Upgrade Between Versions

You are browsing an older version of the Upgrade Guide. For the latest version see: Upgrade Guide

For older upgrade guides see:

• Upgrade Guide v1.x -> v2.x
• Upgrade Guide v0.2 -> v1.2

#2.2 -> 3.0

#Checklist

• Update PHP & Laravel
• Update Interfaces
• Namespace changes
• Configuration changes
• Add Admin Panel if still needed

#PHP & Laravel Requirement Changes

Your Action Item: Upgrade Laravel & PHP if necessary, bump minimum requirements in your project's composer.json file.

#PHP Interface Changes

Several interfaces have been updated to define return types on the language level.

Affected Classes:

• Vanilo\Contracts\Buyable: difference
• Vanilo\Contracts\Shippable: difference
• Vanilo\Properties\Contracts\Property: difference

Your Action Item: Search your application for classes that directly implement these interfaces, and updated them to match the new signatures.

#Namespace Changes

The Vanilo\Framework namespace has been renamed to Vanilo\Foundation. 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 Vanilo\Framework namespace and replace Framework with Foundation in the use clause or in the class name.

Mind renaming the namespace in config/concord.php.

The Vanilo\Foundation\Models\PaymentMethod class has been removed. Use Vanilo\Payment\Models\PaymentMethod instead.

#Configuration Path Changes

The vanilo.framework.* config values have been renamed to vanilo.foundation.*.

Your Action Item: Search your application for occurrences where it refers to vanilo.framework.* keys and replace them with vanilo.foundation.*

#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