Changeset 62482 for trunk/tests/phpunit/tests/formatting/sanitizeEmail.php

Timestamp:

06/10/2026 03:04:54 PM (6 days ago)

Author:

dmsnell

Message:

General: Add support for unicode email addresses in is_email and sanitize_email

This adds support for the unicode address extensions in RFC 6530-3 and refactors the code so there are fewer long regexes and less duplication between sanitize_email and is_email. A new class, WP_Email_Address, provides the shared parts.

Opting out of unicode support is easy, default-filters.php adds unicode support by adding filters, which can be removed.

sanitize_email no longer does major changes like removing an entire subdomain from someone's address, it only cleans up things like soft hyphens and whitespace — changes that happen when coping an email address from text.

Developed in: ​https://github.com/WordPress/wordpress-develop/pull/5237
Discussed in: https://core.trac.wordpress.org/ticket/31992

Props agulbra, akirk, benniledl, dmsnell, ironprogrammer, justlevine, mdawaffe, mukeshpanchal27, SirLouen, tusharbharti.
Fixes #31992.

File:

• trunk/tests/phpunit/tests/formatting/sanitizeEmail.php (modified) (1 diff)

trunk/tests/phpunit/tests/formatting/sanitizeEmail.php

@@ -42 +42 @@
     public function data_sanitized_email_pairs() {
         return array(
-            'shorter than 6 characters'      => array( 'a@b', '' ),
-            'contains no @'                  => array( 'ab', '' ),
-            'just a TLD'                     => array( 'abc@com', '' ),
-            'plain'                          => array( 'abc@example.com', 'abc@example.com' ),
-            'invalid utf8 subdomain dropped' => array( "abc@sub.\x80.org", 'abc@sub.org' ),
-            'all subdomains invalid utf8'    => array( "abc@\x80.org", '' ),
+            'shorter than 6 characters'        => array( 'a@b', '' ),
+            'contains no @'                    => array( 'ab', '' ),
+            'just a TLD'                       => array( 'abc@com', '' ),
+            'plain'                            => array( 'abc@example.com', 'abc@example.com' ),
+            'unicode domain'                   => array( 'abc@grå.org', 'abc@grå.org' ),
+            'unicode local part'               => array( 'grå@example.com', 'grå@example.com' ),
+            'unicode local and domain'         => array( 'grå@grå.org', 'grå@grå.org' ),
+            'invalid utf8 in local'            => array( "a\x80b@example.com", '' ),
+            'invalid utf8 subdomain'           => array( "abc@sub.\x80.org", '' ),
+            'all subdomains invalid utf8'      => array( "abc@\x80.org", '' ),
+            'soft hyphen before dot'           => array( "info@example\xC2\xAD.com", 'info@example.com' ),
+            'soft hyphen after dot'            => array( "info@example.\xC2\xADcom", 'info@example.com' ),
+            'space before dot'                 => array( 'info@example .com', 'info@example.com' ),
+            'space after dot'                  => array( 'info@example. com', 'info@example.com' ),
+            'soft hyphen and space around dot' => array( "info@example \xC2\xAD.com", 'info@example.com' ),
+            'space around at sign'             => array( 'info @ example.com', 'info@example.com' ),
+            'soft hyphen before at sign'       => array( "info\xC2\xAD@example.com", 'info@example.com' ),
+            'display name with angle brackets' => array( 'Alice Example <alice@example.com>', 'alice@example.com' ),
+            'angle brackets only'              => array( '<alice@example.com>', 'alice@example.com' ),
+            'angle brackets invalid address'   => array( 'Alice <not-an-email>', '' ),
         );
     }