For detailed migration instructions, please refer to the official release documentation:
Migration highlights:
- 🗑️ Legacy Cleanup: 18% code reduction (11,871 lines removed)
- 📦 Namespace Modernization: 110 legacy aliases removed
- 🚀 Performance: 59% fewer aliases to autoload
⚠️ Breaking Changes: Required namespace updates for middleware- ✅ Zero Regressions: All 5,548 tests passing (100%)
| From Version | Migration Guide | Effort Level |
|---|---|---|
| v1.x → v2.0.0 | v2.0.0 Migration Guide | Medium |
| v1.1.3 | v1.1.4 Migration Guide | Low (mostly optional) |
| v1.1.2 | v1.1.4 Migration Guide | Low (infrastructure only) |
| v1.1.1 | v1.1.4 Migration Guide | Low (backward compatible) |
| v1.1.0 | v1.1.4 Migration Guide | Medium (multiple versions) |
| v1.0.x | v1.1.4 Migration Guide | Medium (feature changes) |
- Update PSR-15 middleware imports (8 classes - see migration guide)
- Remove "Simple" prefixes* (7 classes - PerformanceMode, LoadShedder, etc.)
- Replace OpenApiExporter with ApiDocumentationMiddleware
- Update DynamicPoolManager → PoolManager
- Run tests:
composer test - Regenerate autoloader:
composer dump-autoload
- Use migration script (provided in v2.0.0 migration guide)
- Review cleanup analysis (docs/v2.0.0-cleanup-analysis.md)
- Update IDE configuration for new namespaces
- Review updated examples in
examples/directory
- Versioning Guide - Complete semantic versioning guidance
- Framework Overview v1.1.4 - Complete release overview
- Release Notes v1.1.4 - Detailed release notes
- Changelog - Complete version history
If you encounter migration issues:
- Check the specific migration guide for your version
- Review error messages (now in Portuguese for clarity)
- Consult the troubleshooting section in the migration guide
- Create GitHub issue: https://github.com/PivotPHP/pivotphp-core/issues
Note: This general migration guide has been replaced by version-specific documentation for better accuracy and detail. Please use the appropriate version-specific guide above.