Exécuter plusieurs instances d'Apache et migrer de PHP 4 à PHP 5

I-A. Remerciements▲

I-B. Préambule▲

Nous devons tout d'abord compiler PHP 4 et PHP 5 de manière à ce que les chemins et noms de fichiers ne soient pas en conflit. Je ne vais pas entrer dans les détails, mais il faudra ajouter ceci pour PHP 5 :

./configure
'--libdir=/usr/lib/php5' \
'--includedir=/usr/include/php5' \
'--program-suffix=5' \
'--with-exec-dir=/usr/lib/php5/libexec' \
'--with-config-file-path=/etc/php5/'

Puisque toutes les instances auront plus ou moins la même configuration, nous allons inclure apache2.conf pour la configuration commune et utiliser une macro pour les différences. Si vous n'avez pas encore installé mod_macro, veuillez l'installer et l'activer :

apt-get install libapache2-mod-macro
a2enmod macro

Nous devons spécifier l'adresse IP par instance, il faut donc supprimer le contenu de /etc/apache2/ports.conf. Supprimez également les liens symboliques de tous les modules qui ne devraient pas être chargés dans toutes les instances (comme php5_module) du fichier /etc/apache2/mods-enabled.

Créez un fichier /etc/apache2/apache2-instance.macro et saisissez votre configuration par instance, par exemple :

<Macro SetupInstance $instance $ip>
LockFile /var/lock/apache2/$instance.accept.lock
PidFile /var/run/apache2/$instance.pid
ErrorLog /var/log/apache2/$instance/error.log
Listen $ip:80
</Macro>

Créez ensuite :

Include /etc/apache2/apache2.conf
Include /etc/apache2/apache2-instance.macro
Use SetupInstance "apache2-php4" "192.168.1.50"

LoadModule php4_module /usr/lib/apache2/modules/libphp4.so
<IfModule mod_php4.c>
AddType application/x-httpd-php .php .phtml .php3
AddType application/x-httpd-php-source .phps
</IfModule>

Faites de même pour apache2-php5.conf. N'oubliez pas de créer également /var/log/apache2/apache2-php4 ainsi que /var/log/apache2/apache2-php5.

Lorsque vous exécutez « apache2ctl start », le script affiche no listening sockets available, shutting down et se termine. C'est normal, bien que nous ayons besoin de démarrer Apache. Nous allons donc modifier le script.

Copiez /usr/sbin/apache2ctl vers /usr/sbin/apache2-php4ctl et /usr/sbin/apache2-php5ctl. Éditez apache2-php4ctl pour changer « HTTPD » à :

HTTPD='/usr/sbin/apache2 -f /etc/apache2/apache2-php4/apache2.conf'

Faites de même pour apache2-php5.

Un autre script a besoin d'être modifié, il est situé dans /etc/init.d : copiez /etc/init.d/apache2 vers /etc/init.d/apache2-php4 et /etc/init.d/apache2-php5 puis déplacez le fichier vers /etc/init.d/apache2.org et modifiez alors /etc/init.d/apache2-php4 :

APACHE2CTL="$ENV /usr/sbin/apache2-php4ctl"

Le script essaie de trouver le PID en cherchant le nom du fichier PID dans la configuration, mais cela ne fonctionnera pas puisque nous utilisons une macro. Ainsi, utilisez ce code :

PIDFILE='/var/run/apache2/apache2-php4.pid'
if [ -e "$PIDFILE" ] ; then
PID=`cat "$PIDFILE"`
fi

Mettez tout en commentaires depuis « for i in $AP_CONF » jusqu'à « done ». Appliquez les mêmes modifications à /etc/init.d/apache2-php5.

Enfin, créez un nouveau script /etc/init.d/apache2 (attention aux permissions) avec le contenu suivant :

#!/bin/sh
./apache2-php4 $@
./apache2-php5 $@

Si vous avez une entreprise d'hébergement Web et que vous avez toujours PHP 4, vous sentez probablement monter la pression. Des articles tels que « Now showing: PHP's true colors » vous enjoignent à basculer et à encaisser le coup, mais ils ne vous donnent pas un seul conseil sur la manière de procéder.

Le problème est que vous pouvez informer vos clients que vous migrez vers PHP 5, mais si vous ne pouvez pas leur fournir une plate forme de test, comment pourront-ils savoir si la migration va casser leurs sites ?

Il y a quelques mois, j'ai posté un article sur comment exécuter plusieurs instances d'Apache avec différentes versions de PHP [NDT : traduit plus haut dans cette page]. Dans cet article, j'ai montré comment créer diverses configurations exécutant Apache sur différentes adresses IP. En utilisant différents ports plutôt que différentes adresses IP, nous pouvons donner un moyen à nos clients de vérifier leurs sites avant de mettre en production.

Si vous n'avez pas lu l'article, commencez par là [NDT Lisez le début de ce tutoriel]. Lors de l'étape « Préparer des fichiers additionnels de configuration » cependant, vous devrez le faire légèrement différemment. Suivez l'article complet, mais à cette étape faites ceci (sans utiliser mod_macro) :

Retirez PHP4 de mods_enabled ainsi que la directive « Listen » du fichier apache.conf. Créez ensuite :

Include /etc/apache2/apache2.conf
Listen 192.168.1.50:80

LoadModule php4_module /usr/lib/apache2/modules/libphp4.so
<IfModule mod_php4.c>
  AddType application/x-httpd-php .php .phtml .php3
  AddType application/x-httpd-php-source .phps
</IfModule>

Include /etc/apache2/apache2.conf

LockFile /var/lock/apache2/apache2-php5.accept.lock
PidFile /var/run/apache2-php5.pid
ErrorLog /var/log/apache2/error-php5.log
Listen 192.168.1.50:8800

LoadModule php5_module /usr/lib/apache2/modules/libphp5.so
<IfModule mod_php5.c>
  AddType application/x-httpd-php .php .phtml .php3
  AddType application/x-httpd-php-source .phps
</IfModule>

Dans cet exemple, remplacez « 192.168.1.50 » par votre propre adresse IP. Redémarrez Apache et il lancera deux instances, l'une avec PHP 4 sur le port 80 et l'autre avec PHP 5 sur le port 8800. Vous pouvez maintenant envoyer un message à tous vos clients en leur annonçant que vous migrerez vers PHP 5 sous un certain nombre de semaines et qu'ils devraient vérifier que leur site n'est pas sujet à des problèmes en se rendant à l'adresse http://www.example.com:8800/, où example.com doit être remplacé par leur propre nom de domaine.

VI-A. Épilogue▲

VI-B. Liens▲