douglasgreen/utility

PHP 实用项目,用于异常类和包装函数

v0.5.1 2024-08-04 21:19 UTC

This package is auto-updated.

Last update: 2024-09-04 21:36:48 UTC


README

PHP 实用项目,用于异常类和包装函数

设置

使用 Composer 添加项目。

composer require douglasgreen/utility

好处

PHP 的核心设计历史悠久,可以追溯到 PHP 3 时代。例如

  • 使用函数而不是类。
  • 函数返回混合类型。
  • 返回 false、null 或空数组以抑制错误。
  • 函数名称和参数不一致。
  • 从函数返回数组或资源而不是对象。
  • 可变参数和返回值的混合。

更糟糕的是,该语言引入了静态类型和严格类型检查工具。

  • 返回 false|string 没有意义,应该返回 ?string。
  • 类型检查器强制你通过严格的比较来更努力地忽略错误。

这些实用类封装了 PHP 函数调用并试图解决这些问题。

函数签名

为了清晰起见,函数名称已重命名。保留了函数参数顺序,除了

  • 可变参数现在在 getter 函数中是返回值。
  • 如果返回信号值,则返回 null 而不是 false。
  • 具有多种形状和类型的数组被简化为单一形状和类型。