黑马程序员技术交流社区
标题: PHP小白应该知道的编码风格 [打印本页]
作者: huawei 时间: 2016-10-14 11:56
标题: PHP小白应该知道的编码风格
本帖最后由 huawei 于 2017-3-5 10:56 编辑
PHP小白应该知道的编码风格
1. php 代码必须以完整的形式来定界(<?php … ?>),即不要使用php 短标签(<? … ?>),且保证在关闭标签后不要有任何空格。
2. 当一个字符串是纯文本组成的时候(即不含有变量),则必须总是以单引号(')作为定界符。例如:
$a = 'Example String';
3. 变量替换中的变量只允许用 $+变量名 的形式。例如:
$greeting = "Hello $name, welcome back!"; // 允许
$greeting = "Hello {$name}, welcome back!"; // 允许
$greeting = "Hello ${name}, welcome back!"; // 不允许
4.当用点号 "." 连接各字符串的时候,字符串与点号间必须用一个空格隔开,且允许把它分割成多行以增强可读性。在这种情况下,点号 "." 必须与等于号 "=" 对齐。例如:
$sql = "SELECT `id`, `name` " . " FROM `people` "
. "WHERE `name` = 'Susan' "
. "ORDER BY `name` ASC ";
当用 array 类型符号来构造数组的时候,必须在每个逗号之后加上一个空格来增强可读性。
例如:$sampleArray = array(1, 2, 3, 'Think', 'SNS');
5. 当使用 array 类型符声明关联数组的时候,我们鼓励把它分成多个行,只是我们必须同时保证每行的键与值的对齐,以保持美观。例如:
$sampleArray = array(
'firstKey' => 'firstValue',
'secondKey' => 'secondValue'
);
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 defineRefInMethod(&$a){
$a = 'a';
}
defineRefInMethod($b);
echo $b; // 'a'
// 实时传递引用-禁止的
function callTimePassRef($a)
{
$a = 'a';
}
callTimePassRef(&$c);
echo $c; // 'a'
14. 函数或方法返回值不可以用括号包住,不然会降低可读性,而且假如以后函数修改为返回引用的话,这将会抛出一个异常。
15. 鼓励尽量使用类型提示,特别是在模块设计中。例如:
class Foo{
public function foo(SomeInterface $object){
////
}
public function bar(array $options){
////
}
}
16. 函数和方法参数必须用逗号+空格来分隔。
17. 对于参数为数组的函数,参数中的数组应该分成多行以增强可读性。例如:
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;
}
作者: eddies 时间: 2016-11-2 16:13
顶顶顶顶顶顶顶顶顶顶顶顶顶顶顶顶顶顶
作者: 小小海 时间: 2016-11-10 22:18
uyhweuiri84
作者: 浅忆旧时光 时间: 2016-11-17 14:31
1218454121324116515
作者: jason_QS 时间: 2016-11-18 23:17
编码风格
作者: 夜歌行 时间: 2016-11-20 16:16
oyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
作者: ch123cn 时间: 2016-11-25 17:54
RE: PHP小白应该知道的编码风格 [修改
作者: hp_eckj_luox 时间: 2016-12-13 16:40
PHP小白应该知道的编码风格 [修改]
作者: 肖肖肖 时间: 2016-12-18 23:55
谢谢分享
作者: 290422624 时间: 2016-12-19 12:45
我想学习
作者: VC丶万人敬仰 时间: 2017-1-3 17:12
6666666666666666666
作者: xiami23king 时间: 2017-1-17 10:26
6666666666666666666666
作者: 1317181388 时间: 2017-2-3 01:13
感谢楼主分享
作者: heychm 时间: 2017-2-6 10:20
656666666666666666
作者: fjdaslfjk 时间: 2017-2-16 11:32
应该知道的编码风格
作者: vcflyfeel 时间: 2017-3-13 15:40
我发现这个命名规范总是前后说得矛盾, 我至少看了不下三篇这样的文章,里面至少有一条和其他的命名规范不一致
作者: —码农— 时间: 2017-4-11 16:52
回复才能看
作者: 剑客星辰 时间: 2017-4-30 10:51
333333333333333333333
作者: 咿呀咿呀哟 时间: 2017-5-2 11:21
感谢分享,谢谢~~
作者: 一路吧 时间: 2017-5-5 07:25
我一直以为elseif是一个函数,原来是else if才是
作者: worldtongf 时间: 2017-5-20 23:17
PHP小白必须懂得的两种常用数据库备份方法
作者: 瞬间回忆 时间: 2017-5-24 16:23
PHP小白应该知道的编码风格
作者: wantswants 时间: 2017-5-26 08:34
谢谢分享哈
作者: dongfengyuli 时间: 2017-5-28 10:45
谢谢谢谢谢谢谢谢
作者: pykpyk 时间: 2017-8-9 10:26
6666666666666666666666666666
作者: 门徒13 时间: 2017-9-4 16:45
看看吧阿布
作者: yuanlinjiayou 时间: 2017-9-8 21:51
111111111111112
欢迎光临 黑马程序员技术交流社区 (http://bbs.itheima.com/) |
黑马程序员IT技术论坛 X3.2 |