upgrade

upgrade verifica as versões dos módulos instalados, planeja atualizações, substitui blocos existentes e repara dependências já instaladas. A instalação de um módulo totalmente ausente continua sendo responsabilidade de install.

SistemaVersão 1.3.1Estável
lil-terminal

Visão geral

upgrade transforma a manutenção dos módulos em um fluxo previsível: primeiro confira o plano, depois atualize um módulo ou toda a instalação, repare dependências compatíveis e, com run instalado, opcionalmente faça uma verificação ou atualização no início de cada sessão autorizada.

Confira o plano antes de substituir código

upgrade -c analisa versões, pacotes e dependências sem gravar código de módulos. A atualização real preserva pacote e repositório, substitui módulos atomicamente e usa install apenas quando uma dependência obrigatória está totalmente ausente.

Sintaxe

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

Referência

upgrade

atualizar todos os módulos de extensão instalados

upgrade <module>

atualizar (ou reparar) o módulo indicado

upgrade -c

verificar versões, pacotes e dependências (sem gravar)

upgrade <module> -c

verificar a versão de um módulo (sem gravar)

upgrade -auto check @run

verificar atualizações uma vez por sessão autorizada via autoload.lil

upgrade -auto update @run

tentar atualizar uma vez por sessão autorizada via autoload.lil

upgrade -auto off

desativar as ações automáticas gerenciadas por upgrade

upgrade -info

mostrar o modo automático e o estado de autoload.lil

Planejamento

Cada marcador instalado registra repositório, versão, pacote Base ou Minimum e geração do lil.core. upgrade procura no mesmo repositório a versão pública compatível mais recente, mantém o pacote escolhido, valida os metadados de compatibilidade e nunca rebaixa uma versão local que esteja à frente.

Atualização e reparo

Os módulos existentes são baixados, normalizados, analisados, verificados quanto a conflitos de métodos e substituídos de forma atômica. As dependências são conferidas por repositório, pacote, versão e geração do núcleo. upgrade atualiza por conta própria uma dependência já instalada; somente uma dependência totalmente ausente é encaminhada ao install.

Modo de verificação

-c executa a mesma análise de versões, pacotes e dependências sem baixar o código-fonte do módulo nem gravar o arquivo de extensões. É o primeiro passo recomendado antes de uma atualização manual ou automática em uma instalação importante.

Modo automático

O modo automático opcional reutiliza o mecanismo de inicialização do run e seu arquivo autoload.lil. upgrade altera apenas o próprio bloco marcado # <upgrade:auto> e preserva todas as demais linhas. check grava upgrade -c, update grava upgrade e off remove somente esse bloco gerenciado. check e update são mutuamente exclusivos.

Como autoload.lil roda uma vez por sessão autorizada, a ação escolhida ocorre após a autenticação e não antes de cada comando. O modo automático requer run. upgrade -info mostra o modo atual sem gravar.

Segurança

A atualização automática fica desativada por padrão. update baixa e substitui código PHP executável dos módulos; use somente um repositório confiável. Se as mudanças precisarem permanecer explícitas, prefira check. upgrade -auto off remove a ação gerenciada a qualquer momento.

Formato do resumo

Verificações e atualizações de toda a instalação começam com um total compacto, mostram os módulos alterados em linhas iniciadas pelas versões — por exemplo v1.30 > v1.33 help (base) — e terminam com contadores como Atuais: 10. Isso facilita comparar várias atualizações de uma só vez.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Atualizar todos os módulos de extensão instalados

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install upgrade
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install upgrade -m
Versão pública exata

Instalar exatamente esta versão publicada.

install upgrade -v 1.3.1
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install upgrade -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Atualizar todos os módulos de extensão instalados
upgrade -c | upgrade
Disponíveis: 4 de 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Atuais: 9
À frente: 1

Atualizados 4 de 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Atuais: 9
À frente: 1
Verificar versões, pacotes e dependências (sem gravar)
upgrade -c
Disponíveis: 4 de 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Atuais: 9
À frente: 1
Verificar a versão de um módulo (sem gravar)
upgrade help -c
Disponíveis: 1 de 1
                v1.30	>	v1.33	help (base)
Atualizar (ou reparar) o módulo indicado
upgrade help
Atualizados 1 de 1
                v1.30	>	v1.33	help (base)
Atualizar todos os módulos de extensão instalados
upgrade
Atualizados 4 de 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Atuais: 9
À frente: 1
Verificar atualizações uma vez por sessão autorizada via autoload.lil
upgrade -auto check
Automatic upgrade  Check only
Session command    upgrade -c
Script             autoload.lil

Grava uma única linha gerenciada upgrade -c em autoload.lil. Na próxima sessão autorizada, run executa a verificação uma vez, mostra o que está disponível e não altera módulos.

Mostrar o modo automático e o estado de autoload.lil
upgrade -info
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil

upgrade -info lê o bloco gerenciado de inicialização e informa se o automático está desligado, em somente verificação ou em atualização. Não altera autoload.lil.

Tentar atualizar uma vez por sessão autorizada via autoload.lil
upgrade -auto update
Automatic upgrade  Update automatically
Session command    upgrade
Script             autoload.lil

Substitui a verificação gerenciada por upgrade. Pode baixar e substituir código executável dos módulos uma vez por sessão autorizada; habilite apenas com um repositório confiável.

Desativar as ações automáticas gerenciadas por upgrade
upgrade -auto off
Automatic upgrade  Off
Script             autoload.lil
Atualizar (ou reparar) o módulo indicado
upgrade missing_module
missing_module: não instalado

Documentação relacionada

Como funcionam as atualizações? →Qual é a diferença entre Base e Minimum? →Como instalar um módulo? →Por que um comando responde “command not found”? →

Versão pública atual

v1.3.12026-08-11

Integração com arquivos

Versão estável atual de upgrade. upgrade verifica as versões dos módulos instalados, planeja atualizações, substitui blocos existentes e repara dependências já instaladas.

# Histórico de versões