Presentazione di Xdebug<\/h2>\n
Xdebug<\/a> \u00e8 una delle estensioni pi\u00f9 popolari per il debug del codice PHP. Si installa dall’ambiente che avete scelto e agisce come un “debugger a passi”.<\/p>\n In breve, questo vi permette di lavorare sul vostro codice riga per riga, in modo da poter esaminare il modo in cui il codice agisce e interagisce all’interno del programma, oltre a studiare il suo output. Da l\u00ec potrete apportare le modifiche che ritenete opportune.<\/p>\n Xdebug pu\u00f2 fare molto di pi\u00f9, per\u00f2:<\/p>\n Date le sue caratteristiche, ci sono molti modi per usare Xdebug (e qualsiasi altro debugger simile) all’interno del vostro flusso di lavoro. Li illustreremo nella prossima sezione.<\/p>\n\n Molti developer non hanno un flusso di lavoro dedicato al debug che utilizza strumenti ed estensioni di terze parti. Questo perch\u00e9 PHP include un proprio rudimentale sistema di registrazione degli errori. Userete comandi come Per esempio, ci sono molti snippet che potete riutilizzare per lo sviluppo di WordPress: Stack Overflow ne \u00e8 pieno<\/a>:<\/p>\n Tuttavia, questo approccio presenta alcuni importanti svantaggi:<\/p>\n L’ultimo punto richiede un grande sforzo manuale, soprattutto se il vostro lavoro quotidiano non \u00e8 quello di sysadmin<\/a>. Per esempio, se volete eseguire il debug di un blocco di codice, potreste aggiungere il vostro snippet in base a una variabile che definite. Tuttavia, potrebbe non essere la fonte del problema e nemmeno indicare cosa sta succedendo.<\/p>\n Invece, uno strumento come Xdebug pu\u00f2 fare la sua magia per fornire una portata maggiore:<\/p>\n In generale, l’utilizzo di uno strumento come Xdebug \u00e8 una decisione proattiva piuttosto che responsive. Potete utilizzare il debug a tappe come parte integrante del processo di sviluppo, proprio come l’implementazione dei test unitari come parte dello sviluppo guidato dai test (TDD).<\/p>\n Anche se potete eseguire il debug del vostro codice senza un errore specifico, spesso \u00e8 utile sapere se un problema si verifica senza avere Xdebug aperto. Questo vi d\u00e0 un punto di partenza per l’esplorazione<\/a>. Non \u00e8 strettamente necessario, ma pu\u00f2 essere una parte utile della vostra catena.<\/p>\n Per segnalare ogni errore che si verifica, dovrete aggiungere una riga all’inizio del file PHP corrispondente:<\/p>\n Si tratta di un comando di tipo catch-all e potete ottenere lo stesso risultato utilizzando la funzione Questo vi permette di modificare le impostazioni all’interno del vostro file php.ini<\/strong>, progetto per progetto. Sebbene possiate entrare in questo file e fare una modifica manuale, spesso \u00e8 meglio lavorare con Una volta impostata la segnalazione degli errori attivi secondo i vostri gusti, potete iniziare a lavorare con Xdebug.<\/p>\n Nelle prossime sezioni vi mostreremo come usare Xdebug, compresi i passaggi necessari per configurarlo. Anche se non possiamo occuparci di tutti gli aspetti dello strumento, questa guida rapida vi permetter\u00e0 di iniziare subito a lavorare.<\/p>\n Per prima cosa, per\u00f2, dovete installare Xdebug. Scopriamo come fare.<\/p>\n Poich\u00e9 Xdebug \u00e8 adattabile a qualsiasi tipo di configurazione, il processo esatto<\/a> per ciascuno di essi sar\u00e0 leggermente diverso. A livello di sistema operativo, ci sono alcune differenze:<\/p>\n Tuttavia, la maggior parte degli utenti non vorr\u00e0 attenersi a un’istanza di Xdebug a livello di sistema. Al contrario, vi conviene integrarlo nel vostro ambiente di sviluppo.<\/p>\n Una volta installato Xdebug per il vostro sistema operativo, dovete collegarlo al vostro ambiente.<\/p>\n I sistemi e gli strumenti supportati sono talmente tanti che non \u00e8 possibile esaminarli tutti. Pi\u00f9 avanti vi forniremo le istruzioni per DevKinsta<\/a> e PhpStorm<\/a>. Tuttavia, ci sono molti altri ambienti popolari tra cui scegliere. Di seguito vi elenchiamo alcuni dei nostri migliori consigli.<\/p>\n VVV<\/a> \u00e8 uno degli ambienti nominati sul sito web di Make WordPress<\/a>:<\/p>\n La buona notizia \u00e8 che VVVV include gi\u00e0 una versione di Xdebug<\/a>, ma dovete attivarla. Potete farlo usando Secure Shell (SSH) all’interno di una finestra del Terminale:<\/p>\n Tuttavia, le prestazioni ne risentono un po’ e dovrete riattivare questa opzione se fate il provisioning dei vostri siti.<\/p>\n Per alcuni utenti, Laravel Valet<\/a> rappresenta un ambiente di sviluppo web quasi perfetto. Ancora meglio, potete integrare Xdebug con esso.<\/p>\n Per farlo, dovrete creare un file di configurazione per il debugger. Potete trovare il vostro percorso utilizzando Successivamente, create un nuovo file xdebug.ini<\/strong> nel percorso dei file .ini<\/strong> aggiuntivi. Nel nostro esempio, si trova in \/opt\/homebrew\/etc\/php\/7.4\/conf.d<\/strong>.<\/p>\n Una volta aperto questo nuovo file, aprite anche il percorso del file di configurazione caricato (il vostro file php.ini<\/strong> principale). Con entrambi aperti, aggiungete il seguente testo in fondo:<\/p>\n Una volta salvate le modifiche, eseguite Tenete presente che potrebbe essere necessario riavviare PHP usando Da qui potete cercare di incorporare Xdebug nel vostro editor di codice preferito.<\/p>\n Come per Valet, anche per XAMPP<\/a> ci sono alcune parti del processo. Tuttavia, le versioni per Windows e macOS hanno due processi diversi.<\/p>\n Iniziate installando XAMPP, poi eseguite un rapido controllo per verificare se il file php_xdebug.dll<\/strong> (Windows) o xdebug.so<\/strong> (macOS) esiste sul vostro sistema:<\/p>\n Se il file esiste, potete passare alla configurazione. In caso contrario, dovrete prima scaricare il binario giusto<\/a> per Windows – un file a 64 bit per la versione di PHP che preferisci – oppure installare qualche altra dipendenza se usate un Mac.<\/p>\n Per Windows, rinominate il file DLL php_xdebug.dll<\/strong> e spostatelo nel percorso del file xamppphpext<\/strong>. Quindi, aprite il file xamppphpphp.ini<\/strong> nel vostro editor di codice preferito<\/a> e aggiungete quanto segue:<\/p>\n Nella sezione Una volta salvate le modifiche, riavviate Apache e verificate la presenza di Xdebug.<\/p>\n Per Mac<\/a>, dovete assicurarvi di installare gli strumenti da linea di comando di Xcode<\/a> usando In alcuni casi, dovrete anche reinstallare XAMPP per ottenere sia il programma principale che i “File per developer”. Dovreste essere in grado di reinstallare solo questi file, ma prima dovrete eseguire un backup della configurazione esistente.<\/p>\n Successivamente, andate al download della cartella sorgente di Xdebug sul vostro sistema e decomprimete il file TGZ. All’interno di una finestra del Terminal, navigate in questa cartella ed eseguite il seguente comando:<\/p>\n Notate che potrebbe essere necessario usare Per verificare se funziona, create un nuovo file xdebug_info.php<\/strong> all’interno della cartella principale htdocs<\/strong> di XAMPP. All’interno, aggiungete quanto segue:<\/p>\n … poi aggiornate Apache e provate Xdebug nel browser.<\/p>\n Una volta installato Xdebug attraverso il sistema operativo e l’ambiente di sviluppo, dovrete visualizzare il debugger stesso. Potrete farlo attraverso l’editor di codice o l’ambiente di sviluppo integrato (IDE)<\/a> che avete scelto. Come per l’ambiente, ce ne sono molti tra cui scegliere e ognuno di essi pu\u00f2 avere un approccio diverso.<\/p>\n Detto questo, molti developer scelgono di usare PhpStorm di JetBrains<\/a>. Infatti, PhpStorm offre “assistenza consapevole di WordPress”<\/a> ed \u00e8 una scelta popolare anche per molte altre ragioni.<\/p>\n Il sito web di JetBrains<\/a> contiene le istruzioni complete per collegare Xdebug e PhpStorm, ma le esamineremo qui.<\/p>\n Per prima cosa, andate alla pagina Languages & Frameworks > PHP<\/strong> all’interno del pannello Preferences<\/strong>. Qui, aprite il menu More Items<\/strong> accanto al campo a tendina CLI Interpreter<\/strong>:<\/p>\n In questo modo verranno mostrati ulteriori dettagli sulla versione di PHP e sull’interprete. Se fate clic sul pulsante More items<\/strong> accanto all’opzione Configuration file<\/strong>, vedrete il percorso completo del vostro file php.ini<\/strong>:<\/p>\n Lavorerete su questo file PHP per continuare il processo di configurazione.<\/p>\n Il primo compito da svolgere \u00e8 quello di modificare tutte le righe che influiscono sul funzionamento di Xdebug con PhpStorm.<\/p>\n All’interno del file php.ini<\/strong>, cercate le seguenti righe e rimuovetele o commentatele:<\/p>\n Queste linee non saranno presenti in tutti i casi, quindi non allarmatevi se non le vedete.<\/p>\n Successivamente, aggiungete al file quanto segue:<\/p>\n Ci sono alcune cose da notare su questa suite di codice:<\/p>\n Una volta aggiunti questi elementi, salvate e chiudete l file, quindi verificate la versione di PHP dalla linea di comando (utilizzando Se avete una versione funzionante di Xdebug, verr\u00e0 visualizzata come una delle estensioni PHP. Potete anche aggiungere Questo \u00e8 tutto ci\u00f2 che dovete fare per far funzionare Xdebug come debugger predefinito con PhpStorm. L’ultimo passo prima di utilizzarlo \u00e8 l’installazione di un’estensione di aiuto al browser.<\/p>\n L’ultima connessione chiave che dovrete stabilire \u00e8 quella tra il vostro browser e PhpStorm, ottenuta attivando il debug a passi sul server. Sebbene possiate farlo dalla linea di comando<\/a> utilizzando i valori speciali Vi consigliamo di utilizzare l’estensione dedicata Xdebug Helper. Potete installarla sul vostro browser preferito:<\/p>\n Se volete esplorare altre estensioni, il sito web di JetBrains<\/a> offre alcune opzioni aggiuntive per i browser pi\u00f9 diffusi.<\/p>\n Una volta installata l’estensione del browser che avete scelto, non dovreste dover modificare altre impostazioni di configurazione. Da qui, potete iniziare a usare Xdebug con PhpStorm.<\/p>\n Anche se in questo caso useremo PhpStorm, vedrete un layout e un’interfaccia simili tra i diversi IDE, anche se ci saranno alcune differenze evidenti.<\/p>\n Ci sono alcuni concetti che si combinano per formare l’intera esperienza di debug:<\/p>\n Il primo passo \u00e8 attivare l’ascolto (listening): senza di esso non potrete eseguire il debug. Per farlo, fate clic sull’opzione Run > Start Listening for PHP Debug Connections<\/strong> nella barra degli strumenti:<\/p>\n In alternativa, potete fare clic sull’icona “telefono” nella barra degli strumenti di PhpStorm:<\/p>\n Entrambe le opzioni avviano l’ascolto delle connessioni.<\/p>\n Da qui, potete iniziare a impostare i punti di interruzione all’interno dell’editor di codice. Un punto rosso indica un punto di interruzione su cui potete fare clic per attivarlo:<\/p>\n Quando volete eseguire il debug del codice, il modo pi\u00f9 semplice \u00e8 quello di iniziare l’ascolto, impostare i punti di interruzione e poi andare alla pagina specifica nel vostro browser. Individuate l’icona della vostra estensione all’interno del browser, poi fateci clic sopra e selezionate l’opzione “Debug”:<\/p>\n In questo modo si aprir\u00e0 il debugger di PhpStorm e si riceveranno le buone o le cattive notizie:<\/p>\n Se fate clic con il tasto destro del mouse sui vari valori, attributi, parametri e variabili, potrete accedere a un ulteriore menu contestuale. In questo modo avrete a disposizione un ampio margine di manovra per testare ed eseguire il debug del vostro codice:<\/p>\n Per esempio, potete impostare valori diversi per le variabili lungo il percorso. Questo potrebbe essere un tentativo deliberato di rompere il vostro codice e vedere cosa succede, oppure un modo per testare il codice che ha gi\u00e0 bisogno di una correzione. In ogni caso, questo vi offre un metodo fantastico per eseguire il debug del vostro codice senza doverlo prima modificare.<\/p>\n WordPress dispone di una serie di opzioni di debug<\/a> attraverso Potete anche salvare i messaggi di errore usando Se lo abbinate allo strumento gratuito DevKinsta per l’ambiente locale<\/a>, avrete anche un modo per abilitare e disabilitare<\/a> In questo modo potete individuare gli errori sul vostro sito durante lo sviluppo e assicurarvi che non vengano trasmessi al sito live. Queste modalit\u00e0 sono anche facili da disattivare, il che \u00e8 fondamentale per la sicurezza del sito e degli utenti<\/a>.<\/p>\n Tutti i piani Kinsta includono anche lo strumento Kinsta APM<\/a>, il nostro strumento di monitoraggio delle prestazioni per i siti WordPress.<\/p>\n Prima di concludere questo articolo, dobbiamo parlare delle scorciatoie.<\/p>\n Come per molti altri software, ci sono vari modi per navigare in Xdebug (e PhpStorm) usando solo la tastiera. In effetti, potete anche usare la riga di comando per eseguire il debug degli script PHP.<\/p>\n Una volta che Xdebug \u00e8 attivo e funzionante, potete usare i seguenti comandi per muovervi:<\/p>\n Anche se il vostro editor di codice specifico avr\u00e0 le sue scorciatoie dedicate, qui l’attenzione \u00e8 rivolta a PhpStorm. Date un’occhiata a questa tabella di scorciatoie da tastiera<\/a> per usare Xdebug con PhpStorm:<\/p>\n![\"Uno](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/xdebug.png\")
\n
Perch\u00e9 Usare Xdebug<\/h2>\n
error_log<\/code>, var_dump<\/code> e print per vedere i risultati delle variabili e delle chiamate di funzione.<\/p>\nfunction log_me($message) {\n if ( WP_DEBUG === true ) {\n if ( is_array($message) || is_object($message) ) {\n error_log( print_r($message, true) );\n } else {\n error_log( $message );\n }\n }\n}<\/code><\/pre>\n\n
WP_DEBUG<\/code> (ne parleremo pi\u00f9 avanti).<\/li>\n\n
Come Attivare la Registrazione degli Errori in PHP<\/h2>\n
error_reporting(E_ALL);<\/code><\/pre>\nini_set<\/a><\/code>:<\/p>\nini_set('error_reporting', E_ALL);<\/code><\/pre>\nini_set<\/code> per modificare un parametro specifico:<\/p>\nini_set('display_errors', '1');<\/code><\/pre>\nCome Usare Xdebug<\/h2>\n
1. Installare Xdebug per il Vostro Sistema Operativo (OS)<\/h3>\n
\n
pecl install xdebug<\/code> da un’istanza del Terminale. Dovrete inoltre avere gli strumenti da riga di comando XCode e PHP installati sul vostro sistema.<\/li>\n<\/ul>\n2. Integrare Xdebug nel Vostro Ambiente di Sviluppo<\/h3>\n
Varying Vagrant Vagrants (VVV)<\/h4>\n
![\"Uno](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/vvv-logo.png\"){kind=logo}
vagrant ssh -c \"switch_php_debugmod xdebug\"<\/code><\/pre>\nLaravel Valet<\/h4>\n
php --ini<\/code> alla riga di comando, che vi restituir\u00e0 diversi percorsi di file:<\/p>\n![\"Una](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/terminal-php-ini.png\")
\n
zend_extension=\"xdebug.so\"<\/code><\/li>\nxdebug.mode=debug<\/code><\/li>\n<\/ul>\nvalet restart<\/code> dal Terminal, quindi aggiungete phpinfo(); exit;<\/code> a uno dei file del vostro sito. Dovrete verificare se questo funziona attraverso un rapido caricamento della pagina nel browser.<\/p>\n![\"Un](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/php-info-page.png\")
sudo brew services restart php<\/code> e verificare che l’installazione di Xdebug nel sistema sia corretta utilizzando php --info | grep xdebug<\/code>. Noterete le linee specifiche di Xdebug all’interno dell’output:<\/p>\n![\"Una](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/grep-xdebug-mode.png\")
<\/p>\nXAMPP<\/h4>\n
![\"A](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/test-xampp-file-terminal.png\")
output_buffering = Off<\/code><\/pre>\n[XDebug]<\/code>, aggiungete le tre righe seguenti:<\/p>\nzend_extension=xdebug\nxdebug.mode=debug\nxdebug.start_with_request=trigger<\/code><\/pre>\nxcode-select --install<\/code> in un’istanza del Terminale. Successivamente, dovrete installare tre pacchetti utilizzando Homebrew:<\/p>\nbrew install autoconf automake libtool<\/code><\/pre>\nphpize\npecl install xdebug<\/code><\/pre>\nsudo<\/code> anche in questo caso. Da qui potrete modificare il file php.ini di XAMPP. Per la maggior parte delle installazioni macOS, lo troverete in \/Applications\/XAMPP\/xamppfiles\/etc\/php.ini<\/strong>. All’interno di questa directory troverete anche il percorso del vostro file xdebug.so<\/strong>: annotatelo e usatelo al posto del percorso del file per questo frammento:<\/p>\n[xdebug]\nzend_extension=\/path\/to\/xdebug.so\nxdebug.mode=develop,degug\nxdebug.start_with_request=yes<\/code><\/pre>\n<?php\nxdebug_info();<\/code><\/pre>\nUsare PhpStorm con Xdebug<\/h2>\n
![\"L'interfaccia](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/php-storm.png\")
![\"Schermata](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/cli-interpreter.png\")
![\"Schermata](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/configuration-file.png\")
Lavorare nel File php.ini<\/h4>\n
zend_extension=<path_to_zend_debugger>\nzend_extension=<path_to_zend_optimizer><\/code><\/pre>\n[xdebug]\nzend_extension=\"xdebug.so\"\nxdebug.mode=debug\nxdebug.client_host=127.0.0.1\nxdebug.client_port=\"<the port (9003 by default) to which Xdebug connects>\"<\/code><\/pre>\n\n
[xdebug]<\/code>, nel qual caso potete omettere la prima denominazione.<\/li>\nzend_extension<\/code> potrebbe richiedere l’aggiunta del percorso completo di xdebug.so<\/strong> per la connessione.<\/li>\nxdebug.client_port<\/code> \u00e8 il modo in cui lo imposterete nel vostro codice.<\/li>\n<\/ul>\nphp --version<\/code>):<\/p>\n![\"Sfondo](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/terminal-xdebug-php-version.png\")
phpinfo();<\/code> a un nuovo file e testarlo nel browser.<\/p>\nInstallare un’Estensione Browser Helper<\/h4>\n
GET<\/code> o POST<\/code>, \u00e8 pi\u00f9 semplice utilizzare un’estensione.<\/p>\n\n
Usare Xdebug<\/h3>\n
\n
![\"Una](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/phpstorm-run-menu.png\")
![\"Un](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/phpstorm-bug-toolbar.png\")
![\"Un](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/add-breakpoints.png\")
![\"Il](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/select-debug-browser.png\")
![\"Una](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/debugger-output.png\")
![\"Una](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/context-menu-debugger.png\")
Come Kinsta Vi Aiuta a Eseguire il Debug del Vostro Sito WordPress<\/h2>\n
WP_DEBUG<\/code> e altri strumenti, come Query Monitor<\/a>. Questi strumenti consentono di visualizzare messaggi di errore precedentemente nascosti in tutto il sito e nella bacheca. Da l\u00ec potrete iniziare a capire qual \u00e8 il problema.<\/p>\nWP_DEBUG_LOG<\/code>, che vi offre un modo per documentare i problemi del vostro sito. Abbiamo spiegato come configurarlo in un altro articolo del blog<\/a>. La configurazione \u00e8 semplice attraverso il cruscotto di MyKinsta<\/a> (e la schermata Siti > Strumenti<\/strong> ):<\/p>\n![\"Il](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/kinsta-dashboard-debug.png\")
WP_DEBUG<\/code> con un solo clic per ogni sito che create:<\/p>\n![\"Il](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/09\/devkinsta-debug.png\")
Scheda Informativa sui Comandi<\/h2>\n
\n\n
\n \nComando<\/th>\n Scorciatoia<\/th>\n<\/tr>\n<\/thead>\n \n Specificare la porta su cui ascoltare (per esempio [9003]<\/code>)<\/td>\n-p [value]<\/code><\/td>\n<\/tr>\n\n Impostare un punto di interruzione sulla riga specificata per il percorso del file indicato.<\/td>\n breakpoint_set -t line file:\/\/\/<path> -n <line><\/code><\/td>\n<\/tr>\n\n Eseguire lo script fino alla fine o al punto di interruzione successivo<\/td>\n run<\/code><\/td>\n<\/tr>\n\n Passare alla riga successiva dell’eseguibile<\/td>\n step_into<\/code><\/td>\n<\/tr>\n\n Elencare le variabili e i valori dell’ambito corrente<\/td>\n context_get<\/code><\/td>\n<\/tr>\n\n Visualizzare il valore della propriet\u00e0 specificata<\/td>\n property_get -n <property><\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n\n
\n