本文介绍两种专业方法，实现仅统计购物车中特定商品 ID（如门票类商品）的数量，避免默认 get_cart_contents_count() 统计全部商品，从而精准控制结账页动态表单字段的生成逻辑。

本文介绍两种专业方法，实现仅统计购物车中特定商品 id（如门票类商品）的数量，避免默认 `get_cart_contents_count()` 统计全部商品，从而精准控制结账页动态表单字段的生成逻辑。

在 WooCommerce 开发中，常需根据购物车中某类商品（例如门票、课程名额等）的数量动态渲染结账表单字段——比如每购买 1 张门票，就显示 1 组姓名填写框。但原生 WC()->cart->get_cart_contents_count() 返回的是整个购物车所有商品项的总数量（按数量累加），无法区分商品类型，导致非门票商品也会触发冗余表单，影响用户体验与数据准确性。

✅ 推荐方案：使用 get_cart_item_quantities() 精确过滤

最清晰、安全且可维护的方式是绕过全局计数函数，直接遍历 WC_Cart::get_cart_item_quantities() —— 该方法返回一个以 product_id 为键、对应数量为值的关联数组，天然支持按 ID 筛选：

add_action( 'woocommerce_before_order_notes', 'person_details' );
function person_details( $checkout ) {
    if ( ! WC()->cart || WC()->cart->is_empty() ) {
        return;
    }

    // 定义需统计的门票商品 ID 列表（请替换为你的真实商品 ID）
    $ticket_product_ids = array( 30, 823, 53, 57 );

    $total_ticket_count = 0;
    foreach ( WC()->cart->get_cart_item_quantities() as $product_id => $quantity ) {
        if ( in_array( (int) $product_id, $ticket_product_ids, true ) ) {
            $total_ticket_count += $quantity;
        }
    }

    // 动态生成 attendee 表单（从 1 开始编号）
    for ( $i = 1; $i <= $total_ticket_count; $i++ ) {
        echo '<h3>' . sprintf( __( 'Please enter details of attendee %d', 'textdomain' ), $i ) . '</h3>';

        woocommerce_form_field( "cstm_full_name{$i}", array(
            'type'          => 'text',
            'class'         => array( 'my-field-class form-row-wide' ),
            'label'         => __( 'Full name', 'textdomain' ),
            'placeholder'   => __( 'Enter full name', 'textdomain' ),
            'required'      => true,
        ), $checkout->get_value( "cstm_full_name{$i}" ) );

        echo '<div class="clear"></div>';
    }
}

✅ 优势说明：

• 不修改全局行为，不影响其他插件或主题对 get_cart_contents_count() 的调用；
• 支持多数量商品（如用户购买 2 张 ID=30 的票，自动计入 2 次）；
• 使用 (int) 类型强转和 true 严格比较，避免字符串 ID 匹配异常；
• 增加 WC()->cart->is_empty() 防御性判断，提升健壮性。

⚠️ 替代方案：通过过滤器劫持 get_cart_contents_count()

若项目中已大量依赖 get_cart_contents_count() 且难以重构，可使用 woocommerce_cart_contents_count 过滤器进行“局部重写”：

add_filter( 'woocommerce_cart_contents_count', 'filter_ticket_cart_count', 10, 1 );
function filter_ticket_cart_count( $count ) {
    if ( ! WC()->cart || WC()->cart->is_empty() ) {
        return 0;
    }

    $ticket_product_ids = array( 30, 823, 53, 57 );
    $filtered_count = 0;

    foreach ( WC()->cart->get_cart_item_quantities() as $product_id => $quantity ) {
        if ( in_array( (int) $product_id, $ticket_product_ids, true ) ) {
            $filtered_count += $quantity;
        }
    }

    return $filtered_count;
}

⚠️ 重要提醒：此方式会全局覆盖 get_cart_contents_count() 的返回值——包括购物车小工具、页眉徽章、AJAX 更新等所有调用场景。除非你明确要求 全站所有位置 都只显示门票数量，否则不建议采用。

? 总结与最佳实践

• 首选 get_cart_item_quantities() + 循环过滤：语义清晰、作用域可控、易于调试，是 WooCommerce 官方推荐的数据访问模式；
• 避免直接修改核心计数逻辑：防止副作用，尤其在多插件共存环境中；
• 务必校验商品 ID 类型：数据库中 product_id 为整型，PHP 数组键可能被转为字符串，强制 (int) 转换可杜绝匹配失败；
• 前端体验优化建议：配合 AJAX 实时更新 attendee 字段数（监听 updated_cart_totals 事件），提升交互流畅度。

通过以上任一方案，你即可精准驱动结账页动态表单，确保每个门票订单都获得恰好数量的实名信息采集入口，兼顾功能严谨性与用户体验。