ThinkPHP作为国内常用的PHP开发框架，支持多种数据库类型，其中PostgreSQL是很多企业级项目会选择的数据库。要在ThinkPHP中正常使用PostgreSQL，需要完成对应的配置操作，下面分步骤说明具体实现方法。
环境准备
在配置之前，需要确保服务器环境满足基本要求：
- 已安装PHP环境，并且PHP安装了PostgreSQL扩展，可以通过
phpinfo()函数查看是否存在pgsql扩展项 - 已安装PostgreSQL数据库，并且知道数据库的主机地址、端口、数据库名、用户名和密码
- 已安装ThinkPHP框架，本文以ThinkPHP6为例说明，其他版本配置逻辑基本一致
修改数据库配置文件
ThinkPHP的数据库配置文件默认位于config/database.php，如果是多应用模式，也可以在应用目录下的config/database.php中单独配置。打开配置文件后，找到default配置项，将默认的数据库连接改为PostgreSQL对应的配置，具体参数如下：
<?php
return [
// 默认数据库连接配置
'default' => 'pgsql',
// 数据库连接配置列表
'connections' => [
'pgsql' => [
// 数据库类型
'type' => 'pgsql',
// 服务器地址
'hostname' => '127.0.0.1',
// 数据库名
'database' => 'test_db',
// 用户名
'username' => 'postgres',
// 密码
'password' => 'your_password',
// 端口
'hostport' => '5432',
// 连接dsn
'dsn' => '',
// 数据库连接参数
'params' => [],
// 数据库编码默认采用utf8
'charset' => 'utf8',
// 数据库表前缀
'prefix' => '',
// 数据库调试模式
'debug' => true,
],
],
];
配置参数说明：
type必须设置为pgsql，这是ThinkPHP识别PostgreSQL数据库的关键参数hostname是PostgreSQL数据库所在服务器的地址，本地环境填127.0.0.1即可hostport是PostgreSQL的默认端口，默认是5432，如果修改过端口需要填写对应的值prefix是表前缀，如果数据库表有统一的前缀可以在这里设置，查询时会自动拼接
测试数据库连接
配置完成后，可以通过编写测试代码验证是否连接成功。在控制器中编写如下代码：
<?php
namespace appcontroller;
use thinkfacadeDb;
class Test
{
public function index()
{
try {
// 查询PostgreSQL数据库的版本信息
$version = Db::query('SELECT version()');
dump($version);
return 'PostgreSQL连接成功';
} catch (Exception $e) {
return '连接失败：' . $e->getMessage();
}
}
}
访问该控制器方法，如果页面输出PostgreSQL的版本信息，说明配置成功。如果提示连接失败，可以检查以下几个地方：
- PHP的pgsql扩展是否安装并启用
- 配置文件中的数据库地址、端口、用户名、密码是否正确
- PostgreSQL数据库是否允许远程连接，防火墙是否开放了对应端口
常见问题处理
提示驱动不存在
如果出现could not find driver的错误，说明PHP没有安装pgsql扩展，需要根据PHP版本安装对应的扩展。以Linux系统为例，执行apt-get install php-pgsql或者yum install php-pgsql安装扩展，安装完成后重启PHP服务即可。
字符集问题
如果查询出来的中文数据出现乱码，需要确认数据库编码和配置中的charset参数是否一致，PostgreSQL一般使用utf8编码，配置中对应设置为utf8即可。
表名大小写问题
PostgreSQL默认对表名和字段名的大小写敏感，如果配置的表名是大写，查询时需要保持大小写一致，或者在配置中设置params参数调整大小写规则。
ThinkPHPPostgreSQL数据库配置PG连接修改时间：2026-07-15 21:24:30