upgrade

Vue d’ensemble

upgrade rend la maintenance des modules prévisible : vérifier d’abord le plan, mettre à jour un module ou toute l’installation, réparer les dépendances compatibles et, avec run, déclencher au choix une vérification ou une mise à jour au début de chaque session autorisée.

Vérifier le plan avant de remplacer le code

upgrade -c analyse versions, paquets et dépendances sans écrire le code des modules. Une mise à jour réelle conserve paquet et dépôt, remplace atomiquement et appelle install uniquement pour une dépendance obligatoire totalement absente.

Syntaxe

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

Référence

Guide de upgrade

Minimum permet uniquement de mettre à jour tous les modules ou un module nommé. La vérification -c, les sélections multiples et l’automatisation nécessitent Base.

Avant de modifier un site en service, lancez upgrade -c : la commande vérifie versions et dépendances sans remplacer le code PHP. upgrade hash -c limite l’analyse à un module.

upgrade hash met à jour ou répare un module installé, tout en conservant son édition Base/Minimum et son dépôt. Sans nom, il traite tous les modules installés. Les modules absents relèvent de install.

upgrade -auto check programme une vérification à l’ouverture d’une session autorisée via run et autoload.lil. -auto update peut modifier automatiquement le code PHP et reste désactivé par défaut. Consultez upgrade -info, puis désactivez avec -auto off. Pour cd et les autres commandes Core, remplacez lil.php.

Planification

Chaque marqueur installé conserve le dépôt, la version, le paquet Base ou Minimum et la génération de lil.core. upgrade recherche dans ce même dépôt la version publique compatible la plus récente, conserve le paquet choisi, valide les métadonnées de compatibilité et ne rétrograde jamais une version locale plus récente.

Mise à jour et réparation

Les modules existants sont téléchargés, normalisés, analysés, vérifiés contre les conflits de méthodes puis remplacés atomiquement. Les dépendances sont contrôlées selon le dépôt, le paquet, la version et la génération du noyau. upgrade met lui-même à jour une dépendance déjà installée ; seule une dépendance totalement absente est confiée à install.

Mode de vérification

-c effectue la même analyse des versions, paquets et dépendances sans télécharger le code source ni écrire le fichier d’extensions. C’est le meilleur premier geste avant une mise à jour manuelle ou automatique sur une installation importante.

Mode automatique

Le mode automatique facultatif réutilise le démarrage de run et son fichier autoload.lil. upgrade ne modifie que son bloc balisé # <upgrade:auto> et préserve toutes les autres lignes. check enregistre upgrade -c, update enregistre upgrade et off supprime uniquement ce bloc. check et update sont exclusifs l’un de l’autre.

Comme autoload.lil s’exécute une fois par session autorisée, l’action choisie intervient après l’authentification et non avant chaque commande. Le module run est requis. upgrade -info affiche le mode courant sans écrire.

Sécurité

La mise à jour automatique est désactivée par défaut. update télécharge et remplace du code PHP exécutable : utilisez uniquement un dépôt de confiance. Si toute modification doit rester explicite, préférez check. upgrade -auto off permet de retirer l’action gérée à tout moment.

Présentation du résumé

Les vérifications et mises à jour de toute l’installation commencent par un total compact, affichent les modules modifiés dans des lignes commençant par les versions — par exemple v1.30 > v1.33 help ⌘ — puis se terminent par des compteurs tels que À jour : 10. Plusieurs mises à jour se comparent ainsi d’un coup d’œil.

Les commandes intégrées cd et core suivent la version de Core ; upgrade signale leur état, mais la mise à jour nécessite de remplacer lil.php.

Les paquets Base portent ⌘ ; les paquets Minimum gardent la mention (minimum).

Résultat pour un module

La vérification ou la mise à jour d’un seul module affiche seulement les versions et le symbole du paquet, par exemple v1.1.5 ⌘ ou v1.1.4 > v1.1.5 ⌘. Le nom et les mentions Current/Available ne sont pas répétés. Si le source est indisponible, la même version est demandée une seconde fois.

upgrade accepte plusieurs noms de modules dans un seul appel, y compris avec -c. Seuls les modules choisis et leurs dépendances nécessaires sont modifiés.

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

Exemple préparé : Play ne modifie pas votre installation.
Status  All 3 modules are current
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
All installed extension modules are current
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
v1.1.4
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
v1.1.4
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
v1.1.5
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
All 3 selected modules are current
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Built-in  core · Core v1.5.x
Update    replace lil.php to update
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Automatic upgrade  Off
Script             autoload.lil
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
missing_module: not installed

Exemple préparé : Play ne modifie pas votre installation.
?

Exemple préparé : Play ne modifie pas votre installation.
?

Exemple préparé : Play ne modifie pas votre installation.
?

Exemple préparé : Play ne modifie pas votre installation.
v1.4.8
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
v1.3.6
Le résultat dépend des paquets installés et du dépôt.

Exemple préparé : Play ne modifie pas votre installation.
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
Le résultat dépend des paquets installés et du dépôt.

Commandes associées

Un lien de commande violet indique que cette fonction utilise un autre module. Ouvrez la commande liée pour voir ce qu’elle apporte et comment l’installer.

Documentation associée