Laravel micro framework for SRP (Single Responsibility Principle)

1.0.0 2023-07-16 23:00 UTC

This package is auto-updated.

Last update: 2024-03-26 22:55:47 UTC



Photon is a lightweight extension framework for Laravel that implements the Single Responsibility Principle (SRP) design pattern. It draws inspiration from the Lucid Framework.

How to Use

To use Photon in your Laravel project, follow these steps:

  1. Open your terminal and execute the following command:
composer require moeen-basra/photon
  1. Open the App\Http\Controllers\Controller class and replace the following code:
use Illuminate\Routing\Controller as BaseController;


use MoeenBasra\Photon\Http\Controller as BaseController;
  1. Extend the app\Exceptions\Handler class with the following class:

Alternatively, you can use the following traits in your existing exception handler:

use MoeenBasra\Photon\Concerns\Marshal;
use MoeenBasra\Photon\Concerns\ActionRunner;

In the render method, execute the following job if the request accepts application\json:

$message = $exception->getMessage();
$code = $exception->getCode();
$errors = ($exception instanceof \Illuminate\Validation\ValidationException) ? $exception->errors() : [];

if ($request->expectsJson()) {
    return $this->run(JsonErrorResponseJob::class, [
        'message' => $message,
        'errors' => $errors,
        'status' => ($code < 100 || $code >= 600) ? 400 : $code,
  1. Create the following directories inside the app folder:
|-- app
|  |-- Actions
|  |-- Features
|  |-- Operations
  1. Here's an example code for a controller that serves the feature:
namespace App\Http\Controllers\Api\Auth;

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

class AuthController extends Controller
    public function __construct()
        $this->middleware('auth:api', ['only' => ['me', 'logout']]);

    public function register(Request $request): JsonResponse
        return $this->serve(RegisterFeature::class, [
            'data' => $request->validated(),
  1. Lastly, here's an example code for a feature that runs the job:
namespace App\Features\Api\Auth;

use App\Operations\Auth\RegisterOperation;
use Illuminate\Http\JsonResponse;
use Photon\Actions\JsonResponseAction;
use MoeenBasra\Photon\Features\Feature;

final class RegisterFeature extends Feature
    public function __construct(
        readonly private array $input
    public function handle(): JsonResponse
        $data = $this->run(RegisterOperation::class, [
            'input' => $this->input

        return $this->run(new JsonResponseAction($data));


Photon is released under the MIT License. See the LICENSE file for details.


You can reach me here