PHPackages                             digitaladapt/vigilant-form-kit - 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. digitaladapt/vigilant-form-kit

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

digitaladapt/vigilant-form-kit
==============================

(Software Development) Kit for VigilantForm.

1.4.0(5y ago)24311MITPHPPHP >=7.1.0

Since Feb 14Pushed 4y agoCompare

[ Source](https://github.com/digitaladapt/vigilant-form-kit)[ Packagist](https://packagist.org/packages/digitaladapt/vigilant-form-kit)[ Docs](https://github.com/digitaladapt/vigilant-form-kit)[ RSS](/packages/digitaladapt-vigilant-form-kit/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (2)Versions (23)Used By (1)

[![CodeFactor](https://camo.githubusercontent.com/143c3015674adc18b1b579c33805b128dc75e181f01754fc0ddd23bb20f75cf2/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f6469676974616c61646170742f766967696c616e742d666f726d2d6b69742f6261646765)](https://www.codefactor.io/repository/github/digitaladapt/vigilant-form-kit)

vigilant-form-kit
=================

[](#vigilant-form-kit)

(Software Development) Kit for VigilantForm.

So what is this?
----------------

[](#so-what-is-this)

VigilantFormKit is a simple library to make it easy to push your form submissions into an instance of VigilantForm.

So what is VigilantForm?
------------------------

[](#so-what-is-vigilantform)

VigilantForm is my attempt to keep junk form submissions from getting put in my CRM.

So rather then putting form submissions directly into my CRM, I push them to VigilantForm.

VigilantForm scores the submission, based on whatever scoring logic you choose; some examples include:

- checking if they passed the honeypot test
- checking how quickly the form was submitted
- checking if the email is valid (syntax and dns check)
- checking if the phone number is reasonable
- checking if required fields are filled out
- checking origin of the ip-address (via ipstack.com)
- looking for bad input, like "http://" in the name field
- and so on

After scoring is complete, the form submission is graded, and you can take different custom actions depending on the grade.

For example, I push quality form submissions into my CRM, but form submissions which need review go to Discord, with links to approve/reject; meanwhile junk form submissions get logged to a file for periodic review, and spam form submsissions quietly get trashed.

So how is it used?
------------------

[](#so-how-is-it-used)

First you add the library:

```
composer require digitaladapt/vigilant-form-kit
```

Then you hook it into your application:

```
use VigilantForm\Kit\VigilantFormKit;

/* once per page, setup and run the tracking */
$vigilantFormKit = new VigilantFormKit("", "", "");

// optional, defaults to (new SessionBag(), "vigilantform_")
// note: for Laravel you can use $request->session().
//$vigilantFormKit->setSession($session, "");

// optional, defaults to ("age", "form_sequence", "/vf-pn.js", "vf-pn")
// note: "" and "" must be unique form field names.
// note: "" must be a public javascript file location.
// note: "" must be the identifier used to process the honeypot in said javascript.
$vigilantFormKit->setHoneypot("", "", "", "");

// optional, defaults to (new NullLogger())
//$vigilantFormKit->setLogger($logger);

// once everything is setup, run the tracking
// if this request is a non-page (script or image) file,
// pass true to track the referral page instead.
$vigilantFormKit->trackSource();
```

```
/* once per form, add honeypot field, recommend just before submit */
echo $vigilantFormKit->generateHoneypot();
```

```
use UnexpectedValueException;

/* handle form submission */
if (!empty($_POST)) {
    try {
        // will determine if user failed the honeypot test, calculate duration, and submit to server.
        $vigilantFormKit->submitForm("", "", $_POST);
    } catch (UnexpectedValueException $exception) {
        // handle submitForm failure
    }
}
```

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

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 ~12 days

Total

19

Last Release

2046d ago

PHP version history (2 changes)v1.0-betaPHP >=7.2.0

1.2.4PHP >=7.1.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/545a8d2d680334e9eae8f4b352c78d8f18cfdbf93b05e97fa7c0760164778d20?d=identicon)[digitaladapt](/maintainers/digitaladapt)

---

Top Contributors

[![digitaladapt](https://avatars.githubusercontent.com/u/9849373?v=4)](https://github.com/digitaladapt "digitaladapt (15 commits)")

### Embed Badge

![Health badge](/badges/digitaladapt-vigilant-form-kit/health.svg)

```
[![Health](https://phpackages.com/badges/digitaladapt-vigilant-form-kit/health.svg)](https://phpackages.com/packages/digitaladapt-vigilant-form-kit)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[civicrm/civicrm-core

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

728272.9k17](/packages/civicrm-civicrm-core)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)

PHPackages © 2026

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