swisnl / laravel-database-guard

dev-master 2026-10-14 06:44 UTC

Requires

• php: ^8.3
• illuminate/contracts: ^12.0|^13.0
• illuminate/database: ^12.0|^13.0
• illuminate/support: ^12.0|^13.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.32
• orchestra/testbench: ^10.0|^11.0
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^12.0
• rector/rector: ^2.6

MIT

• Cees Geene

• database
• laravel
• guard
• swisnl

Published on Packagist.org on 2026-10-14 06:44 UTC

README

Introduction

A single Laravel migration can take down a production database. MySQL takes an exclusive metadata lock for every schema change, and most changes do more than flip metadata: adding an index, changing a column type or dropping a primary key rebuilds or scans the whole table. On a large table that can take minutes or hours, and while it runs:

• On a single server, writes to the table block, and every query on it queues behind the DDL if a long-running transaction delays the lock.
• With async replicas, the change replays on each replica afterwards, stopping replication for the same duration.
• On HA clusters such as Percona XtraDB Cluster or Galera, schema changes run in lockstep on every node (TOI), so the whole cluster stops committing writes until the change completes.

These migrations look harmless in review and pass every test, because development and CI databases are small. The problem only shows on production data volumes, during a deployment.

This package stops those migrations before they run.

Install

composer require swisnl/laravel-database-guard

Optionally publish the config file:

php artisan vendor:publish --tag=database-guard

Usage

TODO

Testing

composer test
composer analyse
composer lint

Changelog

See CHANGELOG for recent changes.

Contributing

See CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

License

The MIT License (MIT). See License File for more information.