你可以通过两种方式安装 Yii:使用 Composer 或下载一个归档文件。推荐使用前者,这样只需执行一条简单的命令就可以安装新的扩展或更新 Yii 了。
标准安装完Yii之后,框架和一个项目模板两者都下载并安装好了。一个项目模板是实现了一些基本特性的一个 可行的Yii项目,比如登录,联系表单,等等。它的代码是以推荐的方式组织的。因此,它能够适合作为你项目的一个好的起点。
在本章节和以后的章节,我们将会介绍如何去安装Yii和所谓的基本的应用程序模板和如何去实现这个模板上的新特性。Yii当然也提供了其它模板叫高级的应用程序模板,它是更好应用于在一个团队开发环境中去开发多层级的应用程序。
信息: 这个基本的应用程序模板是适合于开发90%的Web应用程序。 它不同于高级的应用程序模板主要地在如何使它们的代码是有组织的。 如果你是刚接触Yii,我们强烈建议你坚持使用简单并有足够的功能的基础的应用程序模板。
通过 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 请确保使用的是最新版本,你可以用 composer self-update
命令更新 Composer 为最新版本。
Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下命令即可安装 Yii :
composer global require "fxp/composer-asset-plugin:^1.2.0"
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 包括三个步骤:
- 从 yiiframework.com 下载归档文件。
- 将下载的文件解压缩到 Web 访问的文件夹中。
-
修改
config/web.php
文件,给cookieValidationKey
配置项添加一个密钥(若你通过 Composer 安装,则此步骤会自动完成):// !!! 在下面插入一段密钥(若为空) - 以供 cookie validation 的需要 'cookieValidationKey' => '在此处输入你的密钥',
其他安装方式
上文介绍了两种安装 Yii 的方法,安装的同时也会创建一个立即可用的 Web 应用程序。这个方法对大多数的大或者小的项目是一个不错的起点。如果你正好开始学习Yii,这是特别适合的。
但是其他的安装方式也存在:
验证安装的结果
当安装完成之后,或配置你的Web服务器(看下面的文章)或使用内置Web Server,当在项目 web
目录下可以通过下面的命令:
php yii serve
注意: 默认情况下Https-server将监听8080。可是如果这个端口已经使用或者你想通过这个方式运行多个应用程序,你可以指定使用哪些端口。只加上 --port 参数:
php yii serve --port=8888
安装完成后,就可以使用浏览器通过如下 URL 访问刚安装完的 Yii 应用了:
http://localhost:8080/