###1. 简介（brief intruoduction）
> ExcelDemo 是基于 spreadsheet excel 库做的封装，支持报表的快速生成，节约开发成本。



###2. 组成结构（structure）

* `src` 是源码文件夹
    * `Base.php` 是一个基类，实现类一些通用的方法
    * `NormalTable.php` 普通报表类，支持将输入的数据原生的写入excel中
    * `ReportFrom.php` 多维度合并报表类，支持对相同维度值进行行合并

* `test` 测试文件夹 
    
     
###3. 使用方法（usage）

* 生成普通的表格类型 excel文件下载

        use ExcelDemo\NormalTable;
        
        $powerExcel = new NormalTable();
        
        //只生成一个sheet
        $sheet_title = ['姓名','班级'];//列名称
        $sheet_data  = [['张三','1304'],['李四', '1304']]; //数据
        $sheet_name  = '1304班级' // sheet 名
        $filename    = '学生明细' //文件名
        $save_path   = '/tmp' //excel 下载到本地，存放地址
        $is_down     = true //是否直接下载，true：直接web下载， false：保存到本地
        
        $powerExcel->singleSheet($sheet_title, $sheet_data, $filename, $sheet_name, $save_path, $is_down);


        //生成包含多个sheet excel文件
        $excel_data = [[
            'sheet_title' => $sheet_title,
            'sheet_data'  => $sheet_data,
            '$sheet_name' => $$sheet_name
        ],[
            'sheet_title' => $sheet_title,
            'sheet_data'  => $sheet_data,
            '$sheet_name' => $$sheet_name
        ]]
        
        $powerExcel->numerouseSheet($excel_data, $filename, $save_path, true);

* 支持报表中维度重复值合并类型 excel文件下载

        use ExcelDemo\ReportFrom;
                
        $powerExcel = new ReportFrom();
       
        //只生成一个sheet
        $sheet_title = ['城市','端','uv','pv']; //列名称
        $sheet_data  = [['北京','app',222,10000],['北京', 'app',333,40000],['北京', 'apph5',333,40000], ['上海', 'apph5',333,40000],['杭州', 'apph5',333,40000],['杭州', 'pc',333,40000]]; //数据
        $dim_cnt     = 2; //维度数量
        $sheet_name  = '城市维度用户分布' // sheet 名
        $filename    = '产品用户分析' //文件名
        $save_path   = '/tmp' //excel 下载到本地，存放地址
        $is_down     = true //是否直接下载，true：直接web下载， false：保存到本地
        
        $powerExcel->singleSheet($sheet_title, $dim_cnt, $sheet_data, $filename, $sheet_name, $save_path, $is_down);


        //生成包含多个sheet excel文件
        $excel_data = [[
            'sheet_title' => $sheet_title,
            'dim_cnt'    => $dim_cnt,
            'sheet_data'  => $sheet_data,
            '$sheet_name' => $$sheet_name
        ],[
            'sheet_title' => $sheet_title,
            'dim_cnt'    => $dim_cnt,
            'sheet_data'  => $sheet_data,
            '$sheet_name' => $$sheet_name
        ]]
        
        $powerExcel->numerouseSheet($excel_data, $filename, $save_path, true);

      
###4. 使用composer 加载

* 在composer.json require 中天添加 ` "aozeahj/excel-demo": "v0.1.3" `

* 运行命令 composer update

        {
            "require": {
                "aozeahj/excel-demo": "v0.1.3"
            }
        }
  
  
  
###5. 使用须知

* 维度行合并是只会合并邻近的相同维度值行，不会全局合并，这样数据排列的格式就由用户自定义，更加自由

* 所有的单元格在插入值的时候，默认都加了一个 ' ' 空格前缀，这是为了避免数字输入过长（超过11位）被写成科学记数法格式，加上空格前缀的好处是，接收到的数据都会当作字符串，从而保证数据不变

* excel文件中sheet名称，未传参数时，默认使用 sheet1，sheet2 .....