Syntaxe Magento 1 PHPDoc incorrecte ?

Question

J'ai remarqué les déclarations de style PHPDoc suivantes dans le code principal de Magento, puis copiées dans les extensions Magento :

/** @var $varName Mage_Core_Model_Example */

Ne devrait-il pas suivre le @var [type] [$optionalName] [Optional comment] concept que PHPDoc utilise ?Par exemple:

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

Ou plus simplement en pratique :

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

---

Modifier: c'est peut-être juste une incohérence au sein de leur équipe de développement...J'ai trouvé un exemple de ce que je considérerais comme correct @var bloquer en examinant les modifications de EE 1.14.2 :

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

Answer 1

Vous n’obtiendrez pas de réponse satisfaisante à moins que des réglementations de codage Magento 1 soient publiées quelque part.

Cependant, Magento 1 suit le Norme de codage Zend, lequel, à son tour références à PHPDoc.Donc en théorie, votre observation est correcte.

En pratique, les réglementations concernant PHPDoc n'étaient peut-être pas trop strictes, ni forcées par une validation automatique.En conséquence, les développeurs faisaient ce qui fonctionnait en fonction de leur IDE.PHPStorm prend en charge les deux variantes.Netbeans et Eclipse l'un et l'autre – à déterminer

Pour Magento 2 il y a normes publiées qui autorisent explicitement les deux formats.