salient/utils

Salient 工具包的 utils 库

v0.99.53 2024-09-20 02:11 UTC

README

Salient 工具包 的 utils 组件

Latest Stable Version License CI Status Code Coverage

salient/utils 通过无状态的类提供一系列有用的实用方法。

  • Arr 与数组和相关可迭代对象一起工作。

  • Date 与日期和时间值、时区和间隔一起工作。

  • Debug 通过规范化回溯数据来获取调用者信息。

  • Env 获取环境变量,从 .env 文件中加载值,并将环境值应用到脚本中。

  • File 提供抛出异常的文件系统操作方法。

  • Format 使数据易于阅读。

  • Get 提取、转换和生成数据。例如

    • Get::coalesce() 模拟 SQL 的 COALESCE() 函数
    • Get::code() 改进了 var_export()
    • Get::copy() 获取对象的深拷贝
    • Get::eol() 获取字符串的换行符序列
    • Get::uuid() 生成或转换 UUID
  • Inflect 将英文单词转换为不同形式,例如从单数到复数。

  • Json 提供编码和解码 JSON 数据的方法,在失败时抛出异常。

  • Package 从 Composer 的运行时 API 中检索信息,例如根包的名称。

  • Reflect 与 PHP 的反射 API 一起工作。

  • Regex 提供抛出异常的与正则表达式一起工作的方法。

  • Str 操作字符串。例如

    • Str::expandLeadingTabs() 将前导制表符展开为空格
    • Str::matchCase() 匹配两个字符串的大小写
    • Str::ngrams() 获取字符串的 n-gram
    • Str::snake() 将字符串转换为 snake_case
    • Str::splitDelimited() 安全地分割包含分隔符的字符串
  • Sys 获取关于运行时环境的信息,并提供对退出信号(SIGTERMSIGINTSIGHUP)的处理程序。

  • Test 对值执行测试。

文档

salient/utils 的 API 文档跟踪工具包的 GitHub 仓库main 分支,在那里还可以找到更多文档。