majorsilence/reporting

Instalación

Instala vía Composer (se requiere PHP 8.1+):

composer require majorsilence/reporting

O clona el repositorio e incluye el autoloader manualmente:

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

Sin dependencias de Composer en tiempo de ejecución. El modo nativo FFI requiere además ext-ffi y ffi.enable=true en php.ini.

Modos de integración

Report — subproceso (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');

// Guardar en disco
$rpt->export('pdf', '/tmp/output.pdf');

// O transmitir al navegador
$data = $rpt->export_to_memory('pdf');
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="report.pdf"');
echo $data;

ReportAot — binario AOT

Misma API que Report, pero apunta a un binario autocontenido. No se necesita runtime de .NET. También habilita formatos de exportación adicionales (xlsx_table, tifb, mht).

use MajorsilenceReporting\ReportAot;

$rpt = new ReportAot(
    '/path/to/report.rdl',
    '/path/to/RdlCmd'   // binario autocontenido
);
$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

Carga librdlnative.so directamente en el proceso de PHP mediante FFI. No se genera ningún proceso hijo. Requiere ext-ffi y ffi.enable=true.

use MajorsilenceReporting\ReportNative;
use MajorsilenceReporting\RdlLibrary;

// Cargar la biblioteca nativa una sola vez. Define RDLNATIVE_LIB_DIR automáticamente.
$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 principal

Las tres clases comparten la misma interfaz (espacio de nombres PSR-4 MajorsilenceReporting\):

Conjuntos de datos en memoria

ReportNative permite suministrar datos completamente en memoria mediante add_data() — sin necesidad de conexión a una base de datos. Pasa un nombre de conjunto de datos y un array de arrays asociativos donde cada valor es una cadena.

$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');

Formatos de exportación