Le estensioni PHP aggiungono funzionalità supplementari a PHP. Applicazioni come WordPress, WooCommerce o altri sistemi PHP possono richiedere determinate estensioni affinché singole funzioni lavorino correttamente.
Le estensioni PHP tipiche sono ad esempio curl, internazionale, mbstring, mysqli, cerniera o buon giorno.
In CURIAWEB-cPanel trovi diversi strumenti relativi a PHP. A tale proposito è importante distinguere tra quella consigliata da CURIAWEB Ambiente PHP MultiPHP/EasyApache e per distinguerlo dal CloudLinux PHP Selector aggiuntivo presente.
Raccomandazione CURIAWEB: Per la versione PHP di un sito web utilizzi fondamentalmente il MultiPHP-Manager. Non passare a un'altra gestione di PHP solo perché un'applicazione richiede una determinata estensione PHP.
Che cos'è un'estensione PHP? #
PHP fornisce già numerose funzioni di base. Ulteriori estensioni arricchiscono il linguaggio di ulteriori funzionalità.
Ad esempio, un'applicazione potrebbe richiedere funzionalità per:
- Connessioni al database
- Elaborazione delle immagini
- Archivio ZIP
- connessioni crittografate
- elaborazione internazionale di caratteri e linguaggi
- Elaborazione XML
- Connessioni HTTP o API
A questo scopo vengono utilizzate diverse estensioni PHP.
Estensioni PHP tipiche #
| Estensione | Compito tipico |
|---|---|
curl | Comunicazione con altri server e servizi Web |
buon giorno | Elaborazione delle immagini |
internazionale | Internazionalizzazione, lingua, formati di numeri e date |
mbstring | Elaborazione di codifiche di caratteri multibyte |
mysqli | Connessione a database MySQL/MariaDB |
openssl | Funzioni crittografiche e comunicazione cifrata |
cerniera | Elaborazione di archivi ZIP |
xml | Elaborazione di dati XML |
Questa tabella non è un elenco completo. Quali estensioni sono disponibili e attivate dipende dalla rispettiva versione di PHP e dalla configurazione del server.
L'estensione PHP e la versione di PHP sono due cose diverse #
Una versione di PHP e un'estensione di PHP non devono essere confuse tra loro.
In sintesi:
Versione PHP
→ ambiente di esecuzione PHP
Estensione PHP
→ funzione aggiuntiva all'interno di questo ambiente PHPSe ad esempio un'applicazione richiede PHP in una versione minima specifica e inoltre internazionale richiesto, devono essere soddisfatti entrambi i requisiti.
CURIAWEB utilizza MultiPHP per le versioni PHP #
Per la selezione della versione PHP di un dominio CURIAWEB raccomanda:
Software → MultiPHP Manager
Lì stabilisci quale delle versioni PHP disponibili utilizza il tuo sito web.
Puoi trovare la guida completa su Modificare la versione di PHP in cPanel.
Perché c'è anche „Seleziona versione PHP“? #
In CURIAWEB-cPanel trovi sotto Software inoltre l'area Scegli la versione PHP. Questo appartiene alla gestione PHP di CloudLinux e fornisce un ambiente PHP dedicato con opzioni di configurazione aggiuntive.
Tuttavia, ciò non significa che dovresti usare contemporaneamente il MultiPHP Manager e il CloudLinux PHP Selector per un sito web.
Importante: MultiPHP/EasyApache e il CloudLinux PHP Selector sono gestioni PHP differenti. Non dovresti considerare automaticamente le impostazioni di un ambiente come le impostazioni dell'altro ambiente.
Non cambiare la gestione di PHP a causa di un'estensione #
Se un'applicazione segnala che, ad esempio:
internazionale
o:
cerniera
manca, non dovresti cambiare la gestione PHP come primo passaggio.
Verifica prima:
- quale versione di PHP il sito web sta effettivamente utilizzando
- quale estensione sia specificamente richiesta
- se l'estensione sia già disponibile nell'ambiente PHP utilizzato
- se il messaggio di errore sia effettivamente attuale
1. Controllare la versione di PHP utilizzata #
Apri nel cPanel di CURIAWEB:
Software → MultiPHP Manager
Cerca il dominio in questione e controlla la versione di PHP assegnata.
Prendi nota della versione utilizzata.
Consiglio pratico: Prima di cercare un'estensione PHP presumibilmente mancante, dovresti sempre sapere quale versione di PHP sta effettivamente utilizzando il sito Web interessato.
2. Leggere attentamente il messaggio di errore dell'applicazione #
Se un'applicazione segnala un'estensione PHP mancante, annotane il nome esatto.
Un messaggio potrebbe, ad esempio, indicare implicitamente che una determinata estensione non è disponibile.
L'importante è il nome specifico come:
internazionale
mbstring
cerniera
o:
curl
Non modificare diverse componenti PHP alla cieca.
3. Verificare se il messaggio riguarda effettivamente un'estensione PHP #
Non ogni messaggio di errore PHP indica un'estensione mancante.
Un'applicazione può fallire, ad esempio, anche a causa dei seguenti motivi:
- versione PHP non supportata
- limite di memoria PHP troppo basso
- permessi del file mancanti
- Errore di programmazione
- funzione PHP mancante
- errata configurazione dell'applicazione
Verifica quindi il testo del messaggio di errore prima di modificare la configurazione PHP.
4. Controllare il registro degli errori in caso di errori PHP imprecisi #
Se il sito web mostra semplicemente un errore generico, il registro degli errori potrebbe contenere informazioni più dettagliate.
Un messaggio di errore PHP può contenere, ad esempio, indicazioni su una funzione o una classe inesistente.
Ti spieghiamo come utilizzare il registro degli errori su Leggere il log degli errori di cPanel e trovare gli errori del sito web.
Tipico avviso di un'estensione mancante #
A seconda dell'applicazione e dell'estensione, i messaggi possono ad esempio indicare che una classe o una funzione richiesta non è presente.
Un tale errore deve essere valutato nel rispettivo contesto.
Il nome di una funzione mancante può spesso fornire un'indicazione su quale estensione PHP appartenga.
Importante: Non installare o attivare semplicemente un'estensione basandoti su una singola parola in un messaggio di errore. Verifica prima i requisiti dell'applicazione utilizzata.
Verifica i requisiti di sistema dell'applicazione #
Quando installi un CMS, un plugin, un tema o qualsiasi altra applicazione PHP, verifica i relativi requisiti di sistema ufficiali.
Lì possono esserci, ad esempio, requisiti come:
PHP: versione minima richiesta
Estensione: intl
Estensione: mbstring
Estensione: zipCiò ti consente di distinguere se l'applicazione richiede obbligatoriamente un'estensione o se la consiglia semplicemente per una funzionalità opzionale.
Distinguere tra obbligo e raccomandazione #
I produttori di software a volte fanno una distinzione tra:
- estensioni PHP strettamente necessarie
- estensioni PHP consigliate
- Estensioni per singole funzioni opzionali
Se manca un'estensione facoltativa, questo non significa necessariamente che l'intero sito web debba guastarsi.
Estensione PHP nell'ambiente MultiPHP #
Nell'ambiente MultiPHP/EasyApache consigliato da CURIAWEB, le estensioni PHP vengono fornite lato server per le rispettive versioni di PHP.
Il MultiPHP Manager stesso è pensato principalmente per l'associazione della versione PHP al dominio.
Non è un pannello di controllo in cui puoi attivare e disattivare a piacimento le estensioni PHP di EasyApache per un singolo dominio.
Breve spiegazione: Nel MultiPHP Manager scegli la versione PHP del tuo dominio. I moduli forniti per questo ambiente PHP vanno distinti da essa.
Cosa fare se manca un'estensione necessaria? #
Se il tuo sito utilizza MultiPHP e un'estensione PHP richiesta non è effettivamente disponibile, non dovresti provare ad attivarla contemporaneamente tramite un altro strumento di gestione PHP.
Nota invece:
- dominio interessato
- versione PHP utilizzata
- Nome dell'estensione richiesta
- applicazione utilizzata
- messaggio di errore preciso
Contatta successivamente il supporto di CURIAWEB per verificare se l'estensione è disponibile nell'ambiente PHP in questione o se è prevista lato server.
Perché non posso installare le estensioni di EasyApache da solo? #
EasyApache gestisce i componenti centrali dell'ambiente Apache e PHP del server. In un account di hosting condiviso, un singolo utente cPanel non possiede i diritti amministrativi per installare pacchetti EasyApache a livello di server a propria discrezione.
Questo è voluto: le modifiche all'ambiente PHP centrale possono riguardare più account di hosting o siti web.
Le estensioni PHP dipendono dalla versione #
Un'estensione PHP appartiene sempre a un determinato ambiente PHP o a una specifica versione di PHP.
In sintesi:
Versione PHP A
→ moduli PHP personalizzati
Versione PHP B
→ moduli PHP personalizzatiIl fatto che un'estensione sia disponibile per una versione di PHP non significa quindi automaticamente che ogni altra versione di PHP installata possieda esattamente la stessa configurazione dei moduli.
Non cambiare inutilmente la versione di PHP per mantenere un modulo #
Se manca un'estensione necessaria per una determinata versione di PHP, non dovresti provare a caso diverse versioni di PHP.
Un cambio di versione può avere ripercussioni sull'intera applicazione.
Verifica prima i requisiti del software e la configurazione PHP effettivamente prevista.
Distinguere tra estensioni PHP e impostazioni PHP #
Un'estensione come:
internazionale
è qualcosa di diverso da una direttiva PHP come:
limite di memoria
In sintesi:
estensione PHPLe impostazioni PHP su CURIAWEB si gestiscono tramite il MultiPHP INI-Editor.
Distinguere tra estensioni PHP e limiti PHP #
Anche i limiti PHP come:
memory_limit
upload_max_filesize
post_max_size
max_execution_timenon sono estensioni PHP.
Se un'applicazione segnala ad esempio un errore di memoria, l'attivazione di estensioni aggiuntive di solito non è d'aiuto.
Spieghiamo i principali limiti di PHP su Imposta limite di memoria PHP, dimensione di caricamento e tempo di esecuzione.
cURL #
L'estensione PHP curl consente alle applicazioni PHP di comunicare con altri servizi tramite i protocolli di rete supportati.
Ad esempio, è spesso necessaria quando un sito Web si interfaccia con API o altri servizi Web esterni.
Se un'applicazione non è in grado di stabilire una connessione con un servizio esterno, ciò non significa tuttavia automaticamente che curl manca.
Anche il DNS, i certificati, le credenziali di accesso, il servizio esterno o l'applicazione stessa possono essere la causa.
internazionale #
L'estensione internazionale fornisce funzionalità per l'internazionalizzazione.
Ciò include, tra le altre cose, funzioni per l'elaborazione dipendente dalla lingua e dalla regione.
Alcune applicazioni o librerie richiedono internazionale espressamente previsto.
mbstring #
mbstring fornisce funzioni per l'elaborazione di codifiche di caratteri multibyte.
Ciò è particolarmente rilevante per testi e set di caratteri in cui un carattere non è necessariamente composto da un solo byte.
mysqli #
mysqli fornisce funzioni per la comunicazione di PHP con sistemi di database compatibili con MySQL.
Se un'applicazione PHP basata su database non dispone di un'estensione del database richiesta, potrebbe non essere in grado di connettersi al database.
Un errore di connessione al database, tuttavia, non significa automaticamente che mysqli manca. Anche credenziali di accesso errate o una configurazione errata del database potrebbero esserne la causa.
cerniera #
L'estensione cerniera consente alle applicazioni PHP di lavorare con gli archivi ZIP.
Può essere richiesta, ad esempio, per le funzioni di installazione, importazione, esportazione o backup di un'applicazione.
Se tuttavia la decompressione di un archivio non va a buon fine, la causa potrebbe anche essere un file ZIP danneggiato, spazio di archiviazione insufficiente o altri errori.
buon giorno #
L'estensione buon giorno fornisce funzioni per l'elaborazione delle immagini.
Le applicazioni Web possono utilizzarle, ad esempio, per ridimensionare immagini o eseguire altre operazioni sulle immagini.
Quali formati di immagine e funzioni siano supportati dipende dalla specifica configurazione PHP/GD.
Non equiparare Imagick e GD #
Nell'elaborazione delle immagini potresti anche incontrare:
Imagick
Imagick e GD sono estensioni diverse, ovvero sistemi di elaborazione delle immagini.
Se un'applicazione richiede espressamente Imagick, la presenza di un'estensione GD non significa automaticamente che tale requisito sia soddisfatto.
openssl #
Il supporto a OpenSSL è richiesto da numerose applicazioni PHP per funzioni crittografiche e comunicazione crittografata.
Un problema HTTPS di un sito web non è tuttavia automaticamente un problema dell'estensione PHP openssl.
I certificati SSL del server web e le funzioni PHP OpenSSL sono livelli tecnici differenti.
Estensioni XML #
PHP possiede diverse funzioni ed estensioni per l'elaborazione di XML.
Ad esempio, un'applicazione può richiedere determinati componenti XML.
Se un software specifica un nome di modulo concreto, dovresti verificare esattamente quello e non limitarti a dare per scontato che „qualcosa che ha a che fare con XML“ sia sufficiente.
PDO e driver di database #
Molte applicazioni PHP usano PDO per l'accesso al database.
A tal fine, oltre a PDO stesso, potrebbe essere necessario un driver di database appropriato.
Un messaggio come:
Impossibile trovare il driver
può ad esempio indicare che il driver PDO richiesto per il database utilizzato non è disponibile.
Il messaggio di errore esatto e la configurazione dell'applicazione devono essere considerati insieme.
Cosa significa „Call to undefined function“? #
Un messaggio di errore PHP può contenere, ad esempio:
Chiamata a funzione non definita ...
Ciò significa che PHP non conosce la funzione chiamata nell'ambiente corrente.
Una possibile causa è un'estensione mancante. Tuttavia, potrebbero esserci anche altre cause, ad esempio codice applicativo errato.
Verifica quindi a quale componente appartiene la funzione citata.
Che cosa significa „Class not found“? #
Un messaggio come:
Classe ... non trovata
non dimostra automaticamente che manchi un'estensione PHP.
La classe potrebbe ad esempio diventare:
- di un'estensione PHP
- di una libreria di programmazione
- un plugin
- un tema
- codice applicativo personalizzato
appartenere.
Perciò la precisa denominazione della classe è fondamentale.
WordPress ed estensioni PHP #
WordPress richiede o consiglia determinate estensioni PHP per diverse funzioni. Inoltre, plugin e temi possono avere requisiti propri.
Se un plugin di WordPress segnala un'estensione mancante, dovresti quindi verificare se il requisito proviene dal core di WordPress o esclusivamente dal plugin in questione.
WooCommerce ed estensioni #
WooCommerce sowie Zahlungs-, Versand-, Import- und andere Erweiterungen können zusätzliche PHP-Funktionen verwenden.
Proprio nel caso di installazioni WordPress più complesse, i requisiti dei singoli plugin possono quindi superare i requisiti di base di WordPress.
In caso di messaggio di errore, controlla sempre la documentazione dell'estensione specifica interessata.
Applicazioni Composer ed estensioni PHP #
Le applicazioni PHP che utilizzano Composer possono definire le estensioni richieste come dipendenze.
Durante l'installazione o l'aggiornamento, Composer può quindi indicare, ad esempio, che un determinato ext-...-Manca la dipendenza.
Una segnalazione può, ad esempio, riguardare:
ext-intl
o:
ext-zip
rimandare.
Il prefisso est- indica in questo contesto un'estensione PHP richiesta.
Non aggirare facilmente il controllo di Composer #
Quando Composer segnala un'estensione PHP richiesta, non dovresti ignorare o aggirare il requisito senza prima verificarlo.
L'applicazione potrebbe effettivamente aver bisogno dell'estensione per la sua funzionalità.
Attenzione: Aggirare un controllo delle dipendenze non rende disponibile una funzione PHP mancante. Verifica invece perché l'applicazione richiede l'estensione.
Estensione PHP apparentemente scomparsa dopo il cambio di versione #
Se un'applicazione segnala improvvisamente un'estensione mancante subito dopo un cambio di versione di PHP, dovresti considerare il contesto.
Verifica:
- precedente versione di PHP
- nuova versione di PHP
- nome esatto dell'estensione
- se l'applicazione è supportata con la nuova versione di PHP
Se necessario, puoi ripristinare la versione precedente di PHP tramite il MultiPHP Manager, a condizione che tale versione sia ancora disponibile.
Non assumere subito che la causa siano più estensioni #
Se, a seguito di un cambio di versione di PHP, un sito web non funziona, la prima cosa da fare è esaminare il messaggio di errore specifico.
Un cambio di versione di PHP può causare incompatibilità anche nel codice dell'applicazione, sebbene siano presenti tutte le estensioni richieste.
Non configurare CloudLinux PHP Selector in parallelo #
L'area visibile in cPanel Scegli la versione PHP può offrire opzioni di scelta personali per versioni PHP, estensioni e impostazioni.
Tuttavia, se il tuo sito web è gestito tramite MultiPHP/EasyApache in base alla raccomandazione di CURIAWEB, non dovresti cercare di „integrare“ un'estensione MultiPHP mancante lì con impostazioni parallele nel PHP Selector.
Importante: Un'estensione che attivi all'interno di un altro ambiente PHP non diventa automaticamente parte della versione PHP MultiPHP/EasyApache utilizzata dal tuo sito web.
I pacchetti PEAR non sono la stessa cosa delle estensioni PHP #
In CURIAWEB-cPanel trovi inoltre la sezione Pacchetti PHP-PEAR.
I pacchetti PEAR non sono compatibili con le estensioni PHP lato server come internazionale, curl o mysqli equiparare.
Pertanto, se un'applicazione richiede un'estensione PHP, non dovresti cercare di soddisfare tale requisito installando un pacchetto PEAR qualsiasi.
Anche i moduli Perl sono un'altra cosa #
Anche la sezione cPanel Moduli Perl non appartiene alla gestione delle estensioni PHP.
PHP e Perl sono diversi ambienti di esecuzione o linguaggi di programmazione.
Posso caricare autonomamente un'estensione PHP? #
Un'estensione PHP lato server non può essere attivata caricando un qualsiasi file di modulo nella directory del tuo sito web.
Le estensioni PHP devono corrispondere alla versione di PHP e all'ambiente del server utilizzati e devono essere integrate di conseguenza nel runtime di PHP.
Attenzione: Non caricare moduli PHP compilati sconosciuti da Internet nel tuo account di hosting e non tentare di integrarli manualmente nella configurazione PHP del server.
Non confondere l'estensione PHP con un plugin di WordPress #
Anche un plugin per WordPress e un'estensione PHP sono due cose completamente diverse.
In sintesi:
Estensione PHPUn plugin di WordPress può richiedere un'estensione PHP, ma non può installarla automaticamente come modulo PHP lato server.
Testare il sito web dopo una modifica #
Se è stata fornita una estensione PHP richiesta o se è stata modificata la configurazione di PHP, testa attentamente la funzione che ha precedentemente generato l'errore.
Per esempio:
Installazione del plugin non riuscita
→ Testare nuovamente l'installazione
Funzione API difettosa
→ Testare nuovamente la connessione interessata
Elaborazione ZIP non riuscita
→ Eseguire nuovamente la stessa operazioneEcco come puoi verificare se l'estensione è stata effettivamente la causa.
L'errore persiste nonostante la presenza dell'estensione #
Se l'estensione necessaria è presente e l'applicazione continua a segnalare un errore, non dovresti dare per scontato che manchino altre estensioni PHP.
Controlla invece:
- messaggio di errore preciso
- Versione PHP
- Versione dell'applicazione
- Impostazioni PHP
- Limiti PHP
- Configurazione dell'applicazione
- Registro degli errori
Estensioni PHP dopo il trasferimento del sito web #
Durante il cambio di hosting, l'ambiente PHP potrebbe differire da quello del server precedente.
Un sito web più vecchio o configurato individualmente potrebbe aver utilizzato un'estensione precedentemente installata in aggiunta sul server precedente.
Se un sito Web mostra un errore PHP dopo un trasferimento, per la diagnosi sono necessari anche la versione di PHP utilizzata e le estensioni richieste.
Documentare i requisiti prima di un trasloco #
Per le applicazioni PHP sviluppate su misura, è utile conoscere i requisiti tecnici prima di effettuare un cambio di server.
A ciò appartengono, ad esempio:
- Versione PHP
- estensioni PHP richieste
- Impostazioni PHP
- Requisiti del database
- Cronjob
- ulteriori dipendenze lato server
Ciò consente di verificare l'ambiente di destinazione prima dell'effettivo passaggio.
Procedura consigliata in caso di segnalazione di un'estensione PHP mancante #
- Prendi nota del messaggio di errore completo.
- Prendi nota del nome dell'estensione presumibilmente mancante.
- Verifica i requisiti di sistema dell'applicazione.
- Apri Software → MultiPHP Manager.
- Controlla la versione PHP del dominio interessato.
- Verifica se l'applicazione supporta questa versione di PHP.
- Fai una distinzione tra estensione PHP, impostazione PHP e limite PHP.
- In caso di errori poco chiari, controlla il registro degli errori.
- Non passare a casaccio tra diverse gestioni PHP.
- Contatta il supporto se un'estensione necessaria manca effettivamente nell'ambiente MultiPHP utilizzato.
- Dopo una modifica, testa nuovamente con precisione la funzione precedentemente difettosa.
Risoluzione dei problemi consigliata dopo un cambio di versione di PHP #
- Verifica se l'errore è sorto immediatamente dopo il cambio di versione.
- Prendere nota della versione precedente e di quella attuale di PHP.
- Controlla il messaggio di errore specifico.
- Controlla se viene effettivamente menzionata un'estensione.
- Verifica i requisiti dell'applicazione interessata.
- Se necessario, passa temporaneamente alla versione PHP precedente per effettuare un test.
- Il sito web funziona di nuovo, verifica la compatibilità del nuovo ambiente PHP.
- Non attivare estensioni aggiuntive in modo casuale.
Regola fondamentale: Una mancata estensione PHP dovrebbe essere determinata in base a un requisito specifico o a un messaggio di errore. Controllare la versione di PHP, identificare l'estensione e mantenere pulito l'ambiente PHP utilizzato, senza mescolare diverse gestioni di PHP.
Quando dovresti contattare il supporto di CURIAWEB? #
Se un'applicazione richiede tassativamente un'estensione PHP e questa non è disponibile nell'ambiente MultiPHP/EasyApache utilizzato dal tuo dominio, potrebbe essere necessario un controllo lato server.
Per l'analisi sono particolarmente utili le seguenti indicazioni:
- dominio interessato
- versione PHP utilizzata
- Nome dell'estensione PHP richiesta
- applicazione utilizzata o CMS
- plugin o tema interessato, se pertinente
- messaggio di errore completo
- da quando esiste il problema
- se in precedenza sia stata modificata la versione di PHP o sia stato eseguito il migration del sito web
Non trasmettere password o altri dati di accesso riservati.
Riepilogo #
Le estensioni PHP aggiungono funzionalità supplementari a PHP. Le applicazioni possono, ad esempio, curl, internazionale, mbstring, mysqli, cerniera o richiedono altre estensioni.
CURIAWEB raccomanda fondamentalmente per la versione PHP di un sito web MultiPHP/EasyApache. Puoi gestire la versione PHP tramite Software → MultiPHP Manager.
L'area CloudLinux aggiuntiva visibile Scegli la versione PHP costituisce una gestione PHP separata. Non utilizzarlo in parallelo per integrare presunte estensioni mancanti di un sito web MultiPHP.
Se un'applicazione segnala un'estensione mancante, verifica prima la versione di PHP utilizzata, il nome esatto dell'estensione e i requisiti ufficiali dell'applicazione. Distingui in questo caso tra estensioni PHP, impostazioni PHP e limiti PHP.
Se un'estensione strettamente necessaria manca effettivamente nell'ambiente MultiPHP/EasyApache utilizzato, si dovrebbe verificare se può essere fornita lato server per questa versione di PHP.
La regola più importante è: Non attivare a caso moduli PHP o diversi sistemi PHP: stabilire prima quale estensione sia effettivamente necessaria a quale applicazione sotto quale versione di PHP.
