FrameworkBundle配置(“框架”)

警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 2.7，现已不再维护。

读本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。

               1 2 3 4 5
               #显示Symfony定义的默认配置值欧宝娱乐app下载地址＄PHP应用程序/控制台配置:转储框架#显示应用程序使用的实际配置值＄PHP应用程序/控制台调试:配置框架
              

请注意

使用XML时，必须使用http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony命名空间和相关的XSD模式可在:http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd

秘密

启用

csrf_protection

启用
field_name(2.4版已弃用)

应急服务国际公司

启用

片段

分析器

请求：

格式

字符串要求

这是一个对于您的应用程序应该是唯一的字符串，通常用于为安全相关的操作添加更多的熵。它的值应该是随机选择的一系列字符、数字和符号，建议长度为32个字符左右。

在实践中，Symfony使欧宝娱乐app下载地址用这个值来生成 CSRF令牌中使用的cookies加密记住我的功能以及在使用时创建签名uriESI(边缘包括)．

此选项成为名为的服务容器参数`kernel.secret`，当应用程序需要一个不可变的随机字符串来添加更多的熵时，您可以使用它。

与任何其他与安全性相关的参数一样，经常更改这个值是一个很好的实践。但是，请记住，更改这个值将使所有签名uri和Remember Me cookie无效。这就是为什么在更改这个值之后，您应该重新生成应用程序缓存并注销所有应用程序用户。

2．3

的`http_method_override`选项在Symfony 2.3中引入。欧宝娱乐app下载地址

类型：布尔默认的：真正的

这决定了_methodrequest参数被用作POST请求的预期HTTP方法。如果启用，则要求::enableHttpMethodParameterOverride方法被自动调用。它变成名为的服务容器参数kernel.http_method_override．

另请参阅

有关更多信息，请参见如何改变表单的动作和方法．

谨慎

如果你在用appache反向代理使用此选项，内核将忽略_method参数，这可能导致错误。

要修复此问题，请调用enableHttpMethodParameterOverride ()方法，然后创建请求对象:

                  1 2 3 4 5 6 7 8
                  / /网络/ app.php/ /……＄内核＝新AppCache (＄内核）;请求：：enableHttpMethodParameterOverride ();// <——添加此行＄请求=请求：：createFromGlobals ();/ /……
                 

数组

配置应被信任的IP地址作为代理。详情请参见如何配置Symfony在负载均衡器欧宝娱乐app下载地址或反向代理后工作．

2．3

在Symfony 2.3中引入了CIDR表示法支持，因此您可以将整个子网列入白名欧宝娱乐app下载地址单(例如。10.0.0.0/8,fc00:: / 7)．

YAML
XML
PHP

                   1 2 3
                   # app / config / config.yml框架:trusted_proxies:[192.0.0.1,10．0．0．0/ 8)
                  

                   1 2 3 4 5 6 7 8 9 10 11
                   <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置trusted-proxies＝“192.0.0.1 10.0.0.0/8”/>容器>
                  

                   1 2 3 4
                   / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（“trusted_proxies”= >数组（“192.0.0.1”,“10.0.0.0/8”)));
                  

字符串默认的：零

如果您使用的是TextMate或Mac Vim这样的IDE，那么Symfony可以将异常消息中的所有文件路径欧宝娱乐app下载地址转换为一个链接，该链接将在IDE中打开该文件。

欧宝娱乐app下载地址Symfony包含一些流行ide的预配置url，您可以使用以下键设置它们:

textmate软件
macvim
emacs
崇高

2.3.14

的emacs而且崇高在Symfony 2.3.14中引入了编辑器。欧宝娱乐app下载地址

您也可以指定自定义URL字符串。如果这样做，所有百分号(％)必须加倍才能转义该字符。例如，如果你在Mac OS平台上使用PHPstorm，你会这样做:

YAML
XML
PHP

                   1 2 3
                   # app / config / config.yml框架:ide:“phpstorm: / /开放?文件＝％％f&line=%%l'
                  

                   1 2 3 4 5 6 7 8 9 10 11
                   <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置ide＝“phpstorm: / /开放?文件＝％％f&line=%%l"/>容器>
                  

                   1 2 3 4
                   / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（ide的= >“phpstorm: / /开放?文件＝％％f&line=%%l'));
                  

提示

如果您使用的是Windows PC，则可以安装 PhpStormProtocol能够使用这个。

当然，因为每个开发人员都使用不同的IDE，所以最好在系统级别上进行设置。可以通过设置xdebug.file_link_format在php . ini配置到URL字符串。

如果不使用Xdebug，另一种方法是在欧宝娱乐app下载地址SYMFONY__TEMPLATING__HELPER__CODE__FILE_LINK_FORMAT环境变量。如果设置了这些配置值中的任何一个，则ide选项将被忽略。

布尔

如果存在此配置设置(而不是`假`)，然后是与测试应用程序相关的服务(例如:`test.client`)。此设置应出现在您的`测试`环境(通常经由`应用程序/配置/ config_test.yml`)．

另请参阅

有关更多信息，请参见 测试．

字符串默认的：`在`

如果没有，则使用默认区域`_locale`已设置路由参数。可以使用 要求::getDefaultLocale方法。

另请参阅

关于默认区域设置的更多信息，可以在如何使用用户的语言环境．

数组|字符串默认的：数组()

的处理过程中的不一致性已经发现了许多不同的攻击宿主头部由各种软件(web服务器，反向代理，web框架等)。基本上，每当框架生成一个绝对URL时(例如，当发送电子邮件重置密码时)，主机可能已经被攻击者操纵了。

另请参阅

您可以阅读“‘HTTP主机头攻击’_”以获得有关这类攻击的更多信息。

Symf欧宝娱乐app下载地址ony的要求::getHost ()方法可能容易受到其中一些攻击，因为它取决于web服务器的配置。避免这些攻击的一个简单解决方案是将Symfony应用程序可以响应的主机列入白名单。欧宝娱乐app下载地址这就是它的目的trusted_hosts选择。如果传入请求的主机名与此列表中的主机名不匹配，应用程序将不响应，用户将收到500响应。

YAML
XML
PHP

                   1 2 3
                   # app / config / config.yml框架:trusted_hosts:[" example.com ",“example.org”］
                  

                   12 3 4 5 6 7 8 9 10 11 12 13 14 15
                   <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:可信主机>example.com框架:可信主机><框架:可信主机>example.org框架:可信主机><！--．．．-->框架:配置>容器>
                  

                   1 2 3 4
                   / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（“trusted_hosts”= >数组（“example.com”,“example.org”)));
                  

主机也可以使用正则表达式进行配置(例如:^(+ \)。? example.com美元)，从而更容易响应任何子域。

此外，还可以在前端控制器中设置可信主机要求::setTrustedHosts ()方法:

                 1 2
                 / /网络/ app.php请求：：setTrustedHosts (数组（“^(+ \)。? example.com美元”,“^(+ \)。? example.org美元”))；
                

此选项的默认值是一个空数组，这意味着应用程序可以响应任何给定的主机。

另请参阅

请在安全顾问博客文章．

布尔默认的：`假`

是否在服务容器中启用表单服务。如果您不使用表单，请将此设置为`假`可能会提高应用程序的性能，因为装入容器的服务更少。

此选项将自动设置为`真正的`当配置了其中一个子设置时。

请注意

这将自动启用 验证．

另请参阅

详情请参见形式．

另请参阅

有关表单中CSRF保护的更多信息，请参见 如何实施CSRF保护．

布尔默认的：`真正的`如果启用了表单支持，`假`否则

此选项可用于禁用CSRF保护所有形式。但是你也可以 在个别表格上禁用CSRF保护．

如果你正在使用表单，但想要避免启动会话(例如在仅api的网站中使用表单)，`csrf_protection`将需要设置为`假`．

谨慎

的`framework.csrf_protection.field_name`设置在Symfony 2.4中已弃用欧宝娱乐app下载地址`framework.form.csrf_protection.field_name`代替。

类型：字符串默认的：“_token”

控件所用的隐藏字段的名称 CSRF令牌．

另请参阅

您可以阅读更多关于边缘包含(ESI)的信息 使用边缘包含．

布尔默认的：假

框架中是否启用边缘包含支持。

你也可以设置应急服务国际公司来真正的启用它:

YAML
XML
PHP

                    1 2 3
                    # app / config / config.yml框架:应急服务国际公司:真正的
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:应急服务国际公司/>框架:配置>容器>
                   

                    1 2 3 4
                    / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（应急服务国际公司的= >真正的));
                   

另请参阅

中了解有关片段的更多信息 HTTP缓存文章．

布尔默认的：`假`

是否启用分片监听器。片段侦听器用于独立于页面的其余部分呈现ESI片段。

此设置将自动设置为`真正的`当配置了其中一个子设置时。

字符串默认的：`' / _fragment '`

片段的路径前缀。片段侦听器只会在请求以此路径开始时执行。

布尔默认的：`假`

通过将此选项设置为，可以启用剖析器`真正的`．使用Symfony标准版时，在欧宝娱乐app下载地址`dev`而且`测试`环境。

请注意

剖析器独立于Web开发人员工具栏工作，请参阅 WebProfilerBundle配置关于如何禁用/启用工具栏。

2．3

的`收集`选项在Symfony 2.3中引入。欧宝娱乐app下载地址以前,当`profiler.enabled`是`假`，侧写器是实际上已启用，但收集器已禁用。现在，分析器和收集器可以独立控制。

类型：布尔默认的：真正的

此选项配置启用剖析器时的行为方式。如果设置为真正的，剖析器收集所有请求的数据(除非您另有配置，如自定义匹配器)．如果只希望按需收集信息，可以设置收集旗帜假并手动激活数据收集器:

                  1
                  ＄分析器->使();
                 

布尔默认的：`假`

当设置为时`真正的`，只有在处理请求期间抛出异常时，剖析器才会启用。

布尔默认的：`假`

当设置为时`真正的`，分析器将只在主请求上启用(而不是在子请求上启用)。

字符串默认的：`“文件:% kernel.cache_dir % /分析器”`

存储分析信息的DSN。

另请参阅

看到 切换分析器存储有关分析器存储的更多信息。

字符串默认的：`”`

在需要时，配置存储的用户名。

字符串默认的：`”`

需要时，配置存储的密码。

整数默认的：`86400`

分析存储的生命周期(以秒为单位)。过期后，数据将被删除。

知识产权或路径．

另请参阅

看到如何使用匹配器有条件地启用剖析器有关使用匹配器启用/禁用剖析器的详细信息。

字符串

如果设置，只在当前IP地址匹配时才启用剖析器。

字符串

如果设置了，只在当前路径匹配时才启用剖析器。

字符串

此设置包含自定义匹配器的服务id。

数组默认的：［］

此设置用于关联其他请求格式(例如。超文本标记语言)到一个或多个mime类型(例如:text / html)，它将允许你使用format & mime类型来调用要求::getFormat (mimeType美元)或要求::getMimeType(格式)．

在实践中，这很重要，因为Symfony使用它来自动设置欧宝娱乐app下载地址内容类型标头上的响应(如果您没有显式地设置一个)。如果您传递一个mime类型数组，第一个将用于头。

配置jsonp格式:

YAML
XML
PHP

                    1 2 3 4 5
                    # app / config / config.yml框架:要求:格式:jsonp:“应用程序/ javascript”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
                    <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:请求><框架:格式的名字＝“jsonp”><框架:mime类型>应用程序/ javascript框架:mime类型>框架:格式>框架:请求>框架:配置>容器>
                   

                    1 2 3 4 5 6 7 8
                    / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（“请求”= >数组（“格式”= >数组（“jsonp”= >“应用程序/ javascript”，)，)，));
                   

字符串要求

包含路由和引入路由器的主路由资源(例如YAML文件)应该加载的路径。

字符串

向加载器提示格式的资源的类型。当您使用具有预期文件扩展名的默认路由器(`. xml`,`.yml`/`.yaml`,`. php`)．

整数默认的：`80`

正常http请求的端口(在匹配方案时使用)。

整数默认的：`443`

https请求的端口(在匹配方案时使用)。

混合默认的：`真正的`

确定路由生成器行为。当生成路由时，具有特定的 需求，在使用的参数不满足这些要求的情况下，发电机可以表现不同。

取值为:

`真正的`

当需求未被满足时抛出异常;

`假`

当不满足要求时禁用异常并返回`零`相反;

`零`

禁用检查需求(因此，即使需求不匹配，也要匹配路由)。

`真正的`建议在开发环境中使用，而`假`或`零`在生产中可能是首选。

字符串默认的：`“session.storage.native”`

会话存储使用的服务id。的`session.storage`服务别名将设置为此服务id。这个类必须实现 SessionStorageInterface．

字符串默认的：`“session.handler.native_file”`

会话存储使用的服务id。的`session.handler`服务别名将设置为此服务id。

也可以设置为`零`，默认为PHP安装的处理程序。

另请参阅

你可以看到这个用法的一个例子 如何使用PdoSessionHandler存储会话在数据库中．

字符串默认的：`零`

这指定会话cookie的名称。默认情况下，它将使用定义在`php . ini`与`session.name`指令。

整数默认的：`One hundred.`

看到 gc_probability．

整数默认的：`1`

这定义了每次会话初始化时启动垃圾收集器(GC)进程的概率。概率计算采用`gc_probability`/`gc_divisor`例如，1/100表示有1%的几率GC进程将在每个请求上启动。

整数默认的：`1440`

这决定了数据将被视为“垃圾”并可能被清理的秒数。垃圾收集可能发生在会话启动期间，这取决于 gc_divisor而且gc_probability．

布尔默认的：`假`

这指定会话模块是否将使用严格的会话id模式。如果启用该模式，模块将不接受未初始化的会话id。如果浏览器发送了一个未初始化的会话ID，则会向浏览器发送一个新的会话ID。应用程序通过采用严格模式的会话来防止会话固定。

字符串默认的：% kernel.cache_dir % /会话

这决定了要传递给保存处理程序的参数。如果选择默认文件处理程序，则这是创建会话文件的路径。有关更多信息，请参见配置会话文件的保存路径．

也可以将此值设置为save_path你的php . ini通过将值设置为零：

YAML
XML
PHP

                    1 2 3 4
                    # app / config / config.yml框架:会话:save_path:～
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:会话节省路径＝“零”/>框架:配置>容器>
                   

                    1 2 3 4 5 6
                    / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（“会话”= >数组（“save_path”= >零，)，));
                   

整数默认的：`0`

这是两次会话元数据更新之间等待的秒数。如果会话没有更改，它还将阻止会话处理程序写入。

另请参阅

你可以看到这个用法的一个例子 限制会话元数据写入．

字符串

这个选项允许你定义资产的基本路径:

YAML
XML
PHP

                    1 2 3 4 5
                    # app / config / config.yml框架:#……资产:base_path:' /图片'
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:资产基本路径＝“/图片”/>框架:配置>容器>
                   

                    1 2 3 4 5 6 7
                    / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（/ /……“资产”= >数组（“base_path”= >' /图片'，)，));
                   

数组

此选项允许您定义资产使用的基本url。如果提供了多个基本url, Symfony每次生成资产路径时都会从集合中欧宝娱乐app下载地址选择一个:

YAML
XML
PHP

                    1 2 3 4 5 6
                    # app / config / config.yml框架:#……资产:base_url:-“http://cdn.example.com/”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:资产基url＝“http://cdn.example.com/”/>框架:配置>容器>
                   

                    1 2 3 4 5 6 7
                    / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（/ /……“资产”= >数组（“base_url”= >数组（“http://cdn.example.com/”)，)，));
                   

YAML
XML
PHP

                    1 2 3 4 5 6 7
                    # app / config / config.yml框架:#……资产:包:头像:base_url:“http://static_cdn.example.com/avatars”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                    <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:资产><框架:包的名字＝“阿凡达”基url＝“http://static_cdn.example.com/avatars”/>框架:资产>框架:配置>容器>
                   

                    1 2 3 4 5 6 7 8 9 10 11
                    / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（/ /……“资产”= >数组（“包”= >数组（“阿凡达”= >数组（“base_url”= >“http://static_cdn.example.com/avatars”，)，)，)，));
                   

现在您可以使用阿凡达在模板中打包:

嫩枝
PHP

                    1
                    <imgsrc＝＂{{资产(“…'， 'avatars')}}＂>
                   

每个包可以配置以下选项:

字符串

此选项用于破产通过全局地向所有呈现的资产路径添加一个查询参数来缓存资产。/图片/ logo.png吗?v2)．这只适用于通过树枝渲染的资产资产()函数(或PHP等效)以及使用Assetic呈现的资产。

例如，假设你有以下内容:

嫩枝
PHP

                    1
                    <imgsrc＝＂{{asset('images/logo.png')}}＂alt＝“欧宝娱乐app下载地址Symfony !”/>
                   

默认情况下，这将呈现图像的路径，例如/图片/ logo.png．现在，激活版本选择:

YAML
XML
PHP

                    1 2 3 4 5
                    # app / config / config.yml框架:#……资产:版本:“v2”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:资产版本＝“v2”/>框架:配置>容器>
                   

                    1 2 3 4 5 6 7
                    / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（/ /……“资产”= >数组（“版本”= >“v2”，)，));
                   

现在，相同的资产将呈现为/图片/ logo.png吗?v2如果您使用此功能，您将必须手动增加版本值，以便查询参数更改。

控件还可以控制查询字符串的工作方式 version_format选择。

提示

与所有设置一样，可以使用参数作为属性的值版本．这使得在每次部署时更容易增加缓存。

字符串默认的：`% % s ?% % s`

这指定了 sprintf属性一起使用的版本构造资产路径的选项。默认情况下，该模式将资产的版本作为查询字符串添加。例如，如果`version_format`设置为`% % s ?version = % % s`而且`版本`设置为`5`，资产的路径为`/图片/ logo.png吗?版本= 5`．

请注意

所有百分号(`％`)中的字符必须加倍以转义字符。如果没有转义，值可能会无意中被解释为服务容器．

提示

一些CDN不支持通过查询字符串进行缓存破坏，因此将版本注入到实际的文件路径中是必要的。值得庆幸的是,`version_format`不限于生成版本控制的查询字符串。

该模式分别接收资产的原始路径和版本作为其第一个和第二个参数。因为资产的路径是一个参数，所以您不能就地修改它(例如。`/图片/ logo-v5.png`）;的模式作为资产路径的前缀`版本- % % 2 $ s / % % 1 $ s`，就会得到路径`版本5 /图片/ logo.png`．

然后可以使用URL重写规则在提供资产之前忽略版本前缀。或者，作为部署过程的一部分，您可以将资产复制到适当的版本路径，并忘记任何URL重写。如果您希望较旧的资产版本仍然可以通过其原始URL访问，则后一个选项非常有用。

字符串默认的：`零`

设置加载片段期间或禁用JavaScript时显示的内容。这可以是模板名，也可以是内容本身。

另请参阅

看到 如何用hinclude.js嵌入异步内容有关hinclude的更多信息。

string []默认的：(“FrameworkBundle:形式”)

PHP表单主题的所有资源列表。如果您正在为模板使用Twig格式，则此设置不需要，在这种情况下请参阅形式article．

假设您有自定义全局表单主题src / WebsiteBundle /资源/视图/形式，你可以这样配置:

YAML
XML
PHP

                     1 2 3 4 5 6
                     # app / config / config.yml框架:模板:形式:资源:-“WebsiteBundle:形式”
                    

                     12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
                     <！--app/config/config.xml --><？?> . xml version="1.0" encoding="UTF-8"<容器xmlns＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi＝“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:模板><框架:形式><框架:资源>WebsiteBundle:形式框架:资源>框架:形式>框架:模板>框架:配置>容器>
                    

                     1 2 3 4 5 6 7 8 9 10
                     / / app / config / config . php＄容器->loadFromExtension (“框架”,数组（“模板”= >数组（“形式”= >数组（“资源”= >数组（“WebsiteBundle:形式”，)，)，)，));
                    

请注意

的默认表单模板FrameworkBundle:形式将始终包含在表单资源中。

另请参阅

看到如何处理表单主题获取更多信息。

布尔默认的：`假`

是否启用`翻译`服务容器中的服务。

字符串|数组默认的：`阵列(en)`

2.3.25

的`回退`选项在Symfony 2.3.25中引入。欧宝娱乐app下载地址在Symfony 欧宝娱乐app下载地址2.3.25之前，它被调用`回退`并且只允许一种回退语言定义为字符串。请注意，您仍然可以使用旧的`回退`选项，如果您只想定义一个备用方案。

当没有找到当前语言环境的翻译键时使用此选项。

另请参阅

详情请参见 翻译．

2.6

的`日志记录`选项是在Symfony 2.6中引入的。欧宝娱乐app下载地址

默认的：`真正的`当调试模式开启时，`假`否则。

当`真正的`，每当翻译器找不到给定键的翻译时，就会生成一个日志条目。这些日志是为`翻译`频道和`调试`对于在备用区域设置中有翻译的键的级别`警告`水平如果没有翻译使用根本。

布尔默认的：`假`

启用时，`property_accessor`服务使用PHP的 Magic __call()方法当它`getValue ()`方法。

布尔默认的：`假`

启用时，`property_accessor`当您试图访问数组的无效索引时，服务将引发异常。

布尔默认的：`真正的`如果 表单支持已启用,`假`否则

是否启用验证支持。

此选项将自动设置为`真正的`当配置了其中一个子设置时。

字符串

用于在缓存中持久化类元数据的服务。服务必须实现 CacheInterface．

布尔默认的：`假`

如果启用此选项，则可以使用注释定义验证约束。

字符串默认的：`验证器`

翻译验证约束错误消息时使用的翻译域。

布尔默认的：`假`

如果启用此选项，则 egulias / email-validator库将被电子邮件约束验证器。否则，验证器使用一个简单的正则表达式来验证电子邮件地址。

字符串

从Symfony 2.5开始欧宝娱乐app下载地址，Validator组件引入了一个新的验证API。的`api`选项用于在不同的实现之间切换:

`2.5`

使用Symfony 2.5中引入的验证API。欧宝娱乐app下载地址

`2.5公元前`或`汽车`

的值`api`选项`2.5公元前`或`汽车`，欧宝娱乐app下载地址Symfony将使用与这两个遗留版本兼容的API实现`2.4`实施和`2.5`实现。

请注意

从Symfony 2.7开始，就不再支持原生2.4 API了。欧宝娱乐app下载地址

来捕获这些日志`刺激`环境，配置一个 通道处理程序在`config_prod.yml`为`翻译`通道并设置其`水平`来`调试`．

字符串默认的：`“文件”`

该选项可以是以下值之一:

文件

使用文件系统缓存注释

没有一个

禁用注释缓存

服务id

对象引用的服务id 教义缓存实现

字符串默认的：`“% kernel.cache_dir % /注释”`

以防万一，用于存储注释缓存文件的目录`annotations.cache`设置为`“文件”`．

布尔默认的：`% kernel.debug %`

是否启用缓存的调试模式。如果启用，缓存将在原始文件被更改(包括代码和注释更改)时自动更新。出于性能考虑，建议在生产环境中禁用调试模式，如果使用默认值，调试模式将自动发生。

布尔默认的：`假`

是否启用`序列化器`服务或不在服务容器中。

字符串

用于在缓存中持久化类元数据的服务。服务必须实现`学说\常见\缓存\缓存`接口。

另请参阅

有关更多信息，请参见 如何使用序列化器．

布尔默认的：`假`

如果启用此选项，则可以使用注释定义序列化组。

另请参阅

有关更多信息，请参见 如何使用序列化器．

YAML

                  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
                  框架:秘密:～http_method_override:真正的trusted_proxies:［］ide:～测试:～default_locale:在csrf_protection:启用:假field_name:_token# 2.4以来已弃用，将在3.0移除。使用form.csrf_protection。field_name相反#表单配置形式:启用:假csrf_protection:启用:真正的field_name:～# esi配置应急服务国际公司:启用:假# fragments配置片段:启用:假路径:/ _fragment# profiler配置分析器:启用:假收集:真正的only_exceptions:假only_master_requests:假dsn:文件:% kernel.cache_dir % /分析器用户名:密码:生命周期:86400匹配器:知识产权:～使用urldecoded格式路径:～#示例:^/资源/的路径服务:～#路由器配置路由器:资源:～#需要类型:～http_port:80https_port:443# *设置为true则当参数不为true时抛出异常#匹配要求# *设置为false，当参数不存在时禁用异常#匹配要求(并返回null)# *设置为null以禁用参数检查＃# 'true'是开发模式下的首选配置，而# 'false'或'null'在生产环境中可能是首选strict_requirements:真正的#会话配置会话:storage_id:session.storage.nativehandler_id:session.handler.native_file名称:～cookie_lifetime:～cookie_path:～cookie_domain:～cookie_secure:～cookie_httponly:～gc_divisor:～gc_probability:～gc_maxlifetime:～save_path:“% kernel.cache_dir % /会话”# serializer配置序列化器:启用:假# assets配置资产:base_path:～base_url:［］版本:～version_format:% %年代?% % s '包:#原型名称:base_path:～base_url:［］版本:～version_format:% %年代?% % s '#模板配置模板:hinclude_default_template:～形式:资源:#默认值:-FrameworkBundle:形式缓存:～发动机:#需要#的例子:-嫩枝加载器:［］# translator配置翻译:启用:假回退:(en)日志:“% kernel.debug %”#验证配置验证:启用:假缓存:～enable_annotations:假translation_domain:验证器#注释配置注释:缓存:文件file_cache_dir:“% kernel.cache_dir % /注释”调试:“% kernel.debug %”
                 

此工作，包括代码示例，是根据创作共用BY-SA 3.0许可证。

FrameworkBundle配置(“框架”)

布尔 如果存在此配置设置(而不是假)，然后是与测试应用程序相关的服务(例如:test.client)。此设置应出现在您的测试环境(通常经由应用程序/配置/ config_test.yml)． 另请参阅

字符串默认的：在 如果没有，则使用默认区域_locale已设置路由参数。可以使用要求::getDefaultLocale方法。 另请参阅 关于默认区域设置的更多信息，可以在如何使用用户的语言环境．

另请参阅 有关表单中CSRF保护的更多信息，请参见如何实施CSRF保护．

另请参阅 您可以阅读更多关于边缘包含(ESI)的信息使用边缘包含．

另请参阅 中了解有关片段的更多信息HTTP缓存文章．

布尔默认的：假 通过将此选项设置为，可以启用剖析器真正的．使用Symfony标准版时，在欧宝娱乐app下载地址dev而且测试环境。 请注意

字符串默认的：“文件:% kernel.cache_dir % /分析器” 存储分析信息的DSN。 另请参阅

字符串默认的：“session.storage.native” 会话存储使用的服务id。的session.storage服务别名将设置为此服务id。这个类必须实现SessionStorageInterface．

字符串默认的：“session.storage.native” 会话存储使用的服务id。的session.storage服务别名将设置为此服务id。这个类必须实现SessionStorageInterface．

字符串默认的：“session.handler.native_file” 会话存储使用的服务id。的session.handler服务别名将设置为此服务id。 也可以设置为零，默认为PHP安装的处理程序。 另请参阅

整数默认的：One hundred. 看到gc_probability．

整数默认的：1440 这决定了数据将被视为“垃圾”并可能被清理的秒数。垃圾收集可能发生在会话启动期间，这取决于gc_divisor而且gc_probability．

整数默认的：0 这是两次会话元数据更新之间等待的秒数。如果会话没有更改，它还将阻止会话处理程序写入。 另请参阅

字符串默认的：零 设置加载片段期间或禁用JavaScript时显示的内容。这可以是模板名，也可以是内容本身。 另请参阅

字符串默认的：零 设置加载片段期间或禁用JavaScript时显示的内容。这可以是模板名，也可以是内容本身。 另请参阅

string [] 模板加载器的服务id数组(仅配置一个加载器时为字符串)。模板加载器用于从资源(例如文件系统或数据库)中查找和加载模板。模板加载器必须实现LoaderInterface．

布尔默认的：假 启用时，property_accessor服务使用PHP的Magic __call()方法当它getValue ()方法。

布尔默认的：假 启用时，property_accessor服务使用PHP的Magic __call()方法当它getValue ()方法。

布尔默认的：真正的如果表单支持已启用,假否则 是否启用验证支持。 此选项将自动设置为真正的当配置了其中一个子设置时。

字符串 用于在缓存中持久化类元数据的服务。服务必须实现CacheInterface．

布尔默认的：假 如果启用此选项，则egulias / email-validator库将被电子邮件约束验证器。否则，验证器使用一个简单的正则表达式来验证电子邮件地址。

字符串默认的：“文件” 该选项可以是以下值之一: 文件 使用文件系统缓存注释 没有一个 禁用注释缓存 服务id

字符串 用于在缓存中持久化类元数据的服务。服务必须实现学说\常见\缓存\缓存接口。 另请参阅

布尔默认的：假 如果启用此选项，则可以使用注释定义序列化组。 另请参阅

布尔

如果存在此配置设置(而不是`假`)，然后是与测试应用程序相关的服务(例如:`test.client`)。此设置应出现在您的`测试`环境(通常经由`应用程序/配置/ config_test.yml`)．

另请参阅

有关更多信息，请参见测试．

字符串默认的：`在`

如果没有，则使用默认区域`_locale`已设置路由参数。可以使用要求::getDefaultLocale方法。

另请参阅

关于默认区域设置的更多信息，可以在如何使用用户的语言环境．

另请参阅

有关表单中CSRF保护的更多信息，请参见如何实施CSRF保护．

另请参阅

您可以阅读更多关于边缘包含(ESI)的信息使用边缘包含．

另请参阅

中了解有关片段的更多信息 HTTP缓存文章．

字符串默认的：`“文件:% kernel.cache_dir % /分析器”`

存储分析信息的DSN。

另请参阅

看到切换分析器存储有关分析器存储的更多信息。

字符串默认的：`“session.storage.native”`

会话存储使用的服务id。的`session.storage`服务别名将设置为此服务id。这个类必须实现 SessionStorageInterface．

字符串默认的：`“session.storage.native”`

会话存储使用的服务id。的`session.storage`服务别名将设置为此服务id。这个类必须实现 SessionStorageInterface．

整数默认的：`One hundred.`

看到 gc_probability．

整数默认的：`1440`

这决定了数据将被视为“垃圾”并可能被清理的秒数。垃圾收集可能发生在会话启动期间，这取决于 gc_divisor而且gc_probability．

整数默认的：`0`

这是两次会话元数据更新之间等待的秒数。如果会话没有更改，它还将阻止会话处理程序写入。

另请参阅

你可以看到这个用法的一个例子限制会话元数据写入．

字符串默认的：`零`

设置加载片段期间或禁用JavaScript时显示的内容。这可以是模板名，也可以是内容本身。

另请参阅

看到如何用hinclude.js嵌入异步内容有关hinclude的更多信息。

字符串默认的：`零`

设置加载片段期间或禁用JavaScript时显示的内容。这可以是模板名，也可以是内容本身。

另请参阅

看到如何用hinclude.js嵌入异步内容有关hinclude的更多信息。

string []

模板加载器的服务id数组(仅配置一个加载器时为字符串)。模板加载器用于从资源(例如文件系统或数据库)中查找和加载模板。模板加载器必须实现 LoaderInterface．

布尔默认的：`假`

启用时，`property_accessor`服务使用PHP的 Magic __call()方法当它`getValue ()`方法。

布尔默认的：`假`

启用时，`property_accessor`服务使用PHP的 Magic __call()方法当它`getValue ()`方法。

布尔默认的：`真正的`如果表单支持已启用,`假`否则

是否启用验证支持。

此选项将自动设置为`真正的`当配置了其中一个子设置时。

字符串

用于在缓存中持久化类元数据的服务。服务必须实现 CacheInterface．

布尔默认的：`假`

如果启用此选项，则 egulias / email-validator库将被电子邮件约束验证器。否则，验证器使用一个简单的正则表达式来验证电子邮件地址。

字符串默认的：`“文件”`

该选项可以是以下值之一:

文件

使用文件系统缓存注释

没有一个

禁用注释缓存

服务id

对象引用的服务id 教义缓存实现

字符串

用于在缓存中持久化类元数据的服务。服务必须实现`学说\常见\缓存\缓存`接口。

另请参阅

有关更多信息，请参见如何使用序列化器．

布尔默认的：`假`

如果启用此选项，则可以使用注释定义序列化组。

另请参阅

有关更多信息，请参见如何使用序列化器．