首页  杂七杂八  正文

WordPress批量更换图片地址脚本开发指南

2025.5.30 33blog 杂七杂八 1547

本文详细介绍如何通过SQL脚本和PHP函数批量替换WordPress中的图片地址，包含数据库直接操作和WP-CLI两种方案，并提供安全备份建议和性能优化技巧，帮助站长高效完成媒体URL迁移工作。

一、为什么需要批量更换图片地址

在WordPress运营过程中，可能遇到以下典型场景：

域名变更（http→https或更换主域名）
CDN服务接入需要替换原始URL
媒体文件迁移到新存储位置
多站点合并时的路径调整

手动修改每张图片既不现实也不高效，开发自动化脚本才是专业解决方案。

二、数据库直接替换方案

通过MySQL的REPLACE()函数可快速完成内容替换，建议操作前备份数据库：

UPDATE wp_posts 
SET post_content = REPLACE(
    post_content,
    '旧图片地址',
    '新图片地址'
) 
WHERE post_content LIKE '%旧图片地址%';

进阶版多表替换脚本（包含文章元数据和文章修订版）：

START TRANSACTION;
UPDATE wp_posts SET post_content = REPLACE(post_content, 'http://', 'https://');
UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'http://', 'https://') WHERE meta_key = '_wp_attached_file';
UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'http://', 'https://') WHERE meta_key = '_wp_attachment_metadata';
COMMIT;

三、PHP函数方案（更安全）

通过WordPress的wpdb类执行替换，避免SQL注入风险：

function batch_replace_image_urls() {
    global $wpdb;
    
    $old_url = 'http://旧地址/';
    $new_url = 'https://新地址/';
    
    // 替换文章内容
    $wpdb->query(
        $wpdb->prepare(
            "UPDATE {$wpdb->posts} 
            SET post_content = REPLACE(post_content, %s, %s)",
            $old_url, $new_url
        )
    );
    
    // 替换Gutenberg区块数据
    $wpdb->query(
        $wpdb->prepare(
            "UPDATE {$wpdb->postmeta} 
            SET meta_value = REPLACE(meta_value, %s, %s) 
            WHERE meta_key = '_blocks'",
            $old_url, $new_url
        )
    );
    
    return '替换完成，共影响'.$wpdb->rows_affected.'条记录';
}

四、WP-CLI高级方案

服务器安装WP-CLI后，可创建自定义命令：

!/usr/bin/env wp-cli

WP_CLI::add_command('media replace-urls', function($args, $assoc_args){
    $old = $assoc_args['old'];
    $new = $assoc_args['new'];
    
    $tables = ['posts', 'postmeta', 'options'];
    foreach($tables as $table) {
        WP_CLI::runcommand("db query "UPDATE {$wpdb->$table} SET [...]"");
    }
    
    WP_CLI::success("已替换所有{$old}实例");
});