在 CMS、博客系统中,常需在内容中嵌入动态标签(如 [gallery id="1"]、{user:123}),渲染时调用对应处理函数替换为实际 HTML。本文实现一个通用的标签解析替换函数 my_wp_plugin_tag_action(),支持正则匹配、回调处理、去重替换。
<?php
/**
* 通用内容标签回调替换
*
* @param string $content 原始内容
* @param string $tagRegex 标签正则(需包含捕获组)
* @param callable $callback 处理回调,接收捕获组数组,返回替换字符串
* @param mixed $args 透传给回调的额外参数
* @return string 替换后的内容
*/
function my_wp_plugin_tag_action(string $content, string $tagRegex, callable $callback, $args = false): string {
// 1. 全局匹配所有标签
if (!preg_match_all($tagRegex, $content, $matches, PREG_SET_ORDER)) {
return $content;
}
// 2. 去重:同一标签只处理一次
$uniqueMatches = [];
$seen = [];
foreach ($matches as $match) {
$fullTag = $match[0]; // 整个匹配串
if (!isset($seen[$fullTag])) {
$seen[$fullTag] = true;
$uniqueMatches[] = $match;
}
}
// 3. 逐个执行回调,收集替换对
$replacements = [];
$search = [];
foreach ($uniqueMatches as $match) {
$fullTag = array_shift($match); // 移除 $match[0],剩下捕获组
$replacements[] = $callback($match, $args);
$search[] = $fullTag;
}
// 4. 一次性替换,避免嵌套标签相互干扰
return str_replace($search, $replacements, $content);
}
// ========== 使用示例 ==========
// 定义标签格式:{func:name|param1|param2}
$pattern = '/\{func:([a-z_]+)\|([^}]+)\}/i';
// 模拟内容
$content = '欢迎 {func:get_user|123} 访问我们的 {func:get_site|name}';
// 回调处理器
function tagHandler(array $match, $args) {
[$func, $params] = $match; // $match[1] => func名, $match[2] => 参数串
$params = explode('|', $params);
return match ($func) {
'get_user' => "用户#{$params[0]}",
'get_site' => $params[0] === 'name' ? 'MyBlog' : 'Unknown',
default => '[未知标签:' . $func . ']',
};
}
// 执行替换
echo my_wp_plugin_tag_action($content, $pattern, 'tagHandler');
// 输出: 欢迎 用户#123 访问我们的 MyBlog
?>
$matches 结构为 [ [full, cap1, cap2...], ... ],便于遍历callback(array $captures, mixed $args): string,灵活透传上下文search/replace 对后统一 str_replace,避免前次替换影响后续匹配若需支持嵌套(如 {outer {inner}}),可改用递归或基于栈的解析器,或约定标签不嵌套(多数场景足够)。
eval 或执行用户传入代码match 分支)此模式广泛应用于 WordPress Shortcode、Discuz 论坛代码、Typecho 插件等系统,掌握后可快速构建自定义内容标签引擎。