install

Visão geral

Use install para instalação determinística de módulos: escolha Base ou Minimum, fixe uma versão compatível exata, defina repository ou extension file conscientemente e deixe atualizações de módulos instalados para upgrade.

Instalação e atualização são operações diferentes

install adiciona ou remove módulos e escolhe Base, Minimum, versão exata ou outro repositório. Quando o módulo já está instalado, substituir versão e reparar dependências pertence a upgrade.

Sintaxe

install [mod ...] [repo] [options]

Referência

Manual do install

Minimum aceita instalação e remoção básicas; inspeção detalhada, troca do arquivo de extensões e opções avançadas exigem Base.

Falta um comando no terminal? install hash baixa o módulo PHP compatível, verifica as dependências e o adiciona ao arquivo de extensões. install -l lista apenas o que já está instalado.

Base oferece todas as funções; -m seleciona Minimum quando essa edição existe. Use -i para conferir requisitos e -v para escolher uma versão compatível específica. Para atualizar módulos instalados, use upgrade.

install hash -u ou uninstall hash remove o módulo, mas não comandos do Core nem dependências exigidas por outros módulos. Operações em lote têm resultados separados. Repositórios externos distribuem código PHP executável: confira a origem antes de usar.

Detalhes

Base contém toda a funcionalidade atual; Minimum só existe quando o módulo o publica. O código baixado tem limite de tamanho, é analisado como trait, verificado quanto ao método e conflitos e gravado por arquivo temporário e renomeação atômica.

Segurança

O código PHP remoto passa a fazer parte do lil-terminal. Use um repositório HTTPS confiável; validação e gravação atômica evitam corrupção, mas não determinam a intenção do código.

Comandos secundários

Os nomes secundários documentados são resolvidos para o módulo proprietário: download (independent), patch → diff, coo → ses, read → echo e mariadb → mysql. Eles compartilham o mesmo fluxo de versões do módulo proprietário.

Instalação interativa automática

O Base core atual do lil pode chamar o Installer pelo prefixo @command. Esse caminho é propositalmente mais restrito que um install explícito: ele resolve o módulo proprietário canônico, usa somente o repositório lil padrão, seleciona a versão Base pública atual, oculta o relatório de instalação e retoma o comando interativo original. Não seleciona Minimum, versões development nem repositórios personalizados. Para essas escolhas, permanece a interface explícita install.

Operações com vários módulos

install dns pwd del instala em ordem cada módulo Base informado. Vírgulas e ponto e vírgula também podem separar os nomes. uninstall dns pwd del remove cada módulo de forma independente e informa todos os resultados, portanto uma falha não esconde o estado dos itens seguintes. Opções referentes a um módulo, repositório ou arquivo específico continuam na forma normal de módulo único.

Fontes do repositório

O argumento <repo> pode apontar para outro repositório HTTPS ou para um diretório local com a mesma estrutura de repositório. Fontes locais são úteis em testes controlados; o repositório lil continua sendo o padrão.

Relatórios de dependências

Quando o módulo solicitado precisa primeiro instalar ou atualizar uma dependência obrigatória, o relatório da dependência e o do módulo solicitado são separados por uma linha em branco. Operações em lote com install e uninstall também mantêm cada resultado em um bloco visual próprio.

Marcadores de pacote e remoção segura

Os resultados de instalação e a lista de módulos exibem ⌘ para Base e (minimum) para Minimum. No Minimum, a remoção verifica as dependências e atualiza o arquivo de extensões de forma atômica.

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.
run setup.lil (if present)
O resultado depende dos pacotes instalados e do repositório.

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

Resultado didático preparado; Play não altera a sua instalação.
@help hash -i — detailed command reference
Packages: base / minimum
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Installed hash, v1.1.4
    repo.lil.dog > extensions.php
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Installed hash, v1.1.4 (minimum)
    repo.lil.dog > extensions.php
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
@help hash -i — detailed command reference
Packages: base / minimum
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
@help hash -i — detailed command reference
Version: 1.1.4
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Installed pwd, v1.1.5

Installed dns, v1.2.4
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Installed pwd, v1.1.5

Installed dns, v1.2.4

Installed hash, 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.
Installed code, v1.3.7
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
ping: no version compatible with lil.core.v1
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
@help code -i — detailed command reference
O resultado depende dos pacotes instalados e do repositório.

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

Resultado didático preparado; Play não altera a sua instalação.
@help diff -i — detailed command reference
O resultado depende dos pacotes instalados e do repositório.

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

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

Removed dns
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
core: built-in command cannot be uninstalled

Resultado didático preparado; Play não altera a sua instalação.
Ext  sandbox/tmp/extensions.php
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Ext  (default extension file)
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
Installed pwd, v1.1.5
    repo.lil.dog > sandbox/tmp/extensions.php
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.
missing_module: no version compatible with lil.core.v1

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

Resultado didático preparado; Play não altera a sua instalação.
@help pwd -i — detailed command reference
Package: minimum
O resultado depende dos pacotes instalados e do repositório.

Resultado didático preparado; Play não altera a sua instalação.
@help dns -i — detailed command reference
Version: 1.2.4
O resultado depende dos pacotes instalados e do repositório.

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

Resultado didático preparado; Play não altera a sua instalação.
Installed hash, v1.1.4
    repo.lil.dog > sandbox/tmp/extensions.php
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