PHPackages                             smile/gdpr-dump - 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. [Database &amp; ORM](/categories/database)
4. /
5. smile/gdpr-dump

ActiveLibrary[Database &amp; ORM](/categories/database)

smile/gdpr-dump
===============

A utility to create anonymized database dumps

5.0.7(2mo ago)21633.1k↓14.5%58[1 issues](https://github.com/Smile-SA/gdpr-dump/issues)[3 PRs](https://github.com/Smile-SA/gdpr-dump/pulls)1GPL-3.0-or-laterPHPPHP ^8.1CI passing

Since Feb 6Pushed 2mo ago10 watchersCompare

[ Source](https://github.com/Smile-SA/gdpr-dump)[ Packagist](https://packagist.org/packages/smile/gdpr-dump)[ RSS](/packages/smile-gdpr-dump/feed)WikiDiscussions 5.x Synced 1mo ago

READMEChangelog (10)Dependencies (18)Versions (54)Used By (1)

GdprDump
========

[](#gdprdump)

[![Latest Stable Version](https://camo.githubusercontent.com/7910a31014208e7615764ac4bab0604c32d70c4dd1efc80f32bd7c6104a0d60c/68747470733a2f2f706f7365722e707567782e6f72672f736d696c652f676470722d64756d702f762f737461626c65)](https://packagist.org/packages/smile/gdpr-dump)[![Build Status](https://github.com/Smile-SA/gdpr-dump/workflows/Tests/badge.svg)](https://github.com/Smile-SA/gdpr-dump/workflows/Tests/badge.svg)

This tool provides a command that dumps the contents of a MySQL database.

It is the equivalent of mysqldump, with additional features, at the cost of performance (PHP implementation). The main purpose of this tool is to create anonymized dumps, in order to comply with GDPR regulations.

Features:

- Data converters (transform the data before it is dumped to the file).
- Recursive table filtering.
- Tables whitelist (only these tables will be included in the dump).
- Tables blacklist (not included in the dump).
- Dump options (compression, output type...).
- Predefined configuration templates (Magento, Drupal, OroCommerce).

Documentation
-------------

[](#documentation)

The documentation (including installation instructions) is available in the [wiki](https://github.com/Smile-SA/gdpr-dump/wiki).

Community Templates
-------------------

[](#community-templates)

While it is not the aim of this project to cover each framework, you are encouraged to publish your templates on GitHub under the topic [smile-sa-gdpr-dump-template](https://github.com/topics/smile-sa-gdpr-dump-template).

FAQ
---

[](#faq)

**Why don't you use Doctrine to generate the dump?**

The goal of Doctrine is to support a wide array of DBMS. It does not support features that are specific to some databases.

For example, in MySQL, it is possible to create an index on BLOB columns. There is a restriction though, you need to specify the length of the index.

This feature is used in Magento 2. Since Doctrine does not support this feature, it cannot be used to create a working dump file of a Magento 2 database. The following error would trigger during the import of the generated dump file:

```
ERROR 1170 (42000) at line 254: BLOB/TEXT column 'code' used in key specification without a key length

```

Also, the schema manager of Doctrine can only manage tables. It does not handle triggers, procedures, views...

As a consequence, we don't use Doctrine to generate the dump file. The dump file is generated with [MySQLDump-PHP](https://github.com/druidfi/mysqldump-php) instead, which is only compatible with MySQL.

Contributing
------------

[](#contributing)

You can contribute to this module by submitting issues or pull requests.

For more details, please take a look at the [contribution guidelines](CONTRIBUTING.md).

License
-------

[](#license)

This project is licensed under the [GPLv3 License](LICENSE.md).

Changelog
---------

[](#changelog)

All notable changes are recorded in this [changelog](CHANGELOG.md).

Contact
-------

[](#contact)

Smile Technical Direction

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance84

Actively maintained with recent releases

Popularity49

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 98.1% 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 ~51 days

Recently: every ~81 days

Total

44

Last Release

84d ago

Major Versions

1.2.2 → 2.0.22020-07-28

1.2.3 → 2.0.32020-10-05

2.x-dev → 3.0.02022-07-28

3.x-dev → 4.0.02023-01-10

4.x-dev → 5.0.02024-07-01

PHP version history (5 changes)1.0.0PHP ^7.0

2.0.0PHP ^7.3

2.1.0PHP ^7.3 || ^8.0

3.0.0PHP ^7.4 || ^8.0

4.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/c158652d318dfb93e48bdda8c3c514ed91b7c0ae7e848e33c99bf8efd852c9d6?d=identicon)[smile-sa](/maintainers/smile-sa)

![](https://www.gravatar.com/avatar/965d8c2ff0fdcac3a8b6058d27705410e735b11b6a0e926fcd0cc6c2ce87e4ba?d=identicon)[guvra](/maintainers/guvra)

---

Top Contributors

[![guvra](https://avatars.githubusercontent.com/u/3967259?v=4)](https://github.com/guvra "guvra (621 commits)")[![amenk](https://avatars.githubusercontent.com/u/1087128?v=4)](https://github.com/amenk "amenk (4 commits)")[![marob](https://avatars.githubusercontent.com/u/3486231?v=4)](https://github.com/marob "marob (2 commits)")[![rbayet](https://avatars.githubusercontent.com/u/2353374?v=4)](https://github.com/rbayet "rbayet (1 commits)")[![Ryangr0](https://avatars.githubusercontent.com/u/3602480?v=4)](https://github.com/Ryangr0 "Ryangr0 (1 commits)")[![staabm](https://avatars.githubusercontent.com/u/120441?v=4)](https://github.com/staabm "staabm (1 commits)")[![Swahjak](https://avatars.githubusercontent.com/u/4386577?v=4)](https://github.com/Swahjak "Swahjak (1 commits)")[![clxmstaab](https://avatars.githubusercontent.com/u/47448731?v=4)](https://github.com/clxmstaab "clxmstaab (1 commits)")[![moay](https://avatars.githubusercontent.com/u/3605512?v=4)](https://github.com/moay "moay (1 commits)")

---

Tags

anonymizationdatabasegdprmysqlmysql-backupmysqldumppdophpphp-library

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/smile-gdpr-dump/health.svg)

```
[![Health](https://phpackages.com/badges/smile-gdpr-dump/health.svg)](https://phpackages.com/packages/smile-gdpr-dump)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[behat/behat

Scenario-oriented BDD framework for PHP

4.0k96.8M2.0k](/packages/behat-behat)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

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