Download the PHP package geekcom/phpjasper without Composer
On this page you can find all versions of the php package geekcom/phpjasper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download geekcom/phpjasper
More information about geekcom/phpjasper
Files in geekcom/phpjasper
Rated 5.00 based on 1 reviews
Informations about the package phpjasper
PHPJasper
A PHP Report Generator
Docs
Please consider make a donation, support our activities
About
PHPJasper is the best solution to compile and process JasperReports (.jrxml & .jasper files) just using PHP, in short: to generate reports using PHP.
Our channel on discord
Notes:
- PHPJasper Can be used regardless of your PHP Framework
- For PHP versions less than 7.0 see: v1.16
- Here are several examples of how to use PHPJasper
Why PHPJasper?
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? 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.
It is recommended using Jaspersoft Studio to build your reports, connect it to your datasource (ex: MySQL, POSTGRES), loop thru the results and output it to PDF, XLS, DOC, RTF, ODF, etc.
Some examples of what you can do:
- Invoices
- Reports
- Listings
Requirements
- PHP 7.2 or above
- Java JDK 1.8
Optional
- Any
jdbc
drivers to generate reports from a database (MySQL, PostgreSQL, MSSQL...), must be copied to a folderbin/jasperstarter/jdbc
- We ship the PostgreSQL (42.2.9) in the
bin/jasperstarter/jdbc
directory. - We ship the MySQL connector (v5.1.48) in the
bin/jasperstarter/jdbc
directory. - Microsoft JDBC Drivers SQL Server .
- Jaspersoft Studio (to draw your reports).
Installation
Install Composer if you don't have it.
Or in your file'composer.json' add:
And the just run:
composer install
and thats it.
PHPJasper with Docker
With Docker CE and docker-compose installed just run:
docker-compose up -d
docker exec -it phpjasper composer install
To execute tests:
docker exec -it phpjasper sudo composer test
ordocker exec -it phpjasper sudo composer testdox
To see coverage manually of tests, execute the file: tests/log/report/index.html
Help us writing new tests, make a fork :)
Examples
The Hello World example.
Go to the examples directory in the root of the repository (vendor/geekcom/phpjasper/examples
).
Open the hello_world.jrxml
file with Jaspersoft Studio 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 1: You don't need to do this step if you are using Jaspersoft Studio. You can compile directly within the program.
This commando will compile the hello_world.jrxml
source file to a hello_world.jasper
file.
Processing
Now lets process the report that we compile before:
Now check the examples folder! :) Great right? You now have 2 files, hello_world.pdf
and hello_world.rtf
.
Check the methods compile
and process
in src/JasperPHP.php
for more details
Listing Parameters
Querying the jasper file to examine parameters available in the given jasper report file:
Using database to generate reports
We can also specify parameters for connecting to database:
Note 2:
For a complete list of locales see Supported Locales
Using MSSQL DataBase
Reports from a XML
Reports from a JSON
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
Cenote GmbH for the JasperStarter tool.
JetBrains for the PhpStorm and all great tools.
Questions?
Open a new Issue or look for a closed issue
License
MIT
Contribute
Contributors ✨
Thanks goes to these wonderful people (emoji key):
Daniel Rodrigues 💻 |
Leandro Bitencourt 💻 |
Vitor Mattos 💻 |
Rafael Queiroz 💻 |
Dave Bould 💻 |
ThiagoAlves31 💻 |
Jadson Ribeiro 💻 |
Fernando Boaglio 💻 |
Rahul Jain 💻 |
Luiz Eduardo 💻 |
David Ribeiro 💻 |
James Allen 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!