moeen-basra/photon

Lumen Extension for SRP (Single Responsibility Principle)

Photon

An Extension to Laravel with SRP Design Pattern., _(*1)

How to use

install the package using the following command, _(*2)

composer require moeen-basra/photon

Open the file public/index.php, _(*3)

Replace the following code, _(*4)

$response = $kernel->handle(
    $request = Illuminate\Http\Request::capture()
);

with, _(*5)

$app->alias('request', \Photon\Foundation\Http\Request::class);

$response = $kernel->handle(
    $request = \Photon\Foundation\Http\Request::capture()
);

Open the class App\Http\Controllers\Controller and replace the following code, _(*6)

use Illuminate\Routing\Controller as BaseController;, _(*7)

with, _(*8)

use Photon\Foundation\Controller as BaseController;, _(*9)

Finally you can extends the app\Exceptions\Handler with the following class, _(*10)

\Photon\Foundation\Exceptions\Handler\Handler, _(*11)

or use the following traits in your existing exception handler, _(*12)

use Photon\Foundation\Traits\MarshalTrait;
use Photon\Foundation\Traits\JobDispatcherTrait;

and in the render method run the following job if request accepts application\json, _(*13)

$message = $exception->getMessage();
$class = get_class($exception);
$code = $exception->getCode();

if ($request->expectsJson()) {
    return $this->run(JsonErrorResponseJob::class, [
        'message' => $message,
        'code' => $class,
        'status' => ($code < 100 || $code >= 600) ? 400 : $code,
    ]);
}

Now you can create the following directories in the app folder., _(*14)

|-- app
|  |-- Domains
|  |-- Features
|  |-- Operations

Here is a sample code for a controller serving the feature., _(*15)

namespace App\Http\Controllers\Api\Auth;

use Illuminate\Http\JsonResponse;
use Photon\Foundation\Controller;
use App\Features\Api\Auth\RegisterFeature;

class AuthController extends Controller
{

    public function __construct()
    {
        $this->middleware('auth:api', ['only' => 'me', 'logout', 'refresh']);
    }

    /**
     * Register user
     *
     * @return JsonResponse
     */
    public function register(): JsonResponse
    {
        return $this->serve(RegisterFeature::class);
    }
}

Here is sample code for Feature running the job, _(*16)

namespace App\Features\Api\Auth;

use Photon\Foundation\Feature;
use App\Operations\Auth\RegisterOperation;
use Photon\Domains\Http\Jobs\JsonResponseJob;
use App\Domains\Auth\Jobs\Register\ValidateRegisterRequestJob;

class RegisterFeature extends Feature
{
    public function handle()
    {
        $input = $this->run(ValidateRegisterRequestJob::class);

        $data = $this->run(RegisterOperation::class, compact('input'));

        return $this->run(new JsonResponseJob($data));
    }
}