Release 0.1

Author: Asisyas

.gitignore

@@ -0,0 +1,3 @@
+vendor/
+composer.lock
+.phpunit.result.cache

README.md

@@ -0,0 +1,59 @@
+>**:heavy_exclamation_mark: Basic container implementation with the ability to inject dependencies**
+
+### Requirements
+
+PHP  >= 8.0.0
+
+### How to use the library
+
+Add the latest version of MicroDependencyInjection into your project by using Composer or manually:
+
+__Using Composer (Recommended)__
+
+Either run the following command in the root directory of your project:
+```
+composer require micro/dependency-injection
+```
+
+Or require the Checkout.com package inside the composer.json of your project:
+```
+"require": {
+    "php": ">=8.0",
+    "micro/dependency-injection": "dev-master"
+},
+```
+
+### Example
+
+After adding the library to your project, include the file autoload.php found in root of the library.
+```html
+include 'vendor/autoload.php';
+```
+
+Simple usage:
+```php
+use \Micro\Component\DependencyInjection\Container;
+
+class Logger {
+}
+
+class Mailer {
+    public function __construct(private Logger $logger) {}
+}
+
+$container = new Container();
+
+$container->register(Logger::class, function(Container $container) {
+    return new Logger();
+});
+
+$container->register(Mailer::class, function(Container $container) {
+    return new Mailer($container->get(Logger::class));
+});
+
+$mailer = $container->get(Mailer::class);
+```
+
+### Sample code for:
+
+- [PSR-11](https://www.php-fig.org/psr/psr-11/)

composer.json

@@ -0,0 +1,25 @@
+{
+    "name": "micro/dependency-injection",
+    "description": "Dependency injection service container",
+    "type": "library",
+    "license": "MIT",
+    "version": "0.1",
+    "autoload": {
+        "psr-4": {
+            "Micro\\Component\\DependencyInjection\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "Stanislau.Komar",
+            "email": "stanislau_komar@epam.com"
+        }
+    ],
+    "minimum-stability": "stable",
+    "require": {
+        "psr/container": "^2.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9"
+    }
+}

phpunit.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         backupGlobals="false"
+         backupStaticAttributes="false"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false">
+  <coverage>
+    <include>
+      <directory suffix=".php">src/</directory>
+    </include>
+  </coverage>
+  <testsuites>
+    <testsuite name="Micro Component: Dependency Injection Unit Test Suite">
+      <directory>tests/unit</directory>
+    </testsuite>
+  </testsuites>
+  <php>
+    <env name="APP_ENV" value="testing"/>
+  </php>
+</phpunit>

src/Container.php

@@ -0,0 +1,88 @@
+<?php
+
+namespace Micro\Component\DependencyInjection;
+
+
+use Micro\Component\DependencyInjection\Exception\ServiceNotRegisteredException;
+use Micro\Component\DependencyInjection\Exception\ServiceRegistrationException;
+use Psr\Container\ContainerInterface;
+use \Closure;
+
+class Container implements ContainerInterface, ContainerRegistryInterface
+{
+    /**
+     * @var array<string, object>
+     */
+    private array $services;
+
+    /**
+     * @var array<string, Closure>
+     */
+    private array $servicesRaw;
+
+
+    public function __construct()
+    {
+        $this->services = [];
+        $this->servicesRaw = [];
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function get(string $id)
+    {
+        return $this->lookupService($id);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function has(string $id): bool
+    {
+        return !empty($this->servicesRaw[$id]) || !empty($this->services[$id]);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function register(string $id, \Closure $service): void
+    {
+        if($this->has($id)) {
+            throw new ServiceRegistrationException($id);
+        }
+
+        $this->servicesRaw[$id] = $service;
+    }
+
+    /**
+     * @param string $id
+     * @return object
+     */
+    private function lookupService(string $id): object
+    {
+        if(!empty($this->services[$id])) {
+            return $this->services[$id];
+        }
+
+        return $this->createServiceInstance($id);
+    }
+
+    /**
+     * @param string $id
+     * @return object
+     */
+    private function createServiceInstance(string $id): object
+    {
+        if(empty($this->servicesRaw[$id])) {
+            throw new ServiceNotRegisteredException($id);
+        }
+
+        $raw = $this->servicesRaw[$id];
+        $service = $raw($this);
+
+        $this->services[$id] = $service;
+
+        return $service;
+    }
+}

src/ContainerRegistryInterface.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Micro\Component\DependencyInjection;
+
+
+interface ContainerRegistryInterface
+{
+    /**
+     * @param string $alias
+     * @param \Closure $service
+     * @return void
+     */
+    public function register(string $id, \Closure $service): void;
+}

src/Exception/ServiceNotRegisteredException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Micro\Component\DependencyInjection\Exception;
+
+use Psr\Container\NotFoundExceptionInterface;
+
+class ServiceNotRegisteredException extends \RuntimeException implements NotFoundExceptionInterface
+{
+}

src/Exception/ServiceRegistrationException.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Micro\Component\DependencyInjection\Exception;
+
+use Psr\Container\ContainerExceptionInterface;
+
+class ServiceRegistrationException extends \RuntimeException implements ContainerExceptionInterface
+{
+
+}

tests/unit/ContainerTest.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Micro\Component\DependencyInjection\Tests;
+
+use Micro\Component\DependencyInjection\Container;
+use Micro\Component\DependencyInjection\Exception\ServiceNotRegisteredException;
+use Micro\Component\DependencyInjection\Exception\ServiceRegistrationException;
+use PHPUnit\Framework\TestCase;
+
+class ContainerTest extends TestCase
+{
+    public function testContainerResolveDependencies(): void
+    {
+        $container = new Container();
+
+        $container->register('test', function ( Container $container ) { return new class {
+            public string $name = 'success';
+        }; });
+
+        $service = $container->get('test');
+        $this->assertIsObject($service);
+        $this->assertEquals('success', $service->name);
+    }
+
+    public function testRegisterTwoServicesWithEqualAliasesException(): void
+    {
+        $this->expectException(ServiceRegistrationException::class);
+        $container = new Container();
+
+        $container->register('test', function ( Container $container ) { return new class {}; });
+        $container->register('test', function ( Container $container ) { return new class {}; });
+    }
+
+    public function testContainerUnresolvedException(): void
+    {
+        $this->expectException(ServiceNotRegisteredException::class);
+
+        $container = new Container();
+        $container->register('test', function ( Container $container ) { return new class {
+            public string $name = 'success';
+        }; });
+
+        $container->get('test2');
+    }
+}