pg_connect调用失败主因是pgsql扩展未启用或配置错误；php 8.3默认不带该扩展，须手动编译（--with-pgsql、--with-pdo-pgsql）或windows下在php.ini中启用php_pgsql.dll并确认extension_dir路径正确，同时需配置pg_hba.conf允许127.0.0.1/md5认证并重启服务。
pg_connect 调用失败，基本就是扩展没装或配置不对
PHP 8.3 默认不带 PostgreSQL 扩展，必须手动启用 pgsql 和 pdo_pgsql。光装 PHP 不等于能连 PostgreSQL —— 这是部署时最常卡住的第一步。
确认 pgsql 扩展是否已编译进 PHP
- Linux 源码编译安装 PHP 8.3 时，
./configure必须显式加这两项：-
--with-pgsql=/usr（PostgreSQL 客户端头文件和库路径，常见于/usr或/usr/pgsql-16） --with-pdo-pgsql=/usr
-
- 如果跳过这两项，
php -m | grep pg就不会输出任何内容，pg_connect直接报Call to undefined function pg_connect()。
Windows 下启用 pgsql 扩展更简单但容易漏改 php.ini
- 解压 PHP 8.3 NTS 版后，打开
php.ini，取消注释这两行：extension=php_pgsql.dllextension=php_pdo_pgsql.dll
- 同时确认
extension_dir指向正确，比如：extension_dir = "C:\php\ext" - 改完必须重启
php-cgi.exe或 Web 服务，仅重载 Nginx 不生效。
连接字符串写法与常见权限陷阱
-
pg_connect的 DSN 格式建议用关键词式，避免空格或特殊字符引发解析错误：- ✅ 正确：
"host=localhost port=5432 dbname=mydb user=appuser password=xxx" - ❌ 错误：
"host=localhost;dbname=mydb;..."（分号在 Windows 命令行里会被截断）
- ✅ 正确：
- PostgreSQL 默认拒绝
localhost的 TCP 连接，除非pg_hba.conf明确允许：- 加一行：
host all all 127.0.0.1/32 md5 - 然后
pg_ctl reload或systemctl reload postgresql-16
- 加一行：
- 用户密码为空、或用户没被授予数据库
CONNECT权限，也会导致pg_connect静默失败（返回 false，无详细错误）—— 开发时务必加or die(pg_last_error())。
pdo_pgsql 比原生 pg_* 函数更推荐，但初始化方式不同
- PDO 连接需捕获
PDOException，且 DSN 格式固定：$pdo = new PDO('pgsql:host=localhost;port=5432;dbname=mydb', 'appuser', 'xxx');
- 若 PostgreSQL 服务未运行，PDO 构造会抛异常；而
pg_connect只返回 false，不易察觉。 - 注意：PHP 8.3 对
PDO::ATTR_ERRMODE默认仍是PDO::ERRMODE_SILENT，不设PDO::ERRMODE_EXCEPTION就看不到错误细节。
扩展名、路径、权限、错误处理方式 —— 四个点只要漏一个，pg_connect 就起不来。尤其容易忽略的是 pg_hba.conf 配置和 Windows 下 php.ini 的 extension_dir 绝对路径。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
