|
| 1 | +# Iris Web Framework <a href="README_ZH.md"> <img width="20px" src="https://iris-go.com/images/flag-china.svg?v=10" /></a> <a href="README_RU.md"><img width="20px" src="https://iris-go.com/images/flag-russia.svg?v=10" /></a> <a href="README_ID.md"> <img width="20px" src="https://iris-go.com/images/flag-indonesia.svg?v=10" /></a> <a href="README_GR.md"><img width="20px" src="https://iris-go.com/images/flag-greece.svg?v=10" /></a> |
| 2 | + |
| 3 | +<a href="https://iris-go.com"> <img align="right" width="169px" src="https://iris-go.com/images/icon.svg?v=a" title="logo created by @merry.dii" /> </a> |
| 4 | + |
| 5 | +[](https://travis-ci.org/kataras/iris)<!-- [](https://github.com/kataras/iris/releases)--> [](http://goreportcard.com/report/kataras/iris) [](https://marketplace.visualstudio.com/items?itemName=kataras2006.iris)<!--[](https://github.com/kataras/iris/issues?q=is%3Aissue+is%3Aclosed)--> [](https://kataras.rocket.chat/channel/iris) [](https://iris-go.com/v10/recipe) [](https://github.com/kataras/iris/releases) |
| 6 | + |
| 7 | +Iris é um framework rápido, simples porém completo e muito eficiente para a linguagem Go. |
| 8 | + |
| 9 | +Além disso, Iris proporciona uma base sólida que capricha na expressividade e facilidade de uso para seu próximo site ou API. |
| 10 | + |
| 11 | +Por último, Iris é um framework equivalente ao expressjs no ecossistema da linguagem de programação Go. |
| 12 | + |
| 13 | +Veja o que [as pessoas estão dizendo sobre o Iris](#support) e [deixe uma estrela](https://github.com/kataras/iris/stargazers) nesse repositório do github para se [manter atualizado](https://facebook.com/iris.framework). |
| 14 | + |
| 15 | +## Apoiadores |
| 16 | + |
| 17 | +Muito obrigado a todos que nos apoiam! 🙏 [Apoie a gente!](https://iris-go.com/donate) |
| 18 | + |
| 19 | + |
| 20 | +<a href="https://iris-go.com/donate" target="_blank"><img src="https://iris-go.com/backers.svg?v=2"/></a> |
| 21 | + |
| 22 | +```sh |
| 23 | +$ cat example.go |
| 24 | +``` |
| 25 | + |
| 26 | +```go |
| 27 | +package main |
| 28 | + |
| 29 | +import "github.com/kataras/iris" |
| 30 | + |
| 31 | +func main() { |
| 32 | + app := iris.New() |
| 33 | + // Carrega todos os templates da pasta "./views" |
| 34 | + // cuja extensão é ".html" e parseie-os utilizando |
| 35 | + // a biblioteca `html/template`. |
| 36 | + app.RegisterView(iris.HTML("./views", ".html")) |
| 37 | + |
| 38 | + // Method: GET |
| 39 | + // Resource: http://localhost:8080 |
| 40 | + app.Get("/", func(ctx iris.Context) { |
| 41 | + // Associa {{.message}} a "Hello world!" |
| 42 | + ctx.ViewData("message", "Hello world!") |
| 43 | + // Renderiza o template: ./views/hello.html |
| 44 | + ctx.View("hello.html") |
| 45 | + }) |
| 46 | + |
| 47 | + // Method: GET |
| 48 | + // Resource: http://localhost:8080/user/42 |
| 49 | + // |
| 50 | + // Deseja utilizar uma expressão regular ? |
| 51 | + // É fácil, |
| 52 | + // é só marcar o type to parametro como 'string' |
| 53 | + // e utilizar sua macro `regexp`, i.e: |
| 54 | + // app.Get("/user/{id:string regexp(^[0-9]+$)}") |
| 55 | + app.Get("/user/{id:long}", func(ctx iris.Context) { |
| 56 | + userID, _ := ctx.Params().GetInt64("id") |
| 57 | + ctx.Writef("User ID: %d", userID) |
| 58 | + }) |
| 59 | + |
| 60 | + // Inicializa o servidor utilizando um endereço de rede. |
| 61 | + app.Run(iris.Addr(":8080")) |
| 62 | +} |
| 63 | +``` |
| 64 | + |
| 65 | +> Aprenda mais sobre tipos dos parametros da URI clicando [aqui](_examples/routing/dynamic-path/main.go#L31) |
| 66 | +
|
| 67 | +```html |
| 68 | +<!-- arquivo: ./views/hello.html --> |
| 69 | +<html> |
| 70 | +<head> |
| 71 | + <title>Hello Page</title> |
| 72 | +</head> |
| 73 | +<body> |
| 74 | + <h1>{{.message}}</h1> |
| 75 | +</body> |
| 76 | +</html> |
| 77 | +``` |
| 78 | + |
| 79 | +```sh |
| 80 | +$ go run example.go |
| 81 | +Now listening on: http://localhost:8080 |
| 82 | +Application Started. Press CTRL+C to shut down. |
| 83 | +_ |
| 84 | +``` |
| 85 | + |
| 86 | +## Instalação |
| 87 | + |
| 88 | +O único pré requisito é a [Linguagem de Programação GO](https://golang.org/dl/) |
| 89 | + |
| 90 | +```sh |
| 91 | +$ go get -u github.com/kataras/iris |
| 92 | +``` |
| 93 | + |
| 94 | +Iris lança mão da [pasta vendor](https://docs.google.com/document/d/1Bz5-UB7g2uPBdOx-rw5t9MxJwkfpx90cqG9AFL0JAYo). Dessa forma você conseguirá obter builds reprodutíveis já que esse método impede que nomes no branch upstream sejam renomeados ou deletados. |
| 95 | + |
| 96 | +[](_benchmarks/README_UNIX.md) |
| 97 | + |
| 98 | +_Atualizado em : [Terça, 21 de Novembro de 2017](_benchmarks/README_UNIX.md)_ |
| 99 | + |
| 100 | +<details> |
| 101 | +<summary>Benchmarks de fonte third-party acerca dos frameworks web</summary> |
| 102 | + |
| 103 | + |
| 104 | + |
| 105 | +</details> |
| 106 | + |
| 107 | +## Apoie |
| 108 | + |
| 109 | +- [HISTORY](HISTORY.md#mo-21-may-2018--v1065) o arquivo HISTORY é o seu melhor amigo, ele contém informações sobre as últimas features e mudanças. |
| 110 | +- Econtrou algum bug ? Poste-o nas [issues](https://github.com/kataras/iris/issues) |
| 111 | +- Possui alguma dúvida ou gostaria de falar com alguém experiente para resolver seu problema em tempo real ? Junte-se ao [chat da nossa comunidade](https://chat.iris-go.com). |
| 112 | +- Complete nosso formulário de experiência do usuário clicando [aqui](https://docs.google.com/forms/d/e/1FAIpQLSdCxZXPANg_xHWil4kVAdhmh7EBBHQZ_4_xSZVDL-oCC_z5pA/viewform?usp=sf_link) |
| 113 | +- Gostou do framework ? Deixe um Tweet sobre ele! Veja o que os outros já disseram: |
| 114 | + |
| 115 | +<a href="https://twitter.com/gelnior/status/769100480706379776"> |
| 116 | + <img src="https://comments.iris-go.com/comment27_mini.png" width="350px"> |
| 117 | +</a> |
| 118 | + |
| 119 | +<a href="https://twitter.com/MeAlex07/status/822799954188075008"> |
| 120 | + <img src="https://comments.iris-go.com/comment28_mini.png" width="350px"> |
| 121 | +</a> |
| 122 | + |
| 123 | +<a href="https://twitter.com/_mgale/status/818591490305761280"> |
| 124 | + <img src="https://comments.iris-go.com/comment29_mini.png" width="350px"> |
| 125 | +</a> |
| 126 | +<a href="https://twitter.com/VeayoX/status/813273328550973440"> |
| 127 | + <img src="https://comments.iris-go.com/comment30_mini.png" width="350px"> |
| 128 | +</a> |
| 129 | + |
| 130 | +<a href="https://twitter.com/pvsukale/status/745328224876408832"> |
| 131 | + <img src="https://comments.iris-go.com/comment31_mini.png" width="350px"> |
| 132 | +</a> |
| 133 | + |
| 134 | +<a href="https://twitter.com/blainsmith/status/745338092211560453"> |
| 135 | + <img src="https://comments.iris-go.com/comment32_mini.png" width="350px"> |
| 136 | +</a> |
| 137 | + |
| 138 | +<a href="https://twitter.com/tjbyte/status/758287014210867200"> |
| 139 | + <img src="https://comments.iris-go.com/comment33_mini.png" width="350px"> |
| 140 | +</a> |
| 141 | + |
| 142 | +<a href="https://twitter.com/tangzero/status/751050577220698112"> |
| 143 | + <img src="https://comments.iris-go.com/comment34_mini.png" width="350px"> |
| 144 | +</a> |
| 145 | + |
| 146 | +<a href="https://twitter.com/tjbyte/status/758287244947972096"> |
| 147 | + <img src="https://comments.iris-go.com/comment33_2_mini.png" width="350px"> |
| 148 | +</a> |
| 149 | + |
| 150 | +<a href="https://twitter.com/ferarias/status/902468752364773376"> |
| 151 | + <img src="https://comments.iris-go.com/comment41.png" width="350px"> |
| 152 | +</a> |
| 153 | + |
| 154 | +<br/><br/> |
| 155 | + |
| 156 | +Para mais informações sobre como contribuir para o projeto Iris leia por favor o arquivo [CONTRIBUTING.md](CONTRIBUTING.md). |
| 157 | + |
| 158 | +[Lista de todos os Contribuintes](https://github.com/kataras/iris/graphs/contributors) |
| 159 | + |
| 160 | +## Aprenda |
| 161 | + |
| 162 | +Primeiramente, a melhor maneira de começar a aprender um framework é |
| 163 | +aprender os fundamentos da linguagem de programação em questão e |
| 164 | +as funções principais da biblioteca `http`, se seu app é um projeto |
| 165 | +pessoal muito simples que exija performance e manutenção contínua |
| 166 | +é provável que você consiga seguir adiante apenas com a biblioteca |
| 167 | +padrão. Feito isso, você pode seguir as seguintes diretrizes: |
| 168 | + |
| 169 | +- Navegue por **100+1** **[exemplos](_examples)** e os [iris starter kits](#iris-starter-kits) que criamos para você |
| 170 | +- Leia os [godocs](https://godoc.org/github.com/kataras/iris) para mais detalhes |
| 171 | +- Prepare um chá ou cafezinho, ou o que lhe for mais conveniente, e leia alguns [artigos](#articles) que achamos para você |
| 172 | + |
| 173 | +### Iris starter kits |
| 174 | + |
| 175 | +<!-- table form |
| 176 | +| Description | Link | |
| 177 | +| -----------|-------------| |
| 178 | +| Hasura hub starter project with a ready to deploy golang helloworld webapp with IRIS! | https://hasura.io/hub/project/hasura/hello-golang-iris | |
| 179 | +| Web app básico utilizando o Iris |https://github.com/gauravtiwari/go_iris_app | |
| 180 | +| Uma mini rede social criada com o incrível Iris💖💖 | https://github.com/iris-contrib/Iris-Mini-Social-Network | |
| 181 | +| Iris isomorphic react/hot reloadable/redux/css-modules starter kit | https://github.com/iris-contrib/iris-starter-kit | |
| 182 | +| Projeto demo usando react com typescript e Iris | https://github.com/ionutvilie/react-ts | |
| 183 | +| Plataforma de Gerenciamento de Localização auto hospedada criada com Iris e Angular | https://github.com/iris-contrib/parrot | |
| 184 | +| Iris + Docker e Kubernetes | https://github.com/iris-contrib/cloud-native-go | |
| 185 | +| Quickstart do Iris com Nanobox | https://guides.nanobox.io/golang/iris/from-scratch | |
| 186 | +--> |
| 187 | + |
| 188 | +1. [Web app básico utilizando o Iris](https://github.com/gauravtiwari/go_iris_app) |
| 189 | +2. [Uma mini rede social criada com o incrível Iris💖💖] (https://github.com/iris-contrib/Iris-Mini-Social-Network) |
| 190 | +3. [Iris isomorphic react/hot reloadable/redux/css-modules starter kit](https://github.com/iris-contrib/iris-starter-kit) |
| 191 | +4. [Projeto demo usando react com typescript e Iris](https://github.com/ionutvilie/react-ts) |
| 192 | +5. [Plataforma de Gerenciamento de Localização auto hospedada criada com Iris e Angular](https://github.com/iris-contrib/parrot) |
| 193 | +6. [Iris + Docker e Kubernetes](https://github.com/iris-contrib/cloud-native-go) |
| 194 | +7. [Quickstart do Iris com Nanobox](https://guides.nanobox.io/golang/iris/from-scratch) |
| 195 | +8. [Um projeto Hasura para iniciantes pronto para o deply com um app Golang hello-world utilizando o IRIS](https://hasura.io/hub/project/hasura/hello-golang-iris) |
| 196 | + |
| 197 | +> Voce criou algo parecido ? [Informe-nos](https://github.com/kataras/iris/pulls)! |
| 198 | +
|
| 199 | +### Middleware |
| 200 | + |
| 201 | +Iris tem uma ótima coleção de handlers[[1]](middleware/)[[2]](https://github.com/iris-contrib/middleware) os quais você pode utilizar lado a lado com seus web apps. Entretanto, você não esta limitado a eles - você pode utilizar qualquer middleware de terceiros desde que seja compatível com a biblioteca [net/http](https://golang.org/pkg/net/http/), [_examples/convert-handlers](_examples/convert-handlers) é um exemplo que pode ser tomado como base para tal. |
| 202 | + |
| 203 | +Iris, ao contrário dos demais, é 100% compatível com os padrões e esse é o motivo pelo qual a maioria das grandes empresas que inserem Go em seu fluxo operacional, tal qual a famosa US Television Network, usam e confiam no Iris; Ele é atualizado com frequencia e sempre estará alinhado com o padrão da biblioteca `net/http` que é periodicamente modernizada pelos autores da linguagem Go a cada novo release. |
| 204 | + |
| 205 | +### Artigos |
| 206 | + |
| 207 | +* [Um aplicação Todo utilizando Iris e Vue.js](https://hackernoon.com/a-todo-mvc-application-using-iris-and-vue-js-5019ff870064) |
| 208 | +* [Um projeto Hasura para iniciantes pronto para o deply com um app Golang hello-world utilizando o IRIS](https://bit.ly/2lmKaAZ) |
| 209 | +* [Top 6 frameworks web do Go em 2017](https://blog.usejournal.com/top-6-web-frameworks-for-go-as-of-2017-23270e059c4b) |
| 210 | +* [Framework Iris + MongoDB](https://medium.com/go-language/iris-go-framework-mongodb-552e349eab9c) |
| 211 | +* [Como criar um formulário de upload de arquivos com DropzoneJS e Go](https://hackernoon.com/how-to-build-a-file-upload-form-using-dropzonejs-and-go-8fb9f258a991) |
| 212 | +* [Como mostrar arquivos existentes no servidor utilizando DropzoneJS e Go](https://hackernoon.com/how-to-display-existing-files-on-server-using-dropzonejs-and-go-53e24b57ba19) |
| 213 | +* [Iris,um web framework modular](https://medium.com/@corebreaker/iris-web-cd684b4685c7) |
| 214 | +* [Go vs .NET Core em termos de performance HTTP](https://medium.com/@kataras/go-vs-net-core-in-terms-of-http-performance-7535a61b67b8) |
| 215 | +* [Iris Go vs .NET Core Kestrel em termos de performance HTTP](https://hackernoon.com/iris-go-vs-net-core-kestrel-in-terms-of-http-performance-806195dc93d5) |
| 216 | +* [Como transformar um aparelho Android em um servidor web](https://twitter.com/ThePracticalDev/status/892022594031017988) |
| 217 | +* [Fazendo Deploy de um app Iris na hasura](https://medium.com/@HasuraHQ/deploy-an-iris-golang-app-with-backend-apis-in-minutes-25a559bf530b) |
| 218 | +* [Um serviço encurtador de URL utilizando Go, Iris e Bolt](https://medium.com/@kataras/a-url-shortener-service-using-go-iris-and-bolt-4182f0b00ae7) |
| 219 | + |
| 220 | +### Video Aulas |
| 221 | + |
| 222 | +* [Daily Coding - Web Framework Golang: Iris Framework]( https://www.youtube.com/watch?v=BmOLFQ29J3s) por WarnabiruTV, fonte: youtube, custo: **GRATUITO** |
| 223 | +* [Tutorial Golang MVC dengan Iris Framework & Mongo DB](https://www.youtube.com/watch?v=uXiNYhJqh2I&list=PLMrwI6jIZn-1tzskocnh1pptKhVmWdcbS) (19 ate o momento) por Musobar Media, fonte: youtube, custo: **GRATUITO** |
| 224 | +* [Go/Golang 27 - Iris framework : Routage de base](https://www.youtube.com/watch?v=rQxRoN6ub78) por stephgdesign, fonte: youtube, custo: **GRATUITO** |
| 225 | +* [Go/Golang 28 - Iris framework : Templating](https://www.youtube.com/watch?v=nOKYV073S2Y) por stephgdesignn, fonte: youtube, custo: **GRATUITO** |
| 226 | +* [Go/Golang 29 - Iris framework : Paramètres](https://www.youtube.com/watch?v=K2FsprfXs1E) por stephgdesign, fonte: youtube, custo: **GRATUITO** |
| 227 | +* [Go/Golang 30 - Iris framework : Les middelwares](https://www.youtube.com/watch?v=BLPy1So6bhE) por stephgdesign, fonte: youtube, custo: **GRATUITO** |
| 228 | +* [Go/Golang 31 - Iris framework : Les sessions](https://www.youtube.com/watch?v=RnBwUrwgEZ8) por stephgdesign, fonte: youtube, custo: **GRATUITO** |
| 229 | + |
| 230 | +### Seja contratado |
| 231 | + |
| 232 | +Várias empresas e start-ups estão procurando por desenvolvedores web que sabem Go e possuam experiência com Iris como pré requisito, todos os dias estamos procurando informações sobre empregos e postando na nossa [página do facebook](https://www.facebook.com/iris.framework), de um like na página para ser notificado. |
| 233 | + |
| 234 | +## Licença |
| 235 | + |
| 236 | +Iris é licenciado sob a [Licença 3-Clause BSD](LICENSE). Iris é um software 100% gratuito e open-source. |
| 237 | + |
| 238 | +Caso haja quaisquer dúvidas em relação a licença favor enviar um [e-mail ](mailto:[email protected]?subject=Iris%20License). |
0 commit comments