在Linux系统中通过PHP远程连接Oracle数据库，需要完成环境依赖安装、PHP扩展配置、连接代码编写三个核心步骤，每个环节的配置细节都会影响最终连接是否成功。
环境准备
首先需要确认Linux系统的基础环境，本文以CentOS 7系统、PHP 7.4版本为例，其他Linux发行版和PHP版本的操作逻辑基本一致。需要提前准备的信息包括：远程Oracle数据库的主机IP、端口号（默认1521）、服务名或SID、数据库用户名和密码。
安装Oracle Instant Client
PHP连接Oracle需要依赖Oracle官方的客户端库，不需要安装完整的Oracle数据库客户端，只需要安装轻量的Instant Client即可。步骤如下：
- 下载对应系统架构的Instant Client基础包和SDK包，注意版本要和远程Oracle数据库版本兼容，建议选择11g及以上版本
- 将下载的rpm包或zip包解压到/usr/local/oracle目录，比如解压后的路径为/usr/local/oracle/instantclient_21_10
- 配置系统动态库加载路径，编辑/etc/ld.so.conf文件，添加Instant Client的目录路径，然后执行ldconfig命令刷新配置
安装PHP oci8扩展
oci8是PHP官方提供的用于连接Oracle数据库的扩展，需要通过PECL或者源码编译的方式安装。使用PECL安装的步骤如下：
# 安装oci8扩展 pecl install oci8 # 安装过程中会提示输入Instant Client路径，输入刚才解压的路径即可，比如/usr/local/oracle/instantclient_21_10 # 安装完成后在php.ini中添加扩展配置 echo "extension=oci8.so" >> /etc/php.ini # 重启PHP服务使配置生效，比如使用php-fpm的话执行 systemctl restart php-fpm
安装完成后可以通过php -m | grep oci8命令验证扩展是否加载成功，如果输出oci8则说明扩展安装正常。
编写PHP连接代码
扩展安装完成后就可以编写连接代码，PHP提供了oci_connect函数用于建立Oracle连接，具体示例如下：
<?php
// 远程Oracle数据库配置
$host = '192.168.1.100'; // Oracle数据库主机IP
$port = '1521'; // 端口号
$serviceName = 'orclpdb'; // 服务名，也可以使用SID，对应配置为$oracleSid = 'orcl';
$username = 'test_user'; // 数据库用户名
$password = 'test_pass'; // 数据库密码
// 构造连接字符串，使用服务名的方式
$connStr = "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST={$host})(PORT={$port}))(CONNECT_DATA=(SERVICE_NAME={$serviceName})))";
// 建立连接
$conn = oci_connect($username, $password, $connStr);
if (!$conn) {
$e = oci_error();
die("连接Oracle数据库失败：" . $e['message']);
}
echo "Oracle数据库连接成功";
// 测试查询示例
$sql = "SELECT * FROM test_table WHERE id = :id";
$stmt = oci_parse($conn, $sql);
$id = 1;
oci_bind_by_name($stmt, ':id', $id);
oci_execute($stmt);
while ($row = oci_fetch_assoc($stmt)) {
print_r($row);
}
// 释放资源
oci_free_statement($stmt);
oci_close($conn);
?>常见问题排查
如果连接失败，可以按照以下步骤排查：
- 检查Instant Client路径是否正确，动态库是否可以被系统加载，执行
ldd /usr/lib64/php/modules/oci8.so查看是否有缺失的依赖 - 检查远程Oracle数据库是否允许远程连接，防火墙是否开放了1521端口，可以使用
telnet 192.168.1.100 1521测试端口连通性 - 检查连接字符串中的服务名或SID是否正确，可以联系数据库管理员确认正确的连接参数
- 查看PHP错误日志，获取更详细的连接失败原因，针对性解决问题
注意事项
生产环境中不要将数据库密码明文写在代码里，建议通过配置文件或者环境变量存储敏感信息。另外oci8扩展的版本需要和PHP版本匹配，避免版本不兼容导致扩展加载失败。如果使用的是PHP 8及以上版本，部分oci函数的参数顺序可能有调整，需要参考官方文档对应调整代码。