• Stars
    star
    131
  • Rank 275,867 (Top 6 %)
  • Language
    PHP
  • License
    MIT License
  • Created over 10 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A PHP library to create interesting, sometimes entertaining, random names.

Random Name Generator

A PHP library to create interesting, sometimes entertaining, random names.

Build Status Scrutinizer Code Quality Coverage Status

Latest Stable Version Total Downloads License

Dependency Status

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 nubs/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 = \Nubs\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 \Nubs\RandomNameGenerator\All(
    [
        new \Nubs\RandomNameGenerator\Alliteration(),
        new \Nubs\RandomNameGenerator\Vgng()
    ]
);

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 \Nubs\RandomNameGenerator\Vgng();
echo $generator->getName();

Alliterative Names

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

Examples

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

Usage

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

License

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