Upgrade Between Versions
For older upgrade guides see:
2.2 -> 3.0
Vanilo 3 has just been released, please wait a few hours for the upgrade guide.
- [ ] Update PHP & Laravel
- [ ] Update Interfaces
- [ ] Namespace changes
- [ ] Configuration changes
- [ ] Add Admin Panel if still needed
PHP & Laravel Requirement Changes
|3.0||PHP 8.0+ & Laravel 9.0+||PHP 8.0+ & Laravel 9.0+|
Your Action Item: Upgrade Laravel & PHP if necessary, bump minimum requirements in your
PHP Interface Changes
Several interfaces have been updated to define return types on the language level.
Your Action Item: Search your application for classes that directly implement these interfaces, and updated them to match the new signatures.
Vanilo\Framework namespace has been renamed to
A namespace alias has been created for compatibility, but this will be dropped in the future.
Your Action Item: Search your application for classes that use classes from the
namespace and replace
Foundation in the use clause or in the class name.
Mind renaming the namespace in
Configuration Path Changes
vanilo.framework.* config values have been renamed to
Your Action Item: Search your application for occurrences where it refers to
vanilo.framework.* keys and replace them with
Add Admin Panel If Needed
The admin panel has been removed from the Vanilo core framework. If you still need it,
add it back to your application's dependencies using:
composer require vanilo/admin