PDO::prepare

PHP PDO 参考手册Manual de referencia de PHP PDO

PDO::prepare — Prepara una sentencia SQL para su ejecución y devuelve un objeto PDOStatement (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Descripción

Sintaxis

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

Prepara una sentencia SQL para ser ejecutada por el método PDOStatement::execute(). La sentencia SQL puede contener cero o más marcadores de parámetros con nombre (:name) o de interrogación (?), que serán reemplazados cuando se ejecute la sentencia.

No se pueden incluir simultáneamente marcadores de parámetros con nombre (:name) y de interrogación (?) en una sentencia SQL; solo se puede elegir uno de los dos estilos.

Los parámetros de una sentencia SQL preparada recibirán los valores reales cuando se utilice el método PDOStatement::execute().


Parámetros

statement
Una sentencia SQL válida.

driver_options
Este array contiene uno o más pares clave=>valor para establecer atributos del objeto PDOStatement. El uso más común es establecer el valor de PDO::ATTR_CURSOR como PDO::CURSOR_SCROLL para solicitar un cursor desplazable.


Valores de retorno

Si tiene éxito, PDO::prepare() devuelve un objeto PDOStatement; si falla, devuelve FALSE o lanza una excepción PDOException.


Ejemplo

Usar parámetros con nombre (:name) para preparar sentencias SQL

Ejemplo

<?php /*Pasar valores a la sentencia preparada mediante un array*/ $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(); ?>

Usar parámetros de interrogación (?) para preparar sentencias SQL

Ejemplo

<?php /*Pasar valores a la sentencia preparada mediante un array*/ $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 参考手册Manual de referencia de PHP PDO

Otras extensiones