Cowboy 框架快速入门教程

1. 项目目录结构及介绍

在 https://github.com/extend/cowboy.git 中，Cowboy 是一个轻量级的、高性能的 Erlang Web 服务器。其典型的目录结构如下：

├── doc                # 文档目录
├── ebin                # 编译后的 beam 文件
├── examples            # 示例应用
│   ├── hello           # 基础 Hello World 示例
│   └── ...             # 其他示例
├── include             # 头文件
├── src                 # 源代码目录
│   ├── cowboy.erl      # 主体模块
│   └── ...             # 其他源码
└── test                # 测试目录
    ├── cowboy_test.erl  # 测试用例
    └── ...              # 其他测试文件

• doc: 包含 API 参考和其他 Markdown 格式的文档。
• ebin: 存放编译后的 Erlang 模块（.beam 文件）。
• examples: 提供多个示例应用以帮助用户了解如何使用 Cowboy。
• include: 定义库的头文件（.hrl）。
• src: 源代码存放处，主要的 Cowboy 功能在此实现。
• test: 测试代码，用于验证框架功能。

2. 项目的启动文件介绍

Cowboy 的启动通常涉及到以下步骤：

1. 在 src 目录中找到你的应用程序模块，如 myapp_app.erl。

2. 在该模块中定义 start/2 函数，它接受两个参数 (Type, Args)，并启动 Cowboy 的监听器。例如：

   -module(myapp_app).
   
   -behaviour(application).
   
   %% Application callbacks
   -export([start/2, stop/1]).
   
   start(normal, []) ->
       Dispatch = cowboy_router:compile([
           {'_', [
               {"/", cowboy_handler, [{handler, myapp_handler}]},
               ...
           ]}
       ]),
       
       cowboy:start_http(myapp_http, 100, [{port, 8080}], [
           {env, [{dispatch, Dispatch}]}
       ]),
       ok;
   
   stop(_State) ->
       ok.
   

   这个例子中，start/2 函数启动了一个 HTTP 服务器，监听端口 8080 并且配置了路由。

3. 确保你的应用在 sys.config 或者 app.src 中正确配置，并可以被 Erlang 的 application 行为启动。

3. 项目的配置文件介绍

Cowboy 的配置可以通过在应用程序启动时传递参数来完成，或者在 sys.config 文件中进行。这里是一个简单的配置例子：

[
  {myapp, [
    {http_options, [
      {port, 8080}, 
      {bindings, [{host, "localhost"}]},
      {max_connections, 100}
    ]},
    {middleware, [
      cowboy_router,
      cowboy_handler
    ]}
  ]}
].

这个配置中的 http_options 关键字表示 HTTP 服务器的选项，包括端口、绑定的主机和最大连接数。middleware 配置定义了中间件，这里是 cowboy_router 和 cowboy_handler。

要加载 sys.config 文件，在启动应用时使用以下命令：

erl -pa ebin -boot start_sasl -config config/sys.config

请注意，实际配置可能因具体需求而异，以上仅为基本示例。查阅官方文档获取更详细的配置选项和用法说明。