8.6 Utiliser des extensions

Suivant le processus de compilation que vous avez choisi, vous vous retrouvez avec un nouvel exécutable PHP lié à votre serveur web (sous forme de CGI), ou bien avec une librairie partagée, sous la forme d'un fichier .so. Si vous avez compilé le fichier d'exemple first_module.c comme objet partagé, le fichier résultant doit être nommé first_module.so . Piour l'utiliser, vous devez commencer par copier cette librairie dans un dossier accessible à PHP. Pour un simple test, vous pouvez copier le fichier dans le dossier htdocs et essayer PHP avec le script Un fichier test pour first_module.so. . Si vous avez compilé l'extension dans l'exécutable PHP, il faut enlever l'appel à la fonction dl , car les fonctionnalités du module sont déjà accessibles dans PHP.

Attention

Pour des raisons de sécurité, vous ne devez pas mettre vos modules dynamiques dans un dossier accessible à tous. Même si cela peut se faire et que cela vous simplifiera les tests, il est recommandé de les placer dans un dossier séparé, pour les environnements de production.

En exécutant ce script PHP dans votre navigateur web, vous devriez obtenir l'affichage suivant : Affichage résultant de first_module.php. .

Si nécessaire, les modules dynamiques peuvent être appelé dans le script avec la fonction dl . Cette fonction recherche la librairie partagée, la charge, et inclut les nouvelles fonctions dans PHP. Ici, le module exporte la fonction first_module , qui accepte un paramètre unique, le convertit en entier, et retourne le résultat de la conversion.

Si vous avez réussi à arriver aussi loin, félicitations! Vous avez réussi à compiler votre première extension.

Sommaire :

• Un fichier test pour first_module.so.
• Affichage résultant de first_module.php.