# PHP SDK
[transloadit/php-sdk](https://github.com/transloadit/php-sdk)
Our PHP SDK allows you to automate the uploading of files through the TransloaditREST API using PHP.
It can be installed via Composer.
## Install
```
composer require transloadit/php-sdk
```
Keep your Transloadit account's Auth Key & Secret nearby. You can check the[API credentials](/c/credentials/) page for these values.
## Usage
### 1. Upload and resize an image from your server
This example demonstrates how you can use the SDK to create an Assembly on your server.
It takes a sample image file, uploads it to Transloadit, and starts a resizing job on it.
```php
'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 '
';
print_r($response);
echo '
';
```
### 2. Create a simple end-user upload form
This example shows you how to create a simple Transloadit upload form that redirects back to your site after the upload is done.
Once the script receives the redirect request, the current status for this Assembly is shown using `Transloadit::response()`.
**Note**
There is no guarantee that the Assembly has already finished executing by the time the `$response` is fetched. You should use the `notify_url` parameter for this.
```php
'YOUR_TRANSLOADIT_KEY',
'secret' => 'YOUR_TRANSLOADIT_SECRET',
]);
// Check if this request is a Transloadit redirect_url notification.
// If so fetch the response and output the current assembly status:
$response = Transloadit::response();
if ($response) {
echo '
Assembly Status:
';
echo '
';
print_r($response);
echo '
';
exit();
}
// This should work on most environments, but you might have to modify
// this for your particular setup.
$redirectUrl = sprintf('http://%s%s', $_SERVER['HTTP_HOST'], $_SERVER['REQUEST_URI']);
// Setup a simple file upload form that resizes an image to 200x100px
echo $transloadit->createAssemblyForm([
'params' => [
'steps' => [
'resize' => [
'robot' => '/image/resize',
'width' => 200,
'height' => 100,
],
],
'redirect_url' => $redirectUrl,
],
]);
?>
Pick an image to resize
```
### 3. Use Uppy for file uploads
We recommend using [Uppy](/docs/sdks/uppy.md), our next-gen file uploader for the web.
1. Include Uppy in your page:
```html
```
1. Initialize Uppy with the Transloadit plugin:
```html
```
1. Handle notifications on your PHP backend:
```php
'YOUR_TRANSLOADIT_KEY',
'secret' => 'YOUR_TRANSLOADIT_SECRET',
]);
$response = Transloadit::response();
if ($response) {
http_response_code(200);
echo 'OK';
return;
}
http_response_code(400);
echo 'Bad Request';
```
### 4. Fetch the Assembly Status JSON
You can use the `getAssembly` method to get the Assembly Status.
```php
'YOUR_TRANSLOADIT_KEY',
'secret' => 'YOUR_TRANSLOADIT_SECRET',
]);
$response = $transloadit->getAssembly($assemblyId);
echo '
';
print_r($response);
echo '
';
```
### 5. Create an Assembly with a Template.
This example demonstrates how you can use the SDK to create an Assembly withTemplates.
You are expected to create a Template on your Transloadit account dashboard and add theTemplate ID here.
```php
'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 '
';
print_r($response);
echo '
';
```
### Signature Auth
Signature Authentication is done by the PHP SDK by default internally so you do not need to worry about this :)
## Example
For fully working examples take a look at[examples/](https://github.com/transloadit/php-sdk/tree/HEAD/examples).
## Documentation
See [GitHub](https://github.com/transloadit/php-sdk) for the full documentation.