erlang用cowboy搭建简单服务器收发http

清风丶Yocky

已于 2024-07-30 09:56:30 修改

阅读量1k

点赞数 7

文章标签：服务器 erlang

于 2024-07-29 18:37:54 首次发布

本文链接：https://blog.csdn.net/DKchaos/article/details/140778026

版权

Cowboy

cowboy指南：Nine Nines: Cowboy User Guide

Cowboy是一个小型、快速和现代化的Erlang/OTP HTTP服务器，这意味着我们可以很方便轻松地通过Cowboy来实现一个http服务器。

rebar和cowboy的教学后续更新

开始教学！

创建项目

准备内容

首先，我们需要准备开发ide（这里用了idea作为开发ide）、Erlang/OTP（这里用的OTP25.3）、rebar3（以及windows环境下会用到的rebar3.cmd）

附上部分内容下载地址：

erlang：Downloads - Erlang/OTP

rebar3：https://github.com/erlang/rebar3/archive/refs/heads/main.zip

rebar3需要依赖于erlang，所以需要先安装erlang并设置环境变量后再跑rebar3，windows情况下双击bootstrap.bat运行后就会在文件夹内生成rebar3和rebar3.cmd了

新建app

将rebar3和rebar3.cmd放到工作目录中，打开cmd在目录里执行rebar3 new app $app_name （这里的$app_name是自己定的，我这边用了cowboy_test，所以后续都用cowboy_test表示app名字），

会发现生成了以自己设定的名字生成的文件夹，里面有一个rebar.config文件和一些其他文件，接下来我们把rebar3和rebar3.cmd移入文件夹内方便后续运行

idea用户可以顺便新建一下工作目录：File -> New -> Project from Existing Source，选择生成的文件夹，会自动勾选Rebar model，点击next后可以设置rebar路径，设置为rebar3所在的路径，之后一路next就可以啦

这时候我们就得到了一个全新的rebar构建的app

rebar配置

因为我们需要用到cowboy，所以我们需要将cowboy加入到依赖项中，共有两个地方需要添加：

rebar.config文件：在{deps, []}.的中括号里加上{cowboy, “2.10.0”}，表示rebar需要下载cowboy依赖，也就是这一行变成：{deps, [{cowboy, “2.10.0”}]}. 后续有新增依赖的时候也是在列表中继续以元组的形式增加依赖

src/cowboy_test.app.src文件：在{applications, [kernel,stdlib]},的后面加上cowboy，表示app内会用到cowboy依赖，也就是这一行变成：{applications, [kernel,stdlib,cowboy]},

配置加好之后，我们需要编译下载添加的依赖：

没有idea：我们在工作目录中打开cmd，运行rebar3 compile，就可以下载依赖

有idea：在Run -> Configurations里新加一个Erlang Rebar命令，command只需要compile，保存之后点击run即可完成编译

如果编译完成之后看到一个cowboy_test/_build文件夹，说明编译完成

cowboy启动

cowboy里最常用到的三个方法：

cowboy_router:compile/1（用于编译访问映射）

cowboy:start_clear/3（用于监听指定端口）

cowboy_req:reply/4（用于发送消息）

在项目启动时会执行cowboy_test_app:start/2，所以我们在这里加一个开启cowboy监听的函数start_cowboy/0

-module(cowboy_test_app).

start(_StartType, _StartArgs) ->
    start_cowboy(),
    cowboy_test_sup:start_link().

start_cowboy() ->
    Dispatch = cowboy_router:compile([
        {'_', [{"/my_cowboy", my_cowboy, []}]}	%% 访问映射，例如这里是http://localhost:26521/mycowboy  访问里面内容
    ]),
    {ok, _} = cowboy:start_clear(cowboy_http_listener,
        [{port, 26521}],						%% 访问端口
        #{env => #{dispatch => Dispatch}}		%% 映射
    ).

在这里我们定义了一个my_cowboy的模块处理/my_cowboy路径下请求的信息，所以我们需要新建一个my_cowboy.erl的模块，并添加一个init/2来处理请求信息：

-module(my_cowboy).
-export([init/2]).

init(Req, State) ->
    Req2 = cowboy_req:reply(200, #{<<"content-type">> => <<"text/plain">>}, <<"Hello Cowboy">>, Req),
    {ok, Req2, State}.

这里的操作就是当http请求当前路径时，返回一个200的http请求码，同时发送一个“Hello Cowboy”字符串

代码写完之后先编译，然后执行rebar3 shell即可在shell里启动应用了，此时打开浏览器访问http://localhost:26521/my_cowboy即可向26521端口发送请求并得到返回。

有idea的情况下可以新加rebar的shell命令，然后在before launch里添加一个Run Another Configuration并选择之前加的compile，即可在运行shell的时候一键编译运行

至此服务器已经可以通过rebar shell运行了，通过上面的coding已经可以作为正常收发的一个服务器底子了，有不同需求可以通过不同路径和对应模块处理并返回，这里不做额外coding

但是一堆代码并不适合移植到别的电脑运行，这时候我们就开始进行版本发布并打包，将运行所需内容全部打包起来：

发布

rebar发布需要在rebar.config设置发布相关配置，如下：

{relx, [{release, {<release name>, "0.0.1"},
         [<app_name>]},

        {release, {<other release name>, "0.1.0"},
         [<app_name>]},

         {dev_mode, false},
         {include_erts, true},
       ]}.

可以通过不同的release name对同一个app设置不同的版本（其中app_name是对应app_name.app.src文件的）

我在项目中使用的配置如下：

{relx, [{release, {cowboy_test, "0.1.0"},
    [cowboy_test]},
    {dev_mode, false},
    {include_erts, true},	% 设置自带erlang运行环境，自带的话包会大一些
    {include_src, false},	% 设置不包含源文件
    {extended_start_script, true}
]
}.

之后运行rebar3 release，会在_build/default下找到一个rel文件夹，这里面的就是发布后的文件，其中运行cmd在bin文件夹内，需要运行发布版本时，可以运行bin目录下的cmd文件。（help可以查看可选参数）

D:\cowboy_test_build\default\rel\cowboy_test\bin> cowboy_test.cmd help
Usage: cowboy_test (install|uninstall|start|stop|restart|upgrade|downgrade|console|ping|list|attach|remote_console|undefined)