функция
Устаревший since 2.0.0
update_usermeta()
Устаревшее.
Помечено устаревшим с версии 3.0.0.
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
update_usermeta( int $user_id, string $meta_key, mixed $meta_value ): boolОписание
Сериализовать значения не нужно — они будут сериализованы при необходимости. Ключ метаданных может быть только строкой с подчёркиваниями. Всё остальное будет удалено.
Если значение метаданных пустое, метаданные будут удалены.
См. alsoupdate_user_meta()
Оригинал (английский)
There is no need to serialize values, they will be serialized if it is needed. The metadata key can only be a string with underscores. All else will be removed.
Will remove the metadata, if the meta value is empty.
Параметры
$user_id
int
обязательный
ID пользователя
$meta_key
string
обязательный
Ключ метаданных.
$meta_value
mixed
обязательный
Значение метаданных.
Возвращаемое значение
bool
Исходный код
wp-includes/deprecated.php:2335
function update_usermeta( $user_id, $meta_key, $meta_value ) {
_deprecated_function( __FUNCTION__, '3.0.0', 'update_user_meta()' );
global $wpdb;
if ( !is_numeric( $user_id ) )
return false;
$meta_key = preg_replace('|[^a-z0-_]|i', '', $meta_key);
/** @todo Might need fix because usermeta data is assumed to be already escaped */
if ( is_string($meta_value) )
$meta_value = stripslashes($meta_value);
$meta_value = maybe_serialize($meta_value);
if (empty($meta_value)) {
return delete_usermeta($user_id, $meta_key);
}
$cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );
if ( $cur )
do_action( 'update_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );
if ( !$cur )
$wpdb->insert($wpdb->usermeta, compact('user_id', 'meta_key', 'meta_value') );
elseif ( $cur->meta_value != $meta_value )
$wpdb->update($wpdb->usermeta, compact('meta_value'), compact('user_id', 'meta_key') );
else
return false;
clean_user_cache( $user_id );
wp_cache_delete( $user_id, 'user_meta' );
if ( !$cur )
do_action( 'added_usermeta', $wpdb->insert_id, $user_id, $meta_key, $meta_value );
else
do_action( 'updated_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );
return true;
}История изменений
| Версия | Описание |
|---|---|
| 3.0.0 | Deprecated. Use update_user_meta() |
| 2.0.0 | Introduced. |
