Basic Usage

Create your first operation using make:operation command and define the actions it should perform.

php artisan make:operation

This action will create a new file in the /operations folder of your application.

If you are using the git version control system, the name of the currently active branch will be used as the file name suffix, otherwise the word auto will be used.

You can also specify a name for the file yourself by specifying it with the first argument. For example, php artisan make:operation qwerty.

use App\Models\Article;
use DragonCode\LaravelDeployOperations\Operation;

return new class extends Operation {
    public function __invoke(): void
    {
        Article::query()
            ->lazyById(chunkSize: 100, column: 'id')
            ->each->update(['is_active' => true]);

        // and/or any actions...
    }
};

Next, To run operations, execute the operations artisan command:

php artisan operations

The order in which operations are called is checked by file name in alphabetical order, without taking into account directory names:

# actual file names
2022_10_14_000001_test1      # 1
2022_10_14_000004_test4      # 4
bar/2022_10_14_000003_test3  # 3
foo/2022_10_14_000002_test2  # 2

# order of running operations at startup
2022_10_14_000001_test1      # 1
foo/2022_10_14_000002_test2  # 2
bar/2022_10_14_000003_test3  # 3
2022_10_14_000004_test4      # 4

In addition to other options described in the "Guide" section, you can divide the execution of operations into "before" and "after" certain actions. For example, before and after restarting the queues:

php artisan operations --before
php artisan queue:restart
php artisan operations