如何避免WordPress自定义PHP文件中出现Call to undefined function致命错误

在WordPress环境中制作可定制CSS样式表，通过Advanced Custom Fields（ACF）插件创建了名为primary_theme_color的选项级自定义字段（存储HEX格式颜色值），并编写了一个PHP文件作为CSS资源加载，目的是将ACF的颜色值注入到CSS变量中。但该PHP文件触发致命错误：

Fatal error: Uncaught Error: Call to undefined function the_field()...

对应的PHP代码如下：

<?php
header('Content-type: text/css');
the_field('primary_theme_color', 'option');
$color = the_field('primary_theme_color', 'option');
?>
:root {
    --primary-color:<?php echo $color; ?>;
}
* {
    background-color: var(--primary-color);
}

明明the_field()是ACF插件提供的函数，为何在此无法正常调用？

• 根本原因：未接入WordPress环境
  这个PHP文件是被直接独立访问的，没有触发WordPress的初始化流程，导致WordPress核心函数、ACF插件的函数都未被加载，所以系统无法识别the_field()这类依赖于WordPress的函数。

• 修复方案

  1. 引入WordPress核心初始化文件
     在PHP文件最开头添加代码，引入WordPress的wp-load.php，确保加载所有必要的核心和插件资源：

     <?php
     // 路径需根据你的WordPress安装目录调整，根目录下可直接用此路径
     require_once($_SERVER['DOCUMENT_ROOT'] . '/wp-load.php');
     header('Content-type: text/css');
     // 使用get_field()获取值，而非直接输出的the_field()
     $color = get_field('primary_theme_color', 'option') ?: '#ffffff';
     ?>
     :root {
         --primary-color:<?php echo esc_attr($color); ?>;
     }
     * {
         background-color: var(--primary-color);
     }
     

  2. 替换the_field()为get_field()
the_field()的作用是直接输出字段内容，而你需要将值赋值给变量，应该使用get_field()——它会返回字段值，方便后续赋值和处理。
  3. 添加默认值与安全防护
     通过?: '#ffffff'设置默认颜色，避免字段为空时CSS变量失效；使用esc_attr()转义输出内容，防止潜在的XSS安全风险。

内容的提问来源于stack exchange，提问作者José Carlos PHP