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)