Skip to content

1. 简介

本文档的 PDF 在 |此处|。

本文档的代码在 |此处|。

本文档由 Anthropic 的 AI Claude 生成。它是继“[Laravel] Web 框架分步入门”(2026 年)之后的文档,而该文档又继承了“[Flask] Web 框架分步入门”、“[Spring MVC] Web 框架分步入门”、“[ASP.NET Core MVC] Web 框架分步入门”以及“[NestJS] Web 框架分步入门”(2026 年)。本文档仍处于[PHP] 的生态之内,但更换了框架:

  • [Laravel] 框架被[Symfony] 8.1 框架取代,仍然使用[PHP] 语言(8.4 或更高版本);
  • [Blade] 视图被 [Twig] 视图取代,后者是[Symfony] 的视图引擎;
  • 使用[Laravel] 中的规则和表单请求([FormRequest])进行的验证,被Validator 组件(来自 [Symfony],使用约束,以 [PHP] 属性的形式编写)以及其 Form 组件取代,后者用类来描述表单;
  • 守卫、中间件和 [Gate] 组件(来自 [Laravel] )被 Security 组件(来自 [Symfony])取代:防火墙、身份验证器、角色、密码哈希和尝试次数限制器,并辅以用于 JWT 令牌的 [firebase/php-jwt] 库;
  • 但 [Symfony] 中不存在中间件组件:事件监听器用于介入请求的处理过程;
  • ORM [Eloquent] 被 [Doctrine] 取代,该 ORM 以 [Symfony] 为基础,而 Symfony 又以 [MySQL] 为基础。

本文档紧密遵循 [Laravel] 课程的结构:先是众多小项目,每个项目只聚焦一个概念,然后是一个完整的案例研究——一个用于安排医疗诊所预约的 Web 应用——所有文件都有完整注释。这些示例的编号和涵盖的主题与 [Laravel]、[Flask]、[Spring MVC]、和 [ASP.NET Core MVC] 课程中相同:熟悉其中某门课程的读者可以逐例比较这些框架。不过这并非必需:本文档自成一体,不要求事先了解这些框架。仅有的先决条件是对 Web 编程(HTTP 协议、HTML 语言)的基本了解以及对 [PHP] 语言基础(变量、数组、函数、类)的掌握。课程 “通过示例学习 PHP7 语言入门”(2019 年)为需要先学习语言本身的读者介绍了该语言;这里用到的 [PHP] 8 的新特性(构造函数属性提升、[readonly] 类、属性、枚举、命名参数、空安全运算符等)会在首次出现时加以解释。

1.1. Symfony 在 Web 应用中的角色

Web 应用通常按层构建,每一层只与相邻的层通信:

Image

  • Web 层接收来自浏览器的 HTTP 请求,并向其返回 HTML 页面。这一层正是 [Symfony] 帮助我们编写的部分;
  • 业务层包含应用的业务规则(例如“一位患者只能有一个即将到来的预约”)。它对 Web 一无所知:它同样可以为命令行应用提供服务;
  • 数据访问层(DAO 层,即 Data Access Object)负责读写数据库。我们将使用 [Doctrine],这是与 [Symfony] 搭配的 ORM(Object Relational Mapper),它把表中的行映射为 [PHP] 对象。

Web 层本身遵循 MVC(Model-View-Controller)模式:

  • 控制器(C)是一个 [PHP] 类,其方法称为动作,每个方法处理一种特定类型的请求(例如 [GET /schedule])。动作读取请求参数,通过业务层处理请求,然后选择要显示的视图;
  • 模型(M)是动作传递给视图的数据集合;
  • 视图(V)是一个 [Twig] 文件(扩展名 [.html.twig]):一个包含 [{{ ... }}] 表达式以及 [{% if %}]、[{% for %}]... 指令的 HTML 页面,[Twig] 引擎会用模型中的数据替换它们。

关于术语的说明,以避免混淆:在 [Symfony] 中,表示数据库表的类称为实体 (文件夹 [src/Entity])。因此,在本文档中,术语“模型” 始终指视图模型 (传递给视图的数据),或者在第 2 章中指动作模型 (动作接收的数据)。术语“模板” 指其他页面所继承的公共视图(视图一章)。

请求的处理按图中的编号步骤进行:

  • 1:浏览器发送一个 HTTP 请求,例如 [GET /schedule?doctorId=1&day=2026-09-26];
  • 2:Web 服务器接收请求,并通过 [Symfony] 应用的 [public/index.php] 文件把请求交给该应用。开发期间,该服务器是 [PHP] 自带的服务器,通过命令 [php -S localhost:8000 -t public] 启动;在生产环境中,则会是 [nginx] 或 [Apache] 这样的服务器,并与 [PHP-FPM] 搭配。文件 [public/index.php] 把请求交给应用的内核 (kernel),内核让请求经过一系列事件:来自 [Symfony] 和应用本身的类,以及监听器 (会话、安全、语言等)都会参与其中。其中一个监听器把请求的路径与应用的路由进行比较,并选出负责该请求的动作:这就是路由;
  • 3:动作向业务层请求所需的数据;必要时,业务层会联系 DAO 层,由 DAO 层用 SQL 查询 [MySQL] 数据库;
  • 4:动作构造视图的模型 M,并指示 [Twig] 引擎生成页面(方法 [render]);
  • 5:视图生成的 HTML 页面就是动作的响应,由 [Symfony] 返回给浏览器。

[Symfony] 与 [Laravel] 并列,是 [PHP] 世界中两大 Web 框架之一。它免费且开源,由 Fabien Potencier(以及法国公司 SensioLabs)于 2005 年创建,凡是 [PHP] ([Windows]、[Linux]、[macOS])能运行的地方它都能运行,而 [PHP] 几乎被所有 Web 托管服务商支持。[Symfony] 首先是约五十个组件的集合——它们是独立的库(HTTP 请求和响应、路由、控制台、表单、验证、安全等)——因口碑极佳而被其他项目采用:[Laravel] 本身就构建在其中若干组件之上,上一门课程的读者已经接触过它们。[Symfony] 框架通过 Bundle (集成包)和负责创建应用对象的服务容器 来组装这些组件。与 [Laravel] 相比,[Symfony] 做出了明确的选择:没有外观和全局函数,而是通过依赖注入获得服务;在 YAML 文件中进行显式配置;用 [PHP] 属性([#[Route]]、[#[Assert\NotBlank]]……)来描述代码;以及 ORM [Doctrine],它把对象与其持久化分离开来。它是一个以严谨、文档和版本策略著称的框架:每六个月发布一个次要版本,每两年发布一个“长期支持”版本,并保证一个没有弃用警告的应用无需修改即可过渡到下一个主版本。[Symfony] 既可以创建向 [JavaScript] 客户端([Angular]、[React]、[Vue.js]、[Flutter]...)返回 JSON 的服务器,也可以创建传统的 Web 应用,即由服务器生成 HTML 页面、浏览器只负责显示。本文档探讨的正是第二种用法。

[PHP] 的一个特点在很大程度上解释了[Symfony]:应用在每个请求时都会重新构建然后被丢弃(示例 01)。[Symfony] 通过把其配置一次性编译成 [PHP] 代码来弥补这一代价,这些代码存放在缓存 ([var/cache] 文件夹)中。我们会经常回到这一点。

1.2. 所用工具

这些示例是使用以下工具编写和测试的(它们的安装见附录):

  • [PHP] 8.4(任何 8.4 或更高版本均可),带有扩展 [intl]、[mbstring]、[openssl]、和 [pdo_mysql];
  • [Composer] 2,[PHP] 的库管理器;
  • 编辑器 [Visual Studio Code],带有扩展 [PHP Intelephense] (代码分析)、[Twig Language 2] (视图)和 [YAML] (配置文件);
  • 一款现代浏览器([Chrome]、[Firefox]、[Edge]);
  • 命令行工具 [curl],它显示原始的 HTTP 响应([Windows] 10 和 11 已内置);
  • 数据库管理系统(SGBD)[MySQL] (或 [MariaDB]),例如 [Laragon] 在 [Windows] 下提供的那个,从数据访问一章开始使用,并用于案例研究。在 [Windows] 下,[Laragon] 可一次性安装 [PHP]、[Composer]、和 [MySQL] 。

[Symfony] 及其他库并不属于 [PHP]:[Composer] 在安装时会从 [Packagist] 仓库下载它们(因此当天必须连接互联网),并把它们放入 [vendor] 文件夹。每个项目在 [composer.json] 文件中描述其所用的库。下表列出了主要的库及所用版本:

[symfony/framework-bundle]
框架:核心、路由、控制器、服务容器、配置、会话、缓存;它会安装所需的组件([symfony/http-foundation]、[symfony/http-kernel]、[symfony/routing]、[symfony/dependency-injection]……)
8.1.7
[symfony/twig-bundle]、[twig/twig]
[Twig] 视图(视图一章)
8.1.7, 3.30.0
[symfony/validator]、[symfony/form]
验证(从示例 08 开始)和表单(从示例 17 开始)
8.1.7
[symfony/security-bundle]
身份验证和授权(安全一章)
8.1.7
[symfony/translation]
翻译(示例 09 和 22)
8.1.7
[doctrine/orm]、[doctrine/dbal]、[doctrine/doctrine-bundle]
数据库访问(示例 28 和案例研究)
3.7.2, 4.5.0, 3.3.2
[firebase/php-jwt]
JWT 令牌(身份验证一章)
7.2.0

[Symfony] 通常通过以下命令创建一个完整项目来安装:

composer create-project symfony/skeleton my-project

或者使用 [Symfony] 命令行工具([symfony] 程序;见附录):[symfony new my-project --webapp]。[Composer] 随后会下载 [Symfony] 应用的骨架,接着下载其各个库。骨架中还包含 [Symfony Flex],这是 [Composer] 的一个插件,每当安装一个库([composer require twig])时,它就会根据在线发布的模板 写入该库自己的配置文件。真正启动一个项目就是这样做的。就学习而言,这种方式有一个缺点:文件会自己冒出来,而你不知道它们有什么用。因此,本文档中的示例从另一端开始:示例 01 是尽可能小的 [Symfony] 应用,每个示例只添加自己需要的文件,并手工编写和注释。结尾的案例研究遵循标准 [Symfony] 应用的结构。

1.3. 运行案例研究

1.3.1. 安装 Laragon

案例研究需要 SGBD、MySQL、PHP 解释器,以及 PHP 和 [composer] 包安装器。Laragon 可以提供所有这些,甚至更多。截至 2026 年 9 月,Laragon 可在 URL 和 [Download Laragon – Fast & Modern Dev Environment ] 获得。Laragon 自带的工具可让你安装 PHP 服务器以及 SGBD 和 [MySQL]:

Image

  • 在 [1] 中,是一个 Apache Web 服务器;
  • 在 [2] 中,是 SGBD 和 [MySQL];
  • 在 [3] 中,是一个我们不会使用的消息工具;
  • [4] 启动所有服务(Apache、[MySQL]、MailPit);
  • [5] 显示 URL 和 [http://localhost] 的网页。默认情况下,该 URL 指向 <laragon-install>\www 文件夹,其中 <laragon-install> 是 Laragon 的安装文件夹;
  • 在 [6] 中,启动 HeidiSQL 工具,它可以让你管理 MySQL 数据库。我们将使用该工具创建案例研究所用的数据库;
  • 在 [7] 中,打开一个终端;Laragon 所需的所有二进制文件都在 PATH 中;
  • 在 [8] 中,在与 URL 和 [http://localhost] 关联的文件夹中打开一个 Windows 资源管理器窗口;

Laragon 的安装文件夹包含以下内容:

 
  • 在 [1] 中,[bin] 文件夹包含许多应用:
  • 在 [1] 中,是 Apache Web 服务器;
  • 在 [2] 中,是一个命令行终端;
  • 在 [3] 中,是一个 [git] 客户端,可用于管理项目的不同版本;
  • 在 [4] 中,是一个数据库管理器;
  • 在 [5] 中,是一个邮件管理器;
  • 在 [6] 中,是 SGBD 和 [MySQL];
  • [7] 是另一个 Web 服务器;
  • 在 [8] 中,是 [node.js] ,用于运行 JavaScript 脚本;
  • [9] 是一个文本编辑器;
  • [10] 是 PHP 解释器;
  • [11] 是 [Python] 解释器;
  • [12] 是一个缓存服务器;

Laragon 提供了一套完整的开发环境。在本课程中,我们将使用:

  • SGBD,[MySQL],[6],以及用于图形化管理的 [heidisql] 工具;
  • PHP 8.5 解释器;
  • [composer] 包安装器;

案例研究的 README 指出,必须在终端中输入以下命令:

composer install

以安装示例和案例研究所需的 PHP 包。

php -S localhost:8000 -t public

以运行某个示例或案例研究。如果你在 VSCode 中使用 [PowerShell] 终端,会遇到以下问题:安装 Laragon 之后,Windows 机器的 PATH 目录中既没有 [composer] 也没有 [php]。因此,这些命令在 VSCode 终端中无法被识别。

要把 [composer] 和 [php] 加入 Windows 机器的 PATH,请以 [administrator] 模式打开一个 PowerShell 终端,然后输入以下命令:

[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\laragon\bin\composer","Machine")
[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\laragon\bin\php\php-8.5.11-nts-Win32-vs17-x64","Machine")

请根据你的环境调整这两个高亮显示的路径。

你需要重启 VSCode,这些更改才会生效。

要创建案例研究所需的 [MySQL] 数据库,请按以下步骤操作:

 
  • 在 [1] 中,必须启动所有服务;
  • 在 [2] 中,[Database] 选项可让你管理数据库;

[Database] 选项会启动一个名为 HeidiSQL 的工具:

  • 在 [1] 中,可以选择各种 SGBD 选项。默认值是 SGBD MySQL。这是可以接受的;
  • 在 [2] 中,登录 HeidiSQL;
  • 在 [1-2] 中,运行 SQL 文件,然后选择 [dbrdvmedecins2.sql] 文件,你可以在 [symfony-sept-2026/rdvmedecins2-symfony/database] 文件夹中找到它:

Image

运行 [3] 文件将创建案例研究所用的 [dbrdvmedecins2] 数据库。要查看它,请在 HeidiSQL 中按 F5 刷新显示:

编者注:以下截图显示的是名为 [dbrdvmedecins] 的数据库,而案例研究中的数据库名为 [dbrdvmedecins2]。这两个数据库几乎完全相同,因此我们认为没有必要重新截图。

注释结束

Image

数据库 [dbrdvmedecins] 已创建。其内容如下:

Image

  • 在 [1-3] 中,是表 [clients];
    • [id] 是表的主键;
    • [version] 是该行的版本号。每次修改该行时,这个数字都会递增;
    • [titre, nom, prenom] 用于标识该人员;

Image

  • 在 [1-3] 中,是表 [medecins];
    • [id] 是表的主键;
    • [version] 是该行的版本号;
    • [titre, nom, prenom] 用于标识该人员;

Image

  • 在 [1-3] 中,是医生预约时间段的表:
    • [id]:主键;
    • [version]:行版本号;
    • [id-medecin]:引用医生主键的外键;
    • [hdebut, mdebut]:预约开始时间的小时和分钟。因此,[8,20] 表示上午 8:20。
    • [hfin, mfin]:诊疗结束时间的小时和分钟。

Image

  • 在 [1-3] 中,是已安排预约的 [rv] 表;
    • [id]:主键;
    • [version]:版本号;
    • [jour]:预约日期;
    • [id_creneau]:引用预约时间段主键的外键。由于时间段与医生相关联,因此我们可以知道由哪位医生负责这次预约;
    • [id_client]:指向参加预约的患者编号(主键)的外键;

Image

  • 在 [1-3] 中,表 [users] 列出了有权使用 RdvMedecins 应用的用户;
    • [id, version]:主键、版本号;
    • [login, password]:用户凭据;
    • [nom]:用户名称;
    • [role]:用户的角色。[ADMIN] 拥有完整的访问权限。[USER] 只有只读权限。该用户可以查看医生的日程,但不能安排或取消预约;

1.3.2. 运行案例研究

审阅者注:我建议读者立即按下文所述运行案例研究。当你完全理解了这个预约安排应用的用途之后,请让你喜欢的 AI 按如下方式修改该应用:从现在起,每位医生将能够:

  • 设置自己在两个日期之间的预约时间段。这样他们就可以根据需要调整自己的日程;
  • 在某一天从日历中移除某些时间段——例如,当他们因个人原因无法出诊时;

这一修改并不简单,因为它涉及数据库结构的变更。请让 AI 为你提供新的应用代码以及创建新数据库的 SQL 脚本。为此,你需要向它提供包含完整项目的 ZIP 文件以及旧数据库的 SQL 脚本。

另外,我没有审阅 Claude 创建的这门课程。他之前已经制作过 [NestJS]、[ASP.NET Core MVC]、[Spring MVC] 和 [Flask] 课程,这些课程都很完美。我假定这一门也同样如此。如果你在理解某些内容时遇到问题,解决办法始终是一样的:请你喜欢的 AI 解释你不理解的地方。例如,Claude 就非常擅长这一点。你可能需要把你不理解的示例“上传”给他。

注释结束。

本文档末尾的案例研究是一个完整的应用。读者很可能希望在深入了解框架的细节之前先看到它运行起来:下面介绍如何运行它。它位于 [rdvmedecins2-symfony] 文件夹中,与 [examples] 文件夹并列:

1
2
3
symfony-sept-2026/
├── examples/
└── rdvmedecins2-symfony/

你必须已安装 [PHP] (8.4 或更高版本)、[Composer]、[Visual Studio Code]、以及 [MySQL] (见附录)。然后:

  • 通过运行 [dbrdvmedecins2] 数据库的 创建脚本 [rdvmedecins2-symfony/database/dbrdvmedecins2.sql] 来创建该数据库。使用 [Laragon] 时,打开 [HeidiSQL] 工具(Database 按钮),然后通过 File / Run SQL 菜单运行该脚本。在命令行中,在 [rdvmedecins2-symfony] 文件夹下执行:
mysql -u root < database/dbrdvmedecins2.sql
  • 在 [rdvmedecins2-symfony] 文件夹 中用 [Visual Studio Code] 打开它(File 菜单 / Open Folder),然后打开一个终端(Terminal 菜单 / New Terminal);
  • 安装应用的库:[Composer] 读取文件 [composer.json],下载 [Symfony] 及其他库,并把它们放入应用的 [vendor] 文件夹(需要几十秒):
composer install
  • 检查与数据库的连接。应用连接到位于 [MySQL] 的 [127.0.0.1],端口 3306,使用用户 [root] 且没有密码 (即 [Laragon] 的默认设置)。如果你的 [root] 账户有密码,请把它填写到应用的 [.env] 文件中,在 [DATABASE_URL] 这一行:[mysql://root:myPassword@127.0.0.1:3306/dbrdvmedecins2...];
  • 运行应用:
php -S localhost:8081 -t public
  • [PHP] 显示:
[Sun Sep 27 18:40:12 2026] PHP 8.4.21 Development Server (http://localhost:8081) started

开发服务器在本机的 8081 端口上监听([localhost])。收到的每个请求都会记录在控制台中,同时还有来自 [Symfony] 的消息(选中的路由、发送给数据库的 SQL 命令);

  • 在浏览器中打开地址 [http://localhost:8081] :

Image

  • 使用某个演示账户登录,其密码与用户名相同:[admin] (管理员)、[pelissier]、[tatou]、[dupont] (医生)、[martin]、[durand]、[bistrou]、[german] (患者)。你还必须输入图片中的字符,大小写均可。

一个 [PHP] 应用在启动时并不会读取数据库:连接错误只会在第一个查询数据库的页面上出现,即在建立连接时。[Symfony] 随后会显示其详细的错误页面,并把错误记录到服务器控制台。如果消息是 [SQLSTATE[HY000] [2002] Connection refused],则表示 [MySQL] 尚未启动;如果是 [[1045] Access denied for user 'root'@'localhost'],则表示密码不正确;如果是 [[1049] Unknown database 'dbrdvmedecins2'],则表示 SQL 脚本没有执行;如果是 [could not find driver],则表示 [pdo_mysql] 扩展在 [PHP] 中没有启用。如果页面显示 [Failed opening required '.../vendor/autoload_runtime.php'],则表示 [composer install] 没有执行;如果 [php -S] 命令失败并显示消息 [Failed to listen on localhost:8081 (reason: Address already in use)],则表示 8081 端口已被占用(例如被应用的另一个版本占用)。应用的 [README.md] 文件还描述了其他情形。请在终端中使用 [Ctrl-C] 停止应用。

文档末尾的案例研究演示了如何使用该应用,然后逐个解释它的每个文件。

1.4. 示例

示例存放在 [examples] 文件夹中,每个示例一个子文件夹:

examples/
├── 01-structure/
├── 02-routing/
├── ...
├── 28-layers/
├── common/
│   ├── bootstrap/
│   ├── BootstrapController.php
│   └── README.md
└── composer.json

每个示例都是一个可独立运行的小应用([Symfony])。所有示例使用相同的库,它们在文件 [examples/composer.json] 中描述:

{
    "name": "course/symfony-examples",
    "description": "The 28 examples of the course [Step-by-step introduction to the Symfony web framework]: a single vendor folder, shared by all the examples",
    "type": "project",
    "license": "MIT",
    "require": {
        "php": ">=8.4",
        "ext-intl": "*",
        "ext-pdo_mysql": "*",
        "doctrine/doctrine-bundle": "^3.3",
        "doctrine/orm": "^3.7",
        "firebase/php-jwt": "^7.2",
        "symfony/asset": "^8.1",
        "symfony/console": "^8.1",
        "symfony/dotenv": "^8.1",
        "symfony/form": "^8.1",
        "symfony/framework-bundle": "^8.1",
        "symfony/intl": "^8.1",
        "symfony/lock": "^8.1",
        "symfony/rate-limiter": "^8.1",
        "symfony/security-bundle": "^8.1",
        "symfony/serializer": "^8.1",
        "symfony/translation": "^8.1",
        "symfony/twig-bundle": "^8.1",
        "symfony/validator": "^8.1",
        "symfony/yaml": "^8.1",
        "twig/intl-extra": "^3.30",
        "twig/twig": "^3.30"
    },
    "autoload": {
        "psr-4": {
            "Common\\": "common/"
        }
    },
    "config": {
        "optimize-autoloader": true,
        "sort-packages": true
    },
    "minimum-stability": "stable",
    "prefer-stable": true
}
  • 第 6–29 行:示例所需的内容:[PHP] 8.4 或更高版本,扩展 [intl] (按语言区域格式化数字和日期,示例 16)和 [pdo_mysql](访问 [MySQL],示例 28),随后按字母顺序列出各个库:[Doctrine] (示例 28)、[firebase/php-jwt] (JWT 令牌,示例 25),以及示例所用的 [Symfony] 组件和 Bundle。[^8.1] 的含义是“8.1 版本,或者主版本 8 之内更新的版本”;
  • 第 30–34 行:[Common] 命名空间中的类位于 [common] 文件夹中(PSR-4 规则,见示例 01):这是为 [Bootstrap] 提供服务的共享控制器(示例 15);
  • 其余各行配置 [Composer] 的行为:类加载器经过优化,库按名称排序,并且只接受稳定版本。

要运行这些示例,首先要在打开到 [examples] 文件夹的终端窗口中一次性安装它们的库:

composer install

[Composer] 会创建 [examples/vendor] 文件夹,该文件夹由全部 28 个示例共享,以及 [composer.lock] 文件,其中记录了所安装的确切版本(见案例研究)。[common] 文件夹包含 CSS 框架 [Bootstrap]([common/bootstrap])——由对页面进行格式化的示例共享(从示例 15 开始)——以及为其提供服务的控制器([common/BootstrapController.php];见示例 15)。

几乎所有示例都具有相同的结构——即标准 [Symfony] 应用精简到只剩要点后的结构。例如示例 13 中的这个:

13-first-view/
├── bin/
│   └── console
├── config/
│   ├── packages/
│   │   ├── framework.yaml
│   │   └── twig.yaml
│   ├── bundles.php
│   ├── routes.yaml
│   └── services.yaml
├── public/
│   └── index.php
├── src/
│   ├── Controller/
│   │   └── ViewsController.php
│   ├── Model/
│   │   └── PageModel.php
│   └── Kernel.php
├── templates/
│   └── views/
│       ├── unknown.html.twig
│       └── index.html.twig
├── var/
├── .env
└── composer.json
  • [public/index.php]:所有请求的入口点;[src/Kernel.php]:应用内核;[bin/console]:[Symfony] 的命令行工具(示例 01);
  • [config]:配置:应用的 Bundle([bundles.php])、每个 Bundle 的配置(文件夹 [packages])、路由([routes.yaml],示例 02)、服务([services.yaml],示例 06);
  • [src]:应用的类:控制器([src/Controller])、模型、服务等;
  • [templates]:[Twig] 视图(从视图一章开始);
  • [.env]:该示例特有的设置(示例 01);[var]:[Symfony] 自己写入的文件(缓存、会话)。

要运行一个示例,请在其文件夹中打开一个终端(在 [Visual Studio Code] 中:右键单击示例文件夹,然后选择“Open in Integrated Terminal”),并输入:

php -S localhost:8000 -t public

所有示例都监听 8000 端口:同一时间只能运行一个(或者必须更改端口:[php -S localhost:8001 -t public])。在终端中使用 [Ctrl-C] 停止服务器。修改 [PHP] 文件、视图或配置之后无需重启服务器:更改会在下一个请求时生效(示例 01)。

当你在 [examples] 文件夹中用 [Visual Studio Code] 打开项目时,[PHP Intelephense] 扩展会分析所有文件,包括 [Symfony] 位于 [vendor] 文件夹中的文件:在每个文件中,你都可以使用代码补全、跳转到类或方法的定义([F12] 键)以及错误提示。由于所有示例的类都在 [App] 命名空间中,扩展可能会标记“重复”的类:这对执行没有影响,因为每个示例都独立运行。要避免这些警告,只需打开示例自己的文件夹即可。

1.5. 文档内容

文档的组织结构如下:

动作、路由、响应
从请求到动作:路由、控制器、响应、重定向、共享服务
01 至 06
动作模型
请求参数:绑定、转换、验证、POST 请求
07 至 12
视图及其模板
[Twig]、模板、宏、[Symfony] 表单、验证、PRG、防 CSRF 保护
13 至 21
国际化
一个法语和英语的应用
22
数据作用域
请求、会话、缓存、Cookie
23
请求的生命周期
内核事件、参数解析器、异常处理
24
身份验证和授权
防火墙、存放在 Cookie 中的 JWT 身份验证器、角色、验证码(CAPTCHA)、尝试次数限制
25–27
分层架构和数据访问
使用 [Doctrine] 和 [MySQL]
28
案例研究
RdvMedecins 应用,逐文件讲解
-

每个示例只引入少量新概念,各章环环相扣:最好按顺序阅读。而案例研究则运用了前面各章的所有概念:只要相关,它的说明都会指回该概念被引入的那个示例。附录介绍了如何安装这些工具:[PHP]、[Composer]、[Visual Studio Code] 及其扩展、[MySQL] 以及 [Laragon]、[curl] 和 [symfony] 工具。