Laravel集成PostgreSQL报错：could not find driver（PHP8.1环境）

问题重现 #

Illuminate\Database\QueryException

could not find driver (Connection: pgsql, SQL: select * from information_schema.tables where table_catalog = phptest and table_schema = public and table_name = migrations and table_type = 'BASE TABLE')

at vendor/laravel/framework/src/Illuminate/Database/Connection.php:795
791▕ // If an exception occurs when attempting to run a query, we'll format the error
792▕ // message to include the bindings with SQL, which will make this exception a
793▕ // lot more helpful to the developer instead of just the database's errors.
794▕ catch (Exception $e) {
➜ 795▕ throw new QueryException(
796▕ $this->getName(), $query, $this->prepareBindings($bindings), $e
797▕ );
798▕ }
799▕ }

这个错误核心是PHP未启用PostgreSQL的PDO驱动，即便修改过php.ini，也可能存在以下问题，按顺序排查：

1. 确认修改的是正确的php.ini文件 #

Laravel CLI命令使用的是PHP CLI配置，和Web服务器（Nginx/Apache）的php.ini可能不是同一个。执行命令查看当前CLI加载的php.ini路径：

php --ini

输出中Loaded Configuration File对应的路径才是你需要修改的文件，确保之前修改的是这个。

2. 启用pgsql和pdo_pgsql扩展 #

打开正确的php.ini文件，找到以下两行，去掉前面的注释符号;：

• Linux/macOS：

  extension=pgsql
  extension=pdo_pgsql
  

• Windows：

  extension=pgsql.dll
  extension=pdo_pgsql.dll
  

注意：Windows环境下如果ext目录没有对应dll文件，需要下载和PHP 8.1线程安全/非线程安全版本匹配的扩展包。

3. 安装PostgreSQL扩展依赖（Linux系统） #

Linux下可能未安装PHP的PostgreSQL扩展包，执行对应系统的命令：

• Debian/Ubuntu：

  sudo apt install php8.1-pgsql
  

• CentOS/RHEL（需先配置Remi源）：

  sudo dnf install php81-php-pgsql
  

4. 验证扩展是否生效 #

执行命令查看已加载的PHP模块，确认pgsql和pdo_pgsql在列表中：

php -m

如果没出现，重启终端或重新加载PHP配置（Linux下可重启php-fpm服务）。

5. 清理Laravel配置缓存并验证数据库配置 #

• 检查.env文件中的数据库配置是否正确：

  DB_CONNECTION=pgsql
  DB_HOST=127.0.0.1
  DB_PORT=5432
  DB_DATABASE=phptest
  DB_USERNAME=你的数据库用户名
  DB_PASSWORD=你的数据库密码
  

• 清理Laravel配置缓存：

  php artisan config:clear
  

6. 直接测试PHP与PostgreSQL的连接 #

创建测试脚本test-pgsql.php，验证驱动是否正常：

<?php
$host = '127.0.0.1';
$dbname = 'phptest';
$user = '你的数据库用户名';
$pass = '你的数据库密码';

try {
    $pdo = new PDO("pgsql:host=$host;dbname=$dbname", $user, $pass);
    echo "PostgreSQL连接成功";
} catch (PDOException $e) {
    die("连接失败: " . $e->getMessage());
}

执行脚本：

php test-pgsql.php

如果仍提示找不到驱动，回到前面步骤重新检查扩展安装和配置。

内容的提问来源于stack exchange，提问作者Rakibul Hasan Shaon