Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Attribute	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Command	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
DataCollector	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
DependencyInjection	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Event	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
EventListener	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Exception	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Handler	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Message	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Middleware	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Retry	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Stamp	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Test	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Transport	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
.htaccess	237 B	-r-xr-xr-x	2026-08-17 03:12
CHANGELOG.md	16.26 KB	-rwxrwxr-x	2026-03-19 04:54
Envelope.php	3.12 KB	-rwxrwxr-x	2026-03-19 04:54
HandleTrait.php	2.25 KB	-rwxrwxr-x	2026-03-19 04:54
LICENSE	1.04 KB	-rwxrwxr-x	2026-03-19 04:54
MessageBus.php	2.51 KB	-rwxrwxr-x	2026-03-19 04:54
MessageBusInterface.php	692 B	-rwxrwxr-x	2026-03-19 04:54
README.md	1012 B	-rwxrwxr-x	2026-03-19 04:54
RoutableMessageBus.php	2.12 KB	-rwxrwxr-x	2026-03-19 04:54
TraceableMessageBus.php	3.16 KB	-rwxrwxr-x	2026-03-19 04:54
Worker.php	10.49 KB	-rwxrwxr-x	2026-03-19 04:54
WorkerMetadata.php	1.07 KB	-rwxrwxr-x	2026-03-19 04:54
composer.json	1.74 KB	-rwxrwxr-x	2026-03-19 04:54

Rename

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Messenger;

use Symfony\Component\Messenger\Exception\LogicException;
use Symfony\Component\Messenger\Stamp\HandledStamp;

/**
 * Leverages a message bus to expect a single, synchronous message handling and return its result.
 *
 * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
 */
trait HandleTrait
{
    private MessageBusInterface $messageBus;

/**
     * Dispatches the given message, expecting to be handled by a single handler
     * and returns the result from the handler returned value.
     * This behavior is useful for both synchronous command & query buses,
     * the last one usually returning the handler result.
     *
     * @param object|Envelope $message The message or the message pre-wrapped in an envelope
     */
    private function handle(object $message): mixed
    {
        if (!isset($this->messageBus)) {
            throw new LogicException(\sprintf('You must provide a "%s" instance in the "%s::$messageBus" property, but that property has not been initialized yet.', MessageBusInterface::class, static::class));
        }

$envelope = $this->messageBus->dispatch($message);
        /** @var HandledStamp[] $handledStamps */
        $handledStamps = $envelope->all(HandledStamp::class);

if (!$handledStamps) {
            throw new LogicException(\sprintf('Message of type "%s" was handled zero times. Exactly one handler is expected when using "%s::%s()".', get_debug_type($envelope->getMessage()), static::class, __FUNCTION__));
        }

if (\count($handledStamps) > 1) {
            $handlers = implode(', ', array_map(fn (HandledStamp $stamp): string => \sprintf('"%s"', $stamp->getHandlerName()), $handledStamps));

throw new LogicException(\sprintf('Message of type "%s" was handled multiple times. Only one handler is expected when using "%s::%s()", got %d: %s.', get_debug_type($envelope->getMessage()), static::class, __FUNCTION__, \count($handledStamps), $handlers));
        }

return $handledStamps[0]->getResult();
    }
}