WooCommerce自动取消未支付订单：如何将日期差判断改为时间差（如5分钟）判断？

原代码核心问题 #

• 时间计算逻辑完全偏差：原代码通过%a格式符提取两个时间的自然日差值，哪怕订单刚创建5分钟，只要跨了零点就会被判定为相差1天，根本达不到分钟级判断的效果
• 自定义配置完全失效：代码已经从全局配置中读取了用户设置的待支付时长$my_cancel_time，但实际判断时硬编码了“相差4天”的阈值，没有用到配置项
• 时区匹配错误：直接实例化new DateTime()使用服务器PHP默认时区的时间，和WordPress后台设置的时区存在偏差，会导致时间计算整体不准
• 订单漏处理风险：原代码查询时只取最新的5条待支付订单，创建时间更早的超时订单会永远遍历不到，造成大量待支付订单积压

改造实现方案 #

基础逻辑版（兼容原代码遍历结构） #

核心调整点：把原来按天计算的差值，换算成总分钟数，和配置的待支付时长直接对比，统一使用WordPress自带的时区获取方法，避免时区误差。

function myplugin_cancel_unpaid_wc_orders() {
    global $myplugin_options;
    // 读取配置的待支付时长，单位为分钟，空值默认兜底5分钟
    $my_cancel_time = absint( $myplugin_options['myplugin_cancel_time'] );
    if ( empty( $my_cancel_time ) ) {
        $my_cancel_time = 5;
    }

    $orders = wc_get_orders( array(
        'limit'   => 100, // 单次最多处理100条订单，避免脚本超时
        'orderby' => 'date_created',
        'order'   => 'ASC',
        'status'  => array( 'pending' ),
    ) );

    foreach ( $orders as $order ) {        
        // 获取订单创建时间，匹配WordPress配置的时区
        $order_created = $order->get_date_created()->setTimezone( wp_timezone() );
        // 获取网站时区下的当前时间
        $now = new DateTime( 'now', wp_timezone() );
        // 计算两个时间戳的差值，换算为总分钟数
        $diff_minutes = floor( ( $now->getTimestamp() - $order_created->getTimestamp() ) / 60 );

        // 超时则自动取消
        if ( $diff_minutes >= $my_cancel_time ) {
            $order->update_status( 
                'cancelled', 
                sprintf( '订单超时未支付自动取消，累计等待%u分钟', $my_cancel_time ) 
            );
        }  
    }
}

性能优化版 #

可以直接在订单查询阶段就过滤掉所有未超时的订单，不需要把所有待支付订单都拉进循环遍历，大幅降低数据库查询开销：

function myplugin_cancel_unpaid_wc_orders() {
    global $myplugin_options;
    $my_cancel_time = absint( $myplugin_options['myplugin_cancel_time'] );
    if ( empty( $my_cancel_time ) ) {
        $my_cancel_time = 5;
    }

    // 计算超时阈值：当前时间往前推N分钟
    $timeout_boundary = strtotime( "-{$my_cancel_time} minutes", current_time( 'timestamp' ) );

    // 直接查询出创建时间早于超时阈值的待支付订单
    $orders = wc_get_orders( array(
        'limit'   => 100,
        'status'  => array( 'pending' ),
        'date_created' => '<' . $timeout_boundary,
    ) );

    foreach ( $orders as $order ) {
        $order->update_status( 
            'cancelled', 
            sprintf( '订单超时未支付自动取消，累计等待%u分钟', $my_cancel_time ) 
        );
    }
}

配套使用说明 #

• 这个函数不能直接挂在前台页面加载逻辑里触发，会拖慢页面速度，需要注册为WordPress定时任务，每分钟自动执行一次：

// 注册每分钟执行一次的定时任务
add_action( 'init', function() {
    if ( ! wp_next_scheduled( 'myplugin_cancel_unpaid_wc_orders' ) ) {
        wp_schedule_event( time(), 'every_minute', 'myplugin_cancel_unpaid_wc_orders' );
    }
} );
add_action( 'myplugin_cancel_unpaid_wc_orders', 'myplugin_cancel_unpaid_wc_orders' );

• 如果站点用了缓存插件或者主机禁了WP原生定时任务，可以把这个函数配置到服务器的系统定时任务里，每分钟访问对应触发地址执行。

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