从第三方URL导入图片至WordPress媒体库且不存本地的Hook方案

要把第三方图片URL添加到WordPress媒体库但不保存到本地服务器，核心是绕过WordPress默认的图片下载逻辑，直接在媒体库创建对应条目并映射远程URL。以下是可行的代码实现方案：

1. 自定义函数插入远程图片到媒体库 #

将以下代码添加到主题的functions.php文件中，该函数会直接在媒体库创建条目，不会下载图片到本地：

function add_remote_image_to_media_library($remote_url, $post_id = 0) {
    // 获取远程图片的MIME类型和尺寸
    $headers = get_headers($remote_url, 1);
    $mime_type = $headers['Content-Type'];
    list($width, $height) = getimagesize($remote_url);

    // 提取图片文件名
    $filename = basename($remote_url);

    // 准备附件数据
    $attachment_data = array(
        'post_title'     => sanitize_file_name($filename),
        'post_content'   => '',
        'post_status'    => 'inherit',
        'post_mime_type' => $mime_type,
        'guid'           => $remote_url // 直接使用远程URL作为guid
    );

    // 插入附件
    $attachment_id = wp_insert_attachment($attachment_data, '', $post_id);

    if (!is_wp_error($attachment_id)) {
        // 生成自定义元数据，避免WordPress尝试下载图片
        $metadata = array(
            'width'  => $width,
            'height' => $height,
            'file'   => $filename,
            'sizes'  => array(
                'thumbnail' => array(
                    'file'      => $filename,
                    'width'     => get_option('thumbnail_size_w'),
                    'height'    => get_option('thumbnail_size_h'),
                    'mime-type' => $mime_type
                ),
                'medium' => array(
                    'file'      => $filename,
                    'width'     => get_option('medium_size_w'),
                    'height'    => get_option('medium_size_h'),
                    'mime-type' => $mime_type
                ),
                'large' => array(
                    'file'      => $filename,
                    'width'     => get_option('large_size_w'),
                    'height'    => get_option('large_size_h'),
                    'mime-type' => $mime_type
                )
            )
        );

        // 更新附件元数据
        wp_update_attachment_metadata($attachment_id, $metadata);

        return $attachment_id;
    }

    return false;
}

2. 拦截媒体图片源获取，强制返回远程URL #

添加以下钩子，确保WordPress调用wp_get_attachment_image_src时返回的是第三方URL，而非本地路径：

add_filter('wp_get_attachment_image_src', 'override_attachment_image_src', 10, 4);
function override_attachment_image_src($image, $attachment_id, $size, $icon) {
    $attachment = get_post($attachment_id);
    // 检查guid是否为远程URL（非本地路径）
    if (strpos($attachment->guid, 'http') === 0) {
        $image[0] = $attachment->guid;
    }
    return $image;
}

3. 使用方法 #

你可以通过以下方式调用自定义函数批量添加远程图片：

// 示例：添加单个远程图片
$remote_image_url = 'https://example.com/product-image.jpg';
$attachment_id = add_remote_image_to_media_library($remote_image_url);

// 示例：批量添加
$remote_images = array(
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg'
);
foreach ($remote_images as $url) {
    add_remote_image_to_media_library($url);
}

注意事项 #

• 确保服务器开启了allow_url_fopen，否则getimagesize和get_headers无法获取远程图片信息；如果无法开启，可以改用cURL实现这部分逻辑。
• 部分WordPress插件（如媒体优化类）可能会修改媒体库行为，需要测试兼容性。
• 远程图片需确保可公开访问，否则前端加载会失败。

内容的提问来源于stack exchange，提问作者piyush marothi