phpEnv 不提供 PostgreSQL 安装与管理功能，PostgreSQL 需独立安装并配置；PHP 连接 PostgreSQL 前必须启用 pgsql 扩展、正确配置 pg_hba.conf 并验证连接返回值。
phpEnv 本身不提供 PostgreSQL 服务安装能力 —— 它只是 PHP 版本管理工具，类似 pyenv 或 rbenv，只管 PHP 解释器的切换，不管数据库。
phpEnv 环境下 PostgreSQL 必须独立安装
你看到的“phpEnv 支持 PostgreSQL”是误解。phpEnv 不会帮你启动 postgres 进程、不生成数据目录、不修改 pg_hba.conf，也不会自动配置监听端口。PostgreSQL 必须作为系统级服务单独部署。
- Windows 用户：直接下载官方
postgresql-x64-binaries或使用 EDB Installer，安装后手动启动服务 - macOS 用户：用
brew install postgresql，再运行brew services start postgresql - Linux（Debian/Ubuntu）：执行
sudo apt-get install postgresql postgresql-contrib，服务通常自动启用
验证是否就绪：终端运行 psql --version 和 pg_isready -h localhost -p 5432。后者返回 accepting connections 才算真正可用。
PHP 要连接 PostgreSQL，必须启用 pgsql 扩展
即使 PostgreSQL 服务跑起来了，phpEnv 管理的每个 PHP 版本默认都不带 pgsql 扩展。不启用它，pg_connect() 函数根本不存在，调用时直接报 Fatal error: Uncaught Error: Call to undefined function pg_connect()。
立即学习“PHP免费学习笔记（深入）”；
- 先确认当前 phpEnv 使用的 PHP 版本：
phpenv version - 找到该版本对应的
php.ini路径：php --ini输出中的 “Loaded Configuration File” - 编辑该文件，取消注释这两行：
extension=pgsql和extension=pdo_pgsql - 重启 Web 服务器（如 Apache/Nginx）或 CLI 环境（若用 php-fpm，需 reload fpm）
- 用
php -m | grep pgsql验证扩展已加载
连接字符串写错会导致静默失败，不是报错
pg_connect() 在参数缺失、用户无权限、网络不通或数据库名不存在时，**不会抛出异常，而是返回 false**。如果你没检查返回值，脚本会继续执行，后续 pg_query() 直接崩溃并提示 Warning: pg_query(): supplied resource is not a valid PostgreSQL link resource。
- 务必检查连接结果：
if (!$conn) { die('连接失败: ' . pg_last_error()); } - 连接字符串中不要漏掉
host=—— 即使是本地，也建议显式写host=localhost，避免 Unix socket 路径不一致问题 - 密码含特殊字符（如
@、/）要 URL 编码，否则解析会截断；更稳妥的做法是改用数组形式传参（PHP 8.1+ 支持）：pg_connect(['host' => 'localhost', 'dbname' => 'test', 'user' => 'u', 'password' => 'p@ss'])
最常被跳过的一步：PostgreSQL 默认拒绝所有远程连接，且本地连接也受 pg_hba.conf 控制。哪怕 PHP 和 PostgreSQL 都装好了、扩展也启了，只要这一行没加进去：host all all 127.0.0.1/32 md5，连接就会卡在认证环节，表现为超时或拒绝。改完记得 pg_ctl reload 或重启服务。
