OctoberCMS Version 3.0 Alpha is available early for developers that want to take advantage of the latest Laravel features. This version has been upgraded to use Laravel v9.0. During the alpha phase, OctoberCMS v2 and v3 will be developed in parallel.

While OctoberCMS is a stable and mature platform, the v3 alpha version should be treated as a development branch that doesn't follow traditional semantic versioning rules. It will contain newly introduced features and could contain breakages inside patch releases.

We don't recommend that you use this version in production environments unless you are an advanced user. Instead, use the stable version (v2.1+) or wait for the stable variant of this version (v3.1+) that is expected in a few months.

This is a live document that is updated continuously as an upgrade guide during the alpha phase. If you have any questions or bug reports, please email us using the contact page.

Table of Contents

• Upgrading to 3.0 from 2.x
• Laravel Upgrade Guides
• Sunset Classes
• Fillable Classes
• Translation Event Removed
• Decorated Event Dispatcher
• Http Interface Replaced

Upgrading to 3.0 Alpha from 2.x

PHP Minimum Version

The new minimum PHP version for OctoberCMS v3 is now 8.0.3. The alpha version requires PHP 8.1 or above.

Composer Dependencies

Update the following dependencies in your application's composer.json file:

• october/all to ^3.0
• october/rain to ^3.0
• laravel/framework to ^9.0

If you are including individual modules, these can be updated to be the same as the october/all package.

Laravel Upgrade Guides

Please observe the following upgrade guides for the underlying Laravel PHP framework:

• Upgrading To 7.0 From 6.x
• Upgrading To 8.0 From 7.x
• Upgrading To 9.0 From 8.x

Continue Reading

For complete details on new features and breaking changes in v3.0, please view the 3.0 Release Note.