如果碰着任何问题或者想更深入地学习 Composer, 请参考 Composer 文档(英文),Composer 中文。
如果你已经安装有 Composer 请确保利用的是最新版本, 你可以用命令更新 Composer 为最新版 本。
composer self-update
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/