pg_pconnect

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_pconnect — 영구 PostgreSQL 연결 열기


설명

pg_pconnect(string $connection_string, int $flags = 0): PgSql\Connection|false

pg_pconnect()는 PostgreSQL 데이터베이스에 대한 연결을 엽니다. 다른 PostgreSQL 함수에 필요한 PgSql\Connection 인스턴스를 반환합니다.

기존 연결과 동일한 connection_string으로 pg_pconnect()를 두 번째 호출하면 PGSQL_CONNECT_FORCE_NEWflags로 전달하지 않는 한 기존 연결이 반환됩니다.

영구 연결을 활성화하려면 pgsql.allow_persistent php.ini 지시문을 "On"(기본값)로 설정해야 합니다. 최대 영구 연결 수는 pgsql.max_persistent php.ini 지시문으로 정의할 수 있습니다(기본값은 -1로 제한 없음). 총 연결 수는 pgsql.max_links php.ini 지시문으로 설정할 수 있습니다.

pg_close()pg_pconnect()에 의해 생성된 영구 링크를 닫지 않습니다.


매개변수

connection_string
connection_string은 모든 기본 매개변수를 사용하기 위해 비어 있거나 공백으로 구분된 하나 이상의 매개변수 설정을 포함할 수 있습니다. 각 매개변수 설정은 keyword = value 형식입니다. 등호 주위의 공백은 선택 사항입니다. 빈 값이나 공백이 포함된 값을 쓰려면 작은따옴표로 묶습니다(예: keyword = 'a value'). 값 내의 작은따옴표와 백슬래시는 백슬래시(예: \' 및 \\)로 이스케이프되어야 합니다.

현재 인식되는 매개변수 키워드는 host, hostaddr, port, dbname, user, password, connect_timeout, options, tty(무시됨), sslmode, requiresl(sslmode 대신 사용되지 않음) 및 service입니다. 존재하는 인수는 PostgreSQL 버전에 따라 다릅니다.

flags
PGSQL_CONNECT_FORCE_NEW가 전달되면 connection_string이 기존 연결과 동일하더라도 새 연결이 생성됩니다.

반환 값

성공하면 PgSql\Connection 인스턴스를 반환하고 실패하면 false를 반환합니다.


변경 로그

버전 설명
8.1.0 이제 PgSql\Connection 인스턴스를 반환합니다. 이전에는 resource가 반환되었습니다.

Examples

예제 #1 pg_pconnect() 사용

                  
<?php
$dbconn = pg_pconnect("dbname=mary");
//connect to a database named "mary"

$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=mary");
// connect to a database named "mary" on "localhost" at port "5432"

$dbconn3 = pg_pconnect("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_pconnect($conn_string);
//connect to a database named "test" on the host "sheep" with a username and password
?>
                  
                

기타