Download the PHP package laravel-enso/upgrade without Composer
On this page you can find all versions of the php package laravel-enso/upgrade. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download laravel-enso/upgrade
More information about laravel-enso/upgrade
Files in laravel-enso/upgrade
Package upgrade
Short Description Helper classes dependency for Laravel Enso
License MIT
Homepage https://github.com/laravel-enso/upgrade
Informations about the package upgrade
Upgrade
Description
Upgrade orchestrates both package-level upgrade routines across the Laravel Enso ecosystem and local project upgrade routines defined inside the host application.
It discovers upgrade classes from the application and from configured vendor packages, sorts them by priority and last modification date, and executes them through a consistent pipeline that supports table migrations, data migrations, post-data migration steps, rollback hooks, manual-only upgrades, and before-migration upgrades.
The package also includes a structure-upgrade adapter for permission and role provisioning, plus a status command that reports upgrade applicability, execution mode, ordering, and migration state.
Installation
This package is normally installed as part of the Enso core stack.
For standalone installation in an Enso-based application:
The package registers:
enso:upgradeenso:upgrade:status
If needed, you can publish the config with:
Default configuration:
Features
- Discovers upgrade classes from local folders and configured vendor namespaces.
- Supports package upgrades implemented as PHP classes instead of one-off scripts.
- Sorts upgrades by explicit priority and then by last modified timestamp.
- Supports pre-migration upgrades through the
BeforeMigrationmarker interface. - Supports manual-only upgrades through the
ShouldRunManuallymarker interface. - Supports conditional execution through the
Applicablecontract. - Executes table, data, and post-data migration steps in a controlled sequence.
- Rolls back table changes when a data or post-data migration fails and the upgrade implements rollback support.
- Wraps structure upgrades into permission and role synchronization workflows.
- Provides a status table for debugging pending, manual, or already-ran upgrades.
Usage
Run all applicable upgrades:
Run manual upgrades as well:
Run only upgrades meant to execute before the main database migration flow:
Inspect the current upgrade inventory and status:
A minimal upgrade class can implement MigratesTable:
Structure upgrades can declare permissions and optional roles:
::: tip Tip
If an upgrade implements RollbackTableMigration, the package will automatically call rollbackTableMigration() when the data migration or post-data migration phase throws.
:::
API
Commands
enso:upgrade {--manual} {--before-migration}enso:upgrade:status
Core Services
LaravelEnso\Upgrade\Services\FinderLaravelEnso\Upgrade\Services\UpgradeLaravelEnso\Upgrade\Services\DatabaseLaravelEnso\Upgrade\Services\UpgradeStatusLaravelEnso\Upgrade\Services\Structure
Execution Model
The current execution pipeline is split into three phases:
migrateTable()migrateData()migratePostDataMigration()
Only the migrateData() phase is wrapped in a database transaction.
migrateTable() and migratePostDataMigration() run outside the transaction boundary. If either the data migration or the post-data migration phase fails, and the upgrade implements RollbackTableMigration, the package calls rollbackTableMigration() to undo the table changes explicitly.
Contracts
Execution contracts:
UpgradeMigratesTableMigratesDataMigratesPostDataMigrationRollbackTableMigrationMigratesStructure
Execution modifiers:
ApplicableBeforeMigrationPrioritizationShouldRunManually
Helpers
Database inspection helpers:
LaravelEnso\Upgrade\Helpers\TableLaravelEnso\Upgrade\Helpers\Column
DBAL bridge:
LaravelEnso\Upgrade\Services\DBAL\Connection
Discovery Rules
The finder scans:
- configured vendor folders from
enso.upgrade.vendors - configured local folders from
enso.upgrade.folders Upgradesnamespaces derived from each package's PSR-4 autoload root
Structure Upgrades
MigratesStructure upgrades are wrapped by LaravelEnso\Upgrade\Services\Structure, which:
- creates missing permissions
- assigns them to the default role
- assigns non-default permissions only to explicitly listed roles
- can run an additional post-data migration phase
Depends On
Required Enso packages:
laravel-enso/core↗laravel-enso/enums↗laravel-enso/helpers↗laravel-enso/permissions↗laravel-enso/roles↗
External dependencies:
Contributions
are welcome. Pull requests are great, but issues are good too.
Thank you to all the people who already contributed to Enso!
All versions of upgrade with dependencies
laravel-enso/core Version ^12.0
laravel-enso/enums Version ^3.0
laravel-enso/helpers Version ^4.0
laravel-enso/permissions Version ^5.0
laravel-enso/roles Version ^5.0
doctrine/dbal Version ^3.3