pg_send_prepare

pg_send_prepare(PgSql\Connection $connection, string $statement_name, string $query): int
```php

Envía una solicitud para crear una consulta preparada con los argumentos dados, sin esperar el final de su ejecución.

Esta función es la versión asíncrona de `pg_prepare` : devuelve `true` si ha sido capaz de distribuir la consulta y `false` si no ha sido capaz. Tras una llamada exitosa, llame a `pg_get_result` para determinar si el servidor ha creado correctamente la consulta preparada. Los argumentos de la función son gestionados de la misma manera que `pg_execute`. Al igual que `pg_execute`, la función no funcionará en versiones anteriores a PostgreSQL 7.4.

## Parámetros

`connection`  
Una instancia `PgSql\Connection`.

`statement_name`  
El nombre a dar a la consulta preparada. Debe ser único en cada sesión. Si se especifica una cadena vacía ("") entonces se crea una consulta sin nombre, sobrescribiendo las consultas sin nombre previamente definidas.

`query`  
La consulta SQL con sus argumentos. Debe contener solo una consulta. No se permiten múltiples consultas separadas por punto y coma. Si se utilizan argumentos, se refieren a \$1, \$2, etc.

## Valores devueltos

Devuelve `true` en caso de éxito, `false` o `0` en caso de error. Utilice `pg_get_result` para determinar el resultado de la consulta.

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