Establece la codificación del cliente PostgreSQL

# pg_set_client_encoding

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

pg_set_client_encoding — Establece la codificación del cliente PostgreSQL

### Descripción

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

pg_set_client_encoding() establece la codificación del cliente. Devuelve 0 en caso de éxito y -1 en caso de error.

PostgreSQL convertirá automáticamente los datos de la codificación de la base de datos a la codificación del cliente.

> Nota:

> Anteriormente, esta función se llamaba pg_setclientencoding().

### Parámetros

`connection`

  Una instancia PgSql\Connection. Cuando `connection` no es especificado, se usa la conexión por defecto. La conexión por defecto es la última conexión hecha por pg_connect() o pg_pconnect()

  Advertencia

  Desde PHP 8.1.0, usar la conexión por defecto está obsoleto.

`encoding`

  La codificación del cliente solicitada. Una de estas constantes: `SQL_ASCII`, `EUC_JP`, `EUC_CN`, `EUC_KR`, `EUC_TW`, `UNICODE`, `MULE_INTERNAL`, `LATINX` (X=1...9), `KOI8`, `WIN`, `ALT`, `SJIS`, `BIG5` o `WIN1250`.

  La lista exacta de codificaciones disponibles depende de la versión de PostgreSQL, por lo que se debe consultar el manual de PostgreSQL para obtener una lista más específica.

### Valores devueltos

Devuelve `0` en caso de éxito o `-1` en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | El parámetro `connection` ahora espera una instancia de PgSql\Connection ; anteriormente, se esperaba un resource.

### Ejemplos

Ejemplo #1 Ejemplo con pg_set_client_encoding()

    <?php

    $conn = pg_pconnect("dbname=editeur");
    if (!$conn) {
      echo "Se ha producido un error.\n";
      exit;
    }

    // Establece la codificación del cliente a UNICODE. Los datos se convertirán automáticamente
    // de la codificación del servidor a la codificación del cliente.
    pg_set_client_encoding($conn, "UNICODE");

    $result = pg_query($conn, "SELECT autor, email FROM autores");
    if (!$result) {
      echo "Se ha producido un error.\n";
      exit;
    }

    // Escritura de datos UTF-8
    while ($row = pg_fetch_row($result)) {
      echo "Autor: $row[0]  E-mail: $row[1]";
      echo "<br />\n";
    }

    ?>

### Ver también

- pg_client_encoding() - Lee la codificación del cliente

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