Flask リクエストとレスポンス
Webアプリケーションの核心は「リクエストを受け取り、レスポンスを返す」ことです。この章では、Flaskでリクエストデータを読み取り、さまざまなタイプのレスポンスを構築する方法を詳しく説明します。
すべての例は開発サーバーで直接実行して確認できます。
リクエストオブジェクト——request
Flask はグローバルプロキシオブジェクトを介してrequestすべてのリクエスト情報を提供します。
グローバルオブジェクトではありますが、Flask 内部ではスレッド隔離メカニズムにより、各リクエストが自分のデータを取得できるようになっています。
例
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読み取ります。これは辞書のように動作します:
例
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:
例
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解析後のデータを取得します:
例
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()を使用してファイル名の安全性を確保します:
例
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。
例
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つの形式があります:
例
@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 に誘導します:
例
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エラーを返します:
例
@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():
例
@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" |