KoolReport

KoolReport是一个直观灵活的开源PHP报告框架，可以更快更轻松地生成报告。它让您完全控制数据处理和数据可视化过程。它快速、简单，并且可以通过多种方式进行扩展。

功能特点

支持多种数据源，包括关系型数据库如MySQL、SQL Server、Oracle，以及NoSQL数据库如MongoDB、CSV或Excel文件。
多种数据处理方式:数据转换、连接、分组、过滤等。
通过小部件、图表和表格实现出色的可视化效果。
可在KoolReport扩展包找到更多扩展包。

更新日志

6.1.0版本 (2023年3月31日)
6.0.1版本 (2022年10月3日)
6.0.0版本 (2022年9月23日)
5.5.0版本 (2021年11月15日)
5.1.0版本 (2021年7月7日)
5.0.1版本 (2021年1月11日)
5.0.0版本 (2020年11月11日)
4.7.1版本 (2020年5月19日)
4.7.0版本 (2020年5月15日)
4.5.1版本 (2020年2月4日)
4.5.0版本 (2020年1月21日)
4.3.0版本 (2019年10月4日)
4.0.0版本 (2019年6月6日)
3.25.4版本 (2019年2月15日)
3.25.3版本 (2019年2月14日)
3.25.1版本 (2019年2月13日)
3.25.0版本 (2019年2月11日)
3.1.0版本 (2018年11月17日)
3.0.0版本 (2018年11月13日)
2.78.0版本 (2018年7月16日)
2.43.0版本 (2018年4月20日)
2.42.0版本 (2018年3月19日)
2.41.3版本 (2018年3月2日)
2.31.8版本 (2018年2月5日)
2.31.7版本 (2018年1月26日)
2.0.0版本 (2017年12月23日)
1.72.8版本 (2017年10月30日)
1.61.5版本 (2017年9月27日)
1.61.2版本 (2017年9月21日)
1.47.3版本 (2017年8月23日)
1.34.9版本 (2017年7月25日)
1.32.8版本 (2017年7月5日)
1.27.6版本 (2017年6月7日)
1.15.4版本 (2017年5月22日)
1.11.4版本 (2017年5月4日)
1.0.0版本 (2017年4月3日)

入门指南

系统要求

PHP 5.4或更高版本

安装

通过composer安装

如果您使用composer，可以运行以下命令安装最新版本

$ composer require koolreport/core

手动下载

请访问我们的入门页面，按照指南进行安装。

包含的内容

koolreport/
├── core/
│   ├── src/
│   ├── tests/
│   └── autoload.php

创建您的第一个报告

创建两个文件SalesByCustomer.php和SalesByCustomer.view.php

/
├── koolreport/
├── myreport/
│   ├── SalesByCustomer.php
│   ├── SalesByCustomer.view.php
│   └── index.php

index.php

<?php
// index.php: 仅作为引导文件
require_once "SalesByCustomer.php";

$salesByCustomer = new SalesByCustomer;
$salesByCustomer->run()->render();

SalesByCustomer.php

<?php
require_once "../koolreport/core/autoload.php";

// 指定将用于处理数据的一些数据处理过程
use \koolreport\processes\Group;
use \koolreport\processes\Sort;
use \koolreport\processes\Limit;

// 定义类
class SalesByCustomer extends \koolreport\KoolReport
{    
    protected function settings()
    {
        // 定义"sales"数据源，即orders.csv
        return array(
            "dataSources"=>array(
                "sales"=>array(
                    "class"=>'\koolreport\datasources\CSVDataSource',
                    "filePath"=>"orders.csv",
                ),        
            )
        );
    }
  
    protected function setup()
    {
        // 选择数据源，然后通过各种处理过程传输数据
        // 直到到达最终的数据存储，名为"sales_by_customer"。
        $this->src('sales')
        ->pipe(new Group(array(
            "by"=>"customerName",
            "sum"=>"dollar_sales"
        )))
        ->pipe(new Sort(array(
            "dollar_sales"=>"desc"
        )))
        ->pipe(new Limit(array(10)))
        ->pipe($this->dataStore('sales_by_customer'));
    }
}

SalesByCustomer.view.php

<?php 
    use \koolreport\widgets\koolphp\Table;
    use \koolreport\widgets\google\BarChart;
?>

<div class="report-content">
    <div class="text-center">
        <h1>客户销售报告</h1>
        <p class="lead">本报告显示了前10名客户的销售情况</p>
    </div>

    <?php
    BarChart::create(array(
        "dataStore"=>$this->dataStore('sales_by_customer'),
        "width"=>"100%",
        "height"=>"500px",
        "columns"=>array(
            "customerName"=>array(
                "label"=>"客户"
            ),
            "dollar_sales"=>array(
                "type"=>"number",
                "label"=>"金额",
                "prefix"=>"$",
                "emphasis"=>true
            )
        ),
        "options"=>array(
            "title"=>"客户销售情况",
        )
    ));
    ?>
    <?php
    Table::create(array(
        "dataStore"=>$this->dataStore('sales_by_customer'),
            "columns"=>array(
                "customerName"=>array(
                    "label"=>"客户"
                ),
                "dollar_sales"=>array(
                    "type"=>"number",
                    "label"=>"金额",
                    "prefix"=>"$",
                )
            ),
        "cssClass"=>array(
            "table"=>"table table-hover table-bordered"
        )
    ));
    ?>
</div>