كيفية تفعيل وحدة Xdebug المدمجة في ServBay

كأداة تطوير ويب متكاملة قوية، يتضمن ServBay وحدة Xdebug، وعملية تفعيلها سهلة جداً. Xdebug هو أداة لتصحيح وتحليل PHP، يمكنه مساعدة المطورين في تصحيح التعليمات البرمجية، وتحليل الأداء، واختبار معدل التغطية البرمجية، مما يجعله أداة مهمة لتطوير وصيانة تطبيقات PHP.

مقدمة عن وحدة Xdebug

Xdebug هو امتداد PHP قوي يستخدم لتصحيح وتحليل تعليمات PHP البرمجية. إنه يوفر وظائف تصحيح غنية، بما في ذلك تصحيح نقطة التوقف، تتبع المكدس، مراقبة المتغيرات، وغيرها. بالإضافة إلى ذلك، يدعم Xdebug تحليل الأداء واختبار تغطية التعليمات البرمجية، مما يساعد المطورين على تحسين الأداء وضمان جودة التعليمات البرمجية.

الميزات الرئيسية

1. تصحيح نقطة التوقف: يدعم Xdebug تعيين نقاط التوقف في التعليمات البرمجية وتصحيحها سطراً بسطر، مما يسهل اكتشاف الأخطاء وإصلاحها.
2. تتبع المكدس: يمكن لـ Xdebug توليد معلومات تتبع مكدس مفصلة في حالة حدوث خطأ، مما يساعد المطورين على تحديد المشكلات بسرعة.
3. تحليل الأداء: يوفر Xdebug وظيفة تحليل الأداء ويمكنه توليد تقارير مفصلة عن الأداء، مما يساعد المطورين على تحسين الأداء.
4. تغطية التعليمات البرمجية: يدعم Xdebug اختبار تغطية التعليمات البرمجية، مما يساعد المطورين على التأكد من أن الاختبارات تغطي جميع مسارات التعليمات البرمجية.
5. دعم بيئات التطوير المتكاملة: يمكن لـ Xdebug التكامل مع العديد من بيئات التطوير المتكاملة (IDE) مثل PHPStorm وVisual Studio Code، مما يوفر تجربة تصحيح مريحة.

إصدار وحدة Xdebug المدمجة في ServBay

يدعم ServBay عدة إصدارات من PHP، ويشمل كل إصدار وحدة Xdebug الملائمة. الإصدارات المحددة هي:

• PHP 5.6، 7.0، 7.1: Xdebug 2.5.5
• PHP 7.2، 7.3، 7.4: Xdebug 3.1.6
• PHP 8.0، 8.1، 8.2، 8.3: Xdebug 3.3.1
• PHP 8.4: Xdebug 3.4.0-dev

إشارة

كل إصدار من PHP لديه منفذ Xdebug منفصل ومستقل، مرتبط برقم الإصدار، مثل PHP 7.2 منفذ Xdebug هو 39072، منفذ Xdebug لـ PHP 8.3 هو 39083

كيفية تفعيل وحدة Xdebug

بشكل افتراضي، وحدة Xdebug تكون معطلة. خطوات تفعيل وحدة Xdebug بسيطة جداً، فقط تحتاج إلى تعديل ملف الإعداد المزود لكل إصدار من PHP. الخطوات التفصيلية هي كما يلي:

الخطوة الأولى: العثور على ملف الإعداد

أولاً، توجه إلى دليل conf.d للإصدار المناسب من PHP. على سبيل المثال، لتفعيل وحدة Xdebug لـ PHP 8.3، نحتاج إلى تحرير الملف التالي:

/Applications/ServBay/etc/php/8.3/conf.d/xdebug.ini

الخطوة الثانية: تحرير ملف الإعداد

افتح ملف xdebug.ini، وألغِ تعليق السطر التالي:

[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so

الخطوة الثالثة: إعداد معلمات Xdebug

لاستخدام Xdebug بالكامل، يمكنك إعداد بعض المعلمات الشائعة في xdebug.ini، على سبيل المثال:

xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

الخطوة الرابعة: إعادة تشغيل خدمة PHP

من لوحة إدارة خدمة ServBay، أعد تشغيل خدمة PHP المناسبة. على سبيل المثال، أعد تشغيل خدمة PHP 8.3. بعد إعادة التشغيل، ستتمكن وحدة Xdebug من التحميل بنجاح.

التحقق من تحميل وحدة Xdebug بنجاح

يمكنك التحقق من تحميل وحدة Xdebug بنجاح عن طريق إنشاء ملف PHP بسيط. في دليل جذر خادم الويب، أنشئ ملف phpinfo.php بمحتوى كما يلي:

<?php
phpinfo();
?>

قم بزيارة https://servbay.host/phpinfo.php، واستعرض معلومات PHP في الصفحة الناتجة للبحث عن معلومات وحدة Xdebug. إذا وجدت معلومات تخص Xdebug، فهذا يعني أن الوحدة قد تم تحميلها بنجاح.

تهيئة Xdebug في PHPStorm

لاستخدام Xdebug في التصحيح داخل PHPStorm، عليك تنفيذ الخطوات التالية:

الخطوة الأولى: فتح PHPStorm والدخول إلى الإعدادات

1. افتح PHPStorm.
2. انقر على قائمة File، ثم اختر Settings (لـ Windows/Linux) أو Preferences (لـ macOS).

الخطوة الثانية: إعداد مفسر PHP

1. في نافذة الإعدادات، انتقل إلى Languages & Frameworks -> PHP.
2. في قسم CLI Interpreter، انقر على زر ... على اليمين.
3. في النافذة المنبثقة، انقر على زر + لإضافة مفسر PHP جديد، اختر Local.
4. عيّن مسار مفسر PHP لمسار إصدار PHP الموافق في ServBay، على سبيل المثال /Applications/ServBay/package/php/8.3/8.3.7/bin/php.
5. انقر OK لحفظ الإعدادات.

الخطوة الثالثة: إعداد تصحيح Xdebug

إشارة

كل إصدار من PHP لديه منفذ Xdebug منفصل ومستقل، مرتبط برقم الإصدار، مثل PHP 7.2 منفذ Xdebug هو 39072، منفذ Xdebug لـ PHP 8.3 هو 39083

1. في نافذة الإعدادات، انتقل إلى Languages & Frameworks -> PHP -> Debug.
2. في قسم Xdebug، عيّن Debug Port إلى 39083، بما يتناسب مع إعداد xdebug.client_port.
3. تأكد من تفعيل خيار Can accept external connections.
4. انقر على Apply ثم OK لحفظ الإعدادات.

الخطوة الرابعة: إعداد خادم تطبيقات PHP الويب

1. في نافذة الإعدادات، انتقل إلى Languages & Frameworks -> PHP -> Servers.
2. انقر على زر + على اليمين لإضافة إعداد خادم جديد.
3. عيّن اسم الخادم، على سبيل المثال ServBay Localhost.
4. عيّن Host إلى بحسب مضيف ServBay المقابل، على سبيل المثال servbay.new، المنفذ 443 (HTTPS).
5. عيّن Debugger إلى Xdebug.
6. انقر OK لحفظ الإعدادات.

الخطوة الخامسة: بدء جلسة التصحيح

1. في PHPStorm، افتح مشروع PHP الذي ترغب في تصحيحه.
2. عيّن نقطة توقف في التعليمات البرمجية (انقر على المنطقة الفارغة إلى يسار رقم السطر).
3. انقر على زر Start Listening for PHP Debug Connections في شريط الأدوات العلوي في PHPStorm (أيقونة الحشرة الصغيرة).
4. في المتصفح، قم بزيارة تطبيق PHP الخاص بك، سيقوم Xdebug بالاتصال تلقائياً بـ PHPStorm ويتوقف عند نقطة التوقف.

الخاتمة

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