Flask リクエストとレスポンス

Webアプリケーションの核心は「リクエストを受け取り、レスポンスを返す」ことです。この章では、Flaskでリクエストデータを読み取り、さまざまなタイプのレスポンスを構築する方法を詳しく説明します。

すべての例は開発サーバーで直接実行して確認できます。


リクエストオブジェクト——request

Flask はグローバルプロキシオブジェクトを介してrequestすべてのリクエスト情報を提供します。

グローバルオブジェクトではありますが、Flask 内部ではスレッド隔離メカニズムにより、各リクエストが自分のデータを取得できるようになっています。

例

# request をインポートします。これはスレッドセーフなプロキシオブジェクトです
from flask import Flask, request

app = Flask(__name__)

@app.route("/debug")
def debug():
    # リクエストのさまざまな情報を出力し、request オブジェクトの理解を助けます
    return f"""
<h1>リクエストデバッグ情報</h1>
    <ul>
<li>メソッド:{request.method}</li>
<li>パス:{request.path}</li>
<li>完全なURL:{request.url}</li>
<li>ホスト:{request.host}</li>
<li>クライアントIP:{request.remote_addr}</li>
        <li>User-Agent:{request.headers.get('User-Agent')}</li>
    </ul>
    """

アクセスhttp://127.0.0.1:5000/debug?foo=barすると、リクエストの詳細情報を確認できます。


クエリパラメータの取得——request.args

URL内の?後ろのパラメータをクエリパラメータ(Query String)と呼びます。

を使用してrequest.args読み取ります。これは辞書のように動作します:

例

@app.route("/search")
def search():
    # request.args.get() は安全にパラメータを取得し、key が存在しない場合は None を返します
    keyword = request.args.get("keyword", "")  # クエリのキーワードを取得
    page = request.args.get("page", "1")       # ページ番号を取得、デフォルトは 1
    return f"""
<h1>検索結果</h1>
<p>キーワード:{keyword}</p>
<p>ページ番号:{page}</p>
    """

# テスト:/search?keyword=flask&page=2
# テスト:/search?keyword=サンプル

推奨されるのは.get()メソッド(直接の添え字アクセスではなく)ですrequest.args["key"]、後者は key が存在しない場合にスローするためKeyError、400 エラーページが返される原因になります。


フォームデータの取得——request.form

POST リクエストで送信されたフォームデータを処理するには、を使用しますrequest.form:

例

@app.route("/register", methods=["GET", "POST"])
def register():
    if request.method == "POST":
        # フォームの name="username" フィールドの値を使用
        username = request.form.get("username", "")
        password = request.form.get("password", "")

        if not username or not password:
            return "<h1>エラー</h1><p>ユーザー名とパスワードは空にできません</p>", 400

        return f"<h1>登録成功</h1><p>{username} さん、サンプル へようこそ!</p>"

    # GET リクエストの場合は登録フォームを表示
    return """
<h1>登録</h1>
    <form method="post">
<p>ユーザー名:<input type="text" name="username"></p>
<p>パスワード:<input type="password" name="password"></p>
<p><input type="submit" value="登録"></p>
    </form>
    """

注意:フォームを処理する HTML ページでは、<form>を必ず設定する必要があります。method="post"、そうしないとデータは URL のクエリ文字列(GET 方式)で送信され、機密情報が URL に露出します。


JSONデータの取得——request.json

現代の Web 開発では、JSON は最も一般的なデータ形式です。

クライアントがContent-Type: application/jsonのリクエストを送信した場合は、を使用しますrequest.json解析後のデータを取得します:

例

@app.post("/api/user")
def create_user():
    # request.json は Python の dict に解析済みの JSON データを返します
    data = request.json  # 例:クライアントが {"name": "サンプル", "email": "test@example.com"} を送信した場合

    # フィールドを安全に取得
    name = data.get("name", "不明")
    email = data.get("email", "未提供")

    # dict を直接返すと、Flask が自動的に JSON レスポンスに変換します
    return {
        "message": "ユーザー作成成功",
        "name": name,
        "email": email
    }

curl を使用できますcurlまたは Postman でテスト:

$ curl -X POST http://127.0.0.1:5000/api/user \
  -H "Content-Type: application/json" \
  -d '{"name": "サンプル", "email": "test@example.com"}'
{
  "message": "用户创建成功",
  "name": "サンプル",
  "email": "test@example.com"
}

ファイルアップロード

アップロードされたファイルの処理には、を使用しますrequest.files、Werkzeug が提供するsecure_filename()を使用してファイル名の安全性を確保します:

例

import os
from werkzeug.utils import secure_filename  # 危険なファイル名の文字をフィルタリング

# アップロードディレクトリを設定(実際のプロジェクトでは設定から読み取るべき)
UPLOAD_DIR = "uploads"

@app.route("/upload", methods=["GET", "POST"])
def upload_file():
    if request.method == "POST":
        # ファイルがアップロードされたかどうかを確認
        if "file" not in request.files:
            return "ファイルが選択されていません", 400

        file = request.files["file"]

        # ユーザーが空のフォームを送信した可能性があります(ファイル未選択)
        if file.filename == "":
            return "ファイル名が空です", 400

        # secure_filename はパストラバーサルなどの危険な文字をフィルタリングします
        # 例:"../../etc/passwd" は "etc_passwd" に処理されます
        filename = secure_filename(file.filename)

        # アップロードディレクトリが存在することを確認
        os.makedirs(UPLOAD_DIR, exist_ok=True)

        # ファイルを保存
        file.save(os.path.join(UPLOAD_DIR, filename))
        return f"ファイル {filename} のアップロードに成功しました"

    # GET リクエストではアップロードフォームを表示
    return """
<h1>ファイルをアップロード</h1>
    <form method="post" enctype="multipart/form-data">
        <p><input type="file" name="file"></p>
<p><input type="submit" value="アップロード"></p>
    </form>
    """

フォームにファイルアップロードフィールドがある場合、<form>タグに必ず設定する必要がありますenctype="multipart/form-data"、そうしないとファイルデータがブラウザから送信されません。


レスポンスタイプ完全ガイド

ビュー関数はさまざまなタイプのデータを返すことができ、Flask はそれらを適切な HTTP レスポンスに自動変換します。

この変換ルールを理解することが Flask を習得する鍵です。

文字列を返す

返された文字列は HTML レスポンスボディとして扱われ、ステータスコードはデフォルトで 200、Content-Type はtext/html。

辞書またはリストを返す(JSON)

が自動的に呼び出されjsonify()JSON レスポンスに変換されます。Content-Type はapplication/json。

例

@app.get("/api/posts")
def get_posts():
    # dict を返すと、Flask が自動的に JSON に変換
    return {
        "status": "ok",
        "data": [
            {"id": 1, "title": "Flask 入門チュートリアル"},
            {"id": 2, "title": "RESTful API 設計"},
        ]
    }

@app.get("/api/tags")
def get_tags():
    # list を返すと、Flask が自動的に JSON に変換
    return ["Python", "Flask", "Web 開発", "サンプル"]

タプルを返す——ステータスコードとレスポンスヘッダーを制御する

タプル形式は非常に便利で、3つの形式があります:

例

# 形式1:(body, status_code)
@app.get("/not-found")
def not_found():
    return "<h1>ページが存在しません</h1>", 404

# 形式2:(body, headers_dict)
@app.get("/custom-header")
def custom_header():
    return "OK", {"X-Custom-Header": "サンプル"}

# 形式3:(body, status_code, headers_dict)
@app.post("/api/login")
def api_login():
    # token とカスタムステータスコードを返す
    return {"token": "abc123", "user": "サンプル"}, 201, {"X-RateLimit": "100"}

リダイレクト

を使用してredirect()関数でユーザーを別の URL に誘導します:

例

from flask import Flask, redirect, url_for

app = Flask(__name__)

@app.route("/")
def index():
    # ホームページにアクセスするとログインページにリダイレクト
    return redirect(url_for("login"))

@app.route("/login")
def login():
    return "<h1>先にログインしてください</h1>"

@app.route("/old-page")
def old_page():
    # 旧ページが新ページに恒久的に移転した場合、301 ステータスコードを使用
    return redirect(url_for("new_page"), code=301)

@app.route("/new-page")
def new_page():
    return "<h1>これは新しいページです</h1>"

デフォルトのリダイレクトステータスコードは303 See Other、フォーム送信後のリダイレクト(PRGパターン)に適用されます。

恒久的な移転シナリオには、を使用する必要があります。code=301。


リクエストを中止する——abort

使用するabort()現在のリクエストを直ちに終了し、HTTPエラーを返します:

例

from flask import abort

@app.route("/post/<int:post_id>")
def view_post(post_id):
    # 記事IDが1〜100のみであると仮定
    if post_id < 1 or post_id > 100:
        # 直ちに404を返し、後続のコードは実行されません
        abort(404)

    return f"<h1>記事 #{post_id}</h1>"

@app.route("/admin")
def admin():
    # 未認可アクセス時は403を返します
    abort(403, description="このページにアクセスする権限がありません")

make_response——レスポンスを手動で制御する

Cookieを手動で設定するか、レスポンスヘッダーをカスタマイズする必要がある場合は、使用します。make_response():

例

from flask import make_response

@app.route("/set-cookie")
def set_cookie():
    # make_response はビュー関数の戻り値をResponseオブジェクトにラップします
    resp = make_response("<h1>Cookie が設定されました</h1>")

    # ResponseオブジェクトにCookieを設定します
    resp.set_cookie("theme", "dark", max_age=60*60*24)  # 有効期限24時間
    resp.set_cookie("lang", "zh-CN")

    # レスポンスヘッダーをカスタマイズすることもできます
    resp.headers["X-Powered-By"] = "サンプル-Flask"

    return resp

request のよく使う属性早見表

属性 型 説明 例の値
request.method str HTTPリクエストメソッド "GET", "POST"
request.path str URLパス(ドメイン名を含まない) "/search"
request.args MultiDict URLクエリパラメータ ?keyword=flask&page=1
request.form MultiDict POSTフォームデータ username=admin
request.json dict または None JSONリクエストボディ(解析済み) {"name": "サンプル"}
request.files FileMultiDict アップロードされたファイル request.files["avatar"]
request.headers Headers リクエストヘッダー request.headers["User-Agent"]
request.cookies dict クライアントが送信したCookie request.cookies.get("theme")
request.remote_addr str クライアントのIPアドレス "127.0.0.1"
その他の拡張