pg_parameter_status

(PHP 5, PHP 7)

pg_parameter_status - 查找服务器的当前参数设置。

描述

string pg_parameter_status ([ resource $connection ], string $param_name )

查找服务器的当前参数设置。

某些参数值由服务器在连接启动时或者其值发生更改时自动报告。可以使用pg_parameter_status（）来询问这些设置。它返回参数的当前值（如果已知），或者FALSE参数未知。

从PostgreSQL 8.0报告的参数包括server_version，server_encoding，client_encoding，is_superuser，session_authorization，DateStyle，TimeZone和integer_datetimes。（server_encoding，TimeZone和integer_datetimes在8.0之前未被发布。）请注意，PostgreSQL启动后server_version，server_encoding和integer_datetimes不能更改。

PostgreSQL 7.3或更低版本的服务器不报告参数设置，pg_parameter_status（）包含获取server_version和client_encoding值的逻辑。鼓励应用程序使用pg_parameter_status（）而不是专用代码来确定这些值。

警告

在7.4之前的PostgreSQL服务器上，连接启动后通过SET更改client_encoding不会被pg_parameter_status（）反映出来。

参数

connection

PostgreSQL数据库连接资源。如果connection不存在，则使用默认连接。默认连接是pg_connect（）或pg_pconnect（）所做的最后一个连接。

param_name

可能的param_name值包括server_version，server_encoding，client_encoding，is_superuser，session_authorization，DateStyle，TimeZone和integer_datetimes。

返回值

包含参数值的字符串，FALSE失败或无效param_name。

例子

Example #1 pg_parameter_status() example

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

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

上面的例子将输出：

Server encoding: SQL_ASCII

← pg_options

pg_pconnect →