PHP 注释标记
发布时间：2022-09-26 15:03:37 所属栏目：PHP教程 来源：
导读： 相关标签@author
@author当前文件的作者
语法
@author [name] []
描述
@author可以后边包含作者电子邮箱，通常电子邮箱由包裹
@deprecated
@deprecate
@author当前文件的作者
语法
@author [name] []
描述
@author可以后边包含作者电子邮箱，通常电子邮箱由包裹
@deprecated
@deprecate
|
相关标签@author @author当前文件的作者 语法 @author [name] [] 描述 @author可以后边包含作者电子邮箱，通常电子邮箱由包裹 @deprecated @deprecated : 被此标记的函数或者成员方法表示下个版本将会被废弃，告知适用方不再推荐使用此方法. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @deprecated [] [] 描述 [@example]()@inheritdoc @inheritdoc : 文档继承,会继承父类的文档注释. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @inheritDoc 描述 @inheritDoc会继承父类的所有文档注释.在继承之后可以对指定字段进行重写 标签效果 直接继承 PHP 注释标记， 继承重写 PHP 注释标记， @link @link : 此标签可以引导你到指定的外部跳转链接. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @link [URI] [] 描述 该标签只有1个跳转选项 和@see的区别 -@see@link 外部链接 √ √ 内部程序 √ X @method @method : 此标签可告诉类有哪些魔术方法可以调用. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @method [modifier] [return type] [name]([[type] [parameter]]) [] 使用场景 当一个类用魔术方法__call去代理执行类成员方法时，对于调用方来讲是很迷茫的，因为调用方是无法知道具体有哪些方法可以调用. 通过引入@method可以解决这个问题，可以在类注释添加@method，定义魔术方法可调用的方法，这样调用法可以通过查看注释即可知道如何调用魔术方法，部分IDE可直接识别@method标签从而实现自动填充以及类型判断． 标签效果 IDE自动提示 PHP 注释标记， 最终效果 PHP 注释标记， @mixin@param @param : 可以记录函数/方法的单个入参的信息. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @param [Type] [name] [] 变量列表 PHP 注释标记， 标签效果 PHP 注释标记， @property @property : 当类中包含魔术方法get/set时，可以通过此标签定义名称. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @property [Type] [name] [] 使用场景 当一个类用魔术方法__get或者__set去代理执行类成员变量时，对于调用方来讲是很迷茫的，因为调用方是无法知道具体有哪些成员. 通过引入@property可以解决这个问题，可以在类注释添加@property定义成员变量，这样调用法可以通过查看注释即可知道具体有哪些成员变量可以使用，部分IDE可直接识别@property标签从而实现自动填充以及类型判断． 变量列表 PHP 注释标记， 标签效果 IDE自动提示 PHP 注释标记， 最终效果 PHP 注释标记， [@return]() [[@return]()]()]()]() : 用于在函数/方法返回值信息. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 [[[@return]()]()]() [Type] [] 变量列表 PHP 注释标记， 标签效果 @see @see : 此标签可以引导你到指定的外部跳转链接/内部程序 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @see [URI | FQSEN] [] 描述 该标签可以有两个跳转选项 和@link的区别 -@see@link 外部链接 √ √ 内部程序 √ X @throws @throws : 抛出一个异常php注释，告诉调用方需要做好处理异常相关工作. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @throws [Type] [] 标签效果 PHP 注释标记， @var @var : 定义一个数据的类型. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @var [Type] [$element_name] [] 变量列表 PHP 注释标记， 标签效果 在类成员变量中定义，不需要指定变量名称 PHP 注释标记， 直接给具体变量定义，需要指定变量名称 PHP 注释标记， @internal @internal : 被此标签标记的内部类/方法，作用范围只能限于当前文件，外部文件不可调用. 此标签推荐使用PhpStorm进行阅读,可以能直观体现标签的作用 语法 @internal [\description] 使用场景 此标签通常可使用在单元测试中，比如在单元测试中定义了一个测试用的类，可对此测试类添加@internal标签，这样别人在正常逻辑中万一不小心错误引用了测试类，在IDE的帮助下，可以第一时间得到反馈. （编辑：开发网_新乡站长网） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |
站长推荐
浙公网安备 33038102330465号