Yii快速入门经典教程

本文讲述了Yii快速入门教程。分享给大家供大家参考，具体如下：

Ⅰ、基本概念

文件

入口文件内容：一般格式如下：

PHP;"> run();//根据主配置文件建立应用实例，并运行。你可以在当前应用的任何位置通过Yii::app()来访问这个实例。

配置文件

保存位置：你的应用/protected/config/main.PHP

文件内容：一般格式如下：

PHP;"> dirname(__FILE__).DIRECTORY_SEPARATOR.'..',//当前应用根目录的绝对物理路径 'name'=>'Yii Blog Demo',//当前应用的名称 // 预载入log（记录）应用组件，这表示该应用组件无论它们是否被访问都要被创建。该应用的参数配置在下面以“components”为关键字的数组中设置。 'preload'=>array('log'),//log为组件ID // 自动载入的模型和组件类 'import'=>array( 'application.models.*',//载入“application/models/”文件夹下的所有模型类 'application.components.*',//载入“application/components/”文件夹下的所有应用组件类 ),'defaultController'=>'post',//设置默认控制器类 // 当前应用的组件配置。更多可供配置的组件详见下面的“核心应用组件” 'components'=>array( 'user'=>array( //user（用户）组件配置，“user”为组件ID // 可以使用基于cookie的认证 'allowAutoLogin'=>true,//允许自动登录 ),'cache'=>array( //缓存组件 'class'=>'CMemCache',//缓存组件类 'servers'=>array( //MemCache缓存服务器配置 array('host'=>'server1','port'=>11211,'weight'=>60),//缓存服务器1 array('host'=>'server2','weight'=>40),//缓存服务器2 ),),'db'=>array( //db（数据库）组件配置，“db”为组件ID 'connectionString' => 'sqlite:protected/data/blog.db',//连接数据库的DSN字符串 'tablePrefix' => 'tbl_',//数据表前缀 ),// 如果要使用一个MysqL 数据库，请取消下面的注释 'errorHandler'=>array( // 使用SiteController控制器类中的actionError方法显示错误 'errorAction'=>'site/error',//遇到错误时，运行的操作。控制器名和方法名均小写，并用斜线“/”隔开 ),//URL路由管理器 'urlManager'=>array( 'urlFormat'=>'path',//URL格式。共支持两种格式：'path'格式（如：/path/to/EntryScript.PHP/name1/value1/name2 /value2...）和'get'格式（如: /path/to/EntryScript.PHP?name1=value1&name2=value2...）。当使用'path'格式时，需要设置如下的规则： 'rules'=>array( //URL规则。语法：<参数名:正则表达式> 'post//'=>'post/view',//将post/12/helloword指向post/view?id=12&title=helloword 'posts/'=>'post/index',//将posts/hahahaha指向post/index?tag=hahahaha '/@L_404_0@ 代码如下:

onClicked=$callback;

这里的 $callback 指向了一个有效的 PHP 回调。它可以是一个全局函数也可以是类中的一个方法。如果是后者，它必须以一个数组的方式提供: array($object,'methodName')。

事件句柄的结构如下：

PHP;"> function 方法名($event) { ...... }

这里的 $event 即描述事件的参数（它来源于 raiseEvent() 调用）。$event 参数是 CEvent 或其子类的实例。至少，它包含了关于谁触发了此事件的信息。

事件句柄也可以是一个PHP 5.3以后支持的匿名函数。例如：

onClicked=function($event) { ...... }

如果我们现在调用 onClicked()，onClicked 事件将被触发（在 onClicked() 中），附属的事件句柄将被自动调用。

一个事件可以绑定多个句柄。当事件触发时，这些句柄将被按照它们绑定到事件时的顺序依次执行。如果句柄决定组织后续句柄被执行，它会设置 $event->handled 为 true。

3、组件行为

组件已添加了对 mixin 的支持，并可以绑定一个或多个行为。行为是一个对象，其方法可以被它绑定的部件通过收集功能的方式来实现继承（inherited），而不是专有化继承(即普通的类继承)。一个部件可以以'多重继承'的方式实现多个行为的绑定。

行为类必须实现 IBehavior 接口。大多数行为可以继承自 CBehavior 。如果一个行为需要绑定到一个模型,它也可以从专为模型实现绑定特性的 CModelBehavior 或 CActiveRecordBehavior 继承。

要使用一个行为，它必须首先通过调用此行为的 attach() 方法绑定到一个组件。然后我们就可以通过组件调用此行为方法：

attachBehavior($name,$behavior); // test() 是行为中的方法。 $component->test();

已绑定的行为可以像一个组件中的普通属性一样访问。例如，如果一个名为 tree 的行为绑定到了一个组件，我们就可以通过如下代码获得指向此行为的引用。

tree; // 等于下行代码： // $behavior=$component->asa('tree');

行为是可以被临时禁止的,此时它的方法就会在组件中失效。例如:

disableBehavior($name); // 下面的代码将抛出一个异常 $component->test(); $component->enableBehavior($name); // 现在就可以使用了 $component->test();

两个同名行为绑定到同一个组件下是有可能的。在这种情况下,先绑定的行为则拥有优先权。

当和 events,一起使用时,行为会更加强大。当行为被绑定到组件时,行为里的一些方法就可以绑定到组件的一些事件上了。这样一来,行为就有机观察或者改变组件的常规执行流程。

一个行为的属性也可以通过绑定到的组件来访问。这些属性包含公共成员变量以及通过 getters 和/或 setters 方式设置的属性。例如，若一个行为有一个 xyz 的属性，此行为被绑定到组件 $a，然后我们可以使用表达式 $a->xyz 访问此行为的属性。

模块是一个独立的软件单元，它包含模型,视图,控制器和其他支持的组件。在许多方面上，模块看起来像一个应用。主要的区别就是模块不能单独部署，它必须存在于一个应用里。用户可以像他们访问普通应用的控制器那样访问模块中的控制器。

模块在一些场景里很有用。对大型应用来说，我们可能需要把它划分为几个模块，每个模块可以单独维护和部署。一些通用的功能，例如用户管理，评论管理，可以以模块的形式开发，这样他们就可以容易地在以后的项目中被复用。

1、创建模块

模块组织在一个目录中，目录名即为模块的唯一ID。模块目录的结构跟应用基础目录很相似。下面列出了一个 fourm 的模块的典型的目录结构：

forum/ 模块文件夹 ForumModule.PHP 模块类文件 components/ 包含可复用的用户组件 views/ 包含小物件的视图文件 controllers/ 包含控制器类文件 DefaultController.PHP 默认的控制器类文件 extensions/ 包含第三方扩展 models/ 包含模型类文件 views/ 包含控制器视图和布局文件 layouts/ 包含布局文件 default/ 包含 DefaultController 的视图文件 index.PHP 首页视图文件

模块必须有一个继承自 CWebModule 的模块类。类的名字通过表达式 ucfirst($id).'Module' 确定,其中的 $id 代表模块的 ID (或者说模块的目录名字)。模块类是存储模块代码间可共享信息的中心位置。例如，我们可以使用 CWebModule::params 存储模块参数，使用 CWebModule::components 分享模块级的应用组件。

2、使用模块

要使用模块，首先将模块目录放在应用基础目录的modules文件夹中。然后在应用的modules属性中声明模块ID。例如，为了使用上面的forum模块，我们可以使用如下应用配置:

array('forum',...),...... );

模块也可以在配置时带有初始属性值。做法和配置应用组件很类似。例如， forum 模块可以在其模块类中有一个名为 postPerPage 的属性，它可以在应用配置中配置如下:

array( 'forum'=>array( 'postPerPage'=>20,...... );

模块的实例可通过当前活动控制器的 module 属性访问。在模块实例中，我们可以访问在模块级中共享的信息。例如，为访问上面的 postPerPage 信息，我们可使用如下表达式：

controller->module->postPerPage; // 如如$this引用的是控制器实例，则可以使用下行语句 // $postPerPage=$this->module->postPerPage;

模块中的控制器动作可以通过路由“模块ID/控制器ID/动作ID”或“模块ID/存放控制器类文件的子目录名/控制器ID/动作ID”访问。例如，假设上面的 forum 模块有一个名为 PostController 的控制器，我们就可以通过路由 forum/post/create 访问此控制器中的 create 动作。此路由对应的 URL 即 http://www.example.com/index.PHP?r=forum/post/create。

3、嵌套的模块

模块可以无限级嵌套。这就是说，一个模块可以包含另一个模块，而这另一个模块又可以包含其他模块。我们称前者为父模块，后者为子模块。子模块必须定义在其父模块的 modules 属性中，就像我们前面在应用配置中定义模块一样。

要访问子模块中的控制器动作，我们应使用路由父模块ID/子模块ID/控制器ID/动作ID。

Yii 中广泛的使用了路径别名。路径别名关联于一个目录或文件的路径。它以点号语法指定，类似于广泛使用的名字空间（namespace）格式：

RootAlias.path.to.target

其中的 RootAlias 是某个现存目录的别名，通过调用 YiiBase::setPathOfAlias(),我们可以定义新的路径别名。为方便起见，Yii 预定义了以下几个根别名：

system: 表示 Yii 框架目录； zii: 表示 Zii 库目录； application: 表示应用的基础目录； webroot: 表示入口脚本文件所在的目录。 ext: 表示包含了所有第三方扩展的目录。

额外的，如果应用使用了模块,（Yii）也为每个模块ID定义了根别名，指向相应模块的跟目录。

通过使用 YiiBase::getPathOfAlias(),别名可以被翻译为其相应的路径。

使用别名可以很方便的导入类的定义。例如，如果我们想包含 CController 类的定义，我们可以调用如下代码

代码如下:

import方法跟 include 和 require 不同，它更加高效。导入（import）的类定义并不会真正被包含进来，直到它第一次被引用。多次导入同样的名字空间也会比 include_once 和 require_once 快得多。

我们还可以使用如下语法导入整个目录，这样此目录下的类文件就会在需要时被自动包含。

代码如下:

除 import 外，别名还在其他许多地方指向类。例如，路径别名可以传递给 Yii::createComponent() 以创建相应类的实例。即使类文件在之前从未被包含。

不要将路径别名和名字空间混淆了，名字空间是指对一些类名的一个逻辑组合，这样它们就可以相互区分开，即使有相同的名字。而路径别名是用于指向一个类文件或目录。路径别名与名字空间并不冲突。

下面我们讲解 Yii 编程中推荐的开发规范。为简单起见，我们假设 WebRoot 是 Yii 应用安装的目录。

1、URL

默认情况下，Yii 识别如下格式的 URL： http://hostname/index.PHP?r=ControllerID/ActionID

r 变量意为路由（route），它可以被Yii解析为控制器和动作。如果 ActionID 被省略，控制器将使用默认的动作（在CController::defaultAction中定义）；如果 ControllerID 也被省略（或者 r 变量不存在），应用将使用默认的控制器（在CWebApplication::defaultController中定义）。

通过 CUrlManager 的帮助，可以创建更加可识别，更加 SEO 友好的 URL，例如 http://hostname/ControllerID/ActionID.html。

2、代码

Yii 推荐命名变量、函数和类时使用驼峰风格，即每个单词的首字母大写并连在一起，中间无空格。变量名和函数名应该使它们的第一个单词全部小写，以使其区别于类名。对私有类成员变量来说，我们推荐以下划线作为其名字前缀（例如： $_actionList）。

一个针对控制器类名的特殊规则是它们必须以单词 Controller 结尾。那么控制器ID就是类名的首字母小写并去掉单词Controller。例如，PageController类的ID就是 page。这个规则使应用更加安全。它还使控制器相关的URL更加简单(例如 /index.PHP?r=page/index 而不是 /index.PHP?r=PageController/index)。

3、配置

配置是一个键值对数组。每个键代表了所配置的对象中的属性名，每个值则为相应属性的初始值。

类中任何可写的属性都可以被配置。如果没有配置，属性将使用它们的默认值。当配置一个属性时，最好阅读相应文档以保证初始值正确。

4、文件

命名和使用文件的规范取决于它们的类型。

类文件应以它们包含的公有类命名。例如，CController 类位于 CController.PHP 文件中。公有类是可以被任何其他类使用的类。每个类文件应包含最多一个公有类。私有类（只能被一个公有类使用的类）可以放在使用此类的公有类所在的文件中。

视图文件应以视图的名字命名。例如， index 视图位于 index.PHP 文件中。视图文件是一个PHP脚本文件，它包含了用于呈现内容的HTML和PHP 代码。

配置文件可以任意命名。配置文件是一个PHP脚本，它的主要目的是返回一个体现配置的关联数组。

5、目录

Yii 假定了一系列默认的目录用于不同的场合。如果需要，每个目录都可以自定义。

WebRoot/protected: 这是应用基础目录，是放置所有安全敏感的PHP脚本和数据文件的地方。Yii 有一个默认的 application 别名指向此目录。此目录及目录中的文件应该保护起来防止Web用户访问。它可以通过 CWebApplication::basePath 自定义。 WebRoot/protected/runtime: 此目录放置应用在运行时产生的私有临时文件。此目录必须对 Web 服务器进程可写。它可以通过 CApplication::runtimePath自定义。 WebRoot/protected/extensions: 此目录放置所有第三方扩展。它可以通过 CApplication::extensionPath 自定义。 WebRoot/protected/modules: 此目录放置所有的应用模块，每个模块使用一个子目录。 WebRoot/protected/controllers: 此目录放置所有控制器类文件。它可以通过 CWebApplication::controllerPath 自定义。 WebRoot/protected/views: 此目录放置所有试图文件，包含控制器视图，布局视图和系统视图。它可以通过 CWebApplication::viewPath 自定义。 WebRoot/protected/views/ControllerID: 此目录放置单个控制器类中使用的视图文件。此处的 ControllerID 是指控制器的ID 。它可以通过 CController::viewPath 自定义。 WebRoot/protected/views/layouts: 此目录放置所有布局视图文件。它可以通过 CWebApplication::layoutPath 自定义。 WebRoot/protected/views/system: 此目录放置所有系统视图文件。系统视图文件是用于显示异常和错误的模板。它可以通过CWebApplication::systemViewPath自定义。 WebRoot/assets: 此目录放置公共资源文件。资源文件是可以被发布的，可由Web用户访问的私有文件。此目录必须对 Web 服务器进程可写。它可以通过 CAssetManager::basePath 自定义 WebRoot/themes: 此目录放置应用使用的不同的主题。每个子目录即一个主题，主题的名字即目录的名字。它可以通过 CThemeManager::basePath 自定义。

6、数据库

多数Web 应用是由数据库驱动的。我们推荐在对表和列命名时使用如下命名规范。注意，这些规范并不是 Yii 所必须的。

㈠数据库表名和列名都使用小写命名。㈡名字中的单词应使用下划线分割 (例如 product_order)。㈢对于表名，你既可以使用单数也可以使用复数。但不要同时使用两者。为简单起见，我们推荐使用单数名字。㈣表名可以使用一个通用前缀，例如 tbl_ 。这样当应用所使用的表和另一个应用说使用的表共存于同一个数据库中时就特别有用。这两个应用的表可以通过使用不同的表前缀很容易地区别开。

Ⅱ、使用表单

在 Yii 中处理表单时，通常需要以下步骤：

1. 创建用于表现所要收集数据字段的模型类。 2. 创建一个控制器动作，响应表单提交。 3. 在视图脚本中创建与控制器动作相关的表单。

在编写表单所需的 HTML 代码之前，我们应该先确定来自最终用户输入的数据的类型，以及这些数据应符合什么样的规则。模型类可用于记录这些信息。正如模型章节所定义的，模型是保存用户输入和验证这些输入的中心位置。

取决于使用用户所输入数据的方式，我们可以创建两种类型的模型。如果用户输入被收集、使用然后丢弃，我们应该创建一个表单模型; 如果用户的输入被收集后要保存到数据库，我们应使用一个Active Record。两种类型的模型共享同样的基类 CModel ，它定义了表单所需的通用接口。

1、定义模型类

例如创建为一个表单模型：

PHP;"> class LoginForm extends CFormModel { public $username; public $password; public $rememberMe=false; }

LoginForm 中定义了三个属性: $username,$password 和 $rememberMe。他们用于保存用户输入的用户名和密码，还有用户是否想记住他的登录的选项。由于 $rememberMe 有一个默认的值 false，相应的选项在初始化显示在登录表单中时将是未勾选状态。

我们将这些成员变量称为特性（attributes）而不是属性（properties），以区别于普通的属性（properties）。特性（attribute）是一个主要用于存储来自用户输入或数据库数据的属性（propertiy）。

2、声明验证规则

一旦用户提交了他的输入，模型被填充，我们就需要在使用前确保用户的输入是有效的。这是通过将用户的输入和一系列规则执行验证实现的。我们在 rules() 方法中指定这些验证规则，此方法应返回一个规则配置数组。

_identity=new UserIdentity($this->username,$this->password); if(!$this->_identity->authenticate()) $this->addError('password','错误的用户名或密码。'); } }

rules() 返回的每个规则必须是以下格式：

代码如下:

'ScenarioList',...附加选项)

其中：

AttributeList（特性列表）是需要通过此规则验证的特性列表字符串，每个特性名字由逗号分隔; Validator（验证器）指定要执行验证的种类； on 参数是可选的，它指定此规则应被应用到的场景列表；附加选项是一个名值对数组，用于初始化相应验证器的属性值。

希望本文所述对大家基于Yii框架的PHP程序设计有所帮助。

Yii入门入门入门入门

上一篇：WordPress主题制作之模板文件的引入下一篇：从性能方面考虑PHP下载远程文件的3

Yii快速入门经典教程

Ⅰ、基本概念

Ⅱ、使用表单

猜你在找的PHP相关文章