PHP 编码规范4

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

>>阅读原文<<