php man page for ifx_pconnect

IFX_PCONNECT(3) 							 1							   IFX_PCONNECT(3)

ifx_pconnect - Open persistent Informix connection

SYNOPSIS
       resource ifx_pconnect ([string  $database], [string  $userid], [string  $password])

DESCRIPTION
       ifx_pconnect(3) acts very much like ifx_connect(3) with two major differences.

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

	Second, the connection to the SQL server will not be closed when the execution of the script ends. Instead, the link will remain open  for
       future use (ifx_close(3) will not close links established by ifx_pconnect(3)).

	This type of links is therefore called 'persistent'.

PARAMETERS
	All  of  the  arguments are optional, and if they're missing, defaults are taken from values supplied in php.ini (ifx.default_host for the
       host (Informix libraries will use INFORMIXSERVER environment value if not defined), ifx.default_user for user, ifx.default_password for the
       password (none if not defined).

	      o $database
		- The database name, as a string.

	      o $userid
		- The username, as a string.

	      o $password
		- The password, as a string.

RETURN VALUES
	Returns: valid Informix persistent link identifier on success, or FALSE on errors.

SEE ALSO
       ifx_connect(3).

PHP Documentation Group 													   IFX_PCONNECT(3)