“could not find driver”或“Call to undefined function pg_connect()”说明pdo_pgsql扩展未加载，需通过php -m或PDO::getAvailableDrivers()验证，并在Linux、Windows或Docker中正确安装启用该扩展。
PHP 8 连接 PostgreSQL 时提示 “could not find driver” 或 “Call to undefined function pg_connect()”，说明 pdo_pgsql 扩展未正确加载，不是代码写错了，而是 PHP 缺少与 PostgreSQL 对话的“翻译官”。
确认当前 PHP 是否已启用 pdo_pgsql
在终端执行：php -m | grep pgsql。如果输出为空，或只显示 pdo 没有 pgsql 或 pdo_pgsql，就说明扩展根本没加载。
再运行：php -r "print_r(PDO::getAvailableDrivers());"。若返回数组中不含 "pgsql"，则 PDO 层面完全不认 PostgreSQL 协议——此时任何 DSN 写法都无效。
Linux（Debian/Ubuntu）安装并启用扩展
方法一：一键安装常用组合
立即学习“PHP免费学习笔记（深入）”；
执行：sudo apt install php8.2-pgsql（根据你实际的 PHP 版本调整，如 php8.1-pgsql、php8.3-pgsql）。该命令会自动安装 pdo_pgsql 和 pgsql 两个扩展，并写入配置。
方法二：手动启用（适用于源码编译或自定义安装）
找到 php.ini 文件位置：php --ini → 编辑输出中的 Loaded Configuration File；在文件末尾添加两行：
extension=pdo_pgsqlextension=pgsql
【注意】不要加 .so 后缀，也不要写成 extension=php_pdo_pgsql.so —— PHP 8.0+ 默认使用短名加载机制，写错会导致启动失败且无报错。
重启 Web 服务：sudo systemctl restart php8.2-fpm（FPM 模式）或 sudo systemctl restart apache2（Apache 模式）。
Windows 下修复扩展缺失
第一步：打开 php.ini，取消以下两行前面的分号
;extension=php_pdo_pgsql.dll;extension=php_pgsql.dll
第二步：确认 extension_dir 指向正确的 ext 目录，例如：extension_dir = "C:\php\ext"。
第三步：关键一步——解决 libpq.dll 找不到的问题
如果重启后 phpinfo() 中仍无 pgsql，或 Apache 日志报 “Unable to load dynamic library”，大概率是 libpq.dll 缺失或版本不匹配。不要从 PostgreSQL 安装目录拷 libpq.dll，而应使用 PHP 自带的那个：把 C:\php\libpq.dll 复制到 C:\Apache24\bin\（或你的 Apache / Nginx / CLI 所在 bin 目录）。
第四步：Apache 用户需额外在 httpd.conf 中声明依赖库
在 LoadModule 区块下方插入一行：LoadFile "C:/php/libpq.dll"。路径用正斜杠或双反斜杠，不能用单反斜杠。
Docker 环境下启用 pdo_pgsql
步骤一：修改 Dockerfile，在 RUN 指令中安装扩展
对于 Debian 基础镜像：RUN docker-php-ext-install pdo_pgsql；若提示缺少 pg_config，先加：apt-get update && apt-get install -y libpq-dev。
步骤二：确保扩展被启用
执行 docker exec -it your_php_container php -m | grep pgsql 验证输出含 pdo_pgsql；若无，检查容器内 /usr/local/etc/php/conf.d/docker-php-ext-pdo_pgsql.ini 是否存在且内容为 extension=pdo_pgsql。
步骤三：验证连接可用性
进入容器：docker exec -it your_php_container php -r "$pdo = new PDO('pgsql:host=pg;dbname=test', 'user', 'pass'); echo 'OK';"。这里 host=pg 是容器名，不是 localhost —— 【hostname 必须填 PostgreSQL 服务在 docker-compose.yml 中定义的 service 名】。
