Protege una consulta SQL literal para insertar en un campo de texto

# pg_escape_literal

(PHP 5 >= 5.4.4, PHP 7, PHP 8)

pg_escape_literal — Protege una consulta SQL literal para insertar en un campo de texto

### Descripción

function pg_escape_literal(PgSql\Connection `$connection` = ?, string `$string`): string|false

pg_escape_literal() protege una consulta SQL literal para su ejecución en la base de datos PostgreSQL. El resultado devuelto es un string protegido en formato PostgreSQL. pg_escape_literal() añade comillas simples antes y después de los datos. Los usuarios no deben, por tanto, añadir comillas simples. Se recomienda el uso de esta función en lugar de pg_escape_string(). Si la columna es de tipo bytea, se debe utilizar en su lugar la función pg_escape_bytea(). Para proteger los identificadores (por ejemplo, nombres de tabla, nombres de campos), se debe utilizar la función pg_escape_identifier().

### Parámetros

`connection`

  Una instancia PgSql\Connection. Cuando `connection` no es especificado, se usa la conexión por defecto. La conexión por defecto es la última conexión hecha por pg_connect() o pg_pconnect()

  Advertencia

  Desde PHP 8.1.0, usar la conexión por defecto está obsoleto.

`string`

  Un 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 #1 Ejemplo con pg_escape_literal()

    <?php
      // Conexión a la base de datos
      $dbconn = pg_connect('dbname=foo');

      // Lectura de un fichero (que contiene apóstrofes y barras invertidas)
      $data = file_get_contents('letter.txt');

      // Protección de los datos
      $escaped = pg_escape_literal($data);

      // Inserción en la base de datos. Observe que no hay comillas simples alrededor de {$escaped}
      pg_query("INSERT INTO correspondence (name, data) VALUES ('My letter', {$escaped})");
    ?>

### Ver también

- pg_escape_identifier() - Protege un identificador para su inserción en un campo de texto.
- pg_escape_bytea() - Protege una cadena para insertarla en un campo bytea
- pg_escape_string() - Protege un string para una consulta SQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open