README

backblaze-b2 是用于操作 Backblaze 的 B2 存储服务的 SDK。

安装

通过 Composer

$ composer require gliterd/backblaze-b2

使用方法

use BackblazeB2\Client;
use BackblazeB2\Bucket;

$options = ['auth_timeout_seconds' => seconds];

$client = new Client('accountId', 'applicationKey', $options);

$options 是可选的。如果省略，则默认超时时间为 12 小时。超时允许客户端对象长时间存活，以便授权令牌不会过期。

ApplicationKey 尚不支持，请仅使用 MasterKey

返回存储桶详情

$bucket = $client->createBucket([
    'BucketName' => 'my-special-bucket',
    'BucketType' => Bucket::TYPE_PRIVATE // or TYPE_PUBLIC
]);

更改存储桶类型

$updatedBucket = $client->updateBucket([
    'BucketId' => $bucket->getId(),
    'BucketType' => Bucket::TYPE_PUBLIC
]);

列出所有存储桶

$buckets = $client->listBuckets();

删除存储桶

$client->deleteBucket([
    'BucketId' => 'YOUR_BUCKET_ID'
]);

文件上传

$file = $client->upload([
    'BucketName' => 'my-special-bucket',
    'FileName' => 'path/to/upload/to',
    'Body' => 'I am the file content'

    // The file content can also be provided via a resource.
    // 'Body' => fopen('/path/to/input', 'r')
]);

文件下载

$fileContent = $client->download([
    'FileId' => $file->getId()

    // Can also identify the file via bucket and path:
    // 'BucketName' => 'my-special-bucket',
    // 'FileName' => 'path/to/file'

    // Can also save directly to a location on disk. This will cause download() to not return file content.
    // 'SaveAs' => '/path/to/save/location'
]);

文件删除

$fileDelete = $client->deleteFile([
    'FileId' => $file->getId()

    // Can also identify the file via bucket and path:
    // 'BucketName' => 'my-special-bucket',
    // 'FileName' => 'path/to/file'
]);

列出所有文件

$fileList = $client->listFiles([
    'BucketId' => 'YOUR_BUCKET_ID'
]);

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

测试

$ vendor/bin/phpunit

贡献

请参阅 CONTRIBUTING 和 CONDUCT 了解详细信息。

安全

如果您发现任何安全问题，请通过电子邮件 mhetreramesh@gmail.com 联系，而不是使用问题跟踪器。

致谢

• 所有贡献者

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 了解更多信息。