Laravel と Transloadit
公式 PHP SDK とサーバー側の認証情報を使い、Laravel で検証済みのアップロードファイルを固定の Transloadit Template に送信してください。
実行可能な処理設定
連携を構築
このコントローラーは、アップロードされたファイルを検証し、PHP SDK 経由で固定の Template を実行して、その Assembly ID または機密情報を除去したエラーを返します。
- PHP SDK をインストールし、Transloadit の Template を作成します。
- 三つの環境変数の値を追加し、config/services.php で対応付けてください。
- コントローラーの POST ルートを登録し、file という名前のマルチパートファイルフィールドを送信してください。
インストール
composer require transloadit/php-sdkconfig/services.php
'transloadit' => [
'key' => env('TRANSLOADIT_KEY'),
'secret' => env('TRANSLOADIT_SECRET'),
'template_id' => env('TRANSLOADIT_TEMPLATE_ID'),
],app/Http/Controllers/MediaController.php
<?php
namespace App\Http\Controllers;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
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'),
],
]);
$hasSdkError = (bool) $assembly->error();
if ($hasSdkError || !isset($assembly->data['assembly_id'])) {
// Provider responses may contain secrets; log only a fixed failure category.
Log::warning('Transloadit Assembly creation failed', [
'reason' => $hasSdkError ? 'sdk_error' : 'missing_assembly_id',
]);
return response()->json(['error' => 'Could not start media processing'], 502);
}
return response()->json(['assembly_id' => $assembly->data['assembly_id']], 202);
}
}認証
- Transloadit の Auth Key、Auth Secret、Template ID を Laravel の環境設定に保存し、config/services.php を通じて読み込みます。
- 公式 PHP SDK は、キーとシークレットの両方が指定されている場合、Assemblyリクエストに自動で署名します。
- サーバー側のファイルを Transloadit に送信する前に、アップロードされたファイルを検証し、アプリケーションの認可を適用してください。
制限事項と運用上の注意点
- createAssembly は Assembly を開始しますが、長時間の処理を同期処理にするものではありません。Assembly ID を返し、Webhook またはステータス取得で完了を確認してください。
- この例では Laravel サーバー経由でアップロードします。ブラウザーから大容量ファイルをアップロードする場合は、Uppy を使って Transloadit にデータを直接送信し、Laravel では署名の認可のみを行ってください。
- Laravel のファイル検証と Transloadit Template の制限は別々の制御です。同じプロダクトポリシーに沿って両方を設定してください。
その他の連携