(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).
Если задали массив, содержимое массива выступает как параметры.
Имя пользователя для аутентификации.
Название группы для аутентификации.
Пароль для аутентификации.
Cookie для сессии (YAZ proxy).
Прокси для подключения (YAZ proxy).
Имеет логический тип. Если принимает true
- соединение постоянное,
если false
- непостоянное соединение. По умолчанию соединение
постоянное.
Замечание:
Если вы открыли постоянное соединение, вы не сможете закрыть его позднее с помощью yaz_close().
Имеет логический тип. Если принимает true
, то режим передачи прямых
и обратных пакетов включён; если false
, то данный режим
отключён. По умолчанию режим передачи прямых и обратных пакетов
включён.
Включение режима передачи прямых и обратных пакетов более эффективно и обычно снижает нагрузку в сети для впервые выбранных записей. Однако некоторые сервера Z39.50 не поддерживают режим прямых и обратных пакетов или игнорируют эту настройку. Для них данный режим должен быть отключён.
Строка, определяющая кодировку используемую в Z39.50 и при
передаче данных. Возможны такие значения как:
ISO-8859-1
, UTF-8
,
UTF-16
.
Большинство серверов Z39.50 не поддерживают данную настройку (и таким образом она игнорируется). Много серверов используют кодировку ISO-8859-1 для запросов и сообщений. Кодировки записей в форматах MARC21/USMARC не затрагиваются данной опцией.
Целочисленный параметр, определяющий максимальный размер всех записей, возвращаемых сервером при поиске, в байтах. Для более подробной информации смотрите стандарт » Z39.50.
Замечание:
Опция поддерживается в версии PECL YAZ 1.0.5 и более поздних.
Целочисленный параметр, определяющий максимальное количество байт в отдельной записи, возвращаемой сервером в результате поиска. Данный параметр относится к Exceptional-record-size в стандарте » Z39.50.
Замечание:
Опция поддерживается в версии PECL YAZ 1.0.5 и более поздних.
Функция возвращает дескриптор соединения в случае успешного выполнения
или false
, если возникла ошибка.