Yii框架官方指南系列13——基础知识：开发规范

Yii 偏心规范胜于配置。遵循规范可以使你可以建立成熟的Yii应用而不须要编写、维护复杂的配置。 固然了，在必要时，Yii 仍然能够在几乎全部的方面经过配置实现自定义。

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

1. URL

默认状况下，Yii 识别以下格式的 URL：

http://hostname/index.php?r=ControllerID/ActionID

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

经过 CUrlManager 的帮助，能够建立更加可识别，更加 SEO 友好的 URL，例如http://hostname/ControllerID/ActionID.html。此功能在 URL Management 中有详细讲解。

2. 代码

Yii 推荐命名变量、函数和类时使用 驼峰风格，即每一个单词的首字母大写并连在一块儿，中间无空格。 变量名和函数名应该使它们的第一个单词所有小写，以使其区别于类名（例如：$basePath, runController(),LinkPager）。对私有类成员变量来讲，咱们推荐如下划线做为其名字前缀（例如： $_actionList）。

因为在 PHP 5.3.0 以前不支持名字空间，咱们推荐类要经过某种独立的方式命名，以免和第三方类发生冲突。鉴于此， 全部的 Yii 框架类名以 "C" 做前缀。

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

3. 配置

配置是一个键值对数组。每一个键表明了所配置的对象中的属性名，每一个值则为相应属性的初始值。 例如，array('name'=>'My application', 'basePath'=>'./protected') 初始化了 name 和 basePath 属性为它们相应的数组值。

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

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_ 。这样当应用所使用的表和另外一个应用说使用的表共存于同一个数据库中时就特别有用。 这两个应用的表能够经过使用不一样的表前缀很容易地区别开。