(PHP 4 >= 4.0.1, PECL yaz >= 0.9.0)
yaz_connect — 为连接到 Z39.50 服务器做准备
此函数在成功时返回连接资源,失败时返回零。
yaz_connect() 为连接到 Z39.50 服务器做准备。此函数是非阻塞的,不会尝试建立连接 - 它只是准备稍后在调用 yaz_wait() 时执行连接。
注意:
» YAZ 代理 是一个免费提供的 Z39.50 代理。
zurl
一个字符串,格式为 host[:port][/database]
。如果省略端口,则使用端口 210。如果省略数据库,则使用 Default
。
options
如果作为字符串给出,则将其视为 Z39.50 V2 身份验证字符串(OpenAuth)。
如果作为数组给出,则数组的内容将用作选项。
用于身份验证的用户名。
用于身份验证的组。
用于身份验证的密码。
会话的 Cookie(YAZ 代理)。
用于连接的代理(YAZ 代理)。
布尔值。如果为 true
,则连接为持久连接;如果为 false
,则连接为非持久连接。默认情况下,连接为持久连接。
注意:
如果您打开了一个持久连接,您将无法使用 yaz_close() 在以后关闭它。
布尔值。如果为 true
,则为搜索启用 piggyback;如果为 false
,则禁用 piggyback。默认情况下,piggyback 已启用。
启用 piggyback 更有效,通常可以节省第一次获取记录的网络往返。但是,一些 Z39.50 服务器不支持 piggyback 或它们忽略元素集名称。对于这些服务器,应禁用 piggyback。
一个字符串,指定在 Z39.50 语言和字符集协商中使用的字符集。使用以下字符串:ISO-8859-1
、UTF-8
、UTF-16
。
大多数 Z39.50 服务器不支持此功能(因此,它将被忽略)。许多服务器使用 ISO-8859-1 编码进行查询和消息。MARC21/USMARC 记录不受此设置的影响。
一个整数,指定目标在检索期间返回的所有记录的最大字节大小。有关更多信息,请参见 » Z39.50 标准。
注意:
此选项在 PECL YAZ 1.0.5 或更高版本中受支持。
一个整数,指定目标在检索期间返回的单个记录的最大字节大小。此实体在 » Z39.50 标准 中称为 Exceptional-record-size。
注意:
此选项在 PECL YAZ 1.0.5 或更高版本中受支持。
成功时返回连接资源,错误时返回 false
。
版本 | 描述 |
---|---|
4.1.0 | 添加了参数 options 。 |