ibase_pconnect

(PHP 4, PHP 5)

ibase_pconnectOuvre une connexion persistante � une base de donn�es InterBase

Description

resource ibase_pconnect ([ string $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'.

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