التعليقات فى php

التعليقات على الأكواد في بي اتش بي PHP Comments تعد من أهم أدوات المبرمج، فلابد من وضع الملاحظات على الأكواد لتسهيل عملية مراجعة الأكواد سواء من قبل المبرمج نفسه أو من سيقوم بقراءة الكود من بعده. وهذه التعليقات لن تظهر لمستخدمي التطبيق على عكس تعليقات اتش تي ام ال HTML Comments

تعليق السطر الواحد

فأحياناً يكون التعليق مجرد ملحوظة صغيرة لن تحتاج أكثر من سطر واحد، فيتم كتابة التعليق باستخدام علامة // أو #، فيقوم مُنفذ PHP بتجاهل هذا الكود.

<?php>
//This is a simple echo
 echo 'Hi there';
 //echo 'Hello friends';
 #echo 'Hello friends'
?>

ففي الكود السابق لن يتم طباعة سوى السطر رقم 3 أما جملة echo في السطر رقم 4 , 5 لن يتم تنفيذها لأنها مجرد تعليق.

التعليق متعدد الأسطر

لكن أحياناً تحتاج لإضافة تفاصيل أكثر في أكثر من سطر، بحيث تم وضع مجموعة الأسطر داخل علامة /**/، فمثلاً هذا تعليق متعدد الأسطر من قالب ووردبريس

فجميع هذه الأسطر لن يتم تنفيذها ولكن هي مجرد مجموعة معلومات مفيدة.

أهمية التعليقات في البرمجة

لنتخيل أنك قمت ببرمجة موقع إلكتروني لأحد العملاء، ثم بعد فترة كبيرة طُلب منك دعماً فنياً لهذا الموقع، فهل ستتذكر فيما كنت تفكر تحديداً في هذا الوقت، أو ربما هذا الشخص لديه بعض المعلومات التي يستطيع من خلالها حل مشكلته ولكن لايعرف ميكانيكية عمل الكود فلايصل للحل إلا بعد معاناه أو قد لايصل، لذا لابد من وضع علامات إرشادية دائماً على الطريق لتسهيل الوصول للهدف.