
本文讲解如何在php中正确使用预处理语句传递参数,避免sql注入风险,强调列名不可参数化、仅值可占位,并提供安全、可复用的代码实践。
本文讲解如何在php中正确使用预处理语句传递参数,避免sql注入风险,强调列名不可参数化、仅值可占位,并提供安全、可复用的代码实践。
在编写数据库操作函数时,一个常见误区是试图将列名(如字段名、表名、条件字段)当作参数动态传入SQL语句——正如示例中 $res 和 $fabrik 被直接拼入 SQL 字符串。这是严重安全隐患:不仅易受SQL注入攻击(例如传入 `res` = 1; DROP TABLE village; --),还会导致语法错误(如反引号包裹的 $villageID 实际是数值,不应被当列名引用)。
✅ 正确做法是:仅允许数据值通过参数占位符(? 或命名参数)绑定;所有标识符(列名、表名、WHERE 条件字段名等)必须硬编码或通过白名单严格校验后拼接。
以下是重构后的安全实现:
public function setVillageRes(int $villageID, int $ownerID, string $resColumn, mixed $newValue, string $fabrikColumn = 'fabrik') {
// 1. 先验证输入的列名是否合法(白名单机制)
$allowedColumns = ['wood', 'stone', 'iron', 'crop', 'pop', 'storage', 'market']; // 根据实际字段调整
if (!in_array($resColumn, $allowedColumns) || !in_array($fabrikColumn, $allowedColumns)) {
throw new InvalidArgumentException('Invalid column name provided.');
}
// 2. 查询村庄是否存在(使用参数化)
$stmt = $this->pdo->prepare("SELECT 1 FROM village WHERE villageID = ? AND ownerID = ?");
$stmt->execute([$villageID, $ownerID]);
if (!$stmt->fetch()) {
return "RE-3001";
}
// 3. 安全构建UPDATE语句:列名硬编码/白名单校验,仅值参数化
$sql = "UPDATE village SET `$resColumn` = ? WHERE villageID = ? AND `$fabrikColumn` = ?";
$stmt = $this->pdo->prepare($sql);
$stmt->execute([$newValue, $villageID, $fabrikColumn === 'fabrik' ? $fabrikColumn : $newValue]); // 注意:此处 $fabrik 的含义需明确——若为值,则不应加反引号;若为列名,需另传对应值参数
return $stmt->rowCount() > 0 ? 'SUCCESS' : 'NO_UPDATE';
}
⚠️ 关键注意事项:
-
永远不要用
?占位符替代列名、表名或关键字 —— PDO 不支持,且会破坏SQL结构; - 对动态列名必须做白名单校验,禁止直接拼接用户输入;
- 示例中原
$fabrik变量用途模糊:若它是列名,需单独校验并用于SQL拼接;若它是匹配值,则应作为第三个参数值传入,且不能加反引号; - 建议统一使用命名参数(
:column,:value)提升可读性,尤其在复杂语句中; - 所有数据库操作应配合异常处理(如
try/catch(PDOException))增强健壮性。
通过这种方式,你只需维护一个函数,即可安全支持任意合法资源字段的更新,真正实现「一次编写、多处复用」的设计目标。









