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

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

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

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

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

1. تصحيح بنقاط التوقف: يدعم Xdebug تعيين نقاط التوقف في الكود لتصحيح الأخطاء خطوة بخطوة بسهولة.
2. تتبع المكدسات: عند حدوث خطأ، يمكن لـ Xdebug إنشاء معلومات تتبع مكدس تفصيلية لمساعدة المطورين في تحديد المشكلة بسرعة.
3. تحليل الأداء: يوفر Xdebug ميزات تحليل الأداء لتوليد تقارير أداء تفصيلية، مما يساعد المطورين على تحسين الأداء.
4. تغطية الكود: يدعم Xdebug اختبار تغطية الكود لضمان أن جميع مسارات الكود مغطاة بالاختبارات.
5. دعم بيئات التطوير المتكاملة: يمكن دمج Xdebug مع العديد من بيئات التطوير المتكاملة مثل 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 خاص به مرتبط برقم الإصدار، على سبيل المثال، منفذ Xdebug لـ PHP 7.2 هو 39072، منفذ Xdebug لـ PHP 8.3 هو 39083

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

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

يمكن للمستخدم أيضًا فتح أو تعديل إعدادات الوحدة يدويًا، فيما يلي الخطوات التفصيلية:

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

أولًا، حدد موقع دليل 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، إذا وجدت معلومات متعلقة بـ 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 إلى الإصدار المناسب في ServBay، مثلًا /Applications/ServBay/package/php/8.3/8.3.7/bin/php.
5. اضغط على OK لحفظ الإعدادات.

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

نصيحة

كل إصدار من PHP له منفذ Xdebug خاص به مرتبط برقم الإصدار، مثلًا منفذ Xdebug لـ PHP 7.2 هو 39072، لـ 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 الذي يتطابق مع host في ServBay، مثلًا servbay.new، والمنفذ 443 (HTTPS).
5. حدد Debugger إلى Xdebug.
6. اضغط على OK لحفظ التكوين.

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

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

الخلاصة

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