如何创建一个定制的路线装载机
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 2.5,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.3(当前的稳定版本)。
如何创建一个定制的路线装载机
自定义加载程序允许您添加路由路由到应用程序不包括,例如,在YAML文件。这方便当你有一个包但不想手动添加包的路线应用程序/配置/ routing.yml。这可能是特别重要的,当你想让包可重用,或者当你有开源,这将减缓安装过程并使其容易出错。
另外,您还可以使用一个定制的路线装载机当你想要你的航线自动生成或基于一些公约或模式。一个例子是FOSRestBundle在路由生成基于控制器动作方法的名称。
请注意
有很多包,使用自己的路线完成上述这种情况下加载器,例如FOSRestBundle,JMSI18nRoutingBundle,KnpRadBundle和SonataAdminBundle。
加载路径
的路线在Symfony应用程序加ob娱乐下载载的DelegatingLoader。该装载机使用其他几个不同类型的加载器(代表)加载资源,例如YAML文件或@Route和@Method注释在控制器文件。专业的加载器实现LoaderInterface因此有两个重要的方法:支持()和load ()。
把这些线的routing.ymlAcmeDemoBundle的标准版:
1 2 3 4 5
# src / Acme / DemoBundle /资源/ config / routing.yml_demo:资源:“@AcmeDemoBundle /控制器/ DemoController.php”类型:注释前缀:/演示主要装载机解析时,尝试所有的委托装载机和调用它们支持()方法用给定的资源(@AcmeDemoBundle /控制器/ DemoController.php)和类型(注释)作为参数。当一个装载机的回报真正的,它的load ()方法将调用,它应该返回一个RouteCollection包含路线对象。
创建一个自定义加载程序
从一些自定义源加载路径(即从除了注释,YAML或XML文件),您需要创建一个自定义路径加载程序。该程序应该实现LoaderInterface。
下面的示例加载器加载路由支持资源的类型额外的。类型额外的并不重要,你可以创造任何你想要的资源类型。资源名称本身并不实际使用的例子:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54
名称空间Acme\DemoBundle\路由;使用ob娱乐下载\组件\配置\加载程序\LoaderInterface;使用ob娱乐下载\组件\配置\加载程序\LoaderResolverInterface;使用ob娱乐下载\组件\路由\路线;使用ob娱乐下载\组件\路由\RouteCollection;类ExtraLoader实现了LoaderInterface{私人美元加载=假;公共函数负载(美元资源,美元类型= null){如果(真正的= = =美元这- >加载){扔新\ RuntimeException (“不添加“额外”装载机的两倍);}美元路线=新RouteCollection ();/ /准备一个新的途径美元路径=“额外/{参数}”;美元违约=数组(“_controller”= >AcmeDemoBundle:演示:额外的,);美元需求=数组(“参数”= >“\ d +”,);美元路线=新路线(美元路径,美元违约,美元需求);/ /添加新路线路线集合:美元routeName=“extraRoute”;美元路线- >add (美元routeName,美元路线);美元这- >加载=真正的;返回美元路线;}公共函数支持(美元资源,美元类型= null){返回“额外的”= = =美元类型;}公共函数getResolver(){/ /需要,但可以是空白的,除非你想加载其他资源/ /如果你,使用基类装入器更容易(见下文)}公共函数setResolver(LoaderResolverInterface美元解析器){/ /同上}}请注意
确保您所指定的控制器真的存在。
现在定义一个服务ExtraLoader:
1 2 3 4 5
服务:acme_demo.routing_loader:类:Acme \ DemoBundle \ \ ExtraLoader路由标签:- - - - - -{名称:routing.loader}请注意标签routing.loader。所有服务与这个标签将被标记为潜在路径加载器和添加作为专门的路由器DelegatingLoader。
使用自定义加载程序
如果你没有事,您的自定义路由装载机不被称为。相反,你只需要几行添加到路由配置:
1 2 3 4
# app / config / routing.ymlAcmeDemoBundle_Extra:资源:。类型:额外的这是最重要的部分类型关键。它的值应该是“额外的”。这是这一类型ExtraLoader支持,这将确保它load ()方法被调用。的资源关键是无关紧要的ExtraLoader,所以它被设置为“。”。
请注意
使用自定义路径加载器定义的路线由框架会自动缓存。所以当你改变一些事情在加载程序类本身,别忘了清除缓存。
更高级的加载器
在大多数情况下是最好的实现LoaderInterface自己,但扩展加载程序。知道如何使用这个类LoaderResolver负载二级路由资源。
当然你仍然需要实现支持()和load ()。每当你想要加载另一个资源——例如YAML路由配置文件——你可以调用进口()方法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日24日25日26日
名称空间Acme\DemoBundle\路由;使用ob娱乐下载\组件\配置\加载程序\加载程序;使用ob娱乐下载\组件\路由\RouteCollection;类AdvancedLoader扩展加载程序{公共函数负载(美元资源,美元类型= null){美元集合=新RouteCollection ();美元资源=“@AcmeDemoBundle /资源/ config / import_routing.yml”;美元类型=yaml的;美元importedRoutes=美元这- >导入(美元资源,美元类型);美元集合- >addCollection (美元importedRoutes);返回美元集合;}公共函数支持(美元资源,美元类型= null){返回美元类型= = =“advanced_extra”;}}请注意
导入的路由配置的资源名称和类型可以是任何东西,通常会支持的路由配置加载程序(YAML、XML、PHP、注释等等)。
