就是注释标记
注释标记用于生成文档, param指明需要接收的参数, return指明返回值
在使用 phpDocumentor 等工具生成文档时, 会识别相关注释, 而且IDE也会识别, 在编码的过程中会给出提示...|null $nameList 名称列表
*/
类型列表如下:
string: 字符串
int/integer: 数字
boolean/bool: 布尔
float/double: 浮点
object...[描述]
@property
类属性, 指明可以直接访问与修改的类属性, 私有属性需要通过 __get __set 魔术方法设置与访问, 类型参考 @var
@property [类型] [名称] [...描述]
@property-read
类属性, 指明只读的类属性, 私有属性需要通过 __get 魔术方法访问, 类型参考 @var
@property-write
类属性, 指明只写的类属性, 私有属性需要通过...] [名称] [描述]
@ignore
标明生成文档是忽略的值
@users
标明使用到了哪些值
/**
* @users Class::$num 使用此属性计数
*/
----
有一些注释没有给出说明