yaz_connect - Подготавливает соединение с сервером Z39.50
Вернуться к: YAZ Функции
yaz_connect
(PHP 4 >= 4.0.1, PECL yaz >= 0.9.0)
yaz_connect — Подготавливает соединение с сервером Z39.50
Описание
Функция возвращает дескриптор соединения в случае успеха и ноль в случае ошибки.
yaz_connect() подготавливает соединение с сервером Z39.50. Эта функция неблокирующая и не пытается установить соединение, а лишь готовит соединение для последующего выполнения функцией yaz_wait().
Замечание:
» YAZ proxy бесплатно доступный агент Z39.50.
Список параметров
-
zurl
-
Строка, принимающая форму host[:port][/database]. Если порт опущен, то по умолчанию используется 210 порт. Если опушено название базы данных, используется база с именем Default.
-
options
-
Если задается строка, то она рассматривается как строка аутентификации Z39.50 V2 (OpenAuth).
Если задан массив, то содержимое массива выступает в качестве параметров.
- user
-
Имя пользователя для аутентификации.
- group
-
Название группы для аутентификации.
- password
-
Пароль для аутентификации.
- cookie
-
Cookie для сессии (YAZ proxy).
- proxy
-
Прокси для подключения (YAZ proxy).
- persistent
-
Имеет логический тип. Если принимает
TRUE
- соединение постоянное, еслиFALSE
- непостоянное соединение. По умолчанию соединение постоянное.Замечание:
Если вы открыли постоянное соединение, вы не сможете закрыть его позднее с помощью yaz_close().
- piggyback
-
Имеет логический тип. Если принимает
TRUE
,то режим передачи прямых и обратных пакетов включен; еслиFALSE
, то данный режим отключен. По умолчанию режим передачи прямых и обратных пакетов включен.Включение режима передачи прямых и обратных пакетов более эффективно и обычно снижает нагрузку в сети для впервые выбранных записей. Однако некоторые сервера Z39.50 не поддерживают режим прямых и обратных пакетов или игнорируют эту настройку. Для них данный режим должен быть отключен.
- charset
-
Строка, определяющая кодировку используемую в Z39.50 и при передаче данных. Возможны такие значения как: ISO-8859-1, UTF-8, UTF-16.
Большинство серверов Z39.50 не поддерживают данную настройку (и таким образом она игнорируется). Много серверов используют кодировку ISO-8859-1 для запросов и сообщений. Кодировки записей в форматах MARC21/USMARC не затрагиваются данной опцией.
- preferredMessageSize
-
Целочисленное параметр, определяющий максимальный размер всех записей, возвращенных сервером при поиске, в байтах. Для более подробной информации см. стандарт » Z39.50.
Замечание:
Эта опция поддерживается в версии PECL YAZ 1.0.5 и более поздних.
- maximumRecordSize
-
Целочисленный параметр, определяющий максимальное количество байт в отдельной записи, возвращаемой сервером в результате поиска. Данный параметр относится к Exceptional-record-size в стандарте » Z39.50.
Замечание:
Эта опция поддерживается в версии PECL YAZ 1.0.5 и более поздних.
Возвращаемые значения
Дескриптор соединения в случае успеха, FALSE
при ошибке.
Список изменений
Версия | Описание |
---|---|
4.1.0 |
Был добавлен параметр options .
|
Вернуться к: YAZ Функции