Discussion :

[kakibend]

Bonjour,

J'ai créé un module sous apache 2.2.6 qui, entre autres, interroge un serveur externe hébergeant un annuaire ldap. A l'heure actuelle l'adresse ip du serveur et le numéro de port sont codés en dur sur le module.

J'aimerai pouvoir créé des directives dans le fichier de configuration d'apache (httpd.conf) indiquant l'adresse ip et le numéro de port du serveur; ça sera sous la forme

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
 
<ifmodule mod_monModule>
url @serveur
port Numéro_de_port
<endifmodule>

Avez-vous une idée des fonctions à utiliser??

Merci beaucoup pour votre aide.

[julp]

Etudier les sources d'autres modules : vous fournissez une table correspondants à vos différentes directives dans la structure représentant votre module. Exemple :

Code C :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
module AP_MODULE_DECLARE_DATA ldap_module = {
   STANDARD20_MODULE_STUFF,
   NULL,                        /* create dir config */
   NULL,                        /* merge dir config */
   util_ldap_create_config,     /* create server config */
   util_ldap_merge_config,      /* merge server config */
   util_ldap_cmds,              /* command table */
   util_ldap_register_hooks,    /* set up request processing hooks */
};

Et cette table des directives se présente ainsi :

Code C :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
static const command_rec util_ldap_cmds[] = {
    AP_INIT_TAKE1("LDAPSharedCacheSize", util_ldap_set_cache_bytes,
                  NULL, RSRC_CONF,
                  "Set the size of the shared memory cache (in bytes). Use "
                  "0 to disable the shared memory cache. (default: 100000)"),

    /* ... */

    AP_INIT_TAKE1("LDAPConnectionTimeout", util_ldap_set_connection_timeout,
                  NULL, RSRC_CONF,
                  "Specify the LDAP socket connection timeout in seconds "
                  "(default: 10)"),

    {NULL}
};

(Notez la valeur NULL à la fin)

Les paramètres de AP_INIT_TAKE1 (macro définissant une directive n'attendant qu'un seul et unique argument) sont :

• Le nom de la directive
• La fonction de callback à appeler lorsque la directive est rencontrée. Pour une directive attendant exactement un paramètre son prototype doit correspondre à :
  

  Code C :

  Sélectionner tout - Visualiser dans une fenêtre à part

  const char *(*take1) (cmd_parms *parms, void *mconfig, const char *w);

• Je crois qu'il s'agit d'un pointeur générique privé pour que vous puissiez fournir la configuration du module (la valeur NULL vous permettra d'omettre ce paramètre)
• Un masque décrivant où la directive peut être définie :
  

  Code C :

  Sélectionner tout - Visualiser dans une fenêtre à part

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  /**
   * @defgroup ConfigDirectives Allowed locations for configuration directives.
   *
   * The allowed locations for a configuration directive are the union of
   * those indicated by each set bit in the req_override mask.
   *
   * @{
   */
  #define OR_NONE 0             /**< *.conf is not available anywhere in this override */
  #define OR_LIMIT 1	     /**< *.conf inside <Directory> or <Location>
  				and .htaccess when AllowOverride Limit */
  #define OR_OPTIONS 2         /**< *.conf anywhere
                                  and .htaccess when AllowOverride Options */
  #define OR_FILEINFO 4        /**< *.conf anywhere
  				and .htaccess when AllowOverride FileInfo */
  #define OR_AUTHCFG 8         /**< *.conf inside <Directory> or <Location>
  				and .htaccess when AllowOverride AuthConfig */
  #define OR_INDEXES 16        /**< *.conf anywhere
  				and .htaccess when AllowOverride Indexes */
  #define OR_UNSET 32          /**< unset a directive (in Allow) */
  #define ACCESS_CONF 64       /**< *.conf inside <Directory> or <Location> */
  #define RSRC_CONF 128	     /**< *.conf outside <Directory> or <Location> */
  #define EXEC_ON_READ 256     /**< force directive to execute a command 
                  which would modify the configuration (like including another
                  file, or IFModule */
  /** this directive can be placed anywhere */
  #define OR_ALL (OR_LIMIT|OR_OPTIONS|OR_FILEINFO|OR_AUTHCFG|OR_INDEXES)

• Une description de la directive (à valeur de documentation)

Tout ceci est issu des sources d'une version 2.2

[kakibend]

Merci beaucoup pour cette réponse détaillée... j'avais commencé à lire le source d'un module mais j'avais rien compris..

je vais essayer de le faire , je vous tiendrai au courant!

Merci beaucoup encore une fois

[kakibend]

Bonjour,

Je suis arrivé à mettre en place une lecture de directives par contre je lis des caractères bizzares..."\xc0\x03\xdf\xb7\xc0\x03\xdf\xb7Pw\x18\bPw\x18\b" par exemple... une idée??

[julp]

Faut voir le code qui va avec et un exemple d'utilisation de ladite directive

[kakibend]

Oui c'est vrai que ce n'est pas évident de deviner comme ça, ça risque d'être un peu long...

voilà mon module va ,entre autres, effectuer une connexion vers un annuaire Ldap (openLdap) installé sur un serveur distant, c'est pour celà qe j'ai besoin de directives (@url, num_port...)

voilà ce que j'ai fait:

1- Déclaration de la structure incluants les différentes directrives dont j'aurai besoin:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
 
typedef struct mod_connexion_conf{
 apr_pool_t	*mpool;
/*URL de l'annuaire LDAP*/
 const char *url_LDAP;
/*Numéro de port de l'annuaire LDAP*/
 int num_port;
 
}mod_connexion_conf;

2- Je crée le tableau de directives:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
 
static const command_rec connexion_cmds[] = {
 
        AP_INIT_TAKE1("SERVEUR_LDAP", ap_set_string_slot,
                  (void*)APR_OFFSETOF(mod_connexion_conf, url_LDAP), OR_ALL,
                  "l'adresse url de l'annuaire LDAP"),
 
	AP_INIT_TAKE1("NUM_PORT_LDAP", ap_set_int_slot,
                  (void*)APR_OFFSETOF(mod_connexion_conf, num_port),  
                 OR_ALL, "l'adresse url de l'annuaire LDAP, par défault 389"),
 
    {NULL}
};

3- J'initialise la configuration

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
 
/*initialisation de la configuration */
static void *connexion_conf(apr_pool_t *pool, char *x)
{
	mod_connexion_conf *mod_connexion_conf_ptr;
	if (mod_auth_conf_ptr=apr_pcalloc(pool, sizeof(mod_connexion_conf))){
	mod_connexion_conf_ptr->mpool=pool;
 
	mod_connexion_conf_ptr->url_LDAP=NULL;
	mod_connexion_conf_ptr->num_port=1;
	return mod_connexion_conf_ptr;
	}
		else
	return NULL;
}

4- Dans une fonction interne au module je fais appel aux champs voulus de cette manière:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
 
 
mod_connexion_conf* mod_connexion_conf_ptr ;
/*....*/
ldap_init(mod_connexion_conf_ptr->url_LDAP, mod_connexion_conf_ptr->num_port )

(je ne sais pas si c'est de cette façon qu'on appelle les différents champs...)

5- je déclare le module

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
 
module AP_MODULE_DECLARE_DATA connexion_module = {
    STANDARD20_MODULE_STUFF,
    connexion_conf,
    NULL,
    NULL,
    NULL,
    connexion_cmds,/*table de directives apache*/
    connexion_hooks
};

6- Au niveau de httpd.conf je déclare mes directives de la façon suivante:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
 
<Location /connexion>
  SetHandler connexion
    SERVEUR_LDAP  10.112.25.8
  NUM_PORT_LDAP 389
 
</Location>

Voilà! Merci d'avoi été patient de me lire jusqu'ici!!

[kakibend]

Après une minutieuse rechrche j'ai trouvé la méthode..il me manquait des fonctions faisant le lien entre les directives et le module ; plus d'infos sur le lien:
http://threebit.net/tutorials/apache...tutorial2.html

Merci