upgrade

Resumen

upgrade convierte el mantenimiento de módulos en un proceso previsible: permite revisar el plan, actualizar un módulo o toda la instalación, reparar dependencias compatibles y, con run instalado, ejecutar opcionalmente una comprobación o actualización al iniciar cada sesión autorizada.

Revisa el plan antes de sustituir código

upgrade -c analiza versiones, paquetes y dependencias sin escribir código de módulos. La actualización real conserva paquete y repositorio, reemplaza módulos de forma atómica y usa install solo para una dependencia obligatoria completamente ausente.

Sintaxis

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

Referencia

Manual de upgrade

Minimum solo permite actualizar todos los módulos o uno específico. La comprobación -c, varios nombres y los modos automáticos requieren Base.

Antes de tocar un sitio en producción, ejecuta upgrade -c: revisa versiones y dependencias sin sustituir código PHP. upgrade hash -c comprueba solo ese módulo.

upgrade hash actualiza o repara un módulo instalado y conserva su edición Base/Minimum y su repositorio. Sin argumentos trabaja con todos los módulos instalados. Para añadir uno nuevo se necesita install.

upgrade -auto check programa una comprobación al inicio de una sesión autorizada mediante run y autoload.lil. -auto update puede reemplazar código PHP automáticamente; está desactivado de forma predeterminada. Consulta upgrade -info y desactívalo con -auto off. Los comandos Core, como cd, requieren sustituir lil.php.

Planificación

Cada marcador instalado conserva repositorio, versión, paquete Base o Minimum y generación de lil.core. upgrade resuelve en el mismo repositorio la versión pública compatible más reciente, mantiene el paquete elegido, valida la compatibilidad y nunca rebaja una versión local que vaya por delante.

Actualización y reparación

Los módulos existentes se descargan, normalizan, analizan, comprueban frente a conflictos de métodos y se sustituyen de forma atómica. Las dependencias se revisan por repositorio, paquete, versión y generación del núcleo. upgrade actualiza por sí mismo una dependencia ya instalada; solo una dependencia totalmente ausente se entrega a install.

Modo de comprobación

-c realiza el mismo análisis de versiones, paquetes y dependencias sin descargar el código fuente del módulo ni escribir el archivo de extensiones. Es el primer paso recomendado antes de una actualización manual o automática en una instalación importante.

Modo automático

El modo automático opcional reutiliza el mecanismo de arranque de run y su archivo autoload.lil. upgrade modifica únicamente su bloque marcado # <upgrade:auto> y conserva todas las demás líneas. check guarda upgrade -c, update guarda upgrade y off elimina solo ese bloque. check y update son mutuamente excluyentes.

Como autoload.lil se ejecuta una vez por sesión autorizada, la acción elegida ocurre después de iniciar sesión y no antes de cada comando. El modo automático requiere run. upgrade -info muestra el modo actual sin escribir.

Seguridad

La actualización automática está desactivada de forma predeterminada. update descarga y sustituye código PHP ejecutable, por lo que debe usarse únicamente con un repositorio de confianza. Si los cambios deben seguir siendo explícitos, utilice check. upgrade -auto off elimina la acción administrada en cualquier momento.

Formato del resumen

Las comprobaciones y actualizaciones de toda la instalación comienzan con un total compacto, muestran los módulos modificados en filas que empiezan por las versiones —por ejemplo v1.30 > v1.33 help ⌘— y terminan con contadores como Actuales: 10. Así resulta fácil comparar varias actualizaciones de un vistazo.

Los comandos integrados cd y core pertenecen a Core; upgrade muestra su estado, pero para actualizarlos hay que sustituir lil.php.

Los paquetes Base se marcan con ⌘; Minimum conserva la etiqueta (minimum).

Resultado de un módulo

Al comprobar o actualizar un solo módulo se muestran únicamente las versiones y el marcador del paquete, por ejemplo, v1.1.5 ⌘ o v1.1.4 > v1.1.5 ⌘. No se repiten el nombre ni Current/Available. Si falta el código fuente, se reintenta una vez la misma versión.

upgrade acepta varios módulos en una sola orden, incluso con -c. Solo se modifican los módulos seleccionados y sus dependencias necesarias.

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Status  All 3 modules are current
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
All installed extension modules are current
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
v1.1.4
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
v1.1.4
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
v1.1.5
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
All 3 selected modules are current
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Built-in  core · Core v1.5.x
Update    replace lil.php to update
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Automatic upgrade  Off
Script             autoload.lil
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
missing_module: not installed

Resultado de ejemplo preparado; Play no modifica tu instalación.
?

Resultado de ejemplo preparado; Play no modifica tu instalación.
?

Resultado de ejemplo preparado; Play no modifica tu instalación.
?

Resultado de ejemplo preparado; Play no modifica tu instalación.
v1.4.8
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
v1.3.6
El resultado depende de los paquetes instalados y del repositorio.

Resultado de ejemplo preparado; Play no modifica tu instalación.
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
El resultado depende de los paquetes instalados y del repositorio.

Comandos relacionados

Un enlace violeta a un comando indica que esa función usa otro módulo. Abre el comando enlazado para ver qué aporta y cómo instalarlo.

Documentación relacionada