Création d'une application PHP

Pour créer une application PHP qui accède à une instance Autonomous Database, commencez par configurer votre système de développement afin qu'il prenne en charge l'accès à la base de données qui peut tirer parti de la disponibilité continue et des fonctionnalités hautes performances d'Autonomous Database.

Après avoir configuré votre système de développement, codez les connexions de base de données et les instructions SQL dans votre application pour tirer parti des fonctionnalités de hautes performances et de disponibilité continue.

Rubriques connexes

Configuration de votre système de développement PHP

Pour configurer votre système de développement de sorte que votre application PHP puisse tirer parti de la disponibilité continue et des fonctionnalités hautes performances d'une instance Autonomous Database, procédez comme suit.

  1. Téléchargez et installez PHP.
  2. Téléchargez et installez Oracle Instant Client.
  3. Téléchargez et installez PHP OCI8.
  4. Téléchargez les informations d'identification client de la base de données et rendez-les disponibles pour Oracle Instant Client.

Avant de commencer

Votre système de développement doit répondre à certains critères pour sa configuration.

Téléchargement et installation de PHP

Téléchargez et installez PHP pour le système d'exploitation et l'architecture de votre système :

  • Oracle Linux :

    Exécutez les commandes suivantes pour télécharger et installer PHP, et pour télécharger et installer PEAR afin d'obtenir la commande de gestion de package pecl de PHP :

    sudo dnf install -y oracle-release-el8 oracle-php-release-el8
sudo dnf install -y php php-devel php-xml dtrace-utils
wget http://pear.php.net/go-pear.phar
sudo php go-pear.phar

  • Autres OSes et architectures :

    Accédez à la page PHP relative à l'installation et la configuration et suivez les instructions relatives au système d'exploitation et à l'architecture de votre système.

Téléchargement et installation d'Oracle Instant Client

Téléchargez et installez le package de base Oracle Instant Client pour le système d'exploitation et l'architecture de votre système :

  • Oracle Linux :

    Exécutez les commandes suivantes pour télécharger et installer le package Oracle Instant Client Basic :

    sudo dnf -y install oracle-release-el8
sudo dnf -y install oracle-instantclient21.13-basic oracle-instantclient21.13-devel

    (Pour afficher la liste de tous les packages Instant Client, accédez à la page http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

  • Autres OSes et architectures :

    1. Accédez à la page Téléchargements Oracle Instant Client, et sélectionnez le téléchargement pour le système d'exploitation et l'architecture de votre système.

    2. Sur la page de téléchargement, acceptez le contrat de licence Oracle Technology Network, téléchargez la dernière version du package Basic et du package de kit SDK, puis installez-les en suivant les instructions figurant au bas de la page de téléchargement.

Téléchargement et installation de PHP OCI8

Téléchargez et installez l'extension OCI8 pour PHP pour le système d'exploitation et l'architecture de votre système :

  • Oracle Linux :

    Exécutez les commandes suivantes pour télécharger et installer la dernière version de l'extension OCI8 :

    sudo PHP_DTRACE=yes pecl install oci8
sudo sh -c "echo extension=oci8.so > /etc/php.d/20-oci8.ini"
sudo sh -c "echo oci8.events = On > /etc/php.d/20-oci8.ini"

    Si vos applications ont besoin de variables d'environnement Oracle, ajoutez-les au fichier de configuration /etc/sysconfig/httpd, par exemple : 

    NLS_LANG=AMERICAN_AMERICA.AL32UTF8
NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'
ORA_SDTZ=UTC

    Si vous ajoutez ces variables, redémarrez Apache HTTP Server pour lire les nouvelles variables :

    sudo systemctl restart httpd

  • Autres OSes et architectures :

    1. Exécutez la commande suivante :

      pecl install oci8

    2. Ajoutez les lignes suivantes au fichier php.ini de votre installation PHP : 

      extension=oci8.so
oci8.events = On

Téléchargement et installation des informations d'identification client pour la base de données

  1. Téléchargez le fichier ZIP contenant les informations d'identification client pour la base de données vers un répertoire sécurisé de l'ordinateur.

    Ce fichier ZIP peut être téléchargé à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous disposez d'un compte utilisateur Oracle Cloud vous permettant d'accéder à cette page, téléchargez les informations d'identification comme suit. Si vous ne disposez pas d'un tel compte, vous devez obtenir le fichier ZIP auprès de l'administrateur de la base de données, ainsi que le mot de passe qui protège le fichier ZIP.

    1. Dans votre navigateur Web, connectez-vous à Oracle Cloud et accédez à la page Détails de l'instance Autonomous Database.

    2. Cliquez sur Connexion à une base de données.

    3. Sur la page Connexion à la base de données, cliquez sur Télécharger.

    4. Dans la boîte de dialogue Download Wallet, entrez un mot de passe de portefeuille dans le champ Password et confirmez-le dans le champ Confirm Password.

      Le mot de passe doit comporter au minimum 8 caractères, dont au moins 1 lettre et 1 caractère numérique ou caractère spécial.

    5. Cliquez sur Télécharger pour enregistrer le fichier ZIP d'informations d'identification client dans un répertoire sécurisé.

  2. Après avoir téléchargé le fichier ZIP, procédez comme suit :

    1. Décompressez le fichier ZIP d'informations d'identification client.

    2. Modifiez le fichier sqlnet.ora fourni dans les informations d'identification client en remplaçant "?/network/admin" par le chemin complet du répertoire dans lequel vous avez décompressé les informations d'identification client. Par exemple, remplacez : 

      (DIRECTORY="?/network/admin")

      par :

      (DIRECTORY="/users/jdoe/adbcredentials")

    3. Créez la variable d'environnement TNS_ADMIN, en définissant sa valeur sur le chemin complet du répertoire dans lequel vous avez décompressé les informations d'identification client.

Codage des connexions de base de données et des instructions SQL

Après avoir configuré votre système de développement de manière à ce qu'il prenne en charge la connectivité des applications PHP à une instance Autonomous Database, suivez les instructions ci-après pour obtenir des performances élevées et une disponibilité continue des connexions de votre application à la base de données :

Pour PHP, vous activez la fonction FAN lorsque vous ajoutez la ligne oci8.events = On au fichier php.ini dans le cadre du téléchargement et de l'installation de l'extension Oracle OCI8 sur PHP.

L'interface OCI8 n'expose pas les appels spécifiques de regroupement de connexions en pool. En lieu et place, elle utilise le regroupement de connexions en pool en interne. Afin de tirer parti des avantages des pools de connexions, utilisez la fonction oci_pconnect() pour créer ou réutiliser une connexion persistante entre les demandes HTTP.

Exemple :

$connection = oci_pconnect("appuser", getenv("MY_PASSWORD_ENV_VAR"), "tp_tls");

Cet exemple crée une connexion persistante au service de base de données tp_tls.

Ressources supplémentaires

Pour plus d'informations sur l'extension Oracle OCI8 pour PHP, reportez-vous à la page Oracle OCI8.

Pour plus d'informations sur l'utilisation de PHP avec Oracle Database, reportez-vous au manuel spécial PHP et Oracle.