chaos-php/chaos-monkey

Chaos Monkey is a resiliency tool that helps PHP applications tolerate random failures

Maintainers

Details

github.com/chaos-php/chaos-monkey

Source

Issues

Installs: 2 907

Dependents: 1

Suggesters: 0

Security: 0

Stars: 28

Watchers: 3

Forks: 2

Open Issues: 0

pkg:composer/chaos-php/chaos-monkey

1.1.1 2024-06-01 19:14 UTC

Requires

Requires (Dev)

MIT 71904ee8de8628bf294ae1eeba437fa3fc4d5d9f

  • Arkadiusz Kondas <arkadiusz.kondas.woop@gmail.com>

phpquality-assurancechaos-monkeychaos-engineeringchaos-tests

This package is auto-updated.

Last update: 2025-10-28 08:45:29 UTC

README

Minimum PHP Version build Latest Stable Version GitHub

Chaos Monkey for PHP applications. Try to attack your running PHP App.

Assaults

  • Latency Assault - adds a delay randomly from the range (min and max)
  • Exception Assault - throws given exception class
  • Memory Assault - fill memory until target fraction (95% for example)
  • Kill Assault - no mercy, plain exit()

How to use

The best experience you can get is using ready-made integrations:

If your framework is missing, open an issue or use this package manually:

  1. Install with composer: 
    composer require chaos-php/chaos-monkey
  2. Create ChaosMonkey object 
    $settings = new Settings();
$chaosMonkey = new ChaosMonkey([
   new LatencyAssault($settings),
   new MemoryAssault($settings),
   new ExceptionAssault($settings),
   new KillAppAssault($settings)
], $settings);
  3. Configure settings and trigger chaos monkey in the working place of the application: 
    $settings->setExceptionActive(true);
$settings->setExceptionClass(\RuntimeException::class);
$settings->setProbability(100);
$settings->setEnabled(true);


$chaosMonkey->call();
  4. Watch your app plunge into chaos 🙈🙊🙉 😈

License

ChaosMonkey is released under the MIT Licence. See the bundled LICENSE file for details.

Author

Arkadiusz Kondas