fiber/README_ar_SA.md at 5f1b711fd87bf9b6289ddb4687709e4762b165cc

mirror of https://github.com/gofiber/fiber.git synced 2025-02-24 04:24:02 +00:00

Removed stargazers and releases badges

2020-06-18 23:52:37 +02:00

32 KiB

Raw Blame History

Fiber هو إطار ويب مستوحى من Express مبني على Fasthttp, اسرع محرك HTTP لـ 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)
}

🤖 مقايس الاداء

يتم تنفيذ هذه الاختبارات من قبل 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
ترجم الى 14 لغة أخرى
وأكثر بكثير, استكشف 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.

Routing

📖 Routing

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

يخدم static files

📖 Static

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

📖 Middleware
📖 Next

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

📚 إظهار المزيد من أمثلة التعليمات البرمجية

Views engines

📖 Settings
📖 Engines
📖 Render

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

📖 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

📖 HTTP Methods

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

📖 Websocket

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

🧬 الرسمية Middlewares

والمزيد قابلة للصيانة middleware ecosystem, لقد وضعنا رسمية middlewares في مستودعات منفصلة:

🌱 Third Party Middlewares

هذه قائمة middlewares التي تم إنشاؤها من قبل المجتمع Fiber , الرجاء إنشاءPR إذا كنت تريد أن ترى ذلك!

💬 وسائل الإعلام

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

👍 مساهمة

إذا كنت تريد أن تقول شكرا جزيل و/او دعم التنمية النشطة للـ Fiber:

اضف GitHub نجمة للمشروع.
غرد عن المشروع في تويتر .
اكتب مراجعة أو برنامج تعليمي عن Medium, Dev.to او في موقعك الشخصي.
ساعدنا في ترجمة موقعنا API التوثيق عبر Crowdin
دعم المشروع بالتبرع بـ كوب من القهوة.

☕ الداعمين

Fiber هو مشروع مفتوح المصدر يعمل على التبرعات لدفع الفواتير ، على سبيل المثال اسم النطاق الخاص بنا , gitbook, netlify and serverless الاستضافة. إذا كنت تريد دعم Fiber, تستطيع ☕ شراء كوب قهوة هنا.

	المستخدم	التبرع
	@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

32 KiB Raw Blame History Unescape Escape