Micro-PHP / lib-dependency-injection

src/Container.php

<?php

/*
 *  This file is part of the Micro framework package.
 *
 *  (c) Stanislau Komar <kost@micro-php.net>
 *
 *  For the full copyright and license information, please view the LICENSE
 *  file that was distributed with this source code.
 */

namespace Micro\Component\DependencyInjection;

use Micro\Component\DependencyInjection\Exception\ServiceNotRegisteredException;
use Micro\Component\DependencyInjection\Exception\ServiceRegistrationException;
use Psr\Container\ContainerInterface;

/**
 * @author Stanislau Komar <head.trackingsoft@gmail.com>
 */
class Container implements ContainerInterface, ContainerRegistryInterface, ContainerDecoratorInterface
{
    /**
     * @var array<class-string, mixed>

The doc comment array<class-string, mixed> at position 2 could not be parsed: Unknown type name 'class-string' at position 2 in array<class-string, mixed>.

     */
    private array $services = [];

    /**
     * @var array<class-string, callable(Container): object>

The doc comment array<class-string, callable(Container): object> at position 2 could not be parsed: Unknown type name 'class-string' at position 2 in array<class-string, callable(Container): object>.

     */
    private array $servicesRaw = [];

    /**
     * @var array<class-string, array<int, array<callable(object, Container): object>>>

The doc comment array<class-string, array<int, array<callable(object, Container): object>>> at position 2 could not be parsed: Unknown type name 'class-string' at position 2 in array<class-string, array<int, array<callable(object, Container): object>>>.

     */
    private array $decorators = [];

    /**
     * @psalm-suppress MoreSpecificImplementedParamType
     * @psalm-suppress MixedPropertyTypeCoercion
     *
     * @template T of object
     *
     * @param class-string<T> $id

The doc comment class-string<T> at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<T>.

     *
     * @psalm-return T
     */
    public function get(string $id): object
    {
        if (!empty($this->services[$id])) {
            return $this->services[$id];
        }

        $this->initializeService($id);

        return $this->services[$id];
    }

    /**
     * @param class-string $id

The doc comment class-string at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string.

     *
     * @psalm-suppress MoreSpecificImplementedParamType
     */
    public function has(string $id): bool
    {
        return !empty($this->servicesRaw[$id]) || !empty($this->services[$id]);
    }

    public function register(string $id, callable $service, bool $force = false): void
    {
        if ($this->has($id) && !$force) {
            throw new ServiceRegistrationException(sprintf('Service "%s" already registered', $id));
        }

        $this->servicesRaw[$id] = $service;
    }

    /**
     * @psalm-suppress InvalidPropertyAssignmentValue
     */
    public function decorate(string $id, callable $service, int $priority = 0): void
    {
        if (!\array_key_exists($id, $this->decorators)) {
            $this->decorators[$id] = [];
        }
        $this->decorators[$id][$priority][] = $service;
    }

    /**
     * @template T of Object
     *
     * @param class-string<T> $serviceId

The doc comment class-string<T> at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<T>.

     */
    protected function initializeService(string $serviceId): void
    {
        if (empty($this->servicesRaw[$serviceId])) {
            throw new ServiceNotRegisteredException($serviceId);
        }

        $raw = $this->servicesRaw[$serviceId];
        $service = $raw($this);
        $this->services[$serviceId] = $service;

        if (!\array_key_exists($serviceId, $this->decorators)) {
            return;
        }

        $decoratorsByPriority = $this->decorators[$serviceId];
        krsort($decoratorsByPriority);

        foreach ($decoratorsByPriority as $decorators) {
            foreach ($decorators as $decorator) {
                $this->services[$serviceId] = $decorator($this->services[$serviceId], $this);
            }
        }

        unset($this->decorators[$serviceId]);
    }
}