描述
文章meta字段尽可能从缓存中检索,因此该函数被优化为可多次调用。
参数
- $post_id
-
(int) (可选) 文章 ID,默认为全局
$post
的ID。
返回
(mixed) 一个数组值。对于无效的$post_id
(非数字、零值或负值),为False。如果传递了有效但不存在的post ID,则为空字符串。
说明
源码
更新日志
版本 | 描述 |
---|---|
1.2.0 | 开始引入 |
使用示例
默认用法使用以下示例将变量($custom_fields)赋值为包含当前文章所有自定义字段的多维数组。
<?php $custom_fields = get_post_custom(); ?>
从数组中检索数据以下示例将使用文章 ID 72中的 my_custom_field 键名检索所有自定义字段值(假设有三个自定义字段使用此键,值分别为“dogs”、“47”和“this is other value”)。
<?php $custom_fields = get_post_custom(72); $my_custom_field = $custom_fields['my_custom_field']; foreach ( $my_custom_field as $key => $value ) { echo $key . " => " . $value . "<br />"; } ?>
0 => dogs
1 => 47
2 => This is another value注意:这个函数不仅返回一个多维数组(即:总是准备应对一个数组的数组,即使期望的是单个值的数组),而且它还返回任意存储为meta值的数组的序列化值。如果你期望一个数组可能被存储为meta值,那么请准备好反序列化。