//单行注释
/*多行注释*/
/**
文档注释 （注意 文档注释与前面的那个多行注释不同）文档注释可以和特定的程序元素相关联 例如 类 函数 常量 变量方法
问了将文档注释与元素相关联 只需要在元素前面声明文档注释块 并且确保后面的*号和斜线与元素之间没有空格即可
*/
/** 这是一个关于函数的注释 */ function a(){...} /* 这不是一个文档注释 因为没有以 **开头 */ function b(){..} /** 这是一个文档注释 但是与函数b无关 因为放到了后面 */
文档注释往往用在比如框架中的路由解析 比如 symfony框架。
文档注释会被实际解析的，并且数据会被存储。当文档注释与元素一起声明时，它会与那个元素相关联。这种关联对于创建数据的场景至关重要。这种关联提供了在程序中嵌入附加元数据的功能。
原文：http://www.cnblogs.com/clphp/p/5138663.html