Download the PHP package danielemontecchi/laravel-patcher without Composer
On this page you can find all versions of the php package danielemontecchi/laravel-patcher. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download danielemontecchi/laravel-patcher
More information about danielemontecchi/laravel-patcher
Files in danielemontecchi/laravel-patcher
Package laravel-patcher
Short Description A predictable system for applying one-time operational or data patches in Laravel—trackable, skippable, and rollback-ready.
License MIT
Homepage https://danielemontecchi.com
Informations about the package laravel-patcher
Laravel Patcher
Laravel Patcher is a clean and predictable system for applying one-time patches to your Laravel application. It works similarly to migrations but is designed for operational, data-related, or procedural logic that you need to run once and track.
Inspired by Taylor Otwell’s patching concept, this package formalizes and extends the idea to support a wide variety of use cases, including conditionally skipped patches, tracking applied states, and batch rollback.
Features
- Runs patch classes similar to migrations
- Supports anonymous class patches using
return new class extends Patch - Automatically tracks execution via the
patchesdatabase table - Supports conditional execution via
shouldRun() - Distinguishes executed vs skipped patches using
is_applied - CLI output styled identically to
php artisan migrate - Allows rollback by batch
Installation
Laravel will automatically register the service provider.
To create the required database table, run:
Patch Table Format
The patches table includes:
| Column | Type | Description |
|---|---|---|
| id | bigint | Auto-increment primary key |
| name | string | Patch filename (without .php) |
| batch | int | Batch number (like migrations) |
| is_applied | boolean | Whether shouldRun() returned true and the patch was executed |
| applied_at | timestamp | When the patch was recorded |
Skipped patches are still recorded, but with
is_applied = false.
Creating a Patch
This will generate a new file in database/patches/:
Patches must return an anonymous class instance that extends
Patch.
Executing Patches
Executes all unapplied patches, skipping those already registered in the patches table. Patches for which shouldRun() returns false are marked as skipped and recorded accordingly.
Rolling Back Patches
Rolls back the latest batch of applied patches (only those where is_applied = true).
Use the --step=N option to rollback multiple batches:
License
Laravel Patcher is open-source software licensed under the MIT license. See the LICENSE.md file for full details.
Made with ❤️ by Daniele Montecchi