log

log encontra ou abre arquivos de log, lê um início ou final limitado e filtra linhas sem carregar em memória um log em crescimento por inteiro.

DiagnósticoVersão 1.3.1Estável
lil-terminal

Visão geral

Use log para leitura operacional focada: encontre o arquivo, escolha as primeiras ou últimas linhas e filtre texto literal quando necessário. O comando nunca altera o log.

Reduza o log antes de ler

Logs operacionais crescem continuamente e costumam conter muito mais dados que uma única análise precisa. log reduz a tarefa a arquivo, janela limitada e filtro; em hospedagem compartilhada é mais rápido e seguro que abrir um log grande no editor.

Sintaxe

lil-terminal
log [<file>|<dir>] [-h] [-n <lines>] [-g <text>] [-i] [-l] [-r]

Referência

log

mostrar o log detectado mais recente

log <file>

ler o arquivo de log escolhido

log <dir>

encontrar um log no diretório

log -l

listar os logs detectados

log <dir> -l

listar os logs do diretório

-h

ler desde o início

-n <lines>

mostrar de 1 a 50000 linhas físicas

-g <text>

filtrar linhas que contêm texto literal

-i

ignorar maiúsculas e minúsculas com -g

-r

mostrar as linhas originais sem agrupamento

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.

Encontrar logs e ler uma cauda curta

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 log
Pacote Minimum

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

install log -m
Versão pública exata

Instalar exatamente esta versão publicada.

install log -v 1.3.1
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade log
Remover módulo

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

install log -u

Exemplos

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

Encontrar logs e ler uma cauda curta
log sandbox/logs/review.log
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()

[20-Oct-2026 08:00:02 UTC]
PHP Debug: using fallback configuration

[20-Oct-2026 08:00:03 UTC]
PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Ler desde o início
log sandbox/logs/review.log -h
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()

[20-Oct-2026 08:00:02 UTC]
PHP Debug: using fallback configuration

[20-Oct-2026 08:00:03 UTC]
PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Ler o arquivo de log escolhido
log sandbox/logs/review.log -t
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()

[20-Oct-2026 08:00:02 UTC]
PHP Debug: using fallback configuration

[20-Oct-2026 08:00:03 UTC]
PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Mostrar de 1 a 50000 linhas físicas
log sandbox/logs/review.log -n 2
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log

Stack trace:
#0 /sandbox/src/index.php(31): connect()
Mostrar de 1 a 50000 linhas físicas
log sandbox/logs/review.log -h -n 2
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Filtrar linhas que contêm texto literal
log sandbox/logs/review.log -g Warning
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log
Filter: Warning

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Ignorar maiúsculas e minúsculas com -g
log sandbox/logs/review.log -g warning -i
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log
Filter: warning

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Tratar um arquivo de log ausente
log sandbox/logs/review.log -g DEBUG
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log
Filter: DEBUG

[no matching lines]
Mostrar as linhas originais sem agrupamento
log sandbox/logs/review.log -g error -i -r
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log
Filter: error

[20-Oct-2026 08:00:03 UTC] PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Mostrar as linhas originais sem agrupamento
log sandbox/logs/review.log -r
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC] PHP Notice: request started in /sandbox/src/start.php on line 12
[20-Oct-2026 08:00:01 UTC] PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()
[20-Oct-2026 08:00:02 UTC] PHP Debug: using fallback configuration
[20-Oct-2026 08:00:03 UTC] PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Listar os logs detectados
log -l
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
2026-11-01 12:00:00	96 B	sandbox/logs/app.log
2026-11-01 12:00:00	219 B	sandbox/logs/errors.log
2026-10-20 08:00:00	487 B	sandbox/logs/review.log
Listar os logs do diretório
log sandbox -l
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
2026-11-01 12:00:00	96 B	sandbox/logs/app.log
2026-11-01 12:00:00	219 B	sandbox/logs/errors.log
2026-10-20 08:00:00	487 B	sandbox/logs/review.log
Encontrar um log no diretório
log sandbox
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/app.log

2026-01-01T00:00:00Z INFO sandbox initialized

2026-01-01T00:00:01Z DEBUG sample event completed
Filtrar linhas que contêm texto literal
log sandbox/logs/review.log -g no-such-event
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
File: sandbox/logs/review.log
Filter: no-such-event

[no matching lines]
Ler o arquivo de log escolhido
log sandbox/logs/missing.log
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Log file not found
Mostrar de 1 a 50000 linhas físicas
log sandbox/logs/review.log -n 0
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Line count must be between 1 and 50000
Mostrar de 1 a 50000 linhas físicas
log sandbox/logs/review.log -n 50001
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Line count must be between 1 and 50000
Mostrar de 1 a 50000 linhas físicas
log sandbox/logs/review.log -n abc
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Invalid line count
Ignorar maiúsculas e minúsculas com -g
log sandbox/logs/review.log -i
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Option -i requires -g <text>
Filtrar linhas que contêm texto literal
log sandbox/logs/review.log -g
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Search text is required
Ler o arquivo de log escolhido
log sandbox/logs/review.log -z
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Unknown option: -z
Ler o arquivo de log escolhido
log sandbox/logs/review.log -l
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
List mode accepts a directory, not a file
Filtrar linhas que contêm texto literal
log sandbox -l -g error
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
List mode does not accept a search filter
Ler o arquivo de log escolhido
log sandbox/logs/review.log sandbox/logs/review.log
Exemplo didático — ambiente PHP, servidor e respostas do repositório simulados
Too many paths

Arquivo usado neste exemplo: sandbox/logs/app.log

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed

Documentação relacionada

Quais são os requisitos do servidor? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.3.12026-10-31

Refinamento de produção

Versão estável atual de log. log encontra ou abre arquivos de log, lê um início ou final limitado e filtra linhas sem carregar em memória um log em crescimento por inteiro.

# Histórico de versões