Documentación offline PHP master

pg_escape_identifier

master Documentación oficial Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

pg_escape_identifier

Protege un identificador para su inserción en un campo de texto.

Descripción#

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

`pg_escape_identifier` protege un identificador (ejemplo: tabla, nombre de campo) para una consulta en la base de datos. El resultado es una cadena de caracteres protegida para PostgreSQL. `pg_escape_identifier` añade comillas antes y después de los datos. Los usuarios no deben, por lo tanto, añadir comillas. Se recomienda el uso de esta función para los identificadores de las consultas. Para los datos SQL sin tratar (es decir, los parámetros, excepto de tipo bytea), `pg_escape_literal` o `pg_escape_string` debe ser utilizado. Para los campos de tipo bytea es necesario utilizar `pg_escape_bytea`.

## Parámetros

`connection`  
Una `PgSql\Connection` instancia. Cuando `connection` no es especificado, se usa la conexión por defecto. 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.

`string`  
Una `string` que contiene texto a proteger.

## Valores devueltos

Una `string` que contiene los datos protegidos, o `false` en caso de fallo.

## 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`. |

## Ejemplos

Ejemplo con `pg_escape_identifier`

```php

Véase también#

pg_escape_literal, pg_escape_bytea, pg_escape_string