أساسيات HTTP

أساسيات HTTP — HTTP Basics

من أعظم نقاط قوة Go أن مكتبتها القياسية تحتوي على خادم HTTP إنتاجي — لا تحتاج Express أو Flask أو أي framework. حزمة net/http وحدها كافية لبناء خوادم تخدم ملايين الطلبات.

ملاحظة مهمة: أمثلة HTTP لا يمكن تشغيلها على Go Playground لأنها تحتاج شبكة. اقرأ الكود وافهمه، ثم جرّبه على جهازك المحلي.

أبسط خادم HTTP

main.go

package main

import (
    "fmt"
    "net/http"
)

func main() {
    // معالج بسيط — Simple handler
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "مرحباً بالعالم! 🌍")
    })

    http.HandleFunc("/salam", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "السلام عليكم ورحمة الله وبركاته")
    })

    fmt.Println("الخادم يعمل على http://localhost:8080")
    // شغّل هذا على جهازك — Run this locally
    // http.ListenAndServe(":8080", nil)
}

Output:

واجهة http.Handler

كل شيء في net/http يدور حول هذه الواجهة:

type Handler interface {
    ServeHTTP(w http.ResponseWriter, r *http.Request)
}

http.HandleFunc هي اختصار مريح، لكن يمكنك تنفيذ الواجهة مباشرة:

main.go

package main

import (
    "fmt"
    "net/http"
)

// معالج مخصص — Custom handler
type GreetHandler struct {
    DefaultName string
}

func (h *GreetHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    name := r.URL.Query().Get("name")
    if name == "" {
        name = h.DefaultName
    }
    fmt.Fprintf(w, "أهلاً يا %s! 👋", name)
}

// عدّاد الزيارات — Visit counter
type CounterHandler struct {
    count int
}

func (h *CounterHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    h.count++
    fmt.Fprintf(w, "عدد الزيارات: %d", h.count)
}

func main() {
    greeter := &GreetHandler{DefaultName: "زائر"}
    counter := &CounterHandler{}

    http.Handle("/greet", greeter)
    http.Handle("/count", counter)

    fmt.Println("الخادم جاهز على :8080")
    fmt.Println("GET /greet?name=أحمد")
    fmt.Println("GET /count")
    // http.ListenAndServe(":8080", nil)
}

Output:

فهم الطلب — http.Request

كائن http.Request يحتوي كل معلومات الطلب:

main.go

package main

import (
    "fmt"
    "net/http"
    "strings"
)

func inspectHandler(w http.ResponseWriter, r *http.Request) {
    var sb strings.Builder

    sb.WriteString(fmt.Sprintf("الأسلوب: %s\n", r.Method))
    sb.WriteString(fmt.Sprintf("المسار: %s\n", r.URL.Path))
    sb.WriteString(fmt.Sprintf("الاستعلام: %s\n", r.URL.RawQuery))
    sb.WriteString(fmt.Sprintf("المضيف: %s\n", r.Host))
    sb.WriteString(fmt.Sprintf("User-Agent: %s\n", r.UserAgent()))

    // معاملات الاستعلام — Query parameters
    name := r.URL.Query().Get("name")
    if name != "" {
        sb.WriteString(fmt.Sprintf("الاسم: %s\n", name))
    }

    // الترويسات — Headers
    sb.WriteString("\nالترويسات:\n")
    for key, values := range r.Header {
        sb.WriteString(fmt.Sprintf("  %s: %s\n", key, strings.Join(values, ", ")))
    }

    w.Header().Set("Content-Type", "text/plain; charset=utf-8")
    fmt.Fprint(w, sb.String())
}

func main() {
    // مثال على ما تحتويه Request
    fmt.Println("=== معلومات الطلب ===")
    fmt.Println("r.Method     → GET, POST, PUT, DELETE")
    fmt.Println("r.URL.Path   → /api/users/42")
    fmt.Println("r.URL.Query()→ name=ahmed&age=25")
    fmt.Println("r.Header     → ترويسات HTTP")
    fmt.Println("r.Body       → جسم الطلب (io.ReadCloser)")
    fmt.Println("r.FormValue()→ بيانات النموذج")
    fmt.Println("r.Context()  → سياق الطلب (للإلغاء)")
}

Output:

كتابة الاستجابة — http.ResponseWriter

main.go

package main

import (
    "fmt"
    "net/http"
)

func main() {
    // أمثلة على أنواع الاستجابات — Response examples

    // 1. نص عادي — Plain text
    textHandler := func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "text/plain; charset=utf-8")
        w.WriteHeader(http.StatusOK) // 200
        fmt.Fprint(w, "مرحبا")
    }

    // 2. HTML
    htmlHandler := func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "text/html; charset=utf-8")
        fmt.Fprint(w, "<h1 dir='rtl'>أهلاً وسهلاً</h1>")
    }

    // 3. خطأ — Error
    errorHandler := func(w http.ResponseWriter, r *http.Request) {
        http.Error(w, "غير موجود", http.StatusNotFound) // 404
    }

    // 4. إعادة توجيه — Redirect
    redirectHandler := func(w http.ResponseWriter, r *http.Request) {
        http.Redirect(w, r, "/new-page", http.StatusMovedPermanently) // 301
    }

    _ = textHandler
    _ = htmlHandler
    _ = errorHandler
    _ = redirectHandler

    fmt.Println("أنواع الاستجابات:")
    fmt.Println("w.Header().Set()  → ضبط الترويسة")
    fmt.Println("w.WriteHeader(n)  → رمز الحالة")
    fmt.Println("w.Write([]byte)   → كتابة البيانات")
    fmt.Println("fmt.Fprint(w, s)  → كتابة نص")
    fmt.Println("http.Error()      → رسالة خطأ مع رمز")
    fmt.Println("http.Redirect()   → إعادة توجيه")
}

Output:

التوجيه — Routing (Go 1.22+)

منذ Go 1.22، المُوجّه الافتراضي يدعم أنماطاً أقوى:

mux := http.NewServeMux()

// أنماط Go 1.22+ — Go 1.22+ patterns
mux.HandleFunc("GET /api/users", listUsers)        // GET فقط
mux.HandleFunc("POST /api/users", createUser)       // POST فقط
mux.HandleFunc("GET /api/users/{id}", getUser)      // مع متغير في المسار
mux.HandleFunc("DELETE /api/users/{id}", deleteUser)

// قراءة المتغير — Read path variable
func getUser(w http.ResponseWriter, r *http.Request) {
    id := r.PathValue("id")
    // ...
}

ملقم الملفات الثابتة — Static File Server

// خدمة ملفات من مجلد — Serve files from directory
fs := http.FileServer(http.Dir("./static"))
http.Handle("/static/", http.StripPrefix("/static/", fs))

أخطاء شائعة

خطأ 1: كتابة الترويسات بعد الجسم

// ❌ خطأ — الترويسة بعد الكتابة لا تعمل
fmt.Fprint(w, "data")
w.Header().Set("X-Custom", "value") // متأخر جداً!

// ✅ صحيح — الترويسة قبل الكتابة
w.Header().Set("X-Custom", "value")
fmt.Fprint(w, "data")

خطأ 2: نسيان return بعد الخطأ

// ❌ يكمل التنفيذ بعد الخطأ
if err != nil {
    http.Error(w, "خطأ", 500)
    // الكود يستمر!
}

// ✅ أضف return
if err != nil {
    http.Error(w, "خطأ", 500)
    return
}

تحدي — Challenge

package main

import "fmt"

// أنشئ دالة route تُرجع 200 لـ GET /api/users و 404 لأي شيء آخر
func route(method, path string) (status int) {
    // اكتب الكود هنا
    return 404
}

func main() {
    paths := []struct {
        method, path string
    }{
        {"GET", "/api/users"},
        {"GET", "/missing"},
    }

    for _, p := range paths {
        status := route(p.method, p.path)
        fmt.Printf("الأسلوب: %s\nالمسار: %s\nرمز الحالة: %d\n", p.method, p.path, status)
    }
}