Download the PHP package nowo-tech/routing-kit-bundle without Composer

Routing Kit Bundle

⭐ Found this useful? Install from Packagist · Give it a star on GitHub so more developers can find it.

Routing Kit Bundle — DB-driven (pluggable storage) locale paths for Symfony: dual /foo + /{locale}/foo access, admin-defined canonical URLs, Twig CRUD panel, route-cache invalidation, and SeoKitBundle path bridge. Tested on Symfony 7.4, 8.0, and 8.1 · PHP 8.2+ (Symfony 8.x requires PHP 8.4+).

This bundle is FrankenPHP worker mode friendly.

Features

• Storage — One row per (routeName, locale); filesystem JSON by default; swap via RoutePathStorageInterface.
• Locales — YAML default_locale + locales, or a custom LocaleProviderInterface.
• Canonical definition — Paths stored without {_locale}; the loader always builds /{_locale}/….
• Styles — canonical_style, trailing slash, alias mode (redirect / alias).
• Fallback — Missing locale row → default-locale path for that route name.
• #[Routable] — Controllers offered in the CRUD; params + constraints validated on save.
• Loader — type: nowo_routing_kit registers {name}.{locale} with _canonical_route (import last).
• Panel — Twig CRUD under /_routing on the UiKit page contract (list / form / confirm scaffolds, themed once in nowo_ui_kit for every bundle; see docs/TEMPLATES.md) + Symfony forms (FormKit) for create/edit, export, import, and clear-cache actions (auto invalidation after save/delete). Protect with security.access_roles (default [ROLE_ADMIN]) / allow_unauthenticated.
• Default locale without prefix (opt-in, default_locale_unprefixed) — Router decorator: the default locale generates the bare twin <route>_unlocalized of any route that has one (AuthKit / SiteBackup / app routes), and GET /{default}/… 301s to it. See docs/USAGE.md.
• SeoKit — Optional bridge decorates SeoPathBuilderInterface for canonical/hreflang paths.
• URL redirects (opt-in, url_redirects.enabled) — Operator-managed old path → new path / URL redirects applied before routing, with a panel section at /_routing/redirects, protected paths, live-page detection (LivePathCheckerInterface), hit counting (sync or Messenger) and pluggable storage. See docs/REDIRECTS.md.

Installation

With Symfony Flex, the recipe registers the bundle and adds config (see .symfony/recipe). Without Flex, see docs/INSTALLATION.md.

The loader registers {name}.{locale} with _canonical_route. Protect /_routing with your firewall.

Requirements

• PHP >=8.2 (<8.6); Symfony 8.0 and 8.1 require PHP 8.4+
• Symfony 7.4, 8.0, or 8.1
• Twig for the CRUD panel templates

Configuration

Usage

Open /_routing to manage paths. See docs/USAGE.md.

Development

Install git hooks once per clone: make setup-hooks (REQ-GIT-001).

Demos

Open http://localhost:8058 — panel at /_routing. FrankenPHP mode is controlled by FRANKENPHP_MODE (classic | worker, default worker) in the demo .env.

Playwright e2e of the panel and the README screenshots (REQ-DEMO-013):

Documentation

• Installation
• Configuration
• Usage
• Contributing
• Code of Conduct
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development
• GitHub Spec Kit

Additional documentation

• Customising the admin chrome — UiKit layout and theme; no page copies
• Templates — panel pages → UiKit scaffolds, view models, data blocks (REQ-UI-003)
• URL redirects
• PSR evaluation (REQ-CS-007)
• Demo (FrankenPHP)
• GitHub Actions CI requirements

Tests and coverage

PHPUnit with 100% line coverage of production PHP under src/ (optional SeoKit bridge files excluded when SeoKit is not a require-dev dependency):

License

MIT