PHPackages                             kfilin/randdata - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. kfilin/randdata

ActiveLibrary[Utility & Helpers](/categories/utility)

kfilin/randdata
===============

Data generator with support for complex data and dependency realization

v1.1(6y ago)0201MITHTMLPHP >=5.6.0CI failing

Since Jun 2Pushed 5y ago1 watchersCompare

[ Source](https://github.com/KonstantinFilin/RandData)[ Packagist](https://packagist.org/packages/kfilin/randdata)[ Docs](https://github.com/KonstantinFilin/RandData)[ RSS](/packages/kfilin-randdata/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (1)Versions (12)Used By (0)

RandData
========

[](#randdata)

[![Build Status](https://camo.githubusercontent.com/2131609dee9d64063d2e3b4374a326d467e40aa6cdb4116bbdc285a9dcfa51fb/68747470733a2f2f7472617669732d63692e6f72672f4b6f6e7374616e74696e46696c696e2f52616e64446174612e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/KonstantinFilin/RandData)

Data generator with support for complex data and dependency realization. You can check [demo site](http://randdata.kfilin.com/) of the project.

- [Installation](https://github.com/KonstantinFilin/RandData#installation)
- [Basic usage](https://github.com/KonstantinFilin/RandData#basic-usage)
    - [Raw random values example](https://github.com/KonstantinFilin/RandData#raw-random-values-example)
    - [Filling string by template](https://github.com/KonstantinFilin/RandData#filling-string-by-template)
    - [Generators. Creating csv](https://github.com/KonstantinFilin/RandData#generators-creating-csv)
    - [Generators. Filling database and more](https://github.com/KonstantinFilin/RandData#generators-filling-database-and-more)
    - [Data dependency](https://github.com/KonstantinFilin/RandData#data-dependency)
    - [Data dependency. Nested datasets](https://github.com/KonstantinFilin/RandData#data-dependency-nested-datasets)
    - [Filling forms](https://github.com/KonstantinFilin/RandData#filling-forms)
- [Main Objects](https://github.com/KonstantinFilin/RandData#main-objects)
    - [RandData Fabric](https://github.com/KonstantinFilin/RandData#randdata-fabric)
    - [RandData Set](https://github.com/KonstantinFilin/RandData#randdata-set)
    - [Tuple](https://github.com/KonstantinFilin/RandData#tuple)
    - [RandData Generator](https://github.com/KonstantinFilin/RandData#randdata-generator)
- [DataSet](https://github.com/KonstantinFilin/RandData#dataset-options)
    - [Boolean](https://github.com/KonstantinFilin/RandData#boolean)
    - [Counter](https://github.com/KonstantinFilin/RandData#counter)
    - [Date](https://github.com/KonstantinFilin/RandData#date)
    - [Datetime](https://github.com/KonstantinFilin/RandData#datetime)
    - [Decimal](https://github.com/KonstantinFilin/RandData#decimal)
    - [Domain](https://github.com/KonstantinFilin/RandData#domain)
    - [Email](https://github.com/KonstantinFilin/RandData#email)
    - [Integer](https://github.com/KonstantinFilin/RandData#integer)
    - [Paragraph](https://github.com/KonstantinFilin/RandData#paragraph)
    - [Phone](https://github.com/KonstantinFilin/RandData#phone)
    - [String](https://github.com/KonstantinFilin/RandData#string)
    - [String List](https://github.com/KonstantinFilin/RandData#string-list)
    - [Time](https://github.com/KonstantinFilin/RandData#time)
    - [Value](https://github.com/KonstantinFilin/RandData#value)
    - [Complex](https://github.com/KonstantinFilin/RandData#complex)
- [DataSet (en\_GB)](https://github.com/KonstantinFilin/RandData#dataset-en_gb)
    - [Address](https://github.com/KonstantinFilin/RandData#address)
    - [City](https://github.com/KonstantinFilin/RandData#city)
    - [Person](https://github.com/KonstantinFilin/RandData#person)
    - [Postcode](https://github.com/KonstantinFilin/RandData#postcode)
    - [Street](https://github.com/KonstantinFilin/RandData#street)
- [DataSet (ru\_RU)](https://github.com/KonstantinFilin/RandData#dataset-ru_ru)
    - [Address (ru)](https://github.com/KonstantinFilin/RandData#address-ru)
    - [City (ru)](https://github.com/KonstantinFilin/RandData#city-ru)
    - [Person (ru)](https://github.com/KonstantinFilin/RandData#person-ru)
    - [Postcode (ru)](https://github.com/KonstantinFilin/RandData#postcode-ru)
    - [Street (ru)](https://github.com/KonstantinFilin/RandData#street-ru)
- [ToDo](https://github.com/KonstantinFilin/RandData#todo)

Installation
------------

[](#installation)

```
composer require kfilin/randdata

```

Basic usage
-----------

[](#basic-usage)

More examples in src/examples folder

### Raw random values example

[](#raw-random-values-example)

```
$fabric = new RandData\Fabric();
$dataSetInteger = $fabric->createObjectFromString("integer");
for ($i = 1; $i get() . PHP_EOL;
}

$dataSetInteger2 = $fabric->createObjectFromString("integer:min=-5;max=7");
$dataSetInteger3 = $fabric->createObjectFromString("integer:min=111;max=222");
```

### Filling string by template

[](#filling-string-by-template)

Let's we have a string with a pair of variable words in it. We will fill this fields with random values:

```
class BlankTuple extends \RandData\Tuple
{
    public function getDataSets()
    {
        return [
            "name" => "string_list:values=John,Paul,George,Ringo",
            "dt" => "date:min=1962-10-05;max=1970-05-08"
        ];
    }
}

$generator = new RandData\BlankGenerator(new BlankTuple);
$tpl = "Hello, I'm {name} and today is {dt}";
$generator->init($tpl);
echo $tpl . " => ". $generator->run() . PHP_EOL;
// Hello, I'm {name} and today is {dt}
// =>
// Hello, I'm George and today is 1965-12-12
```

Let's make it a little more complicated:

```
class BlankTuple extends \RandData\Tuple
{
    public function getDataSets()
    {
        return [
            "name" => "string_list:values=John,Paul,George,Ringo",
            "dt" => "date:min=1962-10-05;max=1970-05-08",
            "age" => "integer:min=19;max=30"
        ];
    }

    // Age field is dependant from dt field. See [Data dependency]
    protected function getValue(\RandData\Set $set, $fldName) {
        $birthDtList = [
            "John" => "1940-10-09",
            "Paul" => "1942-06-18",
            "George" => "1943-02-25",
            "Ringo" => "1940-07-07"
        ];

        if ($fldName == "age") {
            $name = $this->result["name"];
            $dt = new \DateTime($this->result["dt"]);
            $birth = !empty($birthDtList[$name])
                ? new \Datetime($birthDtList[$name])
                : null;

            if ($dt && $birth) {
                $interval = $birth->diff($dt);
                return $interval->format("%y");
            }

            return 0;
        }

        return $set->get();
    }

}

$generator = new RandData\BlankGenerator(new BlankTuple);
$tpl = "Hello, I'm {name}, my age {age} and today is {dt}. {name} at {dt}";
$generator->init($tpl);
echo $generator->run() . PHP_EOL;
// Hello, I'm John, my age 27 and today is 1968-07-08. John at 1968-07-08
// Hello, I'm Paul, my age 21 and today is 1963-11-14. Paul at 1963-11-14
// Hello, I'm George, my age 24 and today is 1967-08-14. George at 1967-08-14
// Hello, I'm Ringo, my age 28 and today is 1969-07-05. Ringo at 1969-07-05
// ...
```

### Generators. Creating csv

[](#generators-creating-csv)

```
class PersonTuple extends \RandData\Tuple
{
    public function getDataSets() {
        return [
            "Id" => "counter",
            "Login" => "counter:template=user_#;start=100",
            "Name" => "en_person",
            "Birth" => "date:min=1900-01-01;max=2005-12-31",
            "Phone" => "phone:country_list=7;region_list=495,499,915,919,905,903",
            "Sum" => "integer:min=100;max=10000",
            "Class" => "string_list:values=aaa,bbb,ccc;possibility=50,20,30"
        ];
    }

    protected function getNullProbability() {
        return [
            "Phone" => 20, // null approximately 20% (every fifth)
            "Sum" => 50, // null approximately 50% (every second)
        ];
    }
}

$formatter = new RandData\Formatter\Csv(new \RandData\Generator(new PersonTuple(), 20));
$formatter->setShowHeaders(false);
$formatter->setShowCounter(false);

echo $formatter->build();
echo PHP_EOL;

/*
#;Name;Birth;Phone;Sum
1;user_100;Jeremy Tyson Newman;1975-05-02;+7 (905) 513-68-76;NA;aaa
2;user_101;Valerie Camden Murray;1908-05-07;+7 (915) 573-60-43;2101;aaa
3;user_102;Theodore Kelton Graves;1939-06-26;+7 (903) 647-33-24;NA;bbb
...
*/
```

### Generators. Filling database and more

[](#generators-filling-database-and-more)

First of all, you can define your data manually:

```
class PersonTuple extends \RandData\Tuple
{
    public function getDataSets() {
        return [
            "Id" => "counter",
            "Login" => "counter:template=user_#;start=100",
            "Name" => "en_person",
            "Birth" => "date:min=1900-01-01;max=2005-12-31",
            "Phone" => "phone:country_list=7;region_list=495,499,915,919,905,903",
            "Sum" => "integer:min=100;max=10000",
            "Class" => "string_list:values=aaa,bbb,ccc;possibility=50,20,30"
        ];
    }

    protected function getNullProbability() {
        return [
            "Phone" => 20, // null approximately 20% (every fifth)
            "Sum" => 50, // null approximately 50% (every second)
        ];
    }
}

/*
INSERT INTO `clients` (`Id`,`Login`,`Name`,`Birth`,`Phone`,`Sum`,`Class`) VALUES ('1','user_100','Thomas Brendon Simmons','1941-09-13','+7 (499) 877-05-17','8005','ccc');
INSERT INTO `clients` (`Id`,`Login`,`Name`,`Birth`,`Phone`,`Sum`,`Class`) VALUES ('2','user_101','Audrey Lee Howell','2005-10-16','+7 (499) 888-14-81','9693','aaa');
INSERT INTO `clients` (`Id`,`Login`,`Name`,`Birth`,`Phone`,`Sum`,`Class`) VALUES ('3','user_102','Penelope Ellen Arnold','1975-04-30','+7 (903) 991-48-86','1986','aaa');...
*/
```

If your database is too big and you want to get it fast, you can get it from sql SHOW CREATE TABLE command:

```
$sql = "CREATE TABLE `user` (
 `id` smallint(5) unsigned NOT NULL AUTO_INCREMENT,
 `login` varchar(100) NOT NULL,
 `role` enum('admin','student') NOT NULL,
 `name` varchar(255) DEFAULT NULL,
 `passhash` varchar(50) NOT NULL,
 `blocked` tinyint(1) unsigned NOT NULL DEFAULT '0',
 `activate_code` varchar(100) DEFAULT NULL,
 `activate_dt` date DEFAULT NULL,
 PRIMARY KEY (`id`),
 UNIQUE KEY `login` (`login`)
) ENGINE=MyISAM AUTO_INCREMENT=1 DEFAULT CHARSET=utf8";

$tableName = "user";
$tuple = new \RandData\Fabric\Tuple\SqlCreateTuple($sql);
$generator = new \RandData\Generator($tuple, 20);
$formatter = new \RandData\Formatter\Sql($generator, $tableName);

echo $formatter->build() . PHP_EOL . PHP_EOL;
foreach ($tuple->getDataSets() as $fldName => $fldDef) {
    echo "'" . $fldName . "' => '" . $fldDef . "'" . PHP_EOL;
}

echo PHP_EOL;

/* In output sql insert command: */
INSERT INTO `user` (`id`,`login`,`role`,`name`,`passhash`,`blocked`,`activate_code`,`activate_dt`) VALUES ('1','Xi9ERI','student',NULL,'ZsT1ECLs3BrmgUnWBdjpHpLbHgLExH7sxLFzX5','N','hljwMnafH2pn8tPfwflWSl7MyXtnaMUbehdWvocM5avrFk3e',NULL);
INSERT INTO `user` (`id`,`login`,`role`,`name`,`passhash`,`blocked`,`activate_code`,`activate_dt`) VALUES ('2','hHroxmPFgpDGOMl9yvFDykcAFoZ755P5CGHfZXgA9YNIo','student','Yl3UVeEKxvUysapnddBI9hEr9DeaulWUutMVE0WEdifEoytUdIp2APHPdo6XeWXx3hbfl5ps34sDg4pOto470yzuEXT7fn3VwOZ','BnesLyU43ly6T2bg6KWdii2piBLDhVtcSyie','1','j','2014-07-06');
// ...

/* And rules for inserting into php class, where you can set more strict rules: */

'id' => 'counter',
'login' => 'string:length_min=1;length_max=100',
'role' => 'string_list:values=admin,student',
'name' => 'string:length_min=1;length_max=255',
'passhash' => 'string:length_min=1;length_max=50',
'blocked' => 'boolean:valTrue=1;valFalse=0',
'activate_code' => 'string:length_min=1;length_max=100',
'activate_dt' => 'date:min=1900-01-01;max=2099-12-31',
```

If you want it VERY fast and you don't care much about plausibility, you can fill all database tables (if any field is NULL possible, its value will be NULL with about 50% probability):

```
$dbhost = "localhost";
$dbname = "test";
$dbuser = "root";
$dbpass = "123";
$dsn = sprintf("mysql:dbname=%s;host=%s", $dbname, $dbhost);

try {
    $dbh = new PDO($dsn, $dbuser, $dbpass);
    $rows = $dbh->query("show TABLES", PDO::FETCH_COLUMN, 0);

    foreach ($rows as $tblName) {
        $rowCountSql = "SELECT count(*) FROM `" . $tblName . "`";
        $rowCountRes = $dbh->query($rowCountSql, PDO::FETCH_COLUMN, 0);
        $rowCount = $rowCountRes->fetch();

        // Just as a precaution
        if ($rowCount > 0) {
            echo "Non empty table: [" . $tblName . "]. Rows count: " . $rowCount . PHP_EOL;
            die;
        }

        $createSqlRow = "SHOW CREATE TABLE `" . $tblName . "`";
        $createSqlRes = $dbh->query($createSqlRow, PDO::FETCH_COLUMN, 1);
        $sql = $createSqlRes->fetch();
        $tuple = new \RandData\Fabric\Tuple\SqlCreateTuple($sql);
        $generator = new \RandData\Generator($tuple, 20);
        $formatter = new \RandData\Formatter\Sql($generator, $tblName);
        $sqlIns = $formatter->build();
        $dbh->exec($sqlIns);
    }

} catch (PDOException $e) {
    echo 'Connection failed: ' . $e->getMessage();
}

echo PHP_EOL;
```

Currenty only this data types supported (feel free to ask for extanding the list or make your own contribution to the project):

- (tiny|small|medium|big)int
- decimal
- varchar
- (tiny|medium|long)text
- enum
- set (only one of available values for the row will be generated, i.e. one OR two OR three, but not one,two or one,three
- datetime/date/time/year/year(4)/year(2)

### Data dependency

[](#data-dependency)

In real life data is dependant. Birth must be before death, sunrise time before sunset time, salary is calculating from worked hours, hourly rate, fines and so on.

This library can generate data dependant from other object attributes (for example, hired date dependant from birth date).

```
class EmployeeTuple extends \RandData\Tuple {

    const LEVEL_1 = 40*365*24*3600;
    const LEVEL_2 = 30*365*24*3600;
    const HIRED_AGE_MIN = 20*365*24*3600;
    const HIRED_AGE_MAX = 50*365*24*3600;

    public function getDataSets() {
        return [
            "sex" => "string_list:values=" . RandData\Set\en_GB\Person::SEX_MALE . "," . RandData\Set\en_GB\Person::SEX_FEMALE,
            "name" => "en_person",
            "birth" => "date:min=now -50 year;max=now -20 year",
            "hired" => "date:min=now -3 year;max=now",
            "fired" => "date:min=now -3 year;max=now",
            "score" => "int:min=1;max=3"
        ];
    }

    protected function getNullProbability() {
        return [
            "fired" => 30
        ];
    }

    protected function getSetValueOrNull(RandData\Set $set, $fldName)
    {
        $value = parent::getSetValueOrNull($set, $fldName);

        // Override dependent datasets
        if ($fldName == "sex") {
            $this->getValueSex($value);
        } elseif ($fldName == "birth") {
            $this->getValueBirth($value);
        } elseif ($fldName == "hired") {
            $this->getValueHired($value);
        }

        return $value;
    }

    private function getValueSex(&$value) {
        $this->datasets["name"] = "en_person:sex=" . $value;
        $value = $value == RandData\Set\en_GB\Person::SEX_MALE ? "Male" : "Female";
    }

    private function getValueHired($value) {
        // Fired date must be later than hired date,
        // but earlier than today
        $hiredTs = date("U", strtotime($value));
        $firedDtMin = date("Y-m-d", $hiredTs + 1*24*3600);
        $firedDtMax = date("Y-m-d", date("U") - 3*24*3600);
        $this->datasets["fired"] = "date:min=" . $firedDtMin . ";max=" .$firedDtMax ;
    }

    private function getValueBirth($value) {
        $birthTs = date("U", strtotime($value));
        $nowTs = date("U");

        // Hired date must be later than birth date
        // Let's we can hire somebody in the ages from 20 to 50
        $hiredTsMin = date("Y-m-d", date("U", min([ $birthTs + self::HIRED_AGE_MIN, date("U") ])));
        $hiredTsMax = date("Y-m-d", date("U", min([ $birthTs + self::HIRED_AGE_MAX, date("U") ])));
        $this->datasets["hired"] = "date:min=" . $hiredTsMin . ";max=" . $hiredTsMax;

        // Let's some dummy score will be dependant on age
        if (self::LEVEL_1 < $nowTs - $birthTs) {
            $this->datasets["score"] = "int:min=20;max=25";
        } elseif (self::LEVEL_2 < $nowTs - $birthTs) {
            $this->datasets["score"] = "int:min=10;max=13";
        }
    }
}

$employeeTuple = new EmployeeTuple();
$generator = new \RandData\Generator($employeeTuple, 50);
$formatter = new \RandData\Formatter\Csv($generator);

echo $formatter->build() . PHP_EOL;
```

If you have dependencies between different objects (Authors and Books), it can be little tricky, but something about this:

```
$bookTuple->setAuthorIds($authorsIds)
// ... and then choose from this list
```

Or simplier, if you test with 100 authors:

```
class PersonTuple extends \RandData\Tuple
{
    public function getDataSets() {
        return [
            // ...
            "author_id" => "integer:min=1;max=100",
            // ...
        ];
    }
}
```

### Data dependency. Nested datasets

[](#data-dependency-nested-datasets)

Another way to declare dependency is nested datasets

```
class CarTuple extends \RandData\Tuple
{
    public function getDataSets() {
        return [
            "mark" => "string_list:values=ford,bmw,audi,vw,skoda,toyota,volvo,mercedez,bently,saab",
            "color" => "string_list:values=white,black,grey,blue,yellow,green,orange,red",
            "year" => "integer:min=1950;max=2017"
        ];
    }
}

class PersonTuple extends \RandData\Tuple {

    public function getDataSets() {
        return [
            "name" => "en_person",
            "birth" => "date:min=1920-01-01;max=1999-12-31",
            "login" => "string:char_list=abcdefghjklmnopqrstuvwxyz0123456789;length_min=2;length_max=8",
            "car" => new CarTuple()
        ];
    }

    protected function getNullProbability() {
        return [
            "car" => 30
        ];
    }
}

class OrderTuple extends \RandData\Tuple {
    protected $personList;

    function __construct($personList) {
        parent::__construct();
        $this->personList = $personList;
    }

    public function getDataSets() {
        return [
            "num" => "complex:template=id{string:char_list=abcdef;length_min=2;length_max=2}/" . date("Ymd") . "/{integer:min=1000;max=9999}",
            "delivery_address" => "en_address",
            "price" => "integer:min=50;max=1000",
            "person" => "value:value=person"
        ];
    }

    protected function getSetValueOrNull(RandData\Set $set, $fldName) {
        if ($fldName == "person") {
            return $this->personList[array_rand($this->personList)];
        }

        return $set->get();
    }
}

$generator = new \RandData\Generator(new PersonTuple(), 3);
$personList = $generator->run();
$ot = new OrderTuple($personList);

$generator2 = new \RandData\Generator($ot, 5);
$orderList = $generator2->run();

var_dump($generator2->run());
echo PHP_EOL;
```

### Filling forms

[](#filling-forms)

See [demo site](http://randdata.kfilin.com/forms.php)

Main Objects
------------

[](#main-objects)

### RandData Fabric

[](#randdata-fabric)

Creates RandDataSet objects

### RandData Set

[](#randdata-set)

Generates one random value. Atomic piece of data, may be simple (boolean, number or char) or complex, for example *PersonName* Object (FirstName + MiddleName + LastName) or *AviaTicket Order* Object (departure information, route, passenger list, status information and so on)

### Tuple

[](#tuple)

Manages list of datasets. Can add dataset from PHP object or from string. Generates array of random values

### RandData Generator

[](#randdata-generator)

Manages generation process. Produces amount of random datasets (array of arrays of random values).

### RandData Formatter

[](#randdata-formatter)

Buids data stream into something useful. Now it can be csv file, sql INSERT commands or JSON array.

DataSet options
---------------

[](#dataset-options)

All DataSet can be created from string identificator ("boolean", "string", "integer" and so on):

There also may be an optional params:

```
ID:params

```

Params seperated by semicolon and name/value pairs separated by equal sign:

```
ID:key1=value1;key2=value2;key3=value3

```

Value may be an array item, its item seperated by comma:

```
ID:letters:a,b,c;persons:John,Mary,Jane

```

### Counter

[](#counter)

Simple counter. Generates number sequence inside string or as number. When calling by Generator object, it is incremented automatically. When calling direct or by Tuple object, you need to set counter value manually

**ID**

> counter, cnt

**Params**

- tpl, template: When setted, it generates string with counter (for example, template "user\_#" turns to { user\_1, user\_2, user\_3, ... }. When missed, then usual unsigned integer will be returned { 1, 2, 3, ... }
- start: Default start value. For example, you set generator's amount property to 20, and start counter property setted to 100, then you get values { 100, 101, 102, ..., 119 }

**Initialization string example**

```
counter:template=user_#;start=100

```

### Boolean

[](#boolean)

**ID**

> boolean

**Params**

- valTrue: String to show when true (examples: 1, Y, Yes, +, ...)
- valFalse: String to show when false (examples: 0, N, No, -, ...)

**Initialization string examples**

```
boolean:valTrue=1;valFalse=0
boolean:valTrue=true;valFalse=false

```

### Integer

[](#integer)

**ID**

> int, integer

**Params**

- min: Minimum value (default to 0)
- max: Maximum value (default to return value of [getrandmax()](http://php.net/manual/en/function.getrandmax.php) PHP function

**Initialization string examples**

```
integer
integer:min=-5;max=7

```

### Decimal

[](#decimal)

**ID**

> decimal

**Params**

- min: Minimum value (default to 0)
- max: Maximum value (default to return value of [getrandmax()](http://php.net/manual/en/function.getrandmax.php) PHP function
- minFractionDigits: Minimum digits after the point. Default to 0
- maxFractionDigits: Maximum digits after the point. Default to 8

**Initialization string examples**

```
decimal:min=8;max=13
decimal:min=4;max=6;minFractionDigits=2;maxFractionDigits=4

```

### String

[](#string)

A string of selected chars

**ID**

> string

**Params**

- length\_min: String length. Defaults to 1. Must be minimum 1
- length\_max: String length. Defaults to 10. Must be maximum 100
- char\_list: List of chars that random string consists of. Defaults to \[A-Za-z0-9\]

**Initialization string examples**

```
string:length_min=3;length_max=5;char_list=ABCDEF0123456789

```

### Paragraph

[](#paragraph)

A paragraph of words (random char strings) separated by spaces

**ID**

> paragraph

**Params**

- words\_min: Minimum words in paragraph. Defaults to 3. Must be minimum 1
- words\_max: Maximum words in paragraph. Defaults to 100. Must be maximum 500
- length\_min: String length. Defaults to 1. Must be minimum 1
- length\_max: String length. Defaults to 10. Must be maximum 100
- char\_list: List of chars that random string consists of. Defaults to \[A-Za-z0-9\]

**Initialization string examples**

```
paragraph:words_min=15;words_max=30
paragraph:words_min=15;words_max=30;length_min=4;length_max=6;char_list=ABCDEF0123456789

```

### String List

[](#string-list)

String from the list

**ID**

> string\_list

**Params**

- values: Comma seperated list of available values
- possibility: The possibility of values (in percents). Must be equal to the values count and its sum must be 100. If missing, then all values has the same possibility.

**Initialization string examples**

```
string_list:values=Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday
string_list:values=aaa,bbb,ccc;possibility=50,20,30
// aaa will be choosen approximately 50 times from 100
// bbb will be choosen approximately 20 times from 100
// ccc will be choosen approximately 30 times from 100

```

### Time

[](#time)

**ID**

> time

**Params**

- min: Minimum time. Default to "00:00"
- max: Maximum time. Default to "23:59"
- seconds: Whether to show seconds. 1 - show, 0 - hide. Default to 0

**Initialization string examples**

```
time:seconds=1
time:min=12:30;max=13:15

```

### Date

[](#date)

**ID**

> date

**Params**

- min: Minimum date. Default to today minus one month. Input format YYYY-MM-DD.
- max: Maximum date. Default to today. Input format YYYY-MM-DD.
- format: Output format. Understands any format of [date()](http://php.net/manual/en/function.date.php) PHP function. Default to YYYY-MM-DD

**Initialization string examples**

```
date:format=d.m.Y
date:min=2017-12-25;max=2017-12-28

```

### Datetime

[](#datetime)

**ID**

> datetime

**Params**

- date\_min: Minimum date. Default to today minus one month. Input format YYYY-MM-DD.
- date\_max: Maximum date. Default to today. Input format YYYY-MM-DD.
- date\_format: Output format. Understands any format of [date()](http://php.net/manual/en/function.date.php) PHP function. Default to YYYY-MM-DD
- time\_min: Minimum time. Default to "00:00"
- time\_max: Maximum time. Default to "23:59"
- seconds: Whether to show seconds. 1 - show, 0 - hide. Default to 1

**Initialization string examples**

```
datetime:date_format=d.m.Y;seconds=0
datetime:date_min=2017-05-17;date_max=2017-05-21;time_min=11:00;time_max=14:30

```

### Phone

[](#phone)

**ID**

> phone

**Params**

- country\_list: List of available country codes (1-9)
- region\_list: List of available region codes (3 or 4 digits)
- format: Whether to show number formatted as +# (###) ###-##-## or +# (####) ###-### or as 11 digits. 1 - formatted (default), 0 - unformatted.

**Initialization string examples**

```
phone:format=0
phone:country_list=3,7;region_list=123,456,7890

```

### Domain

[](#domain)

**ID**

Two level www domain

> domain

**Params**

- tld\_list: List of available top domain. Default: com,edu,org,net
- char\_list\_edge: First and last char. Default: abcdefghijklmnoprstuvwxyz0123456789
- char\_list: Available characters (except first and last one). Default is char\_list\_edge chars and a hyphen char ("-").
- skip\_www: Skip www part of domain. Can be 0 or 1. Default 0

**Initialization string examples**

```
domain:skip_www=1
domain:tld_list=org,net;char_list_edge=01;char_list=abcdef0123456789

```

### Email

[](#email)

**ID**

> email

**Params**

- domain\_list: Generate mail only in this domains

**Initialization string example**

```
email:domain_list=gmail.com,yahoo.com,hotmail.com,fbi.gov

```

### Value

[](#value)

Generates single value

**ID**

> value

**Params**

- value: Value to generate

**Initialization string example**

```
email:domain_list=gmail.com,yahoo.com,hotmail.com,fbi.gov

```

### Complex

[](#complex)

Dataset consists of other datasets

**ID**

> complex

**Params**

- template: initialization string - any string with dataset definitions enclosed with {}. See examples for details

**Initialization string example**

```
complex:template=Hello, I'm {string_list:values=Peter,James,John}, my age is {integer:min=5;max=30}, I live @ {en_address} and today is {date}

```

**Examples**

```
$tpl = "Hello, I'm {string_list:values=Peter,James,John}, my age is {integer:min=5;max=30}, I live @ {en_address} and today is {date}";
$generator = new \RandData\Set\Complex($tpl);
echo $generator->run() . PHP_EOL;
```

DataSet (en\_GB)
----------------

[](#dataset-en_gb)

### Address

[](#address)

**ID**

> en\_address

**Params**

No params

### City

[](#city)

**ID**

> en\_city

**Params**

- postcode: post area to take city from

**Initialization string example**

```
en_city:postcode=IP29 8FX
```

### Person

[](#person)

**ID**

> en\_person

**Params**

- sex: List of person's sex. m - Male, f - female. Default to both
- format: First name (%f), middle name (%m) and last name (%l) order. Default to "%f %m %l". %f1 - first letter of the first name, %m1 - first letter of the middle name, %l1 - last letter of ther first name

**Initialization string examples**

```
en_person:format=%f %m %l
en_person:format=%f %m1. %l
en_person:sex=m
```

### Postcode

[](#postcode)

**ID**

> en\_postcode

**Params**

No params

### Street

[](#street)

**ID**

> en\_street

**Params**

No params

DataSet (ru\_RU)
----------------

[](#dataset-ru_ru)

### Address (ru)

[](#address-ru)

**ID**

> ru\_address

**Params**

- show\_flat: Whether to show flat number. 1 - show, 0 - hide

**Initialization string examples**

```
ru_address:show_flat=0
```

### City (ru)

[](#city-ru)

**ID**

> ru\_city

**Params**

No params

### Person (ru)

[](#person-ru)

**ID**

> ru\_person

**Params**

- sex: List of person's sex. m - Male, f - female. Default to both
- format: First name (%f), middle name (%m) and last name (%l) order. Default to "%l %f %m". %f1 - first letter of the first name, %m1 - first letter of the middle name, %l1 - last letter of ther first name

**Initialization string examples**

```
ru_person:format=%f %m %l
ru_person:format=%l %f1. %m1.
ru_person:sex=m

```

### Postcode (ru)

[](#postcode-ru)

**ID**

> ru\_postcode

**Params**

No params

### Street (ru)

[](#street-ru)

**ID**

> ru\_street

**Params**

No params

TODO
----

[](#todo)

- (-) Code style, mess detector, code metrics
- (-) CI
- (-) v1.0

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~108 days

Recently: every ~268 days

Total

11

Last Release

2231d ago

Major Versions

v0.9 → v1.02017-07-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/a4d8aa654a6c4369f6f7973de3e9f51bb97586c6894ae8540ec86aea1881f5fd?d=identicon)[KonstantinFilin](/maintainers/KonstantinFilin)

---

Top Contributors

[![KonstantinFilin](https://avatars.githubusercontent.com/u/2811794?v=4)](https://github.com/KonstantinFilin "KonstantinFilin (115 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kfilin-randdata/health.svg)

```
[![Health](https://phpackages.com/badges/kfilin-randdata/health.svg)](https://phpackages.com/packages/kfilin-randdata)
```

###  Alternatives

[magarrent/laravel-url-shortener

Simpler Url Shortener for Laravel

557.4k](/packages/magarrent-laravel-url-shortener)[bolt/collection

Object Orientated implementations of various collections

12118.6k5](/packages/bolt-collection)[pdazcom/laravel-referrals

A referrals system for a laravel projects.

291.5k](/packages/pdazcom-laravel-referrals)[grei/tanggalmerah

indonesia holiday checker (include sunday)

172.5k](/packages/grei-tanggalmerah)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)