Helpers y Utilidades PHP

function getCachedData(string $sql, array $params = [], ?string $cacheKey = null, int $ttl = 86400): array

// En un Modelo o Controlador

public function obtenerMetricas()
{
    $sql = "SELECT
                p.productLine,
                SUM(od.quantityOrdered * od.priceEach) as Total
            FROM products p
            JOIN orderdetails od ON p.productCode = od.productCode
            GROUP BY p.productLine";

    // Cachear el resultado por 1 hora (3600 segundos) con una clave específica
    return getCachedData($sql, [], 'metricas_dashboard', 3600);
}

function queryToAssocArray(string $sql, string $index_key, string $column_key): array

// Obtener lista de categorías para un Dropdown
$sql = "SELECT id, nombre FROM categorias ORDER BY nombre ASC";
$opciones = queryToAssocArray($sql, 'id', 'nombre');

// Resultado: [1 => 'Electrónica', 2 => 'Hogar', ...]

function arrayToXLSXFile(
    array $results,
    string $fileName = 'temp.xlsx',
    bool $download = true,
    string $sheetName = 'Sheet1',
    array $options = []
): bool

namespace App\Controllers;

class Ventas extends BaseController
{
    public function exportarExcel()
    {
        helper('App\ThirdParty\Ragnos\Helpers\xlsxfiles_helper');

        $db = \Config\Database::connect();
        $ventas = $db->table('orders')
            ->select('orderNumber as Pedido, orderDate as Fecha, status as Estado, customerNumber as Cliente')
            ->get()
            ->getResultArray();

        // Descarga directa al usuario como 'reporte_pedidos.xlsx'
        arrayToXLSXFile($ventas, 'reporte_pedidos.xlsx');
    }
}

helper('App\ThirdParty\Ragnos\Helpers\xlsxfiles_helper');

$datos = [
    ['id' => 101, 'producto' => 'Monitor 4K', 'precio' => 450.00, 'stock' => 12, 'codigo' => '00123'],
    ['id' => 102, 'producto' => 'Teclado Mecánico', 'precio' => 95.50, 'stock' => 30, 'codigo' => '00456'],
];

$rutaDestino = WRITEPATH . 'uploads/reportes/inventario_' . date('Ymd_His') . '.xlsx';

// Pasar download = false guarda el archivo en la ruta indicada
if (arrayToXLSXFile($datos, $rutaDestino, false, 'Inventario')) {
    log_message('info', 'Archivo generado exitosamente en: ' . $rutaDestino);
}

helper('App\ThirdParty\Ragnos\Helpers\xlsxfiles_helper');

$clientes = [
    ['id' => 1, 'nombre' => 'Acme Corp', 'saldo' => 15200.75, 'activo' => true],
    ['id' => 2, 'nombre' => 'Globex Ltd', 'saldo' => -350.00, 'activo' => false],
];

arrayToXLSXFile($clientes, 'clientes_vip.xlsx', true, 'Clientes VIP', [
    'header_bg'     => '107C41', // Verde estilo Excel
    'header_color'  => 'FFFFFF', // Texto blanco
    'auto_filter'   => true,     // Filtros desplegables automáticos
    'freeze_header' => true,     // Fila de encabezado fija
    'custom_widths' => ['A' => 10, 'B' => 35, 'C' => 18, 'D' => 12]
]);

function htmlToXLSXFile(
    string $html,
    string $fileName = 'reporte.xlsx',
    bool $download = true,
    string $sheetName = 'Reporte',
    array $options = []
): bool

helper('App\ThirdParty\Ragnos\Helpers\xlsxfiles_helper');

$reporte = new \App\ThirdParty\Ragnos\Controllers\RSimpleLevelReport();
$reporte->quickSetup('Mejores Empleados', $datos, ['employeeNumber', 'Empleado', 'TotalVentasTrimestre'], ['Oficina' => ['label' => 'Oficina']]);

// Generar el HTML del reporte y convertirlo a un archivo .xlsx real
$html = $reporte->generate();
htmlToXLSXFile($html, 'mejores_empleados.xlsx');

$reporte = new \App\ThirdParty\Ragnos\Controllers\RSimpleLevelReport();
$reporte->quickSetup('Margen por Línea', $datos, ['productLine', 'MargenTotal']);

// Descarga directa en el navegador
$reporte->exportToXLSX('margen_por_linea.xlsx');

// O guardar en el servidor
$reporte->exportToXLSX(WRITEPATH . 'reportes/margen.xlsx', false);

http://localhost/ragnos/content/index.php/tienda/reportes/mejoresempleados?export=xlsx

function buildZipPackage(string $outputPath, array $entries): bool

function arrayToCSVFile(
    array $results,
    $fileName = 'temp.csv',
    $download = true,
    $delimiter = ',',
    $enclosure = '"',
    $escape = '\\'
): bool

helper('App\ThirdParty\Ragnos\Helpers\csvfiles_helper');

$productos = [
    ['id' => 1, 'nombre' => 'Laptop Gamer', 'precio' => 1200.00],
    ['id' => 2, 'nombre' => 'Mouse USB', 'precio' => 25.50],
];

// Descarga directa en formato CSV compatible con Excel
arrayToCSVFile($productos, 'catalogo_productos.csv');

function dbgConsola($data, string $label = 'dbgConsola')

$usuarios = $model->findAll();
dbgConsola($usuarios, 'Lista de Usuarios');
// Verifica la consola de Chrome/Firefox (F12)

function dbgDie($data, int $statusCode = 200): never

function currency(float|int $number, bool $includeSymbol = true): string

echo currency(1500.50); // Muestra "$1,500.50" (dependiendo de config)

function returnAsJSON($data, $statusCode = 200)

if (!$usuario) {
    returnAsJSON(['error' => 'Usuario no encontrado'], 404);
}
returnAsJSON($usuario);