Laravel + Transloadit

Build the integration

This controller validates an uploaded file, starts a fixed Template through the PHP SDK, and returns the Assembly status payload.

1. Install the PHP SDK and create a Transloadit Template.
2. Add the three environment values and map them in config/services.php.
3. Register a POST route for the controller and submit a multipart file field named file.

composer require transloadit/php-sdk

'transloadit' => [
    'key' => env('TRANSLOADIT_KEY'),
    'secret' => env('TRANSLOADIT_SECRET'),
    'template_id' => env('TRANSLOADIT_TEMPLATE_ID'),
],

<?php

namespace App\Http\Controllers;

use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use transloadit\Transloadit;

class MediaController extends Controller
{
    public function store(Request $request): JsonResponse
    {
        $validated = $request->validate([
            'file' => ['required', 'file', 'max:102400'],
        ]);

        $transloadit = new Transloadit([
            'key' => config('services.transloadit.key'),
            'secret' => config('services.transloadit.secret'),
        ]);

        $assembly = $transloadit->createAssembly([
            'files' => [$validated['file']->getRealPath()],
            'params' => [
                'template_id' => config('services.transloadit.template_id'),
            ],
        ]);

        return response()->json($assembly->data, 202);
    }
}

Authentication

• Store the Transloadit Auth Key, Auth Secret, and Template ID in Laravel environment configuration and read them through config/services.php.
• The official PHP SDK signs Assembly requests automatically when both the key and secret are supplied.
• Validate uploaded files and enforce your application’s authorization before sending a server-side file to Transloadit.

Limitations and operational notes

• createAssembly starts the Assembly but does not make long processing synchronous. Return the Assembly ID and use webhooks or status retrieval for completion.
• The example uploads through the Laravel server. For large browser uploads, use Uppy to send bytes directly to Transloadit and let Laravel only authorize signatures.
• Laravel’s public storage validation and your Transloadit Template limits are separate controls; configure both for the same product policy.