Merge branch 'master' of https://github.com/lavela/phpjasper

README.md

@@ -1,4 +1,4 @@
-# JasperReports for PHP v1.0
+# JasperReports for PHP and Laravel Framework
 
 [![Latest Stable Version](https://poser.pugx.org/lavela/phpjasper/v/stable)](https://packagist.org/packages/lavela/phpjasper)  [![Latest Unstable Version](https://poser.pugx.org/lavela/phpjasper/v/unstable)](https://packagist.org/packages/lavela/phpjasper) [![License](https://poser.pugx.org/lavela/phpjasper/license)](https://packagist.org/packages/lavela/phpjasper) [![Total Downloads](https://poser.pugx.org/lavela/phpjasper/downloads)](https://packagist.org/packages/lavela/phpjasper)
 
@@ -161,7 +161,7 @@ foreach($output as $parameter_description)
     print $parameter_description . '<pre>';
 ```
 
-###Advanced example
+###Advanced example - using a database
 
 We can also specify parameters for connecting to database:
 
@@ -190,7 +190,6 @@ $jasper->process(
 )->execute();
 ```
 
-
 ###Using JasperPHP with Laravel 5.2!
 
 1. Install [Composer](http://getcomposer.org) if you don't have it.
@@ -245,6 +244,57 @@ Route::get('/reports', function () {
 In this example we generate reports pdf, rtf and xml.
 
 
+###Additional Information - Reports from a xml in Laravel 5.2
+
+See how easy it is to generate a report with a source an xml file:
+
+```php
+
+use JasperPHP\JasperPHP;
+
+public function xmlToPdf()
+    {
+        $output = public_path() . '/report/'.time().'_CancelAck';
+        $output = public_path() . '/report/'.time().'_CancelAck';
+        $ext = "pdf";
+        $data_file = public_path() . '/report/CancelAck.xml';
+        $driver = 'xml';
+        $xml_xpath = '/CancelResponse/CancelResult/ID';
+
+        \JasperPHP::process(
+            public_path() . '/report/CancelAck.jrxml', 
+            $output, 
+            array($ext),
+            array(),
+            array('data_file' => $data_file, 'driver' => $driver, 'xml_xpath' => $xml_xpath),                   
+            false,
+            false
+        )->execute();
+
+        header('Content-Description: File Transfer');
+        header('Content-Type: application/octet-stream');
+        header('Content-Disposition: attachment; filename='.time().'_CancelAck.'.$ext);
+        header('Content-Transfer-Encoding: binary');
+        header('Expires: 0');
+        header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
+        header('Content-Length: ' . filesize($output.'.'.$ext));
+        flush();
+        readfile($output.'.'.$ext);
+        unlink($output.'.'.$ext);
+
+    }
+```
+**Note:** 
+
+To use the example above you must copy the sample files located at:
+
+**\vendor\lavela\phpjasper\src\JasperStarter\examples\CancelAck.jrxml** 
+and
+**\vendor\lavela\phpjasper\src\JasperStarter\examples\CancelAck.xml** 
+to folder:
+**\public\report** 
+
+
 ###MySQL
 
 We ship the [MySQL connector](http://dev.mysql.com/downloads/connector/j/) (v5.1.34) in the `/src/JasperStarter/jdbc/` directory.