Comment démarrer une application Flask : un guide complet

Si vous êtes comme moi, vous avez probablement vu plusieurs approches différentes pour démarrer une application Flask et vous vous demandez laquelle est la meilleure. Parfois, vous rencontrerez manage.py, d'autres fois, vous verrez create_app. Cela peut prêter à confusion, surtout si vous débutez dans le développement de Flask ou si vous passez d'un projet à un autre.

Dans cet article, je vais vous présenter les méthodes les plus couramment utilisées pour démarrer une application Flask, en les décomposant avec des exemples clairs afin que vous puissiez décider ce qui fonctionne le mieux pour votre cas d'utilisation.

Méthode 1 : fichier app.py de base

Le moyen le plus simple de démarrer une application Flask consiste à créer un fichier app.py. C'est idéal pour les petites applications ou lorsque vous débutez avec Flask.

# app.py
from flask import Flask

app = Flask(__name__)

@app.route('/')
def home():
    return "Welcome to my Flask app!"

if __name__ == "__main__":
    app.run(debug=True)

Comment l'exécuter :

Dans votre terminal, accédez au dossier contenant app.py et exécutez :

python app.py

Flask démarrera sur localhost:5000 et vous pourrez visiter votre application dans un navigateur. C'est la méthode la plus rapide, mais elle présente des limites en termes de mise à l'échelle.

Méthode 2 : utilisation du modèle d'usine create_app

À mesure que votre application grandit, le modèle d'usine avec create_app() devient plus utile. Cette méthode permet de configurer et d'initialiser votre application de manière modulaire, vous permettant de mieux gérer les configurations complexes.

# app.py
from flask import Flask

def create_app():
    app = Flask(__name__)

    @app.route('/')
    def home():
        return "Hello from Factory Pattern!"

    return app

Comment l'exécuter :

Comme il n'y a pas de bloc if __name__ == "__main__", vous l'exécuterez en définissant la variable d'environnement FLASK_APP.

export FLASK_APP=app:create_app
export FLASK_ENV=development
flask run

Cette méthode est plus évolutive car elle permet une gestion plus facile de la configuration, ce qui la rend adaptée aux applications plus volumineuses ou utilisant des extensions.

Méthode 3 : Utilisation de manage.py avec Flask-Script

Bien que Flask-Script soit obsolète au profit de l'interface de ligne de commande (CLI) intégrée de Flask, certaines applications héritées utilisent toujours l'approche manage.py.

# manage.py
from flask_script import Manager
from app import create_app

app = create_app()
manager = Manager(app)

if __name__ == "__main__":
    manager.run()

Pour exécuter l'application :

python manage.py runserver

Cette méthode étant désormais considérée comme obsolète, il est préférable de s'appuyer sur la CLI de Flask pour des fonctionnalités similaires.

Méthode 4 : Utiliser Gunicorn pour la production

Lors du déploiement d'une application Flask en production, vous souhaiterez utiliser un serveur WSGI comme Gunicorn au lieu du serveur de développement intégré de Flask.

Voici comment exécuter votre méthode create_app avec Gunicorn :

gunicorn 'app:create_app()'

Cela lancera votre application Flask en utilisant Gunicorn. Vous pouvez spécifier le nombre de processus de travail, l'hôte et le port si nécessaire :

gunicorn -w 3 -b 0.0.0.0:8000 'app:create_app()'

Méthode 5 : Utilisation de flask run pour la CLI intégrée

La CLI de Flask simplifie l'exécution de l'application et l'exécution d'autres commandes telles que les migrations. La CLI par défaut utilise les variables d'environnement FLASK_APP et FLASK_ENV.

export FLASK_APP=app.py
export FLASK_ENV=development
flask run

Cette commande exécute votre application en mode développement avec le rechargement à chaud et le mode débogage activés. C'est idéal pour le développement, mais vous ne devriez pas l'utiliser en production.

Lequel devriez-vous utiliser ?

• Petits projets ou prototypes : La méthode de base app.py fonctionne parfaitement.
• Applications volumineuses : optez pour le modèle d'usine create_app, car il s'adapte bien aux extensions et aux configurations complexes.
• Production : utilisez Gunicorn ou d'autres serveurs WSGI pour gérer plusieurs requêtes simultanément et offrir de meilleures performances.

Conclusion

Comprendre ces différentes méthodes vous donne de la flexibilité dans la façon dont vous démarrez une application Flask. Que vous construisiez un petit projet ou déployiez un système à grande échelle, vous trouverez l'approche adaptée à vos besoins. En comprenant les éléments essentiels de chaque méthode, vous serez en mesure de maintenir et de faire évoluer votre application efficacement.

Avez-vous utilisé une approche différente qui vous convient mieux ? Faites-le moi savoir dans les commentaires !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!