2010年7月3日 PHP编码规范 第1小节 文件夹命名一般采用英文，长度一般不超过20个字符，命名采用小写字母。除特殊情况才使用中文拼音，一些常见的文件夹命名如：images(存放图形文件)，flash（存放Flash文件），style(存放CSS文件)，scripts（存放Javascript脚本），inc(存放include文件)，link（存放友情链接）,media(存放多媒体文件)等。文件名称统一用小写的英文字母、数字和下划线的组合。 3 源文件的编码规范 1 /* * 类名 * 功能 * 版本 * 日期 * 作者 * 版权 */ 如果对文件进行了修改，应该在文件头中说明修改目的、修改日期、修改人，并变更文件的版本信息；如果修改问文件的一部分，则在文件中进行注释即可，并且标识出修改部分的起止位置 …… /* * 修改目的 * 修改日期 * 修改人 * 版本 */ …… 修改起始 …… …… 修改结束 …… 4 注释 1 块注释通常用于提供对文件，方法，数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方，比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。 块注释之首应该有一个空行，用于把块注释和代码分割开来，比如： /* * 这里是块注释 */ 块注释可以以/*-开头，这样indent(1)就可以将之识别为一个代码块的开始，而不会重排它。 /*- * 如果想被忽略，可是使用特别格式的块注释 * * one * two * three */ 注意：如果你不使用indent(1)，就不必在代码中使用/*-，或为他人可能对你的代码运行indent(1)作让步。 5 声明 1 推荐一行一个声明，因为这样以利于写注释。亦即， int $level; // 缩进的程度 int $size; // 由制表符决定 要优于， int $level, $size; 不要将不同类型变量的声明放在同一行，例如： int $foo, $fooarray[]; //错误 注意：上面的例子中，在类型和标识符之间放了一个空格，另一种被允许的替代方式是使用制表符： int $level; // 缩进的程度 int $size; // 由制表符决定 $currentEntry; // 通常选择制表符作为缩进的标准 6 语句 1 每行至多包含一条语句，例如： $argv++; // 正确的 $argc--; // 正确的 $argv++; $argc--; // 错误的 « 上一篇 俄银行家欲冷冻自己大脑期待未来重生(图)下一篇 » Alt+Tab 能干什么？