从帖子中删除元数据匹配条件。
原型
delete_post_meta( int $post_id, string $meta_key, mixed $meta_value = '' )
描述
你可以根据键,键和值进行匹配。基于密钥和值进行删除将不会使用相同的密钥删除重复的元数据。如果需要,它还允许删除所有元数据匹配键。
参数
$post_id
(int)
(Required)
帖子ID。
$meta_key
(string)
(Required)
元数据名称。
$meta_value
(mixed)
(Optional)
元数据价值。如果是非标量,则必须可序列化。
返回值
(bool)
成功时是真的,失败时是假的。
源文件
路径:wp-includes/post.php
<?php
...
function delete_post_meta( $post_id, $meta_key, $meta_value = '' ) {
// Make sure meta is added to the post, not a revision.
$the_post = wp_is_post_revision( $post_id );
if ( $the_post ) {
$post_id = $the_post;
}
return delete_metadata( 'post', $post_id, $meta_key, $meta_value );
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/delete_post_meta/