h2akim/backupl41

An easy way backup and restore databases in Laravel.

An easy way backup and restore databases in Laravel.

Fork from Cornford/Backup * Add Laravel 4.1 Support, _(*1)

Think of Backup as an easy way to backup and restore a database, with command line integration to Laravel's artisan. These include:, _(*2)

• Backup::export
• Backup::restore
• Backup::setBackupEngineInstance
• Backup::getBackupEngineInstance
• Backup::setBackupFilesystemInstance
• Backup::getBackupFilesystemInstance
• Backup::setEnabled
• Backup::getEnabled
• Backup::setPath
• Backup::getPath
• Backup::setCompress
• Backup::getCompress
• Backup::setFilename
• Backup::getFilename
• Backup::getWorkingFilepath
• Backup::getRestorationFiles
• Backup::getProcessOutput

Installation

Begin by installing this package through Composer. Edit your project's composer.json file to require cornford/backup., _(*3)

"require": {
    "h2akim/backup": "dev-master"
}

Next, update Composer from the Terminal:, _(*4)

composer update

Once this operation completes, the next step is to add the service provider. Open app/config/app.php, and add a new item to the providers array., _(*5)

'H2akim\Backup\Providers\BackupServiceProvider',

The next step is to introduce the facade. Open app/config/app.php, and add a new item to the aliases array., _(*6)

'Backup'         => 'H2akim\Backup\Facades\Backup',

Finally we need to introduce the configuration files into your application., _(*7)

php artisan config:publish h2akim/backup

That's it! You're all set to go., _(*8)

Usage

It's really as simple as using the Backup class in any Controller / Model / File you see fit with:, _(*9)

Backup::, _(*10)

This will give you access to, _(*11)

• Export
• Restore
• Set Backup Engine Instance
• Get Backup Engine Instance
• Set Backup Filesystem Instance
• Get Backup Filesystem Instance
• Set Enabled
• Get Enabled
• Set Path
• Get Path
• Set Compress
• Get Compress
• Set Filename
• Get Filename
• Get Working Filepath
• Get Restoration Files
• Get Process Output

Export

The export method allows a database export file to be created in the defined backup location, with an optional filename option., _(*12)

Backup::export();
Backup::export('database_backup');

Restore

The restore method allows a database export file to be restored to the database, specifying a full filepath to the file., _(*13)

Backup::restore('./database_backup.sql');

Set Backup Engine Instance

The setBackupEngineInstance method allows a custom backup engine instance object to be utilised, implementing the BackupEngineInterface., _(*14)

Backup::setBackupEngineInstance(new BackupEngineMysql(new BackupProcess(new Symfony\Component\Process\Process), 'database', 'localhost', 3306, 'root', '', []));

Get Backup Engine Instance

The getBackupEngineInstance method returns the current backup engine instance object., _(*15)

Backup::getBackupEngineInstance();

Set Backup Filesystem Instance

The setBackupFilesystemInstance method allows a custom backup filesystem instance object to be utilised, implementing the BackupFilesystemInterface., _(*16)

Backup::setBackupFilesystemInstance(new BackupFilesystemInstance);

Get Backup Filesystem Instance

The getBackupFilesystemInstance method returns the current backup filesystem instance object., _(*17)

Backup::getBackupFilesystemInstance();

Set Enabled

The setEnabled method allows backup to be switched on or off, specifying a boolean for state., _(*18)

Backup::setEnabled(true);
Backup::setEnabled(false);

Get Enabled

The getEnabled method returns the current backup enabled status, returning a boolean for its state., _(*19)

Backup::getEnabled();

Set Path

The setPath method allows backup location path to be set, specifying a relative or absolute path as a string, a trailing slash is required., _(*20)

Backup::setPath('/path/to/directory/');

Get Path

The getPath method returns the current absolute backup path in string format., _(*21)

Backup::getPath();

Set Compress

The setCompress method allows backup file compression to be switched on or off, specifying a boolean for state., _(*22)

Backup::setCompress(true);
Backup::setCompress(false);

Get Compress

The getCompress method returns the current compression backup status, returning a boolean for its state., _(*23)

Backup::getCompress();

Set Filename

The setFilename method allows backup filename to be set, specified in a string format., _(*24)

Backup::setFilename('database_backup');
Backup::setFilename('backup-' . date('Ymd-His'));

Get Filename

The getFilename method returns the current set backup filename in a string format., _(*25)

Backup::getFilename();

Get Working Filepath

The getWorkingFilepath method returns the current set working filepath of the current item being processed in a string format., _(*26)

Backup::getWorkingFilepath();

Get Restoration Files

The getRestorationFiles method returns an array containing all of the restoration file filepaths within a give path, an optional absolute path can be set as a string., _(*27)

Backup::getRestorationFiles();
Backup::getRestorationFiles('/path/to/directory/');

License

Backup is open-sourced software licensed under the MIT license, _(*28)