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