Установить соединение с базой данных
Назначение
Функция Linter_Open_Connect
устанавливает связь между РНР-модулем и СУБД ЛИНТЕР с заданным именем пользователя и паролем. В функции может быть указано имя ЛИНТЕР-сервера. Если имя ЛИНТЕР-сервера не указано, то модуль подключится к локальной БД или к серверу по умолчанию.
Синтаксические правила
int Linter_Open_Connect (пользователь, пароль, сервер, режим);
- Пользователь
-
Имя пользователя БД. Символьная строка длиной не более 66 символов.
- Пароль
-
Пароль пользователя. Символьная строка длиной не более 18 символов.
- Сервер
-
Имя ЛИНТЕР-сервера, с которым необходимо установить соединение. Символьная строка длиной не более 8 символов.
- Режим
-
Задает режим обработки транзакций и/или кодовую страницу. Режим обработки транзакций по умолчанию –
AUTOCOMMIT
. Список доступных кодовых страниц находится в системной таблице LINTER_SYSTEM_USER.$$$CHARSET. Кодовая страница по умолчанию зависит от ОС. В среде ОС Windows кодировка определяется по кодировке текущей задачи (OEM, если не указано обратное). В ОС UNIX – по значению переменной LANG. Кодировку по умолчанию можно задать также переменной окруженияLINTER_CP
(см. документ «СУБД ЛИНТЕР. Интерфейс нижнего уровня»).
Формат:
[режим транзакции] [| кодовая страница]
Режимы транзакции:
-
TM_AUTOCOMMIT
; -
TM_OPTIMISTIC
;Примечание
Режим TM_OPTIMISTIC устарел (использовать не рекомендуется).
-
TM_EXCLUSIVE
;
Значение 0 < кодовой страницы > соответствует кодовой странице по умолчанию.
Возвращаемое значение
Идентификатор соединения с БД.