Upgrading to Drupal 9 - Speaker Deck

Slide 1

Slide 1 text

Upgrading to Drupal 9 Oliver Davies, Inviqa

Slide 2

Slide 2 text

@opdavies

Slide 3

Slide 3 text

The D7 release cycle • One long-running branch • Minor versions for bug fixes (7.80, April 2021) • No big, new features • Long time for changes to get committed to core @opdavies

Slide 4

Slide 4 text

The D8 release cycle • Semantic versioning for core • Minor release (new features) every 6 months • Patch release (bug fixes) every month • Multiple supported versions of core (8.9, 9.0, 9.1) @opdavies

Slide 5

Slide 5 text

@opdavies

Slide 6

Slide 6 text

Drupal 8 vs Drupal 9 • No new functionality • Deprecated code removed • PHP required version increased • Major versions of dependencies updated @opdavies

Slide 7

Slide 7 text

Previous upgrade issues • Lots of breaking changes • Core released, but contrib takes time to catch up @opdavies

Slide 8

Slide 8 text

Contrib improvements • Minimal code changes required • Single release can support multiple versions of core • Semantic versioning enabled for contrib projects @opdavies

Slide 9

Slide 9 text

@opdavies

Slide 10

Slide 10 text

The difference is deprecated code @opdavies

Slide 11

Slide 11 text

Deprecation example function drupal_set_message($message = NULL, $type = 'status', $repeat = FALSE) { @trigger_error('drupal_set_message() is deprecated in Drupal 8.5.0 and will be removed before Drupal 9.0.0. Use \Drupal\Core\Messenger\MessengerInterface ::addMessage() instead. See https://www.drupal.org/node/2774931', E_USER_DEPRECATED); $messenger = \Drupal::messenger(); if (isset($message)) { $messenger->addMessage($message, $type, $repeat); } return $messenger->all(); } @opdavies

Slide 12

Slide 12 text

How do I find it? @opdavies

Slide 13

Slide 13 text

Drupal Check • Developed by Matt Glaman • "Built on PHPStan, this static analysis tool will check for correctness (e.g. using a class that doesn't exist), deprecation errors, and more." • https://github.com/mglaman/drupal-check @opdavies

Slide 14

Slide 14 text

composer global require mglaman/drupal-check @opdavies

Slide 15

Slide 15 text

drupal-check web/modules/custom @opdavies

Slide 16

Slide 16 text

@opdavies

Slide 17

Slide 17 text

Upgrade Status module @opdavies

Slide 18

Slide 18 text

@opdavies

Slide 19

Slide 19 text

PHPUnit Bridge • Drupal 8 uses Symfony's PHPUnit Bridge • Includes a 'Deprecation Helper' • Displays deprecation notices in test output @opdavies

Slide 20

Slide 20 text

@opdavies

Slide 21

Slide 21 text

Fixing deprecations - drupal_set_message($text); + Drupal::messenger()->addMessage($text); @opdavies

Slide 22

Slide 22 text

@opdavies

Slide 23

Slide 23 text

Composer • Dependency management tool for PHP • My preferred way to manage Drupal codebases • composer.json lists your dependencies and version constraints • composer.lock stores the installed dependencies and versions • Separate packages for core-recommended, core-dev and core-composer-scaffold @opdavies

Slide 24

Slide 24 text

composer require drupal/admin_toolbar:^2.0 @opdavies

Slide 25

Slide 25 text

composer install @opdavies

Slide 26

Slide 26 text

composer update drupal/admin_toolbar @opdavies

Slide 27

Slide 27 text

Always add '--no-dev' in production @opdavies

Slide 28

Slide 28 text

An Example: Dransible https://github.com/opdavies/dransible @opdavies

Slide 29

Slide 29 text

@opdavies

Slide 30

Slide 30 text

Upgrading Dransible • Remove Drush (temporarily) • Update from Drupal 8.8 to 8.9 • Add Upgrade Status module • Update contrib modules to D9 compatible versions • Remove incompatible contrib modules (if possible) • Fix deprecations in custom code • Upgrade from Drupal 8.9 to 9.0 @opdavies

Slide 31

Slide 31 text

composer update drupal/core-* --with-dependencies @opdavies

Slide 32

Slide 32 text

composer require drupal/upgrade_status @opdavies

Slide 33

Slide 33 text

@opdavies

Slide 34

Slide 34 text

@opdavies

Slide 35

Slide 35 text

@opdavies

Slide 36

Slide 36 text

@opdavies

Slide 37

Slide 37 text

@opdavies

Slide 38

Slide 38 text

@opdavies

Slide 39

Slide 39 text

composer update drupal/core-* --with-dependencies @opdavies

Slide 40

Slide 40 text

@opdavies

Slide 41

Slide 41 text

@opdavies

Slide 42

Slide 42 text

There were some autowiring gotchas... @opdavies

Slide 43

Slide 43 text

Error: Class 'Symfony\Component\Config\Resource\ClassE xistenceResource' not found in Symfony\Component\Depen dencyInjection\Compiler\AutowirePass->createTypeNotFou ndMessage() @opdavies

Slide 44

Slide 44 text

composer require symfony/config:^4 @opdavies

Slide 45

Slide 45 text

Cannot autowire service "Drupal\simple_message\Display SimpleMessage": argument "$messenger" of method "__con struct()" references interface "Drupal\Core\Messenger\ MessengerInterface" but no such service exists. You sh ould maybe alias this interface to the existing "messe nger" service @opdavies

Slide 46

Slide 46 text

Fixing autowiring services: Drupal\simple_message\DisplaySimpleMessage: autowire: true tags: - { name: event_subscriber } @opdavies

Slide 47

Slide 47 text

Fixing autowiring services: + Drupal\Core\Messenger\MessengerInterface: + alias: messenger + private: true Drupal\simple_message\DisplaySimpleMessage: autowire: true tags: - { name: event_subscriber } @opdavies

Slide 48

Slide 48 text

The big deal about Drupal 9 is... that it should not be a big deal Dries Buytaert @opdavies

Slide 49

Slide 49 text

Drupal 10 • Released around June 2022 • Drupal 9 EOL around November 2023 • Symfony 4 EOL in November 2023 • Another easy upgrade @opdavies

Slide 50

Slide 50 text

Thanks! References: • https://www.drupal.org/docs/understanding-drupal • https://dri.es/drupal-9-0-0-released • https://dri.es/drupal-10-target-release-date-and-drupal-9-end-of-life • https://github.com/opdavies/dransible Me: • https://www.oliverdavies.uk @opdavies