函数文档

update_meta()

💡 云策文档标注

概述

update_meta() 函数用于通过 meta ID 更新文章的元数据。它接受 meta ID、meta key 和 meta value 作为参数,并返回布尔值表示更新是否成功。

关键要点

  • 函数参数包括:$meta_id(整数,必需)、$meta_key(字符串,必需,需转义)、$meta_value(字符串,必需,需转义)。
  • 函数内部使用 wp_unslash() 处理转义,并调用 update_metadata_by_mid() 执行更新操作。
  • 返回类型为布尔值,指示更新结果。

代码示例

function update_meta( $meta_id, $meta_key, $meta_value ) {
	$meta_key   = wp_unslash( $meta_key );
	$meta_value = wp_unslash( $meta_value );

	return update_metadata_by_mid( 'post', $meta_id, $meta_value, $meta_key );
}

注意事项

  • 参数 $meta_key 和 $meta_value 在传入前需转义,函数内部会自动处理反斜杠移除。
  • 此函数专门用于更新文章的元数据,其他类型元数据需使用其他函数。

📄 原文内容

Updates post meta data by meta ID.

Parameters

$meta_idintrequired
Meta ID.
$meta_keystringrequired
Meta key. Expect slashed.
$meta_valuestringrequired
Meta value. Expect slashed.

Return

bool

Source

function update_meta( $meta_id, $meta_key, $meta_value ) {
	$meta_key   = wp_unslash( $meta_key );
	$meta_value = wp_unslash( $meta_value );

	return update_metadata_by_mid( 'post', $meta_id, $meta_value, $meta_key );
}

Changelog

Version Description
1.2.0 Introduced.