معالجة معلمات Go Fiber

التعامل مع متغيرات الطلبات المختلفة في إطار عمل Go Fiber

المثال البسيط

يتم الحصول على جميع متغيرات الطلب في إطار Fiber من خلال كائن السياق Ctx.

app.Get("/user/:name?", func(c *fiber.Ctx) error {
    // الحصول على المتغيرات من خلال معلمة Ctx لدالة المسار واستدعاء الطريقة المناسبة
    // هنا، يتم الحصول على المتغير name من خلال Params
    return c.SendString(c.Params("name"))
})

الحصول على متغيرات المسار

الحصول على المتغيرات من مسار URL

// GET http://example.com/user/fenny
app.Get("/user/:name", func(c *fiber.Ctx) error {
  c.Params("name") // "fenny"

  // ...
})

// GET http://example.com/user/fenny/123
app.Get("/user/*", func(c *fiber.Ctx) error {
  c.Params("*")  // "fenny/123"
  c.Params("*1") // "fenny/123"
  
  c.Params("*", "default value")  // يمكن تعيين القيمة الافتراضية باستخدام المعلمة الثانية
})

الحصول على متغيرات نوع Int من المسار

// GET http://example.com/user/123
app.Get("/user/:id", func(c *fiber.Ctx) error {
  id, err := c.ParamsInt("id") // الرقم الصحيح 123 ولا يوجد خطأ

  // ...
})

الحصول على متغيرات الاستعلام في طلب GET

// GET http://example.com/?order=desc&brand=nike
app.Get("/", func(c *fiber.Ctx) error {
  c.Query("order")         // "desc"
  c.Query("brand")         // "nike"
  // يمكن استخدام المعلمة الثانية لتعيين قيمة افتراضية، التي ستُرجع إذا لم يكن المعلمة موجودة
  c.Query("empty", "nike") // "nike"

  // ...
})

إرجاع جميع متغيرات الاستعلام

// GET http://example.com/?name=alex&want_pizza=false&id=
app.Get("/", func(c *fiber.Ctx) error {
    m := c.Queries()
    m["name"]        // "alex"
    m["want_pizza"]  // "false"
    m["id"]          // ""
    // ...
})

ربط متغيرات الاستعلام بكائن هيكلي

// تعريف هيكل لاستقبال المتغيرات
// استخدام المعلمة tag لتحديد أسماء المتغيرات لتكون مرتبطة
type Person struct {
    Name     string     `query:"name"`
    Pass     string     `query:"pass"`
    Products []string   `query:"products"`
}

app.Get("/", func(c *fiber.Ctx) error {
        // تحديد متغير هيكلي لاستقبال المتغيرات
        p := new(Person)

        // استخدام QueryParser لربط متغيرات الاستعلام بالمتغير p
        if err := c.QueryParser(p); err != nil {
            return err
        }

        log.Println(p.Name)     // john
        log.Println(p.Pass)     // doe
        log.Println(p.Products) // [shoe, hat]

        // ...
})
// قم بتنفيذ أمر curl التالي للاختبار
// curl "http://localhost:3000/?name=john&pass=doe&products=shoe,hat"

الحصول على متغيرات نموذج الطلب POST

app.Post("/", func(c *fiber.Ctx) error {
  // الحصول على القيمة الأولى من حقل النموذج "name":
  c.FormValue("name")
  // => "john" أو "" إذا كانت غير موجودة

  // ...
})
## معالجة معلمات الجسم

يُستخدم بشكل رئيسي لمعالجة طلبات POST/PUT ويدعم معلمات JSON و XML ونموذج البيانات.

```go
// قم بتعريف الهيكل لاستقبال المعلمات، وقم بتعريف أسماء حقول المعلمات التي تريد استقبالها من خلال علامات json و xml و form
// json و xml و form يمكن اختيارها حسب الحاجة؛ ليس من الضروري تضمين كلها
type Person struct {
    Name string `json:"name" xml:"name" form:"name"`
    Pass string `json:"pass" xml:"pass" form:"pass"`
}

app.Post("/", func(c *fiber.Ctx) error {
    // قم بتعريف المتغير الهيكلي لاستقبال المعلمات
    p := new(Person)

    // استخدم BodyParser لربط معلمات الجسم بالمتغير p
    if err := c.BodyParser(p); err != nil {
        return err
    }

    log.Println(p.Name) // john
    log.Println(p.Pass) // doe

    // ...
})

// أمثلة عن أنواع مختلفة من الطلبات؛ لطلبات المعلمات بتنسيق JSON، تذكر أن تعين Content-Type: application/json

// curl -X POST -H "Content-Type: application/json" --data "{\"name\":\"john\",\"pass\":\"doe\"}" localhost:3000

// curl -X POST -H "Content-Type: application/xml" --data "<login><name>john</name><pass>doe</pass></login>" localhost:3000

// curl -X POST -H "Content-Type: application/x-www-form-urlencoded" --data "name=john&pass=doe" localhost:3000

// curl -X POST -F name=john -F pass=doe http://localhost:3000

// curl -X POST "http://localhost:3000/?name=john&pass=doe"

كيفية الحصول على البيانات الأصلية للجسم على النحو التالي:

// curl -X POST http://localhost:8080 -d user=john

app.Post("/", func(c *fiber.Ctx) error {
  // استخدم BodyRaw لإرجاع البيانات الأساسية للجسم
  return c.Send(c.BodyRaw()) // []byte("user=john")
})

الحصول على رؤوس الطلب

app.Get("/", func(c *fiber.Ctx) error {
  c.Get("Content-Type")       // "text/plain"
  c.Get("CoNtEnT-TypE")       // "text/plain"
  c.Get("something", "john")  // "john"
  // ...
})

الحصول على عنوان IP الخاص بالعميل

app.Get("/", func(c *fiber.Ctx) error {
  c.IP() // "127.0.0.1"

  // ...
})

إذا تم نشر التطبيق على خادم باستخدام وكيل أو موازن الأحمال، يجب استرداد عنوان IP العميل من خلال رأس x-forwarded-for عن طريق الإعداد التالي:

app := fiber.New(fiber.Config{
  ProxyHeader: fiber.HeaderXForwardedFor,
})

قراءة الكوكيز

app.Get("/", func(c *fiber.Ctx) error {
  // الحصول على الكوكيز بواسطة المفتاح:
  c.Cookies("name")         // "john"
  c.Cookies("empty", "doe") // "doe"
  // ...
})