![[APACHE DOCUMENTATION]](../images/sub.gif)
Ce module est implémenté dans le fichier modules/mod_example.c, et n'est pas compilé par défaut. Il illustre de nombreux aspects de l'API Apache 1.2 et, lorqu'il est activé, démontre la manière dont l'appel de chacun des modules est déclenché par le serveur.
Les fichiers situés dansle répertoire src/modules/example de la ditribution Apache sont fournis à titre d'exemples pour tous ceux qui souhaitent écrire des modules utilisant l'API Apache.
Le fichier principal est mod_example.c, qui illustre tous les mécanismes et syntaxes d'appel. En aucune manière un module additionnel ne nécessite l'inclusion des routines pour toutes les formes d'appel -
On chercherait plutôt la tendance contraire !
Le module d'exemple est un module réellemtn fonctionnel. Si vous l'installez dans votre serveur, associez le gestionnaire "example-handler" pour une portion d'espace particulière, puis naviguez à l'intérieur de cet espace, vouspourrez alors voir quelques exemples de traces d'appels successifs que le module exemple a enregistrées.
Pour inclure le module exemple dans votre serveur, suivez la procédure ci-dessous :
src/Configuration. Si cette ligne n'est pas déjà écrite, ajoutez-la ; ele devra apparaitre comme suit :
AddModule modules/example/mod_example.o
src/Configure
("cd src; ./Configure"). Ceci construira le fichier Makefile pour la compilation du serveur lui-même, et modifiera en conséquence le fichier src/modules/Makefile pour tout module additionnel que vous aurez demandé dans ce sous-répertoire.
src).
Pour ajouter un de vos modules personnels :
Pour activer le module d'exemple, incluez un bloc similaire à ce qui suit, dans votre fichier srm.conf :
<Location /example-info>
SetHandler example-handler
</Location>
Alternativement, vous pourriez mettre la clause suivante dans un fichier .htaccess puis requérir le fichier "test.example" là ou il est :
AddHandler example-handler .example
Après avoir rechargé/redémarré votre serveur, vous devriez être en mesure d'appeler le document d'exemple dans votre navigateur et apercevoir l'affichage évoqué ci-avant.
Syntaxe : Example
Défaut : Aucun
Contexte : configuration serveur, hôtes virtuels, répertoire, .htaccess
Surcharge : Options
Statut : Extension
Module : mod_example
Compatibilité : Example est disponible à partir de la version 1.2 d'Apache.
La directive Example active l'exemple de gestionnaire de contenu pour un sous-répertoire ou un type de fichier particulier. Elle n'accepte pas d'arguments. Si vous requérez une URL à laquelle ce gestionnaire de démonstration s'applique, vous verrez s'afficher quelles sont les routines appelées dans le module, comment et dans quel ordre elles sont appelées pour servir le document.
Version française © Valery Fremaux / EISTI 1998