georgie/laravel-library

laravel个人常用函数集合 包含时间、文件、http、ip、字符串、无限级分类操作、商品规格的迪卡尔乘积运算等

dev-master 2023-06-24 01:22 UTC

This package is auto-updated.

Last update: 2024-10-24 04:18:26 UTC


README

composer require georgie/laravel-library

数组

数组助手类

//  \georgie\arr\ArrayHelper
//把对象或者数组对象,转成数组
ArrayHelper::toArray($object, $properties = [], $recursive = true);

//获取对象或者数组的指定的值
ArrayHelper::getValue($array, $key, $default = null);

//根据指定的key,建立key对应索引的数组,或者分组后的索引数组
ArrayHelper::index($array, $key, $groups = []);

//把数组转成 key-value 的形式
ArrayHelper::map($array, $from, $to, $group = null);

//检查数组是否是列索引
ArrayHelper::isAssoc($array);

//对象数组根据某个字段进行去重复
ArrayHelper::toRepeat($arr,'user_id');

数组增强

数组增强组件主要是对数组等数据进行处理,如无限级分类操作、商品规格的迪卡尔乘积运算等。

功能介绍

根据键名获取数据

如果键名不存在时返回默认值,支持键名的点语法

$d=['a'=>1,'b'=>2];
(new \georgie\arr\Arr())->get($d,'c','没有数据哟');

使用点语法查找:

$d = ['web' => [ 'id' => 1, 'url' => 'georgie.com' ]];
(new \georgie\arr\Arr())->get($d,'web.url');

排队字段获取数据

以下代码获取除 id、url以外的数据

$d = ['id' => 1,'url' => 'georgie.com','name'=>'Georgie'];
print_r((new \georgie\arr\Arr())->getExtName($d,['id','url']));

设置数组元素值支持点语法

$data = (new \georgie\arr\Arr())->set([],'a.b.c',99);

改变数组键名大小写

$data = array('name'=>'georgie',array('url'=>'georgie.com'));
$data = (new \georgie\arr\Arr())->keyCase($data,1); 
第2个参数为类型: 1 大写  0 小写

不区分大小写检测键名是否存

(new \georgie\arr\Arr())->keyExists('g',['g'=>'嘤嘤嘤']);

数组值大小写转换

(new \georgie\arr\Arr())->valueCase(['name'=>'georgie'],1); 
第2个参数为类型: 1 大写  0 小写

数组进行整数映射转换

$data = ['status'=>1];
$d = (new \georgie\arr\Arr())->intToString($data,['status'=>[0=>'关闭',1=>'开启']]); 

数组中的字符串数字转为数值类型

$data = ['status'=>'1','click'=>'200'];
$d = (new \georgie\arr\Arr())->stringToInt($data); 

根据下标过滤数据元素

$d = [ 'id' => 1, 'url' => 'georgie.com','title'=>'嘤嘤嘤' ];
print_r((new \georgie\arr\Arr())->filterKeys($d,['id','url']));
//过滤 下标为 id 的元素

当第三个参数为 0 时只保留指定的元素

$d = [ 'id' => 1, 'url' => 'georgie.com','title'=>'嘤嘤嘤' ];
print_r((new \georgie\arr\Arr())->filterKeys($d,['id'],0));
//只显示id与title 的元素

获得树状结构

(new \georgie\arr\Arr())->tree($data, $title, $fieldPri = 'cid', $fieldPid = 'pid');
参数                   	说明
$data                 	数组
$title                	字段名称
$fieldPri             	主键 id
$fieldPid             	父 id

获得目录列表

(new \georgie\arr\Arr())->channelList($data, $pid = 0, $html = " ", $fieldPri = 'cid', $fieldPid = 'pid', $level = 1);
参数                      	说明 
data                 	操作的数组
pid                  	父级栏目的 id 值
html                	栏目名称前缀,用于在视图中显示层次感的栏目列表 
fieldPri              	唯一键名,如果是表则是表的主键
fieldPid              	父 ID 键名
level                 	等级(不需要传参数,系统运行时使用 ) 

获得多级目录列表(多维数组)

(new \georgie\arr\Arr())->channelLevel($data, $pid = 0, $html = " ", $fieldPri = 'cid', $fieldPid = 'pid') 
参数                          	说明
data                      	操作的数组
pid                      	父级栏目的 id 值
html                     	栏目名称前缀,用于在视图中显示层次感的栏目列表
fieldPri                 	唯一键名,如果是表则是表的主键
fieldPid                  	父 ID 键名

获得所有父级栏目

(new \georgie\arr\Arr())->parentChannel($data, $sid, $fieldPri = 'cid', $fieldPid = 'pid');
参数                          	说明
data                      	操作的数组
sid                      	子栏目
fieldPri                 	唯一键名,如果是表则是表的主键
fieldPid                  	父 ID 键名

是否为子栏目

(new \georgie\arr\Arr())->isChild($data, $sid, $pid, $fieldPri = 'cid', $fieldPid = 'pid')
参数                          	说明
data                      	操作的数组
sid                      	子栏目id
pid                      	父栏目id
fieldPri                 	唯一键名,如果是表则是表的主键
fieldPid                  	父 ID 键名

是否有子栏目

(new \georgie\arr\Arr())->hasChild($data, $cid, $fieldPid = 'pid')
参数                          	说明
data                      	操作的数组
cid                      	栏目cid
fieldPid                  	父 ID 键名

无限级栏目分类

(new \georgie\arr\Arr())->category($categories,$pid = 0,$title = 'title',$id = 'id',$parent_id = 'parent_id')
参数								说明
$categories						操作的数组
$pid								父级编号
$title                  		栏目字段
$id								主键名
$parent_id						父级字段名

迪卡尔乘积

(new \georgie\arr\Arr())->descarte($arr, $tmp = array())

其他

\Georgie\Utils\

Results 处理结果类的封装

  • 一般用于返回统一格式的时候使用(API) 1.Trait方式引入 ,在 Class 中引入 use Georgie\Utils\Traits\Results 2.对象方式引入 new Georgie\Utils\Results 3.Georgie\Utils\Results::getClass()

  • 返回结果默认格式定义如下

    
    //默认返回的消息
     protected static $defaultMsgList = [
    
         // 成功
         0 => '操作成功',
    
         // 2000 - 2999 服务器的业务交互的友好提示
         2000 => '服务器繁忙',    // 服务器返回友好提示
         2001 => '未知错误',
         2002 => '没有更多数据了', // (针对列表式加载更多)
         2003 => '暂无数据', // 数据不存在
    
         // 4001 - 4999 客户端引起的错误
         4002 => '非法请求', // (post & get 请求不正确)
         4003 => '参数错误', // 具体是什么参数错误,可以在返回的时候输入msg参数
         4004 => '签名无效', // --基类
         4005 => '认证错误', // token 无效--基类
         4006 => '请求无效', // (时间校验失败)--基类
    
         // 5001 - 5999 服务器错误(用户自定义的错误,都应该在这个段)
         5500 => '服务器内部错误',
         5501 => '服务器不具备完成请求的功能',
         5502 => '服务器网关异常',
         5503 => '服务器目前无法使用',
         5504 => '服务器网关超时',
         5505 => '服务器不支持请求',
         5403 => '服务器处理异常',
         5404 => '页面不存在',
         5413 => '请求实体过大',
         5414 => '请求的 URI 过长',
     ];
    
* 调用方法
(new Georgie\Utils\Results)->returnJson($array = null);

(new Georgie\Utils\Results)->success($data = [], $msg = '', $params = []);

(new Georgie\Utils\Results)->paramsError($msg = '', $params = []);

(new Georgie\Utils\Results)->error($msg = '', $code = 2000, $params = []);

(new Georgie\Utils\Results)->authError($params = []);

(new Georgie\Utils\Results)->setCode($code);

(new Georgie\Utils\Results)->setMsg($msg = '');

//返回格式:
[
    'code' => 0,
    'msg'  => '',
    'data' => [],
    'time' => 0
]
### 时间助手

//获取当前时间 TimerHelper::getData($format = "Y-m-d H:i:s"); //获取当前时间戳 TimerHelper::getTime(); //获取当前毫秒时间 TimerHelper::getUDate(); //计算时间差 type: time(时间戳) day hour minute TimerHelper::getTimeDifference($end_time, $start_time,$type='time'); //计算时间差 返回字符串 n天n小时n分钟 TimerHelper::getTimeDifferenceStr($end_time,$start_time,$type="dHis"); //将指定日期转换为时间戳 TimerHelper::dateToTimestamp($date); //获取某个时间多少分钟之后的时间 TimerHelper::dateRear($format = "Y-m-d H:i:s", $mun = 10); //获取某个时间多少分钟之前的时间 TimerHelper::dateBefore($format = "Y-m-d H:i:s", $mun = 10); //判断当前的时分是否在指定的时间段内 TimerHelper::checkIsBetweenTime($start, $end);


### 文件助手

//删除目录和文件 FileHelper::delDir($path, $isDelCurrent = false);

//获取文件扩展名 FileHelper::getExt($str);


### ip地址助手

//获取客户端的真实IP (useProx是否使用代理IP) IPHelper::remoteIp($useProxy = false)

//随机生成IP地址 IPHelper::randIp()


### 字符串助手(含随机)

//生成唯一数字 eg: YYYYMMDDHHIISSNNNNNNNNCC 24 StrHelper::uniqueNum();

//生成唯一的 guid StrHelper::guid();

//随机字长度的随机字符串 //type: number letter string all StrHelper::random($length = 6, $type = 'string')


### 验证助手

//验证手机号 ValidateHelper::checkPhone($phone);

//验证邮箱 ValidateHelper::checkEmail($email);

//验证是否HTTP地址 ValidateHelper::isHttp($str);

//验证是否是 json 字符串 ValidateHelper::isJson($str)

### HTTP请求助手

//curl post 请求封装 HttpHelper::curlPost($url, $data, $options = [])

//curl get 请求封装 HttpHelper::curlGet($url, $data, $options = [])

//curl 请求封装 curl($method, $url, $data='', $options = [])