WooCommerce实现会话级单次刷新：购物车低金额时执行逻辑调试

• 原有代码中使用的static $foo_called属于单次PHP请求生命周期内的静态变量，页面刷新会触发全新的独立HTTP请求，所有进程内变量会被完全重置，根本无法跨请求记录“已执行过刷新”的状态
• 代码执行顺序存在硬伤：在购物车金额不足的分支中，是先发送Refresh:0的响应头，再对标记变量赋值，就算在单次请求里，标记的设置动作也完全起不到拦截刷新的作用
• 因为上述两个问题，每一次刷新后的新请求中，标记值都会初始化为false，逻辑就会再次判断金额低于阈值、再次发送刷新头，形成无限循环。

核心思路是把“已执行一次刷新”的标记改为客户端持久化状态存储，利用WooCommerce内置的会话机制跨请求追踪状态，从根本上解决进程内状态丢失的问题。
修正后的可运行代码如下：

/* Avoid 0 value order checkout */
add_action( 'woocommerce_check_cart_items', 'wc_minimum_order_amount' );
function wc_minimum_order_amount() {
    // 设定最低订单金额阈值
    $minimum = 100;
    // 从WooCommerce用户会话中读取已刷新标记
    $has_refreshed = WC()->session->get( 'low_value_cart_refreshed' );

    // 已完成过一次刷新动作，直接退出逻辑
    if ( $has_refreshed ) {
        // 购物车金额达标时重置标记，避免影响后续逻辑
        if ( WC()->cart->total >= $minimum ) {
            WC()->session->__unset( 'low_value_cart_refreshed' );
        }
        return;
    }

    if ( WC()->cart->total < $minimum ) {
        // 先持久化存储刷新标记，再发送刷新响应头
        WC()->session->set( 'low_value_cart_refreshed', true );
        header( "Refresh:0" );
        // 终止后续脚本执行，避免响应头发送失败
        exit;
    }
}

• 状态存储必须在发送刷新响应头之前完成，顺序颠倒会导致标记写入失败，依旧触发循环
• 当购物车总金额达到设定阈值时，必须主动清除之前存储的刷新标记，否则用户后续调整购物车、再次出现金额不足的场景时，逻辑不会正常触发
• 利用WooCommerce内置的WC()->session存储状态，和购物车本身的状态存储逻辑保持一致，适配WooCommerce的登录、游客会话兼容规则，比原生PHP Session稳定性更高
• 发送刷新头后加上exit终止脚本执行，避免后续WordPress、WooCommerce的其他钩子逻辑继续输出内容，导致响应头发送失败或者页面渲染异常

内容的提问来源于stack exchange，提问作者Andres Molina Perez-Tome