Iris Save

The fastest HTTP/2 Go Web Framework. A true successor of expressjs and laravel. Supports AWS Lambda, gRPC, MVC, Unique Router, Websockets, Sessions, Test suite, Dependency Injection and more | 谢谢 https://github.com/kataras/iris/issues/1329

Project README

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")
}
More with simple Handler
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 for more!

Handler with custom input and output arguments

https://github.com/kataras/iris/blob/master/_examples/dependency-injection/basic/main.go

Interesting? Read the examples.

Party Controller (NEW)

Head over to the full running example!

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!

API Guide HOT
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")
}

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

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

👑 Supporters

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

Donations from China are now accepted!

lensesio trading-peter basilarchia xiaozhuai AlbinoGeek celsosz TechMaster altafino hengestone thomasfr International Juanses ansrivas draFWM gf3 lexrus li3p se77en sumjoe vincent-li sascha11110 derReineke Sirisap22 clacroix ixalender mubariz-ahmed rodrigoghm Cesar DavidShaw DmarshalTU IwateKyle Little-YangYang coderperu cshum dtrifonov ichenhe icibiri 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 syrm ukitzmann aprinslo1 kyoukhana mark2b siriushaha spazzymoto kukaki oshirokazuhide t6tg AwsIT BlackHole1 Jude-X KevinZhouRafael Laotanling MihaiPopescu1985 Neulhan NguyenPhuoc SamuelNeves TianJIANG Ubun1 acdias agent3bood b2cbd baoch254 bastengao bunnycodego carlos-enginner civicwar cnzhangquan edwindna2 fenriz07 gnosthi goten002 guanzi008 hdezoscar93 hzxd iantuan kana99 khasanovrs knavels leki75 liheyuan lingyingtan lipatti mattbowen mizzlespot mnievesco motogo mulyawansentosa nasoma ozfive paulxu21 pitt134 qiuzhanghua rapita remopavithran rfunix rhernandez-itemsoft risallaw rxrw saleebm sbenimeli svirmi unixedia vguhesan vladimir-petukhov-sr vuhoanglam yonson2 SergeShin blackHoleNgc1277 martinlindhe mtrense netbaalzovf lfaynman ArturWierzbicki NA RainerGevers aaxx crashCoder dochoaj gog200921 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 Tang634724712 HieuLsw carlosmoran092 yangxianglong

📖 Learning Iris

Create a new project

$ mkdir myapp
$ cd myapp
$ go mod init myapp
$ go get github.com/kataras/iris/[email protected] # or @v12.2.0-beta3
Install on existing project
$ cd myapp
$ go get github.com/kataras/iris/[email protected]

Run

$ go mod tidy -compat=1.18
$ 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 [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.

Open Source Agenda is not affiliated with "Iris" Project. README Source: kataras/iris