akamai.class.inc in Akamai 8.2

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

File

akamai.class.inc

<?php

/**
 * @file akamai.class.inc
 *    Akamai is a registered trademark of Akamai Technologies, Inc.
 *    This class is an abstraction around the Akamai Cache Control API.
 */
interface AkamaiCacheControl {

  /**
   * Clears the provided URLs from the Akamai Content Cache.
   *
   * @param $paths
   *    A path (or array of paths) to clear from Akamai
   * @return
   *    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);

}

/**
 * Default implementation of the AkamaiCacheControl interface
 */
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()) {
    $akamai_config = \Drupal::config('akamai.settings');
    $this->defaults = array(
      'basepath' => $akamai_config
        ->get("basepath"),
      'name' => $akamai_config
        ->get("username"),
      'pwd' => $akamai_config
        ->get("password"),
      'action' => $akamai_config
        ->get("action"),
      'type' => "arl",
      'domain' => $akamai_config
        ->get("domain"),
      'restapi' => $akamai_config
        ->get("restapi"),
      'email' => $akamai_config
        ->get("email"),
    );
    $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
   * @return
   *    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);

    // make paths an array
    if (!is_array($paths)) {
      $url = array(
        $paths,
      );
    }

    // 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);
    }
    $opt = array(
      "action={$action}",
      "domain={$domain}",
      "type={$type}",
    );
    if (!empty($email) && $email != AKAMAI_EMAIL_DISABLE) {
      $opt[] = "email-notification={$email}";
    }
    $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'];
    try {
      $request = \Drupal::httpClient();
      $request
        ->post($url, array(
        'body' => $data_string,
        'timeout' => 5,
        'headers' => array(
          'Content-Type' => 'application/json',
          'Content-Length' => strlen($data_string),
        ),
      ));
      $response
        ->send();
    } catch (Exception $e) {
      watchdog('Akamai', t("Error Clearing Akamai Cache: %msg"), array(
        '%msg' => $e
          ->getMessage(),
      ));
      throw $e;
    }
    $is_success = $resposne
      ->getStatusCode() < 300;
    if (!$is_success) {
      throw new Exception($response->data);
    }
    $response_data = json_decode($response->data);
    watchdog('Akamai', t("Akamai RestAPI %action for %uris: Response: %response"), array(
      '%uris' => implode(' ', $uris),
      '%action' => $action,
      '%response' => $response_data->detail,
    ), WATCHDOG_NOTICE);
  }

}

/**
 * Implementation of the AkamaiCacheControl interface that records what was sent to it.
 * Hint: This is only useful for testing.
 */
class RecordingCacheControlClient implements AkamaiCacheControl {
  public $paths;
  public $options;

  /**
   * Constructs an instance of the Akamai Cache Control facade.
   */
  function __construct($options = array()) {
    $this->options = $options;
  }

  /**
   * Records the paths passed in.
   */
  function clear_url($paths) {
    if (!is_array($paths)) {
      $paths = array(
        $paths,
      );
    }
    $this->paths = $paths;
    return array(
      'success' => TRUE,
      'code' => '',
      'message' => '',
    );
  }

}

/**
 * Implementation of the AkamaiCacheControl interface that throws Exceptions.
 * Hint: This is only useful for testing.
 */
class ErrorCacheControlClient implements AkamaiCacheControl {

  /**
   * Constructs an instance of the Akamai Cache Control facade.
   */
  function __construct($options = array()) {
  }

  /**
   * Records the paths passed in.
   */
  function clear_url($paths) {
    throw new Exception(t('Akamai Failure Condition Test'));
  }

}

Classes

Name	Description
AkamaiCacheControlClient	Default implementation of the AkamaiCacheControl interface
ErrorCacheControlClient	Implementation of the AkamaiCacheControl interface that throws Exceptions. Hint: This is only useful for testing.
RecordingCacheControlClient	Implementation of the AkamaiCacheControl interface that records what was sent to it. Hint: This is only useful for testing.

Interfaces

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