Magento 1 PHPDOCの構文が正しくありませんか？

Question

マゼントコアコードで次のスタイルのPHPDOC宣言に気付いた後、Magento Extensionsにコピーしました。

/** @var $varName Mage_Core_Model_Example */

.

@var [type] [$optionalName] [Optional comment] Concept 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 Coding Standard 、これは、 phpdoc への参照だから理論的には、あなたの観察は正しいです。

実際には、PHPDOCへの規則は、自動検証によって強制されない、厳密ではない可能性があります。その結果、開発者はIDEに応じて何を働いていました。 PhpStormは両方のバリエーションをサポートします。 NetBeansとEclipse One and T.b.c。

Magento 2の場合両方のフォーマットを明示的に許可する公開標準