📝 فن كتابة التعليقات في PHP: اجعل كودك يتحدث!

. بعد أن تعلمت كيف تبدأ كتابة أول سطر برمجي لك في PHP، حان الوقت لنتعلم واحدة من أهم المهارات التي تميز المبرمج المحترف عن المبتدئ، وهي التعليقات (Comments).

ما هي التعليقات (Comments)؟ 🤔

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

لماذا نستخدم التعليقات؟

  1. شرح الكود: لتوضيح ماذا يفعل هذا الجزء من الكود.
  2. التنظيم: لتقسيم الكود إلى أقسام واضحة.
  3. التذكير: لكتابة ملاحظات حول أشياء تحتاج لإكمالها لاحقاً.
  4. تعطيل الكود: يمكنك تحويل سطر برمجي إلى تعليق مؤقتاً لتجربة شيء آخر دون حذف الكود.

أنواع التعليقات في لغة PHP 🛠️

توفر لنا لغة PHP ثلاث طرق مختلفة لكتابة التعليقات، وذلك حسب حاجتك (هل تريد كتابة ملاحظة قصيرة أم شرح مفصل؟).

1. التعليقات ذات السطر الواحد (Single-line Comments) ✍️

تُستخدم هذه الطريقة عندما تريد كتابة ملاحظة سريعة في سطر واحد. هناك طريقتان للقيام بذلك:

أ- استخدام الشرطتين المائلتين // : وهي الطريقة الأكثر شيوعاً وبساطة.

<?php
// This is a simple comment (هذا تعليق بسيط باستخدام الشرطتين)
echo "Hello World!"; // This prints a message to the screen (هذا يطبع رسالة على الشاشة)
?>

ب- استخدام علامة الهاشتاج # : تعمل بنفس طريقة // تماماً وتستخدم في بعض لغات البرمجة الأخرى مثل Python.

<?php
# This is also a single-line comment (هذا أيضاً تعليق سطر واحد)
echo "Welcome to Codex Academy!"; 
?>

2. التعليقات متعددة الأسطر (Multi-line Comments) 📚

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

أي شيء يوضع بين هاتين العلامتين يعتبر تعليقاً، حتى لو كان يمتد لعشر صفحات!

<?php
/* 
This is a multi-line comment.
We can use it to explain a complex part of the code.
It can span across many lines.
(هذا تعليق متعدد الأسطر، نستخدمه لشرح الأجزاء المعقدة)
*/
echo "Learning PHP is fun!"; 
?>

💡 نصائح ذهبية لكتابة تعليقات احترافية

لكي تكون مبرمجاً منظماً، اتبع هذه القواعد البسيطة:

  1. لا تشرح الواضح: لا تكتب تعليقاً مثل // This is a variable لأن الكود واضح بالفعل. بدلاً من ذلك، اشرح لماذا فعلت ذلك.
  2. اجعل تعليقاتك محدثة: إذا قمت بتغيير الكود، لا تنسَ تغيير التعليق المرتبط به حتى لا تضلل من يقرأ الكود.
  3. استخدم التعليقات للتنظيم: يمكنك استخدام التعليقات لتقسيم الصفحة، مثل: // --- Start of Header Section ---.

⚠️ تنبيه هام جداً

تذكر دائماً أن التعليقات في PHP يتم حذفها من قبل الخادم قبل أن تصل الصفحة إلى متصفح المستخدم. هذا يعني أن الشخص الذي يزور موقعك لن يرى تعليقاتك البرمجية في "سورس الكود" (View Page Source) الخاص بـ PHP، مما يجعلها وسيلة آمنة لتدوين ملاحظاتك التقنية.

ماذا سنتعلم في الدرس القادم؟ ⏭️

الآن بعد أن تعلمنا كيف نوثق الكود الخاص بنا، سننتقل إلى خطوة أكثر إثارة! في الدرس القادم سنتعرف على "المتغيرات (Variables)"، وكيف نقوم بتخزين البيانات واستدعائها داخل لغة PHP. استعدوا لأننا سنبدأ في بناء منطق برمجي حقيقي! 🌟