Need help with php-reports?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.


A PHP framework for displaying reports from any data source, including SQL and MongoDB

447 Stars 228 Forks GNU Lesser General Public License v3.0 327 Commits 141 Opened issues

Services available

Need anything else?

Php Reports

A reporting framework for managing and displaying nice looking, exportable reports from any data source, including SQL and MongoDB.

Major features include:

  • Display a report from any data source that can output tabular data (SQL, MongoDB, PHP, etc.)
  • Output reports in HTML, XML, CSV, JSON, or your own custom format
  • Add customizable parameters to a report (e.g. start date and end date)
  • Add graphs and charts with the Google Data Visualization API
  • Supports multiple database environments (e.g. Production, Staging, and Dev)
  • Fully extendable and customizable

For installation instructions and documentation, check out

If you have a question, post on the official forum -

Basic Introduction

Reports are organized and grouped in directories. Each report is it's own file.

A report consists of headers containing meta-data (e.g. name and description) and the actual report (SQL queries, javascript, or PHP code).

All reports return rows of data which are then displayed in a sortable/searchable HTML table.

Reports can be exported to a number of formats including CSV, XLS, JSON, and XML.

The Php Reports framework ties together all these different report types, output formats, and meta-data into a consistent interface.

Example Reports

Here's an example SQL report:

-- Products That Cost At Least $X
-- VARIABLE: {"name": "min_price"}

SELECT Name, Price FROM Products WHERE Price > "{{min_price}}"

The set of SQL comments at the top are the report headers. The first row is always the report name.


header tells the report framework to prompt the user for a value before running the report. Once provided it will be passed into the report body ("{{min_price}}" in this example) and executed.

Here's a MongoDB report:

// List of All Foods
// OPTIONS: {"mongodatabase": "MyDatabase"}
//   "name": "include_inactive",
//   "display": "Include Inactive?",
//   "type": "select",
//   "options": ["yes","no"]
// }

var query = {'type': 'food'};

if(include_inactive == 'no') { query.status = 'active'; }

var result = db.Products.find(query);


As you can see, the structure is very similar. MongoDB reports use javascript style comments for the headers, but everything else remains the same.

You can populate the 'db' variable by specifying the "mongodatabase" option.

Here's a PHP Report:

if($count > 100 || $count < 1) throw new Exception("Count must be between 1 and 100");

$charges = Stripe_Charge::all(array("count" => $count));

$rows = array(); foreach($charges as $charge) { $rows[] = array( 'Charge Id'=>$charge->id, 'Amount'=>number_format($charge->amount/100,2), 'Date'=>date('Y-m-d',$charge->created) ); }

echo json_encode($rows); ?>

Again, the header format is very similar.

The INCLUDE header includes another report within the running one. Below is example content of /stripe.php:

//include the Stripe API client

//set the Stripe api key Stripe::setApiKey("123456"); ?>

Hopefully, you can begin to see the power of Php Reports.

For full documentation and information on getting started, check out

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.