primo commit

libraries/f0f/utils/update/extension.php

@@ -0,0 +1,128 @@
+<?php
+/**
+ * @package     FrameworkOnFramework
+ * @subpackage  utils
+ * @copyright   Copyright (C) 2010-2016 Nicholas K. Dionysopoulos / Akeeba Ltd. All rights reserved.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+// Protect from unauthorized access
+defined('F0F_INCLUDED') or die;
+
+/**
+ * A helper class to read and parse "extension" update XML files over the web
+ */
+class F0FUtilsUpdateExtension
+{
+	/**
+	 * Reads an "extension" XML update source and returns all listed update entries.
+	 *
+	 * If you have a "collection" XML update source you should do something like this:
+	 * $collection = new F0FUtilsUpdateCollection();
+	 * $extensionUpdateURL = $collection->getExtensionUpdateSource($url, 'component', 'com_foobar', JVERSION);
+	 * $extension = new F0FUtilsUpdateExtension();
+	 * $updates = $extension->getUpdatesFromExtension($extensionUpdateURL);
+	 *
+	 * @param   string  $url  The extension XML update source URL to read from
+	 *
+	 * @return  array  An array of update entries
+	 */
+	public function getUpdatesFromExtension($url)
+	{
+		// Initialise
+		$ret = array();
+
+		// Get and parse the XML source
+		$downloader = new F0FDownload();
+		$xmlSource = $downloader->getFromURL($url);
+
+		try
+		{
+			$xml = new SimpleXMLElement($xmlSource, LIBXML_NONET);
+		}
+		catch(Exception $e)
+		{
+			return $ret;
+		}
+
+		// Sanity check
+		if (($xml->getName() != 'updates'))
+		{
+			unset($xml);
+
+			return $ret;
+		}
+
+		// Let's populate the list of updates
+		/** @var SimpleXMLElement $update */
+		foreach ($xml->children() as $update)
+		{
+			// Sanity check
+			if ($update->getName() != 'update')
+			{
+				continue;
+			}
+
+			$entry = array(
+				'infourl'			=> array('title' => '', 'url' => ''),
+				'downloads'			=> array(),
+				'tags'				=> array(),
+				'targetplatform'	=> array(),
+			);
+
+			$properties = get_object_vars($update);
+
+			foreach ($properties as $nodeName => $nodeContent)
+			{
+				switch ($nodeName)
+				{
+					default:
+						$entry[$nodeName] = $nodeContent;
+						break;
+
+					case 'infourl':
+					case 'downloads':
+					case 'tags':
+					case 'targetplatform':
+						break;
+				}
+			}
+
+			$infourlNode = $update->xpath('infourl');
+			$entry['infourl']['title'] = (string)$infourlNode[0]['title'];
+			$entry['infourl']['url'] = (string)$infourlNode[0];
+
+			$downloadNodes = $update->xpath('downloads/downloadurl');
+			foreach ($downloadNodes as $downloadNode)
+			{
+				$entry['downloads'][] = array(
+					'type'		=> (string)$downloadNode['type'],
+					'format'	=> (string)$downloadNode['format'],
+					'url'		=> (string)$downloadNode,
+				);
+			}
+
+			$tagNodes = $update->xpath('tags/tag');
+			foreach ($tagNodes as $tagNode)
+			{
+				$entry['tags'][] = (string)$tagNode;
+			}
+
+			/** @var SimpleXMLElement $targetPlatformNode */
+			$targetPlatformNode = $update->xpath('targetplatform');
+
+			$entry['targetplatform']['name'] = (string)$targetPlatformNode[0]['name'];
+			$entry['targetplatform']['version'] = (string)$targetPlatformNode[0]['version'];
+			$client = $targetPlatformNode[0]->xpath('client');
+			$entry['targetplatform']['client'] = (is_array($client) && count($client)) ? (string)$client[0] : '';
+			$folder = $targetPlatformNode[0]->xpath('folder');
+			$entry['targetplatform']['folder'] = is_array($folder) && count($folder) ? (string)$folder[0] : '';
+
+			$ret[] = $entry;
+		}
+
+		unset($xml);
+
+		return $ret;
+	}
+}