macOS Big Sur系统下PHP 7.4使用PostgreSQL无法加载pdo_pgsql扩展

出现该错误的核心原因是 Brew 官方的 PHP 核心包默认不内置 pdo_pgsql、pgsql 扩展，仅在 php.ini 中添加启用配置但实际扩展文件不存在，因此会抛出镜像未找到的加载错误。可按以下步骤修复：

• 先确认 CLI 调用的 PHP 版本为目标 7.4 版本，执行命令：

  brew unlink php && brew link php@7.4 --force
  

• 安装 PostgreSQL 依赖库（扩展编译需要用到该库文件），执行命令：

  brew install postgresql
  

• 若未安装 Xcode 命令行工具先完成安装，避免编译报错：

  xcode-select --install
  

• 通过 pecl 安装 pdo_pgsql 扩展，安装过程中提示输入 PostgreSQL 路径时直接回车使用自动检测路径即可：

  pecl install pdo_pgsql
  

• 修正 php.ini 配置：pecl 安装完成后会自动在 php.ini 顶部添加扩展加载配置，需要删除你之前手动添加的重复 extension=pdo_pgsql、extension=pgsql 配置，避免重复加载报错。执行 php --ini 可确认当前 CLI 加载的 php.ini 路径，避免修改到其他版本 PHP 的配置文件。
• 验证扩展是否安装成功，执行以下命令，输出中包含 pdo_pgsql、pgsql 即代表修复完成：

  php -m | grep pgsql
  

常见问题排查 #

• 若仍报加载失败，执行 php -i | grep extension_dir 查看当前 PHP 的扩展存储目录，确认 pdo_pgsql.so 文件存在于该目录中。
• M 系列芯片 Mac 注意确认 Brew 安装路径为 /opt/homebrew，不要使用 Intel 架构下的 /usr/local 路径相关的配置。

内容的提问来源于stack exchange，提问作者Ezequiel Tavares