How to Successfully Upgrade Your Drupal Website from Version 8.7 to 9.3

Описание: A comprehensive guide on how to upgrade your Drupal website from version 8.7 to 9.3, including troubleshooting tips for common errors.
---
This video is based on the question https://stackoverflow.com/q/74684638/ asked by the user 'Steve' ( https://stackoverflow.com/u/20688680/ ) and on the answer https://stackoverflow.com/a/74725384/ provided by the user 'Anton' ( https://stackoverflow.com/u/18708936/ ) at 'Stack Overflow' website. Thanks to these great users and Stackexchange community for their contributions.

Visit these links for original content and any more details, such as alternate solutions, latest updates/developments on topic, comments, revision history etc. For example, the original title of the Question was: Upgrade Drupal Website from version 8.7 to 9.3

Also, Content (except music) licensed under CC BY-SA https://meta.stackexchange.com/help/l...
The original Question post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license, and the original Answer post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license.

If anything seems off to you, please feel free to write me at vlogize [AT] gmail [DOT] com.
---
Upgrading Your Drupal Website from Version 8.7 to 9.3: A Step-by-Step Guide

Upgrading a website can sometimes be a daunting task, especially when transitioning between major versions of a content management system like Drupal. If you're facing issues while upgrading your Drupal website from version 8.7 to 9.3, you've come to the right place! In this post, we will provide you with a detailed guide to successfully perform the upgrade and troubleshoot common errors.

Understanding the Problem

Many users experience difficulties when trying to upgrade their Drupal installations. One common scenario is running the automatic update script, only to find the website returning unexpected errors. As evidenced in a recent case, a user encountered an error related to missing components, making their site inaccessible. This can often stem from dependencies that need to be installed or updated.

Solution Overview

To successfully upgrade your Drupal website, follow these steps:

Check the Status Report

Backup Your Site

Install Composer (if not already installed)

Update Dependencies with Composer

Fix Missing Components and Push Changes to Staging

Let's dive into each step in detail.

Step 1: Check the Status Report

Before initiating any upgrade, check the Drupal status report for any existing alerts and warnings. It's crucial to ensure that there are no underlying issues that could affect the upgrade process.

Step 2: Backup Your Site

Always start with a backup. Create a backup of both your existing source code and your database. This will serve as a safety net in case things go wrong during the upgrade process.

Step 3: Install Composer

If you are working on a fresh device, such as a new Mac Book Pro, you will need to install Composer to manage your dependencies. Here’s how to do it:

Open your Mac Terminal.

Run the following commands:

[[See Video to Reveal this Text or Code Snippet]]

To make Composer globally executable, use:

[[See Video to Reveal this Text or Code Snippet]]

Step 4: Update Dependencies with Composer

Now that Composer is installed, navigate to your local website code directory and update the project dependencies using Composer with the following command:

[[See Video to Reveal this Text or Code Snippet]]

This command will download and install all the required dependencies for your Drupal setup.

Next, execute:

[[See Video to Reveal this Text or Code Snippet]]

This ensures that all dependencies are updated to their latest versions.

Step 5: Fix Missing Components and Push Changes to Staging

In many cases, the errors encountered, such as those indicating that certain classes or components are missing (for instance, Drush\Log\DrushLog), can be resolved by requiring the Drush package. Use the following command to include Drush:

[[See Video to Reveal this Text or Code Snippet]]

Once you've installed the necessary components, you will want to add the updated files to your local git repository:

[[See Video to Reveal this Text or Code Snippet]]

Finally, push your changes to the staging website:

[[See Video to Reveal this Text or Code Snippet]]

If your hosting provider integrates CI/CD with your repository, your code push should automatically deploy the changes to your site.

Conclusion

Upgrading your Drupal website from version 8.7 to 9.3 doesn't have to be fraught with difficulties. By following the above steps, you can ensure that your site is upgraded smoothly while addressing potential issues that might arise. Always remember to keep your backups close and address dependency errors promptly! Happy upgrading!