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)。请参阅 许可文件 了解更多信息。