MAJ DOC (Installation spartan - module OCI8)

# Support Oracle OCI8 pour PHP

> UPDATE : Debian bullseye / PHP7.4

Procédure d'installation du **module PHP OCI8** afin de permettre d'utiliser les connexions à une base de données Oracle en PHP.

Cette procédure se fait en 2 étapes, commencer par récupérer et installer les différents utilitaires pour la connexion à Oracle (utilitaires indépendant de PHP). Puis l'installation du module PHP OCI8.

Cette procédure se fait en 2 étapes, commencer par récupérer et installer les différents utilitaires pour la connexion à Oracle (utilitaires indépendants de PHP). Puis l'installation du module PHP OCI8.

### Prérequis

 - *phpize* et *pecl* Installation du paquet `php7.4-dev`

## Oracle Instant Client

Les différents utilitaires sont accessibles depuis la page <https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html>

Vous devrez récupérer au minimum  : 

 - Basic Package (ZIP) instantclient-basic-linux.x64-X.X.X.X.dbru.zip

 - SDK Package (ZIP) instantclient-sdk-linux.x64-X.X.X.X.dbru.zip

Les différents utilitaires sont accessibles depuis la page 

https://git.unicaen.fr/open-source/oscar/-/wikis/Installation-OCI

Dans cet exemple, je vais placer les utilitaires dans le dossier **/opt/oracle** : 

Téléchargez les dans votre `/tmp`

```bash

mkdir -p /opt/oracle

cd !$

```

On va dézipper les 2 archives obtenues : 

## Installation

```bash

unzip  /path/to/instantclient-basic-linux.x64-X.X.X.X.dbru.zip

unzip  /path/to/instantclient-sdk-linux.x64-X.X.X.X.dbru.zip

```

Vous devriez avoir dans votre dossier **/opt/oracle** un dossier **instantclient_X_X**

# Extraction des archives

unzip -o /tmp/instantclient-basiclite-linux.x64-18.5.0.0.0dbru.zip -d /usr/local/

unzip -o /tmp/instantclient-sdk-linux.x64-18.5.0.0.0dbru.zip -d /usr/local/

unzip -o /tmp/instantclient-sqlplus-linux.x64-18.5.0.0.0dbru.zip -d /usr/local/

# Lien symbolique "instantclient/sqlplus"

ln -sf /usr/local/instantclient_18_5 /usr/local/instantclient

ln -sf /usr/local/instantclient/sqlplus /usr/local/bin/sqlplus

##  PHP7.3 OCI

# Installation via PECL

echo 'instantclient,/usr/local/instantclient' | pecl install oci8-2.2.0

## LIBAIO1

# Configuration PHP

echo "extension=oci8.so" > /etc/php/7.4/apache2/conf.d/30-php-oci8.ini

echo "extension=oci8.so" > /etc/php/7.4/cli/conf.d/30-php-oci8.ini

On commence  par installer la  librairie **libaio**

```bash

$ apt install libaio

# Dynamic Library Config

echo "/usr/local/instantclient" > /etc/ld.so.conf.d/oracle-instantclient.conf

ldconfig

```

### PECL

Pour l'installation du module OCI8 de PHP7.3, on va utiliser **pecl**

Pour installer PECL : 

Petit *restart* de *Apache*

```bash

$ apt install php-pear

$ pecl version

  PEAR Version: 1.10.8

  PHP Version: 7.3.11-1+ubuntu18.04.1+deb.sury.org+1

  Zend Engine Version: 3.3.11

  Running on: Linux ED209 #67-Ubuntu SMP Thu Aug 22 16:55:30 UTC 2019 x86_64

service apache2 restart

```

> Si vous êtes derrière un proxy, utilisez la commande `pear config-set http_proxy http://<user>:<password>@<ip_proxy>:<port>` pour régler le proxy utilisé par PEAR (il n'utilise pas le proxy système...)

PECL a besoin de **phpize** qui est inclus dans la librairie **php7.3-dev** pour compiler certains module (dont OCI8 qui nous interesse): 

```bash

$ apt install php7.3-dev

$ phpize -v

Configuring for:

PHP Api Version:         20180731

Zend Module Api No:      20180731

Zend Extension Api No:   320180731

```

### OCI8 

```bash

pecl install oci8

```

Enfin, on installe OCI8. Vous devrez renseigner l'emplacement de l'instantclient installé à l'étape précédente :

la réponse sera : **instantclient,/opt/oracle/instantclient_X_X**

### PHP.INI

On va maintenant activer le module PHP (OCI8) dans le PHP.INI.

Pensez à le faire pour les PHP CLI et SERVEUR

```

# Extrait du fichier php.ini

;extension=interbase

;extension=ldap

;extension=mbstring

;extension=exif      ; Must be after mbstring as it depends on it

;extension=mysqli

# ON ACTIVE  OCI8

extension=oci8  ; Use with Oracle Database 12c Instant Client

;extension=odbc

;etc...

```

## Problèmes connus

### libnnz19.so !

### Installation de PHP7.4

> Pour éviter les problèmes de compatibilité, il est fortement recommandé de supprimer les anciennes version de php avec `apt remove`

Installation des paquets PHP

```bash

 php7.4-curl \

 php7.4-dom \

 php7.4-gd \

 php7.4-gearman \

 gearman-php \

 php7.4-intl \

 php7.4-ldap \

 php7.4-mbstring \

 php7.4-zip

```

### Passage PHP7.3 > PHP7.3

Il faut ensuite configurer l'utilisation de PHP pour l'utilisation en ligne de commande (**cli**) et *Apache* :

> Si vous conservez d'ancienne versions de PHP, Il faut configurer l'utilisation de PHP pour l'utilisation en ligne de commande (**cli**) et *Apache* :

#### Pour PHP-CLI

systemctl restart apache2

```

#### OCI

Le module PHP *OCI8* assure la connexion entre Oscar et SIFAC, pour l'installer, suivez la procédure suivante : [Installation OCI8 pour PHP7.4](./install-oracle-pp.md)

#### Vérifier

Vérifier que tout les modules PHP sont bien chargés en 7.4 :

php bin/oscar.php check:privileges

```

> Il est possible de Github vous demande de générer un *token* d'accès (à créer depuis github.com)

### Mise à jour de la configuration LDAP

Configuration de l'authentification

tmp

*-local

 No newline at end of file

tmp

*-local

 No newline at end of file