koolreport/platesphp

允许 KoolReport 使用 platesphp 模板引擎来渲染视图

1.0.0 2019-06-01 06:14 UTC

This package is auto-updated.

Last update: 2024-09-11 00:42:41 UTC


README

概述

从版本 4.0.0 开始,KoolReport 支持其他模板引擎,而不仅仅是自己的模板视图文件,其中 PlatesPhp 是其中之一。

Plates 是一个快速、易于使用且易于扩展的本地 PHP 模板系统。它受到了优秀的 Twig 模板引擎的启发,并致力于将现代模板语言功能带到本地 PHP 模板中。Plates 是为那些喜欢使用本地 PHP 模板而不是编译模板语言(如 Twig 或 Smarty)的开发者设计的。

亮点

  • 本地 PHP 模板,无需学习新语法
  • Plates 是一个模板系统,不是一个模板语言
  • Plates 鼓励使用现有的 PHP 函数
  • 通过模板布局和继承提高代码重用
  • 模板文件夹用于将模板分组到命名空间中
  • 模板之间共享数据
  • 预先分配数据到特定模板
  • 内置转义辅助工具
  • 通过函数和扩展轻松扩展
  • 框架无关,适用于任何项目
  • 解耦设计使模板易于测试
  • Composer 准备就绪且符合 PSR-2 标准

您可以在 这里 阅取更多关于 Plates PHP 的信息。

安装

通过下载 .zip 文件

  1. 下载
  2. 解压缩 zip 文件
  3. platesphp 文件夹复制到 koolreport 文件夹中,使其看起来如下所示
koolreport
├── core
├── platesphp

通过 composer

composer require koolreport/platesphp

开始使用

步骤 1: 首先创建一个用于存放视图的文件夹

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

步骤 2: 接下来,在您的 MyReport.php 中,您可以这样初始化 platesphp 模板

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');
    }
    ...

}

步骤 3: 创建报告的视图内容。在您的 myreport.phtml 中,您可以这样做

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

重要提示: 您需要使用 $report 变量来引用报告类,而不是像使用默认的 Koolreport 视图文件时那样使用 $this

步骤 4: 要使报告运行并渲染,您需要这样做

//index.php

require_once "MyReport.php";

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

现在您的报告将运行,然后使用 myreport.phtml 来渲染报告的视图。

恭喜!

资源

  1. 完整文档
  2. 示例与演示

支持

如果您需要支持,请使用 我们的论坛,这样其他人也可以从中受益。如果支持请求需要隐私,您可以通过发送电子邮件到 support@koolreport.com 来联系我们。