Skip to main content

While the Drupal site has a great outline of the steps to follow, I found we needed to tweak so the update would work for us.  I found the update process from 8.7.10 to 8.8.0 that worked on our sites was as follows

Starting with ssh
  • composer update # To update any dependencies
Transfer the Drupal 8.8.0 tar gz file

Either using command line or FTP, transfer drupal-8.8.0.tar.gz to your respective directory.

Back to ssh
  • unpack the the drupal-8.8.0.tar.gz - see our update script via ssh
  • git add composer.lock; git commit
  • composer remove webflo/drupal-core-strict --no-update
  • composer remove drupal/core --no-update
  • composer require 'composer/installers:^1.7' --no-update
  • rm composer.lock
  • rm -rf vendor # Also helps avoid conflicts
  • composer require drupal/core-recommended:^8.8 --update-with-dependencies
  • git add composer.json composer.lock; git commit -m "Update Drupal to 8.8.0 and use drupal/core-recommended instead of webflo/drupal-core-strict"

I know there are many ways to complete this process.  However, when we first ran without unpacking drupal-8.8.0.tar.gz, the site failed to complete the update process due.  The errors received included

Your requirements could not be resolved to an installable set of packages.

Problem 1
  • The requested package typo3/phar-stream-wrapper (locked at v3.1.3, required as ^2.1.1) is satisfiable by typo3/phar-stream-wrapper[v3.1.3] but these conflict with your requirements or minimum-stability.
Problem 2
  • drupal/core-recommended 8.8.0 requires typo3/phar-stream-wrapper v3.1.3 -> satisfiable by typo3/phar-stream-wrapper[v3.1.3] but these conflict with your requirements or minimum-stability
  • drupal/core-recommended 8.8.0 requires typo3/phar-stream-wrapper v3.1.3 -> satisfiable by typo3/phar-stream-wrapper[v3.1.3] but these conflict with your requirements or minimum-stability
  • drupal/core-recommended 8.8.0 requires typo3/phar-stream-wrapper v3.1.3 -> satisfiable by typo3/phar-stream-wrapper[v3.1.3] but these conflict with your requirements or minimum-stability
  • Installation request for drupal/core-recommended (locked at 8.8.0, required as ^8.8) -> satisfiable by drupal/core-recommended[8.8.0]

 

Whereas, when we unpacked Drupal 8.8.0 and then ran the above scripts, the process ran seamlessly.

Unexpected error message

Once you have reached this point after updating to Drupal core 8.8.0, and you go to your site and find the error message

"The website encountered an unexpected error. Please try again later."

You need to run '/update.php' after the update.  Then your site will be back up and running.

Related articles

Andrew Fletcher04 Apr 2025
Managing .gitignore changes
When working with Git, the .gitignore file plays a critical role in controlling which files and folders are tracked by version control. Yet, many developers are unsure when changes to .gitignore take effect and how to manage files that are already being tracked. This uncertainty can lead to...
Andrew Fletcher26 Mar 2025
How to fix the ‘Undefined function t’ error in Drupal 10 or 11 code
Upgrading to Drupal 10.4+ you might have noticed a warning in their code editor stating “Undefined function ‘t’”. While Drupal’s `t()` function remains valid in procedural code, some language analysis tools — such as Intelephense — do not automatically recognise Drupal’s global functions. This...
Andrew Fletcher17 Mar 2025
Upgrading to PHP 8.4 challenges with Drupal contrib modules
The upgrade from PHP 8.3.14 to PHP 8.4.4 presents challenges for Drupal 10.4 websites, particularly when dealing with contributed modules. While Drupal core operates seamlessly, various contrib modules have not yet been updated to accommodate changes introduced in PHP 8.4.x. This has resulted in...