Setzt die Kodierung des Clients

# 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

function pg_set_client_encoding(PgSql\Connection `$connection` = ?, string `$encoding`): int

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.

  Warnung

  Seit 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` or `WIN1250`.

  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";
    }

    ?>

### Siehe auch

- pg_client_encoding() - Liefert die Kodierung des Clients

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open