استخدام XDebug لتصحيح مشروع PHP

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

مقدمة عن XDebug

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

تفعيل Xdebug وتكوين بيئة التصحيح

ServBay تأتي مع Xdebug مدمج في كل إصدار من PHP.

::: تحذير ملاحظة يرجى الرجوع إلى المقالة كيفية تفعيل وحدة Xdebug المدمجة في ServBay لمزيد من المعلومات حول كيفية تفعيل وحدة Xdebug وإعداد PHPStorm :::

مثال دقيق للتصحيح

هيكل المشروع النموذجي

لنقم بافتراض وجود مشروع PHP بسيط بهيكل الدليل التالي:

servbay_xdebug_app/
├── src/
│   └── Calculator.php
└── index.php

محتويات ملف Calculator.php هي كالتالي:

<?php
namespace App;

class Calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }

    public function subtract($a, $b)
    {
        return $a - $b;
    }
}

محتويات ملف index.php هي كالتالي:

<?php
require 'vendor/autoload.php';

use App\Calculator;

$calculator = new Calculator();
$sum = $calculator->add(5, 3);
$difference = $calculator->subtract(5, 3);

echo "Sum: " . $sum . "\n";
echo "Difference: " . $difference . "\n";

تعيين نقاط التوقف

نود تصحيح دالة add في فئة Calculator لرؤية كيفية تنفيذها. افتح ملف Calculator.php في PHPStorm وقم بتعيين نقطة توقف عند السطر return $a + $b;.

بدء جلسة التصحيح

1. في PHPStorm، انقر على زر Start Listening for PHP Debug Connections في شريط الأدوات العلوي (رمز الخنفساء).
2. في المتصفح، قم بزيارة تطبيق PHP الخاص بك، مثل https://servbay-xdebug-app.test/index.php.

عملية التصحيح

1. عند زيارة index.php في المتصفح، سيتصل XDebug تلقائيًا بـ PHPStorm، وسيتم إيقاف التنفيذ عند نقطة التوقف المحددة.
2. في PHPStorm، ستجد الكود متوقفًا عند سطر return $a + $b; في دالة add لفئة Calculator.php.

التحقق من قيم المتغيرات

1. في نافذة التصحيح في PHPStorm، يمكنك رؤية السطر الحالي للكود، ومكدس الاستدعاء، وقيم المتغيرات، وغيرها من المعلومات.
2. في لوحة Variables، يمكن رؤية قيمة المتغيرين $a و $b كـ 5 و 3 على التوالي.

تنفيذ خطوة بخطوة

1. انقر على زر Step Over (أو اضغط على F8) لت执行代码 خطوة بخطوة.
2. راقب تغييرات قيم المتغيرات، وتأكد من أن دالة add تعيد النتيجة الصحيحة.

المتابعة في التنفيذ

1. انقر على زر Resume Program (أو اضغط على F9) لمتابعة تنفيذ الكود.
2. سيستمر تشغيل البرنامج حتى يصل إلى نقطة التوقف التالية أو ينتهي التنفيذ.

عرض النتيجة

1. عرض النتيجة في المتصفح، يجب أن تظهر:

   Sum: 8
   Difference: 2

الاستنتاج

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