`replace`

replace prévisualise les remplacements de texte ou d’expressions régulières avant toute écriture. Le chemin, l’extension ou un glob réduisent la portée ; -w est obligatoire pour appliquer les changements.

DéveloppementVersion 1.1.4Stable

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

Vue d’ensemble

Utilisez-le lorsqu’une même correction textuelle doit toucher plusieurs fichiers. Gardez le premier passage en prévisualisation, contrôlez fichiers et occurrences, puis répétez seulement ensuite avec -w.

Vérifier la portée avant d’écrire

Commencez par exemple par replace debug false config -r -e ini : seuls les fichiers et les occurrences sont affichés. Ajoutez -w après vérification et -b si des copies .bak sont utiles avant la modification globale.

Syntaxe

lil-terminal

replace <old> <new> [path] [options]

Référence

replace <old> <new>

prévisualiser dans les fichiers du dossier courant

replace <old> <new> <file>

prévisualiser dans un seul fichier

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

prévisualiser récursivement dans un dossier

-w

écrire atomiquement les changements prévus

-i

chercher le texte sans tenir compte de la casse

-p

utiliser <old> comme expression régulière PHP complète

-e <exts>

limiter les extensions, par exemple php,js,css ou tar.gz

-g <glob>

limiter les noms avec un glob tel que *.php

-b

créer des copies .bak avant écriture

-a

inclure vendor, node_modules, VCS et caches

Choisir la portée

Sans chemin, le dossier courant est utilisé. Les sous-dossiers ne sont parcourus qu’avec -r. -e <exts> filtre les extensions et -g <glob> les noms. Dépendances, VCS et caches sont ignorés sans -a ; les liens symboliques ne sont jamais traités.

Prévisualiser puis écrire

La prévisualisation est le mode par défaut et affiche les occurrences par fichier. Répétez avec -w pour écrire. -b crée d’abord .bak et s’arrête si la sauvegarde existe déjà. -i concerne le texte simple ; -p attend une expression régulière PHP complète avec ses délimiteurs.

Limites et sécurité

Au plus 5000 fichiers sont examinés ; les binaires et fichiers de plus de 4 Mio sont ignorés. Le rapport liste au plus 500 fichiers modifiés. L’écriture passe par un fichier temporaire puis rename.

Aperçu interactif du sandbox

Lancez les exemples préparés directement sur la page. Les résultats sont prédéfinis et affichés dans le navigateur ; aucune commande terminal n’est exécutée sur le serveur.

Prévisualiser dans un seul fichier

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Paquet Base

Installer le paquet complet avec référence locale et tous les modes publiés.

install replace

Paquet Minimum

Installer le paquet réduit. La référence locale est omise ; help <cmd> -i ouvre la référence serveur actuelle.

install replace -m

Version publique exacte

Installer exactement cette version publiée.

install replace -v 1.1.4

Vérifier ou mettre à jour

upgrade vérifie la compatibilité et remplace le bloc seulement si nécessaire.

upgrade replace

Supprimer le module

Supprimer le bloc d’extension sans toucher au noyau ni aux autres modules.

install replace -u

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

Prévisualiser dans un seul fichier

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

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

Écrire atomiquement les changements prévus

replace alpha omega workspace/original.txt -w

Write     workspace/original.txt
Files     1
Replaced  1

Chercher le texte sans tenir compte de la casse

replace ALPHA omega workspace/original.txt -i

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

Utiliser <old> comme expression régulière PHP complète

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

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

Limiter les extensions, par exemple php,js,css ou tar.gz

replace debug false config -r -e ini

Preview      config
Extensions   ini
Files        1
Matches      1
Would write  1

Limiter les noms avec un glob tel que *.php

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

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

Créer des copies .bak avant écriture

replace debug false config -r -w -b

Write     config
Files     2
Replaced  2
Backups   2

Inclure vendor, node_modules, VCS et caches

replace vendor_name package_name . -r -a

Preview      .
Hidden       included
Matches      1
Would write  1

Gérer un chemin cible absent

replace absent present missing.txt

Fichier introuvable: missing.txt

Fichier utilisé dans cet exemple: `sandbox/workspace/replace.txt`

L’exemple utilise un fichier ou un répertoire de l’espace de documentation protégé /sandbox/.

status=draft
owner=lil
status=draft

Documentation associée

Les exemples de la documentation sont-ils réels ? →Pourquoi les gros fichiers et les longues sorties sont-ils limités ? →

Version publique actuelle

v1.1.42026-08-13

Remplacement de texte plus clair

L’aide précise que replace modifie le texte dans les fichiers ; <old>/<new> supprime l’ambiguïté.

# Historique des versions

replace