PHPackages                             zappem/zappem-laravel - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. zappem/zappem-laravel

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

zappem/zappem-laravel
=====================

Connect your Laravel application to Zappem

v1.0.5(9y ago)0116MITPHP

Since Nov 21Pushed 9y agoCompare

[ Source](https://github.com/danjohnson95/zappem-laravel)[ Packagist](https://packagist.org/packages/zappem/zappem-laravel)[ Docs](https://github.com/danjohnson95/zappem-laravel)[ RSS](/packages/zappem-zappem-laravel/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (3)DependenciesVersions (7)Used By (0)

zappem-laravel
==============

[](#zappem-laravel)

Connect your Laravel application to Zappem

Installation
------------

[](#installation)

```
$ composer require zappem/zappem-laravel

```

Then add the following line to your `ServiceProviders` array in `config/app.php`:

```
Zappem\ZappemLaravel\ServiceProvider::class

```

Configuration
-------------

[](#configuration)

Now you'll need to configure Zappem. You can define your configuration in your env file.

The env variables are:

```
ZAPPEM_URL=http://localhost:3000
ZAPPEM_PROJECT=123456
ZAPPEM_ENABLE=true

```

- ZAPPEM\_URL - The full URL (including port number) where Zappem is running.
- ZAPPEM\_PROJECT - The project ID for this application. You can find this on Zappem.
- ZAPPEM\_ENABLE - true/false

Alternatively you can define these values in a configuration file.

```
$ php artisan vendor:publish

```

The configuration file will be located in `/config/zappem.php`.

Note: You may need to rebuild the cache when changing config variables in Laravel

```
$ php artisan config:cache

```

Usage
-----

[](#usage)

Your application should report errors to Zappem in the `report()` function in `app/Exceptions/Handler.php`.

Here's an example of how it should look:

```
public function report(Exception $e){
    if(Config::get('services.zappem.zappem_enable')) \Zappem::exception($e)->send();
}

```

### Passing through a user

[](#passing-through-a-user)

If your application requires users to log in, you can send the currently logged in user to Zappem. This will then display in Zappem when viewing the exception.

```
public function report(Exception $e){
    if(Config::get('services.zappem.zappem_enable')) \Zappem::exception($e)->user(Auth::user()->id)->send();
}

```

The `user()` function currently accepts a string or an integer. You should pass through a unique idenfitier of this user. This could be an ID, Email Address etc.

### Getting back an error code

[](#getting-back-an-error-code)

Whenever you send an exception to Zappem, we'll send you back a short unique numeric code. It may be useful to display this to your users. On Zappem you can search for the code and jump to the exception straight away.

The error code will be contained in the return of sending the exception to us. Here's an example:

```
$Zappem = \Zappem::exception($e)
->user(Auth::user()->id, Auth::user()->name, Auth::user()->email)
->send();

if($Zappem->success){
  return "Sorry, an error occurred. Please contact development quoting this code: ".$Zappem->code;
}

```

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity67

Established project with proven stability

 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

Every ~0 days

Total

5

Last Release

3505d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6871504?v=4)[Dan](/maintainers/danjohnson95)[@danjohnson95](https://github.com/danjohnson95)

---

Top Contributors

[![danjohnson95](https://avatars.githubusercontent.com/u/6871504?v=4)](https://github.com/danjohnson95 "danjohnson95 (23 commits)")

---

Tags

trackingbugzappem

### Embed Badge

![Health badge](/badges/zappem-zappem-laravel/health.svg)

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

###  Alternatives

[zumba/amplitude-php

PHP SDK for Amplitude

4010.1M5](/packages/zumba-amplitude-php)[kyranb/footprints

A simple registration attribution tracking solution for Laravel (UTM Parameters and Referrers)

206366.0k](/packages/kyranb-footprints)[hcodes/server_yametrika

Server-side tracking of visitors using Yandex.Metrica

7521.0k](/packages/hcodes-server-yametrika)[cornford/googlitics

An easy way to integrate Google Analytics with Laravel.

3210.2k](/packages/cornford-googlitics)[axllent/silverstripe-analytics-js

Google Universal Analytics tracking code for Silverstripe

1621.3k](/packages/axllent-silverstripe-analytics-js)[gosquared/php-sdk

1023.6k](/packages/gosquared-php-sdk)

PHPackages © 2026

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