SDK de PHP

Nuestro SDK de PHP te permite automatizar la subida de archivos mediante la REST API de Transloadit usando PHP.

Puedes instalarlo mediante Composer.

Instalación

composer require transloadit/php-sdk

Ten a mano la Auth Key y el Auth Secret de tu cuenta de Transloadit. Puedes consultar la página de credenciales de API para obtener estos valores.

Uso

Ejecuta los siguientes ejemplos de PHP en scripts de confianza del lado del servidor. Mantén el Auth Secret en tu servidor; autoriza a los usuarios antes de permitirles iniciar subidas o solicitar resultados de Assemblies.

1. Sube una imagen desde tu servidor y cambia su tamaño

Este ejemplo muestra cómo puedes usar el SDK para crear una Assembly en tu servidor.

El ejemplo toma un archivo de imagen de muestra, lo sube a Transloadit e inicia un Job para cambiar su tamaño.

<?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. Crea un formulario sencillo de subida para usuarios finales

Para las subidas desde el navegador, sigue la integración con Uppy que aparece más abajo. Esta integración mantiene el proceso de firma en tu servidor y sube los archivos directamente desde el navegador a Transloadit.

Para las notificaciones de finalización del procesamiento, sigue las instrucciones de verificación de firmas de la documentación de la API de webhooks. Una redirección del navegador no demuestra que una Assembly haya finalizado. Transloadit::response() analiza los datos de las notificaciones entrantes; no los autentica. Crear una instancia de Transloadit con un secreto no hace que ese método estático verifique un webhook.

3. Usa Uppy para subir archivos

Recomendamos Uppy para subir archivos desde el navegador. Empieza por la guía de referencia de Uppy y Transloadit⁠ para configurar Templates, firmar en el servidor y consultar ejemplos de cliente específicos para cada framework.

Tu backend de PHP debe autenticar al usuario y autorizar la subida antes de firmar opciones de vigencia breve para la Assembly. Elige en el servidor el Template y las Instructions permitidos. No firmes parámetros arbitrarios procedentes del navegador. Consulta Signature Authentication para conocer el protocolo de firma y la documentación de webhooks anterior para verificar las notificaciones de finalización.

4. Obtén el Assembly Status JSON

Puedes usar el método getAssembly para obtener el estado de la Assembly.

<?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. Crea una Assembly con un Template.

Este ejemplo muestra cómo puedes usar el SDK para crear una Assembly con Templates.

Debes crear un Template en el panel de tu cuenta de Transloadit y añadir aquí el ID del Template.

<?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

El SDK de PHP firma las solicitudes salientes a la API con tu Auth Secret configurado mediante Signature Authentication. Los webhooks entrantes requieren una verificación de firma independiente, como se describe en la documentación de webhooks.

Ejemplo

Para consultar ejemplos completamente funcionales, revisa examples/⁠.

Documentación

Consulta GitHub⁠ para acceder a la documentación completa.