درس 00 من 17

إعداد بيئة العمل

XAMPP + VS Code + PHP Extensions — من الصفر

🕐 45-60 دقيقة🔧 5 خطوات عملية💻 إعداد كامل

لماذا نحتاج إلى إعداد البيئة؟

PHP هي لغة تعمل على السيرفر (Server-side) — بمعنى أن الكود لا يُنفَّذ في المتصفح مباشرةً، بل يحتاج إلى خادم ويب يُترجمه أولاً. لذلك علينا إعداد بيئة عمل محلية على جهازنا تحاكي السيرفر الحقيقي.

ما سنثبّته:

XAMPP — حزمة تشمل Apache (خادم الويب) + MySQL (قاعدة البيانات) + PHP
VS Code — المحرر الأقوى مع إضافات PHP
PHP Extensions — إضافات VS Code لتحسين تجربة الكتابة

الخطوة ١ — تثبيت XAMPP

حمّل XAMPP
اذهب إلى apachefriends.org واختر نسخة XAMPP المناسبة لنظام تشغيلك (Windows / macOS / Linux). اختر PHP 8.2 أو أحدث.
ثبّت XAMPP
شغّل المثبّت واختر المكونات: Apache + MySQL + PHP + phpMyAdmin. اترك المسار الافتراضي C:\xampp\ على Windows.
شغّل XAMPP Control Panel
افتح XAMPP Control Panel واضغط Start بجانب Apache ثم MySQL. يجب أن يتحوّل اللون إلى أخضر.
اختبر التثبيت
افتح المتصفح واكتب localhost — يجب أن ترى صفحة XAMPP الترحيبية.
اذهب إلى phpMyAdmin
اكتب في المتصفح localhost/phpmyadmin للوصول إلى واجهة إدارة MySQL.

💡 مسار ملفات المشاريعكل ملفات PHP يجب أن تكون داخل مجلد C:\xampp\htdocs\ (Windows) أو /opt/lampp/htdocs/ (Linux). ثم تصل إليها عبر localhost/اسم-المشروع/

الخطوة ٢ — تثبيت VS Code

حمّل VS Code
اذهب إلى code.visualstudio.com وحمّل النسخة المناسبة لنظامك وثبّتها.
افتح Extensions Panel
اضغط Ctrl+Shift+X أو اضغط على أيقونة المربعات في الشريط الجانبي.
ابحث وثبّت الإضافات الأساسية
ثبّت هذه الإضافات الأربع:

اسم الإضافة	الناشر	الفائدة
PHP Intelephense	Ben Mewburn	⭐ أذكى إضافة PHP — Autocomplete + Errors + Go to Definition
PHP Debug	Xdebug	Debug بصري — توقف عند أي سطر وافحص المتغيرات
PHP DocBlocker	Neil Brayfield	توليد تلقائي للـ Documentation
phpfmt	Druid Software	تنسيق الكود تلقائياً عند الحفظ

الخطوة ٣ — إعداد VS Code لـ PHP

بعد تثبيت PHP Intelephense، يجب إخبار VS Code بمكان PHP على جهازك.

اضغط Ctrl+, لفتح الإعدادات، ثم ابحث عن php.validate.executablePath وأضف المسار الصحيح:

JSON — settings.json

{{
  // مسار PHP على Windows
  "php.validate.executablePath": "C:\\xampp\\php\\php.exe",

  // أو على macOS/Linux
  // "php.validate.executablePath": "/usr/bin/php",

  // إعدادات Intelephense
  "intelephense.environment.phpVersion": "8.2.0",
  "intelephense.files.maxSize": 5000000,

  // تنسيق عند الحفظ
  "editor.formatOnSave": true,
  "[php]": {{
    "editor.defaultFormatter": "bmewburn.vscode-intelephense-client"
  }},

  // حجم الخط وأسلوب الكتابة
  "editor.fontSize": 15,
  "editor.fontFamily": "'JetBrains Mono', 'Courier New', monospace",
  "editor.tabSize": 4,
  "editor.insertSpaces": true
}}

الخطوة ٤ — أول ملف PHP

الآن دعنا نتأكد أن كل شيء يعمل بشكل صحيح.

أنشئ مجلداً باسم my-php-project داخل htdocs
افتح المجلد بـ VS Code: File → Open Folder
أنشئ ملفاً جديداً باسم index.php
اكتب الكود أدناه واحفظ بـ Ctrl+S
افتح المتصفح على localhost/my-php-project/

PHP — index.php

<?php
// أول برنامج PHP لنا
echo "<h1>مرحباً بالعالم! 🐘</h1>";
echo "<p>نسخة PHP: " . phpversion() . "</p>";
echo "<p>نظام التشغيل: " . PHP_OS . "</p>";
echo "<p>التاريخ: " . date("Y-m-d H:i:s") . "</p>";

// معلومات تفصيلية
phpinfo();
?>

الناتج المتوقع

مرحباً بالعالم! 🐘 نسخة PHP: 8.2.0 نظام التشغيل: WINNT التاريخ: 2026-05-18 14:30:00

🎯 نجح الإعداد!إذا رأيت الصفحة تعمل وتعرض معلومات PHP، فبيئة العمل جاهزة تماماً! يمكنك الآن البدء بكتابة PHP.

الخطوة ٥ — إعداد Xdebug (للـ Debugging المتقدم)

Xdebug أداة قوية تتيح لك توقيف تنفيذ البرنامج عند أي سطر وفحص قيم المتغيرات.

خطوات التثبيت على XAMPP:

اذهب إلى xdebug.org/wizard والصق ناتج phpinfo() ليعطيك الـ DLL المناسب
ضع ملف الـ DLL في مجلد C:\xampp\php\ext\
عدّل php.ini وأضف في النهاية:

INI — php.ini

[xdebug]
zend_extension=xdebug
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_port=9003
xdebug.client_host=localhost

⚠️ إعادة تشغيلبعد تعديل php.ini يجب إعادة تشغيل Apache من XAMPP Control Panel حتى تأخذ الإعدادات مفعولها.

🏠 الفهرس

إعداد بيئة العمل

لماذا نحتاج إلى إعداد البيئة؟

الخطوة ١ — تثبيت XAMPP

الخطوة ٢ — تثبيت VS Code

الخطوة ٣ — إعداد VS Code لـ PHP

الخطوة ٤ — أول ملف PHP

الخطوة ٥ — إعداد Xdebug (للـ Debugging المتقدم)

🧪 اختبر فهمك