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
autres extensions