advancedideasmechanics/mezzio-canonical-url

PSR-7 Canonical URL middleware for Mezzio applications.

v0.0.6 2026-06-16 11:32 UTC

Requires

• php: ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• mezzio/mezzio-router: ^3.0 || ^4.0
• mezzio/mezzio-template: ^2.0 || ^3.0
• psr/http-server-middleware: ^1.0

MIT

• Matthew Pallotta

• php
• library
• canonical
• matthewpallotta
• advancedideasmechanics
• mezzio

README

PSR-7 Canonical URL middleware for Mezzio applications.

Composer

composer install advancedideasmechanics/mezzio-canonical-url

Use

For pipeline.php Middleware Use.

Recommend placing between $app->pipe(RouteMiddleware::class); and $app->pipe(ImplicitHeadMiddleware::class);

$app->pipe(AdvancedIdeasMechanics\MezzioCanonicalUrl\Middleware\CanonicalUrlMiddleware::class);

For route.php Middleware use.

use AdvancedIdeasMechanics\MezzioCanonicalUrl\Middleware\CanonicalUrlMiddleware;

$app->get('/', [CanonicalUrlMiddleware:class, App\Handler\HomePageHandler::class], 'home');

Set below in the templates\layout\default.phtml

if (isset($this->canonicalUrl)) { $this->headLink(['rel' => 'canonical', 'href' => $this->canonicalUrl]); }

If you want to override another page, example templates\app\about.phtml

$this->canonicalUrl = 'https://example.com/about';