new Mysql-Database Dump Step

Author: Alex Schulte

Classes/Step/MysqlDatabaseExportStep.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace Breadlesscode\Backups\Step;
+
+use Neos\Flow\Annotations as Flow;
+
+class MysqlDatabaseExportStep extends StepAbstract
+{
+    /**
+     * Folder name in backup file
+     *
+     * @var string
+     */
+    protected $name = 'MySqlDatabaseExport';
+
+    /**
+     * @Flow\InjectConfiguration(path="persistence.backendOptions", package="Neos.Flow")
+     * @var array
+     */
+    protected $dbConfig;
+
+    public function backup(): bool
+    {
+        $mysqlDumpPath = $this->config['mysqlDumpBinPath'] ?? 'mysqldump';
+        $mysqlDumpOptions = $this->config['mysqlDumpOptions'] ?? [];
+
+        $command = vsprintf('%s -h %s -u %s -p%s %s %s 2>/dev/null 1> %s', [
+            $mysqlDumpPath,
+            escapeshellarg($this->dbConfig['host']),
+            escapeshellarg($this->dbConfig['user']),
+            escapeshellarg($this->dbConfig['password']),
+            escapeshellarg($this->dbConfig['dbname']),
+            implode(' ', $mysqlDumpOptions),
+            $this->getFilenameForBackup()
+        ]);
+
+        exec($command);
+
+        return true;
+    }
+
+    public function restore(): bool
+    {
+        $mysqlPath = $this->config['mysqlBinPath'] ?? 'mysql';
+
+        $command = vsprintf('%s -h %s -u %s -p%s %s 2>/dev/null < %s', [
+            $mysqlPath,
+            escapeshellarg($this->dbConfig['host']),
+            escapeshellarg($this->dbConfig['user']),
+            escapeshellarg($this->dbConfig['password']),
+            escapeshellarg($this->dbConfig['dbname']),
+            $this->getFilenameForBackup()
+        ]);
+
+        exec($command);
+
+        return true;
+    }
+
+    public function getRestoreWarning(): ?string
+    {
+        return 'The database "' . $this->dbConfig['dbname'] . '" will be overwritten:' . PHP_EOL;
+    }
+
+    protected function getFilenameForBackup(): string
+    {
+        $backupPath = $this->getBackupStepPath();
+        return $backupPath . '/' . $this->dbConfig['dbname'] . '.sql';
+    }
+}

Documentation/steps.md

@@ -45,3 +45,20 @@ Breadlesscode:
         tables:
           - neos_flow_security_account
 ```
+
+## MySql-Database export step
+
+This step exports a whole MySql-Database via the `mysqldump`-Binary.
+
+Example configuration:
+```yaml
+Breadlesscode:
+  Backups:
+    steps:
+      'Breadlesscode\Backups\Step\MysqlDatabaseExportStep':
+        mysqlDumpBinPath: 'mysqldump'
+        mysqlBinPath: 'mysql'
+        mysqlDumpOptions:
+          - --single-transaction
+          - --skip-extended-insert
+```