pg_parameter_status

(PHP 5, PHP 7, PHP 8)

pg_parameter_status — 서버의 현재 매개변수 설정 조회


설명

pg_parameter_status(PgSql\Connection $connection = ?, string $param_name): string

서버의 현재 매개변수 설정을 조회합니다.

특정 매개변수 값은 연결 시작 시 또는 값이 변경될 때마다 서버에서 자동으로 보고합니다. pg_parameter_status()를 사용하여 이러한 설정을 조사할 수 있습니다. 알려진 경우 매개변수의 현재 값을 반환하고 매개변수를 모르는 경우 false를 반환합니다.

PostgreSQL 8.0부터 보고되는 매개변수에는 server_version, server_encoding, client_encoding, is_superuser, session_authorization, DateStyle, TimeZoneinteger_datetimes가 포함됩니다. (server_encoding, TimeZoneinteger_datetimes는 8.0 이전 릴리스에서 보고되지 않았습니다.) server_version, server_encodinginteger_datetimes 는 PostgreSQL 시작 후에 변경할 수 없습니다.

주의: 7.4 이전 PostgreSQL 서버에서 연결 시작 후 SET를 통한 client_encoding 변경은 pg_parameter_status()에 반영되지 않습니다.


매개변수

connection
PgSql\Connection 인스턴스. connection을 지정하지 않으면 기본 연결이 사용됩니다. 기본 연결은 pg_connect() 또는 pg_pconnect()에 의해 만들어진 마지막 연결입니다.
param_name
가능한 param_name 값에는 server_version, server_encoding, client_encoding, is_superuser, session_authorization, DateStyle, TimeZoneinteger_datetimes이 포함됩니다. 이 값은 대소문자를 구분합니다.

반환 값

매개변수 값을 포함하는 문자열, 실패 시 false 또는 잘못된 param_name.


변경 로그

버전 설명
8.1.0 connection 매개변수는 이제 PgSql\Connection 인스턴스를 필요로 합니다. 이전에는 resource가 필요했습니다.

Examples

예제 #1 pg_parameter_status() 예제

                  
<?php
  $dbconn = pg_connect("dbname=publisher") or die("Could not connect");

  echo "Server encoding: ", pg_parameter_status($dbconn, "server_encoding");
?>
                  
                

위의 예는 다음을 출력합니다.

Server encoding: SQL_ASCII