PHP Conference Nagoya 2025

pg_set_client_encoding

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

pg_set_client_encoding Choisit l'encodage du client PostgreSQL

Description

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

pg_set_client_encoding() fixe l'encodage du client. Elle retourne 0 en cas de succès et -1 en cas d'erreur.

PostgreSQL convertira automatiquement les données dans l'encodage de la base de données vers l'encodage du client.

Note:

Auparavant, cette fonction s'appelait pg_setclientencoding().

Liste de paramètres

connection

Une instance PgSql\Connection. Quand connection est pas spécifié, la connexion par défaut est utilisé. La connexion par défaut est la dernière connexion faite par pg_connect() ou pg_pconnect()

Avertissement

À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.

encoding

L'encodage client demandé. Un de ces constantes : SQL_ASCII, EUC_JP, EUC_CN, EUC_KR, EUC_TW, UNICODE, MULE_INTERNAL, LATINX (X=1...9), KOI8, WIN, ALT, SJIS, BIG5 ou WIN1250.

La liste exacte des encodages disponibles dépend de votre version PostgreSQL, alors vérifiez votre manuel PostgreSQL pour une liste plus spécifique.

Valeurs de retour

Retourne 0 en cas de succès ou -1 en cas d'erreur.

Historique

Version Description
8.1.0 Le paramètre connection attend désormais une instance de PgSql\Connection ; auparavant, une ressource était attendu.

Exemples

Exemple #1 Exemple avec pg_set_client_encoding()

<?php

$conn
= pg_pconnect("dbname=editeur");
if (!
$conn) {
echo
"Une erreur s'est produite.\n";
exit;
}

// Fixe l'encodage du client à UNICODE. Les données seront automatiquement
// converties de l'encodage serveur à l'encodage client.
pg_set_client_encoding($conn, "UNICODE");

$result = pg_query($conn, "SELECT auteur, email FROM auteurs");
if (!
$result) {
echo
"Une erreur s'est produite.\n";
exit;
}

// Écriture de données UTF-8
while ($row = pg_fetch_row($result)) {
echo
"Auteur: $row[0] E-mail: $row[1]";
echo
"<br />\n";
}

?>

Voir aussi

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top