PHPackages                             hqsoft/reportkit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF & Document Generation](/categories/documents)
4. /
5. hqsoft/reportkit

ActiveLibrary[PDF & Document Generation](/categories/documents)

hqsoft/reportkit
================

Framework para generar reportes y documentos en PDF, Excel y CSV mediante un layout de 24 columnas.

1.0.3(2mo ago)033↓50%1MITPHP

Since Feb 5Pushed 2mo agoCompare

[ Source](https://github.com/hugoquijada/report-kit)[ Packagist](https://packagist.org/packages/hqsoft/reportkit)[ RSS](/packages/hqsoft-reportkit/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (5)Used By (1)

Report Kit
==========

[](#report-kit)

Librería PHP para la generación fluida de reportes multipropósito (HTML, Excel, CSV, PDF). Diseñada para definir la estructura y el estilo del reporte una sola vez y renderizarlo en múltiples formatos.

Instalación
-----------

[](#instalación)

```
composer require hqsoft/report-kit
```

Uso Básico
----------

[](#uso-básico)

La clase principal es `Document`, donde defines la estructura de tu reporte mediante filas (`Row`) y columnas (`Column`).

```
use hqsoft\reportkit\document\Document;

// Crear un documento nuevo
$doc = new Document();

// Agregar un título (fila de ancho completo)
$doc->row(function($row) {
    $row->col(24)->text('Mi Reporte Mensual')->align('center'); // 24 columnas es el ancho total por defecto
});

// Agregar encabezados
$doc->header(function($row) {
    $row->col(8)->text('Producto', bold: true);
    $row->col(8)->text('Cantidad', bold: true);
    $row->col(8)->text('Precio', bold: true);
});

// Agregar datos
$doc->row(function($row) {
    $row->col(8)->text('Laptop');
    $row->col(8)->text('10');
    $row->col(8)->text('1500.00');
});
```

Renderizado
-----------

[](#renderizado)

Una vez definido el documento, puedes usar diferentes "Renderers" para generar la salida deseada.

### HTML

[](#html)

Genera una tabla HTML con estilos en línea, ideal para vistas previas o correos.

```
use hqsoft\reportkit\renderers\html\HtmlRenderer;

$renderer = new HtmlRenderer();
echo $renderer->render($doc);
```

### Spreadsheet (Excel)

[](#spreadsheet-excel)

Genera un archivo `.xlsx` nativo. Requiere `phpoffice/phpspreadsheet`.

```
use hqsoft\reportkit\renderers\spreadsheet\SpreadsheetRenderer;

$renderer = new SpreadsheetRenderer();
$content = $renderer->render($doc); // Retorna el contenido binario del archivo
file_put_contents('reporte.xlsx', $content);
```

### CSV

[](#csv)

Exportación rápida a formato CSV.

```
use hqsoft\reportkit\renderers\csv\CsvRenderer;

$renderer = new CsvRenderer();
echo $renderer->render($doc);
```

Estilos (`CellStyle`)
---------------------

[](#estilos-cellstyle)

Puedes aplicar estilos detallados a tus celdas usando la clase `CellStyle`.

```
use hqsoft\reportkit\document\CellStyle;

$estiloResaltado = CellStyle::create()
    ->bold()
    ->background('#FFFF00')
    ->color('#FF0000')
    ->align('center')
    ->border('bottom', 'thick');

$doc->row(function($row) use ($estiloResaltado) {
    $row->col(12)->text('¡Importante!')->style($estiloResaltado);
});
```

### Capacidades de Estilo

[](#capacidades-de-estilo)

- **Texto**: `bold()`, `italic()`, `decoration('underline')`, `decoration('line-through')`
- **Fuente**: `fontFamily('Arial')`, `fontSize(14)`
- **Color**: `color('#333')`, `background('#f0f0f0')`
- **Alineación**: `align('center')`, `valign('middle')`
- **Bordes**: `border('all', 'thin', '#000')`
- **Espaciado**: `padding(10)` (se convierte a indentación en Excel)
- **Dimensiones**: `width(200)` (ancho de columna), `height(50)` (alto de fila)

Formatos de Datos
-----------------

[](#formatos-de-datos)

Puedes especificar el tipo de dato de una columna para asegurar que se formatee correctamente en Excel y HTML (ej. moneda, fechas).

```
use hqsoft\reportkit\document\Column;

$doc->row(function($row) {
    // Moneda
    $row->col(6)->text('12500.50')->format(Column::FORMAT_CURRENCY);

    // Porcentaje
    $row->col(6)->text('0.15')->format(Column::FORMAT_PERCENTAGE);

    // Fecha (entrada YYYY-MM-DD -> salida DD/MM/YYYY)
    $row->col(6)->text('2026-02-03')->format(Column::FORMAT_DATE);

    // Número con separadores
    $row->col(6)->text('1000000')->format(Column::FORMAT_NUMBER);
});
```

Estilos Nombrados
-----------------

[](#estilos-nombrados)

Para evitar repetir definiciones, puedes registrar estilos en el documento:

```
$doc->addStyle('titulo', CellStyle::create()->fontSize(20)->bold());

// Usar por nombre
$doc->row(function($row) {
    $row->col(24)->text('Mi Título')->style('titulo');
});
```

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance84

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~7 days

Total

4

Last Release

81d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9c5fbeb5f4ae9bd16df30b20e1bea1f8447d4c2ba8a8f796e07dbc3cce24bbb4?d=identicon)[hquijada](/maintainers/hquijada)

---

Top Contributors

[![hugoquijada](https://avatars.githubusercontent.com/u/2067204?v=4)](https://github.com/hugoquijada "hugoquijada (4 commits)")

---

Tags

phppdfexcelcsvlayoutreportes

### Embed Badge

![Health badge](/badges/hqsoft-reportkit/health.svg)

```
[![Health](https://phpackages.com/badges/hqsoft-reportkit/health.svg)](https://phpackages.com/packages/hqsoft-reportkit)
```

###  Alternatives

[maatwebsite/excel

Supercharged Excel exports and imports in Laravel

12.7k144.3M712](/packages/maatwebsite-excel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)