primo commit

libraries/fof30/Platform/Base/Filesystem.php

@@ -0,0 +1,150 @@
+<?php
+/**
+ * @package   FOF
+ * @copyright Copyright (c)2010-2021 Nicholas K. Dionysopoulos / Akeeba Ltd
+ * @license   GNU General Public License version 2, or later
+ */
+
+namespace FOF30\Platform\Base;
+
+defined('_JEXEC') || die;
+
+use FOF30\Container\Container;
+use FOF30\Platform\FilesystemInterface;
+
+abstract class Filesystem implements FilesystemInterface
+{
+	/**
+	 * The list of paths where platform class files will be looked for
+	 *
+	 * @var  array
+	 */
+	protected static $paths = [];
+	/** @var  Container  The component container */
+	protected $container = null;
+
+	/**
+	 * Public constructor.
+	 *
+	 * @param   Container  $c  The component container
+	 */
+	public function __construct(Container $c)
+	{
+		$this->container = $c;
+	}
+
+	/**
+	 * This method will crawl a starting directory and get all the valid files that will be analyzed by getInstance.
+	 * Then it organizes them into an associative array.
+	 *
+	 * @param   string  $path           Folder where we should start looking
+	 * @param   array   $ignoreFolders  Folder ignore list
+	 * @param   array   $ignoreFiles    File ignore list
+	 *
+	 * @return  array   Associative array, where the `fullpath` key contains the path to the file,
+	 *                  and the `classname` key contains the name of the class
+	 */
+	protected static function getFiles($path, array $ignoreFolders = [], array $ignoreFiles = [])
+	{
+		$return = [];
+
+		$files = self::scanDirectory($path, $ignoreFolders, $ignoreFiles);
+
+		// Ok, I got the files, now I have to organize them
+		foreach ($files as $file)
+		{
+			$clean = str_replace($path, '', $file);
+			$clean = trim(str_replace('\\', '/', $clean), '/');
+
+			$parts = explode('/', $clean);
+
+			// If I have less than 3 fragments, it means that the file was inside the generic folder
+			// (interface + abstract) so I have to skip it
+			if (count($parts) < 3)
+			{
+				continue;
+			}
+
+			$return[] = [
+				'fullpath'  => $file,
+				'classname' => 'F0FPlatform' . ucfirst($parts[0]) . ucfirst(basename($parts[1], '.php')),
+			];
+		}
+
+		return $return;
+	}
+
+	/**
+	 * Recursive function that will scan every directory unless it's in the ignore list. Files that aren't in the
+	 * ignore list are returned.
+	 *
+	 * @param   string  $path           Folder where we should start looking
+	 * @param   array   $ignoreFolders  Folder ignore list
+	 * @param   array   $ignoreFiles    File ignore list
+	 *
+	 * @return  array   List of all the files
+	 */
+	protected static function scanDirectory($path, array $ignoreFolders = [], array $ignoreFiles = [])
+	{
+		$return = [];
+
+		$handle = @opendir($path);
+
+		if (!$handle)
+		{
+			return $return;
+		}
+
+		while (($file = readdir($handle)) !== false)
+		{
+			if ($file == '.' || $file == '..')
+			{
+				continue;
+			}
+
+			$fullpath = $path . '/' . $file;
+
+			if ((is_dir($fullpath) && in_array($file, $ignoreFolders)) || (is_file($fullpath) && in_array($file, $ignoreFiles)))
+			{
+				continue;
+			}
+
+			if (is_dir($fullpath))
+			{
+				$return = array_merge(self::scanDirectory($fullpath, $ignoreFolders, $ignoreFiles), $return);
+			}
+			else
+			{
+				$return[] = $path . '/' . $file;
+			}
+		}
+
+		return $return;
+	}
+
+	/**
+	 * Gets the extension of a file name
+	 *
+	 * @param   string  $file  The file name
+	 *
+	 * @return  string  The file extension
+	 */
+	public function getExt($file)
+	{
+		$dot = strrpos($file, '.') + 1;
+
+		return substr($file, $dot);
+	}
+
+	/**
+	 * Strips the last extension off of a file name
+	 *
+	 * @param   string  $file  The file name
+	 *
+	 * @return  string  The file name without the extension
+	 */
+	public function stripExt($file)
+	{
+		return preg_replace('#\.[^.]*$#', '', $file);
+	}
+}

libraries/fof30/Platform/Base/Platform.php

@@ -0,0 +1,416 @@
+<?php
+/**
+ * @package   FOF
+ * @copyright Copyright (c)2010-2021 Nicholas K. Dionysopoulos / Akeeba Ltd
+ * @license   GNU General Public License version 2, or later
+ */
+
+namespace FOF30\Platform\Base;
+
+defined('_JEXEC') || die;
+
+use Exception;
+use FOF30\Container\Container;
+use FOF30\Input\Input;
+use FOF30\Platform\PlatformInterface;
+use Joomla\CMS\Document\Document;
+use Joomla\CMS\User\User;
+
+/**
+ * Abstract implementation of the Platform integration
+ *
+ * @package FOF30\Platform\Base
+ */
+abstract class Platform implements PlatformInterface
+{
+	/** @var  Container  The component container */
+	protected $container = null;
+
+	/** @var  bool  Are plugins allowed to run in CLI mode? */
+	protected $allowPluginsInCli = false;
+
+	/**
+	 * Public constructor.
+	 *
+	 * @param   Container  $c  The component container
+	 */
+	public function __construct(Container $c)
+	{
+		$this->container = $c;
+	}
+
+	/**
+	 * Returns the base (root) directories for a given component.
+	 *
+	 * @param   string  $component  The name of the component. For Joomla! this
+	 *                              is something like "com_example"
+	 *
+	 * @return  array  A hash array with keys main, alt, site and admin.
+	 * @see F0FPlatformInterface::getComponentBaseDirs()
+	 *
+	 */
+	public function getComponentBaseDirs($component)
+	{
+		return [
+			'main'  => '',
+			'alt'   => '',
+			'site'  => '',
+			'admin' => '',
+		];
+	}
+
+	/**
+	 * Returns the application's template name
+	 *
+	 * @param   boolean|array  $params  An optional associative array of configuration settings
+	 *
+	 * @return  string  The template name. System is the fallback.
+	 */
+	public function getTemplate($params = false)
+	{
+		return 'system';
+	}
+
+	/**
+	 * Get application-specific suffixes to use with template paths. This allows
+	 * you to look for view template overrides based on the application version.
+	 *
+	 * @return  array  A plain array of suffixes to try in template names
+	 */
+	public function getTemplateSuffixes()
+	{
+		return [];
+	}
+
+	/**
+	 * Return the absolute path to the application's template overrides
+	 * directory for a specific component. We will use it to look for template
+	 * files instead of the regular component directories. If the application
+	 * does not have such a thing as template overrides return an empty string.
+	 *
+	 * @param   string   $component  The name of the component for which to fetch the overrides
+	 * @param   boolean  $absolute   Should I return an absolute or relative path?
+	 *
+	 * @return  string  The path to the template overrides directory
+	 */
+	public function getTemplateOverridePath($component, $absolute = true)
+	{
+		return '';
+	}
+
+	/**
+	 * Load the translation files for a given component.
+	 *
+	 * @param   string  $component  The name of the component. For Joomla! this
+	 *                              is something like "com_example"
+	 *
+	 * @return  void
+	 * @see F0FPlatformInterface::loadTranslations()
+	 *
+	 */
+	public function loadTranslations($component)
+	{
+		return null;
+	}
+
+	/**
+	 * Authorise access to the component in the back-end.
+	 *
+	 * @param   string  $component  The name of the component.
+	 *
+	 * @return  boolean  True to allow loading the component, false to halt loading
+	 * @see F0FPlatformInterface::authorizeAdmin()
+	 *
+	 */
+	public function authorizeAdmin($component)
+	{
+		return true;
+	}
+
+	/**
+	 * Returns the JUser object for the current user
+	 *
+	 * @param   integer  $id  The ID of the user to fetch
+	 *
+	 * @return  Document
+	 * @see F0FPlatformInterface::getUser()
+	 *
+	 */
+	public function getUser($id = null)
+	{
+		return null;
+	}
+
+	/**
+	 * Returns the JDocument object which handles this component's response.
+	 *
+	 * @return  Document
+	 * @see F0FPlatformInterface::getDocument()
+	 *
+	 */
+	public function getDocument()
+	{
+		return null;
+	}
+
+	/**
+	 * This method will try retrieving a variable from the request (input) data.
+	 *
+	 * @param   string   $key           The user state key for the variable
+	 * @param   string   $request       The request variable name for the variable
+	 * @param   Input    $input         The Input object with the request (input) data
+	 * @param   mixed    $default       The default value. Default: null
+	 * @param   string   $type          The filter type for the variable data. Default: none (no filtering)
+	 * @param   boolean  $setUserState  Should I set the user state with the fetched value?
+	 *
+	 * @return  mixed  The value of the variable
+	 * @see F0FPlatformInterface::getUserStateFromRequest()
+	 *
+	 */
+	public function getUserStateFromRequest($key, $request, $input, $default = null, $type = 'none', $setUserState = true)
+	{
+		return $input->get($request, $default, $type);
+	}
+
+	/**
+	 * Load plugins of a specific type. Obviously this seems to only be required
+	 * in the Joomla! CMS.
+	 *
+	 * @param   string  $type  The type of the plugins to be loaded
+	 *
+	 * @return void
+	 * @see F0FPlatformInterface::importPlugin()
+	 *
+	 */
+	public function importPlugin($type)
+	{
+	}
+
+	/**
+	 * Execute plugins (system-level triggers) and fetch back an array with
+	 * their return values.
+	 *
+	 * @param   string  $event  The event (trigger) name, e.g. onBeforeScratchMyEar
+	 * @param   array   $data   A hash array of data sent to the plugins as part of the trigger
+	 *
+	 * @return  array  A simple array containing the results of the plugins triggered
+	 * @see F0FPlatformInterface::runPlugins()
+	 *
+	 */
+	public function runPlugins($event, $data)
+	{
+		return [];
+	}
+
+	/**
+	 * Perform an ACL check.
+	 *
+	 * @param   string  $action     The ACL privilege to check, e.g. core.edit
+	 * @param   string  $assetname  The asset name to check, typically the component's name
+	 *
+	 * @return  boolean  True if the user is allowed this action
+	 * @see F0FPlatformInterface::authorise()
+	 *
+	 */
+	public function authorise($action, $assetname)
+	{
+		return true;
+	}
+
+	/**
+	 * Is this the administrative section of the component?
+	 *
+	 * @return  boolean
+	 * @see F0FPlatformInterface::isBackend()
+	 *
+	 */
+	public function isBackend()
+	{
+		return true;
+	}
+
+	/**
+	 * Is this the public section of the component?
+	 *
+	 * @return  boolean
+	 * @see F0FPlatformInterface::isFrontend()
+	 *
+	 */
+	public function isFrontend()
+	{
+		return true;
+	}
+
+	/**
+	 * Is this a component running in a CLI application?
+	 *
+	 * @return  boolean
+	 * @see F0FPlatformInterface::isCli()
+	 *
+	 */
+	public function isCli()
+	{
+		return true;
+	}
+
+	/**
+	 * Is AJAX re-ordering supported? This is 100% Joomla!-CMS specific. All
+	 * other platforms should return false and never ask why.
+	 *
+	 * @return  boolean
+	 * @see F0FPlatformInterface::supportsAjaxOrdering()
+	 *
+	 */
+	public function supportsAjaxOrdering()
+	{
+		return true;
+	}
+
+	/**
+	 * Saves something to the cache. This is supposed to be used for system-wide
+	 * F0F data, not application data.
+	 *
+	 * @param   string  $key      The key of the data to save
+	 * @param   string  $content  The actual data to save
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function setCache($key, $content)
+	{
+		return false;
+	}
+
+	/**
+	 * Retrieves data from the cache. This is supposed to be used for system-side
+	 * F0F data, not application data.
+	 *
+	 * @param   string  $key      The key of the data to retrieve
+	 * @param   string  $default  The default value to return if the key is not found or the cache is not populated
+	 *
+	 * @return  string  The cached value
+	 */
+	public function getCache($key, $default = null)
+	{
+		return false;
+	}
+
+	/**
+	 * Is the global F0F cache enabled?
+	 *
+	 * @return  boolean
+	 */
+	public function isGlobalFOFCacheEnabled()
+	{
+		return true;
+	}
+
+	/**
+	 * Clears the cache of system-wide F0F data. You are supposed to call this in
+	 * your components' installation script post-installation and post-upgrade
+	 * methods or whenever you are modifying the structure of database tables
+	 * accessed by F0F. Please note that F0F's cache never expires and is not
+	 * purged by Joomla!. You MUST use this method to manually purge the cache.
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function clearCache()
+	{
+		return false;
+	}
+
+	/**
+	 * logs in a user
+	 *
+	 * @param   array  $authInfo  Authentication information
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function loginUser($authInfo)
+	{
+		return true;
+	}
+
+	/**
+	 * logs out a user
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function logoutUser()
+	{
+		return true;
+	}
+
+	/**
+	 * Logs a deprecated practice. In Joomla! this results in the $message being output in the
+	 * deprecated log file, found in your site's log directory.
+	 *
+	 * @param   string  $message  The deprecated practice log message
+	 *
+	 * @return  void
+	 */
+	public function logDeprecated($message)
+	{
+		// The default implementation does nothing. Override this in your platform classes.
+	}
+
+	/**
+	 * Adds a message
+	 *
+	 * @param   string|array  $title      A title, or an array of additional fields to add to the log entry
+	 * @param   string        $logText    The translation key to the log text
+	 * @param   string        $extension  The name of the extension logging this entry
+	 * @param   User|null     $user       The user the action is being logged for
+	 *
+	 * @return  void
+	 */
+	public function logUserAction($title, $logText, $extension, $user = null)
+	{
+		// The default implementation does nothing. Override this in your platform classes.
+	}
+
+	/**
+	 * Returns the version number string of the platform, e.g. "4.5.6". If
+	 * implementation integrates with a CMS or a versioned foundation (e.g.
+	 * a framework) it is advisable to return that version.
+	 *
+	 * @return  string
+	 *
+	 * @since  2.1.2
+	 */
+	public function getPlatformVersion()
+	{
+		return '';
+	}
+
+	/**
+	 * Handle an exception in a way that results to an error page.
+	 *
+	 * @param   Exception  $exception  The exception to handle
+	 *
+	 * @throws  Exception  Possibly rethrown exception
+	 */
+	public function showErrorPage(Exception $exception)
+	{
+		throw $exception;
+	}
+
+	/**
+	 * Are plugins allowed to run in CLI mode?
+	 *
+	 * @return  bool
+	 */
+	public function isAllowPluginsInCli()
+	{
+		return $this->allowPluginsInCli;
+	}
+
+	/**
+	 * Set whether plugins are allowed to run in CLI mode
+	 *
+	 * @param   bool  $allowPluginsInCli
+	 */
+	public function setAllowPluginsInCli($allowPluginsInCli)
+	{
+		$this->allowPluginsInCli = $allowPluginsInCli;
+	}
+}

libraries/fof30/Platform/FilesystemInterface.php

@@ -0,0 +1,171 @@
+<?php
+/**
+ * @package   FOF
+ * @copyright Copyright (c)2010-2021 Nicholas K. Dionysopoulos / Akeeba Ltd
+ * @license   GNU General Public License version 2, or later
+ */
+
+namespace FOF30\Platform;
+
+defined('_JEXEC') || die;
+
+use Exception;
+use FOF30\Container\Container;
+use UnexpectedValueException;
+
+interface FilesystemInterface
+{
+	/**
+	 * Public constructor.
+	 *
+	 * @param   Container  $c  The component container
+	 */
+	public function __construct(Container $c);
+
+	/**
+	 * Does the file exists?
+	 *
+	 * @param   $path  string   Path to the file to test
+	 *
+	 * @return  bool
+	 */
+	public function fileExists($path);
+
+	/**
+	 * Delete a file or array of files
+	 *
+	 * @param   mixed  $file  The file name or an array of file names
+	 *
+	 * @return  boolean  True on success
+	 *
+	 */
+	public function fileDelete($file);
+
+	/**
+	 * Copies a file
+	 *
+	 * @param   string  $src   The path to the source file
+	 * @param   string  $dest  The path to the destination file
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function fileCopy($src, $dest);
+
+	/**
+	 * Write contents to a file
+	 *
+	 * @param   string    $file    The full file path
+	 * @param   string   &$buffer  The buffer to write
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function fileWrite($file, &$buffer);
+
+	/**
+	 * Checks for snooping outside of the file system root.
+	 *
+	 * @param   string  $path  A file system path to check.
+	 *
+	 * @return  string  A cleaned version of the path or exit on error.
+	 *
+	 * @throws  Exception
+	 */
+	public function pathCheck($path);
+
+	/**
+	 * Function to strip additional / or \ in a path name.
+	 *
+	 * @param   string  $path  The path to clean.
+	 * @param   string  $ds    Directory separator (optional).
+	 *
+	 * @return  string  The cleaned path.
+	 *
+	 * @throws  UnexpectedValueException
+	 */
+	public function pathClean($path, $ds = DIRECTORY_SEPARATOR);
+
+	/**
+	 * Searches the directory paths for a given file.
+	 *
+	 * @param   mixed   $paths  An path string or array of path strings to search in
+	 * @param   string  $file   The file name to look for.
+	 *
+	 * @return  mixed   The full path and file name for the target file, or boolean false if the file is not found in
+	 *                  any of the paths.
+	 */
+	public function pathFind($paths, $file);
+
+	/**
+	 * Wrapper for the standard file_exists function
+	 *
+	 * @param   string  $path  Folder name relative to installation dir
+	 *
+	 * @return  boolean  True if path is a folder
+	 */
+	public function folderExists($path);
+
+	/**
+	 * Utility function to read the files in a folder.
+	 *
+	 * @param   string   $path           The path of the folder to read.
+	 * @param   string   $filter         A filter for file names.
+	 * @param   mixed    $recurse        True to recursively search into sub-folders, or an integer to specify the
+	 *                                   maximum depth.
+	 * @param   boolean  $full           True to return the full path to the file.
+	 * @param   array    $exclude        Array with names of files which should not be shown in the result.
+	 * @param   array    $excludefilter  Array of filter to exclude
+	 *
+	 * @return  array  Files in the given folder.
+	 */
+	public function folderFiles($path, $filter = '.', $recurse = false, $full = false, $exclude = [
+		'.svn', 'CVS', '.DS_Store', '__MACOSX',
+	],
+	                            $excludefilter = ['^\..*', '.*~']);
+
+	/**
+	 * Utility function to read the folders in a folder.
+	 *
+	 * @param   string   $path           The path of the folder to read.
+	 * @param   string   $filter         A filter for folder names.
+	 * @param   mixed    $recurse        True to recursively search into sub-folders, or an integer to specify the
+	 *                                   maximum depth.
+	 * @param   boolean  $full           True to return the full path to the folders.
+	 * @param   array    $exclude        Array with names of folders which should not be shown in the result.
+	 * @param   array    $excludefilter  Array with regular expressions matching folders which should not be shown in
+	 *                                   the result.
+	 *
+	 * @return  array  Folders in the given folder.
+	 */
+	public function folderFolders($path, $filter = '.', $recurse = false, $full = false, $exclude = [
+		'.svn', 'CVS', '.DS_Store', '__MACOSX',
+	],
+	                              $excludefilter = ['^\..*']);
+
+	/**
+	 * Create a folder -- and all necessary parent folders.
+	 *
+	 * @param   string   $path  A path to create from the base path.
+	 * @param   integer  $mode  Directory permissions to set for folders created. 0755 by default.
+	 *
+	 * @return  boolean  True if successful.
+	 */
+	public function folderCreate($path = '', $mode = 0755);
+
+	/**
+	 * Gets the extension of a file name
+	 *
+	 * @param   string  $file  The file name
+	 *
+	 * @return  string  The file extension
+	 */
+	public function getExt($file);
+
+	/**
+	 * Strips the last extension off of a file name
+	 *
+	 * @param   string  $file  The file name
+	 *
+	 * @return  string  The file name without the extension
+	 */
+	public function stripExt($file);
+}

libraries/fof30/Platform/Joomla/Filesystem.php

@@ -0,0 +1,230 @@
+<?php
+/**
+ * @package   FOF
+ * @copyright Copyright (c)2010-2021 Nicholas K. Dionysopoulos / Akeeba Ltd
+ * @license   GNU General Public License version 2, or later
+ */
+
+namespace FOF30\Platform\Joomla;
+
+defined('_JEXEC') || die;
+
+use Exception;
+use FOF30\Container\Container;
+use FOF30\Platform\Base\Filesystem as BaseFilesystem;
+use JLoader;
+use Joomla\CMS\Filesystem\File;
+use Joomla\CMS\Filesystem\Folder;
+use Joomla\CMS\Filesystem\Path;
+use UnexpectedValueException;
+
+/**
+ * Abstraction for Joomla! filesystem API
+ */
+class Filesystem extends BaseFilesystem
+{
+	/**
+	 * Does the file exists?
+	 *
+	 * @param   $path  string   Path to the file to test
+	 *
+	 * @return  bool
+	 */
+	public function fileExists($path)
+	{
+		return File::exists($path);
+	}
+
+	/**
+	 * Delete a file or array of files
+	 *
+	 * @param   mixed  $file  The file name or an array of file names
+	 *
+	 * @return  boolean  True on success
+	 *
+	 */
+	public function fileDelete($file)
+	{
+		return File::delete($file);
+	}
+
+	/**
+	 * Copies a file
+	 *
+	 * @param   string   $src          The path to the source file
+	 * @param   string   $dest         The path to the destination file
+	 * @param   string   $path         An optional base path to prefix to the file names
+	 * @param   boolean  $use_streams  True to use streams
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function fileCopy($src, $dest, $path = null, $use_streams = false)
+	{
+		return File::copy($src, $dest, $path, $use_streams);
+	}
+
+	/**
+	 * Write contents to a file
+	 *
+	 * @param   string    $file         The full file path
+	 * @param   string   &$buffer       The buffer to write
+	 * @param   boolean   $use_streams  Use streams
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function fileWrite($file, &$buffer, $use_streams = false)
+	{
+		return File::write($file, $buffer, $use_streams);
+	}
+
+	/**
+	 * Checks for snooping outside of the file system root.
+	 *
+	 * @param   string  $path  A file system path to check.
+	 *
+	 * @return  string  A cleaned version of the path or exit on error.
+	 *
+	 * @throws  Exception
+	 */
+	public function pathCheck($path)
+	{
+		return Path::check($path);
+	}
+
+	/**
+	 * Function to strip additional / or \ in a path name.
+	 *
+	 * @param   string  $path  The path to clean.
+	 * @param   string  $ds    Directory separator (optional).
+	 *
+	 * @return  string  The cleaned path.
+	 *
+	 * @throws  UnexpectedValueException
+	 */
+	public function pathClean($path, $ds = DIRECTORY_SEPARATOR)
+	{
+		return Path::clean($path, $ds);
+	}
+
+	/**
+	 * Searches the directory paths for a given file.
+	 *
+	 * @param   mixed   $paths  An path string or array of path strings to search in
+	 * @param   string  $file   The file name to look for.
+	 *
+	 * @return  mixed   The full path and file name for the target file, or boolean false if the file is not found in
+	 *                  any of the paths.
+	 */
+	public function pathFind($paths, $file)
+	{
+		return Path::find($paths, $file);
+	}
+
+	/**
+	 * Wrapper for the standard file_exists function
+	 *
+	 * @param   string  $path  Folder name relative to installation dir
+	 *
+	 * @return  boolean  True if path is a folder
+	 */
+	public function folderExists($path)
+	{
+		try
+		{
+			return Folder::exists($path);
+		}
+		catch (Exception $e)
+		{
+			return false;
+		}
+	}
+
+	/**
+	 * Utility function to read the files in a folder.
+	 *
+	 * @param   string   $path           The path of the folder to read.
+	 * @param   string   $filter         A filter for file names.
+	 * @param   mixed    $recurse        True to recursively search into sub-folders, or an integer to specify the
+	 *                                   maximum depth.
+	 * @param   boolean  $full           True to return the full path to the file.
+	 * @param   array    $exclude        Array with names of files which should not be shown in the result.
+	 * @param   array    $excludefilter  Array of filter to exclude
+	 * @param   boolean  $naturalSort    False for asort, true for natsort
+	 *
+	 * @return  array  Files in the given folder.
+	 */
+	public function folderFiles($path, $filter = '.', $recurse = false, $full = false, $exclude = [
+		'.svn', 'CVS', '.DS_Store', '__MACOSX',
+	],
+	                            $excludefilter = ['^\..*', '.*~'], $naturalSort = false)
+	{
+		// JFolder throws nonsense errors if the path is not a folder
+		try
+		{
+			$path = Path::clean($path);
+		}
+		catch (Exception $e)
+		{
+			return [];
+		}
+
+		if (!@is_dir($path))
+		{
+			return [];
+		}
+
+		// Now call JFolder
+		return Folder::files($path, $filter, $recurse, $full, $exclude, $excludefilter, $naturalSort);
+	}
+
+	/**
+	 * Utility function to read the folders in a folder.
+	 *
+	 * @param   string   $path           The path of the folder to read.
+	 * @param   string   $filter         A filter for folder names.
+	 * @param   mixed    $recurse        True to recursively search into sub-folders, or an integer to specify the
+	 *                                   maximum depth.
+	 * @param   boolean  $full           True to return the full path to the folders.
+	 * @param   array    $exclude        Array with names of folders which should not be shown in the result.
+	 * @param   array    $excludefilter  Array with regular expressions matching folders which should not be shown in
+	 *                                   the result.
+	 *
+	 * @return  array  Folders in the given folder.
+	 */
+	public function folderFolders($path, $filter = '.', $recurse = false, $full = false, $exclude = [
+		'.svn', 'CVS', '.DS_Store', '__MACOSX',
+	],
+	                              $excludefilter = ['^\..*'])
+	{
+		// JFolder throws idiotic errors if the path is not a folder
+		try
+		{
+			$path = Path::clean($path);
+		}
+		catch (Exception $e)
+		{
+			return [];
+		}
+
+		if (!@is_dir($path))
+		{
+			return [];
+		}
+
+		// Now call JFolder
+		return Folder::folders($path, $filter, $recurse, $full, $exclude, $excludefilter);
+	}
+
+	/**
+	 * Create a folder -- and all necessary parent folders.
+	 *
+	 * @param   string   $path  A path to create from the base path.
+	 * @param   integer  $mode  Directory permissions to set for folders created. 0755 by default.
+	 *
+	 * @return  boolean  True if successful.
+	 */
+	public function folderCreate($path = '', $mode = 0755)
+	{
+		return Folder::create($path, $mode);
+	}
+}

libraries/fof30/Platform/PlatformInterface.php

@@ -0,0 +1,553 @@
+<?php
+/**
+ * @package   FOF
+ * @copyright Copyright (c)2010-2021 Nicholas K. Dionysopoulos / Akeeba Ltd
+ * @license   GNU General Public License version 2, or later
+ */
+
+namespace FOF30\Platform;
+
+defined('_JEXEC') || die;
+
+use Exception;
+use FOF30\Container\Container;
+use FOF30\Date\Date;
+use FOF30\Input\Input;
+use JDatabaseDriver;
+use Joomla\CMS\Document\Document;
+use Joomla\CMS\Language\Language;
+use Joomla\CMS\User\User;
+use Joomla\Registry\Registry;
+use JsonSerializable;
+
+/**
+ * Part of the F0F Platform Abstraction Layer. It implements everything that
+ * depends on the platform F0F is running under, e.g. the Joomla! CMS front-end,
+ * the Joomla! CMS back-end, a CLI Joomla! Platform app, a bespoke Joomla!
+ * Platform / Framework web application and so on.
+ */
+interface PlatformInterface
+{
+	/**
+	 * Public constructor.
+	 *
+	 * @param   Container  $c  The component container
+	 */
+	public function __construct(Container $c);
+
+	/**
+	 * Checks if the current script is run inside a valid CMS execution
+	 *
+	 * @return bool
+	 */
+	public function checkExecution();
+
+	/**
+	 * Raises an error, using the logic requested by the CMS (PHP Exception or dedicated class)
+	 *
+	 * @param   integer  $code
+	 * @param   string   $message
+	 *
+	 * @return mixed
+	 */
+	public function raiseError($code, $message);
+
+	/**
+	 * Returns the version number string of the CMS/application we're running in
+	 *
+	 * @return  string
+	 *
+	 * @since  2.1.2
+	 */
+	public function getPlatformVersion();
+
+	/**
+	 * Returns absolute path to directories used by the containing CMS/application.
+	 *
+	 * The return is a table with the following key:
+	 * * root    Path to the site root
+	 * * public  Path to the public area of the site
+	 * * admin   Path to the administrative area of the site
+	 * * tmp     Path to the temp directory
+	 * * log     Path to the log directory
+	 *
+	 * @return  array  A hash array with keys root, public, admin, tmp and log.
+	 */
+	public function getPlatformBaseDirs();
+
+	/**
+	 * Returns the base (root) directories for a given component, i.e the application
+	 * which is running inside our main application (CMS, web app).
+	 *
+	 * The return is a table with the following keys:
+	 * * main    The normal location of component files. For a back-end Joomla!
+	 *          component this is the administrator/components/com_example
+	 *          directory.
+	 * * alt    The alternate location of component files. For a back-end
+	 *          Joomla! component this is the front-end directory, e.g.
+	 *          components/com_example
+	 * * site    The location of the component files serving the public part of
+	 *          the application.
+	 * * admin    The location of the component files serving the administrative
+	 *          part of the application.
+	 *
+	 * All paths MUST be absolute. All four paths MAY be the same if the
+	 * platform doesn't make a distinction between public and private parts,
+	 * or when the component does not provide both a public and private part.
+	 * All of the directories MUST be defined and non-empty.
+	 *
+	 * @param   string  $component  The name of the component. For Joomla! this
+	 *                              is something like "com_example"
+	 *
+	 * @return  array  A hash array with keys main, alt, site and admin.
+	 */
+	public function getComponentBaseDirs($component);
+
+	/**
+	 * Returns the application's template name
+	 *
+	 * @param   boolean|array  $params  An optional associative array of configuration settings
+	 *
+	 * @return  string  The template name. System is the fallback.
+	 */
+	public function getTemplate($params = false);
+
+	/**
+	 * Get application-specific suffixes to use with template paths. This allows
+	 * you to look for view template overrides based on the application version.
+	 *
+	 * @return  array  A plain array of suffixes to try in template names
+	 */
+	public function getTemplateSuffixes();
+
+	/**
+	 * Return the absolute path to the application's template overrides
+	 * directory for a specific component. We will use it to look for template
+	 * files instead of the regular component directories. If the application
+	 * does not have such a thing as template overrides return an empty string.
+	 *
+	 * @param   string   $component  The name of the component for which to fetch the overrides
+	 * @param   boolean  $absolute   Should I return an absolute or relative path?
+	 *
+	 * @return  string  The path to the template overrides directory
+	 */
+	public function getTemplateOverridePath($component, $absolute = true);
+
+	/**
+	 * Load the translation files for a given component.
+	 *
+	 * @param   string  $component  The name of the component. For Joomla! this
+	 *                              is something like "com_example"
+	 *
+	 * @return  void
+	 */
+	public function loadTranslations($component);
+
+	/**
+	 * By default FOF will only use the Controller's onBefore* methods to
+	 * perform user authorisation. In some cases, like the Joomla! back-end,
+	 * you also need to perform component-wide user authorisation in the
+	 * Dispatcher. This method MUST implement this authorisation check. If you
+	 * do not need this in your platform, please always return true.
+	 *
+	 * @param   string  $component  The name of the component.
+	 *
+	 * @return  boolean  True to allow loading the component, false to halt loading
+	 */
+	public function authorizeAdmin($component);
+
+	/**
+	 * This method will try retrieving a variable from the request (input) data.
+	 * If it doesn't exist it will be loaded from the user state, typically
+	 * stored in the session. If it doesn't exist there either, the $default
+	 * value will be used. If $setUserState is set to true, the retrieved
+	 * variable will be stored in the user session.
+	 *
+	 * @param   string   $key           The user state key for the variable
+	 * @param   string   $request       The request variable name for the variable
+	 * @param   Input    $input         The Input object with the request (input) data
+	 * @param   mixed    $default       The default value. Default: null
+	 * @param   string   $type          The filter type for the variable data. Default: none (no filtering)
+	 * @param   boolean  $setUserState  Should I set the user state with the fetched value?
+	 *
+	 * @return  mixed  The value of the variable
+	 */
+	public function getUserStateFromRequest($key, $request, $input, $default = null, $type = 'none', $setUserState = true);
+
+	/**
+	 * Load plugins of a specific type. Obviously this seems to only be required
+	 * in the Joomla! CMS itself.
+	 *
+	 * @param   string  $type  The type of the plugins to be loaded
+	 *
+	 * @return void
+	 */
+	public function importPlugin($type);
+
+	/**
+	 * Execute plugins (system-level triggers) and fetch back an array with
+	 * their return values.
+	 *
+	 * @param   string  $event  The event (trigger) name, e.g. onBeforeScratchMyEar
+	 * @param   array   $data   A hash array of data sent to the plugins as part of the trigger
+	 *
+	 * @return  array  A simple array containing the results of the plugins triggered
+	 */
+	public function runPlugins($event, $data);
+
+	/**
+	 * Perform an ACL check. Please note that FOF uses by default the Joomla!
+	 * CMS convention for ACL privileges, e.g core.edit for the edit privilege.
+	 * If your platform uses different conventions you'll have to override the
+	 * F0F defaults using fof.xml or by specialising the controller.
+	 *
+	 * @param   string  $action     The ACL privilege to check, e.g. core.edit
+	 * @param   string  $assetname  The asset name to check, typically the component's name
+	 *
+	 * @return  boolean  True if the user is allowed this action
+	 */
+	public function authorise($action, $assetname);
+
+	/**
+	 * Returns a user object.
+	 *
+	 * @param   integer  $id  The user ID to load. Skip or use null to retrieve
+	 *                        the object for the currently logged in user.
+	 *
+	 * @return  User  The \JUser object for the specified user
+	 */
+	public function getUser($id = null);
+
+	/**
+	 * Returns the \JDocument object which handles this component's response. You
+	 * may also return null and FOF will a. try to figure out the output type by
+	 * examining the "format" input parameter (or fall back to "html") and b.
+	 * FOF will not attempt to load CSS and Javascript files (as it doesn't make
+	 * sense if there's no \JDocument to handle them).
+	 *
+	 * @return  Document
+	 */
+	public function getDocument();
+
+	/**
+	 * Returns an object to handle dates
+	 *
+	 * @param   mixed  $time      The initial time
+	 * @param   null   $tzOffest  The timezone offset
+	 * @param   bool   $locale    Should I try to load a specific class for current language?
+	 *
+	 * @return  Date object
+	 */
+	public function getDate($time = 'now', $tzOffest = null, $locale = true);
+
+	/**
+	 * Return the \JLanguage instance of the CMS/application
+	 *
+	 * @return Language
+	 */
+	public function getLanguage();
+
+	/**
+	 * Returns the database driver object of the CMS/application
+	 *
+	 * @return JDatabaseDriver
+	 */
+	public function getDbo();
+
+	/**
+	 * Is this the administrative section of the component?
+	 *
+	 * @return  boolean
+	 */
+	public function isBackend();
+
+	/**
+	 * Is this the public section of the component?
+	 *
+	 * @return  boolean
+	 */
+	public function isFrontend();
+
+	/**
+	 * Is this the Joomla 4 API application?
+	 *
+	 * @return  boolean
+	 */
+	public function isApi();
+
+	/**
+	 * Is this a component running in a CLI application?
+	 *
+	 * @return  boolean
+	 */
+	public function isCli();
+
+	/**
+	 * Is AJAX re-ordering supported? This is 100% Joomla! CMS (version 3+) specific.
+	 *
+	 * @return  boolean
+	 */
+	public function supportsAjaxOrdering();
+
+	/**
+	 * Saves something to the cache. This is supposed to be used for system-wide
+	 * FOF data, not application data.
+	 *
+	 * @param   string  $key      The key of the data to save
+	 * @param   string  $content  The actual data to save
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function setCache($key, $content);
+
+	/**
+	 * Retrieves data from the cache. This is supposed to be used for system-side
+	 * FOF data, not application data.
+	 *
+	 * @param   string  $key      The key of the data to retrieve
+	 * @param   string  $default  The default value to return if the key is not found or the cache is not populated
+	 *
+	 * @return  string  The cached value
+	 */
+	public function getCache($key, $default = null);
+
+	/**
+	 * Clears the cache of system-wide FOF data. You are supposed to call this in
+	 * your components' installation script post-installation and post-upgrade
+	 * methods or whenever you are modifying the structure of database tables
+	 * accessed by F0F. Please note that FOF's cache never expires and is not
+	 * purged by Joomla!. You MUST use this method to manually purge the cache.
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function clearCache();
+
+	/**
+	 * Returns an object that holds the configuration of the current site.
+	 *
+	 * @return  Registry
+	 */
+	public function getConfig();
+
+	/**
+	 * Is the global FOF cache enabled?
+	 *
+	 * @return  boolean
+	 */
+	public function isGlobalFOFCacheEnabled();
+
+	/**
+	 * logs in a user
+	 *
+	 * @param   array  $authInfo  Authentication information
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function loginUser($authInfo);
+
+	/**
+	 * logs out a user
+	 *
+	 * @return  boolean  True on success
+	 */
+	public function logoutUser();
+
+	/**
+	 * Add a log file for FOF
+	 *
+	 * @param   string  $file
+	 *
+	 * @return  void
+	 */
+	public function logAddLogger($file);
+
+	/**
+	 * Logs a deprecated practice. In Joomla! this results in the $message being output in the
+	 * deprecated log file, found in your site's log directory.
+	 *
+	 * @param   string  $message  The deprecated practice log message
+	 *
+	 * @return  void
+	 */
+	public function logDeprecated($message);
+
+	/**
+	 * Adds a message to the application's debug log
+	 *
+	 * @param   string  $message
+	 *
+	 * @return  void
+	 */
+	public function logDebug($message);
+
+	/**
+	 * Adds a message
+	 *
+	 * @param   string|array  $title      A title, or an array of additional fields to add to the log entry
+	 * @param   string        $logText    The translation key to the log text
+	 * @param   string        $extension  The name of the extension logging this entry
+	 * @param   User|null     $user       The user the action is being logged for
+	 *
+	 * @return  void
+	 */
+	public function logUserAction($title, $logText, $extension, $user = null);
+
+	/**
+	 * Returns the root URI for the request.
+	 *
+	 * @param   boolean  $pathonly  If false, prepend the scheme, host and port information. Default is false.
+	 * @param   string   $path      The path
+	 *
+	 * @return  string  The root URI string.
+	 */
+	public function URIroot($pathonly = false, $path = null);
+
+	/**
+	 * Returns the base URI for the request.
+	 *
+	 * @param   boolean  $pathonly  If false, prepend the scheme, host and port information. Default is false.
+	 *                              |
+	 *
+	 * @return  string  The base URI string
+	 */
+	public function URIbase($pathonly = false);
+
+	/**
+	 * Method to set a response header.  If the replace flag is set then all headers
+	 * with the given name will be replaced by the new one (only if the current platform supports header caching)
+	 *
+	 * @param   string   $name     The name of the header to set.
+	 * @param   string   $value    The value of the header to set.
+	 * @param   boolean  $replace  True to replace any headers with the same name.
+	 *
+	 * @return  void
+	 */
+	public function setHeader($name, $value, $replace = false);
+
+	/**
+	 * In platforms that perform header caching, send all headers.
+	 *
+	 * @return  void
+	 */
+	public function sendHeaders();
+
+	/**
+	 * Immediately terminate the containing application's execution
+	 *
+	 * @param   int  $code  The result code which should be returned by the application
+	 *
+	 * @return  void
+	 */
+	public function closeApplication($code = 0);
+
+	/**
+	 * Perform a redirection to a different page, optionally enqueuing a message for the user.
+	 *
+	 * @param   string  $url     The URL to redirect to
+	 * @param   int     $status  (optional) The HTTP redirection status code, default 301
+	 * @param   string  $msg     (optional) A message to enqueue
+	 * @param   string  $type    (optional) The message type, e.g. 'message' (default), 'warning' or 'error'.
+	 *
+	 * @return  void
+	 *
+	 * @throws  Exception
+	 */
+	public function redirect($url, $status = 301, $msg = null, $type = 'message');
+
+	/**
+	 * Handle an exception in a way that results to an error page.
+	 *
+	 * @param   Exception  $exception  The exception to handle
+	 *
+	 * @throws  Exception  Possibly rethrown exception
+	 */
+	public function showErrorPage(Exception $exception);
+
+	/**
+	 * Set a variable in the user session
+	 *
+	 * @param   string  $name       The name of the variable to set
+	 * @param   string  $value      (optional) The value to set it to, default is null
+	 * @param   string  $namespace  (optional) The variable's namespace e.g. the component name. Default: 'default'
+	 *
+	 * @return  void
+	 */
+	public function setSessionVar($name, $value = null, $namespace = 'default');
+
+	/**
+	 * Get a variable from the user session
+	 *
+	 * @param   string  $name       The name of the variable to set
+	 * @param   string  $default    (optional) The default value to return if the variable does not exit, default: null
+	 * @param   string  $namespace  (optional) The variable's namespace e.g. the component name. Default: 'default'
+	 *
+	 * @return  mixed
+	 */
+	public function getSessionVar($name, $default = null, $namespace = 'default');
+
+	/**
+	 * Unset a variable from the user session
+	 *
+	 * @param   string  $name       The name of the variable to unset
+	 * @param   string  $namespace  (optional) The variable's namespace e.g. the component name. Default: 'default'
+	 *
+	 * @return  void
+	 */
+	public function unsetSessionVar($name, $namespace = 'default');
+
+	/**
+	 * Return the session token. Two types of tokens can be returned:
+	 *
+	 * Session token ($formToken == false): Used for anti-spam protection of forms. This is specific to a session
+	 *   object.
+	 *
+	 * Form token ($formToken == true): A secure hash of the user ID with the session token. Both the session and the
+	 *   user are fetched from the application container.
+	 *
+	 * @param   bool  $formToken  Should I return a form token?
+	 * @param   bool  $forceNew   Should I force the creation of a new token?
+	 *
+	 * @return  mixed
+	 */
+	public function getToken($formToken = false, $forceNew = false);
+
+	/**
+	 * Are plugins allowed to run in CLI mode?
+	 *
+	 * @return  bool
+	 */
+	public function isAllowPluginsInCli();
+
+	/**
+	 * Set whether plugins are allowed to run in CLI mode
+	 *
+	 * @param   bool  $allowPluginsInCli
+	 */
+	public function setAllowPluginsInCli($allowPluginsInCli);
+
+	/**
+	 * Set a script option.
+	 *
+	 * This allows the backend code to set up configuration options for frontend (JavaScript) code in a way that's safe
+	 * for async / deferred scripts. The options are stored in the document's head as an inline JSON document. This
+	 * JSON document is then parsed by a JavaScript helper function which makes the options available to the scripts
+	 * that consume them.
+	 *
+	 * @param   string                  $key     The option key
+	 * @param   mixed|JsonSerializable  $value   The option value. Must be a scalar or a JSON serializable object
+	 * @param   bool                    $merge   Should I merge an array value with existing stored values? Default:
+	 *                                           true
+	 *
+	 * @return  void
+	 */
+	public function addScriptOptions($key, $value, $merge = true);
+
+	/**
+	 * Get a script option, or all of the script options
+	 *
+	 * @param   string|null  $key  The script option to retrieve. Null for all options.
+	 *
+	 * @return  array|mixed  Options for given $key, or all script options
+	 */
+	public function getScriptOptions($key = null);
+}