PDOStatement::execute

PHP PDO-Referenzhandbuch

PDOStatement::execute — Führt eine vorbereitete Anweisung aus (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

Beschreibung

Syntax

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

Führt eine vorbereitete Anweisung aus. Wenn die vorbereitete Anweisung Parameterplatzhalter enthält, müssen Sie eine der folgenden Möglichkeiten wählen:

• Rufen SiePDOStatement::bindParam()auf, um PHP-Variablen an die Parameterplatzhalter zu binden: übergeben Sie gegebenenfalls Eingabewerte und rufen Ausgabewerte über Variablen ab, die an die zugehörigen Parameterplatzhalter gebunden sind.

• oder übergeben Sie ein Array mit ausschließlich Eingabeparameterwerten.

Parameters

input_parameters

Ein Array von Werten mit so vielen Elementen, wie gebundene Parameter in der ausgeführten SQL-Anweisung vorhanden sind. Alle Werte werden als PDO::PARAM_STR behandelt.

Es können nicht mehrere Werte an einen einzelnen Parameter gebunden werden; zum Beispiel können nicht zwei Werte an einen einzelnen benannten Parameter in einer IN()-Klausel gebunden werden.

Die Anzahl der gebundenen Werte darf die angegebene Anzahl nicht überschreiten. Wenn input_parameters mehr Schlüssel enthält als im von PDO::prepare() vorbereiteten SQL angegeben, schlägt die Anweisung fehl und gibt einen Fehler aus.

Rückgabewerte

Gibt bei Erfolg TRUE zurück, bei Fehlschlag FALSE.

Beispiele

Eine vorbereitete Anweisung mit gebundenen Variablen ausführen

<?php
/*  通过绑定 PHP 变量执行一条预处理语句 */
$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();
?>

Eine vorbereitete Anweisung mit einem Array von Einfügewerten ausführen (benannte Parameter)

<?php
/* 通过传递一个含有插入值的数组执行一条预处理语句 */
$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));
?>

Eine vorbereitete Anweisung mit einem Array von Einfügewerten ausführen (Platzhalter)

<?php
/*  通过传递一个插入值的数组执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < ? AND colour = ?');
$sth->execute(array($calories, $colour));
?>

Eine vorbereitete Anweisung mit Fragezeichen-Platzhaltern ausführen

<?php
/* 通过绑定 PHP 变量执行一条预处理语句 */
$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();
?>

Eine vorbereitete Anweisung mit einer IN-Klausel unter Verwendung eines Arrays ausführen

<?php
/*  使用一个数组的值执行一条含有 IN 子句的预处理语句 */
$params = array(1, 21, 63, 171);
/*  创建一个填充了和params相同数量占位符的字符串 */
$place_holders = implode(',', array_fill(0, count($params), '?'));

/*
    对于 $params 数组中的每个值，要预处理的语句包含足够的未命名占位符 。
    语句被执行时， $params 数组中的值被绑定到预处理语句中的占位符。
    这和使用 PDOStatement::bindParam() 不一样，因为它需要一个引用变量。
    PDOStatement::execute() 仅作为通过值绑定的替代。
*/
$sth = $dbh->prepare("SELECT id, name FROM contacts WHERE id IN ($place_holders)");
$sth->execute($params);
?>

PHP PDO-Referenzhandbuch