pg_send_prepare
Sends a request to create a prepared statement with the given parameters, without waiting for completion.
This is an asynchronous version of pg_prepare: it returns true if it was able to dispatch the request, and false if not. After a successful call, call pg_get_result to determine whether the server successfully created the prepared statement. The function's parameters are handled identically to pg_prepare. Like pg_prepare, it will not work on pre-7.4 versions of PostgreSQL.
Parameters
- connection
-
An PgSql\Connection instance.
- statement_name
-
The name to give the prepared statement. Must be unique per-connection. If "" is specified, then an unnamed statement is created, overwriting any previously defined unnamed statement.
- query
-
The parameterized SQL statement. Must contain only a single statement. (multiple statements separated by semi-colons are not allowed.) If any parameters are used, they are referred to as $1, $2, etc.
Return Values
Returns true on success, false or 0 on failure. Use pg_get_result to determine the query result.
Changelog
Version | Description |
8.1.0 | The connection parameter expects an PgSql\Connection instance now; previously, a resource was expected. |