{"title":"セッションの使いかた","version":"5.1","locale":"ja","docname":"topics/http/sessions","url":"/ja/5.1/topics/http/sessions/","canonical":"https://djangodocs.dev/ja/5.1/topics/http/sessions/","summary":"Django は、匿名のセッションをフルサポートしています。このセッションフレームワークを使えば、任意のデータを、サイトの訪問者ごとに保存し、取得できます。","html":"<span id=\"how-to-use-sessions\"></span><h1>セッションの使いかた<a class=\"heading-anchor\" href=\"#module-django.contrib.sessions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Django は、匿名のセッションをフルサポートしています。このセッションフレームワークを使えば、任意のデータを、サイトの訪問者ごとに保存し、取得できます。データはサーバー側に保存され、クッキーの送受信によって抽象化します。クッキーには、データそのものではなくセッション ID が書かれています ( <a class=\"reference internal\" href=\"#cookie-session-backend\"><span class=\"std std-ref\">クッキーベースのバックエンド</span></a> を使用しない限り)。</p>\n<section id=\"enabling-sessions\">\n<h2>セッションを有効にする<a class=\"heading-anchor\" href=\"#enabling-sessions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>セッションは、 <a class=\"reference internal\" href=\"/ja/5.1/ref/middleware/\"><span class=\"doc\">ミドルウェア</span></a> の1つを使って実装されています。</p>\n<p>セッションの機能を有効にするには、次のように設定を行います。</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-MIDDLEWARE\"><code class=\"xref std std-setting docutils literal notranslate\">MIDDLEWARE</code></a> 設定を編集し <code class=\"docutils literal notranslate\">'django.contrib.sessions.middleware.SessionMiddleware'</code> を含むようにする。 <code class=\"docutils literal notranslate\">django-admin startproject</code> で作られるデフォルトの <code class=\"docutils literal notranslate\">settings.py</code> は <code class=\"docutils literal notranslate\">SessionMiddleware</code> が有効化されています。</p></li>\n</ul>\n<p>セッションを使いたくない場合は、 <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-MIDDLEWARE\"><code class=\"xref std std-setting docutils literal notranslate\">MIDDLEWARE</code></a> 内の <code class=\"docutils literal notranslate\">SessionMiddleware</code> 行と <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\">INSTALLED_APPS</code></a> 内の <code class=\"docutils literal notranslate\">'django.contrib.sessions'</code> を削除しても構いません。これで、オーバーヘッドが少しだけ短縮されます。</p>\n</section>\n<section id=\"configuring-the-session-engine\">\n<span id=\"configuring-sessions\"></span><h2>セッションエンジンを設定する<a class=\"heading-anchor\" href=\"#configuring-the-session-engine\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>デフォルトでは、Django はセッションを、(<code class=\"docutils literal notranslate\">django.contrib.sessions.models.Session</code> モデルを用いて) データベースに保存します。これは便利ですが、セットアップによってはセッションのデータを他の場所においたほうが高速化できる場合があります。そのため、Django はセッションデータをファイルシステムやキャッシュに保存するように設定できます。</p>\n<section id=\"using-database-backed-sessions\">\n<h3>データベースを使ったセッション<a class=\"heading-anchor\" href=\"#using-database-backed-sessions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>データベースを使った (database-backed) セッションを使いたい場合には、設定ファイルの <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\">INSTALLED_APPS</code></a>  に <code class=\"docutils literal notranslate\">'django.contrib.sessions'</code> を追加する必要があります。</p>\n<p>一度インストールの設定をすれば、<code class=\"docutils literal notranslate\">manage.py migrate</code> を実行することで、セッションデータを保存する1つのデータベーステーブルをインストールできます。</p>\n</section>\n<section id=\"using-cached-sessions\">\n<span id=\"cached-sessions-backend\"></span><h3>キャッシュを使ったセッション<a class=\"heading-anchor\" href=\"#using-cached-sessions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>よいパフォーマンスを発揮するには、キャッシュを使ったセッションバックエンドを利用した方が良いかもしれません。</p>\n<p>Django のキャッシュシステムを使ってセッションデータを保存するには、まず初めに、キャッシュの設定を済ませておく必要があります。詳しくは、 <a class=\"reference internal\" href=\"/ja/5.1/topics/cache/\"><span class=\"doc\">キャッシュのドキュメンテーション</span></a> を読んでください。</p>\n<aside class=\"admonition admonition-warning\" role=\"note\">\n<p class=\"admonition-title\">警告</p>\n<p>キャッシュを使ったセッションを用いるのは、Memcached または Redis キャッシュバックエンドを使用している場合だけにするべきです。ローカルなメモリキャッシュバックエンドを使用している場合、長時間データをメモリ上に保持しておくのは良い考えではありませんし、全てのデータをファイルやデータベースキャッシュバックエンドを通して送信するよりも、ファイルやデータベースに保存されたセッションから直接送信した方が高速だからです。加えて、ローカルなメモリキャッシュバックエンドは、マルチプロセスに対して安全「ではありません」。したがって、実環境ではあまり良い選択とは言えないでしょう。</p>\n</aside>\n<p>設定ファイルの <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-CACHES\"><code class=\"xref std std-setting docutils literal notranslate\">CACHES</code></a> で複数のキャッシュを定義している場合、Django はデフォルトのキャッシュを使用します。他のキャッシュを使用するには、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_CACHE_ALIAS\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_CACHE_ALIAS</code></a> を使用したいキャッシュの名前に変更します。</p>\n<p>一度キャッシュが設定されると、データベース ベースのキャッシュ(database-backed cache) か非永続キャッシュ (non-persistent cache) のどちらかを選択する必要があります。</p>\n<p>キャッシュ付きデータベースバックエンド（<code class=\"docutils literal notranslate\">cached_db</code>）は、ライトスルーキャッシュを使用します。セッションの書き込みは、データベースとキャッシュの両方に、順番に適用されます。キャッシュへの書き込みが失敗した場合、例外処理が行われ、<a class=\"reference internal\" href=\"/ja/5.1/ref/logging/#django-contrib-sessions-logger\"><span class=\"std std-ref\">sessions logger</span></a> を通じて記録されます。これにより、片方だけで成功した書き込み操作が失敗することを防ぎます。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p>キャッシュへの書き込み時に発生する例外の処理およびログ記録機能が追加されました。</p>\n</aside>\n<p>セッションの読み取りは、まずキャッシュを使用し、データがキャッシュから削除されている場合にはデータベースを使用します。このバックエンドを使用するには、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_ENGINE</code></a> を <code class=\"docutils literal notranslate\">&quot;django.contrib.sessions.backends.cached_db&quot;</code> に設定し、<a class=\"reference internal\" href=\"#using-database-backed-sessions\">using database-backed sessions</a> の構成手順に従ってください。</p>\n<p>キャッシュバックエンド (<code class=\"docutils literal notranslate\">cache</code>) はセッションデータをキャッシュにのみ保存します。これはデータベースの永続化を避けることができるので高速ですが、キャッシュデータが削除されたときのことを考慮しなければなりません。キャッシュが一杯になったりキャッシュサーバーが再起動したりしたときにキャッシュが削除される可能性があり、ユーザーのログアウトを含めてセッションデータが失われることになります。このバックエンドを使うには、 <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_ENGINE</code></a> を <code class=\"docutils literal notranslate\">&quot;django.contrib.sessions.backends.cache&quot;</code> に設定してください。</p>\n<p>キャッシュバックエンドを永続化するには、Redis などの永続キャッシュを適切な設定で使用します。しかし、キャッシュが十分に永続化できるように確実に設定されていない限り、キャッシュデータベースバックエンドを選びましょう。これにより、運用時に信頼性の低いデータストレージによって引き起こされるエッジケースを避けることができます。</p>\n</section>\n<section id=\"using-file-based-sessions\">\n<h3>ファイルを使ったセッション<a class=\"heading-anchor\" href=\"#using-file-based-sessions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>ファイルを使ったセッションを使用するには、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_ENGINE</code></a> を <code class=\"docutils literal notranslate\">&quot;django.contrib.sessions.backends.file&quot;</code> に設定します。</p>\n<p>Django がセッションファイルを保存する場所を設定したい場合には、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_FILE_PATH\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_FILE_PATH</code></a> を設定します (出力先のデフォルト値は、<code class=\"docutils literal notranslate\">tempfile.gettempdir()</code>、普通は <code class=\"docutils literal notranslate\">/tmp</code> になっています)。ウェブサーバが設定した場所の読み書きの権限を持っていることを確認しておいてください。</p>\n</section>\n<section id=\"using-cookie-based-sessions\">\n<span id=\"cookie-session-backend\"></span><h3>クッキーを使ったセッション<a class=\"heading-anchor\" href=\"#using-cookie-based-sessions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>クッキーを使ったセッションを使用するには、 <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_ENGINE</code></a> を <code class=\"docutils literal notranslate\">&quot;django.contrib.sessions.backends.signed_cookies&quot;</code> に設定します。セッションデータは、 <a class=\"reference internal\" href=\"/ja/5.1/topics/signing/\"><span class=\"doc\">暗号化署名</span></a> のための Django のツールと <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SECRET_KEY\"><code class=\"xref std std-setting docutils literal notranslate\">SECRET_KEY</code></a> を使って保存されます。</p>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">注釈</p>\n<p>保存されたデータに JavaScript からアクセスできないように、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_HTTPONLY\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_HTTPONLY</code></a> を <code class=\"docutils literal notranslate\">True</code> に設定しておくことをおすすめします。</p>\n</aside>\n<aside class=\"admonition admonition-warning\" role=\"note\">\n<p class=\"admonition-title\">警告</p>\n<p><strong>このセッションデータは、署名はされていますが、暗号化はされていません。</strong></p>\n<p>クッキーバックエンドを使う時には、セッションデータはクライアントが自由に読むことができます。</p>\n<p>MAC (Message Authentication Code; メッセージ認証コード) を使っているので、たとえクライアントがデータを勝手に書き変えてしまったとしても、書き換えられたセッションデータは無効と判定されます。しかし、たとえばミューザのブラウザが保存しているクッキーを保存できたとしても、セッションクッキーのデータがすべて保存できず、データの一部が失われることがあり、この場合にもセッションデータは無効となってしまいます。Django はデータを圧縮しますが、それでもデータのサイズが1クッキーごとの  <span class=\"target\" id=\"index-2\"></span><a class=\"rfc reference external\" href=\"https://datatracker.ietf.org/doc/html/rfc2965.html#section-5.3\"><strong>一般的な制限の 4096 バイト</strong></a> を超えてしまうことは十分に考えられることです。</p>\n<p><strong>情報が最新であることは保証されません</strong></p>\n<p>MAC のおかげで、データの認証性 (データが他のサイトではなく、確実に自分のサイトで作られたものであること) と、完全性 (データが存在し、データが正しいこと) は保証されますが、そのデータが最新のものであることは保証することができません。つまり、クライアントからデータを受け取ったとしても、そのデータがユーザに最後に送った最新のデータであることは保証できないのです。ということは、セッションデータの使い方によっては、クッキーバックエンドでは  <a class=\"reference external\" href=\"https://en.wikipedia.org/wiki/Replay_attack\">replay attacks</a> ができてしまうことになります。他のセッションバックエンドでは、サーバー側に各セッションの記録が残るので、ユーザがログアウトした時にそれを無効化できますが、クッキーを使ったセッションの場合には、ユーザがログアウトしてもセッションは無効化されません。したがって、攻撃者がユーザのクッキーを盗めば、たとえユーザがログアウトしていたとしても、そのクッキーを使ってユーザになりすますことができてしまいます。クッキーが「古くなった」と判断できるのは、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_AGE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_AGE</code></a> を過ぎた場合だけだからです。</p>\n<p><strong>パフォーマンス</strong></p>\n<p>最後に、クッキーのサイズが大きくなると、サイトの速度にも大きな影響があります。</p>\n</aside>\n</section>\n</section>\n<section id=\"using-sessions-in-views\">\n<h2>ビューでセッションを使う<a class=\"heading-anchor\" href=\"#using-sessions-in-views\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><code class=\"docutils literal notranslate\">SessionMiddleware</code> を有効にすれば、それぞれの <a class=\"reference internal\" href=\"/ja/5.1/ref/request-response/#django.http.HttpRequest\" title=\"django.http.HttpRequest\"><code class=\"xref py py-class docutils literal notranslate\">HttpRequest</code></a> オブジェクト（Django のビュー関数に渡される最初の引数）は、辞書ライクなオブジェクトの <code class=\"docutils literal notranslate\">session</code> 属性を持つようになります。</p>\n<p>この <code class=\"docutils literal notranslate\">request.session</code> には、ビューの好きな場所で、何度でも、読み書きを行うことができます。</p>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-prename descclassname\">backends.base.</span><span class=\"sig-name descname\">SessionBase</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このオブジェクトは、すべてのセッションオブジェクトのベースクラスとなっているので、以下に挙げるような基本的なディクショナリのメソッドを持っています。</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.__getitem__\">\n<span class=\"sig-name descname\">__getitem__</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.__getitem__\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>例: <code class=\"docutils literal notranslate\">fav_color = request.session['fav_color']</code></p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.__setitem__\">\n<span class=\"sig-name descname\">__setitem__</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em>, <em class=\"sig-param\">value</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.__setitem__\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>例: <code class=\"docutils literal notranslate\">request.session['fav_color'] = 'blue'</code></p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.__delitem__\">\n<span class=\"sig-name descname\">__delitem__</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.__delitem__\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>例: <code class=\"docutils literal notranslate\">del request.session['fav_color']</code> 与えられた <code class=\"docutils literal notranslate\">key</code> がセッション内にない場合には、<code class=\"docutils literal notranslate\">KeyError</code> 例外を起こします。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.__contains__\">\n<span class=\"sig-name descname\">__contains__</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.__contains__\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>例: <code class=\"docutils literal notranslate\">'fav_color' in request.session</code></p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.get\">\n<span class=\"sig-name descname\">get</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em>, <em class=\"sig-param\">default<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.get\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aget\">\n<span class=\"sig-name descname\">aget</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em>, <em class=\"sig-param\">default<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aget\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aget()</code></p>\n<p>例: <code class=\"docutils literal notranslate\">fav_color = request.session.get('fav_color', 'red')</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aget()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aset\">\n<span class=\"sig-name descname\">aset</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em>, <em class=\"sig-param\">value</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aset\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><aside class=\"version-note version-added\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">New in Django 5.1</p></aside>\n<p>例: <code class=\"docutils literal notranslate\">await request.session.aset('fav_color', 'red')</code></p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.update\">\n<span class=\"sig-name descname\">update</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">dict</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.update\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aupdate\">\n<span class=\"sig-name descname\">aupdate</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">dict</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aupdate\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aupdate()</code></p>\n<p>例: <code class=\"docutils literal notranslate\">request.session.update({'fav_color': 'red'})</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aupdate()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.pop\">\n<span class=\"sig-name descname\">pop</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em>, <em class=\"sig-param\">default<span class=\"o\">=</span><span class=\"default_value\">__not_given</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.pop\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.apop\">\n<span class=\"sig-name descname\">apop</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em>, <em class=\"sig-param\">default<span class=\"o\">=</span><span class=\"default_value\">__not_given</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.apop\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">apop()</code></p>\n<p>例: <code class=\"docutils literal notranslate\">fav_color = request.session.pop('fav_color', 'blue')</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">apop()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.keys\">\n<span class=\"sig-name descname\">keys</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.keys\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.akeys\">\n<span class=\"sig-name descname\">akeys</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.akeys\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">akeys()</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">akeys()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.values\">\n<span class=\"sig-name descname\">values</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.values\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.avalues\">\n<span class=\"sig-name descname\">avalues</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.avalues\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">avalues()</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">avalues()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.has_key\">\n<span class=\"sig-name descname\">has_key</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.has_key\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.ahas_key\">\n<span class=\"sig-name descname\">ahas_key</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">key</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.ahas_key\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">ahas_key()</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">ahas_key()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.items\">\n<span class=\"sig-name descname\">items</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.items\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aitems\">\n<span class=\"sig-name descname\">aitems</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aitems\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aitems()</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aitems()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.setdefault\">\n<span class=\"sig-name descname\">setdefault</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.setdefault\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.asetdefault\">\n<span class=\"sig-name descname\">asetdefault</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.asetdefault\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">asetdefault()</code></p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">asetdefault()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.clear\">\n<span class=\"sig-name descname\">clear</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.clear\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>また、次のようなメソッドも利用できます。</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.flush\">\n<span class=\"sig-name descname\">flush</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.flush\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aflush\">\n<span class=\"sig-name descname\">aflush</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aflush\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aflush()</code></p>\n<p>セッションから現在のセッションデータを削除し、セッションクッキーを削除します。このメソッドは、前回のセッションデータがユーザのブラウザから再びアクセスされないようにするためなどに使います (たとえば、<a class=\"reference internal\" href=\"/ja/5.1/topics/auth/default/#django.contrib.auth.logout\" title=\"django.contrib.auth.logout\"><code class=\"xref py py-func docutils literal notranslate\">django.contrib.auth.logout()</code></a> がこの関数を呼びます)。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aflush()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.set_test_cookie\">\n<span class=\"sig-name descname\">set_test_cookie</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.set_test_cookie\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aset_test_cookie\">\n<span class=\"sig-name descname\">aset_test_cookie</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aset_test_cookie\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aset_test_cookie()</code></p>\n<p>ユーザのブラウザがクッキーをサポートしているかどうか判定するために、テスト用のクッキーをセットします。クッキーの動作原理により、ユーザが次のページへのリクエストを行わないとこのテストは行えません。詳しい情報については、下の <a class=\"reference internal\" href=\"#setting-test-cookies\">Setting test cookies</a> を読んでください。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aset_test_cookie()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.test_cookie_worked\">\n<span class=\"sig-name descname\">test_cookie_worked</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.test_cookie_worked\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.atest_cookie_worked\">\n<span class=\"sig-name descname\">atest_cookie_worked</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.atest_cookie_worked\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">atest_cookie_worked()</code></p>\n<p>ユーザーのブラウザがテストクッキーを受け入れたかどうかに応じて、<code class=\"docutils literal notranslate\">True</code> または <code class=\"docutils literal notranslate\">False</code> を返します。クッキーの仕組み上、別のページリクエストで事前に <code class=\"docutils literal notranslate\">set_test_cookie()</code> または <code class=\"docutils literal notranslate\">aset_test_cookie()</code> を呼び出す必要があります。詳細は、以下の <a class=\"reference internal\" href=\"#setting-test-cookies\">Setting test cookies</a> を参照してください。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">atest_cookie_worked()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.delete_test_cookie\">\n<span class=\"sig-name descname\">delete_test_cookie</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.delete_test_cookie\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.adelete_test_cookie\">\n<span class=\"sig-name descname\">adelete_test_cookie</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.adelete_test_cookie\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">adelete_test_cookie()</code></p>\n<p>テストクッキーを削除します。クッキーをきれいにしておくために使ってください。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">adelete_test_cookie()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.get_session_cookie_age\">\n<span class=\"sig-name descname\">get_session_cookie_age</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.get_session_cookie_age\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_AGE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_AGE</code></a> の設定値を返します。これはカスタム セッション バックエンドで上書きできます。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.set_expiry\">\n<span class=\"sig-name descname\">set_expiry</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">value</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.set_expiry\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aset_expiry\">\n<span class=\"sig-name descname\">aset_expiry</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">value</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aset_expiry\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aset_expiry()</code></p>\n<p>セッションの有効期限を設定します。以下に挙げるようなさまざまな値を与えることができます。</p>\n<ul class=\"simple\">\n<li><p>もし <code class=\"docutils literal notranslate\">value</code> が整数なら、与えられた秒数だけ活動がなかった時にセッションを破棄します。たとえば、<code class=\"docutils literal notranslate\">request.session.set_expiry(300)</code> と呼び出せば、5分後にセッションを破棄するように設定できます。</p></li>\n<li><p>もし <code class=\"docutils literal notranslate\">value</code> が <code class=\"docutils literal notranslate\">datetime</code> または <code class=\"docutils literal notranslate\">timedelta</code> オブジェクトであれば、セッションはその日時で終了します。</p></li>\n<li><p>もし <code class=\"docutils literal notranslate\">value</code> が <code class=\"docutils literal notranslate\">0</code> ならば、ユーザのセッションクッキーは、ユーザがウェブブラウザを閉じた時に破棄されます。</p></li>\n<li><p>もし <code class=\"docutils literal notranslate\">value</code> が <code class=\"docutils literal notranslate\">None</code> ならば、セッションはグローバルなセッション有効期限ポリシーにしたがって扱われます。</p></li>\n</ul>\n<p>セッションの読み込みを行っても、有効期限は延長されません。セッションの有効期限は、セッションが最後に <em>修正された</em> 時点を基に計算されます。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aset_expiry()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.get_expiry_age\">\n<span class=\"sig-name descname\">get_expiry_age</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.get_expiry_age\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aget_expiry_age\">\n<span class=\"sig-name descname\">aget_expiry_age</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aget_expiry_age\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aget_expiry_age()</code></p>\n<p>このセッションの有効期限までの残りの秒数を返します。カスタムの有効期限を持たない (または、ブラウザを閉じた時とセットした) セッションの場合、この値は <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_AGE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_AGE</code></a> と等しいです。</p>\n<p>この関数は 2 つの省略可能なキーワード引数を取ることができます。</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">modification</code>: セッションを最後に修正した時刻を <a class=\"reference external\" href=\"https://docs.python.org/3/library/datetime.html#datetime.datetime\" title=\"(in Python v3.14)\"><code class=\"xref py py-class docutils literal notranslate\">datetime</code></a> オブジェクトとして与える。デフォルトは現在の時刻。</p></li>\n<li><p><code class=\"docutils literal notranslate\">expiry</code>: セッションの有効期限情報を指定します。<a class=\"reference external\" href=\"https://docs.python.org/3/library/datetime.html#datetime.datetime\" title=\"(in Python v3.14)\"><code class=\"xref py py-class docutils literal notranslate\">datetime</code></a> オブジェクト、<a class=\"reference external\" href=\"https://docs.python.org/3/library/functions.html#int\" title=\"(in Python v3.14)\"><code class=\"xref py py-class docutils literal notranslate\">int</code></a> （秒単位）、または <code class=\"docutils literal notranslate\">None</code> を使用できます。デフォルトでは、<a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.set_expiry\" title=\"django.contrib.sessions.backends.base.SessionBase.set_expiry\"><code class=\"xref py py-meth docutils literal notranslate\">set_expiry()</code></a> / <a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.aset_expiry\" title=\"django.contrib.sessions.backends.base.SessionBase.aset_expiry\"><code class=\"xref py py-meth docutils literal notranslate\">aset_expiry()</code></a> によってセッションに保存された値（存在する場合）か、<code class=\"docutils literal notranslate\">None</code> になります。</p></li>\n</ul>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">注釈</p>\n<p>このメソッドは、セッションを保存する際にセッションの有効期限を秒単位で決定するためにセッションバックエンドで使用されます。このようなコンテキスト以外での使用は想定していません。</p>\n<p>特に、正しい <code class=\"docutils literal notranslate\">modification</code> 値があり、 <strong>かつ</strong> <code class=\"docutils literal notranslate\">expiry</code> が <code class=\"docutils literal notranslate\">datetime</code> オブジェクトとしてセットされている場合にのみ、セッションの残り寿命を決定することが <strong>可能</strong> ですが、 <code class=\"docutils literal notranslate\">modification</code> 値を持っている場合、有効期限を手動で計算する方がより直接的です:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>expires_at <span class=\"o\">=</span> modification <span class=\"o\">+</span> timedelta<span class=\"p\">(</span>seconds<span class=\"o\">=</span>settings<span class=\"o\">.</span>SESSION_COOKIE_AGE<span class=\"p\">)</span>\n</code></pre></div>\n</aside>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aget_expiry_age()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.get_expiry_date\">\n<span class=\"sig-name descname\">get_expiry_date</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.get_expiry_date\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aget_expiry_date\">\n<span class=\"sig-name descname\">aget_expiry_date</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aget_expiry_date\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aget_expiry_date()</code></p>\n<p>このセッションが破棄される日付を返します。カスタムの有効期限を持たない (または、ブラウザを閉じた時とセットした) セッションに対しては、現在時刻から <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_AGE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_AGE</code></a> の秒数までの日付に等しいです。</p>\n<p>この関数は、<a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.get_expiry_age\" title=\"django.contrib.sessions.backends.base.SessionBase.get_expiry_age\"><code class=\"xref py py-meth docutils literal notranslate\">get_expiry_age()</code></a> と同じキーワード引数を取ることができ、使用の際の注意点も同じです。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aget_expiry_date()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.get_expire_at_browser_close\">\n<span class=\"sig-name descname\">get_expire_at_browser_close</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.get_expire_at_browser_close\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aget_expire_at_browser_close\">\n<span class=\"sig-name descname\">aget_expire_at_browser_close</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aget_expire_at_browser_close\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aget_expire_at_browser_close()</code></p>\n<p>ユーザのセッションクッキーがユーザのブラウザが閉じた時に破棄されるかどうかに応じて、<code class=\"docutils literal notranslate\">True</code> または <code class=\"docutils literal notranslate\">False</code> を返します。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aget_expire_at_browser_close()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.clear_expired\">\n<span class=\"sig-name descname\">clear_expired</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.clear_expired\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.aclear_expired\">\n<span class=\"sig-name descname\">aclear_expired</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.aclear_expired\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">aclear_expired()</code></p>\n<p>保存されているセッションから、有効期限が切れているものを削除します。このクラスメソッドは、<a class=\"reference internal\" href=\"/ja/5.1/ref/django-admin/#django-admin-clearsessions\"><code class=\"xref std std-djadmin docutils literal notranslate\">clearsessions</code></a> から呼び出されます。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aclear_expired()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.cycle_key\">\n<span class=\"sig-name descname\">cycle_key</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.cycle_key\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.base.SessionBase.acycle_key\">\n<span class=\"sig-name descname\">acycle_key</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.base.SessionBase.acycle_key\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><em>非同期バージョン</em>: <code class=\"docutils literal notranslate\">acycle_key()</code></p>\n<p>現在のセッションデータを保持したまま、新しいセッションキーを作成します。<a class=\"reference internal\" href=\"/ja/5.1/topics/auth/default/#django.contrib.auth.login\" title=\"django.contrib.auth.login\"><code class=\"xref py py-func docutils literal notranslate\">django.contrib.auth.login()</code></a> は、このメソッドを呼び出すことで、過去のセッションを継続できるようにしています。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">acycle_key()</code> 関数が追加されました。</p>\n</aside>\n</dd></dl>\n\n</dd></dl>\n\n<section id=\"session-serialization\">\n<span id=\"id1\"></span><h3>セッションのシリアライズ<a class=\"heading-anchor\" href=\"#session-serialization\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>デフォルトでは、Django はセッションデータを JSON を用いてシリアライズします。設定ファイルの <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_SERIALIZER\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_SERIALIZER</code></a> に設定すれば、セッションをシリアライズするフォーマットをカスカムできます。 <a class=\"reference internal\" href=\"#custom-serializers\"><span class=\"std std-ref\">自作のシリアライザを書く</span></a> に書いた注意書きの通り、JSON によるシリアライズを強く推奨します。 <em>クッキーバックエンドを利用している場合は特に</em> です。</p>\n<p>たとえば、セッションデータをシリアライズするために <a class=\"reference external\" href=\"https://docs.python.org/3/library/pickle.html#module-pickle\" title=\"(in Python v3.14)\"><code class=\"xref py py-mod docutils literal notranslate\">pickle</code></a> を使用していた場合の、こんな攻撃のシナリオを考えてみましょう。あなたは <a class=\"reference internal\" href=\"#cookie-session-backend\"><span class=\"std std-ref\">署名したクッキーセッションバックエンド</span></a> を使用していて、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SECRET_KEY\"><code class=\"xref std std-setting docutils literal notranslate\">SECRET_KEY</code></a> (または <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SECRET_KEY_FALLBACKS\"><code class=\"xref std std-setting docutils literal notranslate\">SECRET_KEY_FALLBACKS</code></a> の任意のキー) が攻撃者に知られてしまっていたとします (もちろん、これは Django にキーが流出する脆弱性が内在しているというわけではありません)。この時、攻撃者は、セッションに任意の文字列を挿入することができてしまい、このセッションを unpickle すると、サーバ上で任意のコードが実行されてしまいます。このような攻撃は、インターネット上のどこからでも簡単にできてしまいます。クッキーセッションストレージは、クッキーに保存されているデータが勝手に書き換えられないようにクッキーに署名をしていますが、 <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SECRET_KEY\"><code class=\"xref std std-setting docutils literal notranslate\">SECRET_KEY</code></a> が流出するだけで、リモートからコードを実行されてしまう脆弱性が生まれてしまうのです。</p>\n<section id=\"bundled-serializers\">\n<h4>バンドルされているシリアライザ<a class=\"heading-anchor\" href=\"#bundled-serializers\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.serializers.JSONSerializer\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-prename descclassname\">serializers.</span><span class=\"sig-name descname\">JSONSerializer</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.serializers.JSONSerializer\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><a class=\"reference internal\" href=\"/ja/5.1/topics/signing/#module-django.core.signing\" title=\"django.core.signing: Django's signing framework.\"><code class=\"xref py py-mod docutils literal notranslate\">django.core.signing</code></a> の JSON シリアライザのラッパーです。基本的なデータ型だけがシリアライズ可能です。</p>\n<p>また、JSON は文字列のキーしかサポートしていないので、<code class=\"docutils literal notranslate\">request.session</code> に文字列以外のキーを使用してしまうと、次のように期待通りに動いてくれません。</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"c1\"># initial assignment</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>request<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"mi\">0</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;bar&quot;</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"c1\"># subsequent requests following serialization &amp; deserialization</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"c1\"># of session data</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>request<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"mi\">0</span><span class=\"p\">]</span>  <span class=\"c1\"># KeyError</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>request<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;0&quot;</span><span class=\"p\">]</span>\n<span class=\"go\">&#39;bar&#39;</span>\n</code></pre></div>\n<p>同様に、 <code class=\"docutils literal notranslate\">'\\xd9'</code> のような UTF-8 以外のバイトなど、JSONでエンコードできないデータは保存できません（これは <a class=\"reference external\" href=\"https://docs.python.org/3/library/exceptions.html#UnicodeDecodeError\" title=\"(in Python v3.14)\"><code class=\"xref py py-exc docutils literal notranslate\">UnicodeDecodeError</code></a> を発生させます）。</p>\n<p>JSON によるシリアライズの制限について詳しくは、<a class=\"reference internal\" href=\"#custom-serializers\"><span class=\"std std-ref\">自作のシリアライザを書く</span></a> セクションを読んでください。</p>\n</dd></dl>\n\n</section>\n<section id=\"write-your-own-serializer\">\n<span id=\"custom-serializers\"></span><h4>自作のシリアライザを書く<a class=\"heading-anchor\" href=\"#write-your-own-serializer\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<p><a class=\"reference internal\" href=\"#django.contrib.sessions.serializers.JSONSerializer\" title=\"django.contrib.sessions.serializers.JSONSerializer\"><code class=\"xref py py-class docutils literal notranslate\">JSONSerializer</code></a> では、任意の Python データ型を扱うことができません。よくあることですが、利便性とセキュリティはトレード・オフの関係にあります。JSON を使ったセッション内に <code class=\"docutils literal notranslate\">datetime</code> や <code class=\"docutils literal notranslate\">Decimal</code> といった、より高度なデータ型を保存したければ、カスタムのシリアライザを書く (か、<code class=\"docutils literal notranslate\">request.session</code> に保存する前に、あらかじめその値を JSON でシリアライズ可能なオブジェクトに変換しておく) 必要があります。これらの値をシリアライズするのは全然難しくありません (<a class=\"reference internal\" href=\"/ja/5.1/topics/serialization/#django.core.serializers.json.DjangoJSONEncoder\" title=\"django.core.serializers.json.DjangoJSONEncoder\"><code class=\"xref py py-class docutils literal notranslate\">DjangoJSONEncoder</code></a> が役に立つかも知れません) が、シリアライズしたオブジェクトと全く同じデータを再取得できる信頼性の高いデコーダを書く方は、もう少し難しい仕事になります。たとえば、本当は文字列であるにも関わらず、たまたま <code class=\"docutils literal notranslate\">datetime</code> を表現するのと全く同じフォーマットの文字列に出会うという可能性があります。</p>\n<p>シリアライザのクラスは、必ず次の2つのメソッドを実装しなければなりません。セッションデータのディクショナリをシリアライズする <code class=\"docutils literal notranslate\">dumps(self, obj)</code> と、それをデシリアライズする <code class=\"docutils literal notranslate\">loads(self, data)</code> の2つです。</p>\n</section>\n</section>\n<section id=\"session-object-guidelines\">\n<h3>セッションオブジェクトのガイドライン<a class=\"heading-anchor\" href=\"#session-object-guidelines\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<ul class=\"simple\">\n<li><p>Python の普通の文字列を、<code class=\"docutils literal notranslate\">request.session</code> におけるディクショナリのキーとして使うこと。これは慣習のためというよりも、確実で高速にするためのルールです。</p></li>\n<li><p>セッションのディクショナリのキーで、アンダースコアで始まるキーは、Django が内部で使用するために予約されているものと考えること。</p></li>\n<li><p><code class=\"docutils literal notranslate\">request.session</code> を新しいオブジェクトで上書きせず、その属性にアクセスしたり、値をセットしたりしないこと。Python のディクショナリのように扱うこと。</p></li>\n</ul>\n</section>\n<section id=\"examples\">\n<h3>例<a class=\"heading-anchor\" href=\"#examples\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>次の簡単なビューは、ユーザがコメントを投稿した後で、<code class=\"docutils literal notranslate\">has_commented</code> 変数を <code class=\"docutils literal notranslate\">True</code> に設定します。こうすることで、同じユーザが2回以上コメントできないようにすることができます。</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">def</span> <span class=\"nf\">post_comment</span><span class=\"p\">(</span>request<span class=\"p\">,</span> new_comment<span class=\"p\">):</span>\n    <span class=\"k\">if</span> request<span class=\"o\">.</span>session<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"s2\">&quot;has_commented&quot;</span><span class=\"p\">,</span> <span class=\"kc\">False</span><span class=\"p\">):</span>\n        <span class=\"k\">return</span> HttpResponse<span class=\"p\">(</span><span class=\"s2\">&quot;You&#39;ve already commented.&quot;</span><span class=\"p\">)</span>\n    c <span class=\"o\">=</span> comments<span class=\"o\">.</span>Comment<span class=\"p\">(</span>comment<span class=\"o\">=</span>new_comment<span class=\"p\">)</span>\n    c<span class=\"o\">.</span>save<span class=\"p\">()</span>\n    request<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;has_commented&quot;</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"kc\">True</span>\n    <span class=\"k\">return</span> HttpResponse<span class=\"p\">(</span><span class=\"s2\">&quot;Thanks for your comment!&quot;</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>次の次の簡単なビューでは、サイトの「メンバー (member)」にログインする手続きを行います。</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">def</span> <span class=\"nf\">login</span><span class=\"p\">(</span>request<span class=\"p\">):</span>\n    m <span class=\"o\">=</span> Member<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span>username<span class=\"o\">=</span>request<span class=\"o\">.</span>POST<span class=\"p\">[</span><span class=\"s2\">&quot;username&quot;</span><span class=\"p\">])</span>\n    <span class=\"k\">if</span> m<span class=\"o\">.</span>check_password<span class=\"p\">(</span>request<span class=\"o\">.</span>POST<span class=\"p\">[</span><span class=\"s2\">&quot;password&quot;</span><span class=\"p\">]):</span>\n        request<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;member_id&quot;</span><span class=\"p\">]</span> <span class=\"o\">=</span> m<span class=\"o\">.</span>id\n        <span class=\"k\">return</span> HttpResponse<span class=\"p\">(</span><span class=\"s2\">&quot;You&#39;re logged in.&quot;</span><span class=\"p\">)</span>\n    <span class=\"k\">else</span><span class=\"p\">:</span>\n        <span class=\"k\">return</span> HttpResponse<span class=\"p\">(</span><span class=\"s2\">&quot;Your username and password didn&#39;t match.&quot;</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>そして、次の例では、上の <code class=\"docutils literal notranslate\">login()</code> に対応するメンバーのログアウト処理を行います。</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">def</span> <span class=\"nf\">logout</span><span class=\"p\">(</span>request<span class=\"p\">):</span>\n    <span class=\"k\">try</span><span class=\"p\">:</span>\n        <span class=\"k\">del</span> request<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;member_id&quot;</span><span class=\"p\">]</span>\n    <span class=\"k\">except</span> <span class=\"ne\">KeyError</span><span class=\"p\">:</span>\n        <span class=\"k\">pass</span>\n    <span class=\"k\">return</span> HttpResponse<span class=\"p\">(</span><span class=\"s2\">&quot;You&#39;re logged out.&quot;</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>ふつう実際に使われる <a class=\"reference internal\" href=\"/ja/5.1/topics/auth/default/#django.contrib.auth.logout\" title=\"django.contrib.auth.logout\"><code class=\"xref py py-meth docutils literal notranslate\">django.contrib.auth.logout()</code></a> 関数では、データの意図しない漏洩を防ぐために、この例より少し複雑な処理、<code class=\"docutils literal notranslate\">request.session</code> の <a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.flush\" title=\"django.contrib.sessions.backends.base.SessionBase.flush\"><code class=\"xref py py-meth docutils literal notranslate\">flush()</code></a> メソッドを呼び出すなどの処理を行っています。ここで挙げた例は、単にセッションオブジェクトの振る舞いをデモンストレーションすることが目的なので、完全ではない <code class=\"docutils literal notranslate\">logout()</code> を実装しました。</p>\n</section>\n</section>\n<section id=\"setting-test-cookies\">\n<h2>テストクッキーを設定する<a class=\"heading-anchor\" href=\"#setting-test-cookies\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>利便性のため、Django はユーザのブラウザがクッキーを受け入れることができるかどうかをテストするための方法を提供しています。テストをするには、一度ビューの中で <code class=\"docutils literal notranslate\">request.session</code> の <a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.set_test_cookie\" title=\"django.contrib.sessions.backends.base.SessionBase.set_test_cookie\"><code class=\"xref py py-meth docutils literal notranslate\">set_test_cookie()</code></a> メソッドを呼び出してから、同じビューではなく、次に呼び出されるビューの中で、 <a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.test_cookie_worked\" title=\"django.contrib.sessions.backends.base.SessionBase.test_cookie_worked\"><code class=\"xref py py-meth docutils literal notranslate\">test_cookie_worked()</code></a> メソッドを呼び出します。</p>\n<p>このように <code class=\"docutils literal notranslate\">set_test_cookie()</code> と <code class=\"docutils literal notranslate\">test_cookie_worked()</code> を分離しなければならないのはちょっと気持ち悪いですが、クッキーの動作原理により、こうするより仕方がないのです。一度ブラウザにクッキーを設定しても、そのクッキーがブラウザに保存されたかどうかを確認するには、ブラウザがもう一度リクエストを行わなければならないからです。</p>\n<p>テストクッキーがちゃんと機能していることを確認できたら、<a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.delete_test_cookie\" title=\"django.contrib.sessions.backends.base.SessionBase.delete_test_cookie\"><code class=\"xref py py-meth docutils literal notranslate\">delete_test_cookie()</code></a> を使ってセッションをきれいにしておくことにしましょう。</p>\n<p>以下に、テストクッキーの典型的な使用例を挙げます。</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span> <span class=\"nn\">django.http</span> <span class=\"kn\">import</span> HttpResponse\n<span class=\"kn\">from</span> <span class=\"nn\">django.shortcuts</span> <span class=\"kn\">import</span> render\n\n\n<span class=\"k\">def</span> <span class=\"nf\">login</span><span class=\"p\">(</span>request<span class=\"p\">):</span>\n    <span class=\"k\">if</span> request<span class=\"o\">.</span>method <span class=\"o\">==</span> <span class=\"s2\">&quot;POST&quot;</span><span class=\"p\">:</span>\n        <span class=\"k\">if</span> request<span class=\"o\">.</span>session<span class=\"o\">.</span>test_cookie_worked<span class=\"p\">():</span>\n            request<span class=\"o\">.</span>session<span class=\"o\">.</span>delete_test_cookie<span class=\"p\">()</span>\n            <span class=\"k\">return</span> HttpResponse<span class=\"p\">(</span><span class=\"s2\">&quot;You&#39;re logged in.&quot;</span><span class=\"p\">)</span>\n        <span class=\"k\">else</span><span class=\"p\">:</span>\n            <span class=\"k\">return</span> HttpResponse<span class=\"p\">(</span><span class=\"s2\">&quot;Please enable cookies and try again.&quot;</span><span class=\"p\">)</span>\n    request<span class=\"o\">.</span>session<span class=\"o\">.</span>set_test_cookie<span class=\"p\">()</span>\n    <span class=\"k\">return</span> render<span class=\"p\">(</span>request<span class=\"p\">,</span> <span class=\"s2\">&quot;foo/login_form.html&quot;</span><span class=\"p\">)</span>\n</code></pre></div>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p>非同期ビュー関数でテストクッキーを設定する機能が追加されました。</p>\n</aside>\n</section>\n<section id=\"using-sessions-out-of-views\">\n<h2>ビューの外でセッションを使う<a class=\"heading-anchor\" href=\"#using-sessions-out-of-views\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">注釈</p>\n<p>このセクションの例では、<code class=\"docutils literal notranslate\">SessionStore</code> オブジェクトを直接 <code class=\"docutils literal notranslate\">django.contrib.sessions.backends.db</code> バックエンドからインポートしています。しかし、実際に自分でコートを書く場合には、以下のようにして、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_ENGINE</code></a> が指すセッションエンジンから <code class=\"docutils literal notranslate\">SessionStore</code> をインポートすることを考えるべきです。</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">importlib</span> <span class=\"kn\">import</span> import_module\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">django.conf</span> <span class=\"kn\">import</span> settings\n<span class=\"gp\">&gt;&gt;&gt; </span>SessionStore <span class=\"o\">=</span> import_module<span class=\"p\">(</span>settings<span class=\"o\">.</span>SESSION_ENGINE<span class=\"p\">)</span><span class=\"o\">.</span>SessionStore\n</code></pre></div>\n</aside>\n<p>次のようにして、ビューの外からセッションデータを操作する API が利用可能です。</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.sessions.backends.db</span> <span class=\"kn\">import</span> SessionStore\n<span class=\"gp\">&gt;&gt;&gt; </span>s <span class=\"o\">=</span> SessionStore<span class=\"p\">()</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"c1\"># stored as seconds since epoch since datetimes are not serializable in JSON.</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>s<span class=\"p\">[</span><span class=\"s2\">&quot;last_login&quot;</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"mi\">1376587691</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>s<span class=\"o\">.</span>create<span class=\"p\">()</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>s<span class=\"o\">.</span>session_key\n<span class=\"go\">&#39;2b1189a188b44ad18c35e113ac6ceead&#39;</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>s <span class=\"o\">=</span> SessionStore<span class=\"p\">(</span>session_key<span class=\"o\">=</span><span class=\"s2\">&quot;2b1189a188b44ad18c35e113ac6ceead&quot;</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>s<span class=\"p\">[</span><span class=\"s2\">&quot;last_login&quot;</span><span class=\"p\">]</span>\n<span class=\"go\">1376587691</span>\n</code></pre></div>\n<p><code class=\"docutils literal notranslate\">SessionStore.create()</code> は新しいセッション(つまりセッションストアから読み込まれていない、<code class=\"docutils literal notranslate\">session_key=None</code> のセッション)を作成するためのものです。<code class=\"docutils literal notranslate\">save()</code> は既存のセッションを保存するために設計されています（つまり、セッションストアから読み込まれたもの）。新しいセッションに対して <code class=\"docutils literal notranslate\">save()</code> を呼び出すこともできますが、既存のセッションと <code class=\"docutils literal notranslate\">session_key</code> が衝突する可能性があります。 <code class=\"docutils literal notranslate\">create()</code> は <code class=\"docutils literal notranslate\">save()</code> を呼び出し、使用されていない <code class=\"docutils literal notranslate\">session_key</code> が生成されるまでループします。</p>\n<p><code class=\"docutils literal notranslate\">django.contrib.sessions.backends.db</code> バックエンドを使用している場合、各セッションは単なる Django のモデルになっていて、<code class=\"docutils literal notranslate\">Session</code> モデルは <a class=\"extlink-source reference external\" href=\"https://github.com/django/django/blob/stable/5.1.x/django/contrib/sessions/models.py\">django/contrib/sessions/models.py</a> で定義されています。普通のモデルにすぎないので、普通の Django データベース API からセッションにアクセスできます。</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.sessions.models</span> <span class=\"kn\">import</span> Session\n<span class=\"gp\">&gt;&gt;&gt; </span>s <span class=\"o\">=</span> Session<span class=\"o\">.</span>objects<span class=\"o\">.</span>get<span class=\"p\">(</span>pk<span class=\"o\">=</span><span class=\"s2\">&quot;2b1189a188b44ad18c35e113ac6ceead&quot;</span><span class=\"p\">)</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>s<span class=\"o\">.</span>expire_date\n<span class=\"go\">datetime.datetime(2005, 8, 20, 13, 35, 12)</span>\n</code></pre></div>\n<p>セッションのディクショナリを取得するには、<a class=\"reference internal\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession.get_decoded\" title=\"django.contrib.sessions.base_session.AbstractBaseSession.get_decoded\"><code class=\"xref py py-meth docutils literal notranslate\">get_decoded()</code></a> を呼ばなければならないことに注意してください。これが必要なのは、ディクショナリがエンコードされたフォーマットで保存されているためです。</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span>s<span class=\"o\">.</span>session_data\n<span class=\"go\">&#39;KGRwMQpTJ19hdXRoX3VzZXJfaWQnCnAyCkkxCnMuMTExY2ZjODI2Yj...&#39;</span>\n<span class=\"gp\">&gt;&gt;&gt; </span>s<span class=\"o\">.</span>get_decoded<span class=\"p\">()</span>\n<span class=\"go\">{&#39;user_id&#39;: 42}</span>\n</code></pre></div>\n</section>\n<section id=\"when-sessions-are-saved\">\n<h2>セッションが保存されるタイミング<a class=\"heading-anchor\" href=\"#when-sessions-are-saved\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>デフォルトでは、Django がセッションデータベースへデータを保存するのは、セッションが修正された時だけ、つまり、ディクショナリ直下の値が代入または削除された時だけです。</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"c1\"># Session is modified.</span>\nrequest<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;foo&quot;</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;bar&quot;</span>\n\n<span class=\"c1\"># Session is modified.</span>\n<span class=\"k\">del</span> request<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;foo&quot;</span><span class=\"p\">]</span>\n\n<span class=\"c1\"># Session is modified.</span>\nrequest<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;foo&quot;</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"p\">{}</span>\n\n<span class=\"c1\"># Gotcha: Session is NOT modified, because this alters</span>\n<span class=\"c1\"># request.session[&#39;foo&#39;] instead of request.session.</span>\nrequest<span class=\"o\">.</span>session<span class=\"p\">[</span><span class=\"s2\">&quot;foo&quot;</span><span class=\"p\">][</span><span class=\"s2\">&quot;bar&quot;</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;baz&quot;</span>\n</code></pre></div>\n<p>上の例の場合、セッションオブジェクトに修正したことを明示的に伝えるためには、<code class=\"docutils literal notranslate\">modified</code> 属性を設定すれば良いです。</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>request<span class=\"o\">.</span>session<span class=\"o\">.</span>modified <span class=\"o\">=</span> <span class=\"kc\">True</span>\n</code></pre></div>\n<p>このデフォルトの動作を変更するには、設定ファイルの <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_SAVE_EVERY_REQUEST\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_SAVE_EVERY_REQUEST</code></a> を <code class=\"docutils literal notranslate\">True</code> に設定します。<code class=\"docutils literal notranslate\">True</code> に設定すると、Django は1リクエストごとに、セッションをデータベースに保存してくれるようになります。</p>\n<p>セッションクッキーが送信されるのは、セッションの作成及び修正時のみであることに注意してください。<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_SAVE_EVERY_REQUEST\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_SAVE_EVERY_REQUEST</code></a> を <code class=\"docutils literal notranslate\">True</code> に設定すると、各リクエストごとにセッションクッキーが送信されるようになります。</p>\n<p>同時に、セッションクッキーの <code class=\"docutils literal notranslate\">expires</code> 部分も、セッションクッキーが送信されるごとに更新されます。</p>\n<p>レスポンスステータスコードが 500 の時には、セッションは保存されません。</p>\n</section>\n<section id=\"browser-length-sessions-vs-persistent-sessions\">\n<span id=\"browser-length-vs-persistent-sessions\"></span><h2>ブラウザ起動中のみ有効なセッション vs. 永続的なセッション<a class=\"heading-anchor\" href=\"#browser-length-sessions-vs-persistent-sessions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_EXPIRE_AT_BROWSER_CLOSE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_EXPIRE_AT_BROWSER_CLOSE</code></a> 設定を使うと、セッションフレームワークが、ブラウザ起動中のみ有効なセッションと永続的なセッションのどちらを使うか設定できます。</p>\n<p>デフォルトでは、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_EXPIRE_AT_BROWSER_CLOSE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_EXPIRE_AT_BROWSER_CLOSE</code></a> は <code class=\"docutils literal notranslate\">False</code> にセットされていて、セッションクッキーは <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_AGE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_AGE</code></a> の期間ユーザのブラウザに保持されます。これにより、ユーザはブラウザを開くたびにログインし直さずに済みます。</p>\n<p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_EXPIRE_AT_BROWSER_CLOSE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_EXPIRE_AT_BROWSER_CLOSE</code></a> を <code class=\"docutils literal notranslate\">True</code> に設定すると、Django はブラウザ起動中のみ有効なクッキーを使用します。このクッキーは、ブラウザを閉じた瞬間に破棄されます。ユーザがブラウザを開くたびにログインするようにしたい場合には、この設定を利用してください。</p>\n<p>この設定はグローバルなデフォルトですが、1セッションごとのレベルで設定を上書きできます。その場合には、上の <a class=\"reference internal\" href=\"#using-sessions-in-views\">using sessions in views</a> で書いたようにして、<code class=\"docutils literal notranslate\">request.session</code> の <a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.set_expiry\" title=\"django.contrib.sessions.backends.base.SessionBase.set_expiry\"><code class=\"xref py py-meth docutils literal notranslate\">set_expiry()</code></a> メソッドを呼び出してください。</p>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">注釈</p>\n<p>一部のブラウザ (たとえば Chrome) では、ブラウザを閉じて再度開いてもセッションを継続できるようにする設定が提供されています。場合によっては、この設定が <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_EXPIRE_AT_BROWSER_CLOSE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_EXPIRE_AT_BROWSER_CLOSE</code></a> 設定を妨げて、ブラウザが閉じてもセションが破棄されないことがあります。<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_EXPIRE_AT_BROWSER_CLOSE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_EXPIRE_AT_BROWSER_CLOSE</code></a> を有効にした Django アプリケーションのテストをする時には、この点に注意してください。</p>\n</aside>\n</section>\n<section id=\"clearing-the-session-store\">\n<span id=\"id2\"></span><h2>セッションストアのクリア<a class=\"heading-anchor\" href=\"#clearing-the-session-store\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>ユーザがウェブサイトで新しいセッションを作成した時、セッションデータはセッションストアに溜め込まれます。データベースのバックエンドを使っている場合には、<code class=\"docutils literal notranslate\">django_session</code> データベーステーブルが増大し、ファイルバックエンドを使っている場合には、一時ディレクトリのファイル数が増えてゆくでしょう。</p>\n<p>この問題を理解するには、データベースバックエンドで起きていることを考えてみてください。ユーザがログインすると、Django は <code class=\"docutils literal notranslate\">django_session</code> データベースのテーブルに1行を追加します。Django はセッションのデータが変更されるたびに、この行を更新します。ユーザが手動でログアウトすると、Django はこの行を削除します。しかし、ユーザがログアウト <em>しなかった</em> 場合には、この行は決して削除されません。同様のプロセスが、ファイルバックエンドの場合にも発生します。</p>\n<p>Django は、有効期限の切れたセッションを自動的に削除する機能を提供 <em>しません</em> 。したがって、定期的に有効期限の切れたセッションを削除する仕事は、開発者の手に委ねられています。Django はこの目的のために、クリーンナップ用の管理コマンド <a class=\"reference internal\" href=\"/ja/5.1/ref/django-admin/#django-admin-clearsessions\"><code class=\"xref std std-djadmin docutils literal notranslate\">clearsessions</code></a> を用意しています。たとえば、cron の毎日のジョブに追加するなどの方法で、定期的にこのコマンドを実行することが推奨されています。</p>\n<p>キャッシュバックエンドの場合はこの問題が発生しないことに注意してください。キャッシュの場合、不要なデータは自動的に削除されるようになっているからです。しかし、クッキーバックエンドの場合はそうではありません。セッションデータはユーザのブラウザに保存されるからです。</p>\n</section>\n<section id=\"settings\">\n<h2>設定<a class=\"heading-anchor\" href=\"#settings\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>以下の <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#settings-sessions\"><span class=\"std std-ref\">Django の設定</span></a> を使うと、セッションの動作をコントロールできます。</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_CACHE_ALIAS\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_CACHE_ALIAS</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_AGE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_AGE</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_DOMAIN\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_DOMAIN</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_HTTPONLY\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_HTTPONLY</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_NAME\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_NAME</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_PATH\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_PATH</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_SAMESITE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_SAMESITE</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_SECURE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_SECURE</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_ENGINE</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_EXPIRE_AT_BROWSER_CLOSE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_EXPIRE_AT_BROWSER_CLOSE</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_FILE_PATH\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_FILE_PATH</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_SAVE_EVERY_REQUEST\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_SAVE_EVERY_REQUEST</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_SERIALIZER\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_SERIALIZER</code></a></p></li>\n</ul>\n</section>\n<section id=\"session-security\">\n<span id=\"topics-session-security\"></span><h2>セッションのセキュリティ<a class=\"heading-anchor\" href=\"#session-security\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>サイトのサブドメインからは、クライアントに対して、ドメイン全体に対するクッキーを設定できます。信頼できるユーザに管理されていないサブドメインから送られたクッキーを許可している場合、この方法でセッションの固定化 (session fixation) 攻撃が可能になってしまいます。</p>\n<p>たとえば、攻撃者が <code class=\"docutils literal notranslate\">good.example.com</code> にログインして、攻撃者のアカウントに対する有効なセッションを取得したとしましょう。この攻撃者が <code class=\"docutils literal notranslate\">bad.example.com</code> を自由に使えた場合、サブドメインからは <code class=\"docutils literal notranslate\">*.example.com</code> に対してクッキーを設定できるので、先ほど取得したセッションを利用して、攻撃者のセッションキーをターゲットの利用者に送信できてしまいます。次にこの利用者が <code class=\"docutils literal notranslate\">good.example.com</code> を訪問すると、この利用者は攻撃者のアカウントにログインすることになり、そのことに気付かずに大切な個人のデータ (たとえば、クレジットカード情報など) を攻撃者のアカウントに入力してしまう恐れがあります。</p>\n<p>もう一つ考えられる攻撃は、<code class=\"docutils literal notranslate\">good.example.com</code> というサイトが <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_COOKIE_DOMAIN\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_COOKIE_DOMAIN</code></a> を <code class=\"docutils literal notranslate\">&quot;example.com&quot;</code> に設定していた場合に、そのサイトのセッションクッキーが <code class=\"docutils literal notranslate\">bad.example.com</code> に送信されてしまう、というものです。</p>\n</section>\n<section id=\"technical-details\">\n<h2>技術的な詳細<a class=\"heading-anchor\" href=\"#technical-details\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<ul class=\"simple\">\n<li><p>セッション辞書は、<a class=\"reference internal\" href=\"#django.contrib.sessions.serializers.JSONSerializer\" title=\"django.contrib.sessions.serializers.JSONSerializer\"><code class=\"xref py py-class docutils literal notranslate\">JSONSerializer</code></a> を使用する場合、任意の <a class=\"reference external\" href=\"https://docs.python.org/3/library/json.html#module-json\" title=\"(in Python v3.14)\"><code class=\"xref py py-mod docutils literal notranslate\">json</code></a> シリアライズ可能な値を受け入れます。</p></li>\n<li><p>セッションデータは、データベースの <code class=\"docutils literal notranslate\">django_session</code> という名前のテーブルに保存されます。</p></li>\n<li><p>Django は必要なときにだけクッキーを送信します。新しくセッションデータを設定しなければ、Django はセッションクッキーを送信しません。</p></li>\n</ul>\n<section id=\"the-sessionstore-object\">\n<h3><code class=\"docutils literal notranslate\">SessionStore</code> オブジェクト<a class=\"heading-anchor\" href=\"#the-sessionstore-object\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Django が内部でセッションを操作する時は、対応するセッションエンジンの session store オブジェクトを使用します。慣習により、session store オブジェクトは <code class=\"docutils literal notranslate\">SessionStore</code> と名付けられていて、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-SESSION_ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\">SESSION_ENGINE</code></a> で指定したモジュール内に置かれています。</p>\n<p>Django で利用可能なすべての <code class=\"docutils literal notranslate\">SessionStore</code> のサブクラスは、以下のデータ操作メソッドを実装しています。</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">exists()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">create()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">save()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">delete()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">load()</code></p></li>\n<li><p><a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.clear_expired\" title=\"django.contrib.sessions.backends.base.SessionBase.clear_expired\"><code class=\"xref py py-meth docutils literal notranslate\">clear_expired()</code></a></p></li>\n</ul>\n<p>これらのメソッドに対する非同期インターフェースは、<code class=\"docutils literal notranslate\">sync_to_async()</code> でラップすることで提供されます。また、非同期ネイティブな実装が利用可能な場合は、以下の関数をダイレクトに使えます:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">aexists()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">acreate()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">asave()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">adelete()</code></p></li>\n<li><p><code class=\"docutils literal notranslate\">aload()</code></p></li>\n<li><p><a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase.aclear_expired\" title=\"django.contrib.sessions.backends.base.SessionBase.aclear_expired\"><code class=\"xref py py-meth docutils literal notranslate\">aclear_expired()</code></a></p></li>\n</ul>\n<p>独自のセッションエンジンを作ったり、既存のものをカスタマイズするには、<a class=\"reference internal\" href=\"#django.contrib.sessions.backends.base.SessionBase\" title=\"django.contrib.sessions.backends.base.SessionBase\"><code class=\"xref py py-class docutils literal notranslate\">SessionBase</code></a> か既存の <code class=\"docutils literal notranslate\">SessionStore</code> クラスを継承した新しいクラスを作る必要があるでしょう。</p>\n<p>セッションエンジンを拡張することもできますが、データベースをバックエンドとするセッションエンジンを拡張するには通常、追加の労力が必要です（詳しくは次のセクションを参照してください）。</p>\n<aside class=\"version-note version-changed\" data-version=\"5.1\" role=\"note\">\n<p class=\"version-note-title\">Changed in Django 5.1</p><p><code class=\"docutils literal notranslate\">aexists()</code>, <code class=\"docutils literal notranslate\">acreate()</code>, <code class=\"docutils literal notranslate\">asave()</code>, <code class=\"docutils literal notranslate\">adelete()</code>, <code class=\"docutils literal notranslate\">aload()</code>, <code class=\"docutils literal notranslate\">aclear_expired()</code> メソッドが追加されました。</p>\n</aside>\n</section>\n</section>\n<section id=\"extending-database-backed-session-engines\">\n<span id=\"id3\"></span><h2>データベースを使ったセッションを拡張する<a class=\"heading-anchor\" href=\"#extending-database-backed-session-engines\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django に含まれるデータベースを使ったセッションエンジン (具体的に言えば、<code class=\"docutils literal notranslate\">db</code> と <code class=\"docutils literal notranslate\">cached_db</code>) をカスタマイズするには、<a class=\"reference internal\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession\" title=\"django.contrib.sessions.base_session.AbstractBaseSession\"><code class=\"xref py py-class docutils literal notranslate\">AbstractBaseSession</code></a> とともに <code class=\"docutils literal notranslate\">SessionStore</code> クラスを継承する必要があるかもしれません。</p>\n<p><code class=\"docutils literal notranslate\">AbstractBaseSession</code> と <code class=\"docutils literal notranslate\">BaseSessionManager</code> は、<a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\">INSTALLED_APPS</code></a> に <code class=\"docutils literal notranslate\">django.contrib.sessions</code> を追加しなくても、<code class=\"docutils literal notranslate\">django.contrib.sessions.base_session</code> からインポートできます。</p>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.AbstractBaseSession\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-prename descclassname\">base_session.</span><span class=\"sig-name descname\">AbstractBaseSession</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>ベースとなる抽象的なセッションのモデルです。</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.AbstractBaseSession.session_key\">\n<span class=\"sig-name descname\">session_key</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession.session_key\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>プライマリーキーです。フィールド自体は40文字までの文字列を格納できますが、現在の実装では、32文字の文字列 (数字と小文字のASCII文字のランダムな列) を生成します。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.AbstractBaseSession.session_data\">\n<span class=\"sig-name descname\">session_data</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession.session_data\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>エンコード・シリアライズされた、セッションディクショナリーを含む文字列です。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.AbstractBaseSession.expire_date\">\n<span class=\"sig-name descname\">expire_date</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession.expire_date\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>セッションの有効期限を表す datetime オブジェクトです。</p>\n<p>有効期限が切れたセッションをユーザが利用することはできませんが、<a class=\"reference internal\" href=\"/ja/5.1/ref/django-admin/#django-admin-clearsessions\"><code class=\"xref std std-djadmin docutils literal notranslate\">clearsessions</code></a> 管理コマンドを実行するまでは、ふつうはデータベースに保存されています。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.AbstractBaseSession.get_session_store_class\">\n<em class=\"property\"><span class=\"k\">classmethod</span> </em><span class=\"sig-name descname\">get_session_store_class</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession.get_session_store_class\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>セッションモデルで使用するセッションストアクラスを返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.AbstractBaseSession.get_decoded\">\n<span class=\"sig-name descname\">get_decoded</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.AbstractBaseSession.get_decoded\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>デコードしたセッションデータを返します。</p>\n<p>デコードは、セッションストアのクラスで実行されます。</p>\n</dd></dl>\n\n</dd></dl>\n\n<p><a class=\"reference internal\" href=\"#django.contrib.sessions.base_session.BaseSessionManager\" title=\"django.contrib.sessions.base_session.BaseSessionManager\"><code class=\"xref py py-class docutils literal notranslate\">BaseSessionManager</code></a> のサブクラスを作ることで、モデルマネージャをカスタマイズすることもできます。</p>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.BaseSessionManager\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-prename descclassname\">base_session.</span><span class=\"sig-name descname\">BaseSessionManager</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.BaseSessionManager\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.BaseSessionManager.encode\">\n<span class=\"sig-name descname\">encode</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">session_dict</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.BaseSessionManager.encode\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>与えられたセッションディクショナリを、シリアライズ・エンコードした文字列として返します。</p>\n<p>エンコードは、モデルクラスに関連付けられたセッションストアのクラスで実行されます。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.base_session.BaseSessionManager.save\">\n<span class=\"sig-name descname\">save</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">session_key</em>, <em class=\"sig-param\">session_dict</em>, <em class=\"sig-param\">expire_date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.base_session.BaseSessionManager.save\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>与えられたセッションキーに対するセッションデータを保存します。データが空の場合には、セッションを削除します。</p>\n</dd></dl>\n\n</dd></dl>\n\n<p><code class=\"docutils literal notranslate\">SessionStore</code> クラスのカスタマイズは、以下に挙げるメソッドやプロパティをオーバーライドすることで行えます。</p>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.db.SessionStore\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-prename descclassname\">backends.db.</span><span class=\"sig-name descname\">SessionStore</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.db.SessionStore\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>データベースを使ったセッションストアを実装しています。</p>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.db.SessionStore.get_model_class\">\n<em class=\"property\"><span class=\"k\">classmethod</span> </em><span class=\"sig-name descname\">get_model_class</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.db.SessionStore.get_model_class\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>カスタマイズしたセッションモデルを返す必要がある場合には、このメソッドをオーバーライドします。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.db.SessionStore.create_model_instance\">\n<span class=\"sig-name descname\">create_model_instance</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">data</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.db.SessionStore.create_model_instance\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>現在のセッションの状態を表す、セッションモデルオブジェクトの新しいインスタンスを返します。</p>\n<p>このメソッドをオーバーライドすると、セッションモデルのデータをデータベースへ保存する前に修正できます。</p>\n</dd></dl>\n\n</dd></dl>\n\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.cached_db.SessionStore\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-prename descclassname\">backends.cached_db.</span><span class=\"sig-name descname\">SessionStore</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.cached_db.SessionStore\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>キャッシュデータベースを使ったセッションストアを実装しています。</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.sessions.backends.cached_db.SessionStore.cache_key_prefix\">\n<span class=\"sig-name descname\">cache_key_prefix</span><a class=\"heading-anchor\" href=\"#django.contrib.sessions.backends.cached_db.SessionStore.cache_key_prefix\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>キャッシュのキー文字列を作るためにセッションキーに追加するプリフィックスです。</p>\n</dd></dl>\n\n</dd></dl>\n\n<section id=\"example\">\n<h3>カスタマイズ例<a class=\"heading-anchor\" href=\"#example\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>以下の例は、アカウントIDを格納するための追加のデータベース列を含むカスタムのデータベースバックのセッションエンジンを示しており、アカウントのすべてのアクティブセッションに対してデータベースをクエリするオプションを提供します:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.sessions.backends.db</span> <span class=\"kn\">import</span> SessionStore <span class=\"k\">as</span> DBStore\n<span class=\"kn\">from</span> <span class=\"nn\">django.contrib.sessions.base_session</span> <span class=\"kn\">import</span> AbstractBaseSession\n<span class=\"kn\">from</span> <span class=\"nn\">django.db</span> <span class=\"kn\">import</span> models\n\n\n<span class=\"k\">class</span> <span class=\"nc\">CustomSession</span><span class=\"p\">(</span>AbstractBaseSession<span class=\"p\">):</span>\n    account_id <span class=\"o\">=</span> models<span class=\"o\">.</span>IntegerField<span class=\"p\">(</span>null<span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">,</span> db_index<span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">)</span>\n\n    <span class=\"nd\">@classmethod</span>\n    <span class=\"k\">def</span> <span class=\"nf\">get_session_store_class</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">):</span>\n        <span class=\"k\">return</span> SessionStore\n\n\n<span class=\"k\">class</span> <span class=\"nc\">SessionStore</span><span class=\"p\">(</span>DBStore<span class=\"p\">):</span>\n    <span class=\"nd\">@classmethod</span>\n    <span class=\"k\">def</span> <span class=\"nf\">get_model_class</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">):</span>\n        <span class=\"k\">return</span> CustomSession\n\n    <span class=\"k\">def</span> <span class=\"nf\">create_model_instance</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> data<span class=\"p\">):</span>\n        obj <span class=\"o\">=</span> <span class=\"nb\">super</span><span class=\"p\">()</span><span class=\"o\">.</span>create_model_instance<span class=\"p\">(</span>data<span class=\"p\">)</span>\n        <span class=\"k\">try</span><span class=\"p\">:</span>\n            account_id <span class=\"o\">=</span> <span class=\"nb\">int</span><span class=\"p\">(</span>data<span class=\"o\">.</span>get<span class=\"p\">(</span><span class=\"s2\">&quot;_auth_user_id&quot;</span><span class=\"p\">))</span>\n        <span class=\"k\">except</span> <span class=\"p\">(</span><span class=\"ne\">ValueError</span><span class=\"p\">,</span> <span class=\"ne\">TypeError</span><span class=\"p\">):</span>\n            account_id <span class=\"o\">=</span> <span class=\"kc\">None</span>\n        obj<span class=\"o\">.</span>account_id <span class=\"o\">=</span> account_id\n        <span class=\"k\">return</span> obj\n</code></pre></div>\n<p>Django の組み込みの <code class=\"docutils literal notranslate\">cached_db</code> セッションストアから、<code class=\"docutils literal notranslate\">cached_db</code> をベースにしたカスタムのものにマイグレーションする場合は、名前空間の衝突を防ぐためにキャッシュキーのプレフィックスをオーバーライドするべきです:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">class</span> <span class=\"nc\">SessionStore</span><span class=\"p\">(</span>CachedDBStore<span class=\"p\">):</span>\n    cache_key_prefix <span class=\"o\">=</span> <span class=\"s2\">&quot;mysessions.custom_cached_db_backend&quot;</span>\n\n    <span class=\"c1\"># ...</span>\n</code></pre></div>\n</section>\n</section>\n<section id=\"session-ids-in-urls\">\n<h2>URL 内のセッション ID<a class=\"heading-anchor\" href=\"#session-ids-in-urls\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django のセッションフレームワークは、完全かつ単独でクッキーをベースにしています。PHP のように最後の手段として URL にセッション ID を入れるようなことはありません。これは、意図的な設計上の決定です。そのような振る舞いは、URL を醜くしてしまうだけではなく、&quot;Referer&quot; ヘッダを介したセッション ID の盗難に対してサイトを脆弱にしてしまいます。</p>\n</section>","rootId":"module-django.contrib.sessions","toc":[{"title":"セッションを有効にする","anchor":"enabling-sessions","children":[]},{"title":"セッションエンジンを設定する","anchor":"configuring-the-session-engine","children":[{"title":"データベースを使ったセッション","anchor":"using-database-backed-sessions","children":[]},{"title":"キャッシュを使ったセッション","anchor":"using-cached-sessions","children":[]},{"title":"ファイルを使ったセッション","anchor":"using-file-based-sessions","children":[]},{"title":"クッキーを使ったセッション","anchor":"using-cookie-based-sessions","children":[]}]},{"title":"ビューでセッションを使う","anchor":"using-sessions-in-views","children":[{"title":"セッションのシリアライズ","anchor":"session-serialization","children":[{"title":"バンドルされているシリアライザ","anchor":"bundled-serializers","children":[]},{"title":"自作のシリアライザを書く","anchor":"write-your-own-serializer","children":[]}]},{"title":"セッションオブジェクトのガイドライン","anchor":"session-object-guidelines","children":[]},{"title":"例","anchor":"examples","children":[]}]},{"title":"テストクッキーを設定する","anchor":"setting-test-cookies","children":[]},{"title":"ビューの外でセッションを使う","anchor":"using-sessions-out-of-views","children":[]},{"title":"セッションが保存されるタイミング","anchor":"when-sessions-are-saved","children":[]},{"title":"ブラウザ起動中のみ有効なセッション vs. 永続的なセッション","anchor":"browser-length-sessions-vs-persistent-sessions","children":[]},{"title":"セッションストアのクリア","anchor":"clearing-the-session-store","children":[]},{"title":"設定","anchor":"settings","children":[]},{"title":"セッションのセキュリティ","anchor":"session-security","children":[]},{"title":"技術的な詳細","anchor":"technical-details","children":[{"title":"SessionStore オブジェクト","anchor":"the-sessionstore-object","children":[]}]},{"title":"データベースを使ったセッションを拡張する","anchor":"extending-database-backed-session-engines","children":[{"title":"カスタマイズ例","anchor":"example","children":[]}]},{"title":"URL 内のセッション ID","anchor":"session-ids-in-urls","children":[]}],"breadcrumbs":[{"docname":"topics/index","title":"Django を使う","url":"/ja/5.1/topics/"},{"docname":"topics/http/index","title":"HTTP リクエストのハンドリング","url":"/ja/5.1/topics/http/"}],"prev":{"docname":"topics/http/middleware","title":"ミドルウェア (Middleware)","url":"/ja/5.1/topics/http/middleware/"},"next":{"docname":"topics/forms/index","title":"フォームを使う","url":"/ja/5.1/topics/forms/"},"formats":{"html":"/ja/5.1/topics/http/sessions/","markdown":"/ja/5.1/topics/http/sessions.md","json":"/ja/5.1/topics/http/sessions.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/topics/http/sessions.txt","official":"https://docs.djangoproject.com/ja/5.1/topics/http/sessions/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}