PHP基于数组数据为WooCommerce添加产品变量问题排查

核心错误点 #

• 数组键未加引号：代码中$createvariablesniko[precio]、$createvariablesniko['atributos'][COLOR]、$createvariablesniko['atributos'][SIZE]的字符串键未加引号，PHP会将其识别为未定义常量，无法正确读取数组内的价格、属性值
• 属性赋值逻辑不符合WooCommerce规则：原代码将颜色、尺码的属性值强转为数组分别作为属性名/属性值，且未使用WooCommerce要求的属性taxonomy slug作为键，系统无法识别关联的属性项
• 未匹配属性存储格式：WooCommerce变体属性要求存储属性术语的slug，而非前台显示的文本值，属性键需和父产品绑定的属性slug完全一致（全局属性需带pa_前缀）

前置检查 #

执行创建代码前，先确认父产品（ID为$objProduct->get_id()返回的19289）满足以下条件：

• 产品类型已设置为「可变产品（variable）」
• 已添加COLOR、SIZE两个对应属性，且勾选了「用于变体」选项

正确实现代码 #

// 初始化父产品对象，确保类型为可变产品
$parent_product = wc_get_product($objProduct->get_id());
if (!$parent_product->is_type('variable')) {
    $parent_product->set_type('variable');
    $parent_product->save();
}

// 遍历自定义数组批量创建变体
foreach ($datastore as $variation_data) {
    // 正确读取数组值，所有字符串键必须包裹引号
    $price = $variation_data['precio'];
    $color_name = $variation_data['atributos']['COLOR'];
    $size_name = $variation_data['atributos']['SIZE'];

    // 初始化变体实例
    $variation = new \WC_Product_Variation();
    $variation->set_parent_id($objProduct->get_id());

    // 设置价格，需同时设置常规价避免前台显示异常
    $variation->set_regular_price($price);
    $variation->set_price($price);

    // 设置库存状态
    $variation->set_manage_stock(false);
    $variation->set_stock_status('instock');

    // 生成符合WooCommerce规则的属性数组
    // 注意：如果是产品自定义属性而非全局属性，去掉键名的pa_前缀即可
    $variation_attributes = [
        'pa_color' => sanitize_title($color_name),
        'pa_size'  => sanitize_title($size_name)
    ];
    $variation->set_attributes($variation_attributes);

    // 自动创建不存在的属性术语（避免属性值不被识别）
    if (!term_exists($color_name, 'pa_color')) {
        wp_insert_term($color_name, 'pa_color');
    }
    if (!term_exists($size_name, 'pa_size')) {
        wp_insert_term($size_name, 'pa_size');
    }

    // 保存变体到数据库
    $variation->save();
}

后续校验 #

代码执行完成后，进入WooCommerce后台工具页清理产品转存缓存，再打开父产品编辑页即可看到正常关联属性、价格的变体条目。

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