依赖注入的标签

编辑该页面

警告:你浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 3.0,不再维护。

这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。

kernel.event_listener标签。

你可以学习一点关于“标签”,读“如何使用服务标签章”部分服务的容器。

下面是所有可用的标签在Symfony的信息。欧宝娱乐app下载地址可能还有其他包使用标签,没有列在这里。

标签名 使用
assetic.asset 注册一个资产当前的资产管理公司
assetic.factory_worker 添加一个工厂工人
assetic.filter 注册一个过滤器
assetic.formula_loader 添加一个公式装载机到当前的资产管理公司
assetic.formula_resource 将资源添加到当前的资产管理公司
assetic.templating.php 删除此服务如果PHP模板是禁用的
assetic.templating.twig 删除此服务如果树枝模板是禁用的
auto_alias 根据容器参数的值定义的别名
console.command 添加一个命令
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 听不同的事件/ Symfony的钩子欧宝娱乐app下载地址
kernel.event_subscriber 订阅的一组不同的事件/ Symfony的钩子欧宝娱乐app下载地址
kernel.fragment_renderer 添加新的HTTP内容呈现策略
monolog.logger 日志和一个自定义日志通道
monolog.processor 添加一个自定义日志处理器
routing.loader 注册一个定制服务,负载的路线
routing.expression_language_provider 注册一个供应商在路由表达式语言功能
security.expression_language_provider 注册一个提供者的表达式语言功能安全
security.voter 添加一个自定义的选民Symfony的授权逻辑欧宝娱乐app下载地址
security.remember_me_aware 记得我的身份验证
serializer.encoder 注册一个新的编码器序列化器服务
serializer.normalizer 注册一个新的标准化者序列化器服务
swiftmailer.default.plugin 注册自定义SwiftMailer插件
templating.helper 提供你的服务在PHP模板
translation.loader 注册一个定制服务,翻译
translation.extractor 注册一个定制服务,提取翻译消息从一个文件中
translation.dumper 注册一个转储翻译信息定制服务
twig.extension 注册一个定制的树枝延伸
twig.loader 注册一个定制服务,负载树枝模板
validator.constraint_validator 创建您自己的自定义验证约束
validator.initializer 注册一个服务初始化对象之前验证

第二,定义一个服务:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:acme.my_filter:类:MyFilter标签:- - - - - -{名称:assetic.filter,别名:my_filter}

最后,应用过滤器:

1 2 3 4 5 6
{%javascript“@AcmeBaseBundle /资源/公共/ js /全球。js的过滤器= ' my_filter ' %}<脚本src={{asset_url}}>< /脚本>{%endjavascripts%}

你也可以运用你的过滤器通过assetic.filters.my_filter.apply_to这里描述的配置选项:如何应用一个Assetic过滤到一个特定的文件扩展名。为了做到这一点,你必须定义过滤服务在一个单独的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标签,这不是强制定义别名私人服务。然而,这样做(就像在上面的例子中)是有道理的大多数时候,防止直接访问这些服务,而不是使用通用服务别名。

形式猜测的过程。默认情况下,猜测是通过“猜测”形式的基础上,验证元数据和教义的元数据(如果您正在使用原则)或推动元数据(如果您正在使用推动)。

另请参阅

有关如何创建自己的类型的信息推测者,明白了创建一个自定义类型猜测者

缓存:热身或缓存:清晰任务(除非你通过——no-warmup缓存:清晰)。它也运行处理请求时,如果不是通过一个命令。目的是初始化任何所需缓存的应用程序,防止第一个用户任何重要的“缓存命中”,缓存动态生成。

注册自己的缓存温暖,首先创建一个服务实现CacheWarmerInterface接口:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / Acme / MainBundle /缓存/ MyCustomWarmer.php名称空间Acme\MainBundle\缓存;使用欧宝娱乐app下载地址\组件\HttpKernel\CacheWarmer\CacheWarmerInterface;MyCustomWarmer实现了CacheWarmerInterface{公共函数热身(美元cacheDir){/ /……做一些操作“温暖”你的缓存吗}公共函数isOptional(){返回真正的;}}

isOptional方法应该返回true,如果可以使用应用程序没有调用这个缓存温暖。在Sy欧宝娱乐app下载地址mfony中,可选的温暖总是默认执行(你可以改变这一用——no-optional-warmers选择在执行命令)。

注册你的温暖Symfony,给它欧宝娱乐app下载地址kernel.cache_warmer标签:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:main.warmer.my_custom_warmer:类:Acme \ MainBundle \ \ MyCustomWarmer缓存标签:- - - - - -{名称:kernel.cache_warmer,优先级:0}

请注意

优先级值是可选的,默认为0。优先级越高,越早得到执行。

谨慎

如果您的缓存温暖失败的执行,因为任何例外,Symfony不会再次尝试执行它在接下来的请求。欧宝娱乐app下载地址因此,您的应用程序和/或包时应准备的内容缓存生成的温暖并不可用。

EsiFragmentRenderer——创建一个类,它实现了FragmentRendererInterface,注册一个服务,然后标记它kernel.fragment_renderer

额外的记录的属性。

内置的IntrospectionProcessor可以用来添加文件,行,日志的类和方法被触发。

您可以添加一个处理器在全球范围内:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:my_service:类:独白\ \ IntrospectionProcessor处理器标签:- - - - - -{名称:monolog.processor}

提示

如果你的服务不是一个可调用(使用__invoke)您可以添加方法使用特定的方法属性的标记。

您还可以添加一个处理器为一个特定的处理器使用处理程序属性:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:my_service:类:独白\ \ IntrospectionProcessor处理器标签:- - - - - -{名称:monolog.processor,处理程序:firephp}

您还可以添加一个处理器为一个特定的日志记录频道使用通道属性。这只注册处理器安全日志记录通道用于安全组件:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:my_service:类:独白\ \ IntrospectionProcessor处理器标签:- - - - - -{名称:monolog.processor,渠道:安全}

请注意

你不能同时使用处理程序通道属性相同的标记处理程序之间共享所有频道。

表达功能提供者路由表达式的组件。使用这些提供者,您可以定制函数添加到路由表达式语言。

表达功能提供者安全表达组件。使用这些提供者,您可以添加自定义功能安全表达式语言。

AbstractFactory和您的自定义身份验证侦听器扩展AbstractAuthenticationListener,那么你的自定义的身份验证侦听器会自动标记应用和它将自动功能。

现在,注册您的加载程序作为服务和标记translation.loader:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:main.translation.my_custom_loader:类:Acme \ MainBundle \ \ MyCustomLoader翻译标签:- - - - - -{名称:translation.loader,别名:}

别名选项是必需的和非常重要的:它定义了文件“后缀”,将用于使用此加载程序的资源文件。例如,假设您有一些习俗格式,你需要加载。如果你有一个文件,其中包含法语翻译的消息域,那么你可能有一个文件app /资源/翻译/ messages.fr.bin

当Symf欧宝娱乐app下载地址ony试图加载文件时,它将路径传递给您的自定义加载程序的美元的资源论点。然后您可以执行任何逻辑上你需要文件来加载你的翻译。

如果你从数据库加载翻译,你仍然需要一个资源文件,但它可能是空白或包含一些信息从数据库中加载这些资源。这个文件是触发的关键负载方法自定义加载程序。

翻译:更新命令,它使用提取器提取翻译消息从一个文件中。默认情况下,有一个Symfony欧宝娱乐app下载地址框架TwigExtractor和一个PhpExtractor,这有助于发现和提取翻译键从树枝模板和PHP文件。

您可以创建自己的器通过创建一个实现类ExtractorInterface和标签的服务translation.extractor。所需的标签有一个选择:别名,它定义了萃取器的名称:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日24日25日26日
/ / src / Acme / DemoBundle /翻译/ FooExtractor.php名称空间Acme\DemoBundle\翻译;使用欧宝娱乐app下载地址\组件\翻译\\ExtractorInterface;使用欧宝娱乐app下载地址\组件\翻译\MessageCatalogue;FooExtractor实现了ExtractorInterface{受保护的美元前缀;/ * * *提取翻译信息从模板目录的目录。* /公共函数提取(美元目录,MessageCatalogue美元目录){/ /……}/ * * *设置前缀应该用于新发现消息。* /公共函数setPrefix(美元前缀){美元- >前缀=美元前缀;}}
  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:acme_demo.translation.extractor.foo:类:Acme \ DemoBundle \ \ FooExtractor翻译标签:- - - - - -{名称:translation.extractor,别名:喷火}

从模板中提取所有消息,矿用汽车执行将消息转储到一个翻译文件在一个特定的格式。

欧宝娱乐app下载地址Symfony已经伴随着许多的矿用汽车:

您可以创建自己的翻车机通过扩展FileDumper或实现DumperInterface和标签的服务translation.dumper。标签有一个选项:别名这个名字是用来确定应该使用清洁工人。

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:acme_demo.translation.dumper.json:类:Acme \ DemoBundle \ \ JsonFileDumper翻译标签:- - - - - -{名称:translation.dumper,别名:json}

另请参阅

学习如何转储到自定义格式在组件部分。

twig.extension:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:twig.extension.your_extension_name:类:完全限定\ \类\ \扩展名标签:- - - - - -{名称:twig.extension}

如何创建实际的嫩枝上的信息扩展类,明白了树枝的文档欧宝体育电话在主题或阅读如何编写一个定制的树枝扩展篇文章。

在编写自己的扩展之前,看一看树枝官方扩展库已经包含了几个有用的扩展。例如Intl和它的localizeddate过滤器格式日期根据用户的语言环境。这些官员树枝扩展也必须被添加作为常规服务:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:twig.extension.intl:类:Twig_Extensions_Extension_Intl标签:- - - - - -{名称:twig.extension}

树枝装载机- - - - - -FilesystemLoader。如果你需要加载树枝从另一个资源模板,您可以创建一个服务新加载器和标签twig.loader:

  • YAML
  • XML
  • PHP
1 2 3 4 5
服务:acme.demo_bundle.loader.some_twig_loader:类:Acme \ DemoBundle \装载机\ SomeTwigLoader标签:- - - - - -{名称:twig.loader,优先级:0}

请注意

优先级是可选的,默认值0。首先优先加载程序尝试。

ObjectInitializerInterface接口。然后,它与标签validator.initializer标签(没有选项)。

例如,看到EntityInitializer类内部的教义桥。

这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。