README

Поддержка данного пакета остановлена, и вскоре он будет удалён. Пожалуйста, используйте альтернативный пакет: https://github.com/avto-dev/faker-providers

Faker-провайдеры для идентификационных номеров автомобилей

Данный пакет содержит провайдеры данных для пакета Faker, генерирующие идентификаторы, такие как:

Государственный регистрационный номер (ГРЗ);
VIN-код ТС (транспортного средства);
Номер свидетельства о регистрации ТС (СТС);
Номер паспорта ТС (ПТС);
Номер кузова ТС;
Номер шасси ТС;
Номер водительского удостоверения.

Каждый провайдер дополнительно содержит метод генерации невалидного идентификатора.

Установка

Для установки данного пакета выполните в терминале следующую команду:

$ composer require --dev avto-dev/faker-identifiers-providers "^1.1"

Для этого необходим установленный composer. Для его установки перейдите по данной ссылке.

Обратите внимание на то, что необходимо фиксировать мажорную версию устанавливаемого пакета.

Для использования дополнительных пакетов (после создания инстанса Faker\Generator) необходимо их зарегистрировать:

<php

use AvtoDev\FakerIdentifiersProviders\Providers\VinProvider;

$faker = Faker\Factory::create();
$faker->addProvider(new VinProvider($faker));

Интеграция с Laravel

Если вы используете Laravel то действий выше производить не требуется т.к. в пакете присутствует сервис провайдер который производит регистрацию дополнительных провайдеров автоматически.

Использование

Провайдер	Методы
VinProvider	`vinCode()` - генерирует случайный VIN-код `validVinCode()` алиас для `vinCode()` `invalidVinCode()` - генерирует невалидный VIN-код
GrzProvider	`grzCode()` - генерирует случайный ГРЗ `validGrzCode()` алиас для `grzCode()` `invalidGrzCode()` - генерирует невалидный ГРЗ
StsProvider	`stsCode()` - генерирует случайный номер СТС `validStsCode()` алиас для `stsCode()` `invalidStsCode()` - генерирует невалидный номер СТС
PtsProvider	`ptsCode()` - генерирует случайный номер ПТС `validPtsCode()` алиас для `ptsCode()` `invalidPtsCode()` - генерирует невалидный ПТС
BodyProvider	`bodyCode()` - генерирует случайный номер кузова `validBodyCode()` алиас для `bodyCode()` `invalidBodyCode()` - генерирует невалидный номер кузова
ChassisProvider	`chassisCode()` - генерирует случайный номер шасси `validChassisCode()` алиас для `chassisCode()` `invalidChassisCode()` - генерирует невалидный номер шасси
DriverLicenseNumberProvider	`driverLicenseNumber()` - генерирует случайный номер водительского удостоверения `validDriverLicenseNumber()` алиас для `driverLicenseNumber()` `invalidDriverLicenseNumber()` - генерирует невалидный номер водительского удостоверения

Пример использования

<?php

use AvtoDev\FakerIdentifiersProviders\Providers\VinProvider;

// All
$faker = Faker\Factory::create();
$faker->addProvider(new VinProvider($faker));
$code = $faker->vinCode();

// Laravel
$faker = app()->make(Faker\Generator::class);
$code = $faker->vinCode();

Тестирование

Для тестирования данного пакета используется фреймворк phpunit. Для запуска тестов выполните в терминале:

$ git clone git@github.com:avto-dev/faker-identifiers-providers.git ./faker-identifiers-providers && cd $_
$ composer install
$ composer test

Поддержка и развитие

Если у вас возникли какие-либо проблемы по работе с данным пакетом, пожалуйста, создайте соответствующий issue в данном репозитории.

Если вы способны самостоятельно реализовать тот функционал, что вам необходим - создайте PR с соответствующими изменениями. Крайне желательно сопровождать PR соответствующими тестами, фиксирующими работу ваших изменений. После проверки и принятия изменений будет опубликована новая минорная версия.

Лицензирование

Код данного пакета распространяется под лицензией [MIT][link_license].

avto-dev / faker-identifiers-providers

Maintainers

Details