Weave Code
Polyfill Mbstring Laravel Package
symfony/polyfill-mbstring
Provides a partial, native PHP implementation of the Mbstring extension, letting applications use multibyte string functions even when the mbstring extension is unavailable. Part of the Symfony Polyfill family and released under the MIT license.
symfony/polyfill-mbstring provides a partial, native PHP implementation of the Mbstring extension, allowing applications to use multibyte string functions even when the extension isn't installed. Part of the Symfony Polyfill family, it is widely pulled in transitively by frameworks and libraries.
- Defines missing
mb_*functions as pure-PHP fallbacks - Enables consistent UTF-8 and multibyte handling across environments
- Lightweight, dependency-free, and MIT-licensed
- Improves portability for packages that require Mbstring
Frequently asked questions about Polyfill Mbstring
- What is symfony/polyfill-mbstring used for in Laravel?
- It provides a pure-PHP fallback for PHP mbstring functions when ext-mbstring is not installed, so Laravel features such as Blade rendering, validation, localization, and Str helpers can keep working across environments. It is part of Symfony's Polyfill suite and is already used by Laravel core and ecosystem packages. Use it to improve portability on shared hosting, Alpine Linux, or other setups without native mbstring.
- How do I install symfony/polyfill-mbstring in a Laravel project?
- Install it with Composer by running composer require symfony/polyfill-mbstring, or pin a version with composer require symfony/polyfill-mbstring:^1.38.2 --update-with-dependencies. It is often already present transitively through laravel/framework, so check composer show before adding it directly. No Laravel service provider or manual autoload changes are needed.
- Does symfony/polyfill-mbstring require configuration in Laravel?
- No runtime configuration or service provider registration is required. The polyfill defines mbstring-compatible functions only when the native extension is unavailable and is managed through Composer. Ensure ext-iconv is enabled because the polyfill uses it as a fallback.
- Is symfony/polyfill-mbstring compatible with Laravel 10 and Laravel 11?
- Yes, it is framework-agnostic and autoloaded by Composer, and Laravel already depends on Symfony polyfills. Laravel 10 and 11 applications can use it as long as the PHP platform requirements are met. The package requires PHP 7.2+ and ext-iconv according to the technical evaluation.
- Do I still need the PHP mbstring extension if I use symfony/polyfill-mbstring?
- The polyfill is a partial native PHP implementation, not a complete replacement for ext-mbstring. Enable the native mbstring extension when possible for full behavior and better performance. Use symfony/polyfill-mbstring as a fallback when ext-mbstring cannot be installed.
- What is the performance impact of symfony/polyfill-mbstring in production?
- The polyfill adds roughly 10 to 20 percent overhead compared with native mbstring for multibyte operations. That is negligible for many Laravel apps, but high-traffic APIs or content-heavy sites should enable ext-mbstring if available. The polyfill is stateless and has no horizontal scaling impact.
- How should I test mb_scrub and mb_str_pad after updating symfony/polyfill-mbstring?
- Add tests for control-character sanitization with mb_scrub and RTL padding with mb_str_pad using Arabic or Hebrew text. Run CI on Alpine Linux and PHP versions without ext-mbstring, plus validation rules and Blade components that depend on multibyte strings. The v1.38.2 fixes specifically target invalid UTF-8 and RTL padding edge cases.
- What PHP version and extensions does symfony/polyfill-mbstring require?
- The package requires PHP 7.2+ and ext-iconv must be available as a fallback. It has no other external dependencies beyond the iconv extension. Check your composer platform requirements before deploying to shared hosting.
- Are there alternatives to symfony/polyfill-mbstring for Laravel?
- The best alternative is enabling the native PHP mbstring extension, which avoids polyfill overhead and provides complete mbstring behavior. Other polyfill packages exist, but Symfony's polyfill is the standard already pulled in by Laravel core and ecosystem packages. Avoid custom mbstring shims because they are harder to maintain and test.
- How is symfony/polyfill-mbstring maintained and updated?
- It is MIT licensed and actively maintained by Symfony, with updates aligned to Symfony's release cycle. The technical evaluation notes a quarterly release cadence and no deprecation concerns. Laravel's composer constraints help pin polyfill versions and reduce dependency drift.
Weaver
How can I help you explore Laravel packages today?