Add faker() helper

src/Illuminate/Support/Faker.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Illuminate\Support;
+
+use Exception;
+use Faker\Factory;
+use Faker\Generator;
+
+class Faker extends Factory
+{
+    public Generator $faker;
+
+    public function __construct()
+    {
+        $this->faker = self::create();
+    }
+
+    /**
+     * Check the given method name.
+     * Here we can choose to use our own method,
+     * Or call a faker method.
+     *
+     * @param  string  $name
+     * @param  array  $arguments
+     * @return mixed
+     */
+    public function __call(string $name, array $arguments)
+    {
+        return match ($name) {
+            'image', 'alt' => $this->faker->$name(),
+            default => $this->faker->$name(),
+        };
+    }
+
+    /**
+     * Returns a random picture from Lorem Picsum.
+     *
+     * @return string
+     */
+    public function image(): string
+    {
+        try {
+            $rand = random_int(1, 100);
+        } catch (Exception) {
+            $rand = 1;
+        }
+
+        return "https://picsum.photos/200/300?random=$rand";
+    }
+
+    /**
+     * Return a faker sentence to use for our random img.
+     *
+     * @return string
+     */
+    public function alt(): string
+    {
+        return $this->faker->sentence();
+    }
+}

src/Illuminate/Support/helpers.php

@@ -418,3 +418,27 @@ function with($value, callable $callback = null)
         return is_null($callback) ? $value : $callback($value);
     }
 }
+
+if (! function_exists('faker')) {
+    /**
+     * Called without a parameter gives a Faker instance.
+     * Called with an integer parameter gives a collection of Faker instances.
+     *
+     * @param  int|null  $count
+     * @return \Illuminate\Support\Collection|\Illuminate\Support\Faker
+     */
+    function faker(int $count = null): \Illuminate\Support\Collection|\Illuminate\Support\Faker
+    {
+        if (! $count) {
+            return new \Illuminate\Support\Faker();
+        }
+
+        $collection = collect([]);
+
+        for ($i = 0; $i < 10; $i++) {
+            $collection->push(new \Illuminate\Support\Faker());
+        }
+
+        return $collection;
+    }
+}

tests/Support/SupportFakerTest.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace Illuminate\Tests\Support;
+
+use Faker\Factory;
+use Illuminate\Support\Faker;
+use PHPUnit\Framework\TestCase;
+
+class SupportFakerTest extends TestCase
+{
+    public function testIsAChildOfFakerFactory()
+    {
+        $faker = faker();
+
+        $this->assertInstanceOf(Factory::class, $faker);
+    }
+
+    public function testAFakerHelperIsGloballyAvailable()
+    {
+        $faker = faker();
+
+        $this->assertInstanceOf(Faker::class, $faker);
+    }
+
+    public function testCanAcceptACount()
+    {
+        $faker = faker(10);
+
+        $this->assertCount(10, $faker);
+    }
+
+    public function testCollectionContainsFakerInstances()
+    {
+        $faker = faker(10);
+
+        $this->assertInstanceOf(Faker::class, $faker->first());
+    }
+
+    public function testCanReturnARandomName()
+    {
+        $name = faker()->name();
+
+        $this->assertIsString($name);
+    }
+
+    public function testCanReturnARandomNameWhenCreatedAsACollection()
+    {
+        $faker = faker(10);
+
+        $this->assertIsString($faker->first()->name());
+    }
+}