Ecriture et compilation de modules dynamiques sous Windows
Pour écrire un module fonctionnant avec le serveur pour Windows
NT, vous devez installer le code source en même temps que le serveur lui-même.
Pour ce faire, sélectionnez "Installation personnalisée" et assurez-vous que
la case "Source Apache" est cochée.
Quelle est la source incluse dans l'installation ?
Lorsque vous installez le code source, un répertoire appelé src
est créé sous le répertoire racine du serveur. Ce répertoire
contient lui-même les sous-répertoires suivants :
- include - Contient la plupart des fichiers
d'en-tête ayant servi à créer la version binaire IBM de distribution du serveur
Web.
- os\win32 - Contient les éléments spécifiques
inclus dans la version de distribution du serveur Web pour Windows NT.
- CoreR - Contient le fichier ApacheCore.lib.
Il s'agit de la bibliothèque à laquelle vous devez vous lier pour
permettre à votre module de s'exécuter avec la version binaire de
distribution d'IBM HTTP Server.
- modules\example - Contient un module
exemple et un fichier projet qui montrent comment compiler un module. Le
fichier projet (.dsp) a été créé à l'aide de Microsoft Visual C++ 6.0 (c).
Vous trouverez également un répertoire apachesrc
à la racine du serveur. Il contient, sous forme de fichier .zip, le
code source Apache d'origine sur lequel est basé IBM HTTP Server.
Notez que ce code source ne permet pas de générer les fichiers binaires de la version
du produit distribuée par IBM. En effet, le code source de cette version
ne peut vous être fourni en raison de dispositions légales s'appliquant à
certaines technologies mises en oeuvre dans le produit final (SSL, notamment).
Comment compiler un module
Pour compiler un module destiné à s'exécuter avec IBM HTTP Server,
vous devez suivre la procédure ci-après.
- Ajoutez le répertoire src\include
à la liste des chemins d'inclusion.
- Etablissez un lien au fichier ApacheCore.lib
se trouvant dans le répertoire src\CoreR.
Lors de la compilation d'un module prévu pour s'exécuter avec
IBM HTTP Server, tenez compte des restrictions suivantes :
- Le fichier binaire ApacheCore.lib auquel vous vous liez doit être
celui qui a été placé dans le répertoire src\CoreR lors
de l'installation du serveur.
- Les fichiers d'en-tête à utiliser sont ceux qui ont été placés
dans les répertoires src\include et os\win32
lors de l'installation du serveur.
- Vous ne pouvez pas modifier ni ajouter de champs dans les
fichiers d'en-tête se trouvant dans les répertoires src\include et os\win32.