PHP8升级后自定义Sql类的query方法与PDO不兼容报错如何解决

问题原因 #

你的DB\Sql类继承了PHP原生的PDO类，PHP 8.0 开始对类继承的方法签名兼容性执行更严格的强制校验：子类重写父类的方法时，参数结构、类型声明必须和父类保持一致。你自定义的query方法参数和原生PDO::query的参数不匹配，所以触发致命错误。

原生PDO的query方法签名为：

public PDO::query(string $query, ?int $fetchMode = null, mixed ...$fetchModeArgs): PDOStatement|false

解决方案 #

方案1（最推荐）：修改自定义方法名 #

你当前实现的query方法实际是带参数绑定的预处理查询，和原生PDO的query功能定位本身就有差异，直接修改方法名避免和父类方法重名即可，比如改成prepareQuery或者executeQuery，所有调用该方法的位置同步修改方法名即可，完全不会产生兼容性问题。

修改后的方法示例：

// 方法名修改，不再重写父类PDO的query方法
public function executeQuery($query, $parameters=array()) {
    $statement = $this->conection->prepare($query);
    foreach ($parameters as $key => $value) {
        $statement->bindValue($key,$value);
    }
    $statement->execute();
    return $statement;
}

方案2：兼容父类方法签名 #

如果你必须保留query作为方法名，可以修改方法签名和父类保持一致，同时兼容你原有的传参逻辑：

public function query(string $query, mixed $parameters = [], ?int $fetchMode = null, mixed ...$fetchModeArgs)
{
    // 第二个参数为数组时走自定义绑定逻辑
    if (is_array($parameters)) {
        $statement = $this->conection->prepare($query);
        foreach ($parameters as $key => $value) {
            $statement->bindValue($key, $value);
        }
        $statement->execute();
        // 兼容原生fetchMode参数
        if ($fetchMode !== null) {
            $statement->setFetchMode($fetchMode, ...$fetchModeArgs);
        }
        return $statement;
    }
    // 非数组参数时走原生PDO query逻辑
    return $this->conection->query($query, $parameters, ...$fetchModeArgs);
}

额外提示：你的类属性名存在拼写错误，$conection应为$connection，不影响当前报错修复，可顺手修正避免后续维护问题。

内容的提问来源于stack exchange，提问作者Ami