常用函数-update_post_meta()

说明

该函数为指定文章更新已有meta关键字（自定义）的值。

成功更新后函数返回true，若文章未指定meta关键字则返回false。

可用 add_post_meta()函数添加新的meta关键字和值。

用法

<?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?> 

示例

缺省用法

<?php update_post_meta(76, 'my_key', 'Steve'); ?>  

其他示例

假设某文章编号为76并含有以下4个自定义字段：

[key_1] => ‘Happy’
[key_1] => ‘Sad’
[key_2] => ‘Gregory’
[my_key] => ‘Steve’

若要将key_2的值改为Hans:

<?php update_post_meta(76, 'key_2', 'Hans'); ?>  

将key_1的值从Sad改为Happy：

<?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>  

修改后的字段显示如下：

[key_1] => ‘Happy’
[key_1] => ‘Happy’
[key_2] => ‘Hans’
[my_key] => ‘Steve’

注意：该函数仅升级符合标准的第一个字段。

将key_1的值从Happy改为Excited:

<?php     
  update_post_meta(76, 'key_1', 'Excited', 'Happy');      

  //Or      

  update_post_meta(76, 'key_1', 'Excited');      
 
  //To change all fields with the key "key_1":      

  $key1_values = get_post_custom_values('key_1', 76);    
  foreach ( $key1_values as $value )      
    update_post_meta(76, 'key_1', 'Excited', $value);  
?>

更详细示例参见 post_meta函数示例 页面。

参数

$post_id

（整数）（必需）含有需要编辑字段的文章的编号

默认值：None

$meta_key

（字符）（必需）需要编辑的自定义字段的关键字

默认值：None

$meta_value

（字符）（必需）自定义字段的新值

默认值：None

$prev_value

（字符）（可选）希望改变的自定义字段原值。该参数用于区分带有相同关键字的字段。

默认值：None

相关资源

add_post_meta(), get_post_meta(), delete_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()

分类：中文手册