PHPackages                             drkmode/laravel-knock-knock - 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. drkmode/laravel-knock-knock

ActiveLibrary

drkmode/laravel-knock-knock
===========================

Protect your site with a simple password form

1.2.2(1y ago)2210MITPHPPHP >=5.6.4

Since Oct 21Pushed 1y agoCompare

[ Source](https://github.com/DrkMode/laravel-knock-knock)[ Packagist](https://packagist.org/packages/drkmode/laravel-knock-knock)[ RSS](/packages/drkmode-laravel-knock-knock/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)DependenciesVersions (6)Used By (0)

Very simple site wide password protection for Laravel
=====================================================

[](#very-simple-site-wide-password-protection-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/5a012c5bf6c6b6acf136cbcf3bf221aa6cb5799e9bed517ebdb6b7676caf2f6e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64726b6d6f64652f6c61726176656c2d6b6e6f636b2d6b6e6f636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/:vendor_slug/:package_slug)[![Total Downloads](https://camo.githubusercontent.com/f2dfaabc4cb09311551000c2b2edfe5bef9d052dd0272783da98919507c6b80a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f64726b6d6f64652f6c61726176656c2d6b6e6f636b2d6b6e6f636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/drkmode/filament-redirects)

This will add a simple password form in front of your application to protected it from any access. The password is specified using the `.env` file to protect your sites, commonly used for DEV or STAGE sites. You can use multiple passwords for different user groups. Once the password is removed, the access is revoked.

You can use multiple passwords for different user groups. Once the password is removed, the access is revoked.

This does not protect any assets files like css or images.

**Looks like**

[![SiteProtection](https://raw.githubusercontent.com/DrkMode/laravel-knock-knock/main/preview.jpg)](https://raw.githubusercontent.com/DrkMode/laravel-knock-knock/main/preview.jpg)

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

[](#installation)

```
composer require drkmode/laravel-knock-knock

```

### Laravel >= 5.2

[](#laravel--52)

This package requires at least the Laravel Framework of version **5.2**.

Add ServiceProvider to the providers array in `app/config/app.php`.

```
DrkMode\SiteProtection\SiteProtectionServiceProvider::class,

```

### Laravel >= 5.5

[](#laravel--55)

You don't need to add this package to your `app/config/app.php` since it supports auto discovery.

### Add Middleware

[](#add-middleware)

Add Middleware to `app/Http/Kernel.php` or specific routes you want to protect.

```
protected $middlewareGroups = [
    'web' => [
        ...
        \DrkMode\SiteProtection\Http\Middleware\SiteProtection::class,
    ],
    ...
];

```

### Laravel >= 11

[](#laravel--11)

### Add Middleware

[](#add-middleware-1)

Add Middleware to `bootstrap/app.php` or specific routes you want to protect.

```
->withMiddleware(function (Middleware $middleware) {
        $middleware->web(append: [
            ...
            \DrkMode\SiteProtection\Http\Middleware\SiteProtection::class,
        ]);
    })

```

### Configuration

[](#configuration)

Most configuration can be done using ENV variables by adding the following keys to your `.env` file.

#### Adjusting the passwords

[](#adjusting-the-passwords)

You can use multiple passwords separated by comma.

```
SITE_PROTECTION_PASSWORDS=password1,password2

```

To revoke access to your site simply change the password. This requires every user using the old password to re-enter a password.

#### Exclude certain paths from protection

[](#exclude-certain-paths-from-protection)

You can exclude specific paths from protection. Add a comma seperated list of paths to your `.env` file. You can use the `*` to exclude a group of paths.

```
SITE_PROTECTION_EXCEPT_PATHS=path1,path2,login*

```

#### Protect only specific paths

[](#protect-only-specific-paths)

You can protect only some paths. Add a comma seperated list of paths to your `.env` file. You can use the `*` to protect a a group of paths.

```
SITE_PROTECTION_PROTECTED_ONLY_PATHS=path1,path2,admin*

```

#### Set a CSS file uri

[](#set-a-css-file-uri)

You can change the look and feel of the password protection page by adding an uri to your main css file. The css file is appened to the existing css styles to keep basic alignments.

```
SITE_PROTECTION_CSS_FILE_URI=/assets/app.css

```

#### Set a Logo file path

[](#set-a-logo-file-path)

You can add your own company or project logo by setting this `.env` variable to the path of the image.

```
SITE_PROTECTION_LOGO_PATH=/assets/logo.png

```

### Customization

[](#customization)

In case you really need to. You can modify the view that handles password entry by publishing the views to your resource folder. This is not recommended and might cause problems on future updates. Try using the uri to a css file first.

Run the following command:

```
php artisan vendor:publish --provider="DrkMode\SiteProtection\SiteProtectionServiceProvider" --tag=views

```

You can now make the changes in `resources/vendor/views/site-protection/site-protection-form.blade.php`.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

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

Total

5

Last Release

634d ago

### Community

Maintainers

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

---

Top Contributors

[![NoahBosman](https://avatars.githubusercontent.com/u/26520947?v=4)](https://github.com/NoahBosman "NoahBosman (1 commits)")

### Embed Badge

![Health badge](/badges/drkmode-laravel-knock-knock/health.svg)

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

PHPackages © 2026

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