4. 当使用 array 类型符声明关联数组的时候,我们鼓励把它分成多个行,只是我们必须同时保证每行的键与值的对齐,以保持美观。例如: $sampleArray = array( 'firstKey' => 'firstValue', 'secondKey' => 'secondValue' ); 5. 大括号的开始必须在类名的下一行顶格。例如: class Think { // ... } 6. 类中的所有代码都必须用四个空格来进行缩进。 7. 每个 php 文件只允许声明一个类。在类文件里面写其它代码是允许的,但并不鼓励这样做。假如真要附加代码的话,必须用空行来分隔。 8. 任何类变量的声明都必须放在类顶部,先于任何函数的声明。 9. 不允许用 var 符号来声明变量,类成员变量必须以 private,protected 和 public 来声明。其次,把类成员声明为 public 而直接引用虽然是允许的,但通常更好的方法是使用 get 和 set 方法来访问类成员。 10. 方法必须总是用 private,protected 或者 public 来声明其作用域。 11. 静态 static 方法应该声明其作用域,且不应该再被声明为 private 私有,而应该为 protected 或者public ,如果只是不想被子类继承,则应该用 final 声明它们。 12. 函数或方法的初始大括号应该在函数声明的下一行顶格。例如: function get_client_ip() { // … } 13. 在函数或方法名与参数括号之间不允许出现多余的空格。例如: function get_client_ip() { // … } 14. 引用只允许定义在函数参数中,实时传递引用是禁止的。例如: // 引用定义在函数参数-允许的 function defineRefInMethod(&$a) { $a = 'a'; } defineRefInMethod($b); echo $b; // 'a' // 实时传递引用-禁止的 function callTimePassRef($a) { $a = 'a'; } callTimePassRef(&$c); echo $c; // 'a' 15. 函数或方法返回值不可以用括号包住,不然会降低可读性,而且假如以后函数修改为返回引用的话,这将会抛出一个异常。 16. 鼓励尽量使用类型提示,特别是在模块设计中。例如: class Foo { public function foo(SomeInterface $object) { } public function bar(array $options) { } } 17. 函数和方法参数必须用逗号+空格来分隔。 18. 对于参数为数组的函数,参数中的数组应该分成多行以增强可读性。例如: threeArguments(array(1, 2, 3), 2, 3); threeArguments(array(1, 2, 3, 'Think', 'SNS', $a, $b, $c, 56.44, $d, 500), 2, 3); 19. 基于"if", "else"和"else if"的条件控制里,我们必须用空格间隔开语句和括号,大括号的开始 "{" 必须与条件控制语句位于同一行,结束 "}" 必须总是独占一行且顶格,控制流程内容必须用四个空格进行缩进,且不使用"elseif"。 if ($condition) { // ... } else if ($_condition) { // ... } else { // ... } 20. 在条件控制语句的条件括号内,必须用空格将操作符与其它元素隔开。如果遇到很长的逻辑判断,则鼓励用内嵌括号来分割各个逻辑。例如: if (($a != 2) and ($b == 1)) { $a = $b; } 21. "switch" 条件控制语句中,必须用空格将待测参数与其它元素分隔开。例如: switch ($num) { // … } 22. "switch" 语句的内容必须以四个空格缩进,"case" 条件控制的内容必须再加四个空格进行缩进。例如: switch ($indentedSpaces) { case 2: echo "错误"; break; case 4: echo "正确"; break; default: break; } 23. 在 "switch" 语句中应该总是包括 "default" 控制。 24. 有时候我们需要在 "case" 语境中省略掉 "break" 或 "return" ,这个时候我们必须为这些 "case" 语句加上 "// 此处无break" 注释。例如: switch ($numPeople) { case 1: // 此处无break case 2: break; default: break; } |