`replace`

replace muestra primero una vista previa de sustituciones de texto o expresiones regulares y no escribe nada sin -w. La ruta, extensión o glob permiten limitar el alcance.

DesarrolloVersión 1.1.4Estable

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

Resumen

Úselo cuando la misma corrección textual deba aplicarse en varios lugares. Mantenga la primera ejecución como vista previa, compruebe archivos y coincidencias y solo entonces repita el comando con -w.

Comprobar el alcance antes de escribir

Empiece, por ejemplo, con replace debug false config -r -e ini: solo muestra archivos y recuentos. Añada -w cuando la lista sea correcta y -b si quiere copias .bak antes del cambio masivo.

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

Elegir el alcance

Sin ruta se usa el directorio actual. Los subdirectorios solo se recorren con -r. -e <exts> filtra extensiones y -g <glob> nombres. Dependencias, VCS y caché se omiten salvo con -a; los enlaces simbólicos nunca se procesan.

Vista previa y escritura

La vista previa es el modo predeterminado y muestra recuentos por archivo. Repita con -w para escribir. -b crea primero .bak y se detiene si ya existe. -i corresponde a texto simple; -p espera una expresión regular PHP completa con delimitadores.

Límites y seguridad

Se examinan como máximo 5000 archivos; se omiten binarios y archivos mayores de 4 MiB. El informe enumera hasta 500 archivos modificables. La escritura usa archivo temporal y rename.

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 sustituciones en un archivo

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

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 sustituciones en un archivo

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

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

Escribir los cambios previstos de forma atómica

replace alpha omega workspace/original.txt -w

Write     workspace/original.txt
Files     1
Replaced  1

Buscar texto sin distinguir mayúsculas y minúsculas

replace ALPHA omega workspace/original.txt -i

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

Usar <old> como expresión regular PHP completa

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

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

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

replace debug false config -r -e ini

Preview      config
Extensions   ini
Files        1
Matches      1
Would write  1

Limitar nombres con un glob como *.php

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

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

Crear copias .bak antes de escribir

replace debug false config -r -w -b

Write     config
Files     2
Replaced  2
Backups   2

Incluir vendor, node_modules, VCS y cachés

replace vendor_name package_name . -r -a

Preview      .
Hidden       included
Matches      1
Would write  1

Gestionar una ruta de destino ausente

replace absent present missing.txt

Archivo no encontrado: missing.txt

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

Reemplazo de texto más claro

La ayuda deja claro que replace modifica texto dentro de archivos; <old>/<new> evita ambigüedades.

# Historial de versiones

replace