WordPress中如何获取文章的特色图像及附件媒体资源

在WordPress站点开发中，获取文章的特色图像和关联的附件媒体资源是主题定制、功能开发的常见需求，无论是展示文章列表的缩略图，还是调用文章内上传的附件文件，都需要用到对应的WordPress内置函数来实现。

获取文章特色图像的方法

WordPress的特色图像是文章单独设置的主图，获取前需要先确认当前主题已经支持特色图像功能，若未开启可以在主题的functions.php文件中添加以下代码开启：

// 开启主题特色图像支持
add_theme_support('post-thumbnails');

获取特色图像ID

使用get_post_thumbnail_id函数可以获取当前文章的特色图像附件ID，函数接收一个参数即文章ID，不传参数时默认获取当前循环中的文章ID：

// 获取当前文章的特色图像ID
$post_id = get_the_ID(); // 获取当前文章ID
$thumb_id = get_post_thumbnail_id($post_id);
// 若没有设置特色图像，返回false
if($thumb_id){
    echo '特色图像ID：' . $thumb_id;
}

获取特色图像地址和尺寸

拿到特色图像ID后，使用wp_get_attachment_image_src函数可以获取图片的地址、宽度、高度信息，该函数第一个参数是附件ID，第二个参数是图片尺寸，可选值包括thumbnail、medium、large、full，也可以传自定义尺寸的名称：

$thumb_id = get_post_thumbnail_id(get_the_ID());
if($thumb_id){
    // 获取中等尺寸的图片信息
    $img_info = wp_get_attachment_image_src($thumb_id, 'medium');
    // $img_info是数组，索引0是图片地址，1是宽度，2是高度，3是否是裁剪的尺寸
    echo '图片地址：' . $img_info[0];
    echo '图片宽度：' . $img_info[1];
    echo '图片高度：' . $img_info[2];
}

直接获取特色图像标签

如果不需要单独处理图片地址，直接使用get_the_post_thumbnail函数可以获取完整的<img>标签，该函数支持传入文章ID、图片尺寸、属性数组三个参数：

// 获取当前文章的中等尺寸特色图像，添加自定义class
$img_tag = get_the_post_thumbnail(get_the_ID(), 'medium', array('class' => 'post-thumb'));
echo $img_tag;

获取文章的附件媒体资源

文章的附件媒体资源是指上传到该文章下的所有文件，包括图片、文档、视频等，获取这些资源需要使用get_posts函数查询附件类型的文章：

获取所有附件列表

以下代码可以获取指定文章下的所有附件，排除特色图像（如果需要包含特色图像可以去掉后面的过滤逻辑）：

$post_id = get_the_ID();
// 查询当前文章的所有附件
$attachments = get_posts(array(
    'post_type' => 'attachment',
    'post_parent' => $post_id,
    'post_status' => 'inherit',
    'posts_per_page' => -1 // 获取所有附件，不分页
));
if($attachments){
    echo '<ul>';
    foreach($attachments as $attachment){
        $attach_id = $attachment->ID;
        $attach_url = wp_get_attachment_url($attach_id); // 获取附件原始地址
        $attach_title = get_the_title($attach_id); // 获取附件标题
        echo '<li>' . $attach_title . '：' . $attach_url . '</li>';
    }
    echo '</ul>';
}

筛选特定类型的附件

如果只需要获取图片类型的附件，可以在查询参数中添加post_mime_type参数，比如只获取jpg和png图片：

$attachments = get_posts(array(
    'post_type' => 'attachment',
    'post_parent' => get_the_ID(),
    'post_status' => 'inherit',
    'post_mime_type' => array('image/jpeg', 'image/png'), // 指定图片类型
    'posts_per_page' => -1
));

常见注意事项

• 获取特色图像前必须确认主题已经开启post-thumbnails支持，否则函数会返回空值
• wp_get_attachment_image_src函数如果传入的尺寸不存在，会默认返回原始图片的信息
• 如果文章没有设置特色图像，get_post_thumbnail_id会返回false，使用前需要做好非空判断避免报错
• 获取附件时如果文章没有上传过任何附件，get_posts会返回空数组，需要做好判断再遍历

WordPress特色图像附件媒体资源get_post_thumbnail_idwp_get_attachment_image_src修改时间：2026-07-05 14:48:24