PHP PDO_PgSQL如何直接处理布尔值false写入PostgreSQL（无需转字符串）

问题描述 #

环境：PHP 7.4.2、PostgreSQL 13.3、pdo_pgsql扩展，启用严格类型。

实现的PDO更新函数：

public function setAdministratorFlag(int $userID, bool $administrator):void {
    $statement = $this->db->prepare("
        update users set
        administrator = :administrator
        where id = :id;
    ");

    $statement->execute([
        "id" => $userID,
        "administrator" => $administrator,
    ]);
}

数据库字段定义：

administrator boolean not null default false

异常情况：传入$administrator = true时执行正常，传入false时抛出如下错误：

Invalid text representation: 7 ERROR: invalid input syntax for type boolean: ""

临时修复：添加$administrator = $administrator === false ? "false" : $administrator;后可正常执行，但希望找到无需手动转换字符串，让PDO直接识别布尔值false的方法。

解决方案 #

1. 关闭PDO模拟预处理（推荐） #

问题根源是PDO默认开启了模拟预处理（ATTR_EMULATE_PREPARES = true），此时PDO会将所有参数转为字符串传递给PostgreSQL，布尔值false会被转成空字符串，导致PostgreSQL无法识别为布尔类型。

在初始化PDO连接时添加该属性，关闭模拟预处理：

$this->db = new PDO(
    'pgsql:host=你的主机;dbname=你的数据库',
    '用户名',
    '密码',
    [
        PDO::ATTR_EMULATE_PREPARES => false,
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION // 保持异常模式，可选
    ]
);

关闭模拟预处理后，PDO会使用PostgreSQL原生的预处理机制，正确传递布尔类型参数，无需手动转换。

2. 手动绑定参数并指定类型 #

如果无法修改全局PDO连接配置，可以在执行SQL前手动绑定参数，明确指定参数类型为PDO::PARAM_BOOL：

public function setAdministratorFlag(int $userID, bool $administrator):void {
    $statement = $this->db->prepare("
        update users set
        administrator = :administrator
        where id = :id;
    ");
    
    $statement->bindParam(':id', $userID, PDO::PARAM_INT);
    $statement->bindParam(':administrator', $administrator, PDO::PARAM_BOOL);
    
    $statement->execute();
}

通过bindParam指定类型后，PDO会正确处理布尔值，即使模拟预处理开启也能避免错误。

内容的提问来源于stack exchange，提问作者Łukasz Przybylski