PHPackages                             fizteqsolutions/fizwatch-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. [Logging & Monitoring](/categories/logging)
4. /
5. fizteqsolutions/fizwatch-laravel

ActiveLibrary[Logging & Monitoring](/categories/logging)

fizteqsolutions/fizwatch-laravel
================================

Laravel client package for FizWatch error tracking

v1.4.0(2mo ago)11.3k↓69.1%MITPHPPHP ^8.0

Since Feb 27Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/fizteqsolutions/fizwatch-laravel)[ Packagist](https://packagist.org/packages/fizteqsolutions/fizwatch-laravel)[ RSS](/packages/fizteqsolutions-fizwatch-laravel/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (12)Versions (7)Used By (0)

FizWatch Laravel
================

[](#fizwatch-laravel)

Laravel client package for [FizWatch](https://github.com/fizteqsolutions/fizwatch) error tracking. Captures exceptions and sends them to your FizWatch instance automatically.

Supports Laravel 8 through 13.

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

[](#installation)

```
composer require fizteqsolutions/fizwatch-laravel
```

The service provider is auto-discovered — no manual registration needed.

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

[](#configuration)

Add these two variables to your `.env` file:

```
FIZWATCH_URL=https://your-fizwatch-instance.com
FIZWATCH_KEY=fiz_your_project_api_key
```

Both are required. If either is missing, the package does nothing — no HTTP calls, no logs, no interference with your application.

### Publishing the config (optional)

[](#publishing-the-config-optional)

```
php artisan vendor:publish --tag=fizwatch-config
```

This publishes `config/fizwatch.php` where you can customize:

- **`timeout`** — HTTP timeout in seconds (default: 5)
- **`sensitive_fields`** — Request body/query fields replaced with `[Filtered]` before sending (default: `_token`, `password`, `password_confirmation`, `credit_card`, `ssn`, `secret`)
- **`sensitive_headers`** — HTTP headers replaced with `[Filtered]` (default: `authorization`, `cookie`, `set-cookie`)
- **`ignored_exceptions`** — Exception classes that should not be reported to FizWatch (default: none)

### Filtering exceptions

[](#filtering-exceptions)

If certain exceptions are too noisy (e.g., OAuth errors from mobile apps), you can ignore them entirely. First publish the config, then add exception classes to the `ignored_exceptions` array:

```
// config/fizwatch.php

'ignored_exceptions' => [
    \League\OAuth2\Server\Exception\OAuthServerException::class,
    \Symfony\Component\HttpKernel\Exception\NotFoundHttpException::class,
],
```

Uses `instanceof` matching — adding a parent class also ignores all of its subclasses.

Testing your integration
------------------------

[](#testing-your-integration)

```
php artisan fizwatch:test
```

This sends a test exception to your FizWatch instance. You should see it appear on your dashboard immediately.

How it works
------------

[](#how-it-works)

The package hooks into Laravel's exception handler via `reportable()`. When an exception occurs:

1. If `FIZWATCH_URL` or `FIZWATCH_KEY` is not set — does nothing
2. Builds a payload with the exception details, stacktrace, environment info, and HTTP request data
3. Sends it to the FizWatch API
4. If anything fails — fails silently, no logs, no side effects

Normal Laravel error logging is never affected. The package works alongside other error tracking tools (like Sentry) without conflict.

What gets sent
--------------

[](#what-gets-sent)

Each error report includes:

- **Exception** — class, message, file, line
- **Stacktrace** — up to 50 frames
- **Environment** — PHP version, server OS, Laravel environment
- **HTTP Request** (when available) — method, URL, headers, body, query params (with sensitive fields filtered)

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance86

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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

Every ~10 days

Total

6

Last Release

68d ago

### Community

Maintainers

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

---

Top Contributors

[![neamtua](https://avatars.githubusercontent.com/u/1029457?v=4)](https://github.com/neamtua "neamtua (14 commits)")

---

Tags

laravelexception handlererror-trackingfizwatch

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k51.0M7.6k](/packages/larastan-larastan)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

76518.2M120](/packages/laravel-mcp)[spatie/laravel-health

Monitor the health of a Laravel application

87411.3M153](/packages/spatie-laravel-health)[laravel/ai

The official AI SDK for Laravel.

9782.1M162](/packages/laravel-ai)[spatie/laravel-export

Create a static site bundle from a Laravel app

672139.5k6](/packages/spatie-laravel-export)

PHPackages © 2026

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