php 编程规范变量赋值方法

下面我们为php初学者讲一篇关于变量赋值可注意的事项吧。

变量赋值

<?php
 
  $a =1;
  $b =1;
  $c =2;
  $d =2;
 if ($a == $b && $c == $d) die('error');// 错误
  
 if (($a == $b) && ($c == $d)) die('yes');// 正确
 
?>

不要使用内嵌(embedded)赋值运算符试图提高运行时的效率，这是编译器的工作。例如：
$d = ($a = $b + $c) + $r; // 错误

应该写成
$a = $b + $c;
$d = $a + $r;

避免在一个语句中给多个变量赋相同的值。它很难读懂。例如：
$fooBar.fChar = $barFoo.lchar = 'c'; // 错误

不要将赋值运算符用在容易与相等关系运算符混淆的地方。例如：
if ($c++ = $d++) { // 错误
　　...
}

应该写成
if (($c++ = $d++) != 0) {
　　...
}

 

php代码规范化编程实现

代码范例

/*
　* @(#)Cngift.php 1.82 03/06/25
　*
　* 开花石头编写的示例文档
　* 将对编码规范做简单的示范
　*
　*/

require( “db.php” );

/**
　* 示范用类
　*
　* @version 1.82 03.06.25
　* @author 开花石头
　*/
class Blah extends SomeClass {
　　/* 这个类运行时的注释写在这里 */

　　/** 关于变量的注释写在这里 */
　　static int $classVar1;

　　/**
　　　* 对变量编写的多行注释写在这里
　　　*/
　　static string classVar2;

　　/** 变量的文档注释 */
　　int instanceVar1;

　　/** 变量的文档注释 */
　　int[] instanceVar3;

　　/**
　　　* 构造函数的注释
　　　*/
　　function Blah() {
　　　　// ...在这里执行...
　　}

　　/**
　　　* ...函数的文档注释...
　　　*/
　　function doSomething() {
　　　　// ...在这里执行...
　　}

　　/**
　　　* ...方法的注释文档..
　　　* 多行注释
　　　*/
　　public void doSomethingElse(Object someParam) {
　　　　// ...在这里执行...
　　}
}

 

关于类申明我们以前有讲过，这次主要是针对php程序员编程的规范化来讲讲吧。

类的声明

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

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

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

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

function emptyMethod() {}

　　...
}

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

布局

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

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; // 避免这种声明
　　　　...
　　}
　...
}

不管什么语言在变量申明或其它事情都会有多种选择的，但是它们之产有微小的差别，下面我们就拿变量申明来说说吧。

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

要优于，

int $level, $size;

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

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

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

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

本文章提供了5种注释方法：块注释，单行注释，尾端注释，行末注释，文档注释哦，下面我们就一一来看看吧。

短注释可以显示在一行内，并与其后的代码具有一样的缩进层级。如果一个注释不能在一行内写完，就该采用块注释。单行注释之前应该有一个空行。以下是一个代码中单行注释的例子：

if (condition) {

　　/* 以下代码运行的条件 */
　　...
}

尾端注释

if ($a == 2) {
　　return TRUE; /* 对单一条件的说明 */
} else {
　　return isPrime($a); /* 其余的条件 */
}

/*
　* 这里是块注释
*/

块注释可以以/*-开头，这样indent(1)就可以将之识别为一个代码块的开始，而不会重排它。

/*-
　* 如果想被忽略，可是使用特别格式的块注释
　*
　* one
　* 　　two
　* 　　　　three
　*/

注意：如果你不使用indent(1)，就不必在代码中使用/*-，或为他人可能对你的代码运行indent(1)作让步。

4.4 行末注释

注释界定符"//"，可以注释掉整行或者一行中的一部分。它一般不用于连续多行的注释文本；然而，它可以用来注释掉连续多行的代码段。以下是所有三种风格的例子：

if ($foo > 1) {

　　// 第二种用法.
　　...
}
else {
　　return false; // 说明返回值的原因
}

//if ($bar > 1) {
//
// 　// 第三种用法
//　 ...
//}
//else {
　　// return false;
//}

档注释

/**
　* 说明这个类的一些 ...
*/