系统扩展函数-S1后台管理开发手册帮助文档

# function.php 函数说明文档

本文档描述了 `app/function.php` 文件中提供的公共函数。该文件包含系统研发过程中需要的扩展函数，与框架相关函数分离。

## 目录
1. [时间相关函数](#时间相关函数)
2. [字符处理相关函数](#字符处理相关函数)
3. [数组处理相关函数](#数组处理相关函数)
4. [判断相关函数](#判断相关函数)
5. [模块编码相关函数](#模块编码相关函数)

## 时间相关函数

### date_calc($time = null, $caclVal = "0", $type = "day", $format = 'Y-m-d')
时间计算函数
- 参数:
  - `$time`: 时间（可选，默认为当前时间）
  - `$caclVal`: 增加、减少的值（默认为"0"）
  - `$type`: 计算时间类型（默认为"day"）
  - `$format`: 日期格式（默认为'Y-m-d'）
- 返回值: 格式化后的时间字符串

### date_to_day($dates = [])
将日期数组转换为天数组
- 参数:
  - `$dates`: 日期数组
- 返回值: 天数组

### time_friend($time)
友好的时间显示函数 1.0
- 参数:
  - `$time`: 时间戳
- 返回值: 美化后的时间字符串

### time_friend3($sTime, $type = 'normal', $alt = 'false')
友好的时间显示函数 3.0
- 参数:
  - `$sTime`: 待显示的时间
  - `$type`: 类型. normal | mohu | full | ymd | other（默认为'normal'）
  - `$alt`: 已失效（默认为'false'）
- 返回值: 美化后的时间字符串

### make_time()
生成时间段，开始和结束时间
- 返回值: 包含各种时间范围的数组，如今天、昨天、本周、本月等

### getMonthStartEndTime($date = '')
获得指定年的月的开始结束时间
- 参数:
  - `$date`: 日期（可选）
- 返回值: 包含开始和结束时间的数组

### getYearStartEndTime($year = '')
指定年月，年的起止时间
- 参数:
  - `$year`: 年份（可选）
- 返回值: 包含开始和结束时间的数组

### getQuarterStartEndTime($date = '')
指定年月，所在季度开始，结束时间
- 参数:
  - `$date`: 日期（可选）
- 返回值: 包含开始和结束时间的数组

### getDayStartEndTime($date = '')
指定日期的当天的开始时间和结束时间
- 参数:
  - `$date`: 日期（可选）
- 返回值: 包含开始和结束时间的数组

### getDatesBetweenToMonths($start_time, $end_time)
获取两个日期之间所有月份
- 参数:
  - `$start_time`: 开始时间
  - `$end_time`: 结束时间
- 返回值: 月份数组

### getDatesBetweenToWeeks($start_time, $end_time)
获取两个日期之间所有周
- 参数:
  - `$start_time`: 开始时间
  - `$end_time`: 结束时间
- 返回值: 周数组

### getDatesBetweenTwoDays($startDate, $endDate)
获取两个日期之间所有日期
- 参数:
  - `$startDate`: 开始时间(支持时间戳或日期字符串)
  - `$endDate`: 结束时间(支持时间戳或日期字符串)
- 返回值: 日期数组

### rangedate2arr($rangedate, $pirx = '-', $type = 'str')
时间段转为两个数组
- 参数:
  - `$rangedate`: 时间段字符串
  - `$pirx`: 两个时间段分隔符号（默认为'-'）
  - `$type`: 返回类型：str(返回字符串) | int(返回时间戳)（默认为'str'）
- 返回值: 包含开始和结束时间的数组

### covert_excel_date($dateValue)
转换Excel日期格式为标准日期格式
- 参数:
  - `$dateValue`: Excel日期值
- 返回值: 标准日期格式字符串

## 字符处理相关函数

### msubstr($str = '', $start = 0, $length = NULL, $suffix = false, $charset = "utf-8")
字符串截取，支持中文和其他编码
- 参数:
  - `$str`: 需要转换的字符串（默认为空字符串）
  - `$start`: 开始位置（默认为0）
  - `$length`: 截取长度（默认为NULL）
  - `$suffix`: 截断显示字符（默认为false）
  - `$charset`: 编码格式（默认为"utf-8"）
- 返回值: 截取后的字符串

### html_msubstr($str = '', $start = 0, $length = NULL, $suffix = false, $charset = "utf-8")
截取内容清除html之后的字符串长度，支持中文和其他编码
- 参数:
  - `$str`: 需要转换的字符串（默认为空字符串）
  - `$start`: 开始位置（默认为0）
  - `$length`: 截取长度（默认为NULL）
  - `$suffix`: 截断显示字符（默认为false）
  - `$charset`: 编码格式（默认为"utf-8"）
- 返回值: 截取后的字符串

### text_msubstr($str = '', $start = 0, $length = NULL, $suffix = false, $charset = "utf-8")
针对多语言截取，其他语言的截取是中文语言的2倍长度
- 参数:
  - `$str`: 需要转换的字符串（默认为空字符串）
  - `$start`: 开始位置（默认为0）
  - `$length`: 截取长度（默认为NULL）
  - `$suffix`: 截断显示字符（默认为false）
  - `$charset`: 编码格式（默认为"utf-8"）
- 返回值: 截取后的字符串

### htmlspecialchars_decode($str = '')
自定义只针对htmlspecialchars编码过的字符串进行解码
- 参数:
  - `$str`: 需要转换的字符串（默认为空字符串）
- 返回值: 解码后的字符串

### checkStrHtml($string)
过滤Html标签
- 参数:
  - `$string`: 内容
- 返回值: 过滤后的字符串

### trim_space($str, $arr = array())
过滤前后空格等多种字符
- 参数:
  - `$str`: 字符串
  - `$arr`: 特殊字符的数组集合（默认为空数组）
- 返回值: 处理后的字符串

### func_preg_replace($arr = array(), $replacement = ',', $str = '')
替换指定的符号
- 参数:
  - `$arr`: 特殊字符的数组集合（默认为空数组）
  - `$replacement`: 符号（默认为','）
  - `$str`: 字符串（默认为空字符串）
- 返回值: 处理后的字符串

### cut_str($str, $sign, $number)
字符串按符号截取
- 参数:
  - `$str`: 字符串
  - `$sign`: 分隔符
  - `$number`: 位置编号
- 返回值: 截取的字符串

### download($filepath, $filename = 'downfile.zip')
文件下载函数
- 参数:
  - `$filepath`: 文件路径
  - `$filename`: 文件名（默认为'downfile.zip'）
- 返回值: 无

### downFileOutput($file)
服务器文件下载输出，支持断点输出
- 参数:
  - `$file`: 文件路径为本地绝对路径
- 返回值: 文件

### check_file_exists($file)
判断文件是否存在，支持本地及远程文件
- 参数:
  - `$file`: 文件路径
- 返回值: 布尔值

### httpcode($url)
检测网址是否能正常打开
- 参数:
  - `$url`: 网址
- 返回值: HTTP状态码

### curl_post($url, $post_data, $contentType = 'post')
curl post获取数据
- 参数:
  - `$url`: URL地址
  - `$post_data`: POST数据
  - `$contentType`: 内容类型（默认为'post'）
- 返回值: 响应数据

### hiddle_name($user_name)
只保留字符串首尾字符，隐藏中间用*代替（两个字符时只显示第一个）
- 参数:
  - `$user_name`: 姓名
- 返回值: 格式化后的姓名

### hiddle_mobile($str)
定义函数手机号隐藏中间四位
- 参数:
  - `$str`: 手机号
- 返回值: 格式化后手机号

## 数组处理相关函数

### dd2char($ddnum)
生成一个随机字符
- 参数:
  - `$ddnum`: 数字字符串
- 返回值: 随机字符

### get_str_sum($str, $glue = '')
统计二数字串个数，支持按分隔符号统计
- 参数:
  - `$str`: 字符串
  - `$glue`: 分隔符（默认为空）
- 返回值: 统计结果

### obj2arr($array)
PHP stdClass Object转array
- 参数:
  - `$array`: 对象或数组
- 返回值: 数组

### get_2arr_sum($array, $column)
统计二维数组一列后，再求和
- 参数:
  - `$array`: 二维数组
  - `$column`: 列名
- 返回值: 求和结果

### arr_del_val($arr, $value)
删除数组中指定元素值
- 参数:
  - `$arr`: 数组
  - `$value`: 要删除的值
- 返回值: 处理后的数组

### array2unique_bykey($arr, $key)
二维数组去重（保留各个键值的同时去除重复的项）
- 参数:
  - `$arr`: 二维数组
  - `$key`: 用于去重的键名
- 返回值: 去重后的数组

### array2Sort($array, $keys, $sort = 'asc')
二维数组按照指定的键来进行排序
- 参数:
  - `$array`: 二维数组
  - `$keys`: 根据用来排序的键名
  - `$sort`: asc升序 desc 倒序（默认为'asc'）
- 返回值: 排序后的数组

### rowlist2arr($datalist)
字符串转换表达式,处理字符串格式的计算表达式
- 参数:
  - `$datalist`: 数据列表
- 返回值: 转换后的数组

### compress_html($uncompress_html_source)
清除html文件的空格注释信息
- 参数:
  - `$uncompress_html_source`: HTML源码
- 返回值: 压缩后的HTML

### parse_css($urls)
多个CSS文件压缩为一个CSS文件
- 参数:
  - `$urls`: CSS文件URL数组
- 返回值: 合并后的CSS文件路径

## 判断相关函数

### is_weixin()
判断是否为微信打开
- 返回值: 布尔值

### is_http_url($url)
判断url是否完整的链接
- 参数:
  - `$url`: 网址
- 返回值: 布尔值

### tableExists($table)
判断系统中数据库表是否存在
- 参数:
  - `$table`: 表名
- 返回值: 布尔值

### appExists($appname)
判断系统中模块是否存在
- 参数:
  - `$appname`: 模块名称
- 返回值: 布尔值

## 模块编码相关函数

### get_sys_seqnum($name, $isupdate = false)
获取系统编码
- 参数:
  - `$name`: 模块名称
  - `$isupdate`: 是否更新（默认为false）
- 返回值: 系统编码

### get_sequence_nums($name = '', $prekey = '', $value = 1)
获取自增编码
- 参数:
  - `$name`: 名称（默认为空字符串）
  - `$prekey`: 前缀键（默认为空字符串）
  - `$value`: 值（默认为1）
- 返回值: 编码值

### set_sequence_nums($name = '', $prekey = '')
更新自增编码
- 参数:
  - `$name`: 名称（默认为空字符串）
  - `$prekey`: 前缀键（默认为空字符串）
- 返回值: 无