Actualités

> 🚀 **Iris v14 arrive.** La prochaine version majeure est la plus importante de l'histoire du projet : le framework reconstruit sur les génériques de Go, un constructeur d'application vérifié par le compilateur, des aides de requête qui valident à votre place, une table d'erreurs centrale, trente middlewares intégrés et un livre livré dans le dépôt lui-même. Voir [ce qui arrive dans Iris v14](#-ce-qui-arrive-dans-iris-v14) plus bas. > > La version décrite ici, **v12**, continue de fonctionner et de recevoir des correctifs. v14 arrive sur un nouveau chemin d'import, donc rien ne casse chez vous le jour de sa sortie. #

Iris Web Framework English

العربية [![build status](https://img.shields.io/github/actions/workflow/status/kataras/iris/ci.yml?branch=main&style=for-the-badge)](https://github.com/kataras/iris/actions/workflows/ci.yml) [![view examples](https://img.shields.io/badge/examples%20-285-a83adf.svg?style=for-the-badge&logo=go)](https://github.com/kataras/iris/tree/main/_examples) [![chat](https://img.shields.io/gitter/room/iris_go/community.svg?color=cc2b5e&logo=gitter&style=for-the-badge)](https://gitter.im/iris_go/community) [![donate](https://img.shields.io/badge/support-Iris-blue.svg?style=for-the-badge&logo=paypal)](https://iris-go.com/donate) ⚡ Iris est un framework web pour Go à la fois rapide, simple, très complet et très efficace. ✨ Il fournit des moyens simples et élégants de construire les bases de votre prochain site web ou API. 🌟 Lisez [ce que les développeurs pensent d'Iris](https://www.iris-go.com/#review) et **[étoilez](https://github.com/kataras/iris/stargazers)** ce projet open source [![](https://iris-go.com/static/images/reviews.gif)](https://iris-go.com/testimonials/) [![Benchmarks: Jul 18, 2020 at 10:46am (UTC)](https://iris-go.com/static/images/benchmarks.svg)](https://github.com/kataras/server-benchmarks) ```go package main import "github.com/kataras/iris/v12" func main() { app := iris.New() app.Use(iris.Compression) app.Get("/", func(ctx iris.Context) { ctx.HTML("Hello %s!", "World") }) app.Listen(":8080") } ``` Comme l'a dit un jour un [développeur Go](https://twitter.com/dkuye/status/1532087942696554497), **Iris vous couvre sur tous les fronts et tient bon au fil des années** ⭐ Quelques-unes des fonctionnalités qu'offre Iris : * HTTP/2 (Push, y compris les données embarquées) * Middlewares (Accesslog, Basicauth, CORS, gRPC, Anti-Bot hCaptcha, JWT, MethodOverride, ModRevision, Monitor, PPROF, Ratelimit, Anti-Bot reCaptcha, Recovery, RequestID, Rewrite) * Versionnage d'API * Model-View-Controller * Websockets * gRPC * Auto-HTTPS * Prise en charge intégrée de ngrok, le moyen le plus rapide de publier votre application sur internet * Un routeur unique avec des chemins dynamiques en paramètre, des types standards comme :uuid, :string, :int... et la possibilité de créer les vôtres * Compression * Moteurs de vues (HTML, Django, Handlebars, Pug/Jade et plus) * Créez votre propre serveur de fichiers et hébergez votre propre serveur WebDAV * Cache * Localisation (i18n, sitemap) * Sessions * Réponses riches (HTML, Text, Markdown, XML, YAML, Binary, JSON, JSONP, Protocol Buffers, MessagePack, Content Negotiation, Streaming, Server-Sent Events et plus) * Compression des réponses (gzip, deflate, brotli, snappy, s2) * Requêtes riches (Bind URL Query, Headers, Form, Text, XML, YAML, Binary, JSON, Validation, Protocol Buffers, MessagePack et plus) * Injection de dépendances (MVC, Handlers, API Routers) * Suite de tests * Et le plus important... vous obtenez des réponses rapides et du support, depuis le premier jour jusqu'à aujourd'hui ## 🚀 Ce qui arrive dans Iris v14 Iris v14 est la plus grande version de l'histoire du projet. Elle reconstruit le framework sur les génériques de Go et change la façon dont une application est assemblée : moins de câblage dans `main`, des handlers plus courts, et un seul endroit pour les décisions qui étaient auparavant éparpillées sur chaque route. Rien de tout cela ne demande votre attention aujourd'hui. v12 continue de fonctionner, continue de recevoir des correctifs, et v14 arrive avec un guide de migration qui couvre chaque API renommée ou supprimée. ### Toute l'application dans une chaîne vérifiée par le compilateur `iris.NewBuilder` câble CORS, compression, journalisation des accès, l'endpoint de santé, la table d'erreurs, vos services et vos groupes d'API en une seule expression. Le compilateur impose l'ordre des étapes : une application se construit correctement, ou ne se construit pas du tout. ```go iris.NewBuilder(). Prefix("/api"). AllowOrigin("*"). Compression(true). LogRequests(true). Health(true, "production", "kataras"). Errors(errors.NewOptions(). MapErrors(errors.NotFound, catalog.ErrNotFound)). Services(catalog.NewRepository, catalog.NewService). API("/products", api.NewProductsAPI). Build(). Listen(":8080") ``` ### Les handlers cessent de se répéter Le décodage, la validation et le rendu des erreurs sortent du corps du handler. `rest.ReadJSON[T]` décode la requête, exécute la méthode `Validate() error` de votre type lorsqu'elle existe, et écrit lui-même le 400. Les aides de réponse écrivent le statut de succès, ou ce que votre table centrale dit que cette erreur doit renvoyer. ```go func (api *ProductsAPI) create(ctx iris.Context) { input, ok := rest.ReadJSON[catalog.ProductInput](ctx) if !ok { return // 400 déjà écrit : JSON malformé ou Validate en échec. } id, err := api.svc.Create(ctx, input) rest.Created(ctx, id, err) // 201, ou l'erreur mappée centralement. } ``` `rest.OK`, `rest.NoContent`, `rest.Count` et `rest.Paginated` couvrent les autres formes de réponse d'une API. ### Les erreurs sont déclarées une seule fois Le nouveau paquet `rest/errors` contient la correspondance entre les erreurs de votre domaine et les réponses HTTP. Les clients reçoivent des charges utiles canoniques et lisibles par une machine. Les messages internes restent internes. Enregistrez un collecteur et chaque échec atteint votre logger ou votre base de données depuis un seul endroit. Une erreur peut être rendue en JSON ou en vue, selon ce que le client a demandé. ### L'injection de dépendances partout, pas seulement en MVC Les constructeurs déclarent ce dont ils ont besoin et le conteneur le fournit : pour les handlers, pour les groupes d'API, pour les contrôleurs. Un service qui implémente `Init(ctx context.Context) error` s'exécute une fois dans `Build()`. Tout ce qui peut être fermé est fermé à l'arrêt. Le paquet `hero` disparaît, remplacé par `dep` et `rest`, qui en font plus en moins de lignes. Les contrôleurs MVC sont construits sur les génériques. ### Les paquets sont là où on les attend `sessions`, `cache`, `websocket`, `i18n`, `view` et `versioning` sont devenus des middlewares. `mvc` a été déplacé sous `controller`, aux côtés des nouveaux contrôleurs `fileserver`, `sitemap` et `apigraph`. `apigraph` dessine votre arbre de routes sous forme de graphe D3 interactif. Trente middlewares sont fournis d'origine, dont de nouveaux : `httpcost` (temps, mémoire et CPU par requête, pour l'analyse de performance ou la facturation), `bodylimit`, `compress`, `counter`, `referrer`, `geolocation`, `ipaccess` et `servertiming`. Les implémentations de moteurs de vues ont été déplacées vers [iris-contrib/views](https://github.com/iris-contrib/views). ### La configuration est un littéral partiel `iris.Configuration` et les configurateurs `With*` sont remplacés par `iris.Options`. Renseignez les champs qui vous intéressent, le reste vient des valeurs par défaut. `Bind` charge du YAML depuis la variable d'environnement `SERVER_CONFIG`, puis depuis un fichier. ```go app := iris.New(iris.Options{Name: "myapp", LogLevel: "debug"}) ``` ### Des noms qui disent ce qu'ils font Lire un en-tête de requête et définir un en-tête de réponse ne partagent plus un préfixe qui change discrètement de sens : `ctx.Header` lit la requête, tandis que `ctx.SetHeader` et `ctx.ResponseHeader` travaillent sur la réponse. `Party` devient `Router`. `ctx.URLParam` devient `ctx.Query().Get`. Chaque renommage figure dans le guide de migration avec son remplacement, et la plupart tiennent en un rechercher-remplacer. ### Sécurisé par défaut Les cookies de session sont livrés avec `Secure` et `SameSite=Lax`. La limite de taille du corps de requête est appliquée sur tous les chemins de lecture. La reconstruction a emporté des bugs de longue date, parmi lesquels un limiteur de débit qui enregistrait les limites sans jamais les appliquer et un appel à `Logout` capable d'emporter le processus avec lui. ### Une documentation qui se lit du début à la fin v14 est livré avec un livre de 23 chapitres dans le dépôt, un tutoriel de démarrage qui construit une API REST testée en un seul document, un guide de migration pour les applications v12, et un wiki IA en direct généré depuis les sources qui répond aux questions sur le code. ### Ce que cela signifie pour votre code v12 Le chemin d'import devient `github.com/kataras/iris/v14`, donc v12 et v14 peuvent cohabiter et rien ne casse le jour de la sortie. Mettez à jour quand cela vous arrange. Le guide de migration couvre le chemin d'import, les déplacements de paquets, chaque API supprimée et son remplacement, ainsi que les changements de comportement, avec des commandes prêtes pour les parties mécaniques. Il n'y a pas encore de date de sortie publique. Surveillez les [releases](https://github.com/kataras/iris/releases) ou suivez [@iris_framework](https://twitter.com/iris_framework) pour l'apprendre en premier. ## 👑 Soutiens Avec votre aide, nous pouvons améliorer le développement web open source pour tout le monde !

## 📖 Démarrer avec Iris ### Installation Le seul prérequis est le [langage de programmation Go](https://go.dev/dl/). #### Créer un nouveau projet ```sh $ mkdir myapp $ cd myapp $ go mod init myapp $ go get github.com/kataras/iris/v12@latest # ou @v12.2.11 ```

Installer dans un projet existant

```sh $ cd myapp $ go get github.com/kataras/iris/v12@latest ``` **Exécuter** ```sh $ go mod tidy -compat=1.23 # -compat="1.23" sous windows. $ go run . ```

![](https://www.iris-go.com/images/gifs/install-create-iris.gif) Iris possède une **[documentation](https://www.iris-go.com/docs)** complète et précise qui facilite la prise en main du framework. Pour une documentation technique plus détaillée vous pouvez consulter nos [godocs](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.11). Et pour du code exécutable vous trouverez toujours le sous-dossier [./_examples](_examples) du dépôt. ### Développer avec Plexon AI [Plexon AI](https://plexon.ai) est un assistant de programmation IA multiplateforme signé Hellenic Development, et il est livré avec une **skill dédiée à Iris** : un guide de développement v14 écrit par l'auteur du framework, avec dix-neuf documents de référence couvrant le routage et les macros, l'API de contexte, les aides `rest`, la gestion des erreurs, les trente middlewares, les contrôleurs intégrés, le SDK d'authentification, le durcissement de la sécurité, la persistance, le cache, l'i18n, l'observabilité, les performances, les tests, le déploiement et la migration de v12 vers v14. Installez la persona **Software Developer** et la skill Iris arrive avec elle, aux côtés des agents d'ingénierie qu'elle active. Votre assistant écrit alors du code Iris tel que le framework est censé être utilisé, au lieu de deviner à partir de ce qu'il a croisé pendant son entraînement. ### Vous aimez lire en voyageant ?

[![follow author on twitter](https://img.shields.io/twitter/follow/makismaropoulos?color=3D8AA3&logoColor=3D8AA3&style=for-the-badge&logo=twitter)](https://twitter.com/intent/follow?screen_name=makismaropoulos) [![follow Iris web framework on twitter](https://img.shields.io/twitter/follow/iris_framework?color=ee7506&logoColor=ee7506&style=for-the-badge&logo=twitter)](https://twitter.com/intent/follow?screen_name=iris_framework) [![follow Iris web framework on facebook](https://img.shields.io/badge/Follow%20%40Iris.framework-569-2D88FF.svg?style=for-the-badge&logo=facebook)](https://www.facebook.com/iris.framework) Vous pouvez [demander](https://www.iris-go.com/#ebookDonateForm) dès aujourd'hui le PDF et l'accès en ligne à l'**E-Book Iris** (nouvelle édition) et participer au développement d'Iris. ## 🙌 Contribuer Toute contribution à Iris est la bienvenue ! Pour plus d'informations sur la contribution au projet référez-vous au fichier [CONTRIBUTING.md](CONTRIBUTING.md). [Liste des contributeurs](https://github.com/kataras/iris/graphs/contributors) ## 🛡 Sécurité et vulnérabilités Si vous trouvez une vulnérabilité dans Iris, envoyez un e-mail à [iris-go@outlook.com](mailto:iris-go@outlook.com). Toute vulnérabilité sera corrigée aussi rapidement que possible. ## 📝 Licence Le projet est sous [licence BSD 3 clauses](LICENSE), tout comme le langage Go lui-même. Le nom "Iris" est inspiré de la mythologie grecque.