update_post_meta

函数
update_post_meta ( $post_id, $meta_key, $meta_value, $prev_value = '' )
参数
  • (int) $post_id Post ID.
    Required:
  • (string) $meta_key Metadata key.
    Required:
  • (mixed) $meta_value Metadata value. Must be serializable if non-scalar.
    Required:
  • (mixed) $prev_value Optional. Previous value to check before updating. If specified, only update existing metadata entries with this value. Otherwise, update all entries. Default empty.
    Required:
    Default: (empty)
返回值
  • (int|bool) Meta ID if the key didn't exist, true on successful update, false on failure or if the value passed to the function is the same as the one that is already in the database.
定义位置
相关方法
update_site_metadelete_post_metaupdate_user_metaupdate_metaupdate_term_meta
引入
1.5.0
弃用
-

update_post_meta: 这个函数更新一个文章的元数据。它需要三个参数:$post_id,$meta_key,和$meta_value。$post_id是需要更新元数据的文章的ID。$meta_key是要更新的元数据字段的名称。$meta_value是元数据的新值。

根据给定的文章ID更新一个文章元域。

使用`$prev_value`参数来区分具有相同键和文章ID的元字段。

如果文章的元字段不存在,它将被添加并返回其ID。

可以用来代替add_post_meta()。”

function update_post_meta( $post_id, $meta_key, $meta_value, $prev_value = '' ) {
	// Make sure meta is updated for the post, not for 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 );
}