# TYPO3 代码简化器 > 改编自 Boris Cherny（Anthropic）针对 TYPO3 上下文的代码简化代理。 **目标：** TYPO3 v14（主要）、v13、v12.4 LTS（已注明回退）。简化和完善最近更改的 TYPO3 代码。保留所有功能。注重清晰而非巧妙，注重 TYPO3 API 使用而非自定义实现，注重 v14 模式而非弃用方法。 ## 流程 1. 识别最近修改的文件（使用 `git diff --name-only HEAD~1` 或分阶段更改） 2. 运行三个并行审核：**重用**、**质量**、**效率** 3. 汇总发现结果、删除重复数据、按影响排序 4.应用修复，验证行为没有改变 ## 第 1 关：TYPO3 API 重用查找与 TYPO3 已提供的内容重复的自定义实现。 ### 用核心 API 替换自定义代码定制图案| TYPO3 API 替换 ---|--- 手动数据库查询 (`$connection->executeQuery(...)`) |带有命名参数的“QueryBuilder” `$GLOBALS['TYPO3_REQUEST']` |通过中间件/控制器注入`ServerRequestInterface` `new FlashMessage(...)` \+ 手动队列 |通过 DI 的“FlashMessageService” 手动 JSON 响应构建 | PSR-7 中的“JsonResponse” `GeneralUtility::makeInstance()` |通过“Services.yaml”构造函数注入 `$GLOBALS['TSFE']->id` | `$request->getAttribute('路由')->getPageId()` `$GLOBALS['BE_USER']` |注入 `Context` 或 `BackendUserAuthentication` `ObjectManager::get()` |构造函数DI 手动文件路径解析 | `PathUtility`、`Environment::getPublicPath()` 使用全局变量进行自定义缓存 |通过 DI 进行缓存配置的“CacheManager” 用于单个字段的`BackendUtility::getRecord()` `QueryBuilder` 仅选择需要的列手动页面树遍历 | `RootlineUtility` 或 `PageRepository` `GeneralUtility::_GP()` / `_POST()` / `_GET()` | `$request->getQueryParams()` / `getParsedBody()` `$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']` 写入 | PSR-14 事件或“扩展配置” 手动链接生成 | `UriBuilder`（后端）或 `ContentObjectRenderer::typoLink()` ### 替换已弃用的模式 (v14) 已弃用 | v14 更换 ---|--- `ext_localconf.php` 钩子数组 | PSR-14 事件上的“#[AsEventListener]” `$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']` 钩子 | PSR-14 事件 `ext_tables.php` 模块注册 | `配置/后端/Modules.php` `XCLASS` | PSR-14 事件或 DI 装饰 `switchableControllerActions` |每个操作都有单独的插件存储库中的 `$querySettings->setRespectStoragePage(false)`在控制器中设置，而不是在存储库中设置信号/槽 | PSR-14 事件 `AbstractPlugin` (pi_base) | Extbase 控制器或中间件 TCA `eval` 为 `required`、`trim`、`null` |专用 TCA 密钥：“必需”、“可为空” `renderType => 'inputDateTime'` | `'类型' => '日期时间'` `'type' => 'input', 'eval' => 'int'` | `'类型'=>'数字'` 带有数字数组键的“items” |带有“label”/“value”键的“items” ## 第 2 关：代码质量 ### PHP 类 * 每个文件一个类，PSR-4 自动加载 * 在每个 PHP 文件上声明(strict_types=1)` * 不是为继承而设计的类上的“final” * 不可变属性上的“readonly” * DI 依赖的构造函数提升 * 所有方法的显式返回类型 * 没有未使用的“use”导入 * 没有抑制错误 (`@`) * 深度嵌套的保护子句（提前返回） * 存在特定类型时不存在混合类型 * 将 `array` 类型提示替换为类型化数组或 DTO // 之前我的服务类 { 私有连接池 $connectionPool; 私有上下文 $context; 公共函数 __construct(ConnectionPool $connectionPool, Context $context) { $this->连接池 = $连接池; $this->上下文=$上下文； } 公共函数 getData($id) { // ... } } // 之后最后一课 MyService { 公共函数 __construct( 私有只读连接池 $connectionPool, 私有只读上下文 $context, ）{} 公共函数 getData(int $id): 数组 { // ... } } ### 流体模板 * 没有内联 PHP 或复杂的 ViewHelper 链 * 使用 `` 代替硬编码字符串 * 使用 `` / `` 代替手动 `` * 使用``代替手动``标签 * 重复标记的部分内容 (DRY) * 布局槽的部分，不可重复使用（使用 Partials） * 除非绝对必要，否则不要使用“{variable -> f:format.raw()}”（XSS 风险） * 变量使用驼峰命名法 * 删除空的``块 * 将嵌套的 `` 简化为 `` 或三元（更清晰） ### 三氯乙酸 * 使用 v14 `items` 格式和 `label`/`value` 键 * 删除已限制的字段上多余的“排除”=> true * 使用专用类型: `'type' => 'email'`, `'type' => 'datetime'`, `'type' => 'number'`, `'type' => 'link'`, `'type' => 'color'`, `'type' => 'json'` * 使用 `'required' => true` 而不是 `'eval' => 'required'` * 使用 `'nullable' => true` 代替 `'eval' => 'null'` * 删除字符串字段上的 `'default' => ''` （已经是默认值） * 合并调色板定义（删除单字段调色板） * 删除从 `ctrl` (v13.3+) 自动创建的样板 `columns` 定义：`hidden`、`starttime`、`endtime`、`fe_group`、`sys_language_uid`、`l10n_parent`、`l10n_diffsource` * 对启用列使用调色板：“可见性”用于“隐藏”，“访问”用于“开始时间、结束时间” * 从“ext_tables.sql”中删除约定字段（自动添加到数据库） * 从类型中删除未使用的“showitem”字段 ### 服务.yaml * 使用自动装配（当类型提示时删除显式参数定义） * 使用 `_defaults: autowire: true, autoconfigure: true, public: false` * 删除自动装配处理的类的手动服务定义 * 尽可能用“#[Autoconfigure]”替换“factory”定义 * 删除 `public: true` 除非 `GeneralUtility::makeInstance()` 需要 ### ext_localconf.php / ext_tables.php * 尽量减少代码 — 尽可能移至 `Configuration/` 文件 * 仅插件注册（无业务逻辑） * 使用 `ExtensionUtility::configurePlugin()` （不是前端的 `registerPlugin`） * 没有 `addPageTSConfig` — 使用 `Configuration/page.tsconfig` * 没有 `addUserTSConfig` — 使用 `Configuration/user.tsconfig` * 没有 `addTypoScript` — 使用 `Configuration/TypoScript/setup.typoscript` ## 第三关：效率 * QueryBuilder：仅选择需要的列，而不是`*` * QueryBuilder：当需要单行时添加`setMaxResults()` * 使用 `count()` 查询而不是获取所有行进行计数 * 使用 TYPO3 缓存框架缓存昂贵的操作 * 避免在 Extbase 存储库中进行 N+1 查询（使用 `JOIN` 或批量加载） * 使用`TYPO3\CMS\Core\Resource\ProcessedFileRepository`而不是对每个请求进行重新处理 * 删除没有分页的`findAll()`调用 * 使用 `@TYPO3\CMS\Extbase\Annotation\ORM\Lazy` 进行延迟加载文件引用 * 将 `foreach` \+ 手动 `in_array()` 过滤替换为 QueryBuilder `WHERE IN` * 删除 CLI 命令中多余的 `cache:flush` 调用 ## 输出格式分析后，按文件分组报告结果： ## 类/控制器/MyController.php :42 — 替换 GeneralUtility::makeInstance(MyService::class) → 构造函数注入 :18 — 添加返回类型 `: ResponseInterface` :55 — 已弃用: $GLOBALS['TSFE']->id → $request 路由属性 :67 — 保护子句：反转条件、提前返回、减少嵌套 ## 资源/私人/模板/List.html :12 — 硬编码字符串“未找到项目”→ f:translate :34 — 手册 → f:link.page ## 配置/TCA/Overrides/tt_content.php :8 — v12 项目格式 ['Label', 'value'] → ['label' => 'Label', 'value' => 'value'] 应用了 7 个修复。没有行为改变。运行测试来验证。 ## 版本回退简化 v12/v13 兼容性时： * 将“Configuration/RequestMiddlewares.php”保留在“#[AsMiddleware]”旁边 * 将 `Services.yaml` 事件监听器配置与 `#[AsEventListener]` 一起保留 * 将数字 TCA `items` 数组与 `label`/`value` 格式一起保留 * 仅在 v14+ 上使用 `#[Autoconfigure]`（在 v12 中不可用） ** ** ## 制作人员及归属改编自 Boris Cherny（Anthropic）的 [code-simplifier]() 代理和 Claude Code 针对 TYPO3 上下文的捆绑 `/simplify` 技能。 **版权所有 (c) Anthropic** — 代码简化模式（MIT 许可证）感谢 Netresearch DTT GmbH 对 TYPO3 社区的贡献。

Typo3 简化

包含技能