update_post_meta()

根据帖子ID更新帖子元字段。

原型

update_post_meta( int $post_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' )

描述

使用$ prev_value参数来区分具有相同密钥和帖子ID的元字段。

参数

$post_id (int) (Required) 帖子ID。

$meta_key (string) (Required) 元数据键。

$meta_value (mixed) (Required) 元数据价值。如果是非标量，则必须可序列化。

$prev_value (mixed) (Optional)  要删除之前要检查的上一个值。

返回值

(int|bool)  如果密钥不存在则为元ID，成功更新时为true，失败时为false。

源文件

路径：wp-includes/post.php

<?php
...
function update_post_meta( $post_id, $meta_key, $meta_value, $prev_value = '' ) {
	// Make sure meta is added to the post, not a revision.
	$the_post = wp_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}
	return update_metadata( 'post', $post_id, $meta_key, $meta_value, $prev_value );
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/update_post_meta/