granicus.if.org Git - apache/blob - docs/manual/mod/mod_session_dbd.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
   4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_session_dbd - Apache HTTP Server Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <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" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <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">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  21 <p class="apache">Apache HTTP Server Version 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Apache Module mod_session_dbd</h1>
  28 <div class="toplang">
  29 <p><span>Available Languages: </span><a href="../en/mod/mod_session_dbd.html" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_session_dbd.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
  31 </div>
  32 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>DBD/SQL based session support</td></tr>
  33 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  34 <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>session_dbd_module</td></tr>
  35 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_session_dbd.c</td></tr>
  36 <tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.3 and later</td></tr></table>
  37 <h3>Summary</h3>
  38
  39     <div class="warning"><h3>Warning</h3>
  40       <p>The session modules make use of HTTP cookies, and as such can fall
  41       victim to Cross Site Scripting attacks, or expose potentially private
  42       information to clients. Please ensure that the relevant risks have
  43       been taken into account before enabling the session functionality on
  44       your server.</p>
  45     </div>
  46
  47     <p>This submodule of <code class="module"><a href="../mod/mod_session.html">mod_session</a></code> provides support for the
  48     storage of user sessions within a SQL database using the
  49     <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> module.</p>
  50
  51     <p>Sessions can either be <strong>anonymous</strong>, where the session is
  52     keyed by a unique UUID string stored on the browser in a cookie, or
  53     <strong>per user</strong>, where the session is keyed against the userid of
  54     the logged in user.</p>
  55
  56     <p>SQL based sessions are hidden from the browser, and so offer a measure of
  57     privacy without the need for encryption.</p>
  58
  59     <p>Different webservers within a server farm may choose to share a database,
  60     and so share sessions with one another.</p>
  61
  62     <p>For more details on the session interface, see the documentation for
  63     the <code class="module"><a href="../mod/mod_session.html">mod_session</a></code> module.</p>
  64
  65 </div>
  66 <div id="quickview"><h3>Topics</h3>
  67 <ul id="topics">
  68 <li><img alt="" src="../images/down.gif" /> <a href="#dbdconfig">DBD Configuration</a></li>
  69 <li><img alt="" src="../images/down.gif" /> <a href="#anonymous">Anonymous Sessions</a></li>
  70 <li><img alt="" src="../images/down.gif" /> <a href="#peruser">Per User Sessions</a></li>
  71 <li><img alt="" src="../images/down.gif" /> <a href="#housekeeping">Database Housekeeping</a></li>
  72 </ul><h3 class="directives">Directives</h3>
  73 <ul id="toc">
  74 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbdcookiename">SessionDBDCookieName</a></li>
  75 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbdcookiename2">SessionDBDCookieName2</a></li>
  76 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbdcookieremove">SessionDBDCookieRemove</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbddeletelabel">SessionDBDDeleteLabel</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbdinsertlabel">SessionDBDInsertLabel</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbdperuser">SessionDBDPerUser</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbdselectlabel">SessionDBDSelectLabel</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#sessiondbdupdatelabel">SessionDBDUpdateLabel</a></li>
  82 </ul>
  83 <h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_session_dbd">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_session_dbd">Report a bug</a></li></ul><h3>See also</h3>
  84 <ul class="seealso">
  85 <li><code class="module"><a href="../mod/mod_session.html">mod_session</a></code></li>
  86 <li><code class="module"><a href="../mod/mod_session_crypto.html">mod_session_crypto</a></code></li>
  87 <li><code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code></li>
  88 <li><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code></li>
  89 <li><a href="#comments_section">Comments</a></li></ul></div>
  90 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  91 <div class="section">
  92 <h2><a name="dbdconfig" id="dbdconfig">DBD Configuration</a></h2>
  93
  94       <p>Before the <code class="module"><a href="../mod/mod_session_dbd.html">mod_session_dbd</a></code> module can be configured to maintain a
  95       session, the <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> module must be configured to make the various database queries
  96       available to the server.</p>
  97
  98       <p>There are four queries required to keep a session maintained, to select an existing session,
  99       to update an existing session, to insert a new session, and to delete an expired or empty
 100       session. These queries are configured as per the example below.</p>
 101
 102       <div class="example"><h3>Sample DBD configuration</h3><pre class="prettyprint lang-config">DBDriver pgsql
 103 DBDParams "dbname=apachesession user=apache password=xxxxx host=localhost"
 104 DBDPrepareSQL "delete from session where key = %s" deletesession
 105 DBDPrepareSQL "update session set value = %s, expiry = %lld, key = %s where key = %s" updatesession
 106 DBDPrepareSQL "insert into session (value, expiry, key) values (%s, %lld, %s)" insertsession
 107 DBDPrepareSQL "select value from session where key = %s and (expiry = 0 or expiry &gt; %lld)" selectsession
 108 DBDPrepareSQL "delete from session where expiry != 0 and expiry &lt; %lld" cleansession</pre>
 109 </div>
 110
 111     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 112 <div class="section">
 113 <h2><a name="anonymous" id="anonymous">Anonymous Sessions</a></h2>
 114
 115       <p>Anonymous sessions are keyed against a unique UUID, and stored on the
 116       browser within an HTTP cookie. This method is similar to that used by most
 117       application servers to store session information.</p>
 118
 119       <p>To create a simple anonymous session and store it in a postgres database
 120       table called <var>apachesession</var>, and save the session ID in a cookie
 121       called <var>session</var>, configure the session as follows:</p>
 122
 123       <div class="example"><h3>SQL based anonymous session</h3><pre class="prettyprint lang-config">Session On
 124 SessionDBDCookieName session path=/</pre>
 125 </div>
 126
 127       <p>For more examples on how the session can be configured to be read
 128       from and written to by a CGI application, see the
 129       <code class="module"><a href="../mod/mod_session.html">mod_session</a></code> examples section.</p>
 130
 131       <p>For documentation on how the session can be used to store username
 132       and password details, see the <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> module.</p>
 133
 134     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 135 <div class="section">
 136 <h2><a name="peruser" id="peruser">Per User Sessions</a></h2>
 137
 138       <p>Per user sessions are keyed against the username of a successfully
 139       authenticated user. It offers the most privacy, as no external handle
 140       to the session exists outside of the authenticated realm.</p>
 141
 142       <p>Per user sessions work within a correctly configured authenticated
 143       environment, be that using basic authentication, digest authentication
 144       or SSL client certificates. Due to the limitations of who came first,
 145       the chicken or the egg, per user sessions cannot be used to store
 146       authentication credentials from a module like
 147       <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>.</p>
 148
 149       <p>To create a simple per user session and store it in a postgres database
 150       table called <var>apachesession</var>, and with the session keyed to the
 151       userid, configure the session as follows:</p>
 152
 153       <div class="example"><h3>SQL based per user session</h3><pre class="prettyprint lang-config">Session On
 154 SessionDBDPerUser On</pre>
 155 </div>
 156
 157     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 158 <div class="section">
 159 <h2><a name="housekeeping" id="housekeeping">Database Housekeeping</a></h2>
 160       <p>Over the course of time, the database can be expected to start accumulating
 161       expired sessions. At this point, the <code class="module"><a href="../mod/mod_session_dbd.html">mod_session_dbd</a></code> module
 162       is not yet able to handle session expiry automatically.</p>
 163
 164       <div class="warning"><h3>Warning</h3>
 165       <p>The administrator will need to set up an external process via cron to clean
 166       out expired sessions.</p>
 167       </div>
 168
 169     </div>
 170 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 171 <div class="directive-section"><h2><a name="SessionDBDCookieName" id="SessionDBDCookieName">SessionDBDCookieName</a> <a name="sessiondbdcookiename" id="sessiondbdcookiename">Directive</a></h2>
 172 <table class="directive">
 173 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2109 cookie storing the session ID</td></tr>
 174 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDCookieName <var>name</var> <var>attributes</var></code></td></tr>
 175 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>none</code></td></tr>
 176 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 177 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 178 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 179 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 180 </table>
 181     <p>The <code class="directive">SessionDBDCookieName</code> directive specifies the name and
 182     optional attributes of an RFC2109 compliant cookie inside which the session ID will
 183     be stored. RFC2109 cookies are set using the <code>Set-Cookie</code> HTTP header.
 184     </p>
 185
 186     <p>An optional list of cookie attributes can be specified, as per the example below.
 187     These attributes are inserted into the cookie as is, and are not interpreted by
 188     Apache. Ensure that your attributes are defined correctly as per the cookie specification.
 189     </p>
 190
 191     <div class="example"><h3>Cookie with attributes</h3><pre class="prettyprint lang-config">Session On
 192 SessionDBDCookieName session path=/private;domain=example.com;httponly;secure;version=1;</pre>
 193 </div>
 194
 195
 196 </div>
 197 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 198 <div class="directive-section"><h2><a name="SessionDBDCookieName2" id="SessionDBDCookieName2">SessionDBDCookieName2</a> <a name="sessiondbdcookiename2" id="sessiondbdcookiename2">Directive</a></h2>
 199 <table class="directive">
 200 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Name and attributes for the RFC2965 cookie storing the session ID</td></tr>
 201 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDCookieName2 <var>name</var> <var>attributes</var></code></td></tr>
 202 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>none</code></td></tr>
 203 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 204 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 205 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 206 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 207 </table>
 208     <p>The <code class="directive">SessionDBDCookieName2</code> directive specifies the name and
 209     optional attributes of an RFC2965 compliant cookie inside which the session ID will
 210     be stored. RFC2965 cookies are set using the <code>Set-Cookie2</code> HTTP header.
 211     </p>
 212
 213     <p>An optional list of cookie attributes can be specified, as per the example below.
 214     These attributes are inserted into the cookie as is, and are not interpreted by
 215     Apache. Ensure that your attributes are defined correctly as per the cookie specification.
 216     </p>
 217
 218     <div class="example"><h3>Cookie2 with attributes</h3><pre class="prettyprint lang-config">Session On
 219 SessionDBDCookieName2 session path=/private;domain=example.com;httponly;secure;version=1;</pre>
 220 </div>
 221
 222
 223 </div>
 224 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 225 <div class="directive-section"><h2><a name="SessionDBDCookieRemove" id="SessionDBDCookieRemove">SessionDBDCookieRemove</a> <a name="sessiondbdcookieremove" id="sessiondbdcookieremove">Directive</a></h2>
 226 <table class="directive">
 227 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Control for whether session ID cookies should be removed from incoming HTTP headers</td></tr>
 228 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDCookieRemove On|Off</code></td></tr>
 229 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SessionDBDCookieRemove On</code></td></tr>
 230 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 231 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 232 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 233 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 234 </table>
 235     <p>The <code class="directive">SessionDBDCookieRemove</code> flag controls whether the cookies
 236     containing the session ID will be removed from the headers during request processing.</p>
 237
 238     <p>In a reverse proxy situation where the Apache server acts as a server frontend for
 239     a backend origin server, revealing the contents of the session ID cookie to the backend
 240     could be a potential privacy violation. When set to on, the session ID cookie will be
 241     removed from the incoming HTTP headers.</p>
 242
 243
 244 </div>
 245 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 246 <div class="directive-section"><h2><a name="SessionDBDDeleteLabel" id="SessionDBDDeleteLabel">SessionDBDDeleteLabel</a> <a name="sessiondbddeletelabel" id="sessiondbddeletelabel">Directive</a></h2>
 247 <table class="directive">
 248 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to remove sessions from the database</td></tr>
 249 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDDeleteLabel <var>label</var></code></td></tr>
 250 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SessionDBDDeleteLabel deletesession</code></td></tr>
 251 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 252 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 253 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 254 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 255 </table>
 256     <p>The <code class="directive">SessionDBDDeleteLabel</code> directive sets the default delete
 257     query label to be used to delete an expired or empty session. This label must have been previously
 258     defined using the <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
 259
 260
 261 </div>
 262 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 263 <div class="directive-section"><h2><a name="SessionDBDInsertLabel" id="SessionDBDInsertLabel">SessionDBDInsertLabel</a> <a name="sessiondbdinsertlabel" id="sessiondbdinsertlabel">Directive</a></h2>
 264 <table class="directive">
 265 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to insert sessions into the database</td></tr>
 266 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDInsertLabel <var>label</var></code></td></tr>
 267 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SessionDBDInsertLabel insertsession</code></td></tr>
 268 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 269 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 270 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 271 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 272 </table>
 273     <p>The <code class="directive">SessionDBDInsertLabel</code> directive sets the default insert
 274     query label to be used to load in a session. This label must have been previously defined using the
 275     <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
 276
 277     <p>If an attempt to update the session affects no rows, this query will be called to insert the
 278     session into the database.</p>
 279
 280
 281 </div>
 282 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 283 <div class="directive-section"><h2><a name="SessionDBDPerUser" id="SessionDBDPerUser">SessionDBDPerUser</a> <a name="sessiondbdperuser" id="sessiondbdperuser">Directive</a></h2>
 284 <table class="directive">
 285 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable a per user session</td></tr>
 286 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDPerUser On|Off</code></td></tr>
 287 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SessionDBDPerUser Off</code></td></tr>
 288 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 289 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 290 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 291 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 292 </table>
 293     <p>The <code class="directive">SessionDBDPerUser</code> flag enables a per user session keyed
 294     against the user's login name. If the user is not logged in, this directive will be
 295     ignored.</p>
 296
 297
 298 </div>
 299 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 300 <div class="directive-section"><h2><a name="SessionDBDSelectLabel" id="SessionDBDSelectLabel">SessionDBDSelectLabel</a> <a name="sessiondbdselectlabel" id="sessiondbdselectlabel">Directive</a></h2>
 301 <table class="directive">
 302 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to select sessions from the database</td></tr>
 303 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDSelectLabel <var>label</var></code></td></tr>
 304 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SessionDBDSelectLabel selectsession</code></td></tr>
 305 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 306 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 307 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 308 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 309 </table>
 310     <p>The <code class="directive">SessionDBDSelectLabel</code> directive sets the default select
 311     query label to be used to load in a session. This label must have been previously defined using the
 312     <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
 313
 314
 315 </div>
 316 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 317 <div class="directive-section"><h2><a name="SessionDBDUpdateLabel" id="SessionDBDUpdateLabel">SessionDBDUpdateLabel</a> <a name="sessiondbdupdatelabel" id="sessiondbdupdatelabel">Directive</a></h2>
 318 <table class="directive">
 319 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The SQL query to use to update existing sessions in the database</td></tr>
 320 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>SessionDBDUpdateLabel <var>label</var></code></td></tr>
 321 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>SessionDBDUpdateLabel updatesession</code></td></tr>
 322 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
 323 <tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 324 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
 325 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_session_dbd</td></tr>
 326 </table>
 327     <p>The <code class="directive">SessionDBDUpdateLabel</code> directive sets the default update
 328     query label to be used to load in a session. This label must have been previously defined using the
 329     <code class="directive"><a href="../mod/mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></code> directive.</p>
 330
 331     <p>If an attempt to update the session affects no rows, the insert query will be
 332     called to insert the session into the database. If the database supports InsertOrUpdate,
 333     override this query to perform the update in one query instead of two.</p>
 334
 335
 336 </div>
 337 </div>
 338 <div class="bottomlang">
 339 <p><span>Available Languages: </span><a href="../en/mod/mod_session_dbd.html" title="English">&nbsp;en&nbsp;</a> |
 340 <a href="../fr/mod/mod_session_dbd.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
 341 </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">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;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>
 342 <script type="text/javascript"><!--//--><![CDATA[//><!--
 343 var comments_shortname = 'httpd';
 344 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_session_dbd.html';
 345 (function(w, d) {
 346     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 347         d.write('<div id="comments_thread"><\/div>');
 348         var s = d.createElement('script');
 349         s.type = 'text/javascript';
 350         s.async = true;
 351         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 352         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 353     }
 354     else {
 355         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 356     }
 357 })(window, document);
 358 //--><!]]></script></div><div id="footer">
 359 <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 360 <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">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 361 if (typeof(prettyPrint) !== 'undefined') {
 362     prettyPrint();
 363 }
 364 //--><!]]></script>
 365 </body></html>