PDOStatement::bindValue()函数—用法及示例

函数：PDOStatement::bindValue()

适用版本：PHP 5 >= 5.1.0, PHP 7, PHP 8

用法：PDOStatement::bindValue() 方法使用给定的值将一个参数绑定到一个预处理语句中的占位符。这个方法允许你绑定一个具体的值到一个参数，而不是绑定一个变量。

语法：bool PDOStatement::bindValue( mixed $parameter, mixed $value [, int $data_type = PDO::PARAM_STR ] )

参数：

• $parameter: 需要绑定的占位符的参数名或者位置（从1开始）。
• $value: 需要绑定到占位符的值。
• $data_type (可选): 指定参数的数据类型，可以是 PDO::PARAM_* 常量之一，默认为 PDO::PARAM_STR。

返回值：如果绑定成功，则返回 true，否则返回 false。

示例：

// 创建一个PDO连接
$dsn = 'mysql:host=localhost;dbname=test';
$username = 'root';
$password = 'password';

try {
    $pdo = new PDO($dsn, $username, $password);
} catch (PDOException $e) {
    echo 'Connection failed: ' . $e->getMessage();
    exit;
}

// 准备预处理语句
$stmt = $pdo->prepare('SELECT * FROM users WHERE username = :username');

// 绑定参数值
$username = 'john_doe';
$stmt->bindValue(':username', $username, PDO::PARAM_STR);

// 执行查询
$stmt->execute();

// 获取结果
$result = $stmt->fetchAll(PDO::FETCH_ASSOC);

// 输出结果
foreach ($result as $row) {
    echo $row['username'] . ' - ' . $row['email'] . '<br>';
}

在上面的示例中，我们首先创建了一个PDO连接，然后准备了一个预处理语句，其中包含了一个占位符 :username。然后，我们使用 PDOStatement::bindValue() 方法将变量 $username 的值绑定到了这个占位符上。最后，我们执行了查询并获取了结果，然后通过循环输出了每一行的用户名和邮箱。

这个方法的好处是可以防止SQL注入攻击，因为绑定的值会被自动转义和引用。另外，使用 bindValue() 方法时，绑定的值是在绑定的时候就确定的，不会随后的变量更改而改变。