|
|
 |
PDOStatement::bindParam (no version information, might be only in CVS) PDOStatement::bindParam --
Binds a parameter to the specified variable name
说明bool PDOStatement::bindParam ( mixed parameter, mixed &variable [, int data_type [, int length [, mixed driver_options]]] ) | 警告 | 本函数是实验性的。本函数的行为，包括函数名称以及其它任何关于本函数的文档可能会在没有通知的情况下随
PHP 以后的发布而改变。使用本函数风险自担。 |
Binds an SQL statement parameter to the specified variable name. The SQL statement
parameter can either be a named placeholder or a question mark placeholder.
Output parameters will set the value of the bound PHP variable to the value
returned by the database when the SQL statement is executed. This enables you
to call stored procedures with output or input/output parameters, for example,
for databases that support such features.
For non-NULL input-only variables, you can pass an array of input values to
PDOStatement::execute() instead.
参数
- parameter
Parameter identifier. For a prepared statement using named
placeholders, this will be a parameter name of the form
:name. For a prepared statement using
question mark placeholders, this will be the 1-indexed position of
the parameter.
- variable
Name of the PHP variable to bind to the SQL statement parameter.
- data_type
Explicit data type for the parameter using the PDO_PARAM_*
constants. To return an INOUT parameter from a stored procedure,
use the bitwise OR operator to set the PDO_PARAM_INPUT_OUTPUT bits
for the data_type parameter.
To pass a NULL value as an input parameter, declare the
PDO_PARAM_NULL constant.
- length
Length of the data type. To indicate that a parameter is an OUT
parameter from a stored procedure, you must explicitly set the
length.
- driver_options
例例子 1. Execute a prepared statement with named placeholders |
<?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();
?>
|
|
例子 2. Execute a prepared statement with question mark placeholders |
<?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();
?>
|
|
例子 3. Pass a NULL value into a prepared statement |
<?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_NULL);
$sth->execute();
?>
|
|
例子 4. Call a stored procedure with an INOUT parameter |
<?php
$colour = 'red';
$sth = $dbh->prepare('CALL puree_fruit(?)');
$sth->bindParam(1, $colour, PDO_PARAM_STR|PDO_PARAM_INPUT_OUTPUT, 12);
$sth->execute();
print("After pureeing fruit, the colour is: $colour");
?>
|
|
参见
| PDO::prepare() | | PDOStatement::execute() |
| |
PDOStatement::bindColumn