pg_set_client_encoding
(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)
pg_set_client_encoding — Setzt die Kodierung des Clients
Beschreibung
pg_set_client_encoding() setzt die Kodierung des Clients und gibt bei Erfolg 0 zurück, anderenfalls -1.
PostgreSQL konvertiert Daten automatisch aus der Kodierung des Backends in die des Frontends.
Hinweis:
Diese Funktion ersetzt die Funktion pg_setclientencoding().
Parameter-Liste
-
connection
-
Eine PgSql\Connection-Instanz. Falls
connection
nicht angegeben wurde, wird die Standardverbindung benutzt. Das ist die zuletzt mit pg_connect() oder pg_pconnect() aufgebaute Verbindung.WarnungSeit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.
-
encoding
-
Die gewünschte Kodierung des Clients. Sie können aus den folgenden Kodierungen wählen:
SQL_ASCII
,EUC_JP
,EUC_CN
,EUC_KR
,EUC_TW
,UNICODE
,MULE_INTERNAL
,LATINX
(X=1...9),KOI8
,WIN
,ALT
,SJIS
,BIG5
orWIN1250
.Welche Kodierungen genau verfügbar sind, hängt von der verwendeten PostgreSQL-Version ab. Schauen Sie daher im PostgreSQL-Handbuch, welche Kodierungen unterstützt werden.
Rückgabewerte
Gibt bei Erfolg 0
zurück oder -1
bei einem Fehler.
Changelog
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter connection erwartet nun eine PgSql\Connection-Instanz;
vorher wurde eine Ressource erwartet.
|
Beispiele
Beispiel #1 pg_set_client_encoding() Beispiel
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
// Die Kodierung des Clients wird auf UNICODE gesetzt. Die Daten werden
// automatisch aus der Kodierung des Backends nach UNICODE konvertiert.
pg_set_client_encoding($conn, UNICODE);
$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
// UTF-8 Daten ausgeben
while ($row = pg_fetch_row($result)) {
echo "Autor: $row[0] E-mail: $row[1]";
echo "<br />\n";
}
?>