设置。yml配置文件
symfony的大多数方面可以通欧宝娱乐app下载地址过一个配置文件配置写在YAML或纯PHP。在本节中,主要为应用程序配置文件,settings.yml
将被描述。
主要的settings.yml
为应用程序配置文件中可以找到应用程序/ APP_NAME / config /
目录中。
正如简介中所讨论的,settings.yml
文件是environment-aware,受益配置级联机制。
每个环境部分有两个小节:.actions
和.settings
。所有配置指令下.settings
小节,除了一些常见的默认行为呈现页面。
请注意
的settings.yml
配置文件缓存PHP文件;这个过程是自动管理的sfDefineEnvironmentConfigHandler
类。
设置
.actions
.settings
的.actions
小节
默认配置:
默认值:.actions: error_404_module:默认error_404_action:那么error404 login_module:默认login_action:登录secure_module:默认secure_action:安全module_disabled_module:默认module_disabled_action:禁用
的.actions
小节定义常见的页面时执行的动作必须呈现。每个定义有两个组件:一个模块(后缀_module
),一个用于操作(后缀_action
)。
error_404
的error_404
动作执行时必须呈现一本404页的。
登录
的登录
动作执行时没有进行身份验证的用户试图访问一个安全页面。
安全
的安全
当用户没有执行行动所需的凭证。
module_disabled
的module_disabled
行动是当用户请求一个禁用模块执行。
的.settings
小节
的.settings
小节是框架配置发生的地方。下面的段落描述所有可能的设置和大致下令的重要性。
中定义的所有设置.settings
部分可以在代码的任何地方使用sfConfig
对象和前缀设置sf_
。例如,得到的值字符集
设置,使用:
sfConfig::得到(“sf_charset”);
escaping_strategy
默认的:真正的
的escaping_strategy
设置一个布尔值设置决定如果输出逃脱者sub-framework启用。启用时,所有的变量可用的模板会自动调用定义的helper函数逃跑了escaping_method
设置(见下文)。
要小心,escaping_method
symfony使用的是默认的助手,但这可以覆盖在案例的基础上欧宝娱乐app下载地址,当输出一个变量在一个JavaScript脚本标记为例。
输出逃脱者sub-framework使用字符集
设置逃跑。
强烈建议保留默认值真正的
。
提示
这个设置可以设置当您创建一个应用程序的生成:应用程序
任务通过使用——escaping-strategy
选择。
escaping_method
默认的:ESC_SPECIALCHARS
的escaping_method
定义了默认的函数用于转义变量模板(参见escaping_strategy
设置如上图所示)。
你可以选择其中一个内置的价值观:ESC_SPECIALCHARS
,ESC_RAW
,ESC_ENTITIES
,ESC_JS
,ESC_JS_NO_ENTITIES
,ESC_SPECIALCHARS
,或者创建自己的函数。
在大多数情况下,默认值为好。的ESC_ENTITIES
助手也可以使用,特别是如果你只使用英语或欧洲语言。
csrf_secret
默认的:一个随机生成的秘密
的csrf_secret
为您的应用程序是一个独特的秘密。如果不设置为假
,它使CSRF保护所有形式定义的框架。这也是使用的设置link_to ()
助手的时候需要转换一个链接到一个表单(模拟删除
例如HTTP方法)。
强烈建议改变默认值一个独特的秘密你的选择。
提示
这个设置可以设置当您创建一个应用程序的生成:应用程序
任务通过使用——csrf-secret
选择。
字符集
默认的:utf - 8
的字符集
设置是将使用的字符集的框架:从响应内容类型
头,逃逸到输出特性。
在大多数情况下,默认是好的。
警告
这个设置在框架用在许多不同的地方,所以它的值是在几个地方缓存。改变后,配置必须清除缓存,即使在开发环境。
enabled_modules
默认的:(默认)
的enabled_modules
是一个数组模块的名字为这个应用程序启用。模块中定义的插件或symfony的核心不是默认启用,并且必须列在此设置可访欧宝娱乐app下载地址问。
添加一个模块一样简单,添加到列表中(模块的顺序并不重要):
enabled_modules(默认情况下,sfGuardAuth):
的默认的
模块中定义的框架包含所有中设置的默认行为.actions
小节的settings.yml
。建议您定制他们所有人,然后删除默认的
从这个设置模块。
default_timezone
默认的:没有
的default_timezone
设置定义了默认时区使用PHP。它可以是任何时区被PHP。
请注意
如果您不定义一个时区,建议您来定义的php . ini
文件。如果不是,sym欧宝娱乐app下载地址fony会试图猜测最好的时区通过调用函数()
PHP函数。
缓存
默认的:假
的缓存
设置启用或禁用模板缓存。
提示
的一般配置缓存系统中完成view_cache_manager
和view_cache
部分factories.yml
配置文件。细粒度的配置是在完成的cache.yml
配置文件。
etag
默认的:真正的
默认情况下除外dev
和测试
环境
的etag
设置启用或禁用自动生成ETag
HTTP头信息。symfony是一个简单的md5生成的ETa欧宝娱乐app下载地址g响应的内容。
i18n
默认的:假
的i18n
设置一个布尔值,启用或禁用i18n sub-framework。如果您的应用程序国际化,设置它真正的
。
提示
i18n的常规配置系统是要做的i18n
部分的factories.yml
配置文件。
default_culture
默认的:在
的default_culture
设置定义了默认的i18n sub-framework所使用的文化。它可以是任何有效的文化。
standard_helpers
默认的:(部分、缓存)
的standard_helpers
设置辅助组加载的是一个数组模板(名称的组助手没有助手
后缀)。
no_script_name
默认的:真正的
为刺激
环境创建的第一个应用程序,假
对于所有其他
的no_script_name
设置决定是否前端控制器脚本名称是否返回生成的url。默认情况下,它被设置为真正的
由生成:应用程序
的任务刺激
环境创建的第一个应用程序。
显然,只有一个可以有这个设置设置为应用程序和环境真正的
如果所有前端控制器在同一个目录(web /
)。如果你想要不止一个应用程序no_script_name
设置为真正的
下,将相应的前端控制器(s) web根目录的子目录。
lazy_cache_key
默认的:真正的
对于新项目,假
升级项目
当启用时,lazy_cache_key
设置延迟创建一个缓存键之前检查是否可缓存一个行动或部分。这可能会导致一个巨大的性能提升,取决于你的使用模板泛音。
file_link_format
默认的:没有
在调试消息,如果文件路径是可点击的链接sf_file_link_format
或者如果xdebug.file_link_format
PHP配置值设置。
例如,如果你想在TextMate软件打开的文件,您可以使用以下值:
txmt: / /开放? url =文件:/ / % f&line = % l
的% f
占位符将替换文件的绝对路径% l
占位符将被替换为行号。
logging_enabled
默认的:真正的
适用于所有环境除了刺激
的logging_enabled
设置允许日志sub-framework。设置它假
完全绕过了日志记录机制,提供了一个小的性能增益。
提示
细粒度的配置日志记录是要做的factories.yml
配置文件。
web_debug
默认的:假
适用于所有环境除了dev
的web_debug
设置允许web调试工具栏。web调试工具栏注入HTML页面时,响应内容类型。
error_reporting
默认的:
刺激
:E_PARSE | E_COMPILE_ERROR | E_ERROR | E_CORE_ERROR | E_USER_ERRORdev
:E_ALL |代码测试
(E_ALL |代码)^ E_NOTICE- 默认值:E_PARSE | E_COMPILE_ERROR | E_ERROR | E_CORE_ERROR | E_USER_ERROR
的error_reporting
设置控件的PHP错误报告级别(显示在浏览器和写入日志)。
提示
PHP的网站有一些关于如何使用信息按位运算符。
默认的配置是最明智的,不应该被改变。
请注意
在浏览器中显示的错误是前端控制器,自动禁用调试
残疾,这是默认的刺激
环境。
压缩
默认的:假
的压缩
设置使原生PHP响应压缩。如果设置为真正的
,s欧宝娱乐app下载地址ymfony将使用ob_gzhandler
作为一个回调函数ob_start ()
。
建议保持它假
,并使用您的web服务器的本地压缩机制。
use_database
默认的:真正的
的use_database
决定是否应用程序使用一个数据库。
check_lock
默认的:假
的check_lock
设置启用或禁用应用程序锁定系统引发的一些任务缓存:清晰
和项目:禁用
。
如果设置为真正的
禁用所有请求,应用程序将自动重定向到symfony的核心欧宝娱乐app下载地址lib / /数据/ unavailable.php异常
页面。
提示
您可以通过添加一个覆盖默认不可用模板配置/ unavailable.php
文件到您的项目或应用程序。
web_debug_web_dir
默认的:/科幻/ sf_web_debug
的web_debug_web_dir
设置web路径web调试工具栏资产(图像、样式表和JavaScript文件)。
这项工作在Creative Commons许可Attribution-Share都3.0 Unported许可执照。