Come abilitare il modulo Xdebug integrato di ServBay

ServBay, uno strumento di sviluppo web integrato potente, è dotato del modulo Xdebug, e il suo processo di attivazione è molto semplice. Xdebug è un tool di debug e analisi per PHP che aiuta gli sviluppatori con il debug del codice, l'analisi delle prestazioni e il controllo della copertura del codice, ed è uno strumento indispensabile per lo sviluppo e la manutenzione delle applicazioni PHP.

Introduzione al modulo Xdebug

Xdebug è un'estensione PHP potente utilizzata per eseguire debug e analisi del codice PHP. Offre funzionalità di debug avanzate, come il debug con breakpoint, il tracciamento dello stack, il monitoraggio delle variabili, e altro ancora. Inoltre, Xdebug supporta l'analisi delle prestazioni e il controllo della copertura del codice, aiutando gli sviluppatori a ottimizzare le prestazioni del codice e garantire la qualità del codice.

Caratteristiche principali

1. Debug con breakpoint: Xdebug supporta l'impostazione di breakpoint nel codice, consentendo di eseguire il debug riga per riga e individuare e correggere facilmente gli errori.
2. Tracciamento dello stack: in caso di errore, Xdebug genera informazioni dettagliate sullo stack trace per aiutare gli sviluppatori a localizzare rapidamente i problemi.
3. Analisi delle prestazioni: Xdebug offre funzioni di analisi delle prestazioni che generano report dettagliati, aiutando a ottimizzare le prestazioni del codice.
4. Copertura del codice: Xdebug supporta il controllo della copertura del codice per garantire che i test coprano tutti i percorsi del codice.
5. Supporto per ambienti di sviluppo integrati: Xdebug può essere integrato con vari ambienti di sviluppo integrati (IDE) come PHPStorm, Visual Studio Code, offrendo un'esperienza di debug agevole.

Versioni del modulo Xdebug integrate di ServBay

ServBay supporta diversi versioni di PHP e per ognuno ha preinstallato il modulo Xdebug corrispondente. Le versioni specifiche sono le seguenti:

• 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

Suggerimento

Ogni versione di PHP ha una porta Xdebug indipendente, associata al numero di versione, ad esempio la porta Xdebug per PHP 7.2 è 39072, e per PHP 8.3 è 39083.

Come abilitare il modulo Xdebug

Di default, il modulo Xdebug è disabilitato. I passaggi per abilitarlo sono molto semplici: basta navigare su Linguaggio-PHP, scegliere la versione PHP per la quale si desidera abilitare il modulo, ad esempio PHP 8.4, cliccare su Estensioni sulla destra, e poi attivare l'interruttore accanto al modulo Xdebug, quindi salvare.

Gli utenti possono abilitare o modificare manualmente la configurazione del modulo con i seguenti passaggi dettagliati:

Passaggio uno: Trova il file di configurazione

Innanzitutto, individua la directory conf.d per la versione PHP desiderata. Ad esempio, per abilitare Xdebug per PHP 8.3, è necessario modificare il seguente file:

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

Passaggio due: Modifica il file di configurazione

Apri il file xdebug.ini e decommenta la seguente riga:

[Xdebug]
; Decommenta la seguente riga per abilitare XDebug
zend_extension = xdebug.so

Passaggio tre: Configura i parametri di Xdebug

Per sfruttare appieno le funzionalità di Xdebug, nel file xdebug.ini puoi configurare alcuni parametri comuni. Ad esempio:

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

Passaggio quattro: Riavvia il servizio PHP

Nel pannello di gestione dei servizi di ServBay, riavvia il servizio PHP corrispondente. Ad esempio, riavvia il servizio PHP 8.3. Una volta riavviato, il modulo Xdebug sarà caricato con successo.

Verifica che il modulo Xdebug sia caricato correttamente

Puoi verificare se Xdebug è stato caricato correttamente creando un semplice file PHP. Crea un file phpinfo.php nella directory radice del server web con il seguente contenuto:

<?php
phpinfo();
?>

Accedi a https://servbay.host/phpinfo.php e cerca le informazioni relative a Xdebug nella pagina delle informazioni PHP. Se vedi le informazioni relative a Xdebug, significa che il modulo è stato caricato correttamente.

Configurare Xdebug in PHPStorm

Per utilizzare Xdebug in PHPStorm per il debug, è necessario seguire i seguenti passaggi di configurazione:

Passaggio uno: Apri PHPStorm e vai su Impostazioni

1. Apri PHPStorm.
2. Clicca su File nella barra dei menu e seleziona Settings (su Windows/Linux) o Preferences (su macOS).

Passaggio due: Configura l'interprete PHP

1. Nella finestra delle impostazioni, naviga su Languages & Frameworks -> PHP.
2. Nella sezione CLI Interpreter, clicca sul pulsante ... a destra.
3. Nella finestra che si apre, clicca su + per aggiungere un nuovo interprete PHP e seleziona Local.
4. Imposta il percorso dell'interprete PHP sulla versione corrispondente di PHP in ServBay, ad esempio /Applications/ServBay/package/php/8.3/8.3.7/bin/php.
5. Clicca su OK per salvare le impostazioni.

Passaggio tre: Configura il debug di Xdebug

Suggerimento

Ogni versione di PHP ha una porta Xdebug indipendente, associata al numero di versione, ad esempio la porta Xdebug per PHP 7.2 è 39072, e per PHP 8.3 è 39083.

1. Nella finestra delle impostazioni, naviga su Languages & Frameworks -> PHP -> Debug.
2. Nella sezione Xdebug, imposta Debug Port a 39083, coerentemente con la configurazione di xdebug.client_port.
3. Assicurati che l'opzione Can accept external connections sia selezionata.
4. Clicca su Apply e poi su OK per salvare le impostazioni.

Passaggio quattro: Configura il server PHP Web

1. Nella finestra delle impostazioni, naviga su Languages & Frameworks -> PHP -> Servers.
2. Clicca su + sulla destra per aggiungere una nuova configurazione del server.
3. Imposta il nome del server, ad esempio ServBay Localhost.
4. Imposta Host sul nome host corrispondente in ServBay, ad esempio servbay.new, e la porta a 443 (HTTPS).
5. Imposta Debugger su Xdebug.
6. Clicca su OK per salvare le impostazioni.

Passaggio cinque: Avvia una sessione di debug

1. In PHPStorm, apri il progetto PHP che vuoi eseguire in debug.
2. Imposta un breakpoint nel codice (clicca nell'area a sinistra del numero di riga).
3. Clicca sul pulsante Start Listening for PHP Debug Connections nella barra degli strumenti di PHPStorm (icona del piccolo insetto).
4. Nel browser, accedi alla tua applicazione PHP, e Xdebug si connetterà automaticamente a PHPStorm, sospendendo l'esecuzione al breakpoint.

Conclusione

ServBay offre un modo conveniente per gestire e abilitare il modulo Xdebug. Attraverso semplici configurazioni e operazioni di riavvio, gli sviluppatori possono rapidamente abilitare il modulo Xdebug in diverse versioni di PHP, sfruttando le sue potenti funzionalità di debug e analisi per migliorare l'efficienza di sviluppo e manutenzione delle applicazioni PHP. Le funzionalità di debug con breakpoint, analisi delle prestazioni e controllo della copertura del codice di Xdebug lo rendono uno strumento indispensabile per gli sviluppatori PHP.