phpEnv仅管理PHP版本及扩展，不提供PostgreSQL安装或配置；PostgreSQL需单独安装并启动，再手动启用php_pgsql扩展、配置连接参数及pg_hba.conf。
phpEnv 本身不提供 PostgreSQL 安装功能，它只管理 PHP 版本和扩展；PostgreSQL 必须单独安装，再手动配置 PHP 的 pgsql 和 pdo_pgsql 扩展启用。
phpEnv 能做什么、不能做什么
phpEnv 是一个轻量级的 PHP 多版本管理工具（类似 pyenv），它负责：
- 下载、编译、切换不同 PHP 版本（如 8.1 / 8.2 / 8.3）
- 启用/禁用已编译进 PHP 的扩展（如
mbstring、curl） - 但 不处理外部数据库服务 —— PostgreSQL 不在 phpEnv 管控范围内
- 也不自动修改
pg_hba.conf或初始化数据库集群
PostgreSQL 必须独立安装并启动
你在使用 phpEnv 前，得先让 PostgreSQL 在系统中跑起来，否则 pg_connect() 会直接报 Connection refused 或 server not listening。
- Linux（Debian/Ubuntu）：
sudo apt install postgresql postgresql-contrib，再sudo systemctl start postgresql - macOS（Homebrew）：
brew install postgresql，然后brew services start postgresql - Windows：从 postgresql.org 下载官方 installer，勾选 “Initialize database cluster” 和 “Install pgAdmin”
- 安装后务必验证：
psql --version和sudo -u postgres psql -c "SELECT version();"
phpEnv 下启用 pgsql 扩展的实操要点
phpEnv 默认编译 PHP 时可能未包含 pgsql，需手动补编译或确认已有。常见问题不是“找不到扩展”，而是“扩展存在但没连上 PostgreSQL 库”。
立即学习“PHP免费学习笔记（深入）”；
- 先查当前 PHP 是否含 pgsql：
phpenv which php找到路径，再运行$(phpenv which php) -m | grep pgsql；若无输出，说明未启用 - 启用方式取决于你如何安装 PHP：若用 phpEnv +
php-build，需确保构建时传了--with-pgsql=/usr（Linux/macOS）或对应 PostgreSQL 安装路径（Windows 下是--with-pgsql=C:\Program Files\PostgreSQL\15） - 若已安装 PHP 但缺扩展，可尝试用
pecl install pq（推荐替代方案，更现代）或重新用 phpEnv 编译带pgsql的版本 - 启用后必须重启 Web 服务（如 Apache/Nginx）或 CLI 环境（phpenv rehash），否则
pg_connect()仍会报Call to undefined function pg_connect()
连接字符串里最容易漏掉的两个参数
即使扩展启用了、PostgreSQL 也跑着，pg_connect() 还是失败？大概率是连接串缺关键项。
-
port=5432：不能省。很多教程写host=localhost dbname=xxx...，但若 PostgreSQL 改过端口（比如被其他服务占了），不显式写port就连不上 -
sslmode=require：开发环境常忽略，但某些 PostgreSQL 发行版（如 Ubuntu 24.04+ 自带的）默认要求 SSL；不加这句，会静默失败或卡住，错误提示可能是no pg_hba.conf entry—— 实际是 SSL 协商失败 - 正确示例：
pg_connect("host=localhost port=5432 dbname=test user=postgres password=123 sslmode=require") - 验证是否真连上：
pg_stat_ssl视图必须查，光看“连接成功”输出没用
真正卡住人的地方从来不是“怎么写连接代码”，而是 PostgreSQL 服务状态、扩展编译路径、SSL 协商、以及 pg_hba.conf 的 host vs hostssl 规则混用 —— 这些全在 phpEnv 视野之外，得自己一层层敲命令确认。
