PHP几点精华

这样的其中一个原因就是人们不喜欢做一个小库，对小库有一些不正确感觉。把这样的感觉克服掉吧，电脑才不关心你有多少个库呢。

如果你有一些代码可以重用，而且不能放入一个已经存在的库中，那么就做一个新的库吧。如果人们真的考虑重用的话，库不会在很长的一段时间里保持那么小的。

4.5. 知识库

很多公司不清楚现有什么代码可用，而且大多数程序员仍然没有通过沟通他们已经做过了什么，或者一直在询问现存什么代码可用。解决这个的方法是有一个可用的知识库。

理想的情况是，程序员可以到一个WEB页，浏览或者查询打包的知识库列表，找到他们所要的。建立一个程序员可以自动维护的知识库系统，是一个很不错的做法。如果有一个专门的管理员来负责维护这个知识库，那当然更好。

另一种方法是自动的从代码中产生知识库的做法。把通用的类、方法和标头（subsystem headers）作为手册或者是知识库的一个条目。

5. 书写注释

5.1. 讲一个故事

把你的注释当作描述系统的一个故事。并且使得你的注释能被机器解析后，以固定的格式放到手册中去。类的注释是故事的一部分，方法的名称、方法的注释、方法的实现也是故事一部分。所有的这些部分编织在一起，使得人们在以后的时间里能够准确的知道你干了什么，为什么这么做。

5.2. 归档注释

注释的要归档才有意义，否则，假如在一个地方放一条注释描述你做了什么选择和你为什么这么做，只有考古学家才能发现这是最有用的信息。（如何归档另行规范）

5.3. 注释结构

工程的每部分都有特定的注释结构。程序中的注释，这里给出示例作为规范，注释中以 * @ 为关键字的开始，以:为注释关键字结尾。

5.3.1. 预定义关键字

关键字 含义

Purpose 表示类、属**、方法要做些什么或者什么含义。

Package Name 类名

Author 作者

Modifications 修改记录（编号规则为“No”＋日期＋“－”＋序号）

See 参考

Method Name 方法名

Parameter 参数名（包括类型）

Return 返回值（包括类型）

Attribute/Variable Name 属**/变量名

Type 属**/变量类型

5.3.2. 类的注释

/**
* @ Purpose:
* 访问数据库的类，以ODBC作为通用访问接口
* @Package Name: Database
* @Author: Forrest Gump gump@crtvu.edu.cn
* @Modifications:
* No20020523-100:
* odbc_fetch_into()参数位置第二和第三个位置调换
* John Johnson John@crtvu.edu.cn
* @See: (参照)
*/
class Database
{
……
}

5.3.3. 方法注释

/**
* @Purpose:
* 执行一次查询
* @Method Name: Query()
* @Parameter: string $queryStr SQL查询字符串
* @Return: mixed 查询返回值（结果集对象）
*/
function（$queryStr）{……}

5.3.4. 属**或变量注释

/**
* @Purpose:
* 数据库连接用户名
* @Attribute/Variable Name: mDbUserName
* @Type: string
*/
var mDbUserName;

5.3.5. if (0)来注释外部代码块

有时需要注释大段的测试代码，最简单的方法就是使用if (0)块：

function example()
{
great looking code
if (0) {
lots of code
}
more code
}

你不能使用/**/，因为注释内部不能包含注释，而大段的程序中可以包含注释。

5.3.6. 目录文档

所有的目录下都需要具有README文档，其中包括：

· 该目录的功能及其包含内容

· 一个对每一文件的在线说明（带有link），每一个说明通常还应该提取文件标头的一些属**名字。

· 包括设置、使用说明

· 指导人们如何连接相关资源：

o 源文件索引

o 在线文档

o 纸文档

o 设计文档

· 其他对读者有帮助的东西

考虑一下，当每个原有的工程人员走

凌众科技专业提供服务器租用、服务器托管、企业邮局、虚拟主机等服务，公司网站：http://www.lingzhong.cn 为了给广大客户了解更多的技术信息，本技术文章收集来源于网络,凌众科技尊重文章作者的版权，如果有涉及你的版权有必要删除你的文章，请和我们联系。以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!