fab2s / opinhelpers
一组简单、有见地且希望有用的PHP帮助库集合
1.0.1
2024-04-23 22:53 UTC
Requires
- php: ^7.1|^8.0
- fab2s/filelock: ^1.0
- fab2s/math: ^1.0|^2.0
- fab2s/strings: ^1.0
Requires (Dev)
- phpunit/phpunit: ~7.0|~8.0
README
OpinHelpers
是一套类似“瑞士军刀”级别的有见地的帮助库集合(因此得名 opin[h]el^^),涵盖了PHP编程中最令人烦恼的一些方面,如UTF8字符串操作、任意精度数学或正确锁定文件。
OpinHelpers
库在多个方面都有见地,并不旨在成为通用的,但它们在许多现实生活中的情况下应该非常有用。
安装
OpinHelpers
可以使用composer进行安装
composer require "fab2s/opinhelpers"
如果您想特别安装php >=7.2.0版本,请使用
composer require "fab2s/opinhelpers" ^1
如果您想特别安装php 5.6/7.1版本,请使用
composer require "fab2s/opinhelpers" ^0
主要的变化是0.x到1.x的进一步类型化(见兼容性)
文档
OpinHelpers
只需要要求各个库,每个库都有自己的仓库和文档
- Math:高精度基10流畅帮助库,采用相当严格的方法
- Utf8:纯静态UTF8帮助库
- Strings:纯静态字符串帮助库,用于处理更高级的UTF8字符串操作
- Bom:纯静态零依赖BOM帮助库,用于处理Unicode BOM
- FileLock:流畅文件锁定 帮助库
兼容性
OpinHelpers
附带一个 deprecated.php
文件,您可以在项目中 require
它,如果您需要继续使用 v1 之前的旧 namespace
。
require 'vendor/fab2s/opinHelpers/src/deprecated.php'; // no you can use fab2s\OpinHelpers\Math; // same as use fab2s\Math\Math; // old version will be marked as deprecated $number = fab2s\OpinHelpers\Math::numder('42'); // new one is ok with full type hints $number = fab2s\Math\Math::numder('42');
方法名称或签名没有做出显著更改,但有一些小的返回类型更改(在
Utf8
中,false 与 null)、一个边缘值(Utf8::chr(0) = "\0"
)和一个与UTF-32-LE
BOM 检测有关的错误。在大多数情况下应该没问题,但仍然建议重构到新的namespace
并审查使用情况。
要求
OpinHelpers
已在php 7.2、7.3、7.4和8.0上进行了测试
贡献
欢迎贡献,不要犹豫,打开问题并提交拉取请求。
许可证
OpinHelpers
的每个组件都是开源软件,许可协议为 MIT许可证