WordPress functions.php中rest_api_init钩子触发时出现未定义常量错误

问题重现 #

报错信息：
Fatal error: Uncaught Error: Undefined constant "initCors" in functions.php（标记的倒数第二行）
本地环境无报错，部署至WP Engine主机时触发，已在代码开头定义initCors函数，且该代码在其他站点可正常运行。

原代码：

function initCors ( $value ) {
    header( 'Access-Control-Allow-Origin: ' . esc_url_raw( site_url() ) );
    header( 'Access-Control-Allow-Methods: GET' );
    header( 'Access-Control-Allow-Credentials: true' );
    return $value;
}
add_action( 'rest_api_init', function() {
    remove_filter( 'rest_pre_serve_request', 'rest_send_cors_headers' );
    add_filter( 'rest_pre_serve_request', initCors); // 错误行
}, 15 );

解决方案 #

修改错误行的函数引用方式，二选一即可：

方案1：使用函数名字符串（推荐） #

将initCors改为带引号的'initCors'，符合WordPress钩子的标准调用方式：

add_filter( 'rest_pre_serve_request', 'initCors');

方案2：用匿名函数包裹调用 #

如果需要保持灵活，也可以用匿名函数包裹原函数调用：

add_filter( 'rest_pre_serve_request', function($value) {
    return initCors($value);
});

原因说明 #

WP Engine的PHP环境通常启用了更严格的错误检测机制（比如高版本PHP或error_reporting包含E_ERROR级别）。当你直接写initCors时，PHP会优先将其解析为常量，找不到对应常量就直接抛出致命错误。而本地环境可能错误报告级别较低，或者PHP版本较旧，会自动将未定义的常量降级为字符串处理，因此没有触发报错。

WordPress的add_filter/add_action函数要求第二个参数是可调用的回调，合法形式包括函数名字符串、匿名函数、类方法数组等，直接写无引号的函数名不符合规范。

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