majorsilence/reporting

安装

通过 Composer 安装(需要 PHP 8.1+):

composer require majorsilence/reporting

或者克隆仓库并手动引入自动加载器:

require_once __DIR__ . '/vendor/autoload.php';

无 Composer 运行时依赖。原生 FFI 模式还需要 ext-ffi 以及 php.ini 中的 ffi.enable=true。

集成模式

Report —— 子进程(dotnet)

use MajorsilenceReporting\Report;

$rpt = new Report(
    '/path/to/report.rdl',
    '/path/to/RdlCmd.dll'
);
$rpt->set_connection_string('Data Source=/path/to/data.db');
$rpt->set_parameter('StartDate', '2026-01-01');

// 保存到磁盘
$rpt->export('pdf', '/tmp/output.pdf');

// 或直接流式输出到浏览器
$data = $rpt->export_to_memory('pdf');
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="report.pdf"');
echo $data;

ReportAot —— AOT 二进制

与 Report 使用相同的 API,但指向自包含的二进制文件。无需 .NET 运行时。还可解锁额外的导出格式(xlsx_table、tifb、mht)。

use MajorsilenceReporting\ReportAot;

$rpt = new ReportAot(
    '/path/to/report.rdl',
    '/path/to/RdlCmd'   // 自包含二进制文件
);
$rpt->set_connection_string('Data Source=/path/to/data.db');

$data = $rpt->export_to_memory('xlsx_table');
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
echo $data;

ReportNative —— PHP FFI

通过 FFI 将 librdlnative.so 直接加载到 PHP 进程中。不会启动任何子进程。需要 ext-ffi 和 ffi.enable=true。

use MajorsilenceReporting\ReportNative;
use MajorsilenceReporting\RdlLibrary;

// 只加载原生库一次。会自动设置 RDLNATIVE_LIB_DIR。
$lib = RdlLibrary::load('/path/to/librdlnative.so');

$rpt = new ReportNative($lib, '/path/to/report.rdl');
$rpt->set_connection_string('Data Source=/path/to/data.db');

$data = $rpt->export_to_memory('pdf');
header('Content-Type: application/pdf');
echo $data;

核心 API

三个类共享同一接口(PSR-4 命名空间 MajorsilenceReporting\):

内存数据集

ReportNative 支持通过 add_data() 完全在内存中提供数据——无需数据库连接。传入数据集名称和一个关联数组组成的数组,其中每个值都是字符串。

$rpt->add_data('SalesData', [
    ['Product' => 'PDF Library Pro',  'Revenue' => '1200.00', 'Units' => '3'],
    ['Product' => 'Report Designer',   'Revenue' => '250.00',  'Units' => '1'],
    ['Product' => 'Support (12 mo.)',  'Revenue' => '500.00',  'Units' => '1'],
]);

$data = $rpt->export_to_memory('pdf');

导出格式