pg_connect

説明

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

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

例 1pg_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() も参照下さい。