Installare PrestaShop in locale, dalla scelta dell’ambiente ai test

Assistente di installazione PrestaShop completato. Ora puoi installare PrestaShop in locale e gestire il tuo negozio.

Pubblicato il

22 nov 2026

Indice

Hai una modifica da provare al catalogo, ma non vuoi rischiare di rompere il negozio online? Installare PrestaShop sul computer ti permette di lavorare senza pubblicare ogni cambiamento, purché l’ambiente locale usi versioni compatibili di PHP e database.

Installare PrestaShop in locale: assistente completato. Dettagli login e accesso back/front office.

PrestaShop in locale è un ambiente di prova, da configurare come il progetto che vuoi testare

  • Per PrestaShop 9.2, scegli un ambiente con PHP dalla versione 8.1 alla 8.5.
  • XAMPP o MAMP offrono un server web e un database da gestire con interfaccia grafica.
  • Docker è adatto se vuoi tenere separati progetto e componenti del computer.
  • Un errore di connessione al database spesso dipende da nome, credenziali o porta non corrispondenti.
  • Prima della pubblicazione, verifica le modifiche anche su un ambiente di staging.

Prepara un ambiente locale simile al negozio che vuoi sviluppare

Una pagina che si apre su localhost non è ancora un negozio accessibile ai clienti: gira sul tuo computer e ti serve per sviluppare e provare. La documentazione tecnica di PrestaShop descrive tre strade: uno stack locale come XAMPP o MAMP, Docker oppure una macchina virtuale.

Per iniziare con pochi passaggi, uno stack con interfaccia grafica è spesso la via più diretta. Se lavori in team o vuoi replicare con precisione l’ambiente di un progetto, sceglierei Docker: i componenti restano isolati e si possono configurare insieme, anche se serve familiarità con la riga di comando.

Per PrestaShop 9.2 controlla PHP prima di scaricare i file

Un’installazione può fermarsi prima ancora della schermata iniziale se la versione di PHP non è adatta. Le note di rilascio di PrestaShop 9.2 indicano il supporto per PHP dalla versione 8.1 fino alla 8.5; la documentazione tecnica indica inoltre Apache 2.4 o successivo, MySQL 5.7 o MariaDB 10.2 come versioni minime e almeno 512 MB di memory_limit.

Il numero di versione da controllare è quello usato da Apache, che può differire da quello mostrato dal terminale del computer. Se stai provando un modulo o un tema destinato a un negozio esistente, configura l’ambiente con le stesse versioni di PHP e PrestaShop del progetto: così riduci le sorprese causate da differenze tra sviluppo e produzione.

Componente Per PrestaShop 9.2 Controllo pratico
PHP Da 8.1 a 8.5 Verifica la versione associata al server web.
Server web Apache 2.4 o successivo Avvia Apache dal pannello del tuo stack locale.
Database MySQL 5.7 o MariaDB 10.2 come minimo Controlla versione, nome del database e credenziali.
Memoria PHP memory_limit di almeno 512 MB Leggi il valore nel php.ini caricato dal server web.

Se un’estensione o un modulo aggiuntivo ha requisiti diversi, controlla anche quelli prima di scegliere la configurazione: il software del negozio e i suoi componenti devono poter convivere nello stesso ambiente.

Scegli XAMPP o Docker in base al lavoro che devi fare

La domanda utile non è quale strumento sia “il migliore”, ma quanta configurazione vuoi gestire. Per una prima prova guidata, XAMPP, MAMP o Laragon permettono di avviare server e database dal pannello; per sviluppo ripetibile, Docker consente di definire i componenti del progetto in una configurazione condivisibile.

  • XAMPP, MAMP o Laragon: scegli uno stack grafico se vuoi caricare i file nella cartella web e creare il database con phpMyAdmin.
  • Docker: preferiscilo se vuoi isolare l’installazione e poter ricreare l’ambiente con una configurazione del progetto.
  • Staging online: usalo per verificare integrazioni che dipendono da un dominio, da servizi esterni o dalla configurazione dell’hosting.

Per un tema, la documentazione di PrestaShop offre anche configurazioni Docker Compose per PrestaShop 9.1 e versioni successive, con il negozio, il database e phpMyAdmin. La configurazione standard apre il negozio su localhost:8887 e phpMyAdmin su localhost:8889; sono indirizzi di quell’ambiente specifico, non valori da copiare in qualsiasi installazione.

Installa i file e crea un database separato per il negozio

Con il server locale pronto, tieni i file del negozio in una cartella dedicata nella directory web dello stack, come htdocs in molte installazioni XAMPP o MAMP. Scarica il pacchetto ufficiale della versione scelta ed estrailo seguendo la struttura dell’archivio: alcuni pacchetti contengono un programma che estrae a sua volta i file del negozio.

  1. Avvia il server web e il database dal pannello dello stack locale.
  2. Apri phpMyAdmin e crea un database vuoto con un nome semplice, per esempio negozio_test.
  3. Visita nel browser l’indirizzo locale della cartella, per esempio http://localhost/negozio_test/, e segui l’installazione guidata.
  4. Quando richiesto, inserisci il nome del database e le credenziali configurate nel tuo ambiente. Il nome host e la porta dipendono dallo stack scelto.
  5. Al termine, segui le istruzioni dell’installer per rimuovere o rinominare la cartella di installazione e accedere al back office.

Un errore comune è copiare credenziali viste in una guida senza verificare le proprie impostazioni: root e una password vuota, per esempio, non sono universali. Per i test locali crea un database dedicato, così puoi ripartire senza toccare altri progetti sul computer.

Un errore sul database o un back office lento richiedono controlli diversi

La stessa pagina d’errore può avere cause diverse, quindi conviene partire dal sintomo e controllare una cosa alla volta. Nelle discussioni della community ricorre anche la lentezza su Windows: prima di aumentare la memoria senza una diagnosi, controlla se Xdebug è attivo e se la scansione antivirus rallenta l’accesso ai file.

Situazione Possibile causa Cosa fare
“Impossibile connettersi” al database Server, porta, nome o credenziali non corrispondono. Verifica che il database sia avviato e confronta i dati inseriti con quelli di phpMyAdmin.
La pagina su localhost non si apre Server web spento, cartella nel percorso errato o porta occupata. Controlla lo stato di Apache e l’indirizzo locale configurato nello stack.
Back office molto lento su Windows Xdebug, accessi ai file rallentati o scansione antivirus. Verifica se Xdebug è attivo; poi controlla le impostazioni di OPcache e antivirus.
Errore 500 o pagina vuota dopo l’installazione Possibile incompatibilità di PHP, modulo o tema. Controlla i log del server e attiva temporaneamente la modalità debug in ambiente locale.

Un negozio lento in locale non dimostra da solo che sarà lento online, così come un negozio rapido sul computer non garantisce prestazioni identiche sull’hosting. Io partirei dai log e dalla configurazione effettiva del server: aumentare i limiti di memoria alla cieca può nascondere il sintomo senza risolvere la causa.

Usa la prova locale per ridurre gli errori prima della pubblicazione

In locale puoi controllare modifiche al tema, moduli, pagine e flussi di catalogo senza intervenire sul negozio pubblico. Per verificare pagamenti, email, corrieri o servizi esterni, però, configura credenziali di test o passa a un ambiente di staging: localhost non riproduce automaticamente i servizi dell’hosting.

Prima di distribuire il lavoro, trasferisci file e database con una procedura adatta alla versione e all’hosting, aggiorna gli indirizzi del negozio e prova nuovamente il flusso d’acquisto. La copia locale serve a lavorare con meno sprechi di tempo e tentativi; la verifica finale deve avvenire in un ambiente vicino a quello che useranno clienti e collaboratori.

Domande frequenti

PrestaShop 9.2 supporta PHP dalla versione 8.1 alla 8.5. Controlla la versione usata da Apache, che può differire da quella indicata nel terminale, e verifica che il server web sia Apache 2.4 o successivo. La configurazione richiede inoltre MySQL 5.7 o MariaDB 10.2 come minimo e almeno 512 MB di memory_limit.

XAMPP, MAMP o Laragon sono adatti se vuoi avviare server e database da un pannello grafico e gestire il database con phpMyAdmin. Docker è utile per isolare i componenti e ricreare un ambiente di sviluppo condivisibile, anche se richiede familiarità con la riga di comando. Per servizi legati a un dominio o all’hosting, usa anche un ambiente di staging.

Avvia il database, apri phpMyAdmin e crea un database vuoto dedicato, per esempio negozio_test. Nell’installer inserisci il nome del database e le credenziali effettive del tuo ambiente, controllando anche host e porta. Non dare per scontato che root senza password sia la configurazione corretta.

Se compare un errore di connessione, verifica che il database sia avviato e confronta host, porta, nome e credenziali con quelli configurati nello stack. Se il back office è lento su Windows, controlla se Xdebug è attivo e se l’antivirus rallenta l’accesso ai file; esamina anche OPcache. Per un errore 500 o una pagina vuota, consulta i log e prova temporaneamente la modalità debug in locale.

Valuta l'articolo

Valutazione: 0.00 Numero di voti: 0

Tag:

prestashop php xampp docker database

Condividi post

Scrivi un commento