Weave Code
Hyphenator Bundle Laravel Package
liip/hyphenator-bundle
Symfony bundle that adds automatic hyphenation to templates via a Twig filter, wrapping the Org\Heigl\Hyphenator library. Configure locales, patterns, and quality settings inYAML, then let long words wrap cleanly in rendered HTML, emails, and PDF output.
[Deprecated] Adds support to Symfony for hyphenating long words using the Org_Heigl_Hyphenator library.
Frequently asked questions about Hyphenator Bundle
- Can I use liip/hyphenator-bundle in Laravel?
- No, not natively. LiipHyphenatorBundle is a Symfony bundle built around Symfony bundle configuration, dependency injection, and a Twig filter, so Laravel will not auto-discover or consume it like a Laravel package. Using it would mean bypassing the bundle and directly integrating the underlying Org\Heigl\Hyphenator library or writing a custom Laravel wrapper. For most Laravel applications, that is unnecessary risk for a narrow text-formatting feature.
- Is LiipHyphenatorBundle still maintained?
- No. The repository is archived, the last release was in 2015, and it has no active maintenance or dependents. That means no upstream security response, no PHP or Laravel compatibility work, and no issue triage. If you adopt it, your team owns fixes and dependency conflicts from day one.
- Does this package work with modern Laravel and PHP versions?
- Compatibility is unverified and likely poor. The 2015 release predates modern PHP and Laravel support expectations, so installing it into a current Laravel app risks Composer conflicts, fatal errors, and abandoned transitive dependencies. Any evaluation would need explicit PHP-version testing, dependency pinning, and a fallback path.
- How do I add automatic hyphenation to Blade templates in Laravel?
- This bundle does not provide a Blade directive or Laravel-native filter; its template integration is a Twig filter. In Laravel, first test whether CSS hyphens: auto is sufficient for rendered HTML. If server-side hyphenation is truly required, wrap a maintained PHP hyphenation library in a custom Laravel service or Blade directive rather than carrying over the Symfony bundle.
- What is the difference between this bundle and CSS hyphens: auto?
- CSS hyphens: auto lets the browser perform hyphenation at render time using language and dictionary support, so it adds no server dependency. LiipHyphenatorBundle performs server-side dictionary-based hyphenation through Symfony and Twig. CSS is often enough for HTML pages, but server-side hyphenation may still matter for emails, PDFs, or environments where browser hyphenation is inconsistent.
- How do I install liip/hyphenator-bundle?
- Historically, Symfony projects installed it with Composer and enabled the bundle with YAML configuration for locales, patterns, and quality settings. For Laravel, do not install it as-is because it is an archived Symfony bundle and will not integrate through Laravel's service provider, config publishing, or Blade conventions. If you only need the hyphenation behavior, audit the underlying library separately before adding any dependency.
- Which locales and hyphenation patterns are supported?
- The bundle is locale-aware and lets you select hyphenation patterns and dictionaries through configuration, with quality and other options exposed. The exact locale coverage depends on the patterns available through the underlying Org\Heigl\Hyphenator library. You should verify every required locale and dictionary before assuming the package meets your product needs.
- Can I use the underlying Org\Heigl\Hyphenator library without Symfony?
- Yes, the underlying library is plain PHP and can be integrated directly into a Laravel service class without the Symfony bundle layer. However, you should still audit its maintenance status, PHP compatibility, licensing, and security posture before relying on it. The bundle itself should not be carried into Laravel just to access that behavior.
- What are the risks of using an archived Composer package in production?
- The main risks are no security patches, no compatibility fixes, Composer resolution failures, fatal errors on newer PHP versions, and abandoned transitive dependencies. An archived package also means no upstream support, so your team must own every bug and upgrade. For a narrow capability like hyphenation, that maintenance burden is usually hard to justify.
- What are Laravel-friendly alternatives to LiipHyphenatorBundle?
- Start with CSS hyphens: auto if your output is browser-rendered HTML and the required locales are supported. If you need server-side hyphenation, evaluate a maintained PHP hyphenation library and wrap it in a Laravel service provider or custom Blade directive with tests and feature flags. There is no direct Laravel-native equivalent in this package, so avoid exposing Symfony bundle configuration directly to application code.
Weaver
How can I help you explore Laravel packages today?