CUser::Update это штатный метод ядра Битрикса для изменения пользователя из кода. Через него я правлю профили при импорте из CRM, сбрасываю пароли после обращения в поддержку и перекладываю людей между группами. Метод нестатический, поэтому сначала создаётся объект, и это первое место, где спотыкаются: вызов CUser::Update(...) как статического в таком виде не сработает. Ниже: сигнатура, обновление полей, смена пароля, группы, запуск вне страницы и список ошибок, на которые я наступал сам.
Как работает CUser::Update: сигнатура и результат
Метод принимает ID пользователя и массив полей. Меняются только те поля, которые есть в массиве, остальные остаются как были. Исключение одно, и о нём ниже: GROUP_ID заменяет список групп целиком.
<?php
$user = new CUser;
$ok = $user->Update(15, [
'NAME' => 'Иван',
'LAST_NAME' => 'Петров',
'PERSONAL_PHONE' => '+79001234567',
]);
if (!$ok) {
echo $user->LAST_ERROR;
}
Метод возвращает true или false. При false текст причины лежит в свойстве LAST_ERROR того же объекта, а не в глобальном $APPLICATION. Если не проверить результат, ошибка валидации пройдёт молча: сайт покажет «всё сохранено», а в базе старые данные. Я всегда логирую LAST_ERROR вместе с ID пользователя.
Нужен ли глобальный $USER? На обычной странице можно вызвать global $USER; $USER->Update(...), но в агентах и консольных скриптах этого объекта нет, поэтому new CUser надёжнее везде. Права при этом не проверяются: метод обновит любого пользователя, кому бы вы ни были авторизованы. Проверку, что текущий посетитель правит именно себя, пишите сами до вызова.
Изменить данные пользователя: стандартные и пользовательские поля
В массив кладутся поля из таблицы пользователей: NAME, LAST_NAME, SECOND_NAME, EMAIL, LOGIN, ACTIVE, поля профиля с префиксами PERSONAL_ и WORK_. Пользовательские поля передаются под их кодами UF_* в том же массиве, отдельной обёртки нет.
<?php
$user = new CUser;
$fields = [
'EMAIL' => 'ivan@example.ru',
'WORK_COMPANY' => 'ООО Ромашка',
'UF_CRM_ID' => '48213',
];
if (!$user->Update($userId, $fields)) {
AddMessage2Log($userId . ': ' . $user->LAST_ERROR, 'user_update');
}
Указывайте только то, что действительно изменилось. Для этого я сначала читаю текущую запись. Помните, что CUser::GetByID возвращает не массив, а объект CDBResult, массив берётся явным вызовом:
<?php
$current = CUser::GetByID($userId)->Fetch();
$fields = [];
if ($current['EMAIL'] !== $newEmail) {
$fields['EMAIL'] = $newEmail;
}
if ($fields) {
$user = new CUser;
$user->Update($userId, $fields);
}
Не печатайте результат GetByID через print_r или var_dump. Внутри объекта результата лежит подключение к базе, и в вывод попадает пароль MySQL. На одном из проектов он так оказался в логе диагностики. Выводите только нужные скалярные поля.
Если вы меняете EMAIL или LOGIN, ядро проверяет их на уникальность и на формат. Занятый e‑mail даст false и текст в LAST_ERROR. Требование уникальности e‑mail зависит от настройки главного модуля, поэтому на разных сайтах один и тот же код может вести себя по-разному.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Сменить пароль пользователя через CUser::Update
Пароль передаётся открытым текстом в поле PASSWORD, а подтверждение в CONFIRM_PASSWORD. Хэш считает ядро. Подтверждение обязательно: без него метод вернёт ошибку, даже если пароли совпадают.
<?php
$user = new CUser;
$new = 'Xk9#mP2vLq7w';
$ok = $user->Update($userId, [
'PASSWORD' => $new,
'CONFIRM_PASSWORD' => $new,
]);
if (!$ok) {
echo $user->LAST_ERROR;
}
При смене пароля срабатывает политика безопасности групп, в которых состоит пользователь: минимальная длина, требование цифр, спецсимволов и регистров. Если пароль не проходит, LAST_ERROR перечислит нарушенные условия. Генерируя пароль в коде, я проверяю его на тестовом пользователе из той же группы, иначе случайная строка может не пройти политику на боевом сайте.
Складывать готовый хэш в поле PASSWORD не нужно. Я встречал такие попытки при миграции с другого движка, и они заканчивались тем, что вход не работал: ядро хэшировало хэш повторно. Если пользователей переносят пачкой, проще выдать им временные пароли и разослать ссылку на восстановление.
Письмо с новым паролем
После Update письмо пользователю не уходит. Если нужно сообщить пароль, это отдельный шаг: у класса есть метод CUser::SendUserInfo, который отправляет почтовое событие с данными для входа. Перед использованием проверьте его сигнатуру в документации своей версии ядра. Пароль в открытом виде по почте я отправляю только как временный, с требованием сменить его при первом входе.
Восстановление пароля
Для сценария «забыл пароль» есть отдельный путь через контрольную строку и метод CUser::ChangePassword. Он принимает логин, контрольную строку, новый пароль и подтверждение. Прямой Update здесь подходит только там, где пользователя уже проверили вы сами: например, менеджер сбрасывает пароль клиенту из своей админки.
Обновить группы и активность пользователя
Поле GROUP_ID заменяет список групп целиком. Если передать [7], пользователь окажется только в группе 7 и потеряет все остальные, включая «Все пользователи» там, где её привязывали явно. Поэтому для добавления в группу сначала читаю текущие:
<?php
$groups = CUser::GetUserGroup($userId);
$groups[] = 7;
$user = new CUser;
$user->Update($userId, [
'GROUP_ID' => array_unique($groups),
]);
Для блокировки передаётся 'ACTIVE' => 'N', для возврата доступа 'Y'. Заблокированный пользователь не сможет войти, но его заказы и записи в инфоблоках остаются на месте, поэтому деактивация безопаснее удаления.
CUser::Update вне страницы: агент, CLI и обработчики событий
Основная масса задач по обновлению пользователей идёт не с формы, а из фона: синхронизация с CRM, чистка неактивных, массовая смена полей. Тут три особенности.
- Агент. Переменной
USERв агентах нет, авторизовать пользователя методомAuthorizeнельзя.new CUserпри этом работает. По умолчанию агенты выполняются на хите посетителя, поэтому тяжёлую пачку обновлений в один агент не складывайте: режьте на порции и возвращайте из функции строку для следующего запуска. - Консольный скрипт. Скрипт кладу вне webroot, задаю
$_SERVER['DOCUMENT_ROOT'], определяюNO_KEEP_STATISTICиNOT_CHECK_PERMISSIONS, затем подключаю/bitrix/modules/main/include/prolog_before.php. На моём shared-хостинге ядро версии 22.0.300 из CLI не запускалось под PHP 8.0-8.2 и поднялось только под бинарником 7.4, который использует веб. Если ядро из консоли не стартует, сначала попробуйте другие версии PHP на хостинге, а не пишите прямой SQL. - Обработчики. Перед сохранением вызывается событие
OnBeforeUserUpdate, после негоOnAfterUserUpdate. Из «до» можно отменить операцию: бросить исключение через$APPLICATION->ThrowExceptionи вернуть false. Из «после» не вызывайтеUpdateдля того же пользователя, иначе получите рекурсию.
Пример обработчика, который запрещает снимать активность у администратора с ID 1:
<?php
AddEventHandler('main', 'OnBeforeUserUpdate', function (&$arFields) {
if ((int)$arFields['ID'] === 1 && ($arFields['ACTIVE'] ?? '') === 'N') {
global $APPLICATION;
$APPLICATION->ThrowException('Администратора деактивировать нельзя');
return false;
}
});
Регистрировать такой код стоит в /local/php_interface/init.php: папка /local имеет приоритет над /bitrix и не затирается при обновлениях.
Способы изменить пользователя: сравнение и типичные ошибки
Кроме CUser::Update есть и другие пути. Документация сама рекомендует для выборок новое ядро D7 (UserTable::getList), но для записи ситуация другая: старый класс CUser содержит логику паролей и событий, которую вручную не повторить.
| Способ | Хэширует пароль | Вызывает события | Когда брать |
|---|---|---|---|
CUser::Update |
Да, и применяет политику групп | Да | Любая правка профиля, пароля, групп |
CUser::ChangePassword |
Да | Да | Восстановление по контрольной строке |
UserTable::update (D7) |
- | - | Не брать: по документации UserTable служит для выборки данных, а изменять пользователя нужно через CUser |
| Прямой SQL | Нет | Нет | Не использовать |
Строку про D7 я оставил намеренно: UserTable годится для выборок, а не для записи. Прямой SQL по таблице пользователей ломает кэш и оставляет без проверки уникальность логина.
Ошибки, которые я чаще всего вижу в чужом коде:
- Статический вызов
CUser::Update()вместо вызова у экземпляра. - Пароль без
CONFIRM_PASSWORDи последующее недоумение, почему он «не меняется». - Передача
GROUP_IDс одной новой группой и потеря остальных. - Игнорирование возвращаемого значения: false без чтения
LAST_ERROR. - Поиск пользователя по неподходящему ключу фильтра
CUser::GetList. Для точного логина есть отдельный ключLOGIN_EQUALи методCUser::GetByLogin, а обычныйLOGINищет подстроку и может вернуть не того человека. - Обновление в цикле на десятки тысяч записей прямо в агенте на хите: страницы начинают тормозить у случайных посетителей.
Последний пункт решается переносом тяжёлых задач на cron. Для этого агенты на хите отключают и запускают свой скрипт, в который подключено ядро, раз в минуту. Для маленького сайта это избыточно, а вот для массовой синхронизации клиентов с внешней системой оправдано.
Если у вас схема сложнее, например двусторонняя синхронизация пользователей с внешней системой или миграция аккаунтов с другого движка, такую задачу удобнее отдать на доработку: у меня это доработка и поддержка 1С-Битрикс от 3 000 ₽/час, мелкая правка обычно укладывается в один-два часа.
Условия и возможности 1С-Битрикс меняются от версии к версии, поэтому перед внедрением я сверяюсь с актуальной документацией на dev.1c-bitrix.ru.
Частые вопросы
Можно ли вызвать CUser::Update без авторизации?
Да. Метод не проверяет права текущего посетителя и работает в агентах, консольных скриптах и обработчиках. Именно поэтому проверку, что пользователь правит свой профиль, нужно написать самостоятельно до вызова.
Почему CUser::Update возвращает false и ничего не меняет?
Смотрите свойство LAST_ERROR объекта, у которого вызывали метод. Чаще всего причины такие: не передан CONFIRM_PASSWORD, пароль не прошёл политику группы, e‑mail или логин уже заняты, либо обработчик OnBeforeUserUpdate отменил операцию.
Как изменить только одно поле, не затрагивая остальные?
Передайте в массиве одно это поле. Метод обновляет только переданные ключи. Единственное исключение это GROUP_ID: он заменяет список групп целиком, поэтому текущие группы сначала читают через CUser::GetUserGroup.
Можно ли обновлять пароль через UserTable::update из D7?
Не стоит: этот путь не заменяет логику класса CUser по хэшированию и проверке политики пароля. Для смены пароля используйте CUser::Update с парой PASSWORD и CONFIRM_PASSWORD.