我的书签
添加书签
移除书签app.conf
概述
app.conf 是Revel程序的配置文件，它使用 goconfig 语法，类似微软的 INI 文件。
下面是个例子:
app.name=chatapp.secret=pJLzyoiDe17L36mytqC912j81PfTiolHm1veQK6Grn1En3YFdB5lvEHVTwFEaWvjhttp.addr=http.port=9000[dev]results.pretty=truewatch=truelog.trace.output = offlog.info.output = stderrlog.warn.output = stderrlog.error.output = stderr[prod]results.pretty=falsewatch=falselog.trace.output = offlog.info.output = offlog.warn.output = %(app.name)s.loglog.error.output = %(app.name)s.log
每个段是一种 运行模式。最上面的 key (不在任何段内)对所有的运行模式有效。这使得默认值在所有模式中适用，并且根据需要被重写。[prod] 段仅用于 生产 模式。
新建的Revel程序中默认定义了 dev 和 prod 模式, 你也可以自定义你需要的段。 程序启动时，根据 (命令行工具)“revel run” 提供的参数来选择运行模式。
自定义属性
开发者可以自定义key，并通过 revel.Config 变量 访问它们。这里公开了一些简单的 api。
内建属性
应用程序设置
app.name
应用程序名称，用于控制台输出和开发web页。
例如:
app.name = Booking example application
默认值: 无值
app.secret
密钥用于密码操作 (revel.Sign)。Revel 在内部使用它签署session cookies。设置为空将禁用签名。
使用 revel new新建项目时，它被设置为一个随机的字符串。
例如:
app.secret = pJLzyoiDe17L36mytqC912j81PfTiolHm1veQK6Grn1En3YFdB5lvEHVTwFEaWvj
默认值: 无值
HTTP settings
http.port
监听端口
例如:
http.port = 9000
http.addr
监听ip地址
Linux中, 空字符串代表通配符 – Windows中, 空字符串被转换为 "localhost"
默认值: ””
harness.port
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
http.ssl
如果为真, Revel Web服务器将自行配置为接受SSL连接。这需要一个 X509 证书和一个 key 文件。
默认值: false
http.sslcert
指定 X509 证书文件的路径
默认值: ””
http.sslkey
指定 X509 证书 key的路径
默认值: ””
响应结果
results.chunked
确定模板渲染时是否使用 分块编码。分块编码可以减少发送到客户端的第一个字节的时间（在整个模板已经完全呈现数据之前）。
默认值: false
results.pretty
配置 RenderXml 和 RenderJson 生成缩进格式的 XML/JSON. 例如:
results.pretty = true
默认值: false
国际化 (i18n)
i18n.default_language
为消息翻译指定默认的语言，如果客户端请求的语言环境未确认。如果不指定，则返回一个虚拟的信息。
例如:
i18n.default_language = en
默认值: ””
i18n.cookie
指定存储用户语言环境的cookie名称
默认值: “%(cookie.prefix)_LANG” (参考 cookie.prefix)
监视
Revel 监视项目改动，并支持几种类型文件的热重载。启用监视:
watch = true
如果为假, 禁用监视, 并忽略其他相关的监视配置 watch.* (适用于生产环境)
默认值: true
watch.templates
如果为真, Revel 监视模板变化，必要时重新加载他们。
默认值: true
watch.routes
如果为真, Revel 监视 routes 文件的变化，必要时重新加载。
默认值: true
watch.code
如果为真, Revel 监视Go代码改动，必要时重新编译代码(作为反向代理运行)。
app/ 目录(包括子目录)下的代码都被监视。
默认值: true
Cookies
Revel 组件默认使用下面的 cookies:
- REVEL_SESSION
- REVEL_LANG
- REVEL_FLASH
- REVEL_ERRORS
cookie.prefix
Revel 使用这个属性作为 Revel-produced cookies前缀。这样可以在同一台主机上运行多个REVEL应用程序。
例如,
cookie.prefix = MY
则对应的 cookie 名称如下:
- MY_SESSION
- MY_LANG
- MY_FLASH
- MY_ERRORS
默认值: “REVEL”
Session
session.expires
Revel 使用这个属性设置session cookie的有效期。 Revel 使用 ParseDuration 解析字符串，默认值是 30 天。也可以设置为会话结束时过期。 请注意，客户端的行为依赖于浏览器的设置，所以结果并不总是保证。
模板
template.delimiters
指定模板左右分隔符必须这样指定分隔符 “左分隔符 右分隔符”
默认值: “{{ }}”
格式化
format.date
指定默认的日期格式，Revel在两个地方使用它:
format.datetime
指定默认的日期时间格式，Revel在两个地方使用它:
数据库
db.import
指定DB模块的 database/sql 驱动程序导入路径。
默认值: ””
db.driver
指定 database/sql 驱动程序名称 (在sql.Open中使用).
默认值: ””
db.spec
指定 database/sql 数据源名称 (在 sql.Open中使用).
默认值: ””
构建
build.tags
Build tags 构建程序的时候使用。
默认值: ””
日志
TODO
缓存
cache 模块是一个简单的堆或分布式缓存接口
cache.expires
设置缓存过期时间。在程序中调用者使用常量cache.DEFAULT获取。
它是接受一个time.ParseDuration 字符串。
(目前还不能指定默认值为 FOREVER)
默认值: “1h” (1 小时)
cache.memcached
如果为真, 缓存模块使用 memcached 来代替内存缓存。
默认值: false
cache.hosts
一个逗号分隔的 memcached 主机列表。缓存条目使用确定的主机名缓存key自动分片到可用的主机中。主机可能会多次列出，以增加共享的缓存空间。
默认值: ””
计划任务
计划任务 模块允许你运行计划任务或者临时任务
时间表
时间表可以通过key来配置。
cron.schedulename = @hourly
时间表的计划时间可以在执行器中提交任务时使用。例如:
- jobs.Schedule("cron.schedulename", job)
jobs.pool
允许同时允许的任务数量。例如:
jobs.pool = 4
如果为 0, 则没有数量限制
默认值: 10
jobs.selfconcurrent
如果为真, 允许一个任务运行，即使是该任务的实例仍在进行中。
默认值: false
模块
模块 通过指定导入路径将模块添加到应用程序中。例如：
module.testrunner = github.com/revel/revel/modules/testrunner
开发计划
- 允许使用命令行参数配置值或以其他方式在命令行中指定值。
