dbp/relay-blob-library

PHP helper library for interaction with the dbp/relay-blob-bundle.

v0.3.10 2025-06-10 09:15 UTC

Requires

• php: >=8.2
• ext-json: *
• guzzlehttp/guzzle: ^7.0
• guzzlehttp/psr7: ^2.7
• psr/http-message: ^1.0 || ^2.0
• symfony/config: ^6.4 || ^7.2
• symfony/dependency-injection: ^6.4 || ^7.2
• symfony/http-foundation: ^6.4 || ^7
• web-token/jwt-library: ^3.3 || ^4.0.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.50
• phpstan/phpstan: ^2.0.0
• phpstan/phpstan-phpunit: ^2.0.0
• phpstan/phpstan-symfony: ^2.0
• phpunit/phpunit: ^11

AGPL-3.0-or-later

README

GitHub | Packagist | Changelog

PHP helper library for interaction with the relay-blob-bundle.

Installation

composer require dbp/relay-blob-library

Usage

Here is an example of how to use the library in HTTP mode, with OIDC authentication enabled:

    // create the API
    $blobApi = BlobApi::createHttpModeApi(
        $bucketIdentifier, $bucketKey, $blobBaseUrl,
        $oidcEnabled, $oidcProviderUrl, $oidcClientId, $oidcClientSecret);

    $blobFile = new BlobFile();
    $filePath = 'files/myFile.txt';
    $blobFile->setFilename(basename($filePath));
    $blobFile->setFile(new SplFileInfo($filePath));
    $blobFile->setPrefix('my-prefix');
    
    // add the file    
    $blobFile = $blobApi->addFile($blobFile);

    // get the file
    $blobFile = $blobApi->getFile($blobFile->getIdentifier());

    // remove the file
    $blobApi->removeFile($blobFile->getIdentifier());

• For the whole example PHP code, see BlobApiExamples.php

Integration into a Symfony bundle

Soon to come.