PHP PDO: Sentencias preparadas y procedimientos almacenados
Manual de referencia de PHP PDO
Muchas bases de datos más maduras soportan el concepto de sentencias preparadas.
¿Qué es una sentencia preparada? Puede considerarse como una plantilla compilada del SQL que se desea ejecutar, que puede personalizarse con parámetros variables. Las sentencias preparadas pueden aportar dos grandes ventajas:
- La consulta solo necesita ser analizada (o preparada) una vez, pero puede ejecutarse múltiples veces con los mismos o diferentes parámetros. Cuando la consulta está preparada, la base de datos analizará, compilará y optimizará el plan para ejecutar dicha consulta. Para consultas complejas, este proceso puede llevar bastante tiempo; si se necesita repetir la misma consulta varias veces con diferentes parámetros, ese proceso ralentizará enormemente la aplicación. Al usar sentencias preparadas, se puede evitar el ciclo repetido de análisis/compilación/optimización. En resumen, las sentencias preparadas consumen menos recursos y, por lo tanto, se ejecutan más rápido.
- Los parámetros proporcionados a una sentencia preparada no necesitan estar entre comillas; el controlador los maneja automáticamente. Si la aplicación solo utiliza sentencias preparadas, se puede asegurar que no ocurrirá inyección SQL. (Sin embargo, si otras partes de la consulta se construyen con entradas sin escapar, todavía existe el riesgo de inyección SQL).
Las sentencias preparadas son tan útiles que su única característica es que cuando el controlador no las soporta, PDO las simulará. Esto asegura que, sin importar si la base de datos tiene esta capacidad, la aplicación pueda utilizar el mismo patrón de acceso a datos.
Inserción repetida con sentencias preparadas
El siguiente ejemplo ejecuta una consulta de inserción reemplazando los marcadores de posición nombrados correspondientes con name y value.
<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)");
$stmt->bindParam(':name', $name);
$stmt->bindParam(':value', $value);
// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();
// 用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>
Inserción repetida con sentencias preparadas
El siguiente ejemplo ejecuta una consulta de inserción reemplazando los marcadores de posición ? con name y value.
<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (?, ?)");
$stmt->bindParam(1, $name);
$stmt->bindParam(2, $value);
// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();
// 用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>
Obtener datos con sentencias preparadas
El siguiente ejemplo obtiene datos basándose en la forma en que los valores clave ya se han proporcionado. La entrada del usuario se entrecomilla automáticamente, por lo que no hay peligro de ataques de inyección SQL.
<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name = ?");
if ($stmt->execute(array($_GET['name']))) {
while ($row = $stmt->fetch()) {
print_r($row);
}
}
?>
Si el controlador de la base de datos lo soporta, la aplicación también puede enlazar parámetros de salida y entrada. Los parámetros de salida se utilizan generalmente para obtener valores de procedimientos almacenados. Los parámetros de salida son un poco más complejos de usar que los de entrada, porque al enlazar un parámetro de salida, se debe conocer la longitud del parámetro dado. Si el valor enlazado al parámetro es mayor que la longitud sugerida, se producirá un error.
Llamar a un procedimiento almacenado con parámetros de salida
<?php
$stmt = $dbh->prepare("CALL sp_returns_string(?)");
$stmt->bindParam(1, $return_value, PDO::PARAM_STR, 4000);
// 调用存储过程
$stmt->execute();
print "procedure returned $return_value\n";
?>
También se pueden especificar parámetros que tengan valores de entrada y salida a la vez, cuya sintaxis es similar a la de los parámetros de salida. En el siguiente ejemplo, la cadena "hello" se pasa al procedimiento almacenado; cuando el procedimiento retorna, "hello" se reemplaza por el valor devuelto por dicho procedimiento.
Llamar a un procedimiento almacenado con parámetros de entrada/salida
<?php
$stmt = $dbh->prepare("CALL sp_takes_string_returns_string(?)");
$value = 'hello';
$stmt->bindParam(1, $value, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 4000);
// 调用存储过程
$stmt->execute();
print "procedure returned $value\n";
?>
Uso no válido de marcadores de posición
<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE '%?%'");
$stmt->execute(array($_GET['name']));
// 占位符必须被用在整个值的位置
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE ?");
$stmt->execute(array("%$_GET[name]%"));
?>
Otras extensiones