Drupal - Découvrez la fonction ddm, pour débuguer même en aveugle

Posté le Vendredi 3 avril 2020 - 15:18
Sortie de la fonction ddm

Si vous développez avec drupal, vous connaissez peut-être les fonctions dump, dpm ou kint, (sinon, lisez ma rapide présentation de kint.)

Une autre fonction très pratique mais moins connue est ddm(), anciennement connue sous le nom de dd(), qui permet de dumper les paramètres dans un fichier, au lieu de les afficher dans la page. Cette fonction est donc très pratique dans les cas où l’on a aucun retour d’affiché (batch, hook_update, EventSubscriber...)

Note : Cette fonction vient du module devel, le module doit donc être installé et activé pour que la fonction soit disponible.

Le paramètre passé à la fonction est dumpé dans le fichier temporary://drupal-debug.txt, ainsi, sur mon site le wrapper temporary:// est configuré dans le dossier ../files/tmp. (Note : cette configuration se fait directement dans le fichier settings.php de drupal, elle était avant dans Configuration / Médias / Système de fichier)

Image
Configuration dossier tmp

Je peux donc afficher le contenu de ce fichier directement dans un éditeur de texte. À savoir que les tableaux et objets sont dumpé hiéarchiquement, ce qui est pratique mais qui peut rapidement alourdir ce fichier !

  1. # Dans un de vos fichier php :
  2.  
  3. ddm($variable);
Image
Sortie de drupal_debug.txt

On peut assi ajouter des labels à ce que l'on dump pour éviter de se perdre quand on dump plusieurs variables :

  1. function kgaut_2020_preprocess_node(array &$variables) {
  2. /** @var \Drupal\node\Entity\Node $node */
  3. $node = $variables['elements']['#node'];
  4.  
  5. ddm('------------------');
  6. ddm($node->getType(), 'Type de noeud');
  7. ddm($node->getTitle(), 'Titre');
  8. ddm($node->getCreatedTime(), 'Created');
  9. ...
  10. }
Image
Sortie de ddm

Enfin, la fonction bach tail, on peut afficher en live ce qui est dumpé, dans un terminal, sans avoir à recharger le fichier, la commande à exécuter est ci-dessous :

  1. # Chemin à adapter en fonction de votre organisation :
  2.  
  3. tail -f /vhosts/kgaut.net/files/tmp/drupal_debug.txt

Évidement, cela ne vaut pas un "vrai" debuger comme xdebug ou autre, mais c'est mieux que rien !

Aller plus loin ?

 

Comments

Fabien

Posté le Vendredi 17 avril 2020 - 12:37

Merci Kevin pour l'astuce, très utile.
Je me demandais notamment comment récupérer certaines valeurs d'appel ajax sur un form lors d'un événement sur un select ou une case à cochée. Là je penses qu'on peut, non ? Ou il y a plus simple peut-être ?

Ajouter un commentaire

Ne sera pas publié

HTML restreint

  • Balises HTML autorisées : <a href hreflang> <em> <strong> <cite> <blockquote cite> <code> <ul type> <ol start type> <li> <dl> <dt> <dd> <h2 id> <h3 id> <h4 id> <h5 id> <h6 id>
  • Les lignes et les paragraphes vont à la ligne automatiquement.
  • Les adresses de pages web et les adresses courriel se transforment en liens automatiquement.
CAPTCHA Désolé, pour ça, mais c'est le seul moyen pour éviter le spam...