init

Author: mohamed-samir907

.gitignore

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

README.md

@@ -0,0 +1,43 @@
+# HackPHP Container
+HackPHP dependency injection container.
+
+## Installation
+```sh
+composer require hackphp/container
+```
+
+## Usage
+```php
+
+use Hackphp\Container\Container;
+
+$container = Container::getInstance();
+
+// bind class to the container by key = class name 
+$container->bind(ApiHandler::class, fn () => new ApiHandler("123"));
+
+// bind by key = interface.
+$conainer->bind(ApiInterface::class, TestApi::class);
+
+// bind by key = string
+$container->bind("api", fn () => new Api);
+
+// bind singleton
+$container->singleton(ApiInterface::class, fn () => new ApiHandler("123"));
+
+// bind class without instructuions
+$container->bind(TestApi::class);
+$container->singleton(TestApi::class);
+
+// pass the object instead of closure or string
+$apiHandler = new ApiHandler("123");
+$container->instance(ApiInterface::class, $apiHandler);
+
+// resolve binding
+$container->make("api"); // use string key
+$container->make(ApiInterface::class);
+
+// PSR-11
+$container->get("api");
+$container->has("api") // bool
+```

composer.json

@@ -0,0 +1,32 @@
+{
+    "name": "hackphp/container",
+    "description": "HackPHP PSR-11 compatible container",
+    "type": "library",
+    "authors": [
+        {
+            "name": "Mohamed Samir",
+            "email": "gm.mohamedsamir@gmail.com"
+        }
+    ],
+    "require": {
+        "psr/container": "2.0.x-dev"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "9.5.x-dev"
+    },
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "Hackphp\\Container\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Hackphp\\Tests\\Container\\": "tests/"
+        }
+    },
+    "minimum-stability": "dev",
+    "scripts": {
+        "test": "./vendor/bin/phpunit --do-not-cache-result"
+    }
+}

phpunit.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<phpunit
+    bootstrap = "vendor/autoload.php"
+    backupGlobals = "false"
+    backupStaticAttributes = "false"
+    colors = "true"
+    convertErrorsToExceptions = "true"
+    convertNoticesToExceptions = "true"
+    convertWarningsToExceptions = "true"
+    processIsolation = "false"
+    stopOnFailure = "false">
+
+    <testsuites>
+        <testsuite name="Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+
+    <php>
+        <env name="APP_ENV" value="testing"/>
+    </php>
+
+</phpunit>

src/Autowire.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace Hackphp\Container;
+
+use ReflectionClass;
+use ReflectionNamedType;
+
+class Autowire
+{
+    /**
+     * @var ReflectionClass
+     */
+    private ReflectionClass $class;
+
+    /**
+     * Create new Autowire.
+     *
+     * @param string $className
+     */
+    public function __construct($className)
+    {
+        $this->class = new ReflectionClass($className);
+    }
+
+    /**
+     * Check if the class constructor has the given paramter.
+     *
+     * @param  string $paramName
+     * @return bool
+     */
+    public function constructHasType($typeName): bool
+    {
+        $constructor = $this->class->getConstructor();
+
+        if (is_null($constructor)) {
+            return false;
+        }
+
+        foreach ($constructor->getParameters() as $param) {
+            $type = $param->getType();
+
+            if (!$type instanceof ReflectionNamedType) {
+                continue;
+            }
+
+            if ($typeName == $type->getName()) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}

src/Container.php

@@ -0,0 +1,127 @@
+<?php
+
+namespace Hackphp\Container;
+
+use Closure;
+use Psr\Container\ContainerInterface;
+
+class Container implements ContainerInterface
+{
+    use Resolver;
+
+    /**
+     * Container instance.
+     *
+     * @var static
+     */
+    protected static $instance;
+
+    /**
+     * The binded services.
+     *
+     * @var array
+     */
+    protected array $bindings = [];
+
+    /**
+     * The shared services.
+     *
+     * @var array
+     */
+    protected array $instances = [];
+
+    /**
+     * Enable/Disable autowiring.
+     *
+     * @var bool
+     */
+    protected bool $autowiring = true;
+
+    /**
+     * Prevent create new instance.
+     */
+    private function __construct()
+    {
+    }
+
+    /**
+     * Get the Container instance.
+     *
+     * @return static
+     */
+    public static function getInstance(): self
+    {
+        if (is_null(static::$instance)) {
+            static::$instance = new static();
+        }
+
+        return static::$instance;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function get(string $id)
+    {
+        return $this->make($id);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function has(string $id): bool
+    {
+        return isset($this->bindings[$id]) || isset($this->instances[$id]);
+    }
+
+    /**
+     * Bind entry to the container.
+     *
+     * @param  string $name
+     * @param  Closure|string|null $entry
+     * @param  bool $shared
+     * @return void
+     */
+    public function bind(string $name, $entry = null, bool $shared = false): void
+    {
+        $this->bindings[$name] = [
+            "entry" => $entry,
+            "shared" => $shared
+        ];
+    }
+
+    /**
+     * Buind entry to the container as singleton.
+     *
+     * @param  string $name
+     * @param  Closure|string|null $entry
+     * @return void
+     */
+    public function singleton(string $name, $entry = null): void
+    {
+        $this->bind($name, $entry, true);
+    }
+
+    /**
+     * Bind entry to the container shared instances.
+     *
+     * @param  string $name
+     * @param  mixed $entry
+     * @return void
+     */
+    public function instance(string $name, $entry): void
+    {
+        $this->instances[$name] = $entry;
+    }
+
+    /**
+     * Get the entry from the container.
+     *
+     * @param  string $name
+     * @return mixed
+     */
+    public function make(string $name)
+    {
+        return $this->resolve($name);
+    }
+}

src/Exceptions/BindingException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Hackphp\Container\Exceptions;
+
+use Exception;
+
+class BindingException extends Exception
+{
+}