downloads | documentation | faq | getting help | mailing lists | reporting bugs | sites | links | my 
search for in the  
view the version of this page
Last updated: Thu, 21 Aug 2003


(PHP 4 >= 4.0.1)

yaz_connect --  Prepares for a connection to a Z39.50 target (server).


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


Username for authentication.


Group for authentication.


Password for authentication.


Cookie 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.


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.

add a note add a note User Contributed Notes
07-Aug-2003 06:29
If you had to close connection use persistent = FALSE so yaz_close really close connection:

$id = yaz_connect($host,array("user" => "your_user", "password" =>"your_password","persistent" => false, 'piggyback' => false));

some code ....


 Last updated: Thu, 21 Aug 2003
show source | credits | sitemap | mirror sites 
Copyright © 2001-2003 The PHP Group
All rights reserved.
This mirror generously provided by:
Last updated: Sat 01 Nov 2003 04:13:36 EST EST