yaz_connect

(PHP 4 >= 4.0.1, PECL yaz >= 0.9.0)

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


Описание

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

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

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 при ошибке.




Смотрите также:
Описание на ru2.php.net
Описание на php.ru