WebStack

docs/sessions-servers.html

755:139b1412b9c3
2008-02-03 paulb [project @ 2008-02-03 19:58:01 by paulb] Added measures to permit the usage of non-ASCII characters in plaintexts.
     1 <?xml version="1.0" encoding="iso-8859-1"?>     2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">     3 <html xmlns="http://www.w3.org/1999/xhtml"><head>     4   <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type" />     5   <title>Server Environment Support for Sessions</title>     6   <link href="styles.css" rel="stylesheet" type="text/css" /></head>     7 <body>     8 <h1>Server Environment Support for Sessions</h1>     9 <p>Various server environments or frameworks do not support sessions    10 directly. In order to provide primitive support for sessions within    11 WebStack upon such frameworks, the <code>WebStack.Helpers.Session</code>    12 module is used to provide a simple file-based session store. Before    13 deploying an application on one of these frameworks, it may be necessary to    14 create a directory called <code>WebStack-sessions</code> in a    15 particular location so that the storage of session information will    16 work, although WebStack will attempt to create such a directory if it does not already exist.</p>    17 <p>The location of the <code>WebStack-sessions</code> directory    18 depends on the framework as summarised below:</p>    19 <table style="text-align: left; width: 80%;" align="center" border="1" cellpadding="5" cellspacing="0" width="80%">    20   <tbody>    21     <tr>    22       <th style="text-align: center;">Server Environment</th>    23       <th style="text-align: center;">Directory Location</th>    24     </tr>    25     <tr>    26       <td align="undefined" valign="undefined">BaseHTTPRequestHandler</td>    27       <td align="undefined" valign="undefined">The directory where the    28 server is run.</td>    29     </tr>    30     <tr>    31       <td align="undefined" valign="undefined">CGI</td>    32       <td align="undefined" valign="undefined">The directory where the    33 handler resides.</td>    34     </tr>    35     <tr>    36       <td align="undefined" valign="undefined">mod_python</td>    37       <td align="undefined" valign="undefined">The server root (such    38 as <code>/usr/local/apache2</code>).</td>    39     </tr>    40     <tr>    41       <td align="undefined" valign="undefined">Twisted</td>    42       <td align="undefined" valign="undefined">The directory where the    43 server is run.</td>    44     </tr>    45   </tbody>    46 </table>    47 <p>Note that the <code>WebStack-sessions</code> directory must    48 have the appropriate ownership and privileges necessary for the server    49 or framework to write session information into it.<br />    50 </p>    51 <h2>Unsupported Environments and Framework Issues</h2>    52 <ul>    53   <li>Webware 0.8.1 has problems creating sessions and is therefore not    54 supported.</li>    55   <li>Webware releases later than 0.8.1 (at least until the 2004-02-06    56 CVS snapshot used for testing) do not support session detection or    57 expiry correctly.</li>    58 </ul>    59 </body></html>