PHPDoc

PHPDoc 是一个PHP 版的Javadoc。它是一种注释 PHP 代码的正式标准。它支持通过类似phpDocumentor 这样的外部文档生成器生成API 文档，也可以帮助一些例如Zend Studio, NetBeans, ActiveState Komodo Edit and IDE 和 Aptana Studio 之类的集成开发环境 理解变量类型和弱类型语言中的其他歧义并提供改进的代码完成，类型提示和除错功能。
PHPDoc 可同时支持面向对象 的和面向过程的 代码。

使用 <code> 和 <pre>

<code> 和 <pre> 中的内容会忽略上述列表中的任何HTML 标签。（当然，它们自己对应的关闭标签除外）

文档块模板

文档块模板的目的是缩减重复的输入。例如，如果有大量的类成员变量是私有的，我们可以使用一个文档块模板标记它们的属性为私有。文档块模板就是简单地扩充了其中的普通文档块。
一个文档块模板是通过它头部的一个普通文档块识别的。下面是一个最基本的文档块模板：
/**#@+ * */
将其标记为一个文档块模板的文本是"/**#@+" - 嗯，6个字符都是必须存在的。文档块模板会一直应用到所有的可文档化的元素，直到出现模板结束标记：
/**#@-*/
注意，所有的8个字符必须呈现为"/**#@-*/" ，这样 phpDocumentor 才会将其识别为一个模板。