本教程详细讲解如何在 woocommerce 购物车中实现商品关联赠品的自动添加与移除功能。核心内容包括如何避免在 `woocommerce_add_to_cart` 钩子中调用 `wc()->cart->add_to_cart` 导致的无限递归问题，通过临时移除和重新添加钩子来安全操作；同时，提供了一套智能逻辑，确保当主商品被移除时，关联赠品也能被正确地从购物车中清除，提升用户体验和系统稳定性。
引言
在电子商务运营中，通过赠品促销来刺激消费是一种常见的营销策略。例如，当顾客购买特定商品时，自动向购物车添加一件免费赠品。更进一步，我们可能希望当顾客从购物车中移除主商品时，相应的赠品也能被自动移除。实现这一功能需要对 WooCommerce 的购物车机制有深入理解，并妥善处理可能出现的递归调用问题。
核心挑战：woocommerce_add_to_cart 钩子中的递归陷阱
当尝试在 woocommerce_add_to_cart 动作钩子的回调函数中，通过 WC()->cart->add_to_cart() 方法再次向购物车添加商品时，极易陷入无限递归循环。这是因为 WC()->cart->add_to_cart() 方法本身会触发 woocommerce_add_to_cart 钩子，导致回调函数被反复调用，最终可能耗尽系统资源，引发错误。
为了安全地在 woocommerce_add_to_cart 钩子中添加商品，我们需要在执行 WC()->cart->add_to_cart() 之前，临时移除当前正在执行的钩子，待商品添加完成后再将其重新添加回来。
解决方案一：安全添加赠品到购物车
以下代码演示了如何在购买特定商品时，安全地向购物车添加一件免费赠品。我们使用自定义的购物车项元数据（free_gift_meta）来标识赠品，以便后续管理。
/**
* 安全地添加赠品到购物车
* 当特定商品被添加到购物车时，自动添加一个赠品。
*
* @param string $cart_item_key 购物车项的唯一键。
* @param int $product_id 被添加商品的ID。
* @param int $quantity 被添加商品的数量。
* @param int $variation_id 变体ID（如果存在）。
* @param array $variation 变体数据（如果存在）。
* @param array $cart_item_data 购物车项的自定义数据。
*/
function gift_add_product_to_cart_safely( $cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data ) {
// 定义赠品ID和触发赠品添加的主商品ID
$free_product_ids = array( 20070, 39039 ); // 赠品商品ID列表
$trigger_product_ids = array( 38162, 38157 ); // 触发赠品添加的主商品ID列表
$cart = WC()->cart->get_cart();
$has_trigger_product = false;
$has_free_gift = false;
// 遍历购物车，检查是否存在触发商品和已添加的赠品
foreach ( $cart as $item_key => $item_values ) {
// 检查购物车中是否存在任何触发商品
if ( in_array( $item_values['product_id'], $trigger_product_ids ) ) {
$has_trigger_product = true;
}
// 检查是否已经存在我们通过自定义meta标识的赠品
if ( in_array( $item_values['product_id'], $free_product_ids ) && isset( $item_values['free_gift_meta'] ) && $item_values['free_gift_meta'] === 'yes' ) {
$has_free_gift = true;
}
}
// 如果购物车中存在触发商品，但尚未添加赠品
if ( $has_trigger_product && ! $has_free_gift ) {
// 临时移除当前钩子，防止 add_to_cart 递归调用导致无限循环
remove_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_safely', 10, 6 );
// 遍历并添加所有定义的赠品
foreach ( $free_product_ids as $free_id ) {
// 添加赠品到购物车，并附加自定义元数据 'free_gift_meta'
WC()->cart->add_to_cart( $free_id, 1, 0, array(), array( 'free_gift_meta' => 'yes' ) );
}
// 重新添加此钩子，确保后续的 add_to_cart 操作仍能触发此逻辑
add_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_safely', 10, 6 );
}
}
add_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_safely', 10, 6 );代码解析：
- 定义商品ID： $free_product_ids 数组包含赠品的商品ID，$trigger_product_ids 数组包含会触发赠品添加的主商品ID。
