pg_pconnect
(PHP 4, PHP 5)
pg_pconnect — �tablit une connexion PostgreSQL persistante
Description
pg_pconnect() retourne une ressource de connexion persistante en cas de succ�s, ou FALSE en cas d'erreur.
Si un second appel est fait � pg_pconenct() avec le m�me connection_string comme �tant une connexion existante, la connexion existante sera retourn�e � moins que vous ne passez PGSQL_CONNECT_FORCE_NEW � connect_type .
Pour activer les connexions persistantes, la directive de configuration pgsql.allow_persistent du php.ini doit �tre mise � "On" (ce qui est sa valeur par d�faut). Le nombre maximal de connexions peut �tre limit� gr�ce � la directive de configuration pgsql.max_persistent dans le fichier php.ini (par d�faut, elle vaut -1, c'est � dire pas de limite). Le nombre total de connexions peut �tre configur� avec la directive pgsql.max_links du fichier php.ini.
pg_close() ne refermera pas les connexions persistantes g�n�r�es par pg_pconnect().
Liste de param�tres
- connection_string
-
La cha�ne connection_string peut �tre vide pour utiliser tous les param�tres par d�faut ou elle peut contenir un ou plusieurs param�tres de configuration s�par�s par des espaces. Chaque param�tre de configuration est sous la forme code = valeur. Les espaces autour du signe �gal sont optionnels. Pour �crire une valeur vide ou une valeur contenant des espaces, entourez cette valeur avec des apostrophes, par exemple : code = 'une valeur'. Les apostrophes et les antislashs � l'int�rieur de la valeur doivent �tre �chapp�s par un antislash, c'est-�-dire \' et \\.
Les mots-cl� actuellement reconnus sont : host , hostaddr , port , dbname , user , password , connect_timeout , options , tty (ignor�), sslmode , requiressl (obsol�te, utilisez sslmode ) et service . La liste de ces arguments d�pend de la version de votre serveur PostgreSQL.
- connect_type
-
Si PGSQL_CONNECT_FORCE_NEW est pass� en argument, alors une nouvelle connexion sera cr��e, m�me si la cha�ne connection_string est identique � celle de la connexion existante.
Valeurs de retour
Ressource de connexion PostgreSQL en cas de succ�s, FALSE en cas d'�chec.
Exemples
Exemple #1 Exemple avec pg_pconnect()
<?php
$dbconn = pg_pconnect("dbname=marie");
// connexion � une base de donn�es nomm�e "marie"
$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=marie");
// connexion � une base de donn�es nomm�e "marie" sur l'h�te "localhost" sur le port "5432"
$dbconn3 = pg_pconnect("host=mouton port=5432 dbname=marie user=agneau password=foo");
// connexion � une base de donn�es nomm�e "marie" sur l'h�te "mouton" avec un
// nom d'utilisateur et un mot de passe
$conn_string = "host=mouton port=5432 dbname=test user=agneau password=bar";
$dbconn4 = pg_pconnect($conn_string);
// connexion � une base de donn�es nomm�e "test" sur l'h�te "mouton" avec un
// nom d'utilisateur et un mot de passe
?>