PS PrestaShop Principiante

dfbackup — Backup PrestaShop 1.7.8, 8 e 9: guida completa

Installazione, pianificazione e attività cron, destinazioni S3/FTP/Dropbox/OneDrive, crittografia AES-256-GCM, ripristino guidato annullabile e aggiornamento dalla 1.0.0 del modulo dfbackup.

Aggiornato Versione del modulo 2.1.0

Panoramica

DataFirefly Backup (dfbackup) salva il database e i file del suo negozio PrestaShop secondo una pianificazione, invia gli archivi a una o più destinazioni (questo server, Amazon S3 o un servizio compatibile S3, FTP/FTPS, Dropbox, Microsoft OneDrive, un altro PrestaShop), li cifra se lo desidera e li ripristina tramite una procedura guidata con pulsante di annullamento. Funziona su PrestaShop 1.7.8, 8 e 9 (PHP da 7.2 a 8.5), senza mysqldump, shell_exec né SDK.

Il modulo aggiunge Parametri Avanzati > DataFirefly Backup con tre pagine: Dashboard, Backup e ripristino e Impostazioni.

Dashboard dei backup: stato di protezione, ultimo e prossimo backup, spazio usato, stato delle destinazioni e attività recente
Dashboard dei backup

Installazione e aggiornamento

  1. In Moduli > Gestione moduli, clicchi su Carica un modulo e selezioni dfbackup-2.1.0.zip.
  2. Alla prima apertura, la procedura guidata di configurazione la accompagna in cinque passaggi: contenuti, destinazioni, pianificazione, protezione (crittografia ed e-mail), primo backup.

Aggiornamento dalla 2.0.0: carichi lo zip della 2.1.0 sopra il modulo installato. Impostazioni, cronologia e archivi vengono mantenuti; Microsoft OneDrive compare tra le destinazioni.

Aggiornamento dalla 1.0.0: carichi lo zip della 2.1.0 sopra il modulo installato. Le impostazioni e l’intera cronologia vengono mantenute, gli archivi della 1.0.0 restano ripristinabili, le credenziali memorizzate in chiaro dalla 1.0.0 vengono cifrate e gli archivi vengono spostati nella nuova cartella protetta.

La versione 1.0.0 non cifrava davvero gli archivi quando la passphrase veniva inserita nel suo modulo. Dopo l’aggiornamento, la dashboard le chiede di impostare una passphrase; gli archivi che la 1.0.0 aveva contrassegnato come cifrati ma scritto in chiaro sono indicati come tali nella cronologia.

Procedura di prima configurazione, passo Destinazioni: Amazon S3 o compatibile compilato e testato (scrittura, lettura, eliminazione)
Procedura di prima configurazione, passo Destinazioni

Dashboard

Il banner in alto indica se il negozio è protetto e, in caso contrario, cosa fare: nessun backup recente, pianificazione disattivata, attività cron che non chiama il modulo, copie solo su questo server, destinazione in errore, cartella di backup raggiungibile dal web. Sotto: ultimo e prossimo backup, spazio occupato su questo server, destinazioni con il loro ultimo stato, attività recente.

Esegui il backup ora avvia un backup completo; la freccia propone Solo database e Solo file. L’avanzamento viene mostrato passo per passo.

Backup in corso: avanzamento per fasi (database, elenco file, file, archivio, cifratura, impronta, invio) con ripresa automatica
Backup in corso

È possibile lasciare la pagina durante un backup: il lavoro prosegue alla successiva chiamata dell’attività cron. Tenere la pagina aperta lo rende più rapido.

Come si svolge un backup

Un backup viene suddiviso in brevi segmenti (20 secondi per impostazione predefinita, al di sotto del limite di tempo di PHP). Ogni segmento scrive un punto di ripresa: se PHP viene interrotto (limite di tempo, riavvio del server), il segmento successivo riprende dall’ultimo punto di ripresa invece di ricominciare da capo. I segmenti vengono eseguiti dalla pagina del back office aperta, dall’attività cron o dalla riga di comando.

  • Database: tutte le tabelle con il prefisso del negozio, più viste e trigger, lette a blocchi (la memoria resta limitata). Le tabelle elencate in Tabelle i cui dati non vengono salvati mantengono la loro struttura.
  • File: l’intera cartella del negozio, tranne cache, log e le esclusioni impostate. I link simbolici non vengono seguiti: sono elencati nel report, in modo da poterli ricreare.
  • Archivio: un file .tar.gz standard, leggibile con qualsiasi strumento di archiviazione (tar xzf), anche senza il modulo. Per ogni archivio viene registrata un’impronta SHA-256.

Destinazioni

Ogni destinazione attiva riceve ciascun archivio. Conservi almeno una copia al di fuori di questo server. Ogni destinazione dispone di un pulsante Testa la connessione che salva le impostazioni, quindi scrive, rilegge ed elimina un piccolo file; gli errori vengono spiegati (chiave errata, regione errata, permessi, certificato TLS…).

Impostazioni delle destinazioni: FTPS testato con successo, Dropbox collegato con token di aggiornamento, segreti nascosti e cifrati
Impostazioni delle destinazioni

Questo server

Gli archivi sono conservati in una cartella protetta: al di fuori del sito web se l’hosting lo consente, altrimenti in var/dfbackup-<random>/ con protezioni .htaccess, web.config e index.php e nomi di file non indovinabili. La dashboard verifica dal suo browser che la cartella non possa essere scaricata. Su nginx, aggiunga una regola come location ~ ^/var/dfbackup- { deny all; return 404; }, oppure imposti una cartella al di fuori della root web in Impostazioni > Avanzate.

Amazon S3 e servizi compatibili

ID chiave di accesso, chiave di accesso segreta, bucket, regione e cartella facoltativa. Per un servizio compatibile, compili l’endpoint: Cloudflare R2 (https://<account>.r2.cloudflarestorage.com, regione auto), Backblaze B2, Wasabi, OVHcloud, Scaleway, MinIO (selezioni Indirizzi in stile percorso (path-style)). Gli archivi oltre 64 MB vengono inviati in parti e un trasferimento interrotto riprende. La chiave necessita solo di s3:PutObject, s3:GetObject, s3:DeleteObject e s3:ListBucket sul bucket.

FTP / FTPS

Server, porta, utente, password e cartella (creata se necessario). Sicurezza: FTPS esplicito (AUTH TLS, consigliato), FTPS implicito (porta 990) o FTP semplice. Modalità passiva per impostazione predefinita. Il trasferimento utilizza cURL, quindi l’estensione PHP ftp non è necessaria; un caricamento interrotto riprende dal punto in cui si era fermato e la dimensione finale viene verificata.

Dropbox

  1. Su dropbox.com/developers/apps, crei un’app con Scoped access e App folder.
  2. Nella sua scheda Permissions, selezioni files.content.write, files.content.read e files.metadata.read, quindi clicchi su Submit.
  3. Incolli l’App key e l’App secret, clicchi su Apri il link di autorizzazione, consenta l’accesso e incolli il codice mostrato da Dropbox.

Il modulo conserva un refresh token (cifrato) e rinnova autonomamente l’accesso a breve durata. Gli archivi di grandi dimensioni vengono inviati in parti da 8 MB. Un token a lunga durata della versione 1.0.0 continua a funzionare finché Dropbox non lo rifiuta; ricolleghi Dropbox per passare al refresh token.

Microsoft OneDrive

Funziona con OneDrive Personal, Family e Microsoft 365 (lavoro o istituto di istruzione). Si usa la propria registrazione dell’app: non servono né un segreto client né un indirizzo di reindirizzamento.

  1. Su entra.microsoft.com (o portal.azure.com) apra Registrazioni app > Nuova registrazione. Tipi di account supportati: account personali e account di qualsiasi organizzazione (o solo la sua). Lasci vuoto l’URI di reindirizzamento.
  2. In Autenticazione, imposti Consenti flussi client pubblici su Sì e salvi.
  3. In Autorizzazioni API, aggiunga le autorizzazioni delegate Microsoft Graph Files.ReadWrite.AppFolder (o Files.ReadWrite per Una cartella del mio OneDrive), User.Read e offline_access.
  4. Nel modulo, incolli l’ID applicazione (client), lasci Account su common (o consumers per i soli account personali, oppure il suo ID tenant), scelga l’accesso e clicchi su Collega OneDrive.
  5. Apra la pagina Microsoft, inserisca il codice mostrato dal modulo e acceda con l’account proprietario del OneDrive. La pagina conferma il collegamento da sola.

Con Solo cartella dell’app (consigliato), il modulo raggiunge solo App/<nome della sua app> in OneDrive. Alcuni account aziendali rifiutano la cartella dell’app: scelga Una cartella del mio OneDrive e si ricolleghi. Il refresh token è memorizzato cifrato e rinnovato automaticamente. Gli archivi oltre 4 MB vengono inviati in parti da 10 MB e riprendono dopo un’interruzione.

Microsoft revoca l’accesso se non viene usato per 90 giorni, se la password cambia o se l’accesso viene revocato. Una pianificazione regolare lo mantiene attivo; altrimenti clicchi su Ricollega.

Un altro PrestaShop

Un secondo negozio con DataFirefly Backup può ricevere gli archivi (staging, altro server). Sul negozio ricevente, selezioni Ricevi archivi da un altro negozio e generi il segreto; sul negozio mittente, inserisca l’indirizzo del negozio ricevente e questo segreto. Le richieste sono firmate, marcate temporalmente e non possono essere riprodotte; il ricevente verifica la dimensione e lo SHA-256 di ogni archivio. Gli archivi ricevuti compaiono nella cronologia del negozio ricevente; non vengono mai ripristinati automaticamente.

Gli indirizzi su una rete privata (10.x, 172.16-31.x, 192.168.x) vengono rifiutati a meno che non li consenta in Impostazioni > Avanzate; gli indirizzi di loopback e di metadati cloud vengono sempre rifiutati.

Pianificazione e attività cron

Scelga la frequenza (più volte al giorno, giornaliera, settimanale, mensile), l’orario e i contenuti (database + file, o solo database). PrestaShop non può attivarsi da solo: crei un’attività cron presso il suo hosting.

  • Riga di comando (consigliata, nessun limite di tempo): */10 * * * * php /path/to/shop/modules/dfbackup/bin/dfbackup.php cron
  • Indirizzo web (cron dell’hosting o servizio cron online), ogni 5-15 minuti. Contiene un token segreto: lo mantenga riservato e generi un nuovo indirizzo se è stato divulgato.

Il modulo lavora solo quando un backup è previsto o in corso. Una fascia oraria persa perché il server non era disponibile viene recuperata alla chiamata successiva (entro 24 ore). Se il modulo PrestaShop Cron tasks manager è installato, anch’esso chiama DataFirefly Backup ogni ora. La dashboard la avvisa quando l’attività cron smette di chiamare il modulo.

Pianificazione dei backup automatici: frequenza, ora, contenuto, comando cron CLI e indirizzo web protetto da token
Pianificazione dei backup automatici

Contenuti e conservazione

Scelga se salvare il database, i file o entrambi. Cartelle e file non salvati: uno per riga, relativi alla cartella del negozio; * corrisponde a qualsiasi nome (admin*/autoupgrade); un nome senza / vale ovunque (node_modules). Tabelle i cui dati non vengono salvati: statistiche delle visite e log per impostazione predefinita.

File differenziali: tra due backup completi vengono salvati solo i file modificati dall’ultimo backup completo. Ripristini prima il backup completo, poi quello differenziale.

Conservazione: vengono conservati gli ultimi N backup ed eliminati quelli più vecchi di X giorni. Il backup più recente, il backup completo più recente e i backup protetti (icona della puntina nella cronologia) non vengono mai eliminati; l’eliminazione si applica a tutte le destinazioni. I backup di sicurezza (prima di un ripristino o dell’aggiornamento di un modulo) hanno una propria quota.

Crittografia

Gli archivi vengono cifrati con AES-256-GCM, in blocchi da 1 MB, ciascuno autenticato: un archivio modificato, troncato o riordinato viene rifiutato al ripristino. La chiave viene derivata dalla sua passphrase con PBKDF2-SHA256 (600.000 iterazioni, salt casuale per ogni archivio).

  1. Digiti due volte una passphrase di almeno 12 caratteri e, se lo desidera, aggiunga un promemoria (mai la passphrase stessa).
  2. Confermi di averla conservata al di fuori del negozio, quindi clicchi su Salva la passphrase e cifra.
Cifratura degli archivi AES-256-GCM a blocchi autenticati, passphrase salvata con promemoria e avviso di conservazione
Cifratura degli archivi AES-256-GCM a blocchi autenticati

Senza la passphrase, gli archivi cifrati non possono essere ripristinati, nemmeno da DataFirefly. La copia memorizzata nel negozio (cifrata con le chiavi segrete del negozio) va persa insieme al server: la conservi in un gestore di password. Gli utenti esperti possono invece fornirla tramite una variabile d’ambiente o una costante DFBACKUP_PASSPHRASE.

Senza crittografia, gli archivi contengono i dati dei suoi clienti e app/config/parameters.php (password del database): attivi la crittografia non appena una copia lascia questo server.

Notifiche

Report via e-mail (più indirizzi separati da virgole, nella lingua di sua scelta) e via webhook (Slack, Discord, Microsoft Teams o un suo indirizzo HTTPS, memorizzato in forma cifrata). Il report può essere inviato quando qualcosa va storto, dopo ogni backup, solo in caso di successo, oppure mai. I report non contengono mai password né chiavi e indicano l’azione da intraprendere.

Report via e-mail e webhook Slack, Discord o Teams: destinatari, lingua dei report, invio in caso di problemi e test
Report via e-mail e webhook Slack, Discord o Teams
E-mail di report del backup: stato, contenuto, dimensione, durata, destinazioni e azione consigliata, senza password né chiavi
E-mail di report del backup

Pagina Backup e ripristino

Filtri per stato, contenuto, origine (manuale, pianificato, prima di ripristino o aggiornamento, ricevuto o importato), destinazione e periodo, oppure cerchi per numero, etichetta o errore. Per ogni backup: dettagli e log, Verifica l’archivio (legge l’intero archivio e lo controlla), Scarica (copia locale), Ripristina, protezione dalla rotazione, eliminazione.

Cronologia filtrabile dei backup: stato, contenuto, origine, destinazione, periodo, ricerca, azioni verifica, download e ripristino
Cronologia filtrabile dei backup
Dettaglio di un backup: impronta SHA-256, file, numero di tabelle e file, log con data e ora di ogni fase
Dettaglio di un backup

Importa da una destinazione: su un nuovo negozio con questo modulo, colleghi la destinazione in cui si trovano i suoi archivi e li registri per ripristinarli (disaster recovery).

Ripristino guidato

La procedura guidata di ripristino prevede tre passaggi.

  1. Anteprima: data, versione di PrestaShop, dimensione, numero di tabelle e di file, prefisso delle tabelle, crittografia, copie disponibili e avvisi (versione di PrestaShop diversa, backup differenziale, spazio su disco).
  2. Cosa ripristinare: database, file o entrambi; prima un backup di sicurezza (consigliato); mantenere il dominio di questo negozio; ripristinare i file di configurazione del server (disattivato per impostazione predefinita).
  3. Conferma: digiti il nome del negozio; inserisca la passphrase se l’archivio è cifrato.
Ripristino guidato, anteprima: data, versione di PrestaShop, dimensione, tabelle, file, prefisso, cifratura e copie disponibili
Ripristino guidato, anteprima
Ripristino guidato, scelte: database e file, backup di sicurezza preliminare, file di configurazione mantenuti per impostazione predefinita
Ripristino guidato, scelte
Ripristino guidato, conferma esplicita: il nome del negozio va digitato prima di avviare il ripristino
Ripristino guidato, conferma esplicita

Cosa succede in seguito:

  • Prima di qualsiasi modifica, l’archivio viene recuperato, il suo SHA-256 viene confrontato con quello registrato al momento del backup, ogni blocco cifrato viene autenticato e l’intero archivio viene letto. I percorsi assoluti, i percorsi con .., i link simbolici e gli hard link vengono rifiutati.
  • Il backup di sicurezza salva su questo server il database attuale e i file che stanno per essere sovrascritti.
  • I file vengono riscritti. I file aggiunti dopo il backup vengono mantenuti. app/config/parameters.php, parameters.yml, config/settings.inc.php, il modulo stesso e la cartella di backup non vengono sovrascritti, a meno che non lo richieda.
  • Il database viene importato in tabelle temporanee, poi sostituito in un’unica operazione. Le tabelle precedenti vengono conservate per 24 ore: Annulla ripristino le rimette al loro posto. Le tabelle che utilizzano chiavi esterne vengono sostituite direttamente.
  • Le impostazioni e la cronologia di DataFirefly Backup restano quelle attuali. Con Mantieni il dominio di questo negozio, gli indirizzi del negozio restano quelli di questo server (i link scritti nei contenuti non vengono riscritti).

Tutto ciò che è stato salvato dopo la data del backup viene sostituito: ordini, clienti, dipendenti e le loro password. Il negozio resta attivo durante il ripristino; per un negozio molto frequentato, lo metta prima in manutenzione. Dopo la sostituzione, il back office potrebbe chiederle di accedere di nuovo con le credenziali in vigore alla data del backup.

Permessi

I permessi seguono il profilo del dipendente sulle schede del modulo: Visualizza per consultare, Aggiungi per eseguire o verificare un backup, Modifica per cambiare le impostazioni e scaricare, Elimina per eliminare; il ripristino richiede Modifica ed Elimina. Ogni azione sensibile viene registrata nel log di audit (dipendente, IP, data).

Snapshot prima dell’aggiornamento di un modulo

Su PrestaShop 8 e 9, uno snapshot del database viene creato subito prima dell’esecuzione degli script di aggiornamento di un modulo (database fino a 2 GB) e conservato su questo server. PrestaShop 1.7.8 non dispone di un hook prima degli aggiornamenti: esegua un backup manuale prima di aggiornare un modulo.

Impostazioni avanzate

  • Cartella di backup: un percorso assoluto, preferibilmente al di fuori del sito web; gli archivi esistenti vengono spostati quando la si modifica.
  • Lavoro per richiesta: 0 = automatico (20 secondi, al di sotto del limite di tempo di PHP).
  • Limite di memoria durante i backup: viene solo aumentato, mai ridotto.
  • Modalità manutenzione durante il backup: per una copia perfettamente coerente di un negozio molto frequentato.
  • Consenti destinazioni su una rete privata: per un suo server MinIO, FTP o negozio su una rete locale.

Riga di comando

php modules/dfbackup/bin/dfbackup.php cron            # scheduled backup if due, or continue the running one
php modules/dfbackup/bin/dfbackup.php backup full     # full, db or files
php modules/dfbackup/bin/dfbackup.php status

Risoluzione dei problemi

Un backup risulta “In pausa”

Nessuno lo ha fatto avanzare per cinque minuti (pagina chiusa, nessuna chiamata cron). Apra la dashboard per proseguirlo, oppure controlli l’attività cron.

“Spazio su disco insufficiente”

Liberi spazio, escluda le cartelle più grandi in Impostazioni > Contenuti, elimini i backup più vecchi, oppure disattivi Questo server come destinazione (l’archivio viene quindi eliminato dopo l’invio).

“Il server interrompe PHP durante il salvataggio della tabella …”

Esegua i backup con l’attività cron da riga di comando, che non ha limiti di tempo.

Una destinazione non funziona

Apra Impostazioni > Destinazioni e clicchi su Testa la connessione: il messaggio indica la causa e la soluzione. Il backup resta su questo server quando nessuna destinazione remota lo ha accettato.

“Controllo di integrità non riuscito”

L’archivio è stato modificato o danneggiato (copia incompleta, errore del disco): nel negozio non è stato modificato nulla. Utilizzi un’altra copia (un’altra destinazione) o un altro backup.

Disinstallazione

La disinstallazione elimina le impostazioni e la cronologia. Vengono eliminate anche le tabelle precedenti conservate per annullare un ripristino. Gli archivi già salvati restano nella cartella di backup e sulle destinazioni remote.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza