Yii 的安装由如下两步组成:
- 从 yiiframework.com 下载 Yii 框架。
- 将 Yii 压缩包解压至一个 Web 可访问的目录。
提示: 安装在 Web 目录不是必须的,每个 Yii 应用都有一个入口脚本,只有它才必须暴露给 Web 用户。其它 PHP 脚本(包括 Yii)应该保护起来不被 Web 访问,因为它们可能会被黑客利用。
安装完 Yii 以后你也许想验证一下你的服务器是否满足使用 Yii 的要求,只需浏览器中输入如下网址来访问需求检测脚本:
http://localhost/php/yii/requirements/index.php
Yii 的最低需求是你的 Web 服务器支持 PHP 5.1.0 或更高版本。Yii 在 Windows 和 Linux 系统上的 Apache HTTP 服务器 中测试通过,应该在其它支持 PHP 5 的 Web 服务器和平台上也工作正常。
建立第一个 Yii 应用
为了对 Yii 有个初步认识,我们在本节讲述如何建立第一个 Yii
应用。我们将使用 yiic
(命令行工具)创建一个新的 Yii
应用。Gii
(强大的基于web的代码生成器)为特定的任务完成自动代码生成。假定 YiiRoot
为
Yii 的安装目录,WebRoot
是服务器的文档根目录。
在命令行运行 yiic
,如下所示:
% YiiRoot/framework/yiic webapp WebRoot/testdrive (我个人的webRoot是:F:\xampp\htdocs\php)
注意: 在 MacOS、Linux 或 Unix 系统中运行
yiic
时,你可能需要修改yiic
文件的权限使它能够运行。此外,也可以这样运行此工具:
% cd WebRoot % php YiiRoot/framework/yiic.php webapp testdrive
这将在 WebRoot/testdrive
目录下建立一个最基本的
Yii 应用。这个应用拥有了大多数 Yii 应用所需要的目录结构。
不用写一行代码,我们可以在浏览器中访问如下 URL 来看看我们第一个 Yii 应用:
http://hostname/testdrive/index.php
正如我们看到的,这个应用包含三个页面:首页、联系页、登录页。首页展示一些关于应用和用户登录状态的信息,联系页显示一个联系表单以便用户填写并提交他们的咨询,登录页允许用户先通过认证然后访问已授权的内容。 查看下列截图了解更多:
下面的树图描述了我们这个应用的目录结构。请查看约定以获取该结构的详细解释。
testdrive/ index.php Web 应用入口脚本文件 index-test.php 功能测试使用的入口脚本文件 assets/ 包含公开的资源文件 css/ 包含 CSS 文件 images/ 包含图片文件 themes/ 包含应用主题 protected/ 包含受保护的应用文件 yiic yiic 命令行脚本 yiic.bat Windows 下的 yiic 命令行脚本 yiic.php yiic 命令行 PHP 脚本 commands/ 包含自定义的 ‘yiic‘ 命令 shell/ 包含自定义的 ‘yiic shell‘ 命令 components/ 包含可重用的用户组件 Controller.php 所有控制器类的基础类 Identity.php 用来认证的 ‘Identity‘ 类 config/ 包含配置文件 console.php 控制台应用配置 main.php Web 应用配置 test.php 功能测试使用的配置 controllers/ 包含控制器的类文件 SiteController.php 默认控制器的类文件 data/ 包含示例数据库 schema.mysql.sql 示例 MySQL 数据库 schema.sqlite.sql 示例 SQLite 数据库 testdrive.db 示例 SQLite 数据库文件 extensions/ 包含第三方扩展 messages/ 包含翻译过的消息 models/ 包含模型的类文件 LoginForm.php ‘login‘ 动作的表单模型 ContactForm.php ‘contact‘ 动作的表单模型 runtime/ 包含临时生成的文件 tests/ 包含测试脚本 views/ 包含控制器的视图和布局文件 layouts/ 包含布局视图文件 main.php 所有视图的默认布局 column1.php 使用单列页面使用的布局 column2.php 使用双列的页面使用的布局 site/ 包含 ‘site‘ 控制器的视图文件 pages/ 包含 "静态" 页面 about.php "about" 页面的视图 contact.php ‘contact‘ 动作的视图 error.php ‘error‘ 动作的视图(显示外部错误) index.php ‘index‘ 动作的视图 login.php ‘login‘ 动作的视图 system/ 包含系统视图文件
连接到数据库
大多数 Web
应用由数据库驱动,我们的测试应用也不例外。要使用数据库,我们首先需要告诉应用如何连接它。修改应用的配置文件 WebRoot/testdrive/protected/config/main.php
即可,如下所示: