array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.pg-parameter-status.php', 1 => 'pg_parameter_status', 2 => 'Procura uma configuração de parâmetro atual do servidor', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Funções PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-options.php', 1 => 'pg_options', ), 'next' => array ( 0 => 'function.pg-pconnect.php', 1 => 'pg_pconnect', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pgsql/functions/pg-parameter-status.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_parameter_status

(PHP 5, PHP 7, PHP 8)

pg_parameter_status — Procura uma configuração de parâmetro atual do servidor

Descrição

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

Procura uma configuração de parâmetro atual do servidor.

Certos valores de parâmetros são reportados automaticamente pelo servidor na inicialização da conexão ou sempre que seus valores mudam. pg_parameter_status() pode ser usado para interrogar essas configurações. Ele retorna o valor atual de um parâmetro, se conhecido, ou false se o parâmetro não for conhecido.

Os parâmetros relatados pelo servidor incluem server_version, server_encoding, client_encoding, is_superuser, session_authorization, DateStyle, TimeZone e integer_datetimes. Observe que server_version, server_encoding e integer_datetimes não podem ser alterados após a inicialização do PostgreSQL.

Parâmetros

connection

Uma instância de PgSql\Connection. Quando o parâmetro connection não for especificado, a conexão padrão será usada. A conexão padrão é a última conexão feita por pg_connect() ou pg_pconnect().

Aviso

A partir do PHP 8.1.0, usar a conexão padrão foi descontinuado.

param_name

Os possíveis valores de param_name incluem server_version, server_encoding, client_encoding, is_superuser, session_authorization, DateStyle, TimeZone e integer_datetimes. Observe que esse valor diferencia maiúsculas de minúsculas.

Valor Retornado

Uma string contendo o valor do parâmetro, false em caso de falha ou param_name inválido.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro connection agora espera uma instância de PgSql\Connection; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de pg_parameter_status()

<?php
$dbconn = pg_connect("dbname=publisher") or die("Não foi possível conectar");

echo "Codificação de servidor: ", pg_parameter_status($dbconn, "server_encoding");
?>

O exemplo acima produzirá:

Codificação de servidor: SQL_ASCII