宝塔面板安装postgresql插件后，php仍需单独安装并启用pgsql和pdo_pgsql扩展才能连接数据库；若插件未运行、端口未监听或配置文件未允许本地连接，即使扩展装好也无法连通。
宝塔面板里装 PostgreSQL 插件本身不等于 PHP 能连上数据库——插件只管 PostgreSQL 服务运行和图形化管理，pgsql 和 pdo_pgsql 这两个 PHP 扩展必须单独安装并启用，否则 pg_connect() 或 PDO::__construct() 会直接报“function not found”。
确认 PostgreSQL 插件已正确安装并运行
插件装错位置或没启动，后续 PHP 扩展即使装对也连不上。先验证服务状态：
- 登录宝塔 → 左侧菜单点击 PostgreSQL，看右上角是否显示“正在运行”；若显示“已停止”，点启动按钮
- 终端执行
ps aux | grep postgres，应看到类似/www/server/pgsql/bin/postgres -D /www/server/pgsql/data的进程 - 检查监听端口：
netstat -tlnp | grep :5432（默认端口），确保没被防火墙或其它服务占用 - 如果插件页面打不开或提示“未安装”，说明插件安装失败，需重装或改用源码编译方式（见知识库中“命令行编译安装”部分）
在宝塔软件商店一键安装 pgsql 扩展失败的常见原因
宝塔 PHP 管理页里的“安装扩展”按钮对 pgsql 和 pdo_pgsql 支持不稳定，尤其在非标准路径或新版 PostgreSQL 下容易静默失败：
- 插件安装的 PostgreSQL 路径是
/www/server/pgsql，但宝塔商店安装扩展时可能找不到该路径下的pg_config，导致 configure 阶段报configure: error: cannot find pg_config - PHP 源码目录缺失：
ls /www/server/php/83/src/ext/pgsql返回 “No such file”，说明宝塔没缓存对应扩展源码，商店安装必然失败 - 磁盘空间不足：
df -h /www显示剩余低于 300MB 时，编译过程大概率中断，日志里会出现gcc: internal compiler error或virtual memory exhausted - 系统缺少
libpq-devel（CentOS）或libpq-dev（Ubuntu），导致./configure找不到 PostgreSQL 客户端头文件
手动编译安装 pgsql 和 pdo_pgsql 扩展（推荐）
绕过商店限制，用宝塔自带的编译环境直连 PostgreSQL 安装路径，成功率最高：
- 先确认 PostgreSQL 安装路径：
/www/server/pgsql/bin/pg_config --version，记下版本号（如 16.1） - 进入 PHP 对应源码目录（以 PHP 8.3 为例）：
cd /www/server/php/83/src/ext/pgsql；若目录不存在，先创建：mkdir -p /www/server/php/83/src/ext/pgsql，再下载源码或从宝塔 ext 包解压 - 执行编译：
/www/server/php/83/bin/phpize→./configure --with-php-config=/www/server/php/83/bin/php-config --with-pgsql=/www/server/pgsql→make && make install - 同理安装
pdo_pgsql：cd /www/server/php/83/src/ext/pdo_pgsql→ 重复上面三步，只是 configure 参数换成--with-pdo-pgsql=/www/server/pgsql - 编辑配置：
echo -e "extension = pgsql.so\nextension = pdo_pgsql.so" >> /www/server/php/83/etc/php.ini - 必须重启服务：
service php-fpm-83 restart（不是 reload）
验证扩展是否真正生效
“已安装”不等于“能用”，很多问题卡在最后一步：
- 用命令行验证：
php -m | grep -E 'pgsql|pdo_pgsql'，有输出才表示扩展加载成功 - 检查
phpinfo()页面，搜索pgsql，确认 “PostgreSQL Support” 显示 enabled，且 “PostgreSQL Version” 与pg_config --version一致 - 写个测试脚本：
<?php var_dump(pg_connect("host=127.0.0.1 port=5432 dbname=test user=postgres password=123")); ?>，注意 host 不要写 localhost（可能走 Unix socket，而宝塔插件默认只监听 TCP） - 如果报
could not connect to server: Connection refused，说明 PostgreSQL 服务没监听 127.0.0.1 —— 编辑/www/server/pgsql/data/postgresql.conf，确认listen_addresses = '127.0.0.1'；再检查pg_hba.conf是否允许host all all 127.0.0.1/32 md5
最常被忽略的是：PostgreSQL 插件默认不开放远程连接，也不监听 IPv4 回环地址；PHP 扩展装得再全，连不上服务端就是白搭。务必逐项核对 postgresql.conf 和 pg_hba.conf 的配置，而不是只盯着 PHP 侧。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
