Instalación de Laravel 7

Para el tutorial, he descargado la versión 7.14.1 de Laravel siguiendo las indicaciones de su documentación oficial.

Para la instalación del Laravel y del paquete que vamos usar requerimos tener instalado Composer.

Requerimientos mínimos para Instalar PHPJasper

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

Instalación de PHPJasper en Laravel 7

Ingresar en el proyecto desde la línea de comandos y ejecutar el siguiente comando:

composer require geekcom/phpjasper

Luego actualizamos para que se descargue:

composer update

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

Uso de PHPJasper en Laravel 7

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 esta entrada para demostrar el uso de PHPJasper vamos a utilizar los reportes de ejemplo hello_world.jrxml y hello_world_params.jrxml que vienen con el paquete y se encuentran en la ruta vendor/geekcom/phpjasper/examples/.

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

use PHPJasper\PHPJasper; 

La clase PHPJasper 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('/compilarReporte', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world.jrxml';

    $jasper = new PHPJasper;
    $jasper->compile($input)->execute();

    return response()->json([
        'status' => 'ok',
        'msj' => '¡Reporte compilado!'
    ]);
});

Si todo sale bien al ingresar desde el navegador a la ruta del proyecto /compilarReporte debe recibir un json como respuesta:

{
  "status": "ok",
  "msj": "¡Reporte compilado!"
}

Esto va a crear un nuevo archivo en la ruta vendor/geekcom/phpjasper/examples. Una vez que tengas el archivo .jasper generado puedes ejecutar el reporte desde la ruta /reporte:

Route::get('/reporte', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world.jasper';
    $output = base_path() .
    '/vendor/geekcom/phpjasper/examples';
    $options = [
        'format' => ['pdf']
    ];

    $jasper = new PHPJasper;

    $jasper->process(
        $input,
        $output,
        $options
    )->execute();

    $pathToFile = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world.pdf';
    return response()->file($pathToFile);
});

Se debe ver en el navegador el resultado:

Otra de las posibilidades que nos da el paquete es enviar parámetros al reporte, para listar los parámetros que requiere el reporte vamos a usar lo siguiente:

Route::get('/listarParametrosReporte', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.jrxml';

    $jasper = new PHPJasper;
    $output = $jasper->listParameters($input)->execute();

    return response()->json([
        'status' => 'ok',
        'parms' => $output
    ]);
});

Si entramos a la ruta /listarParametrosReporte vamos obtener algo como esto:

{
  "status": "ok",
  "parms": [
    "P myString java.lang.String",
    "P myInt    java.lang.Integer",
    "P myDate   java.util.Date",
    "P myImage  java.awt.Image    This is the description of parameter myImage"
  ]
}

Luego de manera similar al primer ejemplo vamos a crear una ruta para compilar el reporte con parámetros:

Route::get('/compilarReporteParametros', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.jrxml';

    $jasper = new PHPJasper;
    $jasper->compile($input)->execute();

    return response()->json([
        'status' => 'ok',
        'msj' => '¡Reporte compilado!'
    ]);
});

Si todo sale bien al ingresar desde el navegador a la ruta del proyecto /compilarReporteParametros debe recibir un json como respuesta:

{
  "status": "ok",
  "msj": "¡Reporte compilado!"
}

Para ejecutar el reporte con parámetros necesitamos una imagen en el directorio vendor/geekcom/phpjasper/examples/ en este caso estoy usando el siguiente logo de JasperReports:

Luego defino una ruta para ejecutar el reporte con parámetros como sigue:

Route::get('/reporteParametros', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.jasper';
    $output = base_path() .
    '/vendor/geekcom/phpjasper/examples';
    $options = [
        'format' => ['pdf'],
        'params' => [
            'myInt' => 7,
            'myDate' => date('y-m-d'),
            'myImage' => base_path() .
            '/vendor/geekcom/phpjasper/examples/jasperreports_logo.png',
            'myString' => 'Hola Mundo!'
        ]
    ];

    $jasper = new PHPJasper;

    $jasper->process(
        $input,
        $output,
        $options
    )->execute();

    $pathToFile = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.pdf';
    return response()->file($pathToFile);
});

El resultado será el como sigue:

Depuración de errores con PHPJasper

Luego de seguir todos los pasos al pie de la letra puede ser que veas el siguiente error:

La clase PHPJasper 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 reemplazando el comando execute con output:

    // Depuración de errores
    dd($jasper->process(
        $input,
        $output,
        $options
    )->output());

De esta manera podrás visualizar el comando que se trata de ejecutar. Solo es cuestión de copiarlo en la consola y ver el verdadero error que te ocurre.

Errores frecuentes con PHPJasper

• Falta de permisos de escritura en la ruta vendor/geekcom/phpjasper/examples/.
• El reporte de ejemplo usa la fuente Arial, es posible que si está en linux veas el siguiente error:

  net.sf.jasperreports.engine.util.JRFontNotFoundException: Font 'Arial' is not available to the JVM. See the Javadoc for more details. at net.sf.jasperreports.engine.util.JRFontUtil.checkAwtFont(JRFontUtil.java:321) at net.sf.jasperreports.engine.util.JRStyledText.getAwtAttributedString(JRStyledText.java:226)

  La solución detallada la encuentras aquí:

  sudo apt-get install ttf-mscorefonts-installer
  sudo cp -r /usr/share/fonts/truetype/msttcorefonts $JAVA_HOME/lib/fonts
      

Espero que sea de utilidad. Cualquier duda o aporte te invito a que la dejes en los comentarios :).