Linux 下开启 PHP 的 Oracle 扩展

• 参考文章 Oracle 官方安装 oci8 的教程，内容很详细
• rpm 安装参考 Oracle官网文章 或者 中文文章

前言

注意以下几点（给初次使用 Linux 的小白）：

1. Linux 有多个发行本，版本不同，所使用的命令也不同。如 Debian/Ubuntu ,Fedora等
2. 由于 Debain/Ubuntu 不支持使用 rpm 安装 rpm 包，所以需要采用其他方式安装。参考文章
3. php需要已经编译安装，源码编译后会有phpize^[1]，直接在命令窗口安装的 php 一般没有编译（区别：已编译的 php 有 bin 目录）。
4. 网上教程基本上是采用 rpm 安装的形式来安装 Oracle 客户端，但是由于 Denian/Ubuntu 需要转化安装，于是本教程介绍另一种安装方式，直接采用解压缩 zip 方式安装 Oracle 客户端。
5. 本教程是确定你已经编译配置好了 apache 和 php 的情境下进行的
6. 在配置过程中，特别是 Terminal 中运行命令时，如果报错请立即解决，不要执行往后步骤。

安装配置oracle客户端

1. 下载两个安装 Oracle 客户端所必备的 zip 安装包 (或者是rpm包)，

   • zip包：instantclient-basic-linux.x64-12.2.0.1.0.zip 和 instantclient-sdk-linux.x64-12.2.0.1.0.zip
   • rpm 包则下载：oracle-instantclient12.2-basic-12.2.0.1.0-1.x86_64.rpm 和 oracle-instantclient12.2-devel-12.2.0.1.0-1.x86_64.rpm
   • 版本可以自选，但要匹配。

2. 解压两个压缩包到自定义目录下（本文安装路径为/stmpm/software/instantclient_12_2）

3. 配置环境变量,我修改的是 ~^[2]/.profile 文件。如何配置，请看

// 命令 vim ~/.profile (注意没有改文件可以自行创建，也可以创建修改/.bashrc)
// 设置环境变量的方式，下面代码写在 ~/.profile 文件中
export ORACLE_HOME=/stmpm/software/instantclient_12_2
export LD_LIBRARY_PATH=/stmpm/software/instantclient_12_2
export PATH=$ORACLE_HOME:$LD_LIBRARY_PATH:$PATH

4. 生效环境变量配置：

$ source ~/.profile
//查看环境变量，检验配置是否正确
$ echo $PATH  

5. 解压安装方式需要建立软连接，不然无法成功编译oci8。进入 Oracle 解压目录，建立软连接，命令ln -s libclntsh.so.12.1 libclntsh.so

注意 libclntsh.so.12.1 根据下载版本不同而不同。如在 Oracle11.* 的版本则为 libclntsh.so.11.1。而且该链接必须配置，否则在以下的 configure 配置步骤将会报错而导致配置失败。

配置 oci8 扩展

1. 下载 oci8 组件

下载地址，本文下载的是oci8-2.0.12.tgz

注意：oci8 版本在 2.1.0 (包含) 以上只适用 php7.0。其他版本注意看下载官网的版本说明。

2. 解压下载的 oci8 组件包

1. 解压到自定义目录，本文 /stmpm/software/oci8-2.0.12
2. 进入该目录cd /stmpm/software/oci8-2.0.12，以下称为 oci 目录^[3]

3. 编译 oci8

注意，php源码里面的 ext 目录下会有 oci8 组件目录，可以使用该目录进行编译，该目录相当于本文的 oci 目录^[3]

1. 执行 phpize，如果 phpize 不是全局的，直接通过 phpize 绝对路径运行。如 phpize 所在目录为 /usr/php/bin 下，命令可以为 /usr/php/bin/phpize
2. 执行后，会在 oci 目录^[3] 中生成一些文件和目录，使用其中的 configure 可执行文件进行配置
3. 编译 make，若成功则执行 make install 安装，安装成功后会在 php.ini 设置的 extension_dir 目录中生成 oci8.so。如果没有先指定 extension_dir，系统会根据特定规则生成目录。该目录会在 Terminal 中显示出来

4. 综合步骤命令

$ phpize 
$ ./configure --with-php-config=/stmpm/lamp/php/bin/php-config  --with-oci8=shared,instantclient,/stmpm/software/instantclient_12_2
$ make
$ make install  

检验结果

1. 在确认配置无误的情况下，重启 Apache
2. 检验 oci 扩展是否开启
   可以直接在apche所配置的web文件夹中新建一个phpinfo.php文件，输入：

在浏览器运行查看，页面中若有 oci8 标识说 oci8 是 enable 的，且会罗列一些 oci8 的配置信息则证明开启成功。

结束语

最近需要在服务器（Linux环境下）开启php的oracle扩展，由于之前没有在Linux环境下开发的经验，所以遇到很多困难，查了很多教程。网上教程也很多是类似的，无法满足我的需求。所以在综合了许多教程后理出这篇教程（有点乱），适合像我这样刚刚接触Linux开发环境的同志们。另外，本文不足之处希望能够指出，大家相互学习，相互进步。

---

1. linux系统中，php安装成功后，在bin目录下会生成一个名叫phpize的可执行脚本，这个脚本的用途是动态安装php扩展模块。 ↩

2. ~在 Linux系统中代表当前用户的主目录，例如用户为user，则 ~ 表示 /home/user 目录。 ↩

3. 本文指下载的 oci8 组件解压后所在的目录，即/stmpm/software/oci8-2.0.12 ↩ ↩ ↩