/iris

The fastest HTTP/2 Go Web Framework. New, modern, easy to learn. Fast development with Code you control. Unbeatable cost-performance ratio :leaves: :rocket: | 谢谢 | #golang

Primary LanguageGoBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Iris Web Framework

build status view examples chat donate

Iris is a fast, simple yet fully featured and very efficient web framework for Go.

It provides a beautifully expressive and easy to use foundation for your next website or API.

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 <strong>%s</strong>!", "World")
  })

  app.Listen(":8080")
}

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, Amber, 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!

Learn what others saying about Iris and star this open-source project to support its potentials.

Benchmarks: Jul 18, 2020 at 10:46am (UTC)

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

@github is now sponsoring you for $550.00 one time.

A note from your new sponsor:

To celebrate Maintainer Month we want to thank you for all you do for the open source community. Check out our blog post to learn more about how GitHub is investing in maintainers. https://github.blog/2022-06-24-thank-you-to-our-maintainers/

Donations from China are now accepted!

getsentry lensesio github trading-peter basilarchia xiaozhuai AlbinoGeek celsosz TechMaster altafino gf3 alekperos hengestone thomasfr Basoz International Juanses ansrivas draFWM ekobayong lexrus li3p se77en simpleittools sumjoe vincent-li sascha11110 derReineke Sirisap22 hobysmith clacroix ixalender mubariz-ahmed stgrosshh rodrigoghm Cesar DavidShaw DmarshalTU IwateKyle Little-YangYang coderperu cshum dtrifonov ichenhe icibiri jfloresremar jingtianfeng kilarusravankumar leandrobraga lfbos lpintes macropas marcmmx mihado mmckeen75 olaf-lexemo pitexplore pr123 sankethpb saz59 shadowfiga skurtz97 srinivasganti tuhao1020 wahyuief xvalen xytis ElNovi KKP4 Lernakow Major2828 MatejLach odas0r pixelheresy syrm thanasolykos ukitzmann aprinslo1 kyoukhana mark2b siriushaha spazzymoto ArishSultan ehayun kukaki oshirokazuhide t6tg AwsIT BlackHole1 Hongjian0619 Jude-X KevinZhouRafael KrishManohar Laotanling MihaiPopescu1985 Neulhan NguyenPhuoc Oka00 Ramblestsad SamuelNeves TianJIANG Ubun1 XinYoungCN YukinaMochizuki a112121788 acdias agent3bood agoncecelia algoflows annieruci b2cbd baoch254 bastengao bjoroen bunnycodego carlos-enginner civicwar cnzhangquan donam-givita edwindna2 ekofedriyanto fenriz07 ffelipelimao geGao123 gnosthi goten002 guanzi008 hdezoscar93 hieungm homerious hzxd iantuan jackptoke jeremiahyan joelywz kana99 keeio khasanovrs kkdaypenny knavels kohakuhubo kostasvk leki75 liheyuan lingyingtan lipatti marman-hp mattbowen maxgozou miguel-devs mizzlespot mnievesco motogo mulyawansentosa nasoma ozfive paulxu21 phil535 pitt134 qiepeipei qiuzhanghua rapita relaera remopavithran rfunix rhernandez-itemsoft risallaw robivictor rxrw saleebm sbenimeli sebyno seun-otosho su1gen sukiejosh svirmi thepunterbot unixedia vadgun vguhesan vladimir-petukhov-sr vuhoanglam yonson2 SergeShin - BelmonduS blackHoleNgc1277 martinlindhe mdamschen mtrense netbaalzovf oliverjosefzimmer valkuere lfaynman ArturWierzbicki NA RainerGevers aaxx crashCoder dochoaj evillgenius75 gog200921 mwiater nikharsaxena rbondi statik thejones vcruzato CSRaghunandan GeorgeFourikis L-M-Sherlock edsongley evan grassshrimp hazmi-e205 jtgoral ky2s lauweliam letmestudy mblandr ndimorle primadi shyyawn wangbl11 wofka72 xsokev oleang michalsz Curtman claudemuller SridarDhandapani midhubalan rosales-stephanie opusmagna b4zz4r bobmcallan fangli galois-tnp geoshan juanxme nguyentamvinhlong tejzpr theantichris tuxaanand narven raphael-brand HieuLsw carlosmoran092 yangxianglong

📖 Learning Iris

Installation

The only requirement is the Go Programming Language.

Create a new project

$ mkdir myapp
$ cd myapp
$ go mod init myapp
$ go get github.com/kataras/iris/v12@master # or @v12.2.0-beta6
Install on existing project
$ cd myapp
$ go get github.com/kataras/iris/v12@master

Run

$ go mod tidy -compat=1.19
$ go run .

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

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?

Book cover

follow author on twitter

follow Iris web framework on twitter

follow Iris web framework on facebook

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 iris-go@outlook.com. 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.