Download the PHP package larva/support without Composer
On this page you can find all versions of the php package larva/support. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download larva/support
More information about larva/support
Files in larva/support
Download larva/support
More information about larva/support
Files in larva/support
Please rate this library. Is it a good library?
Informations about the package support
Larva 公共支持
一个面向 PHP 项目的轻量级公共支持库,封装日常开发中常用的工具类、助手函数和基础组件,零业务依赖、开箱即用。
特性
- 🚀 零业务依赖:仅依赖
guzzlehttp/guzzle、nesbot/carbon、ezyang/htmlpurifier等通用库 - 🧰 丰富工具集:覆盖 HTTP、字符串、数组、文件、时间、加密、网络、树、JSON、HTML 等常用场景
- 🇨🇳 本土化增强:内置身份证、统一社会信用代码、MAC 地址、IP、ISO 3166、地理位置等中国场景工具
- 🧱 统一基类:提供
BaseObject、Trait(HasAttributes/HasHttpRequest/Macroable)等基础设施 - ✅ 完整测试:基于 PHPUnit 11 编写单元测试
- 🎨 代码风格:使用
friendsofphp/php-cs-fixer统一编码风格
目录
- 环境需求
- 安装
- 快速开始
- 组件一览
- 使用示例
- 开发与测试
- 许可证
环境需求
- PHP
^8.2(支持 8.2 / 8.3 / 8.4+) - 扩展:
ext-curl、ext-dom、ext-json、ext-openssl、ext-mbstring、ext-simplexml、ext-libxml、ext-fileinfo
安装
快速开始
组件一览
| 类 / Trait | 说明 |
|---|---|
BaseObject |
基础对象类,支持数组式属性访问与配置初始化 |
ArrayHelper |
数组 / 对象取值、合并、映射等操作 |
ArrayAccessible |
让对象可被 foreach 遍历 |
Collection |
集合类,提供 map / filter / reduce 等链式操作 |
Config |
轻量级配置容器 |
FileHelper |
文件 / 目录读写、复制、遍历等常用操作 |
HtmlHelper |
HTML 安全过滤、编码(基于 HTMLPurifier) |
HttpClient |
基于 Guzzle 的 HTTP 客户端,支持 JSON、表单、文件上传 |
HttpResponse |
统一的 HTTP 响应封装 |
IDCard |
中国大陆身份证号校验、解析出生日期 / 性别 / 地区 |
IPHelper |
IP 解析、内网段判断、IP ↔ 长整型互转 |
ISO3166 |
国家 / 地区代码数据 |
Json |
JSON 编码 / 解码工具 |
LBSHelper |
地理位置(LBS)相关工具 |
MacAddres |
MAC 地址校验与格式化 |
Number |
数字、金额格式化(人民币、千分位等) |
SSLCertificate |
SSL 证书解析 |
Socket |
Socket 通信 |
SqlHelper |
SQL 拼接助手 |
StringHelper |
字符串处理:UUID、随机数、命名风格转换、截断等 |
TimeHelper |
时间格式化、人性化时间显示(基于 Carbon) |
Tree |
树形结构构建与遍历 |
UnifiedSocialCreditIdentifier |
统一社会信用代码校验 |
Url |
URL 解析、拼接与签名 |
Traits\HasAttributes |
对象属性读写(类似 Yii AR) |
Traits\HasHttpRequest |
HTTP 请求相关通用方法 |
Traits\Macroable |
宏能力(动态扩展类方法) |
完整的接口说明请参考
src/目录下各类的 PHPDoc 注释。
使用示例
HTTP 客户端
字符串助手
数字与金额
时间助手
数组 / 集合
树形结构
身份证
统一社会信用代码
开发与测试
克隆仓库后,安装依赖:
运行单元测试:
检查并自动修复代码风格:
本项目使用
friendsofphp/php-cs-fixer统一编码风格,提交前请确保通过检查。
异常体系
src/Exception/ 目录提供了一系列业务无关的基础异常类,便于业务层统一处理:
Exception:根异常RuntimeException/InvalidCallException/InvalidConfigException/InvalidUrlExceptionHttpClientException/ConnectionException/RequestExceptionFileException/FileNotFoundExceptionNotSupportedException/UnknownMethodException/UnknownPropertyException
路线图
- [ ] 持续完善单元测试覆盖率
- [ ] 增加更多中国本土化工具(如车牌号校验等)
- [ ] 提供更丰富的 TypeScript / IDE 提示
贡献
欢迎提交 Issue 与 Pull Request。提交前请:
- 通过
composer test全部测试 - 通过
composer check-style风格检查 - 在 PR 中描述清楚变更背景与影响范围
安全
如发现安全漏洞,请联系:[email protected],请勿在公开 Issue 中披露。
许可证
本项目基于 MIT 协议发布。
All versions of support with dependencies
PHP Build Version
Package Version
Requires
php Version
^8.2
ext-curl Version *
ext-dom Version *
ext-json Version *
ext-openssl Version *
ext-mbstring Version *
ext-simplexml Version *
ext-libxml Version *
ext-fileinfo Version *
nesbot/carbon Version ^3.8
guzzlehttp/guzzle Version ^8.0
ezyang/htmlpurifier Version ^4.14
ext-curl Version *
ext-dom Version *
ext-json Version *
ext-openssl Version *
ext-mbstring Version *
ext-simplexml Version *
ext-libxml Version *
ext-fileinfo Version *
nesbot/carbon Version ^3.8
guzzlehttp/guzzle Version ^8.0
ezyang/htmlpurifier Version ^4.14
The package larva/support contains the following files
Loading the files please wait ...

