通过Shell运行PHP时oci_connect函数未定义，oci8扩展未加载如何解决？

核心原因 #

浏览器运行的是Apache的PHP模块（mod_php），而shell执行的是PHP的CLI（命令行）版本，两者使用的php.ini配置文件可能不同，且依赖的环境变量也存在差异。

具体排查与解决步骤 #

1. 确认CLI版本PHP的配置文件路径
   执行以下命令，找到CLI模式下PHP实际读取的php.ini位置：

   php --ini
   

   输出中的Loaded Configuration File就是当前CLI使用的配置文件路径，不要混淆Apache的php.ini路径（两者通常分属不同文件，比如Apache的可能在/etc/php.ini，CLI的可能在/etc/php-cli.ini或对应版本子目录）。

2. 在正确的php.ini中启用oci8扩展
   编辑第一步找到的CLI专用php.ini文件，添加或确保以下配置存在：

   extension=oci8.so
   

   若oci8.so不在PHP默认扩展目录，需指定完整路径，可先用find / -name oci8.so命令查找文件实际位置，再配置：

   extension=/usr/lib64/php/modules/oci8.so
   

3. 配置Oracle客户端环境变量
   CLI模式下可能未加载Oracle客户端的环境变量，需确保以下变量设置正确：

   • ORACLE_HOME：Oracle客户端安装目录（例如/usr/lib/oracle/19.3/client64）
   • LD_LIBRARY_PATH：包含Oracle客户端库的路径（例如$ORACLE_HOME/lib）
   • NLS_LANG：可选，设置字符集（例如AMERICAN_AMERICA.AL32UTF8）

   可直接在shell.sh开头添加这些变量：

   export ORACLE_HOME=/usr/lib/oracle/19.3/client64
   export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
   export NLS_LANG=AMERICAN_AMERICA.AL32UTF8
   

   也可将变量添加到/etc/profile或用户的~/.bash_profile中，实现全局生效。

4. 验证扩展加载状态
   执行以下命令，检查CLI模式下oci8是否已加载：

   php -m | grep oci8
   

   若输出oci8则加载成功；若无输出，检查配置文件路径、扩展路径是否正确，或用php -d error_reporting=E_ALL -r "phpinfo();"查看详细错误信息。

5. 生效环境变量
   若修改了/etc/profile或~/.bash_profile，需执行source /etc/profile或重新打开shell会话，确保环境变量生效。

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