গোলং-এ ওয়েব সার্ভারের বিকাশ - সহজ থেকে জটিল পর্যন্ত

পাঁচ বছর আগে শুরু করেছিলাম Gophish বিকাশ, এটি গোলং শেখার সুযোগ করে দিয়েছে। আমি বুঝতে পেরেছি যে গো একটি শক্তিশালী ভাষা, অনেক লাইব্রেরি দ্বারা পরিপূরক। Go বহুমুখী: বিশেষ করে, এটি কোনো সমস্যা ছাড়াই সার্ভার-সাইড অ্যাপ্লিকেশন বিকাশ করতে ব্যবহার করা যেতে পারে।

এই নিবন্ধটি Go-তে একটি সার্ভার লেখার বিষয়ে। আসুন "হ্যালো ওয়ার্ল্ড!" এর মতো সাধারণ জিনিস দিয়ে শুরু করি এবং নিম্নলিখিত ক্ষমতা সহ একটি অ্যাপ্লিকেশন দিয়ে শেষ করি:

- লেটস এনক্রিপ্ট ব্যবহার করে HTTPS এর জন্য।
— এপিআই রাউটার হিসেবে কাজ করা।
- মিডলওয়্যারের সাথে কাজ করা।
- স্ট্যাটিক ফাইলের প্রক্রিয়াকরণ।
- সঠিক শাটডাউন।

Skillbox সুপারিশ করে: ব্যবহারিক কোর্স "শুরু থেকে পাইথন বিকাশকারী".

আমরা মনে করিয়ে দিচ্ছি: "Habr"-এর সকল পাঠকদের জন্য - "Habr" প্রচারমূলক কোড ব্যবহার করে যেকোনো Skillbox কোর্সে নথিভুক্ত করার সময় 10 রুবেল ছাড়।

হ্যালো, বিশ্ব!

আপনি খুব দ্রুত Go এ একটি ওয়েব সার্ভার তৈরি করতে পারেন। এখানে একটি হ্যান্ডলার ব্যবহার করার একটি উদাহরণ যা উপরে প্রতিশ্রুত "হ্যালো, ওয়ার্ল্ড!" ফেরত দেয়।

package main
 
import (
"fmt"
"net/http"
)
 
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello World!")
})
http.ListenAndServe(":80", nil)
}

এর পরে, আপনি যদি অ্যাপ্লিকেশনটি চালান এবং পৃষ্ঠাটি খুলুন স্থানীয় হোস্ট, তারপর আপনি অবিলম্বে পাঠ্য দেখতে পাবেন "হ্যালো, বিশ্ব!" (যদি সবকিছু সঠিকভাবে কাজ করে, অবশ্যই)।

আমরা পরে একাধিকবার হ্যান্ডলারটি ব্যবহার করব, তবে প্রথমে সবকিছু কীভাবে কাজ করে তা বোঝা যাক।

নেট/http

উদাহরণ প্যাকেজ ব্যবহার করা হয়েছে net/http, এটি সার্ভার এবং HTTP ক্লায়েন্ট উভয় বিকাশের জন্য Go-তে প্রাথমিক সরঞ্জাম। কোডটি বোঝার জন্য, আসুন তিনটি গুরুত্বপূর্ণ উপাদানের অর্থ বুঝতে পারি: http.Handler, http.ServeMux এবং http.Server।

HTTP হ্যান্ডলার

যখন আমরা একটি অনুরোধ পাই, হ্যান্ডলার এটি বিশ্লেষণ করে এবং একটি প্রতিক্রিয়া তৈরি করে। Go-তে হ্যান্ডলারগুলি নিম্নরূপ প্রয়োগ করা হয়:

type Handler interface {
        ServeHTTP(ResponseWriter, *Request)
}

প্রথম উদাহরণটি http.HandleFunc সহায়ক ফাংশন ব্যবহার করে। এটি অন্য একটি ফাংশন র‍্যাপ করে, যা ফলস্বরূপ http.ResponseWriter এবং http.Request কে ServeHTTP-এ নেয়।

অন্য কথায়, গোলং-এর হ্যান্ডলারগুলি একটি একক ইন্টারফেসে উপস্থাপিত হয়, যা প্রোগ্রামারকে অনেকগুলি বিকল্প দেয়। সুতরাং, উদাহরণস্বরূপ, মিডলওয়্যার একটি হ্যান্ডলার ব্যবহার করে প্রয়োগ করা হয়, যেখানে ServeHTTP প্রথমে কিছু করে এবং তারপর অন্য হ্যান্ডলারের ServeHTTP পদ্ধতিকে কল করে।

উপরে উল্লিখিত হিসাবে, হ্যান্ডলাররা কেবল অনুরোধের প্রতিক্রিয়া তৈরি করে। কিন্তু নির্দিষ্ট সময়ে কোন নির্দিষ্ট হ্যান্ডলার ব্যবহার করা উচিত?

রাউটিং অনুরোধ করুন

সঠিক পছন্দ করতে, একটি HTTP মাল্টিপ্লেক্সার ব্যবহার করুন। বেশ কয়েকটি লাইব্রেরিতে একে বলা হয় মুক্সার বা রাউটার, কিন্তু এগুলি সব একই জিনিস। মাল্টিপ্লেক্সারের কাজ হল অনুরোধের পথ বিশ্লেষণ করা এবং উপযুক্ত হ্যান্ডলার নির্বাচন করা।

আপনার যদি জটিল রাউটিংয়ের জন্য সমর্থনের প্রয়োজন হয় তবে তৃতীয় পক্ষের লাইব্রেরিগুলি ব্যবহার করা ভাল। সবচেয়ে উন্নত কিছু - গরিলা/মুক্স и go-chi/chi, এই লাইব্রেরি কোনো সমস্যা ছাড়াই মধ্যবর্তী প্রক্রিয়াকরণ বাস্তবায়ন করা সম্ভব করে তোলে। তাদের সাহায্যে, আপনি ওয়াইল্ডকার্ড রাউটিং কনফিগার করতে পারেন এবং অন্যান্য অনেকগুলি কাজ সম্পাদন করতে পারেন। তাদের সুবিধা হল স্ট্যান্ডার্ড HTTP হ্যান্ডলারের সাথে সামঞ্জস্যপূর্ণ। ফলস্বরূপ, আপনি সহজ কোড লিখতে পারেন যা ভবিষ্যতে পরিবর্তন করা যেতে পারে।

একটি স্বাভাবিক পরিস্থিতিতে জটিল কাঠামোর সাথে কাজ করার জন্য অ-মানক সমাধানের প্রয়োজন হবে এবং এটি ডিফল্ট হ্যান্ডলারের ব্যবহারকে উল্লেখযোগ্যভাবে জটিল করে তোলে। বেশিরভাগ অ্যাপ্লিকেশন তৈরি করতে, ডিফল্ট লাইব্রেরি এবং একটি সাধারণ রাউটারের সংমিশ্রণ যথেষ্ট হবে।

ক্যোয়ারী প্রসেসিং

উপরন্তু, আমাদের একটি উপাদান প্রয়োজন যা ইনকামিং সংযোগগুলির জন্য "শুনবে" এবং সঠিক হ্যান্ডলারের কাছে সমস্ত অনুরোধ পুনঃনির্দেশ করবে৷ http.Server সহজেই এই কাজটি পরিচালনা করতে পারে।

নিম্নলিখিত দেখায় যে সার্ভার সংযোগ প্রক্রিয়াকরণের সাথে সম্পর্কিত সমস্ত কাজের জন্য দায়ী। এটি, উদাহরণস্বরূপ, TLS প্রোটোকল ব্যবহার করে কাজ করে। http.ListenAndServer কলটি বাস্তবায়ন করতে, একটি আদর্শ HTTP সার্ভার ব্যবহার করা হয়।

এখন আরও জটিল উদাহরণ দেখা যাক।

যোগ করা যাক এনক্রিপ্ট করা যাক

ডিফল্টরূপে, আমাদের অ্যাপ্লিকেশনটি HTTP প্রোটোকলের উপর চলে, তবে এটি HTTPS প্রোটোকল ব্যবহার করার পরামর্শ দেওয়া হয়। এটি Go এ সমস্যা ছাড়াই করা যেতে পারে। আপনি যদি একটি শংসাপত্র এবং ব্যক্তিগত কী পেয়ে থাকেন তবে সঠিক শংসাপত্র এবং কী ফাইলগুলির সাথে ListenAndServeTLS নিবন্ধন করা যথেষ্ট।

http.ListenAndServeTLS(":443", "cert.pem", "key.pem", nil)

আপনি সবসময় ভাল করতে পারেন.

এর এনক্রিপ্ট যাক স্বয়ংক্রিয় পুনর্নবীকরণ সহ বিনামূল্যে শংসাপত্র প্রদান করে। পরিষেবাটি ব্যবহার করার জন্য, আপনার একটি প্যাকেজ প্রয়োজন autocert.

এটি কনফিগার করার সবচেয়ে সহজ উপায় হল autocert.NewListener পদ্ধতিটি http.Serve-এর সাথে একত্রে ব্যবহার করা। HTTP সার্ভার অনুরোধগুলি প্রক্রিয়া করার সময় পদ্ধতিটি আপনাকে TLS শংসাপত্রগুলি প্রাপ্ত এবং আপডেট করার অনুমতি দেয়:

http.Serve(autocert.NewListener("example.com"), nil)

আমরা যদি ব্রাউজারে ওপেন করি example.com, আমরা একটি HTTPS প্রতিক্রিয়া পাব "হ্যালো, বিশ্ব!"

আপনার যদি আরও বিস্তারিত কনফিগারেশনের প্রয়োজন হয়, তাহলে আপনাকে autocert.Manager ম্যানেজার ব্যবহার করতে হবে। তারপরে আমরা আমাদের নিজস্ব http.Server উদাহরণ তৈরি করি (এখন পর্যন্ত আমরা এটি ডিফল্টরূপে ব্যবহার করি) এবং ম্যানেজারটিকে TLSConfig সার্ভারে যুক্ত করি:

m := &autocert.Manager{
Cache:      autocert.DirCache("golang-autocert"),
Prompt:     autocert.AcceptTOS,
HostPolicy: autocert.HostWhitelist("example.org", "www.example.org"),
}
server := &http.Server{
    Addr:      ":443",
    TLSConfig: m.TLSConfig(),
}
server.ListenAndServeTLS("", "")

স্বয়ংক্রিয় শংসাপত্র পুনর্নবীকরণ সহ সম্পূর্ণ HTTPS সমর্থন বাস্তবায়নের এটি একটি সহজ উপায়।

কাস্টম রুট যোগ করা হচ্ছে

স্ট্যান্ডার্ড লাইব্রেরিতে অন্তর্ভুক্ত ডিফল্ট রাউটারটি ভাল, তবে এটি খুব মৌলিক। বেশিরভাগ অ্যাপ্লিকেশনের জন্য নেস্টেড এবং ওয়াইল্ডকার্ড রুট সহ আরও জটিল রাউটিং প্রয়োজন, বা পাথ প্যাটার্ন এবং প্যারামিটার সেট করার জন্য একটি পদ্ধতি।

এই ক্ষেত্রে এটি প্যাকেজ ব্যবহার মূল্য গরিলা/মুক্স и go-chi/chi. আমরা পরেরটির সাথে কীভাবে কাজ করব তা শিখব - একটি উদাহরণ নীচে দেখানো হয়েছে।

আমাদের API এর জন্য রুট ধারণকারী ফাইল api/v1/api.go দেওয়া হল:

/ HelloResponse is the JSON representation for a customized message
type HelloResponse struct {
Message string `json:"message"`
}
 
// HelloName returns a personalized JSON message
func HelloName(w http.ResponseWriter, r *http.Request) {
name := chi.URLParam(r, "name")
response := HelloResponse{
Message: fmt.Sprintf("Hello %s!", name),
}
jsonResponse(w, response, http.StatusOK)
}
 
// NewRouter returns an HTTP handler that implements the routes for the API
func NewRouter() http.Handler {
r := chi.NewRouter()
r.Get("/{name}", HelloName)
return r
}

আমরা মূল ফাইলে রুটের জন্য api/vq উপসর্গ সেট করি।

তারপরে আমরা এটিকে আমাদের মূল অ্যাপ্লিকেশনটিতে api/v1/ উপসর্গের অধীনে আমাদের প্রধান রাউটারে মাউন্ট করতে পারি:

// NewRouter returns a new HTTP handler that implements the main server routes
func NewRouter() http.Handler {
router := chi.NewRouter()
    router.Mount("/api/v1/", v1.NewRouter())
    return router
}
http.Serve(autocert.NewListener("example.com"), NewRouter())

জটিল রুটের সাথে কাজ করার সহজতা বড়, জটিল অ্যাপ্লিকেশনগুলির গঠন এবং রক্ষণাবেক্ষণকে সহজ করে তোলে।

মিডলওয়্যারের সাথে কাজ করা

স্টেজিং এর সাথে একটি HTTP হ্যান্ডলারকে অন্যটির সাথে মোড়ানো জড়িত, এটি দ্রুত প্রমাণীকরণ, কম্প্রেশন, লগিং এবং অন্যান্য বেশ কয়েকটি ফাংশন সম্পাদন করা সম্ভব করে তোলে।

একটি উদাহরণ হিসাবে, আসুন http.Handler ইন্টারফেসটি দেখি; আমরা এটি ব্যবহার করব একটি হ্যান্ডলার লিখতে যা পরিষেবা ব্যবহারকারীদের প্রমাণীকরণ করে।

func RequireAuthentication(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if !isAuthenticated(r) {
            http.Redirect(w, r, "/login", http.StatusTemporaryRedirect)
            return
        }
        // Assuming authentication passed, run the original handler
        next.ServeHTTP(w, r)
    })
}

থার্ড পার্টি রাউটার আছে, যেমন chi, যা আপনাকে মিডলওয়্যার কার্যকারিতা প্রসারিত করতে দেয়।

স্ট্যাটিক ফাইলের সাথে কাজ করা

Go স্ট্যান্ডার্ড লাইব্রেরিতে ছবি, জাভাস্ক্রিপ্ট এবং CSS ফাইল সহ স্ট্যাটিক কন্টেন্টের সাথে কাজ করার ক্ষমতা রয়েছে। এগুলি http.FileServer ফাংশনের মাধ্যমে অ্যাক্সেস করা যেতে পারে। এটি একটি হ্যান্ডলার প্রদান করে যা একটি নির্দিষ্ট ডিরেক্টরি থেকে ফাইল পরিবেশন করে।

func NewRouter() http.Handler {
    router := chi.NewRouter()
    r.Get("/{name}", HelloName)
 
// Настройка раздачи статических файлов
staticPath, _ := filepath.Abs("../../static/")
fs := http.FileServer(http.Dir(staticPath))
    router.Handle("/*", fs)
    
    return r

এটা অবশ্যই মনে রাখা উচিত যে http.Dir ডিরেক্টরির বিষয়বস্তু প্রদর্শন করে যদি এতে প্রধান index.html ফাইল না থাকে। এই ক্ষেত্রে, ডিরেক্টরিকে আপোস করা থেকে আটকাতে, আপনার প্যাকেজটি ব্যবহার করা উচিত unindexed.

সঠিক শাটডাউন

গো-তে HTTP সার্ভারের গ্রেসফুল শাটডাউন নামে একটি বৈশিষ্ট্য রয়েছে। এটি Shutdown() পদ্ধতি ব্যবহার করে করা যেতে পারে। সার্ভার একটি গোরুটিনে শুরু হয়, এবং তারপর চ্যানেলটি একটি বাধা সংকেত পাওয়ার জন্য শোনা হয়। সংকেত পাওয়ার সাথে সাথে সার্ভারটি বন্ধ হয়ে যায়, তবে অবিলম্বে নয়, কয়েক সেকেন্ড পরে।

handler := server.NewRouter()
srv := &http.Server{
    Handler: handler,
}
 
go func() {
srv.Serve(autocert.NewListener(domains...))
}()
 
// Wait for an interrupt
c := make(chan os.Signal, 1)
signal.Notify(c, os.Interrupt)
<-c
 
// Attempt a graceful shutdown
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
srv.Shutdown(ctx)

একটি উপসংহার হিসাবে

প্রায় সর্বজনীন স্ট্যান্ডার্ড লাইব্রেরি সহ Go একটি শক্তিশালী ভাষা। এর ডিফল্ট ক্ষমতাগুলি খুব প্রশস্ত, এবং সেগুলিকে ইন্টারফেস ব্যবহার করে উন্নত করা যেতে পারে - এটি আপনাকে সত্যিকারের নির্ভরযোগ্য HTTP সার্ভারগুলি বিকাশ করতে দেয়৷

Skillbox সুপারিশ করে:

• দুই বছরের ব্যবহারিক কোর্স "আমি একজন প্রো ওয়েব ডেভেলপার".
• শিক্ষাগত অনলাইন কোর্স "পেশা জাভা বিকাশকারী".
• ব্যবহারিক বছরের কোর্স "0 থেকে PRO পর্যন্ত পিএইচপি বিকাশকারী".

উত্স: www.habr.com