框架配置参考(FrameworkBundle)

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

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

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

请注意

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

字符串要求

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

在实践中，Symfony使欧宝娱乐app下载地址用此值来加密 记住我的功能以及在使用时创建签名uriESI(边缘包括)．这就是为什么您应该将此值视为敏感凭据的原因永远不要公开．

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

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

布尔默认的：`假`

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

如果为true，则在出错时抛出异常。否则，缓存将尝试继续执行并交付有意义的响应。

字符串可能的值：`“没有”`，`“短”`或`“全部”`

对于“short”，主请求的简明跟踪将作为HTTP报头添加。'full'将为所有请求(包括ESI子请求)添加跟踪。(默认:'full'如果在调试;“没有”否则)

字符串

用于跟踪的标头名称。(默认值:X-Symfo欧宝娱乐app下载地址ny-Cache)

整数

在响应中没有提供显式的新鲜度信息时，缓存条目应被视为新鲜的秒数。显式缓存控制或过期头将覆盖此值。(默认值:0)

数组

在响应上触发“私有”缓存控制行为的请求头集，该响应没有通过缓存控制指令显式地声明响应是公共还是私有。(默认:授权和Cookie)

字符串

指定客户端是否可以通过在请求中包含cache - control“no-cache”指令来强制缓存重新加载。设置为`真正的`，以符合rfc2616。(默认值:false)

字符串

指定客户端是否可以通过在请求中包含cache - control "max-age=0"指令来强制缓存重新验证。设置为`真正的`，以符合rfc2616。(默认值:false)

整数

指定默认的秒数(响应TTL精度为秒，粒度为秒)，在此期间缓存可以立即返回一个过期的响应，同时在后台重新验证它(默认值:2)。此设置将被stale-while-revalidate HTTP缓存控制扩展覆盖(参见RFC 5861)。

整数

指定默认的秒数(粒度为秒)，在此期间，当遇到错误时，缓存可以提供过时的响应(默认为60)。这个设置被stale-if-error HTTP Cache-Control扩展覆盖(参见RFC 5861)。

布尔默认的：真正的

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

另请参阅

更改动作和HTTP方法Sym欧宝娱乐app下载地址fony的形式。

谨慎

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

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

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

trusted_headers当在负载均衡器或反向代理后运行Symfony时，需要配置哪些客户端信息应该被信任(例如他们的主机)。欧宝娱乐app下载地址看到 如何配置Symfony在负载均衡器欧宝娱乐app下载地址或反向代理后工作．

trusted_proxies当在负载均衡器或反向代理后运行Symfony时，需要一个选项来获得关于客户端的精确信息(例如他们的IP地址)。欧宝娱乐app下载地址看到 如何配置Symfony在负载均衡器欧宝娱乐app下载地址或反向代理后工作．

字符串默认的：零

欧宝娱乐app下载地址Symfony将变量转储和异常消息中的文件路径转换为在浏览器中打开这些文件的链接。如果您喜欢在您喜欢的IDE或文本编辑器中打开这些文件，请将此选项设置为以下值之一:phpstorm，崇高，textmate软件，macvim，emacs，原子而且vscode．

请注意

的phpstorm选项是由MacOS上的PhpStorm原生支持的，Windows要求 PhpStormProtocolLinux需要phpstorm-url-handler．

如果使用其他编辑器，则预期的配置值是包含% f文件路径的占位符% l行号占位符(百分比符号(％)必须通过重复它们来转义，以防止Symfony将它们解释为容器参数)。欧宝娱乐app下载地址

YAML
XML
PHP

                   1 2 3
                   #配置/包/ framework.yaml框架:ide:“myide: / /开放?url =文件:/ / % % f&line = % % l '
                  

                   1 2 3 4 5 6 7 8 9 10 11
                   <！--config/packages/framework.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＝“myide: / /开放?url =文件:/ / % % f&line = % % l”/>容器>
                  

                   1 2 3 4 5 6
                   / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->ide (“myide: / /开放?url =文件:/ / % % f&line = % % l '）;};
                  

由于每个开发人员都使用不同的IDE，因此启用该特性的推荐方法是在系统级别上配置它。首先，你可以将它的值设置为某个存储IDE/编辑器名称的环境变量:

YAML
XML
PHP

                   1 2 3 4
                   #配置/包/ framework.yaml框架:# env变量存储IDE/编辑器的名称(例如:'phpstorm'， 'vscode'，等等)ide:' % env(解决:CODE_EDITOR) %
                  

                   12 3 4 5 6 7 8 9 10 11 12
                   <！--config/packages/framework.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”><！--the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.) --><框架:配置ide＝“% env(解决:CODE_EDITOR) %”/>容器>
                  

                   1 2 3 4 5 6 7
                   / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛// env变量存储IDE/编辑器的名称(例如:'phpstorm'， 'vscode'，等等)＄框架->ide (env (“CODE_EDITOR”）->解决());};
                  

另一种选择是设置xdebug.file_link_format在您的php . ini配置文件。所使用的格式与framework.ide选项，但不需要转义百分号(％)，把它们加倍:

                 1 2 3 4 5
                 // PhpStorm的示例xdebug.file_link_format＝“phpstorm: / /开放?文件= % f&line = % l”//崇高的例子xdebug.file_link_format＝“subl: / /开放?url =文件:/ / % f&line = % l”
                

请注意

如果两个framework.ide而且xdebug.file_link_format时，Symfony使用欧宝娱乐app下载地址xdebug.file_link_format选择。

提示

设置xdebug.file_link_format即使没有启用Xdebug扩展，ini选项也可以工作。

提示

当在容器或虚拟机中运行应用程序时，您可以告诉Symfony通过更改文件的前缀将它们从客户机映射到主机。欧宝娱乐app下载地址这个映射应该在URL模板的末尾指定，使用＆而且>作为客人对主人的分隔:

                  1 2 3 4 5 6 7
                  / / /道路/ /客户/……/文件will be opened // as /path/to/host/.../file on the host // and /var/www/app/ as /projects/my_project/ also 'myide://%%f:%%l&/path/to/guest/>/path/to/host/&/var/www/app/>/projects/my_project/&...' // example for PhpStorm 'phpstorm://open?file=%%f&line=%%l&/var/www/app/>/projects/my_project/'
                 

布尔

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

另请参阅

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

字符串默认的：在

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

另请参阅

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

数组默认的：［］(空数组=启用所有区域设置)

欧宝娱乐app下载地址Symfony应用程序在默认情况下为所有地区的验证和安全消息生成翻译文件。如果您的应用程序只使用一些地区，使用这个选项来限制Symfony生成的文件，并提高一些性能:欧宝娱乐app下载地址

YAML
XML
PHP

                    1 2 3
                    #配置/包/ translation.yaml框架:enabled_locales:(“en”,“西文”］
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14
                    <！--config/packages/translation.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”><框架:配置><enabled-locale>在enabled-locale><enabled-locale>西文enabled-locale>框架:配置>容器>
                   

                    1 2 3 4 5 6
                    / /配置/包/ translation.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->enabledLocales ([“en”，“西文”]);};
                   

如果某些用户使用该选项中未包含的语言环境发出请求，应用程序将不会显示任何错误，因为Symfony将使用备用语言环境显示内容。欧宝娱乐app下载地址

布尔默认的：`假`

如果此选项设置为`真正的`时，响应将有a`内容语言`属性设置的HTTP头`请求`语言环境。

布尔默认的：`假`

如果此选项设置为`真正的`,`请求`的值将自动设置为`接收语言`HTTP报头。

当`_locale`请求属性被传递时，`接收语言`头文件被忽略。

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

如果`真正的`，欧宝娱乐app下载地址Symfony增加了一个`X-Robots-Tag: noindex`HTTP标记到所有响应(除非你自己的应用程序添加了这个头，在这种情况下它不会被修改)。这 X-Robots-Tag HTTP头告诉搜索引擎不要索引你的网站。此选项是一种保护措施，以防您意外地以调试模式发布站点。

数组|字符串默认的：［］

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

另请参阅

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

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

YAML
XML
PHP

                   1 2 3
                   #配置/包/ framework.yaml框架:trusted_hosts:\[' ^例子。com的美元,“.org \ $ ^例子”］
                  

                   12 3 4 5 6 7 8 9 10 11 12 13 14 15
                   <！--config/packages/framework.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”><框架:配置><框架:可信主机>^ \ com美元示例框架:可信主机><框架:可信主机>^ \ .org $例子框架:可信主机><！--．．．-->框架:配置>容器>
                  

                   1 2 3 4 5 6
                   / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->trustedHosts ([“^例子\ com美元”，“.org \ $ ^例子”]);};
                  

主机也可以配置为响应任何子域，通过^(+ \)。?例子\ com美元例如。

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

                 1 2
                 / /公共/ index . php请求：：setTrustedHosts ([“^(+ \)。?例子\ com美元”，“^(+ \)。?例子\ .org美元”]);
                

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

另请参阅

请在安全顾问博客文章．

布尔默认的：`真正的`或`假`取决于您的安装

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

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

请注意

这将自动启用 验证．

另请参阅

详情请参见形式．

字符串默认的：`_token`

这是您应该提供给表单的CSRF令牌字段的字段名。

另请参阅

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

布尔默认的：真正的或假取决于您的安装

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

YAML
XML
PHP

                    1 2 3 4
                    #配置/包/ framework.yaml框架:#……csrf_protection:真正的
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/packages/framework.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”><框架:配置><框架:csrf保护启用＝“真正的”/>框架:配置>容器>
                   

                    1 2 3 4 5 6 7
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->csrfProtection ()->启用(真正的);};
                   

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

字符串默认的：`error_controller`

这是当应用程序中的任何地方抛出异常时调用的控制器。默认控制器(ErrorController)在不同的错误条件下呈现特定的模板(参见如何自定义错误页面)．

另请参阅

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

布尔默认的：假

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

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

YAML
XML
PHP

                    1 2 3
                    #配置/包/ framework.yaml框架:应急服务国际公司:真正的
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/packages/framework.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
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->应急服务国际公司()->启用(真正的）;};
                   

另请参阅

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

布尔默认的：`假`

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

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

字符串默认的：`零`

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

另请参阅

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

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

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

http_client或者使用自动装配别名 HttpClientInterface．

此服务可以使用framework.http_client.default_options：

YAML
XML
PHP
独立使用

                   1 2 3 4 5 6 7 8
                   #配置/包/ framework.yaml框架:#……http_client:max_host_connections:10default_options:标题:｛“X-Powered-By”:“ACME应用”｝max_redirects:7
                  

                   12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                   <！--config/packages/framework.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”><框架:配置><框架:http客户端max-host-connections＝“10”><框架:默认选项max-redirects＝“7”><框架:头的名字＝“X-Powered-By”>ACME的应用框架:头>框架:默认选项>框架:http客户端>框架:配置>容器>
                  

                   12 3 4 5 6 7 8 9 10 11 12
                   / /配置/包/ framework.php＄容器->loadFromExtension (“框架”, (“http_client”= > [“max_host_connections”= >10，“default_options”= > [“头”= > [“X-Powered-By”= >“ACME应用”),“max_redirects”= >7，]，]，]);
                  

                   1 2 3 4 5 6
                   ＄客户端= HttpClient：：创建([“头”= > [“X-Powered-By”= >“ACME应用”),“max_redirects”= >7),10）;
                  

可以定义多个预先配置的HTTP客户端服务，每个服务名称定义为下的一个键scoped_clients．对象定义的默认选项http_client服务。你可以覆盖这些选项，也可以定义其他一些选项:

YAML
XML
PHP
独立使用

                   1 2 3 4 5 6 7 8
                   #配置/包/ framework.yaml框架:#……http_client:scoped_clients:my_api.client:auth_bearer:secret_bearer_token#……
                  

                   12 3 4 5 6 7 8 9 10 11 12 13 14 15
                   <！--config/packages/framework.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”><框架:配置><框架:http客户端><框架:scoped-client的名字＝“my_api.client”auth-bearer＝“secret_bearer_token”/>框架:http客户端>框架:配置>容器>
                  

                   1 2 3 4 5 6 7 8 9 10 11
                   / /配置/包/ framework.php＄容器->loadFromExtension (“框架”, (“http_client”= > [“scoped_clients”= > [“my_api.client”= > [“auth_bearer”= >“secret_bearer_token”，/ /……]，]，]，]);
                  

                   1 2 3 4
                   ＄客户端= HttpClient：：createForBaseUri (“https://..”。, (“auth_bearer”= >“secret_bearer_token”，/ /……]);
                  

为有作用域的客户端定义的选项仅应用于与它们匹配的urlbase_uri或者是范围选项。不匹配的url总是使用默认选项。

每个限定作用域的客户端还定义了一个相应的已命名的自动装配别名。举个例子欧宝娱乐app下载地址Symfony \ \ HttpClient \ HttpClientInterface myApiClient美元的合同作为参数的类型和名称，自动装配将注入my_api.client服务到自动连接的类中。

通过启用可选的retry_failed配置后，HTTP客户端服务将自动重试失败的HTTP请求。

                 12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
                 #配置/包/ framework.yaml框架:#……http_client:#……default_options:retry_failed:# retry_strategy: app.custom_strategyhttp_codes:0：(“得到”,“头”］如果请求方法为GET或HEAD，则重试网络错误429:真正的#重试所有状态码为429的响应500:(“得到”,“头”］max_retries:2延迟:1000乘数:3.max_delay:5000抖动:0.3scoped_clients:my_api.client:#……retry_failed:max_retries:4
                

字符串

用于创建的用户名和密码`授权`HTTP基本认证时使用的HTTP报头。该选项的取值必须遵循如下格式`用户名:密码`．

字符串

对象所使用的令牌`授权`HTTP承载身份验证(也称为令牌身份验证)中使用的HTTP头。

字符串

用于创建的用户名和密码`授权`类中使用的HTTP头 微软NTLM认证协议．该选项的取值必须遵循如下格式`用户名:密码`．这种身份验证机制需要使用基于curl的传输。

字符串

属性中解释的规则，被合并为相对URI的URI RFC 3986标准。当你发出的所有请求都有一个共同的前缀(例如。`https://api.github.com/`)，这样你就可以避免把它添加到每个请求中。

这里有一些常见的例子`base_uri`合并在实践中的工作:

`base_uri` 相对URI 实际请求的URI

http://example.org /酒吧 http://example.org/bar

http://example.org/foo /酒吧 http://example.org/bar

http://example.org/foo 酒吧 http://example.org/bar

http://example.org/foo/ /酒吧 http://example.org/bar

http://example.org/foo/ 酒吧 http://example.org/foo/bar

http://example.org http://欧宝娱乐app下载地址www.oldmanjams.com http://欧宝娱乐app下载地址www.oldmanjams.com

http://example.org/?bar 酒吧 http://example.org/bar

http://example.org/api/v4 /酒吧 http://example.org/bar

http://example.org/api/v4/ /酒吧 http://example.org/bar

http://example.org/api/v4 酒吧 http://example.org/api/bar

http://example.org/api/v4/ 酒吧 http://example.org/api/v4/bar

`base_uri`	相对URI	实际请求的URI
http://example.org	/酒吧	http://example.org/bar
http://example.org/foo	/酒吧	http://example.org/bar
http://example.org/foo	酒吧	http://example.org/bar
http://example.org/foo/	/酒吧	http://example.org/bar
http://example.org/foo/	酒吧	http://example.org/foo/bar
http://example.org	http://欧宝娱乐app下载地址www.oldmanjams.com	http://欧宝娱乐app下载地址www.oldmanjams.com
http://example.org/?bar	酒吧	http://example.org/bar
http://example.org/api/v4	/酒吧	http://example.org/bar
http://example.org/api/v4/	/酒吧	http://example.org/bar
http://example.org/api/v4	酒吧	http://example.org/api/bar
http://example.org/api/v4/	酒吧	http://example.org/api/v4/bar

字符串

网络接口名称、IP地址、主机名或用作传出网络接口的UNIX套接字。

布尔|`关闭`

缓冲响应意味着您可以多次访问其内容，而无需再次执行请求。当响应的内容类型为时，默认启用缓冲`文本/ *`，`application / json`或`应用程序/ xml`．

如果此选项为布尔值，则当值为时，响应将被缓冲`真正的`．如果此选项是闭包，则在返回值为时缓冲响应`真正的`(闭包接收一个带有响应头的数组作为参数)。

字符串

包含一个或多个用于验证其他服务器证书的证书颁发机构文件的路径。

字符串

包含一个或多个证书颁发机构文件的目录的路径。

字符串

SSL/TLS连接所允许的密码名称的列表。它们可以用冒号、逗号或空格分隔。`“RC4-SHA: tls13 - aes - 128 - gcm - sha256”`)．

整数默认的：`1000`

初始延迟(以毫秒为单位)，用于计算重试之间的等待时间。

布尔默认的：`假`

启用HTTP请求失败后重试功能。当配置其中一个子设置时，此设置将自动设置为true。

数组

在发出请求之前添加的HTTP头的关联数组。此值必须使用格式`['header-name' => 'value0, value1，…']`．

数组默认的：DEFAULT_RETRY_STATUS_CODES ()

触发请求重试的HTTP状态代码列表。

字符串|`零`默认的：`零`

通常是要使用的HTTP版本`“1.1”`或`“2.0”`．留给别人吧`零`让Symfon欧宝娱乐app下载地址y自动选择最佳版本。

浮动默认的：`0.1`(必须在0.0和1.0之间)

这个选项增加了延迟的随机性。避免同时向服务器发送多个请求是很有用的。随机度计算为`延迟*抖动`．例如:如果延迟是`1000毫秒`抖动是`0.2`，实际的延迟将是一个数字之间`800`而且`1200`(1000 +/- 20%)。

字符串

控件的文件的路径 PEM格式HTTP客户端使用的证书。这通常与`local_pk`而且`密码`选项。

字符串

属性的文件的路径 PEM格式属性中定义的证书的私钥`local_cert`选择。

整数默认的：`0`

重试之间初始等待的最大毫秒数。使用`0`不限制持续时间。

浮动默认的: 0

请求和响应允许的最大执行时间(以秒为单位)。小于或等于0的值表示它是无限的。

整数默认的：`6`

定义与单个主机同时打开的最大连接数(将“主机”视为“主机名+端口号”对)。此限制也适用于代理连接，其中代理被认为是应用此限制的主机。

整数默认的：`20.`

要遵循的最大重定向数量。使用`0`不遵循任何重定向。

整数默认的：`3.`

失败请求的最大重试次数。当达到最大值时，客户端返回最后接收到的响应。

浮动默认的：`2`

每次重试发生时，这个值乘以延迟，以便及时分配重试，而不是按顺序执行所有重试。

字符串|`零`默认的：`零`

一个以逗号分隔的主机列表，这些主机不需要连接代理(即使配置了代理)。使用`‘*’`通配符匹配所有主机，空字符串匹配任何主机(禁用代理)。

字符串

中定义的文件中用于加密存储在该文件中的证书的密码短语`local_cert`选择。

数组

在协商TLS或SSL连接时，服务器发送一个表明其身份的证书。从该证书中提取公钥，如果它与此选项中提供的任何公钥不完全匹配，则在发送或接收任何数据之前终止连接。

的关联数组`Algorithm =>哈希`(如`['pin-sha256' => '…']`)．

字符串|`零`

用于发出请求的HTTP代理。留给别人吧`零`根据系统配置自动检测代理。

数组

在发出请求之前添加到URL的查询字符串值的关联数组。此值必须使用格式`['parameter-name' => parameter-value，…]`．

数组

主机名及其IP地址的列表，用于预填充HTTP客户端使用的DNS缓存，以避免对这些主机进行DNS查找。此选项有助于在将URL传递给客户端之前检查ip时提高安全性，并使您的测试更容易。

的关联数组`domain => IP地址`(如`['欧宝娱乐app下载地址www.oldmanjams.com' => '46.137.106.254'，…]`)．

字符串

该服务用于决定请求是否应该重试，并计算重试之间的等待时间。的实例 GenericRetryStrategy配置了`http_codes`，`延迟`，`max_delay`，`乘数`而且`抖动`选项。这个类必须实现RetryStrategyInterface．

字符串

仅对于有作用域的客户端:URL在应用所有其他非默认选项之前必须匹配的正则表达式。默认情况下，范围派生自 base_uri．

浮动默认的:取决于你的PHP配置

等待回应的时间，以秒为单位。如果响应时间较长，则a TransportException抛出。它的默认值与PHP的值相同default_socket_timeout配置选项。

布尔默认的：`真正的`

如果`真正的`，验证其他服务器发送的证书，以确保它们的公共名称与URL中包含的主机相匹配。这通常与`verify_peer`还可以验证证书的真实性。

布尔默认的：`真正的`

如果`真正的`，其他服务器在协商TLS或SSL连接时发送的证书将被验证真实性。对证书进行身份验证还不足以确定服务器，因此应该将此与`verify_host`选择。

布尔默认的：`假`

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

请注意

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

布尔默认的：真正的

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

                  1
                  ＄分析器->使();
                 

字符串默认的：`零`

这指定查询参数、主体参数或请求属性的名称，用于启用或禁用分析器对每个请求的数据收集。将其与`收集`选项，以启用/禁用分析器的需求:

如果`收集`选项设置为`真正的`但是此参数存在于请求中，并且具有除`真正的`，`是的`，`在`或`1`，该等资料将不会被收集;

如果`收集`选项设置为`假`，但此参数存在于请求中，值为`真正的`，`是的`，`在`或`1`时，将收集请求数据。

布尔默认的：`假`

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

布尔默认的：`假`

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

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

存储分析信息的DSN。

原型

要创建的速率限制器的名称。

字符串默认值:`lock.factory`

用于创建锁的服务。类的实例 LockFactory类。

字符串要求

要使用的速率限制算法的名称。例如:`fixed_window`，`sliding_window`而且`no_limit`．看到 费率限制政策)，以获取更多资料。

数组默认的：［］

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

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

配置jsonp格式:

YAML
XML
PHP

                    1 2 3 4 5
                    #配置/包/ framework.yaml框架:要求:格式:jsonp:“应用程序/ javascript”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
                    <！--config/packages/framework.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
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->请求()->格式(“jsonp”，“应用程序/ javascript”）;};
                   

字符串要求

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

字符串

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

字符串

用于在非http上下文中生成url的默认URI(参见 在命令中生成url)．

整数默认的：`80`

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

整数默认的：`443`

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

混合默认的：`真正的`

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

取值为:

`真正的`

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

`假`

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

`零`

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

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

布尔默认的：`真正的`

当此选项设置为`真正的`的正则表达式 路由参数要求将使用utf - 8修饰符．例如，这将在使用时匹配任何UTF-8字符`．`，而不是只匹配一个字节。

如果应用程序的字符集是UTF-8(如getCharset()方法您的内核)建议将其设置为`真正的`．这将使非utf8 url产生404错误。

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

对象时使用的服务IDSessionStorageInterface它存储会话。该服务可在Symfony应用程序中通过欧宝娱乐app下载地址session.storage.factory服务别名。该类必须实现 SessionStorageFactoryInterface．要查看所有可用存储的列表，运行:

                  1
                  ＄PHP bin/console调试:container session.storage.factory。
                 

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

会话存储使用的服务id。默认值`“session.handler.native_file”`将允许Symfon欧宝娱乐app下载地址y使用文件来存储会话元数据来管理会话本身。设置为`零`使用原生PHP会话机制。你也可以 将会话存储在数据库中．

字符串默认的：`零`

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

字符串或int默认的：”

如果设置为0时，欧宝娱乐app下载地址Symfony不会设置任何与缓存相关的特定头文件，它将依赖于 session.cache-limiterphp . ini选项。

与其他会话选项不同，cache_limiter设置为常规容器参数：

YAML
XML
PHP

                    1 2 3 4
                    #配置/ services.yaml参数:session.storage.options:cache_limiter:0
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/services.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”xsi: schemaLocation＝“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd”><参数><参数关键＝“session.storage.options”类型＝“收集”><参数关键＝“cache_limiter”>0参数>参数>参数>容器>
                   

                    1 2 3 4
                    / /配置/ services.php＄容器->setParameter (“session.storage.options”, (“cache_limiter”= >0]);
                   

整数默认的：`One hundred.`

看到 gc_probability．

整数默认的：`1`

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

整数默认的：`1440`

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

整数默认的：`32`

这决定了会话ID字符串的长度，可以是之间的整数`22`而且`256`(两者都包括在内)，是`32`推荐值。较长的会话id更难猜测。

该选项与 会话。sid_length PHP选项．

整数默认的：`4`

这决定了已编码会话ID字符中的比特数。可能的值为`4`f (0 - 9),`5`(0-9, a-v)，和`6`(0-9, a-z, a-z， "-"， "，")。比特数越多，会话ID越强。`5`是大多数环境的推荐值。

该选项与 会话。sid_bits_per_character PHP选项．

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

这决定了要传递给保存处理程序的参数。如果选择默认文件处理程序，则这是创建会话文件的路径。

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

YAML
XML
PHP

                    1 2 3 4
                    #配置/包/ framework.yaml框架:会话:save_path:～
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/packages/framework.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
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->会话()->savePath (零）;};
                   

整数默认的：`0`

这是在更新/写入会话元数据之间等待的秒数。如果出于某种原因，您希望限制会话持续的频率，而不是对每个请求都这样做，那么这可能很有用。

布尔默认的：真正的

是否在框架中启用会话支持。

YAML
XML
PHP

                    1 2 3 4
                    #配置/包/ framework.yaml框架:会话:启用:真正的
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/packages/framework.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
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->会话()->启用(真正的）;};
                   

布尔默认的：`零`

这指定会话ID是否使用cookie存储在客户端。方法中定义的值`php . ini`与`session.use_cookies`指令。

字符串

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

YAML
XML
PHP

                    1 2 3 4 5
                    #配置/包/ framework.yaml框架:#……资产:base_path:' /图片'
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/packages/framework.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 8
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛/ /……＄框架->资产()->basePath (' /图片'）;};
                   

数组

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

YAML
XML
PHP

                    1 2 3 4 5 6
                    #配置/包/ framework.yaml框架:#……资产:base_url:-“http://cdn.example.com/”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/packages/framework.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 8
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛/ /……＄框架->资产()->baseurl ([“http://cdn.example.com/”]);};
                   

YAML
XML
PHP

                    1 2 3 4 5 6 7
                    #配置/包/ framework.yaml框架:#……资产:包:头像:base_url:“http://static_cdn.example.com/avatars”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                    <！--config/packages/framework.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
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛/ /……＄框架->资产()->包(“阿凡达”）->baseurl ([“http://static_cdn.example.com/avatars”]);};
                   

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

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

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

字符串

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

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

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

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

YAML
XML
PHP

                    1 2 3 4 5
                    #配置/包/ framework.yaml框架:#……资产:版本:“v2”
                   

                    12 3 4 5 6 7 8 9 10 11 12 13
                    <！--config/packages/framework.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 8
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛/ /……＄框架->资产()->版本(“v2”）;};
                   

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

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

请注意

与不能同时设置version_strategy或json_manifest_path．

提示

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

字符串默认的：`% % 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访问，则后一个选项非常有用。

字符串默认的：零

的服务id 资产版本策略应用于资产。该选项可以为所有资产全局设置，也可以为每个资产包单独设置:

YAML
XML
PHP

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15
                    #配置/包/ framework.yaml框架:资产:这个策略适用于所有资产(包括包)version_strategy:“app.asset.my_versioning_strategy”包:foo_package:#这个包删除任何版本控制(它的资产不会被版本控制)版本:～bar_package:#这个包使用它自己的策略(默认的策略被忽略)version_strategy:“app.asset.another_version_strategy”baz_package:#此包继承默认策略base_path:' /图片'
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
                    <！--config/packages/framework.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”><框架:配置><框架:资产version-strategy＝“app.asset.my_versioning_strategy”><！--this package removes any versioning (its assets won't be versioned) --><框架:包的名字＝“foo_package”版本＝“零”/><！--this package uses its own strategy (the default strategy is ignored) --><框架:包的名字＝“bar_package”version-strategy＝“app.asset.another_version_strategy”/><！--this package inherits the default strategy --><框架:包的名字＝“baz_package”base_path＝“/图片”/>框架:资产>框架:配置>容器>
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛/ /……＄框架->资产()->versionStrategy (“app.asset.my_versioning_strategy”）;＄框架->资产()->包(“foo_package”）//这个包删除任何版本控制(它的资产不会被版本控制)->版本(零）;＄框架->资产()->包(“bar_package”）//这个包使用它自己的策略(默认策略被忽略)->versionStrategy (“app.asset.another_version_strategy”）;＄框架->资产()->包(“baz_package”）//该包继承默认策略->basePath (' /图片'）;};
                   

请注意

与不能同时设置版本或json_manifest_path．

字符串默认的：零

的文件路径或绝对URLmanifest.json文件，其中包含资产名称及其各自编译后的名称的关联数组。使用“清单”文件的常见缓存破坏技术是通过在资产的文件名后面附加一个“散列”来实现的。main.ae433f1cb.css)在前端编译程序期间。

提示

欧宝娱乐app下载地址Symfony的 Webpack安可支持输出散列资产．此外，这可以合并到许多其他工作流中，包括使用Webpack和Gulpwebpack-manifest-plugin而且gulp-rev,分别。

该选项可以为所有资产全局设置，也可以为每个资产包单独设置:

YAML
XML
PHP

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16
                    #配置/包/ framework.yaml框架:资产:#此清单应用于每个资产(包括包)json_manifest_path:“% kernel.project_dir % /公共/构建/ manifest.json”#你也可以使用绝对url, Symfony会自动下载它们欧宝娱乐app下载地址# json_manifest路径:'https://cdn.example.com/manifest.json'包:foo_package:#这个包使用它自己的manifest(默认文件被忽略)json_manifest_path:“% kernel.project_dir % /公共/构建/ a_different_manifest.json”当在清单中没有找到资产时抛出异常strict_mode:% kernel.debug %bar_package:#这个包使用全局清单(使用默认文件)base_path:' /图片'
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
                    <！--config/packages/framework.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”><框架:配置><！--this manifest is applied to every asset (including packages) --><框架:资产json-manifest-path＝“% kernel.project_dir % /公共/构建/ manifest.json”><！--you can use absolute URLs too and Symfony will download them automatically --><！--<框架:资产json-manifest-path＝＂https://cdn.example.com/manifest.json"> --><！--this package uses its own manifest (the default file is ignored) --><！--Throws an exception when an asset is not found in the manifest --><框架:包的名字＝“foo_package”json-manifest-path＝“% kernel.project_dir % /公共/构建/ a_different_manifest.json”严格模式＝“% kernel.debug %”/><！--this package uses the global manifest (the default file is used) --><框架:包的名字＝“bar_package”基本路径＝“/图片”/>框架:资产>框架:配置>容器>
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20 21
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛/ /……＄框架->资产()//该清单应用于每个资产(包括包)->jsonManifestPath (' % kernel.project_dir % /公共/构建/ manifest.json”）;//你也可以使用绝对url, Symfony会自动下载欧宝娱乐app下载地址// 'json_manifest_path' => 'https://cdn.example.com/manifest.json'，＄框架->资产()->包(“foo_package”）//这个包使用它自己的manifest(默认文件被忽略)->jsonManifestPath (' % kernel.project_dir % /公共/构建/ a_different_manifest.json”）//当manifest中没有资产时抛出异常->setStrictMode (“% kernel.debug %”）;＄框架->资产()->包(“bar_package”）//这个包使用全局清单(使用默认文件)->basePath (' /图片'）;};
                   

请注意

与不能同时设置版本或version_strategy．此外，如果指定了全局清单文件，则此选项不能在包范围内为空。

提示

如果你申请资产，那就是没有找到在manifest.json文件，原-未修改的- asset path返回值。从Symfo欧宝娱乐app下载地址ny 5.4开始，您可以设置strict_mode来真正的以在资产为时获取异常没有找到．

请注意

方法在每个请求上下载JSON清单http_client．

字符串|数组默认的:值 default_locale

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

另请参阅

详情请参见翻译．

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

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

字符串默认的：`translator.formatter.default`

用于格式化翻译消息的服务的ID。服务类必须实现 MessageFormatterInterface．

数组默认的：`［］`

此选项允许定义一个路径数组，组件将在其中查找翻译文件。添加的路径越晚，它的优先级就越高(从较晚路径转换而来的路径会覆盖较早路径)。翻译自 default_path优先级高于所有这些路径的转换。

字符串默认的：`% kernel.project_dir % /翻译`

此选项允许定义存储应用程序翻译文件的路径。

数组默认的：`［］`

此选项启用和配置 翻译服务提供商将您的翻译推送到第三方翻译服务。

布尔默认的：`假`

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

布尔默认的：`真正的`

启用时，`property_accessor`服务使用PHP的 神奇的__get()方法当它`getValue ()`方法。

布尔默认的：`真正的`

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

NotCompromisedPasswordconstraint向公共API发出HTTP请求，以检查给定的密码是否在数据泄露中被泄露。

布尔默认的：`真正的`

如果将此选项设置为`假`，将不会发出任何HTTP请求，所提供的密码将被视为有效。这在您不想或不能发出HTTP请求时非常有用，例如in`dev`而且`测验`环境或持续集成服务器。

字符串默认的：`零`

默认情况下，NotCompromisedPassword约束提供的公共APIhaveibeenpwned.com．此选项允许定义不同但兼容的API端点来进行密码检查。例如，当Symfony应用程序在没有公共访问internet的内部欧宝娱乐app下载地址网中运行时，它就很有用。

字符串|数组默认的：`(“loadValidatorMetadata”)`

定义静态方法的名称，该方法被调用以加载类的验证元数据。您可以用几个方法的名称定义一个字符串数组。在这种情况下，将按此顺序调用它们来加载元数据。

字符串默认的：`宽松的`

属性的默认值 电子邮件验证器的“mode”选项．

数组默认的：[' config /验证/ ']

这个选项允许定义一个包含文件或目录的路径数组，组件将在其中查找其他验证文件:

YAML
XML
PHP

                     1 2 3 4 5 6
                     #配置/包/ framework.yaml框架:验证:映射:道路:-“% kernel.project_dir % / config /验证/”
                    

                     12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                     <！--config/packages/framework.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”><框架:配置><框架:验证><框架:映射><框架:路径>% kernel.project_dir % / config /验证/框架:路径>框架:映射>框架:验证>框架:配置>容器>
                    

                     1 2 3 4 5 6 7 8
                     / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->验证()->映射()->路径([' % kernel.project_dir % / config /验证/]);};
                    

字符串默认的：`“php_array”`

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

php_array

使用PHP数组在内存中缓存注释

文件

使用文件系统缓存注释

没有一个

禁用注释缓存

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

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

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

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

布尔默认的：`真正的`或`假`取决于您的安装

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

布尔默认的：`假`

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

另请参阅

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

字符串

要使用的名称转换器。的 CamelCaseToSnakeCaseNameConverter名称转换器可以通过使用`serializer.name_converter.camel_case_to_snake_case`价值。

另请参阅

有关更多信息，请参见Serializer组件．

字符串

用作默认序列化程序的循环引用处理程序的服务id。服务必须实现这种魔力`美元__invoke(对象)`方法。

另请参阅

有关更多信息，请参见 Serializer组件．

数组默认的：`［］`

此选项允许定义包含文件或目录的路径数组，组件将在其中查找其他序列化文件。

数组默认的：`［］`

带有默认上下文选项的映射，将与每个选项一起使用`序列化`而且`反序列化`调用。这可以用于设置json编码行为`json_encode_options`到一个 Json_encode标记位掩码．

布尔| int默认的：% kernel.debug %

使用应用程序记录器而不是PHP记录器记录PHP错误。当使用整数值时，还可以设置日志级别。中使用的整数值必须相同 error_reporting PHP选项．

该选项还接受PHP错误到日志级别的映射:

YAML
XML
PHP

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
                    #配置/包/ framework.yaml框架:php_errors:日志:”!php / const \ E_DEPRECATED '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_USER_DEPRECATED '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_NOTICE '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_USER_NOTICE '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \代码”：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_WARNING '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_USER_WARNING '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_COMPILE_WARNING '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_CORE_WARNING '：php !/常量Psr \ Log \ LogLevel:错误”!php / const \ E_USER_ERROR '：php !/常量Psr \ Log \ LogLevel:至关重要的”!php / const \ E_RECOVERABLE_ERROR '：php !/常量Psr \ Log \ LogLevel:至关重要的”!php / const \ E_COMPILE_ERROR '：php !/常量Psr \ Log \ LogLevel:至关重要的”!php / const \ E_PARSE '：php !/常量Psr \ Log \ LogLevel:至关重要的”!php / const \ E_ERROR '：php !/常量Psr \ Log \ LogLevel:至关重要的”!php / const \ E_CORE_ERROR '：php !/常量Psr \ Log \ LogLevel:至关重要的
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
                    <！--config/packages/framework.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”><框架:配置><！--in XML configuration you cannot use PHP constants as the value of the 'type' attribute, which makes this format way less readable. Consider using YAML or PHP for this configuration --><框架:日志类型＝“8”logLevel＝“错误”/><框架:日志类型＝“2”logLevel＝“错误”/><！--．．．-->框架:配置>容器>
                   

                    1 2 3 4 5 6 7 8 9
                    / /配置/包/ framework.php使用Psr＼日志＼LogLevel；使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->phpErrors ()->日志(\ E_DEPRECATED LogLevel：：错误);＄框架->phpErrors ()->日志(\ E_USER_DEPRECATED LogLevel：：错误);/ /……};
                   

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

抛出PHP错误`\ ErrorException`实例。的参数`debug.error_handler.throw_at`控制阈值。

字符串默认的：`cache.adapter.filesystem`

控件使用的缓存适配器`cache.app`服务。FrameworkBundle附带了多个适配器:`cache.adapter.apcu`，`cache.adapter.doctrine`，`cache.adapter.system`，`cache.adapter.filesystem`，`cache.adapter.psr6`，`cache.adapter.redis`，`cache.adapter.memcached`而且`cache.adapter.pdo`．

还有一种特殊的适配器叫做`cache.adapter.array`它使用PHP数组在内存中存储内容，并用于禁用缓存(主要是在`dev`环境)。

提示

一开始可能很难理解，因此为了避免混淆，请记住所有池都执行相同的操作，但根据它们所基于的适配器，它们在不同的介质上执行。在内部，池包装了适配器的定义。

另请参阅

有关池如何工作的详细信息，请参见缓存池．

使用实例配置Redis缓存池的默认生存时间为1小时。

YAML
XML
PHP

                    1 2 3 4 5 6 7
                    #配置/包/ framework.yaml框架:缓存:池:cache.mycache:适配器:cache.adapter.redisdefault_lifetime:3600
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20
                    <！--config/packages/framework.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”><框架:配置><框架:缓存><框架:池的名字＝“cache.mycache”适配器＝“cache.adapter.redis”default-lifetime＝“3600”/>框架:缓存><！--．．．-->框架:配置>容器>
                   

                    1 2 3 4 5 6 7 8 9
                    / /配置/包/ framework.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->缓存()->池(“cache.mycache”）->适配器([“cache.adapter.redis”])->defaultLifetime (3600）;};
                   

原型

要创建的存储池名称。

请注意

您的存储池名称不能与`cache.app`或`cache.system`．

字符串默认的：`cache.app`

要使用的适配器的服务名称。您可以指定遵循该模式的默认服务之一`cache.adapter[型]。`．或者，您可以指定另一个缓存池作为基准，这将使该缓存池从基准池继承设置作为默认值。

请注意

您的服务必须实现`Psr \ \ CacheItemPoolInterface缓存`接口。

布尔默认的：`假`

你的服务是否应该公开。

布尔|`字符串`默认的：`零`

您的服务是否应该能够处理标记。也可以是存储标记的另一个缓存池的服务id。

整数|`字符串`

缓存项的默认生存期。给出一个整数值，以秒为单位设置默认的生存期。字符串值可以是ISO 8601时间间隔，例如`“PT5M”`或被接受的PHP日期表达式`strtotime ()`,就像`“5分钟”`．

如果没有提供任何值，缓存适配器将回退到实际缓存存储上的默认值。

字符串

如果您不想使用配置为的服务名称或DSN，请分别覆盖默认的服务名称或DSN`default_X_provider`下`缓存`．有关如何指定特定的提供程序的信息，请参阅上面默认提供程序设置的描述。

字符串

缓存清除器用于清除PSR-6缓存。

另请参阅

有关更多信息，请参见 Psr6CacheClearer．

字符串默认的：`_ % kernel.project_dir % % kernel.container_class %`

此值用作为缓存项键生成的“命名空间”的一部分。一种常见的做法是使用应用程序的唯一名称(例如。`欧宝娱乐app下载地址www.oldmanjams.com`)，因为当将多个应用程序部署到共享同一个缓存后端的同一路径(在不同的服务器上)时，可以防止命名冲突。

它在使用时也很有用 蓝色/绿色部署策略，更一般地，当您需要抽象出实际的部署目录时(例如，当脱机加热缓存时)。

字符串|数组

默认的锁适配器。如果没有定义，则设置为信号量有空时，或去群否则。商店的深网也是允许的。

布尔默认的：`真正的`

是否启用对锁的支持。此设置将自动设置为`真正的`当配置了其中一个子设置时。

数组

由框架扩展创建的锁存储列表。

YAML
XML
PHP

                    1 2 3
                    #配置/包/ lock.yaml框架:锁:' % env (LOCK_DSN) %
                   

                    12 3 4 5 6 7 8 9 10 11 12 13 14 15
                    <！--config/packages/lock.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”><框架:配置><框架:锁><框架:资源>% env (LOCK_DSN) %框架:资源>框架:锁>框架:配置>容器>
                   

                    1 2 3 4 5 6 7
                    / /配置/包/ lock.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->lock ()->资源(“默认”[env (“LOCK_DSN”)));};
                   

另请参阅

详情请参见使用锁处理并发性．

原型

要创建的锁的名称。

字符串默认的：`零`

邮件发送者使用的DSN。当可以使用多个DSN时，请使用`传输`选项(见下文)。

数组

一个 深网列表这可以被邮寄者使用。传输名称是键，dsn是值。

字符串默认的：`零`或默认总线(如果安装了Messenger组件)

消息总线的服务标识符 通讯组件(如。`messenger.default_bus`)．

字符串

的值，即“信封发送者”`邮件从`在 SMTP会话．此值将覆盖代码中设置的任何其他发送方。

数组

作为值的“信封收件人”收件人在 SMTP会话．此值将覆盖代码中设置的任何其他收件人。

YAML
XML
PHP

                     1 2 3 4 5 6
                     #配置/包/ mailer.yaml框架:梅勒:dsn:的smtp: / / localhost: 25信封:收件人:(“admin@欧宝娱乐app下载地址www.oldmanjams.com”,“lead@欧宝娱乐app下载地址www.oldmanjams.com”］
                    

                     12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                     <！--config/packages/mailer.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”><框架:配置><框架:梅勒dsn＝“smtp: / / localhost: 25><框架:信封><框架:收件人>admin@欧宝娱乐app下载地址www.oldmanjams.com框架:收件人><框架:收件人>lead@欧宝娱乐app下载地址www.oldmanjams.com框架:收件人>框架:信封>框架:梅勒>框架:配置>容器>
                    

                     12 3 4 5 6 7 8 9 10 11 12 13 14 15 16
                     / /配置/包/ mailer.php名称空间欧宝娱乐app下载地址＼组件＼DependencyInjection＼加载程序＼配置器；返回静态函数(ContainerConfigurator＄containerConfigurator）：无效｛＄containerConfigurator->扩展(“框架”, (“梅勒”= > [“dsn”= >的smtp: / / localhost: 25，“信封”= > [“收件人”= > [“admin@欧宝娱乐app下载地址www.oldmanjams.com”，“lead@欧宝娱乐app下载地址www.oldmanjams.com”，]，]，]，]);};
                    

数组

要添加到电子邮件中的标题。钥匙(`的名字`属性(XML格式)是头名称，值是头值。

另请参阅

有关更多信息，请参见 全局配置邮件

布尔默认的：`真正的`或`假`取决于您的安装

添加一个 链接HTTP报头回应。

数组

一个由框架扩展创建的工作流列表:

YAML
XML
PHP

                   1 2 3 4 5
                   #配置/包/ workflow.yaml框架:工作流程:my_workflow:#……
                  

                   12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                   <！--config/packages/workflow.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”><框架:配置><框架:工作流><框架:工作流的名字＝“my_workflow”/>框架:工作流><！--．．．-->框架:配置>容器>
                  

                   1 2 3 4 5 6 7 8 9
                   / /配置/包/ workflow.php使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->工作流()->工作流(“my_workflow”）/ /……；};
                  

另请参阅

另见文章在Symfony应用程序中使用工作流欧宝娱乐app下载地址．

布尔默认的：`假`

是否启用工作流支持。此设置将自动设置为`真正的`当配置了其中一个子设置时。

原型

要创建的工作流的名称。

布尔

如果设置为`真正的`,AuditTrailListener将被启用。

字符串|`数组`

其中之一`的地方`或`空`．如果不为空，并且支持的对象还没有通过工作流初始化，则将设置此位置。

数组

每个标记商店都可以定义以下选项:

`参数`（类型：`数组`）

`服务`（类型：`字符串`）

`类型`（类型：`字符串`允许的值：`“方法”`）

数组

可用于工作流配置的元数据。请注意,`的地方`而且`转换`还能有自己的吗`元数据`条目。

数组

所有可用名额(类型：`字符串`)，以配置工作流。

字符串|`数组`

工作流配置支持的对象的FQCN(全限定类名)，如果支持多个对象，则为FQCN数组。

字符串

数组

每个标记商店都可以定义以下选项:

`从`（类型：`字符串`或`数组`)的值`的地方`，两者都允许有多个值`工作流`而且`state_machine`；

`警卫`（类型：`字符串`)一个 ExpressionLanguage兼容表达，阻挡过渡;

`的名字`（类型：`字符串`)过渡的名称;

`来`（类型：`字符串`或`数组`)的值`的地方`，只允许为多个值`工作流`．

字符串可能的值：`“工作流程”`或`“state_machine”`

定义将要创建的工作流类型，可以是普通工作流，也可以是状态机。读 这篇文章了解他们的不同。

数组

定义了日志级别以及应用于匹配给定异常类的异常的HTTP状态代码:

YAML
XML
PHP

                   1 2 3 4 5 6
                   #配置/包/ exceptions.yaml框架:例外:欧宝娱乐app下载地址Symfony \组件\ HttpKernel \ \ BadRequestHttpException异常:log_level:“调试”status_code:422
                  

                   12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
                   <！--config/packages/exceptions.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”><框架:配置><框架:异常类＝“欧宝娱乐app下载地址Symfony \ HttpKernel \异常\ \组件BadRequestHttpException”进行日志级别＝“调试”状态码＝“422”/><！--．．．-->框架:配置>容器>
                  

                   1 2 3 4 5 6 7 8 9 10
                   / /配置/包/ exceptions.php使用欧宝娱乐app下载地址＼组件＼HttpKernel＼异常＼BadRequestHttpException；使用欧宝娱乐app下载地址＼配置＼FrameworkConfig；返回静态函数(FrameworkConfig＄框架）｛＄框架->异常(BadRequestHttpException：：类)->logLevel (“调试”）->statusCode (422);};
                  

配置异常的顺序很重要，因为Symfony将使用第一个匹配的异常的配置欧宝娱乐app下载地址运算符：

                 1 2 3 4 5 6 7 8 9 10
                 #配置/包/ exceptions.yaml框架:例外:例外:log_level:“调试”status_code:404下面的配置永远不会被使用，因为\RuntimeException扩展了\ExceptionRuntimeException:log_level:“调试”status_code:422
                

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

框架配置参考(FrameworkBundle)

trusted_headers当在负载均衡器或反向代理后运行Symfony时，需要配置哪些客户端信息应该被信任(例如他们的主机)。欧宝娱乐app下载地址看到如何配置Symfony在负载均衡器欧宝娱乐app下载地址或反向代理后工作．

trusted_proxies当在负载均衡器或反向代理后运行Symfony时，需要一个选项来获得关于客户端的精确信息(例如他们的IP地址)。欧宝娱乐app下载地址看到如何配置Symfony在负载均衡器欧宝娱乐app下载地址或反向代理后工作．

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

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

字符串默认的：error_controller 这是当应用程序中的任何地方抛出异常时调用的控制器。默认控制器(ErrorController)在不同的错误条件下呈现特定的模板(参见如何自定义错误页面)．

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

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

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

字符串 用于创建的用户名和密码授权类中使用的HTTP头微软NTLM认证协议．该选项的取值必须遵循如下格式用户名:密码．这种身份验证机制需要使用基于curl的传输。

数组默认的：DEFAULT_RETRY_STATUS_CODES () 触发请求重试的HTTP状态代码列表。

字符串 控件的文件的路径PEM格式HTTP客户端使用的证书。这通常与local_pk而且密码选项。

字符串 属性的文件的路径PEM格式属性中定义的证书的私钥local_cert选择。

字符串 该服务用于决定请求是否应该重试，并计算重试之间的等待时间。的实例GenericRetryStrategy配置了http_codes，延迟，max_delay，乘数而且抖动选项。这个类必须实现RetryStrategyInterface．

字符串 仅对于有作用域的客户端:URL在应用所有其他非默认选项之前必须匹配的正则表达式。默认情况下，范围派生自base_uri．

浮动默认的:取决于你的PHP配置 等待回应的时间，以秒为单位。如果响应时间较长，则aTransportException抛出。它的默认值与PHP的值相同default_socket_timeout配置选项。

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

原型 要创建的速率限制器的名称。 字符串默认值:lock.factory 用于创建锁的服务。类的实例LockFactory类。 字符串要求 要使用的速率限制算法的名称。例如:fixed_window，sliding_window而且no_limit．看到费率限制政策)，以获取更多资料。

原型 要创建的速率限制器的名称。 字符串默认值:lock.factory 用于创建锁的服务。类的实例LockFactory类。 字符串要求 要使用的速率限制算法的名称。例如:fixed_window，sliding_window而且no_limit．看到费率限制政策)，以获取更多资料。

字符串默认值:lock.factory 用于创建锁的服务。类的实例LockFactory类。

字符串要求 要使用的速率限制算法的名称。例如:fixed_window，sliding_window而且no_limit．看到费率限制政策)，以获取更多资料。

字符串 用于在非http上下文中生成url的默认URI(参见在命令中生成url)．

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

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

整数默认的：32 这决定了会话ID字符串的长度，可以是之间的整数22而且256(两者都包括在内)，是32推荐值。较长的会话id更难猜测。 该选项与会话。sid_length PHP选项．

整数默认的：4 这决定了已编码会话ID字符中的比特数。可能的值为4f (0 - 9),5(0-9, a-v)，和6(0-9, a-z, a-z， "-"， "，")。比特数越多，会话ID越强。5是大多数环境的推荐值。 该选项与会话。sid_bits_per_character PHP选项．

字符串|数组默认的:值default_locale 当没有找到当前语言环境的翻译键时使用此选项。 另请参阅 详情请参见翻译．

字符串默认的：translator.formatter.default 用于格式化翻译消息的服务的ID。服务类必须实现MessageFormatterInterface．

数组默认的：［］ 此选项允许定义一个路径数组，组件将在其中查找翻译文件。添加的路径越晚，它的优先级就越高(从较晚路径转换而来的路径会覆盖较早路径)。翻译自default_path优先级高于所有这些路径的转换。

数组默认的：［］ 此选项启用和配置翻译服务提供商将您的翻译推送到第三方翻译服务。

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

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

布尔默认的：真正的 启用时，property_accessor服务使用PHP的神奇的__get()方法当它getValue ()方法。

布尔默认的：真正的 启用时，property_accessor服务使用PHP的Magic __set()方法当它setValue ()方法。

字符串默认的：宽松的 属性的默认值电子邮件验证器的“mode”选项．

布尔

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

另请参阅

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

另请参阅

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

字符串默认的：`error_controller`

这是当应用程序中的任何地方抛出异常时调用的控制器。默认控制器(ErrorController)在不同的错误条件下呈现特定的模板(参见如何自定义错误页面)．

另请参阅

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

另请参阅

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

字符串默认的：`零`

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

另请参阅

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

字符串

用于创建的用户名和密码`授权`类中使用的HTTP头微软NTLM认证协议．该选项的取值必须遵循如下格式`用户名:密码`．这种身份验证机制需要使用基于curl的传输。

数组默认的：DEFAULT_RETRY_STATUS_CODES ()

触发请求重试的HTTP状态代码列表。

字符串

控件的文件的路径 PEM格式HTTP客户端使用的证书。这通常与`local_pk`而且`密码`选项。

字符串

属性的文件的路径 PEM格式属性中定义的证书的私钥`local_cert`选择。

字符串

该服务用于决定请求是否应该重试，并计算重试之间的等待时间。的实例 GenericRetryStrategy配置了`http_codes`，`延迟`，`max_delay`，`乘数`而且`抖动`选项。这个类必须实现RetryStrategyInterface．

字符串

仅对于有作用域的客户端:URL在应用所有其他非默认选项之前必须匹配的正则表达式。默认情况下，范围派生自 base_uri．

浮动默认的:取决于你的PHP配置

等待回应的时间，以秒为单位。如果响应时间较长，则a TransportException抛出。它的默认值与PHP的值相同default_socket_timeout配置选项。

字符串默认值:`lock.factory`

用于创建锁的服务。类的实例 LockFactory类。

字符串要求

要使用的速率限制算法的名称。例如:`fixed_window`，`sliding_window`而且`no_limit`．看到费率限制政策)，以获取更多资料。

字符串

用于在非http上下文中生成url的默认URI(参见在命令中生成url)．

整数默认的：`One hundred.`

看到 gc_probability．

整数默认的：`1440`

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

整数默认的：`32`

这决定了会话ID字符串的长度，可以是之间的整数`22`而且`256`(两者都包括在内)，是`32`推荐值。较长的会话id更难猜测。

该选项与会话。sid_length PHP选项．

整数默认的：`4`

这决定了已编码会话ID字符中的比特数。可能的值为`4`f (0 - 9),`5`(0-9, a-v)，和`6`(0-9, a-z, a-z， "-"， "，")。比特数越多，会话ID越强。`5`是大多数环境的推荐值。

该选项与会话。sid_bits_per_character PHP选项．

字符串|数组默认的:值 default_locale

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

另请参阅

详情请参见翻译．

字符串默认的：`translator.formatter.default`

用于格式化翻译消息的服务的ID。服务类必须实现 MessageFormatterInterface．

数组默认的：`［］`

此选项允许定义一个路径数组，组件将在其中查找翻译文件。添加的路径越晚，它的优先级就越高(从较晚路径转换而来的路径会覆盖较早路径)。翻译自 default_path优先级高于所有这些路径的转换。

数组默认的：`［］`

此选项启用和配置翻译服务提供商将您的翻译推送到第三方翻译服务。

布尔默认的：`假`

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

布尔默认的：`假`

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

布尔默认的：`真正的`

启用时，`property_accessor`服务使用PHP的神奇的__get()方法当它`getValue ()`方法。

布尔默认的：`真正的`

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

字符串默认的：`宽松的`

属性的默认值电子邮件验证器的“mode”选项．