drush-commands

Environment

All Drush commands run via ssh web drush. NEVER use just drush — it will not be found without the full vendor path.

Common operations

Task	Command
Clear all caches	ssh web drush cr
Run database updates	ssh web drush updb -y
Enable module	ssh web drush en <module> -y
Uninstall module	ssh web drush pmu <module> -y
Check Drupal status	ssh web drush status
Run cron	ssh web drush cron
One-time login	ssh web drush uli
List enabled modules	ssh web drush pm:list --status=enabled
Check pending updates	ssh web drush updb --no
Watchdog logs	ssh web drush ws --count=20
Rebuild permissions	ssh web drush php-eval "node_access_rebuild();"
Locale update	ssh web drush locale:check && ssh web drush locale:update

After code changes (mandatory order)

1. ssh web drush updb -y (apply hook_update_N)
2. ssh web drush cim -y (import config changes)
3. ssh web drush cr (rebuild caches)

Multiline / newline-separated config values

drush cget <config> <key> --format=string renders real newlines as literal \n text. Feeding that back through drush cset stores the literal backslash-n and corrupts every existing line. To append to or edit a multiline value, use php:eval, then verify with var_export:

# Append a line to a newline-separated value:
ssh web drush php:eval '$c=\Drupal::configFactory()->getEditable("mymodule.settings"); $c->set("patterns", $c->get("patterns")."\nnew-pattern")->save();'
# Verify the stored value has REAL newlines, not literal \n:
ssh web drush php:eval 'var_export(\Drupal::config("mymodule.settings")->get("patterns"));'

Custom Drush commands (Drush 12+)

Place in src/Commands/ using attribute pattern:

<?php

declare(strict_types=1);

namespace Drupal\mymodule\Commands;

use Drush\Attributes as CLI;
use Drush\Commands\DrushCommands;

final class MyModuleCommands extends DrushCommands {

  #[CLI\Command(name: 'mymodule:process')]
  #[CLI\Help(description: 'Process pending items.')]
  public function process(): void {
    $this->io()->success('Done.');
  }

}