是唯一 的下划线在变量名中的用法,声明为 "public" 的从不以下划线开头。
象函数名(见上面 3.3 节)一样,变量名总以小写字母开头并遵循“驼峰式”命名约定。
我们鼓励使用冗长的名字,这样容易理解代码。除非在小循环里,不鼓励使用简洁的名字如 "$i" 和 "$n" 。如果一个循环超过 20 行代码,索引的变量名必须有个具有描述意义的名 字。 B.3.6. 常量
常量包含数字字母字符和下划线,数字允许作为常量名。
常量名的所有字母必须大写。
为 加 强 可 读 性 , 常 量 中 的 单 词 必 须 以 下 划 线 分 隔 , 例 如 可 以 这 样 EMBED_SUPPRESS_EMBED_EXCEPTION 但不许这样 EMBED_SUPPRESSEMBEDEXCEPTION。
常量必须通过 "const" 定义为类的成员,不鼓励使用 "define" 定义的全局常量。 B.4. 编码风格 B.4.1. PHP 代码划分(Demarcation) PHP 代码总是用完整的标准的 PHP 标签定界: 1. 复制代码 短标签 ) ( 是不允许的, 只包含 PHP 代码的文件, 不要结束标签 (参见 第 B.2.1 节 “ 常 规 ”) 。 B.4.2. 字符串 B.4.2.1. 字符串文字 当字符串是文字(不包含变量),用单引号( apostrophe )来括起来: 1. $a = 'Example String'; 复制代码 B.4.2.2. 包含单引号(')的字符串文字 当文字字符串包含单引号(apostrophe )就用双引号括起来,特别在 SQL 语句中: 1. $sql = "SELECT `id`, `name` from `people` WHERE `name`='Fred' OR `name`='Susan'"; 复制代码 在转义单引号时,上述语法是首选的。 B.4.2.3. 变量替换
变量替换有下面两种形式: 1. $greeting = "Hello $name, welcome back!"; 2.
3. $greeting = "He
llo {$name}, welcome back!"; 复制代码 为保持一致,这个形式不允许: 1. $greeting = "Hello ${name}, welcome back!"; 复制代码 B.4.2.4. 字符串连接 字符串用 "." 操作符连接,在它的前后加上空格以提高可读性: 1. $company = 'Zend' . ' ' . 'Technologies'; 复制代码 当用 "." 操作符连接字符串,代码可以分成多个行,也是为提高可读性。在这些例子中, 每个连续的行应当由 whitespace 来填补,例如 "." 和 "=" 对齐: 1. $
sql = "SELECT `id`, `name` FROM `people` " 2. . "WHERE `name` = 'Susan' " 3. . "ORDER BY `name` ASC "; 复制代码 B.4.3. 数组 B.4.3.1. 数字索引数组 Numerically Indexed Arrays
索引不能为负数 建议数组索引从 0 开始。 当用 array 声明有索引的数组,在每个逗号的后面价格空格以提高可读性: 1. $sampleArray = array(1, 2, 3, 'Zend', 'Studio'); 复制代码 也可以用 "array" 声明多行有索引的数组,在每个连续行的开头要用空格填补对齐: 1. $sampleArray = array(1, 2, 3, 'Zend', 'Studio', 2. $a, $b, $c, 3. 56.44, $d, 500); 复制代码 B.4.3.2. 关联数组
当用 声明关联数组,array 我们鼓励把代码分成多行,在每个连续行的开头用空格填补来
对齐键和值: 1. $sampleArray = array('firstKey' => 'firstValue', 2. 'secondKey' => 'secondValue'); 复制代码 B.4.4. 类 B.4.4.1. 类的声明
用下面的约定来命名类。
花括号总是从类名下一行开始。 每个类必须有一个符合 PHPDocumentor 标准的
文档块。
四个空格的缩进。 每个 PHP 文件中只有一个类。
放另外的代码到类里允许但不鼓励。在这些文件中,用两行空格来分隔类和其它代码。
这是个可接受的类的例子: 1. 2. 3. 4. 5. 6. 7. 8. /** * Documentation Block Here */ class SampleClass { // entire content of class // must be indented four spaces }
复制代码 B.4.4.2. 类成员变量
必须用下面的变量名约定来命名类成员变量。
变量的声明必须在类的顶部,要先于方法的声明。 不允许使用 var (因为 ZF 是基于 PHP 5 的 ) ,要用 private、 protected 或 public。直接 访问变量允许但不鼓励,最好使用访问器 (set/get) 。 B.4.5. 函数和方法 B.4.5.1. 函数和方方声明
必须用下面的变量名约定来命名函数。
在类中的函数必须用 p