ap_hook_handler

Prototypes


int ap_hook_handler(int (*TraiterRequete)(request_rec *RequeteApache), const char *Inutile1, const char **Inutile2, int Priorite);

Description

Déclare une fonction de rappel du frontal Apache vers le module pour traiter les requêtes Http.

Le paramètre TraiterRequete est la fonction de rappel. Son paramètre RequeteApache est le descripteur de la requête Apache. Son code retour est soit :

DECLINED.
La demande n'est pas gérée par le module.
OK.
La demande est correctement gérée par le module.
Un code retour Http.
Par example HTTP_OK.

Le paramètre Priorite est le code de priorité d'usage de cette fonction de rappel par Apache. Les valeurs possibles sont :

APR_HOOK_REALLY_FIRST.
Le plus prioritaire.
APR_HOOK_FIRST.
Priorité au dessus la normale.
APR_HOOK_MIDDLE.
Priorité par défaut.
APR_HOOK_LAST.
Priorité au dessous de la normale.
APR_HOOK_LAST.
Le moins prioritaire.

Les principaux champs RequeteApache sont les suivants :

clength.
Entier définissant la taille du contenu.
content_encoding.
Chaîne de caractères définissant l'encodage du contenu.
content_type.
Chaîne de caractères définissant le type du contenu.
handler.
Chaîne de caractères définissant le module cible.
headers_in.
Table des propriétés de l'en-tête de la question.
headers_out.
Table des propriétés de l'en-tête de la réponse.
method_number.
Codification de la méthode invoquée.
proxy_req.
Si Vrai, le client ne veut que l'en-tête du contenu en guise de réponse.
remote_addr.
Descripteur de la soquette du client.
server.
Descripteur du serveur de ressources.
unparsed_uri.
Uniform Resource Identifier (URI) de la question.
user.
Chaîne de caractères définissant le nom de l'utilisateur de connexion.

Exemple


#include <httpd.h>

#include <http_config.h>

#include <http_log.h>

#include <http_protocol.h>

#include <http_request.h>

#include <http_core.h>

#include <ap_compat.h>



...

static void TraiterDemarrer(apr_pool_t *PouleFils, server_rec *ServeurApache)

/***************************************************************************/

{

...

}



static int TraiterConnecter(request_rec *RequeteApache)

/*****************************************************/

{

...

return(OK);

}



static int TraiterRequete(request_rec *RequeteApache)

/***************************************************/

{

...

return(OK);

}



static void EnregistrerRappels(apr_pool_t *Poule)

/***********************************************/

{

...

if (ap_hook_child_init(TraiterDemarrer,NULL,NULL,APR_HOOK_MIDDLE)!=APR_SUCCESS)

   {

   ...

   }

if (ap_hook_check_user_id(TraiterConnecter,NULL,NULL,APR_HOOK_MIDDLE)!=APR_SUCCESS)

   {

   ...

   }

if (ap_hook_handler(TraiterRequete,NULL,NULL,APR_HOOK_MIDDLE)!=APR_SUCCESS)

   {

   ...

   }

...

}



#if defined(__cplusplus)

extern "C"
{

#endif

module AP_MODULE_DECLARE_DATA MonModule={STANDARD20_MODULE_STUFF,NULL,NULL,NULL,NULL,NULL,EnregistrerRappels};

#if defined(__cplusplus)

}

#endif

Voir aussi

ap_hook_check_user_id pour déclarer la méthode de rappel de connexion. ap_hook_child_init pour déclarer la méthode de rappel de démarrage.