minvws/horsebattery

A password generator inspired by https://xkcd.com/936/

v2.0.0 2026-04-24 14:58 UTC

Requires

• php: ^8.3

Requires (Dev)

• mockery/mockery: ^1.4.3
• phpstan/phpstan: ^2.0.0
• phpunit/phpunit: ^13.0
• rector/rector: ^2.0
• squizlabs/php_codesniffer: ^4.0

EUPL-1.2

• Joshua Thijssen
• Pauline Vos

• generator
• security
• password

README

A password generator based on this XKCD comic. Provides a default word list in Dutch and will generate a password based on the wordlist and a given number of words.

May be expanded to include other locales in the future or configuration to allow for other word lists.

Requirements

• PHP >= 8.1
• Composer

Installation

1. Install the package via composer:

composer require minvws/horsebattery

Usage

Generic usage

$generator = new HorseBattery();
$password = $generator->generate(4);

// returns for instance: AandeelBijkomendeDereguleringHandelingen

Running tests

You can run the tests by issuing the following command:

$ composer run test

Contributing

If you encounter any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request on the GitHub repository of this package.

License

This package is open-source and released under the European Union Public License version 1.2. You are free to use, modify, and distribute the package in accordance with the terms of the license.