upgrade

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

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

Referência

Manual do upgrade

Minimum só atualiza todos os módulos ou um módulo específico. Consulta -c, seleção múltipla e automação exigem Base.

Antes de alterar um site em produção, execute upgrade -c: ele verifica versões e dependências sem substituir código PHP. upgrade hash -c limita a consulta a um módulo.

upgrade hash atualiza ou repara o módulo instalado, mantendo sua edição Base/Minimum e seu repositório. Sem argumentos, trabalha com todos os módulos instalados. Um módulo ausente deve ser instalado com install.

upgrade -auto check configura uma verificação no início da sessão autorizada via run e autoload.lil. -auto update pode trocar código PHP automaticamente e vem desligado. Consulte upgrade -info e desligue com -auto off. Para comandos Core como cd, é preciso substituir lil.php.

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 ⌘ — e terminam com contadores como Atuais: 10. Isso facilita comparar várias atualizações de uma só vez.

Os comandos internos cd e core fazem parte do Core; upgrade mostra seu estado, mas para atualizá-los é preciso substituir lil.php.

Os pacotes Base são marcados com ⌘; Minimum continua indicado como (minimum).

Resultado de um módulo

Ao verificar ou atualizar um módulo, aparecem apenas as versões e o marcador do pacote, como v1.1.5 ⌘ ou v1.1.4 > v1.1.5 ⌘. O nome e os rótulos Current/Available não são repetidos. Se o código-fonte estiver indisponível, a mesma versão será solicitada novamente uma vez.

upgrade agora aceita vários nomes de módulos no mesmo comando, inclusive com -c. Somente os módulos selecionados e dependências necessárias são alterados.

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.

Exemplos

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

Resultado didático preparado; Play não altera a sua instalação.
Status  All 3 modules are current
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
All installed extension modules are current
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
v1.1.4
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
v1.1.4
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
v1.1.5
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
All 3 selected modules are current
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Built-in  core · Core v1.5.x
Update    replace lil.php to update
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Automatic upgrade  Off
Script             autoload.lil
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
missing_module: not installed

Resultado didático preparado; Play não altera a sua instalação.
?

Resultado didático preparado; Play não altera a sua instalação.
?

Resultado didático preparado; Play não altera a sua instalação.
?

Resultado didático preparado; Play não altera a sua instalação.
v1.4.8
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
v1.3.6
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
O resultado depende dos pacotes instalados e do repositório.

Comandos relacionados

Um link roxo para um comando indica que esse recurso usa outro módulo. Abra o comando vinculado para ver o que ele oferece e como instalá-lo.

Documentação relacionada