Transloadit
料金
  • ファイルアップロード
  • ファイルインポート
  • バッチ処理
  • 動画エンコーディング
  • 音声エンコーディング
  • 画像処理
  • ドキュメント処理
  • 人工知能
  • ファイルフィルタリングとセキュリティ
  • メディアカタログ化
  • ファイル圧縮
  • コード評価
  • ファイルエクスポート
  • Smart CDN
  • すべてのサービスを表示
  • 連携機能を見る
  • 実行可能なデモを試す (English)
  • Uppy
  • TransloaditKit
  • Android 用 SDK
  • Node.js 用 SDK
  • Next.js 用ビューアー
  • Python 用 SDK
  • Ruby 用 SDK
  • Go 用 SDK
  • Java 用 SDK
  • PHP 用 SDK
  • Zapier
  • MCP サーバー
  • Transloadit CLI
  • Terraform
  • 基本事項
  • ベストプラクティス
  • よくある質問
  • Robot
  • API
  • 形式
  • 初めてのアプリ開発
  • 会社概要
  • 比較
  • オープンソース
  • お客様の声
  • 採用情報 (English)
  • セキュリティ
  • 記事
  • 開発者ニュース (English)
  • 開発のヒント
  • プレス
  • 研究 (English)
  • 導入事例
  • ソリューション
  • ガイド (English)
  • 用語集
  • 法務 (English)
  • ツール
  • 世界中の数百万人に教育を届ける Coursera を支援
  • Transloadit サポート
  • オープンソースサポート
  • サービスレベル契約 (English)
  • エンジニアによるデモを予約 (English)
基本事項Robotよくある質問API形式ベストプラクティス
はじめに
  • 概要
  • はじめてのアプリ
  • 処理結果ファイルの保存
トピック
  • Assembly Instructions
  • Assembly Variable
  • 動的評価
  • Template
  • Webhook
  • サードパーティ認証情報
  • Builtin Template
  • リサイズ方式
  • Assembly Execution Progress
  • Workspace
  • AI エージェント
  • use パラメーターの高度な設定
  • ignore_errors パラメーター
ソフトウェア開発キット
  • 概要
  • Android SDK
  • ブラウザー
  • Convex
  • cURL
  • Go SDK
  • Java SDK
  • MCP Server
  • マルチパートフォーム
  • Node.js SDK
  • Next.js 向け Viewer
  • PHP SDK
  • Python SDK
  • Ruby SDK
  • Terraform
  • TransloaditKit
  • Zapier 連携
移行
  • 移行ガイド
  • Cloudinary から Transloadit への移行
  • Uploadcare から Transloadit への移行
  • Mux から Transloadit への移行
  • Filestack から Transloadit への移行

PHP SDK

transloadit/php-sdk⁠

この PHP SDK を使うと、PHP から Transloadit の REST API を通じたファイルアップロードを自動化できます。

Composer でインストールできます。

インストール

composer require transloadit/php-sdk

Transloadit アカウントの Auth Key と Auth Secret を手元に用意してください。これらの値は API 認証情報ページで確認できます。

使い方

以下の PHP サンプルは、信頼できるサーバー側スクリプトで実行してください。Auth Secret はサーバー上で保持してください。ユーザーがアップロードを開始したり、Assembly の結果をリクエストしたりできるようにする前に、認可を行ってください。

1. サーバーから画像をアップロードしてリサイズ

このサンプルでは、SDK を使ってサーバー上で Assembly を作成する方法を示します。

サンプルの画像ファイルを Transloadit にアップロードし、リサイズ処理を開始します。

<?php
require 'vendor/autoload.php';

use transloadit\Transloadit;

$transloadit = new Transloadit([
  'key' => 'YOUR_TRANSLOADIT_KEY',
  'secret' => getenv('TRANSLOADIT_SECRET'),
]);

$response = $transloadit->createAssembly([
  'files' => ['/PATH/TO/FILE.jpg'],
  'params' => [
    'steps' => [
      'resize' => [
        'robot' => '/image/resize',
        'width' => 200,
        'height' => 100,
      ],
    ],
  ],
]);

if ($response->error()) {
  throw new \RuntimeException($response->data['error'] ?? 'REQUEST_FAILED');
}

// Show the results of the assembly we spawned
echo '<pre>';
print_r($response);
echo '</pre>';

2. エンドユーザー向けのシンプルなアップロードフォームの作成

ブラウザーからのアップロードには、以下の Uppy 連携を参照してください。署名処理はサーバー上で行い、ファイルはブラウザーから Transloadit に直接アップロードします。

処理完了の通知については、Webhooks API ドキュメントの署名検証の手順に従ってください。ブラウザーのリダイレクトは、Assembly の完了を証明するものではありません。Transloadit::response() は受信した通知データを解析しますが、認証は行いません。シークレットを指定して Transloadit のインスタンスを作成しても、その静的メソッドが Webhook を検証するようにはなりません。

3. Uppy によるファイルアップロード

ブラウザーからのアップロードには Uppy を推奨します。まずは Uppy と Transloadit の標準ガイド⁠で、Template の設定、サーバー側での署名、フレームワーク別のクライアントサンプルを確認してください。

PHP バックエンドでは、有効期間の短い Assembly オプションに署名する前に、ユーザーの認証とアップロードの認可を行う必要があります。許可する Template と Assembly Instructions はサーバー上で選択してください。ブラウザーから送られた任意のパラメーターに署名しないでください。署名プロトコルについては Signature Authenticationを、完了通知の検証については前述の Webhook ドキュメントを参照してください。

4. Assembly Status JSON の取得

getAssembly メソッドを使うと、Assembly のステータスを取得できます。

<?php
require 'vendor/autoload.php';

use transloadit\Transloadit;

$assemblyId = 'YOUR_ASSEMBLY_ID';

$transloadit = new Transloadit([
  'key' => 'YOUR_TRANSLOADIT_KEY',
  'secret' => getenv('TRANSLOADIT_SECRET'),
]);

$response = $transloadit->getAssembly($assemblyId);
if ($response->error()) {
  throw new \RuntimeException($response->data['error'] ?? 'REQUEST_FAILED');
}

echo '<pre>';
print_r($response);
echo '</pre>';

5. Template を使った Assembly の作成

このサンプルでは、SDK で Assembly を Template を使って作成する方法を示します。

事前に Transloadit アカウントのダッシュボードで Template を作成し、その Template ID をここに追加する必要があります。

<?php
require 'vendor/autoload.php';

use transloadit\Transloadit;

$transloadit = new Transloadit([
  'key' => 'YOUR_TRANSLOADIT_KEY',
  'secret' => getenv('TRANSLOADIT_SECRET'),
]);

$response = $transloadit->createAssembly([
  'files' => ['/PATH/TO/FILE.jpg'],
  'params' => [
    'template_id' => 'YOUR_TEMPLATE_ID',
  ],
]);

if ($response->error()) {
  throw new \RuntimeException($response->data['error'] ?? 'REQUEST_FAILED');
}

// Show the results of the assembly we spawned
echo '<pre>';
print_r($response);
echo '</pre>';

署名認証

PHP SDK は、Signature Authentication により、設定済みの Auth Secret を使って送信 API リクエストに署名します。受信する Webhook には、Webhook ドキュメントで説明しているとおり、別途署名検証が必要です。

サンプル

そのまま動作するサンプルは、examples/⁠を参照してください。

ドキュメント

完全なドキュメントは GitHub⁠ を参照してください。

前のページ ← Next.js 向け Viewer次のページ Python SDK →
サポートに問い合わせる
Transloadit稼働状況を確認中…

製品

  • サービス
  • 料金
  • デモ EN (English)
  • ツール
  • セキュリティ
  • サポート

会社

  • 会社概要/プレス
  • ブログ/採用情報 EN (English)
  • 比較/コンプライアンス対応表
  • 研究 EN (English)
  • オープンソース
  • ソリューション
  • ウェブの先駆者たち

ドキュメント

  • はじめに
  • トランスコーディング
  • よくある質問
  • API
  • ガイド EN (English)/開発のヒント
  • 対応フォーマット

その他

  • プラットフォームの稼働状況⁠
  • コミュニティフォーラム⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®、tus®、Uppy® は、米国における Transloadit-II GmbH の登録商標です。

プライバシー EN (English)利用規約 EN (English)運営者情報 EN (English)商標 EN (English)DMCA ポリシー EN (English)
EnglishDeutschEspañolFrançaisPortuguês (Brasil)日本語