2020-08-09 19:28:25 +02:00
[](https://support.eji.org/give/153413/#!/donation/checkout)
2020-08-09 19:23:18 +02:00
<!-- # News -->
2019-12-31 23:42:44 +01:00
2020-07-18 13:35:27 +02:00
> This is the under-**development branch**. Stay tuned for the upcoming release [v12.2.0](HISTORY.md#Next). Looking for a stable release? Head over to the [v12.1.8 branch](https://github.com/kataras/iris/tree/v12.1.8) instead.
2020-08-09 19:23:18 +02:00
>
>  Try the official [Iris Command Line Interface](https://github.com/kataras/iris-cli) today!
2020-04-29 20:59:36 +02:00
2020-06-20 23:12:07 +02:00
<!--  Iris version **12.1.8** has been [released ](HISTORY.md#su-16-february-2020--v1218 )! -->
2019-07-22 11:05:16 +02:00
2020-04-29 20:59:36 +02:00
# Iris Web Framework <a href="README_GR.md"><img width="20px" src="https://iris-go.com/images/flag-greece.svg" /></a> <a href="README_FR.md"><img width="20px" src="https://iris-go.com/images/flag-france.svg" /></a> <a href="README_ZH.md"><img width="20px" src="https://iris-go.com/images/flag-china.svg" /></a> <a href="README_ES.md"><img width="20px" src="https://iris-go.com/images/flag-spain.png" /></a> <a href="README_FA.md"><img width="20px" src="https://iris-go.com/images/flag-iran.svg" /></a> <a href="README_RU.md"><img width="20px" src="https://iris-go.com/images/flag-russia.svg" /></a> <a href="README_KO.md"><img width="20px" src="https://iris-go.com/images/flag-south-korea.svg?v=12" /></a>
2019-11-05 21:12:26 +01:00
2020-11-06 13:19:53 +01:00
[](https://travis-ci.org/kataras/iris) [](https://github.com/kataras/iris/tree/master/_examples) [](https://gitter.im/iris_go/community) <!--[](https://iris-go.com/donate) <!--[](https://goreportcard.com/report/github.com/kataras/iris)--><!--[](https://pkg.go.dev/github.com/kataras/iris/v12@v12.2.0)--> <!-- [](https://github.com/kataras/iris/releases) -->
2018-07-24 03:33:53 +02:00
2020-07-28 12:56:52 +02:00
<!-- <a href="https://iris - go.com"> <img align="right" src="https://iris - go.com/images/logo - w169.png"></a> -->
2018-07-24 03:33:53 +02:00
2020-02-11 02:55:06 +01:00
Iris is a fast, simple yet fully featured and very efficient web framework for Go.
2020-02-11 02:24:57 +01:00
2020-02-11 02:55:06 +01:00
It provides a beautifully expressive and easy to use foundation for your next website or API.
2018-07-24 03:33:53 +02:00
2020-10-01 23:59:32 +02:00
Learn what [others saying about Iris ](https://www.iris-go.com/#review ) and ** [star ](https://github.com/kataras/iris/stargazers )** this open-source project to support its potentials.
2019-12-13 22:06:18 +01:00
2020-07-28 12:56:52 +02:00
[](https://iris-go.com/testimonials/)
2020-02-11 02:24:57 +01:00
2020-07-18 13:35:27 +02:00
[](https://github.com/kataras/server-benchmarks)
2020-03-12 00:51:21 +01:00
2020-09-03 00:53:51 +02:00
## 👑 <a href="https://iris-go.com/donate">Supporters</a>
2020-08-12 17:23:00 +02:00
2020-09-16 19:27:01 +02:00
With your help, we can improve Open Source web development for everyone!
> Donations from **China** are now accepted!
2020-08-12 17:32:33 +02:00
< p >
2020-11-17 05:36:13 +01:00
< a href = "https://github.com/vuhoanglam" > < img src = "https://avatars1.githubusercontent.com/u/59502855?v=4" alt = "Vu Hoang Lam" title = "vuhoanglam" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-11-06 13:19:53 +01:00
< a href = "https://github.com/dtrifonov" > < img src = "https://avatars1.githubusercontent.com/u/1520118?v=4" alt = "Dimitar Trifonov" title = "dtrifonov" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-11-02 17:48:08 +01:00
< a href = "https://github.com/midhubalan" > < img src = "https://avatars1.githubusercontent.com/u/13059634?v=4" alt = "Midhubalan Balasubramanian" title = "midhubalan" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-31 05:06:57 +01:00
< a href = "https://github.com/tuxaanand" > < img src = "https://avatars1.githubusercontent.com/u/9750371?v=4" alt = "AANAND NATARAJAN" title = "tuxaanand" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/edsongley" > < img src = "https://avatars1.githubusercontent.com/u/35545454?v=4" alt = "Edsongley Almeida" title = "edsongley" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/ganben" > < img src = "https://avatars1.githubusercontent.com/u/10101347?v=4" alt = "ganben" title = "ganben" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/tejzpr" > < img src = "https://avatars1.githubusercontent.com/u/2813811?v=4" alt = "Tejus Pratap" title = "tejzpr" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/BlackHole1" > < img src = "https://avatars1.githubusercontent.com/u/8198408?v=4" alt = "cui hexiang" title = "BlackHole1" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/wangbl11" > < img src = "https://avatars1.githubusercontent.com/u/14358532?v=4" alt = "tinawang" title = "wangbl11" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/juanxme" > < img src = "https://avatars1.githubusercontent.com/u/661043?v=4" alt = "Juan David Parra Pimiento" title = "juanxme" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/andychongyz" > < img src = "https://avatars1.githubusercontent.com/u/12697240?v=4" alt = "Andy Chong Ying Zhi" title = "andychongyz" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-18 17:26:01 +02:00
< a href = "https://github.com/KevinZhouRafael" > < img src = "https://avatars1.githubusercontent.com/u/16298046?v=4" alt = "Kevin Zhou" title = "KevinZhouRafael" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-12 01:07:04 +02:00
< a href = "https://github.com/mizzlespot" > < img src = "https://avatars1.githubusercontent.com/u/2654538?v=4" alt = "Jasper" title = "mizzlespot" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-10 11:25:54 +02:00
< a href = "https://github.com/wiener01mu" > < img src = "https://avatars1.githubusercontent.com/u/41128011?v=4" alt = "Simranjit Singh" title = "wiener01mu" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/theantichris" > < img src = "https://avatars1.githubusercontent.com/u/1486502?v=4" alt = "Christopher Lamm" title = "theantichris" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/L-M-Sherlock" > < img src = "https://avatars1.githubusercontent.com/u/32575846?v=4" alt = "叶峻峣" title = "L-M-Sherlock" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/tsailiting" > < img src = "https://avatars1.githubusercontent.com/u/48909556?v=4" alt = "TSAI LI TING" title = "tsailiting" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-10 11:30:37 +02:00
< a href = "https://github.com/TonyZhu" > < img src = "https://avatars1.githubusercontent.com/u/677477?v=4" alt = "zhutao" title = "TonyZhu" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-10 11:48:45 +02:00
< a href = "https://github.com/goten002" > < img src = "https://avatars1.githubusercontent.com/u/5025060?v=4" alt = "George Alexiou" title = "goten002" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-10 11:52:06 +02:00
< a href = "https://github.com/jazar17" > < img src = "https://avatars1.githubusercontent.com/u/1813513?v=4" alt = "Jobert Azares" title = "jazar17" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-04 18:48:49 +02:00
< a href = "https://github.com/nguyentamvinhlong" > < img src = "https://avatars1.githubusercontent.com/u/1875916?v=4" alt = "Tam Nguyen" title = "nguyentamvinhlong" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/vguhesan" > < img src = "https://avatars1.githubusercontent.com/u/193960?v=4" alt = "
Venkatt Guhesan" title="vguhesan" with="75" style="width:75px;max-width:75px;height:75px" height="75" />< / a >
2020-10-02 14:13:44 +02:00
< a href = "https://github.com/Cesar" > < img src = "https://avatars1.githubusercontent.com/u/1581870?v=4" alt = "Anibal C C Budaye" title = "Cesar" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-10-01 16:32:09 +02:00
< a href = "https://github.com/unixedia" > < img src = "https://avatars1.githubusercontent.com/u/70646128?v=4" alt = "ARAN ROKA" title = "unixedia" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/ky2s" > < img src = "https://avatars1.githubusercontent.com/u/19502125?v=4" alt = "Valentine" title = "ky2s" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/CSRaghunandan" > < img src = "https://avatars1.githubusercontent.com/u/5226809?v=4" alt = "Chakravarthy Raghunandan" title = "CSRaghunandan" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-28 11:48:45 +02:00
< a href = "https://github.com/maxbertinetti" > < img src = "https://avatars1.githubusercontent.com/u/26814295?v=4" alt = "Massimiliano Bertinetti" title = "maxbertinetti" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/HieuLsw" > < img src = "https://avatars1.githubusercontent.com/u/1675478?v=4" alt = "Hieu Trinh" title = "HieuLsw" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-23 02:42:53 +02:00
< a href = "https://github.com/jingtianfeng" > < img src = "https://avatars1.githubusercontent.com/u/19503202?v=4" alt = "J.T. Feng" title = "jingtianfeng" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-21 17:44:52 +02:00
< a href = "https://github.com/leki75" > < img src = "https://avatars1.githubusercontent.com/u/9675379?v=4" alt = "Gabor Lekeny" title = "leki75" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-19 16:47:44 +02:00
< a href = "https://github.com/lihaotian0607" > < img src = "https://avatars1.githubusercontent.com/u/32523475?v=4" alt = "LiHaotian" title = "lihaotian0607" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-17 12:44:13 +02:00
< a href = "https://github.com/Little-YangYang" > < img src = "https://avatars1.githubusercontent.com/u/10755202?v=4" alt = "Muyang Li" title = "Little-YangYang" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-16 18:41:48 +02:00
< a href = "https://github.com/tuhao1020" > < img src = "https://avatars1.githubusercontent.com/u/26807520?v=4" alt = "Hao Tu" title = "tuhao1020" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-16 10:19:02 +02:00
< a href = "https://github.com/CetinBasoz" > < img src = "https://avatars1.githubusercontent.com/u/3152637?v=4" alt = "Cetin Basoz" title = "CetinBasoz" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-11 10:42:27 +02:00
< a href = "https://github.com/hazmi-e205" > < img src = "https://avatars1.githubusercontent.com/u/12555465?v=4" alt = "Hazmi Amalul" title = "hazmi-e205" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/remyDeme" > < img src = "https://avatars1.githubusercontent.com/u/22757039?v=4" alt = "Rémy Deme" title = "remyDeme" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-06 12:24:53 +02:00
< a href = "https://github.com/vincent-li" > < img src = "https://avatars1.githubusercontent.com/u/765470?v=4" alt = "Vincent Li" title = "vincent-li" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-03 14:36:30 +02:00
< a href = "https://github.com/mtrense" > < img src = "https://avatars1.githubusercontent.com/u/1008285?v=4" alt = "Max Trense" title = "mtrense" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-09-03 00:53:51 +02:00
< a href = "https://github.com/MatejLach" > < img src = "https://avatars1.githubusercontent.com/u/531930?v=4" alt = "Matej Lach" title = "MatejLach" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-08-28 07:31:50 +02:00
< a href = "https://github.com/sumjoe" > < img src = "https://avatars1.githubusercontent.com/u/32655210?v=4" alt = "Joseph De Paola" title = "sumjoe" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-08-18 18:02:20 +02:00
< a href = "https://github.com/AlbinoGeek" > < img src = "https://avatars1.githubusercontent.com/u/1910461?v=4" alt = "Damon Blais" title = "AlbinoGeek" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-08-12 17:32:33 +02:00
< a href = "https://github.com/LYF123123" > < img src = "https://avatars1.githubusercontent.com/u/33317812?v=4" alt = "陆 轶丰" title = "LYF123123" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/xiaozhuai" > < img src = "https://avatars1.githubusercontent.com/u/4773701?v=4" alt = "Weihang Ding" title = "xiaozhuai" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/fangli" > < img src = "https://avatars1.githubusercontent.com/u/3032639?v=4" alt = "Li Fang" title = "fangli" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/TechMaster" > < img src = "https://avatars1.githubusercontent.com/u/1491686?v=4" alt = "TechMaster" title = "TechMaster" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/lensesio" > < img src = "https://avatars1.githubusercontent.com/u/11728472?v=4" alt = "lenses.io" title = "lensesio" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/celsosz" > < img src = "https://avatars1.githubusercontent.com/u/3466493?v=4" alt = "Celso Souza" title = "celsosz" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/altafino" > < img src = "https://avatars1.githubusercontent.com/u/24539467?v=4" alt = "Altafino" title = "altafino" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/thomasfr" > < img src = "https://avatars1.githubusercontent.com/u/287432?v=4" alt = "Thomas Fritz" title = "thomasfr" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/hengestone" > < img src = "https://avatars1.githubusercontent.com/u/362587?v=4" alt = "Conrad Steenberg" title = "hengestone" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/se77en" > < img src = "https://avatars1.githubusercontent.com/u/1468284?v=4" alt = "Damon Zhao" title = "se77en" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/International" > < img src = "https://avatars1.githubusercontent.com/u/1022918?v=4" alt = "George Opritescu" title = "International" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/Juanses" > < img src = "https://avatars1.githubusercontent.com/u/6137970?v=4" alt = "Juanses" title = "Juanses" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/ansrivas" > < img src = "https://avatars1.githubusercontent.com/u/1695056?v=4" alt = "Ankur Srivastava" title = "ansrivas" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/lexrus" > < img src = "https://avatars1.githubusercontent.com/u/219689?v=4" alt = "Lex Tang" title = "lexrus" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/li3p" > < img src = "https://avatars1.githubusercontent.com/u/55519?v=4" alt = "li3p" title = "li3p" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-08-12 17:23:00 +02:00
< / p >
2020-02-11 02:24:57 +01:00
## 📖 Learning Iris
2019-07-22 04:46:30 +02:00
2018-07-25 05:14:33 +02:00
```sh
2020-09-25 19:21:41 +02:00
$ mkdir myapp
$ go mod init myapp
$ go get github.com/kataras/iris/v12@master
2018-07-25 05:14:33 +02:00
```
2020-10-01 23:59:32 +02:00
2020-09-13 22:14:13 +02:00
Iris contains extensive and thorough ** [documentation ](https://www.iris-go.com/docs )** making it easy to get started with the framework.
2020-06-23 23:13:31 +02:00
2020-09-02 12:44:19 +02:00
<!-- Iris contains extensive and thorough ** [wiki ](https://github.com/kataras/iris/wiki )** making it easy to get started with the framework. -->
2019-07-22 04:46:30 +02:00
2019-12-25 11:11:45 +01:00
<!--  -->
2019-11-14 19:16:34 +01:00
2020-06-20 23:12:07 +02:00
For a more detailed technical documentation you can head over to our [godocs ](https://godoc.org/github.com/kataras/iris ). And for executable code you can always visit the [./_examples ](_examples ) repository's subdirectory.
2019-07-22 03:39:14 +02:00
2019-07-22 04:46:30 +02:00
### Do you like to read while traveling?
2019-07-22 03:39:14 +02:00
2020-08-12 17:23:00 +02:00
< a href = "https://iris-go.com/#book" > < img alt = "Book cover" src = "https://iris-go.com/images/iris-book-cover-sm.jpg?v=12" / > < / a >
2019-07-30 17:02:02 +02:00
2020-11-06 13:19:53 +01:00
[](https://twitter.com/intent/follow?screen_name=makismaropoulos)
2020-08-12 23:52:33 +02:00
[](https://twitter.com/intent/follow?screen_name=iris_framework)
2020-11-06 13:19:53 +01:00
[](https://www.facebook.com/iris.framework)
2019-07-22 03:39:14 +02:00
2020-09-01 16:58:07 +02:00
You can [request ](https://www.iris-go.com/#ebookDonateForm ) 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.
2018-07-24 03:33:53 +02:00
2020-02-11 02:24:57 +01:00
## 🙌 Contributing
2018-07-24 03:33:53 +02:00
2019-07-22 04:46:30 +02:00
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 ](CONTRIBUTING.md ) file.
[List of all Contributors ](https://github.com/kataras/iris/graphs/contributors )
2020-02-11 02:24:57 +01:00
## 🛡 Security Vulnerabilities
2019-07-22 04:46:30 +02:00
If you discover a security vulnerability within Iris, please send an e-mail to [iris-go@outlook.com ](mailto:iris-go@outlook.com ). All security vulnerabilities will be promptly addressed.
2020-02-11 02:24:57 +01:00
## 📝 License
2018-07-24 03:33:53 +02:00
2020-02-03 09:50:58 +01:00
This project is licensed under the [BSD 3-clause license ](LICENSE ), just like the Go project itself.
2019-07-22 04:46:30 +02:00
2020-02-03 09:50:58 +01:00
The project name "Iris" was inspired by the Greek mythology.
2020-02-11 02:24:57 +01:00
<!-- ## Stargazers over time
2019-11-19 22:36:18 +01:00
2020-02-11 02:24:57 +01:00
[](https://starchart.cc/kataras/iris) -->
