36 KiB
⚡️ بداية سريعة
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)
}
🤖 مقايس الاداء
يتم تنفيذ هذه الاختبارات من قبل TechEmpower و Go Web. إذا كنت تريد رؤية جميع النتائج ، يرجى زيارة موقعنا Wiki.
⚙️ تثبيت
قبل كل شي قم , بتحميل و تثبيت Go. 1.11
أو أعلى مطلوب.
بعد الانتهاء من التثبيت استخدم الامر go get
:
go get -u github.com/gofiber/fiber
🎯 الميزات
- قوي routing
- يقدم خدمة static files
- أقصى أداء
- ذاكرة منخفضة
- API endpoints
- Middleware & Next مدعوم
- سريع server-side programming
- Template engines
- WebSocket دعم
- Rate Limiter
- ترجم الى 15 لغة أخرى
- وأكثر بكثير, استكشف Fiber
💡 فلسفة
قوفر(مستخدمي لغة Go الجدد) جديد يجعل التبديل من Node.js الى Goتتعامل مع منحنى التعلم قبل أن يتمكنوا من البدء في بناءتطبيقات الويب . Fiber, كـ إطار الويب, تم إنشاؤه بفكرة minimalism ويتبع UNIX way, حتى يتمكن القوفرون الجدد من دخول عالم Go بترحيب حار وموثوق.
Fiber هو مستوحى من Express, إطار الويب الأكثر شعبية على الإنترنت. قمنا بدمج سهولة الـ Express و الأداء الخام لـ Go. إذا كنت قد قمت بتطبيق تطبيق ويب في Node.js (using Express or similar), ستظهر العديد من الأساليب والمبادئ الاكثر شيوعاً لك.
نحن نصغي لمستخدمينا issues, نناقش channel وفي جميع أنحاء الإنترنت لإنشاء سريع, مرن و مألوف Go إطار الويب لـ لأي مهمة, **الموعد الأخير ** و تطوير مهارات! فقط مثل Express تفعل لـ JavaScript عالم.
👀 أمثلة
فيما يلي بعض الأمثلة الشائعة. إذا كنت ترغب في رؤية المزيد من أمثلة التعليمات البرمجية, يرجى زيارة Recipes repository او زيارة API documentation.
📖 Basic Routing
func main() {
app := fiber.New()
// GET /john
app.Get("/:name", func(c *fiber.Ctx) {
msg := fmt.Sprintf("Hello, %s 👋!", c.Params("name"))
c.Send(msg) // => Hello john 👋!
})
// GET /john/75
app.Get("/:name/:age/:gender?", func(c *fiber.Ctx) {
msg := fmt.Sprintf("👴 %s is %s years old", c.Params("name"), c.Params("age"))
c.Send(msg) // => 👴 john is 75 years old
})
// GET /dictionary.txt
app.Get("/:file.:ext", func(c *fiber.Ctx) {
msg := fmt.Sprintf("📃 %s.%s", c.Params("file"), c.Params("ext"))
c.Send(msg) // => 📃 dictionary.txt
})
// GET /flights/LAX-SFO
app.Get("/flights/:from-:to", func(c *fiber.Ctx) {
msg := fmt.Sprintf("💸 From: %s, To: %s", c.Params("from"), c.Params("to"))
c.Send(msg) // => 💸 From: LAX, To: SFO
})
// GET /api/register
app.Get("/api/*", func(c *fiber.Ctx) {
msg := fmt.Sprintf("✋ %s", c.Params("*"))
c.Send(msg) // => ✋ /api/register
})
app.Listen(3000)
}
📖 Serving Static Files
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
func main() {
app := fiber.New()
// Match any route
app.Use(func(c *fiber.Ctx) {
fmt.Println("🥇 First handler")
c.Next()
})
// Match all routes starting with /api
app.Use("/api", func(c *fiber.Ctx) {
fmt.Println("🥈 Second handler")
c.Next()
})
// GET /api/register
app.Get("/api/list", func(c *fiber.Ctx) {
fmt.Println("🥉 Last handler")
c.Send("Hello, World 👋!")
})
app.Listen(3000)
}
📚 إظهار المزيد من أمثلة التعليمات البرمجية
Views engines
Fiber defaults to the html/template when no view engine is set.
If you want to execute partials or use a different engine like amber, handlebars, mustache or pug etc..
Checkout our Template package that support multiple view engines.
import (
"github.com/gofiber/fiber"
"github.com/gofiber/template/pug"
)
func main() {
// You can setup Views engine before initiation app:
app := fiber.New(&fiber.Settings{
Views: pug.New("./views", ".pug"),
})
// OR after initiation app at any convenient location:
app.Settings.Views = pug.New("./views", ".pug"),
// And now, you can call template `./views/home.pug` like this:
app.Get("/", func(c *fiber.Ctx) {
c.Render("home", fiber.Map{
"title": "Homepage",
"year": 1999,
})
})
// ...
}
Grouping routes into chains
📖 Group
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
📖 Logger
import (
"github.com/gofiber/fiber"
"github.com/gofiber/fiber/middleware"
)
func main() {
app := fiber.New()
// Default
app.Use(middleware.Logger())
// Custom logging format
app.Use(middleware.Logger("${method} - ${path}"))
// Custom Config
app.Use(middleware.LoggerWithConfig(middleware.LoggerConfig{
Next: func(ctx *fiber.Ctx) bool {
return ctx.Path() != "/private"
},
Format: "${method} - ${path}",
Output: io.Writer,
}))
app.Listen(3000)
}
Cross-Origin Resource Sharing (CORS)
📖 CORS
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)
}
التحقق من CORS عن طريق تمرير أي مجال Origin
العنوان:
curl -H "Origin: http://example.com" --verbose http://localhost:3000
مخصص 404 response
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
📖 JSON
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
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
📖 Recover
import (
"github.com/gofiber/fiber"
"github.com/gofiber/fiber/middleware"
)
func main() {
app := fiber.New()
app.Use(middleware.Recover())
app.Get("/", func(c *fiber.Ctx) {
panic("normally this would crash your app")
})
app.Listen(3000)
}
🧬 Fiber Middleware
The Fiber middleware modules listed here are maintained by the Fiber team.
Middleware | Description | Built-in middleware |
---|---|---|
adaptor | Converter for net/http handlers to/from Fiber request handlers, special thanks to @arsmn! | - |
basicauth | Basic auth middleware provides an HTTP basic authentication. It calls the next handler for valid credentials and 401 Unauthorized for missing or invalid credentials. | - |
compress | Compression middleware for Fiber, it supports deflate , gzip and brotli by default. |
middleware.Compress() |
cors | Enable cross-origin resource sharing CORS with various options. |
- |
csrf | Protect from CSRF exploits. | - |
filesystem | FileSystem middleware for Fiber, special thanks and credits to Alireza Salary | - |
favicon | Ignore favicon from logs or serve from memory if a file path is provided. | middleware.Favicon() |
helmet | Helps secure your apps by setting various HTTP headers. | - |
jwt | JWT returns a JSON Web Token JWT auth middleware. |
- |
keyauth | Key auth middleware provides a key based authentication. | - |
limiter | Rate-limiting middleware for Fiber. Use to limit repeated requests to public APIs and/or endpoints such as password reset. | - |
logger | HTTP request/response logger. | middleware.Logger() |
pprof | Special thanks to Matthew Lee @mthli |
- |
recover | Recover middleware recovers from panics anywhere in the stack chain and handles the control to the centralized ErrorHandler. | middleware.Recover() |
rewrite | Rewrite middleware rewrites the URL path based on provided rules. It can be helpful for backward compatibility or just creating cleaner and more descriptive links. | - |
requestid | Request ID middleware generates a unique id for a request. | middleware.RequestID() |
session | This session middleware is build on top of fasthttp/session by @savsgio MIT. Special thanks to @thomasvvugt for helping with this middleware. | - |
template | This package contains 8 template engines that can be used with Fiber v1.10.x Go version 1.13 or higher is required. |
- |
websocket | Based on Fasthttp WebSocket for Fiber with Locals support! | - |
🌱 Third Party Middlewares
هذه قائمة middlewares التي تم إنشاؤها من قبل المجتمع Fiber , الرجاء إنشاءPR إذا كنت تريد أن ترى ذلك!
- arsmn/fiber-swagger
- arsmn/fiber-casbin
- arsmn/fiber-introspect
- shareed2k/fiber_tracing
- shareed2k/fiber_limiter
- thomasvvugt/fiber-boilerplate
- arsmn/gqlgen
- kiyonlin/fiber_limiter
- juandiii/go-jwk-security
💬 وسائل الإعلام
- Welcome to Fiber — an Express.js styled web framework written in Go with ❤️ — 03 Feb 2020
- Fiber released v1.7! 🎉 What's new and is it still fast, flexible and friendly? — 21 Feb 2020
- 🚀 Fiber v1.8. What's new, updated and re-thinked? — 03 Mar 2020
- Is switching from Express to Fiber worth it? 🤔 — 01 Apr 2020
- Creating Fast APIs In Go Using Fiber — 07 Apr 2020
- Building a Basic REST API in Go using Fiber - 23 Apr 2020
- 📺 Building a REST API using GORM and Fiber - 25 Apr 2020
- 🌎 Create a travel list app with Go, Fiber, Angular, MongoDB and Google Cloud Secret Manager - 25 Apr 2020
- Fiber v1.9.6 🔥 How to improve performance by 817% and stay fast, flexible and friendly? - 12 May 2020
- The road to web-based authentication with Fiber ⚡ - 20 May 2020
- Building an Express-style API in Go with Fiber - 10 June 2020
- Construir una API en Golang con Fiber 🇪🇸 - 28 June 2020
- 📺Why Go Fiber Is THE New Framework To Learn - 29 June 2020
👍 مساهمة
إذا كنت تريد أن تقول شكرا جزيل و/او دعم التنمية النشطة للـ Fiber
:
- اضف GitHub نجمة للمشروع.
- غرد عن المشروع في تويتر .
- اكتب مراجعة أو برنامج تعليمي عن Medium, Dev.to او في موقعك الشخصي.
- ساعدنا في ترجمة موقعنا API التوثيق عبر Crowdin
- دعم المشروع بالتبرع بـ كوب من القهوة.
☕ الداعمين
Fiber هو مشروع مفتوح المصدر يعمل على التبرعات لدفع الفواتير ، على سبيل المثال اسم النطاق الخاص بنا , gitbook, netlify and serverless الاستضافة. إذا كنت تريد دعم Fiber, تستطيع ☕ شراء كوب قهوة هنا.
المستخدم | التبرع | |
---|---|---|
@destari | ☕ x 10 | |
@thomasvvugt | ☕ x 5 | |
@hendratommy | ☕ x 5 | |
@ekaputra07 | ☕ x 5 | |
@jorgefuertes | ☕ x 5 | |
@candidosales | ☕ x 5 | |
@l0nax | ☕ x 3 | |
@ankush | ☕ x 3 | |
@bihe | ☕ x 3 | |
@justdave | ☕ x 3 | |
@koddr | ☕ x 1 | |
@lapolinar | ☕ x 1 | |
@diegowifi | ☕ x 1 | |
@ssimk0 | ☕ x 1 | |
@raymayemir | ☕ x 1 | |
@melkorm | ☕ x 1 | |
@marvinjwendt | ☕ x 1 | |
@toishy | ☕ x 1 |
💻 المساهمون في كتابة الكود
⭐️ Stargazers
⚠️ رخصة
Copyright (c) 2019-present Fenny and Contributors. Fiber
هو برنامج مجاني ومفتوح المصدر مرخص بموجب MIT License. تم إنشاء الشعار الرسمي من قبل Vic Shóstak ووزعت تحت Creative Commons رخصة (CC BY-SA 4.0 International).
Third-party library licenses