Handle simple comments in address lists

src/Header/AbstractAddressList.php

@@ -63,6 +63,7 @@ public static function fromString($headerLine)
             $values,
             function (&$value) {
                 $value = trim($value);
+                $value = self::stripComments($value);
             }
         );
 
@@ -155,4 +156,19 @@ public function toString()
         $value = $this->getFieldValue(HeaderInterface::FORMAT_ENCODED);
         return (empty($value)) ? '' : sprintf('%s: %s', $name, $value);
     }
+
+    // Supposed to be private, protected as a workaround for PHP bug 68194
+    protected static function stripComments($value)
+    {
+        return preg_replace(
+            '/\\(
+                (
+                    \\\\.|
+                    [^\\\\)]
+                )+
+            \\)/x',
+            '',
+            $value
+        );
+    }
 }

test/Header/AddressListHeaderTest.php

@@ -145,6 +145,26 @@ public function getStringHeadersWithNoWhitespaceSeparator()
         ];
     }
 
+    /**
+     * @dataProvider getHeadersWithComments
+     */
+    public function testDeserializationFromStringWithComments($value)
+    {
+        $header = From::fromString($value);
+        $list = $header->getAddressList();
+        $this->assertEquals(1, count($list));
+        $this->assertTrue($list->has('user@example.com'));
+    }
+
+    public function getHeadersWithComments()
+    {
+        return [
+            ['From: user@example.com (Comment)'],
+            ['From: user@example.com (Comm\\)ent)'],
+            ['From: (Comment\\\\)user@example.com(Another)'],
+        ];
+    }
+
     /**
      * @group 3789
      * @dataProvider getStringHeadersWithNoWhitespaceSeparator