PHP PDO::ATTR_ORACLE_NULLS 怎样处理空字符串

如果同一列在业务代码里有时表现为空字符串、有时表现为 null，先看 PDO 的取数属性，而不要急着改 SQL。PDO::ATTR_ORACLE_NULLS 控制的是取回结果时如何处理空字符串：PDO::NULL_NATURAL 保持自然结果，PDO::NULL_EMPTY_STRING 把空字符串转成 SQL NULL，PDO::NULL_TO_STRING 则把取到的 NULL 转成空字符串。

官方地址：https://www.php.net/manual/en/pdo.constants.php

要把空字符串当作 NULL 读取，设置 PDO::ATTR_ORACLE_NULLS 为 PDO::NULL_EMPTY_STRING；要保留驱动返回的区别，使用 PDO::NULL_NATURAL。这个属性影响 fetch 结果，不会回写数据库。

这个属性到底改变哪一层结果

它是 PDO 连接属性，作用点在“从数据库取回值”这一层。设置它不会把表中的空字符串批量更新成 NULL，也不会替代 INSERT、UPDATE 时的参数绑定。先把这条边界记住，排查结果才不会走偏。

三种常量可以这样理解：

怎样设置并确认当前模式

建议在连接创建后立即设置，并在调试或启动检查中读取一次属性。代码只负责演示连接属性的使用，具体 DSN、用户名和密码应替换为项目自己的配置，不要写入仓库。

 PDO::ERRMODE_EXCEPTION,
    // 只影响 fetch 结果，不会修改数据库中的原始字段。
    PDO::ATTR_ORACLE_NULLS => PDO::NULL_EMPTY_STRING,
]);

// 读取连接当前模式，排查配置是否真的落在这个连接上。
$mode = $pdo->getAttribute(PDO::ATTR_ORACLE_NULLS);
var_dump($mode === PDO::NULL_EMPTY_STRING);

如果项目使用已有连接，也可以单独调用 setAttribute：

setAttribute(PDO::ATTR_ORACLE_NULLS, PDO::NULL_EMPTY_STRING);

// 用 getAttribute 读取实际值，避免只检查配置文件中的预期值。
$actualMode = $pdo->getAttribute(PDO::ATTR_ORACLE_NULLS);
if ($actualMode !== PDO::NULL_EMPTY_STRING) {
    // 记录属性未按预期生效，具体日志实现按项目规范接入。
    throw new RuntimeException('PDO 空字符串处理模式未生效');
}

三种模式应该怎么选

PDO::NULL_EMPTY_STRING 是“空字符串按 NULL 读取”的直接选择；它适合表单可选字段、导入数据等业务约定，但调用方必须接受返回值可能是 null。如果前端接口约定所有字段都输出字符串，才考虑 PDO::NULL_TO_STRING，并在序列化前确认这不会掩盖“数据库确实没有值”的区别。

默认需要兼容现有代码时，优先从 PDO::NULL_NATURAL 开始。它不会替你做归一化，调用方可以显式判断：

为什么设置后看起来没有变化

第一，属性是连接级设置；如果查询使用的不是刚设置的那个 PDO 实例，结果当然不会变化。第二，驱动组合可能不支持所有通用连接属性，官方文档也提醒要考虑具体数据库驱动。第三，测试数据可能只有普通文本或真正的 NULL，没有空字符串这一行，观察不到差异。

可以用三类数据检查逻辑：一行字段存储空字符串、一行存储 NULL、另一行存储普通文本。然后分别切换三种模式，用严格比较 === 记录 fetch 结果。不要用 empty() 代替判断，因为它会把多个不同的“空”合并。

常见问题

设置 ATTR_ORACLE_NULLS 会修改表数据吗？

不会。它是 PDO 取数属性，写入时仍要在 SQL 和绑定参数层明确决定保存空字符串还是 NULL。

什么时候使用 NULL_TO_STRING？

只有当调用方明确要求字符串输出，并且接受 NULL 与空字符串在接口层合并时才使用。否则保留自然结果更容易追踪数据含义。

怎样知道当前连接的模式？

调用 $pdo->getAttribute(PDO::ATTR_ORACLE_NULLS)，再与三个 NULL 模式常量严格比较；同时确认查询实际使用的是同一个连接。

总结来说，空字符串怎样呈现，取决于连接的取数策略和驱动支持。需要统一为空值时选 PDO::NULL_EMPTY_STRING，需要保留差异时选 PDO::NULL_NATURAL，并始终把“读取转换”和“数据库写入”分开处理。