wordpress update_post_meta函数

update_post_meta() 是 WordPress 中一个用于更新文章/页面自定义字段的函数，也称为“元数据”。它的函数原型如下：

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

参数说明：

• $post_id：必需。文章/页面的 ID。
• $meta_key：必需。自定义字段的名称。
• $meta_value：必需。自定义字段的值。
• $prev_value：可选。用于检查是否已经存在该值。如果指定，则只有当自定义字段的值等于 $prev_value 时才会被更新。

调用 update_post_meta() 函数可以更新指定文章/页面的自定义字段数据。例如，如果文章/页面中有一个名为“author”的自定义字段，你可以使用以下代码来更新它的值：

update_post_meta( get_the_ID(), 'author', 'John Doe' );

上面的代码中，get_the_ID() 用于获取当前文章/页面的 ID，第二个参数是自定义字段名称，第三个参数是要更新的值。

需要注意的是，update_post_meta() 函数会根据自定义字段名称和文章/页面 ID 来查找自定义字段，如果找到匹配项，则会更新它的值；如果没有找到匹配项，则会创建一个新的自定义字段。

如果需要更新某个自定义字段，但是需要先检查该字段是否已经存在，并且当前值等于某个特定值，可以在函数的第四个参数中传入 $prev_value。例如，下面的代码仅当自定义字段“author”的当前值为“Jack”时才会将其更新为“John Doe”：

update_post_meta( get_the_ID(), 'author', 'John Doe', 'Jack' );

如果自定义字段名称不存在，则不会更新任何内容，函数将返回 false。如果自定义字段值没有更改，则不会更新自定义字段，函数将返回 false。如果更新成功，则返回 true。

需要注意的是，由于 WordPress 缓存的存在，如果你在代码中更新了自定义字段的值，但是在页面上看不到新的值，可以尝试使用 wp_cache_flush() 函数清除缓存。