beego配置

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"] = ""
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,937评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,503评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,712评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,668评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,677评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,601评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,975评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,637评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,881评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,621评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,710评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,387评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,971评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,947评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,189评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,805评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,449评论 2 342

推荐阅读更多精彩内容