majorsilence/reporting

Installation

Installez via Composer (PHP 8.1+ requis) :

composer require majorsilence/reporting

Ou clonez le dépôt et incluez l'autoloader manuellement :

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

Aucune dépendance Composer en runtime. Le mode natif FFI nécessite en plus ext-ffi et ffi.enable=true dans php.ini.

Modes d'intégration

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

// Enregistrer sur le disque
$rpt->export('pdf', '/tmp/output.pdf');

// Ou diffuser vers le navigateur
$data = $rpt->export_to_memory('pdf');
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="report.pdf"');
echo $data;

ReportAot — binaire AOT

Même API que Report, mais pointe vers un binaire autonome. Aucun runtime .NET requis. Débloque aussi des formats d'export supplémentaires (xlsx_table, tifb, mht).

use MajorsilenceReporting\ReportAot;

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

Charge librdlnative.so directement dans le processus PHP via FFI. Aucun processus enfant n'est lancé. Nécessite ext-ffi et ffi.enable=true.

use MajorsilenceReporting\ReportNative;
use MajorsilenceReporting\RdlLibrary;

// Charger la bibliothèque native une seule fois. Définit RDLNATIVE_LIB_DIR automatiquement.
$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 principale

Les trois classes partagent la même interface (espace de noms PSR-4 MajorsilenceReporting\) :

Jeux de données en mémoire

ReportNative permet de fournir des données entièrement en mémoire via add_data() — aucune connexion à une base de données requise. Passez un nom de jeu de données et un tableau de tableaux associatifs où chaque valeur est une chaîne.

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

Formats d'export