`replace`

replace mostra primeiro a prévia de substituições de texto ou expressões regulares e não grava nada sem -w. Caminho, extensão e glob podem limitar o alcance.

DesenvolvimentoVersão 1.1.4Estável

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/replace debug false config -r -w -bWrite config Files 2 Replaced 2 Backups 2replace debug false config -r -e iniPreview config Extensions ini Files 1 Matches 1 Would write 1replace vendor_name package_name . -r -aPreview . Hidden included Matches 1 Would write 1

Visão geral

Use quando a mesma alteração textual precisa atingir vários arquivos. Mantenha a primeira execução como prévia, confira arquivos e ocorrências e só depois repita o comando com -w.

Conferir o alcance antes de gravar

Comece, por exemplo, com replace debug false config -r -e ini: apenas arquivos e contagens são mostrados. Adicione -w quando a lista estiver correta e -b se quiser cópias .bak antes da alteração em massa.

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

Escolher o alcance

Sem caminho, usa o diretório atual. Subdiretórios só são percorridos com -r. -e <exts> filtra extensões e -g <glob> nomes. Dependências, VCS e cache são ignorados sem -a; links simbólicos nunca são processados.

Prévia e gravação

A prévia é padrão e mostra contagens por arquivo. Repita com -w para gravar. -b cria .bak primeiro e para se a cópia já existir. -i vale para texto simples; -p espera uma regex PHP completa com delimitadores.

Limites e segurança

No máximo 5000 arquivos são examinados; binários e arquivos acima de 4 MiB são ignorados. O relatório lista no máximo 500 arquivos afetados. A gravação usa arquivo temporário e rename.

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é-visualizar em um arquivo

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.4

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é-visualizar em um arquivo

cd \sandbox | replace beta "beta reviewed" workspace/original.txt

Preview      workspace/original.txt
Files        1
Matches      1
Would write  1

Gravar atomicamente as alterações planejadas

replace alpha omega workspace/original.txt -w

Write     workspace/original.txt
Files     1
Replaced  1

Procurar texto sem diferenciar maiúsculas e minúsculas

replace ALPHA omega workspace/original.txt -i

Preview      workspace/original.txt
Case         insensitive
Matches      1
Would write  1

Usar <old> como expressão regular PHP completa

replace "~beta.*~" "beta" workspace/original.txt -p

Preview      workspace/original.txt
Mode         regex
Matches      1
Would write  1

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

replace debug false config -r -e ini

Preview      config
Extensions   ini
Files        1
Matches      1
Would write  1

Limitar nomes com glob como *.php

replace alpha omega workspace -r -g "*.txt"

Preview      workspace
Mask         *.txt
Files        3
Matches      2
Would write  2

Criar cópias .bak antes de gravar

replace debug false config -r -w -b

Write     config
Files     2
Replaced  2
Backups   2

Incluir vendor, node_modules, VCS e cache

replace vendor_name package_name . -r -a

Preview      .
Hidden       included
Matches      1
Would write  1

Tratar um caminho de destino ausente

replace absent present missing.txt

Arquivo não encontrado: missing.txt

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.42026-08-13

Substituição de texto mais clara

A ajuda deixa claro que replace altera texto dentro dos arquivos; <old>/<new> elimina ambiguidades.

# Histórico de versões

replace