PHPackages                             pingslayer/laravel-go-reports - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. pingslayer/laravel-go-reports

ActiveLibrary[Database & ORM](/categories/database)

pingslayer/laravel-go-reports
=============================

High-performance Laravel reporting engine using an embedded Go sidecar for streaming millions of rows with zero memory bloat.

v1.0.0(1mo ago)01MITPHPPHP ^8.1

Since Apr 17Pushed 1mo agoCompare

[ Source](https://github.com/pingslayer/laravel-go-reports)[ Packagist](https://packagist.org/packages/pingslayer/laravel-go-reports)[ RSS](/packages/pingslayer-laravel-go-reports/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

📦 Laravel Go Reports (The Eloquent Tunnel)
==========================================

[](#-laravel-go-reports-the-eloquent-tunnel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a75fa4fcf82943d039123f66162cd84dd819f0974caf7c8750a4e232138d1d76/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70696e67736c617965722f6c61726176656c2d676f2d7265706f7274732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pingslayer/laravel-go-reports)[![Total Downloads](https://camo.githubusercontent.com/eee0139b003521f88eb6a329bc022fd348e1c476fc368a985c9eba1833f7469d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f70696e67736c617965722f6c61726176656c2d676f2d7265706f7274732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pingslayer/laravel-go-reports)[![License](https://camo.githubusercontent.com/d9002147f32fbdce2dcdfcc93ffe5e4c6ed6e4014f244262d56b5506c9a471ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f70696e67736c617965722f6c61726176656c2d676f2d7265706f7274732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pingslayer/laravel-go-reports)

A professional-grade reporting package for Laravel that "Tunnels" complex Eloquent queries to an embedded Go service for high-speed JSON streaming.

---

🚀 Installation
--------------

[](#-installation)

1. **Require the package**:

```
composer require pingslayer/laravel-go-reports
```

2. **Publish the configuration**:

```
php artisan vendor:publish --provider="LaravelGoReports\LaravelGoReportsServiceProvider" --tag="config"
```

---

🏗 Requirements
--------------

[](#-requirements)

- **PHP**: ^8.1
- **Laravel**: ^10.0 | ^11.0 | ^12.0 | ^13.0
- **Database**: **MySQL ONLY** (MariaDB supported)

---

1. **Auto-Start**: When Laravel boots, it detects your OS and launches the bundled Go binary in the background.
2. **Auto-Init**: It sends your database credentials to the Go engine once to establish a connection pool.
3. **Tunneling**: When you call `JSONReport::fromEloquent($query)`, the package extracts the raw SQL and Bindings and sends them to Go for execution and streaming.

---

📖 Usage
-------

[](#-usage)

### Using the Eloquent Tunnel

[](#using-the-eloquent-tunnel)

You can directly pipe either a **Laravel Model** or the **DB Facade** (Query Builder) into the engine. The Tunnel automatically extracts the underlying SQL and Bindings.

#### Option A: Using an Eloquent Model

[](#option-a-using-an-eloquent-model)

```
use LaravelGoReports\JSONReport;
use App\Models\User;

return JSONReport::fromEloquent(
    User::join('orders', 'users.id', '=', 'orders.user_id')
        ->where('orders.status', 'paid')
);
```

#### Option B: Using the DB Facade

[](#option-b-using-the-db-facade)

```
use LaravelGoReports\JSONReport;
use Illuminate\Support\Facades\DB;

return JSONReport::fromEloquent(
    DB::table('reports')->where('amount', '>', 500)
);
```

### Advanced: Passing Raw SQL & Bindings

[](#advanced-passing-raw-sql--bindings)

```
use LaravelGoReports\JSONReport;

return JSONReport::generate([
    'sql' => 'SELECT * FROM reports WHERE amount > ?',
    'bindings' => [500]
]);
```

---

🛠 Configuration (`config/report.php`)
-------------------------------------

[](#-configuration-configreportphp)

```
return [
    'auto_start' => env('REPORT_ENGINE_AUTO_START', true),
    'port'       => env('REPORT_ENGINE_PORT', 8081),
    'secret_key' => env('REPORT_ENGINE_SECRET', 'laravel-go-sync'),
];
```

---

🛡 Security
----------

[](#-security)

- The Go engine only permits `SELECT` statements.
- Any destructive SQL (DELETE, DROP, UPDATE) is strictly blocked by a regex validator.
- Database credentials are kept secure and shared with Go only during core initialization.

---

📄 License
---------

[](#-license)

MIT

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance89

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

53d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dab8886671f9ba43d1c51ea746ebf752db35c2a7dd244b731190cbcf95847983?d=identicon)[pingslayer](/maintainers/pingslayer)

---

Top Contributors

[![pingslayer](https://avatars.githubusercontent.com/u/28712537?v=4)](https://github.com/pingslayer "pingslayer (3 commits)")

---

Tags

jsonlaravelperformancemysqlstreamingreportsgo

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pingslayer-laravel-go-reports/health.svg)

```
[![Health](https://phpackages.com/badges/pingslayer-laravel-go-reports/health.svg)](https://phpackages.com/packages/pingslayer-laravel-go-reports)
```

###  Alternatives

[kirschbaum-development/eloquent-power-joins

The Laravel magic applied to joins.

1.6k29.9M42](/packages/kirschbaum-development-eloquent-power-joins)[spatie/laravel-health

Monitor the health of a Laravel application

87311.3M149](/packages/spatie-laravel-health)[itpathsolutions/dbstan

Database Standardization and Analysis Tool for Laravel

442.1k](/packages/itpathsolutions-dbstan)[sarfraznawaz2005/indexer

Laravel package to monitor SELECT queries and offer best possible INDEX fields.

562.7k](/packages/sarfraznawaz2005-indexer)[lemaur/eloquent-publishing

207.8k1](/packages/lemaur-eloquent-publishing)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)