A股上市公司传智教育(股票代码 003032)旗下技术交流社区北京昌平校区

 找回密码
 加入黑马

QQ登录

只需一步,快速开始

© huawei 黑马粉丝团   /  2016-10-14 11:56  /  5889 人查看  /  26 人回复  /   1 人收藏 转载请遵从CC协议 禁止商业使用本文

本帖最后由 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;
}


游客,如果您要查看本帖隐藏内容请回复


26 个回复

正序浏览
yuanlinjiayou 来自手机 初级黑马 2017-9-8 21:51:49
27#
111111111111112
回复 使用道具 举报
看看吧阿布
回复 使用道具 举报
6666666666666666666666666666
回复 使用道具 举报
谢谢谢谢谢谢谢谢
回复 使用道具 举报

谢谢分享哈
回复 使用道具 举报
PHP小白应该知道的编码风格
回复 使用道具 举报
PHP小白必须懂得的两种常用数据库备份方法
回复 使用道具 举报
我一直以为elseif是一个函数,原来是else if才是
来自宇宙超级黑马专属苹果客户端来自宇宙超级黑马专属苹果客户端
回复 使用道具 举报
感谢分享,谢谢~~
回复 使用道具 举报
333333333333333333333
回复 使用道具 举报
回复才能看
回复 使用道具 举报
我发现这个命名规范总是前后说得矛盾, 我至少看了不下三篇这样的文章,里面至少有一条和其他的命名规范不一致
回复 使用道具 举报
应该知道的编码风格
回复 使用道具 举报
656666666666666666
回复 使用道具 举报
感谢楼主分享
回复 使用道具 举报
6666666666666666666666
回复 使用道具 举报
6666666666666666666
回复 使用道具 举报
我想学习
回复 使用道具 举报
谢谢分享
回复 使用道具 举报
12下一页
您需要登录后才可以回帖 登录 | 加入黑马