-
-
Notifications
You must be signed in to change notification settings - Fork 56
Laravel 9.x Shift #112
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Laravel 9.x Shift #112
Conversation
In an effort to make upgrading the constantly changing config files easier, Shift defaulted them and merged your true customizations - where ENV variables may not be used.
`<env>` tags have a lower precedence than system environment variables making it easier to overwrite PHPUnit configuration values in additional environments, such a CI. Review this blog post for more details on configuration precedence when testing Laravel: https://jasonmccreary.me/articles/laravel-testing-configuration-precedence/
i️ Laravel 9 moved the resources/lang folder to the top level of the project. While Shift moved and replaced references to this folder, you may have additional references to this folder which need to be updated.
Dependencies
Some mail providers may require an additional dependency. For example, if you are using Mailgun, then you will need to install the symfony/mailgun-mailer package:
composer require symfony/mailgun-mailer symfony/http-client
For more details on what has changed you may review the Symfony Mailer section of the Upgrade Guide.
❌ Shift could not upgrade the following files since they differed from the default Laravel version. You will need to compare these files against the default Laravel 9 versions and merge any changes:
- public/index.php
FILESYSTEM_DRIVER environment variable was renamed to FILESYSTEM_DISK in Laravel 9. Shift did not find this variable referenced in your committed files, but you should review any additional environment configuration and rename this variable.
ENV variables.
You should review this commit for additional customizations or opportunities to use new ENV variables. If you have a lot of customizations, you may undo this commit with git revert a85a3397 and make the config file changes manually.
i️ The FILESYSTEM_CLOUD environment variable was removed in a later release of Laravel 8. While you may still use the cloud disk, you are encouraged to configure your own disks.
token driver for API authentication is no longer available. This driver was not very robust and was removed from the documentation. Laravel now recommends using Sanctum.
If you were using the token driver, you may re-add it within your auth.php configuration file, then migrate to Sanctum at your convenience.
i️ Shift updated your dependencies for Laravel 9. While many of the popular packages are reviewed, you may have to update additional packages in order for your application to be compatible with Laravel 9.
Watch dealing with dependencies for tips on handling any additional package incompatibilities.
i️ Laravel 9 adopted anonymous migrations. Shift automated this change to align with modern Laravel conventions and avoid naming migrations.
🎉 Congratulations, you're now running the latest version of Laravel!
Next, you may optionally run the following Shifts to ensure your application is fully upgraded, adopts the latest Laravel conventions, and easier to maintain in the future:
- Upgrade Checker ensures your application is fully upgraded by detecting any outdated code.
- Laravel Fixer automatically updates your code to the latest Laravel conventions.
- Tests Generator intelligently generates model factories, HTTP Tests, and configuration for your application.
- CI Generator intelligently generates CI jobs to lint PHP, check code style, and run tests, including Dusk.
You may also use the Shift Workbench to automate common tasks for maintaining your Laravel and PHP applications.
This pull request includes the changes for upgrading to Laravel 9.x. Feel free to commit any additional changes to the
shift-60142branch.Before merging, you need to:
shift-60142branchcomposer update(if the scripts fail, add--no-scripts)If you need help with your upgrade, check out the Human Shifts. You may also join the Shifty Coders Slack workspace to level-up your Laravel skills.