Question

Warning: This function has been deprecated. Use delete_user_meta() instead.

delete_usermeta( int $user_id,  string $meta_key,  mixed $meta_value = '' )

Remove user meta data.

---

description

---

参数

$user_id

(int) (Required) User ID.

$meta_key

(string) (Required) Metadata key.

$meta_value

(mixed) (Optional) Metadata value.

Default value: ''

---

返回值

(bool) True deletion completed and false if user_id is not a number.

---

源代码

File: wp-includes/deprecated.php

function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) {
	_deprecated_function( __FUNCTION__, '3.0.0', 'delete_user_meta()' );
	global $wpdb;
	if ( !is_numeric( $user_id ) )
		return false;
	$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);

	if ( is_array($meta_value) || is_object($meta_value) )
		$meta_value = serialize($meta_value);
	$meta_value = trim( $meta_value );

	$cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );

	if ( $cur && $cur->umeta_id )
		do_action( 'delete_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );

	if ( ! empty($meta_value) )
		$wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s AND meta_value = %s", $user_id, $meta_key, $meta_value) );
	else
		$wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );

	clean_user_cache( $user_id );
	wp_cache_delete( $user_id, 'user_meta' );

	if ( $cur && $cur->umeta_id )
		do_action( 'deleted_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );

	return true;
}

---

更新日志

Version	description
3.0.0	Use delete_user_meta()
2.0.0	Introduced.

---

相关函数

Uses

• wp-includes/cache.php: wp_cache_delete()
• wp-includes/functions.php: _deprecated_function()
• wp-includes/plugin.php: do_action()
• wp-includes/user.php: clean_user_cache()
• wp-includes/wp-db.php: wpdb::get_row()
• wp-includes/wp-db.php: wpdb::query()
• wp-includes/wp-db.php: wpdb::prepare()
Show 2 more uses Hide more uses

---

Used By

• wp-includes/deprecated.php: update_usermeta()

---

User Contributed Notes