Cover of the book Symfony 5: The Fast Track

Symfony 5: The Fast Track is the best book to learn modern Symfony development, from zero to production. +300 pages in full color showing how to combine Symfony with Docker, APIs, queues & async tasks, Webpack, Single-Page Applications, etc.

Buy printed version
WARNING: You are browsing the documentation for Symfony 4.0 which is not maintained anymore. Consider upgrading your projects to Symfony 5.1.

The Symfony Polyfill / Iconv Component

4.0 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

Alternatively, you can clone the repository.


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.