probablyrational/random-name-generator

A library to create interesting, sometimes entertaining, random names. (Based on nubs/random-name-generator)

v2.2.3 2022-01-22 10:48 UTC

Requires

• php: ~5.6 || ~7.0 || ~8.0

Requires (Dev)

• cinam/randomizer: >=1.1.1,<2.0
• phpunit/phpunit: ~5.0
• satooshi/php-coveralls: ~1.0
• squizlabs/php_codesniffer: ~2.3

MIT

• Zachary Claret-Scott

• generator
• random
• video game
• alliteration
• sketchy

README

A PHP library to create interesting, sometimes entertaining, random names. Based on nubs/random-name-generator!

This fork will be maintained with adinitial generators intended for duct.me

Requirements

This library requires PHP 5.6, or newer.

Installation

This package uses composer so you can just add nubs/random-name-generator as a dependency to your composer.json file or execute the following command:

composer require probablyrational/random-name-generator

Generators

All

The "all" generator will utilize all other configured generators to generate random names. It will select from the list of generators randomly and then use them to generate a random name using their functionality.

Usage

$generator = \ProbablyRational\RandomNameGenerator\All::create();
echo $generator->getName();

Alternatively, if you want to configure/build the generators to use instead of using all of the available generators, you can construct them yourself:

$generator = new \ProbablyRational\RandomNameGenerator\All(
    [
        new \ProbablyRational\RandomNameGenerator\Alliteration(1),
        new \ProbablyRational\RandomNameGenerator\Vgng(1),
        new \ProbablyRational\RandomNameGenerator\Sketch(1)
    ]
);

Video Game Names

The video game name generator is based off of prior art. It will generate unique names based off of "typical" video games.

Examples

• Kamikaze Bubblegum Warrior
• Rockin' Valkyrie Gaiden
• Neurotic Jackhammer Detective
• My Little Mountain Climber Conflict
• Small-Time Princess vs. The Space Mutants

You can also use this web example to see more example video game names generated by this library.

Usage

$generator = new \ProbablyRational\RandomNameGenerator\Vgng(1);
echo $generator->getName();

Alliterative Names

The sketchy name generator is based off of a server called verylegit.

Examples

• Agreeable Anaconda
• Disturbed Duck
• Misty Meerkat
• Prickly Pig

Usage

$generator = new \ProbablyRational\RandomNameGenerator\Alliteration(1);
echo $generator->getName();

Sketchy Names

The alliteration name generator is based off of a list of adjectives and a list of animals.

Examples

• Verification-safe.com2Fcryptolocker.js3Fauthorize=action
• Facebook.com2Ftrojan.gp3Fjava0day=x64
• Google.com2Fpccleaner.rar3Fpassword=pccleaner
• Appleeid-apple.com2Fwebcam.gp3Flogin=ip-camera

Usage

$generator = new \ProbablyRational\RandomNameGenerator\Sketch(1);
echo $generator->getName();

License

random-name-generator is licensed under the MIT license. See LICENSE for the full license text.