Add container proxy

[yiiliveext]

Q	A
Is bugfix?	✔️
New feature?	✔️
Breaks BC?	✔️
Tests pass?	✔️
Fixed issues	#107 #110

Don't merge! This is a demo PR.

Old container syntax

$container = new Container($definitions);

New container syntax

$container = Container::getBuilder()->registerDefinitions($definitions)->build();

index.php container&debugger registration expample

$containerBuilder = Container::getBuilder()
    ->registerDefinitions(require Builder::path('web'));

/**
 * @var array $params The variable is available after requiring config files.
 */
$debugEnabled = (bool)($params['debugger.enabled'] ?? false) && class_exists(Debugger::class);
if ($debugEnabled) {
   $debuggerServiceProvider = new DebugServiceProvider();
   $containerBuilder->registerServiceProviders([$debuggerServiceProvider]);
}
$container = $containerBuilder->build();

Container proxy config

// /config/web.php
CommonServiceCollectorInterface::class => CommonServiceCollector::class,
ContainerProxyInterface::class => static function (ContainerInterface $container) use ($params) {
        $collector = $container->get(CommonServiceCollectorInterface::class);
        $dispatcher = $container->get(EventDispatcherInterface::class);
        $debuggerEnabled = (bool)($params['debugger.enabled'] ?? false);
        $trackedServices = (array)($params['debugger.trackedServices'] ?? []);
        $decoratedServices = (array)($params['container.decorators'] ?? []);
        $runtime = $container->get(Aliases::class)->get('@runtime');
        $path = "$runtime/cache/container-proxy";
        if (!is_dir($path)) {
            mkdir($path);
        }
        $logLevel = ContainerProxy::LOG_ARGUMENTS | ContainerProxy::LOG_RESULT | ContainerProxy::LOG_ERROR;
        return new ContainerProxy(
            $debuggerEnabled,
            array_merge($trackedServices, $decoratedServices),
            $container,
            $dispatcher,
            $collector,
            $path,
            $logLevel
        );
},

// /config/params.php
'debugger.enabled' => true,
'debugger.trackedServices' => [
    \Cycle\ORM\FactoryInterface::class,
    \Yiisoft\Mailer\MailerInterface::class,
    \Psr\Http\Message\ServerRequestFactoryInterface::class,
    \Yiisoft\Yii\Web\Session\SessionInterface::class,
    \Yiisoft\Router\RouteCollectorInterface::class,
],
'debugger.collectors' => [
    \Yiisoft\Di\CommonServiceCollector::class
],
'container.decorators' => [
    // custom method decorator
    \Yiisoft\Router\UrlGeneratorInterface::class => [
        'generate' =>function ($result, $name, $params = []) {
            if ($name === 'site/contact') {
                return $result .  '/me';
            }
            return $result;
        }
    ],
],

Also, you can remove debugger enable from the index.php, and enable it from config

'debugger.trackedServices' => [
    //array-configured interface decorator/proxy, the first param is a proxy/decorator class, other params are decorator's constructor parameters
    LoggerInterface::class => [LoggerInterfaceProxy::class, LogCollectorInterface::class],
    //callback-cofigured interface decorator/proxy
    EventDispatcherInterface::class => function (ContainerInterface $container) {
        $dispatcher = $container->get(EventDispatcherInterface::class);
        $compositeDispatcher = new CompositeDispatcher();
        $compositeDispatcher->attach($container->get(DebugStartupDispatcher::class));
        $compositeDispatcher->attach($container->get(DebugEventDispatcher::class));
        $compositeDispatcher->attach($dispatcher);
        $compositeDispatcher->attach($container->get(DebugShutdownDispatcher::class));

        return new EventDispatcherInterfaceProxy($compositeDispatcher, $container->get(EventCollectorInterface::class));
    },
],

[samdark]

#109 could be merged into it to validate issue is fixed.