PHPackages                             eloquent/dumpling - 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 & ORM](/categories/database)
4. /
5. eloquent/dumpling

AbandonedArchivedLibrary[Database & ORM](/categories/database)

eloquent/dumpling
=================

Diff-friendly mysqldump with an improved interface.

0.2.2(12y ago)1481MITPHPPHP >=5.3

Since Aug 30Pushed 12y ago1 watchersCompare

[ Source](https://github.com/eloquent/dumpling)[ Packagist](https://packagist.org/packages/eloquent/dumpling)[ Docs](https://github.com/eloquent/dumpling)[ RSS](/packages/eloquent-dumpling/feed)WikiDiscussions develop Synced 1mo ago

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

Dumpling
========

[](#dumpling)

*Diff-friendly mysqldump with an improved interface.*

[![The most recent stable version is 0.2.2](https://camo.githubusercontent.com/32078412d0d36fe088f2753c8056a97f6d0b2d1ad261e421023319bf365589dd/687474703a2f2f696d672e736869656c64732e696f2f3a73656d7665722d302e322e322d79656c6c6f772e737667 "This project uses semantic versioning")](http://semver.org/)[![Current build status image](https://camo.githubusercontent.com/225c2830330f2504e6d00392bf0dd0fa948e95eebe4af44cf4406aba74fbfd81/687474703a2f2f696d672e736869656c64732e696f2f7472617669732f656c6f7175656e742f64756d706c696e672f646576656c6f702e737667 "Current build status for the develop branch")](https://travis-ci.org/eloquent/dumpling)[![Current coverage status image](https://camo.githubusercontent.com/8ee009a78815ab41e63be0387e3d21fc6b42c66c5e06ca7d10671f1461b208df/687474703a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f656c6f7175656e742f64756d706c696e672f646576656c6f702e737667 "Current test coverage for the develop branch")](https://coveralls.io/r/eloquent/dumpling)

Installation and documentation
------------------------------

[](#installation-and-documentation)

- Available as [Composer](http://getcomposer.org/) package [eloquent/dumpling](https://packagist.org/packages/eloquent/dumpling).
- [Executable phar](http://lqnt.co/dumpling/dumpling) available for download.
- [API documentation](http://lqnt.co/dumpling/artifacts/documentation/api/) available.

What is *Dumpling*?
-------------------

[](#what-is-dumpling)

*Dumpling* is a wrapper for [mysqldump](http://dev.mysql.com/doc/refman/5.7/en/mysqldump.html) that uses sensible defaults, and provides a streamlined interface. *Dumpling* is designed to be as intuitive and simple to use as possible.

*Dumpling* still uses mysqldump internally, so it's 100% compatible. It also produces output which is much more diff-friendly than standard mysqldump.

What's wrong with mysqldump?
----------------------------

[](#whats-wrong-with-mysqldump)

- Outputs internal databases like `mysql` and `information_schema` which are useless in 99% of cases (and potentially dangerous when importing).
- Extreme line length on extended INSERT statements causes havok for many text editors.
- Diffing of extended INSERT statements is useless, because of line length, and unpredictable row order.
- Leaves out important procedure and function information by default.
- Command line interface is cluttered and inflexible; inclusion/exclusion of databases and tables is inconsistent and limited.
- Raw binary data ruins portability & human readability.
- Command line interface uses non-standard conventions for options and their values.

Dumpling usage
--------------

[](#dumpling-usage)

```
Usage:
 dumpling [database] [table1] ... [tableN]

Arguments:
 database                The database to dump.
 table                   The table(s) to dump. Expects database.table format.

Options:
 --database (-D)         Additional database(s) to dump. (multiple values allowed)
 --exclude-database (-X) Database(s) to ignore. (multiple values allowed)
 --table (-T)            Additional table(s) to dump. Expects database.table format. (multiple values allowed)
 --exclude-table (-x)    Table(s) to ignore. (multiple values allowed)
 --no-data (-d)          Do not dump table data.
 --host (-H)             The server hostname or IP address. (default: "localhost")
 --port (-P)             The server port. (default: "3306")
 --user (-u)             The user to connect as. (default: "root")
 --password (-p)         The password for the user.
 --help (-h)             Display this help message.
 --version (-V)          Display this application version.

```

Usage examples
--------------

[](#usage-examples)

### Dumping localhost as root with no password

[](#dumping-localhost-as-root-with-no-password)

```
dumpling

```

### Excluding databases

[](#excluding-databases)

```
dumpling --exclude-database database_a

```

### Excluding data

[](#excluding-data)

```
dumpling --no-data

```

### Dumping one specific database

[](#dumping-one-specific-database)

```
dumpling database_name

```

### Dumping one specific table

[](#dumping-one-specific-table)

```
dumpling database_name table_name

```

### Dumping two specific tables from different databases

[](#dumping-two-specific-tables-from-different-databases)

```
dumpling --table database_a.table --table database_b.table

```

Requirements
------------

[](#requirements)

- [PHP](http://php.net/) >= 5.3
- [mysqldump](http://dev.mysql.com/doc/refman/5.7/en/mysqldump.html) >= 5.1.2

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~55 days

Total

4

Last Release

4479d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/100152?v=4)[Erin](/maintainers/ezzatron)[@ezzatron](https://github.com/ezzatron)

---

Top Contributors

[![ezzatron](https://avatars.githubusercontent.com/u/100152?v=4)](https://github.com/ezzatron "ezzatron (17 commits)")

---

Tags

clidumpmysqlmysqldumpcommandimproved

### Embed Badge

![Health badge](/badges/eloquent-dumpling/health.svg)

```
[![Health](https://phpackages.com/badges/eloquent-dumpling/health.svg)](https://phpackages.com/packages/eloquent-dumpling)
```

###  Alternatives

[spatie/db-dumper

Dump databases

1.2k25.9M69](/packages/spatie-db-dumper)[ifsnop/mysqldump-php

PHP version of mysqldump cli that comes with MySQL

1.3k5.5M69](/packages/ifsnop-mysqldump-php)[rah/danpu

Zero-dependency MySQL dump library for easily exporting and importing databases

64401.8k10](/packages/rah-danpu)[mysql-workbench-schema-exporter/mysql-workbench-schema-exporter

MySQL Workbench Schema Exporter

488188.5k10](/packages/mysql-workbench-schema-exporter-mysql-workbench-schema-exporter)[cytopia/mysqldump-secure

Secure mysqldump script with encryption, compression, logging, blacklisting and Nagios monitoring integration

1474.7k1](/packages/cytopia-mysqldump-secure)[phpsu/phpsu

Synchronisation Utility: File and Database

1685.6k](/packages/phpsu-phpsu)

PHPackages © 2026

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