array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.pg-parameter-status.php', 1 => 'pg_parameter_status', 2 => 'Consulte un paramètre de configuration courant du serveur', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'pg_cancel_query', ), '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' => 'fr', '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 — Consulte un paramètre de configuration courant du serveur

Description

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 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()

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