3.1 开头注释所有的源文件都应该在开头有一个C语言风格的注释，其中列出类名、功能、版本信息、日期、作者和版权声明：/* * 类名 * 功能 * 版本 * 日期 * 作者 * 版权 */如果对文件进行了修改，应该在文件头中说明修改目的、修改日期、修改人，并变更文件的版本信息；如果修改问文件的一部分，则在文件中进行注释即可，并且标识出修改部分的起止位置……/* * 修改目的 * 修改日期 * 修改人 * 版本 */……修改起始………...
6.1 简单的语句每行至多包含一条语句，例如：$argv++; // 正确的$argc--; // 正确的$argv++; $argc--; // 错误的6.2 复合语句复合语句是包含在大括号中的语句序列，形如"{ 语句 }"。例如下面各段。- 被括其中的语句应该较之复合语句缩进一个层次- 左大括号"{"应位于复合语句起始行的行尾；右大括号"}"应另起一行并与复合语句首行对齐。- 大括号可以被用于所有语句，包括单个语句，只要这些语句是诸如if-else或for控制结构的一部分。...
8.4 变量除了变量名外，所有实例，包括类，类常量，均采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写。变量名不应以下划线或美元符号开头，尽管这在语法上是允许的。变量名应简短且富于描述。变量名的选用应该易于记忆，即，能够指出其用途。尽量避免单个字符的变量名，除非是一次性的临时变量。临时变量通常被取名为i，j，k，m和n，它们一般用于整型；c，d，e，它们一般用于字符型。char $c;int $i;float $...
6.8 switch语句一个switch语句应该具有如下格式：switch (condition) { case ABC: /* falls through */ statements; case DEF: statements; break; case XYZ: statements; break; default: statements; break;}每当一个case顺着往下执行时(因为没有break语句)，通常应在break语句的位置添加注释。上面的示例代码中就包含注释/* falls through */。 http://www...
3.2 引入语句引入语句应该位于文件的头部，并在引入时说明引入文件的作用。例如：//数据库操作类require( “db.php” );3.3 类的声明1 类文档注释(/**……*/) 该注释中所需包含的信息，参见"文档注释" 2 类的声明3 类实现的注释(/*……*/)如果有必要的话 该注释应包含任何有关整个类的信息，而这些信息又不适合作为类文档注释。4 类的(静态)变量 首先是类的公共变量，随后是保护变量，再后是包一级别的变量(没有访问修饰符，access...
9.3.3 返回值设法让你的程序结构符合目的。例如：if (booleanExpression) { return true;} else { return false;}应该代之以如下方法：return booleanExpression;类似地：if (condition) { return x;}return y;应该写做：return (condition ? x : y); http://www.bkjia.com/PHPjc/532578.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/532578.htmlTechArticle9.3.3 返回值 设法让你的程序结构符合目的。例如： ...
9.1 常量位于for循环中作为计数器值的数字常量，除了-1,0和1之外，不应被直接写入代码。9.2 变量赋值避免在一个语句中给多个变量赋相同的值。它很难读懂。例如：$fooBar.fChar = $barFoo.lchar = c; // 错误不要将赋值运算符用在容易与相等关系运算符混淆的地方。例如：if ($c++ = $d++) { // 错误 ...}应该写成if (($c++ = $d++) != 0) { ...}不要使用内嵌(embedded)赋值运算符试图提高运行时的效率，这是编译器的工作。例...
9.3.4 运算符"?"前的表达式如果一个包含二元运算符的表达式出现在三元运算符" ? : "的"?"之前，那么应该给表达式添上一对圆括号。例如：(x >= 0) ? x : -x;9.3.5 特殊注释在注释中使用XXX来标识某些未实现(bogus)的但可以工作(works)的内容。用FIXME来标识某些假的和错误的内容。 http://www.bkjia.com/PHPjc/532577.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/532577.htmlTechArticle9.3.4 运算符"?"前的表达式 如果...
6.3 返回语句一个带返回值的return语句不使用小括号"()"，除非它们以某种方式使返回值更为显见。例如：return;return myDisk.size();return ($size ? $size : $defaultSize); http://www.bkjia.com/PHPjc/532591.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/532591.htmlTechArticle6.3 返回语句 一个带返回值的return语句不使用小括号"()"，除非它们以某种方式使返回值更为显见。例如： return; return myDisk.size();...
3.4 缩进排版4个空格常被作为缩进排版的一个单位。缩进的确切解释并未详细指定(空格 vs. 制表符)。一个制表符等于8个空格(而非4个)，所以在某些编辑器中，需要特别指定一下制表符的长度为4（UltraEdit），而在某些编辑器中，会将制表符转换为空格3.5 行长度尽量避免一行的长度超过80个字符，因为很多终端和工具不能很好处理之。 http://www.bkjia.com/PHPjc/532600.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/532600....
10 代码范例/* * @(#)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 classV...
5.4 类的声明当编写类时，应该遵守以下格式规则：- 在方法名与其参数列表之前的左括号"("间不要有空格- 左大括号"{"位于声明语句同行的末尾- 右大括号"}"另起一行，与相应的声明语句对齐，除非是一个空语句，"}"应紧跟在"{"之后 class Sample extends Object { int $ivar1; int $ivar2;function Sample(int $i, int $j) { ivar$1 = $i; ivar$2 = $j;}function emptyMethod() {} ...}- 方法与方法之间以空行分隔 ...
6 if与else语句if-else语句应该具有如下格式：if (condition){ /* 进行操作的条件 */ statements;}if (condition) {/*进行操作的条件. */ statements;} else {/*进行操作的条件*/ statements;}if (condition) {/*进行操作的条件*/ statements;} else if (condition) {/*进行操作的条件 */ statements;} else{/*进行操作的条件*/ statements;}注意：if语句总是用"{"和"}"括起来，避免使用如下容易引起错误的格式：...
8.3 函数方法名是一个动词，采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写。function run();function runFast();function getBackground();通常每个方法都是执行一个动作的，所以对它的命名应该清楚的说明它是做什么的：用checkForErrors()代替errorCheck()，用dumpDataToFile()代替dataFile()。这么做也可以使功能和数据成为更可区分的物体。有时后缀名是有用的: Max - 含义为某实体所能赋予的最大值。Cnt...
9.3.1 圆括号一般而言，在含有多种运算符的表达式中使用圆括号来避免运算符优先级问题，是个好方法。即使运算符的优先级对你而言可能很清楚，但对其他人未必如此。你不能假设别的程序员和你一样清楚运算符的优先级。if ($a == $b && $c == $d) // 错误if (($a == $b) && ($c == $d)) // 正确 http://www.bkjia.com/PHPjc/532580.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/532580.htmlTechArticle9.3.1 圆括号 一般而...