先理解问题:预处理解决什么
在 PHP 中拼接 SQL 是很多问题的起点。比如把用户输入的邮箱直接拼进 WHERE email = '...',攻击者可以通过引号和逻辑运算符改变 SQL 语义。PDO 预处理的核心,是让 SQL 结构先固定下来,用户输入只作为参数值传入,而不是成为 SQL 语句的一部分。
需要明确的是,占位符只代表“值”,不能代表表名、列名、排序方向或 SQL 关键字。预处理也不是万能过滤器:业务规则、长度、格式、权限仍然需要单独校验。本文以 MySQL 为例说明 PHP 8.2 下常见写法,其他数据库的 DSN、驱动属性和部分语法可能不同。
建立连接与错误模式
先建立可预期的 PDO 连接。建议显式设置字符集、错误模式和默认取回方式。下面的示例关闭 MySQL 的模拟预处理,让驱动尽量使用服务端预处理;是否关闭模拟模式要结合所用驱动和部署环境确认,不能一概而论。
$dsn = 'mysql:host=127.0.0.1;dbname=app;charset=utf8mb4';
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
];
$pdo = new PDO($dsn, $user, $password, $options);ERRMODE_EXCEPTION 能让 prepare、execute 等环节出错时抛出异常,避免静默失败。捕获异常后,应记录必要信息并给用户通用提示,不要把完整 SQL、参数值或数据库结构直接输出到页面。
查询的基本流程
一次正常的预处理查询通常包含四步:写带占位符的 SQL、调用 prepare、绑定参数、执行并取回结果。下面使用命名占位符:
$sql = 'SELECT id, email, created_at FROM users WHERE status = :status AND created_at >= :since ORDER BY id DESC';
$stmt = $pdo->prepare($sql);
$stmt->bindValue(':status', $status, PDO::PARAM_STR);
$stmt->bindValue(':since', $since, PDO::PARAM_STR);
$stmt->execute();
$rows = $stmt->fetchAll();写入数据时同样使用占位符:
$stmt = $pdo->prepare('INSERT INTO users (email, password_hash, created_at) VALUES (:email, :password_hash, :created_at)');
$stmt->execute([
':email' => $email,
':password_hash' => $passwordHash,
':created_at' => $createdAt,
]);execute 传入数组时,值通常按字符串处理。字符串字段问题不大,但整数、布尔值和 NULL 更建议用 bindValue 显式指定类型,例如 PDO::PARAM_INT、PDO::PARAM_BOOL、PDO::PARAM_NULL。另外,命名占位符不要混用位置占位符;在原生预处理模式下,同一个命名占位符重复出现也可能不被接受,应改用不同名称或位置占位符。
动态条件与不能绑定的部分
预处理最适合绑定“值”,但表名、列名、ORDER BY 字段和排序方向不能作为普通参数绑定。遇到这类动态需求,应使用白名单,而不是把用户输入直接拼进 SQL。
$allowedOrder = ['id', 'created_at'];
$orderBy = in_array($orderBy, $allowedOrder, true) ? $orderBy : 'id';
$direction = strtolower($direction) === 'asc' ? 'ASC' : 'DESC';
$sql = 'SELECT id, email FROM users ORDER BY ' . $orderBy . ' ' . $direction;IN 查询也不能只写一个占位符再传入逗号分隔字符串。正确做法是按数组元素个数生成对应数量的占位符,再逐个绑定:
$ids = array_map('intval', $ids);
$ids = array_values(array_unique(array_filter($ids, fn($id) => $id > 0)));
if ($ids === []) {
return [];
}
$placeholders = implode(',', array_fill(0, count($ids), '?'));
$sql = 'SELECT id, email FROM users WHERE id IN (' . $placeholders . ')';
$stmt = $pdo->prepare($sql);
foreach ($ids as $i => $id) {
$stmt->bindValue($i + 1, $id, PDO::PARAM_INT);
}
$stmt->execute();
$rows = $stmt->fetchAll();LIMIT 也常被问到。部分驱动和数据库支持把 LIMIT 作为占位符并绑定整数;如果当前环境报错,可以严格校验为整数后再拼接。关键是不要直接拼接未经校验的用户输入。
$limit = filter_var($limit, FILTER_VALIDATE_INT, [
'options' => ['min_range' => 1, 'max_range' => 100],
]);
if ($limit === false) {
$limit = 20;
}
$sql = 'SELECT id, email FROM users ORDER BY id DESC LIMIT ' . $limit;LIKE 查询应把通配符放在参数值中,而不是写在 SQL 的引号里:
$stmt = $pdo->prepare('SELECT id FROM users WHERE name LIKE :keyword');
$stmt->bindValue(':keyword', '%' . $keyword . '%', PDO::PARAM_STR);
$stmt->execute();如果希望用户输入的 % 和 _ 按普通字符处理,还需要额外定义转义规则,不能只依赖预处理。
常见错误
第一种错误是“假预处理”:先把用户输入拼进 SQL,再调用 prepare。这仍然是把数据当成 SQL 结构,预处理没有发挥作用。
第二种错误是把占位符放进引号里,例如写成 WHERE name = ':name'。此时占位符会被当成普通字符串内容,参数无法按预期替换。
第三种错误是试图用占位符代替表名、列名或 ORDER BY 字段。这类标识符不能像值一样绑定,应该使用固定白名单。
第四种错误是 IN 查询只放一个占位符,然后传入 1,2,3 这样的字符串。数据库会把它当成一个值,而不是三个值,应按元素数量生成占位符。
第五种错误是忽略类型绑定。例如把 LIMIT 参数通过 execute 数组传入,可能被当成字符串,导致语法或类型问题。整数、布尔值和 NULL 应尽量显式绑定。
第六种错误是不处理异常,或者在生产环境直接输出异常 SQL。这样既不利于排查,也可能泄露表结构和敏感数据。应使用异常模式,在服务端记录受控日志,并给用户通用错误提示。
适用边界
PDO 预处理主要保护 SQL 语句中的“值”,不能替代输入校验、权限控制、密码哈希、XSS 防护和 CSRF 防护。动态表名、动态列名、动态排序必须使用白名单;复杂 SQL 仍要关注业务逻辑漏洞。
模拟预处理和原生预处理在行为上可能存在差异,尤其是重复命名占位符、LIMIT 和类型处理。代码在开发环境通过后,仍应确认目标数据库驱动下的表现。本文示例以 MySQL 为主,其他数据库需要按对应驱动的 DSN、属性和语法调整。