Iris là một web framework nhanh, đầy đủ tính năng dành cho Go. Nó mang đến cho API hoặc website tiếp theo của bạn hệ thống định tuyến giàu biểu đạt với tham số đường dẫn có kiểu, một nơi duy nhất để xử lý lỗi, cơ chế dependency injection giúp mã nguồn luôn dễ kiểm thử, cùng các thiết lập mặc định an toàn, sẵn sàng cho production ngay từ đầu.
Phiên bản 14 là bản phát hành lớn nhất trong lịch sử dự án. Framework đã được xây dựng lại xoay quanh generics của Go: một builder ứng dụng được trình biên dịch kiểm soát, các hàm hỗ trợ request có kiểu tự xác thực thay cho bạn, các controller được phân giải bởi container dependency injection, và một pipeline xử lý lỗi chỉ cần cấu hình một lần. HISTORY.md ghi lại mọi điểm mới; Hướng dẫn nâng cấp đưa ứng dụng v12 lên phiên bản mới chỉ trong một lần ngồi.
🤖 Hỏi AI về Iris. Code Wiki cho Iris: miễn phí, do Google tạo trực tiếp từ repository này và luôn đồng bộ với nó theo từng commit. Bạn có thể duyệt kiến trúc qua các sơ đồ, hoặc đặt câu hỏi bằng ngôn ngữ thường ngày cho phần chat của nó về codebase và nhận câu trả lời dựa trên chính mã nguồn thực tế.
Xem những gì người khác nói về Iris và thả sao cho dự án mã nguồn mở này để ủng hộ sự phát triển của nó. Tò mò về tốc độ? Hãy xem các bài benchmark máy chủ độc lập.
package main
import "github.com/kataras/iris/v14"
func main() {
app := iris.New()
app.Get("/", func(ctx iris.Context) {
ctx.JSON(iris.Map{"message": "Hello, World!"})
})
app.Get("/greet/{name:string}", func(ctx iris.Context) {
ctx.WriteString("Hello, " + ctx.Params().GetString("name"))
})
app.Listen(":8080")
}Cả stack production, trong một biểu thức duy nhất
Các ứng dụng thực tế dùng iris.NewBuilder: một chuỗi gọi được trình biên dịch kiểm soát, kết nối CORS, nén dữ liệu, log truy cập, endpoint health, bảng ánh xạ lỗi, các service và các nhóm API của bạn. Sai thứ tự các bước là trình biên dịch từ chối ngay.
iris.NewBuilder().
Prefix("/api").
AllowOrigin("*").
Compression(true).
LogRequests(true).
Health(true, "production", "kataras").
Errors(errors.NewOptions().
MapErrors(errors.NotFound, catalog.ErrNotFound)).
Services(catalog.NewRepository, catalog.NewService).
RouterMiddlewares().
Middlewares().
API("/products", api.NewProductsAPI).
Build().
Listen(":8080")Handler chỉ dài khoảng sáu dòng, bởi việc giải mã, xác thực và kết xuất lỗi đều diễn ra ở một nơi đã được cấu hình sẵn:
func (api *ProductsAPI) create(ctx iris.Context) {
input, ok := ctx.BindJSON[catalog.ProductInput]()
if !ok {
return // 400 already written: malformed JSON or failed Validate.
}
id, err := api.svc.Create(ctx, input)
ctx.Created(id, err) // 201, or the centrally mapped error.
}Hướng dẫn bắt đầu xây dựng một service hoàn chỉnh, có kiểm thử, trên chính stack này chỉ trong một tài liệu.
Như một lập trình viên Go từng nói, Iris lo cho bạn mọi mặt và vẫn đứng vững suốt bao năm qua.
Những gì bạn có với Iris v14:
- Định tuyến với tham số đường dẫn có kiểu (
{id:uuid},{n:int},{addr:email}và nhiều hơn nữa), macro tùy biến và các ràng buộc. Dữ liệu không hợp lệ bị từ chối trước khi handler của bạn chạy. iris.NewBuilder: CORS, nén, log truy cập, endpoint health, ánh xạ lỗi, service và các nhóm API được lắp ráp trong một chuỗi gọi được kiểm tra lúc biên dịch.- Dependency injection: constructor khai báo thứ mình cần, container sẽ cung cấp. Hook
Initializerlúc khởi động, tự động gọi các closer khi tắt. - Bộ helper
restvà một bảng ánh xạ lỗi tập trung: handler mỏng gọn, lỗi chuẩn hóa mà máy đọc được, chi tiết nội bộ không bao giờ lộ ra phía client. - Payload request tự xác thực: chỉ cần triển khai
Validate() error,ctx.BindJSONsẽ chạy nó ngay sau khi giải mã. - Ba mươi mốt middleware tích hợp sẵn: accesslog, API key, basicauth, bodylimit, cache, CORS, hCaptcha và reCAPTCHA, JWT, monitor, pprof, rate limiting, recovery, request ID, rewrite, session, versioning và nhiều hơn nữa.
- Xác thực ở mọi quy mô: Basic Auth chỉ một dòng, API key, SDK JWT dùng generics, một identity server hoàn chỉnh và một OAuth2 provider.
- Controller MVC xây dựng trên generics của Go.
- WebSocket, phục vụ gRPC và versioning cho API.
- View engine: HTML, Django, Handlebars, Pug và nhiều hơn nữa thông qua iris-contrib/views.
- Bản địa hóa (i18n) với hỗ trợ số nhiều và nhận diện ngôn ngữ, kèm sitemap.
- Session với các mặc định cookie an toàn (
Secure,SameSite=Laxngay từ đầu). - Kiểu phản hồi phong phú: JSON, JSONP, XML, YAML, Markdown, Protocol Buffers, MessagePack, content negotiation, streaming và Server-Sent Events.
- Backend AI: package
aikết xuất và chuyển tiếp đầu ra streaming của mô hình qua HTTP (text delta, reasoning trace, các mảnh tool call, usage). Không phụ thuộc vào nhà cung cấp nào và không kèm theo SDK của hãng nào. - Một HTTP client, package
client, để gọi các service khác theo cùng bộ quy tắc JSON mà phía server sử dụng. - Nén phản hồi: gzip, deflate, brotli, snappy, s2, zstd.
- TLS với Let's Encrypt, cùng tunnel ngrok tích hợp sẵn (opt-in:
import _ "github.com/kataras/iris/v14/core/server/ngrok") để đưa ứng dụng đang phát triển lên internet trong vài giây. - Kiểm thử HTTP trong bộ nhớ: test toàn bộ ứng dụng không cần cổng, không cần mạng, không cần sleep.
- Một cuốn sách hoàn chỉnh có thể đọc trực tuyến và tải về miễn phí, một tutorial thực hành và một AI wiki trực tuyến (xem mục Học Iris bên dưới).
- Và quan trọng nhất: bạn luôn nhận được câu trả lời và sự hỗ trợ nhanh chóng, từ ngày đầu tiên cho đến tận bây giờ.
Mới làm quen với Iris? Hãy bắt đầu với Hướng dẫn bắt đầu: một tài liệu duy nhất đưa bạn từ
go mod initđến một REST API đã được kiểm thử, mang dáng dấp production. Đang nâng cấp từ v12? Xem Hướng dẫn nâng cấp. Có thắc mắc ở bất kỳ bước nào? Hãy hỏi AI wiki trực tuyến miễn phí tại codewiki.google/github.com/kataras/iris: do Google tạo từ mã nguồn Iris và luôn được đồng bộ với nó, kèm phần chat tích hợp trả lời các câu hỏi về codebase.
Yêu cầu duy nhất là ngôn ngữ lập trình Go, phiên bản 1.27 trở lên.
$ mkdir myapp
$ cd myapp
$ go mod init myapp
$ go get github.com/kataras/iris/v14@latest # or @v14.0.1Cài đặt vào dự án có sẵn
$ cd myapp
$ go get github.com/kataras/iris/v14@latestChạy
$ go mod tidy
$ go run .Iris có bộ tài liệu phong phú và kỹ lưỡng, giúp bạn dễ dàng bắt đầu với framework.
Để xem tài liệu kỹ thuật chi tiết hơn, hãy ghé godocs của chúng tôi. Để có phần giới thiệu trọn vẹn, thực hành về stack v14 được khuyến nghị, hãy đọc Hướng dẫn bắt đầu; còn nếu bạn đang nâng cấp từ v12, hãy làm theo Hướng dẫn nâng cấp.
Bạn thích học từ mã nguồn? 59 ví dụ đi từ route đầu tiên đến dependency injection, xác thực, kiểm thử và các điểm mở rộng của framework. Mỗi ví dụ đều đã được biên dịch và chạy thử qua HTTP trước khi commit.
Cuốn sách hoàn chỉnh gồm một lời mở đầu, 24 chương và một lời kết, mọi ví dụ mã đều được đối chiếu với mã nguồn của framework. Mỗi chương mở đầu bằng phần bối cảnh dễ hiểu dành cho người mới và khép lại bằng danh mục đọc thêm chọn lọc. Mọi chương đều đọc miễn phí tại iris-go.com/docs; trang sách có mục lục đầy đủ.
Bản PDF cũng miễn phí. Tải trực tiếp: không có biểu mẫu nào phải điền và không cần yêu cầu gì cả. Nếu cuốn sách giúp ích cho bạn, tài trợ cho dự án là cách để bạn góp phần vào sự phát triển của Iris.
Có hai công cụ AI hiểu riêng framework này, vượt ra ngoài những gì một mô hình tổng quát biết về Go.
AI wiki trực tiếp miễn phí và chạy ngay trên trình duyệt: xem kiến trúc hoặc hỏi chat của nó về mã nguồn.
Plexon AI là một trợ lý desktop cho Windows, macOS và Linux, do tác giả của Iris xây dựng. Nó tích hợp sẵn skill Iris (iris-go.com/ai): API v14, chuỗi builder, các helper rest, ánh xạ lỗi, SDK xác thực và các mẫu kiểm thử, trong hai mươi mốt tài liệu tham khảo mà trợ lý nạp khi cần trong lúc viết mã cho bạn. Bật skill trong bảng Skills, hoặc cài persona Software Developer, persona này sẽ bật skill cùng với các công cụ phát triển còn lại. Tải Plexon AI.
Về những người ủng hộ, cách đóng góp, chính sách bảo mật và giấy phép, xem README tiếng Anh.
Dự án này được cấp phép theo giấy phép BSD 3-clause, giống như chính dự án Go.



