文档注释

高质量的 php 函数文档注释对代码理解至关重要。它们包含标记，如：@param（指定参数）、@return（描述返回值）、@throws（列出可能抛出的异常）。使用明确的格式，如使用短横线分隔注释，小写字母和空行分隔标记，以及完整的句子和非重复的信息。仔细的文档注释可提高代码的可维护性和可读性，使…