Oracle et PHP09/01/2004
Par
iubito (Site perso) Ce tutorial explique comment configurer Apache pour prendre en charge Oracle, et comment accéder à une base Oracle pour des requêtes. Avant-Propos 1. Prérequis et configuration 1.1. Configuration sous Linux 1.1.1. Utilisateurs et variables d'environnement 1.1.2. Compilation Apache et PHP 1.1.2.1. Installation apache simple 1.1.2.2. Installation PHP 1.1.2.3. Recompilation d'Apache 1.2. Configuration sous Windows 2. Connexion/Déconnexion : ora_logon et ora_logoff 3. Requête SELECT : comment simplifier ? 4. Autres requêtes (UPDATE, INSERT, DELETE...) En conclusion...
En 2001, pendant mon stage pour valider mon DUT, j'ai tellement
galéré sans trouver de tutorial pour me connecter à une base
Oracle avec PHP, que j'ai décidé de partager les bouts de
scripts que j'ai confectionné. Si aujourd'hui quelques rares tutoriaux Oracle/PHP existent, il y a 2 ans, Google ne m'a pas débusqué de cours ou de scripts tout faits.
Parce que je m'imagine aujourd'hui d'autres développeurs cherchant
des cours Oracle/PHP, j'ai décidé de publier mes connaissances en
la matière.
Pour accèder à une base de données Oracle, il y a en PHP les
"vieilles" fonctions (qui commencent par ora_) et les
nouvelles : les OCI (Oracle Call Interface) à partir de Oracle
8i (8.1.5). L'interface OCI peut être utilisée avec beaucoup de langages de programmation comme par exemple en Pro_Cobol ou en Pro_C.
Si vous programmez en PHP3 ou avec Oracle < 8i,
seules les fonctions ora_ sont accessibles. Il se peut aussi que le script de configuration de PHP ne détecte pas la bonne version d'Oracle (à cause du changement de nom du répertoire orainst...). C'est ce qui s'est produit pour moi. Oracle 8.1.7 était détecté en version 7.3 par PHP.
Donc, pour une question de compatibilité avec Oracle 7 et PHP3,
les codes de ce tutorial utilisent les fonctions ora_,
d'autant plus que les fonctions ora_ sont supportées par les
versions récentes d'Oracle.
Oracle fonctionne en client/serveur, c'est-à-dire qu'un serveur contient
les données et que tous les ordinateurs de l'entreprise possèdent
la version "client" : les utilitaires tels que SQL*Plus (pour faire
des requêtes). Le serveur web Apache est installé sur une machine possèdant le client.
Pour connaître plus de détails sur l'installation d'Apache et PHP,
vous pouvez jeter un oeil à l'excellent
tutorial d'Olivier Népomiachty.
Oracle utilise des "variables d'environnement". Il peut se
poser des problèmes d'utilisateurs.
Sur une machine on va trouver par exemple :
Lorsqu'on appelle un page web de cette machine, c'est le serveur
Apache qui nous répond, et il travaille sous le nom d'utilisateur
"apache".
Or notre objectif est qu'Apache (et plus particulièrement le module
PHP) accède à Oracle. Mais l'utilisateur qui accède à Oracle
est oracle. On résoud le problème en créant des variables d'environnement pour l'utilisateur apache.
Les variables suivantes sont à ajouter dans le fichier .bashrc.
Pour prendre les valeurs exactes, cherchez ces variables dans le .bashrc
de l'utilisateur oracle.
Grâce à ces variables d'environnement, l'utilisateur apache
peut se connecter à la base et donc les pages PHP y faisant
appel fonctionnent.
Olivier Népomiachty a très bien expliqué cette étape dans son tutorial. Je vous conseille d'y jeter un oeil même si je reprend les lignes essentielles ici.
Pour de la documentation et pour télécharger Apache, visitez sur
http://httpd.apache.org/.
Téléchargez dans le répertoire /usr/local/, décompressez le tar.gz dans un répertoire que vous renommerez apache.
Dans un shell, placez-vous dans le répertoire /usr/local/apache. Tapez successivement les lignes suivantes :
Maintenant lancez le démon Apache :
et connectez vous à http://IP_DE_LA_MACHINE/. Si vous
obtenez un résultat semblable à l'image ci-dessous, Apache
fonctionne :-)
Pour continuer on arrête le démon Apache
Pour de la documentation et pour télécharger PHP, tout se
trouve sur le site sur http://fr.php.net/. Téléchargez dans le répertoire /usr/local/, décompressez le tar.gz dans un répertoire que vous renommerez php.
Le "./configure" est une seule commande, les \ (backslash)
en fin de ligne permettent d'aller à la ligne pour rendre le code plus lisible.
Si vous n'êtes pas sûr, enlever les \ et les retours à la ligne, la commande marchera. Notez bien les paramètres --with-oracle et --with-oci8. Pour ce tutorial, seul le paramètre --with-oracle est utile vu que je ne parlerai pas des fonction OCI.
Maintenant nous allons dire à Apache de supporter le PHP.
Pour d'autres options intéressantes, reportez-vous au cours
d'Olivier Népomiachty.
Sous windows c'est plus simple, il suffit d'enlever le point-virgule de l'une
de ces deux lignes du fichier c:\winnt\php.ini :
Maintenant il ne reste plus qu'à démarrer Apache et passer au code PHP.
Documentation PHP : ora_logon
- ora_logoff.
Nous allons créer deux fichiers appelés connexion.php et deconnexion.php, qui auront
pour seule fonction l'ouverture et la fermeture de la connexion à la base de données.
Petit aparté à propos des connexions permanentes : Personnellement je n'utilise pas les connexion permanentes en PHP pour les raisons suivantes :
Le système des classes de Java permet de faire des connexion permanentes, une
classe instanciée au démarrage ouvre plusieurs connexion, et quand un page en
a besoin, elle la prend, puis la rend. Peut-être qu'en PHP5 on pourra faire ça ?
Aller on attaque le code :-p Voici le fichier connexion.php :
NomDeLaBase et pass, ça ne devrait pas poser trop de problèmes ;) Le service (ou TNS) est un nom du service utilisé par les applications "client" d'Oracle installées sur la même machine. Il est donc nécessaire de connaître ces infos (demandez ça à votre DBA Oracle).
Voici maintenant le fichier deconnexion.php qui ferme libère la connexion
$ora_conn :
En cas d'erreur ORA-12545, vérifiez les variables d'environnement, le fichier
tnsnames.ora (votre DBA Oracle connais mieux ce fichier que moi !).
Dans chaque page PHP devant se connecter à la base Oracle, il faut faire un
include() de connexion.php au début et un include() de deconnexion à la fin :
Documentation PHP :
ora_do -
ora_numcols -
ora_columnname -
ora_getcolumn -
ora_fetch. Notez que ora_do est la combinaison de ora_parse, ora_exec et ora_fetch.
Faire une requête "SELECT ..." sur Oracle via PHP n'est pas tout simple.
Le but est de rendre le code le plus lisible... et le requêtage plus facile à faire
(gain de temps dans le développement). Il est possible de faire un fichier inclus, appelé select.php, et qui va réaliser tout le travail, pourvu qu'on lui indique la requête. Voici donc comment faire une requête de sélection :
Ce code est assez lisible :-) Ça serait trop simple si ce n'était que ça... donc sans plus tarder, voici le code du fichier select.php :
Pour comprendre comment afficher les résultats, l'array $result ressemble à :
... ou si vous préférez, un print_r($results)
donne à peu près ceci :
L'instruction while($res = each($results)) parcours ligne par ligne l'array
$results. La variable $res équivaut à une ligne du tableau ci-dessus. Donc $res[0] contient le numéro du rang qui a peu d'importance, et $res[1] contient un array... D'où les echo $res[1]['NOM_DE_LA_COLONNE']...
On a fait le plus dur :-) Voici donc maintenant des choses plus simples :
J'espère que ma première contribution sur Developpez.com vous sera utile, qu'elle
vous permettra de gagner du temps dans le développement PHP/Oracle.
Après avoir construit ces quelques fichiers j'ai gagné un temps considérable
pour faire mes requêtes ;-)
Ce document reste la propriété exclusive de son auteur. La copie,
modification et/ou distribution par quelque moyen que ce soit est
soumise à l'obtention préalable de l'autorisation de l'auteur.
|
Copyright © 2000-2012 - www.developpez.com