db2_prepare(3) [php man page]

DB2_PREPARE(3)								 1							    DB2_PREPARE(3)

db2_prepare - Prepares an SQL statement to be executed

SYNOPSIS

       resource db2_prepare (resource  $connection, string  $statement, [array	$options])

DESCRIPTION

       db2_prepare(3)  creates	a prepared SQL statement which can include 0 or more parameter markers ( ? characters) representing parameters for
       input, output, or input/output. You can pass parameters to the prepared statement using db2_bind_param(3), or for input values only, as	an
       array passed to db2_execute(3).

	There are three main advantages to using prepared statements in your application:

	      o Performance:  when  you  prepare  a  statement, the database server creates an optimized access plan for retrieving data with that
		statement. Subsequently issuing the prepared statement with db2_execute(3) enables the statements to reuse that  access  plan  and
		avoids the overhead of dynamically creating a new access plan for every statement you issue.

	      o Security:  when you prepare a statement, you can include parameter markers for input values. When you execute a prepared statement
		with input values for placeholders, the database server checks each input value to ensure that the type matches the column defini-
		tion or parameter definition.

	      o Advanced  functionality:  Parameter  markers not only enable you to pass input values to prepared SQL statements, they also enable
		you to retrieve OUT and INOUT parameters from stored procedures using db2_bind_param(3).

PARAMETERS

	      o $connection
		- A valid database connection resource variable as returned from db2_connect(3) or db2_pconnect(3).

	      o $statement
		- An SQL statement, optionally containing one or more parameter markers..

	      o $options
		- An associative array containing statement options. You can use this parameter to request a scrollable cursor on database servers
		that support this functionality.  For a description of valid statement options, see db2_set_option(3).

RETURN VALUES

	Returns  a statement resource if the SQL statement was successfully parsed and prepared by the database server. Returns FALSE if the data-
       base server returned an error. You can determine which error was returned by calling db2_stmt_error(3) or db2_stmt_errormsg(3).

EXAMPLES

       Example #1

	      Preparing and executing an SQL statement with parameter markers

	       The following example prepares an INSERT statement that accepts four parameter markers, then iterates over an array of arrays  con-
	      taining the input values to be passed to db2_execute(3).

	      <?php
	      $animals = array(
		  array(0, 'cat', 'Pook', 3.2),
		  array(1, 'dog', 'Peaches', 12.3),
		  array(2, 'horse', 'Smarty', 350.0),
	      );

	      $insert = 'INSERT INTO animals (id, breed, name, weight)
		  VALUES (?, ?, ?, ?)';
	      $stmt = db2_prepare($conn, $insert);
	      if ($stmt) {
		  foreach ($animals as $animal) {
		      $result = db2_execute($stmt, $animal);
		  }
	      }
	      ?>

SEE ALSO

       db2_bind_param(3), db2_execute(3), db2_stmt_error(3), db2_stmt_errormsg(3).

PHP Documentation Group 													    DB2_PREPARE(3)

PDOSTATEMENT.EXECUTE(3) 						 1						   PDOSTATEMENT.EXECUTE(3)

PDOStatement::execute - Executes a prepared statement

SYNOPSIS

       public bool PDOStatement::execute ([array  $input_parameters])

DESCRIPTION

	Execute the prepared statement. If the prepared statement included parameter markers, you must either:

	      ocall  PDOStatement.bindParam(3)	to  bind  PHP  variables  to  the parameter markers: bound variables pass their value as input and
	      receive the output value, if any, of their associated parameter markers

	      oor pass an array of input-only parameter values

PARAMETERS

	      o $input_parameters
		- An array of values with as many elements as there are bound parameters in the SQL  statement	being  executed.  All  values  are
		treated  as  PDO::PARAM_STR.   You cannot bind multiple values to a single parameter; for example, you cannot bind two values to a
		single named parameter in an IN() clause.  You cannot bind more values than specified; if more	keys  exist  in  $input_parameters
		than in the SQL specified in the PDO::prepare, then the statement will fail and an error is emitted.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.2.0	|						    |
       |	|						    |
       |	|  The	keys  from $input_parameters must match the |
       |	| ones declared in the SQL. Before PHP	5.2.0  this |
       |	| was silently ignored. 			    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      Execute a prepared statement with bound variables

	      <?php
	      /* Execute a prepared statement by binding PHP variables */
	      $calories = 150;
	      $colour = 'red';
	      $sth = $dbh->prepare('SELECT name, colour, calories
		  FROM fruit
		  WHERE calories < :calories AND colour = :colour');
	      $sth->bindParam(':calories', $calories, PDO::PARAM_INT);
	      $sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12);
	      $sth->execute();
	      ?>

       Example #2

	      Execute a prepared statement with an array of insert values (named parameters)

	      <?php
	      /* Execute a prepared statement by passing an array of insert values */
	      $calories = 150;
	      $colour = 'red';
	      $sth = $dbh->prepare('SELECT name, colour, calories
		  FROM fruit
		  WHERE calories < :calories AND colour = :colour');
	      $sth->execute(array(':calories' => $calories, ':colour' => $colour));
	      ?>

       Example #3

	      Execute a prepared statement with an array of insert values (placeholders)

	      <?php
	      /* Execute a prepared statement by passing an array of insert values */
	      $calories = 150;
	      $colour = 'red';
	      $sth = $dbh->prepare('SELECT name, colour, calories
		  FROM fruit
		  WHERE calories < ? AND colour = ?');
	      $sth->execute(array($calories, $colour));
	      ?>

       Example #4

	      Execute a prepared statement with question mark placeholders

	      <?php
	      /* Execute a prepared statement by binding PHP variables */
	      $calories = 150;
	      $colour = 'red';
	      $sth = $dbh->prepare('SELECT name, colour, calories
		  FROM fruit
		  WHERE calories < ? AND colour = ?');
	      $sth->bindParam(1, $calories, PDO::PARAM_INT);
	      $sth->bindParam(2, $colour, PDO::PARAM_STR, 12);
	      $sth->execute();
	      ?>

       Example #5

	      Execute a prepared statement using array for IN clause

	      <?php
	      /* Execute a prepared statement using an array of values for an IN clause */
	      $params = array(1, 21, 63, 171);
	      /* Create a string for the parameter placeholders filled to the number of params */
	      $place_holders = implode(',', array_fill(0, count($params), '?'));

	      /*
		  This prepares the statement with enough unnamed placeholders for every value
		  in our $params array. The values of the $params array are then bound to the
		  placeholders in the prepared statement when the statement is executed.
		  This is not the same thing as using PDOStatement::bindParam() since this
		  requires a reference to the variable. PDOStatement::execute() only binds
		  by value instead.
	      */
	      $sth = $dbh->prepare("SELECT id, name FROM contacts WHERE id IN ($place_holders)");
	      $sth->execute($params);
	      ?>

NOTES

       Note

	       Some drivers require to close cursor before executing next statement.

SEE ALSO

       PDO.prepare(3), PDOStatement.bindParam(3), PDOStatement.fetch(3), PDOStatement.fetchAll(3), PDOStatement.fetchColumn(3).

PHP Documentation Group 												   PDOSTATEMENT.EXECUTE(3)