أول صفحة PHP

١جهّز بيئة العمل: XAMPP

لتشغيل PHP على جهازك تحتاج ثلاثة أشياء: خادم ويب يستقبل الطلبات، ومفسّر PHP يشغّل الكود، وقاعدة بيانات. حزمة XAMPP المجانية تجمعها كلها: Apache و PHP و MySQL (اسمها الحديث MariaDB).

1. نزّل XAMPP من موقعه الرسمي apachefriends.org وثبّته في المسار المقترح C:\xampp.
2. افتح XAMPP Control Panel واضغط Start بجانب Apache. حين يصير لونه أخضر فالخادم يعمل.
3. افتح المجلد C:\xampp\htdocs: هذا جذر موقعك. أنشئ فيه مجلدًا باسم 132.
4. أنشئ في VS Code ملفًا باسم hello.php داخل المجلد 132.
5. افتح المتصفح على http://localhost/132/hello.php.

localhost اسم يعني «هذا الجهاز نفسه». فجهازك يلعب الدورين: المتصفح عميل، و XAMPP خادم. وفي هذا المقرر تستطيع أيضًا التجربة مباشرة في مختبر الخادم داخل الصفحة.

٢وسم PHP و echo

كود PHP يُكتب بين الوسمين <?php و ?>. والأمر echo يطبع نصًّا في الاستجابة، أي يضيفه إلى الصفحة التي ستصل للمتصفح:

<?phpecho "<h1>مرحبًا بك في مقرر الواجهات الخلفية</h1>";echo "<p>هذه أول صفحة يبنيها الخادم.</p>";// هذا تعليق لا يُرسل للمتصفح# وهذا تعليق أيضًا

• كل أمر ينتهي بفاصلة منقوطة ;. نسيانها أشهر خطأ عند المبتدئين.
• التعليق: // أو # لسطر واحد، و /* … */ لعدة أسطر.
• إن كان الملف كله PHP فلا تكتب ?> في آخره؛ هذا أسلم ويمنع إرسال مسافات زائدة بالخطأ.

لاحظ في الناتج أعلاه: 🖥 الصفحة هي ما يعرضه المتصفح، و📄 المصدر هو النص الذي أرسله الخادم فعلًا. كل echo أضاف قطعة إلى المصدر.

٣المتغيرات

المتغير في PHP يبدأ دائمًا بعلامة الدولار $، ولا تحتاج إعلان نوعه؛ يُحدَّد من القيمة:

<?php$name = "سعود";      // نص string$age = 20;           // عدد صحيح int$gpa = 4.75;         // عدد عشري float$active = true;      // منطقي bool var_dump($name, $age, $gpa, $active);

الدالة var_dump تطبع نوع القيمة وقيمتها، وهي أداة ممتازة لاكتشاف الأخطاء. لاحظ أن string(8) تعني 8 بايتات، لأن الحرف العربي يأخذ بايتين.

٤دمج النصوص: النقطة لا علامة الجمع

في JavaScript وبايثون تدمج النصوص بعلامة +. أما في PHP فالدمج بـالنقطة . ، وعلامة + للأعداد فقط:

<?php$n = 5;echo "عدد الطلبات: " + $n;

<?php$n = 5;echo "عدد الطلبات: " . $n;

الخطأ قاتل Fatal error: توقف البرنامج ورد الخادم بالرمز 500. لاحظ أن المختبر يشرح لك الخطأ بالعربية تحت الاستجابة.

وللإضافة إلى نص موجود استخدم .= ، وهي مفيدة لبناء صفحة على مراحل:

<?php$html = "<ul>";$html .= "<li>قهوة</li>";$html .= "<li>شاي</li>";$html .= "</ul>";echo $html;

٥علامة التنصيص المزدوجة والمفردة

داخل علامتي التنصيص المزدوجتين "…" يستبدل PHP المتغيرات بقيمها. أما المفردتان '…' فتطبعان النص حرفيًّا:

<?php$city = "المدينة المنورة";echo "أسكن في $city\n";echo 'أسكن في $city\n';echo "\n";echo "حيّاكم يا أهل {$city}، مرحبًا بكم\n";

• في المفردتين لا تُستبدل المتغيرات، ولا يعمل \n (سطر جديد).
• إن جاء بعد المتغير مباشرة حرف عربي أو فاصلة عربية «،» فسيظنّه PHP جزءًا من اسم المتغير! ضع المتغير بين قوسين معقوفين: "{{$city}}،".
• السطر الجديد \n يظهر في المصدر فقط. المتصفح يتجاهله في HTML، فاستخدم <br> أو <p> لتنزل سطرًا في الصفحة.

<?php$city = "جدة";echo "حيّاكم يا أهل $city، مرحبًا";

<?php$city = "جدة";echo "حيّاكم يا أهل {$city}، مرحبًا";

في الخطأ ظن PHP أن اسم المتغير $city، (مع الفاصلة العربية)، فلم يجده. هذا فخ خاص بمن يكتب بالعربية!

٦PHP داخل صفحة HTML

قوة PHP أنه يندمج مع HTML: تكتب الصفحة كعادتك، وتفتح وسم PHP فقط حيث تريد قيمة متغيرة. والاختصار <?= $x ?> يعني <?php echo $x; ?>:

<?php$title = "دورة تطوير الويب";$trainer = "م. سعود الحربي";$seats = 12;?><!DOCTYPE html><html lang="ar" dir="rtl"><head><meta charset="UTF-8"><title><?= $title ?></title></head><body style="font-family:Tahoma">  <h1><?= $title ?></h1>  <p>المدرّب: <b><?= $trainer ?></b></p>  <p>المقاعد المتبقية: <?= $seats ?></p></body></html>

الجزء الأول يجهّز البيانات، والجزء الثاني قالب HTML يعرضها. هذا الفصل بين «البيانات» و«العرض» عادة ممتازة؛ ولاحقًا ستأتي البيانات من قاعدة البيانات بدل أن نكتبها بأيدينا.

٧حين يخطئ الكود

في بيئة التطوير نجعل PHP يعرض أخطاءه في الصفحة نفسها (الإعداد display_errors)، فتعرف السطر ونوع الخطأ. جرّب هذا الكود الذي نسي فاصلة منقوطة:

<?php$name = "نورة"echo "مرحبًا يا $name";

رسالة PHP تقول إن الخطأ في السطر 3، بينما الفاصلة الناقصة في نهاية السطر 2. هذا طبيعي: PHP لا يكتشف النقص إلا حين يصل إلى ما بعده. فإن ظهر لك خطأ صياغة، راجع السطر المذكور والسطر الذي قبله.