Laravel Tutorials

How to Redirect Uppercase URLs to Lowercase with Laravel Middleware

Published
How to Redirect Uppercase URLs to Lowercase with Laravel Middleware image

Last week, I needed to redirect all requests that contained uppercase letters to their lowercase equivalents for SEO optimization.

For example:

From To
/location/Atlanta /location/atlanta
/docs/Laravel-Middleware /docs/laravel-middleware

At the same time, the solution shouldn't change any query parameters:

From To
/locations/United-States?search=Georgia /location/united-states?search=Georgia

It turns out we can do this with just a few lines of code in a Laravel middleware! First, we grab the path from the request and check if the it is the same lowercased. If not, we can use the url()->query() method to append the query string back onto the lowercase version of the path and permanently redirect to the lowercased path.

<?php
 
namespace App\Http\Middleware;
 
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
 
class RedirectUppercase
{
/**
* Handle an incoming request.
*
* @param \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response) $next
*/
public function handle(Request $request, Closure $next): Response
{
$path = $request->path();
 
if (($lower = strtolower($path)) !== $path) {
$url = url()->query($lower, $request->query());
 
return redirect($url, 301);
}
 
return $next($request);
}
}

To register the middleware in a Laravel 11 app, I appended it to the web middleware group in the bootstrap/app.php file.

<?php
 
return Application::configure(basePath: dirname(__DIR__))
->withRouting(
// ...
)
->withMiddleware(function (Middleware $middleware) {
$middleware->appendToGroup('web', \App\Http\Middleware\RedirectUppercase::class);
});

Note: you may want to exclude this middleware from routes that use signed URLs or other case sensitive use-cases.

I'm sure there are possible solutions with Nginx or Apache, but this was by far the simplest solution for me and it works across all environments of the app. I don't have to remember to make any changes on new servers.

Jason Beggs photo

TALL stack (Tailwind CSS, Alpine.js, Laravel, and Livewire) consultant and owner of designtotailwind.com.

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
Laravel AI SDK and Laravel MCP Security Fixes: Update Now image

Laravel AI SDK and Laravel MCP Security Fixes: Update Now

Read article
Mailbox for Laravel: Preview and Test Rendered Email image

Mailbox for Laravel: Preview and Test Rendered Email

Read article
Count Worker Crashes as Job Exceptions in Laravel 13.34 image

Count Worker Crashes as Job Exceptions in Laravel 13.34

Read article
Elastic Bridge: Eloquent-Style Queries for Elasticsearch and OpenSearch image

Elastic Bridge: Eloquent-Style Queries for Elasticsearch and OpenSearch

Read article
Laravel Release Cycle: Versions, Support Policy, and Dates image

Laravel Release Cycle: Versions, Support Policy, and Dates

Read article
Unlearn.dev goes free for a weekend, October 10 and 11 image

Unlearn.dev goes free for a weekend, October 10 and 11

Read article