لا يتم تنفيذ التعليقات باعتبارها جزءًا من الشيفرة البرمجية، وإنما الغرض منها هو أن يقرأها الأشخاص الذين يطّلعون على الشيفرة.
تُستخدم التعليقات في PHP من أجل:
- مساعدة الآخرين على فهم الشيفرة البرمجية.
- تذكير المبرمج بما قام به سابقًا؛ فكثيرًا ما يعود المبرمجون إلى مشاريعهم بعد سنة أو سنتين، ويحتاجون إلى مراجعة الشيفرة لفهم ما أنجزوه.
- تعطيل أجزاء من الشيفرة مؤقتًا، بهدف اختبار البرنامج.
تدعم PHP نوعين من التعليقات:
- التعليقات ذات السطر الواحد (Single-line Comments).
- التعليقات متعددة الأسطر (Multi-line Comments).
// This is a single-line comment
# This is also a single-line comment
/* This is a
multi-line
comment */التعليقات ذات السطر الواحد في PHP
تبدأ التعليقات ذات السطر الواحد بإحدى العلامتين // أو #.
يتم تجاهل أي نص يأتي بعد // أو # إلى نهاية السطر، ولا يُنفَّذ باعتباره جزءًا من الشيفرة البرمجية.
التعليقات متعددة الأسطر في PHP
تبدأ التعليقات متعددة الأسطر بالعلامة /* وتنتهي بالعلامة */.
يتم تجاهل أي نص يقع بين هاتين العلامتين، ولا يُنفَّذ باعتباره جزءًا من الشيفرة البرمجية.
يمكن استخدام صيغة التعليقات لمنع تنفيذ أجزاء محددة من الشيفرة، حتى وإن كانت هذه الأجزاء موجودة داخل سطر برمجي واحد.