In breve: WordPress estensione PHP mancante: indica che WordPress, un plugin o un tema richiede un modulo che il processo PHP del sito non sta caricando.
Indice dei contenuti
Che cosa significa
PHP è composto da un nucleo e da estensioni che aggiungono funzioni per immagini, archivi ZIP, crittografia, XML, internazionalizzazione, database e comunicazioni di rete. WordPress core può funzionare con un insieme di moduli, mentre plugin e temi possono richiederne altri per specifiche funzioni.
Il messaggio relativo a WordPress estensione PHP mancante non dimostra sempre che il pacchetto sia assente dal server. Il modulo può essere installato ma non attivo per la versione PHP del dominio, può essere caricato da CLI ma non dal processo web oppure può fallire durante l’avvio per una dipendenza mancante.
Come riconoscere il problema
- Site Health segnala uno o più moduli PHP mancanti.
- un plugin mostra il messaggio required PHP extension missing.
- compare Call to undefined function dopo un cambio di versione PHP.
- il modulo risulta disponibile da CLI ma non dal sito.
- l’errore interessa un solo dominio o una sola versione PHP.
Registra il nome esatto dell’estensione e il file che genera l’errore. Messaggi generici come “modulo PHP mancante” non sono sufficienti: intl, mbstring, zip, curl, gd, imagick, sodium, soap e xml richiedono controlli differenti.
Cause più frequenti
1. Modulo non attivato per la versione PHP del dominio
Il dominio usa una versione PHP nella quale l’estensione richiesta non è stata abilitata, anche se lo stesso modulo è disponibile in un’altra versione installata sul server. Verifica questa ipotesi confrontando il risultato del processo web con quello della riga di comando e con la configurazione mostrata dal pannello. Non cambiare versione PHP o attivare moduli casualmente: una modifica non necessaria può introdurre incompatibilità aggiuntive.
2. Versione PHP diversa tra sito e riga di comando
WP-CLI, cron e browser possono utilizzare binari o handler differenti. Un controllo eseguito soltanto da shell può quindi mostrare un modulo che il processo web non carica.
3. Plugin o tema con requisiti non soddisfatti
Il componente richiede estensioni come intl, mbstring, zip, soap, gd, imagick, sodium o xml, ma il requisito non è stato verificato prima dell’installazione o dell’aggiornamento.
4. Configurazione per-directory non applicata
File.user.ini, selettori PHP o impostazioni del pannello possono riferirsi alla directory sbagliata, a un handler diverso oppure essere ancora soggetti alla cache della configurazione.
5. Estensione caricata con dipendenze mancanti
Il modulo esiste ma non viene inizializzato perché manca una libreria di sistema, una dipendenza condivisa o una configurazione necessaria; il log PHP può mostrare startup warning.
6. Cambio di handler o aggiornamento incompleto
Un passaggio tra LSAPI, PHP-FPM, CGI o un aggiornamento di pacchetti può lasciare processi attivi con una configurazione precedente o moduli non allineati.
Diagnosi passo per passo
- Identificare il nome esatto dell’estensione richiesta.
- Verificare la versione PHP effettiva usata dal dominio.
- Controllare i moduli caricati dal processo web.
- Confrontare browser, WP-CLI e cron.
- Leggere error log e PHP startup warning.
- Controllare i requisiti del plugin o del tema.
- Verificare configurazione e cache dell’handler PHP.
Controllare la versione PHP effettiva
La versione selezionata nel pannello deve coincidere con quella usata dal dominio. Un sottodominio, una directory protetta, un cron o WP-CLI possono seguire configurazioni differenti. Usa strumenti temporanei e rimuovili dopo la diagnosi: una pagina phpinfo pubblica espone dettagli che non devono restare accessibili.
Annota versione, Server API, percorso del file di configurazione caricato e directory aggiuntive analizzate. Questi dati permettono di capire se una modifica eseguita in MultiPHP Manager, PHP Selector o.user.ini raggiunge realmente il processo che esegue WordPress.
Verificare i moduli caricati
Controlla la presenza del modulo nel processo web e non soltanto da shell. Per alcune estensioni è utile verificare anche la funzione o la classe fornita, per esempio class_exists(), extension_loaded() o una funzione specifica. Il test deve essere rimosso appena concluso.
Quando il modulo compare nella configurazione ma non viene caricato, cerca warning di avvio PHP. Messaggi relativi a file condivisi, simboli non trovati o dipendenze mancanti indicano che l’estensione è stata richiesta ma non inizializzata correttamente.
Moduli richiesti più spesso
intl gestisce internazionalizzazione, formati e translitterazione. mbstring lavora con stringhe multibyte. zip è usata da importazioni, backup e pacchetti. gd e imagick elaborano immagini. sodium offre primitive crittografiche. xml, dom e simplexml servono per documenti strutturati e feed.
La presenza di un’alternativa non garantisce compatibilità. Un plugin può supportare GD o Imagick, mentre un altro può richiedere espressamente una classe specifica. Leggi sempre i requisiti del componente e il messaggio completo prima di decidere quale modulo attivare.
Gestione tramite cPanel
Quando disponibile, usa lo strumento previsto dal servizio per selezionare versione ed estensioni PHP. Verifica di operare sul dominio corretto e conserva uno screenshot o un elenco dello stato precedente. Dopo il salvataggio considera l’eventuale cache di.user.ini e dell’handler.
Non aggiungere manualmente righe extension= se il provider gestisce i moduli centralmente: indicare un file non presente o caricare due volte la stessa estensione può produrre warning e blocchi. La modalità corretta dipende dall’handler e dalla piattaforma.
Plugin, temi e compatibilità
Prima di attivare un modulo verifica che plugin e tema siano aggiornati e compatibili con la versione PHP in uso. Un componente obsoleto può segnalare come “mancante” una funzione rimossa o rinominata, oppure richiedere una libreria non disponibile nella versione scelta.
Esegui i test in staging quando il sito è critico. Dopo l’attivazione controlla frontend, wp-admin, cron, REST API, upload, elaborazione immagini, email e procedure di backup interessate dal modulo.
Procedura di risoluzione
- Attivare il modulo nella versione PHP corretta. Applica la correzione soltanto dopo aver identificato versione PHP, handler e requisito del componente. Conserva il valore precedente, ripeti il test originale e controlla nello stesso intervallo eventuali warning, fatal error e regressioni.
- Allineare PHP web, WP-CLI e cron quando necessario. Applica la correzione soltanto dopo aver identificato versione PHP, handler e requisito del componente. Conserva il valore precedente, ripeti il test originale e controlla nello stesso intervallo eventuali warning, fatal error e regressioni.
- Installare o ripristinare le dipendenze supportate. Applica la correzione soltanto dopo aver identificato versione PHP, handler e requisito del componente. Conserva il valore precedente, ripeti il test originale e controlla nello stesso intervallo eventuali warning, fatal error e regressioni.
- Aggiornare o sostituire il componente incompatibile. Applica la correzione soltanto dopo aver identificato versione PHP, handler e requisito del componente. Conserva il valore precedente, ripeti il test originale e controlla nello stesso intervallo eventuali warning, fatal error e regressioni.
- Correggere.user.ini o selettore PHP del dominio. Applica la correzione soltanto dopo aver identificato versione PHP, handler e requisito del componente. Conserva il valore precedente, ripeti il test originale e controlla nello stesso intervallo eventuali warning, fatal error e regressioni.
- Riavviare soltanto l’handler interessato dopo la modifica. Applica la correzione soltanto dopo aver identificato versione PHP, handler e requisito del componente. Conserva il valore precedente, ripeti il test originale e controlla nello stesso intervallo eventuali warning, fatal error e regressioni.
- Ritestare WordPress e controllare i log. Applica la correzione soltanto dopo aver identificato versione PHP, handler e requisito del componente. Conserva il valore precedente, ripeti il test originale e controlla nello stesso intervallo eventuali warning, fatal error e regressioni.
Domande frequenti
Cosa significa che un’estensione PHP richiesta da WordPress non è disponibile?
Significa che il processo PHP usato dal sito non sta caricando il modulo o la funzione richiesta da WordPress, da un plugin o da un tema. La disponibilità può differire tra versioni PHP, dominio, cron e riga di comando.
Come verificare quale estensione PHP manca realmente?
Identifica il nome esatto del modulo, controlla la versione PHP effettiva del dominio e verifica i moduli caricati dal processo web, non soltanto da shell. Poi confronta i requisiti del componente che ha generato l’errore.
Guide Xlogic correlate
- WordPress Fatal error Class not found
- WordPress errore connessione sicura a WordPress.org
- WordPress failed to open stream: No such file or directory