PHP 7.4环境下Oracle OCI8扩展加载异常 出现OCI_CRED_EXT未定义报错

可行排查步骤 #

• 确认CLI与FPM配置差异
  分别执行php -i | grep "Loaded Configuration File"和php-fpm7.4 -i | grep "Loaded Configuration File"，对比两个环境加载的php.ini路径。大多数此类问题都是oci8的extension=oci8.so配置仅添加到了CLI的php.ini或对应conf.d目录，未同步到FPM的配置目录导致。
• 修正PHP-FPM的环境变量配置
  /etc/environment中配置的Oracle环境变量默认不会被systemd管理的PHP-FPM服务读取，需要手动在/etc/php/7.4/fpm/pool.d/www.conf中添加如下配置，替换为你实际的Oracle客户端路径：

  env[LD_LIBRARY_PATH] = /usr/lib/oracle/[你的客户端版本号]/client64/lib
  env[ORACLE_HOME] = /usr/lib/oracle/[你的客户端版本号]/client64
  env[NLS_LANG] = AMERICAN_AMERICA.AL32UTF8
  

  修改完成后执行systemctl restart php7.4-fpm重启服务，再查看phpinfo确认oci8配置是否正常展示。
• 检查oci8扩展编译完整性
  若CLI下执行php -i | grep oci8也只有作者信息没有实际配置项，说明扩展编译时未正确链接Oracle Instant Client库。先执行pecl uninstall oci8卸载现有扩展，重新执行pecl install oci8-2.2.0，安装过程中提示输入Oracle客户端路径时，输入你实际的instantclient安装路径，不要留空。
• 确认Laravel Forge版本匹配
  Laravel Forge支持多PHP版本共存，先确认站点绑定的PHP版本确实为7.4，避免oci8扩展安装到其他PHP版本的扩展目录，导致FPM无法加载。
• 查看FPM错误日志定位根源
  打开/var/log/php7.4-fpm.log查看服务启动日志，搜索oci8相关报错，可直接定位是扩展文件缺失、依赖库找不到还是配置错误的问题。

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