Merge pull request #17 from 15g-lucas/custom-extension

Explanation of how to create/use a customized extension

Author: GautierDele

content/1.getting-started/6.strategies.md content/1.getting-started/5.strategies.mdcontent/1.getting-started/6.strategies.md renamed to content/1.getting-started/5.strategies.md

@@ -0,0 +1,27 @@
+---
+title: Custom Extension
+description: Custom extension for Xefi Faker PHP
+---
+
+You can easily create a customized Faker extension. To do so, simply define a PHP class that extends the `Xefi\Faker\Extensions\Extension` class, and define the functions you wish to make available.
+
+## Example
+```php
+use Xefi\Faker\Extensions\Extension;
+
+class CustomEmailExtension extends Extension
+{
+    public function generateRandomEmail(string $domainName): mixed
+    {
+        $localPart = strtolower(bin2hex(random_bytes(4)));
+        return $localPart . '@' . $domainName;
+    }
+}
+```
+
+You'll also need to load your extension into Faker
+```php
+faker()->resolveExtensions([CustomEmailExtension::class])
+```
+
+