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.
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. |