samicrusader/flysystem-backblaze

Connects Backblaze B2 object storage to Flysystem

dev-master 2025-09-11 22:42 UTC

Requires

• php: ^8.1
• league/flysystem: 1.0.70
• obregonco/backblaze-b2: dev-master

Requires (Dev)

• phpunit/phpunit: ~4.0||~5.0
• scrutinizer/ocular: ~1.1
• squizlabs/php_codesniffer: ~2.3

MIT

• Sami

• filesystem
• api
• client
• Flysystem
• backblaze

README

Connects Backblaze B2 object storage to Flysystem v1.0; forked from gliterd/mhetreramesh for use with XenForo because Backblaze's S3 implementation is AIDS.

This fork/rewrite uses obregonco/backblaze-b2 since it supports B2 API version 2 and also was updated in the last year.

$ composer require samicrusader/flysystem-backblaze

XF install instructions coming soon

Usage

You will need:

• $accountId -> Master Application Key keyID
• $keyId -> keyID (if you are using the master application key which you shouldn't be, you can omit this)
• $applicationKey => applicationKey

You can find these on the https://secure.backblaze.com/app_keys.htm page.

use Samicrusader\Flysystem\BackblazeClient;
use Samicrusader\Flysystem\BackblazeAdapter;
use League\Flysystem\Filesystem;

$client = new BackblazeClient(
    accountId: 'xxxxxxxxxxxx', 
    authorizationValues: [
        'keyId' => 'xxxxxxxxxxxxxxxxxxxxxxxxx', /* optional if using master account key */
        'applicationKey' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    ]
);
$client->version = 2; // client defaults to v1 for some reason

$adapter = new BackblazeAdapter($client, $bucketName);
$filesystem = new Filesystem($adapter);