README

A helper and facade for making internal sub requests to your application API.

By sending a sub request within the application, you can consume your application's API without sending separate, slower HTTP requests.

Requirements

• PHP 8.5+
• Laravel 13.x

Install

composer require myerscode/laravel-sub-request

The package will be auto-discovered by Laravel.

Usage

You can inject the Dispatcher into your class, use the SubRequest facade, or use the global subrequest helper.

use Myerscode\Laravel\SubRequest\Dispatcher;
use Myerscode\Laravel\SubRequest\SubRequest;

class MyController
{
    public function __construct(private readonly Dispatcher $subRequest) {}

    // Using dependency injection
    public function withInjection()
    {
        return $this->subRequest->post('/auth', ['foo' => 'bar']);
    }

    // Using the facade
    public function withFacade()
    {
        return SubRequest::dispatch('GET', '/details', ['foo' => 'bar']);
    }

    // Using the helper
    public function withHelper()
    {
        return subrequest('GET', '/details', ['foo' => 'bar']);
    }
}

Available Methods

The Dispatcher provides shortcut methods for all HTTP verbs:

$dispatcher->get('/url', $data);
$dispatcher->post('/url', $data);
$dispatcher->put('/url', $data);
$dispatcher->patch('/url', $data);
$dispatcher->delete('/url', $data);
$dispatcher->options('/url', $data);

Custom Headers

All methods accept an optional $headers array as the last parameter, allowing you to set custom headers on the sub request:

// Set Authorization and Accept headers
$dispatcher->get('/api/users', [], [
    'Authorization' => 'Bearer my-token',
    'Accept' => 'application/json',
]);

// Works with the facade and helper too
SubRequest::dispatch('GET', '/api/users', [], ['Authorization' => 'Bearer my-token']);
subrequest('GET', '/api/users', [], ['Authorization' => 'Bearer my-token']);

Headers are applied to the sub request and automatically restored to their original values after dispatch.

Cookies

All methods accept an optional $cookies array as the last parameter, allowing you to forward or set cookies on the sub request:

// Set cookies on the sub request
$dispatcher->get('/api/profile', [], [], [
    'session_id' => 'abc123',
    'token' => 'my-auth-token',
]);

// Combine headers and cookies
$dispatcher->post('/api/data', ['key' => 'value'], [
    'Accept' => 'application/json',
], [
    'session_id' => 'abc123',
]);

// Works with the facade and helper too
SubRequest::dispatch('GET', '/api/profile', [], [], ['session_id' => 'abc123']);
subrequest('GET', '/api/profile', [], [], ['session_id' => 'abc123']);

Cookies are applied to the sub request and automatically restored to their original values after dispatch.

Middleware Control

Use withoutMiddleware() to skip specific middleware on a sub request:

use App\Http\Middleware\Authenticate;
use App\Http\Middleware\RateLimiter;

// Skip a single middleware
$dispatcher->withoutMiddleware(Authenticate::class)->get('/api/internal');

// Skip multiple middleware by chaining
$dispatcher
    ->withoutMiddleware(Authenticate::class)
    ->withoutMiddleware(RateLimiter::class)
    ->post('/api/internal', $data);

// Or pass an array
$dispatcher->withoutMiddleware([Authenticate::class, RateLimiter::class])->get('/api/internal');

The middleware exclusion is automatically reset after each dispatch, so subsequent calls will run all middleware as normal.

License

MIT