README

mengruchu/t-utils 是一个专为项目设计的高效工具包，集成了开发中常用的实用函数和工具类，包括字符串处理、数组操作、时间处理、文件处理等功能。该工具包旨在显著提升开发效率并简化代码实现。

🌟 主要功能

Mengruchu T-Utils 提供了丰富的功能模块，帮助开发者快速构建高质量的应用程序：

• 字符串处理：

  • 隐藏敏感信息（如手机号、身份证号等）
  • 金额格式化为中文大写
  • UUID 生成
  • 字符串格式化与处理
  • 字符串替换和截取操作

• 数组操作：

  • 二维数组与一维数组转换
  • 按字段值查找和排序数组
  • 提取数组中的特定字段值
  • 构建树形数据结构

• 时间处理：

  • 时间戳友好的相对时间显示（如"几分钟前"）
  • 快速获取常用时间点（今天、昨天、上周、上月等）
  • 剩余时间格式化为"天时分"显示
  • 灵活的时间格式化功能

• 网络工具：

  • 客户端 IP 地址获取
  • CURL 请求发送功能

• 文件处理：

  • 文件扩展名提取
  • 文件路径相关操作

• 其他工具：

  • JSON 数据处理
  • XML 数据处理
  • 数据验证功能

📦 安装方式

使用 Composer 进行安装是最简单的方式：

composer require mengruchu/t-utils

💡 使用示例

use Mengruchu\TUtils\StringUtils;

// 隐藏手机号中间四位
$phone = '13812345678';
$hiddenPhone = StringUtils::hidePart($phone, 3, 4);
echo $hiddenPhone; // 输出: 138****5678

// 根据最后一个符号截取字符串
$path = '/home/user/documents/file.txt';
$fileName = StringUtils::strLastSymbolSubstr($path, '/');
echo $fileName; // 输出: file.txt

use Mengruchu\TUtils\ArrayUtils;

// 根据字段值在二维数组中查找一维数组
$users = [
    ['id' => 1, 'name' => '张三', 'age' => 25],
    ['id' => 2, 'name' => '李四', 'age' => 30],
];

$user = ArrayUtils::fieldTwoToOne($users, 'id', 2);
print_r($user); 
// 输出: Array ( [id] => 2 [name] => 李四 [age] => 30 )

// 构建树形结构
$categories = [
    ['id' => 1, 'name' => '分类1', 'superior_id' => 0],
    ['id' => 2, 'name' => '分类2', 'superior_id' => 1],
    ['id' => 3, 'name' => '分类3', 'superior_id' => 1],
];

$tree = ArrayUtils::buildTree($categories);
print_r($tree);
/* 输出:
Array
(
    [0] => Array
        (
            [id] => 1
            [name] => 分类1
            [superior_id] => 0
            [children] => Array
                (
                    [0] => Array
                        (
                            [id] => 2
                            [name] => 分类2
                            [superior_id] => 1
                            [children] => Array()
                        )
                    [1] => Array
                        (
                            [id] => 3
                            [name] => 分类3
                            [superior_id] => 1
                            [children] => Array()
                        )
                )
        )
)
*/

📄 许可证

本项目采用 MIT 许可证。