# t-utils

**Repository Path**: mengruchu/t-utils

## Basic Information

- **Project Name**: t-utils
- **Description**: php7.0上一些常用的工具合集
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-15
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mengruchu T-Utils

<p align="center">
  <img src="https://img.shields.io/badge/PHP->=7.4-blue.svg" alt="PHP Version">
  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License MIT">
</p>

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

## 🌟 主要功能

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

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

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

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

- **网络工具**：
    - 客户端 IP 地址获取
    - CURL 请求发送功能

- **文件处理**：
    - 文件扩展名提取
    - 文件路径相关操作

- **其他工具**：
    - JSON 数据处理
    - XML 数据处理
    - 数据验证功能

## 📦 安装方式

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

```bash
composer require mengruchu/t-utils
```

## 💡 使用示例

```php
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
```

```php
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](LICENSE) 许可证。