linkorb/birt-renderer

从PHP中渲染BIRT报告

dev-master 2019-05-14 16:56 UTC

This package is auto-updated.

Last update: 2024-09-15 04:36:54 UTC


README

从您的PHP应用程序中渲染BIRT .rptdesign 文件。

您可以使用BIRT设计器创建报告,并将它们保存为.rptdesign文件。然后您可以从您的PHP应用程序生成报告,并将它们呈现给最终用户。

报告可以生成HTML、PDF、DOC、XLS、PPT和Postscript格式。

工作原理

这个库是对BIRT运行时的genReport.sh脚本的干净包装。这意味着您需要安装BIRT运行时(见下文)。

先决条件:BIRT运行时

您需要在您的计算机/服务器上的某个位置提取BIRT运行时的最新版本。

您可以从这里下载它:http://download.eclipse.org/birt/downloads/

确保您下载的是BIRT运行时,而不是全功能或其他选项。

在下载文件(birt-runtime-4_4_1-20140916.zip,截至本文撰写时)后,只需将zip文件解压缩到您的磁盘上的某个位置。

您需要记住路径名,因为您需要在代码中实例化新的Renderer时使用它。

PHP中的示例用法

use BirtRenderer\Renderer;
use BirtRenderer\Report;
use BirtRenderer\Parameter;

// Instantiate a report, by filename
$report = new Report();
$report->loadFilename('/home/yourname/example.rptdesign');

// Instantiate the Renderer
$renderer = new Renderer();
// Set the BIRT_HOME environment variable (important)
$renderer->setBirtHome('/home/yourname/birt-runtime-4_4_1');

// Create a list of report-parameters (key/value)
$parameters = array();
$parameters[] = new Parameter('Color', 'Red');
$parameters[] = new Parameter('Size', 'XL');

// Render the report, with supplied parameters to $outputfilename
$outputfilename = '/home/yourname/out.pdf';
$renderer->render($report, $parameters, $outputfilename);

控制台中的示例用法

此库包括一个示例控制台命令来调用库。您可以使用它如下

export BIRT_HOME=/home/yourname/birt-runtime-4_4_1
./bin/birt-renderer report:render --parameter Color=Red --parameter Size=XL myreport.rptdesign output.pdf

根据输出文件的文件扩展名,它会自动检测格式。

许可证

MIT(见LICENSE.md

由LinkORB工程技术团队提供


请查看我们的其他项目linkorb.com/engineering

顺便说一下,我们在招聘!