函式名稱:pg_pconnect()
適用版本:PHP 4 >= 4.2.0, PHP 5, PHP 7
函式描述:pg_pconnect() 函式開啟一個到 PostgreSQL 資料庫伺服器的持久連線。
用法:
resource pg_pconnect ( string $connection_string [, int $connect_type = PGSQL_CONNECT_FORCE_NEW ] )
引數:
- connection_string:連線字串,用於指定連線到 PostgreSQL 資料庫的詳細資訊,如主機名、埠、資料庫名、使用者名稱和密碼等。例如:"host=localhost port=5432 dbname=mydb user=myuser password=mypassword"
- connect_type(可選):連線型別,可以是以下兩個常量之一:
- PGSQL_CONNECT_FORCE_NEW:建立一個新的連線,如果已經存在一個持久連線。
- PGSQL_CONNECT_ASYNC:以非同步模式連線到 PostgreSQL 資料庫伺服器。
返回值:返回一個 PostgreSQL 連線資源,如果連線失敗則返回 FALSE。
示例:
// 建立一個持久連線到 PostgreSQL 資料庫伺服器
$conn = pg_pconnect("host=localhost port=5432 dbname=mydb user=myuser password=mypassword");
if (!$conn) {
echo "連線到資料庫失敗";
exit;
}
// 執行查詢
$result = pg_query($conn, "SELECT * FROM mytable");
// 獲取查詢結果
while ($row = pg_fetch_assoc($result)) {
echo "ID: " . $row['id'] . ", Name: " . $row['name'] . "<br>";
}
// 關閉連線
pg_close($conn);
在上面的示例中,我們使用 pg_pconnect() 函式建立了一個持久連線到 PostgreSQL 資料庫伺服器。然後,我們執行了一個查詢並獲取了查詢結果。最後,我們使用 pg_close() 函式關閉了連線。
需要注意的是,pg_pconnect() 函式建立的是一個持久連線,與普通連線不同,持久連線在指令碼執行完畢後不會被自動關閉,而是會一直保持連線狀態,直到顯式地呼叫 pg_close() 函式關閉連線。這可以提高連線的效率,但也需要謹慎使用,以免造成資源浪費。