Upgrade Guide
Navigate between major versions of auditor
This guide helps you upgrade between major versions of auditor.
📚 Upgrade Paths
📋 Version Support
| Version | Status | PHP | Symfony |
|---|---|---|---|
| 4.x | Active development 🚀 | >= 8.4 | >= 8.0 |
| 3.x | Active support | >= 8.2 | >= 5.4 |
| 2.x | End of Life | >= 7.4 | >= 4.4 |
| 1.x | End of Life | >= 7.2 | >= 3.4 |
✅ General Upgrade Tips
IMPORTANT
Always follow these steps when upgrading:
- Read the full changelog before upgrading
- Backup your database including audit tables
- Test in staging before production
- Update dependencies first - Symfony, Doctrine, PHP
- Run tests after upgrading
- Check for deprecations before the major version
🔍 Checking Your Version
composer show damienharper/auditor
📦 Updating
# Update to latest 4.x
composer require damienharper/auditor:^4.0
# Update to latest 3.x (if on 3.x)
composer require damienharper/auditor:^3.0