如何创建PDO数据库连接类？解决方法内连接变量为null的问题

当然可行！这种把PDO连接实例封装在类内部、供所有类方法调用的需求非常合理且常用，你遇到的连接变量返回null的问题，基本是变量作用域、属性声明或者连接初始化失败导致的，咱们一步步来排查解决。

一、先排查常见的错误原因 #

1. 未正确声明类成员属性 #

很多时候是在构造函数里直接赋值给了局部变量，而不是类的成员属性，导致类方法根本访问不到正确的连接实例：

class DB {
    public function __construct() {
        // 这里的$pdo是构造函数的局部变量，不是类属性
        $pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
    }

    public function getConnection() {
        return $this->pdo; // 这里的$this->pdo从未被赋值，自然返回null
    }
}

解决办法：先在类中显式声明成员属性，再用$this->赋值。

2. PDO连接初始化失败（未捕获异常） #

PDO在连接失败时会抛出PDOException，如果没捕获异常，代码会直接终止，导致类属性没被赋值，最终返回null：

class DB {
    private $pdo;

    public function __construct() {
        // 连接失败直接抛出异常，代码中断，$this->pdo没被赋值
        $this->pdo = new PDO('mysql:host=wrong-host;dbname=test', 'user', 'pass');
    }
}

解决办法：添加异常捕获，同时检查数据库地址、用户名、密码等参数是否正确。

3. 错误的属性访问方式 #

在类方法里直接用$pdo而不是$this->pdo，会访问局部变量而非类属性，自然返回null。

二、正确的实现示例 #

下面是一个完整的、可运行的PDO连接类示例，包含异常处理和方法调用：

class Database {
    // 声明类成员属性，专门存储PDO连接实例
    private $pdo;

    public function __construct(string $host, string $dbname, string $user, string $pass) {
        try {
            // 初始化PDO连接，并赋值给类属性
            $this->pdo = new PDO(
                "mysql:host=$host;dbname=$dbname;charset=utf8mb4",
                $user,
                $pass,
                [
                    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // 开启异常模式，方便排查错误
                    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // 默认返回关联数组
                ]
            );
        } catch (PDOException $e) {
            // 捕获连接异常，生产环境建议写入日志而非直接输出
            die("数据库连接失败: " . $e->getMessage());
        }
    }

    // 示例方法：使用类内的PDO连接执行查询
    public function fetchAll(string $sql, array $params = []): array {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetchAll();
    }

    // 对外提供获取PDO连接实例的方法
    public function getConnection(): PDO {
        return $this->pdo;
    }
}

// 使用示例
$db = new Database('localhost', 'your_db_name', 'your_username', 'your_password');
// 调用类方法执行查询
$users = $db->fetchAll("SELECT * FROM users WHERE age > ?", [18]);
// 直接获取PDO连接实例
$pdoInstance = $db->getConnection();
var_dump($pdoInstance); // 这里会输出PDO对象，而非null

三、关键注意事项 #

• 必须在类中显式声明成员属性（如private $pdo;），否则$this->pdo会被视为动态属性，在PHP严格模式下会报错，且容易出现未赋值的情况。
• 始终开启PDO的异常模式，这样连接或查询失败时能及时捕获错误，避免默默失败导致$pdo为null。
• 在类的所有方法中，必须通过$this->属性名来访问类成员属性，不能直接用变量名。

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