PHP 编码规范-声明

作者：phpchina     来源：     时间：2007-05-03

5.1 每行声明的变量数量

推荐一行一个声明，因为这样以利于写注释。亦即，

int $level; // 缩进的程度
int $size; // 由制表符决定

要优于，

int $level, $size;

不要将不同类型变量的声明放在同一行，例如：

int $foo, $fooarray[]; //错误

注意：上面的例子中，在类型和标识符之间放了一个空格，另一种被允许的替代方式是使用制表符：

int $level; // 缩进的程度
int $size; // 由制表符决定
$currentEntry; // 通常选择制表符作为缩进的标准

5.2 初始化

尽量在声明局部变量的同时初始化。唯一不这么做的理由是变量的初始值依赖于某些先前发生的计算。

5.3 布局

只在代码块的开始处声明变量。（一个块是指任何被包含在大括号"{"和"}"中间的代码。）不要在首次用到该变量时才声明之。这会把注意力不集中的程序员搞糊涂，同时会妨碍代码在该作用域内的可移植性。

function myMethod() {
　　int $int1 = 0; // 方法块的开始

　　if ($condition) {
　　　　int $int2 = 0; // "if"块的开始
　　　　...
　　}
}

该规则的一个例外是for循环的索引变量

for (int $i = 0; i < $maxLoops; $i++) { ... }

避免声明的局部变量覆盖上一级声明的变量。例如，不要在内部代码块中声明相同的变量名：

int $count;
...
function myMethod() {
　　if ($condition) {
　　　　int $count = 0; // 避免这种声明
　　　　...
　　}
　...
}

5.4 类的声明

当编写类时，应该遵守以下格式规则：

- 在方法名与其参数列表之前的左括号"("间不要有空格
- 左大括号"{"位于声明语句同行的末尾
- 右大括号"}"另起一行，与相应的声明语句对齐，除非是一个空语句，"}"应紧跟在"{"之后

class Sample extends Object {
　　int $ivar1;
　　int $ivar2;

function Sample(int $i, int $j) {
　　ivar$1 = $i;
　　ivar$2 = $j;
}

function emptyMethod() {}

　　...
}

- 方法与方法之间以空行分隔