PHP PDO::ATTR_STRINGIFY_FETCHES怎样避免查询结果类型被转成字符串

如果 PDO 查出来的整数、浮点数总是变成字符串，先看连接属性 PDO::ATTR_STRINGIFY_FETCHES。它控制的是“读取结果是否字符串化”，不是参数绑定，也不是数据库字段类型修复。想让结果保持更接近驱动原本的类型，可以在创建连接后显式设置为 false；但金额精度、业务标识和跨驱动一致性仍然应该由应用层的类型契约负责。

官方资料：https://www.php.net/manual/en/pdo.setattribute.php

我在排查这类问题时，最容易踩的坑是把“看到字符串”直接归因于 PDO。实际上，连接属性、驱动实现、数据库列定义和 DTO 转换可能同时参与结果形状。下面把它们拆开，给出一套更稳的选择方式。

先把读取结果当成连接契约

PDO::ATTR_STRINGIFY_FETCHES 的语义很窄：当它为 true 时，读取到的非 NULL 值会被转成字符串；为 false 时，PDO 不主动把所有非空值统一字符串化。NULL 仍然是一个例外，不会因为这个属性就变成普通字符串。

这意味着它应该在连接初始化阶段决定，而不是在每个查询之后临时猜测。连接池、命令行脚本和 Web 请求如果使用了不同的初始化代码，就可能出现同一条 SQL 在不同入口返回不同的 PHP 类型。

 PDO::ERRMODE_EXCEPTION,
    // 关闭统一字符串化，保留驱动可提供的基本类型信息。
    PDO::ATTR_STRINGIFY_FETCHES => false,
]);

// 读取当前值，排查配置是否被连接工厂或驱动覆盖。
$stringify = $pdo->getAttribute(PDO::ATTR_STRINGIFY_FETCHES);
var_dump($stringify);

这里的重点不是“永远关闭字符串化”，而是让配置成为可读、可检查的连接契约。若项目确实需要所有读取值都以字符串传递给下游，也可以设置为 true，但必须把这个决定写在连接工厂里，而不是依赖默认行为。

把预处理模式、参数绑定和结果类型分开

我通常会把下面三个问题分成三个开关来处理：

例如，分页参数应该在输入边界校验并按整数绑定；查询结果中的金额则不适合简单地强制转成浮点数。把这些责任都塞给 ATTR_STRINGIFY_FETCHES，最后只会得到一个看似统一、实际语义模糊的数组。

按字段语义选择转换责任

关闭字符串化后，并不代表所有字段都应该直接交给业务代码。更实用的做法是：先保留读取层的事实，再在仓储层或 DTO 层按字段语义转换。

• 计数和分页编号：读取后可以在明确边界转成整数，并处理超出范围的情况。
• 金额和高精度数值：不要因为看到数字就直接转成浮点数，可按项目的 decimal 方案保存或计算。
• 文本标识：订单号、外部编号、带前导零的编码即使看起来像数字，也应该保持字符串。
• NULL：保留空值语义，避免用空字符串替换后让“没有值”和“值为空”无法区分。

 (string) $row['order_no'],
        'item_count' => $count,
        // 金额先保留字符串，精度计算交给项目选定的 decimal 方案。
        'amount' => $row['amount'],
    ];
}

用 getAttribute 判断“当前连接到底怎么配的”

当线上和本地的结果类型不一致时，不要只看配置文件。可以在连接建立后记录属性值，结合驱动名称和数据库版本一起定位。PDO::getAttribute 能读取部分连接属性；某些驱动不支持的属性会抛出异常，因此诊断代码也应该有清晰的边界。

getAttribute(PDO::ATTR_DRIVER_NAME);
$stringify = $pdo->getAttribute(PDO::ATTR_STRINGIFY_FETCHES);

printf(
    "driver=%s stringify_fetches=%s\n",
    $driver,
    $stringify ? 'true' : 'false'
);

这段信息适合出现在应用启动日志或诊断命令里，不需要写入业务表。它的作用是把“结果变成字符串”从猜测变成一个可定位的连接状态。

驱动差异决定了最终结果仍要有契约

PDO 提供通用属性，但具体返回类型还会受到驱动和数据库列定义影响。PHP 官方手册明确说明，ATTR_STRINGIFY_FETCHES 控制非 NULL 读取值是否转成字符串；这并不承诺所有驱动、所有数值范围都以同样的 PHP 类型呈现。

因此，我更推荐下面的分层策略：

1. 连接工厂显式设置 ATTR_STRINGIFY_FETCHES，并用 getAttribute 记录实际值。
2. 仓储层按字段名和业务语义整理原始结果，不把所有字段统一强转。
3. DTO 或响应层再决定对外 API 的 JSON 表示，尤其注意大整数、金额和前导零。
4. 测试至少覆盖 NULL、小整数、较大整数、精确小数和文本编号。

最后用一张表决定设置方式

一句话总结：PDO::ATTR_STRINGIFY_FETCHES 适合用来固定“读取层是否统一字符串化”的策略，但不应该承担参数类型、金额精度、标识语义和跨驱动兼容的全部责任。把属性放在连接工厂，把转换放在明确的应用边界，排查结果类型问题会快很多。

常见问题

关闭 ATTR_STRINGIFY_FETCHES 后，所有整数都会变成 PHP int 吗？

不一定。它只是关闭 PDO 对非 NULL 值的统一字符串化，最终类型仍和驱动、字段定义、数值范围有关。

ATTR_STRINGIFY_FETCHES 会影响 bindValue 的参数类型吗？

不会。参数类型应由绑定方式和输入校验决定，读取结果的字符串化是另一条配置路径。

为什么 NULL 还是 NULL？

官方定义把 NULL 排除在“非 NULL 值转成字符串”之外，因此不要用这个属性替代空值处理规则。