Документация для разработчиков

Add

mixed
CUser::Add(
 array fields
)

Метод добавляет нового пользователя. При успешном выполнении возвращает ID нового пользователя, в противном случае - вернет "false", а в свойстве LAST_ERROR объекта будет содержаться текст ошибки. Нестатический метод.

Примечание: CUser::Add можно вызывать только как метод инициализированного объекта, а не как статический метод класса CUser.

Параметры

ПараметрОписание
fields Массив значений полей, в качестве ключей данного массива допустимо использовать:
  • LOGIN* - логин (имя входа)
  • NAME - имя пользователя
  • LAST_NAME - фамилия пользователя
  • SECOND_NAME - отчество пользователя
  • EMAIL* - E-Mail адрес пользователя
  • PASSWORD* - пароль пользователя
  • CONFIRM_PASSWORD* - подтверждение пароля (должно быть равным PASSWORD)
  • GROUP_ID - массив ID групп к которым будет приписан пользователь
  • ACTIVE - флаг активности пользователя [Y|N]
  • LID - ID сайта по умолчанию для уведомлений
  • ADMIN_NOTES - заметки администратора
  • XML_ID - ID пользователя для связи с внешними источниками (например, ID пользователя в какой-либо внешний базе)
  • EXTERNAL_AUTH_ID - код источника [link=89611]внешней авторизации[/link]
  • PERSONAL_PROFESSION - наименование профессии
  • PERSONAL_WWW - персональная WWW-страница
  • PERSONAL_ICQ - ICQ
  • PERSONAL_GENDER - пол ["M" - мужчина; "F" - женщина]
  • PERSONAL_BIRTHDAY - дата рождения в формате текущего сайта (или текущего языка для административной части)
  • PERSONAL_PHOTO - массив описывающий фотографию, допустимы следующие ключи этого массива:
    • name - имя файла
    • size - размер файла
    • tmp_name - временный путь на сервере
    • type - тип загружаемого файла
    • del - если значение равно "Y", то изображение будет удалено
    • MODULE_ID - идентификатор главного модуля - "main"
  • PERSONAL_PHONE - телефон
  • PERSONAL_FAX - факс
  • PERSONAL_MOBILE - мобильный телефон
  • PERSONAL_PAGER - пэйджер
  • PERSONAL_STREET - улица, дом
  • PERSONAL_MAILBOX - почтовый ящик
  • PERSONAL_CITY - город
  • PERSONAL_STATE - область / край
  • PERSONAL_ZIP - индекс
  • PERSONAL_COUNTRY - страна
  • PERSONAL_NOTES - личные заметки
  • TITLE - обращение к пользователю. Поле актуально при добавлении и обновлении.
  • WORK_COMPANY - наименование компании
  • WORK_DEPARTMENT - департамент / отдел
  • WORK_POSITION - должность
  • WORK_WWW - WWW-страница компании
  • WORK_PHONE - рабочий телефон
  • WORK_FAX - рабочий факс
  • WORK_PAGER - рабочий пэйджер
  • WORK_STREET - улица, дом компании
  • WORK_MAILBOX - почтовый ящик компании
  • WORK_CITY - город компании
  • WORK_STATE - область / край компании
  • WORK_ZIP - индекс компании
  • WORK_COUNTRY - страна компании
  • WORK_PROFILE - направления деятельности компании
  • WORK_LOGO - массив описывающий логотип компании, допустимы следующие ключи этого массива:
    • name - имя файла
    • size - размер файла
    • tmp_name - временный путь на сервере
    • type - тип загружаемого файла
    • del - если значение равно "Y", то изображение будет удалено
    • MODULE_ID - идентификатор главного модуля - "main"
  • WORK_NOTES - заметки касаемо работы пользователя
* - обязательные поля.

См. также

Примеры использования

<?
// создадим массив описывающий изображение 
// находящееся в файле на сервере
$arIMAGE = CFile::MakeFileArray($_SERVER["DOCUMENT_ROOT"]."/images/photo.gif");
$arIMAGE["MODULE_ID"] = "main";

$user = new CUser;
$arFields = Array(
  "NAME"              => "Сергей",
  "LAST_NAME"         => "Иванов",
  "EMAIL"             => "ivanov@microsoft.com",
  "LOGIN"             => "ivan",
  "LID"               => "ru",
  "ACTIVE"            => "Y",
  "GROUP_ID"          => array(10,11),
  "PASSWORD"          => "123456",
  "CONFIRM_PASSWORD"  => "123456",
  "PERSONAL_PHOTO"    => $arIMAGE
);

$ID = $user->Add($arFields);
if (intval($ID) > 0)
    echo "Пользователь успешно добавлен.";
else
    echo $user->LAST_ERROR;
?>


© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх