pg_connect
(PHP 4, PHP 5)
pg_connect — �tablit une connexion PostgreSQL
Description
pg_connect() ouvre une connexion � une base de donn�es PostgreSQL gr�ce � la cha�ne de connexion connection_string .
Si un deuxi�me appel � pg_connect() est fait avec les m�mes arguments, aucune nouvelle connexion ne sera �tablie tant que vous passerez PGSQL_CONNECT_FORCE_NEW � connect_type , mais la connexion pr�c�dente sera retourn�e.
L'ancienne syntaxe $conn = pg_connect("host", "port", "options", "tty", "dbname") est obsol�te.
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_connect()
<?php
$dbconn = pg_connect("dbname=marie");
// connexion � une base de donn�es nomm�e "marie"
$dbconn2 = pg_connect("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_connect("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_connect($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
?>
Voir aussi
- pg_pconnect() - �tablit une connexion PostgreSQL persistante
- pg_close() - Termine une connexion PostgreSQL
- pg_host() - Retourne le nom d'h�te
- pg_port() - Retourne le num�ro de port
- pg_tty() - Retourne le nom de TTY associ� � la connexion
- pg_options() - Retourne les options PostgreSQL
- pg_dbname() - Retourne le nom de la base de donn�es PostgreSQL