emapi.xml.inc in Embedded Media Field 6.3

XML data retrieval and storage API for Embedded Media API.

File

emapi/includes/emapi.xml.inc

<?php

/**
 *  @file
 *  XML data retrieval and storage API for Embedded Media API.
 */

/**
 *  A wrapper around simplexml to retrieve a given XML file.
 *
 *  @param $url
 *    The URL to the XML to retrieve.
 *  @param $display_errors
 *    Optional; if TRUE, then we'll display errors to the end user. They'll be
 *    logged to the watchdog in any case.
 *  @param $refresh
 *    Optional; if TRUE, then we'll force a new load of the XML. Otherwise,
 *    a cached version will be retrieved if possible.
 *  @return
 *    A fully populated object, or FALSE on an error.
 */
function _emapi_retrieve_xml($url, $display_errors = FALSE, $refresh = FALSE) {
  static $xmls;
  if (!isset($xmls)) {
    $xmls = array();
  }

  // Return our cached XML if allowed, and it exists.
  if (!$refresh && isset($xmls[$url])) {
    return $xmls[$url];
  }
  else {
    if (!$refresh && ($cache = cache_get('emapi:xml:' . $url, 'cache_emapi_xml'))) {
      $xmls[$url] = $cache->data;
      return $xmls[$url];
    }
  }

  // Enable user error handling.
  libxml_use_internal_errors(TRUE);

  // Load the document
  $xml = simplexml_load_file($url);
  if (!$xml) {
    foreach (libxml_get_errors() as $error) {
      $message = 'Error retrieving XML from %url: %error';
      $params = array(
        '%url' => $url,
        '%error' => $error->message,
      );

      // Handle errors here.
      if ($display_errors) {
        drupal_set_message(t($message, $params), 'error');
      }
      watchdog('emapi', $message, $params, WATCHDOG_WARNING);
    }

    // Clear our error cache.
    libxml_clear_errors();

    // Set the static cache, but not Drupal's cache, so we can attempt to
    // retrieve the file another time if possible.
    $xmls[$url] = FALSE;
  }
  else {
    $xmls[$url] = _emapi_unserialize_xml($xml);
    cache_set('emapi:xml:' . $url, $xmls[$url], 'cache_emapi_xml', emapi_variable_get('cache_expire'));
  }
  return $xmls[$url];
}

/**
 *  Recursively converts a SimpleXMLElement object into an array.
 *  @param $xml
 *    The original XML object.
 */
function _emapi_unserialize_xml($xml) {
  if ($xml instanceof SimpleXMLElement) {
    $xml = (array) $xml;
  }
  if (is_array($xml)) {
    foreach ($xml as $key => $item) {
      $xml[$key] = _emapi_unserialize_xml($item);
    }
  }
  return $xml;
}

Functions

Name	Description
_emapi_retrieve_xml	A wrapper around simplexml to retrieve a given XML file.
_emapi_unserialize_xml	Recursively converts a SimpleXMLElement object into an array.