本文详解如何使用 preg_match_all() 配合正确正则模式，从字符串中精准提取所有形如 @@xxx@@ 的占位符，并返回完整匹配数组。
本文详解如何使用 preg_match_all() 配合正确正则模式，从字符串中精准提取所有形如 @@xxx@@ 的占位符，并返回完整匹配数组。
在 PHP 开发中，常需从模板字符串中提取自定义占位符（如 @@address@@、@@user_name@@），用于后续变量替换或内容解析。这类占位符统一以两个 @ 符号起止，中间为大小写字母、数字或下划线组成的标识符。若错误使用 preg_match() 或正则表达式不严谨，将导致仅匹配首个结果、漏匹配、甚至完全失配。
✅ 正确做法：使用 preg_match_all() + 精准模式
preg_match() 仅返回第一个匹配项，而 preg_match_all() 才能捕获全部匹配结果。同时，原始正则 /@@[^a-z]@@/ 存在两个关键问题：
- [^a-z] 表示“非小写字母”，会匹配空格、@、数字等意外字符，逻辑与需求相反；
- 缺少量词（如 + 或 *），无法匹配多字符标识符（如 address 是 7 个字母，而非 1 个）。
✅ 推荐正则模式：
'/@@[a-zA-Z0-9_]+@@/'
- [a-zA-Z0-9_]：明确允许大小写字母、数字和下划线（符合常见 token 命名规范）；
- +：确保匹配一个及以上字符，避免 @@@@ 这类无效空占位符；
- 整体包裹在定界符 / 中，简洁安全。
? 完整示例代码
<?php
$input = 'my address is @@address@@ and my house is at @@street@@ and the number is @@number@@ or so @@user_name@@';
// 使用 preg_match_all 获取全部匹配（注意：$matches 是二维数组）
preg_match_all('/@@[a-zA-Z0-9_]+@@/', $input, $matches);
// $matches[0] 是完整匹配结果的一维数组
$output = $matches[0];
print_r($output);
?>输出结果：
立即学习“PHP免费学习笔记（深入）”；
Array
(
[0] => @@address@@
[1] => @@street@@
[2] => @@number@@
[3] => @@user_name@@
)⚠️ 注意事项与进阶建议
- 区分大小写：当前模式 a-zA-Z 支持大小写，如需严格小写可简化为 [a-z0-9_]+；
- 支持中文或 Unicode：若 token 可含中文，改用 '/@@[\p{L}\p{N}_]+@@/u'（需 u 修饰符启用 Unicode 模式）；
- 避免过度匹配：勿用 .*? 等模糊表达式（如 /@@.*?@@/），可能跨占位符误匹配（例如 @@a@@b@@c@@ 中匹配到 @@a@@b@@）；
-
提取纯名称（不含 @@）：若只需 address、street 等内部值，可使用捕获组：
preg_match_all('/@@([a-zA-Z0-9_]+)@@/', $input, $matches); $names = $matches[1]; // $matches[1] 存储第一个捕获组内容
掌握该模式后，即可稳健支撑模板引擎、配置解析、动态文案生成等典型场景——核心在于：选对函数（preg_match_all）、写对模式（字符集 + 量词）、验证边界（避免贪婪/跨界）。
