amp/lib/CompositeException.php

<?php

namespace Amp;

final class CompositeException extends \Exception
{
    /**
     * @var non-empty-array<array-key, \Throwable>
     */
    private array $reasons;

    /**
     * @param array<array-key, \Throwable> $reasons Array of exceptions.
     * @param string|null  $message Exception message, defaults to message generated from passed exceptions.
     *
     * @psalm-assert non-empty-array<array-key, \Throwable> $reasons
     */
    public function __construct(array $reasons, ?string $message = null)
    {
        parent::__construct($message ?? $this->generateMessage($reasons));

        $this->reasons = $reasons;
    }

    /**
     * @return non-empty-array<array-key, \Throwable>
     */
    public function getReasons(): array
    {
        return $this->reasons;
    }

    /**
     * @param non-empty-array<array-key, \Throwable> $reasons
     */
    private function generateMessage(array $reasons): string
    {
        $message = \sprintf(
            'Multiple errors encountered (%d); use "%s::getReasons()" to retrieve the array of exceptions thrown:',
            \count($reasons),
            self::class
        );

        foreach ($reasons as $reason) {
            $message .= \PHP_EOL . \PHP_EOL . \get_class($reason);

            if ($reason->getMessage() !== '') {
                $message .= ': ' . $reason->getMessage();
            }
        }

        return $message;
    }
}