News
This is the under-development branch. Stay tuned for the upcoming release v12.2.0. Looking for a stable release? Head over to the v12.1.8 branch instead.
Try the official Iris Command Line Interface today!
Due to the large workload, there may be delays in answering your questions.
Iris Web Framework 
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.
Simple Handler
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 for more!
MVC
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!
Learn what others saying about Iris and star this open-source project to support its potentials.
👑
Supporters
With your help, we can improve Open Source web development for everyone!
Donations from China are now accepted!
📖
Learning Iris
Create a new project
$ mkdir myapp
$ cd myapp
$ go mod init myapp
$ go get github.com/kataras/iris/v12@master # or @v12.2.0-alpha2
Install on existing project
$ cd myapp
$ go get github.com/kataras/iris/v12@master
Install with a go.mod file
module myapp
go 1.16
require github.com/kataras/iris/v12 master
Run
$ go mod download
$ go run main.go
# OR just:
# go run -mod=mod main.go
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?
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.
🛡
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.
![[QUESTION]can logger write to multiple files asynchronously and rotate based on size or time?](https://avatars.githubusercontent.com/u/26807520?v=4)
![[DOCUMENTATION] No Content-Encoding: gzip header on gzip-ed bindata](https://avatars.githubusercontent.com/u/4773701?v=4)
![[BUG] CORS doesn't support Subdomains](https://avatars.githubusercontent.com/u/1910461?v=4)
![[FEATURE REQUEST] MVC serving gRPC-compatible controller](https://avatars.githubusercontent.com/u/427668?v=4)
![[BUG/Feature] MVC Dependency authentication example](https://avatars.githubusercontent.com/u/1674289?v=4)
![[BUG] when dynamic routing parameters have type judgments, cause cors problem](https://avatars.githubusercontent.com/u/29367599?v=4)
![[BUG]dynamic routing does not take effect](https://avatars.githubusercontent.com/u/17638267?v=4)
![:exclamation::exclamation::exclamation: [deprecated] Moved to https://github.com/go-macaron/macaron](https://raw.githubusercontent.com/Unknwon/macaron/master/macaronlogo.png)
