- 欢迎使用 CodeIgniter
- 安装说明
- 下载 CodeIgniter
- 从老版本升级
- 疑难解答
- CodeIgniter 概览
- CodeIgniter 将从这里开始
- CodeIgniter 概览
- CodeIgniter 特性
- 应用程序流程图
- 模型-视图-控制器
- 设计与架构目标
- 教程 - 内容提要
- 加载静态内容
- 读取新闻条目
- 创建新闻条目
- 结束语
- 向 CodeIgniter 贡献你的力量
- 编写 CodeIgniter 的文档
- Developer's Certificate of Origin 1.1
- CodeIgniter URL
- 控制器
- 保留名称
- 视图
- 模型
- 辅助函数
- 使用 CodeIgniter 类库
- 创建类库
- 使用 CodeIgniter 驱动器
- 创建驱动器
- 创建核心系统类
- 创建附属类
- 钩子 - 扩展框架核心
- 自动加载资源
- 公共函数
- 兼容性函数
- URI 路由
- 错误处理
- 网页缓存
- 程序分析
- 以 CLI 方式运行
- 管理你的应用程序
- 处理多环境
- 在视图文件中使用 PHP 替代语法
- 安全
- PHP 开发规范
- 基准测试类
- 缓存驱动器
- 日历类
- 购物车类
- 配置类
- Email 类
- 加密类
- 加密类(新版)
- 文件上传类
- 表单验证类
- FTP 类
- 图像处理类
- 输入类
- Javascript 类
- 语言类
- 加载器类
- 迁移类
- 输出类
- 分页类
- 模板解析类
- 安全类
- Session 类
- HTML 表格类
- 引用通告类
- 排版类
- 单元测试类
- URI 类
- 用户代理类
- XML-RPC 与 XML-RPC 服务器类
- Zip 编码类
- 数据库参考
- 数据库快速入门: 示例代码
- 数据库配置
- 连接你的数据库
- 查询
- 生成查询结果
- 查询辅助函数
- 查询构造器类
- 事务
- 数据库元数据
- 自定义函数调用
- 数据库缓存类
- 数据库工厂类
- 数据库工具类
- 数据库驱动器参考
- 数组辅助函数
- 验证码辅助函数
- Cookie 辅助函数
- 日期辅助函数
- 目录辅助函数
- 下载辅助函数
- 邮件辅助函数
- 文件辅助函数
- 表单辅助函数
- HTML 辅助函数
- Inflector 辅助函数
- 语言辅助函数
- 数字辅助函数
- 路径辅助函数
- 安全辅助函数
- 表情辅助函数
- 字符串辅助函数
- 文本辅助函数
- 排版辅助函数
- URL 辅助函数
- XML 辅助函数
- The MIT License (MIT)
- 服务器要求
- 关于 CodeIgniter
PHP 开发规范
CodeIgniter 的开发遵循本页所描述的编码规范,我们也推荐在你自己的应用程序开发中使用 这些规范,但不做强求。
目录
- PHP 开发规范
- 文件格式
- TextMate
- BBEdit
- PHP 结束标签
- 文件的命名
- 类和方法的命名
- 变量的命名
- 注释
- 常量
- TRUE、FALSE 和 NULL
- 逻辑操作符
- 对返回值进行比较以及类型转换
- 调试代码
- 文件中的空格
- 兼容性
- 一个类一个文件
- 空格
- 换行
- 代码缩进
- 中括号和小括号内的空格
- 本地化文本
- 私有方法和变量
- PHP 错误
- 短标记
- 每行只有一条语句
- 字符串
- SQL 查询
- 缺省的函数参数
- 文件格式
文件格式
文件应该保存为 Unicode(UTF-8)编码格式,不要使用 字节序标记(BOM),和 UTF-16 和 UTF-32 不一样, UTF-8 编码格式的文件不需要指定字节序。而且 BOM 会在 PHP 的输出中产生副作用, 它会阻止应用程序设置它的头信息。另外,所有的换行符应该使用 Unix 格式换行符(LF)。
以下是在一些常见的文本编辑器中更改这些设置的方法。针对你的编辑器,方法也许会有所不同, 请参考你的编辑器的说明。
TextMate
- 打开应用程序设置
- 点击 "高级" ,切换到 "保存" 标签页。
- 在 "文件编码" 中,选择 "UTF-8(推荐)"
- 在 "换行符" 中,选择 "LF(推荐)"
- 可选:如果你想对现有文件也能自动作此设置,勾上 "同时应用到已有文件" 选项
BBEdit
- 打开应用程序设置
- 选择左侧的 "文本编码"
- 在 "新文档的默认编码",选择 "Unicode (UTF-8, no BOM)"
- 可选:在 "如果无法检测文件编码,使用...",选择 "Unicode (UTF-8, no BOM)"
- 选择左侧的 "文本文件"
- 在 "默认的换行符" 中,选择 "Mac OS X and Unix (LF)"
PHP 结束标签
PHP 结束标签 ?> 对于 PHP 解析器来说是可选的,但是只要使用了,结束标签之后的空格 有可能会导致不想要的输出,这个空格可能是由开发者或者用户又或者 FTP 应用程序引入的, 甚至可能导致出现 PHP 错误,如果配置了不显示 PHP 错误,就会出现空白页面。基于这个原因, 所有的 PHP 文件将不使用结束标签,而是以一个空行代替。
文件的命名
类文件的命名必须以大写字母开头,其他文件(配置文件,视图,一般的脚本文件等)的命名是全小写。
错误的:
somelibrary.php someLibrary.php SOMELIBRARY.php Some_Library.php Application_config.php Application_Config.php applicationConfig.php
正确的:
Somelibrary.php Some_library.php applicationconfig.php application_config.php
另外,类文件的名称必须和类的名称保持一致,例如,如果你有一个类名为 Myclass , 那么文件名应该是 Myclass.php 。
类和方法的命名
类名必须以大写字母开头,多个单词之间使用下划线分割,不要使用驼峰命名法。
错误的:
class superclass class SuperClass
正确的:
class Super_class
class Super_class { public function __construct() { } }
类的方法应该使用全小写,并且应该明确指出该方法的功能,最好包含一个动词。 避免使用冗长的名称,多个单词之间使用下划线分割。
错误的:
function fileproperties() // not descriptive and needs underscore separator function fileProperties() // not descriptive and uses CamelCase function getfileproperties() // Better! But still missing underscore separator function getFileProperties() // uses CamelCase function get_the_file_properties_from_the_file() // wordy
正确的:
function get_file_properties() // descriptive, underscore separator, and all lowercase letters
变量的命名
变量的命名规则和类方法的命名规则非常接近,使用全小写,使用下划线分割, 并且应该明确指出该变量的用途。非常短的无意义的变量只应该在 for 循环中作为迭代器使用。
错误的:
$j = 'foo'; // single letter variables should only be used in for() loops $Str // contains uppercase letters $bufferedText // uses CamelCasing, and could be shortened without losing semantic meaning $groupid // multiple words, needs underscore separator $name_of_last_city_used // too long
正确的:
for ($j = 0; $j < 10; $j++) $str $buffer $group_id $last_city
注释
通常情况下,应该多写点注释,这不仅可以向那些缺乏经验的程序员描述代码的流程和意图, 而且当你几个月后再回过头来看自己的代码时仍能帮你很好的理解。 注释并没有强制规定的格式,但是我们建议以下的形式。
DocBlock 风格的注释,写在类、方法和属性定义的前面,可以被 IDE 识别:
/** * Super Class * * @package Package Name * @subpackage Subpackage * @category Category * @author Author Name * @link http://example.com */ class Super_class {
/** * Encodes string for use in XML * * @param string $str Input string * @return string */ function xml_encode($str)
/** * Data for class manipulation * * @var array */ public $data = array();
单行注释应该和代码合在一起,大块的注释和代码之间应该留一个空行。
// break up the string by newlines $parts = explode("\n", $str); // A longer comment that needs to give greater detail on what is // occurring and why can use multiple single-line comments. Try to // keep the width reasonable, around 70 characters is the easiest to // read. Don't hesitate to link to permanent external resources // that may provide greater detail: // // http://example.com/information_about_something/in_particular/ $parts = $this->foo($parts);
常量
常量遵循和变量一样的命名规则,除了它需要全部大写。尽量使用 CodeIgniter 已经定义好的常量, 如:SLASH、LD、RD、PATH_CACHE 等。
错误的:
myConstant // missing underscore separator and not fully uppercase N // no single-letter constants S_C_VER // not descriptive $str = str_replace('{foo}', 'bar', $str); // should use LD and RD constants
正确的:
MY_CONSTANT NEWLINE SUPER_CLASS_VERSION $str = str_replace(LD.'foo'.RD, 'bar', $str);
TRUE、FALSE 和 NULL
TRUE 、 FALSE 和 NULL 这几个关键字全部使用大写。
错误的:
if ($foo == true) $bar = false; function foo($bar = null)
正确的:
if ($foo == TRUE) $bar = FALSE; function foo($bar = NULL)
逻辑操作符
不要使用 || 操作符,它在一些设备上看不清(可能看起来像是数字 11), 使用 && 操作符比使用 AND 要好一点,但是两者都可以接受。 另外,在 ! 操作符的前后都应该加一个空格。
错误的:
if ($foo || $bar) if ($foo AND $bar) // okay but not recommended for common syntax highlighting applications if (!$foo) if (! is_array($foo))
正确的:
if ($foo OR $bar) if ($foo && $bar) // recommended if ( ! $foo) if ( ! is_array($foo))
对返回值进行比较以及类型转换
有一些 PHP 函数在失败时返回 FALSE ,但是也可能会返回 "" 或 0 这样的有效值, 这些值在松散类型比较时和 FALSE 是相等的。所以当你在条件中使用这些返回值作比较时, 一定要使用严格类型比较,确保返回值确实是你想要的,而不是松散类型的其他值。
在检查你自己的返回值和变量时也要遵循这种严格的方式,必要时使用 === 和 !== 。
错误的:
// If 'foo' is at the beginning of the string, strpos will return a 0, // resulting in this conditional evaluating as TRUE if (strpos($str, 'foo') == FALSE)
正确的:
if (strpos($str, 'foo') === FALSE)
错误的:
function build_string($str = "") { if ($str == "") // uh-oh! What if FALSE or the integer 0 is passed as an argument? { } }
正确的:
function build_string($str = "") { if ($str === "") { } }
另外关于 类型转换 的信息也将很有用。 类型转换会对变量产生一点轻微的影响,但可能也是期望的。例如 NULL 和 布尔值 FALSE 会转换为空字符串, 数字 0 (和其他数字)将会转换为数字字符串,布尔值 TRUE 会变成 "1":
$str = (string) $str; // cast $str as a string
调试代码
不要在你的提交中包含调试代码,就算是注释掉了也不行。 像 var_dump() 、 print_r() 、 die() 和 exit() 这样的函数,都不应该包含在你的代码里, 除非它们用于除调试之外的其他特殊用途。
文件中的空格
PHP 起始标签的前面和结束标签的后面都不要留空格,输出是被缓存的,所以如果你的文件中有空格的话, 这些空格会在 CodeIgniter 输出它的内容之前被输出,从而会导致错误,而且也会导致 CodeIgniter 无法发送正确的头信息。
兼容性
CodeIgniter 推荐使用 PHP 5.6 或更新版本,但是它还得同时兼容 PHP 5.3.7。 你的代码要么提供适当的回退来兼容这点,要么提供一些可选的功能,当不兼容时能安静的退出而不影响用户的程序。
另外,不要使用那些需要额外安装的库的 PHP 函数,除非你能给出当该函数不存在时,有其他的函数能替代它。
一个类一个文件
除非几个类是*紧密相关的*,否则每个类应该单独使用一个文件。 在 CodeIgniter 中一个文件包含多个类的一个例子是 Xmlrpc 类文件。
空格
在代码中使用制表符(tab)来代替空格,这虽然看起来是一件小事,但是使用制表符代替空格, 可以让开发者阅读你代码的时候,可以根据他们的喜好在他们的程序中自定义缩进。 此外还有一个好处是,这样文件可以更紧凑一点,也就是本来是四个空格字符, 现在只要一个制表符就可以了。
换行
文件必须使用 Unix 的换行格式保存。这对于那些在 Windows 环境下的开发者可能是个问题, 但是不管在什么环境下,你都应该确认下你的文本编辑器已经配置好使用 Unix 换行符了。
代码缩进
使用 Allman 代码缩进风格。除了类的定义之外,其他的所有大括号都应该独占一行, 并且和它对应的控制语句保持相同的缩进。
错误的:
function foo($bar) { // ... } foreach ($arr as $key => $val) { // ... } if ($foo == $bar) { // ... } else { // ... } for ($i = 0; $i < 10; $i++) { for ($j = 0; $j < 10; $j++) { // ... } } try { // ... } catch() { // ... }
正确的:
function foo($bar) { // ... } foreach ($arr as $key => $val) { // ... } if ($foo == $bar) { // ... } else { // ... } for ($i = 0; $i < 10; $i++) { for ($j = 0; $j < 10; $j++) { // ... } } try { // ... } catch() { // ... }
中括号和小括号内的空格
一般情况下,使用中括号和小括号的时候不应该使用多余的空格。 唯一的例外是,在那些接受一个括号和参数的 PHP 的控制结构(declare、do-while、elseif、for、 foreach、if、switch、while)的后面应该加一个空格,这样做可以和函数区分开来,并增加可读性。
错误的:
$arr[ $foo ] = 'foo';
正确的:
$arr[$foo] = 'foo'; // no spaces around array keys
错误的:
function foo ( $bar ) { }
正确的:
function foo($bar) // no spaces around parenthesis in function declarations { }
错误的:
foreach( $query->result() as $row )
正确的:
foreach ($query->result() as $row) // single space following PHP control structures, but not in interior parenthesis
本地化文本
CodeIgniter 的类库应该尽可能的使用相应的语言文件。
错误的:
return "Invalid Selection";
正确的:
return $this->lang->line('invalid_selection');
私有方法和变量
那些只能在内部访问的方法和变量,例如供公有方法使用的那些工具方法或辅助函数,应该以下划线开头。
public function convert_text() private function _convert_text()
PHP 错误
运行代码时不应该出现任何错误信息,并不是把警告和提示信息关掉来满足这一点。 例如,绝不要直接访问一个你没设置过的变量(例如,$_POST 数组), 你应该先使用 isset() 函数判断下。
确保你的开发环境对所有人都开启了错误报告,PHP 环境的 display_errors 参数也开启了, 你可以通过下面的代码来检查:
if (ini_get('display_errors') == 1) { exit "Enabled"; }
有些服务器上 display_errors 参数可能是禁用的,而且你没有权限修改 php.ini 文件, 你可以使用下面的方法来启用它:
ini_set('display_errors', 1);
注解
使用 ini_set() 函数在运行时设置 display_errors 参数和通过 php.ini 配置文件来设置是不一样的,换句话说,当出现致命错误(fatal errors)时,这种方法没用。
短标记
使用 PHP 的完整标记,防止服务器不支持短标记( short_open_tag )参数。
错误的:
<? echo $foo; ?> <?=$foo?>
正确的:
<?php echo $foo; ?>
注解
PHP 5.4 下 <?= 标记是永远可用的。
每行只有一条语句
切记不要在同一行内写多条语句。
错误的:
$foo = 'this'; $bar = 'that'; $bat = str_replace($foo, $bar, $bag);
正确的:
$foo = 'this'; $bar = 'that'; $bat = str_replace($foo, $bar, $bag);
字符串
字符串使用单引号引起来,当字符串中有变量时使用双引号,并且使用大括号将变量包起来。 另外,当字符串中有单引号时,也应该使用双引号,这样就不用使用转义符。
错误的:
"My String" // no variable parsing, so no use for double quotes "My string $foo" // needs braces 'SELECT foo FROM bar WHERE baz = \'bag\'' // ugly
正确的:
'My String' "My string {$foo}" "SELECT foo FROM bar WHERE baz = 'bag'"
SQL 查询
SQL 关键字永远使用大写:SELECT、INSERT、UPDATE、WHERE、AS、JOIN、ON、IN 等。
考虑到易读性,把长的查询分成多行,最好是每行只有一个从句或子从句。
错误的:
// keywords are lowercase and query is too long for // a single line (... indicates continuation of line) $query = $this->db->query("select foo, bar, baz, foofoo, foobar as raboof, foobaz from exp_pre_email_addresses ...where foo != 'oof' and baz != 'zab' order by foobaz limit 5, 100");
正确的:
$query = $this->db->query("SELECT foo, bar, baz, foofoo, foobar AS raboof, foobaz FROM exp_pre_email_addresses WHERE foo != 'oof' AND baz != 'zab' ORDER BY foobaz LIMIT 5, 100");
缺省的函数参数
适当的时候,提供函数参数的缺省值,这有助于防止因错误的函数调用引起的PHP错误, 另外提供常见的备选值可以节省几行代码。例如:
function foo($bar = '', $baz = FALSE)
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论