Instalar cliente Oracle y librerías OCI para PHP

Ahora mismo estoy poniendo un producción un servidor en mi centro de trabajo, en el que además de tener que dar servicio para la base de datos PostgreSQL (explique hace poco cómo permitir conexiones entrantes a esta BBDD), debe hacer conexiones externas a una base de datos Oracle.

Estas conexiones las hará un script en PHP por lo que además, deberemos instalar OCI (Oracle Call Interface) para PHP. Suponemos que está ya instalado el servidor web Apache 2 y los componentes básicos de PHP.

Instalación de Oracle instantclient

Antes de instalar el instantclient como tal, debemos instalar la librería libaio, necesaria para gestionar entradas/salidas asíncronas al kernel. La instrucción será (utilizo “#” en el prompt para indicar como superusuario, “$” en caso contrario):

# yum install libaio1

O si usamos una distribución que use APT:

# apt-get install libaio1

Lo siguiente será acceder al portal de descargas de Oracle y descargar los componentes necesarios para el instantclient:

  • Basic
  • Devel
  • SQLPlus

Elegimos la última versión, nuestra arquitectura  y descargamos los paquetes RPM. La instalación será inmediata si tenemos una distribución basada en Red Hat:

# yum install paquete.rpm

En caso contrario, deberemos instalar alien previamente para que convierta los paquetes RPM en paquetes DEB:

# apt-get install alien

# alien paquete.rpm

# dpkg -i paquete.deb

Ahora ya nos tocar configurar el famoso fichero Tnsnames.ora. Este fichero variará de una configuración a otra por lo que sólo vamos a comentar dónde situarlo. Su ruta debe ser: /etc/oracle/tnsnames.ora, en caso de no existir, deberemos crearla.

Para terminar, deberemos crear unas variables de entorno. Para ello accedemos al fichero /root/.bashrc como superusuario e incluimos las siguientes líneas:

export TNS_ADMIN=/etc/oracleexport SQLPATH=/usr/lib/oracle/11.1.0.1/client/binexport LD_LIBRARY_PATH=/usr/lib/oracle/11.1.0.1/client/lib:$LD_LIBRARY_PATHexport PATH=$PATH:$SQLPATH

En algunas distribuciones, también podréis hacer ese cambio en otro fichero: /etc/environment.

Instalación de OCI en PHP

Ahora nos toca la parte de PHP, es decir, instalar los componentes necesarios para poder hacer llamadas a Oracle desde PHP usando el instantclient que acabamos de instalar (con lo fácil que es hacer esto mismo con MySQL o PostgreSQL…, las cosas del software cerrado).

Suponemos que tenemos instalado Apache2 y PHP, pero aún así instalaremos dos paquetes más:

# yum install php-pear php5-dev

# apt-get install php-pear php5-dev

PHP-PEAR es según definen sus siglas: PHP Extension and Application Repository, es decir, un repositorio de extensiones y aplicaciones para PHP que nos permite instalar sin problemas ciertos componentes de PHP que no podemos instalar a través de nuestro gestor de paquetes habitual (me recuerda a CPAN con Perl, pero esa es otra historia para otra entrada).

Ya estamos en disposición de ejecutarlo para instalar OCI:

pecl install oci8

En la terminal nos aparecerá algo así como:

1-1, ‘all’, ‘abort’, or Enter to continue:

Pulsamos “1” luego ENTER y escribimos las siguientes opciones (debemos saber el PATH exacto de nuestras librerías Oracle, cambiará en función de la versión):

shared,instantclient,/usr/lib/oracle/mi_version/client/lib/

PHP-PEAR descargará, configurará, compilará e instalará el módulo. Finalmente, tenemos que añadir a nuestro fichero php.ini una línea para que cargue la librería dinámica de OCI y puedan hacerse llamadas desde los ficheros PHP.

La ruta del fichero será: /etc/php5/apache2/php.ini y la línea a agregar junto a las demás extensiones la siguiente:

extension=oci8.so

Reiniciamos el servidor web y listo:

services httpd restart

O:

/etc/init.d/apache2 reload

Author Description

F. Javier Carazo Gil

Casi Ingeniero Informático, co-fundador y administrador de Linux Hispano, además de desarrollar software y mantener sistemas en el CSIC, hace poco he fundado junto con Alberto Hornero una start-up: CODECTION donde trabajamos con software libre. Puedes saber más sobre mí, mi vida laboral, mis libros, mis artículos y mi día a día en @fjcarazo y en mi perfil público de LinkedIn.

  • Pingback: Bitacoras.com()

  • raul ricardo

    muy bueno el resumen

    faltaria ahora la primera conexion con una la base de oracle
    Si es usando ssh cuanto mejor

  • http://www.jcarazo.com carazo

    @raúl ricardo: Muchas gracias, vaya si eso, un día podría hacer otra entrada enseñando el uso de OCI.

  • Jonathan C

    Muy bueno el resumen, se entiende,. pero podrías explicar en otro apartado como sería la conexión en el codigo php, es que he hecho todo esto ya, pero no me funciona si tengo la aplicación en un equipo (Centos) y la base de datos en otra. Quisiera saber si es problema del código, puesto si lo pruebo en local tanto la aplicación como la database me funciona.

    Gracias de antemano.

  • http://www.jcarazo.com carazo

    @Jonathan C: El problema seguramente porque debes permitir conexiones entrantes a Oracle.

    Sé cómo hacerlo en PostgreSQL: http://www.linuxhispano.net/2011/02/15/permitir-conexiones-entrantes-a-un-servidor-postgresql/ y en MySQL, pero en Oracle sinceramente no lo sé.

    Por lo que comentas, tiene pinta de ser eso.

  • Martin_tr

    excelente la guía!
    pero tengo un problema al ejecutar:

    yum install php-pear php5-dev

    me dice lo siguiente:

    Loaded plugins: fastestmirror
    Loading mirror speeds from cached hostfile
    * addons: http://ftp.inf.utfsm.cl
    * base: http://ftp.inf.utfsm.cl
    * extras: http://ftp.inf.utfsm.cl
    * updates: http://ftp.inf.utfsm.cl
    Setting up Install Process
    Package 1:php-pear-1.4.9-6.el5.noarch already installed and latest version
    No package php5-dev available.
    Nothing to do

    luego intente seguir con la guia con la instrucción:

    pecl install oci8

    y me dice:

    No releases available for package “pecl.php.net/oci8″
    Cannot initialize ‘oci8′, invalid or missing package file
    Package “oci8″ is not valid
    install failed

  • tatu

    Buenas,
    He seguido los pasos pero a la hora de conectar el php con la BD oracle me devuelve el error:

    [Wed Feb 22 09:46:46 2012] [error] [client 172.25.65.75] PHP Warning: oci_connect(): ORA-12154: TNS:could not resolve the connect identifier specified in /var/www/html/aplicacion/SID.php on line 3
    [Wed Feb 22 09:46:46 2012] [error] [client 172.25.65.75] PHP Fatal error: ORA-12154: TNS:could not resolve the connect identifier specified in /var/www/html/aplicacion/SID.php on line 6

    Si hago la conexión desde el propio servidor al servidor remoto de BD me conecta sin problemas, y si pongo la cadena de conexión en vez del SID de la BD también conecta OK; pero a la hora de conectar a través de la url de la aplicación no me resuelve el tnsnames.

    He añadido las variables de oracle al .bashrc de root y reiniciado el servicio de apache, pero sigue sin funcionar.

    export ORACLE_HOME=/usr/lib/oracle/11.2/client64
    export TNS_ADMIN=/etc/oracle
    export SQLPATH=/usr/lib/oracle/11.2/client64/bin
    export LD_LIBRARY_PATH=/usr/lib/oracle/11.2/client64/lib
    export PATH=$PATH:$SQLPATH:$TNS_ADMIN:$ORACLE_HOME

    ¿Qué puede estar fallando? ¿Alguna idea?
    Gracias.