Adding new changes

Author: Jamie Hannaford

.travis.yml

@@ -3,7 +3,6 @@ php:
   - "5.6"
   - "5.5"
   - "5.4"
-  - "5.3"
   - hhvm
 
 sudo: false

README.md

@@ -16,9 +16,11 @@ so that you can still use the SDK with a pure OpenStack instance
 
 Requirements
 ------------
-* PHP >=5.3.3
+* PHP >=5.4
 * cURL extension for PHP
 
+**Note**: Since PHP 5.3 has reached [end of life](http://php.net/eol.php) and is no longer officially supported, we are moving to 5.4 as a minimum requirement. If upgrading is not an option and you still need a stable version of the SDK for 5.3, please follow [this guide](http://docs.php-opencloud.com/en/latest/using-php-5.3.html).
+
 Installation
 ------------
 You must install this library through Composer:

doc/index.rst

@@ -30,6 +30,10 @@ Read the :doc:`getting-started-with-openstack` or
 :doc:`getting-started-with-rackspace` to help you get started with basic
 Compute operations.
 
+.. note::
+
+  If you are running PHP 5.3, please see our :doc:`using-php-5.3` guide.
+
 Services
 --------
 

doc/services/common/service-args.rst

@@ -3,9 +3,9 @@
   default will be provided if you pass in ``null``.
 
 * ``{region}`` is the region the service will operate in. For Rackspace
-  users, you can select one of the following from the `supported regions page
-  </regions>`_.
+  users, you can select one of the following from the :doc:`supported regions page
+  </regions>`.
 
-* ``{urlType}`` is the `type of URL </url-types>`_ to use, depending on which
+* ``{urlType}`` is the :doc:`type of URL </url-types>` to use, depending on which
   endpoints your catalog provides. If omitted, it will default to the public
   network.

doc/services/dns/domains.rst

@@ -268,8 +268,8 @@ Modify domain
 
 Only the TTL, email address and comment attributes of a domain can be modified.
 Records cannot be added, modified, or removed through this API operation - you
-will need to use the `add records <records#add-record>`__, `modify records
-<records#modify-record>`__ or `remove records <records#delete-record>`__
+will need to use the `add records <records.html#add-record>`__, `modify records
+<records.html#modify-record>`__ or `remove records <records.html#delete-record>`__
 operations respectively.
 
 .. code-block:: php

doc/services/object-store/migrating-containers.rst

@@ -37,13 +37,13 @@ Requirements
 
     use Guzzle\Plugin\Backoff\BackoffPlugin;
 
-    // set timeout in secs
-    $timeout = 10;
+    // maximum number of retries
+    $maxRetries = 10;
 
     // set HTTP error codes
     $httpErrors = array(500, 503, 408);
 
-    $backoffPlugin = BackoffPlugin::getExponentialBackoff($timeout, $httpErrors);
+    $backoffPlugin = BackoffPlugin::getExponentialBackoff($maxRetries, $httpErrors);
     $client->addSubscriber($backoffPlugin);
 
 
@@ -68,12 +68,12 @@ You can access all this functionality by executing:
 
 
 It's advisable to do this process in a Cloud Server in one of the two
-regions you're migrating to/from. This allows you to use ``privateURL``
+regions you're migrating to/from. This allows you to use ``internalURL``
 as the third argument in the ``objectStoreService`` methods like this:
 
 .. code-block:: php
 
-  $client->objectStoreService('cloudFiles', 'IAD', 'privateURL');
+  $client->objectStoreService('cloudFiles', 'IAD', 'internalURL');
 
 
 This will ensure that traffic between your server and your new IAD

doc/services/object-store/objects.rst

@@ -177,6 +177,42 @@ docs <http://docs.openstack.org/api/openstack-object-storage/1.0/content/list-ob
 `Get the executable PHP script for this example <https://raw.githubusercontent.com/rackspace/php-opencloud/master/samples/ObjectStore/list-objects.php>`_
 
 
+List over 10,000 objects
+------------------------
+
+To retrieve more than 10,000 objects (the default limit), you'll need to use
+the built-in paging which uses a 'marker' parameter to fetch the next page of data.
+
+.. code-block:: php
+
+    $containerObjects = array();
+    $marker = '';
+
+    while ($marker !== null) {
+        $params = array(
+            'marker' => $marker,
+        );
+
+        $objects = $container->objectList($params);
+        $total = $objects->count();
+        $count = 0;
+
+        if ($total == 0) {
+            break;
+        }
+
+        foreach ($objects as $object) {
+            /** @var $object OpenCloud\ObjectStore\Resource\DataObject **/
+            $containerObjects[] = $object->getName();
+            $count++;
+
+            $marker = ($count == $total) ? $object->getName() : null;
+        }
+    }
+
+`Get the executable PHP script for this example <https://raw.githubusercontent.com/rackspace/php-opencloud/master/samples/ObjectStore/list-objects-over-10000.php>`_
+
+
 Get object
 ----------
 
@@ -223,7 +259,7 @@ Get content of file
 .. code-block:: php
 
   /** @param $content Guzzle\Http\EntityBody */
-  $content = $object->getContainer();
+  $content = $object->getContent();
 
 
 Get type of file
@@ -326,6 +362,41 @@ the name of the object inside the container that does not exist yet.
 `Get the executable PHP script for this example <https://raw.githubusercontent.com/rackspace/php-opencloud/master/samples/ObjectStore/copy-object.php>`_
 
 
+Symlinking to this object from another location
+-----------------------------------------------
+
+To create a symlink to this file in another location you need to specify
+a string-based source
+
+.. code-block:: php
+
+  $object->createSymlinkFrom('/container_2/new_object_name');
+
+Where ``container_2`` is the name of the container, and ``new_object_name`` is
+the name of the object inside the container that either does not exist yet or
+is an empty file.
+
+`Get the executable PHP script for this example <https://raw.githubusercontent.com/rackspace/php-opencloud/master/samples/ObjectStore/symlink-object.php>`_
+
+
+Setting this object to symlink to another location
+--------------------------------------------------
+
+To set this file to symlink to another location you need to specify
+a string-based destination
+
+.. code-block:: php
+
+  $object->createSymlinkTo('/container_2/new_object_name');
+
+Where ``container_2`` is the name of the container, and ``new_object_name`` is
+the name of the object inside the container.
+
+The object must be an empty file.
+
+`Get the executable PHP script for this example <https://raw.githubusercontent.com/rackspace/php-opencloud/master/samples/ObjectStore/symlink-object.php>`_
+
+
 Get object metadata
 -------------------
 

doc/using-php-5.3.rst

@@ -0,0 +1,20 @@
+Using the SDK with PHP v5.3
+===========================
+
+Since PHP 5.3 has entered EOL and no longer receives security updates, we have bumped the minimum requirement to 5.4. Using 5.3 is still possible, however, but you will need to use an older stable version of the SDK. There are two ways to do this.
+
+The first way is by requiring it through the command line:
+
+.. code-block:: bash
+
+  composer require rackspace/php-opencloud:1.12
+
+The second way is by updating your composer.json file, and specifying the appropriate version of the SDK:
+
+.. code-block:: json
+
+  "require": {
+    "rackspace/php-opencloud": "~1.12"
+  }
+
+Note that **1.12** is the last minor release supporting PHP 5.3. Version 1.13 and above has shifted to PHP 5.4.

lib/OpenCloud/Common/Constants/Header.php

@@ -70,4 +70,5 @@ class Header
     const USER_AGENT = 'User-Agent';
     const VARY = 'Vary';
     const VIA = 'Via';
+    const X_OBJECT_MANIFEST = 'X-Object-Manifest';
 }

lib/OpenCloud/Common/Exceptions/DomainNotFoundException.php

@@ -0,0 +1,22 @@
+<?php
+/**
+ * Copyright 2012-2014 Rackspace US, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+namespace OpenCloud\Common\Exceptions;
+
+class DomainNotFoundException extends \Exception
+{
+}