|
8.103.64 pg_parameter_status()
Consulte un paramètre de configuration courant du serveur
[ Exemples avec pg_parameter_status ] PHP 5
string
pg_parameter_status (
resource
connection
,
string
param_name
)
string
pg_parameter_status (
string
param_name
)
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 et connu ou
FALSE
si le paramètre est inconnu.
Les paramètres retournés par PostgreSQL 8.0 sont
server_version
,
server_encoding
,
client_encoding
,
is_superuser
,
session_authorization
,
DateStyle
,
TimeZone
et
integer_datetimes
.
(
server_encoding
,
TimeZone
et
integer_datetimes
n'étaient pas retournés dans les
versions antérieures à 8.0.) Notez que
server_version
,
server_encoding
et
integer_datetimes
ne peuvent changer après le démarrage de PostgreSQL.
Les serveurs PostgreSQL 7.3 ou de versions inférieures ne retournent pas de paramètres de
configurations,
pg_parameter_status
inclue une logique
pour obtenir des valeurs pour
server_version
et
client_encoding
quand même. Les applications devraient
utiliser
pg_parameter_status
au lieu du code ad hoc
pour déterminer ces valeurs.
| Attention | |
Sur les versions des serveurs PostgreSQL pre-7.4, le changement de
client_encoding
avec
SET
après le
démarrage de la connexion ne sera pas réfléchie par
pg_parameter_status
.
|
-
connection
-
La ressource de connexion de la base de données PostgreSQL. Lorsque
connection
n'est pas présent, 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
.
-
param_name
-
Les valeurs possibles de
param_name
sont
server_version
,
server_encoding
,
client_encoding
,
is_superuser
,
session_authorization
,
DateStyle
,
TimeZone
et
integer_datetimes
.
Une chaîne contenant la valeur du paramètre,
FALSE
en cas d'échec ou
du paramètre
param_name
invalide.
| 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");
?>
|
|
