Chapters
This course is archived!
This tutorial is built using Drupal 8.0. The fundamental concepts of Drupal 8 - like services & routing - are still valid, but newer versions of Drupal *do* have major differences.
-
Course Code
Subscribe to download the code!
Subscribe to download the code!
-
This Video
Subscribe to download the video!
Subscribe to download the video!
-
Course Script
Subscribe to download the script!
Subscribe to download the script!
The Drupal Console & Route Cache
Scroll down to the script below, click on any sentence (including terminal blocks) to jump to that spot in the video!
Keep on Learning!
If you liked what you've learned so far, dive in! Subscribe to get access to this tutorial plus video, code and script downloads.
The Drupal Console!
Google for a new utility called "Drupal Console". This is a fantastic console script that helps you debug, clear cache and generate code. If you love it, you should say thank you to Jesus Olivas and others for their work! It's a bit like Drush, but different, but kind of the same... I don't know. They seem to be co-existing and don't do the exact same things.
To download it, copy the curl statement and run that in your terminal. Next, move
it into a global bin directory so that you can simply type drupal from anywhere
in the terminal:
curl https://drupalconsole.com/installer -L -o drupal.phar
mv drupal.phar /usr/local/bin/drupal
chmod +x /usr/local/bin/drupal
drupal
Tip
If you're on windows, use the readfile line and don't worry about moving the file
into a bin/ directory. Instead, you can type php drupal.phar to run the drupal.phar
file that is downloaded.
Hello Drupal Console! Now try drupal list:
drupal list
This shows a huge list of all of the commands you can run. There is a lot of really good stuff in here - we'll cover some of these in this tutorial.
Clearing the Routing Cache
One of those commands is router:rebuild. Run that to clear the routing cache:
drupal router:rebuild
Ok, go back, refresh and congratulations!!! Seriously: you've just created your first custom page in Drupal 8. By the way, creating a page in the Symfony framework looks almost exactly the same. You're mastering two tools at once! You deserve a vacation.
Notice this page is literally only the text "ROOOOAR". It doesn't have any theming
or templates applied to it. We will tap into the theme system later, but this is
really interesting: if you want to return a Response all by yourself, you can
do that and Drupal won't mess with it. Hey, this could even be a JSON response for
an API. Drupal is a CMS, but it's also a modern, custom-development framework.
14 Comments
Alex B.
Griff P.
4 years ago
Sadly, the drupal console seems to be dead as one of the coauthors declared its development went on a hiatus. Community people advice using Drush instead. More on this here: https://www.drupal.org/proj...
Victor
SFCASTS
Alex B.
4 years ago
Hey guys,
Thanks for sharing this info with others!
Cheers!
Vyacheslav
5 years ago
Hi, thank you for tutorial. I have a question.
Every time we change the route we have to reset router cache and run "drupal router: rebuild". But what to do when we put our module on the production site and there is no way to run drupal router: rebuild. What to do in such cases? I'm faced a problem that until I update the router cache, I can’t see the settings for my module on the configuration page. Clear all caches buttom from "admin/config/development/performance" doesn't help.
weaverryan
SFCASTS
Vyacheslav
5 years ago
edited
Hey Vyacheslav !
Good question. So, they "router:rebuild" is basically a way to only rebuild the routing cache... without rebuilding all your cache. And so, you should be able to rebuild the router cache by rebuilding all the caches. So, I'm actually surprised that the "Clear all caches" button isn't working... as that should clear all caches (including the router cache). Most commonly, this type of thing is handled via drush at deploy time - e.g. drush cache-rebuild (which will clear all the caches, including routing cache).
Do you use Drush at deploy? Or, how do you clear the "rest of your cache" on deploy - with the "Clear all caches" button?
Cheers!
Nina
7 years ago
Hello
I use windows. How can I install drupal console?
Victor
SFCASTS
Nina
7 years ago
Bert Heyman
7 years ago
Is it possible that this
curl https://drupalconsole.com/i... -L -o drupal.phar
mv console.phar /usr/local/bin/drupal
should be this?
curl https://drupalconsole.com/i... -L -o drupal.phar
mv drupal.phar /usr/local/bin/drupal
weaverryan
SFCASTS
Bert Heyman
7 years ago
Yo Bert!
Yea, you're totally right! I just updated the code here: https://github.com/knpunive...
Thanks for pointing that out!
WEB BY DOUG
7 years ago
When I run "curl -LSs http://drupalconsole.com/in... | php" on Mac OS X 10.11.2 (El Captian) I get this error:
Warning: Phar::mapPhar(-): failed to open stream: No such file or directory in - on line 9
Fatal error: Uncaught exception 'PharException' with message 'unable to open phar for reading "-"' in -:9
Stack trace:
#0 -(9): Phar::mapPhar('console.phar')
#1 {main}
thrown in - on line 9
i have same problem too on ubuntu 15.10. what worked for me is execute
curl https://drupalconsole.com/i... -L -o drupal.phar
Looks http is not working for drupalconsole.com...
Wops. I said nothing. http redirects to https. but still don't work me with curl http...
weaverryan
SFCASTS
crevillo
7 years ago
Interesting! I just tried http and it works for me. I wonder if some curl versions don't handle the redirect correctly... I'll update the code at least to use https, which is of course better anyways :).
Thanks for the input!
weaverryan
SFCASTS
WEB BY DOUG
7 years ago
Hi there!
Hmm, i'm not sure about this. Either your system had problems downloading the phar file (so just try it again), or there is some subtle system configuration that is somehow blocking the use of PHAR files. I don't see any issues on the DrupalConsole project (https://github.com/hechoend... for this, and as far as I can tell, it just seems like the installer file you downloaded with the curl command is corrupt. You should definitely not be having problems on a Mac - that's the most common development environment.
Cheers!
"Houston: no signs of life"
Start the conversation!
What PHP libraries does this tutorial use?
// composer.json
{
"require": {
"composer/installers": "^1.0.21", // v1.0.21
"wikimedia/composer-merge-plugin": "^1.3.0" // dev-master
}
}
Running this on Drupal 9, few issues.
Mainly Drupal Console is not currently compatible with Drupal 9. See https://www.drupal.org/project/drupal/issues/3146509#comment-13679903
("Drupal Console is not yet compatible with Symfony 4, but Drupal 9 requires Symfony 4.")
So you can use Drush instead.
composer require drush/drushAfter downloading you have to run Drush as
vendor/drush/drush/drush(unless you get into Drush Launcher etc).To clear all caches use
vendor/drush/drush/drush crOr to just rebuild the routing table (as in the tutorial) you can run
vendor/drush/drush/drush ev '\Drupal::service("router.builder")->rebuild();'