replace

replace zeigt Text- oder Regex-Ersetzungen in den gewählten Dateien zuerst als Vorschau. Geschrieben wird nur mit -w; Pfad, Erweiterung und Glob können den Bereich einschränken.

EntwicklungVersion 1.1.4Stabil
lil-terminal

Überblick

Wenn dieselbe Textänderung an mehreren Stellen nötig ist, zuerst nur die Vorschau verwenden. Zielmenge und Trefferzahlen prüfen und denselben Befehl erst danach mit -w wiederholen.

Bereich vor dem Schreiben prüfen

Zum Beispiel zeigt replace debug false config -r -e ini zunächst nur Dateien und Treffer. -w erst nach der Kontrolle ergänzen; -b erzeugt vor einer Massenänderung bei Bedarf .bak-Kopien.

Syntax

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

Referenz

replace <old> <new>

Ersetzungen in Dateien des aktuellen Verzeichnisses vorschauen

replace <old> <new> <file>

Ersetzungen in einer Datei vorschauen

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

Ersetzungen rekursiv in einem Verzeichnis vorschauen

-w

geplante Änderungen atomar schreiben

-i

Klartext ohne Beachtung der Groß-/Kleinschreibung suchen

-p

<old> als vollständigen PHP-Regulärausdruck verwenden

-e <exts>

Endungen begrenzen, z. B. php,js,css oder tar.gz

-g <glob>

Basisnamen per Glob wie *.php begrenzen

-b

vor dem Schreiben .bak-Kopien erstellen

-a

vendor, node_modules, VCS- und Cache-Verzeichnisse einschließen

Bereich wählen

Ohne Pfad gilt das aktuelle Verzeichnis. Unterverzeichnisse werden erst mit -r durchsucht. -e <exts> filtert Endungen, -g <glob> Dateinamen. Abhängigkeiten, VCS und Cache werden ohne -a übersprungen; symbolische Links werden nie verarbeitet.

Vorschau und Schreiben

Standard ist nur die Vorschau mit Trefferzahlen je Datei. Mit -w wird geschrieben. -b legt vorher .bak an und stoppt, wenn die Sicherung bereits existiert. -i gilt für Klartext; -p erwartet einen vollständigen PHP-Regulärausdruck inklusive Trennzeichen.

Grenzen und Sicherheit

Pro Lauf werden höchstens 5000 Dateien geprüft; Dateien über 4 MiB und Binärdateien werden übersprungen. Der Bericht listet höchstens 500 geänderte Dateien. Geschrieben wird über temporäre Datei und rename.

Interaktive Sandbox-Vorschau

Führen Sie die vorbereiteten Beispiele direkt auf der Seite aus. Die Ergebnisse sind vorab erstellt und werden im Browser angezeigt; auf dem Server wird kein Terminalbefehl ausgeführt.

Ersetzungen in einer Datei vorschauen

Installieren und verwalten

Installieren Sie die aktuelle kompatible Version. Wählen Sie Base für den vollständigen Funktionsumfang oder Minimum für das reduzierte Paket; ein bereits installiertes Modul wird mit upgrade aktualisiert.

Base und Minimum sind zwei Pakete derselben aktuellen Modulversion.

Base-Paket

Vollständiges Paket mit lokaler Referenz und allen veröffentlichten Modi installieren.

install replace
Minimum-Paket

Das reduzierte Paket installieren. Die lokale Referenz entfällt; help <cmd> -i öffnet die aktuelle Serverreferenz.

install replace -m
Exakte öffentliche Version

Genau diese veröffentlichte Version installieren.

install replace -v 1.1.4
Prüfen oder aktualisieren

upgrade prüft Kompatibilität und ersetzt den Block nur bei Bedarf.

upgrade replace
Modul entfernen

Erweiterungsblock entfernen, Core und andere Module bleiben erhalten.

install replace -u

Beispiele

Die Beispiele sind kopierbar, werden aber nicht von der Website ausgeführt. Prüfen Sie Pfade, Rechte und destruktive Optionen.

Ersetzungen in einer Datei vorschauen
cd \sandbox | replace beta "beta reviewed" workspace/original.txt
Preview      workspace/original.txt
Files        1
Matches      1
Would write  1
Geplante Änderungen atomar schreiben
replace alpha omega workspace/original.txt -w
Write     workspace/original.txt
Files     1
Replaced  1
Klartext ohne Beachtung der Groß-/Kleinschreibung suchen
replace ALPHA omega workspace/original.txt -i
Preview      workspace/original.txt
Case         insensitive
Matches      1
Would write  1
<old> als vollständigen PHP-Regulärausdruck verwenden
replace "~beta.*~" "beta" workspace/original.txt -p
Preview      workspace/original.txt
Mode         regex
Matches      1
Would write  1
Endungen begrenzen, z. B. php,js,css oder tar.gz
replace debug false config -r -e ini
Preview      config
Extensions   ini
Files        1
Matches      1
Would write  1
Basisnamen per Glob wie *.php begrenzen
replace alpha omega workspace -r -g "*.txt"
Preview      workspace
Mask         *.txt
Files        3
Matches      2
Would write  2
Vor dem Schreiben .bak-Kopien erstellen
replace debug false config -r -w -b
Write     config
Files     2
Replaced  2
Backups   2
Vendor, node_modules, VCS- und Cache-Verzeichnisse einschließen
replace vendor_name package_name . -r -a
Preview      .
Hidden       included
Matches      1
Would write  1
Fehlenden Zielpfad behandeln
replace absent present missing.txt
Datei nicht gefunden: missing.txt

In diesem Beispiel verwendete Datei: sandbox/workspace/replace.txt

Das Beispiel verwendet eine Datei oder ein Verzeichnis aus dem geschützten Dokumentationsbereich /sandbox/.

status=draft
owner=lil
status=draft

Verwandte Dokumentation

Sind die Beispiele in der Dokumentation echt? →Warum sind große Dateien und Ausgaben begrenzt? →

Aktuelle öffentliche Version

v1.1.42026-08-13

Klarere Textersetzung

Die Hilfe macht deutlich, dass replace Text in Dateien ändert; kurze <old>/<new>-Platzhalter vermeiden Mehrdeutigkeit.

# Versionsverlauf