pg_send_prepare(3) [php man page]

PG_SEND_PREPARE(3)														PG_SEND_PREPARE(3)

pg_send_prepare - Sends a request to create a prepared statement with the given parameters, without waiting for completion.

SYNOPSIS

       bool pg_send_prepare (resource  $connection, string  $stmtname, string  $query)

DESCRIPTION

	Sends a request to create a prepared statement with the given parameters, without waiting for completion.

	This  is  an asynchronous version of pg_prepare(3): it returns TRUE if it was able to dispatch the request, and FALSE if not. After a suc-
       cessful call, call pg_get_result(3) to determine whether the server successfully created the prepared statement. The function's	parameters
       are handled identically to pg_prepare(3). Like pg_prepare(3), it will not work on pre-7.4 versions of PostgreSQL.

PARAMETERS

	      o $connection
		- PostgreSQL database connection resource. When $connection is not present, the default connection is used. The default connection
		is the last connection made by pg_connect(3) or pg_pconnect(3).

	      o $stmtname
		- The name to give the prepared statement. Must be unique per-connection. If "" is specified, then an unnamed  statement  is  cre-
		ated, overwriting any previously defined unnamed statement.

	      o $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 on failure. Use pg_get_result(3) to determine the query result.

EXAMPLES

       Example #1

	      Using pg_send_prepare(3)

	      <?php
		$dbconn = pg_connect("dbname=publisher") or die("Could not connect");

		// Prepare a query for execution
		if (!pg_connection_busy($dbconn)) {
		  pg_send_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1');
		  $res1 = pg_get_result($dbconn);
		}

		// Execute the prepared query.	Note that it is not necessary to escape
		// the string "Joe's Widgets" in any way
		if (!pg_connection_busy($dbconn)) {
		  pg_send_execute($dbconn, "my_query", array("Joe's Widgets"));
		  $res2 = pg_get_result($dbconn);
		}

		// Execute the same prepared query, this time with a different parameter
		if (!pg_connection_busy($dbconn)) {
		  pg_send_execute($dbconn, "my_query", array("Clothes Clothes Clothes"));
		  $res3 = pg_get_result($dbconn);
		}

	      ?>

SEE ALSO

       pg_connect(3), pg_pconnect(3), pg_execute(3), pg_send_execute(3), pg_send_query_params(3).

PHP Documentation Group 													PG_SEND_PREPARE(3)

Check Out this Related Man Page

PG_CONVERT(3)															     PG_CONVERT(3)

pg_convert - Convert associative array values into suitable for SQL statement

SYNOPSIS

       array pg_convert (resource  $connection, string	$table_name, array  $assoc_array, [int	$options])

DESCRIPTION

       pg_convert(3)  checks  and  converts  the values in $assoc_array into suitable values for use in an SQL statement. Precondition for pg_con-
       vert(3) is the existence of a table $table_name which has at least as many columns as $assoc_array has elements.  The  fieldnames  in  $ta-
       ble_name  must  match  the  indices in $assoc_array and the corresponding datatypes must be compatible. Returns an array with the converted
       values on success, FALSE otherwise.

       Note

	       If there are boolean fields in $table_name don't use the constant TRUE in $assoc_array. It will be converted to the  string  'TRUE'
	      which is no valid entry for boolean fields in PostgreSQL. Use one of t, true, 1, y, yes instead.

       Warning

	      This  function is EXPERIMENTAL. The behaviour of this function, its name, and surrounding documentation may change without notice in
	      a future release of PHP. This function should be used at your own risk.

PARAMETERS

	      o $connection
		- PostgreSQL database connection resource.

	      o $table_name
		- Name of the table against which to convert types.

	      o $assoc_array
		- Data to be converted.

	      o $options
		- Any number of PGSQL_CONV_IGNORE_DEFAULT, PGSQL_CONV_FORCE_NULL or PGSQL_CONV_IGNORE_NOT_NULL, combined.

RETURN VALUES

	An array of converted values, or FALSE on error.

EXAMPLES

       Example #1

	      pg_convert(3) example

	      <?php
		$dbconn = pg_connect('dbname=foo');

		$tmp = array(
		    'author' => 'Joe Thackery',
		    'year' => 2005,
		    'title' => 'My Life, by Joe Thackery'
		);

		$vals = pg_convert($dbconn, 'authors', $tmp);
	      ?>

SEE ALSO

       pg_meta_data(3).

PHP Documentation Group 													     PG_CONVERT(3)

Linux and UNIX Man Pages

pg_send_prepare(3) [php man page]

Check Out this Related Man Page