update of @property annotations

framework/yii/base/Action.php

@@ -28,7 +28,8 @@ use Yii;
  * And the parameters provided for the action are: `array('id' => 1)`.
  * Then the `run()` method will be invoked as `run(1)` automatically.
  *
- * @property string $uniqueId The unique ID of this action among the whole application.
+ * @property string $uniqueId The unique ID of this action among the whole application. This property is
+ * read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/base/Application.php

@@ -14,22 +14,23 @@ use yii\web\HttpException;
 /**
  * Application is the base class for all application classes.
  *
- * @property \yii\rbac\Manager $authManager The auth manager for this application.
+ * @property \yii\rbac\Manager $authManager The auth manager for this application. This property is read-only.
  * @property \yii\caching\Cache $cache The cache application component. Null if the component is not enabled.
- * @property \yii\db\Connection $db The database connection.
+ * This property is read-only.
- * @property ErrorHandler $errorHandler The error handler application component.
+ * @property \yii\db\Connection $db The database connection. This property is read-only.
- * @property \yii\base\Formatter $formatter The formatter application component.
+ * @property ErrorHandler $errorHandler The error handler application component. This property is read-only.
- * @property \yii\i18n\I18N $i18N The internationalization component.
+ * @property \yii\base\Formatter $formatter The formatter application component. This property is read-only.
- * @property \yii\log\Logger $log The log component.
+ * @property \yii\i18n\I18N $i18N The internationalization component. This property is read-only.
- * @property \yii\web\Request|\yii\console\Request $request The request component.
+ * @property \yii\log\Logger $log The log component. This property is read-only.
- * @property string $runtimePath The directory that stores runtime files.
+ * @property \yii\web\Request|\yii\console\Request $request The request component. This property is read-only.
- * Defaults to the "runtime" subdirectory under [[basePath]].
+ * @property string $runtimePath The directory that stores runtime files. Defaults to the "runtime"
+ * subdirectory under [[basePath]].
  * @property string $timeZone The time zone used by this application.
- * @property string $uniqueId The unique ID of the module.
+ * @property string $uniqueId The unique ID of the module. This property is read-only.
- * @property \yii\web\UrlManager $urlManager The URL manager for this application.
+ * @property \yii\web\UrlManager $urlManager The URL manager for this application. This property is read-only.
- * @property string $vendorPath The directory that stores vendor files.
+ * @property string $vendorPath The directory that stores vendor files. Defaults to "vendor" directory under
- * Defaults to "vendor" directory under [[basePath]].
+ * [[basePath]].
- * @property View $view The view object that is used to render various view files.
+ * @property View $view The view object that is used to render various view files. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/base/Component.php

@@ -11,6 +11,9 @@ use Yii;
 
 /**
  * @include @yii/base/Component.md
+ *
+ * @property Behavior[] $behaviors List of behaviors attached to this component. This property is read-only.
+ *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0
  */

framework/yii/base/Controller.php

@@ -12,11 +12,15 @@ use Yii;
 /**
  * Controller is the base class for classes containing controller logic.
  *
- * @property array $actionParams The request parameters (name-value pairs) to be used for action parameter binding.
+ * @property array $actionParams The request parameters (name-value pairs) to be used for action parameter
- * @property string $route The route (module ID, controller ID and action ID) of the current request.
+ * binding. This property is read-only.
- * @property string $uniqueId The controller ID that is prefixed with the module ID (if any).
+ * @property string $route The route (module ID, controller ID and action ID) of the current request. This
+ * property is read-only.
+ * @property string $uniqueId The controller ID that is prefixed with the module ID (if any). This property is
+ * read-only.
  * @property View $view The view object that can be used to render views or view files.
- * @property string $viewPath The directory containing the view files for this controller.
+ * @property string $viewPath The directory containing the view files for this controller. This property is
+ * read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/base/View.php

@@ -21,7 +21,8 @@ use yii\widgets\FragmentCache;
  *
  * View provides a set of methods (e.g. [[render()]]) for rendering purpose.
  *
- * @property \yii\web\AssetManager $assetManager The asset manager. Defaults to the "assetManager" application component.
+ * @property \yii\web\AssetManager $assetManager The asset manager. Defaults to the "assetManager" application
+ * component.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/base/Widget.php

@@ -14,7 +14,8 @@ use Yii;
  *
  * @property string $id ID of the widget.
  * @property View $view The view object that can be used to render views or view files.
- * @property string $viewPath The directory containing the view files for this widget.
+ * @property string $viewPath The directory containing the view files for this widget. This property is
+ * read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/caching/RedisCache.php

@@ -39,6 +39,8 @@ use yii\db\redis\Connection;
  * )
  * ~~~
  *
+ * @property \yii\db\redis\Connection $connection This property is read-only.
+ *
  * @author Carsten Brandt <mail@cebe.cc>
  * @since 2.0
  */

framework/yii/captcha/CaptchaAction.php

@@ -29,7 +29,7 @@ use yii\base\InvalidConfigException;
  *    to be validated by the 'captcha' validator.
  * 3. In the controller view, insert a [[Captcha]] widget in the form.
  *
- * @property string $verifyCode The verification code.
+ * @property string $verifyCode The verification code. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/captcha/CaptchaValidator.php

@@ -18,7 +18,7 @@ use yii\validators\Validator;
  *
  * CaptchaValidator should be used together with [[CaptchaAction]].
  *
- * @property \yii\captcha\CaptchaAction $captchaAction The action object.
+ * @property \yii\captcha\CaptchaAction $captchaAction The action object. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/console/Application.php

@@ -45,7 +45,7 @@ use yii\base\InvalidRouteException;
  * yii help
  * ~~~
  *
- * @property Response $response The response component.
+ * @property Response $response The response component. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/console/controllers/HelpController.php

@@ -31,7 +31,7 @@ use yii\helpers\Inflector;
  * In the above, if the command name is not provided, all
  * available commands will be displayed.
  *
- * @property array $commands All available command names.
+ * @property array $commands All available command names. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/data/ActiveDataProvider.php

@@ -49,10 +49,10 @@ use yii\db\Connection;
  * $posts = $provider->getModels();
  * ~~~
  *
- * @property integer $count The number of data models in the current page.
+ * @property integer $count The number of data models in the current page. This property is read-only.
- * @property array $keys The list of key values corresponding to [[models]]. Each data model in [[models]]
+ * @property array $keys The list of key values corresponding to [[models]]. Each data model in [[models]] is
- * is uniquely identified by the corresponding key value in this array.
+ * uniquely identified by the corresponding key value in this array. This property is read-only.
- * @property array $models The list of data models in the current page.
+ * @property array $models The list of data models in the current page. This property is read-only.
  * @property integer $totalCount Total number of possible data models.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>

framework/yii/data/ArrayDataProvider.php

@@ -47,8 +47,8 @@ use yii\helpers\ArrayHelper;
  * Note: if you want to use the sorting feature, you must configure the [[sort]] property
  * so that the provider knows which columns can be sorted.
  *
- * @property array $keys The list of key values corresponding to [[models]]. Each data model in [[models]]
+ * @property array $keys The list of key values corresponding to [[models]]. Each data model in [[models]] is
- * is uniquely identified by the corresponding key value in this array.
+ * uniquely identified by the corresponding key value in this array.
  * @property array $models The list of data models in the current page.
  * @property integer $totalCount Total number of possible data models.
  *

framework/yii/data/DataProvider.php

@@ -16,8 +16,9 @@ use yii\base\InvalidParamException;
  *
  * It implements the [[getPagination()]] and [[getSort()]] methods as specified by the [[IDataProvider]] interface.
  *
- * @property integer $count The number of data models in the current page.
+ * @property integer $count The number of data models in the current page. This property is read-only.
- * @property Pagination $pagination The pagination object. If this is false, it means the pagination is disabled.
+ * @property Pagination $pagination The pagination object. If this is false, it means the pagination is
+ * disabled.
  * @property Sort $sort The sorting object. If this is false, it means the sorting is disabled.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>

framework/yii/data/Pagination.php

@@ -53,13 +53,13 @@ use yii\base\Object;
  * ));
  * ~~~
  *
- * @property integer $limit The limit of the data. This may be used to set the
+ * @property integer $limit The limit of the data. This may be used to set the LIMIT value for a SQL statement
- * LIMIT value for a SQL statement for fetching the current page of data.
+ * for fetching the current page of data. Note that if the page size is infinite, a value -1 will be returned.
- * Note that if the page size is infinite, a value -1 will be returned.
+ * This property is read-only.
- * @property integer $offset The offset of the data. This may be used to set the
+ * @property integer $offset The offset of the data. This may be used to set the OFFSET value for a SQL
- * OFFSET value for a SQL statement for fetching the current page of data.
+ * statement for fetching the current page of data. This property is read-only.
  * @property integer $page The zero-based current page number.
- * @property integer $pageCount Number of pages.
+ * @property integer $pageCount Number of pages. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/data/Sort.php

@@ -65,11 +65,10 @@ use yii\helpers\Inflector;
  * sorted by the orders specified by the Sort object. In the view, we show two hyperlinks
  * that can lead to pages with the data sorted by the corresponding attributes.
  *
- * @property array $attributeOrders Sort directions indexed by attribute names.
+ * @property array $attributeOrders Sort directions indexed by attribute names. Sort direction can be either
- * Sort direction can be either [[Sort::ASC]] for ascending order or
+ * [[Sort::ASC]] for ascending order or [[Sort::DESC]] for descending order. This property is read-only.
- * [[Sort::DESC]] for descending order.
+ * @property array $orders The columns (keys) and their corresponding sort directions (values). This can be
- * @property array $orders The columns (keys) and their corresponding sort directions (values).
+ * passed to [[\yii\db\Query::orderBy()]] to construct a DB query. This property is read-only.
- * This can be passed to [[\yii\db\Query::orderBy()]] to construct a DB query.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/db/ActiveRecord.php

@@ -22,13 +22,16 @@ use yii\helpers\Inflector;
  *
  * @include @yii/db/ActiveRecord.md
  *
- * @property Connection $db the database connection used by this AR class.
+ * @property array $dirtyAttributes The changed attribute values (name-value pairs). This property is
- * @property TableSchema $tableSchema the schema information of the DB table associated with this AR class.
+ * read-only.
- * @property array $oldAttributes the old attribute values (name-value pairs).
+ * @property boolean $isNewRecord Whether the record is new and should be inserted when calling [[save()]].
- * @property array $dirtyAttributes the changed attribute values (name-value pairs).
+ * @property array $oldAttributes The old attribute values (name-value pairs).
- * @property boolean $isNewRecord whether the record is new and should be inserted when calling [[save()]].
+ * @property mixed $oldPrimaryKey The old primary key value. An array (column name => column value) is
- * @property mixed $primaryKey the primary key value.
+ * returned if the primary key is composite or `$asArray` is true. A string is returned otherwise (null will be
- * @property mixed $oldPrimaryKey the old primary key value.
+ * returned if the key value is null). This property is read-only.
+ * @property mixed $primaryKey The primary key value. An array (column name => column value) is returned if
+ * the primary key is composite or `$asArray` is true. A string is returned otherwise (null will be returned if
+ * the key value is null). This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/db/Command.php

@@ -44,7 +44,7 @@ use yii\caching\Cache;
  *
  * To build SELECT SQL statements, please use [[QueryBuilder]] instead.
  *
- * @property string $rawSql The raw SQL.
+ * @property string $rawSql The raw SQL. This property is read-only.
  * @property string $sql The SQL statement to be executed.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>

framework/yii/db/Connection.php

@@ -89,13 +89,16 @@ use yii\caching\Cache;
  * )
  * ~~~
  *
+ * @property string $driverName Name of the DB driver. This property is read-only.
  * @property boolean $isActive Whether the DB connection is established. This property is read-only.
- * @property Transaction $transaction The currently active transaction. Null if no active transaction.
+ * @property string $lastInsertID The row ID of the last row inserted, or the last value retrieved from the
- * @property Schema $schema The database schema information for the current connection.
+ * sequence object. This property is read-only.
- * @property QueryBuilder $queryBuilder The query builder.
+ * @property QueryBuilder $queryBuilder The query builder for the current DB connection. This property is
- * @property string $lastInsertID The row ID of the last row inserted, or the last value retrieved from the sequence object.
+ * read-only.
- * @property string $driverName Name of the DB driver currently being used.
+ * @property Schema $schema The schema information for the database opened by this connection. This property
- * @property array $querySummary The statistical results of SQL queries.
+ * is read-only.
+ * @property Transaction $transaction The currently active transaction. Null if no active transaction. This
+ * property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/db/DataReader.php

@@ -39,10 +39,10 @@ use yii\base\InvalidCallException;
  * [[fetchMode]]. See the [PHP manual](http://www.php.net/manual/en/function.PDOStatement-setFetchMode.php)
  * for more details about possible fetch mode.
  *
- * @property integer $columnCount The number of columns in the result set.
+ * @property integer $columnCount The number of columns in the result set. This property is read-only.
- * @property mixed $fetchMode Fetch mode.
+ * @property mixed $fetchMode Fetch mode. This property is write-only.
- * @property boolean $isClosed Whether the reader is closed or not.
+ * @property boolean $isClosed Whether the reader is closed or not. This property is read-only.
- * @property integer $rowCount Number of rows contained in the result.
+ * @property integer $rowCount Number of rows contained in the result. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/db/Schema.php

@@ -19,8 +19,12 @@ use yii\caching\GroupDependency;
  *
  * Schema represents the database schema information that is DBMS specific.
  *
- * @property string $lastInsertID The row ID of the last row inserted, or the last value retrieved from the sequence object.
+ * @property string $lastInsertID The row ID of the last row inserted, or the last value retrieved from the
- * @property QueryBuilder $queryBuilder The query builder for this connection.
+ * sequence object. This property is read-only.
+ * @property QueryBuilder $queryBuilder The query builder for this connection. This property is read-only.
+ * @property string[] $tableNames All table names in the database. This property is read-only.
+ * @property TableSchema[] $tableSchemas The metadata for all tables in the database. Each array element is an
+ * instance of [[TableSchema]] or its child class. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/db/TableSchema.php

@@ -13,7 +13,7 @@ use yii\base\InvalidParamException;
 /**
  * TableSchema represents the metadata of a database table.
  *
- * @property array $columnNames List of column names.
+ * @property array $columnNames List of column names. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/db/Transaction.php

@@ -29,8 +29,8 @@ use yii\base\InvalidConfigException;
  * }
  * ~~~
  *
- * @property boolean $isActive Whether this transaction is active. Only an active transaction
+ * @property boolean $isActive Whether this transaction is active. Only an active transaction can [[commit()]]
- * can [[commit()]] or [[rollback()]].
+ * or [[rollback()]]. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/db/redis/Connection.php

@@ -21,9 +21,10 @@ use yii\helpers\StringHelper;
  * @method mixed get($key) Set the string value of a key
  * TODO document methods
  *
- * @property string $driverName Name of the DB driver.
+ * @property string $driverName Name of the DB driver. This property is read-only.
- * @property boolean $isActive Whether the DB connection is established.
+ * @property boolean $isActive Whether the DB connection is established. This property is read-only.
- * @property Transaction $transaction The currently active transaction. Null if no active transaction.
+ * @property Transaction $transaction The currently active transaction. Null if no active transaction. This
+ * property is read-only.
  *
  * @author Carsten Brandt <mail@cebe.cc>
  * @since 2.0

framework/yii/db/redis/Transaction.php

@@ -15,8 +15,8 @@ use yii\db\Exception;
 /**
  * Transaction represents a DB transaction.
  *
- * @property boolean $isActive Whether this transaction is active. Only an active transaction
+ * @property boolean $isActive Whether this transaction is active. Only an active transaction can [[commit()]]
- * can [[commit()]] or [[rollBack()]].
+ * or [[rollBack()]]. This property is read-only.
  *
  * @author Carsten Brandt <mail@cebe.cc>
  * @since 2.0

framework/yii/debug/Panel.php

@@ -14,10 +14,10 @@ use yii\base\Component;
  * Panel is a base class for debugger panel classes. It defines how data should be collected,
  * what should be displayed at debug toolbar and on debugger details view.
  *
- * @property string $detail Content that is displayed in debugger detail view.
+ * @property string $detail Content that is displayed in debugger detail view. This property is read-only.
- * @property string $name Name of the panel.
+ * @property string $name Name of the panel. This property is read-only.
- * @property string $summary Content that is displayed at debug toolbar.
+ * @property string $summary Content that is displayed at debug toolbar. This property is read-only.
- * @property string $url URL pointing to panel detail view.
+ * @property string $url URL pointing to panel detail view. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/gii/CodeFile.php

@@ -16,8 +16,9 @@ use yii\helpers\StringHelper;
 /**
  * CodeFile represents a code file to be generated.
  *
- * @property string $relativePath The code file path relative to the application base path.
+ * @property string $relativePath The code file path relative to the application base path. This property is
- * @property string $type The code file extension (e.g. php, txt).
+ * read-only.
+ * @property string $type The code file extension (e.g. php, txt). This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/gii/Generator.php

@@ -27,9 +27,11 @@ use yii\base\View;
  * - [[generate()]]: generates the code based on the current user input and the specified code template files.
  *   This is the place where main code generation code resides.
  *
- * @property string $description The detailed description of the generator.
+ * @property string $description The detailed description of the generator. This property is read-only.
- * @property string $stickyDataFile The file path that stores the sticky attribute values.
+ * @property string $stickyDataFile The file path that stores the sticky attribute values. This property is
- * @property string $templatePath The root path of the template files that are currently being used.
+ * read-only.
+ * @property string $templatePath The root path of the template files that are currently being used. This
+ * property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/log/Logger.php

@@ -61,11 +61,12 @@ use yii\base\InvalidConfigException;
  * When the application ends or [[flushInterval]] is reached, Logger will call [[flush()]]
  * to send logged messages to different log targets, such as file, email, Web.
  *
- * @property array $dbProfiling The first element indicates the number of SQL statements executed,
+ * @property array $dbProfiling The first element indicates the number of SQL statements executed, and the
- * and the second element the total time spent in SQL execution.
+ * second element the total time spent in SQL execution. This property is read-only.
- * @property float $elapsedTime The total elapsed time in seconds for current request.
+ * @property float $elapsedTime The total elapsed time in seconds for current request. This property is
+ * read-only.
  * @property array $profiling The profiling results. Each array element has the following structure:
- *  `array($token, $category, $time)`.
+ * `array($token, $category, $time)`. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/log/Target.php

@@ -22,8 +22,8 @@ use yii\base\InvalidConfigException;
  * satisfying both filter conditions will be handled. Additionally, you
  * may specify [[except]] to exclude messages of certain categories.
  *
- * @property integer $levels The message levels that this target is interested in. This is a bitmap of
+ * @property integer $levels The message levels that this target is interested in. This is a bitmap of level
- * level values. Defaults to 0, meaning  all available levels.
+ * values. Defaults to 0, meaning  all available levels.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/rbac/DbManager.php

@@ -24,6 +24,8 @@ use yii\base\InvalidParamException;
  * the three tables used to store the authorization data by setting [[itemTable]],
  * [[itemChildTable]] and [[assignmentTable]].
  *
+ * @property Item[] $items The authorization items of the specific type. This property is read-only.
+ *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @author Alexander Kochetov <creocoder@gmail.com>
  * @since 2.0

framework/yii/rbac/Item.php

@@ -18,6 +18,7 @@ use yii\base\Object;
  * A user may be assigned one or several authorization items (called [[Assignment]] assignments).
  * He can perform an operation only when it is among his assigned items.
  *
+ * @property Item[] $children All child items of this item. This property is read-only.
  * @property string $name The item name.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>

framework/yii/rbac/Manager.php

@@ -33,9 +33,9 @@ use yii\base\InvalidParamException;
  * at appropriate places in the application code to check if the current user
  * has the needed permission for an operation.
  *
- * @property array $roles Roles (name => Item).
+ * @property Item[] $operations Operations (name => AuthItem). This property is read-only.
- * @property array $tasks Tasks (name => Item).
+ * @property Item[] $roles Roles (name => AuthItem). This property is read-only.
- * @property array $operations Operations (name => Item).
+ * @property Item[] $tasks Tasks (name => AuthItem). This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @author Alexander Kochetov <creocoder@gmail.com>

framework/yii/rbac/PhpManager.php

@@ -23,7 +23,7 @@ use yii\base\InvalidParamException;
  * (for example, the authorization data for a personal blog system).
  * Use [[DbManager]] for more complex authorization data.
  *
- * @property array $authItems The authorization items of the specific type.
+ * @property Item[] $items The authorization items of the specific type. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @author Alexander Kochetov <creocoder@gmail.com>

framework/yii/validators/FileValidator.php

@@ -13,7 +13,7 @@ use yii\web\UploadedFile;
 /**
  * FileValidator verifies if an attribute is receiving a valid uploaded file.
  *
- * @property integer $sizeLimit The size limit for uploaded files.
+ * @property integer $sizeLimit The size limit for uploaded files. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/Application.php

@@ -13,12 +13,12 @@ use yii\base\InvalidRouteException;
 /**
  * Application is the base class for all application classes.
  *
- * @property AssetManager $assetManager The asset manager component.
+ * @property AssetManager $assetManager The asset manager component. This property is read-only.
  * @property string $homeUrl The homepage URL.
- * @property Request $request The request component.
+ * @property Request $request The request component. This property is read-only.
- * @property Response $response The response component.
+ * @property Response $response The response component. This property is read-only.
- * @property Session $session The session component.
+ * @property Session $session The session component. This property is read-only.
- * @property User $user The user component.
+ * @property User $user The user component. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/CacheSession.php

@@ -21,7 +21,7 @@ use yii\base\InvalidConfigException;
  * may be swapped out and get lost. Therefore, you must make sure the cache used by this component
  * is NOT volatile. If you want to use database as storage medium, use [[DbSession]] is a better choice.
  *
- * @property boolean $useCustomStorage Whether to use custom storage.
+ * @property boolean $useCustomStorage Whether to use custom storage. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/CookieCollection.php

@@ -15,8 +15,9 @@ use yii\base\Object;
 /**
  * CookieCollection maintains the cookies available in the current request.
  *
- * @property integer $count The number of cookies in the collection.
+ * @property integer $count The number of cookies in the collection. This property is read-only.
- * @property ArrayIterator $iterator An iterator for traversing the cookies in the collection.
+ * @property ArrayIterator $iterator An iterator for traversing the cookies in the collection. This property
+ * is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/DbSession.php

@@ -28,7 +28,7 @@ use yii\base\InvalidConfigException;
  * )
  * ~~~
  *
- * @property boolean $useCustomStorage Whether to use custom storage.
+ * @property boolean $useCustomStorage Whether to use custom storage. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/HeaderCollection.php

@@ -14,8 +14,9 @@ use ArrayIterator;
 /**
  * HeaderCollection is used by [[Response]] to maintain the currently registered HTTP headers.
  *
- * @property integer $count The number of headers in the collection.
+ * @property integer $count The number of headers in the collection. This property is read-only.
- * @property ArrayIterator $iterator An iterator for traversing the headers in the collection.
+ * @property ArrayIterator $iterator An iterator for traversing the headers in the collection. This property
+ * is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/Request.php

@@ -13,45 +13,49 @@ use yii\helpers\Security;
 
 /**
  *
- * @property string $absoluteUrl The currently requested absolute URL.
+ * @property string $absoluteUrl The currently requested absolute URL. This property is read-only.
- * @property string $acceptTypes User browser accept types, null if not present.
+ * @property string $acceptTypes User browser accept types, null if not present. This property is read-only.
  * @property array $acceptedContentTypes The content types ordered by the preference level. The first element
  * represents the most preferred content type.
  * @property array $acceptedLanguages The languages ordered by the preference level. The first element
  * represents the most preferred language.
  * @property string $baseUrl The relative URL for the application.
- * @property string $cookieValidationKey The secret key used for cookie validation. If it was not set previously,
+ * @property string $cookieValidationKey The secret key used for cookie validation. If it was not set
- * a random key will be generated and used.
+ * previously, a random key will be generated and used.
- * @property CookieCollection $cookies The cookie collection.
+ * @property CookieCollection $cookies The cookie collection. This property is read-only.
- * @property string $csrfToken The random token for CSRF validation.
+ * @property string $csrfToken The random token for CSRF validation. This property is read-only.
- * @property string $hostInfo Schema and hostname part (with port number if needed) of the request URL (e.g. `http://www.yiiframework.com`).
+ * @property string $hostInfo Schema and hostname part (with port number if needed) of the request URL (e.g.
- * @property boolean $isAjax Whether this is an AJAX (XMLHttpRequest) request.
+ * `http://www.yiiframework.com`).
- * @property boolean $isDelete Whether this is a DELETE request.
+ * @property boolean $isAjax Whether this is an AJAX (XMLHttpRequest) request. This property is read-only.
- * @property boolean $isFlash Whether this is an Adobe Flash or Adobe Flex request.
+ * @property boolean $isDelete Whether this is a DELETE request. This property is read-only.
- * @property boolean $isPatch Whether this is a PATCH request.
+ * @property boolean $isFlash Whether this is an Adobe Flash or Adobe Flex request. This property is
- * @property boolean $isPost Whether this is a POST request.
+ * read-only.
- * @property boolean $isPut Whether this is a PUT request.
+ * @property boolean $isPatch Whether this is a PATCH request. This property is read-only.
- * @property boolean $isSecureConnection If the request is sent via secure channel (https).
+ * @property boolean $isPost Whether this is a POST request. This property is read-only.
- * @property string $method Request method, such as GET, POST, HEAD, PUT, PATCH, DELETE.
+ * @property boolean $isPut Whether this is a PUT request. This property is read-only.
- * The value returned is turned into upper case.
+ * @property boolean $isSecureConnection If the request is sent via secure channel (https). This property is
- * @property string $pathInfo Part of the request URL that is after the entry script and before the question mark.
+ * read-only.
- * Note, the returned path info is already URL-decoded.
+ * @property string $method Request method, such as GET, POST, HEAD, PUT, PATCH, DELETE. The value returned is
+ * turned into upper case. This property is read-only.
+ * @property string $pathInfo Part of the request URL that is after the entry script and before the question
+ * mark. Note, the returned path info is already URL-decoded.
  * @property integer $port Port number for insecure requests.
- * @property string $preferredLanguage The language that the application should use. Null is returned if both [[getAcceptedLanguages()]]
+ * @property string $preferredLanguage The language that the application should use. Null is returned if both
- * and `$languages` are empty.
+ * [[getAcceptedLanguages()]] and `$languages` are empty. This property is read-only.
- * @property string $queryString Part of the request URL that is after the question mark.
+ * @property string $queryString Part of the request URL that is after the question mark. This property is
- * @property string $rawBody The request body.
+ * read-only.
- * @property string $referrer URL referrer, null if not present.
+ * @property string $rawBody The request body. This property is read-only.
+ * @property string $referrer URL referrer, null if not present. This property is read-only.
  * @property array $restParams The RESTful request parameters.
  * @property string $scriptFile The entry script file path.
  * @property string $scriptUrl The relative URL of the entry script.
  * @property integer $securePort Port number for secure requests.
- * @property string $serverName Server name.
+ * @property string $serverName Server name. This property is read-only.
- * @property integer $serverPort Server port number.
+ * @property integer $serverPort Server port number. This property is read-only.
  * @property string $url The currently requested relative URL. Note that the URI returned is URL-encoded.
- * @property string $userAgent User agent, null if not present.
+ * @property string $userAgent User agent, null if not present. This property is read-only.
- * @property string $userHost User host name, null if cannot be determined.
+ * @property string $userHost User host name, null if cannot be determined. This property is read-only.
- * @property string $userIP User IP address.
+ * @property string $userIP User IP address. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/Response.php

@@ -18,18 +18,22 @@ use yii\helpers\StringHelper;
 
 /**
  *
- * @property CookieCollection $cookies The cookie collection.
+ * @property CookieCollection $cookies The cookie collection. This property is read-only.
- * @property HeaderCollection $headers The header collection.
+ * @property HeaderCollection $headers The header collection. This property is read-only.
- * @property boolean $isClientError Whether this response indicates a client error.
+ * @property boolean $isClientError Whether this response indicates a client error. This property is
- * @property boolean $isEmpty Whether this response is empty.
+ * read-only.
- * @property boolean $isForbidden Whether this response indicates the current request is forbidden.
+ * @property boolean $isEmpty Whether this response is empty. This property is read-only.
- * @property boolean $isInformational Whether this response is informational.
+ * @property boolean $isForbidden Whether this response indicates the current request is forbidden. This
- * @property boolean $isInvalid Whether this response has a valid [[statusCode]].
+ * property is read-only.
- * @property boolean $isNotFound Whether this response indicates the currently requested resource is not found.
+ * @property boolean $isInformational Whether this response is informational. This property is read-only.
- * @property boolean $isOk Whether this response is OK.
+ * @property boolean $isInvalid Whether this response has a valid [[statusCode]]. This property is read-only.
- * @property boolean $isRedirection Whether this response is a redirection.
+ * @property boolean $isNotFound Whether this response indicates the currently requested resource is not
- * @property boolean $isServerError Whether this response indicates a server error.
+ * found. This property is read-only.
- * @property boolean $isSuccessful Whether this response is successful.
+ * @property boolean $isOk Whether this response is OK. This property is read-only.
+ * @property boolean $isRedirection Whether this response is a redirection. This property is read-only.
+ * @property boolean $isServerError Whether this response indicates a server error. This property is
+ * read-only.
+ * @property boolean $isSuccessful Whether this response is successful. This property is read-only.
  * @property integer $statusCode The HTTP status code to send with the response.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>

framework/yii/web/Session.php

@@ -45,23 +45,27 @@ use yii\base\InvalidParamException;
  * useful for displaying confirmation messages. To use flash messages, simply
  * call methods such as [[setFlash()]], [[getFlash()]].
  *
- * @property array $allFlashes Flash messages (key => message).
+ * @property array $allFlashes Flash messages (key => message). This property is read-only.
  * @property array $cookieParams The session cookie parameters.
- * @property integer $count The number of session variables.
+ * @property integer $count The number of session variables. This property is read-only.
- * @property string $flash The key identifying the flash message. Note that flash messages
+ * @property string $flash The key identifying the flash message. Note that flash messages and normal session
- * and normal session variables share the same name space. If you have a normal
+ * variables share the same name space. If you have a normal session variable using the same name, its value will
- * session variable using the same name, its value will be overwritten by this method.
+ * be overwritten by this method. This property is write-only.
- * @property float $gCProbability The probability (percentage) that the GC (garbage collection) process is started on every session initialization, defaults to 1 meaning 1% chance.
+ * @property float $gCProbability The probability (percentage) that the GC (garbage collection) process is
+ * started on every session initialization, defaults to 1 meaning 1% chance.
  * @property string $id The current session ID.
- * @property boolean $isActive Whether the session has started.
+ * @property boolean $isActive Whether the session has started. This property is read-only.
- * @property SessionIterator $iterator An iterator for traversing the session variables.
+ * @property SessionIterator $iterator An iterator for traversing the session variables. This property is
+ * read-only.
  * @property string $name The current session name.
  * @property string $savePath The current session save path, defaults to '/tmp'.
  * @property integer $timeout The number of seconds after which data will be seen as 'garbage' and cleaned up.
  * The default value is 1440 seconds (or the value of "session.gc_maxlifetime" set in php.ini).
- * @property boolean|null $useCookies The value indicating whether cookies should be used to store session IDs.
+ * @property boolean|null $useCookies The value indicating whether cookies should be used to store session
- * @property boolean $useCustomStorage Whether to use custom storage.
+ * IDs.
- * @property boolean $useTransparentSessionID Whether transparent sid support is enabled or not, defaults to false.
+ * @property boolean $useCustomStorage Whether to use custom storage. This property is read-only.
+ * @property boolean $useTransparentSessionID Whether transparent sid support is enabled or not, defaults to
+ * false.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/UploadedFile.php

@@ -11,17 +11,16 @@ use yii\helpers\Html;
 
 /**
  *
- * @property integer $error The error code.
+ * @property integer $error The error code. This property is read-only.
- * @property boolean $hasError Whether there is an error with the uploaded file.
+ * @property boolean $hasError Whether there is an error with the uploaded file. Check [[error]] for detailed
- * Check [[error]] for detailed error code information.
+ * error code information. This property is read-only.
- * @property string $name The original name of the file being uploaded.
+ * @property string $name The original name of the file being uploaded. This property is read-only.
- * @property integer $size The actual size of the uploaded file in bytes.
+ * @property integer $size The actual size of the uploaded file in bytes. This property is read-only.
- * @property string $tempName The path of the uploaded file on the server.
+ * @property string $tempName The path of the uploaded file on the server. Note, this is a temporary file
- * Note, this is a temporary file which will be automatically deleted by PHP
+ * which will be automatically deleted by PHP after the current request is processed. This property is read-only.
- * after the current request is processed.
+ * @property string $type The MIME-type of the uploaded file (such as "image/gif"). Since this MIME type is
- * @property string $type The MIME-type of the uploaded file (such as "image/gif").
+ * not checked on the server side, do not take this value for granted. Instead, use [[FileHelper::getMimeType()]]
- * Since this MIME type is not checked on the server side, do not take this value for granted.
+ * to determine the exact MIME type. This property is read-only.
- * Instead, use [[FileHelper::getMimeType()]] to determine the exact MIME type.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/UrlManager.php

@@ -15,7 +15,8 @@ use yii\caching\Cache;
  * UrlManager handles HTTP request parsing and creation of URLs based on a set of rules.
  *
  * @property string $baseUrl The base URL that is used by [[createUrl()]] to prepend URLs it creates.
- * @property string $hostInfo The host info (e.g. "http://www.example.com") that is used by [[createAbsoluteUrl()]] to prepend URLs it creates.
+ * @property string $hostInfo The host info (e.g. "http://www.example.com") that is used by
+ * [[createAbsoluteUrl()]] to prepend URLs it creates.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0

framework/yii/web/User.php

@@ -21,9 +21,10 @@ use yii\base\InvalidConfigException;
  * the actual user authentication logic and is often backed by a user database table.
  *
  * @property string|integer $id The unique identifier for the user. If null, it means the user is a guest.
- * @property Identity $identity The identity object associated with the currently logged user.
+ * This property is read-only.
- * Null is returned if the user is not logged in (not authenticated).
+ * @property Identity $identity The identity object associated with the currently logged user. Null is
- * @property boolean $isGuest Whether the current user is a guest.
+ * returned if the user is not logged in (not authenticated).
+ * @property boolean $isGuest Whether the current user is a guest. This property is read-only.
  * @property string $returnUrl The URL that the user should be redirected to after login.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>

framework/yii/widgets/FragmentCache.php

@@ -14,7 +14,8 @@ use yii\caching\Dependency;
 
 /**
  *
- * @property string|boolean $cachedContent The cached content. False is returned if valid content is not found in the cache.
+ * @property string|boolean $cachedContent The cached content. False is returned if valid content is not found
+ * in the cache. This property is read-only.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @since 2.0