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

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.

Note:

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().

Warning

A partir do PHP 8.1.0, usar a conexão padrão tornou-se defasado.

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

Example #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