安装 Yii

你可以通过两种方式安装 Yii：使用 Composer 或下载一个归档文件。 推荐使用前者，这样只需执行一条简单的命令就可以安装新的扩展或更新 Yii 了。

标准安装完Yii之后，框架和一个项目模板两者都下载并安装好了。 一个项目模板是实现了一些基本特性的一个 可行的Yii项目，比如登录，联系表单，等等。 它的代码是以推荐的方式组织的。因此，它能够适合作为你项目的一个好的起点。

在本章节和以后的章节，我们将会介绍如何去安装Yii和所谓的基本的应用程序模板和如何去实现这个模板上的新特性。 Yii当然也提供了其它模板叫 高级的应用程序模板， 它是更好应用于在一个团队开发环境中去开发多层级的应用程序。

信息： 这个基本的应用程序模板是适合于开发90%的Web应用程序。 它不同于高级的应用程序模板主要地在如何使它们的代码是
有组织的。 如果你是刚接触Yii，我们强烈建议你坚持使用简单并有足够的功能的基础的应用程序模板。

通过 Composer 安装

安装 Composer

如果还没有安装 Composer，你可以按 getcomposer.org 中的方法安装。 在 Linux 和 Mac OS X 中可以运行如下命令：

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

在 Windows 中，你需要下载并运行 Composer-Setup.exe。

如果遇到任何问题或者想更深入地学习 Composer， 请参考 Composer 文档。 如果你已经安装有 Composer 请确保使用的是最新版本， 你可以用 composer self-update 命令更新 Composer 为最新版本。

在本指南中，所有 composer 命令都假定您已经安装了全局 的 composer， 这样它可以作为 composer 命令。如果您在本地目录中使用 composer.phar， 则必须相应地调整示例命令。

如果您之前已安装 Composer，请确保使用最新版本。 您可以通过运行 composer self-update 来更新Composer。

注意： 在安装 Yii 期间，Composer 需要从 Github API 请求很多信息。 请求的数量取决于您的应用程序所依赖的数量， 并
可能大于 Github API 速率限制。如果达到此限制，Composer 可能会要求您提供 Github 登录凭据以获取 Github API 访问令牌。
在快速连接上，您可能比 Composer 能够处理的时间早， 因此我们建议您在安装 Yii 之前配置访问令牌。 有关如何执行此操作
的说明，请参阅 Composer documentation about Github API tokens。

安装 Yii

安装 Composer 后，您可以通过在 Web 可访问的文件夹下运行以下命令来 安装Yii应用程序模板：

composer create-project --prefer-dist yiisoft/yii2-app-basic basic

这将在一个名为 basic 的目录中安装Yii应用程序模板的最新稳定版本。 如果需要，您可以选择不同的目录名称。

信息： 如果 composer create-project 命令失败，您也可以参考 Composer 文档的疑难解答 部分中的常见错误。修复错误后，
您可以通过在 basic 目录内运行 composer update 来恢复中止安装。

提示： 如果你想安装 Yii 的最新开发版本，可以使用以下命令代替， 它添加了一个 stability 选项：

composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic

请注意，Yii的开发版本不应该用于生产，因为它可能会破坏您的运行代码。

通过归档文件安装

通过归档文件安装 Yii 包括三个步骤：

1. 从 yiiframework.com 下载归档文件。

2. 将下载的文件解压缩到 Web 访问的文件夹中。

3. 修改 config/web.php 文件，给 cookieValidationKey 配置项 添加一个密钥（若你通过 Composer 安装，则此步骤会自动完成）：

// !!! 在下面插入一段密钥（若为空） - 以供 cookie validation 的需要
'cookieValidationKey' => '在此处输入你的密钥',