Modules
Quasiment tout ce qui a été décrit dans ce chapitre a été illustré par un module implémentant un certain type de fonctionnalité. Comment les modules s’intègrent-ils à Apache ? En fait, presque tout le travail est fait dans le module lui-même, mais un petit extra doit être fait par l’extérieur. À part ça, il suffit d’ajouter une ligne dans le fichier config.m4 de son répertoire, qui sera incorporé dans le script configure. Les lignes pour les deux modules que nous avons illustrés sont :
APACHE_MODULE(optional_fn_import,
example optional function importer, , , no)
APACHE_MODULE(optional_fn_export, example optional function
exporter, , , no)
Les deux modules pourront alors être activés par les options --enable-optional-fn-export et --enable-optional-fn-import de configure. Bien sûr, le point important est que vous pouvez activer un seul, les deux, ou aucun de ces modules et qu’ils fonctionneront toujours correctement.
La liste complète des paramètres de APACHE_MODULE( ) est :
APACHE_MODULE(nom, texte_aide[, objets[, nom_struct[, défaut[, config]]]])
où :
nom
Le nom du module, qui correspond normalement au nom du fichier source (c’est-à-dire, mod_nom.c ).
texte_aide
Le texte affiché par configure lorsqu’il est lancé avec l’option --help.
objets
Si ce paramètre est présent, il remplace le fichier objet par défaut, mod_nom.o.
nom_struct
Par défaut, la structure de module s’appelle nom_module. Ce paramètre, s’il est présent, permet de le modifier.
défaut
Si ce paramètre est présent, il détermine quand le module sera inclus. S’il vaut yes, le module sera toujours inclus, sauf s’il est explicitement désactivé. S’il vaut no, le module ne sera jamais inclus, sauf s’il est explicitement activé. S’il vaut most, le module n’est pas activé, sauf si on a utilisé l’option --enable-most. En son absence, ou s’il vaut all, le module n’est activé que si l’option --enable-all est utilisée.