PHP 注释规范总结

方法注释的常用项

/**
 * 描述
 * @param string $first [<description>]
 * @link http://g.cn
 * @since 5.0 添加了$b参数
 * @author [huxw] [<邮箱>]
 * @date 2020-4-22 //这里可以加上具体时间，不过个人感觉有日期已经足够
 * @api 表示这是一个提供给第三方使用的API接口
 * @return array
 * @license [<url>] GPL
 * @see [url或完整方法名] \yii\base\db::tableName()
 * @throws [类型] [<描述>]
 * @todo [描述]
 * @uses \yii\base\db::$count 使用此属性计数
 * @version 1.0.1 [<描述>]
*/