DatabaseBackup is a CakePHP plugin to export, import and manage database backups. Currently, the plugin supports MySql, Postgres and Sqlite databases.
Did you like this plugin? Its development requires a lot of time for me. Please consider the possibility of making a donation: even a coffee is enough! Thank you.
DatabaseBackup requires:
mariadb
andmariadb-dump
for MariaDB/MySql databases (if you still usemysql
/mysqldump
, see here);pg_dump
andpg_restore
for Postgres databases;sqlite3
for Sqlite databases.
Optionally, if you want to handle compressed backups, bzip2
and gzip
are
also required.
The installation of these binaries may vary depending on your operating system.
You can install the plugin via composer:
composer require --prefer-dist mirko-pagliai/cakephp-database-backup
Then you have to load the plugin. For more information on how to load the plugin, please refer to the CakePHP documentation.
You can execute the shell command to enable the plugin:
bin/cake plugin load DatabaseBackup
This would update your application's bootstrap method.
Compared to the current installation requirements, some tags or branches are provided for those using older versions of CakePHP and PHP:
2.15
versions, which require at least CakePHP5.0
and PHP8.1
;- tag
cakephp4
, which requires at least PHP>=7.4.0
and CakePHP^4.0
.
This tag no longer receives any updates as of January 5, 2024, and roughly coincides with what2.12.3
version was. - tag
cakephp3
, which requires at least PHP>=5.6 <7.4
and CakePHP^3.5.1
.
This tag no longer receives any updates as of April 29, 2021, and roughly coincides with what2.8.5
version was.
You can freely use these, even by downloading the source codes from the attached assets, but their functioning is no longer guaranteed, especially regarding old dependencies that may no longer be available.
See our wiki.
Before opening an issue, check this list of common issues.
Unlike previous versions, with the 3.x branch, thanks to the Mockery's overloading and the (external) component Process
that actually takes care of executing the commands to export/import the databases, normally the tests do not really use the database drivers and do not actually write or read files on the filesystem (i.e. everything is simulated).
The only exception is given by the class DatabaseBackup\Test\TestCase\Utility\BackupExportAndImportTest
, which however does not belong to the testsuite executed by default (it is therefore an optional test) and is marked with the attribute #[CoversNothing]
.
This test class, when executed, will test a real database export and import, using the PHP extensions sqlite3
, mysqli
and pgsql
, that is all the drivers and databases supported by the plugin.
You can test the class directly or the configured real-drivers
testsuite (see available testsuites):
vendor/bin/phpunit --testsuite=real-drivers
Continuous integration (CI) workflows must be run with highest
/lowest
dependencies and "without"/"only with" real drivers and databases.
For transparency and insight into our release cycle and to maintain backward compatibility, DatabaseBackup will be maintained under the Semantic Versioning guidelines.