咨询：WooCommerce API下单时可触发自定义PHP代码的Hook

嘿，我明白你的困扰——woocommerce_order_status_changed在前端下单时工作正常，但API创建订单时就没反应了。这是因为这个钩子的触发逻辑依赖订单状态从旧值变更为新值的动作，而API创建订单时往往是直接设置初始状态（比如创建时就设为processing），没有经历“旧状态→新状态”的变更流程，所以钩子不会被调用。

下面给你几个更适合API场景的钩子，按需选择：

1. 通用订单创建钩子：woocommerce_new_order #

不管是前端还是API创建订单，只要订单成功生成，这个钩子就会触发。如果你的代码不需要依赖状态变更，只是订单创建时执行，这个最通用：

add_action('woocommerce_new_order', 'handle_all_new_orders', 10, 1);
function handle_all_new_orders($order_id) {
    $order = wc_get_order($order_id);
    
    // 可选：判断是否是API订单（通过请求URL识别）
    if (isset($_SERVER['REQUEST_URI']) && strpos($_SERVER['REQUEST_URI'], '/wp-json/wc/') !== false) {
        // 针对API订单的专属逻辑
        error_log("API订单创建：ID {$order_id}");
    }
    
    // 你的通用自定义代码
    // ...
}

2. API专属钩子：woocommerce_rest_insert_shop_order_object #

这个是WooCommerce REST API特有的钩子，在API创建或更新订单对象后立即触发，能直接拿到订单对象和API请求对象，非常适合针对API订单的操作：

add_action('woocommerce_rest_insert_shop_order_object', 'handle_api_order_actions', 10, 3);
function handle_api_order_actions($order, $request, $creating) {
    // $creating 为true时表示是创建订单，false是更新订单
    if ($creating) {
        $order_id = $order->get_id();
        $order_status = $order->get_status();
        
        // 你的自定义代码，比如同步订单到外部系统
        // ...
        
        error_log("通过API创建订单：ID {$order_id}，状态 {$order_status}");
    }
}

3. 特定状态触发钩子：woocommerce_order_status_{status} #

如果你的代码需要在订单变为某个特定状态时执行（比如completed、processing），可以用这个动态钩子。不管是前端还是API设置状态，只要状态确实发生了变更，这个钩子就会触发：

// 比如监听订单变为processing状态
add_action('woocommerce_order_status_processing', 'handle_order_processing', 10, 1);
function handle_order_processing($order_id) {
    $order = wc_get_order($order_id);
    
    // 你的自定义代码
    // ...
}

为什么woocommerce_order_status_changed不生效？ #

再补充下原因：当通过API创建订单时，很多时候是直接在请求中指定status参数，WooCommerce会直接将订单初始状态设为该值，没有“旧状态”的存在，所以woocommerce_order_status_changed需要的$oldstatus和$newstatus的变更动作没有发生，钩子自然不会触发。如果API是更新现有订单的状态，这个钩子是会正常工作的。

建议根据你的业务需求选择合适的钩子，测试时可以用Postman或curl调用WooCommerce API创建订单，查看日志确认代码是否执行。

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