php 注释变量类型,为什么在注释中声明PHP变量类型？

在方法注释中的@var标签中添加类型将允许NetBeans向您显示代码完成.这当然是可选的,但总是一个好主意来完全记录您的代码.

编辑：NetBeans为您自动生成注释的提示是使用/ **扩展.要做到这一点,只需将光标放在要记录的属性或方法上,然后键入/ **,然后按ENTER键.这将展开phpDoc样式注释并添加相应的标签.

编辑2：

您可以在属性上使用@var标记,并且可以使用方法上的@param标签来实现与传递到方法中的参数相同的效果.

在属性上使用@var标签将在您使用属性时可以看到代码提示：

/**

*

* @var My_Type

*/

private $_myProperty;

在方法中使用@param标签将在方法中使用参数时给出代码提示：

/**

*

* @param My_Type $obj

*/

public function myMethod($obj) {

}

实现类似效果的另一种方式同时提供了一些类型的安全性是使用PHP的type hinting机制：

public function myMethod(My_Type $obj) {

}

请注意,此方法具有方法签名中指定的类型. NetBeans现在将在使用@param标记的方法中提供相同的代码完成,如果传入方法的类型与指定的类型不同,则PHP将生成一个E_RECOVERABLE_ERROR.如果您有兴趣更多地了解上述错误,请参阅PHP’s documentation regarding errors和如何处理它们.