Novidades Novidades
Iris Web Framework English 
العربية
[](https://github.com/kataras/iris/actions/workflows/ci.yml) [](https://github.com/kataras/iris/tree/main/_examples) [](https://gitter.im/iris_go/community) [](https://iris-go.com/donate)
⚡ Iris é um framework web rápido, simples, mas completo e muito eficiente para Go.
✨ Ele fornece uma base lindamente expressiva e fácil de usar para seu próximo site ou API.
🌟 Veja o que [outras pessoas dizem sobre o Iris](https://www.iris-go.com/#review) e dê uma **[estrela](https://github.com/kataras/iris/stargazers)** a este projeto de código aberto
[](https://iris-go.com/testimonials/)
[](https://github.com/kataras/server-benchmarks)
```go
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 %s!", "World")
})
app.Listen(":8080")
}
```
Como disse certa vez um [desenvolvedor Go](https://twitter.com/dkuye/status/1532087942696554497), **o Iris cobre você por todos os lados e segue firme com o passar dos anos** ⭐
Alguns dos recursos que o Iris oferece:
* HTTP/2 (Push, inclusive dados embutidos)
* Middleware (Accesslog, Basicauth, CORS, gRPC, Anti-Bot hCaptcha, JWT, MethodOverride, ModRevision, Monitor, PPROF, Ratelimit, Anti-Bot reCaptcha, Recovery, RequestID, Rewrite)
* Versionamento de API
* Model-View-Controller
* Websockets
* gRPC
* Auto-HTTPS
* Suporte nativo ao ngrok, a forma mais rápida de colocar sua aplicação na internet
* Router único com caminhos dinâmicos como parâmetro, com tipos padrão como :uuid, :string, :int... e a possibilidade de criar os seus
* Compressão
* Motores de view (HTML, Django, Handlebars, Pug/Jade e mais)
* Crie seu próprio File Server e hospede seu próprio servidor WebDAV
* Cache
* Localização (i18n, sitemap)
* Sessões
* Respostas ricas (HTML, Text, Markdown, XML, YAML, Binary, JSON, JSONP, Protocol Buffers, MessagePack, Content Negotiation, Streaming, Server-Sent Events e mais)
* Compressão de resposta (gzip, deflate, brotli, snappy, s2)
* Requisições ricas (Bind URL Query, Headers, Form, Text, XML, YAML, Binary, JSON, Validation, Protocol Buffers, MessagePack e mais)
* Injeção de dependência (MVC, Handlers, API Routers)
* Suíte de testes
* E o mais importante... você recebe respostas rápidas e suporte, desde o primeiro dia até hoje
## 🚀 O que vem no Iris v14
O Iris v14 é o maior lançamento da história do projeto. Ele reconstrói o framework sobre os genéricos do Go e muda a forma como uma aplicação é montada: menos fiação no `main`, handlers mais curtos e um único lugar para as decisões que antes ficavam espalhadas por cada rota.
Nada disso exige sua atenção hoje. A v12 continua funcionando, continua recebendo correções, e a v14 chega com um guia de migração que cobre cada API renomeada ou removida.
### A aplicação inteira em uma cadeia verificada pelo compilador
`iris.NewBuilder` conecta CORS, compressão, log de acesso, o endpoint de saúde, o mapa de erros, seus serviços e seus grupos de API em uma única expressão. O compilador impõe a ordem das etapas, então uma aplicação ou compila corretamente ou não compila de jeito nenhum.
```go
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).
API("/products", api.NewProductsAPI).
Build().
Listen(":8080")
```
### Os handlers param de se repetir
Decodificação, validação e renderização de erro saem do corpo do handler. `rest.ReadJSON[T]` decodifica a requisição, executa o método `Validate() error` do seu tipo quando ele existe, e escreve o 400 sozinho. Os auxiliares de resposta escrevem o status de sucesso, ou o que o seu mapa central disser que aquele erro deve retornar.
```go
func (api *ProductsAPI) create(ctx iris.Context) {
input, ok := rest.ReadJSON[catalog.ProductInput](ctx)
if !ok {
return // 400 já escrito: JSON malformado ou Validate reprovado.
}
id, err := api.svc.Create(ctx, input)
rest.Created(ctx, id, err) // 201, ou o erro mapeado centralmente.
}
```
`rest.OK`, `rest.NoContent`, `rest.Count` e `rest.Paginated` cobrem os demais formatos que uma API devolve.
### Os erros são declarados uma única vez
O novo pacote `rest/errors` guarda o mapeamento dos erros do seu domínio para respostas HTTP. Os clientes recebem payloads canônicos e legíveis por máquina. Mensagens internas ficam internas. Registre um coletor e cada falha chega ao seu logger ou ao seu banco de dados a partir de um único lugar. Um erro pode ser renderizado como JSON ou como view, dependendo do que o cliente pediu.
### Injeção de dependência em todo lugar, não só no MVC
Os construtores declaram o que precisam e o contêiner fornece: para handlers, para grupos de API, para controladores. Um serviço que implementa `Init(ctx context.Context) error` roda uma vez dentro de `Build()`. Tudo que pode ser fechado é fechado no desligamento. O pacote `hero` acabou, substituído por `dep` e `rest`, que fazem mais com menos linhas. Os controladores MVC são construídos sobre genéricos.
### Os pacotes estão onde você esperaria
`sessions`, `cache`, `websocket`, `i18n`, `view` e `versioning` viraram middleware. `mvc` foi para dentro de `controller`, ao lado dos novos controladores `fileserver`, `sitemap` e `apigraph`. O `apigraph` desenha a sua árvore de rotas como um grafo D3 interativo.
Trinta middlewares vêm de fábrica, incluindo os novos: `httpcost` (tempo, memória e CPU por requisição, para análise de desempenho ou cobrança), `bodylimit`, `compress`, `counter`, `referrer`, `geolocation`, `ipaccess` e `servertiming`. As implementações dos motores de view foram para [iris-contrib/views](https://github.com/iris-contrib/views).
### A configuração é um literal parcial
`iris.Configuration` e os configuradores `With*` foram substituídos por `iris.Options`. Defina os campos que importam para você e o resto vem dos padrões. `Bind` carrega YAML da variável de ambiente `SERVER_CONFIG` e depois de um arquivo.
```go
app := iris.New(iris.Options{Name: "myapp", LogLevel: "debug"})
```
### Nomes que dizem o que fazem
Ler um cabeçalho de requisição e definir um de resposta não compartilham mais um prefixo que inverte de sentido em silêncio: `ctx.Header` lê a requisição, enquanto `ctx.SetHeader` e `ctx.ResponseHeader` atuam na resposta. `Party` agora é `Router`. `ctx.URLParam` agora é `ctx.Query().Get`. Cada renomeação está no guia de migração junto do seu substituto, e a maioria é um localizar e substituir.
### Seguro por padrão
Os cookies de sessão vêm com `Secure` e `SameSite=Lax`. O limite do corpo da requisição é aplicado em todos os caminhos de leitura. Junto com a reconstrução caíram bugs antigos, entre eles um limitador de taxa que registrava os limites sem nunca aplicá-los e uma chamada a `Logout` capaz de derrubar o processo inteiro.
### Documentação que dá para ler do começo ao fim
A v14 vem com um livro de 23 capítulos dentro do repositório, um tutorial inicial que constrói uma API REST com testes em um único documento, um guia de migração para aplicações v12, e um wiki de IA ao vivo gerado a partir do código-fonte que responde perguntas sobre a base de código.
### O que isso significa para o seu código v12
O caminho de importação passa a ser `github.com/kataras/iris/v14`, então v12 e v14 podem conviver e nada quebra no dia do lançamento. Atualize quando for conveniente. O guia de migração cobre o caminho de importação, a mudança dos pacotes, cada API removida e seu substituto, e as mudanças de comportamento, com comandos prontos para as partes mecânicas.
Ainda não há data pública de lançamento. Acompanhe os [releases](https://github.com/kataras/iris/releases) ou siga [@iris_framework](https://twitter.com/iris_framework) para saber primeiro.
## 👑 Apoiadores
Com a sua ajuda, podemos melhorar o desenvolvimento web de código aberto para todo mundo!
[](https://twitter.com/intent/follow?screen_name=makismaropoulos)
[](https://twitter.com/intent/follow?screen_name=iris_framework)
[](https://www.facebook.com/iris.framework)
Você pode [solicitar](https://www.iris-go.com/#ebookDonateForm) hoje o PDF e o acesso online do **E-Book do Iris** (Nova Edição) e participar do desenvolvimento do Iris.
## 🙌 Contribuindo
Adoraríamos ver sua contribuição ao Iris Web Framework! Para mais informações sobre como contribuir com o projeto Iris, veja o arquivo [CONTRIBUTING.md](CONTRIBUTING.md).
[Lista de todos os contribuidores](https://github.com/kataras/iris/graphs/contributors)
## 🛡 Vulnerabilidades de segurança
Se você descobrir uma vulnerabilidade de segurança no Iris, envie um e-mail para [iris-go@outlook.com](mailto:iris-go@outlook.com). Todas as vulnerabilidades de segurança serão tratadas prontamente.
## 📝 Licença
Este projeto está licenciado sob a [licença BSD de 3 cláusulas](LICENSE), assim como o próprio projeto Go.
O nome do projeto "Iris" foi inspirado na mitologia grega.