Concepts de base de Flask
Dans le chapitre précédent, nous avons appris à créer notre première application Flask. Dans ce chapitre, nous allons examiner en détail certains concepts de base de Flask.
Comprendre les concepts de base de Flask est très important pour développer des applications web efficaces.
Ce qui suit est une analyse détaillée des principaux concepts de base de Flask :
-
RoutageLe routage est la mise en correspondance des URL avec des fonctions Python. Flask vous permet de définir des routes, afin que lorsqu'une URL spécifique est accédée, la fonction correspondante soit appelée.
-
Fonction de vueLes fonctions de vue sont des fonctions Python qui traitent les requêtes et renvoient des réponses. Elles reçoivent généralement un objet requête comme paramètre et renvoient un objet réponse.
-
Objet requêteL'objet requête contient les informations envoyées par le client, telles que la méthode de requête, l'URL, les en-têtes de requête, les données de formulaire, etc.
-
Objet réponseL'objet réponse contient les informations envoyées au client, telles que le code d'état, les en-têtes de réponse, le corps de la réponse, etc.
-
ModèlesFlask utilise le moteur de modèles Jinja2 pour rendre les modèles HTML. Les modèles vous permettent d'intégrer du code Python dans du HTML, ce qui permet de générer dynamiquement des pages web.
-
Fabrique d'application: La fabrique d'application est une fonction Python qui crée et renvoie une instance d'application Flask. Cela vous permet de configurer et d'initialiser votre application, et vous pouvez créer plusieurs instances d'application.
-
Objet de configurationUne application Flask possède un objet de configuration que vous pouvez utiliser pour définir diverses options de configuration, telles que les chaînes de connexion à la base de données, le mode débogage, etc.
-
Blueprint: Les blueprints sont un moyen d'organiser le code dans Flask, vous permettant de regrouper les fonctions de vue, les modèles et les fichiers statiques associés, et ils peuvent être réutilisés dans plusieurs applications.
-
Fichiers statiquesLes fichiers statiques sont des fichiers qui ne sont pas exécutés côté serveur, tels que les fichiers CSS, JavaScript et les images. Flask fournit un moyen simple de servir ces fichiers.
-
ExtensionsFlask dispose de nombreuses extensions qui peuvent ajouter des fonctionnalités supplémentaires, telles que l'intégration de base de données, la validation de formulaires, l'authentification des utilisateurs, etc.
-
SessionFlask utilise des sessions client pour stocker les informations utilisateur, ce qui vous permet de mémoriser l'état de l'utilisateur pendant qu'il navigue dans votre application.
-
Gestion des erreursFlask vous permet de définir des fonctions de gestion des erreurs, qui sont appelées lorsque des erreurs spécifiques se produisent.
1. Routage
Le routage est la correspondance entre les URL et les fonctions Python. Flask vous permet de définir des routes, afin que lorsqu'un utilisateur accède à une URL spécifique, Flask appelle la fonction de vue correspondante pour gérer la requête.
Exemple
app = Flask(__name__)
@app.route('/')
def home():
return 'Bienvenue sur la page d'accueil !'
@app.route('/about')
def about():
return 'Ceci est la page À propos.'
@app.route('/'): Associer l'URL racine/àhomefonction.@app.route('/about'): correspond à/aboutURL correspond àaboutfonction.
2. Fonctions de vue
Les fonctions de vue sont des fonctions Python qui gèrent les requêtes et renvoient des réponses. Elles reçoivent généralement un objet request en paramètre et renvoient un objet de réponse, ou renvoient directement une chaîne, du HTML ou d'autres contenus.
Exemple
@app.route('/greet/<name>')
def greet(name):
return f'Hello, {name}!'
La fonction greet reçoit le paramètre name depuis l'URL et renvoie une réponse sous forme de chaîne.
3. Objet request
L'objet request contient les informations envoyées par le client, notamment la méthode de requête, l'URL, les en-têtes de requête, les données de formulaire, etc. Flask fournit l'objet request pour accéder à ces informations.
Exemple
@app.route('/submit', methods=['POST'])
def submit():
username = request.form.get('username')
return f'Hello, {username}!'
request.form.get('username')Obtenir le champ username à partir des données du formulaire dans une requête POST.
4. Objet de réponse
L'objet de réponse contient les informations envoyées au client, y compris le code de statut, les en-têtes de réponse et le corps de la réponse. Par défaut, Flask traite les chaînes et le HTML directement comme corps de réponse.
Exemple
@app.route('/custom_response')
def custom_response():
response = make_response('This is a custom response!')
response.headers['X-Custom-Header'] = 'Value'
return response
make_responseCréer un objet de réponse personnalisé et définir l'en-tête de réponse X-Custom-Header.
5. Modèles
Flask utilise le moteur de templates Jinja2 pour rendre les templates HTML. Les templates vous permettent d'intégrer du code Python dans le HTML, ce qui génère dynamiquement le contenu de la page web.
Exemple
@app.route('/hello/<name>')
def hello(name):
return render_template('hello.html', name=name)
Fichier de modèle (templates/hello.html) :
Exemple
<html>
<head>
<title>Bonjour</title>
</head>
<body>
<h1>Bonjour, {{ name }}!</h1>
</body>
</html>
6. Fabrique d'application
Une fabrique d'application est une fonction Python utilisée pour créer et configurer des instances d'application Flask. Cette approche permet de créer plusieurs instances d'application ou d'initialiser des applications sous différentes configurations.
Exemple
def create_app(config_name):
app = Flask(__name__)
app.config.from_object(config_name)
from . import routes
app.register_blueprint(routes.bp)
return app
La fonction create_app crée une instance d'application Flask et charge la configuration à partir d'un objet de configuration.
7. Objets de configuration
L'objet de configuration est utilisé pour définir diverses options de configuration pour l'application, telles que les chaînes de connexion à la base de données, le mode débogage, etc. Vous pouvez configurer une application Flask en définissant directement les valeurs ou en chargeant un fichier de configuration.
Exemple
DEBUG = True
SECRET_KEY = 'mysecretkey'
SQLALCHEMY_DATABASE_URI = 'sqlite:///mydatabase.db'
app.config.from_object(Config)Charge les éléments de configuration de la classe Config dans la configuration de l'application.
8. Blueprints
Les Blueprints sont un moyen d'organiser le code dans Flask. Ils vous permettent de regrouper des fonctions de vue, des gabarits et des fichiers statiques associés, et ils peuvent être réutilisés dans plusieurs applications.
Exemple
bp = Blueprint('main', __name__)
@bp.route('/')
def home():
return 'Home Page'
Enregistrer le blueprint (app/__init__.py) :
Exemple
from .routes import bp as main_bp
def create_app():
app = Flask(__name__)
app.register_blueprint(main_bp)
return app
9. Fichiers statiques
Les fichiers statiques sont des fichiers qui ne sont pas exécutés côté serveur, tels que les fichiers CSS, JavaScript et les fichiers image. Flask fournit un moyen simple de servir ces fichiers.
Exemple d'accès aux fichiers statiques :
<link rel="stylesheet" type="text/css" href="{{ url_for(.html'static', filename='style.css') }}">
Répertoire des fichiers statiques :Placez les fichiers statiques dans le dossier static, et Flask les servira automatiquement.
10. Extensions
Flask dispose de nombreuses extensions qui peuvent ajouter des fonctionnalités supplémentaires, telles que l'intégration de bases de données, la validation de formulaires, l'authentification des utilisateurs, etc. Ces extensions offrent des fonctionnalités plus avancées et des intégrations tierces.
Exemple
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///mydatabase.db'
db = SQLAlchemy(app)
SQLAlchemy: Extensions pour l'intégration de bases de données.
11. Sessions
Flask utilise des sessions client pour stocker les informations de l'utilisateur, afin de mémoriser l'état de l'utilisateur pendant qu'il navigue dans l'application. Les données de session sont stockées dans le cookie du client et sont signées et chiffrées côté serveur.
Exemple
# Clé secrète générée automatiquement
app.secret_key = 'your_secret_key_here'
@app.route('/set_session/<username>')
def set_session(username):
session['username'] = username
return f'Session définie pour {username}'
@app.route('/get_session')
def get_session():
username = session.get('username')
return f'Hello, {username}!' if username else 'No session data'
L'objet de session est utilisé pour stocker et récupérer les données de session.
Vous pouvez utiliser le module secrets intégré à Python pour générer une clé secrète forte et aléatoire.
python3 -c 'import secrets; print(secrets.token_hex())'
12. Gestion des erreurs
Flask vous permet de définir des fonctions de gestion des erreurs, qui sont appelées lorsque des erreurs spécifiques se produisent. Vous pouvez personnaliser les pages d'erreur ou la logique de gestion.
Exemple
def page_not_found(e):
return 'Page not found', 404
@app.errorhandler(500)
def internal_server_error(e):
return 'Internal server error', 500
@app.errorhandler(404)Définir une fonction de gestionnaire pour l'erreur 404 et renvoyer une page d'erreur personnalisée.
autres extensions