Golang मा वेब सर्भर विकास - सरल देखि जटिल

पाँच वर्षअघि सुरु गरेँ Gophish को विकास, यसले गोलाङ सिक्ने अवसर प्रदान गर्यो। मैले महसुस गरें कि गो एक शक्तिशाली भाषा हो, धेरै पुस्तकालयहरू द्वारा पूरक। गो बहुमुखी छ: विशेष गरी, यो कुनै पनि समस्या बिना सर्भर-साइड अनुप्रयोगहरू विकास गर्न प्रयोग गर्न सकिन्छ।

यो लेख Go मा सर्भर लेख्ने बारे हो। "नमस्ते संसार!" जस्ता साधारण चीजहरूबाट सुरु गरौं र निम्न क्षमताहरू भएको अनुप्रयोगको साथ अन्त्य गरौं:

- HTTPS को लागि एन्क्रिप्ट गरौं प्रयोग गर्दै।
- एपीआई राउटरको रूपमा काम गर्दै।
— Middleware मा काम गर्दै।
- स्थिर फाइलहरूको प्रशोधन।
- सही बन्द।

Skillbox सिफारिस गर्दछ: व्यावहारिक पाठ्यक्रम "स्क्र्याचबाट पाइथन विकासकर्ता".

हामी सम्झाउँछौं: सबै Habr पाठकहरूका लागि - Habr प्रोमो कोड प्रयोग गरी कुनै पनि Skillbox पाठ्यक्रममा भर्ना गर्दा १०,००० रूबल छुट।

नमस्कार संसार!

तपाईं धेरै चाँडै 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 मा लिन्छ।

अर्को शब्दमा, Golang मा ह्यान्डलरहरू एकल इन्टरफेसमा प्रस्तुत हुन्छन्, जसले प्रोग्रामरलाई धेरै विकल्पहरू दिन्छ। त्यसोभए, उदाहरणका लागि, मिडलवेयर ह्यान्डलर प्रयोग गरेर लागू गरिन्छ, जहाँ ServeHTTP ले पहिले केहि गर्छ र त्यसपछि अर्को ह्यान्डलरको ServeHTTP विधिलाई कल गर्दछ।

माथि उल्लेख गरिए अनुसार, ह्यान्डलरहरूले अनुरोधहरूमा प्रतिक्रियाहरू उत्पन्न गर्छन्। तर कुन विशेष ह्यान्डलर समय मा एक विशेष बिन्दु मा प्रयोग गर्नुपर्छ?

रुटिङ अनुरोध गर्नुहोस्

सही छनोट गर्न, HTTP मल्टिप्लेक्सर प्रयोग गर्नुहोस्। धेरै पुस्तकालयहरूमा यसलाई मक्सर वा राउटर भनिन्छ, तर तिनीहरू सबै एउटै कुरा हुन्। मल्टिप्लेक्सरको कार्य अनुरोध मार्गको विश्लेषण गर्नु र उपयुक्त ह्यान्डलर चयन गर्नु हो।

यदि तपाईंलाई जटिल मार्गको लागि समर्थन चाहिन्छ भने, तेस्रो-पक्ष पुस्तकालयहरू प्रयोग गर्नु राम्रो हुन्छ। केहि सबैभन्दा उन्नत - गोरिल्ला/मक्स и go-chi/chi, यी पुस्तकालयहरूले कुनै पनि समस्या बिना मध्यवर्ती प्रक्रिया कार्यान्वयन गर्न सम्भव बनाउँछ। तिनीहरूको मद्दतले, तपाईंले वाइल्डकार्ड राउटिङ कन्फिगर गर्न सक्नुहुन्छ र अन्य धेरै कार्यहरू गर्न सक्नुहुन्छ। तिनीहरूको फाइदा मानक HTTP ह्यान्डलरहरूसँग अनुकूलता हो। नतिजाको रूपमा, तपाईले साधारण कोड लेख्न सक्नुहुन्छ जुन भविष्यमा परिमार्जन गर्न सकिन्छ।

सामान्य अवस्थामा जटिल फ्रेमवर्कहरूसँग काम गर्न गैर-मानक समाधानहरू आवश्यक पर्दछ, र यसले पूर्वनिर्धारित ह्यान्डलरहरूको प्रयोगलाई महत्त्वपूर्ण रूपमा जटिल बनाउँछ। अनुप्रयोगहरूको विशाल बहुमत सिर्जना गर्न, पूर्वनिर्धारित पुस्तकालय र एक साधारण राउटरको संयोजन पर्याप्त हुनेछ।

क्वेरी प्रशोधन

थप रूपमा, हामीलाई आगमन जडानहरूको लागि "सुन्न" र सही ह्यान्डलरमा सबै अनुरोधहरू रिडिरेक्ट गर्ने कम्पोनेन्ट चाहिन्छ। http.Server ले यो कार्य सजिलैसँग ह्यान्डल गर्न सक्छ।

निम्नले देखाउँदछ कि सर्भर सबै कार्यहरूको लागि जिम्मेवार छ जुन जडान प्रशोधनसँग सम्बन्धित छ। यो, उदाहरण को लागी, TLS प्रोटोकल प्रयोग गरेर काम गर्दछ। http.ListenAndServer कल लागू गर्न, मानक HTTP सर्भर प्रयोग गरिन्छ।

अब थप जटिल उदाहरणहरू हेरौं।

Encrypt गरौं थप्दै

पूर्वनिर्धारित रूपमा, हाम्रो अनुप्रयोग HTTP प्रोटोकलमा चल्छ, तर यसलाई HTTPS प्रोटोकल प्रयोग गर्न सिफारिस गरिन्छ। यो Go मा समस्या बिना गर्न सकिन्छ। यदि तपाईंले प्रमाणपत्र र निजी कुञ्जी प्राप्त गर्नुभएको छ भने, त्यसपछि यो सही प्रमाणपत्र र कुञ्जी फाइलहरूसँग ListenAndServeTLS दर्ता गर्न पर्याप्त छ।

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

तपाईं सधैं राम्रो गर्न सक्नुहुन्छ।

गुप्तिकरण गरौं स्वचालित नवीकरण संग नि: शुल्क प्रमाणपत्र प्रदान गर्दछ। सेवा प्रयोग गर्नको लागि, तपाईंलाई प्याकेज चाहिन्छ autocert.

यसलाई कन्फिगर गर्ने सबैभन्दा सजिलो तरिका http.Serve सँग संयोजनमा autocert.NewListener विधि प्रयोग गर्नु हो। विधिले तपाइँलाई TLS प्रमाणपत्रहरू प्राप्त गर्न र अद्यावधिक गर्न अनुमति दिन्छ जब HTTP सर्भरले अनुरोधहरू प्रक्रिया गर्दछ:

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

जटिल मार्गहरूसँग काम गर्ने Go को सहजताले ठूला, जटिल अनुप्रयोगहरूको संरचना र मर्मतसम्भारलाई सरल बनाउन सम्भव बनाउँछ।

मिडलवेयरसँग काम गर्दै

स्टेजिङमा एउटा 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)
    })
}

त्यहाँ तेस्रो पक्ष राउटरहरू छन्, जस्तै ची, जसले तपाईंलाई मिडलवेयर कार्यक्षमता विस्तार गर्न अनुमति दिन्छ।

स्थिर फाइलहरूसँग काम गर्दै

Go मानक पुस्तकालयमा छविहरू, JavaScript र 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.

सही बन्द

Go मा 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 मा PHP विकासकर्ता".

स्रोत: www.habr.com