在使用 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\MathUtility methods: 确保像 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

该扩展还提供了一些 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 就能检测出这种错误，从而避免运行时错误。

安装和配置

使用 Composer 安装 saschaegerer/phpstan-typo3 扩展非常简单：

composer require --dev saschaegerer/phpstan-typo3

如果安装了 phpstan/extension-installer，则会自动完成配置。否则，需要在 phpstan.neon 文件中手动添加以下配置：

includes:
    - vendor/saschaegerer/phpstan-typo3/extension.neon

自定义配置

该扩展还支持自定义配置，可以根据项目的实际情况进行调整。例如，可以自定义 Context API Aspect 的映射、Request Attribute 的映射以及 Site Attribute 的映射。

总结

saschaegerer/phpstan-typo3 扩展极大地增强了 PHPStan 在 TYPO3 CMS 项目中的静态分析能力。通过提供 TYPO3 CMS 相关的类型信息和规则，它可以帮助开发者在编码阶段发现潜在的错误，从而提高代码质量和减少运行时错误。对于 TYPO3 CMS 开发者来说，这是一个非常有用的工具。