官方文档:
http://www.tornadoweb.org/en/stable/web.html#tornado.web.Application.settings
谷歌中文翻译后直接复制的
常规设置:
autoreload
:如果True
,任何源文件更改时服务器进程将重新启动,如调试模式和自动重新加载中所述。此选项是Tornado 3.2中的新选项; 以前此功能由debug
设置控制。debug
:几种调试模式设置的简写,在调试模式和自动重新加载中描述。设置debug=True
相当于autoreload=True
,compiled_template_cache=False
,static_hash_cache=False
,serve_traceback=True
。default_handler_class
anddefault_handler_args
:如果没有找到其他匹配项,将使用此处理程序; 使用它来实现自定义404页面(Tornado 3.2中的新增功能)。compress_response
:如果True
,文本格式的响应将自动压缩。Tornado 4.0的新功能。gzip
:compress_response
自Tornado 4.0以来已弃用的别名。log_function
:此函数将在每个记录结果的请求结束时调用(使用一个参数,即RequestHandler
对象)。默认实现将写入logging
模块的根记录器。也可以通过覆盖来定制Application.log_request
。serve_traceback
:如果True
,默认错误页面将包含错误的回溯。此选项是Tornado 3.2中的新选项; 以前此功能由debug
设置控制。ui_modules
和ui_methods
:可以设置为UIModule
可用于模板的映射或UI方法。可以设置为模块,字典或模块和/或dicts列表。有关详细信息,请参阅UI模块。websocket_ping_interval
:如果设置为数字,则每n秒钟将对所有websockets进行ping操作。这有助于通过关闭空闲连接的某些代理服务器保持连接活动,并且它可以检测websocket是否在未正确关闭的情况下发生故障。websocket_ping_timeout
:如果设置了ping间隔,并且服务器在这么多秒内没有收到“pong”,它将关闭websocket。默认值是ping间隔的三倍,最少30秒。如果未设置ping间隔,则忽略。
身份验证和安全设置:
cookie_secret
:用于RequestHandler.get_secure_cookie
和set_secure_cookie
签署cookie。key_version
:set_secure_cookie
当cookie_secret
是密钥字典时,requestHandler 使用特定密钥对cookie进行签名。login_url
:authenticated
如果用户未登录,装饰器将重定向到此URL。可以通过覆盖进一步自定义RequestHandler.get_login_url
xsrf_cookies
:如果True
,将启用跨站点请求伪造保护。xsrf_cookie_version
:控制此服务器生成的新XSRF cookie的版本。通常应该保留默认值(它始终是支持的最高版本),但可以在版本转换期间临时设置为较低的值。Tornado 3.2.2中的新功能,它引入了XSRF cookie版本2。xsrf_cookie_kwargs
:可以设置为要传递给RequestHandler.set_cookie
XSRF cookie 的其他参数的字典。twitter_consumer_key
,twitter_consumer_secret
,friendfeed_consumer_key
,friendfeed_consumer_secret
,google_consumer_key
,google_consumer_secret
,facebook_api_key
,facebook_secret
:所用的tornado.auth
模块来验证各种API。
模板设置:
autoescape
:控制模板的自动转义。可以设置为None
禁用转义,或者设置 应该传递所有输出的函数的名称。默认为"xhtml_escape"
。可以使用该指令在每个模板的基础上进行更改。{% autoescape %}
compiled_template_cache
:默认是True
; 如果False
每个请求都会重新编译模板。此选项是Tornado 3.2中的新选项; 以前此功能由debug
设置控制。template_path
:包含模板文件的目录。可以通过覆盖进一步定制RequestHandler.get_template_path
template_loader
:分配给tornado.template.BaseLoader
自定义模板加载的实例 。如果使用此 设置,则忽略template_path
和autoescape
设置。可以通过覆盖进一步定制RequestHandler.create_template_loader
。template_whitespace
:控制模板中空格的处理; 查看tornado.template.filter_whitespace
允许的值。Tornado 4.3中的新功能。
静态文件设置:
static_hash_cache
:默认是True
; 如果False
每次请求都会重新计算静态网址。此选项是Tornado 3.2中的新选项; 以前此功能由debug
设置控制。static_path
:将从中提供静态文件的目录。static_url_prefix
:静态文件的Url前缀,默认为"/static/"
。static_handler_class
,static_handler_args
:可以设置为静态文件而不是默认文件使用不同的处理程序tornado.web.StaticFileHandler
。static_handler_args
如果设置,则应该是要传递给处理程序initialize
方法的关键字参数的字典。