PHPackages                             isapp/ai-spamdetector - 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 & Helpers](/categories/utility)
4. /
5. isapp/ai-spamdetector

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

isapp/ai-spamdetector
=====================

Protect your contact forms from spam and bots using AI. Lightweight, flexible, and powered by OpenAI GPT for smarter filtering.

1.0.0(1y ago)011MITPHP

Since May 23Pushed 1y agoCompare

[ Source](https://github.com/isap-ou/ai-spamdetector)[ Packagist](https://packagist.org/packages/isapp/ai-spamdetector)[ RSS](/packages/isapp-ai-spamdetector/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (5)Versions (2)Used By (1)

AI SpamDetector
===============

[](#ai-spamdetector)

AI SpamDetector is a lightweight, framework-agnostic PHP library designed to intelligently detect spam in form submissions using OpenAI’s GPT models. It analyzes message content, user metadata, and email patterns to help you prevent unwanted or bot-generated form entries with minimal setup.

[![AI SpamDetector](https://camo.githubusercontent.com/0040753fa3121a272b36ca7508c8cc515069b261e942c0a1dfb2751e9f17482d/68747470733a2f2f7374617469632e697361702e6d652f61692d7370616d6465746563746f722e6a7067)](https://github.com/isap-ou/ai-spamdetector)[![Latest Version on Packagist](https://camo.githubusercontent.com/b3229bd4628c7cf8b8f3af53d121f5b1db43aede8084283ac91a44dce8e42ceb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f69736170702f61692d7370616d6465746563746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/isapp/ai-spamdetector)[![Total Downloads](https://camo.githubusercontent.com/49dd601973a5b2a5ce2fa405a159c45d501b4407e1f1cad912a72ed86cf3aaa1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f69736170702f61692d7370616d6465746563746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/isapp/ai-spamdetector)

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

[](#installation)

You can install the package via composer:

```
composer require isapp/ai-spamdetector
```

Basic Usage
-----------

[](#basic-usage)

```
use Isapp\AiSpamdetector\Client;use Isapp\AiSpamdetector\FormData;use Isapp\AiSpamdetector\SpamDetector;

$client = new Client(apiKey: getenv('OPENAI_API_KEY'), organization: getenv('OPENAI_ORGANIZATION'),model: 'gpt-4');
$detector = new SpamDetector(client: $client);

$form = new FormData(
    name: 'James Bond',
    email: 'freeprizes@cheapbiz.com',
    message: 'Click here for FREE cash!!!',
    userAgent: $_SERVER['HTTP_USER_AGENT'] ?? null,
);

$isNotSpam = $detector->analyze($form); // returns true if message is not spam
```

### Class: FormData

[](#class-formdata)

The `FormData` class acts as a structured container for submitted form data. It supports optional fields and omits `null` values when serialized to JSON.

#### Constructor

[](#constructor)

```
new FormData(
    string $email,
    string $message,
    ?string $name = null,
    ?string $firstName = null,
    ?string $lastName = null,
    ?string $phoneNumber = null,
    ?string $userAgent = null
)
```

#### Properties

[](#properties)

PropertyTypeDescription`name`?stringFull name (if not split into first/last)`firstName`?stringFirst name`lastName`?stringLast name`phoneNumber`?stringPhone number`email`?stringEmail address`message`stringThe message content`userAgent`?stringBrowser user-agent (optional)#### Methods

[](#methods)

- `toJson(): string`
    Serializes the form to JSON, skipping all `null` fields.

### Class: Client

[](#class-client)

The `Client` class is a lightweight wrapper around the official OpenAI PHP client. It simplifies authentication and allows you to specify a model.

#### Constructor

[](#constructor-1)

```
new Client(
    string $apiKey,
    ?string $organization = null,
    string $model = 'gpt-4'
)
```

#### Methods

[](#methods-1)

- `make(): \OpenAI\Client`
    Returns the underlying `openai-php/client` instance.
- `getModel(): string`
    Returns the currently configured OpenAI model (e.g., `gpt-4`).

These methods allow you to configure the client before making requests:

- `setApiKey(string $apiKey): static` - Sets a new OpenAI API key.
- `setModel(string $model): static` - Sets the model to be used (e.g. `gpt-4`, `gpt-3.5-turbo`).
- `setOrganization(?string $organization): static` - Sets the OpenAI organization ID (optional).
- `setProject(?string $project): static` - Sets the OpenAI project ID (optional).
- `setBaseUri(string $baseUri): static` - Sets a custom API base URI (default: `api.openai.com/v1`).

All setters return `$this`, allowing fluent configuration.

Contributing
------------

[](#contributing)

Contributions are welcome! If you have suggestions for improvements, new features, or find any issues, feel free to submit a pull request or open an [issue](https://github.com/isap-ou/ai-spamdetector/issues) in this repository.

Thank you for helping make this package better for the community!

License
-------

[](#license)

This project is open-sourced software licensed under the [MIT License](https://opensource.org/licenses/MIT).

You are free to use, modify, and distribute it in your projects, as long as you comply with the terms of the license.

---

Maintained by [ISAPP](https://isapp.be) and [ISAP OÜ](https://isap.me).
Check out our software development services at [isap.me](https://isap.me).

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance46

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity37

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

408d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9bfb1eae1e3e43813da6740e5eaa39307a95db7561c2d27e7e8aa24233cdcbeb?d=identicon)[andrii-trush](/maintainers/andrii-trush)

---

Top Contributors

[![andrii-trush](https://avatars.githubusercontent.com/u/14265776?v=4)](https://github.com/andrii-trush "andrii-trush (4 commits)")

---

Tags

aichatgptform-submissionform-validationphpspam-detection

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/isapp-ai-spamdetector/health.svg)

```
[![Health](https://phpackages.com/badges/isapp-ai-spamdetector/health.svg)](https://phpackages.com/packages/isapp-ai-spamdetector)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k39](/packages/neuron-core-neuron-ai)[maestroerror/laragent

Power of AI Agents in your Laravel project

639159.9k](/packages/maestroerror-laragent)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[oat-sa/tao-core

TAO core extension

66143.7k124](/packages/oat-sa-tao-core)

PHPackages © 2026

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