加入CODE CHINA

· 不限速    · 不限空间    · 不限人数    · 私仓免费

免费加入
    README.md

    Black Lives Matter

    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

    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.

    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!

    Handler with custom input and output arguments

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

    Interesting? Read the examples.

    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.

    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!

    Vytis Valentinavičius Daniel Ha Samuel Antônio Das Neves Agile Data Inc Mark Berner Guilherme Rosado Bob McAllan Alexander Grining Edwin García Martínez Ian Tuan Artem Stavischansky Vladimir Petukhov 劉品均 Carlos Moran Peter Riemenschneider Primadi Setiawan Mubariz Ahmed Peter Kaske Paul Xu David Shaw Stone Travel Tan Andre Dias Rafael Francischini Heyuan Li Rainer Gevers Matic Zarnec Navid Dezashibi Sky Lee Richard Bondi Anthonius Prinslo Vladimir George Fourikis Александр Лебединский Li Yang Qianyu Zhou anilpdv CAO HOAI BAO Oscar Hernandez Gerard Lancea neulhan xushiquan Matt Ľuboš Pinteš Leighton McKeen Weliam simranjit singh Kenneth Jordan Morlé Koudeka Rui Carlos Augusto Horst Ender Pavithran MULYAWAN SENTOSA KIT UNITED Ricardo Hernandez Lopez ChinChuanKuo Nikhar Saxena Servio Zambrano Nate Anderson Claude Muller Marco Moeser Sanketh P B Vu Hoang Lam Dimitar Trifonov Midhubalan Balasubramanian AANAND NATARAJAN Edsongley Almeida ganben Tejus Pratap cui hexiang tinawang Juan David Parra Pimiento Andy Chong Ying Zhi Kevin Zhou Jasper Simranjit Singh Christopher Lamm 叶峻峣 TSAI LI TING zhutao George Alexiou Jobert Azares Tam Nguyen 
Venkatt Guhesan Anibal C C Budaye ARAN ROKA Valentine Chakravarthy Raghunandan Massimiliano Bertinetti Hieu Trinh J.T. Feng Gabor Lekeny LiHaotian Muyang Li Hao Tu Cetin Basoz Hazmi Amalul Rémy Deme Vincent Li Max Trense Matej Lach Joseph De Paola Damon Blais 陆 轶丰 Weihang Ding Li Fang TechMaster lenses.io Celso Souza Altafino Thomas Fritz Conrad Steenberg Damon Zhao George Opritescu Juanses Ankur Srivastava Lex Tang li3p

    📖 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?

    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.

    项目简介

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/kataras/iris

    发行版本 15

    v12.2.0-alpha2

    全部发行版

    贡献者 97

    全部贡献者

    开发语言

    • Go 100.0 %
    • Shell 0.0 %