(PHP 5, PHP 7, PHP 8)
pg_parameter_status — Procura uma configuração de parâmetro atual do servidor
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.
connectionUma 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().
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.
Uma string contendo o valor do parâmetro, false em caso de falha ou
param_name inválido.
| Versão | Descrição |
|---|---|
| 8.1.0 |
O parâmetro connection agora espera uma instância de PgSql\Connection;
anteriormente, um resource era esperado.
|
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