Containers¶

Create container¶

To create a new container, you just need to define its name:

$container = $service->createContainer('my_amazing_container');

If the response returned is FALSE, there was an API error - most likely due to the fact you have a naming collision.

Container names must be valid strings between 0 and 256 characters. Forward slashes are not currently permitted.

Get the executable PHP script for this example

List containers¶

$containers = $service->listContainers();

foreach ($containers as $container) {
    /** @param $container OpenCloud\ObjectStore\Resource\Container */
    printf("Container name: %s\n", $container->name);
    printf("Number of objects within container: %d\n", $container->getObjectCount());
}

Container names are sorted based on a binary comparison, a single built-in collating sequence that compares string data using SQLite’s memcmp() function, regardless of text encoding.

The list is limited to 10,000 containers at a time. To work with larger collections, please read the next section.

Get the executable PHP script for this example

$someContainers = $service->listContainers(array(
    'marker'     => 'container_55',
    'end_marker' => 'container_2001'
));

$someContainers = $service->listContainers(array('limit' => 560));

Get container¶

To retrieve a certain container:

/** @param $container OpenCloud\ObjectStore\Resource\Container */
$container = $service->getContainer('{containerName}');

Get the executable PHP script for this example

$name = $container->name;

$count = $container->getObjectCount();

$bytes = $container->getBytesUsed();

Delete container¶

Deleting an empty container is easy:

$container->delete();

Please bear mind that you must delete all objects inside a container before deleting it. This is done for you if you set the $deleteObjects parameter to TRUE like so:

$container->delete(true);

You can also delete all objects first, and then call delete.

Get the executable PHP script for this example

Deleting all objects inside a container¶

$container->deleteAllObjects();

Get the executable PHP script for this example

Create or update container metadata¶

$container->saveMetadata(array(
    'Author' => 'Virginia Woolf',
    'Published' => '1931'
));

Please bear in mind that this action will set metadata to this array - overriding existing values and wiping those left out. To append values to the current metadata:

$metadata = $container->appendToMetadata(array(
    'Publisher' => 'Hogarth'
));

Get the executable PHP script for this example

Container quotas¶

The container_quotas middleware implements simple quotas that can be imposed on Cloud Files containers by a user. Setting container quotas can be useful for limiting the scope of containers that are delegated to non-admin users, exposed to formpost uploads, or just as a self-imposed sanity check.

To set quotas for a container:

use OpenCloud\Common\Constants\Size;

$container->setCountQuota(1000);
$container->setBytesQuota(2.5 * Size::GB);

And to retrieve them:

echo $container->getCountQuota();
echo $container->getBytesQuota();

Get the executable PHP scripts for this example:

• Set bytes quota
• Set count quota

Access log delivery¶

To view your object access, turn on Access Log Delivery. You can use access logs to analyze the number of people who access your objects, where they come from, how many requests for each object you receive, and time-based usage patterns (such as monthly or seasonal usage).

$container->enableLogging();
$container->disableLogging();

Syncing containers¶

You can synchronize local directories with your CloudFiles/Swift containers very easily. When you do this, the container will mirror exactly the nested file structure within your local directory:

$container->uploadDirectory('/home/user/my-blog');

There are four scenarios you should be aware of: