PHPackages                             alwayscurious/wonderwords - 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. alwayscurious/wonderwords

ActiveLibrary[Utility & Helpers](/categories/utility)

alwayscurious/wonderwords
=========================

A wonderful way to generate random words, phrases, and sentences from curated word lists.

v1.0.0(2mo ago)0260—0%MITPHPPHP ^8.1

Since Mar 7Pushed 2mo agoCompare

[ Source](https://github.com/AlwaysCuriousCo/wonderwords)[ Packagist](https://packagist.org/packages/alwayscurious/wonderwords)[ RSS](/packages/alwayscurious-wonderwords/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

WonderWords
===========

[](#wonderwords)

A wonderful way to generate random words, phrases, and sentences from curated word lists.

Installation
------------

[](#installation)

```
composer require alwayscurious/wonderwords
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
use AlwaysCurious\WonderWords\WonderWords;

$ww = new WonderWords();

// Generate a random word
$ww->word();                    // "phoenix"

// Generate a random phrase (adjective + noun)
$ww->phrase();                  // "blazing phoenix"

// Generate a random sentence
$ww->sentence();                // "The fierce dragon roars mightily."

// Generate a slug
$ww->slug();                    // "crimson-falcon"
$ww->slug('_');                 // "crimson_falcon"
```

### Multiple Results

[](#multiple-results)

```
$ww->words('nouns', 3);         // ["phoenix", "glacier", "storm"]
$ww->phrases(5);                // ["bold raven", "cosmic ember", ...]
$ww->sentences(3);              // ["The swift falcon soars boldly.", ...]
```

### Custom Combinations

[](#custom-combinations)

```
use AlwaysCurious\WonderWords\WordList;

// Combine any categories in any order
$ww->combine([WordList::ADJECTIVES, WordList::NOUNS, WordList::VERBS]);
// "golden eagle soars"

// Use a custom separator
$ww->separator('-')->phrase();  // "blazing-phoenix"
```

### Word Categories

[](#word-categories)

Built-in categories: `adjectives`, `nouns`, `verbs`, `adverbs`

```
$ww->word(WordList::ADJECTIVES);  // "fierce"
$ww->word(WordList::NOUNS);       // "dragon"
$ww->word(WordList::VERBS);       // "roars"
$ww->word(WordList::ADVERBS);     // "mightily"
```

### Custom Word Lists

[](#custom-word-lists)

```
$ww = new WonderWords();

// Replace a built-in category
$ww->wordList()->setCategory('colors', ['red', 'blue', 'green']);

// Add words to an existing category
$ww->wordList()->addWords(WordList::NOUNS, ['spaceship', 'robot']);

// Use your custom category
$ww->word('colors');             // "blue"
```

Credits
-------

[](#credits)

This package is a PHP port inspired by the Python [WonderWords](https://wonderwords.readthedocs.io/en/latest/) library by mrmaxguns.

License
-------

[](#license)

MIT

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance87

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

64d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fa0676f3242298155f63579f1f3823e6cc441cb651e35aa4423494a30ccf22ce?d=identicon)[codearachnid](/maintainers/codearachnid)

---

Top Contributors

[![codearachnid](https://avatars.githubusercontent.com/u/755025?v=4)](https://github.com/codearachnid "codearachnid (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/alwayscurious-wonderwords/health.svg)

```
[![Health](https://phpackages.com/badges/alwayscurious-wonderwords/health.svg)](https://phpackages.com/packages/alwayscurious-wonderwords)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)