深入理解PHP 8.1方法签名兼容性与废弃警告处理

Deprecated: Return type of OM\Db::prepare(string $statement, $driver_options = null) should either be compatible with PDO::prepare(string $query, array $options = []): PDOStatement|false, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in //OM/Db.php on line 114

<?php

namespace OM;

class Db extends \PDO
{
    protected ?array $driver_options = null;
    protected ?array $options = null;

    // 声明与父类PDO::prepare兼容的返回类型
    public function prepare(string $statement, ?array $driver_options = null): \PDOStatement|false // PHP 8.0+ 支持联合类型
    {
        $statement = $this->autoPrefixTables($statement);

        // 注意：这里传入的 $driver_options 在 PDO::prepare 中对应 $options
        // 确保传递给父类的方法参数类型和顺序也是兼容的
        $DbStatement = parent::prepare($statement, \is_array($driver_options) ? $driver_options : []);
        $DbStatement->setQueryCall('prepare');
        $DbStatement->setPDO($this);

        return $DbStatement;
    }

    // 假设 autoPrefixTables 是一个辅助方法
    private function autoPrefixTables(string $statement): string
    {
        // 实际的表前缀逻辑
        return $statement;
    }
}

<?php

namespace OM;

class Db extends \PDO
{
    protected ?array $driver_options = null;
    protected ?array $options = null;

    // 使用 #[ReturnTypeWillChange] 属性抑制废弃警告
    #[\ReturnTypeWillChange]
    public function prepare(string $statement, ?array $driver_options = null) // 此时可以不声明返回类型
    {
        $statement = $this->autoPrefixTables($statement);

        $DbStatement = parent::prepare($statement, \is_array($driver_options) ? $driver_options : []);
        $DbStatement->setQueryCall('prepare');
        $DbStatement->setPDO($this);

        return $DbStatement;
    }

    private function autoPrefixTables(string $statement): string
    {
        return $statement;
    }
}