CascadiaPHP 2024

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.

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

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

add a note

User Contributed Notes 1 note

up
-25
Anonymous
23 years ago
pg_query($connection, "set client_encoding to '$encoding'") can be used instead.
To Top