upgrade

Panoramica

upgrade rende prevedibile la manutenzione dei moduli: prima si controlla il piano, poi si aggiorna un singolo modulo o tutta l’installazione, si riparano le dipendenze compatibili e, con run, si può eseguire una verifica o un aggiornamento all’avvio di ogni sessione autorizzata.

Controllare il piano prima di sostituire il codice

upgrade -c analizza versioni, pacchetti e dipendenze senza scrivere codice dei moduli. L’aggiornamento reale conserva pacchetto e repository, sostituisce atomicamente e usa install solo quando una dipendenza obbligatoria manca del tutto.

Sintassi

upgrade [module ...] [-c] · upgrade -auto <check|update|off> · upgrade -info

Riferimento

Manuale di upgrade

In Minimum si possono aggiornare tutti i moduli o uno solo. Verifica -c, selezione multipla e automazione richiedono Base.

Prima di cambiare un sito attivo, esegui upgrade -c: controlla versioni e dipendenze senza sostituire il codice PHP. upgrade hash -c limita il controllo a un modulo.

upgrade hash aggiorna o ripara un modulo installato conservando edizione Base/Minimum e repository. Senza argomenti controlla tutti i moduli presenti. Per aggiungerne uno nuovo serve install.

upgrade -auto check attiva il controllo all’avvio della sessione autorizzata tramite run e autoload.lil. -auto update può sostituire automaticamente il codice PHP ed è disattivato per impostazione predefinita. Verifica con upgrade -info, disattiva con -auto off. Per i comandi Core come cd occorre sostituire lil.php.

Pianificazione

Ogni marcatore installato conserva repository, versione, pacchetto Base o Minimum e generazione di lil.core. upgrade individua nello stesso repository la versione pubblica compatibile più recente, mantiene il pacchetto scelto, verifica i metadati di compatibilità e non esegue mai il downgrade di una versione locale più avanzata.

Aggiornamento e riparazione

I moduli esistenti vengono scaricati, normalizzati, analizzati, controllati per eventuali conflitti di metodi e sostituiti in modo atomico. Le dipendenze vengono verificate per repository, pacchetto, versione e generazione del core. upgrade aggiorna direttamente una dipendenza già installata; solo una dipendenza del tutto assente viene affidata a install.

Modalità di controllo

-c esegue la stessa analisi di versioni, pacchetti e dipendenze senza scaricare il sorgente del modulo né scrivere il file delle estensioni. È il primo passo consigliato prima di un aggiornamento manuale o automatico su un’installazione importante.

Modalità automatica

La modalità automatica opzionale riutilizza il meccanismo di avvio di run e il relativo file autoload.lil. upgrade modifica soltanto il proprio blocco marcato # <upgrade:auto> e conserva tutte le altre righe. check memorizza upgrade -c, update memorizza upgrade e off rimuove soltanto quel blocco. check e update sono mutuamente esclusivi.

Poiché autoload.lil viene eseguito una volta per sessione autorizzata, l’azione scelta parte dopo l’accesso e non prima di ogni comando. È necessario il modulo run. upgrade -info mostra la modalità corrente senza scrivere.

Sicurezza

L’aggiornamento automatico è disattivato per impostazione predefinita. update scarica e sostituisce codice PHP eseguibile, quindi va usato esclusivamente con un repository attendibile. Se le modifiche devono restare esplicite, scegliere check. upgrade -auto off rimuove l’azione gestita in qualsiasi momento.

Formato del riepilogo

I controlli e gli aggiornamenti dell’intera installazione iniziano con un totale compatto, mostrano i moduli modificati con righe che partono dalle versioni — per esempio v1.30 > v1.33 help ⌘ — e terminano con contatori come Aggiornati: 10. In questo modo più aggiornamenti si confrontano rapidamente.

I comandi integrati cd e core seguono la versione di Core; upgrade ne mostra lo stato, ma per aggiornarli bisogna sostituire lil.php.

I pacchetti Base sono indicati con ⌘; Minimum mantiene (minimum).

Risultato per un modulo

La verifica o l’aggiornamento di un singolo modulo mostra soltanto le versioni e il simbolo del pacchetto, ad esempio v1.1.5 ⌘ o v1.1.4 > v1.1.5 ⌘. Nome e diciture Current/Available non vengono ripetuti. Se il sorgente non è disponibile, la stessa versione viene richiesta una seconda volta.

upgrade accetta più nomi di moduli in una sola chiamata, anche con -c. Vengono modificati solo i moduli selezionati e le dipendenze necessarie.

Installa e gestisci

Installa la versione compatibile corrente. Scegli Base per tutte le funzioni o Minimum per il pacchetto ridotto; usa upgrade per aggiornare un modulo già installato.

Base e Minimum sono due pacchetti della stessa release corrente del modulo.

Esempi

Gli esempi sono copiabili ma il sito non li esegue. Controlla percorsi, permessi e opzioni distruttive.

Risultato didattico preparato: Play non modifica la tua installazione.
Status  All 3 modules are current
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
All installed extension modules are current
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
v1.1.4
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
v1.1.4
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
v1.1.5
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
All 3 selected modules are current
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Built-in  core · Core v1.5.x
Update    replace lil.php to update
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Automatic upgrade  Off
Script             autoload.lil
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
missing_module: not installed

Risultato didattico preparato: Play non modifica la tua installazione.
?

Risultato didattico preparato: Play non modifica la tua installazione.
?

Risultato didattico preparato: Play non modifica la tua installazione.
?

Risultato didattico preparato: Play non modifica la tua installazione.
v1.4.8
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
v1.3.6
Il risultato dipende dai pacchetti installati e dal repository.

Risultato didattico preparato: Play non modifica la tua installazione.
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
Il risultato dipende dai pacchetti installati e dal repository.

Comandi correlati

Un link viola a un comando indica che quella funzione usa un altro modulo. Apri il comando collegato per vedere cosa offre e come installarlo.

Documentazione correlata