get_post_meta - PHP

在WordPress开发中，get_post_meta()是一个用于获取文章元数据的函数。文章元数据是一些键值对，可以用来存储关于文章的任何附加信息。

语法

get_post_meta( int $post_id, string $key = '', bool $single = false )

参数

• post_id (必须) - 文章ID，可以使用 get_the_ID() 获取当前文章ID。
• key (可选) - 要获取元数据的键名。默认为空字符串，表示获取所有元数据。
• single (可选) - 是否返回单个值。默认为 false，表示返回所有相应键名的值。

返回值

当 $single 参数为 false 时，函数将返回一个数组，包含所有指定键名的元数据。

当 $single 参数为 true 时，如果指定的键名有多个值，则将返回第一个值；如果只有一个值，则返回该值；如果没有值，则返回空字符串。

用法示例

获取所有元数据

$metadata = get_post_meta( get_the_ID() );

这将返回一个数组 $metadata，包含当前文章的所有元数据。例如，如果我们想获取文章的“作者”和“发布时间”，可以这样写：

$author = $metadata['author'][0];
$published = $metadata['published'][0];

获取单个元数据值

$author = get_post_meta( get_the_ID(), 'author', true );

这将返回当前文章的“作者”元数据值。

循环遍历所有元数据

如果要对每个元数据执行相同的操作，例如将其打印到页面上，可以使用 foreach 循环遍历元数据数组。例如：

$metadata = get_post_meta( get_the_ID() );
foreach ( $metadata as $key => $value ) {
    echo $key . ': ' . $value[0] . '<br>';
}

这将遍历所有元数据，并将每个元数据的值打印到页面上。

参考文献

• get_post_meta() 函数文档