PHPackages                             cotiga/spam-guard-cs - 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. [Security](/categories/security)
4. /
5. cotiga/spam-guard-cs

ActiveLibrary[Security](/categories/security)

cotiga/spam-guard-cs
====================

Antispam formulaires, ban IP et journalisation d'erreurs HTTP pour le socle CotiCMS Core/Starter (Laravel 13 + Filament v5). Admin Filament intégré.

011PHP

Since Jul 14Pushed 1w agoCompare

[ Source](https://github.com/cotiga/spam-guard-cs)[ Packagist](https://packagist.org/packages/cotiga/spam-guard-cs)[ RSS](/packages/cotiga-spam-guard-cs/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

cotiga/spam-guard-cs
====================

[](#cotigaspam-guard-cs)

Antispam, ban IP et journalisation d'erreurs HTTP pour le socle **CotiCMS Core/Starter** — Laravel 13 + Filament v5, **admin Filament intégré**.

> Pour les installs legacy (Laravel 10/11/12 + STRAdmin/Voyager), voir [`cotiga/spam-guard-lr10`](https://github.com/cotiga/spam-guard-lr10).

- Rate limiting par IP
- Filtrage email : TLD, domaine, patterns suspects
- Détection nom avec chiffres / charabia, message générique de bot, message charabia
- Validation téléphone (format date, lettres, longueur hors norme)
- Géoblocage (via `stevebauman/location`)
- Log et ban automatique des IP abusives
- Email d'alerte sur erreurs récurrentes
- **Administration Filament** : refus antispam, IP bannies, erreurs HTTP, URLs ignorées

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

[](#installation)

```
composer require cotiga/spam-guard-cs
php artisan migrate
```

### 1. Activer l'admin Filament

[](#1-activer-ladmin-filament)

Dans le `AdminPanelProvider`, enregistrer le plugin (auto-détecté s'il est présent) :

```
use Cotiga\SpamGuard\SpamGuardPlugin;

->when(class_exists(SpamGuardPlugin::class), fn ($panel) => $panel->plugin(SpamGuardPlugin::make()))
```

Les 4 Resources `SG*` apparaissent alors dans le groupe **Configuration** du panel.

### 2. Brancher la journalisation d'erreurs (optionnel)

[](#2-brancher-la-journalisation-derreurs-optionnel)

Dans `bootstrap/app.php` — c'est l'équivalent Laravel 13 de l'ancien `app/Exceptions/Handler.php` :

```
->withExceptions(function (Illuminate\Foundation\Configuration\Exceptions $exceptions) {
    \Cotiga\SpamGuard\SpamGuardExceptions::register($exceptions);
})
```

Sans ce branchement, l'antispam des formulaires (`FormSpamGuard`) et l'admin fonctionnent ; seules la journalisation HTTP et le ban automatique sur erreurs récurrentes sont désactivés.

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

[](#configuration)

```
php artisan vendor:publish --tag=spam-guard-config
```

`config/spam-guard.php` : tous les seuils, listes de pays, TLD, patterns, etc.

FormSpamGuard dans les contrôleurs
----------------------------------

[](#formspamguard-dans-les-contrôleurs)

```
use Cotiga\SpamGuard\Services\FormSpamGuard;

class ContactController extends Controller
{
    public function store(ContactRequest $request, FormSpamGuard $guard)
    {
        if ($guard->isSpam($request->mel, $request->ip(), $request->only(['nom', 'tel', 'msg']))) {
            return $this->fakeSuccessResponse($request);
        }
        // traitement normal...
    }
}
```

Vues d'erreur
-------------

[](#vues-derreur)

Le package fournit `spam-guard::errors.generic` (HTML autonome, sans layout). Priorité de résolution : `errors.{status}` → `errors.generic` (de l'app) → `spam-guard::errors.generic`. Pour personnaliser :

```
php artisan vendor:publish --tag=spam-guard-views
```

Tables créées
-------------

[](#tables-créées)

TableDescription`spam_guard_banned_ips`IP bannies automatiquement`spam_guard_errors`Erreurs HTTP loguées`spam_guard_error_ignoreds`Motifs d'URL à ignorer`spam_guard_refused_contacts`Soumissions de formulaires refuséesVariables d'environnement
-------------------------

[](#variables-denvironnement)

```
SPAM_GUARD_ALERT_EMAIL=support@example.com
SPAM_GUARD_ALERT_THRESHOLD=10
SPAM_GUARD_BAN_THRESHOLD=30
```

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance64

Regular maintenance activity

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/01e3b87f81552dcad37697602c25ba84488a282eef74985b7d7a97859c2c1f2a?d=identicon)[COTIGA1](/maintainers/COTIGA1)

---

Top Contributors

[![cotiga](https://avatars.githubusercontent.com/u/16390911?v=4)](https://github.com/cotiga "cotiga (5 commits)")

### Embed Badge

![Health badge](/badges/cotiga-spam-guard-cs/health.svg)

```
[![Health](https://phpackages.com/badges/cotiga-spam-guard-cs/health.svg)](https://phpackages.com/packages/cotiga-spam-guard-cs)
```

###  Alternatives

[mews/purifier

Laravel 5/6/7/8/9/10 HtmlPurifier Package

2.0k18.7M144](/packages/mews-purifier)[paragonie/ecc

PHP Elliptic Curve Cryptography library

24820.0k41](/packages/paragonie-ecc)

PHPackages © 2026

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