<span aria-hidden="true" id="php-sdk-"></span>

# PHP SDK

[transloadit/php-sdk](https://github.com/transloadit/php-sdk)

Mit unserem PHP SDK können Sie Datei-Uploads über die Transloadit REST API mit PHP automatisieren.

Die Installation erfolgt über Composer.

<span aria-hidden="true" id="user-content-php-sdk-install"></span>

<span aria-hidden="true" id="install"></span> <span aria-hidden="true" id="installation"></span>

## Installation

```bash
composer require transloadit/php-sdk

```

Halten Sie den Auth Key und das Auth Secret Ihres Transloadit-Kontos bereit. Diese Werte finden Sie auf der Seite [API-Zugangsdaten](/c/template-credentials/).

<span aria-hidden="true" id="user-content-php-sdk-usage"></span>

<span aria-hidden="true" id="usage"></span> <span aria-hidden="true" id="verwendung"></span>

## Verwendung

Führen Sie die folgenden PHP-Beispiele in vertrauenswürdigen serverseitigen Skripten aus. Bewahren Sie das Auth Secret auf Ihrem Server auf; autorisieren Sie Nutzer, bevor Sie ihnen erlauben, Uploads auszulösen oder Assembly-Ergebnisse anzufordern.

<span aria-hidden="true" id="user-content-php-sdk-1-upload-and-resize-an-image-from-your-server"></span>

<span aria-hidden="true" id="1-upload-and-resize-an-image-from-your-server"></span> <span aria-hidden="true" id="1-ein-bild-von-ihrem-server-hochladen-und-skalieren"></span>

### 1. Ein Bild von Ihrem Server hochladen und skalieren

Dieses Beispiel zeigt, wie Sie mit dem SDK auf Ihrem Server eine Assembly erstellen.

Es verwendet eine Beispielbilddatei, lädt sie zu Transloadit hoch und startet dafür einen Job zur Größenänderung.

```php
<?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,
      ],
    ],
  ],
]);

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

```

<span aria-hidden="true" id="user-content-php-sdk-2-create-a-simple-end-user-upload-form"></span>

<span aria-hidden="true" id="2-create-a-simple-end-user-upload-form"></span> <span aria-hidden="true" id="2-ein-einfaches-upload-formular-für-endnutzer-erstellen"></span>

### 2. Ein einfaches Upload-Formular für Endnutzer erstellen

Für Browser-Uploads folgen Sie der [Uppy-Integration](#3-use-uppy-for-file-uploads) unten. Dabei erfolgt die Signierung auf Ihrem Server, und Dateien werden direkt vom Browser zu Transloadit hochgeladen.

Für Benachrichtigungen über den Abschluss der Verarbeitung folgen Sie den Anweisungen zur Signaturprüfung in der [Dokumentation der Webhooks-API](/de/docs/api/webhooks.md). Eine Weiterleitung im Browser belegt nicht, dass eine Assembly abgeschlossen ist. `Transloadit::response()` parst eingehende Benachrichtigungsdaten, authentifiziert sie aber nicht. Das Erstellen einer Instanz von `Transloadit` mit einem Secret bewirkt nicht, dass diese statische Methode einen Webhook verifiziert.

<span aria-hidden="true" id="user-content-php-sdk-3-integrate-the-jquery-plugin-into-the-previous-example"></span>

<span aria-hidden="true" id="3-use-uppy-for-file-uploads"></span> <span aria-hidden="true" id="3-uppy-für-datei-uploads-verwenden"></span>

### 3. Uppy für Datei-Uploads verwenden

Wir empfehlen [Uppy](/de/docs/sdks/uppy.md) für Browser-Uploads. Beginnen Sie mit dem [zentralen Leitfaden zu Uppy und Transloadit](https://uppy.io/docs/guides/uppy-transloadit/) für die Einrichtung von Templates, serverseitige Signierung und frameworkspezifische Client-Beispiele.

Ihr PHP-Backend muss den Nutzer authentifizieren und den Upload autorisieren, bevor es kurzlebige Assembly-Optionen signiert. Wählen Sie das zulässige Template und die zulässigen Instructions auf dem Server aus. Signieren Sie keine beliebigen Parameter aus dem Browser. Unter [Signature Authentication](/de/docs/api/authentication.md) finden Sie das Signierungsprotokoll. Wie Sie Abschlussbenachrichtigungen verifizieren, erfahren Sie in der oben genannten Webhook-Dokumentation.

<span aria-hidden="true" id="user-content-php-sdk-4-fetch-the-assembly-status-json"></span>

<span aria-hidden="true" id="4-fetch-the-assembly-status-json"></span> <span aria-hidden="true" id="4-assembly-status-json-abrufen"></span>

### 4. Assembly Status JSON abrufen

Mit der Methode `getAssembly` können Sie den Status einer Assembly abrufen.

```php
<?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);

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

```

<span aria-hidden="true" id="user-content-php-sdk-5-create-an-assembly-with-a-template"></span>

<span aria-hidden="true" id="5-create-an-assembly-with-a-template"></span> <span aria-hidden="true" id="5-eine-assembly-mit-einem-template-erstellen"></span>

### 5. Eine Assembly mit einem Template erstellen.

Dieses Beispiel zeigt, wie Sie mit dem SDK eine Assembly mit Templates erstellen.

Erstellen Sie dazu im Dashboard Ihres Transloadit-Kontos ein Template und fügen Sie hier die Template-ID ein.

```php
<?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',
  ],
]);

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

```

<span aria-hidden="true" id="user-content-php-sdk-signature-auth"></span>

<span aria-hidden="true" id="signature-auth"></span>

### Signature Auth

Das PHP SDK signiert ausgehende API-Anfragen mit Ihrem konfigurierten Auth Secret mithilfe der Signature Authentication. Eingehende Webhooks erfordern eine separate Signaturprüfung, wie in der [Webhook-Dokumentation](/de/docs/api/webhooks.md) beschrieben.

<span aria-hidden="true" id="user-content-php-sdk-example"></span>

<span aria-hidden="true" id="example"></span> <span aria-hidden="true" id="beispiel"></span>

## Beispiel

Vollständig funktionsfähige Beispiele finden Sie unter [examples/](https://github.com/transloadit/php-sdk/tree/HEAD/examples).

<span aria-hidden="true" id="user-content-php-sdk-documentation"></span>

<span aria-hidden="true" id="documentation"></span> <span aria-hidden="true" id="dokumentation"></span>

## Dokumentation

Die vollständige Dokumentation finden Sie auf [GitHub](https://github.com/transloadit/php-sdk).
