small / clean-application
This project is a set of class to manage dependency injection of application's part of a clean architecture app, independently of the framework used.
Requires
- php: 8.3.*
- small/collection: >=2.2.0
Requires (Dev)
- pestphp/pest: 2.34.*
- phpstan/phpstan: *
README
<<<<<<< Updated upstream
>>>>>>> Stashed changes
Small Clean Application
This project is a set of class to manage dependency injection of application's part of a clean architecture app, independently of the framework used.
Install
composer require small/clean-application
Parameters
Parameters are managed to automatically inject them in UseCase constructor.
You can set parameters through the facade static object :
\Small\CleanApplication\Facade::setParameter('test', [
'host' => 'http://clean.com',
'port' => 80
]);
You can also get them through the facade :
echo \Small\CleanApplication\Facade::getParameter('test.host');
Output :
http://clean.com
UseCase class
Simple case
A use case is a class materialization of use case that implement Small\CleanApplication\Contract\UseCaseInterface.
For example, here is simply use case that return a string :
<?php
namespace Small\CleanApplication\Test\Feature\Fixture\UseCase;
use Small\CleanApplication\Test\Feature\Fixture\Interface\TestResponseInterface;
class TestUseCase implements \Small\CleanApplication\Contract\UseCaseInterface
{
public function execute($request): TestResponseInterface
{
return new TestResponse('a');
}
}
You can use it using facade :
use Small\CleanApplication\Test\Feature\Fixture\UseCase\TestUseCase;
use \Small\CleanApplication\Test\Feature\Fixture\UseCase\TestRequest;
echo \Small\CleanApplication\Facade::execute(TestUseCase::class, new TestRequest());
Output :
a
Injecting another use case in your use case
You can inject another use case in the use case constructor :
<?php
namespace Small\CleanApplication\Test\Feature\Fixture\UseCase;
use Small\CleanApplication\Contract\UseCaseInterface;
use Small\CleanApplication\Test\Feature\Fixture\Interface\TestDependencyRequestInterface;
use Small\CleanApplication\Test\Feature\Fixture\Interface\TestDependencyResponseInterface;
class TestDependencyUseCase implements UseCaseInterface
{
public function __construct(
protected TestUseCase $testUseCase,
) {}
public function execute($request): TestDependencyResponseInterface
{
return new TestDependencyResponse(
$request->getBefore() . $this->testUseCase->execute($request)->getStatus()
);
}
}
The property testUseCase will automatically be created as TestUseCase object.
Injecting parameters in your use case
You can inject parameters in your use case by typing and naming property in your use case constructor :
<?php
namespace Small\CleanApplication\Test\Feature\Fixture\UseCase;
use Small\CleanApplication\Contract\UseCaseInterface;
use Small\CleanApplication\Test\Feature\Fixture\Interface\TestDependencyRequestInterface;
use Small\CleanApplication\Test\Feature\Fixture\Interface\TestDependencyResponseInterface;
class TestDependencyParamUseCase implements UseCaseInterface
{
public function __construct(
protected string $testUseCase_param,
protected TestUseCase $testUseCase,
) {}
public function execute($request): TestDependencyResponseInterface
{
if (!$request instanceof TestDependencyRequestInterface) {
throw new \Exception('Bad request');
}
return new TestDependencyResponse(
$this->testUseCase_param . $request->getBefore() . $this->testUseCase->execute($request)->getStatus()
);
}
}
The underscrore ('_') separate array keys of parameters structure. Here is an example matching with the $testUseCase_param :
\Small\CleanApplication\Facade::setParameter('testUseCase', ['param' => 'p']);
Interfaces
Three interface structure your code :
- Small\CleanApplication\Contract\UseCaseInterface : All your use cases must implement this interface
- Small\CleanApplication\Contract\Request : All your use case requests must implement this interface
- Small\CleanApplication\Contract\Response : All your use case response must implement this interface
Here's our TestDependency example request class :
<?php
namespace Small\CleanApplication\Test\Feature\Fixture\UseCase;
use Small\CleanApplication\Test\Feature\Fixture\Interface\TestDependencyRequestInterface;
readonly class TestDependencyRequest implements TestDependencyRequestInterface
{
public function __construct(
protected string $before,
) {}
public function getBefore(): string
{
return $this->before;
}
}
And his interface :
<?php
namespace Small\CleanApplication\Test\Feature\Fixture\Interface;
use Small\CleanApplication\Contract\RequestInterface;
interface TestDependencyRequestInterface extends RequestInterface
{
public function getBefore(): string;
}
And here is the response implementation :
<?php
namespace Small\CleanApplication\Test\Feature\Fixture\UseCase;
use Small\CleanApplication\Test\Feature\Fixture\Interface\TestDependencyResponseInterface;
readonly class TestDependencyResponse implements TestDependencyResponseInterface
{
public function __construct(
protected string $status,
) {}
public function getStatus(): string
{
return $this->status;
}
}
And his interface :
<?php
namespace Small\CleanApplication\Test\Feature\Fixture\Interface;
use Small\CleanApplication\Contract\ResponseInterface;
interface TestDependencyResponseInterface extends ResponseInterface
{
public function getStatus(): string;
}
Copyright
This project is under MIT license