Serveur Apache HTTP Version 2.4

Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

# Module Apache mod_dbd

Description: | Gestion des connexions à une base de données SQL
Statut: | Extension
Identificateur de Module: | dbd_module
Fichier Source: | mod_dbd.c
Compatibilité: | Versions 2.1 and supérieures

### Sommaire

Le module `mod_dbd` gère les connexions à une base de données SQL via APR. Il permet aux modules qui requièrent des fonctions liées aux bases de données SQL de se connecter à une base de données à la demande, et s'efforce de conférer aux bases de données une efficacité et une évolutivité optimales pour les MPMs threadés ou non threadés. Pour plus de détails, voir le site web APR, ainsi que cette vue d'ensemble de l'environnement de développement d'Apache DBD par son développeur initial.

### Sujets

- Regroupement des connexions
- Connexion
- API DBD d'Apache
- Requêtes SQL préparées
- AVERTISSEMENT DE SECURITE

### Directives

### Traitement des bugs

- Journal des modifications de httpd
- Problèmes connus
- Signaler un bug

### Voir aussi

- Formats des mots de passe

## Regroupement des connexions

Ce module gère de manière optimisée en fonction de la plate-forme les connexions aux bases de données. Sur les plates-formes non threadées, il maintient une connexion persistente à la manière d'un LAMP classique (Linux, Apache, Mysql, Perl/PHP/Python). Sur les plates-formes threadées, il maintient un groupe de connexions à la fois plus évolutif et plus efficace, comme décrit dans cet article d'ApacheTutor. Notez que `mod_dbd` remplace les modules présentés dans cet article.

## Connexion

Pour vous connecter à votre base de données, vous devez spécifier un pilote et des paramètres de connexion qui diffèrent selon le moteur de base de données. Par exemple, pour vous connecter à mysql, spécifiez ce qui suit :

    DBDriver mysql
    DBDParams host=localhost,dbname=pony,user=shetland,pass=appaloosa

Vous pourrez alors utiliser cette connexion dans de nombreux autres modules comme `mod_rewrite`, `mod_authn_dbd` et `mod_lua`. Vous trouverez des exemples d'utilisation dans la documentation de ces modules.

Voir la syntaxe de la directive `DBDParams` pour les informations à fournir dans la chaîne de connexion en fonction des différents pilotes de base de données supportés.

## API DBD d'Apache

`mod_dbd` exporte cinq fonctions que d'autres modules pourront utiliser. L'API se présente comme suit :

    typedef struct {
        apr_dbd_t *handle;
        apr_dbd_driver_t *driver;
        apr_hash_t *prepared;
    } ap_dbd_t;

    /* Fonctions exportées pour accéder à la base de données */

    /* ouvre une connexion qui DOIT avoir été explicitement fermée.
     * Renvoie NULL en cas d'erreur
     */
    AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*);

    /* ferme une connexion ouverte avec ap_dbd_open */
    AP_DECLARE(void) ap_dbd_close(server_rec*, ap_dbd_t*);

    /* acquiert une connexion qui aura la durée de vie de la requête et qui
     * NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
     * d'erreur. C'est la fonction recommandée pour la plupart des
     * applications.
     */
    AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*);

    /* acquiert une connexion qui aura la durée de vie d'une connexion et
     * qui NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
     * d'erreur.
     */
    AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*);

    /* Prépare une requête qu'un module client pourra utiliser */
    AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*);

    /* Exporte aussi ces fonctions à titre optionnel mour les modules qui
     * péfèreraient les utiliser */
    APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_open, (apr_pool_t*, server_rec*));
    APR_DECLARE_OPTIONAL_FN(void, ap_dbd_close, (server_rec*, ap_dbd_t*));
    APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_acquire, (request_rec*));
    APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_cacquire, (conn_rec*));
    APR_DECLARE_OPTIONAL_FN(void, ap_dbd_prepare, (server_rec*, const char*, const char*));

## Requêtes SQL préparées

`mod_dbd` supporte les requêtes SQL préparées à destination des modules qui pourraient les utiliser. Chaque requête préparée doit posséder un nom (étiquette), et est stockée dans un condensé (hash) : les condensés sont du type `apr_dbd_prepared_t` et s'utilisent dans toute requête SQL ou commande select préparée par apr_dbd.

Il est du ressort des modules utilisateurs de dbd d'utiliser les requêtes préparées et de préciser quelles requêtes doivent être spécifiées dans httpd.conf, ou de fournir leurs propres directives et d'utiliser `ap_dbd_prepare`.

### Avertissement

Lorsqu'on utilise des requêtes préparées avec des bases de données MySQL, il est préférable de définir `reconnect` à 0 dans la chaîne de connexion, afin d'éviter des erreurs provoquées par un client MySQL qui se reconnecterait sans réinitialiser correctement les requêtes préparées. Si `reconnect` est défini à 1, toute connexion défectueuse sera sensée être réparée, mais comme mod_dbd n'en est pas informé, les requêtes préparées seront invalidées.

## AVERTISSEMENT DE SECURITE

Toute application web impliquant une base de données doit se protéger elle-même contre les attaques de type injection SQL. Dans la plupart des cas Apache DBD est sûr, car les applications utilisent des requêtes préparées, et les entrées non sures ne seront utilisées qu'à titre de données. Bien entendu, si vous l'utilisez via un module tiers, vous devez être au fait des précautions à prendre.

Cependant, le pilote FreeTDS est non sûr de par sa nature-même. Comme la bibliothèque sous-jacente ne supporte pas les requêtes préparées, le pilote en effectue une émulation, et les entrées non sûres sont fusionnées avec la requête SQL.

Il peut être sécurisé en décontaminant toutes les entrées : un processus inspiré de la recherche de contaminations (taint mode) de Perl. Chaque entrée est comparée à une expression rationnelle, et seules les entrées qui correspondent sont utilisées, en accord avec le langage Perl :

      $untrusted =~ /([a-z]+)/;
      $trusted = $1;

Pour utiliser ceci, les expressions rationnelles de décontamination doivent être incluses dans les requêtes préparées. L'expression rationnelle doit se situer immédiatement après le caractère % dans la requête préparée, et doit être entourée d'accolades {}. Par exemple, si votre application attend une entrée alphanumérique, vous pouvez utiliser :

``"SELECT foo FROM bar WHERE input = %s"``

avec d'autres pilotes, et ne risquer au pire qu'une requête échouée. Mais avec FreeTDS, vous devez utiliser :

``"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"``

tout ce qui ne correspond pas à l'expression rationnelle est alors rejeté, et la requête est maintenant sûre.

Alternativement, vous pouvez utiliser le pilote ODBC tiers, qui offre la sécurité des requêtes préparées authentiques.

## Directive DBDExptime

Description: | Durée de vie des connexions inactives
Syntaxe: | `DBDExptime durée en secondes`
Défaut: | `DBDExptime 300`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Cette directive permet de définir la durée de vie des connexions inactives lorsque le nombre de connexions spécifié par la directive DBDKeep a été dépassé (plates-formes threadées uniquement).

## Directive DBDInitSQL

Description: | Exécute une instruction SQL après connexion à une base de données
Syntaxe: | `DBDInitSQL "instruction SQL"`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Les modules qui le souhaitent peuvent exécuter une ou plusieurs instructions SQL après connexion à une base de données. Par exemple initialiser certaines valeurs, ou ajouter une entrée dans le journal lors d'une nouvelle connexion à la base de données.

## Directive DBDKeep

Description: | Nombre maximum de connexions maintenues
Syntaxe: | `DBDKeep nombre`
Défaut: | `DBDKeep 2`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Cette directive permet de définir le nombre maximum de connexions à maintenir par processus, en dehors de celles servant à gérer les pics de demandes (plates-formes threadées uniquement).

## Directive DBDMax

Description: | Nombre maximum de connexions
Syntaxe: | `DBDMax nombre`
Défaut: | `DBDMax 10`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Cette directive permet de définir le nombre maximum effectif de connexions par processus (plates-formes threadées uniquement).

## Directive DBDMin

Description: | Nombre minimum de connexions
Syntaxe: | `DBDMin nombre`
Défaut: | `DBDMin 1`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Cette directive permet de définir le nombre minimum de connexions par processus (plates-formes threadées uniquement).

## Directive DBDParams

Description: | Paramètres de la connexion à la base de données
Syntaxe: | `DBDParams param1=valeur1[,param2=valeur2]`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Cette directive permet de spécifier des paramètres selon les besoins du pilote concerné. En général, les paramètres à passer concernent tout ce qui n'a pas de valeur par défaut comme le nom d'utilisateur, le mot de passe, le nom de la base de données, le nom d'hôte et le numéro de port de la connexion.

Les paramètres de la chaîne de connexion en fonction des différents pilotes comprennent :

FreeTDS (pour MSSQL et SyBase)
  username, password, appname, dbname, host, charset, lang, server
MySQL
  host, port, user, pass, dbname, sock, flags, fldsz, group, reconnect
Oracle
  user, pass, dbname, server
PostgreSQL
  La chaîne de connexion est passée directement à `PQconnectdb`
SQLite2
  La chaîne de connexion est scindée avec comme séparateur le caractère ':', et `partie1:partie2` est utilisé dans `sqlite_open(partie1, atoi(partie2), NULL)`
SQLite3
  La chaîne de connexion est passée directement à `sqlite3_open`
ODBC
  datasource, user, password, connect, ctimeout, stimeout, access, txmode, bufsize

## Directive DBDPersist

Description: | Utiliser ou non des connexions persistentes
Syntaxe: | `DBDPersist On|Off`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Si cette directive est définie à Off, les connexions persistentes et les connexions groupées sont désactivées. À la demande d'un client, une nouvelle connexion à la base de données est ouverte, et fermée immédiatement à l'issue du traitement. Cette configuration ne doit être utilisée qu'à des fins de débogage, ou sur des serveurs à charge faible.

Par défaut, les groupes de connexions persistentes sont activés (ou une seule connexion persistente du style LAMP pour les serveurs non threadés), et c'est la configuration qui devrait être utilisée dans la plupart des cas sur un serveur en production.

Avant la version 2.2.2, cette directive n'acceptait que les valeurs `0` et `1` au lieu de `Off` et `On`, respectivement.

## Directive DBDPrepareSQL

Description: | Définit une requête SQL préparée
Syntaxe: | `DBDPrepareSQL "requête SQL" étiquette`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Pour les modules tels que les modules d'authentification, qui utilisent de manière répétée la même requête SQL, on peut optimiser les performances en préparant la requête une fois pour toutes au démarrage, plutôt qu'à chaque utilisation. Cette directive permet de préparer une requête SQL et de lui assigner une étiquette.

## Directive DBDriver

Description: | Spécifie un pilote SQL
Syntaxe: | `DBDriver nom`
Contexte: | configuration du serveur, serveur virtuel
Statut: | Extension
Module: | mod_dbd

Cette directive permet de spécifier un pilote apr_dbd par son nom. Le pilote doit être installé sur votre système (sur la plupart des systèmes, il s'agit d'un objet partagé ou d'une dll). Par exemple, `DBDriver mysql` va sélectionner le pilote MySQL dans la bibliothèque apr_dbd_mysql.so.