PHP 查数据库,别再拼 SQL:PDO 参数绑定实战

假设你在做一个文章列表页,要根据邮箱查询作者。最省事的写法是把输入直接拼进 SQL;最省事的后果,可能是 SQL 注入。正确做法不是手动给引号加反斜杠,而是把 SQL 结构和数据分开。

示例使用 PHP 8 和 MySQL,已有数据库 blog、只读账号以及 users(id, email, name) 表;运行前自行创建测试数据。凭据由环境变量提供,真实部署要使用受保护的密钥管理方式。

<?php
declare(strict_types=1);

$dsn = 'mysql:host=127.0.0.1;dbname=blog;charset=utf8mb4';
$pdo = new PDO($dsn, getenv('DB_USER'), getenv('DB_PASSWORD'), [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_EMULATE_PREPARES => false,
]);

$email = trim($_GET['email'] ?? '');
if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
    http_response_code(400);
    exit('邮箱格式不正确');
}

$stmt = $pdo->prepare('SELECT id, name FROM users WHERE email = :email LIMIT 1');
$stmt->execute(['email' => $email]);
$user = $stmt->fetch(PDO::FETCH_ASSOC);

header('Content-Type: text/html; charset=utf-8');
if (!$user) {
    http_response_code(404);
    exit('未找到用户');
}
echo htmlspecialchars($user['name'], ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');

本地测试可配置临时测试数据库和环境变量,再运行 php -S 127.0.0.1:8000。PHP 内置服务器只适合开发测试,不应作为公网生产服务器。生产环境不要向用户暴露数据库异常堆栈,应在服务端记录脱敏错误并返回通用错误页。

绑定参数不等于所有输入都安全

参数绑定保护的是 SQL 值。表名、字段名、排序方向不能当作普通值占位;如果用户选择排序,应用应该从固定映射中选取,不要直接拼原始输入:

$sorts = ['name' => 'name', 'id' => 'id'];
$sort = $sorts[$_GET['sort'] ?? ''] ?? 'id';
$sql = "SELECT id, name FROM users ORDER BY $sort LIMIT 20";

这里拼进去的值来自代码中的固定白名单,不是未经验证的输入。htmlspecialchars 则解决 HTML 文本上下文中的输出转义,与 SQL 参数绑定是两道不同的防线。放进 JavaScript、URL 或 HTML 属性等不同上下文时,还需要对应的安全处理。

上线前再检查三件事

第一,数据库账号按用途授权;查询页面无需 DROP 表权限。第二,错误和访问日志不能记录密码、会话令牌等敏感数据。第三,用户资料是否允许匿名查询是授权问题,参数绑定无法替你决定;即使示例能查到邮箱,也不代表生产环境可以公开该接口。

写入数据时还要考虑事务

假设一次操作要创建订单并扣减库存,两条 SQL 应在同一数据库事务内按业务规则处理;成功后提交,失败则回滚。事务不是“自动不会超卖”:库存更新需要合适的条件、隔离级别和并发控制。例如以条件更新检查受影响行数,再决定是否提交;跨数据库和外部支付又是另一类问题。

此外,查询接口的邮箱参数可能出现在服务器访问日志、浏览器历史和代理日志中。如果这是敏感信息,应评估是否改变接口设计、减少日志字段并执行严格授权。验证邮箱格式只说明输入形状合理,不证明访问者有权查询该用户。

参考:PHP PDO 预处理;htmlspecialchars。