Instalacja rozszerzenia ORACLE dla PHP

Generalnie całość instalacji przechodzi bez przeszkód, posługując się poniższą dokumentacją

​https://help.ubuntu.com/community/Oracle%20Instant%20Client

z tą różnicą że w kilku miejscach nie zgadza się link do biblioteki jeśli serwer ma architekturę i386/i686 czyli 32bit (bo wówczas nazwa katalogu nie jest client64 tylko client.

Pobieramy 3 paczki (basic-client, sdk oraz sqlplus)

Na podstawie powyższej instrukcji wykonujemy następujące kroki. Instalacja pakietu Alien dla przekompilowania pakietów dla Debian Linux.

apt-get install alien

Następnie kompilujemy pakiety

alien -i oracle-instantclient12.2-basic-12.2.0.1.0-1.x86_64.rpm
alien -i oracle-instantclient12.2-devel-12.2.0.1.0-1.x86_64.rpm

oraz instalujemy

apt-get install libaio1

Pamiętać konieczne o dodaniu ścieżek do /etc/profile. W tym celu należy edytorem np. [vim wiki:AdminGuide/Vim] otworzyć plik /etc/profile oraz do /etc/apache2/envvars i wpisać tam:

ORACLE_HOME=/usr/lib/oracle/12.2/client
export ORACLE_HOME
LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH
export PATH=$PATH:$ORACLE_HOME/bin

Klient już powinien działać, można przetestować:

sqlplus user/passwd@//192.168.1.4:1521/sid

Następnie możemy testować połączenie przez TNS, o ile utworzymy definicję połaczenia TNS:

mkdir -p /usr/lib/oracle/12.2/client/network/admin
vim /usr/lib/oracle/12.2/client/network/admin/tnsnames.ora

Do pliku tnsnames.ora należy wpisać dane: CERES zastepujemy nazwą:​http://www.orafaq.com/wiki/Tnsnames.ora

CERES =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = SEARS)(PORT = 1521))
)
(CONNECT_DATA =
(SERVICE_NAME = CERES)
)
)

Następnie instalacja peclem rozszerzenia php (nie najnowsze bo jest zlinkowane z PHP7):

pecl install oci8-2.0.12
w trakcie należy podać ścieżkę do ORACLE_HOME (tą samą co wyżej w zmiennej ORACLE_HOME)

Następnie dodajemy plik z treścią: extension=oci8.so
vim /etc/php5/conf.d/20-oci.ini

W niektórych przypadkach może się okazać za samo utworzenie pliku z extension=oci8.so rozszerzenie nie będzie wykorzystywane przez PHP. W takim przypadku należy dodać rozszerzenie w następującej lokalizacji

/etc/php5/cli/conf.d/20-oci.ini
/etc/php5/apache2/conf.d/20-oci.ini

Restart apache. W tym momencie powinny działać już przykładowe skrypty php do połączenia z ORACLE. ​oci_connect.

Po udanym teście można rozpocząć konfigurację źródła ORACLE w eDokumenty.

Prawdopodobnie będziemy chcieli wykorzystać skrypty w zadaniach wsadowych wykonywanych z crontab. W tym celu należy również zadeklarować zmienne w /etc/crontab np:

vim /etc/crontab

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/lib/oracle/12.2/client/bin
ORACLE_HOME=/usr/lib/oracle/12.2/client

TROUBLESHOOTING

Patrz wyżej - dokładnie przeczytaj manual z podanego linka i powyższe komentarze.

1. Połączenie działa z przeglądarki ale nie działają wsadowe akcje:

Pierwsze sprawdzamy log /var/log/php_error.log widać błędy: [05-Jul-2017 21:30:02 Europe/Warsaw] [2]: oci_connect(): ORA-12154: TNS:could not resolve the connect identifier specified in /home/edokumenty/public_html/framework/lib/db/OracleManager.inc:110

Uzupełnij w /etc/crontab prawidłowe zmienne środowiskowe ORACLE_HOME i PATH

Poprawność uruchomienia modułu możemy także sprawdzić za pomocą PHPinfo

Alternatywnie może korzystać także z poniższej dokumentacji: ​https://gist.github.com/hewerthomn/81eea2935051eb2500941a9309bca703