English spoken conference

You are browsing the Symfony 4.3 documentation, which changes significantly from Symfony 3.x. If your app doesn't use Symfony 4.3 yet, browse the Symfony 3.4 documentation.

The Symfony Polyfill / Iconv Component

4.3 version
Maintained Unmaintained

The Symfony Polyfill / Iconv Component

This component provides a native PHP implementation of the iconv_* functions to users who run PHP versions without the iconv extension.


$ composer require symfony/polyfill-iconv


If you install this component outside of a Symfony application, you must require the vendor/autoload.php file in your code to enable the class autoloading mechanism provided by Composer. Read this article for more details.


Once this component is installed in your application, you can use the following constants and functions, no matter if the PHP iconv extension is installed or not in your server. The only function not implemented in this component is ob_iconv_handler.

Provided Constants

  • ICONV_IMPL (value = 'Symfony')
  • ICONV_VERSION (value = '1.0')

Provided Functions

These functions are always available:

These functions are only available when the mbstring or the xml extension are installed:

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.