(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]
的字串。如果省略 port,則使用端口 210。如果省略 database,則使用 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
。