# Symfony 组件所有 38 个 Symfony 组件的完整参考 — PHP 8.3+ 和 Symfony 7.x 的模式、API、配置和最佳实践。 ## 成分索引 ### HTTP 和运行时 * **HttpFoundation** — 面向对象的 HTTP 请求/响应替换 PHP 全局变量 → [参考]() * **HttpKernel** — 请求处理、内核事件、控制器解析、中间件 → [参考]() * **PSR-7 Bridge** — 双向 HttpFoundation ↔ PSR-7 转换 → [参考]() * **运行时** - 多个运行时环境的解耦引导 → [参考]() ### 消息传递 * **Messenger** — 同步/异步消息总线、传输（AMQP、Redis、Doctrine）、中间件、信封 → [参考]() ### 控制台 * **控制台** — CLI 命令、输入/输出处理、帮助程序、格式化程序、进度条 → [参考]() ### 依赖注入 * **DependencyInjection** - 服务容器、自动装配、编译器传递、标记服务 → [参考]() * **合约** - 互操作性的解耦抽象（Cache、EventDispatcher、HttpClient 等）→ [参考]() ### 表格和验证 * **Form** — 表单创建、字段类型、事件、数据转换器、集合、主题 → [参考]() * **验证器** — JSR-303 约束、自定义验证器、组、严重性级别 → [参考]() * **OptionsResolver** - 具有默认值、验证、规范化、嵌套的选项配置 → [参考]() ### 缓存、锁和信号量 * **缓存** — PSR-6/PSR-16 适配器、基于标签的失效、踩踏预防 → [参考]() * **Lock** - 跨进程/服务器（Redis、PostgreSQL、文件）的独占资源锁定 → [参考]() * **Semaphore** — 具有可配置限制的并发访问（Redis、DynamoDB）→ [参考]() ### 活动和工作流程 * **EventDispatcher** — 观察者/中介者模式、侦听器、订阅者、优先级 → [参考]() * **工作流** — 状态机、工作流转换、防护、元数据、事件 → [参考]() ### 配置和表达式 * **Config** — 配置加载、验证、缓存、树构建、捆绑配置 → [参考]() * **ExpressionLanguage** - 用于业务规则、验证、安全性的安全表达式沙箱 → [参考]() * **Yaml** — YAML 解析、转储、具有完整数据类型支持的 linting → [参考]() ### 文件系统、查找器和进程 * **文件系统** — 与平台无关的文件/目录操作、原子写入、路径实用程序 → [参考]() * **Finder** — 使用流畅标准（名称、大小、日期、深度、内容）进行文件搜索 → [参考]() * **进程** — 安全系统命令执行、异步进程、输出流 → [参考]() ### 序列化和类型 * **PropertyAccess** - 通过字符串路径读/写对象和数组 (`foo.bar[baz]`) → [reference]() * **PropertyInfo** — 属性元数据提取（类型、访问、描述）→ [参考]() * **TypeInfo** — PHP 类型提取、解析和验证 → [参考]() * **VarDumper** — 使用 HTML/CLI 格式化程序增强变量调试 → [参考]() * **VarExporter** — 将 PHP 数据导出到 OPcache 优化的代码、惰性幽灵/代理对象 → [参考]() ### 测试 * **BrowserKit** - 用于编程 HTTP、cookie、历史记录的模拟浏览器 → [参考]() * **DomCrawler** — HTML/XML 遍历、CSS 选择器、表单自动化 → [参考]() * **CssSelector** — 用于 DOM 查询的 CSS 到 XPath 转换 → [参考]() * **PHPUnit Bridge** — 弃用报告、时间/DNS 模拟、并行测试 → [参考]() ### 数据和文本实用程序 * **Uid** — UUID (v1–v8) 和 ULID 生成、转换、Doctrine 集成 → [参考]() * **Clock** — 使用 MockClock 和 DatePoint 进行可测试的时间抽象 → [参考]() * **Intl** — 国际化数据（语言、国家、货币、时区）→ [参考]() * **JsonPath** — JSON 结构上的 RFC 9535 JSONPath 查询 → [参考]() * **Mime** — 为电子邮件和内容类型创建 MIME 消息 → [参考]() * **Ldap** — LDAP/Active Directory 连接、查询和管理 → [参考]() * **资产** - Web 资产的 URL 生成和版本控制 → [参考]() ## 快速模式 ### 依赖注入（自动装配） # services.yaml — 大多数服务都是自动连接的服务： _默认值：自动装配：真自动配置：真应用\: 资源：'../src/' 排除：'../src/{DI,Entity,Kernel.php}' ### 定义一个路由+控制器使用 Symfony\Component\HttpFoundation\Response；使用 Symfony\Component\Routing\Attribute\Route；文章控制器类 { #[路线('/articles/{id}', 方法: ['GET'])] 公共函数 show(int $id): 响应 { return new Response("文章 $id"); } } ### 发送消息（异步）使用 Symfony\Component\Messenger\MessageBusInterface；订单服务类 { 公共函数 __construct(私有 MessageBusInterface $bus) {} 公共函数地点（订单$订单）：无效 { $this->bus->dispatch(new OrderPlaced($order->getId())); } } ### 创建并验证表单 $form = $this->createForm(ArticleType::class, $article); $form->handleRequest($request); if ($form->isSubscribed() && $form->isValid()) { $em->persist($form->getData()); $em->flush(); 返回 $this->redirectToRoute('article_list'); } ### 带标签的缓存使用 Symfony\Contracts\Cache\ItemInterface； $value = $cache->get('products_list', function (ItemInterface $item) { $item->expiresAfter(3600); $item->tag(['产品']); 返回 $this->repository->findAll(); }); $cache->invalidateTags(['产品']); ### 控制台命令使用 Symfony\Component\Console\Attribute\AsCommand；使用 Symfony\Component\Console\Command\Command；使用 Symfony\Component\Console\Input\InputInterface；使用 Symfony\Component\Console\Output\OutputInterface; #[AsCommand(name: 'app:process', description: '处理项目')] ProcessCommand 类扩展 Command { 受保护的函数执行（InputInterface $输入，OutputInterface $输出）：int { $output->writeln('处理中...'); 返回命令::成功； } } ### 事件订阅者使用 Symfony\Component\EventDispatcher\EventSubscriberInterface; OrderSubscriber 类实现 EventSubscriberInterface { 公共静态函数 getSubscribedEvents(): 数组 { 返回 [OrderPlacedEvent::class => 'onOrderPlaced']; } 公共函数 onOrderPlaced(OrderPlacedEvent $event): void { // 处理事件 } } ### 工作流程转换 if ($workflow->can($article, '发布')) { $workflow->apply($article, '发布'); } ### 锁定资源 $lock = $factory->createLock('pdf- Generation', ttl: 30); if ($lock->acquire()) { 尝试{ 生成Pdf(); }最后{ $锁->释放(); } } ## 最佳实践 * 目标 **PHP 8.3+** 和 **Symfony 7.x**，具有严格的类型 * 通过 YAML/XML 使用 **属性** 来表示路由、命令、消息处理程序、事件侦听器 * 更喜欢**自动装配**——仅在需要配置时手动注册服务 * 在原始 PSR-6 上使用 **缓存合约** (`$cache->get()`) 来预防踩踏 * 应用**验证组**来支持多个表单上下文 * 默认使用**状态机**；仅当需要并行状态时才使用工作流程 * 为无法用内置约束表达的业务逻辑创建**自定义约束** * 使用 PHPUnit Bridge 在测试中模拟 **时间和 DNS** 以获得确定性结果

交响乐团

包含技能