SymfonyChinaSF中国 SFC
4.2翻译中 Symfony 4.2版技术博客翻译中 本月内将对Symfony 4.2技术博客翻译完毕
注册/登录
  1. Home
  2. 中文文档
  3. 组件
  4. Routing组件
  5. 如何包容外部路由资源

如何包容外部路由资源

3.4 版本
维护中的版本
4.2 master 2.8 LTS

所有的路由都通过一个单一的配置文件加载-通常是app/config/routing.yml(请看加载路由)。但是，如果你使用Annotation路由，你需要用Annotation将路由指向到到控制器。这可以通过“importing”导入目录到路由配置中来实现：

1
2
3
4

# app/config/routing.yml
app:
    resource: '@AppBundle/Controller/'
    type:     annotation # required to enable the Annotation reader for this resource
1
2
3
4
5
6
7
8
9
10

<!-- app/config/routing.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<routes xmlns="http://symfony.com/schema/routing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/routing
        http://symfony.com/schema/routing/routing-1.0.xsd">
 
    <!-- the type is required to enable the annotation reader for this resource -->
    <import resource="@AppBundle/Controller/" type="annotation"/>
</routes>
1
2
3
4
5
6
7
8
9
10
11

// app/config/routing.php
use Symfony\Component\Routing\RouteCollection;
 
$collection = new RouteCollection();
$collection->addCollection(
    // second argument is the type, which is required to enable
    // the annotation reader for this resource
    $loader->import("@AppBundle/Controller/", "annotation")
);
 
return $collection;

当从YAML导入资源时，根键（如app）是没有意义的。只要保证它是唯一的，没有其它行覆盖它即可。

resource键用来加载指定的路由资源。在本例中，资源是一个目录，其@AppBundle快捷语法能够解析AppBundle的完整路径。当路由指定一个目录时，该目录中的所有文件都会被解析到路由中去。

你还可以包容其他路由配置文件，以下方法经常用来导入第三方路由：

1
2
3

# app/config/routing.yml
app:
    resource: '@AcmeOtherBundle/Resources/config/routing.yml'
1
2
3
4
5
6
7
8
9

<!-- app/config/routing.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<routes xmlns="http://symfony.com/schema/routing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/routing
        http://symfony.com/schema/routing/routing-1.0.xsd">
 
    <import resource="@AcmeOtherBundle/Resources/config/routing.xml" />
</routes>
1
2
3
4
5
6
7
8
9

// app/config/routing.php
use Symfony\Component\Routing\RouteCollection;
 
$collection = new RouteCollection();
$collection->addCollection(
    $loader->import("@AcmeOtherBundle/Resources/config/routing.php")
);
 
return $collection;

在引入的路由中加前缀 

你也可以选择为导入的路由提供一个“prefix”前缀。例如，假设你希望在AppBundle的所有路由中使用前缀/site（ 如用/site/blog/{slug}代替 /blog/{slug}）：

1
2
3
4
5

# app/config/routing.yml
app:
    resource: '@AppBundle/Controller/'
    type:     annotation
    prefix:   /site
1
2
3
4
5
6
7
8
9
10
11
12

<!-- app/config/routing.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<routes xmlns="http://symfony.com/schema/routing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/routing
        http://symfony.com/schema/routing/routing-1.0.xsd">
 
    <import
        resource="@AppBundle/Controller/"
        type="annotation"
        prefix="/site" />
</routes>
1
2
3
4
5
6
7
8
9
10

// app/config/routing.php
use Symfony\Component\Routing\RouteCollection;
 
$app = $loader->import('@AppBundle/Controller/', 'annotation');
$app->addPrefix('/site');
 
$collection = new RouteCollection();
$collection->addCollection($app);
 
return $collection;

从新的路由资源中加载的每一个路由之路径，现在都被添加了/site字符串前缀。

添加一个需要的主机并引入到路由 

你可以在引入的路由中设置主机的正则表达式。参考如何基于Host来匹配路由了解详情。

本文，包括例程代码在内，采用的是 Creative Commons BY-SA 3.0 创作共用授权。

登录symfonychina 发表评论或留下问题（我们会尽量回复）