如何批量更新 WooCommerce 商品分类：从 cat1 替换为 cat2-php教程-PHP中文网

如何批量更新 WooCommerce 商品分类：从 cat1 替换为 cat2

本文介绍一种安全、高效的 php 脚本方案，通过 url 触发方式（如 domain.de/start.php?update_cats=yes）批量将 woocommerce 中所有属于指定旧分类（如 cat1）的商品，重新分配至新分类（如 cat2），避免手动操作与插件依赖。

本文介绍一种安全、高效的 php 脚本方案，通过 url 触发方式（如 domain.de/start.php?update_cats=yes）批量将 woocommerce 中所有属于指定旧分类（如 cat1）的商品，重新分配至新分类（如 cat2），避免手动操作与插件依赖。

在 WooCommerce 项目维护中，常需批量调整商品分类结构（例如品牌重组、类目优化或迁移）。手动逐个编辑效率低下且易出错，而借助 WordPress 原生函数编写轻量脚本，既能精准控制逻辑，又无需安装额外插件。

以下是一个经过验证的可部署 PHP 脚本（建议保存为 start.php 并置于网站根目录）：

职徒简历

职徒简历是一款AI求职招聘工具，智能简历制作软件，基于GPT的简历优化和简历代写。

下载

<?php // start.php —— 安全可控的商品分类批量更新脚本
require_once( dirname(__FILE__) . '/wp-load.php' );

if ( isset( $_GET['update_cats'] ) && 'yes' === $_GET['update_cats'] ) {
    // 验证管理员权限（强烈建议添加）
    if ( ! current_user_can( 'manage_woocommerce' ) ) {
        wp_die( '权限不足：仅管理员可执行此操作。' );
    }

    add_action( 'init', 'change_products_categories' );
}

function change_products_categories() {
    // 查询所有属于旧分类（如 'cat-1'）的商品
    $args = array(
        'status'   => 'publish',
        'limit'    => -1, // 获取全部，生产环境建议分批处理（见下方说明）
        'category' => array( 'cat-1' ), // 替换为你的旧分类 slug
        'return'   => 'ids', // 仅返回 ID，减少内存占用
    );

    $product_ids = wc_get_products( $args );

    if ( empty( $product_ids ) ) {
        error_log( '未找到属于旧分类的产品。' );
        return;
    }

    $new_category_slug = 'cat-2'; // 替换为你的新分类 slug

    foreach ( $product_ids as $product_id ) {
        // 注意：wp_set_object_terms 第三个参数为 taxonomy，WooCommerce 分类固定为 'product_cat'
        // 第四个参数 true 表示追加（保留其他分类）；false 表示替换（移除旧分类，仅保留新分类）
        // 此处使用 false 实现「将 cat-1 替换为 cat-2」，即移除旧分类、添加新分类
        wp_set_object_terms( $product_id, $new_category_slug, 'product_cat', false );

        // 可选：清除该商品缓存以确保前端立即生效
        wp_cache_delete( 'product_' . $product_id, 'products' );
    }

    error_log( sprintf( '成功更新 %d 个商品的分类。', count( $product_ids ) ) );
    wp_die( '✅ 分类更新完成！共处理 ' . count( $product_ids ) . ' 个商品。' );
}

? 关键注意事项：

✅ 安全性优先：脚本已内置 current_user_can('manage_woocommerce') 权限校验，防止未授权访问；生产环境务必启用。
✅ 分类替换逻辑：wp_set_object_terms(..., false) 表示完全替换当前 product_cat 分类，而非追加。若需保留其他已有分类（如 cat1 → cat4，同时保留 cat3），应设为 true 并先手动移除旧分类，或改用 wp_remove_object_terms() + wp_set_object_terms() 组合。
⚠️ 性能优化建议：对超千级商品，请勿使用 limit => -1。推荐分页处理（如每次 50 个），配合 AJAX 或 WP-CLI 调用，避免超时或内存溢出。
? 分类标识：务必使用分类的 slug（如 'electronics'），而非名称（如 'Electronics'），否则无法匹配。
? 上线前测试：先在开发环境运行，检查数据库 wp_term_relationships 表变更，并确认前台归档页与筛选逻辑正常。