Adds Str:: convertCase() (#326)

* Adds `Str:: convertCase()`

Co-Authored-By: Deeka Wong <8337659+huangdijia@users.noreply.github.com>

* Cs Fix

Co-Authored-By: Deeka Wong <8337659+huangdijia@users.noreply.github.com>

---------

Co-authored-by: Deeka Wong <8337659+huangdijia@users.noreply.github.com>

output/Hyperf/HttpServer/Contract/RequestInterface.php

@@ -37,8 +37,6 @@ public function boolean($key = null, $default = false): bool;
 
     /**
      * Retrieve input from the request as a collection.
-     *
-     * @param array|string|null $key
      */
     public function collect(array|string|null $key = null): \Hyperf\Collection\Collection;
 

output/Hyperf/Stringable/Str.php

@@ -35,6 +35,29 @@ public static function classNamespace($value)
     {
     }
 
+    /**
+     * Convert the case of a string.
+     *
+     * @return string
+     */
+    public static function convertCase(string $string, int $mode = MB_CASE_FOLD, ?string $encoding = 'UTF-8')
+    {
+    }
+
+    /**
+     * Set the callable that will be used to generate UUIDs.
+     */
+    public static function createUuidsUsing(callable $factory = null)
+    {
+    }
+
+    /**
+     * Indicate that UUIDs should be created normally and not using a custom factory.
+     */
+    public static function createUuidsNormally()
+    {
+    }
+
     /**
      * Extracts an excerpt from text that matches the first instance of a phrase.
      *
@@ -207,20 +230,6 @@ public static function transliterate($string, $unknown = '?', $strict = false)
     {
     }
 
-    /**
-     * Set the callable that will be used to generate UUIDs.
-     */
-    public static function createUuidsUsing(callable $factory = null)
-    {
-    }
-
-    /**
-     * Indicate that UUIDs should be created normally and not using a custom factory.
-     */
-    public static function createUuidsNormally()
-    {
-    }
-
     /**
      * Split a string into pieces by uppercase characters.
      *

output/Hyperf/Stringable/Stringable.php

@@ -22,6 +22,17 @@ public function classNamespace()
     {
     }
 
+    /**
+     * Convert the case of a string.
+     *
+     * @param int $mode
+     * @param string $encoding
+     * @return static
+     */
+    public function convertCase($mode = MB_CASE_FOLD, $encoding = 'UTF-8')
+    {
+    }
+
     /**
      * Extracts an excerpt from text that matches the first instance of a phrase.
      *

src/StrMixin.php

@@ -49,6 +49,16 @@ public function classNamespace()
         };
     }
 
+    /**
+     * Convert the case of a string.
+     *
+     * @return string
+     */
+    public static function convertCase()
+    {
+        return fn (string $string, int $mode = MB_CASE_FOLD, ?string $encoding = 'UTF-8') => mb_convert_case($string, $mode, $encoding);
+    }
+
     public function createUuidsNormally()
     {
         return fn () => UuidContainer::$uuidFactory = null;

src/StringableMixin.php

@@ -35,6 +35,12 @@ public function classNamespace()
         return fn () => new static(Str::classNamespace($this->value));
     }
 
+    public function convertCase()
+    {
+        /* @phpstan-ignore-next-line */
+        return fn ($mode = MB_CASE_FOLD, $encoding = 'UTF-8') => new static(Str::convertCase($this->value, $mode, $encoding));
+    }
+
     public function excerpt()
     {
         /* @phpstan-ignore-next-line */