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

# yaz_connect

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

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

### Описание

function 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`, если возникла ошибка.

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

- yaz_close() - Закрывает соединение YAZ

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open