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

我对 PHP 还很陌生，我刚刚开始使用 NetBeans 来开发我的 PHP 代码。

出乎意料的是，当我在查询中输入变量时，会弹出一个对话框，要求我完成注释以保存变量类型。我做了一些调查，发现这似乎是 NetBeans 的一个流行功能，但我找不到任何信息向我解释why情况就是如此。

为什么有人想在注释中放置 PHP 变量的类型？是为了开发使用，还是对代码本身有实际好处？它是不可或缺的还是可选的？

在 a 中添加类型@var方法注释中的 标签将允许 NetBeans 向您显示代码完成情况。这当然是可选的，但完整记录您的代码始终是一个好主意。

Edit:NetBeans 自动为您生成注释的一个技巧是使用/**扩张。为此，只需将光标放在要记录的属性或方法上方并键入/**然后按ENTER钥匙。这将展开 phpDoc 样式注释并添加适当的标签。

Edit 2:您可以使用@var属性上的标签，您可以使用@param方法上的标记可以通过传递到方法中的参数达到相同的效果。

使用@var当您在任何可见的地方使用该属性时，属性上的标签将为您提供代码提示：

/**
 *
 * @var My_Type
 */
private $_myProperty;

使用@param方法上的标签将为您在方法内使用参数时提供代码提示：

/**
 *
 * @param My_Type $obj 
 */
public function myMethod($obj) {

}

另一种实现类似效果同时提供一定类型安全性的方法是使用 PHP类型提示 http://php.net/manual/en/language.oop5.typehinting.php机制：

public function myMethod(My_Type $obj) {

}

请注意，此方法具有方法签名中指定的类型。 NetBeans 现在将在使用以下方法可用的方法内提供相同的代码完成@param标签和 PHP 将产生一个E_RECOVERABLE_ERROR如果传递给方法的类型与指定的类型不同。看PHP 有关错误的文档 http://docs.php.net/errorfunc.constants#errorfunc.constants.errorlevels.e-recoverable-error如果您有兴趣了解有关上述错误的更多信息，以及如何处理它们。