20. L’API Apache

Apache offre une interface de programmation (API) aux modules afin de les isoler des mécanismes du protocole HTTP et les rendre indépendants les uns des autres. Dans ce chapitre, nous explorerons les concepts essentiels de cette API et nous fournirons une liste détaillée des fonctions disponibles pour les auteurs de modules.

Dans les éditions précédentes, nous décrivions l’API d’Apache 1.x. Comme vous le savez, les choses ont évolué depuis et Apache 2.x est arrivé. Les fonctionnalités de la version 2.x incluent des améliorations radicales et très intéressantes par rapport à l’API 1.x ; de plus, le développement de 1.x est arrêté, sauf pour la maintenance. Nous avons donc décidé que, à la différence du reste de ce livre, nous ne présenterions que la nouvelle API (l’annexe présente un peu l’API 1.x).

Dans les éditions précédentes, nous avions également une section faisant office de référence pour l’API. Comme Apache 2.0 a, de son côté, beaucoup amélioré la documentation de cette API, et comme celle-ci évolue encore à l’heure où nous écrivons, nous avons décidé de nous concentrer sur les concepts et les exemples et de vous renvoyer au Web pour les références. Une partie du travail de ce chapitre a consisté à vérifier que la documentation en ligne présentait bien toutes les API importantes.

Dans ce chapitre, nous présenterons les concepts importants, qui sont nécessaires pour comprendre l’API et nous vous dirigerons vers la documentation appropriée. Au chapitre suivant, nous illustrerons l’utilisation de cette API par plusieurs exemples de modules.