PHP integration

1
composer require fileboy/fileboy

1
2
3
4
5
6
7
8
use Fileboy\Client;

$fileboy = new Client(publicKey: getenv('FILEBOY_PUBLIC_KEY'));

$file = $fileboy->uploadFile('report.pdf');
echo $file->id; // store this

$fileboy->buildImageUrl($file->id, transforms: [['type' => 'resize', 'width' => 300]]);

1
2
3
4
5
6
$file = $fileboy->uploadFile(
    './exports/report.pdf',
    metadata: ['customerId' => 'cus_123', 'kind' => 'monthly-report'],
);

echo $file->id; // save this

1
2
3
4
5
$photo = $fileboy->uploadFileFromUrl(
    'https://example.com/photo.jpg',
    name: 'photo.jpg',
    expect: 'image/jpeg',
);

1
2
3
4
5
6
// the details of one file: name, mime, size, hash, metadata
$data = $fileboy->fetchFileData($file->id);

// a URL for a file or an image
$link = $fileboy->buildFileUrl($file->id, download: true);
$thumb = $fileboy->buildImageUrl($photo->id, transforms: [['type' => 'resize', 'width' => 300]]);

1
2
3
4
5
$url = $fileboy->buildImageUrl($photoId, transforms: [
    ['type' => 'resize', 'width' => 800],
    ['type' => 'format', 'format' => 'webp'],
    ['type' => 'quality', 'value' => 80],
]);

1
2
3
4
5
6
7
8
$video = $fileboy->uploadVideo('./clips/launch.mp4', name: 'Launch day');

// encoding runs in the background: poll until it is ready
$data = $fileboy->fetchVideoData($video->id);
$data['extractionStatus'];

$fileboy->buildVideoManifestUrl($video->id, type: 'hls');
$fileboy->buildVideoPosterUrl($video->id);

1
2
3
4
5
6
7
8
9
10
11
12
// app/Providers/AppServiceProvider.php
$this->app->singleton(\Fileboy\Client::class, fn () => new \Fileboy\Client(
    publicKey: config('services.fileboy.public_key'),
    privateKey: config('services.fileboy.private_key'),
));

// in a controller
public function store(Request $request, \Fileboy\Client $fileboy)
{
    $file = $fileboy->uploadFile($request->file('avatar')->getRealPath(), name: $request->file('avatar')->getClientOriginalName());
    $request->user()->update(['avatar_id' => $file->id]);
}

1
2
3
4
5
6
7
8
9
10
11
12
use Fileboy\Webhook;

$event = Webhook::verify(
    $request->getContent(),
    $request->headers->all(),
    config('services.fileboy.webhook_secret'),
);

if ($event['type'] === 'video.ready') {
    echo $event['resource']['urls']['hls'];
}
// throws Fileboy\Exception\WebhookVerificationException when the signature or timestamp is wrong