PHP preg_replace(): sostituzioni regex con backreference

preg_replace($pattern, $replacement, $subject) trova ogni corrispondenza di un'espressione regolare in una stringa e la sostituisce. preg_replace('/\s+/', ' ', $text) trasforma ogni sequenza di spazi, tabulazioni e a capo in un singolo spazio.

<?php
$text = "Too    many \t spaces\n\nand   lines";
echo preg_replace('/\s+/', ' ', $text), "\n";

// Remove every digit
echo preg_replace('/\d/', '', 'R2-D2 and C-3PO'), "\n";

// Case-insensitive, whole words only
echo preg_replace('/\bcat\b/i', 'dog', 'Cat, cats and a CAT.'), "\n";

La stringa originale non viene modificata; preg_replace() ne restituisce una nuova. \b indica un confine di parola, ed è per questo che cats resta invariato.

Backreference: $1,${1} e \1

Nella sostituzione, $1 sta per ciò a cui ha corrisposto il primo gruppo di cattura, $2 per il secondo e $0 per l'intera corrispondenza. Usali per riordinare il testo trovato.

<?php
// 2026-03-14 to 14/03/2026
echo preg_replace('/(\d{4})-(\d{2})-(\d{2})/', '$3/$2/$1', 'Due: 2026-03-14'), "\n";

// "Lovelace, Ada" to "Ada Lovelace"
echo preg_replace('/^(\w+), (\w+)$/', '$2 $1', 'Lovelace, Ada'), "\n";

// $0 is the whole match: wrap every number in brackets
echo preg_replace('/\d+/', '[$0]', 'Rooms 12 and 305'), "\n";

// ${1} when a digit follows the reference
echo preg_replace('/(\d+)/', '${1}0', 'Multiply 5 and 7 by ten'), "\n";

Scrivi la sostituzione tra apici singoli. Tra virgolette doppie "\1" diventa un escape ottale (il byte 0x01) e "${1}" viene letto come una variabile chiamata 1, che non è definita e usa una sintassi delle stringhe deprecata da PHP 8.2. '\1' tra apici singoli funziona come '$1', ma $1 è la grafia più comune.

Rimuovere i caratteri non alfanumerici

Una classe di caratteri negata, [^...], corrisponde a tutto ciò che non è elencato. Sostituirla con '' la rimuove. Per il testo in altre lingue, usa le classi Unicode \p{L} (qualsiasi lettera) e \p{N} (qualsiasi cifra) con il modificatore u, altrimenti eliminerai é, ü e ogni carattere giapponese.

<?php
$s = 'Héllo, wörld! 日本語 #2026';

echo preg_replace('/[^a-zA-Z0-9]/', '', $s), "\n";           // ASCII only
echo preg_replace('/[^a-zA-Z0-9 ]/', '', $s), "\n";          // keep spaces
echo preg_replace('/[^\p{L}\p{N}]/u', '', $s), "\n";         // any language
echo preg_replace('/[^\p{L}\p{N}\s]/u', '', $s), "\n";       // and spaces

// Digits only, for a phone number typed with spaces and dashes
echo preg_replace('/\D/', '', '+1 (555) 123-4567'), "\n";

Creare uno slug per un URL

Più schemi in sequenza trasformano un titolo in uno slug per un URL. Prima converti in minuscolo, poi sostituisci ogni sequenza di caratteri non alfanumerici con un solo trattino, infine togli i trattini alle estremità:

<?php
function slugify(string $title): string
{
    $slug = mb_strtolower($title);
    $slug = preg_replace('/[^\p{L}\p{N}]+/u', '-', $slug);
    return trim($slug, '-');
}

echo slugify('PHP preg_replace(): A Quick Guide!'), "\n";
echo slugify('  10 Tips & Tricks for 2026  '), "\n";
echo slugify('Café au lait'), "\n";

Più schemi, un limite e un conteggio

$pattern e $replacement possono essere array: ogni schema viene sostituito dalla sostituzione con lo stesso indice, in ordine. Il quarto argomento limita le sostituzioni per schema (-1 significa nessun limite), e il quinto riceve quante sostituzioni sono state fatte.

<?php
$text = 'Call 555-1234 or email me at ana@example.com';

$patterns = ['/\d{3}-\d{4}/', '/\S+@\S+/'];
$replacements = ['[phone]', '[email]'];
echo preg_replace($patterns, $replacements, $text), "\n";

// Only the first match
echo preg_replace('/\d+/', '#', 'a1 b2 c3', 1), "\n";

// Count the replacements
$clean = preg_replace('/\s{2,}/', ' ', 'a  b   c d', -1, $count);
echo "$clean ($count replacements)\n";

Calcolare la sostituzione con preg_replace_callback

Quando la sostituzione dipende dalla corrispondenza, usa preg_replace_callback(). Chiama la tua funzione una volta per corrispondenza con l'array $matches e inserisce ciò che la funzione restituisce. Una arrow function tiene le callback brevi su una riga.

<?php
// Add 10% tax to every price
$menu = 'Coffee $3.50, Cake $4.00, Tea $2.80';
echo preg_replace_callback(
    '/\$(\d+\.\d{2})/',
    fn($m) => '$' . number_format($m[1] * 1.10, 2),
    $menu
), "\n";

// snake_case to camelCase
echo preg_replace_callback('/_([a-z])/', fn($m) => strtoupper($m[1]), 'user_first_name'), "\n";

// Fill {placeholders} from an array, leave unknown ones alone
$vars = ['name' => 'Ada', 'count' => 3];
$template = 'Hi {name}, you have {count} messages. {unknown}';
echo preg_replace_callback(
    '/\{(?<key>\w+)\}/',
    fn($m) => $vars[$m['key']] ?? $m[0],
    $template
), "\n";

preg_replace_callback_array() accetta un array di coppie pattern => callback quando più schemi richiedono ciascuno la propria funzione.

Testo di sostituzione da una variabile

Un $ o una barra rovesciata nella sostituzione hanno un significato, quindi una sostituzione che arriva da un utente o da un database può risultare alterata. Un prezzo di $10 viene letto come un riferimento al gruppo 10, che non esiste, e viene fuori vuoto:

<?php
$price = '$10';

// Wrong: "$10" is read as backreference 10
echo preg_replace('/PRICE/', $price, 'Only PRICE today'), "\n";

// Right: the callback's return value is used as is
echo preg_replace_callback('/PRICE/', fn() => $price, 'Only PRICE today'), "\n";

// Or, for fixed text, no regex at all
echo str_replace('PRICE', $price, 'Only PRICE today'), "\n";

Quando né il testo cercato né la sostituzione sono schemi, str_replace() è la scelta più semplice e più veloce. Per verificare uno schema prima di sostituire qualcosa, vedi preg_match().