(PHP 5, PHP 7, PHP 8)
pg_parameter_status — Consulte un paramètre de configuration courant du serveur
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.
connection
Une instance PgSql\Connection.
Quand connection est pas spécifié, la connexion par défaut est utilisé.
La connexion par défaut est la dernière connexion faite par
pg_connect() ou pg_pconnect()
À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.
param_name
Les valeurs possibles de param_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.
Une chaîne contenant la valeur du paramètre, false en cas d'échec ou
du paramètre param_name invalide.
| Version | Description |
|---|---|
| 8.1.0 |
Le paramètre connection attend désormais une instance de
PgSql\Connection ; auparavant, une resource était attendu.
|
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