PHP连接PostgreSQL配置教程

小伙伴们有没有觉得学习文章很有意思？有意思就对了！今天就给大家带来《PHP整合PostgreSQL环境配置教程》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

PHP 默认不自带 PostgreSQL 驱动，需启用 pgsql 和 pdo_pgsql 扩展；未启用时调用相关函数会报“undefined function”或“could not find driver”；应通过 php -m 检查扩展是否加载，并确保 CLI 与 Web 环境的 php.ini 均配置正确，Linux 下安装对应 php-pgsql 包，Windows 下需启用 DLL 并配置 libpq.dll 路径。

PHP 默认不自带 PostgreSQL 驱动，必须显式启用 pgsql 和/或 pdo_pgsql 扩展才能连接 PostgreSQL。没启用就调用 pg_connect() 或 new PDO() 会直接报 Call to undefined function pg_connect() 或 could not find driver。

确认 PostgreSQL 扩展是否已加载

运行 php -m | grep -i pg（Linux/macOS）或 php -m（Windows）查看输出中是否有 pgsql 和 pdo_pgsql。二者用途不同：pgsql 是原生扩展，提供 pg_connect() 等函数；pdo_pgsql 是 PDO 的 PostgreSQL 驱动，用于 PDO 实例。生产环境推荐同时启用两者，便于兼容旧代码和使用 PDO 抽象层。

若未出现，说明扩展未启用，需检查配置。

Linux/macOS 下启用扩展（以 Ubuntu/Debian 为例）

常见错误是只装了 PHP 包，没装 PostgreSQL 扩展包。Ubuntu 中 php 包默认不含数据库扩展，需单独安装：

• 执行 sudo apt install php-pgsql php-pdo（PHP 8.0+）或 sudo apt install php7.4-pgsql php7.4-pdo（对应版本）
• 确认 /etc/php/*/apache2/php.ini 和 /etc/php/*/cli/php.ini 中已取消注释：
  extension=pgsql
extension=pdo_pgsql
• 重启 Web 服务：sudo systemctl restart apache2 或 sudo systemctl restart php*-fpm

注意：CLI（命令行）和 Web（如 Apache/FPM）可能使用不同 php.ini，务必两边都检查。

Windows 下启用扩展

PHP for Windows 通常自带扩展 DLL，但默认禁用：

• 打开 php.ini（可通过 php --ini 定位路径）
• 取消以下两行的注释（去掉前面的分号）：
  extension=php_pdo_pgsql.dll
extension=php_pgsql.dll
• 确保 extension_dir 指向正确的 DLL 目录（如 "ext"），且该目录下存在对应文件
• 重启 Web 服务器（如 Apache）或 PHP-FPM 进程

如果提示 Unable to load dynamic library 'php_pdo_pgsql.dll'，大概率是 libpq.dll 缺失——需将 PostgreSQL 安装目录下的 bin/（如 C:\Program Files\PostgreSQL\15\bin）加入系统 PATH，或把 libpq.dll 复制到 PHP 的 ext/ 目录。

验证连接与常见错误

写个最小测试脚本确认连通性：

try {
    $pdo = new PDO('pgsql:host=localhost;port=5432;dbname=testdb', 'username', 'password');
    echo "PDO 连接成功\n";
} catch (PDOException $e) {
    echo "PDO 错误: " . $e->getMessage() . "\n";
}

$conn = pg_connect("host=localhost port=5432 dbname=testdb user=username password=password");
if (!$conn) {
    echo "pg_connect 失败\n";
} else {
    echo "pg_connect 成功\n";
}

典型失败原因：

• Connection refused：PostgreSQL 服务未运行，或 postgresql.conf 中 listen_addresses 未包含 localhost
• FATAL: password authentication failed：用户名/密码错，或 pg_hba.conf 未允许该用户从该地址登录
• Unknown host：DNS 解析失败，改用 127.0.0.1 替代 localhost 可绕过 IPv6 解析问题

最易被忽略的是：PHP CLI 和 Web 使用的 php.ini 不同、PostgreSQL 的 pg_hba.conf 权限配置未重载、以及 Windows 下 libpq.dll 路径未生效——这三个点卡住的人最多。

以上就是《PHP连接PostgreSQL配置教程》的详细内容，更多关于的资料请关注golang学习网公众号！