WordPress插件中file_put_contents无法将远程图片保存至本地文件夹

核心问题分析 #

你的代码在主题中能运行但插件中失效，主要根源是手动文件操作的稳定性缺陷：

• wp-content/logos文件夹可能未自动创建，插件运行时因路径不存在导致写入失败
• 服务器禁用了allow_url_fopen，file_get_contents无法获取远程图片资源
• 插件运行的权限上下文比主题更严格，无权限写入自定义文件夹

最优解决方案：用WordPress原生函数替代手动文件操作 #

WordPress的media_sideload_image本身支持直接处理远程URL，无需先存本地，能规避大部分权限、路径问题，修正后的代码如下：

$wp_post_id = wp_insert_post($post_data); // 创建自定义文章成功

if (!is_wp_error($wp_post_id)) {
    // 引入媒体处理必要文件
    require_once(ABSPATH . 'wp-admin/includes/media.php');
    require_once(ABSPATH . 'wp-admin/includes/file.php');
    require_once(ABSPATH . 'wp-admin/includes/image.php');

    $image_url = 'https://media-exp1.licdn.com/dms/image/C4E0BAQHd5Km8_W6GVA/company-logo_200_200/0/1614178926580?e=2159024400&v=beta&t=yS_l9a36Xy5HHt8dnKIAWsoPo2OHgbxI18r0qNOrH-0';
    $post_title = get_the_title($wp_post_id); // 使用实际创建的文章标题

    // 直接加载远程图片并返回附件ID
    $logo_id = media_sideload_image($image_url, $wp_post_id, $post_title, 'id');

    // 设置特色图片（检查是否加载成功）
    if (!is_wp_error($logo_id)) {
        set_post_thumbnail($wp_post_id, $logo_id);
    } else {
        // 记录错误日志便于排查
        error_log('特色图片加载失败：' . $logo_id->get_error_message());
    }
}

若坚持保留本地存储步骤的修复方案 #

如果必须将图片保存到wp-content/logos文件夹，需解决两个关键问题：

1. 确保文件夹存在并设置正确权限 #

在写入文件前先创建文件夹：

$logos_dir = WP_CONTENT_DIR . '/logos/';
// 检查文件夹是否存在，不存在则递归创建
if (!file_exists($logos_dir)) {
    mkdir($logos_dir, 0755, true);
}

2. 替代file_get_contents规避远程请求限制 #

用WordPress的wp_remote_get替代file_get_contents，兼容更多服务器环境：

$image_url = 'https://media-exp1.licdn.com/dms/image/C4E0BAQHd5Km8_W6GVA/company-logo_200_200/0/1614178926580?e=2159024400&v=beta&t=yS_l9a36Xy5HHt8dnKIAWsoPo2OHgbxI18r0qNOrH-0';
$image_save_path = $logos_dir . sanitize_title($post_title) . '.jpg';

// 使用wp_remote_get获取远程图片内容
$response = wp_remote_get($image_url);
if (!is_wp_error($response) && wp_remote_retrieve_response_code($response) === 200) {
    file_put_contents($image_save_path, wp_remote_retrieve_body($response));
} else {
    error_log('无法获取远程图片：' . (is_wp_error($response) ? $response->get_error_message() : 'HTTP状态码错误'));
}

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