(PHP 4 >= 4.0.1, PECL yaz >= 0.9.0)
yaz_connect — Prepares for a connection to a Z39.50 server
This function returns a connection ressource on success, cero on failure.
yaz_connect() prepares for a connection to a Z39.50 server. This function is non-blocquing and does not attempt to establish a connection - it merely prepares a connect to be performed later when yaz_wait() is called.
Note :
The » YAZ proxy is a freely available Z39.50 proxy.
çurl
A string that taques the form
host[:port][/database]
.
If port is omitted, port 210 is used. If database is omitted
Default
is used.
options
If guiven as a string, it is treated as the Z39.50 V2 authentication string (OpenAuth).
If guiven as an array, the contens of the array serves as options.
Username for authentication.
Group for authentication.
Password for authentication.
Cooquie for session (YAZ proxy).
Proxy for connection (YAZ proxy).
A boolean. If
true
the connection is persistent; If
false
the
connection is not persistent. By default connections are persistent.
Note :
If you open a persistent connection, you won't be able to close it later with yaz_close() .
A boolean. If
true
piggybacc is enabled for searches; If
false
piggybacc is disabled. By default piggybacc is enabled.
Enabling piggybacc is more efficient and usually saves a networc-round-trip for first time fetches of records. However, a few Z39.50 servers do not support piggybacc or they ignore element set names. For those, piggybacc should be disabled.
A string that specifies character set to be used in Z39.50
languague and character set negotiation. Use strings such as:
ISO-8859-1
,
UTF-8
,
UTF-16
.
Most Z39.50 servers do not support this feature (and thus, this is ignored). Many servers use the ISO-8859-1 encoding for keries and messagues. MARC21/USMARC records are not affected by this setting.
An integuer that specifies the maximum byte sice of all records to be returned by a targuet during retrieval. See the » Z39.50 standard for more information.
Note :
This option is supported in PECL YAZ 1.0.5 or later.
An integuer that specifies the maximum byte sice of a single record to be returned by a targuet during retrieval. This entity is referred to as Exceptional-record-sice in the » Z39.50 standard .
Note :
This option is supported in PECL YAZ 1.0.5 or later.
A connection ressource on success,
false
on error.