Go 每日一庫之 godotenv

時間  2020-02-13
標籤 每日 godotenv 简体版
原文   原文鏈接

簡介

twelve-factor應用提倡將配置存儲在環境變量中。任何從開發環境切換到生產環境時須要修改的東西都從代碼抽取到環境變量裏。
可是在實際開發中，若是同一臺機器運行多個項目，設置環境變量容易衝突，不實用。godotenv庫從.env文件中讀取配置，
而後存儲到程序的環境變量中。在代碼中可使用讀取很是方便。godotenv源於一個 Ruby 的開源項目dotenv。mysql

快速使用

第三方庫須要先安裝：git

$ go get github.com/joho/godotenv

後使用：程序員

package main

import (
  "fmt"
  "log"
  "os"

  "github.com/joho/godotenv"
)

func main() {
  err := godotenv.Load()
  if err != nil {
    log.Fatal(err)
  }

  fmt.Println("name: ", os.Getenv("name"))
  fmt.Println("age: ", os.Getenv("age"))
}

而後在可執行程序相同目錄下，添加一個.env文件：github

name = dj
age = 18

運行程序，輸出：golang

name:  dj
age:  18

可見，使用很是方便。默認狀況下，godotenv讀取項目根目錄下的.env文件，文件中使用key = value的格式，每行一個鍵值對。
調用godotenv.Load()便可加載，可直接調用os.Getenv("key")讀取。os.Getenv是用來讀取環境變量的：web

package main

import (
  "fmt"
  "os"
)

func main() {
  fmt.Println(os.Getenv("GOPATH"))
}

高級特性

自動加載

若是你有程序員的優良傳統——懶，你可能連Load方法都不想本身調用。不要緊，godotenv給你懶的權力！sql

導入github.com/joho/godotenv/autoload，配置會自動讀取：segmentfault

package main

import (
  "fmt"
  "os"

  _ "github.com/joho/godotenv/autoload"
)

func main() {
  fmt.Println("name: ", os.Getenv("name"))
  fmt.Println("age: ", os.Getenv("age"))
}

注意，因爲代碼中沒有顯式用到godotenv庫，須要使用空導入，即導入時包名前添加一個_。微信

看autoload包的源碼，其實就是庫幫你調用了Load方法：網絡

// src/github.com/joho/godotenv/autoload/autoload.go
package autoload

/*
    You can just read the .env file on import just by doing

        import _ "github.com/joho/godotenv/autoload"

    And bob's your mother's brother
*/

import "github.com/joho/godotenv"

func init() {
  godotenv.Load()
}

仔細看註釋，程序員的惡趣味😂！

加載自定義文件

默認狀況下，加載的是項目根目錄下的.env文件。固然咱們能夠加載任意名稱的文件，文件也沒必要以.env爲後綴：

package main

import (
  "fmt"
  "log"
  "os"

  "github.com/joho/godotenv"
)

func main() {
  err := godotenv.Load("common", "dev.env")
  if err != nil {
    log.Fatal(err)
  }

  fmt.Println("name: ", os.Getenv("name"))
  fmt.Println("version: ", os.Getenv("version"))
  fmt.Println("database: ", os.Getenv("database"))
}

common文件內容：

name = awesome web
version = 0.0.1

dev.env：

database = sqlite

production.env：

database = mysql

本身運行看看結果吧！

注意：Load接收多個文件名做爲參數，若是不傳入文件名，默認讀取.env文件的內容。
若是多個文件中存在同一個鍵，那麼先出現的優先，後出現的不生效。因此，上面輸出的database是什麼？

註釋

.env文件中能夠添加註釋，註釋以#開始，直到該行結束。

# app name
name = awesome web
# current version
version = 0.0.1

YAML

.env文件還可使用 YAML 格式：

name: awesome web
version: 0.0.1
package main

import (
  "fmt"
  "os"

  _ "github.com/joho/godotenv/autoload"
)

func main() {
  fmt.Println("name: ", os.Getenv("name"))
  fmt.Println("version: ", os.Getenv("version"))
}

不存入環境變量

godotenv容許不將.env文件內容存入環境變量，使用godotenv.Read()返回一個map[string]string，可直接使用：

package main

import (
  "fmt"
  "log"

  "github.com/joho/godotenv"
)

func main() {
  var myEnv map[string]string
  myEnv, err := godotenv.Read()
  if err != nil {
    log.Fatal(err)
  }

  fmt.Println("name: ", myEnv["name"])
  fmt.Println("version: ", myEnv["version"])
}

直接操做map，簡單直接！

數據源

除了讀取文件，還能夠從io.Reader，從string中讀取配置：

package main

import (
  "fmt"
  "log"

  "github.com/joho/godotenv"
)

func main() {
  content := `
name: awesome web
version: 0.0.1
  `
  myEnv, err := godotenv.Unmarshal(content)
  if err != nil {
    log.Fatal(err)
  }

  fmt.Println("name: ", myEnv["name"])
  fmt.Println("version: ", myEnv["version"])
}

只要實現了io.Reader接口，就能做爲數據源。能夠從文件（os.File），網絡（net.Conn），bytes.Buffer等多種來源讀取：

package main

import (
    "bytes"
    "fmt"
    "log"
    "os"

    "github.com/joho/godotenv"
)

func main() {
  file, _ := os.OpenFile(".env", os.O_RDONLY, 0666)
  myEnv, err := godotenv.Parse(file)
  if err != nil {
    log.Fatal(err)
  }

  fmt.Println("name: ", myEnv["name"])
  fmt.Println("version: ", myEnv["version"])

  buf := &bytes.Buffer{}
  buf.WriteString("name: awesome web @buffer")
  buf.Write([]byte{'\n'})
  buf.WriteString("version: 0.0.1")
  myEnv, err = godotenv.Parse(buf)
  if err != nil {
    log.Fatal(err)
  }

  fmt.Println("name: ", myEnv["name"])
  fmt.Println("version: ", myEnv["version"])
}

注意，從字符串讀取和從io.Reader讀取使用的方法是不一樣的。前者爲Unmarshal，後者是Parse。

生成.env文件

能夠經過程序生成一個.env文件的內容，能夠直接寫入到文件中：

package main

import (
  "bytes"
  "log"

  "github.com/joho/godotenv"
)

func main() {
  buf := &bytes.Buffer{}
  buf.WriteString("name = awesome web")
  buf.WriteByte('\n')
  buf.WriteString("version = 0.0.1")

  env, err := godotenv.Parse(buf)
  if err != nil {
    log.Fatal(err)
  }

  err = godotenv.Write(env, "./.env")
  if err != nil {
    log.Fatal(err)
  }
}

查看生成的.env文件：

name="awesome web"
version="0.0.1"

還能夠返回一個字符串，怎麼揉捏隨你：

package main

import (
  "bytes"
  "fmt"
  "log"

  "github.com/joho/godotenv"
)

func main() {
  buf := &bytes.Buffer{}
  buf.WriteString("name = awesome web")
  buf.WriteByte('\n')
  buf.WriteString("version = 0.0.1")

  env, err := godotenv.Parse(buf)
  if err != nil {
    log.Fatal(err)
  }

  content, err := godotenv.Marshal(env)
  if err != nil {
    log.Fatal(err)
  }
  fmt.Println(content)
}

命令行模式

godotenv還提供了一個命令行的模式：

$ godotenv -f ./.env command args

前面在go get安裝godotenv時，godotenv就已經安裝在$GOPATH/bin目錄下了，我習慣把$GOPATH/bin加入系統PATH，因此godotenv命令能夠直接使用。

命令行模式就是讀取指定文件（若是不經過-f指定，則使用.env文件），設置環境變量，而後運行後面的程序。

咱們簡單寫一個程序驗證一下：

package main

import (
  "fmt"
  "os"
)

func main() {
  fmt.Println(os.Getenv("name"))
  fmt.Println(os.Getenv("version"))
}

使用godotenv運行一下：

$ godotenv -f ./.env go run main.go

輸出：

awesome web
0.0.1

多個環境

實踐中，通常會根據APP_ENV環境變量的值加載不一樣的文件：

package main

import (
    "fmt"
    "log"
    "os"

    "github.com/joho/godotenv"
)

func main() {
    env := os.Getenv("GODAILYLIB_ENV")
    if env == "" {
        env = "development"
    }

    err := godotenv.Load(".env." + env)
    if err != nil {
        log.Fatal(err)
    }

    err = godotenv.Load()
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println("name: ", os.Getenv("name"))
    fmt.Println("version: ", os.Getenv("version"))
    fmt.Println("database: ", os.Getenv("database"))
}

咱們先讀取環境變量GODAILYLIB_ENV，而後讀取對應的.env. + env，最後讀取默認的.env文件。

前面也提到過，先讀取到的優先。咱們能夠在默認的.env文件中配置基礎信息和一些默認的值，
若是在開發/測試/生產環境須要修改，那麼在對應的.env.development/.env.test/.env.production文件中再配置一次便可。

.env文件內容：

name = awesome web
version = 0.0.1
database = file

.env.development：

database = sqlite3

.env.production：

database = mysql

運行程序：

# 默認是開發環境
$ go run main.go
name:  awesome web
version:  0.0.1
database:  sqlite3

# 設置爲生成環境
$ GODAILYLIB_ENV=production go run main.go
name:  awesome web
version:  0.0.1
database:  mysql

一點源碼

godotenv讀取文件內容，爲何可使用os.Getenv訪問：

// src/github.com/joho/godotenv/godotenv.go
func loadFile(filename string, overload bool) error {
    envMap, err := readFile(filename)
    if err != nil {
        return err
    }

    currentEnv := map[string]bool{}
    rawEnv := os.Environ()
    for _, rawEnvLine := range rawEnv {
        key := strings.Split(rawEnvLine, "=")[0]
        currentEnv[key] = true
    }

    for key, value := range envMap {
        if !currentEnv[key] || overload {
            os.Setenv(key, value)
        }
    }

    return nil
}

由於godotenv調用os.Setenv將鍵值對設置到環境變量中了。

總結

本文介紹了godotenv庫的基礎和高級用法。godotenv的源碼也比較好讀，有時間，有興趣的童鞋建議一看~

參考

  1. godotenv GitHub 倉庫：https://github.com/joho/godotenv

我

個人博客

歡迎關注個人微信公衆號【GoUpUp】，共同窗習，一塊兒進步~

本文由博客一文多發平臺 OpenWrite 發佈！
相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程