Come migrare PrestaShop: guida passo passo

In questa guida ti mostrerò passo dopo passo come migrare PrestaShop.

Se stai spostando il sito su un altro server o trasferendolo da locale in remoto, qui troverai la procedura corretta da seguire per evitare errori.

Non vuoi occuparti da solo del trasferimento? Se scegli uno dei nostri server per PrestaShop, potrai richiedere la migrazione gratuita.

Ti basta ordinare il piano e poi aprire un ticket per richiedere la migrazione, dopodiché potrai concordare con il nostro team di supporto il momento più adatto per avviare il trasferimento senza che ci siano down al sito.

Se vuoi procedere in autonomia, qui ti spiegherò due casi:

• come spostare un sito PrestaShop mantenendo lo stesso dominio;
• come fare la migrazione e cambiare il dominio del sito.

All’inizio la procedura è identica per entrambe le situazioni.

Iniziamo dal primo passo.

Prepararsi alla migrazione di PrestaShop

Prima di iniziare a migrare il tuo negozio PrestaShop, ci sono delle verifiche che devi fare.

PrestaShop nella sua documentazione ufficiale raccomanda di procedere con la migrazione da un server all’altro solo dopo aver aggiornato lo store all’ultima versione.

Se non sai come procedere, puoi seguire la nostra guida passo passo all’aggiornamento di PrestaShop.

In questa guida vedrai i passaggi per la versione 1.7.X, nello specifico abbiamo usato la versione 1.7.8.7.

Mettere il negozio in modalità di manutenzione

Quando cambi hosting, prima di iniziare a trasferire il tuo sito, è consigliabile attivare la modalità di manutenzione.

Si tratta di uno step importante soprattutto nel caso di un ecommerce. Mettendo il negozio in manutenzione, non rischi di perdere gli ordini dei clienti durante il processo di migrazione.

Ti consigliamo di programmare la migrazione con anticipo e scegliere un giorno e un orario in cui prevedi che ci siano meno ordini.

Per attivare la modalità di manutenzione fai così:

1. clicca su Parametri Negozio > Generale;
2. fai click sulla scheda Manutenzione;
3. imposta su “No” l’opzione “Abilita negozio”;
4. clicca su “Salva”.

Come passaggi opzionali puoi inserire il tuo indirizzo IP per continuare a visualizzare il negozio anche se è in modalità di manutenzione. Inoltre puoi personalizzare il testo che vedranno gli utenti finché il negozio non sarà di nuovo disponibile.

Fare un backup dei file

È arrivato il momento del passaggio più importante della migrazione del sito PrestaShop. Creare un backup.

La prima cosa che dobbiamo fare è scaricare un backup di tutti i file del nostro sito PrestaShop.

Ci sono diversi metodi per farlo, per esempio:

• puoi usare un client FTP per scaricare i file sul tuo pc;
• puoi creare un file zip con tutti i file del sito direttamente dal file manager di cPanel.

Ai fini di questa guida vediamo come fare collegandoci al server con un client FTP come FileZilla.

Tieni conto che per farlo ti serviranno questi dati:

• nome dell’host;
• username dell’account FTP;
• password;
• porta FTP.

Se il tuo provider usa cPanel puoi trovare questi dati nella sezione Account FTP. Se non hai ancora creato un account FTP, dovrai farlo prima di procedere.

Dopo esserci collegati al server con FileZilla, ci basta trovare la cartella che contiene i file del sito e scaricare tutto il suo contenuto sul nostro computer. Assicurati di selezionare tutti i file.

Ricorda che se hai installato PrestaShop nella root del dominio, la cartella che contiene i file sarà “public_html”. Se invece hai usato un sottodominio o una sottocartella, dovrai individuare la cartella corretta.

In questo modo abbiamo scaricato un backup dei file dal server di origine sul nostro computer. Ora è il momento di passare al database.

Suggerimento avanzato: Con l’accesso SSH che trovi con tutti i nostri piani compresi unManaged VPS cloud, puoi spostare i file usando LFTP (un client FTP che puoi usare da terminale). In questo modo ti colleghi a entrambi i server e sposti i file più rapidamente. È necessario disporre di accesso SSH su entrambi i server, quello di origine e quello di destinazione.

Esportare il database

Dobbiamo creare una copia del database dal server attuale per poi importarla successivamente sul nuovo server in cui stiamo migrando il negozio PrestaShop.

La procedura dipende dal sistema utilizzato dal provider per la gestione del database. Nella maggior parte dei casi potrai farlo con phpMyAdmin.

Questo strumento ci consente di apportare modifiche al database, ma anche di esportare e importare interi database.

Nota importante: se quando accedi a phpMyAdmin vedi più di un database, devi assicurarti di esportare quello corretto.

Per trovare il nome del database consulta il file “parameters.php” che trovi in app/config/. Troverai questa informazioni alla riga “database_name”.

Da phpMyAdmin seleziona il database e clicca sulla scheda “Esporta“. Quindi ti basta esportare il database con le opzioni predefinite di esportazione, usando il formato SQL.

Come migrare PrestaShop su un altro server

Ricapitolando: abbiamo creato una copia dei file del nostro sito PrestaShop ed esportato l’intero database.

Adesso dobbiamo copiare file e database sul nuovo server e poi modificare i file di configurazione necessari a far sì che tutto funzioni correttamente.

Importare il database sul nuovo server

Per migrare PrestaShop su un altro server, dobbiamo importare il database.

Per prima cosa dobbiamo creare un nuovo database sul nuovo server.

Su cPanel la procedura è molto semplice e se non sai come fare puoi usare l’opzione “Procedura guidata database MySQL” che ti guiderà passo passo nella creazione di database e utente.

Dopo aver creato il database, apriamo phpMyAdmin e clicchiamo nell’elenco a sinistra sul nome del database che abbiamo creato, come vedi il database è ancora vuoto. A questo punto clicchiamo sulla scheda “Importa”.

Da qui dobbiamo cliccare su “Scegli file” e poi selezionare dal nostro computer il file .sql con il database che avevamo scaricato nel passaggio precedente. Il file avrà un nome del tipo “nome_database.sql” oppure “nome_database.sql.zip”.

Dopo averlo selezionato, scorri fino in fondo nella pagina per cliccare sul pulsante “Esegui“. Un avviso ti confermerà che il database di PrestaShop è stato importato.

Modificare i file di configurazione

Ora che abbiamo importato il database di PrestaShop sul nuovo server, dobbiamo far sì che il negozio sia associato al database corretto.

Apriamo la cartella in cui abbiamo scaricato il backup dei file di PrestaShop.

Il file che dobbiamo modificare si trova qui: app/config/parameters.php

Possiamo modificarlo con un editor come “blocco note” di Windows.

Nel file dobbiamo inserire le informazioni del nuovo database, vediamo quali sono le righe da modificare.

'database_host' => 'localhost',

Fai riferimento alle indicazioni del tuo provider hosting, se stai migrando verso SupportHost dovrai usare “localhost” come host del database.

'database_name' => 'NOME-NUOVO-DATABASE',

Sostituisci “NOME-NUOVO-DATABASE” con il nome del database che hai creato sul nuovo server.

'database_user' => 'NOME-NUOVO-UTENTE',

Come nella riga precedente, inserisci il nome utente associato al database che hai creato.

'database_password' => 'NUOVA-PASSWORD',

Inserisci la password dell’utente associato al database.

Dopo aver inserito tutti i dati corretti puoi salvare il file.

Caricare i file sul server di destinazione

Dopo aver seguito tutti i passaggi precedenti, potrai caricare tutti i file e le cartelle sul nuovo server.

Puoi seguire lo stesso metodo che abbiamo visto prima: collegarti al nuovo server via FTP usando un client come FileZilla.

Questa volta dovrai fare il processo inverso: selezionare tutti i file e cartelle del sito dal tuo computer e caricarli sul server.

In questo caso dovrai quindi selezionare i file dalla sezione “Sito locale” di FileZilla, aprire la cartella di destinazione nella sezione “Sito remoto” (per esempio public_html per caricarli nella root) e poi caricarli (tasto destro > Upload).

Nota: se vuoi che il tuo negozio sia raggiungibile da un indirizzo come “www.tuodominio.com/negozio” ti basterà creare la cartella “negozio” all’interno di public_html e caricare in questa i tuoi file.

Se vuoi usare un sottodominio ti basta aprire public_html e poi selezionare la cartella corrispondente al sottodominio che vuoi usare, per esempio “negozio.tuodominio.com”.

Operazioni finali per completare il trasferimento

Ora che abbiamo completato la migrazione, ci sono due casi possibili.

Situazione 1: hai deciso di migrare il sito PrestaShop e usare lo stesso dominio sul nuovo server.

In questo caso avrai bisogno di modificare il puntamento del dominio.

Situazione 2: vuoi fare una migrazione con cambio di dominio.

Dovrai modificare le impostazioni di configurazione del negozio per cambiare il dominio con il nuovo.

Vediamo come fare in entrambi i casi.

Completare la migrazione di PrestaShop (senza cambio di dominio)

In questo caso dobbiamo andare a modificare il puntamento del dominio per far sì che quando visitiamo il sito “dominio.com” esso sia collegato al nuovo server e non più al vecchio.

Prima di farlo, però, ti consiglio di verificare che la migrazione sia andata a buon fine e quindi che il tuo ecommerce funzioni correttamente.

Come facciamo a visitare il sito se il dominio punta ancora al vecchio server?

Ci basta usare il file hosts.

Il file hosts del nostro PC ci permette di associare al dominio l’indirizzo IP. Tutto quello che bisogna fare è aggiungere una riga con il nostro dominio e l’indirizzo IP del nuovo server.

Adesso collegandoci al sito dal nostro browser stiamo visitando quello sul nuovo server. Possiamo quindi controllare che il sito funzioni correttamente.

Dopodiché possiamo procedere a cambiare il puntamento del dominio e attendere che le modifiche siano applicate (in genere basta aspettare qualche ora).

Come migrare PrestaShop e cambiare dominio

Se oltre a trasferire il sito PrestaShop da un server ad un altro, abbiamo deciso anche di cambiare dominio, dobbiamo modificare le impostazioni del sito.

Possiamo effettuare questa modifica dal database.

Per prima cosa apriamo phpMyAdmin per accedere al database sul nuovo server.

Modificare la tabella ps_configuration

Cerchiamo nel database la tabella “ps_configuration”.

Nota che il prefisso della tabella potrebbe essere diverso come in questo esempio in cui il prefisso è “ps45”.

Nella tabella dobbiamo cercare le righe:

PS_SHOP_DOMAIN

PS_SHOP_DOMAIN_SSL

In corrispondenza di queste righe, nel valore (value) vedremo l’indirizzo del vecchio dominio, ci basta modificare i valori inserendo il nuovo dominio. Inserisci il dominio come “dominio.com” senza inserire “https:/”.

Modificare la tabella ps_shop_url

Adesso cerchiamo la tabella “ps_shop_url”. Tieni presente che anche in questo caso il prefisso potrebbe non essere “ps” ma differente, come nel nostro caso.

Apriamola per modificarla.

Al suo interno vedremo tre valori:

• domain
• domain_ssl
• physical_uri.

Se abbiamo caricato i file del sito all’interno della root del nuovo dominio dobbiamo cambiare i valori in questo modo:

• domain e domains_ssl: inserisci nei due valori il nuovo dominio;
• physical_uri: inserisci come valore “/”.

Ti mostro un esempio in cui il nuovo dominio è “dominio.com”.

Altrimenti se hai caricato i file in una sottocartella, fai così:

• domain e domains_ssl: inserisci nei due valori il nuovo dominio;
• physical_uri: inserisci come valore il nome della cartella, ad esempio “/negozio”.

Per esempio se il tuo sito si trova a questo indirizzo dominio.com/negozio, dovrai modificare i valori in questo modo:

Disattivare la modalità di manutenzione

Dopo che abbiamo verificato che tutto funzioni correttamente possiamo riportare il nostro sito online disattivando la modalità di manutenzione.

Dal back office possiamo cliccare su “Modalità di manutenzione“, come ti mostro qui:

Dopodiché impostiamo su “Sì” l’opzione Abilita negozio e clicchiamo su “Salva”.

Se il sito non funziona correttamente, segui i metodi descritti nella prossima sezione per risolvere gli errori più diffusi dopo il trasferimento del sito.

Risolvere problemi comuni dopo la migrazione di PrestaShop

Ecco le soluzioni per risolvere alcuni dei problemi più comuni che si verificano dopo il trasferimento di PrestaShop da un server all’altro.

Non è possibile accedere al back office

In alcuni casi dopo la migrazione, invece di vedere il sito ci troviamo davanti a un errore 500 o a una pagina bianca.

Se non riesci ad accedere all’area di amministrazione di PrestaShop dopo aver trasferito il sito, ci sono alcune verifiche da fare.

1. Per prima cosa assicurati di aver modificato il file parameters.php e inserito i dati corretti del nuovo database.
2. Se i dati sono corretti e continui a vedere l’errore, prova a rinominare il file .htaccess con un altro nome, per esempio “.htaccess-disattivato”.
3. Se anche in questo modo, non riesci ad accedere, puoi attivare la modalità di debug di PrestaShop.

Come attivare la modalità di debug di PrestaShop

Apri la cartella “config” e modifica il file “defines.inc.php“.

Trova la riga seguente:

define('_PS_MODE_DEV_', false);

E modificala in questo modo:

define('_PS_MODE_DEV_', true);

Riprova ad accedere al back office di PrestaShop per vedere se funziona.

Avendo attivato la modalità di debug, se ci sono errori li vedrai visualizzati sullo schermo.

Ricordati che dopo aver trovato l’errore dovrai disattivare nuovamente la modalità di debug.

Il sito funziona solo in modalità di debug

Se disattivando la modalità di debug di PrestShop, non riesci a visualizzare il sito correttamente, la soluzione può essere eliminare la cache.

In questa situazione puoi andare a svuotare la cache del sito manualmente.

Per farlo apri la cartella “var/cache“, al suo interno troverai le cartelle “prod” e “dev“, ti basta eliminarle (o anche semplicemente rinominarle) per verificare se il problema si risolve.

Le pagine o le immagini non si vedono

Può capitare che dopo aver migrato il sito PrestaShop alcune pagine o alcune immagini non vengano visualizzate correttamente.

Se visitando alcune delle pagine del tuo sito vedi un errore come “Pagina non trovata” o “Not Found The requested URL”, puoi procedere in questo modo.

Accedi al back office di PrestaShop e vai su Parametri Negozio > Traffico & SEO. Da qui scorri fino a trovare la sezione “Impostazione URL”, poi modifica l’opzione Friendly url su “No” e salva.

Ripeti l’operazione e riattiva l’impostazione Friendly url (impostala su “Sì” e salva). Così facendo PrestaShop rigenererà il file .htaccess e dovresti risolvere i problemi che stai avendo.

Le pagine sono visibili ma presentano errori

Se le pagine del tuo negozio PrestaShop sono raggiungibili dopo la migrazione, ma non vengono caricate correttamente puoi provare a svuotare la cache.

Per farlo ti basta accedere al Back Office del tuo negozio e andare su Parametri avanzati > Prestazioni. Da qui potrai cliccare sul pulsante “Pulisci la cache” così:

Conclusioni

Abbiamo visto nel dettaglio come migrare PrestaShop da un server a un altro. Puoi seguire questa stessa guida anche per trasferire un sito PrestaShop sviluppato in locale su un server.

Ricordati che dopo aver trasferito i file e il database, hai ancora un passaggio da fare:

• se il dominio è rimasto lo stesso, devi cambiare il puntamento;
• se hai cambiato dominio, devi modificare il database per associarlo al nuovo dominio.

Alla fine di questa guida ho riportato alcuni degli errori più comuni che possono capitare dopo il trasferimento.

Nel tuo caso come è andata? Hai spostato il sito con successo o hai avuto difficoltà? Facci sapere con un commento.