UserFrosting 4.3 focuses on updating dependencies and removing support for older versions of PHP.
BakeCommandclass into multiple methods to make it easier for sprinkle to add custom command to the
league/flysystem-rackspacedependencies from the
coresprinkle. If you are using
rackspacefor File Storage, you must now include these packages in your custom Sprinkle.
2.4.x. Reference the AdminLTE upgrade guide for change details.
As of UserFrosting 4.3.0, support for PHP version 5.6 and 7.0 is officially dropped as both versions have reached End Of Life. The minimum PHP version is now 7.1, but 7.2 or higher is recommended.
See the Changelog for the complete list of changes included in this release.
Upgrading UserFrosting to
4.3.x is as simple as getting the new files and updating dependencies, migrations and assets! If you first installed UserFrosting using git, a simple
git pull or
git pull upstream master. Once you have the new files, simply use composer and Bakery to get up to date with everything else:
$ composer update $ php bakery bake
While the updated Composer dependencies have all been tested and integrated into the core UF features and code, they may still introduce a conflict in your your own sprinkle. For example, if you sprinkle requires an additional Composer requirement not compatible with the new dependencies, you may need to update your sprinkle
composer.json requirements to newer version.
Changes in the dependencies might also introduce unexpected behavior or errors in your sprinkle, even if you're not referencing directly. For example, changes introduced between the old Eloquent version (5.4) and the new version now bundled with UserFrosting (5.8) might break your database queries for some edge cases. Checkout the list of updated dependencies and their respective changelog.
UserFrosting 4.3 now include Font Awesome 5.9 by default instead of 4.7 (Font Awesome 4 is so 2017). Breaking changes include new icon prefix, the removal of icon aliases and many icon name changes to align with the new standards. Custom sprinkles will need to be updated to use the new icon names. You can check the upgrade guide for a comprehensive list of icon name changes.
Any sprinkle extending the default
bake Bakery command may need updating. Since the
account sprinkle now extend the
BakeCommand class from the
core Sprinkle, any custom sprinkle extending the
BakeCommand class from the
core sprinkle should now extend same class from the
Account Sprinkle instead. Otherwise, the
create-admin command won't be part of
bake anymore because of PHP class inheritance.
Also, note the
BakeCommand class has been split into multiple methods to make it easier for your sprinkle to add custom sub-command to the bake command at the right place in the baking process. See the
create-admin command in the
account sprinkle for an example.