使用 preg_match() 提取第一处匹配时，只需传入目标字符串和正则表达式，函数会在找到第一个匹配项后立即停止搜索并返回 1。调用后，第三个参数 $matches 数组中索引 0 存放完整匹配内容，后续索引按代码中左括号的出现顺序依次存放各子组捕获的内容。
如何获取完整的匹配文本？
在 $matches 数组中，索引为 0 的元素始终包含与整个正则表达式模式相匹配的完整字符串。这是最直接的提取方式，适用于不需要解析内部结构、只需确认是否存在或获取整体内容的场景。
<?php $subject = "User: admin@example.com, Admin: root@example.org";
$pattern = '/User:\s*(\S+@\S+)/';
// 只匹配第一个出现的位置
if (preg_match($pattern, $subject, $matches)) {
// $matches[0] 是完整匹配部分
echo "完整匹配: " . $matches[0] . PHP_EOL;
// 输出: User: admin@example.com
}
?>
运行上述代码，预期结果为：
完整匹配: User: admin@example.com
注意：即使字符串中有多个类似结构，preg_match 默认只处理第一个符合模式的片段。
如何读取特定子组（Capture Group）的内容？
当正则表达式中包含圆括号定义的子组时，$matches 数组中从索引 1 开始的元素分别对应这些子组的捕获内容。索引 1 对应第一个左括号，索引 2 对应第二个，依此类推。这种结构允许开发者精确提取匹配文本中的特定部分，如邮箱地址的用户名或域名。
<?php $subject = "Order #12345 placed on 2023-10-01";
// 提取订单号和日期
$pattern = '/Order #(\d{5}) placed on (\d{4}-\d{2}-\d{2})/';
if (preg_match($pattern, $subject, $matches)) {
echo "订单号: " . $matches[1] . PHP_EOL;
echo "日期: " . $matches[2] . PHP_EOL;
}
?>
运行结果预期为：
订单号: 12345
日期: 2023-10-01
这里 $matches[1] 捕获了 \d{5} 部分，$matches[2] 捕获了日期部分。
如果未匹配到任何内容，$matches 会是什么状态？
当 preg_match() 未能找到任何匹配项时，函数返回 0，此时传入的 $matches 数组会被清空或保持为空（取决于 PHP 版本和初始状态，通常建议在使用前初始化）。因此，在访问 $matches 之前，必须检查函数的返回值是否为 1，以避免访问不存在的索引导致警告或错误。这确保了程序在处理无匹配情况时的健壮性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
