Linux 下开启 PHP 的 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.zipinstantclient-sdk-linux.x64-12.2.0.1.0.zip
    • rpm 包则下载:oracle-instantclient12.2-basic-12.2.0.1.0-1.x86_64.rpmoracle-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
  1. 生效环境变量配置:
$ source ~/.profile
//查看环境变量,检验配置是否正确
$ echo $PATH  
  1. 解压安装方式需要建立软连接,不然无法成功编译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文件,输入:
<?php
    echo phpinfo();
?>
  

在浏览器运行查看,页面中若有 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

推荐阅读更多精彩内容