phpEnv 默认不支持 PostgreSQL,需手动添加 php_pgsql.dll 和 php_pdo_pgsql.dll 扩展并配置 php.ini;PostgreSQL 16 需独立安装运行,确保 libpq 兼容、认证配置正确及端口开放。

phpEnv 本身不原生支持 PostgreSQL,它默认只集成 MySQL/MariaDB。想用 phpEnv 运行 PHP + PostgreSQL 16,必须手动补全驱动和配置,否则 pg_connect() 会直接报 Call to undefined function pg_connect()。
为什么 phpEnv 启动后找不到 pg_* 函数
phpEnv 的 Windows 版本(如 phpEnv-2023 或更早)打包的 PHP 二进制里,默认没启用 php_pgsql.dll 和 php_pdo_pgsql.dll,且 extension_dir 指向的目录下也通常没有这两个文件。
- 检查你的 PHP 版本是否匹配:phpEnv 常附带 PHP 7.4/8.0/8.1,而 PostgreSQL 16 要求客户端协议兼容 —— 实际上只要 libpq 版本 ≥ 9.6 就能连 PG16,PHP 自带的 libpq 一般满足
-
php.ini中必须显式开启两行:extension=php_pgsql.dll和extension=php_pdo_pgsql.dll - 确保
php_pgsql.dll文件真实存在于ext/目录下;若缺失,需从对应 PHP 版本的官方 ZIP 包中提取(不是从 phpEnv 自带目录拷贝)
如何让 phpEnv 加载 PostgreSQL 扩展
先确认你用的是哪个 phpEnv 分支(常见有 phpenv-win 或 php-env),然后按路径定位到它的 PHP 安装目录,例如 C:\phpenv\versions.1.22\。
- 下载与你 PHP 版本、线程安全(TS/NTS)、架构(x64/x86)完全一致的 PHP 二进制 ZIP 包(从 windows.php.net)
- 从 ZIP 包的
ext/目录中复制php_pgsql.dll和php_pdo_pgsql.dll到 phpEnv 对应 PHP 版本的ext/下 - 编辑该 PHP 版本下的
php.ini(不是系统级的,是 phpEnv 管理的那个),取消注释并确认这两行存在且无拼写错误:extension=php_pgsql.dll、extension=php_pdo_pgsql.dll - 重启 phpEnv 的 Apache/Nginx 服务,执行
php -m | findstr pg验证是否加载成功
phpEnv 下连接 PostgreSQL 16 的实际代码写法
即使扩展加载成功,pg_connect() 仍可能失败,常见原因是 PostgreSQL 服务未运行、认证方式不匹配或端口被占。phpEnv 只管 PHP+Web 服务,不管理 PostgreSQL 实例。
立即学习“PHP免费学习笔记(深入)”;
- PostgreSQL 16 必须独立安装并运行(比如用 EnterpriseDB 安装包或
initdb+pg_ctl启动),不能指望 phpEnv 自带 - 连接字符串示例:
$conn = pg_connect("host=localhost port=5432 dbname=postgres user=postgres password=mypassword");—— 注意port默认是5432,不是 phpEnv 的 Apache 端口 - 如果 PostgreSQL 启用了
scram-sha-256认证(PG10+ 默认),而 PHP 使用旧版 libpq(如 PHP 7.4 自带的),可能握手失败;建议升级到 PHP 8.1+ 或在pg_hba.conf中临时加一行host all all 127.0.0.1/32 md5测试
最易被忽略的一点:phpEnv 和 PostgreSQL 是两个完全独立的进程体系,它们之间没有自动关联。你得自己确保 PostgreSQL 的 postgresql.conf 里 listen_addresses = 'localhost'、pg_hba.conf 允许本地连接,且 Windows 防火墙没拦 5432 端口 —— 这些和 phpEnv 的界面操作无关,但任一环节断了,pg_connect() 就只会返回 false。



















