在方法注释中的@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和如何处理它们.