如何在 ubuntu 机器上安装 oracle instantclient 和 pdo_oci？

Posted 2023-02-24

【中文标题】如何在 ubuntu 机器上安装 oracle instantclient 和 pdo_oci？

【英文标题】：How to install oracle instantclient and pdo_oci on ubuntu machine?

【发布时间】：2014-03-23 01:34:32

【问题描述】：

我需要在 ubuntu 机器上安装 PDO_OCI，没有可以用 apt-get 安装的默认包。

有很多教程展示了如何做到这一点，但是当我遵循它们时，我遇到了与编译相关的问题（配置，制作，...）

我做了什么：

我关注this Tutorial安装即时客户端

安装oci8

pecl install oci8

我得到错误：

错误：找不到 oci.h

安装 PDO_OCI

mkdir -p /tmp/pear/download/
cd /tmp/pear/download/
pecl download pdo_oci
phpize
./configure –with-pdo-oci=instantclient,/usr,11.2

错误：

找不到pdo_driver.h ...

请问您有任何在 UBUNTU 12.04 上完美运行的严肃教程吗？

【参考方案1】：

答案是此article（俄语）的复制品，它又基于此post 并进行了一些更正。经过几天无果的搜索，它对我来说很顺利。

先决条件：

你应该有管理员权限

您应该安装了带有以下软件包的 php5：

sudo apt-get install php5 php5-dev php-pear php5-cli
sudo pecl install pdo

你应该已经安装了 libaio1 库：

sudo apt-get install libaio1

安装 Oracle Instant Client

从 Oracle 网站 (oracle.com/technetwork/database/features/instant-client/index-097480.html) 下载适用于您的处理器架构和操作系统的 Oracle 即时客户端。

对于 Linux，有 2 个即时客户端选项： 适用于 Linux、CentOS、Fedora、Red Hat Enterprise Linux、Mandriva Linux、SUSE Linux 等的 RPM 包。 ZIP 存档——适用于所有其他不支持 RPM 的文件。

有2个文件要下载：

instantclient-basic — Oracle 即时客户端本身

instantclient-sdk — 一组用于应用程序开发的库

为 Oracle 即时客户端创建目录（为软件扩展保留的 /opt 目录非常适合此目的）：

sudo mkdir -p /opt/oracle/

将下载的文件移动到 /opt/oracle 并切换到目标文件夹（假设您将“zip”档案下载到用户的“downloads”目录）：

sudo mv ~/downloads/instantclient-*.zip /opt/oracle/
cd /opt/oracle/

提取下载的档案：

sudo unzip instantclient-basic-*-*.zip
sudo unzip instantclient-sdk-*-*.zip

最后，我们在 /opt/oracle 中为 Oracle 即时客户端 11.2.0.2.0 创建了 instantclient_11_2 目录。将此目录重命名为instantclient（注意版本号）并切换到：

sudo mv instantclient_11_2 instantclient
cd instantclient

接下来我们必须创建几个额外的目录和符号链接（注意版本号）：

sudo ln -s /opt/oracle/instantclient/libclntsh.so.* /opt/oracle/instantclient/libclntsh.so
sudo ln -s /opt/oracle/instantclient/libocci.so.* /opt/oracle/instantclient/libocci.so
sudo ln -s /opt/oracle/instantclient/ /opt/oracle/instantclient/lib

sudo mkdir -p include/oracle/11.2/
cd include/oracle/11.2/
sudo ln -s ../../../sdk/include client
cd -

sudo mkdir -p lib/oracle/11.2/client
cd lib/oracle/11.2/client
sudo ln -s ../../../ lib
cd -

创建包含要搜索 Oracle 即时客户端库的目录名称的配置文件并启用它：

echo /opt/oracle/instantclient/ | sudo tee -a /etc/ld.so.conf.d/oracle.conf
sudo ldconfig

只要 Ubuntu 中没有目录 /usr/include/php，但客户端仍在搜索它，我们将创建符号链接到它的等效项 - php5：

sudo ln -s /usr/include/php5 /usr/include/php

安装OCI8

在之前的操作之后，使用pecl 命令安装oci8 扩展：

sudo pecl install oci8

系统将提示您输入 Oracle 即时客户端的路径，回复：

instantclient,/opt/oracle/instantclient

创建扩展连接文件：

echo "; configuration for php oci8 module" | sudo tee /etc/php5/conf.d/oci8.ini
echo extension=oci8.so | sudo tee -a /etc/php5/conf.d/oci8.ini

安装 PDO_OCI

要安装 PDO_OCI，请从 pear 存储库 (pear.php.net) 下载它。

更新梨包列表：

sudo pecl channel-update pear.php.net

下载存档到临时目录：

sudo mkdir -p /tmp/pear/download/
cd /tmp/pear/download/
sudo pecl download pdo_oci

提取存档内容：

sudo tar xvf PDO_OCI*.tgz
cd PDO_OCI*

这里我们必须修改config.m4 文件，因为它不包含关于我们的Oracle 即时客户端版本的信息。打开文件并添加标记为“+”的更改（注意版本号）：

sudo vim config.m4

下面是2个文件的diff：

***************
*** 7,12 ****
--- 7,14 ----
if test -s "$PDO_OCI_DIR/orainst/unix.rgs"; then
PDO_OCI_VERSION=`grep '"ocommon"' $PDO_OCI_DIR/orainst/unix.rgs | sed 's/[ ][ ]*/:/g' | cut -d: -f 6 | cut -c 2-4`
test -z "$PDO_OCI_VERSION" && PDO_OCI_VERSION=7.3
+ elif test -f $PDO_OCI_DIR/lib/libclntsh.$SHLIB_SUFFIX_NAME.11.2; then
+ PDO_OCI_VERSION=11.2
elif test -f $PDO_OCI_DIR/lib/libclntsh.$SHLIB_SUFFIX_NAME.10.1; then
PDO_OCI_VERSION=10.1 
elif test -f $PDO_OCI_DIR/lib/libclntsh.$SHLIB_SUFFIX_NAME.9.0; then
***************
*** 119,124 ****
--- 121,129 ----
10.2)
PHP_ADD_LIBRARY(clntsh, 1, PDO_OCI_SHARED_LIBADD)
;;
+ 11.2)
+ PHP_ADD_LIBRARY(clntsh, 1, PDO_OCI_SHARED_LIBADD)
+ ;;
*)
AC_MSG_ERROR(Unsupported Oracle version! $PDO_OCI_VERSION)
;;
***************

使用phpize (php.net/manual/ru/install.pecl.phpize.php) 命令为 php 扩展准备环境：

sudo phpize

配置包安装器和安装包（注意版本号）：

sudo ./configure --with-pdo-oci=instantclient,/opt/oracle/instantclient/,11.2
sudo make
sudo make install

为其创建连接文件：

echo "; configuration for php PDO_OCI module" | sudo tee /etc/php5/conf.d/pdo_oci.ini
echo extension=pdo_oci.so | sudo tee -a /etc/php5/conf.d/pdo_oci.ini

重启apache并检查是否安装了扩展：

sudo /etc/init.d/apache2 restart
php -m

【讨论】：

PDO_OCI 作为 PECL 模块已过时！使用github.com/php/php-src/tree/PHP-5.6.17/ext/pdo_oci（或者你使用的任何PHP版本，除非你正在运行php7，否则不要使用master）

另外，在 64 位系统上，您可能需要在创建目录时使用“client64”而不是“client”。

如果您在运行 make 时遇到编译错误，请参阅解决方案 ***.com/questions/20874536/pdo-oci-make-does-not-work

另外，在创建连接文件时，路径也可能是（取决于我猜的 Apache 版本或 Ubuntu），至少在我的情况下，/etc/php5/apache2/conf.d

对我来说 php -m 没有列出 oci 模块。我不得不使用 phpinfo() 来检查“PDO 驱动程序”这一行是否包含 oci。但除了我的 cmets 之外，现在一切正常！谢谢！

【参考方案2】：

pecl install 的 PDO、PDO_OCI 扩展已过时，因为最新的 PHP 版本已将它们内置在其核心中，并且通过这种方式安装这些扩展大多失败。

我花了很多时间尝试以下几种方法但没有运气，最后自己找到了一种干净的方法：从 PHP 源编译和安装扩展强>。

在编译的过程中，也有一些技巧，我已经在我的帖子中详细描述了这个过程：https://medium.com/@thucnc/how-to-install-php5-pdo-oci-oci8-and-other-extensions-for-ubuntu-f405eadfe784

此处列出了简短的步骤：

下载安装Oracle Instant Client，然后导出ORACLE_HOME环境变量

从 PHP 源包中下载和编译 PDO_OCI（如果需要，还有 OCI8），您需要在此处应用一些技巧，包括：

sudo ln -s /usr/include/php5/ /usr/include/php

并编辑 Makefile：

EXTRA_INCLUDES = -I/usr/include/oracle/11.2/client64

启用扩展并重启网络服务器

这也已针对 Debian 7.6 进行了测试

希望这会有所帮助。

【讨论】：

那个链接失效了，这就是不鼓励链接的原因。

在关注了中等帖子之后，它仍然不适合我。它在 PHP CLI 中工作，但不在浏览器中。我最终只是为了大声笑重新启动了整个服务器，它开始在 apache 中工作。 Apache 已多次重新启动以使其正常工作。

@thucnguyen 我是在 ubuntu 18.04 中完成的。但仅适用于 php CLI，不适用于 apache2。来自浏览器的 phpinfo 未显示任何 pdo 扩展名。

【参考方案3】：

本指南可能有助于从源代码编译 pdo_oci 模块，因为 PECL 版本现已过时。我为 CentOS 6.6、PHP v5.3.3 和 Oracle Instant 客户端 v.12.1 编写了 the original post，但它也应该很容易应用于您的案例。

安装PHP开发包

$ apt-get install php-devel 

下载 PHP 源代码

$ cd /usr/local/src
$ mkdir php_source
$ cd php_source/
$ wget http://museum.php.net/php5/php-5.3.3.tar.gz
$ gunzip php-5.3.3.tar.gz
$ tar xvf php-5.3.3.tar

为编译准备 PDO_OCI

确保您设置了 $ORACLE_HOME 环境变量。就我而言，它指向 /usr/lib/oracle/12.1/client64

浏览到扩展源文件所在的文件夹：

$ cd php-5.3.3/ext/pdo_oci

由于我们运行的是 Oracle 客户端 12.1 版，扩展程序不支持开箱即用，因此我们需要做一些修改。我们的 Instant Client 版本号需要添加到 config.m4 文件中，否则 configure 将失败并显示以下错误消息

Oracle 版本...配置：错误：在 /usr/lib/oracle/12.1/client64 下找不到 Oracle 所需的 OCI8 库

打开 config.m4 文件并查找 SUPPORTED_LIB_VERS（第 5 行左右），将 12.1 添加到版本列表中。还可以找到case $PDO_OCI_VERSION in 行（可能是第134 行）并将|12.1 添加到它下面的版本列表中。保存文件，这就是我们所需要的。

准备、配置和制作扩展

$ phpize
$ ./configure
$ make

现在，make 很可能会因为找不到 Oracle 头文件而失败，例如oci.h.这是因为，除非您在开发人员模式下安装了 Oracle 服务器或 Instant 客户端，否则服务器上不存在这些文件。

转到 oracle.com，Instant Client Downloads for Linux 页面并获取适用于您的版本的 Instant 客户端 SDK 包： Instant Client Downloads for Linux

就我而言，我下载了这个文件：http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html

在您选择的任何位置解压文件。我们需要的头文件在 sdk/include 文件夹中。将所有这些文件复制到扩展的 include 文件夹：/usr/local/src/php_source/php-5.3.3/ext/pdo_oci/include

现在make应该通过了：

$ make

作为最终结果，您将在扩展目录的 /modules 子文件夹中获得一个已编译的 pdo_oci.so 模块： /usr/local/src/php_source/php-5.3.3/ext/pdo_oci/modules/pdo_oci.so

移动并启用编译模块

找出 PHP 在服务器上存储其扩展的位置

$ php -i | grep extension_dir

将扩展名 (pdo_oci.so) 复制到该目录。

现在有几种方法可以启用该模块。一种是将它包含在主 php.ini 文件中，但在我的情况下，我在其他模块的其他 .ini 文件所在的文件夹中创建了一个单独的 .ini 文件，并且 PHP 在启动时包含这些文件。

于是我创建了一个文件/etc/php.d/pdo_oci.ini，内容如下：

; Enable pdo_oci extension module
extension=pdo_oci.so

或者，可以将同一行添加到您的 php.ini 文件中。

重启Apache并检查

$ /etc/init.d/httpd restart

如果您安装了 PHP CLI，您可以检查已加载模块的列表，否则创建一个包含 phpinfo() 的 PHP 文件并检查输出。如果您在输出中看到 PDO_OCI - 恭喜！

$ php -m

学分

感谢 Mattias Geniar 关于如何从源代码编译 PHP 扩展的原始帖子：https://ma.ttias.be/how-to-compile-and-install-php-extensions-from-source/

【讨论】：

要在基于 Debian 的系统上下载 php 源代码，您可以这样做 apt-get source php5

【参考方案4】：

不推荐使用 PECL 安装，不要使用它。这是一个很好的教程一步一步如何在 linux 机器上安装 PDO_OCI 和 Oracle 即时客户端： http://shar.lt/linux-install-oracle-instant-client-php-pdo_oci-library/