toosmart/file-store-sdk

There is no license information available for the latest version (1.0.3) of this package.

Interface to use file-store api

1.0.3 2025-05-27 13:42 UTC

Requires

• php: ^7.4
• guzzlehttp/guzzle: ^7.9

Unknown License

• remig

README

A PHP SDK for interacting with the TooSmart Object Storage API. Easily authenticate, upload, and download files from your TooSmart storage buckets.

Features

• Authenticate with API key (JWT-based)

• Upload files, file paths, or HTML content to storage buckets

• Download files from a specified bucket

• Automatic JWT renewal on authentication expiry (401)

Requirements

• PHP 7.4 or higher

• Guzzle HTTP

• TooSmart Object Storage API access

Installation

Install via Composer (recommended):

composer require toosmart/file-store-sdk

Or manually include the SDK and its dependencies in your project.

Usage

1. Initialize the Client

use TooSmart\FileStoreSdk\Client;

$client = new Client('https://your-filestore-api.url', 'your-api-key');

1. Authenticate

$client->login();

1. Select a Storage Bucket

$client->setBucket('your-bucket-name');

1. Download a File

$response = $client->getFile('path/in/bucket/filename.pdf');
$fileContents = $response['body']; // If not JSON, this is the raw file data

1. Upload Content You can upload files, file paths, or HTML content. Each item in $contentList must be an array with keys type (file, path, or html) and value.

Example: Upload a File

$contentList = [
    ['type' => 'file', 'value' => '/local/path/to/file.pdf'],
];

$response = $client->uploadContentList('folder/filename.pdf', $contentList, 'application/pdf', true);
$linkToFile = $response['body']['url'] ?? null;

Example: Upload HTML Content

$contentList = [
    ['type' => 'html', 'value' => '<h1>Hello, World!</h1>'],
];

$response = $client->uploadContentList('folder/hello.html', $contentList, 'text/html', true);