class AkamaiCacheControlClient in Akamai 7.2

Default implementation of the AkamaiCacheControl interface

Hierarchy

• class \AkamaiCacheControlClient implements AkamaiCacheControl

1 string reference to 'AkamaiCacheControlClient'

akamai_get_class in ./akamai.module

Returns the Akamai Cache Control class.

File

./akamai.class.inc, line 25

akamai.class.inc Akamai is a registered trademark of Akamai Technologies, Inc. This class is an abstraction around the Akamai Cache Control API.

class AkamaiCacheControlClient implements AkamaiCacheControl {
  private $defaults;

  //akamai_get_defaults();
  public $parameters;

  /**
   * Constructs an instance of the Akamai Cache Control facade.
   *
   * Valid parameters are specified in the options array as key/value pairs with the
   * parameter name being the key and the parameter setting being the value
   *
   * @param options  An array of parameter options for the Akamae Cache Control
   *                  Web Service. These will override the defaults.
   */
  function __construct($options = array()) {
    $this->defaults = array(
      'basepath' => variable_get("akamai_basepath", ""),
      'name' => variable_get("akamai_username", ""),
      'pwd' => variable_get("akamai_password", ""),
      'action' => variable_get("akamai_action", ""),
      'type' => "arl",
      'domain' => variable_get("akamai_domain", ""),
      'restapi' => variable_get("akamai_restapi", ""),
      'timeout' => variable_get("akamai_timeout", "5"),
    );
    $this->parameters = array_merge($this->defaults, $options);
  }

  /**
   * Clears the provided URLs from the Akamai Content Cache.
   *
   * @param $paths
   *    A path (or array of paths) to clear from Akamai.
   * @throws AkamaiException
   *
   * @return array
   *   An array with 2 keys:
   *   - success: TRUE or FALSE indicating cache clearing success.
   *   - message: Blank if successful, the error message if not successful.
   */
  function clear_url($paths) {

    // Grab params.
    extract($this->parameters);

    // Prepend base path to paths to make URIs.
    $uris = array();
    foreach ($paths as $path) {
      $path = rtrim(preg_match("/^\\//", $path) ? $path : "/{$path}");
      array_push($uris, $basepath . $path);
    }
    $data = array(
      "type" => "arl",
      "action" => "{$action}",
      "domain" => "{$domain}",
      "objects" => $uris,
    );
    $data_string = json_encode($data);
    $data_string = str_replace("\\/", '/', $data_string);

    // URL needs to be in the format of scheme://user:pass@url.
    $url_parsed = parse_url($restapi);
    $url = $url_parsed['scheme'] . '://' . $name . ':' . $pwd . '@' . $url_parsed['host'] . $url_parsed['path'];
    $response = drupal_http_request($url, array(
      'method' => 'POST',
      'data' => $data_string,
      'timeout' => $this->defaults['timeout'],
      'headers' => array(
        'Content-Type' => 'application/json',
        'Content-Length' => strlen($data_string),
      ),
    ));

    // We expect Akamai to respond with code 201 if the purge request was
    // successfully created.
    if ($response->code != 201) {
      $message = format_string('Akamai RestAPI failed !action for !uris with code !code and response: !response', array(
        '!uris' => implode(' ', $uris),
        '!action' => $action,
        '!code' => $response->code,
        '!response' => var_export($response, TRUE),
      ));
      throw new AkamaiException($message);
    }
    if (empty($response->data)) {
      $message = format_string('Received no response data. Akamai RestAPI !action for !uris: Response: !response', array(
        '!uris' => implode(' ', $uris),
        '!action' => $action,
        '!response' => var_export($response, TRUE),
      ));
      throw new AkamaiException($message);
    }
    $response_data = json_decode($response->data);
    if ($response_data === null && json_last_error() !== JSON_ERROR_NONE) {
      $message = format_string('Failed to decode JSON data. Akamai RestAPI !action for !uris: Response: !response', array(
        '!uris' => implode(' ', $uris),
        '!action' => $action,
        '!response' => var_export($response, TRUE),
      ));
      throw new AkamaiException($message);
    }
    watchdog('Akamai', "Akamai RestAPI %action for %uris on %domain: Response: %response", array(
      '%uris' => implode(' ', $uris),
      '%action' => $action,
      '%domain' => $domain,
      '%response' => print_r($response_data, TRUE),
    ), WATCHDOG_NOTICE);
    return $response;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
AkamaiCacheControlClient::$defaults	private	property
AkamaiCacheControlClient::$parameters	public	property
AkamaiCacheControlClient::clear_url		function	Clears the provided URLs from the Akamai Content Cache. Overrides AkamaiCacheControl::clear_url
AkamaiCacheControlClient::__construct		function	Constructs an instance of the Akamai Cache Control facade.