2024年PHP开发者大会日本站

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

参见

添加注释

用户贡献的注释

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