Merge pull request #8476 from kenjis/docs-fabricator.rst

docs: update fabricator.rst

Author: kenjis

user_guide_src/source/testing/fabricator.rst

@@ -3,7 +3,7 @@ Generating Test Data
 ####################
 
 Often you will need sample data for your application to run its tests. The ``Fabricator`` class
-uses fzaninotto's `Faker <https://github.com/FakerPHP/Faker>`_ to turn models into generators
+uses `Faker <https://github.com/FakerPHP/Faker>`_ to turn models into generators
 of random data. Use fabricators in your seeds or test cases to stage fake data for your unit tests.
 
 .. contents::
@@ -56,6 +56,7 @@ method where you can define exactly what the faked data should look like:
 Notice in this example how the first three values are equivalent to the formatters from before. However for ``avatar``
 we have requested an image size other than the default and ``login`` uses a conditional based on app configuration,
 neither of which are possible using the ``$formatters`` parameter.
+
 You may want to keep your test data separate from your production models, so it is a good practice to define
 a child class in your test support folder:
 

user_guide_src/source/testing/fabricator/005.php

@@ -2,28 +2,30 @@
 
 namespace App\Models;
 
+use Faker\Generator;
+
 class UserModel
 {
     // ...
 
     public function fake(Generator &$faker)
     {
         return [
-            'first'  => $faker->firstName,
-            'email'  => $faker->email,
-            'phone'  => $faker->phoneNumber,
-            'avatar' => Faker\Provider\Image::imageUrl(800, 400),
+            'first'  => $faker->firstName(),
+            'email'  => $faker->email(),
+            'phone'  => $faker->phoneNumber(),
+            'avatar' => \Faker\Provider\Image::imageUrl(800, 400),
             'login'  => config('Auth')->allowRemembering ? date('Y-m-d') : null,
         ];
 
         /*
          * Or you can return a return type object.
 
         return new User([
-            'first'  => $faker->firstName,
-            'email'  => $faker->email,
-            'phone'  => $faker->phoneNumber,
-            'avatar' => Faker\Provider\Image::imageUrl(800, 400),
+            'first'  => $faker->firstName(),
+            'email'  => $faker->email(),
+            'phone'  => $faker->phoneNumber(),
+            'avatar' => \Faker\Provider\Image::imageUrl(800, 400),
             'login'  => config('Auth')->allowRemembering ? date('Y-m-d') : null,
         ]);
 

user_guide_src/source/testing/fabricator/006.php

@@ -3,10 +3,11 @@
 namespace Tests\Support\Models;
 
 use App\Models\UserModel;
+use Faker\Generator;
 
 class UserFabricator extends UserModel
 {
-    public function fake(&$faker)
+    public function fake(Generator &$faker)
     {
         // ...
     }

user_guide_src/source/testing/fabricator/008.php

@@ -1,7 +1,8 @@
 <?php
 
 use CodeIgniter\Test\Fabricator;
+use Tests\Support\Models\UserFabricator;
 
-$fabricator = new Fabricator(\UserFabricator::class);
+$fabricator = new Fabricator(UserFabricator::class);
 $testUser   = $fabricator->make();
 print_r($testUser);

user_guide_src/source/testing/fabricator/021.php

@@ -2,15 +2,18 @@
 
 namespace App\Models;
 
+use CodeIgniter\Test\Fabricator;
+use Faker\Generator;
+
 class UserModel
 {
     protected $table = 'users';
 
     public function fake(Generator &$faker)
     {
         return [
-            'first'    => $faker->firstName,
-            'email'    => $faker->email,
+            'first'    => $faker->firstName(),
+            'email'    => $faker->email(),
             'group_id' => mt_rand(1, Fabricator::getCount('groups')),
         ];
     }