PHPackages chypriote/unique-names-generator - 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. chypriote/unique-names-generator ActiveLibrary[Utility & Helpers](/categories/utility) chypriote/unique-names-generator ================================ A package to create readable, meaningful, random strings from animal names, colors and adjectives. v0.0.4(4mo ago)76.0k2MITPHPPHP >=7.4 Since Jan 20Pushed 4mo ago2 watchersCompare [ Source](https://github.com/chypriote/UniqueNamesGenerator)[ Packagist](https://packagist.org/packages/chypriote/unique-names-generator)[ RSS](/packages/chypriote-unique-names-generator/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (1)Versions (4)Used By (0) Unique Names Generator ====================== [](#unique-names-generator) [![Latest Version on Packagist](https://camo.githubusercontent.com/b6ed40436d57480a27271869480edd7d35c0439259eb05b360f33278cc7a23c9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6368797072696f74652f756e697175652d6e616d65732d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chypriote/UniqueNamesGenerator)[![GitHub](https://camo.githubusercontent.com/ca9121d499ebfbb208143b13cd79de48247e8a7094e5e699ce5609c59bac5cde/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6368797072696f74652f556e697175654e616d657347656e657261746f72)](https://camo.githubusercontent.com/ca9121d499ebfbb208143b13cd79de48247e8a7094e5e699ce5609c59bac5cde/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6368797072696f74652f556e697175654e616d657347656e657261746f72)[![Packagist Downloads](https://camo.githubusercontent.com/9dd13ee324a28af55f93a29c6f102ccbc23a3862112d4bd213567ac03b5c476e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6368797072696f74652f756e697175652d6e616d65732d67656e657261746f72)](https://camo.githubusercontent.com/9dd13ee324a28af55f93a29c6f102ccbc23a3862112d4bd213567ac03b5c476e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6368797072696f74652f756e697175652d6e616d65732d67656e657261746f72) A package to create readable, meaningful, random strings from animal names, colors and adjectives. > More than 50,000,000 name combinations out of the box Why Unique name generator? -------------------------- [](#why-unique-name-generator) I needed a way to generate unique and rememberable names a la giphy (i.e. BlueGiantHorse) and was unable to find one in the wild. Moreover, I needed a way to obtain the same result from a specific string in certain cases. Installation ------------ [](#installation) Just require the package through composer: ``` composer require chypriote/unique-names-generator ``` Usage ----- [](#usage) Instantiate a new Generator and call the generate function in order to get a random adjective + animal combo. ``` $generator = new Generator(); $name = $generator->generate(); echo $name; // --> PlannedRhinoceros ``` Subsequent calls will give you different results: ``` $generator = new Generator(); echo $generator->generate(); // --> TypicalWolf echo $generator->generate(); // --> QualifiedKoala echo $generator->generate(); // --> ConfusedCarp echo $generator->generate(); // --> DepressedCanid ``` You can configure the list of dictionaries used: ``` $generator = new Generator(); $generator->setDictionaries(['colors', 'animals']); echo $generator->generate(); // --> OrangeWolverine echo $generator->generate(); // --> MagentaMarten echo $generator->generate(); // --> RedKingfisher echo $generator->generate(); // --> AquaPigeon ``` Available dictionaries are: - **adjectives**: List of 1500+ adjectives (default) - **animals**: List of 300+ animals (default) - **colors**: List of 50+ colors - **countries**: List of countries - **names**: List of ~5000 names - **star wars**: List of Star Wars characters - **languages**: List of 100+ languages In order to use more than 2 dictionaries, you need to set the `length` parameter of the generator: ``` $generator = new Generator(); $generator->setDictionaries(['colors', 'adjectives', 'animals'])->setLength(3); echo $generator->generate(); // --> AzureLinguisticMongoose echo $generator->generate(); // --> TurquoiseCanadianPuffin echo $generator->generate(); // --> EmeraldWideFirefly echo $generator->generate(); // --> PinkBloodyGoldfish ``` You can also get even more different results by enabling the shuffle parameter. This will shuffle the dictionaries on each call of the generator: ``` $generator = new Generator(); $generator ->setDictionaries(['colors', 'adjectives', 'animals']) ->setLength(3) ->setShuffle(true); echo $generator->generate(); // --> CyanFiercePig echo $generator->generate(); // --> NervousAzureUnicorn echo $generator->generate(); // --> CoralLizardFellow echo $generator->generate(); // --> EducationalKingfisherJade ``` You can enter a seed in order to get predictable results for repeated calls: ``` $generator = new Generator(); $generator->setSeed(1234); echo $generator->generate(); // --> GreatKangaroo echo $generator->generate(); // --> ParentalCentipede $generator = new Generator(); $generator->setSeed(1234); echo $generator->generate(); // --> GreatKangaroo echo $generator->generate(); // --> ParentalCentipede ``` Seeds can be either an `integer` or a `string`. TODO-list --------- [](#todo-list) - Possibility to add custom dictionaries - Unit tests FAQ --- [](#faq) **Q: Can this package do *feature*?** A: I created this package out of a need for a personal project. If you have some suggestions feel free to open an issue or a PR! ### Health Score 44 — FairBetter than 91% of packages Maintenance81 Actively maintained with recent releases Popularity29 Limited adoption so far Community11 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 62.5% 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 ~902 days Total 3 Last Release 130d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/e7394bdefd2b1c453a4877ee470f721097c39fb01f907ee3b9b3e9457a734841?d=identicon)[chypriote](/maintainers/chypriote) --- Top Contributors [![chypriote](https://avatars.githubusercontent.com/u/4965058?v=4)](https://github.com/chypriote "chypriote (5 commits)")[![salamwaddah](https://avatars.githubusercontent.com/u/26627088?v=4)](https://github.com/salamwaddah "salamwaddah (3 commits)") --- Tags randomsluggeneratorcolornameadjectiveanimal ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/chypriote-unique-names-generator/health.svg) ``` [![Health](https://phpackages.com/badges/chypriote-unique-names-generator/health.svg)](https://phpackages.com/packages/chypriote-unique-names-generator) ``` ### Alternatives [mistic100/randomcolor Generate attractive random colors 2431.4M6](/packages/mistic100-randomcolor)[ihor/nspl Non-standard PHP library (NSPL) - functional primitives toolbox and more 381368.5k](/packages/ihor-nspl)[nubs/random-name-generator A library to create interesting, sometimes entertaining, random names. 135680.2k3](/packages/nubs-random-name-generator)[gladcodes/keygen A fluent PHP random key generator. 119668.9k2](/packages/gladcodes-keygen)[markrogoyski/itertools-php Iteration tools for PHP 14911.3k](/packages/markrogoyski-itertools-php)[claudiodekker/word-generator Generates random words by combining adjectives and nouns 4155.2k2](/packages/claudiodekker-word-generator) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)