WordPress插件开发：如何批量替换所有文章中的非WebP图片为WebP

核心逻辑 #

先批量将所有非WebP格式的图片转换为WebP，再遍历全站文章内容，把旧图片的URL批量替换为对应的WebP版本URL。

具体实现步骤 #

1. 批量生成WebP图片（基于你已有的转换函数） #

假设你的转换函数是convert_to_webp($file_path)，可以通过遍历WordPress上传目录批量处理所有符合条件的图片：

function batch_convert_images_to_webp() {
    $upload_dir = wp_upload_dir();
    $base_dir = $upload_dir['basedir'];
    
    // 递归遍历上传目录下的所有文件
    $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($base_dir));
    
    foreach ($iterator as $file) {
        if ($file->isFile()) {
            $ext = strtolower($file->getExtension());
            // 只处理非WebP的常见图片格式，且跳过已生成的WebP文件
            if (in_array($ext, ['jpg', 'jpeg', 'png', 'gif']) && !str_contains($file->getFilename(), '.webp')) {
                $file_path = $file->getPathname();
                // 调用你的转换函数生成对应WebP文件
                convert_to_webp($file_path);
            }
        }
    }
}

2. 批量替换文章内容中的旧图片URL #

遍历所有已发布的文章、页面（可扩展到自定义文章类型），替换内容里的图片链接：

function replace_old_images_with_webp() {
    // 查询所有目标内容，仅获取ID提升处理效率
    $args = [
        'post_type' => ['post', 'page'],
        'post_status' => 'publish',
        'posts_per_page' => -1,
        'fields' => 'ids'
    ];
    
    $posts = get_posts($args);
    
    foreach ($posts as $post_id) {
        $content = get_post_field('post_content', $post_id);
        if (empty($content)) continue;
        
        // 匹配图片标签中的旧格式图片URL，替换为WebP版本
        $pattern = '/(<img[^>]+src=")([^"]+\.(jpg|jpeg|png|gif))("[^>]*>)/i';
        $replacement = '$1$2.webp$4';
        
        $new_content = preg_replace($pattern, $replacement, $content);
        
        // 仅当内容有变化时更新，避免无效数据库操作
        if ($new_content !== $content) {
            wp_update_post([
                'ID' => $post_id,
                'post_content' => $new_content
            ]);
        }
    }
}

3. 关键注意事项 #

• 必须备份数据库：批量修改文章内容前一定要备份全库，避免出错无法回滚。
• 处理缩略图变体：WordPress会生成多尺寸缩略图，要确保这些变体也被转换并替换对应URL。
• 自定义字段兼容：如果文章在自定义字段中存储了图片URL，需要额外遍历自定义字段执行替换逻辑。
• 大站点分批次处理：如果站点文章量极大，建议分批次处理避免超时：

function replace_images_in_batches($batch_size = 50) {
    $offset = 0;
    while (true) {
        $args = [
            'post_type' => ['post', 'page'],
            'post_status' => 'publish',
            'posts_per_page' => $batch_size,
            'offset' => $offset,
            'fields' => 'ids'
        ];
        $posts = get_posts($args);
        if (empty($posts)) break;
        
        foreach ($posts as $post_id) {
            // 复用上面的替换逻辑
            $content = get_post_field('post_content', $post_id);
            if (empty($content)) continue;
            
            $pattern = '/(<img[^>]+src=")([^"]+\.(jpg|jpeg|png|gif))("[^>]*>)/i';
            $replacement = '$1$2.webp$4';
            $new_content = preg_replace($pattern, $replacement, $content);
            
            if ($new_content !== $content) {
                wp_update_post(['ID' => $post_id, 'post_content' => $new_content]);
            }
        }
        $offset += $batch_size;
        sleep(1); // 暂停1秒降低服务器负载
    }
}

4. 触发方式 #

推荐通过WP-CLI命令触发，或者在插件后台添加一个手动触发按钮（避免插件激活时直接执行大量操作导致超时）：

// 示例：添加后台工具页面
add_action('admin_menu', function() {
    add_management_page(
        'WebP图片替换工具',
        'WebP图片替换',
        'manage_options',
        'webp-image-replacer',
        function() {
            if (isset($_POST['run_replacement'])) {
                // 执行替换逻辑
                replace_old_images_with_webp();
                echo '<div class="updated"><p>图片替换完成！</p></div>';
            }
            ?>
            <div class="wrap">
                <h1>WebP图片批量替换</h1>
                <form method="post">
                    <?php submit_button('开始替换旧图片为WebP', 'primary', 'run_replacement'); ?>
                </form>
            </div>
            <?php
        }
    );
});

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