Описание и параметры
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;
?>