API de l'objet Request de Flask
La classe Request encapsule toutes les informations sur la requête HTTP envoyée par le client.
En utilisantfrom flask import requestImportez l'objet proxy et utilisez-le directement dans les fonctions de vue.
Référence rapide des attributs courants
| Propriété | Type | Description | Valeur d'exemple |
|---|---|---|---|
| method | str | Méthode de requête HTTP | "GET"、"POST" |
| path | str | Partie du chemin de l'URL (hors domaine et chaîne de requête) | "/search" |
| full_path | str | Chemin + chaîne de requête | "/search?q=example" |
| url | str | URL complète de la requête (hors chaîne de requête) | "http://localhost:5000/search" |
| base_url | str | Identique à url, avec la chaîne de requête finale supprimée. | "http://localhost:5000/search" |
| url_root | str | Domaine + chemin racine de l'application | "http://localhost:5000/" |
| host | str | En-tête Host, y compris le port | "localhost:5000" |
| host_url | str | scheme + host + racine de l'application | "http://localhost:5000/" |
| scheme | str | Protocol | "http"、"https" |
| remote_addr | str | Adresse IP du client | "127.0.0.1" |
| endpoint | str | Le point de terminaison de la route correspondante | "index", "blog.show" |
| url_rule | Règle | Objet de règle de route correspondante | Instance de Rule de Werkzeug |
| view_args | dict | Variables dynamiques dans l'URL | {"post_id": 42} |
| blueprint | str | Nom du blueprint actuel | "auth"、"blog" |
| blueprints | liste | Liste actuelle des niveaux de blueprint correspondants | ["auth"] |
| is_json | bool | Indique si le Content-Type de la requête est JSON | True / False |
Obtenir les données de la requête
| Attributs/Méthodes | Type | Description |
|---|---|---|
| args | MultiDict | Paramètres de requête d'URL. Accès à /search?q=flask → request.args.get("q") |
| forme | MultiDict | Données de formulaire POST (application/x-www-form-urlencoded ou multipart/form-data) |
| json | dict / None | Corps de requête JSON (analysé en objet Python). Renvoie None lorsque la requête n'est pas JSON. |
| data | bytes | Données brutes du corps de la requête |
| files | FileMultiDict | Fichier téléversé. request.files["file"] renvoie un objet FileStorage |
| cookies | dict | Cookie envoyé par le client |
| headers | En-têtes | En-tête de requête. Prend en charge plusieurs méthodes d'accès |
| get_json(force=False, silent=False, cache=True) | — | Analyse le corps de la requête JSON. force force l'analyse des types non JSON, silent renvoie None en cas d'erreur |
Paireargs、formetc. Les types MultiDict, utilisez toujours..get(key, default)Méthode pour obtenir la valeur. Utilisez directementrequest.args["key"]L'accès à une clé inexistante lève une KeyError (renvoie une erreur 400).
Attributs de négociation de contenu
| Attributs/Méthodes | Description |
|---|---|
| accept_mimetypes | Liste des types MIME acceptés par le client (objet MIMEAccept). |
| accept_charsets | Jeu de caractères accepté par le client |
| accept_encodings | Encodage accepté par le client |
| accept_languages | Langue acceptée par le client |
| content_type | Content-Type de la requête |
| content_length | Longueur du corps de la requête (bytes) |
| content_md5 | Somme de contrôle MD5 du corps de la requête |
Exemples de code
Exemple
from flask import Flask, request
app = Flask(__name__)
@app.route("/demo", methods=["GET", "POST"])
def demo():
# Obtenir les paramètres de requête
keyword = request.args.get("q", "")
# Obtenir les données de formulaire
username = request.form.get("username", "")
# Obtenir les données JSON
if request.is_json:
data = request.json
name = data.get("name", "unknown")
# Obtenir les en-têtes de requête
user_agent = request.headers.get("User-Agent", "")
accept_lang = request.accept_languages.best
# Obtenir les informations sur l'URL
url_info = {
"method": request.method, # "GET" ou "POST"
"path": request.path, # "/demo"
"url": request.url, # URL complète
"remote_addr": request.remote_addr, # IP du client
}
return url_info
app = Flask(__name__)
@app.route("/demo", methods=["GET", "POST"])
def demo():
# Obtenir les paramètres de requête
keyword = request.args.get("q", "")
# Obtenir les données de formulaire
username = request.form.get("username", "")
# Obtenir les données JSON
if request.is_json:
data = request.json
name = data.get("name", "unknown")
# Obtenir les en-têtes de requête
user_agent = request.headers.get("User-Agent", "")
accept_lang = request.accept_languages.best
# Obtenir les informations sur l'URL
url_info = {
"method": request.method, # "GET" ou "POST"
"path": request.path, # "/demo"
"url": request.url, # URL complète
"remote_addr": request.remote_addr, # IP du client
}
return url_info