DIGGING INTO DRUPAL 8: CODE SNIPPETS FOR SITE BUILDERS

The more I work with Drupal 8, the more I realize how much has changed for developers in the Drupal community. While the transition to a modern, object-oriented system is what’s best for the longevity of the platform, it certainly doesn’t come without challenges. As someone who doesn’t come from an OOP background, I’ve found the transition difficult at times. In many cases, I know exactly what I want to do, just not how to do it the “Drupal 8 way”. On top of this, tutorials and blog posts on D8 are all over the map in terms of accuracy. Many posts written during D8’s development cycle are no longer applicable because of API changes, etc.

Below is a list of snippets that might be helpful to site builders or developers more familiar with D7 hooks and procedural. It might also be useful to OOP folks who are new to Drupal in general. My goal below is to add to and update these snippets over time.

ROUTES & LINKS

DETERMINE THE CURRENT DRUPAL ROUTE

Need to know what the current Drupal route is or need to run some logic against the current route? You can get the current route like so:

$route = \Drupal::routeMatch()->getRouteName();

To some, the \Drupal::routeMatch() syntax might look foreign (it did to me). Here’s a rundown of what’s happening here:

First, \Drupal. This is calling the global Drupal class, which, in Drupal 8, is a bridge between procedural and OO methods of writing Drupal code. The following comes from the documentation:

This class acts as a unified global accessor to arbitrary services within the system in order to ease the transition from procedural code to injected OO code.

Right. Moving on to ::routeMatch(). Here we’re using the routeMatch() method which “Retrieves the currently active route match object.” Simple enough. But what is “::” all about? This StackOverflow answer helped me to understand what that’s all about.

From there, the getRouteName() method returns the current route name as a string. Here are some example routes: entity.node.canonical, view.frontpage and node.type_add.

IS THIS THE FRONT PAGE ROUTE?

Need to check if the current route is the front page route? There’s a service and method for that:

// Is the current route/path the front page?
if ($is_front = \Drupal::service('path.matcher')->isFrontPage()) {}

Here we’re calling the path.matcher service (defined in /core/core.services.yml) and using the isFrontPage() method. For more on services, check out the “Services and Dependency Injection Container” documentation on api.drupal.org which helped me understand how all of these bits work together and the why of their structure.

GET THE REQUESTED PATH

Need to know what the current page’s requested path was, as opposed to the route? You can do this:

$current_uri = \Drupal::request()->getRequestUri();

REDIRECT TO A SPECIFIC ROUTE

Need to redirect to a specific page? In Drupal 7, you would likely handle this with drupal_goto() in your page callback function. In Drupal 8, you can use RedirectResponse() for that. Here is the relevant changelog.

Here are some examples, borrowed heavily from said changelog. First, in procedural PHP:

use Symfony\Component\HttpFoundation\RedirectResponse;

function my_redirect() {
  return new RedirectResponse(\Drupal::url('user.page'));
}

Here is how you would use a Drupal 8 controller to accomplish the same thing:

use Drupal\Core\Controller\ControllerBase;

class MyControllerClass extends ControllerBase {

  public function foo() {
    //...
    return $this->redirect('user.page');
  }
}