PHPackages ludovicguenet/whizbang - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. ludovicguenet/whizbang ActiveLibrary[Database & ORM](/categories/database) ludovicguenet/whizbang ====================== Whizbang β€” Automatic database schema change tracking, risk analysis, and instant rollback for Laravel. 25353[1 issues](https://github.com/ludoguenet/laravel-whizbang/issues)[1 PRs](https://github.com/ludoguenet/laravel-whizbang/pulls)PHP Since Aug 12Pushed 9mo agoCompare [ Source](https://github.com/ludoguenet/laravel-whizbang)[ Packagist](https://packagist.org/packages/ludovicguenet/whizbang)[ RSS](/packages/ludovicguenet-whizbang/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) [![Whizbang Logo](art/logo.png)](art/logo.png)πŸ›‘οΈ Whizbang – Laravel Database Safety Package ============================================= [](#️-whizbang--laravel-database-safety-package) **The ONE thing Laravel is desperately missing that EVERY developer needs!**Automatic database schema change tracking, safety analysis, and instant rollback system for Laravel migrations. [![PHP Version Require](https://camo.githubusercontent.com/07fb45e7c56238800076bbb2d0c46d24a06e7c19fe62ce7b3372c271096bd754/687474703a2f2f706f7365722e707567782e6f72672f6c75646f7669636775656e65742f7768697a62616e672f726571756972652f706870)](https://packagist.org/packages/ludovicguenet/whizbang)[![Laravel Version](https://camo.githubusercontent.com/a4411156f5df8613bcb79d58e5bbdce9bce8a73378d7a861818b46f7d87e7dc2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302e302532422d4646324432303f7374796c653d666c6174266c6f676f3d6c61726176656c)](https://laravel.com)[![License](https://camo.githubusercontent.com/32aa0b5254db4fb4f21f7c69b795c3b249b4f0e59cc4b06bfd22d6bffc1da3db/687474703a2f2f706f7365722e707567782e6f72672f6c75646f7669636775656e65742f7768697a62616e672f6c6963656e7365)](https://packagist.org/packages/ludovicguenet/whizbang) [Installation](#-installation) β€’ [Quick Start](#-quick-start) β€’ [Features](#-features) β€’ [Commands](#-commands) β€’ [Use Cases](#-use-cases) β€’ [Contributing](#-contributing) --- > ⚠️ **Production Safety Tool**: Whizbang is designed to **protect live databases**. Use it in development *and* production to prevent irreversible data loss. --- πŸ’₯ The Problem ------------- [](#-the-problem) 1. You run `php artisan migrate` in production. 2. Migration drops a column with important data β†’ **GONE FOREVER**. 3. App breaks β†’ **NO EASY WAY BACK**. 4. Boss asks *"What changed?"* β†’ Β―\\*(ツ)*/Β― Laravel migrations are one-way by default. Once destructive changes happen, there’s no built-in recovery or audit trail. --- βœ… The Solution: Whizbang ------------------------ [](#-the-solution-whizbang) An **automatic safety net** for database changes that Laravel doesn’t provide. --- ✨ Key Features -------------- [](#-key-features) - **πŸ“Έ Auto-Snapshots** – Capture schema before *every* migration - **πŸ›‘οΈ Danger Detection** – Warn about risky operations (DROP TABLE, DROP COLUMN, etc.) - **πŸ”„ Rollback Flow** – Execute a rollback procedure with safety checks; table recreation steps are currently logged (scaffold), not auto-applied - **⚑ Risk Analysis** – Calculate rollback safety before executing - **πŸ“Š Change Tracking** – Complete audit trail of what changed and when --- 🚨 Real-World Example -------------------- [](#-real-world-example) ``` php artisan migrate # πŸ“Έ Pre-migration snapshot saved (ID: 123) # ⚠️ DANGEROUS CHANGES DETECTED! # ❌ Column 'users.email' was dropped (Risk: HIGH) # πŸ”„ To rollback, use: php artisan schema:rollback 123 ``` --- πŸ“‹ Requirements -------------- [](#-requirements) - **PHP** 8.2+ - **Laravel** 11.0+ - Database supported by Laravel Migrations --- πŸ“¦ Installation -------------- [](#-installation) ### Install Package [](#install-package) ``` composer require ludovicguenet/whizbang ``` ### Publish Config [](#publish-config) ``` php artisan vendor:publish --tag=whizbang-config ``` ### Run Migrations [](#run-migrations) ``` php artisan migrate ``` --- πŸš€ Quick Start ------------- [](#-quick-start) ### Manual Snapshot [](#manual-snapshot) ``` php artisan schema:snapshot --reason="before-hotfix" ``` ### Risk Analysis [](#risk-analysis) ``` php artisan schema:status # Recent Snapshots: # ID | Reason | Created At | Tables # 123 | pre_migration | 2024-08-11 10:30:00 | 15 # 122 | manual | 2024-08-11 09:15:00 | 15 ``` ### Rollback Flow [](#rollback-flow) ``` php artisan schema:rollback 123 # ⚠️ You are about to rollback your database schema! # βœ… Rollback safety check passed # Are you absolutely sure? (yes/no): yes # βœ… Rollback flow executed. Table recreation steps were logged (no destructive actions applied automatically) ``` --- βš™οΈ Commands ----------- [](#️-commands) ``` # Take a snapshot php artisan schema:snapshot --reason="before-release" # Check status and history php artisan schema:status # Rollback to a snapshot php artisan schema:rollback 123 # Force rollback (skip safety checks) php artisan schema:rollback 123 --force ``` --- 🎯 Use Cases ----------- [](#-use-cases) - **Production Deployments** – Auto-snapshot before migrations - **Hotfixes** – Quick rollback when things go wrong - **Schema Auditing** – Track all database changes - **Team Safety** – Prevent dangerous operations - **Compliance** – Maintain schema change history --- ❓ Why This Doesn’t Exist in Laravel ----------------------------------- [](#-why-this-doesnt-exist-in-laravel) Laravel focuses on **forward migrations**, but offers no built-in way to: - Track actual schema changes - Analyze safety of those changes - Rollback schema changes without full backups - Warn about dangerous operations **Every Laravel developer has been burned by this.**Whizbang closes that gap. --- 🀝 Contributing -------------- [](#-contributing) We welcome contributions! ``` git clone https://github.com/ludoguenet/whizbang.git cd whizbang composer install vendor/bin/pest ``` --- πŸ“œ License --------- [](#-license) Whizbang is open-source software licensed under the [MIT License](LICENSE). --- πŸ”’ Security ---------- [](#-security) If you discover security vulnerabilities, please email **** instead of using the issue tracker. --- **πŸ›‘οΈ Made with ❀️ by [Ludovic GuΓ©net](https://ludovicguenet.me) for the Laravel community πŸ›‘οΈ** [Website](https://ludovicguenet.me) β€’ [Support](mailto:ludo@epekta.com) ### Health Score 21 β€” LowBetter than 19% of packages Maintenance40 Moderate activity, may be stable Popularity18 Limited adoption so far Community10 Small or concentrated contributor base Maturity13 Early-stage or recently created project Bus Factor1 Top contributor holds 80% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/3f1ac1a4b7fdf5d9283574fc60d79c986b1f2baf67b248a65f988a681dd470a6?d=identicon)[ludoguenet](/maintainers/ludoguenet) --- Top Contributors [![ludoguenet](https://avatars.githubusercontent.com/u/36139526?v=4)](https://github.com/ludoguenet "ludoguenet (4 commits)")[![raphaelstolt](https://avatars.githubusercontent.com/u/48225?v=4)](https://github.com/raphaelstolt "raphaelstolt (1 commits)") ### Embed Badge ![Health badge](/badges/ludovicguenet-whizbang/health.svg) ``` [![Health](https://phpackages.com/badges/ludovicguenet-whizbang/health.svg)](https://phpackages.com/packages/ludovicguenet-whizbang) ``` ### Alternatives [doctrine/orm Object-Relational-Mapper for PHP 10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter a PHP SQL highlighting library 3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database The Illuminate Database package. 2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/mongodb MongoDB driver library 1.6k64.0M546](/packages/mongodb-mongodb)[ramsey/uuid-doctrine Use ramsey/uuid as a Doctrine field type. 90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel Reliese Components for Laravel Framework code generation. 1.7k3.4M16](/packages/reliese-laravel) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)