ACF字段结合PHP定时横幅功能故障排查求助

我来帮你排查并修复这个定时横幅的问题，咱们一步步拆解问题并给出解决方案：

可能的核心问题点 #

• DateTime解析不严谨：ACF返回的是Y-m-d H:i格式的字符串，但直接用new DateTime()解析时，若服务器时区设置或格式有细微差异，容易导致解析失败。
• 时区不一致：服务器默认时区可能和你预期的时区不匹配，导致时间比较逻辑出错。
• 缺乏错误校验：没有对字段空值、DateTime对象创建失败等情况做处理，出问题时难以定位原因。

修复后的完整代码 #

function scheduled_site_banner() {
    // 先确认ACF插件已激活
    if (!function_exists('get_field')) {
        return;
    }

    // 从ACF选项页获取字段（必须指定'option'参数，因为是选项页字段）
    $start_date = get_field('banner_start_date', 'option');
    $end_date = get_field('banner_end_date', 'option');
    $banner_message = get_field('banner_message', 'option');

    // 校验必填字段是否都已填写
    if (empty($start_date) || empty($end_date) || empty($banner_message)) {
        return;
    }

    // 匹配ACF设置的日期格式
    $acf_date_format = 'Y-m-d H:i';
    // 使用WordPress站点设置的时区，避免时区偏差
    $site_timezone = new DateTimeZone(wp_timezone_string());

    // 严格按照指定格式和时区创建DateTime对象
    $start_time = DateTime::createFromFormat($acf_date_format, $start_date, $site_timezone);
    $end_time = DateTime::createFromFormat($acf_date_format, $end_date, $site_timezone);
    $current_time = new DateTime('now', $site_timezone);

    // 检查DateTime对象是否创建成功，失败则记录日志便于排查
    if (!$start_time || !$end_time) {
        error_log('Banner date parsing failed: start=' . $start_date . ', end=' . $end_date);
        return;
    }

    // 格式化用于显示的日期
    $formatted_start_date = $start_time->format('F j, Y');
    $formatted_end_date = $end_time->format('F j, Y');

    // 检查当前时间是否在设定的时间范围内（包含起始和结束时间点）
    if ($current_time >= $start_time && $current_time <= $end_time) {
        ?>
        <div class="site-banner">
            <span>
                <strong>Important Notice:</strong> <?php echo esc_html($banner_message); ?>  
                Our site-wide banner is scheduled to display from <?php echo esc_html($formatted_start_date); ?> to <?php echo esc_html($formatted_end_date); ?>
            </span>
        </div>
        <?php
    }
}
add_action('wp_footer', 'scheduled_site_banner');

关键修复说明 #

1. ACF激活校验：避免ACF未激活时出现致命错误。
2. 字段非空校验：防止空字段导致的逻辑异常。
3. 严格日期解析：用DateTime::createFromFormat按照ACF设置的Y-m-d H:i格式解析日期，同时绑定站点时区，彻底解决时区和格式不匹配的问题。
4. 错误日志记录：若日期解析失败，会把错误信息写入服务器日志，方便后续排查。
5. 安全输出：用esc_html()转义输出内容，符合WordPress安全开发规范，防止XSS攻击。
6. 包含边界时间：将比较逻辑改为>=和<=，确保在起始和结束的精确时间点也能正常显示横幅。

额外排查步骤 #

• 确认ACF选项页的字段键和代码中使用的banner_start_date、banner_end_date、banner_message完全一致（ACF字段键为小写字母+下划线格式，注意不要拼写错误）。
• 查看服务器PHP错误日志，确认是否有DateTime相关的报错信息。
• 可临时在代码中添加var_dump($start_date, $end_date);，验证ACF是否返回了预期的日期字符串。

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