Fiber, Go için en hızlı HTTP motoru olan Fasthttp üzerine inşa edilmiş, Express'ten ilham alan bir web frameworküdür. Sıfır bellek ataması ve performans göz önünde bulundurularak hızlı geliştirme için işleri kolaylaştırmak üzere tasarlanmıştır.
package main
import "github.com/gofiber/fiber/v2"
func main() {
app := fiber.New()
app.Get("/", func(c *fiber.Ctx) error {
return c.SendString("Hello, World 👋!")
})
app.Listen(":3000")
}
Bu testler TechEmpower ve Go Web tarafından gerçekleştirildi. Bütün sonuçları görmek için lütfen Wiki sayfasını ziyaret ediniz.
Go'nun 1.14
sürümü (indir) ya da daha yüksek bir sürüm gerekli.
Bir klasör oluşturup klasörün içinde go mod init github.com/your/repo
yazarak projenize başlayın (daha fazla öğren). Ardından Fiber'ı kurmak için go get
komutunu çalıştırın:
go get -u github.com/gofiber/fiber/v2
- Güçlü rotalar
- Statik dosya sunumu
- Olağanüstü performans
- Düşük bellek tüketimi
- API uç noktaları
- Ara katman & Sonraki desteği
- Hızlı sunucu taraflı programlama
- Template engines
- WebSocket support
- Rate Limiter
- 15 dilde mevcut
- Ve daha fazlası, Fiber'ı keşfet
Node.js'ten Go'ya geçen yeni gopherlar kendi web uygulamalarını ve mikroservislerini yazmaya başlamadan önce dili öğrenmek ile uğraşıyorlar. Fiber, bir framework olarak, minimalizm ve UNIX yolunu izleme fikri ile oluşturuldu. Böylece yeni gopherlar sıcak ve güvenilir bir hoşgeldin ile Go dünyasına giriş yapabilirler.
Fiber internet üzerinde en popüler olan Express web frameworkünden esinlenmiştir. Biz Express'in kolaylığını ve Go'nun ham performansını birleştirdik. Daha önce Node.js üzerinde (Express veya benzerini kullanarak) bir web uygulaması geliştirdiyseniz, pek çok metod ve prensip size çok tanıdık gelecektir.
- Fiber unsafe kullanımı sebebiyle her zaman Go'nun son sürümüyle uyumlu olmayabilir. Fiber 2.18.0, Go 1.14 ile 1.17 sürümleriyle test edildi.
- Fiber net/http arabirimiyle uyumlu değildir. Yani gqlgen veya go-swagger gibi net/http ekosisteminin parçası olan projeleri kullanamazsınız.
Aşağıda yaygın örneklerden bazıları listelenmiştir. Daha fazla kod örneği görmek için lütfen Github reposunu veya API dokümantasyonunu ziyaret ediniz.
func main() {
app := fiber.New()
// GET /api/kayit
app.Get("/api/*", func(c *fiber.Ctx) error {
msg := fmt.Sprintf("✋ %s", c.Params("*"))
return c.SendString(msg) // => ✋ kayit
})
// GET /flights/IST-ESB
app.Get("/flights/:kalkis-:inis", func(c *fiber.Ctx) error {
msg := fmt.Sprintf("💸 Kalkış: %s, İniş: %s", c.Params("kalkis"), c.Params("inis"))
return c.SendString(msg) // => 💸 Kalkış: IST, İniş: ESB
})
// GET /sozluk.txt
app.Get("/:file.:ext", func(c *fiber.Ctx) error {
msg := fmt.Sprintf("📃 %s.%s", c.Params("file"), c.Params("ext"))
return c.SendString(msg) // => 📃 sozluk.txt
})
// GET /muhittin/75
app.Get("/:isim/:yas/:cinsiyet?", func(c *fiber.Ctx) error {
msg := fmt.Sprintf("👴 %s %s yaşında", c.Params("isim"), c.Params("yas"))
return c.SendString(msg) // => 👴 muhittin 75 yaşında
})
// GET /muhittin
app.Get("/:isim", func(c *fiber.Ctx) error {
msg := fmt.Sprintf("Merhaba, %s 👋!", c.Params("isim"))
return c.SendString(msg) // => Merhaba Muhittin 👋!
})
log.Fatal(app.Listen(":3000"))
}
func main() {
app := fiber.New()
// GET /api/register
app.Get("/api/*", func(c *fiber.Ctx) error {
msg := fmt.Sprintf("✋ %s", c.Params("*"))
return c.SendString(msg) // => ✋ kayit
}).Name("api")
data, _ := json.MarshalIndent(app.GetRoute("api"), "", " ")
fmt.Print(string(data))
// Cikti:
// {
// "method": "GET",
// "name": "api",
// "path": "/api/*",
// "params": [
// "*1"
// ]
// }
log.Fatal(app.Listen(":3000"))
}
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
log.Fatal(app.Listen(":3000"))
}
func main() {
app := fiber.New()
// Bütün routelara etki eder.
app.Use(func(c *fiber.Ctx) error {
fmt.Println("🥇 İlk handler")
return c.Next()
})
// /api ile başlayan bütün routelara etki eder.
app.Use("/api", func(c *fiber.Ctx) error {
fmt.Println("🥈 İkinci handler")
return c.Next()
})
// GET /api/register
app.Get("/api/list", func(c *fiber.Ctx) error {
fmt.Println("🥉 Son handler")
return c.SendString("Merhaba, Dünya 👋!")
})
log.Fatal(app.Listen(":3000"))
}
📚 Daha fazla kod örneği göster
Hiçbir View Engine ayarlanmadığında Fiber varsayılan olarak html/template'a geçer.
Kısmi yürütmek istiyorsanız veya amber, handlebars, mustache veya pug gibi farklı engine'ler kullanmak istiyorsanız
Çoklu View Engine destekleyen [Template'ımıza](https://github.com/gofiber/template göz atın.
package main
import (
"github.com/gofiber/fiber/v2"
"github.com/gofiber/template/pug"
)
func main() {
// Uygulamayı başlatmadan önce View Engine tanımlayabilirsiniz:
app := fiber.New(fiber.Config{
Views: pug.New("./views", ".pug"),
})
// Ve şimdi `./views/home.pug` templateni şu şekilde çağırabilirsiniz:
app.Get("/", func(c *fiber.Ctx) error {
return c.Render("home", fiber.Map{
"title": "Homepage",
"year": 1999,
})
})
log.Fatal(app.Listen(":3000"))
}
📖 Group
func middleware(c *fiber.Ctx) error {
fmt.Println("Beni umursama!")
return c.Next()
}
func handler(c *fiber.Ctx) error {
return c.SendString(c.Path())
}
func main() {
app := fiber.New()
// Root API route
api := app.Group("/api", middleware) // /api
// API v1 routeları
v1 := api.Group("/v1", middleware) // /api/v1
v1.Get("/list", handler) // /api/v1/list
v1.Get("/user", handler) // /api/v1/user
// API v2 routeları
v2 := api.Group("/v2", middleware) // /api/v2
v2.Get("/list", handler) // /api/v2/list
v2.Get("/user", handler) // /api/v2/user
// ...
}
📖 Logger
package main
import (
"fmt"
"github.com/gofiber/fiber/v2"
"github.com/gofiber/fiber/v2/middleware/logger"
)
func main() {
app := fiber.New()
app.Use(logger.New())
// ...
log.Fatal(app.Listen(":3000"))
}
📖 CORS
import (
"log"
"github.com/gofiber/fiber/v2"
"github.com/gofiber/fiber/v2/middleware/cors"
)
func main() {
app := fiber.New()
app.Use(cors.New())
// ...
log.Fatal(app.Listen(":3000"))
}
Origin
başlığı içinde herhangi bir alan adı kullanarak CORS'u kontrol edin:
curl -H "Origin: http://example.com" --verbose http://localhost:3000
func main() {
app := fiber.New()
app.Static("/", "./public")
app.Get("/demo", func(c *fiber.Ctx) error {
return c.SendString("Bu bir demodur!")
})
app.Post("/register", func(c *fiber.Ctx) error {
return c.SendString("Hoşgeldiniz!")
})
// Hiçbir endpointle eşleşmezse gideceği middleware ve yanıtı.
app.Use(func(c *fiber.Ctx) error {
return c.SendStatus(404)
// => 404 "Sayfa bulunamadı"
})
log.Fatal(app.Listen(":3000"))
}
📖 JSON
type User struct {
Isim string `json:"name"`
Yas int `json:"age"`
}
func main() {
app := fiber.New()
app.Get("/user", func(c *fiber.Ctx) error {
return c.JSON(&User{"Muhittin Topalak", 20})
// => {"Isim":"Muhittin Topalak", "Yas":20}
})
app.Get("/json", func(c *fiber.Ctx) error {
return c.JSON(fiber.Map{
"success": true,
"mesaj": "Merhaba Muhittin Topalak!",
})
// => {"success":true, "message":"Merhaba Muhittin Topalak!"}
})
log.Fatal(app.Listen(":3000"))
}
import (
"github.com/gofiber/fiber/v2"
"github.com/gofiber/fiber/v2/middleware/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
}
}
}))
log.Fatal(app.Listen(":3000"))
// ws://localhost:3000/ws
}
📖 Recover
import (
"github.com/gofiber/fiber/v2"
"github.com/gofiber/fiber/v2/middleware/recover"
)
func main() {
app := fiber.New()
app.Use(recover.New())
app.Get("/", func(c *fiber.Ctx) error {
panic("normalde bu uygulamanızı çökertir.")
})
log.Fatal(app.Listen(":3000"))
}
Fibera dahil edilen middlewareların bir listesi aşağıda verilmiştir.
Middleware | Açıklama |
---|---|
basicauth | Basic auth middleware'i, bir HTTP Basic auth sağlar. Geçerli kimlik bilgileri için sonraki handlerı ve eksik veya geçersiz kimlik bilgileri için 401 döndürür. |
compress | Fiber için sıkıştırma middleware, varsayılan olarak deflate , gzip ve brotli yi destekler. |
cache | Reponseları durdur ve önbelleğe al |
cors | Çeşitli seçeneklerle başlangıçlar arası kaynak paylaşımını (CORS) etkinleştirin. |
csrf | CSRF exploitlerinden korunun. |
filesystem | Fiber için FileSystem middleware, Alireza Salary'e özel teşekkürler |
favicon | Bir dosya yolu sağlanmışsa, loglardaki favicon'u yoksayar veya bellekten sunar. |
limiter | Fiber için hız sınırlayıcı middleware'i. Açık API'lere ve/veya parola sıfırlama gibi endpointlere yönelik tekrarlanan istekleri sınırlamak için kullanın. |
logger | HTTP istek/yanıt logger'ı. |
pprof | Matthew Lee'ye özel teşekkürler (@mthli) |
proxy | Birden çok sunucuya proxy istekleri yapmanızı sağlar |
requestid | Her requeste id verir |
recover | Recover middleware'i, stack chain'ini herhangi bir yerindeki paniklerden kurtulur ve kontrolü merkezileştirilmiş ErrorHandler'e verir. |
timeout | Bir request için maksimum süre ekler ve aşılırsa ErrorHandler'a iletir. |
Harici olarak barındırılan middlewareların modüllerinin listesi Fiber ekibi tarafından korunur.
Middleware | Açıklama |
---|---|
adaptor | Fiber request handlerdan net/http handlerları için dönüştürücü, @arsmn'a özel teşekkürler! |
helmet | Çeşitli HTTP headerları ayarlayarak uygulamalarınızın güvenliğini sağlamaya yardımcı olur. |
jwt | JWT, bir JSON Web Token (JWT) yetkilendirmesi döndüren middleware. |
keyauth | Key auth middleware, key tabanlı bir authentication sağlar. |
rewrite | Rewrite middleware, sağlanan kurallara göre URL yolunu yeniden yazar. Geriye dönük uyumluluk için veya yalnızca daha temiz ve daha açıklayıcı bağlantılar oluşturmak için yardımcı olabilir. |
session | Bu session middleware'i, @savsgio MIT tarafından fasthttp/session üzerine inşa edilmiştir. Bu middleware'a yardımcı olduğu için @thomasvvugt'a özel teşekkürler. |
template | Bu paket, Fiber v1.10.x , Go sürüm 1.13 veya üzeri gerekli olduğunda kullanılabilecek 8 template engine içerir. |
websocket | Yereller desteğiyle Fiber için Fasthttp WebSocket'a dayalıdır! |
Bu, Fiber topluluğu tarafından oluşturulan middleware'lerin bir listesidir, sizinkini görmek istiyorsanız lütfen bir PR oluşturun!
- arsmn/fiber-casbin
- arsmn/fiber-introspect
- arsmn/fiber-swagger
- arsmn/gqlgen
- codemicro/fiber-cache
- sujit-baniya/fiber-boilerplate
- juandiii/go-jwk-security
- kiyonlin/fiber_limiter
- shareed2k/fiber_limiter
- shareed2k/fiber_tracing
- thomasvvugt/fiber-boilerplate
- ansrivas/fiberprometheus
- LdDl/fiber-long-poll
- K0enM/fiber_vhost
- theArtechnology/fiber-inertia
- aschenmaker/fiber-health-check
- elastic/apmfiber
Eğer teşekkür etmek veya Fiber
'ın aktif geliştirilmesini desteklemek istiyorsanız:
- Projeye yıldız verebilirsiniz.
- Twitter hesabınızdan proje hakkında tweet atabilirsinşz.
- Medium, Dev.to veya kişisel blogunuz üzerinden bir inceleme veya eğitici yazı yazabilirsiniz.
- Projeye bir fincan kahve ısmarlayarak destek olabilirsiniz.
Fiber; alan adı, gitbook, netlify, serverless yer sağlayıcısı giderleri ve benzeri şeyleri ödemek için bağışlarla yaşayan bir açık kaynaklı projedir. Eğer Fiber'e destek olmak isterseniz, ☕ buradan kahve ısmarlayabilirsiniz.
User | Donation | |
---|---|---|
@destari | ☕ x 10 | |
@dembygenesis | ☕ x 5 | |
@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 |
Telif (c) 2019-günümüz Fenny ve Contributors. Fiber
, MIT Lisansı altında özgür ve açık kaynaklı bir yazılımdır. Resmi logosu Vic Shóstak tarafında tasarlanmıştır ve Creative Commons lisansı altında dağıtımı yapılır. (CC BY-SA 4.0 International).
Üçüncü Parti Library Lisansları