الدرس السادس: التعليقات في PHP

بسم الله الرحمن الرحيم،

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

<?php
echo "PHPitc.blogspot.com";
?>

يممكنا إضافة تعليق قبل سطر الطباعة لشرح ما يقوم هذا السطر بعمله، فمثلاً يمكننا إضافة تلك الجملة: This line prints the site URL، والهدف الأصلي من وضع تلك التعليقات بالنسبة للمبرمجين هى شرح شيفرات برامجهم، لأن كثيرًا ما ينقطع المبرمجين عن حواسيبهم، وعند رجوعهم إلى برامجهم مرة أخري لإستكمالها، لن يستطيع المبرمج فهم شيفرات برامجه بسهولة، أما مع التعليقات يمكنه فهم برنامجه بسرعة وبسهولة كبيرتين حتى يتسنّى له إستكمال كتابة شيفرات برنامجه أو تطويره.
أو مثلاً إذا قمت بكتابة برنامج مفتوح المصدر، وقمت بنشره على الإنترنت وهو قابل لتتطوير، كيف سيفهم تلك الشيفرات مطوّر أو مبرمج آخر إذا لم تكن قد كتبت فى برنامجك تعليقات تشرحه؟! ، فمن هذا المنطلق يستخدم المبرمجون التعليقات فى كافة لغات البرمجة.
- أنواع التعليقات.
التعليقات فى لغة PHP أو فى معظم لغات البرمجة نوعان، على غرار بعض اللغات التى تعليقاتها من نوع واحد. أما النوع الأول: فهو التعليقات ذو السطر الواحد، والنوع الثاني: التعليقات متعددة الأسطر.
- كيفية كتابة التعليقات.
النوع الأول توجد له طريقتين لكتابته.
الطريقة الأولي: عبر وضع // ومن ثم سيتحول هذا الجزء المتبقى من هذا السطر كله إلى تعليق لا يتلفت له مفسر اللغة، أى أنه يمكن كتابة  // فى أول السطر وسيتم تحول السطر كله إلى تعليق لا يلتفت له المفسر، أو يمكن كتابة سطر برمجة وفي نهايته يمكنك كتابة // ومن ثم سيتحول باقي السطر إلى تعليق، أى أن السطر في تلك الحالة سيتم إقتسامه إلى نصفين، النصف الأول وهو التعليمة البرمجة التى سيتم تنفذها وباقي السطر سيكون عبارة عن تعليق لا يتلفت له المفسر، أو أن المفسر عندما يتلاقى مع // يقفز إلى السطر الذي يليه لتنفيذه، سواءًا كانت تلك العلامة // فى بداية سطر أو فى نصفه، المهم انه عندما يتلاقي مع تلك العلامة يقوم بالقفز إلى السطر الذي يليه، وكل ما ينطبق على علامة // ينطبق على علامة # أيضًا وهى الطريقة الثانية، أمثلة على التعليقات من الطريقة الأولى.

<?php
//This line prints my name
echo "Ahmed Essam";
?>

في تلك الشيفرة سيتم تنفيذ أمر الطباعة بدون أى مشاكل، وبدون أن يلتفت للسطر الذي يعلوه، لأن المفسر وجد علامة // فعندها يقفز إلى السطر الذي يليه ويقوم بتنفيذه وهو أمر الطباعة.

<?php
//This line prints my name
echo "Ahmed Essam"; //This is my name
?>

وفي تلك الشيفرة أيضًا سيتم تنفيذ أمر الطباعة، فما فعله المفسر هو أنه وصل إلى // في السطر الثاني فقام بالقفز إلى السطر الذي يليه، فقام بتنفيذ أمر الطباعة حتى وصل إلى علامة // فقام بالقفز إلى السطر الذي يليه.
أما الطريقة الثانية للنوع الأول: فهو إستبدال علامة // بعلامة الـHash تلك ( # )، وكمثال بسيط.

<?php
#This line prints my name
echo "Ahmed Essam"; #This is my name
?>

النوع الثاني توجد له طريقة واحدة لكتابته.
تلك الطريقة هي عن طريق كتابة:

/*

ثم التعليق ثم إنهاء التعليق عبر كتابة:
*/
، وكمثال بسيط على تلك الطريقة وهذا النوع.

<?php
/* This is a comment
This line below prints my name */
echo "Ahmed Essam";
?>

ففي تلك الشيفرة يقوم المفسّر بالمضي قدمًا مع الشيفرة حتى يصل على تلك العلامة:

/*

ثم يتجاهل كل ما هو أمامه حتى لو كان أمامه مئات السطور، حتى يصل إلى تلك العلامة

*/

فيقوم بعدها إلى نشاطه مرة أخري ويقوم بعمله فى تفسير التعليمات البرمجية في باقي الشيفرة.

المزيد من المواضيع:

---