البدء

0.2تثبيت بيئة محلية (XAMPP، Laragon)

الهدف: الحصول على بيئة PHP محلية تعمل (خادم ويب + PHP + قاعدة + محرر)، مُتحقق منها عبر phpinfo — جاهزة للكتابة والاختبار دون نشر أي شيء.

الوقت المقدّر: 9 دقيقة · قراءة ذاتية · إذا كان لديك 5 دقائق فقط: اقرأ «الأساسي في 30 ثانية» + المخطط.

الأساسي في 30 ثانية

حزمة شاملة تُثبِّت كل شيء معا : خادم ويب (Apache) + PHP + قاعدة (MySQL) مُعدة مسبقا — XAMPP أو Laragon.
ملفات .php تُوضع في المجلد الجذر : htdocs أو www، وتُفتح عبر http://localhost (جهازك نفسه).
تحقق عبر phpinfo() قبل الترميز : ملف info.php يُفتح عبر localhost يؤكد أن كل شيء يعمل.

حالة مستمرة — رياد يُجهِّز جهازه في قسنطينة

رياد، مطور ويب في قسنطينة، استلم حاسوبا فارغا ويجب أن يبرمج أول موقع PHP دون نشر أي شيء. ثبَّت حزمة شاملة (خادم ويب + PHP + قاعدة مربوطة مسبقا)، وشغَّل Apache وMySQL من لوحة التحكم، وحدَّد المجلد الجذر لوضع ملفات .php، ثم أنشأ ملف اختبار info.php وفتحه عبر localhost. ظهرت صفحة معلومات PHP : بيئته جاهزة. ثبَّت VS Code للتحرير وحدَّد phpMyAdmin لقواعده المستقبلية.

حالة مستقلة لهذا القسم : تعود في الدرس والمخطط والنص الجاهز وتحدي 48 ساعة للقسم 0.2.

1. حزمة شاملة (AMP)

يتطلب التطوير بـ PHP بيئة محلية : ثلاث لبنات يلخصها AMP — خادم ويب (Apache)، ولغة PHP (المفسّر)، وقاعدة بيانات (MySQL / MariaDB). تثبيتها وربطها منفصلة ممل ؛ فالحزم الشاملة تجمعها وتضبطها معا في تثبيت واحد : XAMPP (متعدد الأنظمة : Windows وmacOS وLinux)، وLaragon (لـ Windows، خفيف ومحبوب)، وWampServer (لـ Windows) أو MAMP (لـ macOS/Windows). للبدء، يختار رياد واحدة ويثبتها، فيحصل فورا على خادم + PHP + قاعدة جاهزة — دون لمس إعدادات النظام.

2. المجلد الجذر، وlocalhost، وphpinfo

بعد التثبيت، تُشغَّل الخدمات (Apache وMySQL) عبر لوحة التحكم الخاصة بالحزمة. تُوضع ملفات .php في المجلد الجذر للويب (htdocs لـ XAMPP، وwww لغيرها) وتُفتح عبر http://localhost — حيث تعني localhost جهازك نفسه. للقاعدة، تتضمن الحزم phpMyAdmin، وهي واجهة ويب لإدارة MySQL دون سطر الأوامر. أول رد فعل : إنشاء info.php الذي يحتوي <?php phpinfo(); ?>، ووضعه في الجذر وفتحه عبر localhost/info.php — فإذا ظهرت صفحة معلومات PHP، فكل شيء يعمل (وتقرأ فيها الإصدار المثبت). يتحقق رياد هكذا قبل كتابة أول سطر.

3. المحرر والحذر بين المحلي والإنتاج

من جهة المحرر، يُعد VS Code الخيار المعياري (مجاني، وإضافات PHP ممتازة)، أو PhpStorm (مدفوع، وشامل جدا). نقطة حذر : المحلي للتطوير والاختبار ؛ أما الإنتاج (النشر، القسم 5-4) فمرحلة أخرى — يجب أن تتطابق إصدارات PHP/MySQL بينهما قدر الإمكان لتجنب « يعمل محليا ولا يعمل على الإنترنت » الكلاسيكية، تماما مثل حالة أحرف أسماء الملفات (Windows يتجاهلها، وLinux يحترمها). يُدوِّن رياد الإصدارات التي يعرضها phpinfo لمقارنتها لاحقا مع استضافته.

خطأ شائع في الفهم: « تثبيت اللبنات الثلاث منفصلة أكثر جدية — والمحلي سيطابق الإنتاج حتما ». لا، فخان. للبدء، التثبيت المنفصل معقد ومصدر أخطاء (إعدادات تُربط ومنافذ وإصدارات) : الحزمة الشاملة المُعدة مسبقا تضعك في ظروف العمل في دقائق، وهي نقطة البدء الصحيحة. والمحلي ليس مطابقا أبدا حتما للإنتاج : الإصدارات والإضافات ونظام التشغيل وحالة أحرف الملفات قد تختلف — ومن هنا الممارسات الجيدة (مواءمة الإصدارات، والدقة في حالة الأحرف، وإزالة info.php الذي يكشف الإعدادات).

حزمة AMP : ثلاث لبنات مُعدة مسبقا، تُتحقق عبر phpinfo().

نص المخطط (SEO / قارئات الشاشة / الترجمة): 1) رياد، مطور ويب في قسنطينة، يُثبِّت حزمة شاملة : خادم ويب وPHP وقاعدة مربوطة مسبقا، جاهزة في دقائق. 2) يُشغِّل الخدمات، ويضع info.php في المجلد الجذر ويفتحه عبر localhost : تظهر صفحة phpinfo، فالبيئة تعمل. 3) يُحرِّر بـ VS Code ويُدير قواعده عبر phpMyAdmin. الدرس : حزمة مُتحقق منها محليا للتطوير ؛ وإصدارات مواءمة مع الإنتاج لتجنب المفاجآت.

🔎 مثال ملموس — 🔎 مثال ملموس — التحقق من التثبيت

ملف الاختبار.


القراءة : يفتح رياد localhost/info.php ويرى صفحة معلومات PHP : الخادم يُنفِّذ كوده فعلا.

الدرس : بيئة جاهزة للترميز محليا — ثم نُزيل info.php لأنه يكشف الإعدادات.


      
 مفردات القسم

          البيئة المحلية (AMP)
ما يلزم لتشغيل PHP وقاعدة على جهازك للتطوير والاختبار. AMP = خادم ويب (Apache) وPHP وقاعدة (MySQL) — وغالبا تُثبَّت معا عبر حزمة.
            مثال بسيط: يُطوِّر رياد أول موقع كاملا في قسنطينة دون نشر أي شيء.
            ما ليس كذلك: خادم الإنتاج المتاح للزوار.
            رد فعل: برمج واختبر محليا أولا، ثم انشر بعدها.
          حزمة شاملة
تثبيت يجمع خادم الويب + PHP + قاعدة البيانات : XAMPP (متعدد الأنظمة) وLaragon وWampServer (لـ Windows) وMAMP (لـ macOS) — الأسهل للبدء.
            مثال بسيط: يُثبِّت رياد حزمة فيحصل على Apache وPHP وMySQL مربوطة مسبقا.
            ما ليس كذلك: ثلاثة تثبيتات منفصلة تُضبط وتُربط يدويا.
            رد فعل: ابدأ بحزمة، وانتقل إلى التفصيل فقط عند الحاجة.
          المجلد الجذر للويب / localhost
المجلد الذي تُوضع فيه ملفات .php (مثل htdocs وwww) لتُقدَّم ؛ ويُفتح عبر http://localhost (جهازك نفسه).
            مثال بسيط: يضع رياد bonjour.php في htdocs ويفتحه عبر localhost/bonjour.php.
            ما ليس كذلك: أي مجلد يُفتح بالنقر المزدوج دون خادم.
            رد فعل: ملف PHP = دائما في الجذر، ودائما عبر localhost.
          phpMyAdmin
واجهة ويب (مضمنة في الحزم) لإنشاء قواعد بيانات MySQL وإدارتها دون سطر الأوامر.
            مثال بسيط: يُنشئ رياد أول قاعدة ببضع نقرات، دون حفظ SQL عن ظهر قلب.
            ما ليس كذلك: محرر كود أو لغة برمجة.
            رد فعل: استكشف جداولك عبر phpMyAdmin قبل كتابة الاستعلامات.
          phpinfo()
دالة تعرض معلومات إعدادات PHP ؛ ملف info.php الذي يحتوي phpinfo() يتحقق من عمل البيئة ويُظهر الإصدار المثبت.
            مثال بسيط: يقرأ رياد إصدار PHP على صفحة info.php ويُدوِّنه لإنتاجه المستقبلي.
            ما ليس كذلك: دالة تُصلح التثبيت.
            رد فعل: تحقق عبر phpinfo، ودوِّن الإصدار، ثم أزِل الملف.
        

      
 في التطبيق — عمليا — ثبِّت بيئة PHP وتحقق منها

ثبِّت حزمة شاملة (XAMPP أو Laragon) تجمع خادم الويب (Apache) + PHP + القاعدة (MySQL).
شغِّل الخدمات (Apache وMySQL) عبر لوحة التحكم وحدِّد المجلد الجذر للويب (htdocs / www).
تحقق من التثبيت : أنشئ ملف info.php يحتوي phpinfo()، وافتح localhost/info.php — يجب أن تظهر صفحة معلومات PHP (مع الإصدار).
ثبِّت VS Code (مع إضافات PHP) كمحرر، وحدِّد phpMyAdmin لإدارة قواعد MySQL.

 لديك بيئة PHP محلية تعمل (خادم ويب + PHP + قاعدة + محرر)، مُتحقق منها عبر phpinfo — جاهزة لكتابة PHP وتنفيذها واختبارها دون نشر أي شيء.

      
        نص جاهز — أعلِن جهازك جاهزا (30 ثانية)
        « الجهاز جاهز : الحزمة مثبتة، وApache وMySQL يعملان، وملفاتي في المجلد الجذر وlocalhost/info.php يعرض صفحة PHP فعلا. أُحرِّر بـ VS Code وأُدير قواعدي بـ phpMyAdmin — أستطيع البرمجة محليا. »
        يُقال مع عرض صفحة phpinfo المعروضة في المتصفح عبر localhost.
      
      
        قالب جاهز للنسخ — تحقق من جهاز PHP
        ";
echo "إصدار PHP : " . PHP_VERSION;
      
      
        جهاز Windows
على Windows : اختر XAMPP (متعدد الأنظمة) أو Laragon (خفيف) ؛ وبعد التثبيت، شغِّل Apache وMySQL من لوحة التحكم قبل أي اختبار.
        جهاز macOS
على macOS : يناسب XAMPP أو MAMP ؛ وحدِّد المجلد الجذر الخاص بحزمتك وتحقق دائما عبر localhost/info.php.
        قاعة مشتركة في قسنطينة
يُدوِّن رياد إصدار PHP الذي يعرضه phpinfo على بطاقة الجهاز المشترك : يتحقق كل واحد من الخدمات المشغلة عند الوصول، دون إعادة تثبيت عشوائية.
        استدراك منفذ مشغول
صفحة localhost لا تُفتح : تحقق من تشغيل Apache ومن عدم شغل برنامج آخر لمنفذه، ثم أعد تحميل info.php قبل لمس الكود.
      
      
      
      
✓ ممارسات جيدة
اختر حزمة (XAMPP أو Laragon) بدلا من تثبيت اللبنات منفصلة.
تحقق عبر phpinfo() قبل الترميز، ثم أزِل info.php.
وائِم إصدار PHP/MySQL المحلي مع إصدار الإنتاج.
✗ أخطاء شائعة
تثبيت اللبنات الثلاث منفصلة في البداية (معقد ومصدر أخطاء).
ترك info.php على الإنترنت (يكشف الإعدادات).
تجاهل حالة أحرف الملفات (Windows يتجاهلها، وLinux يحترمها).

      
 النقاط الأساسية
يتطلب التطوير بـ PHP بيئة محلية : خادم ويب (Apache) + PHP + قاعدة (MySQL) = « AMP »، تُثبَّت معا عبر حزمة (XAMPP وLaragon وWampServer وMAMP).
ضع ملفات .php في المجلد الجذر (htdocs / www) ؛ وافتحها عبر http://localhost (جهازك نفسه). يُدير phpMyAdmin قواعد MySQL.
تحقق من التثبيت : ملف info.php يحتوي `phpinfo()` ويُفتح عبر localhost/info.php فيعرض معلومات PHP (والإصدار) إذا كان كل شيء يعمل.
المحرر : VS Code (مجاني، إضافات PHP) أو PhpStorm. البيئة المحلية للتطوير/الاختبار ؛ والإنتاج (النشر) مرحلة أخرى (5-4) — وائِم الإصدارات.

      تحدي 48 ساعة — طبِّق غدا
أنشئ info.php في مجلدك الجذر، وافتحه عبر localhost/info.php، ودوِّن إصدار PHP المعروض، ثم أزِل الملف.
      قائمة الخروج من القسمحزمتي تعرض صفحة phpinfo عبر localhost/info.php (الإصدار مُدوَّن).
حدَّدت المجلد الجذر وشغَّلت Apache وMySQL.
VS Code مثبت وphpMyAdmin مُحدَّد — ثم info.php مُزال.
        تقييم ذاتي 1-5 : هل أتحقق عبر phpinfo قبل الترميز؟تقييم ذاتي 1-5 : هل أزلت info.php بعد التحقق؟
      
      ← السابق : ما هي PHP؟ ودورها (V3)التالي : الصياغة الأساسية : الوسوم، echo، التعليقات (V3) →
      
 أسئلة شائعة
لماذا نُثبِّت حزمة شاملة بدلا من PHP وApache وMySQL منفصلة؟
يحتاج موقع PHP الديناميكي ثلاث لبنات تعمل معا : خادم ويب يستلم الطلبات، ومفسّر PHP يُنفِّذ الكود، وقاعدة MySQL. يجب تثبيتها وضبطها وخاصة ربطها ببعضها. التثبيت المنفصل ممكن لكنه معقد للمبتدئ : كل برنامج يُضبَط ويُربَط بالآخرين، مع إدارة الإصدارات والمنافذ — ممل ومثبط. الحزمة الشاملة (XAMPP متعدد الأنظمة، وLaragon الخفيف على Windows، وWampServer وMAMP) تجمع اللبنات الثلاث وأدوات (phpMyAdmin) في تثبيت واحد مُعد مسبقا يعمل فيه كل شيء منذ البداية : بضع نقرات، ولوحة تحكم بسيطة، وجاهزية في دقائق. التثبيت المنفصل يمنح تحكما أكبر لكنه للاحتياجات المتقدمة والإنتاج. للبدء : حزمة وتحقق واحد (phpinfo)، وتبدأ الترميز.
هل أقلق من الفرق بين بيئتي المحلية والإنتاج؟
نعم، إنه موضوع حقيقي — مصدر « يعمل محليا ولا يعمل على الإنترنت » الكلاسيكية — لكن للبدء يكفي الوعي به. قد تختلف المحلية والإنتاج : إصدارات PHP/MySQL، والإضافات المفعلة، ونظام التشغيل (Windows محليا، وغالبا Linux في الإنتاج)، وخاصة حالة أحرف أسماء الملفات (Windows يتجاهلها، وLinux يحترمها — فملف يعمل محليا قد يفشل على الإنترنت). ممارسات جيدة : (1) مواءمة إصدارات PHP/MySQL مع إصدارات استضافتك ؛ (2) الدقة في حالة الأحرف لأسماء الملفات ؛ (3) عدم الاعتماد على إعدادات محلية خاصة ؛ (4) فصل الإعدادات (المعرفات والمفاتيح) عن الكود. الجواب الحديث هو Docker (القسم 5.3) ؛ والإتقان الدقيق يأتي مع النشر (5.4).

      
 تحقّق من فهمك
كيف تتحقق من عمل بيئة PHP محلية؟






 الحزمة الشاملة (XAMPP/Laragon) تجمع الخادم + PHP + القاعدة.

      موارد إضافية (اختياري، للتعمّق أكثر)

  📘
  XAMPP (الموقع الرسمي)
apachefriends.orgAR

  
  تثبيت XAMPP / Laragon لـ PHP
YouTubeAR

      اختبار المستوى 0أسئلة جديدة وأصعب للتحقق من مكتسباتك