Il caricamento del modulo fallisce con "file too large", cosa devo fare?

Di solito è un limite di upload PHP, non un problema dello ZIP del modulo. PrestaShop riceve lo ZIP attraverso il normale flusso di file caricati di PHP; se PHP rifiuta prima il file, il back office può mostrare solo un errore "file too large" o di upload incompleto.

Chiedi al tuo host di aumentare upload_max_filesize e post_max_size. Imposta post_max_size più alto di upload_max_filesize, perché l'intero HTTP POST ha overhead. Per moduli più grandi o hosting condivisi lenti, aumenta anche max_execution_time così PHP ha tempo di copiare ed estrarre l'archivio.

; php.ini or .user.ini example
upload_max_filesize = 64M
post_max_size = 80M
max_execution_time = 300
memory_limit = 256M

# Apache + mod_php only, not PHP-FPM
php_value upload_max_filesize 64M
php_value post_max_size 80M
php_value max_execution_time 300

Dopo aver modificato le impostazioni PHP, riavvia PHP-FPM o Apache se il tuo host lo richiede, poi ricarica il back office PrestaShop e riprova. Se non puoi cambiare quei valori, carica via FTP/SFTP: decomprimi localmente il modulo, copia la cartella del modulo in /modules/, poi installalo da Modules > Module Manager. Il risultato installato è lo stesso di un upload ZIP riuscito.

Ancora bloccato? Contatta il nostro team supporto con nome ZIP, dimensione file, versione PrestaShop, versione PHP e l'esatto errore di upload.

Quando usi FTP/SFTP, assicurati di caricare la cartella che contiene il file PHP principale del modulo. Per esempio, un modulo il cui sorgente dichiara $this->name = 'mprinternallinking' deve vivere come /modules/mprinternallinking/, con mprinternallinking.php e i file vendor/, controllers/, views/ o src/ dentro la stessa cartella. Una cartella wrapper extra è un motivo comune per cui il modulo non appare nel Module Manager.

Dopo aver messo i file al loro posto, non fermarti lì. La routine di installazione è ciò che crea le tabelle del modulo, registra hook e aggiunge controller admin. Nei moduli ispezionati, il codice di installazione può anche resettare opcache, installare storage admin condiviso per la configurazione e inserire default. Se copi soltanto i file e non fai mai clic su Install, quelle tabelle database e quegli hook mancano.

Se un upload fallito precedente ha lasciato una cartella creata a metà, rimuovi solo quella cartella incompleta del modulo prima di riprovare, poi carica una copia pulita. Non eliminare cache PrestaShop o cartelle modulo non correlate solo perché l'upload è fallito; di solito il fallimento è avvenuto prima ancora che il codice install del modulo venisse eseguito.