replace

replace cambia texto dentro de archivos, no sus nombres. Sin -w, presenta los archivos y el número de coincidencias. Para incluir subcarpetas, añade -r.

DesarrolloVersión 1.1.5Estable
lil-terminal

Resumen

-e txt,php filtra extensiones y -g "*.php" nombres. -i ignora mayúsculas en texto normal; -p recibe una expresión regular completa de PHP. -a incluye dependencias y cachés.

Comprobar el alcance antes de escribir

Con -w -b se crean .bak, .bak-001 y siguientes sin sobrescribir copias anteriores. La búsqueda recursiva las omite. Se excluyen binarios y archivos de más de 4 MiB; máximo 5000 archivos.

Sintaxis

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

Referencia

replace <old> <new>

previsualizar sustituciones en archivos del directorio actual

replace <old> <new> <file>

previsualizar sustituciones en un archivo

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

previsualizar recursivamente dentro de un directorio

-w

escribir los cambios previstos de forma atómica

-i

buscar texto sin distinguir mayúsculas y minúsculas

-p

usar <old> como expresión regular PHP completa

-e <exts>

limitar extensiones, por ejemplo php,js,css o tar.gz

-g <glob>

limitar nombres con un glob como *.php

-b

crear copias .bak antes de escribir

-a

incluir vendor, node_modules, VCS y cachés

Primero ver, después escribir

replace cambia texto dentro de archivos, no sus nombres. Sin -w, presenta los archivos y el número de coincidencias. Para incluir subcarpetas, añade -r.

Limitar los cambios

-e txt,php filtra extensiones y -g "*.php" nombres. -i ignora mayúsculas en texto normal; -p recibe una expresión regular completa de PHP. -a incluye dependencias y cachés.

Copias de seguridad

Con -w -b se crean .bak, .bak-001 y siguientes sin sobrescribir copias anteriores. La búsqueda recursiva las omite. Se excluyen binarios y archivos de más de 4 MiB; máximo 5000 archivos.

Vista interactiva del sandbox

Ejecuta los ejemplos preparados directamente en la página. Los resultados están predefinidos y se muestran en el navegador; no se ejecuta ningún comando de terminal en el servidor.

Previsualizar cambios

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Paquete Base

Instala el paquete completo con referencia local y todos los modos publicados.

install replace
Paquete Minimum

Instalar el paquete reducido. No incluye la referencia local; help <cmd> -i abre la referencia actual del servidor.

install replace -m
Versión pública exacta

Instalar exactamente esta versión publicada.

install replace -v 1.1.5
Comprobar o actualizar

upgrade comprueba la compatibilidad y sustituye el bloque solo cuando hace falta.

upgrade replace
Eliminar módulo

Elimina el bloque de extensión sin tocar el núcleo ni otros módulos.

install replace -u

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Previsualizar cambios
cd \sandbox | replace draft published workspace/replace.txt
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Aplicar cambios
replace draft published \sandbox\workspace\replace.txt -w
Replaced                   2 occurrences in 1 file
workspace/replace.txt      2
Buscar sin distinguir mayú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 expresión 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 extensiones
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 máscara
replace draft published \sandbox\workspace -r -g "*.txt"
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Guardar con copia de seguridad
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 dependencias
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
Previsualizar carpeta
replace draft published \sandbox\workspace
Preview                2 replacements in 1 file
workspace/replace.txt  2

Write                  use -w to apply changes
Comprobar ruta ausente
replace draft published \sandbox\missing.txt
Ruta no encontrada
Rechazar expresión inválida
replace draft published \sandbox\workspace\replace.txt -p
Invalid regular expression
Conservar una segunda copia numerada
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

Archivo usado en este ejemplo: sandbox/workspace/replace.txt

El ejemplo usa un archivo o directorio del espacio protegido de documentación /sandbox/.

status=draft
owner=lil
status=draft

Documentación relacionada

¿Son reales los ejemplos de la documentación? →¿Por qué se limitan los archivos grandes y la cantidad de salida? →

Versión pública actual

v1.1.52026-10-31

Numbered backups

La búsqueda en directorios omite .bak y .bak-001, pero se pueden indicar copias directamente.

# Historial de versiones