├── tests
    ├── JsonSchema
    │   ├── dist
    │   │   └── .gitkeep
    │   ├── fixture
    │   │   ├── def
    │   │   │   ├── null.json
    │   │   │   ├── boolean.json
    │   │   │   ├── typeOnly.json
    │   │   │   ├── ref_inline.json
    │   │   │   ├── typeAndMaxItems.json
    │   │   │   └── ref.json
    │   │   ├── null.json
    │   │   ├── boolean.json
    │   │   ├── ref_file_ref.json
    │   │   ├── ref_file_double.json
    │   │   ├── ref_file.json
    │   │   ├── ref_array.json
    │   │   ├── format.json
    │   │   ├── array.json
    │   │   ├── ref_inline.json
    │   │   ├── integer.json
    │   │   ├── combining.json
    │   │   ├── number.json
    │   │   ├── string.json
    │   │   └── object.json
    │   ├── TestCase.php
    │   ├── FakeJsonsTest.php
    │   ├── FakerTest.php
    │   └── HelperTest.php
    └── index.php
├── .gitignore
├── src
    ├── Faker
    │   ├── Factory.php
    │   └── Generator.php
    ├── JsonSchema
    │   ├── InvalidItemsException.php
    │   ├── UnsupportedTypeException.php
    │   ├── FakeJsons.php
    │   ├── Ref.php
    │   └── Faker.php
    ├── Provider
    │   ├── zh_TW
    │   │   ├── PhoneNumber.php
    │   │   ├── DateTime.php
    │   │   ├── Color.php
    │   │   ├── Person.php
    │   │   └── Company.php
    │   ├── zh_CN
    │   │   ├── Internet.php
    │   │   ├── Payment.php
    │   │   ├── PhoneNumber.php
    │   │   ├── DateTime.php
    │   │   ├── Color.php
    │   │   ├── Address.php
    │   │   └── Company.php
    │   ├── Company.php
    │   ├── PhoneNumber.php
    │   ├── en_US
    │   │   ├── Payment.php
    │   │   ├── PhoneNumber.php
    │   │   └── Address.php
    │   ├── Uuid.php
    │   ├── Biased.php
    │   ├── Barcode.php
    │   ├── Person.php
    │   ├── Address.php
    │   ├── Image.php
    │   ├── Color.php
    │   ├── Text.php
    │   ├── UserAgent.php
    │   ├── Lorem.php
    │   ├── HtmlLorem.php
    │   └── Payment.php
    ├── DefaultGenerator.php
    ├── autoload.php
    ├── Calculator
    │   ├── Inn.php
    │   ├── Ean.php
    │   ├── TCNo.php
    │   ├── Iban.php
    │   └── Luhn.php
    ├── UniqueGenerator.php
    ├── ValidGenerator.php
    ├── Factory.php
    ├── Documentor.php
    ├── Guesser
    │   └── Name.php
    └── Generator.php
├── composer.json
└── LICENSE


/tests/JsonSchema/dist/.gitkeep:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/def/null.json:
--------------------------------------------------------------------------------
1 | {
2 |     "type": "null"
3 | }


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/null.json:
--------------------------------------------------------------------------------
1 | {
2 |     "type": "null"
3 | }


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | tests/JsonSchema/dist/*
2 | !tests/JsonSchema/dist/.gitkeep


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/boolean.json:
--------------------------------------------------------------------------------
1 | {
2 |     "type": "boolean"
3 | }


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/def/boolean.json:
--------------------------------------------------------------------------------
1 | {
2 |     "type": "boolean"
3 | }


--------------------------------------------------------------------------------
/src/Faker/Factory.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Faker;
4 | 
5 | class Factory extends \Poppy\Faker\Factory
6 | {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/src/Faker/Generator.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Faker;
4 | 
5 | class Generator extends \Poppy\Faker\Generator
6 | {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/src/JsonSchema/InvalidItemsException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Poppy\Faker\JsonSchema;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | class InvalidItemsException extends RuntimeException
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/JsonSchema/UnsupportedTypeException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types = 1);
 4 | 
 5 | namespace Poppy\Faker\JsonSchema;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | class UnsupportedTypeException extends RuntimeException
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/def/typeOnly.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly"
 5 |     ],
 6 |     "properties": {
 7 |         "typeOnly": {
 8 |             "type": "array"
 9 |         }
10 |     }
11 | }
12 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/ref_file_ref.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly"
 5 |     ],
 6 |     "properties": {
 7 |         "typeOnly": {
 8 |             "$ref": "./def/ref.json"
 9 |         }
10 |     }
11 | }


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/def/ref_inline.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "definitions": {
 3 |         "resource": {
 4 |             "type": "string"
 5 |         }
 6 |     },
 7 |     "$ref": "#/definitions/resource",
 8 |     "required": [
 9 |         ""
10 |     ]
11 | }
12 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/def/typeAndMaxItems.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeAndMaxItems"
 5 |     ],
 6 |     "properties": {
 7 |         "typeAndMaxItems": {
 8 |             "type": "array",
 9 |             "maxItems": 10
10 |         }
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/def/ref.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "$schema": "http://json-schema.org/draft-07/schema#",
 3 |     "type": "object",
 4 |     "required": [
 5 |         "prop1"
 6 |     ],
 7 |     "properties": {
 8 |         "prop1": {
 9 |             "$ref": "./typeOnly.json"
10 |         }
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/ref_file_double.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "bool",
 5 |         "null"
 6 |     ],
 7 |     "properties": {
 8 |         "bool": {
 9 |             "$ref": "./def/boolean.json"
10 |         },
11 |         "null": {
12 |             "$ref": "./def/null.json"
13 |         }
14 |     }
15 | }


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/ref_file.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly",
 5 |         "typeAndMinItems"
 6 |     ],
 7 |     "properties": {
 8 |         "typeOnly": {
 9 |             "$ref": "./def/typeOnly.json"
10 |         },
11 |         "typeAndMaxItems": {
12 |             "$ref": "./def/typeAndMaxItems.json"
13 |         }
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/ref_array.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "$schema": "http://json-schema.org/draft-07/schema#",
 3 |     "type": "object",
 4 |     "required": [
 5 |         "typeArrayRef"
 6 |     ],
 7 |     "properties": {
 8 |         "typeArrayRef": {
 9 |             "type": "array",
10 |             "items": {
11 |                 "$ref": "def/ref.json"
12 |             },
13 |             "minItems": 2,
14 |             "maxItems": 3
15 |         }
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Provider/zh_TW/PhoneNumber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_TW;
 4 | 
 5 | class PhoneNumber extends \Poppy\Faker\Provider\PhoneNumber
 6 | {
 7 |     protected static array $formats = [
 8 |         '+8869########',
 9 |         '+886-9##-###-###',
10 |         '09########',
11 |         '09##-###-###',
12 |         '(02)########',
13 |         '(02)####-####',
14 |         '(0#)#######',
15 |         '(0#)###-####',
16 |         '(0##)######',
17 |         '(0##)###-###',
18 |     ];
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Provider/zh_CN/Internet.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_CN;
 4 | 
 5 | class Internet extends \Poppy\Faker\Provider\Internet
 6 | {
 7 |     protected static array $freeEmailDomain = [
 8 |         'gmail.com', 'yahoo.com', 'hotmail.com', '126.com', '163.com', 'qq.com', 'sohu.com', 'sina.com',
 9 |     ];
10 | 
11 |     protected static array $tld = [
12 |         'com', 'com', 'com', 'com', 'com', 'com', 'biz', 'info', 'net', 'org', 'cn',
13 |         'com.cn', 'edu.cn', 'net.cn', 'biz.cn', 'gov.cn', 'org.cn',
14 |     ];
15 | 
16 |     protected static array $userNameFormats = [
17 |         '{{word}}.{{word}}',
18 |         '{{word}}_{{word}}',
19 |         '{{word}}##',
20 |         '?{{word}}',
21 |     ];
22 | 
23 |     protected static array $emailFormats = [
24 |         '{{userName}}@{{freeEmailDomain}}',
25 |     ];
26 | }
27 | 


--------------------------------------------------------------------------------
/src/DefaultGenerator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker;
 4 | 
 5 | /**
 6 |  * This generator returns a default value for all called properties
 7 |  * and methods. It works with Poppy\Faker\Generator\Base->optional().
 8 |  */
 9 | class DefaultGenerator
10 | {
11 |     protected $default;
12 | 
13 |     public function __construct($default = null)
14 |     {
15 |         $this->default = $default;
16 |     }
17 | 
18 |     /**
19 |      * @param string $attribute
20 |      *
21 |      * @return mixed
22 |      */
23 |     public function __get($attribute)
24 |     {
25 |         return $this->default;
26 |     }
27 | 
28 |     /**
29 |      * @param string $method
30 |      * @param array  $attributes
31 |      *
32 |      * @return mixed
33 |      */
34 |     public function __call($method, $attributes)
35 |     {
36 |         return $this->default;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/format.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "date-time",
 5 |         "email",
 6 |         "hostname",
 7 |         "ipv4",
 8 |         "ipv6",
 9 |         "uri"
10 |     ],
11 |     "properties": {
12 |         "date-time": {
13 |             "type": "string",
14 |             "format": "date-time"
15 |         },
16 |         "email": {
17 |             "type": "string",
18 |             "format": "email"
19 |         },
20 |         "hostname": {
21 |             "type": "string",
22 |             "format": "hostname"
23 |         },
24 |         "ipv4": {
25 |             "type": "string",
26 |             "format": "ipv4"
27 |         },
28 |         "ipv6": {
29 |             "type": "string",
30 |             "format": "ipv6"
31 |         },
32 |         "uri": {
33 |             "type": "string",
34 |             "format": "uri"
35 |         }
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/array.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly",
 5 |         "typeAndMinItems",
 6 |         "typeAndMaxItems",
 7 |         "typeAndMinItems",
 8 |         "typeAndMultipleItems"
 9 |     ],
10 |     "properties": {
11 |         "typeOnly": {
12 |             "type": "array"
13 |         },
14 |         "typeAndMaxItems": {
15 |             "type": "array",
16 |             "maxItems": 10
17 |         },
18 |         "typeAndMinItems": {
19 |             "type": "array",
20 |             "minItems": 10,
21 |             "maxItems": 10
22 |         },
23 |         "typeAndMultipleItems": {
24 |             "type": "array",
25 |             "items": [
26 |                 {
27 |                     "type": "integer"
28 |                 },
29 |                 {
30 |                     "type": "string"
31 |                 }
32 |             ]
33 |         }
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "poppy/faker",
 3 |     "type": "library",
 4 |     "description": "Poppy Faker is a PHP library that generates fake data for zh user.",
 5 |     "keywords": [
 6 |         "faker",
 7 |         "fixtures",
 8 |         "data"
 9 |     ],
10 |     "license": "MIT",
11 |     "authors": [
12 |         {
13 |             "name": "Mark Zhao"
14 |         },
15 |         {
16 |             "name": "François Zaninotto"
17 |         }
18 |     ],
19 |     "require": {
20 |         "php": "^8.2"
21 |     },
22 |     "require-dev": {
23 |         "ext-intl": "*"
24 |     },
25 |     "autoload": {
26 |         "psr-4": {
27 |             "Faker\\": "src/Faker/",
28 |             "Poppy\\Faker\\": "src/"
29 |         }
30 |     },
31 |     "autoload-dev": {
32 |         "psr-4": {
33 |             "Poppy\\Faker\\Test\\": "tests/"
34 |         }
35 |     },
36 |     "config": {
37 |         "sort-packages": true
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/TestCase.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types = 1);
 4 | 
 5 | namespace Poppy\Faker\Tests\JsonSchema;
 6 | 
 7 | use JsonException;
 8 | use ReflectionException;
 9 | use ReflectionMethod;
10 | 
11 | abstract class TestCase extends \PHPUnit\Framework\TestCase
12 | {
13 |     /**
14 |      * @throws JsonException
15 |      */
16 |     protected function getFixture($name)
17 |     {
18 |         return json_decode((string) file_get_contents(__DIR__ . "/fixture/{$name}.json"), false, 512, JSON_THROW_ON_ERROR);
19 |     }
20 | 
21 |     protected function getFile($name): string
22 |     {
23 |         return __DIR__ . "/fixture/{$name}.json";
24 |     }
25 | 
26 |     /**
27 |      * @throws ReflectionException
28 |      */
29 |     protected function callInternalMethod($instance, $method, array $args = [])
30 |     {
31 |         return (new ReflectionMethod(get_class($instance), $method))->invokeArgs($instance, $args);
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/autoload.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * Simple autoloader that follow the PHP Standards Recommendation #0 (PSR-0)
 5 |  * @see https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md for more informations.
 6 |  *
 7 |  * Code inspired from the SplClassLoader RFC
 8 |  * @see https://wiki.php.net/rfc/splclassloader#example_implementation
 9 |  */
10 | spl_autoload_register(function ($className) {
11 |     $className = ltrim($className, '\\');
12 |     $fileName  = '';
13 |     if ($lastNsPos = strripos($className, '\\')) {
14 |         $namespace = substr($className, 0, $lastNsPos);
15 |         $className = substr($className, $lastNsPos + 1);
16 |         $fileName  = str_replace('\\', DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR;
17 |     }
18 |     $fileName = str_replace('src/Poppy/Faker/', 'src/', __DIR__ . DIRECTORY_SEPARATOR . $fileName . $className . '.php');
19 |     if (file_exists($fileName)) {
20 |         require $fileName;
21 | 
22 |         return true;
23 |     }
24 | 
25 |     return false;
26 | });
27 | 


--------------------------------------------------------------------------------
/src/Provider/zh_CN/Payment.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_CN;
 4 | 
 5 | class Payment extends \Poppy\Faker\Provider\Payment
 6 | {
 7 |     /**
 8 |      * @see https://zh.wikipedia.org/wiki/%E4%B8%AD%E5%9B%BD%E9%93%B6%E8%A1%8C%E5%88%97%E8%A1%A8
 9 |      * @var array
10 |      */
11 |     protected static array $banks = [
12 |         '渤海银行',
13 |         '广发银行',
14 |         '国家开发银行',
15 |         '恒丰银行',
16 |         '华夏银行',
17 |         '交通银行',
18 |         '平安银行',
19 |         '上海浦东发展银行',
20 |         '兴业银行',
21 |         '招商银行',
22 |         '浙商银行',
23 |         '中国工商银行',
24 |         '中国光大银行',
25 |         '中国建设银行',
26 |         '中国民生银行',
27 |         '中国农业银行',
28 |         '中国银行',
29 |         '中国邮政储蓄银行',
30 |         '中信银行',
31 |         '東亞銀行',
32 |         '大生銀行',
33 |         '匯立銀行',
34 |     ];
35 | 
36 |     /**
37 |      * @return string
38 |      * @example '中国建设银行'
39 |      */
40 |     public static function bank(): string
41 |     {
42 |         return static::randomElement(static::$banks);
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Provider/zh_CN/PhoneNumber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_CN;
 4 | 
 5 | class PhoneNumber extends \Poppy\Faker\Provider\PhoneNumber
 6 | {
 7 |     protected static $operators = [
 8 |         134, 135, 136, 137, 138, 139, 147, 150, 151, 152, 157, 158, 159, 1705, 178, 182, 183, 184, 187, 188, // China Mobile
 9 |         130, 131, 132, 145, 155, 156, 1707, 1708, 1709, 1718, 1719, 176, 185, 186,                           // China Unicom
10 |         133, 153, 1700, 1701, 177, 180, 181, 189,                                                            // China Telecom
11 |         170, 171,                                                                                            // virtual operators
12 |     ];
13 | 
14 |     protected static array $formats = ['###########'];
15 | 
16 |     public function phoneNumber(): string
17 |     {
18 |         $operator = static::randomElement(static::$operators);
19 |         $format   = static::randomElement(static::$formats);
20 | 
21 |         return $operator . static::numerify(substr($format, 0, strlen($format) - strlen($operator)));
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/FakeJsonsTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types = 1);
 4 | 
 5 | namespace Poppy\Faker\Tests\JsonSchema;
 6 | 
 7 | use JsonSchema\Validator;
 8 | use Poppy\Faker\JsonSchema\FakeJsons;
 9 | 
10 | class FakeJsonsTest extends TestCase
11 | {
12 |     /**
13 |      * @var FakeJsons
14 |      */
15 |     protected FakeJsons $fakeJsons;
16 | 
17 |     protected function setUp(): void
18 |     {
19 |         $this->fakeJsons = new FakeJsons();
20 |     }
21 | 
22 |     public function testInvoke(): void
23 |     {
24 |         ($this->fakeJsons)(__DIR__ . '/fixture', __DIR__ . '/dist', 'http://example.com/schema');
25 |         $validator = new Validator();
26 |         $data      = json_decode((string) file_get_contents(__DIR__ . '/dist/ref_file_double.json'));
27 |         $validator->validate($data, (object) ['$ref' => 'file://' . __DIR__ . '/fixture/ref_file_double.json']);
28 |         foreach ($validator->getErrors() as $error) {
29 |             fwrite(STDOUT, sprintf("[%s] %s\n", $error['property'], $error['message']));
30 |         }
31 |         $this->assertTrue($validator->isValid());
32 |     }
33 | 
34 | 
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Provider/Company.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider;
 4 | 
 5 | class Company extends Base
 6 | {
 7 |     protected static array $formats = [
 8 |         '{{lastName}} {{companySuffix}}',
 9 |     ];
10 | 
11 |     protected static array $companySuffix = ['Ltd'];
12 | 
13 |     protected static array $jobTitleFormat = [
14 |         '{{word}}',
15 |     ];
16 | 
17 |     /**
18 |      * @return string
19 |      * @example 'Acme Ltd'
20 |      *
21 |      */
22 |     public function company()
23 |     {
24 |         $format = static::randomElement(static::$formats);
25 | 
26 |         return $this->generator->parse($format);
27 |     }
28 | 
29 |     /**
30 |      * @return string
31 |      * @example 'Ltd'
32 |      *
33 |      */
34 |     public static function companySuffix()
35 |     {
36 |         return static::randomElement(static::$companySuffix);
37 |     }
38 | 
39 |     /**
40 |      * @return string
41 |      * @example 'Job'
42 |      *
43 |      */
44 |     public function jobTitle()
45 |     {
46 |         $format = static::randomElement(static::$jobTitleFormat);
47 | 
48 |         return $this->generator->parse($format);
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Calculator/Inn.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Calculator;
 4 | 
 5 | class Inn
 6 | {
 7 |     /**
 8 |      * Generates INN Checksum
 9 |      *
10 |      * 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
11 |      *
12 |      * @param string $inn
13 |      * @return string Checksum (one digit)
14 |      */
15 |     public static function checksum($inn)
16 |     {
17 |         $multipliers = [1 => 2, 2 => 4, 3 => 10, 4 => 3, 5 => 5, 6 => 9, 7 => 4, 8 => 6, 9 => 8];
18 |         $sum         = 0;
19 |         for ($i = 1; $i <= 9; $i++) {
20 |             $sum += intval(substr($inn, $i - 1, 1)) * $multipliers[$i];
21 |         }
22 |         return strval(($sum % 11) % 10);
23 |     }
24 | 
25 |     /**
26 |      * Checks whether an INN has a valid checksum
27 |      *
28 |      * @param string $inn
29 |      * @return boolean
30 |      */
31 |     public static function isValid($inn)
32 |     {
33 |         return self::checksum(substr($inn, 0, -1)) === substr($inn, -1, 1);
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2018 duoli
 2 | Copyright (c) 2011 François Zaninotto
 3 | Portions Copyright (c) 2008 Caius Durling
 4 | Portions Copyright (c) 2008 Adam Royle
 5 | Portions Copyright (c) 2008 Fiona Burrows
 6 | 
 7 | Permission is hereby granted, free of charge, to any person obtaining a copy
 8 | of this software and associated documentation files (the "Software"), to deal
 9 | in the Software without restriction, including without limitation the rights
10 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 | copies of the Software, and to permit persons to whom the Software is
12 | furnished to do so, subject to the following conditions:
13 | 
14 | The above copyright notice and this permission notice shall be included in
15 | all copies or substantial portions of the Software.
16 | 
17 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23 | THE SOFTWARE.
24 | 


--------------------------------------------------------------------------------
/src/Provider/PhoneNumber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider;
 4 | 
 5 | use Poppy\Faker\Calculator\Luhn;
 6 | 
 7 | class PhoneNumber extends Base
 8 | {
 9 |     protected static array $formats = ['###-###-###'];
10 | 
11 |     /**
12 |      * @example '555-123-546'
13 |      */
14 |     public function phoneNumber(): string
15 |     {
16 |         return static::numerify($this->generator->parse(static::randomElement(static::$formats)));
17 |     }
18 | 
19 |     /**
20 |      * @return string
21 |      * @example +27113456789
22 |      */
23 |     public function e164PhoneNumber(): string
24 |     {
25 |         $formats = ['+%############'];
26 |         return static::numerify($this->generator->parse(static::randomElement($formats)));
27 |     }
28 | 
29 |     /**
30 |      * International Mobile Equipment Identity (IMEI)
31 |      *
32 |      * @link    http://en.wikipedia.org/wiki/International_Mobile_Station_Equipment_Identity
33 |      * @link    http://imei-number.com/imei-validation-check/
34 |      * @example '720084494799532'
35 |      * @return string $imei
36 |      */
37 |     public function imei(): string
38 |     {
39 |         $imei = static::numerify('##############');
40 |         $imei .= Luhn::computeCheckDigit($imei);
41 |         return $imei;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/ref_inline.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly",
 5 |         "typeAndMinItems",
 6 |         "typeAndMaxItems",
 7 |         "typeAndMinItems",
 8 |         "typeAndMultipleItems"
 9 |     ],
10 |     "properties": {
11 |         "typeOnly": {
12 |             "$ref": "#/definitions/typeOnly"
13 |         },
14 |         "typeAndMaxItems": {
15 |             "$ref": "#/definitions/typeAndMaxItems"
16 |         },
17 |         "typeAndMinItems": {
18 |             "$ref": "#/definitions/typeAndMinItems"
19 |         },
20 |         "typeAndMultipleItems": {
21 |             "$ref": "#/definitions/typeAndMultipleItems"
22 |         }
23 |     },
24 |     "definitions": {
25 |         "typeOnly": {
26 |             "type": "array"
27 |         },
28 |         "typeAndMaxItems": {
29 |             "type": "array",
30 |             "maxItems": 10
31 |         },
32 |         "typeAndMinItems": {
33 |             "type": "array",
34 |             "minItems": 10,
35 |             "maxItems": 10
36 |         },
37 |         "typeAndMultipleItems": {
38 |             "type": "array",
39 |             "items": [
40 |                 {
41 |                     "type": "integer"
42 |                 },
43 |                 {
44 |                     "type": "string"
45 |                 }
46 |             ]
47 |         }
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/integer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly",
 5 |         "typeAndEnum",
 6 |         "typeAndMinimum",
 7 |         "typeAndExcludeMinimum",
 8 |         "typeAndMaximum",
 9 |         "typeAndExcludeMinimum",
10 |         "typeAndMinimumAndMaximum",
11 |         "typeAndMultipleOf"
12 |     ],
13 |     "properties": {
14 |         "typeOnly": {
15 |             "type": "integer"
16 |         },
17 |         "typeAndEnum": {
18 |             "type": "integer",
19 |             "enum": [
20 |                 -100,
21 |                 391,
22 |                 2,
23 |                 0
24 |             ]
25 |         },
26 |         "typeAndMinimum": {
27 |             "type": "integer",
28 |             "minimum": -1
29 |         },
30 |         "typeAndExcludeMinimum": {
31 |             "type": "integer",
32 |             "minimum": -1,
33 |             "maximum": 3,
34 |             "exclusiveMinimum": true
35 |         },
36 |         "typeAndMaximum": {
37 |             "type": "integer",
38 |             "maximum": 3
39 |         },
40 |         "typeAndMinimumAndMaximum": {
41 |             "type": "integer",
42 |             "minimum": -3010210,
43 |             "maximum": 312
44 |         },
45 |         "typeAndMultipleOf": {
46 |             "type": "integer",
47 |             "multipleOf": 3
48 |         }
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Provider/en_US/Payment.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\en_US;
 4 | 
 5 | class Payment extends \Poppy\Faker\Provider\Payment
 6 | {
 7 |     public function bankAccountNumber(): string
 8 |     {
 9 |         // Length between 5 and 17, biased towards center
10 |         $length = self::numberBetween(0, 3) + self::numberBetween(0, 3) + self::numberBetween(0, 3) + self::numberBetween(0, 3) + 5;
11 | 
12 |         return self::numerify(str_repeat('#', $length));
13 |     }
14 | 
15 |     public function bankRoutingNumber(): string
16 |     {
17 |         $district       = self::numberBetween(1, 12);
18 |         $type           = self::randomElement([0, 0, 0, 0, 20, 20, 60]);
19 |         $clearingCenter = self::randomDigitNotNull();
20 |         $state          = self::randomDigit();
21 |         $institution    = self::randomNumber(4, true);
22 | 
23 |         $result = sprintf('%02d%01d%01d%04d', $district + $type, $clearingCenter, $state, $institution);
24 | 
25 |         return $result . self::calculateRoutingNumberChecksum($result);
26 |     }
27 | 
28 |     public static function calculateRoutingNumberChecksum($routing): int
29 |     {
30 |         return (
31 |                 7 * ($routing[0] + $routing[3] + $routing[6]) +
32 |                 3 * ($routing[1] + $routing[4] + $routing[7]) +
33 |                 9 * ($routing[2] + $routing[5])
34 |             ) % 10;
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/combining.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "allOf",
 5 |         "anyOf",
 6 |         "oneOf"
 7 |     ],
 8 |     "properties": {
 9 |         "allOf": {
10 |             "allOf": [
11 |                 {
12 |                     "type": "object"
13 |                 },
14 |                 {
15 |                     "minProperties": 3
16 |                 }
17 |             ]
18 |         },
19 |         "anyOf": {
20 |             "anyOf": [
21 |                 {
22 |                     "type": "object",
23 |                     "maxProperties": 3
24 |                 },
25 |                 {
26 |                     "type": "string",
27 |                     "maxLength": 103
28 |                 },
29 |                 {
30 |                     "type": "integer",
31 |                     "maximum": 137
32 |                 }
33 |             ]
34 |         },
35 |         "oneOf": {
36 |             "oneOf": [
37 |                 {
38 |                     "type": "array",
39 |                     "items": {
40 |                         "type": "null"
41 |                     }
42 |                 },
43 |                 {
44 |                     "type": "string",
45 |                     "minLength": 103
46 |                 },
47 |                 {
48 |                     "type": "boolean"
49 |                 }
50 |             ]
51 |         }
52 |     }
53 | }


--------------------------------------------------------------------------------
/src/Provider/zh_CN/DateTime.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_CN;
 4 | 
 5 | class DateTime extends \Poppy\Faker\Provider\DateTime
 6 | {
 7 |     public static function amPm($max = 'now')
 8 |     {
 9 |         return static::dateTime($max)->format('a') === 'am' ? '上午' : '下午';
10 |     }
11 | 
12 |     public static function dayOfWeek($max = 'now')
13 |     {
14 |         $map  = [
15 |             'Sunday'    => '星期日',
16 |             'Monday'    => '星期一',
17 |             'Tuesday'   => '星期二',
18 |             'Wednesday' => '星期三',
19 |             'Thursday'  => '星期四',
20 |             'Friday'    => '星期五',
21 |             'Saturday'  => '星期六',
22 |         ];
23 |         $week = static::dateTime($max)->format('l');
24 |         return $map[$week] ?? $week;
25 |     }
26 | 
27 |     public static function monthName($max = 'now')
28 |     {
29 |         $map   = [
30 |             'January'   => '一月',
31 |             'February'  => '二月',
32 |             'March'     => '三月',
33 |             'April'     => '四月',
34 |             'May'       => '五月',
35 |             'June'      => '六月',
36 |             'July'      => '七月',
37 |             'August'    => '八月',
38 |             'September' => '九月',
39 |             'October'   => '十月',
40 |             'November'  => '十一月',
41 |             'December'  => '十二月',
42 |         ];
43 |         $month = static::dateTime($max)->format('F');
44 |         return $map[$month] ?? $month;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Provider/zh_TW/DateTime.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_TW;
 4 | 
 5 | class DateTime extends \Poppy\Faker\Provider\DateTime
 6 | {
 7 |     public static function amPm($max = 'now')
 8 |     {
 9 |         return static::dateTime($max)->format('a') === 'am' ? '上午' : '下午';
10 |     }
11 | 
12 |     public static function dayOfWeek($max = 'now')
13 |     {
14 |         $map  = [
15 |             'Sunday'    => '星期日',
16 |             'Monday'    => '星期一',
17 |             'Tuesday'   => '星期二',
18 |             'Wednesday' => '星期三',
19 |             'Thursday'  => '星期四',
20 |             'Friday'    => '星期五',
21 |             'Saturday'  => '星期六',
22 |         ];
23 |         $week = static::dateTime($max)->format('l');
24 |         return $map[$week] ?? $week;
25 |     }
26 | 
27 |     public static function monthName($max = 'now')
28 |     {
29 |         $map   = [
30 |             'January'   => '一月',
31 |             'February'  => '二月',
32 |             'March'     => '三月',
33 |             'April'     => '四月',
34 |             'May'       => '五月',
35 |             'June'      => '六月',
36 |             'July'      => '七月',
37 |             'August'    => '八月',
38 |             'September' => '九月',
39 |             'October'   => '十月',
40 |             'November'  => '十一月',
41 |             'December'  => '十二月',
42 |         ];
43 |         $month = static::dateTime($max)->format('F');
44 |         return $map[$month] ?? $month;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Calculator/Ean.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Calculator;
 4 | 
 5 | /**
 6 |  * Utility class for validating EAN-8 and EAN-13 numbers
 7 |  *
 8 |  */
 9 | class Ean
10 | {
11 |     /**
12 |      * @var string EAN validation pattern
13 |      */
14 |     private const PATTERN = '/^(?:\d{8}|\d{13})$/';
15 | 
16 |     /**
17 |      * Computes the checksum of an EAN number.
18 |      *
19 |      * @see https://en.wikipedia.org/wiki/International_Article_Number
20 |      *
21 |      * @param string $digits
22 |      * @return int
23 |      */
24 |     public static function checksum(string $digits): int
25 |     {
26 |         $length = strlen($digits);
27 | 
28 |         $even = 0;
29 |         for ($i = $length - 1; $i >= 0; $i -= 2) {
30 |             $even += (int) $digits[$i];
31 |         }
32 | 
33 |         $odd = 0;
34 |         for ($i = $length - 2; $i >= 0; $i -= 2) {
35 |             $odd += (int) $digits[$i];
36 |         }
37 | 
38 |         return (10 - ((3 * $even + $odd) % 10)) % 10;
39 |     }
40 | 
41 |     /**
42 |      * Checks whether the provided number is an EAN compliant number and that
43 |      * the checksum is correct.
44 |      *
45 |      * @param string $ean An EAN number
46 |      * @return boolean
47 |      */
48 |     public static function isValid(string $ean): bool
49 |     {
50 |         if (!preg_match(self::PATTERN, $ean)) {
51 |             return false;
52 |         }
53 | 
54 |         return self::checksum(substr($ean, 0, -1)) === (int) substr($ean, -1);
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/number.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly",
 5 |         "typeAndEnum",
 6 |         "typeAndMinimum",
 7 |         "typeAndExcludeMinimum",
 8 |         "typeAndMaximum",
 9 |         "typeAndExcludeMinimum",
10 |         "typeAndMinimumAndMaximum",
11 |         "typeAndMultipleOf"
12 |     ],
13 |     "properties": {
14 |         "typeOnly": {
15 |             "type": "number"
16 |         },
17 |         "typeAndEnum": {
18 |             "type": "number",
19 |             "enum": [
20 |                 -10.0,
21 |                 3.91,
22 |                 2.1,
23 |                 -0.1
24 |             ]
25 |         },
26 |         "typeAndMinimum": {
27 |             "type": "number",
28 |             "minimum": -1
29 |         },
30 |         "typeAndExcludeMinimum": {
31 |             "type": "number",
32 |             "minimum": -1,
33 |             "exclusiveMinimum": true
34 |         },
35 |         "typeAndMaximum": {
36 |             "type": "number",
37 |             "maximum": 3
38 |         },
39 |         "typeAndExcludeMinimum": {
40 |             "type": "number",
41 |             "maximum": 3,
42 |             "excludeMinimum": true
43 |         },
44 |         "typeAndMinimumAndMaximum": {
45 |             "type": "number",
46 |             "minimum": -301.0210,
47 |             "maximum": 312
48 |         },
49 |         "typeAndMultipleOf": {
50 |             "type": "number",
51 |             "multipleOf": 3
52 |         }
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/src/Calculator/TCNo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Calculator;
 4 | 
 5 | use InvalidArgumentException;
 6 | 
 7 | class TCNo
 8 | {
 9 |     /**
10 |      * Generates Turkish Identity Number Checksum
11 |      * Gets first 9 digit as prefix and calculates checksum
12 |      *
13 |      * https://en.wikipedia.org/wiki/Turkish_Identification_Number
14 |      *
15 |      * @param string $identityPrefix
16 |      * @return string Checksum (two digit)
17 |      */
18 |     public static function checksum($identityPrefix)
19 |     {
20 |         if (strlen((string) $identityPrefix) !== 9) {
21 |             throw new InvalidArgumentException('Argument should be an integer and should be 9 digits.');
22 |         }
23 | 
24 |         $oddSum  = 0;
25 |         $evenSum = 0;
26 | 
27 |         $identityArray = array_map('intval', str_split($identityPrefix)); // Creates array from int
28 |         foreach ($identityArray as $index => $digit) {
29 |             if ($index % 2 == 0) {
30 |                 $evenSum += $digit;
31 |             }
32 |             else {
33 |                 $oddSum += $digit;
34 |             }
35 |         }
36 | 
37 |         $tenthDigit    = (7 * $evenSum - $oddSum) % 10;
38 |         $eleventhDigit = ($evenSum + $oddSum + $tenthDigit) % 10;
39 | 
40 |         return $tenthDigit . $eleventhDigit;
41 |     }
42 | 
43 |     /**
44 |      * Checks whether a TCNo has a valid checksum
45 |      *
46 |      * @param string $tcNo
47 |      * @return boolean
48 |      */
49 |     public static function isValid($tcNo)
50 |     {
51 |         return self::checksum(substr($tcNo, 0, -2)) === substr($tcNo, -2, 2);
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/UniqueGenerator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker;
 4 | 
 5 | /**
 6 |  * Proxy for other generators, to return only unique values. Works with
 7 |  * Poppy\Faker\Generator\Base->unique()
 8 |  */
 9 | class UniqueGenerator
10 | {
11 |     protected $generator;
12 | 
13 |     protected $maxRetries;
14 | 
15 |     protected $uniques = [];
16 | 
17 |     /**
18 |      * @param Generator $generator
19 |      * @param integer $maxRetries
20 |      */
21 |     public function __construct(Generator $generator, $maxRetries = 10000)
22 |     {
23 |         $this->generator  = $generator;
24 |         $this->maxRetries = $maxRetries;
25 |     }
26 | 
27 |     /**
28 |      * Catch and proxy all generator calls but return only unique values
29 |      * @param string $attribute
30 |      * @return mixed
31 |      */
32 |     public function __get($attribute)
33 |     {
34 |         return $this->__call($attribute, []);
35 |     }
36 | 
37 |     /**
38 |      * Catch and proxy all generator calls with arguments but return only unique values
39 |      * @param string $name
40 |      * @param array $arguments
41 |      * @return mixed
42 |      */
43 |     public function __call($name, $arguments)
44 |     {
45 |         if (!isset($this->uniques[$name])) {
46 |             $this->uniques[$name] = [];
47 |         }
48 |         $i = 0;
49 |         do {
50 |             $res = call_user_func_array([$this->generator, $name], $arguments);
51 |             $i++;
52 |             if ($i > $this->maxRetries) {
53 |                 throw new \OverflowException(sprintf('Maximum retries of %d reached without finding a unique value', $this->maxRetries));
54 |             }
55 |         } while (array_key_exists(serialize($res), $this->uniques[$name]));
56 |         $this->uniques[$name][serialize($res)] = null;
57 | 
58 |         return $res;
59 |     }
60 | }
61 | 


--------------------------------------------------------------------------------
/src/Calculator/Iban.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Calculator;
 4 | 
 5 | class Iban
 6 | {
 7 |     /**
 8 |      * Generates IBAN Checksum
 9 |      *
10 |      * @param string $iban
11 |      * @return string Checksum (numeric string)
12 |      */
13 |     public static function checksum($iban)
14 |     {
15 |         // Move first four digits to end and set checksum to '00'
16 |         $checkString = substr($iban, 4) . substr($iban, 0, 2) . '00';
17 | 
18 |         // Replace all letters with their number equivalents
19 |         $checkString = preg_replace_callback('/[A-Z]/', ['self', 'alphaToNumberCallback'], $checkString);
20 | 
21 |         // Perform mod 97 and subtract from 98
22 |         $checksum = 98 - self::mod97($checkString);
23 | 
24 |         return str_pad($checksum, 2, '0', STR_PAD_LEFT);
25 |     }
26 | 
27 |     /**
28 |      * @param string $match
29 |      *
30 |      * @return int
31 |      */
32 |     private static function alphaToNumberCallback($match)
33 |     {
34 |         return self::alphaToNumber($match[0]);
35 |     }
36 | 
37 |     /**
38 |      * Converts letter to number
39 |      *
40 |      * @param string $char
41 |      * @return int
42 |      */
43 |     public static function alphaToNumber($char)
44 |     {
45 |         return ord($char) - 55;
46 |     }
47 | 
48 |     /**
49 |      * Calculates mod97 on a numeric string
50 |      *
51 |      * @param string $number Numeric string
52 |      * @return int
53 |      */
54 |     public static function mod97($number)
55 |     {
56 |         $checksum = (int) $number[0];
57 |         for ($i = 1, $size = strlen($number); $i < $size; $i++) {
58 |             $checksum = (10 * $checksum + (int) $number[$i]) % 97;
59 |         }
60 |         return $checksum;
61 |     }
62 | 
63 |     /**
64 |      * Checks whether an IBAN has a valid checksum
65 |      *
66 |      * @param string $iban
67 |      * @return boolean
68 |      */
69 |     public static function isValid($iban)
70 |     {
71 |         return self::checksum($iban) === substr($iban, 2, 2);
72 |     }
73 | }
74 | 


--------------------------------------------------------------------------------
/src/Provider/Uuid.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types = 1);
 4 | 
 5 | namespace Poppy\Faker\Provider;
 6 | 
 7 | class Uuid extends Base
 8 | {
 9 |     /**
10 |      * Generate name based md5 UUID (version 3).
11 |      * @example '7e57d004-2b97-0e7a-b45f-5387367791cd'
12 |      */
13 |     public static function uuid(): string
14 |     {
15 |         // fix for compatibility with 32bit architecture; each mt_rand call is restricted to 32bit
16 |         // two such calls will cause 64bits of randomness regardless of architecture
17 |         $seed = mt_rand(0, 2147483647) . '#' . mt_rand(0, 2147483647);
18 | 
19 |         // Hash the seed and convert to a byte array
20 |         $val  = md5($seed, true);
21 |         $byte = array_values(unpack('C16', $val));
22 | 
23 |         // extract fields from byte array
24 |         $tLo  = ($byte[0] << 24) | ($byte[1] << 16) | ($byte[2] << 8) | $byte[3];
25 |         $tMi  = ($byte[4] << 8) | $byte[5];
26 |         $tHi  = ($byte[6] << 8) | $byte[7];
27 |         $csLo = $byte[9];
28 |         $csHi = $byte[8] & 0x3f | (1 << 7);
29 | 
30 |         // correct byte order for big edian architecture
31 |         if (pack('L', 0x6162797A) == pack('N', 0x6162797A)) {
32 |             $tLo = (($tLo & 0x000000ff) << 24) | (($tLo & 0x0000ff00) << 8)
33 |                 | (($tLo & 0x00ff0000) >> 8) | (($tLo & 0xff000000) >> 24);
34 |             $tMi = (($tMi & 0x00ff) << 8) | (($tMi & 0xff00) >> 8);
35 |             $tHi = (($tHi & 0x00ff) << 8) | (($tHi & 0xff00) >> 8);
36 |         }
37 | 
38 |         // apply version number
39 |         $tHi &= 0x0fff;
40 |         $tHi |= (3 << 12);
41 | 
42 |         // cast to string
43 |         return sprintf(
44 |             '%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x',
45 |             $tLo,
46 |             $tMi,
47 |             $tHi,
48 |             $csHi,
49 |             $csLo,
50 |             $byte[10],
51 |             $byte[11],
52 |             $byte[12],
53 |             $byte[13],
54 |             $byte[14],
55 |             $byte[15]
56 |         );
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/string.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "object",
 3 |     "required": [
 4 |         "typeOnly",
 5 |         "typeAndEnum",
 6 |         "typeAndMaxLength",
 7 |         "typeAndMinLength",
 8 |         "typeAndMinLengthAndMaxLength",
 9 |         "typeAndPattern",
10 |         "typeAndFormat(date-time)",
11 |         "typeAndFormat(email)",
12 |         "typeAndFormat(hostname)",
13 |         "typeAndFormat(ipv4)",
14 |         "typeAndFormat(ipv6)",
15 |         "typeAndFormat(uri)"
16 |     ],
17 |     "properties": {
18 |         "typeOnly": {
19 |             "type": "string"
20 |         },
21 |         "typeAndEnum": {
22 |             "type": "string",
23 |             "enum": [
24 |                 "aaa",
25 |                 "xabc1290あ_!#"
26 |             ]
27 |         },
28 |         "typeAndMaxLength": {
29 |             "type": "string",
30 |             "maxLength": 132
31 |         },
32 |         "typeAndMinLength": {
33 |             "type": "string",
34 |             "minLength": 132
35 |         },
36 |         "typeAndMinLengthAndMaxLength": {
37 |             "type": "string",
38 |             "minLength": 132,
39 |             "maxLength": 13218
40 |         },
41 |         "typeAndPattern": {
42 |             "type": "string",
43 |             "pattern": "^[0-9]{3}-[0-9]{4}$"
44 |         },
45 |         "typeAndFormat(date-time)": {
46 |             "type": "string",
47 |             "format": "date-time"
48 |         },
49 |         "typeAndFormat(email)": {
50 |             "type": "string",
51 |             "format": "email"
52 |         },
53 |         "typeAndFormat(hostname)": {
54 |             "type": "string",
55 |             "format": "hostname"
56 |         },
57 |         "typeAndFormat(ipv4)": {
58 |             "type": "string",
59 |             "format": "ipv4"
60 |         },
61 |         "typeAndFormat(ipv6)": {
62 |             "type": "string",
63 |             "format": "ipv6"
64 |         },
65 |         "typeAndFormat(uri)": {
66 |             "type": "string",
67 |             "format": "uri"
68 |         }
69 |     }
70 | }
71 | 


--------------------------------------------------------------------------------
/src/Calculator/Luhn.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Calculator;
 4 | 
 5 | use InvalidArgumentException;
 6 | 
 7 | /**
 8 |  * Utility class for generating and validating Luhn numbers.
 9 |  *
10 |  * Luhn algorithm is used to validate credit card numbers, IMEI numbers, and
11 |  * National Provider Identifier numbers.
12 |  *
13 |  * @see http://en.wikipedia.org/wiki/Luhn_algorithm
14 |  */
15 | class Luhn
16 | {
17 |     /**
18 |      * @param string $number
19 |      * @return int
20 |      */
21 |     private static function checksum($number)
22 |     {
23 |         $number = (string) $number;
24 |         $length = strlen($number);
25 |         $sum    = 0;
26 |         for ($i = $length - 1; $i >= 0; $i -= 2) {
27 |             $sum += $number[$i];
28 |         }
29 |         for ($i = $length - 2; $i >= 0; $i -= 2) {
30 |             $sum += array_sum(str_split($number[$i] * 2));
31 |         }
32 | 
33 |         return $sum % 10;
34 |     }
35 | 
36 |     /**
37 |      * @param $partialNumber
38 |      * @return string
39 |      */
40 |     public static function computeCheckDigit($partialNumber)
41 |     {
42 |         $checkDigit = self::checksum($partialNumber . '0');
43 |         if ($checkDigit === 0) {
44 |             return 0;
45 |         }
46 | 
47 |         return (string) (10 - $checkDigit);
48 |     }
49 | 
50 |     /**
51 |      * Checks whether a number (partial number + check digit) is Luhn compliant
52 |      *
53 |      * @param string $number
54 |      * @return bool
55 |      */
56 |     public static function isValid($number)
57 |     {
58 |         return self::checksum($number) === 0;
59 |     }
60 | 
61 |     /**
62 |      * Generate a Luhn compliant number.
63 |      *
64 |      * @param string $partialValue
65 |      *
66 |      * @return string
67 |      */
68 |     public static function generateLuhnNumber($partialValue)
69 |     {
70 |         if (!preg_match('/^\d+$/', $partialValue)) {
71 |             throw new InvalidArgumentException('Argument should be an integer.');
72 |         }
73 |         return $partialValue . Luhn::computeCheckDigit($partialValue);
74 |     }
75 | }
76 | 


--------------------------------------------------------------------------------
/src/Provider/Biased.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider;
 4 | 
 5 | class Biased extends Base
 6 | {
 7 |     /**
 8 |      * Returns a biased integer between $min and $max (both inclusive).
 9 |      * The distribution depends on $function.
10 |      *
11 |      * The algorithm creates two doubles, x ∈ [0, 1], y ∈ [0, 1) and checks whether the
12 |      * return value of $function for x is greater than or equal to y. If this is
13 |      * the case the number is accepted and x is mapped to the appropriate integer
14 |      * between $min and $max. Otherwise, two new doubles are created until the pair
15 |      * is accepted.
16 |      *
17 |      * @param integer  $min      Minimum value of the generated integers.
18 |      * @param integer  $max      Maximum value of the generated integers.
19 |      * @param callable $function A function mapping x ∈ [0, 1] onto a double ∈ [0, 1]
20 |      * @return integer An integer between $min and $max.
21 |      */
22 |     public function biasedNumberBetween($min = 0, $max = 100, $function = 'sqrt')
23 |     {
24 |         do {
25 |             $x = mt_rand() / mt_getrandmax();
26 |             $y = mt_rand() / (mt_getrandmax() + 1);
27 |         } while (call_user_func($function, $x) < $y);
28 | 
29 |         return (int) floor($x * ($max - $min + 1) + $min);
30 |     }
31 | 
32 |     /**
33 |      * 'unbiased' creates an unbiased distribution by giving
34 |      * each value the same value of one.
35 |      *
36 |      * @return integer
37 |      */
38 |     protected static function unbiased()
39 |     {
40 |         return 1;
41 |     }
42 | 
43 |     /**
44 |      * 'linearLow' favors lower numbers. The probability decreases
45 |      * in a linear fashion.
46 |      *
47 |      * @return integer
48 |      */
49 |     protected static function linearLow($x)
50 |     {
51 |         return 1 - $x;
52 |     }
53 | 
54 |     /**
55 |      * 'linearHigh' favors higher numbers. The probability increases
56 |      * in a linear fashion.
57 |      *
58 |      * @return integer
59 |      */
60 |     protected static function linearHigh($x)
61 |     {
62 |         return $x;
63 |     }
64 | }
65 | 


--------------------------------------------------------------------------------
/src/ValidGenerator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker;
 4 | 
 5 | use InvalidArgumentException;
 6 | use OverflowException;
 7 | 
 8 | /**
 9 |  * Proxy for other generators, to return only valid values. Works with
10 |  * Poppy\Faker\Generator\Base->valid()
11 |  */
12 | class ValidGenerator
13 | {
14 |     protected $generator;
15 | 
16 |     protected $validator;
17 | 
18 |     protected $maxRetries;
19 | 
20 |     /**
21 |      * @param Generator $generator
22 |      * @param callable|null $validator
23 |      * @param integer $maxRetries
24 |      */
25 |     public function __construct(Generator $generator, $validator = null, $maxRetries = 10000)
26 |     {
27 |         if (is_null($validator)) {
28 |             $validator = function () {
29 |                 return true;
30 |             };
31 |         }
32 |         elseif (!is_callable($validator)) {
33 |             throw new InvalidArgumentException('valid() only accepts callables as first argument');
34 |         }
35 |         $this->generator  = $generator;
36 |         $this->validator  = $validator;
37 |         $this->maxRetries = $maxRetries;
38 |     }
39 | 
40 |     /**
41 |      * Catch and proxy all generator calls but return only valid values
42 |      * @param string $attribute
43 |      *
44 |      * @return mixed
45 |      */
46 |     public function __get($attribute)
47 |     {
48 |         return $this->__call($attribute, []);
49 |     }
50 | 
51 |     /**
52 |      * Catch and proxy all generator calls with arguments but return only valid values
53 |      * @param string $name
54 |      * @param array $arguments
55 |      *
56 |      * @return mixed
57 |      */
58 |     public function __call($name, $arguments)
59 |     {
60 |         $i = 0;
61 |         do {
62 |             $res = call_user_func_array([$this->generator, $name], $arguments);
63 |             $i++;
64 |             if ($i > $this->maxRetries) {
65 |                 throw new OverflowException(sprintf('Maximum retries of %d reached without finding a valid value', $this->maxRetries));
66 |             }
67 |         } while (!call_user_func($this->validator, $res));
68 | 
69 |         return $res;
70 |     }
71 | }
72 | 


--------------------------------------------------------------------------------
/src/Factory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker;
 4 | 
 5 | use InvalidArgumentException;
 6 | 
 7 | class Factory
 8 | {
 9 |     const DEFAULT_LOCALE = 'en_US';
10 | 
11 |     protected static array $defaultProviders = [
12 |         'Address', 'Barcode', 'Biased', 'Color', 'Company',
13 |         'DateTime', 'File', 'HtmlLorem', 'Image', 'Internet', 'Lorem', 'Miscellaneous',
14 |         'Payment', 'Person', 'PhoneNumber', 'Text', 'UserAgent', 'Uuid',
15 |     ];
16 | 
17 |     /**
18 |      * Create a new generator
19 |      *
20 |      * @param string $locale
21 |      * @return Generator
22 |      */
23 |     public static function create($locale = self::DEFAULT_LOCALE)
24 |     {
25 |         $generator = new \Faker\Generator();
26 |         foreach (static::$defaultProviders as $provider) {
27 |             $providerClassName = self::getProviderClassname($provider, $locale);
28 |             $generator->addProvider(new $providerClassName($generator));
29 |         }
30 | 
31 |         return $generator;
32 |     }
33 | 
34 |     /**
35 |      * @param string $provider
36 |      * @param string $locale
37 |      * @return string
38 |      */
39 |     protected static function getProviderClassname($provider, $locale = '')
40 |     {
41 |         if ($providerClass = self::findProviderClassname($provider, $locale)) {
42 |             return $providerClass;
43 |         }
44 |         // fallback to default locale
45 |         if ($providerClass = self::findProviderClassname($provider, static::DEFAULT_LOCALE)) {
46 |             return $providerClass;
47 |         }
48 |         // fallback to no locale
49 |         if ($providerClass = self::findProviderClassname($provider)) {
50 |             return $providerClass;
51 |         }
52 |         throw new InvalidArgumentException(sprintf('Unable to find provider "%s" with locale "%s"', $provider, $locale));
53 |     }
54 | 
55 |     /**
56 |      * @param string $provider
57 |      * @param string $locale
58 |      * @return string
59 |      */
60 |     protected static function findProviderClassname($provider, $locale = '')
61 |     {
62 |         $providerClass = 'Poppy\\Faker\\' . ($locale ? sprintf('Provider\%s\%s', $locale, $provider) : sprintf('Provider\%s', $provider));
63 |         if (class_exists($providerClass)) {
64 |             return $providerClass;
65 |         }
66 |     }
67 | }
68 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/FakerTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types = 1);
 4 | 
 5 | namespace Poppy\Faker\Tests\JsonSchema;
 6 | 
 7 | use InvalidArgumentException;
 8 | use JsonSchema\Validator;
 9 | use Poppy\Faker\JsonSchema\Faker;
10 | use Poppy\Faker\JsonSchema\UnsupportedTypeException;
11 | use SplFileInfo;
12 | 
13 | class FakerTest extends TestCase
14 | {
15 |     /**
16 |      * @dataProvider getTypes
17 |      */
18 |     public function testFakeMustReturnValidValue($type)
19 |     {
20 |         $schema    = $this->getFixture($type);
21 |         $validator = new Validator();
22 | 
23 |         $actual = (new Faker)->generate($schema);
24 |         $validator->validate($actual, $schema);
25 | 
26 |         $this->assertTrue($validator->isValid(), (string) json_encode($validator->getErrors(), JSON_PRETTY_PRINT));
27 |     }
28 | 
29 |     /**
30 |      * @dataProvider getTypesAndFile
31 |      */
32 |     public function testFakeFromFile($type)
33 |     {
34 |         $schema    = $this->getFile($type);
35 |         $validator = new Validator();
36 | 
37 |         $actual = (new Faker)->generate(new SplFileInfo($schema));
38 |         $validator->validate($actual, $schema);
39 | 
40 |         $this->assertTrue($validator->isValid(), (string) json_encode($validator->getErrors(), JSON_PRETTY_PRINT));
41 |     }
42 | 
43 |     public function testGenerateInvalidParameter()
44 |     {
45 |         $this->expectException(InvalidArgumentException::class);
46 |         (new Faker)->generate(null);
47 |     }
48 | 
49 |     public function getTypes(): array
50 |     {
51 |         return [
52 |             ['boolean'],
53 |             ['null'],
54 |             ['integer'],
55 |             ['number'],
56 |             ['string'],
57 |             ['array'],
58 |             ['object'],
59 |             ['combining'],
60 |             ['ref_inline'],
61 |         ];
62 |     }
63 | 
64 |     public function getTypesAndFile(): array
65 |     {
66 |         return [
67 |             ['boolean'],
68 |             ['null'],
69 |             ['integer'],
70 |             ['number'],
71 |             ['string'],
72 |             ['array'],
73 |             ['object'],
74 |             ['combining'],
75 |             ['ref_file'],
76 |             ['ref_file_ref'],
77 |             ['ref_file_double'],
78 |             ['ref_array'],
79 |         ];
80 |     }
81 | 
82 |     public function testFakeMustThrowExceptionIfInvalidType()
83 |     {
84 |         $this->expectException(UnsupportedTypeException::class);
85 | 
86 |         (new Faker)->generate((object) ['type' => 'xxxxx']);
87 |     }
88 | }
89 | 


--------------------------------------------------------------------------------
/src/JsonSchema/FakeJsons.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types = 1);
 4 | 
 5 | namespace Poppy\Faker\JsonSchema;
 6 | 
 7 | use Exception;
 8 | use FilesystemIterator;
 9 | use Iterator;
10 | use RecursiveDirectoryIterator;
11 | use RecursiveIteratorIterator;
12 | use RegexIterator;
13 | use RuntimeException;
14 | use SplFileInfo;
15 | use stdClass;
16 | 
17 | final class FakeJsons
18 | {
19 |     public function __invoke(string $schemaDir, string $distDir, string $schemaUri = null): void
20 |     {
21 |         $faker = new Faker();
22 |         foreach ($this->files($schemaDir) as $fileInfo) {
23 |             /* @var SplFileInfo $fileInfo */
24 |             try {
25 |                 $fake           = $faker->generate($fileInfo);
26 |                 $schemaFilename = $fileInfo->getFilename();
27 |                 if ($fake instanceof stdClass && is_string($schemaUri)) {
28 |                     $fake->{'$schema'} = sprintf('%s/%s', $schemaUri, $schemaFilename);
29 |                 }
30 |                 $targetPath = $distDir . str_replace($schemaDir, '', $fileInfo->getPath());
31 |                 if (!file_exists($targetPath)) {
32 |                     if (!mkdir($targetPath, 0755, true) && !is_dir($targetPath)) {
33 |                         throw new RuntimeException(sprintf('Directory "%s" was not created', $targetPath));
34 |                     }
35 |                 }
36 |                 $distFile = sprintf('%s/%s', $targetPath, $schemaFilename);
37 |                 $fakeJson = json_encode($fake, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . PHP_EOL;
38 |                 fwrite(STDOUT, sprintf("Generate fake file: %s\n", $distFile));
39 |                 file_put_contents($distFile, $fakeJson);
40 |             } catch (Exception $e) {
41 |                 fwrite(STDOUT, sprintf("%s: %s %s on line %d\n", $fileInfo->getFilename(), $e->getMessage(), $e->getFile(), $e->getLine()));
42 |                 continue;
43 |             }
44 |         }
45 |     }
46 | 
47 |     private function files(string $dir): Iterator
48 |     {
49 |         return
50 |             new RegexIterator(
51 |                 new RecursiveIteratorIterator(
52 |                     new RecursiveDirectoryIterator(
53 |                         $dir,
54 |                         FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::SKIP_DOTS
55 |                     ),
56 |                     RecursiveIteratorIterator::LEAVES_ONLY
57 |                 ),
58 |                 "/^.+\\.json/",
59 |                 RegexIterator::MATCH
60 |             );
61 |     }
62 | }
63 | 


--------------------------------------------------------------------------------
/src/Provider/zh_CN/Color.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_CN;
 4 | 
 5 | class Color extends \Poppy\Faker\Provider\Color
 6 | {
 7 |     /**
 8 |      * @link https://zh.wikipedia.org/zh-cn/%E9%A2%9C%E8%89%B2%E5%88%97%E8%A1%A8
 9 |      */
10 |     protected static array $safeColorNames = [
11 |         '黑色', '粟色', '绿色', '藏青', '橄榄色',
12 |         '紫', '凫绿', '鲜绿色', '蓝色', '银色',
13 |         '灰色', '黄色', '品红', '水色', '白色',
14 |     ];
15 | 
16 |     protected static array $allColorNames = [
17 |         '黑色', '昏灰', '灰色', '暗灰', '银色', '亮灰色',
18 |         '庚斯博罗灰', '白烟色', '白色', '雪色', '铁灰色',
19 |         '沙棕', '玫瑰褐', '亮珊瑚色', '印度红', '褐色',
20 |         '耐火砖红', '栗色', '暗红', '鲜红', '红色', '柿子橙',
21 |         '雾玫瑰色', '鲑红', '腥红', '蕃茄红', '暗鲑红',
22 |         '珊瑚红', '橙红', '亮鲑红', '朱红', '赭黄', '热带橙',
23 |         '驼色', '杏黄', '椰褐', '海贝色', '鞍褐', '巧克力色',
24 |         '燃橙', '阳橙', '粉扑桃色', '沙褐', '古铜色', '亚麻色',
25 |         '蜜橙', '秘鲁色', '乌贼墨色', '赭色', '陶坯黄', '橘色',
26 |         '暗橙', '古董白', '日晒色', '硬木色', '杏仁白',
27 |         '那瓦霍白', '万寿菊黄', '蕃木瓜色', '灰土色',
28 |         '卡其色', '鹿皮鞋色', '旧蕾丝色', '小麦色', '桃色',
29 |         '橙色', '花卉白', '金菊色', '暗金菊色', '咖啡色',
30 |         '茉莉黄', '琥珀色', '玉米丝色', '铬黄', '金色',
31 |         '柠檬绸色', '亮卡其色', '灰金菊色', '暗卡其色',
32 |         '含羞草黄', '奶油色', '象牙色', '米黄色', '亮黄',
33 |         '亮金菊黄', '香槟黄', '芥末黄', '月黄', '橄榄色',
34 |         '鲜黄', '黄色', '苔藓绿', '亮柠檬绿', '橄榄军服绿',
35 |         '黄绿', '暗橄榄绿', '苹果绿', '绿黄', '草绿', '草坪绿',
36 |         '查特酒绿', '叶绿', '嫩绿', '明绿', '钴绿', '蜜瓜绿',
37 |         '暗海绿', '亮绿', '灰绿', '常春藤绿', '森林绿',
38 |         '柠檬绿', '暗绿', '绿色', '鲜绿色', '孔雀石绿',
39 |         '薄荷绿', '青瓷绿', '碧绿', '绿松石绿', '铬绿', '苍色',
40 |         '海绿', '中海绿', '薄荷奶油色', '春绿', '孔雀绿',
41 |         '中春绿色', '中碧蓝色', '碧蓝色', '青蓝', '水蓝',
42 |         '绿松石蓝', '绿松石色', '亮海绿', '中绿松石色',
43 |         '亮青', '浅蓝', '灰绿松石色', '暗岩灰', '凫绿', '暗青',
44 |         '青色', '水色', '暗绿松石色', '军服蓝', '孔雀蓝',
45 |         '婴儿粉蓝', '浓蓝', '亮蓝', '灰蓝', '萨克斯蓝',
46 |         '深天蓝', '天蓝', '亮天蓝', '水手蓝', '普鲁士蓝',
47 |         '钢青色', '爱丽丝蓝', '岩灰', '亮岩灰', '道奇蓝',
48 |         '矿蓝', '湛蓝', '韦奇伍德瓷蓝', '亮钢蓝', '钴蓝',
49 |         '灰丁宁蓝', '矢车菊蓝', '鼠尾草蓝', '暗婴儿粉蓝',
50 |         '蓝宝石色', '国际奇连蓝', '蔚蓝', '品蓝', '暗矿蓝',
51 |         '极浓海蓝', '天青石蓝', '幽灵白', '薰衣草紫',
52 |         '长春花色', '午夜蓝', '藏青', '暗蓝', '中蓝', '蓝色',
53 |         '紫藤色', '暗岩蓝', '岩蓝', '中岩蓝', '木槿紫',
54 |         '紫丁香色', '中紫红', '紫水晶色', '浅灰紫红',
55 |         '缬草紫', '矿紫', '蓝紫', '紫罗兰色', '靛色', '暗兰紫',
56 |         '暗紫', '三色堇紫', '锦葵紫', '优品紫红', '中兰紫',
57 |         '淡紫丁香色', '蓟紫', '铁线莲紫', '梅红色', '亮紫',
58 |         '紫色', '暗洋红', '洋红', '品红', '兰紫', '浅珍珠红',
59 |         '陈玫红', '浅玫瑰红', '中青紫红', '洋玫瑰红',
60 |         '玫瑰红', '红宝石色', '山茶红', '深粉红', '火鹤红',
61 |         '浅珊瑚红', '暖粉红', '勃根第酒红', '尖晶石红',
62 |         '胭脂红', '浅粉红', '枢机红', '薰衣草紫红', '灰紫红',
63 |         '樱桃红', '浅鲑红', '绯红', '粉红', '亮粉红', '壳黄红',
64 |         '茜红',
65 |     ];
66 | }
67 | 


--------------------------------------------------------------------------------
/src/Provider/zh_TW/Color.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\zh_TW;
 4 | 
 5 | class Color extends \Poppy\Faker\Provider\Color
 6 | {
 7 |     /**
 8 |      * @link http://zh.wikipedia.org/zh-tw/%E9%A2%9C%E8%89%B2%E5%88%97%E8%A1%A8
 9 |      */
10 |     protected static array $safeColorNames = [
11 |         '黑色', '粟色', '綠色', '藏青', '橄欖色',
12 |         '紫', '鳧綠', '鮮綠色', '藍色', '銀色',
13 |         '灰色', '黃色', '品紅', '水色', '白色',
14 |     ];
15 | 
16 |     protected static array $allColorNames = [
17 |         '黑色', '昏灰', '灰色', '暗灰', '銀色', '亮灰色',
18 |         '庚斯博羅灰', '白煙色', '白色', '雪色', '鐵灰色',
19 |         '沙棕', '玫瑰褐', '亮珊瑚色', '印度紅', '褐色',
20 |         '耐火磚紅', '栗色', '暗紅', '鮮紅', '紅色', '柿子橙',
21 |         '霧玫瑰色', '鮭紅', '腥紅', '蕃茄紅', '暗鮭紅',
22 |         '珊瑚紅', '橙紅', '亮鮭紅', '朱紅', '赭黃', '熱帶橙',
23 |         '駝色', '杏黃', '椰褐', '海貝色', '鞍褐', '巧克力色',
24 |         '燃橙', '陽橙', '粉撲桃色', '沙褐', '古銅色', '亞麻色',
25 |         '蜜橙', '秘魯色', '烏賊墨色', '赭色', '陶坯黃', '橘色',
26 |         '暗橙', '古董白', '日曬色', '硬木色', '杏仁白',
27 |         '那瓦霍白', '萬壽菊黃', '蕃木瓜色', '灰土色',
28 |         '卡其色', '鹿皮鞋色', '舊蕾絲色', '小麥色', '桃色',
29 |         '橙色', '花卉白', '金菊色', '暗金菊色', '咖啡色',
30 |         '茉莉黃', '琥珀色', '玉米絲色', '鉻黃', '金色',
31 |         '檸檬綢色', '亮卡其色', '灰金菊色', '暗卡其色',
32 |         '含羞草黃', '奶油色', '象牙色', '米黃色', '亮黃',
33 |         '亮金菊黃', '香檳黃', '芥末黃', '月黃', '橄欖色',
34 |         '鮮黃', '黃色', '苔蘚綠', '亮檸檬綠', '橄欖軍服綠',
35 |         '黃綠', '暗橄欖綠', '蘋果綠', '綠黃', '草綠', '草坪綠',
36 |         '查特酒綠', '葉綠', '嫩綠', '明綠', '鈷綠', '蜜瓜綠',
37 |         '暗海綠', '亮綠', '灰綠', '常春藤綠', '森林綠',
38 |         '檸檬綠', '暗綠', '綠色', '鮮綠色', '孔雀石綠',
39 |         '薄荷綠', '青瓷綠', '碧綠', '綠松石綠', '鉻綠', '蒼色',
40 |         '海綠', '中海綠', '薄荷奶油色', '春綠', '孔雀綠',
41 |         '中春綠色', '中碧藍色', '碧藍色', '青藍', '水藍',
42 |         '綠松石藍', '綠松石色', '亮海綠', '中綠松石色',
43 |         '亮青', '淺藍', '灰綠松石色', '暗岩灰', '鳧綠', '暗青',
44 |         '青色', '水色', '暗綠松石色', '軍服藍', '孔雀藍',
45 |         '嬰兒粉藍', '濃藍', '亮藍', '灰藍', '薩克斯藍',
46 |         '深天藍', '天藍', '亮天藍', '水手藍', '普魯士藍',
47 |         '鋼青色', '愛麗絲藍', '岩灰', '亮岩灰', '道奇藍',
48 |         '礦藍', '湛藍', '韋奇伍德瓷藍', '亮鋼藍', '鈷藍',
49 |         '灰丁寧藍', '矢車菊藍', '鼠尾草藍', '暗嬰兒粉藍',
50 |         '藍寶石色', '國際奇連藍', '蔚藍', '品藍', '暗礦藍',
51 |         '極濃海藍', '天青石藍', '幽靈白', '薰衣草紫',
52 |         '長春花色', '午夜藍', '藏青', '暗藍', '中藍', '藍色',
53 |         '紫藤色', '暗岩藍', '岩藍', '中岩藍', '木槿紫',
54 |         '紫丁香色', '中紫紅', '紫水晶色', '淺灰紫紅',
55 |         '纈草紫', '礦紫', '藍紫', '紫羅蘭色', '靛色', '暗蘭紫',
56 |         '暗紫', '三色堇紫', '錦葵紫', '優品紫紅', '中蘭紫',
57 |         '淡紫丁香色', '薊紫', '鐵線蓮紫', '梅紅色', '亮紫',
58 |         '紫色', '暗洋紅', '洋紅', '品紅', '蘭紫', '淺珍珠紅',
59 |         '陳玫紅', '淺玫瑰紅', '中青紫紅', '洋玫瑰紅',
60 |         '玫瑰紅', '紅寶石色', '山茶紅', '深粉紅', '火鶴紅',
61 |         '淺珊瑚紅', '暖粉紅', '勃艮第酒紅', '尖晶石紅',
62 |         '胭脂紅', '淺粉紅', '樞機紅', '薰衣草紫紅', '灰紫紅',
63 |         '櫻桃紅', '淺鮭紅', '緋紅', '粉紅', '亮粉紅', '殼黃紅',
64 |         '茜紅',
65 |     ];
66 | }
67 | 


--------------------------------------------------------------------------------
/src/JsonSchema/Ref.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types = 1);
 4 | 
 5 | namespace Poppy\Faker\JsonSchema;
 6 | 
 7 | 
 8 | use RuntimeException;
 9 | use SplFileInfo;
10 | use stdClass;
11 | 
12 | final class Ref
13 | {
14 |     /**
15 |      * @var Faker
16 |      */
17 |     private Faker $faker;
18 | 
19 |     /**
20 |      * @var string
21 |      */
22 |     private string $schemaDir;
23 | 
24 |     public function __construct(Faker $faker, $schemaDir)
25 |     {
26 |         $this->faker     = $faker;
27 |         $this->schemaDir = $schemaDir;
28 |     }
29 | 
30 |     public function __invoke(stdClass $schema, stdClass $parentSchema = null)
31 |     {
32 |         $path = (string) $schema->{'$ref'};
33 |         if ($path[0] === '#') {
34 |             $parentSchema = $parentSchema instanceof stdClass ? $parentSchema : $schema;
35 | 
36 |             return $this->inlineRef($parentSchema, $path);
37 |         }
38 | 
39 |         return $this->externalRef($path, $parentSchema);
40 |     }
41 | 
42 |     private function inlineRef(stdClass $parentSchema, string $path)
43 |     {
44 |         $paths = explode('/', substr($path, 2));
45 |         $prop  = $parentSchema;
46 |         foreach ($paths as $schemaPath) {
47 |             $prop = $prop->{$schemaPath};
48 |         }
49 | 
50 |         return $this->faker->generate($prop, null);
51 |     }
52 | 
53 |     private function externalRef(string $path, stdClass $parentSchema = null)
54 |     {
55 |         $jsonFileName = substr($path, 0, 2) === './' ? substr($path, 2) : $path;
56 |         $jsonPath     = sprintf('%s/%s', $this->schemaDir, $jsonFileName);
57 |         $realPath     = (string) realpath($jsonPath);
58 |         if (is_int(strpos($jsonPath, '#'))) {
59 |             return $this->inlineRefInExternalRef($jsonPath);
60 |         }
61 |         if (!file_exists($jsonPath)) {
62 |             throw new RuntimeException("JSON file not exits:{$jsonPath}");
63 |         }
64 |         if (!file_exists($realPath)) {
65 |             return $this->inlineRefInExternalRef($realPath);
66 |         }
67 | 
68 |         return $this->faker->generate(new SplFileInfo($realPath), $parentSchema, dirname($jsonPath));
69 |     }
70 | 
71 |     private function inlineRefInExternalRef(string $jsonPath)
72 |     {
73 |         $paths = explode('#', $jsonPath);
74 |         if (count($paths) !== 2) {
75 |             throw new RuntimeException("JSON file not exits:{$jsonPath}");
76 |         }
77 |         $schemaFile = $paths[0];
78 |         $path       = '.' . $paths[1];
79 |         if (!file_exists($schemaFile)) {
80 |             throw new RuntimeException("JSON file not exits:{$jsonPath}");
81 |         }
82 |         $json = json_decode((string) file_get_contents($schemaFile));
83 | 
84 |         return $this->inlineRef($json, $path);
85 |     }
86 | }
87 | 


--------------------------------------------------------------------------------
/src/Documentor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker;
 4 | 
 5 | class Documentor
 6 | {
 7 |     protected $generator;
 8 | 
 9 |     /**
10 |      * @param Generator $generator
11 |      */
12 |     public function __construct(Generator $generator)
13 |     {
14 |         $this->generator = $generator;
15 |     }
16 | 
17 |     /**
18 |      * @return array
19 |      */
20 |     public function getFormatters()
21 |     {
22 |         $formatters  = [];
23 |         $providers   = array_reverse($this->generator->getProviders());
24 |         $providers[] = new Provider\Base($this->generator);
25 |         foreach ($providers as $provider) {
26 |             $providerClass              = get_class($provider);
27 |             $formatters[$providerClass] = [];
28 |             $refl                       = new \ReflectionObject($provider);
29 |             foreach ($refl->getMethods(\ReflectionMethod::IS_PUBLIC) as $reflmethod) {
30 |                 if ($reflmethod->getDeclaringClass()->getName() == 'Poppy\Faker\Provider\Base' && $providerClass != 'Poppy\Faker\Provider\Base') {
31 |                     continue;
32 |                 }
33 |                 $methodName = $reflmethod->name;
34 |                 if ($reflmethod->isConstructor()) {
35 |                     continue;
36 |                 }
37 |                 $parameters = [];
38 |                 foreach ($reflmethod->getParameters() as $reflparameter) {
39 |                     $parameter = '$' . $reflparameter->getName();
40 |                     if ($reflparameter->isDefaultValueAvailable()) {
41 |                         $parameter .= ' = ' . var_export($reflparameter->getDefaultValue(), true);
42 |                     }
43 |                     $parameters [] = $parameter;
44 |                 }
45 |                 $parameters = $parameters ? '(' . join(', ', $parameters) . ')' : '';
46 |                 try {
47 |                     $example = $this->generator->format($methodName);
48 |                 } catch (\InvalidArgumentException $e) {
49 |                     $example = '';
50 |                 }
51 |                 if (is_array($example)) {
52 |                     $example = "array('" . join("', '", $example) . "')";
53 |                 }
54 |                 elseif ($example instanceof \DateTime) {
55 |                     $example = "DateTime('" . $example->format('Y-m-d H:i:s') . "')";
56 |                 }
57 |                 elseif ($example instanceof Generator || $example instanceof UniqueGenerator) { // modifier
58 |                     $example = '';
59 |                 }
60 |                 else {
61 |                     $example = var_export($example, true);
62 |                 }
63 |                 $formatters[$providerClass][$methodName . $parameters] = $example;
64 |             }
65 |         }
66 | 
67 |         return $formatters;
68 |     }
69 | }
70 | 


--------------------------------------------------------------------------------
/src/Provider/Barcode.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | use LengthException;
  6 | 
  7 | /**
  8 |  * @see http://en.wikipedia.org/wiki/EAN-13
  9 |  * @see http://en.wikipedia.org/wiki/ISBN
 10 |  */
 11 | class Barcode extends Base
 12 | {
 13 |     /**
 14 |      * Get a random EAN13 barcode.
 15 |      * @return string
 16 |      * @example '4006381333931'
 17 |      */
 18 |     public function ean13()
 19 |     {
 20 |         return $this->ean(13);
 21 |     }
 22 | 
 23 |     /**
 24 |      * Get a random EAN8 barcode.
 25 |      * @return string
 26 |      * @example '73513537'
 27 |      */
 28 |     public function ean8()
 29 |     {
 30 |         return $this->ean(8);
 31 |     }
 32 | 
 33 |     /**
 34 |      * Get a random ISBN-10 code
 35 |      * @link    http://en.wikipedia.org/wiki/International_Standard_Book_Number
 36 |      *
 37 |      * @return string
 38 |      * @example '4881416324'
 39 |      */
 40 |     public function isbn10()
 41 |     {
 42 |         $code = static::numerify(str_repeat('#', 9));
 43 | 
 44 |         return $code . static::isbnChecksum($code);
 45 |     }
 46 | 
 47 |     /**
 48 |      * Get a random ISBN-13 code
 49 |      * @link    http://en.wikipedia.org/wiki/International_Standard_Book_Number
 50 |      *
 51 |      * @return string
 52 |      * @example '9790404436093'
 53 |      */
 54 |     public function isbn13()
 55 |     {
 56 |         $code = '97' . static::numberBetween(8, 9) . static::numerify(str_repeat('#', 9));
 57 | 
 58 |         return $code . static::eanChecksum($code);
 59 |     }
 60 | 
 61 |     /**
 62 |      * Utility function for computing EAN checksums
 63 |      *
 64 |      * @param string $input
 65 |      *
 66 |      * @return integer
 67 |      */
 68 |     protected static function eanChecksum($input)
 69 |     {
 70 |         $sequence = (strlen($input) + 1) === 8 ? [3, 1] : [1, 3];
 71 |         $sums     = 0;
 72 |         foreach (str_split($input) as $n => $digit) {
 73 |             $sums += $digit * $sequence[$n % 2];
 74 |         }
 75 |         return (10 - $sums % 10) % 10;
 76 |     }
 77 | 
 78 |     /**
 79 |      * ISBN-10 check digit
 80 |      * @link http://en.wikipedia.org/wiki/International_Standard_Book_Number#ISBN-10_check_digits
 81 |      *
 82 |      * @param string $input ISBN without check-digit
 83 |      * @throws LengthException When wrong input length passed
 84 |      *
 85 |      * @return string Check digit
 86 |      */
 87 |     protected static function isbnChecksum($input): string
 88 |     {
 89 |         // We're calculating check digit for ISBN-10
 90 |         // so, the length of the input should be 9
 91 |         $length = 9;
 92 | 
 93 |         if (strlen($input) !== $length) {
 94 |             throw new LengthException(sprintf('Input length should be equal to %d', $length));
 95 |         }
 96 | 
 97 |         $digits = str_split($input);
 98 |         array_walk(
 99 |             $digits,
100 |             function (&$digit, $position) {
101 |                 $digit = (10 - $position) * $digit;
102 |             }
103 |         );
104 |         $result = (11 - array_sum($digits) % 11) % 11;
105 | 
106 |         // 10 is replaced by X
107 |         return (string) (($result < 10) ? $result : 'X');
108 |     }
109 | 
110 |     private function ean($length = 13)
111 |     {
112 |         $code = static::numerify(str_repeat('#', $length - 1));
113 | 
114 |         return $code . static::eanChecksum($code);
115 |     }
116 | }
117 | 


--------------------------------------------------------------------------------
/src/Provider/Person.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | class Person extends Base
  6 | {
  7 |     const GENDER_MALE   = 'male';
  8 |     const GENDER_FEMALE = 'female';
  9 | 
 10 |     protected static array $titleFormat = [
 11 |         '{{titleMale}}',
 12 |         '{{titleFemale}}',
 13 |     ];
 14 | 
 15 |     protected static array $firstNameFormat = [
 16 |         '{{firstNameMale}}',
 17 |         '{{firstNameFemale}}',
 18 |     ];
 19 | 
 20 |     protected static array $maleNameFormats = [
 21 |         '{{firstNameMale}} {{lastName}}',
 22 |     ];
 23 | 
 24 |     protected static array $femaleNameFormats = [
 25 |         '{{firstNameFemale}} {{lastName}}',
 26 |     ];
 27 | 
 28 |     protected static array $firstNameMale = [
 29 |         'John',
 30 |     ];
 31 | 
 32 |     protected static array $firstNameFemale = [
 33 |         'Jane',
 34 |     ];
 35 | 
 36 |     protected static array $lastName = ['Doe'];
 37 | 
 38 |     protected static array $titleMale = ['Mr.', 'Dr.', 'Prof.'];
 39 | 
 40 |     protected static array $titleFemale = ['Mrs.', 'Ms.', 'Miss', 'Dr.', 'Prof.'];
 41 | 
 42 |     /**
 43 |      * @param string|null $gender 'male', 'female' or null for any
 44 |      * @return string
 45 |      * @example 'John Doe'
 46 |      */
 47 |     public function name($gender = null)
 48 |     {
 49 |         if ($gender === static::GENDER_MALE) {
 50 |             $format = static::randomElement(static::$maleNameFormats);
 51 |         }
 52 |         elseif ($gender === static::GENDER_FEMALE) {
 53 |             $format = static::randomElement(static::$femaleNameFormats);
 54 |         }
 55 |         else {
 56 |             $format = static::randomElement(array_merge(static::$maleNameFormats, static::$femaleNameFormats));
 57 |         }
 58 | 
 59 |         return $this->generator->parse($format);
 60 |     }
 61 | 
 62 |     /**
 63 |      * @param string|null $gender 'male', 'female' or null for any
 64 |      * @return string
 65 |      * @example 'John'
 66 |      */
 67 |     public function firstName($gender = null)
 68 |     {
 69 |         if ($gender === static::GENDER_MALE) {
 70 |             return static::firstNameMale();
 71 |         }
 72 |         elseif ($gender === static::GENDER_FEMALE) {
 73 |             return static::firstNameFemale();
 74 |         }
 75 | 
 76 |         return $this->generator->parse(static::randomElement(static::$firstNameFormat));
 77 |     }
 78 | 
 79 |     public static function firstNameMale()
 80 |     {
 81 |         return static::randomElement(static::$firstNameMale);
 82 |     }
 83 | 
 84 |     public static function firstNameFemale()
 85 |     {
 86 |         return static::randomElement(static::$firstNameFemale);
 87 |     }
 88 | 
 89 |     /**
 90 |      * @return string
 91 |      * @example 'Doe'
 92 |      */
 93 |     public function lastName()
 94 |     {
 95 |         return static::randomElement(static::$lastName);
 96 |     }
 97 | 
 98 |     /**
 99 |      * @param string|null $gender 'male', 'female' or null for any
100 |      * @return string
101 |      * @example 'Mrs.'
102 |      */
103 |     public function title($gender = null)
104 |     {
105 |         if ($gender === static::GENDER_MALE) {
106 |             return static::titleMale();
107 |         }
108 |         elseif ($gender === static::GENDER_FEMALE) {
109 |             return static::titleFemale();
110 |         }
111 | 
112 |         return $this->generator->parse(static::randomElement(static::$titleFormat));
113 |     }
114 | 
115 |     /**
116 |      * @example 'Mr.'
117 |      */
118 |     public static function titleMale()
119 |     {
120 |         return static::randomElement(static::$titleMale);
121 |     }
122 | 
123 |     /**
124 |      * @example 'Mrs.'
125 |      */
126 |     public static function titleFemale()
127 |     {
128 |         return static::randomElement(static::$titleFemale);
129 |     }
130 | }
131 | 


--------------------------------------------------------------------------------
/src/Provider/en_US/PhoneNumber.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider\en_US;
  4 | 
  5 | class PhoneNumber extends \Poppy\Faker\Provider\PhoneNumber
  6 | {
  7 |     /**
  8 |      * @see https://en.wikipedia.org/wiki/National_conventions_for_writing_telephone_numbers#United_States.2C_Canada.2C_and_other_NANP_countries
  9 |      */
 10 |     protected static array $formats = [
 11 |         // International format
 12 |         '+1-{{areaCode}}-{{exchangeCode}}-####',
 13 |         '+1 ({{areaCode}}) {{exchangeCode}}-####',
 14 |         '+1-{{areaCode}}-{{exchangeCode}}-####',
 15 |         '+1.{{areaCode}}.{{exchangeCode}}.####',
 16 |         '+1{{areaCode}}{{exchangeCode}}####',
 17 | 
 18 |         // Standard formats
 19 |         '{{areaCode}}-{{exchangeCode}}-####',
 20 |         '({{areaCode}}) {{exchangeCode}}-####',
 21 |         '1-{{areaCode}}-{{exchangeCode}}-####',
 22 |         '{{areaCode}}.{{exchangeCode}}.####',
 23 | 
 24 |         '{{areaCode}}-{{exchangeCode}}-####',
 25 |         '({{areaCode}}) {{exchangeCode}}-####',
 26 |         '1-{{areaCode}}-{{exchangeCode}}-####',
 27 |         '{{areaCode}}.{{exchangeCode}}.####',
 28 | 
 29 |         // Extensions
 30 |         '{{areaCode}}-{{exchangeCode}}-#### x###',
 31 |         '({{areaCode}}) {{exchangeCode}}-#### x###',
 32 |         '1-{{areaCode}}-{{exchangeCode}}-#### x###',
 33 |         '{{areaCode}}.{{exchangeCode}}.#### x###',
 34 | 
 35 |         '{{areaCode}}-{{exchangeCode}}-#### x####',
 36 |         '({{areaCode}}) {{exchangeCode}}-#### x####',
 37 |         '1-{{areaCode}}-{{exchangeCode}}-#### x####',
 38 |         '{{areaCode}}.{{exchangeCode}}.#### x####',
 39 | 
 40 |         '{{areaCode}}-{{exchangeCode}}-#### x#####',
 41 |         '({{areaCode}}) {{exchangeCode}}-#### x#####',
 42 |         '1-{{areaCode}}-{{exchangeCode}}-#### x#####',
 43 |         '{{areaCode}}.{{exchangeCode}}.#### x#####',
 44 |     ];
 45 | 
 46 |     /**
 47 |      * @see https://en.wikipedia.org/wiki/Toll-free_telephone_number#United_States
 48 |      */
 49 |     protected static $tollFreeAreaCodes = [
 50 |         800, 844, 855, 866, 877, 888,
 51 |     ];
 52 | 
 53 |     protected static $tollFreeFormats = [
 54 |         // Standard formats
 55 |         '{{tollFreeAreaCode}}-{{exchangeCode}}-####',
 56 |         '({{tollFreeAreaCode}}) {{exchangeCode}}-####',
 57 |         '1-{{tollFreeAreaCode}}-{{exchangeCode}}-####',
 58 |         '{{tollFreeAreaCode}}.{{exchangeCode}}.####',
 59 |     ];
 60 | 
 61 |     public function tollFreeAreaCode()
 62 |     {
 63 |         return self::randomElement(static::$tollFreeAreaCodes);
 64 |     }
 65 | 
 66 |     public function tollFreePhoneNumber()
 67 |     {
 68 |         $format = self::randomElement(static::$tollFreeFormats);
 69 | 
 70 |         return self::numerify($this->generator->parse($format));
 71 |     }
 72 | 
 73 |     /**
 74 |      * NPA-format area code
 75 |      *
 76 |      * @see https://en.wikipedia.org/wiki/North_American_Numbering_Plan#Numbering_system
 77 |      *
 78 |      * @return string
 79 |      */
 80 |     public static function areaCode()
 81 |     {
 82 |         $digits[] = self::numberBetween(2, 9);
 83 |         $digits[] = self::randomDigit();
 84 |         $digits[] = self::randomDigitNot($digits[1]);
 85 | 
 86 |         return join('', $digits);
 87 |     }
 88 | 
 89 |     /**
 90 |      * NXX-format central office exchange code
 91 |      *
 92 |      * @see https://en.wikipedia.org/wiki/North_American_Numbering_Plan#Numbering_system
 93 |      *
 94 |      * @return string
 95 |      */
 96 |     public static function exchangeCode()
 97 |     {
 98 |         $digits[] = self::numberBetween(2, 9);
 99 |         $digits[] = self::randomDigit();
100 | 
101 |         if ($digits[1] === 1) {
102 |             $digits[] = self::randomDigitNot(1);
103 |         }
104 |         else {
105 |             $digits[] = self::randomDigit();
106 |         }
107 | 
108 |         return join('', $digits);
109 |     }
110 | }
111 | 


--------------------------------------------------------------------------------
/src/Provider/Address.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | class Address extends Base
  6 | {
  7 |     protected static array $citySuffix = ['Ville'];
  8 | 
  9 |     protected static array $streetSuffix = ['Street'];
 10 | 
 11 |     protected static array $cityFormats = [
 12 |         '{{firstName}}{{citySuffix}}',
 13 |     ];
 14 | 
 15 |     protected static array $streetNameFormats = [
 16 |         '{{lastName}} {{streetSuffix}}',
 17 |     ];
 18 | 
 19 |     protected static array $streetAddressFormats = [
 20 |         '{{buildingNumber}} {{streetName}}',
 21 |     ];
 22 | 
 23 |     protected static array $addressFormats = [
 24 |         '{{streetAddress}} {{postcode}} {{city}}',
 25 |     ];
 26 | 
 27 |     protected static array $buildingNumber = ['%#'];
 28 | 
 29 |     protected static array $postcode = ['#####'];
 30 | 
 31 |     protected static array $country = [];
 32 | 
 33 |     /**
 34 |      * @example 'Sashabury'
 35 |      */
 36 |     public function city()
 37 |     {
 38 |         $format = static::randomElement(static::$cityFormats);
 39 | 
 40 |         return $this->generator->parse($format);
 41 |     }
 42 | 
 43 |     /**
 44 |      * @example 'Crist Parks'
 45 |      */
 46 |     public function streetName()
 47 |     {
 48 |         $format = static::randomElement(static::$streetNameFormats);
 49 | 
 50 |         return $this->generator->parse($format);
 51 |     }
 52 | 
 53 |     /**
 54 |      * @example '791 Crist Parks'
 55 |      */
 56 |     public function streetAddress()
 57 |     {
 58 |         $format = static::randomElement(static::$streetAddressFormats);
 59 | 
 60 |         return $this->generator->parse($format);
 61 |     }
 62 | 
 63 |     /**
 64 |      * @example '791 Crist Parks, Sashabury, IL 86039-9874'
 65 |      */
 66 |     public function address()
 67 |     {
 68 |         $format = static::randomElement(static::$addressFormats);
 69 | 
 70 |         return $this->generator->parse($format);
 71 |     }
 72 | 
 73 |     /**
 74 |      * @example 'town'
 75 |      */
 76 |     public static function citySuffix()
 77 |     {
 78 |         return static::randomElement(static::$citySuffix);
 79 |     }
 80 | 
 81 |     /**
 82 |      * @example 'Avenue'
 83 |      */
 84 |     public static function streetSuffix()
 85 |     {
 86 |         return static::randomElement(static::$streetSuffix);
 87 |     }
 88 | 
 89 |     /**
 90 |      * @example '791'
 91 |      */
 92 |     public static function buildingNumber()
 93 |     {
 94 |         return static::numerify(static::randomElement(static::$buildingNumber));
 95 |     }
 96 | 
 97 |     /**
 98 |      * @example 86039-9874
 99 |      */
100 |     public static function postcode()
101 |     {
102 |         return static::toUpper(static::bothify(static::randomElement(static::$postcode)));
103 |     }
104 | 
105 |     /**
106 |      * @example 'Japan'
107 |      */
108 |     public static function country():string
109 |     {
110 |         return static::randomElement(static::$country);
111 |     }
112 | 
113 |     /**
114 |      * 经纬度范围由于采取的数据是有限的,这里需要给予限制
115 |      * @param float|int $min
116 |      * @param float|int $max
117 |      * @return float Uses signed degrees format (returns a float number between -90 and 90)
118 |      * @example '77.147489'
119 |      */
120 |     public static function latitude($min = -85.05, $max = 85.05): float
121 |     {
122 |         return static::randomFloat(6, $min, $max);
123 |     }
124 | 
125 |     /**
126 |      * @param float|int $min
127 |      * @param float|int $max
128 |      * @return float Uses signed degrees format (returns a float number between -180 and 180)
129 |      * @example '86.211205'
130 |      */
131 |     public static function longitude($min = -180, $max = 180)
132 |     {
133 |         return static::randomFloat(6, $min, $max);
134 |     }
135 | 
136 |     /**
137 |      * @return array  [latitude, longitude]
138 |      * @example array('77.147489', '86.211205')
139 |      */
140 |     public static function localCoordinates()
141 |     {
142 |         return [
143 |             'latitude'  => static::latitude(),
144 |             'longitude' => static::longitude(),
145 |         ];
146 |     }
147 | }
148 | 


--------------------------------------------------------------------------------
/src/Provider/Image.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | use InvalidArgumentException;
  6 | use RuntimeException;
  7 | 
  8 | /**
  9 |  * Depends on image generation from http://fakeimg.pl/
 10 |  */
 11 | class Image extends Base
 12 | {
 13 | 
 14 |     /**
 15 |      * Generate the URL that will return a random image
 16 |      *
 17 |      * Set randomize too false to remove the random GET parameter at the end of the url.
 18 |      * https://fakeimg.pl/
 19 |      * @param integer     $width
 20 |      * @param integer     $height
 21 |      * @param string|null $word
 22 |      * @param string      $font_color
 23 |      * @param string      $bg_color
 24 |      * @param string      $font_size
 25 |      * @return string
 26 |      * @example https://jdc.jd.com/img/500x300?color=6190e8&text=poppy&textColor=ffffff
 27 |      */
 28 |     public static function imageUrl($width = 640, $height = 480, $word = '', $font_color = 'eae0d0', $bg_color = '282828', $font_size = ''): string
 29 |     {
 30 |         $baseUrl = 'https://i.wulicode.com/img';
 31 |         $url     = "/{$width}x{$height}";
 32 | 
 33 |         $url .= '?';
 34 |         if ($font_color) {
 35 |             $url .= "textColor={$font_color}&";
 36 |         }
 37 | 
 38 |         if ($word) {
 39 |             $url .= 'text=' . urlencode($word) . '&';
 40 |         }
 41 | 
 42 |         if ($bg_color) {
 43 |             $url .= 'color=' . $bg_color . '&';
 44 |         }
 45 | 
 46 |         if ($font_size) {
 47 |             $url .= 'fs=' . $font_size . '&';
 48 |         }
 49 |         else {
 50 |             // min: 20 /max 100
 51 |             $size = (($width / 10) <= 14)
 52 |                 ? 14
 53 |                 : (($width / 10) >= 100 ? 100 : round($width / 10));
 54 |             $url  .= 'fs=' . $size . '&';
 55 |         }
 56 | 
 57 |         return $baseUrl . rtrim($url, '&?');
 58 |     }
 59 | 
 60 |     /**
 61 |      * Download a remote random image to disk and return its location
 62 |      *
 63 |      * Requires curl, or allow_url_fopen to be on in php.ini.
 64 |      *
 65 |      * @param null $dir
 66 |      * @param int  $width
 67 |      * @param int  $height
 68 |      * @param bool $fullPath
 69 |      * @return false|RuntimeException|string
 70 |      * @example '/path/to/dir/13b73edae8443990be1aa8f1a483bc27.jpg'
 71 |      */
 72 |     public static function image($dir = null, $width = 640, $height = 480, $fullPath = true)
 73 |     {
 74 |         $dir = is_null($dir) ? sys_get_temp_dir() : $dir; // GNU/Linux / OS X / Windows compatible
 75 |         // Validate directory path
 76 |         if (!is_dir($dir) || !is_writable($dir)) {
 77 |             throw new InvalidArgumentException(sprintf('Cannot write to directory "%s"', $dir));
 78 |         }
 79 | 
 80 |         // Generate a random filename. Use the server address so that a file
 81 |         // generated at the same time on a different server won't have a collision.
 82 |         $name     = md5(uniqid(empty($_SERVER['SERVER_ADDR']) ? '' : $_SERVER['SERVER_ADDR'], true));
 83 |         $filename = $name . '.jpg';
 84 |         $filepath = $dir . DIRECTORY_SEPARATOR . $filename;
 85 | 
 86 |         $url = static::imageUrl($width, $height);
 87 | 
 88 |         // save file
 89 |         if (function_exists('curl_exec')) {
 90 |             // use cURL
 91 |             $fp = fopen($filepath, 'w');
 92 |             $ch = curl_init($url);
 93 |             curl_setopt($ch, CURLOPT_FILE, $fp);
 94 |             $success = curl_exec($ch) && curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200;
 95 |             fclose($fp);
 96 |             curl_close($ch);
 97 | 
 98 |             if (!$success) {
 99 |                 unlink($filepath);
100 | 
101 |                 // could not contact the distant URL or HTTP error - fail silently.
102 |                 return false;
103 |             }
104 |         }
105 |         elseif (ini_get('allow_url_fopen')) {
106 |             // use remote fopen() via copy()
107 |             copy($url, $filepath);
108 |         }
109 |         else {
110 |             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()');
111 |         }
112 | 
113 |         return $fullPath ? $filepath : $filename;
114 |     }
115 | }
116 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/HelperTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types = 1);
  4 | 
  5 | namespace Poppy\Faker\Tests\JsonSchema;
  6 | 
  7 | use Exception;
  8 | use JsonSchema\Validator;
  9 | use Poppy\Faker\JsonSchema\Faker;
 10 | use Poppy\Faker\Provider\Internet;
 11 | 
 12 | /**
 13 |  * @SuppressWarnings(PHPMD.TooManyPublicMethods)
 14 |  */
 15 | class HelperTest extends TestCase
 16 | {
 17 |     public function testGetMaximumMustReturnMaximumMinusOneIfExclusiveMaximumTrue()
 18 |     {
 19 |         $maximum = 300;
 20 |         $schema  = (object) ['exclusiveMaximum' => true, 'maximum' => $maximum];
 21 | 
 22 |         $actual = (new Faker)->getMaximum($schema);
 23 | 
 24 |         // -1 mean exclusive
 25 |         $this->assertSame($actual, $maximum - 1);
 26 |     }
 27 | 
 28 |     public function testGetMaximumMustReturnMaximumIfExclusiveMaximumFalse()
 29 |     {
 30 |         $maximum = 300;
 31 |         $schema  = (object) ['exclusiveMaximum' => false, 'maximum' => $maximum];
 32 | 
 33 |         $actual = (new Faker)->getMaximum($schema);
 34 | 
 35 |         $this->assertSame($actual, $maximum);
 36 |     }
 37 | 
 38 |     public function testGetMaximumMustReturnMaximumIfExclusiveMaximumAbsent()
 39 |     {
 40 |         $maximum = 300;
 41 |         $schema  = (object) ['maximum' => $maximum];
 42 | 
 43 |         $actual = (new Faker)->getMaximum($schema);
 44 | 
 45 |         $this->assertSame($actual, $maximum);
 46 |     }
 47 | 
 48 |     public function testGetMinimumMustReturnMinimumMinusOneIfExclusiveMinimumTrue()
 49 |     {
 50 |         $minimum = 300;
 51 |         $schema  = (object) ['exclusiveMinimum' => true, 'minimum' => $minimum];
 52 | 
 53 |         $actual = (new Faker)->getMinimum($schema);
 54 | 
 55 |         // +1 mean exclusive
 56 |         $this->assertSame($actual, $minimum + 1);
 57 |     }
 58 | 
 59 |     public function testGetMinimumMustReturnMinimumIfExclusiveMinimumFalse()
 60 |     {
 61 |         $minimum = 300;
 62 |         $schema  = (object) ['exclusiveMinimum' => false, 'minimum' => $minimum];
 63 | 
 64 |         $actual = (new Faker)->getMinimum($schema);
 65 | 
 66 |         $this->assertSame($actual, $minimum);
 67 |     }
 68 | 
 69 |     public function testGetMinimumMustReturnMinimumIfExclusiveMinimumAbsent()
 70 |     {
 71 |         $minimum = 300;
 72 |         $schema  = (object) ['minimum' => $minimum];
 73 | 
 74 |         $actual = (new Faker)->getMinimum($schema);
 75 | 
 76 |         $this->assertSame($actual, $minimum);
 77 |     }
 78 | 
 79 |     public function testGetMultipleOfMustReturnValueIfPresent()
 80 |     {
 81 |         $expected = 7;
 82 |         $schema   = (object) ['multipleOf' => $expected];
 83 | 
 84 |         $actual = (new Faker)->getMultipleOf($schema);
 85 | 
 86 |         $this->assertSame($actual, $expected);
 87 |     }
 88 | 
 89 |     public function testGetMultipleOfMustReturnOneIfAbsent()
 90 |     {
 91 |         $expected = 1;
 92 |         $schema   = (object) [];
 93 | 
 94 |         $actual = (new Faker)->getMultipleOf($schema);
 95 | 
 96 |         $this->assertSame($actual, $expected);
 97 |     }
 98 | 
 99 |     public function testGetInternetFakerInstanceMustReturnInstance()
100 |     {
101 |         $actual = (new Faker)->getInternetFakerInstance();
102 | 
103 |         $this->assertTrue($actual instanceof Internet);
104 |     }
105 | 
106 |     /**
107 |      * @dataProvider getFormats
108 |      */
109 |     public function testGetFormattedValueMustReturnValidValue($format)
110 |     {
111 |         $schema    = (object) ['type' => 'string', 'format' => $format];
112 |         $validator = new Validator();
113 | 
114 |         $actual = (new Faker)->getFormattedValue($schema);
115 |         $validator->validate($actual, $schema);
116 | 
117 |         $this->assertTrue($validator->isValid());
118 |     }
119 | 
120 |     public function testGetFormattedValueMustThrowExceptionIfInvalidFormat()
121 |     {
122 |         $this->expectException(Exception::class);
123 | 
124 |         (new Faker)->getFormattedValue((object) ['format' => 'xxxxx']);
125 |     }
126 | 
127 |     /**
128 |      * @see testGetFormattedValueMustReturnValidValue
129 |      * @SuppressWarnings(PHPMD.UnusedPrivateMethod)
130 |      */
131 |     public function getFormats(): array
132 |     {
133 |         return [
134 |             ['date-time'],
135 |             ['email'],
136 |             ['hostname'],
137 |             ['ipv4'],
138 |             ['ipv6'],
139 |             ['uri'],
140 |         ];
141 |     }
142 | }
143 | 


--------------------------------------------------------------------------------
/src/Provider/Color.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | /**
  6 |  * @author lsv
  7 |  */
  8 | class Color extends Base
  9 | {
 10 |     protected static array $safeColorNames = [
 11 |         'black', 'maroon', 'green', 'navy', 'olive',
 12 |         'purple', 'teal', 'lime', 'blue', 'silver',
 13 |         'gray', 'yellow', 'fuchsia', 'aqua', 'white',
 14 |     ];
 15 | 
 16 |     protected static array $allColorNames = [
 17 |         'AliceBlue', 'AntiqueWhite', 'Aqua', 'Aquamarine',
 18 |         'Azure', 'Beige', 'Bisque', 'Black', 'BlanchedAlmond',
 19 |         'Blue', 'BlueViolet', 'Brown', 'BurlyWood', 'CadetBlue',
 20 |         'Chartreuse', 'Chocolate', 'Coral', 'CornflowerBlue',
 21 |         'Cornsilk', 'Crimson', 'Cyan', 'DarkBlue', 'DarkCyan',
 22 |         'DarkGoldenRod', 'DarkGray', 'DarkGreen', 'DarkKhaki',
 23 |         'DarkMagenta', 'DarkOliveGreen', 'Darkorange', 'DarkOrchid',
 24 |         'DarkRed', 'DarkSalmon', 'DarkSeaGreen', 'DarkSlateBlue',
 25 |         'DarkSlateGray', 'DarkTurquoise', 'DarkViolet', 'DeepPink',
 26 |         'DeepSkyBlue', 'DimGray', 'DimGrey', 'DodgerBlue', 'FireBrick',
 27 |         'FloralWhite', 'ForestGreen', 'Fuchsia', 'Gainsboro', 'GhostWhite',
 28 |         'Gold', 'GoldenRod', 'Gray', 'Green', 'GreenYellow', 'HoneyDew',
 29 |         'HotPink', 'IndianRed', 'Indigo', 'Ivory', 'Khaki', 'Lavender',
 30 |         'LavenderBlush', 'LawnGreen', 'LemonChiffon', 'LightBlue', 'LightCoral',
 31 |         'LightCyan', 'LightGoldenRodYellow', 'LightGray', 'LightGreen', 'LightPink',
 32 |         'LightSalmon', 'LightSeaGreen', 'LightSkyBlue', 'LightSlateGray', 'LightSteelBlue',
 33 |         'LightYellow', 'Lime', 'LimeGreen', 'Linen', 'Magenta', 'Maroon', 'MediumAquaMarine',
 34 |         'MediumBlue', 'MediumOrchid', 'MediumPurple', 'MediumSeaGreen', 'MediumSlateBlue',
 35 |         'MediumSpringGreen', 'MediumTurquoise', 'MediumVioletRed', 'MidnightBlue',
 36 |         'MintCream', 'MistyRose', 'Moccasin', 'NavajoWhite', 'Navy', 'OldLace', 'Olive',
 37 |         'OliveDrab', 'Orange', 'OrangeRed', 'Orchid', 'PaleGoldenRod', 'PaleGreen',
 38 |         'PaleTurquoise', 'PaleVioletRed', 'PapayaWhip', 'PeachPuff', 'Peru', 'Pink', 'Plum',
 39 |         'PowderBlue', 'Purple', 'Red', 'RosyBrown', 'RoyalBlue', 'SaddleBrown', 'Salmon',
 40 |         'SandyBrown', 'SeaGreen', 'SeaShell', 'Sienna', 'Silver', 'SkyBlue', 'SlateBlue',
 41 |         'SlateGray', 'Snow', 'SpringGreen', 'SteelBlue', 'Tan', 'Teal', 'Thistle', 'Tomato',
 42 |         'Turquoise', 'Violet', 'Wheat', 'White', 'WhiteSmoke', 'Yellow', 'YellowGreen',
 43 |     ];
 44 | 
 45 |     /**
 46 |      * @example '#fa3cc2'
 47 |      */
 48 |     public static function hexColor()
 49 |     {
 50 |         return '#' . str_pad(dechex(mt_rand(1, 16777215)), 6, '0', STR_PAD_LEFT);
 51 |     }
 52 | 
 53 |     /**
 54 |      * @example '#ff0044'
 55 |      */
 56 |     public static function safeHexColor()
 57 |     {
 58 |         $color = str_pad(dechex(mt_rand(0, 255)), 3, '0', STR_PAD_LEFT);
 59 | 
 60 |         return '#' . $color[0] . $color[0] . $color[1] . $color[1] . $color[2] . $color[2];
 61 |     }
 62 | 
 63 |     /**
 64 |      * @example 'array(0,255,122)'
 65 |      */
 66 |     public static function rgbColorAsArray()
 67 |     {
 68 |         $color = static::hexColor();
 69 | 
 70 |         return [
 71 |             hexdec(substr($color, 1, 2)),
 72 |             hexdec(substr($color, 3, 2)),
 73 |             hexdec(substr($color, 5, 2)),
 74 |         ];
 75 |     }
 76 | 
 77 |     /**
 78 |      * @example '0,255,122'
 79 |      */
 80 |     public static function rgbColor()
 81 |     {
 82 |         return implode(',', static::rgbColorAsArray());
 83 |     }
 84 | 
 85 |     /**
 86 |      * @example 'rgb(0,255,122)'
 87 |      */
 88 |     public static function rgbCssColor()
 89 |     {
 90 |         return 'rgb(' . static::rgbColor() . ')';
 91 |     }
 92 | 
 93 |     /**
 94 |      * @example 'rgba(0,255,122,0.8)'
 95 |      */
 96 |     public static function rgbaCssColor()
 97 |     {
 98 |         return 'rgba(' . static::rgbColor() . ',' . static::randomFloat(1, 0, 1) . ')';
 99 |     }
100 | 
101 |     /**
102 |      * @example 'blue'
103 |      */
104 |     public static function safeColorName()
105 |     {
106 |         return static::randomElement(static::$safeColorNames);
107 |     }
108 | 
109 |     /**
110 |      * @example 'NavajoWhite'
111 |      */
112 |     public static function colorName()
113 |     {
114 |         return static::randomElement(static::$allColorNames);
115 |     }
116 | 
117 |     /**
118 |      * @return string
119 |      * @example '340,50,20'
120 |      */
121 |     public static function hslColor()
122 |     {
123 |         return sprintf(
124 |             '%s,%s,%s',
125 |             static::numberBetween(0, 360),
126 |             static::numberBetween(0, 100),
127 |             static::numberBetween(0, 100)
128 |         );
129 |     }
130 | 
131 |     /**
132 |      * @return array
133 |      * @example array(340, 50, 20)
134 |      */
135 |     public static function hslColorAsArray()
136 |     {
137 |         return [
138 |             static::numberBetween(0, 360),
139 |             static::numberBetween(0, 100),
140 |             static::numberBetween(0, 100),
141 |         ];
142 |     }
143 | }
144 | 


--------------------------------------------------------------------------------
/src/Provider/zh_CN/Address.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider\zh_CN;
  4 | 
  5 | class Address extends \Poppy\Faker\Provider\Address
  6 | {
  7 | 
  8 |     protected static $cites = [
  9 |         '北京', '上海', '天津', '重庆',
 10 |         '哈尔滨', '长春', '沈阳', '呼和浩特',
 11 |         '石家庄', '乌鲁木齐', '兰州', '西宁',
 12 |         '西安', '银川', '郑州', '济南',
 13 |         '太原', '合肥', '武汉', '长沙',
 14 |         '南京', '成都', '贵阳', '昆明',
 15 |         '南宁', '拉萨', '杭州', '南昌',
 16 |         '广州', '福州', '海口',
 17 |         '香港', '澳门',
 18 |     ];
 19 | 
 20 |     protected static $states = [
 21 |         '北京市', '天津市', '河北省', '山西省',
 22 |         '内蒙古自治区', '辽宁省', '吉林省',
 23 |         '黑龙江省', '上海市', '江苏省',
 24 |         '浙江省', '安徽省', '福建省', '江西省',
 25 |         '山东省', '河南省', '湖北省', '湖南省',
 26 |         '广东省', '广西壮族自治区', '海南省',
 27 |         '重庆市', '四川省', '贵州省', '云南省',
 28 |         '西藏自治区', '陕西省', '甘肃省', '青海省',
 29 |         '宁夏回族自治区', '新疆维吾尔自治区',
 30 |         '香港特别行政区', '澳门特别行政区', '台湾省',
 31 |     ];
 32 | 
 33 |     protected static $stateAbbr = [
 34 |         '京', '皖', '渝', '闽',
 35 |         '甘', '粤', '桂', '黔',
 36 |         '琼', '冀', '豫', '黑',
 37 |         '鄂', '湘', '吉', '苏',
 38 |         '赣', '辽', '蒙', '宁',
 39 |         '青', '鲁', '晋', '陕',
 40 |         '沪', '川', '津', '藏',
 41 |         '新', '滇', '浙', '港',
 42 |         '澳', '台',
 43 |     ];
 44 | 
 45 |     protected static $areas = [
 46 |         '西夏区', '永川区', '秀英区', '高港区',
 47 |         '清城区', '兴山区', '锡山区', '清河区',
 48 |         '龙潭区', '华龙区', '海陵区', '滨城区',
 49 |         '东丽区', '高坪区', '沙湾区', '平山区',
 50 |         '城北区', '海港区', '沙市区', '双滦区',
 51 |         '长寿区', '山亭区', '南湖区', '浔阳区',
 52 |         '南长区', '友好区', '安次区', '翔安区',
 53 |         '沈河区', '魏都区', '西峰区', '萧山区',
 54 |         '金平区', '沈北新区', '孝南区', '上街区',
 55 |         '城东区', '牧野区', '大东区', '白云区',
 56 |         '花溪区', '吉利区', '新城区', '怀柔区',
 57 |         '六枝特区', '涪城区', '清浦区', '南溪区',
 58 |         '淄川区', '高明区', '金水区', '中原区',
 59 |         '高新开发区', '经济开发新区', '新区',
 60 |     ];
 61 | 
 62 |     protected static array $country = [
 63 |         '阿富汗', '阿拉斯加', '阿尔巴尼亚', '阿尔及利亚',
 64 |         '安道尔', '安哥拉', '安圭拉岛英', '安提瓜和巴布达',
 65 |         '阿根廷', '亚美尼亚', '阿鲁巴岛', '阿森松', '澳大利亚',
 66 |         '奥地利', '阿塞拜疆', '巴林', '孟加拉国', '巴巴多斯',
 67 |         '白俄罗斯', '比利时', '伯利兹', '贝宁', '百慕大群岛',
 68 |         '不丹', '玻利维亚', '波斯尼亚和黑塞哥维那', '博茨瓦纳',
 69 |         '巴西', '保加利亚', '布基纳法索', '布隆迪', '喀麦隆',
 70 |         '加拿大', '加那利群岛', '佛得角', '开曼群岛', '中非',
 71 |         '乍得', '智利', '圣诞岛', '科科斯岛', '哥伦比亚',
 72 |         '巴哈马国', '多米尼克国', '科摩罗', '刚果', '科克群岛',
 73 |         '哥斯达黎加', '克罗地亚', '古巴', '塞浦路斯', '捷克',
 74 |         '丹麦', '迪戈加西亚岛', '吉布提', '多米尼加共和国',
 75 |         '厄瓜多尔', '埃及', '萨尔瓦多', '赤道几内亚',
 76 |         '厄立特里亚', '爱沙尼亚', '埃塞俄比亚', '福克兰群岛',
 77 |         '法罗群岛', '斐济', '芬兰', '法国', '法属圭亚那',
 78 |         '法属波里尼西亚', '加蓬', '冈比亚', '格鲁吉亚', '德国',
 79 |         '加纳', '直布罗陀', '希腊', '格陵兰岛', '格林纳达',
 80 |         '瓜德罗普岛', '关岛', '危地马拉', '几内亚', '几内亚比绍',
 81 |         '圭亚那', '海地', '夏威夷', '洪都拉斯', '匈牙利', '冰岛',
 82 |         '印度', '印度尼西亚', '伊郎', '伊拉克', '爱尔兰', '以色列',
 83 |         '意大利', '科特迪瓦', '牙买加', '日本', '约旦', '柬埔塞',
 84 |         '哈萨克斯坦', '肯尼亚', '基里巴斯', '朝鲜', '韩国', '科威特',
 85 |         '吉尔吉斯斯坦', '老挝', '拉脱维亚', '黎巴嫩', '莱索托',
 86 |         '利比里亚', '利比亚', '列支敦士登', '立陶宛', '卢森堡',
 87 |         '马其顿', '马达加斯加', '马拉维', '马来西亚', '马尔代夫',
 88 |         '马里', '马耳他', '马里亚纳群岛', '马绍尔群岛', '马提尼克',
 89 |         '毛里塔尼亚', '毛里求斯', '马约特岛', '墨西哥', '密克罗尼西亚',
 90 |         '中途岛', '摩尔多瓦', '摩纳哥', '蒙古', '蒙特塞拉特岛',
 91 |         '摩洛哥', '莫桑比克', '缅甸', '纳米比亚', '瑙鲁', '尼泊尔',
 92 |         '荷兰', '荷属安的列斯群岛', '新喀里多尼亚群岛', '新西兰',
 93 |         '尼加拉瓜', '尼日尔', '尼日利亚', '纽埃岛', '诺福克岛',
 94 |         '挪威', '阿曼', '帕劳', '巴拿马', '巴布亚新几内亚', '巴拉圭',
 95 |         '秘鲁', '菲律宾', '波兰', '葡萄牙', '巴基斯坦', '波多黎各',
 96 |         '卡塔尔', '留尼汪岛', '罗马尼亚', '俄罗斯', '卢旺达',
 97 |         '东萨摩亚', '西萨摩亚', '圣马力诺', '圣皮埃尔岛及密克隆岛',
 98 |         '圣多美和普林西比', '沙特阿拉伯', '塞内加尔', '塞舌尔',
 99 |         '新加坡', '斯洛伐克', '斯洛文尼亚', '所罗门群岛', '索马里',
100 |         '南非', '西班牙', '斯里兰卡', '圣克里斯托弗和尼维斯',
101 |         '圣赫勒拿', '圣卢西亚', '圣文森特岛', '苏丹', '苏里南',
102 |         '斯威士兰', '瑞典', '瑞士', '叙利亚', '塔吉克斯坦', '坦桑尼亚',
103 |         '泰国', '阿拉伯联合酋长国', '多哥', '托克劳群岛', '汤加',
104 |         '特立尼达和多巴哥', '突尼斯', '土耳其', '土库曼斯坦',
105 |         '特克斯和凯科斯群岛(', '图瓦卢', '美国', '乌干达', '乌克兰',
106 |         '英国', '乌拉圭', '乌兹别克斯坦', '瓦努阿图', '梵蒂冈',
107 |         '委内瑞拉', '越南', '维尔京群岛', '维尔京群岛和圣罗克伊',
108 |         '威克岛', '瓦里斯和富士那群岛', '西撒哈拉', '也门', '南斯拉夫',
109 |         '扎伊尔', '赞比亚', '桑给巴尔', '津巴布韦', '中华人民共和国', '中国',
110 |     ];
111 | 
112 |     public function city()
113 |     {
114 |         return static::randomElement(static::$cites);
115 |     }
116 | 
117 |     public function state()
118 |     {
119 |         return static::randomElement(static::$states);
120 |     }
121 | 
122 |     public function stateAbbr()
123 |     {
124 |         return static::randomElement(static::$stateAbbr);
125 |     }
126 | 
127 |     public static function area()
128 |     {
129 |         return static::randomElement(static::$areas);
130 |     }
131 | 
132 |     public static function country(): string
133 |     {
134 |         return static::randomElement(static::$country);
135 |     }
136 | 
137 |     public function address()
138 |     {
139 |         return $this->city() . static::area();
140 |     }
141 | 
142 |     public static function postcode()
143 |     {
144 |         $prefix = str_pad(mt_rand(1, 85), 2, 0, STR_PAD_LEFT);
145 |         $suffix = '00';
146 | 
147 |         return $prefix . mt_rand(10, 88) . $suffix;
148 |     }
149 | }
150 | 


--------------------------------------------------------------------------------
/src/Provider/Text.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | use InvalidArgumentException;
  6 | 
  7 | abstract class Text extends Base
  8 | {
  9 |     protected static string $baseText = '';
 10 | 
 11 |     protected static string $separator = ' ';
 12 | 
 13 |     protected static int $separatorLen = 1;
 14 | 
 15 |     protected static bool $textStartsWithUppercase = true;
 16 | 
 17 |     protected $explodedText;
 18 | 
 19 |     protected array $consecutiveWords = [];
 20 | 
 21 |     /**
 22 |      * Generate a text string by the Markov chain algorithm.
 23 |      *
 24 |      * Depending on the $maxNbChars, returns a random valid looking text. The algorithm
 25 |      * generates a weighted table with the specified number of words as the index and the
 26 |      * possible following words as the value.
 27 |      *
 28 |      * @param integer $maxNbChars  Maximum number of characters the text should contain (minimum: 10)
 29 |      * @param integer $indexSize   Determines how many words are considered for the generation of the next word.
 30 |      *                             The minimum is 1, and it produces a higher level of randomness, although the
 31 |      *                             generated text usually doesn't make sense. Higher index sizes (up to 5)
 32 |      *                             produce more correct text, at the price of less randomness.
 33 |      * @return string
 34 |      * @example 'Alice, swallowing down her flamingo, and began by taking the little golden key'
 35 |      */
 36 |     public function realText(int $maxNbChars = 200, int $indexSize = 2)
 37 |     {
 38 |         if ($maxNbChars < 10) {
 39 |             throw new InvalidArgumentException('maxNbChars must be at least 10');
 40 |         }
 41 | 
 42 |         if ($indexSize < 1) {
 43 |             throw new InvalidArgumentException('indexSize must be at least 1');
 44 |         }
 45 | 
 46 |         if ($indexSize > 5) {
 47 |             throw new InvalidArgumentException('indexSize must be at most 5');
 48 |         }
 49 | 
 50 |         $words        = $this->getConsecutiveWords($indexSize);
 51 |         $result       = [];
 52 |         $resultLength = 0;
 53 |         // take a random starting point
 54 |         $next = static::randomKey($words);
 55 |         while ($resultLength < $maxNbChars && isset($words[$next])) {
 56 |             // fetch a random word to append
 57 |             $word = static::randomElement($words[$next]);
 58 | 
 59 |             // calculate next index
 60 |             $currentWords   = static::explode($next);
 61 |             $currentWords[] = $word;
 62 |             array_shift($currentWords);
 63 |             $next = static::implode($currentWords);
 64 | 
 65 |             // ensure text starts with an uppercase letter
 66 |             if ($resultLength == 0 && !static::validStart($word)) {
 67 |                 continue;
 68 |             }
 69 | 
 70 |             // append the element
 71 |             $result[]     = $word;
 72 |             $resultLength += static::strlen($word) + static::$separatorLen;
 73 |         }
 74 | 
 75 |         // remove the element that caused the text to overflow
 76 |         array_pop($result);
 77 | 
 78 |         // build result
 79 |         $result = static::implode($result);
 80 | 
 81 |         return static::appendEnd($result);
 82 |     }
 83 | 
 84 |     protected function getConsecutiveWords($indexSize)
 85 |     {
 86 |         if (!isset($this->consecutiveWords[$indexSize])) {
 87 |             $parts = $this->getExplodedText();
 88 |             $words = [];
 89 |             $index = [];
 90 |             for ($i = 0; $i < $indexSize; $i++) {
 91 |                 $index[] = array_shift($parts);
 92 |             }
 93 | 
 94 |             for ($i = 0, $count = count($parts); $i < $count; $i++) {
 95 |                 $stringIndex = static::implode($index);
 96 |                 if (!isset($words[$stringIndex])) {
 97 |                     $words[$stringIndex] = [];
 98 |                 }
 99 |                 $word                  = $parts[$i];
100 |                 $words[$stringIndex][] = $word;
101 |                 array_shift($index);
102 |                 $index[] = $word;
103 |             }
104 |             // cache look up words for performance
105 |             $this->consecutiveWords[$indexSize] = $words;
106 |         }
107 | 
108 |         return $this->consecutiveWords[$indexSize];
109 |     }
110 | 
111 |     protected function getExplodedText()
112 |     {
113 |         if ($this->explodedText === null) {
114 |             $this->explodedText = static::explode(preg_replace('/\s+/u', ' ', static::$baseText));
115 |         }
116 | 
117 |         return $this->explodedText;
118 |     }
119 | 
120 |     protected static function explode($text)
121 |     {
122 |         return explode(static::$separator, $text);
123 |     }
124 | 
125 |     protected static function implode($words)
126 |     {
127 |         return implode(static::$separator, $words);
128 |     }
129 | 
130 |     protected static function strlen($text)
131 |     {
132 |         return function_exists('mb_strlen') ? mb_strlen($text, 'UTF-8') : strlen($text);
133 |     }
134 | 
135 |     protected static function validStart($word)
136 |     {
137 |         $isValid = true;
138 |         if (static::$textStartsWithUppercase) {
139 |             $isValid = preg_match('/^\p{Lu}/u', $word);
140 |         }
141 |         return $isValid;
142 |     }
143 | 
144 |     protected static function appendEnd($text)
145 |     {
146 |         return preg_replace("/([ ,-:;\x{2013}\x{2014}]+$)/us", '', $text) . '.';
147 |     }
148 | }
149 | 


--------------------------------------------------------------------------------
/tests/JsonSchema/fixture/object.json:
--------------------------------------------------------------------------------
  1 | {
  2 |     "type": "object",
  3 |     "required": [
  4 |         "typeOnly",
  5 |         "typeAndAdditionalPropertiesFalse",
  6 |         "typeAndAdditionalPropertiesTrue",
  7 |         "typeAndPatternPropertiesAndAdditionalPropertiesFalse",
  8 |         "typeAndPatternPropertiesAndAdditionalPropertiesTrue",
  9 |         "typeAndPropertiesAndPatternPropertiesAndAdditionalPropertiesObject",
 10 |         "typeAndPropertiesAndPatternPropertiesAndAdditionalPropertiesObjectAndMinProperties",
 11 |         "typeAndPropertiesAndPatternPropertiesAndAdditionalPropertiesObjectAndMinPropertiesAndRequied",
 12 |         "deepNested"
 13 |     ],
 14 |     "properties": {
 15 |         "typeOnly": {
 16 |             "type": "object"
 17 |         },
 18 |         "typeAndMinProperties": {
 19 |             "type": "object",
 20 |             "minProperties": 5
 21 |         },
 22 |         "typeAndMaxProperties": {
 23 |             "type": "object",
 24 |             "maxProperties": 5
 25 |         },
 26 |         "typeAndMinPropertiesAndMaxProperties": {
 27 |             "type": "object",
 28 |             "minProperties": 2,
 29 |             "maxProperties": 10
 30 |         },
 31 |         "typeAndAdditionalPropertiesFalse": {
 32 |             "type": "object",
 33 |             "additionalProperties": false
 34 |         },
 35 |         "typeAndAdditionalPropertiesTrue": {
 36 |             "type": "object",
 37 |             "additionalProperties": true
 38 |         },
 39 |         "typeAndPatternPropertiesAndAdditionalPropertiesFalse": {
 40 |             "type": "object",
 41 |             "patternProperties": {
 42 |                 "^S_[a-z]{0,20}": {
 43 |                     "type": "string"
 44 |                 },
 45 |                 "^I_[A-Z]{3}[0-9]{4,8}": {
 46 |                     "type": "integer"
 47 |                 }
 48 |             },
 49 |             "additionalProperties": false
 50 |         },
 51 |         "typeAndPatternPropertiesAndAdditionalPropertiesTrue": {
 52 |             "type": "object",
 53 |             "patternProperties": {
 54 |                 "^S_[a-z]{0,20}": {
 55 |                     "type": "string"
 56 |                 },
 57 |                 "^I_[A-Z]{3}[0-9]{4,8}": {
 58 |                     "type": "integer"
 59 |                 }
 60 |             },
 61 |             "additionalProperties": true
 62 |         },
 63 |         "typeAndPropertiesAndPatternPropertiesAndAdditionalPropertiesObject": {
 64 |             "type": "object",
 65 |             "properties": {
 66 |                 "builtin": {
 67 |                     "type": "number"
 68 |                 }
 69 |             },
 70 |             "patternProperties": {
 71 |                 "^S_[a-z]{0,20}": {
 72 |                     "type": "string"
 73 |                 },
 74 |                 "^I_[A-Z]{3}[0-9]{4,8}": {
 75 |                     "type": "integer"
 76 |                 }
 77 |             },
 78 |             "additionalProperties": {
 79 |                 "type": "string"
 80 |             }
 81 |         },
 82 |         "typeAndPropertiesAndPatternPropertiesAndAdditionalPropertiesObjectAndMinProperties": {
 83 |             "type": "object",
 84 |             "minProperties": 3,
 85 |             "properties": {
 86 |                 "builtin": {
 87 |                     "type": "number"
 88 |                 }
 89 |             },
 90 |             "patternProperties": {
 91 |                 "^S_[a-z]{0,20}": {
 92 |                     "type": "string"
 93 |                 },
 94 |                 "^I_[A-Z]{3}[0-9]{4,8}": {
 95 |                     "type": "integer"
 96 |                 }
 97 |             },
 98 |             "additionalProperties": {
 99 |                 "type": "string"
100 |             }
101 |         },
102 |         "typeAndPropertiesAndPatternPropertiesAndAdditionalPropertiesObjectAndMinPropertiesAndRequied": {
103 |             "type": "object",
104 |             "minProperties": 3,
105 |             "required": [
106 |                 "builtin"
107 |             ],
108 |             "properties": {
109 |                 "builtin": {
110 |                     "type": "number"
111 |                 }
112 |             },
113 |             "patternProperties": {
114 |                 "^S_[a-z]{0,20}": {
115 |                     "type": "string"
116 |                 },
117 |                 "^I_[A-Z]{3}[0-9]{4,8}": {
118 |                     "type": "integer"
119 |                 }
120 |             },
121 |             "additionalProperties": {
122 |                 "type": "string"
123 |             }
124 |         },
125 |         "deepNested": {
126 |             "type": "object",
127 |             "required": [
128 |                 "first"
129 |             ],
130 |             "properties": {
131 |                 "first": {
132 |                     "type": "object",
133 |                     "required": [
134 |                         "second"
135 |                     ],
136 |                     "properties": {
137 |                         "second": {
138 |                             "type": "object",
139 |                             "required": [
140 |                                 "third"
141 |                             ],
142 |                             "properties": {
143 |                                 "third": {
144 |                                     "type": "object"
145 |                                 }
146 |                             }
147 |                         }
148 |                     }
149 |                 }
150 |             }
151 |         }
152 |     }
153 | }
154 | 


--------------------------------------------------------------------------------
/src/Guesser/Name.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Guesser;
  4 | 
  5 | use Poppy\Faker\Generator;
  6 | use Poppy\Faker\Provider\Base;
  7 | 
  8 | class Name
  9 | {
 10 |     protected $generator;
 11 | 
 12 |     /**
 13 |      * @param Generator $generator
 14 |      */
 15 |     public function __construct(Generator $generator)
 16 |     {
 17 |         $this->generator = $generator;
 18 |     }
 19 | 
 20 |     /**
 21 |      * @param string   $name
 22 |      * @param int|null $size Length of field, if known
 23 |      * @return callable
 24 |      */
 25 |     public function guessFormat($name, $size = null)
 26 |     {
 27 |         $name      = Base::toLower($name);
 28 |         $generator = $this->generator;
 29 |         if (preg_match('/^is[_A-Z]/', $name)) {
 30 |             return function () use ($generator) {
 31 |                 return $generator->boolean;
 32 |             };
 33 |         }
 34 |         if (preg_match('/(_a|A)t$/', $name)) {
 35 |             return function () use ($generator) {
 36 |                 return $generator->dateTime;
 37 |             };
 38 |         }
 39 |         switch (str_replace('_', '', $name)) {
 40 |             case 'firstname':
 41 |                 return function () use ($generator) {
 42 |                     return $generator->firstName;
 43 |                 };
 44 |             case 'lastname':
 45 |                 return function () use ($generator) {
 46 |                     return $generator->lastName;
 47 |                 };
 48 |             case 'username':
 49 |             case 'login':
 50 |                 return function () use ($generator) {
 51 |                     return $generator->userName;
 52 |                 };
 53 |             case 'email':
 54 |             case 'emailaddress':
 55 |                 return function () use ($generator) {
 56 |                     return $generator->email;
 57 |                 };
 58 |             case 'phonenumber':
 59 |             case 'phone':
 60 |             case 'telephone':
 61 |             case 'telnumber':
 62 |                 return function () use ($generator) {
 63 |                     return $generator->phoneNumber;
 64 |                 };
 65 |             case 'address':
 66 |                 return function () use ($generator) {
 67 |                     return $generator->address;
 68 |                 };
 69 |             case 'city':
 70 |             case 'town':
 71 |                 return function () use ($generator) {
 72 |                     return $generator->city;
 73 |                 };
 74 |             case 'streetaddress':
 75 |                 return function () use ($generator) {
 76 |                     return $generator->streetAddress;
 77 |                 };
 78 |             case 'postcode':
 79 |             case 'zipcode':
 80 |                 return function () use ($generator) {
 81 |                     return $generator->postcode;
 82 |                 };
 83 |             case 'state':
 84 |                 return function () use ($generator) {
 85 |                     return $generator->state;
 86 |                 };
 87 |             case 'county':
 88 |                 if ($this->generator->locale == 'en_US') {
 89 |                     return function () use ($generator) {
 90 |                         return sprintf('%s County', $generator->city);
 91 |                     };
 92 |                 }
 93 | 
 94 |                 return function () use ($generator) {
 95 |                     return $generator->state;
 96 |                 };
 97 |             case 'country':
 98 |                 switch ($size) {
 99 |                     case 2:
100 |                         return function () use ($generator) {
101 |                             return $generator->countryCode;
102 |                         };
103 |                     case 3:
104 |                         return function () use ($generator) {
105 |                             return $generator->countryISOAlpha3;
106 |                         };
107 |                     case 5:
108 |                     case 6:
109 |                         return function () use ($generator) {
110 |                             return $generator->locale;
111 |                         };
112 |                     default:
113 |                         return function () use ($generator) {
114 |                             return $generator->country;
115 |                         };
116 |                 }
117 |             case 'locale':
118 |                 return function () use ($generator) {
119 |                     return $generator->locale;
120 |                 };
121 |             case 'currency':
122 |             case 'currencycode':
123 |                 return function () use ($generator) {
124 |                     return $generator->currencyCode;
125 |                 };
126 |             case 'url':
127 |             case 'website':
128 |                 return function () use ($generator) {
129 |                     return $generator->url;
130 |                 };
131 |             case 'company':
132 |             case 'companyname':
133 |             case 'employer':
134 |                 return function () use ($generator) {
135 |                     return $generator->company;
136 |                 };
137 |             case 'title':
138 |                 if ($size !== null && $size <= 10) {
139 |                     return function () use ($generator) {
140 |                         return $generator->title;
141 |                     };
142 |                 }
143 | 
144 |                 return function () use ($generator) {
145 |                     return $generator->sentence;
146 |                 };
147 |             case 'body':
148 |             case 'summary':
149 |             case 'article':
150 |             case 'description':
151 |                 return function () use ($generator) {
152 |                     return $generator->text;
153 |                 };
154 |         }
155 |     }
156 | }
157 | 


--------------------------------------------------------------------------------
/src/Provider/zh_CN/Company.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider\zh_CN;
  4 | 
  5 | class Company extends \Poppy\Faker\Provider\Company
  6 | {
  7 |     protected static array $formats = [
  8 |         '{{companyPrefix}}{{companySuffix}}',
  9 |     ];
 10 | 
 11 |     protected static $companyPrefix = [
 12 |         '超艺', '和泰', '九方', '鑫博腾飞', '戴硕电子',
 13 |         '济南亿次元', '海创', '创联世纪', '凌云', '泰麒麟',
 14 |         '彩虹', '兰金电子', '晖来计算机', '天益', '恒聪百汇',
 15 |         '菊风公司', '惠派国际公司', '创汇', '思优', '时空盒数字',
 16 |         '易动力', '飞海科技', '华泰通安', '盟新', '商软冠联',
 17 |         '图龙信息', '易动力', '华远软件', '创亿', '时刻',
 18 |         '开发区世创', '明腾', '良诺', '天开', '毕博诚', '快讯',
 19 |         '凌颖信息', '黄石金承', '恩悌', '雨林木风计算机',
 20 |         '双敏电子', '维旺明', '网新恒天', '数字100', '飞利信',
 21 |         '立信电子', '联通时科', '中建创业', '新格林耐特',
 22 |         '新宇龙信息', '浙大万朋', 'MBP软件', '昂歌信息',
 23 |         '万迅电脑', '方正科技', '联软', '七喜', '南康', '银嘉',
 24 |         '巨奥', '佳禾', '国讯', '信诚致远', '浦华众城', '迪摩',
 25 |         '太极', '群英', '合联电子', '同兴万点', '襄樊地球村',
 26 |         '精芯', '艾提科信', '昊嘉', '鸿睿思博', '四通', '富罳',
 27 |         '商软冠联', '诺依曼软件', '东方峻景', '华成育卓', '趋势',
 28 |         '维涛', '通际名联',
 29 |     ];
 30 | 
 31 |     protected static array $companySuffix = ['科技', '网络', '信息', '传媒'];
 32 | 
 33 |     /**
 34 |      * @see blog.renren.com/share/223844062/2387611567
 35 |      * @var array
 36 |      */
 37 |     protected static $catchPhrase = [
 38 |         '燕舞，燕舞，一曲歌来一片情。',
 39 |         '康师傅方便面，好吃看得见。',
 40 |         '不要太潇洒！',
 41 |         '让一亿人先聪明起来。',
 42 |         '共创美的前程，共度美的人生。',
 43 |         '省优，部优，葛优？',
 44 |         '喝孔府宴酒，做天下文章。',
 45 |         '健康成就未来。',
 46 |         '牙好，胃口就好，身体倍儿棒，吃嘛嘛香。',
 47 |         '永远的绿色，永远的秦池。',
 48 |         '坐红旗车，走中国路。',
 49 |         '要想皮肤好，早晚用大宝。',
 50 |         '孔府家酒，叫人想家。',
 51 |         '补钙新观念，吸收是要害。',
 52 |         '喝汇源果汁，走健康之路。',
 53 |         '爱的就是你!',
 54 |         '一种可以世袭的古典浪漫',
 55 |         '实力创造价值',
 56 |         '爱生活，爱拉芳！',
 57 |         '人类失去联想，世界将会怎样？',
 58 |         '做女人挺好！',
 59 |         '世界在你眼中？',
 60 |         '今天你有否亿唐？',
 61 |         '只溶在口，不溶在手。',
 62 |         '三千烦恼丝，健康新开始。',
 63 |         '维维豆奶，欢乐开怀。',
 64 |         '我们的光彩来自你的风采。',
 65 |         '钻石恒久远，一颗永流传。',
 66 |         '放我的真心在你的手心。',
 67 |         '小身材，大味道。',
 68 |         '牛奶香浓，丝般感受。',
 69 |         '聆听并不代表沉默，有时安静也是一种力量。',
 70 |         '滴滴香浓，意犹未尽。',
 71 |         '水晶之恋，一生不变。',
 72 |         '中国移动通信，沟通从心开始！',
 73 |         '网易，网聚人的力量！',
 74 |         '科技以人为本，诺基亚',
 75 |         '我们一直在努力！',
 76 |         '阳光总在风雨后',
 77 |         '男人对西服的要求，就是女人对男人的要求',
 78 |         '晚报，不晚报',
 79 |         '原来生活可以更美的',
 80 |         '明天的明天，你还会送我“水晶之恋”吗？',
 81 |         '卫浴出出进进的快感',
 82 |         '有家就有联合利华',
 83 |         '减脂减肥，其实是一种生活态度',
 84 |         '人头马一开，好事自然来。',
 85 |         '假如五指一样长，怎能满足用户不同需求？',
 86 |         '新飞广告做的好，不好新飞冰箱好',
 87 |         '传奇品质，百年张裕',
 88 |         '李宁：把出色留给自己',
 89 |         '一旦拥有，别无选择',
 90 |         '科技让你更轻松',
 91 |         '情系中国结，联通四海心',
 92 |         '海尔，中国造',
 93 |         'SOHU：足迹生活每一天',
 94 |         '果冻我要喜之郎',
 95 |         '国宝大熊猫，心纯天自高',
 96 |         '世界因为不同',
 97 |         '放低偏见，你会有出色发现！',
 98 |         'Just',
 99 |         '创意似金，敬业如牛',
100 |         '不要让男人一手把握',
101 |         '如同情人的手',
102 |         '金窝银窝，不如自己的安乐窝。',
103 |         '没有什么大不了的',
104 |         '时间因我存在',
105 |         '只要有梦想',
106 |         '南方周末',
107 |         '时间改变一切',
108 |         '地球人都知道了',
109 |         '众里寻他千百度，想要几度就几度',
110 |         '您身边的银行，可信赖的银行',
111 |         '三叶钢琴：学琴的孩子不会变坏',
112 |         '柯达：串起生活每一刻',
113 |         '大众甲克虫汽车：想想还是小的好',
114 |         '一直被模拟,从未被超越',
115 |         '幸福生活',
116 |         '朗讯的创造力科技的原动力',
117 |         '事事因你而出色',
118 |         '运动之美，世界共享',
119 |         '鹤舞白沙',
120 |         '想知道“清嘴”的味道吗？',
121 |         '弹指一挥间，世界皆互联',
122 |         '更多选择、更多欢笑',
123 |         '方太，让家的感觉更好',
124 |         '世上仅此一件，今生与你结缘！',
125 |         '白里透红与众不同',
126 |         '没有蛀牙-佳洁士',
127 |         '有线的价值',
128 |         '享受快乐科技',
129 |         '四海一家的解决之道',
130 |         '娃哈哈纯净水：爱你等于爱自己',
131 |         '农民山泉：有点甜',
132 |         '博大精深，西门子',
133 |         '一切尽在把握',
134 |         '声声百思特，遥遥两相知',
135 |         '一呼天下应',
136 |         '让我们做得更好！',
137 |         '暖和亲情，金龙鱼的大家庭。',
138 |         '自然最健康，绿色好心情',
139 |         '支起网络世界',
140 |         '立邦漆：处处放光彩！',
141 |         'fm365:真情互动！',
142 |         '庄重一生，吉祥一生。',
143 |         '人人都为礼品愁，我送北极海狗油。',
144 |         '假如说人生的离合是一场戏，那么百年的好合更是早有安排！',
145 |         '一品黄山天高云淡',
146 |         '上上下下的享受！',
147 |         '我是、我行、我素',
148 |         '让无力者有力，让悲观者前行',
149 |         '金利来—-男人的世界！',
150 |         '百衣百顺',
151 |         '聪明何必绝顶，慧根长留',
152 |         '水往高处流',
153 |         '大石化小，小石化了！',
154 |         '“闲”妻良母',
155 |         '“口服”，“心服”！',
156 |         '盛满青春的秘密！',
157 |         '三十六计走为上',
158 |         '为了她的节日，献上您纯金般的心！',
159 |         '用我们的钓线，你可以在鱼儿发现你之前先找到它',
160 |         '生活就是一场运动，喝下它。',
161 |         '选择维聚阿尔，已经表明你心明眼亮。',
162 |         '佳能，我们看得见你想表达什么。',
163 |         '天天都是春天',
164 |         '假如你不来，广告明星就是他',
165 |         '享受黑夜中偷拍的快感！',
166 |         '彩信发送动人一刻',
167 |         '灵感点亮生活!',
168 |         '聪明演绎，无处不在！',
169 |         '事业我一定争取，对你我从未放弃!',
170 |         '波导手机，手机中的战斗机',
171 |         '鄂尔多斯羊绒衫暖和全世界',
172 |         '洁婷245再大的动作也不要紧',
173 |         '做光明的牛，产光明的奶',
174 |         '假如你的汽车会游泳的话，请照直开，不必刹车。',
175 |         '永远要让驾驶执照比你自己先到期。',
176 |         '请记住，上帝并不是十全十美的，它给汽车预备了备件，而人没有。',
177 |         '小别意酸酸，欢聚心甜甜。',
178 |         '除钞票外，承印一切。',
179 |         '更多欢乐，更多选择',
180 |         '美由你做主',
181 |         '由我天地宽',
182 |         'Sun是太阳，Java是月亮。',
183 |         '不断创新，因为专心',
184 |         '趁早下『斑』，请勿『痘』留。',
185 |         '请不要同刚刚走出本院的女人调情，她或许就是你的外祖母。',
186 |         '创新就是生活',
187 |         '有一个漂亮的地方，万科四季花城',
188 |         '建筑无限生活',
189 |         '臭名远扬，香飘万里',
190 |         '尝尝欢笑，经常麦当劳',
191 |         '深入成就深度',
192 |         '出色湖南，红网了然！',
193 |         '因为网络，地球如村！',
194 |         '一种质感',
195 |         '恒久期盼',
196 |         '繁荣民族文化',
197 |         '不信，死给你看！',
198 |         '天生的，强生的',
199 |         '雪津啤酒，真情的味道！',
200 |         '听世界，打天下',
201 |         '雅芳比女人更了解女人',
202 |         'Sun是太阳，Java是月亮。',
203 |         '中国网通',
204 |         '无线你的无限',
205 |         '家有三洋，冬暖夏凉',
206 |         '倾诉冬日暖语',
207 |         '谁让我心动？',
208 |         '灵活，让篮球场不再是一个平面',
209 |         '别吻我，我怕修。',
210 |         '一呼四应！',
211 |         '无所不包！',
212 |         '当之无愧',
213 |         '以帽取人！',
214 |         '一毛不拔！',
215 |         '自讨苦吃！',
216 |         '成功与科技共辉映',
217 |         '没有最',
218 |     ];
219 | 
220 |     public static function companyPrefix()
221 |     {
222 |         return static::randomElement(static::$companyPrefix);
223 |     }
224 | 
225 |     public static function companySuffix()
226 |     {
227 |         return parent::companySuffix() . '有限公司';
228 |     }
229 | 
230 |     public function catchPhrase()
231 |     {
232 |         return static::randomElement(static::$catchPhrase);
233 |     }
234 | }
235 | 


--------------------------------------------------------------------------------
/src/Provider/UserAgent.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types = 1);
  4 | 
  5 | namespace Poppy\Faker\Provider;
  6 | 
  7 | class UserAgent extends Base
  8 | {
  9 |     protected static array $userAgents = ['firefox', 'chrome', 'internetExplorer', 'opera', 'safari'];
 10 | 
 11 |     protected static array $windowsPlatformTokens = [
 12 |         'Windows NT 6.2', 'Windows NT 6.1', 'Windows NT 6.0', 'Windows NT 5.2', 'Windows NT 5.1',
 13 |         'Windows NT 5.01', 'Windows NT 5.0', 'Windows NT 4.0', 'Windows 98; Win 9x 4.90', 'Windows 98',
 14 |         'Windows 95', 'Windows CE',
 15 |     ];
 16 | 
 17 |     /**
 18 |      * Possible processors on Linux
 19 |      */
 20 |     protected static array $linuxProcessor = ['i686', 'x86_64'];
 21 | 
 22 |     /**
 23 |      * Mac processors (it also added U;)
 24 |      */
 25 |     protected static array $macProcessor = ['Intel', 'PPC', 'U; Intel', 'U; PPC'];
 26 | 
 27 |     /**
 28 |      * Add as many languages as you like.
 29 |      */
 30 |     protected static array $lang = ['en-US', 'sl-SI'];
 31 | 
 32 |     /**
 33 |      * Generate mac processor
 34 |      *
 35 |      * @return string
 36 |      */
 37 |     public static function macProcessor(): string
 38 |     {
 39 |         return static::randomElement(static::$macProcessor);
 40 |     }
 41 | 
 42 |     /**
 43 |      * Generate linux processor
 44 |      *
 45 |      * @return string
 46 |      */
 47 |     public static function linuxProcessor(): string
 48 |     {
 49 |         return static::randomElement(static::$linuxProcessor);
 50 |     }
 51 | 
 52 |     /**
 53 |      * Generate a random user agent
 54 |      *
 55 |      * @example 'Mozilla/5.0 (Windows CE) AppleWebKit/5350 (KHTML, like Gecko) Chrome/13.0.888.0 Safari/5350'
 56 |      */
 57 |     public static function userAgent()
 58 |     {
 59 |         $userAgentName = static::randomElement(static::$userAgents);
 60 | 
 61 |         return static::$userAgentName();
 62 |     }
 63 | 
 64 |     /**
 65 |      * Generate Chrome user agent
 66 |      *
 67 |      * @example 'Mozilla/5.0 (Macintosh; PPC Mac OS X 10_6_5) AppleWebKit/5312 (KHTML, like Gecko) Chrome/14.0.894.0 Safari/5312'
 68 |      */
 69 |     public static function chrome(): string
 70 |     {
 71 |         $saf = mt_rand(531, 536) . mt_rand(0, 2);
 72 | 
 73 |         $platforms = [
 74 |             '(' . static::linuxPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/" . mt_rand(36, 40) . '.0.' . mt_rand(800, 899) . ".0 Mobile Safari/$saf",
 75 |             '(' . static::windowsPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/" . mt_rand(36, 40) . '.0.' . mt_rand(800, 899) . ".0 Mobile Safari/$saf",
 76 |             '(' . static::macPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Chrome/" . mt_rand(36, 40) . '.0.' . mt_rand(800, 899) . ".0 Mobile Safari/$saf",
 77 |         ];
 78 | 
 79 |         return 'Mozilla/5.0 ' . static::randomElement($platforms);
 80 |     }
 81 | 
 82 |     /**
 83 |      * Generate Firefox user agent
 84 |      *
 85 |      * @example 'Mozilla/5.0 (X11; Linuxi686; rv:7.0) Gecko/20101231 Firefox/3.6'
 86 |      */
 87 |     public static function firefox(): string
 88 |     {
 89 |         $ver = 'Gecko/' . date('Ymd', mt_rand(strtotime('2010-1-1'), time())) . ' Firefox/' . mt_rand(35, 37) . '.0';
 90 | 
 91 |         $platforms = [
 92 |             '(' . static::windowsPlatformToken() . '; ' . static::randomElement(static::$lang) . '; rv:1.9.' . mt_rand(0, 2) . '.20) ' . $ver,
 93 |             '(' . static::linuxPlatformToken() . '; rv:' . mt_rand(5, 7) . '.0) ' . $ver,
 94 |             '(' . static::macPlatformToken() . ' rv:' . mt_rand(2, 6) . '.0) ' . $ver,
 95 |         ];
 96 | 
 97 |         return "Mozilla/5.0 " . static::randomElement($platforms);
 98 |     }
 99 | 
100 |     /**
101 |      * Generate Safari user agent
102 |      *
103 |      * @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'
104 |      */
105 |     public static function safari(): string
106 |     {
107 |         $saf = mt_rand(531, 535) . '.' . mt_rand(1, 50) . '.' . mt_rand(1, 7);
108 |         if (mt_rand(0, 1) == 0) {
109 |             $ver = mt_rand(4, 5) . '.' . mt_rand(0, 1);
110 |         }
111 |         else {
112 |             $ver = mt_rand(4, 5) . '.0.' . mt_rand(1, 5);
113 |         }
114 | 
115 |         $mobileDevices = [
116 |             'iPhone; CPU iPhone OS',
117 |             'iPad; CPU OS',
118 |         ];
119 | 
120 |         $platforms = [
121 |             '(Windows; U; ' . static::windowsPlatformToken() . ") AppleWebKit/$saf (KHTML, like Gecko) Version/$ver Safari/$saf",
122 |             '(' . static::macPlatformToken() . ' rv:' . mt_rand(2, 6) . '.0; ' . static::randomElement(static::$lang) . ") AppleWebKit/$saf (KHTML, like Gecko) Version/$ver Safari/$saf",
123 |             '(' . static::randomElement($mobileDevices) . ' ' . mt_rand(7, 8) . '_' . mt_rand(0, 2) . '_' . mt_rand(1, 2) . ' like Mac OS X; ' . static::randomElement(static::$lang) . ") AppleWebKit/$saf (KHTML, like Gecko) Version/" . mt_rand(3, 4) . ".0.5 Mobile/8B" . mt_rand(111, 119) . " Safari/6$saf",
124 |         ];
125 | 
126 |         return "Mozilla/5.0 " . static::randomElement($platforms);
127 |     }
128 | 
129 |     /**
130 |      * Generate Opera user agent
131 |      *
132 |      * @example 'Opera/8.25 (Windows NT 5.1; en-US) Presto/2.9.188 Version/10.00'
133 |      */
134 |     public static function opera(): string
135 |     {
136 |         $platforms = [
137 |             '(' . static::linuxPlatformToken() . '; ' . static::randomElement(static::$lang) . ') Presto/2.' . mt_rand(8, 12) . '.' . mt_rand(160, 355) . ' Version/' . mt_rand(10, 12) . '.00',
138 |             '(' . static::windowsPlatformToken() . '; ' . static::randomElement(static::$lang) . ') Presto/2.' . mt_rand(8, 12) . '.' . mt_rand(160, 355) . ' Version/' . mt_rand(10, 12) . '.00',
139 |         ];
140 | 
141 |         return "Opera/" . mt_rand(8, 9) . '.' . mt_rand(10, 99) . ' ' . static::randomElement($platforms);
142 |     }
143 | 
144 |     /**
145 |      * Generate Internet Explorer user agent
146 |      *
147 |      * @example 'Mozilla/5.0 (compatible; MSIE 7.0; Windows 98; Win 9x 4.90; Trident/3.0)'
148 |      */
149 |     public static function internetExplorer(): string
150 |     {
151 |         return 'Mozilla/5.0 (compatible; MSIE ' . mt_rand(5, 11) . '.0; ' . static::windowsPlatformToken() . '; Trident/' . mt_rand(3, 5) . '.' . mt_rand(0, 1) . ')';
152 |     }
153 | 
154 |     public static function windowsPlatformToken(): string
155 |     {
156 |         return static::randomElement(static::$windowsPlatformTokens);
157 |     }
158 | 
159 |     public static function macPlatformToken(): string
160 |     {
161 |         return 'Macintosh; ' . static::randomElement(static::$macProcessor) . ' Mac OS X 10_' . mt_rand(5, 8) . '_' . mt_rand(0, 9);
162 |     }
163 | 
164 |     public static function linuxPlatformToken(): string
165 |     {
166 |         return 'X11; Linux ' . static::randomElement(static::$linuxProcessor);
167 |     }
168 | }
169 | 


--------------------------------------------------------------------------------
/src/Provider/zh_TW/Person.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider\zh_TW;
  4 | 
  5 | class Person extends \Poppy\Faker\Provider\Person
  6 | {
  7 |     /**
  8 |      * @see https://zh.wikipedia.org/wiki/%E4%B8%AD%E8%8F%AF%E6%B0%91%E5%9C%8B%E5%9C%8B%E6%B0%91%E8%BA%AB%E5%88%86%E8%AD%89
  9 |      */
 10 |     public static $idBirthplaceCode = [
 11 |         'A' => 10,
 12 |         'B' => 11,
 13 |         'C' => 12,
 14 |         'D' => 13,
 15 |         'E' => 14,
 16 |         'F' => 15,
 17 |         'G' => 16,
 18 |         'H' => 17,
 19 |         'I' => 34,
 20 |         'J' => 18,
 21 |         'K' => 19,
 22 |         'M' => 21,
 23 |         'N' => 22,
 24 |         'O' => 35,
 25 |         'P' => 23,
 26 |         'Q' => 24,
 27 |         'T' => 27,
 28 |         'U' => 28,
 29 |         'V' => 29,
 30 |         'W' => 32,
 31 |         'X' => 30,
 32 |         'Z' => 33,
 33 |     ];
 34 | 
 35 |     /**
 36 |      * @see https://zh.wikipedia.org/wiki/%E4%B8%AD%E8%8F%AF%E6%B0%91%E5%9C%8B%E5%9C%8B%E6%B0%91%E8%BA%AB%E5%88%86%E8%AD%89
 37 |      */
 38 |     public static array $idDigitValidator = [1, 9, 8, 7, 6, 5, 4, 3, 2, 1, 1];
 39 | 
 40 |     protected static array $maleNameFormats = [
 41 |         '{{lastName}}{{firstNameMale}}',
 42 |     ];
 43 | 
 44 |     protected static array $femaleNameFormats = [
 45 |         '{{lastName}}{{firstNameFemale}}',
 46 |     ];
 47 | 
 48 |     protected static array $titleMale = ['先生', '博士', '教授'];
 49 | 
 50 |     protected static array $titleFemale = ['小姐', '太太', '博士', '教授'];
 51 | 
 52 |     /**
 53 |      * @link http://zh.wikipedia.org/wiki/%E7%99%BE%E5%AE%B6%E5%A7%93
 54 |      */
 55 |     protected static array $lastName = [
 56 |         '趙', '錢', '孫', '李', '周', '吳', '鄭', '王', '馮',
 57 |         '陳', '褚', '衛', '蔣', '沈', '韓', '楊', '朱', '秦',
 58 |         '尤', '許', '何', '呂', '施', '張', '孔', '曹', '嚴',
 59 |         '華', '金', '魏', '陶', '姜', '戚', '謝', '鄒', '喻',
 60 |         '柏', '水', '竇', '章', '雲', '蘇', '潘', '葛',
 61 |         '奚', '范', '彭', '郎', '魯', '韋', '昌', '馬',
 62 |         '苗', '鳳', '花', '方', '俞', '任', '袁', '柳',
 63 |         '酆', '鮑', '史', '唐', '費', '廉', '岑', '薛',
 64 |         '雷', '賀', '倪', '湯', '滕', '殷', '羅', '畢',
 65 |         '郝', '鄔', '安', '常', '樂', '于', '時', '傅',
 66 |         '皮', '卞', '齊', '康', '伍', '余', '元', '卜',
 67 |         '顧', '孟', '平', '黃', '和', '穆', '蕭', '尹',
 68 |         '姚', '邵', '湛', '汪', '祁', '毛', '禹', '狄',
 69 |         '米', '貝', '明', '臧', '計', '伏', '成', '戴',
 70 |         '談', '宋', '茅', '龐', '熊', '紀', '舒', '屈',
 71 |         '項', '祝', '董', '梁', '杜', '阮', '藍', '閔',
 72 |         '席', '季', '麻', '強', '賈', '路', '婁', '危',
 73 |         '江', '童', '顏', '郭', '梅', '盛', '林', '刁',
 74 |         '鍾', '徐', '丘', '駱', '高', '夏', '蔡', '田',
 75 |         '樊', '胡', '凌', '霍', '虞', '萬', '支', '柯',
 76 |         '昝', '管', '盧', '莫', '經', '房', '裘', '繆',
 77 |         '干', '解', '應', '宗', '丁', '宣', '賁', '鄧',
 78 |         '郁', '單', '杭', '洪', '包', '諸', '左', '石',
 79 |         '崔', '吉', '鈕', '龔', '程', '嵇', '邢', '滑',
 80 |         '裴', '陸', '榮', '翁', '荀', '羊', '於', '惠',
 81 |         '甄', '麴', '家', '封', '芮', '羿', '儲', '靳',
 82 |         '汲', '邴', '糜', '松', '井', '段', '富', '巫',
 83 |         '烏', '焦', '巴', '弓', '牧', '隗', '山', '谷',
 84 |         '車', '侯', '宓', '蓬', '全', '郗', '班', '仰',
 85 |         '秋', '仲', '伊', '宮', '甯', '仇', '欒', '暴',
 86 |         '甘', '鈄', '厲', '戎', '祖', '武', '符', '劉',
 87 |         '景', '詹', '束', '龍', '葉', '幸', '司', '韶',
 88 |         '郜', '黎', '薊', '薄', '印', '宿', '白', '懷',
 89 |         '蒲', '邰', '從', '鄂', '索', '咸', '籍', '賴',
 90 |         '卓', '藺', '屠', '蒙', '池', '喬', '陰', '鬱',
 91 |         '胥', '能', '蒼', '雙', '聞', '莘', '黨', '翟',
 92 |         '譚', '貢', '勞', '逄', '姬', '申', '扶', '堵',
 93 |         '冉', '宰', '酈', '雍', '郤', '璩', '桑', '桂',
 94 |         '濮', '牛', '壽', '通', '邊', '扈', '燕', '冀',
 95 |         '郟', '浦', '尚', '農', '溫', '別', '莊', '晏',
 96 |         '柴', '瞿', '閻', '充', '慕', '連', '茹', '習',
 97 |         '宦', '艾', '魚', '容', '向', '古', '易', '慎',
 98 |         '戈', '廖', '庾', '終', '暨', '居', '衡', '步',
 99 |         '都', '耿', '滿', '弘', '匡', '國', '文', '寇',
100 |         '廣', '祿', '闕', '東', '歐', '殳', '沃', '利',
101 |         '蔚', '越', '夔', '隆', '師', '鞏', '厙', '聶',
102 |         '晁', '勾', '敖', '融', '冷', '訾', '辛', '闞',
103 |         '那', '簡', '饒', '空', '曾', '毋', '沙', '乜',
104 |         '養', '鞠', '須', '豐', '巢', '關', '蒯', '相',
105 |         '查', '后', '荊', '紅', '游', '竺', '權', '逯',
106 |         '蓋', '益', '桓', '公', '万俟', '司馬', '上官',
107 |         '歐陽', '夏侯', '諸葛', '聞人', '東方', '赫連',
108 |         '皇甫', '尉遲', '公羊', '澹臺', '公冶', '宗政',
109 |         '濮陽', '淳于', '單于', '太叔', '申屠', '公孫',
110 |         '仲孫', '軒轅', '令狐', '鍾離', '宇文', '長孫',
111 |         '慕容', '鮮于', '閭丘', '司徒', '司空', '亓官',
112 |         '司寇', '仉', '督', '子車', '顓孫', '端木', '巫馬',
113 |         '公西', '漆雕', '樂正', '壤駟', '公良', '拓跋',
114 |         '夾谷', '宰父', '穀梁', '晉', '楚', '閆', '法',
115 |         '汝', '鄢', '涂', '欽', '段干', '百里', '東郭',
116 |         '南門', '呼延', '歸', '海', '羊舌', '微生', '岳',
117 |         '帥', '緱', '亢', '況', '後', '有', '琴', '梁丘',
118 |         '左丘', '東門', '西門', '商', '牟', '佘', '佴',
119 |         '伯', '賞', '南宮', '墨', '哈', '譙', '笪', '年',
120 |         '愛', '陽', '佟', '第五', '言', '福',
121 |     ];
122 | 
123 |     /**
124 |      * @link http://technology.chtsai.org/namefreq/
125 |      */
126 |     protected static $characterMale = [
127 |         '佳', '俊', '信', '偉', '傑', '冠', '君', '哲',
128 |         '嘉', '威', '宇', '安', '宏', '宗', '宜', '家',
129 |         '庭', '廷', '建', '彥', '心', '志', '思', '承',
130 |         '文', '柏', '樺', '瑋', '穎', '美', '翰', '華',
131 |         '詩', '豪', '賢', '軒', '銘', '霖',
132 |     ];
133 | 
134 |     protected static $characterFemale = [
135 |         '伶', '佩', '佳', '依', '儀', '冠', '君', '嘉',
136 |         '如', '娟', '婉', '婷', '安', '宜', '家', '庭',
137 |         '心', '思', '怡', '惠', '慧', '文', '欣', '涵',
138 |         '淑', '玲', '珊', '琪', '琬', '瑜', '穎', '筑',
139 |         '筱', '美', '芬', '芳', '華', '萍', '萱', '蓉',
140 |         '詩', '貞', '郁', '鈺', '雅', '雯', '靜', '馨',
141 |     ];
142 | 
143 |     public static function randomName($pool, $n)
144 |     {
145 |         $name = '';
146 |         for ($i = 0; $i < $n; ++$i) {
147 |             $name .= static::randomElement($pool);
148 |         }
149 |         return $name;
150 |     }
151 | 
152 |     public static function firstNameMale()
153 |     {
154 |         return static::randomName(static::$characterMale, mt_rand(1, 2));
155 |     }
156 | 
157 |     public static function firstNameFemale()
158 |     {
159 |         return static::randomName(static::$characterFemale, mt_rand(1, 2));
160 |     }
161 | 
162 |     public static function suffix()
163 |     {
164 |         return '';
165 |     }
166 | 
167 |     /**
168 |      * @param string $gender Person::GENDER_MALE || Person::GENDER_FEMALE
169 |      *
170 |      * @return string Length 10 alphanumeric characters, begins with 1 latin character (birthplace),
171 |      * 1 number (gender) and then 8 numbers (the last one is check digit).
172 |      * @see https://en.wikipedia.org/wiki/National_Identification_Card_(Republic_of_China)
173 |      *
174 |      */
175 |     public function personalIdentityNumber($gender = null)
176 |     {
177 |         $birthPlace     = self::randomKey(self::$idBirthplaceCode);
178 |         $birthPlaceCode = self::$idBirthplaceCode[$birthPlace];
179 | 
180 |         $gender     = ($gender != null) ? $gender : self::randomElement([self::GENDER_FEMALE, self::GENDER_MALE]);
181 |         $genderCode = ($gender === self::GENDER_MALE) ? 1 : 2;
182 | 
183 |         $randomNumberCode = self::randomNumber(7, true);
184 | 
185 |         $codes = str_split($birthPlaceCode . $genderCode . $randomNumberCode);
186 |         $total = 0;
187 | 
188 |         foreach ($codes as $key => $code) {
189 |             $total += $code * self::$idDigitValidator[$key];
190 |         }
191 | 
192 |         $checkSumDigit = 10 - ($total % 10);
193 | 
194 |         if ($checkSumDigit == 10) {
195 |             $checkSumDigit = 0;
196 |         }
197 | 
198 |         return $birthPlace . $genderCode . $randomNumberCode . $checkSumDigit;
199 |     }
200 | }
201 | 


--------------------------------------------------------------------------------
/src/Provider/zh_TW/Company.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider\zh_TW;
  4 | 
  5 | class Company extends \Poppy\Faker\Provider\Company
  6 | {
  7 |     protected static $companyEnSuffix = [
  8 |         'Inc', 'and Sons', 'LLC', 'Group', 'PLC', 'Ltd',
  9 |     ];
 10 | 
 11 |     protected static $companyEnFormats = [
 12 |         '{{lastNameEn}} {{companyEnSuffix}}',
 13 |         '{{lastNameEn}}-{{lastNameEn}}',
 14 |         '{{lastNameEn}}, {{lastNameEn}} and {{lastNameEn}}',
 15 |     ];
 16 | 
 17 |     protected static array $formats = [
 18 |         '{{companyPrefix}}{{companyModifier}}',
 19 |         '{{companyPrefix}}{{companySuffix}}',
 20 |         '{{companyPrefix}}{{companyModifier}}{{CompanySuffix}}',
 21 |     ];
 22 | 
 23 |     /**
 24 |      * @link http://zh.wikipedia.org/zh-tw/Category:%E5%8F%B0%E7%81%A3%E5%85%AC%E5%8F%B8%E5%88%97%E8%A1%A8
 25 |      */
 26 |     protected static $companyPrefix = [
 27 |         '乾坤', '亞神', '光譜', '典選', '凱基', '前衛花園',
 28 |         '創見', '友訊', '台達', '合勤', '喜瑪拉雅', '喬山',
 29 |         '多利安', '大國', '大宇', '太陽', '太陽動力', '宏碁',
 30 |         '宏達', '小白兔', '巨大', '巨室', '康師傅', '延伸',
 31 |         '弘煜', '彎的', '擎天', '新亞洲', '旺旺', '昱泉',
 32 |         '智冠', '未來', '松崗', '正新', '洧誠', '海蝶',
 33 |         '添翼創越', '滾石', '王品', '當然', '相信', '睛水',
 34 |         '研華', '福茂', '種子', '米樂士', '紅元素', '紅心辣椒',
 35 |         '統一', '美利達', '美妙', '美樂帝', '群石', '老鷹',
 36 |         '聯強', '芮河', '英特衛', '茂為', '華特', '華研',
 37 |         '華碩', '華義', '角頭', '訊連', '豐華', '豪客', '豪記',
 38 |         '貴族', '趨勢', '遊戲橘子', '野火樂集', '金革',
 39 |         '銀魚', '阿爾發', '風和日麗', '風潮', '風雲',
 40 |     ];
 41 | 
 42 |     protected static $companyModifier = [
 43 |         '科技', '電腦', '國際', '電子', '娛樂', '音樂', '唱片',
 44 |         '證券', '集團', '企業', '機械', '工業', '文化', '汽車',
 45 |         '百貨', '酒店', '數位',
 46 |     ];
 47 | 
 48 |     protected static array $companySuffix = [
 49 |         '公司', '有限公司', '股份有限公司',
 50 |     ];
 51 | 
 52 |     /**
 53 |      * @link https://zh-tw.facebook.com/notes/%E7%8E%A9%E5%BB%A3%E5%91%8Aplaying-with-advertising/%E5%9B%9E%E9%A1%A7%E8%87%BA%E7%81%A3%E6%AD%B7%E5%B1%86%E5%BB%A3%E5%91%8A%E9%87%91%E5%8F%A5%E7%8D%8E/294008963985215
 54 |      */
 55 |     protected static $catchPhrase = [
 56 |         'Everything\'s ok',
 57 |         'Just call me be happy',
 58 |         'Keep Walking',
 59 |         'NOKIA相信科技始終來自於人性',
 60 |         'PayEasy，陪你Shopping一輩子',
 61 |         'Play不累',
 62 |         'The city never sleeps',
 63 |         'Trust me, you can make it!',
 64 |         'We are family',
 65 |         'We share',
 66 |         'You A.S.O beautiful',
 67 |         '一人吃，兩人補',
 68 |         '一定要幸福哦！',
 69 |         '一把抵兩把，何需瑪麗亞？！',
 70 |         '一次買好，就是頂好',
 71 |         '一步一腳印，大家愛台灣',
 72 |         '一段話，感動了一幅畫！',
 73 |         '一點一點 累積更好的自己',
 74 |         '三不五時，愛要及時',
 75 |         '三餐老是在外，人人叫我老外！',
 76 |         '不只辦公室，掌握更多事',
 77 |         '不在乎天長地久，只在乎曾經擁有',
 78 |         '不在辦公室，也能辦公事',
 79 |         '不平凡的平凡大眾',
 80 |         '不想分開 就永遠在一起吧',
 81 |         '不該愛的，趁早換',
 82 |         '不過～不過～，一定測不過',
 83 |         '世事難料，安泰比較好',
 84 |         '世事難料，對人要更好',
 85 |         '世界上最重要的一部車是爸爸的肩膀',
 86 |         '乎乾啦！',
 87 |         '人生30財開始',
 88 |         '什麼最青？',
 89 |         '什麼都有，什麼都賣，什麼都不奇怪！',
 90 |         '今天心情幾？',
 91 |         '他傻瓜、你聰明',
 92 |         '他捉得住我',
 93 |         '你未必出類拔萃 但肯定與眾不同',
 94 |         '你的愛，是孩子最好的示範',
 95 |         '你講台語嘛也通',
 96 |         '便宜一樣有好貨',
 97 |         '係金A！',
 98 |         '信任，帶來新幸福',
 99 |         '信義房屋，信任，帶來新幸福',
100 |         '做你自己才叫乖，做你的乖乖！',
101 |         '做自己 自己做',
102 |         '傻瓜鏡片,聰明選擇',
103 |         'お元気ですか？',
104 |         '全國電子 足感心ㄟ',
105 |         '全家就是你家',
106 |         '再忙，也要和你喝杯咖啡',
107 |         '別讓今天的應酬成為明天的負擔',
108 |         '到服裝店培養氣質，到書店展示服裝',
109 |         '化去心中那條線',
110 |         '原來我們這麼近',
111 |         '只有遠傳，沒有距離',
112 |         '只要有夢，你會紅',
113 |         '叫天天不印 Canon幫你印！',
114 |         '可憐的舊情人，看不到我的新內衣',
115 |         '台灣，加油！',
116 |         '合味才會呷意',
117 |         '啊！福氣啦！',
118 |         '喜歡嗎? 爸爸買給你!',
119 |         '嚕加嚕好呷',
120 |         '回家的感覺真好',
121 |         '因為你值得 L’ORE’AL',
122 |         '夏天好熱 愛要趁熱',
123 |         '多喝水沒事，沒事多喝水',
124 |         '夜深了，打個電話回家',
125 |         '天生超人氣，不該遭人棄',
126 |         '女人說好，才算頂好',
127 |         '好東西和好朋友分享',
128 |         '好的開喜就是成功的一半！',
129 |         '好身體，沒人敢惹你',
130 |         '好險，有南山！',
131 |         '孩子！我要你將來比我強！',
132 |         '學琴的孩子不會變壞',
133 |         '安全是回家唯一的路',
134 |         '小而美、小而冷、小而省',
135 |         '幸福怎能說不用',
136 |         '心，是人生最大的戰場',
137 |         '您真內行！',
138 |         '想像力是你的超能力',
139 |         '慈母心、豆腐心',
140 |         '我不認識你，但是我謝謝你！',
141 |         '我就是超愛 Send！',
142 |         '我的八分新摺學！',
143 |         '拍誰像誰，誰拍誰誰都得像誰',
144 |         '挺立，不只挺阮 也挺恁',
145 |         '捐血一袋，救人一命',
146 |         '撼動天下的力量',
147 |         '擋不住的感覺',
148 |         '整個城市就是我的咖啡館',
149 |         '最佳女主角換你做做看',
150 |         '有心最要緊',
151 |         '有書才會贏',
152 |         '有青才敢大聲',
153 |         '有點黏又不會太黏',
154 |         '期待下一次，不如靠自己',
155 |         '未來 就是現在',
156 |         '正反，反正都很正！',
157 |         '每一句話，都是思念',
158 |         '沒說出口的 保誠也聽得懂',
159 |         '現在的Nobody，未來的Somebody！',
160 |         '生命就該浪費在美好的事物上',
161 |         '用你想要的方式道別',
162 |         '用大金，省大金',
163 |         '用好心腸做好香腸',
164 |         '用愛打敗不景氣',
165 |         '用最愛 照顧最愛',
166 |         '留一盞燈給最後回家的人',
167 |         '百服寧、保護您',
168 |         '真感情就是最好的服務',
169 |         '知識使你更有魅力',
170 |         '碼碼都有獎',
171 |         '管他什麼垢，一瓶就夠',
172 |         '紅利點數也能當飯吃',
173 |         '紙有春風最溫柔',
174 |         '紙要Double A 萬事都OK！',
175 |         '給你好看',
176 |         '給我小心點兒',
177 |         '肝哪沒好，人生是黑白的！肝哪顧好，人生是彩色的！',
178 |         '肝苦誰人知',
179 |         '萬事皆可達，唯有情無價',
180 |         '認真的女人最美麗',
181 |         '贏甲嘸知人',
182 |         '路，是ESCAPE走出來的',
183 |         '這不是肯德基！',
184 |         '這個月不會來，下個月也不會來了，以後都不會來了',
185 |         '這是一定要的啦！',
186 |         '這種時機，無閒也是一種幸福',
187 |         '這種鬼地方都收得到',
188 |         '通往成功的路，總是在施工中',
189 |         '鑽石恆久遠，一顆永留傳',
190 |         '關心自己，也關心別人',
191 |         '關機是一種美德',
192 |         '陪妳Shopping 一輩子',
193 |         '雅芳比女人更瞭解女人',
194 |         '青菜底呷啦',
195 |         '靜得讓您耳根清靜',
196 |         '馬上就會好',
197 |     ];
198 | 
199 |     protected static $bsWords = [
200 |         [
201 |             '實現', '實作', '整合', '最佳化',
202 |             '革命', '轉變', '提昇', '啟用', '指揮',
203 |             '利用', '重現', '結合', '架構', '加強',
204 |             '集中', '變形', '強化', '推廣', '延伸',
205 |             '生產', '進化', '改善', '提高', '開發',
206 |             '創造', '專注',
207 |         ], [
208 |             '加值', '縱向', '堅固', '全球', '在地', '領先',
209 |             '虛擬', '動態', '完全', '成熟', '穩定', '穩健',
210 |             '即時', '全年無休', '高效', '快速', '互動',
211 |             '世界級', '下一代', '新一代', '無線', '無限',
212 |             '豐富', '開源', '前端', '分散式', '無縫', '跨平臺',
213 |         ],
214 |         [
215 |             '典範', '市場', '合作', '架構', '基礎平臺', '頻道',
216 |             '焦點', '方案', '解決方案', '社群', '科技', '技術',
217 |             '內容', '入口', '供應鍊', '介面', '系統', '頻寬',
218 |             '模型', '網路', '使用經驗', '評量', '方法',
219 |         ],
220 |     ];
221 | 
222 |     public static function companyEnSuffix()
223 |     {
224 |         return static::randomElement(static::$companyEnSuffix);
225 |     }
226 | 
227 |     public function companyEn()
228 |     {
229 |         $format = static::randomElement(static::$companyEnFormats);
230 |         return $this->generator->parse($format);
231 |     }
232 | 
233 |     public static function companyModifier()
234 |     {
235 |         return static::randomElement(static::$companyModifier);
236 |     }
237 | 
238 |     public static function companyPrefix()
239 |     {
240 |         return static::randomElement(static::$companyPrefix);
241 |     }
242 | 
243 |     public function catchPhrase()
244 |     {
245 |         return static::randomElement(static::$catchPhrase);
246 |     }
247 | 
248 |     public function bs()
249 |     {
250 |         $result = '';
251 |         foreach (static::$bsWords as &$word) {
252 |             $result .= static::randomElement($word);
253 |         }
254 |         return $result;
255 |     }
256 | 
257 |     /**
258 |      * return standard VAT / Tax ID / Uniform Serial Number
259 |      *
260 |      * @return int
261 |      * @example 28263822
262 |      *
263 |      */
264 |     public function VAT()
265 |     {
266 |         return static::randomNumber(8, true);
267 |     }
268 | }
269 | 


--------------------------------------------------------------------------------
/src/Provider/Lorem.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | use InvalidArgumentException;
  6 | 
  7 | class Lorem extends Base
  8 | {
  9 |     protected static array $wordList = [
 10 |         'alias', 'consequatur', 'aut', 'perferendis', 'sit', 'voluptatem',
 11 |         'accusantium', 'doloremque', 'aperiam', 'eaque', 'ipsa', 'quae', 'ab',
 12 |         'illo', 'inventore', 'veritatis', 'et', 'quasi', 'architecto',
 13 |         'beatae', 'vitae', 'dicta', 'sunt', 'explicabo', 'aspernatur', 'aut',
 14 |         'odit', 'aut', 'fugit', 'sed', 'quia', 'consequuntur', 'magni',
 15 |         'dolores', 'eos', 'qui', 'ratione', 'voluptatem', 'sequi', 'nesciunt',
 16 |         'neque', 'dolorem', 'ipsum', 'quia', 'dolor', 'sit', 'amet',
 17 |         'consectetur', 'adipisci', 'velit', 'sed', 'quia', 'non', 'numquam',
 18 |         'eius', 'modi', 'tempora', 'incidunt', 'ut', 'labore', 'et', 'dolore',
 19 |         'magnam', 'aliquam', 'quaerat', 'voluptatem', 'ut', 'enim', 'ad',
 20 |         'minima', 'veniam', 'quis', 'nostrum', 'exercitationem', 'ullam',
 21 |         'corporis', 'nemo', 'enim', 'ipsam', 'voluptatem', 'quia', 'voluptas',
 22 |         'sit', 'suscipit', 'laboriosam', 'nisi', 'ut', 'aliquid', 'ex', 'ea',
 23 |         'commodi', 'consequatur', 'quis', 'autem', 'vel', 'eum', 'iure',
 24 |         'reprehenderit', 'qui', 'in', 'ea', 'voluptate', 'velit', 'esse',
 25 |         'quam', 'nihil', 'molestiae', 'et', 'iusto', 'odio', 'dignissimos',
 26 |         'ducimus', 'qui', 'blanditiis', 'praesentium', 'laudantium', 'totam',
 27 |         'rem', 'voluptatum', 'deleniti', 'atque', 'corrupti', 'quos',
 28 |         'dolores', 'et', 'quas', 'molestias', 'excepturi', 'sint',
 29 |         'occaecati', 'cupiditate', 'non', 'provident', 'sed', 'ut',
 30 |         'perspiciatis', 'unde', 'omnis', 'iste', 'natus', 'error',
 31 |         'similique', 'sunt', 'in', 'culpa', 'qui', 'officia', 'deserunt',
 32 |         'mollitia', 'animi', 'id', 'est', 'laborum', 'et', 'dolorum', 'fuga',
 33 |         'et', 'harum', 'quidem', 'rerum', 'facilis', 'est', 'et', 'expedita',
 34 |         'distinctio', 'nam', 'libero', 'tempore', 'cum', 'soluta', 'nobis',
 35 |         'est', 'eligendi', 'optio', 'cumque', 'nihil', 'impedit', 'quo',
 36 |         'porro', 'quisquam', 'est', 'qui', 'minus', 'id', 'quod', 'maxime',
 37 |         'placeat', 'facere', 'possimus', 'omnis', 'voluptas', 'assumenda',
 38 |         'est', 'omnis', 'dolor', 'repellendus', 'temporibus', 'autem',
 39 |         'quibusdam', 'et', 'aut', 'consequatur', 'vel', 'illum', 'qui',
 40 |         'dolorem', 'eum', 'fugiat', 'quo', 'voluptas', 'nulla', 'pariatur',
 41 |         'at', 'vero', 'eos', 'et', 'accusamus', 'officiis', 'debitis', 'aut',
 42 |         'rerum', 'necessitatibus', 'saepe', 'eveniet', 'ut', 'et',
 43 |         'voluptates', 'repudiandae', 'sint', 'et', 'molestiae', 'non',
 44 |         'recusandae', 'itaque', 'earum', 'rerum', 'hic', 'tenetur', 'a',
 45 |         'sapiente', 'delectus', 'ut', 'aut', 'reiciendis', 'voluptatibus',
 46 |         'maiores', 'doloribus', 'asperiores', 'repellat',
 47 |     ];
 48 | 
 49 |     /**
 50 |      * @return string
 51 |      * @example 'Lorem'
 52 |      */
 53 |     public static function word()
 54 |     {
 55 |         return static::randomElement(static::$wordList);
 56 |     }
 57 | 
 58 |     /**
 59 |      * Generate an array of random words
 60 |      *
 61 |      * @param integer $nb     how many words to return
 62 |      * @param bool    $asText if true the sentences are returned as one string
 63 |      * @return array|string
 64 |      * @example array('Lorem', 'ipsum', 'dolor')
 65 |      */
 66 |     public static function words($nb = 3, $asText = false)
 67 |     {
 68 |         $words = [];
 69 |         for ($i = 0; $i < $nb; $i++) {
 70 |             $words [] = static::word();
 71 |         }
 72 | 
 73 |         return $asText ? implode(' ', $words) : $words;
 74 |     }
 75 | 
 76 |     /**
 77 |      * Generate a random sentence
 78 |      *
 79 |      * @param integer $nbWords          around how many words the sentence should contain
 80 |      * @param boolean $variableNbWords  set to false if you want exactly $nbWords returned,
 81 |      *                                  otherwise $nbWords may vary by +/-40% with a minimum of 1
 82 |      * @return string
 83 |      * @example 'Lorem ipsum dolor sit amet.'
 84 |      */
 85 |     public static function sentence($nbWords = 6, $variableNbWords = true)
 86 |     {
 87 |         if ($nbWords <= 0) {
 88 |             return '';
 89 |         }
 90 |         if ($variableNbWords) {
 91 |             $nbWords = self::randomizeNbElements($nbWords);
 92 |         }
 93 | 
 94 |         $words    = static::words($nbWords);
 95 |         $words[0] = ucwords($words[0]);
 96 | 
 97 |         return implode(' ', $words) . '.';
 98 |     }
 99 | 
100 |     /**
101 |      * Generate an array of sentences
102 |      *
103 |      * @param integer $nb     how many sentences to return
104 |      * @param bool    $asText if true the sentences are returned as one string
105 |      * @return array|string
106 |      * @example array('Lorem ipsum dolor sit amet.', 'Consectetur adipisicing eli.')
107 |      */
108 |     public static function sentences($nb = 3, $asText = false)
109 |     {
110 |         $sentences = [];
111 |         for ($i = 0; $i < $nb; $i++) {
112 |             $sentences [] = static::sentence();
113 |         }
114 | 
115 |         return $asText ? implode(' ', $sentences) : $sentences;
116 |     }
117 | 
118 |     /**
119 |      * Generate a single paragraph
120 |      *
121 |      * @param integer $nbSentences          around how many sentences the paragraph should contain
122 |      * @param boolean $variableNbSentences  set to false if you want exactly $nbSentences returned,
123 |      *                                      otherwise $nbSentences may vary by +/-40% with a minimum of 1
124 |      * @return string
125 |      * @example 'Sapiente sunt omnis. Ut pariatur ad autem ducimus et. Voluptas rem voluptas sint modi dolorem amet.'
126 |      */
127 |     public static function paragraph($nbSentences = 3, $variableNbSentences = true)
128 |     {
129 |         if ($nbSentences <= 0) {
130 |             return '';
131 |         }
132 |         if ($variableNbSentences) {
133 |             $nbSentences = self::randomizeNbElements($nbSentences);
134 |         }
135 | 
136 |         return implode(' ', static::sentences($nbSentences));
137 |     }
138 | 
139 |     /**
140 |      * Generate an array of paragraphs
141 |      *
142 |      * @param integer $nb     how many paragraphs to return
143 |      * @param bool    $asText if true the paragraphs are returned as one string, separated by two newlines
144 |      * @return array|string
145 |      * @example array($paragraph1, $paragraph2, $paragraph3)
146 |      */
147 |     public static function paragraphs($nb = 3, $asText = false)
148 |     {
149 |         $paragraphs = [];
150 |         for ($i = 0; $i < $nb; $i++) {
151 |             $paragraphs [] = static::paragraph();
152 |         }
153 | 
154 |         return $asText ? implode("\n\n", $paragraphs) : $paragraphs;
155 |     }
156 | 
157 |     /**
158 |      * Generate a text string.
159 |      * Depending on the $maxNbChars, returns a string made of words, sentences, or paragraphs.
160 |      *
161 |      * @param integer $maxNbChars Maximum number of characters the text should contain (minimum 5)
162 |      *
163 |      * @return string
164 |      * @example 'Sapiente sunt omnis. Ut pariatur ad autem ducimus et. Voluptas rem voluptas sint modi dolorem amet.'
165 |      *
166 |      */
167 |     public static function text($maxNbChars = 200)
168 |     {
169 |         if ($maxNbChars < 5) {
170 |             throw new InvalidArgumentException('text() can only generate text of at least 5 characters');
171 |         }
172 | 
173 |         $type = ($maxNbChars < 25) ? 'word' : (($maxNbChars < 100) ? 'sentence' : 'paragraph');
174 | 
175 |         $text = [];
176 |         while (empty($text)) {
177 |             $size = 0;
178 | 
179 |             // until $maxNbChars is reached
180 |             while ($size < $maxNbChars) {
181 |                 $word   = ($size ? ' ' : '') . static::$type();
182 |                 $text[] = $word;
183 | 
184 |                 $size += strlen($word);
185 |             }
186 | 
187 |             array_pop($text);
188 |         }
189 | 
190 |         if ($type === 'word') {
191 |             // capitalize first letter
192 |             $text[0] = ucwords($text[0]);
193 | 
194 |             // end sentence with full stop
195 |             $text[count($text) - 1] .= '.';
196 |         }
197 | 
198 |         return implode('', $text);
199 |     }
200 | 
201 |     protected static function randomizeNbElements($nbElements)
202 |     {
203 |         return (int) ($nbElements * mt_rand(60, 140) / 100) + 1;
204 |     }
205 | }
206 | 


--------------------------------------------------------------------------------
/src/Provider/en_US/Address.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Poppy\Faker\Provider\en_US;
 4 | 
 5 | class Address extends \Poppy\Faker\Provider\Address
 6 | {
 7 |     protected static array $cityPrefix              = ['North', 'East', 'West', 'South', 'New', 'Lake', 'Port'];
 8 |     protected static array $citySuffix              = ['town', 'ton', 'land', 'ville', 'berg', 'burgh', 'borough', 'bury', 'view', 'port', 'mouth', 'stad', 'furt', 'chester', 'mouth', 'fort', 'haven', 'side', 'shire'];
 9 |     protected static array $buildingNumber          = ['%####', '%###', '%##'];
10 |     protected static array $streetSuffix            = [
11 |         'Alley', 'Avenue', 'Branch', 'Bridge', 'Brook', 'Brooks', 'Burg', 'Burgs', 'Bypass', 'Camp', 'Canyon', 'Cape', 'Causeway', 'Center', 'Centers', 'Circle', 'Circles', 'Cliff', 'Cliffs', 'Club', 'Common', 'Corner', 'Corners', 'Course', 'Court', 'Courts', 'Cove', 'Coves', 'Creek', 'Crescent', 'Crest', 'Crossing', 'Crossroad', 'Curve', 'Dale', 'Dam', 'Divide', 'Drive', 'Drive', 'Drives', 'Estate', 'Estates', 'Expressway', 'Extension', 'Extensions', 'Fall', 'Falls', 'Ferry', 'Field', 'Fields', 'Flat', 'Flats', 'Ford', 'Fords', 'Forest', 'Forge', 'Forges', 'Fork', 'Forks', 'Fort', 'Freeway', 'Garden', 'Gardens', 'Gateway', 'Glen', 'Glens', 'Green', 'Greens', 'Grove', 'Groves', 'Harbor', 'Harbors', 'Haven', 'Heights', 'Highway', 'Hill', 'Hills', 'Hollow', 'Inlet', 'Inlet', 'Island', 'Island', 'Islands', 'Islands', 'Isle', 'Isle', 'Junction', 'Junctions', 'Key', 'Keys', 'Knoll', 'Knolls', 'Lake', 'Lakes', 'Land', 'Landing', 'Lane', 'Light', 'Lights', 'Loaf', 'Lock', 'Locks', 'Locks', 'Lodge', 'Lodge', 'Loop', 'Mall', 'Manor', 'Manors', 'Meadow', 'Meadows', 'Mews', 'Mill', 'Mills', 'Mission', 'Mission', 'Motorway', 'Mount', 'Mountain', 'Mountain', 'Mountains', 'Mountains', 'Neck', 'Orchard', 'Oval', 'Overpass', 'Park', 'Parks', 'Parkway', 'Parkways', 'Pass', 'Passage', 'Path', 'Pike', 'Pine', 'Pines', 'Place', 'Plain', 'Plains', 'Plains', 'Plaza', 'Plaza', 'Point', 'Points', 'Port', 'Port', 'Ports', 'Ports', 'Prairie', 'Prairie', 'Radial', 'Ramp', 'Ranch', 'Rapid', 'Rapids', 'Rest', 'Ridge', 'Ridges', 'River', 'Road', 'Road', 'Roads', 'Roads', 'Route', 'Row', 'Rue', 'Run', 'Shoal', 'Shoals', 'Shore', 'Shores', 'Skyway', 'Spring', 'Springs', 'Springs', 'Spur', 'Spurs', 'Square', 'Square', 'Squares', 'Squares', 'Station', 'Station', 'Stravenue', 'Stravenue', 'Stream', 'Stream', 'Street', 'Street', 'Streets', 'Summit', 'Summit', 'Terrace', 'Throughway', 'Trace', 'Track', 'Trafficway', 'Trail', 'Trail', 'Tunnel', 'Tunnel', 'Turnpike', 'Turnpike', 'Underpass', 'Union', 'Unions', 'Valley', 'Valleys', 'Via', 'Viaduct', 'View', 'Views', 'Village', 'Village', 'Villages', 'Ville', 'Vista', 'Vista', 'Walk', 'Walks', 'Wall', 'Way', 'Ways', 'Well', 'Wells',
12 |     ];
13 |     protected static array $postcode                = ['#####', '#####-####'];
14 |     protected static array $state                   = [
15 |         'Alabama', 'Alaska', 'Arizona', 'Arkansas', 'California', 'Colorado', 'Connecticut', 'Delaware', 'District of Columbia', 'Florida', 'Georgia', 'Hawaii', 'Idaho', 'Illinois', 'Indiana', 'Iowa', 'Kansas', 'Kentucky', 'Louisiana', 'Maine', 'Maryland', 'Massachusetts', 'Michigan', 'Minnesota', 'Mississippi', 'Missouri', 'Montana', 'Nebraska', 'Nevada', 'New Hampshire', 'New Jersey', 'New Mexico', 'New York', 'North Carolina', 'North Dakota', 'Ohio', 'Oklahoma', 'Oregon', 'Pennsylvania', 'Rhode Island', 'South Carolina', 'South Dakota', 'Tennessee', 'Texas', 'Utah', 'Vermont', 'Virginia', 'Washington', 'West Virginia', 'Wisconsin', 'Wyoming',
16 |     ];
17 |     protected static array $stateAbbr               = [
18 |         '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',
19 |     ];
20 |     protected static array $country                 = [
21 |         'Afghanistan', 'Albania', 'Algeria', 'American Samoa', 'Andorra', 'Angola', 'Anguilla', 'Antarctica (the territory South of 60 deg S)', 'Antigua and Barbuda', 'Argentina', 'Armenia', 'Aruba', 'Australia', 'Austria', 'Azerbaijan',
22 |         'Bahamas', 'Bahrain', 'Bangladesh', 'Barbados', 'Belarus', 'Belgium', 'Belize', 'Benin', 'Bermuda', 'Bhutan', 'Bolivia', 'Bosnia and Herzegovina', 'Botswana', 'Bouvet Island (Bouvetoya)', 'Brazil', 'British Indian Ocean Territory (Chagos Archipelago)', 'British Virgin Islands', 'Brunei Darussalam', 'Bulgaria', 'Burkina Faso', 'Burundi',
23 |         'Cambodia', 'Cameroon', 'Canada', 'Cape Verde', 'Cayman Islands', 'Central African Republic', 'Chad', 'Chile', 'China', 'Christmas Island', 'Cocos (Keeling) Islands', 'Colombia', 'Comoros', 'Congo', 'Cook Islands', 'Costa Rica', 'Cote d\'Ivoire', 'Croatia', 'Cuba', 'Cyprus', 'Czech Republic',
24 |         'Denmark', 'Djibouti', 'Dominica', 'Dominican Republic',
25 |         'Ecuador', 'Egypt', 'El Salvador', 'Equatorial Guinea', 'Eritrea', 'Estonia', 'Ethiopia',
26 |         'Faroe Islands', 'Falkland Islands (Malvinas)', 'Fiji', 'Finland', 'France', 'French Guiana', 'French Polynesia', 'French Southern Territories',
27 |         'Gabon', 'Gambia', 'Georgia', 'Germany', 'Ghana', 'Gibraltar', 'Greece', 'Greenland', 'Grenada', 'Guadeloupe', 'Guam', 'Guatemala', 'Guernsey', 'Guinea', 'Guinea-Bissau', 'Guyana',
28 |         'Haiti', 'Heard Island and McDonald Islands', 'Holy See (Vatican City State)', 'Honduras', 'Hong Kong', 'Hungary',
29 |         'Iceland', 'India', 'Indonesia', 'Iran', 'Iraq', 'Ireland', 'Isle of Man', 'Israel', 'Italy',
30 |         'Jamaica', 'Japan', 'Jersey', 'Jordan',
31 |         'Kazakhstan', 'Kenya', 'Kiribati', 'Korea', 'Korea', 'Kuwait', 'Kyrgyz Republic',
32 |         'Lao People\'s Democratic Republic', 'Latvia', 'Lebanon', 'Lesotho', 'Liberia', 'Libyan Arab Jamahiriya', 'Liechtenstein', 'Lithuania', 'Luxembourg',
33 |         'Macao', 'Macedonia', 'Madagascar', 'Malawi', 'Malaysia', 'Maldives', 'Mali', 'Malta', 'Marshall Islands', 'Martinique', 'Mauritania', 'Mauritius', 'Mayotte', 'Mexico', 'Micronesia', 'Moldova', 'Monaco', 'Mongolia', 'Montenegro', 'Montserrat', 'Morocco', 'Mozambique', 'Myanmar',
34 |         'Namibia', 'Nauru', 'Nepal', 'Netherlands Antilles', 'Netherlands', 'New Caledonia', 'New Zealand', 'Nicaragua', 'Niger', 'Nigeria', 'Niue', 'Norfolk Island', 'Northern Mariana Islands', 'Norway',
35 |         'Oman',
36 |         'Pakistan', 'Palau', 'Palestinian Territories', 'Panama', 'Papua New Guinea', 'Paraguay', 'Peru', 'Philippines', 'Pitcairn Islands', 'Poland', 'Portugal', 'Puerto Rico',
37 |         'Qatar',
38 |         'Reunion', 'Romania', 'Russian Federation', 'Rwanda',
39 |         'Saint Barthelemy', 'Saint Helena', 'Saint Kitts and Nevis', 'Saint Lucia', 'Saint Martin', 'Saint Pierre and Miquelon', 'Saint Vincent and the Grenadines', 'Samoa', 'San Marino', 'Sao Tome and Principe', 'Saudi Arabia', 'Senegal', 'Serbia', 'Seychelles', 'Sierra Leone', 'Singapore', 'Slovakia (Slovak Republic)', 'Slovenia', 'Solomon Islands', 'Somalia', 'South Africa', 'South Georgia and the South Sandwich Islands', 'Spain', 'Sri Lanka', 'Sudan', 'Suriname', 'Svalbard & Jan Mayen Islands', 'Swaziland', 'Sweden', 'Switzerland', 'Syrian Arab Republic',
40 |         'Taiwan', 'Tajikistan', 'Tanzania', 'Thailand', 'Timor-Leste', 'Togo', 'Tokelau', 'Tonga', 'Trinidad and Tobago', 'Tunisia', 'Turkey', 'Turkmenistan', 'Turks and Caicos Islands', 'Tuvalu',
41 |         'Uganda', 'Ukraine', 'United Arab Emirates', 'United Kingdom', 'United States of America', 'United States Minor Outlying Islands', 'United States Virgin Islands', 'Uruguay', 'Uzbekistan',
42 |         'Vanuatu', 'Venezuela', 'Vietnam',
43 |         'Wallis and Futuna', 'Western Sahara',
44 |         'Yemen',
45 |         'Zambia', 'Zimbabwe',
46 |     ];
47 |     protected static array $cityFormats             = [
48 |         '{{cityPrefix}} {{firstName}}{{citySuffix}}',
49 |         '{{cityPrefix}} {{firstName}}',
50 |         '{{firstName}}{{citySuffix}}',
51 |         '{{lastName}}{{citySuffix}}',
52 |     ];
53 |     protected static array $streetNameFormats       = [
54 |         '{{firstName}} {{streetSuffix}}',
55 |         '{{lastName}} {{streetSuffix}}',
56 |     ];
57 |     protected static array $streetAddressFormats    = [
58 |         '{{buildingNumber}} {{streetName}}',
59 |         '{{buildingNumber}} {{streetName}} {{secondaryAddress}}',
60 |     ];
61 |     protected static array $addressFormats          = [
62 |         "{{streetAddress}}\n{{city}}, {{stateAbbr}} {{postcode}}",
63 |     ];
64 |     protected static array $secondaryAddressFormats = ['Apt. ###', 'Suite ###'];
65 | 
66 |     /**
67 |      * @example 'East'
68 |      */
69 |     public static function cityPrefix()
70 |     {
71 |         return static::randomElement(static::$cityPrefix);
72 |     }
73 | 
74 |     /**
75 |      * @example 'Appt. 350'
76 |      */
77 |     public static function secondaryAddress()
78 |     {
79 |         return static::numerify(static::randomElement(static::$secondaryAddressFormats));
80 |     }
81 | 
82 |     /**
83 |      * @example 'California'
84 |      */
85 |     public static function state()
86 |     {
87 |         return static::randomElement(static::$state);
88 |     }
89 | 
90 |     /**
91 |      * @example 'CA'
92 |      */
93 |     public static function stateAbbr()
94 |     {
95 |         return static::randomElement(static::$stateAbbr);
96 |     }
97 | }
98 | 


--------------------------------------------------------------------------------
/tests/index.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | 
  4 | use Poppy\Faker\Factory;
  5 | 
  6 | include dirname(__DIR__) . '/src/autoload.php';
  7 | 
  8 | $faker = Factory::create('zh_CN');
  9 | function py_faker_desc($desc, $code, $maxLength = 50, $simple = true)
 10 | {
 11 | 	$faker = Factory::create('zh_CN');
 12 | 	ob_start();
 13 | 	eval("\$result = $code;");
 14 | 	print_r($result);
 15 | 	$content = ob_get_clean();
 16 | 	$codeHl  = highlight_string($code, true);
 17 | 	$code    = str_pad($code, $maxLength + 3);
 18 | 	if ($simple) {
 19 | 		echo '// ' . $desc . PHP_EOL . $code . ' // ' . $content . PHP_EOL;
 20 | 	}
 21 | 	else {
 22 |         $content = htmlentities($content);
 23 | 		echo "<pre style='border-bottom: 1px solid #EFEFEF;line-height: 1.4;font-size: 13px;padding-bottom: 8px;'>
 24 | {$desc}{$codeHl}{$content}</pre>";
 25 | 	}
 26 | 
 27 | }
 28 | 
 29 | $md = isset($_GET['md']);
 30 | 
 31 | /**
 32 |  * @param      $title
 33 |  * @param      $items
 34 |  * @param bool $md
 35 |  */
 36 | function py_example($title, $items, $md = true)
 37 | {
 38 | 	if ($md) {
 39 | 		echo PHP_EOL . PHP_EOL . '### ' . $title . PHP_EOL . PHP_EOL;
 40 | 	}
 41 | 	else {
 42 | 		echo "<h2 style='border-bottom: 1px solid #EFEFEF;line-height: 1.4;font-size: 18px;height: 35px;'>{$title}</h2>";
 43 | 	}
 44 | 
 45 | 	if ($md) {
 46 | 		echo '```' . PHP_EOL;
 47 | 	}
 48 | 	$maxLength = 0;
 49 | 	foreach ($items as $item) {
 50 | 		$length    = strlen((string) $item[1]);
 51 | 		$maxLength = $length > $maxLength ? $length : $maxLength;
 52 | 	}
 53 | 
 54 | 	if ($maxLength > 50) {
 55 | 		$maxLength = 50;
 56 | 	}
 57 | 
 58 | 	foreach ($items as $item) {
 59 | 		py_faker_desc($item[0], (string) $item[1], $maxLength, $md);
 60 | 	}
 61 | 	if ($md) {
 62 | 		echo '```' . PHP_EOL;
 63 | 	}
 64 | }
 65 | 
 66 | 
 67 | py_example('Base', [
 68 | 	['生成随机整数 0 - 9', '$faker->randomDigit;'],
 69 | 	['生成唯一整数', '$faker->unique()->randomDigit;'],
 70 | 	['生成随机不为空的整数', '$faker->randomDigitNotNull;'],
 71 | 	['生成随机数字', '$faker->randomNumber($nbDigits = 5, $strict = false);'],
 72 | 	['生成随机浮点数', '$faker->randomFloat($nbMaxDecimals = null, $min = 0, $max = null);'],
 73 | 	['在指定范围内生成随机数', '$faker->numberBetween($min = 1000, $max = 9000);'],
 74 | 	['生成随机字符', '$faker->randomLetter;'],
 75 | 	['在给定的数组中,随机生成给定的个数字符', '$faker->randomElements($array = [\'a\', \'b\', \'c\'], $count = 2);'],
 76 | 	['在给定的数组中,生成单个随机字符', '$faker->randomElement($array = [\'a\', \'b\', \'c\']);'],
 77 | 	['打乱给定的字符串', '$faker->shuffle(\'hello, world\');'],
 78 | 	['打乱给定的数组', '$faker->shuffle([1, 2, 3]);'],
 79 | 	['给占位符生成随机整数 (数字为#)', '$faker->numerify(\'Hello ###\');'],
 80 | 	['给占位符生成随机字符串 (字符串为?)', '$faker->lexify(\'Hello ???\');'],
 81 | 	['给占位符生成混合的随机字符串', '$faker->bothify(\'Hello ##??\');'],
 82 | 	['给占位符生成随机的字符(字母、数字、符号)', '$faker->asciify(\'Hello ***\');'],
 83 | 	['根据正则规则生成随机字符', '$faker->regexify(\'[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}\');'],
 84 | ], $md);
 85 | 
 86 | 
 87 | py_example('Lorem', [
 88 | 	['生成随机个数的字符串', '$faker->word;'],
 89 | 	['随机生成指定个数的字符串', '$faker->words($nb = 3, $asText = false);'],
 90 | 	['随机生成一条语句', '$faker->sentence($nbWords = 6, $variableNbWords = true);'],
 91 | 	['随机生成指定条数的语句', '$faker->sentences($nb = 3, $asText = false);'],
 92 | 	['随机生成一个段落', '$faker->paragraph($nbSentences = 3, $variableNbSentences = true);'],
 93 | 	['随机生成指定个数段落', '$faker->paragraphs($nb = 3, $asText = false);'],
 94 | 	['随机生成一个文本', '$faker->text($maxNbChars = 200);'],
 95 | 	['随机生成一句诗词', '$faker->poem;'],
 96 | ], $md);
 97 | 
 98 | 
 99 | py_example('Person', [
100 | 	['职位', '$faker->title;'],
101 | 	['称谓', '$faker->titleMale;'],
102 | 	['女性称谓', '$faker->titleFemale;'],
103 | 	['姓名', '$faker->name'],
104 | 	['名字', '$faker->firstName'],
105 | 	['男性名字', '$faker->firstNameMale'],
106 | 	['女性名字', '$faker->firstNameFemale'],
107 | 	['姓', '$faker->lastName'],
108 | 	['随机生成一个可以校验的身份证号', '$faker->idNumber'],
109 | ], $md);
110 | 
111 | 
112 | py_example('Address', [
113 | 	['随机生成省份/州', '$faker->state;'],
114 | 	['随机城市省份/州缩写', '$faker->stateAbbr;'],
115 | 	['随机生成城市后缀', '$faker->citySuffix;'],
116 | 	['随机生成街道后缀', '$faker->streetSuffix;'],
117 | 	['随机生成建筑编号', '$faker->buildingNumber;'],
118 | 	['随机生成城市', '$faker->city;'],
119 | 	['随机生成街道名', '$faker->streetName; '],
120 | 	['随机生成街道地址', '$faker->streetAddress;'],
121 | 	['随机生成邮编', '$faker->postcode;'],
122 | 	['随机生成地址', '$faker->address;'],
123 | 	['随机生成国家', '$faker->country;'],
124 | 	['随机生成纬度', '$faker->latitude($min = -90, $max = 90);'],
125 | 	['随机生成经度', '$faker->longitude($min = -180, $max = 180);'],
126 | ], $md);
127 | 
128 | 
129 | py_example('Phone Number', [
130 | 	['生成随机电话号码', '$faker->phoneNumber;'],
131 | 	['随机生成e164电话', '$faker->e164PhoneNumber;'],
132 | ], $md);
133 | 
134 | 
135 | py_example('Company', [
136 | 	['随机生成公司', '$faker->company;'],
137 | 	['随机生成公司后缀', '$faker->companySuffix;'],
138 | 	['随机生成职务', '$faker->jobTitle;'],
139 | 	['随机生成广告语', '$faker->catchPhrase;'],
140 | ], $md);
141 | 
142 | 
143 | py_example('Text', [
144 | 	['随机生成一段文本', '$faker->realText($maxNbChars = 200, $indexSize = 2);'],
145 | ], $md);
146 | 
147 | 
148 | py_example('Datetime', [
149 | 	['随机生成时间戳', '$faker->unixTime($max = \'now\');'],
150 | 	['随机生成时间', '$faker->dateTime($max = \'now\', $timezone = date_default_timezone_get());'],
151 | 	[' dateTimeAd', '$faker->dateTimeAD;'],
152 | 	['随机生成ios8601时间', '$faker->iso8601($max = \'now\');'],
153 | 	['根据格式随机生成日期', '$faker->date($format = \'Y-m-d\', $max = \'now\');'],
154 | 	['根据格式随机生成时间', '$faker->time($format = \'H:i:s\', $max = \'now\');'],
155 | 	['生成指定范围的时间', '$faker->dateTimeBetween($startDate = \'-30 years\', $endDate = \'now\');'],
156 | 	['随机生成一个指定间隔的时间', '$faker->dateTimeInInterval($startDate = \'-30 years\', $interval = \'+ 5 days\', $timezone = date_default_timezone_get());'],
157 | 	['随机生成当前世纪的时间', '$faker->dateTimeThisCentury($max = \'now\', $timezone = date_default_timezone_get());'],
158 | 	['随机生成当前十年的时间', '$faker->dateTimeThisDecade($max = \'now\', $timezone = date_default_timezone_get());'],
159 | 	['随机生成当前年的时间', '$faker->dateTimeThisYear($max = \'now\', $timezone = date_default_timezone_get());'],
160 | 	['随机生成当前月的时间', '$faker->dateTimeThisMonth($max = \'now\', $timezone = date_default_timezone_get());'],
161 | 	['随机生成 am/pm', '$faker->amPm($max = \'now\');'],
162 | 	['随机生成月份的某一天', '$faker->dayOfMonth($max = \'now\');'],
163 | 	['随机生成星期', '$faker->dayOfWeek($max = \'now\');'],
164 | 	['随机生成月份', '$faker->month($max = \'now\');'],
165 | 	['随机生成月份的名称', '$faker->monthName($max = \'now\');'],
166 | 	['随机生成年份', '$faker->year($max = \'now\');'],
167 | 	['随机生成世纪', '$faker->century;'],
168 | 	['随机生成时区', '$faker->timezone;'],
169 | ], $md);
170 | 
171 | 
172 | py_example('Internet', [
173 | 	['随机生成邮箱地址', '$faker->email;'],
174 | 	['随机生成安全的邮箱地址', '$faker->safeEmail;'],
175 | 	['随机生成免费的邮箱地址', '$faker->freeEmail;'],
176 | 	['随机生成公司邮箱地址', '$faker->companyEmail;'],
177 | 	['随机生成免费邮箱域名', '$faker->freeEmailDomain;'],
178 | 	['随机生成安全邮箱域名', '$faker->safeEmailDomain;'],
179 | 	['随机生成用户名', '$faker->userName;'],
180 | 	['随机生成密码', '$faker->password;'],
181 | 	['随机生成域名', '$faker->domainName;'],
182 | 	['随机生成域', '$faker->domainWord;'],
183 | 	['todo Tld', '$faker->tld;'],
184 | 	['随机生成url地址', '$faker->url;'],
185 | 	['随机生成块', '$faker->slug;'],
186 | 	['随机生成ipv4地址', '$faker->ipv4;'],
187 | 	['随机生成本地ipv4地址', '$faker->localIpv4;'],
188 | 	['随机生成ipv6地址', '$faker->ipv6;'],
189 | 	['随机生成mac地址', '$faker->macAddress;'],
190 | ], $md);
191 | 
192 | 
193 | py_example('UserAgent', [
194 | 	['用户代理', '$faker->userAgent;'],
195 | 	['谷歌', '$faker->chrome;'],
196 | 	['火狐', '$faker->firefox; '],
197 | 	['Safari', '$faker->safari; '],
198 | 	['欧朋', '$faker->opera;'],
199 | 	['ie', '$faker->internetExplorer;'],
200 | ], $md);
201 | 
202 | 
203 | py_example('Payment', [
204 | 	['随机生成信用卡类型', '$faker->creditCardType;'],
205 | 	['随机生成信用卡号', '$faker->creditCardNumber;'],
206 | 	['随机生成信用卡有效日期', '$faker->creditCardExpirationDate;'],
207 | 	['随机生成信用卡有效日期', '$faker->creditCardExpirationDateString;'],
208 | 	['随机生成信用卡明细', '$faker->creditCardDetails;'],
209 | 	['随机生成国际银行账号', '$faker->iban($countryCode = null); '],
210 | 	['todo 瑞士银行账号', '$faker->swiftBicNumber; '],
211 | ], $md);
212 | 
213 | 
214 | py_example('Color', [
215 | 	['随机生成16进制颜色', '$faker->hexColor;'],
216 | 	['随机生成rgb格式的颜色', '$faker->rgbColor;'],
217 | 	['随机生成数组格式的rgb颜色', '$faker->rgbColorAsArray;'],
218 | 	['随机生成css格式的rgb颜色', '$faker->rgbCssColor;'],
219 | 	['随机生成颜色名称', '$faker->safeColorName; '],
220 | 	[' 颜色名称', '$faker->colorName;'],
221 | ], $md);
222 | 
223 | 
224 | py_example('File', [
225 | 	['随机生成文件扩展名', '$faker->fileExtension;'],
226 | 	['随机生成mime类型', '$faker->mimeType;'],
227 | ], $md);
228 | 
229 | 
230 | py_example('Image', [
231 | 	['随机生成图片地址', '$faker->imageUrl($width = 640, $height = 480);'],
232 | ], $md);
233 | 
234 | 
235 | py_example('UUID', [
236 | 	['随机生成一个唯一字串', '$faker->uuid'],
237 | ], $md);
238 | 
239 | 
240 | py_example('Calculator', [
241 | 	['随机生成13位ean码', '$faker->ean13;'],
242 | 	['随机生成8位ean码', '$faker->ean8;'],
243 | 	['随机生成13位isbn码', '$faker->isbn13;'],
244 | 	['随机生成10位isbn码', '$faker->isbn10;'],
245 | ], $md);
246 | 
247 | 
248 | py_example('Miscellaneous', [
249 | 	['随机生成bool值 false', '$faker->boolean;'],
250 | 	['平衡的生成bool值', '$faker->boolean($chanceOfGettingTrue = 50);'],
251 | 	[' Md5', '$faker->md5;'],
252 | 	[' Sha1', '$faker->sha1;'],
253 | 	[' Sha256', '$faker->sha256;'],
254 | 	[' Locale', '$faker->locale;'],
255 | 	['随机生成国家编码', '$faker->countryCode;'],
256 | 	['随机生成语言编码', '$faker->languageCode;'],
257 | 	['随机生成货币代码', '$faker->currencyCode;'],
258 | 	[' Emoji', '$faker->emoji;'],
259 | ], $md);
260 | 
261 | 
262 | py_example('Biased', [
263 | 	['在10到20之间得到一个随机数，有更多的几率接近20', '$faker->biasedNumberBetween($min = 10, $max = 20, $function = \'sqrt\');'],
264 | ], $md);
265 | 
266 | 
267 | py_example('Html', [
268 | 	['随机生成一个不超过 $maxDepth层的html, 任何级别上都不超过$maxWidth个元素', '$faker->randomHtml($maxDepth = 2, $maxWidth = 3);'],
269 | ], $md);
270 | 


--------------------------------------------------------------------------------
/src/Provider/HtmlLorem.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | use DOMDocument;
  6 | use DOMElement;
  7 | use Poppy\Faker\Generator;
  8 | use Poppy\Faker\UniqueGenerator;
  9 | 
 10 | class HtmlLorem extends Base
 11 | {
 12 | 
 13 |     const HTML_TAG  = "html";
 14 |     const HEAD_TAG  = "head";
 15 |     const BODY_TAG  = "body";
 16 |     const DIV_TAG   = "div";
 17 |     const P_TAG     = "p";
 18 |     const A_TAG     = "a";
 19 |     const SPAN_TAG  = "span";
 20 |     const TABLE_TAG = "table";
 21 |     const THEAD_TAG = "thead";
 22 |     const TBODY_TAG = "tbody";
 23 |     const TR_TAG    = "tr";
 24 |     const TD_TAG    = "td";
 25 |     const TH_TAG    = "th";
 26 |     const UL_TAG    = "ul";
 27 |     const LI_TAG    = "li";
 28 |     const H_TAG     = "h";
 29 |     const B_TAG     = "b";
 30 |     const I_TAG     = "i";
 31 |     const TITLE_TAG = "title";
 32 |     const FORM_TAG  = "form";
 33 |     const INPUT_TAG = "input";
 34 |     const LABEL_TAG = "label";
 35 | 
 36 |     private $idGenerator;
 37 | 
 38 |     public function __construct(Generator $generator)
 39 |     {
 40 |         parent::__construct($generator);
 41 |         $generator->addProvider(new Lorem($generator));
 42 |         $generator->addProvider(new Internet($generator));
 43 |     }
 44 | 
 45 |     /**
 46 |      * @param integer $maxDepth
 47 |      * @param integer $maxWidth
 48 |      *
 49 |      * @return string
 50 |      */
 51 |     public function randomHtml($maxDepth = 4, $maxWidth = 4)
 52 |     {
 53 |         $document          = new DOMDocument();
 54 |         $this->idGenerator = new UniqueGenerator($this->generator);
 55 | 
 56 |         $head = $document->createElement("head");
 57 |         $this->addRandomTitle($head);
 58 | 
 59 |         $body = $document->createElement("body");
 60 |         $this->addLoginForm($body);
 61 |         $this->addRandomSubTree($body, $maxDepth, $maxWidth);
 62 | 
 63 |         $html = $document->createElement("html");
 64 |         $html->appendChild($head);
 65 |         $html->appendChild($body);
 66 | 
 67 |         $document->appendChild($html);
 68 |         return $document->saveHTML();
 69 |     }
 70 | 
 71 |     private function addRandomSubTree(DOMElement $root, $maxDepth, $maxWidth)
 72 |     {
 73 |         $maxDepth--;
 74 |         if ($maxDepth <= 0) {
 75 |             return $root;
 76 |         }
 77 | 
 78 |         $siblings = mt_rand(1, $maxWidth);
 79 |         for ($i = 0; $i < $siblings; $i++) {
 80 |             if ($maxDepth == 1) {
 81 |                 $this->addRandomLeaf($root);
 82 |             }
 83 |             else {
 84 |                 $sibling = $root->ownerDocument->createElement("div");
 85 |                 $root->appendChild($sibling);
 86 |                 $this->addRandomAttribute($sibling);
 87 |                 $this->addRandomSubTree($sibling, mt_rand(0, $maxDepth), $maxWidth);
 88 |             }
 89 |         }
 90 |         return $root;
 91 |     }
 92 | 
 93 |     private function addRandomLeaf(DOMElement $node)
 94 |     {
 95 |         $rand = mt_rand(1, 10);
 96 |         switch ($rand) {
 97 |             case 1:
 98 |                 $this->addRandomP($node);
 99 |                 break;
100 |             case 2:
101 |                 $this->addRandomA($node);
102 |                 break;
103 |             case 3:
104 |                 $this->addRandomSpan($node);
105 |                 break;
106 |             case 4:
107 |                 $this->addRandomUL($node);
108 |                 break;
109 |             case 5:
110 |                 $this->addRandomH($node);
111 |                 break;
112 |             case 6:
113 |                 $this->addRandomB($node);
114 |                 break;
115 |             case 7:
116 |                 $this->addRandomI($node);
117 |                 break;
118 |             case 8:
119 |                 $this->addRandomTable($node);
120 |                 break;
121 |             default:
122 |                 $this->addRandomText($node);
123 |                 break;
124 |         }
125 |     }
126 | 
127 |     private function addRandomAttribute(DOMElement $node)
128 |     {
129 |         $rand = mt_rand(1, 2);
130 |         switch ($rand) {
131 |             case 1:
132 |                 $node->setAttribute("class", $this->generator->word);
133 |                 break;
134 |             case 2:
135 |                 $node->setAttribute("id", (string) $this->idGenerator->randomNumber(5));
136 |                 break;
137 |         }
138 |     }
139 | 
140 |     private function addRandomP(DOMElement $element, $maxLength = 10)
141 |     {
142 | 
143 |         $node              = $element->ownerDocument->createElement(static::P_TAG);
144 |         $node->textContent = $this->generator->sentence(mt_rand(1, $maxLength));
145 |         $element->appendChild($node);
146 |     }
147 | 
148 |     private function addRandomText(DOMElement $element, $maxLength = 10)
149 |     {
150 |         $text = $element->ownerDocument->createTextNode($this->generator->sentence(mt_rand(1, $maxLength)));
151 |         $element->appendChild($text);
152 |     }
153 | 
154 |     private function addRandomA(DOMElement $element, $maxLength = 10)
155 |     {
156 |         $text = $element->ownerDocument->createTextNode($this->generator->sentence(mt_rand(1, $maxLength)));
157 |         $node = $element->ownerDocument->createElement(static::A_TAG);
158 |         $node->setAttribute("href", $this->generator->safeEmailDomain);
159 |         $node->appendChild($text);
160 |         $element->appendChild($node);
161 |     }
162 | 
163 |     private function addRandomTitle(DOMElement $element, $maxLength = 10)
164 |     {
165 |         $text = $element->ownerDocument->createTextNode($this->generator->sentence(mt_rand(1, $maxLength)));
166 |         $node = $element->ownerDocument->createElement(static::TITLE_TAG);
167 |         $node->appendChild($text);
168 |         $element->appendChild($node);
169 |     }
170 | 
171 |     private function addRandomH(DOMElement $element, $maxLength = 10)
172 |     {
173 |         $h    = static::H_TAG . (string) mt_rand(1, 3);
174 |         $text = $element->ownerDocument->createTextNode($this->generator->sentence(mt_rand(1, $maxLength)));
175 |         $node = $element->ownerDocument->createElement($h);
176 |         $node->appendChild($text);
177 |         $element->appendChild($node);
178 |     }
179 | 
180 |     private function addRandomB(DOMElement $element, $maxLength = 10)
181 |     {
182 |         $text = $element->ownerDocument->createTextNode($this->generator->sentence(mt_rand(1, $maxLength)));
183 |         $node = $element->ownerDocument->createElement(static::B_TAG);
184 |         $node->appendChild($text);
185 |         $element->appendChild($node);
186 |     }
187 | 
188 |     private function addRandomI(DOMElement $element, $maxLength = 10)
189 |     {
190 |         $text = $element->ownerDocument->createTextNode($this->generator->sentence(mt_rand(1, $maxLength)));
191 |         $node = $element->ownerDocument->createElement(static::I_TAG);
192 |         $node->appendChild($text);
193 |         $element->appendChild($node);
194 |     }
195 | 
196 |     private function addRandomSpan(DOMElement $element, $maxLength = 10)
197 |     {
198 |         $text = $element->ownerDocument->createTextNode($this->generator->sentence(mt_rand(1, $maxLength)));
199 |         $node = $element->ownerDocument->createElement(static::SPAN_TAG);
200 |         $node->appendChild($text);
201 |         $element->appendChild($node);
202 |     }
203 | 
204 |     private function addLoginForm(DOMElement $element)
205 |     {
206 | 
207 |         $textInput = $element->ownerDocument->createElement(static::INPUT_TAG);
208 |         $textInput->setAttribute("type", "text");
209 |         $textInput->setAttribute("id", "username");
210 | 
211 |         $textLabel = $element->ownerDocument->createElement(static::LABEL_TAG);
212 |         $textLabel->setAttribute("for", "username");
213 |         $textLabel->textContent = $this->generator->word;
214 | 
215 |         $passwordInput = $element->ownerDocument->createElement(static::INPUT_TAG);
216 |         $passwordInput->setAttribute("type", "password");
217 |         $passwordInput->setAttribute("id", "password");
218 | 
219 |         $passwordLabel = $element->ownerDocument->createElement(static::LABEL_TAG);
220 |         $passwordLabel->setAttribute("for", "password");
221 |         $passwordLabel->textContent = $this->generator->word;
222 | 
223 |         $submit = $element->ownerDocument->createElement(static::INPUT_TAG);
224 |         $submit->setAttribute("type", "submit");
225 |         $submit->setAttribute("value", $this->generator->word);
226 | 
227 |         $submit = $element->ownerDocument->createElement(static::FORM_TAG);
228 |         $submit->setAttribute("action", $this->generator->safeEmailDomain);
229 |         $submit->setAttribute("method", "POST");
230 |         $submit->appendChild($textLabel);
231 |         $submit->appendChild($textInput);
232 |         $submit->appendChild($passwordLabel);
233 |         $submit->appendChild($passwordInput);
234 |         $element->appendChild($submit);
235 |     }
236 | 
237 |     private function addRandomTable(DOMElement $element, $maxRows = 10, $maxCols = 6, $maxTitle = 4, $maxLength = 10)
238 |     {
239 |         $rows = mt_rand(1, $maxRows);
240 |         $cols = mt_rand(1, $maxCols);
241 | 
242 |         $table = $element->ownerDocument->createElement(static::TABLE_TAG);
243 |         $thead = $element->ownerDocument->createElement(static::THEAD_TAG);
244 |         $tbody = $element->ownerDocument->createElement(static::TBODY_TAG);
245 | 
246 |         $table->appendChild($thead);
247 |         $table->appendChild($tbody);
248 | 
249 |         $tr = $element->ownerDocument->createElement(static::TR_TAG);
250 |         $thead->appendChild($tr);
251 |         for ($i = 0; $i < $cols; $i++) {
252 |             $th              = $element->ownerDocument->createElement(static::TH_TAG);
253 |             $th->textContent = $this->generator->sentence(mt_rand(1, $maxTitle));
254 |             $tr->appendChild($th);
255 |         }
256 |         for ($i = 0; $i < $rows; $i++) {
257 |             $tr = $element->ownerDocument->createElement(static::TR_TAG);
258 |             $tbody->appendChild($tr);
259 |             for ($j = 0; $j < $cols; $j++) {
260 |                 $th              = $element->ownerDocument->createElement(static::TD_TAG);
261 |                 $th->textContent = $this->generator->sentence(mt_rand(1, $maxLength));
262 |                 $tr->appendChild($th);
263 |             }
264 |         }
265 |         $element->appendChild($table);
266 |     }
267 | 
268 |     private function addRandomUL(DOMElement $element, $maxItems = 11, $maxLength = 4)
269 |     {
270 |         $num = mt_rand(1, $maxItems);
271 |         $ul  = $element->ownerDocument->createElement(static::UL_TAG);
272 |         for ($i = 0; $i < $num; $i++) {
273 |             $li              = $element->ownerDocument->createElement(static::LI_TAG);
274 |             $li->textContent = $this->generator->sentence(mt_rand(1, $maxLength));
275 |             $ul->appendChild($li);
276 |         }
277 |         $element->appendChild($ul);
278 |     }
279 | }
280 | 


--------------------------------------------------------------------------------
/src/Provider/Payment.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker\Provider;
  4 | 
  5 | use Poppy\Faker\Calculator\Iban;
  6 | use Poppy\Faker\Calculator\Luhn;
  7 | 
  8 | class Payment extends Base
  9 | {
 10 |     public static string $expirationDateFormat = "m/y";
 11 | 
 12 |     protected static array $cardVendors = [
 13 |         'Visa', 'Visa', 'Visa', 'Visa', 'Visa',
 14 |         'MasterCard', 'MasterCard', 'MasterCard', 'MasterCard', 'MasterCard',
 15 |         'American Express', 'Discover Card', 'Visa Retired',
 16 |     ];
 17 | 
 18 |     /**
 19 |      * @var array List of card brand masks for generating valid credit card numbers
 20 |      * @see https://en.wikipedia.org/wiki/Payment_card_number Reference for existing prefixes
 21 |      * @see https://www.mastercard.us/en-us/issuers/get-support/2-series-bin-expansion.html MasterCard 2017 2-Series BIN Expansion
 22 |      */
 23 |     protected static array $cardParams = [
 24 |         'Visa'             => [
 25 |             "4539###########",
 26 |             "4556###########",
 27 |             "4916###########",
 28 |             "4532###########",
 29 |             "4929###########",
 30 |             "40240071#######",
 31 |             "4485###########",
 32 |             "4716###########",
 33 |             "4##############",
 34 |         ],
 35 |         'Visa Retired'     => [
 36 |             "4539########",
 37 |             "4556########",
 38 |             "4916########",
 39 |             "4532########",
 40 |             "4929########",
 41 |             "40240071####",
 42 |             "4485########",
 43 |             "4716########",
 44 |             "4###########",
 45 |         ],
 46 |         'MasterCard'       => [
 47 |             "2221###########",
 48 |             "23#############",
 49 |             "24#############",
 50 |             "25#############",
 51 |             "26#############",
 52 |             "2720###########",
 53 |             "51#############",
 54 |             "52#############",
 55 |             "53#############",
 56 |             "54#############",
 57 |             "55#############",
 58 |         ],
 59 |         'American Express' => [
 60 |             "34############",
 61 |             "37############",
 62 |         ],
 63 |         'Discover Card'    => [
 64 |             "6011###########",
 65 |         ],
 66 |     ];
 67 | 
 68 |     /**
 69 |      * @var array list of IBAN formats, source: @link https://www.swift.com/standards/data-standards/iban
 70 |      */
 71 |     protected static $ibanFormats = [
 72 |         'AD' => [['n', 4], ['n', 4], ['c', 12]],
 73 |         'AE' => [['n', 3], ['n', 16]],
 74 |         'AL' => [['n', 8], ['c', 16]],
 75 |         'AT' => [['n', 5], ['n', 11]],
 76 |         'AZ' => [['a', 4], ['c', 20]],
 77 |         'BA' => [['n', 3], ['n', 3], ['n', 8], ['n', 2]],
 78 |         'BE' => [['n', 3], ['n', 7], ['n', 2]],
 79 |         'BG' => [['a', 4], ['n', 4], ['n', 2], ['c', 8]],
 80 |         'BH' => [['a', 4], ['c', 14]],
 81 |         'BR' => [['n', 8], ['n', 5], ['n', 10], ['a', 1], ['c', 1]],
 82 |         'CH' => [['n', 5], ['c', 12]],
 83 |         'CR' => [['n', 4], ['n', 14]],
 84 |         'CY' => [['n', 3], ['n', 5], ['c', 16]],
 85 |         'CZ' => [['n', 4], ['n', 6], ['n', 10]],
 86 |         'DE' => [['n', 8], ['n', 10]],
 87 |         'DK' => [['n', 4], ['n', 9], ['n', 1]],
 88 |         'DO' => [['c', 4], ['n', 20]],
 89 |         'EE' => [['n', 2], ['n', 2], ['n', 11], ['n', 1]],
 90 |         'ES' => [['n', 4], ['n', 4], ['n', 1], ['n', 1], ['n', 10]],
 91 |         'FI' => [['n', 6], ['n', 7], ['n', 1]],
 92 |         'FR' => [['n', 5], ['n', 5], ['c', 11], ['n', 2]],
 93 |         'GB' => [['a', 4], ['n', 6], ['n', 8]],
 94 |         'GE' => [['a', 2], ['n', 16]],
 95 |         'GI' => [['a', 4], ['c', 15]],
 96 |         'GR' => [['n', 3], ['n', 4], ['c', 16]],
 97 |         'GT' => [['c', 4], ['c', 20]],
 98 |         'HR' => [['n', 7], ['n', 10]],
 99 |         'HU' => [['n', 3], ['n', 4], ['n', 1], ['n', 15], ['n', 1]],
100 |         'IE' => [['a', 4], ['n', 6], ['n', 8]],
101 |         'IL' => [['n', 3], ['n', 3], ['n', 13]],
102 |         'IS' => [['n', 4], ['n', 2], ['n', 6], ['n', 10]],
103 |         'IT' => [['a', 1], ['n', 5], ['n', 5], ['c', 12]],
104 |         'KW' => [['a', 4], ['n', 22]],
105 |         'KZ' => [['n', 3], ['c', 13]],
106 |         'LB' => [['n', 4], ['c', 20]],
107 |         'LI' => [['n', 5], ['c', 12]],
108 |         'LT' => [['n', 5], ['n', 11]],
109 |         'LU' => [['n', 3], ['c', 13]],
110 |         'LV' => [['a', 4], ['c', 13]],
111 |         'MC' => [['n', 5], ['n', 5], ['c', 11], ['n', 2]],
112 |         'MD' => [['c', 2], ['c', 18]],
113 |         'ME' => [['n', 3], ['n', 13], ['n', 2]],
114 |         'MK' => [['n', 3], ['c', 10], ['n', 2]],
115 |         'MR' => [['n', 5], ['n', 5], ['n', 11], ['n', 2]],
116 |         'MT' => [['a', 4], ['n', 5], ['c', 18]],
117 |         'MU' => [['a', 4], ['n', 2], ['n', 2], ['n', 12], ['n', 3], ['a', 3]],
118 |         'NL' => [['a', 4], ['n', 10]],
119 |         'NO' => [['n', 4], ['n', 6], ['n', 1]],
120 |         'PK' => [['a', 4], ['c', 16]],
121 |         'PL' => [['n', 8], ['n', 16]],
122 |         'PS' => [['a', 4], ['c', 21]],
123 |         'PT' => [['n', 4], ['n', 4], ['n', 11], ['n', 2]],
124 |         'RO' => [['a', 4], ['c', 16]],
125 |         'RS' => [['n', 3], ['n', 13], ['n', 2]],
126 |         'SA' => [['n', 2], ['c', 18]],
127 |         'SE' => [['n', 3], ['n', 16], ['n', 1]],
128 |         'SI' => [['n', 5], ['n', 8], ['n', 2]],
129 |         'SK' => [['n', 4], ['n', 6], ['n', 10]],
130 |         'SM' => [['a', 1], ['n', 5], ['n', 5], ['c', 12]],
131 |         'TN' => [['n', 2], ['n', 3], ['n', 13], ['n', 2]],
132 |         'TR' => [['n', 5], ['n', 1], ['c', 16]],
133 |         'VG' => [['a', 4], ['n', 16]],
134 |     ];
135 | 
136 |     /**
137 |      * @return string Returns a credit card vendor name
138 |      *
139 |      * @example 'MasterCard'
140 |      */
141 |     public static function creditCardType()
142 |     {
143 |         return static::randomElement(static::$cardVendors);
144 |     }
145 | 
146 |     /**
147 |      * Returns the String of a credit card number.
148 |      *
149 |      * @param string  $type      Supporting any of 'Visa', 'MasterCard', 'American Express', and 'Discover'
150 |      * @param boolean $formatted Set to true if the output string should contain one separator every 4 digits
151 |      * @param string  $separator Separator string for formatting card number. Defaults to dash (-).
152 |      * @return string
153 |      *
154 |      * @example '4485480221084675'
155 |      */
156 |     public static function creditCardNumber($type = null, $formatted = false, $separator = '-')
157 |     {
158 |         if (is_null($type)) {
159 |             $type = static::creditCardType();
160 |         }
161 |         $mask = static::randomElement(static::$cardParams[$type]);
162 | 
163 |         $number = static::numerify($mask);
164 |         $number .= Luhn::computeCheckDigit($number);
165 | 
166 |         if ($formatted) {
167 |             $p1     = substr($number, 0, 4);
168 |             $p2     = substr($number, 4, 4);
169 |             $p3     = substr($number, 8, 4);
170 |             $p4     = substr($number, 12);
171 |             $number = $p1 . $separator . $p2 . $separator . $p3 . $separator . $p4;
172 |         }
173 | 
174 |         return $number;
175 |     }
176 | 
177 |     /**
178 |      * @param boolean $valid True (by default) to get a valid expiration date, false to get a maybe valid date
179 |      * @return \DateTime
180 |      * @example 04/13
181 |      */
182 |     public function creditCardExpirationDate($valid = true)
183 |     {
184 |         if ($valid) {
185 |             return $this->generator->dateTimeBetween('now', '36 months');
186 |         }
187 | 
188 |         return $this->generator->dateTimeBetween('-36 months', '36 months');
189 |     }
190 | 
191 |     /**
192 |      * @param boolean $valid True (by default) to get a valid expiration date, false to get a maybe valid date
193 |      * @param string  $expirationDateFormat
194 |      * @return string
195 |      * @example '04/13'
196 |      */
197 |     public function creditCardExpirationDateString($valid = true, $expirationDateFormat = null)
198 |     {
199 |         return $this->creditCardExpirationDate($valid)->format(is_null($expirationDateFormat) ? static::$expirationDateFormat : $expirationDateFormat);
200 |     }
201 | 
202 |     /**
203 |      * @param boolean $valid True (by default) to get a valid expiration date, false to get a maybe valid date
204 |      * @return array
205 |      */
206 |     public function creditCardDetails($valid = true)
207 |     {
208 |         $type = static::creditCardType();
209 | 
210 |         return [
211 |             'type'           => $type,
212 |             'number'         => static::creditCardNumber($type),
213 |             'name'           => $this->generator->name(),
214 |             'expirationDate' => $this->creditCardExpirationDateString($valid),
215 |         ];
216 |     }
217 | 
218 |     /**
219 |      * International Bank Account Number (IBAN)
220 |      *
221 |      * @link http://en.wikipedia.org/wiki/International_Bank_Account_Number
222 |      * @param string  $countryCode ISO 3166-1 alpha-2 country code
223 |      * @param string  $prefix      for generating bank account number of a specific bank
224 |      * @param integer $length      total length without country code and 2 check digits
225 |      * @return string
226 |      */
227 |     public static function iban($countryCode = null, $prefix = '', $length = null)
228 |     {
229 |         $countryCode = is_null($countryCode) ? self::randomKey(self::$ibanFormats) : strtoupper($countryCode);
230 | 
231 |         $format = !isset(static::$ibanFormats[$countryCode]) ? null : static::$ibanFormats[$countryCode];
232 |         if ($length === null) {
233 |             if ($format === null) {
234 |                 $length = 24;
235 |             }
236 |             else {
237 |                 $length = 0;
238 |                 foreach ($format as $part) {
239 |                     [$class, $groupCount] = $part;
240 |                     $length += $groupCount;
241 |                 }
242 |             }
243 |         }
244 |         if ($format === null) {
245 |             $format = [['n', $length]];
246 |         }
247 | 
248 |         $expandedFormat = '';
249 |         foreach ($format as $item) {
250 |             [$class, $length] = $item;
251 |             $expandedFormat .= str_repeat($class, $length);
252 |         }
253 | 
254 |         $result         = $prefix;
255 |         $expandedFormat = substr($expandedFormat, strlen($result));
256 |         foreach (str_split($expandedFormat) as $class) {
257 |             switch ($class) {
258 |                 default:
259 |                 case 'c':
260 |                     $result .= mt_rand(0, 100) <= 50 ? static::randomDigit() : strtoupper(static::randomLetter());
261 |                     break;
262 |                 case 'a':
263 |                     $result .= strtoupper(static::randomLetter());
264 |                     break;
265 |                 case 'n':
266 |                     $result .= static::randomDigit();
267 |                     break;
268 |             }
269 |         }
270 | 
271 |         $checksum = Iban::checksum($countryCode . '00' . $result);
272 | 
273 |         return $countryCode . $checksum . $result;
274 |     }
275 | 
276 |     /**
277 |      * Return the String of a SWIFT/BIC number
278 |      *
279 |      * @return  string Swift/Bic number
280 |      * @link    http://en.wikipedia.org/wiki/ISO_9362
281 |      * @example 'RZTIAT22263'
282 |      */
283 |     public static function swiftBicNumber()
284 |     {
285 |         return self::regexify("^([A-Z]){4}([A-Z]){2}([0-9A-Z]){2}([0-9A-Z]{3})?$");
286 |     }
287 | }
288 | 


--------------------------------------------------------------------------------
/src/Generator.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace Poppy\Faker;
  4 | 
  5 | use DateTime;
  6 | use InvalidArgumentException;
  7 | 
  8 | /**
  9 |  * @property string       $name
 10 |  * @method string name(string $gender = null)
 11 |  * @property string       $firstName
 12 |  * @method string firstName(string $gender = null)
 13 |  * @property string       $firstNameMale
 14 |  * @property string       $firstNameFemale
 15 |  * @property string       $lastName
 16 |  * @property string       $title
 17 |  * @method string title(string $gender = null)
 18 |  * @property string       $titleMale
 19 |  * @property string       $titleFemale
 20 |  * @property string       $idNumber
 21 |  *
 22 |  * @property string       $citySuffix
 23 |  * @property string       $cityPrefix
 24 |  * @property string       $streetSuffix
 25 |  * @property string       $buildingNumber
 26 |  * @property string       $city
 27 |  * @property string       $streetName
 28 |  * @property string       $streetAddress
 29 |  * @property string       $secondaryAddress
 30 |  * @property string       $postcode
 31 |  * @property string       $address
 32 |  * @property string       $state
 33 |  * @property string       $country
 34 |  * @method  float        latitude($min = -85.05, $max = 85.05)
 35 |  * @method  float        longitude($min = -180, $max = 180)
 36 |  *
 37 |  * @property string       $ean13
 38 |  * @property string       $ean8
 39 |  * @property string       $isbn13
 40 |  * @property string       $isbn10
 41 |  *
 42 |  * @property string       $phoneNumber
 43 |  * @property string       $e164PhoneNumber
 44 |  *
 45 |  * @property string       $catchPhrase
 46 |  * @property string       $bs
 47 |  * @property string       $company
 48 |  * @property string       $companySuffix
 49 |  * @property string       $jobTitle
 50 |  *
 51 |  * @property string       $creditCardType
 52 |  * @property string       $creditCardNumber
 53 |  * @method string creditCardNumber($type = null, $formatted = false, $separator = '-')
 54 |  * @property DateTime     $creditCardExpirationDate
 55 |  * @property string       $creditCardExpirationDateString
 56 |  * @property array        $creditCardDetails
 57 |  * @property string       $bankAccountNumber
 58 |  * @method string iban($countryCode = null, $prefix = '', $length = null)
 59 |  * @property string       $swiftBicNumber
 60 |  * @property string       $vat
 61 |  *
 62 |  * @property string       $word
 63 |  * @property string|array $words
 64 |  * @method string|array words($nb = 3, $asText = false)
 65 |  * @method string word()
 66 |  * @property string       $sentence
 67 |  * @method string sentence($nbWords = 6, $variableNbWords = true)
 68 |  * @property string|array $sentences
 69 |  * @method string|array sentences($nb = 3, $asText = false)
 70 |  * @property string       $paragraph
 71 |  * @method string paragraph($nbSentences = 3, $variableNbSentences = true)
 72 |  * @property string|array $paragraphs
 73 |  * @method string|array paragraphs($nb = 3, $asText = false)
 74 |  * @property string       $text
 75 |  * @method string text($maxNbChars = 200)
 76 |  *
 77 |  * @method string realText($maxNbChars = 200, $indexSize = 2)
 78 |  *
 79 |  * @property string       $email
 80 |  * @property string       $safeEmail
 81 |  * @property string       $freeEmail
 82 |  * @property string       $companyEmail
 83 |  * @property string       $freeEmailDomain
 84 |  * @property string       $safeEmailDomain
 85 |  * @property string       $userName
 86 |  * @property string       $password
 87 |  * @method string password($minLength = 6, $maxLength = 20)
 88 |  * @property string       $domainName
 89 |  * @property string       $domainWord
 90 |  * @property string       $tld
 91 |  * @property string       $url
 92 |  * @property string       $slug
 93 |  * @method string slug($nbWords = 6, $variableNbWords = true)
 94 |  * @property string       $ipv4
 95 |  * @property string       $ipv6
 96 |  * @property string       $localIpv4
 97 |  * @property string       $macAddress
 98 |  *
 99 |  * @property int          $unixTime
100 |  * @property DateTime     $dateTime
101 |  * @property DateTime     $dateTimeAD
102 |  * @property string       $iso8601
103 |  * @property DateTime     $dateTimeThisCentury
104 |  * @property DateTime     $dateTimeThisDecade
105 |  * @property DateTime     $dateTimeThisYear
106 |  * @property DateTime     $dateTimeThisMonth
107 |  * @property string       $amPm
108 |  * @property string       $dayOfMonth
109 |  * @property string       $dayOfWeek
110 |  * @property string       $month
111 |  * @property string       $monthName
112 |  * @property string       $year
113 |  * @property string       $century
114 |  * @property string       $timezone
115 |  * @method string amPm($max = 'now')
116 |  * @method string date($format = 'Y-m-d', $max = 'now')
117 |  * @method string dayOfMonth($max = 'now')
118 |  * @method string dayOfWeek($max = 'now')
119 |  * @method string iso8601($max = 'now')
120 |  * @method string month($max = 'now')
121 |  * @method string monthName($max = 'now')
122 |  * @method string time($format = 'H:i:s', $max = 'now')
123 |  * @method int unixTime($max = 'now')
124 |  * @method string year($max = 'now')
125 |  * @method DateTime dateTime($max = 'now', $timezone = null)
126 |  * @method DateTime dateTimeAd($max = 'now', $timezone = null)
127 |  * @method DateTime dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null)
128 |  * @method DateTime dateTimeInInterval($date = '-30 years', $interval = '+5 days', $timezone = null)
129 |  * @method DateTime dateTimeThisCentury($max = 'now', $timezone = null)
130 |  * @method DateTime dateTimeThisDecade($max = 'now', $timezone = null)
131 |  * @method DateTime dateTimeThisYear($max = 'now', $timezone = null)
132 |  * @method DateTime dateTimeThisMonth($max = 'now', $timezone = null)
133 |  *
134 |  * @property string       $md5
135 |  * @property string       $sha1
136 |  * @property string       $sha256
137 |  * @property string       $locale
138 |  * @property string       $countryCode
139 |  * @property string       $countryISOAlpha3
140 |  * @property string       $languageCode
141 |  * @property string       $currencyCode
142 |  * @property boolean      $boolean
143 |  * @method boolean boolean($chanceOfGettingTrue = 50)
144 |  *
145 |  * @property int          $randomDigit
146 |  * @property int          $randomDigitNot
147 |  * @property int          $randomDigitNotNull
148 |  * @property string       $randomLetter
149 |  * @property string       $randomAscii
150 |  * @method int randomNumber($nbDigits = null, $strict = false)
151 |  * @method int|string|null randomKey(array $array = [])
152 |  * @method int numberBetween($min = 0, $max = 2147483647)
153 |  * @method float randomFloat($nbMaxDecimals = null, $min = 0, $max = null)
154 |  * @method mixed randomElement(array $array = ['a', 'b', 'c'])
155 |  * @method array randomElements(array $array = ['a', 'b', 'c'], $count = 1, $allowDuplicates = false)
156 |  * @method array|string shuffle($arg = '')
157 |  * @method array shuffleArray(array $array = [])
158 |  * @method string shuffleString($string = '', $encoding = 'UTF-8')
159 |  * @method string numerify($string = '###')
160 |  * @method string lexify($string = '????')
161 |  * @method string bothify($string = '## ??')
162 |  * @method string asciify($string = '****')
163 |  * @method string regexify($regex = '')
164 |  * @method string toLower($string = '')
165 |  * @method string toUpper($string = '')
166 |  * @method Generator optional($weight = 0.5, $default = null)
167 |  * @method Generator unique($reset = false, $maxRetries = 10000)
168 |  * @method Generator valid($validator = null, $maxRetries = 10000)
169 |  * @method mixed passthrough($passthrough)
170 |  *
171 |  * @method integer biasedNumberBetween($min = 0, $max = 100, $function = 'sqrt')
172 |  *
173 |  * @property string       $macProcessor
174 |  * @property string       $linuxProcessor
175 |  * @property string       $userAgent
176 |  * @property string       $chrome
177 |  * @property string       $firefox
178 |  * @property string       $safari
179 |  * @property string       $opera
180 |  * @property string       $internetExplorer
181 |  * @property string       $windowsPlatformToken
182 |  * @property string       $macPlatformToken
183 |  * @property string       $linuxPlatformToken
184 |  *
185 |  * @property string       $uuid
186 |  *
187 |  * @property string       $mimeType
188 |  * @property string       $fileExtension
189 |  * @method string file($sourceDirectory = '/tmp', $targetDirectory = '/tmp', $fullPath = true)
190 |  *
191 |  * @method string imageUrl($width = 640, $height = 480, $word = '', $font_color = '282828', $bg_color = 'eae0d0', $font_size = '')
192 |  * @method string image($dir = null, $width = 640, $height = 480, $category = null, $fullPath = true, $randomize = true, $word = null)
193 |  *
194 |  * @property string       $hexColor
195 |  * @property string       $safeHexColor
196 |  * @property string       $rgbColor
197 |  * @property array        $rgbColorAsArray
198 |  * @property string       $rgbCssColor
199 |  * @property string       $safeColorName
200 |  * @property string       $colorName
201 |  *
202 |  * @method string randomHtml($maxDepth = 4, $maxWidth = 4)
203 |  *
204 |  */
205 | class Generator
206 | {
207 |     protected $providers  = [];
208 |     protected $formatters = [];
209 | 
210 |     public function addProvider($provider)
211 |     {
212 |         array_unshift($this->providers, $provider);
213 |     }
214 | 
215 |     public function getProviders()
216 |     {
217 |         return $this->providers;
218 |     }
219 | 
220 |     public function seed($seed = null)
221 |     {
222 |         if ($seed === null) {
223 |             mt_srand();
224 |         }
225 |         else {
226 |             if (PHP_VERSION_ID < 70100) {
227 |                 mt_srand((int) $seed);
228 |             }
229 |             else {
230 |                 mt_srand((int) $seed, MT_RAND_PHP);
231 |             }
232 |         }
233 |     }
234 | 
235 |     public function format($formatter, $arguments = [])
236 |     {
237 |         return call_user_func_array($this->getFormatter($formatter), $arguments);
238 |     }
239 | 
240 |     /**
241 |      * @param string $formatter
242 |      *
243 |      * @return Callable
244 |      */
245 |     public function getFormatter($formatter)
246 |     {
247 |         if (isset($this->formatters[$formatter])) {
248 |             return $this->formatters[$formatter];
249 |         }
250 |         foreach ($this->providers as $provider) {
251 |             if (method_exists($provider, $formatter)) {
252 |                 $this->formatters[$formatter] = [$provider, $formatter];
253 | 
254 |                 return $this->formatters[$formatter];
255 |             }
256 |         }
257 |         throw new InvalidArgumentException(sprintf('Unknown formatter "%s"', $formatter));
258 |     }
259 | 
260 |     /**
261 |      * Replaces tokens ('{{ tokenName }}') with the result from the token method call
262 |      *
263 |      * @param string $string String that needs to bet parsed
264 |      * @return string
265 |      */
266 |     public function parse($string)
267 |     {
268 |         return preg_replace_callback('/\{\{\s?(\w+)\s?}}/u', [$this, 'callFormatWithMatches'], $string);
269 |     }
270 | 
271 |     /**
272 |      * @param string $attribute
273 |      *
274 |      * @return mixed
275 |      */
276 |     public function __get($attribute)
277 |     {
278 |         return $this->format($attribute);
279 |     }
280 | 
281 |     /**
282 |      * @param string $method
283 |      * @param array  $attributes
284 |      *
285 |      * @return mixed
286 |      */
287 |     public function __call($method, $attributes)
288 |     {
289 |         return $this->format($method, $attributes);
290 |     }
291 | 
292 |     public function __destruct()
293 |     {
294 |         $this->seed();
295 |     }
296 | 
297 |     protected function callFormatWithMatches($matches)
298 |     {
299 |         return $this->format($matches[1]);
300 |     }
301 | }
302 | 


--------------------------------------------------------------------------------
/src/JsonSchema/Faker.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types = 1);
  4 | 
  5 | namespace Poppy\Faker\JsonSchema;
  6 | 
  7 | 
  8 | use InvalidArgumentException;
  9 | use LogicException;
 10 | use Poppy\Faker\Factory;
 11 | use Poppy\Faker\Provider\Base;
 12 | use Poppy\Faker\Provider\DateTime;
 13 | use Poppy\Faker\Provider\Internet;
 14 | use Poppy\Faker\Provider\Lorem;
 15 | use SplFileInfo;
 16 | use stdClass;
 17 | 
 18 | final class Faker
 19 | {
 20 |     /**
 21 |      * type-fake method map
 22 |      *
 23 |      * @var array
 24 |      */
 25 |     private array $fakers = [
 26 |         'null'    => 'fakeNull',
 27 |         'boolean' => 'fakeBoolean',
 28 |         'integer' => 'fakeInteger',
 29 |         'number'  => 'fakeNumber',
 30 |         'string'  => 'fakeString',
 31 |         'array'   => 'fakeArray',
 32 |         'object'  => 'fakeObject',
 33 |     ];
 34 | 
 35 |     /**
 36 |      * @var string
 37 |      */
 38 |     private string $schemaDir = '';
 39 | 
 40 |     /**
 41 |      * Create fake data with JSON schema
 42 |      *
 43 |      * @param SplFileInfo|stdClass $schema Data structure written in JSON Schema
 44 |      * @param stdClass|null        $parentSchema parent schema when it is subschema
 45 |      * @param string|null          $schemaDir forced directory in object loop
 46 |      *
 47 |      * @throws UnsupportedTypeException Throw when unsupported type specified
 48 |      */
 49 |     public function generate($schema, stdClass $parentSchema = null, string $schemaDir = null)
 50 |     {
 51 |         if ($schema instanceof SplFileInfo) {
 52 |             $file = (string) $schema->getRealPath();
 53 |             if (file_exists($file)) {
 54 |                 $this->schemaDir = dirname($file);
 55 |             }
 56 |             $schema = json_decode((string) file_get_contents($file));
 57 |         }
 58 |         if (!$schema instanceof stdClass) {
 59 |             throw new InvalidArgumentException(gettype($schema));
 60 |         }
 61 |         $schema = $this->resolveOf($schema);
 62 |         if (property_exists($schema, '$ref')) {
 63 |             $currentDir = $schemaDir ?? $this->schemaDir;
 64 | 
 65 |             return (new Ref($this, $currentDir))($schema, $parentSchema);
 66 |         }
 67 |         $type = is_array($schema->type) ? Base::randomElement($schema->type) : $schema->type;
 68 | 
 69 |         if (isset($schema->enum)) {
 70 |             return Base::randomElement($schema->enum);
 71 |         }
 72 | 
 73 |         if (isset($schema->const)) {
 74 |             return Base::randomElement([$schema->const]);
 75 |         }
 76 | 
 77 |         if (!isset($this->fakers[$type])) {
 78 |             throw new UnsupportedTypeException($type);
 79 |         }
 80 | 
 81 |         $faker = [$this, $this->fakers[$type]];
 82 |         if (is_callable($faker)) {
 83 |             return call_user_func($faker, $schema);
 84 |         }
 85 | 
 86 |         throw new LogicException;
 87 |     }
 88 | 
 89 |     public function mergeObject(): object
 90 |     {
 91 |         $merged  = [];
 92 |         $objList = func_get_args();
 93 | 
 94 |         foreach ($objList as $obj) {
 95 |             array_push($merged, ...(array) $obj);
 96 |         }
 97 | 
 98 | 
 99 |         return (object) $merged;
100 |     }
101 | 
102 |     public function getMaximum($schema): int
103 |     {
104 |         $offset = ($schema->exclusiveMaximum ?? false) ? 1 : 0;
105 | 
106 |         return (int) (($schema->maximum ?? mt_getrandmax()) - $offset);
107 |     }
108 | 
109 |     public function getMinimum($schema): int
110 |     {
111 |         $offset = ($schema->exclusiveMinimum ?? false) ? 1 : 0;
112 | 
113 |         return (int) (($schema->minimum ?? -mt_getrandmax()) + $offset);
114 |     }
115 | 
116 |     public function resolveDependencies(stdClass $schema, array $keys): array
117 |     {
118 |         $resolved     = [];
119 |         $dependencies = $schema->dependencies ?? new stdClass();
120 | 
121 |         foreach ($keys as $key) {
122 |             $resolved = array_merge($resolved, [$key], $dependencies->{$key} ?? []);
123 |         }
124 | 
125 |         return $resolved;
126 |     }
127 | 
128 |     public function getRandomSchema(): object
129 |     {
130 |         $fakerNames = array_keys($this->fakers);
131 | 
132 |         return (object) [
133 |             'type' => Base::randomElement($fakerNames),
134 |         ];
135 |     }
136 | 
137 |     public function resolveOf(stdClass $schema): stdClass
138 |     {
139 |         if (isset($schema->allOf)) {
140 |             return call_user_func_array([$this, 'mergeObject'], $schema->allOf);
141 |         }
142 |         if (isset($schema->anyOf)) {
143 |             return call_user_func_array([$this, 'mergeObject'], Base::randomElements($schema->anyOf));
144 |         }
145 |         if (isset($schema->oneOf)) {
146 |             return Base::randomElement($schema->oneOf);
147 |         }
148 | 
149 |         return $schema;
150 |     }
151 | 
152 |     public function getMultipleOf($schema): int
153 |     {
154 |         return $schema->multipleOf ?? 1;
155 |     }
156 | 
157 |     public function getInternetFakerInstance(): Internet
158 |     {
159 |         return new Internet(Factory::create());
160 |     }
161 | 
162 |     public function getFormattedValue($schema)
163 |     {
164 |         switch ($schema->format) {
165 |             // Date representation, as defined by RFC 3339, section 5.6.
166 |             case 'date-time':
167 |                 return DateTime::dateTime()->format(DATE_RFC3339);
168 |             // Internet email address, see RFC 5322, section 3.4.1.
169 |             case 'email':
170 |                 return $this->getInternetFakerInstance()->safeEmail();
171 |             // Internet host name, see RFC 1034, section 3.1.
172 |             case 'hostname':
173 |                 return $this->getInternetFakerInstance()->domainName();
174 |             // IPv4 address, according to dotted-quad ABNF syntax as defined in RFC 2673, section 3.2.
175 |             case 'ipv4':
176 |                 return $this->getInternetFakerInstance()->ipv4();
177 |             // IPv6 address, as defined in RFC 2373, section 2.2.
178 |             case 'ipv6':
179 |                 return $this->getInternetFakerInstance()->ipv6();
180 |             // A universal resource identifier (URI), according to RFC3986.
181 |             case 'uri':
182 |                 return $this->getInternetFakerInstance()->url();
183 |             default:
184 |                 throw new UnsupportedTypeException("Unsupported type: {$schema->format}");
185 |         }
186 |     }
187 | 
188 |     /**
189 |      * @return string[] Property names
190 |      */
191 |     public function getProperties(stdClass $schema): array
192 |     {
193 |         $requiredKeys   = $schema->required ?? [];
194 |         $optionalKeys   = array_keys((array) ($schema->properties ?? new stdClass()));
195 |         $maxProperties  = $schema->maxProperties ?? count($optionalKeys) - count($requiredKeys);
196 |         $pickSize       = Base::numberBetween(0, min(count($optionalKeys), $maxProperties));
197 |         $additionalKeys = $this->resolveDependencies($schema, Base::randomElements($optionalKeys, $pickSize));
198 |         $propertyNames  = array_unique(array_merge($requiredKeys, $additionalKeys));
199 | 
200 |         $additionalProperties = $schema->additionalProperties ?? true;
201 |         $patternProperties    = $schema->patternProperties ?? new stdClass();
202 |         $patterns             = array_keys((array) $patternProperties);
203 |         while (count($propertyNames) < ($schema->minProperties ?? 0)) {
204 |             $name = $additionalProperties ? Lorem::word() : Lorem::regexify(Base::randomElement($patterns));
205 |             if (!in_array($name, $propertyNames, true)) {
206 |                 $propertyNames[] = $name;
207 |             }
208 |         }
209 | 
210 |         return $propertyNames;
211 |     }
212 | 
213 |     private function fakeNull()
214 |     {
215 |         return null;
216 |     }
217 | 
218 |     private function fakeBoolean(): bool
219 |     {
220 |         return Base::randomElement([true, false]);
221 |     }
222 | 
223 |     private function fakeInteger(stdClass $schema): int
224 |     {
225 |         $minimum    = $this->getMinimum($schema);
226 |         $maximum    = $this->getMaximum($schema);
227 |         $multipleOf = $this->getMultipleOf($schema);
228 | 
229 |         return Base::numberBetween($minimum, $maximum) * $multipleOf;
230 |     }
231 | 
232 |     private function fakeNumber(stdClass $schema)
233 |     {
234 |         $minimum    = $this->getMinimum($schema);
235 |         $maximum    = $this->getMaximum($schema);
236 |         $multipleOf = $this->getMultipleOf($schema);
237 | 
238 |         return Base::randomFloat(null, $minimum, $maximum) * $multipleOf;
239 |     }
240 | 
241 |     private function fakeString(stdClass $schema): string
242 |     {
243 |         if (isset($schema->format)) {
244 |             return $this->getFormattedValue($schema);
245 |         }
246 |         if (isset($schema->pattern)) {
247 |             return Lorem::regexify($schema->pattern);
248 |         }
249 |         $min = $schema->minLength ?? 1;
250 |         $max = $schema->maxLength ?? max(5, $min + 1);
251 |         if ($max < 5) {
252 |             return substr(Lorem::text(5), 0, $max);
253 |         }
254 |         $lorem = Lorem::text($max);
255 | 
256 |         if (mb_strlen($lorem) < $min) {
257 |             $lorem = str_repeat($lorem, $min);
258 |         }
259 | 
260 |         return mb_substr($lorem, 0, $max);
261 |     }
262 | 
263 |     private function fakeArray(stdClass $schema): array
264 |     {
265 |         if (!isset($schema->items)) {
266 |             $subschemas = [$this->getRandomSchema()];
267 |             // List
268 |         }
269 |         elseif (is_object($schema->items)) {
270 |             $subschemas = [$schema->items];
271 |             // Tuple
272 |         }
273 |         elseif (is_array($schema->items)) {
274 |             $subschemas = $schema->items;
275 |         }
276 |         else {
277 |             throw new InvalidItemsException;
278 |         }
279 | 
280 |         $dummies    = [];
281 |         $itemSize   = Base::numberBetween(($schema->minItems ?? 0), $schema->maxItems ?? count($subschemas));
282 |         $subschemas = array_slice($subschemas, 0, $itemSize);
283 |         $dir        = $this->schemaDir;
284 |         for ($i = 0; $i < $itemSize; $i++) {
285 |             $subschema = $subschemas[$i % count($subschemas)];
286 |             $dummies[] = $this->generate($subschema, $schema, $dir);
287 |         }
288 |         $this->schemaDir = $dir;
289 | 
290 |         return ($schema->uniqueItems ?? false) ? array_unique($dummies) : $dummies;
291 |     }
292 | 
293 |     private function fakeObject(stdClass $schema): stdClass
294 |     {
295 |         $dir           = $this->schemaDir;
296 |         $properties    = $schema->properties ?? new stdClass();
297 |         $propertyNames = $this->getProperties($schema);
298 | 
299 |         $dummy     = new stdClass();
300 |         $schemaDir = $this->schemaDir;
301 |         foreach ($propertyNames as $key) {
302 |             if (isset($properties->{$key})) {
303 |                 $subschema = $properties->{$key};
304 |             }
305 |             else {
306 |                 $subschema = $this->getAdditionalPropertySchema($schema, $key) ?: $this->getRandomSchema();
307 |             }
308 | 
309 |             $dummy->{$key} = $this->generate($subschema, $schema, $schemaDir);
310 |         }
311 |         $this->schemaDir = $dir;
312 | 
313 |         return $dummy;
314 |     }
315 | 
316 |     private function getAdditionalPropertySchema(stdClass $schema, $property)
317 |     {
318 |         $patternProperties    = $schema->patternProperties ?? new stdClass();
319 |         $additionalProperties = $schema->additionalProperties ?? true;
320 | 
321 |         foreach ($patternProperties as $pattern => $sub) {
322 |             if (preg_match("/{$pattern}/", $property)) {
323 |                 return $sub;
324 |             }
325 |         }
326 | 
327 |         if (is_object($additionalProperties)) {
328 |             return $additionalProperties;
329 |         }
330 |     }
331 | }
332 | 


--------------------------------------------------------------------------------