Installation et configuration PHP

Suivez cette procédure pour configurer PHP afin de l'utiliser avec la console de gestion.

Avant de commencer

Exigences :

Pourquoi et quand exécuter cette tâche

Suivez les instructions de cette section pour configurer PHP pour le serveur Apache HTTP ou un autre serveur Web. Les instructions supposent que que vous avez déjà téléchargé la version requise de PHP.

Installation de PHP

Pourquoi et quand exécuter cette tâche

Cette section décrit comment compiler et installer PHP à partir de la source. Si vous disposez d'une installation existante de PHP et ne souhaitez pas la recompiler, vous devez déterminer si les pilotes de base de données appropriés sont installés. Si vous devez installer un pilote de base de données, consultez la documentation PHP relative à la méthode d'installation à utiliser. Installez le pilote de la base de données à utiliser avec Build Forge, comme suit :
  • DB2 : pilote ibm_db2
  • MySQL : pilote mysqli
  • Oracle Instant Client : pilote oci8
Remarque : Actuellement, le client complet Oracle n'est pas compatible avec PHP oci8. Utilisez uniquement Oracle Instant Client.

Procédure

  1. Configurez PHP pour l'installation dans le répertoire de travail que vous venez de créer.
    $ ./configure --prefix=/usr/local/php-5.2.4 --with-<base de données>=shared \
    --with-apxs2 --with-ldap=shared --enable-mbstring --enable-shmop \
    --with-xml --with-zlib=shared
    Remplacez --with-<base de données> comme suit :
    • DB2 : --with-ibm_db2[=rép]. Si =rép n'est pas spécifié, la valeur par défaut est utilisée :/home/db2inst1/sqllib
    • MySQL : --with-mysqli[=fichier]. Le paramètre de fichier facultatif est un chemin d'accès à mysql_config.
    • Microsoft SQL Server : --with-mssql[=rép]
    • Oracle : Vous devez installer une installation distincte d'Oracle Instant Client pour utiliser PHP oci8. Lors de l'utilisation d'Oracle Instant Client pour vous connecter à la base de données, utilisez --with-oci8=instantclient,bib bib est le chemin d'accès au répertoire de la bibliothèque Instant Client.

    Notez le caractère de continuation de ligne \ dans le bloc de code. Cette étape détermine l'emplacement et les options de l'installation de PHP. PHP est installé dans le répertoire /usr/local par défaut. L'exemple montre comment le déplacer dans /usr/local/php-5.2.4. Cet emplacement est utilisé dans des exemples ultérieurs.

  2. Compilez PHP.
    $ make

    Cette étape compile des fichiers exécutables dans votre répertoire local.

  3. Installez PHP (en tant qu'utilisateur root).
    # make install
    Vous devez effectuer cette étape en tant qu'utilisateur disposant de privilèges sur le répertoire dans lequel est installé Apache (/usr/local/apache-2.2.4 dans cet exemple). En règle générale, l'étape est effectuée en tant qu'utilisateur root. Votre configuration administrative locale peut différer.

Configuration de PHP

Procédure

  1. Copiez les fichiers d'extension dans le répertoire d'extension. Les fichiers d'extension pour la base de données doivent être copiés à partir du référentiel vers le répertoire d'extensions actives. L'exemple suivant suppose que PHP est installé dans /usr/local/php-5.2.4. Notez que <dateur> est une chaîne de nombres.
    $ cd /usr/local/php-5.2.4/lib/php/extensions/no-debug-non-zts-<dateur>/
    $ cp <extensions-bd> ..
    Les fichiers <extensions-bd> correspondent à votre base de données pour Build Forge, comme suit :
    • DB2 : ibm_db2.so
    • MySQL : mysql.so et mysqli.so
    • Oracle : oci8.so
  2. Modifiez le fichier de configuration PHP php.ini. L'exemple suivant suppose que PHP est installé dans /usr/local/php-5.2.4 :
    $ cd /usr/local/php-5.2.4/lib/
    $ vi php.ini
    Ajoutez les entrées suivantes :
    extension_dir=/usr/local/php-5.2.4/lib/php/extensions
    upload_tmp_dir=<répertoire>
    extension=<extension-bd-so>
    Utilisez le nom de fichier <extensions-bd-so> (ou les noms de fichier) associés à votre base de données, comme suit :
    • DB2 : extension=ibm_db2.so
    • MySQL : deux entrées -
      extension=mysql.so
      extension=mysqli.so
    • Oracle : extension=oci8.so
    Remarque : Le répertoire utilisé pour upload_tmp_dir doit être inscriptible par l'utilisateur associé au serveur Web Apache. Cet utilisateur est généralement nobody, mais vos pratiques administratives locales peuvent différer.

Edition du fichier de configuration Apache

Procédure

Modifiez le fichier de configuration Apache. Ajoutez les informations sur PHP dans httpd.conf.
cd <rép-apache>
vi httpd.conf
Ajoutez les lignes suivantes :
LoadModule php5_module modules/libphp5.so
AddHandler php5-script .php
AddType text/html .php
DirectoryIndex index.php

Identification du serveur proxy

Pourquoi et quand exécuter cette tâche

(Facultatif) Cette étape est nécessaire uniquement si la console de gestion doit utiliser un serveur proxy pour accéder à sa base de données.

Procédure

Modifiez le fichier de configuration PHP php.ini. Il se trouve dans <install-php>/lib,, par exemple /usr/local/php-5.2.4.

Ajoutez les entrées suivantes :

bf_proxyHost=<nomhôte_serveur_proxy>
bf_proxyPath=<votre_chemin_proxy>
bf_symlinkPath=<=liensym_vers_chemin_proxy>

Commentaires en retour