From 68208c0382ce3a97e2119b15fe1ce08ae032a143 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=B8=9C=E6=96=B9=E5=AD=A4=E6=80=9D=E5=AD=90=EF=BC=88Pari?= =?UTF-8?q?s=C2=B7QianSen=EF=BC=89?= Date: Thu, 19 Jun 2014 01:23:52 +0800 Subject: [PATCH 1/5] Add Chinese Translation Team --- docs/internals/translation-teams.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/internals/translation-teams.md b/docs/internals/translation-teams.md index f216571..267f46a 100644 --- a/docs/internals/translation-teams.md +++ b/docs/internals/translation-teams.md @@ -7,6 +7,13 @@ Brazilian Portuguese - **[@wbraganca](https://github.com/wbraganca)** - Alan Michel Willms Quinot, [@alanwillms](https://github.com/alanwillms), dyulax@gmail.com +China +----- + +- **Paris Qian Sen 东方孤思子,[@qiansen1386](https://github.com/qiansen1386),qiansen1386ATgmail.com** +- [@Aliciamiao](https://github.com/aliciamiao) +- [@riverlet ](https://github.com/riverlet) + German ------ From 7e29f957424b7a9472b46b5f4af1095788a83e56 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=B8=9C=E6=96=B9=E5=AD=A4=E6=80=9D=E5=AD=90=EF=BC=88Pari?= =?UTF-8?q?s=C2=B7QianSen=EF=BC=89?= Date: Mon, 23 Jun 2014 05:03:18 +0800 Subject: [PATCH 2/5] Update README [skip ci] --- docs/guide-zh-CN/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guide-zh-CN/README.md b/docs/guide-zh-CN/README.md index 9c57eb5..bc0e4c6 100644 --- a/docs/guide-zh-CN/README.md +++ b/docs/guide-zh-CN/README.md @@ -35,9 +35,9 @@ Yii 2.0 权威指南 * **已定稿** [控制器（Controller）](structure-controllers.md) * **已定稿** [视图（View）](structure-views.md) * **已定稿** [模型（Model）](structure-models.md) -* **待定中** [过滤器](structure-filters.md) +* **已定稿** [过滤器](structure-filters.md) * **待定中** [小部件（Widget）](structure-widgets.md) -* **待定中** [模块（Module）](structure-modules.md) +* **已定稿** [模块（Module）](structure-modules.md) * **编撰中** [前端资源（Asset）](structure-assets.md) * **待定中** [扩展（extensions）](structure-extensions.md) @@ -185,7 +185,7 @@ RESTful Web 服务 助手类 ------ -* **编撰中** [概述](helper-overview.md) +* **编撰中** [助手一览](helper-overview.md) * **待定中** [ArrayHelper](helper-array.md) * **待定中** [Html](helper-html.md) * **待定中** [Url](helper-url.md) From ff9101029910cc709c82f7547466d0612c4a7e8d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=B8=9C=E6=96=B9=E5=AD=A4=E6=80=9D=E5=AD=90=EF=BC=88Pari?= =?UTF-8?q?s=C2=B7QianSen=EF=BC=89?= Date: Mon, 23 Jun 2014 05:04:18 +0800 Subject: [PATCH 3/5] transalating intro-upgrade-from-v1, left with asset, query builder, form, etc. --- docs/guide-zh-CN/intro-upgrade-from-v1.md | 473 ++++++++++++++++++++++++++++++ 1 file changed, 473 insertions(+) create mode 100644 docs/guide-zh-CN/intro-upgrade-from-v1.md diff --git a/docs/guide-zh-CN/intro-upgrade-from-v1.md b/docs/guide-zh-CN/intro-upgrade-from-v1.md new file mode 100644 index 0000000..c62f5cc --- /dev/null +++ b/docs/guide-zh-CN/intro-upgrade-from-v1.md @@ -0,0 +1,473 @@ +从 Yii 1.1 升级 +=============== + +因为 2.0 框架是完完全全的重写，所以在 1.1 和 2.0 两个版本之间，存在了很多不同之处。因此，从 1.1 版本升级的过程并不像小版本间的跨越那么简单，在本手册中你将会了解两个版本间主要的不同之处。 + +如果你原先没有用过 Yii 1.1， 你可以直接跳过本章，直接从"[入门篇](start-installation.md)"开始读起。 + +请注意，Yii 2.0 引入了很多这篇总结文章并没有涉及到的新功能。我们强烈建议你通读整部权威手册，来了解所有新功能新特色。这样你将有机会发现一些以前你可能要自己开发的功能，而现在他们很可能已经被包含在核心代码中了也说不定。 + + +安装 +------------ + +Yii 2.0 完全拥抱 [Composer](https://getcomposer.org/) 的使用，它其实是实际上的 PHP +包管理器。核心框架以及扩展的安装，都通过 Composer 来处理。想要了解更多如何安装 Yii 2.0 +请参阅本指南的 [安装 Yii](start-installation.md) 章节。如果你想创建新的扩展，或者把你已有的 Yii 1.1 的扩展改写成兼容 +2.0 的版本，你可以参考 [创建扩展](extend-creating-extensions.md) 章节。 + + +PHP 需求 +---------------- + +Yii 2.0 requires PHP 5.4 or above, which is a huge improvement over PHP version 5.2 that is required by Yii 1.1. +As a result, there are many differences on the language level that you should pay attention to. +Below is a summary of the major changes regarding PHP: + +- [命名空间](http://php.net/manual/zh/language.namespaces.php) +- [匿名函数](http://php.net/manual/zh/functions.anonymous.php) +- 数组短语法 `[...元素...]` 用于取代 `array(...元素...)` +- 短格式的 echo 标签 ` 'MyClass', + 'property1' => 'abc', + 'property2' => 'cde', +], [$param1, $param2]); +``` + +更多有关配置的细节可以在 [对象配置](concept-configurations.md) 章节找到。 + + +事件（Event） +------ + +在 Yii 1 里，我们通常通过定义 `on` 开头的方法 (比如 `onBeforeSave`)，来创建事件。而在 Yii 2 中，你可以使用任意的事件名了。同时通过调用 +[[yii\base\Component::trigger()|trigger()]] 方法来触发相关事件： + +```php +$event = new \yii\base\Event; +$component->trigger($eventName, $event); +``` + +要给事件附加一个事件句柄（Event Handler 或者叫事件处理器），需要使用 [[yii\base\Component::on()|on()]] 方法： + +```php +$component->on($eventName, $handler); +// 要解除相关句柄，使用 off 方法： +// $component->off($eventName, $handler); +``` + +其实事件功能还有更多改进之处。要了解它们，请查看 [事件（Event）](concept-events.md) 章节。 + + +路径别名（Path Alias） +------------ + +Yii 2.0 扩展类路径别名的应用，文件/目录路径和 URLs 都可以使用路径别名啦。Yii 2.0 +中路径别名必须以 `@` 符号开头，以区别于普通文件目录路径或 URL。 +比如，`@yii` 就是指向 Yii 安装目录别名。路径别名现在被绝大多数的 Yii 核心代码所支持。比如 +[[yii\caching\FileCache::cachePath]] 就同时支持输入一个路径别名或一个普通的目录地址。 + +路径别名也和类的命名空间密切相关。建议给每一个根命名空间定义一个路径别名，从而无须额外配置，便可启动 Yii +的类自动加载机制。比如，因为有 `@yii` 指向 Yii 安装目录，那类似 `yii\web\Request` +的类就能被 Yii 自动加载。同理，若你用了一个第三方的类库，比如 Zend 框架，你只需定义一个名为 `@Zend` +的路径别名，去指向该框架的安装目录。之后，Yii 就可以自动加载任意 Zend Framework Library 中的类了。 + +更多路径别名信息请参阅[路径别名](concept-aliases.md)章节。 + + +视图（View） +----- + +Yii 2 的视图最显著的改动是视图内的特殊变量 `$this` 不再指向当前控制器或小部件，而是指向 *视图* 对象。它是一个 2.0 +中引入的全新概念。*视图* 对象为 [[yii\web\View]] 的实例，他代表了 MVC 模式中的视图部分。如果你想要在视图中访问一个控制器或者小部件，你可以使用 +`$this->context`。 + +要在其他视图里渲染一个局部视图，你要用 `$this->render()`，而不是 `$this->renderPartial()`。`render` 的调用也发成了变化，因为 +`render()` 现在只返回渲染结果，而不是直接显示它，所以现在你必须显式地把它 **echo** 出来。像这样： + +```php +echo $this->render('_item', ['item' => $item]); +``` + +除了使用 PHP 作为主要的模板语言，Yii 2.0 也装备了两种时髦模板引擎的官方支持：Smarty 和 Twig。过去的 Prado +模板引擎不再被支持。要使用这些模板引擎，你需要配置 `view` 应用组件，给它设置 [[yii\base\View::$renderers|View::$renderers]] +属性。具体请参阅[模板引擎](tutorial-template-engines.md)章节。 + + +模型（Model） +------ + +Yii 2.0使用 [[yii\base\Model]] 作为模型基类，类似于1.1的 `CModel` 。`CFormModel` +被完全弃用了，现在要创建表单模型类，可以通过继承 [[yii\base\Model]] 类来实现。 + +Yii 2.0 引进了名为 [[yii\base\Model::scenarios()|scenarios()]] +的新方法来声明支持的场景，并注明在哪个场景下某属性赋值必须验证，可否被视为安全赋值，等等。如： + +```php +public function scenarios() +{ + return [ + 'backend' => ['email', 'role'], + 'frontend' => ['email', '!role'], + ]; +} +``` + +上面的代码声明了两个场景：`backend` 和 `frontend` 。对于 `backend` 场景，`email` 和 `role` +属性值都是安全的，且能进行批量赋值；对于 `frontend` 场景，`email` 能批量赋值而 `role` 不能。而 `email` 和 `role` 都必须通过规则验证。 + +[[yii\base\Model::rules()|rules()]] 方法仍用于声明验证规则。注意，由于引进了 [[yii\base\Model::scenarios()|scenarios()]] +，现在已经没有 `unsafe` 验证器了。 + +大多数情况下，如果 [[yii\base\Model::rules()|rules()]] 方法内已经完整地指定场景了，那就不必覆写 [[yii\base\Model::scenarios()|scenarios()]] +，也不必声明 `unsafe` 属性值。 + +要了解更多有关模型的细节，请参考[模型](structure-models.md)章节。 + +控制器（Controller） +----------- + +Yii 2.0 使用 [[yii\web\Controller]] 作为控制器的基类，类似于 1.1 的 `CWebController`。使用 [[yii\base\Action]] +作为操作类的基类。 + +这些变化最明显的影响是，当你在写控制器操作的代码时，你应该返回（return）要渲染的内容而不是输出（echo）它： + +```php +public function actionView($id) +{ + $model = \app\models\Post::findOne($id); + if ($model) { + return $this->render('view', ['model' => $model]); + } else { + throw new \yii\web\NotFoundHttpException; + } +} +``` + +请查看 [控制器（Controller）](structure-controllers.md) 章节了解有关控制器的更多细节。 + + +小部件（Widget） +------- + +Yii 2.0 使用 [[yii\base\Widget]] 作为小部件基类，类似于1.1的 `CWidget` + +为了让 IDE 更好地支持框架，Yii 2.0 引进了一个调用小部件的新语法。就是引入了 [[yii\base\Widget::begin()|begin()]]， [[yii\base\Widget::end()|end()]] +和 [[yii\base\Widget::widget()|widget()]] 三个静态方法，用法如下： + +```php +use yii\widgets\Menu; +use yii\widgets\ActiveForm; + +// 注意必须 **"echo"** 结果以显示内容 +echo Menu::widget(['items' => $items]); + +// 传递一个用于初始化对象属性的数组 +$form = ActiveForm::begin([ + 'options' => ['class' => 'form-horizontal'], + 'fieldConfig' => ['inputOptions' => ['class' => 'input-xlarge']], +]); +... 表单输入栏都在这里 ... +ActiveForm::end(); +``` + +更多细节请参阅 [小部件](structure-widgets.md)章节。 + + +主题（Theme） +------ + +Themes work completely differently in 2.0. They are now based on a path mapping mechanism that maps a source +view file path to a themed view file path. For example, if the path map for a theme is +`['/web/views' => '/web/themes/basic']`, then the themed version for the view file +`/web/views/site/index.php` will be `/web/themes/basic/site/index.php`. For this reason, themes can now +be applied to any view file, even a view rendered outside of the context of a controller or a widget. + +Also, there is no more `CThemeManager` component. Instead, `theme` is a configurable property of the `view` +application component. + +更多细节请参考[主题](output-theming.md)章节。 + + +控制台应用（Console Application） +-------------------- + +Console applications are now organized as controllers, like Web applications. Console controllers +should extend from [[yii\console\Controller]], similar to `CConsoleCommand` in 1.1. + +To run a console command, use `yii `, where `` stands for a controller route +(e.g. `sitemap/index`). Additional anonymous arguments are passed as the parameters to the +corresponding controller action method, while named arguments are parsed according to +the declarations in [[yii\console\Controller::options()]]. + +Yii 2.0 supports automatic generation of command help information from comment blocks. + +更多细节请参阅[控制台命令](tutorial-console.md)章节。 + + +国际化（I18N） +---- + +Yii 2.0 移除了原来内置的日期格式器和数字格式器，为了方便 [PECL intl PHP module](http://pecl.php.net/package/intl) （PHP 的国际化扩展）模块的使用。 + +消息翻译现在由 `i18n` 应用组件执行。该组件管理一系列消息源，允许使用基于消息类别的不同消息源。 + +更多细节请参阅[国际化（Internationalization）](tutorial-i18n.md)章节。 + + +操作过滤器（Action Filters） +-------------- + +操作的过滤现在通过行为（behavior）来实现。要定义一个新的，自定义的过滤器，请继承 [[yii\base\ActionFilter]] +类。要使用一个过滤器，需要把过滤器类作为一个 `behavior` 绑定到控制器上。比如，要使用 [[yii\filters\AccessControl]] +过滤器，你需要在控制器内添加如下代码： + +```php +public function behaviors() +{ + return [ + 'access' => [ + 'class' => 'yii\filters\AccessControl', + 'rules' => [ + ['allow' => true, 'actions' => ['admin'], 'roles' => ['@']], + ], + ], + ]; +} +``` + +更多细节请参考[过滤器](structure-filters.md)章节。 + + +前端资源（Assets） +------ + +Yii 2.0 introduces a new concept called *asset bundle* that replaces the script package concept found in Yii 1.1. + +An asset bundle is a collection of asset files (e.g. JavaScript files, CSS files, image files, etc.) +within a directory. Each asset bundle is represented as a class extending [[yii\web\AssetBundle]]. +By registering an asset bundle via [[yii\web\AssetBundle::register()]], you make +the assets in that bundle accessible via the Web. Unlike in Yii 1, the page registering the bundle will automatically +contain the references to the JavaScript and CSS files specified in that bundle. + +更多细节请参阅 [前端资源管理（Asset）](structure-assets.md) 章节。 + + +助手类（Helpers） +------- + +Yii 2.0 很多常用的静态助手类，包括： + +* [[yii\helpers\Html]] +* [[yii\helpers\ArrayHelper]] +* [[yii\helpers\StringHelper]] +* [[yii\helpers\FileHelper]] +* [[yii\helpers\Json]] +* [[yii\helpers\Security]] + +请参考 [助手一览](helper-overview.md) 章节来了解更多。 + +表单 +----- + +Yii 2.0 introduces the *field* concept for building a form using [[yii\widgets\ActiveForm]]. A field +is a container consisting of a label, an input, an error message, and/or a hint text. +A field is represented as an [[yii\widgets\ActiveField|ActiveField]] object. +Using fields, you can build a form more cleanly than before: + +```php + + field($model, 'username') ?> + field($model, 'password')->passwordInput() ?> +
+ +
+ +``` + +请参考 [创建表单](input-forms.md) 章节来了解更多细节。 + + +查询生成器（Query Builder） +------------- + +In 1.1, query building was scattered among several classes, including `CDbCommand`, +`CDbCriteria`, and `CDbCommandBuilder`. Yii 2.0 represents a DB query in terms of a [[yii\db\Query|Query]] object +that can be turned into a SQL statement with the help of [[yii\db\QueryBuilder|QueryBuilder]] behind the scene. +For example: + +```php +$query = new \yii\db\Query(); +$query->select('id, name') + ->from('user') + ->limit(10); + +$command = $query->createCommand(); +$sql = $command->sql; +$rows = $command->queryAll(); +``` + +Best of all, such query building methods can also be used when working with [Active Record](db-active-record.md). + +请参考[查询生成器（Query Builder）](db-query-builder.md) 章节了解更多内容。 + + +活动记录（Active Record） +------------- + +Yii 2.0 的[活动记录](db-active-record.md)改动了很多。两个最显而易见的改动分别涉及构建查询（query +building）和关联查询的处理（relational query handling）。 + +在 1.1 中的 `CDbCriteria` 类在 Yii 2 中被 [[yii\db\ActiveQuery]] （活动查询）所替代。这个类是继承自 +[[yii\db\Query]]，且继承了所有的 +The `CDbCriteria` class in 1.1 is replaced by [[yii\db\ActiveQuery]] in Yii 2. That class extends from [[yii\db\Query]], and thus +inherits all query building methods. You call [[yii\db\ActiveRecord::find()]] to start building a query: + +```php +// To retrieve all *active* customers and order them by their ID: +$customers = Customer::find() + ->where(['status' => $active]) + ->orderBy('id') + ->all(); +``` + +To declare a relation, simply define a getter method that returns an [[yii\db\ActiveQuery|ActiveQuery]] object. +The property name defined by the getter represents the relation name. For example, the following code declares +an `orders` relation (in 1.1, you would have to declare relations in a central place `relations()`): + +```php +class Customer extends \yii\db\ActiveRecord +{ + public function getOrders() + { + return $this->hasMany('Order', ['customer_id' => 'id']); + } +} +``` + +Now you can use `$customer->orders` to access a customer's orders from the related table. You can also use the following code +to perform an on-the-fly relational query with a customized query condition: + +```php +$orders = $customer->getOrders()->andWhere('status=1')->all(); +``` + +When eager loading a relation, Yii 2.0 does it differently from 1.1. In particular, in 1.1 a JOIN query +would be created to select both the primary and the relational records. In Yii 2.0, two SQL statements are executed +without using JOIN: the first statement brings back the primary records and the second brings back the relational +records by filtering with the primary keys of the primary records. + +Instead of returning [[yii\db\ActiveRecord|ActiveRecord]] objects, you may chain the [[yii\db\ActiveQuery::asArray()|asArray()]] +method when building a query to return a large number of records. This will cause the query result to be returned +as arrays, which can significantly reduce the needed CPU time and memory if large number of records . For example: + +```php +$customers = Customer::find()->asArray()->all(); +``` + +Another change is that you can't define attribute default values through public properties anymore. +If you need those, you should set them in the init method of your record class. + +```php +public function init() +{ + parent::init(); + $this->status = self::STATUS_NEW; +} +``` + +There where some problems with overriding the constructor of an ActiveRecord class in 1.1. These are not present in +version 2.0 anymore. Note that when adding parameters to the constructor you might have to override [[yii\db\ActiveRecord::instantiate()]]. + +活动记录方面还有很多其他的变化与改进，请参考 [活动记录](db-active-record.md) 章节以了解更多细节。 + + +用户及身份验证接口（IdentityInterface） +------------------------------------- + +1.1 中的 `CWebUser` 类现在被 [[yii\web\User]] 所取代，随之 `CUserIdentity` 类也不在了。与之相对的，为达到相同目的，你可以实现 +[[yii\web\IdentityInterface]] 接口，它使用起来更直观。在高级应用模版里提供了一个这么样的一个例子。 + +要了解更多细节请参考 [认证（Authentication）](security-authentication.md)，[授权（Authorization）](security-authorization.md) 以及 +[高级应用模版](tutorial-advanced-app.md) 这三个章节。 + + +URL 管理 +-------- + +Yii 2.0 的 URL 管理跟 1.1 中很像。一个主要的改进是现在的 URL 管理支持 **可选参数** 了。比如，如果你在 2.0 中定义了一个下面这样的规则，那么它可以同时匹配 +`post/popular` 和 `post/1/popular` 两种 URL。而在 1.1 中为达成相同效果，必须要使用两条规则。 + +```php +[ + 'pattern' => 'post//', + 'route' => 'post/index', + 'defaults' => ['page' => 1], +] +``` + +请参考 [URL 解析和生成](runtime-url-handling.md) 章节，以了解更多细节。. + +同时使用 Yii 1.1 和 2.x +---------------------- + +如果你遗留有一些 Yii 1.1 的代码，需要跟 Yii 2.0 一起使用，你可以参考 [1.1 和 2.0 共用](extend-using-v1-v2.md) 章节。 From 93a9aa5f4c2262c984aa39b50bde3d3f06f5f5a3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=B8=9C=E6=96=B9=E5=AD=A4=E6=80=9D=E5=AD=90=EF=BC=88Pari?= =?UTF-8?q?s=C2=B7QianSen=EF=BC=89?= Date: Mon, 23 Jun 2014 16:56:51 +0800 Subject: [PATCH 4/5] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/guide-zh-CN/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guide-zh-CN/README.md b/docs/guide-zh-CN/README.md index bc0e4c6..23ed6ab 100644 --- a/docs/guide-zh-CN/README.md +++ b/docs/guide-zh-CN/README.md @@ -36,7 +36,7 @@ Yii 2.0 权威指南 * **已定稿** [视图（View）](structure-views.md) * **已定稿** [模型（Model）](structure-models.md) * **已定稿** [过滤器](structure-filters.md) -* **待定中** [小部件（Widget）](structure-widgets.md) +* **已定稿** [小部件（Widget）](structure-widgets.md) * **已定稿** [模块（Module）](structure-modules.md) * **编撰中** [前端资源（Asset）](structure-assets.md) * **待定中** [扩展（extensions）](structure-extensions.md) @@ -179,8 +179,8 @@ RESTful Web 服务 * 菜单（Menu）：链接到 demo 页 * LinkPager：链接到 demo 页 * LinkSorter：链接到 demo 页 -* **编撰中** [Bootstrap 小部件](bootstrap-widgets.md) -* **编撰中** [Jquery UI 小部件](jui-widgets.md) +* **已完成** [Bootstrap 小部件](widget-bootstrap.md) +* **已完成** [Jquery UI 小部件](widget-jui.md) 助手类 ------ From d80b592a5d74e99b9aa4c34bc63a5848290142c9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=B8=9C=E6=96=B9=E5=AD=A4=E6=80=9D=E5=AD=90=EF=BC=88Pari?= =?UTF-8?q?s=C2=B7QianSen=EF=BC=89?= Date: Tue, 24 Jun 2014 01:25:16 +0800 Subject: [PATCH 5/5] Translated intro-upgrade-from-v1 [skip ci] --- docs/guide-zh-CN/intro-upgrade-from-v1.md | 98 ++++++++++++++----------------- 1 file changed, 44 insertions(+), 54 deletions(-) diff --git a/docs/guide-zh-CN/intro-upgrade-from-v1.md b/docs/guide-zh-CN/intro-upgrade-from-v1.md index c62f5cc..2c1377a 100644 --- a/docs/guide-zh-CN/intro-upgrade-from-v1.md +++ b/docs/guide-zh-CN/intro-upgrade-from-v1.md @@ -20,9 +20,10 @@ Yii 2.0 完全拥抱 [Composer](https://getcomposer.org/) 的使用，它其实 PHP 需求 ---------------- -Yii 2.0 requires PHP 5.4 or above, which is a huge improvement over PHP version 5.2 that is required by Yii 1.1. -As a result, there are many differences on the language level that you should pay attention to. -Below is a summary of the major changes regarding PHP: +Yii 2.0 需求 PHP 5.4 或以上版本，该版本相对于 Yii 1.1 所需求的 PHP 5.2 +而言是一个巨大的改进。也因此，在语言层面上有很多的值得注意的不同之处。 + +下面是在 PHP 层级发生的主要变化的一个小汇总： - [命名空间](http://php.net/manual/zh/language.namespaces.php) - [匿名函数](http://php.net/manual/zh/functions.anonymous.php) @@ -236,14 +237,12 @@ ActiveForm::end(); 主题（Theme） ------ -Themes work completely differently in 2.0. They are now based on a path mapping mechanism that maps a source -view file path to a themed view file path. For example, if the path map for a theme is -`['/web/views' => '/web/themes/basic']`, then the themed version for the view file -`/web/views/site/index.php` will be `/web/themes/basic/site/index.php`. For this reason, themes can now -be applied to any view file, even a view rendered outside of the context of a controller or a widget. +2.0 主题的运作方式跟以往完全不同了。它们现在基于一个 +**路径映射机制**，该机制会把一个源视图文件的路径映射到一个主题视图文件路径。举例来说，如果路径映射为 +`['/web/views' => '/web/themes/basic']`，那么 `/web/views/site/index.php` 视图的主题修饰版就会是 +`/web/themes/basic/site/index.php`。也因此让主题现在可以应用在任何视图文件之上，甚至是渲染于控制器或小部件的上下文环境之外的视图文件。 -Also, there is no more `CThemeManager` component. Instead, `theme` is a configurable property of the `view` -application component. +同样，`CThemeManager` 组件已经被移除了。取而代之的是，`theme` 成为了 `view` 应用组件的一个可配置属性。 更多细节请参考[主题](output-theming.md)章节。 @@ -251,15 +250,13 @@ application component. 控制台应用（Console Application） -------------------- -Console applications are now organized as controllers, like Web applications. Console controllers -should extend from [[yii\console\Controller]], similar to `CConsoleCommand` in 1.1. +控制台应用现在如普通的 Web 应用程序一样，由控制器组成，控制台的控制器继承自 [[yii\console\Controller]] +，类似于1.1的 `CConsoleCommand` 。 -To run a console command, use `yii `, where `` stands for a controller route -(e.g. `sitemap/index`). Additional anonymous arguments are passed as the parameters to the -corresponding controller action method, while named arguments are parsed according to -the declarations in [[yii\console\Controller::options()]]. +运行控制台命令使用 `yii `，其中 `` 代表控制器的路由（如 `sitemap/index`）。额外的匿名参数传递到对应的控制器操作，而有名的参数根据 +[[yii\console\Controller::options()]] 的声明来解析。 -Yii 2.0 supports automatic generation of command help information from comment blocks. +Yii 2.0 支持基于代码注释自动生成相关命令的帮助（help）信息。 更多细节请参阅[控制台命令](tutorial-console.md)章节。 @@ -301,13 +298,11 @@ public function behaviors() 前端资源（Assets） ------ -Yii 2.0 introduces a new concept called *asset bundle* that replaces the script package concept found in Yii 1.1. +Yii 2.0 引入了一个新的概念，称为 *资源包*（Asset Bundle），以代替 1.1 的脚本包概念。 -An asset bundle is a collection of asset files (e.g. JavaScript files, CSS files, image files, etc.) -within a directory. Each asset bundle is represented as a class extending [[yii\web\AssetBundle]]. -By registering an asset bundle via [[yii\web\AssetBundle::register()]], you make -the assets in that bundle accessible via the Web. Unlike in Yii 1, the page registering the bundle will automatically -contain the references to the JavaScript and CSS files specified in that bundle. +一个资源包是一个目录下的资源文件集合（如 JavaScript 文件、CSS 文件、图片文件等）。每一个资源包被表示为一个类，该类继承自 +[[yii\web\AssetBundle]]。用 [[yii\web\AssetBundle::register()]] 方法注册一个资源包后，就使它的资源可被 Web +访问，注册了资源包的页面会自动包含和引用资源包内指定的 JS 和 CSS 文件。 更多细节请参阅 [前端资源管理（Asset）](structure-assets.md) 章节。 @@ -329,10 +324,10 @@ Yii 2.0 很多常用的静态助手类，包括： 表单 ----- -Yii 2.0 introduces the *field* concept for building a form using [[yii\widgets\ActiveForm]]. A field -is a container consisting of a label, an input, an error message, and/or a hint text. -A field is represented as an [[yii\widgets\ActiveField|ActiveField]] object. -Using fields, you can build a form more cleanly than before: +Yii 2.0 引进了 *表单栏（field）* 的概念，用来创建一个基于 [[yii\widgets\ActiveForm]] +的表单。一个表单栏是一个由标签、输入框、错误消息（可能还有提示文字）组成的容器，被表示为 [[yii\widgets\ActiveField|ActiveField]] 对象。 + +使用表单栏建立表单的过程比以前更整洁利落： ```php @@ -350,10 +345,11 @@ Using fields, you can build a form more cleanly than before: 查询生成器（Query Builder） ------------- -In 1.1, query building was scattered among several classes, including `CDbCommand`, -`CDbCriteria`, and `CDbCommandBuilder`. Yii 2.0 represents a DB query in terms of a [[yii\db\Query|Query]] object -that can be turned into a SQL statement with the help of [[yii\db\QueryBuilder|QueryBuilder]] behind the scene. -For example: +Yii 1.1中，查询语句的构建分散在多个类中，包括`CDbCommand`，`CDbCriteria` 以及 +`CDbCommandBuilder`。Yii 2.0 以 [[yii\db\Query|Query]] 对象的形式表示一个数据库查询，这个对象可以在 +[[yii\db\QueryBuilder|QueryBuilder]] 的帮助下于幕后生成 SQL 语句。 + +例如： ```php $query = new \yii\db\Query(); @@ -366,7 +362,7 @@ $sql = $command->sql; $rows = $command->queryAll(); ``` -Best of all, such query building methods can also be used when working with [Active Record](db-active-record.md). +最绝的是，这些查询生成方法还TM可以和[活动记录](db-active-record.md)配合使用 请参考[查询生成器（Query Builder）](db-query-builder.md) 章节了解更多内容。 @@ -374,25 +370,24 @@ Best of all, such query building methods can also be used when working with [Act 活动记录（Active Record） ------------- -Yii 2.0 的[活动记录](db-active-record.md)改动了很多。两个最显而易见的改动分别涉及构建查询（query +Yii 2.0 的[活动记录](db-active-record.md)改动了很多。两个最显而易见的改动分别涉及查询语句的构建（query building）和关联查询的处理（relational query handling）。 在 1.1 中的 `CDbCriteria` 类在 Yii 2 中被 [[yii\db\ActiveQuery]] （活动查询）所替代。这个类是继承自 -[[yii\db\Query]]，且继承了所有的 -The `CDbCriteria` class in 1.1 is replaced by [[yii\db\ActiveQuery]] in Yii 2. That class extends from [[yii\db\Query]], and thus -inherits all query building methods. You call [[yii\db\ActiveRecord::find()]] to start building a query: +[[yii\db\Query]]，因此也继承了所有查询生成方法。当需要开始拼装一个查询了，你可以调用 [[yii\db\ActiveRecord::find()]] +方法来开头： ```php -// To retrieve all *active* customers and order them by their ID: +// 检索所有 *活动的* 客户和订单，并以 ID 排序： $customers = Customer::find() ->where(['status' => $active]) ->orderBy('id') ->all(); ``` -To declare a relation, simply define a getter method that returns an [[yii\db\ActiveQuery|ActiveQuery]] object. -The property name defined by the getter represents the relation name. For example, the following code declares -an `orders` relation (in 1.1, you would have to declare relations in a central place `relations()`): +要声明一个关联关系，只需简单地定义一个 getter 方法来返回一个 [[yii\db\ActiveQuery|ActiveQuery]] +对象。getter 方法定义的属性名（译者注：即 getOrders() 中的 orders）表示关联关系名。如，以下代码声明了一个名为 `orders` +的关系（1.1 中必须在 `relations()` 方法内声明关系）： ```php class Customer extends \yii\db\ActiveRecord @@ -403,29 +398,24 @@ class Customer extends \yii\db\ActiveRecord } } ``` - -Now you can use `$customer->orders` to access a customer's orders from the related table. You can also use the following code -to perform an on-the-fly relational query with a customized query condition: +现在你就可以通过调用 `$customer->orders` +来从关联表中访问所有用户的订单了。你还可以用以下代码进行一场，使用定制的查询条件执行的“即时演算”关联查询： ```php $orders = $customer->getOrders()->andWhere('status=1')->all(); ``` -When eager loading a relation, Yii 2.0 does it differently from 1.1. In particular, in 1.1 a JOIN query -would be created to select both the primary and the relational records. In Yii 2.0, two SQL statements are executed -without using JOIN: the first statement brings back the primary records and the second brings back the relational -records by filtering with the primary keys of the primary records. +当贪婪加载一段关联关系时，Yii 2.0 和 1.1 的运作机理并不相同。具体来说，在 1.1 中，为同时选出主表和关联记录，会生成一个 JOIN +查询。在 Yii 2.0 中会使用两个没有 JOIN 的 SQL 语句：第一条语句取回主表记录，第二条取回用主表记录的主键信息筛选后的关联记录。 -Instead of returning [[yii\db\ActiveRecord|ActiveRecord]] objects, you may chain the [[yii\db\ActiveQuery::asArray()|asArray()]] -method when building a query to return a large number of records. This will cause the query result to be returned -as arrays, which can significantly reduce the needed CPU time and memory if large number of records . For example: +当构建会返回大量记录的查询时，可以添加 [[yii\db\ActiveQuery::asArray()|asArray()]] 方法链的方法，这样会以数组的形式返回查询结果，而不必返回 +[[yii\db\ActiveRecord|ActiveRecord]] 对象，这能明显降低因大量记录读取所消耗的 CPU 时间和内存。如： ```php $customers = Customer::find()->asArray()->all(); ``` -Another change is that you can't define attribute default values through public properties anymore. -If you need those, you should set them in the init method of your record class. +另一个改变是你不能再通过公共数据定义特性（Attribute）的默认值了。如果你需要这么做的话，你可以在你的记录类的 `init` 方法中设置它们。 ```php public function init() @@ -435,8 +425,8 @@ public function init() } ``` -There where some problems with overriding the constructor of an ActiveRecord class in 1.1. These are not present in -version 2.0 anymore. Note that when adding parameters to the constructor you might have to override [[yii\db\ActiveRecord::instantiate()]]. +曾几何时，在 1.1 中重写一个活动记录类的构造器（Constructor）会导致一些问题。它们在 2.0 +中不会再出现了。需要注意的是，如果你需要在构造器中添加一些参数，你恐怕必须重写 [[yii\db\ActiveRecord::instantiate()]] 方法。 活动记录方面还有很多其他的变化与改进，请参考 [活动记录](db-active-record.md) 章节以了解更多细节。