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 代理 是一个免费提供的 Z39.50 代理。

参数

zurl

一个字符串,格式为 host[:port][/database]。如果省略端口,则使用端口 210。如果省略数据库,则使用 Default

options

如果作为字符串给出,则将其视为 Z39.50 V2 身份验证字符串(OpenAuth)。

如果作为数组给出,则数组的内容将用作选项。

user

用于身份验证的用户名。

group

用于身份验证的组。

password

用于身份验证的密码。

cookie

会话的 Cookie(YAZ 代理)。

proxy

用于连接的代理(YAZ 代理)。

persistent

布尔值。如果为 true,则连接为持久连接;如果为 false,则连接为非持久连接。默认情况下,连接为持久连接。

注意:

如果您打开了一个持久连接,您将无法使用 yaz_close() 在以后关闭它。

piggyback

布尔值。如果为 true,则为搜索启用 piggyback;如果为 false,则禁用 piggyback。默认情况下,piggyback 已启用。

启用 piggyback 更有效,通常可以节省第一次获取记录的网络往返。但是,一些 Z39.50 服务器不支持 piggyback 或它们忽略元素集名称。对于这些服务器,应禁用 piggyback。

charset

一个字符串,指定在 Z39.50 语言和字符集协商中使用的字符集。使用以下字符串:ISO-8859-1UTF-8UTF-16

大多数 Z39.50 服务器不支持此功能(因此,它将被忽略)。许多服务器使用 ISO-8859-1 编码进行查询和消息。MARC21/USMARC 记录不受此设置的影响。

preferredMessageSize

一个整数,指定目标在检索期间返回的所有记录的最大字节大小。有关更多信息,请参见 » Z39.50 标准

注意:

此选项在 PECL YAZ 1.0.5 或更高版本中受支持。

maximumRecordSize

一个整数,指定目标在检索期间返回的单个记录的最大字节大小。此实体在 » Z39.50 标准 中称为 Exceptional-record-size。

注意:

此选项在 PECL YAZ 1.0.5 或更高版本中受支持。

返回值

成功时返回连接资源,错误时返回 false

变更日志

版本 描述
4.1.0 添加了参数 options

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top