2020-02-12 00:04:56 +01:00
< p align = "center" >
< a href = "https://fiber.wiki" >
< img alt = "Fiber" height = "100" src = "https://github.com/gofiber/docs/blob/master/static/logo.svg" >
< / a >
< br > < br >
2020-02-14 02:05:39 +01:00
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README.md" >
2020-02-12 00:04:56 +01:00
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/gb.svg" >
< / a >
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_ru.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/ru.svg" >
< / a >
2020-02-13 00:04:10 +03:00
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_es.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/es.svg" >
< / a >
2020-02-12 00:04:56 +01:00
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_ja.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/jp.svg" >
< / a >
2020-02-13 00:04:10 +03:00
<!-- <a href="https://github.com/gofiber/fiber/blob/master/.github/README_pt.md">
2020-02-12 00:04:56 +01:00
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/pt.svg" >
2020-02-13 00:04:10 +03:00
< / a > -->
2020-02-12 00:04:56 +01:00
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_zh-CN.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/cn.svg" >
< / a >
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_de.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/de.svg" >
< / a >
2020-02-12 01:03:52 +01:00
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_ko.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/kr.svg" >
< / a >
2020-02-16 23:42:02 +01:00
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_fr.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/fr.svg" >
< / a >
2020-02-19 15:48:41 +03:00
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_tr.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/tr.svg" >
< / a >
2020-02-12 00:04:56 +01:00
< br > < br >
< a href = "https://github.com/gofiber/fiber/releases" >
< img src = "https://img.shields.io/github/release/gofiber/fiber?style=flat-square" >
< / a >
< a href = "https://fiber.wiki" >
< img src = "https://img.shields.io/badge/api-documentation-blue?style=flat-square" >
< / a >
< a href = "#" >
< img src = "https://img.shields.io/badge/goreport-A%2B-brightgreen?style=flat-square" >
< / a >
< a href = "https://gocover.io/github.com/gofiber/fiber" >
< img src = "https://img.shields.io/badge/coverage-91%25-brightgreen?style=flat-square" >
< / a >
< a href = "https://travis-ci.org/gofiber/fiber" >
< img src = "https://img.shields.io/travis/gofiber/fiber/master.svg?label=linux&style=flat-square" >
< / a >
< a href = "https://travis-ci.org/gofiber/fiber" >
< img src = "https://img.shields.io/travis/gofiber/fiber/master.svg?label=windows&style=flat-square" >
< / a >
2020-02-13 00:04:10 +03:00
< a href = "https://travis-ci.org/gofiber/fiber" >
< img src = "https://img.shields.io/travis/gofiber/fiber/master.svg?label=osx&style=flat-square" >
< / a >
2020-02-12 00:04:56 +01:00
< / p >
< p align = "center" >
2020-02-11 21:17:02 -03:00
< b > Fiber< / b > é um < b > framework web< / b > inspirado no < a href = "https://github.com/expressjs/express" > Express< / a > , construído sobre o < a href = "https://github.com/valyala/fasthttp" > Fasthttp< / a > , o motor HTTP < b > mais rápido< / b > do < a href = "https://golang.org/doc/" > Go< / a > . Projetado para < b > facilitar< / b > e < b > acelerar< / b > o desenvolvimento, com < b > zero de alocação de memória< / b > e < b > desempenho< / b > em mente.
2020-02-12 00:04:56 +01:00
< / p >
2020-02-11 00:31:49 +00:00
## ⚡️ Início rápido
```go
package main
import "github.com/gofiber/fiber"
func main() {
app := fiber.New()
app.Get("/", func(c *fiber.Ctx) {
c.Send("Hello, World!")
})
app.Listen(3000)
}
```
## ⚙️ Instalação
2020-02-11 21:17:02 -03:00
Primeiro de tudo, faça o [download ](https://golang.org/dl/ ) e instale o Go. É necessário a versão `1.11` ou superior.
2020-02-11 00:31:49 +00:00
A instalação é feita usando o comando [`go get` ](https://golang.org/cmd/go/#hdr-Add_dependencies_to_current_module_and_install_them ) :
```bash
go get github.com/gofiber/fiber
```
## 🤖 Benchmarks
2020-02-11 21:17:02 -03:00
Esses testes são realizados pelo [TechEmpower ](https://github.com/TechEmpower/FrameworkBenchmarks ) e [Go Web ](https://github.com/smallnest/go-web-framework-benchmark ). Se você quiser ver todos os resultados, visite nosso [Wiki ](https://fiber.wiki/benchmarks ) .
2020-02-11 00:31:49 +00:00
< p float = "left" align = "middle" >
2020-02-11 02:31:22 +01:00
< img src = "https://github.com/gofiber/docs/blob/master/.gitbook/assets//benchmark-pipeline.png" width = "49%" >
< img src = "https://github.com/gofiber/docs/blob/master/.gitbook/assets//benchmark_alloc.png" width = "49%" >
2020-02-11 00:31:49 +00:00
< / p >
## 🎯 Recursos
- [Roteamento ](https://fiber.wiki/routing ) robusto
- Servir [arquivos estáticos ](https://fiber.wiki/application#static )
- [Desempenho ](https://fiber.wiki/benchmarks ) extremo
2020-02-11 21:17:02 -03:00
- [Baixo consumo de memória ](https://fiber.wiki/benchmarks )
- [API de rotas ](https://fiber.wiki/context )
2020-02-11 00:31:49 +00:00
- Suporte para Middleware e [Next ](https://fiber.wiki/context#next )
2020-02-11 21:17:02 -03:00
- Programação [rápida ](https://dev.to/koddr/welcome-to-fiber-an-express-js-styled-fastest-web-framework-written-with-on-golang-497 ) de aplicações de servidor
- Traduzido em [5 idiomas ](https://fiber.wiki/ )
2020-02-11 00:31:49 +00:00
- E muito mais, [explore o Fiber ](https://fiber.wiki/ )
## 💡 Filosofia
2020-02-11 21:17:02 -03:00
Os novos gophers que mudaram do [Node.js ](https://nodejs.org/en/about/ ) para o [Go ](https://golang.org/doc/ ) estão tendo que lidar com uma curva de aprendizado antes que possam começar a criar seus aplicativos web ou microsserviços. O Fiber, como um **framework web** , foi criado com a ideia de ser **minimalista** e seguindo o **caminho UNIX** , para que novos gophers possam, rapidamente, entrar no mundo do Go com uma recepção calorosa e confiável.
2020-02-11 00:31:49 +00:00
2020-02-11 21:17:02 -03:00
O Fiber é **inspirado** no Express, o framework web mais popular da Internet. Combinamos a **facilidade** do Express e o **desempenho bruto** do Go. Se você já implementou um aplicativo web com Node.js ( _usando Express.js ou similar_ ), então muitos métodos e princípios parecerão **muito comuns** para você.
2020-02-11 00:31:49 +00:00
## 👀 Exemplos
2020-02-11 21:17:02 -03:00
Listados abaixo estão alguns exemplos comuns. Se você quiser ver mais exemplos de código, visite nosso [repositório de receitas ](https://github.com/gofiber/recipes ) ou a [documentação da API ](https://fiber.wiki ).
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
### Serve static files
2020-02-11 00:31:49 +00:00
```go
func main() {
app := fiber.New()
2020-02-16 18:00:14 +01:00
app.Static("/public")
2020-02-11 00:31:49 +00:00
// => http://localhost:3000/js/script.js
// => http://localhost:3000/css/style.css
2020-02-16 18:00:14 +01:00
app.Static("/prefix", "/public")
2020-02-11 00:31:49 +00:00
// => http://localhost:3000/prefix/js/script.js
// => http://localhost:3000/prefix/css/style.css
2020-02-16 18:00:14 +01:00
app.Static("*", "/public/index.html")
// => http://localhost:3000/any/path/shows/index/html
2020-02-11 00:31:49 +00:00
app.Listen(3000)
}
```
2020-02-16 18:00:14 +01:00
### Routing
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
// GET /john
app.Get("/:name", func(c *fiber.Ctx) {
fmt.Printf("Hello %s!", c.Params("name"))
// => Hello john!
})
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
// GET /john
app.Get("/:name/:age?", func(c *fiber.Ctx) {
fmt.Printf("Name: %s, Age: %s", c.Params("name"), c.Params("age"))
// => Name: john, Age:
})
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
// GET /api/register
app.Get("/api*", func(c *fiber.Ctx) {
fmt.Printf("/api%s", c.Params("*"))
// => /api/register
})
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
### Middleware & Next
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
// Match any route
app.Use(func(c *fiber.Ctx) {
fmt.Println("First middleware")
c.Next()
})
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
// Match all routes starting with /api
app.Use("/api", func(c *fiber.Ctx) {
fmt.Println("Second middleware")
c.Next()
})
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
// POST /api/register
app.Post("/api/register", func(c *fiber.Ctx) {
fmt.Println("Last middleware")
c.Send("Hello, World!")
})
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:31:49 +00:00
2020-02-14 02:24:06 +01:00
< details >
2020-02-16 18:00:14 +01:00
< summary > 📜 Show more code examples< / summary >
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
### Custom 404 response
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
app.Static("/public")
app.Get("/demo", func(c *fiber.Ctx) {
c.Send("This is a demo!")
})
app.Post("/register", func(c *fiber.Ctx) {
c.Send("Welcome!")
})
// Last middleware to match anything
app.Use(func(c *fiber.Ctx) {
c.SendStatus(404) // => 404 "Not Found"
})
app.Listen(3000)
}
```
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
### JSON Response
```go
func main() {
app := fiber.New()
type User struct {
Name string `json:"name"`
Age int `json:"age"`
2020-02-11 00:31:49 +00:00
}
2020-02-16 18:00:14 +01:00
// Serialize JSON
app.Get("/json", func(c *fiber.Ctx) {
c.JSON(& User{"John", 20})
// => {"name":"John", "age":20}
})
2020-02-11 00:31:49 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:31:49 +00:00
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
### Recover from panic
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
app.Get("/", func(c *fiber.Ctx) {
panic("Something went wrong!")
})
app.Recover(func(c *fiber.Ctx) {
c.Status(500).Send(c.Error())
// => 500 "Something went wrong!"
})
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
< / details >
2020-02-14 02:05:39 +01:00
2020-02-11 00:31:49 +00:00
## 💬 Mídia
2020-02-11 21:17:02 -03:00
- [Bem-vindo ao Fiber — uma estrutura da Web com estilo Express.js, escrita em Go com ❤️ ](https://dev.to/koddr/welcome-to-fiber-an-express-js-styled-fastest-web-framework-written-with-on-golang-497 ) _por [Vic Shóstak](https://github.com/koddr), 03 fev 2020_
2020-02-11 00:31:49 +00:00
2020-02-11 21:17:02 -03:00
## 👍 Contribuindo
2020-02-11 00:31:49 +00:00
2020-02-13 00:04:10 +03:00
Se você quer **agradecer** e/ou apoiar o desenvolvimento ativo do `Fiber` :
2020-02-11 00:31:49 +00:00
2020-02-11 21:17:02 -03:00
1. Deixe uma [estrela no GitHub ](https://github.com/gofiber/fiber/stargazers ) do projeto.
2020-02-11 00:31:49 +00:00
2. Tweet sobre o projeto [no seu Twitter ](https://twitter.com/intent/tweet?text=%F0%9F%9A%80%20Fiber%20%E2%80%94%20is%20an%20Express.js%20inspired%20web%20framework%20build%20on%20Fasthttp%20for%20%23Go%20https%3A%2F%2Fgithub.com%2Fgofiber%2Ffiber ) .
2020-02-11 21:17:02 -03:00
3. Escreva um review ou tutorial no [Medium ](https://medium.com/ ), [Dev.to ](https://dev.to/ ) ou blog pessoal.
4. Nos ajude a traduzir esses `README` e a [documentação da API ](https://fiber.wiki/ ) para outros idiomas.
2020-02-11 00:31:49 +00:00
2020-02-12 03:54:54 +01:00
## ☕ Supporters
2020-02-16 18:00:14 +01:00
< a href = "https://www.buymeacoffee.com/fenny" target = "_blank" >
< img src = "https://github.com/gofiber/docs/blob/master/static/buy-morning-coffee-3x.gif" alt = "Buy Me A Coffee" height = "100" >
< / a >
2020-02-12 03:54:54 +01:00
< table >
< tr >
< td align = "center" >
2020-02-14 02:05:39 +01:00
< a href = "https://github.com/bihe" >
2020-02-16 18:00:14 +01:00
< img src = "https://avatars1.githubusercontent.com/u/635852?s=460&v=4" width = "100px" > < / br >
2020-02-14 02:05:39 +01:00
< sub > < b > HenrikBinggl< / b > < / sub >
2020-02-12 03:54:54 +01:00
< / a >
2020-02-14 02:05:39 +01:00
< / td >
< td align = "center" >
< a href = "https://github.com/koddr" >
2020-02-16 18:00:14 +01:00
< img src = "https://avatars0.githubusercontent.com/u/11155743?s=460&v=4" width = "100px" > < / br >
2020-02-14 02:05:39 +01:00
< sub > < b > koddr< / b > < / sub >
< / a >
< / td >
< td align = "center" >
< a href = "https://github.com/MarvinJWendt" >
2020-02-16 18:00:14 +01:00
< img src = "https://avatars1.githubusercontent.com/u/31022056?s=460&v=4" width = "100px" > < / br >
2020-02-14 02:05:39 +01:00
< sub > < b > MarvinJWendt< / b > < / sub >
< / a >
< / td >
< td align = "center" >
< a href = "https://github.com/toishy" >
2020-02-16 18:00:14 +01:00
< img src = "https://avatars1.githubusercontent.com/u/31921460?s=460&v=4" width = "100px" > < / br >
2020-02-14 02:05:39 +01:00
< sub > < b > ToishY< / b > < / sub >
< / a >
< / td >
2020-02-12 03:54:54 +01:00
< / tr >
< / table >
## ⭐️ Estrelas
2020-02-11 00:31:49 +00:00
< a href = "https://starchart.cc/gofiber/fiber" rel = "nofollow" > < img src = "https://starchart.cc/gofiber/fiber.svg" alt = "Stars over time" style = "max-width:100%;" > < / a >
## ⚠️ Licença
2020-02-13 00:04:10 +03:00
`Fiber` é um software livre e de código aberto licenciado sob a [Licença MIT ](https://github.com/gofiber/fiber/blob/master/LICENSE ).