Duplicator: Installer.php e il Processo di Ripristino

Il file installer.php è il cuore del sistema di ripristino di Duplicator. Questo script automatizza tutte le operazioni necessarie per riportare un sito WordPress allo stato contenuto nel package: estrazione dei file, importazione del database, aggiornamento degli URL e dei percorsi. Comprendere a fondo il funzionamento dell’installer è essenziale per gestire con sicurezza le operazioni di backup e migrazione. In questa guida analizzeremo ogni aspetto dell’installer, dalle basi fino alle configurazioni avanzate.

Che Cos’è l’Installer di Duplicator

L’installer è uno script PHP generato automaticamente da Duplicator ogni volta che viene creato un nuovo package. Non si tratta di un file generico: ogni installer è specifico per il package a cui appartiene e contiene informazioni sul sito di origine, sulla struttura del database e sulla configurazione di WordPress.

A differenza di altri sistemi di backup che richiedono l’accesso a phpMyAdmin, alla shell SSH o ad altri strumenti tecnici per il ripristino, l’installer di Duplicator offre un’interfaccia web grafica guidata che rende il processo accessibile anche a chi non ha competenze tecniche avanzate.

L’installer gestisce automaticamente:

• L’estrazione dell’archivio compresso (ZIP o DupArchive)
• La creazione o il popolamento delle tabelle del database
• La sostituzione degli URL (Search and Replace)
• L’aggiornamento del file wp-config.php
• La gestione dei dati serializzati nel database
• La pulizia dei file temporanei

Come Avviare l’Installer

Prerequisiti

Per avviare l’installer, devi aver caricato sul server di destinazione:

1. Il file installer.php (o il nome personalizzato che hai scelto)
2. Il file archivio corrispondente (ZIP o DupArchive)

Entrambi i file devono trovarsi nella stessa cartella, che sarà la root del sito WordPress ripristinato. La cartella deve essere accessibile dal web e avere permessi di scrittura adeguati.

Avvio

Apri il browser e naviga all’URL dell’installer:

https://tuodominio.it/installer.php

Se hai rinominato il file per motivi di sicurezza (pratica consigliata), usa il nome che hai assegnato:

https://tuodominio.it/installer-abc123.php

Step 1: Deploy – Validazione e Estrazione

La prima schermata dell’installer mostra un riepilogo del package e i risultati dei controlli di compatibilità del server.

Informazioni del Package

In alto vengono visualizzate le informazioni principali:

• Site: il dominio del sito di origine.
• Notes: eventuali note aggiunte durante la creazione del package.
• Archive Size: la dimensione dell’archivio.
• Created: data e ora di creazione del package.
• Duplicator Version: la versione del plugin usata per creare il package.
• WordPress Version: la versione di WordPress contenuta nel package.

Controlli di Validazione

L’installer esegue una serie di controlli sul server di destinazione:

• Archive: verifica l’integrità del file archivio e conferma che corrisponda al package.
• Validation: controlla che le versioni di PHP e MySQL del server siano compatibili.
• Server Disk: verifica lo spazio disco disponibile per l’estrazione.
• PHP Settings: analizza le impostazioni PHP (max_execution_time, memory_limit, etc.).

Se tutti i controlli sono superati, spunta la casella per accettare i termini e le condizioni, quindi seleziona la modalità di installazione.

Modalità di Installazione

• Full Install (Overwrite): installa sia i file che il database. È la modalità standard per migrazioni e ripristini completi.
• Restore Single Site: ripristina un singolo sito da un backup (disponibile nella versione Pro).
• Database Only: importa solo il database senza toccare i file. Utile quando i file sono già sul server e serve solo il database.

Clicca su Next per avviare l’estrazione dell’archivio.

Processo di Estrazione

L’installer estrae il contenuto dell’archivio nella cartella corrente. Questo processo può richiedere da pochi secondi a diversi minuti, a seconda della dimensione dell’archivio e delle prestazioni del server. Una barra di progresso mostra lo stato dell’operazione.

Durante l’estrazione, il browser deve rimanere aperto. Se l’estrazione si interrompe per un timeout, potrebbe essere necessario aumentare il valore di max_execution_time nelle impostazioni PHP del server.

Step 2: Install – Configurazione del Database

Dopo l’estrazione, l’installer chiede le credenziali del database di destinazione.

Campi del Database

• Action: scegli tra “Create New Database” (se l’utente MySQL ha i privilegi per creare database) o “Connect and Remove All Data” (usa un database esistente, eliminando tutto il suo contenuto attuale) o “Connect and Backup Any Existing Data”.
• Host: l’indirizzo del server MySQL. Nella maggior parte dei casi è localhost. Su hosting condivisi potrebbe essere un indirizzo interno diverso.
• Database: il nome del database. Deve esistere se hai scelto l’azione “Connect”.
• User: l’utente MySQL con permessi completi sul database.
• Password: la password dell’utente MySQL.

Opzioni Avanzate

Espandendo la sezione “Options”, trovi configurazioni aggiuntive:

• Legacy Mode: attivalo se riscontri problemi con l’importazione standard del database.
• Charset e Collation: generalmente conviene lasciare i valori predefiniti. Modificali solo se il database di origine usa un charset specifico.
• Spacing: opzioni per la gestione degli spazi nel dump SQL.
• Mode: scegli tra “Chunking” (per siti grandi) e “Single Process”.

Test della Connessione

Clicca su Test Database per verificare la connessione. L’installer mostra:

• Lo stato della connessione (Success/Fail)
• La versione del server MySQL
• I privilegi dell’utente
• Lo spazio disponibile nel database

Se il test ha successo, clicca su Next per avviare l’importazione del database. Questo processo può richiedere tempo per database di grandi dimensioni.

Step 3: Update – Aggiornamento URL e Percorsi

Questa è la fase in cui l’installer aggiorna tutte le riferimenti interni del sito. È la fase più critica e quella che distingue Duplicator da un semplice dump e restore del database.

URL Update

L’installer mostra gli URL rilevati nel database originale e propone automaticamente i nuovi valori basati sul server di destinazione:

• Old URL: l’URL del sito di origine (es. https://vecchiodominio.it)
• New URL: l’URL del sito di destinazione (es. https://nuovodominio.it)

Verifica attentamente questi valori. Errori in questa fase causeranno link rotti e malfunzionamenti. Presta particolare attenzione a:

• Il protocollo (http vs https)
• La presenza o assenza del “www”
• Eventuali sottocartelle nel percorso

Path Update

Analogamente, l’installer aggiorna i percorsi fisici dei file:

• Old Path: il percorso del sito di origine (es. /home/vecchioutente/public_html/)
• New Path: il percorso sul nuovo server (es. /var/www/html/)

Search and Replace

L’installer esegue un Search and Replace intelligente nel database, che gestisce correttamente:

• Dati serializzati: WordPress e molti plugin usano array serializzati nel database. Un semplice trova-e-sostituisci romperebbe queste strutture. L’installer di Duplicator deserializza i dati, effettua la sostituzione e li riserializza correttamente.
• JSON: i dati in formato JSON (usati da Elementor, Gutenberg e altri page builder) vengono gestiti con la stessa attenzione.
• URL con e senza trailing slash: l’installer gestisce entrambe le varianti.

Opzioni Aggiuntive

• New Admin Account: puoi creare un nuovo account amministratore. Utile se non ricordi le credenziali originali o se stai creando un ambiente di test.
• Site Title: modifica il titolo del sito.
• Full Search: esegue la sostituzione su tutte le tabelle del database, non solo su quelle standard di WordPress. Attivalo se usi plugin che creano tabelle personalizzate.

Step 4: Test – Verifica e Pulizia

L’ultima schermata mostra un riepilogo del ripristino completato e fornisce link utili:

• Admin Login: link diretto alla pagina di login di WordPress.
• Site Home: link alla homepage del sito ripristinato.
• Review Install Report: un report dettagliato delle operazioni eseguite, eventuali avvisi o errori.

Pulizia Obbligatoria

L’installer include un pulsante Security Cleanup che rimuove automaticamente:

• Il file installer.php
• Il file installer-backup.php
• L’archivio originale
• I file di log dell’installer
• La cartella temporanea dup-installer

Non saltare mai questo passaggio. I file dell’installer lasciati sul server rappresentano una grave vulnerabilità di sicurezza: chiunque vi acceda potrebbe sovrascrivere il tuo sito con un altro database o ottenere accesso alle credenziali.

Se dimentichi di eseguire la pulizia, Duplicator mostrerà un avviso persistente nella dashboard di WordPress finché i file non vengono rimossi.

Scenari di Ripristino Avanzati

Ripristino sullo Stesso Server

Quando ripristini un backup sullo stesso server e dominio (ad esempio dopo un errore o un aggiornamento fallito), gli URL e i percorsi non cambiano. In questo caso, l’installer precompilerà automaticamente i valori corretti e il Search and Replace non apporterà modifiche significative.

Ripristino Parziale (Solo Database)

Se i file del sito sono intatti ma il database è corrotto o perso, puoi utilizzare la modalità “Database Only” dell’installer. Questa modalità importa solo il database dal package senza toccare i file sul server.

Ripristino su Server con HTTPS

Se il sito di origine usava HTTP e il server di destinazione usa HTTPS (o viceversa), l’installer gestirà automaticamente la sostituzione del protocollo negli URL. Assicurati però che il certificato SSL sia già attivo sul dominio di destinazione prima di avviare il ripristino.

Risoluzione dei Problemi dell’Installer

• Errore “Archive not found”: il file archivio non è nella stessa cartella dell’installer o ha un nome diverso da quello atteso. Verifica che entrambi i file siano nella stessa directory.
• Timeout durante l’estrazione: il server ha un max_execution_time troppo basso. Aumentalo a 300 o più secondi.
• Errore di connessione al database: verifica le credenziali. Su Plesk, l’host può essere localhost; su altri pannelli potrebbe essere diverso.
• Errore “Permission denied”: la cartella di destinazione non ha permessi di scrittura. Imposta i permessi a 755 per la cartella e 644 per i file.
• Pagina bianca dopo il ripristino: generalmente indica un conflitto PHP. Verifica la versione PHP e confrontala con quella del sito originale.

Sicurezza dell’Installer

L’installer è uno strumento potente e, come tale, richiede attenzione alla sicurezza:

• Rinomina il file: nella versione Pro, puoi assegnare un nome personalizzato all’installer per renderlo meno prevedibile.
• Proteggi con password: nella versione Pro, puoi impostare una password per l’accesso all’installer.
• Elimina subito dopo l’uso: non lasciare mai i file dell’installer sul server più a lungo del necessario.
• Limita l’accesso IP: se possibile, configura il server per permettere l’accesso all’installer solo dal tuo indirizzo IP.

Conclusioni

L’installer di Duplicator è ciò che rende il plugin superiore a molte alternative per il ripristino e la migrazione di siti WordPress. La sua capacità di gestire automaticamente l’estrazione dei file, l’importazione del database, il Search and Replace dei dati serializzati e l’aggiornamento della configurazione riduce drasticamente il rischio di errori umani e il tempo necessario per completare l’operazione.

Per ottenere i migliori risultati con l’installer, è importante utilizzare un hosting WordPress con configurazioni PHP adeguate e spazio disco sufficiente. Un server ben configurato rende il processo di ripristino veloce e senza intoppi.

Se hai bisogno di assistenza per il ripristino di un backup o la migrazione del tuo sito WordPress, non esitare a rivolgerti ai nostri esperti. Contattaci per ricevere supporto professionale e garantire che il tuo sito venga ripristinato correttamente e in sicurezza.