Documentación offline PHP master

pg_client_encoding

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

pg_client_encoding

Lee la codificación del cliente

Descripción#

pg_client_encoding([PgSql\Connection $connection]): string
```php

PostgreSQL soporta la conversión automática entre el servidor y el cliente para ciertos juegos de caracteres. `pg_client_encoding` devuelve la codificación del cliente. La cadena devuelta será una de las codificaciones estándar de PostgreSQL.

> [!NOTE]
> Si la biblioteca libpq es compilada sin el soporte de codificaciones multibyte, `pg_client_encoding` devolverá siempre `SQL_ASCII`. El soporte de codificaciones depende de la versión de PostgreSQL. Consúltese la documentación de PostgreSQL sobre las codificaciones soportadas.
>
> Anteriormente, esta función se llamaba `pg_clientencoding`.

## Parámetros

`connection`  
Una instancia `PgSql\Connection`. Cuando `connection` es `null`, se usa la conexión predeterminada. La conexión predeterminada es la última conexión hecha por `pg_connect` o `pg_pconnect`

> [!WARNING]
> Desde PHP 8.1.0, usar la conexión predeterminada está obsoleto.

## Valores devueltos

La codificación del cliente.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `connection` ahora espera una instancia de `PgSql\Connection` ; anteriormente, se esperaba un `resource`. |
| 8.0.0 | `connection` ahora es nullable. |

## Ejemplos

Ejemplo con `pg_client_encoding`

```php

El ejemplo anterior mostrará:

La codificación del cliente es: ISO-8859-1

Véase también#

pg_set_client_encoding