Back to Iris

Iris Web Framework

README.md

12.2.1196.4 KB
Original Source
<!--<h1> News</h1> Iris version **12.2.0** has been [released](HISTORY.md#sa-11-march-2023--v1220)! As always, the latest version of Iris comes with the promise of lifetime active maintenance. Try the official [Iris Command Line Interface](https://github.com/kataras/iris-cli) today! -->

<a href="https://iris-go.com"></a> Iris Web Framework <a href="README_GR.md"> <a href="README_JA.md"></a> </a> <a href="README_FR.md"></a> <a href="README_ZH_HANT.md"></a> <a href="README_ZH_HANS.md"></a> <a href="README_ES.md"></a> <a href="README_FA.md"></a> <a href="README_RU.md"></a> <a href="README_KO.md"></a> <a href="README_PT_BR.md"></a> <a href="README_VN.md"></a>

<!--[![FOSSA Status](https://img.shields.io/badge/LICENSE%20SCAN-PASSING❀️-CD2956?style=for-the-badge&logo=fossa)](https://app.fossa.io/projects/git%2Bgithub.com%2Fkataras%2Firis?ref=badge_shield)--> <!--[![report card](https://img.shields.io/badge/report%20card-a%2B-ff3333.svg?style=for-the-badge)](https://goreportcard.com/report/github.com/kataras/iris)--><!--[![godocs](https://img.shields.io/badge/go-%20docs-488AC7.svg?style=for-the-badge)](https://pkg.go.dev/github.com/kataras/iris/[email protected])--> <!-- [![release](https://img.shields.io/badge/release%20-v12.0-0077b3.svg?style=for-the-badge)](https://github.com/kataras/iris/releases) -->

🎁 Iris is a fast, simple yet fully featured and very efficient web framework for Go - the perfect gift for developers this holiday season!

✨ It provides a beautifully expressive and easy to use foundation for your next website or API, wrapped with care and decorated with powerful features.

🌟 Learn what others saying about Iris and star this open-source project

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("Happy New Year <strong>%s</strong>! πŸŽ…", "World")
  })

  app.Listen(":8080")
}
<!-- <details><summary>More with simple Handler</summary> ```go package main import "github.com/kataras/iris/v12" type ( request struct { Firstname string `json:"firstname"` Lastname string `json:"lastname"` } response struct { ID string `json:"id"` Message string `json:"message"` } ) func main() { app := iris.New() app.Handle("PUT", "/users/{id:uuid}", updateUser) app.Listen(":8080") } func updateUser(ctx iris.Context) { id := ctx.Params().Get("id") var req request if err := ctx.ReadJSON(&req); err != nil { ctx.StopWithError(iris.StatusBadRequest, err) return } resp := response{ ID: id, Message: req.Firstname + " updated successfully", } ctx.JSON(resp) } ``` > Read the [routing examples](https://github.com/kataras/iris/blob/main/_examples/routing) for more! </details> <details><summary>Handler with custom input and output arguments</summary> [![https://github.com/kataras/iris/blob/main/_examples/dependency-injection/basic/main.go](https://user-images.githubusercontent.com/22900943/105253731-b8db6d00-5b88-11eb-90c1-0c92a5581c86.png)](https://twitter.com/iris_framework/status/1234783655408668672) > Interesting? Read the [examples](https://github.com/kataras/iris/blob/main/_examples/dependency-injection). </details> <details><summary>Party Controller (NEW)</summary> > Head over to the [full running example](https://github.com/kataras/iris/blob/main/_examples/routing/party-controller)! </details> <details><summary>MVC</summary> ```go package main import ( "github.com/kataras/iris/v12" "github.com/kataras/iris/v12/mvc" ) type ( request struct { Firstname string `json:"firstname"` Lastname string `json:"lastname"` } response struct { ID uint64 `json:"id"` Message string `json:"message"` } ) func main() { app := iris.New() mvc.Configure(app.Party("/users"), configureMVC) app.Listen(":8080") } func configureMVC(app *mvc.Application) { app.Handle(new(userController)) } type userController struct { // [...dependencies] } func (c *userController) PutBy(id uint64, req request) response { return response{ ID: id, Message: req.Firstname + " updated successfully", } } ``` Want to see more? Navigate through [mvc examples](_examples/mvc)! </details> <details><summary>API Guide <strong>HOT</strong></summary> ```go package main import ( // [other packages...] "github.com/kataras/iris/v12" ) func main() { iris.NewGuide(). AllowOrigin("*"). Compression(true). Health(true, "development", "kataras"). Timeout(0, 20*time.Second, 20*time.Second). Middlewares(basicauth.New(...)). Services( // NewDatabase(), // NewPostgresRepositoryRegistry, // NewUserService, ). API("/users", new(UsersAPI)). Listen(":80") } ``` </details> -->

As one Go developer once said, Iris got you covered all-round and standing strong over the years ⭐

Some of the features Iris offers:

  • HTTP/2 (Push, even Embedded data)
  • Middleware (Accesslog, Basicauth, CORS, gRPC, Anti-Bot hCaptcha, JWT, MethodOverride, ModRevision, Monitor, PPROF, Ratelimit, Anti-Bot reCaptcha, Recovery, RequestID, Rewrite)
  • API Versioning
  • Model-View-Controller
  • Websockets
  • gRPC
  • Auto-HTTPS
  • Builtin support for ngrok to put your app on the internet, the fastest way
  • Unique Router with dynamic path as parameter with standard types like :uuid, :string, :int... and the ability to create your own
  • Compression
  • View Engines (HTML, Django, Handlebars, Pug/Jade and more)
  • Create your own File Server and host your own WebDAV server
  • Cache
  • Localization (i18n, sitemap)
  • Sessions
  • Rich Responses (HTML, Text, Markdown, XML, YAML, Binary, JSON, JSONP, Protocol Buffers, MessagePack, Content Negotiation, Streaming, Server-Sent Events and more)
  • Response Compression (gzip, deflate, brotli, snappy, s2)
  • Rich Requests (Bind URL Query, Headers, Form, Text, XML, YAML, Binary, JSON, Validation, Protocol Buffers, MessagePack and more)
  • Dependency Injection (MVC, Handlers, API Routers)
  • Testing Suite
  • And the most important... you get fast answers and support from the 1st day until now - that's six full years!

πŸ‘‘ <a href="https://iris-go.com/donate">Supporters</a>

With your help, we can improve Open Source web development for everyone!

<p> <a href="https://github.com/getsentry"></a> <a href="https://github.com/github"></a> <a href="https://github.com/lensesio"></a> <a href="https://github.com/thepunterbot"></a> <a href="https://github.com/h4rdc0m"></a> <a href="https://github.com/draFWM"></a> <a href="https://github.com/gf3"></a> <a href="https://github.com/trading-peter"></a> <a href="https://github.com/AlbinoGeek"></a> <a href="https://github.com/basilarchia"></a> <a href="https://github.com/sumjoe"></a> <a href="https://github.com/simpleittools"></a> <a href="https://github.com/xiaozhuai"></a> <a href="https://github.com/Remydeme"></a> <a href="https://github.com/celsosz"></a> <a href="https://github.com/linxcoder"></a> <a href="https://github.com/jnelle"></a> <a href="https://github.com/TechMaster"></a> <a href="https://github.com/janwebdev"></a> <a href="https://github.com/altafino"></a> <a href="https://github.com/jakoubek"></a> <a href="https://github.com/alekperos"></a> <a href="https://github.com/day0ng"></a> <a href="https://github.com/hengestone"></a> <a href="https://github.com/thomasfr"></a> <a href="https://github.com/code-chimp"></a> <a href="https://github.com/CetinBasoz"></a> <a href="https://github.com/International"></a> <a href="https://github.com/Juanses"></a> <a href="https://github.com/SometimesMage"></a> <a href="https://github.com/ansrivas"></a> <a href="https://github.com/boreevyuri"></a> <a href="https://github.com/brentwilson"></a> <a href="https://github.com/camilbinas"></a> <a href="https://github.com/ekobayong"></a> <a href="https://github.com/lexrus"></a> <a href="https://github.com/li3p"></a> <a href="https://github.com/madhu72"></a> <a href="https://github.com/mosorize"></a> <a href="https://github.com/se77en"></a> <a href="https://github.com/tstangenberg"></a> <a href="https://github.com/vincent-li"></a> <a href="https://github.com/DavidShaw"></a> <a href="https://github.com/sascha11110"></a> <a href="https://github.com/clichi2002"></a> <a href="https://github.com/derReineke"></a> <a href="https://github.com/Sirisap22"></a> <a href="https://github.com/primadi"></a> <a href="https://github.com/agoncecelia"></a> <a href="https://github.com/chrisliang12"></a> <a href="https://github.com/zyu"></a> <a href="https://github.com/hobysmith"></a> <a href="https://github.com/pluja"></a> <a href="https://github.com/antonio-pedrazzini"></a> <a href="https://github.com/clacroix"></a> <a href="https://github.com/njeff3"></a> <a href="https://github.com/ixalender"></a> <a href="https://github.com/mubariz-ahmed"></a> <a href="https://github.com/Cesar"></a> <a href="https://github.com/th31nitiate"></a> <a href="https://github.com/stgrosshh"></a> <a href="https://github.com/Didainius"></a> <a href="https://github.com/DmarshalTU"></a> <a href="https://github.com/IwateKyle"></a> <a href="https://github.com/Little-YangYang"></a> <a href="https://github.com/Major2828"></a> <a href="https://github.com/MatejLach"></a> <a href="https://github.com/amritpal042"></a> <a href="https://github.com/andrefiorot"></a> <a href="https://github.com/boomhut"></a> <a href="https://github.com/cshum"></a> <a href="https://github.com/dtrifonov"></a> <a href="https://github.com/gadokrisztian"></a> <a href="https://github.com/geordee"></a> <a href="https://github.com/guanting112"></a> <a href="https://github.com/iantuan"></a> <a href="https://github.com/ichenhe"></a> <a href="https://github.com/rodrigoghm"></a> <a href="https://github.com/icibiri"></a> <a href="https://github.com/jewe11er"></a> <a href="https://github.com/jfloresremar"></a> <a href="https://github.com/jingtianfeng"></a> <a href="https://github.com/kilarusravankumar"></a> <a href="https://github.com/leandrobraga"></a> <a href="https://github.com/lfbos"></a> <a href="https://github.com/lpintes"></a> <a href="https://github.com/macropas"></a> <a href="https://github.com/marcmmx"></a> <a href="https://github.com/mark2b"></a> <a href="https://github.com/miguel-devs"></a> <a href="https://github.com/mihado"></a> <a href="https://github.com/mmckeen75"></a> <a href="https://github.com/narven"></a> <a href="https://github.com/odas0r"></a> <a href="https://github.com/olaf-lexemo"></a> <a href="https://github.com/pitexplore"></a> <a href="https://github.com/pr123"></a> <a href="https://github.com/rsousacode"></a> <a href="https://github.com/sankethpb"></a> <a href="https://github.com/wixregiga"></a> <a href="https://github.com/GeorgeFourikis"></a> <a href="https://github.com/saz59"></a> <a href="https://github.com/shadowfiga"></a> <a href="https://github.com/siriushaha"></a> <a href="https://github.com/skurtz97"></a> <a href="https://github.com/srinivasganti"></a> <a href="https://github.com/syrm"></a> <a href="https://github.com/tuhao1020"></a> <a href="https://github.com/BlackHole1"></a> <a href="https://github.com/L-M-Sherlock"></a> <a href="https://github.com/claudemuller"></a> <a href="https://github.com/keymanye"></a> <a href="https://github.com/wahyuief"></a> <a href="https://github.com/xuyan2018"></a> <a href="https://github.com/xvalen"></a> <a href="https://github.com/xytis"></a> <a href="https://github.com/ElNovi"></a> <a href="https://github.com/IpastorSan"></a> <a href="https://github.com/KKP4"></a> <a href="https://github.com/Lernakow"></a> <a href="https://github.com/ernestocolombo"></a> <a href="https://github.com/francisstephan"></a> <a href="https://github.com/pixelheresy"></a> <a href="https://github.com/rcapraro"></a> <a href="https://github.com/soiestad"></a> <a href="https://github.com/spkarason"></a> <a href="https://github.com/thanasolykos"></a> <a href="https://github.com/ukitzmann"></a> <a href="https://github.com/DanielKirkwood"></a> <a href="https://github.com/colinf"></a> <a href="https://github.com/simonproctor"></a> <a href="https://github.com/FernandoLangOFC"></a> <a href="https://github.com/Firdavs9512"></a> <a href="https://github.com/Flammable-Duck"></a> <a href="https://github.com/Gepetdo"></a> <a href="https://github.com/Hongjian0619"></a> <a href="https://github.com/JoeD"></a> <a href="https://github.com/Jude-X"></a> <a href="https://github.com/Kartoffelbot"></a> <a href="https://github.com/KevinZhouRafael"></a> <a href="https://github.com/KrishManohar"></a> <a href="https://github.com/Laotanling"></a> <a href="https://github.com/Longf99999"></a> <a href="https://github.com/Lyansun"></a> <a href="https://github.com/MihaiPopescu1985"></a> <a href="https://github.com/TBNilles"></a> <a href="https://github.com/ajanicij"></a> <a href="https://github.com/aprinslo1"></a> <a href="https://github.com/Mohammed8960"></a> <a href="https://github.com/NA"></a> <a href="https://github.com/Neulhan"></a> <a href="https://github.com/kyoukhana"></a> <a href="https://github.com/spazzymoto"></a> <a href="https://github.com/victorgrey"></a> <a href="https://github.com/ArishSultan"></a> <a href="https://github.com/ehayun"></a> <a href="https://github.com/kukaki"></a> <a href="https://github.com/oshirokazuhide"></a> <a href="https://github.com/t6tg"></a> <a href="https://github.com/15189573255"></a> <a href="https://github.com/AGPDev"></a> <a href="https://github.com/AnatolyUA"></a> <a href="https://github.com/AwsIT"></a> <a href="https://github.com/NguyenPhuoc"></a> <a href="https://github.com/Oka00"></a> <a href="https://github.com/PaddyFrenchman"></a> <a href="https://github.com/RainerGevers"></a> <a href="https://github.com/Ramblestsad"></a> <a href="https://github.com/SamuelNeves"></a> <a href="https://github.com/Scorpio69t"></a> <a href="https://github.com/Serissa4000"></a> <a href="https://github.com/TianJIANG"></a> <a href="https://github.com/Ubun1"></a> <a href="https://github.com/WangYajun39"></a> <a href="https://github.com/XinYoungCN"></a> <a href="https://github.com/YukinaMochizuki"></a> <a href="https://github.com/a112121788"></a> <a href="https://github.com/acdias"></a> <a href="https://github.com/aeonsthorn"></a> <a href="https://github.com/agent3bood"></a> <a href="https://github.com/ajb-neodynamics-io"></a> <a href="https://github.com/alessandromarotta"></a> <a href="https://github.com/algobot76"></a> <a href="https://github.com/algoflows"></a> <a href="https://github.com/angelaahhu"></a> <a href="https://github.com/anhxuanpham"></a> <a href="https://github.com/annieruci"></a> <a href="https://github.com/antoniejiao"></a> <a href="https://github.com/artman328"></a> <a href="https://github.com/b2cbd"></a> <a href="https://github.com/baoch254"></a> <a href="https://github.com/bastengao"></a> <a href="https://github.com/beytullahakyuz"></a> <a href="https://github.com/bjoroen"></a> <a href="https://github.com/blackHoleNgc1277"></a> <a href="https://github.com/bunnycodego"></a> <a href="https://github.com/carlos-enginner"></a> <a href="https://github.com/centratelemedia"></a> <a href="https://github.com/chrismalek"></a> <a href="https://github.com/civicwar"></a> <a href="https://github.com/cnzhangquan"></a> <a href="https://github.com/cuong48d"></a> <a href="https://github.com/damiensy"></a> <a href="https://github.com/danlanxiaohei"></a> <a href="https://github.com/dextercai"></a> <a href="https://github.com/dfaugusto"></a> <a href="https://github.com/dkzhang"></a> <a href="https://github.com/dloprodu"></a> <a href="https://github.com/donam-givita"></a> <a href="https://github.com/dph0899"></a> <a href="https://github.com/dvitale"></a> <a href="https://github.com/ec0629"></a> <a href="https://github.com/edwindna2"></a> <a href="https://github.com/ekiyooka"></a> <a href="https://github.com/ekofedriyanto"></a> <a href="https://github.com/eli-yip"></a> <a href="https://github.com/eljefedelrodeodeljefe"></a> <a href="https://github.com/fenriz07"></a> <a href="https://github.com/ffelipelimao"></a> <a href="https://github.com/frenchmajesty"></a> <a href="https://github.com/gastropulgite"></a> <a href="https://github.com/geGao123"></a> <a href="https://github.com/globalflea"></a> <a href="https://github.com/gloudx"></a> <a href="https://github.com/gnosthi"></a> <a href="https://github.com/gogoswift"></a> <a href="https://github.com/goten002"></a> <a href="https://github.com/guanzi008"></a> <a href="https://github.com/hdezoscar93"></a> <a href="https://github.com/hieungm"></a> <a href="https://github.com/hieunmg"></a> <a href="https://github.com/homerious"></a> <a href="https://github.com/hzxd"></a> <a href="https://github.com/inyellowbus"></a> <a href="https://github.com/iuliancarnaru"></a> <a href="https://github.com/iysaleh"></a> <a href="https://github.com/jackptoke"></a> <a href="https://github.com/jackysywk"></a> <a href="https://github.com/jeff2go"></a> <a href="https://github.com/jeremiahyan"></a> <a href="https://github.com/joelywz"></a> <a href="https://github.com/kamolcu"></a> <a href="https://github.com/kana99"></a> <a href="https://github.com/edsongley"></a> <a href="https://github.com/katsubushiken"></a> <a href="https://github.com/kattaprasanth"></a> <a href="https://github.com/keeio"></a> <a href="https://github.com/keval6706"></a> <a href="https://github.com/khasanovrs"></a> <a href="https://github.com/kkdaypenny"></a> <a href="https://github.com/knavels"></a> <a href="https://github.com/kohakuhubo"></a> <a href="https://github.com/korowiov"></a> <a href="https://github.com/kostasvk"></a> <a href="https://github.com/lafayetteDan"></a> <a href="https://github.com/lbsubash"></a> <a href="https://github.com/leki75"></a> <a href="https://github.com/lemuelroberto"></a> <a href="https://github.com/liheyuan"></a> <a href="https://github.com/lingyingtan"></a> <a href="https://github.com/linuxluigi"></a> <a href="https://github.com/lipatti"></a> <a href="https://github.com/maikelcoke"></a> <a href="https://github.com/marek-kuticka"></a> <a href="https://github.com/marman-hp"></a> <a href="https://github.com/mattbowen"></a> <a href="https://github.com/maxgozou"></a> <a href="https://github.com/maxgozzz"></a> <a href="https://github.com/mitas"></a> <a href="https://github.com/mizzlespot"></a> <a href="https://github.com/mkell43"></a> <a href="https://github.com/mnievesco"></a> <a href="https://github.com/mo3lyana"></a> <a href="https://github.com/motogo"></a> <a href="https://github.com/mtrense"></a> <a href="https://github.com/mukunhao"></a> <a href="https://github.com/mulyawansentosa"></a> <a href="https://github.com/nasoma"></a> <a href="https://github.com/ngseiyu"></a> <a href="https://github.com/nikharsaxena"></a> <a href="https://github.com/nronzel"></a> <a href="https://github.com/odelanno"></a> <a href="https://github.com/onlysumitg"></a> <a href="https://github.com/xPoppa"></a> <a href="https://github.com/yesudeep"></a> <a href="https://github.com/ymonk"></a> <a href="https://github.com/yonson2"></a> <a href="https://github.com/yshengliao"></a> <a href="https://github.com/ytxmobile98"></a> <a href="https://github.com/yusong-offx"></a> <a href="https://github.com/zhenggangpku"></a> <a href="https://github.com/zou8944"></a> <a href="https://github.com/SergeShin"></a> <a href="https://github.com/-"></a> <a href="https://github.com/BelmonduS"></a> <a href="https://github.com/Diewald"></a> <a href="https://github.com/cty4ka"></a> <a href="https://github.com/martinjanda"></a> <a href="https://github.com/evan"></a> <a href="https://github.com/hazmi-e205"></a> <a href="https://github.com/jtgoral"></a> <a href="https://github.com/ky2s"></a> <a href="https://github.com/lauweliam"></a> <a href="https://github.com/ozfive"></a> <a href="https://github.com/paulcockrell"></a> <a href="https://github.com/paulxu21"></a> <a href="https://github.com/pesquive"></a> <a href="https://github.com/petros9282"></a> <a href="https://github.com/phil535"></a> <a href="https://github.com/pitt134"></a> <a href="https://github.com/poscard"></a> <a href="https://github.com/qiepeipei"></a> <a href="https://github.com/qiuzhanghua"></a> <a href="https://github.com/rapita"></a> <a href="https://github.com/rbondi"></a> <a href="https://github.com/relaera"></a> <a href="https://github.com/remopavithran"></a> <a href="https://github.com/rfunix"></a> <a href="https://github.com/rhernandez-itemsoft"></a> <a href="https://github.com/rikoriswandha"></a> <a href="https://github.com/risallaw"></a> <a href="https://github.com/robivictor"></a> <a href="https://github.com/rubiagatra"></a> <a href="https://github.com/rubyangxg"></a> <a href="https://github.com/rxrw"></a> <a href="https://github.com/saleebm"></a> <a href="https://github.com/sbenimeli"></a> <a href="https://github.com/sebyno"></a> <a href="https://github.com/seun-otosho"></a> <a href="https://github.com/shobhitsinghal77"></a> <a href="https://github.com/solohiroshi"></a> <a href="https://github.com/su1gen"></a> <a href="https://github.com/sukiejosh"></a> <a href="https://github.com/suresh16671"></a> <a href="https://github.com/svirmi"></a> <a href="https://github.com/terjelafton"></a> <a href="https://github.com/thiennguyen93"></a> <a href="https://github.com/unixedia"></a> <a href="https://github.com/vadgun"></a> <a href="https://github.com/valsorym"></a> <a href="https://github.com/vguhesan"></a> <a href="https://github.com/vpiduri"></a> <a href="https://github.com/vrocadev"></a> <a href="https://github.com/vuhoanglam"></a> <a href="https://github.com/walter-wang"></a> <a href="https://github.com/martinlindhe"></a> <a href="https://github.com/mdamschen"></a> <a href="https://github.com/letmestudy"></a> <a href="https://github.com/michaelsmanley"></a> <a href="https://github.com/Curtman"></a> <a href="https://github.com/SridarDhandapani"></a> <a href="https://github.com/madrigaltenor"></a> <a href="https://github.com/opusmagna"></a> <a href="https://github.com/ShahramMebashar"></a> <a href="https://github.com/b4zz4r"></a> <a href="https://github.com/bobmcallan"></a> <a href="https://github.com/fangli"></a> <a href="https://github.com/galois-tnp"></a> <a href="https://github.com/mblandr"></a> <a href="https://github.com/midhubalan"></a> <a href="https://github.com/netbaalzovf"></a> <a href="https://github.com/oliverjosefzimmer"></a> <a href="https://github.com/peacememories"></a> <a href="https://github.com/talebisinan"></a> <a href="https://github.com/valkuere"></a> <a href="https://github.com/lfaynman"></a> <a href="https://github.com/ArturWierzbicki"></a> <a href="https://github.com/aaxx"></a> <a href="https://github.com/crashCoder"></a> <a href="https://github.com/derekslenk"></a> <a href="https://github.com/dochoaj"></a> <a href="https://github.com/evillgenius75"></a> <a href="https://github.com/gog200921"></a> <a href="https://github.com/mauricedcastro"></a> <a href="https://github.com/mwiater"></a> <a href="https://github.com/sj671"></a> <a href="https://github.com/statik"></a> <a href="https://github.com/supersherm5"></a> <a href="https://github.com/thejones"></a> <a href="https://github.com/CSRaghunandan"></a> <a href="https://github.com/ndimorle"></a> <a href="https://github.com/rosales-stephanie"></a> <a href="https://github.com/shyyawn"></a> <a href="https://github.com/vcruzato"></a> <a href="https://github.com/wangbl11"></a> <a href="https://github.com/wofka72"></a> <a href="https://github.com/geoshan"></a> <a href="https://github.com/juanxme"></a> <a href="https://github.com/nguyentamvinhlong"></a> <a href="https://github.com/yoru74"></a> <a href="https://github.com/xsokev"></a> <a href="https://github.com/oleang"></a> <a href="https://github.com/michalsz"></a> <a href="https://github.com/pomland-94"></a> <a href="https://github.com/tejzpr"></a> <a href="https://github.com/theantichris"></a> <a href="https://github.com/tuxaanand"></a> <a href="https://github.com/raphael-brand"></a> <a href="https://github.com/willypuzzle"></a> <a href="https://github.com/dmcbane"></a> <a href="https://github.com/malcolm-white-dti"></a> <a href="https://github.com/HieuLsw"></a> <a href="https://github.com/carlosmoran092"></a> <a href="https://github.com/yangxianglong"></a> </p>

πŸ“– Learning Iris

Installation

The only requirement is the Go Programming Language.

Create a new project

sh
$ mkdir myapp
$ cd myapp
$ go mod init myapp
$ go get github.com/kataras/iris/v12@latest # or @v12.2.11
<details><summary>Install on existing project</summary>
sh
$ cd myapp
$ go get github.com/kataras/iris/v12@latest

Run

sh
$ go mod tidy -compat=1.23 # -compat="1.23" for windows.
$ go run .
</details>

Iris contains extensive and thorough documentation making it easy to get started with the framework.

<!-- Iris contains extensive and thorough **[wiki](https://github.com/kataras/iris/wiki)** making it easy to get started with the framework. --> <!-- ![](https://media.giphy.com/media/Ur8iqy9FQfmPuyQpgy/giphy.gif) -->

For a more detailed technical documentation you can head over to our godocs. And for executable code you can always visit the ./_examples repository's subdirectory.

Do you like to read while traveling?

<a href="https://iris-go.com/#book"> </a>

You can request a PDF and online access of the Iris E-Book (New Edition, future v12.2.0+) today and be participated in the development of Iris.

πŸ™Œ Contributing

We'd love to see your contribution to the Iris Web Framework! For more information about contributing to the Iris project please check the CONTRIBUTING.md file.

List of all Contributors

πŸ›‘ Security Vulnerabilities

If you discover a security vulnerability within Iris, please send an e-mail to [email protected]. All security vulnerabilities will be promptly addressed.

πŸ“ License

This project is licensed under the BSD 3-clause license, just like the Go project itself.

The project name "Iris" was inspired by the Greek mythology.

<!-- ## Stargazers over time [![Stargazers over time](https://starchart.cc/kataras/iris.svg)](https://starchart.cc/kataras/iris) -->