antonchaikin/f3-404camouflage

Fat-Free Framework plugin to mask framework identity and serve custom 404 pages.

v1.0.1 2025-05-28 17:20 UTC

This package is auto-updated.

Last update: 2025-05-28 17:21:29 UTC


README

Because your app deserves a little privacy... or just a good laugh.

F3 404Camouflage is a plugin for the Fat-Free Framework (F3) that hides all traces of its existence and serves misleading 404 pages from other popular frameworks. Why? To confuse bots, throw off script kiddies, or just for the sheer fun of pretending your PHP app is actually built in Django or Next.js.

🔍 What does it do?

  • Removes X-Powered-By headers and disables PHP exposure.
  • Replaces the default F3 error handler with a fake 404 page that mimics:
    • Laravel
    • Symfony
    • Django
    • ASP.NET
    • Next.js
    • Spring Boot
    • Rails
    • Express.js
    • And more to come...

🛠 Usage

\F3Camouflage\Camouflage::register('symfony'); // or 'laravel', 'rails', etc.

Default mode is 'default', which returns a stylish generic 404 page.

💡 Why?

  • Security through obscurity — throw off attackers who are scanning for specific vulnerabilities.
  • Humor — pretend your tiny PHP app is a full-fledged enterprise Java stack.
  • Misdirection — keep them guessing.

🎭 Frameworks you'd be fooling them with

The 404 pages are carefully crafted to look like they came from real-life deployments of the frameworks they impersonate. You can swap modes to whatever persona you want your app to adopt today.

🔮 Future ideas

  • Custom random rotation of error pages.
  • Mode: Laravel on Mondays, Django on Fridays.
  • Easter egg mode that occasionally serves HTTP 418 (I'm a teapot).

📦 Installation

Use Composer:

composer require antonchaikin/f3-404camouflage

Or clone manually and include it in your project.

☕ Made with love and mischief by developers who like throwing curveballs.