Ubuntu 20.04下PHP 7.4通过OCI8连接多版本Oracle数据库的实现咨询

需求可行性确认 #

该需求完全可实现。当前场景下的连接失败核心原因是：Oracle Instant Client的版本有明确的兼容规则，18.3版本客户端默认开启了高版本认证校验，对9.x这类超老版本数据库的协议、加密算法支持存在默认限制，而非环境完全不兼容。

现有版本的快速适配（无需额外安装组件） #

你当前列表里的11g 11.2.0.1、12c 12.2.0.1、19c 12.2.0.3、19c 19.0 几个版本，18.3的Instant Client原生支持，连接失败可以通过以下配置快速解决：

• 调整客户端认证兼容参数：在18.3 Instant Client的安装目录下新建sqlnet.ora文件，写入配置SQLNET.ALLOWED_LOGON_VERSION_SERVER = 8，该配置会放开客户端对老版本数据库认证协议的限制，解决默认配置下连接11g及以下版本抛出的ORA-28040: 没有匹配的认证协议类错误
• 校准连接串配置：如果连接低版本库还是报错，检查目标库是用SID还是SERVICE_NAME做实例标识，不要硬套服务名格式，把连接串里的SERVICE_NAME = <SRVNAME>替换为对应的SID = <你的实例名>即可，9.x及以上版本都兼容SID的连接格式

Oracle 9.x（9.2.0.6.0、9.0.1.3.1）的专属适配 #

Oracle 9.x版本的数据库原生不支持12c及以上客户端的SHA2认证、TLS加密握手逻辑，就算调整了上面的sqlnet.ora参数，依然会出现协议握手失败，这部分需要做轻量的客户端隔离，不需要搭建多套PHP运行环境：

• 安装11.2.0.4版本的Oracle Instant Client Basic包，存放到独立目录（如/opt/oracle/instantclient_11_2/），该版本是最后一个原生支持Oracle 9.0及以上版本直连的客户端，同时也能兼容你要连接的所有11g、12c、19c高版本库，和现有18.3客户端不会产生文件冲突
• 不需要重新编译oci8扩展，oci8扩展编译时仅依赖开发头文件，运行时会根据当前进程的LD_LIBRARY_PATH环境变量加载对应路径的客户端动态库。针对需要连接9.x版本库的请求，在首次调用oci_connect前临时切换环境变量即可：

  <?php
  // 连接9.x版本前，临时将客户端路径切换为11.2版本
  putenv('LD_LIBRARY_PATH=/opt/oracle/instantclient_11_2');
  // 用原连接逻辑建立和9.x库的连接
  $dbstr = "(DESCRIPTION =(ADDRESS = (PROTOCOL = TCP)(HOST =<SERVERNAME>)(PORT = 1521))
  (CONNECT_DATA = (SERVER = DEDICATED) (SID = <你的9.x实例名>)))";
  $conn = oci_connect('<user>','<pass>',$dbstr);
  // 连接建立完成后，切回18.3客户端路径，不影响后续高版本库的连接逻辑
  putenv('LD_LIBRARY_PATH=/opt/oracle/instantclient_18_3');
  ?>
  

注意事项 #

• 环境变量的切换必须在首次调用oci系列函数前完成，如果PHP进程已经加载了某一版本的客户端动态库，后续再修改LD_LIBRARY_PATH是不会生效的
• 全局动态库配置里（/etc/ld.so.conf.d/oracle-instantclient.conf）仅保留18.3客户端的路径即可，不要把11.2客户端的路径加入全局配置，否则会出现两个版本的动态库冲突
• 给PHP运行用户（如www-data）开放所有客户端目录的读权限，避免出现动态库加载失败的错误
• 连接9.x版本时尽量简化TNS连接串，避免因为老版本的TNS解析长度限制导致连接报错

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