Το Iris είναι ένα γρήγορο web framework για τη Go, με όλα τα απαραίτητα ενσωματωμένα. Δίνει στο επόμενο API ή website σας εκφραστικό routing με typed παραμέτρους διαδρομής, ένα κεντρικό σημείο για τη διαχείριση σφαλμάτων, dependency injection που κρατά τον κώδικα εύκολο στο testing, και προεπιλογές παραγωγής που είναι ασφαλείς από την πρώτη στιγμή.
Η έκδοση 14 είναι η μεγαλύτερη κυκλοφορία στην ιστορία του project. Το framework ξαναχτίστηκε γύρω από τα Go generics: ένας application builder που ελέγχεται κατά τη μεταγλώττιση, typed βοηθητικές συναρτήσεις αιτημάτων που κάνουν το validation για εσάς, controllers που επιλύονται από το dependency container, και μια ροή σφαλμάτων που ρυθμίζετε μία φορά. Το HISTORY.md καταγράφει κάθε νέο στοιχείο, ενώ ο Οδηγός Μετάβασης φέρνει εφαρμογές v12 στη νέα έκδοση σε μία συνεδρία.
🤖 Ρωτήστε την AI για το Iris. Το δωρεάν Code Wiki για το Iris της Google παράγεται από αυτό το αποθετήριο και παραμένει συγχρονισμένο μαζί του, commit προς commit. Περιηγηθείτε στην αρχιτεκτονική με διαγράμματα, ή κάντε στο chat του ερωτήσεις σε απλή γλώσσα για τον κώδικα και λάβετε απαντήσεις θεμελιωμένες στον πραγματικό πηγαίο κώδικα.
Μάθετε τι λένε οι άλλοι για το Iris και δώστε ένα αστέρι σε αυτό το έργο ανοιχτού κώδικα για να στηρίξετε την ανάπτυξή του. Σας ενδιαφέρει η ταχύτητα; Δείτε τα ανεξάρτητα server benchmarks.
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")
}Η στοίβα παραγωγής, σε μία έκφραση
Οι πραγματικές εφαρμογές χρησιμοποιούν το iris.NewBuilder: μια αλυσίδα που ελέγχεται κατά τη μεταγλώττιση και συνδέει CORS, συμπίεση, access logs, ένα health endpoint, τον χάρτη σφαλμάτων σας, τις υπηρεσίες σας και τα API groups σας. Ο compiler απορρίπτει τη λάθος σειρά βημάτων.
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")Οι handlers μένουν στις έξι γραμμές, γιατί η αποκωδικοποίηση, το validation και η απόδοση σφαλμάτων γίνονται σε ένα, ρυθμισμένο σημείο:
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.
}Ο Οδηγός Πρώτων Βημάτων χτίζει μια πλήρη, δοκιμασμένη υπηρεσία πάνω σε αυτή τη στοίβα, σε ένα έγγραφο.
Όπως είπε κάποτε ένας Go developer, το Iris σε καλύπτει ολόπλευρα και παραμένει σταθερό στο πέρασμα των χρόνων.
Τι σας προσφέρει το Iris v14:
- Routing με typed παραμέτρους διαδρομής (
{id:uuid},{n:int},{addr:email}και άλλες), προσαρμοσμένα macros και περιορισμούς. Η μη έγκυρη είσοδος απορρίπτεται πριν τρέξει ο handler σας. iris.NewBuilder: CORS, συμπίεση, καταγραφή αιτημάτων, health endpoint, αντιστοίχιση σφαλμάτων, υπηρεσίες και API groups συναρμολογημένα σε μία αλυσίδα ελεγμένη από τον compiler.- Dependency injection: οι constructors δηλώνουν τι χρειάζονται, το container το παρέχει. Hooks εκκίνησης
Initializer, αυτόματα closers τερματισμού. - Οι βοηθητικές συναρτήσεις
restκαι ένας κεντρικός χάρτης σφαλμάτων: λιτοί handlers, κανονικά, μηχανικά αναγνώσιμα σφάλματα, τα εσωτερικά δεν διαρρέουν ποτέ στους clients. - Payloads αιτημάτων που επικυρώνονται μόνα τους: υλοποιήστε τη
Validate() errorκαι ηctx.BindJSONτην εκτελεί μετά την αποκωδικοποίηση. - Τριάντα ένα ενσωματωμένα middleware: accesslog, API keys, basicauth, bodylimit, cache, CORS, hCaptcha και reCAPTCHA, JWT, monitor, pprof, rate limiting, recovery, request IDs, rewrite, sessions, versioning και άλλα.
- Authentication σε κάθε κλίμακα: Basic Auth μίας γραμμής, API keys, ένα generic JWT SDK, ένας πλήρης identity server και ένας OAuth2 provider.
- MVC controllers χτισμένοι πάνω στα Go generics.
- WebSockets, εξυπηρέτηση gRPC και API versioning.
- View engines: HTML, Django, Handlebars, Pug και άλλες μέσω του iris-contrib/views.
- Localization με πληθυντικούς και ανίχνευση γλώσσας, μαζί με sitemaps.
- Sessions με ασφαλείς προεπιλογές cookies (
Secure,SameSite=Laxαπό προεπιλογή). - Πλούσιες αποκρίσεις: JSON, JSONP, XML, YAML, Markdown, Protocol Buffers, MessagePack, content negotiation, streaming και Server-Sent Events.
- AI backends: το πακέτο
aiαποδίδει και αναμεταδίδει μέσω HTTP τη streaming έξοδο των μοντέλων (text deltas, reasoning traces, tool-call fragments, usage). Δεν εξαρτάται από κανέναν provider και δεν περιέχει κανένα vendor SDK. - Ένας HTTP client, το πακέτο
client, για να καλείτε άλλες υπηρεσίες με τους ίδιους κανόνες JSON που χρησιμοποιεί η πλευρά του server. - Συμπίεση αποκρίσεων: gzip, deflate, brotli, snappy, s2, zstd.
- TLS με Let's Encrypt, και ενσωματωμένο ngrok tunneling (opt-in:
import _ "github.com/kataras/iris/v14/core/server/ngrok") για να βγάλετε μια dev εφαρμογή στο διαδίκτυο σε δευτερόλεπτα. - In-memory HTTP testing: δοκιμές ολόκληρης της εφαρμογής χωρίς ports, χωρίς δίκτυο και χωρίς sleeps.
- Ένα πλήρες βιβλίο που μπορείτε να διαβάσετε online και να κατεβάσετε δωρεάν, ένα πρακτικό tutorial και ένα ζωντανό AI wiki (δείτε το Μαθαίνοντας το Iris παρακάτω).
- Και το σημαντικότερο: παίρνετε γρήγορες απαντήσεις και υποστήριξη, από την πρώτη μέρα μέχρι σήμερα.
Νέοι στο Iris; Ξεκινήστε με τον Οδηγό Πρώτων Βημάτων: ένα έγγραφο που σας πηγαίνει από το
go mod initσε ένα δοκιμασμένο REST API με δομή παραγωγής. Αναβαθμίζετε από τη v12; Δείτε τον Οδηγό Μετάβασης. Ερωτήσεις σε οποιοδήποτε σημείο; Ρωτήστε το δωρεάν ζωντανό AI wiki στο codewiki.google/github.com/kataras/iris, που παράγεται από την Google από τον πηγαίο κώδικα του Iris και παραμένει συγχρονισμένο μαζί του, με ενσωματωμένο chat που απαντά σε ερωτήσεις για τον κώδικα.
Η μόνη απαίτηση είναι η γλώσσα προγραμματισμού Go, έκδοση 1.27 ή νεότερη.
$ mkdir myapp
$ cd myapp
$ go mod init myapp
$ go get github.com/kataras/iris/v14@latest # or @v14.0.1Εγκατάσταση σε υπάρχον project
$ cd myapp
$ go get github.com/kataras/iris/v14@latestΕκτέλεση
$ go mod tidy
$ go run .Το Iris περιέχει εκτενή και αναλυτική τεκμηρίωση που κάνει εύκολο το ξεκίνημα με το framework.
Για πιο λεπτομερή τεχνική τεκμηρίωση μπορείτε να επισκεφθείτε τα godocs μας. Για μια πλήρη, πρακτική εισαγωγή στην προτεινόμενη στοίβα της v14 διαβάστε τον Οδηγό Πρώτων Βημάτων, και αν αναβαθμίζετε από τη v12 ακολουθήστε τον Οδηγό Μετάβασης.
Προτιμάτε να μαθαίνετε από κώδικα; Τα 59 παραδείγματα ξεκινούν από την πρώτη διαδρομή και φτάνουν στο dependency injection, στον έλεγχο ταυτότητας, στο testing και στα σημεία επέκτασης του framework. Καθένα από αυτά μεταγλωττίστηκε και δοκιμάστηκε πάνω από HTTP πριν γίνει commit.
Το πλήρες βιβλίο έχει έναν πρόλογο, 24 κεφάλαια και έναν επίλογο, με κάθε παράδειγμα κώδικα επαληθευμένο απέναντι στον πηγαίο κώδικα του framework. Κάθε κεφάλαιο ανοίγει με ένα υπόβαθρο σε απλή γλώσσα για τους νεοφερμένους και κλείνει με επιλεγμένη πρόσθετη βιβλιογραφία. Κάθε κεφάλαιο διαβάζεται ελεύθερα στο iris-go.com/docs: η σελίδα του βιβλίου έχει τα πλήρη περιεχόμενα.
Το PDF είναι κι αυτό δωρεάν. Κατεβάστε το απευθείας: δεν υπάρχει φόρμα να συμπληρώσετε ούτε κάτι να ζητήσετε. Αν το βιβλίο σας βοηθήσει, με μια χορηγία στο project παίρνετε μέρος στην ανάπτυξη του Iris.
Δύο εργαλεία AI γνωρίζουν συγκεκριμένα αυτό το framework, πέρα από όσα ξέρει ένα γενικό μοντέλο για τη Go.
Το ζωντανό AI wiki είναι δωρεάν και τρέχει στον browser: περιηγηθείτε στην αρχιτεκτονική ή ρωτήστε το chat του για τον κώδικα.
Το Plexon AI είναι μια desktop εφαρμογή για Windows, macOS και Linux, φτιαγμένη από τον δημιουργό του Iris. Ενσωματώνει το skill του Iris (iris-go.com/ai): το API της v14, την αλυσίδα του builder, τους rest helpers, τη χαρτογράφηση σφαλμάτων, το SDK πιστοποίησης και τα μοτίβα δοκιμών, σε είκοσι ένα έγγραφα αναφοράς που ο βοηθός φορτώνει όποτε τα χρειάζεται ενώ γράφει τον κώδικά σας. Ενεργοποιήστε το skill από το πάνελ Skills ή εγκαταστήστε την persona Software Developer, που το ενεργοποιεί μαζί με τα υπόλοιπα εργαλεία της. Κατεβάστε το Plexon AI.
Για τους υποστηρικτές, τη συνεισφορά, την πολιτική ασφαλείας και την άδεια χρήσης, δείτε το αγγλικό README.
Αυτό το project αδειοδοτείται υπό την άδεια BSD 3-clause, όπως ακριβώς και το ίδιο το project της Go.



