OS X Monterey系统PHP 8.1无法加载oci8.so的问题求助

问题根源 #

你安装的是Intel x86架构的Oracle Instant Client，但在Apple Silicon芯片上编译了arm64架构的OCI8扩展，二者架构不兼容，导致扩展无法找到Instant Client中的核心符号。

修复步骤 #

1. 清理现有不兼容组件 #

• 删除Intel版Oracle Instant Client文件，默认安装路径通常为/usr/local/lib/instantclient_*，根据实际安装位置调整
• 清理环境变量：打开~/.zshrc或~/.bash_profile，删除ORACLE_HOME、DYLD_LIBRARY_PATH等相关配置行，执行source ~/.zshrc（对应你的shell配置文件）使更改生效
• 卸载已编译的OCI8扩展：执行pecl uninstall oci8-3.2.1

2. 安装Apple Silicon适配版Instant Client #

• 下载ARM64架构的Oracle Instant Client基础包与SDK包
• 解压后将文件统一放到/opt/homebrew/lib/instantclient_<版本号>目录（例如/opt/homebrew/lib/instantclient_21_13）
• 配置环境变量：在shell配置文件中添加

  export ORACLE_HOME=/opt/homebrew/lib/instantclient_21_13
  export DYLD_LIBRARY_PATH=$ORACLE_HOME
  export PATH=$ORACLE_HOME:$PATH
  

  执行source ~/.zshrc生效

3. 重新编译安装OCI8扩展 #

• 确认当前shell为arm64架构：执行arch，输出应为arm64
• 运行安装命令：

  pecl install oci8-3.2.1
  

  安装过程中提示输入Oracle Instant Client路径时，输入instantclient,/opt/homebrew/lib/instantclient_21_13（对应你设置的ORACLE_HOME路径）

4. 验证修复效果 #

• 执行php -m，检查输出中是否包含oci8模块
• 进入PHP交互模式php -a，测试OCI8相关函数，确认无加载错误

额外检查项 #

• 确保PHP 8.1是Homebrew安装的arm64版本：执行file $(which php)，输出需包含arm64
• 若之前安装过x86版本PHP，卸载后重装：brew uninstall php@8.1 && brew install php@8.1

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