【PHP SDK for OpenStack/Rackspace APIs】使用对象储存服务

【PHP SDK for OpenStack/Rackspace APIs】使用对象存储服务

Swift是OpenStack的对象存储服务。在php-opencloud库中，通过connection对象创建的ObjectStore类（OpenStack或Rackspace)来存取。

例如：

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$cloud = new \OpenCloud\OpenStack(array(
    'username'=>'{username}','password'=>'{password}'));
$swift = $cloud->ObjectStore('cloudFiles','DFW');</code>

使用新创建的$swift，你可以使用不同的对象存储组件。

最高级别的对象存储组件实例是Container，Container是对象的集合名称，与文件系统中的目录和文件夹类似（实际上并不等同）。

所有的对象都保存在Container中。

在一个对象存储实例中列举所有Container

ContainerList对象是Container对象的集合。列举对象存储实例中的所有Container：

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$containers = $swift->ContainerList();
while($container = $containers->Next())
    printf("%s\n", $container->name);</code>

就像其他的对象集合，这也支持First(), Next()和Size()方法。

创建一个新Container

使用上面新创建的$swift对象的Container()方法创建一个新的（空的）的container。

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$mycontainer = $swift->Container();</code>

将该Container保存到对象存储实例中，使用Create()方法：

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$mycontainer->Create('MyContainerName');</code>

name不是必须在Create()方法中，如果name已经被设置的话。直接在方法中指定名称也是很方便的。

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$mycontainer->name = 'MyContainerName';
$mycontainer->Create();</code>

检索已存在的Container

如果你传递一个参数到ObjectStore对象的Container()方法中，可以检索一个已存在的Container：

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$oldcontainer = $swift->Container('SomeOldContainer');</code>

在这种情况下，关于SomeOldContainer的信息将被检索。这包含Container的metadata信息。

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">printf("Container %s has %d object(s) consuming %d bytes\n",
    $oldcontainer->name, $oldcontainer->count, $oldcontainer->bytes);</code>

删除Container

Delete()方法删除Container

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$oldcontainer->Delete();</code>

请注意，Container被删除时必须是空的，也就是说必须没有对象与它相关联。

更新Container

在后台,容器创建和更新方式完全相同。你可以使用Create()方法来更新Container；然而，Update()方法也被作为Create()方法的别名而存在，因为这在语义学上可能不同（在你的程序中）：

<code style="font-family:Consolas,'Liberation Mono',Courier,monospace; font-size:12px; margin:0px; padding:0px; border:none; background-color:transparent">$oldcontainer->metadata->update_time = time();
$oldcontainer->Update();</code>

翻译自：https://github.com/rackspace/php-opencloud/blob/master/docs/userguide/objectstore.md