IBASE_PCONNECT(3)							 1							 IBASE_PCONNECT(3)

ibase_pconnect - Open a persistent connection to an InterBase database

SYNOPSIS

       resource  ibase_pconnect  ([string   $database],  [string   $username],	[string   $password],  [string	 $charset],  [int  $buffers], [int
       $dialect], [string  $role], [int  $sync])

DESCRIPTION

	Opens a persistent connection to an InterBase database.

       ibase_pconnect(3) acts very much like ibase_connect(3) with two major differences.

	First, when connecting, the function will first try to find a (persistent) link that's already opened with the same parameters. If one	is
       found, an identifier for it will be returned instead of opening a new connection.

	Second,  the  connection  to  the InterBase server will not be closed when the execution of the script ends. Instead, the link will remain
       open for future use (ibase_close(3) will not close links established by ibase_pconnect(3)). This type of link is therefore called  'persis-
       tent'.

PARAMETERS

	      o $database
		-  The $database argument has to be a valid path to database file on the server it resides on. If the server is not local, it must
		be prefixed with either 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) or 'hostname@' (IPX/SPX), depending on the connection proto-
		col used.

	      o $username
		- The user name. Can be set with the ibase.default_user php.ini directive.

	      o $password
		- The password for $username. Can be set with the ibase.default_password php.ini directive.

	      o $charset
		-$charset is the default character set for a database.

	      o $buffers
		-$buffers  is  the  number  of	database  buffers  to  allocate for the server-side cache. If 0 or omitted, server chooses its own
		default.

	      o $dialect
		-$dialect selects the default SQL dialect for any statement executed within a connection, and it defaults to the highest one  sup-
		ported by client libraries. Functional only with InterBase 6 and up.

	      o $role
		- Functional only with InterBase 5 and up.

	      o $sync
		-

RETURN VALUES

	Returns an InterBase link identifier on success, or FALSE on error.

SEE ALSO

       ibase_close(3), ibase_connect(3).

PHP Documentation Group 													 IBASE_PCONNECT(3)