【原創】RabbitMQ 之 HTTP server 插件（翻譯）

HTTP server plugin
HTTP 服務器插件

The rabbitmq-mochiweb plugin provides hosting for other plugins that have HTTP interfaces. It allows these interfaces to co-exist on one or more HTTP listeners.
rabbitmq-mochiweb 插件能夠爲其餘擁有 HTTP 接口到插件提供 hosting 功能。容許這些接口並存與一個或者多個 HTTP listener。

Configuration
配置方式

Plugins using rabbit mq-mochiweb typically take a listener configuration item to configure their listening HTTP port. In this page we will give examples for the rabbitmq_management application, but the same configuration can be applied to rabbitmq_jsonrpc and rabbitmq_web_stomp_examples.
使用 rabbitmq-mochiweb 的插件，典型配置爲經過一個 listener 配置條目配置 HTTP 監聽端口。在這裏，咱們將經過 rabbitmq_management 應用做爲示例進行說明，一樣的配置能夠應用到 rabbitmq_jsonrpc 和 rabbitmq_web_stomp 到例子上。

The listener configuration item can contain the following keys:
listener 配置條目能夠包含如下 key 值：

• port (mandatory)
• ip (to listen on only one interface)
• ssl (to enable SSL)
• ssl_opts (to configure SSL)

Listening on a single interface
僅監聽單獨一個接口

Use ip to specify an interface for mochiweb to bind to (giving an IP address as a string or tuple). For example:
能夠使用 ip 來指定 mochiweb 要綁定的接口（以字符串或者元組的形式給出 IP 地址），例如：

[{rabbitmq_management,
  [{listener, [{port, 15672},
               {ip, "127.0.0.1"}
              ]}
  ]}
].

SSL

Set ssl to true to turn on SSL for a listener. Use ssl_opts to specify SSL options. These are the standard Erlang SSL options - see the main page on SSL for more information.
設置 ssl 爲 true 能夠將一個 listener 設置爲支持 SSL 。經過 ssl_opts 能夠指定 SSL 選項。這些選項均爲標準 Erlang SSL 選項 - 詳見 SSL 的 man 頁。

For convenience, if you do not specify ssl_opts then rabbitmq-mochiweb will use the same options as the main RabbitMQ server does for AMQP over SSL, but with client certificate verification turned off. If you wish to use client certificate verification, specify ssl_opts explicitly.
在簡單使用時，若是你沒有設置 ssl_opts，那麼 rabbitmq-mochiweb 將使用和 RabbitMQ 服務器針對 AMQP over SSL 一樣的選項，可是關閉了客戶端證書驗證機制。若是你但願使用客戶端證書驗證機制，能夠顯式設置 ssl_opts 內容。

For example:

[{rabbitmq_management,
  [{listener, [{port,     15672},
               {ssl,      true},
               {ssl_opts, [{cacertfile, "/path/to/cacert.pem"},
                           {certfile,   "/path/to/cert.pem"},
                           {keyfile,    "/path/to/key.pem"}]}
              ]}
  ]}
].