(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
。