了解前端控制器、内核和环境如何协同工作

前端控制器

前端控制器 是一种设计模式；它是应用程序提供的所有请求都必须经过的代码部分。

在 Symfony 骨架中，此角色由 public/ 目录中的 index.php 文件承担。这是处理请求时运行的第一个 PHP 脚本。

前端控制器的主要目的是创建 Kernel 的实例（稍后会详细介绍），使其处理请求并将生成的响应返回到浏览器。

由于每个请求都通过它路由，因此前端控制器可用于在设置内核之前执行全局初始化，或使用附加功能 装饰 内核。示例包括

• 配置自动加载器或添加额外的自动加载机制；
• 通过使用 HttpCache 的实例包装内核来添加 HTTP 级别缓存；
• 启用 Debug 组件。

您可以通过在 URL 中添加前端控制器来选择要使用的前端控制器，例如

1

http://127.0.0.1/index.php/some/path/...

如您所见，此 URL 包含要用作前端控制器的 PHP 脚本。您可以使用它来切换到位于 public/ 目录中的自定义前端控制器。

从技术上讲，在命令行上运行 Symfony 时使用的 bin/console 脚本也是一个前端控制器，只是它不用于 Web，而是用于命令行请求。

内核类

内核 是 Symfony 的核心。它负责设置应用程序使用的所有扩展包，并为它们提供应用程序的配置。然后，它在 handle() 方法中创建服务容器，然后再处理请求。

Symfony 应用程序中使用的内核从 Kernel 扩展而来，并使用 MicroKernelTrait。Kernel 类保留了 KernelInterface 中的一些未实现的方法，而 MicroKernelTrait 定义了几个抽象方法，因此您必须全部实现它们

registerBundles()

它必须返回运行应用程序所需的所有扩展包的数组。

configureRoutes()

它向应用程序添加单个路由或路由集合（例如，加载在某些配置文件中定义的路由）。

configureContainer()

它从配置文件或使用 loadFromExtension() 方法加载应用程序配置，并且还可以注册新的容器参数和服务。

为了填补这些（小的）空白，您的应用程序需要扩展 Kernel 类并使用 MicroKernelTrait 来实现这些方法。Symfony 默认在 src/Kernel.php 文件中提供该内核。

此类使用环境的名称（该名称传递给 Kernel 的 constructor 方法，并且可以通过 getEnvironment() 获得）来决定启用哪些扩展包。该逻辑位于 registerBundles() 中。

您可以自由创建自己的、替代的或额外的 Kernel 变体。您只需要调整您的（或添加新的）前端控制器以使用新的内核。

1
2
3

# .env
# set it to 1 to enable the debug mode
APP_DEBUG=0

1
2
3
4
5

# Use the debug mode defined in the .env file
$ php bin/console command_name

# Ignore the .env file and enable the debug mode for this command
$ APP_DEBUG=1 php bin/console command_name

1
2
3

# config/packages/twig.yaml
twig:
    debug: '%kernel.debug%'

1
2
3
4
5
6
7
8
9
10
11
12

<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.ac.cn/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:twig="http://symfony.ac.cn/schema/dic/twig"
    xsi:schemaLocation="http://symfony.ac.cn/schema/dic/services
        http://symfony.ac.cn/schema/dic/services/services-1.0.xsd
        http://symfony.ac.cn/schema/dic/twig
        http://symfony.ac.cn/schema/dic/twig/twig-1.0.xsd">

    <twig:config debug="%kernel.debug%"/>

</container>

1
2
3
4
5
6
7

// config/packages/twig.php
use Symfony\Config\TwigConfig;

return static function (TwigConfig $twig): void {
    // ...
    $twig->debug('%kernel.debug%');
};

环境

如上所述，Kernel 必须实现另一个方法 - configureContainer()。此方法负责从正确的环境加载应用程序的配置。

配置环境 允许使用不同的配置执行相同的代码。Symfony 默认提供三种环境，分别称为 dev、prod 和 test。

更技术地说，这些名称只不过是从前端控制器传递到 Kernel 构造函数的字符串。然后可以在 configureContainer() 方法中使用此名称来决定要加载哪些配置文件。

Symfony 的默认 Kernel 类通过首先加载在 config/packages/* 上找到的配置文件，然后加载在 config/packages/ENVIRONMENT_NAME/ 中找到的文件来实现此方法。如果您需要更复杂的配置加载方式，您可以自由地以不同的方式实现此方法。

1
2
3
4
5
6

your-project/
├─ var/
│  ├─ cache/
│  │  ├─ dev/   # cache directory for the *dev* environment
│  │  └─ prod/  # cache directory for the *prod* environment
│  ├─ ...