README

通用类包。

通用类包旨在提供一些最初为CIDRAM、phpMussel等通用用途编写的类，作为一个独立的、可重新分发的包，可以通过Composer与其他项目和包轻松集成和使用。

通用类包中的所有类都使用命名空间 Maikuolan\Common。

通用类包目前包含以下类

• Cache: 一个简单的、统一的缓存处理器，由CIDRAM和phpMussel项目用于其缓存需求。目前，它支持APCu、Memcached、Redis、PDO和平文件缓存。
• CommonAbstract: 通用类包的通用抽象。不可直接实例化；应由其他类扩展。
• ComplexStringHandler: 复杂字符串处理器类提供了一个简单的方法来遍历给定字符串的各个部分，通过给定模式标识，执行给定闭包对这些字符串的各个部分，或对分隔这些部分的粘合剂。
• DelayedIO: 在需要读取和更新多个文件但延迟一段时间重新写入文件时提供了一种简单、简单的方法。
• Demojibakefier: 旨在将给定字符串的字符编码标准化为首选字符编码，当给定字符串的字节序列与首选字符编码的预期不匹配时。在可能由多个不同的未知编码组成的数据块的情况下很有用。
• Events: 通过提供一些简单的方法将处理器分配给特定事件，然后在代码库中稍后的某个位置调用这些处理器来在代码库中组织“事件”。
• IPHeader: 尝试从首选源解析原始IP地址，或如果首选源不可用，则使用 REMOTE_ADDR。
• L10N: 由CIDRAM和phpMussel项目用于处理L10N数据，L10N处理器读取一个L10N字符串数组，并提供一些安全、简单的方法在需要时操作和返回这些字符串，并处理基数复数，对于整数和分数都一样，基于从各种复数规则中选择指定的复数规则，以满足大多数已知语言的需求。
• 矩阵：简化了多维数组的生成，支持任意深度和元素数量的指定，并通过任意可调用对象和闭包，支持在任何方向上迭代这些多维数组（无论是向上或向下迭代特定数组，还是跨不同深度等）。
• 数字格式化器：由CIDRAM和phpMussel项目使用，用于格式化前端页面生成的数字，该类提供了比PHP内部number_format()函数更可控制、可自定义的数字格式化机制。
• 操作：由CIDRAM和phpMussel项目用于依赖管理相关的各种操作（内部更新系统的重要组成部分）。
• 请求：由CIDRAM和phpMussel项目用于通过cURL发送出站请求。
• YAML：由CIDRAM和phpMussel项目用于处理YAML数据。

安装方法

建议使用Composer进行安装

composer require maikuolan/common

然而，如果您愿意，也可以从该存储库手动下载所需的类。

下载完软件包或所需的类后，建议使用PSR-4自动加载的方式来访问这些类（尤其是如果您使用的是大量不同且无关的类）。如果您通过Composer安装该软件包，只需执行require_once 'vendor/autoload.php';即可，所有问题都会自动解决。或者，如果您手动安装软件包或其类（或没有使用Composer），或者您不想使用PSR-4自动加载器，您可以通过在代码中使用include或require语句，将所需的类包含或包含到您的项目中，以指向任何需要它们的PHP代码中的所需类。

其他信息

许可

使用GNU通用公共许可证版本2.0（GPLv2）提供。

支持

请使用本存储库的问题页面。

对于贡献者

[CONTRIBUTING.md] 想帮忙吗？

最后更新时间：2024年5月31日（2024.05.31）。