# Django 4.1.8.dev20230308103347 ドキュメント

# WSGI とともにデプロイするには

Django の主要なデプロイプラットフォームは、 Web サーバと Web アプリケーション に関して Python の標準である WSGI です。

Django's `startproject` management command sets up a minimal default WSGI configuration for you, which you can tweak as needed for your project, and direct any WSGI-compliant application server to use.

Django には以下の WSGI サーバのために、手引きとなるドキュメントが用意されています:

- How to use Django with Gunicorn
- Django を uWSGI とともに使うには？
- Django を Apache と `mod_wsgi` とともに使うには？
- How to authenticate against Django's user database from Apache

## `application` オブジェクト

WSGI デプロイでキーとなる概念は、Web サーバがあなたのコードと通信するために使う `application` という呼び出し可能オブジェクトです。これは一般的に、サーバにアクセスできる Python モジュールの中で `application` という名前のオブジェクトとして提供されています。

`startproject` コマンドは、この `application` 呼び出し可能オブジェクトを含む `<project_name>/wsgi.py` ファイルを生成します。

これは、Django のデプロイサーバーによって、また WSGI デプロイプロダクションにおいて、これら両方で使われます。

WSGI サーバーは `application` 呼び出し可能オブジェクトへのパスを、その設定から取得します。Django のビルトインサーバー (要するに `runserver` コマンド) は、`WSGI_APPLICATION` の設定からこれを読み出します。デフォルトでは、 `<project_name>/wsgi.py` 内の `application` 呼び出し可能オブジェクトを指す `<project_name>.wsgi.application` がセットされています。

## Settings モジュールを設定する

WSGI サーバがあなたのアプリケーションを読み込むとき、Django は Settings モジュールをインポートする必要があります。そのモジュールは、あなたのアプリケーション全体が定義されている場所です。

Django は適切な Settings モジュールを見つけるために、 `DJANGO_SETTINGS_MODULE` 環境変数を使用します。これは設定モジュールへのドット区切りのパスを含んでいなければなりません。開発時と実運用時で別々の値を使用することも可能です。どのように設定を組織するか次第です。

この値が設定されていない場合、初期生成ファイルである `wsgi.py` は、 `mysite.settings` をこの値として設定します。ここでの `mysite` はプロジェクトの名前です。このようにして初期設定ファイルを見つけるのが、 `runserver` にあらかじめ用意されている方法です。

注釈

環境変数は、同一プロセス内においては同じ値が使われます。このため、単一プロセスで複数の Django サイトを運用する場合は、適切に機能しません。これは mod_wsgi を使用する場合に起こります。

この問題を回避するためには、サイトごとに固有の daemon プロセスを mod_wsgi の daemon モードで運用するか、もしくは `wsgi.py` ファイル内で `os.environ["DJANGO_SETTINGS_MODULE"] = "mysite.settings"` を実行して環境変数の値を上書きします。

## Applying WSGI middleware

To apply WSGI middleware you can wrap the application object. For instance you could add these lines at the bottom of `wsgi.py`:

    from helloworld.wsgi import HelloWorldApplication
    application = HelloWorldApplication(application)

You could also replace the Django WSGI application with a custom WSGI application that later delegates to the Django WSGI application, if you want to combine a Django application with a WSGI application of another framework.