Download the PHP package ozkanozcan/laravel-404-to-301 without Composer

Laravel 404 To 301 Redirect & Missing URL Logger

An automated 404 URL redirect manager and missing URL logger package for Laravel 10, 11, 12, and 13.
Manage 301/302 redirects dynamically via database rules, cache lookups for high performance, and automatically record unhandled 404 requests to database or log channels.

Table of Contents

• Requirements
• Features
• Installation
• Configuration
• Middleware Setup
• Database Structure
• Artisan Commands
• Programmatic Usage & Facade
• Testing
• Changelog
• Contributing
• License

Requirements

Features

• ⚡ High Performance Caching: Cache lookup results to avoid unnecessary database hits on every request.
• 🔀 Dynamic 301 / 302 Redirects: Easily manage source-to-destination redirect rules.
• 📊 Hit Counter: Keep track of how many times each redirect rule has been triggered.
• 📝 Missing URL Tracker: Automatically log unhandled 404 requests into a dedicated database table (missing_urls) with visitor IP, referer, user agent, and hit frequency.
• 📁 Laravel Log Channel Support: Optionally log 404 events to Laravel log channels (daily, single, slack, etc.).
• 🛡️ Ignored File Patterns: Skip static assets (*.css, *.js, *.png, favicon.ico, robots.txt) from triggering log/database records.
• 💻 Artisan Tools: Bulk import CSV/JSON rules, inspect missing URLs, and prune old missing URL logs.

Installation

Install the package via Composer:

Publish the configuration file and database migrations:

Run the database migrations:

Configuration

The configuration file is published to config/redirect404.php. Here is an overview of the key options:

Middleware Setup

Laravel 11 & 12 (bootstrap/app.php)

Add redirect404 to the web middleware stack:

Laravel 10 (app/Http/Kernel.php)

Add the middleware alias or append it to your web middleware group:

Artisan Commands

1. Inspect Missing 404 URLs

List the top unhandled 404 paths recorded in the database:

2. Bulk Import Redirect Rules (CSV or JSON)

Import redirect rules from a file:

Sample redirects.csv:

Sample redirects.json:

3. Prune Old Missing URL Logs

Clean up old missing URL records from the database:

Programmatic Usage & Facade

You can use the Redirect404 facade or Eloquent models directly in your application or admin panel:

Testing

Run the test suite using PHPUnit:

Changelog

See CHANGELOG.md for full version history.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit changes using Conventional Commits
4. Push to origin and open a Pull Request against development

License

MIT © Özkan Özcan — Özcan Teknoloji
See LICENSE for details.