Requerimientos mínimos para Instalar JasperPHP

• Java JDK 1.6 ó superior.
• Función PHP exec() habilitada.

Instalación de JasperPHP en Laravel 5

Para usar este paquete en Laravel 5 lo primero que debemos es tener instalado Composer. Luego ingresar en el proyecto desde la linea de comandos y ejecutar el siguiente comando:

composer require cossou/jasperphp

Luego actualizamos para que se descargue (a mi me tardó un poco en descargar, pero mi internet es de -0kb así que no creo que a ustedes les pase xD):

composer update

¡Y listo! Con eso lo tendrás instalado el paquete.

Uso de JasperPHP en Laravel 5

Si nunca han usado JasperReports pueden ver ésta entrada donde les muestro como crear un reporte en JasperReports desde cero. Les recomiendo Jaspersoft Studio para tal fin. En ésta entrada para demostrar el uso de JasperPHP vamos a utilizar el reporte de ejemplo que viene con el paquete y se encuentra en la ruta vendor/cossou/jasperphp/examples/hello_world.jrxml.

Inicialmente tienes que añadir la librería donde la vas a usar (para este ejemplo en routes.php):

use JasperPHP\JasperPHP as JasperPHP; 

La clase nos provee un método para compilar los reportes llamado compile() y se usa de la siguiente manera (no es necesario este paso si lo hace antes desde un programa como Jaspersoft Studio):

Route::get('/compilar', function () {
    // Crear el objeto JasperPHP
    $jasper = new JasperPHP;
    
    // Compilar el reporte para generar .jasper
    $jasper->compile(base_path() .
    '/vendor/cossou/jasperphp/examples/hello_world.jrxml')->execute();
   
    return view('welcome');
});

Una vez que tengas el archivo .jasper generado puedes ejecutar tu reporte:

Route::get('/reporte', function () {
    // Crear el objeto JasperPHP
    $jasper = new JasperPHP;
    
    // Generar el Reporte
    $jasper->process(
        // Ruta y nombre de archivo de entrada del reporte
        base_path() .
        '/vendor/cossou/jasperphp/examples/hello_world.jasper', 
        false, // Ruta y nombre de archivo de salida del reporte (sin extensión)
        array('pdf', 'rtf'), // Formatos de salida del reporte
        array('php_version' => phpversion()) // Parámetros del reporte
    )->execute();
   
    return view('welcome');
});

Depuración de errores con JasperPHP

Uno de los errores frecuentes al usar la librería es que no tengamos permisos suficientes para escribir en el directorio donde se genera el reporte. Asegúrese de tener permisos de escritura en la ruta vendor/cossou/jasperphp/examples/.

De igual forma luego de seguir todos los pasos al pie de la letra puede ser que veas el siguiente error:

La clase JasperPHP nos provee una función llamada output() que nos retorna el comando que se esta tratando de ejecutar al generar el reporte. Para poder depurar este comando directamente desde el código lo puedes hacer copiando el siguiente fragmento justo debajo de la generación de tu reporte:

    // Depuración de errores
    exec($jasper->output().' 2>&1', $output);
    print_r($output);

De esta manera podrás visualizar el error específico que te está ocurriendo.

La verdad que este paquete me ha ahorrado mucho tiempo que antes gastaba construyendo reportes desde PHP. Diría que es unir lo mejor de dos mundos. Espero que también te pueda servir. Cualquier duda o aporte te invito a que la dejes en los comentarios :).