框架配置引用(FrameworkBundle)

               1 2 3 4 5
               #显示默认的配置值定义为Symfony欧宝娱乐app下载地址美元php bin /控制台配置:dump-reference框架#显示您的应用程序所使用的实际配置值美元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下载地址用这个值来加密中使用的饼干 记得我的功能当使用和创建签署uri应急服务国际公司(边缘方面包括)。这就是为什么你应该把这个值,就像它是一个敏感的凭据从来没有把它公开。

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

与其他任何与安全相关的参数,这是一个很好的练习来改变这个值的时候。然而,请记住,改变这个值将使所有签署的uri和记住我的饼干。这就是为什么改变这个值之后,你应该重新生成应用程序缓存和注销用户的所有应用程序。

布尔默认的:`假`

如果设置为`真正的`,Symfo欧宝娱乐app下载地址ny内核将捕获所有`\ Throwable`应用程序抛出的异常并将变成HTTP回应。

从7.0 Symfony开始欧宝娱乐app下载地址,这个选项的默认值`真正的`。

6.2

的`handle_all_throwables`选项是在Symfony 6.2中引入的。欧宝娱乐app下载地址


布尔默认的:`假`

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

如果这是真的,异常被抛出当事情出错。否则,缓存将试图进行并提供一个有意义的反应。

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

“短”,一个简洁的跟踪的主要请求将被添加作为一个HTTP头。“全部”将为所有请求添加痕迹(包括ESI subrequests)。(默认:“完整的”如果在调试;“没有”否则)

字符串

标题名称使用的痕迹。(默认值:X-Symfo欧宝娱乐app下载地址ny-Cache)

整数

的秒数缓存条目应该是新鲜的,没有提供明确的新鲜度信息的反应。明确的cache - control或到期头覆盖这个值。(默认值:0)

数组

请求头,触发“私人”cache - control行为反应不明确状态响应是否公共或私人通过cache - control指令。(默认值:授权和饼干)

数组默认的:`set - cookie`

组永远不会被缓存的响应头即使响应缓存和公众。

6.3

的`skip_response_headers`选项是在Symfony 6.3中引入的。欧宝娱乐app下载地址

字符串

指定客户端是否可以强制刷新缓存的请求中包括一个cache - control“no - cache指令”。将其设置为`真正的`为符合RFC 2616。(默认值:false)

字符串

指定客户端是否可以强制缓存重新验证,包括一个cache - control "信息= 0”指令的要求。将其设置为`真正的`为符合RFC 2616。(默认值:false)

整数

指定默认的秒数(粒度是第二个TTL精确的响应是一个秒)中缓存可以立即返回一个陈旧的响应而重新验证它在后台(默认值:2)。该设置被stale-while-revalidate HTTP cache - control扩展(RFC 5861)。

整数

指定默认的秒数(粒度是第二)的缓存可以一个陈旧的响应时遇到一个错误(默认值:60)。这个设置是由stale-if-error覆盖的HTTP cache - control扩展(RFC 5861)。

布尔默认的:`真正的`

如果`真正的`,kernel.terminate事件分派即使缓存。

除非你的应用程序需要处理事件缓存命中率,这是推荐的设置`假`提高性能,因为它避免了必须引导Symfony框架缓存命中。欧宝娱乐app下载地址

6.2

的`terminate_on_cache_hit`选项是在Symfony 6.2中引入的。欧宝娱乐app下载地址

6.2

设置`terminate_on_cache_hit`选项`真正的`被弃用

欧宝娱乐app下载地址Symfony 6.2和7.0在Symfony的选项将被删除。

布尔默认的(见下面的解释)

这决定了_method请求参数是用作POST请求的HTTP方法。如果启用,要求::enableHttpMethodParameterOverride方法自动被调用。它成为服务容器参数命名kernel.http_method_override。

的默认值是:

真正的如果您有一个现有的应用程序,你已经从一个年长的Symfony升级版本不同步欧宝娱乐app下载地址欧宝娱乐app下载地址Symfony Flex食谱;
假,如果您已经创建了一个新的Symfony应用程序或更欧宝娱乐app下载地址新Symfony Flex食谱。这也是默认值从7.0 Symfony。欧宝娱乐app下载地址

6.1

不设置这个选项的值显式地弃用,因为Symfony 6.1因为默认值将会改变欧宝娱乐app下载地址假在Sy欧宝娱乐app下载地址mfony 7.0。

另请参阅

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

谨慎

如果你使用HttpCache反向代理

使用该选项时,内核会忽略_method参数,这可能导致错误。

为了解决这个问题,调用enableHttpMethodParameterOverride ()方法在创建请求对象:

                    1 2 3 4 5 6 7 8
                    / /公共/ index . php/ /……美元内核=新CacheKernel (美元内核);请求::enableHttpMethodParameterOverride ();/ / <——添加这一行美元请求=请求::createFromGlobals ();/ /……
                   

布尔默认的:`假`

6.1

的`trust_x_sendfile_type_header`选项是在Symfony 6.1中引入的。欧宝娱乐app下载地址

`X-Sendfile`是一个特殊的HTTP头告诉web服务器来代替定义的响应内容的文件头。这可以提高性能,因为文件不再服务于你的应用程序,但是直接由web服务器。

这个配置选项决定是否信任`x-sendfile`BinaryFileResponse头。如果启用,Symfony欧宝娱乐app下载地址调用 BinaryFileResponse: trustXSendfileTypeHeader自动的方法。它成为服务容器参数命名`kernel.trust_x_sendfile_type_header`。

trusted_headers选择需要配置哪些客户信息应该被信任(例如宿主)当运行Symfony背后一个负载均衡器或反向代理。欧宝娱乐app下载地址看到 如何配置Symfony背后的工作负欧宝娱乐app下载地址载均衡器或反向代理吗。

trusted_proxies选择是需要精确的信息客户端(例如IP地址)在运行Symfony背后一个负载均衡器或反向代理。欧宝娱乐app下载地址看到 如何配置Symfony背后的工作负欧宝娱乐app下载地址载均衡器或反向代理吗。

字符串默认的:% env(默认值::SYM欧宝娱乐app下载地址FONY_IDE) %

欧宝娱乐app下载地址Symfony将文件路径的变量转储和异常信息链接,打开那些文件在您的浏览器。如果你喜欢在您最喜爱的IDE或文本编辑器中打开这些文件,这个选项设置为下列值:phpstorm,崇高,textmate软件,macvim,emacs,原子和vscode。

请注意

的phpstorm选择是支持本地PhpStorm MacOS,窗户需要 PhpStormProtocol和Linux需要phpstorm-url-handler。

如果你使用另一个编辑器,预期的配置模板,包含一个值是一个URL% f预计占位符的文件路径% l占位符的行号(百分比符号(%)必须加倍逃跑了防止Symfony解释他们作为容器参数)。欧宝娱乐app下载地址

                   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 -->< /span>< ?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,推荐的方式来启用这个特性是系统级配置它。首先,你可以定义这个选项的欧宝娱乐app下载地址SYMFONY_IDESymfony时自动读取环境变量欧宝娱乐app下载地址framework.ide配置没有设置。

6.1

欧宝娱乐app下载地址SYMFONY_IDE环境变量是在Symfony 6.1中引入的支持。欧宝娱乐app下载地址

另一个替代方法是设置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_formatini选项工作即使Xdebug扩展不启用。

提示

当运行你的应用程序在一个容器或一个虚拟机,你可以告诉Symfony将文件从客人映射到主机通过改变他们的前缀。欧宝娱乐app下载地址最后这张地图应该指定URL的模板,使用&和>guest-to-host分隔符:

                  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/'< /code>

`布尔`

如果这个配置设置(而不是礼物`假`),然后测试您的应用程序(如相关的服务。`test.client`)加载。这个设置应该出现在你的`测试`环境(通常是通过`配置/包/测试/ framework.yaml`)。

另请参阅

有关更多信息,请参见 测试。

字符串默认的:在

如果没有使用的默认语言环境_locale路由参数已经设置,它是可用的要求::getDefaultLocale方法。

另请参阅

你可以阅读更多信息的默认语言环境翻译。

数组默认的:[](空数组=启用所有地区)

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

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13 14
                    < !- - - - - -- - - - - -config/packages/translation.xml -->< /span>< ?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下载地址

布尔默认的:`假`

如果将此选项设置`真正的`将有一个响应`内容语言`HTTP头的`请求`语言环境。

布尔默认的:`假`

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

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

布尔默认的:`真正的`当启用了调试模式,`假`否则。

如果`真正的`Sy欧宝娱乐app下载地址mfony补充道,一个`X-Robots-Tag: noindex`HTTP标记所有响应(除非你自己的应用补充说,头,在这种情况下,它不修改)。这 X-Robots-Tag HTTP头告诉搜索引擎索引你的网站。这个选项是一个保护措施以防意外地发布你的网站在调试模式下。

数组|字符串默认的:[]

发现了很多不同的攻击依赖于在处理不一致主机头由各种软件(web服务器、反向代理、web框架,等等)。基本上,每次生成一个框架绝对URL(在发送电子邮件重置密码),主机可能已经被攻击者。

另请参阅

你可以阅读 HTTP主机头攻击为更多的信息关于这些类型的攻击。

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

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

                   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
                   < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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保护个人形式。

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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)包括使用边缘一边。

布尔默认的:假

是否启用边缘方面包括支持的框架。

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

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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的更多信息。

字符串默认的:`/ _fragment`

片段的路径前缀。片段侦听器时才会执行请求从这条路开始。

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

这个服务可以使用配置framework.http_client.default_options:

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

                   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                   < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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客户端>< /框架:配置>< /容器>
                  

                   1 2 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服务。您可以覆盖这些选项可以定义其他几个人:

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

                   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
                   < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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服务到您autowired的类。

通过支持可选retry_failed配置HTTP客户服务将自动重试失败的HTTP请求。

                 1 2 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或重试网络错误429:真正的#重试所有响应429状态码500:(“得到”,“头”]max_retries:2延迟:1000年乘数:3max_delay:5000年抖动:0.3scoped_clients:my_api.client:#……retry_failed:max_retries:4
                

字符串

用于创建用户名和密码`授权`HTTP报头中使用HTTP基本身份验证。这个选项的值必须遵循的格式`用户名:密码`。

字符串

用于创建令牌`授权`HTTP报头中使用HTTP持票人身份验证(也称为令牌认证)。

字符串

用于创建用户名和密码`授权`HTTP头中使用 微软NTLM认证协议。这个选项的值必须遵循的格式`用户名:密码`。这种身份验证机制需要使用cURL-based运输。

字符串

合并成相对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

字符串

网络接口名称、IP地址、主机名或UNIX socket使用即将离任的网络接口。

布尔|`关闭`

缓冲响应意味着您可以多次访问其内容没有再次执行该请求。时默认启用缓冲响应的内容类型`文本/ *`,`application / json`或`应用程序/ xml`。

如果这个选项是一个布尔值,响应值时得到缓冲`真正的`。如果这个选项是一个闭包,响应返回值时得到缓冲`真正的`(关闭接收数组作为参数响应标头)。

字符串

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

字符串

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

字符串

列表的名称密码允许TLS连接。他们可以用冒号分开,(如逗号或空格。`“RC4-SHA: tls13 - aes - 128 - gcm - sha256”`)。

整数

TLS接受的最低版本。的值必须是一个`STREAM_CRYPTO_METHOD_TLSv * _CLIENT`常量定义的PHP。

6.3

的`crypto_method`选项是在Symfony 6.3中引入的。欧宝娱乐app下载地址

整数默认的:`1000年`

用于计算初始延迟毫秒重试之间的等待时间。

布尔默认的:`假`

是否启用支持重试失败的HTTP请求。这个设置是自动设置为true,当其中一个孩子设置配置。

数组

任意的额外的数据通过HTTP客户端进一步使用。这可以时特别有用 装修一个现有的客户。

6.3

的`额外的`选择已经在Symfony 6.3中引入的。欧宝娱乐app下载地址

数组

关联数组的HTTP头添加到请求之前。这个值必须使用格式`['头名称' = > ' 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连接,服务器发送一个证书表明其身份。从这个证书和公钥提取不完全匹配这个选项提供的公钥,连接中止之前发送或接收任何数据。

这个选项的值是一个关联数组`= >哈希算法`(如`[' pin-sha256 ' = > '…']`)。

字符串|`零`

所使用的HTTP代理请求。离开它`零`检测代理自动根据您的系统配置。

数组

一个关联数组添加到URL的查询字符串值之前请求。这个值必须使用格式`(“参数名”= >参数值,…)`。

数组

主机名和IP地址的列表来填充使用的DNS缓存HTTP客户端为了避免DNS查询的主机。这个选项是有用的改善安全当IPs之前检查URL传递给客户机和简化您的测试。

这个选项的值是一个关联数组`域= > IP地址`(如`['欧宝娱乐app下载地址 www.oldmanjams.com ' = > ' 46.137.106.254 ',…]`)。

字符串

服务用于决定是否请求应重试,重试之间的计算时间等。默认情况下,它使用的一个实例 GenericRetryStrategy配置了`http_codes`,`延迟`,`max_delay`,`乘数`和`抖动`选项。这个类必须实现RetryStrategyInterface。

字符串

仅为作用域的客户:URL必须匹配的正则表达式之前所有其他非默认选项。默认情况下,来自范围 base_uri。

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

时间,在几秒钟内,等待一个响应。如果响应需要更长的时间,TransportException抛出。其默认值是一样的PHP的的价值default_socket_timeout配置选项。

布尔默认的:`真正的`

如果`真正的`,其他服务器发送的证书验证,以确保他们的共同名字匹配主机包括在URL中。这通常是结合`verify_peer`也验证证书的真实性。

布尔默认的:`真正的`

如果`真正的`谈判时,其他服务器发送的证书的TLS连接验证真实性。认证证书并不足以确保服务器,所以你应该结合`verify_host`选择。

6.1

HTML洗手液的配置是在Symfony 6.1中引入的。欧宝娱乐app下载地址

的html_sanitizer选项(和孩子)用于配置自定义HTML消毒液。阅读更多有关的选项 HTML文档洗手液欧宝体育电话。

布尔默认的:`假`

分析器可以通过设置这个选项启用`真正的`。当你安装它使用Symfony的Flex,启用了分析器欧宝娱乐app下载地址`dev`和`测试`环境。

请注意

分析器的工作原理独立于Web开发人员工具栏,查看 WebProfilerBundle配置如何禁用/启用工具栏。

布尔默认的:真正的

这个选项配置分析器的行为方式时启用。如果设置为真正的为所有请求,分析器收集数据。如果你想只收集信息随需应变,可以设置收集旗帜假和手动激活数据收集器:

                  1
                  美元分析器- >使();
                 

字符串默认的:`零`

这指定名称查询的参数,一个身体参数或一个请求属性用来启用或禁用分析器为每个请求的数据的集合。结合起来的`收集`选项来启用/禁用对需求的分析工具:

如果`收集`选项设置为`真正的`但是这个参数存在于一个请求以外的任何值`真正的`,`是的`,`在`或`1`,请求将不会收集数据;

如果`收集`选项设置为`假`,但这个参数请求和有价值的存在`真正的`,`是的`,`在`或`1`,请求数据将被收集。

布尔默认的:`假`

这是设置的时候出现`真正的`,分析器只会抛出异常时启用在请求的处理。

布尔默认的:`假`

这是设置的时候出现`真正的`,才会启用分析器主要请求(而不是subrequests)。

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

存储配置信息的DSN。

布尔默认的:`假`

设置这个选项`真正的`使序列化器数据收集器和分析器面板。当这个选项`真正的`,所有的标准化者和编码器被跟踪的实现装饰,收集分析信息。

6.1

的`collect_serializer_data`选项是在Symfony 6.1中引入的。欧宝娱乐app下载地址

原型

您想创建速度限制器的名称。

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

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

字符串要求

速度限制算法使用的名称。实例名称`fixed_window`,`sliding_window`和`no_limit`。看到 速度限制政策更多信息)。

数组默认的:[]

此设置用于额外的请求格式(如联系起来。html一个或多个mime类型(如。text / html),这将允许您使用格式和mime类型来调用要求::getFormat (mimeType美元)或要求::getMimeType(格式)。

在实践中,这是很重要的,因为Symfony用它来自动设置欧宝娱乐app下载地址内容类型标题响应(如果你不显式地设置一个)。如果你通过一个mime类型数组,第一个将用于标题。

配置一个jsonp格式:

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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`)。

字符串

默认URI用于生成url在非http上下文 生成的url命令)。

整数默认的:`80年`

正常的http请求的端口匹配时(这是使用计划)。

整数默认的:`443年`

https请求的端口匹配时(这是使用计划)。

混合默认的:`真正的`

决定了路由发生器的行为。当生成特定的路线 参数需求,发电机可以使用不同的参数不满足这些需求。

值可以是一个:

`真正的`

需求没有得到满足时抛出异常;

`假`

禁用例外当需求没有得到满足和回报`”`相反;

`零`

禁用检查要求(因此,比赛路线即使需求不匹配)。

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

布尔默认的:`真正的`

此选项设置的时候出现`真正的`正则表达式中使用 线路参数的要求将运行使用utf - 8修饰符。例如这将匹配任何在使用utf - 8字符`。`,而不是只匹配一个字节。

如果您的应用程序是utf - 8字符集(中定义的getCharset()方法你的内核)这是推荐的设置`真正的`。这将使non-UTF8 url生成404错误。

字符串默认的:`% kernel.cache_dir %`

路由信息的目录将被缓存。可以设置为`~`(`零`)禁用缓存路线。

6.2

的`cache_dir`设置是在Symfony 6.2中引入的。欧宝娱乐app下载地址

字符串默认的:session.storage.factory.native

用于创建服务IDSessionStorageInterface存储会话。这个服务可以在Symfony应用程序通过欧宝娱乐app下载地址session.storage.factory服务别名。类必须实现 SessionStorageFactoryInterface。看到所有可用的列表存储、运行:

                  1
                  美元php bin /控制台调试:session.storage.factory容器。
                 

字符串默认的:`session.handler.native_file`

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

字符串默认的:`零`

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

字符串或int默认的(空字符串)

如果设置为0,S欧宝娱乐app下载地址ymfony不会设置任何特定的头相关的缓存,它将依赖于缓存控制方法中配置 session.cache-limiterPHP。ini选项。

与其他会话的选项,cache_limiter设置为定期吗容器参数:

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/services.xml -->< /span>< ?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 GC过程意味着有1%的可能性将在每个请求开始。

整数默认的:`1440年`

这决定的秒数后,数据将被视为“垃圾”和潜在的清理。垃圾收集可以发生在会议开始和依赖 gc_divisor和gc_probability。

整数默认的:`32`

这决定了会话ID字符串的长度,可以之间的一个整数`22`和`256年`(包容)`32`推荐的值。长会话id更难猜测。

这个选项有关 会话。sid_length PHP选项。

整数默认的:`4`

这决定了在会话ID字符编码的比特数。可能的值是`4`f (0 - 9),`5`(0 - 9,动)`6`(0 - 9,a - z、a - z”——“,”、“)。位导致更强的会话ID。`5`对于大多数环境建议值。

这个选项有关 会话。sid_bits_per_character PHP选项。

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

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

你也可以设置这个值save_path你的php . ini通过设置值零:

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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`

这是多少秒等待更新/写作之间会话的元数据。这可能是有用的,如果出于某种原因,你想限制会话持续的频率,而不是这样做对每个请求。

布尔默认的:真正的

是否启用会话支持的框架。

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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`指令。

字符串

这个选项允许您定义一个基本路径用于资产:

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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下载地址资产的路径:

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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/”]);};
                   

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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=”{{资产(“…”、“阿凡达”)}}”>
                 

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

字符串

这个选项用于破产缓存资产由全球所有资产呈现路径添加一个查询参数(如。/图片/ logo.png ? v2)。这只适用于资产通过树枝呈现资产()PHP函数(或等效)。

例如,假设您有以下:

                  1
                  <imgsrc=”{{资产(图片/ logo.png)}}”alt=“欧宝娱乐app下载地址Symfony !”/ >
                 

默认情况下,这将使道路图像等/图片/ logo.png。现在,激活版本选择:

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

                    1 2 3 4 5 6 7 8 9 10 11 12 13
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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`资产的路径`= 5 /图片/ logo.png ?版本`。

请注意

所有百分比符号(`%`)的格式字符串必须逃离这个角色翻了一番。没有逃避,可能在不经意间被解释为值服务容器。

提示

一些CDN的不支持cache-busting通过查询字符串,所以将版本注入实际的文件路径是必要的。值得庆幸的是,`version_format`不仅限于生产版本查询字符串。

模式接收资产的原始路径和版本作为它的第一个和第二个参数,分别。由于资产的路径是一个参数,你不能修改它就地(如。`/图片/ logo-v5.png`);不过,您可以使用前缀资产的路径模式`版本- % % 2 $ s / % % 1 $ s`,这将导致的路径`版本5 /图片/ logo.png`。

可以使用URL重写规则无视之前版本前缀服务资产。或者,你可以复制到适当的资产版本路径作为部署过程的一部分,忘记任何URL重写。后者选项是有用的,如果你想要旧的资产版本仍在他们的原始URL访问。

字符串默认的:零

的服务id 资产版本策略应用于资产。这个选项可以设置在全球所有资产和个人资产包:

                    1 2 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:' /图片'
                   

                    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
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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) -->< /span><框架:包的名字=“foo_package”版本=“零”/ >< !- - - - - -- - - - - -this package uses its own strategy (the default strategy is ignored) -->< /span><框架:包的名字=“bar_package”version-strategy=“app.asset.another_version_strategy”/ >< !- - - - - -- - - - - -this package inherits the default strategy -->< /span><框架:包的名字=“baz_package”base_path=“/图片”/ >< /框架:资产>< /框架:配置>< /容器>
                   

                    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 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文件包含一个关联数组的资产名称和编制各自的名称。共同cache-busting技术使用“清单”文件的作品写出资产与“希”附加到文件名(例如。main.ae433f1cb.css在前端编译程序)。

提示

欧宝娱乐app下载地址Symfony的 Webpack安可支持输出散列的资产。此外,这可以纳入其他工作流,包括Webpack和吞咽webpack-manifest-plugin和gulp-rev,分别。

这个选项可以设置在全球所有资产和个人资产包:

                    1 2 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_path:“https://cdn.example.com/manifest.json”包:foo_package:#这个包使用自己的清单(默认文件被忽略)json_manifest_path:“% kernel.project_dir % /公共/构建/ a_different_manifest.json”#抛出异常时没有找到资产清单strict_mode:% kernel.debug %bar_package:#这个包使用全球清单(使用默认的文件)base_path:' /图片'
                   

                    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
                    < !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?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) -->< /span><框架:资产json-manifest-path=“% kernel.project_dir % /公共/构建/ manifest.json”>< !- - - - - -- - - - - -you can use absolute URLs too and Symfony will download them automatically -->< /span>< !- - - - - -- - - - - -<框架:资产json-manifest-path=”https://cdn.example.com/manifest.json"> -->< /span>< !- - - - - -- - - - - -this package uses its own manifest (the default file is ignored) -->< /span>< !- - - - - -- - - - - -Throws an exception when an asset is not found in the manifest -->< /span><框架:包的名字=“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) -->< /span><框架:包的名字=“bar_package”基本路径=“/图片”/ >< /框架:资产>< /框架:配置>< /容器>
                   

                    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 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”)/ /这个包使用自己的清单(默认文件被忽略)- >jsonManifestPath (' % kernel.project_dir % /公共/构建/ a_different_manifest.json”)/ /抛出一个异常时没有找到资产清单- >setStrictMode (“% kernel.debug %”);美元框架- >资产()- >包(“bar_package”)/ /这个包使用全球清单(使用默认的文件)- >basePath (' /图片');};
                   

请注意

该参数不能同时设置版本或version_strategy。此外,该选项不能在计划范围内无效如果指定一个全球性的清单文件。

提示

如果你请求的资产没有找到在manifest.json文件,原来的-未修改的——资产路径将被归还。你可以设置strict_mode来真正的去当一个资产是一个例外没有找到。

请注意

如果设置了一个URL, JSON清单下载每个请求使用http_client。

框架配置引用(FrameworkBundle)

trusted_headers选择需要配置哪些客户信息应该被信任(例如宿主)当运行Symfony背后一个负载均衡器或反向代理。欧宝娱乐app下载地址看到如何配置Symfony背后的工作负欧宝娱乐app下载地址载均衡器或反向代理吗。

trusted_proxies选择是需要精确的信息客户端(例如IP地址)在运行Symfony背后一个负载均衡器或反向代理。欧宝娱乐app下载地址看到如何配置Symfony背后的工作负欧宝娱乐app下载地址载均衡器或反向代理吗。

布尔 如果这个配置设置(而不是礼物假),然后测试您的应用程序(如相关的服务。test.client)加载。这个设置应该出现在你的测试环境(通常是通过配置/包/测试/ framework.yaml)。 另请参阅

另请参阅 关于CSRF保护的更多信息,请参阅如何实现CSRF保护吗。

字符串默认的:error_controller 这个控制器称为抛出异常时在您的应用程序。默认的控制器(ErrorController不同错误条件(见下)呈现特定的模板如何自定义错误页面吗)。

另请参阅 你可以阅读更多关于边缘方面包括(ESI)包括使用边缘一边。

另请参阅 了解更多的碎片HTTP缓存的文章。

字符串默认的:零 集的内容显示在加载片段或JavaScript被禁用。这可以是一个模板名称或内容本身。 另请参阅

字符串 用于创建用户名和密码授权HTTP头中使用微软NTLM认证协议。这个选项的值必须遵循的格式用户名:密码。这种身份验证机制需要使用cURL-based运输。

数组 任意的额外的数据通过HTTP客户端进一步使用。这可以时特别有用装修一个现有的客户。 6.3 的额外的选择已经在Symfony 6.3中引入的。欧宝娱乐app下载地址

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

字符串 一个文件包含之路PEM格式所使用的HTTP客户端证书。这通常是结合local_pk和密码选项。

字符串 一个文件包含的道路PEM格式私钥证书中定义的local_cert选择。

字符串 服务用于决定是否请求应重试,重试之间的计算时间等。默认情况下,它使用的一个实例GenericRetryStrategy配置了http_codes,延迟,max_delay,乘数和抖动选项。这个类必须实现RetryStrategyInterface。

字符串 仅为作用域的客户:URL必须匹配的正则表达式之前所有其他非默认选项。默认情况下,来自范围base_uri。

浮动默认的:取决于你的PHP配置 时间,在几秒钟内,等待一个响应。如果响应需要更长的时间,TransportException抛出。其默认值是一样的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。看到速度限制政策更多信息)。

整数默认的: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,动)6(0 - 9,a - z、a - z”——“,”、“)。位导致更强的会话ID。5对于大多数环境建议值。 这个选项有关会话。sid_bits_per_character PHP选项。

`布尔`

如果这个配置设置(而不是礼物`假`),然后测试您的应用程序(如相关的服务。`test.client`)加载。这个设置应该出现在你的`测试`环境(通常是通过`配置/包/测试/ framework.yaml`)。

另请参阅

有关更多信息,请参见测试。

另请参阅

关于CSRF保护的更多信息,请参阅如何实现CSRF保护吗。

字符串默认的:`error_controller`

这个控制器称为抛出异常时在您的应用程序。默认的控制器(ErrorController不同错误条件(见下)呈现特定的模板如何自定义错误页面吗)。

另请参阅

你可以阅读更多关于边缘方面包括(ESI)包括使用边缘一边。

另请参阅

了解更多的碎片 HTTP缓存的文章。

字符串默认的:`零`

集的内容显示在加载片段或JavaScript被禁用。这可以是一个模板名称或内容本身。

另请参阅

看到创建和使用模板关于hinclude的更多信息。

字符串

用于创建用户名和密码`授权`HTTP头中使用微软NTLM认证协议。这个选项的值必须遵循的格式`用户名:密码`。这种身份验证机制需要使用cURL-based运输。

数组

任意的额外的数据通过HTTP客户端进一步使用。这可以时特别有用装修一个现有的客户。

6.3

的`额外的`选择已经在Symfony 6.3中引入的。欧宝娱乐app下载地址

数组默认的:DEFAULT_RETRY_STATUS_CODES ()

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

字符串

一个文件包含之路 PEM格式所使用的HTTP客户端证书。这通常是结合`local_pk`和`密码`选项。

字符串

一个文件包含的道路 PEM格式私钥证书中定义的`local_cert`选择。

字符串

服务用于决定是否请求应重试,重试之间的计算时间等。默认情况下,它使用的一个实例 GenericRetryStrategy配置了`http_codes`,`延迟`,`max_delay`,`乘数`和`抖动`选项。这个类必须实现RetryStrategyInterface。

字符串

仅为作用域的客户:URL必须匹配的正则表达式之前所有其他非默认选项。默认情况下,来自范围 base_uri。

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

时间,在几秒钟内,等待一个响应。如果响应需要更长的时间,TransportException抛出。其默认值是一样的PHP的的价值default_socket_timeout配置选项。

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

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

字符串要求

速度限制算法使用的名称。实例名称`fixed_window`,`sliding_window`和`no_limit`。看到速度限制政策更多信息)。

整数默认的:`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,动)`6`(0 - 9,a - z、a - z”——“,”、“)。位导致更强的会话ID。`5`对于大多数环境建议值。

这个选项有关会话。sid_bits_per_character PHP选项。