
| Current Path : /var/www/html/sirius-pallets/vendor/drush/drush/src/Commands/core/ |
Linux ift1.ift-informatik.de 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64 |
| Current File : /var/www/html/sirius-pallets/vendor/drush/drush/src/Commands/core/NotifyCommands.php |
<?php
declare(strict_types=1);
namespace Drush\Commands\core;
use Consolidation\AnnotatedCommand\CommandData;
use Consolidation\AnnotatedCommand\Hooks\HookManager;
use Consolidation\SiteProcess\Util\Escape;
use Drush\Attributes as CLI;
use Drush\Commands\DrushCommands;
use Drush\Drush;
use Symfony\Component\Filesystem\Path;
final class NotifyCommands extends DrushCommands
{
#[CLI\Hook(type: HookManager::OPTION_HOOK, target: '*')]
#[CLI\Option(name: 'notify', description: "Notify upon command completion. If set to a number, commands that finish in fewer seconds won't notify.")]
public function optionsetNotify(): void
{
}
#[CLI\Hook(type: HookManager::PRE_COMMAND_HOOK, target: '*')]
public function registerShutdown(CommandData $commandData): void
{
register_shutdown_function([$this, 'shutdown'], $commandData);
}
public function shutdown(CommandData $commandData): void
{
$annotationData = $commandData->annotationData();
if (!$cmd = $annotationData['command']) {
return;
}
if ($this->getConfig()->get('notify.duration')) {
if (self::isAllowed()) {
$msg = dt("Command '!command' completed.", ['!command' => $cmd]);
self::shutdownSend($msg, $commandData);
}
}
}
/**
* Prepares and dispatches notifications to delivery mechanisms.
*
* You may avoid routing a message to secondary messaging mechanisms (e.g. audio),
* by direct use of the delivery functions.
*
* @param string $msg
* Message to send via notification.
*/
public static function shutdownSend(string $msg, CommandData $commandData): void
{
self::shutdownSendText($msg, $commandData);
}
/**
* Send text-based system notification.
*
* This is the automatic, default behavior. It is intended for use with tools
* such as libnotify in Linux and Notification Center on OSX.
*
* @param string $msg
* Message text for delivery.
*/
public static function shutdownSendText(string $msg, CommandData $commandData): bool
{
$override = Drush::config()->get('notify.cmd');
if (!empty($override)) {
$cmd = $override;
$error_message = dt('custom notify command failed.');
} else {
switch (PHP_OS) {
case 'Darwin':
$cmd = 'terminal-notifier -message %s -title Drush';
$error_message = dt('terminal-notifier command failed. Please install it from https://github.com/alloy/terminal-notifier.');
break;
case 'Linux':
default:
$icon = Path::join(Drush::config()->get('drush.base-dir'), 'docs', 'drush_logo-black.png');
$cmd = "notify-send %s -i $icon";
$error_message = dt('notify-send command failed. Please install it as per http://coderstalk.blogspot.com/2010/02/how-to-install-notify-send-in-ubuntu.html.');
break;
}
}
// Keep backward compat and prepare a string here.
$cmd = sprintf($cmd, Escape::shellArg($msg));
$process = Drush::shell($cmd);
$process->run();
if (!$process->isSuccessful()) {
Drush::logger()->warning($error_message);
}
return true;
}
/**
* Identify if the given Drush request should trigger a notification.
*/
public static function isAllowed(): bool
{
$duration = Drush::config()->get('notify.duration');
$execution = time() - $_SERVER['REQUEST_TIME'];
return ($duration === true ||
(is_numeric($duration) && $duration > 0 && $execution > $duration));
}
}