在 Elixir 裡要怎麼架設 HTTP 伺服器呢？

在 NodeJS 架設 HTTP 伺服器

如果是在 NodeJS 底下，我們可以很快透過以下的程式碼建立簡單的伺服器：

const http = require('http');
​
function serverHandler(req, res){
  switch (req.url){
    case '/':{
      res.writeHead(200, {'Content-Type':'text/html'});
      res.write('Hello world');
      res.end();
      break;
    }
      
    default:{
      res.writeHead(404, {'Content-Type':'text/html'});
      res.end('Not found');
      break;
    }
  }
}
​
const server = http.createServer(serverHandler);
server.listen(3001);

但通常我們在 NodeJS 裡面不會這樣直接呼叫 http.createServer 來建立伺服器，我們會利用一些 Web 框架來幫助我們，讓開發上更加便利，例如 express，例如上述程式碼可以改成：

const server = require('express')();
​
server.get('/', function (req, res) {
  res.send('Hello World')
});
​
server.listen(3000);

在 Elixir 中架設伺服器

所以一樣的，在 Elixir 中，我們透過一套名為 plug 的中間層套件，協助我們架設伺服器。

首先我們先建立一個乾淨的專案，並且啟用 supervision 模式：

$ mix new http_server --sup

讓我們看一下資料夾結構：

.
├── README.md
├── lib
│   ├── http_server
│   │   └── application.ex
│   └── http_server.ex
├── mix.exs
└── test
    ├── http_server_test.exs
    └── test_helper.exs

安裝 plug

首先我們需要先安裝 plug。在 Elixir 安裝套件很簡單。

先讓我們打開資料夾中的 mix.exs 檔案，他內容會長這樣：

defmodule HttpServer.MixProject do
  use Mix.Project
​
  def project do
    [
      app: :http_server,
      version: "0.1.0",
      elixir: "~> 1.9",
      start_permanent: Mix.env() == :prod,
      deps: deps()
    ]
  end
​
  # Run "mix help compile.app" to learn about applications.
  def application do
    [
      extra_applications: [:logger],
      mod: {HttpServer.Application, []}
    ]
  end
​
  # Run "mix help deps" to learn about dependencies.
  defp deps do
    [
      # {:dep_from_hexpm, "~> 0.3.0"},
      # {:dep_from_git, git: "https://github.com/elixir-lang/my_dep.git", tag: "0.1.0"}
    ]
  end
end

然後讓我們看到 defp deps do 這段函式區塊：

# Run "mix help deps" to learn about dependencies.
defp deps do
  [
    # {:dep_from_hexpm, "~> 0.3.0"},
    # {:dep_from_git, git: "https://github.com/elixir-lang/my_dep.git", tag: "0.1.0"}
  ]
end

我們在他的 [] 的陣列裡加入 {:plug_cowboy, "~> 2.0"}，這時候應該會長這個樣子：

# Run "mix help deps" to learn about dependencies.
defp deps do
  [
    {:plug_cowboy, "~> 2.0"}
  ]
end

首頁顯示 Hello World

安裝完後，我們在 lib 資料夾底下，建立一個檔案名為 router.ex，然後裡面寫入：

defmodule Router do
  import Plug.Conn
​
  def init(options) do
    options
  end
​
  def call(conn, _opts) do
    conn
    |> put_resp_content_type("text/plain")
    |> send_resp(200, "Hello world")
  end
end

讓伺服器隨同程式上線

再來，我們必須讓伺服器隨著程式啟用時上線。所以我們要來更改 lib/http_server/application.ex 檔案。他應該會長這樣：

defmodule HttpServer.Application do
  # See https://hexdocs.pm/elixir/Application.html
  # for more information on OTP Applications
  @moduledoc false
​
  use Application
​
  def start(_type, _args) do
    children = [
      # Starts a worker by calling: HttpServer.Worker.start_link(arg)
      # {HttpServer.Worker, arg}
    ]
​
    # See https://hexdocs.pm/elixir/Supervisor.html
    # for other strategies and supported options
    opts = [strategy: :one_for_one, name: HttpServer.Supervisor]
    Supervisor.start_link(children, opts)
  end
end

我們在 start 函式中的 children 陣列加入一行：

{Plug.Cowboy, scheme: :http, plug: Router, options: [port: 4001]}

他就變成：

children = [
  {Plug.Cowboy, scheme: :http, plug: Router, options: [port: 4001]}
]

執行程式

程式碼都修改好後，我們在終端機打上：

$ mix run --no-halt

如果沒有東西話記得先切到 http_server 底下：

$ cd http_server

最後打開瀏覽器，輸入 http://localhost:4001，就大功告成啦！

參考文獻

• https://github.com/elixir-plug/plug
• https://elixirschool.com/zh-hant/lessons/specifics/plug/