🧚 🧑🏾‍🤝‍🧑🏼 😧 चरवाहे वेब सर्वर 🙇🏾 🚉 🤞🏽

नमस्ते!
इस ट्यूटोरियल में, मैं उन लोगों को दिखाने की योजना बनाता हूं जो काउबॉय वेब सर्वर से परिचित नहीं हैं कि इसका उपयोग कैसे किया जाए। उनके साथ काम करने का अनुभव रखने वाले लोगों के लिए, यह ट्यूटोरियल दिलचस्प होने की संभावना नहीं है, लेकिन उन लोगों के लिए जो केवल चरवाहा के बारे में सुन-सुनकर स्वागत करते हैं!

हम क्या करेंगे:

सर्वर की सबसे सरल स्थापना और शुरुआत
रूटिंग, स्टैटिक्स रखरखाव का अवलोकन
ErlyDTL के साथ पैटर्निंग (Erlang के लिए Django टेम्पलेट भाषा)

सुविधा के लिए, हमें rebar की आवश्यकता है, एक साधारण स्थापना:

> git clone git://github.com/basho/rebar.git && cd rebar && ./bootstrap

अब rebar निष्पादन योग्य फ़ाइल हमारी निर्देशिका में दिखाई दी है - $ PATH में कहीं इसे कॉपी (या बेहतर लिंक)। उदाहरण के लिए:

 > sudo ln -s `pwd`/rebar /usr/bin/rebar

और यहाँ हम चले!

सर्वर की सबसे सरल स्थापना और शुरुआत

सबसे पहले, हमारे भविष्य के आवेदन के लिए एक निर्देशिका और कंकाल बनाएं, rebar इससे हमें मदद मिलेगी। हम कहीं जाते हैं जहां हम एप्लिकेशन बनाएंगे और निम्नलिखित कमांड निष्पादित करेंगे:

 > mkdir webserver && cd webserver && rebar create-app appid=webserver

rebar create-app appid=webserver एक साधारण rebar create-app appid=webserver का कंकाल बनाता है और अब हमारी वेबसर्वर निर्देशिका इस तरह rebar create-app appid=webserver चाहिए:

अगली चीज जो हम करेंगे, वह काउबॉय, सिंक, माइमेटिप्स और एर्लीडल पर निर्भरता है। काउबॉय हमारा वेब सर्वर है, सिंक एक उपयोगिता है जो हमें प्रत्येक परिवर्तन के साथ हमारे सर्वर को फिर से शुरू नहीं करने की अनुमति देगा और अपडेट के दौरान खुद को बदले हुए मॉड्यूल को फिर से जोड़ देगा, Mimetypes यह निर्धारित करने के लिए एक पुस्तकालय है कि क्या एक्सटेंशन mimetype से मेल खाता है (उपयोगी जब हम स्टैटिक्स पर काम कर रहे हैं), और Erlydtl - एक टेम्पलेट इंजन। Rebar.config नामक rebar के लिए एक कॉन्फ़िगरेशन फ़ाइल बनाएँ:

Rebar.config सामग्री

 {deps, [ {cowboy, ".*", {git, "https://github.com/extend/cowboy.git", {branch, "master"}}}, {sync, ".*", {git, "git://github.com/rustyio/sync.git", {branch, "master"}}}, {mimetypes, ".*", {git, "git://github.com/spawngrid/mimetypes.git", {branch, "master"}}}, {erlydtl, ".*", {git, "git://github.com/evanmiller/erlydtl.git", {branch, "master"}}} ]}.

चलिए src / webserver.erl फ़ाइल बनाते हैं, जिसके साथ हम अभी अपना सर्वर शुरू और बंद करेंगे:

Src / webserver.erl सामग्री

 -module(webserver). %% API -export([ start/0, stop/0 ]). -define(APPS, [crypto, ranch, cowboy, webserver]). %% =================================================================== %% API functions %% =================================================================== start() -> ok = ensure_started(?APPS), ok = sync:go(). stop() -> sync:stop(), ok = stop_apps(lists:reverse(?APPS)). %% =================================================================== %% Internal functions %% =================================================================== ensure_started([]) -> ok; ensure_started([App | Apps]) -> case application:start(App) of ok -> ensure_started(Apps); {error, {already_started, App}} -> ensure_started(Apps) end. stop_apps([]) -> ok; stop_apps([App | Apps]) -> application:stop(App), stop_apps(Apps).

अब, वेबसर्वर को कॉल करना: स्टार्ट () क्रिप्टो, रैंच, काउबॉय, वेबसर्वर और ऑटो-अपडेट एप्लिकेशन को बदले में सिंक का उपयोग करके शुरू करेगा, और वेबसर्वर: स्टॉप रिवर्स ऑर्डर में चलने वाली हर चीज को रोक देगा।
झरना तैयार है, यह काउबॉय पर जाने का समय है। Webserver_app.erl खोलें और प्रारंभ / 2 फ़ंक्शन को संपादित करें:

कामकाज webserver_app: प्रारंभ / 2

 start(_StartType, _StartArgs) -> Dispatch = cowboy_router:compile([ {'_', [ {"/", index_handler, []}, {'_', notfound_handler, []} ]} ]), Port = 8008, {ok, _} = cowboy:start_http(http_listener, 100, [{port, Port}], [{env, [{dispatch, Dispatch}]}] ), webserver_sup:start_link().

प्रेषण नियमों में, हमने संकेत दिया कि हम "/" को छोड़कर सभी अनुरोधों को पूरा करेंगे जो कि notfound_handler (हम 404 त्रुटियां देंगे) का उपयोग करके सर्वर पर आएंगे, और हम index_handler का उपयोग करके "/" अनुरोधों को संसाधित करेंगे। तो यह उन्हें बनाने के लायक है:

Src / index_handler.erl सामग्री

 -module(index_handler). -behaviour(cowboy_http_handler). %% Cowboy_http_handler callbacks -export([ init/3, handle/2, terminate/3 ]). init({tcp, http}, Req, _Opts) -> {ok, Req, undefined_state}. handle(Req, State) -> Body = <<"<h1>It works!</h1>">>, {ok, Req2} = cowboy_req:reply(200, [], Body, Req), {ok, Req2, State}. terminate(_Reason, _Req, _State) -> ok.

Src / notfound_handler.erl सामग्री

 -module(notfound_handler). -behaviour(cowboy_http_handler). %% Cowboy_http_handler callbacks -export([ init/3, handle/2, terminate/3 ]). init({tcp, http}, Req, _Opts) -> {ok, Req, undefined_state}. handle(Req, State) -> Body = <<"<h1>404 Page Not Found</h1>">>, {ok, Req2} = cowboy_req:reply(404, [], Body, Req), {ok, Req2, State}. terminate(_Reason, _Req, _State) -> ok.

यह सब है - हमने एक साधारण वेब सर्वर बनाया है जो लोकलहोस्ट के लिए अनुरोधों को संभाल सकता है: 8008 और लोकलहोस्ट : 8008 / व्हाटएवर। अब यह वेब सर्वर को संकलित करने और शुरू करने के लिए बना हुआ है:

 > rebar get-deps > rebar compile > erl -pa ebin deps/*/ebin -s webserver

rebar get-deps कॉन्फ़िगरेशन से निर्भरता को खींचता है, rebar compile कोड को rebar compile erl -pa ebin deps/*/ebin -s webserver , और erl -pa ebin deps/*/ebin -s webserver स्वयं सर्वर को शुरू करता है। वैसे, उपरोक्त कार्यों के निष्पादन को आसान बनाने के लिए एक सरल मेकफाइल बनाने का समय है:

मेकफाइल सामग्री

 REBAR = `जो rebar` है

 सभी: deps संकलन

 deps:
	 @ ($ (REBAR) get-deps)

 संकलन: स्वच्छ
	 @ ($ (REBAR) संकलन)

 साफ:
	 @ ($ (REBAR) स्वच्छ)

 चलाएँ:
	 @ (erl -pa ebin deps / * / ebin -s webserver)

 .PHONY: सभी डिप्स स्वच्छ रन संकलन करते हैं

अब आप प्रोजेक्ट को एक कॉल के साथ संकलित कर सकते हैं, और एक make run कॉल के साथ शुरू कर make run
सर्वर शुरू होने के बाद, आप पहले लोकलहोस्ट : 8008, और फिर लोकलहोस्ट पर जा सकते हैं: 8008 / जो भी हो और सुनिश्चित करें कि सर्वर अपेक्षित रूप से काम करता है, पहला अनुरोध करने पर "यह काम करता है" और दूसरा "404 पृष्ठ नहीं मिला"।

रूटिंग, स्टैटिक्स रखरखाव का अवलोकन

काउबॉय में रूटिंग यह कहने के लिए नहीं है कि यह सबसे सुविधाजनक है, लेकिन काफी सहन करने योग्य है - मुख्य मापदंडों जैसे URL को पास करना और इन मापदंडों को मान्य करना उपलब्ध हैं। अब तक, प्रेषण नियमों में हमारे पास केवल दो मार्ग हैं:

 {"/", index_handler, []}, {'_', notfound_handler, []}

जो दूसरे के अंदर स्थित है, यह निर्धारित करते हुए कि हम किस मेजबान के लिए नेस्टेड का उपयोग करेंगे। आप इसके बारे में और सामान्य रूप से यहां पढ़ सकते हैं: github.com/extend/cowboy/blob/master/guide/rout.md और यहां मैं केवल यह स्पष्ट करूंगा कि परमाणु '_' का अर्थ है कि मार्ग बिल्कुल सभी पते के लिए अनुरोधों से मेल खाएगा , notfound_handler मॉड्यूल का नाम है जो अनुरोधों को संसाधित करेगा, और [] ext की सूची है। पैरामीटर मॉड्यूल को पारित कर दिया
हम निजी / css निजी / js, निजी / img उपनिर्देशिकाओं में निजी निर्देशिका में स्टेटिक्स को संग्रहीत करेंगे और हम इसे निम्नलिखित नियमों के अनुसार मिलान करेंगे:

 /css/WHATEVER -> /priv/css/WHATEVER /js/WHATEVER -> /priv/js/WHATEVER /img/WHATEVER -> priv/img/WHATEVER

ऐसा करने के लिए, क्रमशः 3 मार्ग जोड़ें:

 Dispatch = cowboy_router:compile([ {'_', [ {"/css/[...]", cowboy_static, [ {directory, {priv_dir, webserver, [<<"css">>]}}, {mimetypes, {fun mimetypes:path_to_mimes/2, default}} ]}, {"/js/[...]", cowboy_static, [ {directory, {priv_dir, webserver, [<<"js">>]}}, {mimetypes, {fun mimetypes:path_to_mimes/2, default}} ]}, {"/img/[...]", cowboy_static, [ {directory, {priv_dir, webserver, [<<"img">>]}}, {mimetypes, {fun mimetypes:path_to_mimes/2, default}} ]}, {"/", index_handler, []}, {'_', notfound_handler, []} ]} ]).

mimetypes: path_to_mimes / 2 फ़ंक्शन फ़ाइल एक्सटेंशन द्वारा सही mimetype को वापस करने के लिए जिम्मेदार है।
यह देखना आसान है कि पिछले 3 रूट लगभग पूरी तरह से मामूली अपवादों के साथ एक दूसरे की नकल करते हैं, चलो स्थैतिक मार्ग की पीढ़ी को एक फ़ंक्शन में डालते हैं और इसके साथ मार्गों को प्रतिस्थापित करते हैं:

 Static = fun(Filetype) -> {lists:append(["/", Filetype, "/[...]"]), cowboy_static, [ {directory, {priv_dir, webserver, [list_to_binary(Filetype)]}}, {mimetypes, {fun mimetypes:path_to_mimes/2, default}} ]} end, Dispatch = cowboy_router:compile([ {'_', [ Static("css"), Static("js"), Static("img"), {"/", index_handler, []}, {'_', notfound_handler, []} ]} ]).

अब, नए प्रेषण नियमों को प्रभावी करने के लिए, हमें सर्वर को पुनरारंभ करने या चरवाहे फ़ंक्शन का उपयोग करने की आवश्यकता है: set_v / 3
पहला एक अप्रमाणिक है, और आपको रूटिंग नियमों में सभी के लिए सर्वर को पुनरारंभ करने के साथ सताया जाता है, इसलिए हम अपनी वेबसर्वर फ़ाइल में रूटिंग को अपडेट करने के लिए एक फ़ंक्शन जोड़ेंगे ताकि वेबसर्वर: update_rout () कंसोल में बुलाया जा सके। और इसलिए कि वेबसर्वर: update_rout / 0 फ़ंक्शन नए मार्गों के बारे में जानता है, हम एक अलग फ़ंक्शन में उनकी परिभाषा निकालते हैं। परिणामस्वरूप, webserver_app.erl फ़ाइल निम्न रूप लेगी:

Src / webserver_app.erl सामग्री

 -module(webserver_app). -behaviour(application). %% Application callbacks -export([ start/2, stop/1 ]). %% API -export([dispatch_rules/0]). %% =================================================================== %% API functions %% =================================================================== dispatch_rules() -> Static = fun(Filetype) -> {lists:append(["/", Filetype, "/[...]"]), cowboy_static, [ {directory, {priv_dir, webserver, [list_to_binary(Filetype)]}}, {mimetypes, {fun mimetypes:path_to_mimes/2, default}} ]} end, cowboy_router:compile([ {'_', [ Static("css"), Static("js"), Static("img"), {"/", index_handler, []}, {'_', notfound_handler, []} ]} ]). %% =================================================================== %% Application callbacks %% =================================================================== start(_StartType, _StartArgs) -> Dispatch = dispatch_rules(), Port = 8008, {ok, _} = cowboy:start_http(http_listener, 100, [{port, Port}], [{env, [{dispatch, Dispatch}]}] ), webserver_sup:start_link(). stop(_State) -> ok.

अब web_verver.erl मॉड्यूल में update_rout फ़ंक्शन जोड़ें:

वेबसर्वर फ़ंक्शन: update_routes / 0

 update_routes() -> Routes = webserver_app:dispatch_rules(), cowboy:set_env(http_listener, dispatch, Routes).

और फ़ंक्शन को -export () विशेषता में जोड़ना न भूलें, जिसके बाद यह इस तरह दिखेगा:

 %% API -export([ start/0, stop/0, update_routes/0 ]).

कंसोल में webserver:update_routes(). चलाएं webserver:update_routes(). स्टैटिक्स के लिए निर्देशिका बनाएं

 > mkdir priv && cd priv && mkdir css js img

और वहां कुछ उपयुक्त फाइलें डालें, जिसके बाद आप जांच सकते हैं कि उन्हें उम्मीद के मुताबिक, लोकलहोस्ट को दिया जा रहा है: 8008 / पथ / फाइल

ErlyDTL के साथ पैटर्निंग (Erlang के लिए Django टेम्पलेट भाषा)

इलंग के लिए कुख्यात शिकागो बॉस वेब फ्रेमवर्क के लेखक इवान मिलर ने एर्लांग के लिए Django टेम्प्लेट लैंग्वेज (https://docs.djangoproject.com/en/dev/topics/templates/) को चित्रित किया और यह स्पष्ट रूप से, बहुत अच्छा है। वास्तव में, यह इस टेम्पलेट इंजन है कि मैं आपके भविष्य की परियोजनाओं में उपयोग के लिए सिफारिश करूंगा - मैंने अभी तक कोई बेहतर विकल्प नहीं देखा है।
एक नई निर्देशिका वेबसर्वर / tpl बनाएँ और वहाँ तीन टेम्प्लेट सहेजें:

Tpl / layout.dtl सामग्री

 <!DOCTYPE html> <html> <head> <title>Webserver</title> </head> <body> {% block content %}{% endblock %} </body> </html>

Tpl / index.dtl सामग्री

 {% extends "layout.dtl" %} {% block content %} <h1>Hello, {{ username | default : "stranger" }}!</h1> {% endblock %}

Tpl / 404.dtl सामग्री

 {% extends "layout.dtl" %} {% block content %} <h1>URL <span style="color:red;">{{ url }}</span> does not exists.</h1> {% endblock %}

टेम्प्लेट का उपयोग करने के लिए, आपको उन्हें संकलित करने की आवश्यकता है। यह erlydtl का उपयोग करके किया जाता है: संकलन / 3 इस प्रकार है:

 ok = erlydtl:compile("tpl/layout.dtl", "layout_tpl", []), ok = erlydtl:compile("tpl/index.dtl", "index_tpl", []), ok = erlydtl:compile("tpl/404.dtl", "404_tpl", []).

अंतिम तर्क टेम्पलेट को संकलित करने के लिए विकल्पों की एक सूची है, जिसे आप यहां और अधिक पढ़ सकते हैं: github.com/evanmiller/erlydtl
प्रत्येक बार आपके द्वारा परिवर्तित किए जाने वाले सभी टेम्प्लेटों को मैन्युअल रूप से संकलित नहीं करने के लिए, हम वेबसर्वर मॉड्यूल में फ़ंक्शंस बनाएंगे जो फिर से शुरू होंगे:

टेम्पलेट्स को फिर से जमा करने के लिए कार्य

 c_tpl() -> c_tpl([]). c_tpl(Opts) -> c_tpl(filelib:wildcard("tpl/*.dtl"), Opts). c_tpl([], _Opts) -> ok; c_tpl([File | Files], Opts) -> ok = erlydtl:compile(File, re:replace(filename:basename(File), ".dtl", "_tpl", [global, {return, list}]), Opts), c_tpl(Files, Opts).

और उन्हें निर्यात करें:

 %% API -export([ start/0, stop/0, update_routes/0, c_tpl/0, c_tpl/1, c_tpl/2 ]).

c_tpl / 0 बिना विकल्प के tpl निर्देशिका से सभी टेम्पलेट्स को फिर से जोड़ देगा, c_tpl / 1 दिए गए विकल्पों के साथ ऐसा ही करेगा, और c_tpl / 2 दिए गए विकल्पों के साथ दिए गए फ़ाइलों को फिर से जोड़ देगा। आइए webserver:c_tpl(). को चलाकर सभी टेम्पलेट्स को संकलित करें webserver:c_tpl(). Erlang के कंसोल में webserver:c_tpl().
हम अपने rebar.config को भी अपडेट करेंगे ताकि जब इसे संकलित किया जाए तो यह भी टेम्पलेट संकलित करें ( उदाहरण के लिए धन्यवाद):

नवीनीकृत rebar.config

 {plugins,[rebar_erlydtl_compiler]}. {deps, [ {cowboy, ".*", {git, "https://github.com/extend/cowboy.git", {branch, "master"}}}, {sync, ".*", {git, "git://github.com/rustyio/sync.git", {branch, "master"}}}, {mimetypes, ".*", {git, "git://github.com/spawngrid/mimetypes.git", {branch, "master"}}}, {erlydtl, ".*", {git, "git://github.com/evanmiller/erlydtl.git", {branch, "master"}}} ]}. {erlydtl_opts,[ {compiler_options, [debug_info]}, [ {doc_root, "tpl"}, {out_dir, "ebin"}, {source_ext, ".dtl"}, {module_ext, "_tpl"} ] ]}.

दुर्भाग्य से, मेरे लिए यह आसान काम नहीं था कि वे सरल तरीकों से टेम्प्लेट में परिवर्तन पकड़ सकें, मैं इसके कोड को थोड़ा बाद में देखूंगा, इसलिए मैंने अभी भी मॉड्यूल में पुनर्मूल्यांकन के लिए कार्य छोड़ दिया है।

अब हम अपने हैंडलर को संपादित करते हैं ताकि वे संकलित टेम्पलेट्स को वापस दें, और टेम्प्लेट के लिए आवश्यक चर भी स्थानांतरित करें:

Src / index_handler.erl सामग्री

 -module(index_handler). -behaviour(cowboy_http_handler). %% Cowboy_http_handler callbacks -export([ init/3, handle/2, terminate/3 ]). init({tcp, http}, Req, _Opts) -> {ok, Req, undefined_state}. handle(Req, State) -> {Username, Req2} = cowboy_req:qs_val(<<"username">>, Req, "stranger"), {ok, HTML} = index_tpl:render([{username, Username}]), {ok, Req3} = cowboy_req:reply(200, [], HTML, Req2), {ok, Req3, State}. terminate(_Reason, _Req, _State) -> ok.

Src / notfound_handler.erl सामग्री

 -module(notfound_handler). -behaviour(cowboy_http_handler). %% Cowboy_http_handler callbacks -export([ init/3, handle/2, terminate/3 ]). init({tcp, http}, Req, _Opts) -> {ok, Req, undefined_state}. handle(Req, State) -> {URL, Req2} = cowboy_req:url(Req), {ok, HTML} = '404_tpl':render([{url, URL}]), {ok, Req3} = cowboy_req:reply(404, [], HTML, Req2), {ok, Req3, State}. terminate(_Reason, _Req, _State) -> ok.

वह, वास्तव में, सब है। ओपन लोकलहोस्ट : 8008 /? उपयोगकर्ता नाम = दुनिया या लोकलहोस्ट : 8008 / qweqweasdasd और खुशी है कि सब कुछ ठीक वैसा ही काम करता है जैसा हम उम्मीद करते हैं।

पूर्ण परियोजना कोड यहां पाया जा सकता है: github.com/chvanikoff/webserver

यह मेरी कहानी को समाप्त करता है, और अगले लेख में मैं आज हमारे लिखित आवेदन में बहुभाषी समर्थन को जोड़ने के बारे में बात करूंगा। प्रश्न, टिप्पणियाँ, टिप्पणियों का स्वागत है;)

चरवाहे वेब सर्वर

सर्वर की सबसे सरल स्थापना और शुरुआत

रूटिंग, स्टैटिक्स रखरखाव का अवलोकन

ErlyDTL के साथ पैटर्निंग (Erlang के लिए Django टेम्पलेट भाषा)

More articles: