mirror of
https://github.com/apache/httpd.git
synced 2026-01-06 09:01:14 +03:00
[trunk][doc] Introducing .fr translation for mod/mod_dbd.xml
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1554386 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Vincent Deffontaines
@@ -3,3 +3,7 @@
|
||||
URI: mod_dbd.html.en
|
||||
Content-Language: en
|
||||
Content-type: text/html; charset=ISO-8859-1
|
||||
|
||||
URI: mod_dbd.html.fr
|
||||
Content-Language: fr
|
||||
Content-type: text/html; charset=ISO-8859-1
|
||||
|
||||
397
docs/manual/mod/mod_dbd.html.fr
Normal file
397
docs/manual/mod/mod_dbd.html.fr
Normal file
@@ -0,0 +1,397 @@
|
||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
|
||||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||||
This file is generated from xml source: DO NOT EDIT
|
||||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||||
-->
|
||||
<title>mod_dbd - Serveur Apache HTTP</title>
|
||||
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
|
||||
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
|
||||
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
|
||||
<script src="../style/scripts/prettify.js" type="text/javascript">
|
||||
</script>
|
||||
|
||||
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
|
||||
<body>
|
||||
<div id="page-header">
|
||||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
|
||||
<p class="apache">Serveur Apache HTTP Version 2.5</p>
|
||||
<img alt="" src="../images/feather.gif" /></div>
|
||||
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
|
||||
<div id="path">
|
||||
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
|
||||
<div id="page-content">
|
||||
<div id="preamble"><h1>Module Apache mod_dbd</h1>
|
||||
<div class="toplang">
|
||||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||||
<a href="../fr/mod/mod_dbd.html" title="Fran<61>ais"> fr </a></p>
|
||||
</div>
|
||||
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Gestion des connexions <20> une base de donn<6E>es SQL</td></tr>
|
||||
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur<75>de<64>Module:</a></th><td>dbd_module</td></tr>
|
||||
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_dbd.c</td></tr></table>
|
||||
<h3>Sommaire</h3>
|
||||
|
||||
<p>Le module <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> g<>re les connexions
|
||||
<20> une base de donn<6E>es SQL via <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. Il permet
|
||||
aux modules qui requi<75>rent des fonctions li<6C>es aux bases de donn<6E>es
|
||||
SQL de se connecter <20> une base de donn<6E>es <20> la demande, et s'efforce
|
||||
de conf<6E>rer aux bases de donn<6E>es une efficacit<69> et une
|
||||
<20>volutivit<69> optimales pour les MPMs thread<61>s ou non thread<61>s. Pour
|
||||
plus de d<>tails, voir le site web <a href="http://apr.apache.org/">APR</a>,
|
||||
ainsi que cette vue d'ensemble de l'<a href="http://people.apache.org/~niq/dbd.html">environnement de
|
||||
d<>veloppement d'Apache DBD</a> par son d<>veloppeur initial.
|
||||
</p>
|
||||
</div>
|
||||
<div id="quickview"><h3 class="directives">Directives</h3>
|
||||
<ul id="toc">
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdexptime">DBDExptime</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdinitsql">DBDInitSQL</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdkeep">DBDKeep</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdmax">DBDMax</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdmin">DBDMin</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdparams">DBDParams</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdpersist">DBDPersist</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdpreparesql">DBDPrepareSQL</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#dbdriver">DBDriver</a></li>
|
||||
</ul>
|
||||
<h3>Sujets</h3>
|
||||
<ul id="topics">
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#pooling">Regroupement des connexions</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#API">API DBD d'Apache</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#prepared">Requ<71>tes SQL pr<70>par<61>es</a></li>
|
||||
<li><img alt="" src="../images/down.gif" /> <a href="#security">AVERTISSEMENT DE SECURITE</a></li>
|
||||
</ul><h3>Voir aussi</h3>
|
||||
<ul class="seealso">
|
||||
<li><a href="../misc/password_encryptions.html">Formats des mots de
|
||||
passe</a></li>
|
||||
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="section">
|
||||
<h2><a name="pooling" id="pooling">Regroupement des connexions</a></h2>
|
||||
<p>Ce module g<>re de mani<6E>re optimis<69>e en fonction de la plate-forme
|
||||
les connexions aux bases de donn<6E>es. Sur les plates-formes non
|
||||
thread<61>es, il maintient une connexion persistente <20> la mani<6E>re d'un
|
||||
LAMP classique (Linux, Apache, Mysql, Perl/PHP/Python). Sur les
|
||||
plates-formes thread<61>es, il maintient un <em>groupe de
|
||||
connexions</em> <20> la fois plus <20>volutif et plus efficace, comme
|
||||
d<>crit dans <a href="http://www.apachetutor.org/dev/reslist">cet
|
||||
article d'ApacheTutor</a>. Notez que <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code>
|
||||
remplace les modules pr<70>sent<6E>s dans cet article.</p>
|
||||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="section">
|
||||
<h2><a name="API" id="API">API DBD d'Apache</a></h2>
|
||||
<p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> exporte cinq fonctions que d'autres
|
||||
modules pourront utiliser. L'API se pr<70>sente comme suit :</p>
|
||||
|
||||
<pre class="prettyprint lang-c">
|
||||
typedef struct {
|
||||
apr_dbd_t *handle;
|
||||
apr_dbd_driver_t *driver;
|
||||
apr_hash_t *prepared;
|
||||
} ap_dbd_t;
|
||||
|
||||
/* Fonctions export<72>es pour acc<63>der <20> la base de donn<6E>es */
|
||||
|
||||
/* ouvre une connexion qui DEVRA <20>tre explicitement ferm<72>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<75>e de vie de la requ<71>te et qui
|
||||
* NE DEVRA PAS <20>tre explicitement ferm<72>e. Renvoie NULL en cas
|
||||
* d'erreur. C'est la fonction recommand<6E>e pour la plupart des
|
||||
* applications.
|
||||
*/
|
||||
AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*);
|
||||
|
||||
/* acquiert une connexion qui aura la dur<75>e de vie d'une connexion et
|
||||
* qui NE DEVRA PAS <20>tre explicitement ferm<72>e. Renvoie NULL en cas
|
||||
* d'erreur.
|
||||
*/
|
||||
AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*);
|
||||
|
||||
/* Pr<50>pare une requ<71>te qu'un module client pourra utiliser */
|
||||
AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*);
|
||||
|
||||
/* Exporte aussi ces fonctions <20> titre optionnel mour les modules qui
|
||||
* p<>f<EFBFBD>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*));
|
||||
</pre>
|
||||
|
||||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="section">
|
||||
<h2><a name="prepared" id="prepared">Requ<71>tes SQL pr<70>par<61>es</a></h2>
|
||||
<p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> supporte les requ<71>tes SQL pr<70>par<61>es pour
|
||||
le compte des modules qui pourraient les utiliser. Chaque requ<71>te
|
||||
pr<70>par<61>e doit poss<73>der un nom (<28>tiquette), et est stock<63>e dans un
|
||||
condens<6E> (hash) : les condens<6E>s sont du type
|
||||
<code>apr_dbd_prepared_t</code> et s'utilisent dans toute requ<71>te
|
||||
SQL ou commande select pr<70>par<61>e par apr_dbd.</p>
|
||||
|
||||
<p>Il est du ressort des modules utilisateurs de dbd d'utiliser les
|
||||
requ<71>tes pr<70>par<61>es et de pr<70>ciser quelles requ<71>tes doivent <20>tre
|
||||
sp<73>cifi<66>es dans httpd.conf, ou de fournir leurs propres directives
|
||||
et d'utiliser <code>ap_dbd_prepare</code>.</p>
|
||||
|
||||
<div class="warning"><h3>Avertissement</h3>
|
||||
Lorsqu'on utilise des requ<71>tes pr<70>par<61>es avec des bases de
|
||||
donn<6E>es MySQL, il est pr<70>f<EFBFBD>rable de d<>finir
|
||||
<code>reconnect</code> <20> 0 dans la cha<68>ne de connexion, afin
|
||||
d'<27>viter des erreurs provoqu<71>es par un client MySQL qui se
|
||||
reconnecterait sans r<>initialiser correctement les requ<71>tes
|
||||
pr<70>par<61>es. Si <code>reconnect</code> est d<>fini <20> 1, toute
|
||||
connexion d<>fectueuse sera sens<6E>e <20>tre r<>par<61>e, mais comme
|
||||
mod_dbd n'en est pas inform<72>, les requ<71>tes pr<70>par<61>es seront
|
||||
invalid<69>es.
|
||||
</div>
|
||||
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="section">
|
||||
<h2><a name="security" id="security">AVERTISSEMENT DE SECURITE</a></h2>
|
||||
|
||||
<p>Toute application web impliquant une base de donn<6E>es doit se
|
||||
prot<6F>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<71>tes pr<70>par<61>es, et les entr<74>es non s<>res ne seront
|
||||
utilis<69>es qu'<27> titre de donn<6E>es. Bien entendu, si vous l'utilisez
|
||||
via un module tiers, vous devez <20>tre au fait des pr<70>cautions <20>
|
||||
prendre.</p>
|
||||
<p>Cependant, le pilote <var>FreeTDS</var> est <strong>non
|
||||
s<>r</strong> de par sa nature m<>me. Comme la biblioth<74>que
|
||||
sous-jacente ne supporte pas les requ<71>tes pr<70>par<61>es, le pilote en
|
||||
effectue une <20>mulation, et les entr<74>es non s<>res sont fusionn<6E>es
|
||||
avec la requ<71>te SQL.</p>
|
||||
<p>Il peut <20>tre s<>curis<69> en <em>d<>contaminant</em> toutes les
|
||||
entr<74>es : un processus inspir<69> de la recherche de contaminations de
|
||||
Perl (NdT : <code>taint checking</code>). Chaque entr<74>e est compar<61>e
|
||||
<20> une expression rationnelle, et
|
||||
seules les entr<74>es qui correspondent sont utilis<69>es, en accord avec
|
||||
le raccourci Perl :</p>
|
||||
<div class="example"><pre><code> $untrusted =~ /([a-z]+)/;
|
||||
$trusted = $1;</code></pre></div>
|
||||
<p>Pour utiliser ceci, les expressions rationnelles de
|
||||
d<>contamination doivent <20>tre incluses dans les requ<71>tes pr<70>par<61>es.
|
||||
L'expression rationnelle doit se situer imm<6D>diatement apr<70>s le
|
||||
caract<63>re % dans la requ<71>te pr<70>par<61>e, et doit <20>tre entour<75>e
|
||||
d'accolades {}. Par exemple, si votre application attend une entr<74>e
|
||||
alphanum<75>rique, vous pouvez utiliser :</p>
|
||||
<div class="example"><p><code>
|
||||
<code>"SELECT foo FROM bar WHERE input = %s"</code>
|
||||
</code></p></div>
|
||||
<p>avec d'autres pilotes, et ne risquer au pire qu'une requ<71>te
|
||||
en <20>chec. Mais avec FreeTDS, vous devez utiliser :</p>
|
||||
<div class="example"><p><code>
|
||||
<code>"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"</code>
|
||||
</code></p></div>
|
||||
<p>tout ce qui ne correspond pas <20> l'expression rationnelle est
|
||||
alors rejet<65>, et la requ<71>te est ainsi d<>sormais s<>re.</p>
|
||||
<p>Alternativement, vous pouvez utiliser le pilote ODBC tiers, qui
|
||||
offre la s<>curit<69> des requ<71>tes pr<70>par<61>es authentiques.</p>
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDExptime" id="DBDExptime">DBDExptime</a> <a name="dbdexptime" id="dbdexptime">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dur<75>e de vie des connexions inactives</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDExptime <var>dur<75>e en secondes</var></code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>DBDExptime 300</code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Cette directive d<>finit la dur<75>e de vie des connexions
|
||||
inactives lorsque le nombre de connexions sp<73>cifi<66> par la directive
|
||||
DBDKeep a <20>t<EFBFBD> d<>pass<73> (plates-formes thread<61>es seulement).</p>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDInitSQL" id="DBDInitSQL">DBDInitSQL</a> <a name="dbdinitsql" id="dbdinitsql">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ex<45>cute une instruction SQL apr<70>s connexion <20> une base de
|
||||
donn<EFBFBD>es</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDInitSQL <var>"instruction SQL"</var></code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Les modules qui le souhaitent peuvent ex<65>cuter une ou plusieurs
|
||||
instructions SQL apr<70>s connexion <20> une base de donn<6E>es. Par exemple
|
||||
initialiser certaines valeurs, ou ajouter une entr<74>e dans le journal
|
||||
lors d'une nouvelle connexion <20> la base de donn<6E>es.</p>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDKeep" id="DBDKeep">DBDKeep</a> <a name="dbdkeep" id="dbdkeep">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de connexions maintenues</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDKeep <var>nombre</var></code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>DBDKeep 2</code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Cette directive d<>finit le nombre maximum de connexions
|
||||
<20> maintenir par processus, en dehors de celles servant <20> g<>rer les
|
||||
pics de demandes (plates-formes thread<61>es seulement).</p>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDMax" id="DBDMax">DBDMax</a> <a name="dbdmax" id="dbdmax">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de connexions</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDMax <var>nombre</var></code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>DBDMax 10</code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Cette directive d<>finit le nombre maximum effectif de
|
||||
connexions par processus (plates-formes thread<61>es seulement).</p>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDMin" id="DBDMin">DBDMin</a> <a name="dbdmin" id="dbdmin">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimum de connexions</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDMin <var>nombre</var></code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>DBDMin 1</code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Cette directive d<>finit le nombre minimum de connexions
|
||||
par processus (plates-formes thread<61>es seulement).</p>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDParams" id="DBDParams">DBDParams</a> <a name="dbdparams" id="dbdparams">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Param<61>tres de la connexion <20> la base de
|
||||
donn<EFBFBD>es</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDParams
|
||||
<var>param1</var>=<var>valeur1</var>[,<var>param2</var>=<var>valeur2</var>]</code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Cette directive sp<73>cifie des param<61>tres selon les
|
||||
besoins du pilote concern<72>. En g<>n<EFBFBD>ral, les param<61>tres <20> 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<6E>es, le nom
|
||||
d'h<>te et le num<75>ro de port de la connexion.</p>
|
||||
<p>Les param<61>tres de la cha<68>ne de connexion en fonction des
|
||||
diff<66>rents pilotes comprennent :</p>
|
||||
<dl>
|
||||
<dt>FreeTDS (pour MSSQL et SyBase)</dt>
|
||||
<dd>username, password, appname, dbname, host, charset, lang, server</dd>
|
||||
<dt>MySQL</dt>
|
||||
<dd>host, port, user, pass, dbname, sock, flags, fldsz, group, reconnect</dd>
|
||||
<dt>Oracle</dt>
|
||||
<dd>user, pass, dbname, server</dd>
|
||||
<dt>PostgreSQL</dt>
|
||||
<dd>La cha<68>ne de connexion est pass<73>e directement <20> <code>PQconnectdb</code></dd>
|
||||
<dt>SQLite2</dt>
|
||||
<dd>La cha<68>ne de connexion est scind<6E>e avec comme s<>parateur le
|
||||
caract<63>re ':', et <code>partie1:partie2</code> est utilis<69> dans
|
||||
<code>sqlite_open(partie1, atoi(partie2), NULL)</code></dd>
|
||||
<dt>SQLite3</dt>
|
||||
<dd>La cha<68>ne de connexion est pass<73>e directement <20> <code>sqlite3_open</code></dd>
|
||||
<dt>ODBC</dt>
|
||||
<dd>datasource, user, password, connect, ctimeout, stimeout, access, txmode, bufsize</dd>
|
||||
</dl>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDPersist" id="DBDPersist">DBDPersist</a> <a name="dbdpersist" id="dbdpersist">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utiliser ou non des connexions persistentes</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDPersist On|Off</code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Si cette directive est d<>finie <20> Off, les connexions persistentes
|
||||
et les connexions group<75>es sont d<>sactiv<69>es. <20> la demande d'un
|
||||
client, une nouvelle connexion <20> la base de donn<6E>es est ouverte, et
|
||||
ferm<72>e imm<6D>diatement <20> l'issue du traitement. Cette configuration ne
|
||||
doit <20>tre utilis<69>e qu'<27> des fins de d<>bogage, ou sur des serveurs <20>
|
||||
charge faible.</p>
|
||||
|
||||
<p>Par d<>faut, les groupes de connexions persistentes sont activ<69>s
|
||||
(ou une seule connexion persistente du style LAMP pour les serveurs
|
||||
non thread<61>s), et c'est la configuration qui devrait <20>tre utilis<69>e
|
||||
dans la plupart des cas sur un serveur en production.</p>
|
||||
|
||||
<p>Avant la version 2.2.2, cette directive n'acceptait que les
|
||||
valeurs <code>0</code> et <code>1</code> au lieu de <code>Off</code>
|
||||
et <code>On</code>, respectivement.</p>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDPrepareSQL" id="DBDPrepareSQL">DBDPrepareSQL</a> <a name="dbdpreparesql" id="dbdpreparesql">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>finit une requ<71>te SQL pr<70>par<61>e</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDPrepareSQL <var>"requ<71>te SQL"</var> <var><3E>tiquette</var></code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Pour les modules tels que les modules d'authentification, qui
|
||||
utilisent de mani<6E>re r<>p<EFBFBD>t<EFBFBD>e la m<>me requ<71>te SQL, on peut optimiser
|
||||
les performances en pr<70>parant la requ<71>te une fois pour toutes au
|
||||
d<>marrage, plut<75>t qu'<27> chaque utilisation. Cette directive permet de
|
||||
pr<70>parer une requ<71>te SQL et de lui assigner une <20>tiquette.</p>
|
||||
|
||||
</div>
|
||||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||||
<div class="directive-section"><h2><a name="DBDriver" id="DBDriver">DBDriver</a> <a name="dbdriver" id="dbdriver">Directive</a></h2>
|
||||
<table class="directive">
|
||||
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp<53>cifie un pilote SQL</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DBDriver <var>nom</var></code></td></tr>
|
||||
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
|
||||
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dbd</td></tr>
|
||||
</table>
|
||||
<p>Cette directive sp<73>cifie un pilote apr_dbd par son
|
||||
nom. Le pilote doit <20>tre install<6C> sur votre syst<73>me (sur la plupart
|
||||
des syst<73>mes, il s'agit d'un objet partag<61> ou d'une dll). Par
|
||||
exemple, <code>DBDriver mysql</code> va s<>lectionner le pilote MySQL
|
||||
dans la biblioth<74>que apr_dbd_mysql.so.</p>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<div class="bottomlang">
|
||||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||||
<a href="../fr/mod/mod_dbd.html" title="Fran<61>ais"> fr </a></p>
|
||||
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
|
||||
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
||||
var comments_shortname = 'httpd';
|
||||
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_dbd.html';
|
||||
(function(w, d) {
|
||||
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
||||
d.write('<div id="comments_thread"><\/div>');
|
||||
var s = d.createElement('script');
|
||||
s.type = 'text/javascript';
|
||||
s.async = true;
|
||||
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
||||
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
||||
}
|
||||
else {
|
||||
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
|
||||
}
|
||||
})(window, document);
|
||||
//--><!]]></script></div><div id="footer">
|
||||
<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
|
||||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
|
||||
if (typeof(prettyPrint) !== 'undefined') {
|
||||
prettyPrint();
|
||||
}
|
||||
//--><!]]></script>
|
||||
</body></html>
|
||||
350
docs/manual/mod/mod_dbd.xml.fr
Normal file
350
docs/manual/mod/mod_dbd.xml.fr
Normal file
@@ -0,0 +1,350 @@
|
||||
<?xml version="1.0"?>
|
||||
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
||||
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
||||
<!-- English Revision : 1421821 -->
|
||||
<!-- French translation : Lucien GENTIS -->
|
||||
<!-- Reviewed by : Vincent Deffontaines -->
|
||||
|
||||
<!--
|
||||
Licensed to the Apache Software Foundation (ASF) under one or more
|
||||
contributor license agreements. See the NOTICE file distributed with
|
||||
this work for additional information regarding copyright ownership.
|
||||
The ASF licenses this file to You under the Apache License, Version 2.0
|
||||
(the "License"); you may not use this file except in compliance with
|
||||
the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
-->
|
||||
|
||||
<modulesynopsis metafile="mod_dbd.xml.meta">
|
||||
|
||||
<name>mod_dbd</name>
|
||||
<description>Gestion des connexions à une base de données SQL</description>
|
||||
<status>Extension</status>
|
||||
<sourcefile>mod_dbd.c</sourcefile>
|
||||
<identifier>dbd_module</identifier>
|
||||
|
||||
<summary>
|
||||
<p>Le module <module>mod_dbd</module> gère les connexions
|
||||
à une base de données SQL via <glossary>APR</glossary>. 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 <a
|
||||
href="http://apr.apache.org/">APR</a>,
|
||||
ainsi que cette vue d'ensemble de l'<a
|
||||
href="http://people.apache.org/~niq/dbd.html">environnement de
|
||||
développement d'Apache DBD</a> par son développeur initial.
|
||||
</p>
|
||||
</summary>
|
||||
|
||||
<seealso><a href="../misc/password_encryptions.html">Formats des mots de
|
||||
passe</a></seealso>
|
||||
|
||||
<section id="pooling"><title>Regroupement des connexions</title>
|
||||
<p>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 <em>groupe de
|
||||
connexions</em> à la fois plus évolutif et plus efficace, comme
|
||||
décrit dans <a href="http://www.apachetutor.org/dev/reslist">cet
|
||||
article d'ApacheTutor</a>. Notez que <module>mod_dbd</module>
|
||||
remplace les modules présentés dans cet article.</p>
|
||||
</section>
|
||||
|
||||
<section id="API"><title>API DBD d'Apache</title>
|
||||
<p><module>mod_dbd</module> exporte cinq fonctions que d'autres
|
||||
modules pourront utiliser. L'API se présente comme suit :</p>
|
||||
|
||||
<highlight language="c">
|
||||
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 DEVRA être 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 DEVRA PAS être 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 DEVRA PAS être 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*));
|
||||
</highlight>
|
||||
</section>
|
||||
|
||||
<section id="prepared"><title>Requêtes SQL préparées</title>
|
||||
<p><module>mod_dbd</module> supporte les requêtes SQL préparées pour
|
||||
le compte 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
|
||||
<code>apr_dbd_prepared_t</code> et s'utilisent dans toute requête
|
||||
SQL ou commande select préparée par apr_dbd.</p>
|
||||
|
||||
<p>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 <code>ap_dbd_prepare</code>.</p>
|
||||
|
||||
<note type="warning"><title>Avertissement</title>
|
||||
Lorsqu'on utilise des requêtes préparées avec des bases de
|
||||
données MySQL, il est préférable de définir
|
||||
<code>reconnect</code> à 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 <code>reconnect</code> 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.
|
||||
</note>
|
||||
</section>
|
||||
|
||||
<section id="security">
|
||||
<title>AVERTISSEMENT DE SECURITE</title>
|
||||
<p>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 sûres 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.</p>
|
||||
<p>Cependant, le pilote <var>FreeTDS</var> est <strong>non
|
||||
sûr</strong> 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.</p>
|
||||
<p>Il peut être sécurisé en <em>décontaminant</em> toutes les
|
||||
entrées : un processus inspiré de la recherche de contaminations de
|
||||
Perl (NdT : <code>taint checking</code>). Chaque entrée est comparée
|
||||
à une expression rationnelle, et
|
||||
seules les entrées qui correspondent sont utilisées, en accord avec
|
||||
le raccourci Perl :</p>
|
||||
<example>
|
||||
<pre><code> $untrusted =~ /([a-z]+)/;
|
||||
$trusted = $1;</code></pre>
|
||||
</example>
|
||||
<p>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 :</p>
|
||||
<example>
|
||||
<code>"SELECT foo FROM bar WHERE input = %s"</code>
|
||||
</example>
|
||||
<p>avec d'autres pilotes, et ne risquer au pire qu'une requête
|
||||
en échec. Mais avec FreeTDS, vous devez utiliser :</p>
|
||||
<example>
|
||||
<code>"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"</code>
|
||||
</example>
|
||||
<p>tout ce qui ne correspond pas à l'expression rationnelle est
|
||||
alors rejeté, et la requête est ainsi désormais sûre.</p>
|
||||
<p>Alternativement, vous pouvez utiliser le pilote ODBC tiers, qui
|
||||
offre la sécurité des requêtes préparées authentiques.</p>
|
||||
</section>
|
||||
<directivesynopsis>
|
||||
<name>DBDriver</name>
|
||||
<description>Spécifie un pilote SQL</description>
|
||||
<syntax>DBDriver <var>nom</var></syntax>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>Cette directive spécifie 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, <code>DBDriver mysql</code> va sélectionner le pilote MySQL
|
||||
dans la bibliothèque apr_dbd_mysql.so.</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDParams</name>
|
||||
<description>Paramètres de la connexion à la base de
|
||||
données</description>
|
||||
<syntax>DBDParams
|
||||
<var>param1</var>=<var>valeur1</var>[,<var>param2</var>=<var>valeur2</var>]</syntax>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>Cette directive spécifie 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.</p>
|
||||
<p>Les paramètres de la chaîne de connexion en fonction des
|
||||
différents pilotes comprennent :</p>
|
||||
<dl>
|
||||
<dt>FreeTDS (pour MSSQL et SyBase)</dt>
|
||||
<dd>username, password, appname, dbname, host, charset, lang, server</dd>
|
||||
<dt>MySQL</dt>
|
||||
<dd>host, port, user, pass, dbname, sock, flags, fldsz, group, reconnect</dd>
|
||||
<dt>Oracle</dt>
|
||||
<dd>user, pass, dbname, server</dd>
|
||||
<dt>PostgreSQL</dt>
|
||||
<dd>La chaîne de connexion est passée directement à <code>PQconnectdb</code></dd>
|
||||
<dt>SQLite2</dt>
|
||||
<dd>La chaîne de connexion est scindée avec comme séparateur le
|
||||
caractère ':', et <code>partie1:partie2</code> est utilisé dans
|
||||
<code>sqlite_open(partie1, atoi(partie2), NULL)</code></dd>
|
||||
<dt>SQLite3</dt>
|
||||
<dd>La chaîne de connexion est passée directement à <code>sqlite3_open</code></dd>
|
||||
<dt>ODBC</dt>
|
||||
<dd>datasource, user, password, connect, ctimeout, stimeout, access, txmode, bufsize</dd>
|
||||
</dl>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDPersist</name>
|
||||
<description>Utiliser ou non des connexions persistentes</description>
|
||||
<syntax>DBDPersist On|Off</syntax>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>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.</p>
|
||||
|
||||
<p>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.</p>
|
||||
|
||||
<p>Avant la version 2.2.2, cette directive n'acceptait que les
|
||||
valeurs <code>0</code> et <code>1</code> au lieu de <code>Off</code>
|
||||
et <code>On</code>, respectivement.</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDPrepareSQL</name>
|
||||
<description>Définit une requête SQL préparée</description>
|
||||
<syntax>DBDPrepareSQL <var>"requête SQL"</var> <var>étiquette</var></syntax>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>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.</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDMin</name>
|
||||
<description>Nombre minimum de connexions</description>
|
||||
<syntax>DBDMin <var>nombre</var></syntax>
|
||||
<default>DBDMin 1</default>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>Cette directive définit le nombre minimum de connexions
|
||||
par processus (plates-formes threadées seulement).</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDKeep</name>
|
||||
<description>Nombre maximum de connexions maintenues</description>
|
||||
<syntax>DBDKeep <var>nombre</var></syntax>
|
||||
<default>DBDKeep 2</default>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>Cette directive définit le nombre maximum de connexions
|
||||
à maintenir par processus, en dehors de celles servant à gérer les
|
||||
pics de demandes (plates-formes threadées seulement).</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDMax</name>
|
||||
<description>Nombre maximum de connexions</description>
|
||||
<syntax>DBDMax <var>nombre</var></syntax>
|
||||
<default>DBDMax 10</default>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>Cette directive définit le nombre maximum effectif de
|
||||
connexions par processus (plates-formes threadées seulement).</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDExptime</name>
|
||||
<description>Durée de vie des connexions inactives</description>
|
||||
<syntax>DBDExptime <var>durée en secondes</var></syntax>
|
||||
<default>DBDExptime 300</default>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>Cette directive définit 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 seulement).</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
<directivesynopsis>
|
||||
<name>DBDInitSQL</name>
|
||||
<description>Exécute une instruction SQL après connexion à une base de
|
||||
données</description>
|
||||
<syntax>DBDInitSQL <var>"instruction SQL"</var></syntax>
|
||||
<contextlist><context>server config</context><context>virtual host</context>
|
||||
</contextlist>
|
||||
|
||||
<usage>
|
||||
<p>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.</p>
|
||||
</usage>
|
||||
</directivesynopsis>
|
||||
|
||||
|
||||
</modulesynopsis>
|
||||
@@ -8,5 +8,6 @@
|
||||
|
||||
<variants>
|
||||
<variant>en</variant>
|
||||
<variant>fr</variant>
|
||||
</variants>
|
||||
</metafile>
|
||||
|
||||
Reference in New Issue
Block a user