update_post_meta() | WordPress更新文章元数据函数

函数

update_post_meta($post_id, $meta_key, $meta_value, $prev_value);

根据WordPress文章 ID 来更新自定义字段。使用 $prev_value 参数来区分同样的 key 和文章 ID 的自定义字段。

如果指定的 $meta_key 不存在，则添加这个自定义字段。

参数

• $post_id – (integer) (required) 将要更新自定义字段的日志 ID。Default: None
• $meta_key – (string) (required) 将要更新自定义字段的名称（key）。Default: None
• $meta_value – (mixed) (required) 自定义字段的新值，如果是一个数组，将会被序列化成字符串。Default: None
• $pre_value – (boolean) (optional) 将要修改的自定义字段原来的值，这是用来区分相同 key 的几个字段，如果省略了，则当前日志下指定 key 的多个值都将被更新。Default: Empty

返回值

(mixed) 如果 meta 不存在，返回 meta_id，否则更新成功返回 true，失败返回 false。

注意：如果传递过去的 meta_value 和数据库中现有的是相同的话，也会返回错误。

源文件

wp-includes/post.php