NotInstantiableWithoutWidgetFactoryInitializationException

Complexity

Total Complexity

3

Size/Duplication

Total Lines	19
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

3 Methods

Rating	Name	Duplication	Size	Complexity
A	getSolution()	0	3	1
A	__construct()	0	6	1
A	getName()	0	3	1

<?php

declare(strict_types=1);

namespace Yiisoft\Widget;

use Throwable;
use Yiisoft\Definitions\Exception\NotInstantiableException;
use Yiisoft\FriendlyException\FriendlyExceptionInterface;

final class NotInstantiableWithoutWidgetFactoryInitializationException extends NotInstantiableException implements FriendlyExceptionInterface
{
    public function __construct(private Throwable $previous)
    {
        parent::__construct(
            $previous->getMessage() .
            ' Perhaps you need to initialize "' . WidgetFactory::class . '" with DI container to resolve dependencies.',
            previous: $previous,
        );
    }

    public function getName(): string
    {
        return 'Failed to create a widget. ' . $this->previous->getMessage();
    }

    public function getSolution(): ?string
    {
        return <<<'SOLUTION'
            Perhaps need initialize `WidgetFactory` with container for resolve dependencies.

            To initialize the widget factory call `WidgetFactory::initialize()` before using the widget.
            It is a good idea to do that for the whole application.

            Example:

            ```php
            /**
             * @var Psr\Container\ContainerInterface $container
             */

            Yiisoft\Widget\WidgetFactory::initialize(
                container: $container,
                definitions: [MyWidget::class => new MyWidget(/*...*/)],
                themes: [
                    'custom' => [
                        MyWidget::class => [
                            'setValue()' => [42],
                        ],
                    ],
                ],
                validate: true, // Whether definitions need to be validated.
            );
            ```

            See Yii example in the configuration file of this package `config/bootstrap.php`.
            SOLUTION;
    }
}