PDO::prepare

PHP PDO 参考手册PHP PDO-Referenzhandbuch

PDO::prepare — Bereitet eine SQL-Anweisung für die Ausführung vor und gibt ein PDOStatement-Objekt zurück (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Beschreibung

Syntax

public PDOStatement PDO::prepare ( string $statement [, array $driver_options = array() ] )

Bereitet eine SQL-Anweisung für die Ausführung durch die Methode PDOStatement::execute() vor. Die SQL-Anweisung kann null oder mehr benannte (:name) oder Fragezeichen (?) Parameterplatzhalter enthalten. Die Parameter werden ersetzt, wenn die Anweisung ausgeführt wird.

Sie können benannte (:name) und Fragezeichen (?) Parameterplatzhalter nicht in derselben SQL-Anweisung mischen; Sie müssen einen Stil wählen.

Die Parameter in einer vorbereiteten SQL-Anweisung werden durch tatsächliche Werte ersetzt, wenn die Methode PDOStatement::execute() aufgerufen wird.


Parameters

Anweisung
Eine gültige SQL-Anweisung.

driver_options
Dieses Array enthält ein oder mehrere Schlüssel=>Wert-Paare, um Attribute für das PDOStatement-Objekt festzulegen. Der häufigste Einsatzzweck ist, den Wert PDO::ATTR_CURSOR auf PDO::CURSOR_SCROLL zu setzen, um einen scrollbaren Cursor anzufordern.


Rückgabewerte

Bei Erfolg gibt PDO::prepare() ein PDOStatement-Objekt zurück. Im Fehlerfall gibt es FALSE zurück oder wirft eine PDOException.


Beispiele

Eine SQL-Anweisung mit benannten (:name) Parametern vorbereiten

Beispiel

<?php /*Werte mithilfe eines Arrays an eine vorbereitete Anweisung übergeben*/ $sql = 'SELECT name, colour, calories FROM fruit WHERE calories < :calories AND colour = :colour'; $sth = $dbh->prepare($sql, array(PDO::ATTR_CURSOR => PDO::CURSOR_FWDONLY)); $sth->execute(array(':calories' => 150, ':colour' => 'red')); $red = $sth->fetchAll(); $sth->execute(array(':calories' => 175, ':colour' => 'yellow')); $yellow = $sth->fetchAll(); ?>

SQL-Anweisung mit Fragezeichen (?)-Parametern vorbereiten

Beispiel

<?php /*Werte mithilfe eines Arrays an eine vorbereitete Anweisung übergeben*/ $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < ? AND colour = ?'); $sth->execute(array(150, 'red')); $red = $sth->fetchAll(); $sth->execute(array(175, 'yellow')); $yellow = $sth->fetchAll(); ?>

PHP PDO 参考手册PHP PDO-Referenzhandbuch

Andere Erweiterungen