Xdebug هي أداة قوية لتصحيح أخطاء PHP وتحليل ملفات التعريف التي تساعدنا على تحليل تطبيقات PHP وتحسينها. وهو يدعم ميزات مثل تصحيح الأخطاء خطوة بخطوة وقياس الأداء وتتبع المكدس، مما يجعل استكشاف الأخطاء وإصلاحها أسهل بكثير ويوفر رؤى أفضل حول التعليمات البرمجية. يوجد أدناه دليل إعداد صغير للاستخدام داخل VSCode.
قم بتثبيت برنامج Xdebug
على سبيل المثال، قمنا بتثبيت Xdebug على نظام Ubuntu الحالي:
sudo apt-get install -y php8.4-xdebugوأخيرًا، نقوم بإنشاء دليل مؤقت لتخزين بيانات التوصيف والتتبع لاحقًا:
mkdir -p /tmp/xdebugتكوين Xdebug
بعد التثبيت، نقوم بتكوين Xdebug. للقيام بذلك، نقوم بتحريره ar/php.ini:
vi /etc/php/8.4/fpm/conf.d/custom.ini
ما يلي هو التكوين الأساسي المعقول:
[xdebug]
; mode (see: https://xdebug.org/docs/all_settings#mode)
; reasonable default
xdebug.mode=debug,profile
; disabled
;xdebug.mode=off
; step debugging
;xdebug.mode=debug
; performance profiling (be aware of load/space)
;xdebug.mode=profile
; trace profiling (record args)
;xdebug.mode=trace
; starting mode
; always (not recommended)
;xdebug.start_with_request=yes
; only when specific get parameters / cookies are set
; (?XDEBUG_TRIGGER=1, ?XDEBUG_PROFILE=1, ?XDEBUG_TRACE=1, ?XDEBUG_SESSION=1)
; this is best in conjunction with Chrome extension "Xdebug helper"
xdebug.start_with_request=trigger
; folder for analyzing profile dumps
xdebug.output_dir="/tmp/xdebug"
; not needed, since it is already in /etc/php/8.4/fpm/conf.d/20-xdebug.ini
;zend_extension=xdebug.soبعد إجراء هذه التعديلات، نقوم بإعادة تشغيل PHP-FPM لتطبيق التغييرات:
sudo service php8.4-fpm restart
تكوين VSCode
لاستخدام Xdebug في Visual Studio Code، يلزم وجود ملحقين وتعديل التكوين. نقوم بتثبيت هذا:
- تصحيح PHP: لوظيفة التصحيح الأساسية.
- PHP ملف التعريف: لتحليل ملفات ذاكرة التخزين المؤقت.
أخيرًا، نقوم بإنشاء ملف التكوين Launch.json في المجلد .vscode الخاص بالمشروع المراد تحليله:
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"ignore": ["**/vendor/**/*.php"]
}
]
}قم بتثبيت ملحق كروم
لقد أثبت ملحق Xdebug المساعد نفسه في مجال تصحيح الأخطاء المرن في المتصفح. وهذا يجعل من الممكن تمكين أو تعطيل Xdebug فقط عند الضرورة. يمكنك أيضًا تغيير وضع التصحيح بسهولة (على سبيل المثال، للتبديل من تصحيح الأخطاء إلى التوصيف):
تكوين ووردبريس
عند استخدام Xdebug في بيئة WordPress، قد يكون من المفيد تعطيل تصحيح الأخطاء ضمن مهام cron عندما تكون جلسة تصحيح الأخطاء نشطة. وهذا يجعل طلبات التصحيح أسهل. للقيام بذلك، أضف السطر التالي إلى: wp-config.php أ:
// disable wp cron on xdebug sessions
if (function_exists('xdebug_is_debugger_active') && xdebug_is_debugger_active()) {
define('DISABLE_WP_CRON', true);
}باستخدام هذا التكوين، لدينا إعداد قوي يسمح لنا بمعالجة مشكلات تصحيح الأخطاء المعقدة بدقة. سواء أكان العثور على أخطاء مستعصية أو مشاكل في الضبط الدقيق للأداء - فإن Xdebug لا يجعل العمل أكثر كفاءة فحسب، بل يقدم أيضًا جودة جديدة للتطوير من خلال التحكم والوضوح في التعليمات البرمجية.