NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4197 most downloaded on Packagist
A library for encoding and decoding internationalized domain names
Latest stable
v4.2.2
Last release 18 days ago
04 Nov 2026
Ships unpredictably
gaps range from 8 days to 2.4 years
Some releases are documented
notes for 9 of 28 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
29 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
v4: security fixes and important backward-compatible bug fixes for 12 months.
The first release candidate for IDNA Convert v5 is ready for testing.
This major release improves Unicode normalization and IDNA validation, adds public validation APIs, and strengthens automated conformance checks. Some inputs accepted by earlier versions are now rejected or produce different normalized results.
This is a prerelease. Please test it with your application before upgrading production installations.
InputValidator and IdnaValidator APIs.ß and final sigma.PunycodeInterface constructor require updates to some custom implementations and subclasses.AbstractPunycode::$unicodeTransCoder property has been replaced by $ucs4Codec.See UPGRADING.md for details, configuration options, and migration guidance.
The minimum PHP version remains 8.1.
The ToASCII checks cover non-transitional UTS #46 mapping followed by strict IDNA2008 validation. They do not establish full UTS #46 conformance or conformance of the separate ToUnicode decoder.
composer require algo26-matthias/idna-convert:5.0.0-rc1
We particularly welcome testing with existing domain collections, URLs, email addresses, and custom implementations of the library's interfaces. Check for changed conversion results and newly raised exceptions, especially when comparing or storing normalized domain names.
Please report unexpected behavior through GitHub Issues, including the input, expected and actual behavior, PHP version, and converter options.
Support periods begin with v5.0.0 stable, not this release candidate:
See SECURITY.md for the maintenance policy.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This version removes the dependency to an abandoned URL parser package. The functionality is rebuilt with own code.
This version removes the dependency to an abandoned URL parser package. The functionality is rebuilt with own code.
Furthermore, the test suite is extended and PHP code quality tools are introduced.
Enhance compatibility with PHP 8.5.
Enhance compatibility with PHP 8.5.
Implement case folding in PHP, thus no longer requiring extra dependencies.
Implement case folding in PHP, thus no longer requiring extra dependencies.
Remove mbstring polyfill
Remove mbstring polyfill
Nothing published for this version
This makes ext/intl a recommendation, but additionally supports mbstring based case folding to properly handle all characters supported with IDNA2008.
This makes ext/intl a recommendation, but additionally supports mbstring based case folding to properly handle all characters supported with IDNA2008. You are strongly advised to have either ext/intl or ext/mbstring installed to avoid buggy conversions.
Nothing published for this version
Fix case folding in NamePrep for IDNA2008
Fix case folding in NamePrep for IDNA2008
Nothing published for this version
Fixes a mix-up in parameter order when checking for URLs in the input.
Fixes a mix-up in parameter order when checking for URLs in the input.
Nothing published for this version
Enhance compatibility with PHP 8.5.
Enhance compatibility with PHP 8.5.
Nothing published for this version
backport changes from v4
backport changes from v4
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.