wordpress获取文章特色图像路径函数wp_get_attachment_image_src()

Posted 2021-01-27 xiaobingch

特色图像是wordpress主要的文章缩略图功能，几乎全部wordpress模板都使用或支持特色图像。今天介绍的wp_get_attachment_image_src()函数就是获取文章特色图像路径的wordpress函数，通过该函数可以返回一个包含图片路径、宽度和高度的有序数组。

函数结构：

<?php wp_get_attachment_image_src( $attachment_id, $size, $icon ); ?>

 

返回值：

Array
(
    [0] => url //图片地址
    [1] => width //图片宽度
    [2] => height //图片高度
    [3] =>  boolean //true表示返回了缩放后的图片，false表示返回了原始图片
)

 

参数说明：

$attachment_id – 数值，必需，想要获取信息的附件ID，默认值：None

$size – 字符串，获取指定尺寸的图像，默认值:None，可选thumbnail, medium, large or full（对应后台——设置——多媒体的图像大小 ，full表示原始尺寸），或通过array(300,240)自定义图片大小。需要注意的是WordPress 2.5 以前的版本是没有 $size 参数的，只显示原始尺寸。

$icon – 布尔，可选，是否使用媒体图标来表示当前附件，比如：如果要获取的附件不是一张图片，而是，比如说视频，让$icon为真可以返回代表视频（mime type：video）的图标，否则只能返回空值。这些代表不同mime type的图片在wp-includes/images/crystal目录下

示例：

1、获取文章缩略图url地址：

<?php 
$getThumbnail = wp_get_attachment_image_src( get_post_thumbnail_id(get_the_ID()),full);
echo $getThumbnail[0];
?>

 

2、官方示例：

<?php 
    $attachment_id = 8; // 附件ID     
    $image_attributes = wp_get_attachment_image_src( $attachment_id ); // 返回一个数组
    if( $image_attributes ) {
?> 
    <img src="<?php echo $image_attributes[0]; ?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>">
<?php } ?

 

函数位置：

wp_get_attachment_image_src()位于wp-includes/media.php