rass_tag_set.php

<?php
# Sample script for RAWS tutorial 8: see http://rambla.eu/ for more info.
#
# Copyright (C) 2010 rambla.be

# 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.
require_once '../RawsClient/Raws/Rass.php';

# Provide the path to a local testfile, that can be uploaded via RASS
define('LOCAL_FILE', '/my/path/to/a/file.mp4');

# Provide your own RASS credentials here
define('USER', 'xxx'); # your user account name
define('PWD', 'xxx'); # your user account pwd
define('CDN', "cdn0x"); # your sub-cdn (e.g. "cdn01")

define('BASE', 'http://rass.' . CDN . '.rambla.be/');

# all RASS API methods (except HEAD) will raise an exception if they don't return an HTTP SUCCESS CODE (200,201,204)
try {
  # Instantiate an object that manages the RASS connection, passing it your login credentials and the base service uri
  $rass = new Rass(USER, PWD, BASE);

  # Create a "tutorial8" directory under the root-directory
  $dir_entry = $rass->createDir("tutorial8", True);
  echo "Created directory with path: " . $dir_entry->path . "\n";
  
  # Upload a file 'test.mp4' to your dir
  $item_entry = $rass->postItem($dir_entry->path, "test.mp4", LOCAL_FILE);
  echo "Created file with path: " . $item_entry->path . "\n";

  # We can now attach tags to our uploaded file
  $meta_entry = $rass->setMetadataFromPath($item_entry->path, array(new Rass_Extension_Tag("animal"), new Rass_Extension_Tag("bird")), array());
  echo "\nTagged " . $meta_entry->kind . " entry with path = " . $meta_entry->path . " (set 'animal' and 'bird')\n";
  foreach ($meta_entry->content->params->tag as $t) {
    echo "Tag: " . $t->text . "\n";
  }
  
  # If you want to keep your existing tags + add new one(s) => use addMetadata()
  $meta_entry = $rass->getMetaEntry($item_entry->path);
  $meta_entry = $rass->addMetadata($meta_entry, array(new Rass_Extension_Tag("mockumentary")), array());
  echo "\nTagged " . $meta_entry->kind . " entry with path = " . $meta_entry->path . " (added 'mockumentary')\n";
  foreach ($meta_entry->content->params->tag as $t) {
    echo "Tag: " . $t->text . "\n";
  }

  # To replace a particular tag with another one, modify the array of Rass_Extension_Tag objects
  foreach ($meta_entry->content->params->tag as $t) {
    # replace the "mockumentary" tag with "documentary"
    if ($t->text == "mockumentary") {
      $t->text = "documentary";
    }
  }
  # a new call to addMetadata() will do a POST of our meta_entry (with no new tags added, but one replaced) 
  $meta_entry = $rass->addMetadata($meta_entry, array(), array());
  echo "\nTagged " . $meta_entry->kind . " entry with path = " . $meta_entry->path . " (replaced 'mockumentary' with 'documentary')\n";
  foreach ($meta_entry->content->params->tag as $t) {
    echo "Tag: " . $t->text . "\n";
  }
  
  # If you use setMetadata() or setMetadataFromPath(), existing tags will be removed (only the ones passed in the argument are being set)
  $meta_entry = $rass->setMetadata($meta_entry, array(new Rass_Extension_Tag("ohno")), array());
  echo "\nTagged " . $meta_entry->kind . " entry with path = " . $meta_entry->path . " (set 'ohno')\n";
  foreach ($meta_entry->content->params->tag as $t) {
    echo "Tag: " . $t->text . "\n";
  }

  // # Delete all metadata for this entry (if you only have the relative path, use deleteMetaEntry_from_path() instead)
  // $meta_entry = $rass->deleteMetaEntry($meta_entry);
  // # We can still retrieve the meta entry, but it will not contain any tags
  // $meta_entry = $rass->getMetaEntry($item_entry->path);
  // echo "\nAll metadata for " . $meta_entry->kind . " entry with path = " . $meta_entry->path . " has been removed !\n";
  // foreach ($meta_entry->content->params->tag as $t) {
  //   echo "Tag: " . $t->text . "\n";
  // }
  // 
  // # DELETE directory on the CDN. Set second argument to True to delete recursively.
  // $rass->deleteDir($dir_entry->path, True);
  // echo "Deleted dir: " . $dir_entry->path . "\n";

}
catch(Zend_Gdata_App_Exception $e) {
    # Report the exception to the user
    echo "\nCaught exception: " . get_class($e) . "\n";
    echo "Message: " . $e->getMessage() . "\n";
    # get the HTTP status code
    echo "HTTP Status Code: " . $e->getResponse()->getStatus() . "\n";
    echo "Response Body with exception details: " . $e->getResponse()->getBody() . "\n";
    # get the raws:error elements
    $rawsResponse = Raws::parseRawsResponse($e->getResponse());
    echo "Raws Code: " . $rawsResponse->getCode() . "\n";
    echo "Raws Message: " . $rawsResponse->getMsg() . "\n";
    $reasons = $rawsResponse->getReasons();
    foreach ($reasons as $reason) {
      echo "Raws Reason: " . $reason . "\n";
    }
    $details = $rawsResponse->getDetails();
    foreach ($details as $key => $value) {
      echo "Raws Detail: " . $key . " -> " . $value . "\n";
    }
}
catch (Zend_Exception $e) {
    echo "Caught exception: " . get_class($e) . "\n";
    echo "Message: " . $e->getMessage() . "\n";
}

---