replace

replace mostra prima l’anteprima delle sostituzioni di testo o regex e non scrive nulla senza -w. Percorso, estensione e glob permettono di restringere l’area di lavoro.

SviluppoVersione 1.1.4Stabile
lil-terminal

Panoramica

Usalo quando la stessa modifica testuale deve essere applicata in più punti. Mantieni la prima esecuzione come anteprima, controlla file e occorrenze e solo dopo ripeti con -w.

Controllare l’ambito prima di scrivere

Inizia, per esempio, con replace debug false config -r -e ini: vengono mostrati soltanto file e conteggi. Aggiungi -w quando l’elenco è corretto e -b se vuoi copie .bak prima della modifica massiva.

Sintassi

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

Riferimento

replace <old> <new>

mostrare l’anteprima nei file della directory corrente

replace <old> <new> <file>

mostrare l’anteprima in un file

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

mostrare l’anteprima ricorsiva in una directory

-w

scrivere atomicamente le modifiche previste

-i

cercare testo ignorando maiuscole e minuscole

-p

usare <old> come espressione regolare PHP completa

-e <exts>

limitare le estensioni, per esempio php,js,css o tar.gz

-g <glob>

limitare i nomi con glob come *.php

-b

creare copie .bak prima della scrittura

-a

includere vendor, node_modules, VCS e cache

Scegliere l’ambito

Senza percorso viene usata la directory corrente. Le sottodirectory vengono attraversate solo con -r. -e <exts> filtra le estensioni e -g <glob> i nomi. Dipendenze, VCS e cache sono saltati senza -a; i link simbolici non vengono mai elaborati.

Anteprima e scrittura

L’anteprima è predefinita e mostra i conteggi per file. Ripeti con -w per scrivere. -b crea prima .bak e si ferma se il backup esiste già. -i vale per testo semplice; -p richiede una regex PHP completa con delimitatori.

Limiti e sicurezza

Si esaminano al massimo 5000 file; binari e file oltre 4 MiB vengono ignorati. Il report elenca al massimo 500 file interessati. La scrittura usa un file temporaneo e rename.

Anteprima interattiva del sandbox

Esegui gli esempi preparati direttamente nella pagina. I risultati sono predefiniti e mostrati nel browser; sul server non viene eseguito alcun comando del terminale.

Mostrare l’anteprima in un file

Installa e gestisci

Installa la versione compatibile corrente. Scegli Base per tutte le funzioni o Minimum per il pacchetto ridotto; usa upgrade per aggiornare un modulo già installato.

Base e Minimum sono due pacchetti della stessa release corrente del modulo.

Pacchetto Base

Installa il pacchetto completo con riferimento locale e tutte le modalità pubblicate.

install replace
Pacchetto Minimum

Installa il pacchetto ridotto. Il riferimento locale è omesso; help <cmd> -i apre il riferimento server corrente.

install replace -m
Versione pubblica esatta

Installa esattamente questa versione pubblicata.

install replace -v 1.1.4
Controlla o aggiorna

upgrade controlla la compatibilità e sostituisce il blocco solo quando serve.

upgrade replace
Rimuovi modulo

Rimuove il blocco estensione senza toccare core e altri moduli.

install replace -u

Esempi

Gli esempi sono copiabili ma il sito non li esegue. Controlla percorsi, permessi e opzioni distruttive.

Mostrare l’anteprima in un file
cd \sandbox | replace beta "beta reviewed" workspace/original.txt
Preview      workspace/original.txt
Files        1
Matches      1
Would write  1
Scrivere atomicamente le modifiche previste
replace alpha omega workspace/original.txt -w
Write     workspace/original.txt
Files     1
Replaced  1
Cercare testo ignorando maiuscole e minuscole
replace ALPHA omega workspace/original.txt -i
Preview      workspace/original.txt
Case         insensitive
Matches      1
Would write  1
Usare <old> come espressione regolare PHP completa
replace "~beta.*~" "beta" workspace/original.txt -p
Preview      workspace/original.txt
Mode         regex
Matches      1
Would write  1
Limitare le estensioni, per esempio php,js,css o tar.gz
replace debug false config -r -e ini
Preview      config
Extensions   ini
Files        1
Matches      1
Would write  1
Limitare i nomi con glob come *.php
replace alpha omega workspace -r -g "*.txt"
Preview      workspace
Mask         *.txt
Files        3
Matches      2
Would write  2
Creare copie .bak prima della scrittura
replace debug false config -r -w -b
Write     config
Files     2
Replaced  2
Backups   2
Includere vendor, node_modules, VCS e cache
replace vendor_name package_name . -r -a
Preview      .
Hidden       included
Matches      1
Would write  1
Gestire un percorso di destinazione mancante
replace absent present missing.txt
File non trovato: missing.txt

File usato in questo esempio: sandbox/workspace/replace.txt

L’esempio usa un file o una directory dell’area di documentazione protetta /sandbox/.

status=draft
owner=lil
status=draft

Documentazione correlata

Versione pubblica attuale

v1.1.42026-08-13

Sostituzione testo più chiara

La guida chiarisce che replace modifica il testo nei file; <old>/<new> elimina l’ambiguità.