135 lines
3.4 KiB
PHP
135 lines
3.4 KiB
PHP
<?php
|
|
/**
|
|
* @package FOF
|
|
* @copyright Copyright (c)2010-2021 Nicholas K. Dionysopoulos / Akeeba Ltd
|
|
* @license GNU General Public License version 2, or later
|
|
*/
|
|
|
|
namespace FOF30\Update;
|
|
|
|
defined('_JEXEC') || die;
|
|
|
|
use Exception;
|
|
use FOF30\Container\Container;
|
|
use FOF30\Download\Download;
|
|
use SimpleXMLElement;
|
|
|
|
/**
|
|
* A helper class to read and parse "extension" update XML files over the web
|
|
*/
|
|
class Extension
|
|
{
|
|
/**
|
|
* 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 = [];
|
|
|
|
// Get and parse the XML source
|
|
$container = Container::getInstance('com_FOOBAR');
|
|
$downloader = new Download($container);
|
|
$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 = [
|
|
'infourl' => ['title' => '', 'url' => ''],
|
|
'downloads' => [],
|
|
'tags' => [],
|
|
'targetplatform' => [],
|
|
];
|
|
|
|
$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'][] = [
|
|
'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;
|
|
}
|
|
}
|