fab2s/opinhelpers

一组简单、有见地且希望有用的PHP帮助库集合

1.0.1 2024-04-23 22:53 UTC

This package is auto-updated.

Last update: 2024-09-23 23:45:39 UTC


README

Build Status Total Downloads Monthly Downloads Latest Stable Version PRs Welcome License

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许可证