Magento 1 phpdoc 구문이 잘못 되었습니까?

Question

Magento Core 코드의 다음 스타일 PHPDoc 선언을 발견 한 후 Magento Extensions에서 복사했습니다.

/** @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 변경 사항을 검토하는 동안 올바른 @var 블록을 고려하는 것의 예를 발견했습니다 :

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

.

Answer 1

Magento 1 코딩 규정이 어딘가에 게시되지 않는 한 만족스러운 대답을 얻지 못할 것입니다.

그러나 Magento 1은 zend 코딩 표준을 따릅니다. 에 대한 참조. 그래서 이론적으로 당신의 관찰이 정확합니다.

실제로 PHPDOC에 대한 규정은 자동 검증에 의해 강제되지 않고 너무 엄격하지 못했을 수 있습니다. 결과적으로 개발자는 IDE에 따라 일했는지를했습니다. phpstorm은 두 가지 변형을 지원합니다. NetBeans 및 Eclipse One과 다른 - T.B.C.

Magento 2에는 명시 적으로 모두를 명시 적으로 허용하는 게시 된 표준 .