README.md

Fuel Background Package.

This package allows you to create the process in your app context.

• If you use closure, you need specify top namespace like "\Email::forge()"

Usage

// Closure
Background::forge(function() {

	// very large process will run background.

})->run();

// Handler
Background::forge(array($email, 'send'))->run();

Example:

// You need to set driver to 'sendmail' in config/mail.php
// mail() doesn't work correctly in exec() context..
$mail = Email::forge();

// Too many to addresses..
$mail->to(array(
	'[email protected]',
	'[email protected]',
	'[email protected]',
	'[email protected]',
	'[email protected]',
	'[email protected]',
));

$background = Background::forge(function($mail) {

	$mail->send();

}, array($mail));

// attach the listener of event.
$background->on('before', function() {
	\Log::info('send mail start.');
});

$background->on('success', function() {
	\Log::info('send mail success.');
});

// exception handler will be called with Exception object.
$background->on('exception', function($e) {
	\Log::info('the exception "'.get_class($e).'" was thrown.');
});

$background->run();

Events:

- before
	before the process starts

- after
	after the process ends

- success
	when the process end with true return value.

- error
	when the process end with false return value.

- exception
	when the process throw some exceptions.

Queuing:

// Normal running

Background::forge(function() {
	for ($i = 0; $i < 2; $i++)
	{
		\Log::warning(1);
	}
})->run();
Background::forge(function() {
	for ($i = 0; $i < 2; $i++)
	{
		\Log::warning(2);
	}
})->run();
Background::forge(function() {
	for ($i = 0; $i < 2; $i++)
	{
		\Log::warning(3);
	}
})->run();

// 1
// 2
// 3
// 1
// 2
// 3

// - This means that three processes exist.


// Queuing

Background::forge(function() {
	for ($i = 0; $i < 2; $i++)
	{
		\Log::warning(1);
	}
})->queue();
Background::forge(function() {
	for ($i = 0; $i < 2; $i++)
	{
		\Log::warning(2);
	}
})->queue();
Background::forge(function() {
	for ($i = 0; $i < 2; $i++)
	{
		\Log::warning(3);
	}
})->queue();

// 1
// 1
// 2
// 2
// 3
// 3

// - This means that only one process exists.