Weave Code
Breadcrumbs Bundle Laravel Package
whiteoctober/breadcrumbs-bundle
A Symfony bundle for building and rendering breadcrumbs in your application. Define breadcrumb trails through configuration or services, then output them in Twig with customizable templates—a simple, lightweight way to add navigation trails to Symfony projects.
WhiteOctober BreadcrumbsBundle is a lightweight Symfony bundle for building and rendering breadcrumb trails. It provides a simple service and Twig helper for assembling breadcrumbs from controller code or annotations, with URLs generated through Symfony’s router and flexible templates for output.
- Fluent service API for adding breadcrumb items and links
- Annotation-based breadcrumb definitions for controller actions
- Twig helper for rendering breadcrumb trails
- Configurable templates, separators, and translation support
- Integrates with Symfony’s router and request context
Frequently asked questions about Breadcrumbs Bundle
- Is whiteoctober/breadcrumbs-bundle a Laravel package?
- No. It is a Symfony 2 bundle built around Symfony's kernel, its YAML/XML dependency injection container, and a Twig extension for rendering. Laravel's service container, Blade templating, and package auto-discovery have no mechanical overlap with that design. There is no architecture fit without a rewrite, at which point you are copying the design rather than integrating the package.
- How do I install whiteoctober/breadcrumbs-bundle?
- Historically you installed it with Composer inside a Symfony 2 application and registered the bundle in AppKernel, with service wiring in services.yml. There is no Laravel service provider, facade, config publish step, or package discovery entry. Composer may resolve it in a Laravel project, but nothing will register or boot it.
- What does this bundle actually do?
- It provides a small breadcrumb builder that accumulates labeled items from your routes and controllers, plus a renderer exposed through Twig. You define the trail fluently in your controller and output accessible, customizable markup in your templates. The functional surface is intentionally tiny: a builder, a few configuration options for separator and theme, and the Twig extension.
- Does it support Laravel 10, 11, or 12?
- No. Symfony 2 reached end of life in 2018, and this bundle's PHP and Twig constraints pin to PHP 5.x and 7.0-era syntax. Its declared Symfony and Twig versions will conflict with any modern lockfile, and the bundle-style packaging was superseded by Symfony Flex recipes in Symfony 4. There is no supported path to run it on a current Laravel release.
- What should Laravel developers use instead for breadcrumbs?
- Use diglactic/laravel-breadcrumbs, which continues the maintained fork lineage of the widely used Laravel breadcrumbs package, or spatie/laravel-breadcrumbs if you prefer that API. For small apps, an in-house singleton service plus an x-breadcrumbs Blade component driven by Route::currentRouteName() is often enough at roughly 150 to 300 lines including tests. Pick whichever already aligns with your existing navigation abstraction.
- Is the package still maintained?
- No. The repository is archived, the last release was 2019-10-18, and it has zero dependents. There is no maintainer doing issue triage and no CVE response process. That makes it a hard blocker for most enterprise dependency reviews regardless of how small the code is.
- What license does it use, and can I copy code from it?
- The license metadata reports NOASSERTION, meaning the repository's licensing could not be machine-identified. Legal review is mandatory before vendoring any file, and a clean-room reimplementation from the documented behavior avoids derivative-work ambiguity. In practice, reimplementing the small behavioral contract is cheaper than a licensing fight.
- Can it generate BreadcrumbList JSON-LD or schema.org markup for SEO?
- Not out of the box. It renders visual HTML navigation through Twig and offers no built-in schema.org or BreadcrumbList JSON-LD output. You would need to emit structured data yourself, for example from a Blade partial that mirrors the same trail. In Laravel, generate the JSON-LD alongside the component so the visual trail and the structured data never drift apart.
- Will it run on PHP 8.2 or 8.3?
- Very unlikely without patching. The bundle targets PHP 5.x and 7.0-era syntax and declares Symfony 2 and Twig constraints that will not resolve on PHP 8.2 or 8.3. Even if you force the install with ignored platform requirements, the container config and Twig extension are inert outside Symfony 2. Treat it as incompatible rather than something to shim.
- How hard is it to reimplement its breadcrumb behavior in Laravel?
- Easy, because the surface is small: capture how items are added, how the last item is marked active, how the separator and theme are configured, and how route names map to labels. Then rebuild it natively as a singleton Breadcrumbs service, a route-name-keyed definition file following Laravel convention, and a Blade component for rendering. Expect roughly 150 to 300 lines including tests, with no abandoned-dependency risk.
Weaver
How can I help you explore Laravel packages today?