التعليقات في لارافيل

التعليق بهذا التنسيق يدعى Docblock، مهمته توفير شرح ومعلومات للمطور عن ما بعده (تابع أو متغير)،

لا يؤثر على عمل التابع أبدا فهو مجرد تعليق متعدد الأسطر يتم تجاهله من قبل ال interpreter،

يفيد بيئة التطوير IDE  أو محرر الأكواد للمساعدة في إظهار شروحات عن التابع ومعاملاته وأنوعها أثناء كتابتك للشيفرة،

في VSCode يمكنك وضع المؤشر فوق اسم التابع وسيظهر مربع شرح عن التابع مصدره هو ذلك التعليق، يمكنك تغيير محتواه كما تريد لتقديم شرح أفضل عن مهام التوابع ومعاملاتها في مشروعك

أو عند كتابتك لاستدعاء لتابع ما يمكنك بعد اكمال كتابة اسم التابع الضغط على Ctrl + Space وسيظهر نفس مربع الشرح