如何为WordPress内容的H2标签添加按顺序生成的ID？

问题背景 #

已通过以下代码成功从WordPress的the_content中提取所有H2标签生成目录：

function h2s_in_the_content($content) {
    if (preg_match_all('#<h2>(.*?)</h2>#', $content, $matches)) {
        foreach ($matches[1] as $key => $value) {
            
            echo '<li class="inhoudsopgave-li">';
            echo '<a href="#' . $key . '" class="link white">' . $value . '</a>';
            echo '</li>';
        }
    }
}

add_filter('the_content', 'h2s_in_the_content', 98);

但在尝试为所有H2标签添加顺序ID（格式如<h2 id="0/1/2/3/etc.">）时，以下代码出现问题：所有H2标签的ID都变成了id="2"，而非按顺序生成。

错误代码：

function replace_text_wps($content){
    if (preg_match_all('#<h2>(.*?)</h2>#', $content, $matches)) {
        foreach ($matches[1] as $key => $value) {
            $replace = array(
                '<h2>' => '<h2 id="' . $key . '">'
            );
        return $content;
        }
    }
    $content = str_replace(array_keys($replace), $replace, $content);
    return $content;
}

add_filter('the_content', 'replace_text_wps',99);

错误原因 #

1. 循环提前终止：foreach循环内部每次赋值$replace后立刻执行return $content，导致循环仅执行一次，后续匹配的H2标签完全未处理。
2. 全局替换逻辑错误：即便去掉提前return的代码，str_replace会把所有<h2>替换成最后一次循环生成的ID值，因为它是全局匹配替换，无法区分每个H2标签的顺序。
3. 变量作用域问题：如果没有匹配到H2标签，$replace变量未定义，执行str_replace时会抛出错误。

修正后的代码 #

使用preg_replace_callback可以逐个处理每个匹配的H2标签，并按顺序生成ID：

function replace_text_wps($content){
    // 初始化计数变量，确保每篇文章处理时从0开始
    static $count = 0;
    $count = 0;

    return preg_replace_callback('#<h2>(.*?)</h2>#', function($match) use (&$count) {
        // 生成当前H2的顺序ID
        $id = $count++;
        // 返回替换后的完整H2标签
        return '<h2 id="' . $id . '">' . $match[1] . '</h2>';
    }, $content);
}

add_filter('the_content', 'replace_text_wps', 99);

代码说明 #

• preg_replace_callback会遍历所有匹配的H2标签，对每个标签执行回调函数，实现精准替换。
• 静态变量$count用来记录当前的顺序ID，每次处理一个H2标签后自增，确保ID从0开始按顺序生成。
• 直接在回调中构造带ID的H2标签，避免了全局替换导致的ID重复问题。

内容的提问来源于stack exchange，提问作者branco holtslag