WordPress│カテゴリー・タグを一括登録する方法｜WP-CLIで確認してから追加

<?php
// wp eval-file waza-terms.php category dry-run
// wp eval-file waza-terms.php category apply
function waza_import_terms(array $rows, string $taxonomy, bool $apply = false): array {
    if (!in_array($taxonomy, array('category', 'post_tag'), true)) throw new RuntimeException('category / post_tag のみ対応');
    $known = array(); $plan = array();
    foreach ($rows as $row) {
        if (!is_array($row) || array_keys($row) !== array(0, 1, 2)
            || count(array_filter($row, 'is_string')) !== 3) {
            throw new RuntimeException('各行は名前・スラッグ・親スラッグの3つの文字列にしてください');
        }
        list($name, $slug, $parent_slug) = $row;
        if ($name !== trim($name) || sanitize_title($slug) !== $slug
            || ($parent_slug !== '' && sanitize_title($parent_slug) !== $parent_slug)) {
            throw new RuntimeException('前後の空白・ハイフンなど、保存時に変わる入力を修正: ' . $slug);
        }
        if (!$name || !preg_match('/^[a-z0-9-]+$/D', $slug) || isset($known[$slug])) throw new RuntimeException('名前・スラッグ・重複を確認: ' . $slug);
        if ($taxonomy === 'post_tag' && $parent_slug !== '') throw new RuntimeException('タグに親は指定できません');
        $parent_id = 0;
        if ($parent_slug !== '') {
            if (isset($known[$parent_slug])) $parent_id = $known[$parent_slug];
            else {
                $parent = get_term_by('slug', $parent_slug, $taxonomy);
                if (!$parent) throw new RuntimeException('親を先に記載: ' . $parent_slug);
                $parent_id = (int) $parent->term_id;
            }
        }
        $existing = get_term_by('slug', $slug, $taxonomy);
        if ($existing && ($existing->name !== $name || (int) $existing->parent !== $parent_id)) throw new RuntimeException('既存データと不一致: ' . $slug);
        $id = $existing ? (int) $existing->term_id : -(count($plan) + 1);
        $known[$slug] = $id;
        $plan[] = array('name' => $name, 'slug' => $slug, 'parent_slug' => $parent_slug, 'id' => $id, 'action' => $existing ? 'keep' : 'create');
    }
    if (!$apply) return $plan;
    $resolved = array(); $result = array();
    foreach ($plan as $item) {
        $id = $item['id'];
        if ($item['action'] === 'create') {
            $parent_id = 0;
            if ($item['parent_slug'] !== '') {
                $parent = get_term_by('slug', $item['parent_slug'], $taxonomy);
                if (!$parent) throw new RuntimeException('親が消失しました。処理を中止します');
                $parent_id = (int) $parent->term_id;
            }
            // 同時編集を避け、直前にもスラッグの重複を確認します。
            if (get_term_by('slug', $item['slug'], $taxonomy)) throw new RuntimeException('実行中に既存データが変わりました: ' . $item['slug']);
            $created = wp_insert_term($item['name'], $taxonomy, array('slug' => $item['slug'], 'parent' => $parent_id));
            if (is_wp_error($created)) throw new RuntimeException($created->get_error_message());
            $id = (int) $created['term_id'];
        }
        $item['id'] = $id; $result[] = $item;
        echo wp_json_encode($item, JSON_UNESCAPED_UNICODE) . PHP_EOL;
    }
    return $result;
}
if (defined('WP_CLI') && WP_CLI) {
    $taxonomy = $args[0] ?? 'category';
    $mode = $args[1] ?? 'dry-run';
    if (!in_array($mode, array('dry-run', 'apply'), true)) WP_CLI::error('dry-run / apply を指定');
    $rows = array(
        array('関東', 'kanto', ''),
        array('東京', 'tokyo', 'kanto'),
        array('神奈川', 'kanagawa', 'kanto'),
    );
    try {
        $result = waza_import_terms($rows, $taxonomy, $mode === 'apply');
        if ($mode === 'dry-run') WP_CLI::line(wp_json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT));
    } catch (Throwable $e) { WP_CLI::error($e->getMessage()); }
}

wp eval-file /private/path/waza-terms.php category dry-run
wp eval-file /private/path/waza-terms.php category apply > terms-created.log

array('関東', 'kanto', ''),
array('茨城', 'ibaraki', 'kanto'),
array('栃木', 'tochigi', 'kanto'),
array('群馬', 'gunma', 'kanto'),
array('埼玉', 'saitama', 'kanto'),
array('千葉', 'chiba', 'kanto'),
array('東京', 'tokyo', 'kanto'),
array('神奈川', 'kanagawa', 'kanto'),

array('北海道・東北', 'hokkaido-tohoku', ''),
array('北海道', 'hokkaido', 'hokkaido-tohoku'),
array('青森', 'aomori', 'hokkaido-tohoku'),
array('岩手', 'iwate', 'hokkaido-tohoku'),
array('宮城', 'miyagi', 'hokkaido-tohoku'),
array('秋田', 'akita', 'hokkaido-tohoku'),
array('山形', 'yamagata', 'hokkaido-tohoku'),
array('福島', 'fukushima', 'hokkaido-tohoku'),
array('関東', 'kanto', ''),
array('茨城', 'ibaraki', 'kanto'),
array('栃木', 'tochigi', 'kanto'),
array('群馬', 'gunma', 'kanto'),
array('埼玉', 'saitama', 'kanto'),
array('千葉', 'chiba', 'kanto'),
array('東京', 'tokyo', 'kanto'),
array('神奈川', 'kanagawa', 'kanto'),
array('甲信越・北陸', 'koshinetsu-hokuriku', ''),
array('新潟', 'niigata', 'koshinetsu-hokuriku'),
array('富山', 'toyama', 'koshinetsu-hokuriku'),
array('石川', 'ishikawa', 'koshinetsu-hokuriku'),
array('福井', 'fukui', 'koshinetsu-hokuriku'),
array('長野', 'nagano', 'koshinetsu-hokuriku'),
array('山梨', 'yamanashi', 'koshinetsu-hokuriku'),
array('東海', 'tokai', ''),
array('岐阜', 'gifu', 'tokai'),
array('静岡', 'shizuoka', 'tokai'),
array('愛知', 'aichi', 'tokai'),
array('三重', 'mie', 'tokai'),
array('近畿', 'kinki', ''),
array('滋賀', 'shiga', 'kinki'),
array('京都', 'kyoto', 'kinki'),
array('大阪', 'osaka', 'kinki'),
array('兵庫', 'hyogo', 'kinki'),
array('奈良', 'nara', 'kinki'),
array('和歌山', 'wakayama', 'kinki'),
array('中国', 'chugoku', ''),
array('鳥取', 'tottori', 'chugoku'),
array('島根', 'shimane', 'chugoku'),
array('岡山', 'okayama', 'chugoku'),
array('広島', 'hiroshima', 'chugoku'),
array('山口', 'yamaguchi', 'chugoku'),
array('四国', 'shikoku', ''),
array('徳島', 'tokushima', 'shikoku'),
array('香川', 'kagawa', 'shikoku'),
array('愛媛', 'ehime', 'shikoku'),
array('高知', 'kochi', 'shikoku'),
array('九州・沖縄', 'kyushu-okinawa', ''),
array('福岡', 'fukuoka', 'kyushu-okinawa'),
array('佐賀', 'saga', 'kyushu-okinawa'),
array('長崎', 'nagasaki', 'kyushu-okinawa'),
array('熊本', 'kumamoto', 'kyushu-okinawa'),
array('大分', 'oita', 'kyushu-okinawa'),
array('宮崎', 'miyazaki', 'kyushu-okinawa'),
array('鹿児島', 'kagoshima', 'kyushu-okinawa'),
array('沖縄', 'okinawa', 'kyushu-okinawa'),