当前浏览:首页 / WordPress函数 / get_post_custom()

get_post_custom( int $post_id )

根据文章ID检索文章meta字段

custom

postmore...


描述

文章meta字段尽可能从缓存中检索,因此该函数被优化为可多次调用。


参数

$post_id

(int) (可选) 文章 ID,默认为全局$post的ID。


返回

(mixed) 一个数组值。对于无效的$post_id(非数字、零值或负值),为False。如果传递了有效但不存在的post ID,则为空字符串。


说明

另见get_post_custom_keys()get_post_custom_values()



源码

查看源码 官方文档


更新日志

版本描述
1.2.0开始引入

用户贡献的笔记

  • 贡献者:Codex

    默认用法使用以下示例将变量($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值,那么请准备好反序列化。