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)