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 包默认不含数据库扩展，需单独安装：
立即学习“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=pgsqlextension=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.dllextension=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 路径未生效——这三个点卡住的人最多。
