beego 目前支持 INI、XML、JSON、YAML 格式的配置文件解析，但是默認采用了 INI 格式解析，用戶可以通過簡單的配置就可以獲得很大的靈活性。 ### 默認配置解析 通過這個文件你可以初始化很多 beego 的默認參數： ~~~ appname = beepkg httpaddr = "127.0.0.1" httpport = 9090 runmode ="dev" autorender = false recoverpanic = false viewspath = "myview" ~~~ 這里的配置是通過`beego.BConfig`生效的，所以，你可以直接將配置寫入到`beego.BConfig` 你也可以在配置文件中配置應用需要用的一些配置信息，例如下面所示的數據庫信息： ~~~ mysqluser = "root" mysqlpass = "rootpass" mysqlurls = "127.0.0.1" mysqldb ? = "beego" ~~~ 那么你就可以通過如下的方式獲取設置的配置信息: ~~~ beego.AppConfig.String("mysqluser") beego.AppConfig.String("mysqlpass") beego.AppConfig.String("mysqlurls") beego.AppConfig.String("mysqldb") ~~~ ### 不同級別的配置 根據不同的運行環境，不同的配置，如開發環境，正式生產線上，配置不同。 在配置文件里面支持 section，可以有不同的 Runmode 的配置，默認優先讀取 runmode 下的配置信息，例如下面的配置文件： ~~~ appname = youdi httpaddr = "localhost" httpport = 8080 runmode ="dev" autorender = false recoverpanic = false viewspath = "myview" ? [dev] httpport = 8080 [prod] httpport = 80 [test] httpport = 8888 ~~~ 上面的配置文件就是在不同的 runmode 下解析不同的配置，例如在 dev 模式下，httpport 是 8080，在 prod 模式下是 80，在 test 模式下是 8888。其他配置文件同理。解析的時候優先解析 runmode 下的配置，然后解析默認的配置。 讀取不同模式下配置參數的方法是“模式::配置參數名”，比如：`beego.AppConfig.String(“dev::mysqluser”)`。 對于自定義的參數，需使用 `beego.GetConfig(tpy, key string, defaultVal interface{})` 來獲取指定 runmode 下的配置（需 1.4.0 以上版本），typ 為參數類型，key 為參數名, defaultVal 為默認值。 ### 多個配置文件 INI 格式配置支持 include 方式，引用多個配置文件，例如下面的兩個配置文件效果同上： app.conf ~~~ appname = beepkg httpaddr = "127.0.0.1" httpport = 9090 ? include "app2.conf" ~~~ app2.conf ~~~ runmode ="dev" autorender = false recoverpanic = false viewspath = "myview" ? [dev] httpport = 8080 [prod] httpport = 8088 [test] httpport = 8888 ~~~ ### 支持環境變量配置 使用環境變量，是非常靈活的一種方式，修改配置方便快捷，對于跨平臺適應性也很好。安全性也很高。值得注意是，機器重啟后，注意變量生效問題。 配置文件解析支持從環境變量中獲取配置項，配置項格式：${環境變量}。例如下面的配置中優先使用環境變量中配置的 runmode 和 httpport,如果有配置環境變量 ProRunMode 則優先使用該環境變量值。如果不存在或者為空，則使用 “dev” 作為 runmode。 app.conf ~~~ runmode ?= "${ProRunMode||dev}" httpport = "${ProPort||9090}" ~~~ 系統默認參數 beego 中帶有很多可配置的參數，我們來一一認識一下它們，這樣有利于我們在接下來的 beego 開發中可以充分的發揮他們的作用(你可以通過在 conf/app.conf 中設置對應的值，不區分大小寫)： ### 基礎配置 * BConfig 保存了所有 beego 里面的系統默認參數，你可以通過 beego.BConfig 來訪問和修改底下的所有配置信息. > 配置文件路徑，默認是應用程序對應的目錄下的 conf/app.conf，用戶可以在程序代碼中加載自己的配置文件 `beego.LoadAppConfig("ini", "conf/app2.conf")` 也可以加載多個文件，只要你調用多次就可以了，如果后面的文件和前面的 key 沖突，那么以最新加載的為最新值 ### 下面給一些具體參數配置 #### App 配置 ##### AppName 應用名稱，默認是 beego。通過 bee new 創建的是創建的項目名。 ~~~ beego.BConfig.AppName = "beego" ~~~ ##### RunMode 應用的運行模式，可選值為 prod, dev 或者 test. 默認是 dev, 為開發模式，在開發模式下出錯會提示友好的出錯頁面，如前面錯誤描述中所述。 ~~~ beego.BConfig.RunMode = "dev" ~~~ ##### RouterCaseSensitive 是否路由忽略大小寫匹配，默認是 true，區分大小寫 ~~~ beego.BConfig.RouterCaseSensitive = true ~~~ ##### ServerName beego 服務器默認在請求的時候輸出 server 為 beego。 ~~~ beego.BConfig.ServerName = "beego" ~~~ ##### RecoverPanic 是否異常恢復，默認值為 true，即當應用出現異常的情況，通過 recover 恢復回來，而不會導致應用異常退出。 ~~~ beego.BConfig.RecoverPanic = true ~~~ ##### CopyRequestBody 是否允許在 HTTP 請求時，返回原始請求體數據字節，默認為 true （GET or HEAD or 上傳文件請求除外）。 ~~~ beego.BConfig.CopyRequestBody = false ~~~ ##### EnableGzip 是否開啟 gzip 支持，默認為 false 不支持 gzip，一旦開啟了 gzip，那么在模板輸出的內容會進行 gzip 或者 zlib 壓縮，根據用戶的 Accept-Encoding 來判斷。 ~~~ beego.BConfig.EnableGzip = false ~~~ Gzip允許用戶自定義壓縮級別、壓縮長度閾值和針對請求類型壓縮: 1. 壓縮級別, gzipCompressLevel = 9,取值為 1~9,如果不設置為 1(最快壓縮) 2. 壓縮長度閾值, gzipMinLength = 256,當原始內容長度大于此閾值時才開啟壓縮,默認為 20B(ngnix默認長度) 3. 請求類型, includedMethods = get;post,針對哪些請求類型進行壓縮,默認只針對 GET 請求壓縮 ##### MaxMemory 文件上傳默認內存緩存大小，默認值是 1 << 26(64M)。 ~~~ beego.BConfig.MaxMemory = 1 << 26 ~~~ ##### EnableErrorsShow 是否顯示系統錯誤信息，默認為 true。 ~~~ beego.BConfig.EnableErrorsShow = true ~~~ ##### EnableErrorsRender 是否將錯誤信息進行渲染，默認值為 true，即出錯會提示友好的出錯頁面，對于 API 類型的應用可能需要將該選項設置為 false 以阻止在 dev 模式下不必要的模板渲染信息返回。 #### Web配置 ##### AutoRender 是否模板自動渲染，默認值為 true，對于 API 類型的應用，應用需要把該選項設置為 false，不需要渲染模板。 ~~~ beego.BConfig.WebConfig.AutoRender = true ~~~ ##### EnableDocs 是否開啟文檔內置功能，默認是 false ~~~ beego.BConfig.WebConfig.EnableDocs = true ~~~ ##### FlashName Flash 數據設置時 Cookie 的名稱，默認是 BEEGO\_FLASH ~~~ beego.BConfig.WebConfig.FlashName = "BEEGO_FLASH" ~~~ ##### FlashSeperator Flash 數據的分隔符，默認是 BEEGOFLASH ~~~ beego.BConfig.WebConfig.FlashSeperator = "BEEGOFLASH" ~~~ ##### DirectoryIndex 是否開啟靜態目錄的列表顯示，默認不顯示目錄，返回 403 錯誤。 ~~~ beego.BConfig.WebConfig.DirectoryIndex = false ~~~ ##### StaticDir 靜態文件目錄設置，默認是static 可配置單個或多個目錄: 單個目錄, StaticDir = download. 相當于 `beego.SetStaticPath("/download","download")` 多個目錄, StaticDir = download:down download2:down2. 相當于 `beego.SetStaticPath("/download","down")` 和 ~~~ beego.SetStaticPath("/download2","down2") beego.BConfig.WebConfig.StaticDir ~~~ ##### StaticExtensionsToGzip 允許哪些后綴名的靜態文件進行 gzip 壓縮，默認支持 .css 和 .js ~~~ beego.BConfig.WebConfig.StaticExtensionsToGzip = []string{".css", ".js"} ~~~ 等價 config 文件中 ~~~ StaticExtensionsToGzip = .css, .js ~~~ ##### TemplateLeft 模板左標簽，默認值是{{。 ~~~ beego.BConfig.WebConfig.TemplateLeft="{{" ~~~ ##### TemplateRight 模板右標簽，默認值是}}。 ~~~ beego.BConfig.WebConfig.TemplateRight="}}" ~~~ ##### ViewsPath 模板路徑，默認值是 views。 ~~~ beego.BConfig.WebConfig.ViewsPath="views" ~~~ ##### EnableXSRF 是否開啟 XSRF，默認為 false，不開啟。 ~~~ beego.BConfig.WebConfig.EnableXSRF = false ~~~ ##### XSRFKEY XSRF 的 key 信息，默認值是 beegoxsrf。 EnableXSRF＝true 才有效 ~~~ beego.BConfig.WebConfig.XSRFKEY = "beegoxsrf" ~~~ ##### XSRFExpire XSRF 過期時間，默認值是 0，不過期。 ~~~ beego.BConfig.WebConfig.XSRFExpire = 0 ~~~ #### 監聽配置 ##### Graceful 是否開啟熱升級，默認是 false，關閉熱升級。 ~~~ beego.BConfig.Listen.Graceful=false ~~~ ##### ServerTimeOut 設置 HTTP 的超時時間，默認是 0，不超時。 ~~~ beego.BConfig.Listen.ServerTimeOut=0 ~~~ ##### ListenTCP4 監聽本地網絡地址類型，默認為 “tcp4”，該值可以是 “tcp”, “tcp4”, “tcp6”, “unix” or “unixpacket” 之一。 ~~~ beego.BConfig.Listen.ListenTCP4 = "tcp4" ~~~ ##### EnableHTTP 是否啟用 HTTP 監聽，默認是 true。 ~~~ beego.BConfig.Listen.EnableHTTP = true ~~~ ##### HTTPAddr 應用監聽地址，默認為空，監聽所有的網卡 IP。 ~~~ beego.BConfig.Listen.HTTPAddr = "" ~~~ ##### HTTPPort 應用監聽端口，默認為 8080。 ~~~ beego.BConfig.Listen.HTTPPort = 8080 ~~~ ##### EnableHTTPS 是否啟用 HTTPS，默認是 false 關閉。當需要啟用時，先設置 EnableHTTPS = true，并設置 HTTPSCertFile 和 HTTPSKeyFile ~~~ beego.BConfig.Listen.EnableHTTPS = false ~~~ ##### HTTPSAddr 應用監聽地址，默認為空，監聽所有的網卡 IP。 ~~~ beego.BConfig.Listen.HTTPSAddr = "" ~~~ ##### HTTPSPort 應用監聽端口，默認為 10443 ~~~ beego.BConfig.Listen.HTTPSPort = 10443 ~~~ ##### HTTPSCertFile 開啟 HTTPS 后，ssl 證書路徑，默認為空。 ~~~ beego.BConfig.Listen.HTTPSCertFile = "conf/ssl.crt" ~~~ ##### HTTPSKeyFile 開啟 HTTPS 之后，SSL 證書 keyfile 的路徑。 ~~~ beego.BConfig.Listen.HTTPSKeyFile = "conf/ssl.key" ~~~ ##### EnableAdmin 是否開啟進程內監控模塊，默認 false 關閉。 ~~~ beego.BConfig.Listen.EnableAdmin = false ~~~ ##### AdminAddr 監控程序監聽的地址，默認值是 localhost 。 ~~~ beego.BConfig.Listen.AdminAddr = "localhost" ~~~ ##### AdminPort 監控程序監聽的地址，默認值是 8088 。 ~~~ beego.BConfig.Listen.AdminPort = 8088 ~~~ ##### EnableFcgi 是否啟用 fastcgi ， 默認是 false。 ~~~ beego.BConfig.Listen.EnableFcgi = false ~~~ ##### EnableStdIo 通過fastcgi 標準I/O，啟用 fastcgi 后才生效，默認 false。 ~~~ beego.BConfig.Listen.EnableStdIo = false ~~~ #### Session配置 ##### SessionOn session 是否開啟，默認是 false。 ~~~ beego.BConfig.WebConfig.Session.SessionOn = false ~~~ ##### SessionProvider session 的引擎，默認是 memory，詳細參見 session 模塊。 ~~~ beego.BConfig.WebConfig.Session.SessionProvider = "" ~~~ ##### SessionName 存在客戶端的 cookie 名稱，默認值是 beegosessionID。 ~~~ beego.BConfig.WebConfig.Session.SessionName = "beegosessionID" ~~~ ##### SessionGCMaxLifetime session 過期時間，默認值是 3600 秒。 ~~~ beego.BConfig.WebConfig.Session.SessionGCMaxLifetime = 3600 ~~~ ##### SessionProviderConfig 配置信息，根據不同的引擎設置不同的配置信息，詳細的配置請看下面的引擎設置，詳細參見 session 模塊 ##### SessionCookieLifeTime session 默認存在客戶端的 cookie 的時間，默認值是 3600 秒。 ~~~ beego.BConfig.WebConfig.Session.SessionCookieLifeTime = 3600 ~~~ ##### SessionAutoSetCookie 是否開啟SetCookie, 默認值 true 開啟。 ~~~ beego.BConfig.WebConfig.Session.SessionAutoSetCookie = true ~~~ ##### SessionDomain session cookie 存儲域名, 默認空。 ~~~ beego.BConfig.WebConfig.Session.SessionDomain = "" ~~~ #### Log配置 ##### AccessLogs 是否輸出日志到 Log，默認在 prod 模式下不會輸出日志，默認為 false 不輸出日志。此參數不支持配置文件配置。 ~~~ beego.BConfig.Log.AccessLogs = false ~~~ ##### FileLineNum 是否在日志里面顯示文件名和輸出日志行號，默認 true。此參數不支持配置文件配置。 ~~~ beego.BConfig.Log.FileLineNum = true ~~~ ##### Outputs 日志輸出配置，參考 logs 模塊，console file 等配置，此參數不支持配置文件配置。 ~~~ beego.BConfig.Log.Outputs = map[string]string{"console": ""} ~~~ or ~~~ beego.BConfig.Log.Outputs["console"] = "" ~~~