Limiti PHP: upload_max_filesize, post_max_size e timeout

Quando WordPress mostra “Il file supera la dimensione massima”, un’importazione si interrompe o una richiesta va in timeout, aumentare un solo valore può non bastare. Esistono inoltre limiti dell’applicazione, del web server, del proxy e del piano hosting.

Questa guida spiega upload_max_filesize, post_max_size e max_execution_time e mostra come modificarli senza scegliere valori eccessivi. La relazione upload_max_filesize post_max_size è il primo controllo da effettuare.

Significato delle principali direttive

I valori della tabella sono esempi, non impostazioni universali. Usa il minimo necessario per l’operazione e rispetta i limiti del piano.

Relazione tra upload_max_filesize e post_max_size

post_max_size deve essere superiore a upload_max_filesize, perché la richiesta contiene anche campi, intestazioni e talvolta più file.

Esempio per un file massimo di 64 MB:

upload_max_filesize = 64M
post_max_size = 72M

Se carichi più file nella stessa richiesta, la somma può superare post_max_size anche quando ogni file rispetta upload_max_filesize.

memory_limit deve essere maggiore del file?

Non esiste una formula unica. Uno script può salvare il file senza caricarlo interamente in memoria oppure può decomprimerlo, analizzarlo e crearne più copie. Immagini, ZIP, XML, CSV, PDF e fogli di calcolo possono richiedere molta più memoria della dimensione sul disco.

Impostare memory_limit uguale a upload_max_filesize non garantisce l’elaborazione. Osserva l’errore reale e aumenta con prudenza.

max_execution_time e max_input_time

max_input_time riguarda il tempo impiegato da PHP per ricevere e analizzare i dati di input. max_execution_time riguarda l’esecuzione dello script, con differenze possibili in base a sistema operativo e modalità PHP.

Un upload lento può inoltre essere interrotto da:

• timeout del browser o della rete;
• proxy e CDN;
• web server;
• applicazione;
• firewall;
• limite del processo PHP;
• operazione successiva al caricamento.

Aumentare max_execution_time non risolve automaticamente un timeout Cloudflare 524 o un limite imposto da un altro livello.

Come modificare i limiti PHP in cPanel

Metodo 1: Select PHP Version e scheda Options

1. apri cPanel → Software → Select PHP Version;
2. verifica che sia selezionata la versione PHP effettivamente usata dal sito;
3. apri la scheda Options;
4. individua la direttiva da modificare;
5. scegli uno dei valori consentiti dall’interfaccia;
6. salva oppure attendi la conferma del salvataggio automatico;
7. controlla il valore effettivo nell’applicazione e ripeti il test.

I valori disponibili nella scheda Options rappresentano quelli consentiti dalla configurazione Xlogic. Non è possibile superare eventuali limiti massimi del server o del piano. Queste opzioni PHP non aumentano CPU, memoria fisica, I/O, processi o Entry Processes dell’account CloudLinux.

Metodo 2: MultiPHP INI Editor

Usa MultiPHP INI Editor quando il dominio è gestito da EA-PHP tramite MultiPHP Manager, oppure quando PHP Selector mostra native e le opzioni CloudLinux non sono applicate.

1. apri cPanel → Software → MultiPHP INI Editor;
2. seleziona il dominio corretto;
3. usa Basic Mode quando la direttiva è disponibile;
4. modifica un valore alla volta;
5. salva;
6. controlla il risultato nell’applicazione.

Editor Mode modifica direttamente le direttive e richiede maggiore attenzione. Un errore di sintassi può impedire l’applicazione delle impostazioni. Non configurare lo stesso parametro con valori differenti sia in Select PHP Version sia in MultiPHP INI Editor.

Metodo .user.ini

Quando previsto dalla configurazione PHP, un file .user.ini nella directory del sito può contenere:

upload_max_filesize = 64M
post_max_size = 72M
memory_limit = 256M
max_execution_time = 120
max_input_time = 120

Non creare contemporaneamente valori diversi in PHP Selector, MultiPHP INI Editor, .user.ini e wp-config.php. La presenza di più livelli rende difficile sapere quale prevale.

Come verificare i valori effettivi

In WordPress consulta Strumenti → Salute del sito → Informazioni → Server e Gestione media per il limite di upload mostrato. Il valore visualizzato dall’applicazione può essere il minimo tra più limiti.

Puoi usare temporaneamente una pagina diagnostica, ma elimina subito qualsiasi file phpinfo().

Ordine e ambito delle configurazioni

Le direttive possono essere definite a livello server, versione PHP, account, dominio e directory. Il valore effettivo dipende dal gestore PHP e dal tipo di direttiva. Per questo non è sufficiente trovare una riga in un file: bisogna controllare ciò che PHP applica realmente alla richiesta del dominio.

Quando un account contiene più siti, seleziona sempre il dominio corretto nel MultiPHP INI Editor. Un .user.ini inserito nella document root può influenzare anche sottodirectory, mentre un file collocato nel percorso sbagliato può non avere alcun effetto. Evita copie differenti della stessa direttiva.

Limiti del web server e del proxy

Anche con PHP configurato correttamente, il web server o un proxy possono rifiutare il corpo della richiesta o interrompere una connessione troppo lunga. Se il messaggio è HTTP 413, 502, 504 o Cloudflare 524, conserva codice e intestazioni: il problema potrebbe non essere una direttiva PHP.

WordPress continua a mostrare il vecchio limite

• verifica di aver selezionato il dominio corretto;
• controlla la versione PHP realmente usata;
• attendi l’aggiornamento della cache delle direttive .user.ini;
• controlla valori duplicati;
• verifica limiti imposti dall’applicazione o dal plugin;
• non confondere il limite media con quello di importazione del plugin.

Importazioni grandi: soluzione migliore del timeout enorme

Per CSV, XML e cataloghi usa lotti più piccoli, ripresa automatica e processi pianificati. Una singola richiesta web di molti minuti è fragile: può essere interrotta da rete, browser o proxy anche con PHP configurato correttamente.

Per archivi del sito utilizza strumenti di backup e ripristino progettati per operazioni lunghe, come JetBackup 5, invece di caricare manualmente file enormi attraverso WordPress.

Valori troppo alti: rischi

• processi PHP occupati per molti minuti;
• maggiore consumo di memoria per richiesta;
• raggiungimento dei limiti CloudLinux;
• code e rallentamenti per altri visitatori;
• operazioni difettose che impiegano più tempo prima di fallire;
• superficie maggiore per richieste abusive.

Non impostare timeout illimitati o memoria illimitata su un sito pubblico. Correggi l’elaborazione e usa valori proporzionati.

Errori frequenti e relativo controllo

Per la memoria consulta Allowed memory size exhausted; per cambiare versione ed estensioni usa PHP Selector in cPanel.

Quando aprire un ticket Xlogic

Apri un ticket se il valore salvato non viene applicato, l’interfaccia non offre la direttiva necessaria o l’operazione continua a fallire con un errore server. Indica dominio, versione PHP, valori attuali e richiesti, file o importazione, dimensione, durata e messaggio completo.

Non inviare password o file contenenti dati personali senza accordo e canale appropriato.

Fonti tecniche ufficiali

• PHP Manual: core php.ini directives
• CloudLinux Manager: PHP Selector
• cPanel: MultiPHP INI Editor
• cPanel: Customize PHP directives

Domande frequenti sui limiti PHP