2020-08-11 18:22:35 +02:00
[](https://support.eji.org/give/153413/#!/donation/checkout)
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
<!-- # News -->
2019-07-25 06:45:59 +02:00
2020-08-11 18:26:29 +02:00
> 这是一个**开发中的版本**。敬请关注即将发布的版本 [v12.2.0](HISTORY.md#Next)。如果想使用稳定版本，请查看 [v12.1.8 分支](https://github.com/kataras/iris/tree/v12.1.8) 。
>
2020-08-11 18:22:35 +02:00
>  立即尝试官方的[Iris命令行工具](https://github.com/kataras/iris-cli)！
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
<!--  Iris version **12.1.8** has been [released ](HISTORY.md#su-16-february-2020--v1218 )! -->
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +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-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02: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) -->
2020-05-10 23:44:54 +02:00
2020-08-11 18:22:35 +02:00
<!-- <a href="https://iris - go.com"> <img align="right" src="https://iris - go.com/images/logo - w169.png"></a> -->
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
Iris 是基于 Go 编写的一个快速，简单但功能齐全且非常高效的 Web 框架。
它为您的下一个网站或 API 提供了一个非常富有表现力且易于使用的基础。
看看 [其他人如何评价 Iris ](https://iris-go.com/testimonials/ )，同时欢迎各位为此开源项目点亮 ** [star ](https://github.com/kataras/iris/stargazers )**。
[](https://iris-go.com/testimonials/)
[](https://github.com/kataras/server-benchmarks)
## 📖 开始学习 Iris
2019-07-25 06:45:59 +02:00
```sh
2020-08-11 18:22:35 +02:00
# 安装Iris：
$ go get github.com/kataras/iris/v12@master
# 假设main.go文件中已存在以下代码
$ cat main.go
2019-07-25 06:45:59 +02:00
```
```go
package main
2019-10-25 00:27:02 +02:00
import "github.com/kataras/iris/v12"
2019-07-25 06:45:59 +02:00
func main() {
2020-08-11 18:22:35 +02:00
app := iris.New()
booksAPI := app.Party("/books")
{
booksAPI.Use(iris.Compression)
// GET: http://localhost:8080/books
booksAPI.Get("/", list)
// POST: http://localhost:8080/books
booksAPI.Post("/", create)
}
app.Listen(":8080")
}
// Book example.
type Book struct {
Title string `json:"title"`
}
func list(ctx iris.Context) {
books := []Book{
{"Mastering Concurrency in Go"},
{"Go Design Patterns"},
{"Black Hat Go"},
}
ctx.JSON(books)
// 提示: 在服务器优先级和客户端请求中进行响应协商，
// 以此来代替 ctx.JSON:
// ctx.Negotiation().JSON().MsgPack().Protobuf()
// ctx.Negotiate(books)
}
func create(ctx iris.Context) {
var b Book
err := ctx.ReadJSON(& b)
// 提示: 使用 ctx.ReadBody(& b) 代替，来绑定所有类型的入参
if err != nil {
ctx.StopWithProblem(iris.StatusBadRequest, iris.NewProblem().
Title("Book creation failure").DetailErr(err))
// 提示: 如果仅有纯文本（ ） ，
// 可使用 ctx.StopWithError(code, err)
return
}
println("Received Book: " + b.Title)
ctx.StatusCode(iris.StatusCreated)
}
```
同样地，在**MVC**中 :
```go
import "github.com/kataras/iris/v12/mvc"
```
```go
m := mvc.New(booksAPI)
m.Handle(new(BookController))
```
```go
type BookController struct {
/* dependencies */
}
// GET: http://localhost:8080/books
func (c *BookController) Get() []Book {
return []Book{
{"Mastering Concurrency in Go"},
{"Go Design Patterns"},
{"Black Hat Go"},
}
}
// POST: http://localhost:8080/books
func (c *BookController) Post(b Book) int {
println("Received Book: " + b.Title)
return iris.StatusCreated
2019-07-25 06:45:59 +02:00
}
```
2020-08-11 18:22:35 +02:00
**启动** 您的 Iris web 服务:
2019-07-25 06:45:59 +02:00
```sh
2020-08-11 18:22:35 +02:00
$ go run main.go
> Now listening on: http://localhost:8080
> Application started. Press CTRL+C to shut down.
2019-07-25 06:45:59 +02:00
```
2020-08-11 18:22:35 +02:00
Books **列表查询** :
```sh
$ curl --header 'Accept-Encoding:gzip' http://localhost:8080/books
[
{
"title": "Mastering Concurrency in Go"
},
{
"title": "Go Design Patterns"
},
{
"title": "Black Hat Go"
}
]
```
**创建** 新的Book:
```sh
$ curl -i -X POST \
--header 'Content-Encoding:gzip' \
--header 'Content-Type:application/json' \
--data "{\"title\":\"Writing An Interpreter In Go\"}" \
http://localhost:8080/books
> HTTP/1.1 201 Created
```
2020-08-11 18:26:29 +02:00
这是**错误**响应所展示的样子：
2020-08-11 18:22:35 +02:00
```sh
$ curl -X POST --data "{\"title\" \"not valid one\"}" \
http://localhost:8080/books
> HTTP/1.1 400 Bad Request
{
"status": 400,
"title": "Book creation failure"
"detail": "invalid character '\"' after object key",
}
```
2019-07-25 06:45:59 +02:00
< / details >
2020-08-11 18:22:35 +02:00
[](https://bit.ly/2YJeSZe)
2020-08-11 18:26:29 +02:00
Iris 有完整且详尽的 ** [使用文档 ](https://github.com/kataras/iris/wiki )** ，让您可以轻松地使用此框架。
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
<!--  -->
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
要了解更详细的技术文档，请访问我们的 [godocs ](https://godoc.org/github.com/kataras/iris )。如果想要寻找代码示例，您可以到仓库的 [./_examples ](_examples ) 子目录下获取。
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
### 你喜欢在旅行时阅读吗？
2019-07-25 06:45:59 +02:00
2020-08-24 20:44:29 +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-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
[](https://twitter.com/intent/follow?screen_name=iris_framework)
2019-10-30 12:57:27 +01:00
2020-08-24 20:44:29 +02:00
您可以[获取](https://www.iris-go.com/#ebookDonateForm)PDF版本或在线访问**电子图书**，
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
## 🙌 贡献
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
我们欢迎您为Iris框架做出贡献！ ， （ ）
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
[贡献者名单 ](https://github.com/kataras/iris/graphs/contributors )
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
## 🛡 安全漏洞
2019-07-25 06:45:59 +02:00
2020-08-11 18:22:35 +02:00
如果您发现在 Iris 存在安全漏洞，请发送电子邮件至 [iris-go@outlook.com ](mailto:iris-go@outlook.com )。所有安全漏洞将会得到及时解决。
## 📝 开源协议（ ）
就像Go语言的协议一样， BSD 3-clause license ](LICENSE )。
2019-07-25 06:45:59 +02:00
项目名称 "Iris" 的灵感来自于希腊神话。
2020-08-11 18:22:35 +02:00
<!-- ## Stargazers over time
[](https://starchart.cc/kataras/iris) -->
