萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 使用 preg_replace_callback 实现内容标签回调替换(类 WordPress Shortcode 机制)

应用场景

在 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
?>

设计要点

  • PREG_SET_ORDER:使 $matches 结构为 [ [full, cap1, cap2...], ... ],便于遍历
  • 去重机制:防止同一标签多次出现导致重复计算或替换错乱
  • 回调签名:callback(array $captures, mixed $args): string,灵活透传上下文
  • 一次性替换:收集所有 search/replace 对后统一 str_replace,避免前次替换影响后续匹配

扩展:支持嵌套标签

若需支持嵌套(如 {outer {inner}}),可改用递归或基于栈的解析器,或约定标签不嵌套(多数场景足够)。

安全提示

  • 回调中严禁直接 eval 或执行用户传入代码
  • 白名单限制允许调用的函数名(如示例中的 match 分支)
  • 对参数做长度、字符集校验,防止 ReDoS 或 XSS

此模式广泛应用于 WordPress Shortcode、Discuz 论坛代码、Typecho 插件等系统,掌握后可快速构建自定义内容标签引擎。

copyright © 萬盛學電腦網 all rights reserved