从帖子中删除元数据匹配条件。

原型

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/