reorganized the main repo to satisfy PSR-0.

apps/bootstrap/www/index.php

@@ -3,7 +3,7 @@
 // comment out the following line to disable debug mode
 defined('YII_DEBUG') or define('YII_DEBUG', true);
 
-require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');
+require(__DIR__ . '/../vendor/yiisoft/yii2/yii/Yii.php');
 require(__DIR__ . '/../vendor/autoload.php');
 
 $config = require(__DIR__ . '/../config/main.php');

apps/bootstrap/yii

@@ -13,7 +13,7 @@ defined('YII_DEBUG') or define('YII_DEBUG', true);
 // fcgi doesn't have STDIN defined by default
 defined('STDIN') or define('STDIN', fopen('php://stdin', 'r'));
 
-require(__DIR__ . '/vendor/yiisoft/yii2/Yii.php');
+require(__DIR__ . '/vendor/yiisoft/yii2/yii/Yii.php');
 require(__DIR__ . '/vendor/autoload.php');
 
 $config = require(__DIR__ . '/config/console.php');

framework/yii/.gitignore

+phpunit.xml
+composer.lock
+

framework/yii/web/HttpCache.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\web;
+
+use Yii;
+use yii\base\ActionFilter;
+use yii\base\Action;
+
+/**
+ * @author Da:Sourcerer <webmaster@dasourcerer.net>
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+class HttpCache extends ActionFilter
+{
+	/**
+	 * @var callback a PHP callback that returns the UNIX timestamp of the last modification time.
+	 * The callback's signature should be:
+	 *
+	 * ~~~
+	 * function ($action, $params)
+	 * ~~~
+	 *
+	 * where `$action` is the [[Action]] object that this filter is currently handling;
+	 * `$params` takes the value of [[params]]. The callback should return a UNIX timestamp.
+	 */
+	public $lastModified;
+	/**
+	 * @var callback a PHP callback that generates the Etag seed string.
+	 * The callback's signature should be:
+	 *
+	 * ~~~
+	 * function ($action, $params)
+	 * ~~~
+	 *
+	 * where `$action` is the [[Action]] object that this filter is currently handling;
+	 * `$params` takes the value of [[params]]. The callback should return a string serving
+	 * as the seed for generating an Etag.
+	 */
+	public $etagSeed;
+	/**
+	 * @var mixed additional parameters that should be passed to the [[lastModified]] and [[etagSeed]] callbacks.
+	 */
+	public $params;
+	/**
+	 * @var string HTTP cache control header. If null, the header will not be sent.
+	 */
+	public $cacheControlHeader = 'Cache-Control: max-age=3600, public';
+
+	/**
+	 * This method is invoked right before an action is to be executed (after all possible filters.)
+	 * You may override this method to do last-minute preparation for the action.
+	 * @param Action $action the action to be executed.
+	 * @return boolean whether the action should continue to be executed.
+	 */
+	public function beforeAction($action)
+	{
+		$verb = Yii::$app->request->getRequestMethod();
+		if ($verb !== 'GET' && $verb !== 'HEAD' || $this->lastModified === null && $this->etagSeed === null) {
+			return true;
+		}
+
+		$lastModified = $etag = null;
+		if ($this->lastModified !== null) {
+			$lastModified = call_user_func($this->lastModified, $action, $this->params);
+		}
+		if ($this->etagSeed !== null) {
+			$seed = call_user_func($this->etagSeed, $action, $this->params);
+			$etag = $this->generateEtag($seed);
+		}
+
+		$this->sendCacheControlHeader();
+		if ($etag !== null) {
+			header("ETag: $etag");
+		}
+
+		if ($this->validateCache($lastModified, $etag)) {
+			header('HTTP/1.1 304 Not Modified');
+			return false;
+		}
+
+		if ($lastModified !== null) {
+			header('Last-Modified: ' . gmdate('D, d M Y H:i:s', $lastModified) . ' GMT');
+		}
+		return true;
+	}
+
+	/**
+	 * Validates if the HTTP cache contains valid content.
+	 * @param integer $lastModified the calculated Last-Modified value in terms of a UNIX timestamp.
+	 * If null, the Last-Modified header will not be validated.
+	 * @param string $etag the calculated ETag value. If null, the ETag header will not be validated.
+	 * @return boolean whether the HTTP cache is still valid.
+	 */
+	protected function validateCache($lastModified, $etag)
+	{
+		if ($lastModified !== null && (!isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) || @strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) < $lastModified)) {
+			return false;
+		} else {
+			return $etag === null || isset($_SERVER['HTTP_IF_NONE_MATCH']) && $_SERVER['HTTP_IF_NONE_MATCH'] === $etag;
+		}
+	}
+
+	/**
+	 * Sends the cache control header to the client
+	 * @see cacheControl
+	 */
+	protected function sendCacheControlHeader()
+	{
+		session_cache_limiter('public');
+		header('Pragma:', true);
+		if ($this->cacheControlHeader !== null) {
+			header($this->cacheControlHeader, true);
+		}
+	}
+
+	/**
+	 * Generates an Etag from the given seed string.
+	 * @param string $seed Seed for the ETag
+	 * @return string the generated Etag
+	 */
+	protected function generateEtag($seed)
+	{
+		return '"' . base64_encode(sha1($seed, true)) . '"';
+	}
+}

framework/yii/web/Identity.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\web;
+
+/**
+ * Identity is the interface that should be implemented by a class providing identity information.
+ *
+ * This interface can typically be implemented by a user model class. For example, the following
+ * code shows how to implement this interface by a User ActiveRecord class:
+ *
+ * ~~~
+ * class User extends ActiveRecord implements Identity
+ * {
+ *     public static function findIdentity($id)
+ *     {
+ *         return static::find($id);
+ *     }
+ *
+ *     public function getId()
+ *     {
+ *         return $this->id;
+ *     }
+ *
+ *     public function getAuthKey()
+ *     {
+ *         return $this->authKey;
+ *     }
+ *
+ *     public function validateAuthKey($authKey)
+ *     {
+ *         return $this->authKey === $authKey;
+ *     }
+ * }
+ * ~~~
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+interface Identity
+{
+	/**
+	 * Finds an identity by the given ID.
+	 * @param string|integer $id the ID to be looked for
+	 * @return Identity the identity object that matches the given ID.
+	 * Null should be returned if such an identity cannot be found
+	 * or the identity is not in an active state (disabled, deleted, etc.)
+	 */
+	public static function findIdentity($id);
+	/**
+	 * Returns an ID that can uniquely identify a user identity.
+	 * @return string|integer an ID that uniquely identifies a user identity.
+	 */
+	public function getId();
+	/**
+	 * Returns a key that can be used to check the validity of a given identity ID.
+	 *
+	 * The key should be unique for each individual user, and should be persistent
+	 * so that it can be used to check the validity of the user identity.
+	 *
+	 * The space of such keys should be big enough to defeat potential identity attacks.
+	 *
+	 * This is required if [[User::enableAutoLogin]] is enabled.
+	 * @return string a key that is used to check the validity of a given identity ID.
+	 * @see validateAuthKey()
+	 */
+	public function getAuthKey();
+	/**
+	 * Validates the given auth key.
+	 *
+	 * This is required if [[User::enableAutoLogin]] is enabled.
+	 * @param string $authKey the given auth key
+	 * @return boolean whether the given auth key is valid.
+	 * @see getAuthKey()
+	 */
+	public function validateAuthKey($authKey);
+}

framework/yii/web/PageCache.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\web;
+
+use Yii;
+use yii\base\ActionFilter;
+use yii\base\Action;
+use yii\base\View;
+use yii\caching\Dependency;
+
+/**
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+class PageCache extends ActionFilter
+{
+	/**
+	 * @var boolean whether the content being cached should be differentiated according to the route.
+	 * A route consists of the requested controller ID and action ID. Defaults to true.
+	 */
+	public $varyByRoute = true;
+	/**
+	 * @var string the application component ID of the [[\yii\caching\Cache|cache]] object.
+	 */
+	public $cache = 'cache';
+	/**
+	 * @var integer number of seconds that the data can remain valid in cache.
+	 * Use 0 to indicate that the cached data will never expire.
+	 */
+	public $duration = 60;
+	/**
+	 * @var array|Dependency the dependency that the cached content depends on.
+	 * This can be either a [[Dependency]] object or a configuration array for creating the dependency object.
+	 * For example,
+	 *
+	 * ~~~
+	 * array(
+	 *     'class' => 'yii\caching\DbDependency',
+	 *     'sql' => 'SELECT MAX(lastModified) FROM Post',
+	 * )
+	 * ~~~
+	 *
+	 * would make the output cache depends on the last modified time of all posts.
+	 * If any post has its modification time changed, the cached content would be invalidated.
+	 */
+	public $dependency;
+	/**
+	 * @var array list of factors that would cause the variation of the content being cached.
+	 * Each factor is a string representing a variation (e.g. the language, a GET parameter).
+	 * The following variation setting will cause the content to be cached in different versions
+	 * according to the current application language:
+	 *
+	 * ~~~
+	 * array(
+	 *     Yii::$app->language,
+	 * )
+	 */
+	public $variations;
+	/**
+	 * @var boolean whether to enable the fragment cache. You may use this property to turn on and off
+	 * the fragment cache according to specific setting (e.g. enable fragment cache only for GET requests).
+	 */
+	public $enabled = true;
+
+
+	public function init()
+	{
+		parent::init();
+		if ($this->view === null) {
+			$this->view = Yii::$app->getView();
+		}
+	}
+
+	/**
+	 * This method is invoked right before an action is to be executed (after all possible filters.)
+	 * You may override this method to do last-minute preparation for the action.
+	 * @param Action $action the action to be executed.
+	 * @return boolean whether the action should continue to be executed.
+	 */
+	public function beforeAction($action)
+	{
+		$properties = array();
+		foreach (array('cache', 'duration', 'dependency', 'variations', 'enabled') as $name) {
+			$properties[$name] = $this->$name;
+		}
+		$id = $this->varyByRoute ? $action->getUniqueId() : __CLASS__;
+		return $this->view->beginCache($id, $properties);
+	}
+
+	/**
+	 * This method is invoked right after an action is executed.
+	 * You may override this method to do some postprocessing for the action.
+	 * @param Action $action the action just executed.
+	 */
+	public function afterAction($action)
+	{
+		$this->view->endCache();
+	}
+}

framework/yii/web/SessionIterator.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\web;
+
+/**
+ * SessionIterator implements an iterator for traversing session variables managed by [[Session]].
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+class SessionIterator implements \Iterator
+{
+	/**
+	 * @var array list of keys in the map
+	 */
+	private $_keys;
+	/**
+	 * @var mixed current key
+	 */
+	private $_key;
+
+	/**
+	 * Constructor.
+	 */
+	public function __construct()
+	{
+		$this->_keys = array_keys($_SESSION);
+	}
+
+	/**
+	 * Rewinds internal array pointer.
+	 * This method is required by the interface Iterator.
+	 */
+	public function rewind()
+	{
+		$this->_key = reset($this->_keys);
+	}
+
+	/**
+	 * Returns the key of the current array element.
+	 * This method is required by the interface Iterator.
+	 * @return mixed the key of the current array element
+	 */
+	public function key()
+	{
+		return $this->_key;
+	}
+
+	/**
+	 * Returns the current array element.
+	 * This method is required by the interface Iterator.
+	 * @return mixed the current array element
+	 */
+	public function current()
+	{
+		return isset($_SESSION[$this->_key]) ? $_SESSION[$this->_key] : null;
+	}
+
+	/**
+	 * Moves the internal pointer to the next array element.
+	 * This method is required by the interface Iterator.
+	 */
+	public function next()
+	{
+		do {
+			$this->_key = next($this->_keys);
+		} while (!isset($_SESSION[$this->_key]) && $this->_key !== false);
+	}
+
+	/**
+	 * Returns whether there is an element at current position.
+	 * This method is required by the interface Iterator.
+	 * @return boolean
+	 */
+	public function valid()
+	{
+		return $this->_key !== false;
+	}
+}

framework/yii/widgets/Breadcrumbs.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\widgets;
+
+use Yii;
+use yii\base\Widget;
+use yii\base\InvalidConfigException;
+use yii\helpers\Html;
+
+/**
+ * Breadcrumbs displays a list of links indicating the position of the current page in the whole site hierarchy.
+ *
+ * For example, breadcrumbs like "Home / Sample Post / Edit" means the user is viewing an edit page
+ * for the "Sample Post". He can click on "Sample Post" to view that page, or he can click on "Home"
+ * to return to the homepage.
+ *
+ * To use Breadcrumbs, you need to configure its [[links]] property, which specifies the links to be displayed. For example,
+ *
+ * ~~~
+ * // $this is the view object currently being used
+ * echo Breadcrumbs::widget(array(
+ *     'links' => array(
+ *         array('label' => 'Sample Post', 'url' => array('post/edit', 'id' => 1)),
+ *         'Edit',
+ *     ),
+ * ));
+ * ~~~
+ *
+ * Because breadcrumbs usually appears in nearly every page of a website, you may consider placing it in a layout view.
+ * You can use a view parameter (e.g. `$this->params['breadcrumbs']`) to configure the links in different
+ * views. In the layout view, you assign this view parameter to the [[links]] property like the following:
+ *
+ * ~~~
+ * // $this is the view object currently being used
+ * echo Breadcrumbs::widget(array(
+ *     'links' => isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : array(),
+ * ));
+ * ~~~
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+class Breadcrumbs extends Widget
+{
+	/**
+	 * @var string the name of the breadcrumb container tag.
+	 */
+	public $tag = 'ul';
+	/**
+	 * @var array the HTML attributes for the breadcrumb container tag.
+	 */
+	public $options = array('class' => 'breadcrumb');
+	/**
+	 * @var boolean whether to HTML-encode the link labels.
+	 */
+	public $encodeLabels = true;
+	/**
+	 * @var string the first hyperlink in the breadcrumbs (called home link).
+	 * If this property is not set, it will default to a link pointing to [[\yii\web\Application::homeUrl]]
+	 * with the label 'Home'. If this property is false, the home link will not be rendered.
+	 */
+	public $homeLink;
+	/**
+	 * @var array list of links to appear in the breadcrumbs. If this property is empty,
+	 * the widget will not render anything. Each array element represents a single link in the breadcrumbs
+	 * with the following structure:
+	 *
+	 * ~~~
+	 * array(
+	 *     'label' => 'label of the link',  // required
+	 *     'url' => 'url of the link',      // optional, will be processed by Html::url()
+	 * )
+	 * ~~~
+	 *
+	 * If a link is active, you only need to specify its "label", and instead of writing `array('label' => $label)`,
+	 * you should simply use `$label`.
+	 */
+	public $links = array();
+	/**
+	 * @var string the template used to render each inactive item in the breadcrumbs. The token `{link}`
+	 * will be replaced with the actual HTML link for each inactive item.
+	 */
+	public $itemTemplate = "<li>{link} <span class=\"divider\">/</span></li>\n";
+	/**
+	 * @var string the template used to render each active item in the breadcrumbs. The token `{link}`
+	 * will be replaced with the actual HTML link for each active item.
+	 */
+	public $activeItemTemplate = "<li class=\"active\">{link}</li>\n";
+
+	/**
+	 * Renders the widget.
+	 */
+	public function run()
+	{
+		if (empty($this->links)) {
+			return;
+		}
+		$links = array();
+		if ($this->homeLink === null) {
+			$links[] = $this->renderItem(array(
+				'label' => Yii::t('yii', 'Home'),
+				'url' => Yii::$app->homeUrl,
+			), $this->itemTemplate);
+		} elseif ($this->homeLink !== false) {
+			$links[] = $this->renderItem($this->homeLink, $this->itemTemplate);
+		}
+		foreach ($this->links as $link) {
+			if (!is_array($link)) {
+				$link = array('label' => $link);
+			}
+			$links[] = $this->renderItem($link, isset($link['url']) ? $this->itemTemplate : $this->activeItemTemplate);
+		}
+		echo Html::tag($this->tag, implode('', $links), $this->options);
+	}
+
+	/**
+	 * Renders a single breadcrumb item.
+	 * @param array $link the link to be rendered. It must contain the "label" element. The "url" element is optional.
+	 * @param string $template the template to be used to rendered the link. The token "{link}" will be replaced by the link.
+	 * @return string the rendering result
+	 * @throws InvalidConfigException if `$link` does not have "label" element.
+	 */
+	protected function renderItem($link, $template)
+	{
+		if (isset($link['label'])) {
+			$label = $this->encodeLabels ? Html::encode($link['label']) : $link['label'];
+		} else {
+			throw new InvalidConfigException('The "label" element is required for each link.');
+		}
+		if (isset($link['url'])) {
+			return strtr($template, array('{link}' => Html::a($label, $link['url'])));
+		} else {
+			return strtr($template, array('{link}' => $label));
+		}
+	}
+}

framework/yii/widgets/Captcha.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\widgets;
+
+use Yii;
+use yii\base\InvalidConfigException;
+use yii\base\Widget;
+use yii\helpers\Html;
+use yii\helpers\Json;
+use yii\web\CaptchaAction;
+
+/**
+ * Captcha renders a CAPTCHA image element.
+ *
+ * Captcha is used together with [[CaptchaAction]] provide [CAPTCHA](http://en.wikipedia.org/wiki/Captcha)
+ * - a way of preventing Website spamming.
+ *
+ * The image element rendered by Captcha will display a CAPTCHA image generated by
+ * an action whose route is specified by [[captchaAction]]. This action must be an instance of [[CaptchaAction]].
+ *
+ * When the user clicks on the CAPTCHA image, it will cause the CAPTCHA image
+ * to be refreshed with a new CAPTCHA.
+ *
+ * You may use [[\yii\validators\CaptchaValidator]] to validate the user input matches
+ * the current CAPTCHA verification code.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+class Captcha extends Widget
+{
+	/**
+	 * @var string the route of the action that generates the CAPTCHA images.
+	 * The action represented by this route must be an action of [[CaptchaAction]].
+	 */
+	public $captchaAction = 'site/captcha';
+	/**
+	 * @var array HTML attributes to be applied to the rendered image element.
+	 */
+	public $options = array();
+
+
+	/**
+	 * Renders the widget.
+	 */
+	public function run()
+	{
+		$this->checkRequirements();
+
+		if (!isset($this->options['id'])) {
+			$this->options['id'] = $this->getId();
+		}
+		$id = $this->options['id'];
+		$options = Json::encode($this->getClientOptions());
+		$this->view->registerAssetBundle('yii/captcha');
+		$this->view->registerJs("jQuery('#$id').yiiCaptcha($options);");
+		$url = Yii::$app->getUrlManager()->createUrl($this->captchaAction, array('v' => uniqid()));
+		echo Html::img($url, $this->options);
+	}
+
+	/**
+	 * Returns the options for the captcha JS widget.
+	 * @return array the options
+	 */
+	protected function getClientOptions()
+	{
+		$options = array(
+			'refreshUrl' => Html::url(array($this->captchaAction, CaptchaAction::REFRESH_GET_VAR => 1)),
+			'hashKey' => "yiiCaptcha/{$this->captchaAction}",
+		);
+		return $options;
+	}
+
+	/**
+	 * Checks if there is graphic extension available to generate CAPTCHA images.
+	 * This method will check the existence of ImageMagick and GD extensions.
+	 * @return string the name of the graphic extension, either "imagick" or "gd".
+	 * @throws InvalidConfigException if neither ImageMagick nor GD is installed.
+	 */
+	public static function checkRequirements()
+	{
+		if (extension_loaded('imagick')) {
+			$imagick = new \Imagick();
+			$imagickFormats = $imagick->queryFormats('PNG');
+			if (in_array('PNG', $imagickFormats)) {
+				return 'imagick';
+			}
+		}
+		if (extension_loaded('gd')) {
+			$gdInfo = gd_info();
+			if (!empty($gdInfo['FreeType Support'])) {
+				return 'gd';
+			}
+		}
+		throw new InvalidConfigException('GD with FreeType or ImageMagick PHP extensions are required.');
+	}
+}

yii/web/PageCache.php → framework/yii/widgets/FragmentCache.php

@@ -5,27 +5,23 @@
  * @license http://www.yiiframework.com/license/
  */
 
-namespace yii\web;
+namespace yii\widgets;
 
 use Yii;
-use yii\base\ActionFilter;
-use yii\base\Action;
-use yii\base\View;
+use yii\base\Widget;
+use yii\caching\Cache;
 use yii\caching\Dependency;
 
 /**
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0
  */
-class PageCache extends ActionFilter
+class FragmentCache extends Widget
 {
 	/**
-	 * @var boolean whether the content being cached should be differentiated according to the route.
-	 * A route consists of the requested controller ID and action ID. Defaults to true.
-	 */
-	public $varyByRoute = true;
-	/**
-	 * @var string the application component ID of the [[\yii\caching\Cache|cache]] object.
+	 * @var Cache|string the cache object or the application component ID of the cache object.
+	 * After the FragmentCache object is created, if you want to change this property,
+	 * you should only assign it with a cache object.
 	 */
 	public $cache = 'cache';
 	/**
@@ -66,39 +62,113 @@ class PageCache extends ActionFilter
 	 * the fragment cache according to specific setting (e.g. enable fragment cache only for GET requests).
 	 */
 	public $enabled = true;
+	/**
+	 * @var array a list of placeholders for embedding dynamic contents. This property
+	 * is used internally to implement the content caching feature. Do not modify it.
+	 */
+	public $dynamicPlaceholders;
 
-
+	/**
+	 * Initializes the FragmentCache object.
+	 */
 	public function init()
 	{
 		parent::init();
-		if ($this->view === null) {
-			$this->view = Yii::$app->getView();
+
+		if (!$this->enabled) {
+			$this->cache = null;
+		} elseif (is_string($this->cache)) {
+			$this->cache = Yii::$app->getComponent($this->cache);
+		}
+
+		if ($this->getCachedContent() === false) {
+			$this->view->cacheStack[] = $this;
+			ob_start();
+			ob_implicit_flush(false);
 		}
 	}
 
 	/**
-	 * This method is invoked right before an action is to be executed (after all possible filters.)
-	 * You may override this method to do last-minute preparation for the action.
-	 * @param Action $action the action to be executed.
-	 * @return boolean whether the action should continue to be executed.
+	 * Marks the end of content to be cached.
+	 * Content displayed before this method call and after {@link init()}
+	 * will be captured and saved in cache.
+	 * This method does nothing if valid content is already found in cache.
 	 */
-	public function beforeAction($action)
+	public function run()
 	{
-		$properties = array();
-		foreach (array('cache', 'duration', 'dependency', 'variations', 'enabled') as $name) {
-			$properties[$name] = $this->$name;
+		if (($content = $this->getCachedContent()) !== false) {
+			echo $content;
+		} elseif ($this->cache instanceof Cache) {
+			$content = ob_get_clean();
+			array_pop($this->view->cacheStack);
+			if (is_array($this->dependency)) {
+				$this->dependency = Yii::createObject($this->dependency);
+			}
+			$data = array($content, $this->dynamicPlaceholders);
+			$this->cache->set($this->calculateKey(), $data, $this->duration, $this->dependency);
+
+			if (empty($this->view->cacheStack) && !empty($this->dynamicPlaceholders)) {
+				$content = $this->updateDynamicContent($content, $this->dynamicPlaceholders);
+			}
+			echo $content;
 		}
-		$id = $this->varyByRoute ? $action->getUniqueId() : __CLASS__;
-		return $this->view->beginCache($id, $properties);
 	}
 
 	/**
-	 * This method is invoked right after an action is executed.
-	 * You may override this method to do some postprocessing for the action.
-	 * @param Action $action the action just executed.
+	 * @var string|boolean the cached content. False if the content is not cached.
 	 */
-	public function afterAction($action)
+	private $_content;
+
+	/**
+	 * Returns the cached content if available.
+	 * @return string|boolean the cached content. False is returned if valid content is not found in the cache.
+	 */
+	public function getCachedContent()
 	{
-		$this->view->endCache();
+		if ($this->_content === null) {
+			$this->_content = false;
+			if ($this->cache instanceof Cache) {
+				$key = $this->calculateKey();
+				$data = $this->cache->get($key);
+				if (is_array($data) && count($data) === 2) {
+					list ($content, $placeholders) = $data;
+					if (is_array($placeholders) && count($placeholders) > 0) {
+						if (empty($this->view->cacheStack)) {
+							// outermost cache: replace placeholder with dynamic content
+							$content = $this->updateDynamicContent($content, $placeholders);
+						}
+						foreach ($placeholders as $name => $statements) {
+							$this->view->addDynamicPlaceholder($name, $statements);
+						}
+					}
+					$this->_content = $content;
+				}
+			}
+		}
+		return $this->_content;
+	}
+
+	protected function updateDynamicContent($content, $placeholders)
+	{
+		foreach ($placeholders as $name => $statements) {
+			$placeholders[$name] = $this->view->evaluateDynamicContent($statements);
+		}
+		return strtr($content, $placeholders);
+	}
+
+	/**
+	 * Generates a unique key used for storing the content in cache.
+	 * The key generated depends on both [[id]] and [[variations]].
+	 * @return string a valid cache key
+	 */
+	protected function calculateKey()
+	{
+		$factors = array(__CLASS__, $this->getId());
+		if (is_array($this->variations)) {
+			foreach ($this->variations as $factor) {
+				$factors[] = $factor;
+			}
+		}
+		return $this->cache->buildKey($factors);
 	}
 }

framework/yii/widgets/LinkPager.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\widgets;
+
+use Yii;
+use yii\base\InvalidConfigException;
+use yii\helpers\Html;
+use yii\base\Widget;
+use yii\web\Pagination;
+
+/**
+ * LinkPager displays a list of hyperlinks that lead to different pages of target.
+ *
+ * LinkPager works with a [[Pagination]] object which specifies the totally number
+ * of pages and the current page number.
+ *
+ * Note that LinkPager only generates the necessary HTML markups. In order for it
+ * to look like a real pager, you should provide some CSS styles for it.
+ * With the default configuration, LinkPager should look good using Twitter Bootstrap CSS framework.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+class LinkPager extends Widget
+{
+	/**
+	 * @var Pagination the pagination object that this pager is associated with.
+	 * You must set this property in order to make LinkPager work.
+	 */
+	public $pagination;
+	/**
+	 * @var array HTML attributes for the pager container tag.
+	 */
+	public $options = array('class' => 'pagination');
+	/**
+	 * @var string the CSS class for the "first" page button.
+	 */
+	public $firstPageCssClass = 'first';
+	/**
+	 * @var string the CSS class for the "last" page button.
+	 */
+	public $lastPageCssClass = 'last';
+	/**
+	 * @var string the CSS class for the "previous" page button.
+	 */
+	public $prevPageCssClass = 'prev';
+	/**
+	 * @var string the CSS class for the "next" page button.
+	 */
+	public $nextPageCssClass = 'next';
+	/**
+	 * @var string the CSS class for the active (currently selected) page button.
+	 */
+	public $activePageCssClass = 'active';
+	/**
+	 * @var string the CSS class for the disabled page buttons.
+	 */
+	public $disabledPageCssClass = 'disabled';
+	/**
+	 * @var integer maximum number of page buttons that can be displayed. Defaults to 10.
+	 */
+	public $maxButtonCount = 10;
+	/**
+	 * @var string the label for the "next" page button. Note that this will NOT be HTML-encoded.
+	 * If this property is null, the "next" page button will not be displayed.
+	 */
+	public $nextPageLabel = '&raquo;';
+	/**
+	 * @var string the text label for the previous page button. Note that this will NOT be HTML-encoded.
+	 * If this property is null, the "previous" page button will not be displayed.
+	 */
+	public $prevPageLabel = '&laquo;';
+	/**
+	 * @var string the text label for the "first" page button. Note that this will NOT be HTML-encoded.
+	 * If this property is null, the "first" page button will not be displayed.
+	 */
+	public $firstPageLabel;
+	/**
+	 * @var string the text label for the "last" page button. Note that this will NOT be HTML-encoded.
+	 * If this property is null, the "last" page button will not be displayed.
+	 */
+	public $lastPageLabel;
+	/**
+	 * @var string the template used to render the content within the pager container.
+	 * The token "{buttons}" will be replaced with the actual page buttons.
+	 */
+	public $template = '{buttons}';
+
+
+	/**
+	 * Initializes the pager.
+	 */
+	public function init()
+	{
+		if ($this->pagination === null) {
+			throw new InvalidConfigException('The "pagination" property must be set.');
+		}
+	}
+
+	/**
+	 * Executes the widget.
+	 * This overrides the parent implementation by displaying the generated page buttons.
+	 */
+	public function run()
+	{
+		$buttons = strtr($this->template, array(
+			'{buttons}' => Html::tag('ul', implode("\n", $this->createPageButtons())),
+		));
+		echo Html::tag('div', $buttons, $this->options);
+	}
+
+	/**
+	 * Creates the page buttons.
+	 * @return array a list of page buttons (in HTML code).
+	 */
+	protected function createPageButtons()
+	{
+		$buttons = array();
+
+		$pageCount = $this->pagination->getPageCount();
+		$currentPage = $this->pagination->getPage();
+
+		// first page
+		if ($this->firstPageLabel !== null) {
+			$buttons[] = $this->createPageButton($this->firstPageLabel, 0, $this->firstPageCssClass, $currentPage <= 0, false);
+		}
+
+		// prev page
+		if ($this->prevPageLabel !== null) {
+			if (($page = $currentPage - 1) < 0) {
+				$page = 0;
+			}
+			$buttons[] = $this->createPageButton($this->prevPageLabel, $page, $this->prevPageCssClass, $currentPage <= 0, false);
+		}
+
+		// internal pages
+		list($beginPage, $endPage) = $this->getPageRange();
+		for ($i = $beginPage; $i <= $endPage; ++$i) {
+			$buttons[] = $this->createPageButton($i + 1, $i, null, false, $i == $currentPage);
+		}
+
+		// next page
+		if ($this->nextPageLabel !== null) {
+			if (($page = $currentPage + 1) >= $pageCount - 1) {
+				$page = $pageCount - 1;
+			}
+			$buttons[] = $this->createPageButton($this->nextPageLabel, $page, $this->nextPageCssClass, $currentPage >= $pageCount - 1, false);
+		}
+
+		// last page
+		if ($this->lastPageLabel !== null) {
+			$buttons[] = $this->createPageButton($this->lastPageLabel, $pageCount - 1, $this->lastPageCssClass, $currentPage >= $pageCount - 1, false);
+		}
+
+		return $buttons;
+	}
+
+	/**
+	 * Creates a page button.
+	 * You may override this method to customize the generation of page buttons.
+	 * @param string $label the text label for the button
+	 * @param integer $page the page number
+	 * @param string $class the CSS class for the page button.
+	 * @param boolean $disabled whether this page button is disabled
+	 * @param boolean $active whether this page button is active
+	 * @return string the generated button
+	 */
+	protected function createPageButton($label, $page, $class, $disabled, $active)
+	{
+		if ($active) {
+			$class .= ' ' . $this->activePageCssClass;
+		}
+		if ($disabled) {
+			$class .= ' ' . $this->disabledPageCssClass;
+		}
+		$class = trim($class);
+		$options = array('class' => $class === '' ? null : $class);
+		return Html::tag('li', Html::a($label, $this->pagination->createUrl($page)), $options);
+	}
+
+	/**
+	 * @return array the begin and end pages that need to be displayed.
+	 */
+	protected function getPageRange()
+	{
+		$currentPage = $this->pagination->getPage();
+		$pageCount = $this->pagination->getPageCount();
+
+		$beginPage = max(0, $currentPage - (int)($this->maxButtonCount / 2));
+		if (($endPage = $beginPage + $this->maxButtonCount - 1) >= $pageCount) {
+			$endPage = $pageCount - 1;
+			$beginPage = max(0, $endPage - $this->maxButtonCount + 1);
+		}
+		return array($beginPage, $endPage);
+	}
+}
\ No newline at end of file

framework/yii/widgets/ListPager.php

+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\widgets;
+
+use yii\base\InvalidConfigException;
+use yii\helpers\Html;
+use yii\base\Widget;
+use yii\web\Pagination;
+
+/**
+ * ListPager displays a drop-down list that contains options leading to different pages.
+ *
+ * ListPager works with a [[Pagination]] object which specifies the totally number
+ * of pages and the current page number.
+ *
+ * Note that ListPager requires JavaScript to work. You should consider using [[LinkPager]]
+ * if you want to make your page work without JavaScript.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @since 2.0
+ */
+class ListPager extends Widget
+{
+	/**
+	 * @var Pagination the pagination object that this pager is associated with.
+	 * You must set this property in order to make ListPager work.
+	 */
+	public $pagination;
+	/**
+	 * @var array HTML attributes for the drop-down list tag. The following options are specially handled:
+	 *
+	 * - prompt: string, a prompt text to be displayed as the first option.
+	 *
+	 * The rest of the options will be rendered as the attributes of the resulting tag. The values will
+	 * be HTML-encoded using [[encode()]]. If a value is null, the corresponding attribute will not be rendered.
+	 */
+	public $options = array();
+	/**
+	 * @var string the template used to render the label for each list option.
+	 * The token "{page}" will be replaced with the actual page number (1-based).
+	 */
+	public $template = '{page}';
+
+
+	/**
+	 * Initializes the pager.
+	 */
+	public function init()
+	{
+		if ($this->pagination === null) {
+			throw new InvalidConfigException('The "pagination" property must be set.');
+		}
+	}
+
+	/**
+	 * Executes the widget.
+	 * This overrides the parent implementation by displaying the generated page buttons.
+	 */
+	public function run()
+	{
+		$pageCount = $this->pagination->getPageCount();
+		$currentPage = $this->pagination->getPage();
+
+		$pages = array();
+		for ($i = 0; $i < $pageCount; ++$i) {
+			$pages[$this->pagination->createUrl($i)] = $this->generatePageText($i);
+		}
+		$selection = $this->pagination->createUrl($currentPage);
+
+		if (!isset($this->options['onchange'])) {
+			$this->options['onchange'] = "if (this.value != '') { window.location = this.value; };";
+		}
+
+		echo Html::dropDownList(null, $selection, $pages, $this->options);
+	}
+
+	/**
+	 * Generates the label of the list option for the specified page number.
+	 * You may override this method to customize the option display.
+	 * @param integer $page zero-based page number
+	 * @return string the list option for the page number
+	 */
+	protected function generatePageText($page)
+	{
+		return strtr($this->template, array(
+			'{page}' => $page + 1,
+		));
+	}
+
+}
\ No newline at end of file

yii/web/HttpCache.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\web;
-
-use Yii;
-use yii\base\ActionFilter;
-use yii\base\Action;
-
-/**
- * @author Da:Sourcerer <webmaster@dasourcerer.net>
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-class HttpCache extends ActionFilter
-{
-	/**
-	 * @var callback a PHP callback that returns the UNIX timestamp of the last modification time.
-	 * The callback's signature should be:
-	 *
-	 * ~~~
-	 * function ($action, $params)
-	 * ~~~
-	 *
-	 * where `$action` is the [[Action]] object that this filter is currently handling;
-	 * `$params` takes the value of [[params]]. The callback should return a UNIX timestamp.
-	 */
-	public $lastModified;
-	/**
-	 * @var callback a PHP callback that generates the Etag seed string.
-	 * The callback's signature should be:
-	 *
-	 * ~~~
-	 * function ($action, $params)
-	 * ~~~
-	 *
-	 * where `$action` is the [[Action]] object that this filter is currently handling;
-	 * `$params` takes the value of [[params]]. The callback should return a string serving
-	 * as the seed for generating an Etag.
-	 */
-	public $etagSeed;
-	/**
-	 * @var mixed additional parameters that should be passed to the [[lastModified]] and [[etagSeed]] callbacks.
-	 */
-	public $params;
-	/**
-	 * @var string HTTP cache control header. If null, the header will not be sent.
-	 */
-	public $cacheControlHeader = 'Cache-Control: max-age=3600, public';
-
-	/**
-	 * This method is invoked right before an action is to be executed (after all possible filters.)
-	 * You may override this method to do last-minute preparation for the action.
-	 * @param Action $action the action to be executed.
-	 * @return boolean whether the action should continue to be executed.
-	 */
-	public function beforeAction($action)
-	{
-		$verb = Yii::$app->request->getRequestMethod();
-		if ($verb !== 'GET' && $verb !== 'HEAD' || $this->lastModified === null && $this->etagSeed === null) {
-			return true;
-		}
-
-		$lastModified = $etag = null;
-		if ($this->lastModified !== null) {
-			$lastModified = call_user_func($this->lastModified, $action, $this->params);
-		}
-		if ($this->etagSeed !== null) {
-			$seed = call_user_func($this->etagSeed, $action, $this->params);
-			$etag = $this->generateEtag($seed);
-		}
-
-		$this->sendCacheControlHeader();
-		if ($etag !== null) {
-			header("ETag: $etag");
-		}
-
-		if ($this->validateCache($lastModified, $etag)) {
-			header('HTTP/1.1 304 Not Modified');
-			return false;
-		}
-
-		if ($lastModified !== null) {
-			header('Last-Modified: ' . gmdate('D, d M Y H:i:s', $lastModified) . ' GMT');
-		}
-		return true;
-	}
-
-	/**
-	 * Validates if the HTTP cache contains valid content.
-	 * @param integer $lastModified the calculated Last-Modified value in terms of a UNIX timestamp.
-	 * If null, the Last-Modified header will not be validated.
-	 * @param string $etag the calculated ETag value. If null, the ETag header will not be validated.
-	 * @return boolean whether the HTTP cache is still valid.
-	 */
-	protected function validateCache($lastModified, $etag)
-	{
-		if ($lastModified !== null && (!isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) || @strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) < $lastModified)) {
-			return false;
-		} else {
-			return $etag === null || isset($_SERVER['HTTP_IF_NONE_MATCH']) && $_SERVER['HTTP_IF_NONE_MATCH'] === $etag;
-		}
-	}
-
-	/**
-	 * Sends the cache control header to the client
-	 * @see cacheControl
-	 */
-	protected function sendCacheControlHeader()
-	{
-		session_cache_limiter('public');
-		header('Pragma:', true);
-		if ($this->cacheControlHeader !== null) {
-			header($this->cacheControlHeader, true);
-		}
-	}
-
-	/**
-	 * Generates an Etag from the given seed string.
-	 * @param string $seed Seed for the ETag
-	 * @return string the generated Etag
-	 */
-	protected function generateEtag($seed)
-	{
-		return '"' . base64_encode(sha1($seed, true)) . '"';
-	}
-}

yii/web/Identity.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\web;
-
-/**
- * Identity is the interface that should be implemented by a class providing identity information.
- *
- * This interface can typically be implemented by a user model class. For example, the following
- * code shows how to implement this interface by a User ActiveRecord class:
- *
- * ~~~
- * class User extends ActiveRecord implements Identity
- * {
- *     public static function findIdentity($id)
- *     {
- *         return static::find($id);
- *     }
- *
- *     public function getId()
- *     {
- *         return $this->id;
- *     }
- *
- *     public function getAuthKey()
- *     {
- *         return $this->authKey;
- *     }
- *
- *     public function validateAuthKey($authKey)
- *     {
- *         return $this->authKey === $authKey;
- *     }
- * }
- * ~~~
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-interface Identity
-{
-	/**
-	 * Finds an identity by the given ID.
-	 * @param string|integer $id the ID to be looked for
-	 * @return Identity the identity object that matches the given ID.
-	 * Null should be returned if such an identity cannot be found
-	 * or the identity is not in an active state (disabled, deleted, etc.)
-	 */
-	public static function findIdentity($id);
-	/**
-	 * Returns an ID that can uniquely identify a user identity.
-	 * @return string|integer an ID that uniquely identifies a user identity.
-	 */
-	public function getId();
-	/**
-	 * Returns a key that can be used to check the validity of a given identity ID.
-	 *
-	 * The key should be unique for each individual user, and should be persistent
-	 * so that it can be used to check the validity of the user identity.
-	 *
-	 * The space of such keys should be big enough to defeat potential identity attacks.
-	 *
-	 * This is required if [[User::enableAutoLogin]] is enabled.
-	 * @return string a key that is used to check the validity of a given identity ID.
-	 * @see validateAuthKey()
-	 */
-	public function getAuthKey();
-	/**
-	 * Validates the given auth key.
-	 *
-	 * This is required if [[User::enableAutoLogin]] is enabled.
-	 * @param string $authKey the given auth key
-	 * @return boolean whether the given auth key is valid.
-	 * @see getAuthKey()
-	 */
-	public function validateAuthKey($authKey);
-}

yii/web/SessionIterator.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\web;
-
-/**
- * SessionIterator implements an iterator for traversing session variables managed by [[Session]].
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-class SessionIterator implements \Iterator
-{
-	/**
-	 * @var array list of keys in the map
-	 */
-	private $_keys;
-	/**
-	 * @var mixed current key
-	 */
-	private $_key;
-
-	/**
-	 * Constructor.
-	 */
-	public function __construct()
-	{
-		$this->_keys = array_keys($_SESSION);
-	}
-
-	/**
-	 * Rewinds internal array pointer.
-	 * This method is required by the interface Iterator.
-	 */
-	public function rewind()
-	{
-		$this->_key = reset($this->_keys);
-	}
-
-	/**
-	 * Returns the key of the current array element.
-	 * This method is required by the interface Iterator.
-	 * @return mixed the key of the current array element
-	 */
-	public function key()
-	{
-		return $this->_key;
-	}
-
-	/**
-	 * Returns the current array element.
-	 * This method is required by the interface Iterator.
-	 * @return mixed the current array element
-	 */
-	public function current()
-	{
-		return isset($_SESSION[$this->_key]) ? $_SESSION[$this->_key] : null;
-	}
-
-	/**
-	 * Moves the internal pointer to the next array element.
-	 * This method is required by the interface Iterator.
-	 */
-	public function next()
-	{
-		do {
-			$this->_key = next($this->_keys);
-		} while (!isset($_SESSION[$this->_key]) && $this->_key !== false);
-	}
-
-	/**
-	 * Returns whether there is an element at current position.
-	 * This method is required by the interface Iterator.
-	 * @return boolean
-	 */
-	public function valid()
-	{
-		return $this->_key !== false;
-	}
-}

yii/widgets/Breadcrumbs.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\widgets;
-
-use Yii;
-use yii\base\Widget;
-use yii\base\InvalidConfigException;
-use yii\helpers\Html;
-
-/**
- * Breadcrumbs displays a list of links indicating the position of the current page in the whole site hierarchy.
- *
- * For example, breadcrumbs like "Home / Sample Post / Edit" means the user is viewing an edit page
- * for the "Sample Post". He can click on "Sample Post" to view that page, or he can click on "Home"
- * to return to the homepage.
- *
- * To use Breadcrumbs, you need to configure its [[links]] property, which specifies the links to be displayed. For example,
- *
- * ~~~
- * // $this is the view object currently being used
- * echo Breadcrumbs::widget(array(
- *     'links' => array(
- *         array('label' => 'Sample Post', 'url' => array('post/edit', 'id' => 1)),
- *         'Edit',
- *     ),
- * ));
- * ~~~
- *
- * Because breadcrumbs usually appears in nearly every page of a website, you may consider placing it in a layout view.
- * You can use a view parameter (e.g. `$this->params['breadcrumbs']`) to configure the links in different
- * views. In the layout view, you assign this view parameter to the [[links]] property like the following:
- *
- * ~~~
- * // $this is the view object currently being used
- * echo Breadcrumbs::widget(array(
- *     'links' => isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : array(),
- * ));
- * ~~~
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-class Breadcrumbs extends Widget
-{
-	/**
-	 * @var string the name of the breadcrumb container tag.
-	 */
-	public $tag = 'ul';
-	/**
-	 * @var array the HTML attributes for the breadcrumb container tag.
-	 */
-	public $options = array('class' => 'breadcrumb');
-	/**
-	 * @var boolean whether to HTML-encode the link labels.
-	 */
-	public $encodeLabels = true;
-	/**
-	 * @var string the first hyperlink in the breadcrumbs (called home link).
-	 * If this property is not set, it will default to a link pointing to [[\yii\web\Application::homeUrl]]
-	 * with the label 'Home'. If this property is false, the home link will not be rendered.
-	 */
-	public $homeLink;
-	/**
-	 * @var array list of links to appear in the breadcrumbs. If this property is empty,
-	 * the widget will not render anything. Each array element represents a single link in the breadcrumbs
-	 * with the following structure:
-	 *
-	 * ~~~
-	 * array(
-	 *     'label' => 'label of the link',  // required
-	 *     'url' => 'url of the link',      // optional, will be processed by Html::url()
-	 * )
-	 * ~~~
-	 *
-	 * If a link is active, you only need to specify its "label", and instead of writing `array('label' => $label)`,
-	 * you should simply use `$label`.
-	 */
-	public $links = array();
-	/**
-	 * @var string the template used to render each inactive item in the breadcrumbs. The token `{link}`
-	 * will be replaced with the actual HTML link for each inactive item.
-	 */
-	public $itemTemplate = "<li>{link} <span class=\"divider\">/</span></li>\n";
-	/**
-	 * @var string the template used to render each active item in the breadcrumbs. The token `{link}`
-	 * will be replaced with the actual HTML link for each active item.
-	 */
-	public $activeItemTemplate = "<li class=\"active\">{link}</li>\n";
-
-	/**
-	 * Renders the widget.
-	 */
-	public function run()
-	{
-		if (empty($this->links)) {
-			return;
-		}
-		$links = array();
-		if ($this->homeLink === null) {
-			$links[] = $this->renderItem(array(
-				'label' => Yii::t('yii', 'Home'),
-				'url' => Yii::$app->homeUrl,
-			), $this->itemTemplate);
-		} elseif ($this->homeLink !== false) {
-			$links[] = $this->renderItem($this->homeLink, $this->itemTemplate);
-		}
-		foreach ($this->links as $link) {
-			if (!is_array($link)) {
-				$link = array('label' => $link);
-			}
-			$links[] = $this->renderItem($link, isset($link['url']) ? $this->itemTemplate : $this->activeItemTemplate);
-		}
-		echo Html::tag($this->tag, implode('', $links), $this->options);
-	}
-
-	/**
-	 * Renders a single breadcrumb item.
-	 * @param array $link the link to be rendered. It must contain the "label" element. The "url" element is optional.
-	 * @param string $template the template to be used to rendered the link. The token "{link}" will be replaced by the link.
-	 * @return string the rendering result
-	 * @throws InvalidConfigException if `$link` does not have "label" element.
-	 */
-	protected function renderItem($link, $template)
-	{
-		if (isset($link['label'])) {
-			$label = $this->encodeLabels ? Html::encode($link['label']) : $link['label'];
-		} else {
-			throw new InvalidConfigException('The "label" element is required for each link.');
-		}
-		if (isset($link['url'])) {
-			return strtr($template, array('{link}' => Html::a($label, $link['url'])));
-		} else {
-			return strtr($template, array('{link}' => $label));
-		}
-	}
-}

yii/widgets/Captcha.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\widgets;
-
-use Yii;
-use yii\base\InvalidConfigException;
-use yii\base\Widget;
-use yii\helpers\Html;
-use yii\helpers\Json;
-use yii\web\CaptchaAction;
-
-/**
- * Captcha renders a CAPTCHA image element.
- *
- * Captcha is used together with [[CaptchaAction]] provide [CAPTCHA](http://en.wikipedia.org/wiki/Captcha)
- * - a way of preventing Website spamming.
- *
- * The image element rendered by Captcha will display a CAPTCHA image generated by
- * an action whose route is specified by [[captchaAction]]. This action must be an instance of [[CaptchaAction]].
- *
- * When the user clicks on the CAPTCHA image, it will cause the CAPTCHA image
- * to be refreshed with a new CAPTCHA.
- *
- * You may use [[\yii\validators\CaptchaValidator]] to validate the user input matches
- * the current CAPTCHA verification code.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-class Captcha extends Widget
-{
-	/**
-	 * @var string the route of the action that generates the CAPTCHA images.
-	 * The action represented by this route must be an action of [[CaptchaAction]].
-	 */
-	public $captchaAction = 'site/captcha';
-	/**
-	 * @var array HTML attributes to be applied to the rendered image element.
-	 */
-	public $options = array();
-
-
-	/**
-	 * Renders the widget.
-	 */
-	public function run()
-	{
-		$this->checkRequirements();
-
-		if (!isset($this->options['id'])) {
-			$this->options['id'] = $this->getId();
-		}
-		$id = $this->options['id'];
-		$options = Json::encode($this->getClientOptions());
-		$this->view->registerAssetBundle('yii/captcha');
-		$this->view->registerJs("jQuery('#$id').yiiCaptcha($options);");
-		$url = Yii::$app->getUrlManager()->createUrl($this->captchaAction, array('v' => uniqid()));
-		echo Html::img($url, $this->options);
-	}
-
-	/**
-	 * Returns the options for the captcha JS widget.
-	 * @return array the options
-	 */
-	protected function getClientOptions()
-	{
-		$options = array(
-			'refreshUrl' => Html::url(array($this->captchaAction, CaptchaAction::REFRESH_GET_VAR => 1)),
-			'hashKey' => "yiiCaptcha/{$this->captchaAction}",
-		);
-		return $options;
-	}
-
-	/**
-	 * Checks if there is graphic extension available to generate CAPTCHA images.
-	 * This method will check the existence of ImageMagick and GD extensions.
-	 * @return string the name of the graphic extension, either "imagick" or "gd".
-	 * @throws InvalidConfigException if neither ImageMagick nor GD is installed.
-	 */
-	public static function checkRequirements()
-	{
-		if (extension_loaded('imagick')) {
-			$imagick = new \Imagick();
-			$imagickFormats = $imagick->queryFormats('PNG');
-			if (in_array('PNG', $imagickFormats)) {
-				return 'imagick';
-			}
-		}
-		if (extension_loaded('gd')) {
-			$gdInfo = gd_info();
-			if (!empty($gdInfo['FreeType Support'])) {
-				return 'gd';
-			}
-		}
-		throw new InvalidConfigException('GD with FreeType or ImageMagick PHP extensions are required.');
-	}
-}

yii/widgets/FragmentCache.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\widgets;
-
-use Yii;
-use yii\base\Widget;
-use yii\caching\Cache;
-use yii\caching\Dependency;
-
-/**
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-class FragmentCache extends Widget
-{
-	/**
-	 * @var Cache|string the cache object or the application component ID of the cache object.
-	 * After the FragmentCache object is created, if you want to change this property,
-	 * you should only assign it with a cache object.
-	 */
-	public $cache = 'cache';
-	/**
-	 * @var integer number of seconds that the data can remain valid in cache.
-	 * Use 0 to indicate that the cached data will never expire.
-	 */
-	public $duration = 60;
-	/**
-	 * @var array|Dependency the dependency that the cached content depends on.
-	 * This can be either a [[Dependency]] object or a configuration array for creating the dependency object.
-	 * For example,
-	 *
-	 * ~~~
-	 * array(
-	 *     'class' => 'yii\caching\DbDependency',
-	 *     'sql' => 'SELECT MAX(lastModified) FROM Post',
-	 * )
-	 * ~~~
-	 *
-	 * would make the output cache depends on the last modified time of all posts.
-	 * If any post has its modification time changed, the cached content would be invalidated.
-	 */
-	public $dependency;
-	/**
-	 * @var array list of factors that would cause the variation of the content being cached.
-	 * Each factor is a string representing a variation (e.g. the language, a GET parameter).
-	 * The following variation setting will cause the content to be cached in different versions
-	 * according to the current application language:
-	 *
-	 * ~~~
-	 * array(
-	 *     Yii::$app->language,
-	 * )
-	 */
-	public $variations;
-	/**
-	 * @var boolean whether to enable the fragment cache. You may use this property to turn on and off
-	 * the fragment cache according to specific setting (e.g. enable fragment cache only for GET requests).
-	 */
-	public $enabled = true;
-	/**
-	 * @var array a list of placeholders for embedding dynamic contents. This property
-	 * is used internally to implement the content caching feature. Do not modify it.
-	 */
-	public $dynamicPlaceholders;
-
-	/**
-	 * Initializes the FragmentCache object.
-	 */
-	public function init()
-	{
-		parent::init();
-
-		if (!$this->enabled) {
-			$this->cache = null;
-		} elseif (is_string($this->cache)) {
-			$this->cache = Yii::$app->getComponent($this->cache);
-		}
-
-		if ($this->getCachedContent() === false) {
-			$this->view->cacheStack[] = $this;
-			ob_start();
-			ob_implicit_flush(false);
-		}
-	}
-
-	/**
-	 * Marks the end of content to be cached.
-	 * Content displayed before this method call and after {@link init()}
-	 * will be captured and saved in cache.
-	 * This method does nothing if valid content is already found in cache.
-	 */
-	public function run()
-	{
-		if (($content = $this->getCachedContent()) !== false) {
-			echo $content;
-		} elseif ($this->cache instanceof Cache) {
-			$content = ob_get_clean();
-			array_pop($this->view->cacheStack);
-			if (is_array($this->dependency)) {
-				$this->dependency = Yii::createObject($this->dependency);
-			}
-			$data = array($content, $this->dynamicPlaceholders);
-			$this->cache->set($this->calculateKey(), $data, $this->duration, $this->dependency);
-
-			if (empty($this->view->cacheStack) && !empty($this->dynamicPlaceholders)) {
-				$content = $this->updateDynamicContent($content, $this->dynamicPlaceholders);
-			}
-			echo $content;
-		}
-	}
-
-	/**
-	 * @var string|boolean the cached content. False if the content is not cached.
-	 */
-	private $_content;
-
-	/**
-	 * Returns the cached content if available.
-	 * @return string|boolean the cached content. False is returned if valid content is not found in the cache.
-	 */
-	public function getCachedContent()
-	{
-		if ($this->_content === null) {
-			$this->_content = false;
-			if ($this->cache instanceof Cache) {
-				$key = $this->calculateKey();
-				$data = $this->cache->get($key);
-				if (is_array($data) && count($data) === 2) {
-					list ($content, $placeholders) = $data;
-					if (is_array($placeholders) && count($placeholders) > 0) {
-						if (empty($this->view->cacheStack)) {
-							// outermost cache: replace placeholder with dynamic content
-							$content = $this->updateDynamicContent($content, $placeholders);
-						}
-						foreach ($placeholders as $name => $statements) {
-							$this->view->addDynamicPlaceholder($name, $statements);
-						}
-					}
-					$this->_content = $content;
-				}
-			}
-		}
-		return $this->_content;
-	}
-
-	protected function updateDynamicContent($content, $placeholders)
-	{
-		foreach ($placeholders as $name => $statements) {
-			$placeholders[$name] = $this->view->evaluateDynamicContent($statements);
-		}
-		return strtr($content, $placeholders);
-	}
-
-	/**
-	 * Generates a unique key used for storing the content in cache.
-	 * The key generated depends on both [[id]] and [[variations]].
-	 * @return string a valid cache key
-	 */
-	protected function calculateKey()
-	{
-		$factors = array(__CLASS__, $this->getId());
-		if (is_array($this->variations)) {
-			foreach ($this->variations as $factor) {
-				$factors[] = $factor;
-			}
-		}
-		return $this->cache->buildKey($factors);
-	}
-}

yii/widgets/LinkPager.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\widgets;
-
-use Yii;
-use yii\base\InvalidConfigException;
-use yii\helpers\Html;
-use yii\base\Widget;
-use yii\web\Pagination;
-
-/**
- * LinkPager displays a list of hyperlinks that lead to different pages of target.
- *
- * LinkPager works with a [[Pagination]] object which specifies the totally number
- * of pages and the current page number.
- *
- * Note that LinkPager only generates the necessary HTML markups. In order for it
- * to look like a real pager, you should provide some CSS styles for it.
- * With the default configuration, LinkPager should look good using Twitter Bootstrap CSS framework.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-class LinkPager extends Widget
-{
-	/**
-	 * @var Pagination the pagination object that this pager is associated with.
-	 * You must set this property in order to make LinkPager work.
-	 */
-	public $pagination;
-	/**
-	 * @var array HTML attributes for the pager container tag.
-	 */
-	public $options = array('class' => 'pagination');
-	/**
-	 * @var string the CSS class for the "first" page button.
-	 */
-	public $firstPageCssClass = 'first';
-	/**
-	 * @var string the CSS class for the "last" page button.
-	 */
-	public $lastPageCssClass = 'last';
-	/**
-	 * @var string the CSS class for the "previous" page button.
-	 */
-	public $prevPageCssClass = 'prev';
-	/**
-	 * @var string the CSS class for the "next" page button.
-	 */
-	public $nextPageCssClass = 'next';
-	/**
-	 * @var string the CSS class for the active (currently selected) page button.
-	 */
-	public $activePageCssClass = 'active';
-	/**
-	 * @var string the CSS class for the disabled page buttons.
-	 */
-	public $disabledPageCssClass = 'disabled';
-	/**
-	 * @var integer maximum number of page buttons that can be displayed. Defaults to 10.
-	 */
-	public $maxButtonCount = 10;
-	/**
-	 * @var string the label for the "next" page button. Note that this will NOT be HTML-encoded.
-	 * If this property is null, the "next" page button will not be displayed.
-	 */
-	public $nextPageLabel = '&raquo;';
-	/**
-	 * @var string the text label for the previous page button. Note that this will NOT be HTML-encoded.
-	 * If this property is null, the "previous" page button will not be displayed.
-	 */
-	public $prevPageLabel = '&laquo;';
-	/**
-	 * @var string the text label for the "first" page button. Note that this will NOT be HTML-encoded.
-	 * If this property is null, the "first" page button will not be displayed.
-	 */
-	public $firstPageLabel;
-	/**
-	 * @var string the text label for the "last" page button. Note that this will NOT be HTML-encoded.
-	 * If this property is null, the "last" page button will not be displayed.
-	 */
-	public $lastPageLabel;
-	/**
-	 * @var string the template used to render the content within the pager container.
-	 * The token "{buttons}" will be replaced with the actual page buttons.
-	 */
-	public $template = '{buttons}';
-
-
-	/**
-	 * Initializes the pager.
-	 */
-	public function init()
-	{
-		if ($this->pagination === null) {
-			throw new InvalidConfigException('The "pagination" property must be set.');
-		}
-	}
-
-	/**
-	 * Executes the widget.
-	 * This overrides the parent implementation by displaying the generated page buttons.
-	 */
-	public function run()
-	{
-		$buttons = strtr($this->template, array(
-			'{buttons}' => Html::tag('ul', implode("\n", $this->createPageButtons())),
-		));
-		echo Html::tag('div', $buttons, $this->options);
-	}
-
-	/**
-	 * Creates the page buttons.
-	 * @return array a list of page buttons (in HTML code).
-	 */
-	protected function createPageButtons()
-	{
-		$buttons = array();
-
-		$pageCount = $this->pagination->getPageCount();
-		$currentPage = $this->pagination->getPage();
-
-		// first page
-		if ($this->firstPageLabel !== null) {
-			$buttons[] = $this->createPageButton($this->firstPageLabel, 0, $this->firstPageCssClass, $currentPage <= 0, false);
-		}
-
-		// prev page
-		if ($this->prevPageLabel !== null) {
-			if (($page = $currentPage - 1) < 0) {
-				$page = 0;
-			}
-			$buttons[] = $this->createPageButton($this->prevPageLabel, $page, $this->prevPageCssClass, $currentPage <= 0, false);
-		}
-
-		// internal pages
-		list($beginPage, $endPage) = $this->getPageRange();
-		for ($i = $beginPage; $i <= $endPage; ++$i) {
-			$buttons[] = $this->createPageButton($i + 1, $i, null, false, $i == $currentPage);
-		}
-
-		// next page
-		if ($this->nextPageLabel !== null) {
-			if (($page = $currentPage + 1) >= $pageCount - 1) {
-				$page = $pageCount - 1;
-			}
-			$buttons[] = $this->createPageButton($this->nextPageLabel, $page, $this->nextPageCssClass, $currentPage >= $pageCount - 1, false);
-		}
-
-		// last page
-		if ($this->lastPageLabel !== null) {
-			$buttons[] = $this->createPageButton($this->lastPageLabel, $pageCount - 1, $this->lastPageCssClass, $currentPage >= $pageCount - 1, false);
-		}
-
-		return $buttons;
-	}
-
-	/**
-	 * Creates a page button.
-	 * You may override this method to customize the generation of page buttons.
-	 * @param string $label the text label for the button
-	 * @param integer $page the page number
-	 * @param string $class the CSS class for the page button.
-	 * @param boolean $disabled whether this page button is disabled
-	 * @param boolean $active whether this page button is active
-	 * @return string the generated button
-	 */
-	protected function createPageButton($label, $page, $class, $disabled, $active)
-	{
-		if ($active) {
-			$class .= ' ' . $this->activePageCssClass;
-		}
-		if ($disabled) {
-			$class .= ' ' . $this->disabledPageCssClass;
-		}
-		$class = trim($class);
-		$options = array('class' => $class === '' ? null : $class);
-		return Html::tag('li', Html::a($label, $this->pagination->createUrl($page)), $options);
-	}
-
-	/**
-	 * @return array the begin and end pages that need to be displayed.
-	 */
-	protected function getPageRange()
-	{
-		$currentPage = $this->pagination->getPage();
-		$pageCount = $this->pagination->getPageCount();
-
-		$beginPage = max(0, $currentPage - (int)($this->maxButtonCount / 2));
-		if (($endPage = $beginPage + $this->maxButtonCount - 1) >= $pageCount) {
-			$endPage = $pageCount - 1;
-			$beginPage = max(0, $endPage - $this->maxButtonCount + 1);
-		}
-		return array($beginPage, $endPage);
-	}
-}
\ No newline at end of file

yii/widgets/ListPager.php

-<?php
-/**
- * @link http://www.yiiframework.com/
- * @copyright Copyright (c) 2008 Yii Software LLC
- * @license http://www.yiiframework.com/license/
- */
-
-namespace yii\widgets;
-
-use yii\base\InvalidConfigException;
-use yii\helpers\Html;
-use yii\base\Widget;
-use yii\web\Pagination;
-
-/**
- * ListPager displays a drop-down list that contains options leading to different pages.
- *
- * ListPager works with a [[Pagination]] object which specifies the totally number
- * of pages and the current page number.
- *
- * Note that ListPager requires JavaScript to work. You should consider using [[LinkPager]]
- * if you want to make your page work without JavaScript.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @since 2.0
- */
-class ListPager extends Widget
-{
-	/**
-	 * @var Pagination the pagination object that this pager is associated with.
-	 * You must set this property in order to make ListPager work.
-	 */
-	public $pagination;
-	/**
-	 * @var array HTML attributes for the drop-down list tag. The following options are specially handled:
-	 *
-	 * - prompt: string, a prompt text to be displayed as the first option.
-	 *
-	 * The rest of the options will be rendered as the attributes of the resulting tag. The values will
-	 * be HTML-encoded using [[encode()]]. If a value is null, the corresponding attribute will not be rendered.
-	 */
-	public $options = array();
-	/**
-	 * @var string the template used to render the label for each list option.
-	 * The token "{page}" will be replaced with the actual page number (1-based).
-	 */
-	public $template = '{page}';
-
-
-	/**
-	 * Initializes the pager.
-	 */
-	public function init()
-	{
-		if ($this->pagination === null) {
-			throw new InvalidConfigException('The "pagination" property must be set.');
-		}
-	}
-
-	/**
-	 * Executes the widget.
-	 * This overrides the parent implementation by displaying the generated page buttons.
-	 */
-	public function run()
-	{
-		$pageCount = $this->pagination->getPageCount();
-		$currentPage = $this->pagination->getPage();
-
-		$pages = array();
-		for ($i = 0; $i < $pageCount; ++$i) {
-			$pages[$this->pagination->createUrl($i)] = $this->generatePageText($i);
-		}
-		$selection = $this->pagination->createUrl($currentPage);
-
-		if (!isset($this->options['onchange'])) {
-			$this->options['onchange'] = "if (this.value != '') { window.location = this.value; };";
-		}
-
-		echo Html::dropDownList(null, $selection, $pages, $this->options);
-	}
-
-	/**
-	 * Generates the label of the list option for the specified page number.
-	 * You may override this method to customize the option display.
-	 * @param integer $page zero-based page number
-	 * @return string the list option for the page number
-	 */
-	protected function generatePageText($page)
-	{
-		return strtr($this->template, array(
-			'{page}' => $page + 1,
-		));
-	}
-
-}
\ No newline at end of file