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

编辑本页

警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 5.0,现已不再维护。

本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。

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

配置环境部分解释了Symfony如何使用环境以不同的配置设置运行应用程序的基础知ob娱乐下载识。本节将更深入地解释引导应用程序时会发生什么。要进入这个过程,你需要了解三个共同工作的部分:

请注意

通常,您不需要定义自己的前端控制器或内核类,因为Symfoob娱乐下载ny提供了合理的默认实现。本文的目的是解释幕后发生的事情。

前置控制器

前端控制器是一种设计模式;这是一段代码所有由应用程序提供服务的请求贯穿始终。

在Symfonob娱乐下载y Skeleton中,此角色由index . php公共/目录中。这是处理请求时执行的第一个PHP脚本。

前端控制器的主要用途是创建对象的实例内核(稍后将详细介绍),让它处理请求并将结果响应返回给浏览器。

因为每个请求都要通过它路由,所以可以使用前端控制器在设置内核之前执行全局初始化装修具有附加特性的内核。例子包括:

  • 配置自动装填机或添加额外的自动装填机制;
  • 的实例包装内核,从而添加HTTP级缓存HttpCache
  • 使调试组件

你可以通过在URL中添加前置控制器来选择它,比如:

1
http://localhost/index.php/some/path/..。

如您所见,这个URL包含用作前端控制器的PHP脚本。您可以使用它切换到一个自定义的前端控制器,位于公共/目录中。

另请参阅

你几乎不希望在URL中显示前端控制器。这可以通过配置web服务器来实现,如图所示配置Web服务器

技术上,bin /控制台在命令行上运行Symfony时使用的脚本也是一个前ob娱乐下载端控制器,只是它不用于web,而是用于命令行请求。

内核类

内核是Symfony的核心。ob娱乐下载它负责设置应用程序使用的所有包,并为它们提供应用程序的配置。然后,它在服务容器中的请求之前创建服务容器处理()方法。

Symfony应用程序中使用的内核从ob娱乐下载内核并使用MicroKernelTrait.的内核类中留下一些方法KernelInterface未实现和MicroKernelTrait定义了几个抽象方法,所以你必须实现它们:

registerBundles ()
它必须返回运行应用程序所需的所有bundle的数组。
configureRoutes ()
它向应用程序添加单独的路由或路由的集合(例如加载一些配置文件中定义的路由)。
configureContainer ()
它从配置文件或使用loadFromExtension ()方法,也可以注册新的容器参数和服务。

为了填补这些(小的)空白,您的应用程序需要扩展Kernel类并使用MicroKernelTrait来实现这些方法。ob娱乐下载默认情况下,Symfony在src / Kernel.php文件。

这个类使用环境的名称——它被传递给内核构造函数方法,可通过getEnvironment ()-决定启用哪些包。这样做的逻辑是正确的registerBundles ()

您可以自由地创建自己的、替代的或附加的内核变体。您所需要的只是调整您的(或添加一个新的)前端控制器来使用新的内核。

请注意

的名称和位置内核不是固定的。当把在一个应用程序中加入多个内核,因此,例如,添加额外的子目录可能是有意义的src / admin / AdminKernel.php而且src / api / ApiKernel.php.重要的是前端控制器能够创建适当内核的实例。

请注意

还有很多内核可以用于,例如重写默认目录结构.但是很有可能你不需要通过几个来快速改变这些东西内核实现。

调试模式

的第二个参数内核构造函数指定应用程序是否应在“调试模式”下运行。不管配置环境, Syob娱乐下载mfony应用程序可以在调试模式设置为时运行真正的

这会影响应用程序中的许多事情,比如在错误页面上显示堆栈跟踪,或者缓存文件是否在每个请求上动态重建。虽然不是必需的,但调试模式通常设置为真正的dev而且测验环境和刺激环境。

类似于配置环境您还可以使用env文件

1 2 3
# .env#设置为1以启用调试模式APP_DEBUG = 0

属性可以覆盖命令的此值APP_DEBUG值,然后运行它们:

1 2 3 4 5
使用.env文件中定义的调试模式PHP bin/console命令名#忽略.env文件,并打开此命令的调试模式APP_DEBUG=1 php bin/console command_name . txt

在内部,调试模式的值变为kernel.debug参数。服务容器.如果你查看应用程序配置文件,你会看到使用的参数,例如,打开Twig的调试模式:

  • YAML
  • XML
  • PHP
1 2 3
#配置/包/ twig.yaml枝:调试:“% kernel.debug %”

的环境

如上所述,内核必须实现另一个方法-configureContainer ().该方法负责从右侧加载应用程序的配置环境

配置环境允许使用不同的配置执行相同的代码。ob娱乐下载Symfony提供了三个默认调用的环境dev刺激而且测验

从技术上讲,这些名称不过是从前端控制器传递到内核的构造函数。的名称中使用此名称configureContainer ()方法来决定加载哪些配置文件。

ob娱乐下载Symfony的默认内核类通过首先加载在配置/包/ *然后,在配置/包/ ENVIRONMENT_NAME /.如果您需要一种更复杂的加载配置的方法,您可以自由地以不同的方式实现此方法。

环境和缓存目录

ob娱乐下载Symfony在许多方面利用了缓存:应用程序配置、路由配置、Twig模板等都被缓存到存储在文件系统文件中的PHP对象中。

默认情况下,这些缓存文件主要存储在var /缓存/目录中。但是,每个环境都会缓存自己的一组文件:

1 2 3 4 5 6
Your-project /├─var/│├─cache/││├─dev/ # cache directory for *dev* environment││├─…

有时,在调试时,检查缓存文件以了解某些东西是如何工作的可能是有帮助的。这样做时,请记住查看您正在使用的环境的目录(最常见的是dev /在开发和调试时)。虽然它可以变化,但/ dev / var /缓存目录包括以下内容:

appDevDebugProjectContainer.php
缓存的“服务容器”,表示缓存的应用程序配置。
appDevUrlGenerator.php
由路由配置生成并在生成url时使用的PHP类。
appDevUrlMatcher.php
用于路由匹配的PHP类——请查看这里的编译正则表达式逻辑,该逻辑用于将传入url匹配到不同的路由。
树枝/
这个目录包含所有缓存的Twig模板。

请注意

您可以更改缓存目录的位置和名称。欲了解更多信息,请阅读文章如何覆盖Symfony的默认目录ob娱乐下载结构

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。