yii2中文手册(完整版).pdf

摘取天上星，一个热爱互联网艺术的人！ 安装 Yii 你可以通过两种方式安装 Yii ：使用 Composer 或下载一个归档文件。推荐使用前者，这样只需执行一条 简单的命令就可以安装新的扩展或更新 Yii 了。 注意：和 Yii 1 不同，以标准方式安装 Yii 2 时会同时下载并安装框架本身 和一个应用程序的基本骨架。 通过 Composer 安装 如果还没有安装 Composer ，你可以按 中的方法安装。在 Linux 和 Mac OS X 中可 以运行如下命令： curl -s /installer | php mv composer.phar /usr/local/bin/composer 在 Windows 中，你需要下载并运行 Composer-Setup.exe 。 如果遇到任何问题或者想更深入地学习 Composer ，请参考 Composer 文档（英文） ，Composer 中文 。 如果你已经安装有 Composer 请确保使用的是最新版本，你可以用 composer self-update 命令更新 Composer 为最新版本。 Composer 安装后，切换到一个可通过 Web 访问的目录，执行如下命令即可安装 Yii ： composer global require fxp/composer-asset-plugin:1.0.0-beta4 composer create-project --prefer-dist yiisoft/yii2-app-basic basic 第一条命令安装 Composer asset plugin ，它是通过 Composer 管理 bower 和 npm 包所必须的，此 命令全局生效，一劳永逸。 第二条命令会将 Yii 安装在名为 basic 的目录中，你也可以随便选择其他名 称。 注意：在安装过程中 Composer 可能会询问你 GitHub 账户的登录信息， 因为可能在使用中超过了 GitHub API （对匿名用户的）使用限制。因为 Composer 需要为所有扩展包从 GitHub 中获取大量信息，所以超限非常 正常。（译注：也意味着作为程序猿没有 GitHub 账号，就真不能愉快地玩 耍了）登陆 GitHub 之后可以得到更高的 API 限额，这样 Composer 才 能正常运行。更多细节请参考 Composer 文档 （该段 Composer 中文文档 期待您的参与）。 技巧：如果你想安装 Yii 的最新开发版本，可以使用以下命令代替，它添加 了一个 stability 选项 （中文版）: composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic 注意，Yii 的开发版(dev 版)不应该用于生产环境中，它可能会破坏运行中 的代码。 通过归档文件安装 通过归档文件安装 Yii 包括三个步骤： 1.从 下载归档文件。 2.将下载的文件解压缩到 Web 目录中。 3.修改 config/web.php 文件，给 cookieValidationKey 配置项添加一个密钥（若你通过 Composer 安装，则此步骤会自动完成）： // !!! 在下面插入一段密钥（若为空） - 以供 cookie validation 的需要 cookieValidationKey = 在此处输入你的密钥, 其他安装方式 上文介绍了两种安装 Yii 的方法，安装的同时也会创建一个立即可用的 Web 应用程序。对于小的项目 或用于学习上手，这都是一个不错的起点。 但是其他的安装方式也存在： •如果你只想安装核心框架，然后从零开始构建整个属于你自己的应用程序模版，可以参考从头构 建自定义模版一节的介绍。 •如果你要开发一个更复杂的应用，可以更好地适用于团队开发环境的，可以考虑安装高级应用模 版 。 验证安装的结果 安装完成后，就可以使用浏览器通过如下 URL 访问刚安装完的 Yii 应用了： http://localhost/basic/web/index.php 这个 URL 假设你将 Yii 安装到了一个位于 Web 文档根目