final class UserCommands extends DrushCommands (View source)

Traits

A copy of \Drupal\Core\DependencyInjection\AutowireTrait with first params' type hint changed.

ProcessManagerAwareTrait
LoggerAwareTrait
IO

Constants

REQ

OPT

EXIT_SUCCESS

EXIT_FAILURE

EXIT_FAILURE_WITH_CLARITY

INFORMATION

BLOCK

UNBLOCK

ROLE_ADD

ROLE_REMOVE

CREATE

CANCEL

PASSWORD

INF_LABELS

INF_DEFAULT_FIELDS

Properties

protected $uri from  ExecTrait
protected ConfigInterface $config from  ConfigAwareTrait
protected InputInterface $input from  InputAwareTrait
protected OutputInterface $output from  OutputAwareTrait
protected $io from  IO
protected $obj from  IO
protected CommandData|null $commandData from  DrushCommands

Methods

bool
startBrowser(string|null $uri = null, int $sleep = 0, int|null $port = null, string|bool $browser = false)

Starts a background browser/tab for the current site or a specified URL.

static bool
programExists($program)

No description

static string
getEditor(string|null $editor = null)

No description

$this
setConfig(ConfigInterface $config)

Set the config management object.

ConfigInterface
getConfig()

Get the config management object.

static string
configPrefix()

Any class that uses ConfigAwareTrait SHOULD override this method , and define a prefix for its configuration items. This is usually done in a base class. When used, this method should return a string that ends with a "."; see BaseTask::configPrefix().

static 
configClassIdentifier($classname)

No description

static 
configPostfix()

No description

static 
configure(string $key, mixed $value, ConfigInterface|null $config = null)

No description

mixed|null
getConfigValue(string $key, mixed|null $default = null)

No description

$this
setInput(InputInterface $input)

No description

InputInterface
input()

No description

InputInterface
getInput() deprecated

Backwards compatibility.

$this
setOutput(OutputInterface $output)

No description

OutputInterface
output()

No description

OutputInterface
stderr()

No description

OutputInterface
getOutput() deprecated

Backwards compatibility

currentState()

No description

from  IO
__construct(DateFormatterInterface $dateFormatter)

No description

restore()

No description

from  IO
void
configurePrompts(InputInterface $input)

Configure the prompt fallbacks.

mixed
promptUntilValid(Closure $prompt, bool|string $required, Closure|null $validate)

Prompt the user until the given validation callback passes.

void
restorePrompts()

Restore the prompts output.

bool
runningUnitTests()

No description

DrushStyle
io()

Override Robo's IO function with our custom style.

DrushLoggerManager|null
logger()

Returns a logger object.

void
printFile(string $file)

Print the contents of a file.

preHook(CommandData $commandData)

Persist commandData for use in primary command callback. Used by 'topic' commands.

initHook($input, AnnotationData $annotationData)

Configure Laravel prompts package.

printFileTopic(CommandData $commandData)

Print the contents of a file. The path comes from the @topic annotation.

HandlerStack
getStack()

Get a Guzzle handler stack that uses the Drush logger.

processManager()

This method overrides the trait in order to provide a more specific return type.

static AutowireTrait
create(ContainerInterface $container)

Instantiates a new instance of the implementing class using autowiring.

information(string $names = '', $options = ['format' => 'table', 'uid' => self::REQ, 'mail' => self::REQ])

Print information about the specified user(s).

renderRolesCell($key, $cellData, FormatterOptions $options)

No description

void
block(string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Block the specified user(s).

void
unblock(string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Unblock the specified user(s).

void
addRole(string $role, string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Add a role to the specified user accounts.

void
removeRole(string $role, string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Remove a role from the specified user accounts.

CommandError
createUser(string $name, $options = ['format' => 'table', 'password' => self::REQ, 'mail' => self::REQ])

Create a user account.

void
createValidate(CommandData $commandData)

Assure that provided username is available.

void
cancel(string $names = '', $options = ['delete-content' => false, 'reassign-content' => false, 'uid' => self::REQ, 'mail' => self::REQ])

Block or delete user account(s) with the specified name(s).

void
password(string $name, string $password)

Set the password for the user account with the specified name.

array
infoArray($account)

A flatter and simpler array presentation of a Drupal $user object.

array
getAccounts(string $names = '', array $options = [])

Get accounts from name variables or uid & mail options.

void
roleComplete(CompletionInput $input, CompletionSuggestions $suggestions)

No description

Details

bool startBrowser(string|null $uri = null, int $sleep = 0, int|null $port = null, string|bool $browser = false)

Starts a background browser/tab for the current site or a specified URL.

Uses a non-blocking Process call, so Drush execution will continue.

Parameters

string|null $uri

Optional URI or site path to open in browser. If omitted, or if a site path is specified, the current site home page uri will be prepended if the site's hostname resolves.

int $sleep
int|null $port
string|bool $browser

Return Value

bool

TRUE if browser was opened. FALSE if browser was disabled by the user or a default browser could not be found.

static bool programExists($program)

No description

Parameters

$program

Return Value

bool

static string getEditor(string|null $editor = null)

No description

Parameters

string|null $editor

Return Value

string

$this setConfig(ConfigInterface $config)

Set the config management object.

Parameters

ConfigInterface $config

Return Value

$this

ConfigInterface getConfig()

Get the config management object.

Return Value

ConfigInterface

static protected string configPrefix()

Any class that uses ConfigAwareTrait SHOULD override this method , and define a prefix for its configuration items. This is usually done in a base class. When used, this method should return a string that ends with a "."; see BaseTask::configPrefix().

Return Value

string

static protected configClassIdentifier($classname)

No description

Parameters

$classname

static protected configPostfix()

No description

static configure(string $key, mixed $value, ConfigInterface|null $config = null)

No description

Parameters

string $key
mixed $value
ConfigInterface|null $config

protected mixed|null getConfigValue(string $key, mixed|null $default = null)

No description

Parameters

string $key
mixed|null $default

Return Value

mixed|null

$this setInput(InputInterface $input)

No description

Parameters

InputInterface $input

Return Value

$this

See also

\Symfony\Component\Console\Input\InputAwareInterface::setInput()

protected InputInterface input()

No description

Return Value

InputInterface

protected InputInterface getInput() deprecated

deprecated

Backwards compatibility.

Return Value

InputInterface

$this setOutput(OutputInterface $output)

No description

Parameters

OutputInterface $output

Return Value

$this

See also

\Robo\Contract\OutputAwareInterface::setOutput()

protected OutputInterface output()

No description

Return Value

OutputInterface

protected OutputInterface stderr()

No description

Return Value

OutputInterface

protected OutputInterface getOutput() deprecated

deprecated

Backwards compatibility

Return Value

OutputInterface

currentState()

No description

__construct(DateFormatterInterface $dateFormatter)

No description

Parameters

DateFormatterInterface $dateFormatter

restore()

No description

protected void configurePrompts(InputInterface $input)

Configure the prompt fallbacks.

Parameters

InputInterface $input

Return Value

void

protected mixed promptUntilValid(Closure $prompt, bool|string $required, Closure|null $validate)

Prompt the user until the given validation callback passes.

Parameters

Closure $prompt
bool|string $required
Closure|null $validate

Return Value

mixed

protected void restorePrompts()

Restore the prompts output.

Return Value

void

protected bool runningUnitTests()

No description

Return Value

bool

protected DrushStyle io()

Override Robo's IO function with our custom style.

Return Value

DrushStyle

DrushLoggerManager|null logger()

Returns a logger object.

Return Value

DrushLoggerManager|null

protected void printFile(string $file)

Print the contents of a file.

Parameters

string $file

Full path to a file.

Return Value

void

preHook(CommandData $commandData)

Persist commandData for use in primary command callback. Used by 'topic' commands.

Parameters

CommandData $commandData

initHook($input, AnnotationData $annotationData)

Configure Laravel prompts package.

Parameters

$input
AnnotationData $annotationData

protected printFileTopic(CommandData $commandData)

Print the contents of a file. The path comes from the @topic annotation.

Parameters

CommandData $commandData

Full path to a file.

protected HandlerStack getStack()

Get a Guzzle handler stack that uses the Drush logger.

ProcessManager processManager()

This method overrides the trait in order to provide a more specific return type.

Return Value

ProcessManager

static AutowireTrait create(ContainerInterface $container)

Instantiates a new instance of the implementing class using autowiring.

Parameters

ContainerInterface $container

The service container this instance should use.

Return Value

AutowireTrait

RowsOfFields information(string $names = '', $options = ['format' => 'table', 'uid' => self::REQ, 'mail' => self::REQ])

Print information about the specified user(s).

Parameters

string $names
$options

Return Value

RowsOfFields

renderRolesCell($key, $cellData, FormatterOptions $options)

No description

Parameters

$key
$cellData
FormatterOptions $options

void block(string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Block the specified user(s).

Parameters

string $names
$options

Return Value

void

void unblock(string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Unblock the specified user(s).

Parameters

string $names
$options

Return Value

void

void addRole(string $role, string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Add a role to the specified user accounts.

Parameters

string $role
string $names
$options

Return Value

void

void removeRole(string $role, string $names = '', $options = ['uid' => self::REQ, 'mail' => self::REQ])

Remove a role from the specified user accounts.

Parameters

string $role
string $names
$options

Return Value

void

CommandError createUser(string $name, $options = ['format' => 'table', 'password' => self::REQ, 'mail' => self::REQ])

Create a user account.

Parameters

string $name
$options

Return Value

CommandError

void createValidate(CommandData $commandData)

Assure that provided username is available.

Parameters

CommandData $commandData

Return Value

void

void cancel(string $names = '', $options = ['delete-content' => false, 'reassign-content' => false, 'uid' => self::REQ, 'mail' => self::REQ])

Block or delete user account(s) with the specified name(s).

  • Existing content may be deleted or reassigned to the Anonymous user. See options.
  • By default only nodes are deleted or reassigned. Custom entity types need own code to support cancellation. See https://www.drupal.org/project/drupal/issues/3043725 for updates.

Parameters

string $names
$options

Return Value

void

void password(string $name, string $password)

Set the password for the user account with the specified name.

Parameters

string $name
string $password

Return Value

void

array infoArray($account)

A flatter and simpler array presentation of a Drupal $user object.

Parameters

$account

Return Value

array

protected array getAccounts(string $names = '', array $options = [])

Get accounts from name variables or uid & mail options.

Parameters

string $names
array $options

A array of loaded accounts.

Return Value

array

Exceptions

Exception

void roleComplete(CompletionInput $input, CompletionSuggestions $suggestions)

No description

Parameters

CompletionInput $input
CompletionSuggestions $suggestions

Return Value

void