[2.7] Add Utils::redactUserInfo() method (#613)

* Add `Utils::redactUserInfo()` method

Co-Authored-By: Tim Düsterhus <209270+timwolla@users.noreply.github.com>

* Update Utils.php

---------

Co-authored-by: Tim Düsterhus <209270+timwolla@users.noreply.github.com>

Author: GrahamCampbell

README.md

@@ -503,6 +503,13 @@ a message.
 Read a line from the stream up to the maximum allowed buffer length.
 
 
+## `GuzzleHttp\Psr7\Utils::redactUserInfo`
+
+`public static function redactUserInfo(UriInterface $uri): UriInterface`
+
+Redact the password in the user info part of a URI.
+
+
 ## `GuzzleHttp\Psr7\Utils::streamFor`
 
 `public static function streamFor(resource|string|null|int|float|bool|StreamInterface|callable|\Iterator $resource = '', array $options = []): StreamInterface`

src/Utils.php

@@ -250,6 +250,20 @@ public static function readLine(StreamInterface $stream, ?int $maxLength = null)
         return $buffer;
     }
 
+    /**
+     * Redact the password in the user info part of a URI.
+     */
+    public static function redactUserInfo(UriInterface $uri): UriInterface
+    {
+        $userInfo = $uri->getUserInfo();
+
+        if (false !== ($pos = \strpos($userInfo, ':'))) {
+            return $uri->withUserInfo(\substr($userInfo, 0, $pos), '***');
+        }
+
+        return $uri;
+    }
+
     /**
      * Create a new stream based on the input type.
      *

tests/UtilsTest.php

@@ -154,6 +154,15 @@ public function testReadsLineUntilEmptyStringReturnedFromRead(): void
         self::assertSame('h', Psr7\Utils::readLine($s));
     }
 
+    public function testRedactUserInfo(): void
+    {
+        $uri = new Psr7\Uri('http://my_user:secretPass@localhost/');
+
+        $redactedUri = Psr7\Utils::redactUserInfo($uri);
+
+        self::assertSame('http://my_user:***@localhost/', (string) $redactedUri);
+    }
+
     public function testCalculatesHash(): void
     {
         $s = Psr7\Utils::streamFor('foobazbar');