This is a PHP version of mysqldump
cli that comes with MySQL. It can be used for interacting with the data before
creating the database dump. E.g. it can modify the contents of tables and is thus good for anonymize data.
Out of the box, mysqldump-php
supports backing up table structures, the data itself, views, triggers and events.
mysqldump-php
supports:
- output binary blobs as hex
- resolves view dependencies (using Stand-In tables)
- output compared against original mysqldump
- dumps stored routines (functions and procedures)
- dumps events
- does extended-insert and/or complete-insert
- supports virtual columns from MySQL 5.7
- does insert-ignore, like a REPLACE but ignoring errors if a duplicate key exists
- modifying data from database on-the-fly when dumping, using hooks
- can save directly to Google Cloud storage over a compressed stream wrapper (GZIPSTREAM)
- PHP 7.4 or 8.x with PDO - see supported versions
- MySQL 5.7 or newer (and compatible MariaDB)
Install using Composer:
composer require druidfi/mysqldump-php
<?php
try {
$dump = new \Druidfi\Mysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
$dump->start('storage/work/dump.sql');
} catch (\Exception $e) {
echo 'mysqldump-php error: ' . $e->getMessage();
}
Refer to the ifsnop/mysqldump-php Wiki for some examples and a comparison between mysqldump and mysqldump-php dumps.
You can register a callable that will be used to transform values during the export. An example use-case for this is removing sensitive data from database dumps:
$dumper = new \Druidfi\Mysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
$dumper->setTransformTableRowHook(function ($tableName, array $row) {
if ($tableName === 'customers') {
$row['social_security_number'] = (string) rand(1000000, 9999999);
}
return $row;
});
$dumper->start('storage/work/dump.sql');
You can register a callable that will be used to report on the progress of the dump
$dumper->setInfoHook(function($object, $info) {
if ($object === 'table') {
echo $info['name'], $info['rowCount'];
});
You can register table specific 'where' clauses to limit data on a per table basis. These override the default where
dump setting:
$dumper = new \Druidfi\Mysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
$dumper->setTableWheres([
'users' => 'date_registered > NOW() - INTERVAL 3 MONTH AND deleted=0',
'logs' => 'date_logged > NOW() - INTERVAL 1 DAY',
'posts' => 'isLive=1'
]);
You can register table specific 'limits' to limit the returned rows on a per table basis:
$dumper = new \Druidfi\Mysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
$dumper->setTableLimits([
'users' => 300,
'logs' => 50,
'posts' => 10
]);
You can also specify the limits as an array where the first value is the number of rows and the second is the offset
$dumper = new \Druidfi\Mysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
$dumper->setTableLimits([
'users' => [20, 10], //MySql query equivalent "... LIMIT 20 OFFSET 10"
]);
Dump settings can be changed from default values with 4th argument for Mysqldump constructor:
$dumper = new \Druidfi\Mysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password', $pdoOptions);
All options:
- include-tables
- Only include these tables (array of table names), include all if empty.
- exclude-tables
- Exclude these tables (array of table names), include all if empty, supports regexps.
- include-views
- Only include these views (array of view names), include all if empty. By default, all views named as the include-tables array are included.
- if-not-exists
- Only create a new table when a table of the same name does not already exist. No error message is thrown if the table already exists.
- compress
- Possible values:
Bzip2|Gzip|Gzipstream|None
, default isNone
- Could be specified using the consts:
CompressManagerFactory::GZIP
,CompressManagerFactory::BZIP2
orCompressManagerFactory::NONE
- Possible values:
- reset-auto-increment
- Removes the AUTO_INCREMENT option from the database definition
- Useful when used with no-data, so when db is recreated, it will start from 1 instead of using an old value
- add-drop-database
- MySQL docs 5.7
- add-drop-table
- MySQL docs 5.7
- add-drop-triggers
- MySQL docs 5.7
- add-locks
- MySQL docs 5.7
- complete-insert
- MySQL docs 5.7
- databases
- MySQL docs 5.7
- default-character-set
- Possible values:
utf8|utf8mb4
, default isutf8
utf8
is compatible option andutf8mb4
is for full utf8 compliance- Could be specified using the consts:
DumpSettings::UTF8
orDumpSettings::UTF8MB4
- MySQL docs 5.7
- Possible values:
- disable-keys
- MySQL docs 5.7
- events
- MySQL docs 5.7
- extended-insert
- MySQL docs 5.7
- hex-blob
- MySQL docs 5.7
- insert-ignore
- MySQL docs 5.7
- lock-tables
- MySQL docs 5.7
- net_buffer_length
- MySQL docs 5.7
- no-autocommit
- Option to disable autocommit (faster inserts, no problems with index keys)
- MySQL docs 5.7
- no-create-info
- MySQL docs 5.7
- no-data
- Do not dump data for these tables (array of table names), support regexps,
true
to ignore all tables - MySQL docs 5.7
- Do not dump data for these tables (array of table names), support regexps,
- routines
- MySQL docs 5.7
- single-transaction
- MySQL docs 5.7
- skip-comments
- MySQL docs 5.7
- skip-dump-date
- MySQL docs 5.7
- skip-triggers
- MySQL docs 5.7
- skip-tz-utc
- MySQL docs 5.7
- skip-definer
- MySQL docs 5.7
- where
- MySQL docs 5.7
The following options are now enabled by default, and there is no way to disable them since they should always be used.
- disable-foreign-keys-check
- MySQL docs 5.7
To dump a database, you need the following privileges:
- SELECT
- In order to dump table structures and data.
- SHOW VIEW
- If any databases has views, else you will get an error.
- TRIGGER
- If any table has one or more triggers.
- LOCK TABLES
- If "lock tables" option was enabled.
- PROCESS
- If you don’t use the --no-tablespaces option.
Use SHOW GRANTS FOR user@host; to know what privileges user has. See the following link for more information:
- Which are the minimum privileges required to get a backup of a MySQL database schema?
- PROCESS privilege from MySQL 5.7.31 and MySQL 8.0.21 in July 2020
The testing script creates and populates a database using all possible datatypes. Then it exports it using both mysqldump-php and mysqldump, and compares the output. Only if it is identical tests are OK.
Some tests are skipped if mysql server doesn't support them.
A couple of tests are only comparing between original sql code and mysqldump-php generated sql, because some options are not available in mysqldump.
Local setup for tests:
docker compose up -d --build
docker compose exec php81 /app/tests/scripts/create_users.sh
docker compose exec php81 /app/tests/scripts/create_users.sh db2
docker compose exec php81 /app/tests/scripts/create_users.sh db3
docker compose exec -w /app/tests/scripts php74 ./test.sh
docker compose exec -w /app/tests/scripts php80 ./test.sh
docker compose exec -w /app/tests/scripts php81 ./test.sh
docker compose exec -w /app/tests/scripts php82 ./test.sh
docker compose exec -w /app/tests/scripts php74 ./test.sh db2
docker compose exec -w /app/tests/scripts php80 ./test.sh db2
docker compose exec -w /app/tests/scripts php81 ./test.sh db2
docker compose exec -w /app/tests/scripts php82 ./test.sh db2
docker compose exec -w /app/tests/scripts php74 ./test.sh db3
docker compose exec -w /app/tests/scripts php80 ./test.sh db3
docker compose exec -w /app/tests/scripts php81 ./test.sh db3
docker compose exec -w /app/tests/scripts php82 ./test.sh db3
Forked from Diego Torres's version which have latest updates from 2020. Use it for PHP 7.3 and older. https://github.com/ifsnop/mysqldump-php
Originally based on James Elliott's script from 2009. https://code.google.com/archive/p/db-mysqldump/
Adapted and extended by Michael J. Calkins. https://github.com/clouddueling
This project is open-sourced software licensed under the GPL license