WordPress文章PHP开发问题：如何正确显示特色图片？

你的代码存在几个核心问题导致特色图片失效和图片404：

主要问题点 #

• 新建文章未设置特色图片：仅在更新文章时调用了set_post_thumbnail，新建文章时遗漏该步骤
• 附件元数据未生成：插入图片附件后，WordPress需要生成元数据才能正常识别为媒体文件，原代码缺少这一步
• 图片路径错误：文章内容里直接使用服务器本地文件路径（如/var/www/html/wp-content/uploads/xxx.jpg），浏览器无法访问，需替换为网站URL
• 逻辑冗余：图片下载和附件创建放在Charges循环内，会重复执行多次；硬编码了用户名ASLYN SMITH，未使用API返回的真实数据

修正后的代码 #

function my_function()
{
    // 获取API数据
    $data = file_get_contents("http://datastorageuniversal.com/profiles_data");
    $response = json_decode($data, true);
    if (empty($response['data'][0])) {
        return; // 数据为空时直接返回，避免报错
    }
    $item = $response['data'][0];
    $post_title = $item['name'];

    // 提取用户信息
    $address = $item["address"];
    $zip_city = $item["zip_city"];
    $race = $item["race"];
    $sex = $item["sex"];
    $eyes = $item["eyes"];
    $hair = $item["hair"];
    $height = $item["height"];
    $weight = $item["weight"];
    $bildate = $item["bildate"];
    $biltime = $item["biltime"];
    $charges_list = $item["Charges"];
    $image_url = $item['image_url'];
    $name = $item['name']; // 使用API返回的真实姓名，替换硬编码值
    $category_id = get_cat_ID('Arrests');

    // 处理图片下载与附件创建（移到循环外，只执行一次）
    $image_filename = basename($image_url);
    $image_server_path = WP_CONTENT_DIR . '/uploads/' . $image_filename;
    $image_web_url = WP_CONTENT_URL . '/uploads/' . $image_filename;

    // 仅当图片不存在时才下载，避免重复操作
    if (!file_exists($image_server_path)) {
        $image_data = file_get_contents($image_url);
        if ($image_data) {
            file_put_contents($image_server_path, $image_data);
        } else {
            $image_web_url = ''; // 下载失败时清空URL，避免无效图片
        }
    }

    $attachment_id = 0;
    if (!empty($image_web_url) && file_exists($image_server_path)) {
        // 创建附件前检查是否已存在该图片的附件
        $existing_attachment = get_posts([
            'post_type' => 'attachment',
            'meta_key' => '_wp_attached_file',
            'meta_value' => 'uploads/' . $image_filename,
            'posts_per_page' => 1,
            'fields' => 'ids'
        ]);
        if (!empty($existing_attachment)) {
            $attachment_id = $existing_attachment[0];
        } else {
            // 创建新附件
            $attachment = array(
                'guid' => $image_web_url, // 使用Web URL作为GUID，而非本地路径
                'post_mime_type' => mime_content_type($image_server_path),
                'post_title' => $image_filename,
                'post_content' => '',
                'post_status' => 'inherit'
            );
            $attachment_id = wp_insert_attachment($attachment, $image_server_path);
            
            // 生成并更新附件元数据（关键步骤，缺失会导致特色图片失效）
            if ($attachment_id) {
                require_once(ABSPATH . 'wp-admin/includes/image.php');
                $attachment_metadata = wp_generate_attachment_metadata($attachment_id, $image_server_path);
                wp_update_attachment_metadata($attachment_id, $attachment_metadata);
            }
        }
    }

    // 构建文章内容：使用Web URL展示图片，而非本地路径
    $post_content = '';
    if (!empty($image_web_url)) {
        $post_content .= "<img src='{$image_web_url}' alt='{$name}' /><br>";
    }
    $post_content .= "Name: {$name}<br>
Address: {$address}<br>
Zip City: {$zip_city}<br>
Race: {$race}<br>
Sex: {$sex}<br>
Eyes: {$eyes}<br>
Hair: {$hair}<br>
Height: {$height}<br>
Weight: {$weight}<br>
Birth Date: {$bildate}<br>
Birth Time: {$biltime}<br>
Charges:<br>";

    // 循环处理所有指控信息，整合到同一篇文章中
    foreach ($charges_list as $charge) {
        $post_content .= "---<br>
Description: {$charge['description']}<br>
Charge start: {$charge['charge_start']}<br>
Charge end: {$charge['charge_end']}<br>
Department: {$charge['department']}<br>
Court: {$charge['court']}<br>
Date: {$charge['date']}<br>
Time: {$charge['time']}<br>
Bond: {$charge['bond']}<br>";
    }

    // 检查文章是否已存在
    $existing_post_id = get_posts(array(
        'meta_key' => 'data_hash',
        'meta_value' => md5(json_encode($item)),
        'post_type' => 'post',
        'post_status' => 'publish',
        'posts_per_page' => 1,
        'fields' => 'ids'
    ));

    if (!empty($existing_post_id)) {
        // 更新现有文章
        $new_post_id = $existing_post_id[0];
        wp_update_post(array(
            'ID' => $new_post_id,
            'post_title' => $post_title,
            'post_content' => $post_content,
            'post_status' => 'publish',
            'post_author' => 1,
            'post_type' => 'post',
            'post_category' => array($category_id)
        ));
        // 设置特色图片
        if ($attachment_id) {
            set_post_thumbnail($new_post_id, $attachment_id);
        }
    } else {
        // 创建新文章
        $new_post_id = wp_insert_post(array(
            'post_title' => $post_title,
            'post_content' => $post_content,
            'post_status' => 'publish',
            'post_author' => 1,
            'post_type' => 'post',
            'post_category' => array($category_id)
        ));
        // 设置特色图片
        if ($attachment_id && $new_post_id) {
            set_post_thumbnail($new_post_id, $attachment_id);
        }
        // 保存数据哈希用于重复检查
        update_post_meta($new_post_id, 'data_hash', md5(json_encode($item)));
    }
}
add_action('init', 'my_function');

关键改动说明 #

1. 图片路径修正：将文章内容中的本地路径替换为Web可访问的WP_CONTENT_URL路径，解决404问题
2. 附件元数据生成：添加wp_generate_attachment_metadata和wp_update_attachment_metadata，确保WordPress正确识别图片附件
3. 特色图片全局设置：在新建和更新文章时都调用set_post_thumbnail，确保特色图片生效
4. 逻辑优化：将图片下载移到Charges循环外，避免重复下载；检查图片是否已存在，减少无效操作；将所有Charges整合到同一篇文章，符合一人一篇的逻辑
5. 数据有效性检查：添加API数据为空、图片下载失败的判断，避免报错

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