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

# pg_parameter_status

(PHP 5, PHP 7, PHP 8)

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

### Descrição

function pg_parameter_status(PgSql\Connection `$connection` = ?, string `$name`): string|false

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.

`name`

  Os possíveis valores de `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 `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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open