yaz_connect
Description
resource yaz_connect ( string zurl [, mixed options])This function returns a connection resource on success;, zero on failure.
yaz_connect() prepares for a connection to a Z39.50 target. The zurl argument takes the form host[:port][/database]. If port is omitted 210 is used. If database is omitted Default is used. This function is non-blocking and does not attempt to establish a socket - it merely prepares a connect to be performed later when yaz_wait() is called.
If the second argument, options, is given as a string it is treated as the Z39.50 V2 authentication string (OpenAuth).
If options is given as an array the contents of the array serves as options. Note that array options are only supported for PHP 4.1.0 and later.
yaz_connect() options
- user
Username for authentication.
- group
Group for authentication.
- password
Password for authentication.
- cookie
Cookie for session (YAZ proxy).
- proxy
Proxy for connection (YAZ proxy).
- persistent
A boolean. If TRUE the connection is persistent; If FALSE the connection is not persistent. By default connections are persistent.
- piggyback
A boolean. If TRUE piggyback is enabled for searches; If FALSE piggyback is disabled. By default piggyback is enabled. Enabling piggyback is more efficient and usually saves a network-round-trip for first time fetches of records. However, a few Z39.50 targets do not support piggyback or they ignore element set names. For those, piggyback should be disabled.
Note: The use of a proxy often improves performance. A Z39.50 proxy is part of the free YAZ++ package.