PHP编码规范之注释和文件结构说明

2015-01-24信息快讯网

理解学习PHP编码规范之注释和文件结构,编写规则的代码与目录结构让大家能快速的熟悉。提高协同工作效率。

文件结构

|DDimages
|DDinclude
  |DDparameter
  |DDconfig
  |DDfunction
|DDindex
images存放图片文件,include中是系统是要引用的文件,一般在parameter中存放参数文件,config中存放配置文件,function中存放方法文件,如javascript的方法等,并按功能模块的分类,将各功能的类也放入其中
文件名
文件夹命名一般采用英文,长度一般不超过20个字符,命名采用小写字母。除特殊情况才使用中文拼音,一些常见的文件夹命名如:images(存放图形文件),flash(存放Flash文件),style(存放CSS文件),scripts(存放Javascript脚本),inc(存放include文件),link(存放友情链接),media(存放多媒体文件)等。文件名称统一用小写的英文字母、数字和下划线的组合。
块注释
块注释通常用于提供对文件,方法,数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方,比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。
块注释之首应该有一个空行,用于把块注释和代码分割开来,比如:
/*
 * 这里是块注释
*/
块注释可以以/*-开头,这样indent(1)就可以将之识别为一个代码块的开始,而不会重排它。
/*-
 * 如果想被忽略,可是使用特别格式的块注释
 *
 * one
 *   two
 *     three
 */
注意:如果你不使用indent(1),就不必在代码中使用/*-,或为他人可能对你的代码运行indent(1)作让步。
单行注释
短注释可以显示在一行内,并与其后的代码具有一样的缩进层级。如果一个注释不能在一行内写完,就该采用块注释。单行注释之前应该有一个空行。以下是一个代码中单行注释的例子:
if (condition) {
  /* 以下代码运行的条件 */
  ...
}
尾端注释
极短的注释可以与它们所要描述的代码位于同一行,但是应该有足够的空白来分开代码和注释。若有多个短注释出现于大段代码中,它们应该具有相同的缩进。
以下是一个代码中尾端注释的例子:
 
if ($a == 2) { 
  return TRUE; /* 对单一条件的说明 */ 
} else { 
  return isPrime($a); /* 其余的条件 */ 
} 

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

文档注释
文档注释描述php的类、构造器,方法,以及字段(field)。每个文档注释都会被置于注释定界符/**...*/之中,一个注释对应一个类或成员。该注释应位于声明之前:

/**
 * 说明这个类的一些 ...
*/
class Example { ...

注意顶层(top-level)的类是不缩进的,而其成员是缩进的。描述类的文档注释的第一行(/**)不需缩进;随后的文档注释每行都缩进1格(使星号纵向对齐)。成员,包括构造函数在内,其文档注释的第一行缩进4格,随后每行都缩进5格。
若你想给出有关类、变量或方法的信息,而这些信息又不适合写在文档中,则可使用实现块注释(见5.1.1)或紧跟在声明后面的单行注释(见5.1.2)。例如,有关一个类实现的细节,应放入紧跟在类声明后面的实现块注释中,而不是放在文档注释中。
文档注释不能放在一个方法或构造器的定义块中,因为程序会将位于文档注释之后的第一个声明与其相关联。
在WINDOWS中设置计划任务执行PHP文件的方法
php中使用DOM类读取XML文件的实现代码
PHPExcel读取Excel文件的实现代码
PHP中文件缓存转内存缓存的方法
PHP函数篇详解十进制、二进制、八进制和十六进制转换函数说明
遍历指定目录下的所有目录和文件的php代码
php 转换字符串编码 iconv与mb_convert_encoding的区别说明
php数组函数序列之array_combine() - 数组合并函数使用说明
php json_encode奇怪问题说明
PHP安全配置详细说明
php数据结构 算法(PHP描述) 简单选择排序 simple selection sort
php学习笔记(三)操作符与控制结构
PHP 数据结构 算法描述 冒泡排序 bubble sort
PHP 数据结构 算法 三元组 Triplet
php学习之 循环结构实现代码
PHP统计目录下的文件总数及代码行数(去除注释及空行)
批量修改RAR文件注释的php代码
Windows下XDebug 手工配置与使用说明
PHP中开发XML应用程序之基础篇 添加节点 删除节点 查询节点 查询节
PHP三层结构(下) PHP实现AOP第1/2页
PHP三层结构(上) 简单三层结构
php操作excel文件 基于phpexcel
php 上传文件类型判断函数(避免上传漏洞 )
php 网页播放器用来播放在线视频的代码(自动判断并选择视频文件类型)
php ftp文件上传函数(基础版)
php下连接ftp实现文件的上传、下载、删除文件实例代码
在PHP中使用反射技术的架构插件使用说明
PHP 缓存实现代码及详细注释
php 数组操作(增加,删除,查询,排序)等函数说明第1/2页
PHP 魔术函数使用说明
php 上一篇,下一篇文章实现代码与原理说明
php for 循环语句使用方法详细说明
PHP 图片上传实现代码 带详细注释
DedeCMS dede_channeltype表字段注释
php 无限级分类学习参考之对ecshop无限级分类的解析 带详细注释
php 验证码制作(网树注释思想)
©2014-2024 dbsqp.com