mbezhanov / faker-provider-collection
A collection of custom providers for the Faker library
Installs: 5 595 997
Dependents: 16
Suggesters: 0
Security: 0
Stars: 195
Watchers: 6
Forks: 29
Open Issues: 1
Requires
- php: ^7.4|^8.0
- fakerphp/faker: ^1.13
Requires (Dev)
- php-mock/php-mock: ^2.3
- phpunit/phpunit: ^9.5
README
A growing collection of useful Providers for fakerphp/faker mostly ported to PHP from the stympy/faker Ruby library.
Contents
Installation
composer require mbezhanov/faker-provider-collection
Basic Usage
You can use the ProviderCollectionHelper
utility class to quickly add all providers to the Faker generator:
<?php $faker = \Faker\Factory::create(); \Bezhanov\Faker\ProviderCollectionHelper::addAllProvidersTo($faker);
Formatters
Below is the list of bundled formatters in the default locale.
Bezhanov\Faker\Provider\Avatar
Generates an avatar URL using the RoboHash web service.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Avatar($faker)); $faker->avatar; // https://robohash.org/repellat-veritatis-consequatur.png?size=300x300&set=set1 $faker->avatar('foo'); // https://robohash.org/foo.png?size=300x300&set=set1 $faker->avatar('foo', '300x300'); // https://robohash.org/foo.png?size=300x300&set=set1 $faker->avatar('foo', '300x300', 'jpg'); // https://robohash.org/foo.jpg?size=300x300&set=set1 $faker->avatar('foo', '300x300', 'jpg', 'set2'); // https://robohash.org/foo.jpg?size=300x300&set=set2 $faker->avatar('foo', '300x300', 'jpg', 'set2', 'bg2'); // https://robohash.org/foo.jpg?size=300x300&set=set2&bgset=bg2
Bezhanov\Faker\Provider\Commerce
Generates product and department data for e-commerce websites and online stores.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Commerce($faker)); $faker->promotionCode; // KillerPromotion257835 $faker->department; // Kids & Games $faker->department(6); // Games, Industrial, Books & Automotive $faker->department(3, true); // Jewelry, Music & Shoes $faker->category; // Computers $faker->productName; // Small Rubber Bottle
Bezhanov\Faker\Provider\Device
Generates random mobile device specifications
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Device($faker)); $faker->deviceBuildNumber; // 186 $faker->deviceManufacturer; // Apple $faker->deviceModelName; // iPhone 4 $faker->devicePlatform; // Ubuntu Touch $faker->deviceSerialNumber; // ejfjnRNInxh0363JC2WM $faker->deviceVersion; // 812
Bezhanov\Faker\Provider\Demographic
Generates random demographic data, such as: race, gender, demonym, educational attainment, height
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Demographic($faker)); $faker->race; // Asian $faker->educationalAttainment; // Master's degree $faker->demonym; // Bulgarian $faker->maritalStatus; // Married $faker->gender; // Female $faker->height; // 1.99 $faker->height(Demographic::UNIT_TYPE_IMPERIAL); // 7 ft, 2 in
Bezhanov\Faker\Provider\Educator
Generates secondary school and university names, and course names.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Educator($faker)); $faker->university; // Clearcourt University $faker->secondarySchool; // Mallowpond High $faker->course; // Bachelor of Forensic Science $faker->campus; // Brighthurst Campus
Bezhanov\Faker\Provider\Food
Generates ingredient names, spice names, and recipe measurements.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Food($faker)); $faker->ingredient; // Hazelnut $faker->spice; // Chamomile $faker->measurement; // 1 pint
Bezhanov\Faker\Provider\Medicine
Generates fake medicine names.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Medicine($faker)); $faker->medicine; // Amphevorin
Bezhanov\Faker\Provider\Placeholder
Generates URLs to placeholder images using the Placeholder.com image placeholder service.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Placeholder($faker)); $faker->placeholder(); // https://placehold.it/300x300.png $faker->placeholder('250x250'); // https://placehold.it/250x250.png $faker->placeholder('250x250', 'jpg'); // https://placehold.it/250x250.jpg $faker->placeholder('250x250', 'jpg', 'ff0000'); // https://placehold.it/250x250.jpg/ff0000 $faker->placeholder('250x250', 'jpg', 'f00', '000000'); // https://placehold.it/250x250.jpg/f00/000000 $faker->placeholder('250x250', 'jpg', 'ff0000', '000', 'test'); // https://placehold.it/250x250.jpg/ff0000/000?text=test
Bezhanov\Faker\Provider\Science
Generates names of scientists and chemical elements
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Science($faker)); $faker->chemicalElement; // Radium $faker->chemicalElementSymbol; // Fe $faker->scientist; // Max Planck
Bezhanov\Faker\Provider\Space
Generates names of astronomical objects, distance measurements, spacecrafts, etc.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Space($faker)); $faker->planet; // Neptune $faker->moon; // Europa $faker->galaxy; // Andromeda $faker->nebula; // Orion Nebula $faker->starCluster; // Palomar 6 $faker->constellation; // Ursa Major $faker->star; // Luyten 726-8B $faker->agency; // Japan Aerospace Exploration Agency $faker->agencyAbv; // NASA $faker->nasaSpaceCraft; // Atlantis $faker->spaceCompany; // SpaceX $faker->distanceMeasurement; // 43 kiloparsecs $faker->meteorite; // Qidong $faker->launchVehicle; // Saturn IV
Bezhanov\Faker\Provider\Species
Generates scientific names of fictional bird, animal, and plant species.
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Species($faker)); echo $faker->bird . PHP_EOL; // Rostratula subis echo $faker->creature . PHP_EOL; // Latrodectus indri echo $faker->plant . PHP_EOL; // Pyrus filiformis
Bezhanov\Faker\Provider\Team
Generates sports and sports team names
<?php $faker = \Faker\Factory::create(); $faker->addProvider(new \Bezhanov\Faker\Provider\Team($faker)); $faker->team; // Oregon Tigers $faker->sport; // soccer
Integrations
Contributing
All contributions are welcome. Before opening PRs, make sure that all tests are passing, and that code coverage is satisfactory:
phpunit tests --coverage-html coverage