Feedback

Habilitando Oracle Cloud ODBC

No Scriptcase, temos disponíveis os seguintes drivers para conexão com o Oracle: Oracle 8.0.5 ou Acima, Oracle PDO, Oracle ODBC e Oracle 8. Se você estiver utilizando um ambiente próprio, pré-configurado, as extensões do Oracle devem ser habilitadas manualmente no PHP.

IMPORTANTE: Se você estiver utilizando o instalador automático do Scriptcase, as extensões já estão habilitadas no PHP, prontas para conexão. O procedimento abaixo é apenas para instalações manuais do Scriptcase.

Pré-requisitos

Antes de prosseguir nesta documentação, verifique a arquitetura do seu PHP. Para que os drivers sejam habilitados corretamente, os arquivos devem ser baixados de acordo com a arquitetura utilizada.

  • No seu Scriptcase, existe o arquivo info.php, acesse-o pela URL: http://127.0.0.1:8092/scriptcase/info.php, onde você irá encontrar a informação referente a arquitetura no phpinfo().

ATENÇÃO: Realize o download do Oracle instant client de acordo com a arquitetura do seu PHP.

Arquitetura do PHP

  • Arquitetura i386/i686 = 32 bits
  • Arquitetura x86_64 = 64 bits

Abaixo estão listados os arquivos necessários para que os drivers do Oracle sejam habilitados.

Arquivos necessários:

Ubuntu x64

  • Oracle Instant Client - Basic Package 12.1.0.2(x86_64): Clique Aqui
  • Oracle Instant Client - Devel Package 12.1.0.2(x86_64): Clique Aqui

Red-Hat/Centos/OpenSuse

x86_64

  • Oracle Instant Client - Basic Package 12.1.0.2(x86_64): Clique Aqui
  • Oracle Instant Client - Devel Package 12.1.0.2(x86_64): Clique Aqui
  • Oracle Instant Client - ODBC Package 12.1.0.2(x86_64): Clique Aqui

i386/i686

  • Oracle Instant Client - Basic Package 12.1.0.2(i386/i686): Clique Aqui
  • Oracle Instant Client - Devel Package 12.1.0.2(i386/i686): Clique Aqui
  • Oracle Instant Client - ODBC Package 12.1.0.2(i386/i686): Clique Aqui

IMPORTANTE: O PHP 8.1 é compatível com o Oracle Instant Client 11.2 ou superior.
Para realizar o download do Oracle Instant Client inferior a versão 19.5.0.0, é necessário ter uma Conta Oracle.

Outros Arquivos

  • Oracle Instant Client 12.2.0 ou Superior: Clique Aqui

Tabela de Compatibilidade

Drive Versão do banco de dados Oracle            
Oracle ODBC 9i Driver 9i 10g Driver 10g 11g R1 Driver 11g R1 11g R2(11.2) Driver 11g R2(11.2) 12c Driver 12c 18c Driver 18c 19c Driver 19c
Instant Client Versão de base de dados Oracle            
19.6.0.0 9i Driver 9i 10g Driver 10g 11g R1 Driver 11g R1 11g R2(11.2) Driver 11g R2(11.2) 12c Driver 12c 18c Driver 18c 19c Driver 19c

Configurando Oracle Cloud ODBC no Linux

É necessário habilitar a extensão do Oracle no PHP e configurar o instant_client para realizar a conexão. Siga os passos descritos abaixo para habilitar os drivers de conexão.

1 - Instale os pacotes abaixo:

UBUNTU\DEBIAN CENTOS\RHEL
sudo apt-get update sudo yum update
sudo apt-get install libaio1 sudo yum install libaio-devel
sudo apt-get install libncurses5 sudo yum install libaio
sudo apt-get install alien sudo yum install glibc
sudo apt-get install gcc-multilib g++-multilib sudo yum install compat-libstdc++-33
sudo apt-get install libpam0g sudo yum install glibc-devel
sudo apt-get install unixodbc-dev unixodbc sudo yum install libstdc++
  sudo yum install libstdc++
  sudo yum install pam
  sudo yum install ncurses-devel
  sudo yum install unixODBC

2 - Converta e instale os pacotes do Instant Client Basic baixados anteriormente em seu sistema Linux:

UBUNTU\DEBIAN CENTOS\RHEL
sudo alien oracle-instantclient12.1-devel-12.1.0.2.0-1.x86_64.rpm sudo yum install oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm
sudo alien oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm sudo yum install oracle-instantclient12.1-devel-12.1.0.2.0-1.x86_64.rpm
sudo dpkg -i oracle-instantclient12.1-basic_12.1.0.2.0-2_amd64.deb  
sudo dpkg -i oracle-instantclient12.1-devel_12.1.0.2.0-2_amd64.deb  

3 - Copie a extensão oci8.so baixada anteriormente para o diretório de extensões do PHP:

EX: sudo cp oci8.so /usr/lib/php/20180731

Acesse o arquivo info.php e procure pela linha extension_dir. Ela informará o caminho exato para o diretório responsável pelas extensões do PHP.

Caminho para o diretório de extensões do PHP

4 - Edite o arquivo do php.ini e declare no final do arquivo a extensão do Oracle.

UBUNTU\DEBIAN CENTOS\RHEL
/etc/php/7.3/apache2/php.ini /etc/php.ini

EX: extension=oci8.so

Inserindo extensão no php.ini

5 - Edite o arquivo das variáveis de ambiente e declare a variável responsável por identificar a biblioteca do Oracle:

Informe a váriavel LD_LIBRARY_PATH e o caminho para a biblioteca no arquivo responsável pelas variáveis de ambiente do seu sistema. Verifique abaixo o caminho de acordo com o seu sistema operacional:

ATENÇÃO: O caminho para a biblioteca pode depender de como você realizou a sua instalação, por padrão o caminho é este: /usr/lib/oracle/12.1/client64/lib/.

UBUNTU\DEBIAN CENTOS\RHEL
sudo nano /etc/apache2/envvars sudo nano /etc/sysconfig/httpd
  • Adicione esta variável no final do arquivo com a sintaxe:

export LD_LIBRARY_PATH=/usr/lib/oracle/12.1/client64/lib/

EX:

Adicionando a variável de ambiente do Client Oracle

NOTA: Se você estiver utilizando CentOS/RHEL, não será necessário utilizar o ‘export’ antes da variável.

6 - Reinicie o serviço do apache do Scriptcase para que as mudanças surtam efeito. Utilize os comandos abaixo de acordo com o seu sistema operacional.

UBUNTU\DEBIAN CENTOS\RHEL
sudo service apache2 restart sudo systemctl restart httpd

Conexão com o Scriptcase

Dúvidas ou Problemas de Conexão?

Contacte o nosso suporte em caso de problemas de conexão ou dúvidas a respeito deste banco de dados.