SDK para PHP

Nosso SDK para PHP permite automatizar o upload de arquivos pela REST API da Transloadit usando PHP.

Ele pode ser instalado via Composer.

Instalar

composer require transloadit/php-sdk

Tenha à mão a Auth Key & o Auth Secret da sua conta na Transloadit. Você pode consultar a página de credenciais da API para encontrar esses valores.

Uso

Execute os exemplos PHP abaixo em scripts confiáveis executados no servidor. Mantenha o Auth Secret no seu servidor; autorize os usuários antes de permitir que eles iniciem uploads ou solicitem resultados de Assemblies.

1. Fazer upload e redimensionar uma imagem a partir do seu servidor

Este exemplo mostra como usar o SDK para criar uma Assembly no seu servidor.

Ele usa um arquivo de imagem de exemplo, faz upload dele para a Transloadit e inicia um Job de redimensionamento da imagem.

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

use transloadit\Transloadit;

$transloadit = new Transloadit([
  'key' => 'YOUR_TRANSLOADIT_KEY',
  'secret' => 'YOUR_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>';

2. Criar um formulário de upload simples para o usuário final

Para uploads pelo navegador, siga a integração com o Uppy abaixo. Ela mantém a assinatura no seu servidor e faz upload dos arquivos diretamente do navegador para a Transloadit.

Para notificações de conclusão do processamento, siga as instruções de verificação de assinatura na documentação da API de webhooks. Um redirecionamento no navegador não comprova que uma Assembly foi concluída. Transloadit::response() interpreta os dados das notificações recebidas; não os autentica. Criar uma instância de Transloadit com um valor secreto não faz com que esse método estático verifique um webhook.

3. Usar o Uppy para uploads de arquivos

Recomendamos o Uppy para uploads pelo navegador. Comece pelo guia canônico do Uppy e da Transloadit⁠ para configurar Templates, implementar a assinatura no servidor e consultar exemplos de cliente específicos para cada framework.

Seu backend PHP deve autenticar o usuário e autorizar o upload antes de assinar opções de Assembly com validade curta. Escolha no servidor o Template e as Instructions permitidos. Não assine parâmetros arbitrários vindos do navegador. Consulte Signature Authentication para conhecer o protocolo de assinatura e a documentação de webhooks acima para verificar as notificações de conclusão.

4. Obter o Assembly Status JSON

Você pode usar o método getAssembly para obter o Assembly Status.

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

use transloadit\Transloadit;

$assemblyId = 'YOUR_ASSEMBLY_ID';

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

$response = $transloadit->getAssembly($assemblyId);

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

5. Criar uma Assembly com um Template.

Este exemplo mostra como usar o SDK para criar uma Assembly com Templates.

Você deve criar um Template no painel da sua conta na Transloadit e adicionar o Template ID aqui.

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

use transloadit\Transloadit;

$transloadit = new Transloadit([
  'key' => 'YOUR_TRANSLOADIT_KEY',
  'secret' => 'YOUR_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>';

Signature Auth

O SDK para PHP assina as requisições de API enviadas com o Auth Secret configurado, usando Signature Authentication. Os webhooks recebidos exigem uma verificação de assinatura separada, conforme descrito na documentação de webhooks.

Exemplo

Para exemplos totalmente funcionais, consulte examples/⁠.

Documentação

Consulte o GitHub⁠ para acessar a documentação completa.