Add Autowire class for consistent DI support

Author: danielRConsid

README.md

@@ -14,10 +14,14 @@ Container, Factories and dependency injectors will help to make your PHP code mo
 Containers allowing you to easily create and retrieve objects that are needed throughout your application.
 ```php
 use MaplePHP\Container\Container;
+
 $container = new Container();
-$container->set("YourClass", \YourNamespace\To\YourClass::class); // Bind "YourClass" to container and dependency injector
-$yourClass = $container->get("YourClass")->get(); // Will return "YourClass"
-//$yourClass->yourClassMehthod();
+
+// You can set mixed values in the container
+$container->set("hasEmail", true);
+
+$hasEmail = $container->get("hasEmail")->get();
+var_dump($hasEmail); // Result in: (bool) true
 ```
 If the constructor of "YourClass" contains unresolved class arguments, the dependency injector will attempt to automatically locate them for you. Read more under the headline **dependency injector**.
 
@@ -40,32 +44,16 @@ Take a look at this example
 
 ```php
 
-$container->set("YourClass", \YourNamespace\To\YourClass::class);
-$testService = $container->get("YourClass");
-echo $testService->start();
-
-```
-The above code will load **YourClass** and auto initialize the class **Test**.
-
-```php
-namespace YourNamespace\To;
-
-use YourNamespace\ToTestClasses\Test;
-
-class YourClass {
-    
-    private $test;
+use MaplePHP\Container\Container;
+use MaplePHP\Container\Autowire;
+use App\Services\MailService;
 
-    // Dependency injector will auto load "Test" class and the "Test" classes and so on.
-    function __construct(Test $test) {
-        $this->test = $test;
-    }
+$container = new Container();
+$container->set("MailService", new Autowire(MailService::class));
 
-    function start() {
-        return $this->test->get("This is the start page");
-    }
-    
-}
+// This will return "MailService" with all dependencies resolved on constructor
+$mailService = $container->get("MailService")->get();
+echo $mailService->send();
 ```
 
 ## Event handler

composer.json

@@ -27,8 +27,12 @@
     "maplephp/dto": "^3.0"
   },
   "autoload": {
+    "files": [
+      "src/Setup/aliases.php"
+    ],
     "psr-4": {
-      "MaplePHP\\Container\\": ""
+      "Psr\\Container\\": "src/Interfaces/",
+      "MaplePHP\\Container\\": "src"
     }
   },
   "minimum-stability": "dev"

src/Autowire.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace MaplePHP\Container;
+
+use MaplePHP\Container\Interfaces\AutowireInterface;
+
+class Autowire implements AutowireInterface
+{
+
+    private Reflection $reflect;
+    /**
+     * @var mixed|object|null
+     */
+    private mixed $class = null;
+    private bool $disableDI = false;
+
+    /**
+     * @param string $class
+     * @throws \ReflectionException
+     */
+    public function __construct(string $class)
+    {
+        if (is_string($class) && class_exists($class)) {
+            $this->reflect = new Reflection($class);
+        } else {
+            throw new \InvalidArgumentException("The class {$class} does not exist.");
+        }
+    }
+
+    /**
+     * Disable the dependency injector
+     *
+     * Note: This method MUST be implemented in such a way as to retain the immutability
+     *
+     * @return $this
+     */
+    public function disableDI(): self
+    {
+        $inst = clone $this;
+        $inst->disableDI = true;
+        return $inst;
+    }
+
+    /**
+     * Pass custom arguments to the class constructor
+     *
+     * Note: This method MUST be implemented in such a way as to retain the immutability
+     * NOTE: This will disable the dependency injector
+     *
+     * @param array $args
+     * @return $this
+     */
+    public function addArgs(array $args): self
+    {
+        if(count($args) <= 0) {
+            throw new \InvalidArgumentException("You must provide at least one argument.");
+        }
+        $inst = $this->disableDI();
+        $inst->reflect->setArgs($args);
+        return $inst;
+    }
+
+    /**
+     * Run the class with all dependencies.
+     *
+     * @return mixed
+     * @throws \ReflectionException
+     */
+    public function run(): mixed
+    {
+        if (is_null($this->class)) {
+            $this->class = ($this->disableDI) ? $this->reflect->get() : $this->reflect->dependencyInjector();
+        }
+        return $this->class;
+    }
+}

Container.php src/Container.phpContainer.php renamed to src/Container.php

@@ -5,7 +5,8 @@
 namespace MaplePHP\Container;
 
 use Closure;
-use MaplePHP\Container\Interfaces\ContainerInterface;
+use MaplePHP\Container\Interfaces\AutowireInterface;
+use Psr\Container\ContainerInterface;
 use MaplePHP\Container\Interfaces\FactoryInterface;
 use MaplePHP\DTO\Format\Arr;
 //use MaplePHP\Container\Reflection;
@@ -112,27 +113,26 @@ public function isContainer(string $identifier): bool
 
     /**
      * Get a container or factory
-     * @param string $identifier [description]
-     * @param array $args Is possible to overwrite/add __construct or method argumnets
-     * @return mixed
+     * @template T of object
+     * @param class-string<T>|string $identifier The class or service identifier
+     * @param string $identifier
+     * @param array $args Is possible to overwrite/add __construct or method arguments
+     * @return T
      * @throws ReflectionException
      */
     public function get(string $identifier, array $args = []): mixed
     {
-        if ($service = $this->getService($identifier)) {
+        $service = $this->getService($identifier);
+        if (isset($service)) {
             if (count($args) === 0) {
                 $args = $this->getArgs($identifier);
             }
             if ($this->isFactory($identifier)) {
                 $this->getter[$identifier] = $service(...$args);
             } else {
-                if (empty($this->getter[$identifier])) {
-                    if (is_string($service) && class_exists($service)) {
-                        $reflect = new Reflection($service);
-                        if (count($args) > 0) {
-                            $reflect->setArgs($args);
-                        }
-                        $this->getter[$identifier] = $reflect->get();
+                if (!isset($this->getter[$identifier])) {
+                    if ($service instanceof AutowireInterface) {
+                        $this->getter[$identifier] = $service->run();
                     } else {
                         $this->getter[$identifier] = $service;
                     }

EventHandler.php src/EventHandler.phpEventHandler.php renamed to src/EventHandler.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace MaplePHP\Container\Interfaces;
+
+interface AutowireInterface
+{
+    /**
+     * Disable the dependency injector
+     *
+     * Note: This method MUST be implemented in such a way as to retain the immutability
+     *
+     * @return $this
+     */
+    public function disableDI(): self;
+
+    /**
+     * Pass custom arguments to the class constructor
+     *
+     * Note: This method MUST be implemented in such a way as to retain the immutability
+     * Note: This will disable the dependency injector
+     *
+     * @param array $args
+     * @return $this
+     */
+    public function addArgs(array $args): self;
+
+    /**
+     * Run the class with all dependencies.
+     *
+     * @return mixed
+     * @throws \ReflectionException
+     */
+    public function run(): mixed;
+}

Exceptions/ContainerException.php src/Exceptions/ContainerException.phpExceptions/ContainerException.php renamed to src/Exceptions/ContainerException.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace MaplePHP\Container\Interfaces;
+namespace Psr\Container;
 
 /**
  * Describes the interface of a container that exposes methods to read its entries.