第三方扩展函数-S1后台管理开发手册帮助文档

# extend.php 函数说明文档

本文档描述了 `app/extend.php` 文件中提供的公共扩展函数。该文件包含系统研发过程中需要的扩展函数，主要用于处理Excel、邮件发送、条形码和二维码生成等功能。

## 目录
1. [Excel处理函数](#excel处理函数)
2. [邮件发送函数](#邮件发送函数)
3. [条形码和二维码生成函数](#条形码和二维码生成函数)
4. [其他扩展函数](#其他扩展函数)

## Excel处理函数

### convert_excel_date($dateValue)
转换Excel日期格式为标准日期格式
- 参数:
  - `$dateValue`: Excel日期值（可以是数字或日期字符串）
- 返回值: 标准日期格式字符串或null

### export_excel($titles = '', $keys = '', $data = [], $file_name = '导出文件')
导出excel信息
- 参数:
  - `$titles`: 导出的表格标题（默认为空字符串）
  - `$keys`: 需要导出的键名（默认为空字符串）
  - `$data`: 需要导出的数据（默认为空数组）
  - `$file_name`: 导出的文件名称（默认为'导出文件'）
- 返回值: 无（直接输出Excel文件并退出）

### get_excel_obj($file_name = '导出文件')
获取excel对象
- 参数:
  - `$file_name`: 文件名称（默认为'导出文件'）
- 返回值: PHPExcel对象

### get_excel_data($file_url = '', $start_row = 1, $start_col = 0, $end_row = 0, $limit = 0)
读取excel返回数据
- 参数:
  - `$file_url`: 文件路径（默认为空字符串）
  - `$start_row`: 起始行（默认为1）
  - `$start_col`: 起始列（默认为0）
  - `$end_row`: 结束行（可选，默认为0）
  - `$limit`: 限制条数（可选，默认为0）
- 返回值: Excel数据数组

### string_from_column_index($pColumnIndex = 0)
数字转字母（用于Excel列名）
- 参数:
  - `$pColumnIndex`: 列索引（默认为0）
- 返回值: 对应的Excel列字母（如A、B、AA等）

## 邮件发送函数

### send_email($address, $title, $message, $config = [])
发送邮件
- 参数:
  - `$address`: 收件人地址
  - `$title`: 邮件标题
  - `$message`: 邮件内容
  - `$config`: 邮件配置（默认为空数组）
- 返回值: 发送成功返回true，失败返回错误信息

## 条形码和二维码生成函数

### create_barcode($text = '', $file_name = '', $path = '', $codebar = 'BCGcode39')
生成条形码
- 参数:
  - `$text`: 写入内容（默认为空字符串）
  - `$file_name`: 文件名称（默认为空字符串）
  - `$path`: 条形码保存路径（默认为空字符串）
  - `$codebar`: 条形码类型（默认为'BCGcode39'）
    可选类型: 'BCGcodabar','BCGcode11','BCGcode39','BCGcode39extended','BCGcode93',
    'BCGcode128','BCGean8','BCGean13','BCGisbn','BCGi25','BCGs25','BCGmsi',
    'BCGupca','BCGupce','BCGupcext2','BCGupcext5','BCGpostnet','BCGothercode'
- 返回值: 包含文件名和路径的数组

### create_qrcode($data = '', $path = '', $ecc = 'H', $size = 10)
生成二维码
- 参数:
  - `$data`: 写入数据（默认为空字符串）
  - `$path`: 二维码保存路径（默认为空字符串）
  - `$ecc`: 错误修正水平（默认为'H'）可选值: 'L','M','Q','H'
  - `$size`: 二维码大小（默认为10）范围: 1 - 10
- 返回值: 包含文件名和路径的数组

## 其他扩展函数

### getKeywords($title = "", $content = "")
关键字提取方法
- 参数:
  - `$title`: 进行分词的标题（默认为空字符串）
  - `$content`: 进行分词的内容（默认为空字符串）
- 返回值: 关键词数组

### http($method, $url, $params = '', $header = [], $timeout = 30, $options = [])
HTTP请求函数
- 参数:
  - `$method`: 请求方法（GET、POST、PUT、DELETE）
  - `$url`: 请求地址
  - `$params`: 请求参数（默认为空字符串）
  - `$header`: 请求头（默认为空数组）
  - `$timeout`: 超时时间（默认为30秒）
  - `$options`: 其他选项（默认为空数组）
- 返回值: 请求结果

### httpRpc($url, $params = [], $method = 'get')
HTTP RPC请求函数（仅供内部使用）
- 参数:
  - `$url`: 请求地址
  - `$params`: 请求参数（默认为空数组）
  - `$method`: 请求方法（默认为'get'）
- 返回值: 包含code、msg、data的数组