编辑“WordPress:Function Reference/update post meta”

==描述==
函数 [[WordPress:Function Reference/update post meta|update post meta()]]为某篇文章更新现存的meta key（自定义区）。

成功更新之后，函数返回<var>true</var>，如果文章没有规定meta key，函数返回<var>false</var>。

如果你想要添加一个新的meta key和参数值，请使用[[WordPress:Function Reference/add post meta|add_post_meta()]]函数。

==用法==

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

==例子==
===默认用法===

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

===其它的例子===

假定一篇文章的ID是76，下面的4个自定义区：

<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
[key_1] => '愉快'<br/>
[key_1] => '悲伤'<br/>
[key_2] => 'Gregory'<br/>
[my_key] => 'Steve'<br/>
</div>

将<tt>key_2</tt>的参数值更改为''Hans'':

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

将<tt>key_1</tt>的参数值从''悲伤'' 更改为 ''愉悦''：

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

Fields现在看起来像：
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
[key_1] => 'Happy'<br/>
[key_1] => 'Happy'<br/>
[key_2] => 'Hans'<br/>
[my_key] => 'Steve'<br/>
</div>
'''''注:'''这个函数只会更新匹配标准的第一个field。''

将第一个<tt>key_1</tt>的参数值从''高兴'' 更改为 ''兴奋的''：

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

  //或者

  update_post_meta(76, 'key_1', 'Excited');

  //更改所有关键字为 "key_1"的fields:

  $key1_values = get_post_custom_values('key_1', 76);
  foreach ( $key1_values as $value )
    update_post_meta(76, 'key_1', 'Excited', $value);
?></pre>
关于更详细的例子，请进入[[WordPress:Function Reference/post meta Function Examples|post_meta 函数例子]]网页。


==参数==
{{Parameter|$post_id|integer|包含你需要编辑的field的文章的ID。}}
{{Parameter|$meta_key|string|你需要编辑的自定义field的关键字。}}
{{Parameter|$meta_value|string|自定义field的新的参数值。}}
{{Parameter|$prev_value|string|你想要更改的自定义field的旧的参数值。这是要区分几个相同关键词的field。|可选择的}}

==相关的==

[[WordPress:Function Reference/delete post meta|delete_post_meta()]], [[WordPress:Function Reference/get post meta|get_post_meta()]], [[WordPress:Function Reference/add post meta|add_post_meta()]], [[WordPress:Function Reference/get post custom|get_post_custom()]], [[WordPress:Function Reference/get post custom values|get_post_custom_values()]], [[WordPress:Function Reference/get post custom keys|get_post_custom_keys()]]

[[WordPress:Function Reference/delete post meta|delete_post_meta()]], [[WordPress:Function Reference/get post meta|get_post_meta()]], [[WordPress:Function Reference/add post meta|add_post_meta()]], [[WordPress:Function Reference/get post custom|get_post_custom()]], [[WordPress:Function Reference/get post custom values|get_post_custom_values()]], [[WordPress:Function Reference/get post custom keys|get_post_custom_keys()]]