[9.x] Retrieve the underlying string value in Stringable (#40861)

* Add method to retrieve the underlying string value

* rename method

Co-authored-by: Taylor Otwell <[email protected]>

Author: cerbero90

src/Illuminate/Support/Stringable.php

@@ -992,6 +992,26 @@ public function dd()
         exit(1);
     }
 
+    /**
+     * Get the underlying string value.
+     *
+     * @return string
+     */
+    public function value()
+    {
+        return $this->toString();
+    }
+
+    /**
+     * Get the underlying string value.
+     *
+     * @return string
+     */
+    public function toString()
+    {
+        return $this->value;
+    }
+
     /**
      * Convert the object to a string when JSON encoded.
      *

tests/Support/SupportStringableTest.php

@@ -943,4 +943,10 @@ public function testScan()
         $this->assertSame(['Otwell', 'Taylor'], $this->stringable('Otwell, Taylor')->scan('%[^,],%s')->toArray());
         $this->assertSame(['filename', 'jpg'], $this->stringable('filename.jpg')->scan('%[^.].%s')->toArray());
     }
+
+    public function testGet()
+    {
+        $this->assertSame('foo', $this->stringable('foo')->value());
+        $this->assertSame('foo', $this->stringable('foo')->toString());
+    }
 }