如何在WordPress中通过REST API生成多尺寸图片并写入元数据

你现在的代码确实能把图片上传到服务器，但只存了原图，没触发WordPress内置的多尺寸图片生成机制——这就是为什么后台上传能自动生成各种缩略图，而你的代码不行的原因。其实只需要调用WordPress的核心函数就能解决，我帮你把代码修改并解释清楚：

关键问题分析 #

WordPress后台上传图片时，会自动调用wp_generate_attachment_metadata()函数，这个函数会根据你主题设置的所有图片尺寸（包括默认的thumbnail、medium，还有你示例里的slider、real_estate_lite_*这类自定义尺寸）生成对应的缩略图，同时生成完整的元数据结构，最后序列化存储到postmeta表的_wp_attachment_metadata字段里。你的代码刚好缺了这一步。

修改后的完整代码 #

// 修正原代码变量名笔误，统一为$featured_images
$featured_images = [
    "https://media.architecturaldigest.com/photos/585811cfdcb583e908275f46/4:3/w_384/buildings-with-trees-001.jpg",
    "https://media.architecturaldigest.com/photos/585811cfdcb583e908275f46/4:3/w_384/buildings-with-trees-001.jpg"
];
$count_img = 0;
$attached_ids = []; // 存储生成的附件ID

// 加载WordPress图片处理核心函数（REST环境下默认未自动加载）
require_once(ABSPATH . 'wp-admin/includes/image.php');

foreach($featured_images as $url) {
    // 解析图片路径与文件名
    $path = parse_url($url, PHP_URL_PATH);
    $filename = mt_rand() . basename($path);
    $uploaddir = wp_upload_dir();
    $uploadfile = $uploaddir['path'] . '/' . $filename;

    // 用WordPress原生函数获取远程文件，兼容性更强
    $response = wp_remote_get($url);
    if(is_wp_error($response)) {
        continue; // 获取失败则跳过当前图片
    }
    $contents = wp_remote_retrieve_body($response);

    // 保存图片到服务器
    $savefile = fopen($uploadfile, 'w');
    fwrite($savefile, $contents);
    fclose($savefile);
    chmod($uploadfile, 0644); // 设置更安全的文件权限，避免过度开放

    // 检测文件MIME类型
    $wp_filetype = wp_check_filetype(basename($filename), null );

    // 准备附件基础数据
    $attachment = array(
        'post_mime_type' => $wp_filetype['type'],
        'post_title'     => sanitize_file_name($filename), // 对文件名做安全处理
        'post_content'   => '',
        'post_status'    => 'inherit',
        'post_parent'    => $new_post_id,
    );

    // 将图片插入媒体库，生成附件ID
    $attach_id = wp_insert_attachment( $attachment, $uploadfile, $new_post_id );

    if($attach_id) {
        // 核心步骤：生成所有预设尺寸的缩略图与完整元数据
        $metadata = wp_generate_attachment_metadata($attach_id, $uploadfile);
        // 更新附件元数据，WordPress会自动序列化后存入postmeta表
        wp_update_attachment_metadata($attach_id, $metadata);

        // 将第一张图片设为文章特色图片
        if($count_img === 0) {
            set_post_thumbnail( $new_post_id, $attach_id );
        }

        $attached_ids[] = $attach_id;
        $count_img++;
    }
}

// 将附件ID列表存入自定义字段
if(!empty($attached_ids)) {
    $format_featured_img = implode('|', $attached_ids);
    update_post_meta($new_post_id, 'real_estate_property_images', $format_featured_img);
}

关键改动说明 #

1. 加载核心处理函数：添加require_once(ABSPATH . 'wp-admin/includes/image.php');，因为REST API环境下不会自动加载后台的图片处理类，必须手动引入才能调用生成缩略图的核心函数。
2. 优化远程文件获取：用wp_remote_get()替代file_get_contents()，更符合WordPress规范，也能避免部分服务器禁用allow_url_fopen的问题。
3. 自动生成多尺寸图片：调用wp_generate_attachment_metadata()后，会自动完成：
   • 生成所有WordPress预设和主题自定义的图片尺寸
   • 在uploads目录创建对应的缩略图文件
   • 生成和你示例完全一致的元数据结构（包含width、height、sizes、image_meta等字段）
4. 正确存储元数据：wp_update_attachment_metadata()会自动把生成的元数据序列化后，存入postmeta表的_wp_attachment_metadata字段，和后台上传的效果完全一致。
5. 代码细节优化：修正了原代码的变量名笔误，调整了文件权限为更安全的0644，添加了错误处理逻辑跳过获取失败的图片。

这样修改后，你的代码就能像后台媒体库上传一样，自动生成所有需要的图片尺寸，并且元数据也会正确序列化存储啦。

内容的提问来源于stack exchange，提问作者Ali Akbar