phpenv不负责安装postgresql或其扩展，需单独安装数据库服务并确保phpenv管理的php版本编译时启用--with-pgsql；验证需用psql命令行测试连通性，再检查php -m | grep pg确认扩展加载。
phpenv 本身不负责安装 PostgreSQL 数据库，也不提供“PostgreSQL 扩展组件”这种东西——它只管 PHP 版本管理。你真正需要的，是两件独立的事：
- 单独安装 PostgreSQL 服务（数据库本身）
- 确保当前
phpenv管理的 PHP 版本启用了pgsql扩展（PHP 连 Postgres 的驱动）
下面直接说清怎么做、为什么、容易在哪卡住。
PostgreSQL 数据库得自己装，和 phpenv 无关
phpenv 是个 PHP 版本切换工具，它不碰系统级服务。PostgreSQL 是一个独立运行的数据库进程，必须单独安装并启动。
- 在 Debian/Ubuntu 上：
sudo apt update && sudo apt install postgresql postgresql-contrib
- 在 macOS 上（用 Homebrew）：
brew install postgresql
- 在 Windows 上：去官网下载安装包，按向导走，注意记下设置的密码和端口（默认
5432）
装完后必须手动启动服务：
sudo systemctl start postgresql或 macOS：
brew services start postgresql不启动，
pg_connect() 一定会报 Connection refused 或超时。
phpenv 管理的 PHP 必须编译时带 --with-pgsql
phpenv 默认安装的 PHP 不含 pgsql 扩展——它只装最简核心。你要么：
-
安装时显式启用 PostgreSQL 支持：
phpenv install 8.3.13 --configure-options="--with-pgsql=/usr"
（路径/usr是 Debian/Ubuntu 的默认 PostgreSQL 安装前缀；macOS 可能是/opt/homebrew或/usr/local，用brew --prefix postgresql查） -
或者：先装好 PHP，再用
pecl补装（但成功率低，因依赖头文件）：phpenv shell 8.3.13<br>pecl install pdo_pgsql
然后手动在php.ini里加extension=pdo_pgsql——但更推荐第一种方式，一劳永逸。
验证是否生效：
php -m | grep pg应看到
pgsql 和/或 pdo_pgsql。没输出？说明扩展根本没加载。
常见连接失败原因：host、port、权限三处最容易错
即使扩展装了、PostgreSQL 也跑了，pg_connect() 还是失败，大概率卡在这三点：
-
pg_connect("host=localhost dbname=test user=me")中的host写成127.0.0.1有时会失败（PostgreSQL 默认只监听localhost的 Unix socket，IPv4 需额外配置） - 没改
postgresql.conf里的listen_addresses和pg_hba.conf的访问规则，导致拒绝连接 - 用户没权限：用
sudo -u postgres psql进去后，执行CREATE USER myapp WITH PASSWORD 'xxx';<br>CREATE DATABASE myapp OWNER myapp;
别直接用postgres用户连生产环境
最省事的调试法：psql -h localhost -U myapp -d myapp 能连上，PHP 才可能连上。连不上 shell，就别急着写 PHP。
phpenv install 后必须 run phpenv rehash
每次用phpenv install 装完新 PHP 版本，必须立刻执行：
phpenv rehash否则
php 命令仍指向旧版本，php -v 和 php -m 看到的都不是你刚装的那个。
另外，如果你用 phpenv local 8.3.13 切换项目版本，但 php --ini 显示的 Loaded Configuration File 还是旧路径——说明 phpenv 的 shim 没生效，检查 ~/.bashrc 或 ~/.zshrc 是否漏了 eval "$(phpenv init -)"。
PostgreSQL 和 PHP 的连接问题，90% 出在「数据库没跑起来」「PHP 扩展没编进去」「网络/权限没放开」这三层。别在 pg_connect() 报错后一头扎进 PHP 代码里调，先用命令行工具交叉验证每层是否通。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
