包简介

Allow KoolReport to use platesphp template engine to render view

README 文档

README

Overview

Starting from version 4.0.0, KoolReport supports other template engines rather than just its own template view file and PlatesPhp is one of them.

Plates is a native PHP template system that’s fast, easy to use and easy to extend. It’s inspired by the excellent Twig template engine and strives to bring modern template language functionality to native PHP templates. Plates is designed for developers who prefer to use native PHP templates over compiled template languages, such as Twig or Smarty.

Highlight

Native PHP templates, no new syntax to learn
Plates is a template system, not a template language
Plates encourages the use of existing PHP functions
Increase code reuse with template layouts and inheritance
Template folders for grouping templates into namespaces
Data sharing across templates
Preassign data to specific templates
Built-in escaping helpers
Easy to extend using functions and extensions
Framework-agnostic, will work with any project
Decoupled design makes templates easy to test
Composer ready and PSR-2 compliant

You may read more information about Plates PHP in here.

Installation

By downloading .zip file

Download
Unzip the zip file
Copy the folder platesphp into koolreport folder so that look like below

koolreport
├── core
├── platesphp

By composer

composer require koolreport/platesphp

Get started

Step 1: First create a folder to hold the views

project/
├── reports/
│   └── MyReport.php
├── views/
│   └── myreport.phtml

Step 2: Next, in your MyReport.php you initiate platesphp template like this:

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

class MyReport extends \koolreport\KoolReport
{
    use \koolreport\platesphp\Engine;
    
    protected function platesInit()
    {
        return League\Plates\Engine::create(dirname(__FILE__).'/../views');
    }
    ...

}

Step 3: Create report's view content. In your myreport.phtml you can do:

<html>
<head>
    <title>MyReport</title>
</head>
<body>
    <?php
    \koolreport\widgets\koolphp\Table::create(array(
        "dataSource"=>$report->dataStore("result"),
    ));
    ?>
</body>
</html>

Important Note: You need to use $report variable to refer to the report class, not $this as you do when use default Koolreport view file.

Step 4: To make the report run and render, you do:

//index.php

require_once "MyReport.php";

$report = new MyReport;
$report->run()->render("myreport"); // You need to specify the view you want to render

Now your report will run and then use myreport.phtml to render the view of report.

Congrat!

Resources

Support

Please use our forum if you need support, by this way other people can benefit as well. If the support request need privacy, you may send email to us at support@koolreport.com.

koolreport/platesphp 适用场景与选型建议

koolreport/platesphp 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 15 次下载、GitHub Stars 达 0，最近一次更新时间为 2019 年 06 月 01 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「php」「template engine」「Data Report」「Reporting Tools」「platesphp」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 koolreport/platesphp 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 koolreport/platesphp 我们能提供哪些服务？

定制开发 / 二次开发

基于 koolreport/platesphp 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 koolreport/platesphp 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

plasticstudio/silverstripe-seo 2

A SilverStripe module to optimise the Meta, crawling, indexing, and sharing of your website content (forked from Cyber-Duck/Silverstripe-SEO)

ouxsoft/phpmarkup 0

A Processor for Markup written in PHP. Allows extraction of Markup into a data structure, orchestrated nested manipulation of said structure, and output as (optimized) Markup.

koolreport/twig 0

Allow KoolReport to use twig template engine to render view

xtompie/tpl 0

Simple template engine

gurubob/ascii-table 2

Simple ASCII output of array data

e2es/blade 0

E2E Studios PHP Framework adaptation of leafsphp/blade package