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)
