magento 1 phpdoc语法不正确？

Question

我已经注意到了Magento核心代码中的以下样式phpdoc声明，随后在magento扩展中复制：

/** @var $varName Mage_Core_Model_Example */

.

它不应该遵循 @var [type] [$optionalName] [Optional comment]概念phpdoc使用？例如：

/** @var Mage_Core_Model_Example $optionalVarNameOrComment Optional comment here */

.

或更简单的实践：

/** @var Mage_Core_Model_Example */
$example = Mage::getModel('core/example');

.

---

编辑：也许它在他们的开发团队中的不一致......我发现了一个例子，我将在审查EE 1.14.2的情况下查看正确的世代ocodetagcode块的示例：

# app/code/core/Mage/Adminhtml/Model/Sales/Order/Create.php - 1531:
/** @var Mage_Sales_Model_Order $oldOrder */

.

Answer 1

除非有MAGENTO 1编码法规，否则您不会获得满意的答案。

但是，magento 1跟随，又转动对phpdoc的引用。所以在理论上，你的观察是正确的。

在实践中，对PHPDOC的任何法规可能都太严格，而不是通过自动验证强制。结果，开发人员根据他们的IDE做了什么。 phpstorm支持两种变体。 NetBeans和Eclipse一个和另一个 - T.B.C。

for magento 2有发布的标准明确允许格式