能否拦截wp_head/wp_footer脚本并读取内容转为内联脚本？

要拦截wp_head()和wp_footer()输出的外部脚本，将其转为内联形式并获取脚本名称，我们可以利用WordPress的钩子系统来完成，下面是两种实用的实现方案：

方案一：用script_loader_tag过滤器直接替换标签 #

这个方法最直接，它会在每个脚本标签输出前触发，让你可以精准判断并替换目标脚本：

function inline_selected_scripts($tag, $handle, $src) {
    // 定义需要转为内联的脚本handle（注册名称）数组
    $target_handles = ['plugin-script-handle', 'custom-script'];
    
    // 跳过非目标脚本
    if (!in_array($handle, $target_handles)) {
        return $tag;
    }
    
    // 读取脚本文件内容（优先用本地路径，避免远程读取问题）
    $script_content = file_get_contents(ABSPATH . parse_url($src, PHP_URL_PATH));
    
    // 读取成功则返回内联脚本标签，失败则保留原标签作为 fallback
    if ($script_content) {
        return "<script type='text/javascript'>$script_content</script>";
    }
    
    return $tag;
}
add_filter('script_loader_tag', 'inline_selected_scripts', 10, 3);

关键说明： #

• 获取脚本handle：这是核心，你需要知道脚本注册时的handle（也就是wp_register_script()或wp_enqueue_script()的第一个参数）。如果不确定，可以临时添加这段代码打印所有已注册的脚本handle：

  function debug_script_handles() {
      global $wp_scripts;
      foreach ($wp_scripts->registered as $handle => $script) {
          echo "<p>脚本handle：$handle</p>";
      }
  }
  add_action('wp_print_scripts', 'debug_script_handles');
  

• 路径处理：用ABSPATH . parse_url($src, PHP_URL_PATH)把URL转为本地文件路径，比直接用file_get_contents($src)更可靠，避免服务器禁用远程读取的问题。
• 保持顺序：这个方法会保留脚本原本的输出顺序，不用担心依赖关系混乱。

方案二：取消脚本排队，手动输出内联内容 #

如果你需要更灵活的控制（比如指定在头部或页脚输出），可以先取消目标脚本的外部输出，再手动添加内联内容：

function replace_script_with_inline() {
    // 取消目标脚本的排队，阻止外部引用输出
    wp_dequeue_script('plugin-script-handle');
    
    // 获取脚本本地路径（以插件内的script.js为例）
    $script_path = plugin_dir_path(__FILE__) . 'assets/js/script.js';
    $script_content = file_get_contents($script_path);
    
    // 在wp_footer输出内联脚本（也可以换成wp_head）
    if ($script_content) {
        add_action('wp_footer', function() use ($script_content) {
            echo "<script type='text/javascript'>$script_content</script>";
        });
    }
}
// 优先级设为11，确保在脚本注册之后执行
add_action('wp_enqueue_scripts', 'replace_script_with_inline', 11);

注意事项： #

• 优先级设置：wp_enqueue_scripts的优先级要高于脚本注册时的优先级，这样才能确保我们的函数在脚本注册后执行，成功取消排队。
• 依赖检查：如果目标脚本依赖其他脚本，要确保内联脚本的输出顺序在依赖脚本之后，否则会出现未定义变量/函数的错误。

额外提示 #

• 只对小体积脚本做内联，大脚本内联会增加HTML文件大小，反而影响加载速度。
• 可以结合WordPress的缓存机制，避免每次请求都读取脚本文件。

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