newman / laravel-delay
Laravel delay helper package
Installs: 13 051
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: ^8.0
- illuminate/contracts: ^8.12|^9.0|^10.0
- illuminate/support: ^8.12|^9.0|^10.0
- nesbot/carbon: ^2.13
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.0
- nunomaduro/larastan: ^1.0|^2.4
- orchestra/testbench: ^6.0|^7.0|^8.0
- phpunit/phpunit: ^8.0|^9.0
README
Package which helps you to delay (sleep) your code for some time.
Note before continuing
As of Laravel version 10.10.0 you may not need this package anymore in favour of in-built helper - https://laravel.com/docs/10.x/helpers#sleep
Installation
Requirements
- Laravel 8.12+, 9.0+, 10.0+
- PHP 8.0
Installation
Require the package via Composer:
composer require newman/laravel-delay
📖 Usage
Using as Facade
use Newman\LaravelDelay\Facades\Delay; // ... Delay::for(3);
Using as Trait
<?php namespace App\Console\Commands; use Illuminate\Console\Command; use Newman\LaravelDelay\Traits\Delayable; class ImportTask extends Command { use Delayable; // ... }
then in code you can call the delay the code execution like this:
$this->delay()->for(5);
or
$this->delay(5);
They both will delay execution for 5 seconds.
You can include trait in any class you'd like to use it, including controllers.
Using as service container
use Newman\LaravelDelay\Contracts\DelayContract; // ... app()->make(DelayContract::class)->for(5);
Usage samples
Let's assume we're using Trait.
Delay execution for 10 seconds:
$this->delay(10); $this->delay()->for(10); $this->delay()->forSeconds(10);
Note that in case you want to delay for fractions of a second, you should use forMs
function.
Delay execution for 1500 miliseconds (1.5 second):
$this->delay()->forMs(1500); $this->delay()->forMiliseconds(1500);
Delay execution for 5000 microseconds (0.005 second):
$this->delay()->forMicroseconds(5000);
Delay execution till given Carbon datetime:
$this->delay()->till(Carbon::now()->addMinutes(5)->addSeconds(15));
Delay execution for 10 seconds only on given environment/-s:
$this->delay()->for(10)->environments(['production']); // delays only on production $this->delay()->for(10)->environments(['production', 'staging']); // delays on production and staging only
Delay execution for 10 seconds except given environment/-s:
$this->delay()->for(10)->except(['prodction']); // delays on all environments, except production $this->delay()->for(10)->except(['prodction', 'staging']); // delays on all environments, except production and staging
Delay execution for 10 seconds only when callback returns false:
$this->delay()->for(10)->exceptWhen(fn () => 1 + 1 == 2); // code will not delay in this case, because callback returns true $this->delay()->for(10)->exceptWhen(fn () => 1 + 1 == 3); // code will delay in this case, because callback returns false
and we can even pass multiple callbacks.
$this->delay()->for(10)->exceptWhen(fn () => false)->exceptWhen(fn () => false); // code will delay $this->delay()->for(10)->exceptWhen(fn () => true)->exceptWhen(fn () => false); // code will not delay, because all callbacks doesn't return false
At last we can chain multiple conditions:
It will delay for 10 seconds only on production & staging environments and only when it's not 10 AM.
$this->delay() ->for(10) ->environments(['production', 'staging']) ->exceptWhen(fn () => Carbon::now()->hour == 10);
🤝 Contributing
We'll appreciate your collaboration to this package.
When making pull requests, make sure:
- All tests are passing:
composer test
- Test coverage is not reduced:
composer test-coverage
- There are no PHPStan errors:
composer phpstan
- Coding standard is followed:
composer lint
orcomposer fix-style
to automatically fix it.