# php-utils

**Repository Path**: magein/php-utils

## Basic Information

- **Project Name**: php-utils
- **Description**: php开发使用的工具类

不依赖框架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/magein/php-utils
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-08-23
- **Last Updated**: 2025-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 简介

> php 一些常用的扩展

### 自动化测试

项目跟目录下执行

```php
./vendor/bin/phpunit
```

### 类说明

#### Console.php

```php
use magein\utils\Console;
Console::error('失败');
Console::success('成功');
Console::warning('警告');
Console::white('政策');
Console::red('红色');
Console::blue('蓝色');
Console::green('绿色');
Console::yellow('黄色');
```

#### DateFormatter.php

```php
use magein\utils\DateFormatter;
DateFormatter::now();
DateFormatter::unixtime('2025-06-18 14:55:31');
DateFormatter::date('2025-06-18 14:55:31');
DateFormatter::time('2025-06-18 14:55:31');
DateFormatter::datetime('1750230185');
DateFormatter::today();
DateFormatter::yesterday();
DateFormatter::dayRange();
DateFormatter::tomorrow();
// 上周
DateFormatter::lastWeek();
// 前几天的数据 不包含今天
DateFormatter::prevDay();
// 近几天的数据 包含今天
DateFormatter::lastDay();
```

#### BrowserAgent.php

```php
use magein\utils\BrowserAgent;
BrowserAgent::random();
BrowserAgent::android();
// 返回一个数组包含user-agent参数
BrowserAgent::header();
```

#### Validator.php

常用的验证类

```php
use magein\utils\Validator;

Validator::phone();
Validator::email();
Validator::qq();
Validator::idCard();
Validator::url();
Validator::http();
Validator::https();
Validator::ip();
Validator::ipv4();
Validator::ipv6();
Validator::image();
Validator::chinese();

```

#### Result.php

> 用于方法的返回值

#### Faker.php

> 用于生成数据

```php
use magein\utils\Faker;
Faker::email();
Faker::phone();
Faker::text();
Faker::phone();
Faker::name();
Faker::title();
```

#### Location.php

> 规范经纬度取值,仅仅是规范不同地图取值经纬度前后的问题，腾讯地址返回维度在前，高德返回经度在前

仅仅适用与中国范围内的经纬度

```php
use magein\utils\Location;

$number = '39.5420,116.2529';
$location = Location::init($number);
// 经度在前的字符串
$location->toString();
$location->toArray();
// 返回带键的数组通过 longitude和latitude
$location->toArray(false);
// 获取经度
$location->getLongitude();
// 获取维度
$location->getLatitude();
```

#### Http.php

> 使用需要安装GuzzleHttp

```shell
composer require guzzlehttp/guzzle:^7.6
```

```php

$http = new \magein\utils\Http;
// 要添加到请求的查询字符串的关联数组或查询字符串
$http->get($url,$params=[]);
// 用来发送一个 application/x-www-form-urlencoded POST请求
$http->formParams($url,$params);
// 设置请求的主体为 multipart/form-data 表单 
$http->multipartFormData($url,$params);
$http->json($url,$params,'post');
$http->body($url,$params,'put');
```

#### Tree.php

```php

$tree = new \magein\utils\Tree($data);
$data=$tree->transfer();

// 设置主键ID
$tree->setPrimary('id');
// 设置父级索引 默认parent_id
$tree->setParentId('pid');
// 设置子集索引 默认child
$tree->setChild('children');

// 数据结构转化成一维数组
$tree->floor($url,$params);
// 设置请求的主体为 multipart/form-data 表单
```