الماجنتو 1 فبدوك بناء الجملة غير صحيحة?

Question

لقد لاحظت الإعلانات فبدوك النمط التالي في التعليمات البرمجية الأساسية الماجنتو ، ونسخها في وقت لاحق في ملحقات الماجنتو:

/** @var $varName Mage_Core_Model_Example */

يجب أن لا تتبع @var [type] [$optionalName] [Optional comment] المفهوم أن يستخدم فبدوك?على سبيل المثال:

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

أو ببساطة أكثر في الممارسة:

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

---

تحرير: ربما يكون مجرد تناقض بين فريق التطوير الخاص بهم...لقد وجدت مثالا على ما أود أن تنظر في الصحيح @var حظر أثناء مراجعة التغييرات إي 1.14.2:

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

Answer 1

لن تحصل على إجابة مرضية ما لم تكن هناك الماجنتو 1 لوائح الترميز نشرت في مكان ما.

ومع ذلك ، الماجنتو 1 يتبع زند الترميز القياسية, ، والتي بدورها إشارات إلى فبدوك.لذلك من الناحية النظرية ، ملاحظتك صحيحة.

في الممارسة العملية ، قد لا تكون أي لوائح تجاه فبدوك صارمة للغاية ، ولا يتم فرضها عن طريق التحقق التلقائي.ونتيجة لذلك ، لم المطورين ما عملت اعتمادا على إيد بهم.فبستورم يدعم كلا الاختلافات.نيتبانز والكسوف واحد والآخر-ر. ب. ج.

للماجنتو 2 هناك المعايير المنشورة التي تسمح صراحة لكلا التنسيقين.