replace

replace altera o texto dentro dos arquivos, não seus nomes. Sem -w, apenas lista arquivos e ocorrências. Para subpastas, use -r.

DesenvolvimentoVersão 1.1.5Estável
lil-terminal

Visão geral

-e txt,php filtra extensões e -g "*.php" filtra nomes. -i ignora maiúsculas no texto simples; -p aceita regex PHP completa. -a inclui pastas de dependências e cache.

Conferir o alcance antes de gravar

-w -b cria .bak, .bak-001 etc. sem substituir backups anteriores. A busca recursiva os ignora. Binários e arquivos acima de 4 MiB são ignorados; limite de 5000 arquivos.

Sintaxe

lil-terminal
replace <old> <new> [path] [options]

Referência

replace <old> <new>

pré-visualizar nos arquivos do diretório atual

replace <old> <new> <file>

pré-visualizar em um arquivo

replace <old> <new> <dir> -r

pré-visualizar recursivamente em um diretório

-w

gravar atomicamente as alterações planejadas

-i

procurar texto sem diferenciar maiúsculas e minúsculas

-p

usar <old> como expressão regular PHP completa

-e <exts>

limitar extensões, por exemplo php,js,css ou tar.gz

-g <glob>

limitar nomes com glob como *.php

-b

criar cópias .bak antes de gravar

-a

incluir vendor, node_modules, VCS e cache

Prévia antes de gravar

replace altera o texto dentro dos arquivos, não seus nomes. Sem -w, apenas lista arquivos e ocorrências. Para subpastas, use -r.

Selecione os arquivos certos

-e txt,php filtra extensões e -g "*.php" filtra nomes. -i ignora maiúsculas no texto simples; -p aceita regex PHP completa. -a inclui pastas de dependências e cache.

Cópias de segurança

-w -b cria .bak, .bak-001 etc. sem substituir backups anteriores. A busca recursiva os ignora. Binários e arquivos acima de 4 MiB são ignorados; limite de 5000 arquivos.

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.

Prévia da alteração

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

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

install replace -m
Versão pública exata

Instalar exatamente esta versão publicada.

install replace -v 1.1.5
Verificar ou atualizar

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

upgrade replace
Remover módulo

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

install replace -u

Exemplos

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

Prévia da alteração
cd \sandbox | replace draft published workspace/replace.txt
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Gravar alterações
replace draft published \sandbox\workspace\replace.txt -w
Replaced                   2 occurrences in 1 file
workspace/replace.txt      2
Ignorar maiúsculas
replace DRAFT published \sandbox\workspace\replace.txt -i
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Usar expressão regular
replace "~draft~" published \sandbox\workspace\replace.txt -p
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Filtrar por extensão
replace draft published \sandbox\workspace -r -e txt
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Filtrar por nome
replace draft published \sandbox\workspace -r -g "*.txt"
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Gravar com backup
replace draft published \sandbox\workspace\replace.txt -w -b
Replaced                   2 occurrences in 1 file
workspace/replace.txt      2

Backups                    1
workspace/replace.txt.bak
Incluir dependências
replace draft published \sandbox\workspace -r -a -e txt
Preview                3 replacements in 2 files
workspace/replace.txt  2
workspace/vendor/review.txt  1

Write                  use -w to apply changes
Prévia da pasta
replace draft published \sandbox\workspace
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Verificar destino ausente
replace draft published \sandbox\missing.txt
Caminho não encontrado
Recusar regex inválida
replace draft published \sandbox\workspace\replace.txt -p
Invalid regular expression
Guardar um segundo backup numerado
replace draft published \sandbox\workspace\replace.txt -w -b | replace published final \sandbox\workspace\replace.txt -w -b
Replaced                   2 occurrences in 1 file
workspace/replace.txt      2

Backups                    1
workspace/replace.txt.bak

Replaced                   2 occurrences in 1 file
workspace/replace.txt      2

Backups                    1
workspace/replace.txt.bak-001

Arquivo usado neste exemplo: sandbox/workspace/replace.txt

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

status=draft
owner=lil
status=draft

Documentação relacionada

Os exemplos da documentação são reais? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.1.52026-10-31

Numbered backups

A busca em diretórios ignora .bak e .bak-001; backups ainda podem ser indicados pelo caminho explícito.

# Histórico de versões