pg_connect

(PHP 3, PHP 4 )

pg_connect -- PostgreSQL接続を開く

説明

resource pg_connect ( string connection_string)

pg_connect() は、他のPostgreSQL関数で必要とさ れる接続リソースを返します。

pg_connect() は、 connection_string で指定したPostgreSQLデー タベースへの接続をオープンします。この関数は、成功時に接続リソー スを返します。接続できなかった場合には、 FALSE が返されます。 connection_string は、引用符で括った文字列 とする必要があります。

例 1 pg_connect() の使用法

 ?php
$dbconn = pg_connect ("dbname=mary");
// "mary"という名前のデータベースに接続
$dbconn2 = pg_connect ("host=localhost port=5432 dbname=mary");
// "localhost"のポート"5432"にて"mary"という名前のデータベースに接続
$dbconn3 = pg_connect ("host=sheep port=5432 dbname=mary user=lamb
password=baaaa");
// ユーザ名とパスワードを指定してホスト"sheep"上の"mary"という名前のデー
// タベースに接続
$conn_string = "host=sheep port=5432 dbname=test user=lamb
password=bar";
$dbconn4 = pg_connect ($conn_string);
// ユーザ名とパスワードを指定してホスト"sheep"上の"test"という名前のデー
// タベースへ接続
? 
connection_string で利用可能な引数には、 dbname , port , host , tty , options , user , password が含まれます。

同じ connection_string 引数で2回 pg_connect() 関数がコールされた場合、新規の接続 はオープンされません。代わりに既にオープンされている接続リソース が返されます。異なる接続パラメータ(すなわち別のユーザ名)を使用す る場合には、同じデータベースに対して複数の接続をオープンすること が可能です。

複数のパラメータをサポートする構文: $conn = pg_connect ("host", "port", "options", "tty", "dbname") は過去のものであり、推奨されません。

pg_pconnect() , pg_close() , pg_host() , pg_port() , pg_tty() , pg_options() , pg_dbname() も参照下さい。