(PHP 5, PHP 7, PHP 8)
pg_parameter_status — Liefert den aktuellen Wert eines Parameters des Servers
Ermittelt die aktuelle Einstellung eines Parameters des Servers.
Bestimmte Servereinstellungen (Parameter) werden beim Verbindungsaufbau
oder, wenn sich ihr Wert ändert, automatich vom Server gemeldet. Mit
pg_parameter_status() können Sie diese Einstellungen
abfragen. Zurückgegeben wird der aktuelle Wert des Parameters, falls dieser
bekannt ist, anderenfalls false.
In PostgreSQL 8.0 werden die Werte für folgende Parameter zurückgegeben:
server_version, server_encoding,
client_encoding, is_superuser,
session_authorization, DateStyle,
TimeZone und integer_datetimes.
(server_encoding, TimeZone und
integer_datetimes werden von PostgreSQL vor 8.0 nicht
zurückgegeben.) Beachten Sie, dass server_version,
server_encoding und integer_datetimes
nach dem Start von PostgreSQL nicht mehr verändert werden können.
PostgreSQL 7.3 oder darunter geben gar keine Servereinstellungen zurück.
pg_parameter_status() kann trotzdem benutzt werden, um
die Werte von server_version und
client_encoding zu ermitteln. Es wird empfohlen, in
Anwendungen pg_parameter_status() zu verwenden, anstatt
speziellen Code zu schreiben, um diese Werte zu erhalten.
In PostgreSQL-Versionen vor 7.4 wird ein nachträgliches (nach dem Start
des Servers) Ändern von client_encoding mit dem
Kommando SET von
pg_parameter_status() ignoriert.
connectionEine PgSql\Connection-Instanz.
Falls connection nicht angegeben wurde, wird die Standardverbindung benutzt.
Das ist die zuletzt mit pg_connect() oder pg_pconnect() aufgebaute Verbindung.
Seit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.
param_name
Mögliche Werte für param_name sind:
server_version, server_encoding,
client_encoding, is_superuser,
session_authorization, DateStyle,
TimeZone und integer_datetimes.
Es ist zu beachten, dass bei diesem Wert zwischen Groß- und
Kleinschreibung unterschieden wird.
Ein string, der den Wert des Parameters enthält, oder false,
falls ein Fehler auftrat oder der Parameter
param_name ungültig ist.
| Version | Beschreibung |
|---|---|
| 8.1.0 |
Der Parameter connection erwartet nun eine PgSql\Connection-Instanz;
vorher wurde eine Ressource erwartet.
|
Beispiel #1 pg_parameter_status()-Beispiel
<?php
$dbconn = pg_connect("dbname=publisher") or die("Verbindungsaufbau fehlgeschlagen");
echo "Server encoding: ", pg_parameter_status($dbconn, "server_encoding");
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Server encoding: SQL_ASCII