English (US) – 永夜 https://www.shuijingwanwq.com 没有不值得去解决的问题,也没有不值得去学习的技术! Tue, 16 Jun 2026 07:31:03 +0000 zh-Hans hourly 1 https://wordpress.org/?v=7.0 WP 6.9 标签同步脚本在 WP 7.0 失效完整排查与解决实录 https://www.shuijingwanwq.com/2026/06/16/17171/ https://www.shuijingwanwq.com/2026/06/16/17171/#respond Tue, 16 Jun 2026 07:01:23 +0000 https://www.shuijingwanwq.com/?p=17171 Post Views: 6

一、前言
参考:博客标签翻译实操|8060个标签,基于 PHP 脚本实现全流程。使用一套自定义PHP脚本,实现批量遍历中文标签、自动同步缺失英文翻译标签的功能。该脚本在WordPress 6.9版本中稳定运行,零报错、零数据异常,可完美实现中英标签1:1对齐。
近期将站点升级至WordPress 7.0后,脚本突发异常:无报错、可正常运行,但无法补齐缺失的英文标签,出现中英标签数量不一致的问题。历经半天全方位排查、多次代码改写、数据库修复、踩坑测试,最终定位核心问题并完美解决。本文完整记录全部排查过程、源码、运行日志、故障原因与最终解决方案。


二、初始环境与基础配置
– 站点程序:WordPress 7.0(原稳定版本6.9)
– 多语言插件:Polylang 最新稳定版
– 缓存插件:W3 Total Cache
– 运行环境:Linux、PHP8.1、阿里云RDS MySQL
– 脚本功能:仅读取中文标签,自动检测英文缺失标签,仅新增英文标签,不修改、不删除任何中文原始数据


三、故障现象(升级WP7.0后)
站点升级WP7.0后,新增3个中文标签(360、Sitemap、站点地图),后台中英文标签数据如下:
– 中文标签总数:8274 项
– 英文标签总数:8271 项
– 数据差值:缺失3个英文翻译标签
– 异常表现:后台英文标签未同步
执行原本WP6.9可用的同步脚本,运行日志如下,脚本判定无需要处理的标签,完全失效:

 [root@iZ23wv7v5ggZ www.shuijingwanwq.com]# php polylang-batch-zh-to-en-tags.php
🚀 开始批量处理所有zh标签,自动添加en翻译(分页模式)...

📊 正在处理第 1 - 1000 个标签...
🔰 正在处理: 360 (ID: 36603)
📊 正在处理第 1001 - 2000 个标签...
📊 正在处理第 2001 - 3000 个标签...
📊 正在处理第 3001 - 4000 个标签...
📊 正在处理第 4001 - 5000 个标签...
🔰 正在处理: Sitemap (ID: 36607)
📊 正在处理第 5001 - 6000 个标签...
📊 正在处理第 6001 - 7000 个标签...
📊 正在处理第 7001 - 8000 个标签...
🔰 正在处理: 站点地图 (ID: 36604)
📊 正在处理第 8001 - 8274 个标签...

🎉 全部处理完成!
📊 统计:
   已处理新标签: 0
   已跳过已有翻译: 8271

✅ 所有标签都已经处理完毕,和手动添加的完全一样!

核心异常:脚本检测8271个标签已有翻译,0个新增,但实际英文标签确实缺失3个,属于假性判定已翻译故障。


四、多轮错误排查与踩坑记录
1. 误区一:判定为WP7.0底层API不兼容
初始怀疑WordPress7.0重构了术语、标签底层逻辑,导致Polylang旧API失效。尝试修改脚本:替换原生Polylang翻译绑定方法、改用$wpdb底层写入、手动添加语言归属字段、绑定翻译组ID。
修改后出现新故障:通过数据库直接写入的标签,无法被Polylang识别语言归属,全部变成无语言脏数据,后台英文列表不计数,全语言视图出现大量重复标签,问题进一步恶化。
2. 误区二:新增脏数据清理逻辑导致脚本卡死、数据损毁
为解决重复脏标签问题,新增批量查询、删除无语言标签的SQL逻辑。由于站点标签总量超8000条,循环连表查询+逐条删除的重量级操作,直接导致脚本卡死无输出。
强制终止脚本后,出现灾难性数据异常:英文标签总数从8000+暴跌至2项(如图1),大量正常英文标签被误判删除,中文标签出现冗余新增(如图2),数据彻底错乱。

强制终止脚本后,出现灾难性数据异常:英文标签总数从8000+暴跌至2项(如图1),大量正常英文标签被误判删除

中文标签出现冗余新增(如图2),数据彻底错乱。


3. 误区三:Polylang版本API参数报错
尝试使用新版Polylang官方函数 pll_save_term_translations() 绑定翻译关系,运行直接抛出PHP致命错误:参数类型不匹配,证实AI适配的新版代码存在兼容性bug,无法通用。


五、核心根因定位(最终真相)
所有代码改写、底层适配均无效,最终通过还原环境、清空缓存测试,定位到真正故障原因:
WordPress7.0升级后,W3 Total Cache缓存残留旧版Polylang翻译关系缓存。
缓存残留导致 pll_get_term() 函数读取缓存数据而非真实数据库数据,假性判定缺失的3个标签已存在英文翻译,直接跳过新增逻辑,造成脚本失效。
此故障与代码版本、WP底层API无关,纯粹是缓存残留导致的数据判定失真。


六、最终解决方案(零修改原版脚本,完美修复)
1. 前置修复操作
1. 通过阿里云RDS恢复数据库至WP7.0升级前的干净备份,还原所有错乱标签数据;
2. 登录WordPress后台 → 性能(W3 Total Cache)→ 仪表盘 → 清空所有缓存,彻底清除残留的翻译关系缓存、术语缓存;
3. 保留WP6.9原版可用脚本,不做任何代码修改。
2. 最终可用原版脚本(WP6.9/7.0通用)
polylang-batch-zh-to-en-tags.php

<?php
if (php_sapi_name() !== 'cli') {
    die("❌ 请在命令行运行\n");
}

require __DIR__ . '/wp-config.php';
global $wpdb, $polylang;

// 配置:一次处理多少个,你可以根据自己的服务器调整
$per_page = 1000; 
// 配置:源语言和目标语言,以后其他语言直接改这里就好
$source_lang = 'zh';
$target_lang = 'en';

echo "🚀 开始批量处理所有{$source_lang}标签,自动添加{$target_lang}翻译(分页模式)...\n\n";

$processed = 0;
$skipped = 0;
$offset = 0;

while (true) {
    // 分页拿源语言标签
    $terms = get_terms([
        'taxonomy' => 'post_tag',
        'lang' => $source_lang,
        'hide_empty' => false,
        'number' => $per_page,
        'offset' => $offset,
    ]);

    if (is_wp_error($terms) || empty($terms)) {
        break;
    }

    $current_count = count($terms);
    echo "📊 正在处理第 " . ($offset + 1) . " - " . ($offset + $current_count) . " 个标签...\n";

    foreach ($terms as $term) {
        $source_id = $term->term_id;
        $name = $term->name;
        $slug = $term->slug;

        // 检查是不是已经有目标语言的翻译了
        $target_id = pll_get_term($source_id, $target_lang);
        if ($target_id) {
            $skipped++;
            continue;
        }

        echo "🔰 正在处理: {$name} (ID: {$source_id})\n";

        // 创建目标语言标签,绕过slug重复检查
        $wpdb->insert($wpdb->terms, [
            'name' => $name,
            'slug' => $slug,
            'term_group' => 0
        ]);
        $new_target_id = $wpdb->insert_id;

        // 目标语言标签的taxonomy
        $wpdb->insert($wpdb->term_taxonomy, [
            'term_id'     => $new_target_id,
            'taxonomy'    => 'post_tag',
            'description' => '',
            'parent'      => 0,
            'count'       => 0
        ]);

        // 设置目标语言
        $polylang->model->term->set_language($new_target_id, $target_lang);

        // 绑定翻译
        $polylang->model->term->save_translations($source_id, [
            $target_lang => $new_target_id
        ]);

        $processed++;
    }

    $offset += $per_page;
    unset($terms);
    gc_collect_cycles();
}

echo "\n🎉 全部处理完成!\n";
echo "📊 统计:\n";
echo "   已处理新标签: {$processed}\n";
echo "   已跳过已有翻译: {$skipped}\n";
echo "\n✅ 所有标签都已经处理完毕,和手动添加的完全一样!\n";

3. 最终成功运行日志

[root@iZ23wv7v5ggZ www.shuijingwanwq.com]# php polylang-batch-zh-to-en-tags.php
🚀 开始批量处理所有zh标签,自动添加en翻译(分页模式)...

📊 正在处理第 1 - 1000 个标签...
🔰 正在处理: 360 (ID: 36603)
📊 正在处理第 1001 - 2000 个标签...
📊 正在处理第 2001 - 3000 个标签...
📊 正在处理第 3001 - 4000 个标签...
📊 正在处理第 4001 - 5000 个标签...
🔰 正在处理: Sitemap (ID: 36607)
📊 正在处理第 5001 - 6000 个标签...
📊 正在处理第 6001 - 7000 个标签...
📊 正在处理第 7001 - 8000 个标签...
🔰 正在处理: 站点地图 (ID: 36604)
📊 正在处理第 8001 - 8274 个标签...

🎉 全部处理完成!
📊 统计:
   已处理新标签: 3
   已跳过已有翻译: 8271

✅ 所有标签都已经处理完毕,和手动添加的完全一样!

七、最终修复结果
– 中文标签总数:8274 项(无增减,原始数据完整)
– 英文标签总数:8274 项(成功补齐3个缺失标签)
– 无无语言脏标签、无重复标签
– 中英标签1:1完美对齐,翻译关系正常绑定


八、总结与避坑经验
1. WP大版本升级后,优先清空全站缓存、插件缓存,再测试原有自定义脚本,不要盲目判定代码不兼容;
2. Polylang多语言站点,翻译关系、术语判定高度依赖缓存,缓存残留会导致函数假性判定异常;
3. 原版稳定运行的脚本,优先保留,不要盲目改写适配新版本,大部分“兼容故障”都是缓存导致;
4. 禁止在批量脚本中添加全库循环删除逻辑,大数据量下极易卡死、误删正常数据。

]]>
https://www.shuijingwanwq.com/2026/06/16/17171/feed/ 0
Yii2 Starter Kit 切换至中文语言环境后,编辑器未正常显示的解决 https://www.shuijingwanwq.com/2018/08/21/2851/ https://www.shuijingwanwq.com/2018/08/21/2851/#respond Tue, 21 Aug 2018 09:29:20 +0000 http://www.shuijingwanwq.com/?p=2851 Post Views: 96 1、当 Locale 的值设置为 English (US) 时,Create Article 时,编辑器正常显示,但是对应的语言包文件 /assets/5fbb6f5a/lang/en.js 响应 404,如图1
当 Locale 的值设置为 English (US) 时,Create Article 时,编辑器正常显示,但是对应的语言包文件 /assets/5fbb6f5a/lang/en.js 响应 404

图1

2、当 本地 的值设置为 简体中文 时,创建文章 时,编辑器未正常显示,如图2
当 本地 的值设置为 简体中文 时,创建文章 时,编辑器未正常显示

图2

3、刷新页面,查看浏览器 Console,发现原因在于对应的语言文件 /assets/5fbb6f5a/lang/zh.js 不存在,进而导致 Uncaught TypeError: Cannot read property ‘html’ of undefined,如图3
刷新页面,查看浏览器 Console,发现原因在于对应的语言文件 /assets/5fbb6f5a/lang/zh.js  不存在,进而导致 Uncaught TypeError: Cannot read property 'html' of undefined

图3

4、打开网址:http://backend.yii2-starter-kit.terentev.net/content/article/create ,发现官方示例仍然存在此 Bug,如图4
打开网址:http://backend.yii2-starter-kit.terentev.net/content/article/create ,发现官方示例仍然存在此 Bug

图4

5、查看 \backend\views\article\_form.php,编辑器代码如下,其基于 asofter/yii2-imperavi-redactor
<pre class="wp-block-syntaxhighlighter-code">

    <?php echo $form->field($model, 'body')->widget(
        \yii\imperavi\Widget::className(),
        [
            'plugins' => ['fullscreen', 'fontcolor', 'video'],
            'options' => [
                'minHeight' => 400,
                'maxHeight' => 400,
                'buttonSource' => true,
                'convertDivs' => false,
                'removeEmptyTags' => false,
                'imageUpload' => Yii::$app->urlManager->createUrl(['/file-storage/upload-imperavi'])
            ]
        ]
    ) ?>

</pre>
7、打开网址:https://imperavi.com/download/redactor/langs/en/ ,下载 en.js,复制至 \vendor\asofter\yii2-imperavi-redactor\yii\imperavi\assets\lang\en.js,以解决 /assets/5fbb6f5a/lang/en.js 响应 404的问题。注:如果 \vendor 未放在版本控制中,则建议将 en.js 放入版本控制中,在执行 composer install 后,自动复制至 \vendor\asofter\yii2-imperavi-redactor\yii\imperavi\assets\lang\en.js。刷新页面,/assets/5fbb6f5a/lang/en.js 响应200,如图6
打开网址:https://imperavi.com/download/redactor/langs/en/ ,下载 en.js,复制至 \vendor\asofter\yii2-imperavi-redactor\yii\imperavi\assets\lang\en.js,以解决 /assets/5fbb6f5a/lang/en.js 响应 404的问题。注:如果 \vendor 未放在版本控制中,则建议将 en.js 放入版本控制中,在执行 composer install 后,自动复制至 \vendor\asofter\yii2-imperavi-redactor\yii\imperavi\assets\lang\en.js。刷新页面,/assets/5fbb6f5a/lang/en.js 响应200

图6

8、打开网址:https://imperavi.com/download/redactor/langs/zh/ ,下载失败,决定基于当前语言环境手动定义编辑器的语言选项,以确保可以正确寻找到对应的语言包文件,进而解决编辑器显示的问题,编辑 \backend\views\article\_form.php
<pre class="wp-block-syntaxhighlighter-code">

    <?php
        /* 基于本地语言环境手动定义编辑器的语言选项 */
        switch (Yii::$app->language) {
            case 'en-US':
                $lang = 'en';
                break;
            case 'ru-RU':
                $lang = 'ru';
                break;
            case 'uk-UA':
                $lang = 'uk';
                break;
            case 'es':
                $lang = 'es';
                break;
            case 'vi':
                $lang = 'vi';
                break;
            case 'zh-CN':
                $lang = 'zh_cn';
                break;
            case 'pl-PL':
                $lang = 'pl';
                break;
            default:
                $lang = 'en';
        }
    ?>

    <?php echo $form->field($model, 'body')->widget(
        \yii\imperavi\Widget::className(),
        [
            'plugins' => ['fullscreen', 'fontcolor', 'video'],
            'options' => [
                'lang' => $lang,
                'minHeight' => 400,
                'maxHeight' => 400,
                'buttonSource' => true,
                'convertDivs' => false,
                'removeEmptyTags' => false,
                'imageUpload' => Yii::$app->urlManager->createUrl(['/file-storage/upload-imperavi'])
            ]
        ]
    ) ?>

</pre>
9、当 本地 的值设置为 简体中文 时,创建文章 时,编辑器正常显示,如图7
当 本地 的值设置为 简体中文 时,创建文章 时,编辑器正常显示

图7

]]>
https://www.shuijingwanwq.com/2018/08/21/2851/feed/ 0