WooCommerce订单校验：如何借助非UI钩子实现最低金额或商品数量限制？

嘿，这个需求我太懂了——只靠禁用「Proceed to checkout」和「Place order」按钮确实不够稳妥，万一有人通过直接调用API、修改前端代码甚至手动构造请求绕过UI限制，那你的规则就形同虚设了。WooCommerce其实提供了几个后端级别的非UI钩子，能帮你在订单创建的关键环节做强制校验，完全不用担心被绕过，下面给你详细说：

1. 用woocommerce_check_cart_items钩子做购物车全局校验 #

这个钩子会在购物车页面加载、结账页面加载以及用户尝试更新购物车时触发，属于比较早期的校验节点，能提前拦截不符合要求的购物车状态。

你可以用它同时检查最低金额和最低商品数量，代码示例如下：

add_action('woocommerce_check_cart_items', 'enforce_minimum_order_requirements');

function enforce_minimum_order_requirements() {
    // 自定义你的规则：最低金额和最低商品数量
    $minimum_amount = 50; // 单位：欧元
    $minimum_items = 3;

    // 获取当前购物车的总金额（不含运费、税费）
    $cart_subtotal = WC()->cart->subtotal;
    // 获取当前购物车的商品总数量
    $cart_item_count = WC()->cart->get_cart_contents_count();

    // 校验逻辑：不满足任一条件就触发错误
    if ($cart_subtotal < $minimum_amount && $cart_item_count < $minimum_items) {
        wc_add_notice(
            sprintf('请满足最低订单要求：至少消费%s€，或至少购买%s件商品', $minimum_amount, $minimum_items),
            'error'
        );
    } elseif ($cart_subtotal < $minimum_amount) {
        wc_add_notice(
            sprintf('订单金额不足，请至少消费%s€', $minimum_amount),
            'error'
        );
    } elseif ($cart_item_count < $minimum_items) {
        wc_add_notice(
            sprintf('商品数量不足，请至少购买%s件商品', $minimum_items),
            'error'
        );
    }
}

这段代码会自动在购物车/结账页面顶部显示错误提示，同时WooCommerce会自动禁用结账相关的操作（包括按钮和后端提交），非常省心。

2. 用woocommerce_checkout_process钩子做结账前最终校验 #

如果说上面的钩子是“前置拦截”，那woocommerce_checkout_process就是订单创建前的最后一道防线——它会在用户点击「Place order」后、后端真正生成订单之前触发，哪怕用户绕过了前端校验，这个钩子也能直接阻断订单创建。

代码逻辑和上面类似，你可以单独用它，也可以和上面的钩子配合使用（双重保险）：

add_action('woocommerce_checkout_process', 'enforce_minimum_order_at_checkout');

function enforce_minimum_order_at_checkout() {
    $minimum_amount = 50;
    $minimum_items = 3;

    $cart_subtotal = WC()->cart->subtotal;
    $cart_item_count = WC()->cart->get_cart_contents_count();

    if ($cart_subtotal < $minimum_amount && $cart_item_count < $minimum_items) {
        wc_add_notice(
            sprintf('请满足最低订单要求：至少消费%s€，或至少购买%s件商品', $minimum_amount, $minimum_items),
            'error'
        );
    }
}

为什么推荐用非UI钩子？ #

• 安全性高：这些钩子运行在后端，前端无法修改或绕过，完全杜绝了“钻空子”的可能；
• 兼容性好：不管你用什么主题或结账插件，只要是基于标准WooCommerce流程，这些钩子都能正常工作；
• 自带提示：用wc_add_notice添加的错误信息会自动适配你的站点样式，不用自己写额外的UI代码。

把上面的代码加到你的主题functions.php文件里，或者用自定义代码插件（比如Code Snippets）添加，就能实现你想要的强制校验啦！

备注：内容来源于stack exchange，提问作者fudo