Joomla! Downloader

Joomla! Downloader è un'utilità PHP composta da un solo file che scarica ed estrae Joomla direttamente sul tuo server. È pensata per velocizzare le nuove installazioni, ridurre i passaggi manuali e semplificare i flussi di deploy.

Panoramica

Joomla! Downloader è uno script PHP standalone che recupera i pacchetti Joomla direttamente da sorgenti ufficiali, li scarica in modalità server-to-server, valida l’archivio ed estrae automaticamente i file.

Invece di scaricare localmente un file ZIP, caricarlo via FTP ed estrarlo manualmente, ti basta caricare un singolo file PHP, aprirlo nel browser, scegliere la release di Joomla e lasciare che lo script completi il processo per te.

Server-to-server

Scarica Joomla direttamente sul server di destinazione, evitando i colli di bottiglia del trasferimento locale.

Estrazione automatica

Verifica ed estrae automaticamente l’archivio ZIP, poi rimuove i file temporanei.

Setup rapido

Una scorciatoia pratica per nuove installazioni Joomla, ambienti di staging e setup ripetuti di progetto.

Repository GitHub Release

Come funziona

Joomla! Downloader sostituisce il classico workflow di installazione con un processo lato server più breve e pulito. Lo script è pensato per ridurre le operazioni manuali, risparmiare tempo e abbassare il rischio di errori durante trasferimento o estrazione.

Workflow tipico

Carica joomla_downloader.php sul tuo server.
Apri lo script nel browser.
Carica l’elenco dei pacchetti Joomla disponibili.
Scegli la release che vuoi installare.
Avvia il processo di download ed estrazione.
Rimuovi lo script e continua con il normale installer web di Joomla.

Schermata di selezione pacchetto di Joomla Downloader

Scegli il pacchetto Joomla

La schermata di selezione del pacchetto mostra molto più di un semplice pulsante di download. Ogni card può esporre diversi dettagli utili per aiutarti a scegliere la release Joomla corretta per il tuo progetto.

La versione della release.
Il branch o channel a cui appartiene.
Il livello di maturità, ad esempio Stable, Release Candidate, Beta, Alpha o Nightly Build.
I requisiti minimi di PHP e del database, inclusi MariaDB, MySQL e PostgreSQL.
Un pulsante con link all’articolo ufficiale delle note di rilascio per quel pacchetto.

Requisiti

Joomla! Downloader è volutamente leggero e basato su PHP puro, ma il server deve comunque avere alcune capacità di base per scaricare ed estrarre correttamente i pacchetti.

Requisito	Perché è importante	Note
PHP	Esegue lo script downloader	Usa una versione PHP supportata e compatibile con la release Joomla di destinazione.
cURL	Scarica i pacchetti dalle sorgenti ufficiali di Joomla	Necessario per il recupero affidabile dei pacchetti remoti.
Supporto ZIP	Estrae l’archivio Joomla scaricato	Il server deve poter validare e decomprimere file ZIP.
Permessi di scrittura	Crea file ed estrae Joomla nella directory di destinazione	Assicurati che l’utente del web server possa scrivere nella cartella di installazione.
Accesso via browser	Avvia l’interfaccia web	Il processo viene eseguito dal browser dopo aver caricato il file PHP.

Scenari supportati

Nuove installazioni Joomla
Setup di progetti cliente
Ambienti di staging e test
Sviluppo parallelo multi-sito
Connessioni locali a banda limitata

Passaggi di utilizzo

1. Carica lo script

Copia joomla_downloader.php nella web root di destinazione, ad esempio public_html/ o un’altra document root.

2. Aprilo nel browser

Avvia lo script dal browser, lascia che carichi l’elenco dei pacchetti Joomla disponibili e scegli la release che ti serve.

Processo di Joomla Downloader completato

3. Completa e installa Joomla

Dopo download, validazione, estrazione e pulizia finale, rimuovi lo script e continua con il normale wizard di installazione di Joomla.

Schermate passo-passo

Il processo completo è breve, ma mostrare ogni passaggio tecnico è utile per gli utenti che vogliono capire esattamente cosa sta facendo lo script. Per questo motivo, uno slideshow è la scelta migliore: mantiene la pagina più pulita continuando a documentare l’intero workflow.

Passaggio 1 - Caricamento dello script — Passaggio 1 — Carica il file `joomla_downloader.php` sul server di destinazione.

Passaggio 3 - Elenco dei pacchetti release — Passaggio 3 — Seleziona la release o il channel di Joomla che vuoi installare.

Passaggio 4 - Preparazione del download — Passaggio 4 — Lo script prepara il processo di download lato server.

Passaggio 5 - Download del pacchetto — Passaggio 5 — Joomla viene scaricato direttamente dal server sorgente al tuo ambiente hosting.

Passaggio 6 - Validazione archivio — Passaggio 6 — L’archivio scaricato viene validato prima dell’estrazione.

Passaggio 7 - Estrazione dei file — Passaggio 7 — Il pacchetto ZIP viene estratto direttamente nella directory di destinazione.

Passaggio 8 - Pulizia finale — Passaggio 8 — I file temporanei vengono rimossi per lasciare pulita la directory di installazione.

Passaggio 9 - Completato — Passaggio 9 — Il flusso di download ed estrazione è completato e Joomla è pronto per l’installazione.

Note di sicurezza

Joomla! Downloader è progettato con un workflow lineare e più sicuro. I materiali del progetto evidenziano come concetti chiave di sicurezza l’uso di sorgenti ufficiali, la validazione dell’archivio, i punti limitati di manipolazione e la pulizia finale.

Sorgenti ufficiali dei pacchetti

Usa il downloader solo con sorgenti Joomla affidabili configurate dal progetto.

Validazione dell’archivio

Il processo include la validazione del file ZIP prima dell’estrazione per ridurre problemi legati agli archivi.

Superficie di attacco minima

La documentazione del progetto evidenzia un flusso semplice senza parametri URL dei pacchetti liberamente manipolabili.

Rimuovi lo script

Dopo l’estrazione, elimina il file downloader per evitare che resti accessibile su un server pubblico.

Pratica consigliata

Usalo per installazioni nuove, non su un sito live già configurato.
Eseguilo nella root di destinazione solo quando sei pronto a installare Joomla.
Elimina lo script immediatamente dopo il completamento dell’estrazione.
Continua con l’installer standard di Joomla solo dopo aver controllato i file estratti.

Personalizzazione dei pacchetti

Joomla! Downloader può essere personalizzato facilmente modificando l’array $packagesConfig. Questo ti consente di decidere quali pacchetti Joomla mostrare nella schermata principale, così puoi semplificare l’interfaccia oppure esporre canali di release più avanzati per test e sviluppo.

// Configuration: packages to display on main page
$packagesConfig = array(
    // Stable releases
    array('server' => 'targets'),                       // Latest Joomla! stable
    array('server' => 'targets', 'channel' => '5.x'),  // Joomla! 5.x LTS
    # array('server' => 'j5'),                          // Joomla! 5.4
    # array('server' => 'j4'),                          // Joomla! 4.4
    # array('server' => 'stable'),                      // Joomla! 4.4
    # array('server' => 'maintenance'),                 // Joomla! 3.10

    // Release Candidates
    array('server' => 'targets', 'stability' => 'RC'),                         // Latest Release Candidate
    array('server' => 'targets', 'channel' => '5.x', 'stability' => 'RC'),    // Joomla! 5.x Release Candidate
    # array('server' => 'targets', 'stability' => 'Alpha'),                    // Latest Alpha Release
    # array('server' => 'targets', 'channel' => '6.x', 'stability' => 'Alpha'),// Joomla! 6.x Alpha Release
    # array('server' => 'test'),                                               // Joomla! 5.1 RC

    // Nightly builds
    array('server' => 'nightly-major'),
    array('server' => 'nightly-minor'),
    array('server' => 'nightly-patch'),
);

Perché personalizzarlo?

Mostrare solo pacchetti stabili per workflow orientati alla produzione.
Esporre release candidate, release alpha o nightly build per il testing.
Limitare il numero di opzioni visibili per clienti o utenti meno tecnici.
Creare un elenco pacchetti adatto ai branch Joomla preferiti dal tuo team.

Significato dei parametri

Ogni elemento all’interno di $packagesConfig indica allo script quale sorgente pacchetti o tipo di release deve essere mostrato nella pagina principale. Le chiavi più importanti sono server, channel e stability.

Parametro	Significato	Esempio
server	Identifica la sorgente dei pacchetti o il gruppo di release da interrogare. Definisce la famiglia generale dei pacchetti, ad esempio target standard, release di maintenance o nightly build.	`'server' => 'targets'`
channel	Restringe il risultato a uno specifico branch Joomla. È utile quando vuoi mostrare pacchetti relativi soltanto a una linea principale, come 5.x o 6.x.	`'channel' => '5.x'`
stability	Filtra i pacchetti in base al livello di maturità. I valori tipici includono fasi di release come RC o Alpha e aiutano a distinguere le versioni pronte per la produzione da quelle orientate ai test.	`'stability' => 'RC'`

Esempi pratici

array('server' => 'targets') mostra l’ultimo target stabile.
array('server' => 'targets', 'channel' => '5.x') limita i risultati a Joomla 5.x.
array('server' => 'targets', 'stability' => 'RC') mostra i pacchetti release candidate.
array('server' => 'nightly-major') espone nightly build per test avanzati.

Casi d’uso

Avviare un nuovo sito Joomla senza upload manuale del file ZIP ed estrazione manuale.
Preparare più progetti cliente con un workflow di setup ripetibile.
Creare rapidamente ambienti di staging.
Testare pacchetti alpha, release candidate o nightly quando disponibili.
Lavorare in ambienti con banda locale di upload limitata.
Ridurre il tempo di setup ripetitivo per sviluppatori e agenzie.

Pensato per deploy più rapidi

Il vantaggio principale non è solo la comodità: è un workflow di installazione più pulito che sfrutta la banda del server, riduce le operazioni manuali e lascia meno file temporanei residui.

Risoluzione problemi

Lo script non si apre

Controlla che il file sia stato caricato nella web root corretta e che l’esecuzione PHP sia abilitata per quella directory.

I pacchetti disponibili non vengono caricati

Verifica le connessioni in uscita, la disponibilità di cURL e le eventuali restrizioni server che possono bloccare le richieste remote.

Il download fallisce o si interrompe

Controlla limiti dell’hosting, restrizioni sulle connessioni remote, timeout e spazio disco disponibile.

L’estrazione non viene completata

Verifica che il supporto ZIP sia attivo e che la directory di destinazione sia scrivibile dall’utente del web server.

I file sembrano incompleti dopo l’estrazione

Elimina i file parziali, controlla lo spazio disco disponibile e ripeti il processo partendo da una directory pulita.

Passo successivo dopo il completamento

Una volta estratto il pacchetto, elimina lo script downloader e continua dal browser con il normale processo di installazione di Joomla.