> WordPress中文手册 > wordpress获取自定义字段值函数:get_post_meta()

【描述】
该函数返回指定文章中含有指定关键字自定义字段的值

【用法】

<?PHP $meta_values = get_post_meta($post_id, $key, $single); ?>

【参数】
$post_id

(整数)(必需)希望从中得到数据的文章的编号。用$post->ID获取文章编号。

默认值:None

$key

(字符)(必需)字符,字符中含有希望的meta值的名称。

默认值:None

$single

(布尔值)(可选)如果默认值设为true,函数返回单个字符形式的结果。如果为false或为设置,则函数返回自定义字段的数组。

默认值:false

【返回的值】

若$single设为false或空,函数返回一个包含指定关键字的所有值的数组
若$single设为true,函数返回指定关键字的第一个值(不是数组)
无论$single值是什么,如果没有指定关键字,函数将返回空的字符。
【示例】
先在后台添加自定义字段:
wordpress获取自定义字段值函数:get_post_meta()
以下代码可用于index.php进行测试

 if (have_posts()) ://如果有文章
 while (have_posts()) : the_post(); //开启主循环
   $xzmeta  = get_post_meta(get_the_ID(),'xzmeta',true);
 endwhile; 
 endif;

如果没有设置”xzmeta”这个自定义字段的话,$xzmeta 会是false
如果有设置,则返回设置的值。
如果第三个参数设置为false,则返回数组,且相同键值的自定义字段的值会按照添加顺序组合成一个序列数组。
如果只设置$postid参数,那将返回所有的自定义字段值。用法类似于使用get_post_custom()函数
【源代码】

get_post_meta() 位于 wp-includes/post.php