Yii Framework 教程可以参见官方中文文档 ,那么为什么还要写这个开发教程呢? 本教程目的是通过不同的视角(主要是通过开发Windows应用C++,C#程序员的角度)帮助Windows 桌面应用或ASP.Net程序员较快的掌握PHP Yii Framework应用程序框架。 使用PHP开发Web应用的一个重要好处是可以应用于各种操作系统(Unix,Windows,Mac OS),而不像Asp.Net一般只能应用中Windows操作系统上。使用PHP+Apache+MySQL (XMAP/LAMP) 几乎可以打遍天下无敌手:-)。
本教程所使用的操作系统为Windows,开发IDE为 VS.PHP,之所以使用这个开发环境是因为VS.PHP采用Visual Studio 作为IDE ,对于Visual Studio开发人员比较熟悉。而且可以用来同时开发调试C#,PHP应用。 Yii Framework 本身和IDE无关,你可以使用你喜欢的PHP开发工具来开发Yii 应用(比如Eclipse)。关于VS.PHP的介绍可以参见 VS.PHP + YiiFramework 组合开发PHP应用。本教程关于Yii Framework知识也和开发IDE无关,可以应用到各种开发环境,你可以选择你自己喜欢的开发环境。
在创建第一个应用之间,需要下载Yii 开发包,下载可以到Yii网站http://www.yiiframework.com/download/ 下载,目前版本为1.1.12, 下载后直接解压,为方便起见将其解压到C:根目录下:
使用VS.PHP的还有一个好处是其自带了Apache Web 服务器,因此无需另外安装,你也可以安装XAMP (Apache+MySQL+PHP) ,但如需要使用MySQL,则另外需安装MySQL.
安装好Yii Framework之后,我们就使用VS.PHP来创建第一个PHP应用,Hello World。
VS.PHP 创建HelloWorld项目,并添加一个index.php 文件。
此时修改index.php 为
<?php print "Hello, World!"; ?>
按F5运行程序,VS.PHP打开确省浏览器,显示“Hello,World!?. 但这不是一个Yii应用!!!,我们还没有使用Yii Web应用程序框架,Yii Framework是一个纯面向对象的应用程序框架。其Web程序的Application类为CWebApplication类。并采用了MVC模型。
下面的示意图展示了 Yii 应用的静态结构
下图展示了一个 Yii 应用在处理用户请求时典型的工作流
Yii应用本身有很多配置,比如确省的Controller ,action是否使用Log文件等。对于Hello,World这个简单的应用,就全部使用缺省值。缺省的Controller为SiteController, Action为indexAction. 也就是说,比如你的网站为www.guidebee.com ,如果你采用Yii Framework, 用户请求www.guidebee.com时,Yii 应用的CWebApplication 将创建类SiteController的实例并调用SiteController的indexAction方法,(相当于C# Console应用的Program 的main方法)。
Yii 项目使用不同的目录来存放Controller,Action,View,Layout等,其缺省目录结构如下
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/ 包含系统视图文件
这个目录结构可以通过Yii自带的工具来创建缺省的文件建立第一个 Yii 应用。
对于Hello World项目来说,没有必要这么复杂,我们只需创建 protected \controllers 目录以存放SiteController.php。
每个Yii应用都有的入口脚本,可以理解为C#的Program类。这个 入口脚本大同小异
<?php // 包含Yii引导文件 //require_once(dirname(__FILE__).'/../../framework/yii.php'); $yii='C:/yiiframework/yii.php'; // 发布应用时,去掉下面代码避免产生调试信息 defined('YII_DEBUG') or define('YII_DEBUG',true); require_once($yii); // 创建一个应用实例并执行 Yii::createWebApplication()->run();
前面说过Yii的缺省Controller为SiteController,缺省Action为actionIndex, 因此HelloWorld的SiteController代码如下:
/** * SiteController is the default controller to handle user requests. */ class SiteController extends CController { /** * Index action is the default action in a controller. */ public function actionIndex() { echo 'Hello World'; } }
此时再运行应用,可以在浏览器中显示“Hello,World”。 目前没有使用MVC模型直接在Controller 使用echo 打印出“Hello,World”, 下面稍微修改一下代码,创建一个简单的View。
View缺省目录为protected 目录下的views 子目录,和Controller类对于,比如SiteController对应到Views目录下的site子目录,和Asp.Net一样,Yii的View(对应到Asp.Net的Page类)也可以使用MasterPage,Yii应用成为Layout,缺省Layout存放在views的layouts 子目录。
修改SiteController的actionIndex 方法,改为:
public function actionIndex() { $this->render("index"); }
View 视图是一个包含了主要的用户交互元素的PHP脚本.他可以包含PHP语句,但是我们建议这些语句不要去改变数据模型,且最好能够保持其单纯性(单纯作为视图)。为了实现逻辑和界面分离,大段的逻辑应该被放置于控制器或模型中,而不是视图中,视图有一个名字,当渲染(render)时,名字会被用于识别视图脚本文件。
actionIndex 通过render 方法来显示一个View,对应到views->site 目录下的 index.php 。render 缺省使用views ->layouts 下的 main.php 作为 Layout (布局,MasterPage)
布局是一种用来修饰视图的特殊的视图文件.它通常包含了用户界面中通用的一部分视图.例如:布局可以包含header和footer的部分,然后把内容嵌入其间.
......header here...... <?php echo $content; ?> ......footer here......
其中的 $content
则储存了内容视图的渲染结果.
来看一下View是目录下的index.php (View) 代码:
<?php echo "Hello,World!"; ?>
这样就完成了Hello,World的MVC模型,运行显示“Hello,World”。