在Go程序中中嵌入Caddy

英文原文：https://github.com/mholt/caddy/wiki/Extending-Caddy

加入Caddy交流论坛和其他开发者一起分享。

你可以用Caddy作为你Go应用程序的库。如果你的Go应用程序需要的不仅仅是Go的基本静态文件服务器或反向代理，那么这一点非常有用。当你需要重新加载程序时，你甚至可以利用Caddy优雅的重启功能。

如果你只需要caddy包，链接的godoc有相关指令。

注意：如果你不想创建原始的Caddyfile字符串，可以使用Caddyfile包将字符串转化为通过JSON表示的标识。它结构简单，很容易使用代码操作，而不需要解析原始字符串。

下面是一个简单的例子：

  1. caddy.AppName = "Sprocket"
  2. caddy.AppVersion = "1.2.3"
  4. // 传入这个Caddyfile的服务类型名称（比如"http"）
  5. caddyfile, err := caddy.LoadCaddyfile(serverType)
  6. if err != nil {
  7.     log.Fatal(err)
  8. }
  10. instance, err := caddy.Start(caddyfile)
  11. if err != nil {
  12.     log.Fatal(err)
  13. }
  15. // Start() 在服务启动完毕前处于阻塞状态
  16. // Wait() 在服务停止前处于阻塞状态
  17. instance.Wait()

你也能重启Caddy：

  1. // 在Linux系统，能使用平滑重启
  2. // 要使用同一个Caddyfile，只需要传入nil
  3. // 请务必使用新实例替换掉旧的！
  4. instance, err = instance.Restart(newCaddyfile)
  5. if err != nil {
  6.     log.Fatal(err)
  7. }

或者停止它：

  1. err = instance.Stop()
  2. if err != nil {
  3.     log.Fatal(err)
  4. }

下面是另外一个例子，用来为你的应用从当前目录载入Caddyfile：

  1. package main
  3. import (
  4.     "io/ioutil"
  5.     "log"
  6.     "os"
  8.     "github.com/mholt/caddy"
  9.     _ "github.com/mholt/caddy/caddyhttp"
  10. )
  12. func init() {
  13.     // 配置默认caddyfile
  14.     caddy.SetDefaultCaddyfileLoader("default", caddy.LoaderFunc(defaultLoader))
  15. }
  17. func main() {
  18.     caddy.AppName = "Sprocketplus"
  19.     caddy.AppVersion = "1.2.3"
  21.     // 载入caddyfile
  22.     caddyfile, err := caddy.LoadCaddyfile("http")
  23.     if err != nil {
  24.         log.Fatal(err)
  25.     }
  27.     // 启动caddy服务
  28.     instance, err := caddy.Start(caddyfile)
  29.     if err != nil {
  30.         log.Fatal(err)
  31.     }
  33.     instance.Wait()
  34. }
  36. // 提供载入功能
  37. func defaultLoader(serverType string) (caddy.Input, error) {
  38.     contents, err := ioutil.ReadFile(caddy.DefaultConfigFile)
  39.     if err != nil {
  40.         if os.IsNotExist(err) {
  41.             return nil, nil
  42.         }
  43.         return nil, err
  44.     }
  45.     return caddy.CaddyfileInput{
  46.         Contents:       contents,
  47.         Filepath:       caddy.DefaultConfigFile,
  48.         ServerTypeName: serverType,
  49.     }, nil
  50. }

请务必参考godoc获取caddy包的最新内容。好运！