array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.yaz-connect.php', 1 => 'yaz_connect', 2 => 'Подготавливает соединение с сервером Z39.50', ), 'up' => array ( 0 => 'ref.yaz.php', 1 => 'Функции YAZ', ), 'prev' => array ( 0 => 'function.yaz-close.php', 1 => 'yaz_close', ), 'next' => array ( 0 => 'function.yaz-database.php', 1 => 'yaz_database', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/yaz/functions/yaz-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

yaz_connect

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

yaz_connect — Подготавливает соединение с сервером 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, если возникла ошибка.

Смотрите также