pg_connect
(PHP 4, PHP 5)
pg_connect — 打开一个 PostgreSQL 连接
<h3>说明</h3>
resource <strong>pg_connect</strong>
( string <code>$connection_string</code>
)
<p>
<strong>pg_connect()</strong> 返回其它 PostgreSQL 函数所需要的资源。
</p>
<p>
<strong>pg_connect()</strong> 打开一个由
<code>connection_string</code> 所指定的
PostgreSQL 数据库的连接。如果成功则返回连接资源,如果不能连接则返回
<strong><code>FALSE</code></strong>。<code>connection_string</code> 应该是用引号引起来的字符串。
<p><strong>Example #1 使用 <strong>pg_connect()</strong></strong></p>
<?php
$dbconn = pg_connect("dbname=mary");
//connect to a database named "mary"
$dbconn2 = pg_connect("host=localhost port=5432 dbname=mary");
// connect to a database named "mary" on "localhost" at port "5432"
$dbconn3 = pg_connect("host=sheep port=5432 dbname=mary user=lamb password=foo");
//connect to a database named "mary" on the host "sheep" with a username and password
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
$dbconn4 = pg_connect($conn_string);
//connect to a database named "test" on the host "sheep" with a username and password
?>
<code>connection_string</code> 所包括的参数有
<code>host</code>,<code>port</code>,<code>tty</code>, <code>options</code>,<code>dbname</code>, <code>user</code>
和 <code>password</code>。
</p>
<p>
如果用同样的 <code>connection_string</code> 再次调用
<strong>pg_connect()</strong>,不会建立新连接,而是返回前面已经打开的连接资源。如果使用不同的连接字符串,则可以和同一个数据库建立多个连接。
</p>
<p>
旧的多参数语法 <strong>$conn = pg_connect("host", "port", "options", "tty", "dbname")</strong> 已经不提倡使用。
</p>
<p>
参见 pg_pconnect(),pg_close(),pg_host(),pg_port(), pg_tty(),pg_options()
和 pg_dbname()。
</p>