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.

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.
- Avvia il server web e il database dal pannello dello stack locale.
- Apri phpMyAdmin e crea un database vuoto con un nome semplice, per esempio
negozio_test. - Visita nel browser l’indirizzo locale della cartella, per esempio
http://localhost/negozio_test/, e segui l’installazione guidata. - Quando richiesto, inserisci il nome del database e le credenziali configurate nel tuo ambiente. Il nome host e la porta dipendono dallo stack scelto.
- 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.