magento 1 phpdoc语法不正确?
-
13-12-2019 - |
题
我已经注意到了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 */
. 解决方案
除非有MAGENTO 1编码法规,否则您不会获得满意的答案。
但是,magento 1跟随,又转动对phpdoc的引用。所以在理论上,你的观察是正确的。 在实践中,对PHPDOC的任何法规可能都太严格,而不是通过自动验证强制。结果,开发人员根据他们的IDE做了什么。 phpstorm支持两种变体。 NetBeans和Eclipse一个和另一个 - T.B.C。for magento 2有发布的标准明确允许格式