Use Hyperf\Stringable\Str instead of Hyperf\Utils\Str (#5634)

Author: huangdijia

composer.json

@@ -30,7 +30,10 @@
     "autoload": {
         "psr-4": {
             "Hyperf\\Stringable\\": "src/"
-        }
+        },
+        "files": [
+            "src/Functions.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": {

src/Functions.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of Hyperf.
+ *
+ * @link     https://www.hyperf.io
+ * @document https://hyperf.wiki
+ * @contact  [email protected]
+ * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
+ */
+namespace Hyperf\Stringable;
+
+/**
+ * Get a new stringable object from the given string.
+ *
+ * @param null|string $string
+ * @return mixed|Stringable
+ */
+function str($string = null)
+{
+    if (func_num_args() === 0) {
+        return new class() {
+            public function __call($method, $parameters)
+            {
+                return Str::$method(...$parameters);
+            }
+
+            public function __toString()
+            {
+                return '';
+            }
+        };
+    }
+
+    return Str::of($string);
+}

tests/FunctionsTest.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of Hyperf.
+ *
+ * @link     https://www.hyperf.io
+ * @document https://hyperf.wiki
+ * @contact  [email protected]
+ * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
+ */
+namespace HyperfTest\Stringable;
+
+use Hyperf\Stringable\Stringable;
+use PHPUnit\Framework\TestCase;
+use ReflectionClass;
+
+use function Hyperf\Stringable\str;
+
+/**
+ * @internal
+ * @coversNothing
+ */
+class FunctionsTest extends TestCase
+{
+    public function testStr()
+    {
+        $stringable = str('string-value');
+
+        $this->assertInstanceOf(Stringable::class, $stringable);
+        $this->assertSame('string-value', (string) $stringable);
+
+        $stringable = str($name = null);
+        $this->assertInstanceOf(Stringable::class, $stringable);
+        $this->assertTrue($stringable->isEmpty());
+
+        $strAccessor = str();
+        $this->assertTrue((new ReflectionClass($strAccessor))->isAnonymous());
+        $this->assertSame($strAccessor->limit('string-value', 3), 'str...');
+
+        $strAccessor = str();
+        $this->assertTrue((new ReflectionClass($strAccessor))->isAnonymous());
+        $this->assertSame((string) $strAccessor, '');
+    }
+}