First Commit

vendor/fakerphp/faker/src/Faker/Calculator/Ean.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Faker\Calculator;
+
+/**
+ * Utility class for validating EAN-8 and EAN-13 numbers
+ */
+class Ean
+{
+    /**
+     * @var string EAN validation pattern
+     */
+    public const PATTERN = '/^(?:\d{8}|\d{13})$/';
+
+    /**
+     * Computes the checksum of an EAN number.
+     *
+     * @see https://en.wikipedia.org/wiki/International_Article_Number
+     *
+     * @return int
+     */
+    public static function checksum(string $digits)
+    {
+        $sequence = (strlen($digits) + 1) === 8 ? [3, 1] : [1, 3];
+        $sums = 0;
+
+        foreach (str_split($digits) as $n => $digit) {
+            $sums += ((int) $digit) * $sequence[$n % 2];
+        }
+
+        return (10 - $sums % 10) % 10;
+    }
+
+    /**
+     * Checks whether the provided number is an EAN compliant number and that
+     * the checksum is correct.
+     *
+     * @param string $ean An EAN number
+     *
+     * @return bool
+     */
+    public static function isValid(string $ean)
+    {
+        if (!preg_match(self::PATTERN, $ean)) {
+            return false;
+        }
+
+        return self::checksum(substr($ean, 0, -1)) === (int) substr($ean, -1);
+    }
+}

vendor/fakerphp/faker/src/Faker/Calculator/Iban.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Faker\Calculator;
+
+class Iban
+{
+    /**
+     * Generates IBAN Checksum
+     *
+     * @return string Checksum (numeric string)
+     */
+    public static function checksum(string $iban)
+    {
+        // Move first four digits to end and set checksum to '00'
+        $checkString = substr($iban, 4) . substr($iban, 0, 2) . '00';
+
+        // Replace all letters with their number equivalents
+        $checkString = preg_replace_callback(
+            '/[A-Z]/',
+            static function (array $matches): string {
+                return (string) self::alphaToNumber($matches[0]);
+            },
+            $checkString,
+        );
+
+        // Perform mod 97 and subtract from 98
+        $checksum = 98 - self::mod97($checkString);
+
+        return str_pad($checksum, 2, '0', STR_PAD_LEFT);
+    }
+
+    /**
+     * Converts letter to number
+     *
+     * @return int
+     */
+    public static function alphaToNumber(string $char)
+    {
+        return ord($char) - 55;
+    }
+
+    /**
+     * Calculates mod97 on a numeric string
+     *
+     * @param string $number Numeric string
+     *
+     * @return int
+     */
+    public static function mod97(string $number)
+    {
+        $checksum = (int) $number[0];
+
+        for ($i = 1, $size = strlen($number); $i < $size; ++$i) {
+            $checksum = (10 * $checksum + (int) $number[$i]) % 97;
+        }
+
+        return $checksum;
+    }
+
+    /**
+     * Checks whether an IBAN has a valid checksum
+     *
+     * @return bool
+     */
+    public static function isValid(string $iban)
+    {
+        return self::checksum($iban) === substr($iban, 2, 2);
+    }
+}

vendor/fakerphp/faker/src/Faker/Calculator/Inn.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Faker\Calculator;
+
+/**
+ * @deprecated moved to ru_RU\Company, use {@link \Faker\Provider\ru_RU\Company}.
+ * @see \Faker\Provider\ru_RU\Company
+ */
+class Inn
+{
+    /**
+     * Generates INN Checksum
+     *
+     * https://ru.wikipedia.org/wiki/%D0%98%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B9_%D0%BD%D0%BE%D0%BC%D0%B5%D1%80_%D0%BD%D0%B0%D0%BB%D0%BE%D0%B3%D0%BE%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D1%89%D0%B8%D0%BA%D0%B0
+     *
+     * @param string $inn
+     *
+     * @return string Checksum (one digit)
+     *
+     * @deprecated use {@link \Faker\Provider\ru_RU\Company::inn10Checksum()} instead
+     * @see \Faker\Provider\ru_RU\Company::inn10Checksum()
+     */
+    public static function checksum($inn)
+    {
+        return \Faker\Provider\ru_RU\Company::inn10Checksum($inn);
+    }
+
+    /**
+     * Checks whether an INN has a valid checksum
+     *
+     * @param string $inn
+     *
+     * @return bool
+     *
+     * @deprecated use {@link \Faker\Provider\ru_RU\Company::inn10IsValid()} instead
+     * @see \Faker\Provider\ru_RU\Company::inn10IsValid()
+     */
+    public static function isValid($inn)
+    {
+        return \Faker\Provider\ru_RU\Company::inn10IsValid($inn);
+    }
+}

vendor/fakerphp/faker/src/Faker/Calculator/Isbn.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Faker\Calculator;
+
+/**
+ * Utility class for validating ISBN-10
+ */
+class Isbn
+{
+    /**
+     * @var string ISBN-10 validation pattern
+     */
+    public const PATTERN = '/^\d{9}[0-9X]$/';
+
+    /**
+     * ISBN-10 check digit
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number#ISBN-10_check_digits
+     *
+     * @param string $input ISBN without check-digit
+     *
+     * @throws \LengthException When wrong input length passed
+     */
+    public static function checksum(string $input): string
+    {
+        // We're calculating check digit for ISBN-10
+        // so, the length of the input should be 9
+        $length = 9;
+
+        if (strlen($input) !== $length) {
+            throw new \LengthException(sprintf('Input length should be equal to %d', $length));
+        }
+
+        $digits = str_split($input);
+        array_walk(
+            $digits,
+            static function (&$digit, $position): void {
+                $digit = (10 - $position) * $digit;
+            },
+        );
+        $result = (11 - array_sum($digits) % 11) % 11;
+
+        // 10 is replaced by X
+        return ($result < 10) ? (string) $result : 'X';
+    }
+
+    /**
+     * Checks whether the provided number is a valid ISBN-10 number
+     *
+     * @param string $isbn ISBN to check
+     */
+    public static function isValid(string $isbn): bool
+    {
+        if (!preg_match(self::PATTERN, $isbn)) {
+            return false;
+        }
+
+        return self::checksum(substr($isbn, 0, -1)) === substr($isbn, -1);
+    }
+}

vendor/fakerphp/faker/src/Faker/Calculator/Luhn.php

@@ -0,0 +1,72 @@
+<?php
+
+namespace Faker\Calculator;
+
+/**
+ * Utility class for generating and validating Luhn numbers.
+ *
+ * Luhn algorithm is used to validate credit card numbers, IMEI numbers, and
+ * National Provider Identifier numbers.
+ *
+ * @see http://en.wikipedia.org/wiki/Luhn_algorithm
+ */
+class Luhn
+{
+    /**
+     * @return int
+     */
+    private static function checksum(string $number)
+    {
+        $number = (string) $number;
+        $length = strlen($number);
+        $sum = 0;
+
+        for ($i = $length - 1; $i >= 0; $i -= 2) {
+            $sum += $number[$i];
+        }
+
+        for ($i = $length - 2; $i >= 0; $i -= 2) {
+            $sum += array_sum(str_split($number[$i] * 2));
+        }
+
+        return $sum % 10;
+    }
+
+    /**
+     * @return string
+     */
+    public static function computeCheckDigit(string $partialNumber)
+    {
+        $checkDigit = self::checksum($partialNumber . '0');
+
+        if ($checkDigit === 0) {
+            return '0';
+        }
+
+        return (string) (10 - $checkDigit);
+    }
+
+    /**
+     * Checks whether a number (partial number + check digit) is Luhn compliant
+     *
+     * @return bool
+     */
+    public static function isValid(string $number)
+    {
+        return self::checksum($number) === 0;
+    }
+
+    /**
+     * Generate a Luhn compliant number.
+     *
+     * @return string
+     */
+    public static function generateLuhnNumber(string $partialValue)
+    {
+        if (!preg_match('/^\d+$/', $partialValue)) {
+            throw new \InvalidArgumentException('Argument should be an integer.');
+        }
+
+        return $partialValue . Luhn::computeCheckDigit($partialValue);
+    }
+}

vendor/fakerphp/faker/src/Faker/Calculator/TCNo.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Faker\Calculator;
+
+/**
+ * @deprecated moved to tr_TR\Person, use {@link \Faker\Provider\tr_TR\Person}.
+ * @see \Faker\Provider\tr_TR\Person
+ */
+class TCNo
+{
+    /**
+     * Generates Turkish Identity Number Checksum
+     * Gets first 9 digit as prefix and calculates checksum
+     *
+     * https://en.wikipedia.org/wiki/Turkish_Identification_Number
+     *
+     * @param string $identityPrefix
+     *
+     * @return string Checksum (two digit)
+     *
+     * @deprecated use {@link \Faker\Provider\tr_TR\Person::tcNoChecksum()} instead
+     * @see \Faker\Provider\tr_TR\Person::tcNoChecksum()
+     */
+    public static function checksum($identityPrefix)
+    {
+        return \Faker\Provider\tr_TR\Person::tcNoChecksum($identityPrefix);
+    }
+
+    /**
+     * Checks whether a TCNo has a valid checksum
+     *
+     * @param string $tcNo
+     *
+     * @return bool
+     *
+     * @deprecated use {@link \Faker\Provider\tr_TR\Person::tcNoIsValid()} instead
+     * @see \Faker\Provider\tr_TR\Person::tcNoIsValid()
+     */
+    public static function isValid($tcNo)
+    {
+        return \Faker\Provider\tr_TR\Person::tcNoIsValid($tcNo);
+    }
+}

vendor/fakerphp/faker/src/Faker/ChanceGenerator.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Faker;
+
+use Faker\Extension\Extension;
+
+/**
+ * This generator returns a default value for all called properties
+ * and methods. It works with Faker\Generator::optional().
+ *
+ * @mixin Generator
+ */
+class ChanceGenerator
+{
+    private $generator;
+    private $weight;
+    protected $default;
+
+    /**
+     * @param Extension|Generator $generator
+     */
+    public function __construct($generator, float $weight, $default = null)
+    {
+        $this->default = $default;
+        $this->generator = $generator;
+        $this->weight = $weight;
+    }
+
+    public function ext(string $id)
+    {
+        return new self($this->generator->ext($id), $this->weight, $this->default);
+    }
+
+    /**
+     * Catch and proxy all generator calls but return only valid values
+     *
+     * @param string $attribute
+     *
+     * @deprecated Use a method instead.
+     */
+    public function __get($attribute)
+    {
+        trigger_deprecation('fakerphp/faker', '1.14', 'Accessing property "%s" is deprecated, use "%s()" instead.', $attribute, $attribute);
+
+        return $this->__call($attribute, []);
+    }
+
+    /**
+     * @param string $name
+     * @param array  $arguments
+     */
+    public function __call($name, $arguments)
+    {
+        if (mt_rand(1, 100) <= (100 * $this->weight)) {
+            return call_user_func_array([$this->generator, $name], $arguments);
+        }
+
+        return $this->default;
+    }
+}

vendor/fakerphp/faker/src/Faker/Container/Container.php

@@ -0,0 +1,139 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Container;
+
+use Faker\Extension\Extension;
+
+/**
+ * A simple implementation of a container.
+ *
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Container implements ContainerInterface
+{
+    /**
+     * @var array<string, callable|object|string>
+     */
+    private array $definitions;
+
+    private array $services = [];
+
+    /**
+     * Create a container object with a set of definitions. The array value MUST
+     * produce an object that implements Extension.
+     *
+     * @param array<string, callable|object|string> $definitions
+     */
+    public function __construct(array $definitions)
+    {
+        $this->definitions = $definitions;
+    }
+
+    /**
+     * Retrieve a definition from the container.
+     *
+     * @param string $id
+     *
+     * @throws \InvalidArgumentException
+     * @throws \RuntimeException
+     * @throws ContainerException
+     * @throws NotInContainerException
+     */
+    public function get($id): Extension
+    {
+        if (!is_string($id)) {
+            throw new \InvalidArgumentException(sprintf(
+                'First argument of %s::get() must be string',
+                self::class,
+            ));
+        }
+
+        if (array_key_exists($id, $this->services)) {
+            return $this->services[$id];
+        }
+
+        if (!$this->has($id)) {
+            throw new NotInContainerException(sprintf(
+                'There is not service with id "%s" in the container.',
+                $id,
+            ));
+        }
+
+        $definition = $this->definitions[$id];
+
+        $service = $this->getService($id, $definition);
+
+        if (!$service instanceof Extension) {
+            throw new \RuntimeException(sprintf(
+                'Service resolved for identifier "%s" does not implement the %s" interface.',
+                $id,
+                Extension::class,
+            ));
+        }
+
+        $this->services[$id] = $service;
+
+        return $service;
+    }
+
+    /**
+     * Get the service from a definition.
+     *
+     * @param callable|object|string $definition
+     */
+    private function getService(string $id, $definition)
+    {
+        if (is_callable($definition)) {
+            try {
+                return $definition();
+            } catch (\Throwable $e) {
+                throw new ContainerException(
+                    sprintf('Error while invoking callable for "%s"', $id),
+                    0,
+                    $e,
+                );
+            }
+        } elseif (is_object($definition)) {
+            return $definition;
+        } elseif (is_string($definition)) {
+            if (class_exists($definition)) {
+                try {
+                    return new $definition();
+                } catch (\Throwable $e) {
+                    throw new ContainerException(sprintf('Could not instantiate class "%s"', $id), 0, $e);
+                }
+            }
+
+            throw new ContainerException(sprintf(
+                'Could not instantiate class "%s". Class was not found.',
+                $id,
+            ));
+        } else {
+            throw new ContainerException(sprintf(
+                'Invalid type for definition with id "%s"',
+                $id,
+            ));
+        }
+    }
+
+    /**
+     * Check if the container contains a given identifier.
+     *
+     * @param string $id
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function has($id): bool
+    {
+        if (!is_string($id)) {
+            throw new \InvalidArgumentException(sprintf(
+                'First argument of %s::get() must be string',
+                self::class,
+            ));
+        }
+
+        return array_key_exists($id, $this->definitions);
+    }
+}

vendor/fakerphp/faker/src/Faker/Container/ContainerBuilder.php

@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Container;
+
+use Faker\Core;
+use Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class ContainerBuilder
+{
+    /**
+     * @var array<string, callable|object|string>
+     */
+    private array $definitions = [];
+
+    /**
+     * @param callable|object|string $definition
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function add(string $id, $definition): self
+    {
+        if (!is_string($definition) && !is_callable($definition) && !is_object($definition)) {
+            throw new \InvalidArgumentException(sprintf(
+                'First argument to "%s::add()" must be a string, callable or object.',
+                self::class,
+            ));
+        }
+
+        $this->definitions[$id] = $definition;
+
+        return $this;
+    }
+
+    public function build(): ContainerInterface
+    {
+        return new Container($this->definitions);
+    }
+
+    private static function defaultExtensions(): array
+    {
+        return [
+            Extension\BarcodeExtension::class => Core\Barcode::class,
+            Extension\BloodExtension::class => Core\Blood::class,
+            Extension\ColorExtension::class => Core\Color::class,
+            Extension\DateTimeExtension::class => Core\DateTime::class,
+            Extension\FileExtension::class => Core\File::class,
+            Extension\NumberExtension::class => Core\Number::class,
+            Extension\UuidExtension::class => Core\Uuid::class,
+            Extension\VersionExtension::class => Core\Version::class,
+        ];
+    }
+
+    public static function withDefaultExtensions(): self
+    {
+        $instance = new self();
+
+        foreach (self::defaultExtensions() as $id => $definition) {
+            $instance->add($id, $definition);
+        }
+
+        return $instance;
+    }
+}

vendor/fakerphp/faker/src/Faker/Container/ContainerException.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Container;
+
+use Psr\Container\ContainerExceptionInterface;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class ContainerException extends \RuntimeException implements ContainerExceptionInterface
+{
+}

vendor/fakerphp/faker/src/Faker/Container/ContainerInterface.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Faker\Container;
+
+use Psr\Container\ContainerInterface as BaseContainerInterface;
+
+interface ContainerInterface extends BaseContainerInterface
+{
+}

vendor/fakerphp/faker/src/Faker/Container/NotInContainerException.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Container;
+
+use Psr\Container\NotFoundExceptionInterface;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class NotInContainerException extends \RuntimeException implements NotFoundExceptionInterface
+{
+}

vendor/fakerphp/faker/src/Faker/Core/Barcode.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Core;
+
+use Faker\Calculator;
+use Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Barcode implements Extension\BarcodeExtension
+{
+    private Extension\NumberExtension $numberExtension;
+
+    public function __construct(?Extension\NumberExtension $numberExtension = null)
+    {
+        $this->numberExtension = $numberExtension ?: new Number();
+    }
+
+    private function ean(int $length = 13): string
+    {
+        $code = Extension\Helper::numerify(str_repeat('#', $length - 1));
+
+        return sprintf('%s%s', $code, Calculator\Ean::checksum($code));
+    }
+
+    public function ean13(): string
+    {
+        return $this->ean();
+    }
+
+    public function ean8(): string
+    {
+        return $this->ean(8);
+    }
+
+    public function isbn10(): string
+    {
+        $code = Extension\Helper::numerify(str_repeat('#', 9));
+
+        return sprintf('%s%s', $code, Calculator\Isbn::checksum($code));
+    }
+
+    public function isbn13(): string
+    {
+        $code = '97' . $this->numberExtension->numberBetween(8, 9) . Extension\Helper::numerify(str_repeat('#', 9));
+
+        return sprintf('%s%s', $code, Calculator\Ean::checksum($code));
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/Blood.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Core;
+
+use Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Blood implements Extension\BloodExtension
+{
+    /**
+     * @var string[]
+     */
+    private array $bloodTypes = ['A', 'AB', 'B', 'O'];
+
+    /**
+     * @var string[]
+     */
+    private array $bloodRhFactors = ['+', '-'];
+
+    public function bloodType(): string
+    {
+        return Extension\Helper::randomElement($this->bloodTypes);
+    }
+
+    public function bloodRh(): string
+    {
+        return Extension\Helper::randomElement($this->bloodRhFactors);
+    }
+
+    public function bloodGroup(): string
+    {
+        return sprintf(
+            '%s%s',
+            $this->bloodType(),
+            $this->bloodRh(),
+        );
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/Color.php

@@ -0,0 +1,177 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Core;
+
+use Faker\Extension;
+use Faker\Extension\Helper;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Color implements Extension\ColorExtension
+{
+    private Extension\NumberExtension $numberExtension;
+
+    /**
+     * @var string[]
+     */
+    private array $safeColorNames = [
+        'black', 'maroon', 'green', 'navy', 'olive',
+        'purple', 'teal', 'lime', 'blue', 'silver',
+        'gray', 'yellow', 'fuchsia', 'aqua', 'white',
+    ];
+    /**
+     * @var string[]
+     */
+    private array $allColorNames = [
+        'AliceBlue', 'AntiqueWhite', 'Aqua', 'Aquamarine',
+        'Azure', 'Beige', 'Bisque', 'Black', 'BlanchedAlmond',
+        'Blue', 'BlueViolet', 'Brown', 'BurlyWood', 'CadetBlue',
+        'Chartreuse', 'Chocolate', 'Coral', 'CornflowerBlue',
+        'Cornsilk', 'Crimson', 'Cyan', 'DarkBlue', 'DarkCyan',
+        'DarkGoldenRod', 'DarkGray', 'DarkGreen', 'DarkKhaki',
+        'DarkMagenta', 'DarkOliveGreen', 'Darkorange', 'DarkOrchid',
+        'DarkRed', 'DarkSalmon', 'DarkSeaGreen', 'DarkSlateBlue',
+        'DarkSlateGray', 'DarkTurquoise', 'DarkViolet', 'DeepPink',
+        'DeepSkyBlue', 'DimGray', 'DimGrey', 'DodgerBlue', 'FireBrick',
+        'FloralWhite', 'ForestGreen', 'Fuchsia', 'Gainsboro', 'GhostWhite',
+        'Gold', 'GoldenRod', 'Gray', 'Green', 'GreenYellow', 'HoneyDew',
+        'HotPink', 'IndianRed', 'Indigo', 'Ivory', 'Khaki', 'Lavender',
+        'LavenderBlush', 'LawnGreen', 'LemonChiffon', 'LightBlue', 'LightCoral',
+        'LightCyan', 'LightGoldenRodYellow', 'LightGray', 'LightGreen', 'LightPink',
+        'LightSalmon', 'LightSeaGreen', 'LightSkyBlue', 'LightSlateGray', 'LightSteelBlue',
+        'LightYellow', 'Lime', 'LimeGreen', 'Linen', 'Magenta', 'Maroon', 'MediumAquaMarine',
+        'MediumBlue', 'MediumOrchid', 'MediumPurple', 'MediumSeaGreen', 'MediumSlateBlue',
+        'MediumSpringGreen', 'MediumTurquoise', 'MediumVioletRed', 'MidnightBlue',
+        'MintCream', 'MistyRose', 'Moccasin', 'NavajoWhite', 'Navy', 'OldLace', 'Olive',
+        'OliveDrab', 'Orange', 'OrangeRed', 'Orchid', 'PaleGoldenRod', 'PaleGreen',
+        'PaleTurquoise', 'PaleVioletRed', 'PapayaWhip', 'PeachPuff', 'Peru', 'Pink', 'Plum',
+        'PowderBlue', 'Purple', 'Red', 'RosyBrown', 'RoyalBlue', 'SaddleBrown', 'Salmon',
+        'SandyBrown', 'SeaGreen', 'SeaShell', 'Sienna', 'Silver', 'SkyBlue', 'SlateBlue',
+        'SlateGray', 'Snow', 'SpringGreen', 'SteelBlue', 'Tan', 'Teal', 'Thistle', 'Tomato',
+        'Turquoise', 'Violet', 'Wheat', 'White', 'WhiteSmoke', 'Yellow', 'YellowGreen',
+    ];
+
+    public function __construct(?Extension\NumberExtension $numberExtension = null)
+    {
+        $this->numberExtension = $numberExtension ?: new Number();
+    }
+
+    /**
+     * @example '#fa3cc2'
+     */
+    public function hexColor(): string
+    {
+        return '#' . str_pad(dechex($this->numberExtension->numberBetween(1, 16777215)), 6, '0', STR_PAD_LEFT);
+    }
+
+    /**
+     * @example '#ff0044'
+     */
+    public function safeHexColor(): string
+    {
+        $color = str_pad(dechex($this->numberExtension->numberBetween(0, 255)), 3, '0', STR_PAD_LEFT);
+
+        return sprintf(
+            '#%s%s%s%s%s%s',
+            $color[0],
+            $color[0],
+            $color[1],
+            $color[1],
+            $color[2],
+            $color[2],
+        );
+    }
+
+    /**
+     * @example 'array(0,255,122)'
+     *
+     * @return int[]
+     */
+    public function rgbColorAsArray(): array
+    {
+        $color = $this->hexColor();
+
+        return [
+            hexdec(substr($color, 1, 2)),
+            hexdec(substr($color, 3, 2)),
+            hexdec(substr($color, 5, 2)),
+        ];
+    }
+
+    /**
+     * @example '0,255,122'
+     */
+    public function rgbColor(): string
+    {
+        return implode(',', $this->rgbColorAsArray());
+    }
+
+    /**
+     * @example 'rgb(0,255,122)'
+     */
+    public function rgbCssColor(): string
+    {
+        return sprintf(
+            'rgb(%s)',
+            $this->rgbColor(),
+        );
+    }
+
+    /**
+     * @example 'rgba(0,255,122,0.8)'
+     */
+    public function rgbaCssColor(): string
+    {
+        return sprintf(
+            'rgba(%s,%s)',
+            $this->rgbColor(),
+            $this->numberExtension->randomFloat(1, 0, 1),
+        );
+    }
+
+    /**
+     * @example 'blue'
+     */
+    public function safeColorName(): string
+    {
+        return Helper::randomElement($this->safeColorNames);
+    }
+
+    /**
+     * @example 'NavajoWhite'
+     */
+    public function colorName(): string
+    {
+        return Helper::randomElement($this->allColorNames);
+    }
+
+    /**
+     * @example '340,50,20'
+     */
+    public function hslColor(): string
+    {
+        return sprintf(
+            '%s,%s,%s',
+            $this->numberExtension->numberBetween(0, 360),
+            $this->numberExtension->numberBetween(0, 100),
+            $this->numberExtension->numberBetween(0, 100),
+        );
+    }
+
+    /**
+     * @example array(340, 50, 20)
+     *
+     * @return int[]
+     */
+    public function hslColorAsArray(): array
+    {
+        return [
+            $this->numberExtension->numberBetween(0, 360),
+            $this->numberExtension->numberBetween(0, 100),
+            $this->numberExtension->numberBetween(0, 100),
+        ];
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/Coordinates.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Core;
+
+use Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Coordinates implements Extension\Extension
+{
+    private Extension\NumberExtension $numberExtension;
+
+    public function __construct(?Extension\NumberExtension $numberExtension = null)
+    {
+        $this->numberExtension = $numberExtension ?: new Number();
+    }
+
+    /**
+     * @example '77.147489'
+     *
+     * @return float Uses signed degrees format (returns a float number between -90 and 90)
+     */
+    public function latitude(float $min = -90.0, float $max = 90.0): float
+    {
+        if ($min < -90 || $max < -90) {
+            throw new \LogicException('Latitude cannot be less that -90.0');
+        }
+
+        if ($min > 90 || $max > 90) {
+            throw new \LogicException('Latitude cannot be greater that 90.0');
+        }
+
+        return $this->randomFloat(6, $min, $max);
+    }
+
+    /**
+     * @example '86.211205'
+     *
+     * @return float Uses signed degrees format (returns a float number between -180 and 180)
+     */
+    public function longitude(float $min = -180.0, float $max = 180.0): float
+    {
+        if ($min < -180 || $max < -180) {
+            throw new \LogicException('Longitude cannot be less that -180.0');
+        }
+
+        if ($min > 180 || $max > 180) {
+            throw new \LogicException('Longitude cannot be greater that 180.0');
+        }
+
+        return $this->randomFloat(6, $min, $max);
+    }
+
+    /**
+     * @example array('77.147489', '86.211205')
+     *
+     * @return array{latitude: float, longitude: float}
+     */
+    public function localCoordinates(): array
+    {
+        return [
+            'latitude' => $this->latitude(),
+            'longitude' => $this->longitude(),
+        ];
+    }
+
+    private function randomFloat(int $nbMaxDecimals, float $min, float $max): float
+    {
+        if ($min > $max) {
+            throw new \LogicException('Invalid coordinates boundaries');
+        }
+
+        return $this->numberExtension->randomFloat($nbMaxDecimals, $min, $max);
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/DateTime.php

@@ -0,0 +1,217 @@
+<?php
+
+namespace Faker\Core;
+
+use Faker\Extension\DateTimeExtension;
+use Faker\Extension\GeneratorAwareExtension;
+use Faker\Extension\GeneratorAwareExtensionTrait;
+use Faker\Extension\Helper;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ *
+ * @since 1.20.0
+ */
+final class DateTime implements DateTimeExtension, GeneratorAwareExtension
+{
+    use GeneratorAwareExtensionTrait;
+
+    /**
+     * @var string[]
+     */
+    private array $centuries = ['I', 'II', 'III', 'IV', 'V', 'VI', 'VII', 'VIII', 'IX', 'X', 'XI', 'XII', 'XIII', 'XIV', 'XV', 'XVI', 'XVII', 'XVIII', 'XIX', 'XX', 'XXI'];
+
+    private ?string $defaultTimezone = null;
+
+    /**
+     * Get the POSIX-timestamp of a DateTime, int or string.
+     *
+     * @param \DateTime|float|int|string $until
+     *
+     * @return false|int
+     */
+    private function getTimestamp($until = 'now')
+    {
+        if (is_numeric($until)) {
+            return (int) $until;
+        }
+
+        if ($until instanceof \DateTime) {
+            return $until->getTimestamp();
+        }
+
+        return strtotime(empty($until) ? 'now' : $until);
+    }
+
+    /**
+     * Get a DateTime created based on a POSIX-timestamp.
+     *
+     * @param int $timestamp the UNIX / POSIX-compatible timestamp
+     */
+    private function getTimestampDateTime(int $timestamp): \DateTime
+    {
+        return new \DateTime('@' . $timestamp);
+    }
+
+    private function resolveTimezone(?string $timezone): string
+    {
+        if ($timezone !== null) {
+            return $timezone;
+        }
+
+        return null === $this->defaultTimezone ? date_default_timezone_get() : $this->defaultTimezone;
+    }
+
+    /**
+     * Internal method to set the timezone on a DateTime object.
+     */
+    private function setTimezone(\DateTime $dateTime, ?string $timezone): \DateTime
+    {
+        $timezone = $this->resolveTimezone($timezone);
+
+        return $dateTime->setTimezone(new \DateTimeZone($timezone));
+    }
+
+    public function dateTime($until = 'now', ?string $timezone = null): \DateTime
+    {
+        return $this->setTimezone(
+            $this->getTimestampDateTime($this->unixTime($until)),
+            $timezone,
+        );
+    }
+
+    public function dateTimeAD($until = 'now', ?string $timezone = null): \DateTime
+    {
+        $min = (PHP_INT_SIZE > 4) ? -62135597361 : -PHP_INT_MAX;
+
+        return $this->setTimezone(
+            $this->getTimestampDateTime($this->generator->numberBetween($min, $this->getTimestamp($until))),
+            $timezone,
+        );
+    }
+
+    public function dateTimeBetween($from = '-30 years', $until = 'now', ?string $timezone = null): \DateTime
+    {
+        $start = $this->getTimestamp($from);
+        $end = $this->getTimestamp($until);
+
+        if ($start > $end) {
+            throw new \InvalidArgumentException('"$from" must be anterior to "$until".');
+        }
+
+        $timestamp = $this->generator->numberBetween($start, $end);
+
+        return $this->setTimezone(
+            $this->getTimestampDateTime($timestamp),
+            $timezone,
+        );
+    }
+
+    public function dateTimeInInterval($from = '-30 years', string $interval = '+5 days', ?string $timezone = null): \DateTime
+    {
+        $intervalObject = \DateInterval::createFromDateString($interval);
+        $datetime = $from instanceof \DateTime ? $from : new \DateTime($from);
+
+        $other = (clone $datetime)->add($intervalObject);
+
+        $begin = min($datetime, $other);
+        $end = $datetime === $begin ? $other : $datetime;
+
+        return $this->dateTimeBetween($begin, $end, $timezone);
+    }
+
+    public function dateTimeThisWeek($until = 'sunday this week', ?string $timezone = null): \DateTime
+    {
+        return $this->dateTimeBetween('monday this week', $until, $timezone);
+    }
+
+    public function dateTimeThisMonth($until = 'last day of this month', ?string $timezone = null): \DateTime
+    {
+        return $this->dateTimeBetween('first day of this month', $until, $timezone);
+    }
+
+    public function dateTimeThisYear($until = 'last day of december', ?string $timezone = null): \DateTime
+    {
+        return $this->dateTimeBetween('first day of january', $until, $timezone);
+    }
+
+    public function dateTimeThisDecade($until = 'now', ?string $timezone = null): \DateTime
+    {
+        $year = floor(date('Y') / 10) * 10;
+
+        return $this->dateTimeBetween("first day of january $year", $until, $timezone);
+    }
+
+    public function dateTimeThisCentury($until = 'now', ?string $timezone = null): \DateTime
+    {
+        $year = floor(date('Y') / 100) * 100;
+
+        return $this->dateTimeBetween("first day of january $year", $until, $timezone);
+    }
+
+    public function date(string $format = 'Y-m-d', $until = 'now'): string
+    {
+        return $this->dateTime($until)->format($format);
+    }
+
+    public function time(string $format = 'H:i:s', $until = 'now'): string
+    {
+        return $this->date($format, $until);
+    }
+
+    public function unixTime($until = 'now'): int
+    {
+        return $this->generator->numberBetween(0, $this->getTimestamp($until));
+    }
+
+    public function iso8601($until = 'now'): string
+    {
+        return $this->date(\DateTime::ISO8601, $until);
+    }
+
+    public function amPm($until = 'now'): string
+    {
+        return $this->date('a', $until);
+    }
+
+    public function dayOfMonth($until = 'now'): string
+    {
+        return $this->date('d', $until);
+    }
+
+    public function dayOfWeek($until = 'now'): string
+    {
+        return $this->date('l', $until);
+    }
+
+    public function month($until = 'now'): string
+    {
+        return $this->date('m', $until);
+    }
+
+    public function monthName($until = 'now'): string
+    {
+        return $this->date('F', $until);
+    }
+
+    public function year($until = 'now'): string
+    {
+        return $this->date('Y', $until);
+    }
+
+    public function century(): string
+    {
+        return Helper::randomElement($this->centuries);
+    }
+
+    public function timezone(?string $countryCode = null): string
+    {
+        if ($countryCode) {
+            $timezones = \DateTimeZone::listIdentifiers(\DateTimeZone::PER_COUNTRY, $countryCode);
+        } else {
+            $timezones = \DateTimeZone::listIdentifiers();
+        }
+
+        return Helper::randomElement($timezones);
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/File.php

@@ -0,0 +1,564 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Core;
+
+use Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class File implements Extension\FileExtension
+{
+    /**
+     * MIME types from the apache.org file. Some types are truncated.
+     *
+     * @var array Map of MIME types => file extension(s)
+     *
+     * @see http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types
+     */
+    private array $mimeTypes = [
+        'application/atom+xml' => 'atom',
+        'application/ecmascript' => 'ecma',
+        'application/emma+xml' => 'emma',
+        'application/epub+zip' => 'epub',
+        'application/java-archive' => 'jar',
+        'application/java-vm' => 'class',
+        'application/javascript' => 'js',
+        'application/json' => 'json',
+        'application/jsonml+json' => 'jsonml',
+        'application/lost+xml' => 'lostxml',
+        'application/mathml+xml' => 'mathml',
+        'application/mets+xml' => 'mets',
+        'application/mods+xml' => 'mods',
+        'application/mp4' => 'mp4s',
+        'application/msword' => ['doc', 'dot'],
+        'application/octet-stream' => [
+            'bin',
+            'dms',
+            'lrf',
+            'mar',
+            'so',
+            'dist',
+            'distz',
+            'pkg',
+            'bpk',
+            'dump',
+            'elc',
+            'deploy',
+        ],
+        'application/ogg' => 'ogx',
+        'application/omdoc+xml' => 'omdoc',
+        'application/pdf' => 'pdf',
+        'application/pgp-encrypted' => 'pgp',
+        'application/pgp-signature' => ['asc', 'sig'],
+        'application/pkix-pkipath' => 'pkipath',
+        'application/pkixcmp' => 'pki',
+        'application/pls+xml' => 'pls',
+        'application/postscript' => ['ai', 'eps', 'ps'],
+        'application/pskc+xml' => 'pskcxml',
+        'application/rdf+xml' => 'rdf',
+        'application/reginfo+xml' => 'rif',
+        'application/rss+xml' => 'rss',
+        'application/rtf' => 'rtf',
+        'application/sbml+xml' => 'sbml',
+        'application/vnd.adobe.air-application-installer-package+zip' => 'air',
+        'application/vnd.adobe.xdp+xml' => 'xdp',
+        'application/vnd.adobe.xfdf' => 'xfdf',
+        'application/vnd.ahead.space' => 'ahead',
+        'application/vnd.dart' => 'dart',
+        'application/vnd.data-vision.rdz' => 'rdz',
+        'application/vnd.dece.data' => ['uvf', 'uvvf', 'uvd', 'uvvd'],
+        'application/vnd.dece.ttml+xml' => ['uvt', 'uvvt'],
+        'application/vnd.dece.unspecified' => ['uvx', 'uvvx'],
+        'application/vnd.dece.zip' => ['uvz', 'uvvz'],
+        'application/vnd.denovo.fcselayout-link' => 'fe_launch',
+        'application/vnd.dna' => 'dna',
+        'application/vnd.dolby.mlp' => 'mlp',
+        'application/vnd.dpgraph' => 'dpg',
+        'application/vnd.dreamfactory' => 'dfac',
+        'application/vnd.ds-keypoint' => 'kpxx',
+        'application/vnd.dvb.ait' => 'ait',
+        'application/vnd.dvb.service' => 'svc',
+        'application/vnd.dynageo' => 'geo',
+        'application/vnd.ecowin.chart' => 'mag',
+        'application/vnd.enliven' => 'nml',
+        'application/vnd.epson.esf' => 'esf',
+        'application/vnd.epson.msf' => 'msf',
+        'application/vnd.epson.quickanime' => 'qam',
+        'application/vnd.epson.salt' => 'slt',
+        'application/vnd.epson.ssf' => 'ssf',
+        'application/vnd.ezpix-album' => 'ez2',
+        'application/vnd.ezpix-package' => 'ez3',
+        'application/vnd.fdf' => 'fdf',
+        'application/vnd.fdsn.mseed' => 'mseed',
+        'application/vnd.fdsn.seed' => ['seed', 'dataless'],
+        'application/vnd.flographit' => 'gph',
+        'application/vnd.fluxtime.clip' => 'ftc',
+        'application/vnd.hal+xml' => 'hal',
+        'application/vnd.hydrostatix.sof-data' => 'sfd-hdstx',
+        'application/vnd.ibm.minipay' => 'mpy',
+        'application/vnd.ibm.secure-container' => 'sc',
+        'application/vnd.iccprofile' => ['icc', 'icm'],
+        'application/vnd.igloader' => 'igl',
+        'application/vnd.immervision-ivp' => 'ivp',
+        'application/vnd.kde.karbon' => 'karbon',
+        'application/vnd.kde.kchart' => 'chrt',
+        'application/vnd.kde.kformula' => 'kfo',
+        'application/vnd.kde.kivio' => 'flw',
+        'application/vnd.kde.kontour' => 'kon',
+        'application/vnd.kde.kpresenter' => ['kpr', 'kpt'],
+        'application/vnd.kde.kspread' => 'ksp',
+        'application/vnd.kde.kword' => ['kwd', 'kwt'],
+        'application/vnd.kenameaapp' => 'htke',
+        'application/vnd.kidspiration' => 'kia',
+        'application/vnd.kinar' => ['kne', 'knp'],
+        'application/vnd.koan' => ['skp', 'skd', 'skt', 'skm'],
+        'application/vnd.kodak-descriptor' => 'sse',
+        'application/vnd.las.las+xml' => 'lasxml',
+        'application/vnd.llamagraphics.life-balance.desktop' => 'lbd',
+        'application/vnd.llamagraphics.life-balance.exchange+xml' => 'lbe',
+        'application/vnd.lotus-1-2-3' => '123',
+        'application/vnd.lotus-approach' => 'apr',
+        'application/vnd.lotus-freelance' => 'pre',
+        'application/vnd.lotus-notes' => 'nsf',
+        'application/vnd.lotus-organizer' => 'org',
+        'application/vnd.lotus-screencam' => 'scm',
+        'application/vnd.mozilla.xul+xml' => 'xul',
+        'application/vnd.ms-artgalry' => 'cil',
+        'application/vnd.ms-cab-compressed' => 'cab',
+        'application/vnd.ms-excel' => [
+            'xls',
+            'xlm',
+            'xla',
+            'xlc',
+            'xlt',
+            'xlw',
+        ],
+        'application/vnd.ms-excel.addin.macroenabled.12' => 'xlam',
+        'application/vnd.ms-excel.sheet.binary.macroenabled.12' => 'xlsb',
+        'application/vnd.ms-excel.sheet.macroenabled.12' => 'xlsm',
+        'application/vnd.ms-excel.template.macroenabled.12' => 'xltm',
+        'application/vnd.ms-fontobject' => 'eot',
+        'application/vnd.ms-htmlhelp' => 'chm',
+        'application/vnd.ms-ims' => 'ims',
+        'application/vnd.ms-lrm' => 'lrm',
+        'application/vnd.ms-officetheme' => 'thmx',
+        'application/vnd.ms-pki.seccat' => 'cat',
+        'application/vnd.ms-pki.stl' => 'stl',
+        'application/vnd.ms-powerpoint' => ['ppt', 'pps', 'pot'],
+        'application/vnd.ms-powerpoint.addin.macroenabled.12' => 'ppam',
+        'application/vnd.ms-powerpoint.presentation.macroenabled.12' => 'pptm',
+        'application/vnd.ms-powerpoint.slide.macroenabled.12' => 'sldm',
+        'application/vnd.ms-powerpoint.slideshow.macroenabled.12' => 'ppsm',
+        'application/vnd.ms-powerpoint.template.macroenabled.12' => 'potm',
+        'application/vnd.ms-project' => ['mpp', 'mpt'],
+        'application/vnd.ms-word.document.macroenabled.12' => 'docm',
+        'application/vnd.ms-word.template.macroenabled.12' => 'dotm',
+        'application/vnd.ms-works' => ['wps', 'wks', 'wcm', 'wdb'],
+        'application/vnd.ms-wpl' => 'wpl',
+        'application/vnd.ms-xpsdocument' => 'xps',
+        'application/vnd.mseq' => 'mseq',
+        'application/vnd.musician' => 'mus',
+        'application/vnd.oasis.opendocument.chart' => 'odc',
+        'application/vnd.oasis.opendocument.chart-template' => 'otc',
+        'application/vnd.oasis.opendocument.database' => 'odb',
+        'application/vnd.oasis.opendocument.formula' => 'odf',
+        'application/vnd.oasis.opendocument.formula-template' => 'odft',
+        'application/vnd.oasis.opendocument.graphics' => 'odg',
+        'application/vnd.oasis.opendocument.graphics-template' => 'otg',
+        'application/vnd.oasis.opendocument.image' => 'odi',
+        'application/vnd.oasis.opendocument.image-template' => 'oti',
+        'application/vnd.oasis.opendocument.presentation' => 'odp',
+        'application/vnd.oasis.opendocument.presentation-template' => 'otp',
+        'application/vnd.oasis.opendocument.spreadsheet' => 'ods',
+        'application/vnd.oasis.opendocument.spreadsheet-template' => 'ots',
+        'application/vnd.oasis.opendocument.text' => 'odt',
+        'application/vnd.oasis.opendocument.text-master' => 'odm',
+        'application/vnd.oasis.opendocument.text-template' => 'ott',
+        'application/vnd.oasis.opendocument.text-web' => 'oth',
+        'application/vnd.olpc-sugar' => 'xo',
+        'application/vnd.oma.dd2+xml' => 'dd2',
+        'application/vnd.openofficeorg.extension' => 'oxt',
+        'application/vnd.openxmlformats-officedocument.presentationml.presentation' => 'pptx',
+        'application/vnd.openxmlformats-officedocument.presentationml.slide' => 'sldx',
+        'application/vnd.openxmlformats-officedocument.presentationml.slideshow' => 'ppsx',
+        'application/vnd.openxmlformats-officedocument.presentationml.template' => 'potx',
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' => 'xlsx',
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.template' => 'xltx',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document' => 'docx',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.template' => 'dotx',
+        'application/vnd.pvi.ptid1' => 'ptid',
+        'application/vnd.quark.quarkxpress' => [
+            'qxd',
+            'qxt',
+            'qwd',
+            'qwt',
+            'qxl',
+            'qxb',
+        ],
+        'application/vnd.realvnc.bed' => 'bed',
+        'application/vnd.recordare.musicxml' => 'mxl',
+        'application/vnd.recordare.musicxml+xml' => 'musicxml',
+        'application/vnd.rig.cryptonote' => 'cryptonote',
+        'application/vnd.rim.cod' => 'cod',
+        'application/vnd.rn-realmedia' => 'rm',
+        'application/vnd.rn-realmedia-vbr' => 'rmvb',
+        'application/vnd.route66.link66+xml' => 'link66',
+        'application/vnd.sailingtracker.track' => 'st',
+        'application/vnd.seemail' => 'see',
+        'application/vnd.sema' => 'sema',
+        'application/vnd.semd' => 'semd',
+        'application/vnd.semf' => 'semf',
+        'application/vnd.shana.informed.formdata' => 'ifm',
+        'application/vnd.shana.informed.formtemplate' => 'itp',
+        'application/vnd.shana.informed.interchange' => 'iif',
+        'application/vnd.shana.informed.package' => 'ipk',
+        'application/vnd.simtech-mindmapper' => ['twd', 'twds'],
+        'application/vnd.smaf' => 'mmf',
+        'application/vnd.stepmania.stepchart' => 'sm',
+        'application/vnd.sun.xml.calc' => 'sxc',
+        'application/vnd.sun.xml.calc.template' => 'stc',
+        'application/vnd.sun.xml.draw' => 'sxd',
+        'application/vnd.sun.xml.draw.template' => 'std',
+        'application/vnd.sun.xml.impress' => 'sxi',
+        'application/vnd.sun.xml.impress.template' => 'sti',
+        'application/vnd.sun.xml.math' => 'sxm',
+        'application/vnd.sun.xml.writer' => 'sxw',
+        'application/vnd.sun.xml.writer.global' => 'sxg',
+        'application/vnd.sun.xml.writer.template' => 'stw',
+        'application/vnd.sus-calendar' => ['sus', 'susp'],
+        'application/vnd.svd' => 'svd',
+        'application/vnd.symbian.install' => ['sis', 'sisx'],
+        'application/vnd.syncml+xml' => 'xsm',
+        'application/vnd.syncml.dm+wbxml' => 'bdm',
+        'application/vnd.syncml.dm+xml' => 'xdm',
+        'application/vnd.tao.intent-module-archive' => 'tao',
+        'application/vnd.tcpdump.pcap' => ['pcap', 'cap', 'dmp'],
+        'application/vnd.tmobile-livetv' => 'tmo',
+        'application/vnd.trid.tpt' => 'tpt',
+        'application/vnd.triscape.mxs' => 'mxs',
+        'application/vnd.trueapp' => 'tra',
+        'application/vnd.ufdl' => ['ufd', 'ufdl'],
+        'application/vnd.uiq.theme' => 'utz',
+        'application/vnd.umajin' => 'umj',
+        'application/vnd.unity' => 'unityweb',
+        'application/vnd.uoml+xml' => 'uoml',
+        'application/vnd.vcx' => 'vcx',
+        'application/vnd.visio' => ['vsd', 'vst', 'vss', 'vsw'],
+        'application/vnd.visionary' => 'vis',
+        'application/vnd.vsf' => 'vsf',
+        'application/vnd.wap.wbxml' => 'wbxml',
+        'application/vnd.wap.wmlc' => 'wmlc',
+        'application/vnd.wap.wmlscriptc' => 'wmlsc',
+        'application/vnd.webturbo' => 'wtb',
+        'application/vnd.wolfram.player' => 'nbp',
+        'application/vnd.wordperfect' => 'wpd',
+        'application/vnd.wqd' => 'wqd',
+        'application/vnd.wt.stf' => 'stf',
+        'application/vnd.xara' => 'xar',
+        'application/vnd.xfdl' => 'xfdl',
+        'application/voicexml+xml' => 'vxml',
+        'application/widget' => 'wgt',
+        'application/winhlp' => 'hlp',
+        'application/wsdl+xml' => 'wsdl',
+        'application/wspolicy+xml' => 'wspolicy',
+        'application/x-7z-compressed' => '7z',
+        'application/x-bittorrent' => 'torrent',
+        'application/x-blorb' => ['blb', 'blorb'],
+        'application/x-bzip' => 'bz',
+        'application/x-cdlink' => 'vcd',
+        'application/x-cfs-compressed' => 'cfs',
+        'application/x-chat' => 'chat',
+        'application/x-chess-pgn' => 'pgn',
+        'application/x-conference' => 'nsc',
+        'application/x-cpio' => 'cpio',
+        'application/x-csh' => 'csh',
+        'application/x-debian-package' => ['deb', 'udeb'],
+        'application/x-dgc-compressed' => 'dgc',
+        'application/x-director' => [
+            'dir',
+            'dcr',
+            'dxr',
+            'cst',
+            'cct',
+            'cxt',
+            'w3d',
+            'fgd',
+            'swa',
+        ],
+        'application/x-font-ttf' => ['ttf', 'ttc'],
+        'application/x-font-type1' => ['pfa', 'pfb', 'pfm', 'afm'],
+        'application/x-font-woff' => 'woff',
+        'application/x-freearc' => 'arc',
+        'application/x-futuresplash' => 'spl',
+        'application/x-gca-compressed' => 'gca',
+        'application/x-glulx' => 'ulx',
+        'application/x-gnumeric' => 'gnumeric',
+        'application/x-gramps-xml' => 'gramps',
+        'application/x-gtar' => 'gtar',
+        'application/x-hdf' => 'hdf',
+        'application/x-install-instructions' => 'install',
+        'application/x-iso9660-image' => 'iso',
+        'application/x-java-jnlp-file' => 'jnlp',
+        'application/x-latex' => 'latex',
+        'application/x-lzh-compressed' => ['lzh', 'lha'],
+        'application/x-mie' => 'mie',
+        'application/x-mobipocket-ebook' => ['prc', 'mobi'],
+        'application/x-ms-application' => 'application',
+        'application/x-ms-shortcut' => 'lnk',
+        'application/x-ms-wmd' => 'wmd',
+        'application/x-ms-wmz' => 'wmz',
+        'application/x-ms-xbap' => 'xbap',
+        'application/x-msaccess' => 'mdb',
+        'application/x-msbinder' => 'obd',
+        'application/x-mscardfile' => 'crd',
+        'application/x-msclip' => 'clp',
+        'application/x-msdownload' => ['exe', 'dll', 'com', 'bat', 'msi'],
+        'application/x-msmediaview' => [
+            'mvb',
+            'm13',
+            'm14',
+        ],
+        'application/x-msmetafile' => ['wmf', 'wmz', 'emf', 'emz'],
+        'application/x-rar-compressed' => 'rar',
+        'application/x-research-info-systems' => 'ris',
+        'application/x-sh' => 'sh',
+        'application/x-shar' => 'shar',
+        'application/x-shockwave-flash' => 'swf',
+        'application/x-silverlight-app' => 'xap',
+        'application/x-sql' => 'sql',
+        'application/x-stuffit' => 'sit',
+        'application/x-stuffitx' => 'sitx',
+        'application/x-subrip' => 'srt',
+        'application/x-sv4cpio' => 'sv4cpio',
+        'application/x-sv4crc' => 'sv4crc',
+        'application/x-t3vm-image' => 't3',
+        'application/x-tads' => 'gam',
+        'application/x-tar' => 'tar',
+        'application/x-tcl' => 'tcl',
+        'application/x-tex' => 'tex',
+        'application/x-tex-tfm' => 'tfm',
+        'application/x-texinfo' => ['texinfo', 'texi'],
+        'application/x-tgif' => 'obj',
+        'application/x-ustar' => 'ustar',
+        'application/x-wais-source' => 'src',
+        'application/x-x509-ca-cert' => ['der', 'crt'],
+        'application/x-xfig' => 'fig',
+        'application/x-xliff+xml' => 'xlf',
+        'application/x-xpinstall' => 'xpi',
+        'application/x-xz' => 'xz',
+        'application/x-zmachine' => 'z1',
+        'application/xaml+xml' => 'xaml',
+        'application/xcap-diff+xml' => 'xdf',
+        'application/xenc+xml' => 'xenc',
+        'application/xhtml+xml' => ['xhtml', 'xht'],
+        'application/xml' => ['xml', 'xsl'],
+        'application/xml-dtd' => 'dtd',
+        'application/xop+xml' => 'xop',
+        'application/xproc+xml' => 'xpl',
+        'application/xslt+xml' => 'xslt',
+        'application/xspf+xml' => 'xspf',
+        'application/xv+xml' => ['mxml', 'xhvml', 'xvml', 'xvm'],
+        'application/yang' => 'yang',
+        'application/yin+xml' => 'yin',
+        'application/zip' => 'zip',
+        'audio/adpcm' => 'adp',
+        'audio/basic' => ['au', 'snd'],
+        'audio/midi' => ['mid', 'midi', 'kar', 'rmi'],
+        'audio/mp4' => 'mp4a',
+        'audio/mpeg' => [
+            'mpga',
+            'mp2',
+            'mp2a',
+            'mp3',
+            'm2a',
+            'm3a',
+        ],
+        'audio/ogg' => ['oga', 'ogg', 'spx'],
+        'audio/vnd.dece.audio' => ['uva', 'uvva'],
+        'audio/vnd.rip' => 'rip',
+        'audio/webm' => 'weba',
+        'audio/x-aac' => 'aac',
+        'audio/x-aiff' => ['aif', 'aiff', 'aifc'],
+        'audio/x-caf' => 'caf',
+        'audio/x-flac' => 'flac',
+        'audio/x-matroska' => 'mka',
+        'audio/x-mpegurl' => 'm3u',
+        'audio/x-ms-wax' => 'wax',
+        'audio/x-ms-wma' => 'wma',
+        'audio/x-pn-realaudio' => ['ram', 'ra'],
+        'audio/x-pn-realaudio-plugin' => 'rmp',
+        'audio/x-wav' => 'wav',
+        'audio/xm' => 'xm',
+        'image/bmp' => 'bmp',
+        'image/cgm' => 'cgm',
+        'image/g3fax' => 'g3',
+        'image/gif' => 'gif',
+        'image/ief' => 'ief',
+        'image/jpeg' => ['jpeg', 'jpg', 'jpe'],
+        'image/ktx' => 'ktx',
+        'image/png' => 'png',
+        'image/prs.btif' => 'btif',
+        'image/sgi' => 'sgi',
+        'image/svg+xml' => ['svg', 'svgz'],
+        'image/tiff' => ['tiff', 'tif'],
+        'image/vnd.adobe.photoshop' => 'psd',
+        'image/vnd.dece.graphic' => ['uvi', 'uvvi', 'uvg', 'uvvg'],
+        'image/vnd.dvb.subtitle' => 'sub',
+        'image/vnd.djvu' => ['djvu', 'djv'],
+        'image/vnd.dwg' => 'dwg',
+        'image/vnd.dxf' => 'dxf',
+        'image/vnd.fastbidsheet' => 'fbs',
+        'image/vnd.fpx' => 'fpx',
+        'image/vnd.fst' => 'fst',
+        'image/vnd.fujixerox.edmics-mmr' => 'mmr',
+        'image/vnd.fujixerox.edmics-rlc' => 'rlc',
+        'image/vnd.ms-modi' => 'mdi',
+        'image/vnd.ms-photo' => 'wdp',
+        'image/vnd.net-fpx' => 'npx',
+        'image/vnd.wap.wbmp' => 'wbmp',
+        'image/vnd.xiff' => 'xif',
+        'image/webp' => 'webp',
+        'image/x-3ds' => '3ds',
+        'image/x-cmu-raster' => 'ras',
+        'image/x-cmx' => 'cmx',
+        'image/x-freehand' => ['fh', 'fhc', 'fh4', 'fh5', 'fh7'],
+        'image/x-icon' => 'ico',
+        'image/x-mrsid-image' => 'sid',
+        'image/x-pcx' => 'pcx',
+        'image/x-pict' => ['pic', 'pct'],
+        'image/x-portable-anymap' => 'pnm',
+        'image/x-portable-bitmap' => 'pbm',
+        'image/x-portable-graymap' => 'pgm',
+        'image/x-portable-pixmap' => 'ppm',
+        'image/x-rgb' => 'rgb',
+        'image/x-tga' => 'tga',
+        'image/x-xbitmap' => 'xbm',
+        'image/x-xpixmap' => 'xpm',
+        'image/x-xwindowdump' => 'xwd',
+        'message/rfc822' => ['eml', 'mime'],
+        'model/iges' => ['igs', 'iges'],
+        'model/mesh' => ['msh', 'mesh', 'silo'],
+        'model/vnd.collada+xml' => 'dae',
+        'model/vnd.dwf' => 'dwf',
+        'model/vnd.gdl' => 'gdl',
+        'model/vnd.gtw' => 'gtw',
+        'model/vnd.mts' => 'mts',
+        'model/vnd.vtu' => 'vtu',
+        'model/vrml' => ['wrl', 'vrml'],
+        'model/x3d+binary' => 'x3db',
+        'model/x3d+vrml' => 'x3dv',
+        'model/x3d+xml' => 'x3d',
+        'text/cache-manifest' => 'appcache',
+        'text/calendar' => ['ics', 'ifb'],
+        'text/css' => 'css',
+        'text/csv' => 'csv',
+        'text/html' => ['html', 'htm'],
+        'text/n3' => 'n3',
+        'text/plain' => [
+            'txt',
+            'text',
+            'conf',
+            'def',
+            'list',
+            'log',
+            'in',
+        ],
+        'text/prs.lines.tag' => 'dsc',
+        'text/richtext' => 'rtx',
+        'text/sgml' => ['sgml', 'sgm'],
+        'text/tab-separated-values' => 'tsv',
+        'text/troff' => [
+            't',
+            'tr',
+            'roff',
+            'man',
+            'me',
+            'ms',
+        ],
+        'text/turtle' => 'ttl',
+        'text/uri-list' => ['uri', 'uris', 'urls'],
+        'text/vcard' => 'vcard',
+        'text/vnd.curl' => 'curl',
+        'text/vnd.curl.dcurl' => 'dcurl',
+        'text/vnd.curl.scurl' => 'scurl',
+        'text/vnd.curl.mcurl' => 'mcurl',
+        'text/vnd.dvb.subtitle' => 'sub',
+        'text/vnd.fly' => 'fly',
+        'text/vnd.fmi.flexstor' => 'flx',
+        'text/vnd.graphviz' => 'gv',
+        'text/vnd.in3d.3dml' => '3dml',
+        'text/vnd.in3d.spot' => 'spot',
+        'text/vnd.sun.j2me.app-descriptor' => 'jad',
+        'text/vnd.wap.wml' => 'wml',
+        'text/vnd.wap.wmlscript' => 'wmls',
+        'text/x-asm' => ['s', 'asm'],
+        'text/x-fortran' => ['f', 'for', 'f77', 'f90'],
+        'text/x-java-source' => 'java',
+        'text/x-opml' => 'opml',
+        'text/x-pascal' => ['p', 'pas'],
+        'text/x-nfo' => 'nfo',
+        'text/x-setext' => 'etx',
+        'text/x-sfv' => 'sfv',
+        'text/x-uuencode' => 'uu',
+        'text/x-vcalendar' => 'vcs',
+        'text/x-vcard' => 'vcf',
+        'video/3gpp' => '3gp',
+        'video/3gpp2' => '3g2',
+        'video/h261' => 'h261',
+        'video/h263' => 'h263',
+        'video/h264' => 'h264',
+        'video/jpeg' => 'jpgv',
+        'video/jpm' => ['jpm', 'jpgm'],
+        'video/mj2' => 'mj2',
+        'video/mp4' => 'mp4',
+        'video/mpeg' => ['mpeg', 'mpg', 'mpe', 'm1v', 'm2v'],
+        'video/ogg' => 'ogv',
+        'video/quicktime' => ['qt', 'mov'],
+        'video/vnd.dece.hd' => ['uvh', 'uvvh'],
+        'video/vnd.dece.mobile' => ['uvm', 'uvvm'],
+        'video/vnd.dece.pd' => ['uvp', 'uvvp'],
+        'video/vnd.dece.sd' => ['uvs', 'uvvs'],
+        'video/vnd.dece.video' => ['uvv', 'uvvv'],
+        'video/vnd.dvb.file' => 'dvb',
+        'video/vnd.fvt' => 'fvt',
+        'video/vnd.mpegurl' => ['mxu', 'm4u'],
+        'video/vnd.ms-playready.media.pyv' => 'pyv',
+        'video/vnd.uvvu.mp4' => ['uvu', 'uvvu'],
+        'video/vnd.vivo' => 'viv',
+        'video/webm' => 'webm',
+        'video/x-f4v' => 'f4v',
+        'video/x-fli' => 'fli',
+        'video/x-flv' => 'flv',
+        'video/x-m4v' => 'm4v',
+        'video/x-matroska' => ['mkv', 'mk3d', 'mks'],
+        'video/x-mng' => 'mng',
+        'video/x-ms-asf' => ['asf', 'asx'],
+        'video/x-ms-vob' => 'vob',
+        'video/x-ms-wm' => 'wm',
+        'video/x-ms-wmv' => 'wmv',
+        'video/x-ms-wmx' => 'wmx',
+        'video/x-ms-wvx' => 'wvx',
+        'video/x-msvideo' => 'avi',
+        'video/x-sgi-movie' => 'movie',
+    ];
+
+    public function mimeType(): string
+    {
+        return array_rand($this->mimeTypes, 1);
+    }
+
+    public function extension(): string
+    {
+        $extension = $this->mimeTypes[array_rand($this->mimeTypes, 1)];
+
+        return is_array($extension) ? $extension[array_rand($extension, 1)] : $extension;
+    }
+
+    public function filePath(): string
+    {
+        return tempnam(sys_get_temp_dir(), 'faker');
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/Number.php

@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Core;
+
+use Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Number implements Extension\NumberExtension
+{
+    public function numberBetween(int $min = 0, int $max = 2147483647): int
+    {
+        $int1 = min($min, $max);
+        $int2 = max($min, $max);
+
+        return mt_rand($int1, $int2);
+    }
+
+    public function randomDigit(): int
+    {
+        return $this->numberBetween(0, 9);
+    }
+
+    public function randomDigitNot(int $except): int
+    {
+        $result = $this->numberBetween(0, 8);
+
+        if ($result >= $except) {
+            ++$result;
+        }
+
+        return $result;
+    }
+
+    public function randomDigitNotZero(): int
+    {
+        return $this->numberBetween(1, 9);
+    }
+
+    public function randomFloat(?int $nbMaxDecimals = null, float $min = 0, ?float $max = null): float
+    {
+        if (null === $nbMaxDecimals) {
+            $nbMaxDecimals = $this->randomDigit();
+        }
+
+        if (null === $max) {
+            $max = $this->randomNumber();
+
+            if ($min > $max) {
+                $max = $min;
+            }
+        }
+
+        if ($min > $max) {
+            $tmp = $min;
+            $min = $max;
+            $max = $tmp;
+        }
+
+        return round($min + $this->numberBetween() / mt_getrandmax() * ($max - $min), $nbMaxDecimals);
+    }
+
+    public function randomNumber(?int $nbDigits = null, bool $strict = false): int
+    {
+        if (null === $nbDigits) {
+            $nbDigits = $this->randomDigitNotZero();
+        }
+        $max = 10 ** $nbDigits - 1;
+
+        if ($max > mt_getrandmax()) {
+            throw new \InvalidArgumentException('randomNumber() can only generate numbers up to mt_getrandmax()');
+        }
+
+        if ($strict) {
+            return $this->numberBetween(10 ** ($nbDigits - 1), $max);
+        }
+
+        return $this->numberBetween(0, $max);
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/Uuid.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Faker\Core;
+
+use Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Uuid implements Extension\UuidExtension
+{
+    private Extension\NumberExtension $numberExtension;
+
+    public function __construct(?Extension\NumberExtension $numberExtension = null)
+    {
+
+        $this->numberExtension = $numberExtension ?: new Number();
+    }
+
+    public function uuid3(): string
+    {
+        // fix for compatibility with 32bit architecture; each mt_rand call is restricted to 32bit
+        // two such calls will cause 64bits of randomness regardless of architecture
+        $seed = $this->numberExtension->numberBetween(0, 2147483647) . '#' . $this->numberExtension->numberBetween(0, 2147483647);
+
+        // Hash the seed and convert to a byte array
+        $val = md5($seed, true);
+        $byte = array_values(unpack('C16', $val));
+
+        // extract fields from byte array
+        $tLo = ($byte[0] << 24) | ($byte[1] << 16) | ($byte[2] << 8) | $byte[3];
+        $tMi = ($byte[4] << 8) | $byte[5];
+        $tHi = ($byte[6] << 8) | $byte[7];
+        $csLo = $byte[9];
+        $csHi = $byte[8] & 0x3f | (1 << 7);
+
+        // correct byte order for big edian architecture
+        if (pack('L', 0x6162797A) == pack('N', 0x6162797A)) {
+            $tLo = (($tLo & 0x000000ff) << 24) | (($tLo & 0x0000ff00) << 8)
+                | (($tLo & 0x00ff0000) >> 8) | (($tLo & 0xff000000) >> 24);
+            $tMi = (($tMi & 0x00ff) << 8) | (($tMi & 0xff00) >> 8);
+            $tHi = (($tHi & 0x00ff) << 8) | (($tHi & 0xff00) >> 8);
+        }
+
+        // apply version number
+        $tHi &= 0x0fff;
+        $tHi |= (3 << 12);
+
+        // cast to string
+        return sprintf(
+            '%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x',
+            $tLo,
+            $tMi,
+            $tHi,
+            $csHi,
+            $csLo,
+            $byte[10],
+            $byte[11],
+            $byte[12],
+            $byte[13],
+            $byte[14],
+            $byte[15],
+        );
+    }
+}

vendor/fakerphp/faker/src/Faker/Core/Version.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Core;
+
+use Faker\Extension;
+use Faker\Provider\DateTime;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Version implements Extension\VersionExtension
+{
+    private Extension\NumberExtension $numberExtension;
+    /**
+     * @var string[]
+     */
+    private array $semverCommonPreReleaseIdentifiers = ['alpha', 'beta', 'rc'];
+
+    public function __construct(?Extension\NumberExtension $numberExtension = null)
+    {
+
+        $this->numberExtension = $numberExtension ?: new  Number();
+    }
+
+    /**
+     * Represents v2.0.0 of the semantic versioning: https://semver.org/spec/v2.0.0.html
+     */
+    public function semver(bool $preRelease = false, bool $build = false): string
+    {
+        return sprintf(
+            '%d.%d.%d%s%s',
+            $this->numberExtension->numberBetween(0, 9),
+            $this->numberExtension->numberBetween(0, 99),
+            $this->numberExtension->numberBetween(0, 99),
+            $preRelease && $this->numberExtension->numberBetween(0, 1) === 1 ? '-' . $this->semverPreReleaseIdentifier() : '',
+            $build && $this->numberExtension->numberBetween(0, 1) === 1 ? '+' . $this->semverBuildIdentifier() : '',
+        );
+    }
+
+    /**
+     * Common pre-release identifier
+     */
+    private function semverPreReleaseIdentifier(): string
+    {
+        $ident = Extension\Helper::randomElement($this->semverCommonPreReleaseIdentifiers);
+
+        if ($this->numberExtension->numberBetween(0, 1) !== 1) {
+            return $ident;
+        }
+
+        return $ident . '.' . $this->numberExtension->numberBetween(1, 99);
+    }
+
+    /**
+     * Common random build identifier
+     */
+    private function semverBuildIdentifier(): string
+    {
+        if ($this->numberExtension->numberBetween(0, 1) === 1) {
+            // short git revision syntax: https://git-scm.com/book/en/v2/Git-Tools-Revision-Selection
+            return substr(sha1(Extension\Helper::lexify('??????')), 0, 7);
+        }
+
+        // date syntax
+        return DateTime::date('YmdHis');
+    }
+}

vendor/fakerphp/faker/src/Faker/DefaultGenerator.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Faker;
+
+/**
+ * This generator returns a default value for all called properties
+ * and methods.
+ *
+ * @mixin Generator
+ *
+ * @deprecated Use ChanceGenerator instead
+ */
+class DefaultGenerator
+{
+    protected $default;
+
+    public function __construct($default = null)
+    {
+        trigger_deprecation('fakerphp/faker', '1.16', 'Class "%s" is deprecated, use "%s" instead.', __CLASS__, ChanceGenerator::class);
+
+        $this->default = $default;
+    }
+
+    public function ext()
+    {
+        return $this;
+    }
+
+    /**
+     * @param string $attribute
+     *
+     * @deprecated Use a method instead.
+     */
+    public function __get($attribute)
+    {
+        trigger_deprecation('fakerphp/faker', '1.14', 'Accessing property "%s" is deprecated, use "%s()" instead.', $attribute, $attribute);
+
+        return $this->default;
+    }
+
+    /**
+     * @param string $method
+     * @param array  $attributes
+     */
+    public function __call($method, $attributes)
+    {
+        return $this->default;
+    }
+}

vendor/fakerphp/faker/src/Faker/Documentor.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace Faker;
+
+class Documentor
+{
+    protected $generator;
+
+    public function __construct(Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return array
+     */
+    public function getFormatters()
+    {
+        $formatters = [];
+        $providers = array_reverse($this->generator->getProviders());
+        $providers[] = new Provider\Base($this->generator);
+
+        foreach ($providers as $provider) {
+            $providerClass = get_class($provider);
+            $formatters[$providerClass] = [];
+            $refl = new \ReflectionObject($provider);
+
+            foreach ($refl->getMethods(\ReflectionMethod::IS_PUBLIC) as $reflmethod) {
+                if ($reflmethod->getDeclaringClass()->getName() == 'Faker\Provider\Base' && $providerClass != 'Faker\Provider\Base') {
+                    continue;
+                }
+                $methodName = $reflmethod->name;
+
+                if ($reflmethod->isConstructor()) {
+                    continue;
+                }
+                $parameters = [];
+
+                foreach ($reflmethod->getParameters() as $reflparameter) {
+                    $parameter = '$' . $reflparameter->getName();
+
+                    if ($reflparameter->isDefaultValueAvailable()) {
+                        $parameter .= ' = ' . var_export($reflparameter->getDefaultValue(), true);
+                    }
+                    $parameters[] = $parameter;
+                }
+                $parameters = $parameters ? '(' . implode(', ', $parameters) . ')' : '';
+
+                try {
+                    $example = $this->generator->format($methodName);
+                } catch (\InvalidArgumentException $e) {
+                    $example = '';
+                }
+
+                if (is_array($example)) {
+                    $example = "array('" . implode("', '", $example) . "')";
+                } elseif ($example instanceof \DateTime) {
+                    $example = "DateTime('" . $example->format('Y-m-d H:i:s') . "')";
+                } elseif ($example instanceof Generator || $example instanceof UniqueGenerator) { // modifier
+                    $example = '';
+                } else {
+                    $example = var_export($example, true);
+                }
+                $formatters[$providerClass][$methodName . $parameters] = $example;
+            }
+        }
+
+        return $formatters;
+    }
+}

vendor/fakerphp/faker/src/Faker/Extension/AddressExtension.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface AddressExtension extends Extension
+{
+    /**
+     * @example '791 Crist Parks, Sashabury, IL 86039-9874'
+     */
+    public function address(): string;
+
+    /**
+     * Randomly return a real city name.
+     */
+    public function city(): string;
+
+    /**
+     * @example 86039-9874
+     */
+    public function postcode(): string;
+
+    /**
+     * @example 'Crist Parks'
+     */
+    public function streetName(): string;
+
+    /**
+     * @example '791 Crist Parks'
+     */
+    public function streetAddress(): string;
+
+    /**
+     * Randomly return a building number.
+     */
+    public function buildingNumber(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/BarcodeExtension.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface BarcodeExtension extends Extension
+{
+    /**
+     * Get a random EAN13 barcode.
+     *
+     * @example '4006381333931'
+     */
+    public function ean13(): string;
+
+    /**
+     * Get a random EAN8 barcode.
+     *
+     * @example '73513537'
+     */
+    public function ean8(): string;
+
+    /**
+     * Get a random ISBN-10 code
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number
+     *
+     * @example '4881416324'
+     */
+    public function isbn10(): string;
+
+    /**
+     * Get a random ISBN-13 code
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number
+     *
+     * @example '9790404436093'
+     */
+    public function isbn13(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/BloodExtension.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface BloodExtension extends Extension
+{
+    /**
+     * Get an actual blood type
+     *
+     * @example 'AB'
+     */
+    public function bloodType(): string;
+
+    /**
+     * Get a random resis value
+     *
+     * @example '+'
+     */
+    public function bloodRh(): string;
+
+    /**
+     * Get a full blood group
+     *
+     * @example 'AB+'
+     */
+    public function bloodGroup(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/ColorExtension.php

@@ -0,0 +1,63 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface ColorExtension extends Extension
+{
+    /**
+     * @example '#fa3cc2'
+     */
+    public function hexColor(): string;
+
+    /**
+     * @example '#ff0044'
+     */
+    public function safeHexColor(): string;
+
+    /**
+     * @example 'array(0,255,122)'
+     *
+     * @return int[]
+     */
+    public function rgbColorAsArray(): array;
+
+    /**
+     * @example '0,255,122'
+     */
+    public function rgbColor(): string;
+
+    /**
+     * @example 'rgb(0,255,122)'
+     */
+    public function rgbCssColor(): string;
+
+    /**
+     * @example 'rgba(0,255,122,0.8)'
+     */
+    public function rgbaCssColor(): string;
+
+    /**
+     * @example 'blue'
+     */
+    public function safeColorName(): string;
+
+    /**
+     * @example 'NavajoWhite'
+     */
+    public function colorName(): string;
+
+    /**
+     * @example '340,50,20'
+     */
+    public function hslColor(): string;
+
+    /**
+     * @example array(340, 50, 20)
+     *
+     * @return int[]
+     */
+    public function hslColorAsArray(): array;
+}

vendor/fakerphp/faker/src/Faker/Extension/CompanyExtension.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface CompanyExtension extends Extension
+{
+    /**
+     * @example 'Acme Ltd'
+     */
+    public function company(): string;
+
+    /**
+     * @example 'Ltd'
+     */
+    public function companySuffix(): string;
+
+    public function jobTitle(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/CountryExtension.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface CountryExtension extends Extension
+{
+    /**
+     * @example 'Japan'
+     */
+    public function country(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/DateTimeExtension.php

@@ -0,0 +1,242 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * FakerPHP extension for Date-related randomization.
+ *
+ * Functions accepting a date string use the `strtotime()` function internally.
+ *
+ * @experimental
+ *
+ * @since 1.20.0
+ */
+interface DateTimeExtension
+{
+    /**
+     * Get a DateTime object between January 1, 1970, and `$until` (defaults to "now").
+     *
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone zone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     *
+     * @example DateTime('2005-08-16 20:39:21')
+     */
+    public function dateTime($until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a DateTime object for a date between January 1, 0001, and now.
+     *
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone zone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @example DateTime('1265-03-22 21:15:52')
+     *
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeAD($until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a DateTime object a random date between `$from` and `$until`.
+     * Accepts date strings that can be recognized by `strtotime()`.
+     *
+     * @param \DateTime|string     $from     defaults to 30 years ago
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone zone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeBetween($from = '-30 years', $until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a DateTime object based on a random date between `$from` and an interval.
+     * Accepts date string that can be recognized by `strtotime()`.
+     *
+     * @param \DateTime|int|string $from     defaults to 30 years ago
+     * @param string               $interval defaults to 5 days after
+     * @param string|null          $timezone zone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeInInterval($from = '-30 years', string $interval = '+5 days', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a date time object somewhere inside the current week.
+     *
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone zone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeThisWeek($until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a date time object somewhere inside the current month.
+     *
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeThisMonth($until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a date time object somewhere inside the current year.
+     *
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeThisYear($until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a date time object somewhere inside the current decade.
+     *
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeThisDecade($until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a date time object somewhere inside the current century.
+     *
+     * @param \DateTime|int|string $until    maximum timestamp, defaults to "now"
+     * @param string|null          $timezone timezone for generated date, fallback to `DateTime::$defaultTimezone` and `date_default_timezone_get()`.
+     *
+     * @see \DateTimeZone
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public function dateTimeThisCentury($until = 'now', ?string $timezone = null): \DateTime;
+
+    /**
+     * Get a date string between January 1, 1970, and `$until`.
+     *
+     * @param string               $format DateTime format
+     * @param \DateTime|int|string $until  maximum timestamp, defaults to "now"
+     *
+     * @see https://www.php.net/manual/en/datetime.format.php
+     */
+    public function date(string $format = 'Y-m-d', $until = 'now'): string;
+
+    /**
+     * Get a time string (24h format by default).
+     *
+     * @param string               $format DateTime format
+     * @param \DateTime|int|string $until  maximum timestamp, defaults to "now"
+     *
+     * @see https://www.php.net/manual/en/datetime.format.php
+     */
+    public function time(string $format = 'H:i:s', $until = 'now'): string;
+
+    /**
+     * Get a UNIX (POSIX-compatible) timestamp between January 1, 1970, and `$until`.
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     */
+    public function unixTime($until = 'now'): int;
+
+    /**
+     * Get a date string according to the ISO-8601 standard.
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     */
+    public function iso8601($until = 'now'): string;
+
+    /**
+     * Get a string containing either "am" or "pm".
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     *
+     * @example 'am'
+     */
+    public function amPm($until = 'now'): string;
+
+    /**
+     * Get a localized random day of the month.
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     *
+     * @example '16'
+     */
+    public function dayOfMonth($until = 'now'): string;
+
+    /**
+     * Get a localized random day of the week.
+     *
+     * Uses internal DateTime formatting, hence PHP's internal locale will be used (change using `setlocale()`).
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     *
+     * @example 'Tuesday'
+     *
+     * @see setlocale
+     * @see https://www.php.net/manual/en/function.setlocale.php Set a different output language
+     */
+    public function dayOfWeek($until = 'now'): string;
+
+    /**
+     * Get a random month (numbered).
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     *
+     * @example '7'
+     */
+    public function month($until = 'now'): string;
+
+    /**
+     * Get a random month.
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     *
+     * @see setlocale
+     * @see https://www.php.net/manual/en/function.setlocale.php Set a different output language
+     *
+     * @example 'September'
+     */
+    public function monthName($until = 'now'): string;
+
+    /**
+     * Get a random year between 1970 and `$until`.
+     *
+     * @param \DateTime|int|string $until maximum timestamp, defaults to "now"
+     *
+     * @example '1987'
+     */
+    public function year($until = 'now'): string;
+
+    /**
+     * Get a random century, formatted as Roman numerals.
+     *
+     * @example 'XVII'
+     */
+    public function century(): string;
+
+    /**
+     * Get a random timezone, uses `\DateTimeZone::listIdentifiers()` internally.
+     *
+     * @param string|null $countryCode two-letter ISO 3166-1 compatible country code
+     *
+     * @example 'Europe/Rome'
+     */
+    public function timezone(?string $countryCode = null): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/Extension.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Extension;
+
+/**
+ * An extension is the only way to add new functionality to Faker.
+ *
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface Extension
+{
+}

vendor/fakerphp/faker/src/Faker/Extension/ExtensionNotFound.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class ExtensionNotFound extends \LogicException
+{
+}

vendor/fakerphp/faker/src/Faker/Extension/FileExtension.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface FileExtension extends Extension
+{
+    /**
+     * Get a random MIME type
+     *
+     * @example 'video/avi'
+     */
+    public function mimeType(): string;
+
+    /**
+     * Get a random file extension (without a dot)
+     *
+     * @example avi
+     */
+    public function extension(): string;
+
+    /**
+     * Get a full path to a new real file on the system.
+     */
+    public function filePath(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/GeneratorAwareExtension.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Extension;
+
+use Faker\Generator;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface GeneratorAwareExtension extends Extension
+{
+    /**
+     * This method MUST be implemented in such a way as to retain the
+     * immutability of the extension, and MUST return an instance that has the
+     * new Generator.
+     */
+    public function withGenerator(Generator $generator): Extension;
+}

vendor/fakerphp/faker/src/Faker/Extension/GeneratorAwareExtensionTrait.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Faker\Extension;
+
+use Faker\Generator;
+
+/**
+ * A helper trait to be used with GeneratorAwareExtension.
+ */
+trait GeneratorAwareExtensionTrait
+{
+    /**
+     * @var Generator|null
+     */
+    private $generator;
+
+    /**
+     * @return static
+     */
+    public function withGenerator(Generator $generator): Extension
+    {
+        $instance = clone $this;
+
+        $instance->generator = $generator;
+
+        return $instance;
+    }
+}

vendor/fakerphp/faker/src/Faker/Extension/Helper.php

@@ -0,0 +1,106 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * A class with some methods that may make building extensions easier.
+ *
+ * @experimental This class is experimental and does not fall under our BC promise
+ */
+final class Helper
+{
+    /**
+     * Returns a random element from a passed array.
+     */
+    public static function randomElement(array $array)
+    {
+        if ($array === []) {
+            return null;
+        }
+
+        return $array[array_rand($array, 1)];
+    }
+
+    /**
+     * Replaces all hash sign ('#') occurrences with a random number
+     * Replaces all percentage sign ('%') occurrences with a non-zero number.
+     *
+     * @param string $string String that needs to bet parsed
+     */
+    public static function numerify(string $string): string
+    {
+        // instead of using randomDigit() several times, which is slow,
+        // count the number of hashes and generate once a large number
+        $toReplace = [];
+
+        if (($pos = strpos($string, '#')) !== false) {
+            for ($i = $pos, $last = strrpos($string, '#', $pos) + 1; $i < $last; ++$i) {
+                if ($string[$i] === '#') {
+                    $toReplace[] = $i;
+                }
+            }
+        }
+
+        if ($nbReplacements = count($toReplace)) {
+            $maxAtOnce = strlen((string) mt_getrandmax()) - 1;
+            $numbers = '';
+            $i = 0;
+
+            while ($i < $nbReplacements) {
+                $size = min($nbReplacements - $i, $maxAtOnce);
+                $numbers .= str_pad((string) mt_rand(0, 10 ** $size - 1), $size, '0', STR_PAD_LEFT);
+                $i += $size;
+            }
+
+            for ($i = 0; $i < $nbReplacements; ++$i) {
+                $string[$toReplace[$i]] = $numbers[$i];
+            }
+        }
+
+        return self::replaceWildcard($string, '%', static function () {
+            return mt_rand(1, 9);
+        });
+    }
+
+    /**
+     * Replaces all question mark ('?') occurrences with a random letter.
+     *
+     * @param string $string String that needs to bet parsed
+     */
+    public static function lexify(string $string): string
+    {
+        return self::replaceWildcard($string, '?', static function () {
+            return chr(mt_rand(97, 122));
+        });
+    }
+
+    /**
+     * Replaces hash signs ('#') and question marks ('?') with random numbers and letters
+     * An asterisk ('*') is replaced with either a random number or a random letter.
+     *
+     * @param string $string String that needs to bet parsed
+     */
+    public static function bothify(string $string): string
+    {
+        $string = self::replaceWildcard($string, '*', static function () {
+            return mt_rand(0, 1) === 1 ? '#' : '?';
+        });
+
+        return self::lexify(self::numerify($string));
+    }
+
+    private static function replaceWildcard(string $string, string $wildcard, callable $callback): string
+    {
+        if (($pos = strpos($string, $wildcard)) === false) {
+            return $string;
+        }
+
+        for ($i = $pos, $last = strrpos($string, $wildcard, $pos) + 1; $i < $last; ++$i) {
+            if ($string[$i] === $wildcard) {
+                $string[$i] = call_user_func($callback);
+            }
+        }
+
+        return $string;
+    }
+}

vendor/fakerphp/faker/src/Faker/Extension/NumberExtension.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface NumberExtension extends Extension
+{
+    /**
+     * Returns a random number between $int1 and $int2 (any order)
+     *
+     * @param int $min default to 0
+     * @param int $max defaults to 32 bit max integer, ie 2147483647
+     *
+     * @example 79907610
+     */
+    public function numberBetween(int $min, int $max): int;
+
+    /**
+     * Returns a random number between 0 and 9
+     */
+    public function randomDigit(): int;
+
+    /**
+     * Generates a random digit, which cannot be $except
+     */
+    public function randomDigitNot(int $except): int;
+
+    /**
+     * Returns a random number between 1 and 9
+     */
+    public function randomDigitNotZero(): int;
+
+    /**
+     * Return a random float number
+     *
+     * @example 48.8932
+     */
+    public function randomFloat(?int $nbMaxDecimals, float $min, ?float $max): float;
+
+    /**
+     * Returns a random integer with 0 to $nbDigits digits.
+     *
+     * The maximum value returned is mt_getrandmax()
+     *
+     * @param int|null $nbDigits Defaults to a random number between 1 and 9
+     * @param bool     $strict   Whether the returned number should have exactly $nbDigits
+     *
+     * @example 79907610
+     */
+    public function randomNumber(?int $nbDigits, bool $strict): int;
+}

vendor/fakerphp/faker/src/Faker/Extension/PersonExtension.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface PersonExtension extends Extension
+{
+    public const GENDER_FEMALE = 'female';
+    public const GENDER_MALE = 'male';
+
+    /**
+     * @param string|null $gender 'male', 'female' or null for any
+     *
+     * @example 'John Doe'
+     */
+    public function name(?string $gender = null): string;
+
+    /**
+     * @param string|null $gender 'male', 'female' or null for any
+     *
+     * @example 'John'
+     */
+    public function firstName(?string $gender = null): string;
+
+    public function firstNameMale(): string;
+
+    public function firstNameFemale(): string;
+
+    /**
+     * @example 'Doe'
+     */
+    public function lastName(): string;
+
+    /**
+     * @example 'Mrs.'
+     *
+     * @param string|null $gender 'male', 'female' or null for any
+     */
+    public function title(?string $gender = null): string;
+
+    /**
+     * @example 'Mr.'
+     */
+    public function titleMale(): string;
+
+    /**
+     * @example 'Mrs.'
+     */
+    public function titleFemale(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/PhoneNumberExtension.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface PhoneNumberExtension extends Extension
+{
+    /**
+     * @example '555-123-546'
+     */
+    public function phoneNumber(): string;
+
+    /**
+     * @example +27113456789
+     */
+    public function e164PhoneNumber(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/UuidExtension.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface UuidExtension extends Extension
+{
+    /**
+     * Generate name based md5 UUID (version 3).
+     *
+     * @example '7e57d004-2b97-0e7a-b45f-5387367791cd'
+     */
+    public function uuid3(): string;
+}

vendor/fakerphp/faker/src/Faker/Extension/VersionExtension.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Faker\Extension;
+
+/**
+ * @experimental This interface is experimental and does not fall under our BC promise
+ */
+interface VersionExtension extends Extension
+{
+    /**
+     * Get a version number in semantic versioning syntax 2.0.0. (https://semver.org/spec/v2.0.0.html)
+     *
+     * @param bool $preRelease Pre release parts may be randomly included
+     * @param bool $build      Build parts may be randomly included
+     *
+     * @example 1.0.0
+     * @example 1.0.0-alpha.1
+     * @example 1.0.0-alpha.1+b71f04d
+     */
+    public function semver(bool $preRelease = false, bool $build = false): string;
+}

vendor/fakerphp/faker/src/Faker/Factory.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace Faker;
+
+class Factory
+{
+    public const DEFAULT_LOCALE = 'en_US';
+
+    protected static $defaultProviders = ['Address', 'Barcode', 'Biased', 'Color', 'Company', 'DateTime', 'File', 'HtmlLorem', 'Image', 'Internet', 'Lorem', 'Medical', 'Miscellaneous', 'Payment', 'Person', 'PhoneNumber', 'Text', 'UserAgent', 'Uuid'];
+
+    /**
+     * Create a new generator
+     *
+     * @param string $locale
+     *
+     * @return Generator
+     */
+    public static function create($locale = self::DEFAULT_LOCALE)
+    {
+        $generator = new Generator();
+
+        foreach (static::$defaultProviders as $provider) {
+            $providerClassName = self::getProviderClassname($provider, $locale);
+            $generator->addProvider(new $providerClassName($generator));
+        }
+
+        return $generator;
+    }
+
+    /**
+     * @param string $provider
+     * @param string $locale
+     *
+     * @return string
+     */
+    protected static function getProviderClassname($provider, $locale = '')
+    {
+        if ($providerClass = self::findProviderClassname($provider, $locale)) {
+            return $providerClass;
+        }
+
+        // fallback to default locale
+        if ($providerClass = self::findProviderClassname($provider, static::DEFAULT_LOCALE)) {
+            return $providerClass;
+        }
+
+        // fallback to no locale
+        if ($providerClass = self::findProviderClassname($provider)) {
+            return $providerClass;
+        }
+
+        throw new \InvalidArgumentException(sprintf('Unable to find provider "%s" with locale "%s"', $provider, $locale));
+    }
+
+    /**
+     * @param string $provider
+     * @param string $locale
+     *
+     * @return string|null
+     */
+    protected static function findProviderClassname($provider, $locale = '')
+    {
+        $providerClass = 'Faker\\' . ($locale ? sprintf('Provider\%s\%s', $locale, $provider) : sprintf('Provider\%s', $provider));
+
+        if (class_exists($providerClass, true)) {
+            return $providerClass;
+        }
+
+        return null;
+    }
+}

vendor/fakerphp/faker/src/Faker/Generator.php

@@ -0,0 +1,985 @@
+<?php
+
+namespace Faker;
+
+use Faker\Container\ContainerInterface;
+
+/**
+ * @property string $citySuffix
+ *
+ * @method string citySuffix()
+ *
+ * @property string $streetSuffix
+ *
+ * @method string streetSuffix()
+ *
+ * @property string $buildingNumber
+ *
+ * @method string buildingNumber()
+ *
+ * @property string $city
+ *
+ * @method string city()
+ *
+ * @property string $streetName
+ *
+ * @method string streetName()
+ *
+ * @property string $streetAddress
+ *
+ * @method string streetAddress()
+ *
+ * @property string $postcode
+ *
+ * @method string postcode()
+ *
+ * @property string $address
+ *
+ * @method string address()
+ *
+ * @property string $country
+ *
+ * @method string country()
+ *
+ * @property float $latitude
+ *
+ * @method float latitude($min = -90, $max = 90)
+ *
+ * @property float $longitude
+ *
+ * @method float longitude($min = -180, $max = 180)
+ *
+ * @property float[] $localCoordinates
+ *
+ * @method float[] localCoordinates()
+ *
+ * @property int $randomDigitNotNull
+ *
+ * @method int randomDigitNotNull()
+ *
+ * @property mixed $passthrough
+ *
+ * @method mixed passthrough($value)
+ *
+ * @property string $randomLetter
+ *
+ * @method string randomLetter()
+ *
+ * @property string $randomAscii
+ *
+ * @method string randomAscii()
+ *
+ * @property array $randomElements
+ *
+ * @method array randomElements($array = ['a', 'b', 'c'], $count = 1, $allowDuplicates = false)
+ *
+ * @property mixed $randomElement
+ *
+ * @method mixed randomElement($array = ['a', 'b', 'c'])
+ *
+ * @property int|string|null $randomKey
+ *
+ * @method int|string|null randomKey($array = [])
+ *
+ * @property array|string $shuffle
+ *
+ * @method array|string shuffle($arg = '')
+ *
+ * @property array $shuffleArray
+ *
+ * @method array shuffleArray($array = [])
+ *
+ * @property string $shuffleString
+ *
+ * @method string shuffleString($string = '', $encoding = 'UTF-8')
+ *
+ * @property string $numerify
+ *
+ * @method string numerify($string = '###')
+ *
+ * @property string $lexify
+ *
+ * @method string lexify($string = '????')
+ *
+ * @property string $bothify
+ *
+ * @method string bothify($string = '## ??')
+ *
+ * @property string $asciify
+ *
+ * @method string asciify($string = '****')
+ *
+ * @property string $regexify
+ *
+ * @method string regexify($regex = '')
+ *
+ * @property string $toLower
+ *
+ * @method string toLower($string = '')
+ *
+ * @property string $toUpper
+ *
+ * @method string toUpper($string = '')
+ *
+ * @property int $biasedNumberBetween
+ *
+ * @method int biasedNumberBetween($min = 0, $max = 100, $function = 'sqrt')
+ *
+ * @property string $hexColor
+ *
+ * @method string hexColor()
+ *
+ * @property string $safeHexColor
+ *
+ * @method string safeHexColor()
+ *
+ * @property array $rgbColorAsArray
+ *
+ * @method array rgbColorAsArray()
+ *
+ * @property string $rgbColor
+ *
+ * @method string rgbColor()
+ *
+ * @property string $rgbCssColor
+ *
+ * @method string rgbCssColor()
+ *
+ * @property string $rgbaCssColor
+ *
+ * @method string rgbaCssColor()
+ *
+ * @property string $safeColorName
+ *
+ * @method string safeColorName()
+ *
+ * @property string $colorName
+ *
+ * @method string colorName()
+ *
+ * @property string $hslColor
+ *
+ * @method string hslColor()
+ *
+ * @property array $hslColorAsArray
+ *
+ * @method array hslColorAsArray()
+ *
+ * @property string $company
+ *
+ * @method string company()
+ *
+ * @property string $companySuffix
+ *
+ * @method string companySuffix()
+ *
+ * @property string $jobTitle
+ *
+ * @method string jobTitle()
+ *
+ * @property int $unixTime
+ *
+ * @method int unixTime($max = 'now')
+ *
+ * @property \DateTime $dateTime
+ *
+ * @method \DateTime dateTime($max = 'now', $timezone = null)
+ *
+ * @property \DateTime $dateTimeAD
+ *
+ * @method \DateTime dateTimeAD($max = 'now', $timezone = null)
+ *
+ * @property string $iso8601
+ *
+ * @method string iso8601($max = 'now')
+ *
+ * @property string $date
+ *
+ * @method string date($format = 'Y-m-d', $max = 'now')
+ *
+ * @property string $time
+ *
+ * @method string time($format = 'H:i:s', $max = 'now')
+ *
+ * @property \DateTime $dateTimeBetween
+ *
+ * @method \DateTime dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null)
+ *
+ * @property \DateTime $dateTimeInInterval
+ *
+ * @method \DateTime dateTimeInInterval($date = '-30 years', $interval = '+5 days', $timezone = null)
+ *
+ * @property \DateTime $dateTimeThisCentury
+ *
+ * @method \DateTime dateTimeThisCentury($max = 'now', $timezone = null)
+ *
+ * @property \DateTime $dateTimeThisDecade
+ *
+ * @method \DateTime dateTimeThisDecade($max = 'now', $timezone = null)
+ *
+ * @property \DateTime $dateTimeThisYear
+ *
+ * @method \DateTime dateTimeThisYear($max = 'now', $timezone = null)
+ *
+ * @property \DateTime $dateTimeThisMonth
+ *
+ * @method \DateTime dateTimeThisMonth($max = 'now', $timezone = null)
+ *
+ * @property string $amPm
+ *
+ * @method string amPm($max = 'now')
+ *
+ * @property string $dayOfMonth
+ *
+ * @method string dayOfMonth($max = 'now')
+ *
+ * @property string $dayOfWeek
+ *
+ * @method string dayOfWeek($max = 'now')
+ *
+ * @property string $month
+ *
+ * @method string month($max = 'now')
+ *
+ * @property string $monthName
+ *
+ * @method string monthName($max = 'now')
+ *
+ * @property string $year
+ *
+ * @method string year($max = 'now')
+ *
+ * @property string $century
+ *
+ * @method string century()
+ *
+ * @property string $timezone
+ *
+ * @method string timezone($countryCode = null)
+ *
+ * @property void $setDefaultTimezone
+ *
+ * @method void setDefaultTimezone($timezone = null)
+ *
+ * @property string $getDefaultTimezone
+ *
+ * @method string getDefaultTimezone()
+ *
+ * @property string $file
+ *
+ * @method string file($sourceDirectory = '/tmp', $targetDirectory = '/tmp', $fullPath = true)
+ *
+ * @property string $randomHtml
+ *
+ * @method string randomHtml($maxDepth = 4, $maxWidth = 4)
+ *
+ * @property string $imageUrl
+ *
+ * @method string imageUrl($width = 640, $height = 480, $category = null, $randomize = true, $word = null, $gray = false, string $format = 'png')
+ *
+ * @property string $image
+ *
+ * @method string image($dir = null, $width = 640, $height = 480, $category = null, $fullPath = true, $randomize = true, $word = null, $gray = false, string $format = 'png')
+ *
+ * @property string $email
+ *
+ * @method string email()
+ *
+ * @property string $safeEmail
+ *
+ * @method string safeEmail()
+ *
+ * @property string $freeEmail
+ *
+ * @method string freeEmail()
+ *
+ * @property string $companyEmail
+ *
+ * @method string companyEmail()
+ *
+ * @property string $freeEmailDomain
+ *
+ * @method string freeEmailDomain()
+ *
+ * @property string $safeEmailDomain
+ *
+ * @method string safeEmailDomain()
+ *
+ * @property string $userName
+ *
+ * @method string userName()
+ *
+ * @property string $password
+ *
+ * @method string password($minLength = 6, $maxLength = 20)
+ *
+ * @property string $domainName
+ *
+ * @method string domainName()
+ *
+ * @property string $domainWord
+ *
+ * @method string domainWord()
+ *
+ * @property string $tld
+ *
+ * @method string tld()
+ *
+ * @property string $url
+ *
+ * @method string url()
+ *
+ * @property string $slug
+ *
+ * @method string slug($nbWords = 6, $variableNbWords = true)
+ *
+ * @property string $ipv4
+ *
+ * @method string ipv4()
+ *
+ * @property string $ipv6
+ *
+ * @method string ipv6()
+ *
+ * @property string $localIpv4
+ *
+ * @method string localIpv4()
+ *
+ * @property string $macAddress
+ *
+ * @method string macAddress()
+ *
+ * @property string $word
+ *
+ * @method string word()
+ *
+ * @property array|string $words
+ *
+ * @method array|string words($nb = 3, $asText = false)
+ *
+ * @property string $sentence
+ *
+ * @method string sentence($nbWords = 6, $variableNbWords = true)
+ *
+ * @property array|string $sentences
+ *
+ * @method array|string sentences($nb = 3, $asText = false)
+ *
+ * @property string $paragraph
+ *
+ * @method string paragraph($nbSentences = 3, $variableNbSentences = true)
+ *
+ * @property array|string $paragraphs
+ *
+ * @method array|string paragraphs($nb = 3, $asText = false)
+ *
+ * @property string $text
+ *
+ * @method string text($maxNbChars = 200)
+ *
+ * @property bool $boolean
+ *
+ * @method bool boolean($chanceOfGettingTrue = 50)
+ *
+ * @property string $md5
+ *
+ * @method string md5()
+ *
+ * @property string $sha1
+ *
+ * @method string sha1()
+ *
+ * @property string $sha256
+ *
+ * @method string sha256()
+ *
+ * @property string $locale
+ *
+ * @method string locale()
+ *
+ * @property string $countryCode
+ *
+ * @method string countryCode()
+ *
+ * @property string $countryISOAlpha3
+ *
+ * @method string countryISOAlpha3()
+ *
+ * @property string $languageCode
+ *
+ * @method string languageCode()
+ *
+ * @property string $currencyCode
+ *
+ * @method string currencyCode()
+ *
+ * @property string $emoji
+ *
+ * @method string emoji()
+ *
+ * @property string $creditCardType
+ *
+ * @method string creditCardType()
+ *
+ * @property string $creditCardNumber
+ *
+ * @method string creditCardNumber($type = null, $formatted = false, $separator = '-')
+ *
+ * @property \DateTime $creditCardExpirationDate
+ *
+ * @method \DateTime creditCardExpirationDate($valid = true)
+ *
+ * @property string $creditCardExpirationDateString
+ *
+ * @method string creditCardExpirationDateString($valid = true, $expirationDateFormat = null)
+ *
+ * @property array $creditCardDetails
+ *
+ * @method array creditCardDetails($valid = true)
+ *
+ * @property string $iban
+ *
+ * @method string iban($countryCode = null, $prefix = '', $length = null)
+ *
+ * @property string $swiftBicNumber
+ *
+ * @method string swiftBicNumber()
+ *
+ * @property string $name
+ *
+ * @method string name($gender = null)
+ *
+ * @property string $firstName
+ *
+ * @method string firstName($gender = null)
+ *
+ * @property string $firstNameMale
+ *
+ * @method string firstNameMale()
+ *
+ * @property string $firstNameFemale
+ *
+ * @method string firstNameFemale()
+ *
+ * @property string $lastName
+ *
+ * @method string lastName($gender = null)
+ *
+ * @property string $title
+ *
+ * @method string title($gender = null)
+ *
+ * @property string $titleMale
+ *
+ * @method string titleMale()
+ *
+ * @property string $titleFemale
+ *
+ * @method string titleFemale()
+ *
+ * @property string $phoneNumber
+ *
+ * @method string phoneNumber()
+ *
+ * @property string $e164PhoneNumber
+ *
+ * @method string e164PhoneNumber()
+ *
+ * @property int $imei
+ *
+ * @method int imei()
+ *
+ * @property string $realText
+ *
+ * @method string realText($maxNbChars = 200, $indexSize = 2)
+ *
+ * @property string $realTextBetween
+ *
+ * @method string realTextBetween($minNbChars = 160, $maxNbChars = 200, $indexSize = 2)
+ *
+ * @property string $macProcessor
+ *
+ * @method string macProcessor()
+ *
+ * @property string $linuxProcessor
+ *
+ * @method string linuxProcessor()
+ *
+ * @property string $userAgent
+ *
+ * @method string userAgent()
+ *
+ * @property string $chrome
+ *
+ * @method string chrome()
+ *
+ * @property string $msedge
+ *
+ * @method string msedge()
+ *
+ * @property string $firefox
+ *
+ * @method string firefox()
+ *
+ * @property string $safari
+ *
+ * @method string safari()
+ *
+ * @property string $opera
+ *
+ * @method string opera()
+ *
+ * @property string $internetExplorer
+ *
+ * @method string internetExplorer()
+ *
+ * @property string $windowsPlatformToken
+ *
+ * @method string windowsPlatformToken()
+ *
+ * @property string $macPlatformToken
+ *
+ * @method string macPlatformToken()
+ *
+ * @property string $iosMobileToken
+ *
+ * @method string iosMobileToken()
+ *
+ * @property string $linuxPlatformToken
+ *
+ * @method string linuxPlatformToken()
+ *
+ * @property string $uuid
+ *
+ * @method string uuid()
+ */
+class Generator
+{
+    protected $providers = [];
+    protected $formatters = [];
+
+    private $container;
+
+    /**
+     * @var UniqueGenerator
+     */
+    private $uniqueGenerator;
+
+    public function __construct(?ContainerInterface $container = null)
+    {
+        $this->container = $container ?: Container\ContainerBuilder::withDefaultExtensions()->build();
+    }
+
+    /**
+     * @template T of Extension\Extension
+     *
+     * @param class-string<T> $id
+     *
+     * @throws Extension\ExtensionNotFound
+     *
+     * @return T
+     */
+    public function ext(string $id): Extension\Extension
+    {
+        if (!$this->container->has($id)) {
+            throw new Extension\ExtensionNotFound(sprintf(
+                'No Faker extension with id "%s" was loaded.',
+                $id,
+            ));
+        }
+
+        $extension = $this->container->get($id);
+
+        if ($extension instanceof Extension\GeneratorAwareExtension) {
+            $extension = $extension->withGenerator($this);
+        }
+
+        return $extension;
+    }
+
+    public function addProvider($provider)
+    {
+        array_unshift($this->providers, $provider);
+
+        $this->formatters = [];
+    }
+
+    public function getProviders()
+    {
+        return $this->providers;
+    }
+
+    /**
+     * With the unique generator you are guaranteed to never get the same two
+     * values.
+     *
+     * <code>
+     * // will never return twice the same value
+     * $faker->unique()->randomElement(array(1, 2, 3));
+     * </code>
+     *
+     * @param bool $reset      If set to true, resets the list of existing values
+     * @param int  $maxRetries Maximum number of retries to find a unique value,
+     *                         After which an OverflowException is thrown.
+     *
+     * @throws \OverflowException When no unique value can be found by iterating $maxRetries times
+     *
+     * @return self A proxy class returning only non-existing values
+     */
+    public function unique($reset = false, $maxRetries = 10000)
+    {
+        if ($reset || $this->uniqueGenerator === null) {
+            $this->uniqueGenerator = new UniqueGenerator($this, $maxRetries);
+        }
+
+        return $this->uniqueGenerator;
+    }
+
+    /**
+     * Get a value only some percentage of the time.
+     *
+     * @param float $weight A probability between 0 and 1, 0 means that we always get the default value.
+     *
+     * @return self
+     */
+    public function optional(float $weight = 0.5, $default = null)
+    {
+        if ($weight > 1) {
+            trigger_deprecation('fakerphp/faker', '1.16', 'First argument ($weight) to method "optional()" must be between 0 and 1. You passed %f, we assume you meant %f.', $weight, $weight / 100);
+            $weight = $weight / 100;
+        }
+
+        return new ChanceGenerator($this, $weight, $default);
+    }
+
+    /**
+     * To make sure the value meet some criteria, pass a callable that verifies the
+     * output. If the validator fails, the generator will try again.
+     *
+     * The value validity is determined by a function passed as first argument.
+     *
+     * <code>
+     * $values = array();
+     * $evenValidator = function ($digit) {
+     *   return $digit % 2 === 0;
+     * };
+     * for ($i=0; $i < 10; $i++) {
+     *   $values []= $faker->valid($evenValidator)->randomDigit;
+     * }
+     * print_r($values); // [0, 4, 8, 4, 2, 6, 0, 8, 8, 6]
+     * </code>
+     *
+     * @param ?\Closure $validator  A function returning true for valid values
+     * @param int       $maxRetries Maximum number of retries to find a valid value,
+     *                              After which an OverflowException is thrown.
+     *
+     * @throws \OverflowException When no valid value can be found by iterating $maxRetries times
+     *
+     * @return self A proxy class returning only valid values
+     */
+    public function valid(?\Closure $validator = null, int $maxRetries = 10000)
+    {
+        return new ValidGenerator($this, $validator, $maxRetries);
+    }
+
+    public function seed($seed = null)
+    {
+        if ($seed === null) {
+            mt_srand();
+        } else {
+            mt_srand((int) $seed, self::mode());
+        }
+    }
+
+    /**
+     * @see https://www.php.net/manual/en/migration83.deprecated.php#migration83.deprecated.random
+     */
+    private static function mode(): int
+    {
+        if (PHP_VERSION_ID < 80300) {
+            return MT_RAND_PHP;
+        }
+
+        return MT_RAND_MT19937;
+    }
+
+    public function format($format, $arguments = [])
+    {
+        return call_user_func_array($this->getFormatter($format), $arguments);
+    }
+
+    /**
+     * @param string $format
+     *
+     * @return callable
+     */
+    public function getFormatter($format)
+    {
+        if (isset($this->formatters[$format])) {
+            return $this->formatters[$format];
+        }
+
+        if (method_exists($this, $format)) {
+            $this->formatters[$format] = [$this, $format];
+
+            return $this->formatters[$format];
+        }
+
+        // "Faker\Core\Barcode->ean13"
+        if (preg_match('|^([a-zA-Z0-9\\\]+)->([a-zA-Z0-9]+)$|', $format, $matches)) {
+            $this->formatters[$format] = [$this->ext($matches[1]), $matches[2]];
+
+            return $this->formatters[$format];
+        }
+
+        foreach ($this->providers as $provider) {
+            if (method_exists($provider, $format)) {
+                $this->formatters[$format] = [$provider, $format];
+
+                return $this->formatters[$format];
+            }
+        }
+
+        throw new \InvalidArgumentException(sprintf('Unknown format "%s"', $format));
+    }
+
+    /**
+     * Replaces tokens ('{{ tokenName }}') with the result from the token method call
+     *
+     * @param string $string String that needs to bet parsed
+     *
+     * @return string
+     */
+    public function parse($string)
+    {
+        $callback = function ($matches) {
+            return $this->format($matches[1]);
+        };
+
+        return preg_replace_callback('/{{\s?(\w+|[\w\\\]+->\w+?)\s?}}/u', $callback, $string);
+    }
+
+    /**
+     * Get a random MIME type
+     *
+     * @example 'video/avi'
+     */
+    public function mimeType()
+    {
+        return $this->ext(Extension\FileExtension::class)->mimeType();
+    }
+
+    /**
+     * Get a random file extension (without a dot)
+     *
+     * @example avi
+     */
+    public function fileExtension()
+    {
+        return $this->ext(Extension\FileExtension::class)->extension();
+    }
+
+    /**
+     * Get a full path to a new real file on the system.
+     */
+    public function filePath()
+    {
+        return $this->ext(Extension\FileExtension::class)->filePath();
+    }
+
+    /**
+     * Get an actual blood type
+     *
+     * @example 'AB'
+     */
+    public function bloodType(): string
+    {
+        return $this->ext(Extension\BloodExtension::class)->bloodType();
+    }
+
+    /**
+     * Get a random resis value
+     *
+     * @example '+'
+     */
+    public function bloodRh(): string
+    {
+        return $this->ext(Extension\BloodExtension::class)->bloodRh();
+    }
+
+    /**
+     * Get a full blood group
+     *
+     * @example 'AB+'
+     */
+    public function bloodGroup(): string
+    {
+        return $this->ext(Extension\BloodExtension::class)->bloodGroup();
+    }
+
+    /**
+     * Get a random EAN13 barcode.
+     *
+     * @example '4006381333931'
+     */
+    public function ean13(): string
+    {
+        return $this->ext(Extension\BarcodeExtension::class)->ean13();
+    }
+
+    /**
+     * Get a random EAN8 barcode.
+     *
+     * @example '73513537'
+     */
+    public function ean8(): string
+    {
+        return $this->ext(Extension\BarcodeExtension::class)->ean8();
+    }
+
+    /**
+     * Get a random ISBN-10 code
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number
+     *
+     * @example '4881416324'
+     */
+    public function isbn10(): string
+    {
+        return $this->ext(Extension\BarcodeExtension::class)->isbn10();
+    }
+
+    /**
+     * Get a random ISBN-13 code
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number
+     *
+     * @example '9790404436093'
+     */
+    public function isbn13(): string
+    {
+        return $this->ext(Extension\BarcodeExtension::class)->isbn13();
+    }
+
+    /**
+     * Returns a random number between $int1 and $int2 (any order)
+     *
+     * @example 79907610
+     */
+    public function numberBetween($int1 = 0, $int2 = 2147483647): int
+    {
+        return $this->ext(Extension\NumberExtension::class)->numberBetween((int) $int1, (int) $int2);
+    }
+
+    /**
+     * Returns a random number between 0 and 9
+     */
+    public function randomDigit(): int
+    {
+        return $this->ext(Extension\NumberExtension::class)->randomDigit();
+    }
+
+    /**
+     * Generates a random digit, which cannot be $except
+     */
+    public function randomDigitNot($except): int
+    {
+        return $this->ext(Extension\NumberExtension::class)->randomDigitNot((int) $except);
+    }
+
+    /**
+     * Returns a random number between 1 and 9
+     */
+    public function randomDigitNotZero(): int
+    {
+        return $this->ext(Extension\NumberExtension::class)->randomDigitNotZero();
+    }
+
+    /**
+     * Return a random float number
+     *
+     * @example 48.8932
+     */
+    public function randomFloat($nbMaxDecimals = null, $min = 0, $max = null): float
+    {
+        return $this->ext(Extension\NumberExtension::class)->randomFloat(
+            $nbMaxDecimals !== null ? (int) $nbMaxDecimals : null,
+            (float) $min,
+            $max !== null ? (float) $max : null,
+        );
+    }
+
+    /**
+     * Returns a random integer with 0 to $nbDigits digits.
+     *
+     * The maximum value returned is mt_getrandmax()
+     *
+     * @param int|null $nbDigits Defaults to a random number between 1 and 9
+     * @param bool     $strict   Whether the returned number should have exactly $nbDigits
+     *
+     * @example 79907610
+     */
+    public function randomNumber($nbDigits = null, $strict = false): int
+    {
+        return $this->ext(Extension\NumberExtension::class)->randomNumber(
+            $nbDigits !== null ? (int) $nbDigits : null,
+            (bool) $strict,
+        );
+    }
+
+    /**
+     * Get a version number in semantic versioning syntax 2.0.0. (https://semver.org/spec/v2.0.0.html)
+     *
+     * @param bool $preRelease Pre release parts may be randomly included
+     * @param bool $build      Build parts may be randomly included
+     *
+     * @example 1.0.0
+     * @example 1.0.0-alpha.1
+     * @example 1.0.0-alpha.1+b71f04d
+     */
+    public function semver(bool $preRelease = false, bool $build = false): string
+    {
+        return $this->ext(Extension\VersionExtension::class)->semver($preRelease, $build);
+    }
+
+    /**
+     * @deprecated
+     */
+    protected function callFormatWithMatches($matches)
+    {
+        trigger_deprecation('fakerphp/faker', '1.14', 'Protected method "callFormatWithMatches()" is deprecated and will be removed.');
+
+        return $this->format($matches[1]);
+    }
+
+    /**
+     * @param string $attribute
+     *
+     * @deprecated Use a method instead.
+     */
+    public function __get($attribute)
+    {
+        trigger_deprecation('fakerphp/faker', '1.14', 'Accessing property "%s" is deprecated, use "%s()" instead.', $attribute, $attribute);
+
+        return $this->format($attribute);
+    }
+
+    /**
+     * @param string $method
+     * @param array  $attributes
+     */
+    public function __call($method, $attributes)
+    {
+        return $this->format($method, $attributes);
+    }
+
+    public function __destruct()
+    {
+        $this->seed();
+    }
+
+    public function __wakeup()
+    {
+        $this->formatters = [];
+    }
+}

vendor/fakerphp/faker/src/Faker/Guesser/Name.php

@@ -0,0 +1,180 @@
+<?php
+
+namespace Faker\Guesser;
+
+use Faker\Provider\Base;
+
+class Name
+{
+    protected $generator;
+
+    public function __construct(\Faker\Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @param string   $name
+     * @param int|null $size Length of field, if known
+     *
+     * @return callable|null
+     */
+    public function guessFormat($name, $size = null)
+    {
+        $name = Base::toLower($name);
+        $generator = $this->generator;
+
+        if (preg_match('/^is[_A-Z]/', $name)) {
+            return static function () use ($generator) {
+                return $generator->boolean();
+            };
+        }
+
+        if (preg_match('/(_a|A)t$/', $name)) {
+            return static function () use ($generator) {
+                return $generator->dateTime();
+            };
+        }
+
+        switch (str_replace('_', '', $name)) {
+            case 'firstname':
+                return static function () use ($generator) {
+                    return $generator->firstName();
+                };
+
+            case 'lastname':
+                return static function () use ($generator) {
+                    return $generator->lastName();
+                };
+
+            case 'username':
+            case 'login':
+                return static function () use ($generator) {
+                    return $generator->userName();
+                };
+
+            case 'email':
+            case 'emailaddress':
+                return static function () use ($generator) {
+                    return $generator->email();
+                };
+
+            case 'phonenumber':
+            case 'phone':
+            case 'telephone':
+            case 'telnumber':
+                return static function () use ($generator) {
+                    return $generator->phoneNumber();
+                };
+
+            case 'address':
+                return static function () use ($generator) {
+                    return $generator->address();
+                };
+
+            case 'city':
+            case 'town':
+                return static function () use ($generator) {
+                    return $generator->city();
+                };
+
+            case 'streetaddress':
+                return static function () use ($generator) {
+                    return $generator->streetAddress();
+                };
+
+            case 'postcode':
+            case 'zipcode':
+                return static function () use ($generator) {
+                    return $generator->postcode();
+                };
+
+            case 'state':
+                return static function () use ($generator) {
+                    return $generator->state();
+                };
+
+            case 'county':
+                if ($this->generator->locale == 'en_US') {
+                    return static function () use ($generator) {
+                        return sprintf('%s County', $generator->city());
+                    };
+                }
+
+                return static function () use ($generator) {
+                    return $generator->state();
+                };
+
+            case 'country':
+                switch ($size) {
+                    case 2:
+                        return static function () use ($generator) {
+                            return $generator->countryCode();
+                        };
+
+                    case 3:
+                        return static function () use ($generator) {
+                            return $generator->countryISOAlpha3();
+                        };
+
+                    case 5:
+                    case 6:
+                        return static function () use ($generator) {
+                            return $generator->locale();
+                        };
+
+                    default:
+                        return static function () use ($generator) {
+                            return $generator->country();
+                        };
+                }
+
+                break;
+
+            case 'locale':
+                return static function () use ($generator) {
+                    return $generator->locale();
+                };
+
+            case 'currency':
+            case 'currencycode':
+                return static function () use ($generator) {
+                    return $generator->currencyCode();
+                };
+
+            case 'url':
+            case 'website':
+                return static function () use ($generator) {
+                    return $generator->url();
+                };
+
+            case 'company':
+            case 'companyname':
+            case 'employer':
+                return static function () use ($generator) {
+                    return $generator->company();
+                };
+
+            case 'title':
+                if ($size !== null && $size <= 10) {
+                    return static function () use ($generator) {
+                        return $generator->title();
+                    };
+                }
+
+                return static function () use ($generator) {
+                    return $generator->sentence();
+                };
+
+            case 'body':
+            case 'summary':
+            case 'article':
+            case 'description':
+                return static function () use ($generator) {
+                    return $generator->text();
+                };
+        }
+
+        return null;
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/CakePHP/ColumnTypeGuesser.php

@@ -0,0 +1,79 @@
+<?php
+
+namespace Faker\ORM\CakePHP;
+
+class ColumnTypeGuesser
+{
+    protected $generator;
+
+    public function __construct(\Faker\Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return \Closure|null
+     */
+    public function guessFormat($column, $table)
+    {
+        $generator = $this->generator;
+        $schema = $table->schema();
+
+        switch ($schema->columnType($column)) {
+            case 'boolean':
+                return static function () use ($generator) {
+                    return $generator->boolean;
+                };
+
+            case 'integer':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 2147483647);
+                };
+
+            case 'biginteger':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, PHP_INT_MAX);
+                };
+
+            case 'decimal':
+            case 'float':
+                return static function () use ($generator) {
+                    return $generator->randomFloat();
+                };
+
+            case 'uuid':
+                return static function () use ($generator) {
+                    return $generator->uuid();
+                };
+
+            case 'string':
+                if (method_exists($schema, 'getColumn')) {
+                    $columnData = $schema->getColumn($column);
+                } else {
+                    $columnData = $schema->column($column);
+                }
+                $length = $columnData['length'];
+
+                return static function () use ($generator, $length) {
+                    return $generator->text($length);
+                };
+
+            case 'text':
+                return static function () use ($generator) {
+                    return $generator->text();
+                };
+
+            case 'date':
+            case 'datetime':
+            case 'timestamp':
+            case 'time':
+                return static function () use ($generator) {
+                    return $generator->datetime();
+                };
+
+            case 'binary':
+            default:
+                return null;
+        }
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/CakePHP/EntityPopulator.php

@@ -0,0 +1,173 @@
+<?php
+
+namespace Faker\ORM\CakePHP;
+
+use Cake\ORM\TableRegistry;
+
+class EntityPopulator
+{
+    protected $class;
+    protected $connectionName;
+    protected $columnFormatters = [];
+    protected $modifiers = [];
+
+    public function __construct($class)
+    {
+        $this->class = $class;
+    }
+
+    /**
+     * @param string $name
+     */
+    public function __get($name)
+    {
+        return $this->{$name};
+    }
+
+    /**
+     * @param string $name
+     */
+    public function __set($name, $value)
+    {
+        $this->{$name} = $value;
+    }
+
+    public function mergeColumnFormattersWith($columnFormatters)
+    {
+        $this->columnFormatters = array_merge($this->columnFormatters, $columnFormatters);
+    }
+
+    public function mergeModifiersWith($modifiers)
+    {
+        $this->modifiers = array_merge($this->modifiers, $modifiers);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessColumnFormatters($populator)
+    {
+        $formatters = [];
+        $class = $this->class;
+        $table = $this->getTable($class);
+        $schema = $table->schema();
+        $pk = $schema->primaryKey();
+        $guessers = $populator->getGuessers() + ['ColumnTypeGuesser' => new ColumnTypeGuesser($populator->getGenerator())];
+        $isForeignKey = static function ($column) use ($table) {
+            foreach ($table->associations()->type('BelongsTo') as $assoc) {
+                if ($column == $assoc->foreignKey()) {
+                    return true;
+                }
+            }
+
+            return false;
+        };
+
+        foreach ($schema->columns() as $column) {
+            if ($column == $pk[0] || $isForeignKey($column)) {
+                continue;
+            }
+
+            foreach ($guessers as $guesser) {
+                if ($formatter = $guesser->guessFormat($column, $table)) {
+                    $formatters[$column] = $formatter;
+
+                    break;
+                }
+            }
+        }
+
+        return $formatters;
+    }
+
+    /**
+     * @return array
+     */
+    public function guessModifiers()
+    {
+        $modifiers = [];
+        $table = $this->getTable($this->class);
+
+        $belongsTo = $table->associations()->type('BelongsTo');
+
+        foreach ($belongsTo as $assoc) {
+            $modifiers['belongsTo' . $assoc->name()] = function ($data, $insertedEntities) use ($assoc) {
+                $table = $assoc->target();
+                $foreignModel = $table->alias();
+
+                $foreignKeys = [];
+
+                if (!empty($insertedEntities[$foreignModel])) {
+                    $foreignKeys = $insertedEntities[$foreignModel];
+                } else {
+                    $foreignKeys = $table->find('all')
+                    ->select(['id'])
+                    ->map(static function ($row) {
+                        return $row->id;
+                    })
+                    ->toArray();
+                }
+
+                if (empty($foreignKeys)) {
+                    throw new \Exception(sprintf('%s belongsTo %s, which seems empty at this point.', $this->getTable($this->class)->table(), $assoc->table()));
+                }
+
+                $foreignKey = $foreignKeys[array_rand($foreignKeys)];
+                $data[$assoc->foreignKey()] = $foreignKey;
+
+                return $data;
+            };
+        }
+
+        // TODO check if TreeBehavior attached to modify lft/rgt cols
+
+        return $modifiers;
+    }
+
+    /**
+     * @param array $options
+     */
+    public function execute($class, $insertedEntities, $options = [])
+    {
+        $table = $this->getTable($class);
+        $entity = $table->newEntity();
+
+        foreach ($this->columnFormatters as $column => $format) {
+            if (null !== $format) {
+                $entity->{$column} = is_callable($format) ? $format($insertedEntities, $table) : $format;
+            }
+        }
+
+        foreach ($this->modifiers as $modifier) {
+            $entity = $modifier($entity, $insertedEntities);
+        }
+
+        if (!$entity = $table->save($entity, $options)) {
+            throw new \RuntimeException("Failed saving $class record");
+        }
+
+        $pk = $table->primaryKey();
+
+        if (is_string($pk)) {
+            return $entity->{$pk};
+        }
+
+        return $entity->{$pk[0]};
+    }
+
+    public function setConnection($name)
+    {
+        $this->connectionName = $name;
+    }
+
+    protected function getTable($class)
+    {
+        $options = [];
+
+        if (!empty($this->connectionName)) {
+            $options['connection'] = $this->connectionName;
+        }
+
+        return TableRegistry::get($class, $options);
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/CakePHP/Populator.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace Faker\ORM\CakePHP;
+
+class Populator
+{
+    protected $generator;
+    protected $entities = [];
+    protected $quantities = [];
+    protected $guessers = [];
+
+    public function __construct(\Faker\Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return \Faker\Generator
+     */
+    public function getGenerator()
+    {
+        return $this->generator;
+    }
+
+    /**
+     * @return array
+     */
+    public function getGuessers()
+    {
+        return $this->guessers;
+    }
+
+    /**
+     * @return $this
+     */
+    public function removeGuesser($name)
+    {
+        if ($this->guessers[$name]) {
+            unset($this->guessers[$name]);
+        }
+
+        return $this;
+    }
+
+    /**
+     * @throws \Exception
+     *
+     * @return $this
+     */
+    public function addGuesser($class)
+    {
+        if (!is_object($class)) {
+            $class = new $class($this->generator);
+        }
+
+        if (!method_exists($class, 'guessFormat')) {
+            throw new \Exception('Missing required custom guesser method: ' . get_class($class) . '::guessFormat()');
+        }
+
+        $this->guessers[get_class($class)] = $class;
+
+        return $this;
+    }
+
+    /**
+     * @param array $customColumnFormatters
+     * @param array $customModifiers
+     *
+     * @return $this
+     */
+    public function addEntity($entity, $number, $customColumnFormatters = [], $customModifiers = [])
+    {
+        if (!$entity instanceof EntityPopulator) {
+            $entity = new EntityPopulator($entity);
+        }
+
+        $entity->columnFormatters = $entity->guessColumnFormatters($this);
+
+        if ($customColumnFormatters) {
+            $entity->mergeColumnFormattersWith($customColumnFormatters);
+        }
+
+        $entity->modifiers = $entity->guessModifiers($this);
+
+        if ($customModifiers) {
+            $entity->mergeModifiersWith($customModifiers);
+        }
+
+        $class = $entity->class;
+        $this->entities[$class] = $entity;
+        $this->quantities[$class] = $number;
+
+        return $this;
+    }
+
+    /**
+     * @param array $options
+     *
+     * @return array
+     */
+    public function execute($options = [])
+    {
+        $insertedEntities = [];
+
+        foreach ($this->quantities as $class => $number) {
+            for ($i = 0; $i < $number; ++$i) {
+                $insertedEntities[$class][] = $this->entities[$class]->execute($class, $insertedEntities, $options);
+            }
+        }
+
+        return $insertedEntities;
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Doctrine/ColumnTypeGuesser.php

@@ -0,0 +1,91 @@
+<?php
+
+namespace Faker\ORM\Doctrine;
+
+use Doctrine\Common\Persistence\Mapping\ClassMetadata;
+use Faker\Generator;
+
+require_once 'backward-compatibility.php';
+
+class ColumnTypeGuesser
+{
+    protected $generator;
+
+    public function __construct(Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return \Closure|null
+     */
+    public function guessFormat($fieldName, ClassMetadata $class)
+    {
+        $generator = $this->generator;
+        $type = $class->getTypeOfField($fieldName);
+
+        switch ($type) {
+            case 'boolean':
+                return static function () use ($generator) {
+                    return $generator->boolean();
+                };
+
+            case 'decimal':
+                $size = $class->fieldMappings[$fieldName]['precision'] ?? 2;
+
+                return static function () use ($generator, $size) {
+                    return $generator->randomNumber($size + 2) / 100;
+                };
+
+            case 'smallint':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 65535);
+                };
+
+            case 'integer':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 2147483647);
+                };
+
+            case 'bigint':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, PHP_INT_MAX);
+                };
+
+            case 'float':
+                return static function () use ($generator) {
+                    return $generator->randomFloat();
+                };
+
+            case 'string':
+                $size = $class->fieldMappings[$fieldName]['length'] ?? 255;
+
+                return static function () use ($generator, $size) {
+                    return $generator->text($size);
+                };
+
+            case 'text':
+                return static function () use ($generator) {
+                    return $generator->text();
+                };
+
+            case 'datetime':
+            case 'date':
+            case 'time':
+                return static function () use ($generator) {
+                    return $generator->datetime();
+                };
+
+            case 'datetime_immutable':
+            case 'date_immutable':
+            case 'time_immutable':
+                return static function () use ($generator) {
+                    return \DateTimeImmutable::createFromMutable($generator->datetime);
+                };
+
+            default:
+                // no smart way to guess what the user expects here
+                return null;
+        }
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Doctrine/EntityPopulator.php

@@ -0,0 +1,248 @@
+<?php
+
+namespace Faker\ORM\Doctrine;
+
+use Doctrine\Common\Persistence\Mapping\ClassMetadata;
+use Doctrine\Common\Persistence\ObjectManager;
+
+require_once 'backward-compatibility.php';
+
+/**
+ * Service class for populating a table through a Doctrine Entity class.
+ */
+class EntityPopulator
+{
+    /**
+     * @var ClassMetadata
+     */
+    protected $class;
+    /**
+     * @var array
+     */
+    protected $columnFormatters = [];
+    /**
+     * @var array
+     */
+    protected $modifiers = [];
+
+    public function __construct(ClassMetadata $class)
+    {
+        $this->class = $class;
+    }
+
+    /**
+     * @return string
+     */
+    public function getClass()
+    {
+        return $this->class->getName();
+    }
+
+    public function setColumnFormatters($columnFormatters)
+    {
+        $this->columnFormatters = $columnFormatters;
+    }
+
+    /**
+     * @return array
+     */
+    public function getColumnFormatters()
+    {
+        return $this->columnFormatters;
+    }
+
+    public function mergeColumnFormattersWith($columnFormatters)
+    {
+        $this->columnFormatters = array_merge($this->columnFormatters, $columnFormatters);
+    }
+
+    public function setModifiers(array $modifiers)
+    {
+        $this->modifiers = $modifiers;
+    }
+
+    /**
+     * @return array
+     */
+    public function getModifiers()
+    {
+        return $this->modifiers;
+    }
+
+    public function mergeModifiersWith(array $modifiers)
+    {
+        $this->modifiers = array_merge($this->modifiers, $modifiers);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessColumnFormatters(\Faker\Generator $generator)
+    {
+        $formatters = [];
+        $nameGuesser = new \Faker\Guesser\Name($generator);
+        $columnTypeGuesser = new ColumnTypeGuesser($generator);
+
+        foreach ($this->class->getFieldNames() as $fieldName) {
+            if ($this->class->isIdentifier($fieldName) || !$this->class->hasField($fieldName)) {
+                continue;
+            }
+
+            $size = $this->class->fieldMappings[$fieldName]['length'] ?? null;
+
+            if ($formatter = $nameGuesser->guessFormat($fieldName, $size)) {
+                $formatters[$fieldName] = $formatter;
+
+                continue;
+            }
+
+            if ($formatter = $columnTypeGuesser->guessFormat($fieldName, $this->class)) {
+                $formatters[$fieldName] = $formatter;
+
+                continue;
+            }
+        }
+
+        foreach ($this->class->getAssociationNames() as $assocName) {
+            if ($this->class->isCollectionValuedAssociation($assocName)) {
+                continue;
+            }
+
+            $relatedClass = $this->class->getAssociationTargetClass($assocName);
+
+            $unique = $optional = false;
+
+            if ($this->class instanceof \Doctrine\ORM\Mapping\ClassMetadata) {
+                $mappings = $this->class->getAssociationMappings();
+
+                foreach ($mappings as $mapping) {
+                    if ($mapping['targetEntity'] == $relatedClass) {
+                        if ($mapping['type'] == \Doctrine\ORM\Mapping\ClassMetadata::ONE_TO_ONE) {
+                            $unique = true;
+                            $optional = $mapping['joinColumns'][0]['nullable'] ?? false;
+
+                            break;
+                        }
+                    }
+                }
+            } elseif ($this->class instanceof \Doctrine\ODM\MongoDB\Mapping\ClassMetadata) {
+                $mappings = $this->class->associationMappings;
+
+                foreach ($mappings as $mapping) {
+                    if ($mapping['targetDocument'] == $relatedClass) {
+                        if ($mapping['type'] == \Doctrine\ODM\MongoDB\Mapping\ClassMetadata::ONE && $mapping['association'] == \Doctrine\ODM\MongoDB\Mapping\ClassMetadata::REFERENCE_ONE) {
+                            $unique = true;
+                            $optional = $mapping['nullable'] ?? false;
+
+                            break;
+                        }
+                    }
+                }
+            }
+
+            $index = 0;
+            $formatters[$assocName] = static function ($inserted) use ($relatedClass, &$index, $unique, $optional, $generator) {
+                if (isset($inserted[$relatedClass])) {
+                    if ($unique) {
+                        $related = null;
+
+                        if (isset($inserted[$relatedClass][$index]) || !$optional) {
+                            $related = $inserted[$relatedClass][$index];
+                        }
+
+                        ++$index;
+
+                        return $related;
+                    }
+
+                    return $generator->randomElement($inserted[$relatedClass]);
+                }
+
+                return null;
+            };
+        }
+
+        return $formatters;
+    }
+
+    /**
+     * Insert one new record using the Entity class.
+     *
+     * @param bool $generateId
+     *
+     * @return EntityPopulator
+     */
+    public function execute(ObjectManager $manager, $insertedEntities, $generateId = false)
+    {
+        $obj = $this->class->newInstance();
+
+        $this->fillColumns($obj, $insertedEntities);
+        $this->callMethods($obj, $insertedEntities);
+
+        if ($generateId) {
+            $idsName = $this->class->getIdentifier();
+
+            foreach ($idsName as $idName) {
+                $id = $this->generateId($obj, $idName, $manager);
+                $this->class->reflFields[$idName]->setValue($obj, $id);
+            }
+        }
+
+        $manager->persist($obj);
+
+        return $obj;
+    }
+
+    private function fillColumns($obj, $insertedEntities): void
+    {
+        foreach ($this->columnFormatters as $field => $format) {
+            if (null !== $format) {
+                // Add some extended debugging information to any errors thrown by the formatter
+                try {
+                    $value = is_callable($format) ? $format($insertedEntities, $obj) : $format;
+                } catch (\InvalidArgumentException $ex) {
+                    throw new \InvalidArgumentException(sprintf(
+                        'Failed to generate a value for %s::%s: %s',
+                        get_class($obj),
+                        $field,
+                        $ex->getMessage(),
+                    ));
+                }
+                // Try a standard setter if it's available, otherwise fall back on reflection
+                $setter = sprintf('set%s', ucfirst($field));
+
+                if (is_callable([$obj, $setter])) {
+                    $obj->$setter($value);
+                } else {
+                    $this->class->reflFields[$field]->setValue($obj, $value);
+                }
+            }
+        }
+    }
+
+    private function callMethods($obj, $insertedEntities): void
+    {
+        foreach ($this->getModifiers() as $modifier) {
+            $modifier($obj, $insertedEntities);
+        }
+    }
+
+    /**
+     * @return int
+     */
+    private function generateId($obj, $column, ObjectManager $manager)
+    {
+        $repository = $manager->getRepository(get_class($obj));
+        $result = $repository->createQueryBuilder('e')
+                ->select(sprintf('e.%s', $column))
+                ->getQuery()
+                ->execute();
+        $ids = array_map('current', $result->toArray());
+
+        do {
+            $id = mt_rand();
+        } while (in_array($id, $ids, false));
+
+        return $id;
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Doctrine/Populator.php

@@ -0,0 +1,126 @@
+<?php
+
+namespace Faker\ORM\Doctrine;
+
+use Doctrine\Common\Persistence\ObjectManager;
+use Faker\Generator;
+
+require_once 'backward-compatibility.php';
+
+/**
+ * Service class for populating a database using the Doctrine ORM or ODM.
+ * A Populator can populate several tables using ActiveRecord classes.
+ */
+class Populator
+{
+    /**
+     * @var int
+     */
+    protected $batchSize;
+
+    /**
+     * @var Generator
+     */
+    protected $generator;
+
+    /**
+     * @var ObjectManager|null
+     */
+    protected $manager;
+
+    /**
+     * @var array
+     */
+    protected $entities = [];
+
+    /**
+     * @var array
+     */
+    protected $quantities = [];
+
+    /**
+     * @var array
+     */
+    protected $generateId = [];
+
+    /**
+     * Populator constructor.
+     *
+     * @param int $batchSize
+     */
+    public function __construct(Generator $generator, ?ObjectManager $manager = null, $batchSize = 1000)
+    {
+        $this->generator = $generator;
+        $this->manager = $manager;
+        $this->batchSize = $batchSize;
+    }
+
+    /**
+     * Add an order for the generation of $number records for $entity.
+     *
+     * @param mixed $entity A Doctrine classname, or a \Faker\ORM\Doctrine\EntityPopulator instance
+     * @param int   $number The number of entities to populate
+     */
+    public function addEntity($entity, $number, $customColumnFormatters = [], $customModifiers = [], $generateId = false)
+    {
+        if (!$entity instanceof \Faker\ORM\Doctrine\EntityPopulator) {
+            if (null === $this->manager) {
+                throw new \InvalidArgumentException('No entity manager passed to Doctrine Populator.');
+            }
+            $entity = new \Faker\ORM\Doctrine\EntityPopulator($this->manager->getClassMetadata($entity));
+        }
+        $entity->setColumnFormatters($entity->guessColumnFormatters($this->generator));
+
+        if ($customColumnFormatters) {
+            $entity->mergeColumnFormattersWith($customColumnFormatters);
+        }
+        $entity->mergeModifiersWith($customModifiers);
+        $this->generateId[$entity->getClass()] = $generateId;
+
+        $class = $entity->getClass();
+        $this->entities[$class] = $entity;
+        $this->quantities[$class] = $number;
+    }
+
+    /**
+     * Populate the database using all the Entity classes previously added.
+     *
+     * Please note that large amounts of data will result in more memory usage since the the Populator will return
+     * all newly created primary keys after executing.
+     *
+     * @param ObjectManager|null $entityManager A Doctrine connection object
+     *
+     * @return array A list of the inserted PKs
+     */
+    public function execute($entityManager = null)
+    {
+        if (null === $entityManager) {
+            $entityManager = $this->manager;
+        }
+
+        if (null === $entityManager) {
+            throw new \InvalidArgumentException('No entity manager passed to Doctrine Populator.');
+        }
+
+        $insertedEntities = [];
+
+        foreach ($this->quantities as $class => $number) {
+            $generateId = $this->generateId[$class];
+
+            for ($i = 0; $i < $number; ++$i) {
+                $insertedEntities[$class][] = $this->entities[$class]->execute(
+                    $entityManager,
+                    $insertedEntities,
+                    $generateId,
+                );
+
+                if (count($insertedEntities) % $this->batchSize === 0) {
+                    $entityManager->flush();
+                }
+            }
+            $entityManager->flush();
+        }
+
+        return $insertedEntities;
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Doctrine/backward-compatibility.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+if (!class_exists('Doctrine\Common\Persistence\Mapping\ClassMetadata')) {
+    class_alias(\Doctrine\Persistence\Mapping\ClassMetadata::class, 'Doctrine\Common\Persistence\Mapping\ClassMetadata');
+}
+
+if (!class_exists('Doctrine\Common\Persistence\ObjectManager')) {
+    class_alias(\Doctrine\Persistence\ObjectManager::class, 'Doctrine\Common\Persistence\ObjectManager');
+}

vendor/fakerphp/faker/src/Faker/ORM/Mandango/ColumnTypeGuesser.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace Faker\ORM\Mandango;
+
+use Faker\Generator;
+
+class ColumnTypeGuesser
+{
+    /**
+     * @var Generator
+     */
+    protected $generator;
+
+    public function __construct(Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return \Closure|null
+     */
+    public function guessFormat($field)
+    {
+        $generator = $this->generator;
+
+        switch ($field['type']) {
+            case 'boolean':
+                return static function () use ($generator) {
+                    return $generator->boolean;
+                };
+
+            case 'integer':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 4294967295);
+                };
+
+            case 'float':
+                return static function () use ($generator) {
+                    return $generator->randomFloat();
+                };
+
+            case 'string':
+                return static function () use ($generator) {
+                    return $generator->text(255);
+                };
+
+            case 'date':
+                return static function () use ($generator) {
+                    return $generator->dateTime;
+                };
+
+            default:
+                // no smart way to guess what the user expects here
+                return null;
+        }
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Mandango/EntityPopulator.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace Faker\ORM\Mandango;
+
+use Faker\Provider\Base;
+use Mandango\Mandango;
+
+/**
+ * Service class for populating a table through a Mandango ActiveRecord class.
+ */
+class EntityPopulator
+{
+    protected $class;
+    protected $columnFormatters = [];
+
+    /**
+     * @param string $class A Mandango ActiveRecord classname
+     */
+    public function __construct($class)
+    {
+        $this->class = $class;
+    }
+
+    /**
+     * @return string
+     */
+    public function getClass()
+    {
+        return $this->class;
+    }
+
+    public function setColumnFormatters($columnFormatters)
+    {
+        $this->columnFormatters = $columnFormatters;
+    }
+
+    /**
+     * @return array
+     */
+    public function getColumnFormatters()
+    {
+        return $this->columnFormatters;
+    }
+
+    public function mergeColumnFormattersWith($columnFormatters)
+    {
+        $this->columnFormatters = array_merge($this->columnFormatters, $columnFormatters);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessColumnFormatters(\Faker\Generator $generator, Mandango $mandango)
+    {
+        $formatters = [];
+        $nameGuesser = new \Faker\Guesser\Name($generator);
+        $columnTypeGuesser = new \Faker\ORM\Mandango\ColumnTypeGuesser($generator);
+
+        $metadata = $mandango->getMetadata($this->class);
+
+        // fields
+        foreach ($metadata['fields'] as $fieldName => $field) {
+            if ($formatter = $nameGuesser->guessFormat($fieldName)) {
+                $formatters[$fieldName] = $formatter;
+
+                continue;
+            }
+
+            if ($formatter = $columnTypeGuesser->guessFormat($field)) {
+                $formatters[$fieldName] = $formatter;
+
+                continue;
+            }
+        }
+
+        // references
+        foreach (array_merge($metadata['referencesOne'], $metadata['referencesMany']) as $referenceName => $reference) {
+            if (!isset($reference['class'])) {
+                continue;
+            }
+            $referenceClass = $reference['class'];
+
+            $formatters[$referenceName] = static function ($insertedEntities) use ($referenceClass) {
+                if (isset($insertedEntities[$referenceClass])) {
+                    return Base::randomElement($insertedEntities[$referenceClass]);
+                }
+
+                return null;
+            };
+        }
+
+        return $formatters;
+    }
+
+    /**
+     * Insert one new record using the Entity class.
+     */
+    public function execute(Mandango $mandango, $insertedEntities)
+    {
+        $metadata = $mandango->getMetadata($this->class);
+
+        $obj = $mandango->create($this->class);
+
+        foreach ($this->columnFormatters as $column => $format) {
+            if (null !== $format) {
+                $value = is_callable($format) ? $format($insertedEntities, $obj) : $format;
+
+                if (isset($metadata['fields'][$column])
+                    || isset($metadata['referencesOne'][$column])) {
+                    $obj->set($column, $value);
+                }
+
+                if (isset($metadata['referencesMany'][$column])) {
+                    $adder = 'add' . ucfirst($column);
+                    $obj->$adder($value);
+                }
+            }
+        }
+        $mandango->persist($obj);
+
+        return $obj;
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Mandango/Populator.php

@@ -0,0 +1,63 @@
+<?php
+
+namespace Faker\ORM\Mandango;
+
+use Mandango\Mandango;
+
+/**
+ * Service class for populating a database using Mandango.
+ * A Populator can populate several tables using ActiveRecord classes.
+ */
+class Populator
+{
+    protected $generator;
+    protected $mandango;
+    protected $entities = [];
+    protected $quantities = [];
+
+    public function __construct(\Faker\Generator $generator, Mandango $mandango)
+    {
+        $this->generator = $generator;
+        $this->mandango = $mandango;
+    }
+
+    /**
+     * Add an order for the generation of $number records for $entity.
+     *
+     * @param mixed $entity A Propel ActiveRecord classname, or a \Faker\ORM\Propel\EntityPopulator instance
+     * @param int   $number The number of entities to populate
+     */
+    public function addEntity($entity, $number, $customColumnFormatters = [])
+    {
+        if (!$entity instanceof \Faker\ORM\Mandango\EntityPopulator) {
+            $entity = new \Faker\ORM\Mandango\EntityPopulator($entity);
+        }
+        $entity->setColumnFormatters($entity->guessColumnFormatters($this->generator, $this->mandango));
+
+        if ($customColumnFormatters) {
+            $entity->mergeColumnFormattersWith($customColumnFormatters);
+        }
+        $class = $entity->getClass();
+        $this->entities[$class] = $entity;
+        $this->quantities[$class] = $number;
+    }
+
+    /**
+     * Populate the database using all the Entity classes previously added.
+     *
+     * @return array A list of the inserted entities.
+     */
+    public function execute()
+    {
+        $insertedEntities = [];
+
+        foreach ($this->quantities as $class => $number) {
+            for ($i = 0; $i < $number; ++$i) {
+                $insertedEntities[$class][] = $this->entities[$class]->execute($this->mandango, $insertedEntities);
+            }
+        }
+        $this->mandango->flush();
+
+        return $insertedEntities;
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Propel/ColumnTypeGuesser.php

@@ -0,0 +1,109 @@
+<?php
+
+namespace Faker\ORM\Propel;
+
+class ColumnTypeGuesser
+{
+    protected $generator;
+
+    public function __construct(\Faker\Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return \Closure|null
+     */
+    public function guessFormat(\ColumnMap $column)
+    {
+        $generator = $this->generator;
+
+        if ($column->isTemporal()) {
+            if ($column->isEpochTemporal()) {
+                return static function () use ($generator) {
+                    return $generator->dateTime;
+                };
+            }
+
+            return static function () use ($generator) {
+                return $generator->dateTimeAD;
+            };
+        }
+        $type = $column->getType();
+
+        switch ($type) {
+            case \PropelColumnTypes::BOOLEAN:
+            case \PropelColumnTypes::BOOLEAN_EMU:
+                return static function () use ($generator) {
+                    return $generator->boolean;
+                };
+
+            case \PropelColumnTypes::NUMERIC:
+            case \PropelColumnTypes::DECIMAL:
+                $size = $column->getSize();
+
+                return static function () use ($generator, $size) {
+                    return $generator->randomNumber($size + 2) / 100;
+                };
+
+            case \PropelColumnTypes::TINYINT:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 127);
+                };
+
+            case \PropelColumnTypes::SMALLINT:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 32767);
+                };
+
+            case \PropelColumnTypes::INTEGER:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 2147483647);
+                };
+
+            case \PropelColumnTypes::BIGINT:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, PHP_INT_MAX);
+                };
+
+            case \PropelColumnTypes::FLOAT:
+            case \PropelColumnTypes::DOUBLE:
+            case \PropelColumnTypes::REAL:
+                return static function () use ($generator) {
+                    return $generator->randomFloat();
+                };
+
+            case \PropelColumnTypes::CHAR:
+            case \PropelColumnTypes::VARCHAR:
+            case \PropelColumnTypes::BINARY:
+            case \PropelColumnTypes::VARBINARY:
+                $size = $column->getSize();
+
+                return static function () use ($generator, $size) {
+                    return $generator->text($size);
+                };
+
+            case \PropelColumnTypes::LONGVARCHAR:
+            case \PropelColumnTypes::LONGVARBINARY:
+            case \PropelColumnTypes::CLOB:
+            case \PropelColumnTypes::CLOB_EMU:
+            case \PropelColumnTypes::BLOB:
+                return static function () use ($generator) {
+                    return $generator->text;
+                };
+
+            case \PropelColumnTypes::ENUM:
+                $valueSet = $column->getValueSet();
+
+                return static function () use ($generator, $valueSet) {
+                    return $generator->randomElement($valueSet);
+                };
+
+            case \PropelColumnTypes::OBJECT:
+            case \PropelColumnTypes::PHP_ARRAY:
+            default:
+                // no smart way to guess what the user expects here
+                return null;
+        }
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Propel/EntityPopulator.php

@@ -0,0 +1,204 @@
+<?php
+
+namespace Faker\ORM\Propel;
+
+use Faker\Provider\Base;
+
+/**
+ * Service class for populating a table through a Propel ActiveRecord class.
+ */
+class EntityPopulator
+{
+    protected $class;
+    protected $columnFormatters = [];
+    protected $modifiers = [];
+
+    /**
+     * @param string $class A Propel ActiveRecord classname
+     */
+    public function __construct($class)
+    {
+        $this->class = $class;
+    }
+
+    /**
+     * @return string
+     */
+    public function getClass()
+    {
+        return $this->class;
+    }
+
+    public function setColumnFormatters($columnFormatters)
+    {
+        $this->columnFormatters = $columnFormatters;
+    }
+
+    /**
+     * @return array
+     */
+    public function getColumnFormatters()
+    {
+        return $this->columnFormatters;
+    }
+
+    public function mergeColumnFormattersWith($columnFormatters)
+    {
+        $this->columnFormatters = array_merge($this->columnFormatters, $columnFormatters);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessColumnFormatters(\Faker\Generator $generator)
+    {
+        $formatters = [];
+        $class = $this->class;
+        $peerClass = $class::PEER;
+        $tableMap = $peerClass::getTableMap();
+        $nameGuesser = new \Faker\Guesser\Name($generator);
+        $columnTypeGuesser = new \Faker\ORM\Propel\ColumnTypeGuesser($generator);
+
+        foreach ($tableMap->getColumns() as $columnMap) {
+            // skip behavior columns, handled by modifiers
+            if ($this->isColumnBehavior($columnMap)) {
+                continue;
+            }
+
+            if ($columnMap->isForeignKey()) {
+                $relatedClass = $columnMap->getRelation()->getForeignTable()->getClassname();
+                $formatters[$columnMap->getPhpName()] = static function ($inserted) use ($relatedClass, $generator) {
+                    return isset($inserted[$relatedClass]) ? $generator->randomElement($inserted[$relatedClass]) : null;
+                };
+
+                continue;
+            }
+
+            if ($columnMap->isPrimaryKey()) {
+                continue;
+            }
+
+            if ($formatter = $nameGuesser->guessFormat($columnMap->getPhpName(), $columnMap->getSize())) {
+                $formatters[$columnMap->getPhpName()] = $formatter;
+
+                continue;
+            }
+
+            if ($formatter = $columnTypeGuesser->guessFormat($columnMap)) {
+                $formatters[$columnMap->getPhpName()] = $formatter;
+
+                continue;
+            }
+        }
+
+        return $formatters;
+    }
+
+    /**
+     * @return bool
+     */
+    protected function isColumnBehavior(\ColumnMap $columnMap)
+    {
+        foreach ($columnMap->getTable()->getBehaviors() as $name => $params) {
+            $columnName = Base::toLower($columnMap->getName());
+
+            switch ($name) {
+                case 'nested_set':
+                    $columnNames = [$params['left_column'], $params['right_column'], $params['level_column']];
+
+                    if (in_array($columnName, $columnNames, false)) {
+                        return true;
+                    }
+
+                    break;
+
+                case 'timestampable':
+                    $columnNames = [$params['create_column'], $params['update_column']];
+
+                    if (in_array($columnName, $columnNames, false)) {
+                        return true;
+                    }
+
+                    break;
+            }
+        }
+
+        return false;
+    }
+
+    public function setModifiers($modifiers)
+    {
+        $this->modifiers = $modifiers;
+    }
+
+    /**
+     * @return array
+     */
+    public function getModifiers()
+    {
+        return $this->modifiers;
+    }
+
+    public function mergeModifiersWith($modifiers)
+    {
+        $this->modifiers = array_merge($this->modifiers, $modifiers);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessModifiers(\Faker\Generator $generator)
+    {
+        $modifiers = [];
+        $class = $this->class;
+        $peerClass = $class::PEER;
+        $tableMap = $peerClass::getTableMap();
+
+        foreach ($tableMap->getBehaviors() as $name => $params) {
+            switch ($name) {
+                case 'nested_set':
+                    $modifiers['nested_set'] = static function ($obj, $inserted) use ($class, $generator): void {
+                        if (isset($inserted[$class])) {
+                            $queryClass = $class . 'Query';
+                            $parent = $queryClass::create()->findPk($generator->randomElement($inserted[$class]));
+                            $obj->insertAsLastChildOf($parent);
+                        } else {
+                            $obj->makeRoot();
+                        }
+                    };
+
+                    break;
+
+                case 'sortable':
+                    $modifiers['sortable'] = static function ($obj, $inserted) use ($class, $generator): void {
+                        $obj->insertAtRank($generator->numberBetween(1, count($inserted[$class] ?? []) + 1));
+                    };
+
+                    break;
+            }
+        }
+
+        return $modifiers;
+    }
+
+    /**
+     * Insert one new record using the Entity class.
+     */
+    public function execute($con, $insertedEntities)
+    {
+        $obj = new $this->class();
+
+        foreach ($this->getColumnFormatters() as $column => $format) {
+            if (null !== $format) {
+                $obj->setByName($column, is_callable($format) ? $format($insertedEntities, $obj) : $format);
+            }
+        }
+
+        foreach ($this->getModifiers() as $modifier) {
+            $modifier($obj, $insertedEntities);
+        }
+        $obj->save($con);
+
+        return $obj->getPrimaryKey();
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Propel/Populator.php

@@ -0,0 +1,90 @@
+<?php
+
+namespace Faker\ORM\Propel;
+
+/**
+ * Service class for populating a database using the Propel ORM.
+ * A Populator can populate several tables using ActiveRecord classes.
+ */
+class Populator
+{
+    protected $generator;
+    protected $entities = [];
+    protected $quantities = [];
+
+    public function __construct(\Faker\Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * Add an order for the generation of $number records for $entity.
+     *
+     * @param mixed $entity A Propel ActiveRecord classname, or a \Faker\ORM\Propel\EntityPopulator instance
+     * @param int   $number The number of entities to populate
+     */
+    public function addEntity($entity, $number, $customColumnFormatters = [], $customModifiers = [])
+    {
+        if (!$entity instanceof \Faker\ORM\Propel\EntityPopulator) {
+            $entity = new \Faker\ORM\Propel\EntityPopulator($entity);
+        }
+        $entity->setColumnFormatters($entity->guessColumnFormatters($this->generator));
+
+        if ($customColumnFormatters) {
+            $entity->mergeColumnFormattersWith($customColumnFormatters);
+        }
+        $entity->setModifiers($entity->guessModifiers($this->generator));
+
+        if ($customModifiers) {
+            $entity->mergeModifiersWith($customModifiers);
+        }
+        $class = $entity->getClass();
+        $this->entities[$class] = $entity;
+        $this->quantities[$class] = $number;
+    }
+
+    /**
+     * Populate the database using all the Entity classes previously added.
+     *
+     * @param PropelPDO $con A Propel connection object
+     *
+     * @return array A list of the inserted PKs
+     */
+    public function execute($con = null)
+    {
+        if (null === $con) {
+            $con = $this->getConnection();
+        }
+        $isInstancePoolingEnabled = \Propel::isInstancePoolingEnabled();
+        \Propel::disableInstancePooling();
+        $insertedEntities = [];
+        $con->beginTransaction();
+
+        foreach ($this->quantities as $class => $number) {
+            for ($i = 0; $i < $number; ++$i) {
+                $insertedEntities[$class][] = $this->entities[$class]->execute($con, $insertedEntities);
+            }
+        }
+        $con->commit();
+
+        if ($isInstancePoolingEnabled) {
+            \Propel::enableInstancePooling();
+        }
+
+        return $insertedEntities;
+    }
+
+    protected function getConnection()
+    {
+        // use the first connection available
+        $class = key($this->entities);
+
+        if (!$class) {
+            throw new \RuntimeException('No class found from entities. Did you add entities to the Populator ?');
+        }
+
+        $peer = $class::PEER;
+
+        return \Propel::getConnection($peer::DATABASE_NAME, \Propel::CONNECTION_WRITE);
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Propel2/ColumnTypeGuesser.php

@@ -0,0 +1,112 @@
+<?php
+
+namespace Faker\ORM\Propel2;
+
+use Propel\Generator\Model\PropelTypes;
+use Propel\Runtime\Map\ColumnMap;
+
+class ColumnTypeGuesser
+{
+    protected $generator;
+
+    public function __construct(\Faker\Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return \Closure|null
+     */
+    public function guessFormat(ColumnMap $column)
+    {
+        $generator = $this->generator;
+
+        if ($column->isTemporal()) {
+            if ($column->getType() == PropelTypes::BU_DATE || $column->getType() == PropelTypes::BU_TIMESTAMP) {
+                return static function () use ($generator) {
+                    return $generator->dateTime;
+                };
+            }
+
+            return static function () use ($generator) {
+                return $generator->dateTimeAD;
+            };
+        }
+        $type = $column->getType();
+
+        switch ($type) {
+            case PropelTypes::BOOLEAN:
+            case PropelTypes::BOOLEAN_EMU:
+                return static function () use ($generator) {
+                    return $generator->boolean;
+                };
+
+            case PropelTypes::NUMERIC:
+            case PropelTypes::DECIMAL:
+                $size = $column->getSize();
+
+                return static function () use ($generator, $size) {
+                    return $generator->randomNumber($size + 2) / 100;
+                };
+
+            case PropelTypes::TINYINT:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 127);
+                };
+
+            case PropelTypes::SMALLINT:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 32767);
+                };
+
+            case PropelTypes::INTEGER:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 2147483647);
+                };
+
+            case PropelTypes::BIGINT:
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, PHP_INT_MAX);
+                };
+
+            case PropelTypes::FLOAT:
+            case PropelTypes::DOUBLE:
+            case PropelTypes::REAL:
+                return static function () use ($generator) {
+                    return $generator->randomFloat();
+                };
+
+            case PropelTypes::CHAR:
+            case PropelTypes::VARCHAR:
+            case PropelTypes::BINARY:
+            case PropelTypes::VARBINARY:
+                $size = $column->getSize();
+
+                return static function () use ($generator, $size) {
+                    return $generator->text($size);
+                };
+
+            case PropelTypes::LONGVARCHAR:
+            case PropelTypes::LONGVARBINARY:
+            case PropelTypes::CLOB:
+            case PropelTypes::CLOB_EMU:
+            case PropelTypes::BLOB:
+                return static function () use ($generator) {
+                    return $generator->text;
+                };
+
+            case PropelTypes::ENUM:
+                $valueSet = $column->getValueSet();
+
+                return static function () use ($generator, $valueSet) {
+                    return $generator->randomElement($valueSet);
+                };
+
+            case PropelTypes::OBJECT:
+            case PropelTypes::PHP_ARRAY:
+            default:
+                // no smart way to guess what the user expects here
+                return null;
+        }
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Propel2/EntityPopulator.php

@@ -0,0 +1,207 @@
+<?php
+
+namespace Faker\ORM\Propel2;
+
+use Faker\Provider\Base;
+use Propel\Runtime\Map\ColumnMap;
+
+/**
+ * Service class for populating a table through a Propel ActiveRecord class.
+ */
+class EntityPopulator
+{
+    protected $class;
+    protected $columnFormatters = [];
+    protected $modifiers = [];
+
+    /**
+     * @param string $class A Propel ActiveRecord classname
+     */
+    public function __construct($class)
+    {
+        $this->class = $class;
+    }
+
+    /**
+     * @return string
+     */
+    public function getClass()
+    {
+        return $this->class;
+    }
+
+    public function setColumnFormatters($columnFormatters)
+    {
+        $this->columnFormatters = $columnFormatters;
+    }
+
+    /**
+     * @return array
+     */
+    public function getColumnFormatters()
+    {
+        return $this->columnFormatters;
+    }
+
+    public function mergeColumnFormattersWith($columnFormatters)
+    {
+        $this->columnFormatters = array_merge($this->columnFormatters, $columnFormatters);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessColumnFormatters(\Faker\Generator $generator)
+    {
+        $formatters = [];
+        $class = $this->class;
+        $peerClass = $class::TABLE_MAP;
+        $tableMap = $peerClass::getTableMap();
+        $nameGuesser = new \Faker\Guesser\Name($generator);
+        $columnTypeGuesser = new \Faker\ORM\Propel2\ColumnTypeGuesser($generator);
+
+        foreach ($tableMap->getColumns() as $columnMap) {
+            // skip behavior columns, handled by modifiers
+            if ($this->isColumnBehavior($columnMap)) {
+                continue;
+            }
+
+            if ($columnMap->isForeignKey()) {
+                $relatedClass = $columnMap->getRelation()->getForeignTable()->getClassname();
+                $formatters[$columnMap->getPhpName()] = static function ($inserted) use ($relatedClass, $generator) {
+                    $relatedClass = trim($relatedClass, '\\');
+
+                    return isset($inserted[$relatedClass]) ? $generator->randomElement($inserted[$relatedClass]) : null;
+                };
+
+                continue;
+            }
+
+            if ($columnMap->isPrimaryKey()) {
+                continue;
+            }
+
+            if ($formatter = $nameGuesser->guessFormat($columnMap->getPhpName(), $columnMap->getSize())) {
+                $formatters[$columnMap->getPhpName()] = $formatter;
+
+                continue;
+            }
+
+            if ($formatter = $columnTypeGuesser->guessFormat($columnMap)) {
+                $formatters[$columnMap->getPhpName()] = $formatter;
+
+                continue;
+            }
+        }
+
+        return $formatters;
+    }
+
+    /**
+     * @return bool
+     */
+    protected function isColumnBehavior(ColumnMap $columnMap)
+    {
+        foreach ($columnMap->getTable()->getBehaviors() as $name => $params) {
+            $columnName = Base::toLower($columnMap->getName());
+
+            switch ($name) {
+                case 'nested_set':
+                    $columnNames = [$params['left_column'], $params['right_column'], $params['level_column']];
+
+                    if (in_array($columnName, $columnNames, false)) {
+                        return true;
+                    }
+
+                    break;
+
+                case 'timestampable':
+                    $columnNames = [$params['create_column'], $params['update_column']];
+
+                    if (in_array($columnName, $columnNames, false)) {
+                        return true;
+                    }
+
+                    break;
+            }
+        }
+
+        return false;
+    }
+
+    public function setModifiers($modifiers)
+    {
+        $this->modifiers = $modifiers;
+    }
+
+    /**
+     * @return array
+     */
+    public function getModifiers()
+    {
+        return $this->modifiers;
+    }
+
+    public function mergeModifiersWith($modifiers)
+    {
+        $this->modifiers = array_merge($this->modifiers, $modifiers);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessModifiers(\Faker\Generator $generator)
+    {
+        $modifiers = [];
+        $class = $this->class;
+        $peerClass = $class::TABLE_MAP;
+        $tableMap = $peerClass::getTableMap();
+
+        foreach ($tableMap->getBehaviors() as $name => $params) {
+            switch ($name) {
+                case 'nested_set':
+                    $modifiers['nested_set'] = static function ($obj, $inserted) use ($class, $generator): void {
+                        if (isset($inserted[$class])) {
+                            $queryClass = $class . 'Query';
+                            $parent = $queryClass::create()->findPk($generator->randomElement($inserted[$class]));
+                            $obj->insertAsLastChildOf($parent);
+                        } else {
+                            $obj->makeRoot();
+                        }
+                    };
+
+                    break;
+
+                case 'sortable':
+                    $modifiers['sortable'] = static function ($obj, $inserted) use ($class, $generator): void {
+                        $obj->insertAtRank($generator->numberBetween(1, count($inserted[$class] ?? []) + 1));
+                    };
+
+                    break;
+            }
+        }
+
+        return $modifiers;
+    }
+
+    /**
+     * Insert one new record using the Entity class.
+     */
+    public function execute($con, $insertedEntities)
+    {
+        $obj = new $this->class();
+
+        foreach ($this->getColumnFormatters() as $column => $format) {
+            if (null !== $format) {
+                $obj->setByName($column, is_callable($format) ? $format($insertedEntities, $obj) : $format);
+            }
+        }
+
+        foreach ($this->getModifiers() as $modifier) {
+            $modifier($obj, $insertedEntities);
+        }
+        $obj->save($con);
+
+        return $obj->getPrimaryKey();
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Propel2/Populator.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace Faker\ORM\Propel2;
+
+use Propel\Runtime\Propel;
+use Propel\Runtime\ServiceContainer\ServiceContainerInterface;
+
+/**
+ * Service class for populating a database using the Propel ORM.
+ * A Populator can populate several tables using ActiveRecord classes.
+ */
+class Populator
+{
+    protected $generator;
+    protected $entities = [];
+    protected $quantities = [];
+
+    public function __construct(\Faker\Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * Add an order for the generation of $number records for $entity.
+     *
+     * @param mixed $entity A Propel ActiveRecord classname, or a \Faker\ORM\Propel2\EntityPopulator instance
+     * @param int   $number The number of entities to populate
+     */
+    public function addEntity($entity, $number, $customColumnFormatters = [], $customModifiers = [])
+    {
+        if (!$entity instanceof \Faker\ORM\Propel2\EntityPopulator) {
+            $entity = new \Faker\ORM\Propel2\EntityPopulator($entity);
+        }
+        $entity->setColumnFormatters($entity->guessColumnFormatters($this->generator));
+
+        if ($customColumnFormatters) {
+            $entity->mergeColumnFormattersWith($customColumnFormatters);
+        }
+        $entity->setModifiers($entity->guessModifiers($this->generator));
+
+        if ($customModifiers) {
+            $entity->mergeModifiersWith($customModifiers);
+        }
+        $class = $entity->getClass();
+        $this->entities[$class] = $entity;
+        $this->quantities[$class] = $number;
+    }
+
+    /**
+     * Populate the database using all the Entity classes previously added.
+     *
+     * @param PropelPDO $con A Propel connection object
+     *
+     * @return array A list of the inserted PKs
+     */
+    public function execute($con = null)
+    {
+        if (null === $con) {
+            $con = $this->getConnection();
+        }
+        $isInstancePoolingEnabled = Propel::isInstancePoolingEnabled();
+        Propel::disableInstancePooling();
+        $insertedEntities = [];
+        $con->beginTransaction();
+
+        foreach ($this->quantities as $class => $number) {
+            for ($i = 0; $i < $number; ++$i) {
+                $insertedEntities[$class][] = $this->entities[$class]->execute($con, $insertedEntities);
+            }
+        }
+        $con->commit();
+
+        if ($isInstancePoolingEnabled) {
+            Propel::enableInstancePooling();
+        }
+
+        return $insertedEntities;
+    }
+
+    protected function getConnection()
+    {
+        // use the first connection available
+        $class = key($this->entities);
+
+        if (!$class) {
+            throw new \RuntimeException('No class found from entities. Did you add entities to the Populator ?');
+        }
+
+        $peer = $class::TABLE_MAP;
+
+        return Propel::getConnection($peer::DATABASE_NAME, ServiceContainerInterface::CONNECTION_WRITE);
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Spot/ColumnTypeGuesser.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Faker\ORM\Spot;
+
+use Faker\Generator;
+
+class ColumnTypeGuesser
+{
+    protected $generator;
+
+    /**
+     * ColumnTypeGuesser constructor.
+     */
+    public function __construct(Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * @return \Closure|null
+     */
+    public function guessFormat(array $field)
+    {
+        $generator = $this->generator;
+        $type = $field['type'];
+
+        switch ($type) {
+            case 'boolean':
+                return static function () use ($generator) {
+                    return $generator->boolean;
+                };
+
+            case 'decimal':
+                $size = $field['precision'] ?? 2;
+
+                return static function () use ($generator, $size) {
+                    return $generator->randomNumber($size + 2) / 100;
+                };
+
+            case 'smallint':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 65535);
+                };
+
+            case 'integer':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, 2147483647);
+                };
+
+            case 'bigint':
+                return static function () use ($generator) {
+                    return $generator->numberBetween(0, PHP_INT_MAX);
+                };
+
+            case 'float':
+                return static function () use ($generator) {
+                    return $generator->randomFloat(null, 0, 4294967295);
+                };
+
+            case 'string':
+                $size = $field['length'] ?? 255;
+
+                return static function () use ($generator, $size) {
+                    return $generator->text($size);
+                };
+
+            case 'text':
+                return static function () use ($generator) {
+                    return $generator->text;
+                };
+
+            case 'datetime':
+            case 'date':
+            case 'time':
+                return static function () use ($generator) {
+                    return $generator->datetime;
+                };
+
+            default:
+                // no smart way to guess what the user expects here
+                return null;
+        }
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Spot/EntityPopulator.php

@@ -0,0 +1,199 @@
+<?php
+
+namespace Faker\ORM\Spot;
+
+use Faker\Generator;
+use Faker\Guesser\Name;
+use Spot\Locator;
+use Spot\Mapper;
+use Spot\Relation\BelongsTo;
+
+/**
+ * Service class for populating a table through a Spot Entity class.
+ */
+class EntityPopulator
+{
+    /**
+     * When fetching existing data - fetch only few first rows.
+     */
+    public const RELATED_FETCH_COUNT = 10;
+
+    /**
+     * @var Mapper
+     */
+    protected $mapper;
+
+    /**
+     * @var Locator
+     */
+    protected $locator;
+
+    /**
+     * @var array
+     */
+    protected $columnFormatters = [];
+    /**
+     * @var array
+     */
+    protected $modifiers = [];
+
+    /**
+     * @var bool
+     */
+    protected $useExistingData = false;
+
+    /**
+     * @param bool $useExistingData
+     */
+    public function __construct(Mapper $mapper, Locator $locator, $useExistingData = false)
+    {
+        $this->mapper = $mapper;
+        $this->locator = $locator;
+        $this->useExistingData = $useExistingData;
+    }
+
+    /**
+     * @return string
+     */
+    public function getMapper()
+    {
+        return $this->mapper;
+    }
+
+    public function setColumnFormatters($columnFormatters)
+    {
+        $this->columnFormatters = $columnFormatters;
+    }
+
+    /**
+     * @return array
+     */
+    public function getColumnFormatters()
+    {
+        return $this->columnFormatters;
+    }
+
+    public function mergeColumnFormattersWith($columnFormatters)
+    {
+        $this->columnFormatters = array_merge($this->columnFormatters, $columnFormatters);
+    }
+
+    public function setModifiers(array $modifiers)
+    {
+        $this->modifiers = $modifiers;
+    }
+
+    /**
+     * @return array
+     */
+    public function getModifiers()
+    {
+        return $this->modifiers;
+    }
+
+    public function mergeModifiersWith(array $modifiers)
+    {
+        $this->modifiers = array_merge($this->modifiers, $modifiers);
+    }
+
+    /**
+     * @return array
+     */
+    public function guessColumnFormatters(Generator $generator)
+    {
+        $formatters = [];
+        $nameGuesser = new Name($generator);
+        $columnTypeGuesser = new ColumnTypeGuesser($generator);
+        $fields = $this->mapper->fields();
+
+        foreach ($fields as $fieldName => $field) {
+            if ($field['primary'] === true) {
+                continue;
+            }
+
+            if ($formatter = $nameGuesser->guessFormat($fieldName)) {
+                $formatters[$fieldName] = $formatter;
+
+                continue;
+            }
+
+            if ($formatter = $columnTypeGuesser->guessFormat($field)) {
+                $formatters[$fieldName] = $formatter;
+
+                continue;
+            }
+        }
+        $entityName = $this->mapper->entity();
+        $entity = $this->mapper->build([]);
+        $relations = $entityName::relations($this->mapper, $entity);
+
+        foreach ($relations as $relation) {
+            // We don't need any other relation here.
+            if ($relation instanceof BelongsTo) {
+                $fieldName = $relation->localKey();
+                $entityName = $relation->entityName();
+                $field = $fields[$fieldName];
+                $required = $field['required'];
+
+                $locator = $this->locator;
+
+                $formatters[$fieldName] = function ($inserted) use ($required, $entityName, $locator, $generator) {
+                    if (!empty($inserted[$entityName])) {
+                        return $generator->randomElement($inserted[$entityName])->get('id');
+                    }
+
+                    if ($required && $this->useExistingData) {
+                        // We did not add anything like this, but it's required,
+                        // So let's find something existing in DB.
+                        $mapper = $locator->mapper($entityName);
+                        $records = $mapper->all()->limit(self::RELATED_FETCH_COUNT)->toArray();
+
+                        if (empty($records)) {
+                            return null;
+                        }
+
+                        return $generator->randomElement($records)['id'];
+                    }
+
+                    return null;
+                };
+            }
+        }
+
+        return $formatters;
+    }
+
+    /**
+     * Insert one new record using the Entity class.
+     *
+     * @return string
+     */
+    public function execute($insertedEntities)
+    {
+        $obj = $this->mapper->build([]);
+
+        $this->fillColumns($obj, $insertedEntities);
+        $this->callMethods($obj, $insertedEntities);
+
+        $this->mapper->insert($obj);
+
+        return $obj;
+    }
+
+    private function fillColumns($obj, $insertedEntities): void
+    {
+        foreach ($this->columnFormatters as $field => $format) {
+            if (null !== $format) {
+                $value = is_callable($format) ? $format($insertedEntities, $obj) : $format;
+                $obj->set($field, $value);
+            }
+        }
+    }
+
+    private function callMethods($obj, $insertedEntities): void
+    {
+        foreach ($this->getModifiers() as $modifier) {
+            $modifier($obj, $insertedEntities);
+        }
+    }
+}

vendor/fakerphp/faker/src/Faker/ORM/Spot/Populator.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace Faker\ORM\Spot;
+
+use Spot\Locator;
+
+/**
+ * Service class for populating a database using the Spot ORM.
+ */
+class Populator
+{
+    protected $generator;
+    protected $locator;
+    protected $entities = [];
+    protected $quantities = [];
+
+    /**
+     * Populator constructor.
+     */
+    public function __construct(\Faker\Generator $generator, ?Locator $locator = null)
+    {
+        $this->generator = $generator;
+        $this->locator = $locator;
+    }
+
+    /**
+     * Add an order for the generation of $number records for $entity.
+     *
+     * @param string $entityName             Name of Entity object to generate
+     * @param int    $number                 The number of entities to populate
+     * @param array  $customColumnFormatters
+     * @param array  $customModifiers
+     * @param bool   $useExistingData        Should we use existing rows (e.g. roles) to populate relations?
+     */
+    public function addEntity(
+        $entityName,
+        $number,
+        $customColumnFormatters = [],
+        $customModifiers = [],
+        $useExistingData = false
+    ) {
+        $mapper = $this->locator->mapper($entityName);
+
+        if (null === $mapper) {
+            throw new \InvalidArgumentException('No mapper can be found for entity ' . $entityName);
+        }
+        $entity = new EntityPopulator($mapper, $this->locator, $useExistingData);
+
+        $entity->setColumnFormatters($entity->guessColumnFormatters($this->generator));
+
+        if ($customColumnFormatters) {
+            $entity->mergeColumnFormattersWith($customColumnFormatters);
+        }
+        $entity->mergeModifiersWith($customModifiers);
+
+        $this->entities[$entityName] = $entity;
+        $this->quantities[$entityName] = $number;
+    }
+
+    /**
+     * Populate the database using all the Entity classes previously added.
+     *
+     * @param Locator $locator A Spot locator
+     *
+     * @return array A list of the inserted PKs
+     */
+    public function execute($locator = null)
+    {
+        if (null === $locator) {
+            $locator = $this->locator;
+        }
+
+        if (null === $locator) {
+            throw new \InvalidArgumentException('No entity manager passed to Spot Populator.');
+        }
+
+        $insertedEntities = [];
+
+        foreach ($this->quantities as $entityName => $number) {
+            for ($i = 0; $i < $number; ++$i) {
+                $insertedEntities[$entityName][] = $this->entities[$entityName]->execute(
+                    $insertedEntities,
+                );
+            }
+        }
+
+        return $insertedEntities;
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Address.php

@@ -0,0 +1,166 @@
+<?php
+
+namespace Faker\Provider;
+
+class Address extends Base
+{
+    protected static $citySuffix = ['Ville'];
+    protected static $streetSuffix = ['Street'];
+    protected static $cityFormats = [
+        '{{firstName}}{{citySuffix}}',
+    ];
+    protected static $streetNameFormats = [
+        '{{lastName}} {{streetSuffix}}',
+    ];
+    protected static $streetAddressFormats = [
+        '{{buildingNumber}} {{streetName}}',
+    ];
+    protected static $addressFormats = [
+        '{{streetAddress}} {{postcode}} {{city}}',
+    ];
+
+    protected static $buildingNumber = ['%#'];
+    protected static $postcode = ['#####'];
+    protected static $country = [];
+
+    /**
+     * @example 'town'
+     *
+     * @return string
+     */
+    public static function citySuffix()
+    {
+        return static::randomElement(static::$citySuffix);
+    }
+
+    /**
+     * @example 'Avenue'
+     *
+     * @return string
+     */
+    public static function streetSuffix()
+    {
+        return static::randomElement(static::$streetSuffix);
+    }
+
+    /**
+     * @example '791'
+     *
+     * @return string
+     */
+    public static function buildingNumber()
+    {
+        return static::numerify(static::randomElement(static::$buildingNumber));
+    }
+
+    /**
+     * @example 'Sashabury'
+     *
+     * @return string
+     */
+    public function city()
+    {
+        $format = static::randomElement(static::$cityFormats);
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @example 'Crist Parks'
+     *
+     * @return string
+     */
+    public function streetName()
+    {
+        $format = static::randomElement(static::$streetNameFormats);
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @example '791 Crist Parks'
+     *
+     * @return string
+     */
+    public function streetAddress()
+    {
+        $format = static::randomElement(static::$streetAddressFormats);
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @example 86039-9874
+     *
+     * @return string
+     */
+    public static function postcode()
+    {
+        return static::toUpper(static::bothify(static::randomElement(static::$postcode)));
+    }
+
+    /**
+     * @example '791 Crist Parks, Sashabury, IL 86039-9874'
+     *
+     * @return string
+     */
+    public function address()
+    {
+        $format = static::randomElement(static::$addressFormats);
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @example 'Japan'
+     *
+     * @return string
+     */
+    public static function country()
+    {
+        return static::randomElement(static::$country);
+    }
+
+    /**
+     * Uses signed degrees format (returns a float number between -90 and 90)
+     *
+     * @example '77.147489'
+     *
+     * @param float|int $min
+     * @param float|int $max
+     *
+     * @return float
+     */
+    public static function latitude($min = -90, $max = 90)
+    {
+        return static::randomFloat(6, $min, $max);
+    }
+
+    /**
+     * Uses signed degrees format (returns a float number between -180 and 180)
+     *
+     * @example '86.211205'
+     *
+     * @param float|int $min
+     * @param float|int $max
+     *
+     * @return float
+     */
+    public static function longitude($min = -180, $max = 180)
+    {
+        return static::randomFloat(6, $min, $max);
+    }
+
+    /**
+     * @example array('77.147489', '86.211205')
+     *
+     * @return float[]
+     */
+    public static function localCoordinates()
+    {
+        return [
+            'latitude' => static::latitude(),
+            'longitude' => static::longitude(),
+        ];
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Barcode.php

@@ -0,0 +1,107 @@
+<?php
+
+namespace Faker\Provider;
+
+use Faker\Calculator\Ean;
+use Faker\Calculator\Isbn;
+
+/**
+ * @see http://en.wikipedia.org/wiki/EAN-13
+ * @see http://en.wikipedia.org/wiki/ISBN
+ */
+class Barcode extends Base
+{
+    private function ean($length = 13)
+    {
+        $code = static::numerify(str_repeat('#', $length - 1));
+
+        return $code . Ean::checksum($code);
+    }
+
+    /**
+     * Utility function for computing EAN checksums
+     *
+     * @deprecated Use \Faker\Calculator\Ean::checksum() instead
+     *
+     * @param string $input
+     *
+     * @return int
+     */
+    protected static function eanChecksum($input)
+    {
+        return Ean::checksum($input);
+    }
+
+    /**
+     * ISBN-10 check digit
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number#ISBN-10_check_digits
+     * @deprecated Use \Faker\Calculator\Isbn::checksum() instead
+     *
+     * @param string $input ISBN without check-digit
+     *
+     * @throws \LengthException When wrong input length passed
+     *
+     * @return string
+     */
+    protected static function isbnChecksum($input)
+    {
+        return Isbn::checksum($input);
+    }
+
+    /**
+     * Get a random EAN13 barcode.
+     *
+     * @return string
+     *
+     * @example '4006381333931'
+     */
+    public function ean13()
+    {
+        return $this->ean(13);
+    }
+
+    /**
+     * Get a random EAN8 barcode.
+     *
+     * @return string
+     *
+     * @example '73513537'
+     */
+    public function ean8()
+    {
+        return $this->ean(8);
+    }
+
+    /**
+     * Get a random ISBN-10 code
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number
+     *
+     * @return string
+     *
+     * @example '4881416324'
+     */
+    public function isbn10()
+    {
+        $code = static::numerify(str_repeat('#', 9));
+
+        return $code . Isbn::checksum($code);
+    }
+
+    /**
+     * Get a random ISBN-13 code
+     *
+     * @see http://en.wikipedia.org/wiki/International_Standard_Book_Number
+     *
+     * @return string
+     *
+     * @example '9790404436093'
+     */
+    public function isbn13()
+    {
+        $code = '97' . self::numberBetween(8, 9) . static::numerify(str_repeat('#', 9));
+
+        return $code . Ean::checksum($code);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Base.php

@@ -0,0 +1,710 @@
+<?php
+
+namespace Faker\Provider;
+
+use Faker\DefaultGenerator;
+use Faker\Generator;
+use Faker\UniqueGenerator;
+use Faker\ValidGenerator;
+
+class Base
+{
+    /**
+     * @var \Faker\Generator
+     */
+    protected $generator;
+
+    /**
+     * @var \Faker\UniqueGenerator
+     */
+    protected $unique;
+
+    public function __construct(Generator $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    /**
+     * Returns a random number between 0 and 9
+     *
+     * @return int
+     */
+    public static function randomDigit()
+    {
+        return mt_rand(0, 9);
+    }
+
+    /**
+     * Returns a random number between 1 and 9
+     *
+     * @return int
+     */
+    public static function randomDigitNotNull()
+    {
+        return mt_rand(1, 9);
+    }
+
+    /**
+     * Generates a random digit, which cannot be $except
+     *
+     * @param int $except
+     *
+     * @return int
+     */
+    public static function randomDigitNot($except)
+    {
+        $result = self::numberBetween(0, 8);
+
+        if ($result >= $except) {
+            ++$result;
+        }
+
+        return $result;
+    }
+
+    /**
+     * Returns a random integer with 0 to $nbDigits digits.
+     *
+     * The maximum value returned is mt_getrandmax()
+     *
+     * @param int  $nbDigits Defaults to a random number between 1 and 9
+     * @param bool $strict   Whether the returned number should have exactly $nbDigits
+     *
+     * @example 79907610
+     *
+     * @return int
+     */
+    public static function randomNumber($nbDigits = null, $strict = false)
+    {
+        if (!is_bool($strict)) {
+            throw new \InvalidArgumentException('randomNumber() generates numbers of fixed width. To generate numbers between two boundaries, use numberBetween() instead.');
+        }
+
+        if (null === $nbDigits) {
+            $nbDigits = static::randomDigitNotNull();
+        }
+        $max = 10 ** $nbDigits - 1;
+
+        if ($max > mt_getrandmax()) {
+            throw new \InvalidArgumentException('randomNumber() can only generate numbers up to mt_getrandmax()');
+        }
+
+        if ($strict) {
+            return mt_rand(10 ** ($nbDigits - 1), $max);
+        }
+
+        return mt_rand(0, $max);
+    }
+
+    /**
+     * Return a random float number
+     *
+     * @param int       $nbMaxDecimals
+     * @param float|int $min
+     * @param float|int $max
+     *
+     * @example 48.8932
+     *
+     * @return float
+     */
+    public static function randomFloat($nbMaxDecimals = null, $min = 0, $max = null)
+    {
+        if (null === $nbMaxDecimals) {
+            $nbMaxDecimals = static::randomDigit();
+        }
+
+        if (null === $max) {
+            $max = static::randomNumber();
+
+            if ($min > $max) {
+                $max = $min;
+            }
+        }
+
+        if ($min > $max) {
+            $tmp = $min;
+            $min = $max;
+            $max = $tmp;
+        }
+
+        return round($min + mt_rand() / mt_getrandmax() * ($max - $min), $nbMaxDecimals);
+    }
+
+    /**
+     * Returns a random number between $int1 and $int2 (any order)
+     *
+     * @param int $int1 default to 0
+     * @param int $int2 defaults to 32 bit max integer, ie 2147483647
+     *
+     * @example 79907610
+     *
+     * @return int
+     */
+    public static function numberBetween($int1 = 0, $int2 = 2147483647)
+    {
+        $min = $int1 < $int2 ? $int1 : $int2;
+        $max = $int1 < $int2 ? $int2 : $int1;
+
+        return mt_rand($min, $max);
+    }
+
+    /**
+     * Returns the passed value
+     */
+    public static function passthrough($value)
+    {
+        return $value;
+    }
+
+    /**
+     * Returns a random letter from a to z
+     *
+     * @return string
+     */
+    public static function randomLetter()
+    {
+        return chr(mt_rand(97, 122));
+    }
+
+    /**
+     * Returns a random ASCII character (excluding accents and special chars)
+     *
+     * @return string
+     */
+    public static function randomAscii()
+    {
+        return chr(mt_rand(33, 126));
+    }
+
+    /**
+     * Returns randomly ordered subsequence of $count elements from a provided array
+     *
+     * @todo update default $count to `null` (BC) for next major version
+     *
+     * @param array|class-string|\Traversable $array           Array to take elements from. Defaults to a-c
+     * @param int|null                        $count           Number of elements to take. If `null` then returns random number of elements
+     * @param bool                            $allowDuplicates Allow elements to be picked several times. Defaults to false
+     *
+     * @throws \InvalidArgumentException
+     * @throws \LengthException          When requesting more elements than provided
+     *
+     * @return array New array with $count elements from $array
+     */
+    public static function randomElements($array = ['a', 'b', 'c'], $count = 1, $allowDuplicates = false)
+    {
+        $elements = $array;
+
+        if (is_string($array) && function_exists('enum_exists') && enum_exists($array)) {
+            $elements = $array::cases();
+        }
+
+        if ($array instanceof \Traversable) {
+            $elements = \iterator_to_array($array, false);
+        }
+
+        if (!is_array($elements)) {
+            throw new \InvalidArgumentException(sprintf(
+                'Argument for parameter $array needs to be array, an instance of %s, or an instance of %s, got %s instead.',
+                \UnitEnum::class,
+                \Traversable::class,
+                is_object($array) ? get_class($array) : gettype($array),
+            ));
+        }
+
+        $numberOfElements = count($elements);
+
+        if (!$allowDuplicates && null !== $count && $numberOfElements < $count) {
+            throw new \LengthException(sprintf(
+                'Cannot get %d elements, only %d in array',
+                $count,
+                $numberOfElements,
+            ));
+        }
+
+        if (null === $count) {
+            $count = mt_rand(1, $numberOfElements);
+        }
+
+        $randomElements = [];
+
+        $keys = array_keys($elements);
+        $maxIndex = $numberOfElements - 1;
+        $elementHasBeenSelectedAlready = [];
+        $numberOfRandomElements = 0;
+
+        while ($numberOfRandomElements < $count) {
+            $index = mt_rand(0, $maxIndex);
+
+            if (!$allowDuplicates) {
+                if (isset($elementHasBeenSelectedAlready[$index])) {
+                    continue;
+                }
+
+                $elementHasBeenSelectedAlready[$index] = true;
+            }
+
+            $key = $keys[$index];
+
+            $randomElements[] = $elements[$key];
+
+            ++$numberOfRandomElements;
+        }
+
+        return $randomElements;
+    }
+
+    /**
+     * Returns a random element from a passed array
+     *
+     * @param array|class-string|\Traversable $array
+     *
+     * @throws \InvalidArgumentException
+     */
+    public static function randomElement($array = ['a', 'b', 'c'])
+    {
+        $elements = $array;
+
+        if (is_string($array) && function_exists('enum_exists') && enum_exists($array)) {
+            $elements = $array::cases();
+        }
+
+        if ($array instanceof \Traversable) {
+            $elements = iterator_to_array($array, false);
+        }
+
+        if ($elements === []) {
+            return null;
+        }
+
+        if (!is_array($elements)) {
+            throw new \InvalidArgumentException(sprintf(
+                'Argument for parameter $array needs to be array, an instance of %s, or an instance of %s, got %s instead.',
+                \UnitEnum::class,
+                \Traversable::class,
+                is_object($array) ? get_class($array) : gettype($array),
+            ));
+        }
+
+        $randomElements = static::randomElements($elements, 1);
+
+        return $randomElements[0];
+    }
+
+    /**
+     * Returns a random key from a passed associative array
+     *
+     * @param array $array
+     *
+     * @return int|string|null
+     */
+    public static function randomKey($array = [])
+    {
+        if (!$array) {
+            return null;
+        }
+        $keys = array_keys($array);
+
+        return $keys[mt_rand(0, count($keys) - 1)];
+    }
+
+    /**
+     * Returns a shuffled version of the argument.
+     *
+     * This function accepts either an array, or a string.
+     *
+     * @example $faker->shuffle([1, 2, 3]); // [2, 1, 3]
+     * @example $faker->shuffle('hello, world'); // 'rlo,h eold!lw'
+     *
+     * @see shuffleArray()
+     * @see shuffleString()
+     *
+     * @param array|string $arg The set to shuffle
+     *
+     * @return array|string The shuffled set
+     */
+    public static function shuffle($arg = '')
+    {
+        if (is_array($arg)) {
+            return static::shuffleArray($arg);
+        }
+
+        if (is_string($arg)) {
+            return static::shuffleString($arg);
+        }
+
+        throw new \InvalidArgumentException('shuffle() only supports strings or arrays');
+    }
+
+    /**
+     * Returns a shuffled version of the array.
+     *
+     * This function does not mutate the original array. It uses the
+     * Fisher–Yates algorithm, which is unbiased, together with a Mersenne
+     * twister random generator. This function is therefore more random than
+     * PHP's shuffle() function, and it is seedable.
+     *
+     * @see http://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
+     *
+     * @example $faker->shuffleArray([1, 2, 3]); // [2, 1, 3]
+     *
+     * @param array $array The set to shuffle
+     *
+     * @return array The shuffled set
+     */
+    public static function shuffleArray($array = [])
+    {
+        $shuffledArray = [];
+        $i = 0;
+        reset($array);
+
+        foreach ($array as $key => $value) {
+            if ($i == 0) {
+                $j = 0;
+            } else {
+                $j = mt_rand(0, $i);
+            }
+
+            if ($j == $i) {
+                $shuffledArray[] = $value;
+            } else {
+                $shuffledArray[] = $shuffledArray[$j];
+                $shuffledArray[$j] = $value;
+            }
+            ++$i;
+        }
+
+        return $shuffledArray;
+    }
+
+    /**
+     * Returns a shuffled version of the string.
+     *
+     * This function does not mutate the original string. It uses the
+     * Fisher–Yates algorithm, which is unbiased, together with a Mersenne
+     * twister random generator. This function is therefore more random than
+     * PHP's shuffle() function, and it is seedable. Additionally, it is
+     * UTF8 safe if the mb extension is available.
+     *
+     * @see http://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
+     *
+     * @example $faker->shuffleString('hello, world'); // 'rlo,h eold!lw'
+     *
+     * @param string $string   The set to shuffle
+     * @param string $encoding The string encoding (defaults to UTF-8)
+     *
+     * @return string The shuffled set
+     */
+    public static function shuffleString($string = '', $encoding = 'UTF-8')
+    {
+        if (function_exists('mb_strlen')) {
+            // UTF8-safe str_split()
+            $array = [];
+            $strlen = mb_strlen($string, $encoding);
+
+            for ($i = 0; $i < $strlen; ++$i) {
+                $array[] = mb_substr($string, $i, 1, $encoding);
+            }
+        } else {
+            $array = str_split($string, 1);
+        }
+
+        return implode('', static::shuffleArray($array));
+    }
+
+    private static function replaceWildcard($string, $wildcard, $callback)
+    {
+        if (($pos = strpos($string, $wildcard)) === false) {
+            return $string;
+        }
+
+        for ($i = $pos, $last = strrpos($string, $wildcard, $pos) + 1; $i < $last; ++$i) {
+            if ($string[$i] === $wildcard) {
+                $string[$i] = call_user_func($callback);
+            }
+        }
+
+        return $string;
+    }
+
+    /**
+     * Replaces all hash sign ('#') occurrences with a random number
+     * Replaces all percentage sign ('%') occurrences with a not null number
+     *
+     * @param string $string String that needs to bet parsed
+     *
+     * @return string
+     */
+    public static function numerify($string = '###')
+    {
+        // instead of using randomDigit() several times, which is slow,
+        // count the number of hashes and generate once a large number
+        $toReplace = [];
+
+        if (($pos = strpos($string, '#')) !== false) {
+            for ($i = $pos, $last = strrpos($string, '#', $pos) + 1; $i < $last; ++$i) {
+                if ($string[$i] === '#') {
+                    $toReplace[] = $i;
+                }
+            }
+        }
+
+        if ($nbReplacements = count($toReplace)) {
+            $maxAtOnce = strlen((string) mt_getrandmax()) - 1;
+            $numbers = '';
+            $i = 0;
+
+            while ($i < $nbReplacements) {
+                $size = min($nbReplacements - $i, $maxAtOnce);
+                $numbers .= str_pad(static::randomNumber($size), $size, '0', STR_PAD_LEFT);
+                $i += $size;
+            }
+
+            for ($i = 0; $i < $nbReplacements; ++$i) {
+                $string[$toReplace[$i]] = $numbers[$i];
+            }
+        }
+        $string = self::replaceWildcard($string, '%', [static::class, 'randomDigitNotNull']);
+
+        return $string;
+    }
+
+    /**
+     * Replaces all question mark ('?') occurrences with a random letter
+     *
+     * @param string $string String that needs to bet parsed
+     *
+     * @return string
+     */
+    public static function lexify($string = '????')
+    {
+        return self::replaceWildcard($string, '?', [static::class,  'randomLetter']);
+    }
+
+    /**
+     * Replaces hash signs ('#') and question marks ('?') with random numbers and letters
+     * An asterisk ('*') is replaced with either a random number or a random letter
+     *
+     * @param string $string String that needs to be parsed
+     *
+     * @return string
+     */
+    public static function bothify($string = '## ??')
+    {
+        $string = self::replaceWildcard($string, '*', static function () {
+            return mt_rand(0, 1) === 1 ? '#' : '?';
+        });
+
+        return static::lexify(static::numerify($string));
+    }
+
+    /**
+     * Replaces * signs with random numbers and letters and special characters
+     *
+     * @example $faker->asciify(''********'); // "s5'G!uC3"
+     *
+     * @param string $string String that needs to bet parsed
+     *
+     * @return string
+     */
+    public static function asciify($string = '****')
+    {
+        return preg_replace_callback('/\*/u', [static::class, 'randomAscii'], $string);
+    }
+
+    /**
+     * Transforms a basic regular expression into a random string satisfying the expression.
+     *
+     * @example $faker->regexify('[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}'); // sm0@y8k96a.ej
+     *
+     * Regex delimiters '/.../' and begin/end markers '^...$' are ignored.
+     *
+     * Only supports a small subset of the regex syntax. For instance,
+     * unicode, negated classes, unbounded ranges, subpatterns, back references,
+     * assertions, recursive patterns, and comments are not supported. Escaping
+     * support is extremely fragile.
+     *
+     * This method is also VERY slow. Use it only when no other formatter
+     * can generate the fake data you want. For instance, prefer calling
+     * `$faker->email` rather than `regexify` with the previous regular
+     * expression.
+     *
+     * Also note than `bothify` can probably do most of what this method does,
+     * but much faster. For instance, for a dummy email generation, try
+     * `$faker->bothify('?????????@???.???')`.
+     *
+     * @see https://github.com/icomefromthenet/ReverseRegex for a more robust implementation
+     *
+     * @param string $regex A regular expression (delimiters are optional)
+     *
+     * @return string
+     */
+    public static function regexify($regex = '')
+    {
+        // ditch the anchors
+        $regex = preg_replace('/^\/?\^?/', '', $regex);
+        $regex = preg_replace('/\$?\/?$/', '', $regex);
+        // All {2} become {2,2}
+        $regex = preg_replace('/\{(\d+)\}/', '{\1,\1}', $regex);
+        // Single-letter quantifiers (?, *, +) become bracket quantifiers ({0,1}, {0,rand}, {1, rand})
+        $regex = preg_replace('/(?<!\\\)\?/', '{0,1}', $regex);
+        $regex = preg_replace('/(?<!\\\)\*/', '{0,' . static::randomDigitNotNull() . '}', $regex);
+        $regex = preg_replace('/(?<!\\\)\+/', '{1,' . static::randomDigitNotNull() . '}', $regex);
+        // [12]{1,2} becomes [12] or [12][12]
+        $regex = preg_replace_callback('/(\[[^\]]+\])\{(\d+),(\d+)\}/', static function ($matches) {
+            return str_repeat($matches[1], Base::randomElement(range($matches[2], $matches[3])));
+        }, $regex);
+        // (12|34){1,2} becomes (12|34) or (12|34)(12|34)
+        $regex = preg_replace_callback('/(\([^\)]+\))\{(\d+),(\d+)\}/', static function ($matches) {
+            return str_repeat($matches[1], Base::randomElement(range($matches[2], $matches[3])));
+        }, $regex);
+        // A{1,2} becomes A or AA or \d{3} becomes \d\d\d
+        $regex = preg_replace_callback('/(\\\?.)\{(\d+),(\d+)\}/', static function ($matches) {
+            return str_repeat($matches[1], Base::randomElement(range($matches[2], $matches[3])));
+        }, $regex);
+        // (this|that) becomes 'this' or 'that'
+        $regex = preg_replace_callback('/\((.*?)\)/', static function ($matches) {
+            return Base::randomElement(explode('|', str_replace(['(', ')'], '', $matches[1])));
+        }, $regex);
+        // All A-F inside of [] become ABCDEF
+        $regex = preg_replace_callback('/\[([^\]]+)\]/', static function ($matches) {
+            return '[' . preg_replace_callback('/(\w|\d)\-(\w|\d)/', static function ($range) {
+                return implode('', range($range[1], $range[2]));
+            }, $matches[1]) . ']';
+        }, $regex);
+        // All [ABC] become B (or A or C)
+        $regex = preg_replace_callback('/\[([^\]]+)\]/', static function ($matches) {
+            // remove backslashes (that are not followed by another backslash) because they are escape characters
+            $match = preg_replace('/\\\(?!\\\)/', '', $matches[1]);
+            $randomElement = Base::randomElement(str_split($match));
+
+            //[.] should not be a random character, but a literal .
+            return str_replace('.', '\.', $randomElement);
+        }, $regex);
+        // replace \d with number and \w with letter and . with ascii
+        $regex = preg_replace_callback('/\\\w/', [static::class, 'randomLetter'], $regex);
+        $regex = preg_replace_callback('/\\\d/', [static::class, 'randomDigit'], $regex);
+        //replace . with ascii except backslash
+        $regex = preg_replace_callback('/(?<!\\\)\./', static function () {
+            $chr = static::asciify('*');
+
+            if ($chr === '\\') {
+                $chr .= '\\';
+            }
+
+            return $chr;
+        }, $regex);
+        // remove remaining single backslashes
+        $regex = str_replace('\\\\', '[:escaped_backslash:]', $regex);
+        $regex = str_replace('\\', '', $regex);
+        $regex = str_replace('[:escaped_backslash:]', '\\', $regex);
+
+        // phew
+        return $regex;
+    }
+
+    /**
+     * Converts string to lowercase.
+     * Uses mb_string extension if available.
+     *
+     * @param string $string String that should be converted to lowercase
+     *
+     * @return string
+     */
+    public static function toLower($string = '')
+    {
+        return extension_loaded('mbstring') ? mb_strtolower($string, 'UTF-8') : strtolower($string);
+    }
+
+    /**
+     * Converts string to uppercase.
+     * Uses mb_string extension if available.
+     *
+     * @param string $string String that should be converted to uppercase
+     *
+     * @return string
+     */
+    public static function toUpper($string = '')
+    {
+        return extension_loaded('mbstring') ? mb_strtoupper($string, 'UTF-8') : strtoupper($string);
+    }
+
+    /**
+     * Chainable method for making any formatter optional.
+     *
+     * @param float|int $weight Set the probability of receiving a null value.
+     *                          "0" will always return null, "1" will always return the generator.
+     *                          If $weight is an integer value, then the same system works
+     *                          between 0 (always get false) and 100 (always get true).
+     *
+     * @return mixed|null
+     */
+    public function optional($weight = 0.5, $default = null)
+    {
+        // old system based on 0.1 <= $weight <= 0.9
+        // TODO: remove in v2
+        if ($weight > 0 && $weight < 1 && mt_rand() / mt_getrandmax() <= $weight) {
+            return $this->generator;
+        }
+
+        // new system with percentage
+        if (is_int($weight) && mt_rand(1, 100) <= $weight) {
+            return $this->generator;
+        }
+
+        return new DefaultGenerator($default);
+    }
+
+    /**
+     * Chainable method for making any formatter unique.
+     *
+     * <code>
+     * // will never return twice the same value
+     * $faker->unique()->randomElement(array(1, 2, 3));
+     * </code>
+     *
+     * @param bool $reset      If set to true, resets the list of existing values
+     * @param int  $maxRetries Maximum number of retries to find a unique value,
+     *                         After which an OverflowException is thrown.
+     *
+     * @throws \OverflowException When no unique value can be found by iterating $maxRetries times
+     *
+     * @return UniqueGenerator A proxy class returning only non-existing values
+     */
+    public function unique($reset = false, $maxRetries = 10000)
+    {
+        if ($reset || !$this->unique) {
+            $this->unique = new UniqueGenerator($this->generator, $maxRetries);
+        }
+
+        return $this->unique;
+    }
+
+    /**
+     * Chainable method for forcing any formatter to return only valid values.
+     *
+     * The value validity is determined by a function passed as first argument.
+     *
+     * <code>
+     * $values = array();
+     * $evenValidator = function ($digit) {
+     *   return $digit % 2 === 0;
+     * };
+     * for ($i=0; $i < 10; $i++) {
+     *   $values []= $faker->valid($evenValidator)->randomDigit;
+     * }
+     * print_r($values); // [0, 4, 8, 4, 2, 6, 0, 8, 8, 6]
+     * </code>
+     *
+     * @param Closure $validator  A function returning true for valid values
+     * @param int     $maxRetries Maximum number of retries to find a unique value,
+     *                            After which an OverflowException is thrown.
+     *
+     * @throws \OverflowException When no valid value can be found by iterating $maxRetries times
+     *
+     * @return ValidGenerator A proxy class returning only valid values
+     */
+    public function valid($validator = null, $maxRetries = 10000)
+    {
+        return new ValidGenerator($this->generator, $validator, $maxRetries);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Biased.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Faker\Provider;
+
+class Biased extends Base
+{
+    /**
+     * Returns a biased integer between $min and $max (both inclusive).
+     * The distribution depends on $function.
+     *
+     * The algorithm creates two doubles, x ∈ [0, 1], y ∈ [0, 1) and checks whether the
+     * return value of $function for x is greater than or equal to y. If this is
+     * the case the number is accepted and x is mapped to the appropriate integer
+     * between $min and $max. Otherwise two new doubles are created until the pair
+     * is accepted.
+     *
+     * @param int      $min      Minimum value of the generated integers.
+     * @param int      $max      Maximum value of the generated integers.
+     * @param callable $function A function mapping x ∈ [0, 1] onto a double ∈ [0, 1]
+     *
+     * @return int An integer between $min and $max.
+     */
+    public function biasedNumberBetween($min = 0, $max = 100, $function = 'sqrt')
+    {
+        do {
+            $x = mt_rand() / mt_getrandmax();
+            $y = mt_rand() / (mt_getrandmax() + 1);
+        } while (call_user_func($function, $x) < $y);
+
+        return (int) floor($x * ($max - $min + 1) + $min);
+    }
+
+    /**
+     * 'unbiased' creates an unbiased distribution by giving
+     * each value the same value of one.
+     *
+     * @return int
+     */
+    protected static function unbiased()
+    {
+        return 1;
+    }
+
+    /**
+     * 'linearLow' favors lower numbers. The probability decreases
+     * in a linear fashion.
+     *
+     * @return int
+     */
+    protected static function linearLow($x)
+    {
+        return 1 - $x;
+    }
+
+    /**
+     * 'linearHigh' favors higher numbers. The probability increases
+     * in a linear fashion.
+     *
+     * @return int
+     */
+    protected static function linearHigh($x)
+    {
+        return $x;
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Color.php

@@ -0,0 +1,158 @@
+<?php
+
+namespace Faker\Provider;
+
+class Color extends Base
+{
+    protected static $safeColorNames = [
+        'black', 'maroon', 'green', 'navy', 'olive',
+        'purple', 'teal', 'lime', 'blue', 'silver',
+        'gray', 'yellow', 'fuchsia', 'aqua', 'white',
+    ];
+
+    protected static $allColorNames = [
+        'AliceBlue', 'AntiqueWhite', 'Aqua', 'Aquamarine',
+        'Azure', 'Beige', 'Bisque', 'Black', 'BlanchedAlmond',
+        'Blue', 'BlueViolet', 'Brown', 'BurlyWood', 'CadetBlue',
+        'Chartreuse', 'Chocolate', 'Coral', 'CornflowerBlue',
+        'Cornsilk', 'Crimson', 'Cyan', 'DarkBlue', 'DarkCyan',
+        'DarkGoldenRod', 'DarkGray', 'DarkGreen', 'DarkKhaki',
+        'DarkMagenta', 'DarkOliveGreen', 'Darkorange', 'DarkOrchid',
+        'DarkRed', 'DarkSalmon', 'DarkSeaGreen', 'DarkSlateBlue',
+        'DarkSlateGray', 'DarkTurquoise', 'DarkViolet', 'DeepPink',
+        'DeepSkyBlue', 'DimGray', 'DimGrey', 'DodgerBlue', 'FireBrick',
+        'FloralWhite', 'ForestGreen', 'Fuchsia', 'Gainsboro', 'GhostWhite',
+        'Gold', 'GoldenRod', 'Gray', 'Green', 'GreenYellow', 'HoneyDew',
+        'HotPink', 'IndianRed', 'Indigo', 'Ivory', 'Khaki', 'Lavender',
+        'LavenderBlush', 'LawnGreen', 'LemonChiffon', 'LightBlue', 'LightCoral',
+        'LightCyan', 'LightGoldenRodYellow', 'LightGray', 'LightGreen', 'LightPink',
+        'LightSalmon', 'LightSeaGreen', 'LightSkyBlue', 'LightSlateGray', 'LightSteelBlue',
+        'LightYellow', 'Lime', 'LimeGreen', 'Linen', 'Magenta', 'Maroon', 'MediumAquaMarine',
+        'MediumBlue', 'MediumOrchid', 'MediumPurple', 'MediumSeaGreen', 'MediumSlateBlue',
+        'MediumSpringGreen', 'MediumTurquoise', 'MediumVioletRed', 'MidnightBlue',
+        'MintCream', 'MistyRose', 'Moccasin', 'NavajoWhite', 'Navy', 'OldLace', 'Olive',
+        'OliveDrab', 'Orange', 'OrangeRed', 'Orchid', 'PaleGoldenRod', 'PaleGreen',
+        'PaleTurquoise', 'PaleVioletRed', 'PapayaWhip', 'PeachPuff', 'Peru', 'Pink', 'Plum',
+        'PowderBlue', 'Purple', 'Red', 'RosyBrown', 'RoyalBlue', 'SaddleBrown', 'Salmon',
+        'SandyBrown', 'SeaGreen', 'SeaShell', 'Sienna', 'Silver', 'SkyBlue', 'SlateBlue',
+        'SlateGray', 'Snow', 'SpringGreen', 'SteelBlue', 'Tan', 'Teal', 'Thistle', 'Tomato',
+        'Turquoise', 'Violet', 'Wheat', 'White', 'WhiteSmoke', 'Yellow', 'YellowGreen',
+    ];
+
+    /**
+     * @example '#fa3cc2'
+     *
+     * @return string
+     */
+    public static function hexColor()
+    {
+        return '#' . str_pad(dechex(self::numberBetween(1, 16777215)), 6, '0', STR_PAD_LEFT);
+    }
+
+    /**
+     * @example '#ff0044'
+     *
+     * @return string
+     */
+    public static function safeHexColor()
+    {
+        $color = str_pad(dechex(self::numberBetween(0, 255)), 3, '0', STR_PAD_LEFT);
+
+        return '#' . $color[0] . $color[0] . $color[1] . $color[1] . $color[2] . $color[2];
+    }
+
+    /**
+     * @example 'array(0,255,122)'
+     *
+     * @return array
+     */
+    public static function rgbColorAsArray()
+    {
+        $color = static::hexColor();
+
+        return [
+            hexdec(substr($color, 1, 2)),
+            hexdec(substr($color, 3, 2)),
+            hexdec(substr($color, 5, 2)),
+        ];
+    }
+
+    /**
+     * @example '0,255,122'
+     *
+     * @return string
+     */
+    public static function rgbColor()
+    {
+        return implode(',', static::rgbColorAsArray());
+    }
+
+    /**
+     * @example 'rgb(0,255,122)'
+     *
+     * @return string
+     */
+    public static function rgbCssColor()
+    {
+        return 'rgb(' . static::rgbColor() . ')';
+    }
+
+    /**
+     * @example 'rgba(0,255,122,0.8)'
+     *
+     * @return string
+     */
+    public static function rgbaCssColor()
+    {
+        return 'rgba(' . static::rgbColor() . ',' . static::randomFloat(1, 0, 1) . ')';
+    }
+
+    /**
+     * @example 'blue'
+     *
+     * @return string
+     */
+    public static function safeColorName()
+    {
+        return static::randomElement(static::$safeColorNames);
+    }
+
+    /**
+     * @example 'NavajoWhite'
+     *
+     * @return string
+     */
+    public static function colorName()
+    {
+        return static::randomElement(static::$allColorNames);
+    }
+
+    /**
+     * @example '340,50,20'
+     *
+     * @return string
+     */
+    public static function hslColor()
+    {
+        return sprintf(
+            '%s,%s,%s',
+            self::numberBetween(0, 360),
+            self::numberBetween(0, 100),
+            self::numberBetween(0, 100),
+        );
+    }
+
+    /**
+     * @example array(340, 50, 20)
+     *
+     * @return array
+     */
+    public static function hslColorAsArray()
+    {
+        return [
+            self::numberBetween(0, 360),
+            self::numberBetween(0, 100),
+            self::numberBetween(0, 100),
+        ];
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Company.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Faker\Provider;
+
+class Company extends Base
+{
+    protected static $formats = [
+        '{{lastName}} {{companySuffix}}',
+    ];
+
+    protected static $companySuffix = ['Ltd'];
+
+    protected static $jobTitleFormat = [
+        '{{word}}',
+    ];
+
+    /**
+     * @example 'Acme Ltd'
+     *
+     * @return string
+     */
+    public function company()
+    {
+        $format = static::randomElement(static::$formats);
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @example 'Ltd'
+     *
+     * @return string
+     */
+    public static function companySuffix()
+    {
+        return static::randomElement(static::$companySuffix);
+    }
+
+    /**
+     * @example 'Job'
+     *
+     * @return string
+     */
+    public function jobTitle()
+    {
+        $format = static::randomElement(static::$jobTitleFormat);
+
+        return $this->generator->parse($format);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/DateTime.php

@@ -0,0 +1,389 @@
+<?php
+
+namespace Faker\Provider;
+
+class DateTime extends Base
+{
+    protected static $century = ['I', 'II', 'III', 'IV', 'V', 'VI', 'VII', 'VIII', 'IX', 'X', 'XI', 'XII', 'XIII', 'XIV', 'XV', 'XVI', 'XVII', 'XVIII', 'XIX', 'XX', 'XXI'];
+
+    protected static $defaultTimezone = null;
+
+    /**
+     * @param \DateTime|float|int|string $max
+     *
+     * @return false|int
+     */
+    protected static function getMaxTimestamp($max = 'now')
+    {
+        if (is_numeric($max)) {
+            return (int) $max;
+        }
+
+        if ($max instanceof \DateTime) {
+            return $max->getTimestamp();
+        }
+
+        return strtotime(empty($max) ? 'now' : $max);
+    }
+
+    /**
+     * Get a timestamp between January 1, 1970, and now
+     *
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return int
+     *
+     * @example 1061306726
+     */
+    public static function unixTime($max = 'now')
+    {
+        return self::numberBetween(0, static::getMaxTimestamp($max));
+    }
+
+    /**
+     * Get a datetime object for a date between January 1, 1970 and now
+     *
+     * @param \DateTime|int|string $max      maximum timestamp used as random end limit, default to "now"
+     * @param string               $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     *
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     *
+     * @example DateTime('2005-08-16 20:39:21')
+     */
+    public static function dateTime($max = 'now', $timezone = null)
+    {
+        return static::setTimezone(
+            new \DateTime('@' . static::unixTime($max)),
+            $timezone,
+        );
+    }
+
+    /**
+     * Get a datetime object for a date between January 1, 001 and now
+     *
+     * @param \DateTime|int|string $max      maximum timestamp used as random end limit, default to "now"
+     * @param string|null          $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     *
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     *
+     * @example DateTime('1265-03-22 21:15:52')
+     */
+    public static function dateTimeAD($max = 'now', $timezone = null)
+    {
+        $min = (PHP_INT_SIZE > 4 ? -62135597361 : -PHP_INT_MAX);
+
+        return static::setTimezone(
+            new \DateTime('@' . self::numberBetween($min, static::getMaxTimestamp($max))),
+            $timezone,
+        );
+    }
+
+    /**
+     * get a date string formatted with ISO8601
+     *
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example '2003-10-21T16:05:52+0000'
+     */
+    public static function iso8601($max = 'now')
+    {
+        return static::date(\DateTime::ISO8601, $max);
+    }
+
+    /**
+     * Get a date string between January 1, 1970 and now
+     *
+     * @param string               $format
+     * @param \DateTime|int|string $max    maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example '2008-11-27'
+     */
+    public static function date($format = 'Y-m-d', $max = 'now')
+    {
+        return static::dateTime($max)->format($format);
+    }
+
+    /**
+     * Get a time string (24h format by default)
+     *
+     * @param string               $format
+     * @param \DateTime|int|string $max    maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example '15:02:34'
+     */
+    public static function time($format = 'H:i:s', $max = 'now')
+    {
+        return static::dateTime($max)->format($format);
+    }
+
+    /**
+     * Get a DateTime object based on a random date between two given dates.
+     * Accepts date strings that can be recognized by strtotime().
+     *
+     * @param \DateTime|string $startDate Defaults to 30 years ago
+     * @param \DateTime|string $endDate   Defaults to "now"
+     * @param string|null      $timezone  time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     *
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     *
+     * @example DateTime('1999-02-02 11:42:52')
+     */
+    public static function dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null)
+    {
+        $startTimestamp = $startDate instanceof \DateTime ? $startDate->getTimestamp() : strtotime($startDate);
+        $endTimestamp = static::getMaxTimestamp($endDate);
+
+        if ($startTimestamp > $endTimestamp) {
+            throw new \InvalidArgumentException('Start date must be anterior to end date.');
+        }
+
+        $timestamp = self::numberBetween($startTimestamp, $endTimestamp);
+
+        return static::setTimezone(
+            new \DateTime('@' . $timestamp),
+            $timezone,
+        );
+    }
+
+    /**
+     * Get a DateTime object based on a random date between one given date and
+     * an interval
+     * Accepts date string that can be recognized by strtotime().
+     *
+     * @param \DateTime|string $date     Defaults to 30 years ago
+     * @param string           $interval Defaults to 5 days after
+     * @param string|null      $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     *
+     * @example dateTimeInInterval('1999-02-02 11:42:52', '+ 5 days')
+     *
+     * @see http://php.net/manual/en/timezones.php
+     * @see http://php.net/manual/en/function.date-default-timezone-get.php
+     */
+    public static function dateTimeInInterval($date = '-30 years', $interval = '+5 days', $timezone = null)
+    {
+        $intervalObject = \DateInterval::createFromDateString($interval);
+        $datetime = $date instanceof \DateTime ? $date : new \DateTime($date);
+        $otherDatetime = clone $datetime;
+        $otherDatetime->add($intervalObject);
+
+        $begin = min($datetime, $otherDatetime);
+        $end = $datetime === $begin ? $otherDatetime : $datetime;
+
+        return static::dateTimeBetween(
+            $begin,
+            $end,
+            $timezone,
+        );
+    }
+
+    /**
+     * Get a date time object somewhere within a century.
+     *
+     * @param \DateTime|int|string $max      maximum timestamp used as random end limit, default to "now"
+     * @param string|null          $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     */
+    public static function dateTimeThisCentury($max = 'now', $timezone = null)
+    {
+        return static::dateTimeBetween('-100 year', $max, $timezone);
+    }
+
+    /**
+     * Get a date time object somewhere within a decade.
+     *
+     * @param \DateTime|int|string $max      maximum timestamp used as random end limit, default to "now"
+     * @param string|null          $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     */
+    public static function dateTimeThisDecade($max = 'now', $timezone = null)
+    {
+        return static::dateTimeBetween('-10 year', $max, $timezone);
+    }
+
+    /**
+     * Get a date time object somewhere inside the current year.
+     *
+     * @param \DateTime|int|string $max      maximum timestamp used as random end limit, default to "now"
+     * @param string|null          $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     */
+    public static function dateTimeThisYear($max = 'now', $timezone = null)
+    {
+        return static::dateTimeBetween('first day of january this year', $max, $timezone);
+    }
+
+    /**
+     * Get a date time object somewhere within a month.
+     *
+     * @param \DateTime|int|string $max      maximum timestamp used as random end limit, default to "now"
+     * @param string|null          $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
+     *
+     * @return \DateTime
+     */
+    public static function dateTimeThisMonth($max = 'now', $timezone = null)
+    {
+        return static::dateTimeBetween('-1 month', $max, $timezone);
+    }
+
+    /**
+     * Get a string containing either "am" or "pm".
+     *
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example 'am'
+     */
+    public static function amPm($max = 'now')
+    {
+        return static::dateTime($max)->format('a');
+    }
+
+    /**
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example '22'
+     */
+    public static function dayOfMonth($max = 'now')
+    {
+        return static::dateTime($max)->format('d');
+    }
+
+    /**
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example 'Tuesday'
+     */
+    public static function dayOfWeek($max = 'now')
+    {
+        return static::dateTime($max)->format('l');
+    }
+
+    /**
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example '7'
+     */
+    public static function month($max = 'now')
+    {
+        return static::dateTime($max)->format('m');
+    }
+
+    /**
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example 'September'
+     */
+    public static function monthName($max = 'now')
+    {
+        return static::dateTime($max)->format('F');
+    }
+
+    /**
+     * @param \DateTime|int|string $max maximum timestamp used as random end limit, default to "now"
+     *
+     * @return string
+     *
+     * @example '1987'
+     */
+    public static function year($max = 'now')
+    {
+        return static::dateTime($max)->format('Y');
+    }
+
+    /**
+     * @return string
+     *
+     * @example 'XVII'
+     */
+    public static function century()
+    {
+        return static::randomElement(static::$century);
+    }
+
+    /**
+     * @return string
+     *
+     * @example 'Europe/Paris'
+     */
+    public static function timezone(?string $countryCode = null)
+    {
+        if ($countryCode) {
+            $timezones = \DateTimeZone::listIdentifiers(\DateTimeZone::PER_COUNTRY, $countryCode);
+        } else {
+            $timezones = \DateTimeZone::listIdentifiers();
+        }
+
+        return static::randomElement($timezones);
+    }
+
+    /**
+     * Internal method to set the time zone on a DateTime.
+     *
+     * @param string|null $timezone
+     *
+     * @return \DateTime
+     */
+    private static function setTimezone(\DateTime $dt, $timezone)
+    {
+        return $dt->setTimezone(new \DateTimeZone(static::resolveTimezone($timezone)));
+    }
+
+    /**
+     * Sets default time zone.
+     *
+     * @param string $timezone
+     */
+    public static function setDefaultTimezone($timezone = null)
+    {
+        static::$defaultTimezone = $timezone;
+    }
+
+    /**
+     * Gets default time zone.
+     *
+     * @return string|null
+     */
+    public static function getDefaultTimezone()
+    {
+        return static::$defaultTimezone;
+    }
+
+    /**
+     * @param string|null $timezone
+     *
+     * @return string|null
+     */
+    private static function resolveTimezone($timezone)
+    {
+        return (null === $timezone) ? ((null === static::$defaultTimezone) ? date_default_timezone_get() : static::$defaultTimezone) : $timezone;
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/File.php

@@ -0,0 +1,610 @@
+<?php
+
+namespace Faker\Provider;
+
+class File extends Base
+{
+    /**
+     * MIME types from the apache.org file. Some types are truncated.
+     *
+     * @var array Map of MIME types => file extension(s)
+     *
+     * @see http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types
+     */
+    protected static $mimeTypes = [
+        'application/atom+xml' => 'atom',
+        'application/ecmascript' => 'ecma',
+        'application/emma+xml' => 'emma',
+        'application/epub+zip' => 'epub',
+        'application/java-archive' => 'jar',
+        'application/java-vm' => 'class',
+        'application/javascript' => 'js',
+        'application/json' => 'json',
+        'application/jsonml+json' => 'jsonml',
+        'application/lost+xml' => 'lostxml',
+        'application/mathml+xml' => 'mathml',
+        'application/mets+xml' => 'mets',
+        'application/mods+xml' => 'mods',
+        'application/mp4' => 'mp4s',
+        'application/msword' => ['doc', 'dot'],
+        'application/octet-stream' => [
+            'bin',
+            'dms',
+            'lrf',
+            'mar',
+            'so',
+            'dist',
+            'distz',
+            'pkg',
+            'bpk',
+            'dump',
+            'elc',
+            'deploy',
+        ],
+        'application/ogg' => 'ogx',
+        'application/omdoc+xml' => 'omdoc',
+        'application/pdf' => 'pdf',
+        'application/pgp-encrypted' => 'pgp',
+        'application/pgp-signature' => ['asc', 'sig'],
+        'application/pkix-pkipath' => 'pkipath',
+        'application/pkixcmp' => 'pki',
+        'application/pls+xml' => 'pls',
+        'application/postscript' => ['ai', 'eps', 'ps'],
+        'application/pskc+xml' => 'pskcxml',
+        'application/rdf+xml' => 'rdf',
+        'application/reginfo+xml' => 'rif',
+        'application/rss+xml' => 'rss',
+        'application/rtf' => 'rtf',
+        'application/sbml+xml' => 'sbml',
+        'application/vnd.adobe.air-application-installer-package+zip' => 'air',
+        'application/vnd.adobe.xdp+xml' => 'xdp',
+        'application/vnd.adobe.xfdf' => 'xfdf',
+        'application/vnd.ahead.space' => 'ahead',
+        'application/vnd.dart' => 'dart',
+        'application/vnd.data-vision.rdz' => 'rdz',
+        'application/vnd.dece.data' => ['uvf', 'uvvf', 'uvd', 'uvvd'],
+        'application/vnd.dece.ttml+xml' => ['uvt', 'uvvt'],
+        'application/vnd.dece.unspecified' => ['uvx', 'uvvx'],
+        'application/vnd.dece.zip' => ['uvz', 'uvvz'],
+        'application/vnd.denovo.fcselayout-link' => 'fe_launch',
+        'application/vnd.dna' => 'dna',
+        'application/vnd.dolby.mlp' => 'mlp',
+        'application/vnd.dpgraph' => 'dpg',
+        'application/vnd.dreamfactory' => 'dfac',
+        'application/vnd.ds-keypoint' => 'kpxx',
+        'application/vnd.dvb.ait' => 'ait',
+        'application/vnd.dvb.service' => 'svc',
+        'application/vnd.dynageo' => 'geo',
+        'application/vnd.ecowin.chart' => 'mag',
+        'application/vnd.enliven' => 'nml',
+        'application/vnd.epson.esf' => 'esf',
+        'application/vnd.epson.msf' => 'msf',
+        'application/vnd.epson.quickanime' => 'qam',
+        'application/vnd.epson.salt' => 'slt',
+        'application/vnd.epson.ssf' => 'ssf',
+        'application/vnd.ezpix-album' => 'ez2',
+        'application/vnd.ezpix-package' => 'ez3',
+        'application/vnd.fdf' => 'fdf',
+        'application/vnd.fdsn.mseed' => 'mseed',
+        'application/vnd.fdsn.seed' => ['seed', 'dataless'],
+        'application/vnd.flographit' => 'gph',
+        'application/vnd.fluxtime.clip' => 'ftc',
+        'application/vnd.hal+xml' => 'hal',
+        'application/vnd.hydrostatix.sof-data' => 'sfd-hdstx',
+        'application/vnd.ibm.minipay' => 'mpy',
+        'application/vnd.ibm.secure-container' => 'sc',
+        'application/vnd.iccprofile' => ['icc', 'icm'],
+        'application/vnd.igloader' => 'igl',
+        'application/vnd.immervision-ivp' => 'ivp',
+        'application/vnd.kde.karbon' => 'karbon',
+        'application/vnd.kde.kchart' => 'chrt',
+        'application/vnd.kde.kformula' => 'kfo',
+        'application/vnd.kde.kivio' => 'flw',
+        'application/vnd.kde.kontour' => 'kon',
+        'application/vnd.kde.kpresenter' => ['kpr', 'kpt'],
+        'application/vnd.kde.kspread' => 'ksp',
+        'application/vnd.kde.kword' => ['kwd', 'kwt'],
+        'application/vnd.kenameaapp' => 'htke',
+        'application/vnd.kidspiration' => 'kia',
+        'application/vnd.kinar' => ['kne', 'knp'],
+        'application/vnd.koan' => ['skp', 'skd', 'skt', 'skm'],
+        'application/vnd.kodak-descriptor' => 'sse',
+        'application/vnd.las.las+xml' => 'lasxml',
+        'application/vnd.llamagraphics.life-balance.desktop' => 'lbd',
+        'application/vnd.llamagraphics.life-balance.exchange+xml' => 'lbe',
+        'application/vnd.lotus-1-2-3' => '123',
+        'application/vnd.lotus-approach' => 'apr',
+        'application/vnd.lotus-freelance' => 'pre',
+        'application/vnd.lotus-notes' => 'nsf',
+        'application/vnd.lotus-organizer' => 'org',
+        'application/vnd.lotus-screencam' => 'scm',
+        'application/vnd.mozilla.xul+xml' => 'xul',
+        'application/vnd.ms-artgalry' => 'cil',
+        'application/vnd.ms-cab-compressed' => 'cab',
+        'application/vnd.ms-excel' => [
+            'xls',
+            'xlm',
+            'xla',
+            'xlc',
+            'xlt',
+            'xlw',
+        ],
+        'application/vnd.ms-excel.addin.macroenabled.12' => 'xlam',
+        'application/vnd.ms-excel.sheet.binary.macroenabled.12' => 'xlsb',
+        'application/vnd.ms-excel.sheet.macroenabled.12' => 'xlsm',
+        'application/vnd.ms-excel.template.macroenabled.12' => 'xltm',
+        'application/vnd.ms-fontobject' => 'eot',
+        'application/vnd.ms-htmlhelp' => 'chm',
+        'application/vnd.ms-ims' => 'ims',
+        'application/vnd.ms-lrm' => 'lrm',
+        'application/vnd.ms-officetheme' => 'thmx',
+        'application/vnd.ms-pki.seccat' => 'cat',
+        'application/vnd.ms-pki.stl' => 'stl',
+        'application/vnd.ms-powerpoint' => ['ppt', 'pps', 'pot'],
+        'application/vnd.ms-powerpoint.addin.macroenabled.12' => 'ppam',
+        'application/vnd.ms-powerpoint.presentation.macroenabled.12' => 'pptm',
+        'application/vnd.ms-powerpoint.slide.macroenabled.12' => 'sldm',
+        'application/vnd.ms-powerpoint.slideshow.macroenabled.12' => 'ppsm',
+        'application/vnd.ms-powerpoint.template.macroenabled.12' => 'potm',
+        'application/vnd.ms-project' => ['mpp', 'mpt'],
+        'application/vnd.ms-word.document.macroenabled.12' => 'docm',
+        'application/vnd.ms-word.template.macroenabled.12' => 'dotm',
+        'application/vnd.ms-works' => ['wps', 'wks', 'wcm', 'wdb'],
+        'application/vnd.ms-wpl' => 'wpl',
+        'application/vnd.ms-xpsdocument' => 'xps',
+        'application/vnd.mseq' => 'mseq',
+        'application/vnd.musician' => 'mus',
+        'application/vnd.oasis.opendocument.chart' => 'odc',
+        'application/vnd.oasis.opendocument.chart-template' => 'otc',
+        'application/vnd.oasis.opendocument.database' => 'odb',
+        'application/vnd.oasis.opendocument.formula' => 'odf',
+        'application/vnd.oasis.opendocument.formula-template' => 'odft',
+        'application/vnd.oasis.opendocument.graphics' => 'odg',
+        'application/vnd.oasis.opendocument.graphics-template' => 'otg',
+        'application/vnd.oasis.opendocument.image' => 'odi',
+        'application/vnd.oasis.opendocument.image-template' => 'oti',
+        'application/vnd.oasis.opendocument.presentation' => 'odp',
+        'application/vnd.oasis.opendocument.presentation-template' => 'otp',
+        'application/vnd.oasis.opendocument.spreadsheet' => 'ods',
+        'application/vnd.oasis.opendocument.spreadsheet-template' => 'ots',
+        'application/vnd.oasis.opendocument.text' => 'odt',
+        'application/vnd.oasis.opendocument.text-master' => 'odm',
+        'application/vnd.oasis.opendocument.text-template' => 'ott',
+        'application/vnd.oasis.opendocument.text-web' => 'oth',
+        'application/vnd.olpc-sugar' => 'xo',
+        'application/vnd.oma.dd2+xml' => 'dd2',
+        'application/vnd.openofficeorg.extension' => 'oxt',
+        'application/vnd.openxmlformats-officedocument.presentationml.presentation' => 'pptx',
+        'application/vnd.openxmlformats-officedocument.presentationml.slide' => 'sldx',
+        'application/vnd.openxmlformats-officedocument.presentationml.slideshow' => 'ppsx',
+        'application/vnd.openxmlformats-officedocument.presentationml.template' => 'potx',
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' => 'xlsx',
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.template' => 'xltx',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document' => 'docx',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.template' => 'dotx',
+        'application/vnd.pvi.ptid1' => 'ptid',
+        'application/vnd.quark.quarkxpress' => [
+            'qxd',
+            'qxt',
+            'qwd',
+            'qwt',
+            'qxl',
+            'qxb',
+        ],
+        'application/vnd.realvnc.bed' => 'bed',
+        'application/vnd.recordare.musicxml' => 'mxl',
+        'application/vnd.recordare.musicxml+xml' => 'musicxml',
+        'application/vnd.rig.cryptonote' => 'cryptonote',
+        'application/vnd.rim.cod' => 'cod',
+        'application/vnd.rn-realmedia' => 'rm',
+        'application/vnd.rn-realmedia-vbr' => 'rmvb',
+        'application/vnd.route66.link66+xml' => 'link66',
+        'application/vnd.sailingtracker.track' => 'st',
+        'application/vnd.seemail' => 'see',
+        'application/vnd.sema' => 'sema',
+        'application/vnd.semd' => 'semd',
+        'application/vnd.semf' => 'semf',
+        'application/vnd.shana.informed.formdata' => 'ifm',
+        'application/vnd.shana.informed.formtemplate' => 'itp',
+        'application/vnd.shana.informed.interchange' => 'iif',
+        'application/vnd.shana.informed.package' => 'ipk',
+        'application/vnd.simtech-mindmapper' => ['twd', 'twds'],
+        'application/vnd.smaf' => 'mmf',
+        'application/vnd.stepmania.stepchart' => 'sm',
+        'application/vnd.sun.xml.calc' => 'sxc',
+        'application/vnd.sun.xml.calc.template' => 'stc',
+        'application/vnd.sun.xml.draw' => 'sxd',
+        'application/vnd.sun.xml.draw.template' => 'std',
+        'application/vnd.sun.xml.impress' => 'sxi',
+        'application/vnd.sun.xml.impress.template' => 'sti',
+        'application/vnd.sun.xml.math' => 'sxm',
+        'application/vnd.sun.xml.writer' => 'sxw',
+        'application/vnd.sun.xml.writer.global' => 'sxg',
+        'application/vnd.sun.xml.writer.template' => 'stw',
+        'application/vnd.sus-calendar' => ['sus', 'susp'],
+        'application/vnd.svd' => 'svd',
+        'application/vnd.symbian.install' => ['sis', 'sisx'],
+        'application/vnd.syncml+xml' => 'xsm',
+        'application/vnd.syncml.dm+wbxml' => 'bdm',
+        'application/vnd.syncml.dm+xml' => 'xdm',
+        'application/vnd.tao.intent-module-archive' => 'tao',
+        'application/vnd.tcpdump.pcap' => ['pcap', 'cap', 'dmp'],
+        'application/vnd.tmobile-livetv' => 'tmo',
+        'application/vnd.trid.tpt' => 'tpt',
+        'application/vnd.triscape.mxs' => 'mxs',
+        'application/vnd.trueapp' => 'tra',
+        'application/vnd.ufdl' => ['ufd', 'ufdl'],
+        'application/vnd.uiq.theme' => 'utz',
+        'application/vnd.umajin' => 'umj',
+        'application/vnd.unity' => 'unityweb',
+        'application/vnd.uoml+xml' => 'uoml',
+        'application/vnd.vcx' => 'vcx',
+        'application/vnd.visio' => ['vsd', 'vst', 'vss', 'vsw'],
+        'application/vnd.visionary' => 'vis',
+        'application/vnd.vsf' => 'vsf',
+        'application/vnd.wap.wbxml' => 'wbxml',
+        'application/vnd.wap.wmlc' => 'wmlc',
+        'application/vnd.wap.wmlscriptc' => 'wmlsc',
+        'application/vnd.webturbo' => 'wtb',
+        'application/vnd.wolfram.player' => 'nbp',
+        'application/vnd.wordperfect' => 'wpd',
+        'application/vnd.wqd' => 'wqd',
+        'application/vnd.wt.stf' => 'stf',
+        'application/vnd.xara' => 'xar',
+        'application/vnd.xfdl' => 'xfdl',
+        'application/voicexml+xml' => 'vxml',
+        'application/widget' => 'wgt',
+        'application/winhlp' => 'hlp',
+        'application/wsdl+xml' => 'wsdl',
+        'application/wspolicy+xml' => 'wspolicy',
+        'application/x-7z-compressed' => '7z',
+        'application/x-bittorrent' => 'torrent',
+        'application/x-blorb' => ['blb', 'blorb'],
+        'application/x-bzip' => 'bz',
+        'application/x-cdlink' => 'vcd',
+        'application/x-cfs-compressed' => 'cfs',
+        'application/x-chat' => 'chat',
+        'application/x-chess-pgn' => 'pgn',
+        'application/x-conference' => 'nsc',
+        'application/x-cpio' => 'cpio',
+        'application/x-csh' => 'csh',
+        'application/x-debian-package' => ['deb', 'udeb'],
+        'application/x-dgc-compressed' => 'dgc',
+        'application/x-director' => [
+            'dir',
+            'dcr',
+            'dxr',
+            'cst',
+            'cct',
+            'cxt',
+            'w3d',
+            'fgd',
+            'swa',
+        ],
+        'application/x-font-ttf' => ['ttf', 'ttc'],
+        'application/x-font-type1' => ['pfa', 'pfb', 'pfm', 'afm'],
+        'application/x-font-woff' => 'woff',
+        'application/x-freearc' => 'arc',
+        'application/x-futuresplash' => 'spl',
+        'application/x-gca-compressed' => 'gca',
+        'application/x-glulx' => 'ulx',
+        'application/x-gnumeric' => 'gnumeric',
+        'application/x-gramps-xml' => 'gramps',
+        'application/x-gtar' => 'gtar',
+        'application/x-hdf' => 'hdf',
+        'application/x-install-instructions' => 'install',
+        'application/x-iso9660-image' => 'iso',
+        'application/x-java-jnlp-file' => 'jnlp',
+        'application/x-latex' => 'latex',
+        'application/x-lzh-compressed' => ['lzh', 'lha'],
+        'application/x-mie' => 'mie',
+        'application/x-mobipocket-ebook' => ['prc', 'mobi'],
+        'application/x-ms-application' => 'application',
+        'application/x-ms-shortcut' => 'lnk',
+        'application/x-ms-wmd' => 'wmd',
+        'application/x-ms-wmz' => 'wmz',
+        'application/x-ms-xbap' => 'xbap',
+        'application/x-msaccess' => 'mdb',
+        'application/x-msbinder' => 'obd',
+        'application/x-mscardfile' => 'crd',
+        'application/x-msclip' => 'clp',
+        'application/x-msdownload' => ['exe', 'dll', 'com', 'bat', 'msi'],
+        'application/x-msmediaview' => [
+            'mvb',
+            'm13',
+            'm14',
+        ],
+        'application/x-msmetafile' => ['wmf', 'wmz', 'emf', 'emz'],
+        'application/x-rar-compressed' => 'rar',
+        'application/x-research-info-systems' => 'ris',
+        'application/x-sh' => 'sh',
+        'application/x-shar' => 'shar',
+        'application/x-shockwave-flash' => 'swf',
+        'application/x-silverlight-app' => 'xap',
+        'application/x-sql' => 'sql',
+        'application/x-stuffit' => 'sit',
+        'application/x-stuffitx' => 'sitx',
+        'application/x-subrip' => 'srt',
+        'application/x-sv4cpio' => 'sv4cpio',
+        'application/x-sv4crc' => 'sv4crc',
+        'application/x-t3vm-image' => 't3',
+        'application/x-tads' => 'gam',
+        'application/x-tar' => 'tar',
+        'application/x-tcl' => 'tcl',
+        'application/x-tex' => 'tex',
+        'application/x-tex-tfm' => 'tfm',
+        'application/x-texinfo' => ['texinfo', 'texi'],
+        'application/x-tgif' => 'obj',
+        'application/x-ustar' => 'ustar',
+        'application/x-wais-source' => 'src',
+        'application/x-x509-ca-cert' => ['der', 'crt'],
+        'application/x-xfig' => 'fig',
+        'application/x-xliff+xml' => 'xlf',
+        'application/x-xpinstall' => 'xpi',
+        'application/x-xz' => 'xz',
+        'application/x-zmachine' => 'z1',
+        'application/xaml+xml' => 'xaml',
+        'application/xcap-diff+xml' => 'xdf',
+        'application/xenc+xml' => 'xenc',
+        'application/xhtml+xml' => ['xhtml', 'xht'],
+        'application/xml' => ['xml', 'xsl'],
+        'application/xml-dtd' => 'dtd',
+        'application/xop+xml' => 'xop',
+        'application/xproc+xml' => 'xpl',
+        'application/xslt+xml' => 'xslt',
+        'application/xspf+xml' => 'xspf',
+        'application/xv+xml' => ['mxml', 'xhvml', 'xvml', 'xvm'],
+        'application/yang' => 'yang',
+        'application/yin+xml' => 'yin',
+        'application/zip' => 'zip',
+        'audio/adpcm' => 'adp',
+        'audio/basic' => ['au', 'snd'],
+        'audio/midi' => ['mid', 'midi', 'kar', 'rmi'],
+        'audio/mp4' => 'mp4a',
+        'audio/mpeg' => [
+            'mpga',
+            'mp2',
+            'mp2a',
+            'mp3',
+            'm2a',
+            'm3a',
+        ],
+        'audio/ogg' => ['oga', 'ogg', 'spx'],
+        'audio/vnd.dece.audio' => ['uva', 'uvva'],
+        'audio/vnd.rip' => 'rip',
+        'audio/webm' => 'weba',
+        'audio/x-aac' => 'aac',
+        'audio/x-aiff' => ['aif', 'aiff', 'aifc'],
+        'audio/x-caf' => 'caf',
+        'audio/x-flac' => 'flac',
+        'audio/x-matroska' => 'mka',
+        'audio/x-mpegurl' => 'm3u',
+        'audio/x-ms-wax' => 'wax',
+        'audio/x-ms-wma' => 'wma',
+        'audio/x-pn-realaudio' => ['ram', 'ra'],
+        'audio/x-pn-realaudio-plugin' => 'rmp',
+        'audio/x-wav' => 'wav',
+        'audio/xm' => 'xm',
+        'image/bmp' => 'bmp',
+        'image/cgm' => 'cgm',
+        'image/g3fax' => 'g3',
+        'image/gif' => 'gif',
+        'image/ief' => 'ief',
+        'image/jpeg' => ['jpeg', 'jpg', 'jpe'],
+        'image/ktx' => 'ktx',
+        'image/png' => 'png',
+        'image/prs.btif' => 'btif',
+        'image/sgi' => 'sgi',
+        'image/svg+xml' => ['svg', 'svgz'],
+        'image/tiff' => ['tiff', 'tif'],
+        'image/vnd.adobe.photoshop' => 'psd',
+        'image/vnd.dece.graphic' => ['uvi', 'uvvi', 'uvg', 'uvvg'],
+        'image/vnd.dvb.subtitle' => 'sub',
+        'image/vnd.djvu' => ['djvu', 'djv'],
+        'image/vnd.dwg' => 'dwg',
+        'image/vnd.dxf' => 'dxf',
+        'image/vnd.fastbidsheet' => 'fbs',
+        'image/vnd.fpx' => 'fpx',
+        'image/vnd.fst' => 'fst',
+        'image/vnd.fujixerox.edmics-mmr' => 'mmr',
+        'image/vnd.fujixerox.edmics-rlc' => 'rlc',
+        'image/vnd.ms-modi' => 'mdi',
+        'image/vnd.ms-photo' => 'wdp',
+        'image/vnd.net-fpx' => 'npx',
+        'image/vnd.wap.wbmp' => 'wbmp',
+        'image/vnd.xiff' => 'xif',
+        'image/webp' => 'webp',
+        'image/x-3ds' => '3ds',
+        'image/x-cmu-raster' => 'ras',
+        'image/x-cmx' => 'cmx',
+        'image/x-freehand' => ['fh', 'fhc', 'fh4', 'fh5', 'fh7'],
+        'image/x-icon' => 'ico',
+        'image/x-mrsid-image' => 'sid',
+        'image/x-pcx' => 'pcx',
+        'image/x-pict' => ['pic', 'pct'],
+        'image/x-portable-anymap' => 'pnm',
+        'image/x-portable-bitmap' => 'pbm',
+        'image/x-portable-graymap' => 'pgm',
+        'image/x-portable-pixmap' => 'ppm',
+        'image/x-rgb' => 'rgb',
+        'image/x-tga' => 'tga',
+        'image/x-xbitmap' => 'xbm',
+        'image/x-xpixmap' => 'xpm',
+        'image/x-xwindowdump' => 'xwd',
+        'message/rfc822' => ['eml', 'mime'],
+        'model/iges' => ['igs', 'iges'],
+        'model/mesh' => ['msh', 'mesh', 'silo'],
+        'model/vnd.collada+xml' => 'dae',
+        'model/vnd.dwf' => 'dwf',
+        'model/vnd.gdl' => 'gdl',
+        'model/vnd.gtw' => 'gtw',
+        'model/vnd.mts' => 'mts',
+        'model/vnd.vtu' => 'vtu',
+        'model/vrml' => ['wrl', 'vrml'],
+        'model/x3d+binary' => 'x3db',
+        'model/x3d+vrml' => 'x3dv',
+        'model/x3d+xml' => 'x3d',
+        'text/cache-manifest' => 'appcache',
+        'text/calendar' => ['ics', 'ifb'],
+        'text/css' => 'css',
+        'text/csv' => 'csv',
+        'text/html' => ['html', 'htm'],
+        'text/n3' => 'n3',
+        'text/plain' => [
+            'txt',
+            'text',
+            'conf',
+            'def',
+            'list',
+            'log',
+            'in',
+        ],
+        'text/prs.lines.tag' => 'dsc',
+        'text/richtext' => 'rtx',
+        'text/sgml' => ['sgml', 'sgm'],
+        'text/tab-separated-values' => 'tsv',
+        'text/troff' => [
+            't',
+            'tr',
+            'roff',
+            'man',
+            'me',
+            'ms',
+        ],
+        'text/turtle' => 'ttl',
+        'text/uri-list' => ['uri', 'uris', 'urls'],
+        'text/vcard' => 'vcard',
+        'text/vnd.curl' => 'curl',
+        'text/vnd.curl.dcurl' => 'dcurl',
+        'text/vnd.curl.scurl' => 'scurl',
+        'text/vnd.curl.mcurl' => 'mcurl',
+        'text/vnd.dvb.subtitle' => 'sub',
+        'text/vnd.fly' => 'fly',
+        'text/vnd.fmi.flexstor' => 'flx',
+        'text/vnd.graphviz' => 'gv',
+        'text/vnd.in3d.3dml' => '3dml',
+        'text/vnd.in3d.spot' => 'spot',
+        'text/vnd.sun.j2me.app-descriptor' => 'jad',
+        'text/vnd.wap.wml' => 'wml',
+        'text/vnd.wap.wmlscript' => 'wmls',
+        'text/x-asm' => ['s', 'asm'],
+        'text/x-fortran' => ['f', 'for', 'f77', 'f90'],
+        'text/x-java-source' => 'java',
+        'text/x-opml' => 'opml',
+        'text/x-pascal' => ['p', 'pas'],
+        'text/x-nfo' => 'nfo',
+        'text/x-setext' => 'etx',
+        'text/x-sfv' => 'sfv',
+        'text/x-uuencode' => 'uu',
+        'text/x-vcalendar' => 'vcs',
+        'text/x-vcard' => 'vcf',
+        'video/3gpp' => '3gp',
+        'video/3gpp2' => '3g2',
+        'video/h261' => 'h261',
+        'video/h263' => 'h263',
+        'video/h264' => 'h264',
+        'video/jpeg' => 'jpgv',
+        'video/jpm' => ['jpm', 'jpgm'],
+        'video/mj2' => 'mj2',
+        'video/mp4' => 'mp4',
+        'video/mpeg' => ['mpeg', 'mpg', 'mpe', 'm1v', 'm2v'],
+        'video/ogg' => 'ogv',
+        'video/quicktime' => ['qt', 'mov'],
+        'video/vnd.dece.hd' => ['uvh', 'uvvh'],
+        'video/vnd.dece.mobile' => ['uvm', 'uvvm'],
+        'video/vnd.dece.pd' => ['uvp', 'uvvp'],
+        'video/vnd.dece.sd' => ['uvs', 'uvvs'],
+        'video/vnd.dece.video' => ['uvv', 'uvvv'],
+        'video/vnd.dvb.file' => 'dvb',
+        'video/vnd.fvt' => 'fvt',
+        'video/vnd.mpegurl' => ['mxu', 'm4u'],
+        'video/vnd.ms-playready.media.pyv' => 'pyv',
+        'video/vnd.uvvu.mp4' => ['uvu', 'uvvu'],
+        'video/vnd.vivo' => 'viv',
+        'video/webm' => 'webm',
+        'video/x-f4v' => 'f4v',
+        'video/x-fli' => 'fli',
+        'video/x-flv' => 'flv',
+        'video/x-m4v' => 'm4v',
+        'video/x-matroska' => ['mkv', 'mk3d', 'mks'],
+        'video/x-mng' => 'mng',
+        'video/x-ms-asf' => ['asf', 'asx'],
+        'video/x-ms-vob' => 'vob',
+        'video/x-ms-wm' => 'wm',
+        'video/x-ms-wmv' => 'wmv',
+        'video/x-ms-wmx' => 'wmx',
+        'video/x-ms-wvx' => 'wvx',
+        'video/x-msvideo' => 'avi',
+        'video/x-sgi-movie' => 'movie',
+    ];
+
+    /**
+     * Get a random MIME type
+     *
+     * @return string
+     *
+     * @example 'video/avi'
+     */
+    public static function mimeType()
+    {
+        return static::randomElement(array_keys(static::$mimeTypes));
+    }
+
+    /**
+     * Get a random file extension (without a dot)
+     *
+     * @example avi
+     *
+     * @return string
+     */
+    public static function fileExtension()
+    {
+        $random_extension = static::randomElement(array_values(static::$mimeTypes));
+
+        return is_array($random_extension) ? static::randomElement($random_extension) : $random_extension;
+    }
+
+    /**
+     * Copy a random file from the source directory to the target directory and returns the filename/fullpath
+     *
+     * @param string $sourceDirectory The directory to look for random file taking
+     * @param string $targetDirectory
+     * @param bool   $fullPath        Whether to have the full path or just the filename
+     *
+     * @return string
+     */
+    public static function file($sourceDirectory = '/tmp', $targetDirectory = '/tmp', $fullPath = true)
+    {
+        if (!is_dir($sourceDirectory)) {
+            throw new \InvalidArgumentException(sprintf('Source directory %s does not exist or is not a directory.', $sourceDirectory));
+        }
+
+        if (!is_dir($targetDirectory)) {
+            throw new \InvalidArgumentException(sprintf('Target directory %s does not exist or is not a directory.', $targetDirectory));
+        }
+
+        if ($sourceDirectory == $targetDirectory) {
+            throw new \InvalidArgumentException('Source and target directories must differ.');
+        }
+
+        // Drop . and .. and reset array keys
+        $files = array_filter(array_values(array_diff(scandir($sourceDirectory), ['.', '..'])), static function ($file) use ($sourceDirectory) {
+            return is_file($sourceDirectory . DIRECTORY_SEPARATOR . $file) && is_readable($sourceDirectory . DIRECTORY_SEPARATOR . $file);
+        });
+
+        if (empty($files)) {
+            throw new \InvalidArgumentException(sprintf('Source directory %s is empty.', $sourceDirectory));
+        }
+
+        $sourceFullPath = $sourceDirectory . DIRECTORY_SEPARATOR . static::randomElement($files);
+
+        $destinationFile = Uuid::uuid() . '.' . pathinfo($sourceFullPath, PATHINFO_EXTENSION);
+        $destinationFullPath = $targetDirectory . DIRECTORY_SEPARATOR . $destinationFile;
+
+        if (false === copy($sourceFullPath, $destinationFullPath)) {
+            return false;
+        }
+
+        return $fullPath ? $destinationFullPath : $destinationFile;
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/HtmlLorem.php

@@ -0,0 +1,307 @@
+<?php
+
+namespace Faker\Provider;
+
+use Faker\Generator;
+use Faker\UniqueGenerator;
+
+class HtmlLorem extends Base
+{
+    public const HTML_TAG = 'html';
+    public const HEAD_TAG = 'head';
+    public const BODY_TAG = 'body';
+    public const DIV_TAG = 'div';
+    public const P_TAG = 'p';
+    public const A_TAG = 'a';
+    public const SPAN_TAG = 'span';
+    public const TABLE_TAG = 'table';
+    public const THEAD_TAG = 'thead';
+    public const TBODY_TAG = 'tbody';
+    public const TR_TAG = 'tr';
+    public const TD_TAG = 'td';
+    public const TH_TAG = 'th';
+    public const UL_TAG = 'ul';
+    public const LI_TAG = 'li';
+    public const H_TAG = 'h';
+    public const B_TAG = 'b';
+    public const I_TAG = 'i';
+    public const TITLE_TAG = 'title';
+    public const FORM_TAG = 'form';
+    public const INPUT_TAG = 'input';
+    public const LABEL_TAG = 'label';
+
+    private $idGenerator;
+
+    public function __construct(Generator $generator)
+    {
+        parent::__construct($generator);
+        $generator->addProvider(new Lorem($generator));
+        $generator->addProvider(new Internet($generator));
+    }
+
+    /**
+     * @param int $maxDepth
+     * @param int $maxWidth
+     *
+     * @return string
+     */
+    public function randomHtml($maxDepth = 4, $maxWidth = 4)
+    {
+        if (!class_exists(\DOMDocument::class, false)) {
+            throw new \RuntimeException('ext-dom is required to use randomHtml.');
+        }
+
+        $document = new \DOMDocument();
+        $this->idGenerator = new UniqueGenerator($this->generator);
+
+        $head = $document->createElement('head');
+        $this->addRandomTitle($head);
+
+        $body = $document->createElement('body');
+        $this->addLoginForm($body);
+        $this->addRandomSubTree($body, $maxDepth, $maxWidth);
+
+        $html = $document->createElement('html');
+        $html->appendChild($head);
+        $html->appendChild($body);
+
+        $document->appendChild($html);
+
+        return $document->saveHTML();
+    }
+
+    private function addRandomSubTree(\DOMElement $root, $maxDepth, $maxWidth)
+    {
+        --$maxDepth;
+
+        if ($maxDepth <= 0) {
+            return $root;
+        }
+
+        $siblings = self::numberBetween(1, $maxWidth);
+
+        for ($i = 0; $i < $siblings; ++$i) {
+            if ($maxDepth == 1) {
+                $this->addRandomLeaf($root);
+            } else {
+                $sibling = $root->ownerDocument->createElement('div');
+                $root->appendChild($sibling);
+                $this->addRandomAttribute($sibling);
+                $this->addRandomSubTree($sibling, self::numberBetween(0, $maxDepth), $maxWidth);
+            }
+        }
+
+        return $root;
+    }
+
+    private function addRandomLeaf(\DOMElement $node): void
+    {
+        $rand = self::numberBetween(1, 10);
+
+        switch ($rand) {
+            case 1:
+                $this->addRandomP($node);
+
+                break;
+
+            case 2:
+                $this->addRandomA($node);
+
+                break;
+
+            case 3:
+                $this->addRandomSpan($node);
+
+                break;
+
+            case 4:
+                $this->addRandomUL($node);
+
+                break;
+
+            case 5:
+                $this->addRandomH($node);
+
+                break;
+
+            case 6:
+                $this->addRandomB($node);
+
+                break;
+
+            case 7:
+                $this->addRandomI($node);
+
+                break;
+
+            case 8:
+                $this->addRandomTable($node);
+
+                break;
+
+            default:
+                $this->addRandomText($node);
+
+                break;
+        }
+    }
+
+    private function addRandomAttribute(\DOMElement $node): void
+    {
+        $rand = self::numberBetween(1, 2);
+
+        switch ($rand) {
+            case 1:
+                $node->setAttribute('class', $this->generator->word());
+
+                break;
+
+            case 2:
+                $node->setAttribute('id', (string) $this->idGenerator->randomNumber(5));
+
+                break;
+        }
+    }
+
+    private function addRandomP(\DOMElement $element, $maxLength = 10): void
+    {
+        $node = $element->ownerDocument->createElement(static::P_TAG);
+        $node->textContent = $this->generator->sentence(self::numberBetween(1, $maxLength));
+        $element->appendChild($node);
+    }
+
+    private function addRandomText(\DOMElement $element, $maxLength = 10): void
+    {
+        $text = $element->ownerDocument->createTextNode($this->generator->sentence(self::numberBetween(1, $maxLength)));
+        $element->appendChild($text);
+    }
+
+    private function addRandomA(\DOMElement $element, $maxLength = 10): void
+    {
+        $text = $element->ownerDocument->createTextNode($this->generator->sentence(self::numberBetween(1, $maxLength)));
+        $node = $element->ownerDocument->createElement(static::A_TAG);
+        $node->setAttribute('href', $this->generator->safeEmailDomain());
+        $node->appendChild($text);
+        $element->appendChild($node);
+    }
+
+    private function addRandomTitle(\DOMElement $element, $maxLength = 10): void
+    {
+        $text = $element->ownerDocument->createTextNode($this->generator->sentence(self::numberBetween(1, $maxLength)));
+        $node = $element->ownerDocument->createElement(static::TITLE_TAG);
+        $node->appendChild($text);
+        $element->appendChild($node);
+    }
+
+    private function addRandomH(\DOMElement $element, $maxLength = 10): void
+    {
+        $h = static::H_TAG . (string) self::numberBetween(1, 3);
+        $text = $element->ownerDocument->createTextNode($this->generator->sentence(self::numberBetween(1, $maxLength)));
+        $node = $element->ownerDocument->createElement($h);
+        $node->appendChild($text);
+        $element->appendChild($node);
+    }
+
+    private function addRandomB(\DOMElement $element, $maxLength = 10): void
+    {
+        $text = $element->ownerDocument->createTextNode($this->generator->sentence(self::numberBetween(1, $maxLength)));
+        $node = $element->ownerDocument->createElement(static::B_TAG);
+        $node->appendChild($text);
+        $element->appendChild($node);
+    }
+
+    private function addRandomI(\DOMElement $element, $maxLength = 10): void
+    {
+        $text = $element->ownerDocument->createTextNode($this->generator->sentence(self::numberBetween(1, $maxLength)));
+        $node = $element->ownerDocument->createElement(static::I_TAG);
+        $node->appendChild($text);
+        $element->appendChild($node);
+    }
+
+    private function addRandomSpan(\DOMElement $element, $maxLength = 10): void
+    {
+        $text = $element->ownerDocument->createTextNode($this->generator->sentence(self::numberBetween(1, $maxLength)));
+        $node = $element->ownerDocument->createElement(static::SPAN_TAG);
+        $node->appendChild($text);
+        $element->appendChild($node);
+    }
+
+    private function addLoginForm(\DOMElement $element): void
+    {
+        $textInput = $element->ownerDocument->createElement(static::INPUT_TAG);
+        $textInput->setAttribute('type', 'text');
+        $textInput->setAttribute('id', 'username');
+
+        $textLabel = $element->ownerDocument->createElement(static::LABEL_TAG);
+        $textLabel->setAttribute('for', 'username');
+        $textLabel->textContent = $this->generator->word();
+
+        $passwordInput = $element->ownerDocument->createElement(static::INPUT_TAG);
+        $passwordInput->setAttribute('type', 'password');
+        $passwordInput->setAttribute('id', 'password');
+
+        $passwordLabel = $element->ownerDocument->createElement(static::LABEL_TAG);
+        $passwordLabel->setAttribute('for', 'password');
+        $passwordLabel->textContent = $this->generator->word();
+
+        $submit = $element->ownerDocument->createElement(static::INPUT_TAG);
+        $submit->setAttribute('type', 'submit');
+        $submit->setAttribute('value', $this->generator->word());
+
+        $submit = $element->ownerDocument->createElement(static::FORM_TAG);
+        $submit->setAttribute('action', $this->generator->safeEmailDomain());
+        $submit->setAttribute('method', 'POST');
+        $submit->appendChild($textLabel);
+        $submit->appendChild($textInput);
+        $submit->appendChild($passwordLabel);
+        $submit->appendChild($passwordInput);
+        $element->appendChild($submit);
+    }
+
+    private function addRandomTable(\DOMElement $element, $maxRows = 10, $maxCols = 6, $maxTitle = 4, $maxLength = 10): void
+    {
+        $rows = self::numberBetween(1, $maxRows);
+        $cols = self::numberBetween(1, $maxCols);
+
+        $table = $element->ownerDocument->createElement(static::TABLE_TAG);
+        $thead = $element->ownerDocument->createElement(static::THEAD_TAG);
+        $tbody = $element->ownerDocument->createElement(static::TBODY_TAG);
+
+        $table->appendChild($thead);
+        $table->appendChild($tbody);
+
+        $tr = $element->ownerDocument->createElement(static::TR_TAG);
+        $thead->appendChild($tr);
+
+        for ($i = 0; $i < $cols; ++$i) {
+            $th = $element->ownerDocument->createElement(static::TH_TAG);
+            $th->textContent = $this->generator->sentence(self::numberBetween(1, $maxTitle));
+            $tr->appendChild($th);
+        }
+
+        for ($i = 0; $i < $rows; ++$i) {
+            $tr = $element->ownerDocument->createElement(static::TR_TAG);
+            $tbody->appendChild($tr);
+
+            for ($j = 0; $j < $cols; ++$j) {
+                $th = $element->ownerDocument->createElement(static::TD_TAG);
+                $th->textContent = $this->generator->sentence(self::numberBetween(1, $maxLength));
+                $tr->appendChild($th);
+            }
+        }
+        $element->appendChild($table);
+    }
+
+    private function addRandomUL(\DOMElement $element, $maxItems = 11, $maxLength = 4): void
+    {
+        $num = self::numberBetween(1, $maxItems);
+        $ul = $element->ownerDocument->createElement(static::UL_TAG);
+
+        for ($i = 0; $i < $num; ++$i) {
+            $li = $element->ownerDocument->createElement(static::LI_TAG);
+            $li->textContent = $this->generator->sentence(self::numberBetween(1, $maxLength));
+            $ul->appendChild($li);
+        }
+        $element->appendChild($ul);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Image.php

@@ -0,0 +1,196 @@
+<?php
+
+namespace Faker\Provider;
+
+/**
+ * Depends on image generation from http://lorempixel.com/
+ */
+class Image extends Base
+{
+    /**
+     * @var string
+     */
+    public const BASE_URL = 'https://via.placeholder.com';
+
+    public const FORMAT_JPG = 'jpg';
+    public const FORMAT_JPEG = 'jpeg';
+    public const FORMAT_PNG = 'png';
+
+    /**
+     * @var array
+     *
+     * @deprecated Categories are no longer used as a list in the placeholder API but referenced as string instead
+     */
+    protected static $categories = [
+        'abstract', 'animals', 'business', 'cats', 'city', 'food', 'nightlife',
+        'fashion', 'people', 'nature', 'sports', 'technics', 'transport',
+    ];
+
+    /**
+     * Generate the URL that will return a random image
+     *
+     * Set randomize to false to remove the random GET parameter at the end of the url.
+     *
+     * @example 'http://via.placeholder.com/640x480.png/CCCCCC?text=well+hi+there'
+     *
+     * @param int         $width
+     * @param int         $height
+     * @param string|null $category
+     * @param bool        $randomize
+     * @param string|null $word
+     * @param bool        $gray
+     * @param string      $format
+     *
+     * @return string
+     */
+    public static function imageUrl(
+        $width = 640,
+        $height = 480,
+        $category = null,
+        $randomize = true,
+        $word = null,
+        $gray = false,
+        $format = 'png'
+    ) {
+        trigger_deprecation(
+            'fakerphp/faker',
+            '1.20',
+            'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead',
+        );
+
+        // Validate image format
+        $imageFormats = static::getFormats();
+
+        if (!in_array(strtolower($format), $imageFormats, true)) {
+            throw new \InvalidArgumentException(sprintf(
+                'Invalid image format "%s". Allowable formats are: %s',
+                $format,
+                implode(', ', $imageFormats),
+            ));
+        }
+
+        $size = sprintf('%dx%d.%s', $width, $height, $format);
+
+        $imageParts = [];
+
+        if ($category !== null) {
+            $imageParts[] = $category;
+        }
+
+        if ($word !== null) {
+            $imageParts[] = $word;
+        }
+
+        if ($randomize === true) {
+            $imageParts[] = Lorem::word();
+        }
+
+        $backgroundColor = $gray === true ? 'CCCCCC' : str_replace('#', '', Color::safeHexColor());
+
+        return sprintf(
+            '%s/%s/%s%s',
+            self::BASE_URL,
+            $size,
+            $backgroundColor,
+            count($imageParts) > 0 ? '?text=' . urlencode(implode(' ', $imageParts)) : '',
+        );
+    }
+
+    /**
+     * Download a remote random image to disk and return its location
+     *
+     * Requires curl, or allow_url_fopen to be on in php.ini.
+     *
+     * @example '/path/to/dir/13b73edae8443990be1aa8f1a483bc27.png'
+     *
+     * @return bool|string
+     */
+    public static function image(
+        $dir = null,
+        $width = 640,
+        $height = 480,
+        $category = null,
+        $fullPath = true,
+        $randomize = true,
+        $word = null,
+        $gray = false,
+        $format = 'png'
+    ) {
+        trigger_deprecation(
+            'fakerphp/faker',
+            '1.20',
+            'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead',
+        );
+
+        $dir = null === $dir ? sys_get_temp_dir() : $dir; // GNU/Linux / OS X / Windows compatible
+
+        // Validate directory path
+        if (!is_dir($dir) || !is_writable($dir)) {
+            throw new \InvalidArgumentException(sprintf('Cannot write to directory "%s"', $dir));
+        }
+
+        // Generate a random filename. Use the server address so that a file
+        // generated at the same time on a different server won't have a collision.
+        $name = md5(uniqid(empty($_SERVER['SERVER_ADDR']) ? '' : $_SERVER['SERVER_ADDR'], true));
+        $filename = sprintf('%s.%s', $name, $format);
+        $filepath = $dir . DIRECTORY_SEPARATOR . $filename;
+
+        $url = static::imageUrl($width, $height, $category, $randomize, $word, $gray, $format);
+
+        // save file
+        if (function_exists('curl_exec')) {
+            // use cURL
+            $fp = fopen($filepath, 'w');
+            $ch = curl_init($url);
+            curl_setopt($ch, CURLOPT_FILE, $fp);
+            $success = curl_exec($ch) && curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200;
+            fclose($fp);
+            curl_close($ch);
+
+            if (!$success) {
+                unlink($filepath);
+
+                // could not contact the distant URL or HTTP error - fail silently.
+                return false;
+            }
+        } elseif (ini_get('allow_url_fopen')) {
+            // use remote fopen() via copy()
+            $success = copy($url, $filepath);
+
+            if (!$success) {
+                // could not contact the distant URL or HTTP error - fail silently.
+                return false;
+            }
+        } else {
+            return new \RuntimeException('The image formatter downloads an image from a remote HTTP server. Therefore, it requires that PHP can request remote hosts, either via cURL or fopen()');
+        }
+
+        return $fullPath ? $filepath : $filename;
+    }
+
+    public static function getFormats(): array
+    {
+        trigger_deprecation(
+            'fakerphp/faker',
+            '1.20',
+            'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead',
+        );
+
+        return array_keys(static::getFormatConstants());
+    }
+
+    public static function getFormatConstants(): array
+    {
+        trigger_deprecation(
+            'fakerphp/faker',
+            '1.20',
+            'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead',
+        );
+
+        return [
+            static::FORMAT_JPG => constant('IMAGETYPE_JPEG'),
+            static::FORMAT_JPEG => constant('IMAGETYPE_JPEG'),
+            static::FORMAT_PNG => constant('IMAGETYPE_PNG'),
+        ];
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Internet.php

@@ -0,0 +1,407 @@
+<?php
+
+namespace Faker\Provider;
+
+class Internet extends Base
+{
+    protected static $freeEmailDomain = ['gmail.com', 'yahoo.com', 'hotmail.com'];
+    protected static $tld = ['com', 'com', 'com', 'com', 'com', 'com', 'biz', 'info', 'net', 'org'];
+
+    protected static $userNameFormats = [
+        '{{lastName}}.{{firstName}}',
+        '{{firstName}}.{{lastName}}',
+        '{{firstName}}##',
+        '?{{lastName}}',
+    ];
+    protected static $emailFormats = [
+        '{{userName}}@{{domainName}}',
+        '{{userName}}@{{freeEmailDomain}}',
+    ];
+    protected static $urlFormats = [
+        'http://www.{{domainName}}/',
+        'http://{{domainName}}/',
+        'http://www.{{domainName}}/{{slug}}',
+        'http://www.{{domainName}}/{{slug}}',
+        'https://www.{{domainName}}/{{slug}}',
+        'http://www.{{domainName}}/{{slug}}.html',
+        'http://{{domainName}}/{{slug}}',
+        'http://{{domainName}}/{{slug}}',
+        'http://{{domainName}}/{{slug}}.html',
+        'https://{{domainName}}/{{slug}}.html',
+    ];
+
+    /**
+     * @see https://tools.ietf.org/html/rfc1918#section-3
+     */
+    protected static $localIpBlocks = [
+        ['10.0.0.0', '10.255.255.255'],
+        ['172.16.0.0', '172.31.255.255'],
+        ['192.168.0.0', '192.168.255.255'],
+    ];
+
+    /**
+     * @example 'jdoe@acme.biz'
+     *
+     * @return string
+     */
+    public function email()
+    {
+        $format = static::randomElement(static::$emailFormats);
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @example 'jdoe@example.com'
+     *
+     * @return string
+     */
+    final public function safeEmail()
+    {
+        return preg_replace('/\s/u', '', $this->userName() . '@' . static::safeEmailDomain());
+    }
+
+    /**
+     * @example 'jdoe@gmail.com'
+     *
+     * @return string
+     */
+    public function freeEmail()
+    {
+        return preg_replace('/\s/u', '', $this->userName() . '@' . static::freeEmailDomain());
+    }
+
+    /**
+     * @example 'jdoe@dawson.com'
+     *
+     * @return string
+     */
+    public function companyEmail()
+    {
+        return preg_replace('/\s/u', '', $this->userName() . '@' . $this->domainName());
+    }
+
+    /**
+     * @example 'gmail.com'
+     *
+     * @return string
+     */
+    public static function freeEmailDomain()
+    {
+        return static::randomElement(static::$freeEmailDomain);
+    }
+
+    /**
+     * @example 'example.org'
+     *
+     * @return string
+     */
+    final public static function safeEmailDomain()
+    {
+        $domains = [
+            'example.com',
+            'example.org',
+            'example.net',
+        ];
+
+        return static::randomElement($domains);
+    }
+
+    /**
+     * @example 'jdoe'
+     *
+     * @return string
+     */
+    public function userName()
+    {
+        $format = static::randomElement(static::$userNameFormats);
+        $username = static::bothify($this->generator->parse($format));
+
+        $username = strtolower(static::transliterate($username));
+
+        // check if transliterate() didn't support the language and removed all letters
+        if (trim($username, '._') === '') {
+            throw new \Exception('userName failed with the selected locale. Try a different locale or activate the "intl" PHP extension.');
+        }
+
+        // clean possible trailing dots from first/last names
+        $username = str_replace('..', '.', $username);
+        $username = rtrim($username, '.');
+
+        return $username;
+    }
+
+    /**
+     * @example 'fY4èHdZv68'
+     *
+     * @return string
+     */
+    public function password($minLength = 6, $maxLength = 20)
+    {
+        $pattern = str_repeat('*', $this->numberBetween($minLength, $maxLength));
+
+        return $this->asciify($pattern);
+    }
+
+    /**
+     * @example 'tiramisu.com'
+     *
+     * @return string
+     */
+    public function domainName()
+    {
+        return $this->domainWord() . '.' . $this->tld();
+    }
+
+    /**
+     * @example 'faber'
+     *
+     * @return string
+     */
+    public function domainWord()
+    {
+        $lastName = $this->generator->format('lastName');
+
+        $lastName = strtolower(static::transliterate($lastName));
+
+        // check if transliterate() didn't support the language and removed all letters
+        if (trim($lastName, '._') === '') {
+            throw new \Exception('domainWord failed with the selected locale. Try a different locale or activate the "intl" PHP extension.');
+        }
+
+        // clean possible trailing dot from last name
+        $lastName = rtrim($lastName, '.');
+
+        return $lastName;
+    }
+
+    /**
+     * @example 'com'
+     *
+     * @return string
+     */
+    public function tld()
+    {
+        return static::randomElement(static::$tld);
+    }
+
+    /**
+     * @example 'http://www.runolfsdottir.com/'
+     *
+     * @return string
+     */
+    public function url()
+    {
+        $format = static::randomElement(static::$urlFormats);
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @example 'aut-repellat-commodi-vel-itaque-nihil-id-saepe-nostrum'
+     *
+     * @return string
+     */
+    public function slug($nbWords = 6, $variableNbWords = true)
+    {
+        if ($nbWords <= 0) {
+            return '';
+        }
+
+        if ($variableNbWords) {
+            $nbWords = (int) ($nbWords * self::numberBetween(60, 140) / 100) + 1;
+        }
+        $words = $this->generator->words($nbWords);
+
+        return implode('-', $words);
+    }
+
+    /**
+     * @example '237.149.115.38'
+     *
+     * @return string
+     */
+    public function ipv4()
+    {
+        return long2ip(Miscellaneous::boolean() ? self::numberBetween(-2147483648, -2) : self::numberBetween(16777216, 2147483647));
+    }
+
+    /**
+     * @example '35cd:186d:3e23:2986:ef9f:5b41:42a4:e6f1'
+     *
+     * @return string
+     */
+    public function ipv6()
+    {
+        $res = [];
+
+        for ($i = 0; $i < 8; ++$i) {
+            $res[] = dechex(self::numberBetween(0, 65535));
+        }
+
+        return implode(':', $res);
+    }
+
+    /**
+     * @example '10.1.1.17'
+     *
+     * @return string
+     */
+    public static function localIpv4()
+    {
+        $ipBlock = self::randomElement(static::$localIpBlocks);
+
+        return long2ip(static::numberBetween(ip2long($ipBlock[0]), ip2long($ipBlock[1])));
+    }
+
+    /**
+     * @example '32:F1:39:2F:D6:18'
+     *
+     * @return string
+     */
+    public static function macAddress()
+    {
+        $mac = [];
+
+        for ($i = 0; $i < 6; ++$i) {
+            $mac[] = sprintf('%02X', self::numberBetween(0, 0xff));
+        }
+
+        return implode(':', $mac);
+    }
+
+    protected static function transliterate($string)
+    {
+        if (0 === preg_match('/[^A-Za-z0-9_.]/', $string)) {
+            return $string;
+        }
+
+        $transId = 'Any-Latin; Latin-ASCII; NFD; [:Nonspacing Mark:] Remove; NFC;';
+
+        if (class_exists(\Transliterator::class, false) && $transliterator = \Transliterator::create($transId)) {
+            $transString = $transliterator->transliterate($string);
+        } else {
+            $transString = static::toAscii($string);
+        }
+
+        return preg_replace('/[^A-Za-z0-9_.]/u', '', $transString);
+    }
+
+    protected static function toAscii($string)
+    {
+        static $arrayFrom, $arrayTo;
+
+        if (empty($arrayFrom)) {
+            $transliterationTable = [
+                'IJ' => 'I', 'Ö' => 'O', 'Œ' => 'O', 'Ü' => 'U', 'ä' => 'a', 'æ' => 'a',
+                'ij' => 'i', 'ö' => 'o', 'œ' => 'o', 'ü' => 'u', 'ß' => 's', 'ſ' => 's',
+                'À' => 'A', 'Á' => 'A', 'Â' => 'A', 'Ã' => 'A', 'Ä' => 'A', 'Å' => 'A',
+                'Æ' => 'A', 'Ā' => 'A', 'Ą' => 'A', 'Ă' => 'A', 'Ç' => 'C', 'Ć' => 'C',
+                'Č' => 'C', 'Ĉ' => 'C', 'Ċ' => 'C', 'Ď' => 'D', 'Đ' => 'D', 'È' => 'E',
+                'É' => 'E', 'Ê' => 'E', 'Ë' => 'E', 'Ē' => 'E', 'Ę' => 'E', 'Ě' => 'E',
+                'Ĕ' => 'E', 'Ė' => 'E', 'Ĝ' => 'G', 'Ğ' => 'G', 'Ġ' => 'G', 'Ģ' => 'G',
+                'Ĥ' => 'H', 'Ħ' => 'H', 'Ì' => 'I', 'Í' => 'I', 'Î' => 'I', 'Ï' => 'I',
+                'Ī' => 'I', 'Ĩ' => 'I', 'Ĭ' => 'I', 'Į' => 'I', 'İ' => 'I', 'Ĵ' => 'J',
+                'Ķ' => 'K', 'Ľ' => 'K', 'Ĺ' => 'K', 'Ļ' => 'K', 'Ŀ' => 'K', 'Ł' => 'L',
+                'Ñ' => 'N', 'Ń' => 'N', 'Ň' => 'N', 'Ņ' => 'N', 'Ŋ' => 'N', 'Ò' => 'O',
+                'Ó' => 'O', 'Ô' => 'O', 'Õ' => 'O', 'Ø' => 'O', 'Ō' => 'O', 'Ő' => 'O',
+                'Ŏ' => 'O', 'Ŕ' => 'R', 'Ř' => 'R', 'Ŗ' => 'R', 'Ś' => 'S', 'Ş' => 'S',
+                'Ŝ' => 'S', 'Ș' => 'S', 'Š' => 'S', 'Ť' => 'T', 'Ţ' => 'T', 'Ŧ' => 'T',
+                'Ț' => 'T', 'Ù' => 'U', 'Ú' => 'U', 'Û' => 'U', 'Ū' => 'U', 'Ů' => 'U',
+                'Ű' => 'U', 'Ŭ' => 'U', 'Ũ' => 'U', 'Ų' => 'U', 'Ŵ' => 'W', 'Ŷ' => 'Y',
+                'Ÿ' => 'Y', 'Ý' => 'Y', 'Ź' => 'Z', 'Ż' => 'Z', 'Ž' => 'Z', 'à' => 'a',
+                'á' => 'a', 'â' => 'a', 'ã' => 'a', 'ā' => 'a', 'ą' => 'a', 'ă' => 'a',
+                'å' => 'a', 'ç' => 'c', 'ć' => 'c', 'č' => 'c', 'ĉ' => 'c', 'ċ' => 'c',
+                'ď' => 'd', 'đ' => 'd', 'è' => 'e', 'é' => 'e', 'ê' => 'e', 'ë' => 'e',
+                'ē' => 'e', 'ę' => 'e', 'ě' => 'e', 'ĕ' => 'e', 'ė' => 'e', 'ƒ' => 'f',
+                'ĝ' => 'g', 'ğ' => 'g', 'ġ' => 'g', 'ģ' => 'g', 'ĥ' => 'h', 'ħ' => 'h',
+                'ì' => 'i', 'í' => 'i', 'î' => 'i', 'ï' => 'i', 'ī' => 'i', 'ĩ' => 'i',
+                'ĭ' => 'i', 'į' => 'i', 'ı' => 'i', 'ĵ' => 'j', 'ķ' => 'k', 'ĸ' => 'k',
+                'ł' => 'l', 'ľ' => 'l', 'ĺ' => 'l', 'ļ' => 'l', 'ŀ' => 'l', 'ñ' => 'n',
+                'ń' => 'n', 'ň' => 'n', 'ņ' => 'n', 'ʼn' => 'n', 'ŋ' => 'n', 'ò' => 'o',
+                'ó' => 'o', 'ô' => 'o', 'õ' => 'o', 'ø' => 'o', 'ō' => 'o', 'ő' => 'o',
+                'ŏ' => 'o', 'ŕ' => 'r', 'ř' => 'r', 'ŗ' => 'r', 'ś' => 's', 'š' => 's',
+                'ť' => 't', 'ù' => 'u', 'ú' => 'u', 'û' => 'u', 'ū' => 'u', 'ů' => 'u',
+                'ű' => 'u', 'ŭ' => 'u', 'ũ' => 'u', 'ų' => 'u', 'ŵ' => 'w', 'ÿ' => 'y',
+                'ý' => 'y', 'ŷ' => 'y', 'ż' => 'z', 'ź' => 'z', 'ž' => 'z', 'Α' => 'A',
+                'Ά' => 'A', 'Ἀ' => 'A', 'Ἁ' => 'A', 'Ἂ' => 'A', 'Ἃ' => 'A', 'Ἄ' => 'A',
+                'Ἅ' => 'A', 'Ἆ' => 'A', 'Ἇ' => 'A', 'ᾈ' => 'A', 'ᾉ' => 'A', 'ᾊ' => 'A',
+                'ᾋ' => 'A', 'ᾌ' => 'A', 'ᾍ' => 'A', 'ᾎ' => 'A', 'ᾏ' => 'A', 'Ᾰ' => 'A',
+                'Ᾱ' => 'A', 'Ὰ' => 'A', 'ᾼ' => 'A', 'Β' => 'B', 'Γ' => 'G', 'Δ' => 'D',
+                'Ε' => 'E', 'Έ' => 'E', 'Ἐ' => 'E', 'Ἑ' => 'E', 'Ἒ' => 'E', 'Ἓ' => 'E',
+                'Ἔ' => 'E', 'Ἕ' => 'E', 'Ὲ' => 'E', 'Ζ' => 'Z', 'Η' => 'I', 'Ή' => 'I',
+                'Ἠ' => 'I', 'Ἡ' => 'I', 'Ἢ' => 'I', 'Ἣ' => 'I', 'Ἤ' => 'I', 'Ἥ' => 'I',
+                'Ἦ' => 'I', 'Ἧ' => 'I', 'ᾘ' => 'I', 'ᾙ' => 'I', 'ᾚ' => 'I', 'ᾛ' => 'I',
+                'ᾜ' => 'I', 'ᾝ' => 'I', 'ᾞ' => 'I', 'ᾟ' => 'I', 'Ὴ' => 'I', 'ῌ' => 'I',
+                'Θ' => 'T', 'Ι' => 'I', 'Ί' => 'I', 'Ϊ' => 'I', 'Ἰ' => 'I', 'Ἱ' => 'I',
+                'Ἲ' => 'I', 'Ἳ' => 'I', 'Ἴ' => 'I', 'Ἵ' => 'I', 'Ἶ' => 'I', 'Ἷ' => 'I',
+                'Ῐ' => 'I', 'Ῑ' => 'I', 'Ὶ' => 'I', 'Κ' => 'K', 'Λ' => 'L', 'Μ' => 'M',
+                'Ν' => 'N', 'Ξ' => 'K', 'Ο' => 'O', 'Ό' => 'O', 'Ὀ' => 'O', 'Ὁ' => 'O',
+                'Ὂ' => 'O', 'Ὃ' => 'O', 'Ὄ' => 'O', 'Ὅ' => 'O', 'Ὸ' => 'O', 'Π' => 'P',
+                'Ρ' => 'R', 'Ῥ' => 'R', 'Σ' => 'S', 'Τ' => 'T', 'Υ' => 'Y', 'Ύ' => 'Y',
+                'Ϋ' => 'Y', 'Ὑ' => 'Y', 'Ὓ' => 'Y', 'Ὕ' => 'Y', 'Ὗ' => 'Y', 'Ῠ' => 'Y',
+                'Ῡ' => 'Y', 'Ὺ' => 'Y', 'Φ' => 'F', 'Χ' => 'X', 'Ψ' => 'P', 'Ω' => 'O',
+                'Ώ' => 'O', 'Ὠ' => 'O', 'Ὡ' => 'O', 'Ὢ' => 'O', 'Ὣ' => 'O', 'Ὤ' => 'O',
+                'Ὥ' => 'O', 'Ὦ' => 'O', 'Ὧ' => 'O', 'ᾨ' => 'O', 'ᾩ' => 'O', 'ᾪ' => 'O',
+                'ᾫ' => 'O', 'ᾬ' => 'O', 'ᾭ' => 'O', 'ᾮ' => 'O', 'ᾯ' => 'O', 'Ὼ' => 'O',
+                'ῼ' => 'O', 'α' => 'a', 'ά' => 'a', 'ἀ' => 'a', 'ἁ' => 'a', 'ἂ' => 'a',
+                'ἃ' => 'a', 'ἄ' => 'a', 'ἅ' => 'a', 'ἆ' => 'a', 'ἇ' => 'a', 'ᾀ' => 'a',
+                'ᾁ' => 'a', 'ᾂ' => 'a', 'ᾃ' => 'a', 'ᾄ' => 'a', 'ᾅ' => 'a', 'ᾆ' => 'a',
+                'ᾇ' => 'a', 'ὰ' => 'a', 'ᾰ' => 'a', 'ᾱ' => 'a', 'ᾲ' => 'a', 'ᾳ' => 'a',
+                'ᾴ' => 'a', 'ᾶ' => 'a', 'ᾷ' => 'a', 'β' => 'b', 'γ' => 'g', 'δ' => 'd',
+                'ε' => 'e', 'έ' => 'e', 'ἐ' => 'e', 'ἑ' => 'e', 'ἒ' => 'e', 'ἓ' => 'e',
+                'ἔ' => 'e', 'ἕ' => 'e', 'ὲ' => 'e', 'ζ' => 'z', 'η' => 'i', 'ή' => 'i',
+                'ἠ' => 'i', 'ἡ' => 'i', 'ἢ' => 'i', 'ἣ' => 'i', 'ἤ' => 'i', 'ἥ' => 'i',
+                'ἦ' => 'i', 'ἧ' => 'i', 'ᾐ' => 'i', 'ᾑ' => 'i', 'ᾒ' => 'i', 'ᾓ' => 'i',
+                'ᾔ' => 'i', 'ᾕ' => 'i', 'ᾖ' => 'i', 'ᾗ' => 'i', 'ὴ' => 'i', 'ῂ' => 'i',
+                'ῃ' => 'i', 'ῄ' => 'i', 'ῆ' => 'i', 'ῇ' => 'i', 'θ' => 't', 'ι' => 'i',
+                'ί' => 'i', 'ϊ' => 'i', 'ΐ' => 'i', 'ἰ' => 'i', 'ἱ' => 'i', 'ἲ' => 'i',
+                'ἳ' => 'i', 'ἴ' => 'i', 'ἵ' => 'i', 'ἶ' => 'i', 'ἷ' => 'i', 'ὶ' => 'i',
+                'ῐ' => 'i', 'ῑ' => 'i', 'ῒ' => 'i', 'ῖ' => 'i', 'ῗ' => 'i', 'κ' => 'k',
+                'λ' => 'l', 'μ' => 'm', 'ν' => 'n', 'ξ' => 'k', 'ο' => 'o', 'ό' => 'o',
+                'ὀ' => 'o', 'ὁ' => 'o', 'ὂ' => 'o', 'ὃ' => 'o', 'ὄ' => 'o', 'ὅ' => 'o',
+                'ὸ' => 'o', 'π' => 'p', 'ρ' => 'r', 'ῤ' => 'r', 'ῥ' => 'r', 'σ' => 's',
+                'ς' => 's', 'τ' => 't', 'υ' => 'y', 'ύ' => 'y', 'ϋ' => 'y', 'ΰ' => 'y',
+                'ὐ' => 'y', 'ὑ' => 'y', 'ὒ' => 'y', 'ὓ' => 'y', 'ὔ' => 'y', 'ὕ' => 'y',
+                'ὖ' => 'y', 'ὗ' => 'y', 'ὺ' => 'y', 'ῠ' => 'y', 'ῡ' => 'y', 'ῢ' => 'y',
+                'ῦ' => 'y', 'ῧ' => 'y', 'φ' => 'f', 'χ' => 'x', 'ψ' => 'p', 'ω' => 'o',
+                'ώ' => 'o', 'ὠ' => 'o', 'ὡ' => 'o', 'ὢ' => 'o', 'ὣ' => 'o', 'ὤ' => 'o',
+                'ὥ' => 'o', 'ὦ' => 'o', 'ὧ' => 'o', 'ᾠ' => 'o', 'ᾡ' => 'o', 'ᾢ' => 'o',
+                'ᾣ' => 'o', 'ᾤ' => 'o', 'ᾥ' => 'o', 'ᾦ' => 'o', 'ᾧ' => 'o', 'ὼ' => 'o',
+                'ῲ' => 'o', 'ῳ' => 'o', 'ῴ' => 'o', 'ῶ' => 'o', 'ῷ' => 'o', 'А' => 'A',
+                'Б' => 'B', 'В' => 'V', 'Г' => 'G', 'Д' => 'D', 'Е' => 'E', 'Ё' => 'E',
+                'Ж' => 'Z', 'З' => 'Z', 'И' => 'I', 'Й' => 'I', 'К' => 'K', 'Л' => 'L',
+                'М' => 'M', 'Н' => 'N', 'О' => 'O', 'П' => 'P', 'Р' => 'R', 'С' => 'S',
+                'Т' => 'T', 'У' => 'U', 'Ф' => 'F', 'Х' => 'K', 'Ц' => 'T', 'Ч' => 'C',
+                'Ш' => 'S', 'Щ' => 'S', 'Ы' => 'Y', 'Э' => 'E', 'Ю' => 'Y', 'Я' => 'Y',
+                'а' => 'A', 'б' => 'B', 'в' => 'V', 'г' => 'G', 'д' => 'D', 'е' => 'E',
+                'ё' => 'E', 'ж' => 'Z', 'з' => 'Z', 'и' => 'I', 'й' => 'I', 'к' => 'K',
+                'л' => 'L', 'м' => 'M', 'н' => 'N', 'о' => 'O', 'п' => 'P', 'р' => 'R',
+                'с' => 'S', 'т' => 'T', 'у' => 'U', 'ф' => 'F', 'х' => 'K', 'ц' => 'T',
+                'ч' => 'C', 'ш' => 'S', 'щ' => 'S', 'ы' => 'Y', 'э' => 'E', 'ю' => 'Y',
+                'я' => 'Y', 'ð' => 'd', 'Ð' => 'D', 'þ' => 't', 'Þ' => 'T', 'ა' => 'a',
+                'ბ' => 'b', 'გ' => 'g', 'დ' => 'd', 'ე' => 'e', 'ვ' => 'v', 'ზ' => 'z',
+                'თ' => 't', 'ი' => 'i', 'კ' => 'k', 'ლ' => 'l', 'მ' => 'm', 'ნ' => 'n',
+                'ო' => 'o', 'პ' => 'p', 'ჟ' => 'z', 'რ' => 'r', 'ს' => 's', 'ტ' => 't',
+                'უ' => 'u', 'ფ' => 'p', 'ქ' => 'k', 'ღ' => 'g', 'ყ' => 'q', 'შ' => 's',
+                'ჩ' => 'c', 'ც' => 't', 'ძ' => 'd', 'წ' => 't', 'ჭ' => 'c', 'ხ' => 'k',
+                'ჯ' => 'j', 'ჰ' => 'h', 'ţ' => 't', 'ʼ' => "'", '̧' => '', 'ḩ' => 'h',
+                '‘' => "'", '’' => "'", 'ừ' => 'u', '/' => '', 'ế' => 'e', 'ả' => 'a',
+                'ị' => 'i', 'ậ' => 'a', 'ệ' => 'e', 'ỉ' => 'i', 'ồ' => 'o', 'ề' => 'e',
+                'ơ' => 'o', 'ạ' => 'a', 'ẵ' => 'a', 'ư' => 'u', 'ằ' => 'a', 'ầ' => 'a',
+                'ḑ' => 'd', 'Ḩ' => 'H', 'Ḑ' => 'D', 'ș' => 's', 'ț' => 't', 'ộ' => 'o',
+                'ắ' => 'a', 'ş' => 's', "'" => '', 'ու' => 'u', 'ա' => 'a', 'բ' => 'b',
+                'գ' => 'g', 'դ' => 'd', 'ե' => 'e', 'զ' => 'z', 'է' => 'e', 'ը' => 'y',
+                'թ' => 't', 'ժ' => 'zh', 'ի' => 'i', 'լ' => 'l', 'խ' => 'kh', 'ծ' => 'ts',
+                'կ' => 'k', 'հ' => 'h', 'ձ' => 'dz', 'ղ' => 'gh', 'ճ' => 'ch', 'մ' => 'm',
+                'յ' => 'y', 'ն' => 'n', 'շ' => 'sh', 'ո' => 'o', 'չ' => 'ch', 'պ' => 'p',
+                'ջ' => 'j', 'ռ' => 'r', 'ս' => 's', 'վ' => 'v', 'տ' => 't', 'ր' => 'r',
+                'ց' => 'ts', 'փ' => 'p', 'ք' => 'q', 'և' => 'ev', 'օ' => 'o', 'ֆ' => 'f',
+            ];
+            $arrayFrom = array_keys($transliterationTable);
+            $arrayTo = array_values($transliterationTable);
+        }
+
+        return str_replace($arrayFrom, $arrayTo, $string);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Lorem.php

@@ -0,0 +1,228 @@
+<?php
+
+namespace Faker\Provider;
+
+class Lorem extends Base
+{
+    protected static $wordList = [
+        'alias', 'consequatur', 'aut', 'perferendis', 'sit', 'voluptatem',
+        'accusantium', 'doloremque', 'aperiam', 'eaque', 'ipsa', 'quae', 'ab',
+        'illo', 'inventore', 'veritatis', 'et', 'quasi', 'architecto',
+        'beatae', 'vitae', 'dicta', 'sunt', 'explicabo', 'aspernatur', 'aut',
+        'odit', 'aut', 'fugit', 'sed', 'quia', 'consequuntur', 'magni',
+        'dolores', 'eos', 'qui', 'ratione', 'voluptatem', 'sequi', 'nesciunt',
+        'neque', 'dolorem', 'ipsum', 'quia', 'dolor', 'sit', 'amet',
+        'consectetur', 'adipisci', 'velit', 'sed', 'quia', 'non', 'numquam',
+        'eius', 'modi', 'tempora', 'incidunt', 'ut', 'labore', 'et', 'dolore',
+        'magnam', 'aliquam', 'quaerat', 'voluptatem', 'ut', 'enim', 'ad',
+        'minima', 'veniam', 'quis', 'nostrum', 'exercitationem', 'ullam',
+        'corporis', 'nemo', 'enim', 'ipsam', 'voluptatem', 'quia', 'voluptas',
+        'sit', 'suscipit', 'laboriosam', 'nisi', 'ut', 'aliquid', 'ex', 'ea',
+        'commodi', 'consequatur', 'quis', 'autem', 'vel', 'eum', 'iure',
+        'reprehenderit', 'qui', 'in', 'ea', 'voluptate', 'velit', 'esse',
+        'quam', 'nihil', 'molestiae', 'et', 'iusto', 'odio', 'dignissimos',
+        'ducimus', 'qui', 'blanditiis', 'praesentium', 'laudantium', 'totam',
+        'rem', 'voluptatum', 'deleniti', 'atque', 'corrupti', 'quos',
+        'dolores', 'et', 'quas', 'molestias', 'excepturi', 'sint',
+        'occaecati', 'cupiditate', 'non', 'provident', 'sed', 'ut',
+        'perspiciatis', 'unde', 'omnis', 'iste', 'natus', 'error',
+        'similique', 'sunt', 'in', 'culpa', 'qui', 'officia', 'deserunt',
+        'mollitia', 'animi', 'id', 'est', 'laborum', 'et', 'dolorum', 'fuga',
+        'et', 'harum', 'quidem', 'rerum', 'facilis', 'est', 'et', 'expedita',
+        'distinctio', 'nam', 'libero', 'tempore', 'cum', 'soluta', 'nobis',
+        'est', 'eligendi', 'optio', 'cumque', 'nihil', 'impedit', 'quo',
+        'porro', 'quisquam', 'est', 'qui', 'minus', 'id', 'quod', 'maxime',
+        'placeat', 'facere', 'possimus', 'omnis', 'voluptas', 'assumenda',
+        'est', 'omnis', 'dolor', 'repellendus', 'temporibus', 'autem',
+        'quibusdam', 'et', 'aut', 'consequatur', 'vel', 'illum', 'qui',
+        'dolorem', 'eum', 'fugiat', 'quo', 'voluptas', 'nulla', 'pariatur',
+        'at', 'vero', 'eos', 'et', 'accusamus', 'officiis', 'debitis', 'aut',
+        'rerum', 'necessitatibus', 'saepe', 'eveniet', 'ut', 'et',
+        'voluptates', 'repudiandae', 'sint', 'et', 'molestiae', 'non',
+        'recusandae', 'itaque', 'earum', 'rerum', 'hic', 'tenetur', 'a',
+        'sapiente', 'delectus', 'ut', 'aut', 'reiciendis', 'voluptatibus',
+        'maiores', 'doloribus', 'asperiores', 'repellat',
+    ];
+
+    /**
+     * @example 'Lorem'
+     *
+     * @return string
+     */
+    public static function word()
+    {
+        return static::randomElement(static::$wordList);
+    }
+
+    /**
+     * Generate an array of random words
+     *
+     * @example array('Lorem', 'ipsum', 'dolor')
+     *
+     * @param int  $nb     how many words to return
+     * @param bool $asText if true the sentences are returned as one string
+     *
+     * @return array|string
+     */
+    public static function words($nb = 3, $asText = false)
+    {
+        $words = [];
+
+        for ($i = 0; $i < $nb; ++$i) {
+            $words[] = static::word();
+        }
+
+        return $asText ? implode(' ', $words) : $words;
+    }
+
+    /**
+     * Generate a random sentence
+     *
+     * @example 'Lorem ipsum dolor sit amet.'
+     *
+     * @param int  $nbWords         around how many words the sentence should contain
+     * @param bool $variableNbWords set to false if you want exactly $nbWords returned,
+     *                              otherwise $nbWords may vary by +/-40% with a minimum of 1
+     *
+     * @return string
+     */
+    public static function sentence($nbWords = 6, $variableNbWords = true)
+    {
+        if ($nbWords <= 0) {
+            return '';
+        }
+
+        if ($variableNbWords) {
+            $nbWords = self::randomizeNbElements($nbWords);
+        }
+
+        $words = static::words($nbWords);
+        $words[0] = ucwords($words[0]);
+
+        return implode(' ', $words) . '.';
+    }
+
+    /**
+     * Generate an array of sentences
+     *
+     * @example array('Lorem ipsum dolor sit amet.', 'Consectetur adipisicing eli.')
+     *
+     * @param int  $nb     how many sentences to return
+     * @param bool $asText if true the sentences are returned as one string
+     *
+     * @return array|string
+     */
+    public static function sentences($nb = 3, $asText = false)
+    {
+        $sentences = [];
+
+        for ($i = 0; $i < $nb; ++$i) {
+            $sentences[] = static::sentence();
+        }
+
+        return $asText ? implode(' ', $sentences) : $sentences;
+    }
+
+    /**
+     * Generate a single paragraph
+     *
+     * @example 'Sapiente sunt omnis. Ut pariatur ad autem ducimus et. Voluptas rem voluptas sint modi dolorem amet.'
+     *
+     * @param int  $nbSentences         around how many sentences the paragraph should contain
+     * @param bool $variableNbSentences set to false if you want exactly $nbSentences returned,
+     *                                  otherwise $nbSentences may vary by +/-40% with a minimum of 1
+     *
+     * @return string
+     */
+    public static function paragraph($nbSentences = 3, $variableNbSentences = true)
+    {
+        if ($nbSentences <= 0) {
+            return '';
+        }
+
+        if ($variableNbSentences) {
+            $nbSentences = self::randomizeNbElements($nbSentences);
+        }
+
+        return implode(' ', static::sentences($nbSentences));
+    }
+
+    /**
+     * Generate an array of paragraphs
+     *
+     * @example array($paragraph1, $paragraph2, $paragraph3)
+     *
+     * @param int  $nb     how many paragraphs to return
+     * @param bool $asText if true the paragraphs are returned as one string, separated by two newlines
+     *
+     * @return array|string
+     */
+    public static function paragraphs($nb = 3, $asText = false)
+    {
+        $paragraphs = [];
+
+        for ($i = 0; $i < $nb; ++$i) {
+            $paragraphs[] = static::paragraph();
+        }
+
+        return $asText ? implode("\n\n", $paragraphs) : $paragraphs;
+    }
+
+    /**
+     * Generate a text string.
+     * Depending on the $maxNbChars, returns a string made of words, sentences, or paragraphs.
+     *
+     * @example 'Sapiente sunt omnis. Ut pariatur ad autem ducimus et. Voluptas rem voluptas sint modi dolorem amet.'
+     *
+     * @param int $maxNbChars Maximum number of characters the text should contain (minimum 5)
+     *
+     * @return string
+     */
+    public static function text($maxNbChars = 200)
+    {
+        if ($maxNbChars < 5) {
+            throw new \InvalidArgumentException('text() can only generate text of at least 5 characters');
+        }
+
+        $type = 'paragraph';
+
+        if ($maxNbChars < 100) {
+            $type = 'sentence';
+        }
+
+        if ($maxNbChars < 25) {
+            $type = 'word';
+        }
+
+        $text = [];
+
+        while (empty($text)) {
+            $size = 0;
+
+            // until $maxNbChars is reached
+            while ($size < $maxNbChars) {
+                $word = ($size ? ' ' : '') . static::$type();
+                $text[] = $word;
+
+                $size += strlen($word);
+            }
+
+            array_pop($text);
+        }
+
+        if ($type === 'word') {
+            // capitalize first letter
+            $text[0] = ucwords($text[0]);
+
+            // end sentence with full stop
+            $text[count($text) - 1] .= '.';
+        }
+
+        return implode('', $text);
+    }
+
+    protected static function randomizeNbElements($nbElements)
+    {
+        return (int) ($nbElements * self::numberBetween(60, 140) / 100) + 1;
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Medical.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Faker\Provider;
+
+class Medical extends Base
+{
+    protected static $bloodTypes = ['A', 'AB', 'B', 'O'];
+
+    protected static $bloodRhFactors = ['+', '-'];
+
+    /**
+     * @example 'AB'
+     */
+    public static function bloodType(): string
+    {
+        return static::randomElement(static::$bloodTypes);
+    }
+
+    /**
+     * @example '+'
+     */
+    public static function bloodRh(): string
+    {
+        return static::randomElement(static::$bloodRhFactors);
+    }
+
+    /**
+     * @example 'AB+'
+     */
+    public function bloodGroup(): string
+    {
+        return $this->generator->parse('{{bloodType}}{{bloodRh}}');
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Miscellaneous.php

@@ -0,0 +1,342 @@
+<?php
+
+namespace Faker\Provider;
+
+class Miscellaneous extends Base
+{
+    /**
+     * @see https://en.wikipedia.org/wiki/Emoji#Unicode_blocks
+     * On date of 2017-03-26
+     *
+     * U+1F600 - U+1F637 in Unicode Codepoint Escape Syntax
+     */
+    protected static $emoji = [
+        "\u{1F600}", "\u{1F601}", "\u{1F602}", "\u{1F603}",
+        "\u{1F604}", "\u{1F605}", "\u{1F606}", "\u{1F607}",
+        "\u{1F608}", "\u{1F609}", "\u{1F60A}", "\u{1F60B}",
+        "\u{1F60C}", "\u{1F60D}", "\u{1F60E}", "\u{1F60F}",
+        "\u{1F610}", "\u{1F611}", "\u{1F612}", "\u{1F613}",
+        "\u{1F614}", "\u{1F615}", "\u{1F616}", "\u{1F617}",
+        "\u{1F618}", "\u{1F619}", "\u{1F61A}", "\u{1F61B}",
+        "\u{1F61C}", "\u{1F61D}", "\u{1F61E}", "\u{1F61F}",
+        "\u{1F620}", "\u{1F621}", "\u{1F622}", "\u{1F623}",
+        "\u{1F624}", "\u{1F625}", "\u{1F626}", "\u{1F627}",
+        "\u{1F628}", "\u{1F629}", "\u{1F62A}", "\u{1F62B}",
+        "\u{1F62C}", "\u{1F62D}", "\u{1F62E}", "\u{1F62F}",
+        "\u{1F630}", "\u{1F631}", "\u{1F632}", "\u{1F633}",
+        "\u{1F634}", "\u{1F635}", "\u{1F636}", "\u{1F637}",
+    ];
+
+    /**
+     * @see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+     * On date of 2016-04-22
+     */
+    protected static $languageCode = [
+        'aa', 'ab', 'ae', 'af', 'ak', 'am', 'an', 'ar', 'as', 'av',
+        'ay', 'az', 'ba', 'be', 'bg', 'bh', 'bi', 'bm', 'bn', 'bo',
+        'br', 'bs', 'ca', 'ce', 'ch', 'co', 'cr', 'cs', 'cu', 'cv',
+        'cy', 'da', 'de', 'dv', 'dz', 'ee', 'el', 'en', 'eo', 'es',
+        'et', 'eu', 'fa', 'ff', 'fi', 'fj', 'fo', 'fr', 'fy', 'ga',
+        'gd', 'gl', 'gn', 'gu', 'gv', 'ha', 'he', 'hi', 'ho', 'hr',
+        'ht', 'hu', 'hy', 'hz', 'ia', 'id', 'ie', 'ig', 'ii', 'ik',
+        'io', 'is', 'it', 'iu', 'ja', 'jv', 'ka', 'kg', 'ki', 'kj',
+        'kk', 'kl', 'km', 'kn', 'ko', 'kr', 'ks', 'ku', 'kv', 'kw',
+        'ky', 'la', 'lb', 'lg', 'li', 'ln', 'lo', 'lt', 'lu', 'lv',
+        'mg', 'mh', 'mi', 'mk', 'ml', 'mn', 'mr', 'ms', 'mt', 'my',
+        'na', 'nb', 'nd', 'ne', 'ng', 'nl', 'nn', 'no', 'nr', 'nv',
+        'ny', 'oc', 'oj', 'om', 'or', 'os', 'pa', 'pi', 'pl', 'ps',
+        'pt', 'qu', 'rm', 'rn', 'ro', 'ru', 'rw', 'sa', 'sc', 'sd',
+        'se', 'sg', 'si', 'sk', 'sl', 'sm', 'sn', 'so', 'sq', 'sr',
+        'ss', 'st', 'su', 'sv', 'sw', 'ta', 'te', 'tg', 'th', 'ti',
+        'tk', 'tl', 'tn', 'to', 'tr', 'ts', 'tt', 'tw', 'ty', 'ug',
+        'uk', 'ur', 'uz', 've', 'vi', 'vo', 'wa', 'wo', 'xh', 'yi',
+        'yo', 'za', 'zh', 'zu',
+    ];
+
+    /**
+     * @see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+     * On date of 2014-10-19
+     */
+    protected static $countryCode = [
+        'AD', 'AE', 'AF', 'AG', 'AI', 'AL', 'AM', 'AO', 'AQ', 'AR',
+        'AS', 'AT', 'AU', 'AW', 'AX', 'AZ', 'BA', 'BB', 'BD', 'BE',
+        'BF', 'BG', 'BH', 'BI', 'BJ', 'BL', 'BM', 'BN', 'BO', 'BQ',
+        'BR', 'BS', 'BT', 'BW', 'BY', 'BZ', 'CA', 'CC', 'CD', 'CF',
+        'CG', 'CH', 'CI', 'CK', 'CL', 'CM', 'CN', 'CO', 'CR', 'CU',
+        'CV', 'CW', 'CX', 'CY', 'CZ', 'DE', 'DJ', 'DK', 'DM', 'DO',
+        'DZ', 'EC', 'EE', 'EG', 'EH', 'ER', 'ES', 'ET', 'FI', 'FJ',
+        'FK', 'FM', 'FO', 'FR', 'GA', 'GB', 'GD', 'GE', 'GF', 'GG',
+        'GH', 'GI', 'GL', 'GM', 'GN', 'GP', 'GQ', 'GR', 'GS', 'GT',
+        'GU', 'GW', 'GY', 'HK', 'HN', 'HR', 'HT', 'HU', 'ID', 'IE',
+        'IL', 'IM', 'IN', 'IO', 'IQ', 'IR', 'IS', 'IT', 'JE', 'JM',
+        'JO', 'JP', 'KE', 'KG', 'KH', 'KI', 'KM', 'KN', 'KP', 'KR',
+        'KW', 'KY', 'KZ', 'LA', 'LB', 'LC', 'LI', 'LK', 'LR', 'LS',
+        'LT', 'LU', 'LV', 'LY', 'MA', 'MC', 'MD', 'ME', 'MF', 'MG',
+        'MH', 'MK', 'ML', 'MM', 'MN', 'MO', 'MP', 'MQ', 'MR', 'MS',
+        'MT', 'MU', 'MV', 'MW', 'MX', 'MY', 'MZ', 'NA', 'NC', 'NE',
+        'NF', 'NG', 'NI', 'NL', 'NO', 'NP', 'NR', 'NU', 'NZ', 'OM',
+        'PA', 'PE', 'PF', 'PG', 'PH', 'PK', 'PL', 'PM', 'PN', 'PR',
+        'PS', 'PT', 'PW', 'PY', 'QA', 'RE', 'RO', 'RS', 'RU', 'RW',
+        'SA', 'SB', 'SC', 'SD', 'SE', 'SG', 'SH', 'SI', 'SJ', 'SK',
+        'SL', 'SM', 'SN', 'SO', 'SR', 'SS', 'ST', 'SV', 'SX', 'SY',
+        'SZ', 'TC', 'TD', 'TF', 'TG', 'TH', 'TJ', 'TK', 'TL', 'TM',
+        'TN', 'TO', 'TR', 'TT', 'TV', 'TW', 'TZ', 'UA', 'UG', 'UM',
+        'US', 'UY', 'UZ', 'VA', 'VC', 'VE', 'VG', 'VI', 'VN', 'VU',
+        'WF', 'WS', 'YE', 'YT', 'ZA', 'ZM', 'ZW',
+    ];
+
+    /**
+     * @see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
+     * On date of 2014-10-19
+     */
+    protected static $countryISOAlpha3 = [
+        'ABW', 'AFG', 'AGO', 'AIA', 'ALA', 'ALB', 'AND', 'ARE', 'ARG', 'ARM',
+        'ASM', 'ATA', 'ATF', 'ATG', 'AUS', 'AUT', 'AZE', 'BDI', 'BEL', 'BEN',
+        'BES', 'BFA', 'BGD', 'BGR', 'BHR', 'BHS', 'BIH', 'BLM', 'BLR', 'BLZ',
+        'BMU', 'BOL', 'BRA', 'BRB', 'BRN', 'BTN', 'BVT', 'BWA', 'CAF', 'CAN',
+        'CCK', 'CHE', 'CHL', 'CHN', 'CIV', 'CMR', 'COD', 'COG', 'COK', 'COL',
+        'COM', 'CPV', 'CRI', 'CUB', 'CUW', 'CXR', 'CYM', 'CYP', 'CZE', 'DEU',
+        'DJI', 'DMA', 'DNK', 'DOM', 'DZA', 'ECU', 'EGY', 'ERI', 'ESH', 'ESP',
+        'EST', 'ETH', 'FIN', 'FJI', 'FLK', 'FRA', 'FRO', 'FSM', 'GAB', 'GBR',
+        'GEO', 'GGY', 'GHA', 'GIB', 'GIN', 'GLP', 'GMB', 'GNB', 'GNQ', 'GRC',
+        'GRD', 'GRL', 'GTM', 'GUF', 'GUM', 'GUY', 'HKG', 'HMD', 'HND', 'HRV',
+        'HTI', 'HUN', 'IDN', 'IMN', 'IND', 'IOT', 'IRL', 'IRN', 'IRQ', 'ISL',
+        'ISR', 'ITA', 'JAM', 'JEY', 'JOR', 'JPN', 'KAZ', 'KEN', 'KGZ', 'KHM',
+        'KIR', 'KNA', 'KOR', 'KWT', 'LAO', 'LBN', 'LBR', 'LBY', 'LCA', 'LIE',
+        'LKA', 'LSO', 'LTU', 'LUX', 'LVA', 'MAC', 'MAF', 'MAR', 'MCO', 'MDA',
+        'MDG', 'MDV', 'MEX', 'MHL', 'MKD', 'MLI', 'MLT', 'MMR', 'MNE', 'MNG',
+        'MNP', 'MOZ', 'MRT', 'MSR', 'MTQ', 'MUS', 'MWI', 'MYS', 'MYT', 'NAM',
+        'NCL', 'NER', 'NFK', 'NGA', 'NIC', 'NIU', 'NLD', 'NOR', 'NPL', 'NRU',
+        'NZL', 'OMN', 'PAK', 'PAN', 'PCN', 'PER', 'PHL', 'PLW', 'PNG', 'POL',
+        'PRI', 'PRK', 'PRT', 'PRY', 'PSE', 'PYF', 'QAT', 'REU', 'ROU', 'RUS',
+        'RWA', 'SAU', 'SDN', 'SEN', 'SGP', 'SGS', 'SHN', 'SJM', 'SLB', 'SLE',
+        'SLV', 'SMR', 'SOM', 'SPM', 'SRB', 'SSD', 'STP', 'SUR', 'SVK', 'SVN',
+        'SWE', 'SWZ', 'SXM', 'SYC', 'SYR', 'TCA', 'TCD', 'TGO', 'THA', 'TJK',
+        'TKL', 'TKM', 'TLS', 'TON', 'TTO', 'TUN', 'TUR', 'TUV', 'TWN', 'TZA',
+        'UGA', 'UKR', 'UMI', 'URY', 'USA', 'UZB', 'VAT', 'VCT', 'VEN', 'VGB',
+        'VIR', 'VNM', 'VUT', 'WLF', 'WSM', 'YEM', 'ZAF', 'ZMB', 'ZWE',
+    ];
+
+    protected static $localeData = [
+        'aa_DJ', 'aa_ER', 'aa_ET',
+        'af_NA', 'af_ZA', 'ak_GH',
+        'am_ET', 'ar_AE', 'ar_BH', 'ar_DZ',
+        'ar_EG', 'ar_IQ', 'ar_JO', 'ar_KW', 'ar_LB',
+        'ar_LY', 'ar_MA', 'ar_OM', 'ar_QA', 'ar_SA',
+        'ar_SD', 'ar_SY', 'ar_TN', 'ar_YE',
+        'as_IN', 'az_AZ', 'be_BY',
+        'bg_BG', 'bn_BD', 'bn_IN',
+        'bo_CN', 'bo_IN', 'bs_BA',
+        'byn_ER', 'ca_ES',
+        'cch_NG', 'cs_CZ',
+        'cy_GB', 'da_DK', 'de_AT',
+        'de_BE', 'de_CH', 'de_DE', 'de_LI', 'de_LU',
+        'dv_MV', 'dz_BT',
+        'ee_GH', 'ee_TG', 'el_CY', 'el_GR',
+        'en_AS', 'en_AU', 'en_BE', 'en_BW',
+        'en_BZ', 'en_CA', 'en_GB', 'en_GU', 'en_HK',
+        'en_IE', 'en_IN', 'en_JM', 'en_MH', 'en_MP',
+        'en_MT', 'en_NA', 'en_NZ', 'en_PH', 'en_PK',
+        'en_SG', 'en_TT', 'en_UM', 'en_US', 'en_VI',
+        'en_ZA', 'en_ZW', 'es_AR',
+        'es_BO', 'es_CL', 'es_CO', 'es_CR', 'es_DO',
+        'es_EC', 'es_ES', 'es_GT', 'es_HN', 'es_MX',
+        'es_NI', 'es_PA', 'es_PE', 'es_PR', 'es_PY',
+        'es_SV', 'es_US', 'es_UY', 'es_VE',
+        'et_EE', 'eu_ES', 'fa_AF',
+        'fa_IR', 'fi_FI', 'fil_PH',
+        'fo_FO', 'fr_BE', 'fr_CA',
+        'fr_CH', 'fr_FR', 'fr_LU', 'fr_MC', 'fr_SN',
+        'fur_IT', 'ga_IE',
+        'gaa_GH', 'gez_ER', 'gez_ET',
+        'gl_ES', 'gsw_CH', 'gu_IN',
+        'gv_GB', 'ha_GH', 'ha_NE',
+        'ha_NG', 'ha_SD', 'haw_US',
+        'he_IL', 'hi_IN', 'hr_HR',
+        'hu_HU', 'hy_AM',
+        'id_ID', 'ig_NG',
+        'ii_CN', 'is_IS',
+        'it_CH', 'it_IT',
+        'ja_JP', 'ka_GE', 'kaj_NG',
+        'kam_KE', 'kcg_NG',
+        'kfo_CI', 'kk_KZ', 'kl_GL',
+        'km_KH', 'kn_IN',
+        'ko_KR', 'kok_IN', 'kpe_GN',
+        'kpe_LR', 'ku_IQ', 'ku_IR', 'ku_SY',
+        'ku_TR', 'kw_GB', 'ky_KG',
+        'ln_CD', 'ln_CG', 'lo_LA',
+        'lt_LT', 'lv_LV',
+        'mk_MK', 'ml_IN', 'mn_CN',
+        'mn_MN', 'mr_IN',
+        'ms_BN', 'ms_MY', 'mt_MT',
+        'my_MM', 'nb_NO', 'nds_DE',
+        'ne_IN', 'ne_NP', 'nl_BE',
+        'nl_NL', 'nn_NO',
+        'nr_ZA', 'nso_ZA', 'ny_MW',
+        'oc_FR', 'om_ET', 'om_KE',
+        'or_IN', 'pa_IN', 'pa_PK',
+        'pl_PL', 'ps_AF',
+        'pt_BR', 'pt_PT', 'ro_MD', 'ro_RO',
+        'ru_RU', 'ru_UA', 'rw_RW',
+        'sa_IN', 'se_FI', 'se_NO',
+        'sh_BA', 'sh_CS', 'sh_YU',
+        'si_LK', 'sid_ET', 'sk_SK',
+        'sl_SI', 'so_DJ', 'so_ET',
+        'so_KE', 'so_SO', 'sq_AL',
+        'sr_BA', 'sr_CS', 'sr_ME', 'sr_RS', 'sr_YU',
+        'ss_SZ', 'ss_ZA', 'st_LS',
+        'st_ZA', 'sv_FI', 'sv_SE',
+        'sw_KE', 'sw_TZ', 'syr_SY',
+        'ta_IN', 'te_IN', 'tg_TJ',
+        'th_TH', 'ti_ER', 'ti_ET',
+        'tig_ER', 'tn_ZA',
+        'to_TO', 'tr_TR',
+        'trv_TW', 'ts_ZA', 'tt_RU',
+        'ug_CN', 'uk_UA',
+        'ur_IN', 'ur_PK', 'uz_AF', 'uz_UZ',
+        've_ZA', 'vi_VN',
+        'wal_ET', 'wo_SN', 'xh_ZA',
+        'yo_NG', 'zh_CN', 'zh_HK',
+        'zh_MO', 'zh_SG', 'zh_TW', 'zu_ZA',
+    ];
+
+    /**
+     * @see https://en.wikipedia.org/wiki/ISO_4217
+     * On date of 2023-01-01
+     *
+     * With the following exceptions:
+     * SVC has been replaced by the USD in 2001: https://en.wikipedia.org/wiki/Salvadoran_col%C3%B3n
+     * ZWL has been suspended since 2009: https://en.wikipedia.org/wiki/Zimbabwean_dollar
+     * HRK has been replaced by EUR since 2023: https://en.wikipedia.org/wiki/Croatian_kuna
+     */
+    protected static $currencyCode = [
+        'AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN',
+        'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BRL',
+        'BSD', 'BTN', 'BWP', 'BYN', 'BZD', 'CAD', 'CDF', 'CHF', 'CLP', 'CNY',
+        'COP', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD',
+        'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GHS', 'GIP',
+        'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HTG', 'HUF', 'IDR', 'ILS',
+        'INR', 'IQD', 'IRR', 'ISK', 'JMD', 'JOD', 'JPY', 'KES', 'KGS', 'KHR',
+        'KMF', 'KPW', 'KRW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD',
+        'LSL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRU',
+        'MUR', 'MVR', 'MWK', 'MXN', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK',
+        'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG',
+        'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK',
+        'SGD', 'SHP', 'SLL', 'SOS', 'SRD', 'SSP', 'STN', 'SYP', 'SZL', 'THB',
+        'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TWD', 'TZS', 'UAH', 'UGX',
+        'USD', 'UYU', 'UZS', 'VES', 'VND', 'VUV', 'WST', 'XAF', 'XCD', 'XOF',
+        'XPF', 'YER', 'ZAR', 'ZMW',
+    ];
+
+    /**
+     * Return a boolean, true or false.
+     *
+     * @param int $chanceOfGettingTrue Between 0 (always get false) and 100 (always get true)
+     *
+     * @return bool
+     *
+     * @example true
+     */
+    public static function boolean($chanceOfGettingTrue = 50)
+    {
+        return self::numberBetween(1, 100) <= $chanceOfGettingTrue;
+    }
+
+    /**
+     * @example 'cfcd208495d565ef66e7dff9f98764da'
+     *
+     * @return string
+     */
+    public static function md5()
+    {
+        return md5(self::numberBetween());
+    }
+
+    /**
+     * @example 'b5d86317c2a144cd04d0d7c03b2b02666fafadf2'
+     *
+     * @return string
+     */
+    public static function sha1()
+    {
+        return sha1(self::numberBetween());
+    }
+
+    /**
+     * @example '85086017559ccc40638fcde2fecaf295e0de7ca51b7517b6aebeaaf75b4d4654'
+     *
+     * @return string
+     */
+    public static function sha256()
+    {
+        return hash('sha256', self::numberBetween());
+    }
+
+    /**
+     * @example 'fr_FR'
+     *
+     * @return string
+     */
+    public static function locale()
+    {
+        return static::randomElement(static::$localeData);
+    }
+
+    /**
+     * @example 'FR'
+     *
+     * @see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+     *
+     * @return string
+     */
+    public static function countryCode()
+    {
+        return static::randomElement(static::$countryCode);
+    }
+
+    /**
+     * @example 'FRA'
+     *
+     * @see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
+     *
+     * @return string
+     */
+    public static function countryISOAlpha3()
+    {
+        return static::randomElement(static::$countryISOAlpha3);
+    }
+
+    /**
+     * @example 'fr'
+     *
+     * @return string
+     */
+    public static function languageCode()
+    {
+        return static::randomElement(static::$languageCode);
+    }
+
+    /**
+     * @example 'EUR'
+     *
+     * @see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+     *
+     * @return string
+     */
+    public static function currencyCode()
+    {
+        return static::randomElement(static::$currencyCode);
+    }
+
+    /**
+     * Returns an Emoji (Unicode character between U+1F600 and U+1F637).
+     *
+     * @see https://en.wikipedia.org/wiki/Emoji#Unicode_blocks
+     *
+     * @return string
+     */
+    public static function emoji()
+    {
+        return static::randomElement(static::$emoji);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Payment.php

@@ -0,0 +1,312 @@
+<?php
+
+namespace Faker\Provider;
+
+use Faker\Calculator\Iban;
+use Faker\Calculator\Luhn;
+
+class Payment extends Base
+{
+    public static $expirationDateFormat = 'm/y';
+
+    protected static $cardVendors = [
+        'Visa', 'Visa', 'Visa', 'Visa', 'Visa',
+        'MasterCard', 'MasterCard', 'MasterCard', 'MasterCard', 'MasterCard',
+        'American Express', 'Discover Card', 'Visa Retired', 'JCB',
+    ];
+
+    /**
+     * @var array List of card brand masks for generating valid credit card numbers
+     *
+     * @see https://en.wikipedia.org/wiki/Payment_card_number Reference for existing prefixes
+     * @see https://www.mastercard.us/en-us/issuers/get-support/2-series-bin-expansion.html MasterCard 2017 2-Series BIN Expansion
+     */
+    protected static $cardParams = [
+        'Visa' => [
+            '4539###########',
+            '4556###########',
+            '4916###########',
+            '4532###########',
+            '4929###########',
+            '40240071#######',
+            '4485###########',
+            '4716###########',
+            '4##############',
+        ],
+        'Visa Retired' => [
+            '4539########',
+            '4556########',
+            '4916########',
+            '4532########',
+            '4929########',
+            '40240071####',
+            '4485########',
+            '4716########',
+            '4###########',
+        ],
+        'MasterCard' => [
+            '2221###########',
+            '23#############',
+            '24#############',
+            '25#############',
+            '26#############',
+            '2720###########',
+            '51#############',
+            '52#############',
+            '53#############',
+            '54#############',
+            '55#############',
+        ],
+        'American Express' => [
+            '34############',
+            '37############',
+        ],
+        'Discover Card' => [
+            '6011###########',
+        ],
+        'JCB' => [
+            '3528###########',
+            '3589###########',
+        ],
+    ];
+
+    /**
+     * @var array list of IBAN formats, source: @see https://www.swift.com/standards/data-standards/iban
+     */
+    protected static $ibanFormats = [
+        'AD' => [['n', 4],    ['n', 4],  ['c', 12]],
+        'AE' => [['n', 3],    ['n', 16]],
+        'AL' => [['n', 8],    ['c', 16]],
+        'AT' => [['n', 5],    ['n', 11]],
+        'AZ' => [['a', 4],    ['c', 20]],
+        'BA' => [['n', 3],    ['n', 3],  ['n', 8],  ['n', 2]],
+        'BE' => [['n', 3],    ['n', 7],  ['n', 2]],
+        'BG' => [['a', 4],    ['n', 4],  ['n', 2],  ['c', 8]],
+        'BH' => [['a', 4],    ['c', 14]],
+        'BR' => [['n', 8],    ['n', 5],  ['n', 10], ['a', 1],  ['c', 1]],
+        'CH' => [['n', 5],    ['c', 12]],
+        'CR' => [['n', 4],    ['n', 14]],
+        'CY' => [['n', 3],    ['n', 5],  ['c', 16]],
+        'CZ' => [['n', 4],    ['n', 6],  ['n', 10]],
+        'DE' => [['n', 8],    ['n', 10]],
+        'DK' => [['n', 4],    ['n', 9],  ['n', 1]],
+        'DO' => [['c', 4],    ['n', 20]],
+        'EE' => [['n', 2],    ['n', 2],  ['n', 11], ['n', 1]],
+        'EG' => [['n', 4],    ['n', 4],  ['n', 17]],
+        'ES' => [['n', 4],    ['n', 4],  ['n', 1],  ['n', 1],  ['n', 10]],
+        'FI' => [['n', 6],    ['n', 7],  ['n', 1]],
+        'FR' => [['n', 5],    ['n', 5],  ['c', 11], ['n', 2]],
+        'GB' => [['a', 4],    ['n', 6],  ['n', 8]],
+        'GE' => [['a', 2],    ['n', 16]],
+        'GI' => [['a', 4],    ['c', 15]],
+        'GR' => [['n', 3],    ['n', 4],  ['c', 16]],
+        'GT' => [['c', 4],    ['c', 20]],
+        'HR' => [['n', 7],    ['n', 10]],
+        'HU' => [['n', 3],    ['n', 4],  ['n', 1],  ['n', 15], ['n', 1]],
+        'IE' => [['a', 4],    ['n', 6],  ['n', 8]],
+        'IL' => [['n', 3],    ['n', 3],  ['n', 13]],
+        'IS' => [['n', 4],    ['n', 2],  ['n', 6],  ['n', 10]],
+        'IT' => [['a', 1],    ['n', 5],  ['n', 5],  ['c', 12]],
+        'KW' => [['a', 4],    ['n', 22]],
+        'KZ' => [['n', 3],    ['c', 13]],
+        'LB' => [['n', 4],    ['c', 20]],
+        'LI' => [['n', 5],    ['c', 12]],
+        'LT' => [['n', 5],    ['n', 11]],
+        'LU' => [['n', 3],    ['c', 13]],
+        'LV' => [['a', 4],    ['c', 13]],
+        'MC' => [['n', 5],    ['n', 5],  ['c', 11], ['n', 2]],
+        'MD' => [['c', 2],    ['c', 18]],
+        'ME' => [['n', 3],    ['n', 13], ['n', 2]],
+        'MK' => [['n', 3],    ['c', 10], ['n', 2]],
+        'MR' => [['n', 5],    ['n', 5],  ['n', 11], ['n', 2]],
+        'MT' => [['a', 4],    ['n', 5],  ['c', 18]],
+        'MU' => [['a', 4],    ['n', 2],  ['n', 2],  ['n', 12], ['n', 3],  ['a', 3]],
+        'NL' => [['a', 4],    ['n', 10]],
+        'NO' => [['n', 4],    ['n', 6],  ['n', 1]],
+        'PK' => [['a', 4],    ['c', 16]],
+        'PL' => [['n', 8],    ['n', 16]],
+        'PS' => [['a', 4],    ['c', 21]],
+        'PT' => [['n', 4],    ['n', 4],  ['n', 11], ['n', 2]],
+        'RO' => [['a', 4],    ['c', 16]],
+        'RS' => [['n', 3],    ['n', 13], ['n', 2]],
+        'SA' => [['n', 2],    ['c', 18]],
+        'SE' => [['n', 3],    ['n', 16], ['n', 1]],
+        'SI' => [['n', 5],    ['n', 8],  ['n', 2]],
+        'SK' => [['n', 4],    ['n', 6],  ['n', 10]],
+        'SM' => [['a', 1],    ['n', 5],  ['n', 5],  ['c', 12]],
+        'TN' => [['n', 2],    ['n', 3],  ['n', 13], ['n', 2]],
+        'TR' => [['n', 5],    ['n', 1],  ['c', 16]],
+        'VG' => [['a', 4],    ['n', 16]],
+    ];
+
+    /**
+     * @return string Returns a credit card vendor name
+     *
+     * @example 'MasterCard'
+     */
+    public static function creditCardType()
+    {
+        return static::randomElement(static::$cardVendors);
+    }
+
+    /**
+     * Returns the String of a credit card number.
+     *
+     * @param string $type      Supporting any of 'Visa', 'MasterCard', 'American Express', 'Discover' and 'JCB'
+     * @param bool   $formatted Set to true if the output string should contain one separator every 4 digits
+     * @param string $separator Separator string for formatting card number. Defaults to dash (-).
+     *
+     * @return string
+     *
+     * @example '4485480221084675'
+     */
+    public static function creditCardNumber($type = null, $formatted = false, $separator = '-')
+    {
+        if (null === $type) {
+            $type = static::creditCardType();
+        }
+        $mask = static::randomElement(static::$cardParams[$type]);
+
+        $number = static::numerify($mask);
+        $number .= Luhn::computeCheckDigit($number);
+
+        if ($formatted) {
+            $p1 = substr($number, 0, 4);
+            $p2 = substr($number, 4, 4);
+            $p3 = substr($number, 8, 4);
+            $p4 = substr($number, 12);
+            $number = $p1 . $separator . $p2 . $separator . $p3 . $separator . $p4;
+        }
+
+        return $number;
+    }
+
+    /**
+     * @param bool $valid True (by default) to get a valid expiration date, false to get a maybe valid date
+     *
+     * @return \DateTime
+     *
+     * @example 04/13
+     */
+    public function creditCardExpirationDate($valid = true)
+    {
+        if ($valid) {
+            return $this->generator->dateTimeBetween('now', '36 months');
+        }
+
+        return $this->generator->dateTimeBetween('-36 months', '36 months');
+    }
+
+    /**
+     * @param bool   $valid                True (by default) to get a valid expiration date, false to get a maybe valid date
+     * @param string $expirationDateFormat
+     *
+     * @return string
+     *
+     * @example '04/13'
+     */
+    public function creditCardExpirationDateString($valid = true, $expirationDateFormat = null)
+    {
+        return $this->creditCardExpirationDate($valid)->format(null === $expirationDateFormat ? static::$expirationDateFormat : $expirationDateFormat);
+    }
+
+    /**
+     * @param bool $valid True (by default) to get a valid expiration date, false to get a maybe valid date
+     *
+     * @return array
+     */
+    public function creditCardDetails($valid = true)
+    {
+        $type = static::creditCardType();
+
+        return [
+            'type' => $type,
+            'number' => static::creditCardNumber($type),
+            'name' => $this->generator->name(),
+            'expirationDate' => $this->creditCardExpirationDateString($valid),
+        ];
+    }
+
+    /**
+     * International Bank Account Number (IBAN)
+     *
+     * @see http://en.wikipedia.org/wiki/International_Bank_Account_Number
+     *
+     * @param string $countryCode ISO 3166-1 alpha-2 country code
+     * @param string $prefix      for generating bank account number of a specific bank
+     * @param int    $length      total length without country code and 2 check digits
+     *
+     * @return string
+     */
+    public static function iban($countryCode = null, $prefix = '', $length = null)
+    {
+        $countryCode = null === $countryCode ? self::randomKey(self::$ibanFormats) : strtoupper($countryCode);
+
+        $format = !isset(static::$ibanFormats[$countryCode]) ? null : static::$ibanFormats[$countryCode];
+
+        if ($length === null) {
+            if ($format === null) {
+                $length = 24;
+            } else {
+                $length = 0;
+
+                foreach ($format as $part) {
+                    [$class, $groupCount] = $part;
+                    $length += $groupCount;
+                }
+            }
+        }
+
+        if ($format === null) {
+            $format = [['n', $length]];
+        }
+
+        $expandedFormat = '';
+
+        foreach ($format as $item) {
+            [$class, $length] = $item;
+            $expandedFormat .= str_repeat($class, $length);
+        }
+
+        $result = $prefix;
+        $expandedFormat = substr($expandedFormat, strlen($result));
+
+        foreach (str_split($expandedFormat) as $class) {
+            switch ($class) {
+                default:
+                case 'c':
+                    $result .= Miscellaneous::boolean() ? static::randomDigit() : strtoupper(static::randomLetter());
+
+                    break;
+
+                case 'a':
+                    $result .= strtoupper(static::randomLetter());
+
+                    break;
+
+                case 'n':
+                    $result .= static::randomDigit();
+
+                    break;
+            }
+        }
+
+        $checksum = Iban::checksum($countryCode . '00' . $result);
+
+        return $countryCode . $checksum . $result;
+    }
+
+    /**
+     * Return the String of a SWIFT/BIC number
+     *
+     * @example 'RZTIAT22263'
+     *
+     * @see    http://en.wikipedia.org/wiki/ISO_9362
+     *
+     * @return string Swift/Bic number
+     */
+    public static function swiftBicNumber()
+    {
+        return self::regexify('^([A-Z]){4}([A-Z]){2}([0-9A-Z]){2}([0-9A-Z]{3})?$');
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Person.php

@@ -0,0 +1,147 @@
+<?php
+
+namespace Faker\Provider;
+
+class Person extends Base
+{
+    public const GENDER_MALE = 'male';
+    public const GENDER_FEMALE = 'female';
+
+    protected static $titleFormat = [
+        '{{titleMale}}',
+        '{{titleFemale}}',
+    ];
+
+    protected static $firstNameFormat = [
+        '{{firstNameMale}}',
+        '{{firstNameFemale}}',
+    ];
+
+    protected static $maleNameFormats = [
+        '{{firstNameMale}} {{lastName}}',
+    ];
+
+    protected static $femaleNameFormats = [
+        '{{firstNameFemale}} {{lastName}}',
+    ];
+
+    protected static $firstNameMale = [
+        'John',
+    ];
+
+    protected static $firstNameFemale = [
+        'Jane',
+    ];
+
+    protected static $lastName = ['Doe'];
+
+    protected static $titleMale = ['Mr.', 'Dr.', 'Prof.'];
+
+    protected static $titleFemale = ['Mrs.', 'Ms.', 'Miss', 'Dr.', 'Prof.'];
+
+    /**
+     * @param string|null $gender 'male', 'female' or null for any
+     *
+     * @return string
+     *
+     * @example 'John Doe'
+     */
+    public function name($gender = null)
+    {
+        if ($gender === static::GENDER_MALE) {
+            $format = static::randomElement(static::$maleNameFormats);
+        } elseif ($gender === static::GENDER_FEMALE) {
+            $format = static::randomElement(static::$femaleNameFormats);
+        } else {
+            $format = static::randomElement(array_merge(static::$maleNameFormats, static::$femaleNameFormats));
+        }
+
+        return $this->generator->parse($format);
+    }
+
+    /**
+     * @param string|null $gender 'male', 'female' or null for any
+     *
+     * @return string
+     *
+     * @example 'John'
+     */
+    public function firstName($gender = null)
+    {
+        if ($gender === static::GENDER_MALE) {
+            return static::firstNameMale();
+        }
+
+        if ($gender === static::GENDER_FEMALE) {
+            return static::firstNameFemale();
+        }
+
+        return $this->generator->parse(static::randomElement(static::$firstNameFormat));
+    }
+
+    /**
+     * @return string
+     */
+    public static function firstNameMale()
+    {
+        return static::randomElement(static::$firstNameMale);
+    }
+
+    /**
+     * @return string
+     */
+    public static function firstNameFemale()
+    {
+        return static::randomElement(static::$firstNameFemale);
+    }
+
+    /**
+     * @example 'Doe'
+     *
+     * @return string
+     */
+    public function lastName()
+    {
+        return static::randomElement(static::$lastName);
+    }
+
+    /**
+     * @example 'Mrs.'
+     *
+     * @param string|null $gender 'male', 'female' or null for any
+     *
+     * @return string
+     */
+    public function title($gender = null)
+    {
+        if ($gender === static::GENDER_MALE) {
+            return static::titleMale();
+        }
+
+        if ($gender === static::GENDER_FEMALE) {
+            return static::titleFemale();
+        }
+
+        return $this->generator->parse(static::randomElement(static::$titleFormat));
+    }
+
+    /**
+     * @example 'Mr.'
+     *
+     * @return string
+     */
+    public static function titleMale()
+    {
+        return static::randomElement(static::$titleMale);
+    }
+
+    /**
+     * @example 'Mrs.'
+     *
+     * @return string
+     */
+    public static function titleFemale()
+    {
+        return static::randomElement(static::$titleFemale);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/PhoneNumber.php

@@ -0,0 +1,270 @@
+<?php
+
+namespace Faker\Provider;
+
+use Faker\Calculator\Luhn;
+
+class PhoneNumber extends Base
+{
+    protected static $formats = ['###-###-###'];
+
+    /**
+     * @see https://github.com/giggsey/libphonenumber-for-php/blob/master/src/CountryCodeToRegionCodeMap.php
+     * @see https://libphonenumber.appspot.com/phonenumberparser?number=%2B4576597442
+     */
+    protected static $e164Formats = [
+        '+1##########',
+        '+7##########',
+        '+20##########',
+        '+27##########',
+        '+30##########',
+        '+31##########',
+        '+32#########',
+        '+33#########',
+        '+34#########',
+        '+36#########',
+        '+39##########',
+        '+40#########',
+        '+41#########',
+        '+43##########',
+        '+44##########',
+        '+45########',
+        '+46##########',
+        '+47########',
+        '+48##########',
+        '+49##########',
+        '+51#########',
+        '+52##########',
+        '+53##########',
+        '+54##########',
+        '+55#########',
+        '+56##########',
+        '+57##########',
+        '+58##########',
+        '+60##########',
+        '+61##########',
+        '+62##########',
+        '+63##########',
+        '+64##########',
+        '+65##########',
+        '+66##########',
+        '+81##########',
+        '+82##########',
+        '+84##########',
+        '+86##########',
+        '+90##########',
+        '+91##########',
+        '+92##########',
+        '+93#########',
+        '+94#########',
+        '+95##########',
+        '+98##########',
+        '+211#########',
+        '+212#########',
+        '+213#########',
+        '+216########',
+        '+218#########',
+        '+220#######',
+        '+221#########',
+        '+222########',
+        '+223########',
+        '+224#########',
+        '+225##########',
+        '+226########',
+        '+227########',
+        '+228########',
+        '+229########',
+        '+230########',
+        '+231#########',
+        '+232########',
+        '+233#########',
+        '+234##########',
+        '+235########',
+        '+236########',
+        '+237#########',
+        '+238#######',
+        '+239#######',
+        '+240#########',
+        '+241########',
+        '+242#########',
+        '+243#########',
+        '+244#########',
+        '+245#########',
+        '+246#######',
+        '+247######',
+        '+248#######',
+        '+249#########',
+        '+250#########',
+        '+251#########',
+        '+252#########',
+        '+253########',
+        '+254##########',
+        '+255#########',
+        '+256#########',
+        '+257########',
+        '+258#########',
+        '+260#########',
+        '+261#########',
+        '+262#########',
+        '+263##########',
+        '+264#########',
+        '+265#########',
+        '+266########',
+        '+267##########',
+        '+268#########',
+        '+269#######',
+        '+290#####',
+        '+291#######',
+        '+297#######',
+        '+298######',
+        '+299######',
+        '+350########',
+        '+351#########',
+        '+352##########',
+        '+353##########',
+        '+354#########',
+        '+355#########',
+        '+356########',
+        '+357########',
+        '+358##########',
+        '+359#########',
+        '+370########',
+        '+371########',
+        '+372##########',
+        '+373########',
+        '+374########',
+        '+375##########',
+        '+376#########',
+        '+377#########',
+        '+378##########',
+        '+380##########',
+        '+381##########',
+        '+382#########',
+        '+383#########',
+        '+385#########',
+        '+386########',
+        '+387#########',
+        '+389########',
+        '+420#########',
+        '+421#########',
+        '+423#########',
+        '+500#####',
+        '+501#######',
+        '+502########',
+        '+503########',
+        '+504########',
+        '+505########',
+        '+506########',
+        '+507##########',
+        '+508#########',
+        '+509########',
+        '+590#########',
+        '+591#########',
+        '+592#######',
+        '+593##########',
+        '+594#########',
+        '+595##########',
+        '+596#########',
+        '+597#######',
+        '+598##########',
+        '+599########',
+        '+670########',
+        '+672######',
+        '+673#######',
+        '+674#######',
+        '+675########',
+        '+676#######',
+        '+677#######',
+        '+678#######',
+        '+679#######',
+        '+680#######',
+        '+681#########',
+        '+682#####',
+        '+683#######',
+        '+685##########',
+        '+686########',
+        '+687######',
+        '+688#######',
+        '+689#########',
+        '+690#######',
+        '+691#######',
+        '+692#######',
+        '+800########',
+        '+808########',
+        '+850##########',
+        '+852#########',
+        '+853########',
+        '+855##########',
+        '+856##########',
+        '+870#########',
+        '+878############',
+        '+880##########',
+        '+881#########',
+        '+882##########',
+        '+883#########',
+        '+886##########',
+        '+888###########',
+        '+960##########',
+        '+961########',
+        '+962#########',
+        '+963#########',
+        '+964##########',
+        '+965########',
+        '+966##########',
+        '+967#########',
+        '+968#########',
+        '+970##########',
+        '+971##########',
+        '+972##########',
+        '+973########',
+        '+974########',
+        '+975########',
+        '+976##########',
+        '+977##########',
+        '+979#########',
+        '+992#########',
+        '+993########',
+        '+994#########',
+        '+995#########',
+        '+996#########',
+        '+998#########',
+    ];
+
+    /**
+     * @example '555-123-546'
+     *
+     * @return string
+     */
+    public function phoneNumber()
+    {
+        return static::numerify($this->generator->parse(static::randomElement(static::$formats)));
+    }
+
+    /**
+     * @example +11134567890
+     *
+     * @return string
+     */
+    public function e164PhoneNumber()
+    {
+        return static::numerify($this->generator->parse(static::randomElement(static::$e164Formats)));
+    }
+
+    /**
+     * International Mobile Equipment Identity (IMEI)
+     *
+     * @see http://en.wikipedia.org/wiki/International_Mobile_Station_Equipment_Identity
+     * @see http://imei-number.com/imei-validation-check/
+     *
+     * @example '720084494799532'
+     *
+     * @return int $imei
+     */
+    public function imei()
+    {
+        $imei = (string) static::numerify('##############');
+        $imei .= Luhn::computeCheckDigit($imei);
+
+        return $imei;
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Text.php

@@ -0,0 +1,202 @@
+<?php
+
+namespace Faker\Provider;
+
+abstract class Text extends Base
+{
+    protected static $baseText = '';
+    protected static $separator = ' ';
+    protected static $separatorLen = 1;
+    protected $explodedText;
+    protected $consecutiveWords = [];
+    protected static $textStartsWithUppercase = true;
+
+    /**
+     * Generate a text string by the Markov chain algorithm.
+     *
+     * Depending on the $maxNbChars, returns a random valid looking text. The algorithm
+     * generates a weighted table with the specified number of words as the index and the
+     * possible following words as the value.
+     *
+     * @example 'Alice, swallowing down her flamingo, and began by taking the little golden key'
+     *
+     * @param int $maxNbChars Maximum number of characters the text should contain (minimum: 10)
+     * @param int $indexSize  Determines how many words are considered for the generation of the next word.
+     *                        The minimum is 1, and it produces a higher level of randomness, although the
+     *                        generated text usually doesn't make sense. Higher index sizes (up to 5)
+     *                        produce more correct text, at the price of less randomness.
+     *
+     * @return string
+     */
+    public function realText($maxNbChars = 200, $indexSize = 2)
+    {
+        return $this->realTextBetween((int) round($maxNbChars * 0.8), $maxNbChars, $indexSize);
+    }
+
+    /**
+     * Generate a text string by the Markov chain algorithm.
+     *
+     * Depending on the $maxNbChars, returns a random valid looking text. The algorithm
+     * generates a weighted table with the specified number of words as the index and the
+     * possible following words as the value.
+     *
+     * @example 'Alice, swallowing down her flamingo, and began by taking the little golden key'
+     *
+     * @param int $minNbChars Minimum number of characters the text should contain (maximum: 8)
+     * @param int $maxNbChars Maximum number of characters the text should contain (minimum: 10)
+     * @param int $indexSize  Determines how many words are considered for the generation of the next word.
+     *                        The minimum is 1, and it produces a higher level of randomness, although the
+     *                        generated text usually doesn't make sense. Higher index sizes (up to 5)
+     *                        produce more correct text, at the price of less randomness.
+     *
+     * @return string
+     */
+    public function realTextBetween($minNbChars = 160, $maxNbChars = 200, $indexSize = 2)
+    {
+        if ($minNbChars < 1) {
+            throw new \InvalidArgumentException('minNbChars must be at least 1');
+        }
+
+        if ($maxNbChars < 10) {
+            throw new \InvalidArgumentException('maxNbChars must be at least 10');
+        }
+
+        if ($indexSize < 1) {
+            throw new \InvalidArgumentException('indexSize must be at least 1');
+        }
+
+        if ($indexSize > 5) {
+            throw new \InvalidArgumentException('indexSize must be at most 5');
+        }
+
+        if ($minNbChars >= $maxNbChars) {
+            throw new \InvalidArgumentException('minNbChars must be smaller than maxNbChars');
+        }
+
+        $words = $this->getConsecutiveWords($indexSize);
+        $iterations = 0;
+
+        do {
+            ++$iterations;
+
+            if ($iterations >= 100) {
+                throw new \OverflowException(sprintf('Maximum retries of %d reached without finding a valid real text', $iterations));
+            }
+
+            $result = $this->generateText($maxNbChars, $words);
+        } while (static::strlen($result) <= $minNbChars);
+
+        return $result;
+    }
+
+    /**
+     * @param int   $maxNbChars
+     * @param array $words
+     *
+     * @return string
+     */
+    protected function generateText($maxNbChars, $words)
+    {
+        $result = [];
+        $resultLength = 0;
+        // take a random starting point
+        $next = static::randomKey($words);
+
+        while ($resultLength < $maxNbChars && isset($words[$next])) {
+            // fetch a random word to append
+            $word = static::randomElement($words[$next]);
+
+            // calculate next index
+            $currentWords = static::explode($next);
+            $currentWords[] = $word;
+            array_shift($currentWords);
+            $next = static::implode($currentWords);
+
+            // ensure text starts with an uppercase letter
+            if ($resultLength == 0 && !static::validStart($word)) {
+                continue;
+            }
+
+            // append the element
+            $result[] = $word;
+            $resultLength += static::strlen($word) + static::$separatorLen;
+        }
+
+        // remove the element that caused the text to overflow
+        array_pop($result);
+
+        // build result
+        $result = static::implode($result);
+
+        return static::appendEnd($result);
+    }
+
+    protected function getConsecutiveWords($indexSize)
+    {
+        if (!isset($this->consecutiveWords[$indexSize])) {
+            $parts = $this->getExplodedText();
+            $words = [];
+            $index = [];
+
+            for ($i = 0; $i < $indexSize; ++$i) {
+                $index[] = array_shift($parts);
+            }
+
+            for ($i = 0, $count = count($parts); $i < $count; ++$i) {
+                $stringIndex = static::implode($index);
+
+                if (!isset($words[$stringIndex])) {
+                    $words[$stringIndex] = [];
+                }
+                $word = $parts[$i];
+                $words[$stringIndex][] = $word;
+                array_shift($index);
+                $index[] = $word;
+            }
+            // cache look up words for performance
+            $this->consecutiveWords[$indexSize] = $words;
+        }
+
+        return $this->consecutiveWords[$indexSize];
+    }
+
+    protected function getExplodedText()
+    {
+        if ($this->explodedText === null) {
+            $this->explodedText = static::explode(preg_replace('/\s+/u', ' ', static::$baseText));
+        }
+
+        return $this->explodedText;
+    }
+
+    protected static function explode($text)
+    {
+        return explode(static::$separator, $text);
+    }
+
+    protected static function implode($words)
+    {
+        return implode(static::$separator, $words);
+    }
+
+    protected static function strlen($text)
+    {
+        return function_exists('mb_strlen') ? mb_strlen($text, 'UTF-8') : strlen($text);
+    }
+
+    protected static function validStart($word)
+    {
+        $isValid = true;
+
+        if (static::$textStartsWithUppercase) {
+            $isValid = preg_match('/^\p{Lu}/u', $word);
+        }
+
+        return $isValid;
+    }
+
+    protected static function appendEnd($text)
+    {
+        return preg_replace("/([ ,-:;\x{2013}\x{2014}]+$)/us", '', $text) . '.';
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/UserAgent.php

@@ -0,0 +1,219 @@
+<?php
+
+namespace Faker\Provider;
+
+class UserAgent extends Base
+{
+    protected static $userAgents = ['firefox', 'chrome', 'internetExplorer', 'opera', 'safari', 'msedge'];
+
+    protected static $windowsPlatformTokens = [
+        'Windows NT 6.2', 'Windows NT 6.1', 'Windows NT 6.0', 'Windows NT 5.2', 'Windows NT 5.1',
+        'Windows NT 5.01', 'Windows NT 5.0', 'Windows NT 4.0', 'Windows 98; Win 9x 4.90', 'Windows 98',
+        'Windows 95', 'Windows CE',
+    ];
+
+    /**
+     * Possible processors on Linux
+     */
+    protected static $linuxProcessor = ['i686', 'x86_64'];
+
+    /**
+     * Mac processors (it also added U;)
+     */
+    protected static $macProcessor = ['Intel', 'PPC', 'U; Intel', 'U; PPC'];
+
+    /**
+     * Add as many languages as you like.
+     */
+    protected static $lang = ['en-US', 'sl-SI', 'nl-NL'];
+
+    /**
+     * Generate mac processor
+     *
+     * @return string
+     */
+    public static function macProcessor()
+    {
+        return static::randomElement(static::$macProcessor);
+    }
+
+    /**
+     * Generate linux processor
+     *
+     * @return string
+     */
+    public static function linuxProcessor()
+    {
+        return static::randomElement(static::$linuxProcessor);
+    }
+
+    /**
+     * Generate a random user agent
+     *
+     * @example 'Mozilla/5.0 (Windows CE) AppleWebKit/5350 (KHTML, like Gecko) Chrome/13.0.888.0 Safari/5350'
+     *
+     * @return string
+     */
+    public static function userAgent()
+    {
+        $userAgentName = static::randomElement(static::$userAgents);
+
+        return static::$userAgentName();
+    }
+
+    /**
+     * Generate Chrome user agent
+     *
+     * @example 'Mozilla/5.0 (Macintosh; PPC Mac OS X 10_6_5) AppleWebKit/5312 (KHTML, like Gecko) Chrome/14.0.894.0 Safari/5312'
+     *
+     * @return string
+     */
+    public static function chrome()
+    {
+        $saf = self::numberBetween(531, 536) . self::numberBetween(0, 2);
+
+        $platforms = [
+            '(' . static::linuxPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/" . self::numberBetween(36, 40) . '.0.' . self::numberBetween(800, 899) . ".0 Mobile Safari/$saf",
+            '(' . static::windowsPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/" . self::numberBetween(36, 40) . '.0.' . self::numberBetween(800, 899) . ".0 Mobile Safari/$saf",
+            '(' . static::macPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/" . self::numberBetween(36, 40) . '.0.' . self::numberBetween(800, 899) . ".0 Mobile Safari/$saf",
+        ];
+
+        return 'Mozilla/5.0 ' . static::randomElement($platforms);
+    }
+
+    /**
+     * Generate Edge user agent
+     *
+     * @example 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.82 Safari/537.36 Edg/99.0.1150.36'
+     *
+     * @return string
+     */
+    public static function msedge()
+    {
+        $saf = self::numberBetween(531, 537) . '.' . self::numberBetween(0, 2);
+        $chrv = self::numberBetween(79, 99) . '.0';
+
+        $platforms = [
+            '(' . static::windowsPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/$chrv" . '.' . self::numberBetween(4000, 4844) . '.' . self::numberBetween(10, 99) . " Safari/$saf Edg/$chrv" . self::numberBetween(1000, 1146) . '.' . self::numberBetween(0, 99),
+            '(' . static::macPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/$chrv" . '.' . self::numberBetween(4000, 4844) . '.' . self::numberBetween(10, 99) . " Safari/$saf Edg/$chrv" . self::numberBetween(1000, 1146) . '.' . self::numberBetween(0, 99),
+            '(' . static::linuxPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/$chrv" . '.' . self::numberBetween(4000, 4844) . '.' . self::numberBetween(10, 99) . " Safari/$saf EdgA/$chrv" . self::numberBetween(1000, 1146) . '.' . self::numberBetween(0, 99),
+            '(' . static::iosMobileToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Version/15.0 EdgiOS/$chrv" . self::numberBetween(1000, 1146) . '.' . self::numberBetween(0, 99) . " Mobile/15E148 Safari/$saf",
+        ];
+
+        return 'Mozilla/5.0 ' . static::randomElement($platforms);
+    }
+
+    /**
+     * Generate Firefox user agent
+     *
+     * @example 'Mozilla/5.0 (X11; Linuxi686; rv:7.0) Gecko/20101231 Firefox/3.6'
+     *
+     * @return string
+     */
+    public static function firefox()
+    {
+        $ver = 'Gecko/' . date('Ymd', self::numberBetween(strtotime('2010-1-1'), time())) . ' Firefox/' . self::numberBetween(35, 37) . '.0';
+
+        $platforms = [
+            '(' . static::windowsPlatformToken() . '; ' . static::randomElement(static::$lang) . '; rv:1.9.' . self::numberBetween(0, 2) . '.20) ' . $ver,
+            '(' . static::linuxPlatformToken() . '; rv:' . self::numberBetween(5, 7) . '.0) ' . $ver,
+            '(' . static::macPlatformToken() . ' rv:' . self::numberBetween(2, 6) . '.0) ' . $ver,
+        ];
+
+        return 'Mozilla/5.0 ' . static::randomElement($platforms);
+    }
+
+    /**
+     * Generate Safari user agent
+     *
+     * @example 'Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_7_1 rv:3.0; en-US) AppleWebKit/534.11.3 (KHTML, like Gecko) Version/4.0 Safari/534.11.3'
+     *
+     * @return string
+     */
+    public static function safari()
+    {
+        $saf = self::numberBetween(531, 535) . '.' . self::numberBetween(1, 50) . '.' . self::numberBetween(1, 7);
+
+        if (Miscellaneous::boolean()) {
+            $ver = self::numberBetween(4, 5) . '.' . self::numberBetween(0, 1);
+        } else {
+            $ver = self::numberBetween(4, 5) . '.0.' . self::numberBetween(1, 5);
+        }
+
+        $mobileDevices = [
+            'iPhone; CPU iPhone OS',
+            'iPad; CPU OS',
+        ];
+
+        $platforms = [
+            '(Windows; U; ' . static::windowsPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Version/$ver Safari/$saf",
+            '(' . static::macPlatformToken() . ' rv:' . self::numberBetween(2, 6) . '.0; ' . static::randomElement(static::$lang) . ") AppleWebKit/$saf (KHTML, like Gecko) Version/$ver Safari/$saf",
+            '(' . static::randomElement($mobileDevices) . ' ' . self::numberBetween(7, 8) . '_' . self::numberBetween(0, 2) . '_' . self::numberBetween(1, 2) . ' like Mac OS X; ' . static::randomElement(static::$lang) . ") AppleWebKit/$saf (KHTML, like Gecko) Version/" . self::numberBetween(3, 4) . '.0.5 Mobile/8B' . self::numberBetween(111, 119) . " Safari/6$saf",
+        ];
+
+        return 'Mozilla/5.0 ' . static::randomElement($platforms);
+    }
+
+    /**
+     * Generate Opera user agent
+     *
+     * @example 'Opera/8.25 (Windows NT 5.1; en-US) Presto/2.9.188 Version/10.00'
+     *
+     * @return string
+     */
+    public static function opera()
+    {
+        $platforms = [
+            '(' . static::linuxPlatformToken() . '; ' . static::randomElement(static::$lang) . ') Presto/2.' . self::numberBetween(8, 12) . '.' . self::numberBetween(160, 355) . ' Version/' . self::numberBetween(10, 12) . '.00',
+            '(' . static::windowsPlatformToken() . '; ' . static::randomElement(static::$lang) . ') Presto/2.' . self::numberBetween(8, 12) . '.' . self::numberBetween(160, 355) . ' Version/' . self::numberBetween(10, 12) . '.00',
+        ];
+
+        return 'Opera/' . self::numberBetween(8, 9) . '.' . self::numberBetween(10, 99) . ' ' . static::randomElement($platforms);
+    }
+
+    /**
+     * Generate Internet Explorer user agent
+     *
+     * @example 'Mozilla/5.0 (compatible; MSIE 7.0; Windows 98; Win 9x 4.90; Trident/3.0)'
+     *
+     * @return string
+     */
+    public static function internetExplorer()
+    {
+        return 'Mozilla/5.0 (compatible; MSIE ' . self::numberBetween(5, 11) . '.0; ' . static::windowsPlatformToken() . '; Trident/' . self::numberBetween(3, 5) . '.' . self::numberBetween(0, 1) . ')';
+    }
+
+    /**
+     * @return string
+     */
+    public static function windowsPlatformToken()
+    {
+        return static::randomElement(static::$windowsPlatformTokens);
+    }
+
+    /**
+     * @return string
+     */
+    public static function macPlatformToken()
+    {
+        return 'Macintosh; ' . static::randomElement(static::$macProcessor) . ' Mac OS X 10_' . self::numberBetween(5, 8) . '_' . self::numberBetween(0, 9);
+    }
+
+    /**
+     * @return string
+     */
+    public static function iosMobileToken()
+    {
+        $iosVer = self::numberBetween(13, 15) . '_' . self::numberBetween(0, 2);
+
+        return 'iPhone; CPU iPhone OS ' . $iosVer . ' like Mac OS X';
+    }
+
+    /**
+     * @return string
+     */
+    public static function linuxPlatformToken()
+    {
+        return 'X11; Linux ' . static::randomElement(static::$linuxProcessor);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/Uuid.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace Faker\Provider;
+
+class Uuid extends Base
+{
+    /**
+     * Generate name based md5 UUID (version 3).
+     *
+     * @example '7e57d004-2b97-0e7a-b45f-5387367791cd'
+     *
+     * @return string
+     */
+    public static function uuid()
+    {
+        // fix for compatibility with 32bit architecture; each mt_rand call is restricted to 32bit
+        // two such calls will cause 64bits of randomness regardless of architecture
+        $seed = self::numberBetween(0, 2147483647) . '#' . self::numberBetween(0, 2147483647);
+
+        // Hash the seed and convert to a byte array
+        $val = md5($seed, true);
+        $byte = array_values(unpack('C16', $val));
+
+        // extract fields from byte array
+        $tLo = ($byte[0] << 24) | ($byte[1] << 16) | ($byte[2] << 8) | $byte[3];
+        $tMi = ($byte[4] << 8) | $byte[5];
+        $tHi = ($byte[6] << 8) | $byte[7];
+        $csLo = $byte[9];
+        $csHi = $byte[8] & 0x3f | (1 << 7);
+
+        // correct byte order for big edian architecture
+        if (pack('L', 0x6162797A) == pack('N', 0x6162797A)) {
+            $tLo = (($tLo & 0x000000ff) << 24) | (($tLo & 0x0000ff00) << 8)
+                | (($tLo & 0x00ff0000) >> 8) | (($tLo & 0xff000000) >> 24);
+            $tMi = (($tMi & 0x00ff) << 8) | (($tMi & 0xff00) >> 8);
+            $tHi = (($tHi & 0x00ff) << 8) | (($tHi & 0xff00) >> 8);
+        }
+
+        // apply version number
+        $tHi &= 0x0fff;
+        $tHi |= (3 << 12);
+
+        // cast to string
+        return sprintf(
+            '%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x',
+            $tLo,
+            $tMi,
+            $tHi,
+            $csHi,
+            $csLo,
+            $byte[10],
+            $byte[11],
+            $byte[12],
+            $byte[13],
+            $byte[14],
+            $byte[15],
+        );
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_EG/Address.php

@@ -0,0 +1,217 @@
+<?php
+
+namespace Faker\Provider\ar_EG;
+
+class Address extends \Faker\Provider\Address
+{
+    protected static $cityPrefix = [
+        'شمال',
+        'جنوب',
+        'شرق',
+        'غرب',
+    ];
+
+    protected static $streetPrefix = ['شارع', 'طريق', 'ممر'];
+
+    /**
+     * @see https://ar.wikipedia.org/wiki/%D8%AA%D8%B5%D9%86%D9%8A%D9%81:%D8%A3%D8%AD%D9%8A%D8%A7%D8%A1_%D8%A7%D9%84%D9%82%D8%A7%D9%87%D8%B1%D8%A9
+     */
+    protected static $cityName = [
+        'التجمع الاول',
+        'التجمع التالت',
+        'التجمع الخامس',
+        'الشروق',
+        'الرحاب',
+        'الجزيرة',
+        'الحسين',
+        'الزمالك',
+        'السلام',
+        'الظاهر',
+        'العباسية',
+        'المطرية',
+        'الموسكي',
+        'النزهة الجديدة',
+        'السيدة زينب',
+        'المرج',
+        'المعادي',
+        'المقطم',
+        'المنيل',
+        'الوايلي',
+        'باب الشعرية',
+        'باب اللوق',
+        'ثكنات المعادي',
+        'جاردن سيتي',
+        'جسر السويس',
+        'عابدين',
+        'حدائق المعادي',
+        'حلمية الزيتون',
+        'حلوان',
+        'الأزبكية',
+        'الزاوية الحمراء',
+        'الساحل',
+        'مدينة نصر',
+        'حدائق القبة',
+        'شبرا',
+        'عين شمس',
+        'روكسي',
+        'زهراء المعادي',
+        'سراي القبة',
+        'عبود',
+        'عزبة النخل',
+        'كوتسيكا',
+        'الشيخ زايد',
+        'السادس من اكتوير',
+        'العاشر من رمضان',
+        'المعصرة',
+        'الزهراء',
+        'غمرة',
+        'المنيب',
+        'فيصل',
+        'الدقي',
+        'العتبة',
+        'المظلات',
+        'المطار',
+        'قباء',
+        'ألف مسكن',
+        'هليوبوليس',
+        'هارون',
+        'كلية البنات',
+        'عبده باشا',
+        'الجيش',
+        'الكيت كات',
+        'إمبابة',
+    ];
+
+    /**
+     * @see https://ar.wikipedia.org/wiki/%D9%82%D8%A7%D8%A6%D9%85%D8%A9_%D9%85%D8%AD%D8%A7%D9%81%D8%B8%D8%A7%D8%AA_%D9%85%D8%B5%D8%B1
+     * @see https://ar.wikipedia.org/wiki/%D8%A8%D8%B7%D8%A7%D9%82%D8%A9_%D8%A7%D9%84%D8%B1%D9%82%D9%85_%D8%A7%D9%84%D9%82%D9%88%D9%85%D9%8A_%D8%A7%D9%84%D9%85%D8%B5%D8%B1%D9%8A%D8%A9
+     */
+    protected static $governorates = [
+        'الإسكندرية' => '02',
+        'الإسماعيلية' => '19',
+        'أسوان' => '28',
+        'أسيوط' => '25',
+        'الأقصر' => '29',
+        'البحر الأحمر' => '31',
+        'البحيرة' => '18',
+        'بني سويف' => '22',
+        'بورسعيد' => '03',
+        'جنوب سيناء' => '35',
+        'القاهرة' => '01',
+        'الدقهلية' => '12',
+        'دمياط' => '11',
+        'سوهاج' => '26',
+        'السويس' => '04',
+        'الشرقية' => '13',
+        'شمال سيناء' => '34',
+        'الغربية' => '16',
+        'الفيوم' => '23',
+        'القليوبية' => '14',
+        'قنا' => '27',
+        'كفر الشيخ' => '15',
+        'مطروح' => '33',
+        'المنوفية' => '17',
+        'المنيا' => '24',
+        'الوادي الجديد' => '32',
+    ];
+
+    protected static $buildingNumber = ['%####', '%###', '%#'];
+
+    protected static $postcode = ['#####', '#####-####'];
+
+    /**
+     * @see http://www.nationsonline.org/oneworld/countrynames_arabic.htm
+     */
+    protected static $country = [
+        'الكاريبي', 'أمريكا الوسطى', 'أنتيجوا وبربودا', 'أنجولا', 'أنجويلا', 'أندورا', 'اندونيسيا', 'أورجواي', 'أوروبا', 'أوزبكستان', 'أوغندا', 'أوقيانوسيا', 'أوقيانوسيا النائية', 'أوكرانيا', 'ايران', 'أيرلندا', 'أيسلندا', 'ايطاليا',
+        'بابوا غينيا الجديدة', 'باراجواي', 'باكستان', 'بالاو', 'بتسوانا', 'بتكايرن', 'بربادوس', 'برمودا', 'بروناي', 'بلجيكا', 'بلغاريا', 'بليز', 'بنجلاديش', 'بنما', 'بنين', 'بوتان', 'بورتوريكو', 'بوركينا فاسو', 'بوروندي', 'بولندا', 'بوليفيا', 'بولينيزيا', 'بولينيزيا الفرنسية', 'بيرو',
+        'تانزانيا', 'تايلند', 'تايوان', 'تركمانستان', 'تركيا', 'ترينيداد وتوباغو', 'تشاد', 'توجو', 'توفالو', 'توكيلو', 'تونجا', 'تونس', 'تيمور الشرقية',
+        'جامايكا', 'جبل طارق', 'جرينادا', 'جرينلاند', 'جزر الأنتيل الهولندية', 'جزر الترك وجايكوس', 'جزر القمر', 'جزر الكايمن', 'جزر المارشال', 'جزر الملديف', 'جزر الولايات المتحدة البعيدة الصغيرة', 'جزر أولان', 'جزر سليمان', 'جزر فارو', 'جزر فرجين الأمريكية', 'جزر فرجين البريطانية', 'جزر فوكلاند', 'جزر كوك', 'جزر كوكوس', 'جزر ماريانا الشمالية', 'جزر والس وفوتونا', 'جزيرة الكريسماس', 'جزيرة بوفيه', 'جزيرة مان', 'جزيرة نورفوك', 'جزيرة هيرد وماكدونالد', 'جمهورية افريقيا الوسطى', 'جمهورية التشيك', 'جمهورية الدومينيك', 'جمهورية الكونغو الديمقراطية', 'جمهورية جنوب افريقيا', 'جنوب آسيا', 'جنوب أوروبا', 'جنوب شرق آسيا', 'جنوب وسط آسيا', 'جواتيمالا', 'جوادلوب', 'جوام', 'جورجيا', 'جورجيا الجنوبية وجزر ساندويتش الجنوبية', 'جيبوتي', 'جيرسي',
+        'دومينيكا',
+        'رواندا', 'روسيا', 'روسيا البيضاء', 'رومانيا', 'روينيون',
+        'زامبيا', 'زيمبابوي',
+        'ساحل العاج', 'ساموا', 'ساموا الأمريكية', 'سانت بيير وميكولون', 'سانت فنسنت وغرنادين', 'سانت كيتس ونيفيس', 'سانت لوسيا', 'سانت مارتين', 'سانت هيلنا', 'سان مارينو', 'ساو تومي وبرينسيبي', 'سريلانكا', 'سفالبارد وجان مايان', 'سلوفاكيا', 'سلوفينيا', 'سنغافورة', 'سوازيلاند', 'سوريا', 'سورينام', 'سويسرا', 'سيراليون', 'سيشل',
+        'شرق آسيا', 'شرق افريقيا', 'شرق أوروبا', 'شمال افريقيا', 'شمال أمريكا', 'شمال أوروبا', 'شيلي',
+        'صربيا', 'صربيا والجبل الأسود',
+        'طاجكستان',
+        'عمان',
+        'غامبيا', 'غانا', 'غرب آسيا', 'غرب افريقيا', 'غرب أوروبا', 'غويانا', 'غيانا', 'غينيا', 'غينيا الاستوائية', 'غينيا بيساو',
+        'فانواتو', 'فرنسا', 'فلسطين', 'فنزويلا', 'فنلندا', 'فيتنام', 'فيجي',
+        'قبرص', 'قرغيزستان', 'قطر',
+        'كازاخستان', 'كاليدونيا الجديدة', 'كرواتيا', 'كمبوديا', 'كندا', 'كوبا', 'كوريا الجنوبية', 'كوريا الشمالية', 'كوستاريكا', 'كولومبيا', 'كومنولث الدول المستقلة', 'كيريباتي', 'كينيا',
+        'لاتفيا', 'لاوس', 'لبنان', 'لوكسمبورج', 'ليبيا', 'ليبيريا', 'ليتوانيا', 'ليختنشتاين', 'ليسوتو',
+        'مارتينيك', 'ماكاو الصينية', 'مالطا', 'مالي', 'ماليزيا', 'مايوت', 'مدغشقر', 'مصر', 'مقدونيا', 'ملاوي', 'منغوليا', 'موريتانيا', 'موريشيوس', 'موزمبيق', 'مولدافيا', 'موناكو', 'مونتسرات', 'ميانمار', 'ميكرونيزيا', 'ميلانيزيا',
+        'ناميبيا', 'نورو', 'نيبال', 'نيجيريا', 'نيكاراجوا', 'نيوزيلاندا', 'نيوي',
+        'هايتي', 'هندوراس', 'هولندا', 'هونج كونج الصينية',
+        'وسط آسيا', 'وسط افريقيا',
+    ];
+
+    protected static $cityFormats = [
+        '{{cityName}}',
+    ];
+
+    protected static $streetNameFormats = [
+        '{{streetPrefix}} {{firstName}} {{lastName}}',
+    ];
+
+    protected static $streetAddressFormats = [
+        '{{buildingNumber}} {{streetName}}',
+        '{{buildingNumber}} {{streetName}} {{secondaryAddress}}',
+    ];
+
+    protected static $addressFormats = [
+        "{{streetAddress}}\n{{city}}",
+    ];
+
+    protected static $secondaryAddressFormats = ['شقة رقم. ##', 'عمارة رقم ##'];
+
+    /**
+     * @example 'شرق'
+     */
+    public static function cityPrefix()
+    {
+        return static::randomElement(static::$cityPrefix);
+    }
+
+    /**
+     * @example 'المعادي'
+     */
+    public static function cityName()
+    {
+        return static::randomElement(static::$cityName);
+    }
+
+    /**
+     * @example 'شارع'
+     */
+    public static function streetPrefix()
+    {
+        return static::randomElement(static::$streetPrefix);
+    }
+
+    /**
+     * @example 'شقة رقم. 350'
+     */
+    public static function secondaryAddress()
+    {
+        return static::numerify(static::randomElement(static::$secondaryAddressFormats));
+    }
+
+    /**
+     * @example 'الإسكندرية'
+     */
+    public static function governorate()
+    {
+        return static::randomKey(static::$governorates);
+    }
+
+    /**
+     * @example '01'
+     *
+     * @return string
+     */
+    public static function governorateId()
+    {
+        return static::randomElement(static::$governorates);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_EG/Color.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Faker\Provider\ar_EG;
+
+class Color extends \Faker\Provider\Color
+{
+    protected static $safeColorNames = [
+        'أسود', 'قرمزي', 'أخضر', 'كحلي', 'زيتوني',
+        'أرجواني', 'أحمر', 'أزرق', 'فضي', 'ذهبي',
+        'رمادي', 'أصفر', 'برتقالي', 'بني', 'أبيض', 'بنفسجى',
+    ];
+
+    /**
+     * @see http://r7eq.com/Service/Design/ColorName/
+     */
+    protected static $allColorNames = [
+        'أخضر فاتح',
+        'أزرق فاتح',
+        'أحمر فاتح',
+        'أصفر فاتح',
+        'بني فاتح',
+        'رمادي فاتح',
+        'أرجواني فاتح',
+        'زيتوني فاتح',
+        'كحلي فاتح',
+        'قرمزي فاتح',
+        'أسود فاتح',
+        'بنفسجى فاتح',
+        'برتقالي فاتح',
+        'زيتوني داكن',
+        'كحلي داكن',
+        'أخضر داكن',
+        'قرمزي داكن',
+        'أزرق داكن',
+        'أحمر داكن',
+        'أرجواني داكن',
+        'بنفسجى داكن',
+        'بني داكن',
+        'برتقالي داكن',
+        'أصفر داكن',
+        'رمادي داكن',
+        'وردي',
+        'زهري',
+        'طوبي',
+        'كستنائي',
+        'عسلي',
+        'نحاسي',
+        'أسمر',
+        'خشبي',
+        'كريمي',
+        'سكري',
+        'ثلجي',
+        'بيج',
+        'ليموني',
+        'فستقي',
+        'كموني',
+        'يروزي',
+        'سماوي',
+        'نيلي',
+        'بحري',
+        'فحمي',
+        'زيتي',
+        'عنابي',
+    ];
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_EG/Company.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace Faker\Provider\ar_EG;
+
+use Faker\Calculator\Luhn;
+
+class Company extends \Faker\Provider\Company
+{
+    protected static $formats = [
+        '{{companyPrefix}} {{cityName}}',
+        '{{companyPrefix}} {{lastName}}',
+        '{{cityName}} {{companySuffix}}',
+        '{{lastName}} {{companySuffix}}',
+        '{{companyPrefix}} {{lastName}} {{companySuffix}}',
+        '{{companyPrefix}} {{cityName}} {{companySuffix}}',
+    ];
+
+    protected static $catchPhraseWords = [
+        ['الخدمات', 'الحلول', 'الانظمة'],
+        [
+            'الذهبية', 'الذكية', 'المتطورة', 'المتقدمة', 'الدولية', 'المتخصصه', 'السريعة',
+            'المثلى', 'الابداعية', 'المتكاملة', 'المتغيرة', 'المثالية',
+        ],
+    ];
+
+    protected static $companyPrefix = ['شركة', 'مؤسسة', 'مجموعة', 'مكتب', 'أكاديمية', 'معرض'];
+
+    protected static $companySuffix = [
+        ' ش.م.م',
+        ' للتجاره العامه',
+        'للأجهزة الطبيه',
+        'للتوريدات',
+        'للمقاولات',
+        'للتطوير العقاري',
+        'للدعايه و الاعلان',
+        'للحلول المتقدمه',
+        'للخدمات الدولية',
+        'الدولية',
+        'للانظمة المتكاملة',
+    ];
+
+    /**
+     * @example 'مؤسسة'
+     *
+     * @return string
+     */
+    public function companyPrefix()
+    {
+        return static::randomElement(self::$companyPrefix);
+    }
+
+    /**
+     * @example 'الحلول المتقدمة'
+     */
+    public function catchPhrase()
+    {
+        $result = [];
+
+        foreach (static::$catchPhraseWords as &$word) {
+            $result[] = static::randomElement($word);
+        }
+
+        return implode(' ', $result);
+    }
+
+    /**
+     * example 010101010
+     */
+    public static function companyTaxIdNumber()
+    {
+        $partialValue = static::numerify(str_repeat('#', 9));
+
+        return Luhn::generateLuhnNumber($partialValue);
+    }
+
+    /**
+     * example 010101
+     */
+    public static function companyTradeRegisterNumber()
+    {
+        $partialValue = static::numerify(str_repeat('#', 6));
+
+        return Luhn::generateLuhnNumber($partialValue);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_EG/Internet.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace Faker\Provider\ar_EG;
+
+class Internet extends \Faker\Provider\Internet
+{
+    protected static $userNameFormats = [
+        '{{lastNameAscii}}.{{firstNameAscii}}',
+        '{{firstNameAscii}}.{{lastNameAscii}}',
+        '{{firstNameAscii}}##',
+        '?{{lastNameAscii}}',
+    ];
+    protected static $safeEmailTld = [
+        'com', 'com.eg', 'eg', 'me', 'net', 'org',
+    ];
+
+    protected static $tld = [
+        'biz', 'com', 'come.eg', 'info', 'eg', 'net', 'org',
+    ];
+
+    protected static $lastNameAscii = [
+        'ahmed',
+        'mostafa',
+        'mahmoud',
+        'carmen',
+        'rakeen',
+        'hazem',
+        'ezz',
+        'hemeida',
+        'ramah',
+        'fahmy',
+        'ehab',
+        'karim',
+        'abdulaziz',
+        'elsherbiny',
+        'karam',
+        'abdulaziz',
+        'bayoumi',
+        'tharwat',
+        'elshamy',
+        'youssef',
+        'rizk',
+        'ramzy',
+        'younes',
+        'selim',
+    ];
+    protected static $firstNameAscii = [
+        'ahmed',
+        'mostafa',
+        'mahmoud',
+        'hazem',
+        'ehab',
+        'karim',
+        'dina',
+        'maged',
+        'mohamed',
+        'saif',
+        'basma',
+        'youssef',
+        'hashem',
+        'dina',
+        'hani',
+        'hashem',
+    ];
+
+    public static function lastNameAscii()
+    {
+        return static::randomElement(static::$lastNameAscii);
+    }
+
+    public static function firstNameAscii()
+    {
+        return static::randomElement(static::$firstNameAscii);
+    }
+
+    /**
+     * @example 'ahmad.abbadi'
+     */
+    public function userName()
+    {
+        $format = static::randomElement(static::$userNameFormats);
+
+        return static::bothify($this->generator->parse($format));
+    }
+
+    /**
+     * @example 'wewebit.jo'
+     */
+    public function domainName()
+    {
+        return static::randomElement(static::$lastNameAscii) . '.' . $this->tld();
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_EG/Payment.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Faker\Provider\ar_EG;
+
+class Payment extends \Faker\Provider\Payment
+{
+    /**
+     * International Bank Account Number (IBAN)
+     *
+     * @see https://www.upiqrcode.com/iban-generator/eg/egypt
+     */
+    public function bankAccountNumber(): string
+    {
+        return self::iban('EG', '', 25);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_EG/Person.php

@@ -0,0 +1,107 @@
+<?php
+
+namespace Faker\Provider\ar_EG;
+
+class Person extends \Faker\Provider\Person
+{
+    protected static $maleNameFormats = [
+        '{{firstNameMale}} {{lastName}}',
+        '{{prefix}} {{firstNameMale}} {{lastName}}',
+        '{{titleMale}} {{firstNameMale}} {{lastName}}',
+    ];
+
+    protected static $femaleNameFormats = [
+        '{{firstNameFemale}} {{lastName}}',
+        '{{prefix}} {{firstNameFemale}} {{lastName}}',
+        '{{titleFemale}} {{firstNameFemale}} {{lastName}}',
+    ];
+
+    /**
+     * @see http://muslim-names.us/
+     */
+    protected static $firstNameMale = [
+
+        'آدم', 'أبراهيم', 'أحمد', 'أدهم', 'أسامة', 'أسعد', 'أشرف', 'أكثم', 'أكرم', 'أمجد', 'أمين', 'أنس', 'أنور', 'أيمن', 'أيوب', 'إبراهيم', 'إسلام', 'إسماعيل', 'إلياس', 'إياد', 'إيهاب', 'ابراهيم', 'احسان', 'احمد', 'ادريس', 'ادم', 'ادهم', 'اديب', 'اسامة',
+        'اسحاق', 'اسحق', 'اسعد', 'اسلام', 'اسماعيل', 'اصلان', 'اكرم', 'المنصور', 'امجد', 'امير', 'امين', 'أنس', 'انور', 'انيس', 'اياد', 'اياس',
+        'ايمن', 'ايوب', 'باسل', 'باسم', 'باهر', 'بدر', 'برهان', 'بسام', 'بشار', 'بشر', 'بشير', 'بكر', 'بلال', 'بليغ', 'بهاء', 'توفيق', 'جابر', 'جاسر', 'جاسم', 'جعفر', 'جلال', 'جمال', 'جمزه', 'جميل', 'جهاد',
+        'حاتم', 'حازم', 'حافظ', 'حامد', 'حبيب', 'حسام', 'حسان', 'حسن', 'حسني', 'حسين', 'حمدان', 'حمدي', 'حمزة', 'حميد', 'خالد', 'خضر', 'خلف', 'خليفة', 'خليل', 'خميس', 'داوود', 'دياب', 'رأفت', 'رؤوف',
+        'رائد', 'رائف', 'راجح', 'راجي', 'راشد', 'راضي', 'راغب', 'رافت', 'راكان', 'رامز', 'رامي', 'ربيع', 'رجب', 'رزق', 'رشاد', 'رشيد', 'رضا', 'رضوان', 'رياض', 'ريان', 'زاهر', 'زاهي', 'زايد',
+        'زكريا', 'زمام', 'زهير', 'زياد', 'زيد', 'زيدان', 'زين', 'سالم', 'سامح', 'سامر', 'سامي', 'سعد', 'سعيد', 'سلام', 'سلطان', 'سلمان', 'سليم', 'سليمان', 'سمعان', 'سميح', 'سنان', 'سند',
+        'سيف', 'شادي', 'شاكر', 'شريف', 'شهاب', 'شهم', 'شوان', 'صادق', 'صافي', 'صالح', 'صفاء', 'صفوان', 'صقر', 'صلاح', 'صلاح الدين', 'صهيب', 'ضرغام', 'ضياء', 'ضياء الدين', 'طارق', 'طالب', 'طاهر', 'طه', 'عادل', 'عاصم', 'عاطف',
+        'عبيدة', 'عثمان', 'عدلي', 'عدنان', 'عزت',
+        'عصام', 'علاء', 'علي', 'عماد', 'عمار', 'عمر', 'عمرو', 'عنان', 'عواد', 'عوض', 'عوف', 'عوني', 'عيد', 'عيسى', 'غازي', 'غسان', 'غيث', 'فؤاد', 'فادي',
+        'فارس', 'فاروق', 'فاضل', 'فايز', 'فتحي', 'فراس', 'فرح', 'فريد', 'فهد', 'فهمي', 'فوزي', 'فيصل', 'قارس', 'قاسم', 'قيس', 'كامل', 'كرم', 'كريم', 'كمال', 'لؤي', 'لبيب', 'لطفي', 'ليث', 'مأمون',
+        'مؤمن', 'مؤنس', 'ماجد', 'مازن', 'مالك', 'مامون', 'ماهر', 'مبارك', 'مجد', 'مجدي', 'محسن', 'محمد ', 'محمود', 'محي', 'مختار', 'مدحت', 'مراد', 'مروان', 'مسعد', 'مسعود', 'مصباح', 'مصطفى', 'مصعب',
+        'معاذ', 'معتز', 'معتصم', 'ممدوح', 'منتصر', 'منصور', 'منير', 'مهاب', 'مهدي', 'مهند', 'موسى', 'نائل', 'ناجي', 'نادر', 'ناصر',
+        'نبيل', 'نديم', 'نزار', 'نزيه', 'نسيم', 'نشات', 'نصار', 'نصر', 'نضال', 'نعمان', 'نعمة', 'نعيم', 'نقولا', 'هادي', 'هاشم', 'هانى', 'هاني', 'هشام', 'هلال', 'همام', 'هيثم', 'وائل',
+        'واصف', 'وجدي', 'وجيه', 'وحيد', 'وديع', 'وسام', 'وسيم', 'وصفي', 'وليد', 'وهيب', 'ياسر', 'ياسين', 'يامن', 'يحيى', 'يشار', 'يعقوب', 'يوسف', 'يونس',
+    ];
+
+    /**
+     * @see http://muslim-names.us/
+     */
+    protected static $firstNameFemale = [
+        'آثار', 'آلاء', 'آية', 'أبرار', 'أحلام', 'أروى', 'أريج', 'أسماء', 'أسيل', 'أصاله', 'أفنان', 'ألاء', 'أماني', 'أمل', 'أميرة', 'أنسام', 'أنوار', 'إخلاص', 'إسراء', 'إكرام', 'إنعام', 'إيمان', 'إيناس', 'ابتهاج', 'ابتهال', 'إخلاص', 'أروى', 'أريج',
+        'أزهار', 'اسراء', 'اسرار', 'اسيل', 'اشراق', 'أفراح', 'إكرام', 'إلهام', 'آمال', 'أمنة', 'أميرة', 'أمينة', 'أنعام', 'أنوار', 'آيات', 'إيمان', 'إيناس', 'آية', 'بتول', 'بثينة', 'بسمة',
+        'بشائر', 'بشرى', 'تالا', 'تالة', 'تسنيم', 'تغريد', 'تقوى', 'تقى', 'تمارا', 'تهاني', 'ثريا', 'جميلة', 'جنى', 'جهاد', 'حبيبة', 'حسناء', 'حلا', 'حليمة', 'حنان', 'حنين', 'حياة',
+        'خديجة', 'خلود', 'دارين', 'داليا', 'دانا', 'دانة', 'دانية', 'دعاء', 'دلال', 'دنيا', 'ديانا', 'ديما', 'دينا', 'رؤى', 'راما', 'رانا', 'رانيا', 'راوية', 'راية', 'ربا', 'رباب', 'ربى', 'رجاء', 'رحمة', 'رحمه', 'رزان',
+        'رشا', 'رغد', 'رغدة', 'رقية', 'رنا', 'رناد', 'رنده', 'رنيم', 'رنين', 'رهف', 'روان', 'رولى', 'رويدة', 'ريان', 'ريتا', 'ريم', 'ريما', 'ريناد', 'ريهام', 'زكية', 'زهرة', 'زين', 'زينا',
+        'زينات', 'زينب', 'زينة', 'ساجدة', 'سارة', 'سجى', 'سحر', 'سعاد', 'سكينة', 'سلسبيل', 'سلمى', 'سلوى', 'سما', 'سماح', 'سماره', 'سمر', 'سمية', 'سميرة', 'سناء', 'سندس', 'سهام', 'سهر', 'سهى', 'سهير', 'سهيله', 'سوزان', 'سوسن',
+        'سيرين', 'سيرينا', 'سيلين', 'سيما', 'شذى', 'شروق', 'شريفة', 'شرين', 'شريهان', 'شفاء', 'شهد', 'شيرين', 'شيماء', 'صابرين', 'صبا', 'صباح', 'صبرين', 'صفا', 'صفاء', 'صفية', 'ضحى', 'ضياء', 'عائشة', 'عاليا', 'عالية', 'عبلة', 'عبير', 'عزة', 'عزيزة', 'عفاف', 'علا', 'علياء',
+        'عهد', 'غادة', 'غدير', 'غرام', 'غزل', 'غيداء', 'فاتن', 'فاديه', 'فاطمة', 'فايزة', 'فتحية', 'فدوى', 'فدى', 'فرح', 'فريال', 'فريدة', 'فوزية', 'فيروز', 'فيفيان', 'قمر', 'لارا', 'لانا', 'لبنا', 'لطيفة', 'لمى',
+        'لميس', 'لنا', 'لورا', 'لورينا', 'لونا', 'ليان', 'ليدا', 'ليلى', 'ليليان', 'لين', 'لينا', 'لينة', 'ليندا', 'مايا', 'مجدولين', 'مديحة', 'مرام', 'مروة', 'مريام', 'مريم', 'مشيرة', 'معالي', 'ملاك', 'ملك', 'منار', 'منال', 'منى', 'مها', 'مي',
+        'ميادة', 'مياده', 'ميار', 'ميان', 'ميرا', 'ميرال', 'ميران', 'ميرفت', 'ميس', 'ميساء', 'ميسره', 'ناديا', 'نادية', 'نادين', 'ناديه', 'نانسي', 'نبيله', 'نجاة', 'نجلاء', 'نجوى', 'نداء', 'ندى',
+        'نرمين', 'نسرين', 'نسيمة', 'نعمت', 'نعمه', 'نهاد', 'نهى', 'نوال', 'نور', 'نورا', 'نوران', 'نيروز', 'نيفين', 'هادلين', 'هالة', 'هانيا', 'هايدي', 'هبة', 'هدايه', 'هدى', 'هديل', 'هلا', 'هنا', 'هناء', 'هنادي', 'هند', 'هيا', 'هيفا',
+        'هيفاء', 'هيلين', 'وئام', 'وجدان', 'وداد', 'ورود', 'وسام', 'وسيم', 'وعد', 'وفاء', 'ولاء', 'يارا', 'ياسمين', 'يسرى',
+    ];
+
+    protected static $lastName = [
+        'عبد الرحيم', 'عبد الرحمن', 'عبد الرؤوف', 'عبد الحميد', 'عبد الله', 'عبد الباسط', 'عبد الحليم', 'عبد الجواد', 'عبد الجليل',
+        'عبد المجيد', 'عبد المطلب', 'عبد المهيمن', 'عبد القادر', 'عبد الفتاح', 'عبد العزيز', 'عبد السلام', 'عبد الرزاق',
+        'طلال', 'هارون', 'شافع', 'عبد الكريم', 'عبد اللطيف', 'عبد الوهاب', 'عبد الهادي', 'عبد الناصر', 'عبد المعطي',
+        'نجيب', 'مظهر', 'عزيز', 'عمران', 'فواز', 'غانم', 'مجاهد', 'عزمي',
+        'زين العابدين', 'كاظم', 'السويلم', 'رجائي', 'مهران', 'رسلان', 'السقا', 'مكي', 'حارث',
+        'غالب', 'السايس', 'صدام', 'هوساوي', 'السعيد', 'الداوود', 'جبر', 'عز الدين', 'عزام', 'عز العرب', 'الصعيدي',
+        'جمال الدين', 'السباعي', 'الكفراوي',
+    ];
+
+    protected static $titleMale = ['السيد', 'الأستاذ', 'الدكتور', 'المهندس'];
+    protected static $titleFemale = ['السيدة', 'الآنسة', 'الدكتورة', 'المهندسة'];
+    private static $prefix = ['أ.', 'د.', 'أ.د', 'م.'];
+
+    /**
+     * @example 'أ.'
+     */
+    public static function prefix()
+    {
+        return static::randomElement(static::$prefix);
+    }
+
+    /**
+     * @see https://ar.wikipedia.org/wiki/%D8%A8%D8%B7%D8%A7%D9%82%D8%A9_%D8%A7%D9%84%D8%B1%D9%82%D9%85_%D8%A7%D9%84%D9%82%D9%88%D9%85%D9%8A_%D8%A7%D9%84%D9%85%D8%B5%D8%B1%D9%8A%D8%A9
+     *
+     * @example 27512310101010
+     *
+     * @return string
+     */
+    public static function nationalIdNumber($gender = null)
+    {
+        $randomBirthDateTimestamp = mt_rand(strtotime('1950-Jan-10'), strtotime('2005-Dec-25'));
+
+        $centuryId = ((int) date('Y', $randomBirthDateTimestamp)) >= 2000 ? 3 : 2;
+        $fullBirthDate = date('ymd', $randomBirthDateTimestamp);
+        $governorateId = Address::governorateId();
+        $birthRegistrationSequence = mt_rand(1, 500);
+
+        if ($gender === static::GENDER_MALE) {
+            $birthRegistrationSequence = $birthRegistrationSequence | 1; // Convert to the nearest odd number
+        } elseif ($gender === static::GENDER_FEMALE) {
+            $birthRegistrationSequence = $birthRegistrationSequence & ~1; // Convert to the nearest even number
+        }
+
+        $birthRegistrationSequence = str_pad((string) $birthRegistrationSequence, 4, '0', STR_PAD_LEFT);
+        $randomCheckDigit = mt_rand(1, 9);
+
+        return $centuryId . $fullBirthDate . $governorateId . $birthRegistrationSequence . $randomCheckDigit;
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_EG/Text.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Faker\Provider\ar_EG;
+
+class Text extends \Faker\Provider\Text
+{
+    protected static function validStart($word)
+    {
+        return preg_match('/^\p{Arabic}/u', $word);
+    }
+
+    /**
+     * License: Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
+     *
+     * Title: ألف ليلة وليلة
+     * Language: Arabic
+     *
+     * @see https://ar.wikisource.org/wiki/%D8%A3%D9%84%D9%81_%D9%84%D9%8A%D9%84%D8%A9_%D9%88%D9%84%D9%8A%D9%84%D8%A9/%D8%A7%D9%84%D8%AC%D8%B2%D8%A1_%D8%A7%D9%84%D8%A3%D9%88%D9%84
+     *
+     * @var string
+     */
+    protected static $baseText = <<<'EOT'
+ففي الليلة الأولى قالت: بلغني أيها الملك السعيد أنه كان تاجر من التجار كثير المال والمعاملات في البلاد قد ركب يومًا وخرج يطالب في بعض البلاد فاشتد عليه الحر فجلس تحت شجرة وحط يده في خرجه وأكل كسرة كانت معه وتمرة فلما فرغ من أكل التمرة رمى النواة وإذا هو بعفريت طويل القامة وبيده سيف فدنا من ذلك التاجر وقال له: قم حتى أقتلك مثل ما قتلت ولدي فقال له التاجر: كيف قتلت ولدك قال له: لما أكلت التمرة ورميت نواتها جاءت النواة في صدر ولدي فقضي عليه ومات من ساعته فقال التاجر للعفريت: أعلم أيها العفريت أني على دين ولي مال كثير وأولاد وزوجة وعندي رهون فدعني أذهب إلى بيتي وأعطي كل ذي حق حقه ثم أعود إليك ولك علي عهد وميثاق أني أعود إليك فتفعل بي ما تريد والله على ما أقول وكيل. فاستوثق منه الجني وأطلقه فرجع إلى بلده وقضى جميع تعلقاته وأوصل الحقوق إلى أهلها وأعلم زوجته وأولاده بما جرى له فبكوا وكذلك جميع أهله ونساءه وأولاده وأوصى وقعد عندهم إلى تمام السنة ثم توجه وأخذ كفنه تحت إبطه وودع أهله وجيرانه وجميع أهله وخرج رغمًا عن أنفه وأقيم عليه العياط والصراخ فمشى إلى أن وصل إلى ذلك البستان وكان ذلك اليوم أول السنة الجديدة فبينما هو جالس يبكي على ما يحصل له وإذا بشيخ كبير قد أقبل عليه ومعه غزالة مسلسلة فسلم على هذا التاجر وحياه وقال له: ما سبب جلوسك في هذا المكان وأنت منفرد وهو مأوى الجن فأخبره التاجر بما جرى له مع ذلك العفريت وبسبب قعوده في هذا منهم الشيخ الأول وهو صاحب الغزالة وقبل يد ذلك العفريت وقال له: يا أيها الجني وتاج ملوك الجن إذا حكيت لك حكايتي مع هذه الغزالة ورأيتها عجيبة أتهب لي ثلث دم هذا التاجر قال: نعم. يا أيها الشيخ إذا أنت حكيت لي الحكاية ورأيتها عجيبة وهبت لك ثلث دمه فقال ذلك الشيخ الأول: اتعلم يا أيها العفريت أن هذه الغزالة هي بنت عمي ومن لحمي ودمي وكنت تزوجت بها وهي صغيرة السن وأقمت معها نحو ثلاثين سنة فلم أرزق منها بولد فأخذت لي سرية فرزقت منها بولد ذكر كأنه البدر إذا بدا بعينين مليحتين وحاجبين مزججين وأعضاء كاملة فكبر شيئًا فشيئًا إلى أن صار ابن خمس عشرة سنة فطرأت لي سفرة إلى بعض المدن فسافرت بمتجر عظيم وكانت بنت عمي هذه الغزالة تعلمت السحر والكهانة من صغرها فسحرت ذلك الولد عجلًا وسحرت الجارية أمه بقرة وسلمتها إلى الراعي ثم جئت أنا بعد مدة طويلة من السفر فسألت عن ولدي وعن أمه فقالت لي جاريتك ماتت وابنك هرب ولم أعلم أين راح فجلست مدة سنة وأنا حزين القلب باكي العين إلى أن جاء عيد الضحية فأرسلت إلى الراعي أن يخصني ببقرة سمينة وهي سريتي التي سحرتها تلك الغزالة فشمرت ثيابي وأخذت السكين بيدي وتهيأت لذبحها فصاحت وبكت بكاء شديدًا فقمت عنها وأمرت ذلك الراعي بذبحها وسلخها فلم يجد فيها شحمًا ولا لحمًا غير جلد وعظم فندمت على ذبحها حيث لا ينفعني الندم وأعطيتها للراعي وقلت له: ائتني بعجل سمين فأتاني بولدي المسحور عجلًا فلما رآني ذلك العجل قطع حبله وجاءني وتمرغ علي وولول وبكى فأخذتني الرأفة عليه وقلت للراعي ائتني ببقرة ودع هذا. وأدرك شهرزاد الصباح فسكتت عن الكلام المباح. فقالت لها أختها: ما أطيب حديثك وألطفه وألذه وأعذبه فقالت: وأين هذا مما أحدثكم به الليلة القابلة إن عشت وأبقاني الملك فقال الملك في نفسه: والله ما أقتلها حتى أسمع بقية حديثها 
Line truncated
+
+و في الليلة الثانية قالت دنيازاد لأختها شهرزاد: يا أختي أتممي لنا حديثك الذي هو حديث التاجر والجني. قالت حبًا وكرامة إن أذن لي الملك في ذلك فقال لها الملك: احكي فقالت: بلغني أيها الملك السعيد ذو الرأي الرشيد أنه لما رأى بكاء العجل حن قلبه إليه وقال للراعي: ابق هذا العجل بين البهائم. كل ذلك والجني يتعجب من حكاية ذلك الكلام العجيب ثم قال صاحب الغزالة: يا سيد ملوك الجان كل ذلك جرى وابنة عمي هذه الغزالة تنظر وترى وتقول اذبح هذا العجل فإنه سمين فلم يهن علي أن أذبحه وأمرت الراعي أن يأخذه وتوجه به ففي ثاني يوم وأنا جالس وإذا بالراعي أقبل علي وقال: يا سيدي إني أقول شيئًا تسر به ولي البشارة. فقلت: نعم فقال: أيها التاجر إن لي بنتًا كانت تعلمت السحر في صغرها من امرأة عجوز كانت عندنا فلما كنا بالأمس وأعطيتني العجل دخلت به عليها فنظرت إليه ابنتي وغطت وجهها وبكت ثم إنها ضحكت وقالت: يا أبي قد خس قدري عندك حتى تدخل علي الرجال الأجانب. فقلت لها: وأين الرجال الأجانب ولماذا بكيت وضحكت فقالت لي أن هذا العجل الذي معك ابن سيدي التاجر ولكنه مسحور وسحرته زوجة أبيه هو وأمه فهذا سبب ضحكي وأما سبب بكائي فمن أجل أمه حيث ذبحها أبوه فتعجبت من ذلك غاية العجب وما صدقت بطلوع الصباح حتى جئت إليك لأعلمك فلما سمعت أيها الجني كلام هذا الراعي خرجت معه وأنا سكران من غير مدام من كثرة الفرح والسرور والذي حصل لي إلى أن أتيت إلى داره فرحبت بي ابنة الراعي وقبلت يدي ثم إن العجل جاء إلي وتمرغ علي فقلت لابنة الراعي: أحق ما تقولينه عن ذلك العجل فقالت: نعم يا سيدي إيه ابنك وحشاشة كبدك فقلت لها: أيها الصبية إن أنت خلصتيه فلك عندي ما تحت يد أبيك من المواشي والأموال فتبسمت وقالت: يا سيدي ليس لي رغبة في المال إلا بشرطين: الأول: أن تزوجني به والثاني: أن أسر من سحرته وأحبسها وإلا فلست آمن مكرها فلما سمعت أيها الجني كلام بنت الراعي قلت : ولك فوق جميع ما تحت يد أبيك من الأموال زيادة وأما بنت عمي فدمها لك مباح. فلما سمعت كلامي أخذت طاسة وملأتها ماء ثم أنها عزمت عليها ورشت بها العجل وقالت: إن كان الله خلقك عجلًا فدم على هذه الصفة ولا تتغير وإن كنت مسحورًا فعد إلى خلقتك الأولى بإذن الله تعالى وإذا به انتفض ثم صار إنسانًا فوقعت عليه وقلت له: بالله عليك احك لي جميع ما صنعت بك وبأمك بنت عمي فحكى لي جميع ما جرى لهما فقلت: يا ولدي قد قيض الله لك من خلصك وخلص حقك ثم إني أيها الجني زوجته ابنة الراعي ثم أنها سحرت ابنة عمي هذه الغزالة وجئت إلى هنا فرأيت هؤلاء الجماعة فسألتهم عن حالهم فأخبروني بما جرى لهذا التاجر فجلست لأنظر ما يكون وهذا حديثي فقال الجني: هذا حديث عجيب وقد وهبت لك ثلث دمه فعند ذلك تقدم الشيخ صاحب الكلبتين السلاقيتين وقال له: اعلم يا سيد ملوك الجان أن هاتين الكلبتين أخوتي وأنا ثالثهم ومات والدي وخلف لنا ثلاثة آلاف دينار ففتحت دكانًا أبيع فيه وأشتري وسافر أخي بتجارته وغاب عنا مدة سنة مع القوافل ثم أتى وما معه شيء فقلت له: يا أخي أما أشرت عليك بعدم السفر فبكى وقال: يا أخي قدر الله عز وجل علي بهذا ولم يبق لهذا الكلام فائدة ولست أملك شيئًا فأخذته وطلعت به إلى الدكان ثم ذهبت به إلى الحمام وألبسته حلة من الملابس الفاخرة وأكلت أنا وإياه وقلت له: يا أخي إني أحسب ربح دكاني من السنة إلى السنة ثم أقسمه دون رLine truncated
+
+ثم وافقتهم على السفر وقلت لهم: يا أخوتي إننا نحسب ما عندنا من المال فحسبناه فإذا هو ستة آلاف دينار فقلت: ندفن نصفها تحت الأرض لينفعا إذا أصابنا أمر ويأخذ كل واحد منا ألف دينار ونتسبب فيها قالوا: نعم الرأي فأخذت المال وقسمته نصفين ودفنت ثلاثة آلاف دينار. وأما الثلاثة آلاف الأخرى فأعطيت كل واحد منهم ألف دينار وجهزنا بضائع واكترينا مركبًا ونقلنا فيها حوائجنا وسافرنا مدة شهر كامل إلى أن دخلنا مدينة وبعنا بضائعنا فربحنا في الدينار عشرة دنانير ثم أردنا السفر فوجدنا على شاطئ البحر جارية عليها خلق مقطع فقبلت يدي وقالت: يا سيدي هل عندك إحسان ومعروف أجازيك عليهما قلت: نعم إن عندي الإحسان والمعروف ولو لم تجازيني فقالت: يا سيدي تزوجني وخذني إلى بلادك فإني قد وهبتك نفسي فافعل معي معروفًا لأني ممن يصنع معه المعروف والإحسان ويجازي عليهما ولا يغرنك حالي. فلما سمعت كلامها حن قلبي إليها لأمر يريده الله عز وجل فأخذتها وكسوتها وفرشت لها في المركب فرشًا حسنًا وأقبلت عليها وأكرمتها ثم سافرنا وقد أحبها قلبي محبة عظيمة وصرت لا أفارقها ليلًا ولا نهارًا أو اشتغلت بها عن إخوتي فغاروا مني وحسدوني على مالي وكثرت بضاعتي وطمحت عيونهم في المال جميعه وتحدثوا بقتلي وأخذ مالي وقالوا: نقتل أخانا ويصير المال جميعه لنا وزين لهم الشيطان أعمالهم فجاؤوني وأنا نائم بجانب زوجتي ورموني في البحر فلما استيقظت زوجتي انتفضت فصارت عفريتة وحملتني وأطلعتني على جزيرة وغابت عني قليلًا وعادت إلي عند الصباح وقالت لي: أنا زوجتك التي حملتك ونجيتك من القتل بإذن الله تعالى واعلم أني جنية رأيتك فحبك قلبي وأنا مؤمنة بالله ورسوله فجئتك بالحال الذي رأيتني فيه فتزوجت بي وها أنا قد نجيتك من الغرق وقد غضبت على إخوتك ولا بد أن أقتلهم. فلما سمعت حكايتها تعجبت وشكرتها على فعلها وقلت لها أما هلاك إخوتي فلا ينبغي ثم حكيت لها ما جرى لي معهم من أول الزمان إلى آخره. فلما سمعت كلامي قالت: أنا في هذه الليلة أطير إليهم وأغرق مراكبهم وأهلكهم فقلت لها: بالله لا تفعلي فإن صاحب المثل يقول: يا محسنًا لمن أساء كفي المسيء فعله وهم إخوتي على كل حال قالت لا بد من قتلهم فاستعطفتها ثم أنها حملتني وطارت فوضعتني على سطح داري ففتحت الأبواب وأخرجت الذي خبأته تحت الأرض وفتحت دكاني بعد ما سلمت على الناس واشتريت بضائع فلما كان الليل دخلت داري فوجدت هاتين الكلبتين مربوطتين فيها فلما رأياني قاما إلي وبكيا وتعلقا بي فلم أشعر إلا وزوجتي قالت هؤلاء إخوتك فقلت من فعل بهم هذا الفعل قالت أنا أرسلت إلى أختي ففعلت بهم ذلك وما يتخلصون إلا بعد عشر سنوات فجئت وأنا سائر إليها تخلصهم بعد إقامتهم عشر سنوات في هذا الحال فرأيت هذا الفتى قال الجني: إنها حكاية عجيبة وقد وهبت لك ثلث دمه في جنايته فعند ذلك تقدم الشيخ الثالث صاحب البغلة وقال للجني أنا أحكي لك حكاية أعجب من حكاية الاثنين وتهب لي باقي دمه وجنايته فقال الجني نعم فقال الشيخ أيها السلطان ورئيس الجان إن هذه البغلة كانت زوجتي سافرت وغبت عنها سنة كاملة ثم قضيت سفري وجئت إليها في الليل فرأيت عبد أسود راقد معها في الفراش وهما في كلام وغنج وضحك وتقبيل وهراش فلما رأتني عجلت وقامت إلي بكوز فيه ماء فتكلمت عليه ورشتني وقالت اخرج من هذه الصورة إلى صورة كلب فصرت في الحال كلبًا فطردتLine truncated
+
+وفي الليلة الثالثة قالت لها أختها دنيا زاد : يا أختي أتمي لنا حديثك فقالت حبًا وكرامة بلغني أيها الملك السعيد أن التاجر أقبل على الشيوخ وشكرهم هنوه بالسلامة ورجع كل واحد إلى بلده وما هذه بأعجب من حكاية الصياد فقال لها الملك: وما حكاية الصياد؟يا ناس اقرأو الكتب فالكتب مشوقة و اتمنى ان تقرأوا القصة التالية لانها مشوقة .
+EOT;
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_JO/Address.php

@@ -0,0 +1,152 @@
+<?php
+
+namespace Faker\Provider\ar_JO;
+
+class Address extends \Faker\Provider\Address
+{
+    protected static $streetPrefix = ['شارع'];
+
+    protected static $cityPrefix = ['شمال', 'شرق', 'غرب', 'جنوب', 'وسط'];
+
+    /**
+     * @see http://ar.wikipedia.org/wiki/%D9%85%D9%84%D8%AD%D9%82:%D9%82%D8%A7%D8%A6%D9%85%D8%A9_%D9%85%D8%AF%D9%86_%D8%A7%D9%84%D8%A3%D8%B1%D8%AF%D9%86
+     */
+    protected static $cityName = [
+        'اربد', 'أبو نصير', 'الجبيهه', 'الحصن', 'الرصيفة', 'الرمثا', 'الزرقاء', 'السلط', 'الشهيد عزمي', 'الصريح', 'الضليل', 'الطفيلة', 'العقبة',     'القويسمة', 'الكرك', 'المشارع', 'المفرق', 'الهاشمية', 'ام قصير', 'ايدون',
+        'بيت راس',
+        'تلاع العلي',
+        'جرش',
+        'ساكب', 'سحاب',
+        'شفا بدران',
+        'صويلح',
+        'عمان', 'عنجره', 'عين الباشا',
+        'غور الصافي',
+        'كريمه', 'كفرنجه',
+        'مادبا', 'مخيم البقعه', 'مخيم حطين', 'مرج الحمام', 'معان',
+        'ناعور',
+        'وادي السير',
+    ];
+
+    protected static $buildingNumber = ['%####', '%###', '%#'];
+
+    protected static $postcode = ['#####', '#####-####'];
+
+    /**
+     * @see http://ar.wikipedia.org/wiki/%D9%85%D9%84%D8%AD%D9%82:%D9%82%D8%A7%D8%A6%D9%85%D8%A9_%D8%A7%D9%84%D9%88%D9%84%D8%A7%D9%8A%D8%A7%D8%AA_%D8%A7%D9%84%D8%A3%D9%85%D8%B1%D9%8A%D9%83%D9%8A%D8%A9_%D8%AD%D8%B3%D8%A8_%D8%A7%D9%84%D9%85%D8%B3%D8%A7%D8%AD%D8%A9
+     */
+    protected static $state = [
+        'آيوا', 'أركنساس', 'أريزونا', 'ألاباما', 'ألاسكا', 'أوريغون', 'أوكلاهوما', 'أوهايو', 'أيداهو', 'إلينوي', 'إنديانا', 'الاباما', 'الجزر العذراء الأمريكية',
+        'بنس    يلفانيا', 'بورتو ريكو',
+        'تكساس', 'تينيسي',
+        'جزر ماريانا الشمالية', 'جورجيا',
+        'داكوتا الجنوبية', 'داكوتا الشمالية', 'ديلاوير', 'رود آيلاند',
+        'ساموا الأمريكية',
+        'غوام',
+        'فرجينيا الغربية', 'فلوريدا', 'فيرجينيا', 'فيرجينيا الغربية', 'فيرمونت',
+        'كارولاينا الجنوبية', 'كارولاينا الشمالية', 'كارولينا الشمالية', 'كاليفورنيا', 'كانساس', 'كنتاكي', 'كولورادو', 'كونيتيكت',
+        'لويزيانا',
+        'ماريلاند', 'ماساتشوستس', 'ماين', 'مسيسيبي', 'مونتانا', 'ميريلاند', 'ميزوري', 'ميشيغان', 'مين', 'مينيسوتا',
+        'نبراسكا', 'نيفادا', 'نيو جيرسي', 'نيو ميكسيكو', 'نيوهامشير', 'نيويورك',
+        'هاواي',
+        'واشنطن', 'وايومنغ', 'ويسكنسن', 'يوتا',
+    ];
+
+    protected static $stateAbbr = [
+        'AK', 'AL', 'AR', 'AZ', 'CA', 'CO', 'CT', 'DC', 'DE', 'FL', 'GA', 'HI', 'IA', 'ID', 'IL', 'IN', 'KS', 'KY', 'LA', 'MA', 'MD', 'ME', 'MI', 'MN', 'MO', 'MS', 'MT', 'NC', 'ND', 'NE', 'NH', 'NJ', 'NM', 'NV', 'NY', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX', 'UT', 'VA', 'VT', 'WA', 'WI', 'WV', 'WY',
+    ];
+
+    /**
+     * @see http://www.nationsonline.org/oneworld/countrynames_arabic.htm
+     */
+    protected static $country = [
+        'الكاريبي', 'أمريكا الوسطى', 'أنتيجوا وبربودا', 'أنجولا', 'أنجويلا', 'أندورا', 'اندونيسيا', 'أورجواي', 'أوروبا', 'أوزبكستان', 'أوغندا', 'أوقيانوسيا', 'أوقيانوسيا النائية', 'أوكرانيا', 'ايران', 'أيرلندا', 'أيسلندا', 'ايطاليا',
+        'بابوا غينيا الجديدة', 'باراجواي', 'باكستان', 'بالاو', 'بتسوانا', 'بتكايرن', 'بربادوس', 'برمودا', 'بروناي', 'بلجيكا', 'بلغاريا', 'بليز', 'بنجلاديش', 'بنما', 'بنين', 'بوتان', 'بورتوريكو', 'بوركينا فاسو', 'بوروندي', 'بولندا', 'بوليفيا', 'بولينيزيا', 'بولينيزيا الفرنسية', 'بيرو',
+        'تانزانيا', 'تايلند', 'تايوان', 'تركمانستان', 'تركيا', 'ترينيداد وتوباغو', 'تشاد', 'توجو', 'توفالو', 'توكيلو', 'تونجا', 'تونس', 'تيمور الشرقية',
+        'جامايكا', 'جبل طارق', 'جرينادا', 'جرينلاند', 'جزر الأنتيل الهولندية', 'جزر الترك وجايكوس', 'جزر القمر', 'جزر الكايمن', 'جزر المارشال', 'جزر الملديف', 'جزر الولايات المتحدة البعيدة الصغيرة', 'جزر أولان', 'جزر سليمان', 'جزر فارو', 'جزر فرجين الأمريكية', 'جزر فرجين البريطانية', 'جزر فوكلاند', 'جزر كوك', 'جزر كوكوس', 'جزر ماريانا الشمالية', 'جزر والس وفوتونا', 'جزيرة الكريسماس', 'جزيرة بوفيه', 'جزيرة مان', 'جزيرة نورفوك', 'جزيرة هيرد وماكدونالد', 'جمهورية افريقيا الوسطى', 'جمهورية التشيك', 'جمهورية الدومينيك', 'جمهورية الكونغو الديمقراطية', 'جمهورية جنوب افريقيا', 'جنوب آسيا', 'جنوب أوروبا', 'جنوب شرق آسيا', 'جنوب وسط آسيا', 'جواتيمالا', 'جوادلوب', 'جوام', 'جورجيا', 'جورجيا الجنوبية وجزر ساندويتش الجنوبية', 'جيبوتي', 'جيرسي',
+        'دومينيكا',
+        'رواندا', 'روسيا', 'روسيا البيضاء', 'رومانيا', 'روينيون',
+        'زامبيا', 'زيمبابوي',
+        'ساحل العاج', 'ساموا', 'ساموا الأمريكية', 'سانت بيير وميكولون', 'سانت فنسنت وغرنادين', 'سانت كيتس ونيفيس', 'سانت لوسيا', 'سانت مارتين', 'سانت هيلنا', 'سان مارينو', 'ساو تومي وبرينسيبي', 'سريلانكا', 'سفالبارد وجان مايان', 'سلوفاكيا', 'سلوفينيا', 'سنغافورة', 'سوازيلاند', 'سوريا', 'سورينام', 'سويسرا', 'سيراليون', 'سيشل',
+        'شرق آسيا', 'شرق افريقيا', 'شرق أوروبا', 'شمال افريقيا', 'شمال أمريكا', 'شمال أوروبا', 'شيلي',
+        'صربيا', 'صربيا والجبل الأسود',
+        'طاجكستان',
+        'عمان',
+        'غامبيا', 'غانا', 'غرب آسيا', 'غرب افريقيا', 'غرب أوروبا', 'غويانا', 'غيانا', 'غينيا', 'غينيا الاستوائية', 'غينيا بيساو',
+        'فانواتو', 'فرنسا', 'فلسطين', 'فنزويلا', 'فنلندا', 'فيتنام', 'فيجي',
+        'قبرص', 'قرغيزستان', 'قطر',
+        'كازاخستان', 'كاليدونيا الجديدة', 'كرواتيا', 'كمبوديا', 'كندا', 'كوبا', 'كوريا الجنوبية', 'كوريا الشمالية', 'كوستاريكا', 'كولومبيا', 'كومنولث الدول المستقلة', 'كيريباتي', 'كينيا',
+        'لاتفيا', 'لاوس', 'لبنان', 'لوكسمبورج', 'ليبيا', 'ليبيريا', 'ليتوانيا', 'ليختنشتاين', 'ليسوتو',
+        'مارتينيك', 'ماكاو الصينية', 'مالطا', 'مالي', 'ماليزيا', 'مايوت', 'مدغشقر', 'مصر', 'مقدونيا', 'ملاوي', 'منغوليا', 'موريتانيا', 'موريشيوس', 'موزمبيق', 'مولدافيا', 'موناكو', 'مونتسرات', 'ميانمار', 'ميكرونيزيا', 'ميلانيزيا',
+        'ناميبيا', 'نورو', 'نيبال', 'نيجيريا', 'نيكاراجوا', 'نيوزيلاندا', 'نيوي',
+        'هايتي', 'هندوراس', 'هولندا', 'هونج كونج الصينية',
+        'وسط آسيا', 'وسط افريقيا',
+    ];
+
+    protected static $cityFormats = [
+        '{{cityPrefix}} {{cityName}}',
+        '{{cityName}}',
+    ];
+
+    protected static $streetNameFormats = [
+        '{{streetPrefix}} {{firstName}} {{lastName}}',
+    ];
+
+    protected static $streetAddressFormats = [
+        '{{buildingNumber}} {{streetName}}',
+        '{{buildingNumber}} {{streetName}} {{secondaryAddress}}',
+    ];
+
+    protected static $addressFormats = [
+        "{{streetAddress}}\n{{city}}",
+    ];
+
+    protected static $secondaryAddressFormats = ['شقة رقم. ##', 'بناية رقم ##'];
+
+    /**
+     * @example 'شرق'
+     */
+    public static function cityPrefix()
+    {
+        return static::randomElement(static::$cityPrefix);
+    }
+
+    /**
+     * @example 'عمان'
+     */
+    public static function cityName()
+    {
+        return static::randomElement(static::$cityName);
+    }
+
+    /**
+     * @example 'شارع'
+     */
+    public static function streetPrefix()
+    {
+        return static::randomElement(static::$streetPrefix);
+    }
+
+    /**
+     * @example 'شقة رقم. 350'
+     */
+    public static function secondaryAddress()
+    {
+        return static::numerify(static::randomElement(static::$secondaryAddressFormats));
+    }
+
+    /**
+     * @example 'كاليفورنيا'
+     */
+    public static function state()
+    {
+        return static::randomElement(static::$state);
+    }
+
+    /**
+     * @example 'CA'
+     */
+    public static function stateAbbr()
+    {
+        return static::randomElement(static::$stateAbbr);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_JO/Company.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace Faker\Provider\ar_JO;
+
+class Company extends \Faker\Provider\Company
+{
+    protected static $formats = [
+        '{{lastName}} {{companySuffix}}',
+        '{{companyPrefix}} {{lastName}} {{companySuffix}}',
+        '{{companyPrefix}} {{lastName}}',
+    ];
+
+    protected static $bsWords = [
+        [],
+    ];
+
+    protected static $catchPhraseWords = [
+        ['الخدمات', 'الحلول', 'الانظمة'],
+        [
+            'الذهبية', 'الذكية', 'المتطورة', 'المتقدمة', 'الدولية', 'المتخصصه', 'السريعة',
+            'المثلى', 'الابداعية', 'المتكاملة', 'المتغيرة', 'المثالية',
+        ],
+    ];
+
+    protected static $companyPrefix = ['شركة', 'مؤسسة', 'مجموعة', 'مكتب', 'أكاديمية', 'معرض'];
+
+    protected static $companySuffix = ['وأولاده', 'للمساهمة المحدودة', ' ذ.م.م', 'مساهمة عامة', 'وشركائه'];
+
+    /**
+     * @example 'مؤسسة'
+     *
+     * @return string
+     */
+    public function companyPrefix()
+    {
+        return static::randomElement(self::$companyPrefix);
+    }
+
+    /**
+     * @example 'Robust full-range hub'
+     */
+    public function catchPhrase()
+    {
+        $result = [];
+
+        foreach (static::$catchPhraseWords as &$word) {
+            $result[] = static::randomElement($word);
+        }
+
+        return implode(' ', $result);
+    }
+
+    /**
+     * @example 'integrate extensible convergence'
+     */
+    public function bs()
+    {
+        $result = [];
+
+        foreach (static::$bsWords as &$word) {
+            $result[] = static::randomElement($word);
+        }
+
+        return implode(' ', $result);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_JO/Internet.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Faker\Provider\ar_JO;
+
+class Internet extends \Faker\Provider\Internet
+{
+    protected static $userNameFormats = [
+        '{{lastNameAscii}}.{{firstNameAscii}}',
+        '{{firstNameAscii}}.{{lastNameAscii}}',
+        '{{firstNameAscii}}##',
+        '?{{lastNameAscii}}',
+    ];
+    protected static $safeEmailTld = [
+        'com', 'jo', 'me', 'net', 'org',
+    ];
+
+    protected static $tld = [
+        'biz', 'com', 'info', 'jo', 'net', 'org',
+    ];
+
+    protected static $lastNameAscii = [
+        'abbad', 'abbadi', 'abbas', 'abulebbeh', 'flefel', 'hadi', 'hamad', 'hasan', 'jabri', 'kanaan', 'karam', 'maanee', 'melhem', 'nimry', 'obaisi', 'qasem', 'qawasmee', 'rabee', 'rashwani', 'shami', 'zaloum',
+    ];
+    protected static $firstNameAscii = [
+        'abd', 'abdullah', 'ahmad', 'akram', 'amr', 'bashar', 'bilal', 'fadi', 'ibrahim', 'khaled', 'layth', 'mohammad', 'mutaz', 'omar', 'osama', 'rami', 'saleem', 'samer', 'sami', 'yazan',
+    ];
+
+    public static function lastNameAscii()
+    {
+        return static::randomElement(static::$lastNameAscii);
+    }
+
+    public static function firstNameAscii()
+    {
+        return static::randomElement(static::$firstNameAscii);
+    }
+
+    /**
+     * @example 'ahmad.abbadi'
+     */
+    public function userName()
+    {
+        $format = static::randomElement(static::$userNameFormats);
+
+        return static::bothify($this->generator->parse($format));
+    }
+
+    /**
+     * @example 'wewebit.jo'
+     */
+    public function domainName()
+    {
+        return static::randomElement(static::$lastNameAscii) . '.' . $this->tld();
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_JO/Person.php

@@ -0,0 +1,108 @@
+<?php
+
+namespace Faker\Provider\ar_JO;
+
+class Person extends \Faker\Provider\Person
+{
+    protected static $maleNameFormats = [
+        '{{firstNameMale}} {{lastName}}',
+        '{{firstNameMale}} {{lastName}}',
+        '{{firstNameMale}} {{lastName}}',
+        '{{firstNameMale}} {{lastName}}',
+        '{{titleMale}} {{firstNameMale}} {{lastName}}',
+    ];
+
+    protected static $femaleNameFormats = [
+        '{{firstNameFemale}} {{lastName}}',
+        '{{firstNameFemale}} {{lastName}}',
+        '{{firstNameFemale}} {{lastName}}',
+        '{{firstNameFemale}} {{lastName}}',
+        '{{titleFemale}} {{firstNameFemale}} {{lastName}}',
+    ];
+
+    /**
+     * @see http://muslim-names.us/
+     */
+    protected static $firstNameMale = [
+        'آدم', 'أبراهيم', 'أبو بكر', 'أحمد', 'أدهم', 'أسامة', 'أسعد', 'أسيد', 'أشرف', 'أكثم', 'أكرم', 'أمجد', 'أمين', 'أنتوني', 'أنزور', 'أنس', 'أنمار', 'أنور', 'أواس', 'أوس', 'أيمن', 'أيهم', 'أيوب', 'إبراهيم', 'إسلام', 'إسماعيل', 'إلياس', 'إياد', 'إيهاب', 'ابان', 'ابراهام', 'ابراهيم', 'ابراهيم محمد', 'اثير', 'احسان', 'احمد', 'ادريس', 'ادم', 'ادهم', 'اديب', 'ارام', 'ازاد', 'ازد', 'اسامة', 'اسحاق', 'اسحق', 'اسعد', 'اسلام', 'اسماعيل', 'اسيد', 'اشراف', 'اشرف', 'اصلان', 'اكثم', 'اكرم', 'البراء', 'البشر', 'البطوش', 'الحارث', 'الحسين', 'الحمزه', 'الطفيل', 'العزم', 'الليث', 'المؤمن بالله', 'المثنى', 'المستبد', 'المعتز', 'المعتز بالله', 'المعتصم بالله', 'المنتصر بالله', 'المنصور', 'الياس', 'اليمان', 'امجد', 'امل', 'امير', 'امين', 'اندرو', 'انس', 'انور', 'انيس', 'اوس', 'اوسم', 'اوهان', 'اويس', 'اياد', 'اياد الدين', 'اياس', 'ايسر', 'ايليا', 'ايمن', 'ايهاب', 'ايهم', 'ايوب',
+        'باجس', 'باسل', 'باسم', 'باندي', 'باهر', 'بدر', 'بدوان', 'براء', 'برنابا', 'برهان', 'بسام', 'بشار', 'بشارة', 'بشر', 'بشير', 'بطرس', 'بكر', 'بلال', 'بليغ', 'بندر', 'بهاء', 'بهاء الدين', 'بيتر',
+        'تامر', 'تحسين', 'تركي', 'تشارلي', 'تقي الدين', 'توفيق', 'تيسير', 'تيمور',
+        'ثائر', 'ثامر',
+        'جابر', 'جاد', 'جاسر', 'جاسم', 'جاك', 'جباغ', 'جبر', 'جبرائي', 'جبير', 'جراح', 'جريس', 'جعفر', 'جلال', 'جلال الدين', 'جمال', 'جمزه', 'جميل', 'جهاد', 'جواد', 'جودت', 'جورج', 'جوزيف',
+        'حابس', 'حاتم', 'حارث', 'حارثه', 'حازم', 'حازم محمد', 'حافظ', 'حاكم', 'حالد', 'حامد', 'حبيب', 'حذيفة', 'حذيفه', 'حسام', 'حسام الدين', 'حسان', 'حسن', 'حسني', 'حسين', 'حكم', 'حكمت', 'حلمي', 'حماده', 'حمد', 'حمدالله', 'حمدان', 'حمدي', 'حمزة', 'حمزه', 'حمود', 'حمودة', 'حموده', 'حميد', 'حنا', 'خالد',
+        'خضر', 'خلدون', 'خلف', 'خليفة', 'خليفه', 'خليل', 'خميس', 'خير الدين', 'خيرالله', 'خيري',
+        'دانتي', 'داني', 'دانيال', 'داود', 'داوود',
+        'ذياب', 'ذيب',
+        'رأفت', 'رؤوف', 'رئاد', 'رائد', 'رائف', 'راجح', 'راجي', 'راشد', 'راضي', 'راغب', 'رافت', 'رافع', 'رافي', 'راكان', 'رامان', 'رامز', 'رامي', 'رامين', 'ربيع', 'رجا', 'رجائي', 'رجب', 'رداد', 'رزق', 'رسلان', 'رسلان الدين', 'رشاد', 'رشبد', 'رشيد', 'رضا', 'رضوان', 'رعد', 'رغد', 'رغيد', 'ركان', 'رماح', 'رمزي', 'رمضان', 'رهاب', 'رواد', 'روحي', 'روزا', 'روني', 'رياض', 'ريان', 'ريتشارد', 'ريمون',
+        'زاهر', 'زاهي', 'زايد', 'زبد', 'زخريا', 'زكريا', 'زكي', 'زمام', 'زهدي', 'زهير', 'زياد', 'زيد', 'زيدان', 'زيدون', 'زين', 'زين العابدين', 'سائد', 'سابا', 'ساري', 'سالم', 'سامح', 'سامر', 'سامي', 'ساهر', 'سدير', 'سركيس', 'سرمد', 'سري', 'سعد', 'سعدي', 'سعود', 'سعيد', 'سفيان', 'سكوت', 'سلام', 'سلطان', 'سلمان', 'سليم', 'سليمان', 'سمؤل', 'سمعان', 'سميح', 'سمير', 'سنان', 'سند', 'سهام الدين', 'سهل', 'سهم', 'سيف', 'سيف الاسلام', 'سيف الدين', 'سيمون',
+        'شادي', 'شارلي', 'شافع', 'شاكر', 'شامان', 'شامل', 'شاهر', 'شحادة', 'شحاده', 'شربف', 'شرحبيل', 'شريف', 'شكري', 'شهاب', 'شهم', 'شوان', 'شوقي', 'شوكت',
+        'صادق', 'صافي', 'صالح', 'صبحي', 'صبره', 'صبري', 'صخر', 'صدام', 'صدقي', 'صفاء', 'صفوان', 'صقر', 'صلاح', 'صلاح الدين', 'صليبا', 'صهيب',
+        'ضرار', 'ضرغام', 'ضياء', 'ضياء الدين',
+        'طارق', 'طالب', 'طاهر', 'طلال', 'طه',
+        'عادل', 'عاصم', 'عاطف', 'عامر', 'عايد', 'عبادة', 'عباده', 'عباس', 'عبد', 'عبد الباري', 'عبد الحافظ', 'عبد الحكيم', 'عبد الحليم', 'عبد الحميد', 'عبد الحي', 'عبد الرحمان', 'عبد الرحمن', 'عبد الرحيم', 'عبد الرزاق', 'عبد السلام', 'عبد السميع', 'عبد العزيز', 'عبد العفو', 'عبد الغني', 'عبد الفتاح', 'عبد القادر', 'عبد الكريم', 'عبد اللطيف', 'عبد الله', 'عبد المجيد', 'عبد المولى', 'عبد الناصر', 'عبد الهادي', 'عبد ربه', 'عبداالله', 'عبدالاله', 'عبدالباسط', 'عبدالجليل', 'عبدالجواد', 'عبدالحليم', 'عبدالحميد', 'عبدالرؤوف', 'عبدالرحمن', 'عبدالرحيم', 'عبدالرزاق', 'عبدالسلام', 'عبدالعزيز', 'عبدالفتاح', 'عبدالقادر', 'عبدالكريم', 'عبداللطيف', 'عبدالله', 'عبدالمجيد', 'عبدالمطلب', 'عبدالمعطي', 'عبدالمهيمن', 'عبدالناصر', 'عبدالهادي', 'عبدالوهاب', 'عبدربه', 'عبده', 'عبود', 'عبيدالله', 'عبيدة', 'عتيبه', 'عثمان', 'عدب', 'عدلي', 'عدنان', 'عدوان', 'عدى', 'عدي', 'عرار', 'عربي', 'عرفات', 'عرفة', 'عرمان', 'عروة', 'عريق', 'عرين', 'عز الدين', 'عزالدين', 'عزام', 'عزت', 'عزمي', 'عزيز', 'عصام', 'عصمت', 'عطا', 'عطاالله', 'عطيه', 'عقل', 'علاء', 'علاء الدين', 'علي', 'عليان', 'عماد', 'عماد الدين', 'عمادالدين', 'عمار', 'عمر', 'عمراسامة', 'عمران', 'عمرو', 'عملا', 'عميد', 'عناد', 'عنان', 'عواد', 'عودة', 'عوده', 'عوض', 'عوف', 'عون', 'عوني', 'عيد', 'عيدالله', 'عيسى',
+        'غازي', 'غالب', 'غانم', 'غدير', 'غسان', 'غيث',
+        'فؤاد', 'فؤاس', 'فائق', 'فاخر', 'فادي', 'فارس', 'فاروق', 'فاضل', 'فايز', 'فتحي', 'فجر', 'فخرى', 'فخري', 'فرأس', 'فراس', 'فرح', 'فريد', 'فكتور', 'فلاح', 'فندي', 'فهد', 'فهمي', 'فواز', 'فوزي', 'فيصل', 'فيليب',
+        'قارس', 'قاسم', 'قبلان', 'قتاده', 'قتيبة', 'قتيبه', 'قصي', 'قيس',
+        'كاسترو', 'كاظم', 'كامل', 'كايد', 'كرم', 'كريم', 'كفاح', 'كمال', 'كنان',
+        'لؤي', 'لؤي الدين', 'لبيب', 'لطف', 'لطفي', 'لورنس', 'لويس', 'ليث', 'ليث الدين', 'ليليان',
+        'مأمون', 'مؤتمن', 'مؤثر', 'مؤمن', 'مؤنس', 'مؤيد', 'ماجد', 'مارتن', 'مارسيل', 'مازن', 'مالك', 'مامون', 'ماهر', 'مبارك', 'مثنى', 'مجاهد', 'مجد', 'مجدي', 'مجمد', 'محسن', 'محمد‏ ‏', 'محمود', 'محي', 'محي الدين', 'مختار', 'مخلص', 'مدحت', 'مدين', 'مراد', 'مرشد', 'مرهف', 'مروان', 'مسعد', 'مسعود', 'مسلم', 'مشاري', 'مشعل', 'مشهور', 'مشيل', 'مصباح', 'مصطغى', 'مصطفى', 'مصطفي', 'مصطلفى', 'مصعب', 'مضر', 'مطيع', 'مظفر', 'مظهر', 'معاد', 'معاذ', 'معاوية', 'معاويه', 'معتز', 'معتصم', 'معمر', 'معن', 'معنصم', 'معويه', 'معين', 'مفدي', 'مفلح', 'مقداد', 'مكين', 'ملهم', 'ممدوح', 'مناف', 'منتصر', 'منح', 'منذر', 'منصف', 'منصور', 'منقذ', 'منير', 'مهاب', 'مهدي', 'مهران', 'مهند', 'موسى', 'موفق', 'مياس', 'ميسم', 'ميشيل', 'ميلاد', 'مينا',
+        'نائل', 'ناجي', 'نادر', 'نارت', 'ناصر', 'ناهض', 'نايف', 'نبراس', 'نبيل', 'نتانت', 'نجاتي', 'نجيب', 'نديم', 'نزار', 'نزال', 'نزيه', 'نسيم', 'نشات', 'نصار', 'نصر', 'نصري', 'نصوح', 'نضال', 'نظام', 'نعمان', 'نعمة', 'نعيم', 'نقولا', 'نمر', 'نهاد', 'نهار', 'نواف', 'نور', 'نور الدين', 'نورالدين', 'نورس', 'نوفان',
+        'هادي', 'هارون', 'هاشم', 'هاكان', 'هانى', 'هاني', 'هذال', 'هشام', 'هلال', 'همام', 'هملر', 'هناء', 'هيثم',
+        'وائل', 'واثق', 'واصف', 'وجدي', 'وجيه', 'وحيد', 'وديع', 'ورد', 'وسام', 'وسام الدين', 'وسن', 'وسيم', 'وصفي', 'وضاح', 'وعد', 'وفاء', 'وليد', 'وهيب',
+        'ياسر', 'ياسين', 'يامن', 'يحيى', 'يزن', 'يزيد', 'يسار', 'يشار', 'يعرب', 'يعقوب', 'يمان', 'ينال', 'يوسف', 'يونس',
+    ];
+
+    /**
+     * @see http://muslim-names.us/
+     */
+    protected static $firstNameFemale = [
+        'آثار', 'آلاء', 'آناء', 'آية', 'أبرار', 'أحلام', 'أروى', 'أريج', 'أسماء', 'أسيل', 'أصاله', 'أفنان', 'ألاء', 'أماني', 'أمل', 'أميرة', 'أنسام', 'أنطوانيت', 'أنوار', 'أيات', 'أية', 'أيناس', 'أيه', 'ؤقهسفغ', 'إباء', 'إخلاص', 'إسراء', 'إسلام', 'إكرام', 'إنعام', 'إيمان', 'إيناس', 'ابتهاج', 'ابتهال', 'ابرار', 'ابراهيم', 'اتيان', 'احسان', 'احلام', 'احمد', 'اخلاص', 'ارجوان', 'اروى', 'اريج', 'ازهار', 'اسامة', 'اسحار', 'اسرا', 'اسراء', 'اسرار', 'اسلام', 'اسما', 'اسماء', 'اسمهان', 'اسمى', 'اسيل', 'اشراق', 'اصالة', 'اعتدال', 'افراح', 'افنان', 'افيا', 'اكرام', 'الاء', 'العنود', 'الهام', 'اليان', 'اليزابيث', 'امال', 'اماندا', 'اماني', 'امل', 'امنه', 'اميرة', 'اميليا', 'امينة', 'اناهيد', 'انتظار', 'انجليكا', 'انعام', 'انوار', 'اويس', 'ايات', 'ايام', 'اية', 'ايفا', 'ايفان', 'ايفون', 'ايمان', 'ايناس', 'ايه',
+        'باسمة', 'باميلا', 'بان', 'بانا', 'بتول', 'بثينه', 'بدور', 'براء', 'براءة', 'برديس', 'بروين', 'بسمة', 'بشائر', 'بشرى', 'بلسم', 'بلقيس', 'بنان', 'بهجه', 'بيا', 'بيان', 'بيداء', 'بيسان',
+        'تالا', 'تالة', 'تالين', 'تامر', 'تانيا ماريا', 'تحرير', 'تسنيم', 'تغريد', 'تقوى', 'تقى', 'تمارا', 'تماضر', 'تمام', 'تهاني', 'تولين',
+        'ثريا',
+        'جاسمن', 'جالا', 'جلنار', 'جمانا', 'جمانة', 'جميلة', 'جنى', 'جهاد', 'جوانا', 'جود', 'جورجيت', 'جوسيت', 'جولييت', 'جيانا', 'جيسيكا',
+        'حبيبة', 'حسناء', 'حصه', 'حلا', 'حليمة', 'حنان', 'حنين', 'حياة',
+        'ختام', 'خديجه', 'خلود', 'خولة',
+        'دارين', 'داليا', 'دالية', 'دانا', 'دانا كريستيل جميلة', 'دانة', 'دانية', 'دانييل', 'دبنا', 'دعاء', 'دعد', 'دلال', 'دنى', 'دنيا', 'دولا', 'ديالا', 'ديان', 'ديانا', 'ديما', 'دينا',
+        'رؤى', 'رؤيه', 'رابعة', 'راغدة', 'راما', 'رانا', 'راندي', 'رانيا', 'راوية', 'راية', 'ربا', 'رباب', 'ربى', 'رجاء', 'رحمة', 'رحمه', 'ردينة', 'رزان', 'رشا', 'رغد', 'رغدة', 'رفاعية', 'رفاه', 'رقية', 'رقيه', 'رلى', 'رمال', 'رنا', 'رناد', 'رند', 'رنده', 'رنيم', 'رنين', 'رهام', 'رهف', 'رواء', 'روان', 'روبينا', 'روتانا', 'روحية', 'رودا', 'روزان', 'روزانا', 'روزين', 'رولى', 'روند', 'رويدة', 'ريان', 'ريتا', 'ريم', 'ريما', 'ريمان', 'ريناتا', 'ريناد', 'ريهام',
+        'زكية', 'زمان', 'زها', 'زهرة', 'زين', 'زينا', 'زينات', 'زينب', 'زينة', 'ساجدة', 'ساجده', 'سارة', 'سارين', 'سالي', 'ساندرا', 'ساندي', 'سباتا', 'سجى', 'سحر', 'سدين', 'سرى', 'سرين', 'سعاد', 'سكينة', 'سلام', 'سلسبيل', 'سلمى', 'سلوى', 'سما', 'سماح', 'سماره', 'سمر', 'سمية', 'سميره', 'سميه', 'سناء', 'سنابل', 'سندس', 'سنريت', 'سنن', 'سها', 'سهاد', 'سهام', 'سهر', 'سهى', 'سهير', 'سهيله', 'سوار', 'سوزان', 'سوزانا', 'سوسن', 'سيرين', 'سيرينا', 'سيلفا', 'سيلين', 'سيما',
+        'شدى', 'شذا', 'شذى', 'شروق', 'شريفة', 'شرين', 'شريهان', 'شفاء', 'شهد', 'شهناز', 'شيرين', 'شيماء',
+        'صابرين', 'صالح', 'صبا', 'صباح', 'صباحت', 'صبرين', 'صحر', 'صفا', 'صفاء', 'صفية', 'صمود',
+        'ضحى', 'ضياء',
+        'عائشة', 'عاليا', 'عالية', 'عايشة', 'عبلة', 'عبير', 'عدله', 'عرين', 'عزة', 'عزيزة', 'عفاف', 'علا', 'علياء', 'عنود', 'عهد',
+        'غادة', 'غدير', 'غرام', 'غزل', 'غصون', 'غفران', 'غنى', 'غيد', 'غيداء', 'غيده', 'غيفار',
+        'فاتن', 'فادية', 'فاديه', 'فاطمة', 'فايزة', 'فتحية', 'فتحيه', 'فتنه', 'فداء', 'فدوى', 'فدى', 'فرح', 'فريال', 'فريدة', 'فوزية', 'فيروز', 'فيفيان',
+        'قمر',
+        'كاترين', 'كاتيا', 'كارلا', 'كرستينا', 'كريستين', 'كريستينا', 'كلوديت', 'كلودين', 'كوثر', 'كيان',
+        'لارا', 'لاري', 'لانا', 'لبنا', 'لجين', 'لطيفة', 'لمى', 'لميس', 'لنا', 'لورا', 'لورينا', 'لوسانا', 'لوسينا', 'لونا', 'ليان', 'ليدا', 'ليلى', 'ليليان', 'لين', 'لينا', 'لينة', 'ليندا', 'لينه',
+        'مادلين', 'ماري', 'ماريا', 'ماريان', 'مارينا', 'مايا', 'مجد', 'مجدولين', 'محبوبة', 'مديحة', 'مرام', 'مرح', 'مروة', 'مريام', 'مريانا', 'مريم', 'مسعدة', 'مشيرة', 'معالي', 'ملاك', 'ملك', 'منار', 'منال', 'منى', 'مها', 'مهتاب', 'مي', 'ميادة', 'مياده', 'ميار', 'ميان', 'ميرا', 'ميرال', 'ميران', 'ميرفت', 'ميرنا', 'ميريت', 'ميس', 'ميسا', 'ميساء', 'ميسر', 'ميسره', 'ميسم', 'ميسون', 'ميلاء', 'ميناس',
+        'نائله', 'ناتاشا', 'ناتالي', 'ناديا', 'نادية', 'نادين', 'ناديه', 'ناردين', 'ناريمان', 'نانسي', 'نبال', 'نبراس', 'نبيله', 'نجاة', 'نجاح', 'نجلاء', 'نجوان', 'نجود', 'نجوى', 'نداء', 'ندى', 'ندين', 'نرمين', 'نزميه', 'نسرين', 'نسيمة', 'نعمت', 'نعمه', 'نهاد', 'نهى', 'نهيدة', 'نوال', 'نور', 'نور الهدى', 'نورا', 'نوران', 'نيروز', 'نيفين',
+        'هادلين', 'هازار', 'هالة', 'هانيا', 'هايدي', 'هبة', 'هدايه', 'هدى', 'هديل', 'هزار', 'هلا', 'هلين', 'هنا', 'هناء', 'هنادا', 'هنادي', 'هند', 'هيا', 'هيفا', 'هيفاء', 'هيلين',
+        'وئام', 'وجدان', 'وداد', 'ورود', 'وسام', 'وسن', 'وسيم', 'وعد', 'وفاء', 'ولاء',
+        'ىمنة', 'يارا', 'ياسمين', 'يافا', 'يسرى', 'ينان', 'ﻟﻮﺗﺸﻴﺎ',
+    ];
+
+    protected static $lastName = [
+        'آلهامي', 'أبو الرب', 'ابو رحمة', 'ابو سعده', 'ابو يوسف', 'ابوالحاج', 'الامام', 'البتراء', 'البلبيسي', 'الترابين', 'التلهوني', 'الجبارات', 'الجرَّاح', 'الجوابره', 'الجوالدة', 'الحجايا', 'الحوراني', 'الدعجة', 'الردايدة', 'الرشدان', 'الرفاعي', 'الروابدة', 'الروسان', 'الريماوي', 'الزعبية', 'الزوربا', 'السحاقات', 'السحيمات', 'السراج', 'السعد', 'السلطية', 'السيوف', 'الشامي', 'الشريدة', 'الشريف', 'الشطناوي', 'الشمالي', 'الصرايرة', 'الصمادي', 'الصنات', 'الضمور', 'الطباع', 'الطراونة', 'الطويسات', 'الطويل', 'العدوان', 'العضيبات', 'العلامي', 'العمري', 'العمرية', 'العناسوة', 'العنانبه', 'الغريب', 'الفاخوري', 'الفاعوري', 'الفناطسة', 'القطيشات', 'الكردي', 'الكركي', 'المبيضين', 'المجالي', 'المحاميد', 'المساعيد', 'المشاهره', 'المصري', 'المعشر', 'المواجدة', 'المومنى', 'المومنية', 'النسور', 'النشاشيبي', 'النعيمات', 'الهلسة', 'الوشاح',
+        'بني حسن', 'بني صقر',
+        'سحاب',
+        'شمر',
+        'ضميدات',
+        'طلفاح',
+        'عابدين', 'عباد', 'عجلون', 'عقلة', 'عناسوة',
+        'مطير', 'معاني',
+        'وادي',
+    ];
+
+    protected static $titleMale = ['السيد', 'الأستاذ', 'الدكتور', 'المهندس'];
+    protected static $titleFemale = ['السيدة', 'الآنسة', 'الدكتورة', 'المهندسة'];
+    private static $prefix = ['أ.', 'د.', 'أ.د', 'م.'];
+
+    /**
+     * @example 'أ.'
+     */
+    public static function prefix()
+    {
+        return static::randomElement(static::$prefix);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_JO/Text.php

@@ -0,0 +1,272 @@
+<?php
+
+namespace Faker\Provider\ar_JO;
+
+class Text extends \Faker\Provider\Text
+{
+    protected static function validStart($word)
+    {
+        return preg_match('/^\p{Arabic}/u', $word);
+    }
+
+    /**
+     * License: Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
+     *
+     * Title: حي بن يقظان
+     * Author: ابن الطفيل
+     * Language: Arabic
+     *
+     * @see https://ar.wikisource.org/wiki/%D8%A7%D8%A8%D9%86_%D8%A7%D9%84%D8%B7%D9%81%D9%8A%D9%84_-_%D8%AD%D9%8A_%D8%A8%D9%86_%D9%8A%D9%82%D8%B8%D8%A7%D9%86
+     *
+     * @var string
+     */
+    protected static $baseText = <<<'EOT'
+ذكر سلفنا الصالح - رضي الله عنهم - أن جزيرة من جزائر الهند التي تحت خط الاستواء، وهي الجزيرة التي يتولد بها الإنسان من غير أم ولا أب، وبها شجر يثمر نساء، وهي التي ذكر المسعودي أنها جزيرة الوقواق لان تلك الجزيرة اعدل بقاع الأرض هواء؛ أتممها لشروق النور الأعلى عليها استعدادً، وان كان ذلك خلاف ما يراه جمهور الفلاسفة وكبار الأطباء، فانهم يرون إن اعدل ما في المعمورة الإقليم الرابع، فان كانوا قالوا ذلك لأنه صح عندهم انه ليس على خط الاستواء عمارة لمانع من الموانع الأرضية، فلقولهم: أن الإقليم الرابع اعدل بقاع الأرض وجه، وان كانوا إنما أرادوا بذلك إن ما على خط الاستواء شديد الحرارة، كالذي يصرح به أكثرهم فهو خطأ يقوم البرهان على خلافه.
+
+وذلك أنه قد تبرهن في العلوم الطبيعية أنه لا سبب لتكون الحرارة إلا الحركة أو ملاقاة الأجسام الحارة والإضاءة؛ وتبين فيها أيضاً إن الشمس بذاتها غير حارة ولا متكيفة بشيء من هذه الكيفيات المزاجية؛ وقد تبين فيها أيضاً إن الأجسام التي تقبل الإضاءة أتم القبول، هي الأجسام الصقيلة غير الشفافة، ويليها في قبول ذلك الأجسام الكثيفة غير الصقيلة، فأما الأجسام الشفافة التي لاشيء فيها من الكثافة فلا تقبل الضوء بوجه.
+
+وهذا وحده مما برهنه الشيخ أبو علي خاصة، ولم يذكره من تقدمه، فإذا صحت هذه المقدمات، فاللازم عنها أن الشمس لا تسخن الأرض كما تسخن الأجسام الحارة أجسام أخر تماسها، لان الشمس في ذاتها غير حارة ولا الأرض أيضاً تسخن بالحركة لأنها ساكنة وعلى حالة واحدة في شروق الشمس عليها وفي وقت مغيبها عنها وأحوالها في التسخين والتبريد، ظاهرة الاختلاف للحس في هذين الوقتين.
+
+ولا الشمس أيضاً تسخن الهواء أولاً ثم تسخن بعد ذلك الأرض بتوسط سخونة الهواء، وكيف يكون ذلك ونحن نجد أن ما قرب من الهواء من الأرض في وقت الحر، أسخن كثيراً من الهواء الذي يبعد منه علواً؟ فبقي أن تسخين الشمس للأرض إنما هو على سبيل الإضاءة لا غير، فان الحرارة تتبع الضوء أبداً: حتى إن الضوء إذا افرط في المرأة المقعرة، أشعل ما حاذاها.
+
+وقد ثبت في علوم التعاليم بالبراهين القطعية، أن الشمس كروية الشكل، وأن الأرض كذلك، وأن الشمس أعظم من الأرض كثيراً، وأن الذي يستضيء من الشمس أبداً هو أعظم من نصفها، وأن هذا النصف المضيء من الأرض في كل وقت أشد ما يكون الضوء في وسطه، لأنه أبعد المواضع من المظلمة، ولأنه يقابل من الشمس أجزاءاً أكثر، وما قرب من المحيط كان أقل ضوءاً حتى ينتهي إلى الظلمة عند محيط الدائرة الذي ما أضاء موقعه من الأرض قط، وإنما يكون الموضع وسط دائرة الضياء إذا كانت الشمس على سمت رؤوس الساكنين فيه، وحينئذ تكون الحرارة في ذلك الموضع أشد ما يكون فان كان الموضع مما تبعد الشمس عن مسامتة رؤوس أهله، كان شديد البرودة جداً، وان كان مما تدوم فيه المسامتة كان شديد الحرارة، وقد ثبت في علم الهيئة أن بقاع الأرض التي على خط الاستواء لا تسامت الشمس رؤوس أهلها سوى مرتين في العام: عند حلولها برأس الحمل؛ وعند حلولها برأس الميزان.
+
+وهي في سائر العام ستة أشهر جنوباً منهم، وستة أشهر شمالاً منهم: فليس عندهم حر مفرط، ولا برد مفرط. وأحوالهم بسبب ذلك متشابهة.
+
+وهذا القول يحتاج إلى بيان أكثر من هذا، لا يليق بما نحن بسبيله؛ وإنما نبهناك عليه، لأنه من الأمور التي تشهد بصحة ما ذكر من تجويز تولد الإنسان بتلك البقعة من غير أم ولا أب.
+
+فمنهم من بت الحكم وجزم القضية بأن حي بن يقظان من جملة من تكون في تلك البقعة من غير أم ولا أب، ومنهم من أنكر ذلك وروى من أمره خبراً نقصه عليك، فقال: انه كان بازاء تلك الجزيرة، جزيرة عظيمة متسعة الأكتاف، كثيرة الفوائد، عامرة بالناس، يملكها رجل منهم شديد الأنفة والغيرة، وكانت له أخت ذات جمال وحسن باهر فعضلها ومنعها الأزواج إذا لم يجد لها كفواً. وكان له قريب يسمى يقظان فتزوجها سراً على وجه جائز في مذهبهم المشهور في زمنهم.
+
+ثم إنها حملت منه ووضعت طفلاً. فلما خافت أن يفتضح أمرها وينكشف سرها، وضعته في تابوت أحكمت زمه بعد أن أروته من الرضاع؛ وخرجت به في أول الليل في جملة من خدمها وثقاتها إلى ساحل البحر، وقلبها يحترق صبابةً به، وخوفاً عليه، ثم إنها ودعته وقالت: "اللهم انك خلقت هذا الطفل ولم يكن شيئاً مذكوراً، ورزقته في ظلمات الأحشاء، وتكفلت به حتى تم واستوى. وأنا قد سلمته إلى لطفك، ورجوت له فضلك، خوفاً من هذا الملك الغشوم الجبار العنيد.
+
+فكن له، ولا تسلمه، يا أرحم الراحمين" ثم قذفت به في اليم. فصادف ذلك جري الماء بقوة المد، فاحتمله من ليلته إلى ساحل الجزيرة الأخرى المتقدم ذكرها. وكان المد يصل في ذلك الوقت إلى موضع لا يصل إليه بعد علم. فأدخله الماء بقوته إلى أجمة ملتفة الشجر عذبة التربة، مستورة عن الرياح والمطر، محجوبة عن الشمس تزاور عنها إذا طلعت، وتميل إذا غربت. ثم أخذ الماء في الجزر.
+
+وبقي التابوت في ذلك الموضع، وعلت الرمال بهبوب الرياح، وتراكمت بعد ذلك حتى سدت مدخل الماء إلى تلك الأجمة. فكان المد لا ينتهي إليها، وكانت مسامير التابوت قد فلقت، وألواحه قد اضطربت عند رمي الماء في تلك الأجمة. فلما أشتد الجوع بذلك الطفل، بكى واستغاث وعالج الحركة، فوقع صوته في أذن ظبية فقدت طلاها، خرج من كناسه فحمله العقاب، فلما سمعت الصوت ظنته ولدها.
+
+فتتبعت الصوت وهي تتخيل طلاها حتى وصلت إلى التابوت، ففحصت عنه بأظلافها وهو ينوء ويئن من داخله، حتى طار عن التابوت لوح من أعلاه. فحنت الظبية وحنت عليه ورئفت به، وألقمه حلمتها وأروته لبناً سائغاً. ومازالت تتعهده وتربيه وتدفع عنه الأذى. هذا ما كان من ابتداء أمره عند من ينكره التولد. ونحن نصف هنا كيف تربى وكيف أنتقل في أحواله حتى يبلغ المبلغ العظيم. وأما الذين زعموا أنه تولد من الأرض فانهم قالوا إن بطناً من أرض تلك الجزيرة تخمرت فيه طينه على مر السنين والأعوام، حتى امتزج فيها الحار بالبارد، والرطب باليابس، امتزاج تكافؤ وتعادل في القوى. وكانت هذه الطينة المتخمرة كبيرة جداً وكان بعضها يفضل بعضاً في اعتدال المزاج والتهيؤ لتكون الأمشاج.
+
+وكان الوسط منها أعدل ما فيها وأتمه مشابهة بمزاج الإنسان: فتمخضت تلك الطينة، وحدث فيها شبه نفاخات الغليان لشدة لزوجتها: وحدث في الوسط منها لزوجة ونفاخة صغيرة جداً، منقسمة بقسمين، بينها حجاب رقيق، ممتلئة بجسم لطيف هوائي في غاية من الاعتدال اللائق به، فتعلق به عند ذلك الروح الذي هو من أمر الله تعالى وتشبث به تشبثاً يعسر انفصاله عنه عند الحس وعند العقل؛ إذ قد تبين أن هذا الروح دائم الفيضان من عند الله عز وجل، وأنه بمنزلة نور الشمس الذي هو دائم الفيضان على العالم.
+
+فمن الأجسام ما لا يستضيء به، وهو الهواء الشفاف جداً؛ ومنها ما يستضيء به بعض الاستضاءة، وهي الأجسام الكثيفة غير الصقيلة وهذه تختلف في قبول الضياء، وتختلف بحسب ذلك ألوانها، ومنها ما يستضيء به غاية الاستضاءة وهي الأجسام الصقيلة كالمرأة ونحوها.
+
+فإذا كانت هذه المرأة مقعرة على شكل مخصوص، حدث فيها النار لإفراط الضياء. الذي هو الروح، الذي هو من أمر الله تعالى، فياض أبداً على جميع الموجودات؛ فمنها ما لا يظهر أثره فيه اعدم الأستعداد، وهي الجمادات التي لا حياة لها، وهذه بمنزلة الهواء في المثال المتقدم، ومنها ما يظهر أثره فيه، وهي أنواع النبات بحسب استعداداتها وهذه بمنزلة الأجسام الكثيفة في المثال المتقدم؛ ومنها ما يظهر أثره فيه ظهوراً كثيراً، وهي الأجسام الصقيلة في المثال المتقدم.
+
+ومن هذه الأجسام الصقيلة ما يزيد على شدة قبوله لضياء الشمس أنه يحكي صورة الشمس، ومثالها. وكذلك أيضاً من الحيوان ما يزيد على شدة قبوله للروح أنه يحكي الروح ويتصور بصورته وهو الإنسان خاصة.
+
+واليه الإشارة بقوله صلى الله عليه وسلم: "إن الله خلق أدم على صورته". فان قويت في هذه الصورة حتى تتلاشى جميع الصور في حقها، وتبقى هي وحدها، وتحرق سبحات نورها كل ما أدركته، كانت حينئذ بمنزلة المرأة المنعكسة على نفسها المحرقة لسوها وهذا لا يكون إلا للأنبياء صلوات الله عليهم أجمعين. وهذا كله مبين في مواضعه اللائقة به، فليرجع إلى تمام ما حكوه من وصف ذلك التخلق.
+
+قالوا: فلما تعلق هذا الروح بتلك القرارة، خضعت له جميع القوى وسجدت له وسخرت بأمر الله تعالى في كمالها، فتكون بازاء تلك القرارة نفاخة أخرى منقسمة إلى ثلاث قرارت بينهما حجب لطيفة، ومسالك نافذة، وامتلأت بمثل ذلك الهوائي الذي امتلأت منه القرارة الأولى؛ إلا أنه ألطف منه. وفي هذه البطون الثلاثة المنقسمة من واحد، طائفة من تلك القوى التي خضعت له وتوكلت بحراستها والقيام عليها، وإنهاء ما يطرأ فيها من دقيق الأشياء وجليلها إلى الروح الأول المتعلق بالقرارة الأولى.
+
+وتكون بازاء هذه القرارة من الجهة المقابلة للقراءة الثانية، نفاخة ثالثة مملوءة جسماً هوائياً، إلا أنه أغلظ من الأولين وسكن في هذه القرارة فريق من تلك القوى الخاضعة، وتوكلت بحفظها و القيام عليها؛ فكانت هذه القرارة الأولى والثانية والثالثة، أول ما تخلق من تلك الطينة المتحمرة على الترتيب الذي ذكرناه. واحتاج بعضها إلى بعض: فالأولى منها حاجتها إلى الآخرين، حاجة استخدام وتسخير.
+
+والأخريان حاجتهما إلى الأولى حاجة المرؤوس إلى الرئيس، والمدبر إلى المدبر؛ وكلاهما لما يتخلق بعدهما من الأعضاء رئيس لا مرؤوس. وأحدهما، وهو الثاني، أتمم رئاسة من الثالث فالأول منهما لما تعلق به الروح، واشتعلت حرارته تشكل بشكل النار لصنوبري وتشكل أيضاً الجسم الغليظ المحدق به على شكله، وتكون لحماً صلباً، وصار عليه غلاف صفيق يحفظه وسمي العضو كله قلباً واحتاج لما يتبع الحرارة من التحليل وافناء الرطوبات إلى شيء يمده ويغذوه، ويخلف ما تحلل منه على الدوام، وإلا لم يطل بقاؤه، واحتاج أيضاً إلى تحسس بما يلائمه فيجذبه، وبما يخالفه فيدفعه. فتكفل له العضو الواحد بما فيه من القوى التي أصلها منه بحاجته الواحدة، وتكفل له العضو الآخر بحاجته الأخرى.
+
+وكان المتكفل بالحس هو الدماغو المتكفل بالغذاء هو الكبد؛ واحتاج كل واحد من هذين إليه في أن يمدها بحرارته، وبالقوى المخصوصة بهما التي أصلها منه ، فانتسجت بينهما لذلك كله مسالك وطرق: بعضها أوسع من بعض بحسب ما تدعواليه الضرورة، فكانت الشرايين و العروق. وصفه الطبيعيون في خلقة الجنين في الرحم، لم يغادروا من ذلك شيئاً، إلى أن كمل خلقه، وتمت أعضاؤه، وحصل في حد خروج الجنين من البطن، واستعانوا في وصف كمال ذلك بتلك الطينة الكبيرة المتخمرة، وأنها كانت قد تهيأت لان يتخلق منها كل ما يحتاج إليه في خلق الإنسان من الأغشية المجللة لجملة بدنه وغيرها فلما كمل انشقت عنه تلك الأغشية، بشبه المخاض، وتصدع باقي الطينة إذ كان قد لحقه الجفاف.
+
+ثم استغاث ذلك الطفل عند فناء مادة غذائه واشتداد جوعه، فلبته ظبية فقدت طلاها. ثم استوى عبد ما وصفه هؤلاء بعد هذا الموضع، وما وصفه الطائفة الأولى في معنى التربية؛ فقالوا جميعاً: إن الظبية التي تكفلت به وافقت خصباً ومرعى أثيثاً، فكثر لحمها وكثر لبنها، حتى قام بغذاء ذلك الطفل أحسن قيام. وكانت معه لا تبعد عنه إلا لضرورة الرعي. وألف الطفل تلك الظبية حتى كان بحيث إذا هي أبطأت عنه اشتد بكاؤه فطارت إليه.
+
+ولم يكن بتلك الجزيرة شيء من السباع العادية، فتربى الطفل ونما واغتذى بلبن تلك الظبية إلى أن تم له حولان، وتدرج في المشي وأثغر فكان يتبع تلك الظبية، وكانت هي ترفق به و ترحمه وتحمله إلى مواضع فيها شجر مثمر فكانت تطعمه ما تساقط من ثمراتها الحلوة النضيجة؛ وما كان منها صلب القشر كسرته له بطواحنها؛ ومتى عاد إلى اللبن أروته، ومتى ظمئ إلى الماء أرودته، متى ضحا ظللته؛ ومتى خصر أدفأته.
+
+وإذا جن الليل صرفته إلى مكان الأول وجللته بنفسها وبريش كان هناك؛ مما ملئ به التابوت أولاً في وقت وضع الطفل فيه. وكان في غدوهما ورواحهما قد ألفهما ربرب يسرح ويبيت معهما حيث مبيتهما. فما زال الطفل مع الظباء على تلك الحال: يحكي نغمتها بصوته حتى لا يكاد يفرق بينهما؛ وكذلك كان يحكي جميع ما يسمعه من أصوات الطير وأنواع سائر الحيوان محاكاة شديدة لقوة انفعاله لما يريده ما كانت محاكاته لأصوات الظباء في الاستصراخ والاستئلاف والاستدعاء والاستدفاع. إذ للحيوانات في هذه الأحوال المختلفة أصوات مختلفة فألفته الوحوش وألفها؛ ولم تنكره ولا أنكرها.
+
+فلما ثبت في نفسه أمثلة الأشياء بعد مغيبها عن مشاهدته، حدث له نزوغ إلى بعضها؛ وكراهية لبعض. وكان في ذلك كله ينظر إلى جميع الحيوانات فيراها كاسية بالاوبار و الأشعار و أنواع الريش، وكان يرى ما لها من العدو وقوة البطش، وما لها من الأسلحة المعدة لمدافعة من ينازعها، مثل القرون و الأنياب و الحوافر و الصياصي و المخالب. ثم يرجع إلى نفسه، فيرى ما به من العري وعدم السلاح، وضعف العدو، وقلة البطش، عندما كانت تنازعه الوحوش أكل الثمرات، وتستبد بها دونه، وتغلبه عليها، فلا يستطيع المدافعة عن نفسه، ولا الفرار عن شيء منها. وكان يرى أترابه من أولاد الظباء، قد تبتت لها قرون، بعد أن لم تكن، وصارت قوية بعد ضعفها في العدو.
+
+ولم ير لنفسه شيئاً من ذلك فكان يفكر في ذلك ولا يدري ما سببه. وكان ينظر إلى ذوي العاهات والخلق الناقص فلا يجد لنفسه شبيهاً فيهم. وكان أيضاً ينظر إلى مخارج الفضول من سائر الحيوانات، فيراها مستورة: أما مخرج أغلظ الفضلتين فبالاذناب، وأما مخرج وأما مخرج أرقهما فبالاوبار وما أشبههما. ولأنها كانت أيضاً اخفى قضباناً منه. فكان ذلك ما يكربه ويسؤه.
+
+فلما طال همه في ذلك كله، وهو قد قارب سبعة اعوام، ويئس من أن يكمل له ما قد أضر به نقصه، اتخذ من أوراق الشجر العريضة شيئاً جعل بعضه خلفه و بعضه قدمه، وعمل من الخوض والحلفاء شبه حزام على وسطه، علق به تلك الأوراق فلم يلبث إلا يسيراً حتى ذوى ذلك الورق وجف وتساقط. فما زال يتخذ غيره ويخصف بعضه ببعض طاقات مضاعفة، وربما كان ذلك أطول لبقائه إلا انه على كل حال قصير المدة.
+
+واتخذ من أغصان الشجر عصياً وسوى أطرافها وعدل متنها. وكان بها على الوحوش المنازعة له، فيحمل على الضعيف منها، ويقاوم القوي منها، فنبل بذلك قدره عند نفسه بعض نباله، ورأى أن ليده فضلاً كثيراً على أيديها: إذ أمكن له بها ستر عورته واتخاذ العصي التي يدافع بها عن حوزته، ما استغنى به عما أراده من الذنب والعذاب الطبيعي. وفي خلال ذلك ترعرع واربى على السبع سنين، وطال به العناء في تجديد الأوراق التي كان يستتر بها.
+
+فكانت نفسه عند ذلك تنازعه إلى اتخاذ ذنب من ذنوب الوحوش الميتة ليعلقه على نفسه، إلا أنه كان يرى أحياء الوحوش تتحامى ميتها وتفر عنه فلا يتأتى له الأقدام على ذلك الفعل، إلى أن صادف في الأيام نسراً ميتاً فهدي إلى نيل أمله منه، واغتنم الفرصة في، إذ لم ير للوحوش عنه نفرةً فأقدم عليه، وقطع جناحيه وذنبه صحاحاً كما هي، وفتح ريشها وسواها، وسلخ عنه سائر جلده، وفصله على قطعتين: ربط إحداهما على ظهره، وأخرى على سرته وما تحتها، وعلق الذنب من خلفه، وعلق الجناحين على عضديه، فأكسبه ذلك ستراً ودفئاً ومهابة في نفوس جميع الوحوش، حتى كانت لا تنازعه ولا تعارضه. فصار لايدنو إليه شيء منها سوى الظبية التي كانت أرضعته وربته: فانها لم تفارقه ولا فارقها، إلى أن اسنت وضعغت، فكان يرتاد بها المراعي الخصبة ويجتني لها الثمرات الحلوة، ويطعمها.
+
+ومازل الهزل والضعف يستولي عليها ويتوالى، إلى أن أدركها الموت، فسكنت حركاتها بالجملة، وتعطلت جميع أفعالها. فلما رأها الصبي على تلك الحالة، جزع جزعاً شديداً، وكادت نفسه تفيض أسفاً عليها. فكان يناديها بالصوت الذي كانت عادتها أن تجيبه عند سماعه، ويصيح بأشد ما يقدر عليه، فلا لها عند ذلك حركة ولا تغييراً. فكان ينظر إلى أذنيها والى عينيها فلا يرى بها آفة ظاهرة، وكذلك كان ينظر إلى جميع أعضائها فلا يرى بشيء منها آفة.
+
+فكان يطمع إن يعثر على موضع الآفة فيزيلها عنها، فترجع إلى ما كانت عليه فلم ياتت له شيء من ذلك ولا استطاعة. وكان الذي أرشده لهذا الرأي ما كان قد اعتبره في نفسه قبل ذلك: لانه كان يرى انه إذا غمض عينيه أو حجبهما بشيء لا يبصر حتى نزول ذلك العائق، وكذلك كان يرى انه اذا ادخل إصبعه في أذنيه وسدها لا يسمع شيئاً حتى يزول ذلك العارض، وإذا امسك أنفه بيده لا يشم شيئاً من الروائح حتى يفتح أنفه. فاعتقد من اجل ذلك إن جميع ماله من الادراكات و الأفعال قد تكون لها عوائق تعوقها، فإذا أزيلت العوائق عادت الأفعال.
+
+فلما نظر إلى جميع أعضاء الظاهرة ولم ير فيها آفة ظاهرة - وكان يرى مع ذلك العطلة قد اشتملها ولم يختص بها عضو دون عضو - وقع في خاطرة أن الآفة التي نزلت بها، إنما هي العضو غائب عن العيان مستكن في باطن الجسد، وان ذلك العضو لا يغني عنه في فعله شيء من هذه الأعضاء الظاهرة. فلما نزلت به الآفة عمت المضرة، وشملت العطلة، وطمع لو أنه عثر على ذلك العضو وأزال عنه ما يزال به لاستقامت أحواله وفاض على سائر البدن نفعه، وعادت الأفعال إلى ما كانت عليه.
+
+وكان قد شاهد قبل ذلك في الأشباح الميتة من الوحوش وسواها أن جميع أعضائها مصمتة لا تجويف فيها إلا القحف، والصدر، والبطن. فوقع في نفسه أن العضو الذي بتلك الصفة لن يعدو أحد هذه المواضع الثلاثة، وكان يغلب على ظنه غلبة قوية أنه إنما هو في الموضع المتوسط من هذه المواضع الثلاثة، إذ استقر في نفسه أن جميع الأعضاء محتاجة إليه، وأن الواجب بحسب ذلك أن يكون مسكنه في الوسط.
+
+وكان أيضاً إذا رجع إلى ذاته، شعر بمثل هذا العضو في صدره لانه كان يعترض سائراً اعضائه كاليد، والرجل، والأذن، والانف، والعين، ويقدر مفارقتها، فيتاى له أنه كان يستغني عنها، وكان يقدر في رأسه مثل ذلك ويظن أنه يستغني عنه، فإذا فكر في الشيء الذي يجده في صدره، لم يتأت له الاستغناء عنه طرفة عين.
+
+وكذلك كان عند محاربته للوحوش أكثر ما كان يتقي من صياصيهم على صدره، لشعوره بالشيء الذي فيه. فلما جزم الحكم بان العضو الذي نزلت به الآفة إنما هو في صدورها، اجمع على البحث عليه والتنقير عنه، لعله يظفر به، ويرى آفته فيزيلها ثم انه خاف أنه يكون نفس فعله هذا أعظم من الآفة التي نزلت بها أولاً فيكون سعيه عليها. ثم أنه تفكر: هل رأى من الوحوش وسواها، من ضار في مثل تلك الحال، ثم عاد إلى مثل حاله الأول؟ فلم يجد شيئاً! فحصل له من ذلك، اليأس من رجوعها إلى حالها الأولى إن هو تركها، وبقي له بعض الرجاء في رجوعها إلى تلك الحال إن هو وجد ذلك العضو وأزال الآفة عنه. فعزم على شق صدرها وتفتيش ما فيه، فاتخذ من كسور الأحجار الصلدة وشقوق القصب اليابسة، أشباه السكاكين، وشق بها بين أضلاعها حتى قطع اللحم الذي بين الأضلاع، وأفضى إلى الحجاب المستبطن للأضلاع فراه قوياً، فقوي ظنه مثل ذلك الحجاب لا يكون إلا لمثل ذلك العضو وطمع بأنه إذا تجاوزه ألفى مطلوبه فحاول شقه، فصعب عليه، لعدم الآلات، ولأنها لم تكن إلا من الحجارة والقصب، فاستجدها ثانية واستحدها وتلطف في خرق الحجاب حتى انخرق له، فأفضى إلى الرئة فظن أنها مطلوبه، فما زال يقلبها ويطلب موضع الآفة بها.
+
+وكان أولاً نصفها الذي هو في الجانب الواحد. فلما راها مائلة إلى جهة واحدة، وكان قد اعتقد أن ذلك العضو لا يكون إلا في الوسط في عرض البدن، كما في الوسط في طوله. فمازال يفتش في وسط الصدر حتى ألفى القلب وهو مجلل بغشاء في غاية القوة مربوط بعلائق في غاية الوثاقة، والرثة مطيفة به من الجهة التي بدأ بالشق منها، فقال في نفسه: إن كان لهذا العضو من الجهة الأخرى مثل ما له من الجهة فهو في حقيقة الوسط، ولا محالة أنه مطلوبي. لا سيما مع ما أرى له حسن الوضع، وجمال الشكل، وقلة التشتت، وقوة اللحم، وأنه محجوب بمثل هذا الحجاب الذي لم أر مثله لشيء من الأعضاء. فبحث عن الجانب الآخر من الصدر، فوجد فيه الحجاب المستبطن للأضلاع، ووجد الرئة كمثل ما وجد من هذه الجهة.
+
+فحكم بان ذلك العضو هو مطلوبه، فحاول هتك حجابه، وشق شغافه، فبكد واستكراه ما، قدر على ذلك، بعد استفراغ مجهوده. وجرد القلب فراه مصمتاً من كل جهة، فنظر هل يرى فيه آفة ظاهرة؟ فلم ير فيه شيئاً! فشد على يده، فتبين له أن فيه تجويفاً، فقال: لعل مطلوبي الأقصى إنما هو في داخل هذا العضو، وأنا حتى الآن لم أصل إليه. فشق عليه، فألقى فيه تجويفين اثنين احدهما من الجهة اليمنى والآخر من الجهة اليسرى، والذي من الجهة اليمنى مملوء بعقد منعقد، والذي من الجهة اليسرى خال لا شيء به.
+
+فقال: لن يعدو مطلوبي أن يكون مسكنه أحد هذين البيتين. ثم قال: أما هذا البيت الأيمن، فلا أرى فيه إلا هذا الدم المنعقد. ولا شك أنه لم ينعقد حتى صار الجسد كله إلى هذا الحال - إذ كان قد شاهد الدماء متى سالت وخرجت انعقدت وجمدت ولم يكن هذا إلا دماً كسائر الدماء - وأنا أرى أن هذا الدم موجود في سائر الأعضاء لا يختص به عضو دون أخر، وأنا ليس مطلوبي شيئاً بهذه الصفة إنما مطلوبي الشيء الذي يختص به هذا الموضع الذي أجدني لا أستغني عنه طرفة العين، واليه كان انبعاثي من أول. واما هذا الدم فكم مرة جرحتني الوحوش في المحاربة فسال مني كثير منه فما ضرني ذلك ولا افقدني شيئاً من أفعالي، فهذا بيت ليس فيه مطلوبي. وأما هذا البيت الأيسر فأراه خالياً لاشيء فيه، وما أرى ذلك لباطل، فاني رأيت كل عضو من الأعضاء إنما لفعل يختص به، فكيف يكون هذا البيت على ما شاهدت من شرفه باطلاً؟ ما أرى إلا أن مطلوبي كان فيه! فارتحل عنه وأخلاه. وعند ذلك، طرأ على هذا الجسد من العطلة ما طرأ، ففقد الإدراك وعدم الحراك. فلما رأى أن الساكن في ذلك البيت قد ارتحل قبل انهدامه وتركه وهو بحاله، تحقق أنه أحرى أن لا يعود إليه بعد أن حدث فيه من الخراب والتخريق ما حدث. فصار عنده الجسد كله خسيساً لا قدر له بالإضافة إلى ذلك الشيء الذي اعتقد في نفسه أنه يسكنه مدة ويرحل عنه بعد ذلك.
+
+فاقتصر على الفكرة في ذلك الشيء ما هو؟ وكيف هو؟ وما الذي ربطه بهذا الجسد؟ والى اين صار؟ ومن أي الأبواب خرج عند خروجه من الجسد؟ وما السبب الذي أزعجه إن كان خرج كارهاً؟ وما السبب الذي كره إليه الجسد، حتى فارقه إن كان خرج مختاراً؟ وتشتت فكره في ذلك كله، وسلا عن الجسد وطرحه، وعلم أن أمه التي عطفت عليه وأرضعته، إنما كانت ذلك الشيء المرتحل، وعنه كانت تصدر تلك الأفعال كلها، لا هذا الجسد العاطل وأن هذا الجسد بجملته، إنما هو كالآلة وبمنزلة العصي التي اتخذها هو لقتال الوحوش. فانتقلت علاقته عن الجسد إلى صاحب الجسد ومحركه، ولم يبق له شوق إلا إليه. وفي خلال ذلك نتن ذلك الجسد، وقامت منه روائح كريهة، فزادت نفرته عنه، وود أن لا يراه ثم انه سنح لنظره غرابان يقتتلان حتى صرع أحدهما الآخر ميتاً. ثم جعل الحي يبحث في الأرض حتى حفر حفرة فوارى فيها ذلك الميت بالتراب فقال في نفسه: ما أحسن ما صنع هذا الغراب في مواراة جيفة صاحبه وان كان قد أساء في قتله اياه! وأنا كنت أحق بالاهتداء إلى هذا الفعل بآمي! فحفر حفرة وألقى فيها جسد أمه، وحثا عليها التراب.
+
+وبقي يتفكر في ذلك الشيء المصرف للجسد لا يدري ما هو! غير أنه كان ينظر إلى أشخاص الظباء كلها، فيراها على شكل أمه، وعلى صورتها فكان يغلب على ظنه، أن كل واحد منها إنما يحركه ويصرفه شيء هو مثل الشيء الذي كان يحرك أمه ويصرفها، فكان يألف الظباء ويحن إليها لمكان ذلك الشبه. وبقي على ذلك برهة من الزمن، يتصفح أنواع الحيوان والنبات ويطوف بساحل تلك الجزيرة، ويتطلب هل يرى أو يجد لنفسه شبيهاً حسبما يرى لكل واحد من أشخاص الحيوان والنبات أشباهاً كثيرة، فلا يجد شيئاً من ذلك. وكان يرى البحر قد أحدق بالجزيرة من كل جهة، فيعتقد أنه ليس في الوجود أرض سوى جزيرته تلك.
+
+واتفق في بعض الاحيان أن انقدحت نار في أجمة قلخ على سبيل المحاكة. فلما بصر بها رأى منظراً هاله، وخلقاً لم يعهده قبل، فوقف يتعجب منها ملياً، ومازال يدنو منها شيئاً فشيئاً، فرأى ما للنار من الضوء الثاقب والفعل الغالب حتى لا تعلق بشيء إلا أتت عليه وأحالته إلى نفسها، فحمله، العجب بها، وبما ركب الله تعالى في طباعه من الجراءة و القوة، على أن يده إليها، وأراد أن يأخذ منها شيئاً فلما باشرها أحرقت يده فلم يستطع القبض عليها فاهتدى إلى أن يأخذ قبساً لم تستول النار على جميعه، فأخذ بطرفه السليم والنار في طرفه الآخر، فتاتي له ذلك وحمله إلى موضعه الذي كان يأوي إليه - وكان قد خلا في جحر استحسنه للسكنى قبل ذلك. ثم مازال يمد تلك النار بالحشيش والحطب الجزل، ويتعهدهاً ليلاً ونهاراً استحساناً منه وتعجباً منها.
+
+وكان يزيد انسه بها ليلاً، لأنها كانت تقوم له مقام الشمس في الضياء و الدفء، فعظم بها ولوعه، واعتقد أنها أفضل الأشياء التي لديه: وكان دائماً يراها تتحرك إلى جهة فوق وتطلب العلو، فغلب على ظنه أنها من جملة الجواهر السماوية التي كان يشاهدها. وكان يختبر قوتها في جميع الأشياء بأن يلقيها فيها، فيراها مستولية عليه أما بسرعة واما ببطء بحسب قوة استعداد الجسم الذي كان يلقيه للاحتراق أو ضعفه. وكان من جملة ما القى فيها على سبيل الاختبار لقوتها، شيء من أصناف الحيوانات البحرية - كان قد ألقاه البحر إلى ساحله - فلما أنضجت ذلك الحيوان وسطع قتاره تحركت شهوته إليه، فأكل منه شيئاً فاستطابه، فاعتاد بذلك أكل اللحم، فصرف الحيلة في صيد البر والبحر، حتى مهر في ذلك. وزادت محبته للنار، إذ تأتي له بها من وجوه الاغتذاء الطيب شيء لم يتأت له قبل ذلك.
+
+فلما اشتد شغفه بها لما رأى من أحسن آثارها وقوة اقتدارها، وقع في نفسه أن الشيء الذي ارتحل من قلب أمه الظبية التي أنشأته، كان من جوهر هذا الوجود أو من شيء يجانسه، وأكد ذلك في ظنه، ما كان يراه من حرارة الحيوان طول مدة حياته، وبرودته من بعد موته، وكل هذا دائم لا يختل، وما كان يجده في نفسه من شدة الحرارة عند صدره، بازاء الموضع الذي كان قد شق عليه من الظبية، فوقع في نفسه أنه لو أخذ حيواناً حياً وشق قلبه ونظر إلى ذلك التجويف الذي صادفه خالياً عندما شق عليه في أمه الظبية، لرأه في الحيوان الحي وهو مملوء بذلك الشيء الساكن فيه وتحقق هل هو من جوهر النار؟ وهل فيه شيء من الضوء والحرارة، آم لا؟ فعمد إلى بعد الوحوش واستوثق منه كتافاً وشقه على الصفة التي شق بها الظبية حتى وصل القلب. فقصد أولاً إلى الجهة اليسرى منه وشقها، فرأى ذلك الفراغ مملوءاً بهواء بخاري، يشبه الضباب الابيض، فأدخل إصبعه فيه، فوجده من الحرارة في حد كاد يحرقه، ومات ذلك الحيوان على الفور.
+
+فصح عنده أن ذلك البخار الحار هو الذي كان يحرك هذا الحيوان، وأن في كل شخص من أشخاص الحيوانات مثل ذلك، ومتى انفصل عن الحيوان مات. ثم تحركت في نفسه الشهوة للبحث عن سائر أعضاء الحيوان وترتيبها وأوضاعها وكميتها وكيفية ارتباط بعضها ببعض، وكيف تستمد من هذا البخار الحار حتى تستمر لها الحياة به، وكيف بقاء هذا البخار المدة التي يبقى، ومن أين يستمد، وكيف لا تنفذ حرارته؟ فتتبع ذلك كله بتشريح الحيوانات الأحياء و الاموات، ولم يزل ينعم النظر فيها ويجيد الفكرة، حتى بلغ في ذلك كله مبلغ كبار الطبيعيين، فتبين له أن كل شخص من أشخاص الحيوان، وان كان كثيراً بأعضائه وتفنن حواسه وحركاته فانه واحد بذلك الروح الذي مبدؤه من قرار واحد، وانقسامه وانقسامه في سائر الأعضاء منبعث منه. وأن جميع الأعضاء إنما هي خادمة له، أو مؤدية عنه، وأن منزلة ذلك الروح في تصريف الجسد، كمنزلة من يحارب الأعداء بالسلاح التام، ويصيد جميع صيد البر والبحر، فيمد لكل جنس آلة يصيده بها والتي يحارب بها تنقسم: إلى ما يدفع به نكيلة غيره، والى ما ينكي بها غيره.
+
+وكذلك آلات الصيد تنقسم: إلى ما يصلح لحيوان البحر، والى ما يصلح لحيوان البر، وكذلك الأشياء التي يشرح بها تنقسم: إلى ما يصلح للشق، والى ما يصلح للكسر، والى ما يصلح للثقب، والبدن الواحد، وهو يصرف ذلك أنحاء من التصريف بحسب ما تصلح له كل آلة، وبحسب الغايات التي تلتمس بذلك التصرف. كذلك؛ ذلك الروح الحيواني واحد، وإذا عمل بالة العين كان فعله أبصاراً، وإذا عمل بآلة الآذن كان فعله سمعاً، وإذا عمل بآلة الآنف كان فعله شماً، وإذا عمل بآلة اللسان كان فعله ذوقاً، وإذا عمل بالجلد واللحم كان فعله لمساً، وإذا عمل بالعضد كان فعله حركه، وإذا عمل بالكبد كان فعله غذاء واغتذاء.
+
+ولكل واحد من هذه، أعضاء تخدمه. ولا يتم لشيء من هذه فعل إلا بما يصل إليها من ذلك الروح، على الطريق التي تسمى عصباً. ومتى انقطعت تلك الطرق أو انسدت، تعطل فعل ذلك العضو. وهذه الأعصاب إنما تستمد الروح من بطون الدماغ يستمد الروح من القلب، والدماغ فيه أرواح كثير، لانه موضع تتوزع فيه أقسام كثيرة: فآي عضو عدم هذا الروح بسبب من الأسباب تعطل فعله وصار بمنزلة الآلة المطرحة، التي يصرفها الفاعل ولا ينتفع بها. فان خرج هذا الروح بجملته عن الجسد، أو فني، أو تحلل بوجه من الوجوه، تعطل الجسد كله، وصار إلى حالة الموت، فانتهى به إلى هذا من منشئه، وذلك أحد وعشرون عاماً.
+
+وفي خلال هذه المدة المذكورة تفنن في وجوه حيله، واكتسى بجلود الحيوانات التي كان يشرحها، واحتذى بها، واتخذ الخيوط من الأشعار ولحا قصب الخطمية والخباري والقنب، وكل نبات ذي خيط. وكان أصل اهتدائه إلى ذلك، أنه أخذ من الحلفاء وعمل خطاطيف من الشوك القوي والقصب المحدد على الحجارة.
+
+واهتدى إلى البناء بما رأى من فعل الخطاطيف فاتخذ مخزناً وبيتاً لفضلة غذائه، وحصن عليه بباب من القصب المربوط بعضه إلى بعض، لئلا يصل إليه شيء من الحيوانات عند مغيبه عن تلك الجهة في بعض شؤونه. واستألف جوانح الطير ليستعين بها في الصيد، واتخذ الدواجن ببيضها وفراخها، واتخذ من الصياصي البقر الوحشية شبه الاسنة، وركبها في القصب القوي، وفي عصي الزان وغيرها، واستعان في ذلك بالنار وبحروف الحجارة، حتى صارت شبه الرماح، واتخذ ترسه من جلود مضاعة: كل ذلك لما رأى من عدمه السلاح الطبيعي. ولما رأى أن يده تفي له بكل ما فاته من ذلك، وكان لا يقاومه شيء من الحيوانات على اختلاف أنواعها، إلا أنها كانت عنه فتعجزه هرباً، فكر في وجه الحيلة في ذلك، فلم ير شيئاً أنجع له من أن يتالف بعض الحيوانات الشديدة العدو، ويحسن إليها بأعداد الغذاء الذي يصلح لها، حتى يتأتى له الركوب عليها ومطاردة سائر الأصناف بها.
+
+وكان بتلك الجزيرة خيل البرية وحمر وحشية، فاتخذ منها ما يصلح له، وراضها حتى كمل بها غرضه، وعمل عليها من الشرك والجلود أمثال الشكائم والسروج فتاتي له بذلك ما امله من طرد الحيوانات التي صعبت عليه الحيلة في أخذها. وانما تفنن في هذه الأمور كلها ف وقت اشتغاله التشريح، وشهوته في وقوفه على خصائص أعضاء الحيوان، وبماذا تختلف، وذلك في المدة التي حددنا منتهاها بأحد وعشرين عاماً. ثم انه بعد ذلك أخذ في مآخذ أخر من النظر، فتصفح جميع الأجسام التي في عالم الكون والفساد: من الحيوانات على اختلاف أنواعها، والنبات والمعادن وأصناف الحجارة والتراب والماء والبخار والثلج والبرد، والدخان واللهيب والجمر، فرأى لها أصوافاً كثيرة وأفعالاً مختلفة، وحركات متفقة ومضادة، وأنعم النظر في ذلك والتثبت، فرأى أنها تتفق ببعض الصفات وتختلف ببعض، وأنها من الجهة التي تتفق بها واحدة، ومن الجهة التي تختلف فيها متغايرة ومتكثرة فكان تارة ينظر خصائص الأشياء وما يتفرد به بعضها عن بعض، فتكثر عنده كثرة تخرج عن الحصر، وينتشر له الوجود انتشار لا يضبط. كل عضو منها فيرى أنه يحتمل القسمة إلى أجزاء كثيرة جداً، فيحكم على ذاته بالكثرة، وكذلك على ذات كل شيء.
+
+ثم كان يرجع إلى نظر آخر من طريق ثان، فيرى أن أعضاءه، وان كانت كثيرة فهي متصلة كلها بعضها ببعض، لا انفصال بينها بوجه، فهي في الحكم الواحد، وأنها لا تختلف إلا بحسب اختلاف أفعالها، أن ذلك الاختلاف إنما هو بسبب ما يصل إليها من قوة الروح الحيواني، الذي انتهى إليه نظره أولاً، وأن ذلك الروح واحد ذاته، وهو حقيقة الذات، وسائر الأعضاء كلها كالآلات، فكانت تتحد عنده ذاته بهذا الطريق.
+
+ثم أنه كان ينتقل إلى جميع أنواع الحيوانات، فيرى كل شخص منها واحداً بهذا النوع من النظر. ثم كان ينظر إلى نوع منها: كالظباء والخيل وأصناف الطير صنفاً صنفاً، فكان يرى أشخاص كل نوع يشبه بعضه بعضاً في الأعضاء الظاهرة والباطنة الادراكات والحركات والمنازع، ولا يرى بينها اختلافاً إلا في أشياء يسيرة بالإضافة إلى ما اتفقت فيه.
+
+وكان يحكم بان الروح الذي لجميع ذلك النوع شيء واحد، وأنه لم يختلف إلا أنه انقسم على قلوب كثيرة، وأنه لو أمكن أن يجمع جميع الذي افترق في تلك القلوب منه ويجعل في وعاء واحد، لكان كله شيئاً واحداً، بمنزلة ماء واحد، أو شراب واحد، يفرق على أوان كثيرة، ثم يجمع بعد ذلك. فهو في حالتي تفريقه وجمعه شيء واحد، إنما الغرض له التكثر بوجه ما، فكان يرى النوع بهذا النظر واحداً، ويجعل كثرة أشخاصه بمنزلة كثيرة أعضاء الشخص الواحد، التي لم تكن كثرة في الحقيقة.
+
+ثم كان يحضر أنواع الحيوانات كلها في نفسه ويتأملها فيراها تتفق في أنها تحس، وتغتذي، وتتحرك بالإرادة إلى أي جهة شاءت، وكان قد علم أن هذه الأفعال هي أخص أفعال الروح الحيواني، وأن سائر الأشياء التي تختلف بها بعد هذا الاتفاق، ليست شديدة الاختصاص بالروح الحيواني. فظهر له بهذا التأمل، أن الروح الحيواني الذي لجميع جنس الحيوان واحد بالحقيقة، وان كان فيه اختلاف يسير، اختص به نوع دون نوع: بمنزلة ماء واحد مقسوم على أوان كثيرة، بعضه أبرد من بعض.
+
+وهو في أصله واحد وكل ما كان في طبقة واحدة من البرودة، فهو بمنزلة اختصاص ذلك الروح الحيواني بنوع واحد، وان عرض له التكثر بوجه ما. فكان يرى جنس الحيوان كله واحداً بهذا النوع من النظر. ثم كان يرجع إلى أنواع النبات على اختلافها. فيرى كل نوع منها تشبه أشخاصه بعضها بعضاً في الأغصان، والورق، والزهر والثمر، والأفعال فكان يقيسها بالحيوان، ويعلم أن لها شيئاً واحداً فيه: هو لها بمنزلة الروح الحيواني وأنها بذلك الشيء واحد. وكذلك كان ينظر إلى جنس النبات كله، فيحكم باتحاده بحسب ما يراه من اتفاق فعله في أنه يتغذى وينمو.
+
+ثم كان يجمع في نفسه جنس الحيوان وجنس النبات، فيراهما جميعاً متفقين في الاغتذاء والنمو، ألا أن الحيوان يزيد على النبات، بفضل الحس والادراك والتحرك؛ وربما ظهر في النبات شيء شبيه به، مثل تحول وجوه الزهر إلى جهة الشمس، وتحرك عروقه إلى الغذاء، بسبب شيء واحد مشترك بينهما، هو في أحدهما أتمم وأكمل، وفي الآخر قد عاقه عائق ما، وأن ذلك بمنزلة ماء واحد قسم بقسمين، أحدهما جامد والآخر سيال، فيتحد عنده النبات والحيوان. ثم ينظر إلى الأجسام التي لا تحس ولا تغتذي ولا تنمو، من الحجارة، والتراب، والماء، والهواء، واللهب، فيرى أنها أجسام مقدر لها الطول وعرض وعمق وأنها لاتختلف، إلا أن بعضها ذو لون وبعضها لا لون له وبعضها حار والآخر بارد، ونحو ذلك من الاختلافات وكان يرى أن الحار منها يصير بارداً، والبارد يصير حار وكان يرى الماء يصير بخاراً والبخار ماء، والأشياء المحترقة تصير جمراً، ورماداً، ولهيباً، ودخاناً، والدخان إذا وافق في صعوده قبة حجر انعقد فيه وصار بمنزلة سائر الأشياء الأرضية، فيظهر له بهذا التأمل، أن جميعها شيء واحد في الحقيقة، وان لحقتها الكثرة بوجه ما، فذلك مثل ما لحقت الكثرة للحيوان والنبات.
+
+ثم ينظر إلى الشيء الذي اتحد به عند النبات والحيوان، فيرى أنه جسم ما مثل هذه الأجسام: له طول وعرض وعمق، وهو إما حار واما بارد، كواحد من هذه الأجسام التي لا تحس ولا تتغذى، وانما خالفها بأفعاله التي تظهر عنه بالآلات الحيوانية والنباتية لا غير، ولعل تلك الأفعال ليست ذاتية، وانما تسري إليه من شيء آخر ولو سرت إلى هذه الأجسام الآخر، لكانت مثله فكان ينظر إليه بذاته مجرداً عن هذه الأفعال، التي تظهر ببادئ الرأي، أنها صادرة عنه، فكان يرى أنه ليس إلا جسماً من هذه الأجسام، فيظهر له بهذا التأمل، أن الأجسام كلها شيء واحد: حيها وجمادها، متحركها وساكنها، إلا أنه يظهر أن لبعضها أفعالاً بالات، ولا يدري هل تلك الأفعال ذاتية لها، أو سارية أليها من غيرها. وكان في هذه الحال لا يرى شيئاً غير الأجسام فكان بهذا الطريق يرى الوجود كله شيئاً واحداً، وبالنظر الأول كثرة لا تنحصر ولا تتناهى. وبقي بحكم هذه الحالة مدة.
+
+ثم انه تأمل جميع الأجسام حيها وجامدها. وهي التي هي عنده تارةً شيء واحد وتارةً كثيرة كثرة لا نهاية لها، فرأى إن كل واحد منها، لا يخلو من أحد أمرين: إما أن يتحرك إلى جهة العلو مثل الدخان واللهيب والهواء، إذا حصل تحت الماء واما أن يتحرك إلى الجهة المضادة لتلك الجهة، وهي جهة السفل، مثل الماء، وأجزاء الحيوان و النبات، وأن كل جسم من هذه الأجسام لن يعرى عن إحدى هاتين الحركتين وأنه لا يسكن إلا إذا منعه مانع يعوقه عن طريقه، مثل الحجر النازل يصادف وجه الأرض صلباً، فلا يمكن أن يخرقه، ولو أمكنه ذلك لما انثنى عن حركته فيما يظهر، ولذلك إذا رفعته، وجدته يتحامل عليك بميله إلى جهة السفل، طالباً للنزول. وكذلك الدخان في صعوده، لا ينثني إلا أن يصادف قبة صلبة تحبسه، فحينئذً ينعطف يميناً وشمالاً ثم إذا تخلص من تلك القبة، خرق الهواء صاعداً لأن الهواء لا يمكنه أن يحبسه.
+
+وكان يرى إن الهواء إذا ملئ به زق جلد، وربط ثم غوص تحت الماء طلب الصعود وتحامل على من يمسكه تحت الماء، ولا يزال يفعل ذلك حتى يوافي موضع الهواء، وذلك بخروجه من تحت الماء فحينئذً يسكن ويزول عنه ذلك التحامل والميل إلى جهة العلو الذي كان يوجد منه قبل ذلك. ونظر هل يجد جسماً يعرى عن إحدى هاتين الحركتين أو الميل إلى إحداهما في الوقت ما؟ فلم يجد ذلك في الأجسام التي لديه، وانما طلب ذلك، لانه طمع أن يجده، فيرى طبيعة الجسم من حيث هو جسم، دون أن تقترن به وصف من الأوصاف، التي هي منشأ التكثر. فلما أعياه ذلك ونظر إلى الأجسام التي هي أقل الأجسام حملاً للأوصاف فلم يرها تعرى عن أحد هذين الوصفين بوجه، وهما اللذان يعبر عنهما بالثقل والخفة فنظر إلى الثقل والخفة، هل هما للجسم من حيث هو جسم؟ أو هما لمعنى زائد على الجسمية؟ فظهر له أنهما لمعنى زائد على الجسمية لانهما لو كانا للجسم من حيث هو جسم، لما وجد إلا وهما له.
+
+ونحن نجد الثقيل لا توجد فيه الخفة، والخفيف لا يوجد فيه الثقل، وهما لا محالة جسمان ولكل واحد منهما معنى منفرد به عن الأخر زائد على جسميته. وذلك المعنى، الذي به غاير كل واحد منهما الآخر، ولولا ذلك لكانا شيئاً واحداً من جميع الوجوه.
+
+فتبين له أن حقيقة كل واحد من الثقيل والخفيف، مركبة من معنيين: أحدهما ما يقع فيه الاشتراك منهما جميعاً، وهو معنى الجسمية؛ والآخر ما تنفرد به حقيقة كل واحد منهما على الاخر، وهما أما الثقل في احدهما واما الخفة في الاخر، المقترنان بمعنى الجسمية، أي المعنى الذي يحرك أحدهما الأخر علواً والأخر سفلاً. وكذلك نظر إلى سائر الأجسام من الجمادات والأحياء، فرأى أن حقيقة وجود كل واحد منهما مركبة من معنى الجسمية، ومن شيء أخر زائد على الجسمية: أما واحد، واما أكثر من واحد؛ فلاحت له صور الأجسام على اختلافها وهو أول ما لاح له من العالم الروحاني، اذ هي صور لا تدرك بالحس، وانما تدرك بضرب ما من النظر العقلي.
+
+ولاح له في جملة ما لاح من ذلك، أن الروح الحيواني الذي مسكنه القلب - وهو الذي تقدم شرحه أولاً - لابد له أيضاً من معنى زائد على جسميته يصلح بذلك المعنى لأن يعمل هذه الأعمال الغريبة، التي تختص به من ضروب الاحساسات، وفنون الادراكات وأصناف الحركات، وذلك المعنى هو صورته وفضله الذي انفصل به عن سائر الأجسام، وهو الذي يعبر عنه النظار بالنفس الحيوانية. وكذلك ايضاً للشيء الذي يقوم للنبات مقام الحار الغريزي للحيوان، شيء يخصه هو صورته، وهو الذي يعبر عنه النظار بالنفس النباتية. وكذلك لجميع الأجسام الجمادات: وهي ما عدا الحيوان والنبات مما في عالم الكون والفساد شيء يخصها به، يفعل كل واحد منها فعله الذي يختص به مثل صنوف الحركات وضروب الكيفيات المحسوسة عنها، وذلك الشيء هو صورة كل واحد منها، وهو الذي يعبر النظار عنه بالطبيعة.
+
+فلما وقف بهذا النظر على ان حقيقة الروح الحيواني، الذي كان تشوقه اليه ابداً، مركبة من معنى الجسمية، ومن معنى أخر زائد على الجسمية، وان معنى الجسمية مشترك، ولسائر الأجسام، والمعنى الأخر المقترن به هو وحده، هان عنده معنى الجسمية فاطرحه، وتعلق فكره بالمعنى الثاني، وهو الذي يعبر عنه النفس؛ فتشوق إلى التحقق به فالتزم الفكرة فيه، وجعل مبدأ النظر في ذلك تصفح الأجسام كلها، لا من جهة ما هي أجسام، بل من وجهة ما هي ذوات صور تلزم عنها خواص، ينفصل بها بعضها ببعض. فتتبع ذلك وحصره في نفسه، فرأى جملة من الأجسام، تشترك في صورة ما يصدر عنها فعل ما، أو أفعال ما، ورأى فريقاً من تلك الجملة، مع أنه يشارك الجملة بتلك الصورة، يزيد عليها بصورة أخرى، يصدر عنها ما، ورأى طائفة من ذلك الفريق، مع أنها تشارك الفريق في الصورة الأولى والثانية، تزيد عليه بصوره ثالثة، تصدر عنها أفعال ما خاصة بها. مثال ذلك: إن الأجسام الأرضية، مثل التراب والحجارة والمعادن والنبات والحيوان، وسائر الأجسام الثقيلة، وهي جملة واحدة تشترك في صورة واحدة تصدر عنها الحركة إلى الأسفل، ما لم يعقها عائق عن النزول: ومتى تحركت إلى جهة العلو بالقسر ثم تركت، تحركت بصورتها إلى الأسفل. وفريق من هذه الجملة، وهو النبات والحيوان، مع مشاركة الجملة المتقدمة في تلك الصورة، يزيد عليها صورة أخرى، يصدر عنها التغذي والنمو. والتغذي: هو أن يخلف المتغذي، بدل ما تحلل منه، بان يحيل إلى ما التشبه بجوهره مادة قريبة منه، يجتذبها إلى نفسه.
+
+والنمو: هو الحركة في الأقطار الثلاثة، على نسبة محفوظة في الطول والعرض والعمق.
+
+فهذان الفعلان عامان للنبات والحيوان، وهما لا محالة صادران عن صورة مشتركة لهما، وهي المعبر عنها بالنفس النباتية. وطائفة من هذا الفريق، وهو الحيوان خاصة، مع مشاركته الفريق المتقدم في الصورة الأولى والثانية، تزيد عليه بصورة ثالثة، يصدر عنها الحس والتنقل من حين إلى أخر. ورأى أيضاً كل نوع من أنواع الحيوان، له خاصية ينحاز بها عن سائر الأنواع، وينفصل بها متميزاً عنها. فعلم إن ذلك صادر عن صورة له تخصه هي زائدة عن معنى الصورة المشتركة له ولسائر الحيوان، وكذلك لكل واحد من أنواع النبات مثل ذلك. فتبين له إن الأجسام المحسوسة التي في عالم الكون والفساد، بعضها تلتئم حقيقته من معان كثيرة، زائدة على معنى الجسمية، وبعضها من معان اقل؛ وعلم إن معرفة الأقل أسهل من معرفة الأكثر؛ فطلب أولاً الوقوف على الحقيقة لشيء الذي تلتئم حقيقته من اقل الأشياء، ورأى إن الحيوان والنبات، لا تلتئم حقائقها إلا من معان كثيرة، لتفنن أفعالها؛ فأخر التفكير في صورهما. وكذلك رأى إن أجزاء الأرض بعضها ابسط من بعض، فقصد منها إلى ابسط ما قدر عليه وكذلك رأى إن الماء شيء قليل التركيب، لقلة ما يصدر عن صورته من أفعال، وكذلك راى النار والهواء. وكان قد سبق إلى ظنه أولاً، أن هذه الأربعة يستحيل بعضها إلى بعض، وان لها شيئاً واحداً تشترك فيه، وهو معنى الجسمية، وان ذلك الشيء ينبغي إن يكون خلواً من المعاني التي تميز بها كل واحد من هذه الأربعة عن الأخر، فلا يمكن أن يتحرك إلى فوق ولا إلى اسفل، ولا إن يكون حاراً ولا يكون بارداً، ولا يكون رطباً، ولا يابساً، لان كل واحد من هذه الاوصاف، لا يعم جميع الأجسام، فليست إذن للجسم بما هو جسم.
+
+فإذا أمكن وجود جسم لا صورة فيه زائدة على الجسمية، فليس تكون فيه صفة من هذه الصفات، ولا يمكن إن تكون فيه صفة إلا وهي تعم سائر الأجسام المتصورة، بضروب الصور. فنظر هل يجد وصفاً واحداً يعم جميع الأجسام: حيها وجمادها، فلم يجد شيئاً يعم الأجسام كلها. إلا معنى الامتداد الموجود في جميعها في الأقطار الثلاثة، التي يعبر عنها بالطول، والعرض، والعمق، فعلم هذا المعنى هو للجسم من حيث هو جسم، لكنه لم يتأت له بالحس وجود جسم بهذه الصفة وحدها، حتى لا يكون فيه معنى زائد على الامتداد المذكور ويكون بالجملة خلواً من سائر الصور. ثم تفكر في هذا الامتداد إلى الأقطار الثلاثة، هل هو معنى الجسم بعينه، وليس ثم معنى أخر أو ليس الأمر كذلك، فرأى أن وراء هذا الامتداد معنى أخر، هو الذي يوجد فيه هذا الامتداد، وان الامتداد وحده لا يمكن إن يقوم بنفسه كما إن ذلك الشيء الممتد، لا يمكن أن تقوم دون امتداد. واعتبر ذلك ببعض هذه الأجسام المحسوسة ذوات الصور، كالطين مثلاً، كان له طول وعرض وعمق على قدر ما.
+
+ثم إن تلك الكرة بعينها لو أخذت وردت إلى شكل مكعب أو بيض، لتبدل ذلك الطول وذلك العرض وذلك العمق، وصارت على قدر أخر. غير الذي كانت عليه، والطين واحد بعينه لم يتبدل، غير أنه لا بد له من طول وعرض وعمق على أي قدر كان، ولا يمكن إن يعرى عنها؛ غير أنها لتعاقبها عليه، تبين له أنها معنى على حياله؛ ولكونه لا يعرى بالجملة عنها، تبين له أنها من حقيقة. فلاح له بهذا الاعتبار، إن الجسم، بما هو جسم، مركب على الحقيقة من معنين: أحدهما يقوم منه مقام الطين للكرة في هذا المثال. والأخر: يقوم مقام طول الكرة وعرضها وعمقها، أو المكعب، أو أي شكل كان له. وانه لا يفهم الجسم إلا مركباً من هذين المعنين، وان احدهما لا يستغني عن الأخر. ولكن الذي يمكن أن يتبدل ويتعاقب على أوجه كثيرة، وهو معنى الامتداد يشبه الصورة التي لسائر الأجسام ذوات الصور، والذي يثبت على حال واحدة، وهو الذي ينزل منزلة الطين في المثال المتقدم، يشبه معنى الجسمية التي لسائر الأجسام ذوات الصور.
+
+وهذا الشيء الذي هو بمنزلة الطين في هذا المثال هو الذي يسميه النظار المادة والهيولى وهي عارية عن الصورة جملة. فلما نظره إلى هذا الحد، وفارق المحسوس بعض مفارقة، وأشرف على تخوم العالم العقلي، استوحش وحن إلى ما ألفه من عالم الحس، فتقهقر قليلاً وترك الجسم على الإطلاق، إذ هو أمر لا يدركه الحس، ولا يقدر على تناوله. فاخذ أبسط الأجسام المحسوسة التي شاهدها، وهي تلك الأربعة التي كان قد وقف نظره عليها.
+
+فأول ما نظر إلى الماء فرأى انه إذا خلي وما تقتضيه صورته، ظهر منه برد محسوس، وطلب النزول إلى اسفل فإذا سخن أما بالنار واما بحرارة الشمس، زال عنه البرد أولاً وبقي فيه طلب النزول، فإذا أفرط عليه بالتسخين، زال عنه طلب النزول إلى اسفل. وصار يطلب الصعود إلى فوق. فزال عنه بالجملة الوصفان اللذان كانا أبداً يصدران عن صورته، ولم يعرف من صورته أكثر من صدور هذين الفعلين عنها. فلما زال هذان الفعلان بطل حكم الصورة، فزالت الصورة المائية عن ذلك الجسم عندما ظهرت منه أفعال من شأنها أن تصدر عن صورة أخرى، وحدثت له صورة أخرى، بعد أن لم تكن، وصدر عنه بها أفعال لم يكن من شأنها أن تصدر عنه وهو بصورته الأولى. فعلم بالضرورة أن كل حادث لا بد له من محدث. فارتسم في نفسه بهذا الاعتبار، فاعل للصورة، ارتساماً على العموم دون تفصيل. ثم أنه تتبع الصور التي كان قد عاينها قبل ذلك، صورة صورة، فرأى أنها كلها حادثة، وأنها لا بد لها من فاعل. ثم نظر إلى ذوات، الصور، فلم ير أنها شيء أكثر من استعداد الجسم لان يصدر عنه ذلك الفعل، مثل الماء، فانه إذا افرط عليه التسخين، استعد للحركة إلى فوق وصلح لها.
+
+فذلك الاستعداد هو صورته، إذ ليس ها هنا إلا جسم وأشياء تحس عنه، بعد أن لم تكن؛ فصلوح الجسم لبعض الحركات دون بعض، واستعداده بصورته، ولاح له مثل ذلك في جميع الصور، فتبين له أن الأفعال الصادرة عنها، ليست في الحقيقة لها، وانما هي لفاعل يفعل بها الأفعال المنسوبة إليها؛ وهذا المعنى الذي لاح له، هو قول الرسول الله عليه الصلاة والسلام: "كنت سمعه الذي يسمع به وبصره الذي يبصر به" وفي محكم التنزيل: "بسم الله الرحمن الرحيم" فان تقتلوهم ولكن الله قتلهم؛ وما رميت إذا رميت، ولكن الله رمى! صدق الله العظيم. فلما لاح له من أمر هذا الفاعل، ما لاح على الإجمال دون تفصيل، حدث له شوق حثيث إلى معرفته على التفصيل، ولانه لم يكن بعد فارق عالم الحس، جعل يطلب هذا الفاعل على جهة المحسوسات، وهو لا يعلم بعد هل هو واحد أو كثير؟ فتصفح جميع الأجسام التي لديه، وهي التي كانت فكرته أبداً فيها، فرأها كلها تتكون تارة وتفسد أخرى، وما لم يقف على فساد جملته، وقف على الفساد أجزائه مثل الماء والأرض، فانه راى أجزاءهما تفسد بالنار، وكذلك الهواء رآه يفسد بشدة البرد، حتى بتكون منه الثلج فيسيل ماء. وكذلك سائر الأجسام التي كانت لديه، ولم ير منها شيئاً بريئاً عن الحدوث والافتقار إلى الفاعل المختار، فاطرحها كلها وانتقلت فكرته إلى الأجسام السماوية.
+
+وانتهى إلى هذا النظر على رأس أربعة أسابيع من منشئه، وذلك ثمانية وعشرون عاماً. فعلم إن السماء وما فيها من كواكب الأجسام، لأنها ممتدة في الأقطار الثلاثة: الطول، والعرض، والعمق؛ لا ينفك شيء منها عن هذه الصفة، وكل ما لا ينفك عن هذه الصفة، فهو جسم؛ فهي إذن كلها أجسام. ثم تفكر هل هي ممتدة إلى ما لا نهاية، وذاهبة أبداً في الطول والعرض والعمق إلى ما لا نهاية، أو هي متناهية محدودة بحدود تنقطع عندها، ولا يمكن أن يكون وراءها شيء من الامتداد؟ فتحير بعد ذلك بعض الحيرة. ثم انه بقوة فطرته، وذكاء خاطره، راى أن جسماً لا نهاية له أمر باطل، وشيء لا يمكن، ومعنى لا يعقل، وتقوى هذا الحكم عنده بحجج كثيرة، سنحت له بينه وبين نفسه وذلك أنه قال: أما الجسم السماوي فهو متناه من الجهة التي تليني والناحية التي وقع عليها حسي، فهذا لا شك فيه لأنني أدركه ببصر، وأما الجهة التي تقابل هذه الجهة، وهي التي يداخلني فيها الشك، فاني أيضاً أعلم من المحال أن تمتد إلى غير نهاية، لأني إن تخيلت أن خطين اثنين، يبتدئان من هذه الجهة المتناهية، ويمران في سمك الجسم إلى غير نهاية حسب امتداد الجسم، ثم تخيلت أن أحد هذين الخطين، قطع منه جزء كبير من ناحية طرفه المتناهي، ثم أخذ ما بقي منه شيء واطبق الخط المقطوع منه على الخط الذي لم يقطع منه شيء، وذهب الذهن كذلك معهما إلى الجهة التي يقال إنها غير متناهية، فأما أن نجد خطين أبداً يمتدان إلى غير نهاية ولا ينقص أحدهما عن الأخر، فيكون الذي قطع منه جزء مساوياً للذي لم يقطع منه شيء وهو محال، كما أن الكل مثل الجزء المحال؛ واما أن لا يمتد الناقص معه ابداً، بل ينقطع دون مذهبه ويقف عن الامتدادمعه، فيكون متناهياً، فإذا رد عليه القدر الذي قطع منه أولاً، وقد كان متناهياً، صار كله أيضاً متناهياً، وحينئذ لا يقصر عن الخط الأخر الذي يقطع منه شيء، ولا يفضل عليه فيكون إذن مثله وهو متناه، فذلك أيضاً متناه، فالجسم الذي تفرض فيه هذه الخطوط متناه، وكل جسم يمكن أن تفرض فيه هذه الخطوط، فكل جسم متناه.
+
+فإذا فرضنا أن جسماً غير متناه، فقد فرضنا باطلاً ومحالاً. فلما صح عنده بفطرته الفائقة التي لمثل هذه الجهة، أن جسم السماء متناه، أراد أن يعرف على أي شكل هو، وكيفية انقطاعه بالسطوح التي تحده. فنظر أولاً إلى الشمس والقمر وسائر الكواكب، فرأها كلها تطلع من جهة المشرق، وتغرب من جهة المغرب، فما كان يمر على سمت رأسه، رأه يقطع دائرة عظمى، وما مال عن سمت رأسه إلى الشمال أو إلى الجنوب، رأه يقطع دائرة أصغر من تلك. وما كان أبعد عن سمت الرأس إلى أحد الجانبين، كانت دائرته أصغر من دائرة ما هو أقرب. حتى كانت أصغر الدوائر التي تتحرك عليها الكواكب، دائرتين اثنتين: إحداهما حول القطب الجنوبي، وهي مدار سهيل، والاخرى حول القطب الشمالي، وهي المدار الفرقدين. ولما كان مسكنه على خط الاستواء الذي وصفناه أولاً، كانت هذه الدوائر كلها على سطح آفة. ومتشابهة في الجنوب والشمال وكان القطبان معاً ظاهرين له، وكان يترقب إذا طلع كوكب من الكواكب على دائرة كبيرة، وطلع كوكب آخر على دائرة صغيرة، وكان طلوعهما معاً، فكان يرى غروبهما معاً. واطرد له في ذلك جميع الكواكب وفي جميع الأوقات، فتبين له بذلك أن الفلك على شكل الكرة، وقوى ذلك في اعتقاده، ما رآه من رجوع الشمس والقمر وسائر الكواكب إلى المشرق، بعد مغيبها بالمغرب، وما رآه أيضاً من أنها تظهر لبصره على قدر واحد من العظم في حال طلوعها وتوسطها وغروبها، وأنها لو كانت حركتها على غير شكل الكرة لكانت لا محالة في بعض الأوقات، أقرب إلى بصره منها في وقت آخر، ولو كانت كذلك، لكانت مقاديرها واعظامها تختلف عند بصره فيراها في حال القرب أعظم مما يراها في حال البعد، لاختلاف أبعادها عن مركزه حينئذ بخلافها على الأول.
+
+فلما لم يكن شيء من ذلك؛ تحقق عنده كروية الشكل. وما زال يتصفح حركة القمر، فيراها آخذه من المغرب إلى المشرق وحركات الكواكب السيارة كذلك، حتى تبين له قدر كبير من علم الهيئة، وظهر له أن حركتها لا تكون إلا بأفلاك كثيرة، كلها مضمنة في فلك واحد، هو أعلاها. وهو الذي يحرك الكل من المشرق إلى المغرب في اليوم والليلة. وشرح كيفية انتقاله. ومعرفة ذلك يطول؛ وهو مثبت في الكتب، ولا يحتاج منه في غرضنا إلا للقدر الذي أردناه. فلما انتهى إلى هذه المعرفة، ووقف على أن الفلك بجملته وما يحتوي عليه، كشيء واحد متصل بعضه ببعض، وأن جميع الأجسام التي كان ينظر فيها أولاً: كالأرض والماء والهواء والنبات والحيوان وما شاكلها، هي كلها في ضمنه وغير خارجة عنه، وأنه كله أشبه شيء بشخص من أشخاص الحيوان؛ وما فيه من الكواكب المنيرة هي بمنزلة حواس الحيوان؛ وما فيه من ضروب الأفلاك، المتصل بعضها ببعض، هي بمنزلة أعضاء الحيوان؛ وما في داخله من الكون والفساد هي بمنزلة ما في جوف الحيوان من أصناف الفضول والرطوبات، التي كثيراً ما يتكون فيها أيضاً حيوان، كما يتكون في العالم الأكبر. فلما تبين له أنه كله كشخص واحد في الحقيقة، واتحدت عنده أجزاؤه الكثيرة بنوع من النظر الذي اتحدت به عنده الأجسام التي في عالم الكون والفساد، تفكر في العالم بجملته، هل هو شيء حدث بعد إن لم يكن، وخرج إلى الوجود بعد العدم؟ أو هو أمر كان موجوداً فيما سلف، ولم يسبقه العدم بوجه من الوجوه؟ فتشك في ذلك ولم يترجح عنده أحد الحكمين على الآخر. وذلك أنه كان إذا أزمع على اعتقاد القدم، اعترضه عوارض كثيرة، من استحالة وجود ما لا نهاية له، بمثل الذي استحال عنده به وجود جسم لا نهاية وكذلك أيضاً كان يرى أن هذا الوجود لا يخلو من الحوادث، فهو لا يمكن تقدمه عليها، وما لا يمكن أن يتقدم على الحوادث، فهو أيضاً محدث. وإذا أزمع على اعتقاد الحدوث، اعترضته عوارض أخرى، وذلك أنه كان يرى أن معنى حدوثه، بعد أن لم يكن لا يفهم إلا على أن الزمان تقدمه، والزمان من جملة العالم وغير منفك عنه، فإذن لا يفهم تأخر العالم عن الزمان. وكذلك أيضاً كان يقول: إذا كان حادثاً، فلا بد له من محدث؛ وهذا المحدث الذي أحدثه، لم أحدثه الآن ولم يحدثه قبل ذلك، الطارئ طرأ عليه ولا شيء هناك غيره، أم لتغير حدث في ذاته؟ فان كان فما الذي احدث ذلك التغيير؟ وما زال يتفكر في ذلك عدة سنين.
+
+فتتعارض عنده الحجج، ولا يترجح عنده أحد الاعتقادين على الآخر. فلما أعياه ذلك، جعل يتفكر ما الذي يلزم عن كل واحد من الاعتقادين، فلعل اللازم عنهما يكون شيئاً واحداً. فرأى انه إن اعتقد حدوث العالم خروجه إلى الوجود بعد العدم، فاللازم عن ذلك ضرورة، انه لا يمكن أن يخرج إلى الوجود بنفسه، وانه لا بد له من فاعل يخرجه إلى الوجود، وان ذلك الفاعل لا يمكن إن يدرك بشيء من الحواس، لانه لو أدرك بشيء من الحواس لكان جسماً من الأجسام، ولو كان جسماً من الأجسام لكان من جملة العالم، وكان حادثاً واحتاج إلى محدث، ولو كان ذلك المحدث الثاني أيضاً جسماً، لحتاج إلى محدث ثالث، والثالث إلى رابع، ويتسلسل ذلك إلى غير نهايةً وهو باطل. فإذن لابد للعالم من فاعل ليس بجسم، وإذا لم يكن جسماً فليس إلى إدراكه لشيء من الحواس سبيل، الآن الحواس الخمس لا تدرك إلا الأجسام، وإذا لا يمكن أن يحس فلا يمكن أن يتخيل، لان التخيل ليس شيئاً إلا إحضار صور المحسوسات بعد غيبتها، وإذا لم يكن جسماً فصفات الأجسام كلها تستحيل عليه، وأول صفات الأجسام هو الامتداد في الطول والعرض والعمق، وهو منزه عن ذلك، وعن جميع ما يتبع هذا الوصف من صفات الأجسام. وإذا كان فاعلاً للعالم فهو لا محالة قادر عليه وعالم به "بسم الله الرحمن الرحيم" إلا يعلم من خلق، وهو اللطيف الخبير؟ صدق الله العظيم. وراى أيضاً انه إن اعتقد قدم العالم، وان العدم لم يسبقه، وانه لم يزل كما هو، فان اللازم عن ذلك أن حركته قديمة لا نهاية لها من جهة الابتداء، إذ لم يسبقها سكون يكون مبدؤها منه، وكل حركة فلابد لها من محرك ضرورة، والمحرك أما أن يكون قوة سارية في جسم من الأجسام - أما جسم المتحرك نفسه، واما جسم أخر خارج عنه - واما أن تكون قوة ليست سارية ولا شائعة قي جسم. وكل قوى سارية في جسم وشائعه فيه، فانها تنقسم بانقسامه، وتتضاعف بتضاعفه، مثل الثقل بالحجر مثلاً. المحرك إلى الأسفل.
+
+فانه إن قسم الحجر نصفين. وان زيد عليه أخر مثله، زاد في الثقل أخر مثله، فان أمكن أن يتزايد الحجر إلى غير نهاية، كتزايد هذا الثقل إلى غير نهاية، وان وصل الحجر إلى حد ما من العظم ووقف، وصل الثقل إلى ذلك الحد ووقف، لكنه قد تبرهن أن كل جسم فانه لا محالة متناه، فإذن كل قوة في الجسم فهي لا محالة متناهية. فان وجدناها قوة تفعل فعلاً لا نهاية له، فهي قوة ليست في جسم، وقد وجدنا الفلك يتحرك أبداً حركة لانهاية لها ولا انقطاع إذ فرضناه قديماً لا ابتداء له فالواجب على ذلك أن تكون القوة التي تحرك ليست في جسمه، ولا في جسم خارج عنه. فهي إذا لشيء بريء عن الأجسام، وغير موصوف بشيء من أوصاف الجسمية، وقد كان لاح له في نظره الأول في عالم الكون والفساد إن حقيقة وجود كل جسم، إنما هي من جهة صورته التي هي استعداده لضروب الحركات، وان وجوده الذي له من جهة مادته وجود ضعيف لا يكاد يدرك؛ فان وجود العالم كله إنما هو من جهة استعداده لتحريك هذا المحرك البريء عن المادة، وعن صفات الأجسام، المنزه عن أن يدركه حس، أو يتطرق إليه خيال، سبحانه، وإذا كان فاعلاً لحركات الفلك على اختلاف أنواعها، فعلاً لا تفاوت فيه ولا فتور فيه ولا قصور، فهو لا محالة قادر عليها وعالم بها.
+
+فانتهى نظره بهذا الطريق إلى ما انتهى إليه بالطريق الأول، ولم يضره في ذلك تشككه في قدم العالم أو حدوثه، وصح له على الوجهين جميعاً وجود فاعل غير الجسم، ولا متصل بجسم ولا منفصل عنه، ولا داخل فيه، ولا خارج عنه، إذ: الاتصال، والانفصال، والدخول، هي كلمات من صفات الأجسام، وهو منزه عنها. ولما كانت المادة في كل جسم مفتقرة إلى الصورة، إذ لا تقوم إلا بها ولا تثبت لها حقيقة دونها، وكانت الصورة لا يصح وجودها إلا من فعل هذا الفاعل تبين له افتقار جميع الموجودات في وجودها إلى هذا الفاعل وأنه لا قيام لشيء منها إلا به فهو إذن علة لها، وهي معلومة له، سواء كانت محدثة الوجود، بعد أن سبقها العدم، أو كانت الابتداء لها من جهة الزمان، ولم يسبقها العدم قط، فانها على كلا الحالتين معلولة، ومفتقرة إلى الفاعل، متعلقة الوجود به، ولولا دوامه لم تدم، ولولا وجوده لم توجد، ولولا قدمه لم تكن قديمة، وهو في ذاته غني عنها وبريء منها! وكيف لا يكون كذلك وقد تبرهن أن قدرته غير متناهية، وأن جميع الأجسام وما يتصل بها أو يتعلق بها، ولو بعض التعلق، هو متناه منقطع. فإذن العالم كله بما في السماوات والأرض والكواكب، وما بينها، وما فوقها، وما تحتها، فعله وخلقه؛ ومتأخر عليه بالذات، وان كانت غير ماخرة عليها بالزمان. كما انك إذا أخذت في قبضتك جسماً من الأجسام، ثم حركت يدك، فان ذلك الجسم لا محالة يتحرك تابعاً لحركة يدك، حركة متأخرة عن حركة يدك، تأخراً بالذات؛ وان كانت لم تتأخر بالزمان عنها، بل كان ابتداؤهما معاً، فكذلك العالم كله، معلول ومخلوق لهذا الفاعل بغير زمان "بسم الله الرحمن الرحيم" إنما أمره إذا أراد شيئاً أن يقول له كن فيكون صدق الله العظيم. فلما راى إن جميع الموجودات فعله، تصفحها من بعد ذا تصفحاً على طريق الاعتبار في قدرة فاعلها؛ والتعجب من غريب صنعته، ولطيف حكمته، ودقيق علمه فتبين له في اقل الأشياء الموجودة، فضلاً عن أكثرها من أثار الحكمة، وبدائع الصنعة، ما قضى منه كل العجب، وتحقق عنده إن ذلك لا يصدر إلا عن فاعل مختار في غاية الكمال وفوق الكمال "بسم الله الرحمن الرحيم" لا يغرب عنه مثقال ذرة في السموات ولا في الأرض ولا اصغر من ذلك ولا أكبر صدق الله العظيم.
+
+ثمتأمل في جميع أصناف الحيوان، كيف "بسم الله الرحمن الرحيم" أعطى كل شيء خلقه، ثم هداه صدق الله العظيم لاستعماله، فلولا أنه هداه لاستعمال تلك الأعضاء التي خلقت له في وجوه المنافع المقصود بها، لما انتفع بها الحيوان، وكانت كلاً عليه، فعلم بذلك أنه أكرم الكرماء، وارحم الرحماء. من فيض ذلك الفاعل المختار - جل جلاله - ومن وجوده، ومن فعله، فعلم أن الذي هو في ذاته أعظم منها، وأكمل، واتمم وأحسن، وأبهى وأجمل وأدوم، وأنه لا نسبة لهذه إلى تلك. فما زال يتتبع صفات الكمال كلها، فيراها له وصادرة عنه، ويرى أنه أحق بها من كل ما يوصف بها دونه. وتتبع صفات النقص كلها فرآه بريئاً منها، ومنزهاً عنها؛ وكيف لا يكون بريئاً منها وليس معنى النقص إلا العدم المحض، أو ما يتعلق بالعدم؟ وكيف يكون العدم تعلق أو تلبس، بمن هو الموجود المحض، الواجب الوجود بذاته، المعطي لكل ذي وجود وجوده، فلا وجود إلا هو: فهو الوجود، وهو الكمال، وهو التمام، وهو الحسن، وهو البهاء، وهو القدرة، وهو العلم، وهو هو، و "بسم الله الرحمن الرحيم" كل شيء هالك إلا وجهه صدق الله العظيم. فانتهت به المعرفة إلى هذا الحد، على رأس خمسة أسابيع من منشئه، وذلك خمسة وثلاثون عاماً، وقد رسخ في قلبه من هذا الفاعل، ما شغله عن الفكرة في كل شيء إلا فيه، وذهل عما كان فيه تصفح الموجودات والبحث عنها، حتى صار بحيث لا يقع بصره على شيء من الأشياء، إلا ويرى فيه أثر الصنعة، ومن حينه، فينتقل بفكره على الفور إلى الصانع ويترك المصنوع، حتى اشتد شوقه إليه، وانزعج قلبه بالكلية عن العالم الأدنى المحسوس، وتعلق بالعالم الأرفع المعقول. فلما حصل له العلم بهذا الموجود الرفيع الثابت الوجود الذي لا سبب لوجود جميع الأشياء، أراد أن يعلم بأي شيء حصل له هذا العالم، وبأي قوة أدرك هذا الموجود: فتصفح حواسه كلها وهي: السمع، والبصر، والشم، والذوق، واللمس، فرأى أنها لا تدرك شيئاً إلا جسماً، أو ما هو في الجسم، وذلك أن السمع لا يدرك المسموعات، وهي ما يحدث من تموج الهواء عند تصادم الأجسام، والبصر إنما يدرك الألوان، والشم يدرك الروائح، والذوق يدرك الطعوم، واللمس يدرك الأمزجة والصلابة واللين، والخشونة والملاسة، وكذلك القوة الخيالية لا تدرك شيئاً إلا أن يكون له طول وعرض وعمق؛ وهذه المدركات كلها من صفات الأجسام، وليس لهذه الحواس أدراك شيء سواها، وذلك لأنها قوى شائعة في الأجسام، ومنقسمة بانقسامها، فهي لذلك لا تدرك إلا جسماً منقسماً، لان هذه القوة إذا كانت شائعة في شيء منقسم، فلا محالة أنها إذا أدركت شيئاً من الأشياء، فانه ينقسم بانقسامها؛ فإذن كل قوة في جسم، فانها لا محالة لا تدرك إلا جسماً أو ما هو جسم.
+
+وقد تبين إن هذا الموجود الواجب الوجود، بريء من صفات الأجسام من جميع الاتجاهات، فإذن لا سبيل إلى إدراكه إلا بشيء ليس بجسم، ولا هو قوة في جسم، ولا تعلق له وجه من الوجوه بالأجسام، ولا هو داخل فيها ولا خارج عنها، ولا متصل بها ولا منفصل عنها. وقد كان تبين له أن أدركه بذاته، ورسخت المعرفة به عنده، فتبين له بذلك أن ذاته التي أدركه بها أمر غير جسماني، ولا يجوز عليه شيء من صفات الأجسام، وان كل ما يدركه من ظاهر ذاته من الجسمانية فانها ليست حقيقة ذاته، وانما حقيقة ذاته ذلك الشيء الذي أدرك به الموجود المطلق الواجب الوجود. فلما علم أن ذاته ليست هذه المتجسمة التي يدركها بحواسه، ويحيط بها أديمه، هان عنده بالجملة جسمه، وجعل يتفكر في تلك الذات الشريفة، التي أدرك بها ذلك الموجود الشريف الواجب الوجود، ونظر في ذاته تلك الشريفة، هل يمكن أن تبيد أو تفسد وتضمحل، أو هي دائمة البقاء؟ فرأى إن الفساد والاضمحلال إنما هو من صفات الأجسام بأن تخلع صورة وتلبس صورة أخرى، مثل الماء إذا صار هواء، والهواء إذا صار ماء، والنبات إذا صار تراباً، والتراب إذا صار نباتاً، هذا هو معنى الفساد.
+
+وأما الشيء الذي ليس بجسم، ولا يحتاج في قوامه إلى جسم، وهو منزه بالجملة عن الجسمانية، فلا يتصور فساده البتة. فلما ثبت له أن ذاته الحقيقة لا يمكن فسادها، أراد إن يعلم كيف يكون حالها إذا اطرح البدن وتخلت عنه، وقد كان تبين له أنها لا تطرحه إلا إذا لم يصلح آلة لها، فتصفح جميع القوى المدركة، فرأى أن كل واحدة منها تارةً تكون مدركة بالقوة، وتارةً تكون مدرة بالفعل: مثل العين في حال تغميضها أو أعراضها عن البصر، فانها تكون مدركة بالقوة - ومعنى مدركه بالقوة أنها لا تدرك الآن وتدرك في المستقبل - وفي حال فتحها واستقبالها للمبصر، تكون مدركه بالفعل - ومعنى مدركة بالفعل أنها الآن تدرك - وكذلك كل واحدة من هذه القوى تكون مدركة بالقوة وتكون مدركة بالفعل، وكل واحدة من هذه القوى إن كانت لم تدرك قط بالفعل، فهي ما دامت بالقوة لا تتشوق إلى إدراك الشيء المخصوص بها لأنها لم تتعرف به بعد، مثل من خلق مكفوف البصر؛ وان كانت قد أدركت بالفعل تارةً، ثم صارت بالقوة، فانها ما دامت بالقوة تشتاق إلى الإدراك بالفعل لأنها قد تعرفت إلى المدرك، وتعلقت به، وحنت إليه، مثل من كان يصيراً ثم عمي فانه لا يزال يشتاق إلى المبصرات. وبحسب ما يكون الشيء المدرك أتم وأبهى وأحسن، يكون الشوق أكثر؛ والتألم لفقده اعظم، ولذلك كان تألم من يفقد بصره بعد الرؤية أعظم من تألم من يفقد شمه، إذ الأشياء التي يدركها البصر أتم وأحسن من التي يدركها الشم، فان كان في الأشياء شيء لا نهاية لكماله، ولا غاية لحسنه وجماله وبهائه، وهو فوق الكمال والبهاء والجمال، وليس في الوجود كمال، ولا حسن، ولا بهاء، ولا جمال إلا صادر من جهته، وفائض من قبله، فمن فقد إدراك ذلك الشيء بعد إن تعرف به، فلا محالة أنهما ما دام فاقد له، يكون في ألام لا نهاية لها، كما أن من كان مدركاً له على الدوام، فانه يكون في لذة لا انفصام لها، وغبطة لا غاية لها ورائها، وبهجة وسرور لا نهاية لهما. وقد تبين له أن الموجود الواجب الوجود.
+
+متصف بأوصاف الكمال كلها، ومنزه عن الصفات النقص وبريء منها. وتبين له أن الشيء الذي به يتوصل إلى أدركه أمر لا يشبه الأجسام، ولا يفسد لفسادها؛ فظهر له بذلك أن من كانت له مثل هذه الذات، المعدة لمثل هذا الإدراك؛ فانه إذا أطرح البدن بالموت؛ فإما أن يكون قبل ذلك - في مدة تصريفه للبدن - لم يتعرف قط بهذا الموجود الواجب الوجود؛ ولا اتصل به؛ ولا سمع عنه؛ فهذا إذا فارق البدن لا يشتاق إلى ذلك الموجود ولا يتألم لفقده. واما جميع القوى الجسمانية، فانها تبطل ببطلان الجسم؛ فلا تشتاق أيضاً إلى مقتضيات تلك القوى، ولا تحن إليها، ولا تتألم لفقدها. وهذه حال البهائم غير الناطقة كلها: سواء كانت من صورة الإنسان أو لم تكن. واما إن يكون قبل ذلك - في مدة تصريفه للبدن - قد تعرف بهذا الموجود، وعلم ما هو عليه من الكمال والعظمة والسلطان والحسن إلا انه أعرض عنه واتبع هواه، حتى وافته منيته وهو على تلك الحال، فيحرم المشاهدة، وعنده الشوق إليها فيبقى في عذاب طويل، وألام لا نهاية لها. فأما من يتخلص من تلك الآلام بعد جهد طويل، ويشاهد ما تشوق إليه قبل ذلك، واما أن يبقى في آلامه بقاءً سرمدياً، بحسب استعداده لكل واحد من الوجهين لحياته الجسمانية.
+
+واما من تعرف بهذا الموجود الواجب الوجود، قبل أن يفارق البدن، واقبل بكليته عليه والتزم الفكرة في جلاله وحسن بهائه، ولم يعرض عنه حتى وافته منيته، وهذا على حال من الإقبال والمشاهدة بالفعل. فهذا إذا فارق البدن بقي في لذة لا نهاية لها، وغبطة وسرور وفرح دائم، لاتصال مشاهدته لذلك الموجود الواجب الوجود، وسلامة تلك المشاهدة من الكدر والشوائب؛ ويزول عنه ما تقتضيه هذه القوى الجسمانية من الأمور الحسية التي هي - بالإضافة إلى تلك الحال - ألام وشرور وعوائق. فلما تبين له أن كمال ذاته ولذتها إنما هو بمشاهدة ذلك الموجود الواجب الوجود على الدوام، مشاهدة بالفعل أبداً، حتى لا يعرض عنه طرفة عين لكي توافيه منيته، وهو في حال المشاهدة بالفعل، فتتصل لذته دون أن يتخللها ألم. ثم جعل يتفكر كيف يتأتى له دوام هذه المشاهدة بالفعل، حتى لا يقع منه أعراض فكان يلازم الفكرة في ذلك الموجود كل ساعة، فما هو إلا يسنح لبصره محسوس ما من المحسوسات، أو يخرق سمعه صوت بعض الحيوان، أو يتعرضه خيال من الخيالات، أو يناله ألم في أحد اعضائه، أو يصيبه الجوع أو العطش أو البرد أو الحر، أو يحتاج القيام لدفع فضوله؛ فتختل فكرته، ويزول عما كان فيه، ويتعذر عليه الرجوع إلى ما كان عليه من حال المشاهدة، إلا بعد جهد. وكان يخاف أن تفاجأه منيته وهو في حال الأعراض، فيفضي إلى الشقاء الدائم، وألم الحجاب.
+
+فساءه حاله ذلك، وأعياء الدواء. فجعل يتصفح أنواع الحيوانات كلها، وينظر أفعالها وما تسعى فيه، لعله يتفطن في بعضها أنها شعرت بهذا الموجود، وجعلت تسعى نحوه، فيتعلم منها ما يكون في سبب نجاته. فرآها كلها إنما تسعى في تحصيل غذائها، ومقتضى شهواتها من المطعوم والمشروب والمنكوح، والاستظلال والاستدفاء، وتجد في ذلك ليلها ونهارها إلى حين مماتها وانقضاء مدتها. ولم ير شيئاً منها ينحرف عن هذا الرأي، ولا يسعى لغيره في وقت من الأوقات، فبان له بذلك أنها لم تشعر بذلك الموجود ولا اشتاقت إليه، ولا تعرفت إليه بوجه من الوجوه، وأنها كلها صائرة إلى العدم، أو إلى حال شبيه بالعدم. فلما حكم على ذلك بالحيوان، علم أن الحكم على النبات أولى، إذ ليس للنبات من الادراكات إلا بعض ما للحيوان. وإذا كان الأكمل إدراكاً لم يصل إلى هذه المعرفة، فالأنقص إدراكاً أحرى أن لا يصل، مع انه رأى أيضاً أن أفعال النبات كلها لا تتعدى الغذاء والتوليد. ثم انه بعد ذلك نظر إلى الكواكب والأفلاك فرآها كلها منتظمة الحركات، جارية على نسق؛ ورآها شفافة ومضيئة بعيدة عن قبول التغيير والفساد، فحدس حدساً قوياً أن لها ذوات سوى أجسامها، تعرف ذلك الموجود الواجب الوجود، وأن تلك الذوات العارفة ليست بأجسام، ولا منطبعة في أجسام مثل ذاته، هو، العارفة، وكيف لا يكون لها مثل تلك الذوات البريئة عن الجسمانية، ويكون لمثله على ما به من الضعف وشدة الاحتياج إلى الأمور المحسوسة، وأنه من جملة الأجسام الفاسدة؟ ومع ما به من النقص، فلم يعقه ذلك عن أن تكون ذاته بريئة عن الأجسام لا تفسد، فتبين له بذلك أن الأجسام السماوية أولى بذلك، وعلم أنها تعرف ذلك الموجود الواجب الوجود وتشاهد على الدوام بالفعل، لأن العوائق التي قطعت به هو عن الدوام المشاهدة من العوارض المحسوسة، لا يوجد مثلها للأجسام السماوية.
+
+ثم انه تفكر: لم اختص هو من بين سائر أنواع الحيوانات بهذه الذات التي أشبه بها الأجسام السماوية. وقد كان تبين له أولاً من آمر العناصر واستحالة بعضها إلى بعض، وأن جميع ما على وجه الأرض لا يبقى على صورته؛ بل الكون والفساد متعاقبان عليه أبداً، وأن أكثر هذه الأجسام مختلطة مركبة من أشياء متضادة، ولذلك تؤول إلى الفساد، وانه لا يوجد منه شيء صرفاً، وما كان منها قريباً من أن يكون صرفاً خالصاً لا شائبة فيه، فهو بعيد عن الفساد جداً مثل الذهب والياقوت، وأن الأجسام البسيطة صرفة، ولذلك هي بعيدة عن الفساد، والصور لا تتعاقب عليها. وتبين له هنالك أن جميع الأجسام التي في عالم الكون والفساد، منها ما تتقوم حقيقتها بصورة واحدة زائدة على معنى الجسمية - وهذه هي الاسطقسات الأربع - ومنها ما تتقوم حقيقتها أكثر من ذلك كالحيوان والنبات. فما كان قوام حقيقته بصور أقل، كانت أفعاله أقل، وبعده عن الحياة أكثر، فان عدم الصورة جملة لم يكن فيه إلى الحياة طريق، وصار في حال شبيه بالعدم، وما كان قوام حقيقته بصور أكثر، كانت أفعاله أكثر، ودخوله في حال الحياة أبلغ؛ وان كانت تلك الصورة بحيث لا سبيل إلى مفارقتها لمادتها التي اختصت بها كانت الحياة حينئذ كامل الظهور والكمال والقوة. فالشيء العديم للصورة جملة هو الهيولى والمادة، ولا شيء من الحياة فيها وهي شبيهة بالعدم، والشيء المتقوم بصورة واحدة هي الاسطقسات الأربع وهي في أول مراتب الوجود في عالم الكون والفساد ومنها تتركب الأشياء ذوات الصور الكثيرة. وهذه الاسطقسات ضعيفة الحياة جداً، إذ ليست تتحرك إلا حركة واحدة، وانما كانت ضعيفة الحياة لان لكل واحد منها ضداً ظاهر العناد يخالفه في مقتضى طبيعته، ويطلب أن يغير صورته.
+
+فوجوده لذلك غير متمكن، وحياته ضعيف، والبات أقوى حياة منه والحيوان أظهر حياة منه. وذلك أن ما كان من هذه المركبات تغلب عليه طبيعة أسطقس واحد، فلقوته فيه يغلب طبائع الاسطقسات الباقية، ويبطل قواها، ويصير ذلك المركب في حكم الاسطقس الغالب، فلا يستأهل لاجل ذلك من الحياة آل شيئا يسيراً، كما إن ذلك الاسطقس لا يستأهل من الحياة إلا يسيراً ضعيفاً وما كان من هذه المركبات لا تغلب عليه طبيعة أسطقس واحد منها، فان الاسطقسات تكون فيه متعادلة متكافئة، فإذن لا يبطل لأحدهما الآخر قوة الآخر بأكثر مما يبطل ذلك الآخر قوته، بل يفعل بعضها في بعض فعلاً متساوياً، فلا يكون فعل أحد الاسطقسات أظهر فيه، ولا يستولي عليه أحدها، فيكون بعيد الشبه من كل واحد من الاسطقسات، فكأنه لا مضادة لصورته، فيستأهل الحياة بذلك. ومتى زاد هذا الاعتدال وكان أتم وأبعد من الانحراف، كان بعده عن أن يوجد له ضد أكثر، وكانت حياته أكمل. ولما كان الروح الحيواني الذي مسكنه القلب، شديد الاعتدال، لانه ألطف من الأرض والماء وأغلظ من النار والهواء، صار في حكم الوسط ولم يضاده شيء من الاسطقسات مضادة بينه.
+
+فاستعد بذلك الصورة الحيوانية، فرأى أن الواجب إلى ذلك أن يكون أعدل ما في هذه الأرواح الحيوانية مستعداً لاتمم ما يكون من الحياة في عالم الكون والفساد، وأن يكون ذلك الروح قريباً من أن يقال أنه لا ضد لصورته، فيشبه لذلك هذه الأجسام السماوية التي لا ضد لصورها؛ ويكون روح ذلك الحيوان، وكأنه وسط بالحقيقة بين الاسطقسات التي لا تتحرك إلى جهة العلو على الإطلاق، ولا إلى جهة السفل، بل لو أمكن أن يجعل في وسط المسافة بين المراكز وأعلى ما تنتهي إليه النار في جهة العلو ولم يطرأ عليه الفساد، لثبت هناك ولم يطلب الصعود ولا نزول. ولو تحرك في المكان، لتحرك حول الوسط كما تتحرك الأجسام السماوية، ولو تحرك في الوضع، لتحرك على نفسه، وكان كروي الشكل إذ لا يمكن غير ذلك، فإذن هو شديد الشبه بالأجسام السماوية. ولما كان قد اعتقد أن أحوال الحيوان، ولم ير فيها ما يظن به انه شعر بالموجود الواجب الوجود، وقد كان علم من ذاتها قد شعرت به، قطع ذلك على أنه هو الحيوان المعتدل الروح، الشيبة بالأجسام السماوية وتبين لو انه نوع مباين لسائر الحيوان، وانه إنما خلق لغاية أخرى، وأعد لامر عظيم، لم يعد له شيء من أنواع الحيوان، وكفى به شرفاً أن يكون أحس جزأيه - وهو الجسماني - أشبه الأشياء بالجواهر السماوية الخارجة عن عالم الكون والفساد، المنزهة عن الحوادث النقص والاستحالة والتغيير. وأما أشرف جزأيه، فهو الشيء الذي به عرف الموجود الواجب الوجود، وهذا الشيء العارف، أمر رباني الهي يستحيل ولا يلحقه الفساد، ولا يوصف بشيء مما توصف به الأجسام، ولا يدرك بشيء من الحواس، ولا يتخيل، ولا يتوصل إلى معرفته بآلة سواه، بل يتوصل إليه به؛ فهو العارف والمعروف، والمعرفة؛ وهو العالم، والمعلوم، والعلم؛ لا يتباين في شيء من ذلك، إذ التباين والانفصال من صفات الأجسام ولواحقها، ولا جسم هنالك ولا صفة جسم ولا لاحق بجسم! فلما تبين له الوجه الذي اختص به من بين سائر أصناف الحيوان بمشابهة الأجسام السماوية، رأى إن الواجب عليه أن يتقبلها ويحاكي أفعالها ويتشبه بها جهده. وكذلك رأى أنه بجزئه الاشرف الذي به عرف الموجود الواجب الوجود، فيه شبه ما منه من حيث هو منزه عن صفات الأجسام، وكما أن الواجب الوجود منزه عنها، فرأى ايضاً انه يجب عليه أن يسعى في تحصيل صفاته لنفسه من أي وجه أمكن، وان يتخلق بأخلاقه ويقتدي بأفعاله، ويجد في تنفيذ إرادته، ويسلم الآمر له، ويرضى بجميع حكمه، رضى من قلبه ظاهراً وباطناً، بحيث يسر به وان كان مؤلماً لجسمه وضاراً به ومتلفتاً لبدنه بالجملة. وكذلك رأى فيه شبهاً من سائر أنواع الحيوان بجزئه الخسيس الذي هو من عالم الكون والفساد، وهو البدن المظلم والكثيف، الذي يطالبه بأنواع المحسوسات من المطعوم والمشروب والمنكوح، ورأى أيضاً أن ذلك البدن لم يخلق له عبثاً ولا قرن به لامر باطل، ويجب عليه أن يتفقده ويصلح من شأنه. هذا التفقد لا يكون منه إلا بفعل يشبه أفعال سائر الحيوان. فاتجهت عنده الأعمال التي يجب عليه أن يفعلها نحو ثلاثة أغراض: أما عمل يتشبه بالحيوان الغير الناطق.
+
+واما عمل يتشبه به بالأجسام السماوية. واما عمل يتشبه به بالموجود الواجب الوجود. فالتشبه الأول: يجب عليه من حيث البدن المظلم ذو الأعضاء المنقسمة، والقوى المختلفة، والمنازع المتفننة. والتشبه الثاني: يجب عليه من حيث له الروح الحيواني الذي مسكنه القلب، وهو مبدأ لسائر البدن، ولما فيه من القوى. والتشبه الثالث: يجب عليه من حيث هو، أي: من حيث هو الذات التي بها عرف ذلك الموجود الواجب الوجود. وكان أولاً قد وقف على أن سعادته وفوزه من الشقاء، إنما هي في دوام المشاهدة لهذا الموجود الواجب الوجود، حتى يكون بحيث لا يعرض بطرفة عين. ثم أنه نظر بالوجه الذي يتأتى له به هذا الدوام، فأخر له النظر أنه يجب عليه الاعتمال في هذه الأقسام الثلاثة من التشبيهات: آما التشبه الأول، فلا يحصل له به شيء من هذه المشاهدة، بل هو صارف عنها وعائق دونها، إذ هو تصرف في الأمور المحسوسة، والأمور المحسوسة كلها حجب معترضة دون تلك المشاهدة؛ وانما احتيج إلى هذا التشبه لاستدامة هذا الروح الحيواني الذي يحصل به التشبه الثاني بالأجسام السماوية.
+
+فالضرورة تدعو إليه من هذا الطريق،ولو كان لا يخلو من تلك المضرة. واما التشبه الثاني، فيحصل له به حظ عظيم من المشاهدة على الدوام، لكنها مشاهدة يخالطها شوب؛ اذ من يشاهد ذلك النحو من المشاهدة على الدوام فهو مع تلك المشاهدة يعقل ذاته ويلتفت إليه حسبما يتبين بعد هذا. واما التشبه الثالث، فتحصل به المشاهدة الصرفة، والاستغراق المحض الذي لا التفات فيه بوجه من الوجوه الا إلى الموجود الواجب الوجود، والذي يشاهد هذه المشاهدة قد غابت عنه ذات نفسه وفنيت وتلاشت. وكذلك سائر الذوات، كثيرة كانت أو قليلة، إلا ذات الواحد الحق الواجب الوجود - جل وتعالى وعز. فلما تبين له أن مطلوبه الأقصى هو هذا التشبه الثالث، وأنه لا يحصل له إلا بعد التمرن والاعتمال مدة طويلة في التشبه الثاني، وان هذه المدة لا تدوم له بالتشبه الأول، وعلم أن التشبه الأول - وان كان ضرورياً، فانه عائق بذاته وان كان معيناً بالعرض لا بالذات لكنه ضروري- فألزم نفسه أن لا يجعل لها حظاً من هذا التشبه الأول، إلا بقدر الضرورة، وهي الكفاية التي لا بقاء للروح الحيواني بأقل منها. ووجد ما تدعو إليه الضرورة في بقاء هذا الروح أمرين: أحدهما: ما يمده من الداخل، ويخلف عليه بدل ما يتخلل منه وهو الغذاء. والأخر: ما يقيه من الخارج، ويدفع عنه وجوه الأذى: من البرد والحر والمطر ولفح الشمس والحيوانات المؤذية ونحو ذلك. ورأى أنه إن تناول ضرورية من هذه جزافاً كيفما اتفق، ربما وقع في السرف واخذ فوق الكفاية. فكان سعيه على نفسه من حيث لا يشعر، فرأى أن الحزم له أن يفرض لنفسه فيها حدوداً لا يتعداها، ومقادير لا يتجاوزها، وبأن له الفرض يجب أن يكون في جنس ما يتغذى به. وأي شيء يكون وفي مقداره وفي المدة التي تكون بين العبادات إليه. فنظر أولاً إلى أجناس ما به يتغذى، فرآها ثلاثة أضرب: أولاً: أما نبات لم يكمل بعد نضجه ولم ينته إلى غاية تمامه، وهي أصناف البقول الرطبة التي يمكن الاغتذاء بها.
+
+ثانياً: واما ثمرات النبات الذي تم وانتهى وأخرج بذرة ليتكون منه أخر من نوعه حفظاً له، وهي أصناف الفواكه رطبها ويابسها. ثالثاً: واما حيوان من الحيوانات التي يتغذى بها: أما البرية واما البحرية. وكان قد صح عنده أن هذه الأجناس كلها، من فعل ذلك الموجود الواجب الوجود الذي تبين له أن سعادته في القرب منه، وطلب التشبه به، ولا محالة أن الاغتذاء بها مما يقطعها عن كمالها ويحول بينها وبين الغاية القصوى المقصودة بها. فكان ذلك اعتراض على فعل الفاعل. وهذا الاعتراض مضاد لما يطلبه من القرب منه والتشبه به. فرأى أن الصواب كان له لو أمكن أن يمتنع عن الغذاء جملة واحدة، لكنه لما لم يمكنه ذلك، لانه أن امتنع عنه أل ذلك إلى فساد جسمه، فيكون ذلك اعتراضاً على فاعله أشد من الأول، إذ هو أشرف من تلك الأشياء الآخر التي يكون فسادها سبباً لبقائه.
+
+فاستهل أيسر الضررين، وتسامح في اخف الاعتراضين، ورأى إن يأخذ من هذه الأجناس إذا عدمت آيها تيسر له، بالقدر الذي يتبين له بعد هذا. فأما إن كانت كلها موجودة فينبغي له حينئذ إن يتثبت ويتخير منها ما لم يكن في أخذه كبير اعتراض على فعل فاعل، وذلك مثل لحوم الفواكه التي قد تناهت في الطيب، وصلح ما فيها لتوليد البزر على الشرط التحفظ على ذلك البزر، بان لا يأكله ولا يفسده ولا يلقيه في موضع لا يصلح للنبات، مثل الصفاة والسبخة ونحوهما. فان تعذر عليه وجود مثل هذه الثمرات ذات الطعم الغاذي، كالتفاح والكمثرى والأجاص ونحوها، كان له عند ذلك إن يأكل آما الثمرات التي لا يغذو منها إلا نفس البزر، كالجوز والقسطل، واما من البقول التي لم تصل بعد حد كمالها. والشرط عليه في هذين لأن يقصد أكثرها وجوداً وأقواها توليداً، وان لا يستأصل أصولها ولا يفني بزرها. فان عدم هذه، فله أن يأخذ من الحيوان آو من بيضه، والشرط عليه من الحيوان إن يأخذ من أكثره وجوداً، ويستأصل منه نوعاً بأسره. هذا ما رأى في جنس ما يتغذى به. واما المقدر فرأى أن يكون بحسب ما يسد خلة الجوع ولا يزيد عليها. واما الزمان الذي بين كل عودتين، فرأى انه إذا اخذ حاجته من الغذاء، أن يقيم عليه ولا يتعرض لسواه، حتى يلحقه ضعف يقطع به بعض الأعمال التي تجب عليه في التشبه الثاني، وهي التي يأتي ذكرها بعد هذا. فأما ما تدعو إليه الضرورة في بقاء الروح الحيواني مما يقيه من خارج، فكان الخطب فيه يسيراً: إذ كان مكتسياً بالجلود، وقد كان له مسكن يقيه مما يرد عليه من خارج، فاكتفى بذلك ولم يرى الاشتغال به، والتزم في غذائه القوانين التي رسمها لنفسه، وهي التي تقدم شرحها. ثم اخذ في العمل الثاني، وهو التشبه بالأجسام السماوية والاقتداء بها، والتقبل أوصافها، فانحصرت عنده في ثلاثة أضرب: الضرب الأول: أوصاف لها بالإضافة إلى ما تحتها من عالم الكون والفساد، وهي ما تعطيه إياه من التسخين بالذات، آو التبريد بالعرض، والإضاءة والتلطيف والتكثيف، إلى سائر ما تفعل فيه من الأمور التي بها يستعد لفيضان الصور الروحانية عليه من عند الفاعل الواجب الوجود. والضرب الثاني: أوصاف لها في ذاتها، مثل كونها شفافة وناصعة وطاهرة منزهة عن الكدر وضروب الرجس، ومتحركة بالاستدارة بعضها على مركز نفسها، وبعضها على مركز غيرها.
+
+والضرب الثالث: أوصاف لها بالإضافة إلى الموجود الواجب الوجود، مثل كونها تشاهد مشاهدة دائمة، وتعرض عنه، وتتشوق إليه، وتتصرف بحكمه، وتتسخر في تتميم إرادته، ولا تتحرك إلا بمشيئته وفي قبضته. فجعل يتشبه بها جهده في كل من هذه الاضرب الثلاثة. آما الضرب الأول: فكان تشبه بها فيه: إن ألزم نفسه إن لا يرى ذا حاجة آو عاهة آو مضرة، أو ذا عائق من الحيوان أو النبات، وهو يقدر على أزالتها عنه إلا ويزيلها. فمتى وقع بصره على نبات قد حجبه عن الشمس حاجب آو تعلق به نبات آخر يؤذيه، أو عطش عطشاً يكاد يفسده، أزال عنه ذلك الحاجب إن كان ما يزال، وفصل بينه وبين ذلك المؤذي بفاصل لا يضر المؤذي، وتهده بالسقي ما أمكنه. ومتى وقع بصره على حيوان قد أرهقه سبع آو نشب به ناشب، آو تعلق به شوك، آو سقط على عينيه آو آذنيه شيء يؤذيه، آو مسه ظمأ آو جوع، تكفل بإزالة ذلك كله عنه جهده واطعمه وسقاه. ومتى وقع بصره على ماء يسيل إلى سقي نبات أو حيوان وقد عاقه عن ممره ذلك عائق، من حجر سقط فيه، آو جرف انهار عليه، ازال ذلك كله عنه. وما زال يمعن في هذا النوع من ضروب التشبه حتى بلغ فيه الغاية. واما الضرب الثاني: فكان تشبهه بها فيه إن الزم نفسه دوام الطهارة وإزالة الدنس والرجس عن جسمه والاغتسال بالماء في أكثر الأوقات، وتنظيف ما كان من أظافره واسنانه ومغابن بدنه، وتطيبها بما أمكن من طيبات النبات وصنوف الدهون العطرة، وتعهد لباسه بالتنظيف والتطييب حتى كان يتلألأ حسناً وجمالاً ونظافة وطيباً. والتزم مع ذلك ضروب الحركة على الاستدارة: فتارةً كان يطوف بالجزيرة، ويدور على ساحلها ويسيح باكنافها، وتارةً كان يطوف ببيته، او ببعض الكدى أدوارا معدوده: آما مشياً، آما هرولة؛ وتارة يدور على نفسه حتى يغشه عليه.
+
+وأما الضرب الثالث: فكان تشبهه بها فيه، إن كان يلازم الفكرة في تلك الموجود الواجب الوجود، ثم يقطع علائق المحسوسات. ويغمض عينيه، ويسد أذنيه، ويضرب جهده عن تتبع الخيال، ويروم بمبلغ طاقته إن لا يفكر في شيء سواه، ولا يشترك به احداً ويستعين على ذلك بالاستدارة على نفسه والاستحثاث فيها.
+
+فكان اذا اشتد في الاستدارة، غابت عنه جميع المحسوسات، وضعف الخيال وسائر القوى التي إلى الألأت الجسمانية، وقوي فعل ذاته - التي هي بريئة من الجسم - فكانت في بعض الأوقات فكرته قد تخلص عن الشوب ويشاهد بها الموجود الواجب الوجود، ثم تكر عليه القوى الجسمانية فتفسد عليه حاله، وترده إلى اسفل السافلين. ويعود من ذي قبل، فان لحقه ضعف يقطع به عن غرضه تناول بعض الأغذية عن الشرائط المذكورة. ثم انتقل إلى شأنه من التشبه بالأجسام السماوية بالأضرب الثلاثة المذكورة. ودأب على ذلك مدة وهو يجاهد قواه الجسمانية وتجاهده، وينازعها وتنازعه في الأوقات التي يكون له عليها الظهور، وتتخلص فكرته عن الشوب، يلوح له شيء من أحوال أهل التشبه الثالث.
+
+ثم جعل يطلب التشبه الثالث، ويسعى في تحصيله، فينظر في صفات الموجود الواجب الوجود. وقد كان تبين له أثناء نظره العلمي قبل الشروع في العمل، إنها على ضربين: آما صفة ثبوت: كالعلم والقدرة والحكمة.
+
+وأما صففة سلب: كتنزه عن الجسمانية وعن صفات الأجسام ولواحقها، وما يتعلق بها، ولو على بعد.
+
+وأن صفات الثبوت يشترط فيها هذا التنزيه حتى لا يكون فيها شيء من صفات الأجسام التي من جملتها الكثرة، فلا تتكثر ذاته بهذه الصفات الثبوتية، ثم ترجع كلها إلى معنى واحد هي حقيقة ذاته. فجعل يطلب كيف يتشبه به في كل واحد من هذين الضربين. آما صفات الاجاب، فلما علم انها كلها راجعة إلى حقيقة ذاته، وانه لا كثرة فيها بوجه من الوجوه، إذ الكثرة من صفات الأجسام؛ وعلم إن علمه بذاته؛ ليس معنى زائداً على ذاته، بل ذاته هي علمه لذاته؛ وعلمه بذاته هو ذاته، تبين له انه إن أمكنه هو إن يعلم ذاته، فليس ذلك العلم الذي علم به ذاته معنى زائداً على ذاته، بل هو هو! فرأى إن التشبه به من صفات الاجاب، هو ان يعلمه فقط دون إن يشرك به شيئاً من صفات الأجسام؛ فاخذ نفسه بذلك. واما صقات السلب، فانها كلها راجعة إلى التنزه عن الجسمية. فجعل يطرح اوصاف الجسمية عن ذاته. وكان قد طرح منها كثيراً في رياضته المتقدمة التي كان ينحو بها بالتشبه بالأجسام السماوية. إلا انه أبقى منها بقايا كثيرة: كحركة الاستدارة - والحركة من أخص صفات الأجسام - وكل الاعتناء بأمر الحيوان والنبات والرحمة لها، والاهتمام بإزالة عوائقها. فان هذه أيضاً من صفات الأجسام، إذ لا يراها أولاً إلا بقوة جسمانية، ثم يكدح بأمرها بقوة جسمانية أيضاً. فاخذ في طرح ذلك كله عن نفسه، إذ هي بجملتها مما لا يليق بهذه الحالة التي يطلبها الآن.
+
+وما زال يقتصر على السكون في قصر مغارته مطرقاً، غاضاً بصره، معرضاً عن جميع المحسوسات والقوى الجسمانية، مجتمع الهم والفكرة في الموجود الواجب الوجود وحده دون شركه؛ فمتى سنح بخياله سانح سواه، طرده عن خياله جهده، ودافعه وراض نفسه على ذلك، ودأب فيه مدة طويلة، بحيث تمر عليه عدة أيام لا يتغذى فيها ولا يتحرك. وفي خلال شدة مجاهدته هذه ربما كانت تغيب عن ذكره وفكره جميع الأشياء إلا ذاته، فانها كانت لا تغيب عنه في وقت استغراقه بمشاهدة الموجود الأول الحق الواجب الوجود.
+
+فكان يسوءه ذلك، ويعلم انه شوب في المشاهدة المحضة، وشركه في الملاحظة. ومازال يطلب الفناء عن نفسه والإخلاص في مشاهدة الحق حتى تأتى له ذلك، وغابت عن ذكره وفكره السموات والأرض وما بينهما، وجميع الصور الروحانية والقوى الجسمانية، وجميع القوى المفارقة للمواد، والتي هي الذوات العارفه بالموجود الحق؛ وغابت ذاته في جملة تلك الذوات، وتلاشى الكل واضمحل، وصار هباءً منثوراً، ولم يبقى إلا الواحد الحق الموجود الثابت الوجود.
+
+وهو يقول بقوله الذي ليس معنى زائداً على ذاته: "بسم الله الرحمن الرحيم" لمن الملك اليوم لله الواحد القهار صدق الله العظيم ففهم كلامه وسمع ندائه ولم يمنعه عن فهمه كونه لا يعرف الكلام، ولا يتكلم.
+
+واستغرق في حالته هذه وشاهد ما لا عين رأت ولا إذن سمعت! ولا خطر على قلب بشر. فلا تعلق قلبك بوصف آمر لم يخطر على قلب بشر، فان كثيراً من الأمور التي تخطر على قلوب البشر قد يتعذر وصفه، فكيف بأمر لا سبيل إلى خطورة على القلب، ولا هو من عالمه ولا من طوره!؟ ولست أعني بالقلب جسم القلب، ولا الروح التي في تجويفه بل أعني صورة تلك الروح الفائضة بقواها على بدن الإنسان، فان كل واحد من هذه الثلاثة قد يقال له قلب ولكن لا سبيل لخطور ذلك الآمر على واحد من هذه الثلاثة، ولا يتأتى التعبير إلا عما الخطر علها.
+
+ومن رام التعبير عن تلك الحال، فقد رام مستحيلاً وهو بمنزلة من يريد أن يذوق الألوان من حيث هي الألوان، ويطلب أن يكون السواد مثلاً حلواً أو حامضاً.
+
+لكنا، مع ذلك، لا نخيلك عن إشارات نومئ بها إلى ما شاهده من عجائب ذلك المقام، على سبيل ضرب المثل، لا على سبيل قرع باب الحقيقية. إذ لا سبيل إلى التحقق بما في ذلك المقام إلا بالوصول إليه.
+
+فأصغ الآن بسمع قلبك، وحدق ييصر إلى ما أشير به اليك لعلك أن تجد منه هدياً يلقيك على جادة الطريق! وشرطي عليك أن لا تطلب مني في هذا الوقت مزيد بيان بالمشافهة على ما أودعه هذه الاوراق فان المجال ضيق، والتحكم بالألفاظ على آمر ليس من شأنه أن يلفظ به خطر.
+
+فأقول: انه لما فني عن ذاتهوعن جميع وعن جميع الذوات ولم ير في الوجود إلا الواحد القيوم، وشاهد ما شاهد، ثم عاد إلى ملاحظة الاغيار عندما آفاق من حالة تلك التي شبيه بالسكر، خطر بباله انه لا ذات له يغاير بها ذات الحق تعالى، وان حقيقة ذاته هي ذات الحق، وان الشيء الذي كان يظن أولاً انه ذات المغايرة لذات الحق، ليس شيئاً في الحقيقة، بل ليس ثم شيء إلا ذات الحق، وان ذلك بمنزلة نور الشمس الذي يقع على الأجسام الكثيفة فتراه يظهر فيها.
+
+فإنه وإن نسب إلى الجسم الذي يظهر فيه، فليس هو في الحقيقية شيئاً سوى نور الشمس. وان زال ذلك الجسم زال نوره، وبقي نور الشمس بحاله لم ينقص عند حضور ذلك الجسم ولم يزد عند مغيبه.
+
+ومتى حدث جسم يصلح لقبول ذلك النور، قبله، فإذا عدم الجسم عدم ذلك القبول، ولك يكن له معنى، عنده هذا الظن بما قد بان له من إن ذات الحق، عز وجل، لا تتكثر بوجهه من الوجوه، وأن علمه بذاته، وهو ذاته بعينها.
+
+فلزم عنده من هذا أن حصل عنده العلم بذاته، فقد حصلت عنده ذاته، وقد كان حصل عنده العلم فحصلت عنده الذات.
+
+وهذه الذات لا تحصل إلا عند ذاتها، ونفس حصولها هو الذات؛ فإذن هو الذات بعينها. وكذلك جميع الذوات المفارقة للمادة العارفة بتلك الذات الحقه التي كان يراها أولاً كثيرة، وصارت عنده بهذا الظن شيئاً واحداً. وكادت هذه الشبه ترسخ في نفسه لولا أن تداركه الله برحمته وتلافاه بهدايته، فعلم إن الشبهة انما ثارت عنده من بقايا ظلمة الأجسام، وكدورة المحسوسات. فان الكثير والقليل والواحد والوحدة، والجمع والاجتماع، والافتراق، هي كلها من صفات الأجسام، وتلك الذوات المفارقة العارفة بذات الحق، عز وجل، لبرائتها عن المادة، لا يجب إن يقال انها كثيرة، ولا واحدة، لان الكثرة انما هي مغايرة الذوات بعضها لبعض، والوحدة أيضاً لا تكون إلا بالاتصال. ولا يفهم شيء من ذلك إلا في المعاني المركبة المتلبسة بالمادة. غير إن العبارة في هذا الموضع قد تضيق جداً لانك إن عبرت عن تلك الذوات المفارقة بصيغة الجمع حسب لفظنا هذا، أوهم ذلك معنى الكثرة فيها، وهي بريئة عن الكثرة. وان أنت عبرت بصيغة الإفراد، اوهم ذلك معنى الاتحاد، وهو مستحيل عليها. وكأني بمن يقف على هذا الموضع من الخفافيش الذين تظلم الشمس في أعينهم يتحرك في سلسلة جنونه، ويقول: لقد افرطت في تدقيقك حتى انك قد انخلعت عن غريزة العقلاء، واطرحت حكم معقول، فان من أحكام العقل إن الشيء آما واحد واما كثير، فليتئد في غلوائه، وليكف من غرب لسانه وليتهم نفسه، وليعتبر بالعالم المحسوس الخسيس الذي هو أطباقه بنحو ما اعتبر به حي بن يقظان حيث كان بنظر فيه بنظر فيراه كثيراً كثرة لا تنحصر ولا تدخل تحت حد، ثم ينظر فيه بنظر آخر، فيراه واحداً. وبقي في ذلك متردداً ولم يكنه إن يقطع بأحد الوصفين دون الآخر. هذا فالعالم المحسوس منشأ الجمع والإفراد، وفيه الانفصال والاتصال، والتحيز والمغايرة، والاتفاق والاختلاف، فما ظنه بالعالم الإلهي الذي لا يقال فيه كل ولا بعض، ولا ينطق في أمره بلفظ من الألفاظ المسموعة، إلا وتوهم فيه شيء على خلاف الحقيقة، فلا يعرفه إلا من شاهده؛ ولا تثبت حقيقته إلا عند من حصل فيه. واما قوله: حتى انخلعت عن غريزة العقلاء، واطرحت حكم المعقول. فنحن نسلم له ذلك، ونتركه مع عقله وعقلائه، فان العقل الذي يعنيه هو أمثاله، انما هو القوة الناطقة التي تتصفح أشخاص الموجودات المحسوسة، وتقتنص منها المعنى الكلي. والعقلاء الذين يعنيهم، هم ينظرون من هذا النظر والنمط الذي كلامنا فيه فوق هذا كله، فليسد عنه سمعه من لا يعرف سوى المحسوسات وكلياتها، وليرجع إلى فريقه الذين "بسم الله الرحمن الرحيم" يعملون ظاهراً من الحياة الدنيا. وهم عن الآخرة هم غافلون. صدق الله العظيم. فان كنت ممن يقتنع بهذا النوع من التلويح والإشارة إلى ما في العالم الإلهي، ولا تحمل ألفاظاً من المعاني على ما جرت العادة بها في تحميلها إياه، فنحن نزيدك شيئاً مما شاهده حي بن يقظان في مقام أولي الصدق الذي تقدم ذكره، فتقول: انه بعض الاستغراق المحض، والفناء التام، وحقيقة الوصول، وشاهد للفلك الأعلى، الذي لا جسم له، ورأى ذاتاً بريئة عن المادة، ليست هي ذات الواحد الحق، ولا هي نفس الفلك، ولا هي غيرها؛ وكأنها صورة الشمس التي تظهر في مرآة من المرائي الصقيلة، فانها ليست هي الشمس ولا المرأة ولا غيرهما. وراى لذات ذلك الفلك المفارقة من الكمال والبهاء والحسن، ما يعظم عن إن يوصف بلسان، ويLine truncated
+
+فلما سمع أسال منه وصف تلك الحقائق والذوات المفارقة لعالم الحس العارفة بذات الحق عز وجل، ووصفه ذلك الحق تعالى وجل بأوصافه الحسنى، ووصف له ما أمكنه وصفه مما شاهده عند الوصول من لذات الواصلين وألام المحجوبين، لم يشك أسال في أن جميع الأشياء التي وردت في شريعته من أمر الله عز وجل، وملائكته، وكتبه، ورسله، واليوم الآخر، وجنته وناره، هي أمثلة هذه التي شاهدها حي بن يقظان؛ فانفتح بصر قلبه وانقدحت نار خطره وتطابق عنده المعقول والمنقول، وقربت عليه طرق التأويل، ولم يبق عليه مشكل في الشرع إلا تبين له، ولا مغلق إلا انفتح، ولا غامض إلا اتضح، وصار من أولى الألباب. وعند ذلك نظر إلى حي بن يقظان بعين التعظيم والتوقير، وتحقق عنده أنه من أولياء الله الذين لا خوف عليهم ولا هم يحزنون. فالتزم خدمته والاقتداء به بإشارته فيما تعارض عنده من الأعمال الشرعية التي قد تعلمها في ملته. وجعل حي بن يقظان يستفصحه عن أمره وشأنه، فجعل أسال يصف له شأن جزيرته وما فيها من العالم، وكيف كانت سيرهم قبل وصول الملة اليهم.
+
+وكيف هي الآن بعد وصولها إليهم، وصف له جميع ما ورد في الشريعة من وصف العالم الإلهي، والجنة والنار، والبعث والنشور، والحشر والحساب، والميزان والصراط. ففهم حي بن يقظان ذلك كله ولم ير فيه شيء على خلاف ما شاهده في مقامه الكريم. فعلم أن الذي وصف ذلك وجاء به محق في وصفه، صادق في قوله، ورسول من عند ربه؛ فأمن به وصدقه وشهد برسالته.
+
+ثم جاء يسأله عما جاء به من الفرائض، ووضعه من العبادات؛ فوصف له الصلاة والزكاة، والصيام والحج، وما أشبهها من الأعمال الظاهرة؛ فتلقى ذلك والتزمه، وأخذ نفسه بأدائه امتثالاً للآمر الذي صح عنده صدق قوله.
+
+إلا انه بقي في نفسه أمران كان يتعجب منهما ولا يدري وجه الحكمة فيهما: أحدهما - لما ضرب هذا الرسول الأمثال للناس في أكثر ما وصفه من أمر العالم الإلهي، وأضرب عن المكاشفة حتى وقع الناس في أمر عظيم من التجسيم، واعتقاد أشياء في ذات الحق هو منزه عنها وبريء منها؟ وكذلك في أمر الثواب والعقاب! والآمر الآخر - لم اقتصر على هذه الفرائض ووظائف العبادات وأباح الاقتناء للأموال والتوسع في المأكل، حتى بفرغ الناس بالاشتغال بالباطل، والأعراض عن الحق؟ وكان رأيه هو لا يتناول أحد شيئاً إلا ما يقيم به من الرمق؛ واما الأموال فلم تكن لها عنده معنى.
+
+وكان يرى ما في الشرع من الأحكام في أمر الأموال: كالزكاة وتشعبها، والبيوع والربا والحدود والعقوبات، فكان يستغرب هذا كله ويراه تطويلاً، ويقول: إن الناس لو فهموا الآمر على حقيقته لاعرضوا عن هذه البواطل، وأقبلو على الحق، واستغنوا عن هذا كله، ولم يكن لاحد اختصاص بمال يسأل عن زكاته، أو تقطع الأيدي على سرقته، أو تذهب النفوس على أخذه مجاهرة.
+
+وكان الذي أوقعه في ذلك ظنه، أن الناس كلهم ذوو فطر فائقة، وأذهان ثاقبة، ونفوس عازمة، ولم يكن يدري ما هم عليه من البلادة والنقص، وسوء الرأي وضعف العزم، وأنهم كالأنعام بل هم أضل سبيلاً.
+
+فلما اشتد إشفاقه على الناس، وطمع أن تكون نجاتهم على يديه، حدثت له النية في الوصول إليهم، وإيضاح الحق لديهم، وتبييه لهم ففاوض في ذلك صاحبه أسال وسأله: هل تمكنه حيلة في الوصول اليهم؟ فأعلمه بما هم فيه من نقص الفطرة والأعراض عن آمر الله فلم يتأت له فهم ذلك، وبقي في نفسه تعلق بما كان قد أمله.
+
+وطمع أسال أيضاً أن يهدي الله على يديه طائفة من معارفه المريدين الذين كانوا أقرب من التخلص من سواهم، فساعده على رأيه، ورأيا أن يلتزما ساحل البحر ولا يفارقاه ليلاً ولا نهاراً، لعل الله إن السني لهما عبور البحر فالتزما ذلك وابتهلا الله تعالى أن يهيء لهما من أمرهما رشدأً.
+
+فكان من أمر الله عز وجل أن سفينة ضلت مسلكها، ودفعها الرياح وتلاطم الأمواج إلى ساحلها. فلما قربت من البر رأى أهلها الرجلين على الشاطئ.
+
+فدنوا منها فكلمهم أسال وسألهم أن يحملوهما معهم، فأجابوهما إلى ذلك، وأدخلوهما السفينة، فأرسل الله إليهم ريحاً رخاء حملت السفينة في أقرب مدة إلى الجزيرة التي أملاها فنزلا بها، ودخلا مدينتها، واجتمع أصحاب أسال به، فعرفهم شأن حي بن يقظان، فاشتملوا عليه شديداً وأكبروا آمره، واجتمعوا إليه واعظموه وبجلوه، وأعلمه أسال أن تلك الطائفة هم أن تلك الطائفة هم أقرب إلى الفهم والذكاء من جميع الناس، وانه إن عجز عن تعليمهم فهو عن تعليم الجمهور أعجز.
+
+وكان رأس تلك الجزيرة سلامان وهو صاحب أسال الذي كان يراه ملازمة الجماعة، ويقول بتحريم العزلة، فشرع حي بن يقظان في تعليمهم وبث أسرار الحكمة إليهم.
+
+فما هو إلا أن ترقى عن الظاهر قليلاً وأخذ في وصف ما سبق إلى فهمهم خلافه، فجعلوا ينقبضون منه وتشمئز نفوسهم مما يأتي به، ويتسخطونه بقلوبهم، وان اظهروا له الرضا في وجهه اكراماً لغربته فيهم، ومراعاة لحق صاحبهم أسال! وما زال حي بن يقظان يستلطفهم ليلاً ونهاراً، ويبن لهم الحق سراً وجهاراً، فلا يزيدهم ذلك إلا نبوأً ونفاراً، مع أنهم كانوا محبين للخير، راغبين في الحق، إلا انهم لنقص فطرتهم كانوا لا يطلبون الحق من طريقة ولا يأخذونه لجهة تحقيقه، ولا يلتمسونه من بابه، بل كانوا لا يريدون معرفته من طريق أربابه. فيأس من أصلاحهم، وانقطع رجائه من صلاحهم لقلة قبولهم.
+
+وتصفح طبقات الناس بعد ذلك، فرأى كل حزب بما لديهم فرحون، قد اتخذوا ألههم هواهم، ومعبودهم شهواتهم، وتهالكوا في جميع حطام الدنيا، ألهاهم التكاثر حتى زاروا المقابر، لا تنجح فيهم الموعظة ولا تعمل فيهم الكلمة الحسنة، ولا يزدادون بالجدل إلا إصرارا.
+
+واما الحكمة فلا سبيل لهم إليها، ولا حظ لهم منه، قد غمرتهم الجهالة وران على قلوبهم ما يكسبون ختم الله على قلوبهم وعلى سمعهم وعلى أبصارهم غشاوةً ولهم عذاب عظيم.
+
+فلما رأى سرادق العذاب قد أحاط بهم، الظالمات الحجب قد تغشتهم، والكل منهم - إلا اليسير - لا يتمسكون من ملتهم إلا بالدنيا، وقد نبذوا أعمالهم على خفتها وسهولتها وراء ظهورهم، واشتروا بها ثمناً قليلاً، وألهاهم عن ذكر الله تعالى التجارة والبيع، ولم يخافوا يوماً تنقلب فيه القلوب والابصار، لأن له وتحقق على القطع، أن مخاطبتهم بطريق المكاشفة لا تمكن وأن تكليفهم من العمل فوق هذا القدر لا يتفق، وأن حظ أكثر الجمهور من الانتفاع بالشريعة إنما هو في حياتهم الدنيا لا يستقيم له معاشه، ولا يتعدى عليه سواه فيما اختص هو به، وانه لا يفوز منه بالسعادة الأخروية إلا الشاذ النادر، وهو من أراد حرث الآخرة وسعى لها سعياً وهو مؤمن.
+
+وأما من طغى وأثر الحياة الدنيا فان الجحيم هي المأوى، وأي تعب أعظم وشقاوةً أطم ممن إذا تصفحت أعماله من وقت انتباهه من نومه إلى حين رجوعه إلى الكره لا تجد منها شيئاً إلا وهو يلتمس به تحصيل غايةً من هذه الأمور المحسوسة الخسيسة آما مال يجمعه أو لذة ينالها أو شهوة يقضيها أو غيطاً يتشفه به أو جاه يحرزه أو عمل من أعمال الشرع يتزين به أو يدافع عن رقبته، وهي كلها ظلمات بعضها فوق بعض في بحر لجي وان منكم إلا واردها كان على ربك حتماً مقضياً.
+
+فلما فهم أحوال الناس وان أكثرهم بمنزلة الحيوان غير الناطق علم أن الحكمة كلها والهداية والتوفيق فيما نطقت به الرسل ووردت به الشريعة لا يمكن غير ذلك ولا يحتمل المزيد عليه ولكل عمل رجال وكل ميسر لما خلق له "بسم الله الرحمن الرحيم" سنة الله التي قد خلت من قبل ولن تجد لسنة الله تبديلاً صدق الله العظيم.
+
+فانصرف إلى سلامان وأصحابه، فاعتذر عما تكلم به معه وتبرأ إليهم منه وأعلمهم أنه قد رآه مثل رأيهم واهتدى بمثل هديهم، وأوصاهم بملازمة ما هم عليه من التزام حدود الشرع والأعمال الظاهرة مقلة الخوض فيما لا يعنيهم، والإيمان بالمتشابهات والتسليم لها، والأعراض عن البدع والأهواء والاقتداء بالسلف الصالح والترك لمحدثات الأمور، وأمرهم بمجانبة ما عليه جمهور العوام من إهمال الشريعة والإقبال على الدنيا، وحذرهم عنه غاية التحذير، وعلم هو وصاحبه أسال أن هذه الطائفة المريدة القاصرة لا نجاة لها إلا بهذا الطريق، وأنها إن رفعت عنه إلى يفاع الاستبصار اختل ما هي عليه ولم يمكنها أن تلحق بدرجة السعداء وتذبذبت وانتكست وساءت عاقبتها. وان هي دامت على ما هي عليه حتى يوافيها اليقين فازت بالآمن وكانت من أصحاب اليمين، والسابقون السابقون أولئك المقربون. فو دعاهم وانفصلا عنهم وتلطفا في العود إلى جزيرتهما حتى يسر الله عز وجل عليهما العبور إليها. وطلب حي بن يقظان مقامه الكريم بالنحو الذي طلبه أولاً حتى عاد إليه، واقتدى به أسال حتى قرب من أو كاد وعبدا الله في تلك الجزيرة حتى أتاهما اليقين. هذا - أيدنا الله وأياك بروح منه - ما كان من نبأ حي بن يقظان وأسال وسلامان وقد أشتمل على حظ من الكلام لا يوجد في كتاب ولا يسمع في معتاد خطاب، وهو من العلم المكنون الذي لا يقبله إلا أهل المعرفة بالله، ولا يجهله إلا أهل الغرة بالله. وقد خالفنا فيه طريق السلف الصالح في الضنانا به والشح عليه. إلا أن الذي سهل علينا إفشاء هذا السر وهتك الحجاب، ما ظهر في زماننا من أراء فاسده نبغت بها متفلسفة العصر وصرحت بها، حتى انتشرت في البلدان وعما ضررها وخشينا على الضعفاء الذين اطرحوا تقليد الأنبياء صلوات الله عليهم، وأرادوا تقليد السفهاء والأغبياء أن يظنوا أن تلك الآراء هي الأسرار المضنون بها على غير أهلها، فيزيد بذلك حبهم فيها وولعهم فيها. فرأينا أن نلمح إليهم بطرف من سر الأسرار لنجتذبهم إلى جانب التحقيق، ثم نصدهم عن ذلك الطريق. ولم نخل مع ذلك ما أودعناه هذه الأوراق اليسيره من الأسرار عن حجاب رقيق وستر لطيف ينتهك سريعاً لمن هو أهله، ويتكاثف لمن لا يستحق تجاوزه حتى لا يتعداه. وأنا أسئل إخواني الواقفين على هذا الكلام، أن يقبلو عذري فيما تسائلت في تبينه وتسامحت في تثبيته، فلم أفعل ذلك إلا لأني تسمنت شواهق يزل الطرف عن مرآها. وأردت تقريب الكلام فيها على وجه الترغيب والتشويق في دخول الطريق. وأسأل الله التجاوز والعفو، وأن يوردنا من المعرفة به الصفو، إنه منعم كريم. والسلام عليك أيها الأخ المفترض إسعافه ورحمت الله وبركاته.
+EOT;
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_SA/Address.php

@@ -0,0 +1,146 @@
+<?php
+
+namespace Faker\Provider\ar_SA;
+
+class Address extends \Faker\Provider\Address
+{
+    protected static $streetPrefix = ['شارع', 'طريق', 'ممر'];
+
+    /**
+     * @see https://ar.wikipedia.org/wiki/%D9%82%D8%A7%D8%A6%D9%85%D8%A9_%D9%85%D8%AF%D9%86_%D8%A7%D9%84%D8%B3%D8%B9%D9%88%D8%AF%D9%8A%D8%A9
+     */
+    protected static $cityName = [
+        'الرياض', 'جدة', 'مكة', 'المدينة المنورة', 'تبوك', 'الدمام', 'الأحساء', 'القطيف', 'خميس مشيط', 'المظيلف', 'الهفوف',
+        'المبرز', 'الطائف', 'نجران', 'حفر الباطن', 'الجبيل', 'ضباء', 'الخرج', 'الثقبة', 'ينبع البحر', 'الخبر', 'عرعر', 'الحوية',
+        'عنيزة', 'سكاكا', 'جيزان', 'القريات', 'الظهران', 'الزلفي', 'الباحة', 'الرس', 'وادي الدواسر', 'بيشة', 'سيهات', 'شرورة',
+        'الدوادمي', 'الأفلاج',
+    ];
+
+    /**
+     * @see https://ar.wikipedia.org/wiki/%D8%A7%D9%84%D8%AA%D9%82%D8%B3%D9%8A%D9%85_%D8%A7%D9%84%D8%A5%D8%AF%D8%A7%D8%B1%D9%8A_%D9%84%D9%84%D9%85%D9%85%D9%84%D9%83%D8%A9_%D8%A7%D9%84%D8%B9%D8%B1%D8%A8%D9%8A%D8%A9_%D8%A7%D9%84%D8%B3%D8%B9%D9%88%D8%AF%D9%8A%D8%A9
+     */
+    protected static $subdivisions = [
+        'منطقة الرياض', 'منطقة القصيم',
+        'منطقة مكة المكرمة', 'منطقة المدينة المنورة',
+        'منطقة حائل', 'منطقة الجوف', 'منطقة تبوك', 'منطقة الحدود الشمالية',
+        'منطقة عسير', 'منطقة جازان', 'منطقة نجران', 'منطقة الباحة',
+        'المنطقة الشرقية',
+    ];
+
+    /**
+     * @see https://ar.wikipedia.org/wiki/%D9%82%D8%A7%D8%A6%D9%85%D8%A9_%D9%85%D8%AD%D8%A7%D9%81%D8%B8%D8%A7%D8%AA_%D8%A7%D9%84%D8%B3%D8%B9%D9%88%D8%AF%D9%8A%D8%A9
+     */
+    protected static $governorates = [
+        'الرياض', 'الدرعية', 'الخرج', 'الدوادمي', 'المجمعة', 'القويعية', 'الأفلاج', 'وادي الدواسر', 'الزلفي', 'شقراء', 'حوطة بني تميم', 'عفيف', 'الغاط', 'السليل', 'ضرما', 'المزاحمية', 'رماح', 'ثادق', 'حريملاء', 'الحريق', 'مرات',
+        'مكة المكرمة', 'جدة', 'الطائف', 'القنفذة', 'الليث', 'رابغ', 'خليص', 'الخرمة', 'رنية', 'تربة', 'الجموم', 'الكامل', 'المويه', 'ميسان', 'أضم', 'العرضيات', 'بحرة',
+        'المدينة المنورة', 'ينبع', 'العلا', 'مهد الذهب', 'الحناكية', 'بدر', 'خيبر', 'العيص', 'وادي الفرع',
+        'بريدة', 'عنيزة', 'الرس', 'المذنب', 'البكيرية', 'البدائع', 'الأسياح', 'النبهانية', 'الشماسية', 'عيون الجواء', 'رياض الخبراء', 'عقلة الصقور', 'ضرية',
+        'الدمام', 'الأحساء', 'حفر الباطن', 'الجبيل', 'القطيف', 'الخبر', 'الخفجي', 'رأس تنورة', 'بقيق', 'النعيرية', 'قرية العليا', 'العديد',
+        'أبها', 'خميس مشيط', 'بيشة', 'النماص', 'محايل عسير', 'ظهران الجنوب', 'تثليث', 'سراة عبيدة', 'رجال ألمع', 'بلقرن', 'أحد رفيدة', 'المجاردة', 'البرك', 'بارق', 'تنومة', 'طريب',
+        'تبوك', 'الوجه', 'ضبا', 'تيماء', 'أملج', 'حقل', 'البدع',
+        'حائل', 'بقعاء', 'الغزالة', 'الشنان', 'الحائط', 'السليمي', 'الشملي', 'موقق', 'سميراء',
+        'عرعر', 'رفحاء', 'طريف', 'العويقيلة',
+        'جازان', 'صبيا', 'أبو عريش', 'صامطة', 'بيش', 'الدرب', 'الحرث', 'ضمد', 'الريث', 'جزر فرسان', 'الدائر', 'العارضة', 'أحد المسارحة', 'العيدابي', 'فيفاء', 'الطوال', 'هروب',
+        'نجران', 'شرورة', 'حبونا', 'بدر الجنوب', 'يدمه', 'ثار', 'خباش', 'الخرخير',
+        'الباحة', 'بلجرشي', 'المندق', 'المخواة', 'قلوة', 'العقيق', 'القرى', 'غامد الزناد', 'الحجرة', 'بني حسن',
+        'سكاكا', 'القريات', 'دومة الجندل', 'طبرجل',
+    ];
+
+    protected static $buildingNumber = ['%####', '%###', '%#'];
+
+    protected static $postcode = ['#####', '#####-####'];
+
+    /**
+     * @see http://www.nationsonline.org/oneworld/countrynames_arabic.htm
+     */
+    protected static $country = [
+        'الكاريبي', 'أمريكا الوسطى', 'أنتيجوا وبربودا', 'أنجولا', 'أنجويلا', 'أندورا', 'اندونيسيا', 'أورجواي', 'أوروبا', 'أوزبكستان', 'أوغندا', 'أوقيانوسيا', 'أوقيانوسيا النائية', 'أوكرانيا', 'ايران', 'أيرلندا', 'أيسلندا', 'ايطاليا',
+        'بابوا غينيا الجديدة', 'باراجواي', 'باكستان', 'بالاو', 'بتسوانا', 'بتكايرن', 'بربادوس', 'برمودا', 'بروناي', 'بلجيكا', 'بلغاريا', 'بليز', 'بنجلاديش', 'بنما', 'بنين', 'بوتان', 'بورتوريكو', 'بوركينا فاسو', 'بوروندي', 'بولندا', 'بوليفيا', 'بولينيزيا', 'بولينيزيا الفرنسية', 'بيرو',
+        'تانزانيا', 'تايلند', 'تايوان', 'تركمانستان', 'تركيا', 'ترينيداد وتوباغو', 'تشاد', 'توجو', 'توفالو', 'توكيلو', 'تونجا', 'تونس', 'تيمور الشرقية',
+        'جامايكا', 'جبل طارق', 'جرينادا', 'جرينلاند', 'جزر الأنتيل الهولندية', 'جزر الترك وجايكوس', 'جزر القمر', 'جزر الكايمن', 'جزر المارشال', 'جزر الملديف', 'جزر الولايات المتحدة البعيدة الصغيرة', 'جزر أولان', 'جزر سليمان', 'جزر فارو', 'جزر فرجين الأمريكية', 'جزر فرجين البريطانية', 'جزر فوكلاند', 'جزر كوك', 'جزر كوكوس', 'جزر ماريانا الشمالية', 'جزر والس وفوتونا', 'جزيرة الكريسماس', 'جزيرة بوفيه', 'جزيرة مان', 'جزيرة نورفوك', 'جزيرة هيرد وماكدونالد', 'جمهورية افريقيا الوسطى', 'جمهورية التشيك', 'جمهورية الدومينيك', 'جمهورية الكونغو الديمقراطية', 'جمهورية جنوب افريقيا', 'جنوب آسيا', 'جنوب أوروبا', 'جنوب شرق آسيا', 'جنوب وسط آسيا', 'جواتيمالا', 'جوادلوب', 'جوام', 'جورجيا', 'جورجيا الجنوبية وجزر ساندويتش الجنوبية', 'جيبوتي', 'جيرسي',
+        'دومينيكا',
+        'رواندا', 'روسيا', 'روسيا البيضاء', 'رومانيا', 'روينيون',
+        'زامبيا', 'زيمبابوي',
+        'ساحل العاج', 'ساموا', 'ساموا الأمريكية', 'سانت بيير وميكولون', 'سانت فنسنت وغرنادين', 'سانت كيتس ونيفيس', 'سانت لوسيا', 'سانت مارتين', 'سانت هيلنا', 'سان مارينو', 'ساو تومي وبرينسيبي', 'سريلانكا', 'سفالبارد وجان مايان', 'سلوفاكيا', 'سلوفينيا', 'سنغافورة', 'سوازيلاند', 'سوريا', 'سورينام', 'سويسرا', 'سيراليون', 'سيشل',
+        'شرق آسيا', 'شرق افريقيا', 'شرق أوروبا', 'شمال افريقيا', 'شمال أمريكا', 'شمال أوروبا', 'شيلي',
+        'صربيا', 'صربيا والجبل الأسود',
+        'طاجكستان',
+        'عمان',
+        'غامبيا', 'غانا', 'غرب آسيا', 'غرب افريقيا', 'غرب أوروبا', 'غويانا', 'غيانا', 'غينيا', 'غينيا الاستوائية', 'غينيا بيساو',
+        'فانواتو', 'فرنسا', 'فلسطين', 'فنزويلا', 'فنلندا', 'فيتنام', 'فيجي',
+        'قبرص', 'قرغيزستان', 'قطر',
+        'كازاخستان', 'كاليدونيا الجديدة', 'كرواتيا', 'كمبوديا', 'كندا', 'كوبا', 'كوريا الجنوبية', 'كوريا الشمالية', 'كوستاريكا', 'كولومبيا', 'كومنولث الدول المستقلة', 'كيريباتي', 'كينيا',
+        'لاتفيا', 'لاوس', 'لبنان', 'لوكسمبورج', 'ليبيا', 'ليبيريا', 'ليتوانيا', 'ليختنشتاين', 'ليسوتو',
+        'مارتينيك', 'ماكاو الصينية', 'مالطا', 'مالي', 'ماليزيا', 'مايوت', 'مدغشقر', 'مصر', 'مقدونيا', 'ملاوي', 'منغوليا', 'موريتانيا', 'موريشيوس', 'موزمبيق', 'مولدافيا', 'موناكو', 'مونتسرات', 'ميانمار', 'ميكرونيزيا', 'ميلانيزيا',
+        'ناميبيا', 'نورو', 'نيبال', 'نيجيريا', 'نيكاراجوا', 'نيوزيلاندا', 'نيوي',
+        'هايتي', 'هندوراس', 'هولندا', 'هونج كونج الصينية',
+        'وسط آسيا', 'وسط افريقيا',
+    ];
+
+    protected static $cityFormats = [
+        '{{cityName}}',
+    ];
+
+    protected static $streetNameFormats = [
+        '{{streetPrefix}} {{firstName}} {{lastName}}',
+    ];
+
+    protected static $streetAddressFormats = [
+        '{{buildingNumber}} {{streetName}}',
+        '{{buildingNumber}} {{streetName}} {{secondaryAddress}}',
+    ];
+
+    protected static $addressFormats = [
+        "{{streetAddress}}\n{{city}}",
+    ];
+
+    protected static $secondaryAddressFormats = ['شقة رقم. ##', 'عمارة رقم ##'];
+
+    /**
+     * @example 'شرق'
+     */
+    public static function cityPrefix()
+    {
+        return static::randomElement(static::$cityPrefix);
+    }
+
+    /**
+     * @example 'الرياض'
+     */
+    public static function cityName()
+    {
+        return static::randomElement(static::$cityName);
+    }
+
+    /**
+     * @example 'شارع'
+     */
+    public static function streetPrefix()
+    {
+        return static::randomElement(static::$streetPrefix);
+    }
+
+    /**
+     * @example 'شقة رقم. 350'
+     */
+    public static function secondaryAddress()
+    {
+        return static::numerify(static::randomElement(static::$secondaryAddressFormats));
+    }
+
+    /**
+     * @example 'منطقة الرياض'
+     */
+    public static function subdivision()
+    {
+        return static::randomElement(static::$subdivisions);
+    }
+
+    /**
+     * @example 'منطقة الرياض'
+     */
+    public static function governorate()
+    {
+        return static::randomElement(static::$governorates);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_SA/Color.php

@@ -0,0 +1,81 @@
+<?php
+
+namespace Faker\Provider\ar_SA;
+
+class Color extends \Faker\Provider\Color
+{
+    protected static $safeColorNames = [
+        'أسود', 'قرمزي', 'أخضر', 'أزرق داكن', 'زيتوني',
+        'أرجواني', 'أحمر', 'ليمي', 'أزرق', 'فضي',
+        'رمادي', 'أصفر', 'برتقالي', 'بني', 'أبيض',
+    ];
+
+    /**
+     * @see https://ar.wikipedia.org/wiki/%D9%82%D8%A7%D8%A6%D9%85%D8%A9_%D8%A7%D9%84%D8%A3%D9%84%D9%88%D8%A7%D9%86_(%D9%85%D8%AA%D8%B6%D8%A7%D9%85%D8%A9)
+     */
+    protected static $allColorNames = [
+        'استقلالي', 'انصهاري الذهب', 'أبنوسي', 'أبيض', 'أبيض الشبح', 'أبيض زهوري', 'أبيض عتيق', 'أبيض مضاد للإشعاع',
+        'أبيض هولندي', 'أحمر الأبنية', 'أحمر التفاح المحلى', 'أحمر التفاح المحلى الداكن', 'أحمر الفالون',
+        'أحمر الفيراري', 'أحمر إمبراطوري', 'أحمر إنجليزي', 'أحمر باستيلي داكن', 'أحمر توسكاني عميق',
+        'أحمر جامعة بوسطن', 'أحمر حرس السواحل', 'أحمر داكن', 'أحمر ديبيان', 'أحمر صيني', 'أحمر طوبي', 'أحمر عقيقي',
+        'أحمر كادميومي', 'أحمر كارمن', 'أحمر مرجاني', 'أحمر مطفئة الحريق', 'أحمر نحاسي', 'أحمر هندي', 'أخضر (بانتون)',
+        'أخضر (ح ص ز)', 'أخضر (صباغ)', 'أخضر (عجلة الألوان) (أخض )', 'أخضر (كريولا)', 'أخضر (لون)', 'أخضر (مونسل)',
+        'أخضر (نظام الألوان الطبيعية)', 'أخضر الصياد', 'أخضر الغابة (تقليدي)', 'أخضر الغابة (وب)', 'أخضر الهند',
+        'أخضر أندرويد', 'أخضر إسلامي', 'أخضر إلكتروني', 'أخضر إنجليزي', 'أخضر باستيلي داكن', 'أخضر بحري داكن',
+        'أخضر برونسويكي', 'أخضر بنغلاديشي', 'أخضر تشارلستون', 'أخضر تفاحي', 'أخضر تمويهي', 'أخضر جامعة كاليفورنيا م ت',
+        'أزرق جامعة كامبريدج', 'أخضر جيشي', 'أخضر دارتموثي', 'أخضر داكن', 'أخضر دغلي', 'أخضر دغلي داكن',
+        'أخضر دغلي عميق', 'أخضر ربيعي داكن', 'أخضر زيتوني داكن', 'أخضر سباقي بريطاني', 'أخضر سرخسي',
+        'أخضر طحالبي داكن', 'أخضر قاروري', 'أخضر كادميومي', 'أخضر كاستلتون', 'أخضر كاريبي', 'أخضر مزرق',
+        'أخضر مضيء', 'أخضر مكتبي', 'أخضر هوكر', 'أرجواني إلكرتوني', 'أرجواني إمبراطوري', 'أرجواني باستيلي داكن',
+        'أرجواني فوشي', 'أرجواني قطيفي', 'أرجواني هان', 'أزرق', 'أزرق (ح ص ز)', 'أزرق (صبغة)', 'أزرق (كريولا)',
+        'أزرق (مونسل)', 'أزرق (نظام الألوان الطبيعية)', 'أزرق اردوازي داكن', 'أزرق البحرية مضيء',
+        'أزرق التفوق الجوي', 'أزرق السماء الإيطالي', 'أزرق السماء الفرنسي', 'أزرق العاشقين', 'أزرق الهونولولو',
+        'أزرق أليس', 'أزرق إلكتروني', 'أزرق إلكتروني داكن', 'أزرق إمبراطوري', 'أزرق إمبراطوري داكن', 'إزرق إيتون',
+        'أزرق باستيلي داكن', 'أزرق بوندي', 'أزرق جامعة براندايس', 'أزرق جامعة ديوك', 'أزرق جامعة كارولينا',
+        'أزرق جامعة كولومبيا', 'أزرق جوي (القوات الجوية الأمريكية)', 'أزرق جوي (سلاح الجو الملكي)',
+        'أزرق حرس السواحل', 'أزرق داكن', 'أزرق رمادي', 'أزرق سماوي داكن', 'أزرق سماوي عميق', 'أزرق سيروليان',
+        'أزرق طفولي', 'أزرق عاصفي', 'أزرق عيني الطفل', 'أزرق فرنسا', 'أزرق فرنسي', 'أزرق فريق دودجر',
+        'أزرق قنطريوني', 'أزرق كاتالينا', 'أزرق كاديتي', 'أزرق كروي', 'أزرق كلين العالمي', 'أزرق مسحوقي داكن',
+        'أزرق مصري', 'أزرق هان', 'أزرق هوائي', 'أسود', 'أشقر', 'أصفر الكناري', 'أصفر الكوبالت', 'أصفر أريليد',
+        'أصفر إلكتروني', 'أصفر برونزي', 'أصفر داكن', 'أصفر ذهبي', 'أصفر كادميومي', 'أصفر متألق',
+        'أزرق منتصف الليل الداكن', 'أصفر الأرض', 'أصفر مخضر', 'أصفر موزي', 'أصفر هندي', 'أفوكادوي', 'ألماسي',
+        'أمازوني', 'أومبرياوي محروق', 'أيلي', 'إمبراطوري', 'إيزابيلي', 'باذنجاني', 'برتقالي الجزر',
+        'برتقالي الجزر العميق', 'برتقالي داكن', 'برتقالي عالمي (جسر البوابة الذهبية)', 'برتقالي عالمي (فضاء جوي)',
+        'برتقالي عالمي (هندسة)', 'برتقالي فريق الجيانتس', 'برتقالي كادميومي', 'برتقالي متألق', 'برتقالي محروق',
+        'برتقالي مشاب', 'برعمي يونيو', 'برغوثي داكن', 'برغوثي عميق', 'برغوثي فرنسي', 'برقي', 'برونزي', 'برونزي عتيق',
+        'برونزي منطلق', 'بندقي الكستناء', 'بندقي الكستناء الداكن', 'بندقي الكستناء العميق', 'بنفسجي إلكتروني',
+        'بنفسجي إنجليزي', 'بنفسجي داكن', 'بنفسجي صيني', 'بنفسجي فرنسي', 'بنفسجي مزرق', 'بنفسجي ياباني',
+        'بني الحمير', 'بني المتملقين', 'بني داكن', 'بني ذهبي', 'بني كاكاوي', 'بني (وب)', 'بني (تقليدي)',
+        'بورغندي', 'بيزنطي', 'بيزنطي داكن', 'ترابي', 'تربي داكن', 'تربي محروق', 'تفاحي جراني سميث', 'تملقي',
+        'توردي', 'جاسبري', 'جلدي الجاموس', 'جمشتي', 'جملي', 'جوزي الهند', 'حسائي', 'حممي داكن', 'خامي',
+        'خبازي عميق', 'خبازي فرنسي', 'خرنوبي', 'خزامي إلكتروني', 'خزامي إنجليزي', 'خزامي داكن', 'خزامي مضيء',
+        'خشخاشي ذهبي', 'خشخاشي منثور', 'خلدي داكن', 'خلدي عميق', 'خوخي عميق', 'خوخي فرنسي', 'دودي قياس', 'دينمي',
+        'ذروي', 'ذهبي (معدني)', 'ذهبي (وب)(ذهبي)', 'ذهبي القلب', 'رأسي الموت', 'رقيبي الشمس', 'رماد الأخشاب', 'رمادي',
+        'رمادي (رمادي HTML/CSS)', 'رمادي (رمادي X11)', 'رمادي الميدان', 'رمادي-أزرق داكن', 'رمادي اردوازي داكن',
+        'رمادي دافي', 'رمادي داكن', 'رمادي البوارج', 'رمادي بارد', 'رمادي خافت', 'رمادي رقيبي الشمس', 'رمادي كاديتي',
+        'رمادي متوسط داكن', 'رمادي مزرق', 'زبرجدي', 'زرنيخي', 'زعفراني عميق', 'زمردي', 'زمردي مضيء', 'زنجبيلي',
+        'زنجفري', 'زهري النحام', 'زهري إزهار الكرز', 'زهري الحافة', 'زهري الحجاب', 'زهري الحلوى السكرية', 'زهري الصين',
+        'زهري القرنفل', 'زهري الكرز', 'زهري باربي', 'زهري بيكر-ميلر', 'زهري ساحر', 'زهري ساخن', 'زهري داكن',
+        'زهري طفولي', 'زهري عميق', 'زهري فاندانغو', 'زهري فرنسي', 'زهري فوشي', 'زهري قطيفي', 'زهري كارمن',
+        'زهري كارمن العميق', 'زهري متألق', 'زهري مرجاني', 'زيتوني أسود', 'ستري أسود الجلد', 'سحلبي داكن',
+        'سقفي', 'سقلاتي داكن', 'سلموني داكن', 'سوسني', 'سيان', 'سيان (طباعي)', 'سيان إلكتروني', 'سيان داكن',
+        'سيروليان', 'سيروليان داكن', 'سيروليان مضيء', 'شامباني', 'شامباني عميق', 'شوكولاتي (تقليدي)', 'شوكولاتي (وب)',
+        'صبغة خشب الزان', 'صبغي النيلة', 'صحراوي', 'صفروي', 'صقيعي سيرولياني', 'صوفي', 'صوفي فرنسي', 'طوبي',
+        'طيني نضيج داكن', 'عاجي', 'عاصفي الغبار', 'عصوي الذهب', 'عصوي الذهب الداكن', 'عظمي', 'علكي', 'عليقي بويزن',
+        'عليقي داكن', 'عليقي فرنسي', 'عنبري', 'عنبي', 'عنبري (SAE/ECE)', 'عنبي بري', 'غزلي البنات', 'فاصولي أسود',
+        'فاندانغوي', 'فانيلي داكن', 'فحمي', 'فقاعي', 'فلدسباري', 'فوشي', 'فوشي (كريولا)', 'فوشي الموضة', 'فوشي عتيق',
+        'فوشي عميق', 'فوشي فرنسي', 'فيروزي داكن', 'فيروزي مضيء', 'قرطبي', 'قرفي', 'قرمزي', 'قرمزي الأليزارين',
+        'قرمزي إلكتروني', 'قرمزي جامعة ألاباما', 'قرمزي جامعة هارفارد', 'قشدي', 'قشري البيض', 'قطيفي', 'قندسي',
+        'قنطريوني', 'قهوي', 'قهوي اللبن', 'قهوي عميق', 'كابري', 'كاديتي', 'كاردينالي', 'كارمن', 'كارمن عميق',
+        'كارمن ياباني', 'كبادي', 'كبدي داكن', 'كبدي داكن (الأحصنة)', 'كتاني', 'كستنائي مضيء', 'كرتوزي (تقليدي)',
+        'كرتوزي (وب)', 'كرزي', 'كرزي عميق', 'كرزي هوليوود', 'كلاريتي', 'كمبوجي', 'كوبالتي', 'كوزي العسل', 'لاتيهي كوني',
+        'لازوردي', 'لازوردي إلكتروني', 'لازوردي ضبابي(ويب)', 'لحائي داكن', 'لهيبي', 'لوزي', 'لوزي مبيض', 'ليلاكي عميق',
+        'ليلاكي فرنسي', 'ليلاكي مضيء', 'ليموني عميق', 'ليموني مر', 'ليمي إلكتروني', 'ليمي فرنسي', 'ليمي مر', 'مائي',
+        'ماجنتي داكن', 'ماجنتي ساخن', 'ماجنتي عميق', 'مرجاني', 'مرجاني داكن', 'مسحوقي الطفل', 'مشمشي', 'مصفر', 'معدني',
+        'موزي مجنون', 'نبيذي فرنسي', 'نحاسي', 'نحاسي (كريولا)', 'نحاسي أصفر', 'نحاسي عتيق', 'نرجسي أسلي', 'نرجسي كاذب',
+        'نيلي (وب)', 'نيلي', 'نيلي إلكتروني', 'نيلي ياباني', 'هليوني', 'هليوني رمادي', 'هندبائي', 'هوائي طلق',
+        'وردي أمريكي', 'وردي الأسواق', 'وردي الصين', 'وردي بلغاري', 'وردي فرنسي', 'وردي فوشي', 'وردي قرانيا',
+        'وردي كلاسيكي', 'وردي مضيء', 'وردي نحاسي', 'ياسميني', 'ياقوتي أزرق', 'ياقوتي عتيق', 'ياقوتي عميق',
+        'ياقوتي مغمور', 'يخضور عام', 'يشبي', 'يوسفي داكن', 'يوسفي ذري', 'يوكاليبتوسي',
+    ];
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_SA/Company.php

@@ -0,0 +1,78 @@
+<?php
+
+namespace Faker\Provider\ar_SA;
+
+use Faker\Calculator\Luhn;
+
+class Company extends \Faker\Provider\Company
+{
+    protected static $formats = [
+        '{{lastName}} {{companySuffix}}',
+        '{{companyPrefix}} {{lastName}} {{companySuffix}}',
+        '{{companyPrefix}} {{lastName}}',
+    ];
+
+    protected static $bsWords = [
+        [],
+    ];
+
+    protected static $catchPhraseWords = [
+        ['الخدمات', 'الحلول', 'الانظمة'],
+        [
+            'الذهبية', 'الذكية', 'المتطورة', 'المتقدمة', 'الدولية', 'المتخصصه', 'السريعة',
+            'المثلى', 'الابداعية', 'المتكاملة', 'المتغيرة', 'المثالية',
+        ],
+    ];
+
+    protected static $companyPrefix = ['شركة', 'مؤسسة', 'مجموعة', 'مكتب', 'أكاديمية', 'معرض'];
+
+    protected static $companySuffix = ['وأولاده', 'للمساهمة المحدودة', ' ذ.م.م', 'مساهمة عامة', 'وشركائه'];
+
+    /**
+     * @example 'مؤسسة'
+     *
+     * @return string
+     */
+    public function companyPrefix()
+    {
+        return static::randomElement(self::$companyPrefix);
+    }
+
+    /**
+     * @example 'الحلول المتقدمة'
+     */
+    public function catchPhrase()
+    {
+        $result = [];
+
+        foreach (static::$catchPhraseWords as &$word) {
+            $result[] = static::randomElement($word);
+        }
+
+        return implode(' ', $result);
+    }
+
+    /**
+     * @example 'integrate extensible convergence'
+     */
+    public function bs()
+    {
+        $result = [];
+
+        foreach (static::$bsWords as &$word) {
+            $result[] = static::randomElement($word);
+        }
+
+        return implode(' ', $result);
+    }
+
+    /**
+     * example 7001010101
+     */
+    public static function companyIdNumber()
+    {
+        $partialValue = static::numerify(700 . str_repeat('#', 6));
+
+        return Luhn::generateLuhnNumber($partialValue);
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_SA/Internet.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Faker\Provider\ar_SA;
+
+class Internet extends \Faker\Provider\Internet
+{
+    protected static $userNameFormats = [
+        '{{lastNameAscii}}.{{firstNameAscii}}',
+        '{{firstNameAscii}}.{{lastNameAscii}}',
+        '{{firstNameAscii}}##',
+        '?{{lastNameAscii}}',
+    ];
+    protected static $safeEmailTld = [
+        'com', 'jo', 'me', 'net', 'org',
+    ];
+
+    protected static $tld = [
+        'biz', 'com', 'info', 'sa', 'net', 'org',
+    ];
+
+    protected static $lastNameAscii = [
+        'abbad', 'abbadi', 'abbas', 'abulebbeh', 'flefel', 'hadi', 'hamad', 'hasan', 'jabri', 'kanaan', 'karam', 'maanee', 'melhem', 'nimry', 'obaisi', 'qasem', 'qawasmee', 'rabee', 'rashwani', 'shami', 'zaloum',
+    ];
+    protected static $firstNameAscii = [
+        'abd', 'abdullah', 'ahmad', 'akram', 'amr', 'bashar', 'bilal', 'fadi', 'ibrahim', 'khaled', 'layth', 'mohammad', 'mutaz', 'omar', 'osama', 'rami', 'saleem', 'samer', 'sami', 'yazan',
+    ];
+
+    public static function lastNameAscii()
+    {
+        return static::randomElement(static::$lastNameAscii);
+    }
+
+    public static function firstNameAscii()
+    {
+        return static::randomElement(static::$firstNameAscii);
+    }
+
+    /**
+     * @example 'ahmad.abbadi'
+     */
+    public function userName()
+    {
+        $format = static::randomElement(static::$userNameFormats);
+
+        return static::bothify($this->generator->parse($format));
+    }
+
+    /**
+     * @example 'wewebit.jo'
+     */
+    public function domainName()
+    {
+        return static::randomElement(static::$lastNameAscii) . '.' . $this->tld();
+    }
+}

vendor/fakerphp/faker/src/Faker/Provider/ar_SA/Payment.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Faker\Provider\ar_SA;
+
+class Payment extends \Faker\Provider\Payment
+{
+    /**
+     * International Bank Account Number (IBAN)
+     *
+     * @see http://en.wikipedia.org/wiki/International_Bank_Account_Number
+     *
+     * @param string $prefix      for generating bank account number of a specific bank
+     * @param string $countryCode ISO 3166-1 alpha-2 country code
+     * @param int    $length      total length without country code and 2 check digits
+     *
+     * @return string
+     */
+    public static function bankAccountNumber($prefix = '', $countryCode = 'SA', $length = null)
+    {
+        return static::iban($countryCode, $prefix, $length);
+    }
+}