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

yaz_connect

(PHP 4 >= 4.0.1)

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

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.



add a note add a note User Contributed Notes
yaz_connect
Byron
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 ....

yaz_close($id);

<yaz_closeyaz_database>
 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: http://php.mirrors.ilisys.com.au/
Last updated: Sat 01 Nov 2003 04:13:36 EST EST