内置的Symfon欧宝娱乐app下载地址y服务标签
编辑本页警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 3.3,现已不再维护。
读本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。
- assetic.asset
- assetic.factory_worker
- assetic.filter
- assetic.formula_loader
- assetic.formula_resource
- assetic.templating.php
- assetic.templating.twig
- auto_alias
- console.command
- controller.argument_value_resolver
- data_collector
- doctrine.event_listener
- doctrine.event_subscriber
- form.type
- form.type_extension
- form.type_guesser
- kernel.cache_clearer
- kernel.cache_warmer
- kernel.event_listener
- kernel.event_subscriber
- kernel.fragment_renderer
- monolog.logger
- monolog.processor
- routing.loader
- routing.expression_language_provider
- security.expression_language_provider
- security.remember_me_aware
- security.voter
- serializer.encoder
- serializer.normalizer
- swiftmailer.default.plugin
- templating.helper
- translation.loader
- translation.extractor
- translation.dumper
- twig.extension
- twig.loader
- validator.constraint_validator
- validator.initializer
服务标签该机制是由DependencyInjection组件标记需要特殊处理的服务,如控制台命令或Twig扩展。
这些是Symfony组件提供的最常见的标记,但在您的应用程序中,第三方包可能提供更多可欧宝娱乐app下载地址用的标记:
Assetic \ \工厂工人\ WorkerInterface.它的过程(美元资产)
方法在创建资产后为每个资产调用。您可以修改资产,甚至返回一个新的资产。
为了添加一个新的worker,首先创建一个类:
1 2 3 4 5 6 7 8 9 10 11
使用Assetic\资产\AssetInterface;使用Assetic\工厂\工人\WorkerInterface;类mywork实现了WorkerInterface{公共函数过程(AssetInterface$资产){/ /……更改$asset或返回一个新的}}
然后把它注册为一个带标签的服务:
- YAML
- XML
- PHP
1 2 3
服务:AppBundle \ Assetic \ CustomWorker:标签:(assetic.factory_worker)
过程(美元资产)
方法在创建资产后为每个资产调用。您可以修改资产,甚至返回一个新的资产。
为了添加一个新的worker,首先创建一个类:
1 2 3 4 5 6 7 8 9 10 11
使用Assetic\资产\AssetInterface;使用Assetic\工厂\工人\WorkerInterface;类mywork实现了WorkerInterface{公共函数过程(AssetInterface$资产){/ /……更改$asset或返回一个新的}}
然后把它注册为一个带标签的服务:
- YAML
- XML
- PHP
1 2 3
服务:AppBundle \ Assetic \ CustomWorker:标签:(assetic.factory_worker)
其次,定义一个服务:
- YAML
- XML
- PHP
1 2 3 4
服务:AppBundle \ Assetic \ CustomFilter:标签:-{名称:assetic.filter,别名:my_filter}
最后,应用滤镜:
1 2 3 4 5 6
{%javascript'@AcmeBaseBundle/Resources/public/js/global.js' filter='my_filter' %}<脚本src="{{asset_url}}">脚本>{%endjavascripts%}
您还可以通过assetic.filters.my_filter.apply_to
配置选项,如下所示:如何应用一个汇编过滤器到特定的文件扩展名.要做到这一点,必须在单独的xml配置文件中定义筛选器服务,并通过assetic.filters.my_filter.resource
配置的关键。
应用程序不需要处理这三个服务,而是需要一个通用服务app.lock
服务,该服务将是这些服务之一的别名,具体取决于某些配置。多亏了auto_alias
选项,则可以根据配置参数的值自动创建该别名。
考虑到配置参数叫做database_type
的存在。然后是通用的app.lock
服务的定义如下:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10
服务:app.mysql_lock:#……app.postgresql_lock:#……app.sqlite_lock:#……app.lock:标签:-{名称:auto_alias,格式:“应用,% database_type % _lock”}
的格式
选项定义用于构造为别名的服务名称的表达式。这个表达式可以使用任何容器参数(像往常一样,将它们的名称包装为%
字符)。
请注意
当使用auto_alias
标记,将别名服务定义为私有并不是强制性的。然而,这样做(就像上面的例子一样)在大多数情况下是有意义的,可以防止直接访问这些服务,而不是使用通用服务别名。
请注意
需要手动添加欧宝娱乐app下载地址
编译器传递给容器以使该特性工作。
如何创建自定义数据收集器篇文章。
事件监听器和订阅器篇文章。
事件监听器和订阅器篇文章。
如何创建自定义表单字段类型篇文章。
如何创建一个表单类型扩展篇文章。
形式猜测的过程。默认情况下,表单猜测是由基于验证元数据和Doctrine元数据(如果使用Doctrine)或Propel元数据(如果使用Propel)的“猜测者”完成的。
另请参阅
有关如何创建自己的类型猜测器的信息,请参见创建一个自定义类型猜测器.
另请参阅
有关如何创建自己的类型猜测器的信息,请参见创建一个自定义类型猜测器.
缓存:清晰命令。如果你的bundle缓存文件,你应该在缓存清理过程中添加自定义缓存清理器来清除这些文件。
为了注册你的自定义缓存清理器,首先你必须创建一个服务类:
12 3 4 5 6 7 8 9 10 11 12
/ / src / AppBundle /缓存/ MyClearer.php名称空间AppBundle\缓存;使用欧宝娱乐app下载地址\组件\HttpKernel\CacheClearer\CacheClearerInterface;类MyClearer实现了CacheClearerInterface{公共函数清晰的($cacheDir){//清除缓存}}
如果你在用默认的服务。yml配置,您的服务将自动标记为kernel.cache_clearer
.但是,你也可以手动注册:
- YAML
- XML
- PHP
1 2 3
服务:AppBundle \ \ MyClearer缓存:标签:(kernel.cache_clearer)
12 3 4 5 6 7 8 9 10 11 12
/ / src / AppBundle /缓存/ MyClearer.php名称空间AppBundle\缓存;使用欧宝娱乐app下载地址\组件\HttpKernel\CacheClearer\CacheClearerInterface;类MyClearer实现了CacheClearerInterface{公共函数清晰的($cacheDir){//清除缓存}}
kernel.cache_clearer
.但是,你也可以手动注册:- YAML
- XML
- PHP
1 2 3
服务:AppBundle \ \ MyClearer缓存:标签:(kernel.cache_clearer)
缓存:热身或缓存:清晰
命令(除非你通过——no-warmup
来缓存:清晰
).它也会在处理请求时运行,如果其中一个命令还没有完成请求的话。
3.3
的预热部分从Symfony 欧宝娱乐app下载地址3.3开始缓存:清晰
命令不建议使用。你必须总是通过考试——no-warmup
选项缓存:清晰
和使用缓存:热身
而是为缓存预热。
目的是初始化应用程序将需要的任何缓存,并防止第一个用户在动态生成缓存的情况下受到任何重要的“缓存命中”。
要注册自己的缓存预热器,首先创建一个实现CacheWarmerInterface接口:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / Acme / MainBundle /缓存/ MyCustomWarmer.php名称空间AppBundle\缓存;使用欧宝娱乐app下载地址\组件\HttpKernel\CacheWarmer\CacheWarmerInterface;类MyCustomWarmer实现了CacheWarmerInterface{公共函数热身($cacheDir){/ /……做一些操作来“加热”你的缓存}公共函数isOptional(){返回真正的;}}
的isOptional ()
方法应返回true,如果可以在不调用此缓存预热器的情况下使用应用程序。在Sy欧宝娱乐app下载地址mfony中,默认情况下总是执行可选的暖器(您可以使用——no-optional-warmers
选项)。
如果你在用默认的服务。yml配置,您的服务将自动标记为kernel.cache_warmer
.但是,你也可以手动注册:
- YAML
- XML
- PHP
1 2 3 4
服务:AppBundle \ \ MyCustomWarmer缓存:标签:-{名称:kernel.cache_warmer,优先级:0}
请注意
的优先级
Value为可选参数,默认值为0。优先级越高,执行得越快。
谨慎
如果您的缓存温暖器因为任何异常而执行失败,Symfony将不会尝试为下一个请求再次执行它。欧宝娱乐app下载地址因此,当缓存预热器生成的内容不可用时,您的应用程序和/或包应该做好准备。
缓存温暖器类名称
优先级
TemplatePathsCacheWarmer
20.
RouterCacheWarmer
0
TemplateCacheCacheWarmer
0
3.3
的预热部分从Symfony 欧宝娱乐app下载地址3.3开始缓存:清晰
命令不建议使用。你必须总是通过考试——no-warmup
选项缓存:清晰
和使用缓存:热身
而是为缓存预热。
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / Acme / MainBundle /缓存/ MyCustomWarmer.php名称空间AppBundle\缓存;使用欧宝娱乐app下载地址\组件\HttpKernel\CacheWarmer\CacheWarmerInterface;类MyCustomWarmer实现了CacheWarmerInterface{公共函数热身($cacheDir){/ /……做一些操作来“加热”你的缓存}公共函数isOptional(){返回真正的;}}
isOptional ()
方法应返回true,如果可以在不调用此缓存预热器的情况下使用应用程序。在Sy欧宝娱乐app下载地址mfony中,默认情况下总是执行可选的暖器(您可以使用——no-optional-warmers
选项)。kernel.cache_warmer
.但是,你也可以手动注册:- YAML
- XML
- PHP
1 2 3 4
服务:AppBundle \ \ MyCustomWarmer缓存:标签:-{名称:kernel.cache_warmer,优先级:0}
请注意
的优先级
Value为可选参数,默认值为0。优先级越高,执行得越快。
谨慎
如果您的缓存温暖器因为任何异常而执行失败,Symfony将不会尝试为下一个请求再次执行它。欧宝娱乐app下载地址因此,当缓存预热器生成的内容不可用时,您的应用程序和/或包应该做好准备。
缓存温暖器类名称 | 优先级 |
---|---|
TemplatePathsCacheWarmer | 20. |
RouterCacheWarmer | 0 |
TemplateCacheCacheWarmer | 0 |
EsiFragmentRenderer-创建一个实现FragmentRendererInterface,将其注册为服务,然后标记为kernel.fragment_renderer
.
应用程序但是您可以在将记录器注入服务时更改通道。
- YAML
- XML
- PHP
1 2 3 4 5
服务:AppBundle \ Log \ customlog:参数:(“@logger”)标签:-{名称:monolog.logger,渠道:应用程序}
提示
您还可以在配置中配置自定义通道,并直接从服务容器检索相应的记录器服务(请参阅如何将消息记录到不同的文件).
- YAML
- XML
- PHP
1 2 3 4 5
服务:AppBundle \ Log \ customlog:参数:(“@logger”)标签:-{名称:monolog.logger,渠道:应用程序}
提示
您还可以在配置中配置自定义通道,并直接从服务容器检索相应的记录器服务(请参阅如何将消息记录到不同的文件).
routing.loader:
- YAML
- XML
- PHP
1 2 3
服务:AppBundle \ \ CustomLoader路由:标签:(routing.loader)
有关更多信息,请参见如何创建自定义路由加载器.
- YAML
- XML
- PHP
1 2 3
服务:AppBundle \ \ CustomLoader路由:标签:(routing.loader)
表达式函数提供程序用于路由表达式组件。使用这些提供程序,您可以向路由表达式语言添加自定义函数。
表达式函数提供程序用于安全表达式组件。使用这些提供程序,您可以向安全表达式语言添加自定义函数。
AbstractFactory并扩展您的自定义身份验证侦听器AbstractAuthenticationListener,那么您的自定义身份验证侦听器将自动应用此标记,并自动运行。
isGranted ()在Sy欧宝娱乐app下载地址mfony的授权检查器上,一个“投票者”系统在幕后被用来决定用户是否应该拥有访问权限。的security.voter
标签允许您将自己的自定义投票人添加到该系统。
有关更多信息,请阅读如何使用选民检查用户权限篇文章。
NormalizerInterface而且DenormalizerInterface.
详情请参见如何使用序列化器.
默认归一化器的优先级可以在registerSerializerConfiguration ()方法。
swiftmailer.default.plugin(它没有选择)。
请注意
默认的
在这个标记中是邮件发送者的名称。如果您配置了多个邮件程序,或者由于某种原因更改了默认的邮件程序名称,那么您应该将其更改为您的邮件程序的名称,以便使用此标记。
SwiftMailer插件必须实现Swift_Events_EventListener
接口。有关插件的更多信息,请参见SwiftMailer的插件文档欧宝体育电话.
几个SwiftMailer插件是Symfony的核心,可以通过不同的配置激活。欧宝娱乐app下载地址详细信息请参见SwiftmailerBundle配置(swiftmailer).
请注意
默认的
在这个标记中是邮件发送者的名称。如果您配置了多个邮件程序,或者由于某种原因更改了默认的邮件程序名称,那么您应该将其更改为您的邮件程序的名称,以便使用此标记。
Swift_Events_EventListener
接口。有关插件的更多信息,请参见SwiftMailer的插件文档欧宝体育电话.现在,将加载器注册为服务并标记为translation.loader
:
- YAML
- XML
- PHP
1 2 3 4
服务:AppBundle \ \ MyCustomLoader翻译:标签:-{名称:translation.loader,别名:箱子}
的别名
选项是必需的,而且非常重要:它定义了将用于使用该加载器的资源文件的文件“后缀”。例如,假设您有一些定制箱子
您需要加载的格式。如果你有箱子
文件的法语翻译消息
域名,那么你可能有一个文件app /资源/翻译/ messages.fr.bin
.
当Symf欧宝娱乐app下载地址ony尝试加载箱子
文件时,它将路径传递给自定义加载器美元的资源
论点。然后,您可以在该文件上执行所需的任何逻辑,以便加载翻译。
如果从数据库加载翻译,仍然需要一个资源文件,但它可能是空白的,或者包含一些关于从数据库加载这些资源的信息。文件是触发load ()
方法。
翻译:更新命令时,它使用提取器从文件中提取翻译消息。默认情况下,Symfony框架有欧宝娱乐app下载地址一个TwigExtractor和一个PhpExtractor,这有助于从Twig模板和PHP文件中查找和提取翻译键。
您可以通过创建实现的类来创建自己的提取器ExtractorInterface并将服务标记为translation.extractor
.标签有一个必需的选项:别名
,它定义了提取器的名称:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
/ / src / Acme / DemoBundle /翻译/ FooExtractor.php名称空间Acme\DemoBundle\翻译;使用欧宝娱乐app下载地址\组件\翻译\器\ExtractorInterface;使用欧宝娱乐app下载地址\组件\翻译\MessageCatalogue;类FooExtractor实现了ExtractorInterface{受保护的$前缀;/** *从模板目录提取翻译消息到目录。* /公共函数提取($目录, MessageCatalogue$目录){/ /……}/** *设置应用于新发现消息的前缀。* /公共函数setPrefix($前缀){$这->前缀=$前缀;}}
- YAML
- XML
- PHP
1 2 3 4
服务:应用翻译\ \ CustomExtractor:标签:-{名称:translation.extractor,别名:喷火}
器从模板中提取所有消息后,将执行转储程序以将消息转储到特定格式的翻译文件中。
欧宝娱乐app下载地址Symfony已经提供了许多转储器:
- CsvFileDumper
- IcuResFileDumper
- IniFileDumper
- MoFileDumper
- PoFileDumper
- QtFileDumper
- XliffFileDumper
- YamlFileDumper
您可以通过扩展创建自己的转储器FileDumper或实现DumperInterface并将服务标记为translation.dumper
.标签有一个选项:别名
这是用来确定应该使用哪个转储器的名称。
- YAML
- XML
- PHP
1 2 3 4
服务:AppBundle \ \ JsonFileDumper翻译:标签:-{名称:translation.dumper,别名:json}
另请参阅
学习如何转储为自定义格式在组件部分。
twig.extension.如果你在用默认的服务。yml配置,该服务是自动注册和自动标记的。但是,你也可以手动注册:
- YAML
- XML
- PHP
1 2 3
服务:AppBundle \树枝\ AppExtension:标签:(twig.extension)
- YAML
- XML
- PHP
1 2 3
服务:AppBundle \树枝\ AppExtension:标签:(twig.extension)
有关如何创建实际的树枝扩展类的信息,请参见树枝的文档欧宝体育电话关于这个话题或阅读如何编写一个自定义树枝扩展篇文章。
在编写自己的扩展之前,请先查看树枝官方扩展存储库它已经包含了几个有用的扩展。例如Intl
和它的localizeddate
筛选器,根据用户的语言环境格式化日期。这些官方的Twig扩展也必须作为常规服务添加:
- YAML
- XML
- PHP
1 2 3
服务:Twig_Extensions_Extension_Intl:标签:(twig.extension)
树枝装载机-FilesystemLoader.如果您需要从其他资源加载Twig模板,您可以为新的加载器创建一个服务并标记它twig.loader
.
如果你使用默认的服务。yml配置,由于自动配置,该服务将被自动标记。但是,你也可以手动注册:
- YAML
- XML
- PHP
1 2 3 4
服务:AppBundle \树枝\ CustomLoader:标签:-{名称:twig.loader,优先级:0}
请注意
的优先级
Value为可选参数,默认为0
.优先级较高的加载器将首先尝试。
如何创建自定义验证约束篇文章。
ObjectInitializerInterface接口。然后,标记它与validator.initializer
标签(它没有选项)。
有关示例,请参见DoctrineInitializer
在教义桥里面上课。