Afin de faciliter la mise à jour du code de Drupal 8 vers 9, un bel outil a été créé par la communauté qui tourne statiquement sur votre code et souligne toute l'utilisation de code obsolète que vous pourriez avoir. C'est un utilitaire de ligne de commande appelé drupal-check qui est facilement installable et peut accélérer le processus de migration de votre projet. Bien sûr, vous pouvez également compter sur l’IDE pour signaler les avertissements obsolètes.
Drupal-Check
Vous avez peut-être déjà entendu parler de Drupal-Check?
Construit sur PHPStan, cet outil d'analyse statique vérifie l'exactitude (par exemple, en utilisant une classe qui n'existe pas), les erreurs d'obsolescence, etc.
Au lieu d'exécuter PHPStan directement, vous exécutez Drupal Check. Il comprend PHPStan, les règles de dépréciation de PHPStan et PHPStan Drupal et leurs configurations.
Pourquoi? Bien qu'il existe de nombreux outils d'analyse statique, aucun d'entre eux ne fonctionne avec le contexte Drupal à l'esprit. Cela permet de vérifier les modules de contribution pour les erreurs de dépréciation générées par le noyau.
Avec la tendance actuelle au sein de la communauté Drupal suite au fin de cycle de maintenance de Drupal 7 en 2022. Êtes-vous prêt à migrer votre projet vers Drupal 9?
Consultez ces quelques instructions d’utilisation de Drupal-check pour une correction et vérification de votre code vers Drupal 9.
Exigences
Nécessite une version de Php supérieur à la 7.2
Installation
Vous pouvez l'installer dans votre projet en utilisant Composer comme dépendance de développement comme ceci:
composer require mglaman/drupal-check --dev
Vous pouvez également l'installer globalement à l'aide de Composer comme ceci:
composer global require mglaman/drupal-check
Reportez-vous à la documentation de Composer pour savoir comment vous assurer que les binaires globaux sont dans votre PATH: https://getcomposer.org/doc/00-intro.md#manual-installation
Cet outil fonctionne sur tout le code Drupal, mais doit être exécuté dans le répertoire racine d'un projet Drupal.
Usage
drupal-check [OPTIONS] [DIRS]
- OPTIONS - Voir "Options" pour les valeurs autorisées. Spécifiez les multiples dans l'ordre, par exemple -ad.
- DIRS - Un ou plusieurs répertoires à la racine d'un projet Drupal.
Options
- -a : Vérifier l'analyse
- -d : Vérifier les abandons (par défaut)
- -e: Exclure les répertoires. Les caractères génériques fonctionnent. Séparez les répertoires exclus par des virgules, sans espace. par exemple: */tests/codeception/acceptance/*.php
- ---drupal-root Chemin vers la racine Drupal. Option de secours si drupal-check n'a pas pu identifier la racine Drupal à partir du ou des chemins fournis.
Exemples sur quelques modules contributes
- Vérifiez le module de contribution d'adresse:
drupal-check web/modules/contrib/adresse
- Vérifiez le module de contribution d'adresse pour les dépréciations:
drupal-check -d web/modules/contrib/adresse
- Vérifiez le module de contribution d'adresse pour l'analyse:
drupal-check -a web/modules/contrib/adresse
- Vérifiez le module de contribution d'adresse pour les dépréciations et l'analyse:
drupal-check -ad web/modules/contrib/adresse
Ajouter un commentaire