本文基于The Definitive Guide to Yii 2.0,根据自己的实际操作,尝试着半翻译半叙述的将YII框架的安装过程说清楚。
安装Yii框架的方式有两种:
- 通过Composer依赖管理工具安装
- 下载归档文件进行安装
其中官方比较推荐的是第一种安装方式,因为Composer确实是好用,通过几行简单的命令行,就可以给你的项目中安装新的扩展库。而本文从入门Yii框架的角度来考虑,所以选择了使用第二种安装方式,即下载归档文件进行安装。
在一个Yii框架的标准安装流程中,会下载安装整个框架以及一个项目模板。这个项目模板,可以满足一个项目的基本需求,具备如登录功能、网站的“联系我们”等功能。同时它的代码风格也是官方比较推崇的,作为一个入门上手的项目,还是非常OK的。而Yii框架的标准模板有两种:
安装的流程不会差很多,而考虑到某度上的很多后续教程,都是基于Advanced Project Template的,所以就以Advanced Project Template为例子,记录一下在windows上的安装过程。
以归档文件方式安装Yii框架,只需要三个步骤:
- 下载归档文件,点击上面的链接即可下载
- 将文件解压到网站目录下,具有访问权限的文件夹
- 进入文件夹,对项目进行初始化
针对3,详细步骤如下:
- 如果直接下载的归档压缩文件进行解压,那么解压出来的文件夹应该是
advanced
,进入文件夹,运行path\to\advanced\init.bat
,此时会出现提示:
Yii Application Initialization Tool v1.0
Which environment do you want the application to be initialized in?
[0] Development
[1] Production
Your choice [0-1, or "q" to quit]
输入0
选择开发模式,在此模式下,便于开发调试。继续下去:
Initialize the application under 'Development' environment? [yes|no]
输入yes
,框架会进行初始化,生成一些文件,清单如下:
Start initialization ...
generate backend/config/main-local.php
generate backend/config/params-local.php
generate backend/config/test-local.php
generate backend/web/index-test.php
generate backend/web/index.php
generate backend/web/robots.txt
generate common/config/main-local.php
generate common/config/params-local.php
generate common/config/test-local.php
generate console/config/main-local.php
generate console/config/params-local.php
generate frontend/config/main-local.php
generate frontend/config/params-local.php
generate frontend/config/test-local.php
generate frontend/web/index-test.php
generate frontend/web/index.php
generate frontend/web/robots.txt
generate yii
generate yii_test
generate yii_test.bat
generate cookie validation key in backend/config/main-local.php
generate cookie validation key in frontend/config/main-local.php
chmod 0777 backend/runtime
chmod 0777 backend/web/assets
chmod 0777 frontend/runtime
chmod 0777 frontend/web/assets
chmod 0755 yii
chmod 0755 yii_test
... initialization completed.
从上面的生成清单可以看到,init.bat
实际上对框架的一些必要文件进行自动生成。
到这一步,框架便已经安装完毕,打开浏览器输入对应的应用首页地址,就可以得到
而如果得到的是403,那大概是服务器没有配置好,可以重新检查一下此时的url是否是在应用对应的web文件夹下。例如,在Apache服务器的默认配置,localhost
指向的地址为server\path\htdocs\
的情况下,frontend应用对应的地址为server\path\htdocs\advanced\frontend\web
,此时的url应该是http://localhost/advanced/frontend/web
以此参考,对服务器进行相关设置即可。