微凉

3.3 类的声明1 类文档注释(/**……*/) 该注释中所需包含的信息，参见"文档注释" 2 类的声明3 类实现的注释(/*……*/)如果有必要的话 该注释应包含任何有关整个类的信息，而这些信息又不适合作为类文档注释。4 类的(静态)变量 首先是类的公共变量，随后是保护变量，再后是包一级别的变量(没有访问修饰符，access modifier)，最后是私有变量。5 实例变量

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

5.3 布局只在代码块的开始处声明变量。（一个块是指任何被包含在大括号"{"和"}"中间的代码。）不要在首次用到该变量时才声明之。这会把注意力不集中的程序员搞糊涂，同时会妨碍代码在该作用域内的可移植性。function myMethod() {　　int $int1 = 0; // 方法块的开始　　if ($condition) {　　　　int $int2 = 0; //

5.4 类的声明当编写类时，应该遵守以下格式规则：- 在方法名与其参数列表之前的左括号"("间不要有空格- 左大括号"{"位于声明语句同行的末尾- 右大括号"}"另起一行，与相应的声明语句对齐，除非是一个空语句，"}"应紧跟在"{"之后class Sample extends Object {　　int $ivar1;　　int $ivar2;function Sa

6.1 简单的语句每行至多包含一条语句，例如：$argv++; // 正确的$argc--; // 正确的$argv++; $argc--; // 错误的

6.2 复合语句复合语句是包含在大括号中的语句序列，形如"{ 语句 }"。例如下面各段。- 被括其中的语句应该较之复合语句缩进一个层次- 左大括号"{"应位于复合语句起始行的行尾；右大括号"}"应另起一行并与复合语句首行对齐。- 大括号可以被用于所有语句，包括单个语句，只要这些语句是诸如if-else或for控制结构的一部分。这样便于添加语句而无需担心由于忘了加括号而引入bug

6.3 返回语句一个带返回值的return语句不使用小括号"()"，除非它们以某种方式使返回值更为显见。例如：return;return myDisk.size();return ($size ? $size : $defaultSize);

6.9 try...catch语句一个try-catch语句应该具有如下格式：try {　　statements;} catch (ExceptionClass e) {　　statements;}一个try-catch语句后面也可能跟着一个finally语句，不论try代码块是否顺利执行完，它都会被执行。try {　　statements;} catc

6.7 do...while语句一个do-while语句应该具有如下格式：do {　　statements;} while (condition);

6.8 switch语句一个switch语句应该具有如下格式：switch (condition) {　　case ABC: 　　/* falls through */　　　　statements;　　case DEF:　　　statements;　　　break;　　case XYZ:　　　　statements;　　　　break;　　d

6.6 while语句一个while语句应该具有如下格式while (condition) {　　statements;}一个空的while语句应该具有如下格式：while (condition);

5.1 每行声明的变量数量推荐一行一个声明，因为这样以利于写注释。亦即，int $level; // 缩进的程度int $size; // 由制表符决定要优于，int $level, $size;不要将不同类型变量的声明放在同一行，例如：int $foo, $fooarray[]; //错误注意：上面的例子中，在类型和标识符之间放了一个空格，另一种被

4.4 行末注释注释界定符"//"，可以注释掉整行或者一行中的一部分。它一般不用于连续多行的注释文本；然而，它可以用来注释掉连续多行的代码段。以下是所有三种风格的例子：if ($foo > 1) {　　// 第二种用法.　　...}else {　　return false; // 说明返回值的原因}//if ($bar > 1) {//// 　//

3.6 换行当一个表达式无法容纳在一行内时，可以依据如下一般规则断开之：- 在一个逗号后面断开- 在一个操作符前面断开- 宁可选择较高级别(higher-level)的断开，而非较低级别(lower-level)的断开- 新的一行应该与上一行同一级别表达式的开头处对齐- 如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边，那就代之以缩进8个空格。以下是断开方法调用的

1 文件结构||――images|――include　　|――parameter　　|――config　　|――function|――indeximages存放图片文件，include中是系统是要引用的文件，一般在parameter中存放参数文件，config中存放配置文件，function中存放方法文件，如javascript的方法等，并按功能模块的分类，将各

2 文件名文件夹命名一般采用英文，长度一般不超过20个字符，命名采用小写字母。除特殊情况才使用中文拼音，一些常见的文件夹命名如：images(存放图形文件)，flash（存放Flash文件），style(存放CSS文件)，scripts（存放Javascript脚本），inc(存放include文件)，link（存放友情链接）,media(存放多媒体文件)等。文件名称统一用小写的英文字母、数字

3.1 开头注释所有的源文件都应该在开头有一个C语言风格的注释，其中列出类名、功能、版本信息、日期、作者和版权声明：/*　* 类名　* 功能　* 版本　* 日期　* 作者　* 版权　*/如果对文件进行了修改，应该在文件头中说明修改目的、修改日期、修改人，并变更文件的版本信息；如果修改问文件的一部分，则在文件中进行注释即可，并且标识出修改部分的起止位置

3.4 缩进排版4个空格常被作为缩进排版的一个单位。缩进的确切解释并未详细指定(空格 vs. 制表符)。一个制表符等于8个空格(而非4个)，所以在某些编辑器中，需要特别指定一下制表符的长度为4（UltraEdit），而在某些编辑器中，会将制表符转换为空格

3.5 行长度尽量避免一行的长度超过80个字符，因为很多终端和工具不能很好处理之。

4.1 块注释块注释通常用于提供对文件，方法，数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方，比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。块注释之首应该有一个空行，用于把块注释和代码分割开来，比如：/*　* 这里是块注释*/块注释可以以/*-开头，这样indent(1)就可以将之识别为

4.2 单行注释短注释可以显示在一行内，并与其后的代码具有一样的缩进层级。如果一个注释不能在一行内写完，就该采用块注释。单行注释之前应该有一个空行。以下是一个代码中单行注释的例子：if (condition) {　　/* 以下代码运行的条件 */　　...}

4.3 尾端注释极短的注释可以与它们所要描述的代码位于同一行，但是应该有足够的空白来分开代码和注释。若有多个短注释出现于大段代码中，它们应该具有相同的缩进。以下是一个代码中尾端注释的例子：if ($a == 2) {　　return TRUE; /* 对单一条件的说明 */} else {　　return isPrime($a); /* 其余的条件 */}

4.5 文档注释文档注释描述php的类、构造器，方法，以及字段(field)。每个文档注释都会被置于注释定界符/**...*/之中，一个注释对应一个类或成员。该注释应位于声明之前：/**　* 说明这个类的一些 ...*/class Example { ...注意顶层(top-level)的类是不缩进的，而其成员是缩进的。描述类的文档注释的第一行(/**)不需缩进；随

6.5 for语句一个for语句应该具有如下格式：for (initialization; condition; update) {　　statements;}一个空的for语句(所有工作都在初始化，条件判断，更新子句中完成）应该具有如下格式：for (initialization; condition; update);当在for语句的初始化或更新子句