Créer une application PHP

Pour créer une application PHP qui accède à une base de données Autonomous Database, vous commencez par configurer votre système de développement pour prendre en charge l'accès à la base de données, qui peut tirer parti de la disponibilité continue et des fonctions haute performance d'Autonomous Database.

Après avoir configuré votre système de développement, vous codez les connexions à la base de données et les énoncés SQL dans votre application afin de tirer parti des fonctions de disponibilité continue et de haute performance.

Configurer votre système de développement PHP

Pour configurer votre système de développement afin que votre application PHP puisse tirer parti de la disponibilité continue et des fonctions de haute performance d'une base de données Autonomous Database, vous devez effectuer ces étapes.

  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 données d'identification du client pour la base de données et mettez-les à la disposition d'Oracle Instant Client.

Étapes préliminaires

Pour pouvoir être configuré, votre système de développement doit répondre à certains critères.

Télécharger et installer PHP

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

  • Oracle Linux :

    Exécutez ces commandes pour télécharger et installer PHP et télécharger et installer PEAR afin d'obtenir la commande de gestion d'ensembles 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 architectures et OSes :

    Allez à la page Installation et configuration de PHP et suivez les instructions correspondant au système d'exploitation et à l'architecture de votre système.

Télécharger et installer Oracle Instant Client

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

  • Oracle Linux :

    Exécutez ces commandes pour télécharger et installer l'ensemble de base Oracle Instant Client :

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

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

  • Autres architectures et OSes :

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

    2. Dans la page de téléchargement, acceptez le contrat de licence d'Oracle Technology Network, téléchargez les dernières versions de l'ensemble de base et de l'ensemble SDK, puis installez-les en suivant les instructions au bas de la page de téléchargement.

Télécharger et installer PHP OCI8

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

  • Oracle Linux :

    Exécutez ces commandes 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 le serveur Apache HTTP pour lire les nouvelles variables :

    sudo systemctl restart httpd
  • Autres architectures et OSes :

    1. Exécutez la commande suivante :

      pecl install oci8
    2. Ajoutez les lignes suivantes au fichier php.ini de l'installation de PHP :

      extension=oci8.so
      oci8.events = On

Télécharger et installer les données d'identification du client pour la base de données

  1. Téléchargez le fichier zip contenant les données d'identification du client pour votre base de données dans un répertoire sécurisé sur votre ordinateur.

    Ce fichier zip est disponible pour téléchargement à partir de la page Détails de la base de données dans la console Oracle Cloud. Si vous avez un compte d'utilisateur Oracle Cloud qui vous permet d'accéder à cette page, téléchargez les données 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, avec le mot de passe utilisé pour protéger le fichier zip.

    1. Dans votre navigateur Web, connectez-vous à Oracle Cloud et naviguez jusqu'à la page Détails pour Autonomous Database.

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

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

    4. Dans la boîte de dialogue Download Wallet (Télécharger le portefeuille), entrez un mot de passe dans le champ Password (Mot de passe) et confirmez le mot de passe dans le champ Confirmer le mot de passe.

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

    5. Cliquez sur Télécharger pour enregistrer le fichier zip des données d'identification du client dans un répertoire sécurisé.

  2. Après avoir téléchargé le fichier zip, procédez de la façon suivante :

    1. Décompressez le fichier zip de données d'identification du client.

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

      (DIRECTORY="?/network/admin")

      en :

      (DIRECTORY="/users/jdoe/adbcredentials")
    3. Créez la variable d'environnement TNS_ADMIN et réglez sa valeur au chemin complet du répertoire où vous avez décompressé les données d'identification du client.

Coder les connexions aux bases de données et les énoncés SQL

Après avoir configuré votre système de développement pour prendre en charge la connectivité d'application PHP à une base de données Autonomous Database, suivez ces directives pour obtenir une haute performance et une disponibilité continue des connexions de votre application à la base de données :

Pour PHP, vous activez l'avis rapide des applications lorsque vous ajoutez la ligne oci8.events = On au fichier php.ini lors du téléchargement et de l'installation de l'extension Oracle OCI8.

L'interface OCI8 n'affiche pas les appels de réserve de connexions spécifiques. Elle utilise la réserve de connexions en interne. Pour tirer parti des avantages de la réserve de connexions, utilisez la fonction oci_pconnect() pour créer ou réutiliser une connexion qui persiste entre les demandes HTTP.

Par 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, voir la page Oracle OCI8.

Pour plus d'informations sur l'utilisation de PHP avec Oracle Database, voir Le manuel PHP et Oracle.