طريقة كتابة الكود داخل الصفحة والتعليقات

✳️ أولاً: ما معنى Syntax؟

Syntax تعني: قواعد كتابة الكود بشكل صحيح حتى يفهمه مترجم اللغة (PHP Interpreter) ويُنفّذه بدون أخطاء.

إذا كتبت الكود بطريقة خاطئة (مثلاً نسيت فاصلة منقوطة أو كتبت كلمة محجوزة بشكل خاطئ)، ستظهر لك أخطاء تنفيذية (Errors).

1. المفاهيم الأساسية في بناء الجمل البرمجية

PHP هي لغة برمجية مفسرة، مما يعني أن التعليمات تُنفّذ سطرًا بسطر بواسطة الخادم.

وتتطلب كل تعليمة نهاية محددة بالرمز ;.

📌 الشكل الأساسي لكود PHP:
<?php
  // الكود هنا
?>
PHP
✔️ الشرح:
  • <?php ← بداية كود PHP.
  • ?> ← نهاية كود PHP (أحيانًا لا تُكتب إذا كان الملف كلّه PHP فقط).
  • كل كود PHP يجب أن يكون داخل هذا الإطار ليعمل.
❌ خطأ شائع:
echo "Hello"  // نسي الفاصلة المنقوطة
PHP
✔️ الصحيح:
echo "Hello";
PHP
✅ 2. طباعة النصوص – (echo / print)
🧪 مثال:
<?php
  echo "مرحبًا بكم في تعلم PHP!";
  print "هذا نص آخر.";
?>
PHP
✔️ الشرح:
  • echo وprint كلاهما يُستخدمان لعرض النصوص.
  • تضع النص بين علامتي اقتباس مزدوجة أو مفردة (" " أو ' ').
  • يجب إنهاء كل سطر بـ فاصلة منقوطة .
🧾 دمج PHP مع HTML (PHP داخل HTML والعكس)
✅ أولًا: تشغيل PHP داخل صفحة HTML

يمكنك كتابة كود PHP داخل أي ملف HTML باستخدام وسم <?php ?>.

📌 القاعدة:
<?php
  // كود PHP
?>
PHP
🟢 مثال 1: PHP داخل HTML
<!DOCTYPE html>
<html>
  <head>
    <title>مثال PHP مع HTML</title>
  </head>
  <body>
    <h1>أهلاً بك!</h1>
    <p>
      <?php
        echo "اليوم هو " . date("Y-m-d");
      ?>
    </p>
  </body>
</html>
PHP

🔹 في هذا المثال، كود PHP طبع تاريخ اليوم داخل عنصر <p>.

🟢 مثال 2: استخدام متغير PHP داخل HTML
<?php
  $username = "ياسين";
?>
<!DOCTYPE html>
<html>
  <body>
    <h1>مرحبًا <?php echo $username; ?>!</h1>
  </body>
</html>
PHP

📌 النتيجة:
مرحبًا ياسين!

🔄 ثانيًا: HTML داخل PHP

إذا كنت داخل كود PHP وتريد طباعة HTML، ببساطة تكتبه كنص:

<?php
echo "<h1>أهلاً بكم!</h1>";
echo "<p>هذا موقعنا الجديد.</p>";
?>
PHP

ولكن ⚠️ هذا الأسلوب غير مفضل كثيرًا عند كتابة صفحات كبيرة، لأن HTML كثير، والـ echo يصبح غير عملي.

🛠️ الطريقة الأفضل: خلط HTML مع PHP فقط وقت الحاجة

✅ اكتب HTML عادي، وأدرج PHP فقط عندما تحتاج طباعة قيمة أو شرط أو تكرار.

💡 استخدام الشروط داخل HTML
<?php
  $loggedIn = true;
?>
<!DOCTYPE html>
<html>
  <body>
    <?php if($loggedIn): ?>
      <p>أهلاً بك في موقعنا.</p>
    <?php else: ?>
      <p>يرجى تسجيل الدخول.</p>
    <?php endif; ?>
  </body>
</html>
PHP

⏪ هذا يسمى “PHP المختصرة” (Alternative Syntax) وغالبًا تُستخدم مع HTML داخل الشروط والتكرار.

🧠 نصائح مهمة:
النصيحةالتوضيح
✅ احفظ الملف بامتداد .phpحتى لو كان يحتوي HTML فقط
✅ استخدم <?php ?> فقط داخل ملفات PHPولا تكتب PHP في ملف .html
❌ لا تكتب PHP قبل وسم <!DOCTYPE> إلا للعمليات الخاصة (مثل تحويلات أو session)
✅ استخدم echo أو <?= ?> عند الحاجة لطباعة متغيرات داخل HTML
📌 مثال عملي بسيط جداً للمبتدئ:
<?php
$name = "ياسين";
$age = 21;
?>
<!DOCTYPE html>
<html>
<body>
  <h2>معلومات الطالب:</h2>
  <p>الاسم: <?php echo $name; ?></p>
  <p>العمر: <?= $age; ?></p>
</body>
</html>
PHP

🔹 <?= $age ?> اختصار لـ <?php echo $age; ?>

🧨 محاذير:
  • ❌ لا تكتب <?php echo $name ?>; ← النقطة والفاصلة داخل HTML غير مطلوبة.
  • ❌ لا تنسَ إغلاق وسم ?> في نهاية PHP (إلا إذا كان آخر سطر في الملف).
  • ❌ لا تستخدم كود PHP داخل ملفات .html، لأنه لن يُنفذ.
✅ خلاصة:
  • PHP يمكن إدراجها بسهولة داخل HTML.
  • الأفضل استخدام PHP فقط لطباعة البيانات أو الشروط.
  • HTML هو الهيكل، وPHP تضيف الذكاء والتفاعلية.
📝 ما هي التعليقات في PHP؟

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

✅ يفهمه البشر فقط – لا تُنفذه لغة PHP.

✅ أنواع التعليقات في PHP

في PHP يوجد 3 أنواع رئيسية من التعليقات:

1️⃣ تعليق لسطر واحد (Single-line comment)

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

🧪 الشكل:
// هذا تعليق باستخدام //
# هذا تعليق باستخدام #
PHP
✔️ مثال:
<?php
  // هذا السطر يطبع اسم المستخدم
  echo "مرحبا بك";
?>
PHP
2️⃣ تعليق لعدة أسطر (Multi-line comment)

تستخدمه عندما تريد كتابة شرح طويل أو ملاحظات تمتد لأكثر من سطر.

🧪 الشكل:
/*
هذا تعليق طويل
يمكن أن يمتد على أكثر من سطر
لشرح جزء كبير من الكود
*/
PHP
✔️ مثال:
<?php
/*
السطر التالي يطبع رسالة ترحيب
في المستقبل سنجعل الرسالة ديناميكية
*/
echo "أهلاً وسهلاً!";
?>
PHP
⭐ فوائد التعليقات
  1. ✅ توضيح الهدف من الكود
    • تسهّل فهم الكود عند الرجوع إليه لاحقًا.
    • مثال: 
// نطبع اسم الطالب من قاعدة البيانات
PHP
  1. ✅ تنظيم العمل ضمن فريق
    • يفهم باقي المطورين ما الذي كنت تنوي فعله في جزء معين من الكود.
  2. ✅ إخفاء الكود مؤقتًا أثناء التجربة (debugging)
    • مثل تعطيل سطر لاختباره بدون حذفه: 
// echo $password; // لا نريد عرض كلمة السر الآن
PHP
  1. ✅ تذكير نفسك بما يجب فعله لاحقًا
    • يُستخدم كثيرًا مع كلمة 
// TODO: ربط هذه الصفحة بقاعدة البيانات لاحقًا
PHP
🚫 محاذير عند استخدام التعليقات
❗ الخطأ❌ لماذا هو مشكلة؟
كتابة تعليقات غير مفيدةمثل: // هذا متغير ← معلومة معروفة ولا تُضيف شيء.
الإكثار من التعليقات الزائدةتجعل الكود مزدحم وغير مريح للقراءة.
استخدام تعليقات قديمةقد تصبح مضللة إذا تغيّر الكود ولم تُحدّث التعليق.
نسيان حذف تعليقات سريةمثل كلمات مرور أو ملاحظات خاصة بالعميل.
💡 نصائح عند كتابة التعليقات

✅ اجعل التعليق مختصرًا وذو معنى.

✅ علّق فقط عندما يكون الكود غير واضح بذاته.

✅ لا تشرح أشياء واضحة جدًا:

$x = 5; // تعيين x إلى 5 ← ❌ لا داعي لهذا التعليق
PHP

✅ استخدم اللغة العربية أو الإنجليزية حسب جمهورك، لكن كن واضحًا دائمًا.

✅ استخدم علامات واضحة لتحديد المهام المستقبلية:

// FIXME: هذا الكود يعمل بشكل غير صحيح مع الأرقام السالبة
// TODO: تحسين طريقة عرض النتائج
PHP
📌 مقارنة بين الأنواع الثلاثة:
النوعالرمزمتى تستخدمه؟
سطر واحد// أو #للتعليقات القصيرة
عدة أسطر/* ... */لشرح مطول أو عدة أفكار
تعليق كود مؤقتأي نوعلتجربة كود أو تعطيله بدون حذفه