Document the removal of true/punycode and pear/net_idna2
authorTim Düsterhus <duesterhus@woltlab.com>
Thu, 9 Jun 2022 10:13:09 +0000 (12:13 +0200)
committerGitHub <noreply@github.com>
Thu, 9 Jun 2022 10:13:09 +0000 (12:13 +0200)
docs/migration/wsc55/libraries.md

index fb125269f0fd222fa689495125facefafa42e178..f0ee88339f7ea995b7c10e123c4ff23e96e12368 100644 (file)
@@ -7,6 +7,12 @@ The Polyfill for PHP 8.2 was added.
 
 Refer to the documentation within the [symfony/polyfill](https://github.com/symfony/polyfill/) repository for details.
 
+## IDNA Handling
+
+The true/punycode and pear/net_idna2 dependencies were removed, because of a lack of upstream maintenance.
+Instead the [`idn_to_ascii`](https://www.php.net/manual/en/function.idn-to-ascii.php) function should be used.
+A polyfill for environments without the intl extension is provided.
+
 ## Laminas Diactoros
 
 Diactoros was updated from version 2.4 to 2.10.