Fiber是一个基于Express的 Web框架，建立在Go语言写的 最快的FasthttpHTTP引擎的基础上。皆在简化 零内存分配和提高性能，以便快速开发。

## ⚡️ 快速入门 ```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) } ``` ## ⚙️ 安装首先， [下载](https://golang.org/dl/)并安装Go。 `1.11`或更高。使用[`go get`](https://golang.org/cmd/go/#hdr-Add_dependencies_to_current_module_and_install_them)命令完成安装： ```bash export GO111MODULE=on export GOPROXY=https://goproxy.cn go get -u github.com/gofiber/fiber ``` ## 🤖 性能这些测试由[TechEmpower](https://github.com/TechEmpower/FrameworkBenchmarks)和[Go Web执行](https://github.com/smallnest/go-web-framework-benchmark) 。如果要查看所有结果，请访问我们的[Wiki](https://docs.gofiber.io/benchmarks) 。

## 🎯 特点 - 强大的[路由](https://docs.gofiber.io/routing) - [静态文件](https://docs.gofiber.io/application#static)服务 - 极限[表现](https://docs.gofiber.io/benchmarks) - [内存占用低](https://docs.gofiber.io/benchmarks) - Express [API端点](https://docs.gofiber.io/context) - 中间件和[Next](https://docs.gofiber.io/context#next)支持 - [快速的](https://dev.to/koddr/welcome-to-fiber-an-express-js-styled-fastest-web-framework-written-with-on-golang-497)服务器端编程 - [Template engines](https://docs.gofiber.io/middleware#template) - [WebSocket support](https://docs.gofiber.io/middleware#websocket) - [Rate Limiter](https://docs.gofiber.io/middleware#limiter) - Available in [10 languages](https://docs.gofiber.io/) - 以及更多[文档](https://docs.gofiber.io/) ## 💡 哲学从[Node.js](https://nodejs.org/en/about/)切换到[Go的](https://golang.org/doc/)新gopher在开始构建Web应用程序或微服务之前正在应对学习过程。 Fiber作为一个**Web框架** ，是按照**极简主义**的思想并遵循**UNIX方式创建的**，因此新的gopher可以以热烈和可信赖的欢迎**方式**迅速进入Go的世界。 Fiber **受** Internet上最流行的Web框架Expressjs的**启发** 。我们结合了Express的**易用**性和Go的**原始性能** 。如果您曾经在Node.js上实现过Web应用程序(*使用Express.js或类似工具*)，那么许多方法和原理对您来说似乎**非常易懂**。 ## 👀 示例下面列出了一些常见示例。如果您想查看更多代码示例，请访问我们的[Recipes存储库](https://github.com/gofiber/recipes)或访问我们的[API文档](https://docs.gofiber.io) 。 ### Routing 📖 https://docs.gofiber.io/#basic-routing ```go func main() { app := fiber.New() // GET /john app.Get("/:name", func(c *fiber.Ctx) { fmt.Printf("Hello %s!", c.Params("name")) // => Hello john! }) // 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: }) // GET /api/register app.Get("/api/*", func(c *fiber.Ctx) { fmt.Printf("/api/%s", c.Params("*")) // => /api/register }) app.Listen(3000) } ``` ### Serve static files 📖 https://docs.gofiber.io/application#static ```go func main() { app := fiber.New() app.Static("/", "/public") // => http://localhost:3000/js/script.js // => http://localhost:3000/css/style.css app.Static("/prefix", "/public") // => http://localhost:3000/prefix/js/script.js // => http://localhost:3000/prefix/css/style.css app.Static("*", "/public/index.html") // => http://localhost:3000/any/path/shows/index/html app.Listen(3000) } ``` ### Middleware & Next 📖 https://docs.gofiber.io/routing#middleware 📖 https://docs.gofiber.io/context#next ```go func main() { app := fiber.New() // Match any route app.Use(func(c *fiber.Ctx) { fmt.Println("First middleware") c.Next() }) // Match all routes starting with /api app.Use("/api", func(c *fiber.Ctx) { fmt.Println("Second middleware") c.Next() }) // GET /api/register app.Get("/api/list", func(c *fiber.Ctx) { fmt.Println("Last middleware") c.Send("Hello, World!") }) app.Listen(3000) } ```

📚 Show more code examples

### Template engines 📖 https://docs.gofiber.io/application#settings 📖 https://docs.gofiber.io/context#render 📖 https://docs.gofiber.io/middleware#template Fiber supports the default [Go template engine](https://golang.org/pkg/html/template/) But if you want to use another template engine like [amber](https://github.com/eknkc/amber), [handlebars](https://github.com/aymerick/raymond), [mustache](https://github.com/cbroglie/mustache) or [pug](https://github.com/Joker/jade). You can use our [Template Middleware](https://docs.gofiber.io/middleware#template). ```go package main import ( "github.com/gofiber/fiber" "github.com/gofiber/template" ) func main() { // You can setup template engine before initiation app: app := fiber.New(&fiber.Settings{ TemplateEngine: template.Mustache(), TemplateFolder: "./views", TemplateExtension: ".tmpl", }) // OR after initiation app at any convenient location: app.Settings.TemplateEngine = template.Mustache() app.Settings.TemplateFolder = "./views" app.Settings.TemplateExtension = ".tmpl" // And now, you can call template `./views/home.tmpl` like this: app.Get("/", func(c *fiber.Ctx) { c.Render("home", fiber.Map{ "title": "Homepage", "year": 1999, }) }) // ... } ``` ### Grouping routes into chains 📖 https://docs.gofiber.io/application#group ```go func main() { app := fiber.New() // Root API route api := app.Group("/api", cors()) // /api // API v1 routes v1 := api.Group("/v1", mysql()) // /api/v1 v1.Get("/list", handler) // /api/v1/list v1.Get("/user", handler) // /api/v1/user // API v2 routes v2 := api.Group("/v2", mongodb()) // /api/v2 v2.Get("/list", handler) // /api/v2/list v2.Get("/user", handler) // /api/v2/user // ... } ``` ### Middleware logger 📖 https://docs.gofiber.io/middleware#logger ```go import ( "github.com/gofiber/fiber" "github.com/gofiber/logger" ) func main() { app := fiber.New() // Optional logger config config := logger.Config{ Format: "${time} - ${method} ${path}\n", TimeFormat: "Mon, 2 Jan 2006 15:04:05 MST", } // Logger with config app.Use(logger.New(config)) app.Listen(3000) } ``` ### Cross-Origin Resource Sharing (CORS) 📖 https://docs.gofiber.io/middleware#cors ```go import ( "github.com/gofiber/fiber" "github.com/gofiber/cors" ) func main() { app := fiber.New() // CORS with default config app.Use(cors.New()) app.Listen(3000) } ``` Check CORS by passing any domain in `Origin` header: ```bash curl -H "Origin: http://example.com" --verbose http://localhost:3000 ``` ### Custom 404 response 📖 https://docs.gofiber.io/application#http-methods ```go func main() { app := fiber.New() 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) } ``` ### JSON Response 📖 https://docs.gofiber.io/context#json ```go type User struct { Name string `json:"name"` Age int `json:"age"` } func main() { app := fiber.New() app.Get("/user", func(c *fiber.Ctx) { c.JSON(&User{"John", 20}) // => {"name":"John", "age":20} }) app.Get("/json", func(c *fiber.Ctx) { c.JSON(fiber.Map{ "success": true, "message": "Hi John!", }) // => {"success":true, "message":"Hi John!"} }) app.Listen(3000) } ``` ### WebSocket Upgrade 📖 https://docs.gofiber.io/middleware#websocket ```go import ( "github.com/gofiber/fiber" "github.com/gofiber/websocket" ) func main() { app := fiber.New() app.Get("/ws", websocket.New(func(c *websocket.Conn) { for { mt, msg, err := c.ReadMessage() if err != nil { log.Println("read:", err) break } log.Printf("recv: %s", msg) err = c.WriteMessage(mt, msg) if err != nil { log.Println("write:", err) break } } })) app.Listen(3000) // ws://localhost:3000/ws } ``` ### Recover middleware 📖 https://docs.gofiber.io/middleware#recover ```go import ( "github.com/gofiber/fiber" "github.com/gofiber/recover" ) func main() { app := fiber.New() // Optional recover config config := recover.Config{ Handler: func(c *fiber.Ctx, err error) { c.SendString(err.Error()) c.SendStatus(500) }, } // Logger with custom config app.Use(recover.New(config)) app.Listen(3000) } ```

## 💬 媒体 - [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) — _03 Feb 2020_ - [Fiber released v1.7! 🎉 What's new and is it still fast, flexible and friendly?](https://dev.to/koddr/fiber-v2-is-out-now-what-s-new-and-is-he-still-fast-flexible-and-friendly-3ipf) — _21 Feb 2020_ - [🚀 Fiber v1.8. What's new, updated and re-thinked?](https://dev.to/koddr/fiber-v1-8-what-s-new-updated-and-re-thinked-339h) — _03 Mar 2020_ - [Is switching from Express to Fiber worth it? 🤔](https://dev.to/koddr/are-sure-what-your-lovely-web-framework-running-so-fast-2jl1) — _01 Apr 2020_ - [Creating Fast APIs In Go Using Fiber](https://dev.to/jozsefsallai/creating-fast-apis-in-go-using-fiber-59m9) — _07 Apr 2020_ ## 👍 贡献如果您要说声**谢谢**或支持`Fiber`的积极发展： 1. 将[GitHub Star](https://github.com/gofiber/fiber/stargazers)添加到项目中。 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)发布有关项目[的推文](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文件`翻译成其它语言。 ## ☕ Coffee Supporters

_{Thomas van Vugt}

_{Ray Mayemir}

_melkorm

_{Eka Putra}

_{Henrik Binggl}

_{Vic Shóstak}

_MarvinJWendt

_ToishY

_JustDave

_melkorm

_ekaputra07

## ‎‍💻 Code Contributors

## ⚠️ License Copyright (c) 2019-present [Fenny](https://github.com/fenny) and [Fiber Contributors](https://github.com/gofiber/fiber/graphs/contributors). `Fiber` is free and open-source software licensed under the [MIT License](https://github.com/gofiber/fiber/blob/master/LICENSE). Official logo was created by [Vic Shóstak](https://github.com/koddr) and distributed under [Creative Commons](https://creativecommons.org/licenses/by-sa/4.0/) license (CC BY-SA 4.0 International).