2020-08-09 19:28:25 +02:00
[](https://support.eji.org/give/153413/#!/donation/checkout)
2020-08-09 19:23:18 +02:00
2021-01-10 10:51:49 +01: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
2021-02-19 08:58:29 +01:00
[](https://github.com/kataras/iris/actions) [](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
2021-01-23 04:14:00 +01:00
< details > < summary > 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 uint64 `json:"id"`
Message string `json:"message"`
}
)
func main() {
app := iris.New()
app.Handle("PUT", "/users/{id:uint64}", updateUser)
app.Listen(":8080")
}
func updateUser(ctx iris.Context) {
id, _ := ctx.Params().GetUint64("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/master/_examples/routing) for more!
< / details >
< details > < summary > Handler with custom input and output arguments< / summary >
2021-01-21 00:41:47 +01:00
[](https://twitter.com/iris_framework/status/1234783655408668672)
2021-01-23 04:14:00 +01:00
> Interesting? Read the [examples](https://github.com/kataras/iris/blob/master/_examples/dependency-injection).
< / 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 >
2021-01-21 00:36:11 +01: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 >
2021-03-03 23:42:50 +01:00
< a href = "https://github.com/cpp2go" > < img src = "https://avatars1.githubusercontent.com/u/12148026?v=4" alt = "Li Yang" title = "cpp2go" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/lafayetteDan" > < img src = "https://avatars1.githubusercontent.com/u/26064396?v=4" alt = "Qianyu Zhou" title = "lafayetteDan" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/anilpdv" > < img src = "https://avatars1.githubusercontent.com/u/32708402?v=4" alt = "anilpdv" title = "anilpdv" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-02-12 08:09:59 +01:00
< a href = "https://github.com/baoch254" > < img src = "https://avatars1.githubusercontent.com/u/74555344?v=4" alt = "CAO HOAI BAO" title = "baoch254" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-02-08 19:06:01 +01:00
< a href = "https://github.com/hdezoscar93" > < img src = "https://avatars1.githubusercontent.com/u/21270107?v=4" alt = "Oscar Hernandez" title = "hdezoscar93" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-02-06 20:48:44 +01:00
< a href = "https://github.com/blackHoleNgc1277" > < img src = "https://avatars1.githubusercontent.com/u/41342763?v=4" alt = "Gerard Lancea" title = "blackHoleNgc1277" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-31 19:22:49 +01:00
< a href = "https://github.com/Neulhan" > < img src = "https://avatars1.githubusercontent.com/u/52434903?v=4" alt = "neulhan" title = "Neulhan" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/kana99" > < img src = "https://avatars1.githubusercontent.com/u/3714069?v=4" alt = "xushiquan" title = "kana99" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-23 23:48:46 +01:00
< a href = "https://github.com/mattbowen" > < img src = "https://avatars1.githubusercontent.com/u/46803?v=4" alt = "Matt" title = "mattbowen" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-20 23:42:35 +01:00
< a href = "https://github.com/lpintes" > < img src = "https://avatars1.githubusercontent.com/u/2546783?v=4" alt = "Ľuboš Pinteš" title = "lpintes" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-15 21:46:06 +01:00
< a href = "https://github.com/mmckeen75" > < img src = "https://avatars1.githubusercontent.com/u/49529489?v=4" alt = "Leighton McKeen" title = "mmckeen75" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/lauweliam" > < img src = "https://avatars1.githubusercontent.com/u/4064517?v=4" alt = "Weliam" title = "lauweliam" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/galois-tnp" > < img src = "https://avatars1.githubusercontent.com/u/41128011?v=4" alt = "simranjit singh" title = "galois-tnp" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-15 21:57:46 +01:00
< a href = "https://github.com/gnosthi" > < img src = "https://avatars1.githubusercontent.com/u/17650528?v=4" alt = "Kenneth Jordan" title = "gnosthi" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/ndimorle" > < img src = "https://avatars1.githubusercontent.com/u/76732415?v=4" alt = "Morlé Koudeka" title = "ndimorle" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-10 10:51:49 +01:00
< a href = "https://github.com/rsousacode" > < img src = "https://avatars1.githubusercontent.com/u/34067397?v=4" alt = "Rui" title = "rsousacode" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/carlos-enginner" > < img src = "https://avatars1.githubusercontent.com/u/59775876?v=4" alt = "Carlos Augusto" title = "carlos-enginner" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-07 03:14:41 +01:00
< a href = "https://github.com/motogo" > < img src = "https://avatars1.githubusercontent.com/u/1704958?v=4" alt = "Horst Ender" title = "motogo" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-06 00:52:39 +01:00
< a href = "https://github.com/remopavithran" > < img src = "https://avatars1.githubusercontent.com/u/50388068?v=4" alt = "Pavithran" title = "remopavithran" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/mulyawansentosa" > < img src = "https://avatars1.githubusercontent.com/u/29946673?v=4" alt = "MULYAWAN SENTOSA" title = "mulyawansentosa" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2021-01-01 22:01:27 +01:00
< a href = "https://github.com/TianJIANG" > < img src = "https://avatars1.githubusercontent.com/u/158459?v=4" alt = "KIT UNITED" title = "TianJIANG" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/rhernandez-itemsoft" > < img src = "https://avatars1.githubusercontent.com/u/4327356?v=4" alt = "Ricardo Hernandez Lopez" title = "rhernandez-itemsoft" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/ChinChuanKuo" > < img src = "https://avatars1.githubusercontent.com/u/11756978?v=4" alt = "ChinChuanKuo" title = "ChinChuanKuo" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-12-23 09:23:56 +01:00
< a href = "https://github.com/nikharsaxena" > < img src = "https://avatars1.githubusercontent.com/u/8684362?v=4" alt = "Nikhar Saxena" title = "nikharsaxena" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-12-20 00:13:10 +01:00
< a href = "https://github.com/fenriz07" > < img src = "https://avatars1.githubusercontent.com/u/9199380?v=4" alt = "Servio Zambrano" title = "fenriz07" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/NA" > < img src = "https://avatars1.githubusercontent.com/u/1600?v=4" alt = "Nate Anderson" title = "NA" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-12-08 05:06:32 +01:00
< a href = "https://github.com/claudemuller" > < img src = "https://avatars1.githubusercontent.com/u/8104894?v=4" alt = "Claude Muller" title = "claudemuller" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
< a href = "https://github.com/marcmmx" > < img src = "https://avatars1.githubusercontent.com/u/7670546?v=4" alt = "Marco Moeser" title = "marcmmx" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
2020-11-26 09:53:52 +01:00
< a href = "https://github.com/sankethpb" > < img src = "https://avatars1.githubusercontent.com/u/16034868?v=4" alt = "Sanketh P B" title = "sankethpb" with = "75" style = "width:75px;max-width:75px;height:75px" height = "75" / > < / a >
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
2021-02-19 07:49:15 +01:00
### Create a new project
2018-07-25 05:14:33 +02:00
```sh
2021-02-19 07:05:13 +01:00
$ mkdir myapp
$ cd myapp
2020-09-25 19:21:41 +02:00
$ go mod init myapp
2021-01-10 11:16:19 +01:00
$ go get github.com/kataras/iris/v12@master # or @v12 .2.0-alpha2
2021-02-19 07:49:15 +01:00
```
< details > < summary > Install on existing project< / summary >
```sh
$ cd myapp
$ go get github.com/kataras/iris/v12@master
```
< / details >
< details > < summary > Install with a go.mod file< / summary >
```txt
module myapp
go 1.16
2021-02-19 08:56:41 +01:00
require github.com/kataras/iris/v12 master
2021-02-19 07:49:15 +01:00
```
**Run**
```sh
2021-02-19 07:05:13 +01:00
$ go mod download
2021-02-19 07:49:15 +01:00
$ go run main.go
2021-02-19 08:56:41 +01:00
# OR just:
# go run -mod=mod main.go
2018-07-25 05:14:33 +02:00
```
2021-02-19 07:49:15 +01:00
< / details >
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)
2021-02-06 21:07:57 +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) -->
