PHPackages                             chaos-php/chaos-monkey-symfony-bundle - 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. [Testing &amp; Quality](/categories/testing)
4. /
5. chaos-php/chaos-monkey-symfony-bundle

ActiveLibrary[Testing &amp; Quality](/categories/testing)

chaos-php/chaos-monkey-symfony-bundle
=====================================

Chaos Monkey for Symfony applications

1.0.0(1y ago)873451MITPHPPHP ^8.1

Since Jan 20Pushed 1y ago5 watchersCompare

[ Source](https://github.com/chaos-php/chaos-monkey-symfony-bundle)[ Packagist](https://packagist.org/packages/chaos-php/chaos-monkey-symfony-bundle)[ RSS](/packages/chaos-php-chaos-monkey-symfony-bundle/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (6)Dependencies (10)Versions (7)Used By (0)

ChaosMonkeySymfonyBundle
========================

[](#chaosmonkeysymfonybundle)

[![Minimum PHP Version](https://camo.githubusercontent.com/ef363a5a30025ffef1857918c40fa01e97f03929e5f87d12a14bf334a7de9220/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e312d3838393242462e737667)](https://php.net/)[![Symfony Versions Supported](https://camo.githubusercontent.com/6f32f15e7a8fcb0ae7a84edd2b2d0d0d39484e3e404b7604ad995e8adc14cfbf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73796d666f6e792d253545362e34253230253743253743253230253545372e302d677265656e)](https://camo.githubusercontent.com/6f32f15e7a8fcb0ae7a84edd2b2d0d0d39484e3e404b7604ad995e8adc14cfbf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73796d666f6e792d253545362e34253230253743253743253230253545372e302d677265656e)[![Packagist Version](https://camo.githubusercontent.com/879a2dcd23962c4a83890e044f5f822da78d757ae0d583daf11938188a5e8323/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6368616f732d7068702f6368616f732d6d6f6e6b65792d73796d666f6e792d62756e646c65)](https://packagist.org/packages/chaos-php/chaos-monkey-symfony-bundle)[![ci](https://github.com/chaos-php/chaos-monkey-symfony-bundle/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/chaos-php/chaos-monkey-symfony-bundle/actions/workflows/ci.yml)[![GitHub](https://camo.githubusercontent.com/52a3b137f86620032335dd9860a2b019e8c78db89afc1c179265f65d1f970bca/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6368616f732d7068702f6368616f732d6d6f6e6b65792d73796d666f6e792d62756e646c65)](https://camo.githubusercontent.com/52a3b137f86620032335dd9860a2b019e8c78db89afc1c179265f65d1f970bca/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6368616f732d7068702f6368616f732d6d6f6e6b65792d73796d666f6e792d62756e646c65)

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

Assaults
--------

[](#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()`

Watchers
--------

[](#watchers)

- **Request** - attack http request
- Repository (not implemented)
- Service (not implemented)

Activators
----------

[](#activators)

- "Query param" - attack only if given query param is present (default `chaos`)

Symfony
-------

[](#symfony)

How to use
----------

[](#how-to-use)

1. Install with composer: ```
    composer require chaos-php/chaos-monkey-symfony-bundle
    ```
2. Add Symfony bundle (e.g. `config/bundles.php`): ```
    return [
        //... other bundles
        Chaos\Monkey\Symfony\ChaosMonkeyBundle::class => ['all' => true],
    ];
    ```
3. Add `chaos_monkey.yaml` configuration (copy from below) and enable assaults
4. Watch your app plunge into chaos 🙈🙊🙉 😈

Configuration reference
-----------------------

[](#configuration-reference)

```
chaos_monkey:
    enabled: false
    probability: 20 # percentage probability of attack (100 - everyone, 0 - none)
    assaults:
        latency:
            active: false
            minimum: 1000 # in miliseconds
            maximum: 3000 # in miliseconds
        memory:
            active: false
            fill_fraction: 0.95 # percentage of memory filling
        exception:
            active: false
            class: 'RuntimeException'
        kill_app:
            active: false
    watchers: # currently watchers can be enabled/disabled only in container compile time
        request:
            enabled: true
            priority: 0
    activators:
       query_param: false # if true then chaos monkey will be called only if given query param exist (with any value)
       query_param_name: 'chaos'
```

Roadmap
-------

[](#roadmap)

- Flex recipe
- Metrics (for example `chaos_monkey_request_count_assaulted`)
- Assault profiles - each profile can contain different assaults
- CustomWatcher (based on container tag)
- CustomAssault (not implemented)

License
-------

[](#license)

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

Author
------

[](#author)

Arkadiusz Kondas (@ArkadiuszKondas)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 88.2% 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 ~246 days

Recently: every ~299 days

Total

6

Last Release

716d ago

Major Versions

0.5.0 → 1.0.02024-06-02

PHP version history (2 changes)0.1.0PHP ^7.4 || ^8.0

0.4.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/5d00e1e73a4ff379162b943421469055929a95e7a6ce4c3808976dcc1fa28f4f?d=identicon)[akondas](/maintainers/akondas)

---

Top Contributors

[![akondas](https://avatars.githubusercontent.com/u/8239917?v=4)](https://github.com/akondas "akondas (15 commits)")[![marmichalski](https://avatars.githubusercontent.com/u/57528542?v=4)](https://github.com/marmichalski "marmichalski (2 commits)")

---

Tags

chaos-engineeringchaos-monkeyphpquality-assurancesymfonysymfony-bundlephpsymfonyquality assurancechaos-monkeychaos-engineeringchaos-tests

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/chaos-php-chaos-monkey-symfony-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/chaos-php-chaos-monkey-symfony-bundle/health.svg)](https://phpackages.com/packages/chaos-php-chaos-monkey-symfony-bundle)
```

###  Alternatives

[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k43.5M5.2k](/packages/larastan-larastan)[chaos-php/chaos-monkey

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

283.5k1](/packages/chaos-php-chaos-monkey)[certificationy/certificationy

A library to create certification system

46930.7k1](/packages/certificationy-certificationy)[letsdrink/ouzo-goodies

Utility classes, test assertions and mocking framework extracted from Ouzo framework.

132617.9k7](/packages/letsdrink-ouzo-goodies)[df/php-coverfish

lightweight static code analysis tool for class coverage check of PHPUnit's CodeCoverage

234.9k1](/packages/df-php-coverfish)[sci3ma/symfony-grumphp

Configured GrumPHP with bunch of tools for static code analysis Symfony Framework

196.7k](/packages/sci3ma-symfony-grumphp)

PHPackages © 2026

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