2020-02-12 00:04:27 +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:27 +01:00
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/gb.svg" >
< / a >
2020-02-12 23:32:31 +03:00
<!-- <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-12 00:04:27 +01: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 >
< 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 >
< a href = "https://github.com/gofiber/fiber/blob/master/.github/README_pt.md" >
< img height = "20px" src = "https://cdnjs.cloudflare.com/ajax/libs/flag-icon-css/3.4.6/flags/4x3/pt.svg" >
< / a >
< 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:56 +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-12 00:04:27 +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-12 23:34:45 +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:27 +01:00
< / p >
< p align = "center" >
2020-02-12 23:32:31 +03:00
< strong > Fiber< / strong > — это < strong > веб фреймворк< / strong > , который был вдохновлен < a href = "https://github.com/expressjs/express" > Express< / a > и основан на < a href = "https://github.com/valyala/fasthttp" > Fasthttp< / a > , самом быстром HTTP-движке написанном на < a href = "https://golang.org/doc/" > Go< / a > . Фреймворк был разработан с целью < strong > упростить< / strong > процесс < strong > быстрой< / strong > разработки < strong > высокопроизводительных< / strong > веб-приложений с < strong > нулевым распределением памяти< / strong > .
2020-02-12 00:04:27 +01:00
< / p >
2020-02-11 00:32:01 +00:00
## ⚡️ Быстрый старт
```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)
}
```
## ⚙️ Установка
2020-02-12 23:32:31 +03:00
Прежде всего, [скачайте ](https://golang.org/dl/ ) и установите Go.
> Go **1.11** (с включенными [модулями Go](https://golang.org/doc/go1.11#modules)) или выше.
2020-02-11 00:32:01 +00:00
Установка выполняется с помощью команды [`go get` ](https://golang.org/cmd/go/#hdr-Add_dependencies_to_current_module_and_install_them ) :
```bash
2020-02-12 23:32:31 +03:00
go get -u github.com/gofiber/fiber
2020-02-11 00:32:01 +00:00
```
2020-02-12 23:32:31 +03:00
## 🤖 Бенчмарки
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
Тестирование проводилось с помощью [TechEmpower ](https://github.com/TechEmpower/FrameworkBenchmarks ) и [Go Web ](https://github.com/smallnest/go-web-framework-benchmark ). Если вы хотите увидеть все результаты, пожалуйста, посетите наш [Wiki ](https://fiber.wiki/benchmarks ).
2020-02-11 00:32:01 +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:32:01 +00:00
< / p >
## 🎯 Особенности
- Надежная [маршрутизация ](https://fiber.wiki/routing )
2020-02-12 23:32:31 +03:00
- Доступ к [статичным файлам ](https://fiber.wiki/application#static )
2020-02-11 00:32:01 +00:00
- Экстремальная [производительность ](https://fiber.wiki/benchmarks )
2020-02-12 23:32:31 +03:00
- [Низкий объем потребления памяти ](https://fiber.wiki/benchmarks )
2020-02-12 23:34:45 +03:00
- [Эндпоинты ](https://fiber.wiki/context ) Express [API ](https://fiber.wiki/context )
2020-02-12 23:32:31 +03:00
- Middleware и поддержка [Next ](https://fiber.wiki/context#next )
2020-02-11 00:32:01 +00:00
- [Быстрое ](https://dev.to/koddr/welcome-to-fiber-an-express-js-styled-fastest-web-framework-written-with-on-golang-497 ) программирование на стороне сервера
2020-02-14 02:24:06 +01:00
- Available in [5 languages ](https://fiber.wiki/ )
2020-02-12 23:32:31 +03:00
- И многое другое, [посетите наш Wiki ](https://fiber.wiki/ )
2020-02-11 00:32:01 +00:00
## 💡 Философия
2020-02-12 23:32:31 +03:00
Новые Go-программисты, которые переключаются с [Node.js ](https://nodejs.org/en/about/ ) на [Go ](https://golang.org/doc/ ), имеют дело с очень извилистой кривой обучения, прежде чем они смогут начать создавать свои веб-приложения или микросервисы. Fiber, как **веб-фреймворк** , был создан с идеей **минимализма** и следовал **принципу UNIX** , так что новички смогут быстро войти в мир Go без особых проблем.
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
Fiber **вдохновлен** Express, самым популярным веб фреймворком в Интернете. Мы объединили **простоту** Express и **чистую производительность** Go. Если вы когда-либо реализовывали веб-приложение на Node.js (*с использованием Express или аналогичного фреймворка*), то многие методы и принципы покажутся вам **очень знакомыми** .
2020-02-11 00:32:01 +00:00
## 👀 Примеры
2020-02-12 23:32:31 +03:00
Ниже перечислены некоторые из распространенных примеров. Если вы хотите увидеть больше примеров кода, пожалуйста, посетите наш [репозиторий рецептов ](https://github.com/gofiber/recipes ) или [документацию по API ](https://fiber.wiki ).
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
### Serve static files
2020-02-11 00:32:01 +00:00
```go
func main() {
app := fiber.New()
2020-02-16 18:00:14 +01:00
app.Static("/public")
2020-02-11 00:32:01 +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:32:01 +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:32:01 +00:00
app.Listen(3000)
}
```
2020-02-16 18:00:14 +01:00
### Routing
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-11 00:32:01 +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:32:01 +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:32:01 +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:32:01 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
### Middleware & Next
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
```go
func main() {
app := fiber.New()
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// Match any route
app.Use(func(c *fiber.Ctx) {
fmt.Println("First middleware")
c.Next()
})
2020-02-11 00:32:01 +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:32:01 +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!")
})
app.Listen(3000)
}
```
2020-02-11 00:32:01 +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 >
### Custom 404 response
```go
func main() {
app := fiber.New()
2020-02-11 00:32:01 +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!")
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
// Last middleware to match anything
app.Use(func(c *fiber.Ctx) {
c.SendStatus(404) // => 404 "Not Found"
})
2020-02-11 00:32:01 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:32:01 +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:32:01 +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:32:01 +00:00
2020-02-16 18:00:14 +01:00
app.Listen(3000)
}
```
2020-02-11 00:32:01 +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!")
})
2020-02-14 02:05:39 +01:00
2020-02-16 18:00:14 +01:00
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-12 23:40:20 +03:00
## 💬 Медиа
2020-02-11 00:32:01 +00:00
2020-02-12 23:40:20 +03:00
- [Welcome to Fiber — an Express.js styled web framework written in Go with ❤️ ](https://dev.to/koddr/welcome-to-fiber-an-express-js-styled-fastest-web-framework-written-with-on-golang-497 ) *[Vic Shóstak](https://github.com/koddr), 3 февраля 2020 г .*
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
## 👍 Помощь проекту
2020-02-11 00:32:01 +00:00
2020-02-12 23:32:31 +03:00
Если вы хотите сказать **спасибо** и/или поддержать активное развитие `Fiber` :
2020-02-11 00:32:01 +00:00
1. Добавьте [GitHub Star ](https://github.com/gofiber/fiber/stargazers ) в проект.
2020-02-12 23:32:31 +03:00
2. Напишите о проекте [в вашем 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 ).
3. Сделайте обзор фреймворка на [Medium ](https://medium.com/ ), [Dev.to ](https://dev.to/ ) или в личном блоге.
4. Помогите нам перевести `README` и [API ](https://fiber.wiki/ ) на другой язык.
2020-02-11 00:32:01 +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 >
## ⭐️ Звезды
2020-02-11 00:32:01 +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 >
## ⚠️ Лицензия
2020-02-12 23:49:35 +03:00
`Fiber` — это бесплатное программное обеспечение с открытым исходным кодом, лицензированное по [лицензии MIT ](https://github.com/gofiber/fiber/blob/master/LICENSE ).