rsync-backup/README.md

rsyncer

---

A thin rsync wrapper class for PHP without any dependencies

Requirements

---

PHP 5.6+, rsync, composer

Installation

---

• Use Composer to install the package

• From project root directory execute

  composer install

  or

  composer require codeplayr/rsyncer

• Composer will take care of autoloading. Just include the autoloader at the top of the file

  require_once __DIR__ . '/vendor/autoload.php';

Usage

---

See following example:

use \Codeplayr\Rsyncer\Option;
use \Codeplayr\Rsyncer\SSH;
use \Codeplayr\Rsyncer\Rsync;

$source = __DIR__ . '/src/';
$destination = __DIR__ . '/backup/';

$date = date('Y-m-d', time());

//rsync options
$option = new Option([
	Option::FILES_FROM	=> __DIR__ . '/rules.txt',
	Option::EXCLUDE_FROM=> __DIR__ . '/exclude-rules.txt',
	Option::LOG_FILE	=> __DIR__ . "/logs/{$date}.log",
	Option::ARCHIVE		=> false,
	Option::LINKS		=> true,
	Option::TIMES		=> true,
	Option::RECURSIVE	=> true,
	Option::VERBOSE		=> true,
	Option::COMPRESS	=> true,
	Option::CHECKSUM	=> true,
	Option::DRY_RUN		=> false,
]);

//add additional flags
$option->addFlag('human-readable')
		->addArgument('exclude', '/path/to/exclude')
		->addArgument('include', '*.html')
		->addArgument('include', '*.php')
		->addArgument('include', '*/')
		->addArgument('exclude', '*');		

//optional ssh connection to remote host
$ssh = new SSH([
	SSH::USERNAME		=> 'user',
	SSH::HOST			=> '1.2.3.4',
	SSH::PORT			=> 22,
	SSH::IDENTITY_FILE	=> '~/.ssh/id_rsa',
]);

//configuration options
$conf = [
	Rsync::SHOW_OUTPUT	=> true,
];

$rsync = new Rsync( $option, $ssh, $conf );

//assemble and show Command
echo $rsync->getCommand( $source, $destination );

//start syncing directories
if( ! $rsync->sync( $source, $destination ) ){
	echo $rsync->getMessage()->toString();
}

Running the script generates following rsync command and options:

rsync
	-ltrvzc
	--human-readable 		
	--files-from="/path/to/rules.txt"
	--exclude-from="/path/to/exclude-rules.txt"
	--log-file="/path/to/logs/2016-10-29.log"
	--exclude='/path/to/exclude'
	--include="*.html"
	--include="*.php"
	--include="*/"
	--exclude="*"
	-e="ssh -i ~/.ssh/id_rsa"
	user@1.2.3.4:"/path/to/src/" "/path/to/backup/"

Run Tests:

---

• All tests are inside tests folder.
• Execute composer install --dev phpunit/phpunit to install phpunit
• Run phpunit from inside the tests directory to execute testcase
• Set --coverage-text option to show code coverage report in terminal