(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)
pg_set_client_encoding — Define a codificação do cliente
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().
connectionUma 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().
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.
Retorna 0 em caso de sucesso ou -1 em caso de erro.
| Versão | Descrição |
|---|---|
| 8.1.0 |
O parâmetro connection agora espera uma instância de PgSql\Connection;
anteriormente, um resource era esperado.
|
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";
}
?>