ThinkPHP 8 连接 PostgreSQL 需启用 pdo_pgsql 扩展、删除 charset 配置、设置 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，并在 Docker 中用容器名作 hostname。
PHP 8 连接 PostgreSQL 并执行查询，核心在于三步：确保扩展可用、构造正确连接、用合适方式执行查询。关键细节容易出错，尤其在 ThinkPHP 8 或 Docker 环境下。
确认 pdo_pgsql 扩展已启用
PHP 8 默认不带 PostgreSQL 支持，必须手动启用 pdo_pgsql（PDO 方式）或 pgsql（原生扩展）。仅靠安装 PostgreSQL 服务或能用 psql 连接，并不代表 PHP 可用。
- Linux（Debian/Ubuntu）：
sudo apt install php-pgsql，再重启php-fpm或apache2 - macOS（Postgres.app + Homebrew PHP）：
pecl install pdo_pgsql，并在php.ini中添加extension=pdo_pgsql - Windows（WAMP/MAMP）：编辑对应版本的
php.ini，取消注释extension=php_pdo_pgsql.dll和extension=php_pgsql.dll；若报libpq.dll缺失，需在 Apache 配置中加LoadFile "C:/php/libpq.dll" - 验证是否生效：
php -r "print_r(PDO::getAvailableDrivers());"输出应含"pgsql"
用 PDO 构建安全连接（推荐）
使用 PDO 是最通用、可移植的方式。注意 PostgreSQL 不接受 charset 参数，写上会导致 DSN 构造失败——连接看似成功，但首次查询就抛空 QueryException，无实际错误信息。
- DSN 格式为：
pgsql:host=localhost;port=5432;dbname=mydb;user=myuser;password=mypass（不含charset） - Docker 环境中，
host必须填容器名（如pg），不能写localhost - 务必设置错误模式：
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则 PostgreSQL 的真实错误（如表不存在、权限拒绝）会被静默吞掉 - 示例代码：
$dsn = "pgsql:host=localhost;port=5432;dbname=testdb;user=postgres;password=1234";
try {
$pdo = new PDO($dsn, null, null, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]);
// 查询示例
$stmt = $pdo->query("SELECT * FROM users LIMIT 5");
$users = $stmt->fetchAll();
var_dump($users);
} catch (PDOException $e) {
error_log("DB Error: " . $e->getMessage());
die("数据库操作失败");
}
?>
用 pg_connect() 做快速验证（原生方式）
适合调试或轻量脚本。它不依赖 PDO，但函数名和参数格式与 PDO 不同，且错误处理更原始。
立即学习“PHP免费学习笔记（深入）”；
- 连接字符串是键值对空格分隔，如：
"host=localhost port=5432 dbname=testdb user=postgres password=1234" - 成功返回资源（PHP 8.1+ 为
PgSql\Connection对象），失败返回false - 必须用
pg_last_error()获取错误详情，否则静默失败 - 示例：
$conn_string = "host=localhost port=5432 dbname=testdb user=postgres password=1234";
$dbconn = pg_connect($conn_string);
if (!$dbconn) {
die("连接失败：" . pg_last_error());
}
$result = pg_query($dbconn, "SELECT id, name FROM users WHERE active = true");
if ($result) {
while ($row = pg_fetch_assoc($result)) {
echo $row['id'] . ": " . $row['name'] . "\n";
}
}
?>
ThinkPHP 8 特别注意事项
TP8 对 PostgreSQL 支持较弱，默认配置易踩坑，不是“换数据库名就能用”。
- 配置文件中删掉
'charset' => 'utf8'这一行，哪怕设为null也比留着强 -
hostname在 Docker 下必须是容器名（如pg），不是127.0.0.1或localhost - 确保数据库配置数组里显式包含：
'options' => [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION] - 模型查询前，建议先用
Db::connect()->query('SELECT 1')测试基础连通性
