fab2s/bom

纯静态零依赖的 BOM 辅助工具,用于处理 Unicode BOM

1.0.1 2021-06-16 09:43 UTC

This package is auto-updated.

Last update: 2024-09-16 17:04:22 UTC


README

Build Status Total Downloads Monthly Downloads Latest Stable Version Scrutinizer Code Quality PRs Welcome License

一个纯静态零依赖的 字节顺序标记 辅助工具,用于处理 Unicode BOM

安装

可以使用 composer 安装 Bom

composer require "fab2s/bom"

Bom 也包含在 OpinHelper 中,这是一个包含多个“瑞士军刀级”辅助工具的包,覆盖了 PHP 编程中一些最令人烦恼的问题,如 UTF8 字符串操作、高精度数学或正确锁定文件

如果您需要使用低于 7.1 的 PHP,您仍然可以使用 OpinHelper 0.x

先决条件

Bom 没有特定的依赖

实践中

Bom 支持 UTF-8|16|32 BOM,包括 小端大端 端序

Bom 结构简洁,仅公开五个方法

// get Bom
$bomAtStartOfString = Bom::extract($string); // returns null when none are found

// remove eventual BOM from beging of string
$bomLessString = Bom::drop($string);

// get encoding from a supported BOM
$encoding = Bom::getBomEncoding($bom); // returns null if the BOM is not valid

// get BOM for a supported encoding
$bom = Bom::getEncodingBom($encoding); // returns null if the encoding is not supported (has no BOM)

// get the list of BOMs as an array with corresponding encodings as indexes
$boms = Bom::getBoms(); // returns an associatiove array of encodings and correesponding BOMs

foreach ($boms as $encoding => $bom) {
    // do something ...
}

要求

Bom 已在 php 7.1、7.2、7.3、7.4 和 8.0 上进行测试

贡献

欢迎贡献,不要犹豫,可以提出问题和提交拉取请求。

许可证

Bom 是开源软件,许可协议为 MIT 许可证