ServBay में XDebug के साथ PHP प्रोजेक्ट डिबग करें

XDebug PHP डेवेलपर्स के लिए एक शक्तिशाली डिबगिंग, परफॉर्मेंस एनालिसिस और कोड कवरेज टूल है। ServBay लोकल डेवेलपमेंट एनवायरनमेंट में XDebug का इंटीग्रेशन PHP प्रोजेक्ट्स की डेवलपमेंट एफिशिएंसी और कोड क्वालिटी को खासा बढ़ाता है। XDebug के ज़रिए, डेवलपर ब्रेकपॉइंट सेट कर सकते हैं, वेरिएबल्स के वैल्यू चेक कर सकते हैं, फंक्शन कॉल स्टैक ट्रेस कर सकते हैं और परफॉर्मेंस बॉटलनेक का विश्लेषण कर सकते हैं—जिससे समस्याओं का समाधान कहीं अधिक तेजी से संभव होता है।

XDebug क्या है?

XDebug, PHP के लिए बनाया गया एक एक्सटेंशन है जो जबरदस्त डिबगिंग और विश्लेषण फीचर्स प्रदान करता है। इसमें रिमोट डिबगिंग (अक्सर DBGp प्रोटोकॉल के तहत), ब्रेकपॉइंट सेटिंग, स्टेप-बाय-स्टेप एग्जीक्यूशन, वेरिएबल्स चेकिंग, फंक्शन कॉल स्टैक ट्रेसिंग, स्क्रिप्ट परफॉर्मेंस प्रोफाइलिंग, और कोड कवरेज रिपोर्ट जेनरेट करने जैसी क्षमताएं होती हैं। XDebug की मदद से डेवलपर्स कोड के एक्जीक्यूशन फ्लो और उसकी स्थिति की गहराई से समझ पा सकते हैं और समस्याओं की पुष्टि व समाधान ज़्यादा जल्दी कर पाते हैं।

XDebug के कई ऑपरेटिंग मोड्स होते हैं, जिनमें सबसे आम 'debug' मोड है, जिसका इस्तेमाल इंटरैक्टिव ब्रेकपॉइंट डिबग के लिए होता है।

ServBay में XDebug इनेबल और सेटअप करें

ServBay में हर सपोर्टेड PHP वर्शन के लिए XDebug पहले से ही शामिल रहता है—आपको इसे मैन्युअली डाउनलोड या कंपाइल करने की ज़रूरत नहीं।

XDebug मॉड्यूल इनेबल करें: ServBay ऐप ओपन करें। 'भाषा' → 'PHP' सेक्शन में जाएं और जिस PHP वर्शन के साथ XDebug इस्तेमाल करना है, उसे चुनें। 'एक्सटेंशन' में 'xdebug' मॉड्यूल देखें और सुनिश्चित करें कि वह "इनेबल्ड" है। यदि न हो, तो क्लिक करके इनेबल करें। इनेबल होने के बाद PHP-FPM सेवा को रीस्टार्ट करना पड़ सकता है (ServBay अक्सर यह अपने आप करता है)।
अपना IDE कॉन्फ़िगर करें: अपने पसंदीदा इंटीग्रेटेड डेवेलपमेंट एनवायरनमेंट (जैसे PHPStorm या VS Code) में XDebug कनेक्शन सेट करें। आमतौर पर इसमें सुन रहे पोर्ट (जो UI में बताई गई XDebug सेटिंग्स से मेल खाता हो) और जरूरत पड़ने पर रिमोट पाथ मैपिंग सेट करना होता है (हालांकि ServBay लोकल वातावरण में इसकी कमी ही रहती है)।
अधिक IDE कॉन्फ़िगरेशन जानकारी
अगर आपको किसी खास IDE (जैसे PHPStorm, VS Code आदि) में XDebug सेटअप के लिए स्टेप-बाय-स्टेप जानकारी चाहिए, तो संबंधित IDE के डाक्युमेंटेशन या ServBay में Xdebug मॉड्यूल इनेबल करने की गाइड पढ़ें।

अभ्यास: ServBay में PHP प्रोजेक्ट डिबगिंग

यहाँ हम एक सिंपल प्रोजेक्ट के उदाहरण से दिखाएंगे कि ServBay में XDebug के साथ किस तरह PHP डिबगिंग की जाती है।

1. ServBay में वेबसाइट सेट करें

पहले ServBay में एक नई वेबसाइट बनाएं ताकि हमारा डेमो प्रोजेक्ट उसमें होस्ट हो सके:

ServBay के वेबसाइट रूट डायरेक्ट्री /Applications/ServBay/www/ में एक नया प्रोजेक्ट फोल्डर बनाएं, उदाहरण के लिए servbay-xdebug-app।
ServBay ऐप खोलकर “वेबसाइट” सेक्शन में जाएं।
नई वेबसाइट जोड़ें, और रूट डायरेक्ट्री को /Applications/ServBay/www/servbay-xdebug-app पर सेट करें।
कोई भी लोकल डोमेन सेट करें, जैसे कि servbay-xdebug-app.servbay.demo।
मनचाहा PHP वर्शन चुनें और सुनिश्चित करें कि वह वर्शन ऊपर बताए गए अनुसार XDebug सहित इनेबल और सेट है।
सेव करें और बदलाव लागू करें। ServBay अपने आप Caddy/Nginx और होस्ट्स फाइल (या अपने DNS) को अपडेट कर देगा।

2. प्रोजेक्ट स्ट्रक्चर और कोड

/Applications/ServBay/www/servbay-xdebug-app/ डायरेक्ट्री में नीचे बताए गए फोल्डर और फाइल्स बनाएं:

servbay-xdebug-app/
├── src/
│   └── Calculator.php
└── index.php

src/Calculator.php का कंटेंट:

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

<?php
// मान लीजिए आप Composer का इस्तेमाल कर रहे हैं, यहाँ ऑटो-लोडर लोड करें
// अगर Composer का प्रयोग नहीं किया, तो लोडिंग तरीका असलियत के हिसाब से बदलें
require __DIR__ . '/vendor/autoload.php';

use App\Calculator;

echo "Debugging Example:\n";

$calculator = new Calculator();
$num1 = 5;
$num2 = 3;

$sum = $calculator->add($num1, $num2);
$difference = $calculator->subtract($num1, $num2);

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

echo "Done.\n";
?>

नोट: ऊपर require __DIR__ . '/vendor/autoload.php'; मानकर चल रहा है कि आपने Composer इस्तेमाल किया है। सिर्फ टेस्टिंग के लिए आप यह लाइन हटा सकते हैं और use App\Calculator; की जगह require __DIR__ . '/src/Calculator.php'; लिख सकते हैं।

3. ब्रेकपॉइंट सेट करें

अपने IDE (जैसे PHPStorm) में /Applications/ServBay/www/servbay-xdebug-app/src/Calculator.php फाइल खोलें। 'add' मेथड की return $a + $b; वाली लाइन के आगे लाइन नंबर पर क्लिक करके ब्रेकपॉइंट लगाएँ।

4. डिबगिंग सेशन शुरू करें

अपने IDE में XDebug कनेक्शन के लिए लिस्निंग शुरू करें। PHPStorm में यह आमतौर पर "Start Listening for PHP Debug Connections" टूलबार बटन (फोन या बग आइकन) से किया जाता है।
ब्राउज़र में अपने ServBay साइट के index.php पेज—https://servbay-xdebug-app.servbay.demo/index.php—पर जाएं।
अगर आपकी XDebug सेटिंग में xdebug.start_with_request 'trigger' पर है, तो ब्राउज़र एक्सटेंशन या मैन्युअल तरीके से XDebug ट्रिगर ऐड करना न भूलें (जैसे: https://servbay-xdebug-app.servbay.demo/index.php?XDEBUG_TRIGGER=1 पर जाएं)।

5. डिबग प्रोसेस

जब ब्राउज़र index.php को एक्सेस करता है और XDebug सेशन ट्रिगर होता है, तो XDebug अपने-आप आपके IDE से कनेक्ट हो जाता है और ब्रेकपॉइंट पर कोड एग्जीक्यूशन रोक देता है।
IDE "डिबगिंग व्यू" में बदल जाएगा, जहां कोड ब्रेकपॉइंट पर रुका होगा—जैसे Calculator.php की add लाइन।

6. वेरिएबल्स देखें

IDE के डिबगिंग विंडो में आप करंट कोड लाइन, कॉल स्टैक, वेरिएबल वैल्यू आदि देख सकते हैं।
"Variables" पैनल में आप इस वक्त उपलब्ध वेरिएबल्स जान सकते हैं—जैसे $a की वैल्यू 5, $b की वैल्यू 3 होगी।

7. लाइन-बाय-लाइन एग्जीक्यूशन (Single Stepping)

IDE में उपलब्ध सिंगल-स्टेप बटन का उपयोग करें (Step Over (F8), Step Into (F7), Step Out (Shift+F8) आदि)।
- Step Over: करंट लाइन को चलाता है; अगर कोई फंक्शन कॉल है, तो उसके अंदर नहीं घुसता, फंक्शन पूरा चलाकर अगली लाइन पर जाता है।
- Step Into: करंट लाइन को चलाता है; अगर इसमें फंक्शन कॉल है, तो उसके अंदर की पहली लाइन पर चला जाता है।
- Step Out: मौजूदा फंक्शन का बचा कोड चला कर बाहर लौट जाता है।
इस तरीके से आप लाइन-बाय-लाइन कोड का फ्लो और वेरिएबल्स के मान बदलते देख सकते हैं।

8. कंटिन्यू/रिज्यूम प्रोग्राम

IDE में “Resume Program” बटन (आमतौर पर हरा प्ले आइकन या F9) पर क्लिक करें; प्रोग्राम दोबारा चलेगा, जब तक अगला ब्रेकपॉइंट या फिनिश न हो जाए।

9. आउटपुट देखें

प्रोग्राम पूरा होने के बाद ब्राउज़र (या CLI डिबगिंग होने पर टर्मिनल) में आउटपुट देख लें। इस उदाहरण के लिए, आपको दिखेगा:
text
```
Debugging Example:
Sum: 8
Difference: 2
Done.
```
1
2
3
4

ध्यान रखने योग्य बातें

फायरवॉल: अपने OS का फायरवॉल आपकी IDE द्वारा इस्तेमाल किए जा रहे पोर्ट (डिफॉल्ट: 9003) को ब्लॉक न करे।
पोर्ट कन्फ्लिक्ट: XDebug के लिए जो पोर्ट सेट है वह किसी अन्य ऐप्लिकेशन में न इस्तेमाल हो रहा हो।
परफॉर्मेंस इम्पैक्ट: xdebug.mode=debug और xdebug.start_with_request=yes होने पर हर PHP रिक्वेस्ट में डिबगिंग चालू हो जाती है, जिससे साइट की परफॉर्मेंस पर असर पड़ सकता है। डिबगिंग न चाहिए हो तो XDebug को बंद करें या xdebug.start_with_request को trigger पर रखें।
CLI डिबगिंग: XDebug का इस्तेमाल PHP CLI स्क्रिप्ट्स की डिबगिंग के लिए भी किया जा सकता है। इसके लिए कमांड लाइन में ENVs या स्पेशल पैरामीटर सेट करें—डिटेल के लिए XDebug डाक्युमेंटेशन देखें।
IDE वर्शन व सेटिंग्स: अलग-अलग IDE वर्शन और इंटरफेस में हल्का-फुल्का फर्क हो सकता है—हमेशा अपने IDE की ऑफिशियल गाइड देखें।

सामान्य समस्याएँ और उनके हल (FAQ)

प्रश्न: मेरी IDE, XDebug से कनेक्ट नहीं हो रही है, क्या करूँ?

उत्तर: इन बिंदुओं की जांच करें:

सुनिश्चित करें कि ServBay में चुने गए PHP वर्शन का XDebug मॉड्यूल इनेबल है।
php.ini में xdebug.mode, xdebug.client_host, xdebug.client_port की सेटिंग्स सही हैं और आपके IDE में वही पोर्ट व होस्ट सेट हैं।
अगर आप xdebug.start_with_request = trigger यूज़ कर रहे हैं, तो वरिफाय करें कि आपने ठीक से ट्रिगर ऐड किया (GET/POST पैरामीटर, कुकी या हेडर)।
अपने OS के फायरवॉल में XDebug पोर्ट के लिए ट्रैफिक अलाउड हो।
IDE में XDebug पोर्ट लिस्निंग चालू हो।

प्रश्न: XDebug इनेबल करने के बाद वेबसाइट स्लो क्यों हो जाती है?

उत्तर: शायद आपने xdebug.start_with_request को yes पर सेट किया है। इस मोड में हर PHP रिक्वेस्ट में डिबगिंग स्टार्ट होती है, जिससे ओवरहेड बढ़ता है। बेहतर है कि इसे trigger पर रखें और सिर्फ जरूरत के वक्त मैन्युअल ट्रिगर करें।

प्रश्न: क्या XDebug के ज़रिए AJAX रिक्वेस्ट भी डिबग की जा सकती हैं?

उत्तर: हाँ, AJAX रिक्वेस्ट डिबगिंग आम HTTP रिक्वेस्ट जैसी ही होती है; बस ये तय कर लें कि रिक्वेस्ट में XDebug ट्रिगर (कुकी या हेडर के ज़रिए) पास हो रहा है।

प्रश्न: PHPStorm के अलावा, क्या ServBay का XDebug VS Code या अन्य IDE में सपोर्ट करता है?

उत्तर: बिल्कुल। ServBay में XDebug PHP का स्टैंडर्ड एक्सटेंशन है और यह किसी भी DBGp प्रोटोकॉल सपोर्टेड IDE/एडिटर (जैसे VS Code [PHP Debug एक्सटेंशन के साथ], NetBeans, Eclipse आदि) के साथ चलेगा। सेटअप के ज्यादातर स्टेप्स एक जैसे ही हैं—सिर्फ पोर्ट लिस्निंग IDE में सही सेट करें।

निष्कर्ष

ServBay में इंटीग्रेटेड XDebug की वजह से PHP प्रोजेक्ट की लोकल डिबगिंग बेहद आसान और फायदेमंद हो जाती है। ब्रेकपॉइंट, वेरिएबल जांच और सिंगल-स्टेप एग्जीक्यूशन जैसे टूल्स आपकी समस्या पहचानने और सुलझाने की क्षमता कई गुना बढ़ा देते हैं, जिससे कोड क्वालिटी सुनिश्चित रहती है। ServBay के सुविधाजनक एनवायरनमेंट मैनेजमेंट के साथ, XDebug आपकी PHP डेवेलपमेंट वर्कफ्लो की ताकत को कई गुना बढ़ा देगा। तो आज़माइए ServBay के साथ XDebug—PHP डेवेलपमेंट को बनाइए और अधिक स्मार्ट, फ़ास्ट और भरोसेमंद!

ServBay में XDebug के साथ PHP प्रोजेक्ट डिबग करें ​

XDebug क्या है? ​

ServBay में XDebug इनेबल और सेटअप करें ​

अभ्यास: ServBay में PHP प्रोजेक्ट डिबगिंग ​

1. ServBay में वेबसाइट सेट करें ​

2. प्रोजेक्ट स्ट्रक्चर और कोड ​

3. ब्रेकपॉइंट सेट करें ​

4. डिबगिंग सेशन शुरू करें ​

5. डिबग प्रोसेस ​

6. वेरिएबल्स देखें ​

7. लाइन-बाय-लाइन एग्जीक्यूशन (Single Stepping) ​

8. कंटिन्यू/रिज्यूम प्रोग्राम ​

9. आउटपुट देखें ​

ध्यान रखने योग्य बातें ​

सामान्य समस्याएँ और उनके हल (FAQ) ​

निष्कर्ष ​