PHP preg_match()：正则表达式用法与示例

preg_match($pattern, $subject, $matches) 检查字符串是否匹配某个正则表达式。匹配时返回 1，否则返回 0，并把找到的内容放进 $matches：preg_match('/\d+/', 'Order 4521 shipped', $m) 返回 1，并把 $m[0] 设为 "4521"。

<?php
$text = 'Order 4521 shipped on 2026-03-14';

if (preg_match('/\d+/', $text, $m)) {
    echo "First number: {$m[0]}\n";
}

var_dump(preg_match('/shipped/', $text));   // found
var_dump(preg_match('/cancelled/', $text)); // not found
var_dump(preg_match('/SHIPPED/i', $text));  // i = case-insensitive

正则是一个两边带分隔符的字符串，分隔符通常是 /.../，后面可以跟 i 这样的修饰符。用单引号写正则：在双引号中，PHP 会先展开 $name 和 \x41、\101 这样的转义，正则引擎收到的可能就不是你写的那个正则了。

捕获组

正则中的圆括号会捕获它匹配到的那部分字符串。$m[0] 是整个匹配，$m[1] 是第一个组，$m[2] 是第二个组，按左括号从左往右计数。

<?php
$text = 'Shipped on 2026-03-14 at 09:30';

if (preg_match('/(\d{4})-(\d{2})-(\d{2})/', $text, $m)) {
    print_r($m);
    [, $year, $month, $day] = $m;
    echo "Day $day, month $month, year $year\n";
}

// (?: ) groups without capturing
preg_match('/(?:at|on) (\d{2}:\d{2})/', $text, $t);
print_r($t);

命名组

(?<name>...) 给组起一个名字。值会同时存在名字和编号下面，这样即使有人在正则前面加了一个组，读取结果的代码也不会出错。

<?php
$log = '[2026-03-14 09:30:12] ERROR: Disk almost full';

$pattern = '/^\[(?<date>[\d-]+) (?<time>[\d:]+)\] (?<level>\w+): (?<message>.+)$/';

if (preg_match($pattern, $log, $m)) {
    echo $m['level'], "\n";
    echo $m['message'], "\n";
    echo $m['date'], ' ', $m['time'], "\n";
}

// Keep only the named keys
print_r(array_filter($m, 'is_string', ARRAY_FILTER_USE_KEY));

用 preg_match_all 找出所有匹配

preg_match_all() 在第一个匹配之后会继续查找，并返回匹配的数量。默认情况下，$m[0] 保存所有完整匹配，$m[1] 保存第一个组的所有值。使用 PREG_SET_ORDER 时，每个匹配会得到一个数组，循环处理起来更方便。

<?php
$text = 'Contact ana@example.com or bo@test.org, not support@';

$count = preg_match_all('/(\w+)@(\w+\.\w+)/', $text, $m);
echo "Found $count addresses\n";
print_r($m[0]);   // full matches
print_r($m[2]);   // domains

preg_match_all('/(\w+)@(\w+\.\w+)/', $text, $sets, PREG_SET_ORDER);
foreach ($sets as $s) {
    echo "user {$s[1]} at {$s[2]}\n";
}

// Every number in a string
preg_match_all('/\d+/', 'a1 b22 c333', $nums);
print_r($nums[0]);

校验输入：锚点、电话号码、邮政编码

做校验时，正则必须匹配整个字符串，所以用 ^ 开头，用 $ 结尾。有一个陷阱：$ 也会匹配末尾换行符之前的位置，所以 '/^\d+$/' 会接受 "123\n"。加上 D 修饰符，或者改用只匹配字符串最末尾的 \z。

<?php
$tests = ['123', '12a', "123\n", ''];

foreach ($tests as $t) {
    printf("%-8s plain:%d  with D:%d\n",
        json_encode($t),
        preg_match('/^\d+$/', $t),
        preg_match('/^\d+$/D', $t)
    );
}

// Japanese postal code: 123-4567
var_dump(preg_match('/^\d{3}-\d{4}$/D', '150-0002'));

// US phone: (555) 123-4567 or 555-123-4567 or 5551234567
$phone = '/^(\(\d{3}\) ?|\d{3}-?)\d{3}-?\d{4}$/D';
foreach (['(555) 123-4567', '555-123-4567', '5551234567', '55-1234'] as $p) {
    echo $p, ' => ', preg_match($phone, $p), "\n";
}

至于邮箱地址，正则要么会拒绝合法的地址，要么会接受不合法的地址。改用 filter_var($email, FILTER_VALIDATE_EMAIL)（见 filter_var()）。

处理 UTF-8、中文和日文的 u 修饰符

没有 u 修饰符时，正则按字节工作。一个中文或日文字符在 UTF-8 中占三个字节，所以 . 只匹配三分之一个字符，算出来的长度也不对。加上 u 后，正则按字符工作，你还可以使用 Unicode 属性类，比如匹配汉字的 \p{Han}。

<?php
$word = '日本語';

var_dump(preg_match('/^.{3}$/', $word));   // bytes: 9, no match
var_dump(preg_match('/^.{3}$/u', $word));  // characters: 3, match

$text = 'PHPで正規表現を使う';
preg_match_all('/\p{Han}+/u', $text, $kanji);
preg_match_all('/\p{Katakana}+/u', 'コーヒーとカフェラテ', $kata);
print_r($kanji[0]);
print_r($kata[0]);

// Only hiragana (and the long vowel mark)?
var_dump(preg_match('/^[\p{Hiragana}ー]+$/uD', 'ひらがな'));

u 还会校验目标字符串：如果字符串不是合法的 UTF-8，preg_match() 会返回 false，而不是进行匹配。

用 preg_quote 转义用户输入

.、+、?、( 和 / 这样的字符在正则中有特殊含义。如果正则的一部分来自变量，比如搜索词，就用 preg_quote() 处理它，并把分隔符作为第二个参数传入，否则 1+1 会匹配 11，未转义的 / 还会破坏整个正则。

<?php
$search = '1+1';
$text = 'Is 11 the answer? No, 1+1 is 2.';

// Wrong: + means "one or more"
preg_match('/' . $search . '/', $text, $bad);
echo "Unescaped matched: {$bad[0]}\n";

// Right
$pattern = '/' . preg_quote($search, '/') . '/';
echo "Pattern: $pattern\n";
preg_match($pattern, $text, $good);
echo "Escaped matched: {$good[0]}\n";

无效的正则不会抛出异常。PHP 会输出一条警告，preg_match() 返回 false：

Warning: preg_match(): No ending delimiter '/' found in /path/to/index.php on line 3

所以当正则是在运行时拼出来的，要检查 === false（或 preg_last_error_msg()）。如果只是检查是否包含某个子串，根本不需要正则，str_contains() 更快也更清晰。要修改匹配到的文本，使用 preg_replace()。