【サンプル付き】WSGIとは?その役割やメリットをわかりやすく解説

（最終更新月：2023年9月）

✔このような方へ向けて書かれた記事となります

「WSGIとは、詳しく何なのか理解したい」

「WSGIの仕組みや機能を知りたい」

「WSGIを用いた具体的な事例を見てみたい」

✔当記事を通じてお伝えすること

WSGIの基礎概念
WSGIの働きとその応用
WSGIを活用した実例

当記事では、WSGIの基本から、その特性を最大限利用する方法まで、具体的な事例を交えて詳しく説明します。

是非、最後までお読みください。

筆者プロフィール

【現職】プロダクトマネージャー

【副業】ブログ（月間17万PV）/YouTube/Web・アプリ制作

「プログラミング × ライティング × 営業」の経験を活かし、30後半からのIT系職へシフト。当サイトでは、実際に手を動かせるWebアプリの開発を通じて、プログラミングはもちろん、IT職に必要な情報を提供していきます。

【当ブログで紹介しているサイト】

当サイトチュートリアルで作成したデモ版日報アプリ

Django × Reactで開発したツール系Webアプリ

✔人に見せても恥ずかしくないコードを書こう

「リーダブルコード」は、わかりやすく良いコードの定義を教えてくれる本です。

見るからにきれいなコードの書き方
コードの分割方法
変数や関数の命名規則

エンジニアのスタンダートとすべき基準を一から解説しています。

何回も読むのに値する本なので、ぜひ手にとって読んでみてください。

リーダブルコード ―より良いコードを書くためのシンプルで実践的なテクニック

created by Rinker

¥2,640 (2024/05/03 14:22:26時点 Amazon調べ-詳細)

WSGIの基本

WSGIについて深く探ることで、PythonでのWeb開発の基盤を理解できます。

これにより、より高度なアプリケーションの開発が可能です。

WSGIとは
WSGIとPythonの連携

WSGIとは

WSGIは、Web Server Gateway Interfaceの略で、PythonのWebアプリケーションとWebサーバーとの間の標準的なインターフェースを提供します。

異なるWebサーバー上で同じアプリケーションを動作させられる仕組みです。

WSGIとPythonの連携

PythonのWebフレームワークの多くは、WSGIをサポートしています。

WSGIにより、フレームワークを選ぶ自由が増え、最適なフレームワークを選択できるのです。

例えば、DjangoやFlaskなどの人気のあるフレームワークは、WSGIを使用してWebサーバーと連携します。

WSGIプログラミングの第一歩

こちらでは、WSGIを使用したプログラミングの基本を学びます。

このセクションを通じて、WSGIの基本的な使い方とその機能を理解することができます。

“Hello, World”アプリケーションガイド
WSGIのプログラム例
簡易WSGIサーバーの例

“Hello, World”アプリケーションガイド

WSGIを使用した最も基本的なアプリケーションを作成してみましょう。

以下は、”Hello, World”を表示するWSGIアプリケーションのコード例です。

def application(environ, start_response):
    status = '200 OK'
    headers = [('Content-type', 'text/plain')]
    start_response(status, headers)
    return [b"Hello, World!"]

このコードをhello.pyとして保存し、WSGIサーバーを使用して実行することで、Webブラウザからアクセス可能となります。

WSGIのプログラム例

WSGIは非常に柔軟で、さまざまなWebアプリケーションの開発に適しています。

例えば、リクエストのパスに応じて異なるレスポンスを返すアプリケーションも簡単に作成できます。

def application(environ, start_response):
    path = environ.get('PATH_INFO')
    if path == '/hello':
        response_body = b"Hello, World!"
    else:
        response_body = b"Welcome to my WSGI app!"
    status = '200 OK'
    headers = [('Content-type', 'text/plain')]
    start_response(status, headers)
    return [response_body]

WSGIを使用すると、Pythonのコードで直接Webアプリケーションのロジックを記述できます。

簡易WSGIサーバーの例

WSGIアプリケーションを実行するためのWSGIサーバーはいくつか存在します。

代表的なものは以下のとおり。

wsgiref
gunicorn
uWSGI

以下では、Pythonの標準ライブラリに含まれるwsgirefを使用した例を見ていきましょう。

以下がWSGIサーバーを起動するための短いスクリプトです。

# runserver.py

from wsgiref.simple_server import make_server
import hello

# サーバーを作成
server = make_server('127.0.0.1', 8080, hello.application)

# サーバーを起動
print("Serving on port 8080...")
server.serve_forever()

このスクリプトは、hello.pyと同じディレクトリに保存してください。

このスクリプトをrunserver.pyとして保存します。

次に、以下のコマンドを実行してWSGIサーバーを起動しましょう。