The Symfony Polyfill / Iconv Component

Edit this page

Warning: You are browsing the documentation for Symfony 2.8, which is no longer maintained.

Read the updated version of this page for Symfony 6.1 (the current stable version).

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.