(PHP 4, PHP 5)
ibase_pconnect — Ouvre une connexion persistante à une base de données InterBase
$database
[, string $username
[, string $password
[, string $charset
[, int $buffers
[, int $dialect
[, string $role
[, int $sync
]]]]]]]] )Ouvre une connexion persistante à une base de données InterBase.
ibase_pconnect() se comporte similairement à ibase_connect(), avec deux différences majeures.
La première est que, lors de la connexion, la fonction va essayer de trouver une connexion (persistante) déjà ouverte. Si elle la trouve, cette dernière sera retournée, plutôt qu'une nouvelle connexion. Sinon, une nouvelle connexion sera ouverte.
La deuxième est que la connexion ne sera pas fermée à la fin du script, mais restera ouverte pour utilisation ultérieure. ( ibase_close() ne fermera pas une connexion ouverte avec ibase_pconnect()). Ce type de lien est alors dit 'persistant'.
database
L'argument database
doit être un chemin valide
vers le fichier de la base de données sur le serveur où il réside. Si
le serveur n'est pas local, il doit être préfixé avec soit 'hostname:'
(TCP/IP), '//hostname/' (NetBEUI) ou 'hostname@' (IPX/SPX), suivant le
protocole utilisé.
username
Le nom d'utilisateur. Peut être défini avec la directive ibase.default_user du php.ini.
password
Le mot de passe pour l'utilisateur username
.
Peut être défini avec la directive
ibase.default_password du php.ini.
charset
charset
est le jeu de caractères par défaut pour
la base de données.
buffers
buffers
est le nombre de buffers de la base de données
à allouer pour le cache côté serveur. Si ce paramètre vaut 0 ou s'il est
omis, le serveur choisira lui-même ce nombre.
dialect
dialect
sélectionne le dialecte SQL par défaut pour
toutes les requêtes exécutées dans la connexion, et vaudra par défaut,
le plus haut supporté par la bibliothèque cliente. Ne fonctionne qu'avec
InterBase 6 et supérieur.
role
Ne fonctionne qu'avec InterBase 5 et supérieur.
sync
Retourne un identifiant de connexion InterBase en cas de succès,
ou FALSE
si une erreur survient.