Skip to content

Latest commit

 

History

History
716 lines (551 loc) · 50.6 KB

README_az.md

File metadata and controls

716 lines (551 loc) · 50.6 KB
Raw

Fiber

Fiber Go dili üçün ən sürətli HTTP mühərriki Fasthttp və Express kitabxanasına bənzər arxitektura üzərində qurulmuş bir web framework-dür. Sıfır yaddaş ayrılması (zero-memory allocation) və performans səbəbilə development prosesini sürətləndirmək və asanlaşdırmaq üçün tərtib edilmişdir.

⚡️ Sürətli Başlanğıc

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")
}

🤖 Performans Dəyərləri

Bu testlər TechEmpower və Go Web tərəfindən aparılıb. Bütün nəticələri görmək üçün Wiki səhifəsinə keçid edə bilərsiniz.

⚙️ Quraşdırılması

Go dilinin 1.17 və ya daha yuxarı versiyanın yükləndiyindən əmin olun.

Bir qovluq yaratdıqdan sonra, go mod init github.com/your/repo komandasını eyni qovluğun daxilində işə salaraq layihənizi başladın (go modulları haqqında əlavə bilgilər). Növbəti addım olaraq Fiber-i go get komandasını işlədərək yükləyin:

go get -u github.com/gofiber/fiber/v2

🎯 Özəllikləri

Daha ətraflı məlumat üçün rəsmi sənədləşməyə baxış keçirə bilərsiniz.

💡 Fəlsəfə

Node.js-dən Go-ya yeni keçən gopher-lər veb tətbiqlər və mikroservislər yazmadan öncə dilin özünəməxsus sintaksisini öyrənməklə məşğul olurlar. Fiber Minimalizm və UNIX-in yaradılış prinsiplərinə uyğun şəkildə qurulmuş bir web framework-dür. Bu sahədə yeni olan gopher-lər Go dünyasında özlərini doğma və güvənli hiss edə biləcək şəkildə bir ab-hava ilə rastlaşa bilərlər.

Fiber internet üzərində olan ən məşhur web framework-lərdən biri olan Express-dən ilhamlanaraq ərsəyə gəlmişdir. Biz Express-in rahatlıq və asanlıq xüsusiyyətlərini, Go-nun çiy performansı ilə birləşdirmişik; əgər əvvəldən Node.js üzərində (Express və ya bənzərləri) veb tətbiqi yaratmısınızsa, onda əksər metodlar və prinsiplər sizə tanış gələcəkdir.

Biz istifadəçilərdən gələn issue-a, Discord kanalımıza və bütün interneti əhatə edən vasitələrdən gələn rəyləri nəzərə alırıq. Bunun nəzdində, biz sürətli və rahat şəkildə hər bir tapşırığın səviyyəsinə uyğun olan — dostcasına bir Go web framework-ü olmağı hədəfləmişik (Express-in JavaScript dünyasında etdiyi kimi).

⚠️ Limitlər

  • Fiber unsafe prinsiplərə əsaslanaraq çalışdığından, o hər zaman Go-nun son versiyası ilə uyğunlaşmaya bilər. Buna görə də, Fiber 2.40.0 — Go 1.17 və 1.21 versiyaları ilə test edilərək saz vəziyyətə gətirilmişdir.
  • Fiber net/http interfeysləri ilə uyğun deyil. Yəni gqlgen, go-swagger kimi net/http ekosisteminin parçası olan layihələri istifadə edə bilməzsiniz.

👀 Misallar

Aşağıda geniş istifadə olunan misallardan bəziləri siyahı şəklində qeyd olunub. Əgər daha çox koda dair misalları görmək istəyirsinizsə, onda Əlavə misallardan ibarət github deposunu və ya API sənədləşməni nəzərdən keçirin.

📖 Sadə Routing

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) // => ✋ register
    })

    // GET /flights/LAX-SFO
    app.Get("/flights/:from-:to", func(c *fiber.Ctx) error {
        msg := fmt.Sprintf("💸 From: %s, To: %s", c.Params("from"), c.Params("to"))
        return c.SendString(msg) // => 💸 From: LAX, To: SFO
    })

    // GET /dictionary.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) // => 📃 dictionary.txt
    })

    // GET /john/75
    app.Get("/:name/:age/:gender?", func(c *fiber.Ctx) error {
        msg := fmt.Sprintf("👴 %s is %s years old", c.Params("name"), c.Params("age"))
        return c.SendString(msg) // => 👴 john is 75 years old
    })

    // GET /john
    app.Get("/:name", func(c *fiber.Ctx) error {
        msg := fmt.Sprintf("Hello, %s 👋!", c.Params("name"))
        return c.SendString(msg) // => Hello john 👋!
    })

    log.Fatal(app.Listen(":3000"))
}

📖 Route-un Adlandırılması

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) // => ✋ register
    }).Name("api")

    data, _ := json.MarshalIndent(app.GetRoute("api"), "", "  ")
    fmt.Print(string(data))
    // Prints:
    // {
    //    "method": "GET",
    //    "name": "api",
    //    "path": "/api/*",
    //    "params": [
    //      "*1"
    //    ]
    // }


    log.Fatal(app.Listen(":3000"))
}

📖 Static Fayl Təqdimatı

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"))
}

📖 Middleware & Next

func main() {
    app := fiber.New()

    // Match any route
    app.Use(func(c *fiber.Ctx) error {
        fmt.Println("🥇 First handler")
        return c.Next()
    })

    // Match all routes starting with /api
    app.Use("/api", func(c *fiber.Ctx) error {
        fmt.Println("🥈 Second handler")
        return c.Next()
    })

    // GET /api/list
    app.Get("/api/list", func(c *fiber.Ctx) error {
        fmt.Println("🥉 Last handler")
        return c.SendString("Hello, World 👋!")
    })

    log.Fatal(app.Listen(":3000"))
}
📚 Daha çox misalllar

Baxış mühərriki (View Engine)

📖 Config 📖 Mühərriklər 📖 Render

Fiber baxış mühərriki təyin edilmədikdə html/template-in default formasını alır.

Əgər siz partial-ı və ya müxtəlif tipdə olan mühərrikləri istifadə etmək istəyirsinizsə, o zaman amber, handlebars, mustache, pug və s. kimi misallara baxa bilərsiniz.

Çoxsaylı baxış mühərriklərini dəstəkləyən template package-ə göstərilən link vasitəsilə nəzərdən keçirə bilərsiniz.

package main

import (
    "github.com/gofiber/fiber/v2"
    "github.com/gofiber/template/pug"
)

func main() {
    // Baxış mühərrikini tətbiqi başlatzmadan əvvəl quraşdıra bilərsiniz:
    app := fiber.New(fiber.Config{
        Views: pug.New("./views", ".pug"),
    })

    // Və indi `./views/home.pug` template-i bu şəkildə çağıra bilərsiniz:
    app.Get("/", func(c *fiber.Ctx) error {
        return c.Render("home", fiber.Map{
            "title": "Homepage",
            "year":  1999,
        })
    })

    log.Fatal(app.Listen(":3000"))
}

Route-ın zəncirlərdə qruplaşdırılması

📖 Group

func middleware(c *fiber.Ctx) error {
    fmt.Println("Don't mind me!")
    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 routes
    v1 := api.Group("/v1", middleware) // /api/v1
    v1.Get("/list", handler)           // /api/v1/list
    v1.Get("/user", handler)           // /api/v1/user

    // API v2 routes
    v2 := api.Group("/v2", middleware) // /api/v2
    v2.Get("/list", handler)           // /api/v2/list
    v2.Get("/user", handler)           // /api/v2/user

    // ...
}

Middleware Logger

📖 Logger

package main

import (
    "log"

    "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"))
}

Cross-Origin Resource Sharing (CORS)

📖 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ığında istənilən domeni keçməklə CORS-un yoxlanması:

curl -H "Origin: http://example.com" --verbose http://localhost:3000

Custom 404 response

📖 HTTP Methods

func main() {
    app := fiber.New()

    app.Static("/", "./public")

    app.Get("/demo", func(c *fiber.Ctx) error {
        return c.SendString("This is a demo!")
    })

    app.Post("/register", func(c *fiber.Ctx) error {
        return c.SendString("Welcome!")
    })

    // Sonuncu middleware-in hər şeyə uyğunlaşdırılması
    app.Use(func(c *fiber.Ctx) error {
        return c.SendStatus(404)
        // => 404 "Not Found"
    })

    log.Fatal(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) error {
        return c.JSON(&User{"John", 20})
        // => {"name":"John", "age":20}
    })

    app.Get("/json", func(c *fiber.Ctx) error {
        return c.JSON(fiber.Map{
            "success": true,
            "message": "Hi John!",
        })
        // => {"success":true, "message":"Hi John!"}
    })

    log.Fatal(app.Listen(":3000"))
}

WebSocket-in təkminləşdirilməsi (upgrade)

📖 Websocket

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
}

Server-Sent Events

📖 More Info

import (
    "github.com/gofiber/fiber/v2"
    "github.com/valyala/fasthttp"
)

func main() {
  app := fiber.New()

  app.Get("/sse", func(c *fiber.Ctx) error {
    c.Set("Content-Type", "text/event-stream")
    c.Set("Cache-Control", "no-cache")
    c.Set("Connection", "keep-alive")
    c.Set("Transfer-Encoding", "chunked")

    c.Context().SetBodyStreamWriter(fasthttp.StreamWriter(func(w *bufio.Writer) {
      fmt.Println("WRITER")
      var i int

      for {
        i++
        msg := fmt.Sprintf("%d - the time is %v", i, time.Now())
        fmt.Fprintf(w, "data: Message: %s\n\n", msg)
        fmt.Println(msg)

        w.Flush()
        time.Sleep(5 * time.Second)
      }
    }))

    return nil
  })

  log.Fatal(app.Listen(":3000"))
}

Middleware-in Bərpası

📖 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("normally this would crash your app")
    })

    log.Fatal(app.Listen(":3000"))
}

Etibarlı Proxy İstifadəsi

📖 Config

import (
    "github.com/gofiber/fiber/v2"
    "github.com/gofiber/fiber/v2/middleware/recover"
)

func main() {
    app := fiber.New(fiber.Config{
        EnableTrustedProxyCheck: true,
        TrustedProxies: []string{"0.0.0.0", "1.1.1.1/30"}, // IP address or IP address range
        ProxyHeader: fiber.HeaderXForwardedFor,
    })

    // ...

    log.Fatal(app.Listen(":3000"))
}

🧬 Daxili Middleware

Aşağıda Fiber-in daxilində olan middleware-lər siyahı şəklində göstərilmişdir.

Middleware Açıqlama
basicauth Sadə bir auth middleware-dir və HTTP Basic Auth yaratmaq üçün istifadə olunur. Keçərli vəsiqə (credentials) bilgiləri üçün sonrakı handler-i, əksik və ya keçərsiz vəsiqə bilgiləri üçün 401 qaytarır.
cache Response-ı dayandırır və keşə yerləşdirir.
compress Fiber üçün sıxışdırma (compression) middleware-dir. Default olaraq deflate, gzip və brotli dəstəkləyir.
cors Çeşidli seçimlərlə başlanğıclar arası mənbə paylaşımı (CORS) aktivləşdirir.
csrf CSRF exploit-dən qorunmasını təmin edir.
encryptcookie Encrypt middleware-i cookie dəyərlərini şifrələyir.
envvar Environment dəyərlərini göstərilən config-ə görə təyin edir.
etag Keşlərin daha səmərəli istifadəsinə və bant genişliyinə qənaət etməyə imkan verən ETag middleware-i; məzmun dəyişməyibsə veb serverin response-nı təkrar göndərməsinin qarşısını alır.
expvar Expvar middleware, HTTP serverlərinin bəzi runtime dəyərlərini JSON formatında göstərir.
favicon Əgər faylın yolu (path) göstərilmişdirsə, artıq loglarda olan favicon-u yox sayıb onu saxlanan depodan götürür.
filesystem Fiber üçün fayl sistem middleware-i. Alireza Salary-ə xüsusi təşəkkürlər.
limiter Fiber üçün rate limitləyən middleware. Açıq API-ə və ya şifrə yeniləmə kimi endpoint-ə yönəlik təkrarlanan request-in qarşısını alır.
logger HTTP istək/cavab (request/response) logger-i.
monitor Monitor middleware-i serverin metriklərini report edər ("Express-status-monitor"-dan qaynaqlanıb).
pprof Matthew Lee-yə xüsusi təşəkkürlər (@mthli).
proxy Birdən çox server-ə proxy istəyi göndərməyiniz üçündür.
recover Recover middleware-i stack chain-ni hər hansı bir yerindəki paniklərdən qurtulmasına kömək edir və kontrolu mərkəzləşdirilmiş ErrorHandler-ə ötürür.
requestid Hər request üçün ayrı request id yaradır.
session Session üçün middleware. Qeyd: Bu middleware Fiber-in öz storage struktrunu istifadə edir.
skip Skip middleware-i verilən şərt true olduğu halda handler-i görməyərək üstündən ötüb keçir.
timeout Bir request üçün maksimum vaxt əlavə edir. Əgər arada fasilə yaranarsa, onda proses məhz ErrorHandler-ə göndərilərək icra edilir.
keyauth Key giriş middleware-i, key əsaslı bir authentication metodudur.
redirect Yönləndirmə üçün middleware.
rewrite Rewrite middleware-i verilən qanunlara əsasən URL yolunu (path) yenidən yazır. Geri dönüşün icrası üçün uyğunluq təşkil edən təsviri linklərin yaradılması üçün nəzərdə tutulmuşdur.
adaptor Fiber request handler-dən net/http handler-ə çevirici. @arsmn-ə xüsusi təşəkkürlər!
helmet Fərqli HTTP header istifadə edərək tətbiqi daha təhlükəsiz saxlamağa kömək edir.

🧬 Xarici Middleware

Fiber komandası tərəfindən dəstəklənən və inkişaf etdirilən middleware-in siyahısı.

Middleware Description
jwt JWT, JSON Web Token(JWT) girişi qaytaran bir middleware-dir.
storage Fiber-in Storage arxitekturasını dəstəkləyən bir sıra storage driver verir. Bu sayədə storage-ə ehtiyac duyan Fiber middleware-də rahatlıqla istifadə oluna bilər.
template Bu paket, Fiber v1.10.x, Go versiyası 1.13 və ya daha yuxarı olduqda istifadə oluna bilər. 8 template mühərriki var.
websocket Yerlilərin dəstəyi ilə WebSocket-ə əsaslanan Fiber üçün Fasthttp.

🕶️ Möhtəşəm Siyahı

Əlavə yazılar, middleware-lər, misallar, və alətlər üçün bizim möhtəşəm siyahımıza göz atın.

👍 Dəstək Nümayişi

Əgər Fiber-ə dəstək olmaq və ya təşəkkür etmək istəyirsinizsə:

  1. Layihəni GitHub Ulduzu ilə işarələyin.
  2. Layihə haqqında şəxsi 𝕏 (Twitter) hesabınızda paylaşın.
  3. Medium, Dev.to və ya şəxsi bloqunuz üzərindən bir incələmə və ya tədris yönümlü bir yazı dərc edin.
  4. Bizim üçün, sadəcə bir fincan kofe alın.

☕ "Bir fincan kofe almaq" məsələsi

Fiber açıq qaynaqlı bir layihə olduğu üçün, gəlirlərini yalnız ianələr vasitəsilə təmin edir və bu da domain adı, gitbook, netlify, serverless hosting xərcləri üçün istifadə olunur. Belə olduğu halda, Fiber-ə ən yaxşı dəstək elə bizim üçün ☕ bir kofe almaqdan gələ bilər.

İstifadəçi İanə
@destari ☕ x 10
@dembygenesis ☕ x 5
@thomasvvugt ☕ x 5
@hendratommy ☕ x 5
@ekaputra07 ☕ x 5
@jorgefuertes ☕ x 5
@candidosales ☕ x 5
@l0nax ☕ 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

‎‍💻 Koda Töhfə Verənlər

Code Contributors

⭐️ Layihəni Ulduzlayanlar

Stargazers over time

⚠️ Lisenziya Haqqında

Müəllif Hüququ (c) 2019-bugün Fenny və Contributors. Fiber pulsuz və açıq qaynaqlı bir proqram təminatıdır və MIT License altında lisenziyalaşmışdır. Rəsmi loqo Vic Shóstak tərəfindən yaradılmış və Creative Commons lisenziyası altında paylanmışdır (CC BY-SA 4.0 International).

Üçüncü Tərəf Kitabxana Lisenziyaları