Strumenti di debug nativi di WordPress che non richiedono un IDE

Se ti è appena capitato di iscriverti al sito e stai perseguendo contenuti specifici per The Independent WordPress Developer, ti consiglio di leggere il post precedente, almeno, per prepararti ai contenuti di questo post.

Se, tuttavia, stai cercando di recuperare il ritardo sull’articolo precedente, ecco un breve elenco di tutto ciò che è stato scritto finora:

1. Sviluppo locale per lo sviluppatore WordPress indipendente
2. Database e strumenti per lo sviluppatore WordPress indipendente
3. Installazione di WordPress per lo sviluppo locale

Mentre ci prepariamo a parlare di argomenti più avanzati come il debug e gli IDE, vale innanzitutto la pena notare gli strumenti che abbiamo a disposizione che possiamo installare all’interno di WordPress che ci aiuteranno con i problemi di debug durante lo sviluppo.

Inoltre, questi problemi non sono correlati a problemi strettamente PHP. Questi includono anche problemi con JavaScript. E per fare un ulteriore passo avanti, ci sono modi in cui possiamo configurare WordPress in modo nativo in modo che generi errori direttamente nel nostro browser.

Quindi, prima di esaminare i registri degli errori, gli IDE, Xdebug e così via, daremo un’occhiata a cosa possiamo fare all’interno di WordPress stesso.

Strumenti di debug nativi di WordPress

Gli strumenti di debug nativi di WordPress sono una combinazione di due cose:

1. le opzioni che possiamo impostare nel file di configurazione di WordPress che ci consentono di vedere le informazioni scritte sullo schermo,
2. diversi plugin che ci aiuteranno a lavorare con i file PHP e JavaScript dall’area di amministrazione di WordPress

Per il secondo punto sopra, voglio essere chiaro che ci sono molti plugin disponibili per qualcosa del genere; tuttavia, voglio mantenere l’installazione il più snella possibile in modo da non essere inondati di troppe informazioni.

Invece, voglio che abbiamo le informazioni di cui abbiamo bisogno per testare e valutare il nostro lavoro, ma che abbiamo solo ciò di cui abbiamo bisogno. Almeno per ora. Forse parleremo di argomenti avanzati nei post futuri.

Detto questo, iniziamo.

Configurazione WordPress

Prima di preoccuparsi della configurazione, WordPress stesso fornisce alcune opzioni diverse che possiamo configurare nel wp-config.phpfile. Questi sono ben documentati nel Codex, ma so per esperienza di e-mail di altri che le informazioni possono essere un po’ difficili da vagliare.

Innanzitutto, è importante notare quanto segue (come citato dal codice di WordPress):

WP_DEBUG è una costante PHP (una variabile globale permanente) che può essere utilizzata per attivare la modalità "debug" in WordPress. Si presume che sia false per impostazione predefinita e di solito è impostato su true nel file wp-config.php sulle copie di sviluppo di WordPress.

Questo presuppone che tu capisca le costanti PHP. In caso contrario, controlla il manuale qui (è piuttosto semplice). Il corto è il seguente:

Una costante è un identificatore (nome) per un valore semplice.

Quindi farò il possibile per fornire le opzioni di configurazione il più distillate possibile.

Innanzitutto, nel wp-config.phpfile, vorrai cambiare la riga che dice:

<?php
define( 'WP_DEBUG', false );

A questo :

<?php
define( 'WP_DEBUG', true );

Non è tutto, però. Ci sono alcune altre cose da aggiungere che miglioreranno l’esperienza di debug:

<?php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );

Se stai seguendo nel Ma cosa significa ogni riga? Ecco la spiegazione succinta che posso dare in questo momento:

• WP_DEBUG. Questo visualizzerà tutti gli errori e gli avvisi generati da PHP durante l’esecuzione di WordPress. L’esecuzione dell’applicazione da sola non dovrebbe mostrare alcun problema; tuttavia, eseguirlo insieme a vari plug-in potrebbe essere una storia diversa a seconda della qualità del plug-in.
• WP_DEBUG_LOG. Questa è una delle mie costanti preferite e scrive tutto l’output nel registro in modo dettagliato. Tratterò questo in un prossimo post ma, per ora, sappi che questo è qualcosa che penso dovrebbe essere sempre impostato nel tuo ambiente di sviluppo.
• WP_DEBUG_DISPLAY. Questo è uno che puoi impostare su true o false (anche se preferisco true). Completa l’impostazione precedente consentendoti di vedere i messaggi nel browser che vengono scritti anche nel blog. Non so se questo è qualcosa che troverai utile o meno. Se non sei pronto a esaminare le tracce dello stack e informazioni più dettagliate, potresti prendere in considerazione l’impostazione di questo su true.
• dislay_errors. Il Codex menziona che puoi impostare questo valore su false, ma penso che dovrebbe essere impostato su true per abilitare gli errori e gli avvisi.
• SCRIPT_DEBUG. Il core di WordPress utilizza versioni ridotte di file CSS e JavaScript. La disattivazione di questa impostazione ti consentirà di visualizzare tutto il contenuto dei file nella forma originale. Ciò è particolarmente utile se intendi contribuire a Core o lavorare su JavaScript incluso in Core.
• SAVEQUERIE. Questa è un’impostazione leggermente più avanzata, secondo me. In breve, prenderà tutte le query eseguite sul database e le salverà in un array PHP che potrai analizzare in seguito. Esso

Ora che abbiamo coperto la configurazione di WordPress, che dire dei plugin?

Plugin per il debug

Quando dico che il repository è pieno di plugin per questo, lo intendo. In effetti, se sei nuovo nello sviluppo di WordPress, non consiglierei di cercare cose da installare.

Può diventare rapidamente opprimente, rischiare di non capire cosa fanno alcuni di loro e potenzialmente portarti lungo un percorso in cui finisci per interrompere la tua installazione.

Invece di farlo, ti consiglio di dare un’occhiata ai seguenti plugin (leggendo prima la loro descrizione, ovviamente) e poi da lì:

1. Barra di debug. Questo plug-in da solo aggiunge un menu alla barra di amministrazione che ti consentirà di visualizzare la query, la cache e altre informazioni. Richiede che WP_DEBUG e SAVEQUERIES come descritto sopra siano abilitati.
2. Debug Bar List Script e dipendenze stile. Questo è un componente aggiuntivo del plug-in di cui sopra che ti consentirà di eseguire il debug di ulteriori stili JavaScript e CSS in esecuzione nel contesto di WordPress.
3. Console della barra di debug. Questo plugin è uno che dovresti usare con esitazione. Per lo meno, ti consente di eseguire PHP e MySQL dall’interno di WordPress stesso. Non consiglio questo plugin a meno che tu non sia molto a tuo agio con una delle due lingue. Tuttavia, se lo sei, questo è qualcosa che può essere potente per la prototipazione di una funzione o di una query prima di integrarla nel tuo plug-in.

Esame dei registri degli errori

Nel prossimo post, inizieremo a esaminare ciò che è necessario per esaminare il registro degli errori generato da WordPress e come comprendere le informazioni che vediamo.

Inoltre, esamineremo ciò che è necessario per utilizzare i plug-in descritti in questo post. Successivamente, passeremo a strumenti ancora più avanzati.

Ma un passo alla volta, giusto?

Per ora, tuttavia, configura la tua installazione come descritto sopra, installa i plug-in collegati e quindi fai il possibile per esplorare come funzionano, cosa potresti vedere sullo schermo e come questo può avere un impatto e un beneficio positivo sul tuo sviluppo.

Sì, potrebbe esserci un po’ di una curva di apprendimento. Ma è per questo che stiamo andando così piano. C’è molto da imparare e abbiamo tutto il tempo per coprire tutto il terreno necessario.