[9.x] Add missing Str::wrap() static method (#44207)

* Move wrap to Str static method

* Add tests

Author: stevebauman

src/Illuminate/Support/Str.php

@@ -338,6 +338,18 @@ public static function finish($value, $cap)
         return preg_replace('/(?:'.$quoted.')+$/u', '', $value).$cap;
     }
 
+    /**
+     * Wrap the string with the given strings.
+     *
+     * @param  string  $before
+     * @param  string|null  $after
+     * @return string
+     */
+    public static function wrap($value, $before, $after = null)
+    {
+        return $before.$value.($after ??= $before);
+    }
+
     /**
      * Determine if a given string matches a given pattern.
      *

src/Illuminate/Support/Stringable.php

@@ -1060,7 +1060,7 @@ public function wordCount()
      */
     public function wrap($before, $after = null)
     {
-        return new static($before.$this->value.($after ??= $before));
+        return new static(Str::wrap($this->value, $before, $after));
     }
 
     /**

tests/Support/SupportStrTest.php

@@ -352,6 +352,12 @@ public function testFinish()
         $this->assertSame('abcbbc', Str::finish('abcbbcbc', 'bc'));
     }
 
+    public function testWrap()
+    {
+        $this->assertEquals('"value"', Str::wrap('value', '"'));
+        $this->assertEquals('foo-bar-baz', Str::wrap('-bar-', 'foo', 'baz'));
+    }
+
     public function testIs()
     {
         $this->assertTrue(Str::is('/', '/'));