WooCommerce修改最终HTML文本块：头部文本替换失效问题排查

你当前的代码用wp_head钩子启动输出缓冲，但wp_head是在<head>标签内部执行的——这时候<head>标签里的早期内容（比如页面标题<title>、基础meta标签等）已经被输出到浏览器，没被输出缓冲捕获，所以这些header区域的内容无法被替换。

要捕获整个页面的输出（包括header和body），必须在任何页面内容输出前启动缓冲，适合的钩子是template_redirect（仅作用于前台页面，避免干扰后台）。修改后的代码如下：

function start_modify_html() {
    // 仅对前台页面启用输出缓冲，排除后台
    if ( ! is_admin() ) {
        ob_start();
    }
}

function end_modify_html() {
    if ( ! is_admin() && ob_get_length() > 0 ) {
        $html = ob_get_clean();
        $html = str_replace( 'old string', 'new string', $html );
        echo $html;
    }
}

add_action( 'template_redirect', 'start_modify_html' );
add_action( 'shutdown', 'end_modify_html' );

• template_redirect钩子：在WordPress确认要加载的模板文件后、任何内容输出前触发，能完整覆盖整个页面的输出流程。
• is_admin()判断：避免后台操作被缓冲，防止出现异常问题。
• shutdown钩子：在PHP脚本执行结束前触发，确保所有页面内容都被缓冲捕获后，再执行替换和输出操作。

修改后，header和body区域的目标文本都能被正常替换。

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