PHP PDO bindValue 怎样区分字符串和整数

PHP PDO 的 bindValue() 不会只根据 PHP 变量当前看起来像数字，就自动替你决定 SQL 参数类型。最稳妥的写法是把第三个参数写出来：文本使用 PDO::PARAM_STR，整数使用 PDO::PARAM_INT，空值使用 PDO::PARAM_NULL。省略第三个参数时，手册定义的默认值是 PDO::PARAM_STR。

官方地址：https://www.php.net/pdostatement.bindvalue.php

判断绑定类型时先看数据库字段和业务语义，再看输入是否已经完成转换；不要把“由表单传来的数字字符串”直接等同于整数。

先用 PDO::PARAM_* 明确绑定类型

下面的例子同时查询整数主键和文本状态。$userId 是应用内部已经确认的整数，$status 是业务文本，因此两个占位符使用不同的参数类型。

prepare($sql);

// id 对应整数列，避免把业务上的整数意图隐藏在默认字符串类型里。
$stmt->bindValue(':id', $userId, PDO::PARAM_INT);

// status 是文本列，即使内容看起来像数字，也按字符串绑定。
$stmt->bindValue(':status', $status, PDO::PARAM_STR);

// execute 返回失败时由异常模式或调用方统一处理。
$stmt->execute();
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

这里的关键不是让数据库“猜”类型，而是让代码把参数契约写在调用点。PDO::PARAM_INT 表示 SQL INTEGER，PDO::PARAM_STR 表示字符串参数。绑定类型不能替代表结构设计，也不会把文本列变成整数列。

理解 bindValue 的默认值与迁移风险

bindValue(string|int $param, mixed $value, int $type = PDO::PARAM_STR) 的第三个参数可以省略，但省略不等于“按照变量的 PHP 类型自动推断”。例如下面两行都没有显式指定类型，维护者很容易误以为第二行会因为值为整数而自然使用整数参数。

bindValue(':id', 42);
$stmt->bindValue(':name', 'alice');

// 迁移时把字段意图补齐，代码读起来更接近 SQL 契约。
$stmt->bindValue(':id', 42, PDO::PARAM_INT);
$stmt->bindValue(':name', 'alice', PDO::PARAM_STR);

默认字符串绑定不一定立刻导致查询错误，但它会把输入转换、驱动行为和数据库比较规则混在一起。尤其是分页、主键、状态码等字段，显式写出整数类型更容易发现调用方传入了错误的数据。

因此，旧代码迁移时优先检查两类参数：一类是表单、JSON 或 URL 中读出的“数字字符串”，另一类是数据库字段明确为整数、但代码长期省略第三个参数的条件。前者要先完成业务层转换，后者要补上 PDO::PARAM_INT。

按输入边界选择绑定方式

PHP 中的 $_GET、$_POST 和许多 JSON 解码结果可能把数字保留为字符串。判断绑定类型时，推荐把“输入清洗”和“PDO 绑定”分成两个动作：先验证并转换，再按转换后的业务类型绑定。

bindValue(':page', $page, PDO::PARAM_INT);

// 空值要保留 NULL 语义，不要把 null 强行转成空字符串。
$nickname = $input['nickname'] ?? null;
$stmt->bindValue(
    ':nickname',
    $nickname,
    $nickname === null ? PDO::PARAM_NULL : PDO::PARAM_STR
);

'42' 是字符串，42 才是整数；两者都可能来自用户输入，但处理责任不同。不要仅用 is_numeric() 就把值当成整数，因为它也会接受小数、带空格的文本或其他不符合当前字段约束的形式。整数参数还应根据业务规则检查范围，不能只依赖 PDO 的类型常量。

布尔值和大整数也要单独考虑。PDO 有 PDO::PARAM_BOOL，但前端的 "0"、"1"、"false" 并不天然具有同一布尔语义；大于 PHP 整数范围的编号不要盲目绑定成 PDO::PARAM_INT，应先确认数据库字段和驱动的可表示范围，必要时按字符串处理。

把类型判断收敛到可复用代码

当一个查询有多个可选条件时，不建议在循环里凭字段名猜类型。可以让参数映射同时保存值和 PDO 类型，使 SQL 条件、输入转换和绑定规则保持一一对应。

 ['value' => $userId, 'type' => PDO::PARAM_INT],
    ':keyword' => ['value' => $keyword, 'type' => PDO::PARAM_STR],
];

foreach ($params as $name => $definition) {
    // 每个定义都来自已完成校验的业务变量。
    $stmt->bindValue($name, $definition['value'], $definition['type']);
}

if (!$stmt->execute()) {
    // 非异常模式下必须显式处理 execute 的失败返回值。
    throw new RuntimeException('查询执行失败');
}

这种方式适合固定字段集合，不适合把任意用户输入直接拼成列名、排序方向或 SQL 片段。占位符只能替代值，动态列名仍需要白名单。无论采用数组映射还是封装函数，类型表都应由服务端代码维护。

迁移后的检查清单

把旧的默认字符串绑定改成显式类型后，可以按下面顺序做一次回归检查：

• 确认每个占位符名称与 SQL 中的参数一致，问号占位符使用从 1 开始的位置。
• 确认数据库字段和业务语义：整数使用 PDO::PARAM_INT，文本使用 PDO::PARAM_STR，空值使用 PDO::PARAM_NULL。
• 确认表单或 JSON 的数字字符串已经完成格式、范围和必填校验，再转换成整数。
• 确认 null、空字符串、false 和字符串 "0" 没有被业务代码混为一谈。
• 确认 PDO 的错误模式和异常处理策略统一，失败时不会静默继续使用不完整结果。

结论可以压缩成一句话：bindValue() 的第三个参数是类型声明，不是可有可无的格式装饰。对整数和字符串写出不同的 PDO::PARAM_*，再把输入转换放在绑定之前，代码的行为边界会清楚很多。

常见追问

数字字符串能不能直接用 PDO::PARAM_INT？

可以在已经确认它是合法整数并完成转换时使用。更推荐先用过滤和范围校验得到真正的整数，再绑定，而不是把任意用户传入的字符串直接交给整数参数。

字符串数字什么时候仍然应该用 PDO::PARAM_STR？

当字段语义是文本，例如订单号、邮编、带前导零的编码或需要保留精确字符形式的编号时，即使内容只包含数字，也应按字符串处理。

bindValue 和 bindParam 的类型参数一样吗？

两者都可以使用 PDO::PARAM_* 常量，但 bindValue() 绑定调用当下的值，bindParam() 绑定变量本身。只讨论一次查询参数时，bindValue() 通常更直观。