Oracle Instant Client安装教程

SSKNV • 2025-02-15 17:10 • 编程

一、安装前准备

1、确认系统版本

确认系统位数和版本，下载对应的Oracle Instant Client。

uname -i  # 查看系统位数
cat /etc/redhat-release # 查看系统版本

2、下载Oracle Instant Client包

在Oracle官网下载对应版本的Oracle Instant Client包，通常可以在下面的页面找到对应的版本：https://www.oracle.com/database/technologies/instant-client/downloads.html

3、下载Instant Client SDK（可选）

如果需要编译使用Instant Client的应用程序，则需要下载对应的Instant Client SDK。

4、安装依赖库

安装完整版Oracle需要安装多个依赖库，但是使用Instant Client只需要安装少量库即可。

yum install libaio # 安装libaio库
yum install libstdc++  # 安装libstdc++库，仅适用于Instant Client 12.2或更早的版本

二、安装Oracle Instant Client

1、解压Oracle Instant Client包

将下载的Oracle Instant Client包解压到指定的目录，例如 /opt/oracle/instantclient_19_11。

unzip instantclient-basic-linux.x64-19.11.0.0.0dbru.zip -d /opt/oracle/
cd /opt/oracle
mv instantclient_19_11 instantclient # 将解压后的文件夹名修改为简单易懂的名称

2、设置ORACLE_HOME和LD_LIBRARY_PATH环境变量

ORACLE_HOME指向Instant Client安装的目录，LD_LIBRARY_PATH指向Instant Client库文件的位置。

export ORACLE_HOME='/opt/oracle/instantclient'
export LD_LIBRARY_PATH=$ORACLE_HOME

3、测试命令是否可用

运行命令sqlplus，确认Oracle Instant Client安装成功。

sqlplus -v

三、安装ODBC驱动（可选）

1、安装unixODBC

如果需要使用ODBC连接Oracle数据库，则需要安装unixODBC。

yum install unixODBC # 安装unixODBC

2、解压ODBC Instant Client包

将下载的ODBC Instant Client包解压到Instant Client的目录下，例如：/opt/oracle/instantclient_19_11。

unzip instantclient-odbc-linux.x64-19.11.0.0.0dbru.zip -d /opt/oracle/instantclient_19_11/

3、创建ODBC数据源

编辑odbc.ini文件（如果不存在，则新建该文件）：

[oracle_db] # Oracle数据库的数据源名称
Driver = /opt/oracle/instantclient_19_11/libsqora.so.19.1  # ODBC Instant Client的驱动文件路径
DSN = oracle_db # 使用的数据源名称
ServerName = //ip:port/orcl  # Oracle数据库的服务器地址和实例名
UserID = user # 数据库用户名
Password = password # 数据库密码

4、测试ODBC连接

运行isql命令，确认ODBC驱动运行正常。

isql oracle_db
select * from dual;
exit # 退出isql

四、安装OCI8扩展（可选）

如果需要使用PHP连接Oracle数据库，则需要安装OCI8扩展来支持Oracle Instant Client。

1、安装PHP扩展工具包

安装PHP扩展工具包，例如yum install php-devel。

yum install php-devel # 安装PHP扩展工具包

2、安装OCI8扩展

使用pecl命令安装OCI8扩展。

pecl install oci8

3、编辑php.ini文件

将OCI8扩展所需的配置加入php.ini文件中：

extension=oci8.so

4、重启Web服务器或PHP-FPM

五、安装PDO_OCI扩展（可选）

如果需要使用PDO连接Oracle数据库，则需要安装PDO_OCI扩展来支持Oracle Instant Client。

1、安装PHP扩展工具包

安装PHP扩展工具包，例如yum install php-devel。

yum install php-devel # 安装PHP扩展工具包

2、安装PDO_OCI扩展

使用pecl命令安装PDO_OCI扩展。

pecl install pdo_oci

3、编辑php.ini文件

将PDO_OCI扩展所需的配置加入php.ini文件中：

extension=pdo_oci.so