Spaces-API

An API wrapper for DigitalOcean's Spaces object storage designed for easy use.

 

Connecting

require_once("spaces.php");

$key = "EXAMPLE_KEY";
$secret = "EXAMPLE_SECRET";

$space = "my-space";

$space = new SpacesConnect($key, $secret, $space);

All available options:

SpacesConnect( REQUIRED KEY, REQUIRED SECRET, OPTIONAL SPACE's NAME, OPTIONAL REGION, OPTION HOST DOMAIN );

Uploading/Downloading Files

$path_to_file = "folder/my-image.png";
$optional_file_name = "image.png";

$space->uploadFile($path_to_file, $optional_file_name);



$download_file = "image.png";
$save_as = "folder/downloaded-image.png";

$space->downloadFile($download_file, $save_as);

All available options:

uploadFile( REQUIRED PATH TO FILE, OPTIONAL NAME TO SAVE FILE AS);

downloadFile( REQUIRED FILE TO DOWNLOAD, REQUIRED LOCATION TO SAVE FILE);

Creating Temporary Links

$file = "image.png";
$valid_for = "1 day";

$link = $space->CreateTemporaryURL($file, $valid_for);

All available options:

CreateTemporaryURL( REQUIRED FILE NAME, OPTIONAL TIME LINK IS VALID FOR);

Other File APIs

//List all files and folders
$files = $space->listObjects();


//Check if a file/folder by that name already exists. True/False.
$space->doesObjectExist($file_name);


//Pull information about a single object.
$file_info = $space->getObject($file_name);


//Delete a file/folder.
$space->deleteObject($file_name);


//Upload a complete directory instead of a single file.
$space->uploadDirectory($path_to_directory, $key_prefix);


//Pull Access Control List information.
$acl = $space-listObjectACL($file_name);


//Update Access Control List information.
$space->PutObjectACL($file_name, $acl_info_array);

Creating Spaces

$new_space = "my-new-space";

$space->createSpace($new_space);

All available options:

createSpace( REQUIRED SPACE NAME, OPTIONAL REGION FOR SPACE);