Подготавливает соединение с сервером Z39.50

Описание

yaz_connect ( string $zurl [, mixed $options ] ) : mixed

Функция возвращает дескриптор соединения в случае успеха и ноль в случае ошибки.

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_close() - Закрывает соединение YAZ