previousDB_common::nextQueryIsManip() (Previous) (Next) DB_common::provides()next

View this page in Last updated: Tue, 02 Jun 2009
English | Brazilian Portuguese | Chinese | Dutch | French | German | Hungarian | Japanese | Polish | Russian | Spanish | Turkish

DB_common::prepare()

DB_common::prepare() – Prepares a SQL statement for later execution

Synopsis

resource prepare ( string $query )

Description

Gets a SQL statement ready so it can be run by execute().

Parameter

string $query

the query to prepare

Return value

resource - the query handle or a DB_Error object on failure

Note

This function can not be called statically.

Example

Using prepare()

<?php
// Once you have a valid DB object named $db...
$sth $db->prepare('INSERT INTO numbers (number) VALUES (?)');
if (
PEAR::isError($sth)) {
    die(
$sth->getMessage());
}

$res =& $db->execute($sth1);
if (
PEAR::isError($res)) {
    die(
$res->getMessage());
}
?>
previousDB_common::nextQueryIsManip() (Previous) (Next) DB_common::provides()next

Download Documentation Last updated: Tue, 02 Jun 2009
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
Note by: user2037
It may not be obvious but you need to "escape placeholder characters" such as question marks, exclamation points, and ampersands when preparing a query. For example: "SELECT * WHERE a \!= FALSE AND b = ?".