# symfony/polyfill-iconv

Symfony polyfill for the Iconv extension

Repository: https://github.com/symfony/polyfill-iconv
Canonical: https://ross.abutalabs.com/products/polyfill-iconv
Homepage: https://symfony.com/polyfill-iconv
Language: PHP
License: MIT
License Family: permissive
Topics: symfony, component, symfony-component, compatibility, iconv, javascript, polyfill, portable, shim, symfony-polyfill
Last push: 2026-04-26T14:44:56+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 79, release rhythm 81, longevity 100
- inputs: {"age_days": 3968, "days_push": 129, "days_rel": 129, "gap_med": 3, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1759, forks 10 (observed 2026-08-28T04:05:32.457152+00:00)

## What it is
A Symfony component that provides a native PHP implementation of the iconv extension functions for environments where the extension is unavailable. It acts as a drop-in compatibility shim so code depending on iconv works across PHP setups.

## Use cases
- use iconv functions when the PHP iconv extension is missing
- make a PHP library portable across hosts without iconv installed
- ensure consistent character encoding conversion behavior across environments
- add iconv compatibility to a legacy PHP application
- avoid hard dependency on PHP extensions in a composer package

## When to choose
- your PHP code calls iconv functions and must run on hosts without the extension
- you maintain a library that should work on minimal PHP installations
- you want a drop-in, MIT-licensed shim maintained by the Symfony ecosystem

## When to avoid
- the iconv extension is already installed and enabled on your target environments
- you need ob_iconv_handler, which this polyfill does not implement
- you need full-featured character encoding conversion beyond iconv's API

## Facets
- artifact type: library
- maturity: stable
- function: internationalization, developer-tools
- domain: developer-tools, cross-platform
- platform: php
- tags: polyfill, iconv, shim, character-encoding, symfony-component, compatibility-layer, localization

## Member repositories
- symfony/polyfill-iconv (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:32.457152+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:27:32.725086+00:00, confidence not recorded.
  - readme: https://github.com/symfony/polyfill-iconv (fetched 2026-08-28T04:05:32.457152+00:00, sha e5dda08da8a2)
  - homepage: https://symfony.com/polyfill-iconv (fetched 2026-08-29T11:05:39.026237+00:00, sha 45289e572887)
  - site_page: https://symfony.com/doc (fetched 2026-08-29T11:05:39.035147+00:00, sha 44889134f4fb)
  - site_page: https://symfony.com/releases (fetched 2026-08-29T11:05:39.037227+00:00, sha 5bd749e2b676)
  - site_page: https://symfony.com/blog/category/releases (fetched 2026-08-29T11:05:39.039118+00:00, sha 0739a28df2e8)
- Data as of 2026-08-30T08:39:29.467469+00:00.