phpEnv 不能安装 PostgreSQL，它仅管理 PHP 版本与环境；要支持 pg_connect() 或 PDO，须单独安装 PostgreSQL 服务并确保 PHP 编译时已包含 pgsql 扩展（需 libpq-dev 依赖）。
phpEnv 本身不提供 PostgreSQL 数据库服务，也不能直接安装或管理 PostgreSQL 扩展——它只负责 PHP 版本和环境的切换。想让 PHP 通过 pg_connect() 或 PDO 连上 PostgreSQL，必须在系统级单独安装 PostgreSQL 服务 + PHP 的 pgsql 扩展，phpEnv 只能帮你切换到已编译好该扩展的 PHP 版本。
phpEnv 能不能装 PostgreSQL？
不能。phpEnv 是一个 PHP 版本管理工具（类似 pyenv），它的职责仅限于：
- 下载、编译、切换不同版本的 PHP 二进制文件
- 管理
php.ini路径和扩展加载（前提是扩展已存在） - 不触碰数据库服务、不修改系统包、不执行
apt install postgresql类操作
如果你运行 phpenv install 8.2.10，它只会编译 PHP，不会自动装 PostgreSQL，也不会帮你启用 pgsql.so ——这个扩展得你手动编译进 PHP 或事后用系统包安装。
如何让 phpEnv 下的 PHP 支持 PostgreSQL？
分两步：先确保系统有 PostgreSQL 服务，再确保当前 phpEnv 使用的 PHP 版本启用了 pgsql 扩展。
立即学习“PHP免费学习笔记（深入）”；
- 用系统包管理器装 PostgreSQL 服务（如 Ubuntu）：
sudo apt install postgresql postgresql-contrib - 装 PHP PostgreSQL 扩展：
sudo apt install php-pgsql（注意：这会把pgsql.so放进系统 PHP 的扩展目录，但不一定对 phpEnv 编译的 PHP 生效） - 若你用 phpEnv 自行编译 PHP（如
phpenv install 8.2.10），需在编译前装好系统依赖：sudo apt install libpq-dev，否则configure阶段会跳过 pgsql 支持 - 编译后检查是否内置：
phpenv version-name | xargs -I {} phpenv local {} && php -m | grep pgsql；无输出说明没编译进去，得重装并确认libpq-dev已就位
常见错误：pg_connect() 函数不存在
典型现象是 PHP 报错：Fatal error: Uncaught Error: Call to undefined function pg_connect()。根本原因不是配置错，而是函数压根没被编译进当前 PHP 实例。
- 先确认扩展是否存在：
php --ri pgsql—— 若提示“Extension 'pgsql' not present”，说明未启用或未编译 - 不要试图在
php.ini里加extension=pgsql然后重启 Apache 就完事：phpEnv 切换的 PHP 不读系统php.ini，它用的是自己编译时指定的配置路径 - 若用
phpenv编译，必须在configure阶段看到类似checking for PostgreSQL support... yes的日志，否则重装时补libpq-dev - 临时验证：用
php -r "echo function_exists('pg_connect') ? 'ok' : 'missing';"直接测函数可用性，绕过 Web 服务器干扰
连接字符串写法与端口陷阱
PostgreSQL 默认端口是 5432，但很多用户忽略它被占用或改过，导致 pg_connect() 超时失败却报“connection refused”这种模糊错误。
- 显式写端口更可靠：
host=localhost port=5432 dbname=test user=postgres password=123 - 若 PostgreSQL 装在 Docker 或非标准路径，
host不能写127.0.0.1（IPv4）而要用localhost（触发 Unix domain socket），否则可能因pg_hba.conf规则匹配失败被拒 - 连接失败时优先查
pg_last_error()：var_dump(pg_last_error($conn));，比靠猜快得多 - 本地开发建议用
peer认证而非密码：编辑/etc/postgresql/*/main/pg_hba.conf，把local all all peer行放开，然后sudo systemctl reload postgresql
真正卡住的地方往往不是代码逻辑，而是 phpEnv 编译 PHP 时漏了 libpq-dev，或者以为装了 php-pgsql 包就自动生效——其实那只是给系统 PHP 装的，跟 phpEnv 管的 PHP 完全无关。
