Skip to content
On this page
developed by

Create and share your own pack of anonymizers

You created a bunch of anonymizers and want to reuse them easily? May be you also want to share them with the community?

The DbToolsBundle help you to do so with a github template repository.

After you created a fresh repository from this template, follow these steps to set up your pack:

1. Adapt the template to your repository

Now you have your repository. Let's say its name is my-vendor/pack-awesome.

First, you will need to adapt the provided composer.json:

    "name": "db-tools-bundle/pack-template",
    "name": "my-vendor/pack-awesome",
    "description": "An example pack of anonymizers for the DbToolsBundle",
    "description": "An awesome pack for anonymizing many things!",
    "type": "db-tools-bundle-pack",
    "license": "MIT",
    "authors": [
            "name": "Makina Corpus", 
            "homepage": "" 
    "minimum-stability": "stable",
    "prefer-stable": true,
    "require": {
        "php": ">=8.1",
        "makinacorpus/db-tools-bundle": "^0.3"
    "require-dev": {
        "friendsofphp/php-cs-fixer": "^3.34",
        "phpstan/phpstan": "^1.10",
        "phpunit/phpunit": "^10.3",
        "symfony/framework-bundle": "^6.0",
        "symfony/validator": "^6.3"
    "autoload": {
        "psr-4": {
            "DbToolsBundle\\PackExample\\" : "src/"
            "DbToolsBundle\\PackAwesome\\" : "src/"
    "autoload-dev": {
        "psr-4": {
            "DbToolsBundle\\PackExample\\Tests\\": "tests/"
            "DbToolsBundle\\PackAwesome\\Tests\\": "tests/"
    "config": {
        "sort-packages": true
    "scripts": {
        "phpcs": "./vendor/bin/php-cs-fixer fix --verbose --allow-risky=yes",
        "phpstan": "./vendor/bin/phpstan --memory-limit=1G",
        "checks": [
        "dry-checks": [
            "@phpcs --dry-run",

Then, after reading it, delete examples:

rm src/Anonymizer/MyAnonymizer.php
rm tests/Functional/Anonymizer/MyAnonymizerTest.php

After that, bootstrap your README with the given example:


And adapt it:

# DbToolsBundle - Pack [your pack name]
# DbToolsBundle - Awesome pack
[a short description]
An awesome pack for anonymizing many things!

This pack provides:

* `my-pack:anonymizer-1`: a short description of this anonymizer 
* `my-pack:anonymizer-2`: a short description of this anonymizer 
* `my-pack:anonymizer-3`: a short description of this anonymizer 
Fill this later 

## Installation

Run the following command to add this pack to your application:

composer require db-tools-bundle/pack-[your pack]
composer require my-vendor/pack-awesome

Learn more about how to use this package reading [the DbToolsBundle documentation]( on Read the Docs.

## Licence

This software is published under the [MIT License](./

2. Develop your anonymizers

Now you are ready to add your own anonymizers. Put them in src/Anonymizer.


Learn more about how to develop them reading the Custom Anonymizers section.

3. Test your anonymizers

After you built your anonymizers, don't forget to test them. We recommend doing at least one functionnal test per anonymizer. To inspire you doing these tests, read existing tests in the DbToolsBundle or in official packs.

To help you launchning these tests, use provided script, see Development guide section to learn how to use it.

5. Share your pack on packagist

If you want to share it and make it easily installable, share your package on Packagist.

6. Make it an official pack


  • you find your package good enough,
  • it is well tested,
  • you think it is generic enough to interest a large number of people,

Then, you should consider to add it to the official packs list.

Doing so, your package will be more visible (it will be added to this documentation) but it will also be automatically tested by a CI every week from the packs-status repository.

This CI will:

  • Check Coding standards (with PHP CS Fixer)
  • Launch a Static Analysis (with PHPStan)
  • Launch PHPUnit tests on different database vendors and PHP versions
  • Will, on every fail, create an issue on your pack repository to warn you

To ask your package to be part of official list, open an issue on the packs-status repository.


Note that to have your pack becoming an official one, you will need to transfere the repository to the DbToolsBundle Organization.

Released under the MIT License.