fiber/.github/README_ar_SA.md

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

⚙️ تثبيت

قبل كل شي قم , بتحميل و تثبيت Go. 1.11 أو أعلى مطلوب.

بعد الانتهاء من التثبيت استخدم الامر go get :

go get -u github.com/gofiber/fiber

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

يتم تنفيذ هذه الاختبارات من قبل TechEmpower و Go Web. إذا كنت تريد رؤية جميع النتائج ، يرجى زيارة موقعنا Wiki.

🎯 الميزات

• قوي routing
• يقدم خدمة static files
• أقصى أداء
• ذاكرة منخفضة
• API endpoints
• Middleware & Next مدعوم
• سريع server-side programming
• Template engines
• WebSocket دعم
• Rate Limiter
• ترجم الى 12 لغة أخرى
• وأكثر بكثير, استكشف 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)
}

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

Template engines

📖 Settings
📖 Template Engines
📖 Render

Fiber defaults to the Go template engine when no Template engine is set.

If you want to template partials and a different engine like amber, handlebars, mustache or pug etc..

You can use our Template Middleware.

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

func main() {
  // You can setup template engine before initiation app:
  app := fiber.New(&fiber.Settings{
    Templates: pug.New("./views", ".pug"),
  })

  // OR after initiation app at any convenient location:
  app.Settings.Templates = 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)
}

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

📖 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 في مستودعات منفصلة:

• gofiber/compression
• gofiber/basicauth
• gofiber/requestid
• gofiber/websocket
• gofiber/keyauth
• gofiber/rewrite
• gofiber/recover
• gofiber/limiter
• gofiber/session
• gofiber/adaptor
• gofiber/logger
• gofiber/helmet
• gofiber/embed
• gofiber/pprof
• gofiber/cors
• gofiber/csrf
• gofiber/jwt

🌱 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

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

• 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

👍 مساهمة

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

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

☕ الداعمين

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

	المستخدم	التبرع
	@thomasvvugt	☕ x 5
	@ekaputra07	☕ x 5
	@candidosales	☕ x 5
	@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

‎‍💻 المساهمون في كتابة الكود

⚠️ رخصة

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

• FastHTTP
• Schema
• bytebufferpool