WordPress自定义日期计算器插件仅每月21日可用问题求助

问题概述 #

开发的WordPress日期计算器插件，核心功能是计算房产交割日之后第45天和180天的日期，采用Epoch时间转换逻辑（将Datetime转为Epoch时间，添加对应天数的秒数后转回Datetime）规避闰年问题。本地PHP+HTML表单测试无异常，但移植到WordPress后，仅选择每月21日能正常运行，选择其他日期会触发404错误。

可能原因 #

• Permalink规则冲突：WordPress默认支持日期型固定链接结构（如/%year%/%monthnum%/%day%/%postname%/），当表单以GET方式提交日期参数（如2024-05-20）时，WordPress会误将日期串解析为文章/页面的路由，导致返回404。21日可能恰好未匹配到任何现有日期路由，因此能正常运行。
• 表单参数传递异常：日期参数未正确URL编码，部分字符（如-）在服务器解析时被截断或误判，仅21日的参数格式未触发该问题。
• 插件路由未正确注册：插件自定义的表单处理路由规则存在缺陷，仅能匹配包含21的日期参数，其他日期无法命中处理逻辑，触发WordPress的404机制。

解决方法 #

1. 改用POST方式提交表单（推荐） #

避免日期参数出现在URL中，彻底规避Permalink规则干扰：

<form method="POST" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
    <!-- 指定WordPress后台处理动作 -->
    <input type="hidden" name="action" value="calc_settlement_dates">
    <input type="date" name="settlement_date" required>
    <button type="submit">计算日期</button>
</form>

在插件中注册POST动作处理函数：

// 处理登录用户请求
add_action('admin_post_calc_settlement_dates', 'process_settlement_calculation');
// 处理未登录用户请求
add_action('admin_post_nopriv_calc_settlement_dates', 'process_settlement_calculation');

function process_settlement_calculation() {
    if (!isset($_POST['settlement_date'])) {
        wp_redirect($_SERVER['HTTP_REFERER']);
        exit;
    }

    // 日期计算逻辑
    $settlement_dt = new DateTime($_POST['settlement_date']);
    $epoch = $settlement_dt->getTimestamp();
    
    $day_45 = new DateTime();
    $day_45->setTimestamp($epoch + 45 * 24 * 60 * 60);
    
    $day_180 = new DateTime();
    $day_180->setTimestamp($epoch + 180 * 24 * 60 * 60);

    // 携带结果跳转回原页面
    wp_redirect(add_query_arg(
        ['res_45' => $day_45->format('Y-m-d'), 'res_180' => $day_180->format('Y-m-d')],
        $_SERVER['HTTP_REFERER']
    ));
    exit;
}

2. 修复GET方式的Permalink冲突 #

若必须使用GET提交，添加重写规则排除日期参数的解析：

function add_calc_date_rewrite_rule() {
    add_rewrite_rule(
        '^settlement-calc/date=([0-9-]+)/?',
        'index.php?calc_action=1&settlement_date=$matches[1]',
        'top'
    );
}
add_action('init', 'add_calc_date_rewrite_rule');

// 注册自定义查询变量
function register_calc_query_vars($vars) {
    $vars[] = 'calc_action';
    $vars[] = 'settlement_date';
    return $vars;
}
add_filter('query_vars', 'register_calc_query_vars');

添加后需进入WordPress后台「设置-固定链接」页面，点击「保存更改」刷新重写规则。

3. 验证并编码日期参数 #

在前端对日期参数进行URL编码，避免解析异常：

document.querySelector('form').addEventListener('submit', function(e) {
    const dateInput = this.querySelector('input[name="settlement_date"]');
    dateInput.value = encodeURIComponent(dateInput.value);
});

后端处理时解码参数：

$settlement_date = urldecode(get_query_var('settlement_date'));
$settlement_dt = new DateTime($settlement_date);

测试验证 #

• 选择不同日期（如1日、15日、30日）提交表单，确认是否仍触发404。
• 开启WordPress调试模式（wp-config.php中设置WP_DEBUG=true、WP_DEBUG_LOG=true），查看wp-content/debug.log中的路由错误日志，辅助定位剩余问题。

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