安装Yii2
你可以通过两种方式来安装Yii框架:
- 通过Composer安装
- 通过下载一个所需文件以及Yii框架文件的应用模板
推荐前者方式,这样只需一条简单的命令就可以安装新的Yii框架了。
通过Composer安装
Composer是PHP中用来管理依赖(dependency)关系的工具。你可以在自己的项目中声明所依赖的外部工具库(libraries),Composer会帮你安装这些依赖的库文件。
了解了什么是Composer,那么推荐您使用Composer安装Yii框架。从这里下载Composer:下载,或直接运行下述命令:
curl -s http://getcomposer.org/installer | php
官方 Composer 指南如下:
在 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 create-project yiisoft/yii2-app-advanced advanced
第一条命令安装 Composer asset plugin, 它是通过 Composer 管理 bower 和 npm 包所必须的,此命令全局生效,一劳永逸。
第二条命令安装yii basic模版 并部署到 basic
的目录中。如果你想使用其它目录名称,你可以选择其他目录名称。
第三条命令安装yii advanced模版 并部署到advanced
目录中。
通过归档文件安装
通过归档文件安装 Yii 包括三个步骤:
- 从 yiiframework.com 下载归档文件。
- 将下载的文件解压缩到 Web 访问的文件夹中。
-
config/web.php
文件,给cookieValidationKey
配置项 添加一个密钥(若你通过 Composer 安装,则此步骤会自动完成):
// !!! 在下面插入一段密钥(若为空) - 以供 cookie validation 的需要
'cookieValidationKey' => '在此处输入你的密钥',
附加:如果要开发一个更复杂的应用,可以更好地适用于团队开发环境的,可以考虑安装高级模版
验证安装结果
可以通过两种方式验证安装结果:
1.通过内置Web服务器
- 通过Web服务器
第一种,内置服务器,切换到web目录,可以通过下面代码实现
php yii serve
注意: 默认情况下Https-server将监听8080。可是如果这个端口已经使用或者你想通过这个方式运行多个应用程序,你可以指定使用哪些端口。 只加上 --port 参数:
php yii serve --port=8080
使用浏览器通过如下 URL 访问刚安装完的 Yii 应用了:
http://localhost:8080/
你应该可以在浏览器中看到如上所示的 “Congratulations!” 页面。如果没有, 请通过以下任意一种方式,检查当前 PHP 环境是否满足 Yii 最基本需求:
- 复制
/requirements.php
到/web/requirements.php
,然后通过浏览器访问 URLhttp://localhost/requirements.php
- 执行如下命令:
cd basic
php requirements.php
可以访问Yii的web访问目录:
http://localhost/basic/web/index.php
http://localhost/advanced/frontend/web/index.php
http://localhost/advanced/backend/web/index.php
配置Web服务器
通过上述方法安装的应用程序在 Windows,Max OS X,Linux 中的 Apache HTTP 服务器或 Nginx HTTP 服务器 上都可以直接运行。
配置好 PHP 安装环境,使其符合 Yii 的最小需求。主要是需要 PHP 5.4 或 以上版本。 如果应用需要用到数据库,那还要安装 PDO PHP 扩展 和相应的数据库驱动(例如访问 MySQL 数据库所需的 pdo_mysql
)。
推荐使用的 Apache 配置
在 Apache 的 httpd.conf
文件或在一个虚拟主机配置文件中使用如下配置。注意,你应该将 path/to/basic/web
替换为实际的 basic/web
目录。
# 设置文档根目录为 “basic/web”
DocumentRoot "path/to/basic/web"
<Directory "path/to/basic/web">
RewriteEngine on
# 如果请求的是真实存在的文件或目录,直接访问
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 如果请求的不是真实文件或目录,分发请求至 index.php
RewriteRule . index.php
# ...其它设置...
</Directory>
推荐使用的 Nginx 配置
为了使用 Nginx,你应该已经将 PHP 安装为 FPM SAPI 了。使用如下 Nginx 配置,将 path/to/basic/web
替换为实际的 basic/web
目录,mysite.local
替换为实际的主机名以提供服务。
server {
charset utf-8;
client_max_body_size 128M;
listen 80;
## 监听 ipv4 上的 80 端口
# listen [::]:80 default_server ipv6only=on;
## 监听 ipv6 上的 80 端口
server_name mysite.local;
root /path/to/basic/web;
index index.php;
access_log /path/to/basic/log/access.log main;
error_log /path/to/basic/log/error.log;
location / {
# 如果找不到真实存在的文件,把请求重定向给 index.php
try_files $uri $uri/ /index.php?$args;
}
# 若取消下面这段的注释,可避免 Yii 接管不存在文件的处理过程(404)
#location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
# try_files $uri =404;
#}
#error_page 404 /404.html;
location ~ \.php$ {
include fastcgi.conf;
fastcgi_pass 127.0.0.1:9000;
#fastcgi_pass unix:/var/run/php5-fpm.sock;
}
location ~ /\.(ht|svn|git) {
deny all;
}
}
使用该配置时,你还应该在 php.ini
文件中设置 cgi.fix_pathinfo=0
, 能避免掉很多不必要的 stat()
系统调用。
还要注意当运行一个 HTTPS 服务器时,需要添加 fastcgi_param HTTPS on
; 一行, 这样 Yii 才能正确地判断连接是否安全。