推荐使用：增强类型（Augmented Types）

推荐使用：增强类型（Augmented Types）

augmented_typesA PHP extension to enforce parameter and return type annotations项目地址:https://gitcode.com/gh_mirrors/au/augmented_types

增强类型 是一个PHP扩展，它在运行时强制执行PHPDoc样式的类型注解，与opcode缓存器兼容，并允许选择性地执行函数类型注解，从而实现类型安全性的逐步提升，而对性能的影响极小。

项目简介

Augmented Types 旨在使您的PHP代码更加严格和类型安全。通过检查并强制执行函数参数和返回值的类型，这个扩展可以帮助您预防因类型不匹配而导致的错误。开发者可以在不影响整个代码库的情况下，逐渐引入类型检查，这样可以在保持灵活性的同时提高代码质量。

技术分析

Augmented Types 的核心在于其对PHPDoc注释的支持。在每个需要类型检查的函数或方法上方添加注解，例如：

/**
* @param int $a
* @return float[]
*/
function foo ($a) {
    echo "You passed in the integer $a";
    return [$a * 1.0, $a * 2.718];
}

在运行时，如果实际传入的类型或返回的类型不符合注解中的定义，Augmented Types 将抛出致命错误。这种机制使得开发者能够精确控制类型检查的范围，通过白名单和黑名单功能可以选择性地应用类型强制。

此外，它的默认配置非常灵活，通过 augmented_types.enforce_by_default 参数，您可以决定是否全局开启类型检查，或者只针对特定文件和目录启用。

应用场景

适用于那些希望逐步引入静态类型检查，但又不想完全依赖于强类型语言如TypeScript的PHP项目。在大型代码库中，这为旧代码和新代码之间的平滑过渡提供了可能，也可以作为混合动态和静态类型检查策略的一部分。

项目特点

1. 兼容性广泛 - 兼容多数opcode缓存器，确保性能影响最小。
2. 渐进式类型检查 - 可以通过白名单和黑名单机制选择性地开启类型检查。
3. 灵活性 - 默认情况下仅针对已标记的函数进行类型检查，避免了大规模重构的风险。
4. 易于安装 - 在Unix系统上编译安装简单明了，虽然目前尚不支持Windows，但我们欢迎贡献者提供跨平台支持。

请访问项目GitHub页面，获取详细的安装指南、常见问题解答以及更多关于如何贡献的信息。让我们一起提升PHP代码的质量和稳定性，借助Augmented Types享受更安全的编程体验。

augmented_typesA PHP extension to enforce parameter and return type annotations项目地址:https://gitcode.com/gh_mirrors/au/augmented_types