PHP PDO连接PostgreSQL数据库的基础类实现

数据库连接的准备工作

在运行提供的核心代码之前，项目中必须包含一个位于根目录 ./config/db.json 的配置文件。该文件需要以 JSON 格式存储数据库连接凭证，结构应包含以下字段：

• db_host：数据库服务器地址。
• db_name：目标数据库名称。
• db_port：数据库监听端口（默认为 5432）。
• db_user：数据库用户名。
• db_pwd：数据库密码。

核心操作与代码解析

以下代码展示了一个名为 pgdb 的单例模式的基类实现。它的主要职责是创建并维持一个与 PostgreSQL 的 PDO 连接实例。

第一步：获取配置与构建连接字符串

在类的构造函数中，首先检查静态属性 $PDOInstance 是否已存在。若未初始化，则读取外部配置文件。根据主机地址是否为 localhost，动态添加 Host 参数至连接字符串，确保网络兼容性。

class pgdb {
    public $pdo;
    public static $PDOInstance;
    public $config;

    public function __construct() {
        if (!self::$PDOInstance) {
            // 读取 ./config/db.json 配置文件
            $this->config = json_decode(file_get_contents("./config/db.json"), true);
            $config = $this->config["data_base"];
            
            // 构建 DSN 前缀
            $hosturl = ($config["db_host"] != 'localhost') ? "host={$config['db_host']}" : '';

第二步：执行数据库连接初始化

使用构建好的 DSN（Data Source Name）、用户名和密码实例化 PDO 对象。代码中指定了 PDO::ATTR_PERSISTENT => true 以启用持久化连接，这在高并发场景下通常有助于减少握手开销。

try {
    self::$PDOInstance = new PDO(
        "pgsql:$hosturlport={$config['db_port']};dbname={$config['db_name']}",
        $config['db_user'],
        $config['db_pwd'],
        array(PDO::ATTR_PERSISTENT => true)
    );
} catch (Exception $ex) {
    // 连接失败时的错误处理逻辑
    die('数据库连接异常');
}

第三步：设置环境与安全参数

连接建立后，代码强制执行了三项关键设置以确保稳定性和安全性：

1. 字符集设置：SET client_encoding='UTF-8'，防止中文等复杂字符乱码。
2. 禁用模拟预处理：将 PDO::ATTR_EMULATE_PREPARES 设为 false，交由数据库原生处理预处理语句，增强 SQL 注入防护能力。
3. 异常模式：将 PDO::ATTR_ERRMODE 设为 PDO::ERRMODE_EXCEPTION，使数据库错误能通过标准的 PHP 异常抛出。

第四步：分配局部句柄

完成全局单例 $PDOInstance 的设置后，将其赋值给当前实例的 $this->pdo 属性，以便后续在该类的其他方法中进行查询操作。

注意事项

原文中的错误处理分支包含了直接输出 HTML 页面的逻辑，且引用了外部的 layer.js 资源。在生产环境中，建议移除具体的 UI 框架依赖，转而使用更轻量级的日志记录方式来处理“服务器变更”或“连接重置”等状态，保持代码库的独立性。

以上就是 PHP PDO 连接 PostgreSQL 基础代码的详细内容，更多关于 PHP 数据库开发的资料请关注本站其它相关文章！