PHP 正则表达式提取双@包围的占位符(如 @@token@@)

3次阅读

PHP 正则表达式提取双@包围的占位符(如 @@token@@)

本文详解如何使用 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)、写对模式(字符集 + 量词)、验证边界(避免贪婪/跨界)

text=ZqhQzanResources