PHP preg_replace()：正则替换与反向引用

preg_replace($pattern, $replacement, $subject) 在字符串中找出正则表达式的每一处匹配并替换它。preg_replace('/\s+/', ' ', $text) 会把每一段连续的空格、制表符和换行符替换成一个空格。

<?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";

原字符串不会被修改；preg_replace() 返回一个新字符串。\b 表示单词边界，所以 cats 没有被替换。

反向引用：$1、${1} 和 \1

在替换字符串中，$1 代表第一个捕获组匹配到的内容，$2 代表第二个，$0 代表整个匹配。用它们可以重新排列匹配到的文本。

<?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";

替换字符串要用单引号。在双引号中，"\1" 会变成八进制转义（字节 0x01），而 "${1}" 会被当作名为 1 的变量，这个变量没有定义，而且这种字符串语法从 PHP 8.2 起已被弃用。单引号中的 '\1' 和 '$1' 效果相同，但 $1 是更常见的写法。

删除非字母数字的字符

取反的字符类 [^...] 匹配所有没有列出的字符。把它替换成 '' 就删除了这些字符。对于其他语言的文本，配合 u 修饰符使用 Unicode 类 \p{L}（任意字母）和 \p{N}（任意数字），否则 é、ü 以及所有中文、日文字符都会被删掉。

<?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";

生成 URL slug

连续使用几个正则，就能把标题变成 URL slug。先转成小写，再把每一段连续的非字母数字字符替换成一个连字符，最后去掉两端的连字符：

<?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";

多个正则、次数限制和计数

$pattern 和 $replacement 都可以是数组：每个正则按顺序被替换成相同下标的替换字符串。第四个参数限制每个正则的替换次数（-1 表示不限制），第五个参数会收到实际替换的次数。

<?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";

用 preg_replace_callback 计算替换内容

当替换内容取决于匹配结果时，使用 preg_replace_callback()。它对每个匹配调用一次你的函数，传入 $matches 数组，并插入函数返回的内容。用箭头函数可以把简短的回调写在一行里。

<?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() 接收一个由 pattern => callback 组成的数组。

来自变量的替换文本

替换字符串中的 $ 和反斜杠都有特殊含义，所以来自用户或数据库的替换文本可能会被弄乱。价格 $10 会被当作对第 10 组的引用，而这个组并不存在，结果就成了空字符串：

<?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";

如果要查找的文本和替换文本都不是正则，str_replace() 更简单也更快。想在替换之前先测试正则，见 preg_match()。