كيف تشغّل ملف PHP في XAMPP؟ الطريقة الصحيحة خطوة بخطوة

لتشغيل ملف PHP في XAMPP لا يكفي أن تنقر عليه نقرًا مزدوجًا؛ يجب أن تضع الملف داخل مجلد htdocs، ثم تشغّل خدمة Apache من لوحة تحكم XAMPP، وأخيرًا تفتحه من المتصفح عبر عنوان يبدأ بـ http://localhost/. السبب بسيط: لغة PHP تُنفَّذ على الخادم، لا في المتصفح مباشرة، ولذلك تحتاج إلى Apache ليقرأ الكود ويحوّله إلى صفحة جاهزة للعرض.

الكثيرون يخلطون بين أمرين مختلفين تمامًا: فتح الملف لتعديل الكود وتشغيل الملف لرؤية النتيجة. في السطور التالية سأشرح الفرق بوضوح، ثم أعطيك الخطوات الدقيقة كما أفعلها فعليًا على جهازي.

لماذا لا يعمل الملف عند النقر عليه مباشرة؟

إذا نقرت نقرًا مزدوجًا على ملف .php، سيحدث أحد أمرين: إمّا يسألك ويندوز عن برنامج لفتحه، أو يفتحه محرّر نصوص ويعرض لك الكود الخام مثل <?php echo "Hello"; ?> بدل النتيجة. وإذا فتحته في المتصفح بطريقة السحب أو عبر مسار مثل file:///C:/... فسترى الكود أو صفحة فارغة.

هذا سلوك طبيعي وليس خطأً. المتصفح يفهم HTML وCSS وJavaScript فقط، أمّا PHP فيحتاج إلى «مترجم» يعمل على الخادم. وهنا يأتي دور Apache الموجود داخل XAMPP: هو من ينفّذ الكود ويرسل الناتج النهائي إلى المتصفح.

الخطوات الصحيحة لتشغيل ملف PHP

1. افتح لوحة تحكم XAMPP (XAMPP Control Panel) واضغط زر Start بجانب Apache. عندما يتحوّل لونه إلى الأخضر يكون الخادم جاهزًا. لست بحاجة لتشغيل MySQL إلا إذا كان مشروعك يستخدم قاعدة بيانات.
2. حدّد مجلد htdocs، وهو مجلد المشاريع الرسمي. مساره الافتراضي على ويندوز: C:\xampp\htdocs، وعلى ماك: /Applications/XAMPP/htdocs.
3. انسخ ملف PHP إلى هذا المجلد، أو الأفضل: أنشئ مجلدًا فرعيًا للمشروع مثل C:\xampp\htdocs\myproject وضع ملفاتك بداخله لتبقى منظمة.
4. افتح المتصفح واكتب العنوان حسب مكان الملف:
   • إذا كان الملف مباشرة في htdocs باسم hello.php، اكتب: http://localhost/hello.php
   • إذا كان داخل مجلد المشروع، اكتب: http://localhost/myproject/hello.php
5. اضغط Enter لتظهر النتيجة المنفّذة، وليس الكود.

نصيحة عملية: إذا فتحت http://localhost/ وحده، سيعرض لك Apache قائمة بمحتويات مجلد htdocs (ما لم يوجد ملف index.php أو index.html)، وهذه طريقة سريعة للتأكد أنّ الخادم يعمل وأنّ ملفك موجود في المكان الصحيح.

أين أفتح الكود للتعديل؟

لتعديل الكود، افتح الملف بمحرّر مخصّص مثل Visual Studio Code أو Notepad++ أو Sublime Text. هذه المحرّرات لا «تشغّل» PHP، لكنها تمنحك تلوين الصياغة وإكمال الكود واكتشاف الأخطاء الإملائية. القاعدة الذهنية: المحرّر للكتابة، والمتصفح عبر localhost للتشغيل.

الهدف	الأداة	الطريقة	النتيجة
تعديل الكود	محرّر نصوص (VS Code…)	فتح الملف مباشرة	ترى الكود لتحرّره
رؤية النتيجة	المتصفح + Apache	http://localhost/…	ترى الصفحة منفّذة
نقر مزدوج على الملف	ويندوز/ماك	خطأ شائع	ترى الكود أو صفحة فارغة

حل أشهر المشكلات

Apache لا يعمل ويظهر خطأ المنفذ 80: غالبًا يستخدم المنفذ برنامج آخر مثل Skype أو خادم IIS أو تطبيق يعتمد على المنفذ نفسه. الحل: أغلق البرنامج المتعارض، أو غيّر منفذ Apache من الإعدادات (Config) إلى منفذ آخر مثل 8080، وحينها يصبح العنوان http://localhost:8080/hello.php.

تظهر صفحة بيضاء فارغة: يعني غالبًا وجود خطأ برمجي في الكود بينما تعطيل عرض الأخطاء مفعّل. راجع الفاصلة المنقوطة ; في نهاية الأسطر والأقواس، أو فعّل عرض الأخطاء لتشخيص المشكلة.

خطأ 404 Not Found: الملف ليس في المسار الذي كتبته. تأكّد أنّ اسم الملف والمجلد مطابقان تمامًا للعنوان (وانتبه لحساسية الأحرف)، وأنّ الامتداد .php وليس .php.txt المخفي الذي يضيفه Notepad أحيانًا.

خطأ 403 Forbidden: غالبًا صلاحيات مجلد أو عدم وجود ملف افتراضي داخله؛ جرّب الوصول إلى ملف محدد بالاسم بدل فتح المجلد وحده.

الأسئلة الشائعة

هل يجب تشغيل MySQL دائمًا؟ لا. شغّل MySQL فقط إذا كان الكود يتصل بقاعدة بيانات. لعرض صفحة PHP بسيطة يكفي Apache.

لماذا يفتح الملف كنص بدل تنفيذه؟ لأنك فتحته بمسار ملف (file:///) أو بالنقر المزدوج، لا عبر http://localhost/. الوصول عبر localhost وحده هو ما يمرّ الطلب على Apache لينفّذ الكود.

هل أستطيع وضع مشاريعي خارج مجلد htdocs؟ نعم، عبر إنشاء «Virtual Host» في إعدادات Apache، لكنه خطوة متقدمة. للبداية، ابقَ داخل htdocs فهو أبسط وأقل عرضة للأخطاء.

نسيت مسار htdocs، كيف أجده؟ في لوحة تحكم XAMPP اضغط زر Explorer، ثم ادخل مجلد htdocs مباشرة؛ هذا يضمن أنك تعمل داخل مجلد التثبيت الصحيح إذا كان لديك أكثر من نسخة.