app.conf
是Revel程序的配置文件,它使用 goconfig 语法,类似微软的 INI 文件。
下面是个例子:
app.name=chat
app.secret=pJLzyoiDe17L36mytqC912j81PfTiolHm1veQK6Grn1En3YFdB5lvEHVTwFEaWvj
http.addr=
http.port=9000
[dev]
results.pretty=true
watch=true
log.trace.output = off
log.info.output = stderr
log.warn.output = stderr
log.error.output = stderr
[prod]
results.pretty=false
watch=false
log.trace.output = off
log.info.output = off
log.warn.output = %(app.name)s.log
log.error.output = %(app.name)s.log
每个段是一种 运行模式。最上面的 key (不在任何段内)对所有的运行模式有效。这使得默认值在所有模式中适用,并且根据需要被重写。[prod]
段仅用于 生产
模式。
新建的Revel程序中默认定义了 dev 和 prod 模式, 你也可以自定义你需要的段。 程序启动时,根据 (命令行工具)“revel run” 提供的参数来选择运行模式。
开发者可以自定义key,并通过 revel.Config
变量 访问它们。这里公开了一些简单的 api。
应用程序名称,用于控制台输出和开发web页。
例如:
app.name = Booking example application
默认值: 无值
密钥用于密码操作 (revel.Sign
)。Revel 在内部使用它签署session cookies。设置为空将禁用签名。
使用 revel new
新建项目时,它被设置为一个随机的字符串。
例如:
app.secret = pJLzyoiDe17L36mytqC912j81PfTiolHm1veQK6Grn1En3YFdB5lvEHVTwFEaWvj
默认值: 无值
监听端口
例如:
http.port = 9000
监听ip地址
Linux中, 空字符串代表通配符 – Windows中, 空字符串被转换为 "localhost"
默认值: ””
Specifies the port for the application to listen on, when run by the harness. For example, when the harness is running, it will listen on http.port
, run the application on harness.port
, and reverse-proxy requests. Without the harness, the application listens on http.port
directly.
默认情况下,会选择一个随机的空闲端口。这仅仅是必要的,由该程序限制插座访问的环境中运行时设置。By default, a random free port will be chosen. This is only necessary to set when running in an environment that restricts socket access by the program.
Default: 0
如果为真, Revel Web服务器将自行配置为接受SSL连接。这需要一个 X509 证书和一个 key 文件。
默认值: false
指定 X509 证书文件的路径
默认值: ””
指定 X509 证书 key的路径
默认值: ””
确定模板渲染时是否使用 分块编码。分块编码可以减少发送到客户端的第一个字节的时间(在整个模板已经完全呈现数据之前)。
默认值: false
配置 RenderXml
和 RenderJson
生成缩进格式的 XML/JSON. 例如:
results.pretty = true
默认值: false
为消息翻译指定默认的语言,如果客户端请求的语言环境未确认。如果不指定,则返回一个虚拟的信息。
例如:
i18n.default_language = en
默认值: ””
指定存储用户语言环境的cookie名称
默认值: “%(cookie.prefix)_LANG” (参考 cookie.prefix)
Revel 监视项目改动,并支持几种类型文件的热重载。启用监视:
watch = true
如果为假, 禁用监视, 并忽略其他相关的监视配置 watch.*
(适用于生产环境)
默认值: true
如果为真, Revel 监视模板变化,必要时重新加载他们。
默认值: true
如果为真, Revel 监视 routes
文件的变化,必要时重新加载。
默认值: true
如果为真, Revel 监视Go代码改动,必要时重新编译代码(作为反向代理运行)。
app/
目录(包括子目录)下的代码都被监视。
默认值: true
Revel 组件默认使用下面的 cookies:
Revel 使用这个属性作为 Revel-produced cookies前缀。这样可以在同一台主机上运行多个REVEL应用程序。
例如,
cookie.prefix = MY
则对应的 cookie 名称如下:
默认值: “REVEL”
Revel 使用这个属性设置session cookie的有效期。 Revel 使用 ParseDuration 解析字符串,默认值是 30 天。也可以设置为会话结束时过期。 请注意,客户端的行为依赖于浏览器的设置,所以结果并不总是保证。
指定模板左右分隔符
必须这样指定分隔符 “左分隔符 右分隔符”
默认值: “{{ }}”
指定默认的日期格式,Revel在两个地方使用它:
time.Time
(参考 binding)date
模板函数输出日期 (参考 模板函数)默认值: “2006-01-02”
指定默认的日期时间格式,Revel在两个地方使用它:
time.Time
(参考 binding)datetime
模板函数输出日期 (参考 模板函数)默认值: “2006-01-02 15:04”
指定DB模块的 database/sql 驱动程序导入路径。
默认值: ””
指定 database/sql 驱动程序名称 (在sql.Open
中使用).
默认值: ””
指定 database/sql 数据源名称 (在 sql.Open
中使用).
默认值: ””
Build tags 构建程序的时候使用。
默认值: ””
TODO
cache 模块是一个简单的堆或分布式缓存接口
设置缓存过期时间。在程序中调用者使用常量cache.DEFAULT
获取。
它是接受一个time.ParseDuration
字符串。
(目前还不能指定默认值为 FOREVER
)
默认值: “1h” (1 小时)
如果为真, 缓存模块使用 memcached 来代替内存缓存。
默认值: false
一个逗号分隔的 memcached 主机列表。缓存条目使用确定的主机名缓存key自动分片到可用的主机中。主机可能会多次列出,以增加共享的缓存空间。
默认值: ””
计划任务 模块允许你运行计划任务或者临时任务
时间表可以通过key来配置。
cron.schedulename = @hourly
时间表的计划时间可以在执行器中提交任务时使用。例如:
jobs.Schedule("cron.schedulename", job)
允许同时允许的任务数量。例如:
jobs.pool = 4
如果为 0, 则没有数量限制
默认值: 10
如果为真, 允许一个任务运行,即使是该任务的实例仍在进行中。
默认值: false
模块 通过指定导入路径将模块添加到应用程序中。例如:
module.testrunner = github.com/revel/revel/modules/testrunner