Consulte un paramètre de configuration courant du serveur

# pg_parameter_status

(PHP 5, PHP 7, PHP 8)

pg_parameter_status — Consulte un paramètre de configuration courant du serveur

### Description

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

Consulte un paramètre de configuration courant du serveur.

Certaines valeurs de paramètres sont retournées par le serveur automatiquement lors du démarrage de la connexion ou lorsqu'une valeur change. pg_parameter_status() peut être utilisée pour interroger ces configurations. La fonction retourne la valeur courante du paramètre s'il est connu ou `false` si le paramètre est inconnu.

Les paramètres retournés par le serveur sont `server_version`, `server_encoding`, `client_encoding`, `is_superuser`, `session_authorization`, `DateStyle`, `TimeZone` et `integer_datetimes`. Il est à noter que `server_version`, `server_encoding` et `integer_datetimes` ne peuvent changer après le démarrage de PostgreSQL.

### Liste de paramètres

`connection`

  Une instance PgSql\Connection. Quand `connection` n'est pas spécifiée, la connexion par défaut est utilisée. La connexion par défaut est la dernière connexion faite par pg_connect() ou pg_pconnect()

  Avertissement

  À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.

`name`

  Les valeurs possibles de `name` sont `server_version`, `server_encoding`, `client_encoding`, `is_superuser`, `session_authorization`, `DateStyle`, `TimeZone` et `integer_datetimes`. Il est à noter que cette valeur est sensible à la casse.

### Valeurs de retour

Une chaîne contenant la valeur du paramètre, `false` en cas d'échec ou du paramètre `name` invalide.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `connection` attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Exemple avec pg_parameter_status()

    <?php
      $dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");

      echo "Encodage du serveur : ", pg_parameter_status($dbconn, "server_encoding");
    ?>

L'exemple ci-dessus va afficher :

    Encodage du serveur : SQL_ASCII

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