Define a codificação do cliente

# pg_set_client_encoding

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

pg_set_client_encoding — Define a codificação do cliente

### Descrição

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

pg_set_client_encoding() define a codificação do cliente e retorna 0 em caso de sucesso ou -1 em caso de erro.

O PostgreSQL converterá automaticamente os dados da codificação do banco de dados backend na codificação frontend.

> Nota:

> A função costumava ser chamada de pg_setclientencoding().

### Parâmetros

`connection`

  Uma instância de PgSql\Connection. Quando o parâmetro `connection` não for especificado, a conexão padrão será usada. A conexão padrão é a última conexão feita por pg_connect() ou pg_pconnect().

  Aviso

  A partir do PHP 8.1.0, usar a conexão padrão foi descontinuado.

`encoding`

  A codificação do cliente necessária. Um de `SQL_ASCII`, `EUC_JP`, `EUC_CN`, `EUC_KR`, `EUC_TW`, `UNICODE`, `MULE_INTERNAL`, `LATINX` (X=1...9), `KOI8`, `WIN` , `ALT`, `SJIS`, `BIG5` ou `WIN1250`.

  A lista exata de codificações disponíveis depende da sua versão do PostgreSQL, portanto verifique o manual do PostgreSQL para obter uma lista mais específica.

### Valor Retornado

Retorna `0` em caso de sucesso ou `-1` em caso de erro.

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `connection` agora espera uma instância de PgSql\Connection; anteriormente, um resource era esperado.

### Exemplos

Exemplo #1 Exemplo de pg_set_client_encoding()

    <?php

    $conn = pg_pconnect("dbname=publisher");
    if (!$conn) {
      echo "An error occurred.\n";
      exit;
    }

    // Define a codificação do cliente como UNICODE. Os dados serão automaticamente
    // convertidos da codificação de backend para frontend.
    pg_set_client_encoding($conn, "UNICODE");

    $result = pg_query($conn, "SELECT author, email FROM authors");
    if (!$result) {
      echo "An error occurred.\n";
      exit;
    }

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

    ?>

### Veja Também

- pg_client_encoding() - Obtém a codificação do cliente

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