自定义WordPress页面函数失效，如何合规替代wp-load.php？

嘿，这个问题我之前帮好几个开发者捋过——直接硬加载wp-load.php确实能临时解决，但确实不是WordPress推荐的做法，容易引发全局变量冲突、加载顺序错乱这类隐性问题。下面给你几个更合规的方案，都是贴合WP核心架构的思路：

方案1：通过重写规则让请求走WordPress核心流程 #

直接访问page-myslug.php会完全绕过WP的初始化流程，所以核心思路是让这个PDF生成请求先经过WP的路由系统，自动完成核心初始化。

步骤如下：

• 在主题的functions.php中添加自定义重写规则：

function setup_pdf_rewrite_rules() {
    // 添加重写规则，把/pdf-generator/开头的请求映射到你的模板页面
    add_rewrite_rule(
        '^pdf-generator/?',
        'index.php?pagename=myslug', // 这里的myslug是你后台创建页面时设置的slug
        'top'
    );
    // 注册自定义查询变量，用来接收value参数
    add_rewrite_tag('%pdf_value%', '([^&]+)');
}
add_action('init', 'setup_pdf_rewrite_rules');

• 登录WP后台，进入「设置」→「固定链接」，随便点击一下「保存更改」（不用修改设置，只是刷新重写规则）。
• 之后就可以通过www.mywp.com/pdf-generator/?value=4243访问了，WP会自动初始化核心，你模板里的TCPDF函数就能正常调用。还能通过get_query_var('pdf_value')安全获取参数值。

方案2：封装成REST API端点（推荐给纯接口场景） #

如果你的PDF生成更偏向接口需求，用WP的REST API是最优雅的方式——WP会自动处理权限、初始化等所有核心流程，完全符合规范。

在functions.php中注册自定义端点：

function register_pdf_generator_endpoint() {
    register_rest_route('pdf/v1', '/generate', array(
        'methods' => WP_REST_Server::READABLE, // 对应GET请求
        'callback' => 'handle_pdf_generation',
        // 这里可以设置权限回调，比如只允许登录用户访问，示例用__return_true允许所有访问
        'permission_callback' => '__return_true',
    ));
}
add_action('rest_api_init', 'register_pdf_generator_endpoint');

function handle_pdf_generation($request) {
    // 安全获取参数
    $value = $request->get_param('value');
    if (empty($value)) {
        return new WP_Error('missing_param', 'Value parameter is required', array('status' => 400));
    }

    // 设置PDF响应头
    header('Content-Type: application/pdf');
    header('Content-Disposition: inline; filename="custom-pdf.pdf"');

    // 执行TCPDF生成逻辑
    $pdf = new TCPDF();
    // 这里添加你的PDF内容构建代码，比如添加页面、写入文字等
    $pdf->AddPage();
    $pdf->SetFont('helvetica', '', 12);
    $pdf->Cell(0, 10, 'Generated PDF with value: ' . esc_html($value), 0, 1);

    // 输出PDF
    $pdf->Output('custom-pdf.pdf', 'I');
    exit;
}

之后访问www.mywp.com/wp-json/pdf/v1/generate?value=4243就能正常生成PDF了，完全在WP的上下文里运行，不会有函数未定义的问题。

方案3：安全加载WP核心（备选，仅当必须直接访问PHP文件时） #

如果因为某些原因必须直接访问page-myslug.php，可以用更安全的方式代替直接require wp-load.php，避免路径错误和重复加载：

// 放在page-myslug.php的最顶部
if (!defined('ABSPATH')) {
    // 自动定位WP根目录
    $wp_root = dirname(__FILE__);
    while (!file_exists($wp_root . '/wp-load.php') && $wp_root !== '/') {
        $wp_root = dirname($wp_root);
    }
    if (file_exists($wp_root . '/wp-load.php')) {
        require_once($wp_root . '/wp-load.php');
    } else {
        die('Could not locate WordPress core files.');
    }
}

不过这个方案还是不如前两个优雅，因为直接访问PHP文件会绕开WP的安全检查和钩子系统，优先推荐方案1或2。

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