JasperReports for PHP

Package to generate reports with JasperReports 6 library through JasperStarter v3 command-line tool.

##Install

Install Composer if you don't have it.

composer require lavela/phpjasper

Or in your 'composer.json' file add:

{
    "require": {
		"lavela/phpjasper": "1.0",
    }
}

And the just run:

composer install

and thats it.

##Introduction

This package aims to be a solution to compile and process JasperReports (.jrxml & .jasper files).

###Why?

Did you ever had to create a good looking Invoice with a lot of fields for your great web app?

I had to, and the solutions out there were not perfect. Generating *HTML* + *CSS* to make a *PDF*? WTF? That doesn't make any sense! :)

Then I found **JasperReports** the best open source solution for reporting.

###What can I do with this?

Well, everything. JasperReports is a powerful tool for **reporting** and **BI**.

**From their website:**

> The JasperReports Library is the world's most popular open source reporting engine. It is entirely written in Java and it is able to use data coming from any kind of data source and produce pixel-perfect documents that can be viewed, printed or exported in a variety of document formats including HTML, PDF, Excel, OpenOffice and Word.

I recommend using [Jaspersoft Studio](http://community.jaspersoft.com/project/jaspersoft-studio) to build your reports, connect it to your datasource (ex: MySQL), loop thru the results and output it to PDF, XLS, DOC, RTF, ODF, etc.

*Some examples of what you can do:*

* Invoices
* Reports
* Listings

##Examples

###The *Hello World* example.

Go to the examples directory in the root of the repository (`vendor/lavela/phpjasper/examples`).
Open the `hello_world.jrxml` file with iReport or with your favorite text editor and take a look at the source code.

#### Compiling

First we need to compile our `JRXML` file into a `JASPER` binary file. We just have to do this one time.

**Note:** You don't need to do this step if you are using *Jaspersoft Studio*. You can compile directly within the program.

```php

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

use JasperPHP\JasperPHP;

$input = __DIR__ . '/vendor/lavela/phpjasper/examples/hello_world.jrxml';	

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

This commando will compile the hello_world.jrxml source file to a hello_world.jasper file.

Note: If you are using Laravel 4 run php artisan tinker and copy & paste the command above.

####Processing

Now lets process the report that we compile before:

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

use JasperPHP\JasperPHP;

$input = __DIR__ . '/vendor/lavela/phpjasper/examples/hello_world.jasper';	
$output = __DIR__;	

$jasper = new JasperPHP;

$jasper->process(
	$input,
	$output,
	array("pdf", "rtf")
)->execute();

Now check the examples folder! :) Great right? You now have 2 files, hello_world.pdf and hello_world.rtf.

Check the API of the compile and process functions in the file src/JasperPHP/JasperPHP.php file.

####Listing Parameters

Querying the jasper file to examine parameters available in the given jasper report file:

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

use JasperPHP\JasperPHP;

$input = __DIR__ . '/vendor/lavela/phpjasper/examples/hello_world_params.jrxml';

$jasper = new JasperPHP;
$output = $jasper->list_parameters($input)->execute();

foreach($output as $parameter_description)
    print $parameter_description . '<pre>';

###Advanced example

We can also specify parameters for connecting to database:

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

use JasperPHP\JasperPHP;	

$input = __DIR__ . '/vendor/lavela/phpjasper/examples/hello_world.jrxml';	
$output = __DIR__;	

$jasper = new JasperPHP;
$jasper->process(
	$input,
	$output,
	array("pdf", "rtf"),
	array("php_version" => phpversion()),
	array(
		'driver' => 'postgres',
		'username' => 'vagrant',
		'host' => 'localhost',
		'database' => 'samples',
		'port' => '5433',
	)						
)->execute();

##Requirements

• Java JDK 1.8
• PHP exec() function
• [optional] Mysql Connector (if you want to use database)
• [optional] PostgreSQL Connector (if you want to use database)
• [optional] Jaspersoft Studio (to draw and compile your reports)

##Installation

###Java

Check if you already have Java installed:

$ java -version
java version "1.8.0_65"
Java(TM) SE Runtime Environment (build 1.8.0_65-b17)
Java HotSpot(TM)  Client VM (build 25.65-b01, mixed mode, sharing)

If you get:

command not found: java

Then install it with: (Ubuntu/Debian)

$ sudo apt-get install default-jdk

Now run the java -version again and check if the output is ok.

###Using in Laravel 5.1!

use JasperPHP\JasperPHP as JasperPHP;

Route::get('/', function () {
	
	$input = __DIR__ . '/vendor/lavela/phpjasper/examples/hello_world.jrxml';	
	$output = __DIR__;	
	
    $jasper = new JasperPHP;

	// Process a Jasper file to PDF and RTF (you can use directly the .jrxml)
    $jasper->process(
        $input,
        $output,
        array("pdf", "rtf")
    )->execute();

    return view('index');
});

###MySQL

We ship the [MySQL connector](http://dev.mysql.com/downloads/connector/j/) (v5.1.34) in the `/src/JasperStarter/jdbc/` directory.

###PostgreSQL

We ship the [PostgreSQL](https://jdbc.postgresql.org/) (v9.4-1203) in the `/src/JasperStarter/jdbc/` directory.

##Performance

Depends on the complexity, amount of data and the resources of your machine (let me know your use case).

I have a report that generates a *Invoice* with a DB connection, images and multiple pages and it takes about **3/4 seconds** to process. I suggest that you use a worker to generate the reports in the background.

##Thanks

Thanks to [Cenote GmbH](http://www.cenote.de/) for the [JasperStarter](http://jasperstarter.sourceforge.net/) tool.

##Questions?

Drop me a line on Skype [leandro.bittencourt16]
Drop me a line on Skype [danielrodrigueslima] 

##License

MIT