ibase_pconnect
(PHP 4, PHP 5)
ibase_pconnect — Ouvre une connexion persistante � une base de donn�es InterBase
Description
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'.
Liste de param�tres
- 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
-
Valeurs de retour
Retourne un identifiant de connexion InterBase en cas de succ�s, ou FALSE si une erreur survient.
Historique
Version | Description |
---|---|
4.0.0 | Les param�tres buffers , dialect et role ont �t� ajout�s |
Voir aussi
- ibase_close() - Ferme une connexion � une base de donn�es Interbase
- ibase_connect() - Ouvre une connexion � une base de donn�es InterBase