The document discusses debugging techniques in Drupal 8. It begins by outlining some basic configuration options like PHP error reporting and the Devel module. It then covers specific debugging tools like Xdebug, Drupal Console, and the Web Profiler module. Various code examples demonstrate debugging problems like class not found errors and accessing protected properties. Continuous integration with Probo CI and pull requests are presented as solutions for testing and client approval workflows. The key steps for debugging are identified as thinking through code logically, identifying goals, finding the right tool to solve problems, and testing fixes.

1. Debugging in Drupal 8
Life After DPM : Creating and Debugging a Module
Allie Jones

2. Allie Ray Jones | @AllieRays

3. Review of Resources
Gitbook of Configuration Steps: https://www.gitbook.com/book/zivtech/debug-tools-for-drupal8/details
Github Repo of ZRMS and Module: https://github.com/AllieRays/debugging-drupal-8
Demo Site: http://zivte.ch/1Ss473k
Slide Deck: http://zivte.ch/1VxWF60
Zivtech Rocks My Socks
Demo Site
Bear Install Profile Drupal 8 Site

4. Plan Ahead:
Configuration to avoid frustration
Reduce technical debt
Why is this Important?
Stop ‘Googling’ all of your problems away
(If this blog post doesn’t solve my problem another one will)
● Fix problems & code faster
Stop thinking about debugging after the fact. You should be logically thinking through as you develop.

5. Overview
Debugging is a Personal Choice. Pick Your Tools.
Drupal Console IDE Xdebug
Continuous
Integration

6. Zivtech Rocks My Socks ( demo site http://zivte.ch/1Ss47k )

7. But First, Basic Configuration

8. Easy / Low Hanging Configuration Options
PHP.ini
Set Error Reporting to Strict: error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
Display Errors as Html: display_errors = On
Log your errors to a php_error file: log_errors = On || log_errors_max_len = 1024

9. Easy / Low Hanging Configuration Options
Configuration Settings: Use your setting.local.php.
In setting.php add an include
if (file_exists(__DIR__ . '/settings.local.php')) {
include __DIR__ . '/settings.local.php';
}
setting.local.php
Show all error messages, with backtrace information.
$config['system.logging']['error_level'] = 'verbose';
Disable CSS and JS aggregation.
$config['system.performance']['css']['preprocess'] = FALSE;
$config['system.performance']['js']['preprocess'] = FALSE;

10. Easy / Low Hanging Configuration Options
Documentation: https://api.drupal.org/api/drupal/8
Community: StackOverflow, Drupal.StackExchange & Drupal IRC
Change Records: https://www.drupal.org/list-changes/drupal

11. Change Records:
https://www.drupal.org/list-changes/drupal

12. Drupal Print Message
The Devel Module provides helper functions to print variables in the browser.
function dpm($input, $name = NULL, $type = 'status') {
if (Drupal::currentUser()->hasPermission('access devel information')) {
$export = kprint_r($input, TRUE, $name);
drupal_set_message($export, $type, TRUE);
}
return $input;
}
What is DPM anyways?

13. Caching
From the Terminal:
● Drush: drush cr (new as of D8)
● Drupal Console: drupal cache:rebuild
Everyone’s favorite love / hate relationship
From the Browser:
● Admin Ui: /admin/config/development/performance
● Chrome Settings: Disable cache

14. But Seriously,
Did You
Clear Your Cache?

15. Easy / Low Hanging Configuration Options
"Log. (Huh) What is it good for. Absolutely ..."
Debugging
/admin/reports/dblog

16. Devel Module
Drupal 7 Drupal 8

17. Drupal 8
Devel out of the Box

18. Devel Submodule: Kint
prettify all the things
“It's var_dump() and
debug_backtrace() on steroids”
print data in a human readable way
backtracing

19. Devel Submodule: Web Profiler
/admin/config/development/devel/webprofiler
Based on Symfony’s toolbar
Summary toolbar
Resources admin page
Review resource utilization
Cache effectiveness
Database queries
Views

20. Web Profiler in action

21. Drupal Console
Built on the Symfony console library
Debug Your Code
drupal routes:debug
drupal router:debug [internal route name]
Clear Cache
drupal router:rebuild
Generate Code
drupal generate:module
drupal generate:controller
drupal generate:entity:config
drupal generate:form

22. Demo

23. Zivtech Rocks My Socks (demo site)

24. Socks Module

25. Module & Basic Controller:
drupal generate:module
generate:controller

26. Config Entity : drupal generate:entity:config

27. Form : drupal generate:form

28. Let’s Break
Some Things !

29. Problem:
Class Not Found

30. PHPStorm
PHP IDE Integrated Development Environment by Jetbrains
Code hinting
Auto completion
Breakpoints
Built in Drupal settings support

31. Controller Goal: Display a basic page
namespace DrupalsocksController;
use DrupalCoreControllerControllerBase;
class SockController extends ControllerBase {
public function content() {
$sockContent = Drupal::service('socks.sock_content');
$somethings = $sockContent->displaySomethings();
return [
'#type' => 'markup',
'#markup' => t($somethings)
];
}
}
socks.sock_controller_content:
path: 'socks'
defaults:
_controller: 'DrupalsocksControllerSockController::content'
_title: 'All the Socks'
requirements:
_permission: 'access content'
socks/src/Controller/SockController.php socks/socks.routing.yml

32. Controller
namespace DrupalsocksController;
class SockController extends ControllerBase {
public function content() {
$sockContent = Drupal::service('socks.sock_content');
$somethings = $sockContent->displaySomethings();
return [
'#type' => 'markup',
'#markup' => t($somethings)
];
}
}
Problem Solution

33. Problem: Accessing
Private and
Protected Methods

34. Goal: Create a configurable entity type of Sock
namespace DrupalsocksEntity;
use DrupalCoreConfigEntityConfigEntityBase;
class Sock extends ConfigEntityBase {
public $id;
public $uuid;
public $label;
public $description;
public $fabric;
public $rating;
}
socks/Entity/Sock.php
class SockListBuilder extends ConfigEntityListBuilder {
public function buildRow(EntityInterface $entity) {
$row['id'] = $entity->id();
$row['description'] = $entity->description;
$row['fabric'] = $entity->fabric;
$row['rating'] = $entity->rating;
return $row + parent::buildRow($entity);
}
}
socks/src/Controller/SockListBuilder.php
Config Entity

35. class Sock extends ConfigEntityBase {
/**
* The sock's rating.
* @var string
*/
protected $rating;
}
public function buildRow(EntityInterface $entity) {
$row['id'] = $entity->id();
$row['description'] = $entity->description;
$row['fabric'] = $entity->fabric;
$row['rating'] = $entity->rating;
return $row + parent::buildRow($entity);
}
PROBLEM
Config Entity

36. SOLUTION
protected $rating;
/**
* @return string
*/
public function getRating() {
return $this->rating;
}
/**
* @param string $rating
*/
public function setRating($rating) {
$this->rating = $rating;
}
public function buildRow(EntityInterface $entity) {
$row['id'] = $entity->id();
$row['description'] = $entity->description;
$row['fabric'] = $entity->fabric;
$row['rating'] = $entity->getRating();
return $row + parent::buildRow($entity);
}
Sock Entity
Sock List Builder
Accessing a protected property by creating methods

37. Problem:
Syntax Error

38. Xdebug
Allows script execution to be paused at any point to read through variables
Support stack and execution traces in error messages
Profiling to find performance bottlenecks
https://zivtech.gitbooks.io/zrms/content/xdebug.html admin/reports/status/php

39. public function submitForm(array &$form, FormStateInterface $form_state) {
$result = $form_state->getValue('fav_sock');
drupal_set_message($this->t('Your favorite sock is @fav_sock',
array('@fav_sock' => $result)));
if ($result == 'Ankle Biters') {
$form_state->setRedirect('socks.knee_highs_controller_content');
}
else {
if ($result == 'Old Fashions') {
$form_state->setRedirect('socks.old_fashions_controller_content');
}
else {
$form_state->setRedirect('socks.knee_highs_controller_content');
}
}
}
Form Goal: Let users pick their favorite sock
class FavoriteSockForm extends FormBase {
public function getFormId() {
return 'favorite_sock_form';
}
public function buildForm(array $form,
FormStateInterface $form_state) {
$form['fav_sock'] = array(
'#type' => 'radios',
'#options' => array(
'Ankle Biters' => $this->t('Ankle Biters'),
'Old Fashions' => $this->t('Old Fashions'),
'Knee Highs' => $this->t('Knee Highs')
),
);
$form['submit'] = array(
'#type' => 'submit',
'#value' => t('Submit'),
);
return $form;
}
socks/src/Form/FavoriteSockForm.php

40. Form
class FavoriteSockForm extends FormBase {
public function getFormId() {
return 'favorite_sock_form';
}
public function buildForm(array $form,
FormStateInterface $form_state) {
$form['fav_sock'] = array(
'#type' => 'radios',
'#options' => array(
'Ankle Biters' => $this->t('Ankle Biters'),
'Old Fashions' => $this->t('Old Fashions'),
'Knee Highs' => $this->t('Knee Highs')
),
);
$form['submit'] = array(
'#type' => 'submit',
'#value' => t('Submit'),
);
return $form;
}
public function submitForm(array &$form, FormStateInterface $form_state) {
$result = $form_state['values']['fav_sock'];
drupal_set_message($this->t('Your favorite sock is @fav_sock',
array('@fav_sock' => $result)));
if ($result == 'Ankle Biters') {
$form_state->setRedirect('socks.knee_highs_controller_content');
}
else {
if ($result == 'Old Fashions') {
$form_state->setRedirect('socks.old_fashions_controller_content');
}
else {
$form_state->setRedirect('socks.knee_highs_controller_content');
}
}
}
socks/src/Form/FavoriteSockForm.php

41. Xdebug
$form_state->getValue is an object,
but the code is trying to access it as if it were an array.
Change $form_state['values']['fav_sock'] to $form_state->getValue('fav_sock')

42. Debugging and QA does not stop at code
completion.

43. Problem:
Shared Staging Environment
Client Approval Process

44. Probo CI
Probo CI creates test environments for each new feature
Visual representation of the project
while development is in progress
with Pull Request builds
Code more confidently &
Speed up approval process
Continuous integration

45. Probo CI
assets:
- dev.sql.gz
steps:
- name: Example site setup
plugin: Drupal
database: dev.sql.gz
databaseGzipped: true
databaseUpdates: true
revertFeatures: true
clearCaches: true
SOLUTION
https://github.com/AllieRays/debugging-drupal-8/blob/probos/.probo.yaml

46. Problem:
Cherry Picked
Deployments

47. PROBLEM

48. Pull Requests with Probo CI
SOLUTION
https://github.com/AllieRays/debugging-drupal-8/pull/1
https://9365d60b-17fa-4834-bb2b-3bba252a14c6.probo.build/ || zivte.ch/1Ss473k

49. Gitbook of Configuration Steps: https://www.gitbook.com/book/zivtech/debug-tools-for-drupal8/details
Github Repo of ZRMS and Module: https://github.com/AllieRays/debugging-drupal-8
Demo Site: http://zivte.ch/1Ss473k
Slide Deck: http://zivte.ch/1VxWF60
Step 1: Logically think through as you develop.
Step 2: Identify the goal/objective of your code.
Step 3: Identify problem and use appropriate tools to solve your problem.
Step 4: Fix and Test.
Step 5: Test Again.
Step 6: Success!
Review

50. Gitbook of Configuration Steps:
https://www.gitbook.com/book/zivte
ch/debug-tools-for-drupal8/details

51. Thank You!