在使用 TYPO3 CMS 进行项目开发时，我们经常会遇到一些难以察觉的错误，这些错误往往只有在运行时才会暴露出来。例如，Context->getAspect() 方法的返回值类型，PropertyMapper->convert() 方法的类型转换，以及 MathUtility::forceIntegerInRange() 方法的返回值范围等等，这些类型信息对于 PHPStan 来说是未知的，导致静态分析无法准确地进行。Composer在线学习地址：学习地址
saschaegerer/phpstan-typo3 扩展正是为了解决这些问题而诞生的。它通过提供 typo3 cms 相关的类型信息和规则，增强了 phpstan 的静态分析能力，从而帮助开发者在编码阶段发现潜在的类型错误、参数错误和逻辑错误。
Dynamic Return Type Extensions
该扩展提供了动态返回类型扩展，可以帮助 PHPStan 理解 TYPO3 CMS 中一些特殊方法的返回值类型。例如：
-
\TYPO3\CMS\Core\Context\Context->getAspect(): 确保返回正确的 Aspect 对象类型。 -
\TYPO3\CMS\Extbase\Property\PropertyMapper->convert(): 确保属性映射转换返回正确的类型。 -
\TYPO3\CMS\Core\Utility\MathUtilitymethods: 确保像isIntegerInRange这样的方法返回正确的类型。 -
\TYPO3\CMS\Extbase\Persistence\Generic\Query->execute()和\TYPO3\CMS\Extbase\Persistence\QueryInterface->execute(): 确保查询执行返回正确的对象类型。 -
\TYPO3\CMS\Core\Site\Entity\Site->getAttribute()和\Psr\Http\Message\ServerRequestInterface->getAttribute(): 确保返回正确的属性类型。
例如，PHPStan 原本无法得知 MathUtility::forceIntegerInRange(100, 1, 10) 的返回值范围是 1 到 10 之间的整数。安装此扩展后，PHPStan 就能理解该方法的返回值类型，从而可以检测出一些潜在的逻辑错误。
Framework Specific Rules
立即学习“PHP免费学习笔记（深入）”；
该扩展还提供了一些 TYPO3 CMS 特定的规则，可以帮助开发者避免一些常见的错误。例如：
-
\TYPO3\CMS\Core\Context\Context->getAspect(): 确保正确使用 Context API。 -
\Psr\Http\Message\ServerRequestInterface->getAttribute(): 确保正确使用 PSR-7 请求属性。 -
\TYPO3\CMS\Core\Site\Entity\Site->getAttribute(): 确保正确使用 Site API 属性。 -
\TYPO3\CMS\Extbase\Validation\ValidatorResolver->createValidator(): 确保创建验证器时传递了所有必需的选项。
例如，PHPStan 原本无法得知调用 ValidatorResolver->createValidator(RegularExpressionValidator::class) 时需要传递 regularExpression 选项。安装此扩展后，PHPStan 就能检测出这种错误，从而避免运行时错误。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
安装和配置
使用 Composer 安装 saschaegerer/phpstan-typo3 扩展非常简单：
<code class="bash">composer require --dev saschaegerer/phpstan-typo3</code>
如果安装了 phpstan/extension-installer，则会自动完成配置。否则，需要在 phpstan.neon 文件中手动添加以下配置：
<code class="neon">includes:
- vendor/saschaegerer/phpstan-typo3/extension.neon</code>自定义配置
该扩展还支持自定义配置，可以根据项目的实际情况进行调整。例如，可以自定义 Context API Aspect 的映射、Request Attribute 的映射以及 Site Attribute 的映射。
总结
saschaegerer/phpstan-typo3 扩展极大地增强了 PHPStan 在 TYPO3 CMS 项目中的静态分析能力。通过提供 TYPO3 CMS 相关的类型信息和规则，它可以帮助开发者在编码阶段发现潜在的错误，从而提高代码质量和减少运行时错误。对于 TYPO3 CMS 开发者来说，这是一个非常有用的工具。
