Git repo branch changes
Recently, we removed the master
branch, and renamed the dev
branch to main
. You can update your Solder to use the main
branch with the following commands:
git branch -m dev main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a
Updating to v0.8.0
Version 0.8.0 requires PHP 8.2+, so you'll need to install that and configure your web server to use it.
You'll need to edit your .env
file, to change the following strings:
BROADCAST_DRIVER=
toBROADCAST_CONNECTION=
CACHE_DRIVER=
toCACHE_STORE=
You will also need to add the following to your .env
(see .env.example
for an explanation):
HASH_VERIFY=false
When you update Solder, make sure to also run the optimize
command:
php artisan optimize
Updating to v0.7.15
Version 0.7.15 requires PHP 8.1+, so you'll need to install that and configure your web server to use it.
Updating from v0.7.6/v0.7.7 to v0.7.8
Version 0.7.8 requires PHP 8.0+, so you'll need to install that and configure your web server to use it.
Updating from v0.7 and onward
Make sure to backup your SQL database before any update!
Put the Solder application into maintenance mode.
php artisan down
And then run a pull to get the latest changes from the GitHub repository.
git pull
Note:
If
git pull
fails with:error: The following untracked working tree files would be overwritten by merge: Please move or remove them before you can merge. Aborting
Reset the repo to the latest version before the update
git reset --hard <version>
The next step will update existing or new dependencies
- If you installed composer locally:
php composer.phar update --no-dev --no-interaction
- If you installed it globally:
composer update --no-dev --no-interaction
Note:
This command will fail if Solder is not put into maintenance mode.
Regardless of whether or not there are changes to the database migrations, back up your database, and run a migrate to be sure.
php artisan migrate
Bring the Solder application out maintenance mode.
php artisan up
If you installed Solder using composer create-project, please reinstall solder again using the most recent info on the Getting Started guide.
Updating from pre-v0.7
Make sure to backup your SQL database and Modpack resources (images) before attempting
When updating your Solder install, you will be doing a complete wipe of the application. Just completely delete the entire solder installation and follow the Installation steps laid out in the Getting Started page. Once installed, follow the Laravel DB migration steps below.
Laravel DB migration changes
Laravel changes the way it handles DB migrations which will cause problems when trying to migrate the new DB migrations in v0.7.
The old table name was set as 'laravel_migrations'. The new table name that tracks your migrations is set in app/config/database.php
under the key-value pair migrations
. Because of this, when you try to migrate the new changes, it will attempt to start from the beginning.
- Old structure is as follows: 3 columns (bundle, name, batch).
- New structure is as follows: 2 columns (migration, batch).
The bundle
column can be deleted and the name
column renamed to migration
.
Once you have done that and renamed the table as well with RENAME TABLE
laravel_migrations
TO migrations
.
You should be able to execute php artisan migrate
without any more issues.