pg_connect

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

pg_connect — PostgreSQL 연결 열기


설명

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

pg_connect()connection_string에 의해 지정된 PostgreSQL 데이터베이스에 대한 연결을 엽니다.

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

여러 매개변수 $conn = pg_connect("host", "port", "options", "tty", "dbname")가 있는 이전 구문은 더 이상 사용되지 않습니다.


매개변수

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

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

options 매개변수는 서버에서 호출할 명령줄 매개변수를 설정하는 데 사용할 수 있습니다.

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

PGSQL_CONNECT_ASYNC가 제공되면 연결이 비동기적으로 설정됩니다. 연결 상태는 pg_connect_poll() 또는 pg_connection_status()를 통해 확인할 수 있습니다.


반환 값

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


변경 로그

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

Examples

예제 #1 Using pg_connect()

                  
<?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

$dbconn5 = pg_connect("host=localhost options='--client_encoding=UTF8'");
//connect to a database on "localhost" and set the command line parameter which tells the encoding is in UTF-8
?>
                  
                

기타

  • pg_pconnect() - 영구 PostgreSQL 연결 열기
  • pg_close() - PostgreSQL 연결을 닫습니다
  • pg_host() - 연결과 관련된 호스트 이름을 반환합니다.
  • pg_port() - 연결과 관련된 포트 번호를 반환합니다.
  • pg_tty() - 연결과 관련된 TTY 이름을 반환합니다.
  • pg_options() - 연결과 관련된 옵션 가져오기
  • pg_dbname() - 데이터베이스 이름 가져오기