PHPackages                             joshwhatk/super-scan - 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. joshwhatk/super-scan

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

joshwhatk/super-scan
====================

Simple File Change Detection for Laravel

v1.0.2(10y ago)11251[1 PRs](https://github.com/joshwhatk/super-scan/pulls)MITPHPPHP >=5.5.9

Since Jan 11Pushed 8y ago1 watchersCompare

[ Source](https://github.com/joshwhatk/super-scan)[ Packagist](https://packagist.org/packages/joshwhatk/super-scan)[ RSS](/packages/joshwhatk-super-scan/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (8)Versions (10)Used By (0)

Super-scan
==========

[](#super-scan)

Detect changed files using PHP/MySQL/CRON

Introduction
------------

[](#introduction)

This set of scripts is an evolution from what David K. Lynn offered as a SitePoint article and then through suggestions from Han Wechgelaer.

For the original code and readme, you can check the repository for which this is a fork: [SuperScan](https://github.com/dklynn/SuperScan). Although based on the same original code, this repository is now **very** different from David K. Lynn's version, so I have removed his readme as well.

**Super-scan** is a package built for Laravel that allows simple File change detection and reporting.

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

[](#installation)

Register the SuperScanServiceProvider in your `config/app.php`:

```
JoshWhatK\SuperScan\SuperScanServiceProvider::class,

```

Publish the config file and migrations:

```
php artisan vendor:publish --provider="JoshWhatK\SuperScan\SuperScanServiceProvider"

```

Change the default Account(s) as you wish:

> Example

```
'account' => [

    /*
    |--------------------------------------------------------------------------
    | Default Account
    |--------------------------------------------------------------------------
    |
    | This account information is saved to the database during the super-scan
    | migrations. If you are not using the default
    | JoshWhatK\SuperScan\Database\Account model, then this can be removed.
    |
    */

    'defauts' => [
        [
            'name' => 'Base Account',
            'server_name' => 'hostname',
            'ip_address' => '127.0.0.1',
            'scan_directory' => '/var/www/html'
            'public_url' => 'https://www.example.com',
            'excluded_directories' => [
                'logs',
            ],
        ],
    ],
],

```

If you would like to use your own Account model, just make sure that it implements `JoshWhatK\SuperScan\Contracts\AccountInterface`.

Now you can set up the `Scan` to run as a Laravel task in `app/Console/Kernel.php`.

```
$schedule->call(function () {
    try {
        Scan::run(Account::first(), new Report);
    } catch (\Exception $e) {
    }
})->everyMinute();

```

Now you can test it using:

```
php artisan schedule:run

```

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 92.5% 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 ~18 days

Recently: every ~26 days

Total

7

Last Release

3711d ago

Major Versions

v0.0.4 → v1.0.02016-03-30

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1848905?v=4)[Josh Friend](/maintainers/joshwhatk)[@joshwhatk](https://github.com/joshwhatk)

---

Top Contributors

[![joshwhatk](https://avatars.githubusercontent.com/u/1848905?v=4)](https://github.com/joshwhatk "joshwhatk (173 commits)")[![dklynn](https://avatars.githubusercontent.com/u/14948073?v=4)](https://github.com/dklynn "dklynn (14 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/joshwhatk-super-scan/health.svg)

```
[![Health](https://phpackages.com/badges/joshwhatk-super-scan/health.svg)](https://phpackages.com/packages/joshwhatk-super-scan)
```

###  Alternatives

[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17818.7k](/packages/markwalet-nova-modal-response)[crumbls/layup

A visual page builder plugin for Filament 5 — Divi-style grid layouts with extensible widgets.

591.7k1](/packages/crumbls-layup)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.2k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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