WordPress как на ладони
WordPress темы и плагины за 250 рублей wordpress jino

update_user_meta() WP 3.0

Обновляет мета поле указанного пользователя.

Кроме обновления существующего поля, также создаст поле, если поля с таким ключом еще не существует.

Функцию можно использовать вместо add_user_meta(). При создании поля вызывает add_user_meta() с параметром $unique = true. Это означает, что add_user_meta() удобно использовать только в случаях, когда нужно создать несколько полей с одинаковыми ключами, во остальных случаях удобнее использовать эту функцию.

Используйте параметр $prev_value, когда нужно определить какое именно поле, из нескольких с одинаковыми ключами, нужно обновить.

Функция не удаляет поле, если передано пустое значение параметра $meta_value.

Используется в: update_user_option().
Работает на основе: update_metadata()
✈ 1 раз = 0.000987с = медленно | 50000 раз = 45.34с = очень медленно PHP 7.0.8, WP 4.6.1

Хуков нет.

Возвращает

Число/true/false.

  • true - при успешном обновлении.
  • false - при неудаче.
  • ID первичного поля таблицы метаполей (umeta_id), когда было создано новое поле.

Использование

update_user_meta( $user_id, $meta_key, $meta_value, $prev_value )
$user_id(число) (обязательный)
ID пользователя.
$meta_key(строка) (обязательный)
Ключ поля - поле meta_key в таблице wp_usermeta, для которого значение meta_value должно быть обновлено.
$meta_value(строка/массив/число/объект/логический) (обязательный)

Новое значение поля. Значение должно отличаться от предыдущего. Объекты и массивы будут автоматически сериализованы (serialized).

Если указать значение, которое уже записано метаполе (такое же), то функция не будет делать лишних запросов по обновлению старого значения на такое же новое...

$prev_value(строка/массив/число/объект/логический)
Старое значение. Нужно указывать когда у пользователя может быть несколько полей с одинаковыми ключами и нам нужно обновить определенное из них.
По умолчанию: ''

Примеры

#1 Базовый пример

Предположим у пользователя с ID 1 должно быть мета поле mood. Давайте обновим его значение или создадим поле, если его не существует.

update_user_meta( 1, 'mood', 'good' )

#2 Обновим сайт пользователя

В мета полях пользователя хранятся привычные нам данные: Ник, Имя, Фамилия, Сайт и т.д. Пример ниже показывает, как обновить сайт пользователя с ID 1:

$user_id = 1;
$website = 'http://wordpress.org';
update_user_meta($user_id, 'user_url', $website);

#2 Проверка на ошибку

Этот пример показывает как проверить обновилось ли поле:

$user_id = 1;
$new_value = 'good';

// Вернет false, если предыдущее значение совпадает с $new_value.
if( ! update_user_meta( $user_id, 'some_meta_key', $new_value ) ){
	echo "Поле не обновлено";
}

// Получим значение поля и проверим его с новым значением $new_value
if ( get_user_meta($user_id,  'some_meta_key', true ) != $new_value )
	wp_die('Ошибка: новое значение не записалось.');

Код update user meta: wp-includes/user.php VER 4.9.6

<?php
function update_user_meta($user_id, $meta_key, $meta_value, $prev_value = '') {
	return update_metadata('user', $user_id, $meta_key, $meta_value, $prev_value);
}

Cвязанные функции

Из метки: metadata (метаданные)

7 комментов
  • Андрей cайт: ypfirm.ru

    Как обновить много полей? Неужели каждый раз придётся обращаться к базе через эту функцию?

    Ответить2.1 года назад #
    • Kama5346

      Ну можно одним запросом SQL. А через среду ВП если, то да каждое поле надо обновить отдельно...

      Ответить2.1 года назад #
    • Egor

      Обновить одной функцией действительно нельзя, можно лишь сделать эту операцию более удобной.

      <?php
      $user_id = 1234;
      
      $metas = array( 
      	'nickname'   => $userFirstName,
      	'first_name' => $userFirstName, 
      	'last_name'  => $userLastName ,
      	'city'       => $userCityID ,
      	'gender'     => $userGenderID
      );
      
      foreach($metas as $key => $value) {
      	update_user_meta( $user_id, $key, $value );
      }

      Тут еще пример, как сделать это прямым запросом - http://stackoverflow.com/questions/30610780/how-to-update-user-meta-for-multiple-meta-key-in-wordpress

      2
      Ответить1.2 год назад #
  • @ Otshelnik-Fm191 cайт: otshelnik-fm.ru

    Тимур подскажи - посмотрел исходник update_metadata - но не понял.
    Если в update_user_meta передавать ключ и значение которое уже там в бд есть - будет обновляться или false вызовет и не запустит работу mysql по обновлению ячейки?

    У меня в коде может передаваться значение которое присутствует уже в данном метаполе.
    Пример: update_user_meta($user_id, 'mbd_type', $type);
    а в $type будет например android.

    По ресурсам скрипта - получается я в холостую буду гонять функцию update_user_meta (так как в бд уже записано значение android) и она будет обновлять значение которое не изменилось (ненужные операции для бд). Надо ли мне делать проверку - если есть это значение - то не выполнять апдейт, если в этом юзермета оно другое - то тогда и обновлять. Или шило на мыло получается?

    1
    Ответить1.3 год назад #
    • @ Otshelnik-Fm191 cайт: otshelnik-fm.ru

      Отвечу - себе не внимательному - если значение одинаковое и уже присутствует в значении этого ключа - то выполнение оборвется:

      // Compare existing value to new value if no prev value given and the key exists only once.
      	if ( empty($prev_value) ) {
      		$old_value = get_metadata($meta_type, $object_id, $meta_key);
      		if ( count($old_value) == 1 ) {
      			if ( $old_value[0] === $meta_value )
      				return false;
      		}
      	}

      Поэтому никаких лишних проверок не надо - вордпресс обо все позаботился.
      Извините за беспокойство и с наступающим новым годом!

      1
      Ответить1.3 год назад #
  • @ Otshelnik-Fm191 cайт: otshelnik-fm.ru

    Тимур дополни - про то что возвращает функция: если поля не было и она создала его - то вернет id метаполя. число (umeta_id). А только при обновлении поля если все ок - вернет true
    https://developer.wordpress.org/reference/functions/update_user_meta/#return

    1
    Ответить3 месяца назад #

Здравствуйте, !