PHP开发规范小结
[TOC] ## 文件格式
PHP代码文件必须以 不带BOM的 UTF-8编码。
所有PHP文件必须使用 Unix LF (linefeed)作为行的结束符。
PHP 结束标签
所有PHP文件必须以一个空白行作为结束。
纯PHP代码文件必须省略最后的 ?>结束标签。
文件的命名
类文件的命名必须以大写字母开头，其他文件（配置文件，视图，一般的脚本文件等）的命名是全小写。另外，类文件的名称必须和类的名称保持一致。
命名空间和类的命名
- CI框架：类名必须以大写字母开头，多个单词之间使用下划线分割，不要使用驼峰命名法。
- RSP-1：类的命名必须 遵循 StudlyCaps大写开头的驼峰命名规范。
方法的命名
- CI框架：类的方法应该使用全小写，并且应该明确指出该方法的功能，最好包含一个动词。 避免使用冗长的名称，多个单词之间使用下划线分割。
- RSP-1:方法名称必须符合 camelCase() 式的小写开头驼峰命名规范。
属性的命名
- CI框架：变量的命名规则和类方法的命名规则非常接近，使用全小写，使用下划线分割， 并且应该明确指出该变量的用途。非常短的无意义的变量只应该在 for 循环中作为迭代器使用。
- RSP-1：类的属性命名可以遵循 大写开头的驼峰式 ( $StudlyCaps)、小写开头的驼峰式 ( $camelCase) 又或者是 下划线分隔式 ( $under_score)，本规范不做强制要求，但无论遵循哪种命名方式，都应该在一定的范围内保持一致。这个范围可以是整个团队、整个包、整个类或整个方法。
注释
通常情况下，应该多写点注释，这不仅可以向那些缺乏经验的程序员描述代码的流程和意图， 而且当你几个月后再回过头来看自己的代码时仍能帮你很好的理解。 注释并没有强制规定的格式，但是我们建议以下的形式。
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); 常量
类的常量中所有字母都必须大写，词间以下划线分隔。 参照以下代码：
PHP所有 关键字必须全部小写。
常量 true、 false和 null也必须全部小写。
逻辑操作符
不要使用 ||操作符，它在一些设备上看不清（可能看起来像是数字 11）， 使用 &&操作符比使用 AND要好一点，但是两者都可以接受。 另外，在 !操作符的前后都应该加一个空格。
对返回值进行比较以及类型转换
有一些 PHP 函数在失败时返回 FALSE ，但是也可能会返回 "" 或 0 这样的有效值， 这些值在松散类型比较时和 FALSE 是相等的。所以当你在条件中使用这些返回值作比较时， 一定要使用严格类型比较，确保返回值确实是你想要的，而不是松散类型的其他值。
在检查你自己的返回值和变量时也要遵循这种严格的方式，必要时使用 === 和 !== 。
文件中的空格
PHP 起始标签的前面和结束标签的后面都不要留空格。
一个类一个文件
除非几个类是 紧密相关的，否则每个类应该单独使用一个文件。
空格
- CI框架：在代码中使用制表符（tab）来代替空格，这虽然看起来是一件小事，但是使用制表符代替空格， 可以让开发者阅读你代码的时候，可以根据他们的喜好在他们的程序中自定义缩进。 此外还有一个好处是，这样文件可以更紧凑一点，也就是本来是四个空格字符， 现在只要一个制表符就可以了。
- PSR-2:代码必须使用4个空格符而不是 tab键 进行缩进。
- 缩进使用制表符，对齐使用空格。
代码缩进
函数和控制结构必须使用 Allman 样式括起来
字符串
字符串使用单引号引起来，当字符串中有变量时使用双引号，并且使用大括号将变量包起来。 另外，当字符串中有单引号时，也应该使用双引号，这样就不用使用转义符。
'My String'"My string {$foo}""SELECT foo FROM bar WHERE baz = 'bag'"