PK \R}V src/View/Api/JsonView.phpnu [ data instanceof \Throwable)
{
$result = [
'status' => 200,
'data' => $this->data,
];
}
else
{
$result = [
'status' => $this->data->getCode(),
'data' => $this->data->getMessage(),
];
// When site debugging is enabled AND error reporting is set to maximum we'll return exception traces
$app = Factory::getApplication();
$siteDebug = (bool) $app->get('debug');
$maxErrorReporting = $app->get('error_reporting') === 'maximum';
if ($siteDebug && $maxErrorReporting)
{
$result['debug'] = [];
$thisException = $this->data;
while (!empty($thisException))
{
$result['debug'][] = [
'message' => $thisException->getMessage(),
'code' => $thisException->getCode(),
'file' => $thisException->getFile(),
'line' => $thisException->getLine(),
'backtrace' => $thisException->getTrace(),
];
$thisException = $this->data->getPrevious();
}
}
}
$this->getDocument()->setBuffer(json_encode($result));
echo $this->getDocument()->render();
}
}PK \Sʉ src/View/Api/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ src/View/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ src/Controller/ApiController.phpnu [ getMyView();
try
{
$this->akeebaEngineInitialisation();
$this->authenticate();
$method = $this->input->get('method');
$data = $this->getRequestData();
$this->taskHandler = Task::getInstance($this->factory);
$view->data = $this->taskHandler->execute($method, $data);
}
catch (Throwable $e)
{
$view->data = $e;
}
$view->display();
return $this;
}
/**
* Get the request data as an array
*
* @return array
* @since 9.6.0
*/
protected function getRequestData(): array
{
switch ($this->input->getMethod() ?? 'GET')
{
case 'GET':
$input = $this->input->get;
break;
default:
case 'POST':
$input = $this->input->post;
break;
}
$cleanedData = $input->getArray();
$data = [];
foreach ($cleanedData as $key => $value)
{
if (is_array($value))
{
$data[$key] = $input->get($key, [], 'array');
}
else
{
$data[$key] = $input->get($key, null, 'raw');
}
}
return $data;
}
/**
* Get the BackupApi view object
*
* @return JsonView
* @since 9.6.0
*/
protected function getMyView(): JsonView
{
static $view;
if (empty($view))
{
$viewType = $this->app->getDocument()->getType();
$viewName = $this->input->get('view', $this->default_view);
$viewLayout = $this->input->get('layout', 'default', 'string');
try
{
$view = $this->getView(
$viewName,
$viewType,
'',
['base_path' => $this->basePath, 'layout' => $viewLayout, 'contentType' => $this->contentType]
);
}
catch (\Exception $e)
{
throw new RuntimeException($e->getMessage());
}
$view->document = $this->app->getDocument();
}
return $view;
}
/**
* Verifies the Secret Key (API token)
*
* @return bool
* @since 7.4.0
*/
private function verifyKey(): bool
{
$cParams = ComponentHelper::getParams('com_akeebabackup');
// Is the JSON API enabled?
if ($cParams->get('jsonapi_enabled', 0) != 1)
{
return false;
}
// Is the key secure enough?
$validKey = $this->serverKey();
if (empty($validKey) || empty(trim($validKey)) || !Complexify::isStrongEnough($validKey, false))
{
return false;
}
/**
* Get the API authentication token. There are two sources
* 1. X-Akeeba-Auth header (preferred, overrides all others)
* 2. the _akeebaAuth GET parameter
*/
$authSource = $this->input->server->getString('HTTP_X_AKEEBA_AUTH', null);
if (is_null($authSource))
{
$authSource = $this->input->get->getString('_akeebaAuth', null);
}
// No authentication token? No joy.
if (empty($authSource) || !is_string($authSource) || empty(trim($authSource)))
{
return false;
}
return hash_equals($validKey, $authSource);
}
/**
* Get the server key, i.e. the Secret Word for the front-end backups and JSON API
*
* @return mixed
*
* @since 7.4.0
*/
private function serverKey()
{
if (is_null($this->key))
{
$this->key = Platform::getInstance()->get_platform_configuration_option('frontend_secret_word', '');
}
return $this->key;
}
/**
* Initialises the Akeeba Engine
*
* @return void
* @since 9.6.0
*/
private function akeebaEngineInitialisation(): void
{
$this->loadAkeebaEngine();
Platform::getInstance()->load_version_defines();
if (!defined('AKEEBA_BACKUP_ORIGIN'))
{
define('AKEEBA_BACKUP_ORIGIN', 'json');
}
}
/**
* Performs user authentication
*
* @return void
* @since 9.6.0
*/
private function authenticate(): void
{
// API v3 authentication: only Joomla API authentication
if (
$this->input->getInt('_apiVersion', 0) == 3
&& !$this->app->login(['username' => ''], ['silent' => true, 'action' => 'core.login.api'])
)
{
throw new RuntimeException('Access denied', 503);
}
// API v2 authentication: Akeeba Backup Secret Key _or_ Joomla API authentication
if (
!$this->verifyKey()
&& !$this->protectedLogin(['username' => ''], ['silent' => true, 'action' => 'core.login.api'])
)
{
throw new RuntimeException('Access denied', 503);
}
}
/**
* Login a user without trigger the login failure plugins.
*
* @param array $credentials Array('username' => string, 'password' => string)
* @param array $options Array('remember' => boolean)
*
* @return boolean|\Exception True on success, false if failed or silent handling is configured, or a \Exception object on authentication error.
*
* @since 9.6.0
*/
private function protectedLogin($credentials, $options = [])
{
$app = $this->app;
// Get the global Authentication object.
$authenticate = Authentication::getInstance('api-authentication');
$response = $authenticate->authenticate($credentials, $options);
// Import the user plugin group.
PluginHelper::importPlugin('user');
if ($response->status === Authentication::STATUS_SUCCESS) {
/*
* Validate that the user should be able to log in (different to being authenticated).
* This permits authentication plugins blocking the user.
*/
$authorisations = $authenticate->authorise($response, $options);
$denied_states = Authentication::STATUS_EXPIRED | Authentication::STATUS_DENIED;
foreach ($authorisations as $authorisation) {
if ((int) $authorisation->status & $denied_states) {
// If silent is set, just return false.
return false;
}
}
// OK, the credentials are authenticated and user is authorised. Let's fire the onLogin event.
$results = $this->triggerPluginEvent('onUserLogin', [(array) $response, $options]);
/*
* If any of the user plugins did not successfully complete the login routine
* then the whole method fails.
*
* Any errors raised should be done in the plugin as this provides the ability
* to provide much more information about why the routine may have failed.
*/
$user = Factory::getApplication()->getIdentity();
if ($response->type === 'Cookie')
{
if (method_exists($user, 'set'))
{
/** @noinspection PhpDeprecationInspection */
$user->set('cookieLogin', true);
}
else
{
$user->cookieLogin = true;
}
}
if (\in_array(false, $results, true) == false) {
$options['user'] = $user;
$options['responseType'] = $response->type;
// The user is successfully logged in. Run the after login events
$this->triggerPluginEvent('onUserAfterLogin', [$options]);
return true;
}
}
return false;
}
}PK \Sʉ src/Controller/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ
src/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ .htaccessnu 7m
Order allow,deny
Deny from all
PK \Ď{8 {8
config.xmlnu [
PK \yo< < version.phpnu [
Order allow,deny
Deny from all
PK \s $ sql/updates/mysql/9.4.0-20221011.sqlnu [ /**
* @package akeebabackup
* @copyright Copyright 2006-2026 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
ALTER TABLE `#__akeebabackup_profiles` ADD COLUMN `access` INT(11) DEFAULT '1';
PK \%0 0 % sql/updates/mysql/9.0.10-20211130.sqlnu [ /**
* @package akeebabackup
* @copyright Copyright 2006-2026 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
ALTER TABLE `#__akeebabackup_profiles` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE `#__akeebabackup_backups` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE `#__akeebabackup_storage` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE `#__akeeba_common` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
PK \!k ) sql/updates/mysql/9.0.0-20210321-1958.sqlnu [ /**
* @package akeebabackup
* @copyright Copyright 2006-2026 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
-- No operationPK \Sʉ sql/updates/mysql/.htaccessnu 7m
Order allow,deny
Deny from all
PK \m ) sql/updates/mysql/9.0.9-20211117-2054.sqlnu [ /**
* @package akeebabackup
* @copyright Copyright 2006-2026 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
-- Ensure the correct character set and collation for all tables and columns
-- Note: this update was made obsolete by the 9.0.10 update. Therefore its contents are removed to prevent Joomla from
-- tripping over its feet...PK \Sʉ sql/updates/.htaccessnu 7m
Order allow,deny
Deny from all
PK \}; ; ! sql/uninstall.postgresql.utf8.sqlnu [ /**
* @package akeebabackup
* @copyright Copyright 2006-2026 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
DROP TABLE IF EXISTS "#__akeebabackup_profiles";
DROP TABLE IF EXISTS "#__akeebabackup_backups";
DROP TABLE IF EXISTS "#__akeebabackup_storage";
PK \|N sql/web.confignu [
PK \Sʉ
sql/.htaccessnu 7m
Order allow,deny
Deny from all
PK \h
CHANGELOG.phpnu [ Akeeba Backup 10.3.6
================================================================================
+ Site Transfer Wizard: transfer any backup archive present on the server, not just the latest one (gh-36)
# [LOW] Site Transfer Wizard: Dark mode layout issues (white-on-white in upload stats area)
# [HIGH] Box, Dropbox, OneDrive stored files under the local temp name
# [HIGH] Uploads failed when using a bucket-restricted BackBlaze B2 key
# [MEDIUM] Box, Dropbox, Google Drive, OneDrive token refresh raced expiry
# [MEDIUM] RackSpace CloudFiles validated the username, not the API key
# [MEDIUM] Dropbox public download URL embedded the access token
# [MEDIUM] OneDrive for Business signed download URL was broken on Graph
# [MEDIUM] S3 v4 pre-signed URLs failed (403) on path-style non-AWS hosts
# [MEDIUM] Google Storage pre-signed URLs duplicated the bucket name (403)
# [LOW] Box folder listing paginated incorrectly
# [LOW] BackBlaze cancelUpload sent the request body as form-data, not JSON
# [LOW] BackBlaze downloadFileById used the wrong API path (404)
# [LOW] WebDAV options() dropped capabilities from repeated DAV headers
Akeeba Backup 10.3.5
================================================================================
+ Translations for Greek (el-GR), French (fr-FR), German (de-DE), Spanish (es-ES), Portuguese (pt-PT), and Italian (it-IT)
~ Switched to BackBlaze B2 v4 API
~ Obfuscate kickstart.txt so that broken file scanners (OVH) don't cause problems by misidentifying it as "malicious"
# [HIGH] The Site Transfer Wizard was not working
# [HIGH] DirectFTP would not work due to setting erroneous directory permissions
Akeeba Backup 10.3.4
================================================================================
# [LOW] Configuration page: Count Quota value not saved when using spinner arrows or when saving without first clicking outside the custom value field
# [MEDIUM] Fix stdClass warning when reading akeeba.quota.logfiles configuration key
Akeeba Backup 10.3.3
================================================================================
+ Add "Delete obsolete log files" quota feature
~ Manage Backups: the View Log button is now disabled with a tooltip when the log file no longer exists on the server
# [MEDIUM] Configuration page: saving an SFTP password containing an angle bracket (e.g. `|'),
['*' => '.*', '?' => '.?']) . '$/i', $string
);
}
}
// Unicode-safe binary data length function
if (!function_exists('akstringlen'))
{
if (function_exists('mb_strlen'))
{
function akstringlen($string)
{
return mb_strlen($string, '8bit');
}
}
else
{
function akstringlen($string)
{
return strlen($string);
}
}
}
if (!function_exists('aksubstr'))
{
if (function_exists('mb_strlen'))
{
function aksubstr($string, $start, $length = null)
{
return mb_substr($string, $start, $length, '8bit');
}
}
else
{
function aksubstr($string, $start, $length = null)
{
return substr($string, $start, $length);
}
}
}
/**
* Gets a query parameter from GET or POST data
*
* @param $key
* @param $default
*/
function getQueryParam($key, $default = null)
{
$value = $default;
if (array_key_exists($key, $_REQUEST))
{
$value = $_REQUEST[$key];
}
return $value;
}
// Debugging function
function debugMsg($msg)
{
if (!defined('KSDEBUG'))
{
return;
}
$fp = fopen('debug.txt', 'a');
fwrite($fp, $msg . PHP_EOL);
fclose($fp);
// Echo to stdout if KSDEBUGCLI is defined
if (defined('KSDEBUGCLI'))
{
echo $msg . "\n";
}
}
/**
* Invalidate a file in OPcache.
*
* Only applies if the file has a .php extension.
*
* @param string $file The filepath to clear from OPcache
*
* @return boolean
* @since 7.1.0
*/
function clearFileInOPCache($file)
{
static $hasOpCache = null;
if (is_null($hasOpCache))
{
$hasOpCache = ini_get('opcache.enable')
&& function_exists('opcache_invalidate')
&& (!ini_get('opcache.restrict_api') || stripos(realpath($_SERVER['SCRIPT_FILENAME']), ini_get('opcache.restrict_api')) === 0);
}
if ($hasOpCache && (strtolower(substr($file, -4)) === '.php'))
{
return opcache_invalidate($file, true);
}
return false;
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* The base class of Akeeba Engine objects. Allows for error and warnings logging
* and propagation. Largely based on the Joomla! 1.5 JObject class.
*/
abstract class AKAbstractObject
{
/** @var array The queue size of the $_errors array. Set to 0 for infinite size. */
protected $_errors_queue_size = 0;
/** @var array The queue size of the $_warnings array. Set to 0 for infinite size. */
protected $_warnings_queue_size = 0;
/** @var array An array of errors */
private $_errors = [];
/** @var array An array of warnings */
private $_warnings = [];
/**
* Get the most recent error message
*
* @param integer $i Optional error index
*
* @return string Error message
*/
public function getError($i = null)
{
return $this->getItemFromArray($this->_errors, $i);
}
/**
* Returns the last item of a LIFO string message queue, or a specific item
* if so specified.
*
* @param array $array An array of strings, holding messages
* @param int $i Optional message index
*
* @return mixed The message string, or false if the key doesn't exist
*/
private function getItemFromArray($array, $i = null)
{
// Find the item
if ($i === null)
{
// Default, return the last item
$item = end($array);
}
else if (!array_key_exists($i, $array))
{
// If $i has been specified but does not exist, return false
return false;
}
else
{
$item = $array[$i];
}
return $item;
}
/**
* Return all errors, if any
*
* @return array Array of error messages
*/
public function getErrors()
{
return $this->_errors;
}
/**
* Resets all error messages
*/
public function resetErrors()
{
$this->_errors = [];
}
/**
* Get the most recent warning message
*
* @param integer $i Optional warning index
*
* @return string Error message
*/
public function getWarning($i = null)
{
return $this->getItemFromArray($this->_warnings, $i);
}
/**
* Return all warnings, if any
*
* @return array Array of error messages
*/
public function getWarnings()
{
return $this->_warnings;
}
/**
* Resets all warning messages
*/
public function resetWarnings()
{
$this->_warnings = [];
}
/**
* Propagates errors and warnings to a foreign object. The foreign object SHOULD
* implement the setError() and/or setWarning() methods but DOESN'T HAVE TO be of
* AKAbstractObject type. For example, this can even be used to propagate to a
* JObject instance in Joomla!. Propagated items will be removed from ourselves.
*
* @param object $object The object to propagate errors and warnings to.
*/
public function propagateToObject(&$object)
{
// Skip non-objects
if (!is_object($object))
{
return;
}
if (method_exists($object, 'setError'))
{
if (!empty($this->_errors))
{
foreach ($this->_errors as $error)
{
$object->setError($error);
}
$this->_errors = [];
}
}
if (method_exists($object, 'setWarning'))
{
if (!empty($this->_warnings))
{
foreach ($this->_warnings as $warning)
{
$object->setWarning($warning);
}
$this->_warnings = [];
}
}
}
/**
* Propagates errors and warnings from a foreign object. Each propagated list is
* then cleared on the foreign object, as long as it implements resetErrors() and/or
* resetWarnings() methods.
*
* @param object $object The object to propagate errors and warnings from
*/
public function propagateFromObject(&$object)
{
if (method_exists($object, 'getErrors'))
{
$errors = $object->getErrors();
if (!empty($errors))
{
foreach ($errors as $error)
{
$this->setError($error);
}
}
if (method_exists($object, 'resetErrors'))
{
$object->resetErrors();
}
}
if (method_exists($object, 'getWarnings'))
{
$warnings = $object->getWarnings();
if (!empty($warnings))
{
foreach ($warnings as $warning)
{
$this->setWarning($warning);
}
}
if (method_exists($object, 'resetWarnings'))
{
$object->resetWarnings();
}
}
}
/**
* Add an error message
*
* @param string $error Error message
*/
public function setError($error)
{
if ($this->_errors_queue_size > 0)
{
if (count($this->_errors) >= $this->_errors_queue_size)
{
array_shift($this->_errors);
}
}
$this->_errors[] = $error;
}
/**
* Add an error message
*
* @param string $error Error message
*/
public function setWarning($warning)
{
if ($this->_warnings_queue_size > 0)
{
if (count($this->_warnings) >= $this->_warnings_queue_size)
{
array_shift($this->_warnings);
}
}
$this->_warnings[] = $warning;
}
/**
* Sets the size of the error queue (acts like a LIFO buffer)
*
* @param int $newSize The new queue size. Set to 0 for infinite length.
*/
protected function setErrorsQueueSize($newSize = 0)
{
$this->_errors_queue_size = (int) $newSize;
}
/**
* Sets the size of the warnings queue (acts like a LIFO buffer)
*
* @param int $newSize The new queue size. Set to 0 for infinite length.
*/
protected function setWarningsQueueSize($newSize = 0)
{
$this->_warnings_queue_size = (int) $newSize;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* The superclass of all Akeeba Kickstart parts. The "parts" are intelligent stateful
* classes which perform a single procedure and have preparation, running and
* finalization phases. The transition between phases is handled automatically by
* this superclass' tick() final public method, which should be the ONLY public API
* exposed to the rest of the Akeeba Engine.
*/
abstract class AKAbstractPart extends AKAbstractObject
{
/**
* Indicates whether this part has finished its initialisation cycle
*
* @var boolean
*/
protected $isPrepared = false;
/**
* Indicates whether this part has more work to do (it's in running state)
*
* @var boolean
*/
protected $isRunning = false;
/**
* Indicates whether this part has finished its finalization cycle
*
* @var boolean
*/
protected $isFinished = false;
/**
* Indicates whether this part has finished its run cycle
*
* @var boolean
*/
protected $hasRun = false;
/**
* The name of the engine part (a.k.a. Domain), used in return table
* generation.
*
* @var string
*/
protected $active_domain = "";
/**
* The step this engine part is in. Used verbatim in return table and
* should be set by the code in the _run() method.
*
* @var string
*/
protected $active_step = "";
/**
* A more detailed description of the step this engine part is in. Used
* verbatim in return table and should be set by the code in the _run()
* method.
*
* @var string
*/
protected $active_substep = "";
/**
* Any configuration variables, in the form of an array.
*
* @var array
*/
protected $_parametersArray = [];
/** @var string The database root key */
protected $databaseRoot = [];
/** @var array An array of observers */
protected $observers = [];
/** @var int Last reported warnings's position in array */
private $warnings_pointer = -1;
/**
* The public interface to an engine part. This method takes care for
* calling the correct method in order to perform the initialisation -
* run - finalisation cycle of operation and return a proper response array.
*
* @return array A Response Array
*/
final public function tick()
{
// Call the right action method, depending on engine part state
switch ($this->getState())
{
case "init":
$this->_prepare();
break;
case "prepared":
$this->_run();
break;
case "running":
$this->_run();
break;
case "postrun":
$this->_finalize();
break;
}
// Send a Return Table back to the caller
$out = $this->_makeReturnTable();
return $out;
}
/**
* Returns the state of this engine part.
*
* @return string The state of this engine part. It can be one of
* error, init, prepared, running, postrun, finished.
*/
final public function getState()
{
if ($this->getError())
{
return "error";
}
if (!($this->isPrepared))
{
return "init";
}
if (!($this->isFinished) && !($this->isRunning) && !($this->hasRun) && ($this->isPrepared))
{
return "prepared";
}
if (!($this->isFinished) && $this->isRunning && !($this->hasRun))
{
return "running";
}
if (!($this->isFinished) && !($this->isRunning) && $this->hasRun)
{
return "postrun";
}
if ($this->isFinished)
{
return "finished";
}
}
/**
* Runs the preparation for this part. Should set _isPrepared
* to true
*/
abstract protected function _prepare();
/**
* Runs the main functionality loop for this part. Upon calling,
* should set the _isRunning to true. When it finished, should set
* the _hasRan to true. If an error is encountered, setError should
* be used.
*/
abstract protected function _run();
/**
* Runs the finalisation process for this part. Should set
* _isFinished to true.
*/
abstract protected function _finalize();
/**
* Constructs a Response Array based on the engine part's state.
*
* @return array The Response Array for the current state
*/
final protected function _makeReturnTable()
{
// Get a list of warnings
$warnings = $this->getWarnings();
// Report only new warnings if there is no warnings queue size
if ($this->_warnings_queue_size == 0)
{
if (($this->warnings_pointer > 0) && ($this->warnings_pointer < (count($warnings))))
{
$warnings = array_slice($warnings, $this->warnings_pointer + 1);
$this->warnings_pointer += count($warnings);
}
else
{
$this->warnings_pointer = count($warnings);
}
}
$out = [
'HasRun' => (!($this->isFinished)),
'Domain' => $this->active_domain,
'Step' => $this->active_step,
'Substep' => $this->active_substep,
'Error' => $this->getError(),
'Warnings' => $warnings
];
return $out;
}
/**
* Returns a copy of the class's status array
*
* @return array
*/
public function getStatusArray()
{
return $this->_makeReturnTable();
}
/**
* Sends any kind of setup information to the engine part. Using this,
* we avoid passing parameters to the constructor of the class. These
* parameters should be passed as an indexed array and should be taken
* into account during the preparation process only. This function will
* set the error flag if it's called after the engine part is prepared.
*
* @param array $parametersArray The parameters to be passed to the
* engine part.
*/
final public function setup($parametersArray)
{
if ($this->isPrepared)
{
$this->setState('error', "Can't modify configuration after the preparation of " . $this->active_domain);
}
else
{
$this->_parametersArray = $parametersArray;
if (array_key_exists('root', $parametersArray))
{
$this->databaseRoot = $parametersArray['root'];
}
}
}
/**
* Sets the engine part's internal state, in an easy to use manner
*
* @param string $state One of init, prepared, running, postrun, finished, error
* @param string $errorMessage The reported error message, should the state be set to error
*/
protected function setState($state = 'init', $errorMessage = 'Invalid setState argument')
{
switch ($state)
{
case 'init':
$this->isPrepared = false;
$this->isRunning = false;
$this->isFinished = false;
$this->hasRun = false;
break;
case 'prepared':
$this->isPrepared = true;
$this->isRunning = false;
$this->isFinished = false;
$this->hasRun = false;
break;
case 'running':
$this->isPrepared = true;
$this->isRunning = true;
$this->isFinished = false;
$this->hasRun = false;
break;
case 'postrun':
$this->isPrepared = true;
$this->isRunning = false;
$this->isFinished = false;
$this->hasRun = true;
break;
case 'finished':
$this->isPrepared = true;
$this->isRunning = false;
$this->isFinished = true;
$this->hasRun = false;
break;
case 'error':
default:
$this->setError($errorMessage);
break;
}
}
final public function getDomain()
{
return $this->active_domain;
}
final public function getStep()
{
return $this->active_step;
}
final public function getSubstep()
{
return $this->active_substep;
}
/**
* Attaches an observer object
*
* @param AKAbstractPartObserver $obs
*/
function attach(AKAbstractPartObserver $obs)
{
$this->observers["$obs"] = $obs;
}
/**
* Detaches an observer object
*
* @param AKAbstractPartObserver $obs
*/
function detach(AKAbstractPartObserver $obs)
{
unset($this->observers["$obs"]);
}
/**
* Sets the BREAKFLAG, which instructs this engine part that the current step must break immediately,
* in fear of timing out.
*/
protected function setBreakFlag()
{
AKFactory::set('volatile.breakflag', true);
}
final protected function setDomain($new_domain)
{
$this->active_domain = $new_domain;
}
final protected function setStep($new_step)
{
$this->active_step = $new_step;
}
final protected function setSubstep($new_substep)
{
$this->active_substep = $new_substep;
}
/**
* Notifies observers each time something interesting happened to the part
*
* @param mixed $message The event object
*/
protected function notify($message)
{
foreach ($this->observers as $obs)
{
$obs->update($this, $message);
}
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* The base class of unarchiver classes
*/
abstract class AKAbstractUnarchiver extends AKAbstractPart
{
/** @var array List of the names of all archive parts */
public $archiveList = [];
/** @var int The total size of all archive parts */
public $totalSize = [];
/** @var array Which files to rename */
public $renameFiles = [];
/** @var array Which directories to rename */
public $renameDirs = [];
/** @var array Which files to skip */
public $skipFiles = [];
/** @var string Archive filename */
protected $filename = null;
/** @var integer Current archive part number */
protected $currentPartNumber = -1;
/** @var integer The offset inside the current part */
protected $currentPartOffset = 0;
/** @var bool Should I restore permissions? */
protected $flagRestorePermissions = false;
/** @var AKAbstractPostproc Post processing class */
protected $postProcEngine = null;
/** @var string Absolute path to prepend to extracted files */
protected $addPath = '';
/** @var string Absolute path to remove from extracted files */
protected $removePath = '';
/** @var integer Chunk size for processing */
protected $chunkSize = 524288;
/** @var resource File pointer to the current archive part file */
protected $fp = null;
/** @var int Run state when processing the current archive file */
protected $runState = null;
/** @var stdClass File header data, as read by the readFileHeader() method */
protected $fileHeader = null;
/** @var int How much of the uncompressed data we've read so far */
protected $dataReadLength = 0;
/** @var array Unwriteable files in these directories are always ignored and do not cause errors when not extracted */
protected $ignoreDirectories = [];
/**
* Wakeup function, called whenever the class is unserialized
*/
public function __wakeup()
{
if ($this->currentPartNumber >= 0)
{
$this->fp = @fopen($this->archiveList[$this->currentPartNumber], 'r');
if ((is_resource($this->fp)) && ($this->currentPartOffset > 0))
{
@fseek($this->fp, $this->currentPartOffset);
}
}
}
/**
* Sleep function, called whenever the class is serialized
*/
public function shutdown()
{
if (is_resource($this->fp))
{
$this->currentPartOffset = @ftell($this->fp);
@fclose($this->fp);
}
}
/**
* Is this file or directory contained in a directory we've decided to ignore
* write errors for? This is useful to let the extraction work despite write
* errors in the log, logs and tmp directories which MIGHT be used by the system
* on some low quality hosts and Plesk-powered hosts.
*
* @param string $shortFilename The relative path of the file/directory in the package
*
* @return boolean True if it belongs in an ignored directory
*/
public function isIgnoredDirectory($shortFilename)
{
// return false;
if (substr($shortFilename, -1) == '/')
{
$check = rtrim($shortFilename, '/');
}
else
{
$check = dirname($shortFilename);
}
return in_array($check, $this->ignoreDirectories);
}
/**
* Implements the abstract _prepare() method
*/
final protected function _prepare()
{
if (count($this->_parametersArray) > 0)
{
foreach ($this->_parametersArray as $key => $value)
{
switch ($key)
{
// Archive's absolute filename
case 'filename':
$this->filename = $value;
// Sanity check
if (!empty($value))
{
$value = strtolower($value);
if (strlen($value) > 6)
{
if (
(substr($value, 0, 7) == 'http://')
|| (substr($value, 0, 8) == 'https://')
|| (substr($value, 0, 6) == 'ftp://')
|| (substr($value, 0, 7) == 'ssh2://')
|| (substr($value, 0, 6) == 'ssl://')
)
{
$this->setState('error', 'Invalid archive location');
}
}
}
break;
// Should I restore permissions?
case 'restore_permissions':
$this->flagRestorePermissions = $value;
break;
// Should I use FTP?
case 'post_proc':
$this->postProcEngine = AKFactory::getpostProc($value);
break;
// Path to add in the beginning
case 'add_path':
$this->addPath = $value;
$this->addPath = str_replace('\\', '/', $this->addPath);
$this->addPath = rtrim($this->addPath, '/');
if (!empty($this->addPath))
{
$this->addPath .= '/';
}
break;
// Path to remove from the beginning
case 'remove_path':
$this->removePath = $value;
$this->removePath = str_replace('\\', '/', $this->removePath);
$this->removePath = rtrim($this->removePath, '/');
if (!empty($this->removePath))
{
$this->removePath .= '/';
}
break;
// Which files to rename (hash array)
case 'rename_files':
$this->renameFiles = $value;
break;
// Which files to rename (hash array)
case 'rename_dirs':
$this->renameDirs = $value;
break;
// Which files to skip (indexed array)
case 'skip_files':
$this->skipFiles = $value;
break;
// Which directories to ignore when we can't write files in them (indexed array)
case 'ignoredirectories':
$this->ignoreDirectories = $value;
break;
}
}
}
$this->scanArchives();
$this->readArchiveHeader();
$errMessage = $this->getError();
if (!empty($errMessage))
{
$this->setState('error', $errMessage);
}
else
{
$this->runState = AK_STATE_NOFILE;
$this->setState('prepared');
}
}
/**
* Scans for archive parts
*/
private function scanArchives()
{
if (defined('KSDEBUG'))
{
@unlink('debug.txt');
}
debugMsg('Preparing to scan archives');
$privateArchiveList = [];
// Get the components of the archive filename
$dirname = dirname($this->filename);
$base_extension = $this->getBaseExtension();
$basename = basename($this->filename, $base_extension);
$this->totalSize = 0;
// Scan for multiple parts until we don't find any more of them
$count = 0;
$found = true;
$this->archiveList = [];
while ($found)
{
++$count;
$extension = substr($base_extension, 0, 2) . sprintf('%02d', $count);
$filename = $dirname . DIRECTORY_SEPARATOR . $basename . $extension;
$found = file_exists($filename);
if ($found)
{
debugMsg('- Found archive ' . $filename);
// Add yet another part, with a numeric-appended filename
$this->archiveList[] = $filename;
$filesize = @filesize($filename);
$this->totalSize += $filesize;
$privateArchiveList[] = [$filename, $filesize];
}
else
{
debugMsg('- Found archive ' . $this->filename);
// Add the last part, with the regular extension
$this->archiveList[] = $this->filename;
$filename = $this->filename;
$filesize = @filesize($filename);
$this->totalSize += $filesize;
$privateArchiveList[] = [$filename, $filesize];
}
}
debugMsg('Total archive parts: ' . $count);
$this->currentPartNumber = -1;
$this->currentPartOffset = 0;
$this->runState = AK_STATE_NOFILE;
// Send start of file notification
$message = new stdClass;
$message->type = 'totalsize';
$message->content = new stdClass;
$message->content->totalsize = $this->totalSize;
$message->content->filelist = $privateArchiveList;
$this->notify($message);
}
/**
* Returns the base extension of the file, e.g. '.jpa'
*
* @return string
*/
private function getBaseExtension()
{
static $baseextension;
if (empty($baseextension))
{
$basename = basename($this->filename);
$lastdot = strrpos($basename, '.');
$baseextension = substr($basename, $lastdot);
}
return $baseextension;
}
/**
* Concrete classes are supposed to use this method in order to read the archive's header and
* prepare themselves to the point of being ready to extract the first file.
*/
protected abstract function readArchiveHeader();
protected function _run()
{
if ($this->getState() == 'postrun')
{
return;
}
$this->setState('running');
$timer = AKFactory::getTimer();
$status = true;
while ($status && ($timer->getTimeLeft() > 0))
{
switch ($this->runState)
{
case AK_STATE_NOFILE:
debugMsg(self::class . '::_run() - Reading file header');
$status = $this->readFileHeader();
if ($status)
{
// Send start of file notification
$message = new stdClass;
$message->type = 'startfile';
$message->content = new stdClass;
$message->content->realfile = $this->fileHeader->file;
$message->content->file = $this->fileHeader->file;
$message->content->uncompressed = $this->fileHeader->uncompressed;
if (array_key_exists('realfile', get_object_vars($this->fileHeader)))
{
$message->content->realfile = $this->fileHeader->realFile;
}
if (array_key_exists('compressed', get_object_vars($this->fileHeader)))
{
$message->content->compressed = $this->fileHeader->compressed;
}
else
{
$message->content->compressed = 0;
}
debugMsg(self::class . '::_run() - Preparing to extract ' . $message->content->realfile);
$this->notify($message);
}
else
{
debugMsg(self::class . '::_run() - Could not read file header');
}
break;
case AK_STATE_HEADER:
case AK_STATE_DATA:
debugMsg(self::class . '::_run() - Processing file data');
$status = $this->processFileData();
break;
case AK_STATE_DATAREAD:
case AK_STATE_POSTPROC:
debugMsg(self::class . '::_run() - Calling post-processing class');
$this->postProcEngine->timestamp = $this->fileHeader->timestamp;
$status = $this->postProcEngine->process();
$this->propagateFromObject($this->postProcEngine);
$this->runState = AK_STATE_DONE;
break;
case AK_STATE_DONE:
default:
if ($status)
{
debugMsg(self::class . '::_run() - Finished extracting file');
// Send end of file notification
$message = new stdClass;
$message->type = 'endfile';
$message->content = new stdClass;
if (array_key_exists('realfile', get_object_vars($this->fileHeader)))
{
$message->content->realfile = $this->fileHeader->realFile;
}
else
{
$message->content->realfile = $this->fileHeader->file;
}
$message->content->file = $this->fileHeader->file;
if (array_key_exists('compressed', get_object_vars($this->fileHeader)))
{
$message->content->compressed = $this->fileHeader->compressed;
}
else
{
$message->content->compressed = 0;
}
$message->content->uncompressed = $this->fileHeader->uncompressed;
$this->notify($message);
}
$this->runState = AK_STATE_NOFILE;
break;
}
}
$error = $this->getError();
if (!$status && ($this->runState == AK_STATE_NOFILE) && empty($error))
{
debugMsg(self::class . '::_run() - Just finished');
// We just finished
$this->setState('postrun');
// Reset internal state, prevents __wakeup from trying to open a non-existent file
$this->currentPartNumber = -1;
}
elseif (!empty($error))
{
debugMsg(self::class . '::_run() - Halted with an error:');
debugMsg($error);
$this->setState('error', $error);
}
}
/**
* Concrete classes must use this method to read the file header
*
* @return bool True if reading the file was successful, false if an error occurred or we reached end of archive
*/
protected abstract function readFileHeader();
/**
* Concrete classes must use this method to process file data. It must set $runState to AK_STATE_DATAREAD when
* it's finished processing the file data.
*
* @return bool True if processing the file data was successful, false if an error occurred
*/
protected abstract function processFileData();
protected function _finalize()
{
// Nothing to do
$this->setState('finished');
}
/**
* Opens the next part file for reading
*/
protected function nextFile()
{
debugMsg('Current part is ' . $this->currentPartNumber . '; opening the next part');
++$this->currentPartNumber;
if ($this->currentPartNumber > (count($this->archiveList) - 1))
{
$this->setState('postrun');
return false;
}
else
{
if (is_resource($this->fp))
{
@fclose($this->fp);
}
debugMsg('Opening file ' . $this->archiveList[$this->currentPartNumber]);
$this->fp = @fopen($this->archiveList[$this->currentPartNumber], 'r');
if ($this->fp === false)
{
debugMsg('Could not open file - crash imminent');
$this->setError(AKText::sprintf('ERR_COULD_NOT_OPEN_ARCHIVE_PART', $this->archiveList[$this->currentPartNumber]));
}
fseek($this->fp, 0);
$this->currentPartOffset = 0;
return true;
}
}
/**
* Returns true if we have reached the end of file
*
* @param $local bool True to return EOF of the local file, false (default) to return if we have reached the end of
* the archive set
*
* @return bool True if we have reached End Of File
*/
protected function isEOF($local = false)
{
$eof = @feof($this->fp);
if (!$eof)
{
// Border case: right at the part's end (eeeek!!!). For the life of me, I don't understand why
// feof() doesn't report true. It expects the fp to be positioned *beyond* the EOF to report
// true. Incredible! :(
$position = @ftell($this->fp);
$filesize = @filesize($this->archiveList[$this->currentPartNumber]);
if ($filesize <= 0)
{
// 2Gb or more files on a 32 bit version of PHP tend to get screwed up. Meh.
$eof = false;
}
elseif ($position >= $filesize)
{
$eof = true;
}
}
if ($local)
{
return $eof;
}
else
{
return $eof && ($this->currentPartNumber >= (count($this->archiveList) - 1));
}
}
/**
* Tries to make a directory user-writable so that we can write a file to it
*
* @param $path string A path to a file
*/
protected function setCorrectPermissions($path)
{
static $rootDir = null;
if (is_null($rootDir))
{
$rootDir = rtrim(AKFactory::get('kickstart.setup.destdir', ''), '/\\');
}
$directory = rtrim(dirname($path), '/\\');
if ($directory != $rootDir)
{
// Is this an unwritable directory?
if (!is_writeable($directory))
{
$this->postProcEngine->chmod($directory, 0755);
}
}
$this->postProcEngine->chmod($path, 0644);
}
/**
* Reads data from the archive and notifies the observer with the 'reading' message
*
* @param $fp
* @param $length
*/
protected function fread($fp, $length = null)
{
if (is_numeric($length))
{
if ($length > 0)
{
$data = fread($fp, $length);
}
else
{
$data = fread($fp, PHP_INT_MAX);
}
}
else
{
$data = fread($fp, PHP_INT_MAX);
}
if ($data === false)
{
$data = '';
}
// Send start of file notification
$message = new stdClass;
$message->type = 'reading';
$message->content = new stdClass;
$message->content->length = strlen($data);
$this->notify($message);
return $data;
}
/**
* Removes the configured $removePath from the path $path
*
* @param string $path The path to reduce
*
* @return string The reduced path
*/
protected function removePath($path)
{
if (empty($this->removePath))
{
return $path;
}
if (strpos($path, $this->removePath) === 0)
{
$path = substr($path, strlen($this->removePath));
$path = ltrim($path, '/\\');
}
return $path;
}
/**
* Am I supposed to skip the extraction of the current file? This depends on
*
* @return bool
*/
protected function mustSkip()
{
static $isDryRun = null;
// List of files (and patterns) to extract
static $extractList = null;
// Internal cache of the last file we checked and whether it must be skipped
static $lastFileName = '';
static $mustSkip = false;
// Make sure the dry run flag is, indeed, populated
if (is_null($isDryRun))
{
$isDryRun = AKFactory::get('kickstart.setup.dryrun', '0');
}
// If it's a Kickstart dry run we have to skip the extraction of the file
if ($isDryRun)
{
return true;
}
// Make sure I have a list of files and patterns to extract
if (is_null($extractList))
{
$extractList = $this->getExtractList();
}
// No list of files to extract is given; we must extract everything.
if (empty($extractList))
{
return false;
}
// I am asked about the same file again. Return the cached result.
if ($this->fileHeader->file == $lastFileName)
{
return $mustSkip;
}
// Does the current file match the extract patterns or not?
$lastFileName = $this->fileHeader->file;
$lastFileName = (strpos($lastFileName, $this->addPath) === 0) ? substr($lastFileName, strlen(rtrim($this->addPath, "\\/")) + 1) : $lastFileName;
$mustSkip = !$this->matchesGlobPatterns($lastFileName, $extractList);
return $mustSkip;
}
protected function fuzzySignatureSearch($requiredSignatures, $sigLen)
{
if (!is_array($requiredSignatures))
{
$requiredSignatures = [$requiredSignatures];
}
fseek($this->fp, 0, SEEK_SET);
$stuff = $this->fread($this->fp, 131072);
$maxPos = function_exists('mb_strlen') ? mb_strlen($stuff, 'binary') : strlen($stuff);
for ($i = 0; $i < $maxPos; $i++)
{
foreach ($requiredSignatures as $signature)
{
$sigBinary = function_exists('mb_substr') ? mb_substr($stuff, $i, $sigLen, 'binary') : substr($stuff, $i, $sigLen);
if ($sigBinary === $signature)
{
fseek($this->fp, $i, SEEK_SET);
return true;
}
}
}
return false;
}
/**
* Get the list of files / folders to extract. The list can contain filenames or glob patterns.
*
* @return array
*/
private function getExtractList()
{
$rawList = AKFactory::get('kickstart.setup.extract_list', '');
// Sometimes I could get an array, e.g. from CLI
if (is_array($rawList))
{
$rawList = implode("\n", $rawList);
}
// Remove any whitespace
$rawList = trim($rawList);
if (empty($rawList))
{
return [];
}
// Convert commas to newlines so we can support both ways to express lists
$rawList = str_replace(",", "\n", $rawList);
$rawList = trim($rawList);
// Convert the list to an array and clean it
$list = explode("\n", $rawList);
$list = array_map('trim', $list);
return array_unique($list);
}
/**
* Tests whether the item $item matches the list of shell patterns $list.
*
* @param string $item The file name to test
* @param array $list The list of glob patterns to match
*
* @return bool
*/
private function matchesGlobPatterns($item, array $list)
{
if (empty($list))
{
return true;
}
foreach ($list as $pattern)
{
if (fnmatch($pattern, $item))
{
return true;
}
}
return false;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* File post processor engines base class
*/
abstract class AKAbstractPostproc extends AKAbstractObject
{
/** @var int The UNIX timestamp of the file's desired modification date */
public $timestamp = 0;
/** @var string The actual file path we'll have to process */
protected $filename = null;
/** @var int The requested permissions */
protected $perms = 0755;
/** @var string The temporary file path we gave to the unarchiver engine */
protected $tempFilename = null;
/** @var string The temporary directory where the data will be stored */
protected $tempDir = '';
/**
* Processes the current file, e.g. moves it from temp to final location by FTP
*/
abstract public function process();
/**
* The unarchiver tells us the path to the filename it wants to extract and we give it
* a different path instead.
*
* @param string $filename The path to the real file
* @param int $perms The permissions we need the file to have
*
* @return string The path to the temporary file
*/
abstract public function processFilename($filename, $perms = 0755);
/**
* Recursively creates a directory if it doesn't exist
*
* @param string $dirName The directory to create
* @param int $perms The permissions to give to that directory
*/
abstract public function createDirRecursive($dirName, $perms);
abstract public function chmod($file, $perms);
abstract public function unlink($file);
abstract public function rmdir($directory);
abstract public function rename($from, $to);
/**
* Returns the configured temporary directory
*
* @return string
*/
public function getTempDir()
{
return $this->tempDir;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* Descendants of this class can be used in the unarchiver's observer methods (attach, detach and notify)
*
* @author Nicholas
*
*/
abstract class AKAbstractPartObserver
{
abstract public function update($object, $message);
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2026 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
class AKPartNullObserver extends AKAbstractPartObserver
{
public function update($object, $message)
{
// This observer does nothing.
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* Direct file writer
*/
class AKPostprocDirect extends AKAbstractPostproc
{
public function process()
{
$restorePerms = AKFactory::get('kickstart.setup.restoreperms', false);
if ($restorePerms)
{
@chmod($this->filename, $this->perms);
}
else
{
if (@is_file($this->filename))
{
@chmod($this->filename, 0644);
}
else
{
@chmod($this->filename, 0755);
}
}
if ($this->timestamp > 0)
{
@touch($this->filename, $this->timestamp);
}
if (@is_file($this->filename) || @is_link($this->filename))
{
clearFileInOPCache($this->filename);
}
return true;
}
public function processFilename($filename, $perms = 0755)
{
$this->perms = $perms;
$this->filename = $filename;
return $filename;
}
public function createDirRecursive($dirName, $perms)
{
if (AKFactory::get('kickstart.setup.dryrun', '0'))
{
return true;
}
if (@mkdir($dirName, 0755, true))
{
@chmod($dirName, 0755);
return true;
}
$root = AKFactory::get('kickstart.setup.destdir');
$root = rtrim(str_replace('\\', '/', $root), '/');
$dir = rtrim(str_replace('\\', '/', $dirName), '/');
if (strpos($dir, $root) === 0)
{
$dir = ltrim(substr($dir, strlen($root)), '/');
$root .= '/';
}
else
{
$root = '';
}
if (empty($dir))
{
return true;
}
$dirArray = explode('/', $dir);
$path = '';
foreach ($dirArray as $dir)
{
$path .= $dir . '/';
$ret = is_dir($root . $path) ? true : @mkdir($root . $path);
if (!$ret)
{
// Is this a file instead of a directory?
if (is_file($root . $path))
{
@unlink($root . $path);
$ret = @mkdir($root . $path);
}
if (!$ret)
{
$this->setError(AKText::sprintf('COULDNT_CREATE_DIR', $path));
return false;
}
}
// Try to set new directory permissions to 0755
@chmod($root . $path, $perms);
}
return true;
}
public function chmod($file, $perms)
{
if (AKFactory::get('kickstart.setup.dryrun', '0'))
{
return true;
}
return @chmod($file, $perms);
}
public function unlink($file)
{
return @unlink($file);
}
public function rmdir($directory)
{
return @rmdir($directory);
}
public function rename($from, $to)
{
return @rename($from, $to);
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* FTP file writer
*/
class AKPostprocFTP extends AKAbstractPostproc
{
/** @var bool Should I use FTP over implicit SSL? */
public $useSSL = false;
/** @var bool use Passive mode? */
public $passive = true;
/** @var string FTP host name */
public $host = '';
/** @var int FTP port */
public $port = 21;
/** @var string FTP user name */
public $user = '';
/** @var string FTP password */
public $pass = '';
/** @var string FTP initial directory */
public $dir = '';
/** @var resource The FTP handle */
private $handle = null;
public function __construct()
{
$this->useSSL = AKFactory::get('kickstart.ftp.ssl', false);
$this->passive = AKFactory::get('kickstart.ftp.passive', true);
$this->host = AKFactory::get('kickstart.ftp.host', '');
$this->port = AKFactory::get('kickstart.ftp.port', 21);
if (trim($this->port) == '')
{
$this->port = 21;
}
$this->user = AKFactory::get('kickstart.ftp.user', '');
$this->pass = AKFactory::get('kickstart.ftp.pass', '');
$this->dir = AKFactory::get('kickstart.ftp.dir', '');
$this->tempDir = AKFactory::get('kickstart.ftp.tempdir', '');
$connected = $this->connect();
if ($connected)
{
if (!empty($this->tempDir))
{
$tempDir = rtrim($this->tempDir, '/\\') . '/';
$writable = $this->isDirWritable($tempDir);
}
else
{
$tempDir = '';
$writable = false;
}
if (!$writable)
{
// Default temporary directory is the current root
$tempDir = KSROOTDIR;
if (empty($tempDir))
{
// Oh, we have no directory reported!
$tempDir = '.';
}
$absoluteDirToHere = $tempDir;
$tempDir = rtrim(str_replace('\\', '/', $tempDir), '/');
if (!empty($tempDir))
{
$tempDir .= '/';
}
$this->tempDir = $tempDir;
// Is this directory writable?
$writable = $this->isDirWritable($tempDir);
}
if (!$writable)
{
// Nope. Let's try creating a temporary directory in the site's root.
$tempDir = $absoluteDirToHere . '/kicktemp';
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
$this->createDirRecursive($tempDir, $trustMeIKnowWhatImDoing);
// Try making it writable...
$this->fixPermissions($tempDir);
$writable = $this->isDirWritable($tempDir);
}
// Was the new directory writable?
if (!$writable)
{
// Let's see if the user has specified one
$userdir = AKFactory::get('kickstart.ftp.tempdir', '');
if (!empty($userdir))
{
// Is it an absolute or a relative directory?
$absolute = false;
$absolute = $absolute || (substr($userdir, 0, 1) == '/');
$absolute = $absolute || (substr($userdir, 1, 1) == ':');
$absolute = $absolute || (substr($userdir, 2, 1) == ':');
if (!$absolute)
{
// Make absolute
$tempDir = $absoluteDirToHere . $userdir;
}
else
{
// it's already absolute
$tempDir = $userdir;
}
// Does the directory exist?
if (is_dir($tempDir))
{
// Yeah. Is it writable?
$writable = $this->isDirWritable($tempDir);
}
}
}
$this->tempDir = $tempDir;
if (!$writable)
{
// No writable directory found!!!
$this->setError(AKText::_('FTP_TEMPDIR_NOT_WRITABLE'));
}
else
{
AKFactory::set('kickstart.ftp.tempdir', $tempDir);
$this->tempDir = $tempDir;
}
}
}
public function connect()
{
// Connect to server, using SSL if so required
if ($this->useSSL)
{
$this->handle = @ftp_ssl_connect($this->host, $this->port);
}
else
{
$this->handle = @ftp_connect($this->host, $this->port);
}
if ($this->handle === false)
{
$this->setError(AKText::_('WRONG_FTP_HOST'));
return false;
}
// Login
if (!@ftp_login($this->handle, $this->user, $this->pass))
{
$this->setError(AKText::_('WRONG_FTP_USER'));
@ftp_close($this->handle);
return false;
}
// Change to initial directory
if (!@ftp_chdir($this->handle, $this->dir))
{
$this->setError(AKText::_('WRONG_FTP_PATH1'));
@ftp_close($this->handle);
return false;
}
// Enable passive mode if the user requested it
if ($this->passive)
{
@ftp_pasv($this->handle, true);
}
else
{
@ftp_pasv($this->handle, false);
}
// Try to download ourselves
$testFilename = defined('KSSELFNAME') ? KSSELFNAME : basename(__FILE__);
$tempHandle = fopen('php://temp', 'r+');
if (@ftp_fget($this->handle, $tempHandle, $testFilename, FTP_ASCII, 0) === false)
{
$this->setError(AKText::_('WRONG_FTP_PATH2'));
@ftp_close($this->handle);
fclose($tempHandle);
return false;
}
fclose($tempHandle);
return true;
}
private function isDirWritable($dir)
{
$fp = @fopen($dir . '/kickstart.dat', 'w');
if ($fp === false)
{
return false;
}
else
{
@fclose($fp);
unlink($dir . '/kickstart.dat');
return true;
}
}
public function createDirRecursive($dirName, $perms)
{
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
// UNIXize the paths
$removePath = str_replace('\\', '/', $removePath);
$dirName = str_replace('\\', '/', $dirName);
// Make sure they both end in a slash
$removePath = rtrim($removePath, '/\\') . '/';
$dirName = rtrim($dirName, '/\\') . '/';
// Process the path removal
$left = substr($dirName, 0, strlen($removePath));
if ($left == $removePath)
{
$dirName = substr($dirName, strlen($removePath));
}
}
if (empty($dirName))
{
$dirName = '';
} // 'cause the substr() above may return FALSE.
$check = '/' . trim($this->dir, '/') . '/' . trim($dirName, '/');
if ($this->is_dir($check))
{
return true;
}
$alldirs = explode('/', $dirName);
$previousDir = '/' . trim($this->dir);
foreach ($alldirs as $curdir)
{
$check = $previousDir . '/' . $curdir;
if (!$this->is_dir($check))
{
// Proactively try to delete a file by the same name
@ftp_delete($this->handle, $check);
if (@ftp_mkdir($this->handle, $check) === false)
{
// If we couldn't create the directory, attempt to fix the permissions in the PHP level and retry!
$this->fixPermissions($removePath . $check);
if (@ftp_mkdir($this->handle, $check) === false)
{
// Can we fall back to pure PHP mode, sire?
if (!@mkdir($check))
{
$this->setError(AKText::sprintf('FTP_CANT_CREATE_DIR', $check));
return false;
}
else
{
// Since the directory was built by PHP, change its permissions
$trustMeIKnowWhatImDoing =
500 + 10 + 1; // working around overzealous scanners written by bozos
@chmod($check, $trustMeIKnowWhatImDoing);
return true;
}
}
}
@ftp_chmod($this->handle, $perms, $check);
}
$previousDir = $check;
}
return true;
}
private function is_dir($dir)
{
return @ftp_chdir($this->handle, $dir);
}
private function fixPermissions($path)
{
// Turn off error reporting
if (!defined('KSDEBUG'))
{
$oldErrorReporting = @error_reporting(0);
}
// Get UNIX style paths
$relPath = str_replace('\\', '/', $path);
$basePath = rtrim(str_replace('\\', '/', KSROOTDIR), '/');
$basePath = rtrim($basePath, '/');
if (!empty($basePath))
{
$basePath .= '/';
}
// Remove the leading relative root
if (substr($relPath, 0, strlen($basePath)) == $basePath)
{
$relPath = substr($relPath, strlen($basePath));
}
$dirArray = explode('/', $relPath);
$pathBuilt = rtrim($basePath, '/');
foreach ($dirArray as $dir)
{
if (empty($dir))
{
continue;
}
$oldPath = $pathBuilt;
$pathBuilt .= '/' . $dir;
if (is_dir($oldPath . $dir))
{
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
@chmod($oldPath . $dir, $trustMeIKnowWhatImDoing);
}
else
{
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
if (@chmod($oldPath . $dir, $trustMeIKnowWhatImDoing) === false)
{
@unlink($oldPath . $dir);
}
}
}
// Restore error reporting
if (!defined('KSDEBUG'))
{
@error_reporting($oldErrorReporting);
}
}
public function __sleep()
{
if (!is_null($this->handle) && is_resource($this->handle))
{
@ftp_close($this->handle);
}
$this->handle = null;
}
public function __destruct()
{
if (!is_null($this->handle) && is_resource($this->handle))
{
@ftp_close($this->handle);
}
}
public function __wakeup()
{
$this->connect();
}
public function process()
{
if (is_null($this->tempFilename))
{
// If an empty filename is passed, it means that we shouldn't do any post processing, i.e.
// the entity was a directory or symlink
return true;
}
$remotePath = dirname($this->filename);
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$removePath = ltrim($removePath, "/");
$remotePath = ltrim($remotePath, "/");
$left = substr($remotePath, 0, strlen($removePath));
if ($left == $removePath)
{
$remotePath = substr($remotePath, strlen($removePath));
}
}
$absoluteFSPath = dirname($this->filename);
$relativeFTPPath = trim($remotePath, '/');
$absoluteFTPPath = '/' . trim($this->dir, '/') . '/' . trim($remotePath, '/');
$onlyFilename = basename($this->filename);
$remoteName = $absoluteFTPPath . '/' . $onlyFilename;
$ret = @ftp_chdir($this->handle, $absoluteFTPPath);
if ($ret === false)
{
$ret = $this->createDirRecursive($absoluteFSPath, 0755);
if ($ret === false)
{
$this->setError(AKText::sprintf('FTP_COULDNT_UPLOAD', $this->filename));
return false;
}
$ret = @ftp_chdir($this->handle, $absoluteFTPPath);
if ($ret === false)
{
$this->setError(AKText::sprintf('FTP_COULDNT_UPLOAD', $this->filename));
return false;
}
}
$ret = @ftp_put($this->handle, $remoteName, $this->tempFilename, FTP_BINARY);
if ($ret === false)
{
// If we couldn't create the file, attempt to fix the permissions in the PHP level and retry!
$this->fixPermissions($this->filename);
$this->unlink($this->filename);
$fp = @fopen($this->tempFilename, 'r');
if ($fp !== false)
{
$ret = @ftp_fput($this->handle, $remoteName, $fp, FTP_BINARY);
@fclose($fp);
}
else
{
$ret = false;
}
}
@unlink($this->tempFilename);
if ($ret === false)
{
$this->setError(AKText::sprintf('FTP_COULDNT_UPLOAD', $this->filename));
return false;
}
$restorePerms = AKFactory::get('kickstart.setup.restoreperms', false);
if ($restorePerms)
{
@ftp_chmod($this->_handle, $this->perms, $remoteName);
}
else
{
@ftp_chmod($this->_handle, 0644, $remoteName);
}
if (@is_file($this->filename) || @is_link($this->filename))
{
clearFileInOPCache($this->filename);
}
return true;
}
/*
* Tries to fix directory/file permissions in the PHP level, so that
* the FTP operation doesn't fail.
* @param $path string The full path to a directory or file
*/
public function unlink($file)
{
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($file, 0, strlen($removePath));
if ($left == $removePath)
{
$file = substr($file, strlen($removePath));
}
}
$check = '/' . trim($this->dir, '/') . '/' . trim($file, '/');
return @ftp_delete($this->handle, $check);
}
public function processFilename($filename, $perms = 0755)
{
// Catch some error conditions...
if ($this->getError())
{
return false;
}
// If a null filename is passed, it means that we shouldn't do any post processing, i.e.
// the entity was a directory or symlink
if (is_null($filename))
{
$this->filename = null;
$this->tempFilename = null;
return null;
}
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($filename, 0, strlen($removePath));
if ($left == $removePath)
{
$filename = substr($filename, strlen($removePath));
}
}
// Trim slash on the left
$filename = ltrim($filename, '/');
$this->filename = $filename;
$this->tempFilename = tempnam($this->tempDir, 'kickstart-');
$this->perms = $perms;
if (empty($this->tempFilename))
{
// Oops! Let's try something different
$this->tempFilename = $this->tempDir . '/kickstart-' . time() . '.dat';
}
return $this->tempFilename;
}
public function close()
{
@ftp_close($this->handle);
}
public function chmod($file, $perms)
{
return @ftp_chmod($this->handle, $perms, $file);
}
public function rmdir($directory)
{
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($directory, 0, strlen($removePath));
if ($left == $removePath)
{
$directory = substr($directory, strlen($removePath));
}
}
$check = '/' . trim($this->dir, '/') . '/' . trim($directory, '/');
return @ftp_rmdir($this->handle, $check);
}
public function rename($from, $to)
{
$originalFrom = $from;
$originalTo = $to;
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($from, 0, strlen($removePath));
if ($left == $removePath)
{
$from = substr($from, strlen($removePath));
}
}
$from = '/' . trim($this->dir, '/') . '/' . trim($from, '/');
if (!empty($removePath))
{
$left = substr($to, 0, strlen($removePath));
if ($left == $removePath)
{
$to = substr($to, strlen($removePath));
}
}
$to = '/' . trim($this->dir, '/') . '/' . trim($to, '/');
$result = @ftp_rename($this->handle, $from, $to);
if ($result !== true)
{
return @rename($from, $to);
}
else
{
return true;
}
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* FTP file writer
*/
class AKPostprocSFTP extends AKAbstractPostproc
{
/** @var bool Should I use FTP over implicit SSL? */
public $useSSL = false;
/** @var bool use Passive mode? */
public $passive = true;
/** @var string FTP host name */
public $host = '';
/** @var int FTP port */
public $port = 21;
/** @var string FTP user name */
public $user = '';
/** @var string FTP password */
public $pass = '';
/** @var string FTP initial directory */
public $dir = '';
/** @var resource SFTP resource handle */
private $handle = null;
/** @var resource SSH2 connection resource handle */
private $_connection = null;
/** @var string Current remote directory, including the remote directory string */
private $_currentdir;
public function __construct()
{
$this->host = AKFactory::get('kickstart.ftp.host', '');
$this->port = AKFactory::get('kickstart.ftp.port', 22);
if (trim($this->port) == '')
{
$this->port = 22;
}
$this->user = AKFactory::get('kickstart.ftp.user', '');
$this->pass = AKFactory::get('kickstart.ftp.pass', '');
$this->dir = AKFactory::get('kickstart.ftp.dir', '');
$this->tempDir = AKFactory::get('kickstart.ftp.tempdir', '');
$connected = $this->connect();
if ($connected)
{
if (!empty($this->tempDir))
{
$tempDir = rtrim($this->tempDir, '/\\') . '/';
$writable = $this->isDirWritable($tempDir);
}
else
{
$tempDir = '';
$writable = false;
}
if (!$writable)
{
// Default temporary directory is the current root
$tempDir = KSROOTDIR;
if (empty($tempDir))
{
// Oh, we have no directory reported!
$tempDir = '.';
}
$absoluteDirToHere = $tempDir;
$tempDir = rtrim(str_replace('\\', '/', $tempDir), '/');
if (!empty($tempDir))
{
$tempDir .= '/';
}
$this->tempDir = $tempDir;
// Is this directory writable?
$writable = $this->isDirWritable($tempDir);
}
if (!$writable)
{
// Nope. Let's try creating a temporary directory in the site's root.
$tempDir = $absoluteDirToHere . '/kicktemp';
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
$this->createDirRecursive($tempDir, $trustMeIKnowWhatImDoing);
// Try making it writable...
$this->fixPermissions($tempDir);
$writable = $this->isDirWritable($tempDir);
}
// Was the new directory writable?
if (!$writable)
{
// Let's see if the user has specified one
$userdir = AKFactory::get('kickstart.ftp.tempdir', '');
if (!empty($userdir))
{
// Is it an absolute or a relative directory?
$absolute = false;
$absolute = $absolute || (substr($userdir, 0, 1) == '/');
$absolute = $absolute || (substr($userdir, 1, 1) == ':');
$absolute = $absolute || (substr($userdir, 2, 1) == ':');
if (!$absolute)
{
// Make absolute
$tempDir = $absoluteDirToHere . $userdir;
}
else
{
// it's already absolute
$tempDir = $userdir;
}
// Does the directory exist?
if (is_dir($tempDir))
{
// Yeah. Is it writable?
$writable = $this->isDirWritable($tempDir);
}
}
}
$this->tempDir = $tempDir;
if (!$writable)
{
// No writable directory found!!!
$this->setError(AKText::_('SFTP_TEMPDIR_NOT_WRITABLE'));
}
else
{
AKFactory::set('kickstart.ftp.tempdir', $tempDir);
$this->tempDir = $tempDir;
}
}
}
public function connect()
{
$this->_connection = false;
if (!function_exists('ssh2_connect'))
{
$this->setError(AKText::_('SFTP_NO_SSH2'));
return false;
}
$this->_connection = @ssh2_connect($this->host, $this->port);
if (!@ssh2_auth_password($this->_connection, $this->user, $this->pass))
{
$this->setError(AKText::_('SFTP_WRONG_USER'));
$this->_connection = false;
return false;
}
$this->handle = @ssh2_sftp($this->_connection);
// I must have an absolute directory
if (!$this->dir)
{
$this->setError(AKText::_('SFTP_WRONG_STARTING_DIR'));
return false;
}
// Change to initial directory
if (!$this->sftp_chdir('/'))
{
$this->setError(AKText::_('SFTP_WRONG_STARTING_DIR'));
unset($this->_connection);
unset($this->handle);
return false;
}
// Try to download ourselves
$testFilename = defined('KSSELFNAME') ? KSSELFNAME : basename(__FILE__);
$basePath = '/' . trim($this->dir, '/');
if (@fopen("ssh2.sftp://{$this->handle}$basePath/$testFilename", 'r+') === false)
{
$this->setError(AKText::_('SFTP_WRONG_STARTING_DIR'));
unset($this->_connection);
unset($this->handle);
return false;
}
return true;
}
/**
* Changes to the requested directory in the remote server. You give only the
* path relative to the initial directory and it does all the rest by itself,
* including doing nothing if the remote directory is the one we want.
*
* @param string $dir The (realtive) remote directory
*
* @return bool True if successful, false otherwise.
*/
private function sftp_chdir($dir)
{
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
// UNIXize the paths
$removePath = str_replace('\\', '/', $removePath);
$dir = str_replace('\\', '/', $dir);
// Make sure they both end in a slash
$removePath = rtrim($removePath, '/\\') . '/';
$dir = rtrim($dir, '/\\') . '/';
// Process the path removal
$left = substr($dir, 0, strlen($removePath));
if ($left == $removePath)
{
$dir = substr($dir, strlen($removePath));
}
}
if (empty($dir))
{
// Because the substr() above may return FALSE.
$dir = '';
}
// Calculate "real" (absolute) SFTP path
$realdir = substr($this->dir, -1) == '/' ? substr($this->dir, 0, strlen($this->dir) - 1) : $this->dir;
$realdir .= '/' . $dir;
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
if ($this->_currentdir == $realdir)
{
// Already there, do nothing
return true;
}
$result = @ssh2_sftp_stat($this->handle, $realdir);
if ($result === false)
{
return false;
}
else
{
// Update the private "current remote directory" variable
$this->_currentdir = $realdir;
return true;
}
}
private function isDirWritable($dir)
{
if (@fopen("ssh2.sftp://{$this->handle}$dir/kickstart.dat", 'w') === false)
{
return false;
}
else
{
@ssh2_sftp_unlink($this->handle, $dir . '/kickstart.dat');
return true;
}
}
public function createDirRecursive($dirName, $perms)
{
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
// UNIXize the paths
$removePath = str_replace('\\', '/', $removePath);
$dirName = str_replace('\\', '/', $dirName);
// Make sure they both end in a slash
$removePath = rtrim($removePath, '/\\') . '/';
$dirName = rtrim($dirName, '/\\') . '/';
// Process the path removal
$left = substr($dirName, 0, strlen($removePath));
if ($left == $removePath)
{
$dirName = substr($dirName, strlen($removePath));
}
}
if (empty($dirName))
{
$dirName = '';
} // 'cause the substr() above may return FALSE.
$check = '/' . trim($this->dir, '/ ') . '/' . trim($dirName, '/');
if ($this->is_dir($check))
{
return true;
}
$alldirs = explode('/', $dirName);
$previousDir = '/' . trim($this->dir, '/ ');
foreach ($alldirs as $curdir)
{
if (!$curdir)
{
continue;
}
$check = $previousDir . '/' . $curdir;
if (!$this->is_dir($check))
{
// Proactively try to delete a file by the same name
@ssh2_sftp_unlink($this->handle, $check);
if (@ssh2_sftp_mkdir($this->handle, $check) === false)
{
// If we couldn't create the directory, attempt to fix the permissions in the PHP level and retry!
$this->fixPermissions($check);
if (@ssh2_sftp_mkdir($this->handle, $check) === false)
{
// Can we fall back to pure PHP mode, sire?
if (!@mkdir($check))
{
$this->setError(AKText::sprintf('FTP_CANT_CREATE_DIR', $check));
return false;
}
else
{
// Since the directory was built by PHP, change its permissions
$trustMeIKnowWhatImDoing =
500 + 10 + 1; // working around overzealous scanners written by bozos
@chmod($check, $trustMeIKnowWhatImDoing);
return true;
}
}
}
@ssh2_sftp_chmod($this->handle, $check, $perms);
}
$previousDir = $check;
}
return true;
}
private function is_dir($dir)
{
return $this->sftp_chdir($dir);
}
private function fixPermissions($path)
{
// Turn off error reporting
if (!defined('KSDEBUG'))
{
$oldErrorReporting = @error_reporting(0);
}
// Get UNIX style paths
$relPath = str_replace('\\', '/', $path);
$basePath = rtrim(str_replace('\\', '/', KSROOTDIR), '/');
$basePath = rtrim($basePath, '/');
if (!empty($basePath))
{
$basePath .= '/';
}
// Remove the leading relative root
if (substr($relPath, 0, strlen($basePath)) == $basePath)
{
$relPath = substr($relPath, strlen($basePath));
}
$dirArray = explode('/', $relPath);
$pathBuilt = rtrim($basePath, '/');
foreach ($dirArray as $dir)
{
if (empty($dir))
{
continue;
}
$oldPath = $pathBuilt;
$pathBuilt .= '/' . $dir;
if (is_dir($oldPath . '/' . $dir))
{
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
@chmod($oldPath . '/' . $dir, $trustMeIKnowWhatImDoing);
}
else
{
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
if (@chmod($oldPath . '/' . $dir, $trustMeIKnowWhatImDoing) === false)
{
@unlink($oldPath . $dir);
}
}
}
// Restore error reporting
if (!defined('KSDEBUG'))
{
@error_reporting($oldErrorReporting);
}
}
function __wakeup()
{
$this->connect();
}
/*
* Tries to fix directory/file permissions in the PHP level, so that
* the FTP operation doesn't fail.
* @param $path string The full path to a directory or file
*/
public function process()
{
if (is_null($this->tempFilename))
{
// If an empty filename is passed, it means that we shouldn't do any post processing, i.e.
// the entity was a directory or symlink
return true;
}
$remotePath = dirname($this->filename);
$absoluteFSPath = dirname($this->filename);
$absoluteFTPPath = '/' . trim($this->dir, '/') . '/' . trim($remotePath, '/');
$onlyFilename = basename($this->filename);
$remoteName = $absoluteFTPPath . '/' . $onlyFilename;
$ret = $this->sftp_chdir($absoluteFTPPath);
if ($ret === false)
{
$ret = $this->createDirRecursive($absoluteFSPath, 0755);
if ($ret === false)
{
$this->setError(AKText::sprintf('SFTP_COULDNT_UPLOAD', $this->filename));
return false;
}
$ret = $this->sftp_chdir($absoluteFTPPath);
if ($ret === false)
{
$this->setError(AKText::sprintf('SFTP_COULDNT_UPLOAD', $this->filename));
return false;
}
}
// Create the file
$ret = $this->write($this->tempFilename, $remoteName);
// If I got a -1 it means that I wasn't able to open the file, so I have to stop here
if ($ret === -1)
{
$this->setError(AKText::sprintf('SFTP_COULDNT_UPLOAD', $this->filename));
return false;
}
if ($ret === false)
{
// If we couldn't create the file, attempt to fix the permissions in the PHP level and retry!
$this->fixPermissions($this->filename);
$this->unlink($this->filename);
$ret = $this->write($this->tempFilename, $remoteName);
}
@unlink($this->tempFilename);
if ($ret === false)
{
$this->setError(AKText::sprintf('SFTP_COULDNT_UPLOAD', $this->filename));
return false;
}
$restorePerms = AKFactory::get('kickstart.setup.restoreperms', false);
if ($restorePerms)
{
$this->chmod($remoteName, $this->perms);
}
else
{
$this->chmod($remoteName, 0644);
}
if (@is_file($this->filename) || @is_link($this->filename))
{
clearFileInOPCache($this->filename);
}
return true;
}
private function write($local, $remote)
{
$fp = @fopen("ssh2.sftp://{$this->handle}$remote", 'w');
$localfp = @fopen($local, 'r');
if ($fp === false)
{
return -1;
}
if ($localfp === false)
{
@fclose($fp);
return -1;
}
$res = true;
while (!feof($localfp) && ($res !== false))
{
$buffer = @fread($localfp, 65567);
$res = @fwrite($fp, $buffer);
}
@fclose($fp);
@fclose($localfp);
return $res;
}
public function unlink($file)
{
$check = '/' . trim($this->dir, '/') . '/' . trim($file, '/');
return @ssh2_sftp_unlink($this->handle, $check);
}
public function chmod($file, $perms)
{
return @ssh2_sftp_chmod($this->handle, $file, $perms);
}
public function processFilename($filename, $perms = 0755)
{
// Catch some error conditions...
if ($this->getError())
{
return false;
}
// If a null filename is passed, it means that we shouldn't do any post processing, i.e.
// the entity was a directory or symlink
if (is_null($filename))
{
$this->filename = null;
$this->tempFilename = null;
return null;
}
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($filename, 0, strlen($removePath));
if ($left == $removePath)
{
$filename = substr($filename, strlen($removePath));
}
}
// Trim slash on the left
$filename = ltrim($filename, '/');
$this->filename = $filename;
$this->tempFilename = tempnam($this->tempDir, 'kickstart-');
$this->perms = $perms;
if (empty($this->tempFilename))
{
// Oops! Let's try something different
$this->tempFilename = $this->tempDir . '/kickstart-' . time() . '.dat';
}
return $this->tempFilename;
}
public function close()
{
unset($this->_connection);
unset($this->handle);
}
public function rmdir($directory)
{
$check = '/' . trim($this->dir, '/') . '/' . trim($directory, '/');
return @ssh2_sftp_rmdir($this->handle, $check);
}
public function rename($from, $to)
{
$from = '/' . trim($this->dir, '/') . '/' . trim($from, '/');
$to = '/' . trim($this->dir, '/') . '/' . trim($to, '/');
$result = @ssh2_sftp_rename($this->handle, $from, $to);
if ($result !== true)
{
return @rename($from, $to);
}
else
{
return true;
}
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* Hybrid direct / FTP mode file writer
*/
class AKPostprocHybrid extends AKAbstractPostproc
{
/** @var bool Should I use the FTP layer? */
public $useFTP = false;
/** @var bool Should I use FTP over implicit SSL? */
public $useSSL = false;
/** @var bool use Passive mode? */
public $passive = true;
/** @var string FTP host name */
public $host = '';
/** @var int FTP port */
public $port = 21;
/** @var string FTP user name */
public $user = '';
/** @var string FTP password */
public $pass = '';
/** @var string FTP initial directory */
public $dir = '';
/** @var resource The FTP handle */
private $handle = null;
/** @var null The FTP connection handle */
private $_handle = null;
/**
* Public constructor. Tries to connect to the FTP server.
*/
public function __construct()
{
$this->useFTP = true;
$this->useSSL = AKFactory::get('kickstart.ftp.ssl', false);
$this->passive = AKFactory::get('kickstart.ftp.passive', true);
$this->host = AKFactory::get('kickstart.ftp.host', '');
$this->port = AKFactory::get('kickstart.ftp.port', 21);
$this->user = AKFactory::get('kickstart.ftp.user', '');
$this->pass = AKFactory::get('kickstart.ftp.pass', '');
$this->dir = AKFactory::get('kickstart.ftp.dir', '');
$this->tempDir = AKFactory::get('kickstart.ftp.tempdir', '');
if (trim($this->port) == '')
{
$this->port = 21;
}
// If FTP is not configured, skip it altogether
if (empty($this->host) || empty($this->user) || empty($this->pass))
{
$this->useFTP = false;
}
// Try to connect to the FTP server
$connected = $this->connect();
// If the connection fails, skip FTP altogether
if (!$connected)
{
$this->useFTP = false;
}
if ($connected)
{
if (!empty($this->tempDir))
{
$tempDir = rtrim($this->tempDir, '/\\') . '/';
$writable = $this->isDirWritable($tempDir);
}
else
{
$tempDir = '';
$writable = false;
}
if (!$writable)
{
// Default temporary directory is the current root
$tempDir = KSROOTDIR;
if (empty($tempDir))
{
// Oh, we have no directory reported!
$tempDir = '.';
}
$absoluteDirToHere = $tempDir;
$tempDir = rtrim(str_replace('\\', '/', $tempDir), '/');
if (!empty($tempDir))
{
$tempDir .= '/';
}
$this->tempDir = $tempDir;
// Is this directory writable?
$writable = $this->isDirWritable($tempDir);
}
if (!$writable)
{
// Nope. Let's try creating a temporary directory in the site's root.
$tempDir = $absoluteDirToHere . '/kicktemp';
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
$this->createDirRecursive($tempDir, $trustMeIKnowWhatImDoing);
// Try making it writable...
$this->fixPermissions($tempDir);
$writable = $this->isDirWritable($tempDir);
}
// Was the new directory writable?
if (!$writable)
{
// Let's see if the user has specified one
$userdir = AKFactory::get('kickstart.ftp.tempdir', '');
if (!empty($userdir))
{
// Is it an absolute or a relative directory?
$absolute = false;
$absolute = $absolute || (substr($userdir, 0, 1) == '/');
$absolute = $absolute || (substr($userdir, 1, 1) == ':');
$absolute = $absolute || (substr($userdir, 2, 1) == ':');
if (!$absolute)
{
// Make absolute
$tempDir = $absoluteDirToHere . $userdir;
}
else
{
// it's already absolute
$tempDir = $userdir;
}
// Does the directory exist?
if (is_dir($tempDir))
{
// Yeah. Is it writable?
$writable = $this->isDirWritable($tempDir);
}
}
}
$this->tempDir = $tempDir;
if (!$writable)
{
// No writable directory found!!!
$this->setError(AKText::_('FTP_TEMPDIR_NOT_WRITABLE'));
}
else
{
AKFactory::set('kickstart.ftp.tempdir', $tempDir);
$this->tempDir = $tempDir;
}
}
}
/**
* Tries to connect to the FTP server
*
* @return bool
*/
public function connect()
{
if (!$this->useFTP)
{
return false;
}
// Connect to server, using SSL if so required
if ($this->useSSL)
{
$this->handle = @ftp_ssl_connect($this->host, $this->port);
}
else
{
$this->handle = @ftp_connect($this->host, $this->port);
}
if ($this->handle === false)
{
$this->setError(AKText::_('WRONG_FTP_HOST'));
return false;
}
// Login
if (!@ftp_login($this->handle, $this->user, $this->pass))
{
$this->setError(AKText::_('WRONG_FTP_USER'));
@ftp_close($this->handle);
return false;
}
// Change to initial directory
if (!@ftp_chdir($this->handle, $this->dir))
{
$this->setError(AKText::_('WRONG_FTP_PATH1'));
@ftp_close($this->handle);
return false;
}
// Enable passive mode if the user requested it
if ($this->passive)
{
@ftp_pasv($this->handle, true);
}
else
{
@ftp_pasv($this->handle, false);
}
// Try to download ourselves
$testFilename = defined('KSSELFNAME') ? KSSELFNAME : basename(__FILE__);
$tempHandle = fopen('php://temp', 'r+');
if (@ftp_fget($this->handle, $tempHandle, $testFilename, FTP_ASCII, 0) === false)
{
$this->setError(AKText::_('WRONG_FTP_PATH2'));
@ftp_close($this->handle);
fclose($tempHandle);
return false;
}
fclose($tempHandle);
return true;
}
/**
* Is the directory writeable?
*
* @param string $dir The directory ti check
*
* @return bool
*/
private function isDirWritable($dir)
{
$fp = @fopen($dir . '/kickstart.dat', 'w');
if ($fp === false)
{
return false;
}
@fclose($fp);
unlink($dir . '/kickstart.dat');
return true;
}
/**
* Create a directory, recursively
*
* @param string $dirName The directory to create
* @param int $perms The permissions to give to the directory
*
* @return bool
*/
public function createDirRecursive($dirName, $perms)
{
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
// UNIXize the paths
$removePath = str_replace('\\', '/', $removePath);
$dirName = str_replace('\\', '/', $dirName);
// Make sure they both end in a slash
$removePath = rtrim($removePath, '/\\') . '/';
$dirName = rtrim($dirName, '/\\') . '/';
// Process the path removal
$left = substr($dirName, 0, strlen($removePath));
if ($left == $removePath)
{
$dirName = substr($dirName, strlen($removePath));
}
}
// 'cause the substr() above may return FALSE.
if (empty($dirName))
{
$dirName = '';
}
$check = '/' . trim($this->dir, '/') . '/' . trim($dirName, '/');
$checkFS = $removePath . trim($dirName, '/');
if ($this->is_dir($check))
{
return true;
}
$alldirs = explode('/', $dirName);
$previousDir = '/' . trim($this->dir);
$previousDirFS = rtrim($removePath, '/\\');
foreach ($alldirs as $curdir)
{
$check = $previousDir . '/' . $curdir;
$checkFS = $previousDirFS . '/' . $curdir;
if (!is_dir($checkFS) && !$this->is_dir($check))
{
// Proactively try to delete a file by the same name
if (!@unlink($checkFS) && $this->useFTP)
{
@ftp_delete($this->handle, $check);
}
$createdDir = @mkdir($checkFS, 0755);
if (!$createdDir && $this->useFTP)
{
$createdDir = @ftp_mkdir($this->handle, $check);
}
if ($createdDir === false)
{
// If we couldn't create the directory, attempt to fix the permissions in the PHP level and retry!
$this->fixPermissions($checkFS);
$createdDir = @mkdir($checkFS, 0755);
if (!$createdDir && $this->useFTP)
{
$createdDir = @ftp_mkdir($this->handle, $check);
}
if ($createdDir === false)
{
$this->setError(AKText::sprintf('FTP_CANT_CREATE_DIR', $check));
return false;
}
}
if (!@chmod($checkFS, $perms) && $this->useFTP)
{
@ftp_chmod($this->handle, $perms, $check);
}
}
$previousDir = $check;
$previousDirFS = $checkFS;
}
return true;
}
private function is_dir($dir)
{
if ($this->useFTP)
{
return @ftp_chdir($this->handle, $dir);
}
return false;
}
/**
* Tries to fix directory/file permissions in the PHP level, so that
* the FTP operation doesn't fail.
*
* @param $path string The full path to a directory or file
*/
private function fixPermissions($path)
{
// Turn off error reporting
if (!defined('KSDEBUG'))
{
$oldErrorReporting = error_reporting(0);
}
// Get UNIX style paths
$relPath = str_replace('\\', '/', $path);
$basePath = rtrim(str_replace('\\', '/', KSROOTDIR), '/');
$basePath = rtrim($basePath, '/');
if (!empty($basePath))
{
$basePath .= '/';
}
// Remove the leading relative root
if (substr($relPath, 0, strlen($basePath)) == $basePath)
{
$relPath = substr($relPath, strlen($basePath));
}
$dirArray = explode('/', $relPath);
$pathBuilt = rtrim($basePath, '/');
foreach ($dirArray as $dir)
{
if (empty($dir))
{
continue;
}
$oldPath = $pathBuilt;
$pathBuilt .= '/' . $dir;
if (is_dir($oldPath . $dir))
{
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
@chmod($oldPath . $dir, $trustMeIKnowWhatImDoing);
}
else
{
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
if (@chmod($oldPath . $dir, $trustMeIKnowWhatImDoing) === false)
{
@unlink($oldPath . $dir);
}
}
}
// Restore error reporting
if (!defined('KSDEBUG'))
{
@error_reporting($oldErrorReporting);
}
}
/**
* Called after unserialisation, tries to reconnect to FTP
*/
public function __wakeup()
{
if ($this->useFTP)
{
$this->connect();
}
}
public function __sleep()
{
if ($this->useFTP)
{
if (!is_null($this->_handle) && is_resource($this->_handle))
{
@ftp_close($this->_handle);
}
}
$this->_handle = null;
}
public function __destruct()
{
if ($this->useFTP)
{
if (!is_null($this->handle) && is_resource($this->handle))
{
@ftp_close($this->handle);
}
}
}
/**
* Post-process an extracted file, using FTP or direct file writes to move it
*
* @return bool
*/
public function process()
{
if (is_null($this->tempFilename))
{
// If an empty filename is passed, it means that we shouldn't do any post processing, i.e.
// the entity was a directory or symlink
return true;
}
$remotePath = dirname($this->filename);
$removePath = AKFactory::get('kickstart.setup.destdir', '');
$root = rtrim($removePath, '/\\');
if (!empty($removePath))
{
$removePath = ltrim($removePath, "/");
$remotePath = ltrim($remotePath, "/");
$left = substr($remotePath, 0, strlen($removePath));
if ($left == $removePath)
{
$remotePath = substr($remotePath, strlen($removePath));
}
}
$absoluteFSPath = dirname($this->filename);
$relativeFTPPath = trim($remotePath, '/');
$absoluteFTPPath = '/' . trim($this->dir, '/') . '/' . trim($remotePath, '/');
$onlyFilename = basename($this->filename);
$remoteName = $absoluteFTPPath . '/' . $onlyFilename;
// Does the directory exist?
if (!is_dir($root . '/' . $absoluteFSPath))
{
$ret = $this->createDirRecursive($absoluteFSPath, 0755);
if (($ret === false) && ($this->useFTP))
{
$ret = @ftp_chdir($this->handle, $absoluteFTPPath);
}
if ($ret === false)
{
$this->setError(AKText::sprintf('FTP_COULDNT_UPLOAD', $this->filename));
return false;
}
}
if ($this->useFTP)
{
$ret = @ftp_chdir($this->handle, $absoluteFTPPath);
}
// Try copying directly
$ret = @copy($this->tempFilename, $root . '/' . $this->filename);
if ($ret === false)
{
$this->fixPermissions($this->filename);
$this->unlink($this->filename);
$ret = @copy($this->tempFilename, $root . '/' . $this->filename);
}
if ($this->useFTP && ($ret === false))
{
$ret = @ftp_put($this->handle, $remoteName, $this->tempFilename, FTP_BINARY);
if ($ret === false)
{
// If we couldn't create the file, attempt to fix the permissions in the PHP level and retry!
$this->fixPermissions($this->filename);
$this->unlink($this->filename);
$fp = @fopen($this->tempFilename, 'r');
if ($fp !== false)
{
$ret = @ftp_fput($this->handle, $remoteName, $fp, FTP_BINARY);
@fclose($fp);
}
else
{
$ret = false;
}
}
}
@unlink($this->tempFilename);
if ($ret === false)
{
$this->setError(AKText::sprintf('FTP_COULDNT_UPLOAD', $this->filename));
return false;
}
$restorePerms = AKFactory::get('kickstart.setup.restoreperms', false);
$perms = $restorePerms ? $this->perms : 0644;
$ret = @chmod($root . '/' . $this->filename, $perms);
if ($this->useFTP && ($ret === false))
{
@ftp_chmod($this->_handle, $perms, $remoteName);
}
if (@is_file($this->filename) || @is_link($this->filename))
{
clearFileInOPCache($this->filename);
}
return true;
}
public function unlink($file)
{
$ret = @unlink($file);
if (!$ret && $this->useFTP)
{
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($file, 0, strlen($removePath));
if ($left == $removePath)
{
$file = substr($file, strlen($removePath));
}
}
$check = '/' . trim($this->dir, '/') . '/' . trim($file, '/');
$ret = @ftp_delete($this->handle, $check);
}
return $ret;
}
/**
* Create a temporary filename
*
* @param string $filename The original filename
* @param int $perms The file permissions
*
* @return string
*/
public function processFilename($filename, $perms = 0755)
{
// Catch some error conditions...
if ($this->getError())
{
return false;
}
// If a null filename is passed, it means that we shouldn't do any post processing, i.e.
// the entity was a directory or symlink
if (is_null($filename))
{
$this->filename = null;
$this->tempFilename = null;
return null;
}
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($filename, 0, strlen($removePath));
if ($left == $removePath)
{
$filename = substr($filename, strlen($removePath));
}
}
// Trim slash on the left
$filename = ltrim($filename, '/');
$this->filename = $filename;
$this->tempFilename = tempnam($this->tempDir, 'kickstart-');
$this->perms = $perms;
if (empty($this->tempFilename))
{
// Oops! Let's try something different
$this->tempFilename = $this->tempDir . '/kickstart-' . time() . '.dat';
}
return $this->tempFilename;
}
/**
* Closes the FTP connection
*/
public function close()
{
if (!$this->useFTP)
{
@ftp_close($this->handle);
}
}
public function chmod($file, $perms)
{
if (AKFactory::get('kickstart.setup.dryrun', '0'))
{
return true;
}
$ret = @chmod($file, $perms);
if (!$ret && $this->useFTP)
{
// Strip absolute filesystem path to website's root
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($file, 0, strlen($removePath));
if ($left == $removePath)
{
$file = substr($file, strlen($removePath));
}
}
// Trim slash on the left
$file = ltrim($file, '/');
$ret = @ftp_chmod($this->handle, $perms, $file);
}
return $ret;
}
public function rmdir($directory)
{
$ret = @rmdir($directory);
if (!$ret && $this->useFTP)
{
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($directory, 0, strlen($removePath));
if ($left == $removePath)
{
$directory = substr($directory, strlen($removePath));
}
}
$check = '/' . trim($this->dir, '/') . '/' . trim($directory, '/');
$ret = @ftp_rmdir($this->handle, $check);
}
return $ret;
}
public function rename($from, $to)
{
$ret = @rename($from, $to);
if (!$ret && $this->useFTP)
{
$originalFrom = $from;
$originalTo = $to;
$removePath = AKFactory::get('kickstart.setup.destdir', '');
if (!empty($removePath))
{
$left = substr($from, 0, strlen($removePath));
if ($left == $removePath)
{
$from = substr($from, strlen($removePath));
}
}
$from = '/' . trim($this->dir, '/') . '/' . trim($from, '/');
if (!empty($removePath))
{
$left = substr($to, 0, strlen($removePath));
if ($left == $removePath)
{
$to = substr($to, strlen($removePath));
}
}
$to = '/' . trim($this->dir, '/') . '/' . trim($to, '/');
$ret = @ftp_rename($this->handle, $from, $to);
}
return $ret;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* JPA archive extraction class
*/
class AKUnarchiverJPA extends AKAbstractUnarchiver
{
protected $archiveHeaderData = [];
protected function readArchiveHeader()
{
debugMsg('Preparing to read archive header');
// Initialize header data array
$this->archiveHeaderData = new stdClass();
// Open the first part
debugMsg('Opening the first part');
$this->nextFile();
// Fail for unreadable files
if ($this->fp === false)
{
debugMsg('Could not open the first part');
return false;
}
// Fuzzy check for the start of archive.
debugMsg('Fuzzy checking for archive signature');
$sigFound = $this->fuzzySignatureSearch([
'JPA',
], 3);
if (!$sigFound)
{
debugMsg('Cannot find a valid archive signature in the first 128Kb of the first part file');
$this->setError(AKText::sprintf('ERR_INVALID_ARCHIVE_LONG', 'jpa', 'j'));
return false;
}
debugMsg(sprintf('File signature found, position %d', ftell($this->fp)));
// Read the signature
$sig = fread($this->fp, 3);
if ($sig != 'JPA')
{
// Not a JPA file
debugMsg('Invalid archive signature');
$this->setError(AKText::sprintf('ERR_INVALID_ARCHIVE_LONG', 'jpa', 'j'));
return false;
}
// Read and parse header length
$header_length_array = unpack('v', fread($this->fp, 2));
$header_length = $header_length_array[1];
// Read and parse the known portion of header data (14 bytes)
$bin_data = fread($this->fp, 14);
$header_data = unpack('Cmajor/Cminor/Vcount/Vuncsize/Vcsize', $bin_data);
// Temporary array with all the data we read
$temp = [
'signature' => $sig,
'length' => $header_length,
'major' => $header_data['major'],
'minor' => $header_data['minor'],
'filecount' => $header_data['count'],
'uncompressedsize' => $header_data['uncsize'],
'compressedsize' => $header_data['csize'],
'unknowndata' => '',
];
// Load additional header data
$rest_length = $header_length - 19;
$junk = '';
while ($rest_length > 8)
{
// Read the extra length signature and size
$extraSig = fread($this->fp, 4);
$binData = fread($this->fp, 2);
$extraHeader = unpack('vlength', $binData);
$length = $extraHeader['length'] - 2;
$rest_length -= 6 + $length;
switch ($extraSig)
{
case "\x4A\x50\x01\x01":
$moreBinData = fread($this->fp, $length);
$moreExtraHeader = unpack('vtotalParts', $moreBinData);
$temp['totalParts'] = $moreExtraHeader['totalParts'];
break;
case "\x4A\x50\x01\x02":
$moreBinData = fread($this->fp, $length);
// Only decode on 64-bit versions of PHP
if (PHP_INT_SIZE >= 8)
{
$moreExtraHeader = unpack('Puncompressed/Pcompressed', $moreBinData);
$header_data['uncsize'] = $moreExtraHeader['uncompressed'];
$header_data['csize'] = $moreExtraHeader['compressed'];
$temp['uncompressedsize'] = $moreExtraHeader['uncompressed'];
$temp['compressedsize'] = $moreExtraHeader['compressed'];
}
break;
default:
$moreBinData = fread($this->fp, $length);
$junk .= $extraSig . $binData . $moreBinData;
break;
}
}
if ($rest_length > 0)
{
$junk .= fread($this->fp, $rest_length);
}
else
{
$junk .= '';
}
// Array-to-object conversion
foreach ($temp as $key => $value)
{
$this->archiveHeaderData->{$key} = $value;
}
debugMsg('Header data:');
debugMsg('Length : ' . $header_length);
debugMsg('Major : ' . $header_data['major']);
debugMsg('Minor : ' . $header_data['minor']);
debugMsg('File count : ' . $header_data['count']);
debugMsg('Uncompressed size : ' . $header_data['uncsize']);
debugMsg('Compressed size : ' . $header_data['csize']);
debugMsg('Total Parts : ' . (isset($header_data['totalParts']) ? $header_data['totalParts'] : '1'));
$this->currentPartOffset = @ftell($this->fp);
$this->dataReadLength = 0;
return true;
}
/**
* Concrete classes must use this method to read the file header
*
* @return bool True if reading the file was successful, false if an error occurred or we reached end of archive
*/
protected function readFileHeader()
{
// If the current part is over, proceed to the next part please
if ($this->isEOF(true))
{
debugMsg('Archive part EOF; moving to next file');
$this->nextFile();
}
$this->currentPartOffset = ftell($this->fp);
debugMsg("Reading file signature; part {$this->currentPartNumber}, offset {$this->currentPartOffset}");
// Get and decode Entity Description Block
$signature = fread($this->fp, 3);
$this->fileHeader = new stdClass();
$this->fileHeader->timestamp = 0;
// Check signature
if ($signature != 'JPF')
{
if ($this->isEOF(true))
{
// This file is finished; make sure it's the last one
$gotNextFile = $this->nextFile();
if (!$gotNextFile && $this->getState() !== 'postrun')
{
debugMsg(sprintf('Cannot open file %s for part #%d', $this->archiveList[$this->currentPartNumber] ?: '(unknown)', $this->currentPartNumber));
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER_OFFSET_ZERO',
$this->archiveList[$this->currentPartNumber] ?: '(unknown)',
$this->currentPartNumber,
'jpa',
'j'
));
return false;
}
if (!$this->isEOF(false))
{
debugMsg('Invalid file signature before end of archive encountered');
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER',
$this->currentPartNumber,
$this->currentPartOffset,
'jpa',
'j'
));
return false;
}
// We're just finished
return false;
}
else
{
$screwed = true;
if (AKFactory::get('kickstart.setup.ignoreerrors', false))
{
debugMsg('Invalid file block signature; launching heuristic file block signature scanner');
$screwed = !$this->heuristicFileHeaderLocator();
if (!$screwed)
{
$signature = 'JPF';
}
else
{
debugMsg('Heuristics failed. Brace yourself for the imminent crash.');
}
}
if ($screwed)
{
// This is not a file block! The archive is corrupt.
debugMsg('Invalid file block signature');
if (count($this->archiveList) > 1)
{
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER_MULTIPART',
$this->currentPartNumber,
$this->currentPartOffset,
'jpa',
'j'
));
return false;
}
$this->setError(AKText::sprintf('INVALID_FILE_HEADER', $this->currentPartNumber, $this->currentPartOffset));
return false;
}
}
}
// This a JPA Entity Block. Process the header.
$isBannedFile = false;
// Read length of EDB and of the Entity Path Data
$length_array = unpack('vblocksize/vpathsize', fread($this->fp, 4));
// Read the path data
if ($length_array['pathsize'] > 0)
{
$file = fread($this->fp, $length_array['pathsize']);
}
else
{
$file = '';
}
// Handle file renaming
$isRenamed = false;
if (is_array($this->renameFiles) && (count($this->renameFiles) > 0))
{
if (array_key_exists($file, $this->renameFiles))
{
$file = $this->renameFiles[$file];
$isRenamed = true;
}
}
// Handle directory renaming
$isDirRenamed = false;
if (is_array($this->renameDirs) && (count($this->renameDirs) > 0))
{
if (array_key_exists(dirname($file), $this->renameDirs))
{
$file = rtrim($this->renameDirs[dirname($file)], '/') . '/' . basename($file);
$isRenamed = true;
$isDirRenamed = true;
}
}
// Read and parse the known data portion
$bin_data = fread($this->fp, 14);
$header_data = unpack('Ctype/Ccompression/Vcompsize/Vuncompsize/Vperms', $bin_data);
// Read any unknown data
$restBytes = $length_array['blocksize'] - (21 + $length_array['pathsize']);
if ($restBytes > 0)
{
// Start reading the extra fields
while ($restBytes >= 4)
{
$extra_header_data = fread($this->fp, 4);
$extra_header = unpack('vsignature/vlength', $extra_header_data);
$restBytes -= 4;
$extra_header['length'] -= 4;
if ($extra_header['length'] > 0)
{
switch ($extra_header['signature'])
{
case 256:
// File modified timestamp
$bindata = fread($this->fp, $extra_header['length']);
$restBytes -= $extra_header['length'];
$timestamps = unpack('Vmodified', substr($bindata, 0, 4));
$filectime = $timestamps['modified'];
$this->fileHeader->timestamp = $filectime;
break;
case 512:
$bindata = fread($this->fp, $extra_header['length']);
$restBytes -= $extra_header['length'];
// Only decode on 64-bit versions of PHP
if (PHP_INT_SIZE >= 8)
{
$sizes = unpack('Pclen/Punclen', $bindata);
$header_data['compsize'] = $sizes['clen'];
$header_data['uncompsize'] = $sizes['unclen'];
}
break;
default:
// Unknown field
$junk = fread($this->fp, $extra_header['length']);
$restBytes -= $extra_header['length'];
break;
}
}
}
if ($restBytes > 0)
{
$junk = fread($this->fp, $restBytes);
}
}
$compressionType = $header_data['compression'];
// Populate the return array
$this->fileHeader->file = $file;
$this->fileHeader->compressed = $header_data['compsize'];
$this->fileHeader->uncompressed = $header_data['uncompsize'];
switch ($header_data['type'])
{
case 0:
$this->fileHeader->type = 'dir';
break;
case 1:
$this->fileHeader->type = 'file';
break;
case 2:
$this->fileHeader->type = 'link';
break;
}
switch ($compressionType)
{
case 0:
$this->fileHeader->compression = 'none';
break;
case 1:
$this->fileHeader->compression = 'gzip';
break;
case 2:
$this->fileHeader->compression = 'bzip2';
break;
}
$this->fileHeader->permissions = $header_data['perms'];
// Find hard-coded banned files
if ((basename($this->fileHeader->file) == ".") || (basename($this->fileHeader->file) == ".."))
{
$isBannedFile = true;
}
// Also try to find banned files passed in class configuration
if ((count($this->skipFiles) > 0) && (!$isRenamed))
{
if (in_array($this->fileHeader->file, $this->skipFiles))
{
$isBannedFile = true;
}
}
// If we have a banned file, let's skip it
if ($isBannedFile)
{
debugMsg('Skipping file ' . $this->fileHeader->file);
// Advance the file pointer, skipping exactly the size of the compressed data
$seekleft = $this->fileHeader->compressed;
while ($seekleft > 0)
{
// Ensure that we can seek past archive part boundaries
$curSize = @filesize($this->archiveList[$this->currentPartNumber]);
$curPos = @ftell($this->fp);
$canSeek = $curSize - $curPos;
if ($canSeek > $seekleft)
{
$canSeek = $seekleft;
}
@fseek($this->fp, $canSeek, SEEK_CUR);
$seekleft -= $canSeek;
if ($seekleft)
{
$this->nextFile();
}
}
$this->currentPartOffset = @ftell($this->fp);
$this->runState = AK_STATE_DONE;
return true;
}
// Remove the removePath, if any
$this->fileHeader->file = $this->removePath($this->fileHeader->file);
// Last chance to prepend a path to the filename
if (!empty($this->addPath) && !$isDirRenamed)
{
$this->fileHeader->file = $this->addPath . $this->fileHeader->file;
}
// Get the translated path name
$restorePerms = AKFactory::get('kickstart.setup.restoreperms', false);
if (!$this->mustSkip())
{
if ($this->fileHeader->type == 'file')
{
// Regular file; ask the postproc engine to process its filename
if ($restorePerms)
{
$this->fileHeader->realFile =
$this->postProcEngine->processFilename($this->fileHeader->file, $this->fileHeader->permissions);
}
else
{
$this->fileHeader->realFile = $this->postProcEngine->processFilename($this->fileHeader->file);
}
}
elseif ($this->fileHeader->type == 'dir')
{
$dir = $this->fileHeader->file;
// Directory; just create it
if ($restorePerms)
{
$this->postProcEngine->createDirRecursive($dir, $this->fileHeader->permissions);
}
else
{
$this->postProcEngine->createDirRecursive($dir, 0755);
}
$this->postProcEngine->processFilename(null);
}
else
{
// Symlink; do not post-process
$this->postProcEngine->processFilename(null);
}
$this->createDirectory();
}
// Header is read
$this->runState = AK_STATE_HEADER;
$this->dataReadLength = 0;
return true;
}
protected function heuristicFileHeaderLocator()
{
$ret = false;
$fullEOF = false;
while (!$ret && !$fullEOF)
{
$this->currentPartOffset = @ftell($this->fp);
if ($this->isEOF(true))
{
$this->nextFile();
}
if ($this->isEOF(false))
{
$fullEOF = true;
continue;
}
// Read 512Kb
$chunk = fread($this->fp, 524288);
$size_read = mb_strlen($chunk, '8bit');
//$pos = strpos($chunk, 'JPF');
$pos = mb_strpos($chunk, 'JPF', 0, '8bit');
if ($pos !== false)
{
// We found it!
$this->currentPartOffset += $pos + 3;
@fseek($this->fp, $this->currentPartOffset, SEEK_SET);
$ret = true;
}
else
{
// Not yet found :(
$this->currentPartOffset = @ftell($this->fp);
}
}
return $ret;
}
/**
* Creates the directory this file points to
*/
protected function createDirectory()
{
if ($this->mustSkip())
{
return true;
}
// Do we need to create a directory?
if (empty($this->fileHeader->realFile))
{
$this->fileHeader->realFile = $this->fileHeader->file;
}
$lastSlash = strrpos($this->fileHeader->realFile, '/');
$dirName = substr($this->fileHeader->realFile, 0, $lastSlash);
$perms = $this->flagRestorePermissions ? $this->fileHeader->permissions : 0755;
$ignore = AKFactory::get('kickstart.setup.ignoreerrors', false) || $this->isIgnoredDirectory($dirName);
if (($this->postProcEngine->createDirRecursive($dirName, $perms) == false) && (!$ignore))
{
$this->setError(AKText::sprintf('COULDNT_CREATE_DIR', $dirName));
return false;
}
else
{
return true;
}
}
/**
* Concrete classes must use this method to process file data. It must set $runState to AK_STATE_DATAREAD when
* it's finished processing the file data.
*
* @return bool True if processing the file data was successful, false if an error occurred
*/
protected function processFileData()
{
switch ($this->fileHeader->type)
{
case 'dir':
return $this->processTypeDir();
break;
case 'link':
return $this->processTypeLink();
break;
case 'file':
switch ($this->fileHeader->compression)
{
case 'none':
return $this->processTypeFileUncompressed();
break;
case 'gzip':
case 'bzip2':
return $this->processTypeFileCompressedSimple();
break;
}
break;
default:
debugMsg('Unknown file type ' . $this->fileHeader->type);
break;
}
}
/**
* Process the file data of a directory entry
*
* @return bool
*/
private function processTypeDir()
{
// Directory entries in the JPA do not have file data, therefore we're done processing the entry
$this->runState = AK_STATE_DATAREAD;
return true;
}
/**
* Process the file data of a link entry
*
* @return bool
*/
private function processTypeLink()
{
$readBytes = 0;
$toReadBytes = 0;
$leftBytes = $this->fileHeader->compressed;
$data = '';
while ($leftBytes > 0)
{
$toReadBytes = ($leftBytes > $this->chunkSize) ? $this->chunkSize : $leftBytes;
$mydata = $this->fread($this->fp, $toReadBytes);
$reallyReadBytes = akstringlen($mydata);
$data .= $mydata;
$leftBytes -= $reallyReadBytes;
if ($reallyReadBytes < $toReadBytes)
{
// We read less than requested! Why? Did we hit local EOF?
if ($this->isEOF(true) && !$this->isEOF(false))
{
// Yeap. Let's go to the next file
$this->nextFile();
}
else
{
debugMsg('End of local file before reading all data with no more parts left. The archive is corrupt or truncated.');
// Nope. The archive is corrupt
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
}
$filename = isset($this->fileHeader->realFile) ? $this->fileHeader->realFile : $this->fileHeader->file;
if (!$this->mustSkip())
{
// Try to remove an existing file or directory by the same name
if (file_exists($filename))
{
@unlink($filename);
@rmdir($filename);
}
// Remove any trailing slash
if (substr($filename, -1) == '/')
{
$filename = substr($filename, 0, -1);
}
// Create the symlink - only possible within PHP context. There's no support built in the FTP protocol, so no postproc use is possible here :(
@symlink($data, $filename);
}
$this->runState = AK_STATE_DATAREAD;
return true; // No matter if the link was created!
}
private function processTypeFileUncompressed()
{
// Uncompressed files are being processed in small chunks, to avoid timeouts
if (($this->dataReadLength == 0) && !$this->mustSkip())
{
// Before processing file data, ensure permissions are adequate
$this->setCorrectPermissions($this->fileHeader->file);
clearstatcache($this->fileHeader->file);
}
// Open the output file
if (!$this->mustSkip())
{
$ignore =
AKFactory::get('kickstart.setup.ignoreerrors', false) || $this->isIgnoredDirectory($this->fileHeader->file);
if ($this->dataReadLength == 0)
{
$outfp = @fopen($this->fileHeader->realFile, 'w');
}
else
{
$outfp = @fopen($this->fileHeader->realFile, 'a');
}
// Can we write to the file?
if (($outfp === false) && (!$ignore))
{
// An error occurred
debugMsg('Could not write to output file');
$this->setError(AKText::sprintf('COULDNT_WRITE_FILE', $this->fileHeader->realFile));
return false;
}
}
// Does the file have any data, at all?
if ($this->fileHeader->compressed == 0)
{
// No file data!
if (!$this->mustSkip() && is_resource($outfp))
{
@fclose($outfp);
}
$this->runState = AK_STATE_DATAREAD;
return true;
}
// Reference to the global timer
$timer = AKFactory::getTimer();
$toReadBytes = 0;
$leftBytes = $this->fileHeader->compressed - $this->dataReadLength;
// Loop while there's data to read and enough time to do it
while (($leftBytes > 0) && ($timer->getTimeLeft() > 0))
{
$toReadBytes = ($leftBytes > $this->chunkSize) ? $this->chunkSize : $leftBytes;
$data = $this->fread($this->fp, $toReadBytes);
$reallyReadBytes = akstringlen($data);
$leftBytes -= $reallyReadBytes;
$this->dataReadLength += $reallyReadBytes;
if ($reallyReadBytes < $toReadBytes)
{
// We read less than requested! Why? Did we hit local EOF?
if ($this->isEOF(true) && !$this->isEOF(false))
{
// Yeap. Let's go to the next file
$this->nextFile();
}
else
{
// Nope. The archive is corrupt
debugMsg('Not enough data in file. The archive is truncated or corrupt.');
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
if (!$this->mustSkip())
{
if (is_resource($outfp))
{
@fwrite($outfp, $data);
}
}
}
// Close the file pointer
if (!$this->mustSkip())
{
if (is_resource($outfp))
{
@fclose($outfp);
}
}
// Was this a pre-timeout bail out?
if ($leftBytes > 0)
{
$this->runState = AK_STATE_DATA;
}
else
{
// Oh! We just finished!
$this->runState = AK_STATE_DATAREAD;
$this->dataReadLength = 0;
}
return true;
}
private function processTypeFileCompressedSimple()
{
if (!$this->mustSkip())
{
// Before processing file data, ensure permissions are adequate
$this->setCorrectPermissions($this->fileHeader->file);
clearstatcache($this->fileHeader->file);
// Open the output file
$outfp = @fopen($this->fileHeader->realFile, 'w');
// Can we write to the file?
$ignore =
AKFactory::get('kickstart.setup.ignoreerrors', false) || $this->isIgnoredDirectory($this->fileHeader->file);
if (($outfp === false) && (!$ignore))
{
// An error occurred
debugMsg('Could not write to output file');
$this->setError(AKText::sprintf('COULDNT_WRITE_FILE', $this->fileHeader->realFile));
return false;
}
}
// Does the file have any data, at all?
if ($this->fileHeader->compressed == 0)
{
// No file data!
if (!$this->mustSkip())
{
if (is_resource($outfp))
{
@fclose($outfp);
}
}
$this->runState = AK_STATE_DATAREAD;
return true;
}
// Simple compressed files are processed as a whole; we can't do chunk processing
$zipData = $this->fread($this->fp, $this->fileHeader->compressed);
while (akstringlen($zipData) < $this->fileHeader->compressed)
{
// End of local file before reading all data, but have more archive parts?
if ($this->isEOF(true) && !$this->isEOF(false))
{
// Yeap. Read from the next file
$this->nextFile();
$bytes_left = $this->fileHeader->compressed - akstringlen($zipData);
$zipData .= $this->fread($this->fp, $bytes_left);
}
else
{
debugMsg('End of local file before reading all data with no more parts left. The archive is corrupt or truncated.');
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
if ($this->fileHeader->compression == 'gzip')
{
$unzipData = gzinflate($zipData);
}
elseif ($this->fileHeader->compression == 'bzip2')
{
$unzipData = bzdecompress($zipData);
}
unset($zipData);
// Write to the file.
if (!$this->mustSkip() && is_resource($outfp))
{
@fwrite($outfp, $unzipData, $this->fileHeader->uncompressed);
@fclose($outfp);
}
unset($unzipData);
$this->runState = AK_STATE_DATAREAD;
return true;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* ZIP archive extraction class
*
* Since the file data portion of ZIP and JPA are similarly structured (it's empty for dirs,
* linked node name for symlinks, dumped binary data for no compressions and dumped gzipped
* binary data for gzip compression) we just have to subclass AKUnarchiverJPA and change the
* header reading bits. Reusable code ;)
*/
class AKUnarchiverZIP extends AKUnarchiverJPA
{
public $expectDataDescriptor = false;
protected function readArchiveHeader()
{
debugMsg('Preparing to read archive header');
// Initialize header data array
$this->archiveHeaderData = new stdClass();
// Open the first part
debugMsg('Opening the first part');
$this->nextFile();
// Fail for unreadable files
if ($this->fp === false)
{
debugMsg('The first part is not readable');
return false;
}
// Fuzzy check for the start of archive.
debugMsg('Fuzzy checking for archive signature');
$sigFound = $this->fuzzySignatureSearch([
pack('V', 0x08074b50), // Multi-part ZIP
pack('V', 0x30304b50), // Multi-part ZIP (alternate)
pack('V', 0x04034b50) // Single file
], 4);
if (!$sigFound)
{
debugMsg('Cannot find a valid archive signature in the first 128Kb of the first part file');
$this->setError(AKText::sprintf('ERR_INVALID_ARCHIVE_LONG', 'zip', 'z'));
return false;
}
debugMsg(sprintf('File signature found, position %d', ftell($this->fp)));
// Read a possible multipart signature
$sigBinary = fread($this->fp, 4);
$headerData = unpack('Vsig', $sigBinary);
// Roll back if it's not a multipart archive
if ($headerData['sig'] == 0x04034b50)
{
debugMsg('The archive is not multipart');
fseek($this->fp, -4, SEEK_CUR);
}
else
{
debugMsg('The archive is multipart');
}
$multiPartSigs = [
0x08074b50, // Multi-part ZIP
0x30304b50, // Multi-part ZIP (alternate)
0x04034b50 // Single file
];
if (!in_array($headerData['sig'], $multiPartSigs))
{
debugMsg('Invalid header signature ' . dechex($headerData['sig']));
$this->setError(AKText::sprintf('ERR_INVALID_ARCHIVE_LONG', 'zip', 'z'));
return false;
}
$this->currentPartOffset = @ftell($this->fp);
debugMsg('Current part offset after reading header: ' . $this->currentPartOffset);
$this->dataReadLength = 0;
return true;
}
/**
* Concrete classes must use this method to read the file header
*
* @return bool True if reading the file was successful, false if an error occurred or we reached end of archive
*/
protected function readFileHeader()
{
// If the current part is over, proceed to the next part please
if ($this->isEOF(true))
{
debugMsg('Opening next archive part');
$gotNextFile = $this->nextFile();
}
$this->currentPartOffset = ftell($this->fp);
if ($this->expectDataDescriptor)
{
// The last file had bit 3 of the general purpose bit flag set. This means that we have a
// 12 byte data descriptor we need to skip. To make things worse, there might also be a 4
// byte optional data descriptor header (0x08074b50).
$junk = @fread($this->fp, 4);
$junk = unpack('Vsig', $junk);
if ($junk['sig'] == 0x08074b50)
{
// Yes, there was a signature
$junk = @fread($this->fp, 12);
debugMsg('Data descriptor (w/ header) skipped at ' . (ftell($this->fp) - 12));
}
else
{
// No, there was no signature, just read another 8 bytes
$junk = @fread($this->fp, 8);
debugMsg('Data descriptor (w/out header) skipped at ' . (ftell($this->fp) - 8));
}
// And check for EOF, too
if ($this->isEOF(true))
{
debugMsg('EOF before reading header');
$gotNextFile = $this->nextFile();
}
}
// Get and decode Local File Header
$headerBinary = fread($this->fp, 30);
$headerData =
unpack('Vsig/C2ver/vbitflag/vcompmethod/vlastmodtime/vlastmoddate/Vcrc/Vcompsize/Vuncomp/vfnamelen/veflen', $headerBinary);
// Check signature
if (!($headerData['sig'] == 0x04034b50))
{
debugMsg('Not a file signature at ' . (ftell($this->fp) - 4));
// The signature is not the one used for files. Is this a central directory record (i.e. we're done)?
if ($headerData['sig'] == 0x02014b50)
{
debugMsg('EOCD signature at ' . (ftell($this->fp) - 4));
// End of ZIP file detected. We'll just skip to the end of file...
while ($this->nextFile())
{
};
@fseek($this->fp, 0, SEEK_END); // Go to EOF
return false;
}
else
{
if (isset($gotNextFile) && !$gotNextFile && $this->getState() !== 'postrun')
{
debugMsg(sprintf('Cannot open file %s for part #%d', $this->archiveList[$this->currentPartNumber] ?: '(unknown)', $this->currentPartNumber));
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER_OFFSET_ZERO',
$this->archiveList[$this->currentPartNumber] ?: '(unknown)',
$this->currentPartNumber,
'zip',
'z'
));
return false;
}
if ($this->currentPartOffset === 0 && $this->currentPartNumber > 0)
{
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER_MULTIPART',
$this->currentPartNumber,
$this->currentPartOffset,
'jpa',
'j'
));
return false;
}
debugMsg('Invalid signature ' . dechex($headerData['sig']) . ' at ' . ftell($this->fp));
if (count($this->archiveList) > 1)
{
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER_MULTIPART',
$this->currentPartNumber,
$this->currentPartOffset,
'zip',
'z'
));
return false;
}
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER',
$this->currentPartNumber,
$this->currentPartOffset,
'zip',
'z'
));
return false;
}
}
// If bit 3 of the bitflag is set, expectDataDescriptor is true
$this->expectDataDescriptor = ($headerData['bitflag'] & 4) == 4;
$this->fileHeader = new stdClass();
$this->fileHeader->timestamp = 0;
// Read the last modified data and time
$lastmodtime = $headerData['lastmodtime'];
$lastmoddate = $headerData['lastmoddate'];
if ($lastmoddate && $lastmodtime)
{
// ----- Extract time
$v_hour = ($lastmodtime & 0xF800) >> 11;
$v_minute = ($lastmodtime & 0x07E0) >> 5;
$v_seconde = ($lastmodtime & 0x001F) * 2;
// ----- Extract date
$v_year = (($lastmoddate & 0xFE00) >> 9) + 1980;
$v_month = ($lastmoddate & 0x01E0) >> 5;
$v_day = $lastmoddate & 0x001F;
// ----- Get UNIX date format
$this->fileHeader->timestamp = @mktime($v_hour, $v_minute, $v_seconde, $v_month, $v_day, $v_year);
}
$isBannedFile = false;
$this->fileHeader->compressed = $headerData['compsize'];
$this->fileHeader->uncompressed = $headerData['uncomp'];
$nameFieldLength = $headerData['fnamelen'];
$extraFieldLength = $headerData['eflen'];
// Read filename field
$this->fileHeader->file = fread($this->fp, $nameFieldLength);
// Handle file renaming
$isRenamed = false;
if (is_array($this->renameFiles) && (count($this->renameFiles) > 0))
{
if (array_key_exists($this->fileHeader->file, $this->renameFiles))
{
$this->fileHeader->file = $this->renameFiles[$this->fileHeader->file];
$isRenamed = true;
}
}
// Handle directory renaming
$isDirRenamed = false;
if (is_array($this->renameDirs) && (count($this->renameDirs) > 0))
{
if (array_key_exists(dirname($this->fileHeader->file), $this->renameDirs))
{
$file =
rtrim($this->renameDirs[dirname($this->fileHeader->file)], '/') . '/' . basename($this->fileHeader->file);
$isRenamed = true;
$isDirRenamed = true;
}
}
// Read extra field if present
if ($extraFieldLength > 0)
{
$extrafield = fread($this->fp, $extraFieldLength);
}
debugMsg('*' . ftell($this->fp) . ' IS START OF ' . $this->fileHeader->file . ' (' . $this->fileHeader->compressed . ' bytes)');
// Decide filetype -- Check for directories
$this->fileHeader->type = 'file';
if (strrpos($this->fileHeader->file, '/') == strlen($this->fileHeader->file) - 1)
{
$this->fileHeader->type = 'dir';
}
// Decide filetype -- Check for symbolic links
if (($headerData['ver1'] == 10) && ($headerData['ver2'] == 3))
{
$this->fileHeader->type = 'link';
}
switch ($headerData['compmethod'])
{
case 0:
$this->fileHeader->compression = 'none';
break;
case 8:
$this->fileHeader->compression = 'gzip';
break;
}
// Find hard-coded banned files
if ((basename($this->fileHeader->file) == ".") || (basename($this->fileHeader->file) == ".."))
{
$isBannedFile = true;
}
// Also try to find banned files passed in class configuration
if ((count($this->skipFiles) > 0) && (!$isRenamed))
{
if (in_array($this->fileHeader->file, $this->skipFiles))
{
$isBannedFile = true;
}
}
// If we have a banned file, let's skip it
if ($isBannedFile)
{
// Advance the file pointer, skipping exactly the size of the compressed data
$seekleft = $this->fileHeader->compressed;
while ($seekleft > 0)
{
// Ensure that we can seek past archive part boundaries
$curSize = @filesize($this->archiveList[$this->currentPartNumber]);
$curPos = @ftell($this->fp);
$canSeek = $curSize - $curPos;
if ($canSeek > $seekleft)
{
$canSeek = $seekleft;
}
@fseek($this->fp, $canSeek, SEEK_CUR);
$seekleft -= $canSeek;
if ($seekleft)
{
$this->nextFile();
}
}
$this->currentPartOffset = @ftell($this->fp);
$this->runState = AK_STATE_DONE;
return true;
}
// Remove the removePath, if any
$this->fileHeader->file = $this->removePath($this->fileHeader->file);
// Last chance to prepend a path to the filename
if (!empty($this->addPath) && !$isDirRenamed)
{
$this->fileHeader->file = $this->addPath . $this->fileHeader->file;
}
// Get the translated path name
if (!$this->mustSkip())
{
if ($this->fileHeader->type == 'file')
{
$this->fileHeader->realFile = $this->postProcEngine->processFilename($this->fileHeader->file);
}
elseif ($this->fileHeader->type == 'dir')
{
$this->fileHeader->timestamp = 0;
$dir = $this->fileHeader->file;
$this->postProcEngine->createDirRecursive($dir, 0755);
$this->postProcEngine->processFilename(null);
}
else
{
// Symlink; do not post-process
$this->fileHeader->timestamp = 0;
$this->postProcEngine->processFilename(null);
}
$this->createDirectory();
}
// Header is read
$this->runState = AK_STATE_HEADER;
return true;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* JPS archive extraction class
*/
class AKUnarchiverJPS extends AKUnarchiverJPA
{
/**
* Header data for the archive
*
* @var array
*/
protected $archiveHeaderData = [];
/**
* Plaintext password from which the encryption key will be derived with PBKDF2
*
* @var string
*/
protected $password = '';
/**
* Which hash algorithm should I use for key derivation with PBKDF2.
*
* @var string
*/
private $pbkdf2Algorithm = 'sha1';
/**
* How many iterations should I use for key derivation with PBKDF2
*
* @var int
*/
private $pbkdf2Iterations = 1000;
/**
* Should I use a static salt for key derivation with PBKDF2?
*
* @var bool
*/
private $pbkdf2UseStaticSalt = 0;
/**
* Static salt for key derivation with PBKDF2
*
* @var string
*/
private $pbkdf2StaticSalt = "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
/**
* How much compressed data I have read since the last file header read
*
* @var int
*/
private $compressedSizeReadSinceLastFileHeader = 0;
public function __construct()
{
$this->password = AKFactory::get('kickstart.jps.password', '');
}
public function __wakeup()
{
parent::__wakeup();
// Make sure the decryption is all set up (required!)
AKEncryptionAES::setPbkdf2Algorithm($this->pbkdf2Algorithm);
AKEncryptionAES::setPbkdf2Iterations($this->pbkdf2Iterations);
AKEncryptionAES::setPbkdf2UseStaticSalt($this->pbkdf2UseStaticSalt);
AKEncryptionAES::setPbkdf2StaticSalt($this->pbkdf2StaticSalt);
}
protected function readArchiveHeader()
{
// Initialize header data array
$this->archiveHeaderData = new stdClass();
// Open the first part
$this->nextFile();
// Fail for unreadable files
if ($this->fp === false)
{
return false;
}
// Fuzzy check for the start of archive.
debugMsg('Fuzzy checking for archive signature');
$sigFound = $this->fuzzySignatureSearch([
'JPS'
], 3);
if (!$sigFound)
{
debugMsg('Cannot find a valid archive signature in the first 128Kb of the first part file');
$this->setError(AKText::sprintf('ERR_INVALID_ARCHIVE_LONG', 'jps', 'j'));
return false;
}
debugMsg(sprintf('File signature found, position %d', ftell($this->fp)));
// Read the signature
$sig = fread($this->fp, 3);
if ($sig != 'JPS')
{
// Not a JPS file
$this->setError(AKText::sprintf('ERR_INVALID_ARCHIVE_LONG', 'jps', 'j'));
return false;
}
// Read and parse the known portion of header data (5 bytes)
$bin_data = fread($this->fp, 5);
$header_data = unpack('Cmajor/Cminor/cspanned/vextra', $bin_data);
// Is this a v2 archive?
$versionHumanReadable = $header_data['major'] . '.' . $header_data['minor'];
$isV2Archive = version_compare($versionHumanReadable, '2.0', 'ge');
// Load any remaining header data
$rest_length = $header_data['extra'];
if ($isV2Archive && $rest_length)
{
// V2 archives only have one kind of extra header
if (!$this->readKeyExpansionExtraHeader())
{
return false;
}
}
elseif ($rest_length > 0)
{
$junk = fread($this->fp, $rest_length);
}
// Temporary array with all the data we read
$temp = [
'signature' => $sig,
'major' => $header_data['major'],
'minor' => $header_data['minor'],
'spanned' => $header_data['spanned']
];
// Array-to-object conversion
foreach ($temp as $key => $value)
{
$this->archiveHeaderData->{$key} = $value;
}
$this->currentPartOffset = @ftell($this->fp);
$this->dataReadLength = 0;
return true;
}
/**
* Concrete classes must use this method to read the file header
*
* @return bool True if reading the file was successful, false if an error occurred or we reached end of archive
*/
protected function readFileHeader()
{
// If the current part is over, proceed to the next part please
if ($this->isEOF(true))
{
$this->nextFile();
}
$this->currentPartOffset = ftell($this->fp);
// Get and decode Entity Description Block
$signature = fread($this->fp, 3);
// Check for end-of-archive siganture
if ($signature == 'JPE')
{
$this->setState('postrun');
return true;
}
$this->fileHeader = new stdClass();
$this->fileHeader->timestamp = 0;
// Check signature
if ($signature != 'JPF')
{
if ($this->isEOF(true))
{
// This file is finished; make sure it's the last one
$gotNextFile = $this->nextFile();
if (!$gotNextFile && $this->getState() !== 'postrun')
{
debugMsg(sprintf('Cannot open file %s for part #%d', $this->archiveList[$this->currentPartNumber] ?: '(unknown)', $this->currentPartNumber));
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER_OFFSET_ZERO',
$this->archiveList[$this->currentPartNumber] ?: '(unknown)',
$this->currentPartNumber,
'jps',
'j'
));
return false;
}
if (!$this->isEOF(false))
{
$this->setError(AKText::sprintf('INVALID_FILE_HEADER', $this->currentPartNumber, $this->currentPartOffset));
return false;
}
// We're just finished
return false;
}
else
{
fseek($this->fp, -6, SEEK_CUR);
$signature = fread($this->fp, 3);
if ($signature == 'JPE')
{
return false;
}
if (count($this->archiveList) > 1)
{
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER_MULTIPART',
$this->currentPartNumber,
$this->currentPartOffset,
'jps',
'j'
));
return false;
}
$this->setError(AKText::sprintf(
'INVALID_FILE_HEADER',
$this->currentPartNumber,
$this->currentPartOffset,
'jps',
'j'
));
return false;
}
}
// This a JPS Entity Block. Process the header.
$isBannedFile = false;
// Make sure the decryption is all set up
AKEncryptionAES::setPbkdf2Algorithm($this->pbkdf2Algorithm);
AKEncryptionAES::setPbkdf2Iterations($this->pbkdf2Iterations);
AKEncryptionAES::setPbkdf2UseStaticSalt($this->pbkdf2UseStaticSalt);
AKEncryptionAES::setPbkdf2StaticSalt($this->pbkdf2StaticSalt);
// Read and decrypt the header
$edbhData = fread($this->fp, 4);
$edbh = unpack('vencsize/vdecsize', $edbhData);
$bin_data = fread($this->fp, $edbh['encsize']);
// Add the header length to the data read
$this->compressedSizeReadSinceLastFileHeader += $edbh['encsize'] + 4;
// Decrypt and truncate
$bin_data = AKEncryptionAES::AESDecryptCBC($bin_data, $this->password);
$bin_data = substr($bin_data, 0, $edbh['decsize']);
// Read length of EDB and of the Entity Path Data
$length_array = unpack('vpathsize', substr($bin_data, 0, 2));
// Read the path data
$file = substr($bin_data, 2, $length_array['pathsize']);
// Handle file renaming
$isRenamed = false;
if (is_array($this->renameFiles) && (count($this->renameFiles) > 0))
{
if (array_key_exists($file, $this->renameFiles))
{
$file = $this->renameFiles[$file];
$isRenamed = true;
}
}
// Handle directory renaming
$isDirRenamed = false;
if (is_array($this->renameDirs) && (count($this->renameDirs) > 0))
{
if (array_key_exists(dirname($file), $this->renameDirs))
{
$file = rtrim($this->renameDirs[dirname($file)], '/') . '/' . basename($file);
$isRenamed = true;
$isDirRenamed = true;
}
}
// Read and parse the known data portion
$bin_data = substr($bin_data, 2 + $length_array['pathsize']);
$header_data = unpack('Ctype/Ccompression/Vuncompsize/Vperms/Vfilectime', $bin_data);
$this->fileHeader->timestamp = $header_data['filectime'];
$compressionType = $header_data['compression'];
// Populate the return array
$this->fileHeader->file = $file;
$this->fileHeader->uncompressed = $header_data['uncompsize'];
switch ($header_data['type'])
{
case 0:
$this->fileHeader->type = 'dir';
break;
case 1:
$this->fileHeader->type = 'file';
break;
case 2:
$this->fileHeader->type = 'link';
break;
}
switch ($compressionType)
{
case 0:
$this->fileHeader->compression = 'none';
break;
case 1:
$this->fileHeader->compression = 'gzip';
break;
case 2:
$this->fileHeader->compression = 'bzip2';
break;
}
$this->fileHeader->permissions = $header_data['perms'];
// Find hard-coded banned files
if ((basename($this->fileHeader->file) == ".") || (basename($this->fileHeader->file) == ".."))
{
$isBannedFile = true;
}
// Also try to find banned files passed in class configuration
if ((count($this->skipFiles) > 0) && (!$isRenamed))
{
if (in_array($this->fileHeader->file, $this->skipFiles))
{
$isBannedFile = true;
}
}
// If we have a banned file, let's skip it
if ($isBannedFile)
{
$done = false;
while (!$done)
{
// Read the Data Chunk Block header
$binMiniHead = fread($this->fp, 8);
if (in_array(substr($binMiniHead, 0, 3), ['JPF', 'JPE']))
{
// Not a Data Chunk Block header, I am done skipping the file
@fseek($this->fp, -8, SEEK_CUR); // Roll back the file pointer
$done = true; // Mark as done
continue; // Exit loop
}
else
{
// Skip forward by the amount of compressed data
$miniHead = unpack('Vencsize/Vdecsize', $binMiniHead);
@fseek($this->fp, $miniHead['encsize'], SEEK_CUR);
$this->compressedSizeReadSinceLastFileHeader += 8 + $miniHead['encsize'];
}
}
$this->currentPartOffset = @ftell($this->fp);
$this->runState = AK_STATE_DONE;
$this->fileHeader->compressed = $this->compressedSizeReadSinceLastFileHeader;
$this->compressedSizeReadSinceLastFileHeader = 0;
return true;
}
// Remove the removePath, if any
$this->fileHeader->file = $this->removePath($this->fileHeader->file);
// Last chance to prepend a path to the filename
if (!empty($this->addPath) && !$isDirRenamed)
{
$this->fileHeader->file = $this->addPath . $this->fileHeader->file;
}
// Get the translated path name
$restorePerms = AKFactory::get('kickstart.setup.restoreperms', false);
if (!$this->mustSkip())
{
if ($this->fileHeader->type == 'file')
{
// Regular file; ask the postproc engine to process its filename
if ($restorePerms)
{
$this->fileHeader->realFile =
$this->postProcEngine->processFilename($this->fileHeader->file, $this->fileHeader->permissions);
}
else
{
$this->fileHeader->realFile = $this->postProcEngine->processFilename($this->fileHeader->file);
}
}
elseif ($this->fileHeader->type == 'dir')
{
$dir = $this->fileHeader->file;
$this->fileHeader->realFile = $dir;
// Directory; just create it
if ($restorePerms)
{
$this->postProcEngine->createDirRecursive($this->fileHeader->file, $this->fileHeader->permissions);
}
else
{
$this->postProcEngine->createDirRecursive($this->fileHeader->file, 0755);
}
$this->postProcEngine->processFilename(null);
}
else
{
// Symlink; do not post-process
$this->postProcEngine->processFilename(null);
}
$this->createDirectory();
}
$this->fileHeader->compressed = $this->compressedSizeReadSinceLastFileHeader;
$this->compressedSizeReadSinceLastFileHeader = 0;
// Header is read
$this->runState = AK_STATE_HEADER;
$this->dataReadLength = 0;
return true;
}
/**
* Creates the directory this file points to
*/
protected function createDirectory()
{
if ($this->mustSkip())
{
return true;
}
// Do we need to create a directory?
$lastSlash = strrpos($this->fileHeader->realFile, '/');
$dirName = substr($this->fileHeader->realFile, 0, $lastSlash);
$perms = 0755;
$ignore = AKFactory::get('kickstart.setup.ignoreerrors', false) || $this->isIgnoredDirectory($dirName);
if (($this->postProcEngine->createDirRecursive($dirName, $perms) == false) && (!$ignore))
{
$this->setError(AKText::sprintf('COULDNT_CREATE_DIR', $dirName));
return false;
}
return true;
}
/**
* Concrete classes must use this method to process file data. It must set $runState to AK_STATE_DATAREAD when
* it's finished processing the file data.
*
* @return bool True if processing the file data was successful, false if an error occurred
*/
protected function processFileData()
{
switch ($this->fileHeader->type)
{
case 'dir':
return $this->processTypeDir();
break;
case 'link':
return $this->processTypeLink();
break;
case 'file':
switch ($this->fileHeader->compression)
{
case 'none':
return $this->processTypeFileUncompressed();
break;
case 'gzip':
case 'bzip2':
return $this->processTypeFileCompressedSimple();
break;
}
break;
}
}
/**
* Process the file data of a directory entry
*
* @return bool
*/
private function processTypeDir()
{
// Directory entries in the JPA do not have file data, therefore we're done processing the entry
$this->runState = AK_STATE_DATAREAD;
return true;
}
/**
* Process the file data of a link entry
*
* @return bool
*/
private function processTypeLink()
{
// Does the file have any data, at all?
if ($this->fileHeader->uncompressed == 0)
{
// No file data!
$this->runState = AK_STATE_DATAREAD;
return true;
}
// Read the mini header
$binMiniHeader = fread($this->fp, 8);
$reallyReadBytes = akstringlen($binMiniHeader);
if ($reallyReadBytes < 8)
{
// We read less than requested! Why? Did we hit local EOF?
if ($this->isEOF(true) && !$this->isEOF(false))
{
// Yeap. Let's go to the next file
$this->nextFile();
// Retry reading the header
$binMiniHeader = fread($this->fp, 8);
$reallyReadBytes = akstringlen($binMiniHeader);
// Still not enough data? If so, the archive is corrupt or missing parts.
if ($reallyReadBytes < 8)
{
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
else
{
// Nope. The archive is corrupt
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
// Read the encrypted data
$miniHeader = unpack('Vencsize/Vdecsize', $binMiniHeader);
$toReadBytes = $miniHeader['encsize'];
$data = $this->fread($this->fp, $toReadBytes);
$reallyReadBytes = akstringlen($data);
$this->compressedSizeReadSinceLastFileHeader += 8 + $miniHeader['encsize'];
if ($reallyReadBytes < $toReadBytes)
{
// We read less than requested! Why? Did we hit local EOF?
if ($this->isEOF(true) && !$this->isEOF(false))
{
// Yeap. Let's go to the next file
$this->nextFile();
// Read the rest of the data
$toReadBytes -= $reallyReadBytes;
$restData = $this->fread($this->fp, $toReadBytes);
$reallyReadBytes = akstringlen($data);
if ($reallyReadBytes < $toReadBytes)
{
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
$data .= $restData;
}
else
{
// Nope. The archive is corrupt
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
// Decrypt the data
$data = AKEncryptionAES::AESDecryptCBC($data, $this->password);
// Is the length of the decrypted data less than expected?
$data_length = akstringlen($data);
if ($data_length < $miniHeader['decsize'])
{
$this->setError(AKText::_('ERR_INVALID_JPS_PASSWORD'));
return false;
}
// Trim the data
$data = substr($data, 0, $miniHeader['decsize']);
if (!$this->mustSkip())
{
// Try to remove an existing file or directory by the same name
if (file_exists($this->fileHeader->file))
{
@unlink($this->fileHeader->file);
@rmdir($this->fileHeader->file);
}
// Remove any trailing slash
if (substr($this->fileHeader->file, -1) == '/')
{
$this->fileHeader->file = substr($this->fileHeader->file, 0, -1);
}
// Create the symlink - only possible within PHP context. There's no support built in the FTP protocol, so no postproc use is possible here :(
@symlink($data, $this->fileHeader->file);
}
$this->runState = AK_STATE_DATAREAD;
return true; // No matter if the link was created!
}
private function processTypeFileUncompressed()
{
// Uncompressed files are being processed in small chunks, to avoid timeouts
if (($this->dataReadLength == 0) && !$this->mustSkip())
{
// Before processing file data, ensure permissions are adequate
$this->setCorrectPermissions($this->fileHeader->file);
clearstatcache($this->fileHeader->file);
}
// Open the output file
if (!$this->mustSkip())
{
$ignore =
AKFactory::get('kickstart.setup.ignoreerrors', false) || $this->isIgnoredDirectory($this->fileHeader->file);
if ($this->dataReadLength == 0)
{
$outfp = @fopen($this->fileHeader->realFile, 'w');
}
else
{
$outfp = @fopen($this->fileHeader->realFile, 'a');
}
// Can we write to the file?
if (($outfp === false) && (!$ignore))
{
// An error occurred
$this->setError(AKText::sprintf('COULDNT_WRITE_FILE', $this->fileHeader->realFile));
return false;
}
}
// Does the file have any data, at all?
if ($this->fileHeader->uncompressed == 0)
{
// No file data!
if (!$this->mustSkip() && is_resource($outfp))
{
@fclose($outfp);
}
$this->runState = AK_STATE_DATAREAD;
return true;
}
$this->setError('An uncompressed file was detected; this is not supported by this archive extraction utility');
return false;
}
private function processTypeFileCompressedSimple()
{
$timer = AKFactory::getTimer();
// Files are being processed in small chunks, to avoid timeouts
if (($this->dataReadLength == 0) && !$this->mustSkip())
{
// Before processing file data, ensure permissions are adequate
$this->setCorrectPermissions($this->fileHeader->file);
clearstatcache($this->fileHeader->file);
}
// Open the output file
if (!$this->mustSkip())
{
// Open the output file
$outfp = @fopen($this->fileHeader->realFile, 'w');
// Can we write to the file?
$ignore =
AKFactory::get('kickstart.setup.ignoreerrors', false) || $this->isIgnoredDirectory($this->fileHeader->file);
if (($outfp === false) && (!$ignore))
{
// An error occurred
$this->setError(AKText::sprintf('COULDNT_WRITE_FILE', $this->fileHeader->realFile));
return false;
}
}
// Does the file have any data, at all?
if ($this->fileHeader->uncompressed == 0)
{
// No file data!
if (!$this->mustSkip())
{
if (is_resource($outfp))
{
@fclose($outfp);
}
}
$this->runState = AK_STATE_DATAREAD;
return true;
}
$leftBytes = $this->fileHeader->uncompressed - $this->dataReadLength;
// Loop while there's data to write and enough time to do it
while (($leftBytes > 0) && ($timer->getTimeLeft() > 0))
{
// Read the mini header
$binMiniHeader = fread($this->fp, 8);
$reallyReadBytes = akstringlen($binMiniHeader);
if ($reallyReadBytes < 8)
{
// We read less than requested! Why? Did we hit local EOF?
if ($this->isEOF(true) && !$this->isEOF(false))
{
// Yeap. Let's go to the next file
$this->nextFile();
// Retry reading the header
$binMiniHeader = fread($this->fp, 8);
$reallyReadBytes = akstringlen($binMiniHeader);
// Still not enough data? If so, the archive is corrupt or missing parts.
if ($reallyReadBytes < 8)
{
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
else
{
// Nope. The archive is corrupt
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
// Read the encrypted data
$miniHeader = unpack('Vencsize/Vdecsize', $binMiniHeader);
$toReadBytes = $miniHeader['encsize'];
$data = $this->fread($this->fp, $toReadBytes);
$reallyReadBytes = akstringlen($data);
$this->compressedSizeReadSinceLastFileHeader += $miniHeader['encsize'] + 8;
if ($reallyReadBytes < $toReadBytes)
{
// We read less than requested! Why? Did we hit local EOF?
if ($this->isEOF(true) && !$this->isEOF(false))
{
// Yeap. Let's go to the next file
$this->nextFile();
// Read the rest of the data
$toReadBytes -= $reallyReadBytes;
$restData = $this->fread($this->fp, $toReadBytes);
$reallyReadBytes = akstringlen($restData);
if ($reallyReadBytes < $toReadBytes)
{
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
if (akstringlen($data) == 0)
{
$data = $restData;
}
else
{
$data .= $restData;
}
}
else
{
// Nope. The archive is corrupt
$this->setError(AKText::_('ERR_CORRUPT_ARCHIVE'));
return false;
}
}
// Decrypt the data
$data = AKEncryptionAES::AESDecryptCBC($data, $this->password);
// Is the length of the decrypted data less than expected?
$data_length = akstringlen($data);
if ($data_length < $miniHeader['decsize'])
{
$this->setError(AKText::_('ERR_INVALID_JPS_PASSWORD'));
return false;
}
// Trim the data
$data = substr($data, 0, $miniHeader['decsize']);
// Decompress
$data = gzinflate($data);
$unc_len = akstringlen($data);
// Write the decrypted data
if (!$this->mustSkip())
{
if (is_resource($outfp))
{
@fwrite($outfp, $data, akstringlen($data));
}
}
// Update the read length
$this->dataReadLength += $unc_len;
$leftBytes = $this->fileHeader->uncompressed - $this->dataReadLength;
}
// Close the file pointer
if (!$this->mustSkip())
{
if (is_resource($outfp))
{
@fclose($outfp);
}
}
// Was this a pre-timeout bail out?
if ($leftBytes > 0)
{
$this->runState = AK_STATE_DATA;
}
else
{
// Oh! We just finished!
$this->runState = AK_STATE_DATAREAD;
$this->dataReadLength = 0;
}
return true;
}
private function readKeyExpansionExtraHeader()
{
$signature = fread($this->fp, 4);
if ($signature != "JH\x00\x01")
{
// Not a valid JPS file
$this->setError(AKText::_('ERR_NOT_A_JPS_FILE'));
return false;
}
$bin_data = fread($this->fp, 8);
$header_data = unpack('vlength/Calgo/Viterations/CuseStaticSalt', $bin_data);
if ($header_data['length'] != 76)
{
// Not a valid JPS file
$this->setError(AKText::_('ERR_NOT_A_JPS_FILE'));
return false;
}
switch ($header_data['algo'])
{
case 0:
$algorithm = 'sha1';
break;
case 1:
$algorithm = 'sha256';
break;
case 2:
$algorithm = 'sha512';
break;
default:
// Not a valid JPS file
$this->setError(AKText::_('ERR_NOT_A_JPS_FILE'));
return false;
break;
}
$this->pbkdf2Algorithm = $algorithm;
$this->pbkdf2Iterations = $header_data['iterations'];
$this->pbkdf2UseStaticSalt = $header_data['useStaticSalt'];
$this->pbkdf2StaticSalt = fread($this->fp, 64);
return true;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* Timer class
*/
class AKCoreTimer extends AKAbstractObject
{
/** @var int Maximum execution time allowance per step */
private $max_exec_time = null;
/** @var int Timestamp of execution start */
private $start_time = null;
/**
* Public constructor, creates the timer object and calculates the execution time limits
*
* @return void
*/
public function __construct()
{
// Initialize start time
$this->start_time = $this->microtime_float();
// Get configured max time per step and bias
$config_max_exec_time = AKFactory::get('kickstart.tuning.max_exec_time', 14);
$bias = AKFactory::get('kickstart.tuning.run_time_bias', 75) / 100;
// Get PHP's maximum execution time (our upper limit)
if (@function_exists('ini_get'))
{
$php_max_exec_time = @ini_get("maximum_execution_time");
if ((!is_numeric($php_max_exec_time)) || ($php_max_exec_time == 0))
{
// If we have no time limit, set a hard limit of about 10 seconds
// (safe for Apache and IIS timeouts, verbose enough for users)
$php_max_exec_time = 14;
}
}
else
{
// If ini_get is not available, use a rough default
$php_max_exec_time = 14;
}
// Apply an arbitrary correction to counter CMS load time
$php_max_exec_time--;
// Apply bias
$php_max_exec_time = $php_max_exec_time * $bias;
$config_max_exec_time = $config_max_exec_time * $bias;
// Use the most appropriate time limit value
if ($config_max_exec_time > $php_max_exec_time)
{
$this->max_exec_time = $php_max_exec_time;
}
else
{
$this->max_exec_time = $config_max_exec_time;
}
}
/**
* Returns the current timestampt in decimal seconds
*/
private function microtime_float()
{
list($usec, $sec) = explode(" ", microtime());
return ((float) $usec + (float) $sec);
}
/**
* Wake-up function to reset internal timer when we get unserialized
*/
public function __wakeup()
{
// Re-initialize start time on wake-up
$this->start_time = $this->microtime_float();
}
/**
* Gets the number of seconds left, before we hit the "must break" threshold
*
* @return float
*/
public function getTimeLeft()
{
return $this->max_exec_time - $this->getRunningTime();
}
/**
* Gets the time elapsed since object creation/unserialization, effectively how
* long Akeeba Engine has been processing data
*
* @return float
*/
public function getRunningTime()
{
return $this->microtime_float() - $this->start_time;
}
/**
* Enforce the minimum execution time
*/
public function enforce_min_exec_time()
{
// Try to get a sane value for PHP's maximum_execution_time INI parameter
if (@function_exists('ini_get'))
{
$php_max_exec = @ini_get("maximum_execution_time");
}
else
{
$php_max_exec = 10;
}
if (($php_max_exec == "") || ($php_max_exec == 0))
{
$php_max_exec = 10;
}
// Decrease $php_max_exec time by 500 msec we need (approx.) to tear down
// the application, as well as another 500msec added for rounding
// error purposes. Also make sure this is never gonna be less than 0.
$php_max_exec = max($php_max_exec * 1000 - 1000, 0);
// Get the "minimum execution time per step" Akeeba Backup configuration variable
$minexectime = AKFactory::get('kickstart.tuning.min_exec_time', 0);
if (!is_numeric($minexectime))
{
$minexectime = 0;
}
// Make sure we are not over PHP's time limit!
if ($minexectime > $php_max_exec)
{
$minexectime = $php_max_exec;
}
// Get current running time
$elapsed_time = $this->getRunningTime() * 1000;
$minexectime = 1000.0 * $minexectime;
// Only run a sleep delay if we haven't reached the minexectime execution time
if (($minexectime > $elapsed_time) && ($elapsed_time > 0))
{
$sleep_msec = (int)($minexectime - $elapsed_time);
if (function_exists('usleep'))
{
usleep(1000 * $sleep_msec);
}
elseif (function_exists('time_nanosleep'))
{
$sleep_sec = floor($sleep_msec / 1000);
$sleep_nsec = 1000000 * ($sleep_msec - ($sleep_sec * 1000));
time_nanosleep($sleep_sec, $sleep_nsec);
}
elseif (function_exists('time_sleep_until'))
{
$until_timestamp = time() + $sleep_msec / 1000;
time_sleep_until($until_timestamp);
}
elseif (function_exists('sleep'))
{
$sleep_sec = ceil($sleep_msec / 1000);
sleep($sleep_sec);
}
}
}
/**
* Reset the timer. It should only be used in CLI mode!
*/
public function resetTime()
{
$this->start_time = $this->microtime_float();
}
/**
* @param int $max_exec_time
*/
public function setMaxExecTime($max_exec_time)
{
$this->max_exec_time = $max_exec_time;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2024-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* PHP 8.4+ workaround for standalone MD5 and SHA-1 functions.
*
* PHP 8.4 deprecates the standalone md5(), md5_file(), sha1(), and sha1_file() functions. This trait creates shims
* which use the hash() and hash_file() functions instead where available.
*
* IMPORTANT! PHP 7.4 made the ext/hash extension mandatory. These shims are here only as a backwards compatibility aid.
* Eventually, we need to remove them, replacing their use by the direct use of hash() and hash_file().
*
* @deprecated 9.0
*/
abstract class AKUtilsHash
{
/**
* @deprecated 9.0 Use hash() instead
*/
public static function md5($string, $binary = false)
{
static $shouldUseHash = null;
if ($shouldUseHash === null)
{
$shouldUseHash = function_exists('hash')
&& function_exists('hash_algos')
&& in_array('md5', hash_algos());
}
return $shouldUseHash ? hash('md5', $string, $binary) : md5($string, $binary);
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
class AKUtilsHtaccess extends AKAbstractObject
{
/**
* Extract the PHP handler configuration from a .htaccess file.
*
* This method supports AddHandler lines and SetHandler blocks.
*
* @param string $htaccess
*
* @return string|null NULL when not found
*/
public static function extractHandler($htaccess)
{
// Normalize the .htaccess
$htaccess = self::normalizeHtaccess($htaccess);
// Look for SetHandler and AddHandler in Files and FilesMatch containers
foreach (['Files', 'FilesMatch'] as $container)
{
$result = self::extractContainer($container, $htaccess);
if (!is_null($result))
{
return $result;
}
}
// Fallback: extract an AddHandler line
$found = preg_match('#^AddHandler\s?.*\.php.*$#mi', $htaccess, $matches);
if ($found >= 1)
{
return $matches[0];
}
return null;
}
/**
* Extracts a Files or FilesMatch container with an AddHandler or SetHandler line
*
* @param string $container "Files" or "FilesMatch"
* @param string $htaccess The .htaccess file content
*
* @return string|null NULL when not found
*/
protected static function extractContainer($container, $htaccess)
{
// Try to find the opening container tag e.g.
$pattern = sprintf('#<%s\s*.*\.php.*>#m', $container);
$found = preg_match($pattern, $htaccess, $matches, PREG_OFFSET_CAPTURE);
if (!$found)
{
return null;
}
// Get the rest of the .htaccess sample
$openContainer = $matches[0][0];
$htaccess = trim(substr($htaccess, $matches[0][1] + strlen($matches[0][0])));
// Try to find the closing container tag
$pattern = sprintf('##m', $container);
$found = preg_match($pattern, $htaccess, $matches, PREG_OFFSET_CAPTURE);
if (!$found)
{
return null;
}
// Get the rest of the .htaccess sample
$htaccess = trim(substr($htaccess, 0, $matches[$found - 1][1]));
$closeContainer = $matches[$found - 1][0];
if (empty($htaccess))
{
return null;
}
// Now we'll explode remaining lines and find the first SetHandler or AddHandler line
$lines = array_map('trim', explode("\n", $htaccess));
$lines = array_filter($lines, function ($line) {
return preg_match('#(Add|Set)Handler\s?#i', $line) >= 1;
});
if (empty($lines))
{
return null;
}
return $openContainer . "\n" . array_shift($lines) . "\n" . $closeContainer;
}
/**
* Normalize the .htaccess file content, making it suitable for handler extraction
*
* @param string $htaccess The original file
*
* @return string The normalized file
*/
private static function normalizeHtaccess($htaccess)
{
// Convert all newlines into UNIX style
$htaccess = str_replace("\r\n", "\n", $htaccess);
$htaccess = str_replace("\r", "\n", $htaccess);
// Return only non-comment, non-empty lines
$isNonEmptyNonComment = function ($line) {
$line = trim($line);
return !empty($line) && (substr($line, 0, 1) !== '#');
};
$lines = array_map('trim', explode("\n", $htaccess));
return implode("\n", array_filter($lines, $isNonEmptyNonComment));
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* A filesystem scanner which uses opendir()
*/
class AKUtilsLister extends AKAbstractObject
{
public function &getFiles($folder, $pattern = '*')
{
// Initialize variables
$arr = [];
$false = false;
if (!is_dir($folder))
{
return $false;
}
$handle = @opendir($folder);
// If directory is not accessible, just return FALSE
if ($handle === false)
{
$this->setWarning('Unreadable directory ' . $folder);
return $false;
}
while (($file = @readdir($handle)) !== false)
{
if (!fnmatch($pattern, $file))
{
continue;
}
if (($file != '.') && ($file != '..'))
{
$ds =
($folder == '') || ($folder == '/') || (@substr($folder, -1) == '/') || (@substr($folder, -1) == DIRECTORY_SEPARATOR) ?
'' : DIRECTORY_SEPARATOR;
$dir = $folder . $ds . $file;
$isDir = is_dir($dir);
if (!$isDir)
{
$arr[] = $dir;
}
}
}
@closedir($handle);
return $arr;
}
public function &getFolders($folder, $pattern = '*')
{
// Initialize variables
$arr = [];
$false = false;
if (!is_dir($folder))
{
return $false;
}
$handle = @opendir($folder);
// If directory is not accessible, just return FALSE
if ($handle === false)
{
$this->setWarning('Unreadable directory ' . $folder);
return $false;
}
while (($file = @readdir($handle)) !== false)
{
if (!fnmatch($pattern, $file))
{
continue;
}
if (($file != '.') && ($file != '..'))
{
$ds =
($folder == '') || ($folder == '/') || (@substr($folder, -1) == '/') || (@substr($folder, -1) == DIRECTORY_SEPARATOR) ?
'' : DIRECTORY_SEPARATOR;
$dir = $folder . $ds . $file;
$isDir = is_dir($dir);
if ($isDir)
{
$arr[] = $dir;
}
}
}
@closedir($handle);
return $arr;
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* A filesystem zapper - removes all files and folders under a root
*/
class AKUtilsZapper extends AKAbstractPart
{
/** @var array Directories left to be deleted */
private $directory_list;
/** @var array Files left to be deleted */
private $file_list;
/**
* Have we finished scanning all subdirectories of the current directory?
*
* @var boolean
*/
private $done_subdir_scanning = false;
/**
* Have we finished scanning all files of the current directory?
*
* @var boolean
*/
private $done_file_scanning = true;
/**
* Is the current directory completely excluded?
*
* @var boolean
*/
private $excluded_folder = false;
/** @var integer How many files have been processed in the current step */
private $processed_files_counter;
/** @var string Current directory being scanned */
private $current_directory;
/** @var string Current root directory being processed */
private $root = '';
/** @var integer Total files to process */
private $total_files = 0;
/** @var integer Total files already processed */
private $done_files = 0;
/** @var integer Total folders to process */
private $total_folders = 0;
/** @var integer Total folders already processed */
private $done_folders = 0;
/** @var array Absolute filesystem patterns to never delete (e.g. /var/www/html/*.jpa) */
private $excluded = [];
/** @var bool Are we in a dry-run? */
private $dryRun = false;
/**
* Implements the _prepare() abstract method
*
* Configuration parameters:
*
* root The root under which we are going to be deleting files
* excluded Absolute filesystem patterns to never delete (e.g. /var/www/html/*.jpa)
*
* @return void
*/
protected function _prepare()
{
debugMsg(self::class . " :: Starting _prepare()");
$defaultExcluded = $this->getDefaultExclusions();
$parameters = array_merge([
'root' => rtrim(AKFactory::get('kickstart.setup.destdir'), '/' . DIRECTORY_SEPARATOR),
'excluded' => $defaultExcluded,
'dryRun' => AKFactory::get('kickstart.setup.dryrun', false)
], $this->_parametersArray);
$this->root = $parameters['root'];
$this->excluded = $parameters['excluded'];
$this->directory_list[] = $this->root;
$this->done_subdir_scanning = true;
$this->done_file_scanning = true;
$this->total_files = 0;
$this->done_files = 0;
$this->total_folders = 0;
$this->done_folders = 0;
$this->dryRun = $parameters['dryRun'];
if (empty($this->root))
{
$error = "The folder to delete was not specified.";
debugMsg(self::class . " :: " . $error);
$this->setError($error);
return;
}
if (!is_dir($this->root))
{
$error = sprintf("Folder %s does not exist", $this->root);
debugMsg(self::class . " :: " . $error);
$this->setError($error);
return;
}
$this->setState('prepared');
debugMsg(self::class . " :: prepared");
}
protected function _run()
{
if ($this->getState() == 'postrun')
{
debugMsg(self::class . " :: Already finished");
$this->setStep("-");
$this->setSubstep("");
return true;
}
// If I'm done scanning files and subdirectories and there are no more files to pack get the next
// directory. This block is triggered in the first step in a new root.
if (empty($this->file_list) && $this->done_subdir_scanning && $this->done_file_scanning)
{
$this->progressMarkFolderDone();
if (!$this->getNextDirectory())
{
$this->setState('postrun');
return true;
}
}
// If I'm not done scanning for files and the file list is empty then scan for more files
if (!$this->done_file_scanning && empty($this->file_list))
{
$this->scanFiles();
}
// If I have files left, delete them
elseif (!empty($this->file_list))
{
$this->delete_files();
}
// If I'm not done scanning subdirectories, go ahead and scan some more of them
elseif (!$this->done_subdir_scanning)
{
$this->scanSubdirs();
}
// Do I have an error?
if ($this->getError())
{
return false;
}
return true;
}
/**
* Implements the _finalize() abstract method
*
*/
protected function _finalize()
{
// No finalization is required
$this->setState('finished');
}
// ============================================================================================
// PRIVATE METHODS
// ============================================================================================
/**
* Gets the next directory to scan from the stack. It also applies folder
* filters (directory exclusion, subdirectory exclusion, file exclusion),
* updating the operation toggle properties of the class.
*
* @return boolean True if we found a directory, false if the directory
* stack is empty. It also returns true if the folder is
* filtered (we are told to skip it)
*/
private function getNextDirectory()
{
// Reset the file / folder scanning positions
$this->done_file_scanning = false;
$this->done_subdir_scanning = false;
$this->excluded_folder = false;
if (count($this->directory_list) == 0)
{
// No directories left to scan
return false;
}
// Get and remove the last entry from the $directory_list array
$this->current_directory = array_pop($this->directory_list);
$this->setStep($this->current_directory);
$this->processed_files_counter = 0;
// Apply directory exclusion filters
if ($this->isFiltered($this->current_directory))
{
debugMsg("Skipping directory " . $this->current_directory);
$this->done_subdir_scanning = true;
$this->done_file_scanning = true;
$this->excluded_folder = true;
return true;
}
return true;
}
/**
* Try to delete some files from the $file_list
*
* @return boolean True if there were files deleted , false otherwise
* (empty filelist or fatal error)
*/
protected function delete_files()
{
// Get a reference to the archiver and the timer classes
$timer = AKFactory::getTimer();
// Normal file removal loop; we keep on processing the file list, removing files as we go.
if (count($this->file_list) == 0)
{
// No files left to pack. Return true and let the engine loop
$this->progressMarkFolderDone();
return true;
}
debugMsg("Deleting files");
$numberOfFiles = 0;
$postProc = AKFactory::getPostProc();
while ((count($this->file_list) > 0))
{
$file = @array_shift($this->file_list);
$numberOfFiles++;
// Remove the file
$this->setSubstep($file);
$this->notify((object) [
'type' => 'deleteFile',
'file' => $file
]);
if (!$this->dryRun)
{
$postProc->unlink($file);
clearFileInOPCache($file);
}
// Mark a done file
$this->progressMarkFileDone();
if ($this->getError())
{
return false;
}
// I am running out of time.
if ($timer->getTimeLeft() <= 0)
{
return true;
}
}
// True if we have more files, false if we're done packing
return (count($this->file_list) > 0);
}
protected function progressAddFile()
{
$this->total_files++;
}
protected function progressMarkFileDone()
{
$this->done_files++;
}
protected function progressAddFolder()
{
$this->total_folders++;
}
protected function progressMarkFolderDone()
{
debugMsg("Deleting directory " . $this->current_directory);
$this->setSubstep($this->current_directory);
$this->notify((object) [
'type' => 'deleteFolder',
'file' => $this->current_directory
]);
if (!$this->dryRun)
{
/**
* The scanner goes from shallow to deep directory. However this means that when it scans
* /foo/bar/baz/bat
* it will only be able to remove the 'bat' directory, thus leaving foo/bar/baz on the disk. The following
* method will check if the directory is a subdirectory of the site root and work its way up the tree until
* it finds the site root. Therefore it will end up deleting the parent folders as well.
*/
$this->deleteParentFolders($this->current_directory);
}
}
/**
* Returns the site root, the translated site root and the translated current directory
*
* @return array
*/
protected function getCleanDirectoryComponents()
{
$root = $this->root;
$translated_root = $root;
$dir = TrimTrailingSlash($this->current_directory);
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN')
{
$translated_root = TranslateWinPath($translated_root);
$dir = TranslateWinPath($dir);
}
if (substr($dir, 0, strlen($translated_root)) == $translated_root)
{
$dir = substr($dir, strlen($translated_root));
}
elseif (in_array(substr($translated_root, -1), ['/', '\\']))
{
$new_translated_root = rtrim($translated_root, '/\\');
if (substr($dir, 0, strlen($new_translated_root)) == $new_translated_root)
{
$dir = substr($dir, strlen($new_translated_root));
}
}
if (substr($dir, 0, 1) == '/')
{
$dir = substr($dir, 1);
}
return [$root, $translated_root, $dir];
}
/**
* Steps the subdirectory scanning of the current directory
*
* @return boolean True on success, false on fatal error
*/
protected function scanSubdirs()
{
$lister = new AKUtilsLister();
[$root, $translated_root, $dir] = $this->getCleanDirectoryComponents();
debugMsg("Scanning directories of " . $this->current_directory);
// Get subdirectories
$subdirectories = $lister->getFolders($this->current_directory);
// Error propagation
$this->propagateFromObject($lister);
// Error control
if ($this->getError())
{
return false;
}
// Start adding the subdirectories
if (!empty($subdirectories) && is_array($subdirectories))
{
// Treat symlinks to directories as simple symlink files
foreach ($subdirectories as $subdirectory)
{
if (is_link($subdirectory))
{
// Symlink detected; apply directory filters to it
if (empty($dir))
{
$dirSlash = $dir;
}
else
{
$dirSlash = $dir . '/';
}
$check = $dirSlash . basename($subdirectory);
debugMsg("Directory symlink detected: $check");
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN')
{
$check = TranslateWinPath($check);
}
$check = $translated_root . '/' . $check;
// Check for excluded symlinks
if ($this->isFiltered($check))
{
debugMsg("Skipping directory symlink " . $check);
continue;
}
debugMsg('Adding folder symlink: ' . $check);
$this->file_list[] = $subdirectory;
$this->progressAddFile();
}
$this->directory_list[] = $subdirectory;
$this->progressAddFolder();
}
}
$this->done_subdir_scanning = true;
return true;
}
/**
* Steps the files scanning of the current directory
*
* @return boolean True on success, false on fatal error
*/
protected function scanFiles()
{
$lister = new AKUtilsLister();
[$root, $translated_root, $dir] = $this->getCleanDirectoryComponents();
debugMsg("Scanning files of " . $this->current_directory);
$this->processed_files_counter = 0;
// Get file listing
$fileList = $lister->getFiles($this->current_directory);
// Error propagation
$this->propagateFromObject($lister);
// Error control
if ($this->getError())
{
return false;
}
// Do I have an unreadable directory?
if (($fileList === false))
{
$this->setWarning('Unreadable directory ' . $this->current_directory);
$this->done_file_scanning = true;
return true;
}
// Directory was readable, process the file list
if (is_array($fileList) && !empty($fileList))
{
// Add required trailing slash to $dir
if (!empty($dir))
{
$dir .= '/';
}
// Scan all directory entries
foreach ($fileList as $fileName)
{
$check = $dir . basename($fileName);
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN')
{
$check = TranslateWinPath($check);
}
$check = $translated_root . '/' . $check;
$skipThisFile = $this->isFiltered($check);
if ($skipThisFile)
{
debugMsg("Skipping file $fileName");
continue;
}
$this->file_list[] = $fileName;
$this->processed_files_counter++;
$this->progressAddFile();
}
}
$this->done_file_scanning = true;
return true;
}
/**
* Is a file or folder filtered (protected from deletion)
*
* @param string $fileOrFolder
*
* @return bool
*/
private function isFiltered($fileOrFolder)
{
foreach ($this->excluded as $pattern)
{
if (fnmatch($pattern, $fileOrFolder))
{
return true;
}
}
return false;
}
/**
* Get the default exceptions from deletion
*
* @return array
*/
private function getDefaultExclusions()
{
$ret = [];
$destDir = AKFactory::get('kickstart.setup.destdir');
/**
* Exclude Kickstart / restore.php itself. Otherwise it'd crash!
*/
$myName = defined('KSSELFNAME') ? KSSELFNAME : basename(__FILE__);
$ret[] = KSROOTDIR . '/' . $myName;
/**
* Cheat: exclude the directory used in development (see source/buildscripts/kickstart_test.php)
*
* This directory contains the non-concatenated source code for Kickstart. We need to keep it protected.
*/
if (defined('MINIBUILD') && (MINIBUILD != $destDir))
{
$ret[] = TranslateWinPath(MINIBUILD);
}
/**
* Exclude the backup archive directory if it's not the site's root. This prevents mindlessly deleting all your
* backups before you restore from a previous backup which might not be the one you actually wanted. I will call
* this feature "clumsy-proofing".
*/
$backupArchive = AKFactory::get('kickstart.setup.sourcefile');
$backupDirectory = AKFactory::get('kickstart.setup.sourcepath');
$backupDirectory = empty($backupDirectory) ? dirname($backupArchive) : $backupDirectory;
if ($backupDirectory != $destDir)
{
$ret[] = TranslateWinPath($backupDirectory);
}
/**
* Exclude the backup archive files
*
* This obviously only makes sense when the backup archives are stored in the extraction target folder which is
* the most common use of Kickstart. In this case the backups folder is not excluded above.
*/
$plainBackupName = basename($backupArchive, '.jpa');
$plainBackupName = basename($plainBackupName, '.jps');
$plainBackupName = basename($plainBackupName, '.zip');
$ret[] = TranslateWinPath($backupDirectory . '/' . $plainBackupName) . '.*';
/**
* Exclude Kickstart language files. Only applies in Kickstart mode.
*/
if (defined('KICKSTART'))
{
$langDir = defined('KSLANGDIR') ? KSLANGDIR : KSROOTDIR;
$myName = defined('KSSELFNAME') ? KSSELFNAME : basename(__FILE__);
$iniFilePattern = basename($myName, '.php') . '.*.ini';
if ($langDir != KSROOTDIR)
{
$ret[] = KSLANGDIR;
}
$ret[] = $langDir . '/' . $iniFilePattern;
$ret[] = KSROOTDIR . '/' . $iniFilePattern;
}
// Exclude the Kickstart temporary directory, if one is used by the post-processing engine
$postProc = AKFactory::getPostProc();
$tempDir = $postProc->getTempDir();
if (!empty($tempDir) && (realpath($tempDir) != realpath($destDir)))
{
$ret[] = TranslateWinPath($tempDir);
}
/**
* Exclude the configured Skipped Files ('kickstart.setup.skipfiles'). Also exclude the various restoration.php
* files if we are in restore.php mode and the files are present. These are required for the integrated
* restoration to actually work :)
*/
$skippedFiles = AKFactory::get('kickstart.setup.skipfiles', [
basename(__FILE__), 'kickstart.php', 'htaccess.bak', 'php.ini.bak',
]);
if (!defined('KICKSTART'))
{
// In restore.php mode we have to exclude the various restoration.php files
$skippedFiles = array_merge([
// Akeeba Backup for Joomla!
'administrator/components/com_akeeba/restoration.php',
'administrator/components/com_akeebabackup/restoration.php',
// Joomla! Update
'administrator/components/com_joomlaupdate/restoration.php',
// Akeeba Backup for WordPress
'wp-content/plugins/akeebabackupwp/app/restoration.php',
'wp-content/plugins/akeebabackupcorewp/app/restoration.php',
'wp-content/plugins/akeebabackup/app/restoration.php',
'wp-content/plugins/akeebabackupwpcore/app/restoration.php',
// Akeeba Solo
'app/restoration.php',
], $skippedFiles);
}
foreach ($skippedFiles as $file)
{
$checkFile = $destDir . '/' . $file;
if (file_exists($checkFile))
{
$ret[] = TranslateWinPath($checkFile);
}
}
/**
* Exclude .htaccess if the stealth feature is enabled. Otherwise we'd unset the stealth mode.
* Exclude it even if we have any AddHandler directive, otherwise the site will be borked if the user
* chooses not to rename the .htaccess file
*/
if (AKFactory::get('kickstart.stealth.enable') || AKFactory::get('kickstart.setup.phphandlers', []))
{
$ret[] = $destDir . '/.htaccess';
}
// Remove any duplicate lines
$ret = array_unique($ret);
return $ret;
}
/**
* Recursively delete an empty folder and any of its empty parent folders.
*
* @param string $folder The folder to deletes
*/
private function deleteParentFolders($folder)
{
// Don't try to delete an empty folder or the filesystem root
if (empty($folder) || ($folder == '/'))
{
return;
}
$folder = TranslateWinPath($folder);
$root = TranslateWinPath($this->root);
// Don't try to delete the site's root
if ($folder === $root)
{
return;
}
// Delete the leaf folder
$postProc = AKFactory::getPostProc();
$postProc->rmdir($folder);
// If the leaf folder is not under the site's root don't delete its parents
if (strpos($folder, $root) !== 0)
{
return;
}
// Get and recursively delete the parent folder
$this->deleteParentFolders(dirname($folder));
}
}
/**
* Runs the Zapper and returns a status table. The Zapper only runs if the feature is enabled (kickstart.setup.zapbefore
* is 1) and there are more Zapper steps to run (its state is not postrun). If any of these conditions is not met we
* return boolean false.
*
* @param AKAbstractPartObserver $observer The observer to attach to the Zapper instance
*
* @return bool|array Boolean false or a status array
*/
function runZapper(AKAbstractPartObserver $observer)
{
// This method should only run in restore.php mode or when we have Kickstart Professional.
$isKickstart = defined('KICKSTART');
$isPro = defined('KICKSTARTPRO') ? KICKSTARTPRO : false;
$isDebug = defined('KSDEBUG') ? KSDEBUG : false;
if ($isKickstart && (!$isPro && !$isDebug))
{
return false;
}
// Is the feature enabled?
$enabled = AKFactory::get('kickstart.setup.zapbefore', 0);
if (!$enabled)
{
return false;
}
// Do I still have work to do?
$zapper = AKFactory::getZapper();
if ($zapper->getState() == 'finished')
{
return false;
}
// Attach the observer
if (is_object($observer))
{
$zapper->attach($observer);
}
// Run a step, create and return a status array
$timer = AKFactory::getTimer();
while ($timer->getTimeLeft() > 0)
{
$ret = $zapper->tick();
if ($ret['Error'] != '')
{
break;
}
}
$retArray = [
'status' => true,
'message' => null,
'done' => false,
];
if ($ret['Error'] != '')
{
$retArray['status'] = false;
$retArray['done'] = true;
$retArray['message'] = $ret['Error'];
}
else
{
$retArray['files'] = 0;
$retArray['bytesIn'] = 0;
$retArray['bytesOut'] = 0;
$retArray['factory'] = AKFactory::serialize();
$retArray['lastfile'] = 'Deleting: ' . $zapper->getSubstep();
}
$timer->enforce_min_exec_time();
return $retArray;
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* A simple INI-based i18n engine
*/
class AKText extends AKAbstractObject
{
/**
* The default (en_GB) translation used when no other translation is available
*
* @var array
*/
private $default_translation = array (
'AUTOMODEON' => 'Auto-mode enabled',
'ERR_NOT_A_JPA_FILE' => 'The file is not a JPA archive',
'ERR_CORRUPT_ARCHIVE' => 'The archive file is corrupt, truncated or archive parts are missing',
'ERR_INVALID_ARCHIVE_LONG' => 'The archive file appears to be corrupt, or archive parts are missing. If your backups consist of multiple files, please make sure that you have downloaded all the archive part files (files with the same name and extensions .%s, .%s01, .%2$s02…). Please make sure to download and upload files using SFTP, or FTP in Binary transfer mode and do check that their file size matches the sizes reported in the Manage Backups page of Akeeba Backup / Akeeba Solo.',
'ERR_INVALID_LOGIN' => 'Invalid login',
'COULDNT_CREATE_DIR' => 'Could not create %s folder',
'COULDNT_WRITE_FILE' => 'Could not open %s for writing.',
'WRONG_FTP_HOST' => 'Wrong FTP host or port',
'WRONG_FTP_USER' => 'Wrong FTP username or password',
'WRONG_FTP_PATH1' => 'Wrong FTP initial directory - the directory doesn\'t exist',
'FTP_CANT_CREATE_DIR' => 'Could not create directory %s',
'FTP_TEMPDIR_NOT_WRITABLE' => 'Could not find or create a writable temporary directory',
'SFTP_TEMPDIR_NOT_WRITABLE' => 'Could not find or create a writable temporary directory',
'FTP_COULDNT_UPLOAD' => 'Could not upload %s',
'THINGS_HEADER' => 'Things you should know about Akeeba Kickstart',
'THINGS_01' => 'Kickstart is not an installer. It is an archive extraction tool. The actual installer was put inside the archive file at backup time.',
'THINGS_03' => 'Kickstart is bound by your server\'s configuration. As such, it may not work at all.',
'THINGS_04' => 'You should download and upload your archive files using FTP in Binary transfer mode. Any other method could lead to a corrupt backup archive and restoration failure.',
'THINGS_05' => 'Post-restoration site load errors are usually caused by .htaccess or php.ini directives. You should understand that blank pages, 404 and 500 errors can usually be worked around by editing the aforementioned files. It is not our job to mess with your configuration files, because this could be dangerous for your site.',
'THINGS_06' => 'Kickstart overwrites files without a warning. If you are not sure that you are OK with that do not continue.',
'THINGS_07' => 'Trying to restore to the temporary URL of a cPanel host (e.g. http://1.2.3.4/~username) will lead to restoration failure and your site will appear to be not working. This is normal and it\'s just how your server and CMS software work.',
'THINGS_08' => 'You are supposed to read the documentation before using this software. Most issues can be avoided, or easily worked around, by understanding how this software works.',
'THINGS_09' => 'This text does not imply that there is a problem detected. It is standard text displayed every time you launch Kickstart.',
'CLOSE_LIGHTBOX' => 'Click here or press ESC to close this message',
'SELECT_ARCHIVE' => 'Select a backup archive',
'ARCHIVE_FILE' => 'Archive file:',
'SELECT_EXTRACTION' => 'Select an extraction method',
'WRITE_TO_FILES' => 'Write to files:',
'WRITE_HYBRID' => 'Hybrid (use FTP only if needed)',
'WRITE_DIRECTLY' => 'Directly',
'WRITE_FTP' => 'Use FTP for all files',
'WRITE_SFTP' => 'Use SFTP for all files',
'FTP_HOST' => '(S)FTP host name:',
'FTP_PORT' => '(S)FTP port:',
'FTP_FTPS' => 'Use FTP over SSL (FTPS)',
'FTP_PASSIVE' => 'Use FTP Passive Mode',
'FTP_USER' => '(S)FTP username:',
'FTP_PASS' => '(S)FTP password:',
'FTP_DIR' => '(S)FTP directory:',
'FTP_TEMPDIR' => 'Temporary directory:',
'FTP_CONNECTION_OK' => 'FTP Connection Established',
'SFTP_CONNECTION_OK' => 'SFTP Connection Established',
'FTP_CONNECTION_FAILURE' => 'The FTP Connection Failed',
'SFTP_CONNECTION_FAILURE' => 'The SFTP Connection Failed',
'FTP_TEMPDIR_WRITABLE' => 'The temporary directory is writable.',
'FTP_TEMPDIR_UNWRITABLE' => 'The temporary directory is not writable. Please check the permissions.',
'FTP_BROWSE' => 'Browse',
'FTPBROWSER_LBL_INSTRUCTIONS' => 'Click on a directory to navigate into it. Click on OK to select that directory, Cancel to abort the procedure.',
'FTPBROWSER_ERROR_HOSTNAME' => 'Invalid FTP host or port',
'FTPBROWSER_ERROR_USERPASS' => 'Invalid FTP username or password',
'FTPBROWSER_ERROR_NOACCESS' => 'Directory doesn\'t exist or you don\'t have enough permissions to access it',
'FTPBROWSER_ERROR_UNSUPPORTED' => 'Sorry, your FTP server doesn\'t support our FTP directory browser.',
'FTPBROWSER_LBL_GOPARENT' => '<up one level>',
'FTPBROWSER_LBL_ERROR' => 'An error occurred',
'SFTP_NO_SSH2' => 'Your web server does not have the SSH2 PHP module, therefore cannot connect to SFTP servers.',
'SFTP_NO_FTP_SUPPORT' => 'Your SSH server does not allow SFTP connections',
'SFTP_WRONG_USER' => 'Wrong SFTP username or password',
'SFTP_WRONG_STARTING_DIR' => 'You must supply a valid absolute path',
'SFTPBROWSER_ERROR_NOACCESS' => 'Directory doesn\'t exist or you don\'t have enough permissions to access it',
'SFTP_COULDNT_UPLOAD' => 'Could not upload %s',
'SFTP_CANT_CREATE_DIR' => 'Could not create directory %s',
'UI-ROOT' => '<root>',
'CONFIG_UI_FTPBROWSER_TITLE' => 'FTP Directory Browser',
'BTN_CHECK' => 'Check',
'BTN_RESET' => 'Reset',
'BTN_TESTFTPCON' => 'Test FTP Connection',
'BTN_TESTSFTPCON' => 'Test SFTP Connection',
'BTN_GOTOSTART' => 'Start over',
'BTN_RETRY' => 'Retry',
'FINE_TUNE' => 'Fine-tune',
'MIN_EXEC_TIME' => 'Minimum execution time:',
'MAX_EXEC_TIME' => 'Maximum execution time:',
'SECONDS_PER_STEP' => 'seconds per step',
'EXTRACT_FILES' => 'Extract files',
'BTN_START' => 'Start',
'EXTRACTING' => 'Extracting',
'DO_NOT_CLOSE_EXTRACT' => 'Do not close this window while the extraction is in progress',
'RESTACLEANUP' => 'Restoration and Clean Up',
'BTN_RUNINSTALLER' => 'Run the Installer',
'BTN_CLEANUP' => 'Clean Up',
'BTN_SITEFE' => 'Visit your site\'s frontend',
'BTN_SITEBE' => 'Visit your site\'s backend',
'WARNINGS' => 'Extraction Warnings',
'ERROR_OCCURED' => 'An error occurred',
'STEALTH_MODE' => 'Stealth mode',
'STEALTH_URL' => 'HTML file to show to web visitors',
'ERR_NOT_A_JPS_FILE' => 'The file is not a JPS archive',
'ERR_INVALID_JPS_PASSWORD' => 'The password you gave is wrong or the archive is corrupt',
'JPS_PASSWORD' => 'Archive Password (for JPS files)',
'INVALID_FILE_HEADER_OFFSET_ZERO' => 'Cannot open the file %s for reading. This is part #%d of your backup archive which consists of multiple files (files with the same name and extensions .%s, .%s01, .%4$s02…). Please make sure that you have all of these files in the same folder as Kickstart.',
'INVALID_FILE_HEADER' => 'Invalid header in archive file, part %s, offset %s. Please make sure to download and upload backup archive files using SFTP, or FTP in Binary transfer mode and do check that their file size matches the sizes reported in the Manage Backups page of Akeeba Backup / Akeeba Solo.',
'INVALID_FILE_HEADER_MULTIPART' => 'Invalid header in archive file, part %s, offset %s. Your backup archive consists of multiple files (files with the same name and extensions .%s, .%s01, .%4$s02…). Either some files are missing, or they are corrupt or truncated. You will need all of these files to be present in the same directory. Please make sure to download and upload backup archive files using SFTP, or FTP in Binary transfer mode and do check that their file size matches the sizes reported in the Manage Backups page of Akeeba Backup / Akeeba Solo.',
'UPDATE_HEADER' => 'An updated version of Akeeba Kickstart (unknown) is available!',
'UPDATE_NOTICE' => 'You are advised to always use the latest version of Akeeba Kickstart available. Older versions may be subject to bugs and will not be supported.',
'UPDATE_DLNOW' => 'Download now',
'UPDATE_MOREINFO' => 'More information',
'NEEDSOMEHELPKS' => 'Want some help to use this tool? Read this first:',
'QUICKSTART' => 'Quick Start Guide',
'CANTGETITTOWORK' => 'Can\'t get it to work? Click me!',
'NOARCHIVESCLICKHERE' => 'No archives detected. Click here for troubleshooting instructions.',
'POSTRESTORATIONTROUBLESHOOTING' => 'Something not working after the restoration? Click here for troubleshooting instructions.',
'IGNORE_MOST_ERRORS' => 'Ignore most errors',
'TIME_SETTINGS_HELP' => 'Increase the minimum to 3 if you get AJAX errors. Increase the maximum to 10 for faster extraction, decrease back to 5 if you get AJAX errors. Try minimum 5, maximum 1 (not a typo!) if you keep getting AJAX errors.',
'STEALTH_MODE_HELP' => 'When enabled, only visitors from your IP address will be able to see the site until the restoration is complete. Everyone else will be redirected to and only see the URL above. Your server must see the real IP of the visitor (this is controlled by your host, not you or us).',
'RENAME_FILES_HELP' => 'Renames .htaccess, web.config, php.ini and .user.ini contained in the archive while extracting. Files are renamed with a .bak extension. The file names are restored when you click on Clean Up.',
'RESTORE_PERMISSIONS_HELP' => 'Applies the file permissions (but NOT file ownership) which were stored at backup time. Only works with JPA and JPS archives. Does not work on Windows (PHP does not offer such a feature).',
'EXTRACT_LIST' => 'Files to extract',
'EXTRACT_LIST_HELP' => 'Enter a file path such as images/cat.png or shell pattern such as images/*.png on each line. Only files matching this list will be written to disk. Leave empty to extract everything (default).',
'AKS3_IMPORT' => 'Import from Amazon S3',
'AKS3_TITLE_STEP1' => 'Connect to Amazon S3',
'AKS3_ACCESS' => 'Access Key',
'AKS3_SECRET' => 'Secret Key',
'AKS3_CONNECT' => 'Connect to Amazon S3',
'AKS3_CANCEL' => 'Cancel import',
'AKS3_TITLE_STEP2' => 'Select your Amazon S3 bucket',
'AKS3_BUCKET' => 'Bucket',
'AKS3_LISTCONTENTS' => 'List contents',
'AKS3_TITLE_STEP3' => 'Select archive to import',
'AKS3_FOLDERS' => 'Folders',
'AKS3_FILES' => 'Archive Files',
'AKS3_TITLE_STEP4' => 'Importing...',
'AKS3_DO_NOT_CLOSE' => 'Please do not close this window while your backup archives are being imported',
'AKS3_TITLE_STEP5' => 'Import is complete',
'AKS3_BTN_RELOAD' => 'Reload Kickstart',
'WRONG_FTP_PATH2' => 'Wrong FTP initial directory - the directory doesn\'t correspond to your site\'s web root',
'ARCHIVE_DIRECTORY' => 'Archive directory:',
'RELOAD_ARCHIVES' => 'Reload',
'CONFIG_UI_SFTPBROWSER_TITLE' => 'SFTP Directory Browser',
'ERR_COULD_NOT_OPEN_ARCHIVE_PART' => 'Could not open archive part file %s for reading. Check that the file exists, is readable by the web server and is not in a directory made out of reach by chroot, open_basedir restrictions or any other restriction put in place by your host.',
'RENAME_FILES' => 'Rename server configuration files before extraction',
'BTN_SHOW_FINE_TUNE' => 'Show advanced options (for experts)',
'RESTORE_PERMISSIONS' => 'Restore file permissions',
'ZAPBEFORE' => 'Delete everything before extraction',
'ZAPBEFORE_HELP' => 'Tries to delete all existing files and folders under the directory where Kickstart is stored before extracting the backup archive. It DOES NOT take into account which files and folders exist in the backup archive. Files and folders deleted by this feature CAN NOT be recovered. WARNING! THIS MAY DELETE FILES AND FOLDERS WHICH DO NOT BELONG TO YOUR SITE. USE WITH EXTREME CAUTION. BY ENABLING THIS FEATURE YOU ASSUME ALL RESPONSIBILITY AND LIABILITY.',
);
/**
* Translation strings for el-GR
*
* @var array
*/
private $translation_el_gr = array (
'AUTOMODEON' => 'Ο αυτόματος τρόπος λειτουργίας ενεργοποιήθηκε',
'ERR_NOT_A_JPA_FILE' => 'Το αρχείο δεν είναι αρχείο αρχειοθέτησης JPA',
'ERR_CORRUPT_ARCHIVE' => 'Το αρχείο αρχειοθέτησης είναι κατεστραμμένο, τετμημένο ή λείπουν τμήματα του αρχείου αρχειοθέτησης',
'ERR_INVALID_ARCHIVE_LONG' => 'Το αρχείο αρχειοθέτησης φαίνεται να είναι κατεστραμμένο ή λείπουν τμήματα. Αν τα αντίγραφα ασφαλείας σας αποτελούνται από πολλαπλά αρχεία, βεβαιωθείτε ότι έχετε κατεβάσει όλα τα αρχεία τμημάτων αρχειοθέτησης (αρχεία με το ίδιο όνομα και επεκτάσεις .%s, .%s01, .%2$s02…). Βεβαιωθείτε ότι κατεβάσατε και ανεβάσατε τα αρχεία χρησιμοποιώντας SFTP, ή FTP σε λειτουργία μεταφοράς Binary και ελέγξατε ότι το μέγεθός τους ταιριάζει με τα μεγέθη που αναφέρονται στη σελίδα Διαχείριση Αντιγράφων Ασφαλείας του Akeeba Backup / Akeeba Solo.',
'ERR_INVALID_LOGIN' => 'Μη έγκυρη σύνδεση',
'COULDNT_CREATE_DIR' => 'Αδυναμία δημιουργίας του φακέλου %s',
'COULDNT_WRITE_FILE' => 'Αδυναμία ανοίγματος του %s για εγγραφή.',
'WRONG_FTP_HOST' => 'Λάθος FTP host ή port',
'WRONG_FTP_USER' => 'Λάθος όνομα χρήστη ή κωδικός πρόσβασης FTP',
'WRONG_FTP_PATH1' => 'Λάθος αρχικός φάκελος FTP - ο φάκελος δεν υπάρχει',
'FTP_CANT_CREATE_DIR' => 'Αδυναμία δημιουργίας φακέλου %s',
'FTP_TEMPDIR_NOT_WRITABLE' => 'Αδυναμία εύρεσης ή δημιουργίας εγγράψιμου προσωρινού φακέλου',
'SFTP_TEMPDIR_NOT_WRITABLE' => 'Αδυναμία εύρεσης ή δημιουργίας εγγράψιμου προσωρινού φακέλου',
'FTP_COULDNT_UPLOAD' => 'Αδυναμία ανέβασματος του %s',
'THINGS_HEADER' => 'Πράγματα που πρέπει να γνωρίζετε για το Akeeba Kickstart',
'THINGS_01' => 'Το Kickstart δεν είναι πρόγραμμα εγκατάστασης. Είναι ένα εργαλείο εξαγωγής αρχείων αρχειοθέτησης. Το πραγματικό πρόγραμμα εγκατάστασης τοποθετήθηκε μέσα στο αρχείο αρχειοθέτησης κατά την ώρα δημιουργίας του αντιγράφου ασφαλείας.',
'THINGS_03' => 'Το Kickstart περιορίζεται από τη διαμόρφωση του server σας. Ως εκ τούτου, ενδέχεται να μην λειτουργεί καθόλου.',
'THINGS_04' => 'Πρέπει να κατεβάσετε και να ανεβάσετε τα αρχεία αρχειοθέτησης χρησιμοποιώντας FTP σε λειτουργία μεταφοράς Binary. Οποιαδήποτε άλλη μέθοδος μπορεί να οδηγήσει σε κατεστραμμένο αρχείο αρχειοθέτησης αντιγράφου ασφαλείας και αποτυχία αποκατάστασης.',
'THINGS_05' => 'Σφάλματα φόρτωσης του ιστότοπου μετά την αποκατάσταση συνήθως προκαλούνται από οδηγούς .htaccess ή php.ini. Πρέπει να κατανοήσετε ότι οι κενές σελίδες, τα σφάλματα 404 και 500 συνήθως μπορούν να παρακαμφθούν με επεξεργασία των προαναφερθέντων αρχείων. Δεν είναι εργασία μας να αλλάξουμε τα αρχεία διαμόρφωσής σας, επειδή αυτό μπορεί να είναι επικίνδυνο για τον ιστότοπό σας.',
'THINGS_06' => 'Το Kickstart αντικαθιστά αρχεία χωρίς προειδοποίηση. Αν δεν είστε σίγουροι ότι αυτό σας πειράζει, μην συνεχίσετε.',
'THINGS_07' => 'Η προσπάθεια αποκατάστασης στο προσωρινό URL ενός host cPanel (π.χ. http://1.2.3.4/~username) θα οδηγήσει σε αποτυχία αποκατάστασης και ο ιστότοπός σας θα φαίνεται να μην λειτουργεί. Αυτό είναι φυσιολογικό και οφείλεται στον τρόπο λειτουργίας του server και του λογισμικού CMS σας.',
'THINGS_08' => 'Πρέπει να διαβάσετε την τεκμηρίωση πριν χρησιμοποιήσετε αυτό το λογισμικό. Τα περισσότερα προβλήματα μπορούν να αποφευχθούν, ή εύκολα να παρακαμφθούν, κατανοώντας πώς λειτουργεί αυτό το λογισμικό.',
'THINGS_09' => 'Αυτό το κείμενο δεν υποδηλώνει ότι εντοπίστηκε πρόβλημα. Είναι προεπιλεγμένο κείμενο που εμφανίζεται κάθε φορά που εκκινείτε το Kickstart.',
'CLOSE_LIGHTBOX' => 'Κάντε κλικ εδώ ή πατήστε ESC για να κλείσετε αυτό το μήνυμα',
'SELECT_ARCHIVE' => 'Επιλέξτε ένα αρχείο αρχειοθέτησης αντιγράφου ασφαλείας',
'ARCHIVE_FILE' => 'Αρχείο αρχειοθέτησης:',
'SELECT_EXTRACTION' => 'Επιλέξτε μια μέθοδο εξαγωγής',
'WRITE_TO_FILES' => 'Εγγραφή σε αρχεία:',
'WRITE_HYBRID' => 'Υβριδική (χρήση FTP μόνο όταν χρειάζεται)',
'WRITE_DIRECTLY' => 'Απευθείας',
'WRITE_FTP' => 'Χρήση FTP για όλα τα αρχεία',
'WRITE_SFTP' => 'Χρήση SFTP για όλα τα αρχεία',
'FTP_HOST' => 'Όνομα (S)FTP host:',
'FTP_PORT' => '(S)FTP port:',
'FTP_FTPS' => 'Χρήση FTP μέσω SSL (FTPS)',
'FTP_PASSIVE' => 'Χρήση FTP Passive Mode',
'FTP_USER' => 'Όνομα χρήστη (S)FTP:',
'FTP_PASS' => 'Κωδικός πρόσβασης (S)FTP:',
'FTP_DIR' => 'Φάκελος (S)FTP:',
'FTP_TEMPDIR' => 'Προσωρινός φάκελος:',
'FTP_CONNECTION_OK' => 'Η σύνδεση FTP δημιουργήθηκε',
'SFTP_CONNECTION_OK' => 'Η σύνδεση SFTP δημιουργήθηκε',
'FTP_CONNECTION_FAILURE' => 'Αποτυχία σύνδεσης FTP',
'SFTP_CONNECTION_FAILURE' => 'Αποτυχία σύνδεσης SFTP',
'FTP_TEMPDIR_WRITABLE' => 'Ο προσωρινός φάκελος είναι εγγράψιμος.',
'FTP_TEMPDIR_UNWRITABLE' => 'Ο προσωρινός φάκελος δεν είναι εγγράψιμος. Ελέγξτε τα δικαιώματα πρόσβασης.',
'FTP_BROWSE' => 'Περιήγηση',
'FTPBROWSER_LBL_INSTRUCTIONS' => 'Κάντε κλικ σε έναν φάκελο για να πλοηγηθείτε μέσα του. Κάντε κλικ στο OK για να επιλέξετε αυτόν τον φάκελο, Cancel για να ακυρώσετε τη διαδικασία.',
'FTPBROWSER_ERROR_HOSTNAME' => 'Μη έγκυρο FTP host ή port',
'FTPBROWSER_ERROR_USERPASS' => 'Μη έγκυρο όνομα χρήστη ή κωδικός πρόσβασης FTP',
'FTPBROWSER_ERROR_NOACCESS' => 'Ο φάκελος δεν υπάρχει ή δεν έχετε αρκετά δικαιώματα για πρόσβαση',
'FTPBROWSER_ERROR_UNSUPPORTED' => 'Λυπούμαστε, ο FTP server σας δεν υποστηρίζει τον περιηγητή φακέλων FTP.',
'FTPBROWSER_LBL_GOPARENT' => '<ένας βαθμός πάνω>',
'FTPBROWSER_LBL_ERROR' => 'Προέκυψε σφάλμα',
'SFTP_NO_SSH2' => 'Ο web server σας δεν διαθέτει το module PHP SSH2, επομένως δεν μπορεί να συνδεθεί με servers SFTP.',
'SFTP_NO_FTP_SUPPORT' => 'Ο SSH server σας δεν επιτρέπει συνδέσεις SFTP',
'SFTP_WRONG_USER' => 'Λάθος όνομα χρήστη ή κωδικός πρόσβασης SFTP',
'SFTP_WRONG_STARTING_DIR' => 'Πρέπει να παρέχετε μια έγκυρη απόλυτη διαδρομή',
'SFTPBROWSER_ERROR_NOACCESS' => 'Ο φάκελος δεν υπάρχει ή δεν έχετε αρκετά δικαιώματα για πρόσβαση',
'SFTP_COULDNT_UPLOAD' => 'Αδυναμία ανέβασματος του %s',
'SFTP_CANT_CREATE_DIR' => 'Αδυναμία δημιουργίας φακέλου %s',
'UI-ROOT' => '<ρίζα>',
'CONFIG_UI_FTPBROWSER_TITLE' => 'Περιηγητής φακέλων FTP',
'BTN_CHECK' => 'Έλεγχος',
'BTN_RESET' => 'Επαναφορά',
'BTN_TESTFTPCON' => 'Δοκιμή σύνδεσης FTP',
'BTN_TESTSFTPCON' => 'Δοκιμή σύνδεσης SFTP',
'BTN_GOTOSTART' => 'Επανεκκίνηση',
'BTN_RETRY' => 'Επανάληψη',
'FINE_TUNE' => 'Λεπτή ρύθμιση',
'MIN_EXEC_TIME' => 'Ελάχιστος χρόνος εκτέλεσης:',
'MAX_EXEC_TIME' => 'Μέγιστος χρόνος εκτέλεσης:',
'SECONDS_PER_STEP' => 'δευτερόλεπτα ανά βήμα',
'EXTRACT_FILES' => 'Εξαγωγή αρχείων',
'BTN_START' => 'Έναρξη',
'EXTRACTING' => 'Εξαγωγή σε εξέλιξη',
'DO_NOT_CLOSE_EXTRACT' => 'Μην κλείσετε αυτό το παράθυρο ενώ η εξαγωγή βρίσκεται σε εξέλιξη',
'RESTACLEANUP' => 'Αποκατάσταση και Καθαρισμός',
'BTN_RUNINSTALLER' => 'Εκτέλεση του προγράμματος εγκατάστασης',
'BTN_CLEANUP' => 'Καθαρισμός',
'BTN_SITEFE' => 'Επίσκεψη στο frontend του ιστότοπου',
'BTN_SITEBE' => 'Επίσκεψη στο backend του ιστότοπου',
'WARNINGS' => 'Προειδοποιήσεις εξαγωγής',
'ERROR_OCCURED' => 'Προέκυψε σφάλμα',
'STEALTH_MODE' => 'Λανθάνων τρόπος λειτουργίας',
'STEALTH_URL' => 'Αρχείο HTML που θα εμφανίζεται στους επισκέπτες του ιστότοπου',
'ERR_NOT_A_JPS_FILE' => 'Το αρχείο δεν είναι αρχείο αρχειοθέτησης JPS',
'ERR_INVALID_JPS_PASSWORD' => 'Ο κωδικός πρόσβασης που δώσατε είναι λάθος ή το αρχείο αρχειοθέτησης είναι κατεστραμμένο',
'JPS_PASSWORD' => 'Κωδικός πρόσβασης αρχείου αρχειοθέτησης (για αρχεία JPS)',
'INVALID_FILE_HEADER_OFFSET_ZERO' => 'Αδυναμία ανοίγματος του αρχείου %s για ανάγνωση. Αυτό είναι το τμήμα #%d του αρχείου αρχειοθέτησης αντιγράφου ασφαλείας που αποτελείται από πολλαπλά αρχεία (αρχεία με το ίδιο όνομα και επεκτάσεις .%s, .%s01, .%4$s02…). Βεβαιωθείτε ότι έχετε όλα αυτά τα αρχεία στον ίδιο φάκελο με το Kickstart.',
'INVALID_FILE_HEADER' => 'Μη έγκυρο header στο αρχείο αρχειοθέτησης, τμήμα %s, offset %s. Βεβαιωθείτε ότι κατεβάσατε και ανεβάσατε τα αρχεία αρχειοθέτησης αντιγράφου ασφαλείας χρησιμοποιώντας SFTP, ή FTP σε λειτουργία μεταφοράς Binary και ελέγξατε ότι το μέγεθός τους ταιριάζει με τα μεγέθη που αναφέρονται στη σελίδα Διαχείριση Αντιγράφων Ασφαλείας του Akeeba Backup / Akeeba Solo.',
'INVALID_FILE_HEADER_MULTIPART' => 'Μη έγκυρο header στο αρχείο αρχειοθέτησης, τμήμα %s, offset %s. Το αρχείο αρχειοθέτησης αντιγράφου ασφαλείας σας αποτελείται από πολλαπλά αρχεία (αρχεία με το ίδιο όνομα και επεκτάσεις .%s, .%s01, .%4$s02…). Ή κάποια αρχεία λείπουν, ή είναι κατεστραμμένα ή τετμημένα. Θα χρειαστείτε όλα αυτά τα αρχεία να υπάρχουν στον ίδιο φάκελο. Βεβαιωθείτε ότι κατεβάσατε και ανεβάσατε τα αρχεία αρχειοθέτησης αντιγράφου ασφαλείας χρησιμοποιώντας SFTP, ή FTP σε λειτουργία μεταφοράς Binary και ελέγξατε ότι το μέγεθός τους ταιριάζει με τα μεγέθη που αναφέρονται στη σελίδα Διαχείριση Αντιγράφων Ασφαλείας του Akeeba Backup / Akeeba Solo.',
'UPDATE_HEADER' => 'Μια ενημερωμένη έκδοση του Akeeba Kickstart (unknown) είναι διαθέσιμη!',
'UPDATE_NOTICE' => 'Σας συμβουλεύουμε να χρησιμοποιείτε πάντα την τελευταία έκδοση του Akeeba Kickstart που είναι διαθέσιμη. Οι παλαιότερες εκδόσεις ενδέχεται να περιέχουν σφάλματα και δεν θα υποστηρίζονται.',
'UPDATE_DLNOW' => 'Λήψη τώρα',
'UPDATE_MOREINFO' => 'Περισσότερες πληροφορίες',
'NEEDSOMEHELPKS' => 'Θέλετε βοήθεια για τη χρήση αυτού του εργαλείου; Διαβάστε πρώτα αυτό:',
'QUICKSTART' => 'Οδηγός γρήγορης εκκίνησης',
'CANTGETITTOWORK' => 'Δεν καταφέρνετε να το κάνετε να λειτουργήσει; Κάντε κλικ εδώ!',
'NOARCHIVESCLICKHERE' => 'Δεν εντοπίστηκαν αρχεία αρχειοθέτησης. Κάντε κλικ εδώ για οδηγίες αντιμετώπισης προβλημάτων.',
'POSTRESTORATIONTROUBLESHOOTING' => 'Κάτι δεν λειτουργεί μετά την αποκατάσταση; Κάντε κλικ εδώ για οδηγίες αντιμετώπισης προβλημάτων.',
'IGNORE_MOST_ERRORS' => 'Παραβίαση περισσότερων σφαλμάτων',
'TIME_SETTINGS_HELP' => 'Αυξήστε το ελάχιστο σε 3 αν λαμβάνετε σφάλματα AJAX. Αυξήστε το μέγιστο σε 10 για ταχύτερη εξαγωγή, μειώστε το ξανά σε 5 αν λαμβάνετε σφάλματα AJAX. Δοκιμάστε ελάχιστο 5, μέγιστο 1 (δεν είναι τυπογραφικό σφάλμα!) αν συνεχίζετε να λαμβάνετε σφάλματα AJAX.',
'STEALTH_MODE_HELP' => 'Όταν είναι ενεργοποιημένο, μόνο οι επισκέπτες από τη διεύθυνση IP σας θα μπορούν να δουν τον ιστότοπο μέχρι να ολοκληρωθεί η αποκατάσταση. Όλοι οι υπόλοιποι θα ανακατευθύνονται και θα βλέπουν μόνο την παραπάνω URL. Ο server σας πρέπει να βλέπει την πραγματική διεύθυνση IP του επισκέπτη (αυτό ελέγχεται από τον host σας, όχι από εσάς ή εμάς).',
'RENAME_FILES_HELP' => 'Ανομοσιάζει τα αρχεία .htaccess, web.config, php.ini και .user.ini που περιέχονται στο αρχείο αρχειοθέτησης κατά την εξαγωγή. Τα αρχεία μετονομάζονται με επέκταση .bak. Τα ονόματα αρχείων επαναφέρονται όταν κάνετε κλικ στο Καθαρισμός.',
'RESTORE_PERMISSIONS_HELP' => 'Εφαρμόζει τα δικαιώματα αρχείων (αλλά ΟΧΙ την ιδιοκτησία αρχείων) που αποθηκεύτηκαν κατά την ώρα δημιουργίας του αντιγράφου ασφαλείας. Λειτουργεί μόνο με αρχεία αρχειοθέτησης JPA και JPS. Δεν λειτουργεί στο Windows (το PHP δεν παρέχει τέτοια δυνατότητα).',
'EXTRACT_LIST' => 'Αρχεία προς εξαγωγή',
'EXTRACT_LIST_HELP' => 'Εισάγετε μια διαδρομή αρχείου όπως images/cat.png ή ένα pattern shell όπως images/*.png σε κάθε γραμμή. Μόνο τα αρχεία που ταιριάζουν σε αυτή τη λίστα θα γραφτούν στον δίσκο. Αφήστε κενό για εξαγωγή όλων (προεπιλογή).',
'AKS3_IMPORT' => 'Εισαγωγή από Amazon S3',
'AKS3_TITLE_STEP1' => 'Σύνδεση με Amazon S3',
'AKS3_ACCESS' => 'Κλειδί πρόσβασης',
'AKS3_SECRET' => 'Κρυπτογραφημένο κλειδί',
'AKS3_CONNECT' => 'Σύνδεση με Amazon S3',
'AKS3_CANCEL' => 'Ακύρωση εισαγωγής',
'AKS3_TITLE_STEP2' => 'Επιλογή bucket Amazon S3',
'AKS3_BUCKET' => 'Bucket',
'AKS3_LISTCONTENTS' => 'Εμφάνιση περιεχομένων',
'AKS3_TITLE_STEP3' => 'Επιλογή αρχείου αρχειοθέτησης προς εισαγωγή',
'AKS3_FOLDERS' => 'Φάκελοι',
'AKS3_FILES' => 'Αρχεία αρχειοθέτησης',
'AKS3_TITLE_STEP4' => 'Εισαγωγή σε εξέλιξη…',
'AKS3_DO_NOT_CLOSE' => 'Παρακαλώ μην κλείσετε αυτό το παράθυρο ενώ τα αρχεία αρχειοθέτησης αντιγράφου ασφαλείας εισάγονται',
'AKS3_TITLE_STEP5' => 'Η εισαγωγή ολοκληρώθηκε',
'AKS3_BTN_RELOAD' => 'Επαναφόρτωση Kickstart',
'WRONG_FTP_PATH2' => 'Λάθος αρχικός φάκελος FTP - ο φάκελος δεν αντιστοιχεί στη ρίζα ιστού του ιστότοπού σας',
'ARCHIVE_DIRECTORY' => 'Φάκελος αρχείων αρχειοθέτησης:',
'RELOAD_ARCHIVES' => 'Επαναφόρτωση',
'CONFIG_UI_SFTPBROWSER_TITLE' => 'Περιηγητής φακέλων SFTP',
'ERR_COULD_NOT_OPEN_ARCHIVE_PART' => 'Αδυναμία ανοίγματος του αρχείου τμήματος αρχειοθέτησης %s για ανάγνωση. Ελέγξτε ότι το αρχείο υπάρχει, είναι αναγνώσιμο από τον web server και δεν βρίσκεται σε φάκελο που είναι μη προσβάσιμος λόγω περιορισμών chroot, open_basedir ή οποιουδήποτε άλλου περιορισμού που έχει θέσει ο host σας.',
'RENAME_FILES' => 'Μετονομασία αρχείων διαμόρφωσης server πριν την εξαγωγή',
'BTN_SHOW_FINE_TUNE' => 'Εμφάνιση προηγμένων επιλογών (για ειδικούς)',
'RESTORE_PERMISSIONS' => 'Αποκατάσταση δικαιωμάτων αρχείων',
'ZAPBEFORE' => 'Διαγραφή όλων πριν την εξαγωγή',
'ZAPBEFORE_HELP' => 'Προσπαθεί να διαγράψει όλα τα υπάρχοντα αρχεία και φακέλους κάτω από τον φάκελο όπου βρίσκεται το Kickstart πριν την εξαγωγή του αρχείου αρχειοθέτησης αντιγράφου ασφαλείας. ΔΕΝ λαμβάνει υπόψη ποια αρχεία και φακέλοι υπάρχουν στο αρχείο αρχειοθέτησης αντιγράφου ασφαλείας. Τα αρχεία και οι φάκελοι που διαγράφονται από αυτή τη δυνατότητα ΔΕΝ ΜΠΟΡΟΥΝ να ανακτηθούν. ΠΡΟΕΙΔΟΠΟΙΗΣΗ! ΑΥΤΟ ΜΠΟΡΕΙ ΝΑ ΔΙΑΓΡΕΙ ΑΡΧΕΙΑ ΚΑΙ ΦΑΚΕΛΟΥΣ ΠΟΥ ΔΕΝ ΑΝΗΚΟΥΝ ΣΤΟΝ ΙΣΤΟΤΟΠΟ ΣΑΣ. ΧΡΗΣΙΜΟΠΟΙΗΣΤΕ ΜΕ ΕΞΤΡΕΜΗ ΠΡΟΣΟΧΗ. ΕΝΕΡΓΟΠΟΙΩΝΤΑΣ ΑΥΤΗ ΤΗ ΔΥΝΑΤΟΤΗΤΑ ΑΝΑΛΑΜΒΑΝΕΤΕ ΟΛΗ ΤΗΝ ΕΥΘΥΝΗ ΚΑΙ ΑΠΟΔΑΝΕΥΘΥΝΩΣΗ.',
);
/**
* Translation strings for fr-FR
*
* @var array
*/
private $translation_fr_fr = array (
'AUTOMODEON' => 'Mode automatique activé',
'ERR_NOT_A_JPA_FILE' => 'Le fichier n\'est pas une archive JPA',
'ERR_CORRUPT_ARCHIVE' => 'Le fichier archive est corrompu, tronqué ou des parties de l\'archive sont manquantes',
'ERR_INVALID_ARCHIVE_LONG' => 'Le fichier archive semble corrompu, ou des parties de l\'archive sont manquantes. Si vos sauvegardes se composent de plusieurs fichiers, veuillez vous assurer d\'avoir téléchargé tous les fichiers parties de l\'archive (fichiers portant le même nom et les extensions .%s, .%s01, .%2$s02…). Veuillez vous assurer de télécharger et téléverser les fichiers en utilisant SFTP, ou FTP en mode de transfert binaire et vérifier que la taille de leurs fichiers correspond aux tailles indiquées dans la page Gérer les sauvegardes de Akeeba Backup / Akeeba Solo.',
'ERR_INVALID_LOGIN' => 'Identifiant de connexion invalide',
'COULDNT_CREATE_DIR' => 'Impossible de créer le dossier %s',
'COULDNT_WRITE_FILE' => 'Impossible d\'ouvrir %s en écriture.',
'WRONG_FTP_HOST' => 'Hôte ou port FTP incorrect',
'WRONG_FTP_USER' => 'Nom d\'utilisateur ou mot de passe FTP incorrect',
'WRONG_FTP_PATH1' => 'Répertoire initial FTP incorrect - le répertoire n\'existe pas',
'FTP_CANT_CREATE_DIR' => 'Impossible de créer le répertoire %s',
'FTP_TEMPDIR_NOT_WRITABLE' => 'Impossible de trouver ou de créer un répertoire temporaire accessible en écriture',
'SFTP_TEMPDIR_NOT_WRITABLE' => 'Impossible de trouver ou de créer un répertoire temporaire accessible en écriture',
'FTP_COULDNT_UPLOAD' => 'Impossible de téléverser %s',
'THINGS_HEADER' => 'Points à connaître au sujet de Akeeba Kickstart',
'THINGS_01' => 'Kickstart n\'est pas un programme d\'installation. C\'est un outil d\'extraction d\'archives. Le programme d\'installation proprement dit a été placé dans le fichier archive lors de la sauvegarde.',
'THINGS_03' => 'Kickstart est limité par la configuration de votre serveur. À ce titre, il se peut qu\'il ne fonctionne pas du tout.',
'THINGS_04' => 'Vous devriez télécharger et téléverser vos fichiers archive en utilisant FTP en mode de transfert binaire. Toute autre méthode pourrait entraîner une corruption de l\'archive de sauvegarde et un échec de la restauration.',
'THINGS_05' => 'Les erreurs de chargement du site après la restauration sont généralement causées par des directives .htaccess ou php.ini. Vous devriez comprendre que les pages blanches, les erreurs 404 et 500 peuvent généralement être contournées en modifiant les fichiers susmentionnés. Il ne nous appartient pas de modifier vos fichiers de configuration, car cela pourrait être dangereux pour votre site.',
'THINGS_06' => 'Kickstart remplace les fichiers sans avertissement. Si vous n\'êtes pas certain d\'accepter cela, ne continuez pas.',
'THINGS_07' => 'Tenter de restaurer sur l\'URL temporaire d\'un hébergeur cPanel (par exemple http://1.2.3.4/~utilisateur) entraînera un échec de la restauration et votre site semblera ne pas fonctionner. C\'est normal et c\'est simplement ainsi que fonctionnent votre serveur et le logiciel CMS.',
'THINGS_08' => 'Vous êtes censé lire la documentation avant d\'utiliser ce logiciel. La plupart des problèmes peuvent être évités, ou facilement contournés, en comprenant le fonctionnement de ce logiciel.',
'THINGS_09' => 'Ce texte n\'implique pas qu\'un problème ait été détecté. Il s\'agit d\'un texte standard affiché à chaque lancement de Kickstart.',
'CLOSE_LIGHTBOX' => 'Cliquez ici ou appuyez sur ÉCHAP pour fermer ce message',
'SELECT_ARCHIVE' => 'Sélectionner une archive de sauvegarde',
'ARCHIVE_FILE' => 'Fichier archive :',
'SELECT_EXTRACTION' => 'Sélectionner une méthode d\'extraction',
'WRITE_TO_FILES' => 'Écrire dans les fichiers :',
'WRITE_HYBRID' => 'Hybride (utiliser FTP uniquement si nécessaire)',
'WRITE_DIRECTLY' => 'Directement',
'WRITE_FTP' => 'Utiliser FTP pour tous les fichiers',
'WRITE_SFTP' => 'Utiliser SFTP pour tous les fichiers',
'FTP_HOST' => 'Nom d\'hôte (S)FTP :',
'FTP_PORT' => 'Port (S)FTP :',
'FTP_FTPS' => 'Utiliser FTP sur SSL (FTPS)',
'FTP_PASSIVE' => 'Utiliser le mode passif FTP',
'FTP_USER' => 'Nom d\'utilisateur (S)FTP :',
'FTP_PASS' => 'Mot de passe (S)FTP :',
'FTP_DIR' => 'Répertoire (S)FTP :',
'FTP_TEMPDIR' => 'Répertoire temporaire :',
'FTP_CONNECTION_OK' => 'Connexion FTP établie',
'SFTP_CONNECTION_OK' => 'Connexion SFTP établie',
'FTP_CONNECTION_FAILURE' => 'La connexion FTP a échoué',
'SFTP_CONNECTION_FAILURE' => 'La connexion SFTP a échoué',
'FTP_TEMPDIR_WRITABLE' => 'Le répertoire temporaire est accessible en écriture.',
'FTP_TEMPDIR_UNWRITABLE' => 'Le répertoire temporaire n\'est pas accessible en écriture. Veuillez vérifier les permissions.',
'FTP_BROWSE' => 'Parcourir',
'FTPBROWSER_LBL_INSTRUCTIONS' => 'Cliquez sur un répertoire pour y naviguer. Cliquez sur OK pour sélectionner ce répertoire, Annuler pour interrompre la procédure.',
'FTPBROWSER_ERROR_HOSTNAME' => 'Hôte ou port FTP invalide',
'FTPBROWSER_ERROR_USERPASS' => 'Nom d\'utilisateur ou mot de passe FTP invalide',
'FTPBROWSER_ERROR_NOACCESS' => 'Le répertoire n\'existe pas ou vous n\'avez pas les permissions suffisantes pour y accéder',
'FTPBROWSER_ERROR_UNSUPPORTED' => 'Désolé, votre serveur FTP ne prend pas en charge notre navigateur de répertoires FTP.',
'FTPBROWSER_LBL_GOPARENT' => '<monter d\'un niveau>',
'FTPBROWSER_LBL_ERROR' => 'Une erreur s\'est produite',
'SFTP_NO_SSH2' => 'Votre serveur web ne dispose pas du module PHP SSH2, il ne peut donc pas se connecter aux serveurs SFTP.',
'SFTP_NO_FTP_SUPPORT' => 'Votre serveur SSH n\'autorise pas les connexions SFTP',
'SFTP_WRONG_USER' => 'Nom d\'utilisateur ou mot de passe SFTP incorrect',
'SFTP_WRONG_STARTING_DIR' => 'Vous devez fournir un chemin absolu valide',
'SFTPBROWSER_ERROR_NOACCESS' => 'Le répertoire n\'existe pas ou vous n\'avez pas les permissions suffisantes pour y accéder',
'SFTP_COULDNT_UPLOAD' => 'Impossible de téléverser %s',
'SFTP_CANT_CREATE_DIR' => 'Impossible de créer le répertoire %s',
'UI-ROOT' => '<racine>',
'CONFIG_UI_FTPBROWSER_TITLE' => 'Navigateur de répertoires FTP',
'BTN_CHECK' => 'Vérifier',
'BTN_RESET' => 'Réinitialiser',
'BTN_TESTFTPCON' => 'Tester la connexion FTP',
'BTN_TESTSFTPCON' => 'Tester la connexion SFTP',
'BTN_GOTOSTART' => 'Recommencer',
'BTN_RETRY' => 'Réessayer',
'FINE_TUNE' => 'Affiner',
'MIN_EXEC_TIME' => 'Temps d\'exécution minimum :',
'MAX_EXEC_TIME' => 'Temps d\'exécution maximum :',
'SECONDS_PER_STEP' => 'secondes par étape',
'EXTRACT_FILES' => 'Extraire les fichiers',
'BTN_START' => 'Démarrer',
'EXTRACTING' => 'Extraction en cours',
'DO_NOT_CLOSE_EXTRACT' => 'Ne fermez pas cette fenêtre pendant que l\'extraction est en cours',
'RESTACLEANUP' => 'Restauration et nettoyage',
'BTN_RUNINSTALLER' => 'Exécuter le programme d\'installation',
'BTN_CLEANUP' => 'Nettoyer',
'BTN_SITEFE' => 'Visiter la partie publique de votre site',
'BTN_SITEBE' => 'Visiter la partie administrative de votre site',
'WARNINGS' => 'Avertissements d\'extraction',
'ERROR_OCCURED' => 'Une erreur s\'est produite',
'STEALTH_MODE' => 'Mode furtif',
'STEALTH_URL' => 'Fichier HTML à afficher aux visiteurs du web',
'ERR_NOT_A_JPS_FILE' => 'Le fichier n\'est pas une archive JPS',
'ERR_INVALID_JPS_PASSWORD' => 'Le mot de passe que vous avez fourni est incorrect ou l\'archive est corrompue',
'JPS_PASSWORD' => 'Mot de passe de l\'archive (pour les fichiers JPS)',
'INVALID_FILE_HEADER_OFFSET_ZERO' => 'Impossible d\'ouvrir le fichier %s en lecture. Il s\'agit de la partie n°%d de votre archive de sauvegarde qui se compose de plusieurs fichiers (fichiers portant le même nom et les extensions .%s, .%s01, .%4$s02…). Veuillez vous assurer que tous ces fichiers se trouvent dans le même dossier que Kickstart.',
'INVALID_FILE_HEADER' => 'En-tête invalide dans le fichier archive, partie %s, décalage %s. Veuillez vous assurer de télécharger et téléverser les fichiers archive de sauvegarde en utilisant SFTP, ou FTP en mode de transfert binaire et vérifier que la taille de leurs fichiers correspond aux tailles indiquées dans la page Gérer les sauvegardes de Akeeba Backup / Akeeba Solo.',
'INVALID_FILE_HEADER_MULTIPART' => 'En-tête invalide dans le fichier archive, partie %s, décalage %s. Votre archive de sauvegarde se compose de plusieurs fichiers (fichiers portant le même nom et les extensions .%s, .%s01, .%4$s02…). Soit certains fichiers sont manquants, soit ils sont corrompus ou tronqués. Tous ces fichiers doivent être présents dans le même répertoire. Veuillez vous assurer de télécharger et téléverser les fichiers archive de sauvegarde en utilisant SFTP, ou FTP en mode de transfert binaire et vérifier que la taille de leurs fichiers correspond aux tailles indiquées dans la page Gérer les sauvegardes de Akeeba Backup / Akeeba Solo.',
'UPDATE_HEADER' => 'Une version mise à jour de Akeeba Kickstart (unknown) est disponible !',
'UPDATE_NOTICE' => 'Il vous est conseillé d\'utiliser toujours la dernière version de Akeeba Kickstart disponible. Les anciennes versions peuvent être sujettes à des bugs et ne seront pas prises en charge.',
'UPDATE_DLNOW' => 'Télécharger maintenant',
'UPDATE_MOREINFO' => 'Plus d\'informations',
'NEEDSOMEHELPKS' => 'Vous avez besoin d\'aide pour utiliser cet outil ? Lisez ceci en premier :',
'QUICKSTART' => 'Guide de démarrage rapide',
'CANTGETITTOWORK' => 'Vous n\'arrivez pas à le faire fonctionner ? Cliquez ici !',
'NOARCHIVESCLICKHERE' => 'Aucune archive détectée. Cliquez ici pour les instructions de dépannage.',
'POSTRESTORATIONTROUBLESHOOTING' => 'Quelque chose ne fonctionne pas après la restauration ? Cliquez ici pour les instructions de dépannage.',
'IGNORE_MOST_ERRORS' => 'Ignorer la plupart des erreurs',
'TIME_SETTINGS_HELP' => 'Augmentez le minimum à 3 si vous obtenez des erreurs AJAX. Augmentez le maximum à 10 pour une extraction plus rapide, diminuez à 5 si vous obtenez des erreurs AJAX. Essayez minimum 5, maximum 1 (ce n\'est pas une coquille !) si vous continuez à obtenir des erreurs AJAX.',
'STEALTH_MODE_HELP' => 'Lorsqu\'il est activé, seuls les visiteurs provenant de votre adresse IP pourront voir le site jusqu\'à ce que la restauration soit terminée. Tous les autres seront redirigés vers l\'URL ci-dessus et n\'en verront que celle-ci. Votre serveur doit voir l\'IP réelle du visiteur (cela est contrôlé par votre hébergeur, pas par vous ou nous).',
'RENAME_FILES_HELP' => 'Renomme les fichiers .htaccess, web.config, php.ini et .user.ini contenus dans l\'archive lors de l\'extraction. Les fichiers sont renommés avec l\'extension .bak. Les noms de fichiers sont restaurés lorsque vous cliquez sur Nettoyage.',
'RESTORE_PERMISSIONS_HELP' => 'Applique les permissions de fichiers (mais PAS la propriété des fichiers) qui ont été stockées au moment de la sauvegarde. Ne fonctionne qu\'avec les archives JPA et JPS. Ne fonctionne pas sous Windows (PHP n\'offre pas cette fonctionnalité).',
'EXTRACT_LIST' => 'Fichiers à extraire',
'EXTRACT_LIST_HELP' => 'Saisissez un chemin de fichier tel que images/cat.png ou un motif shell tel que images/*.png sur chaque ligne. Seuls les fichiers correspondant à cette liste seront écrits sur le disque. Laisser vide pour extraire tout le contenu (par défaut).',
'AKS3_IMPORT' => 'Importer depuis Amazon S3',
'AKS3_TITLE_STEP1' => 'Se connecter à Amazon S3',
'AKS3_ACCESS' => 'Clé d\'accès',
'AKS3_SECRET' => 'Clé secrète',
'AKS3_CONNECT' => 'Se connecter à Amazon S3',
'AKS3_CANCEL' => 'Annuler l\'importation',
'AKS3_TITLE_STEP2' => 'Sélectionner votre bucket Amazon S3',
'AKS3_BUCKET' => 'Bucket',
'AKS3_LISTCONTENTS' => 'Lister le contenu',
'AKS3_TITLE_STEP3' => 'Sélectionner l\'archive à importer',
'AKS3_FOLDERS' => 'Dossiers',
'AKS3_FILES' => 'Fichiers archive',
'AKS3_TITLE_STEP4' => 'Importation en cours…',
'AKS3_DO_NOT_CLOSE' => 'Veuillez ne pas fermer cette fenêtre pendant l\'importation de vos archives de sauvegarde',
'AKS3_TITLE_STEP5' => 'L\'importation est terminée',
'AKS3_BTN_RELOAD' => 'Recharger Kickstart',
'WRONG_FTP_PATH2' => 'Répertoire initial FTP incorrect - le répertoire ne correspond pas à la racine web de votre site',
'ARCHIVE_DIRECTORY' => 'Répertoire des archives :',
'RELOAD_ARCHIVES' => 'Recharger',
'CONFIG_UI_SFTPBROWSER_TITLE' => 'Navigateur de répertoires SFTP',
'ERR_COULD_NOT_OPEN_ARCHIVE_PART' => 'Impossible d\'ouvrir le fichier partie d\'archive %s en lecture. Vérifiez que le fichier existe, est lisible par le serveur web et ne se trouve pas dans un répertoire rendu inaccessible par chroot, les restrictions open_basedir ou toute autre restriction mise en place par votre hébergeur.',
'RENAME_FILES' => 'Renommer les fichiers de configuration du serveur avant l\'extraction',
'BTN_SHOW_FINE_TUNE' => 'Afficher les options avancées (pour experts)',
'RESTORE_PERMISSIONS' => 'Restaurer les permissions de fichiers',
'ZAPBEFORE' => 'Supprimer tout avant l\'extraction',
'ZAPBEFORE_HELP' => 'Tente de supprimer tous les fichiers et dossiers existants dans le répertoire où Kickstart est stocké avant d\'extraire l\'archive de sauvegarde. Il NE tient PAS compte des fichiers et dossiers présents dans l\'archive de sauvegarde. Les fichiers et dossiers supprimés par cette fonctionnalité NE PEUVENT PAS être récupérés. ATTENTION ! CELA PEUT SUPPRIMER DES FICHIERS ET DES DOSSIERS QUI NE APPARTIENNENT PAS À VOTRE SITE. UTILISER AVEC LA PLUS GRANDE PRUDENCE. EN ACTIVANT CETTE FONCTIONNALITÉ, VOUS ASSUMEZ L\'ENTIÈRE RESPONSABILITÉ ET LE RISQUE QUI EN RÉSULTE.',
);
/**
* Translation strings for de-DE
*
* @var array
*/
private $translation_de_de = array (
'AUTOMODEON' => 'Automodus aktiviert',
'ERR_NOT_A_JPA_FILE' => 'Die Datei ist kein JPA-Archiv',
'ERR_CORRUPT_ARCHIVE' => 'Die Archivdatei ist beschädigt, abgeschnitten oder Archivteile fehlen',
'ERR_INVALID_ARCHIVE_LONG' => 'Die Archivdatei scheint beschädigt zu sein oder Archivteile fehlen. Wenn Ihre Sicherungen aus mehreren Dateien bestehen, stellen Sie bitte sicher, dass Sie alle Archivteil-Dateien heruntergeladen haben (Dateien mit demselben Namen und den Erweiterungen .%s, .%s01, .%2$s02…). Bitte laden Sie und laden Sie Dateien über SFTP oder FTP im Binärübertragungsmodus hoch und überprüfen Sie, dass ihre Dateigröße mit den auf der Seite „Sicherungen verwalten" in Akeeba Backup / Akeeba Solo angegebenen Größen übereinstimmt.',
'ERR_INVALID_LOGIN' => 'Ungültige Anmeldung',
'COULDNT_CREATE_DIR' => 'Verzeichnis %s konnte nicht erstellt werden',
'COULDNT_WRITE_FILE' => 'Datei %s konnte nicht zum Schreiben geöffnet werden.',
'WRONG_FTP_HOST' => 'Falscher FTP-Host oder falscher Port',
'WRONG_FTP_USER' => 'Falscher FTP-Benutzername oder falsches Passwort',
'WRONG_FTP_PATH1' => 'Falsches FTP-Startverzeichnis – das Verzeichnis existiert nicht',
'FTP_CANT_CREATE_DIR' => 'Verzeichnis %s konnte nicht erstellt werden',
'FTP_TEMPDIR_NOT_WRITABLE' => 'Kein beschreibbares temporäres Verzeichnis gefunden oder erstellt werden',
'SFTP_TEMPDIR_NOT_WRITABLE' => 'Kein beschreibbares temporäres Verzeichnis gefunden oder erstellt werden',
'FTP_COULDNT_UPLOAD' => 'Datei %s konnte nicht hochgeladen werden',
'THINGS_HEADER' => 'Wichtige Informationen zu Akeeba Kickstart',
'THINGS_01' => 'Kickstart ist kein Installationsprogramm. Es ist ein Tool zum Entpacken von Archiven. Das eigentliche Installationsprogramm wurde beim Erstellen der Sicherung in die Archivdatei eingebettet.',
'THINGS_03' => 'Kickstart ist an die Konfiguration Ihres Servers gebunden. Daher kann es sein, dass es überhaupt nicht funktioniert.',
'THINGS_04' => 'Sie sollten Ihre Archivdateien über FTP im Binärübertragungsmodus herunterladen und hochladen. Jedes andere Verfahren kann zu einem beschädigten Sicherungsarchiv und einem Wiederherstellungsfehler führen.',
'THINGS_05' => 'Fehler beim Laden der Website nach der Wiederherstellung werden in der Regel durch .htaccess- oder php.ini-Direktiven verursacht. Sie sollten verstehen, dass leere Seiten, 404- und 500-Fehler in der Regel durch Bearbeiten der aforementioned Dateien behoben werden können. Es ist nicht unsere Aufgabe, Ihre Konfigurationsdateien zu verändern, da dies für Ihre Website gefährlich sein könnte.',
'THINGS_06' => 'Kickstart überschreibt Dateien ohne Warnung. Wenn Sie nicht sicher sind, dass Sie damit einverstanden sind, fahren Sie nicht fort.',
'THINGS_07' => 'Der Versuch, auf die temporäre URL eines cPanel-Hosts wiederherzustellen (z. B. http://1.2.3.4/~benutzername), führt zum Wiederherstellungsfehler und Ihre Website scheint nicht zu funktionieren. Dies ist normal und liegt an der Funktionsweise Ihres Servers und Ihrer CMS-Software.',
'THINGS_08' => 'Sie sollten die Dokumentation lesen, bevor Sie diese Software verwenden. Die meisten Probleme können durch das Verständnis der Funktionsweise dieser Software vermieden oder einfach behoben werden.',
'THINGS_09' => 'Dieser Text bedeutet nicht, dass ein Problem erkannt wurde. Es ist ein Standardtext, der bei jedem Start von Kickstart angezeigt wird.',
'CLOSE_LIGHTBOX' => 'Klicken Sie hier oder drücken Sie ESC, um diese Nachricht zu schließen',
'SELECT_ARCHIVE' => 'Ein Sicherungsarchiv auswählen',
'ARCHIVE_FILE' => 'Archivdatei:',
'SELECT_EXTRACTION' => 'Eine Extraktionsmethode auswählen',
'WRITE_TO_FILES' => 'In Dateien schreiben:',
'WRITE_HYBRID' => 'Hybrid (FTP nur bei Bedarf verwenden)',
'WRITE_DIRECTLY' => 'Direkt',
'WRITE_FTP' => 'FTP für alle Dateien verwenden',
'WRITE_SFTP' => 'SFTP für alle Dateien verwenden',
'FTP_HOST' => '(S)FTP-Hostname:',
'FTP_PORT' => '(S)FTP-Port:',
'FTP_FTPS' => 'FTP über SSL verwenden (FTPS)',
'FTP_PASSIVE' => 'FTP-Passivmodus verwenden',
'FTP_USER' => '(S)FTP-Benutzername:',
'FTP_PASS' => '(S)FTP-Passwort:',
'FTP_DIR' => '(S)FTP-Verzeichnis:',
'FTP_TEMPDIR' => 'Temporäres Verzeichnis:',
'FTP_CONNECTION_OK' => 'FTP-Verbindung hergestellt',
'SFTP_CONNECTION_OK' => 'SFTP-Verbindung hergestellt',
'FTP_CONNECTION_FAILURE' => 'Die FTP-Verbindung ist fehlgeschlagen',
'SFTP_CONNECTION_FAILURE' => 'Die SFTP-Verbindung ist fehlgeschlagen',
'FTP_TEMPDIR_WRITABLE' => 'Das temporäre Verzeichnis ist beschreibbar.',
'FTP_TEMPDIR_UNWRITABLE' => 'Das temporäre Verzeichnis ist nicht beschreibbar. Bitte überprüfen Sie die Berechtigungen.',
'FTP_BROWSE' => 'Durchsuchen',
'FTPBROWSER_LBL_INSTRUCTIONS' => 'Klicken Sie auf ein Verzeichnis, um darin zu navigieren. Klicken Sie auf OK, um dieses Verzeichnis auszuwählen, oder auf Abbrechen, um den Vorgang abzubrechen.',
'FTPBROWSER_ERROR_HOSTNAME' => 'Ungültiger FTP-Host oder falscher Port',
'FTPBROWSER_ERROR_USERPASS' => 'Ungültiger FTP-Benutzername oder falsches Passwort',
'FTPBROWSER_ERROR_NOACCESS' => 'Verzeichnis existiert nicht oder Sie haben nicht genügend Berechtigungen für den Zugriff',
'FTPBROWSER_ERROR_UNSUPPORTED' => 'Ihr FTP-Server unterstützt unseren FTP-Verzeichnisbrowser leider nicht.',
'FTPBROWSER_LBL_GOPARENT' => '<eine Ebene nach oben>',
'FTPBROWSER_LBL_ERROR' => 'Ein Fehler ist aufgetreten',
'SFTP_NO_SSH2' => 'Ihr Webserver verfügt nicht über das SSH2-PHP-Modul und kann daher keine Verbindung zu SFTP-Servern herstellen.',
'SFTP_NO_FTP_SUPPORT' => 'Ihr SSH-Server erlaubt keine SFTP-Verbindungen',
'SFTP_WRONG_USER' => 'Falscher SFTP-Benutzername oder falsches Passwort',
'SFTP_WRONG_STARTING_DIR' => 'Sie müssen einen gültigen absoluten Pfad angeben',
'SFTPBROWSER_ERROR_NOACCESS' => 'Verzeichnis existiert nicht oder Sie haben nicht genügend Berechtigungen für den Zugriff',
'SFTP_COULDNT_UPLOAD' => 'Datei %s konnte nicht hochgeladen werden',
'SFTP_CANT_CREATE_DIR' => 'Verzeichnis %s konnte nicht erstellt werden',
'UI-ROOT' => '<Wurzel>',
'CONFIG_UI_FTPBROWSER_TITLE' => 'FTP-Verzeichnisbrowser',
'BTN_CHECK' => 'Prüfen',
'BTN_RESET' => 'Zurücksetzen',
'BTN_TESTFTPCON' => 'FTP-Verbindung testen',
'BTN_TESTSFTPCON' => 'SFTP-Verbindung testen',
'BTN_GOTOSTART' => 'Von vorne beginnen',
'BTN_RETRY' => 'Wiederholen',
'FINE_TUNE' => 'Feineinstellungen',
'MIN_EXEC_TIME' => 'Minimale Ausführungszeit:',
'MAX_EXEC_TIME' => 'Maximale Ausführungszeit:',
'SECONDS_PER_STEP' => 'Sekunden pro Schritt',
'EXTRACT_FILES' => 'Dateien extrahieren',
'BTN_START' => 'Starten',
'EXTRACTING' => 'Extrahieren',
'DO_NOT_CLOSE_EXTRACT' => 'Schließen Sie dieses Fenster während der Extraktion nicht',
'RESTACLEANUP' => 'Wiederherstellung und Bereinigung',
'BTN_RUNINSTALLER' => 'Installationsprogramm ausführen',
'BTN_CLEANUP' => 'Bereinigen',
'BTN_SITEFE' => 'Website-Oberfläche besuchen',
'BTN_SITEBE' => 'Website-Backend besuchen',
'WARNINGS' => 'Extraktionswarnungen',
'ERROR_OCCURED' => 'Ein Fehler ist aufgetreten',
'STEALTH_MODE' => 'Tarnkappenmodus',
'STEALTH_URL' => 'HTML-Datei, die Websitzern angezeigt werden soll',
'ERR_NOT_A_JPS_FILE' => 'Die Datei ist kein JPS-Archiv',
'ERR_INVALID_JPS_PASSWORD' => 'Das von Ihnen eingegebene Passwort ist falsch oder das Archiv ist beschädigt',
'JPS_PASSWORD' => 'Archivpasswort (für JPS-Dateien)',
'INVALID_FILE_HEADER_OFFSET_ZERO' => 'Die Datei %s konnte nicht zum Lesen geöffnet werden. Dies ist Teil #%d Ihres Sicherungsarchivs, das aus mehreren Dateien besteht (Dateien mit demselben Namen und den Erweiterungen .%s, .%s01, .%4$s02…). Bitte stellen Sie sicher, dass sich alle diese Dateien im selben Verzeichnis wie Kickstart befinden.',
'INVALID_FILE_HEADER' => 'Ungültiger Header in der Archivdatei, Teil %s, Offset %s. Bitte laden Sie und laden Sie Sicherungsarchivdateien über SFTP oder FTP im Binärübertragungsmodus hoch und überprüfen Sie, dass ihre Dateigröße mit den auf der Seite „Sicherungen verwalten" in Akeeba Backup / Akeeba Solo angegebenen Größen übereinstimmt.',
'INVALID_FILE_HEADER_MULTIPART' => 'Ungültiger Header in der Archivdatei, Teil %s, Offset %s. Ihr Sicherungsarchiv besteht aus mehreren Dateien (Dateien mit demselben Namen und den Erweiterungen .%s, .%s01, .%4$s02…). Entweder fehlen einige Dateien, oder sie sind beschädigt oder abgeschnitten. Alle diese Dateien müssen im selben Verzeichnis vorhanden sein. Bitte laden Sie und laden Sie Sicherungsarchivdateien über SFTP oder FTP im Binärübertragungsmodus hoch und überprüfen Sie, dass ihre Dateigröße mit den auf der Seite „Sicherungen verwalten" in Akeeba Backup / Akeeba Solo angegebenen Größen übereinstimmt.',
'UPDATE_HEADER' => 'Eine aktualisierte Version von Akeeba Kickstart (unbekannt) ist verfügbar!',
'UPDATE_NOTICE' => 'Es wird empfohlen, immer die neueste verfügbare Version von Akeeba Kickstart zu verwenden. Ältere Versionen können Fehler enthalten und werden nicht unterstützt.',
'UPDATE_DLNOW' => 'Jetzt herunterladen',
'UPDATE_MOREINFO' => 'Weitere Informationen',
'NEEDSOMEHELPKS' => 'Brauchen Sie Hilfe bei der Verwendung dieses Tools? Lesen Sie zuerst dies:',
'QUICKSTART' => 'Schnellstartanleitung',
'CANTGETITTOWORK' => 'Funktioniert es nicht? Hier klicken!',
'NOARCHIVESCLICKHERE' => 'Keine Archive erkannt. Hier klicken für Fehlerbehebungsanweisungen.',
'POSTRESTORATIONTROUBLESHOOTING' => 'Nach der Wiederherstellung funktioniert etwas nicht? Hier klicken für Fehlerbehebungsanweisungen.',
'IGNORE_MOST_ERRORS' => 'Die meisten Fehler ignorieren',
'TIME_SETTINGS_HELP' => 'Erhöhen Sie das Minimum auf 3, wenn Sie AJAX-Fehler erhalten. Erhöhen Sie das Maximum auf 10 für eine schnellere Extraktion, verringern Sie es auf 5, wenn Sie AJAX-Fehler erhalten. Versuchen Sie Minimum 5, Maximum 1 (kein Tippfehler!), wenn Sie weiterhin AJAX-Fehler erhalten.',
'STEALTH_MODE_HELP' => 'Wenn aktiviert, können nur Besucher von Ihrer IP-Adresse die Website bis zum Abschluss der Wiederherstellung sehen. Alle anderen werden zur oben genannten URL weitergeleitet und sehen nur diese. Ihr Server muss die echte IP des Besuchers erkennen (dies wird von Ihrem Host, nicht von Ihnen oder uns, gesteuert).',
'RENAME_FILES_HELP' => 'Benennt .htaccess, web.config, php.ini und .user.ini im Archiv beim Extrahieren um. Die Dateien erhalten die Erweiterung .bak. Die Dateinamen werden beim Klicken auf „Bereinigen" wiederhergestellt.',
'RESTORE_PERMISSIONS_HELP' => 'Wendet die beim Sichern gespeicherten Dateiberechtigungen (aber NICHT den Datei-Besitz) an. Funktioniert nur mit JPA- und JPS-Archiven. Funktioniert nicht unter Windows (PHP bietet diese Funktion nicht an).',
'EXTRACT_LIST' => 'Zu extrahierende Dateien',
'EXTRACT_LIST_HELP' => 'Geben Sie in jeder Zeile einen Dateipfad wie images/cat.png oder ein Shell-Muster wie images/*.png ein. Nur die mit dieser Liste übereinstimmenden Dateien werden auf die Festplatte geschrieben. Leer lassen, um alles zu extrahieren (Standard).',
'AKS3_IMPORT' => 'Von Amazon S3 importieren',
'AKS3_TITLE_STEP1' => 'Verbindung zu Amazon S3 herstellen',
'AKS3_ACCESS' => 'Zugriffsschlüssel',
'AKS3_SECRET' => 'Geheimschlüssel',
'AKS3_CONNECT' => 'Verbindung zu Amazon S3 herstellen',
'AKS3_CANCEL' => 'Import abbrechen',
'AKS3_TITLE_STEP2' => 'Amazon S3-Bucket auswählen',
'AKS3_BUCKET' => 'Bucket',
'AKS3_LISTCONTENTS' => 'Inhalt auflisten',
'AKS3_TITLE_STEP3' => 'Archiv zum Importieren auswählen',
'AKS3_FOLDERS' => 'Ordner',
'AKS3_FILES' => 'Archivdateien',
'AKS3_TITLE_STEP4' => 'Importiert…',
'AKS3_DO_NOT_CLOSE' => 'Bitte schließen Sie dieses Fenster nicht, während Ihre Sicherungsarchive importiert werden',
'AKS3_TITLE_STEP5' => 'Import abgeschlossen',
'AKS3_BTN_RELOAD' => 'Kickstart neu laden',
'WRONG_FTP_PATH2' => 'Falsches FTP-Startverzeichnis – das Verzeichnis entspricht nicht dem Web-Stammverzeichnis Ihrer Website',
'ARCHIVE_DIRECTORY' => 'Archivverzeichnis:',
'RELOAD_ARCHIVES' => 'Neu laden',
'CONFIG_UI_SFTPBROWSER_TITLE' => 'SFTP-Verzeichnisbrowser',
'ERR_COULD_NOT_OPEN_ARCHIVE_PART' => 'Archivteil-Datei %s konnte nicht zum Lesen geöffnet werden. Überprüfen Sie, ob die Datei existiert, vom Webserver lesbar ist und sich nicht in einem durch chroot-, open_basedir-Einschränkungen oder andere vom Host gesetzte Einschränkungen unzugänglichen Verzeichnis befindet.',
'RENAME_FILES' => 'Server-Konfigurationsdateien vor der Extraktion umbenennen',
'BTN_SHOW_FINE_TUNE' => 'Erweiterte Optionen anzeigen (für Experten)',
'RESTORE_PERMISSIONS' => 'Dateiberechtigungen wiederherstellen',
'ZAPBEFORE' => 'Vor der Extraktion alles löschen',
'ZAPBEFORE_HELP' => 'Versucht, alle vorhandenen Dateien und Ordner unter dem Verzeichnis, in dem Kickstart gespeichert ist, vor dem Entpacken des Sicherungsarchivs zu löschen. Es wird NICHT berücksichtigt, welche Dateien und Ordner im Sicherungsarchiv vorhanden sind. Dateien und Ordner, die durch diese Funktion gelöscht werden, Können NICHT wiederhergestellt werden. WARNUNG! DIES KÖNNTE DATEIEN UND ORNER LÖSCHEN, DIE NICHT ZU IHRER WEBSITE GEHÖREN. MIT EXTREMER VORSICHT VERWENDEN. DURCH DAS AKTIVIEREN DIESER FUNKTION ÜBERNEHMEN SIE DIE VOLLE VERANTWORTUNG UND HAFTUNG.',
);
/**
* Translation strings for es-ES
*
* @var array
*/
private $translation_es_es = array (
'AUTOMODEON' => 'Modo automático activado',
'ERR_NOT_A_JPA_FILE' => 'El archivo no es un archivo JPA',
'ERR_CORRUPT_ARCHIVE' => 'El archivo de archivo está corrupto, truncado o faltan partes del archivo',
'ERR_INVALID_ARCHIVE_LONG' => 'El archivo de archivo parece estar corrupto o faltan partes del archivo. Si sus copias de seguridad consisten en varios archivos, asegúrese de haber descargado todos los archivos de parte del archivo (archivos con el mismo nombre y extensiones .%s, .%s01, .%2$s02…). Asegúrese de descargar y cargar archivos usando SFTP, o FTP en modo de transferencia binaria y compruebe que su tamaño coincide con los tamaños reportados en la página Gestionar copias de seguridad de Akeeba Backup / Akeeba Solo.',
'ERR_INVALID_LOGIN' => 'Inicio de sesión no válido',
'COULDNT_CREATE_DIR' => 'No se pudo crear la carpeta %s',
'COULDNT_WRITE_FILE' => 'No se pudo abrir %s para escritura.',
'WRONG_FTP_HOST' => 'Host o puerto FTP incorrecto',
'WRONG_FTP_USER' => 'Nombre de usuario o contraseña FTP incorrectos',
'WRONG_FTP_PATH1' => 'Directorio inicial FTP incorrecto: el directorio no existe',
'FTP_CANT_CREATE_DIR' => 'No se pudo crear el directorio %s',
'FTP_TEMPDIR_NOT_WRITABLE' => 'No se pudo encontrar o crear un directorio temporal con permiso de escritura',
'SFTP_TEMPDIR_NOT_WRITABLE' => 'No se pudo encontrar o crear un directorio temporal con permiso de escritura',
'FTP_COULDNT_UPLOAD' => 'No se pudo cargar %s',
'THINGS_HEADER' => 'Aspectos que debe conocer sobre Akeeba Kickstart',
'THINGS_01' => 'Kickstart no es un instalador. Es una herramienta de extracción de archivos. El instalador real se incluyó dentro del archivo en el momento de la copia de seguridad.',
'THINGS_03' => 'Kickstart está limitado por la configuración de su servidor. Como tal, es posible que no funcione en absoluto.',
'THINGS_04' => 'Debe descargar y cargar sus archivos de archivo usando FTP en modo de transferencia binaria. Cualquier otro método podría provocar un archivo de copia de seguridad corrupto y un fallo en la restauración.',
'THINGS_05' => 'Los errores de carga del sitio después de la restauración suelen ser causados por directivas de .htaccess o php.ini. Debe comprender que las páginas en blanco, los errores 404 y 500 suelen poder resolverse editando los archivos mencionados anteriormente. No es nuestra tarea modificar sus archivos de configuración, ya que esto podría ser peligroso para su sitio.',
'THINGS_06' => 'Kickstart sobrescribe archivos sin previo aviso. Si no está seguro de que le parece bien, no continúe.',
'THINGS_07' => 'Intentar restaurar en la URL temporal de un host de cPanel (por ejemplo, http://1.2.3.4/~usuario) provocará un fallo en la restauración y su sitio parecerá no funcionar. Esto es normal y se debe a cómo funcionan su servidor y el software del CMS.',
'THINGS_08' => 'Debe leer la documentación antes de usar este software. La mayoría de los problemas se pueden evitar, o resolver fácilmente, comprendiendo cómo funciona este software.',
'THINGS_09' => 'Este texto no implica que se haya detectado un problema. Es un texto estándar que se muestra cada vez que inicia Kickstart.',
'CLOSE_LIGHTBOX' => 'Haga clic aquí o pulse ESC para cerrar este mensaje',
'SELECT_ARCHIVE' => 'Seleccionar un archivo de copia de seguridad',
'ARCHIVE_FILE' => 'Archivo de archivo:',
'SELECT_EXTRACTION' => 'Seleccionar un método de extracción',
'WRITE_TO_FILES' => 'Escribir en archivos:',
'WRITE_HYBRID' => 'Híbrido (usar FTP solo si es necesario)',
'WRITE_DIRECTLY' => 'Directamente',
'WRITE_FTP' => 'Usar FTP para todos los archivos',
'WRITE_SFTP' => 'Usar SFTP para todos los archivos',
'FTP_HOST' => 'Nombre de host (S)FTP:',
'FTP_PORT' => 'Puerto (S)FTP:',
'FTP_FTPS' => 'Usar FTP sobre SSL (FTPS)',
'FTP_PASSIVE' => 'Usar el modo pasivo de FTP',
'FTP_USER' => 'Nombre de usuario (S)FTP:',
'FTP_PASS' => 'Contraseña (S)FTP:',
'FTP_DIR' => 'Directorio (S)FTP:',
'FTP_TEMPDIR' => 'Directorio temporal:',
'FTP_CONNECTION_OK' => 'Conexión FTP establecida',
'SFTP_CONNECTION_OK' => 'Conexión SFTP establecida',
'FTP_CONNECTION_FAILURE' => 'La conexión FTP falló',
'SFTP_CONNECTION_FAILURE' => 'La conexión SFTP falló',
'FTP_TEMPDIR_WRITABLE' => 'El directorio temporal tiene permiso de escritura.',
'FTP_TEMPDIR_UNWRITABLE' => 'El directorio temporal no tiene permiso de escritura. Compruebe los permisos.',
'FTP_BROWSE' => 'Examinar',
'FTPBROWSER_LBL_INSTRUCTIONS' => 'Haga clic en un directorio para navegar en él. Haga clic en Aceptar para seleccionar ese directorio, o Cancelar para abortar el procedimiento.',
'FTPBROWSER_ERROR_HOSTNAME' => 'Host o puerto FTP no válido',
'FTPBROWSER_ERROR_USERPASS' => 'Nombre de usuario o contraseña FTP no válidos',
'FTPBROWSER_ERROR_NOACCESS' => 'El directorio no existe o no tiene suficientes permisos para acceder a él',
'FTPBROWSER_ERROR_UNSUPPORTED' => 'Lo sentimos, su servidor FTP no admite nuestro explorador de directorios FTP.',
'FTPBROWSER_LBL_GOPARENT' => '<subir un nivel>',
'FTPBROWSER_LBL_ERROR' => 'Se produjo un error',
'SFTP_NO_SSH2' => 'Su servidor web no tiene el módulo PHP SSH2, por lo tanto no puede conectarse a servidores SFTP.',
'SFTP_NO_FTP_SUPPORT' => 'Su servidor SSH no permite conexiones SFTP',
'SFTP_WRONG_USER' => 'Nombre de usuario o contraseña SFTP incorrectos',
'SFTP_WRONG_STARTING_DIR' => 'Debe proporcionar una ruta absoluta válida',
'SFTPBROWSER_ERROR_NOACCESS' => 'El directorio no existe o no tiene suficientes permisos para acceder a él',
'SFTP_COULDNT_UPLOAD' => 'No se pudo cargar %s',
'SFTP_CANT_CREATE_DIR' => 'No se pudo crear el directorio %s',
'UI-ROOT' => '<raíz>',
'CONFIG_UI_FTPBROWSER_TITLE' => 'Explorador de directorios FTP',
'BTN_CHECK' => 'Comprobar',
'BTN_RESET' => 'Restablecer',
'BTN_TESTFTPCON' => 'Probar conexión FTP',
'BTN_TESTSFTPCON' => 'Probar conexión SFTP',
'BTN_GOTOSTART' => 'Empezar de nuevo',
'BTN_RETRY' => 'Reintentar',
'FINE_TUNE' => 'Ajuste fino',
'MIN_EXEC_TIME' => 'Tiempo mínimo de ejecución:',
'MAX_EXEC_TIME' => 'Tiempo máximo de ejecución:',
'SECONDS_PER_STEP' => 'segundos por paso',
'EXTRACT_FILES' => 'Extraer archivos',
'BTN_START' => 'Iniciar',
'EXTRACTING' => 'Extrayendo',
'DO_NOT_CLOSE_EXTRACT' => 'No cierre esta ventana mientras la extracción esté en curso',
'RESTACLEANUP' => 'Restauración y limpieza',
'BTN_RUNINSTALLER' => 'Ejecutar el instalador',
'BTN_CLEANUP' => 'Limpiar',
'BTN_SITEFE' => 'Visitar la parte frontal de su sitio',
'BTN_SITEBE' => 'Visitar la parte trasera de su sitio',
'WARNINGS' => 'Advertencias de extracción',
'ERROR_OCCURED' => 'Se produjo un error',
'STEALTH_MODE' => 'Modo sigiloso',
'STEALTH_URL' => 'Archivo HTML que se mostrará a los visitantes web',
'ERR_NOT_A_JPS_FILE' => 'El archivo no es un archivo JPS',
'ERR_INVALID_JPS_PASSWORD' => 'La contraseña que proporcionó es incorrecta o el archivo está corrupto',
'JPS_PASSWORD' => 'Contraseña del archivo (para archivos JPS)',
'INVALID_FILE_HEADER_OFFSET_ZERO' => 'No se puede abrir el archivo %s para lectura. Esta es la parte nº %d de su archivo de copia de seguridad, que consiste en varios archivos (archivos con el mismo nombre y extensiones .%s, .%s01, .%4$s02…). Asegúrese de tener todos estos archivos en la misma carpeta que Kickstart.',
'INVALID_FILE_HEADER' => 'Encabezado no válido en el archivo de archivo, parte %s, desplazamiento %s. Asegúrese de descargar y cargar archivos de copia de seguridad usando SFTP, o FTP en modo de transferencia binaria y compruebe que su tamaño coincide con los tamaños reportados en la página Gestionar copias de seguridad de Akeeba Backup / Akeeba Solo.',
'INVALID_FILE_HEADER_MULTIPART' => 'Encabezado no válido en el archivo de archivo, parte %s, desplazamiento %s. Su archivo de copia de seguridad consiste en varios archivos (archivos con el mismo nombre y extensiones .%s, .%s01, .%4$s02…). Algunos archivos pueden faltar, o estar corruptos o truncados. Necesitará que todos estos archivos estén presentes en el mismo directorio. Asegúrese de descargar y cargar archivos de copia de seguridad usando SFTP, o FTP en modo de transferencia binaria y compruebe que su tamaño coincide con los tamaños reportados en la página Gestionar copias de seguridad de Akeeba Backup / Akeeba Solo.',
'UPDATE_HEADER' => '¡Hay una versión actualizada de Akeeba Kickstart (desconocida) disponible!',
'UPDATE_NOTICE' => 'Se le recomienda utilizar siempre la última versión disponible de Akeeba Kickstart. Las versiones anteriores pueden tener errores y no recibirán soporte.',
'UPDATE_DLNOW' => 'Descargar ahora',
'UPDATE_MOREINFO' => 'Más información',
'NEEDSOMEHELPKS' => '¿Necesita ayuda para usar esta herramienta? Lea esto primero:',
'QUICKSTART' => 'Guía de inicio rápido',
'CANTGETITTOWORK' => '¿No consigue que funcione? ¡Haga clic aquí!',
'NOARCHIVESCLICKHERE' => 'No se han detectado archivos. Haga clic aquí para obtener instrucciones de solución de problemas.',
'POSTRESTORATIONTROUBLESHOOTING' => '¿Algo no funciona después de la restauración? Haga clic aquí para obtener instrucciones de solución de problemas.',
'IGNORE_MOST_ERRORS' => 'Ignorar la mayoría de los errores',
'TIME_SETTINGS_HELP' => 'Aumente el mínimo a 3 si obtiene errores de AJAX. Aumente el máximo a 10 para una extracción más rápida, disminúyalo a 5 si obtiene errores de AJAX. Pruebe con mínimo 5, máximo 1 (no es un error tipográfico) si sigue obteniendo errores de AJAX.',
'STEALTH_MODE_HELP' => 'Cuando está activado, solo los visitantes desde su dirección IP podrán ver el sitio hasta que se complete la restauración. Todos los demás serán redirigidos a la URL anterior y solo verán esa página. Su servidor debe ver la IP real del visitante (esto está controlado por su proveedor de alojamiento, no por usted ni por nosotros).',
'RENAME_FILES_HELP' => 'Renombra los archivos .htaccess, web.config, php.ini y .user.ini contenidos en el archivo durante la extracción. Los archivos se renombran con una extensión .bak. Los nombres de archivo se restauran cuando hace clic en Limpiar.',
'RESTORE_PERMISSIONS_HELP' => 'Aplica los permisos de archivo (pero NO la propiedad del archivo) que se almacenaron en el momento de la copia de seguridad. Solo funciona con archivos JPA y JPS. No funciona en Windows (PHP no ofrece esta funcionalidad).',
'EXTRACT_LIST' => 'Archivos a extraer',
'EXTRACT_LIST_HELP' => 'Introduzca una ruta de archivo como images/cat.png o un patrón de shell como images/*.png en cada línea. Solo los archivos que coincidan con esta lista se escribirán en el disco. Déjelo vacío para extraer todo (predeterminado).',
'AKS3_IMPORT' => 'Importar desde Amazon S3',
'AKS3_TITLE_STEP1' => 'Conectar a Amazon S3',
'AKS3_ACCESS' => 'Clave de acceso',
'AKS3_SECRET' => 'Clave secreta',
'AKS3_CONNECT' => 'Conectar a Amazon S3',
'AKS3_CANCEL' => 'Cancelar importación',
'AKS3_TITLE_STEP2' => 'Seleccionar su bucket de Amazon S3',
'AKS3_BUCKET' => 'Bucket',
'AKS3_LISTCONTENTS' => 'Mostrar contenido',
'AKS3_TITLE_STEP3' => 'Seleccionar archivo para importar',
'AKS3_FOLDERS' => 'Carpetas',
'AKS3_FILES' => 'Archivos de archivo',
'AKS3_TITLE_STEP4' => 'Importando...',
'AKS3_DO_NOT_CLOSE' => 'Por favor, no cierre esta ventana mientras se están importando sus archivos de copia de seguridad',
'AKS3_TITLE_STEP5' => 'La importación se ha completado',
'AKS3_BTN_RELOAD' => 'Recargar Kickstart',
'WRONG_FTP_PATH2' => 'Directorio inicial FTP incorrecto: el directorio no corresponde con la raíz web de su sitio',
'ARCHIVE_DIRECTORY' => 'Directorio de archivos:',
'RELOAD_ARCHIVES' => 'Recargar',
'CONFIG_UI_SFTPBROWSER_TITLE' => 'Explorador de directorios SFTP',
'ERR_COULD_NOT_OPEN_ARCHIVE_PART' => 'No se pudo abrir el archivo de parte del archivo %s para lectura. Compruebe que el archivo existe, es legible por el servidor web y no se encuentra en un directorio inaccesible debido a chroot, restricciones open_basedir o cualquier otra restricción impuesta por su proveedor de alojamiento.',
'RENAME_FILES' => 'Renombrar archivos de configuración del servidor antes de la extracción',
'BTN_SHOW_FINE_TUNE' => 'Mostrar opciones avanzadas (para expertos)',
'RESTORE_PERMISSIONS' => 'Restaurar permisos de archivo',
'ZAPBEFORE' => 'Eliminar todo antes de la extracción',
'ZAPBEFORE_HELP' => 'Intenta eliminar todos los archivos y carpetas existentes bajo el directorio donde se almacena Kickstart antes de extraer el archivo de copia de seguridad. NO tiene en cuenta qué archivos y carpetas existen en el archivo de copia de seguridad. Los archivos y carpetas eliminados por esta función NO SE PUEDEN recuperar. ¡ADVERTENCIA! ESTO PUEDE ELIMINAR ARCHIVOS Y CARPETAS QUE NO PERTENECEN A SU SITIO. USE CON EXTREMA PRECAUCIÓN. AL ACTIVAR ESTA FUNCIÓN USTED Asume TODA LA RESPONSABILIDAD.',
);
/**
* Translation strings for it-IT
*
* @var array
*/
private $translation_it_it = array (
'AUTOMODEON' => 'Modalità automatica attivata',
'ERR_NOT_A_JPA_FILE' => 'Il file non è un archivio JPA',
'ERR_CORRUPT_ARCHIVE' => 'Il file di archivio è corrotto, troncato o mancano parti dell\'archivio',
'ERR_INVALID_ARCHIVE_LONG' => 'Il file di archivio sembra essere corrotto, o mancano parti dell\'archivio. Se i tuoi backup sono composti da più file, assicurati di aver scaricato tutti i file delle parti dell\'archivio (file con lo stesso nome ed estensioni .%s, .%s01, .%2$s02…). Assicurati di scaricare e caricare i file usando SFTP, o FTP in modalità di trasferimento Binario e verifica che le loro dimensioni corrispondano a quelle riportate nella pagina Gestione Backup di Akeeba Backup / Akeeba Solo.',
'ERR_INVALID_LOGIN' => 'Accesso non valido',
'COULDNT_CREATE_DIR' => 'Impossibile creare la cartella %s',
'COULDNT_WRITE_FILE' => 'Impossibile aprire %s per la scrittura.',
'WRONG_FTP_HOST' => 'Host o porta FTP errati',
'WRONG_FTP_USER' => 'Nome utente o password FTP errati',
'WRONG_FTP_PATH1' => 'Directory iniziale FTP errata - la directory non esiste',
'FTP_CANT_CREATE_DIR' => 'Impossibile creare la directory %s',
'FTP_TEMPDIR_NOT_WRITABLE' => 'Impossibile trovare o creare una directory temporanea scrivibile',
'SFTP_TEMPDIR_NOT_WRITABLE' => 'Impossibile trovare o creare una directory temporanea scrivibile',
'FTP_COULDNT_UPLOAD' => 'Impossibile caricare %s',
'THINGS_HEADER' => 'Cose che dovresti sapere su Akeeba Kickstart',
'THINGS_01' => 'Kickstart non è un programma di installazione. È uno strumento di estrazione degli archivi. Il programma di installazione effettivo è stato inserito nel file di archivio al momento del backup.',
'THINGS_03' => 'Kickstart è limitato dalla configurazione del tuo server. Come tale, potrebbe non funzionare affatto.',
'THINGS_04' => 'Dovresti scaricare e caricare i file di archivio usando FTP in modalità di trasferimento Binario. Qualsiasi altro metodo potrebbe portare a un archivio di backup corrotto e al fallimento del ripristino.',
'THINGS_05' => 'Gli errori di caricamento del sito dopo il ripristino sono generalmente causati da direttive .htaccess o php.ini. Dovresti capire che le pagine bianche, gli errori 404 e 500 possono di solito essere risolti modificando i suddetti file. Non è il nostro compito modificare i tuoi file di configurazione, perché questo potrebbe essere pericoloso per il tuo sito.',
'THINGS_06' => 'Kickstart sovrascrive i file senza preavviso. Se non sei sicuro che vada bene, non continuare.',
'THINGS_07' => 'Tentare di ripristinare sull\'URL temporaneo di un host cPanel (es. http://1.2.3.4/~username) porterà al fallimento del ripristino e il tuo sito sembrerà non funzionare. Questo è normale ed è semplicemente il modo in cui il tuo server e il software CMS funzionano.',
'THINGS_08' => 'Dovresti leggere la documentazione prima di usare questo software. La maggior parte dei problemi può essere evitata, o facilmente risolta, capendo come funziona questo software.',
'THINGS_09' => 'Questo testo non implica che sia stato rilevato un problema. È un testo standard visualizzato ogni volta che avvii Kickstart.',
'CLOSE_LIGHTBOX' => 'Clicca qui o premi ESC per chiudere questo messaggio',
'SELECT_ARCHIVE' => 'Seleziona un archivio di backup',
'ARCHIVE_FILE' => 'File di archivio:',
'SELECT_EXTRACTION' => 'Seleziona un metodo di estrazione',
'WRITE_TO_FILES' => 'Scrittura su file:',
'WRITE_HYBRID' => 'Ibrido (usa FTP solo se necessario)',
'WRITE_DIRECTLY' => 'Direttamente',
'WRITE_FTP' => 'Usa FTP per tutti i file',
'WRITE_SFTP' => 'Usa SFTP per tutti i file',
'FTP_HOST' => 'Nome host (S)FTP:',
'FTP_PORT' => 'Porta (S)FTP:',
'FTP_FTPS' => 'Usa FTP su SSL (FTPS)',
'FTP_PASSIVE' => 'Usa la modalità passiva FTP',
'FTP_USER' => 'Nome utente (S)FTP:',
'FTP_PASS' => 'Password (S)FTP:',
'FTP_DIR' => 'Directory (S)FTP:',
'FTP_TEMPDIR' => 'Directory temporanea:',
'FTP_CONNECTION_OK' => 'Connessione FTP stabilita',
'SFTP_CONNECTION_OK' => 'Connessione SFTP stabilita',
'FTP_CONNECTION_FAILURE' => 'La connessione FTP è fallita',
'SFTP_CONNECTION_FAILURE' => 'La connessione SFTP è fallita',
'FTP_TEMPDIR_WRITABLE' => 'La directory temporanea è scrivibile.',
'FTP_TEMPDIR_UNWRITABLE' => 'La directory temporanea non è scrivibile. Verifica le autorizzazioni.',
'FTP_BROWSE' => 'Sfoglia',
'FTPBROWSER_LBL_INSTRUCTIONS' => 'Clicca su una directory per navigare al suo interno. Clicca su OK per selezionare quella directory, Annulla per interrompere la procedura.',
'FTPBROWSER_ERROR_HOSTNAME' => 'Host o porta FTP non validi',
'FTPBROWSER_ERROR_USERPASS' => 'Nome utente o password FTP non validi',
'FTPBROWSER_ERROR_NOACCESS' => 'La directory non esiste o non hai autorizzazioni sufficienti per accedervi',
'FTPBROWSER_ERROR_UNSUPPORTED' => 'Spiacenti, il tuo server FTP non supporta il nostro browser di directory FTP.',
'FTPBROWSER_LBL_GOPARENT' => '<su di un livello>',
'FTPBROWSER_LBL_ERROR' => 'Si è verificato un errore',
'SFTP_NO_SSH2' => 'Il tuo server web non dispone del modulo PHP SSH2, quindi non può connettersi ai server SFTP.',
'SFTP_NO_FTP_SUPPORT' => 'Il tuo server SSH non consente connessioni SFTP',
'SFTP_WRONG_USER' => 'Nome utente o password SFTP errati',
'SFTP_WRONG_STARTING_DIR' => 'Devi fornire un percorso assoluto valido',
'SFTPBROWSER_ERROR_NOACCESS' => 'La directory non esiste o non hai autorizzazioni sufficienti per accedervi',
'SFTP_COULDNT_UPLOAD' => 'Impossibile caricare %s',
'SFTP_CANT_CREATE_DIR' => 'Impossibile creare la directory %s',
'UI-ROOT' => '<root>',
'CONFIG_UI_FTPBROWSER_TITLE' => 'Browser di directory FTP',
'BTN_CHECK' => 'Verifica',
'BTN_RESET' => 'Reimposta',
'BTN_TESTFTPCON' => 'Testa la connessione FTP',
'BTN_TESTSFTPCON' => 'Testa la connessione SFTP',
'BTN_GOTOSTART' => 'Ricomincia',
'BTN_RETRY' => 'Riprova',
'FINE_TUNE' => 'Regola in dettaglio',
'MIN_EXEC_TIME' => 'Tempo minimo di esecuzione:',
'MAX_EXEC_TIME' => 'Tempo massimo di esecuzione:',
'SECONDS_PER_STEP' => 'secondi per passaggio',
'EXTRACT_FILES' => 'Estrai file',
'BTN_START' => 'Avvia',
'EXTRACTING' => 'Estrazione in corso',
'DO_NOT_CLOSE_EXTRACT' => 'Non chiudere questa finestra mentre l\'estrazione è in corso',
'RESTACLEANUP' => 'Ripristino e pulizia',
'BTN_RUNINSTALLER' => 'Esegui il programma di installazione',
'BTN_CLEANUP' => 'Pulisci',
'BTN_SITEFE' => 'Visita il frontend del tuo sito',
'BTN_SITEBE' => 'Visita il backend del tuo sito',
'WARNINGS' => 'Avvisi di estrazione',
'ERROR_OCCURED' => 'Si è verificato un errore',
'STEALTH_MODE' => 'Modalità stealth',
'STEALTH_URL' => 'File HTML da mostrare ai visitatori web',
'ERR_NOT_A_JPS_FILE' => 'Il file non è un archivio JPS',
'ERR_INVALID_JPS_PASSWORD' => 'La password inserita è errata o l\'archivio è corrotto',
'JPS_PASSWORD' => 'Password dell\'archivio (per file JPS)',
'INVALID_FILE_HEADER_OFFSET_ZERO' => 'Impossibile aprire il file %s per la lettura. Questa è la parte #%d del tuo archivio di backup che è composto da più file (file con lo stesso nome ed estensioni .%s, .%s01, .%4$s02…). Assicurati di avere tutti questi file nella stessa cartella di Kickstart.',
'INVALID_FILE_HEADER' => 'Intestazione non valida nel file di archivio, parte %s, offset %s. Assicurati di scaricare e caricare i file di archivio di backup usando SFTP, o FTP in modalità di trasferimento Binario e verifica che le loro dimensioni corrispondano a quelle riportate nella pagina Gestione Backup di Akeeba Backup / Akeeba Solo.',
'INVALID_FILE_HEADER_MULTIPART' => 'Intestazione non valida nel file di archivio, parte %s, offset %s. Il tuo archivio di backup è composto da più file (file con lo stesso nome ed estensioni .%s, .%s01, .%4$s02…). Alcuni file potrebbero mancare, oppure sono corrotti o troncati. Avrai bisogno di tutti questi file presenti nella stessa directory. Assicurati di scaricare e caricare i file di archivio di backup usando SFTP, o FTP in modalità di trasferimento Binario e verifica che le loro dimensioni corrispondano a quelle riportate nella pagina Gestione Backup di Akeeba Backup / Akeeba Solo.',
'UPDATE_HEADER' => 'È disponibile una versione aggiornata di Akeeba Kickstart (unknown)!',
'UPDATE_NOTICE' => 'Si consiglia di utilizzare sempre l\'ultima versione disponibile di Akeeba Kickstart. Le versioni precedenti potrebbero essere soggette a bug e non saranno supportate.',
'UPDATE_DLNOW' => 'Scarica ora',
'UPDATE_MOREINFO' => 'Maggiori informazioni',
'NEEDSOMEHELPKS' => 'Hai bisogno di aiuto per usare questo strumento? Leggi prima questo:',
'QUICKSTART' => 'Guida rapida',
'CANTGETITTOWORK' => 'Non riesci a farlo funzionare? Clicca qui!',
'NOARCHIVESCLICKHERE' => 'Nessun archivio rilevato. Clicca qui per le istruzioni di risoluzione dei problemi.',
'POSTRESTORATIONTROUBLESHOOTING' => 'Qualcosa non funziona dopo il ripristino? Clicca qui per le istruzioni di risoluzione dei problemi.',
'IGNORE_MOST_ERRORS' => 'Ignora la maggior parte degli errori',
'TIME_SETTINGS_HELP' => 'Aumenta il minimo a 3 se ricevi errori AJAX. Aumenta il massimo a 10 per un\'estrazione più veloce, riduci a 5 se ricevi errori AJAX. Prova minimo 5, massimo 1 (non è un errore di battitura!) se continui a ricevere errori AJAX.',
'STEALTH_MODE_HELP' => 'Quando attivata, solo i visitatori dal tuo indirizzo IP potranno vedere il sito fino al completamento del ripristino. Tutti gli altri saranno reindirizzati e vedranno solo la URL sopra. Il tuo server deve vedere l\'IP reale del visitatore (questo è controllato dal tuo host, non da te o da noi).',
'RENAME_FILES_HELP' => 'Rinomina .htaccess, web.config, php.ini e .user.ini contenuti nell\'archivio durante l\'estrazione. I file vengono rinominati con un\'estensione .bak. I nomi dei file vengono ripristinati quando clicchi su Pulisci.',
'RESTORE_PERMISSIONS_HELP' => 'Applica le autorizzazioni dei file (ma NON la proprietà dei file) che sono state memorizzate al momento del backup. Funziona solo con archivi JPA e JPS. Non funziona su Windows (PHP non offre questa funzionalità).',
'EXTRACT_LIST' => 'File da estrarre',
'EXTRACT_LIST_HELP' => 'Inserisci un percorso di file come images/cat.png o un modello shell come images/*.png su ogni riga. Solo i file corrispondenti a questo elenco verranno scritti su disco. Lasciare vuoto per estrarre tutto (predefinito).',
'AKS3_IMPORT' => 'Importa da Amazon S3',
'AKS3_TITLE_STEP1' => 'Connetti ad Amazon S3',
'AKS3_ACCESS' => 'Chiave di accesso',
'AKS3_SECRET' => 'Chiave segreta',
'AKS3_CONNECT' => 'Connetti ad Amazon S3',
'AKS3_CANCEL' => 'Annulla importazione',
'AKS3_TITLE_STEP2' => 'Seleziona il tuo bucket Amazon S3',
'AKS3_BUCKET' => 'Bucket',
'AKS3_LISTCONTENTS' => 'Elenca contenuti',
'AKS3_TITLE_STEP3' => 'Seleziona l\'archivio da importare',
'AKS3_FOLDERS' => 'Cartelle',
'AKS3_FILES' => 'File di archivio',
'AKS3_TITLE_STEP4' => 'Importazione in corso...',
'AKS3_DO_NOT_CLOSE' => 'Non chiudere questa finestra mentre i tuoi archivi di backup vengono importati',
'AKS3_TITLE_STEP5' => 'L\'importazione è completata',
'AKS3_BTN_RELOAD' => 'Ricarica Kickstart',
'WRONG_FTP_PATH2' => 'Directory iniziale FTP errata - la directory non corrisponde alla radice web del tuo sito',
'ARCHIVE_DIRECTORY' => 'Directory degli archivi:',
'RELOAD_ARCHIVES' => 'Ricarica',
'CONFIG_UI_SFTPBROWSER_TITLE' => 'Browser di directory SFTP',
'ERR_COULD_NOT_OPEN_ARCHIVE_PART' => 'Impossibile aprire il file della parte dell\'archivio %s per la lettura. Verifica che il file esista, sia leggibile dal server web e non si trovi in una directory resa irraggiungibile da chroot, restrizioni open_basedir o qualsiasi altra restrizione impostata dal tuo host.',
'RENAME_FILES' => 'Rinomina i file di configurazione del server prima dell\'estrazione',
'BTN_SHOW_FINE_TUNE' => 'Mostra opzioni avanzate (per esperti)',
'RESTORE_PERMISSIONS' => 'Ripristina le autorizzazioni dei file',
'ZAPBEFORE' => 'Cancella tutto prima dell\'estrazione',
'ZAPBEFORE_HELP' => 'Tenta di eliminare tutti i file e le cartelle esistenti sotto la directory dove è memorizzato Kickstart prima di estrarre l\'archivio di backup. NON tiene conto di quali file e cartelle esistono nell\'archivio di backup. I file e le cartelle eliminati da questa funzionalità NON possono essere recuperati. ATTENZIONE! QUESTO POTREBBE ELIMINARE FILE E CARTELLE CHE NON APPARTENGONO AL TUO SITO. USARE CON ESTREMA CAUTELA. ATTIVANDO QUESTA FUNZIONALITÀ SI ASSUME OGNI RESPONSABILITÀ E OBBLIGAZIONE.',
);
/**
* Translation strings for pt-PT
*
* @var array
*/
private $translation_pt_pt = array (
'AUTOMODEON' => 'Modo automático ativado',
'ERR_NOT_A_JPA_FILE' => 'O ficheiro não é um arquivo JPA',
'ERR_CORRUPT_ARCHIVE' => 'O ficheiro de arquivo está corrompido, truncado ou estão faltando partes do arquivo',
'ERR_INVALID_ARCHIVE_LONG' => 'O ficheiro de arquivo parece estar corrompido, ou estão faltando partes do arquivo. Se as suas cópias de segurança consistem em múltiplos ficheiros, por favor certifique-se de que descarregou todos os ficheiros de partes do arquivo (ficheiros com o mesmo nome e extensões .%s, .%s01, .%2$s02…). Por favor certifique-se de descarregar e enviar ficheiros usando SFTP, ou FTP no modo de transferência Binária e verifique que o tamanho dos ficheiros corresponde aos tamanhos reportados na página Gerir Cópias de Segurança do Akeeba Backup / Akeeba Solo.',
'ERR_INVALID_LOGIN' => 'Login inválido',
'COULDNT_CREATE_DIR' => 'Não foi possível criar a pasta %s',
'COULDNT_WRITE_FILE' => 'Não foi possível abrir %s para escrita.',
'WRONG_FTP_HOST' => 'Nome ou porta do servidor FTP incorretos',
'WRONG_FTP_USER' => 'Nome de utilizador ou palavra-passe FTP incorretos',
'WRONG_FTP_PATH1' => 'Diretório inicial FTP incorreto — o diretório não existe',
'FTP_CANT_CREATE_DIR' => 'Não foi possível criar o diretório %s',
'FTP_TEMPDIR_NOT_WRITABLE' => 'Não foi possível encontrar ou criar um diretório temporário com permissão de escrita',
'SFTP_TEMPDIR_NOT_WRITABLE' => 'Não foi possível encontrar ou criar um diretório temporário com permissão de escrita',
'FTP_COULDNT_UPLOAD' => 'Não foi possível enviar %s',
'THINGS_HEADER' => 'Coisas que deve saber sobre o Akeeba Kickstart',
'THINGS_01' => 'O Kickstart não é um instalador. É uma ferramenta de extração de arquivos. O instalador propriamente dito foi colocado dentro do ficheiro de arquivo no momento da cópia de segurança.',
'THINGS_03' => 'O Kickstart está limitado pela configuração do seu servidor. Como tal, pode não funcionar de todo.',
'THINGS_04' => 'Deve descarregar e enviar os seus ficheiros de arquivo usando FTP no modo de transferência Binária. Qualquer outro método poderá levar a um arquivo de cópia de segurança corrompido e falha na restauração.',
'THINGS_05' => 'Erros ao carregar o site após a restauração são geralmente causados por diretivas do .htaccess ou php.ini. Deve entender que páginas em branco, erros 404 e 500 podem geralmente ser contornados editando os ficheiros acima mencionados. Não é a nossa função alterar os seus ficheiros de configuração, porque isso pode ser perigoso para o seu site.',
'THINGS_06' => 'O Kickstart substitui ficheiros sem aviso. Se não tiver a certeza de que está de acordo com isso, não continue.',
'THINGS_07' => 'Tentar restaurar para a URL temporária de um alojamento cPanel (por exemplo, http://1.2.3.4/~username) irá levar a uma falha na restauração e o seu site parecerá não estar a funcionar. Isto é normal e é assim que o seu servidor e o software CMS funcionam.',
'THINGS_08' => 'Deve ler a documentação antes de utilizar este software. A maioria dos problemas pode ser evitada, ou facilmente contornada, compreendendo como este software funciona.',
'THINGS_09' => 'Este texto não implica que exista um problema detetado. É um texto padrão exibido sempre que lança o Kickstart.',
'CLOSE_LIGHTBOX' => 'Clique aqui ou prima ESC para fechar esta mensagem',
'SELECT_ARCHIVE' => 'Selecionar um arquivo de cópia de segurança',
'ARCHIVE_FILE' => 'Ficheiro de arquivo:',
'SELECT_EXTRACTION' => 'Selecionar um método de extração',
'WRITE_TO_FILES' => 'Escrever em ficheiros:',
'WRITE_HYBRID' => 'Híbrido (usar FTP apenas se necessário)',
'WRITE_DIRECTLY' => 'Diretamente',
'WRITE_FTP' => 'Usar FTP para todos os ficheiros',
'WRITE_SFTP' => 'Usar SFTP para todos os ficheiros',
'FTP_HOST' => 'Nome do servidor (S)FTP:',
'FTP_PORT' => 'Porta (S)FTP:',
'FTP_FTPS' => 'Usar FTP sobre SSL (FTPS)',
'FTP_PASSIVE' => 'Usar Modo Passivo do FTP',
'FTP_USER' => 'Nome de utilizador (S)FTP:',
'FTP_PASS' => 'Palavra-passe (S)FTP:',
'FTP_DIR' => 'Diretório (S)FTP:',
'FTP_TEMPDIR' => 'Diretório temporário:',
'FTP_CONNECTION_OK' => 'Ligação FTP estabelecida',
'SFTP_CONNECTION_OK' => 'Ligação SFTP estabelecida',
'FTP_CONNECTION_FAILURE' => 'A ligação FTP falhou',
'SFTP_CONNECTION_FAILURE' => 'A ligação SFTP falhou',
'FTP_TEMPDIR_WRITABLE' => 'O diretório temporário tem permissão de escrita.',
'FTP_TEMPDIR_UNWRITABLE' => 'O diretório temporário não tem permissão de escrita. Por favor verifique as permissões.',
'FTP_BROWSE' => 'Navegar',
'FTPBROWSER_LBL_INSTRUCTIONS' => 'Clique num diretório para navegar nele. Clique em OK para selecionar esse diretório, Cancelar para abortar o procedimento.',
'FTPBROWSER_ERROR_HOSTNAME' => 'Nome ou porta do servidor FTP inválidos',
'FTPBROWSER_ERROR_USERPASS' => 'Nome de utilizador ou palavra-passe FTP inválidos',
'FTPBROWSER_ERROR_NOACCESS' => 'O diretório não existe ou não tem permissões suficientes para aceder a ele',
'FTPBROWSER_ERROR_UNSUPPORTED' => 'Lamentamos, mas o seu servidor FTP não suporta o nosso navegador de diretórios FTP.',
'FTPBROWSER_LBL_GOPARENT' => '<subir um nível>',
'FTPBROWSER_LBL_ERROR' => 'Ocorreu um erro',
'SFTP_NO_SSH2' => 'O seu servidor web não tem o módulo PHP SSH2, por conseguinte não consegue ligar a servidores SFTP.',
'SFTP_NO_FTP_SUPPORT' => 'O seu servidor SSH não permite ligações SFTP',
'SFTP_WRONG_USER' => 'Nome de utilizador ou palavra-passe SFTP incorretos',
'SFTP_WRONG_STARTING_DIR' => 'Deve fornecer um caminho absoluto válido',
'SFTPBROWSER_ERROR_NOACCESS' => 'O diretório não existe ou não tem permissões suficientes para aceder a ele',
'SFTP_COULDNT_UPLOAD' => 'Não foi possível enviar %s',
'SFTP_CANT_CREATE_DIR' => 'Não foi possível criar o diretório %s',
'UI-ROOT' => '<raiz>',
'CONFIG_UI_FTPBROWSER_TITLE' => 'Navegador de Diretórios FTP',
'BTN_CHECK' => 'Verificar',
'BTN_RESET' => 'Repor',
'BTN_TESTFTPCON' => 'Testar Ligação FTP',
'BTN_TESTSFTPCON' => 'Testar Ligação SFTP',
'BTN_GOTOSTART' => 'Recomeçar',
'BTN_RETRY' => 'Tentar novamente',
'FINE_TUNE' => 'Ajuste fino',
'MIN_EXEC_TIME' => 'Tempo mínimo de execução:',
'MAX_EXEC_TIME' => 'Tempo máximo de execução:',
'SECONDS_PER_STEP' => 'segundos por passo',
'EXTRACT_FILES' => 'Extrair ficheiros',
'BTN_START' => 'Iniciar',
'EXTRACTING' => 'A extrair',
'DO_NOT_CLOSE_EXTRACT' => 'Não feche esta janela enquanto a extração estiver em curso',
'RESTACLEANUP' => 'Restauração e Limpeza',
'BTN_RUNINSTALLER' => 'Executar o Instalador',
'BTN_CLEANUP' => 'Limpar',
'BTN_SITEFE' => 'Visitar a parte frontal do seu site',
'BTN_SITEBE' => 'Visitar a parte administrativa do seu site',
'WARNINGS' => 'Avisos de Extração',
'ERROR_OCCURED' => 'Ocorreu um erro',
'STEALTH_MODE' => 'Modo furtivo',
'STEALTH_URL' => 'Ficheiro HTML a mostrar aos visitantes do site',
'ERR_NOT_A_JPS_FILE' => 'O ficheiro não é um arquivo JPS',
'ERR_INVALID_JPS_PASSWORD' => 'A palavra-passe que forneceu está incorreta ou o arquivo está corrompido',
'JPS_PASSWORD' => 'Palavra-passe do Arquivo (para ficheiros JPS)',
'INVALID_FILE_HEADER_OFFSET_ZERO' => 'Não é possível abrir o ficheiro %s para leitura. Esta é a parte nº %d do seu arquivo de cópia de segurança que consiste em múltiplos ficheiros (ficheiros com o mesmo nome e extensões .%s, .%s01, .%4$s02…). Por favor certifique-se de que tem todos estes ficheiros na mesma pasta que o Kickstart.',
'INVALID_FILE_HEADER' => 'Cabeçalho inválido no ficheiro de arquivo, parte %s, deslocamento %s. Por favor certifique-se de descarregar e enviar ficheiros de arquivo de cópia de segurança usando SFTP, ou FTP no modo de transferência Binária e verifique que o tamanho dos ficheiros corresponde aos tamanhos reportados na página Gerir Cópias de Segurança do Akeeba Backup / Akeeba Solo.',
'INVALID_FILE_HEADER_MULTIPART' => 'Cabeçalho inválido no ficheiro de arquivo, parte %s, deslocamento %s. O seu arquivo de cópia de segurança consiste em múltiplos ficheiros (ficheiros com o mesmo nome e extensões .%s, .%s01, .%4$s02…). Ou alguns ficheiros estão em falta, ou estão corrompidos ou truncados. Vai precisar de todos estes ficheiros presentes no mesmo diretório. Por favor certifique-se de descarregar e enviar ficheiros de arquivo de cópia de segurança usando SFTP, ou FTP no modo de transferência Binária e verifique que o tamanho dos ficheiros corresponde aos tamanhos reportados na página Gerir Cópias de Segurança do Akeeba Backup / Akeeba Solo.',
'UPDATE_HEADER' => 'Uma versão atualizada do Akeeba Kickstart (unknown) está disponível!',
'UPDATE_NOTICE' => 'Recomenda-se que utilize sempre a versão mais recente do Akeeba Kickstart disponível. Versões mais antigas podem estar sujeitas a erros e não serão suportadas.',
'UPDATE_DLNOW' => 'Descarregar agora',
'UPDATE_MOREINFO' => 'Mais informações',
'NEEDSOMEHELPKS' => 'Precisa de ajuda para utilizar esta ferramenta? Leia isto primeiro:',
'QUICKSTART' => 'Guia de Início Rápido',
'CANTGETITTOWORK' => 'Não consegue fazer funcionar? Clique em mim!',
'NOARCHIVESCLICKHERE' => 'Nenhum arquivo detetado. Clique aqui para instruções de resolução de problemas.',
'POSTRESTORATIONTROUBLESHOOTING' => 'Algo não está a funcionar após a restauração? Clique aqui para instruções de resolução de problemas.',
'IGNORE_MOST_ERRORS' => 'Ignorar a maioria dos erros',
'TIME_SETTINGS_HELP' => 'Aumente o mínimo para 3 se obtiver erros AJAX. Aumente o máximo para 10 para uma extração mais rápida, diminua para 5 se obtiver erros AJAX. Tente mínimo 5, máximo 1 (não é um erro!) se continuar a obter erros AJAX.',
'STEALTH_MODE_HELP' => 'Quando ativado, apenas os visitantes do seu endereço IP poderão ver o site até a restauração ser concluída. Todos os outros serão redirecionados para a URL acima e apenas verão essa página. O seu servidor deve ver o IP real do visitante (isto é controlado pelo seu alojamento, não por si ou por nós).',
'RENAME_FILES_HELP' => 'Alterar a designação do .htaccess, web.config, php.ini e .user.ini contidos no arquivo durante a extração. Os ficheiros são renomeados com uma extensão .bak. As designações dos ficheiros são restauradas quando clica em Limpar.',
'RESTORE_PERMISSIONS_HELP' => 'Aplica as permissões dos ficheiros (mas NÃO a propriedade dos ficheiros) que foram guardadas no momento da cópia de segurança. Apenas funciona com arquivos JPA e JPS. Não funciona no Windows (o PHP não oferece tal funcionalidade).',
'EXTRACT_LIST' => 'Ficheiros a extrair',
'EXTRACT_LIST_HELP' => 'Introduza um caminho de ficheiro tal como images/cat.png ou um padrão de shell tal como images/*.png em cada linha. Apenas os ficheiros que correspondam a esta lista serão escritos no disco. Deixe vazio para extrair tudo (predefinição).',
'AKS3_IMPORT' => 'Importar do Amazon S3',
'AKS3_TITLE_STEP1' => 'Ligar ao Amazon S3',
'AKS3_ACCESS' => 'Chave de Acesso',
'AKS3_SECRET' => 'Chave Secreta',
'AKS3_CONNECT' => 'Ligar ao Amazon S3',
'AKS3_CANCEL' => 'Cancelar importação',
'AKS3_TITLE_STEP2' => 'Selecionar o seu contentor do Amazon S3',
'AKS3_BUCKET' => 'Contentor',
'AKS3_LISTCONTENTS' => 'Listar conteúdos',
'AKS3_TITLE_STEP3' => 'Selecionar arquivo para importar',
'AKS3_FOLDERS' => 'Pastas',
'AKS3_FILES' => 'Ficheiros de Arquivo',
'AKS3_TITLE_STEP4' => 'A importar…',
'AKS3_DO_NOT_CLOSE' => 'Por favor não feche esta janela enquanto os seus arquivos de cópia de segurança estão a ser importados',
'AKS3_TITLE_STEP5' => 'A importação está concluída',
'AKS3_BTN_RELOAD' => 'Recarregar o Kickstart',
'WRONG_FTP_PATH2' => 'Diretório inicial FTP incorreto — o diretório não corresponde à raiz web do seu site',
'ARCHIVE_DIRECTORY' => 'Diretório de arquivos:',
'RELOAD_ARCHIVES' => 'Recarregar',
'CONFIG_UI_SFTPBROWSER_TITLE' => 'Navegador de Diretórios SFTP',
'ERR_COULD_NOT_OPEN_ARCHIVE_PART' => 'Não foi possível abrir o ficheiro de parte do arquivo %s para leitura. Verifique que o ficheiro existe, é legível pelo servidor web e não se encontra num diretório inacessível devido a restrições de chroot, open_basedir ou qualquer outra restrição implementada pelo seu alojamento.',
'RENAME_FILES' => 'Renomear ficheiros de configuração do servidor antes da extração',
'BTN_SHOW_FINE_TUNE' => 'Mostrar opções avançadas (para especialistas)',
'RESTORE_PERMISSIONS' => 'Restaurar permissões dos ficheiros',
'ZAPBEFORE' => 'Eliminar tudo antes da extração',
'ZAPBEFORE_HELP' => 'Tenta eliminar todos os ficheiros e pastas existentes sob o diretório onde o Kickstart se encontra antes de extrair o arquivo de cópia de segurança. NÃO tem em conta quais ficheiros e pastas existem no arquivo de cópia de segurança. Ficheiros e pastas eliminados por esta funcionalidade NÃO podem ser recuperados. AVISO! ISTO PODE ELIMINAR FICHEIROS E PASTAS QUE NÃO PERTENCEM AO SEU SITE. UTILIZAR COM EXTREMA CAUTELA. AO ATIVAR ESTA FUNCIONALIDADE ASSUME TODA A RESPONSABILIDADE.',
);
/** END OF ARRAY — DO NOT EDIT OR REMOVE **/
private $strings;
/**
* The currently detected language (ISO code)
*
* @var string
*/
private $language;
/*
* Initializes the translation engine
*
* Loading order:
* 1. Built-in en-GB default strings
* 2. Built-in translation matching the browser's preferred language (if any)
* 3. External INI translation files via loadTranslationFile()
*
* @return AKText
*/
public function __construct()
{
// Step 1: Start with the default en-GB translation
$this->strings = $this->default_translation;
// Step 2: Try loading the en-GB INI file, if it exists
$this->loadTranslationFile('en-GB');
// Step 3: Get browser language preferences and match against built-in translations
$browserLanguages = $this->getBrowserLanguage();
foreach ($browserLanguages as $langStruct)
{
$fullLang = $langStruct[0];
$baseLang = $langStruct[1];
if (empty($fullLang))
{
continue;
}
$varName = 'translation_' . strtolower(str_replace('-', '_', $fullLang));
// Try exact match first (e.g. fr-FR)
if (isset($this->$varName))
{
$this->strings = array_merge($this->strings, $this->$varName);
$this->language = $fullLang;
break;
}
// Try base language match (e.g. fr from fr-CH)
$baseVarName = 'translation_' . strtolower($baseLang);
if (isset($this->$baseVarName))
{
$this->strings = array_merge($this->strings, $this->$baseVarName);
$this->language = $baseLang;
break;
}
// Try base language prefix scan (e.g. bare 'el' matches translation_el_gr)
$prefix = 'translation_' . strtolower($baseLang) . '_';
$found = null;
foreach (get_object_vars($this) as $propName => $propValue)
{
if (strpos($propName, $prefix) === 0 && is_array($propValue))
{
$found = [$propName, $propValue];
break;
}
}
if ($found !== null)
{
[$propName, $propValue] = $found;
$this->strings = array_merge($this->strings, $propValue);
$localeSuffix = substr($propName, strlen('translation_'));
$underscorePos = strpos($localeSuffix, '_');
$this->language = substr($localeSuffix, 0, $underscorePos) . '-' . strtoupper(substr($localeSuffix, $underscorePos + 1));
break;
}
}
// Step 4: Load external INI translation files
$this->loadTranslationFile();
}
/**
* A PHP based INI file parser.
*
* Thanks to asohn ~at~ aircanopy ~dot~ net for posting this handy function on
* the parse_ini_file page on http://gr.php.net/parse_ini_file
*
* @param string $file Filename to process
* @param bool $process_sections True to also process INI sections
* @param bool $rawdata If true, the $file contains raw INI data, not a filename
*
* @return array An associative array of sections, keys and values
* @access private
*/
public static function parse_ini_file($file, $process_sections = false, $rawdata = false)
{
$process_sections = ($process_sections !== true) ? false : true;
if (!$rawdata)
{
$ini = file($file);
}
else
{
$file = str_replace("\r", "", $file);
$ini = explode("\n", $file);
}
if (!is_array($ini))
{
return [];
}
if (count($ini) == 0)
{
return [];
}
$sections = [];
$values = [];
$result = [];
$globals = [];
$i = 0;
foreach ($ini as $line)
{
$line = trim($line);
$line = str_replace("\t", " ", $line);
// Comments
if (!preg_match('/^[a-zA-Z0-9[]/', $line))
{
continue;
}
// Sections
if ($line[0] == '[')
{
$tmp = explode(']', $line);
$sections[] = trim(substr($tmp[0], 1));
$i++;
continue;
}
// Key-value pair
$lineParts = explode('=', $line, 2);
if (count($lineParts) != 2)
{
continue;
}
$key = trim($lineParts[0]);
$value = trim($lineParts[1]);
unset($lineParts);
if (strstr($value, ";"))
{
$tmp = explode(';', $value);
if (count($tmp) == 2)
{
if ((($value[0] != '"') && ($value[0] != "'")) ||
preg_match('/^".*"\s*;/', $value) || preg_match('/^".*;[^"]*$/', $value) ||
preg_match("/^'.*'\s*;/", $value) || preg_match("/^'.*;[^']*$/", $value)
)
{
$value = $tmp[0];
}
}
else
{
if ($value[0] == '"')
{
$value = preg_replace('/^"(.*)".*/', '$1', $value);
}
elseif ($value[0] == "'")
{
$value = preg_replace("/^'(.*)'.*/", '$1', $value);
}
else
{
$value = $tmp[0];
}
}
}
$value = trim($value);
$value = trim($value, "'\"");
if ($i == 0)
{
if (substr($line, -1, 2) == '[]')
{
$globals[$key][] = $value;
}
else
{
$globals[$key] = $value;
}
}
else
{
if (substr($line, -1, 2) == '[]')
{
$values[$i - 1][$key][] = $value;
}
else
{
$values[$i - 1][$key] = $value;
}
}
}
for ($j = 0; $j < $i; $j++)
{
if ($process_sections === true)
{
if (isset($sections[$j]) && isset($values[$j]))
{
$result[$sections[$j]] = $values[$j];
}
}
else
{
if (isset($values[$j]))
{
$result[] = $values[$j];
}
}
}
return $result + $globals;
}
public static function sprintf($key)
{
$text = self::getInstance();
$args = func_get_args();
if (count($args) > 0)
{
$args[0] = $text->_($args[0]);
return @call_user_func_array('sprintf', $args);
}
return '';
}
/**
* Singleton pattern for Language
*
* @return AKText The global AKText instance
*/
public static function &getInstance()
{
static $instance;
if (!is_object($instance))
{
$instance = new AKText();
}
return $instance;
}
public static function _($string)
{
$text = self::getInstance();
$key = strtoupper($string);
$key = substr($key, 0, 1) == '_' ? substr($key, 1) : $key;
if (isset ($text->strings[$key]))
{
$string = $text->strings[$key];
}
else
{
if (defined($string))
{
$string = constant($string);
}
}
return $string;
}
/**
* Returns an array of the browser's preferred languages.
*
* Each entry is an array with two elements:
* [0] Full language tag (e.g. "fr-fr", "de-de")
* [1] Base language code (e.g. "fr", "de")
*
* Detection code derived from Full Operating System Language Detection by Harald Hope
* Retrieved from http://techpatterns.com/downloads/php_language_detection.php
*
* @return array List of language preference structs
*/
public function getBrowserLanguage()
{
$user_languages = [];
if (isset($_SERVER["HTTP_ACCEPT_LANGUAGE"]))
{
$languages = strtolower($_SERVER["HTTP_ACCEPT_LANGUAGE"]);
$languages = str_replace(' ', '', $languages);
$languages = explode(",", $languages);
foreach ($languages as $language_list)
{
$temp_array = [];
$temp_array[0] = substr($language_list, 0, strcspn($language_list, ';'));
$temp_array[1] = substr($language_list, 0, 2);
if ((strlen($temp_array[0]) == 5) && ((substr($temp_array[0], 2, 1) == '-') || (substr($temp_array[0], 2, 1) == '_')))
{
$langLocation = strtoupper(substr($temp_array[0], 3, 2));
$temp_array[0] = $temp_array[1] . '-' . $langLocation;
}
$user_languages[] = $temp_array;
}
}
if (empty($user_languages))
{
$user_languages[0] = ['', ''];
}
return $user_languages;
}
/**
* Loads an external INI translation file for the given language.
*
* If $lang is null, loads the INI file for the currently detected language ($this->language).
* The INI file is searched for in KSLANGDIR (if defined) or KSROOTDIR.
*
* @param string $lang Language tag (e.g. "en-GB", "fr-FR"). Null to use $this->language.
*
* @return void
*/
public function loadTranslationFile($lang = null)
{
if (defined('KSLANGDIR'))
{
$dirname = KSLANGDIR;
}
else
{
$dirname = KSROOTDIR;
}
$myName = defined('KSSELFNAME') ? KSSELFNAME : basename(__FILE__);
$basename = basename($myName, '.php') . '.ini';
if (empty($lang))
{
$lang = $this->language;
}
if (empty($lang))
{
return;
}
$translationFilename = $dirname . DIRECTORY_SEPARATOR . $lang . '.' . $basename;
if (!@file_exists($translationFilename) && ($basename != 'kickstart.ini'))
{
$basename = 'kickstart.ini';
$translationFilename = $dirname . DIRECTORY_SEPARATOR . $lang . '.' . $basename;
}
if (!@file_exists($translationFilename))
{
return;
}
$temp = self::parse_ini_file($translationFilename, false);
if (!is_array($this->strings))
{
$this->strings = [];
}
if (empty($temp))
{
$this->strings = array_merge($this->default_translation, $this->strings);
}
else
{
$this->strings = array_merge($this->strings, $temp);
}
}
/**
* @deprecated Use loadTranslationFile() instead. Kept for backward compatibility.
*
* @param string $lang Language tag. Null to use $this->language.
*
* @return void
*/
private function loadTranslation($lang = null)
{
$this->loadTranslationFile($lang);
}
public function dumpLanguage()
{
$out = '';
foreach ($this->strings as $key => $value)
{
$out .= "$key=$value\n";
}
return $out;
}
public function asJavascript()
{
$out = '';
foreach ($this->strings as $key => $value)
{
$key = addcslashes($key, '\\\'"');
$value = addcslashes($value, '\\\'"');
if (!empty($out))
{
$out .= ",\n";
}
$out .= "'$key':\t'$value'";
}
return $out;
}
public function resetTranslation()
{
$this->strings = $this->default_translation;
}
public function addDefaultLanguageStrings($stringList = [])
{
if (!is_array($stringList))
{
return;
}
if (empty($stringList))
{
return;
}
$this->strings = array_merge($stringList, $this->strings);
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* The Akeeba Kickstart Factory class
*
* This class is reponssible for instantiating all Akeeba Kickstart classes
*/
class AKFactory
{
/** @var array A list of instantiated objects */
private $objectlist = [];
/** @var array Simple hash data storage */
private $varlist = [];
/** @var self Static instance */
private static $instance = null;
/**
* AKFactory constructor.
*
* This is a private constructor makes sure we can't instantiate the class unless we go through the static
* getInstance singleton method. This is different than making the class abstract (preventing any kind of object
* instantiation).
*/
private function __construct()
{
}
/**
* Gets a serialized snapshot of the Factory for safekeeping (hibernate)
*
* @return string The serialized snapshot of the Factory
*/
public static function serialize()
{
$engine = self::getUnarchiver();
$engine->shutdown();
$serialized = serialize(self::getInstance());
if (function_exists('base64_encode') && function_exists('base64_decode'))
{
$serialized = base64_encode($serialized);
}
return $serialized;
}
/**
* Gets the unarchiver engine
*
* @return AKAbstractUnarchiver
*/
public static function &getUnarchiver($configOverride = null)
{
static $class_name;
if (!empty($configOverride) && isset($configOverride['reset']) && $configOverride['reset'])
{
$class_name = null;
}
if (empty($class_name))
{
$filetype = self::get('kickstart.setup.filetype', null);
if (empty($filetype))
{
$filename = self::get('kickstart.setup.sourcefile', null);
$basename = basename($filename);
$baseextension = strtoupper(substr($basename, -3));
switch ($baseextension)
{
case 'JPA':
$filetype = 'JPA';
break;
case 'JPS':
$filetype = 'JPS';
break;
case 'ZIP':
$filetype = 'ZIP';
break;
default:
die('Invalid archive type or extension in file ' . $filename);
break;
}
}
$class_name = 'AKUnarchiver' . ucfirst($filetype);
}
$destdir = self::get('kickstart.setup.destdir', null);
if (empty($destdir))
{
$destdir = KSROOTDIR;
}
/** @var AKAbstractUnarchiver $object */
$object = self::getClassInstance($class_name);
if ($object->getState() == 'init')
{
$sourcePath = self::get('kickstart.setup.sourcepath', '');
$sourceFile = self::get('kickstart.setup.sourcefile', '');
if (!empty($sourcePath))
{
$sourceFile = rtrim($sourcePath, '/\\') . '/' . $sourceFile;
}
// Initialize the object –– Any change here MUST be reflected to echoHeadJavascript (default values)
$config = [
'filename' => $sourceFile,
'restore_permissions' => self::get('kickstart.setup.restoreperms', 0),
'post_proc' => self::get('kickstart.procengine', 'direct'),
'add_path' => self::get('kickstart.setup.targetpath', $destdir),
'remove_path' => self::get('kickstart.setup.removepath', ''),
'rename_files' => self::get('kickstart.setup.renamefiles', [
'.htaccess' => 'htaccess.bak', 'php.ini' => 'php.ini.bak', 'web.config' => 'web.config.bak',
'.user.ini' => '.user.ini.bak',
]),
'skip_files' => self::get('kickstart.setup.skipfiles', [
basename(__FILE__), 'kickstart.php', 'htaccess.bak', 'php.ini.bak',
]),
'ignoredirectories' => self::get('kickstart.setup.ignoredirectories', [
'tmp', 'log', 'logs',
]),
];
if (!defined('KICKSTART'))
{
// In restore.php mode we have to exclude the restoration.php files
$moreSkippedFiles = [
// Akeeba Backup for Joomla!
'administrator/components/com_akeeba/restoration.php',
'administrator/components/com_akeebabackup/restoration.php',
// Joomla! Update
'administrator/components/com_joomlaupdate/restoration.php',
// Akeeba Backup for WordPress
'wp-content/plugins/akeebabackupwp/app/restoration.php',
'wp-content/plugins/akeebabackupcorewp/app/restoration.php',
'wp-content/plugins/akeebabackup/app/restoration.php',
'wp-content/plugins/akeebabackupwpcore/app/restoration.php',
// Akeeba Solo
'app/restoration.php',
];
$config['skip_files'] = array_merge($config['skip_files'], $moreSkippedFiles);
}
if (!empty($configOverride))
{
$config = array_merge($config, $configOverride);
}
$object->setup($config);
}
return $object;
}
// ========================================================================
// Public factory interface
// ========================================================================
public static function get($key, $default = null)
{
$self = self::getInstance();
if (array_key_exists($key, $self->varlist))
{
return $self->varlist[$key];
}
return $default;
}
/**
* Gets a single, internally used instance of the Factory
*
* @param string $serialized_data [optional] Serialized data to spawn the instance from
*
* @return AKFactory A reference to the unique Factory object instance
*/
protected static function &getInstance($serialized_data = null)
{
if (!is_object(self::$instance) || !is_null($serialized_data))
{
if (!is_null($serialized_data))
{
self::$instance = unserialize($serialized_data);
return self::$instance;
}
self::$instance = new self();
}
return self::$instance;
}
/**
* Internal function which instantiates a class named $class_name.
* The autoloader
*
* @param string $class_name
*
* @return object
*/
protected static function &getClassInstance($class_name)
{
$self = self::getInstance();
if (!isset($self->objectlist[$class_name]))
{
$self->objectlist[$class_name] = new $class_name;
}
return $self->objectlist[$class_name];
}
// ========================================================================
// Public hash data storage interface
// ========================================================================
/**
* Regenerates the full Factory state from a serialized snapshot (resume)
*
* @param string $serialized_data The serialized snapshot to resume from
*/
public static function unserialize($serialized_data)
{
if (function_exists('base64_encode') && function_exists('base64_decode'))
{
$serialized_data = base64_decode($serialized_data);
}
self::getInstance($serialized_data);
}
/**
* Reset the internal factory state, freeing all previously created objects
*/
public static function nuke()
{
self::$instance = null;
}
// ========================================================================
// Akeeba Kickstart classes
// ========================================================================
public static function set($key, $value)
{
$self = self::getInstance();
$self->varlist[$key] = $value;
}
/**
* Gets the post processing engine
*
* @param string $proc_engine
*
* @return AKAbstractPostproc
*/
public static function &getPostProc($proc_engine = null)
{
static $class_name;
if (empty($class_name))
{
if (empty($proc_engine))
{
$proc_engine = self::get('kickstart.procengine', 'direct');
}
$class_name = 'AKPostproc' . ucfirst($proc_engine);
}
return self::getClassInstance($class_name);
}
/**
* Get the a reference to the Akeeba Engine's timer
*
* @return AKCoreTimer
*/
public static function &getTimer()
{
return self::getClassInstance('AKCoreTimer');
}
/**
* Get an instance of the filesystem zapper
*
* @return AKUtilsZapper
*/
public static function &getZapper()
{
return self::getClassInstance('AKUtilsZapper');
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* Interface for AES encryption adapters
*/
interface AKEncryptionAESAdapterInterface
{
/**
* Decrypts a string. Returns the raw binary ciphertext, zero-padded.
*
* @param string $plainText The plaintext to encrypt
* @param string $key The raw binary key (will be zero-padded or chopped if its size is different than the block size)
*
* @return string The raw encrypted binary string.
*/
public function decrypt($plainText, $key);
/**
* Returns the encryption block size in bytes
*
* @return int
*/
public function getBlockSize();
/**
* Is this adapter supported?
*
* @return bool
*/
public function isSupported();
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* Abstract AES encryption class
*/
abstract class AKEncryptionAESAdapterAbstract
{
/**
* Trims or zero-pads a key / IV
*
* @param string $key The key or IV to treat
* @param int $size The block size of the currently used algorithm
*
* @return null|string Null if $key is null, treated string of $size byte length otherwise
*/
public function resizeKey($key, $size)
{
if (empty($key))
{
return null;
}
$keyLength = strlen($key);
if (function_exists('mb_strlen'))
{
$keyLength = mb_strlen($key, 'ASCII');
}
if ($keyLength == $size)
{
return $key;
}
if ($keyLength > $size)
{
if (function_exists('mb_substr'))
{
return mb_substr($key, 0, $size, 'ASCII');
}
return substr($key, 0, $size);
}
return $key . str_repeat("\0", ($size - $keyLength));
}
/**
* Returns null bytes to append to the string so that it's zero padded to the specified block size
*
* @param string $string The binary string which will be zero padded
* @param int $blockSize The block size
*
* @return string The zero bytes to append to the string to zero pad it to $blockSize
*/
protected function getZeroPadding($string, $blockSize)
{
$stringSize = strlen($string);
if (function_exists('mb_strlen'))
{
$stringSize = mb_strlen($string, 'ASCII');
}
if ($stringSize == $blockSize)
{
return '';
}
if ($stringSize < $blockSize)
{
return str_repeat("\0", $blockSize - $stringSize);
}
$paddingBytes = $stringSize % $blockSize;
return str_repeat("\0", $blockSize - $paddingBytes);
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
class Mcrypt extends AKEncryptionAESAdapterAbstract implements AKEncryptionAESAdapterInterface
{
protected $cipherType = MCRYPT_RIJNDAEL_128;
protected $cipherMode = MCRYPT_MODE_CBC;
public function decrypt($cipherText, $key)
{
$iv_size = $this->getBlockSize();
$key = $this->resizeKey($key, $iv_size);
$iv = substr($cipherText, 0, $iv_size);
$cipherText = substr($cipherText, $iv_size);
$plainText = mcrypt_decrypt($this->cipherType, $key, $cipherText, $this->cipherMode, $iv);
return $plainText;
}
public function isSupported()
{
if (!function_exists('mcrypt_get_key_size'))
{
return false;
}
if (!function_exists('mcrypt_get_iv_size'))
{
return false;
}
if (!function_exists('mcrypt_create_iv'))
{
return false;
}
if (!function_exists('mcrypt_encrypt'))
{
return false;
}
if (!function_exists('mcrypt_decrypt'))
{
return false;
}
if (!function_exists('mcrypt_list_algorithms'))
{
return false;
}
if (!function_exists('hash'))
{
return false;
}
if (!function_exists('hash_algos'))
{
return false;
}
$algorightms = mcrypt_list_algorithms();
if (!in_array('rijndael-128', $algorightms))
{
return false;
}
if (!in_array('rijndael-192', $algorightms))
{
return false;
}
if (!in_array('rijndael-256', $algorightms))
{
return false;
}
$algorightms = hash_algos();
if (!in_array('sha256', $algorightms))
{
return false;
}
return true;
}
public function getBlockSize()
{
return mcrypt_get_iv_size($this->cipherType, $this->cipherMode);
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
class OpenSSL extends AKEncryptionAESAdapterAbstract implements AKEncryptionAESAdapterInterface
{
/**
* The OpenSSL options for encryption / decryption
*
* @var int
*/
protected $openSSLOptions = 0;
/**
* The encryption method to use
*
* @var string
*/
protected $method = 'aes-128-cbc';
public function __construct()
{
$this->openSSLOptions = OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING;
}
public function decrypt($cipherText, $key)
{
$iv_size = $this->getBlockSize();
$key = $this->resizeKey($key, $iv_size);
$iv = substr($cipherText, 0, $iv_size);
$cipherText = substr($cipherText, $iv_size);
$plainText = openssl_decrypt($cipherText, $this->method, $key, $this->openSSLOptions, $iv);
return $plainText;
}
public function isSupported()
{
if (!function_exists('openssl_get_cipher_methods'))
{
return false;
}
if (!function_exists('openssl_random_pseudo_bytes'))
{
return false;
}
if (!function_exists('openssl_cipher_iv_length'))
{
return false;
}
if (!function_exists('openssl_encrypt'))
{
return false;
}
if (!function_exists('openssl_decrypt'))
{
return false;
}
if (!function_exists('hash'))
{
return false;
}
if (!function_exists('hash_algos'))
{
return false;
}
$algorightms = openssl_get_cipher_methods();
if (!in_array('aes-128-cbc', $algorightms))
{
return false;
}
$algorightms = hash_algos();
if (!in_array('sha256', $algorightms))
{
return false;
}
return true;
}
/**
* @return int
*/
public function getBlockSize()
{
return openssl_cipher_iv_length($this->method);
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* AES implementation in PHP (c) Chris Veness 2005-2016.
* Right to use and adapt is granted for under a simple creative commons attribution
* licence. No warranty of any form is offered.
*
* Heavily modified for Akeeba Backup by Nicholas K. Dionysopoulos
* Also added AES-128 CBC mode (with mcrypt and OpenSSL) on top of AES CTR
* Removed CTR encrypt / decrypt (no longer used)
*/
class AKEncryptionAES
{
// Sbox is pre-computed multiplicative inverse in GF(2^8) used in SubBytes and KeyExpansion [�5.1.1]
protected static $Sbox =
[0x63, 0x7c, 0x77, 0x7b, 0xf2, 0x6b, 0x6f, 0xc5, 0x30, 0x01, 0x67, 0x2b, 0xfe, 0xd7, 0xab, 0x76,
0xca, 0x82, 0xc9, 0x7d, 0xfa, 0x59, 0x47, 0xf0, 0xad, 0xd4, 0xa2, 0xaf, 0x9c, 0xa4, 0x72, 0xc0,
0xb7, 0xfd, 0x93, 0x26, 0x36, 0x3f, 0xf7, 0xcc, 0x34, 0xa5, 0xe5, 0xf1, 0x71, 0xd8, 0x31, 0x15,
0x04, 0xc7, 0x23, 0xc3, 0x18, 0x96, 0x05, 0x9a, 0x07, 0x12, 0x80, 0xe2, 0xeb, 0x27, 0xb2, 0x75,
0x09, 0x83, 0x2c, 0x1a, 0x1b, 0x6e, 0x5a, 0xa0, 0x52, 0x3b, 0xd6, 0xb3, 0x29, 0xe3, 0x2f, 0x84,
0x53, 0xd1, 0x00, 0xed, 0x20, 0xfc, 0xb1, 0x5b, 0x6a, 0xcb, 0xbe, 0x39, 0x4a, 0x4c, 0x58, 0xcf,
0xd0, 0xef, 0xaa, 0xfb, 0x43, 0x4d, 0x33, 0x85, 0x45, 0xf9, 0x02, 0x7f, 0x50, 0x3c, 0x9f, 0xa8,
0x51, 0xa3, 0x40, 0x8f, 0x92, 0x9d, 0x38, 0xf5, 0xbc, 0xb6, 0xda, 0x21, 0x10, 0xff, 0xf3, 0xd2,
0xcd, 0x0c, 0x13, 0xec, 0x5f, 0x97, 0x44, 0x17, 0xc4, 0xa7, 0x7e, 0x3d, 0x64, 0x5d, 0x19, 0x73,
0x60, 0x81, 0x4f, 0xdc, 0x22, 0x2a, 0x90, 0x88, 0x46, 0xee, 0xb8, 0x14, 0xde, 0x5e, 0x0b, 0xdb,
0xe0, 0x32, 0x3a, 0x0a, 0x49, 0x06, 0x24, 0x5c, 0xc2, 0xd3, 0xac, 0x62, 0x91, 0x95, 0xe4, 0x79,
0xe7, 0xc8, 0x37, 0x6d, 0x8d, 0xd5, 0x4e, 0xa9, 0x6c, 0x56, 0xf4, 0xea, 0x65, 0x7a, 0xae, 0x08,
0xba, 0x78, 0x25, 0x2e, 0x1c, 0xa6, 0xb4, 0xc6, 0xe8, 0xdd, 0x74, 0x1f, 0x4b, 0xbd, 0x8b, 0x8a,
0x70, 0x3e, 0xb5, 0x66, 0x48, 0x03, 0xf6, 0x0e, 0x61, 0x35, 0x57, 0xb9, 0x86, 0xc1, 0x1d, 0x9e,
0xe1, 0xf8, 0x98, 0x11, 0x69, 0xd9, 0x8e, 0x94, 0x9b, 0x1e, 0x87, 0xe9, 0xce, 0x55, 0x28, 0xdf,
0x8c, 0xa1, 0x89, 0x0d, 0xbf, 0xe6, 0x42, 0x68, 0x41, 0x99, 0x2d, 0x0f, 0xb0, 0x54, 0xbb, 0x16];
// Rcon is Round Constant used for the Key Expansion [1st col is 2^(r-1) in GF(2^8)] [�5.2]
protected static $Rcon = [
[0x00, 0x00, 0x00, 0x00],
[0x01, 0x00, 0x00, 0x00],
[0x02, 0x00, 0x00, 0x00],
[0x04, 0x00, 0x00, 0x00],
[0x08, 0x00, 0x00, 0x00],
[0x10, 0x00, 0x00, 0x00],
[0x20, 0x00, 0x00, 0x00],
[0x40, 0x00, 0x00, 0x00],
[0x80, 0x00, 0x00, 0x00],
[0x1b, 0x00, 0x00, 0x00],
[0x36, 0x00, 0x00, 0x00]];
protected static $passwords = [];
/**
* The algorithm to use for PBKDF2. Must be a supported hash_hmac algorithm. Default: sha1
*
* @var string
*/
private static $pbkdf2Algorithm = 'sha1';
/**
* Number of iterations to use for PBKDF2
*
* @var int
*/
private static $pbkdf2Iterations = 1000;
/**
* Should we use a static salt for PBKDF2?
*
* @var int
*/
private static $pbkdf2UseStaticSalt = 0;
/**
* The static salt to use for PBKDF2
*
* @var string
*/
private static $pbkdf2StaticSalt = "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
/**
* AES Cipher function: encrypt 'input' with Rijndael algorithm
*
* @param array $input Message as byte-array (16 bytes)
* @param array $w key schedule as 2D byte-array (Nr+1 x Nb bytes) -
* generated from the cipher key by KeyExpansion()
*
* @return string Ciphertext as byte-array (16 bytes)
*/
protected static function Cipher($input, $w)
{
// main Cipher function [�5.1]
$Nb = 4; // block size (in words): no of columns in state (fixed at 4 for AES)
$Nr = count($w) / $Nb - 1; // no of rounds: 10/12/14 for 128/192/256-bit keys
$state = []; // initialise 4xNb byte-array 'state' with input [�3.4]
for ($i = 0; $i < 4 * $Nb; $i++)
{
$state[$i % 4][floor($i / 4)] = $input[$i];
}
$state = self::AddRoundKey($state, $w, 0, $Nb);
for ($round = 1; $round < $Nr; $round++)
{ // apply Nr rounds
$state = self::SubBytes($state, $Nb);
$state = self::ShiftRows($state, $Nb);
$state = self::MixColumns($state);
$state = self::AddRoundKey($state, $w, $round, $Nb);
}
$state = self::SubBytes($state, $Nb);
$state = self::ShiftRows($state, $Nb);
$state = self::AddRoundKey($state, $w, $Nr, $Nb);
$output = [4 * $Nb]; // convert state to 1-d array before returning [�3.4]
for ($i = 0; $i < 4 * $Nb; $i++)
{
$output[$i] = $state[$i % 4][floor($i / 4)];
}
return $output;
}
protected static function AddRoundKey($state, $w, $rnd, $Nb)
{
// xor Round Key into state S [�5.1.4]
for ($r = 0; $r < 4; $r++)
{
for ($c = 0; $c < $Nb; $c++)
{
$state[$r][$c] ^= $w[$rnd * 4 + $c][$r];
}
}
return $state;
}
protected static function SubBytes($s, $Nb)
{
// apply SBox to state S [�5.1.1]
for ($r = 0; $r < 4; $r++)
{
for ($c = 0; $c < $Nb; $c++)
{
$s[$r][$c] = self::$Sbox[$s[$r][$c]];
}
}
return $s;
}
protected static function ShiftRows($s, $Nb)
{
// shift row r of state S left by r bytes [�5.1.2]
$t = [4];
for ($r = 1; $r < 4; $r++)
{
for ($c = 0; $c < 4; $c++)
{
$t[$c] = $s[$r][($c + $r) % $Nb];
} // shift into temp copy
for ($c = 0; $c < 4; $c++)
{
$s[$r][$c] = $t[$c];
} // and copy back
} // note that this will work for Nb=4,5,6, but not 7,8 (always 4 for AES):
return $s; // see fp.gladman.plus.com/cryptography_technology/rijndael/aes.spec.311.pdf
}
protected static function MixColumns($s)
{
// combine bytes of each col of state S [�5.1.3]
for ($c = 0; $c < 4; $c++)
{
$a = [4]; // 'a' is a copy of the current column from 's'
$b = [4]; // 'b' is a�{02} in GF(2^8)
for ($i = 0; $i < 4; $i++)
{
$a[$i] = $s[$i][$c];
$b[$i] = $s[$i][$c] & 0x80 ? $s[$i][$c] << 1 ^ 0x011b : $s[$i][$c] << 1;
}
// a[n] ^ b[n] is a�{03} in GF(2^8)
$s[0][$c] = $b[0] ^ $a[1] ^ $b[1] ^ $a[2] ^ $a[3]; // 2*a0 + 3*a1 + a2 + a3
$s[1][$c] = $a[0] ^ $b[1] ^ $a[2] ^ $b[2] ^ $a[3]; // a0 * 2*a1 + 3*a2 + a3
$s[2][$c] = $a[0] ^ $a[1] ^ $b[2] ^ $a[3] ^ $b[3]; // a0 + a1 + 2*a2 + 3*a3
$s[3][$c] = $a[0] ^ $b[0] ^ $a[1] ^ $a[2] ^ $b[3]; // 3*a0 + a1 + a2 + 2*a3
}
return $s;
}
/**
* Key expansion for Rijndael Cipher(): performs key expansion on cipher key
* to generate a key schedule
*
* @param array $key Cipher key byte-array (16 bytes)
*
* @return array Key schedule as 2D byte-array (Nr+1 x Nb bytes)
*/
protected static function KeyExpansion($key)
{
// generate Key Schedule from Cipher Key [�5.2]
// block size (in words): no of columns in state (fixed at 4 for AES)
$Nb = 4;
// key length (in words): 4/6/8 for 128/192/256-bit keys
$Nk = (int) (count($key) / 4);
// no of rounds: 10/12/14 for 128/192/256-bit keys
$Nr = $Nk + 6;
$w = [];
$temp = [];
for ($i = 0; $i < $Nk; $i++)
{
$r = [$key[4 * $i], $key[4 * $i + 1], $key[4 * $i + 2], $key[4 * $i + 3]];
$w[$i] = $r;
}
for ($i = $Nk; $i < ($Nb * ($Nr + 1)); $i++)
{
$w[$i] = [];
for ($t = 0; $t < 4; $t++)
{
$temp[$t] = $w[$i - 1][$t];
}
if ($i % $Nk == 0)
{
$temp = self::SubWord(self::RotWord($temp));
for ($t = 0; $t < 4; $t++)
{
$rConIndex = (int) ($i / $Nk);
$temp[$t] ^= self::$Rcon[$rConIndex][$t];
}
}
else if ($Nk > 6 && $i % $Nk == 4)
{
$temp = self::SubWord($temp);
}
for ($t = 0; $t < 4; $t++)
{
$w[$i][$t] = $w[$i - $Nk][$t] ^ $temp[$t];
}
}
return $w;
}
protected static function SubWord($w)
{
// apply SBox to 4-byte word w
for ($i = 0; $i < 4; $i++)
{
$w[$i] = self::$Sbox[$w[$i]];
}
return $w;
}
/*
* Unsigned right shift function, since PHP has neither >>> operator nor unsigned ints
*
* @param a number to be shifted (32-bit integer)
* @param b number of bits to shift a to the right (0..31)
* @return a right-shifted and zero-filled by b bits
*/
protected static function RotWord($w)
{
// rotate 4-byte word w left by one byte
$tmp = $w[0];
for ($i = 0; $i < 3; $i++)
{
$w[$i] = $w[$i + 1];
}
$w[3] = $tmp;
return $w;
}
protected static function urs($a, $b)
{
$a &= 0xffffffff;
$b &= 0x1f; // (bounds check)
if ($a & 0x80000000 && $b > 0)
{ // if left-most bit set
$a = ($a >> 1) & 0x7fffffff; // right-shift one bit & clear left-most bit
$a = $a >> ($b - 1); // remaining right-shifts
}
else
{ // otherwise
$a = ($a >> $b); // use normal right-shift
}
return $a;
}
/**
* AES decryption in CBC mode. This is the standard mode (the CTR methods
* actually use Rijndael-128 in CTR mode, which - technically - isn't AES).
*
* It supports AES-128 only. It assumes that the last 4 bytes
* contain a little-endian unsigned long integer representing the unpadded
* data length.
*
* @since 3.0.1
* @author Nicholas K. Dionysopoulos
*
* @param string $ciphertext The data to encrypt
* @param string $password Encryption password
*
* @return string The plaintext
*/
public static function AESDecryptCBC($ciphertext, $password)
{
$adapter = self::getAdapter();
if (!$adapter->isSupported())
{
return false;
}
// Read the data size
$data_size = unpack('V', substr($ciphertext, -4));
// Do I have a PBKDF2 salt?
$salt = substr($ciphertext, -92, 68);
$rightStringLimit = -4;
$params = self::getKeyDerivationParameters();
$keySizeBytes = $params['keySize'];
$algorithm = $params['algorithm'];
$iterations = $params['iterations'];
$useStaticSalt = $params['useStaticSalt'];
if (substr($salt, 0, 4) == 'JPST')
{
// We have a stored salt. Retrieve it and tell decrypt to process the string minus the last 44 bytes
// (4 bytes for JPST, 16 bytes for the salt, 4 bytes for JPIV, 16 bytes for the IV, 4 bytes for the
// uncompressed string length - note that using PBKDF2 means we're also using a randomized IV per the
// format specification).
$salt = substr($salt, 4);
$rightStringLimit -= 68;
$key = self::pbkdf2($password, $salt, $algorithm, $iterations, $keySizeBytes);
}
elseif ($useStaticSalt)
{
// We have a static salt. Use it for PBKDF2.
$key = self::getStaticSaltExpandedKey($password);
}
else
{
// Get the expanded key from the password. THIS USES THE OLD, INSECURE METHOD.
$key = self::expandKey($password);
}
// Try to get the IV from the data
$iv = substr($ciphertext, -24, 20);
if (substr($iv, 0, 4) == 'JPIV')
{
// We have a stored IV. Retrieve it and tell mdecrypt to process the string minus the last 24 bytes
// (4 bytes for JPIV, 16 bytes for the IV, 4 bytes for the uncompressed string length)
$iv = substr($iv, 4);
$rightStringLimit -= 20;
}
else
{
// No stored IV. Do it the dumb way.
$iv = self::createTheWrongIV($password);
}
// Decrypt
$plaintext = $adapter->decrypt($iv . substr($ciphertext, 0, $rightStringLimit), $key);
// Trim padding, if necessary
if (strlen($plaintext) > $data_size)
{
$plaintext = substr($plaintext, 0, $data_size);
}
return $plaintext;
}
/**
* That's the old way of creating an IV that's definitely not cryptographically sound.
*
* DO NOT USE, EVER, UNLESS YOU WANT TO DECRYPT LEGACY DATA
*
* @param string $password The raw password from which we create an IV in a super bozo way
*
* @return string A 16-byte IV string
*/
public static function createTheWrongIV($password)
{
static $ivs = [];
$key = AKUtilsHash::md5($password);
if (!isset($ivs[$key]))
{
$nBytes = 16; // AES uses a 128 -bit (16 byte) block size, hence the IV size is always 16 bytes
$pwBytes = [];
for ($i = 0; $i < $nBytes; $i++)
{
$pwBytes[$i] = ord(substr($password, $i, 1)) & 0xff;
}
$iv = self::Cipher($pwBytes, self::KeyExpansion($pwBytes));
$newIV = '';
foreach ($iv as $int)
{
$newIV .= chr($int);
}
$ivs[$key] = $newIV;
}
return $ivs[$key];
}
/**
* Expand the password to an appropriate 128-bit encryption key
*
* @param string $password
*
* @return string
*
* @since 5.2.0
* @author Nicholas K. Dionysopoulos
*/
public static function expandKey($password)
{
// Try to fetch cached key or create it if it doesn't exist
$nBits = 128;
$lookupKey = AKUtilsHash::md5($password . '-' . $nBits);
if (array_key_exists($lookupKey, self::$passwords))
{
$key = self::$passwords[$lookupKey];
return $key;
}
// use AES itself to encrypt password to get cipher key (using plain password as source for
// key expansion) - gives us well encrypted key.
$nBytes = $nBits / 8; // Number of bytes in key
$pwBytes = [];
for ($i = 0; $i < $nBytes; $i++)
{
$pwBytes[$i] = ord(substr($password, $i, 1)) & 0xff;
}
$key = self::Cipher($pwBytes, self::KeyExpansion($pwBytes));
$key = array_merge($key, array_slice($key, 0, $nBytes - 16)); // expand key to 16/24/32 bytes long
$newKey = '';
foreach ($key as $int)
{
$newKey .= chr($int);
}
$key = $newKey;
self::$passwords[$lookupKey] = $key;
return $key;
}
/**
* Returns the correct AES-128 CBC encryption adapter
*
* @return AKEncryptionAESAdapterInterface
*
* @since 5.2.0
* @author Nicholas K. Dionysopoulos
*/
public static function getAdapter()
{
static $adapter = null;
if (is_object($adapter) && ($adapter instanceof AKEncryptionAESAdapterInterface))
{
return $adapter;
}
$adapter = new OpenSSL();
if (!$adapter->isSupported())
{
$adapter = new Mcrypt();
}
return $adapter;
}
/**
* @return string
*/
public static function getPbkdf2Algorithm()
{
return self::$pbkdf2Algorithm;
}
/**
* @param string $pbkdf2Algorithm
* @return void
*/
public static function setPbkdf2Algorithm($pbkdf2Algorithm)
{
self::$pbkdf2Algorithm = $pbkdf2Algorithm;
}
/**
* @return int
*/
public static function getPbkdf2Iterations()
{
return self::$pbkdf2Iterations;
}
/**
* @param int $pbkdf2Iterations
* @return void
*/
public static function setPbkdf2Iterations($pbkdf2Iterations)
{
self::$pbkdf2Iterations = $pbkdf2Iterations;
}
/**
* @return int
*/
public static function getPbkdf2UseStaticSalt()
{
return self::$pbkdf2UseStaticSalt;
}
/**
* @param int $pbkdf2UseStaticSalt
* @return void
*/
public static function setPbkdf2UseStaticSalt($pbkdf2UseStaticSalt)
{
self::$pbkdf2UseStaticSalt = $pbkdf2UseStaticSalt;
}
/**
* @return string
*/
public static function getPbkdf2StaticSalt()
{
return self::$pbkdf2StaticSalt;
}
/**
* @param string $pbkdf2StaticSalt
* @return void
*/
public static function setPbkdf2StaticSalt($pbkdf2StaticSalt)
{
self::$pbkdf2StaticSalt = $pbkdf2StaticSalt;
}
/**
* Get the parameters fed into PBKDF2 to expand the user password into an encryption key. These are the static
* parameters (key size, hashing algorithm and number of iterations). A new salt is used for each encryption block
* to minimize the risk of attacks against the password.
*
* @return array
*/
public static function getKeyDerivationParameters()
{
return [
'keySize' => 16,
'algorithm' => self::$pbkdf2Algorithm,
'iterations' => self::$pbkdf2Iterations,
'useStaticSalt' => self::$pbkdf2UseStaticSalt,
'staticSalt' => self::$pbkdf2StaticSalt,
];
}
/**
* PBKDF2 key derivation function as defined by RSA's PKCS #5: https://www.ietf.org/rfc/rfc2898.txt
*
* Test vectors can be found here: https://www.ietf.org/rfc/rfc6070.txt
*
* This implementation of PBKDF2 was originally created by https://defuse.ca
* With improvements by http://www.variations-of-shadow.com
* Modified for Akeeba Engine by Akeeba Ltd (removed unnecessary checks to make it faster)
*
* @param string $password The password.
* @param string $salt A salt that is unique to the password.
* @param string $algorithm The hash algorithm to use. Default is sha1.
* @param int $count Iteration count. Higher is better, but slower. Default: 1000.
* @param int $key_length The length of the derived key in bytes.
*
* @return string A string of $key_length bytes
*/
public static function pbkdf2($password, $salt, $algorithm = 'sha1', $count = 1000, $key_length = 16)
{
if (function_exists("hash_pbkdf2"))
{
return hash_pbkdf2($algorithm, $password, $salt, $count, $key_length, true);
}
$hash_length = akstringlen(hash($algorithm, "", true));
$block_count = ceil($key_length / $hash_length);
$output = "";
for ($i = 1; $i <= $block_count; $i++)
{
// $i encoded as 4 bytes, big endian.
$last = $salt . pack("N", $i);
// First iteration
$xorResult = hash_hmac($algorithm, $last, $password, true);
$last = $xorResult;
// Perform the other $count - 1 iterations
for ($j = 1; $j < $count; $j++)
{
$last = hash_hmac($algorithm, $last, $password, true);
$xorResult ^= $last;
}
$output .= $xorResult;
}
return aksubstr($output, 0, $key_length);
}
/**
* Get the expanded key from the user supplied password using a static salt. The results are cached for performance
* reasons.
*
* @param string $password The user-supplied password, UTF-8 encoded.
*
* @return string The expanded key
*/
private static function getStaticSaltExpandedKey($password)
{
$params = self::getKeyDerivationParameters();
$keySizeBytes = $params['keySize'];
$algorithm = $params['algorithm'];
$iterations = $params['iterations'];
$staticSalt = $params['staticSalt'];
$lookupKey = "PBKDF2-$algorithm-$iterations-" . AKUtilsHash::md5($password . $staticSalt);
if (!array_key_exists($lookupKey, self::$passwords))
{
self::$passwords[$lookupKey] = self::pbkdf2($password, $staticSalt, $algorithm, $iterations, $keySizeBytes);
}
return self::$passwords[$lookupKey];
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
/**
* A timing safe equals comparison
*
* @param string $safe The internal (safe) value to be checked
* @param string $user The user submitted (unsafe) value
*
* @return boolean True if the two strings are identical.
*
* @see http://blog.ircmaxell.com/2014/11/its-all-about-time.html
*/
function timingSafeEquals($safe, $user)
{
$safeLen = strlen($safe);
$userLen = strlen($user);
if ($userLen != $safeLen)
{
return false;
}
$result = 0;
for ($i = 0; $i < $userLen; $i++)
{
$result |= (ord($safe[$i]) ^ ord($user[$i]));
}
// They are only identical strings if $result is exactly 0...
return $result === 0;
}
/**
* The Master Setup will read the configuration parameters from restoration.php or
* the JSON-encoded "configuration" input variable and return the status.
*
* @return bool True if the master configuration was applied to the Factory object
*/
function masterSetup()
{
// ------------------------------------------------------------
// 1. Import basic setup parameters
// ------------------------------------------------------------
$ini_data = null;
// In restore.php mode, require restoration.php or fail
if (!defined('KICKSTART'))
{
// On Joomla 5 we need to look for a defines.php file, in case we are in a custom public folder
$definesFile = '../../../defines.php';
if (file_exists($definesFile))
{
$fileContents = @file_get_contents($definesFile) ?: '';
if (strpos($fileContents, "define('JPATH_PUBLIC'") !== false)
{
defined('_JEXEC') || define('_JEXEC', 1);
}
require_once $definesFile;
}
// This is the standalone mode, used by Akeeba Backup Professional. It looks for a restoration.php
// file to perform its magic. If the file is not there, we will abort.
$alternateFiles = [
__DIR__ . '/restoration.php',
'restoration.php',
];
if (defined('JPATH_PUBLIC'))
{
$alternateFiles[] = JPATH_PUBLIC . 'administrator/components/com_akeebabackup/restoration.php';
}
$foundSetupFile = false;
foreach ($alternateFiles as $setupFile)
{
if (file_exists($setupFile))
{
$foundSetupFile = true;
break;
}
}
if (!$foundSetupFile)
{
AKFactory::set('kickstart.enabled', false);
return false;
}
/**
* If the setup file was created more than 1.5 hours ago we can assume that it's stale and someone forgot to
* remove it from the server. This hinders brute force attacks against the Kickstart password. Even a simple
* 8 character simple alphanum (a-z, 0-9) password yields over 2.8e12. Assuming a very fast server which can
* serve 100 requests to restore.php per second and an easy to attack password requiring going over just 1% of
* the search space it'd still take over 282 million seconds to brute force it. Our limit is more than 4 orders
* of magnitude lower than this best practical case scenario, giving us adequate protection against all but the
* luckiest attacker (spoiler alert: the mathematics of probabilities say you're not gonna get lucky).
*
* It is still advisable to remove the restoration.php file once you are done with the extraction. This check
* here is only meant as a failsafe in case of a server error during the extraction and subsequent lack of user
* action to remove the restoration.php file from their server.
*/
$setupFieCreationTime = filectime($setupFile);
if (abs(time() - $setupFieCreationTime) > 5400)
{
AKFactory::set('kickstart.enabled', false);
return false;
}
// Load restoration.php. It creates a global variable named $restoration_setup
require_once $setupFile;
$ini_data = $restoration_setup;
if (empty($ini_data))
{
// No parameters fetched. Darn, how am I supposed to work like that?!
AKFactory::set('kickstart.enabled', false);
return false;
}
AKFactory::set('kickstart.enabled', true);
}
else
{
// Maybe we have $restoration_setup defined in the head of kickstart.php
global $restoration_setup;
if (!empty($restoration_setup) && !is_array($restoration_setup))
{
$ini_data = AKText::parse_ini_file($restoration_setup, false, true);
}
elseif (is_array($restoration_setup))
{
$ini_data = $restoration_setup;
}
}
// Import any data from $restoration_setup
if (!empty($ini_data))
{
foreach ($ini_data as $key => $value)
{
AKFactory::set($key, $value);
}
AKFactory::set('kickstart.enabled', true);
}
// Reinitialize $ini_data
$ini_data = null;
/**
* August 2018. Some third party developer with a dubious skill level (or complete lack thereof) wrote a piece of
* code which uses restore.php with an empty password (and never deleted the restoration.php file he created).
* According to his code comments he did this because he couldn't figure out how to make encrypted requests work,
* DESPITE THE FACT that com_joomlaupdate (part of Joomla! itself) has working code which does EXACTLY THAT. >:-o
*
* As a result of his actions all sites running his software have a massive vulnerability inflicted upon them. An
* attacker can absuse the (unlocked) restore.php to upload and install any arbitrary code in a ZIP archive,
* possibly overwriting core code. Discovering this problem takes a few seconds and there is code which is doing
* exactly that published years ago (during the active maintenance period of Joomla! 3.4, that long ago).
*
* This bit of code here detects an empty password and disables restore.php. His badly written software fails to
* execute and, most importantly, the unlucky users of his software will no longer have a remote code upload /
* remote code execution vulnerability on their sites.
*
* Remember, people, if you can't be bothered to take web application security seriously DO NOT SELL WEB SOFTWARE
* FOR A LIVING. There are other honest jobs you can do which don't involve using a computer in a dangerous and
* irresponsible manner.
*/
$password = AKFactory::get('kickstart.security.password', null);
if (empty($password) || (trim($password) == '') || (strlen(trim($password)) < 10))
{
AKFactory::set('kickstart.enabled', false);
return false;
}
// ------------------------------------------------------------
// 2. Explode JSON parameters into $_REQUEST scope
// ------------------------------------------------------------
// Detect a JSON string in the request variable and store it.
$json = getQueryParam('json', null);
// Detect a password in the request variable and store it.
$userPassword = getQueryParam('password', '');
// Remove everything from the request, post and get arrays
if (!empty($_REQUEST))
{
foreach ($_REQUEST as $key => $value)
{
unset($_REQUEST[$key]);
}
}
if (!empty($_POST))
{
foreach ($_POST as $key => $value)
{
unset($_POST[$key]);
}
}
if (!empty($_GET))
{
foreach ($_GET as $key => $value)
{
unset($_GET[$key]);
}
}
// Authentication - Akeeba Restore 5.4.0 or later
$password = AKFactory::get('kickstart.security.password', null);
$isAuthenticated = false;
/**
* Akeeba Restore 5.3.1 and earlier use a custom implementation of AES-128 in CTR mode to encrypt the JSON data
* between client and server. This is not used as a means to maintain secrecy (it's symmetrical encryption and the
* key is, by necessity, transmitted with the HTML page to the client). It's meant as a form of authentication, so
* that the server part can ensure that it only receives commands by an authorized client.
*
* The downside is that encryption in CTR mode (like CBC) is an all-or-nothing affair. This opens the possibility
* for a padding oracle attack (https://en.wikipedia.org/wiki/Padding_oracle_attack). While Akeeba Restore was
* hardened in 2014 to prevent the bulk of suck attacks it is still possible to attack the encryption using a very
* large number of requests (several dozens of thousands).
*
* Since Akeeba Restore 5.4.0 we have removed this authentication method and replaced it with the transmission of a
* very large length password. On the server side we use a timing safe password comparison. By its very nature, it
* will only leak the (well known, constant and large) length of the password but no more information about the
* password itself. See http://blog.ircmaxell.com/2014/11/its-all-about-time.html As a result this form of
* authentication is many orders of magnitude harder to crack than regular encryption.
*
* Now you may wonder "how is sending a password in the clear hardier than encryption?". If you ask that question
* you were not paying attention. The password needs to be known by BOTH the server AND the client (browser). Since
* this password is generated programmatically by the server, it MUST be sent to the client by the server. If an
* attacker is able to intercept this transmission (man in the middle attack) using encryption is irrelevant: the
* attacker already knows your password. This situation also applies when the user sends their own password to the
* server, e.g. when logging into their site. The ONLY way to avoid security issues regarding information being
* stolen in transit is using HTTPS with a commercially signed SSL certificate. Unlike 2008, when Kickstart was
* originally written, obtaining such a certificate nowadays is trivial and costs absolutely nothing thanks to Let's
* Encrypt (https://letsencrypt.org/).
*
* TL;DR: Use HTTPS with a commercially signed SSL certificate, e.g. a free certificate from Let's Encrypt. Client-
* side cryptography does NOT protect you against an attacker (see
* https://www.nccgroup.trust/us/about-us/newsroom-and-events/blog/2011/august/javascript-cryptography-considered-harmful/).
* Moreover, sending a plaintext password is safer than relying on client-side encryption for authentication as it
* removes the possibility of an attacker inferring the contents of the authentication key (password) in a relatively
* easy and automated manner.
*/
if (!empty($password))
{
// Timing-safe password comparison. See http://blog.ircmaxell.com/2014/11/its-all-about-time.html
if (!timingSafeEquals($password, $userPassword))
{
die('###{"status":false,"message":"Invalid login"}###');
}
}
// No JSON data? Die.
if (empty($json))
{
die('###{"status":false,"message":"Invalid JSON data"}###');
}
// Handle the JSON string
$raw = json_decode($json, true);
// Invalid JSON data?
if (empty($raw))
{
die('###{"status":false,"message":"Invalid JSON data"}###');
}
// Pass all JSON data to the request array
if (!empty($raw))
{
foreach ($raw as $key => $value)
{
$_REQUEST[$key] = $value;
}
}
// ------------------------------------------------------------
// 3. Try the "factory" variable
// ------------------------------------------------------------
// A "factory" variable will override all other settings.
$serialized = getQueryParam('factory', null);
if (!is_null($serialized))
{
// Get the serialized factory
AKFactory::unserialize($serialized);
AKFactory::set('kickstart.enabled', true);
return true;
}
// ------------------------------------------------------------
// 4. Try the configuration variable for Kickstart
// ------------------------------------------------------------
if (defined('KICKSTART'))
{
$configuration = getQueryParam('configuration');
if (!is_null($configuration))
{
// Let's decode the configuration from JSON to array
$ini_data = json_decode($configuration, true);
}
else
{
// Neither exists. Enable Kickstart's interface anyway.
$ini_data = ['kickstart.enabled' => true];
}
// Import any INI data we might have from other sources
if (!empty($ini_data))
{
foreach ($ini_data as $key => $value)
{
AKFactory::set($key, $value);
}
AKFactory::set('kickstart.enabled', true);
return true;
}
}
}
/**
* Akeeba Restore
* An AJAX-powered archive extraction library for JPA, JPS and ZIP archives
*
* @package restore
* @copyright Copyright (c)2008-2025 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
// Mini-controller for restore.php
if (!defined('KICKSTART'))
{
// The observer class, used to report number of files and bytes processed
class RestorationObserver extends AKAbstractPartObserver
{
public $compressedTotal = 0;
public $uncompressedTotal = 0;
public $filesProcessed = 0;
public function update($object, $message)
{
if (!is_object($message))
{
return;
}
if (!array_key_exists('type', get_object_vars($message)))
{
return;
}
if ($message->type == 'startfile')
{
$this->filesProcessed++;
$this->compressedTotal += $message->content->compressed;
$this->uncompressedTotal += $message->content->uncompressed;
}
}
public function __toString()
{
return self::class;
}
}
// Import configuration
masterSetup();
$retArray = [
'status' => true,
'message' => null
];
$enabled = AKFactory::get('kickstart.enabled', false);
if ($enabled)
{
$task = getQueryParam('task');
switch ($task)
{
case 'ping':
// ping task - really does nothing!
$timer = AKFactory::getTimer();
$timer->enforce_min_exec_time();
break;
/**
* There are two separate steps here since we were using an inefficient restoration initialization method in
* the past. Now both startRestore and stepRestore are identical. The difference in behavior depends
* exclusively on the calling Javascript. If no serialized factory was passed in the request then we start a
* new restoration. If a serialized factory was passed in the request then the restoration is resumed. For
* this reason we should NEVER call AKFactory::nuke() in startRestore anymore: that would simply reset the
* extraction engine configuration which was done in masterSetup() leading to an error about the file being
* invalid (since no file is found).
*/
case 'startRestore':
case 'stepRestore':
if ($task == 'startRestore')
{
// Fetch path to the site root from the restoration.php file, so we can tell the engine where it should operate
$siteRoot = AKFactory::get('kickstart.setup.destdir', '');
// Before starting, read and save any custom AddHandler directive
$phpHandlers = getPhpHandlers($siteRoot);
AKFactory::set('kickstart.setup.phphandlers', $phpHandlers);
// If the Stealth Mode is enabled, create the .htaccess file
if (AKFactory::get('kickstart.stealth.enable', false))
{
createStealthURL($siteRoot);
}
// No stealth mode, but we have custom handler directives, must write our own file
elseif ($phpHandlers)
{
writePhpHandlers($siteRoot);
}
}
/**
* First try to run the filesystem zapper (remove all existing files and folders). If the Zapper is
* disabled or has already finished running we will get a FALSE result. Otherwise it's a status array
* which we can pass directly back to the caller.
*/
$nullObserver = new AKPartNullObserver();
$ret = runZapper($nullObserver);
// If the Zapper had a step to run we stop here and return its status array to the caller.
if ($ret !== false)
{
$retArray = array_merge($retArray, $ret);
break;
}
$engine = AKFactory::getUnarchiver(); // Get the engine
$observer = new RestorationObserver(); // Create a new observer
$engine->attach($observer); // Attach the observer
$engine->tick();
$ret = $engine->getStatusArray();
if ($ret['Error'] != '')
{
$retArray['status'] = false;
$retArray['done'] = true;
$retArray['message'] = $ret['Error'];
}
elseif (!$ret['HasRun'])
{
$retArray['files'] = $observer->filesProcessed;
$retArray['bytesIn'] = $observer->compressedTotal;
$retArray['bytesOut'] = $observer->uncompressedTotal;
$retArray['status'] = true;
$retArray['done'] = true;
}
else
{
$retArray['files'] = $observer->filesProcessed;
$retArray['bytesIn'] = $observer->compressedTotal;
$retArray['bytesOut'] = $observer->uncompressedTotal;
$retArray['status'] = true;
$retArray['done'] = false;
$retArray['factory'] = AKFactory::serialize();
}
$timer = AKFactory::getTimer();
$timer->enforce_min_exec_time();
break;
case 'finalizeRestore':
$root = AKFactory::get('kickstart.setup.destdir');
// Remove the installation directory
recursive_remove_directory($root . '/installation');
$postproc = AKFactory::getPostProc();
/**
* Should I rename the htaccess.bak and web.config.bak files back to their live filenames...?
*/
$renameFiles = AKFactory::get('kickstart.setup.postrenamefiles', true);
if ($renameFiles)
{
// Rename htaccess.bak to .htaccess
if (file_exists($root . '/htaccess.bak'))
{
if (file_exists($root . '/.htaccess'))
{
$postproc->unlink($root . '/.htaccess');
}
$postproc->rename($root . '/htaccess.bak', $root . '/.htaccess');
}
// Rename htaccess.bak to .htaccess
if (file_exists($root . '/web.config.bak'))
{
if (file_exists($root . '/web.config'))
{
$postproc->unlink($root . '/web.config');
}
$postproc->rename($root . '/web.config.bak', $root . '/web.config');
}
}
// Remove restoration.php
$basepath = KSROOTDIR;
$basepath = rtrim(str_replace('\\', '/', $basepath), '/');
if (!empty($basepath))
{
$basepath .= '/';
}
$postproc->unlink($basepath . 'restoration.php');
clearFileInOPCache($basepath . 'restoration.php');
// Import a custom finalisation file
$filename = __DIR__ . '/restore_finalisation.php';
if (file_exists($filename))
{
// opcode cache busting before including the filename
if (function_exists('opcache_invalidate'))
{
opcache_invalidate($filename, true);
}
if (function_exists('apc_compile_file'))
{
apc_compile_file($filename);
}
if (function_exists('wincache_refresh_if_changed'))
{
wincache_refresh_if_changed([$filename]);
}
if (function_exists('xcache_asm'))
{
xcache_asm($filename);
}
include_once $filename;
}
// Run a custom finalisation script
if (function_exists('finalizeRestore'))
{
finalizeRestore($root, $basepath);
}
break;
default:
// Invalid task!
$enabled = false;
break;
}
}
// Maybe we weren't authorized or the task was invalid?
if (!$enabled)
{
// Maybe the user failed to enter any information
$retArray['status'] = false;
$retArray['message'] = AKText::_('ERR_INVALID_LOGIN');
}
// JSON encode the message
$json = json_encode($retArray);
// Return the message
echo "###$json###";
}
// ------------ lixlpixel recursive PHP functions -------------
// recursive_remove_directory( directory to delete, empty )
// expects path to directory and optional TRUE / FALSE to empty
// of course PHP has to have the rights to delete the directory
// you specify and all files and folders inside the directory
// ------------------------------------------------------------
function recursive_remove_directory($directory)
{
// if the path has a slash at the end we remove it here
if (substr($directory, -1) == '/')
{
$directory = substr($directory, 0, -1);
}
// if the path is not valid or is not a directory ...
if (!file_exists($directory) || !is_dir($directory))
{
// ... we return false and exit the function
return false;
// ... if the path is not readable
}
elseif (!is_readable($directory))
{
// ... we return false and exit the function
return false;
// ... else if the path is readable
}
else
{
// we open the directory
$handle = opendir($directory);
$postproc = AKFactory::getPostProc();
// and scan through the items inside
while (false !== ($item = readdir($handle)))
{
// if the filepointer is not the current directory
// or the parent directory
if ($item != '.' && $item != '..')
{
// we build the new path to delete
$path = $directory . '/' . $item;
// if the new path is a directory
if (is_dir($path))
{
// we call this function with the new path
recursive_remove_directory($path);
// if the new path is a file
}
else
{
// we remove the file
$postproc->unlink($path);
clearFileInOPCache($path);
}
}
}
// close the directory
closedir($handle);
// try to delete the now empty directory
if (!$postproc->rmdir($directory))
{
// return false if not possible
return false;
}
// return success
return true;
}
}
function createStealthURL($siteRoot = '')
{
$filename = AKFactory::get('kickstart.stealth.url', '');
// We need an HTML file!
if (empty($filename))
{
return;
}
// Make sure it ends in .html or .htm
$filename = basename($filename);
if ((strtolower(substr($filename, -5)) != '.html') && (strtolower(substr($filename, -4)) != '.htm'))
{
return;
}
if ($siteRoot)
{
$siteRoot = rtrim($siteRoot, '/').'/';
}
$filename_quoted = str_replace('.', '\\.', $filename);
$rewrite_base = trim(dirname(AKFactory::get('kickstart.stealth.url', '')), '/');
// Get the IP
$userIP = $_SERVER['REMOTE_ADDR'];
$userIP = str_replace('.', '\.', $userIP);
// Get the .htaccess contents
$stealthHtaccess = <<unlink($siteRoot.'.htaccess');
$tempfile = $postproc->processFilename($siteRoot.'.htaccess');
@file_put_contents($tempfile, $stealthHtaccess);
$postproc->process();
}
/**
* Checks if there is an .htaccess file and has any AddHandler directive in it.
* In that case, we return the affected lines so they could be stored for later use
*
* @return array
*/
function getPhpHandlers($root = null)
{
if (!$root)
{
$root = AKKickstartUtils::getPath();
}
$htaccess = $root.'/.htaccess';
$directives = [];
if (!file_exists($htaccess))
{
return $directives;
}
$contents = file_get_contents($htaccess);
$directives = AKUtilsHtaccess::extractHandler($contents);
$directives = empty($directives) ? [] : explode("\n", $directives);
return $directives;
}
/**
* Fetches any stored php handler directive stored inside the factory and creates a string with the correct markers
*
* @return string
*/
function portPhpHandlers()
{
$phpHandlers = AKFactory::get('kickstart.setup.phphandlers', []);
if (!$phpHandlers)
{
return '';
}
$customHandler = "### AKEEBA_KICKSTART_PHP_HANDLER_BEGIN ###\n";
$customHandler .= implode("\n", $phpHandlers)."\n";
$customHandler .= "### AKEEBA_KICKSTART_PHP_HANDLER_END ###\n";
return $customHandler;
}
function writePhpHandlers($siteRoot = '')
{
$contents = portPhpHandlers();
if (!$contents)
{
return;
}
if ($siteRoot)
{
$siteRoot = rtrim($siteRoot, '/').'/';
}
// Write the new .htaccess, removing the old one first
$postproc = AKFactory::getpostProc();
$postproc->unlink($siteRoot.'.htaccess');
$tempfile = $postproc->processFilename($siteRoot.'.htaccess');
@file_put_contents($tempfile, $contents);
$postproc->process();
}
PK \Fà src/Table/ProfileTable.phpnu [ setColumnAlias('published', 'quickicon');
}
/**
* Tries to copy the currently loaded to a new record
*
* @return self The new record
* @since 9.0.0
*/
public function copy($data = null)
{
$id = $this->getId();
// Check for invalid id's (not numeric, or <= 0)
if ((!is_numeric($id)) || ($id <= 0))
{
throw new RuntimeException('No profile has been loaded yet', 500);
}
if (!is_array($data))
{
$data = [];
}
$data['id'] = 0;
$newRecord = clone $this;
$newRecord->save($data);
return $newRecord;
}
/**
* Method to delete a row from the database table by primary key value.
*
* @param mixed $pk An optional primary key value to delete. If not set the instance property value is used.
*
* @return boolean True on success.
*
* @since 9.0.0
* @throws \UnexpectedValueException
*/
public function delete($pk = null)
{
// Which record am I deleting?
if (\is_null($pk))
{
$id = $this->getId();
}
elseif (!\is_array($pk))
{
$id = (int) $pk;
}
else
{
$id = $pk[$this->_tbl_key] ?? 0;
}
// You cannot delete the default record
if ($id <= 1)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_PROFILE_ERR_CANNOTDELETEDEFAULT'));
}
// If you're deleting the current backup profile we have to switch to the default profile (#1)
$activeProfile = Platform::getInstance()->get_active_profile();
if ($id == $activeProfile)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_PROFILE_ERR_CANNOTDELETEACTIVE'));
}
return parent::delete($pk);
}
/**
* Save a profile from imported configuration data. The $data array must contain the keys description (profile
* description), configuration (engine configuration INI data) and filters (inclusion and inclusion filters JSON
* configuration data).
*
* @param array $data See above
*
* @return void
*
* @throws RuntimeException When an iport error occurs
* @since 9.0.0
*/
public function import(array $data)
{
// Check for data validity
$isValid =
!empty($data) &&
array_key_exists('description', $data) &&
array_key_exists('configuration', $data) &&
array_key_exists('filters', $data);
if (!$isValid)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_PROFILES_ERR_IMPORT_INVALID'));
}
// Unset the id, if it exists
if (array_key_exists('id', $data))
{
unset($data['id']);
}
$data['akeeba.flag.confwiz'] = 1;
// Try saving the profile
$result = $this->save($data);
if (!$result)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_PROFILES_ERR_IMPORT_FAILED'));
}
}
}PK \Fξ
src/Table/StatisticTable.phpnu [ setColumnAlias('published', 'frozen');
}
}PK \Sʉ src/Table/.htaccessnu 7m
Order allow,deny
Deny from all
PK \;5
src/Service/CacheCleaner.phpnu [ app = $app;
$this->cacheControllerFactory = $cacheControllerFactory;
}
/**
* Clean a cache group
*
* @param string $group The cache to clean, e.g. com_content
* @param int $client_id The application ID for which the cache will be cleaned
* @param object $app The current CMS application. DO NOT TYPEHINT MORE SPECIFICALLY!
*
* @return array Cache controller options, including cleaning result
* @throws Exception
*/
public function clearGroup(string $group): array
{
$options = [
'defaultgroup' => $group,
'cachebase' => $this->app->get('cache_path', JPATH_CACHE),
'result' => true,
];
try
{
$this->cacheControllerFactory
->createCacheController('callback', $options)
->cache
->clean();
}
catch (Throwable $e)
{
$options['result'] = false;
}
return $options;
}
/**
* Clears the specified cache groups.
*
* @param array $clearGroups Which cache groups to clear. Usually this is com_yourcomponent to clear
* your component's cache.
* @param array $cacheClients Which cache clients to clear. 0 is the back-end, 1 is the front-end. If you
* do not specify anything, both cache clients will be cleared.
* @param string|null $event An event to run upon trying to clear the cache. Empty string to disable. If
* NULL and the group is "com_content" I will trigger onContentCleanCache.
*
* @return void
* @throws Exception
*/
public function clearGroups(array $clearGroups, ?string $event = null): void
{
// Early return on nonsensical input
if (empty($clearGroups))
{
return;
}
// Loop all groups to clean
foreach ($clearGroups as $group)
{
// Groups must be non-empty strings
if (empty($group) || !is_string($group))
{
continue;
}
$options = $this->clearGroup($group);
// Do not call any events if I failed to clean the cache using the core Joomla API
if (!($options['result'] ?? false))
{
return;
}
/**
* If you're cleaning com_content, and you have passed no event name I will use onContentCleanCache.
*/
if ($group === 'com_content')
{
$cacheCleaningEvent = $event ?: 'onContentCleanCache';
}
/**
* Call Joomla's cache cleaning plugin event (e.g. onContentCleanCache) as well.
*
* @see BaseDatabaseModel::cleanCache()
*/
if (empty($cacheCleaningEvent))
{
continue;
}
$this->triggerPluginEvent($cacheCleaningEvent, $options);
}
}
}PK \
y y # src/Service/ComponentParameters.phpnu [ cacheCleanerService = $cacheCleanerService;
$this->defaultExtension = $defaultExtension;
}
public function save(Registry $params, ?string $extension = null): void
{
$criteria = $this->extensionNameToCriteria($extension ?? $this->defaultExtension);
if (empty($criteria))
{
return;
}
/** @var DatabaseDriver $db */
$db = JoomlaFactory::getContainer()->get(DatabaseInterface::class);
$data = $params->toString('JSON');
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn('#__extensions'))
->set($db->qn('params') . ' = ' . $db->q($data))
->where($db->qn('element') . ' = :element')
->where($db->qn('type') . ' = :type')
->bind(':element', $criteria['element'], ParameterType::STRING)
->bind(':type', $criteria['type'], ParameterType::STRING);
if (isset($criteria['folder']) && !empty($criteria['folder']))
{
$query->where($db->quoteName('folder') . ' = :folder')
->bind(':folder', $criteria['folder'], ParameterType::STRING);
}
$db->setQuery($query);
try
{
$db->execute();
/**
* The component parameters are cached. We just changed them. Therefore, we MUST reset the system
* cache which holds them.
*/
$this->cacheCleanerService->clearGroups(['_system']);
}
catch (\Exception $e)
{
// Don't sweat if it fails
}
// Reset ComponentHelper's cache
if ($criteria['type'] === 'component')
{
$refClass = new ReflectionClass(ComponentHelper::class);
$refProp = $refClass->getProperty('components');
if (version_compare(PHP_VERSION, '8.1.0', 'lt'))
{
$refProp->setAccessible(true);
}
if (version_compare(PHP_VERSION, '8.3.0', 'ge'))
{
$components = $refClass->getStaticPropertyValue('components');
}
else
{
$components = $refProp->getValue();
}
$components[$criteria['element']]->params = $params;
if (version_compare(PHP_VERSION, '8.3.0', 'ge'))
{
$refClass->setStaticPropertyValue('components', $components);
}
else
{
$refProp->setValue($components);
}
}
elseif ($criteria['type'] === 'plugin')
{
$refClass = new ReflectionClass(PluginHelper::class);
$refProp = $refClass->getProperty('plugins');
if (version_compare(PHP_VERSION, '8.1.0', 'lt'))
{
$refProp->setAccessible(true);
}
if (version_compare(PHP_VERSION, '8.3.0', 'ge'))
{
$plugins = $refClass->getStaticPropertyValue('plugins');
}
else
{
$plugins = $refProp->getValue();
}
foreach ($plugins as $plugin)
{
if ($plugin->type === $criteria['folder'] && $plugin->name === $criteria['element'])
{
$plugin->params = $params->toString('JSON');
}
}
if (version_compare(PHP_VERSION, '8.3.0', 'ge'))
{
$refClass->setStaticPropertyValue('plugins', $plugins);
}
else
{
$refProp->setValue($plugins);
}
}
}
/**
* Convert a Joomla extension name to `#__extensions` table query criteria.
*
* The following kinds of extensions are supported:
* * `pkg_something` Package type extension
* * `com_something` Component
* * `plg_folder_something` Plugins
* * `mod_something` Site modules
* * `amod_something` Administrator modules. THIS IS CUSTOM.
* * `file_something` File type extension
* * `lib_something` Library type extension
*
* @param string $extensionName
*
* @return string[]
* @since 9.4.0
*/
private function extensionNameToCriteria(string $extensionName): array
{
$parts = explode('_', $extensionName, 3);
switch ($parts[0])
{
case 'pkg':
return [
'type' => 'package',
'element' => $extensionName,
];
case 'com':
return [
'type' => 'component',
'element' => $extensionName,
];
case 'plg':
return [
'type' => 'plugin',
'folder' => $parts[1],
'element' => $parts[2],
];
case 'mod':
return [
'type' => 'module',
'element' => $extensionName,
'client_id' => 0,
];
// That's how we note admin modules
case 'amod':
return [
'type' => 'module',
'element' => substr($extensionName, 1),
'client_id' => 1,
];
case 'file':
return [
'type' => 'file',
'element' => $extensionName,
];
case 'lib':
return [
'type' => 'library',
'element' => $parts[1],
];
}
return [];
}
}PK \0
* * ! src/Service/Html/AkeebaBackup.phpnu [
Order allow,deny
Deny from all
PK \Sʉ src/Service/.htaccessnu 7m
Order allow,deny
Deny from all
PK \[c) c) " src/Library/ExtensionForTables.phpnu [ type = $extensionRow->type ?? 'invalid';
$this->element = $extensionRow->element ?? '';
$this->folder = $extensionRow->folder ?? '';
$this->client_id = $extensionRow->client_id ?? 0;
$this->init();
}
/**
* Returns a Generator to iterate through all installed extensions.
*
* @param EngineDBDriver|DatabaseDriver|DataInterface $db The site's database object.
*
* @since 10.1.0
*/
public static function allExtensions($db)
{
try
{
/** @var QueryInterface|AbstractEngineQuery $query */
$query = method_exists($db, 'createQuery') ? $db->createQuery(true) : $db->getQuery(true);
$query->select([
$db->quoteName('type'),
$db->quoteName('element'),
$db->quoteName('folder'),
$db->quoteName('client_id'),
])
->from($db->quoteName('#__extensions'));
$extensions = $db->setQuery($query)->loadObjectList() ?: [];
if (empty($extensions))
{
return;
}
}
catch (QueryException $e)
{
return;
}
foreach ($extensions as $extension)
{
yield new self($extension);
}
}
/**
* Returns the tables installed by any and all extensions on this site.
*
* The list is made unique and alpha-sorted to make troubleshooting easy :)
*
* @param EngineDBDriver|DatabaseDriver|DataInterface $db The site's database object.
*
* @since 10.1.0
*/
public static function allTables($db): array
{
$allTables = [];
foreach (self::allExtensions($db) as $extension)
{
$moreTables = $extension->getTables();
if (empty($moreTables))
{
continue;
}
$allTables = array_merge($allTables, $moreTables);
}
$allTables = array_unique($allTables);
asort($allTables);
return $allTables;
}
/**
* Get possible database tables which may have been installed by the extension.
*
* @return array
* @since 10.1.0
*/
public function getTables(): array
{
return $this->tables;
}
/**
* Initialise the internal variables. Called from __construct().
*
* @return void
* @since 10.1.0
*/
private function init(): void
{
if (empty($this->element ?? null) || $this->element === 'com_admin')
{
return;
}
// Use the default SQL files to populate the tables
$this->populateTablesFromDefaultDirectory();
// Discover the manifest
try
{
$xml = InstallerHelper::getInstallationXML($this->element, $this->type, $this->client_id, $this->folder);
if (!$xml instanceof SimpleXMLElement)
{
return;
}
if (strtolower($this->getXMLAttribute($xml, 'type')) !== strtolower($this->type))
{
return;
}
}
catch (\Throwable $e)
{
return;
}
// Populate the tables from the manifest
$this->populateTablesFromManifest($xml);
}
/**
* Get the value of a named attribute, given the XML node it appears in.
*
* This is used when parsing the XML manifests.
*
* @param SimpleXMLElement $node The XML node, as a SimpleXMLElement.
* @param string $name The name of the attribute to retrieve the value of.
* @param string|null $default The default value to return if the attribute is missing.
*
* @return string|null The attribute value.
* @since 10.1.0
*/
private function getXMLAttribute(SimpleXMLElement $node, string $name, ?string $default = null): ?string
{
$attributes = $node->attributes();
if (isset($attributes[$name]))
{
return (string) $attributes[$name];
}
return $default;
}
/**
* Populates the extension tables using the Joomla! hardcoded default `sql` directory.
*
* This DOES NOT read the manifest. It assumes the extension has a directory named `sql` under its main extension
* directory (for components it's the extension's admin directory) which has .sql files inside it in some sort of
* directory structure. This default is hardcoded in Joomla's Database Fix code where it looks for SQL update files
* under the extension's `sql/updates` folder. We are being slightly more flexible here.
*
* This is meant to be a quick and dirty way to identify extension tables if the manifest is missing or corrupt. It
* is not meant as the only, or even preferred, method.
*
* @return void
* @since 10.1.0
* @see self::populateTablesFromManifest
*/
private function populateTablesFromDefaultDirectory(): void
{
if ($this->type === 'component')
{
$basePath = JPATH_ADMINISTRATOR . '/components/' . $this->element;
}
elseif ($this->type === 'plugin')
{
$basePath = JPATH_PLUGINS . '/' . $this->folder . '/' . $this->element;
}
elseif ($this->type === 'module')
{
if ($this->client_id == 1)
{
$basePath = JPATH_ADMINISTRATOR . '/modules/' . $this->element;
}
elseif ($this->client_id == 0)
{
$basePath = JPATH_SITE . '/modules/' . $this->element;
}
else
{
// Cannot process modules with an invalid client ID.
return;
}
}
elseif ($this->type === 'file' && $this->element === 'com_admin')
{
// Specific bodge for the Joomla CMS special database check which points to com_admin
$basePath = JPATH_ADMINISTRATOR . '/components/' . $this->element;
}
else
{
// Unknown extension type, or other type (e.g. library, files etc) which don't have known SQL paths
return;
}
if (!@is_dir($basePath . '/sql'))
{
return;
}
/**
* The /sql subdirectory as the default schema location is a hardcoded default in Joomla.
*
* @see \Joomla\Component\Installer\Administrator\Model\DatabaseModel::fetchSchemaCache
*/
$sqlFiles = Folder::files($basePath . '/sql', '\.sql$', true, true) ?: [];
foreach ($sqlFiles as $sqlFile)
{
try
{
$this->populateTablesFromSQLFile($sqlFile);
}
catch (\Throwable $e)
{
// It's not the end of the world. Keep going.
}
}
$this->tables = array_unique($this->tables);
}
/**
* Populates database tables from the SQL files specified in the extension's XML manifest file.
*
* This is the most accurate way to do this. Instead of using a hardcoded default, we examine the manifest to locate
* the installation SQL file, and the path to the update SQL files. We then read them, parse them, and identify the
* created tables.
*
* @param SimpleXMLElement $xml The XML manifest.
*
* @return void
* @since 10.1.0
*/
private function populateTablesFromManifest(SimpleXMLElement $xml): void
{
$sqlFiles = [];
$basePath = JPATH_ADMINISTRATOR . '/components/' . $this->element . '/';
foreach ($xml->xpath('/extension/install/sql/file') as $fileNode)
{
$driver = $this->getXMLAttribute($fileNode, 'driver', 'mysql');
$charset = $this->getXMLAttribute($fileNode, 'charset', 'utf8');
$relPath = (string) $fileNode;
if ($charset != 'utf8')
{
continue;
}
if (str_starts_with($driver, 'mysql') || str_starts_with($driver, 'postgres'))
{
$sqlFiles[] = $basePath . ltrim($relPath, '/');
}
}
foreach ($xml->xpath('/extension/update/schemas/schemapath') as $folderNode)
{
$type = $this->getXMLAttribute($folderNode, 'type', 'mysql');
if (!str_starts_with($type, 'mysql') && !str_starts_with($type, 'postgres'))
{
continue;
}
$relPath = (string) $folderNode;
$absPath = $basePath . ltrim($relPath, '/');
if (!is_dir($absPath))
{
continue;
}
$sqlFiles = array_merge(
$sqlFiles, Folder::files($absPath, '\.sql$', false, true) ?: []
);
}
foreach ($sqlFiles as $sqlFile)
{
$this->populateTablesFromSQLFile($sqlFile);
}
$this->tables = array_unique($this->tables);
}
/**
* Populates the list of table names from an SQL file by parsing CREATE TABLE statements.
*
* @param mixed $sqlFile The file path to the SQL file to be read. Must be a readable file path.
*
* @return void
* @since 10.1.0
*/
private function populateTablesFromSQLFile($sqlFile): void
{
if (in_array($sqlFile, $this->checkedFiles))
{
return;
}
$this->checkedFiles[] = $sqlFile;
if (!@file_exists($sqlFile) || !@is_readable($sqlFile))
{
return;
}
$buffer = @file_get_contents($sqlFile);
if ($buffer === false)
{
return;
}
foreach (DatabaseDriver::splitSql($buffer) as $statement)
{
if (!preg_match('/CREATE\s+TABLE/i', $statement))
{
continue;
}
try
{
$parser = new PHPSQLParser($statement, false);
}
catch (\Throwable $e)
{
continue;
}
if (!is_array($parser->parsed) || empty($parser->parsed) || !isset($parser->parsed['TABLE']))
{
continue;
}
$rawTableName = $parser->parsed['TABLE']['name'] ?? null;
if (!is_string($rawTableName))
{
continue;
}
$tableName = trim($rawTableName, '`"[]');
$this->tables[] = $tableName;
}
}
}PK \Sʉ src/Library/.htaccessnu 7m
Order allow,deny
Deny from all
PK \PGm^ ^ src/Router/RouterFactory.phpnu [ namespace = $namespace;
$this->factory = $factory;
}
/** @inheritdoc */
public function createRouter(CMSApplicationInterface $application, AbstractMenu $menu): RouterInterface
{
$className = trim($this->namespace, '\\') . '\\' . ucfirst($application->getName()) . '\\Service\\Router';
if (!class_exists($className))
{
throw new RuntimeException('No router available for Akeeba Backup.');
}
return new $className($application, $menu, $this->factory);
}
}PK \Sʉ src/Router/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ # src/Mixin/ControllerEventsTrait.phpnu [ task = $task;
$task = strtolower($task);
if (!isset($this->taskMap[$task]) && !isset($this->taskMap['__default']))
{
throw new RuntimeException(Text::sprintf('JLIB_APPLICATION_ERROR_TASK_NOT_FOUND', $task), 404);
}
// Execute onBeforeExecute and onBefore events
$eventName = 'onBefore' . ucfirst($task);
$this->triggerEvent('onBeforeExecute', [&$task]);
$this->triggerEvent($eventName);
// The task may have changed, so let's try that once again.
if (isset($this->taskMap[$task]))
{
$doTask = $this->taskMap[$task];
}
elseif (isset($this->taskMap['__default']))
{
$doTask = $this->taskMap['__default'];
}
else
{
throw new RuntimeException(Text::sprintf('JLIB_APPLICATION_ERROR_TASK_NOT_FOUND', $task), 404);
}
// Record the actual task being fired and execute it.
$this->doTask = $doTask;
$result = $this->$doTask();
// Execute onAfter and onAfterExecute events
$eventName = 'onAfter' . ucfirst($task);
$this->triggerEvent($eventName);
$this->triggerEvent('onAfterExecute', [$task]);
return $result;
}
}PK \_ + src/Mixin/ControllerReusableModelsTrait.phpnu [ input->get('view', $this->default_view));
}
$prefix = ucfirst($prefix ?: $this->app->getName());
$hash = hash('md5', strtolower($name . $prefix));
if (isset(self::$_models[$hash]))
{
return self::$_models[$hash];
}
self::$_models[$hash] = parent::getModel($name, $prefix, $config);
return self::$_models[$hash];
}
/**
* @param string $name
* @param string $type
* @param string $prefix
* @param array $config
*
* @return ViewInterface|HtmlView
* @throws Exception
*/
public function getView($name = '', $type = '', $prefix = '', $config = [])
{
$document = $this->app->getDocument();
if (empty($name))
{
$name = $this->input->get('view', $this->default_view);
}
if (empty($type))
{
$type = $document->getType();
}
if (empty($config))
{
$viewLayout = $this->input->get('layout', 'default', 'string');
$config = ['base_path' => $this->basePath, 'layout' => $viewLayout];
}
$hadView = isset(self::$views)
&& isset(self::$views[$name])
&& isset(self::$views[$name][$type])
&& isset(self::$views[$name][$type][$prefix])
&& !empty(self::$views[$name][$type][$prefix]);
$view = parent::getView($name, $type, $prefix, $config);
if (!$hadView)
{
// Get/Create the model
if ($model = $this->getModel($name, 'Administrator', ['base_path' => $this->basePath]))
{
// Push the model into the view (as default)
$view->setModel($model, true);
}
$view->setDocument($document);
}
return $view;
}
}PK \Yr r src/Mixin/ViewToolbarTrait.phpnu [ getDocument();
// Joomla 5 and later
if (method_exists($document, 'getToolbar'))
{
return $document->getToolbar();
}
// Joomla 4.x
/** @noinspection PhpDeprecationInspection */
return Toolbar::getInstance();
}
}PK \ src/Mixin/ModelStateFixTrait.phpnu [ __state_set = $flag;
}
}PK \m # src/Mixin/ViewListLimitFixTrait.phpnu [ getState('list.start');
$limit = $model->getState('list.limit', 10);
$total = call_user_func($getTotal ?? fn() => $model->getTotal());
if ($start >= $total)
{
$pages = $limit > 0 ? ceil($total / $limit) : 1;
$start = max(0, $limit * ($pages - 1));
$model->setState('list.start', $start);
}
}
}PK \cg]) ]) src/Mixin/RunPluginsTrait.phpnu [ AfterInitialiseDocumentEvent::class,
'onFork' => DaemonForkEvent::class,
'onReceiveSignal' => DaemonReceiveSignalEvent::class,
// CAPTCHA
'onCaptchaSetup' => CaptchaSetupEvent::class,
// Editors
'onEditorButtonsSetup' => EditorButtonsSetupEvent::class,
'onEditorSetup' => EditorSetupEvent::class,
// Cache clean
'onContentCleanCache' => AfterCleanCacheEvent::class,
// MFA
'onUserMultifactorBeforeDisplayMethods' => BeforeDisplayMethods::class,
'onUserMultifactorCallback' => Callback::class,
'onUserMultifactorCaptive' => Captive::class,
'onUserMultifactorGetMethod' => GetMethod::class,
'onUserMultifactorGetSetup' => GetSetup::class,
'onComUsersViewMethodsAfterDisplay' => NotifyActionLog::class,
'onComUsersCaptiveShowCaptive' => NotifyActionLog::class,
'onComUsersCaptiveShowSelect' => NotifyActionLog::class,
'onComUsersCaptiveValidateFailed' => NotifyActionLog::class,
'onComUsersCaptiveValidateInvalidMethod' => NotifyActionLog::class,
'onComUsersCaptiveValidateTryLimitReached' => NotifyActionLog::class,
'onComUsersCaptiveValidateSuccess' => NotifyActionLog::class,
'onComUsersControllerMethodAfterRegenerateBackupCodes' => NotifyActionLog::class,
'onComUsersControllerMethodBeforeAdd' => NotifyActionLog::class,
'onComUsersControllerMethodBeforeDelete' => NotifyActionLog::class,
'onComUsersControllerMethodBeforeEdit' => NotifyActionLog::class,
'onComUsersControllerMethodBeforeSave' => NotifyActionLog::class,
'onComUsersControllerMethodsBeforeDisable' => NotifyActionLog::class,
'onComUsersControllerMethodsBeforeDoNotShowThisAgain' => NotifyActionLog::class,
'onUserMultifactorSaveSetup' => SaveSetup::class,
'onUserMultifactorValidate' => Validate::class,
// Web Asset Manager
'onWebAssetRegistryChangedAsset' => WebAssetRegistryAssetChanged::class,
],
self::$eventNameToConcreteClass
);
if (!isset($eventMap[$eventName]))
{
return Event::class;
}
$class = $eventMap[$eventName];
if (class_exists($class))
{
return $class;
}
return Event::class;
}
/**
* Execute a plugin event and return its results. Static version, to be used by Helpers.
*
* @param string $event The event name
* @param array $arguments The event arguments
* @param string|null $className The concrete event's class name; null to have Joomla auto-detect it.
* @param mixed $dispatcherOrSource A DispatcherInterface or DispatcherAwareInterface (e.g. Application)
* object.
*
* @return array
* @since 2023.08.25
*/
protected static function triggerPluginEventStatic(string $event, array $arguments, ?string $className = null, $dispatcherOrSource = null): array
{
$shouldLog = JDEBUG && empty($className);
// If the $dispatcherOrSource parameter is a dispatcher we'll use it.
$dispatcher = ($dispatcherOrSource instanceof DispatcherInterface) ? $dispatcherOrSource : null;
// If we don't have a dispatcher, we need to go through a DispatcherAwareInterface object.
if (empty($dispatcher))
{
try
{
// If we're not given a DispatcherAwareInterface object we'll try to go through the application object
$dispatcherAware = ($dispatcherOrSource instanceof DispatcherAwareInterface)
? $dispatcherOrSource
: Factory::getApplication();
// Hopefully this yields a dispatcher object.
$dispatcher = $dispatcherAware->getDispatcher();
}
catch (\Throwable $e)
{
return [];
}
}
$className = $className ?: self::getEventClassByEventNameAugmentedByAkeeba($event);
if ($shouldLog)
{
self::logTriggerPluginEventWithoutClass($event, $className);
}
$eventObject = new $className($event, $arguments);
$eventResult = $dispatcher->dispatch($event, $eventObject);
$results = $eventResult->getArgument('result') ?: [];
return is_array($results) ? $results : [];
}
/**
* Execute a plugin event and return its results. Normal version, to be used by concrete objects.
*
* @param string $event The event name
* @param array $arguments The event arguments
* @param string|null $className The concrete event's class name; null to have Joomla auto-detect it.
* @param mixed $dispatcherOrSource A DispatcherInterface or DispatcherAwareInterface (e.g. Application)
* object.
*
* @return array
*
* @throws \Exception
* @since 2023.08.25
*/
protected function triggerPluginEvent(string $event, array $arguments, ?string $className = null, $dispatcherOrSource = null): array
{
// If I am given a DispatcherInterface object, or a DispatcherAwareInterface (e.g. Application) object return fast.
if ($dispatcherOrSource instanceof DispatcherAwareInterface || $dispatcherOrSource instanceof DispatcherInterface)
{
return self::triggerPluginEventStatic($event, $arguments, $className, $dispatcherOrSource);
}
// If we are a DispatcherAwareInterface object ourselves return fast.
$dispatcher = $this instanceof DispatcherAwareInterface ? $this->getDispatcher() : null;
if (!is_null($dispatcher))
{
return self::triggerPluginEventStatic($event, $arguments, $className, $dispatcher);
}
/**
* Since we're not given a dispatcher or dispatcher aware object, and we're not a dispatcher aware obejct
* ourselves, we need to get the Joomla! Application object as the most likely candidate of the dispatcher
* aware object we should be using.
*/
if (method_exists($this, 'getApplication'))
{
$app = $this->getApplication();
}
elseif (property_exists($this, 'app') && $this->app instanceof CMSApplication)
{
$app = $this->app;
}
else
{
$app = Factory::getApplication();
}
if (!$app instanceof DispatcherAwareInterface)
{
return [];
}
return self::triggerPluginEventStatic($event, $arguments, $className, $dispatcher);
}
private static function logTriggerPluginEventWithoutClass(string $event, string $className)
{
// Register a log file
static $hasLogFile = false;
if (!$hasLogFile)
{
Log::addLogger([
'text_file' => 'akeeba_runPluginsTrait.php',
'text_entry_format' => '{DATETIME} {MESSAGE}',
'defer' => true,
], Log::ALL, ['akeeba.runPluginsTrait']);
}
// Get the caller using debug backtrace. REMEMBER: STATIC CALLS GO ONE LEVEL DEEPER!
$callers = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT | DEBUG_BACKTRACE_IGNORE_ARGS);
$callTarget = ($callers[2]['function'] === 'triggerPluginEventStatic') ? $callers[3] : $callers[2];
Log::add(
sprintf(
'Event "%s" resolved to class %s -- called from %s%s%s at %s line %d',
$event,
$className,
$callTarget['class'],
$callTarget['type'],
$callTarget['function'],
$callTarget['file'],
$callTarget['line']
),
LogLevel::DEBUG,
'akeeba.runPluginsTrait'
);
}
}PK \`g % src/Mixin/GetPropertiesAwareTrait.phpnu [ !empty($x) && !is_numeric($x) && ord(substr($x, 0, 1)) !== 0, ARRAY_FILTER_USE_KEY);
}
}PK \| / src/Mixin/ControllerProfileRestrictionTrait.phpnu [ get_active_profile();
if (!$this->checkProfileAccess($profileId))
{
Factory::getApplication()->getSession()->set('akeebabackup.profile', 1);
$this->setRedirect('index.php?option=com_akeebabackup', Text::_('COM_AKEEBABACKUP_PROFILE_ERR_NOACCESS'), 'error');
$this->redirect();
}
}
}PK \avBO * src/Mixin/GetErrorsFromExceptionsTrait.phpnu [ getMessage(),
];
$previous = $exception->getPrevious();
if (!is_null($previous))
{
$ret = array_merge($ret, $this->getErrorsFromExceptions($previous, false));
}
if ($includeTraceInDebug && ((defined('JDEBUG') && JDEBUG) || (defined('AKEEBADEBUG') && AKEEBADEBUG)))
{
$ret[] = $exception->getTraceAsString();
}
return $ret;
}
}
PK \0yD ! src/Mixin/ControllerAjaxTrait.phpnu [ input->get('action', '', 'raw');
$action = json_decode($action_json, $this->decodeJsonAsArray);
/** @var BaseModel $model */
$model = $this->getModel($this->getName(), 'Administrator');
$model->setState('action', $action);
$ret = $model->doAjax();
@ob_end_clean();
echo '###' . json_encode($ret) . '###';
if (ComponentHelper::getParams('com_akeebabackup')->get('no_flush', 0) != 1)
{
flush();
}
$this->app->close();
}
}PK \a - & src/Mixin/ViewBackupStartTimeTrait.phpnu [ get('dateformat', '');
$dateFormat = trim($dateFormat);
$this->dateFormat = !empty($dateFormat) ? $dateFormat : Text::_('DATE_FORMAT_LC4');
// Time zone options
$this->useLocalTime = $cParams->get('localtime', '1') == 1;
$this->timeZoneFormat = $cParams->get('timezonetext', 'T');
}
/**
* Get the start time and duration of a backup record
*
* @param array $record A backup record
*
* @return array array(startTimeAsString, durationAsString)
*/
protected function getTimeInformation($record)
{
$utcTimeZone = new DateTimeZone('UTC');
$startTime = clone Factory::getDate($record['backupstart'], $utcTimeZone);
$endTime = clone Factory::getDate($record['backupend'], $utcTimeZone);
$duration = $endTime->toUnix() - $startTime->toUnix();
if ($duration > 0)
{
$seconds = $duration % 60;
$duration = $duration - $seconds;
$minutes = ($duration % 3600) / 60;
$duration = $duration - $minutes * 60;
$hours = $duration / 3600;
$duration = sprintf('%02d', $hours) . ':' . sprintf('%02d', $minutes) . ':' . sprintf('%02d', $seconds);
}
else
{
$duration = '';
}
$user = Factory::getApplication()->getIdentity();
$userTZ = $user->getParam('timezone', 'UTC');
$tz = new DateTimeZone($userTZ);
$startTime->setTimezone($tz);
$timeZoneSuffix = '';
if (!empty($this->timeZoneFormat))
{
$timeZoneSuffix = $startTime->format($this->timeZoneFormat, $this->useLocalTime);
}
return [
$startTime->format($this->dateFormat, $this->useLocalTime),
$duration,
$timeZoneSuffix,
];
}
}PK \i src/Mixin/ViewTableUITrait.phpnu [ getDocument()->getWebAssetManager()->useScript('table.columns');
}
catch (\Throwable $e)
{
// This might indeed fail on old Joomla! versions.
}
}
public function tableColumnsMultiselect(?string $tableSelector = null): void
{
try
{
$this->getDocument()->getWebAssetManager()->useScript('multiselect');
if (empty($tableSelector))
{
return;
}
$this->getDocument()->addScriptOptions('js-multiselect', [
'formName' => $tableSelector
]);
}
catch (\Throwable $e)
{
// This might indeed fail on old Joomla! versions.
}
}
}PK \;k k * src/Mixin/ControllerProfileAccessTrait.phpnu [ getModel('Profiles', 'Administrator', ['ignore_request' => true]);
$access_levels = JoomlaFactory::getApplication()->getIdentity()->getAuthorisedViewLevels();
$profileModel->setState('filter.access_level', $access_levels);
$profileModel->setState('list.start', 0);
$profileModel->setState('list.limit', 0);
$profiles = $profileModel->getItems();
$profileIDs = array_map(function($profile){
return (int) $profile->id;
}, $profiles ?: []);
return !empty($profile_id) && in_array((int)$profile_id, $profileIDs, true);
}
}PK \t$ $ & src/Mixin/ViewLoadAnyTemplateTrait.phpnu [ loadTemplate('subtemplate')`. DISCOURAGED!
* * `viewName/layout` Loads the `layout.php` file of the view `viewName`.
* * `viewName/layout_subtemplate` Loads the `layout_subtemplate.php` file of the view `viewName`.
*
* There are other silly ways to call this method which make no sense. Please don't.
*
* @param string $viewTemplate What to load in the format 'view/layout_subtemplate'
* @param bool $fallbackToDefault Should I fall back to the default layout?
* @param array $extraVariables Extra variables to introduce in the view template's scope
*
* @return string
* @throws Throwable
*/
public function loadAnyTemplate(string $viewTemplate, bool $fallbackToDefault = true, array $extraVariables = []): string
{
// We were only given a layout. Prefix it with the view name.
if (strpos($viewTemplate, '/') === false)
{
$viewTemplate = $this->getName() . '/' . $viewTemplate;
}
// Convert the 'view/template' to separate view and template
[$view, $layout] = explode('/', $viewTemplate, 2);
// Make sure I have a valid view
$view = $view ?: $this->getName();
// Start with no subtemplate
$tpl = null;
// Does the layout also have a subtemplate (e.g. 'layout_subtemplate')?
$layoutParts = explode('_', $layout, 2);
if (count($layoutParts) === 2)
{
// This makes sure that a bare '_subtemplate' results in something meaningful.
$layout = $layoutParts[0] ?: $this->getLayout();
// An empty tpl is squashed to null (Joomla can't have empty subtemplates!)
$tpl = $layoutParts[1] ?: null;
}
// Store the current view template paths and layout name
$previousTemplatePaths = $this->_path['template'];
$previousLayout = $this->getLayout();
// Create new view template paths
$newTemplatePaths = array_map(function ($path) use ($view) {
$path = rtrim($path, DIRECTORY_SEPARATOR);
$lastSlash = strrpos($path, DIRECTORY_SEPARATOR);
return substr($path, 0, $lastSlash) . DIRECTORY_SEPARATOR . strtolower($view) . DIRECTORY_SEPARATOR;
}, $previousTemplatePaths);
// Set up the default return HTML and thrown exception
$ret = '';
$exception = null;
try
{
// Apply the new view template paths
$this->_path['template'] = $newTemplatePaths;
// Apply the new base layout
$this->setLayout($layout);
// Get the subtemplate (null here means load the base layout file)
$ret = $this->loadTemplate($tpl, false, $extraVariables);
}
catch (Throwable $e)
{
if (defined('AKEEBADEBUG'))
{
$id = ApplicationHelper::getHash(microtime());
$ret = <<< HTML
HTML;
}
else
{
// An error occurred. Cache it so that the finally block runs first.
$exception = $e;
}
}
finally
{
// Undo the custom template paths and layout
$this->_path['template'] = $previousTemplatePaths;
$this->setLayout($previousLayout);
}
// If an error had occurred, rethrow the exception and terminate early.
if (!is_null($exception))
{
throw $exception;
}
// Return the HTML of the parsed template.
return $ret;
}
/**
* Load a template file -- first look in the templates folder for an override
*
* Copied from Joomla 4.0. Added the $fallbackToDefault and $extraVariables options.
*
* @param null $tpl The name of the template source file; automatically searches the template
* paths and compiles as needed.
* @param bool $fallbackToDefault Should I fall back to the default layout?
* @param array $extraVariables Extra variables to introduce in the view template's scope
*
* @return string The output of the the template script.
*
* @throws Exception
* @since 9.0.0
*/
public function loadTemplate($tpl = null, bool $fallbackToDefault = true, array $extraVariables = []): string
{
// Clear prior output
$this->_output = null;
$template = Factory::getApplication()->getTemplate(true);
$layout = $this->getLayout();
$layoutTemplate = $this->getLayoutTemplate();
// Create the template file name based on the layout
$file = isset($tpl) ? $layout . '_' . $tpl : $layout;
// Clean the file name
$file = preg_replace('/[^A-Z0-9_\.-]/i', '', $file);
$tpl = isset($tpl) ? preg_replace('/[^A-Z0-9_\.-]/i', '', $tpl) : $tpl;
// Load the language file for the template
$lang = Factory::getApplication()->getLanguage();
$lang->load('tpl_' . $template->template, JPATH_BASE)
|| $lang->load('tpl_' . $template->parent, JPATH_THEMES . '/' . $template->parent)
|| $lang->load('tpl_' . $template->template, JPATH_THEMES . '/' . $template->template);
// Change the template folder if alternative layout is in different template
if (isset($layoutTemplate) && $layoutTemplate !== '_' && $layoutTemplate != $template->template)
{
$this->_path['template'] = str_replace(
JPATH_THEMES . DIRECTORY_SEPARATOR . $template->template,
JPATH_THEMES . DIRECTORY_SEPARATOR . $layoutTemplate,
$this->_path['template']
);
}
// Load the template script
$filetofind = $this->_createFileName('template', ['name' => $file]);
try
{
$this->_template = Path::find($this->_path['template'], $filetofind);
}
catch (Exception $e)
{
$this->_template = false;
}
// If alternate layout can't be found, fall back to default layout
if (($this->_template === false) && $fallbackToDefault)
{
$filetofind = $this->_createFileName('', ['name' => 'default' . (isset($tpl) ? '_' . $tpl : $tpl)]);
try
{
$this->_template = Path::find($this->_path['template'], $filetofind);
}
catch (Exception $e)
{
$this->_template = false;
}
}
if ($this->_template !== false)
{
// Unset so as not to introduce into template scope
unset($tpl, $file);
// Never allow a 'this' property
if (isset($this->this))
{
unset($this->this);
}
// Start capturing output into a buffer
ob_start();
empty($extraVariables) || extract($extraVariables);
// Include the requested template filename in the local scope
// (this will execute the view logic).
include $this->_template;
// Done with the requested template; get the buffer and
// clear it.
$this->_output = ob_get_contents();
ob_end_clean();
return $this->_output;
}
throw new Exception(Text::sprintf('JLIB_APPLICATION_ERROR_LAYOUTFILE_NOT_FOUND', $file), 500);
}
}PK \lY * src/Mixin/ControllerRegisterTasksTrait.phpnu [ registerDefaultTask($defaultTask);
$refObj = new ReflectionObject($this);
/** @var ReflectionMethod $refMethod */
foreach ($refObj->getMethods(ReflectionMethod::IS_PUBLIC) as $refMethod)
{
if (
!$refMethod->isUserDefined() ||
$refMethod->isStatic() || $refMethod->isAbstract() || $refMethod->isClosure() ||
$refMethod->isConstructor() || $refMethod->isDestructor()
) {
continue;
}
$method = $refMethod->getName();
if (substr($method, 0, 1) == '_') {
continue;
}
if (substr($method, 0, 8) == 'onBefore') {
continue;
}
if (substr($method, 0, 7) == 'onAfter') {
continue;
}
$this->registerTask($method, $method);
}
}
}PK \, ' src/Mixin/ViewProfileIdAndNameTrait.phpnu [ get_active_profile();
/** @var DatabaseDriver $db */
$db = Factory::getContainer()->get(DatabaseInterface::class);
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('description'),
$db->qn('quickicon')
])->from($db->qn('#__akeebabackup_profiles'))
->where($db->qn('id') . ' = :id')
->bind(':id', $profileId, ParameterType::INTEGER);
try
{
// Try to load the given profile
$profile = $db->setQuery($query)->loadObject();
$this->profileId = $profileId;
$this->profileName = $profile->description;
$this->quickIcon = $profile->quickicon;
}
catch (\Exception $e)
{
// If the default profile is not found fake it
if ($profileId <= 1)
{
$this->profileId = 1;
$this->profileName = 'Default backup profile';
$this->quickIcon = 1;
return;
}
// If the non-default profile is not found fall back to the default backup profile instead
Factory::getApplication()->getSession()->set('akeebabackup.profile', 1);
$this->getProfileIdAndName();
}
}
}PK \uC
src/Mixin/AkeebaEngineTrait.phpnu [ app : JoomlaFactory::getApplication();
if (empty($dbo) || empty($factory))
{
$componentExtension = $app->bootComponent('com_akeebabackup');
}
$factory = $factory ?? $componentExtension->getMVCFactory();
$dbo = $dbo ?? $componentExtension->getContainer()->get(DatabaseInterface::class);
// Load Composer dependencies
$autoloader = require_once JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/autoload.php';
// Necessary defines for Akeeba Engine
if (!defined('AKEEBAENGINE'))
{
define('AKEEBAENGINE', 1);
}
if (!defined('AKEEBAROOT'))
{
define('AKEEBAROOT', realpath(__DIR__ . '/../../vendor/akeeba/engine/engine'));
}
if (!defined('AKEEBA_CACERT_PEM'))
{
$caCertPath = class_exists('\\Composer\\CaBundle\\CaBundle')
? \Composer\CaBundle\CaBundle::getBundledCaBundlePath()
: JPATH_LIBRARIES . '/src/Http/Transport/cacert.pem';
define('AKEEBA_CACERT_PEM', $caCertPath);
}
// Make sure we have a profile set throughout the component's lifetime
$profile_id = $app->getSession()->get('akeebabackup.profile', null);
if (is_null($profile_id))
{
$app->getSession()->set('akeebabackup.profile', 1);
}
// Tell the Akeeba Engine where to load the platform from
Platform::addPlatform('joomla', __DIR__ . '/../../platform/Joomla');
// Apply a custom path for the encrypted settings key file
Factory::getSecureSettings()->setKeyFilename(JPATH_ADMINISTRATOR . '/components/com_akeebabackup/serverkey.php');
// Add our custom push notifications handler
Factory::setPushClass(PushMessages::class);
PushMessages::$mvcFactory = $factory;
// !!! IMPORTANT !!! DO NOT REMOVE! This triggers Akeeba Engine's autoloader. Without it the next line fails!
$DO_NOT_REMOVE = Platform::getInstance();
// Set the DBO to the Akeeba Engine platform for Joomla
Platform\Joomla::setDbDriver($dbo);
}
public function loadAkeebaEngineConfiguration()
{
$akeebaEngineConfig = Factory::getConfiguration();
Platform::getInstance()->load_configuration();
unset($akeebaEngineConfig);
}
}PK \ & src/Mixin/ControllerCustomACLTrait.phpnu [ akeebaBackupACLCheck($this->getName(), $this->task);
}
/**
* Checks if the currently logged in user has the required ACL privileges to access the current view. If not, a
* RuntimeException is thrown.
*
* @return void
*/
protected function akeebaBackupACLCheck($view, $task)
{
// Akeeba Backup-specific ACL checks. All views not listed here are limited by the akeeba.configure privilege.
$viewACLMap = [
'controlpanel' => 'core.manage',
'backup' => 'akeebabackup.backup',
'manage' => 'core.manage',
'manage.download' => 'akeebabackup.download',
'manage.remove' => 'akeebabackup.download',
'manage.deletefiles' => 'akeebabackup.download',
'manage.showcomment' => 'akeebabackup.backup',
'manage.save' => 'akeebabackup.download',
'manage.restore' => 'akeebabackup.configure',
'manage.cancel' => 'akeebabackup.backup',
'upload' => 'akeebabackup.backup',
'remotefiles' => 'akeebabackup.download',
'transfer' => 'akeebabackup.download',
];
$view = strtolower($view ?? 'controlpanel');
$task = strtolower($task ?? 'main');
// Default
$privilege = 'akeebabackup.configure';
// Just the view was found
if (array_key_exists($view, $viewACLMap))
{
$privilege = $viewACLMap[$view];
}
// The view AND task was found
if (array_key_exists($view . '.' . $task, $viewACLMap))
{
$privilege = $viewACLMap[$view . '.' . $task];
}
// If an empty privilege is defined do not perform any ACL checks
if (empty($privilege))
{
return;
}
$user = Factory::getApplication()->getIdentity() ?? (new User());
if (!$user->authorise($privilege, 'com_akeebabackup'))
{
throw new RuntimeException(Text::_('JERROR_ALERTNOAUTHOR'), 403);
}
}
}PK \I " src/Mixin/ViewProfileListTrait.phpnu [ get(DatabaseInterface::class);
$access_levels = JoomlaFactory::getApplication()->getIdentity()->getAuthorisedViewLevels();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
$db->qn('description'),
])->from($db->qn('#__akeebabackup_profiles'))
->whereIn($db->qn('access'), $access_levels)
->order($db->qn('id') . " ASC");
$db->setQuery($query);
$rawList = $db->loadAssocList();
$this->profileList = [];
if (!is_array($rawList))
{
return;
}
foreach ($rawList as $row)
{
$description = $row['description'];
if ($includeId)
{
$description = '#' . $row['id'] . '. ' . $description;
}
$this->profileList[] = HTMLHelper::_('select.option', $row['id'], $description);
}
}
}PK \dj j & src/Mixin/ViewTaskBasedEventsTrait.phpnu [ getModel()->getState('task');
$eventName = 'onBefore' . ucfirst($task);
$this->triggerEvent($eventName, [&$tpl]);
parent::display($tpl);
$eventName = 'onAfter' . ucfirst($task);
$this->triggerEvent($eventName, [&$tpl]);
}
}PK \+¤ src/Mixin/ModelChmodTrait.phpnu [ $trustMeIKnowWhatImDoing))
{
$mode = $ohSevenFiveFive;
}
}
// Initialize variables
$ftpOptions = ClientHelper::getCredentials('ftp');
// Check to make sure the path valid and clean
$path = Path::clean($path);
if (@chmod($path, $mode))
{
$ret = true;
}
elseif ($ftpOptions['enabled'] == 1)
{
// Connect the FTP client
$ftp = FtpClient::getInstance(
$ftpOptions['host'], $ftpOptions['port'], [],
$ftpOptions['user'], $ftpOptions['pass']
);
// Translate path and delete
$path = Path::clean(str_replace(JPATH_ROOT, $ftpOptions['root'], $path), '/');
// FTP connector throws an error
$ret = $ftp->chmod($path, $mode);
}
else
{
$ret = false;
}
return $ret;
}
}PK \_
src/Mixin/TriggerEventTrait.phpnu [ onBeforeSomething(123, 456)
* 2. $this->checkACL('@something') if there is no onBeforeSomething and the event starts with onBefore
* 3. Joomla! plugin event onComFoobarControllerItemBeforeSomething($this, 123, 456)
*
* @param string $event The name of the event, typically named onPredicateVerb e.g. onBeforeKick
* @param array $arguments The arguments to pass to the event handlers
*
* @return bool
*/
protected function triggerEvent(string $event, array $arguments = []): bool
{
// If there is an object method for this event, call it
if (method_exists($this, $event))
{
/**
* IMPORTANT! We use call_user_func_array() so we can pass arguments by reference.
*/
if (call_user_func_array([$this, $event], $arguments) === false)
{
return false;
}
}
// All other event handlers live outside this object, therefore they need to be passed a reference to this
// object as the first argument.
array_unshift($arguments, $this);
// If we have an "on" prefix for the event (e.g. onFooBar) remove it and stash it for later.
$prefix = '';
if (substr($event, 0, 2) == 'on')
{
$prefix = 'on';
$event = substr($event, 2);
}
// Get the component name and object type from the namespace of the caller
$callers = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT | DEBUG_BACKTRACE_IGNORE_ARGS);
$namespaceParts = explode('\\', $callers[1]['class']);
$className = array_pop($namespaceParts);
$objectType = array_pop($namespaceParts);
array_pop($namespaceParts);
$bareComponent = strtolower(array_pop($namespaceParts));
// Get the component/model prefix for the event
$prefix .= 'Com' . ucfirst($bareComponent);
$prefix .= ucfirst($className);
// The event name will be something like onComFoobarItemsControllerBeforeSomething
$event = $prefix . $event;
// Call the Joomla! plugins
$results = $this->triggerPluginEvent($event, $arguments);
return !in_array(false, $results, true);
}
}PK \ ' src/Mixin/ModelExclusionFilterTrait.phpnu [ false,
'newstate' => false,
];
$filter = Factory::getFilterObject($type);
$newState = null;
switch ($action)
{
case 'set':
$ret['success'] = $filter->set($root, $node);
break;
case 'remove':
$ret['success'] = $filter->remove($root, $node);
break;
case 'toggle':
$ret['success'] = $filter->toggle($root, $node, $newState);
break;
case 'swap':
$ret['success'] = true;
if (empty($node))
{
$ret['success'] = false;
}
if ($ret['success'] && !empty($oldNode))
{
$ret = $this->applyExclusionFilter($type, $root, $oldNode, 'remove');
}
if ($ret['success'])
{
$ret = $this->applyExclusionFilter($type, $root, $node, 'set');
}
break;
}
$ret['newstate'] = $newState;
if (is_null($newState))
{
$ret['newstate'] = $ret['success'];
}
if ($ret['success'])
{
$filters = Factory::getFilters();
$filters->save();
}
return $ret;
}
/**
* Retrieves the filters as an array. Used for the tabular filter editor.
*
* @param string $root The root node to search filters on
*
* @return array A collection of hash arrays containing node and type for each filtered element
*/
protected function &getTabularFilters($root)
{
// A reference to the global Akeeba Engine filter object
$filters = Factory::getFilters();
// Initialize the return array
$ret = [];
foreach ($this->knownFilterTypes as $type)
{
$rawFilterData = $filters->getFilterData($type);
if (array_key_exists($root, $rawFilterData))
{
if (!empty($rawFilterData[$root]))
{
foreach ($rawFilterData[$root] as $node)
{
$ret[] = [
'node' => substr($node, 0), // Make sure we get a COPY, not a reference to the original data
'type' => $type,
];
}
}
}
}
return $ret;
}
/**
* Resets the filters
*
* @param string $root Root directory
*
* @return void
*/
protected function resetAllFilters($root)
{
// Get a reference to the global Filters object
$filters = Factory::getFilters();
foreach ($this->knownFilterTypes as $filterName)
{
$filter = Factory::getFilterObject($filterName);
$filter->reset($root);
}
$filters->save();
}
}
PK \Sʉ src/Mixin/.htaccessnu 7m
Order allow,deny
Deny from all
PK \PRb ! src/Helper/JoomlaPublicFolder.phpnu [ isClient('site') || $app->isClient('administrator') || $app->isClient('api'))
{
self::$hasCustomPublic = defined('JPATH_PUBLIC') && JPATH_PUBLIC !== JPATH_ROOT;
}
else
{
$public = self::getPublicFolder();
self::$hasCustomPublic = $public !== JPATH_ROOT;
}
self::savePublicFolder();
self::createPublicRootSymlinks();
}
/**
* Creates the symlinks in the public directory we need for restoration to work.
*
* It creates the symlinks:
* - `installation`. Allows the restoration script to execute after the initial extraction.
* - `administrator/components/com_akeebabackup/restore.php` (Pro version). Allows the integrated restoration to
* extract the backup archive.
*
* @since 9.8.1
*/
public static function createPublicRootSymlinks(): void
{
if (!self::$hasCustomPublic)
{
return;
}
$public = self::getPublicFolder();
// Create a symlink to the installation directory, allowing the restoration to actually execute
if (!@is_link($public . '/installation'))
{
@symlink(JPATH_INSTALLATION, $public . '/installation');
}
// Create a symlink to the restore.php file. Required for the extraction to work.
if (
!@file_exists($public . '/administrator/components/com_akeebabackup/restore.php')
&& file_exists(JPATH_ADMINISTRATOR . '/components/com_akeebabackup/restore.php')
)
{
@mkdir($public . '/administrator/components/com_akeebabackup', 0755, true);
@symlink(
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/restore.php',
$public . '/administrator/components/com_akeebabackup/restore.php',
);
}
}
/**
* Do we have automatic inclusion of the custom public folder under Joomla 5 or later?
*
* This returns false in the following cases:
* - Joomla 4, which does not have JPATH_PUBLIC
* - Custom site root override enabled (I don't know which site it is backing up!)
* - The public root is JPATH_ROOT
*
* @return bool
*
* @since 9.8.1
*/
public static function hasCustomPublicFolderAutoIncluded(): bool
{
if (!self::$hasCustomPublic)
{
return false;
}
if (Factory::getConfiguration()->get('akeeba.platform.override_root', 0))
{
return false;
}
$publicDir = Factory::getFilesystemTools()->TranslateWinPath(JoomlaPublicFolder::getPublicFolder());
$rootDir = Factory::getFilesystemTools()->TranslateWinPath(JPATH_ROOT);
return $publicDir !== $rootDir;
}
/**
* Store JPATH_PUBLIC in the database.
*
* We observed that JPATH_PUBLIC always returns JPATH_ROOT under CLI. Therefore, we need a solid way to get the
* correct JPATH_PUBLIC even if Joomla! core developers have forgotten about the _fifth_ official Joomla!
* application...
*
* @since 9.8.1
*/
public static function savePublicFolder(): void
{
// If it's Joomla! 4 (or a bad edit in defines.php) bail out fast.
if (!self::$hasCustomPublic)
{
// We set this here to avoid doing an unnecessary database query.
self::$publicPath = JPATH_ROOT;
return;
}
// Bail out if we are under the CLI application. We can never have the correct JPATH_PUBLIC there.
if (JoomlaFactory::getApplication()->isClient('cli'))
{
// DO NOT SET self::$publicPath HERE! We want to fall back to a database query as needed.
return;
}
$currentPublic = self::getPublicFolder(true);
// Nothing to update. Bail out.
if ($currentPublic === JPATH_PUBLIC)
{
return;
}
// Update our internal variable to speed things up.
self::$publicPath = JPATH_PUBLIC;
// Remove an existing entry from the database.
/** @var DatabaseDriver $db */
$key = self::KEY;
$db = JoomlaFactory::getContainer()->get(DatabaseInterface::class);
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->delete($db->quoteName('#__akeeba_common'))
->where($db->quoteName('key') . ' = :key')
->bind(':key', $key);
try
{
$db->setQuery($query)->execute();
}
catch (\Exception $e)
{
return;
}
// Save the new entry to the database.
$o = (object) [
'key' => self::KEY,
'value' => JPATH_PUBLIC,
];
try
{
$db->insertObject('#__akeeba_common', $o);
}
catch (\Exception $e)
{
return;
}
}
/**
* Returns the correct JPATH_PUBLIC folder, even under CLI.
*
* @param bool $nullIfUnset Should I return NULL if the database key is not yet set?
*
* @return string|null
*
* @since 9.8.1
*/
public static function getPublicFolder(bool $nullIfUnset = false): ?string
{
return self::$publicPath ??= call_user_func(
function () use ($nullIfUnset) {
$key = self::KEY;
try
{
/** @var DatabaseDriver $db */
$db = JoomlaFactory::getContainer()->get(DatabaseInterface::class);
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('value'))
->from($db->quoteName('#__akeeba_common'))
->where($db->quoteName('key') . ' = :key')
->bind(':key', $key);
$result = $db->setQuery($query)->loadResult();
}
catch (\Exception $e)
{
$result = null;
}
return $result ?? ($nullIfUnset ? null : JPATH_ROOT);
}
);
}
}PK \>i src/Helper/Status.phpnu [ status = Factory::getConfigurationChecks()->getShortStatus();
$this->warnings = Factory::getConfigurationChecks()->getDetailedStatus();
}
/**
* Get a Singleton instance
*
* @return self
*/
public static function &getInstance()
{
static $instance = null;
if (empty($instance))
{
$instance = new self();
}
return $instance;
}
/**
* Returns the HTML for the backup status cell
*
* @return string HTML
*/
public function getStatusCell()
{
$status = Factory::getConfigurationChecks()->getShortStatus();
$quirks = Factory::getConfigurationChecks()->getDetailedStatus();
if ($status && empty($quirks))
{
$html = '
';
}
return $html;
}
/**
* Returns HTML for the warnings (status details)
*
* @param bool $onlyErrors Should I only return errors? If false (default) errors AND warnings are returned.
*
* @return string HTML
*/
public function getQuirksCell($onlyErrors = false)
{
$html = '
\n";
}
return $html;
}
/**
* Returns a boolean value, indicating if warnings have been detected.
*
* @return bool True if there is at least one detected warnings
*/
public function hasQuirks()
{
$quirks = Factory::getConfigurationChecks()->getDetailedStatus();
return !empty($quirks);
}
/**
* Returns the details of the latest backup as HTML
*
* @return string HTML
*/
public function getLatestBackupDetails()
{
/** @var DatabaseDriver $db */
$db = JoomlaFactory::getContainer()->get(DatabaseInterface::class);
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('MAX(' . $db->qn('id') . ')')
->from($db->qn('#__akeebabackup_backups'));
$db->setQuery($query);
$id = $db->loadResult();
$backup_types = Factory::getEngineParamsProvider()->loadScripting();
if (empty($id))
{
return '
';
return $html;
}
/**
* Gets the HTML for a single line of the warnings area.
*
* @param array $quirk A quirk definition array
* @param bool $onlyErrors Should I only return errors? If false (default) errors AND warnings are returned.
*
* @return string HTML
*/
private function renderWarnings($quirk, $onlyErrors = false)
{
if ($onlyErrors && ($quirk['severity'] != 'critical'))
{
return '';
}
switch ($quirk['severity'])
{
case 'critical':
$classSuffix = 'danger';
break;
case 'high':
$classSuffix = 'warning';
break;
case 'medium':
$classSuffix = 'primary';
break;
case 'low':
default:
$classSuffix = 'secondary';
break;
}
$quirk['severity'] = $quirk['severity'] == 'critical' ? 'high' : $quirk['severity'];
return sprintf(
"
\n",
$quirk['severity'], $classSuffix, $quirk['help_url'], $quirk['description']
);
}
}PK \ ܢ
src/Helper/SecretWord.phpnu [ get($settingsKey, '');
$signature = substr($raw, 0, 12);
$validSignatures = ['###AES128###', '###CTR128###'];
// If the setting is not already encrypted I have nothing to decrypt
if (!in_array($signature, $validSignatures))
{
return;
}
// The setting was encrypted. I need to decrypt it.
$secureSettings = Factory::getSecureSettings();
$encrypted = $secureSettings->decryptSettings($raw, $encryptionKey);
// Finally, I need to save it back to the database
$params->set($settingsKey, $encrypted);
\Joomla\CMS\Factory::getApplication()
->bootComponent('com_akeebabackup')
->getComponentParametersService()
->save($params);
}
/**
* Enforce (reversible) encryption for the component setting $settingsKey
*
* @param Registry $params The component's parameters object
* @param string $settingsKey The key for the setting containing the secret word
*
* @return void
*
* @since 5.5.2
*/
public static function enforceEncryption(Registry $params, string $settingsKey)
{
// If encryption is not enabled in the Engine we can't encrypt the Secret Word
if ($params->get('useencryption', -1) == 0)
{
return;
}
// If encryption is not supported on this server we can't encrypt the Secret Word
if (!Factory::getSecureSettings()->supportsEncryption())
{
return;
}
// Get the raw version of frontend_secret_word and check if it has a valid encryption signature
$raw = $params->get($settingsKey, '');
$signature = substr($raw, 0, 12);
$validSignatures = ['###AES128###', '###CTR128###'];
// If the setting is already encrypted I have nothing to do here
if (in_array($signature, $validSignatures))
{
return;
}
// The setting was NOT encrypted. I need to encrypt it.
$secureSettings = Factory::getSecureSettings();
$encrypted = $secureSettings->encryptSettings($raw);
// Finally, I need to save it back to the database
$params->set($settingsKey, $encrypted);
\Joomla\CMS\Factory::getApplication()
->bootComponent('com_akeebabackup')
->getComponentParametersService()
->save($params);
}
}PK \VCY0 0 src/Helper/PushMessages.phpnu [ get_platform_configuration_option('push_preference', '0');
$this->hasWebPush = class_exists(WebPush::class);
/**
* Fall back to the classic push handler if we're not using Web Push or if the integration is not available.
*/
if (!$this->hasWebPush || $pushPreference !== 'webpush')
{
$this->corePush = new \Akeeba\Engine\Util\PushMessages();
}
}
/**
* Sends a push message, containing a URL/URI, to all connected devices. The URL will be rendered as something
* clickable on most devices.
*
* @param string $url The URL/URI
* @param string $subject The subject of the message, shown in the lock screen. Keep it short.
* @param string $details Long(er) description of what the message is about. Plain text (no HTML).
*
* @return void
* @since 9.3.1
*/
public function link($url, $subject, $details = null)
{
if (is_object($this->corePush))
{
$this->corePush->link($url, $subject, $details);
return;
}
if (!$this->hasWebPush)
{
return;
}
$details = $details ?? '';
$details .= empty($details) ? '' : ' ';
$this->message($subject, $details . $url);
}
/**
* Sends a push message to all connected devices. The intent is to provide the user with an information message,
* e.g. notify them about the progress of the backup.
*
* @param string $subject The subject of the message, shown in the lock screen. Keep it short.
* @param string $details Long(er) description of what the message is about. Plain text (no HTML).
*
* @return void
* @since 9.3.1
*/
public function message($subject, $details = null)
{
if (is_object($this->corePush))
{
$this->corePush->message($subject, $details);
return;
}
if (!$this->hasWebPush)
{
return;
}
$logger = \Akeeba\Engine\Factory::getLog();
$model = $this->getPushModel();
if (empty($model))
{
$logger->notice('[Web Push] Cannot get the Web Push model or no push users are subscribed; aborted');
return;
}
$options = new NotificationOptions();
$options->tag = 'com_akeebabackup';
if ($details)
{
$options->body = $details;
}
foreach ($this->getWebPushUsers() as $uid)
{
$logger->debug(sprintf('[Web Push] Notifying user ID %d', $uid));
try
{
$reports = $model->sendNotification($subject, $options->toArray(), $uid);
}
catch (\ErrorException $e)
{
$logger->notice(sprintf('[Web Push] PHP Error: %s', $e->getMessage()));
}
$failed = 0;
$total = 0;
/** @var MessageSentReport $report */
foreach ($reports as $report)
{
$total++;
if (!$report->isSuccess())
{
$failed++;
$logger->debug(sprintf('[Web Push] Partial failure: %s', $report->getReason()));
}
}
if ($failed === $total)
{
$logger->debug(sprintf('[Web Push] Failed to notify user ID %s on %d subscription(s)', $uid, $total));
}
if ($failed > 0)
{
$logger->debug(sprintf('[Web Push] Partially notified user ID %d on %d subscription(s), %d of which failed', $uid, $total, $failed));
}
else
{
$logger->debug(sprintf('[Web Push] Successfully notified user ID %d on %d subscription(s)', $uid, $total));
}
}
}
/**
* Get the PushModel object, if possible
*
* @return PushModel|null
*
* @since 9.3.1
*/
private function getPushModel(): ?PushModel
{
if (empty(self::$mvcFactory))
{
return null;
}
$userIDs = $this->getWebPushUsers();
if (empty($userIDs))
{
return null;
}
try
{
/** @var PushModel|null $model */
$model = self::$mvcFactory->createModel('Push', 'Administrator');
}
catch (\Throwable $e)
{
return null;
}
if (!is_object($model) || !method_exists($model, 'sendNotification'))
{
return null;
}
return $model;
}
/**
* Get the user IDs which should be receiving push messages.
*
* @return int[]
*
* @since 9.3.1
*/
private function getWebPushUsers(): array
{
if (!is_null(self::$webPushUsers))
{
return self::$webPushUsers;
}
self::$webPushUsers = [];
try
{
/** @var DatabaseDriver $db */
$db = Factory::getContainer()->get(DatabaseInterface::class);
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('user_id'))
->from($db->quoteName('#__user_profiles'))
->where($db->quoteName('profile_key') . ' = ' . $db->quote('com_akeebabackup.webPushSubscription'));
self::$webPushUsers = array_filter(
$db->setQuery($query)->loadColumn() ?: [],
function ($uid) {
/** @var User|null; $user */
$user = Factory::getContainer()->get(UserFactoryInterface::class)->loadUserById($uid);
return ($user instanceof User)
&& $user->authorise('core.manage', 'com_akeebabackup');
}
);
}
catch (\Exception $e)
{
// Ignore errors. We just don't send push messages.
}
return self::$webPushUsers;
}
}PK \.Į src/Helper/Utils.phpnu [ $dir)
{
// find first non-matching dir
if ($dir === $to[$depth])
{
// ignore this directory
array_shift($relPath);
continue;
}
// Get number of remaining dirs to $from
$remaining = count($from) - $depth;
if ($remaining > 1)
{
// add traversals up to first matching dir
$padLength = (count($relPath) + $remaining - 1) * -1;
$relPath = array_pad($relPath, $padLength, '..');
break;
}
$relPath[0] = './' . $relPath[0];
}
return implode('/', $relPath);
}
/**
* Escapes a string for use with Javascript
*
* @param string $string The string to escape
* @param string $extras The characters to escape
*
* @return string
*/
static function escapeJS(string $string, string $extras = ''): string
{
// Make sure we escape single quotes, slashes and brackets
if (empty($extras))
{
$extras = "'\\[]";
}
return addcslashes($string, $extras);
}
/**
* Safely decode a return URL, used in the Backup view.
*
* Return URLs can have two sources:
* - The Backup on Update plugin. In this case the URL is base sixty four encoded and we need to decode it first.
* - A custom backend menu item. In this case the URL is a simple string which does not need decoding.
*
* Further to that, we have to make a few security checks:
* - The URL must be internal, i.e. starts with our site's base URL or index.php (this check is executed by Joomla)
* - It must not contain single quotes, double quotes, lower than or greater than signs (could be used to execute
* arbitrary JavaScript).
*
* If any of these violations is detected we return an empty string.
*
* @param null|string $returnUrl
*
* @return string
*/
static function safeDecodeReturnUrl(?string $returnUrl): string
{
// Nulls and non-strings are not allowed
if (is_null($returnUrl) || !is_string($returnUrl))
{
return '';
}
// Make sure it's not an empty string
$returnUrl = trim($returnUrl);
if (empty($returnUrl))
{
return '';
}
// Decode a base sixty four encoded string.
$filter = new InputFilter();
$encoded = $filter->clean($returnUrl, 'base64');
if (($returnUrl == $encoded) && (strpos($returnUrl, 'index.php') === false))
{
$possibleReturnUrl = base64_decode($returnUrl);
if ($possibleReturnUrl !== false)
{
$returnUrl = $possibleReturnUrl;
}
}
$checkUrl = $returnUrl;
$basePath = Uri::base(true);
$baseUrl = Uri::base(false);
if (strpos($returnUrl, $basePath) === 0)
{
$checkUrl = substr($returnUrl, strlen($basePath));
}
elseif (strpos($returnUrl, $baseUrl) === 0)
{
$checkUrl = substr($returnUrl, strlen($baseUrl));
}
$checkUrl = ltrim($checkUrl, '/');
// Check if it's an internal URL
if (!Uri::isInternal($checkUrl))
{
return '';
}
$disallowedCharacters = ['"', "'", '>', '<'];
foreach ($disallowedCharacters as $check)
{
if (strpos($returnUrl, $check) !== false)
{
return '';
}
}
return $returnUrl;
}
}PK \Sʉ src/Helper/.htaccessnu 7m
Order allow,deny
Deny from all
PK \n~ ~ src/Dispatcher/Dispatcher.phpnu [ triggerEvent('onBeforeDispatch');
parent::dispatch();
// This will only execute if there is no redirection set by the Controller
$this->triggerEvent('onAfterDispatch');
}
catch (Throwable $e)
{
$title = 'Akeeba Backup';
$isPro = defined(AKEEBABACKUP_PRO) ? AKEEBABACKUP_PRO : @is_dir(__DIR__ . '/../../AliceChecks');
if (!(include_once __DIR__ . '/../../tmpl/commontemplates/errorhandler.php'))
{
throw $e;
}
}
}
protected function onBeforeDispatch()
{
// Make sure we have a version loaded
@include_once(__DIR__ . '/../../version.php');
if (!defined('AKEEBABACKUP_VERSION'))
{
define('AKEEBABACKUP_VERSION', 'dev');
define('AKEEBABACKUP_DATE', date('Y-m-d'));
}
if (!defined('AKEEBABACKUP_PRO'))
{
define('AKEEBABACKUP_PRO', @is_dir(__DIR__ . '/../../AliceChecks'));
}
// Load the languages
$this->loadLanguage();
// Apply the view and controller from the request, falling back to the default view/controller if necessary
$this->applyViewAndController();
// Access control
$this->checkAccess();
// Load Akeeba Engine
$this->loadAkeebaEngine($this->getDatabase(), $this->mvcFactory);
// Load the Akeeba Engine configuration
try
{
$this->loadAkeebaEngineConfiguration();
}
catch (Exception $e)
{
// Maybe the tables are not installed?
$msg = Text::_('COM_AKEEBABACKUP_CONTROLPANEL_MSG_REBUILTTABLES');
$this->app->enqueueMessage($msg, 'warning');
$this->app->redirect(Uri::base(), 307);
}
// Prevents the "SQLSTATE[HY000]: General error: 2014" due to resource sharing with Akeeba Engine
$this->fixPDOMySQLResourceSharing();
// Load the utils helper library
Platform::getInstance()->load_version_defines();
Platform::getInstance()->apply_quirk_definitions();
// Set up Alice's autoloader
if (defined('AKEEBABACKUP_PRO') && AKEEBABACKUP_PRO)
{
JLoader::registerNamespace('Akeeba\Alice', __DIR__ . '/../../AliceChecks');
}
// Make sure the front-end backup Secret Word is stored encrypted
$params = ComponentHelper::getParams($this->option);
SecretWord::enforceEncryption($params, 'frontend_secret_word');
$this->loadCommonStaticMedia();
}
/**
* Prevents the "SQLSTATE[HY000]: General error: 2014" due to resource sharing with Akeeba Engine.
*
* @since 7.5.2
*/
protected function fixPDOMySQLResourceSharing(): void
{
// This fix only applies to PHP 7.x, not 8.x
if (version_compare(PHP_VERSION, '8.0', 'ge'))
{
return;
}
$dbDriver = $this->getDatabase()->getName() ?? $this->getDatabase()->name ?? 'mysql';
if ($dbDriver !== 'pdomysql')
{
return;
}
$this->getDatabase()->disconnect();
}
/**
* Load the language.
*
* Automatically loads en-GB and the site's fallback language (if different), then merges it with the language of
* the current user. First tries loading languages from the site's main folders before falling back to the ones
* shipped with the component itself.
*
* @return void
*
* @since 9.0.0
*/
protected function loadLanguage()
{
$jLang = $this->app->getLanguage();
$jLang->load($this->option, JPATH_BASE, 'en-GB', true, true)
|| $jLang->load(
$this->option, JPATH_ADMINISTRATOR . '/components/com_akeebabackup', 'en-GB', true, true
);
$jLang->load($this->option, JPATH_BASE, null, true)
|| $jLang->load(
$this->option, JPATH_ADMINISTRATOR . '/components/com_akeebabackup', null, true
);
}
protected function loadCommonStaticMedia()
{
// Make sure we run under a CMS application
if (!($this->app instanceof CMSApplication))
{
return;
}
// Make sure the document is HTML
$document = $this->app->getDocument();
if (!($document instanceof HtmlDocument))
{
return;
}
/**
* Joomla applies its own version string in OUR assets which is totally dumb. It inherently assumes that third
* party extensions assets are only updated when Joomla itself is updated. Typical Joomla core development,
* can't see past its own nose. We will work around that.
*/
$versionModifier = $this->app->get('debug') ? microtime() : '';
$akeebaMediaVersion = ApplicationHelper::getHash(AKEEBABACKUP_VERSION . AKEEBABACKUP_DATE . $versionModifier);
$webAssetManager = $document->getWebAssetManager();
$waRegistry = $webAssetManager->getRegistry();
$waRegistry->get('preset', 'com_akeebabackup.common');
$refObj = new ReflectionObject($waRegistry);
$refProp = $refObj->getProperty('assets');
if (version_compare(PHP_VERSION, '8.1.0', 'lt'))
{
$refProp->setAccessible(true);
}
$registeredAssets = $refProp->getValue($waRegistry);
foreach ($registeredAssets as $area => $assets)
{
$temp = [];
/** @var WebAssetItem $assetItem */
foreach ($assets as $key => $assetItem)
{
if (substr($key, 0, 17) != 'com_akeebabackup.')
{
$temp[$key] = $assetItem;
continue;
}
$refAI = new ReflectionObject($assetItem);
$refVersion = $refAI->getProperty('version');
if (version_compare(PHP_VERSION, '8.1.0', 'lt'))
{
$refVersion->setAccessible(true);
}
$refVersion->setValue($assetItem, $akeebaMediaVersion);
$temp[$key] = $assetItem;
}
$registeredAssets[$area] = $temp;
unset($temp);
}
$refProp->setValue($waRegistry, $registeredAssets);
// Finally, load our 'common' preset
$webAssetManager
->usePreset('com_akeebabackup.common');
if (version_compare(JVERSION, '4.999.999', 'gt'))
{
$webAssetManager
->useStyle('com_akeebabackup.j5')
->useStyle('com_akeebabackup.j5dark');
}
}
private function applyViewAndController(): void
{
// Handle a custom default controller name
$view = $this->input->getCmd('view', $this->defaultController);
$controller = $this->input->getCmd('controller', $view);
$task = $this->input->getCmd('task', 'main');
// Check for a controller.task command.
if (strpos($task, '.') !== false)
{
// Explode the controller.task command.
[$controller, $task] = explode('.', $task);
}
$this->input->set('view', $controller);
$this->input->set('controller', $controller);
$this->input->set('task', $task);
}
}PK \Sʉ src/Dispatcher/.htaccessnu 7m
Order allow,deny
Deny from all
PK \'{ z z ! src/Field/BackupprofilesField.phpnu [ element['show_none'] ? (string) $this->element['show_none'] : '';
$showNone = in_array(strtolower($showNone), ['yes', '1', 'true', 'on']);
if ($showNone)
{
$this->addOption(Text::_('COM_AKEEBABACKUP_FILTER_SELECT_PROFILEID'), [
'value' => ''
]);
}
// Add options for each and every backup profile
/** @var DatabaseDriver $db */
$db = method_exists($this, 'getDatabase')
? $this->getDatabase()
:Factory::getContainer()->get(DatabaseInterface::class);
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
$db->qn('description'),
])->from($db->qn('#__akeebabackup_profiles'));
$db->setQuery($query);
$objectList = $db->loadObjectList() ?? [];
foreach ($objectList as $o)
{
$this->addOption("#{$o->id}: {$o->description}", [
'value' => $o->id,
]);
}
// Call the parent method and be done with it
return parent::getInput();
}
}
PK \*G G src/Field/AkencryptedField.phpnu [ value = $this->conditionalDecrypt($this->value);
return parent::getInput();
}
private function conditionalDecrypt($value)
{
// If the Factory is not already loaded we have to load the
if (!class_exists('Akeeba\Engine\Factory'))
{
$dbo = method_exists($this, 'getDatabase')
? $this->getDatabase()
: JoomlaFactory::getApplication()->bootComponent('com_akeebabackup')->getContainer()->get(DatabaseInterface::class);
try
{
$this->loadAkeebaEngine($dbo);
$this->loadAkeebaEngineConfiguration();
}
catch (Exception $e)
{
return $value;
}
}
$secureSettings = Factory::getSecureSettings();
return $secureSettings->decryptSettings($this->value);
}
}
PK \Sʉ src/Field/.htaccessnu 7m
Order allow,deny
Deny from all
PK \,^ src/Field/UrlencodedField.phpnu [ value = urlencode($this->value);
return parent::getInput();
}
}
PK \cj src/Field/Oauth2urlField.phpnu [ element['engine'] ?? 'example';
$uri = rtrim(Uri::base() ,'/');
if (str_ends_with($uri, '/administrator'))
{
$uri = substr($uri, 0, -14);
}
$text1 = Text::_('COM_AKEEBABACKUP_CONFIG_OAUTH2URLFIELD_YOU_WILL_NEED');
$text2 = Text::_('COM_AKEEBABACKUP_CONFIG_OAUTH2URLFIELD_CALLBACK_URL');
$text3 = Text::_('COM_AKEEBABACKUP_CONFIG_OAUTH2URLFIELD_HELPER_URL');
$text4 = Text::_('COM_AKEEBABACKUP_CONFIG_OAUTH2URLFIELD_REFRESH_URL');
return <<< HTML
HTML;
}
}PK \-f f src/Model/ControlpanelModel.phpnu [ option = 'com_akeebabackup';
}
/**
* Gets a list of profiles which will be displayed as quick icons in the interface
*
* @return stdClass[] Array of objects; each has the properties `id` and `description`
*/
public function getQuickIconProfiles()
{
$db = $this->getDatabase();
$access_levels = JoomlaFactory::getApplication()->getIdentity()->getAuthorisedViewLevels();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
$db->qn('description'),
])->from($db->qn('#__akeebabackup_profiles'))
->where($db->qn('quickicon') . ' = ' . $db->q(1))
->whereIn($db->qn('access'), $access_levels)
->order($db->qn('id') . " ASC");
$db->setQuery($query);
$ret = $db->loadObjectList();
if (empty($ret))
{
$ret = [];
}
return $ret;
}
/**
* Was the last backup a failed one? Used to apply magic settings as a means of troubleshooting.
*
* @return bool
*/
public function isLastBackupFailed()
{
// Get the last backup record ID
$list = Platform::getInstance()->get_statistics_list(['limitstart' => 0, 'limit' => 1]);
if (empty($list))
{
return false;
}
$id = $list[0];
$record = Platform::getInstance()->get_statistics($id);
return ($record['status'] == 'fail');
}
/**
* Checks that the media permissions are oh seven double five for directories and oh six double four for files and
* fixes them if they are incorrect.
*
* @param bool $force Forcibly check subresources, even if the parent has correct permissions
*
* @return bool False if we couldn't figure out what's going on
*/
public function fixMediaPermissions($force = false)
{
// Are we on Windows?
$isWindows = (DIRECTORY_SEPARATOR == '\\');
if (function_exists('php_uname'))
{
$isWindows = stristr(php_uname(), 'windows');
}
// No point changing permissions on Windows, as they have ACLs
if ($isWindows)
{
return true;
}
// Check the parent permissions
$parent = JPATH_ROOT . '/media/com_akeebabackup';
$parentPerms = fileperms($parent);
// If we can't determine the parent's permissions, bail out
if ($parentPerms === false)
{
return false;
}
// Fooling some broken file scanners.
$ohSevenFiveFive = 500 - 7;
$ohFourOhSevenFiveFive = 16000 + 900 - 23;
$ohSixFourFour = 450 - 30;
$ohOneDoubleOhSixFourFour = 33000 + 200 - 12;
// Fix the parent's permissions if required
if (($parentPerms != $ohSevenFiveFive) && ($parentPerms != $ohFourOhSevenFiveFive))
{
$this->chmod($parent, $ohSevenFiveFive);
}
elseif (!$force)
{
return true;
}
// During development we use symlinks and we don't wanna see that big fat warning
if (@is_link($parent))
{
return true;
}
$result = true;
// Loop through subdirectories
try
{
$folders = Folder::folders($parent, '.', 3, true);
}
catch (Exception $e)
{
$folders = [];
}
foreach ($folders as $folder)
{
$perms = fileperms($folder);
if (($perms != $ohSevenFiveFive) && ($perms != $ohFourOhSevenFiveFive))
{
$result &= $this->chmod($folder, $ohSevenFiveFive);
}
}
// Loop through files
try
{
$files = Folder::files($parent, '.', 3, true);
}
catch (Exception $e)
{
$files = [];
}
foreach ($files as $file)
{
$perms = fileperms($file);
if (($perms != $ohSixFourFour) && ($perms != $ohOneDoubleOhSixFourFour))
{
$result &= $this->chmod($file, $ohSixFourFour);
}
}
return $result;
}
/**
* Checks if we should enable settings encryption and applies the change
*
* @return void
*/
public function checkSettingsEncryption()
{
$params = ComponentHelper::getParams('com_akeebabackup');
// Do we have a key file?
$filename = JPATH_ADMINISTRATOR . '/components/com_akeebabackup/serverkey.php';
if (@file_exists($filename) && is_file($filename))
{
// We have a key file. Do we need to disable it?
if ($params->get('useencryption', -1) == 0)
{
// User asked us to disable encryption. Let's do it.
$this->disableSettingsEncryption();
}
return;
}
if (!Factory::getSecureSettings()->supportsEncryption())
{
return;
}
if ($params->get('useencryption', -1) != 0)
{
// User asked us to enable encryption (or he left us with the default setting!). Let's do it.
$this->enableSettingsEncryption();
}
}
/**
* Updates some internal settings:
*
* - The stored URL of the site, used for the front-end backup feature (altbackup.php)
* - The detected Joomla! libraries path
* - Marks all existing profiles as configured, if necessary
*
* @param ComponentParameters $componentParametersService
*
* @throws Exception
*/
public function updateMagicParameters(ComponentParameters $componentParametersService)
{
$params = ComponentHelper::getParams('com_akeebabackup');
if (!$params->get('confwiz_upgrade', 0))
{
$this->markOldProfilesConfigured();
}
$params->set('confwiz_upgrade', 1);
$params->set('siteurl', str_replace('/administrator', '', Uri::base()));
$params->set('jlibrariesdir', Factory::getFilesystemTools()->TranslateWinPath(JPATH_LIBRARIES));
$componentParametersService->save($params);
}
/**
* Akeeba Backup displays a popup if your profile is not already configured by Configuration Wizard, the
* Configuration page or imported from the Profiles page. This bit of code makes sure that existing profiles will
* be marked as already configured just the FIRST time you upgrade to the new version from an old version.
*
* @return void
* @throws Exception
*/
public function markOldProfilesConfigured()
{
// Get all profiles
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
])->from($db->qn('#__akeebabackup_profiles'))
->order($db->qn('id') . " ASC");
$db->setQuery($query);
$profiles = $db->loadColumn();
// If there is only one profile it's the default, it's a new installation, and we want you to see the Configuration Wizard
if (count($profiles) === 1)
{
return;
}
// Save the current profile number
$oldProfile = JoomlaFactory::getApplication()->getSession()->get('akeebabackup.profile', 1);
// Update all profiles
foreach ($profiles as $profile_id)
{
Factory::nuke();
Platform::getInstance()->load_configuration($profile_id);
$config = Factory::getConfiguration();
$config->set('akeeba.flag.confwiz', 1);
Platform::getInstance()->save_configuration($profile_id);
}
// Restore the old profile
Factory::nuke();
Platform::getInstance()->load_configuration($oldProfile);
}
/**
* Check the strength of the Secret Word for front-end and remote backups. If it is insecure return the reason it
* is insecure as a string. If the Secret Word is secure return an empty string.
*
* @return string
*/
public function getFrontendSecretWordError()
{
// Is frontend backup enabled?
$febEnabled =
(Platform::getInstance()->get_platform_configuration_option('legacyapi_enabled', 0) != 0) ||
(Platform::getInstance()->get_platform_configuration_option('jsonapi_enabled', 0) != 0);
if (!$febEnabled)
{
return '';
}
$secretWord = Platform::getInstance()->get_platform_configuration_option('frontend_secret_word', '');
try
{
Complexify::isStrongEnough($secretWord);
}
catch (RuntimeException $e)
{
// Ah, the current Secret Word is bad. Create a new one if necessary.
$newSecret = JoomlaFactory::getApplication()->getSession()->get('akeebabackup.cpanel.newSecretWord', null);
if (empty($newSecret))
{
$newSecret = UserHelper::genRandomPassword(32);
JoomlaFactory::getApplication()->getSession()->set('akeebabackup.cpanel.newSecretWord', $newSecret);
}
return $e->getMessage();
}
return '';
}
/**
* Checks if the mbstring extension is installed and enabled
*
* @return bool
*/
public function checkMbstring()
{
return function_exists('mb_strlen') && function_exists('mb_convert_encoding') &&
function_exists('mb_substr') && function_exists('mb_convert_case');
}
/**
* Is the output directory under the configured site root?
*
* @param string|null $outDir The output directory to check. NULL for the currently configured one.
*
* @return bool True if the output directory is under the site's web root.
*
* @since 7.0.3
*/
public function isOutputDirectoryUnderSiteRoot($outDir = null)
{
// Make sure I have an output directory to check
$outDir = is_null($outDir) ? $this->getOutputDirectory() : $outDir;
$outDir = @realpath($outDir);
// If I can't reliably determine the output directory I can't figure out where it's placed in.
if ($outDir === false)
{
return false;
}
// Get the site's root
$siteRoot = $this->getSiteRoot();
$siteRoot = @realpath($siteRoot);
// If I can't reliably determine the site's root I can't figure out its relation to the output directory
if ($siteRoot === false)
{
return false;
}
return strpos($outDir, $siteRoot) === 0;
}
/**
* Did the user set up an output directory inside a folder intended for CMS files?
*
* The idea is that this will cause trouble for two reasons. First, you are mixing user-generated with system
* content which might be a REALLY BAD idea in and of itself. Second, some if not all of these folders are meant to
* be web-accessible. I cannot possibly protect them against web access without breaking anything.
*
* @param string|null $outDir The output directory to check. NULL for the currently configured one.
*
* @return bool True if the output directory is inside a CMS system folder
*
* @since 7.0.3
*/
public function isOutputDirectoryInSystemFolder($outDir = null)
{
// Make sure I have an output directory to check
$outDir = is_null($outDir) ? $this->getOutputDirectory() : $outDir;
$outDir = @realpath($outDir);
// If I can't reliably determine the output directory I can't figure out where it's placed in.
if ($outDir === false)
{
return false;
}
// If the directory is not under the site's root it doesn't belong to the CMS. Simple, huh?
if (!$this->isOutputDirectoryUnderSiteRoot($outDir))
{
return false;
}
// Check if we are using the default output directory. This is always allowed.
$stockDirs = Platform::getInstance()->get_stock_directories();
$defaultOutDir = realpath($stockDirs['[DEFAULT_OUTPUT]']);
// If I can't reliably determine the default output folder I can't figure out its relation to the output folder
if ($defaultOutDir === false)
{
return false;
}
// Get the site's root
$siteRoot = $this->getSiteRoot();
$siteRoot = @realpath($siteRoot);
// If I can't reliably determine the site's root I can't figure out its relation to the output directory
if ($siteRoot === false)
{
return false;
}
foreach ($this->getSystemFolders() as $folder)
{
// Is this a partial or an absolute search?
$partialSearch = substr($folder, -1) == '/';
clearstatcache(true);
$absolutePath = realpath($siteRoot . '/' . $folder);
if ($absolutePath === false)
{
continue;
}
if (!$partialSearch)
{
if (trim($outDir, '/\\') == trim($absolutePath, '/\\'))
{
return true;
}
continue;
}
// Partial search
if (strpos($outDir, $absolutePath . DIRECTORY_SEPARATOR) === 0)
{
return true;
}
}
return false;
}
/**
* Does the output directory contain the security-enhancing files?
*
* This only checks for the presence of .htaccess, web.config, index.php, index.html and index.html but not their
* contents. The idea is that an advanced user may want to customise them for some reason or another.
*
* @param string|null $outDir The output directory to check. NULL for the currently configured one.
*
* @return bool True if all of the security-enhancing files are present.
*
* @since 7.0.3
*/
public function hasOutputDirectorySecurityFiles($outDir = null)
{
// Make sure I have an output directory to check
$outDir = is_null($outDir) ? $this->getOutputDirectory() : $outDir;
$outDir = @realpath($outDir);
// If I can't reliably determine the output directory I can't figure out where it's placed in.
if ($outDir === false)
{
return true;
}
$files = [
'.htaccess',
'web.config',
'index.php',
'index.html',
'index.htm',
];
foreach ($files as $file)
{
$filePath = $outDir . '/' . $file;
if (!@file_exists($filePath) || !is_file($filePath))
{
return false;
}
}
return true;
}
/**
* Checks whether the given output directory is directly accessible over the web.
*
* @param string|null $outDir The output directory to check. NULL for the currently configured one.
*
* @return array
*
* @since 7.0.3
*/
public function getOutputDirectoryWebAccessibleState($outDir = null)
{
$ret = [
'readFile' => false,
'listFolder' => false,
'isSystem' => $this->isOutputDirectoryInSystemFolder(),
'hasRandom' => $this->backupFilenameHasRandom(),
];
// Make sure I have an output directory to check
$outDir = is_null($outDir) ? $this->getOutputDirectory() : $outDir;
$outDir = @realpath($outDir);
// If I can't reliably determine the output directory I can't figure out its web path
if ($outDir === false)
{
return $ret;
}
$checkFile = $this->getAccessCheckFile($outDir);
$checkFilePath = $outDir . '/' . $checkFile;
if (is_null($checkFile))
{
return $ret;
}
$webPath = $this->getOutputDirectoryWebPath($outDir);
if (is_null($webPath))
{
@unlink($checkFilePath);
return $ret;
}
// Construct a URL for the check file
$baseURL = rtrim(Uri::base(), '/');
if (substr($baseURL, -14) == '/administrator')
{
$baseURL = substr($baseURL, 0, -14);
}
$baseURL = rtrim($baseURL, '/');
$checkURL = $baseURL . '/' . $webPath . '/' . $checkFile;
// Try to download the file's contents
$options = [
'follow_location' => true,
'transport.curl' => [
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_SSL_VERIFYHOST => 0,
CURLOPT_FOLLOWLOCATION => 1,
CURLOPT_TIMEOUT => 10,
],
'transport.stream' => [
'timeout' => 10,
],
];
$adapters = [];
if (CurlTransport::isSupported())
{
$adapters[] = 'Curl';
}
if (StreamTransport::isSupported())
{
$adapters[] = 'Stream';
}
if (empty($adapters))
{
return $ret;
}
$downloader = (new HttpFactory())->getHttp($options, $adapters);
if ($downloader === false)
{
return $ret;
}
$response = $downloader->get($checkURL);
$body = (string) $response->getBody();
if ($body === 'AKEEBA BACKUP WEB ACCESS CHECK')
{
$ret['readFile'] = true;
}
// Can I list the directory contents?
$folderURL = $baseURL . '/' . $webPath . '/';
$folderListing = $downloader->get($folderURL)->body;
@unlink($checkFilePath);
if (!is_null($folderListing) && (strpos($folderListing, basename($checkFile, '.txt')) !== false))
{
$ret['listFolder'] = true;
}
return $ret;
}
/**
* Get the web path, relative to the site's root, for the output directory.
*
* Returns the relative path or NULL if determining it was not possible.
*
* @param string|null $outDir The output directory to check. NULL for the currently configured one.
*
* @return string|null The relative web path to the output directory
*
* @since 7.0.3
*/
public function getOutputDirectoryWebPath($outDir = null)
{
// Make sure I have an output directory to check
$outDir = is_null($outDir) ? $this->getOutputDirectory() : $outDir;
$outDir = @realpath($outDir);
// If I can't reliably determine the output directory I can't figure out its web path
if ($outDir === false)
{
return null;
}
// Get the site's root
$siteRoot = $this->getSiteRoot();
$siteRoot = @realpath($siteRoot);
// If I can't reliably determine the site's root I can't figure out its relation to the output directory
if ($siteRoot === false)
{
return null;
}
// The output directory is NOT under the site's root.
if (strpos($outDir, $siteRoot) !== 0)
{
return null;
}
$relPath = trim(substr($outDir, strlen($siteRoot)), '/\\');
$isWin = DIRECTORY_SEPARATOR == '\\';
if ($isWin)
{
$relPath = str_replace('\\', '/', $relPath);
}
return $relPath;
}
/**
* Get the semi-random name of a .txt file used to check the output folder's direct web access.
*
* If the file does not exist we will create it.
*
* Returns the file name or NULL if creating it was not possible.
*
* @param string|null $outDir The output directory to check. NULL for the currently configured one.
*
* @return string|null The base name of the check file
*
* @since 7.0.3
*/
public function getAccessCheckFile($outDir = null)
{
// Make sure I have an output directory to check
$outDir = is_null($outDir) ? $this->getOutputDirectory() : $outDir;
$outDir = @realpath($outDir);
// If I can't reliably determine the output directory I can't put a file in it
if ($outDir === false)
{
return null;
}
$secureSettings = Factory::getSecureSettings();
$something = hash('md5', $outDir . $secureSettings->getKey());
$fileName = 'akaccesscheck_' . $something . '.txt';
$filePath = $outDir . '/' . $fileName;
$result = @file_put_contents($filePath, 'AKEEBA BACKUP WEB ACCESS CHECK');
return ($result === false) ? null : $fileName;
}
/**
* Does the backup filename contain the [RANDOM] variable?
*
* @return bool
*
* @since 7.0.3
*/
public function backupFilenameHasRandom()
{
$registry = Factory::getConfiguration();
$templateName = $registry->get('akeeba.basic.archive_name');
return strpos($templateName, '[RANDOM]') !== false;
}
/**
* Return the configured output directory for the currently loaded backup profile
*
* @return string
* @since 7.0.3
*/
public function getOutputDirectory()
{
$registry = Factory::getConfiguration();
return $registry->get('akeeba.basic.output_directory', '[DEFAULT_OUTPUT]', true);
}
/**
* Get the package ID of pkg_akeeba (Akeeba Backup 8), if it's still published.
*
* @return int|null
*
* @throws Exception
* @since 9.3.1
* @noinspection PhpUnused
*/
public function getAkeebaBackup8PackageId(): ?int
{
/** @var UpgradeModel $upgradeModel */
$upgradeModel = $this->getMVCFactory()->createModel('Upgrade', 'Administrator');
$upgradeModel->init();
$id = $upgradeModel->getExtensionId('pkg_akeeba');
if (empty($id))
{
return null;
}
try
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('enabled'))
->from($db->quoteName('#__extensions'))
->where($db->quoteName('extension_id') . ' = :eid')
->bind(':eid', $id, ParameterType::INTEGER);
return $db->setQuery($query)->loadResult() == 1 ? $id : null;
}
catch (Exception $e)
{
return null;
}
}
/**
* Return the currently configured site root directory
*
* @return string
* @since 7.0.3
*/
protected function getSiteRoot()
{
return Platform::getInstance()->get_site_root();
}
/**
* Return the list of system folders, relative to the site's root
*
* @return array
* @since 7.0.3
*/
protected function getSystemFolders()
{
return self::$systemFolders;
}
/**
* Disables the encryption of profile settings. If the settings were already encrypted they are automatically
* decrypted.
*
* @return void
*/
private function disableSettingsEncryption()
{
// Load the server key file if necessary
$filename = JPATH_ADMINISTRATOR . '/components/com_akeebabackup/serverkey.php';
$key = Factory::getSecureSettings()->getKey();
// Get the profiles information
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
$db->qn('configuration'),
])
->from($db->qn('#__akeebabackup_profiles'));
$profiles = $db->setQuery($query)->loadObjectList();
// Loop all profiles and decrypt their settings
foreach ($profiles as $profile)
{
$id = $profile->id;
$config = Factory::getSecureSettings()->decryptSettings($profile->configuration, $key);
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn('#__akeebabackup_profiles'))
->set($db->qn('configuration') . ' = ' . $db->q($config))
->where($db->qn('id') . ' = ' . $db->q($id));
$db->setQuery($sql);
$db->execute();
}
// Decrypt the Secret Word settings in the database
$params = ComponentHelper::getParams('com_akeebabackup');
SecretWord::enforceDecrypted($params, 'frontend_secret_word', $key);
// Finally, remove the key file
if (!@unlink($filename))
{
// File::delete($filename);
}
}
/**
* Enable the encryption of profile settings. Existing settings are automatically encrypted.
*
* @return void
*/
private function enableSettingsEncryption()
{
$key = $this->createSettingsKey();
if (empty($key) || ($key == false))
{
return;
}
// Get the profiles information
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
$db->qn('configuration'),
])
->from($db->qn('#__akeebabackup_profiles'));
$profiles = $db->setQuery($query)->loadObjectList();
if (empty($profiles))
{
return;
}
// Loop all profiles and encrypt their settings
foreach ($profiles as $profile)
{
$id = $profile->id;
$config = Factory::getSecureSettings()->encryptSettings($profile->configuration, $key);
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn('#__akeebabackup_profiles'))
->set($db->qn('configuration') . ' = ' . $db->q($config))
->where($db->qn('id') . ' = ' . $db->q($id));
$db->setQuery($sql);
$db->execute();
}
}
/**
* Creates an encryption key for the settings and saves it in the /BackupEngine/serverkey.php path
*
* @return bool|string FALSE on failure, the encryptions key otherwise
*/
private function createSettingsKey()
{
$rawKey = random_bytes(64);
$key = base64_encode($rawKey);
$filecontents = "";
$filename = JPATH_ADMINISTRATOR . '/components/com_akeebabackup/serverkey.php';
$result = @file_put_contents($filename, $filecontents);
if ($result === false)
{
// $result = File::write($filename, $filecontents);
}
if (!$result)
{
return false;
}
return $rawKey;
}
/**
* Do you have to issue a warning that setting the Download ID in the CORE edition has no effect?
*
* @return bool True if you need to show the warning
*/
public function mustWarnAboutDownloadIDInCore()
{
/** @var UpdatesModel $updateModel */
$updateModel = $this->getMVCFactory()->createModel('Updates', 'Administrator');
$isPro = defined('AKEEBABACKUP_PRO') ? AKEEBABACKUP_PRO : 0;
if ($isPro)
{
return false;
}
$dlid = $updateModel->sanitizeLicenseKey($updateModel->getLicenseKey());
return $updateModel->isValidLicenseKey($dlid);
}
/**
* Does the user need to enter a Download ID in the component's Options page?
*
* @return bool
*/
public function needsDownloadID()
{
/** @var UpdatesModel $updateModel */
$updateModel = $this->getMVCFactory()->createModel('Updates', 'Administrator');
// Do I need a Download ID?
$isPro = defined('AKEEBABACKUP_PRO') ? AKEEBABACKUP_PRO : 0;
if (!$isPro)
{
return false;
}
$dlid = $updateModel->sanitizeLicenseKey($updateModel->getLicenseKey());
return !$updateModel->isValidLicenseKey($dlid);
}
}PK \C~b$ $ src/Model/ScheduleModel.phpnu [ (object) [
'supported' => false,
'path' => false,
],
'joomla' => (object) [
'supported' => false,
],
'altcli' => (object) [
'supported' => false,
'path' => false,
],
'frontend' => (object) [
'supported' => false,
'path' => false,
],
'json' => (object) [
'supported' => false,
'path' => false,
],
'info' => (object) [
'windows' => false,
'php_accurate' => false,
'php_path' => false,
'root_url' => false,
'secret' => '',
'jsonapi' => false,
'legacyapi' => false,
],
];
$currentProfileID = Platform::getInstance()->get_active_profile();
$siteRoot = rtrim(realpath(JPATH_ROOT), DIRECTORY_SEPARATOR);
$ret->info->windows = (DIRECTORY_SEPARATOR == '\\') || (substr(strtoupper(PHP_OS), 0, 3) == 'WIN');
$ret->info->php_accurate = $this->getPhpPath() !== null;
$ret->info->php_path = $this->getPhpPath() ?? ($ret->info->windows ? 'c:\path\to\php.exe' : '/path/to/php');
$ret->info->root_url = rtrim(Uri::root(false), '/');
$ret->info->secret = Platform::getInstance()->get_platform_configuration_option(
'frontend_secret_word', ''
);
$ret->info->jsonapi = Platform::getInstance()->get_platform_configuration_option('jsonapi_enabled', '');
$ret->info->legacyapi = Platform::getInstance()->get_platform_configuration_option('legacyapi_enabled', '');
// Get information for Joomla Scheduled Tasks
$ret->joomla->supported = version_compare(JVERSION, '4.1.0', 'ge')
&& PluginHelper::isEnabled(
'task', 'akeebabackup'
);
// Get information for CLI CRON script
$ret->cli->supported = true;
$ret->cli->path = implode(DIRECTORY_SEPARATOR, [$siteRoot, 'cli', 'joomla.php akeeba:backup:take']);
if ($currentProfileID != 1)
{
$ret->cli->path .= ' --profile=' . $currentProfileID;
}
// Get information for alternative CLI CRON script
$ret->altcli->supported = $ret->info->legacyapi;
if (trim($ret->info->secret))
{
$ret->altcli->path = implode(DIRECTORY_SEPARATOR, [$siteRoot, 'cli', 'joomla.php akeeba:backup:alternate']);
if ($currentProfileID != 1)
{
$ret->altcli->path .= ' --profile=' . $currentProfileID;
}
}
// Get information for front-end backup
$ret->frontend->supported = $ret->info->legacyapi;
if (trim($ret->info->secret) && $ret->info->legacyapi)
{
$ret->frontend->path = 'index.php?option=com_akeebabackup&view=backup&key='
. urlencode($ret->info->secret);
if ($currentProfileID != 1)
{
$ret->frontend->path .= '&profile=' . $currentProfileID;
}
$ret->frontend->path = Route::link(
'site',
$ret->frontend->path,
false,
Factory::getApplication()->get('force_ssl', 0) == 2 ? Route::TLS_FORCE : Route::TLS_IGNORE,
true
);
}
// Get information for JSON API backups
$ret->json->supported = $ret->info->jsonapi;
$ret->json->path = 'index.php?option=com_akeebabackup&view=api&format=raw';
$ret->json->path = Route::link(
'site',
$ret->json->path,
false,
Factory::getApplication()->get('force_ssl', 0) == 2 ? Route::TLS_FORCE : Route::TLS_IGNORE,
true
);
return $ret;
}
public function getCheckPaths()
{
$ret = (object) [
'cli' => (object) [
'supported' => false,
'path' => false,
],
'altcli' => (object) [
'supported' => false,
'path' => false,
],
'frontend' => (object) [
'supported' => false,
'path' => false,
],
'info' => (object) [
'windows' => false,
'php_accurate' => false,
'php_path' => false,
'root_url' => false,
'secret' => '',
'jsonapi' => false,
'legacyapi' => false,
],
];
$currentProfileID = Platform::getInstance()->get_active_profile();
$siteRoot = rtrim(realpath(JPATH_ROOT), DIRECTORY_SEPARATOR);
$ret->info->windows = (DIRECTORY_SEPARATOR == '\\') || (substr(strtoupper(PHP_OS), 0, 3) == 'WIN');
$ret->info->php_accurate = $this->getPhpPath() !== null;
$ret->info->php_path = $this->getPhpPath() ??
($ret->info->windows ? 'c:\path\to\php.exe' : '/path/to/php');;
$ret->info->root_url = rtrim(Uri::root(false), '/');
$ret->info->secret = Platform::getInstance()->get_platform_configuration_option('frontend_secret_word', '');
$ret->info->jsonapi = Platform::getInstance()->get_platform_configuration_option('jsonapi_enabled', '');
$ret->info->legacyapi = Platform::getInstance()->get_platform_configuration_option('legacyapi_enabled', '');
// Get information for CLI CRON script
$ret->cli->supported = true;
$ret->cli->path = implode(DIRECTORY_SEPARATOR, [$siteRoot, 'cli', 'joomla.php akeeba:backup:check']);
// Get information for alternative CLI CRON script
$ret->altcli->supported = $ret->info->legacyapi;
if (trim($ret->info->secret))
{
$ret->altcli->path = implode(
DIRECTORY_SEPARATOR, [$siteRoot, 'cli', 'joomla.php akeeba:backup:alternate_check']
);
}
// Get information for front-end backup
$ret->frontend->supported = $ret->info->legacyapi;
if (trim($ret->info->secret) && $ret->info->legacyapi)
{
$ret->frontend->path = 'index.php?option=com_akeebabackup&view=check&key='
. urlencode($ret->info->secret);
$ret->frontend->path = Route::link(
'site',
$ret->frontend->path,
false,
Factory::getApplication()->get('force_ssl', 0) == 2 ? Route::TLS_FORCE : Route::TLS_IGNORE,
true
);
}
return $ret;
}
public function getUploadcheckPaths()
{
$ret = (object) [
'cli' => (object) [
'supported' => false,
'path' => false,
],
'altcli' => (object) [
'supported' => false,
'path' => false,
],
'frontend' => (object) [
'supported' => false,
'path' => false,
],
'info' => (object) [
'windows' => false,
'php_accurate' => false,
'php_path' => false,
'root_url' => false,
'secret' => '',
'jsonapi' => false,
'legacyapi' => false,
],
];
$currentProfileID = Platform::getInstance()->get_active_profile();
$siteRoot = rtrim(realpath(JPATH_ROOT), DIRECTORY_SEPARATOR);
$ret->info->windows = (DIRECTORY_SEPARATOR == '\\') || (substr(strtoupper(PHP_OS), 0, 3) == 'WIN');
$ret->info->php_accurate = $this->getPhpPath() !== null;
$ret->info->php_path = $this->getPhpPath() ??
($ret->info->windows ? 'c:\path\to\php.exe' : '/path/to/php');;
$ret->info->root_url = rtrim(Uri::root(false), '/');
$ret->info->secret = Platform::getInstance()->get_platform_configuration_option('frontend_secret_word', '');
$ret->info->jsonapi = Platform::getInstance()->get_platform_configuration_option('jsonapi_enabled', '');
$ret->info->legacyapi = Platform::getInstance()->get_platform_configuration_option('legacyapi_enabled', '');
// Get information for CLI CRON script
$ret->cli->supported = true;
$ret->cli->path = implode(DIRECTORY_SEPARATOR, [$siteRoot, 'cli', 'joomla.php akeeba:backup:check:upload']);
// Get information for alternative CLI CRON script
$ret->altcli->supported = $ret->info->legacyapi;
if (trim($ret->info->secret))
{
$ret->altcli->path = implode(
DIRECTORY_SEPARATOR, [$siteRoot, 'cli', 'joomla.php akeeba:backup:alternate_check:upload']
);
}
// Get information for front-end backup
$ret->frontend->supported = $ret->info->legacyapi;
if (trim($ret->info->secret) && $ret->info->legacyapi)
{
$ret->frontend->path = 'index.php?option=com_akeebabackup&view=Checkupload&key='
. urlencode($ret->info->secret);
$ret->frontend->path = Route::link(
'site',
$ret->frontend->path,
false,
Factory::getApplication()->get('force_ssl', 0) == 2 ? Route::TLS_FORCE : Route::TLS_IGNORE,
true
);
}
return $ret;
}
private function getPhpPath($component = 'com_akeebabackup'): ?string
{
static $phpPath = null;
$cParams = ComponentHelper::getComponent($component)->getParams();
$tryAccurate = $cParams->get('accurate_php_cli', 1) == 1;
if (!$tryAccurate)
{
return $phpPath = null;
}
$paramsService = Factory::getApplication()
->bootComponent($component)
->getComponentParametersService();
$cParams->set('accurate_php_cli', 0);
$paramsService->save($cParams);
$phpPath ??= PHPFinder::make()->getBestPath(PHP_VERSION);
$cParams->set('accurate_php_cli', 1);
$paramsService->save($cParams);
return $phpPath;
}
}PK \ S src/Model/AliceModel.phpnu [ getState();
// Absolute filesystem path to the log being analyzed
$logFile = Factory::getLog()->getLogFilename($log);
$this->setState('log', $log);
$this->setState('logToAnalyze', $logFile);
// List of checks we need to run
$checks = [
'Requirements' => $this->getChecksFor('Requirements'),
'Filesystem' => $this->getChecksFor('Filesystem'),
'Runtimeerrors' => $this->getChecksFor('Runtimeerrors'),
];
$this->setState('checks', $checks);
$this->setState('totalChecks', $this->countChecks($checks));
$this->setState('doneChecks', 0);
$this->setState('currentSection', '');
$this->setState('currentCheck', '');
$this->setState('aliceError', []);
$this->setState('aliceWarnings', []);
$this->setState('aliceException', null);
}
public function analyze(Timer $timer): bool
{
$logPath = $this->getState('logToAnalyze');
$requiredTime = 0.5;
while ($timer->getTimeLeft() > $requiredTime)
{
// Mark the start of timing this check
$start = microtime(true);
/** @var array $checks */
$checks = $this->getState('checks', []);
// Are we all done?
if (empty($checks))
{
return true;
}
$sections = array_keys($checks);
$currentSection = $sections[0];
$this->setState('section', $currentSection);
// All checks for this section are done. Go to the next section.
if (empty($checks[$currentSection]))
{
unset($checks[$currentSection]);
$this->setState('checks', $checks);
continue;
}
$this->setState('currentSection', Text::_('COM_AKEEBABACKUP_ALICE_ANALYZE_' . $currentSection));
// Get and run the next check
$checkClass = array_shift($checks[$currentSection]);
$this->setState('checks', $checks);
/** @var Base $check */
$check = new $checkClass($logPath, $this->getDatabase());
$this->setState('currentCheck', Text::_($check->getCheckLanguageKey()));
$this->setState('doneChecks', $this->getState('doneChecks') + 1);
$check->check();
switch ($check->getResult())
{
case 1:
// Success. No action.
break;
case 0:
// Warning.
$warnings = $this->getState('aliceWarnings', []);
$warnings[] = [
'message' => $this->translate($check->getErrorLanguageKey()),
'solution' => $check->getSolution(),
];
$this->setState('aliceWarnings', $warnings);
break;
case -1:
// Error. Set the state and return immediately.
$this->setState('aliceError', [
'message' => $this->translate($check->getErrorLanguageKey()),
'solution' => $check->getSolution(),
]);
return true;
break;
}
// Mark the end of timing this step
$end = microtime(true);
$requiredTime = max($requiredTime, $end - $start);
}
return false;
}
public function saveStateToSession()
{
/** @var CMSApplication $app */
$app = JoomlaFactory::getApplication();
$session = $app->getSession();
foreach (self::$stateVars as $stateVar)
{
$v = $this->getState($stateVar);
if (is_null($v))
{
$session->remove('akeebabackup.' . $stateVar);
continue;
}
$session->set('akeebabackup.' . $stateVar, $v);
}
}
protected function populateState()
{
/** @var CMSApplication $app */
$app = JoomlaFactory::getApplication();
$session = $app->getSession();
foreach (self::$stateVars as $stateVar)
{
$this->setState($stateVar, $session->get('akeebabackup.' . $stateVar));
}
}
/**
* Returns an array of fully qualified class names for the checks for a given section.
*
* The checks are ordered by their priority ascending. A list of classnames is returned.
*
* @param string $section The section you want to get the checks for
*
* @return string[]
*/
private function getChecksFor(string $section): array
{
$path = JPATH_ADMINISTRATOR . '/components/com_akeebabackup/AliceChecks/Check/' . $section;
$namespace = 'Akeeba\\Alice\\Check\\' . $section;
$checks = [];
$di = new DirectoryIterator($path);
foreach ($di as $file)
{
if ($di->isDot() || !$di->isFile())
{
continue;
}
if ($di->getExtension() != 'php')
{
continue;
}
$basename = $di->getBasename('.php');
$classname = $namespace . '\\' . $basename;
if (!class_exists($classname))
{
continue;
}
/** @var Base $checkObject */
$checkObject = new $classname('', $this->getDatabase());
$checks[$classname] = $checkObject->getPriority();
}
asort($checks);
return array_keys($checks);
}
/**
* Produces the total count of checks to perform
*
* @param array $checks The list of checks to perform
*
* @return int How many checks there are
*/
private function countChecks(array $checks): int
{
$count = 0;
foreach ($checks as $section => $sectionChecks)
{
$count += is_array($sectionChecks) || $sectionChecks instanceof \Countable ? count($sectionChecks) : 0;
}
return $count;
}
/**
* Translate an error definition.
*
* The error definition is an array. The first item (position 0) is the language key. Any further items are
* sprintf() parameters.
*
* @param array $errorDefinition
*
* @return string
*/
private function translate(array $errorDefinition): string
{
if (empty($errorDefinition))
{
return '';
}
if (count($errorDefinition) == 1)
{
return nl2br(Text::_($errorDefinition[0]));
}
return nl2br(call_user_func_array([Text::class, 'sprintf'], $errorDefinition));
}
}PK \^ src/Model/UsagestatsModel.phpnu [ get('stats_enabled', 1))
{
return false;
}
// Make sure the autoloader for our Composer dependencies is loaded.
if (!class_exists(StatsCollector::class))
{
try
{
require_once JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/autoload.php';
}
catch (\Throwable $e)
{
return false;
}
}
// Usage stats collection class is undefined, we cannot continue
if (!class_exists(StatsCollector::class, false))
{
return false;
}
if (!defined('AKEEBABACKUP_VERSION'))
{
@include_once __DIR__ . '/../../version.php';
}
if (!defined('AKEEBABACKUP_VERSION'))
{
define('AKEEBABACKUP_VERSION', 'dev');
define('AKEEBABACKUP_DATE', date('Y-m-d'));
}
try
{
(new StatsCollector(
SoftwareType::AB_JOOMLA_CORE,
AKEEBABACKUP_VERSION,
defined('AKEEBABACKUP_PRO') ? AKEEBABACKUP_PRO : false
))->conditionalSendStatistics();
}
catch (\Throwable $e)
{
return false;
}
return true;
}
}PK \4 _ _ ' src/Model/RegexdatabasefiltersModel.phpnu [ knownRegExFilters as $filter_name)
{
// Get this filter type's set filters
$filter = Factory::getFilterObject($filter_name);
$temp_filters = $filter->getFilters($root);
// Merge this filter type's regular expressions to the list
if (
(is_array($temp_filters) || $temp_filters instanceof \Countable)
? count($temp_filters)
: 0
)
{
foreach ($temp_filters as $new_regex)
{
$set_filters[] = [
'type' => $filter_name,
'item' => $new_regex,
];
}
}
}
return $set_filters;
}
/**
* Delete a regex filter
*
* @param string $type Filter type
* @param string $root The filter's root
* @param string $string The filter string to remove
*
* @return bool True on success
*/
public function remove($type, $root, $string)
{
$ret = $this->applyExclusionFilter($type, $root, $string, 'remove');
return $ret['success'];
}
/**
* Creates a new regex filter
*
* @param string $type Filter type
* @param string $root The filter's root
* @param string $string The filter string to remove
*
* @return bool True on success
*/
public function setFilter($type, $root, $string)
{
$ret = $this->applyExclusionFilter($type, $root, $string, 'set');
return $ret['success'];
}
/**
* Handles a request coming in through AJAX. Basically, this is a simple proxy to the model methods.
*
* @return array
*/
public function doAjax()
{
$action = $this->getState('action');
$verb = array_key_exists('verb', $action) ? $action['verb'] : null;
$ret_array = [];
switch ($verb)
{
// Produce a list of regex filters
case 'list':
$ret_array = [
'list' => $this->get_regex_filters($action['root'])
];
break;
// Set a filter (used by the editor)
case 'set':
$ret_array = ['success' => $this->setFilter($action['type'], $action['root'], $action['node'])];
break;
// Remove a filter (used by the editor)
case 'remove':
$ret_array = ['success' => $this->remove($action['type'], $action['root'], $action['node'])];
break;
}
return $ret_array;
}
}PK \/ / src/Model/FilefiltersModel.phpnu [ knownFilterTypes = ['directories', 'files', 'skipdirs', 'skipfiles'];
}
/**
* Returns an array with the listing and filter status of a directory
*
* @param string $root Root directory
* @param array $crumbs Breadcrumbs in array format, defining the parent directory
* @param string $child The child directory we want to scan
*
* @return array
*/
public function makeListing(string $root, array $crumbs = [], string $child = ''): array
{
// Construct the full node
$node = $this->glueCrumbs($crumbs, $child);
// Create the new crumbs
if (!is_array($crumbs))
{
$crumbs = [];
}
if (!empty($child))
{
$crumbs[] = $child;
}
// Get listing with the filter info
$listing = $this->getListing($root, $node);
// Assemble the array
$listing['root'] = $root;
$listing['crumbs'] = $crumbs;
return $listing;
}
/**
* Toggle a filter
*
* @param string $root Root directory
* @param array $crumbs Components of the current directory relative to the root
* @param string $item The child item of the current directory we want to toggle the filter for
* @param string $filter The name of the filter to apply (directories, skipfiles, skipdirs, files)
*
* @return array
*/
public function toggle(string $root, array $crumbs, string $item, string $filter): array
{
$node = $this->glueCrumbs($crumbs, $item);
return $this->applyExclusionFilter($filter, $root, $node, 'toggle');
}
/**
* Set a filter
*
* @param string $root Root directory
* @param array $crumbs Components of the current directory relative to the root
* @param string $item The child item of the current directory we want to set the filter for
* @param string $filter The name of the filter to apply (directories, skipfiles, skipdirs, files)
*
* @return array
*/
public function setFilter(string $root, array $crumbs, string $item, string $filter): array
{
$node = $this->glueCrumbs($crumbs, $item);
return $this->applyExclusionFilter($filter, $root, $node, 'set');
}
/**
* Remove a filter
*
* @param string $root Root directory
* @param array $crumbs Components of the current directory relative to the root
* @param string $item The child item of the current directory we want to remove the filter for
* @param string $filter The name of the filter to apply (directories, skipfiles, skipdirs, files)
*
* @return array
*/
public function remove(string $root, array $crumbs, string $item, string $filter): array
{
$node = $this->glueCrumbs($crumbs, $item);
return $this->applyExclusionFilter($filter, $root, $node, 'remove');
}
/**
* Swap a filter
*
* @param string $root Root directory
* @param array $crumbs Components of the current directory relative to the root
* @param string $old_item The child item of the current directory we want to remove a filter for
* @param string $new_item The child item of the current directory we want to add a filter for
* @param string $filter The name of the filter to apply (directories, skipfiles, skipdirs, files)
*
* @return array
*/
public function swap(string $root, array $crumbs, string $old_item, string $new_item, string $filter): array
{
$new_node = $this->glueCrumbs($crumbs, $new_item);
$old_node = $this->glueCrumbs($crumbs, $old_item);
return $this->applyExclusionFilter($filter, $root, $new_node, 'swap', $old_node);
}
/**
* Retrieves the filters as an array. Used for the tabular filter editor.
*
* @param string $root The root node to search filters on
*
* @return array A collection of hash arrays containing node and type for each filtered element
*/
public function getFilters(string $root): array
{
return $this->getTabularFilters($root);
}
/**
* Resets the filters
*
* @param string $root Root directory
*
* @return array
*/
public function resetFilters(string $root): array
{
$this->resetAllFilters($root);
return $this->makeListing($root);
}
/**
* Handles a request coming in through AJAX. Basically, this is a simple proxy to the model methods.
*
* @return array
*/
public function doAjax(): array
{
$action = $this->getState('action');
$verb = array_key_exists('verb', get_object_vars($action)) ? $action->verb : null;
if (!array_key_exists('crumbs', get_object_vars($action)))
{
$action->crumbs = [];
}
$ret_array = [];
switch ($verb)
{
// Return a listing for the normal view
case 'list':
$ret_array = $this->makeListing($action->root, $action->crumbs, $action->node);
break;
// Toggle a filter's state
case 'toggle':
$ret_array = $this->toggle($action->root, $action->crumbs, $action->node, $action->filter);
break;
// Set a filter (used by the editor)
case 'set':
$ret_array = $this->setFilter($action->root, $action->crumbs, $action->node, $action->filter);
break;
// Swap a filter (used by the editor)
case 'swap':
$ret_array =
$this->swap($action->root, $action->crumbs, $action->old_node, $action->new_node, $action->filter);
break;
case 'tab':
$ret_array = [
'list' => $this->getFilters($action->root)
];
break;
// Reset filters
case 'reset':
$ret_array = $this->resetFilters($action->root);
break;
}
return $ret_array;
}
/**
* Returns a listing of contained directories and files, as well as their exclusion status
*
* @param string $root The root directory
* @param string $node The subdirectory to scan
*
* @return array
*/
private function getListing(string $root, string $node): array
{
// Initialize the absolute directory root
$directory = substr($root, 0);
// Replace stock directory tags, like [SITEROOT]
$stock_dirs = Platform::getInstance()->get_stock_directories();
if (!empty($stock_dirs))
{
foreach ($stock_dirs as $key => $replacement)
{
$directory = str_replace($key, $replacement, $directory);
}
}
$directory = Factory::getFilesystemTools()->TranslateWinPath($directory);
// Clean and add the node
$node = Factory::getFilesystemTools()->TranslateWinPath($node);
// Just a directory separator is treated as no directory at all
if (($node == '/'))
{
$node = '';
}
// Trim leading and trailing slashes
$node = trim($node, '/');
// Add node to directory
if (!empty($node))
{
$directory .= '/' . $node;
}
// Add any required trailing slash to the node to be used below
if (!empty($node))
{
$node .= '/';
}
// Get a filters instance
$filters = Factory::getFilters();
// Get a listing of folders and process it
$folders = Factory::getFileLister()->getFolders($directory);
$folders_out = [];
if (!empty($folders))
{
asort($folders);
foreach ($folders as $folder)
{
$folder = Factory::getFilesystemTools()->TranslateWinPath($folder);
// Filter out files whose names result to an empty JSON representation
$json_folder = json_encode($folder);
$folder = json_decode($json_folder);
if (empty($folder))
{
continue;
}
$test = $node . $folder;
$status = [];
// Check dir/all filter (exclude)
$result = $filters->isFilteredExtended($test, $root, 'dir', 'all', $byFilter);
$status['directories'] = (!$result) ? 0 : (($byFilter == 'directories') ? 1 : 2);
// Check dir/content filter (skip_files)
$result = $filters->isFilteredExtended($test, $root, 'dir', 'content', $byFilter);
$status['skipfiles'] = (!$result) ? 0 : (($byFilter == 'skipfiles') ? 1 : 2);
// Check dir/children filter (skip_dirs)
$result = $filters->isFilteredExtended($test, $root, 'dir', 'children', $byFilter);
$status['skipdirs'] = (!$result) ? 0 : (($byFilter == 'skipdirs') ? 1 : 2);
$status['link'] = @is_link($directory . '/' . $folder);
// Add to output array
$folders_out[$folder] = $status;
}
}
unset($folders);
$folders = $folders_out;
// Get a listing of files and process it
$files = Factory::getFileLister()->getFiles($directory);
$files_out = [];
if (!empty($files))
{
asort($files);
foreach ($files as $file)
{
// Filter out files whose names result to an empty JSON representation
$json_file = json_encode($file);
$file = json_decode($json_file);
if (empty($file))
{
continue;
}
$test = $node . $file;
$status = [];
// Check file/all filter (exclude)
$result = $filters->isFilteredExtended($test, $root, 'file', 'all', $byFilter);
$status['files'] = (!$result) ? 0 : (($byFilter == 'files') ? 1 : 2);
$status['size'] = $this->formatSize(@filesize($directory . '/' . $file), 1);
$status['link'] = @is_link($directory . '/' . $file);
// Add to output array
$files_out[$file] = $status;
}
}
unset($files);
$files = $files_out;
// Return a compiled array
$retArray = [
'folders' => $folders,
'files' => $files,
];
return $retArray;
/* Return array format
* [array] :
* 'folders' [array] :
* (folder_name) => [array]:
* 'directories' => 0|1|2
* 'skipfiles' => 0|1|2
* 'skipdirs' => 0|1|2
* 'files' [array] :
* (file_name) => [array]:
* 'files' => 0|1|2
*
* Legend:
* 0 -> Not excluded
* 1 -> Excluded by the direct filter
* 2 -> Excluded by another filter (regex, api, an unknown plugin filter...)
*/
}
/**
* Glues the current directory crumbs and the child directory into a node string
*
* @param array $crumbs Breadcrumbs in array or JSON encoded array format
* @param string $child The child folder (relative to the root defined by crumbs)
*
* @return string The absolute node (path) of the $child
*/
private function glueCrumbs(array $crumbs, string $child): string
{
// Construct the full node
$node = '';
array_walk($crumbs, function ($value, $index) {
if (in_array(trim($value), ['.', '..']))
{
throw new InvalidArgumentException("Unacceptable folder crumbs");
}
});
if ((stristr($child, '/..') !== false) || (stristr($child, '\..') !== false))
{
throw new InvalidArgumentException("Unacceptable child folder");
}
if (!empty($crumbs))
{
$node = implode('/', $crumbs);
}
if (!empty($node))
{
$node .= '/';
}
if (!empty($child))
{
$node .= $child;
}
return $node;
}
/**
* Format the size of the file (given in bytes) to something human readable, e.g. 123 MB
*
* @param int $bytes The file size in bytes
* @param int $decimals How many decimals you want (default: 0)
*
* @return string The human-readable, formatted size
*/
private function formatSize(int $bytes, int $decimals = 0): string
{
$bytes = empty($bytes) ? 0 : (int) $bytes;
$format = empty($decimals) ? '%0u' : '%0.' . $decimals . 'f';
$uom = [
'TB' => 1048576 * 1048576,
'GB' => 1024 * 1048576,
'MB' => 1048576,
'KB' => 1024,
'B' => 1,
];
// Whole bytes cannot have decimal positions
if (!empty($decimals))
{
unset($uom['B']);
}
foreach ($uom as $unit => $byteSize)
{
if (floatval($bytes) >= $byteSize)
{
return sprintf($format, $bytes / $byteSize) . ' ' . $unit;
}
}
// If the number is either too big or too small,
return sprintf('%0u B', $bytes);
}
}PK \ ) ) # src/Model/RegexfilefiltersModel.phpnu [ loadForm(
'com_akeebabackup.statistic',
'statistic',
[
'control' => 'jform',
'load_data' => $loadData,
]
);
if (empty($form))
{
return false;
}
// Modify the form based on access controls.
if (!$this->canEditState((object) $data))
{
// Disable fields for display.
$form->setFieldAttribute('frozen', 'disabled', 'true');
// Disable fields while saving.
// The controller has already verified this is a record you can edit.
$form->setFieldAttribute('frozen', 'filter', 'unset');
}
return $form;
}
/**
* Method to get the data that should be injected in the form.
*
* @return mixed The data for the form.
*
* @since 1.6
*/
protected function loadFormData()
{
// Check the session for previously entered form data.
$app = JoomlaFactory::getApplication();
$data = $app->getUserState('com_akeebabackup.edit.statistic.data', []);
if (empty($data))
{
$data = (object) $this->getItem();
}
$this->preprocessData('com_akeebabackup.statistic', $data);
return $data;
}
public function delete(&$pks)
{
$pks = ArrayHelper::toInteger((array) $pks);
$table = $this->getTable();
// Include the plugins for the delete events.
PluginHelper::importPlugin($this->events_map['delete']);
// Iterate the items to delete each one.
foreach ($pks as $i => $id)
{
if ((!is_numeric($id)) || ($id <= 0))
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_BUADMIN_ERROR_INVALIDID'));
}
// Get the backup statistics record and the files to delete
$stat = (array) Platform::getInstance()->get_statistics($id);
$table->bind($stat);
if ($stat['frozen'])
{
throw new FrozenRecordError(Text::_('COM_AKEEBABACKUP_BUADMIN_FROZENRECORD_ERROR'));
}
try
{
$result = $this->canDelete($table);
$error = null;
}
catch (\Exception $e)
{
$result = false;
$error = $e->getMessage();
}
if ($result === false && $error === null)
{
/** @deprecated 10.1.0 Only for Joomla 4 b/c. Remove in 11. */
/** @noinspection PhpDeprecationInspection */
$error = $table->getError();
}
if (!$result)
{
// Prune items that you can't change.
unset($pks[$i]);
if ($error)
{
Log::add($error, Log::WARNING, 'jerror');
}
else
{
Log::add(Text::_('JLIB_APPLICATION_ERROR_DELETE_NOT_PERMITTED'), Log::WARNING, 'jerror');
}
return false;
}
$context = $this->option . '.' . $this->name;
// Trigger the before delete event.
$result = $this->triggerPluginEvent($this->event_before_delete, [$context, $table]);
if (\in_array(false, $result, true))
{
/** @deprecated 10.1.0 Only for Joomla 4 b/c. Remove in 11. */
/** @noinspection PhpDeprecationInspection */
$error = $table->getError();
throw new RuntimeException($error);
}
$ref = [$id];
if (!$this->deleteFiles($ref))
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_BUADMIN_ERR_CANNOT_DELETE_ARCHIVES'));
}
try
{
$ref = @intval($id);
}
catch (\Throwable $e)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_BUADMIN_ERROR_INVALIDID'));
}
if (!$table->delete($id))
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_BUADMIN_ERR_CANNOT_DELETE_RECORD'));
}
// Trigger the after event.
$this->triggerPluginEvent($this->event_after_delete, [$context, $table]);
}
// Clear the component's cache
$this->cleanCache();
return true;
}
/**
* Delete the backup files of one or more backup statistics records
*
* @param int|array $pks The IDs of the backup statistics records to delete
*
* @return bool True on success
*/
public function deleteFiles(&$pks)
{
$pks = ArrayHelper::toInteger((array) $pks);
$result = true;
foreach ($pks as $i => $id)
{
if ((!is_numeric($id)) || ($id <= 0))
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_BUADMIN_ERROR_INVALIDID'));
}
// Get the backup statistics record and the files to delete
$stat = (array) Platform::getInstance()->get_statistics($id);
if ($stat['frozen'])
{
throw new FrozenRecordError(Text::_('COM_AKEEBABACKUP_BUADMIN_FROZENRECORD_ERROR'));
}
// Remove the custom log file if necessary
$this->deleteLogs($stat);
// Get all of the files
$allFiles = Factory::getStatistics()->get_all_filenames($stat, false);
// No files? Nothing to do.
if (empty($allFiles))
{
continue;
}
foreach ($allFiles as $filename)
{
if (!@file_exists($filename))
{
continue;
}
if (@unlink($filename))
{
continue;
}
$result = true;
// if (!File::delete($filename))
// {
// $result = false;
// }
$result = false;
}
$this->triggerEvent('onAfterDeleteFiles', [$id]);
}
return $result;
}
/**
* Deletes the backup-specific log files of a backup stats records
*
* @param array $stat Stats record
*
* @return void
*/
protected function deleteLogs(array $stat)
{
// We can't delete logs if there is no backup ID in the record
if (!isset($stat['backupid']) || empty($stat['backupid']))
{
return;
}
$logFileNames = [
'akeeba.' . $stat['tag'] . '.' . $stat['backupid'] . '.log',
'akeeba.' . $stat['tag'] . '.' . $stat['backupid'] . '.log.php',
];
foreach ($logFileNames as $logFileName)
{
$logPath = dirname($stat['absolute_path']) . '/' . $logFileName;
if (!@file_exists($logPath))
{
continue;
}
if (@unlink($logPath))
{
continue;
}
// File::delete($logPath);
}
}
protected function canDelete($record)
{
// Allow the check to be overridden by the API task
$override = $this->getState('workaround.override_canDelete');
if ($override !== null && is_bool($override))
{
return $override;
}
return parent::canDelete($record);
}
}PK \ m m src/Model/PushModel.phpnu [ initialiseWebPush('com_akeebabackup', 'vapidKey');
}
}PK \ > > src/Model/RemotefilesModel.phpnu [ getPostProcEngineNameForRecord($id, false);
if ($postProcEngineName == 'none')
{
// There's no file stored remotely. Get the post-proc engine from the profile.
$postProcEngineName = $this->getPostProcEngineNameForRecord($id, true);
}
$postProcEngine = Factory::getPostprocEngine($postProcEngineName);
return [
'engine' => $postProcEngineName,
'delete' => $postProcEngine->supportsDelete(),
'downloadToFile' => $postProcEngine->supportsDownloadToFile(),
'downloadToBrowser' => $postProcEngine->supportsDownloadToBrowser(),
'inlineDownload' => $postProcEngine->doesInlineDownloadToBrowser(),
];
}
/**
* Returns the definitions of the Manage Remotely Stored Files action for a given backup record.
*
* Returns an icon definition list for the applicable actions on this backup record
*
* @param int $id The backup record ID to return action definitions for
*
* @return array The action definitions
* @throws Exception
*/
public function getActions(int $id): array
{
$actions = [
'downloadToFile' => false,
'delete' => false,
'downloadToBrowser' => 0,
];
$postProcEngineName = $this->getPostProcEngineNameForRecord($id);
$postProcEngine = Factory::getPostprocEngine($postProcEngineName);
$stat = Platform::getInstance()->get_statistics($id);
// Does the engine support local d/l and we need to d/l the file locally?
if ($postProcEngine->supportsDownloadToFile() && !$stat['filesexist'])
{
$actions['downloadToFile'] = true;
}
// Does the engine support remote deletes?
if ($postProcEngine->supportsDelete())
{
$actions['delete'] = true;
}
// Does the engine support downloads to browser?
if ($postProcEngine->supportsDownloadToBrowser())
{
$actions['downloadToBrowser'] = max(1, $stat['multipart']);
}
return $actions;
}
/**
* Downloads a remote file back to the site's server
*
* @param int $id The backup record ID to fetch back to server
* @param int $part Which part file of the backup record should I fetch back?
* @param int $frag Which fragment of the backup record should I fetch back?
*
* @return bool true when we're done downloading, false if we have more work to do
* @throws Exception On error
*/
public function downloadToServer(int $id, int $part = -1, int $frag = -1): bool
{
// Gather the necessary information to perform the download
$backupRecord = Platform::getInstance()->get_statistics($id);
$remoteFilenameParts = explode('://', $backupRecord['remote_filename']);
$engine = Factory::getPostprocEngine($remoteFilenameParts[0]);
$remoteFilepath = $remoteFilenameParts[1];
// Note that single part archives have $backupRecord['multipart'] == 0. We need that to be 1.
$totalNumberOfParts = max($backupRecord['multipart'], 1);
// Timer initialization
$config = Factory::getConfiguration();
$timer = Factory::getTimer();
$start = $timer->getRunningTime();
$app = JoomlaFactory::getApplication();
// If we are starting a new download we need to reset the statistics in the session
if ($part == -1)
{
// Total size of the files to download
$app->getSession()->set('akeebabackup.dl_totalsize', $backupRecord['total_size']);
// Cumulative bytes downloaded so far
$app->getSession()->set('akeebabackup.dl_donesize', 0);
// Convert part -1 to 0, indicating it's the very first part
$part = 0;
// Indicate this is going to be the very first fragment of the file to download
$frag = -1;
}
while (true)
{
/**
* If we are trying to download a part that's higher than the number of parts in the archive we're all done.
*
* Remember: $part is the 0-based index (first part is zero). $totalNumberOfParts is the 1-based count of
* items in the collection.
*/
if ($part >= $totalNumberOfParts)
{
// Fall through to the return code which also updates the backup record
break;
}
// Get the remote and local filenames
$basename = basename($remoteFilepath);
$extension = strtolower(str_replace(".", "", strrchr($basename, ".")));
$partExtension = ($part == 0) ? $extension : substr($extension, 0, 1) . sprintf('%02u', $part);
$remoteFilepath = substr($remoteFilenameParts[1], 0, -strlen($extension)) . $partExtension;
$localFilepath = $config->get('akeeba.basic.output_directory') . '/' . basename($remoteFilepath);
/**
* If $frag == -1 I am starting to download a new backup archive part. Therefore I need to initialize the
* local file.
*/
if ($frag == -1)
{
Platform::getInstance()->unlink($localFilepath);
$fp = @fopen($localFilepath, 'w');
if ($fp === false)
{
throw new RuntimeException(Text::sprintf('COM_AKEEBABACKUP_REMOTEFILES_ERR_CANTOPENFILE', $localFilepath), 500);
}
@fclose($fp);
// Set the frag to 0 to let the download proceed correctly.
$frag = 0;
}
// Calculate the offset to start downloading from and try to download the next fragment
$from = $frag * self::DOWNLOAD_FRAGMENT_SIZE;
$tempFilepath = $localFilepath . '.tmp';
$allowMultipart = true;
try
{
// Try to do a multipart download. If it's not supported, do a single part download.
try
{
$engine->downloadToFile($remoteFilepath, $tempFilepath, $from, self::DOWNLOAD_FRAGMENT_SIZE);
}
catch (RangeDownloadNotSupported $e)
{
$allowMultipart = false;
$engine->downloadToFile($remoteFilepath, $tempFilepath);
}
}
catch (Exception $e)
{
// Failed download
if (
(($part < $backupRecord['multipart']) || (($backupRecord['multipart'] == 0) && ($part == 0))) &&
($frag == 0)
)
{
// Failure to download the part's beginning = failure to download. Period.
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_REMOTEFILES_ERR_CANTDOWNLOAD'), 500, $e);
}
// We tried reading past the end of a part file. Go to the next part.
$part++;
$frag = -1;
continue;
}
// Add the currently downloaded fragment's size to the running total size of downloaded files
$downloadedFragmentSize = (int) @filesize($tempFilepath);
$currentTotal = $app->getSession()->get('akeebabackup.dl_donesize', 0);
$app->getSession()->set('akeebabackup.dl_donesize', $currentTotal + $downloadedFragmentSize);
if (!$allowMultipart)
{
// Single part download: move the temporary file to the local file
$this->moveTempFile($tempFilepath, $localFilepath);
// Go to the start of the next part
$part++;
$frag = -1;
break;
}
// Multipart download: try to combine the just downloaded fragment (in a temp file) with the local file
$this->combineTemporaryAndLocalFile($tempFilepath, $localFilepath);
// Indicate we need to download the next fragment
$frag++;
// Do I have enough time to try another fragment?
$end = $timer->getRunningTime();
$requiredTime = max(1.1 * ($end - $start), !isset($requiredTime) ? 1.0 : $requiredTime);
if ($timer->getTimeLeft() < $requiredTime)
{
break;
}
$start = $end;
}
// We set these variables in the model state to allow the View to access them
$this->setState('id', $id);
$this->setState('part', $part);
$this->setState('frag', $frag);
/**
* If we are trying to download a part that's higher than the number of parts in the archive we're all done.
*
* Remember: $part is the 0-based index (first part is zero). $totalNumberOfParts is the 1-based count of
* items in the collection.
*/
if ($part >= $totalNumberOfParts)
{
// Update the backup record, indicating the files now exist locally
$backupRecord['filesexist'] = 1;
Platform::getInstance()->set_or_update_statistics($id, $backupRecord);
// Tell the called that we're all done with the downloads.
return true;
}
// Tell the caller more steps are required to download the files
return false;
}
/**
* Delete the files stored in the remote storage service
*
* @param int $id The backup record we're deleting remote stored files for
* @param int $part The backup part whose remotely stored file we're deleting
*
* @return array Information about the progress
* @throws Exception On error
*/
public function deleteRemoteFiles(int $id, int $part = -1): array
{
$ret = [
'finished' => false,
'id' => $id,
'part' => $part,
];
// Gather the necessary information to perform the delete
$stat = Platform::getInstance()->get_statistics($id);
if ($stat['frozen'])
{
throw new FrozenRecordError(Text::_('COM_AKEEBABACKUP_BUADMIN_FROZENRECORD_ERROR'));
}
$remoteFilenameParts = explode('://', $stat['remote_filename']);
$engine = Factory::getPostprocEngine($remoteFilenameParts[0]);
$remote_filename = $remoteFilenameParts[1];
// Start timing ourselves
$timer = Factory::getTimer(); // The core timer object
$start = $timer->getRunningTime(); // Mark the start of this download
$break = false; // Don't break the step
while ($timer->getTimeLeft() && !$break && ($part < $stat['multipart']))
{
// Get the remote filename
$basename = basename($remote_filename);
$extension = strtolower(str_replace(".", "", strrchr($basename, ".")));
$new_extension = $extension;
if ($part > 0)
{
$new_extension = substr($extension, 0, 1) . sprintf('%02u', $part);
}
$remote_filename = substr($remote_filename, 0, -strlen($extension)) . $new_extension;
// Do we have to initialize the process?
if ($part == -1)
{
// Init
$part = 0;
}
// Try to delete the part
$required_time = 1.0;
try
{
$engine->delete($remote_filename);
}
catch (Exception $e)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_REMOTEFILES_ERR_CANTDELETE'), 500, $e);
}
// Successful delete
$end = $timer->getRunningTime();
$part++;
// Do we predict that we have enough time?
$required_time = max(1.1 * ($end - $start), $required_time);
if ($timer->getTimeLeft() < $required_time)
{
$break = true;
}
$start = $end;
}
if ($part >= $stat['multipart'])
{
// Just finished!
$stat['remote_filename'] = '';
Platform::getInstance()->set_or_update_statistics($id, $stat);
$ret['finished'] = true;
return $ret;
}
// More work to do...
$ret['id'] = $id;
$ret['part'] = $part;
return $ret;
}
/**
* Appends the contents of the temporary file to the local file
*
* @param string $tempFilepath Temporary file to read from
* @param string $localFilepath Local file to append to
* @param int $chunkLength Perform the appent up to this many bytes at a time
*
* @return void
*
* @throws RuntimeException If something has gone wrong
*/
private function combineTemporaryAndLocalFile(string $tempFilepath,
string $localFilepath,
int $chunkLength = 262144)
{
try
{
$localFilePointer = @fopen($localFilepath, 'a');
if ($localFilePointer === false)
{
throw new RuntimeException(Text::sprintf('COM_AKEEBABACKUP_REMOTEFILES_ERR_CANTOPENFILE', $localFilepath), 500);
}
$tempFilePointer = fopen($tempFilepath, 'r');
// Um, weird, I can't open the temp file.
if ($tempFilePointer === false)
{
throw new RuntimeException(sprintf('Can not read data from temporary file %s', $tempFilepath));
}
while (!feof($tempFilePointer))
{
$data = fread($tempFilePointer, $chunkLength);
if ($data === false)
{
throw new RuntimeException(sprintf('Can not read data from temporary file %s', $tempFilepath));
}
$dataLength = $this->akstrlen($data);
$written = fwrite($localFilePointer, $data);
if ($written != $dataLength)
{
throw new RuntimeException(Text::sprintf('COM_AKEEBABACKUP_REMOTEFILES_ERR_CANTOPENFILE', $localFilepath), 500);
}
}
}
finally
{
if (isset($tempFilePointer) && is_resource($tempFilePointer))
{
fclose($tempFilePointer);
}
if (isset($localFilePointer) && is_resource($localFilePointer))
{
fclose($localFilePointer);
}
Platform::getInstance()->unlink($tempFilepath);
}
}
private function akstrlen(string $string): int
{
return function_exists('mb_strlen') ? mb_strlen($string, '8bit') : strlen($string);
}
/**
* Move a temporary file into a local file path
*
* @param string $tempFilepath The temporary file to move from
* @param string $localFilepath The local file to move into
*
* @return void
* @throws RuntimeException If the move fails
*/
private function moveTempFile(string $tempFilepath, string $localFilepath)
{
try
{
// Try to unlink the existing local file (it should exist, we already tried creating it as a zero byte file)
Platform::getInstance()->unlink($localFilepath);
// Move the temporary file to the local file
if (!Platform::getInstance()->move($tempFilepath, $localFilepath))
{
throw new RuntimeException(Text::sprintf('COM_AKEEBABACKUP_REMOTEFILES_ERR_CANTOPENFILE', $localFilepath));
}
}
finally
{
// Delete the temporary file
Platform::getInstance()->unlink($tempFilepath);
}
}
/**
* Returns the post-processing engine name for the given backup record ID.
*
* @param int $id The backup record ID
* @param bool $profileOverridesRecord Return the engine name from the backup profile, not the backup record
*
* @return string
* @throws Exception
*/
private function getPostProcEngineNameForRecord(int $id, bool $profileOverridesRecord = false): string
{
// Load the stats record
$stat = Platform::getInstance()->get_statistics($id);
if (empty($stat))
{
return 'none';
}
if ($profileOverridesRecord)
{
/** @var ProfilesModel $profilesModel */
$profilesModel = $this->getMVCFactory()->createModel('Profiles', 'Administrator');
$postProcPerProfile = $profilesModel->getPostProcessingEnginePerProfile();
$profileId = $stat['profile_id'];
if (!array_key_exists($profileId, $postProcPerProfile))
{
return 'none';
}
return $postProcPerProfile[$profileId];
}
// Get the post-proc engine from the remote location
$remote_filename = $stat['remote_filename'];
if (empty($remote_filename))
{
return 'none';
}
$remoteFilenameParts = explode('://', $remote_filename, 2);
return $remoteFilenameParts[0];
}
}PK \De e src/Model/StatisticsModel.phpnu [ filterFormName = 'filter_manage';
}
/**
* Is this string a valid remote filename?
*
* We've had reports that some servers return a bogus, non-empty string for some remote_filename columns, causing
* the "Manage remote stored files" column to appear even for locally stored files. By applying more rigorous tests
* for the remote_filename column we can avoid this problem.
*
* @param string|null $filename
*
* @return bool
*
* @since 9.2.2
*/
public function isRemoteFilename(?string $filename = null): bool
{
// A remote filename has to be a string which is does not consist solely of whitespace
if (!is_string($filename) || trim($filename) === '')
{
return false;
}
// Let's remote whitespace just in case
$filename = trim($filename);
// A remote filename must be in the format engine://path
if (strpos($filename, '://') === false)
{
return false;
}
// Get the engine and path
[$engine, $path] = explode('://', $filename, 2);
$engine = trim($engine);
$path = trim($path);
// Both engine and path must be non-empty
if (empty($engine) || empty($path))
{
return false;
}
// The engine must be known to the backup engine
$classname = 'Akeeba\\Engine\\Postproc\\' . ucfirst($engine);
return class_exists($classname);
}
/**
* Does the log file for the given backup record exist on the server?
*
* @param array $stat A backup record (as returned by get_statistics_list)
*
* @return bool
*/
public function hasLogFile(array $stat): bool
{
if (empty($stat['backupid']) || empty($stat['tag']) || empty($stat['absolute_path']))
{
return false;
}
$logDir = dirname($stat['absolute_path']);
$base = 'akeeba.' . $stat['tag'] . '.' . $stat['backupid'] . '.log';
return @file_exists($logDir . '/' . $base) || @file_exists($logDir . '/' . $base . '.php');
}
/**
* Returns the same list as getStatisticsList(), but includes an extra field
* named 'meta' which categorises attempts based on their backup archive status
*
* @param bool $overrideLimits Should I disregard limit, limitStart and filters?
* @param array $filters Filters to apply. See Platform::get_statistics_list
* @param array $order Results ordering. The accepted keys are by (column name) and order (ASC or DESC)
*
* @return array An array of arrays. Each inner array is one backup record.
*/
public function &getStatisticsListWithMeta($overrideLimits = false, $filters = null, $order = null)
{
$limitstart = $overrideLimits ? 0 : $this->getState('list.start', 0);
$limit = $overrideLimits ? 0 : $this->getState('list.limit', 10);
$filters = $overrideLimits ? null : $filters;
if (is_array($order) && isset($order['order']))
{
$order['order'] = strtoupper($order['order']) === 'ASC' ? 'asc' : 'desc';
}
$allStats = Platform::getInstance()->get_statistics_list([
'limitstart' => $limitstart,
'limit' => $limit,
'filters' => $filters,
'order' => $order,
]);
$validRecords = Platform::getInstance()->get_valid_backup_records() ?: [];
$updateObsoleteRecords = [];
$ret = array_map(function (array $stat) use (&$updateObsoleteRecords, $validRecords) {
$hasRemoteFiles = false;
// Translate backup status and the existence of a remote filename to the backup record's "meta" status.
switch ($stat['status'])
{
case 'run':
$stat['meta'] = 'pending';
break;
case 'fail':
$stat['meta'] = 'fail';
break;
default:
$hasRemoteFiles = $this->isRemoteFilename($stat['remote_filename']);
$stat['meta'] = $hasRemoteFiles ? 'remote' : 'obsolete';
break;
}
$stat['hasRemoteFiles'] = $hasRemoteFiles;
// If the backup is reported to have files still stored on the server we need to investigate further
if (in_array($stat['id'], $validRecords))
{
$archives = Factory::getStatistics()->get_all_filenames($stat);
$hasLocalFiles = (is_array($archives) ? count($archives) : 0) > 0;
$stat['meta'] = $hasLocalFiles ? 'ok' : ($hasRemoteFiles ? 'remote' : 'obsolete');
// The archives exist. Set $stat['size'] to the total size of the backup archives.
if ($hasLocalFiles)
{
$stat['size'] = $stat['total_size']
?: array_reduce(
$archives,
function ($carry, $filename) {
return $carry += @filesize($filename) ?: 0;
},
0
);
return $stat;
}
// The archives do not exist or we can't find them. If the record says otherwise we need to update it.
if ($stat['filesexist'])
{
$updateObsoleteRecords[] = $stat['id'];
}
// Does the backup record report a total size even though our files no longer exist?
if ($stat['total_size'])
{
$stat['size'] = $stat['total_size'];
}
}
return $stat;
}, $allStats);
$ret = array_map(function (array $stat): array {
$stat['log_present'] = $this->hasLogFile($stat);
return $stat;
}, $ret);
// Update records which report that their files exist on the server but, in fact, they don't.
Platform::getInstance()->invalidate_backup_records($updateObsoleteRecords);
return $ret;
}
/**
* Send an email notification for backups which failed to upload to remote storage.
*
* @return array See the CLI script
* @since 10.1.0
*/
public function notifyFailedUploads()
{
// Get profile ID with a post proc engine
$profileIDsWithPostProc = $this->getProfileIDsWithPostProcEngines();
if (empty($profileIDsWithPostProc))
{
return [
'message' => ["No need to run: no backup profiles with remote storage currently set up."],
'result' => true,
];
}
$cParams = ComponentHelper::getParams('com_akeebabackup');
// Get the last execution and search for failed uploads AFTER that date
$last = $this->getLastCheck('akeeba_checkfailedupload');
// Get backup records with failed uploads
$filters = [
['field' => 'profile_id', 'operand' => 'IN', 'value' => $profileIDsWithPostProc],
['field' => 'status', 'operand' => '=', 'value' => 'complete'],
['field' => 'type', 'operand' => '!=', 'value' => 'dbonly'],
['field' => 'filesexist', 'operand' => '=', 'value' => '1'],
['field' => 'frozen', 'operand' => '=', 'value' => '0'],
['field' => 'remote_filename', 'operand' => 'EMPTY', 'value' => ''],
['field' => 'backupstart', 'operand' => '>', 'value' => $last],
];
$failedUploads = Platform::getInstance()->get_statistics_list(['filters' => $filters]);
// Well, everything went ok.
if (!$failedUploads)
{
return [
'message' => ["No need to run: no backups with failed uploads, or notifications were already sent."],
'result' => true,
];
}
// Whops! Something went wrong, let's start notifing
$superAdmins = [];
$superAdminEmail = $cParams->get('uploadfailure_email_address', '');
if (!empty($superAdminEmail))
{
$superAdmins = $this->getSuperUsers($superAdminEmail);
}
if (empty($superAdmins))
{
$superAdmins = $this->getSuperUsers();
}
if (empty($superAdmins))
{
return [
'message' => ["Failed uploads(s) detected, but there are no configured Super Administrators to receive notifications"],
'result' => false,
];
}
$failedReport = [];
foreach ($failedUploads as $fail)
{
$string = "Description : " . $fail['description'] . "\n";
$string .= "Start time : " . $fail['backupstart'] . "\n";
$string .= "Origin : " . $fail['origin'] . "\n";
$string .= "Type : " . $fail['type'] . "\n";
$string .= "Profile ID : " . $fail['profile_id'] . "\n";
$string .= "Backup ID : " . $fail['id'];
$failedReport[] = $string;
}
$failedReport = implode("\n#-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+#\n", $failedReport);
$email_subject = $cParams->get('uploadfailure_email_subject', '');
if (!$email_subject)
{
$email_subject = <<get('uploadfailure_email_body', '');
if (!$email_body)
{
$email_body = <<get('mailfrom');
$fromname = $app->get('fromname');
$email_subject = Factory::getFilesystemTools()->replace_archive_name_variables($email_subject);
$email_body = Factory::getFilesystemTools()->replace_archive_name_variables($email_body);
$email_body = str_replace('[FAILEDLIST]', $failedReport, $email_body);
foreach ($superAdmins as $sa)
{
try
{
/** @var Mail $mailer */
$mailer = JFactory::getContainer()->get(MailerFactoryInterface::class)->createMailer();
$mailer->setSender([$mailfrom, $fromname]);
$mailer->addRecipient($sa->email);
$mailer->setSubject($email_subject);
$mailer->setBody($email_body);
$mailer->Send();
}
catch (Exception $e)
{
// Joomla! 3.5 is written by incompetent bonobos
}
}
// Let's update the last time we check, so we will avoid to send
// the same notification several times
$this->updateLastCheck(intval($last), 'akeeba_checkfailedupload');
return [
'message' => [
sprintf(
'Found %d failed upload(s)',
(is_array($failedUploads) || $failedUploads instanceof \Countable)
? count($failedUploads)
: 0
),
sprintf(
"Sent %s notifications",
count($superAdmins)
),
],
'result' => false,
];
}
/**
* Send an email notification for failed backups
*
* @return array See the CLI script
*/
public function notifyFailed()
{
$cParams = ComponentHelper::getParams('com_akeebabackup');
// Invalidate stale backups
try
{
Factory::resetState([
'global' => true,
'log' => false,
'maxrun' => $cParams->get('failure_timeout', 180),
]);
}
catch (Exception $e)
{
// This will die if the output directory is invalid. Let it die, then.
}
// Get the last execution and search for failed backups AFTER that date
$last = $this->getLastCheck();
// Get failed backups
$filters = [
['field' => 'status', 'operand' => '=', 'value' => 'fail'],
['field' => 'backupstart', 'operand' => '>', 'value' => $last],
];
$failed = Platform::getInstance()->get_statistics_list(['filters' => $filters]);
// Well, everything went ok.
if (!$failed)
{
return [
'message' => ["No need to run: no failed backups or notifications were already sent."],
'result' => true,
];
}
// Whops! Something went wrong, let's start notifing
$superAdmins = [];
$superAdminEmail = $cParams->get('failure_email_address', '');
if (!empty($superAdminEmail))
{
$superAdmins = $this->getSuperUsers($superAdminEmail);
}
if (empty($superAdmins))
{
$superAdmins = $this->getSuperUsers();
}
if (empty($superAdmins))
{
return [
'message' => ["Failed backup(s) detected, but there are no configured Super Administrators to receive notifications"],
'result' => false,
];
}
$failedReport = [];
foreach ($failed as $fail)
{
$string = "Description : " . $fail['description'] . "\n";
$string .= "Start time : " . $fail['backupstart'] . "\n";
$string .= "Origin : " . $fail['origin'] . "\n";
$string .= "Type : " . $fail['type'] . "\n";
$string .= "Profile ID : " . $fail['profile_id'] . "\n";
$string .= "Backup ID : " . $fail['id'];
$failedReport[] = $string;
}
$failedReport = implode("\n#-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+#\n", $failedReport);
$email_subject = $cParams->get('failure_email_subject', '');
if (!$email_subject)
{
$email_subject = <<get('failure_email_body', '');
if (!$email_body)
{
$email_body = <<get('mailfrom');
$fromname = $app->get('fromname');
$email_subject = Factory::getFilesystemTools()->replace_archive_name_variables($email_subject);
$email_body = Factory::getFilesystemTools()->replace_archive_name_variables($email_body);
$email_body = str_replace('[FAILEDLIST]', $failedReport, $email_body);
foreach ($superAdmins as $sa)
{
try
{
/** @var Mail $mailer */
$mailer = JFactory::getContainer()->get(MailerFactoryInterface::class)->createMailer();
$mailer->setSender([$mailfrom, $fromname]);
$mailer->addRecipient($sa->email);
$mailer->setSubject($email_subject);
$mailer->setBody($email_body);
$mailer->Send();
}
catch (Exception $e)
{
// Joomla! 3.5 is written by incompetent bonobos
}
}
// Let's update the last time we check, so we will avoid to send
// the same notification several times
$this->updateLastCheck(intval($last));
return [
'message' => [
sprintf(
'Found %d failed backup(s)',
(is_array($failed) || $failed instanceof \Countable)
? count($failed)
: 0
),
sprintf(
"Sent %s notifications",
count($superAdmins)
),
],
'result' => false,
];
}
/**
* Set the flag to hide the restoration instructions modal from the Manage Backups page
*
* @param ComponentParameters $componentParametersService
*
* @return void
*/
public function hideRestorationInstructionsModal(ComponentParameters $componentParametersService)
{
$cParams = ComponentHelper::getParams('com_akeebabackup');
$cParams->set('show_howtorestoremodal', 0);
$componentParametersService->save($cParams);
}
/**
* Get a Joomla! pagination object
*
* @param array $filters Filters to apply. See Platform::get_statistics_list
*
* @return Pagination
*/
public function getFilteredPagination($filters = null)
{
// Get a storage key.
$store = $this->getStoreId('getPagination:' . hash('md5', serialize($filters)));
// Try to load the data from internal storage.
if (isset($this->cache[$store]))
{
return $this->cache[$store];
}
// Prepare pagination values
$total = Platform::getInstance()->get_statistics_count($filters);
$limitstart = $this->getState('list.start', 0);
$limit = $this->getState('list.limit', 10);
// Create the pagination object
$this->cache[$store] = new Pagination($total, $limitstart, $limit);
return $this->cache[$store];
}
/**
* Returns the profile IDs which have a post-processing engine enabled.
*
* @return array
* @since 10.1.0
*/
protected function getProfileIDsWithPostProcEngines(): array
{
try
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('id'))
->from($db->quoteName('#__akeebabackup_profiles'));
$profileIDs = $db->setQuery($query)->loadColumn() ?: [];
}
catch (Exception $e)
{
return [];
}
$currentProfileId = Platform::getInstance()->get_active_profile() ?: 1;
$applicableProfileIDs = [];
foreach ($profileIDs as $profileID)
{
try
{
Platform::getInstance()->load_configuration($profileID);
$engine = Factory::getConfiguration()->get('akeeba.advanced.postproc_engine') ?: 'none';
}
catch (Exception $e)
{
continue;
}
if ($engine === 'none')
{
continue;
}
$applicableProfileIDs[] = $profileID;
}
Platform::getInstance()->load_configuration($currentProfileId);
return $applicableProfileIDs;
}
protected function populateState($ordering = null, $direction = null)
{
// Call the parent method
parent::populateState($ordering, $direction);
$app = JoomlaFactory::getApplication();
if ($app->isClient('site'))
{
$this->setState('list.start', 0);
$this->setState('list.limit', 0);
}
}
/**
* Build an SQL query to load the list data.
*
* @return DatabaseQuery|QueryInterface
*
* @throws Exception
* @since 9.0.0
*/
protected function getListQuery()
{
/** @var DatabaseDriver $db */
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn('#__akeebabackup_backups'));
// Description / ID search filter
$search = $this->getState('filter.search');
if (!empty($search))
{
if (stripos($search, 'id:') === 0)
{
$ids = (int) substr($search, 3);
$query->where($db->quoteName('id') . ' = :id')
->bind(':id', $ids, ParameterType::INTEGER);
}
else
{
$search = '%' . $search . '%';
$query->where($db->qn('description') . ' LIKE :search')
->bind(':search', $search);
}
}
// Dates from and to filters
$from = $this->getState('filter.from');
$to = $this->getState('filter.to');
if (!empty($from) && !empty($to))
{
$from = (clone JoomlaFactory::getDate($from))->toSql();
$to = (clone JoomlaFactory::getDate($to))->toSql();
$query->where($db->qn('backupstart') . ' BETWEEN :from AND :to')
->bind(':from', $from, ParameterType::STRING)
->bind(':to', $to, ParameterType::STRING);
}
elseif (!empty($from))
{
$from = (clone JoomlaFactory::getDate($from))->toSql();
$query->where($db->qn('backupstart') . ' >= :from')
->bind(':from', $from, ParameterType::STRING);
}
elseif (!empty($to))
{
$to = (clone JoomlaFactory::getDate($to))->toSql();
$query->where($db->qn('backupstart') . ' <= :to')
->bind(':to', $to, ParameterType::STRING);
}
// origin filter
$origin = $this->getState('filter.origin');
if (is_string($origin) && !empty($origin))
{
$query->where($db->qn('origin') . ' = :origin')
->bind(':origin', $origin, ParameterType::STRING);
}
// profile filter
$profile = $this->getState('filter.profile');
if (is_numeric($profile))
{
$query->where($db->qn('profile_id') . ' = :profile')
->bind(':profile', $profile, ParameterType::INTEGER);
}
// frozen filter
$frozen = $this->getState('filter.frozen');
if (is_numeric($frozen))
{
// Option 2 is non-frozen which is 0 in the database
$frozen = $frozen == 2 ? 0 : $frozen;
$query->where($db->qn('frozen') . ' = :frozen')
->bind(':frozen', $frozen, ParameterType::INTEGER);
}
return $query;
}
/**
* Returns the Super Users' email information. If you provide a comma separated $email list we will check that these
* emails do belong to Super Users and that they have not blocked reception of system emails.
*
* @param null|string $email A list of Super Users to email, null for all Super Users
*
* @return User[] The list of Super User objects
*/
private function getSuperUsers($email = null)
{
// Convert the email list to an array
$emails = [];
if (!empty($email))
{
$temp = explode(',', $email);
$emails = [];
foreach ($temp as $entry)
{
$emails[] = trim($entry);
}
$emails = array_unique($emails);
$emails = array_map('strtolower', $emails);
}
// Get all usergroups with Super User access
$db = $this->getDatabase();
$q = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([$db->qn('id')])
->from($db->qn('#__usergroups'));
$groups = $db->setQuery($q)->loadColumn();
// Get the groups that are Super Users
$groups = array_filter($groups, function ($gid) {
return Access::checkGroup($gid, 'core.admin');
});
$userList = [];
foreach ($groups as $gid)
{
$uids = Access::getUsersByGroup($gid);
array_walk($uids, function ($uid, $index) use (&$userList) {
$userList[$uid] = JoomlaFactory::getContainer()->get(UserFactoryInterface::class)->loadUserById($uid);
});
}
if (empty($emails))
{
return $userList;
}
$userList = array_filter($userList, function (User $user) use ($emails) {
return in_array(strtolower($user->email), $emails);
});
return $userList;
}
/**
* Update the time we last checked for failed backups
*
* @param bool $exists Any non zero value means that we update, not insert, the record
* @param string $tag The storage tag to update, default `akeeba_checkfailed`
*
* @return void
*/
private function updateLastCheck(bool $exists = false, string $tag = 'akeeba_checkfailed')
{
$db = $this->getDatabase();
$now = clone JoomlaFactory::getDate();
$nowToSql = $now->toSql();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->insert($db->qn('#__akeebabackup_storage'))
->columns([$db->qn('tag'), $db->qn('lastupdate')])
->values(':tag, :lastupdate')
->bind(':tag', $tag)
->bind(':lastupdate', $nowToSql);
if ($exists)
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn('#__akeebabackup_storage'))
->set($db->qn('lastupdate') . ' = :lastupdate')
->where($db->qn('tag') . ' = :tag')
->bind(':tag', $tag)
->bind(':lastupdate', $nowToSql);
}
try
{
$db->setQuery($query)->execute();
}
catch (Exception $exc)
{
}
}
/**
* Get the last update check date and time stamp
*
* @param string $tag The storage tag to update, default `akeeba_checkfailed`
*
* @return string
*/
private function getLastCheck(string $tag = 'akeeba_checkfailed')
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('lastupdate'))
->from($db->qn('#__akeebabackup_storage'))
->where($db->qn('tag') . ' = :tag')
->bind(':tag', $tag);
$datetime = $db->setQuery($query)->loadResult();
if (!intval($datetime))
{
$datetime = $db->getNullDate();
}
return $datetime;
}
}PK \鎥+ + src/Model/RestoreModel.phpnu [ option))
{
$r = null;
if (!preg_match('/(.*)Model/i', \get_class($this), $r))
{
throw new Exception(Text::sprintf('JLIB_APPLICATION_ERROR_GET_NAME', __METHOD__), 500);
}
$this->option = ComponentHelper::getComponentName($this, $r[1]);
}
if ($factory)
{
$this->setMVCFactory($factory);
return;
}
$component = JoomlaFactory::getApplication()->bootComponent($this->option);
if ($component instanceof MVCFactoryServiceInterface)
{
$this->setMVCFactory($component->getMVCFactory());
}
}
/**
* Generates a pseudo-random password
*
* @param int $length The length of the password in characters
*
* @return string The requested password string
*/
public function makeRandomPassword($length = 32)
{
return UserHelper::genRandomPassword($length);
}
/**
* Validates the data passed to the request.
*
* @return mixed True if all is OK, an error string if something is wrong
*/
public function validateRequest()
{
// Is this a valid backup entry?
$ids = $this->getIDsFromRequest();
$id = array_pop($ids);
$profileID = JoomlaFactory::getApplication()->getInput()->getInt('profileid', 0);
// No backup IDs in the request and no backup profile (which means I should use its latest backup record) is found.
if (empty($id) && ($profileID <= 0))
{
return Text::_('COM_AKEEBABACKUP_RESTORE_ERROR_INVALID_RECORD');
}
if (empty($id))
{
try
{
$id = $this->getLatestBackupForProfile($profileID);
}
catch (RuntimeException $e)
{
return $e->getMessage();
}
}
$this->setState('id', $id);
$data = Platform::getInstance()->get_statistics($id);
if (empty($data))
{
return Text::_('COM_AKEEBABACKUP_RESTORE_ERROR_INVALID_RECORD');
}
if ($data['status'] != 'complete')
{
return Text::_('COM_AKEEBABACKUP_RESTORE_ERROR_INVALID_RECORD');
}
// Load the profile ID (so that we can find out the output directory)
$profile_id = $data['profile_id'];
Platform::getInstance()->load_configuration($profile_id);
$path = $data['absolute_path'];
$exists = @file_exists($path);
if (!$exists)
{
// Let's try figuring out an alternative path
$config = Factory::getConfiguration();
$path = $config->get('akeeba.basic.output_directory', '') . '/' . $data['archivename'];
$exists = @file_exists($path);
}
if (!$exists)
{
return Text::_('COM_AKEEBABACKUP_RESTORE_ERROR_ARCHIVE_MISSING');
}
$filename = basename($path);
$lastdot = strrpos($filename, '.');
$extension = strtoupper(substr($filename, $lastdot + 1));
if (!in_array($extension, ['JPS', 'JPA', 'ZIP']))
{
return Text::_('COM_AKEEBABACKUP_RESTORE_ERROR_INVALID_TYPE');
}
$this->data = $data;
$this->path = $path;
$this->extension = $extension;
return true;
}
/**
* Finds the latest backup for a given backup profile with an "OK" status (the archive file exists on your server).
* If none is found a RuntimeException is thrown.
*
* This method uses the code from the Transfer model for DRY reasons.
*
* @param int $profileID The profile in which to locate the latest valid backup
*
* @return int
*
* @throws RuntimeException|Exception
*
* @since 5.3.0
*/
public function getLatestBackupForProfile(int $profileID): int
{
/** @var TransferModel $transferModel */
$transferModel = $this->getMVCFactory()->createModel('Transfer', 'Administrator');
$latestBackup = $transferModel->getLatestBackupInformation($profileID);
if (empty($latestBackup))
{
throw new RuntimeException(Text::sprintf('COM_AKEEBABACKUP_RESTORE_ERROR_NO_LATEST', $profileID));
}
return $latestBackup['id'];
}
/**
* Creates the restoration.php file which is used to configure Akeeba Restore (restore.php). Without it, resotre.php
* is completely inert, preventing abuse.
*
* @return bool
*/
public function createRestorationINI(): bool
{
// Get a password
$this->password = $this->makeRandomPassword(32);
$this->setState('password', $this->password);
// Do we have to use FTP?
$procengine = $this->getState('procengine', 'direct');
// Get the absolute path to site's root
$siteroot = JPATH_SITE;
// Get the JPS password
$password = addslashes($this->getState('jps_key'));
// Get min / max execution time
$min_exec = (int) $this->getState('min_exec', 0);
$max_exec = (int) $this->getState('max_exec', 5);
$bias = 75;
$data = " '{$this->password}',
'kickstart.tuning.max_exec_time' => '{$max_exec}',
'kickstart.tuning.run_time_bias' => '{$bias}',
'kickstart.tuning.min_exec_time' => '{$min_exec}',
'kickstart.procengine' => '$procengine',
'kickstart.setup.sourcefile' => '{$this->path}',
'kickstart.setup.destdir' => '$siteroot',
'kickstart.setup.restoreperms' => '0',
'kickstart.setup.filetype' => '{$this->extension}',
'kickstart.setup.dryrun' => '0',
'kickstart.jps.password' => '$password'
ENDDATA;
/**
* Tell the restoration script to enable stealth mode. This will have two side effects:
*
* 1. Regular visitors won't be redirected to the installation folder, potentially causing issues
* 2. If direct access to the installation folder has been blocked (ie by the Htaccess Maker) it will be allowed
*/
if ((int) $this->getState('stealthmode', 0) == 1)
{
$data .= ",\n\t 'kickstart.stealth.enable' => '1',\n\t'kickstart.stealth.url' => 'installation/offline.html'";
}
/**
* Should I enable the “Delete everything before extraction” option?
*
* This requires TWO conditions to be true:
*
* 1. The application-level configuration option showDeleteOnRestore was enabled to show the option to the user
* 2. The user has enabled this option (the Controller sets it in the zapbefore model variable)
*/
$cParams = ComponentHelper::getParams($this->option);
$shownDeleteOnRestore = $cParams->get('showDeleteOnRestore', 0) == 1;
if ($shownDeleteOnRestore && ((int) $this->getState('zapbefore', 0) == 1))
{
$data .= ",\n\t'kickstart.setup.zapbefore' => '1'";
}
// If we're using the FTP or Hybrid engine we need to set up the FTP parameters
if (in_array($procengine, ['ftp', 'hybrid']))
{
$ftp_host = $this->getState('ftp_host', '');
$ftp_port = $this->getState('ftp_port', '21');
$ftp_user = $this->getState('ftp_user', '');
$ftp_pass = addcslashes($this->getState('ftp_pass', ''), "'\\");
$ftp_root = $this->getState('ftp_root', '');
$ftp_ssl = $this->getState('ftp_ssl', 0);
$ftp_pasv = $this->getState('ftp_root', 1);
$tempdir = $this->getState('tmp_path', '');
$data .= << '$ftp_ssl',
'kickstart.ftp.passive' => '$ftp_pasv',
'kickstart.ftp.host' => '$ftp_host',
'kickstart.ftp.port' => '$ftp_port',
'kickstart.ftp.user' => '$ftp_user',
'kickstart.ftp.pass' => '$ftp_pass',
'kickstart.ftp.dir' => '$ftp_root',
'kickstart.ftp.tempdir' => '$tempdir'
ENDDATA;
}
$data .= ');';
// Remove the old file, if it's there...
$configPath = JPATH_ADMINISTRATOR . '/components/' . $this->option . '/restoration.php';
clearstatcache(true, $configPath);
if (@file_exists($configPath))
{
if (!@unlink($configPath))
{
// File::delete($configPath);
}
}
// Write new file
$result = @file_put_contents($configPath, $data);
if ($result === false)
{
// $result = File::write($configPath, $data);
}
// Clear opcode caches for the generated .php file
if (function_exists('opcache_invalidate'))
{
opcache_invalidate($configPath, true);
}
if (function_exists('apc_compile_file'))
{
apc_compile_file($configPath);
}
if (function_exists('wincache_refresh_if_changed'))
{
wincache_refresh_if_changed([$configPath]);
}
if (function_exists('xcache_asm'))
{
xcache_asm($configPath);
}
return $result;
}
/**
* Handles an AJAX request
*
* @return mixed
*/
public function doAjax()
{
$ajax = $this->getState('ajax');
$input = JoomlaFactory::getApplication()->getInput();
switch ($ajax)
{
// FTP Connection test for DirectFTP
case 'testftp':
// Grab request parameters
$config = [
'host' => $input->get('host', '', 'raw'),
'port' => $input->get('port', 21, 'int'),
'user' => $input->get('user', '', 'raw'),
'pass' => $input->get('pass', '', 'raw'),
'initdir' => $input->get('initdir', '', 'raw'),
'usessl' => $input->get('usessl', 'cmd') == 'true',
'passive' => $input->get('passive', 'cmd') == 'true',
];
// Perform the FTP connection test
$test = new Directftp();
try
{
$test->initialize('', $config);
}
catch (Exception $e)
{
return implode("\n", $this->getErrorsFromExceptions($e));
}
return true;
break;
// Unrecognized AJAX task
default:
$result = false;
break;
}
return $result;
}
/**
* Gets the list of IDs from the request data
*
* @return array
*/
protected function getIDsFromRequest()
{
// Get the ID or list of IDs from the request or the configuration
$input = JoomlaFactory::getApplication()->getInput();
$cid = $input->get('cid', [], 'array');
$id = $input->getInt('id', 0);
if (is_array($cid) && !empty($cid))
{
return array_unique(array_map(function ($x) {
return (int) $x;
}, $cid));
}
if (!empty($id))
{
return [$id];
}
return [];
}
}PK \q * src/Model/Exceptions/FrozenRecordError.phpnu [
Order allow,deny
Deny from all
PK \b src/Model/BrowserModel.phpnu [ getState('folder', '');
$processfolder = $this->getState('processfolder', 0);
if (empty($folder))
{
$folder = JPATH_SITE;
}
$stock_dirs = Platform::getInstance()->get_stock_directories();
arsort($stock_dirs);
if ($processfolder == 1)
{
foreach ($stock_dirs as $find => $replace)
{
$folder = str_replace($find, $replace, $folder);
}
}
// Normalise name, but only if realpath() really, REALLY works...
$old_folder = $folder;
$folder = @realpath($folder);
if ($folder === false)
{
$folder = $old_folder;
}
$isFolderThere = @is_dir($folder);
// Check if it's a subdirectory of the site's root
$isInRoot = (strpos($folder, JPATH_SITE) === 0);
// Check open_basedir restrictions
$isOpenbasedirRestricted = Factory::getConfigurationChecks()->checkOpenBasedirs($folder);
// -- Get the meta form of the directory name, if applicable
$folder_raw = $folder;
foreach ($stock_dirs as $replace => $find)
{
$folder_raw = str_replace($find, $replace, $folder_raw);
}
$isWritable = false;
$subfolders = [];
if ($isFolderThere && !$isOpenbasedirRestricted)
{
$isWritable = is_writable($folder);
try
{
$subfolders = Folder::folders($folder);
}
catch (\Exception $e)
{
$subfolders = [];
}
}
// In case we can't identify the parent folder, use ourselves.
$parent = $folder;
$breadcrumbs = [];
// Try to get the parent directory
$pathparts = explode(DIRECTORY_SEPARATOR, $folder);
if (is_array($pathparts))
{
$path = '';
foreach ($pathparts as $part)
{
$path .= empty($path) ? $part : DIRECTORY_SEPARATOR . $part;
if (empty($part))
{
if (DIRECTORY_SEPARATOR != '\\')
{
$path = DIRECTORY_SEPARATOR;
}
$part = DIRECTORY_SEPARATOR;
}
$breadcrumbs[] = [
'label' => $part,
'folder' => $path,
];
}
$junk = array_pop($pathparts);
$parent = implode(DIRECTORY_SEPARATOR, $pathparts);
}
$this->setState('folder', $folder);
$this->setState('folder_raw', $folder_raw);
$this->setState('parent', $parent);
$this->setState('exists', $isFolderThere);
$this->setState('inRoot', $isInRoot);
$this->setState('openbasedirRestricted', $isOpenbasedirRestricted);
$this->setState('writable', $isWritable);
$this->setState('subfolders', $subfolders);
$this->setState('breadcrumbs', $breadcrumbs);
}
}
PK \Py! ! src/Model/ConfigurationModel.phpnu [ getInput()
->get($property, $default, is_array($default) ? 'array' : 'raw');
}
catch (Exception $e)
{
}
return parent::getState($property, $default);
}
/**
* Save the engine configuration
*
* @return void
* @throws Exception
*/
public function saveEngineConfig(): void
{
/** @var CMSApplication $app */
$app = JoomlaFactory::getApplication();
$data = $this->getState('engineconfig', []);
// Forbid stupidly selecting the site's root as the output or temporary directory
if (array_key_exists('akeeba.basic.output_directory', $data))
{
$folder = $data['akeeba.basic.output_directory'];
$folder = Factory::getFilesystemTools()->translateStockDirs($folder, true, true);
$check = Factory::getFilesystemTools()->translateStockDirs('[SITEROOT]', true, true);
if ($check == $folder)
{
$data['akeeba.basic.output_directory'] = '[DEFAULT_OUTPUT]';
}
else
{
$data['akeeba.basic.output_directory'] = Factory::getFilesystemTools()->rebaseFolderToStockDirs($data['akeeba.basic.output_directory']);
}
}
// Unprotect the configuration and merge it
$config = Factory::getConfiguration();
$protectedKeys = $config->getProtectedKeys();
$config->resetProtectedKeys();
$config->mergeArray($data, false, false);
$config->setProtectedKeys($protectedKeys);
// Save configuration
Platform::getInstance()->save_configuration();
}
/**
* Test the FTP connection.
*
* @return void
* @throws RuntimeException
*/
public function testFTP(): void
{
$config = [
'host' => $this->getState('host'),
'port' => $this->getState('port'),
'username' => $this->getState('user'),
'password' => $this->getState('pass'),
'directory' => $this->getState('initdir'),
'usessl' => $this->getState('usessl'),
'passive' => $this->getState('passive'),
'passive_fix' => $this->getState('passive_mode_workaround'),
];
// Check for bad settings
if (substr($config['host'], 0, 6) == 'ftp://')
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_CONFIG_FTPTEST_BADPREFIX'), 500);
}
// Special case for cURL transport
if ($this->getState('isCurl'))
{
$test = new FtpCurl($config);
}
else
{
$test = new Ftp($config);
}
$test->connect();
// If we're here, it means that we were able to connect to the remote server. Now let's try to upload a small file
$tmp_path = JoomlaFactory::getApplication()->get('tmp_path');
$test_file = '.akeeba_test_' . substr(hash('md5', microtime()), 0, 5). '.dat';
$tmp_file = $tmp_path . '/' . $test_file;
file_put_contents($tmp_file, 'Akeeba Backup test file');
// Construct the remote file path
$realdir = substr($config['directory'], -1) == '/' ? substr($config['directory'], 0, strlen($config['directory']) - 1) : $config['directory'];
$realdir .= '/' . dirname($test_file);
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
$realname = $realdir . '/' . basename($test_file);
try
{
$ret = $test->upload($tmp_file, $realname);
}
catch (RuntimeException $e)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_CONFIG_FTPTEST_NOUPLOAD'), 500);
}
finally
{
try
{
File::delete($tmp_file);
}
catch (Exception $e)
{
// Swallow.
}
}
if (!$ret)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_CONFIG_FTPTEST_NOUPLOAD'), 500);
}
// Delete the remote file. If it fails, that's ok for us
$test->delete($realname);
}
/**
* Test the SFTP connection.
*
* @return void
* @throws RuntimeException
*/
public function testSFTP(): void
{
$config = [
'host' => $this->getState('host'),
'port' => $this->getState('port'),
'username' => $this->getState('user'),
'password' => $this->getState('pass'),
'privateKey' => $this->getState('privkey'),
'publicKey' => $this->getState('pubkey'),
'directory' => $this->getState('initdir'),
];
// Check for bad settings
if (substr($config['host'], 0, 7) == 'sftp://')
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_CONFIG_SFTPTEST_BADPREFIX'), 500);
}
// Initialize the correct object
if ($this->getState('isCurl'))
{
$test = new SftpCurl($config);
}
else
{
$test = new Sftp($config);
}
$test->connect();
// If we're here, it means that we were able to connect to the remote server. Now let's try to upload a small file
$tmp_path = JoomlaFactory::getApplication()->get('tmp_path');
$test_file = '.akeeba_test_' . substr(hash('md5', microtime()), 0, 5). '.dat';
$tmp_file = $tmp_path . '/' . $test_file;
file_put_contents($tmp_file, 'Akeeba Backup test file');
// Construct the remote file path
$realdir = substr($config['directory'], -1) == '/' ? substr($config['directory'], 0, strlen($config['directory']) - 1) : $config['directory'];
$realdir .= '/' . dirname($test_file);
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
$realname = $realdir . '/' . basename($test_file);
try
{
$test->upload($tmp_file, $realname);
}
catch (RuntimeException $e)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_CONFIG_SFTPTEST_NOUPLOAD'), 500);
}
finally
{
try
{
File::delete($tmp_file);
}
catch (Exception $e)
{
// Swallow.
}
}
// Delete the remote file. If it fails, that's ok for us
$test->delete($realname);
}
/**
* Opens an OAuth window for the selected post-processing engine
*
* @return void
* @throws Exception
*/
public function dpeOuthOpen(): void
{
$engine = $this->getState('engine');
$params = $this->getState('params', []);
// Get a callback URI for OAuth 2
$params['callbackURI'] = rtrim(Uri::base(), '/') . '/index.php?option=com_akeebabackup&view=Configuration&task=dpecustomapiraw&engine=' . $engine;
// Get the Input object
$params['input'] = JoomlaFactory::getApplication()->getInput()->getArray();
// Get the engine
$engineObject = Factory::getPostprocEngine($engine);
if (!$engineObject instanceof Base)
{
return;
}
$engineObject->oauthOpen($params);
}
/**
* Runs a custom API call for the selected post-processing engine
*
* @return mixed
*/
public function dpeCustomAPICall()
{
$engine = $this->getState('engine');
$method = $this->getState('method');
$params = $this->getState('params', []);
// Get the Input object
$params['input'] = JoomlaFactory::getApplication()->getInput()->getArray();
$engineObject = Factory::getPostprocEngine($engine);
if (!$engineObject instanceof Base)
{
return false;
}
return $engineObject->customAPICall($method, $params);
}
/**
* Test the connection to a remote FTP server using cURL transport
*
* @return void
* @throws RuntimeException
*/
private function testFtpCurl(): void
{
$options = [
'host' => $this->getState('host'),
'port' => $this->getState('port'),
'username' => $this->getState('user'),
'password' => $this->getState('pass'),
'directory' => $this->getState('initdir'),
'usessl' => $this->getState('usessl'),
'passive' => $this->getState('passive'),
'passive_fix' => $this->getState('passive_mode_workaround'),
];
$sftpTransfer = new FtpCurl($options);
$sftpTransfer->connect();
}
}PK \eG3 G3 src/Model/S3importModel.phpnu [ setState('s3access', $accessKey);
$this->setState('s3secret', $secretKey);
}
/**
* Get a list of Amazon S3 buckets.
*
* @return array
*/
public function getBuckets(): array
{
// Return cached data, if it exists
if (is_array(self::$buckets))
{
return self::$buckets;
}
// Initialise
self::$buckets = [];
// Make sure we have enough information to collect the list of bucket
if (!$this->hasAdequateInformation(false))
{
return self::$buckets;
}
// Try to retrieve the buckets
try
{
$config = $this->getS3Configuration();
$config->setRegion('us-east-1');
$s3 = $this->getS3Connector();
self::$buckets = $s3->listBuckets(false);
}
catch (Exception $e)
{
// Swallow the exception
}
// Thsi should never be triggered since listBuckets() always returns an array.
if (!is_array(self::$buckets))
{
self::$buckets = [];
}
return self::$buckets;
}
/**
* Returns the folders and archive files in an S3 bucket
*
* @return array[]
*/
public function getContents(): array
{
if (is_array(self::$folders) && is_array(self::$files))
{
return [
'files' => self::$files,
'folders' => self::$folders,
];
}
self::$files = [];
self::$folders = [];
if (!$this->hasAdequateInformation())
{
return [
'files' => self::$files,
'folders' => self::$folders,
];
}
$root = $this->getState('folder', '/');
$bucket = $this->getState('s3bucket');
$region = $this->getBucketRegion($bucket);
$config = $this->getS3Configuration();
$config->setRegion($region);
$s3 = $this->getS3Connector();
try
{
$raw = $s3->getBucket($bucket, $root, null, null, '/', true);
foreach ($raw as $name => $record)
{
if (substr($name, -8) == '$folder$')
{
continue;
}
if (array_key_exists('name', $record))
{
$extension = substr($name, -4);
if (!in_array($extension, ['.zip', '.jpa', '.jps']))
{
continue;
}
$files[$name] = $record;
}
elseif (array_key_exists('prefix', $record))
{
$folders[$name] = $record;
}
}
}
catch (Exception $e)
{
// Swallow the exception
}
return [
'files' => $files,
'folders' => $folders,
];
}
/**
* Get the breadcrumbs you'll be using in the S3 import view
*
* @return array
*/
public function getCrumbs(): array
{
$folder = $this->getState('folder', '');
$crumbs = [];
if (!empty($folder))
{
$folder = rtrim($folder, '/');
$crumbs = explode('/', $folder);
}
return $crumbs;
}
/**
* Downloads a backup archive set to the server
*
* @return bool Have I finished the import?
* @throws Exception
*/
public function downloadToServer(): bool
{
if (!$this->hasAdequateInformation())
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_S3IMPORT_ERR_NOTENOUGHINFO'));
}
/** @var CMSApplication $app */
$app = \Joomla\CMS\Factory::getApplication();
$session = $app->getSession();
// Gather the necessary information to perform the download
$part = $session->get('com_akeebabackup.s3import.part', -1);
$frag = $session->get('com_akeebabackup.s3import.frag', -1);
$remoteFilename = $this->getState('file', '');
$bucket = $this->getState('s3bucket');
$region = $this->getBucketRegion($bucket);
$config = $this->getS3Configuration();
$config->setRegion($region);
$s3 = $this->getS3Connector();
// Get the number of parts and total size from the session, or –if not there– fetch it
$totalparts = $session->get('com_akeebabackup.s3import.totalparts', -1);
$totalsize = $session->get('com_akeebabackup.s3import.totalsize', -1);
if (($totalparts < 0) || (($part < 0) && ($frag < 0)))
{
$filePrefix = substr($remoteFilename, 0, -3);
$allFiles = $s3->getBucket($bucket, $filePrefix);
$totalsize = 0;
if (count($allFiles))
{
foreach ($allFiles as $name => $file)
{
$totalsize += $file['size'];
}
}
$session->set('com_akeebabackup.s3import.totalparts', count($allFiles));
$session->set('com_akeebabackup.s3import.totalsize', $totalsize);
$session->set('com_akeebabackup.s3import.donesize', 0);
$totalparts = $session->get('com_akeebabackup.s3import.totalparts', -1);
}
// Start timing ourselves
$timer = Factory::getTimer(); // The core timer object
$start = $timer->getRunningTime(); // Mark the start of this download
$break = false; // Don't break the step
$local_file = null;
while (($timer->getRunningTime() < $this->maxTimeAllowance) && !$break && ($part < $totalparts))
{
// Get the remote and local filenames
$basename = basename($remoteFilename);
$extension = strtolower(str_replace(".", "", strrchr($basename, ".")));
$new_extension = $extension;
if ($part > 0)
{
$new_extension = substr($extension, 0, 1) . sprintf('%02u', $part);
}
$remote_filename = substr($remoteFilename, 0, -strlen($extension)) . $new_extension;
// Figure out where on Earth to put that file
$local_file = Factory::getConfiguration()
->get('akeeba.basic.output_directory') . '/' . basename($remote_filename);
// Do we have to initialize the process?
if ($part == -1)
{
// Currently downloaded size
$session->set('com_akeebabackup.s3import.donesize', 0);
// Init
$part = 0;
}
// Do we have to initialize the file?
if ($frag == -1)
{
// Delete and touch the output file
Platform::getInstance()->unlink($local_file);
$fp = @fopen($local_file, 'w');
if ($fp !== false)
{
@fclose($fp);
}
// Init
$frag = 0;
}
// Calculate from and length
$length = 1048576;
$from = $frag * $length;
$to = ($frag + 1) * $length - 1;
// Try to download the first frag
$temp_file = $local_file . '.tmp';
@unlink($temp_file);
$required_time = 1.0;
try
{
$s3->getObject($this->getState('s3bucket', ''), $remote_filename, $temp_file, $from, $to);
$result = true;
}
catch (Exception $e)
{
$result = false;
}
if (!$result)
{
// Failed download
@unlink($temp_file);
if (
(
(($part < $totalparts) || (($totalparts == 1) && ($part == 0))) &&
($frag == 0)
)
)
{
// Failure to download the part's beginning = failure to download. Period.
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_S3IMPORT_ERR_NOTFOUND'));
}
elseif ($part >= $totalparts)
{
// Just finished! Create a stats record.
$multipart = $totalparts;
$multipart--;
$filetime = time();
// Create a new backup record
$record = [
'description' => Text::_('COM_AKEEBABACKUP_DISCOVER_LABEL_IMPORTEDDESCRIPTION'),
'comment' => '',
'backupstart' => date('Y-m-d H:i:s', $filetime),
'backupend' => date('Y-m-d H:i:s', $filetime + 1),
'status' => 'complete',
'origin' => 'backend',
'type' => 'full',
'profile_id' => 1,
'archivename' => basename($remoteFilename),
'absolute_path' => dirname($local_file) . '/' . basename($remoteFilename),
'multipart' => $multipart,
'tag' => 'backend',
'filesexist' => 1,
'remote_filename' => '',
'total_size' => $totalsize,
];
$id = null;
Platform::getInstance()->set_or_update_statistics($id, $record);
return true;
}
else
{
// Since this is a staggered download, consider this normal and go to the next part.
$part++;
$frag = -1;
}
}
// Add the currently downloaded frag to the total size of downloaded files
if ($result)
{
clearstatcache();
$filesize = (int) @filesize($temp_file);
$total = $session->get('com_akeebabackup.s3import.donesize', 0);
$total += $filesize;
$session->set('com_akeebabackup.s3import.donesize', $total);
}
// Successful download, or have to move to the next part.
if ($result)
{
// Append the file
$fp = @fopen($local_file, 'a');
if ($fp === false)
{
// Can't open the file for writing
@unlink($temp_file);
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_S3IMPORT_ERR_CANTWRITE'));
}
@clearstatcache();
$tf = fopen($temp_file, 'r');
if ($tf === false)
{
@unlink($temp_file);
@fclose($fp);
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_S3IMPORT_ERR_CANTOPEN'));
}
while (!feof($tf))
{
$data = fread($tf, 262144);
fwrite($fp, $data);
}
fclose($tf);
fclose($fp);
@unlink($temp_file);
$frag++;
}
// Advance the frag pointer and mark the end
$end = $timer->getRunningTime();
// Do we predict that we have enough time?
$required_time = max(1.1 * ($end - $start), $required_time);
if ($required_time > ($this->maxTimeAllowance - $end + $start))
{
$break = true;
}
$start = $end;
}
// Pass the id, part, frag in the request so that the view can grab it
$this->setState('part', $part);
$this->setState('frag', $frag);
$session->set('com_akeebabackup.s3import.part', $part);
$session->set('com_akeebabackup.s3import.frag', $frag);
if ($part >= $totalparts)
{
// Just finished! Create a new backup record
$record = [
'description' => Text::_('COM_AKEEBABACKUP_DISCOVER_LABEL_IMPORTEDDESCRIPTION'),
'comment' => '',
'backupstart' => date('Y-m-d H:i:s'),
'backupend' => date('Y-m-d H:i:s', time() + 1),
'status' => 'complete',
'origin' => 'backend',
'type' => 'full',
'profile_id' => 1,
'archivename' => basename($remoteFilename),
'absolute_path' => dirname($local_file) . '/' . basename($remoteFilename),
'multipart' => $totalparts,
'tag' => 'backend',
'filesexist' => 1,
'remote_filename' => '',
'total_size' => $totalsize,
];
$id = null;
Platform::getInstance()->set_or_update_statistics($id, $record);
return true;
}
return false;
}
/**
* Returns the region for the bucket
*
* @param string $bucket
*
* @return string|null
*/
public function getBucketRegion(string $bucket): ?string
{
$bucketForRegion = $this->getState('bucketForRegion', null);
$region = $this->getState('region', null);
if (!empty($bucket) && (($bucketForRegion != $bucket) || empty($region)))
{
$config = $this->getS3Configuration();
$config->setRegion('us-east-1');
$s3 = $this->getS3Connector();
$region = $s3->getBucketLocation($bucket);
$this->setState('bucketForRegion', $bucket);
$this->setState('region', $region);
}
return $region;
}
/**
* Gets an S3 connector object
*
* @return Amazons3
*/
private function getS3Connector(): Amazons3
{
static $s3 = null;
if (!is_object($s3))
{
$config = $this->getS3Configuration();
$s3 = new Amazons3($config);
}
return $s3;
}
private function getS3Configuration(): Configuration
{
static $s3Config = null;
if (!is_object($s3Config))
{
$s3Access = $this->getState('s3access');
$s3Secret = $this->getState('s3secret');
$s3Config = new Configuration($s3Access, $s3Secret, 'v4', 'us-east-1');
}
return $s3Config;
}
/**
* Do I have enough information to connect to S3?
*
* @param bool $checkBucket Should I also check that a bucket name is set?
*
* @return bool
*/
private function hasAdequateInformation($checkBucket = true): bool
{
$s3access = $this->getState('s3access');
$s3secret = $this->getState('s3secret');
$s3bucket = $this->getState('s3bucket');
$check = !empty($s3access) && !empty($s3secret);
if ($checkBucket)
{
$check = $check && !empty($s3bucket);
}
return $check;
}
}PK \ P P src/Model/BackupModel.phpnu [ get('akeeba.basic.output_directory', '[DEFAULT_OUTPUT]', true);
$timer = new Timer($timeOut, 75);
// Part I. Remove these obsolete files first
$killFiles = [
'akeeba.log',
'akeeba.backend.log',
'akeeba.frontend.log',
'akeeba.cli.log',
'akeeba.json.log',
];
foreach ($killFiles as $fileName)
{
$path = $logDir . '/' . $fileName;
if (@is_file($path))
{
@unlink($path);
}
}
if ($timer->getTimeLeft() <= 0.01)
{
return;
}
// Part II. Convert .log files.
try
{
$di = new DirectoryIterator($logDir);
}
catch (Exception $e)
{
return;
}
foreach ($di as $file)
{
try
{
if (!$file->isFile())
{
continue;
}
$baseName = $file->getFilename();
if (substr($baseName, 0, 7) !== 'akeeba.')
{
continue;
}
if (substr($baseName, -4) !== '.log')
{
continue;
}
$this->convertLogFile($file->getPathname());
if ($timer->getTimeLeft() <= 0.01)
{
return;
}
}
catch (Exception $e)
{
/**
* Someone did something stupid, like using the site's root as the backup output directory while having
* an open_basedir restriction. Sorry, mate, you get insecure junk. We had warned you. You didn't heed
* the warning. That's your problem now.
*/
}
}
}
/**
* Get the default backup description.
*
* The default description is "Backup taken on DATE TIME" where DATE TIME is the current timestamp in the most
* specific timezone. The timezone order, from least to most specific, is:
* * UTC (fallback)
* * Server Timezone from Joomla's Global Configuration
* * Timezone from the current user's profile (only applicable to backend backups)
* * Forced backup timezone
*
* @param string $format Date and time format. Default: DATE_FORMAT_LC2 plus the abbreviated timezone
*
* @return string
*/
public function getDefaultDescription(string $format = ''): string
{
// If no date format is specified we use DATE_FORMAT_LC2 plus the abbreviated timezone
if (empty($format))
{
$format = Text::_('DATE_FORMAT_LC2') . ' T';
}
// Get the most specific Joomla timezone (UTC, overridden by server timezone, overridden by user timezone)
$joomlaTimezone = JoomlaFactory::getApplication()->get('offset', 'UTC');
if (!JoomlaFactory::getApplication()->isClient('cli'))
{
$user = JoomlaFactory::getApplication()->getIdentity() ?? (new User());
if (!$user->guest)
{
$joomlaTimezone = $user->getParam('timezone', $joomlaTimezone);
}
}
$timezone = $joomlaTimezone;
// The forced timezone overrides everything else
$forcedTZ = Platform::getInstance()->get_platform_configuration_option('forced_backup_timezone', 'AKEEBA/DEFAULT');
if (!empty($forcedTZ) && ($forcedTZ != 'AKEEBA/DEFAULT'))
{
$timezone = $forcedTZ;
}
// Convert the current date and time to the selected timezone
$dateNow = clone JoomlaFactory::getDate();
$tz = new DateTimeZone($timezone);
$dateNow->setTimezone($tz);
return Text::_('COM_AKEEBABACKUP_BACKUP_DEFAULT_DESCRIPTION') . ' ' . $dateNow->format($format, true);
}
/**
* Get the profile used to take the last backup for the specified tag
*
* @param string $tag The backup tag a.k.a. backup origin (backend, frontend, json, ...)
* @param string|null $backupId (optional) The Backup ID
*
* @return int The profile ID of the latest backup taken with the specified tag / backup ID
*/
public function getLastBackupProfile(string $tag, ?string $backupId = null): int
{
$filters = [
['field' => 'tag', 'value' => $tag],
];
if (!empty($backupId))
{
$filters[] = ['field' => 'backupid', 'value' => $backupId];
}
$statList = Platform::getInstance()->get_statistics_list([
'filters' => $filters,
'order' => [
'by' => 'id', 'order' => 'DESC',
],
]
);
if (is_array($statList))
{
$stat = array_pop($statList);
return (int) $stat['profile_id'];
}
// Backup entry not found. If backupId was specified, try without a backup ID
if (!empty($backupId))
{
return $this->getLastBackupProfile($tag);
}
// Else, return the default backup profile
return 1;
}
/**
* Send a push notification for a failed backup
*
* State variables expected (MUST be set):
* errorMessage The error message
*
* @return void
*/
public function pushFail()
{
$this->initialiseWebPush();
$errorMessage = $this->getState('errorMessage');
$platform = Platform::getInstance();
$key = 'COM_AKEEBABACKUP_PUSH_ENDBACKUP_FAIL_BODY_WITH_MESSAGE';
if (empty($errorMessage))
{
$key = 'COM_AKEEBABACKUP_PUSH_ENDBACKUP_FAIL_BODY';
}
$pushSubject = sprintf(
$platform->translate('COM_AKEEBABACKUP_PUSH_ENDBACKUP_FAIL_SUBJECT'),
$platform->get_site_name(),
$platform->get_host()
);
$pushDetails = sprintf(
$platform->translate($key),
$platform->get_site_name(),
$platform->get_host(),
$errorMessage
);
$push = new PushMessages();
$push->message($pushSubject, $pushDetails);
}
/**
* Starts or step a backup process. Set the state variable "ajax" to the task you want to execute OR call the
* relevant public method directly.
*
* @return array An Akeeba Engine return array
* @throws Exception
*
* @noinspection PhpUnused
*/
public function runBackup(): array
{
$this->initialiseWebPush();
if (!defined('AKEEBADEBUG') && JoomlaFactory::getApplication()->get('debug', false))
{
define('AKEEBADEBUG', 1);
}
$ret_array = [];
$ajaxTask = $this->getState('ajax');
switch ($ajaxTask)
{
// Start a new backup
case 'start':
$ret_array = $this->startBackup();
break;
// Step through a backup
case 'step':
$ret_array = $this->stepBackup();
break;
// Send a push notification for backup failure
case 'pushFail':
$this->pushFail();
break;
default:
break;
}
return $ret_array;
}
/**
* Starts a new backup.
*
* State variables expected
*
* backupid The ID of the backup. If none is set up we will create a new one in the form id123
* tag The backup tag, e.g. "frontend". If none is set up we'll get it through the Platform.
* description The description of the backup (optional)
* comment The comment of the backup (optional)
* jpskey JPS password
* angiekey ANGIE password
*
* @param array $overrides Configuration overrides
*
* @return array An Akeeba Engine return array
* @throws Exception
*/
public function startBackup(array $overrides = []): array
{
$this->initialiseWebPush();
// Get information from the model state
$tag = $this->getState('tag', null);
$description = $this->getState('description', '');
$comment = $this->getState('comment', '');
$jpskey = $this->getState('jpskey', null);
$angiekey = $this->getState('angiekey', null);
$backupId = $this->getBackupId();
$profile = JoomlaFactory::getApplication()->getSession()->get('akeebabackup.profile', defined('AKEEBA_PROFILE') ? AKEEBA_PROFILE : 1);
// Use the default description if none specified
$description = $description ?: $this->getDefaultDescription();
// Try resetting the engine
try
{
Factory::resetState([
'maxrun' => 0,
]);
}
catch (Exception $e)
{
// This will die if the output directory is invalid. Let it die, then.
}
// Remove any stale memory files left over from the previous step
if (empty($tag))
{
$tag = Platform::getInstance()->get_backup_origin();
}
$tempVarsTag = $tag;
$tempVarsTag .= empty($backupId) ? '' : ('.' . $backupId);
Factory::getFactoryStorage()->reset($tempVarsTag);
Factory::nuke();
Factory::getLog()->log(LogLevel::DEBUG, " -- Resetting Akeeba Engine factory ($tag.$backupId)");
Platform::getInstance()->load_configuration();
// Autofix the output directory
/** @var ConfigurationwizardModel $confWizModel */
$confWizModel = $this->getMVCFactory()->createModel('Configurationwizard', 'Administrator');
$confWizModel->autofixDirectories();
// Rebase Off-site Folder Inclusion filters to use site path variables
/** @var IncludefoldersModel $incFoldersModel */
$incFoldersModel = $this->getMVCFactory()->createModel('Includefolders', 'Administrator');
if (is_object($incFoldersModel) && method_exists($incFoldersModel, 'rebaseFiltersToSiteDirs'))
{
$incFoldersModel->rebaseFiltersToSiteDirs();
}
// Should I apply any configuration overrides?
if (is_array($overrides) && !empty($overrides))
{
$config = Factory::getConfiguration();
$protectedKeys = $config->getProtectedKeys();
$config->resetProtectedKeys();
foreach ($overrides as $k => $v)
{
$config->set($k, $v);
}
$config->setProtectedKeys($protectedKeys);
}
// Check if there are critical issues preventing the backup
if (!Factory::getConfigurationChecks()->getShortStatus())
{
$configChecks = Factory::getConfigurationChecks()->getDetailedStatus();
foreach ($configChecks as $checkItem)
{
if ($checkItem['severity'] != 'critical')
{
continue;
}
return [
'HasRun' => 0,
'Domain' => 'init',
'Step' => '',
'Substep' => '',
'Error' => 'Failed configuration check Q' . $checkItem['code'] . ': ' . $checkItem['description'] . '. Please refer to https://www.akeeba.com/documentation/warnings/q' . $checkItem['code'] . '.html for more information and troubleshooting instructions.',
'Warnings' => [],
'Progress' => 0,
];
}
}
// Set up Kettenrad
$options = [
'description' => $description,
'comment' => $comment,
'jpskey' => $jpskey,
'angiekey' => $angiekey,
];
if (is_null($jpskey))
{
unset ($options['jpskey']);
}
if (is_null($angiekey))
{
unset ($options['angiekey']);
}
$kettenrad = Factory::getKettenrad();
$kettenrad->setBackupId($backupId);
$kettenrad->setup($options);
$this->setState('backupid', $backupId);
/**
* Convert log files in the backup output directory
*
* This removes the obsolete, default log files (akeeba.(backend|frontend|cli|json).log and converts the old .log
* files into their .php counterparts.
*
* We are doing this when loading the the Control Panel page but ALSO when taking a new backup because some
* people might be installing updates and taking backups automatically, without visiting the Control Panel
* except in rare cases.
*/
$this->convertLogFiles(3);
/**
* We need to run tick() twice in the first backup step.
*
* The first tick() will reset the backup engine and start a new backup. However, no backup record is created
* at this point. This means that Factory::loadState() cannot find a backup record, therefore it cannot read
* the backup profile being used, therefore it will assume it's profile #1.
*
* The second tick() creates the backup record without doing much else, fixing this issue.
*
* However, if you have conservative settings where the min exec time is MORE than the max exec time the second
* tick would never run. Therefore we need to tell the first tick to ignore the time settings (since it only
* takes a few milliseconds to execute anyway) and then apply the time settings on the second tick (which also
* only takes a few milliseconds). This is why we have setIgnoreMinimumExecutionTime before and after the first
* tick. DO NOT REMOVE THESE.
*
* Furthermore, if the first tick reaches the end of backup or an error condition we MUST NOT run the second
* tick() since the engine state will be invalid. Hence the check for the state that performs a hard break. This
* could happen if you have a sufficiently high max execution time, no break between steps and we fail to
* execute any step, e.g. the installer image is missing, a database error occurred or we can not list the files
* and directories to back up.
*
* THEREFORE, DO NOT REMOVE THE LOOP OR THE if-BLOCK IN IT, THEY ARE THERE FOR A GOOD REASON!
*/
$kettenrad->setIgnoreMinimumExecutionTime(true);
for ($i = 0; $i < 2; $i++)
{
$kettenrad->tick();
if (in_array($kettenrad->getState(), [Part::STATE_FINISHED, Part::STATE_ERROR]))
{
break;
}
$kettenrad->setIgnoreMinimumExecutionTime(false);
}
$ret_array = $kettenrad->getStatusArray();
// Notify the actionlog plugin
$statistics = Factory::getStatistics();
$this->triggerEvent('onStart', [$statistics->getId(), $profile]);
try
{
Factory::saveState($tag, $backupId);
}
catch (RuntimeException $e)
{
$ret_array['Error'] = $e->getMessage();
}
return $ret_array;
}
/**
* Steps through a backup.
*
* State variables expected (MUST be set):
* backupid The ID of the backup.
* tag The backup tag, e.g. "frontend".
* profile (optional) The profile ID of the backup.
*
* @param bool $requireBackupId Should the backup ID be required?
*
* @return array An Akeeba Engine return array
* @throws Exception
*/
public function stepBackup($requireBackupId = true)
{
$this->initialiseWebPush();
// Get information from the model state
$tag = $this->getState('tag', defined('AKEEBA_BACKUP_ORIGIN') ? AKEEBA_BACKUP_ORIGIN : null);
$backupId = $this->getState('backupid', null);
// populateState() pushes the current profile number into the state.
$profile = max(0, (int) $this->getState('profile', 0)) ?: $this->getLastBackupProfile($tag, $backupId);
// Set the active profile
JoomlaFactory::getApplication()->getSession()->set('akeebabackup.profile', $profile);
if (!defined('AKEEBA_PROFILE'))
{
define('AKEEBA_PROFILE', $profile);
}
// Run a backup step
$ret_array = [
'HasRun' => 0,
'Domain' => 'init',
'Step' => '',
'Substep' => '',
'Error' => '',
'Warnings' => [],
'Progress' => 0,
];
try
{
// Reload the configuration
Platform::getInstance()->load_configuration($profile);
// Load the engine from storage
Factory::loadState($tag, $backupId, $requireBackupId);
// Set the backup ID and run a backup step
$kettenrad = Factory::getKettenrad();
$kettenrad->tick();
$ret_array = $kettenrad->getStatusArray();
}
catch (Exception $e)
{
$ret_array['Error'] = $e->getMessage();
}
try
{
if (empty($ret_array['Error']) && ($ret_array['HasRun'] != 1))
{
Factory::saveState($tag, $backupId);
}
}
catch (RuntimeException $e)
{
$ret_array['Error'] = $e->getMessage();
}
if (!empty($ret_array['Error']) || ($ret_array['HasRun'] == 1))
{
/**
* Do not nuke the Factory if we're trying to resume after an error.
*
* When the resume after error (retry) feature is enabled AND we are performing a backend backup we MUST
* leave the factory storage intact so we can actually resume the backup. If we were to nuke the Factory
* the resume would report that it cannot load the saved factory and lead to a failed backup.
*/
$config = Factory::getConfiguration();
if (JoomlaFactory::getApplication()->isClient('administrator') && $config->get('akeeba.advanced.autoresume', 1))
{
// We are about to resume; abort.
return $ret_array;
}
// Clean up
Factory::nuke();
$tempVarsTag = $tag;
$tempVarsTag .= empty($backupId) ? '' : ('.' . $backupId);
Factory::getFactoryStorage()->reset($tempVarsTag);
}
return $ret_array;
}
/**
* Converts a log file from .log to .log.php
*
* @param string $filePath
*
* @return void
*
* @since 7.0.3
*/
protected function convertLogFile(string $filePath): void
{
// The name of the converted log file is the same with the extension .php appended to it.
$newFile = $filePath . '.php';
// If the new log file exists I should return immediately
if (@file_exists($newFile))
{
return;
}
// Try to open the converted log file (.log.php)
$fp = @fopen($newFile, 'w');
if ($fp === false)
{
return;
}
// Try to open the source log file (.log)
$sourceFP = @fopen($filePath, 'r');
if ($sourceFP === false)
{
@fclose($fp);
return;
}
// Write the die statement to the source log file
fwrite($fp, '<' . '?' . 'php die(); ' . '?' . ">\n");
// Copy data, 512KB at a time
while (!feof($sourceFP))
{
$chunk = @fread($sourceFP, 524288);
if ($chunk === false)
{
break;
}
$result = fwrite($fp, $chunk);
if ($result === false)
{
break;
}
}
// Close both files
@fclose($sourceFP);
@fclose($fp);
// Delete the original (.log) file
@unlink($filePath);
}
/**
* Method to auto-populate the state.
*
* This method should only be called once per instantiation and is designed
* to be called on the first call to the getState() method unless the
* configuration flag to ignore the request is set.
*
* @return void
*
* @note Calling getState in this method will result in recursion.
* @throws Exception
* @since 9.0.0
*/
protected function populateState()
{
/** @var CMSApplication $app */
$app = JoomlaFactory::getApplication();
$input = $app->getInput();
$profile = (int) $app->getSession()->get('akeebabackup.profile', 1);
$profile = defined('AKEEBA_PROFILE') ? AKEEBA_PROFILE : $profile;
$profile = max($profile, 1);
$stateVariables = [
'tag' => $input->get('tag', null, 'string'),
'backupId' => $input->get('backupid', null, 'string'),
'description' => $input->get('description', '', 'string'),
'comment' => $input->get('comment', '', 'html'),
'jpskey' => $input->get('jpskey', null, 'raw'),
'angiekey' => $input->get('angiekey', null, 'raw'),
'profile' => $input->get('profile', $profile, 'int'),
'ajax' => $input->get('ajax', '', 'cmd'),
'errorMessage' => $input->get('errorMessage', '', 'raw'),
];
foreach ($stateVariables as $k => $v)
{
$this->setState($k, $v);
}
}
/**
* Get a new backup ID string.
*
* In the past we were trying to get the next backup record ID using two methods:
* - Querying the information_schema.tables metadata table. In many cases we saw this returning the wrong value,
* even though the MySQL documentation said this should return the next autonumber (WTF?)
* - Doing a MAX(id) on the table and adding 1. This didn't work correctly if the latest records were deleted by the
* user.
*
* However, the backup ID does not need to be the same as the backup record ID. It only needs to be *unique*. So
* this time around we are using a simple, unique ID based on the current GMT date and time.
*
* @return string
*/
private function getBackupId(): string
{
$microtime = explode(' ', microtime(false));
$microseconds = (int) ($microtime[0] * 1000000);
return 'id-' . gmdate('Ymd-His') . '-' . $microseconds;
}
/**
* Make sure we can load the Web Push helper, if needed and not already loaded
*
* @return void
* @since 9.3.1
*/
private function initialiseWebPush()
{
$pushPreference = Platform::getInstance()->get_platform_configuration_option('push_preference', '0');
if ($pushPreference !== 'webpush')
{
return;
}
if (!class_exists(WebPush::class))
{
require_once JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/autoload.php';
}
}
}PK \9 src/Model/DiscoverModel.phpnu [ translateStockDirs(
$this->getState('directory', '')
);
// Get all archive files
$files = array_filter(Factory::getFileLister()->getFiles($directory, true),
function ($file) {
$dotPos = strrpos($file, '.');
if ($dotPos === false)
{
return $dotPos;
}
$ext = strtoupper(substr($file, $dotPos + 1));
return in_array($ext, ['JPA', 'JPS', 'ZIP']);
});
// If nothing found, bail out
if (empty($files))
{
return [];
}
// Make sure these files do not already exist in another backup record
$db = $this->getDatabase();
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('absolute_path'))
->from($db->qn('#__akeebabackup_backups'))
->where($db->qn('absolute_path') . ' LIKE ' . $db->q($directory . '%'))
->where($db->qn('filesexist') . ' = ' . $db->q('1'));
try
{
$existingFiles = $db->setQuery($sql)->loadColumn();
}
catch (Exception $e)
{
$existingFiles = [];
}
$files = array_filter($files, function ($file) use ($existingFiles) {
return !in_array($file, $existingFiles);
});
// Finally sort the resulting array for easier reading
sort($files);
return $files;
}
/**
* Imports an archive file as a new backup record
*
* @param string $file The full path to the archive to import
*
* @return int|null The new backup record ID; null if the save failed without an error message
*
* @throws Exception Error when saving the backup record
*/
public function import(string $file): ?int
{
$directory = Factory::getFilesystemTools()->translateStockDirs(
$this->getState('directory', '')
);
// Find out how many parts there are
$multipart = 0;
$base = substr($file, 0, -4);
$ext = substr($file, -3);
$found = true;
$total_size = @filesize($directory . '/' . $file);
while ($found)
{
$multipart++;
$newExtension = substr($ext, 0, 1) . sprintf('%02u', $multipart);
$newFile = $directory . '/' . $base . '.' . $newExtension;
$found = file_exists($newFile);
if ($found)
{
$total_size += @filesize($newFile);
}
}
$fileModificationTime = @filemtime($directory . '/' . $file);
if (empty($fileModificationTime))
{
$fileModificationTime = time();
}
// Create a new backup record
$record = [
'description' => Text::_('COM_AKEEBABACKUP_DISCOVER_LABEL_IMPORTEDDESCRIPTION'),
'comment' => '',
'backupstart' => date('Y-m-d H:i:s', $fileModificationTime),
'backupend' => date('Y-m-d H:i:s', $fileModificationTime + 1),
'status' => 'complete',
'origin' => 'backend',
'type' => 'full',
'profile_id' => 1,
'archivename' => $file,
'absolute_path' => $directory . '/' . $file,
'multipart' => $multipart,
'tag' => 'backend',
'filesexist' => 1,
'remote_filename' => '',
'total_size' => $total_size,
];
$id = null;
$id = Platform::getInstance()->set_or_update_statistics($id, $record);
return $id;
}
}PK \H~ ~ $ src/Model/MultipledatabasesModel.phpnu [ getInclusions('db');
}
/**
* Checks if a filter is already applied
*
* @param array $newFilter Indexed array containing the filter data
*
* @return bool True if the filter already exists
* @since 7.5.0
*/
public function filterExists(array $newFilter): bool
{
// Sanity checks
if (!isset($newFilter['host']) || !isset($newFilter['database']) || !isset($newFilter['prefix']))
{
return false;
}
$filters = $this->get_databases();
foreach ($filters as $filter)
{
// If I have a filter with the same host, db name and table prefix, it means that they're the same
if (
($newFilter['host'] == $filter['host']) &&
($newFilter['database'] == $filter['database']) &&
($newFilter['prefix'] == $filter['prefix'])
)
{
return true;
}
}
return false;
}
/**
* Delete a database definition
*
* @param string $root The name of the database root key to remove
*
* @return bool True on success
*/
public function remove($root)
{
$ret = $this->applyExclusionFilter('multidb', $root, null, 'remove');
return $ret['success'];
}
/**
* Creates a new database definition
*
* @param string $root The name of the database root key
* @param array $data The connection information
*
* @return array
*/
public function setFilter($root, $data)
{
$ret = $this->applyExclusionFilter('multidb', $root, $data, 'set');
return $ret;
}
/**
* Tests the connectivity to a database
*
* @param array $data The connection information
*
* @return array Status array: 'status' is true on success, 'message' contains any error message while connecting
* to the database
*/
public function test($data)
{
try
{
$db = Factory::getDatabase($data);
$success = $db->getErrorNum() <= 0;
$error = $db->getErrorMsg();
}
catch (Exception $e)
{
$success = false;
$error = $e->getMessage();
}
if (
empty($data['driver']) || empty($data['host']) || empty($data['user']) || empty($data['password'])
|| empty($data['database'])
)
{
return [
'status' => false,
'message' => Text::_('COM_AKEEBABACKUP_MULTIDB_ERR_MISSINGINFO'),
];
}
return [
'status' => $success,
'message' => $error,
];
}
/**
* Handles a request coming in through AJAX. Basically, this is a simple proxy to the model methods.
*
* @return array
*/
public function doAjax()
{
$action = $this->getState('action');
$verb = array_key_exists('verb', $action) ? $action['verb'] : null;
$ret_array = [];
switch ($verb)
{
// Set a filter (used by the editor)
case 'set':
$ret_array = $this->setFilter($action['root'], $action['data']);
break;
// Remove a filter (used by the editor)
case 'remove':
$ret_array = ['success' => $this->remove($action['root'])];
break;
// Test connection (used by the editor)
case 'test':
$ret_array = $this->test($action['data']);
break;
}
return $ret_array;
}
}PK \\Q,
,
src/Model/ProfileModel.phpnu [ loadForm(
'com_akeebabackup.profile',
'profile',
[
'control' => 'jform',
'load_data' => $loadData,
]
);
if (empty($form))
{
return false;
}
// Modify the form based on access controls.
if (!$this->canEditState((object) $data))
{
// Disable fields for display.
$form->setFieldAttribute('quickicon', 'disabled', 'true');
// Disable fields while saving.
// The controller has already verified this is a record you can edit.
$form->setFieldAttribute('quickicon', 'filter', 'unset');
}
return $form;
}
/**
* Reset the configuration and filters of a backup profile
*
* @param int $pk Backup profile ID
*
* @return bool True if the profile exists and we can reset its configuration.
* @throws \Exception
*/
public function resetConfiguration(int $pk)
{
$table = $this->getTable();
if (!$table->load($pk))
{
/** @deprecated 10.1.0 Only for Joomla 4 b/c. Remove in 11. */
/** @noinspection PhpDeprecationInspection */
throw new \RuntimeException($table->getError());
}
$table->configuration = '';
$table->filters = '';
return $table->save([
'configuration' => '',
'filters' => '',
]);
}
/**
* Method to get the data that should be injected in the form.
*
* @return mixed The data for the form.
*
* @since 1.6
*/
protected function loadFormData()
{
// Check the session for previously entered form data.
$app = Factory::getApplication();
$data = $app->getUserState('com_akeebabackup.edit.profile.data', []);
if (empty($data))
{
$data = $this->getItem();
}
$this->preprocessData('com_akeebabackup.profile', $data);
return $data;
}
public function save($data)
{
// If we're working with the default profile, force a public access level
if (($data['id'] ?? 0) == 1)
{
$data['access'] = 1;
}
$app = Factory::getApplication();
// Perform the check on permissions only if we're not in CLI (better be safe than sorry)
if (!$app->isClient('cli'))
{
$user = $app->getIdentity();
// Wait, the user has no permissions
if (!$user->authorise('core.manage', 'com_akeebabackup'))
{
unset($data['access']);
}
}
return parent::save($data);
}
/**
* Method to test whether a record can be deleted.
*
* @param object $record A record object.
*
* @return boolean True if allowed to delete the record. Defaults to the permission set in the component.
*
* @since 1.6
*/
protected function canDelete($record)
{
if (empty($record->id))
{
return false;
}
if ($record->id == 1)
{
return false;
}
// Allow the check to be overridden by the API task
$override = $this->getState('workaround.override_canDelete');
if ($override !== null && is_bool($override))
{
return $override;
}
return parent::canDelete($record);
}
}PK \FpYH YH & src/Model/ConfigurationwizardModel.phpnu [ getInput()
->get($property, $default, is_array($default) ? 'array' : 'raw');
}
catch (Exception $e)
{
}
return parent::getState($property, $default);
}
/**
* Attempts to automatically figure out where the output and temporary directories should point, adjusting their
* permissions should it be necessary.
*
* @param bool $dontRecurse Used internally. Always skip this parameter when calling this method.
*
* @return bool True if we could fix the directories
* @throws Exception
*/
public function autofixDirectories(bool $dontRecurse = false): bool
{
// Get the output directory, translated
$engineConfig = Factory::getConfiguration();
$outputDirectory = $engineConfig->get('akeeba.basic.output_directory', '');
$fixOut = true;
// If no output directory is specified set it the default output and retry.
if (empty($outputDirectory) && !$dontRecurse)
{
/** @var ConfigurationModel $model */
$model = $this->getMVCFactory()->createModel('Configuration', 'Administrator');
$model->setState('engineconfig', [
'akeeba.basic.output_directory' => '[DEFAULT_OUTPUT]',
]);
$model->saveEngineConfig();
return $this->autofixDirectories(true);
}
// Is the folder writeable?
if (is_dir($outputDirectory))
{
$filename = $outputDirectory . '/test.dat';
$fixOut = !@file_put_contents($filename, 'test');
if (!$fixOut)
{
// Directory writable, remove the temp file
@unlink($filename);
}
}
// Do I need to change the permissions?
if ($fixOut)
{
// Try to chmod the directory
$this->chmod($outputDirectory, 511);
// Repeat the test
$filename = $outputDirectory . '/test.dat';
$fixOut = !@file_put_contents($filename, 'test');
if (!$fixOut)
{
// Directory writable, remove the temp file
@unlink($filename);
}
}
/**
* If we reached this point after recursion, we can't fix the permissions of the default backup output folder.
* The user has to manually select a writeable backup output directory (or make the default otuput writeable).
*/
if ($fixOut && $dontRecurse)
{
return false;
}
/**
* Write the output folder through the Configuration model. This ensures that:
*
* - we are not trying to use the site's root as the output folder.
* - the output folder saved in the database contains an abstracted representation of the folder, using path
* variables instead of absolute filesystem folders.
*
* @var ConfigurationModel $model
*/
$model = $this->getMVCFactory()->createModel('Configuration', 'Administrator');
// Do I have to fall back to the default output directory?
$outputDirectory = $fixOut ? '[DEFAULT_OUTPUT]' : $outputDirectory;
$previousOutputDirectory = $engineConfig->get('akeeba.basic.output_directory', '', true);
$model->setState('engineconfig', [
'akeeba.basic.output_directory' => $outputDirectory,
]);
if ($outputDirectory !== $previousOutputDirectory)
{
$model->saveEngineConfig();
}
/**
* If we had to revert to the default output we will run ourselves again to make sure that the default backup
* output folder is, in fact, writeable.
*/
if ($fixOut)
{
return $this->autofixDirectories(true);
}
return true;
}
/**
* Creates a temporary file of a specific size
*
* @param int $blocks How many 128Kb blocks to write. Common values: 1, 2, 4, 16, 40, 80, 81
* @param string|null $tempDirectory Asbolute path to the temporary directory
*
* @return bool TRUE on success
*/
public function createTempFile(int $blocks = 1, ?string $tempDirectory = null): bool
{
if (empty($tempDirectory))
{
$aeconfig = Factory::getConfiguration();
$tempDirectory = $aeconfig->get('akeeba.basic.output_directory', '');
}
$sixtyfourBytes = '012345678901234567890123456789012345678901234567890123456789ABCD';
$oneKilo = '';
$oneBlock = '';
for ($i = 0; $i < 16; $i++)
{
$oneKilo .= $sixtyfourBytes;
}
for ($i = 0; $i < 128; $i++)
{
$oneBlock .= $oneKilo;
}
$filename = tempnam($tempDirectory, 'confwiz');
@unlink($filename);
$fp = @fopen($filename, 'w');
if ($fp !== false)
{
for ($i = 0; $i < $blocks; $i++)
{
if (!@fwrite($fp, $oneBlock))
{
@fclose($fp);
@unlink($filename);
return false;
}
}
@fclose($fp);
@unlink($filename);
}
else
{
return false;
}
return true;
}
/**
* Sleeps for a given amount of time. Returns false if the sleep time requested is over the maximum execution time.
*
* @param int $secondsDelay Seconds to sleep
*
* @return bool FALSE if we cannot sleep that long
*/
public function doNothing(int $secondsDelay = 1): bool
{
// Try to get the maximum execution time and PHP memory limit
if (function_exists('ini_get'))
{
$maxexec = ini_get("max_execution_time");
$memlimit = ini_get("memory_limit");
}
else
{
$maxexec = 14;
$memlimit = 16777216;
}
// Unknown time limit; suppose 10s
if (!is_numeric($maxexec) || ($maxexec == 0))
{
$maxexec = 10;
}
// Some servers report silly values, i.e. 30000, which Do Not Work™ :(
if ($maxexec > 180)
{
$maxexec = 10;
}
// Sometimes memlimit comes with the M or K suffixes. Parse them.
if (is_string($memlimit))
{
$memlimit = strtoupper(trim(str_replace(' ', '', $memlimit)));
if (substr($memlimit, -1) == 'K')
{
$memlimit = 1024 * substr($memlimit, 0, -1);
}
elseif (substr($memlimit, -1) == 'M')
{
$memlimit = 1024 * 1024 * substr($memlimit, 0, -1);
}
elseif (substr($memlimit, -1) == 'G')
{
$memlimit = 1024 * 1024 * 1024 * substr($memlimit, 0, -1);
}
}
// Unknown limit; suppose 16M
if (!is_numeric($memlimit) || ($memlimit === 0))
{
$memlimit = 16777216;
}
// No limit; suppose 128M
if ($memlimit === -1)
{
$memlimit = 134217728;
}
// Get the current memory usage (or assume one if the metric is not available)
if (function_exists('memory_get_usage'))
{
$usedram = memory_get_usage();
}
else
{
$usedram = 7340032; // Suppose 7M of RAM usage if the metric isn't available;
}
// If we have less than 12M of RAM left, we have to limit ourselves to 6 seconds of
// total execution time (emperical value!) to avoid deadly memory outages
if (($memlimit - $usedram) < 12582912)
{
$maxexec = 5;
}
// If the requested delay is over the $maxexec limit (minus one second
// for application initialization), return false
if ($secondsDelay > ($maxexec - 1))
{
return false;
}
// And now, run the silly loop to simulate the CPU usage pattern during backup
$start = microtime(true);
$loop = true;
while ($loop)
{
// Waste some CPU power...
for ($i = 1; $i < 1000; $i++)
{
$j = exp((int)($i * $i / 123 * 864) >> 2);
unset($j);
}
// ... then sleep for a millisec
usleep(1000);
// Are we done yet?
$end = microtime(true);
if (($end - $start) >= $secondsDelay)
{
$loop = false;
}
}
return true;
}
/**
* This method will analyze your database tables and try to figure out the optimal batch row count value so that its
* SELECT doesn't return excessive amounts of data. The only drawback is that it only accounts for the core tables,
* but that is usually a good metric.
*
* @return void
*/
public function analyzeDatabase(): void
{
$memlimit = 16777216;
// Try to get the PHP memory limit
if (function_exists('ini_get'))
{
$memlimit = ini_get("memory_limit");
}
if (!is_numeric($memlimit) || ($memlimit === 0))
{
$memlimit = 16777216; // Unknown limit; suppose 16M
}
if ($memlimit === -1)
{
$memlimit = 134217728; // No limit; suppose 128M
}
// Get the current memory usage (or assume one if the metric is not available)
$usedram = 7340032;
if (function_exists('memory_get_usage'))
{
$usedram = memory_get_usage();
}
// How much RAM can I spare? It's the max memory minus the current memory usage and an extra
// 5Mb to cater for Akeeba Engine's peak memory usage
$max_mem_usage = $usedram + 5242880;
$ram_allowance = $memlimit - $max_mem_usage;
// If the RAM allowance is too low, assume 2Mb (emperical value)
if ($ram_allowance < 2097152)
{
$ram_allowance = 2097152;
}
// If SHOW TABLE STATUS is not supported this is a safe-ish value.
$rowCount = 10000;
// Get the table statistics
$db = $this->getDatabase();
if (stripos($db->getName(), 'mysql') !== false)
{
// The table analyzer only works with MySQL
$db->setQuery("SHOW TABLE STATUS");
try
{
$metrics = $db->loadAssocList();
}
catch (Exception $exc)
{
$metrics = null;
}
// SHOW TABLE STATUS is supported.
if (!empty($metrics))
{
$rowCount = 100000; // Start with the default value
foreach ($metrics as $table)
{
// Get row count and average row length
$rows = $table['Rows'];
$avg_len = $table['Avg_row_length'];
// Calculate RAM usage with current settings
$max_rows = min($rows, $rowCount);
$max_ram_current = $max_rows * $avg_len;
if ($max_ram_current > $ram_allowance)
{
// Hm... over the allowance. Let's try to find a sweet spot.
$max_rows = (int) ($ram_allowance / $avg_len);
// Quantize to multiple of 10 rows
$max_rows = 10 * floor($max_rows / 10);
// Can't really go below 10 rows / batch
if ($max_rows < 10)
{
$max_rows = 10;
}
// If the new setting is less than the current $rowCount, use the new setting
if ($rowCount > $max_rows)
{
$rowCount = $max_rows;
}
}
}
}
}
$profile_id = Platform::getInstance()->get_active_profile();
$config = Factory::getConfiguration();
// Use the correct database dump engine (only 'native' is currently supported)
$config->set('akeeba.advanced.dump_engine', 'native');
// Save the row count per batch
$config->set('engine.dump.common.batchsize', $rowCount);
// Enable SQL file splitting - default is 512K unless the part_size is less than that!
$splitSize = 524288;
$partSize = $config->get('engine.archiver.common.part_size', 0);
if (($partSize < $splitSize) && !empty($partSize))
{
$splitSize = $partSize;
}
$config->set('engine.dump.common.splitsize', $splitSize);
// Enable extended INSERTs
$config->set('engine.dump.common.extended_inserts', '1');
// Determine optimal packet size (must be at most two fifths of the split size and no more than 256K)
$packet_size = (int) $splitSize * 0.4;
if ($packet_size > 262144)
{
$packet_size = 262144;
}
$config->set('engine.dump.common.packet_size', $packet_size);
// Enable the native dump engine
$config->set('akeeba.advanced.dump_engine', 'native');
Platform::getInstance()->save_configuration($profile_id);
}
/**
* Executes the action requested through AJAX
*
* @return array
* @throws Exception
*
* @noinspection PhpUnused
*/
public function runAjax(): array
{
// Only allowed actions
$allowedActions = [
'ping', 'minexec', 'applyminexec', 'directories', 'database', 'maxexec', 'applymaxexec', 'partsize', 'flush'
];
// Get the requested action from the model state
$action = $this->getState('act');
$result = ['status' => false];
if (in_array($action, $allowedActions) && method_exists($this, $action))
{
$result = call_user_func([$this, $action]);
}
return $result;
}
/**
* Creates a dummy file of a given size. Remember to give the filesize query parameter in bytes!
*
* @return array{status: bool}
* @throws Exception
*/
public function partsize(): array
{
$timer = Factory::getTimer();
$blocks = JoomlaFactory::getApplication()->getInput()->getInt('blocks', 1);
$result = $this->createTempFile($blocks);
if ($result)
{
// Save the setting
if ($blocks > 200)
{
$blocks = 16383; // Over 25Mb = 2Gb minus 128Kb limit (safe setting for PHP not running on 64-bit Linux)
}
$profile_id = Platform::getInstance()->get_active_profile();
$config = Factory::getConfiguration();
$config->set('engine.archiver.common.part_size', $blocks * 128 * 1024);
Platform::getInstance()->save_configuration($profile_id);
}
// Enforce the min exec time
$timer->enforce_min_exec_time(false);
return ['status' => $result];
}
/**
* Pings the configuration wizard process and marks the current profile as configured
*
* @return array{status: bool}
*
* @noinspection PhpUnusedPrivateMethodInspection
*/
private function ping(): array
{
// Get the profile ID
$profile_id = Platform::getInstance()->get_active_profile();
// Set the embedded installer to the default ANGIE installer
$engineConfig = Factory::getConfiguration();
$engineConfig->set('akeeba.advanced.embedded_installer', 'angie');
// And mark this profile as already configured
$engineConfig->set('akeeba.flag.confwiz', 1);
Platform::getInstance()->save_configuration($profile_id);
return ['status' => true];
}
/**
* Try different values of minimum execution time
*
* @return array{status: bool}
* @throws Exception
*
* @noinspection PhpUnusedPrivateMethodInspection
*/
private function minexec(): array
{
$seconds = JoomlaFactory::getApplication()->getInput()
->get('seconds', '0.5', 'float');
if ($seconds < 1)
{
usleep($seconds * 1000000);
}
else
{
sleep($seconds);
}
return ['status' => true];
}
/**
* Saves the AJAX preference and the minimum execution time
*
* @return array{status: bool}
* @throws Exception
*
* @noinspection PhpUnusedPrivateMethodInspection
*/
private function applyminexec(): array
{
// Get the user parameters
$minexec = JoomlaFactory::getApplication()->getInput()
->get('minexec', 2.0, 'float');
// Save the settings
$profile_id = Platform::getInstance()->get_active_profile();
$engineConfig = Factory::getConfiguration();
$engineConfig->set('akeeba.tuning.min_exec_time', $minexec * 1000);
Platform::getInstance()->save_configuration($profile_id);
// Enforce the min exec time
$timer = Factory::getTimer();
$timer->enforce_min_exec_time(false);
// Done!
return ['status' => true];
}
/**
* Try to make the directories writable or provide a set of writable directories
*
* @return array{status: bool}
* @throws Exception
*
* @noinspection PhpUnusedPrivateMethodInspection
*/
private function directories(): array
{
$timer = Factory::getTimer();
$result = $this->autofixDirectories();
$timer->enforce_min_exec_time(false);
return ['status' => $result];
}
/**
* Analyze the database and apply optimized database dump settings
*
* @return array{status: bool}
*
* @noinspection PhpUnusedPrivateMethodInspection
*/
private function database(): array
{
$timer = Factory::getTimer();
$this->analyzeDatabase();
$timer->enforce_min_exec_time(false);
return ['status' => true];
}
/**
* Try to apply a specific maximum execution time setting
*
* @return array{status: bool}
* @throws Exception
*
* @noinspection PhpUnusedPrivateMethodInspection
*/
private function maxexec(): array
{
$seconds = JoomlaFactory::getApplication()->getInput()
->get('seconds', 30, 'int');
$timer = Factory::getTimer();
$result = $this->doNothing($seconds);
$timer->enforce_min_exec_time(false);
return ['status' => $result];
}
/**
* Save a specific maximum execution time preference to the database
*
* @return array{status: bool}
* @throws Exception
*
* @noinspection PhpUnusedPrivateMethodInspection
*/
private function applymaxexec(): array
{
// Get the user parameters
$maxexec = JoomlaFactory::getApplication()->getInput()
->get('seconds', 2, 'int');
// Save the settings
$timer = Factory::getTimer();
$profile_id = Platform::getInstance()->get_active_profile();
$config = Factory::getConfiguration();
$config->set('akeeba.tuning.max_exec_time', $maxexec);
$config->set('akeeba.tuning.run_time_bias', '75');
$config->set('akeeba.advanced.scan_engine', 'smart');
$config->set('akeeba.advanced.archiver_engine', 'jpa');
Platform::getInstance()->save_configuration($profile_id);
// Enforce the min exec time
$timer->enforce_min_exec_time(false);
// Done!
return ['status' => true];
}
/**
* Checks whether calling flush() crashes PHP
*
* @return true[]
* @see https://www.akeeba.com/support/pre-sales-requests/40667-ajax-invalid-problem.html
*/
private function flush(): array
{
$cParams = ComponentHelper::getParams('com_akeebabackup');
/** @var ComponentParameters $paramsService */
$paramsService = JoomlaFactory::getApplication()->bootComponent('com_akeebabackup')->getComponentParametersService();
// If no_flush is enabled, skip over
if ($cParams->get('no_flush', 0) == 1)
{
return ['status' => true];
}
// Set no_flush to enabled
$cParams->set('no_flush', 1);
$paramsService->save($cParams);
// Try to flush();
flush();
// Set no_flush to disabled
$cParams->set('no_flush', 0);
$paramsService->save($cParams);
return ['status' => true];
}
}PK \ +4 ' src/Model/UpgradeHandler/AngieToBrs.phpnu [ upgradeModel = $upgradeModel;
$this->dbo = $dbo;
}
public function onUpdate(?string $type = null, ?InstallerAdapter $parent = null): void
{
// Get a list of all backup profiles
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('id'))
->from($db->quoteName('#__akeebabackup_profiles'));
$profileIds = $db->setQuery($query)->loadColumn();
// Normally this should never happen as we're supposed to have at least profile #1
if (empty($profileIds))
{
return;
}
$this->loadAkeebaEngine($this->dbo);
$platform = Platform::getInstance();
$currentProfile = $platform->get_active_profile();
foreach ($profileIds as $profile)
{
// Load the profile configuration
try
{
$platform->load_configuration($profile);
$config = Factory::getConfiguration();
}
catch (\Throwable $e)
{
// Your database is broken :(
continue;
}
$currentInstaller = $config->get('akeeba.advanced.embedded_installer', 'brs');
if (strpos($currentInstaller, 'brs') === 0)
{
continue;
}
// Transcribe the local quota to remote quota settings if the legacy "Enable remote quotas" option is on.
$protected = $config->getProtectedKeys();
$config->setProtectedKeys([]);
$newInstaller = str_replace('angie', 'brs', $currentInstaller);
if (!in_array($newInstaller, ['brs', 'brs-generic']))
{
$newInstaller = 'brs';
}
$config->set('akeeba.advanced.embedded_installer', $newInstaller);
$config->setProtectedKeys($protected);
// Save the changes
try
{
$platform->save_configuration($profile);
}
catch (\Throwable $e)
{
// Your database is broken!
continue;
}
}
$platform->load_configuration($currentProfile);
}
}PK \L=8ii
i
) src/Model/UpgradeHandler/RemoteQuotas.phpnu [ upgradeModel = $upgradeModel;
$this->dbo = $dbo;
}
public function onUpdate(?string $type = null, ?InstallerAdapter $parent = null): void
{
// Get a list of all backup profiles
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('id'))
->from($db->quoteName('#__akeebabackup_profiles'));
$profileIds = $db->setQuery($query)->loadColumn();
// Normally this should never happen as we're supposed to have at least profile #1
if (empty($profileIds))
{
return;
}
$this->loadAkeebaEngine($this->dbo);
$platform = Platform::getInstance();
$currentProfile = $platform->get_active_profile();
foreach ($profileIds as $profile)
{
// Load the profile configuration
try
{
$platform->load_configuration($profile);
$config = Factory::getConfiguration();
}
catch (\Throwable $e)
{
// Your database is broken :(
continue;
}
if ($config->get('akeeba.quota.remote', 0) != 1)
{
continue;
}
// Transcribe the local quota to remote quota settings if the legacy "Enable remote quotas" option is on.
$protected = $config->getProtectedKeys();
$config->setProtectedKeys([]);
$config->set('akeeba.quota.remote', null);
$config->set('akeeba.quota.remotely.maxage.enable', $config->get('akeeba.quota.maxage.enable', 0));
$config->set('akeeba.quota.remotely.maxage.maxdays', $config->get('akeeba.quota.maxage.maxdays', 31));
$config->set('akeeba.quota.remotely.maxage.keepday', $config->get('akeeba.quota.maxage.keepday', 1));
$config->set('akeeba.quota.remotely.enable_size_quota', $config->get('akeeba.quota.enable_size_quota', 0));
$config->set('akeeba.quota.remotely.size_quota', $config->get('akeeba.quota.size_quota', 15728640));
$config->set('akeeba.quota.remotely.enable_count_quota', $config->get('akeeba.quota.enable_count_quota', 1));
$config->set('akeeba.quota.remotely.count_quota', $config->get('akeeba.quota.count_quota', 3));
$config->setProtectedKeys($protected);
// Save the changes
try
{
$platform->save_configuration($profile);
}
catch (\Throwable $e)
{
// Your database is broken!
continue;
}
}
$platform->load_configuration($currentProfile);
}
}PK \"[d9 d9 , src/Model/UpgradeHandler/MigrateSettings.phpnu [ upgradeModel = $upgradeModel;
$this->dbo = $dbo;
}
/**
* Do I need to migrate settings from pkg_akeeba?
*
* This will return true only if com_akeeba is installed AND I have not already migrated the settings.
*
* @return bool
* @since 9.0.0
*/
public function onNeedsMigration(): bool
{
$cParams = ComponentHelper::getParams('com_akeebabackup');
$alreadyMigrated = $cParams->get('migrated_from_pkg_akeeba', 0) == 1;
$hasPkgAkeeba = !empty($this->upgradeModel->getExtensionId('com_akeeba'));
return $hasPkgAkeeba && !$alreadyMigrated;
}
/**
* Do we have a compatible, old version of Akeeba Backup (com_akeeba) already installed on the site?
*
* This tries to load the version of the already installed version from the manifest cache of the old component. A
* version is compatible if it's Akeeba Backup 7 or 8 or a dev release we created anytime after January 1st, 2020
* i.e. after we had announced Akeeba Backup 7 as an upcoming release.
*
* @return bool
* @since 9.0.0
*/
public function onHasCompatibleAkeebaVersion(): bool
{
// Get the extension ID for com_akeeba
$eid = $this->upgradeModel->getExtensionId('com_akeeba');
if (empty($eid))
{
return false;
}
// Get the cached manifest of the old component (com_akeeba)
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->quoteName('manifest_cache'),
])
->from($db->quoteName('#__extensions'))
->where($db->quoteName('type') . ' = ' . $db->quote('component'))
->where($db->quoteName('element') . ' = ' . $db->quote('com_akeeba'));
try
{
$manifestCacheJson = $db->setQuery($query)->loadResult();
}
catch (Exception $e)
{
return false;
}
// JSON decode the manifest
$manifest = @json_decode($manifestCacheJson, true);
if (empty($manifest))
{
return false;
}
// Get the creation date and version
$creationDate = $manifest['creationDate'];
$version = $manifest['version'];
// If it's version 7.0.0 or later we're golden.
if (version_compare($version, '7.0.0', 'ge'))
{
return true;
}
try
{
$date = clone JoomlaFactory::getDate($creationDate);
}
catch (Exception $e)
{
return false;
}
// If we have a dev release it must be published after January 1st, 2020, i.e. the year must be 2020 or later.
if ($date->year >= 2020)
{
return true;
}
// All checks failed. This is an old version.
return false;
}
/**
* Migrate from Akeeba Backup 7.x / 8.x
*
* @return bool Always true
* @since 9.0.0
*/
public function onMigrateSettings(): bool
{
$this->migrateDownloadKey();
$this->migrateComponentOptions();
$this->migrateEngineKey();
$this->migrateDatabaseData();
$this->migrateDefaultBackupFolder();
return true;
}
public function onInstall($type, $parent)
{
JoomlaPublicFolder::savePublicFolder();
}
public function onUpdate($type, $parent)
{
JoomlaPublicFolder::savePublicFolder();
}
/**
* Migrates the component options from com_akeeba to com_akeebabackup and mark everything as migrated.
*
* @return void
* @since 9.0.0
*/
private function migrateComponentOptions(): void
{
$oldParams = ComponentHelper::getParams('com_akeeba');
$cParams = ComponentHelper::getParams('com_akeebabackup');
foreach ($oldParams->getIterator() as $key => $value)
{
$cParams->set($key, $value);
}
$cParams->set('migrated_from_pkg_akeeba', 1);
JoomlaFactory::getApplication()
->bootComponent('com_akeebabackup')
->getComponentParametersService()
->save($cParams);
}
/**
* Migrate the Akeeba Engine settings encryption key from com_akeeba to com_akeebabackup.
*
* @return void
* @since 9.0.0
*/
private function migrateEngineKey(): void
{
$oldKey = JPATH_ADMINISTRATOR . '/components/com_akeeba/BackupEngine/serverkey.php';
$newKey = JPATH_ADMINISTRATOR . '/components/com_akeebabackup/engine/serverkey.php';
if (!@file_exists($oldKey) || !@is_file($oldKey) || !@is_readable($oldKey))
{
return;
}
@copy($oldKey, $newKey);
}
/**
* Migrate the database data from com_akeeba to com_akeebabackup.
*
* @return void
* @since 9.0.0
*/
private function migrateDatabaseData(): void
{
// First, we will mass-migrate the data
$tableMap = [
'#__ak_profiles' => '#__akeebabackup_profiles',
'#__ak_stats' => '#__akeebabackup_backups',
'#__ak_storage' => '#__akeebabackup_storage',
];
$this->dbo->transactionStart();
foreach ($tableMap as $oldTable => $newTable)
{
// Remove all data from the existing table
$this->dbo->truncateTable($newTable);
// Create and run an INSERT INTO ... SELECT query to make the migrate run as fast as possible.
$outerQuery = (method_exists($this->dbo, 'createQuery') ? $this->dbo->createQuery() : $this->dbo->getQuery(true))
->select('*')
->from($this->dbo->quoteName($oldTable));
if ($oldTable === '#__ak_profiles')
{
$outerQuery->select('1 AS ' . $this->dbo->quoteName('access'));
}
$innerQuery = 'INSERT INTO ' . $this->dbo->quoteName($newTable) . ' ' . ((string) $outerQuery);
$this->dbo->setQuery($innerQuery)->execute();
}
try
{
$this->dbo->transactionCommit();
}
catch (Exception $e)
{
}
}
private function migrateDefaultBackupFolder(): void
{
$oldFolder = 'components/com_akeeba/backup';
$newFolder = 'components/com_akeebabackup/backup';
// STEP 0 - Load the migrated server key using our neat in-memory patching trick. We'll need it in step 1 below.
$this->reloadEncryptionKey();
// STEP 1 — Replace com_akeeba to com_akeebabackup in the absolute output directory path of each backup profile.
foreach ($this->getBackupProfileIDs() as $profile)
{
// Load the profile configuration
try
{
Platform::getInstance()->load_configuration($profile);
$config = Factory::getConfiguration();
}
catch (Throwable $e)
{
// Your database is broken :(
continue;
}
$outputDirectory = $config->get('akeeba.basic.output_directory', '[DEFAULT_OUTPUT]');
if (strpos($outputDirectory, $oldFolder) === false)
{
continue;
}
$outputDirectory = str_replace($oldFolder, $newFolder, $outputDirectory);
try
{
Platform::getInstance()->save_configuration($profile);
}
catch (Throwable $e)
{
// Your database is broken!
continue;
}
}
// STEP 2 — Replace com_akeeba to com_akeebabackup in the absolute file path of every backup record.
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__akeebabackup_backups'))
->set(
$db->quoteName('absolute_path') . ' = REPLACE(' .
$db->quoteName('absolute_path') . ', :find, :replace'
. ')'
)
->bind(':find', $oldFolder)
->bind(':replace', $newFolder);
$db->setQuery($query)->execute();
// STEP 3 — Move all backup archives, log files and so on
$sourceDir = JPATH_ADMINISTRATOR . '/' . $oldFolder;
$destDir = JPATH_ADMINISTRATOR . '/' . $newFolder;
try
{
$folders = Folder::files($sourceDir);
}
catch (Exception $e)
{
$folders = [];
}
foreach ($folders as $fileName)
{
$sourceFile = $sourceDir . '/' . $fileName;
$destFile = $destDir . '/' . $fileName;
if (!@rename($sourceFile, $destFile))
{
// File::move($sourceFile, $destFile);
}
}
}
/**
* Returns the IDs of all backup profiles
*
* @return array
* @since 9.0.0
*/
private function getBackupProfileIDs(): array
{
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('id'))
->from($db->quoteName('#__akeebabackup_profiles'));
$profiles = $db->setQuery($query)->loadColumn() ?: [];
return $profiles;
}
private function reloadEncryptionKey()
{
$newKey = JPATH_ADMINISTRATOR . '/components/com_akeebabackup/engine/serverkey.php';
$contents = @file_get_contents($newKey);
if ($contents === false)
{
return;
}
$contents = str_replace('AKEEBA_SERVERKEY', 'AKEEBA_MIGRATED_SERVERKEY', $contents);
BufferStreamHandler::stream_register();
file_put_contents('buffer://serverkey.php', $contents);
require_once 'buffer://serverkey.php';
if (!defined('AKEEBA_MIGRATED_SERVERKEY'))
{
[$junk, $toProcess] = explode("'AKEEBA_MIGRATED_SERVERKEY',", $contents);
$toProcess = trim($toProcess, " \t\n;php?>)");
$toProcess = trim($toProcess, '\'');
define('AKEEBA_MIGRATED_SERVERKEY', $toProcess);
}
$key = @base64_decode(AKEEBA_MIGRATED_SERVERKEY);
if (empty($key))
{
return;
}
$secSettings = Factory::getSecureSettings();
$secSettings->setKey($key);
}
private function migrateDownloadKey(): void
{
$oldEid = $this->getExtensionId('pkg_akeeba', 'package', 0);
$newEid = $this->getExtensionId('pkg_akeebabackup', 'package', 0);
if (empty($oldEid) || empty($newEid))
{
return;
}
$oldDLKey = $this->getDownloadKey($oldEid);
$newDLKey = $this->getDownloadKey($newEid);
// If I already have a key do nothing
if ($newDLKey['valid'])
{
return;
}
// If the old version does not have a key or does not support keys the Joomla 4 fall back to component options
$dlid = $oldDLKey['value'] ?? null;
if (!$oldDLKey['valid'] || !$oldDLKey['supported'])
{
$dlid = ComponentHelper::getParams('com_akeeba')->get('update_dlid', null);
}
// No Download ID to migrate? Okay, then.
if (empty($dlid))
{
return;
}
$this->setDownloadKey($newEid, $dlid);
}
private function getDownloadKey(int $extension_id): array
{
// Get the extension record
$db = $this->dbo;
$extension = new \Joomla\CMS\Table\Extension($db);
$extension->load($extension_id);
// Joomla expects the extra_query key in the object. This comes from the update site
if (method_exists($extension, 'set'))
{
/** @noinspection PhpDeprecationInspection */
$extension->set('extra_query', $this->getExtraQuery($extension_id));
}
else
{
$extension->extra_query = $this->getExtraQuery($extension_id);
}
// Use the InstallerHelper::getDownloadKey to get the current download key
return InstallerHelper::getDownloadKey($extension);
}
private function setDownloadKey(int $extension_id, ?string $downloadKey)
{
$dlKeyInfo = $this->getDownloadKey($extension_id);
if (!($dlKeyInfo['supported'] ?? false))
{
throw new RuntimeException('The extension does not support Download Keys');
}
$extraQuery = empty($downloadKey) ? null : ($dlKeyInfo['prefix'] . $downloadKey . $dlKeyInfo['suffix']);
$this->setExtraQuery($extension_id, $extraQuery);
}
private function getExtraQuery(int $extension_id): ?string
{
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('update_site_id'))
->from($db->quoteName('#__update_sites_extensions'))
->where($db->quoteName('extension_id') . ' = :eid')
->bind(':eid', $extension_id, ParameterType::INTEGER);
$usid = $db->setQuery($query)->loadResult() ?: null;
if (empty($usid))
{
return null;
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('extra_query'))
->from($db->quoteName('#__update_sites'))
->where($db->quoteName('update_site_id') . ' = :usid')
->bind(':usid', $usid, ParameterType::INTEGER);
return $db->setQuery($query)->loadResult() ?: null;
}
private function setExtraQuery(int $extension_id, ?string $extraQuery): void
{
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('update_site_id'))
->from($db->quoteName('#__update_sites_extensions'))
->where($db->quoteName('extension_id') . ' = :eid')
->bind(':eid', $extension_id, ParameterType::INTEGER);
$usid = $db->setQuery($query)->loadResult() ?: null;
if (empty($usid))
{
throw new RuntimeException('Cannot find the update site for the extension');
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__update_sites'))
->set($db->quoteName('extra_query') . ' = ' . $db->quote($extraQuery))
->where($db->quoteName('update_site_id') . ' = :usid')
->bind(':usid', $usid, ParameterType::INTEGER);
$db->setQuery($query)->execute();
}
private function getExtensionId($element, $type, $clientId): ?int
{
$db = $this->dbo;
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('extension_id'))
->from($db->quoteName('#__extensions'))
->where($db->quoteName('type') . ' = :type')
->where($db->quoteName('element') . ' = :element')
->where($db->quoteName('client_id') . ' = :client_id');
$query->bind(':type', $type, ParameterType::STRING);
$query->bind(':element', $element, ParameterType::STRING);
$query->bind(':client_id', $clientId, ParameterType::INTEGER);
return $db->setQuery($query)->loadResult() ?: null;
}
}PK \Sʉ " src/Model/UpgradeHandler/.htaccessnu 7m
Order allow,deny
Deny from all
PK \.n " src/Model/DatabasefiltersModel.phpnu [ knownFilterTypes = ['tables', 'tabledata'];
}
/**
* Returns a list of the database tables, views, procedures, functions and triggers,
* along with their filter status in array format, for use in the GUI
*
* @param string $root The database root we're working on
*
* @return array Hash array. 'tables' is an array list of tables w/ metadata. 'root' is the current db root.
*/
public function makeListing(string $root): array
{
// Get database inclusion filters
$filters = Factory::getFilters();
$database_list = $filters->getInclusions('db');
// Load the database object for the selected database
$config = $database_list[$root];
$config['user'] = $config['username'];
$db = Factory::getDatabase($config);
// Load the table data
try
{
$table_data = $db->getTables();
}
catch (Exception $e)
{
$table_data = [];
}
$tableMeta = [];
try
{
$db->setQuery('SHOW TABLE STATUS');
$temp = $db->loadAssocList();
foreach ($temp as $record)
{
$tableMeta[$db->getAbstract($record['Name'])] = [
'engine' => $record['Engine'],
'rows' => $record['Rows'],
'dataLength' => $record['Data_length'],
'indexLength' => $record['Index_length'],
];
}
}
catch (Exception $e)
{
}
// Process filters
$tables = [];
if (!empty($table_data))
{
foreach ($table_data as $table_name => $table_type)
{
$status = [
'engine' => null,
'rows' => null,
'dataLength' => null,
'indexLength' => null,
];
if (array_key_exists($table_name, $tableMeta))
{
$status = $tableMeta[$table_name];
}
// Add table type
$status['type'] = $table_type;
// Check dbobject/all filter (exclude)
$result = $filters->isFilteredExtended($table_name, $root, 'dbobject', 'all', $byFilter);
$status['tables'] = (!$result) ? 0 : (($byFilter == 'tables') ? 1 : 2);
// Check dbobject/content filter (skip table data)
$result = $filters->isFilteredExtended($table_name, $root, 'dbobject', 'content', $byFilter);
$status['tabledata'] = (!$result) ? 0 : (($byFilter == 'tabledata') ? 1 : 2);
// We can't filter contents of views, merge tables, black holes, procedures, functions and triggers
if ($table_type != 'table')
{
$status['tabledata'] = 2;
}
$tables[$table_name] = $status;
}
}
return [
'tables' => $tables,
'root' => $root,
];
}
/**
* Returns an array containing a mapping of db root names and their human-readable representation
*
* @return array Array of objects; "value" contains the root name, "text" the human-readable text
*/
public function getRoots(): array
{
// Get database inclusion filters
$filters = Factory::getFilters();
$database_list = $filters->getInclusions('db');
$ret = [];
foreach ($database_list as $name => $definition)
{
$root = $definition['host'];
if (!empty($definition['port']))
{
$root .= ':' . $definition['port'];
}
$root .= '/' . $definition['database'];
if ($name == '[SITEDB]')
{
$root = Text::_('COM_AKEEBABACKUP_DBFILTER_LABEL_SITEDB');
}
$ret[] = (object) [
'value' => $name,
'text' => $root,
];
}
return $ret;
}
/**
* Toggle a filter
*
* @param string $root Database root
* @param string $item The db entity we want to toggle the filter for
* @param string $filter The name of the filter to apply (tables, tabledata)
*
* @return array
*/
public function toggle(string $root, string $item, string $filter): array
{
return $this->applyExclusionFilter($filter, $root, $item, 'toggle');
}
/**
* Set a filter
*
* @param string $root Database root
* @param string $item The db entity we want to toggle the filter for
* @param string $filter The name of the filter to apply (tables, tabledata)
*
* @return array
*/
public function remove(string $root, string $item, string $filter): array
{
return $this->applyExclusionFilter($filter, $root, $item, 'remove');
}
/**
* Set a filter
*
* @param string $root Database root
* @param string $item The db entity we want to toggle the filter for
* @param string $filter The name of the filter to apply (tables, tabledata)
*
* @return array
*/
public function setFilter(string $root, string $item, string $filter): array
{
return $this->applyExclusionFilter($filter, $root, $item, 'set');
}
/**
* Swap a filter
*
* @param string $root Database root
* @param string $old_item The db entity that used to be filtered and will no longer be
* @param string $new_item The db entity that wasn't filtered but now will be
* @param string $filter The name of the filter to apply (tables, tabledata)
*
* @return array
*/
public function swap(string $root, string $old_item, string $new_item, string $filter): array
{
return $this->applyExclusionFilter($filter, $root, $new_item, 'swap', $old_item);
}
/**
* Retrieves the filters as an array. Used for the tabular filter editor.
*
* @param string $root The root node to search filters on
*
* @return array An array of hash arrays containing node and type for each filtered element
*/
public function getFilters(string $root): array
{
return $this->getTabularFilters($root);
}
/**
* Resets all filters
*
* @param string $root Root directory
*
* @return array
*/
public function resetFilters(string $root): array
{
$this->resetAllFilters($root);
return $this->makeListing($root);
}
/**
* Handles a request coming in through AJAX. Basically, this is a simple proxy to the model methods.
*
* @return array
*/
public function doAjax(): array
{
$action = $this->getState('action');
$verb = array_key_exists('verb', get_object_vars($action)) ? $action->verb : null;
$ret_array = [];
switch ($verb)
{
// Return a listing for the normal view
case 'list':
$ret_array = $this->makeListing($action->root);
break;
// Toggle a filter's state
case 'toggle':
$ret_array = $this->toggle($action->root, $action->node, $action->filter);
break;
// Set a filter (used by the editor)
case 'set':
$ret_array = $this->setFilter($action->root, $action->node, $action->filter);
break;
// Remove a filter (used by the editor)
case 'remove':
$ret_array = $this->remove($action->root, $action->node, $action->filter);
break;
// Swap a filter (used by the editor)
case 'swap':
$ret_array = $this->swap($action->root, $action->old_node, $action->new_node, $action->filter);
break;
// Tabular view
case 'tab':
$ret_array = [
'list' => $this->getFilters($action->root)
];
break;
// Reset filters
case 'reset':
$ret_array = $this->resetFilters($action->root);
break;
}
return $ret_array;
}
}PK \!m m src/Model/ProfilesModel.phpnu [ getSession()->get('akeebabackup.profile', null);
// Get the IDs of all profiles
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('id'))
->from($db->qn('#__akeebabackup_profiles'));
$db->setQuery($query);
$profiles = $db->loadColumn();
// Initialise return;
$engines = [];
// Loop all profiles
foreach ($profiles as $profileId)
{
Platform::getInstance()->load_configuration($profileId);
$profileConfiguration = \Akeeba\Engine\Factory::getConfiguration();
$engines[$profileId] = $profileConfiguration->get('akeeba.advanced.postproc_engine');
}
// Reload the current profile
Platform::getInstance()->load_configuration($currentProfileID);
return $engines;
}
/**
* Save a profile from imported configuration data. The $data array must contain the keys description (profile
* description), configuration (engine configuration INI data) and filters (inclusion and inclusion filters JSON
* configuration data).
*
* @param array $data See above
*
* @return int|null
*
* @throws RuntimeException|Exception When an import error occurs
*/
public function import($data): ?int
{
// Check for data validity
$isValid =
is_array($data) &&
!empty($data) &&
array_key_exists('description', $data) &&
array_key_exists('configuration', $data) &&
array_key_exists('filters', $data);
if (!$isValid)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_PROFILES_ERR_IMPORT_INVALID'));
}
// Unset the id, if it exists
if (array_key_exists('id', $data))
{
unset($data['id']);
}
$data['akeeba.flag.confwiz'] = 1;
// Try saving the profile
/** @var ProfileTable $table */
$table = $this->getTable('Profile');
$result = $table->save($data);
if (!$result)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_PROFILES_ERR_IMPORT_FAILED'));
}
return $table->getId();
}
/**
* Method to auto-populate the model state.
*
* @param string $ordering An optional ordering field.
* @param string $direction An optional direction (asc|desc).
*
* @return void
*
* @throws Exception
* @since 9.0.0
*
*/
protected function populateState($ordering = 'id', $direction = 'asc')
{
$app = Factory::getApplication();
$search = $app->getUserStateFromRequest($this->context . 'filter.search', 'filter_search', '', 'string');
$this->setState('filter.search', $search);
$search = $app->getUserStateFromRequest($this->context . 'filter.quickicon', 'filter_quickicon', '', 'string');
$this->setState('filter.quickicon', ($search === '') ? $search : (int) $search);
parent::populateState($ordering, $direction);
}
/**
* Build an SQL query to load the list data.
*
* @return DatabaseQuery|QueryInterface
*
* @throws Exception
* @since 9.0.0
*/
protected function getListQuery()
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select(['p.*', $db->quoteName('ag.title', 'access_level')])
->from($db->qn('#__akeebabackup_profiles', 'p'))
->join('LEFT', $db->quoteName('#__viewlevels', 'ag'), $db->quoteName('ag.id') . ' = ' . $db->quoteName('p.access'))
;
// Description / ID search filter
$search = $this->getState('filter.search');
if (!empty($search))
{
if (stripos($search, 'id:') === 0)
{
$ids = (int) substr($search, 3);
$query->where($db->quoteName('id') . ' = :id')
->bind(':id', $ids, ParameterType::INTEGER);
}
else
{
$search = '%' . $search . '%';
$query->where($db->qn('description') . ' LIKE :search')
->bind(':search', $search);
}
}
// Quickicon filter
$quickIcon = $this->getState('filter.quickicon');
if (is_numeric($quickIcon))
{
$query->where($db->qn('quickicon') . ' = :quickicon')
->bind(':quickicon', $quickIcon, ParameterType::INTEGER);
}
$access_levels = $this->getState('filter.access_level');
if (!empty($access_levels) && is_array($access_levels))
{
$query->whereIn($db->quoteName('p.access'), $access_levels);
}
return $query;
}
}PK \?1" " src/Model/UploadModel.phpnu [ get_statistics($id);
$returnStatus = false;
$remote_filename = null;
// The number of parts must be AT LEAST 1. If it's 0 it mean no split archive, i.e. a single part.
$stat['multipart'] = max($stat['multipart'], 1);
// Load the Factory
$savedFactory = $app->getSession()->get('akeebabackup.upload_factory', null);
$logger = Factory::getLog();
if ($savedFactory)
{
Factory::unserialize($savedFactory);
Platform::getInstance()->load_configuration($stat['profile_id']);
$logger->open('backend');
$logger->info(sprintf(
'Continuing transfer of backup record #%d (part %d, fragment %d)',
$id, $part, $frag
));
}
else
{
Platform::getInstance()->load_configuration($stat['profile_id']);
$logger->reset('backend');
$logger->info(sprintf(
"Starting transfer of the files of backup record #%d to remote storage using post-processing engine %s.",
$id,
Factory::getConfiguration()->get('akeeba.advanced.postproc_engine')));
}
// Load the post-processing engine
$config = Factory::getConfiguration();
$engine_name = $config->get('akeeba.advanced.postproc_engine');
$engine = Factory::getPostprocEngine($engine_name);
// Get the timer and reset it
$timer = Factory::getTimer();
$timer->resetTime();
while ($timer->getTimeLeft() > 0.01)
{
// Start counting the time for this part
$startTime = $timer->getRunningTime();
// Calculate the filenames
$local_filename = $stat['absolute_path'];
$basename = basename($local_filename);
$extension = strtolower(str_replace(".", "", strrchr($basename, ".")));
$new_extension = $extension;
if ($part > 0)
{
$new_extension = substr($extension, 0, 1) . sprintf('%02u', $part);
}
$local_filename = substr($local_filename, 0, -strlen($extension)) . $new_extension;
// Start uploading
try
{
$result = $engine->processPart($local_filename);
}
catch (Exception $e)
{
$app->getSession()->remove('akeebabackup.upload_factory');
throw $e;
}
if (!is_bool($result))
{
throw new LogicException(sprintf("Unexpected result from %s: %s", get_class($engine), print_r($result, true)));
}
// Stop the running timer
$endTime = $timer->getRunningTime();
$elapsedTime = $endTime - $startTime;
// What is the next part and frag to upload?
$frag++;
if ($result === true)
{
$part++;
$frag = 0;
}
// Calculate the remote filename
$remote_filename = $config->get('akeeba.advanced.postproc_engine', '') . '://';
$remote_filename .= $engine->getRemotePath();
/**
* Am I already finished?
*
* Parts are uploaded in the order 0, 1, 2, ... Part 0 is the .jpa/.jps/.zip file. Part 1 is .j01/.z01 and
* so forth.
*
* $stat['multipart'] contains the total number of parts. Let's say it's 5. This means that we need to
* upload parts 0, 1, 2, 3 and 4. When $part is 5 (or greater, even though that'd be a bug) we must stop
* at one.
*
* In the edge case where $stat['multipart'] is 1 the same thing applies. The only part we must transfer is
* 0. If $part is 1 we're done.
*
* Therefore the condition for checking whether we're all done is that $part is greater than zero (we have
* already uploaded the first and possibly only part) AND $part is greater than OR EQUAL to the total number
* of parts in the backup archive set.
*/
if (($part >= 0) && ($part >= $stat['multipart']))
{
Factory::getLog()->info(sprintf(
'Finished transfer of backup record #%d',
$id
));
// Update stats with remote filename
$data = [
'remote_filename' => $remote_filename,
];
Platform::getInstance()->set_or_update_statistics($id, $data);
// Indicate that we're all done
$returnStatus = true;
break;
}
// Do I have enough time for another fragment's upload?
if ($timer->getTimeLeft() < (2.0 * $elapsedTime))
{
break;
}
$logger->info(sprintf(
'Continuing transfer of backup record #%d (part %d, fragment %d)',
$id, $part, $frag
));
}
// Serialize the factory
$app->getSession()->set('akeebabackup.upload_factory', $returnStatus ? null : Factory::serialize());
// Should I tell the user that we have more work to do?
if (!$returnStatus)
{
Factory::getLog()->info(sprintf(
'The transfer of backup record #%d will continue on the next step',
$id
));
}
// Update the Model state
$this->setState('id', $id);
$this->setState('part', $part);
$this->setState('frag', $frag);
$this->setState('stat', $stat);
$this->setState('remotename', $remote_filename);
$timer->enforce_min_exec_time();
return $returnStatus;
}
}PK \ E E src/Model/UpdatesModel.phpnu [ version = AKEEBABACKUP_VERSION;
$this->updateSite = 'https://cdn.akeeba.com/updates/pkgakeebabackupcore.xml';
$this->updateSiteName = 'Akeeba Backup Core for Joomla!';
if (defined('AKEEBABACKUP_PRO') ? AKEEBABACKUP_PRO : 0)
{
$this->updateSite = 'https://cdn.akeeba.com/updates/pkgakeebabackuppro.xml';
$this->updateSiteName = 'Akeeba Backup Professional for Joomla!';
}
$this->extension_id = $this->findExtensionId($this->extensionKey, 'package');
if (empty($this->extension_id))
{
$this->createFakePackageExtension();
$this->extension_id = $this->findExtensionId($this->extensionKey, 'package');
}
}
/**
* Refreshes the Joomla! update sites for this extension as needed
*
* @return void
*/
public function refreshUpdateSite(): void
{
if (empty($this->extension_id))
{
return;
}
// Create the update site definition we want to store to the database
$update_site = [
'name' => $this->updateSiteName,
'type' => 'extension',
'location' => $this->updateSite,
'enabled' => 1,
'last_check_timestamp' => 0,
// 'extra_query' => 'dlid=' . $this->getLicenseKey(),
];
// Get a reference to the db driver
$db = $this->getDatabase();
// Get the update sites for our extension
$updateSiteIds = $this->getUpdateSiteIds();
if (empty($updateSiteIds))
{
$updateSiteIds = [];
}
/** @var boolean $needNewUpdateSite Do I need to create a new update site? */
$needNewUpdateSite = true;
/** @var int[] $deleteOldSites Old Site IDs to delete */
$deleteOldSites = [];
// Loop through all update sites
foreach ($updateSiteIds as $id)
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn('#__update_sites'))
->where($db->qn('update_site_id') . ' = :usid')
->bind(':usid', $id, ParameterType::INTEGER);
try
{
$aSite = $db->setQuery($query)->loadObject() ?: null;
}
catch (Exception $e)
{
$aSite = null;
}
if (empty($aSite))
{
// This update site no longer exists.
continue;
}
// We have an update site that looks like ours
if ($needNewUpdateSite && ($aSite->name == $update_site['name']) && ($aSite->location == $update_site['location']))
{
$needNewUpdateSite = false;
$mustUpdate = false;
// Is it enabled? If not, enable it.
if (!$aSite->enabled)
{
$mustUpdate = true;
$aSite->enabled = 1;
}
// Is the extra_query missing from this update site but already have an extra_query from an older one?
if (empty($aSite->extra_query) && !empty($update_site['extra_query']))
{
$mustUpdate = true;
$aSite->extra_query = $update_site['extra_query'];
}
// Update the update site if necessary
if ($mustUpdate)
{
$db->updateObject('#__update_sites', $aSite, 'update_site_id', true);
}
continue;
}
// Try to carry forward the first extra query (download key) found in the old update sites.
$update_site['extra_query'] = ($update_site['extra_query'] ?? '') ?: ($aSite->extra_query ?: '');
// In any other case we need to delete this update site, it's obsolete
$deleteOldSites[] = $aSite->update_site_id;
}
if (!empty($deleteOldSites))
{
try
{
// Delete update sites
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->delete('#__update_sites')
->whereIn($db->qn('update_site_id'), $deleteOldSites, ParameterType::INTEGER);
$db->setQuery($query)->execute();
// Delete update sites to extension ID records
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->delete('#__update_sites_extensions')
->whereIn($db->qn('update_site_id'), $deleteOldSites, ParameterType::INTEGER);
$db->setQuery($query)->execute();
}
catch (\Exception $e)
{
// Do nothing on failure
return;
}
}
// Do we still need to create a new update site?
if ($needNewUpdateSite)
{
$update_site['extra_query'] = $update_site['extra_query'] ?? '';
// No update sites defined. Create a new one.
$newSite = (object) $update_site;
$db->insertObject('#__update_sites', $newSite);
$id = $db->insertid();
$updateSiteExtension = (object) [
'update_site_id' => $id,
'extension_id' => $this->extension_id,
];
$db->insertObject('#__update_sites_extensions', $updateSiteExtension);
}
}
/**
* Gets the update site Ids for our extension.
*
* @return array An array of IDs
*/
public function getUpdateSiteIds(): array
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('update_site_id'))
->from($db->qn('#__update_sites_extensions'))
->where($db->qn('extension_id') . ' = :eid')
->bind(':eid', $this->extension_id, ParameterType::INTEGER);
try
{
$ret = $db->setQuery($query)->loadColumn(0);
}
catch (Exception $e)
{
$ret = null;
}
return is_array($ret) ? $ret : [];
}
/**
* Get the contents of all the update sites of the configured extension
*
* @return array|null
*/
public function getUpdateSites(): ?array
{
$updateSiteIDs = $this->getUpdateSiteIds();
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn('#__update_sites'))
->where($db->qn('update_site_id') . ' IN (' . implode(', ', $updateSiteIDs) . ')');
try
{
$db->setQuery($query);
$ret = $db->loadAssocList('update_site_id');
}
catch (Exception $e)
{
$ret = null;
}
return empty($ret) ? [] : $ret;
}
/**
* Gets the license key for a paid extension.
*
* On Joomla! 3 or when $forceLegacy is true we look in the component Options.
*
* On Joomla! 4 we use the information in the dlid element of the extension's XML manifest to parse the extra_query
* fields of all configured update sites of the extension. This is the same thing Joomla does when it tries to
* determine the license key of our extension when installing updates. If the extension is missing, it has no
* associated update sites, the update sites are missing / rebuilt / disassociated from the extension or the
* extra_query of all update site records is empty we parse the $extraQuery set in the constructor, if any. Also
* note that on Joomla 4 mode if the extension does not exist, does not have a manifest or does not have a valid
* dlid element in its manifest we will end up returning an empty string, just like Joomla! itself would have done
* when installing updates.
*
* @param bool $forceLegacy Should I always retrieve the legacy license key, even in J4?
*
* @return string
*/
public function getLicenseKey(bool $forceLegacy = false): string
{
// Joomla! 4. We need to parse the extra_query of the update sites to get the correct Download ID.
$updateSites = $this->getUpdateSites();
$extra_query = array_reduce($updateSites, function ($extra_query, $updateSite) {
if (!empty($extra_query))
{
return $extra_query;
}
return $updateSite['extra_query'];
}, '');
// Fall back to legacy extra query
if (empty($extra_query))
{
return '';
}
// Return the parsed results.
return $this->getLicenseKeyFromExtraQuery($extra_query);
}
/**
* Returns an object with the #__extensions table record for the current extension.
*
* @return object|null
*/
public function getExtensionObject()
{
[$extensionPrefix, $extensionName] = explode('_', $this->extensionKey);
switch ($extensionPrefix)
{
default:
case 'com':
$type = 'component';
$name = $this->extensionKey;
break;
case 'pkg':
$type = 'package';
$name = $this->extensionKey;
break;
}
// Find the extension ID
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn('#__extensions'))
->where($db->qn('type') . ' = :type')
->where($db->qn('element') . ' = :name')
->bind(':type', $type)
->bind(':name', $name);
try
{
$db->setQuery($query);
$extension = $db->loadObject();
}
catch (Exception $e)
{
return null;
}
return $extension;
}
/**
* Sanitizes the license key.
*
* YOU SHOULD OVERRIDE THIS METHOD. The default implementation returns a lowercase string with all characters except
* letters, numbers and colons removed.
*
* @param string $licenseKey
*
* @return string The sanitized license key
*/
public function sanitizeLicenseKey(string $licenseKey): string
{
return strtolower(preg_replace("/[^a-zA-Z0-9:]/", "", $licenseKey));
}
/**
* Is the provided string a valid license key?
*
* YOU SHOULD OVERRIDE THIS METHOD. The default implementation checks for valid Download IDs in the format used by
* Akeeba software.
*
* @param string $licenseKey
*
* @return bool
*/
public function isValidLicenseKey(string $licenseKey): bool
{
return preg_match('/^(\d{1,}:)?[0-9a-f]{32}$/i', $licenseKey) === 1;
}
/**
* Extract the download ID from an extra_query based on the prefix and suffix information stored in the dlid element
* of the extension's XML manifest file.
*
* @param string $extra_query
*
* @return string
*/
protected function getLicenseKeyFromExtraQuery(?string $extra_query): string
{
$extra_query = trim($extra_query ?? '');
if (empty($extra_query))
{
return '';
}
// Get the extension XML manifest. If the extension or the manifest don't exist return an empty string.
$extension = $this->getExtensionObject();
if (!$extension)
{
return '';
}
$installXmlFile = $this->getManifestXML(
$extension->element,
$extension->type,
(int) $extension->client_id,
$extension->folder
);
if (!$installXmlFile)
{
return '';
}
// If the manifest does not have a dlid element return an empty string.
if (!isset($installXmlFile->dlid))
{
return '';
}
// Naive parsing of the extra_query, the same way Joomla does.
$prefix = (string) $installXmlFile->dlid['prefix'];
$suffix = (string) $installXmlFile->dlid['suffix'];
$licenseKey = substr($extra_query, strlen($prefix));
if ($licenseKey === false)
{
return '';
}
if ($suffix !== '')
{
$licenseKey = substr($licenseKey, 0, -strlen($suffix));
}
return ($licenseKey === false) ? '' : $licenseKey;
}
/**
* Get the manifest XML file of a given extension.
*
* @param string $element element of an extension
* @param string $type type of an extension
* @param integer $client_id client_id of an extension
* @param string $folder folder of an extension
*
* @return SimpleXMLElement|bool False on failure
*/
protected function getManifestXML(string $element, string $type, int $client_id = 1, ?string $folder = null)
{
$path = ($client_id !== 0) ? JPATH_ADMINISTRATOR : JPATH_ROOT;
switch ($type)
{
case 'component':
$path .= '/components/' . $element . '/' . substr($element, 4) . '.xml';
break;
case 'plugin':
$path .= '/plugins/' . $folder . '/' . $element . '/' . $element . '.xml';
break;
case 'module':
$path .= '/modules/' . $element . '/' . $element . '.xml';
break;
case 'template':
$path .= '/templates/' . $element . '/templateDetails.xml';
break;
case 'library':
$path = JPATH_ADMINISTRATOR . '/manifests/libraries/' . $element . '.xml';
break;
case 'file':
$path = JPATH_ADMINISTRATOR . '/manifests/files/' . $element . '.xml';
break;
case 'package':
$path = JPATH_ADMINISTRATOR . '/manifests/packages/' . $element . '.xml';
}
return simplexml_load_file($path);
}
/**
* Gets the ID of an extension
*
* @param string $element Extension element, e.g. com_foo, mod_foo, lib_foo, pkg_foo or foo (CAUTION: plugin,
* file!)
* @param string $type Extension type: component, module, library, package, plugin or file
* @param null $folder Plugins: plugin folder. Modules: admin/site
*
* @return int Extension ID or 0 on failure
*/
private function findExtensionId(string $element, string $type = 'component', ?string $folder = null): int
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('extension_id'))
->from($db->qn('#__extensions'))
->where($db->qn('element') . ' = :element')
->where($db->qn('type') . ' = :type')
->bind(':element', $element, ParameterType::STRING)
->bind(':type', $type, ParameterType::STRING);
// Plugin? We should look for a folder
if ($type == 'plugin')
{
$folder = $folder ?: 'system';
$query->where($db->qn('folder') . ' = ' . $db->q($folder));
}
// Module? Use the folder to determine if it's site or admin module.
if ($type == 'module')
{
$folder = $folder ?: 'site';
$query->where($db->qn('client_id') . ' = ' . $db->q(($folder == 'site') ? 0 : 1));
}
try
{
$id = $db->setQuery($query, 0, 1)->loadResult();
}
catch (Exception $e)
{
$id = 0;
}
return empty($id) ? 0 : (int) $id;
}
private function createFakePackageExtension()
{
/** @var DatabaseDriver $db */
$db = $this->getDatabase();
$manifestCacheJson = json_encode([
'name' => 'Akeeba Backup for Joomla! package',
'type' => 'package',
'creationDate' => gmdate('Y-m-d'),
'author' => 'Nicholas K. Dionysopoulos',
'copyright' => sprintf('Copyright (c)2006-%d Akeeba Ltd / Nicholas K. Dionysopoulos', gmdate('Y')),
'authorEmail' => '',
'authorUrl' => 'https://www.akeeba.com',
'version' => $this->version,
'description' => sprintf('Akeeba Backup for Joomla! installation package v.%s', $this->version),
'group' => '',
'filename' => 'pkg_akeebabackup',
]);
$extensionRecord = [
'name' => 'Akeeba Backup for Joomla! package',
'type' => 'package',
'element' => 'pkg_akeebabackup',
'folder' => '',
'client_id' => 0,
'enabled' => 1,
'access' => 1,
'protected' => 0,
'manifest_cache' => $manifestCacheJson,
'params' => '{}',
'checked_out' => 0,
'checked_out_time' => null,
'state' => 0,
];
$extension = new Extension($db);
$extension->save($extensionRecord);
$this->createFakePackageManifest();
}
private function createFakePackageManifest()
{
$path = sprintf("%s/manifests/packages/%s.xml", JPATH_ADMINISTRATOR, $this->extensionKey);
if (file_exists($path))
{
return;
}
$isPro = defined('AKEEBABACKUP_PRO') ? AKEEBABACKUP_PRO : 0;
$proCore = $isPro ? 'pro' : 'core';
$dlid = $isPro ? '' : '';
$year = gmdate('Y');
$date = gmdate('Y-m-d');
$proPlugins = <<< END
plg_console_akeebabackup.zipplg_system_backuponupdate.zipplg_actionlog_akeebabackup.zip
END;
$proPlugins = $isPro ? $proPlugins : '';
$content = <<< XML
$dlid
Akeeba Backup for Joomla! packageNicholas K. Dionysopoulos$dateakeebabackup{$this->version}https://www.akeeba.comAkeeba Ltdhttps://www.akeeba.comCopyright (c)2006-$year Akeeba Ltd / Nicholas K. DionysopoulosGNU GPL v3 or laterAkeeba Backup for Joomla! installation package {$this->version}com_akeebabackup-{$proCore}.zipplg_quickicon_akeebabackup.zip
$proPlugins
script.akeebabackup.php
XML;
if (!@file_put_contents($content, $path))
{
// File::write($path, $content);
}
}
}PK \" ˵ ˵ src/Model/UpgradeModel.phpnu [ [
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Model/UsageStatisticsModel.php',
// Remove iDriveSync — the service has been discontinued
JPATH_ADMINISTRATOR . 'administrator/components/com_akeebabackup/vendor/akeeba/engine/Postproc/idrivesync.json',
JPATH_ADMINISTRATOR . 'administrator/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Idrivesync.php',
JPATH_ADMINISTRATOR . 'administrator/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Connector/Idrivesync.php',
// Remove Piecon
JPATH_ADMINISTRATOR . 'media/com_akeebabackup/js/piecon.js',
JPATH_ADMINISTRATOR . 'media/com_akeebabackup/js/piecon.min.js',
JPATH_ADMINISTRATOR . 'media/com_akeebabackup/js/piecon.min.js.map',
// Legacy helpers
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Helper/CacheCleaner.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Helper/ComponentParams.php',
// Legacy filters
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Stack/StackMyjoomla.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Stack/myjoomla.json',
// Legacy usage stats collection
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Helper/usagestats.php',
// Old ANGIE restoration script
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/angie-generic.jpa',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/angie-generic.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/angie-joomla.jpa',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/angie-joomla.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/angie.jpa',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/angie.json',
// Old copy of Kickstart
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/kickstart.txt',
],
'folders' => [
JPATH_ADMINISTRATOR . 'administrator/components/com_akeebabackup/platform/Joomla/Finalization',
// Legacy traits
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Controller/Mixin',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Dispatcher/Mixin',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Model/Mixin',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/Table/Mixin',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/View/Mixin',
// Legacy folders (these dependencies are now imported through Composer)
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/engine',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/webpush',
],
];
/**
* Files and folders to remove ONLY from the Core version
*
* @var array[]
*/
private const REMOVE_FROM_CORE = [
'files' => [
// Pro engine features
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/Directftp.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/directftp.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/Directftpcurl.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/directftpcurl.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/Directsftp.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/directsftp.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/Directsftpcurl.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/directsftpcurl.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/Jps.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/jps.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/Zipnative.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Archiver/zipnative.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Connector/**"',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/amazons3.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Amazons3.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/azure.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Azure.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/backblaze.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Backblaze.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/box.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Box.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/cloudfiles.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Cloudfiles.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/cloudme.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Cloudme.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/dreamobjects.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Dreamobjects.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/dropbox.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Dropbox.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/dropbox2.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Dropbox2.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/ftp.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Ftp.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/ftpcurl.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Ftpcurl.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/googledrive.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Googledrive.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/googlestorage.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Googlestorage.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/googlestoragejson.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Googlestoragejson.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/idrivesync.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Idrivesync.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/onedrive.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Onedrive.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/onedrivebusiness.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Onedrivebusiness.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/ovh.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Ovh.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/pcloud.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Pcloud.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/s3.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/S3.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/sftp.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Sftp.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/sftpcurl.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Sftpcurl.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/sugarsync.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Sugarsync.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/swift.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Swift.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/webdav.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Postproc/Webdav.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Scan/large.json',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/vendor/akeeba/engine/Scan/Large.php',
// Kickstart, used for Site Transfer Wizard
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/kickstart.txt',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/kickstart.dat',
// Pro features: Controllers
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/AliceController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/DiscoverController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/IncludefoldersController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/MultipledatabasesController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/RegexdatabasefiltersController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/RegexfilefiltersController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/RemoteFilesController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/RestoreController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/ScheduleController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/S3importController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/TransferController.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Controller/UploadController.php',
// Pro features: Models
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/AliceModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/DiscoverModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/IncludefoldersModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/MultipledatabasesModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/RegexdatabasefiltersModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/RegexfilefiltersModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/RemoteFilesModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/RestoreModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/ScheduleModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/S3importModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/TransferModel.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/Model/UploadModel.php',
// Pro features: Platform files
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Components.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Extensiondirs.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Extensionfiles.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Languages.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Modules.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Plugins.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Filter/Templates.php',
// Pro features: integrated restoration — Should be removed by Joomla itself
// JPATH_ADMINISTRATOR . '/components/com_akeebabackup/restore.php',
],
'folders' => [
// Pro features: API application — Should be removed by Joomla itself
// JPATH_API . '/components/com_akeebabackup',
// Pro features: ALICE — Should be removed by Joomla itself
// JPATH_ADMINISTRATOR . '/components/com_akeebabackup/AliceChecks',
// Pro features: Joomla CLI integration
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/src/CliCommands',
// Pro features: Views
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Alice',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Discover',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Includefolders',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Multipledatabases',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Regexdatabasefilters',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Regexfilefilters',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/RemoteFiles',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Restore',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Schedule',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/S3import',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Transfer',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/View/Upload',
// Pro features: View templates
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Alice',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Discover',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Includefolders',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Multipledatabases',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Regexdatabasefilters',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Regexfilefilters',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/RemoteFiles',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Restore',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Schedule',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/S3import',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Transfer',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/tmpl/Upload',
// Pro features: Platform folders
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Config/Pro',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/platform/Joomla/Finalization',
// Pro features: Frontend controllers — Should be removed by Joomla itself
// JPATH_SITE . '/src/Controller',
// Pro features: Frontend models — Should be removed by Joomla itself
// JPATH_SITE . '/src/Model',
],
];
/** @var string[] Included extensions to automatically publish on a NEW INSTALLATION */
private const ENABLE_EXTENSIONS = [
'plg_quickicon_akeebabackup',
'plg_system_backuponupdate',
];
/** @var string[] Included extensions to automatically publish on NEW INSTALLATION OR UPGRADE */
private const ALWAYS_ENABLE_EXTENSIONS = [
'plg_console_akeebabackup',
'plg_pagecache_akeebabackup',
'plg_system_akwarn',
'plg_task_akeebabackup',
'plg_webservices_akeebabackup',
];
/** @var string[] Extensions to always uninstall if they are still installed (runs on install and upgrade) */
private const REMOVE_EXTENSIONS = [];
/** @var string[] Included extensions to be uninstalled when installing the Core version */
private const PRO_ONLY_EXTENSIONS = [
'plg_console_akeebabackup',
'plg_system_backuponupdate',
'plg_actionlog_akeebabackup',
'plg_task_akeebabackup',
'plg_webservices_akeebabackup',
'plg_pagecache_akeebabackup',
];
/** @var string Relative directory to the custom handlers */
private const CUSTOM_HANDLERS_DIRECTORY = 'UpgradeHandler';
/**
* The database driver.
*
* @var DatabaseInterface
* @since 9.3.0
*/
protected $_db;
/**
* List of extensions included in both old and new packages (if applicable)
*
* @var array
*/
private $extensionsList;
/**
* Caches the extension names to IDs so we don't query the database too many times.
*
* @var array
*/
private $extensionIds = [];
/**
* UpgradeModel custom handlers, implementing custom logic for each extension.
*
* @var object[]
*/
private $customHandlers = [];
public function init()
{
// Find out the common extensions
if ($this->isSamePackage())
{
$this->extensionsList = $this->getExtensionsFromPackage(self::PACKAGE_NAME);
}
else
{
$oldExtensions = $this->getExtensionsFromPackage(self::OLD_PACKAGE_NAME);
$newExtensions = $this->getExtensionsFromPackage(self::PACKAGE_NAME);
$this->extensionsList = array_intersect($newExtensions, $oldExtensions);
}
// Load extension-specific adapters
$this->loadCustomHandlers();
}
/**
* Handles the package's post-flight routine
*
* @param string $type Which action is happening (install|uninstall|discover_install|update)
* @param PackageAdapter|null $parent The object responsible for running this script. NULL if running outside
* of the package's script.
*
* @return bool
*/
public function postflight(string $type, ?PackageAdapter $parent = null): bool
{
switch ($type)
{
// Brand new installation (regular or through Discover)
case 'install':
case 'discover_install':
$this->runIsolated([
'upgradeFromOldPackage',
'uninstallExtensions',
'publishExtensionsOnInstall',
'publishExtensionsAlways',
'removeObsoleteFiles',
'adoptMyExtensions',
]);
$this->runCustomHandlerEvent('onInstall', $type, $parent);
break;
// Update to a new version
case 'update':
default:
$this->runIsolated([
'removeObsoleteFiles',
'publishExtensionsAlways',
'uninstallExtensions',
'uninstallProExtensions',
'adoptMyExtensions',
]);
$this->runCustomHandlerEvent('onUpdate', $type, $parent);
break;
// Uninstallation
case 'uninstall':
$this->runCustomHandlerEvent('onUninstall', $type, $parent);
break;
}
return true;
}
/**
* Runs an event across all custom handler objects.
*
* @param string $eventName The name of the event to run
* @param mixed ...$arguments Arguments to the event
*
* @return array The results of the custom handler events.
*/
public function runCustomHandlerEvent(string $eventName, ...$arguments): array
{
$result = [];
foreach ($this->customHandlers as $adapter)
{
if (!method_exists($adapter, $eventName))
{
continue;
}
try
{
$result[] = $adapter->{$eventName}(...$arguments);
}
catch (Throwable $e)
{
if (defined('JDEBUG') && JDEBUG)
{
Factory::getApplication()->enqueueMessage($e->getMessage());
}
}
}
return $result;
}
/**
* Returns the extension ID for a Joomla extension given its name.
*
* This is deliberately public so that custom handlers can use it without having to reimplement it.
*
* @param string $extension The extension name, e.g. `plg_system_example`.
*
* @return int|null The extension ID or null if no such extension exists
*/
public function getExtensionId(string $extension): ?int
{
if (isset($this->extensionIds[$extension]))
{
return $this->extensionIds[$extension];
}
$this->extensionIds[$extension] = null;
$criteria = $this->extensionNameToCriteria($extension);
if (empty($criteria))
{
return $this->extensionIds[$extension];
}
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('extension_id'))
->from($db->quoteName('#__extensions'));
foreach ($criteria as $key => $value)
{
$type = is_numeric($value) ? ParameterType::INTEGER : ParameterType::STRING;
$type = is_bool($value) ? ParameterType::BOOLEAN : $type;
$type = is_null($value) ? ParameterType::NULL : $type;
/**
* This is required since $value is passed by reference in bind(). If we do not do this unholy trick the
* $value variable is overwritten in the next foreach() iteration, therefore all criteria values will be
* equal to the last value iterated. Groan...
*/
$varName = 'queryParam' . ucfirst($key);
${$varName} = $value;
$query->where($db->qn($key) . ' = :' . $key)
->bind(':' . $key, ${$varName}, $type);
}
try
{
$this->extensionIds[$extension] = (int) $db->setQuery($query)->loadResult();
}
catch (RuntimeException $e)
{
return null;
}
return $this->extensionIds[$extension];
}
/**
* Adopt the extensions by new package.
*
* This modifies the package_id column of the #__extensions table for the records of the extensions declared in the
* new package's manifest. This allows you to use Discover to install new extensions without leaving them “orphan”
* of a package in the #__extensions table, something which could cause problems when running Joomla! Update.
*
* @return void
*/
public function adoptMyExtensions(): void
{
// Get the extension ID of the new package
$newPackageId = $this->getExtensionId(self::PACKAGE_NAME);
if (empty($newPackageId))
{
return;
}
// Get the extension IDs
$extensionIDs = array_map([$this, 'getExtensionId'], $this->getExtensionsFromPackage(self::PACKAGE_NAME));
$extensionIDs = array_filter($extensionIDs, function ($x) {
return !empty($x);
});
if (empty($extensionIDs))
{
return;
}
/**
* Looks stupid? This realigns the integer keys because whereIn() expects 0-based, monotonically increasing
* array keys. Otherwise it ends up emitting null values. GROAN!
*/
$extensionIDs = array_merge($extensionIDs);
// Reassign all extensions
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__extensions'))
->set($db->qn('package_id') . ' = :package_id')
->whereIn($db->qn('extension_id'), $extensionIDs, ParameterType::INTEGER)
->bind(':package_id', $newPackageId, ParameterType::INTEGER);
$db->setQuery($query)->execute();
}
/**
* Handle the package upgrade from the old to the new package.
*
* These versions would also run on Joomla 4 but are replaced with this new package. Since the package name is
* different but some of the included extensions are under the same name we need to deal with them. Namely, we need
* to:
*
* * Change the `package_id` in the `#__extensions` table to that of the new `pkg_akeebabackup` package. This is
* currently not used anywhere(?) but it might be the case that Joomla finalyl decides to prevent standalone
* uninstallation of extensions which are part of a package.
* * Remove the extensions from the `#__akeeba_common` entries which mark them as dependent on FOF 3.x or 4.x. This
* is so that FOF 3.x / 4.x can be uninstalled when the old package (`pkg_akeeba`) is being uninstalled, since
* these extensions will NOT be removed with it, per the item below.
* * Edit the cached XML manifest file of the old `pkg_akeeba` package so that it doesn't try to uninstall the
* extensions it has in common with the new `pkg_akeebabackup` package. Joomla SHOULD figure this out by means of
* the recorded `package_id` in the `#__extensions` table but it currently doesn't seem to have any code to do
* that. Therefore editing the cached XML manifest is the only reasonable way to do this.
*
* @return void
* @noinspection PhpUnused
*/
protected function upgradeFromOldPackage(): void
{
if ($this->isSamePackage())
{
$this->unregisterFromFOF('3');
$this->unregisterFromFOF('4');
return;
}
if (!$this->hasOldPackage())
{
return;
}
$this->reassignExtensions();
/** @noinspection PhpRedundantOptionalArgumentInspection */
$this->unregisterFromFOF('3');
$this->unregisterFromFOF('4');
$this->removeExtensionsFromPackageManifest();
}
/**
* Publish a list of extensions.
*
* Used to publish various plugins when you install the package.
*
* @return void
*/
protected function publishExtensionsOnInstall(?array $extensionsList = null): void
{
$extensionsList = $extensionsList ?? self::ENABLE_EXTENSIONS;
$extensionIDs = array_map([$this, 'getExtensionId'], $extensionsList);
$extensionIDs = array_filter($extensionIDs, function ($x) {
return !empty($x);
});
if (empty($extensionIDs))
{
return;
}
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__extensions'))
->set($db->qn('enabled') . ' = 1')
->whereIn($db->quoteName('extension_id'), $extensionIDs);
try
{
$db->setQuery($query)->execute();
}
catch (RuntimeException $e)
{
return;
}
}
protected function publishExtensionsAlways()
{
$this->publishExtensionsOnInstall(self::ALWAYS_ENABLE_EXTENSIONS);
}
/**
* Removes obsolete files and folders.
*
* This is required because Joomla's extensions installer will only check for the top-level files and directories
* listed in the XML manifest. Any folders and files deeper than that will not be removed automatically.
*
* @return void
* @noinspection PhpUnused
*/
protected function removeObsoleteFiles(): void
{
// We will definitely remove REMOVE_FROM_ALL_VERSIONS in all versions
$removeSource = self::REMOVE_FROM_ALL_VERSIONS;
$isPro = $isPro ?? $this->isPro();
if (!$isPro)
{
$removeSource['files'] = array_merge($removeSource['files'], self::REMOVE_FROM_CORE['files']);
$removeSource['folders'] = array_merge($removeSource['folders'], self::REMOVE_FROM_CORE['folders']);
}
// Remove files
foreach ($removeSource['files'] as $file)
{
if (!is_file($file))
{
continue;
}
try
{
File::delete($file);
}
catch (\Exception $e)
{
// Swallow.
}
}
// Remove folders
foreach ($removeSource['folders'] as $folder)
{
$this->deleteFolder($folder);
}
}
/**
* Uninstalls the extensions which are marked as always to be uninstalled.
*
* @return void
* @noinspection PhpUnused
*/
protected function uninstallExtensions(): void
{
// Tell Joomla to uninstall the extensions always meant to be removed.
foreach (self::REMOVE_EXTENSIONS as $extension)
{
$this->uninstallExtension($extension);
}
}
/**
* Uninstalls Pro-only extensions from the Core version of the package.
*
* @return void
* @noinspection PhpUnused
*/
protected function uninstallProExtensions(): void
{
// If it's the Pro version we don't uninstall anything.
if ($this->isPro())
{
return;
}
// Tell Joomla to uninstall the Pro-only extensions.
foreach (self::PRO_ONLY_EXTENSIONS as $extension)
{
$this->uninstallExtension($extension);
}
}
private function deleteFolder(string $path): bool
{
// If the folder does not exist in the requested form return early.
$hasMixedCase = is_dir($path);
if (!$hasMixedCase)
{
return false;
}
// If the folder is all lowercase return early.
$baseName = basename($path);
$lowercaseBaseName = strtolower($baseName);
if ($baseName === $lowercaseBaseName)
{
try
{
return $hasMixedCase && Folder::delete($path);
}
catch (\Exception $e)
{
return false;
}
}
// We have a mixed case folder. Further investigation necessary.
$altPath = dirname($path) . '/' . $lowercaseBaseName;
$hasLowercase = is_dir($altPath);
// If the lowercase path does not exist we have a case-sensitive filesystem. Return early.
if (!$hasLowercase)
{
try
{
return $hasMixedCase && Folder::delete($path);
}
catch (\Exception $e)
{
return false;
}
}
// Both folders exist. Are they the same?
$testBasename = UserHelper::genRandomPassword(8) . '.dat';
$data = UserHelper::genRandomPassword(32);
$lowercaseTestFile = $altPath . '/' . $testBasename;
$uppercaseTestFile = $path . '/' . $testBasename;
try
{
File::write($lowercaseTestFile, $data);
}
catch (\Exception $e)
{
// Swallow.
}
$readData = file_get_contents($uppercaseTestFile);
try
{
File::delete($lowercaseTestFile);
}
catch (\Exception $e)
{
// Swallow.
}
// The two folders are different. We have a case-sensitive filesystem. Proceed with deletion.
if ($readData !== $data)
{
try
{
return Folder::delete($path);
}
catch (\Exception $e)
{
return false;
}
}
/**
* The two folders are identical.
*
* It is impossible to know if the folder is written on disk as lowercase or mixed case. We must rename it to
* all lowercase. If we don't, moving the site to a case-sensitive filesystem will break it (the folder will be
* in the wrong case!). Therefore we have to do a two-step process to effect the rename on a case-insensitive
* filesystem...
*/
$intermediateBasename = $lowercaseBaseName . '_' . UserHelper::genRandomPassword(8);
$intermediatePath = dirname($path) . '/' . $intermediateBasename;
try
{
Folder::move($path, $intermediatePath);
Folder::move($intermediatePath, $altPath);
}
catch (\Exception $e)
{
return false;
}
return false;
}
/**
* Runs a method inside a try/catch block to suppress any errors
*
* @param string[] $methodNames The method name to run
*
* @return void
*/
private function runIsolated(array $methodNames): void
{
foreach ($methodNames as $methodName)
{
try
{
$this->{$methodName}();
}
catch (Throwable $e)
{
// No problem, let's move on.
}
}
}
/**
* Does the old package even exist?
*
* @return bool
*/
private function hasOldPackage(): bool
{
if (empty(self::OLD_PACKAGE_NAME))
{
return false;
}
$eid = $this->getExtensionId(self::OLD_PACKAGE_NAME);
return !empty($eid);
}
/**
* Reassign the extensions to the new package.
*
* This modifies the package_id column of the #__extensions table for the records of the records defined in
* $this->extensionsList. Since these are shared between the old and new packages we need to change their package ID
* to the new package's ID. Otherwise Joomla might be confused as to which package "owns" them.
*
* @return void
*/
private function reassignExtensions(): void
{
// Get the extension ID of the new package
$newPackageId = $this->getExtensionId(self::PACKAGE_NAME);
if (empty($newPackageId))
{
return;
}
// Get the extension IDs
$extensionIDs = array_map([$this, 'getExtensionId'], $this->extensionsList);
$extensionIDs = array_filter($extensionIDs, function ($x) {
return !empty($x);
});
if (empty($extensionIDs))
{
return;
}
/**
* Looks stupid? This realigns the integer keys because whereIn() expects 0-based, monotonically increasing
* array keys. Otherwise it ends up emitting null values. GROAN!
*/
$extensionIDs = array_merge($extensionIDs);
// Reassign all extensions
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__extensions'))
->set($db->qn('package_id') . ' = :package_id')
->whereIn($db->qn('extension_id'), $extensionIDs, ParameterType::INTEGER)
->bind(':package_id', $newPackageId, ParameterType::INTEGER);
$db->setQuery($query)->execute();
}
/**
* Unregisters a list of extensions from being marked as dependent on the specified FOF version.
*
* @param string $fofVersion PHP version to unregister the extensions from
*
* @return void
*/
private function unregisterFromFOF($fofVersion = '3')
{
// Make sure we have an extensions list and it's canonical (admin modules have mod_ prefix, not amod_).
$extensions = $this->extensionsList;
$extensions = array_map(function ($name) {
if (substr($name, 0, 5) == 'amod_')
{
$name = 'mod_' . substr($name, 5);
}
return $name;
}, $extensions);
// Get the existing list of extensions dependent on the specified version of FOF.
$keyName = 'fof' . $fofVersion . '0';
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('value'))
->from($db->quoteName('#__akeeba_common'))
->where($db->quoteName('key') . ' = :keyName')
->bind(':keyName', $keyName);
try
{
$json = $db->setQuery($query)->loadResult();
$list = ($json === null) ? [] : json_decode($json, true);
}
catch (RuntimeException $e)
{
return;
}
// If the list is empty I am already done.
if (is_null($list) || !is_array($list))
{
return;
}
// Remove the common extensions which no longer depend on FOF.
$list = array_diff($list, $extensions);
$json = json_encode($list);
// Update the #__akeeba_common table.
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__akeeba_common'))
->set($db->quoteName('value') . ' = :json')
->where($db->quoteName('key') . ' = :keyName')
->bind(':json', $json)
->bind(':keyName', $keyName);
try
{
$db->setQuery($query)->execute();
}
catch (RuntimeException $e)
{
return;
}
}
/**
* Removes the common extensions from old package's cached manifest.
*
* This prevents Joomla from uninstalling modules, plugins etc which are nominally included in both packages when
* you uninstall the old package.
*
* @return void
*/
private function removeExtensionsFromPackageManifest(): void
{
// Make sure we have an old package and a list of extensions
$oldPackage = self::OLD_PACKAGE_NAME;
$extensions = $this->extensionsList;
if (empty($oldPackage) || empty($extensions))
{
return;
}
// Get the cached manifest as a SimpleXMLElement node
$xml = $this->getPackageXMLManifest($oldPackage);
if (is_null($xml))
{
return;
}
// Walk through all the tags and remove the extensions in the $extensions list
foreach ($xml->xpath('//files/file') as $fileField)
{
$extension = $this->xmlNodeToExtensionName($fileField);
if (is_null($extension) || !in_array($extension, $extensions))
{
continue;
}
unset($fileField[0][0]);
}
// Save the modified manifest back to the package manifests cache.
$filePath = $this->getCachedManifestPath($oldPackage);
$contents = $xml->asXML();
@file_put_contents($filePath, $contents);
}
/**
* Gets a SimpleXMLElement representation of the cached manifest of the extension.
*
* @param string $package
*
* @return SimpleXMLElement|null
*/
private function getPackageXMLManifest(string $package): ?SimpleXMLElement
{
$filePath = $this->getCachedManifestPath($package);
if (!@file_exists($filePath) || !@is_readable($filePath))
{
return null;
}
$xmlContent = @file_get_contents($filePath);
if (empty($xmlContent))
{
return null;
}
return new SimpleXMLElement($xmlContent);
}
/**
* Get the list of extensions included in a package
*
* @param string $package
*
* @return array
*/
private function getExtensionsFromPackage(string $package): array
{
$extensions = [];
$xml = $this->getPackageXMLManifest($package);
if (is_null($xml))
{
return $extensions;
}
foreach ($xml->xpath('//files/file') as $fileField)
{
$extension = $this->xmlNodeToExtensionName($fileField);
if (is_null($extension))
{
continue;
}
$extensions[] = $extension;
}
return $extensions;
}
/**
* Take a SimpleXMLElement `` node of the package manifest and return the corresponding Joomla extension name
*
* @param SimpleXMLElement $fileField The `` node of the package manifest
*
* @return string|null The extension name, null if it cannot be determined.
*/
private function xmlNodeToExtensionName(SimpleXMLElement $fileField): ?string
{
$type = (string) $fileField->attributes()->type;
$id = (string) $fileField->attributes()->id;
switch ($type)
{
case 'component':
case 'file':
case 'library':
$extension = $id;
break;
case 'plugin':
$group = (string) $fileField->attributes()->group ?? 'system';
$extension = 'plg_' . $group . '_' . $id;
break;
case 'module':
$client = (string) $fileField->attributes()->client ?? 'site';
$extension = (($client != 'site') ? 'a' : '') . $id;
break;
default:
$extension = null;
break;
}
return $extension;
}
/**
* Convert a Joomla extension name to `#__extensions` table query criteria.
*
* The following kinds of extensions are supported:
* * `pkg_something` Package type extension
* * `com_something` Component
* * `plg_folder_something` Plugins
* * `mod_something` Site modules
* * `amod_something` Administrator modules. THIS IS CUSTOM.
* * `file_something` File type extension
* * `lib_something` Library type extension
*
* @param string $extensionName
*
* @return string[]
*/
private function extensionNameToCriteria(string $extensionName): array
{
$parts = explode('_', $extensionName, 3);
switch ($parts[0])
{
case 'pkg':
return [
'type' => 'package',
'element' => $extensionName,
];
case 'com':
return [
'type' => 'component',
'element' => $extensionName,
];
case 'plg':
return [
'type' => 'plugin',
'folder' => $parts[1],
'element' => $parts[2],
];
case 'mod':
return [
'type' => 'module',
'element' => $extensionName,
'client_id' => 0,
];
// That's how we note admin modules
case 'amod':
return [
'type' => 'module',
'element' => substr($extensionName, 1),
'client_id' => 1,
];
case 'file':
return [
'type' => 'file',
'element' => $extensionName,
];
case 'lib':
return [
'type' => 'library',
'element' => $parts[1],
];
}
return [];
}
/**
* Get the absolute filesystem path
*
* @param string $package
*
* @return string
*/
private function getCachedManifestPath(string $package): string
{
return JPATH_MANIFESTS . '/packages/' . $package . '.xml';
}
/**
* Is this the Pro version?
*
* This is determined by examining the constants, files and folders defined in self::PRO_CRITERIA
*
* @return bool
* @see self::PRO_CRITERIA
*/
private function isPro(): bool
{
if (empty(self::PRO_CRITERIA))
{
return false;
}
foreach (self::PRO_CRITERIA as $criterion)
{
[$type, $value] = $criterion;
switch ($type)
{
case 'const':
case 'constant':
if (!defined($value))
{
continue 2;
}
if (constant($value))
{
return true;
}
break;
case 'folder':
if (@file_exists($value) && @is_dir($value))
{
return true;
}
break;
case 'file':
if (@file_exists($value) && @is_file($value))
{
return true;
}
break;
default:
continue 2;
}
}
return false;
}
/**
* Uninstall an extension by name.
*
* @param string $extension
*
* @return bool
*/
private function uninstallExtension(string $extension): bool
{
// Let's get the extension ID. If it's not there we can't uninstall this extension, right..?
$eid = $this->getExtensionId($extension);
if (empty($eid))
{
return false;
}
// Extensions must be marked as not belonging to the package before they can be removed
$this->removeExtensionPackageLink($eid);
// Get an Extension table object and Installer object.
$row = new Extension($this->getDatabase());
$installer = Installer::getInstance();
// Load the extension row or fail the uninstallation immediately.
try
{
if (!$row->load($eid))
{
return false;
}
}
catch (Throwable $e)
{
// If the database query fails or Joomla experiences an unplanned rapid deconstruction let's bail out.
return false;
}
// Can't uninstalled protected extensions
/** @noinspection PhpUndefinedFieldInspection */
if ((int) $row->locked === 1)
{
return false;
}
// An extension row without a type? What have you done to your database, you MONSTER?!
if (empty($row->type))
{
return false;
}
// Do the actual uninstallation. Try to trap any errors, just in case...
try
{
return $installer->uninstall($row->type, $eid);
}
catch (Throwable $e)
{
return false;
}
}
/**
* Loads any custom handlers.
*
* @return void
*/
private function loadCustomHandlers(): void
{
$handlerNamespace = __NAMESPACE__ . '\\' . self::CUSTOM_HANDLERS_DIRECTORY;
$this->customHandlers = [];
// Scan the directory and load the custom handlers
$targetDirectory = __DIR__ . '/' . self::CUSTOM_HANDLERS_DIRECTORY;
if (!@file_exists($targetDirectory) || !@is_dir($targetDirectory))
{
return;
}
$di = new DirectoryIterator($targetDirectory);
/** @var DirectoryIterator $entry */
foreach ($di as $entry)
{
// Ignore folders
if ($entry->isDot() || $entry->isDir())
{
continue;
}
// Ignore non-PHP directories
if ($entry->getExtension() != 'php')
{
continue;
}
// Get the class name
$bareName = basename($entry->getFilename(), '.php');
$bareNameCanonical = preg_replace('/[^A-Z_]/i', '', $bareName);
/**
* Some hosts rename files with numeric suffixes, e.g. FooBar.php is renamed to FooBar.01.php. In both cases
* the bare class name would be "FooBar" but the canonical would be "FooBar" vs "FooBar.01". This check
* makes sure that renamed files will NOT be loaded. Ever.
*/
if ($bareName != $bareNameCanonical)
{
continue;
}
// Have I already loaded an object this class? Yeah, sometimes hosts do weird(er) things.
if (array_key_exists($bareNameCanonical, $this->customHandlers))
{
continue;
}
// Try to load the file
require_once $entry->getPathname();
// Make sure we actually loaded a class I can use
$classFQN = $handlerNamespace . '\\' . $bareNameCanonical;
if (!class_exists($classFQN, false))
{
continue;
}
// Add the custom handler, passing a reference to ourselves
$this->customHandlers[$bareNameCanonical] = new $classFQN($this, $this->getDatabase());
}
}
/**
* Are the old and new packages identical?
*
* Also returns true if no OLD_PACKAGE_NAME has been specified.
*
* @return bool
*/
private function isSamePackage(): bool
{
return empty(self::OLD_PACKAGE_NAME) || (self::OLD_PACKAGE_NAME === self::PACKAGE_NAME);
}
private function removeExtensionPackageLink(int $eid): void
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__extensions'))
->set($db->quoteName('package_id') . ' = 0')
->where($db->quoteName('extension_id') . ' = :eid')
->bind(':eid', $eid, ParameterType::INTEGER);
$db->setQuery($query)->execute();
}
}PK \$v src/Model/TransferModel.phpnu [ session = $app->getSession();
}
/**
* Get the information for the latest backup
*
* @param $profileID int|null The profile ID for which to get the latest backup. Set to null to search all
* profiles.
*
* @return array|null An array of backup record information or null if there is no usable backup for site
* transfer
* @throws Exception
*/
public function getLatestBackupInformation(?int $profileID = null): ?array
{
// Initialise
$db = $this->getDatabase();
/** @var Statistics $model */
$model = $this->getMVCFactory()->createModel('Statistics', 'Administrator', ['ignore_request' => 1]);
$model->setState('list.start', 0);
$model->setState('list.limit', 1);
$filters = null;
if ($profileID > 0)
{
$filters = [
[
'field' => 'profile_id',
'operand' => '=',
'value' => $profileID,
],
];
}
$backups = $model->getStatisticsListWithMeta(false, $filters, $db->qn('id') . ' DESC');
// No valid backups? No joy.
if (empty($backups))
{
return null;
}
// Get the latest backup
$backup = array_shift($backups);
// If it's not stored on the server (e.g. remote backup), no joy.
if ($backup['meta'] != 'ok')
{
return null;
}
// If it's not a full site backup, no joy.
if ($backup['type'] != 'full')
{
return null;
}
return $backup;
}
/**
* Get the information for a specific backup record, given its ID.
*
* Unlike getLatestBackupInformation(), this does not care about the backup's age. However, the backup archive files
* must still be present on the server (we can't transfer files we don't have!) and the backup must be a full site
* backup.
*
* @param int $backupID The backup record ID to retrieve.
*
* @return array|null An array of backup record information or null if it cannot be used for site transfer.
* @throws Exception
* @since 10.3.6
*/
public function getBackupInformationById(int $backupID): ?array
{
// Initialise
$db = $this->getDatabase();
/** @var Statistics $model */
$model = $this->getMVCFactory()->createModel('Statistics', 'Administrator', ['ignore_request' => 1]);
$model->setState('list.start', 0);
$model->setState('list.limit', 1);
$filters = [
[
'field' => 'id',
'operand' => '=',
'value' => $backupID,
],
];
$backups = $model->getStatisticsListWithMeta(false, $filters, $db->qn('id') . ' DESC');
// No such backup? No joy.
if (empty($backups))
{
return null;
}
$backup = array_shift($backups);
// If its archive files are not present on the server, no joy.
if ($backup['meta'] != 'ok')
{
return null;
}
// If it's not a full site backup, no joy.
if ($backup['type'] != 'full')
{
return null;
}
return $backup;
}
/**
* Get the information for the backup the Site Transfer Wizard should use.
*
* If a specific backup record ID has been selected (e.g. from the Manage Backups page) it returns that record's
* information, ignoring its age. Otherwise it falls back to the latest usable backup.
*
* @return array|null An array of backup record information or null if there is no usable backup for site transfer.
* @throws Exception
* @since 10.3.6
*/
public function getTransferBackupInformation(): ?array
{
$backupID = (int) $this->session->get('akeebabackup.transfer.backupId', 0);
if ($backupID > 0)
{
return $this->getBackupInformationById($backupID);
}
return $this->getLatestBackupInformation();
}
/**
* Returns the amount of space required on the target server. The two array keys are
* size In bytes
* string Pretty formatted, user-friendly string
*
* @return array
* @throws Exception
*/
public function getApproximateSpaceRequired(): array
{
$backup = $this->getTransferBackupInformation();
if (is_null($backup))
{
return [
'size' => 0,
'string' => '0.00 KB',
];
}
$approximateSize = 2.5 * (float) $backup['size'];
$unit = ['b', 'KB', 'MB', 'GB', 'TB', 'PB'];
return [
'size' => $approximateSize,
'string' => @round($approximateSize / (1024 ** ($i = floor(log($approximateSize, 1024)))), 2) . ' '
. $unit[$i],
];
}
/**
* Cleans up a URL and makes sure it is a valid-looking URL
*
* @param string $url The URL to check
*
* @return array status [ok, invalid, same, notexists] (check status); url (the cleaned URL)
*/
public function checkAndCleanUrl(string $url): array
{
$url = trim($url);
// Initialise
$result = [
'status' => 'ok',
'url' => $url,
];
// Am I missing the protocol?
if (strpos($url, '://') === false)
{
$url = 'http://' . $url;
}
$result['url'] = $url;
// Verify that it is an HTTP or HTTPS URL.
$uri = Uri::getInstance($url);
$protocol = $uri->getScheme();
if (!in_array($protocol, ['http', 'https']))
{
$result['status'] = 'invalid';
return $result;
}
// Verify we are not restoring to the same site we are backing up from
$path = $this->simplifyPath($uri->getPath() ?? '');
$uri->setPath('/' . $path);
$siteUri = Uri::getInstance();
if ($siteUri->getHost() == $uri->getHost())
{
$sitePath = $this->simplifyPath($siteUri->getPath());
if ($sitePath == $path)
{
$result['status'] = 'same';
return $result;
}
}
$result['url'] = $uri->toString(['scheme', 'user', 'pass', 'host', 'port', 'path']);
// Verify we can reach the domain. Since it can be an IP we check both name to IP and IP to name.
$host = $uri->getHost();
if (function_exists('idn_to_ascii'))
{
$host = idn_to_ascii($host);
}
$isValid = ($siteUri->getHost() == $uri->getHost()) || ($host == 'localhost') || ($host == '127.0.0.1')
|| (($host !== false) && checkdnsrr($host, 'A'));
// Sometimes we have a domain name without a DNS record which *can* be accessed locally, e.g. through the hosts
// file. We have to cater for that, just in case...
if (!$isValid)
{
try
{
$http = (new HttpFactory())->getHttp();
$dummy = $http->get($uri->toString(), [], 5);
$isValid = ($dummy->getStatusCode() >= 100) && ($dummy->getStatusCode() < 400);
}
catch (Exception $e)
{
// Nope.
}
}
// Sometimes just the SSL certificate is wrong. Let's give it a go.
if (!$isValid)
{
$dummy = $this->httpGet($uri->toString(), [], 5);
$isValid = !empty($dummy);
}
if (!$isValid)
{
$result['status'] = 'notexists';
return $result;
}
// All checks pass
return $result;
}
/**
* Determines the status of FTP, FTPS and SFTP support. The returned array has two keys 'supported' and 'firewalled'
* each one being an array. You want the protocol to has its 'supported' value set to true and its 'firewalled'
* value set to false. This would mean that the server supports this protocol AND does not block outbound
* connections over this protocol.
*
* @return array
*/
public function getFTPSupport(): array
{
// Initialise
$result = [
'supported' => [
'ftpcurl' => false,
'ftpscurl' => false,
'sftpcurl' => false,
'ftp' => false,
'ftps' => false,
'sftp' => false,
],
'firewalled' => [
'ftpcurl' => false,
'ftpscurl' => false,
'sftpcurl' => false,
'ftp' => false,
'ftps' => false,
'sftp' => false,
],
];
// Necessary functions for each connection method
$supportChecks = [
'ftpcurl' => ['curl_init', 'curl_exec', 'curl_setopt', 'curl_errno', 'curl_error'],
'ftpscurl' => ['curl_init', 'curl_exec', 'curl_setopt', 'curl_errno', 'curl_error'],
'sftpcurl' => ['curl_init', 'curl_exec', 'curl_setopt', 'curl_errno', 'curl_error'],
'ftp' => [
'ftp_connect',
'ftp_login',
'ftp_close',
'ftp_chdir',
'ftp_mkdir',
'ftp_pasv',
'ftp_put',
'ftp_delete',
],
'ftps' => [
'ftp_ssl_connect',
'ftp_login',
'ftp_close',
'ftp_chdir',
'ftp_mkdir',
'ftp_pasv',
'ftp_put',
'ftp_delete',
],
'sftp' => [
'ssh2_connect',
'ssh2_auth_password',
'ssh2_auth_pubkey_file',
'ssh2_sftp',
'ssh2_exec',
'ssh2_sftp_unlink',
'ssh2_sftp_stat',
'ssh2_sftp_mkdir',
],
];
// Determine which connection methods are supported
$supported = [];
foreach ($supportChecks as $protocol => $functions)
{
$supported[$protocol] = true;
foreach ($functions as $function)
{
if (!function_exists($function))
{
$supported[$protocol] = false;
break;
}
}
}
$result['supported'] = $supported;
// We no longer check for firewall settings. The 3PD test server got clogged :(
/**
* $result['firewalled'] = array(
* 'ftp' => !$result['supported']['ftp'] ? false : EngineTransfer\Ftp::isFirewalled(),
* 'ftpcurl' => !$result['supported']['ftp'] ? false : EngineTransfer\FtpCurl::isFirewalled(),
* 'ftps' => !$result['supported']['ftps'] ? false : EngineTransfer\Ftp::isFirewalled(['ssl' => true]),
* 'ftpscurl' => !$result['supported']['ftp'] ? false : EngineTransfer\FtpCurl::isFirewalled(['ssl' => true]),
* 'sftp' => !$result['supported']['sftp'] ? false : EngineTransfer\Sftp::isFirewalled(),
* 'sftpcurl' => !$result['supported']['sftp'] ? false : EngineTransfer\SftpCurl::isFirewalled(),
* );
* /**/
return $result;
}
/**
* Checks the FTP connection parameters
*
* @param array $config FTP/SFTP connection details
*
* @throws RuntimeException
*/
public function testConnection(array $config)
{
$connector = $this->getConnector($config);
// Is it the same site we are restoring from? It is if the configuration.php exists and has the same contents as
// the one I read from our server.
$this->checkIfSameSite($connector);
// Only perform those checks if I'm not forcing the transfer
if (!$config['force'])
{
// Check if there's a special file in this directory, e.g. .htaccess, php.ini, .user.ini or web.config.
$this->checkIfHasSpecialFile($connector);
// Check if there's another site present in this directory
$this->checkIfExistingSite($connector);
}
// Does it match the URL to the site?
$this->checkIfMatchesUrl($connector);
}
/**
* Upload Kickstart, our extra script and check that the target server fullfills our criteria
*
* @param array $config FTP/SFTP connection details
*
* @throws Exception
*/
public function initialiseUpload(array $config)
{
$connector = $this->getConnector($config);
$randomPrefix = $this->session->get('akeebabackup.transfer.randomName', 'kickstart');
// XOR-decode Kickstart from obfuscated on-disk storage into a temporary plain-text file for upload
$xorKey = 'ThisIsKickstartCoreWhichIsNotMaliciousYouCanDownloadItFromAkeebaDotComIfYouWant';
$encoded = file_get_contents(JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/kickstart.dat');
$fullKey = str_repeat($xorKey, (int) ceil(strlen($encoded) / strlen($xorKey)));
$kickstartTemp = tempnam(sys_get_temp_dir(), 'ksdat_');
file_put_contents($kickstartTemp, $encoded ^ substr($fullKey, 0, strlen($encoded)));
// Can I upload Kickstart and my extra script?
$files = [
$kickstartTemp
=> $randomPrefix . '.php',
JPATH_ADMINISTRATOR . '/components/com_akeebabackup/installers/kickstart.transfer.php'
=> $randomPrefix . '.transfer.php',
];
$createdFiles = [];
$transferredSize = 0;
$transferTime = 0;
try
{
foreach ($files as $localFile => $remoteFile)
{
$start = microtime(true);
$connector->upload($localFile, $connector->getPath($remoteFile));
$end = microtime(true);
$createdFiles[] = $remoteFile;
$transferredSize += filesize($localFile);
$transferTime += $end - $start;
}
}
catch (Exception $e)
{
// An upload failed. Remove existing files.
$this->removeRemoteFiles($connector, $createdFiles, true);
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADKICKSTART'));
}
finally
{
@unlink($kickstartTemp);
}
// Get the transfer speed between the two servers in bytes / second
$transferSpeed = $transferredSize / $transferTime;
try
{
$trustMeIKnowWhatImDoing = 500 + 10 + 1; // working around overzealous scanners written by bozos
$connector->mkdir($connector->getPath('kicktemp'), $trustMeIKnowWhatImDoing);
}
catch (Exception $e)
{
// Don't sweat if we can't create our temporary directory.
}
// Can I run Kickstart and my extra script?
try
{
$this->checkRemoteServerEnvironment($config['force']);
}
catch (Exception $e)
{
$this->removeRemoteFiles($connector, $createdFiles, true);
throw $e;
}
// Get the lowest maximum execution time between our local and remote server
$remoteTimeout = $this->session->get('akeebabackup.transfer.remoteTimeLimit', 5);
$localTimeout = 5;
if (function_exists('ini_get'))
{
$localTimeout = ini_get("max_execution_time");
}
$timeout = min($localTimeout, $remoteTimeout);
if ($localTimeout == 0)
{
$timeout = $remoteTimeout;
}
elseif ($remoteTimeout == 0)
{
$timeout = $localTimeout;
}
if ($timeout == 0)
{
$timeout = 5;
}
// Get the maximum transfer size, rounded down to 512K
$maxTransferSize = $transferSpeed * $timeout;
$maxTransferSize = floor($maxTransferSize / 524288) * 524288;
if ($maxTransferSize == 0)
{
$maxTransferSize = 524288;
}
/**
* We never go above a maximum transfer size that depends on the server memory setting and the maximum remote
* upload size (minus 10Kb for overhead data)
*/
// Maximum chunk size determined by local server's memory constraints
$chunkSizeLimit = $this->getMaxChunkSize();
// Chunk size selected by the user
$userUploadLimit = $this->session->get('akeebabackup.transfer.chunkSize', 5242880) - 10240;
// Maximum chunk size determined by the remote server
$maxUploadLimit = $this->session->get('akeebabackup.transfer.uploadLimit', 5242880) - 10240;
// Calculated optimum chunk size (maxTransferSize is calculated by server-to-server speed limits)
$maxTransferSize = min($maxUploadLimit, $userUploadLimit, $maxTransferSize, $chunkSizeLimit);
/**
* A little explanation for "$maxUploadLimit / 4" below. We are uploading binary data which gets encoded as
* form data. The integer part is a rough estimation of the size discrepancy between raw and encoded data.
*/
if ($config['chunkMode'] == 'post')
{
$maxTransferSize = min(floor($maxUploadLimit / 4), $maxTransferSize, $chunkSizeLimit);
}
// Save the optimal transfer size in the session
$this->session->set('akeebabackup.transfer.fragSize', $maxTransferSize);
}
/**
* Upload the next fragment
*
* @param array $config FTP/SFTP connection details
*
* @return array
* @throws Exception
*
*/
public function uploadChunk(array $config): array
{
$ret = [
'result' => true,
'done' => false,
'message' => '',
'totalSize' => 0,
'doneSize' => 0,
];
// Get information from the session
$fragSize = $this->session->get('akeebabackup.transfer.fragSize', 5242880);
$backup = $this->session->get('akeebabackup.transfer.lastBackup', []);
$totalSize = $this->session->get('akeebabackup.transfer.totalSize', 0);
$doneSize = $this->session->get('akeebabackup.transfer.doneSize', 0);
$part = $this->session->get('akeebabackup.transfer.part', -1);
$frag = $this->session->get('akeebabackup.transfer.frag', -1);
// Do I need to update the total size?
if (!$totalSize)
{
$totalSize = $backup['total_size'];
$this->session->set('akeebabackup.transfer.totalSize', $totalSize);
}
$ret['totalSize'] = $totalSize;
// First fragment of a new part
if ($frag == -1)
{
$frag = 0;
$part++;
}
/**
* If the backup is single part then $backup['multipart'] is 0. This means that the next if-block will report
* that the transfer is done. In these cases we have to convert $backup['multipart'] to 1 to let the upload
* actually run at all.
*/
if ($backup['multipart'] == 0)
{
$backup['multipart'] = 1;
}
// If I'm past the last part I'm done.
if ($part >= $backup['multipart'])
{
// We are done
$ret['done'] = true;
return $ret;
}
// Get the information for this part
$fileName = $this->getPartFilename($backup['absolute_path'], $part);
$fileSize = filesize($fileName);
$intendedSeekPosition = $fragSize * $frag;
// I am trying to seek past EOF. Oops. Upload the next part.
if ($intendedSeekPosition >= $fileSize)
{
$this->session->set('akeebabackup.transfer.frag', -1);
return $this->uploadChunk($config);
}
// Open the part
$fp = @fopen($fileName, 'r');
if ($fp === false)
{
$ret['result'] = false;
$ret['message'] = Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTREADLOCALFILE', $fileName);
return $ret;
}
// Seek to position
if (fseek($fp, $intendedSeekPosition) == -1)
{
@fclose($fp);
$ret['result'] = false;
$ret['message'] = Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTREADLOCALFILE', $fileName);
return $ret;
}
// Read the data
$data = fread($fp, $fragSize);
$doneSize += strlen($data);
$ret['doneSize'] = $doneSize;
$this->session->set('akeebabackup.transfer.doneSize', $doneSize);
// Upload the data
$this->session->set('akeebabackup.transfer.frag', $frag);
try
{
switch ($config['chunkMode'])
{
case 'post':
$dataLength = $this->uploadUsingPost($fileName, $data);
break;
case 'chunked':
default:
$dataLength = $this->uploadUsingChunked($fileName, $data, $config);
break;
}
}
finally
{
// Close the part
fclose($fp);
}
// Update the session data
$this->session->set('akeebabackup.transfer.fragSize', $fragSize);
$this->session->set('akeebabackup.transfer.totalSize', $totalSize);
$this->session->set('akeebabackup.transfer.doneSize', $doneSize);
$this->session->set('akeebabackup.transfer.part', $part);
$this->session->set('akeebabackup.transfer.frag', ++$frag);
// Did I go past EOF? Then on to the next part
$intendedSeekPosition += $dataLength;
if ($intendedSeekPosition >= $fileSize)
{
$this->session->set('akeebabackup.transfer.frag', -1);
$this->session->set('akeebabackup.transfer.part', ++$part);
}
// Did I reach the last part? Then I'm done
if ($part >= $backup['multipart'])
{
// We are done
$ret['done'] = true;
}
return $ret;
}
/**
* Reset the upload information. Required to start over.
*
* @return void
*/
public function resetUpload()
{
$this->session->set('akeebabackup.transfer.totalSize', 0);
$this->session->set('akeebabackup.transfer.doneSize', 0);
$this->session->set('akeebabackup.transfer.part', -1);
$this->session->set('akeebabackup.transfer.frag', -1);
}
/**
* Gets the FTP configuration from the session
*
* @return array
*/
public function getFtpConfig(): array
{
$transferOption = $this->session->get('akeebabackup.transfer.transferOption', '');
return [
'method' => $transferOption,
'force' => $this->session->get('akeebabackup.transfer.force', 0),
'host' => $this->session->get('akeebabackup.transfer.ftpHost', ''),
'port' => $this->session->get('akeebabackup.transfer.ftpPort', ''),
'username' => $this->session->get('akeebabackup.transfer.ftpUsername', ''),
'password' => $this->session->get('akeebabackup.transfer.ftpPassword', ''),
'directory' => $this->session->get('akeebabackup.transfer.ftpDirectory', ''),
'ssl' => $transferOption == 'ftps',
'passive' => $this->session->get('akeebabackup.transfer.ftpPassive', 1),
'passive_fix' => $this->session->get('akeebabackup.transfer.ftpPassiveFix', 1),
'privateKey' => $this->session->get('akeebabackup.transfer.ftpPrivateKey', ''),
'publicKey' => $this->session->get('akeebabackup.transfer.ftpPubKey', ''),
'chunkMode' => $this->session->get('akeebabackup.transfer.chunkMode', 'chunked'),
'chunkSize' => $this->session->get('akeebabackup.transfer.chunkSize', '5242880'),
];
}
public function makeRandomPrefix(): string
{
$randomPrefix = UserHelper::genRandomPassword(16);
$this->session->set('akeebabackup.transfer.randomName', $randomPrefix);
return $randomPrefix;
}
/**
* Tries to simplify a server path to get the site's root. It can handle most forms on non-SEF and non-rewrite SEF
* URLs (as in index.php?foo=bar, something.php/this/is?completely=nuts#ok). It can't fix stupid but it tries really
* bloody hard to.
*
* @param string $path The path to simplify. We *expect* this to contain nonsense.
*
* @return string The scrubbed clean URL, hopefully leading to the site's root.
*/
private function simplifyPath(string $path): string
{
$path = ltrim($path, '/');
if (empty($path))
{
return $path;
}
// Trim out anything after a .php file (including the .php file itself)
if (substr($path, -1) != '/')
{
$parts = explode('/', $path);
$newParts = [];
foreach ($parts as $part)
{
if (substr($part, -4) == '.php')
{
break;
}
$newParts[] = $part;
}
$path = implode('/', $newParts);
}
if (substr($path, -13) == 'administrator')
{
$path = substr($path, 0, -13);
}
return $path;
}
/**
* Gets the TransferInterface connector object based on the $config configuration parameters array
*
* @param array $config The configuration array with the FTP/SFTP connection information
*
* @return TransferInterface
*
* @throws RuntimeException
*/
private function getConnector(array $config): TransferInterface
{
switch ($config['method'])
{
case 'sftp':
$connector = new Sftp($config);
break;
case 'sftpcurl':
$connector = new SftpCurl($config);
break;
case 'ftpcurl':
case 'ftpscurl':
$connector = new FtpCurl($config);
break;
default:
$connector = new Ftp($config);
break;
}
return $connector;
}
/**
* Checks if the remote site is the same as the site we are running the wizard from.
*
* @param TransferInterface $connector
*/
private function checkIfSameSite(TransferInterface $connector)
{
$myConfiguration = @file_get_contents(JPATH_ROOT . '/configuration.php');
if ($myConfiguration === false)
{
return;
}
try
{
$otherConfiguration = $connector->read($connector->getPath('configuration.php'));
}
catch (Exception $e)
{
// File not found. No harm done.
return;
}
if ($otherConfiguration == $myConfiguration)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_SAMESITE'));
}
}
/**
* Check if there's a special file which might prevent site transfer from taking place.
*
* @param TransferInterface $connector
*/
private function checkIfHasSpecialFile(TransferInterface $connector)
{
$possibleFiles = ['.htaccess', 'web.config', 'php.ini', '.user.ini'];
foreach ($possibleFiles as $file)
{
try
{
$fileContents = $connector->read($connector->getPath($file));
}
catch (Exception $e)
{
// File not found. No harm done.
continue;
}
if (empty($fileContents))
{
continue;
}
throw new TransferIgnorableError(Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_HTACCESS', $file));
}
}
/**
* Check if there's an existing site
*
* @param TransferInterface $connector
*/
private function checkIfExistingSite(TransferInterface $connector)
{
/**
* I run into a PHP bug. When we try to read 'wordpress/index.php' over FTP to determine if it exists we end up
* with the folder "wordpress" being created. I have only been able to reproduce with with VSFTPd. The VSFTPd
* log claims there is only an unsuccessful read operation. Why the folder is created is a mystery, but I have
* to remove it anyway. I know, right?
*/
// $possibleFiles = ['index.php', 'wordpress/index.php'];
$possibleFiles = ['index.php'];
foreach ($possibleFiles as $file)
{
try
{
$fileContents = $connector->read($connector->getPath($file));
}
catch (Exception $e)
{
// File not found. No harm done.
continue;
}
if (empty($fileContents))
{
continue;
}
throw new TransferIgnorableError(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_EXISTINGSITE'));
}
}
/**
* Check if the connection matches the site's stated URL
*
* @param TransferInterface $connector
*/
private function checkIfMatchesUrl(TransferInterface $connector)
{
$sourceFile = JPATH_SITE . '/media/com_akeebabackup/icons/loading.gif';
// Try to upload the file
try
{
$connector->upload($sourceFile, $connector->getPath(basename($sourceFile)));
}
catch (Exception $e)
{
$errorMessage = Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADTESTFILE', basename($sourceFile));
$errorMessage .= " — [ " . $e->getMessage() . ' ]';
throw new RuntimeException($errorMessage);
}
// Try to fetch the file over HTTP
$url = $this->session->get('akeebabackup.transfer.url', '');
$url = rtrim($url, '/');
$http = (new HttpFactory())->getHttp();
$wrongSSL = false;
try
{
$response = $http->get($url . '/' . basename($sourceFile), [], 10);
$data = (string) $response->getBody() ?: null;
}
catch (Exception $e)
{
$data = null;
}
/**
* The download of the test file failed. This can mean that the (S)FTP directory does not match the site URL we
* were given, DNS resolution does not work or we have an SSL issue. We are going to determine which one is it.
*/
if (is_null($data))
{
$uri = new Uri($url);
$hostname = $uri->getHost();
$results = dns_get_record($hostname, DNS_A);
// If there are no IPv4 records let's try to get IPv6 records
if (((is_array($results) || ($results instanceof Countable)) ? count($results) : 0) == 0)
{
$results = dns_get_record($hostname, DNS_AAAA);
}
// No DNS records. So, that's why fetching data failed!
if ((is_array($results) || $results instanceof Countable ? count($results) : 0) == 0)
{
// Delete the temporary file
$connector->delete($connector->getPath(basename($sourceFile)));
// And now throw the error
throw new TransferFatalError(Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_DNS', $hostname));
}
/**
* The DNS resolution worked. The next theory we have to test is that the SSL certificate is invalid or
* self-signed. The best way to do that without having to go through the OpenSSL extensions (which might not
* be installed or activated) is to do no SSL checking and retry the download. If that works we definitely
* have an SSL issue.
*
* Since Joomla's HTTP factory doesn't allow security downgrading we have to do it the hard way, with direct
* use of fopen() wrappers :(
*/
$contextOptions = $this->getProxyStreamContext();
$contextOptions = array_merge_recursive(
$contextOptions, [
'http' => [
'timeout' => 10,
'follow_location' => 1,
],
'ssl' => [
'verify_peer' => false,
'verify_peer_name' => false,
],
]
);
$context = stream_context_create($contextOptions);
$data = @file_get_contents($url . '/' . basename($sourceFile), false, $context) ?: null;
}
// Delete the temporary file
$connector->delete($connector->getPath(basename($sourceFile)));
// Could we get it over HTTP?
$originalData = file_get_contents($sourceFile);
// Downloaded data is verified but the SSL certificate was bad: tell the user to fix the SSL certificate.
if ($wrongSSL && ($originalData == $data))
{
throw new TransferFatalError(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_WRONGSSL'));
}
// Downloaded data did not match (no matter of the SSL verification): configuration error.
if ($originalData != $data)
{
throw new TransferFatalError(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTACCESSTESTFILE'));
}
}
/**
* Removes files stored remotely
*
* @param TransferInterface $connector The transfer object
* @param array $files The list of remote files to delete (relative paths)
* @param bool|true $ignoreExceptions Should I ignore exceptions thrown?
*
* @return void
*
* @throws Exception
*/
private function removeRemoteFiles(TransferInterface $connector, array $files, $ignoreExceptions = true)
{
if (empty($files))
{
return;
}
foreach ($files as $file)
{
$remoteFile = $connector->getPath($file);
try
{
$connector->delete($remoteFile);
}
catch (Exception $e)
{
// Only let the exception bubble up if we are told not to ignore exceptions
if (!$ignoreExceptions)
{
throw $e;
}
}
}
}
/**
* Check if the remote server environment matches our expectations.
*
* @param bool $forced Are we forcing the transfer? If so some checks are ignored
*
* @throws Exception
*/
private function checkRemoteServerEnvironment(bool $forced = false)
{
$baseUrl = $this->session->get('akeebabackup.transfer.url', '');
$baseUrl = rtrim($baseUrl, '/');
$randomPrefix = $this->session->get('akeebabackup.transfer.randomName', 'kickstart');
$rawData = $this->httpGet($baseUrl . '/' . $randomPrefix . '.php?task=serverinfo', [], 10);
if (is_null($rawData))
{
// Cannot access Kickstart on the remote server
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTRUNKICKSTART'));
}
// Try to get the raw JSON data
$pos = strpos($rawData, '###');
if ($pos === false)
{
// Invalid AJAX data, no leading ###
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTRUNKICKSTART'));
}
// Remove the leading ###
$rawData = substr($rawData, $pos + 3);
$pos = strpos($rawData, '###');
if ($pos === false)
{
// Invalid AJAX data, no trailing ###
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTRUNKICKSTART'));
}
// Remove the trailing ###
$rawData = substr($rawData, 0, $pos);
// Get the JSON response
$data = @json_decode($rawData, true);
if (empty($data))
{
// Invalid AJAX data, can't decode this stuff
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTRUNKICKSTART'));
}
// Disk space check could be ignored since some hosts return the wrong value for the available disk space
if (!$forced)
{
// Does the server have enough disk space?
$freeSpace = $data['freeSpace'];
$requiredSize = $this->getApproximateSpaceRequired();
if ($requiredSize['size'] > $freeSpace)
{
$unit = ['b', 'KB', 'MB', 'GB', 'TB', 'PB'];
$freeSpaceString = @round($freeSpace / 1024 ** ($i = floor(log($freeSpace, 1024))), 2) . ' '
. $unit[$i];
throw new TransferIgnorableError(
Text::sprintf(
'COM_AKEEBABACKUP_TRANSFER_ERR_NOTENOUGHSPACE', $requiredSize['string'], $freeSpaceString
)
);
}
}
// Can I write to remote files?
$canWrite = $data['canWrite'];
$canWriteTemp = $data['canWriteTemp'];
if (!$canWrite && !$canWriteTemp)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTWRITEREMOTEFILES'));
}
if ($canWrite)
{
$this->session->set('akeebabackup.transfer.targetPath', '');
}
else
{
$this->session->set('akeebabackup.transfer.targetPath', 'kicktemp');
}
$this->session->set('akeebabackup.transfer.remoteTimeLimit', $data['maxExecTime']);
// What is my upload limit?
$uploadLimit = min($data['maxPost'], $data['maxUpload']);
if (empty($data['maxPost']))
{
$uploadLimit = $data['maxUpload'];
}
elseif (empty($data['maxUpload']))
{
$uploadLimit = $data['maxPost'];
}
if (empty($uploadLimit))
{
$uploadLimit = 1048576;
}
$this->session->set('akeebabackup.transfer.uploadLimit', $uploadLimit);
}
/**
* Get the filename for a backup part file, given the base file and the part number
*
* @param string $baseFile Full path to the base file (.jpa, .jps, .zip)
* @param int $part Part number
*
* @return string
*/
private function getPartFilename(string $baseFile, int $part = 0): string
{
if ($part == 0)
{
return $baseFile;
}
$dirname = dirname($baseFile);
$basename = basename($baseFile);
$pos = strrpos($basename, '.');
$extension = substr($basename, $pos + 1);
$newExtension = substr($baseFile, 0, 1) . sprintf('%02u', $part);
return $dirname . '/' . basename($basename, '.' . $extension) . '.' . $newExtension;
}
/**
* Returns the PHP memory limit. If ini_get is not available it will assume 8Mb.
*
* @return int
*/
private function getServerMemoryLimit(): int
{
// Default reported memory limit: 8Mb
$memLimit = 8388608;
// If we can't find out how much PHP memory we have available use 8Mb by default
if (!function_exists('ini_get'))
{
return $memLimit;
}
$iniMemLimit = ini_get("memory_limit");
$iniMemLimit = $this->convertMemoryLimitToBytes($iniMemLimit);
$memLimit = ($iniMemLimit > 0) ? $iniMemLimit : $memLimit;
return (int) $memLimit;
}
/**
* Gets the maximum chunk size the server can handle safely. It does so by finding the PHP memory limit, removing
* the current memory usage (or at least 2Mb) and rounding down to the closest 512Kb. It can never be lower than
* 512Kb.
*
* @return int
*/
private function getMaxChunkSize(): int
{
$memoryLimit = $this->getServerMemoryLimit();
$usedMemory = max(memory_get_usage(), memory_get_peak_usage(), 2048);
$maxChunkSize = max(($memoryLimit - $usedMemory) / 2, 524288);
return floor($maxChunkSize / 524288) * 524288;
}
/**
* Convert the textual representation of PHP memory limit to an integer, e.g. convert 8M to 8388608
*
* @param string $setting The PHP memory limit
*
* @return int PHP memory limit as an integer
*/
private function convertMemoryLimitToBytes(string $setting): int
{
$val = trim($setting);
$last = strtolower(substr($val, -1));
if (is_numeric($last))
{
return $setting;
}
$val = substr($val, 0, -1);
switch ($last)
{
/** @noinspection PhpMissingBreakStatementInspection */
case 't':
$val *= 1024;
/** @noinspection PhpMissingBreakStatementInspection */
case 'g':
$val *= 1024;
/** @noinspection PhpMissingBreakStatementInspection */
case 'm':
$val *= 1024;
case 'k':
$val *= 1024;
}
return (int) $val;
}
/**
* Uploads a chunk of a backup part file using a direct POST to Kickstart.
*
* This is the method supported by the Site Transfer Wizard since its inception. However, it may not work with hosts
* which have a sensitive server protection, e.g. the very tight mod_security2 rules on SiteGround servers. In those
* cases the remote server will respond with a 500 Internal Server Error, a 403 Forbidden or another server error.
*
* @param string $fileName The filename to upload
* @param string $data The data to upload
*
* @return int The length of the data we managed to upload
*
* @since 3.1.0
*/
private function uploadUsingPost(string $fileName, string $data): int
{
$frag = $this->session->get('akeebabackup.transfer.frag', -1);
$fragSize = $this->session->get('akeebabackup.transfer.fragSize', 5242880);
$url = $this->session->get('akeebabackup.transfer.url', '');
$directory = $this->session->get('akeebabackup.transfer.targetPath', '');
$randomPrefix = $this->session->get('akeebabackup.transfer.randomName', 'kickstart');
$url = rtrim($url, '/') . '/' . $randomPrefix . '.php';
$uri = Uri::getInstance($url);
$uri->setVar('task', 'uploadFile');
$uri->setVar('file', basename($fileName));
$uri->setVar('directory', $directory);
$uri->setVar('frag', $frag);
$uri->setVar('fragSize', $fragSize);
$phpTimeout = 10;
if (function_exists('ini_get'))
{
$phpTimeout = (int) ini_get('max_execution_time') ?: 3600;
$phpTimeout = min($phpTimeout, 3600);
}
$dataLength = function_exists('mb_strlen') ? mb_strlen($data, 'ASCII') : strlen($data);
$rawData = $this->httpPost(
$uri->toString(), http_build_query(
[
'data' => $data,
]
), [], $phpTimeout
);
unset($data);
// Try to get the raw JSON data
$pos = strpos($rawData, '###');
if ($pos === false)
{
// Invalid AJAX data, no leading ###
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADARCHIVE', basename($fileName))
);
}
// Remove the leading ###
$rawData = substr($rawData, $pos + 3);
$pos = strpos($rawData, '###');
if ($pos === false)
{
// Invalid AJAX data, no trailing ###
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADARCHIVE', basename($fileName))
);
}
// Remove the trailing ###
$rawData = substr($rawData, 0, $pos);
// Get the JSON response
$data = @json_decode($rawData, true);
if (empty($data))
{
// Invalid AJAX data, can't decode this stuff
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADARCHIVE', basename($fileName))
);
}
if (!$data['status'])
{
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_ERRORFROMREMOTE', $data['message'])
);
}
return $dataLength;
}
/**
* Uploads a chunk of a backup part file via FTP and then uses Kickstart to piece the file together.
*
* This is a new upload method which works better on servers with tighter security. The only downside is that we
* have to open many FTP/SFTP upload sessions which may result in the remote server eventually blocking our uploads.
*
* @param string $fileName The filename to upload
* @param string $data The data to upload
* @param array $config The FTP/SFTP configuration
*
* @return int The length of the data we managed to upload
*
* @throws Exception
* @since 3.1.0
*/
private function uploadUsingChunked(string $fileName, string $data, array $config): int
{
// ==== Initialize
$frag = $this->session->get('akeebabackup.transfer.frag', -1);
$fragSize = $this->session->get('akeebabackup.transfer.fragSize', 5242880);
$url = $this->session->get('akeebabackup.transfer.url', '');
$directory = $this->session->get('akeebabackup.transfer.targetPath', '');
// ==== Upload the data to the same folder as Kickstart, under a temporary name
// Even though the connector has the write() method, it's not very good for over 1M files. So we create a temp file instead.
$engineConfig = Factory::getConfiguration();
$localTempFile = tempnam(JoomlaFactory::getApplication()->get('tmp_path', sys_get_temp_dir()), 'stw');
$localTempFile = ($localTempFile === false) ? tempnam(sys_get_temp_dir(), 'stw') : $localTempFile;
$localTempFile = ($localTempFile === false) ? tempnam(
$engineConfig->get('akeeba.basic.output_directory', '[DEFAULT_OUTPUT]'), 'stw'
) : $localTempFile;
if ($localTempFile === false)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANTCREATETEMPCHUNK'));
}
if (!file_put_contents($localTempFile, $data))
{
try
{
$written = File::write($localTempFile, $data);
}
catch (Exception $e)
{
$written = false;
}
if (!$written)
{
throw new RuntimeException(Text::_('COM_AKEEBABACKUP_TRANSFER_ERR_CANTCREATETEMPCHUNK'));
}
}
$random = new RandomValue();
$tempFile = strtolower($random->generateString(8)) . '.dat';
$connector = $this->getConnector($config);
try
{
$remoteDirectory = $config['directory'] . (empty($directory) ? '' : ('/' . $directory));
$remoteFile = $remoteDirectory . '/' . $tempFile;
$uploaded = $connector->upload($localTempFile, $remoteFile, true);
}
finally
{
@unlink($localTempFile);
}
if (!$uploaded)
{
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADTEMP', $localTempFile, $remoteFile)
);
}
// ==== Call Kickstart to piece together the file
$randomPrefix = $this->session->get('akeebabackup.transfer.randomName', 'kickstart');
$url = rtrim($url, '/') . '/' . $randomPrefix . '.php';
$uri = Uri::getInstance($url);
$uri->setVar('task', 'uploadFile');
$uri->setVar('file', basename($fileName));
$uri->setVar('directory', $directory);
$uri->setVar('frag', $frag);
$uri->setVar('fragSize', $fragSize);
$uri->setVar('dataFile', $tempFile);
$phpTimeout = 10;
if (function_exists('ini_get'))
{
$phpTimeout = (int) ini_get('max_execution_time') ?: 3600;
$phpTimeout = min($phpTimeout, 3600);
}
$dataLength = function_exists('mb_strlen') ? mb_strlen($data, 'ASCII') : strlen($data);
$rawData = $this->httpGet($uri->toString(), [], $phpTimeout);
// ==== Delete the temporary files
@unlink($localTempFile);
$connector->delete($remoteFile);
// ==== Parse Kickstart's response
// Try to get the raw JSON data
$pos = strpos($rawData, '###');
if ($pos === false)
{
// Invalid AJAX data, no leading ###
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADARCHIVE', basename($fileName))
);
}
// Remove the leading ###
$rawData = substr($rawData, $pos + 3);
$pos = strpos($rawData, '###');
if ($pos === false)
{
// Invalid AJAX data, no trailing ###
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADARCHIVE', basename($fileName))
);
}
// Remove the trailing ###
$rawData = substr($rawData, 0, $pos);
// Get the JSON response
$data = @json_decode($rawData, true);
if (empty($data))
{
// Invalid AJAX data, can't decode this stuff
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_CANNOTUPLOADARCHIVE', basename($fileName))
);
}
if (!$data['status'])
{
throw new RuntimeException(
Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_ERRORFROMREMOTE', $data['message'])
);
}
return $dataLength;
}
/**
* Perform an HTTP GET and return the results.
*
* This method is rigged to work EVEN IF the TLS/SSL certificate of the target server is invalid or self-signed.
* This is unfortunately a very typical use case when transferring sites as the target site most often than not is
* not fully set up yet (no domain assigned, no TLS certificate assigned and so on).
*
* If, however, the domain name of the target URL cannot resolve neither as IPv4 nor as IPv6 we'll throw an
* exception.
*
* @param string $url The URL to fetch
* @param array $headers Any headers to send (optional). Default: none.
* @param int $timeout The timeout in seconds (optional). Default: 10 seconds.
*
* @return string|null
*/
private function httpGet(string $url, array $headers = [], int $timeout = 10): ?string
{
// First I'm going to try with the HTTP factory which is the most reliable method for properly set up sites.
$http = (new HttpFactory())->getHttp();
try
{
$response = $http->get($url, $headers, $timeout);
$data = (string) $response->getBody() ?: null;
}
catch (Exception $e)
{
// We absorb all exceptions since they are all generic, it's not a different exception per error type :(
$data = null;
}
// Non-null returns mean that the HTTP factory worked. Return early and spare us the trouble.
if (!is_null($data))
{
return $data;
}
// Does the domain name resolve?
$uri = new Uri($url);
$hostname = strtolower($uri->getHost());
if (!isset(self::$domainResolvable[$hostname]))
{
$results = dns_get_record($hostname, DNS_A);
// If there are no IPv4 records let's try to get IPv6 records
if (((is_array($results) || ($results instanceof Countable)) ? count($results) : 0) == 0)
{
$results = dns_get_record($hostname, DNS_AAAA);
}
// No DNS records. So, that's why fetching data failed!
self::$domainResolvable[$hostname] = (is_array($results) || $results instanceof Countable ? count($results)
: 0) > 0;
}
// If the domain doesn't resolve complain loudly.
if (!self::$domainResolvable[$hostname])
{
throw new TransferFatalError(Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_DNS', $hostname));
}
/**
* The DNS resolution worked. A different error has occurred. Unfortunately, we don't know WHAT happened so we
* will make an assumption that the problem is that the TLS/SSL certificate is invalid (e.g. wrong Common Name)
* or self-signed. We are going to use the PHP URL fopen wrappers to try and run the request regardless. This is
* not very secure but, as we said, it's an unfortunate reality of how this feature is used :(
*/
$contextOptions = $this->getProxyStreamContext();
$contextOptions = array_merge_recursive(
$contextOptions, [
'http' => [
'timeout' => $timeout,
'follow_location' => 1,
],
'ssl' => [
'verify_peer' => false,
'verify_peer_name' => false,
],
]
);
// Headers are provided as a dictionary. PHP expects them as a plain array of "Header-Name: Value" entries.
if (isset($headers))
{
$headers = array_map(
function ($k, $v) {
if (is_numeric($k) && strpos($v, ':') !== false)
{
return $v;
}
return $k . ':' . $v;
}, array_keys($headers), array_values($headers)
);
}
if (!empty($headers))
{
$context['http']['header'] = array_values($headers);
}
// Create the context and run the request
$context = stream_context_create($contextOptions);
return @file_get_contents($url, false, $context) ?: null;
}
/**
* Perform an HTTP POST and return the results.
*
* This method is rigged to work EVEN IF the TLS/SSL certificate of the target server is invalid or self-signed.
* This is unfortunately a very typical use case when transferring sites as the target site most often than not is
* not fully set up yet (no domain assigned, no TLS certificate assigned and so on).
*
* If, however, the domain name of the target URL cannot resolve neither as IPv4 nor as IPv6 we'll throw an
* exception.
*
* @param string $url The URL to fetch
* @param string $data The data to send over POST
* @param array $headers Any headers to send (optional). Default: none.
* @param int $timeout The timeout in seconds (optional). Default: 10 seconds.
*
* @return string|null
*/
private function httpPost(string $url, string $data, array $headers = [], int $timeout = 10): ?string
{
// First I'm going to try with the HTTP factory which is the most reliable method for properly set up sites.
$http = (new HttpFactory())->getHttp();
try
{
$response = $http->post($url, $data, $headers, $timeout);
$ret = (string) $response->getBody() ?: null;
}
catch (Exception $e)
{
// We absorb all exceptions since they are all generic, it's not a different exception per error type :(
$ret = null;
}
// Non-null returns mean that the HTTP factory worked. Return early and spare us the trouble.
if (!is_null($ret))
{
return $ret;
}
// Does the domain name resolve?
$uri = new Uri($url);
$hostname = strtolower($uri->getHost());
if (!isset(self::$domainResolvable[$hostname]))
{
$results = dns_get_record($hostname, DNS_A);
// If there are no IPv4 records let's try to get IPv6 records
if (((is_array($results) || ($results instanceof Countable)) ? count($results) : 0) == 0)
{
$results = dns_get_record($hostname, DNS_AAAA);
}
// No DNS records. So, that's why fetching data failed!
self::$domainResolvable[$hostname] = (is_array($results) || $results instanceof Countable ? count($results)
: 0) > 0;
}
// If the domain doesn't resolve complain loudly.
if (!self::$domainResolvable[$hostname])
{
throw new TransferFatalError(Text::sprintf('COM_AKEEBABACKUP_TRANSFER_ERR_DNS', $hostname));
}
/**
* The DNS resolution worked. A different error has occurred. Unfortunately, we don't know WHAT happened so we
* will make an assumption that the problem is that the TLS/SSL certificate is invalid (e.g. wrong Common Name)
* or self-signed. We are going to use the PHP URL fopen wrappers to try and run the request regardless. This is
* not very secure but, as we said, it's an unfortunate reality of how this feature is used :(
*/
// Add necessary headers
if (!isset($headers['Content-Type']))
{
$headers['Content-Type'] = 'application/x-www-form-urlencoded; charset=utf-8';
}
$headers['Content-Length'] = function_exists('mb_strlen') ? \mb_strlen($data, 'ASCII') : \strlen($data);
// Headers are provided as a dictionary. PHP expects them as a plain array of "Header-Name: Value" entries.
$headers = array_map(
function ($k, $v) {
if (is_numeric($k) && strpos($v, ':') !== false)
{
return $v;
}
return $k . ':' . $v;
}, array_keys($headers), array_values($headers)
);
$contextOptions = $this->getProxyStreamContext();
$contextOptions = array_merge_recursive(
$contextOptions, [
'http' => [
'method' => 'POST',
'content' => $data,
'timeout' => $timeout,
'follow_location' => 1,
'header' => array_values($headers),
],
'ssl' => [
'verify_peer' => false,
'verify_peer_name' => false,
],
]
);
// Create the context and run the request
$context = stream_context_create($contextOptions);
return @file_get_contents($url, false, $context) ?: null;
}
}PK \Sʉ src/Model/.htaccessnu 7m
Order allow,deny
Deny from all
PK \2 ! src/Model/IncludefoldersModel.phpnu [ getInput()
->get($property, $default, is_array($default) ? 'array' : 'raw');
}
catch (Exception $e)
{
}
return parent::getState($property, $default);
}
/**
* Returns an array containing a list of directories definitions
*
* @return array Array of definitions; The key contains the internal root name, the data is the directory path
*/
public function get_directories(): array
{
// Get database inclusion filters
$filter = Factory::getFilterObject('extradirs');
return $filter->getInclusions('dir');
}
/**
* Automatically rebase included folders to use path variables like [SITEROOT] and [ROOTPARENT]
*
* @return void
* @since 7.3.3
*/
public function rebaseFiltersToSiteDirs(): void
{
$includeFolders = $this->get_directories();
foreach ($includeFolders as $uuid => $def)
{
$originalDir = $def[0];
$convertedDir = Factory::getFilesystemTools()->rebaseFolderToStockDirs($originalDir);
if ($originalDir == $convertedDir)
{
continue;
}
$def[0] = $convertedDir;
$this->setFilter($uuid, $def);
}
}
/**
* Delete a database definition
*
* @param string $uuid The external directory's filter root key (UUID) to remove
*
* @return array
*/
public function remove(string $uuid): array
{
// Special case (empty UUID): New row is added, so the GUI tries to delete the default (empty) record
if (empty($uuid))
{
return ['success' => true, 'newstate' => true];
}
return $this->applyExclusionFilter('extradirs', $uuid, null, 'remove');
}
/**
* Creates a new database definition
*
* @param string $uuid The external directory's filter root key (UUID) to remove
* @param array $data The root and path to the external directory we're adding
*
* @return array
*/
public function setFilter(string $uuid, array $data): array
{
return $this->applyExclusionFilter('extradirs', $uuid, $data, 'set');
}
/**
* Handles a request coming in through AJAX. Basically, this is a simple proxy to the model methods.
*
* @return array
*/
public function doAjax(): array
{
$action = $this->getState('action');
$verb = array_key_exists('verb', $action) ? $action['verb'] : null;
$ret_array = [];
switch ($verb)
{
// Set a filter (used by the editor)
case 'set':
$new_data = [
0 => Factory::getFilesystemTools()->rebaseFolderToStockDirs($action['root']),
1 => $action['data'],
];
// Set the new root
$ret_array = $this->setFilter($action['uuid'], $new_data);
break;
// Remove a filter (used by the editor)
case 'remove':
$ret_array = $this->remove($action['uuid']);
break;
}
return $ret_array;
}
}PK \ae e src/Model/LogModel.phpnu [ get('akeeba.basic.output_directory');
$files = Factory::getFileLister()->getFiles($outputDir);
$ret = [];
if (empty($files) || !is_array($files))
{
return $ret;
}
foreach ($files as $filename)
{
$baseName = basename($filename);
$startsWithAkeeba = substr($baseName, 0, 7) == 'akeeba.';
$endsWithLog = substr($baseName, -4) == '.log';
$endsWithPhpLog = substr($baseName, -8) == '.log.php';
$isDefaultLog = $baseName == 'akeeba.log';
if ($startsWithAkeeba && ($endsWithLog || $endsWithPhpLog) && !$isDefaultLog)
{
/**
* Extract the tag from the filename (akeeba.tag.log or akeeba.tag.log.php)
*
* We ignore the first seven characters ("akeeba.") and the last X characters, where X is 8 if the
* log file name ends with .log.php or 4 if the log name ends with .log.
*/
$tag = substr($baseName, 7, -($endsWithPhpLog ? 8 : 4));
if (empty($tag))
{
continue;
}
$parts = explode('.', $tag);
$key = array_pop($parts);
$key = str_replace('id', '', $key);
$key = is_numeric($key) ? sprintf('%015u', $key) : $key;
if (empty($parts))
{
$key = str_repeat('0', 15) . '.' . $key;
}
else
{
$key .= '.' . implode('.', $parts);
}
$ret[$key] = $tag;
}
}
if ($onlyFailed)
{
$ret = $this->keepOnlyFailedLogs($ret);
}
krsort($ret);
return $ret;
}
/**
* Gets the JHtml options list for selecting a log file
*
* @param bool $onlyFailed Should I only return the log files of backups marked as failed?
*
* @return array
*/
public function getLogList(bool $onlyFailed = false): array
{
$origin = null;
$options = [];
$list = $this->getLogFiles($onlyFailed);
if (!empty($list))
{
$options[] = HTMLHelper::_('select.option', null, Text::_('COM_AKEEBABACKUP_LOG_CHOOSE_FILE_VALUE'));
foreach ($list as $item)
{
$text = Text::_('COM_AKEEBABACKUP_BUADMIN_LABEL_ORIGIN_' . $item);
if (strstr($item, '.') !== false)
{
[$origin, $backupId] = explode('.', $item, 2);
$text = Text::_('COM_AKEEBABACKUP_BUADMIN_LABEL_ORIGIN_' . $origin) . ' (' . $backupId . ')';
}
$options[] = HTMLHelper::_('select.option', $item, $text);
}
}
return $options;
}
/**
* Output the raw text log file to the standard output without the PHP die header
*
* @param bool $withHeader Should I include a header telling the user how to submit this file?
*
* @return void
*/
public function echoRawLog($withHeader = true)
{
$tag = $this->getState('tag', '');
$logFile = Factory::getLog()->getLogFilename($tag);
if ($withHeader)
{
echo "WARNING: Do not copy and paste lines from this file!\r\n";
echo "You are supposed to ZIP and attach it in your support forum post.\r\n";
echo "If you fail to do so, we will be unable to provide efficient support.\r\n";
echo "\r\n";
echo "--- START OF RAW LOG --\r\n";
}
// The at sign (silence operator) is necessary to prevent PHP showing a warning if the file doesn't exist or
// isn't readable for any reason.
$fp = @fopen($logFile, 'r');
if ($fp === false)
{
if ($withHeader)
{
echo "--- END OF RAW LOG ---\r\n";
}
return;
}
$firstLine = @fgets($fp);
if (substr($firstLine, 0, 5) != '<' . '?' . 'php')
{
@fclose($fp);
@readfile($logFile);
}
else
{
while (!feof($fp))
{
echo rtrim(fgets($fp)) . "\r\n";
}
@fclose($fp);
}
if ($withHeader)
{
echo "--- END OF RAW LOG ---\r\n";
}
}
protected function keepOnlyFailedLogs($logs)
{
$db = $this->getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->quoteName('tag'),
$db->quoteName('backupid'),
])
->from($db->quoteName('#__akeebabackup_backups'))
->where($db->quoteName('status') . ' = ' . $db->quote('fail'));
$failedBackups = $db->setQuery($query)->loadObjectList() ?: [];
if (empty($failedBackups))
{
return [];
}
$failedBackups = array_map(function ($o) {
$tag = $o->tag ?? '';
return $tag . (empty($tag) ? '' : '.') . $o->backupid;
}, $failedBackups);
return array_intersect($logs, $failedBackups);
}
}PK \gwm1' 1' src/View/Transfer/HtmlView.phpnu [ 0,
'string' => '0.00 Kb',
];
/** @var string The URL to the site we are restoring to (from the session) */
public $newSiteUrl = '';
/** @var string */
public $newSiteUrlResult = '';
/** @var array Results of support and firewall status of the known file transfer methods */
public $ftpSupport = [
'supported' => [
'ftp' => false,
'ftps' => false,
'sftp' => false,
],
'firewalled' => [
'ftp' => false,
'ftps' => false,
'sftp' => false,
],
];
/** @var array Available transfer options, for use by JHTML */
public $transferOptions = [];
/** @var array Available chunk options, for use by JHTML */
public $chunkOptions = [];
/** @var array Available chunk size options, for use by JHTML */
public $chunkSizeOptions = [];
/** @var bool Do I have supported but firewalled methods? */
public $hasFirewalledMethods = false;
/** @var string Currently selected transfer option */
public $transferOption = 'manual';
/** @var string Currently selected chunk option */
public $chunkMode = 'chunked';
/** @var string Currently selected chunk size */
public $chunkSize = 5242880;
/** @var string FTP/SFTP host name */
public $ftpHost = '';
/** @var string FTP/SFTP port (empty for default port) */
public $ftpPort = '';
/** @var string FTP/SFTP username */
public $ftpUsername = '';
/** @var string FTP/SFTP password – or certificate password if you're using SFTP with SSL certificates */
public $ftpPassword = '';
/** @var string SFTP public key certificate path */
public $ftpPubKey = '';
/** @var string SFTP private key certificate path */
public $ftpPrivateKey = '';
/** @var string FTP/SFTP directory to the new site's root */
public $ftpDirectory = '';
/** @var string FTP passive mode (default is true) */
public $ftpPassive = true;
/** @var string FTP passive mode workaround, for FTP/FTPS over cURL (default is true) */
public $ftpPassiveFix = true;
/** @var int Forces the transfer by skipping some checks on the target site */
public $force = 0;
/**
* Translations to pass to the view
*
* @var array
*/
public $translations = [];
public function booleanSwitch(string $name, int $selected = 0, string $class = ''): string
{
$layoutVariables = [
'class' => $class,
'id' => $name,
'name' => $name,
'value' => $selected,
'options' => [
HTMLHelper::_('select.option', 0, Text::_('JNO')),
HTMLHelper::_('select.option', 1, Text::_('JYES')),
],
];
return LayoutHelper::render('joomla.form.field.radio.switcher', $layoutVariables);
}
protected function onBeforeMain()
{
$this->addToolbar();
$this->getDocument()->getWebAssetManager()
->useScript('com_akeebabackup.transfer');
/** @var CMSApplication $app */
$app = Factory::getApplication();
$session = $app->getSession();
/** @var TransferModel $model */
$model = $this->getModel();
$this->latestBackup = $model->getTransferBackupInformation();
$this->selectedBackupId = (int) $session->get('akeebabackup.transfer.backupId', 0);
$this->spaceRequired = $model->getApproximateSpaceRequired();
$this->newSiteUrl = $session->get('akeebabackup.transfer.url', '');
$this->newSiteUrlResult = $session->get('akeebabackup.transfer.url_status', '');
$this->ftpSupport = $session->get('akeebabackup.transfer.ftpsupport', null);
$this->transferOption = $session->get('akeebabackup.transfer.transferOption', null);
$this->chunkMode = $session->get('akeebabackup.transfer.chunkMode', 'chunked');
$this->chunkSize = $session->get('akeebabackup.transfer.chunkSize', 5242880);
$this->ftpHost = $session->get('akeebabackup.transfer.ftpHost', null);
$this->ftpPort = $session->get('akeebabackup.transfer.ftpPort', null);
$this->ftpUsername = $session->get('akeebabackup.transfer.ftpUsername', null);
$this->ftpPassword = $session->get('akeebabackup.transfer.ftpPassword', null);
$this->ftpPubKey = $session->get('akeebabackup.transfer.ftpPubKey', null);
$this->ftpPrivateKey = $session->get('akeebabackup.transfer.ftpPrivateKey', null);
$this->ftpDirectory = $session->get('akeebabackup.transfer.ftpDirectory', null);
$this->ftpPassive = $session->get('akeebabackup.transfer.ftpPassive', 1);
$this->ftpPassiveFix = $session->get('akeebabackup.transfer.ftpPassiveFix', 1);
if (!empty($this->latestBackup))
{
$user = Factory::getApplication()->getIdentity();
$lastBackupDate = clone Factory::getDate($this->latestBackup['backupstart'], 'UTC');
$tz = new DateTimeZone($user->getParam('timezone', $app->get('offset')));
$lastBackupDate->setTimezone($tz);
$this->lastBackupDate = $lastBackupDate->format(Text::_('DATE_FORMAT_LC2'), true);
$session->set('akeebabackup.transfer.lastBackup', $this->latestBackup);
}
if (empty($this->ftpSupport))
{
$this->ftpSupport = $model->getFTPSupport();
$session->set('akeebabackup.transfer.ftpsupport', $this->ftpSupport);
}
$this->transferOptions = $this->getTransferMethodOptions();
$this->chunkOptions = $this->getChunkOptions();
$this->chunkSizeOptions = $this->getChunkSizeOptions();
$randomPrefix = $model->makeRandomPrefix();
Text::script('COM_AKEEBABACKUP_FILEFILTERS_LABEL_UIROOT');
Text::script('COM_AKEEBABACKUP_CONFIG_DIRECTFTP_TEST_FAIL');
$this->getDocument()
->addScriptOptions('akeebabackup.System.params.AjaxURL', Route::_(sprintf("index.php?option=com_akeebabackup&view=Transfer&format=raw&force=%d", $this->force), false, Route::TLS_IGNORE, true))
->addScriptOptions('akeebabackup.Transfer.lastUrl', $this->newSiteUrl)
->addScriptOptions('akeebabackup.Transfer.lastResult', $this->newSiteUrlResult)
->addScriptOptions('akeebabackup.transfer', ['randomName' => $randomPrefix . '.php']);
}
/**
* Returns the JHTML options for a transfer methods drop-down, filtering out the unsupported and firewalled methods
*
* @return array
*/
private function getTransferMethodOptions(): array
{
$options = [];
foreach ($this->ftpSupport['supported'] as $method => $supported)
{
if (!$supported)
{
continue;
}
$methodName = Text::_('COM_AKEEBABACKUP_TRANSFER_LBL_TRANSFERMETHOD_' . $method);
if ($this->ftpSupport['firewalled'][$method])
{
$methodName = '🔒 ' . $methodName;
}
$options[] = HTMLHelper::_('select.option', $method, $methodName);
}
$options[] = HTMLHelper::_('select.option', 'manual', Text::_('COM_AKEEBABACKUP_TRANSFER_LBL_TRANSFERMETHOD_MANUALLY'));
return $options;
}
/**
* Returns the JHTML options for a chunk methods drop-down
*
* @return array
*/
private function getChunkOptions(): array
{
$options = [];
$options[] = ['value' => 'chunked', 'text' => Text::_('COM_AKEEBABACKUP_TRANSFER_LBL_TRANSFERMODE_CHUNKED')];
$options[] = ['value' => 'post', 'text' => Text::_('COM_AKEEBABACKUP_TRANSFER_LBL_TRANSFERMODE_POST')];
return $options;
}
/**
* Returns the JHTML options for a chunk size drop-down
*
* @return array
*/
private function getChunkSizeOptions(): array
{
$options = [];
$multiplier = 1048576;
$options[] = ['value' => 0.5 * $multiplier, 'text' => '512 KB'];
$options[] = ['value' => 1 * $multiplier, 'text' => '1 MB'];
$options[] = ['value' => 2 * $multiplier, 'text' => '2 MB'];
$options[] = ['value' => 5 * $multiplier, 'text' => '5 MB'];
$options[] = ['value' => 10 * $multiplier, 'text' => '10 MB'];
$options[] = ['value' => 20 * $multiplier, 'text' => '20 MB'];
$options[] = ['value' => 30 * $multiplier, 'text' => '30 MB'];
$options[] = ['value' => 50 * $multiplier, 'text' => '50 MB'];
$options[] = ['value' => 100 * $multiplier, 'text' => '100 MB'];
return $options;
}
private function addToolbar(): void
{
$toolbar = $this->getToolbarCompat();
ToolbarHelper::title(Text::_('COM_AKEEBABACKUP_TRANSFER'), 'icon-akeeba');
$toolbar->back()
->text('COM_AKEEBABACKUP_CONTROLPANEL')
->icon('fa fa-' . (Factory::getApplication()->getLanguage()->isRtl() ? 'arrow-right' : 'arrow-left'))
->url('index.php?option=com_akeebabackup');
$toolbar->link(
'COM_AKEEBABACKUP_TRANSFER_BTN_RESET',
Route::_('index.php?option=com_akeebabackup&view=Transfer&task=reset', false)
)->icon('icon-refresh');
$toolbar->help(null, false, 'https://www.akeeba.com/documentation/akeeba-backup-joomla/using-akeeba-backup-component.html#menu-transfer');
}
}PK \Sʉ src/View/Transfer/.htaccessnu 7m
Order allow,deny
Deny from all
PK \kY src/View/S3import/HtmlView.phpnu [ addToolbar();
$this->getDocument()->getWebAssetManager()
->useScript('com_akeebabackup.s3import');
/** @var S3importModel $model */
$model = $this->getModel();
// Assign variables
$this->s3access = $model->getState('s3access');
$this->s3secret = $model->getState('s3secret');
$this->buckets = $model->getBuckets();
$this->bucketSelect = $this->getBucketsDropdown();
$this->contents = $model->getContents();
$this->root = $model->getState('folder');
$this->crumbs = $model->getCrumbs();
// Script options
$this->getDocument()
->addScriptOptions('akeebabackup.S3import.accessKey', $this->s3access)
->addScriptOptions('akeebabackup.S3import.secretKey', $this->s3secret)
->addScriptOptions('akeebabackup.S3import.importURL', Route::_(
sprintf(
"index.php?option=com_akeebabackup&view=S3import&task=dltoserver&part=-1&frag=-1&layout=downloading&%s=1",
Factory::getApplication()->getFormToken()
), false, Route::TLS_IGNORE, true));
}
public function onBeforeDltoserver()
{
$this->addToolbar();
$this->getDocument()->getWebAssetManager()
->useScript('com_akeebabackup.s3import');
$this->setLayout('downloading');
/** @var S3importModel $model */
$model = $this->getModel();
/** @var SessionInterface $session */
$session = Factory::getApplication()->getSession();
$total = $session->get('com_akeebabackup.s3import.totalsize', 0);
$done = $session->get('com_akeebabackup.s3import.donesize', 0);
$part = $session->get('com_akeebabackup.s3import.part', 0) + 1;
$parts = $session->get('com_akeebabackup.s3import.totalparts', 0);
$percent = 0;
if ($total > 0)
{
$percent = (int) (100 * ($done / $total));
$percent = max(0, $percent);
$percent = min($percent, 100);
}
$this->total = $total;
$this->done = $done;
$this->percent = $percent;
$this->total_parts = $parts;
$this->current_part = $part;
// Add an immediate redirection URL as a script option
$step = (int) $model->getState('step', 1) + 1;
$location = Route::_('index.php?option=com_akeebabackup&view=S3import&layout=downloading&task=dltoserver&step=' . $step, false, Route::TLS_IGNORE, true);
$this->getDocument()
->addScriptOptions('akeebabackup.S3import.autoRedirectURL', $location);
}
/**
* Get the Joomla HTML drop-down for the S3 buckets
*
* @return mixed
*/
public function getBucketsDropdown()
{
/** @var S3importModel $model */
$model = $this->getModel();
$options = [];
$buckets = $model->getBuckets();
$options[] = HTMLHelper::_('select.option', '', Text::_('COM_AKEEBABACKUP_S3IMPORT_LABEL_SELECTBUCKET'));
if (!empty($buckets))
{
foreach ($buckets as $b)
{
$options[] = HTMLHelper::_('select.option', $b, $b);
}
}
$selected = $model->getState('s3bucket', '');
return HTMLHelper::_('select.genericlist', $options, 's3bucket', [
'list.attr' => [
'class' => 'form-select',
],
], 'value', 'text', $selected);
}
private function addToolbar(): void
{
$toolbar = $this->getToolbarCompat();
ToolbarHelper::title(Text::_('COM_AKEEBABACKUP_S3IMPORT'), 'icon-akeeba');
$toolbar->back()
->text('COM_AKEEBABACKUP_CONTROLPANEL')
->icon('fa fa-' . (Factory::getApplication()->getLanguage()->isRtl() ? 'arrow-right' : 'arrow-left'))
->url('index.php?option=com_akeebabackup');
$toolbar->help(null, false, 'https://www.akeebabackup .com/documentation/akeeba-backup-joomla/import-s3.html');
}
}PK \Sʉ src/View/S3import/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Ey( y( " src/View/Controlpanel/HtmlView.phpnu [ addToolbar();
/** @var ControlpanelModel $model */
$model = $this->getModel();
$statusHelper = Status::getInstance();
try
{
/** @var UsagestatsModel $usageStatsModel */
$this
->getModel('Usagestats')
->collectStatistics();
}
catch (Throwable $e)
{
// This is allowed to fail gracefully.
}
$this->getProfileList();
$this->getProfileIdAndName();
/** @var CMSApplication $app */
$app = \Joomla\CMS\Factory::getApplication();
/** @var Session $session */
$session = $app->getSession();
$params = ComponentHelper::getParams('com_akeebabackup');
$this->quickIconProfiles = $model->getQuickIconProfiles();
$this->statusCell = $statusHelper->getStatusCell();
$this->detailsCell = $statusHelper->getQuirksCell();
$this->latestBackupCell = $statusHelper->getLatestBackupDetails();
$this->areMediaPermissionsFixed = $model->fixMediaPermissions();
$this->checkMbstring = $model->checkMbstring();
$this->needsDownloadID = $model->needsDownloadID() ? 1 : 0;
$this->coreWarningForDownloadID = $model->mustWarnAboutDownloadIDInCore();
$this->extension_id = (int) $model->getState('extension_id', 0);
$this->frontEndSecretWordIssue = $model->getFrontendSecretWordError();
$this->newSecretWord = $session->get('akeebabackup.cpanel.newSecretWord', null);
$this->desktopNotifications = $params->get('desktop_notifications', '0') ? 1 : 0;
$this->formattedChangelog = $this->formatChangelog();
$this->promptForConfigurationwizard = Factory::getConfiguration()->get('akeeba.flag.confwiz', 0) == 0;
$this->countWarnings = count(Factory::getConfigurationChecks()->getDetailedStatus());
$user = $app->getIdentity() ?? (new User());
$this->permissions = [
'configure' => $user->authorise('akeebabackup.configure', 'com_akeebabackup'),
'backup' => $user->authorise('akeebabackup.backup', 'com_akeebabackup'),
'download' => $user->authorise('akeebabackup.download', 'com_akeebabackup'),
];
$this->isOutputDirectoryUnderSiteRoot = $model->isOutputDirectoryUnderSiteRoot();
$this->hasOutputDirectorySecurityFiles = $model->hasOutputDirectorySecurityFiles();
$this->lastUpsellDismiss = $params->get('lastUpsellDismiss', 0);
/** @var UpgradeModel $upgradeModel */
$upgradeModel = $this->getModel('Upgrade');
$upgradeModel->init();
$this->canUpgradeFromAkeebaBackup8 = version_compare(JVERSION, '4.4.999999', 'lt') && in_array(
true, $upgradeModel->runCustomHandlerEvent('onNeedsMigration'), true
);
$this->akeebaBackup8PackageId = $this->getModel()->getAkeebaBackup8PackageId();
/** @var UpdatesModel $updatesModel */
$updatesModel = $this->getModel('Updates');
$this->updateSiteId = $updatesModel->getUpdateSiteIds()[0];
// Load the version constants
Platform::getInstance()->load_version_defines();
// Add the Javascript to the document
$wa = $app->getDocument()->getWebAssetManager();
$wa->useScript('com_akeebabackup.controlpanel');
$this->addJSScriptOptions();
parent::display($tpl);
}
protected function addToolbar(): void
{
ToolbarHelper::title(Text::_('COM_AKEEBABACKUP_' . (AKEEBABACKUP_PRO ? 'PRO' : 'CORE')), 'icon-akeeba');
$toolbar = $this->getToolbarCompat();
$toolbar->preferences('com_akeebabackup');
$toolbar->help(null, false, 'https://www.akeeba.com/documentation/akeeba-backup-joomla/control-panel.html');
}
/**
* Adds inline Javascript to the document
*/
protected function addJSScriptOptions()
{
$this->getDocument()->addScriptOptions(
'akeeba.System.notification.hasDesktopNotification', (bool) $this->desktopNotifications
);
$this->getDocument()->addScriptOptions('akeeba.ControlPanel.needsDownloadID', (bool) $this->needsDownloadID);
$this->getDocument()->addScriptOptions(
'akeeba.ControlPanel.outputDirUnderSiteRoot', (bool) $this->isOutputDirectoryUnderSiteRoot
);
$this->getDocument()->addScriptOptions(
'akeeba.ControlPanel.hasSecurityFiles', (bool) $this->hasOutputDirectorySecurityFiles
);
}
protected function formatChangelog($onlyLast = false)
{
$ret = '';
$file = __DIR__ . '/../../../CHANGELOG.php';
$lines = @file($file);
if (empty($lines))
{
return $ret;
}
array_shift($lines);
foreach ($lines as $line)
{
$line = trim($line);
if (empty($line))
{
continue;
}
$type = substr($line, 0, 1);
switch ($type)
{
case '=':
continue 2;
break;
case '+':
$ret .= "\t" . '
PK \Sʉ tmpl/regexfilefilters/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ tmpl/controlpanel/profile.phpnu [ 'index.php?......'
* ]
* to set up a custom return URL
*/
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Router\Route;
$this->getDocument()->getWebAssetManager()
->usePreset('choicesjs')
->useScript('webcomponent.field-fancy-select');
?>
PK \^\K tmpl/controlpanel/joomla_eol.phpnu [
1760475600): ?>
Joomla! 4 has reached End of Service
Joomla! 4 became End of Service on October 15th, 2025.
Our software for Joomla! 4 is also End of Life. We will no longer provide any updates or support.
Kindly note that we started showing these notices since October 15th, 2023 — two years before the planned End of Life of our software for Joomla! 4.
1728939600): ?>
Joomla! 4 is approaching End of Service
Joomla! 4 is currently in security–only maintenance. It will become End of Service on October 15th, 2025.
Our software for Joomla! 4 is also in security-only maintenance. We only provide security updates and limited support for it until October 15th, 2025.
You need to update your site to Joomla! 5 as soon as possible. We will not provide any updates or support after October 15th, 2025. Moreover, we do not guarantee an update path to Joomla! 5 and beyond will exist after October 15th, 2025.
1697317200): ?>
Joomla! 4 is approaching Security Maintenance
Joomla! 4 will enter security–only maintenance on October 15th, 2024. It will become End of Service on October 15th, 2025.
Will provide full support and updates for our Joomla! 4 software until October 15th, 2024. From then until October 15th, 2025 we will only provide security updates and limited support. We will not provide any updates or support after October 15th, 2025.
We urge you to upgrade your site to Joomla! 5 before October 15th, 2024. Please note that we do not guarantee an update path to Joomla! 5 and beyond after October 15th, 2025.
Please contact the administrator of the site and let them know of this error and what you were doing when this
happened.
- An unhandled Exception has been detected
getMessage()) ?>
File getFile())) ?>
Line getLine() ?>
Would you like us to help you faster?
Save this page as PDF or HTML. Make a ZIP file containing this PDF or HTML file. When filing a support ticket please attach the ZIP file (not the PDF or HTML file itself).
Why do we need all that information?
This information is an x-ray of your site at the time the error occurred. It lets us reproduce the issue or, if it's not a bug in our software, help you pinpoint the external reason which led to it.
What about privacy?
Attachments are private in our ticket system: only you and us can see them, even if you file a public ticket, and they are automatically deleted after a month.
The content below this point is for developers and power users.
Joomla – PHP on
Debug information
Exception type:
getTraceAsString()) ?>
getPrevious()): ?>
Previous exception
getMessage()) ?>
File getFile())) ?> Line getLine() ?>
Exception type:
getTraceAsString()) ?>
System information
Operating System (reported by PHP)
PHP version (as reported by your server)
PHP Built On
PHP SAPI
Server identity
Browser identity
Joomla! version
get(\Joomla\Database\DatabaseInterface::class);
if (!is_null($db)):
?>
$info):
if (strtoupper($info['state']) != 'ENABLED')
{
continue;
} ?>
Directory Status
$v): ?>
WriteableUnwriteable
PK \6L L $ tmpl/commontemplates/profilename.phpnu [
:
#profileId) ?> escape($this->profileName) ?>
PK \Z+ + ! tmpl/commontemplates/wrongphp.phpnu [ [maintenance_date, eol_date]
*
* For versions older than 5.6 we use a fake maintenance_date because this information no longer exists on PHP's
* site and it's irrelevant anyway; these PHP versions are already EOL therefore we only use their EOL date.
*/
$phpDates = array(
'3.0' => array('1990-01-01 00:00:00', '2000-10-20 00:00:00'),
'4.0' => array('1990-01-01 00:00:00', '2001-06-23 00:00:00'),
'4.1' => array('1990-01-01 00:00:00', '2002-03-12 00:00:00'),
'4.2' => array('1990-01-01 00:00:00', '2002-09-06 00:00:00'),
'4.3' => array('1990-01-01 00:00:00', '2005-03-31 00:00:00'),
'4.4' => array('1990-01-01 00:00:00', '2008-08-07 00:00:00'),
'5.0' => array('1990-01-01 00:00:00', '2005-09-05 00:00:00'),
'5.1' => array('1990-01-01 00:00:00', '2006-08-24 00:00:00'),
'5.2' => array('1990-01-01 00:00:00', '2011-01-11 00:00:00'),
'5.3' => array('1990-01-01 00:00:00', '2014-08-14 00:00:00'),
'5.4' => array('1990-01-01 00:00:00', '2015-09-03 00:00:00'),
'5.5' => array('1990-01-01 00:00:00', '2016-07-10 00:00:00'),
'5.6' => array('2017-01-10 00:00:00', '2018-12-31 00:00:00'),
'7.0' => array('2018-01-01 00:00:00', '2019-01-10 00:00:00'),
'7.1' => array('2018-12-01 00:00:00', '2019-12-01 00:00:00'),
'7.2' => array('2019-11-30 00:00:00', '2020-11-30 00:00:00'),
'7.3' => array('2020-12-06 00:00:00', '2021-12-06 00:00:00'),
'7.4' => array('2021-11-28 00:00:00', '2022-11-28 00:00:00'),
'8.0' => array('2022-11-26 00:00:00', '2023-11-26 00:00:00'),
'8.1' => array('2023-11-25 00:00:00', '2024-11-25 00:00:00'),
);
// Make sure I have all necessary configuration variables
$config = array_merge(array(
'minPHPVersion' => '7.2.0',
'softwareName' => 'This software',
'silentResults' => false,
'longVersion' => PHP_VERSION,
'shortVersion' => sprintf('%d.%d', PHP_MAJOR_VERSION, PHP_MINOR_VERSION),
'currentTimestamp' => time(),
), $config);
// Selectively extract configuration variables. Do not use extract(), it's potentially dangerous.
$minPHPVersion = $config['minPHPVersion'];
$softwareName = $config['softwareName'];
$silentResults = $config['silentResults'];
$longVersion = $config['longVersion'];
$shortVersion = $config['shortVersion'];
$currentTimestamp = $config['currentTimestamp'];
if (!version_compare($longVersion, $minPHPVersion, 'lt'))
{
unset($minPHPVersion, $softwareName, $longVersion, $shortVersion, $phpDates,
$silentResults, $currentTimestamp);
return true;
}
// Typically used in the frontend to not divulge any information about the server
if ($silentResults)
{
return false;
}
/**
* Safe defaults for PHP versions older than 5.3.0.
*
* Older PHP versions don't even have support for DateTime so we need these defaults to prevent this warning script from
* bringing the site down with an error.
*/
$isEol = true;
$isAncient = true;
$isSecurity = false;
$isCurrent = false;
$eolDateFormatted = $phpDates[$shortVersion][1];
$securityDateFormatted = $phpDates[$shortVersion][0];
/**
* This can only work on PHP 5.2.0 or later
*/
if (version_compare($longVersion, '5.2.0', 'ge'))
{
$tzGmt = new DateTimeZone('GMT');
$securityDate = new DateTime($phpDates[$shortVersion][0], $tzGmt);
$eolDate = new DateTime($phpDates[$shortVersion][1], $tzGmt);
/**
* Ancient: This PHP version has reached end-of-life more than 2 years ago
* EOL: This PHP version has reached end-of-life
* Security: This PHP version has reached the Security Support date but not the EOL date yet
* Current: This PHP version is still in Active Support
*/
$isEol = $eolDate->getTimestamp() <= $currentTimestamp;
$isAncient = $isEol && (($currentTimestamp - $eolDate->getTimestamp()) >= 63072000);
$isSecurity = !$isEol && ($securityDate->getTimestamp() <= $currentTimestamp);
$isCurrent = !$isEol && !$isSecurity;
$eolDateFormatted = $eolDate->format('l, d F Y');
$securityDateFormatted = $securityDate->format('l, d F Y');
}
$characterization = $isCurrent ? 'unsupported' : 'older';
$characterization = $isEol ? 'obsolete' : $characterization;
$characterization = $isAncient ? 'dangerously obsolete' : $characterization;
?>
requires PHP or later.
PHP version detected
You can check our Compatibility page to see which versions of PHP are supported by each version of our software, select the newest one that fits your site's needs and upgrade your site to it. If you are unsure how to do this, please ask your host.
Your version of PHP, , has reached the end of its life a very long time ago, namely on . It has known security vulnerabilities which can be used to compromise (“hack”) web servers. It is no longer safe using it in production. You are VERY STRONGLY advised to upgrade your server to a supported PHP version as soon as possible.
Security advice
Your version of PHP, , has reached the end of its life on . End-of-life PHP versions may have security vulnerabilities — which may or may not have been known before they became End of Life — which can be used to compromise (“hack”) your site. It is no longer safe using it in production, even if your host or your Linux distribution claim otherwise. The PHP language developers themselves have said time over time that not all security vulnerabilities fixes can be backported to End-of-Life versions of PHP since they may require architectural changes in PHP itself. You are strongly advised to upgrade your server to a supported PHP version as soon as possible.
Security reminder
Your version of PHP, , has entered the “Security Support” phase of its life on . As such, only security issues will be addressed but not any of its known functional issues (“bugs”). Unfixed functional issues in PHP can lead to your site not working properly. It is advisable to plan migrating your site to a supported PHP version no later than – that's when PHP will become End-of-Life, therefore completely unsuitable for use on a live server.
Why is my PHP version not supported?
Even though PHP will be supported by the PHP project until we are unfortunately unable to provide support for it in our software. This has to do either with missing features or third party libraries. Older PHP versions are missing features we require for our software to work efficiently and be written in a way that makes it possible for us to provide a plethora of relevant features while maintaining good quality control. Moreover, third party libraries we use to provide some of the software's features do not support older PHP versions for the same reason – so even if we don't absolutely need to use at least PHP the third party libraries do, making it impossible for our software to run on your older version . We apologize for the inconvenience.
We'd like to remind you, however, that newer PHP versions are always faster and more well-tested than their predecessors. Upgrading your site to a newer PHP version will not only let our software run but will also make your site faster, more stable and help it perform better in search engine results.
isset($minPHPVersion) ? $minPHPVersion : '7.2.0',
'softwareName' => isset($softwareName) ? $softwareName : 'This software',
'silentResults' => isset($silentResults) ? $silentResults : false,
// Override these to test the script
'longVersion' => isset($longVersion) ? $longVersion : PHP_VERSION,
'shortVersion' => isset($shortVersion) ? $shortVersion : sprintf('%d.%d', PHP_MAJOR_VERSION, PHP_MINOR_VERSION),
'currentTimestamp' => isset($currentTimestamp) ? $currentTimestamp : time(),
));
}
catch (Exception $e)
{
// This should never happen
return false;
}
}PK \~2ּG/ G/ + tmpl/commontemplates/phpversion_warning.phpnu [ [maintenance_date, eol_date]
*
* For versions older than 5.6 we use a fake maintenance_date because this information no longer exists on PHP's
* site and it's irrelevant anyway; these PHP versions are already EOL therefore we only use their EOL date.
*/
$phpDates = array(
'3.0' => array('1990-01-01 00:00:00', '2000-10-20 00:00:00'),
'4.0' => array('1990-01-01 00:00:00', '2001-06-23 00:00:00'),
'4.1' => array('1990-01-01 00:00:00', '2002-03-12 00:00:00'),
'4.2' => array('1990-01-01 00:00:00', '2002-09-06 00:00:00'),
'4.3' => array('1990-01-01 00:00:00', '2005-03-31 00:00:00'),
'4.4' => array('1990-01-01 00:00:00', '2008-08-07 00:00:00'),
'5.0' => array('1990-01-01 00:00:00', '2005-09-05 00:00:00'),
'5.1' => array('1990-01-01 00:00:00', '2006-08-24 00:00:00'),
'5.2' => array('1990-01-01 00:00:00', '2011-01-11 00:00:00'),
'5.3' => array('1990-01-01 00:00:00', '2014-08-14 00:00:00'),
'5.4' => array('1990-01-01 00:00:00', '2015-09-03 00:00:00'),
'5.5' => array('1990-01-01 00:00:00', '2016-07-10 00:00:00'),
'5.6' => array('2017-01-10 00:00:00', '2018-12-31 00:00:00'),
'7.0' => array('2018-01-01 00:00:00', '2019-01-10 00:00:00'),
'7.1' => array('2018-12-01 00:00:00', '2019-12-01 00:00:00'),
'7.2' => array('2019-11-30 00:00:00', '2020-11-30 00:00:00'),
'7.3' => array('2020-12-06 00:00:00', '2021-12-06 00:00:00'),
'7.4' => array('2021-11-28 00:00:00', '2022-11-28 00:00:00'),
'8.0' => array('2022-11-26 00:00:00', '2023-11-26 00:00:00'),
'8.1' => array('2023-11-25 00:00:00', '2024-11-25 00:00:00'),
);
// Make sure I have all necessary configuration variables
$useFef = !defined('JVERSION') || version_compare(JVERSION, '4.0.0', 'lt');
$config = array_merge(array(
'softwareName' => 'This software',
'class_priority_low' => $useFef ? 'akeeba-block--info' : 'alert alert-info',
'class_priority_medium' => $useFef ? 'akeeba-block--warning' : 'alert alert-warning',
'class_priority_high' => $useFef ? 'akeeba-block--failure' : 'alert alert-danger',
'warn_about_maintenance' => true,
'maintenance_period' => 'P6M',
'eol_period_too_old' => 'P3M',
'longVersion' => PHP_VERSION,
'shortVersion' => sprintf('%d.%d', PHP_MAJOR_VERSION, PHP_MINOR_VERSION),
'currentTimestamp' => time(),
), $config);
// Selectively extract configuration variables. Do not use extract(), it's potentially dangerous.
$softwareName = $config['softwareName'];
$class_priority_low = $config['class_priority_low'];
$class_priority_medium = $config['class_priority_medium'];
$class_priority_high = $config['class_priority_high'];
$warn_about_maintenance = $config['warn_about_maintenance'];
$maintenance_period = $config['maintenance_period'];
$eol_period_too_old = $config['eol_period_too_old'];
$longVersion = $config['longVersion'];
$shortVersion = $config['shortVersion'];
$currentTimestamp = $config['currentTimestamp'];
$phpVersions = array_keys($phpDates);
$lastVersion = array_pop($phpVersions);
/**
* Safe defaults for PHP versions older than 5.3.0.
*
* Older PHP versions don't even have support for DateTime so we need these defaults to prevent this warning script from
* bringing the site down with an error.
*/
$isEol = true;
$isAncient = true;
$isSecurity = false;
$isCurrent = false;
$isTooNew = !isset($phpDates[$shortVersion]) && version_compare($shortVersion, $lastVersion, 'gt');
$eolDateFormatted = isset($phpDates[$shortVersion]) ? $phpDates[$shortVersion][1] : '';
$securityDateFormatted = isset($phpDates[$shortVersion]) ? $phpDates[$shortVersion][0] : '';
/**
* This can only work on PHP 5.3.0 or later since we are using DatePeriod (PHP >= 5.3.0)
*/
if (version_compare($longVersion, '5.2.0', 'ge') && !$isTooNew)
{
$tzGmt = new DateTimeZone('GMT');
$securityDate = new DateTime($phpDates[$shortVersion][0], $tzGmt);
$eolDate = new DateTime($phpDates[$shortVersion][1], $tzGmt);
$ancientPeriod = new DateInterval($eol_period_too_old);
$ancientDate = clone $eolDate;
$ancientDate->add($ancientPeriod);
if (!empty($maintenance_period))
{
$maintenancePeriod = new DateInterval($maintenance_period);
$securityDate = $securityDate->add($maintenancePeriod);
}
/**
* Ancient: This PHP version has reached end-of-life more than $eol_period_too_old ago
* EOL: This PHP version has reached end-of-life
* Security: This PHP version has reached the Security Support date but not the EOL date yet
* Current: This PHP version is still in Active Support
*/
$isEol = $eolDate->getTimestamp() <= $currentTimestamp;
$isAncient = $ancientDate->getTimestamp() <= $currentTimestamp;
$isSecurity = !$isEol && ($securityDate->getTimestamp() <= $currentTimestamp);
$isCurrent = !$isEol && !$isSecurity;
$eolDateFormatted = $eolDate->format('l, d F Y');
$securityDateFormatted = $securityDate->format('l, d F Y');
}
if ($isCurrent)
{
return;
}
if ($isTooNew): ?>
PHP version is newer than this software supports
Your site is currently using PHP . This version of PHP was released after your currently installed version of was released. As a result, we cannot guarantee that will work correctly on your site.
Please check for an updated version of . Kindly note that it usually takes us a few days to weeks after the initial (X.Y.0) PHP version release before we publish a version of our software which supports it.
Severely outdated PHP version
Your site is currently using PHP . This version of PHP has become End-of-Life since . It has not received security updates for a very long time. You MUST NOT use it for a live site!
will stop supporting your version of PHP very soon. You must very urgently upgrade to a newer version of PHP. You can check our Compatibility page to see which versions of PHP are supported by each version of our software, select the newest one that fits your site's needs and upgrade your site to it. You can ask your host or your system administrator for instructions on upgrading PHP. It's easy and it will make your site faster and more secure.
Outdated PHP version
Your site is currently using PHP . This version of PHP has recently become End-of-Life since . It has stopped receiving security updates. You should not use it for a live site.
will stop supporting your version of PHP in the near future. You should upgrade to a newer version of PHP at your earliest convenience. You can check our Compatibility page to see which versions of PHP are supported by each version of our software, select the newest one that fits your site's needs and upgrade your site to it. You can ask your host or your system administrator for instructions on upgrading PHP. It's easy and it will make your site faster and more secure.
PHP is approaching End–of–Life
Your site is currently using PHP . This version of PHP has entered its “Security maintenance” phase since and has stopped receiving bug fixes. It will stop receiving security updates on at which point it will be unsuitable for use on a live site. We recommend updating to a newer PHP version as soon as possible.
We have detected that you are running HHVM instead of PHP. This software WILL NOT WORK properly on HHVM. Please switch to PHP 7 instead.
HHVM was Facebook's attempt at modernizing the PHP 5.x language and making it faster. Unfortunately it's also incompatible with PHP proper.
PHP 7 has solved all these issues. It's fast, modern and fully compatible with our software.
Please switch to PHP 7. If you are unsure how to do that, contact your host or the person responsible for maintaining your server.
They are the only people who can help you configure your server.
Kindly note that HHVM is not -and has never been- a supported execution environment for our software.
As a result, if you see this message on your site you are unfortunately ineligible for support and / or filing bug reports.
Please switch to PHP 7. If your problem persists after that we can help you / accept your bug report. Thank you for your understanding.
PK \Sʉ tmpl/commontemplates/.htaccessnu 7m
Order allow,deny
Deny from all
PK \M " tmpl/multipledatabases/default.phpnu [
PK \Sʉ tmpl/alice/.htaccessnu 7m
Order allow,deny
Deny from all
PK \(dB B tmpl/filefilters/default.phpnu [ loadAnyTemplate('commontemplates/errormodal');
echo $this->loadAnyTemplate('commontemplates/profilename');
?>
PK \Sʉ tmpl/filefilters/.htaccessnu 7m
Order allow,deny
Deny from all
PK \IMy y % tmpl/regexdatabasefilters/default.phpnu [ loadAnyTemplate('commontemplates/errormodal');
echo $this->loadAnyTemplate('commontemplates/profilename');
?>
root_select ?>
PK \Sʉ # tmpl/regexdatabasefilters/.htaccessnu 7m
Order allow,deny
Deny from all
PK \|N tmpl/web.confignu [
PK \wY tmpl/s3import/default.phpnu [
PK \+ 2 tmpl/s3import/downloading.phpnu [
PK \{Ӻ backup/index.phpnu [
This file was generated automatically by the Akeeba Backup Engine
DO NOT REMOVE THIS FILE
This file tells your web server to not list the contents of this directory, instead returning an HTTP 403 Forbidden
error. This makes it implausible for a malicious third party to successfully guess the filenames of your backup
archives. Therefore, even if this folder is directly web accessible – despite the .htaccess and web.config file already
put in place by the Akeeba Backup Engine – it will still be reasonably protected against malicious users trying to
download your backup archives.
Please do not remove this file as it could have security implications for your site.
You are strongly advised to never delete or modify any of the files automatically created in this folder by the
Akeeba Backup Engine, namely:
* .htaccess
* web.config
* index.html
* index.htm
* index.php
PK \㘉ħ backup/web.confignu [
PK \Sʉ backup/.htaccessnu 7m
Order allow,deny
Deny from all
PK \0 backup/index.htmlnu [
PK \q vendor/autoload.phpnu [ = 70400)) {
$issues[] = 'Your Composer dependencies require a PHP version ">= 7.4.0". You are running ' . PHP_VERSION . '.';
}
if ($issues) {
if (!headers_sent()) {
header('HTTP/1.1 500 Internal Server Error');
}
if (!ini_get('display_errors')) {
if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
fwrite(STDERR, 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . implode(PHP_EOL, $issues) . PHP_EOL.PHP_EOL);
} elseif (!headers_sent()) {
echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL;
}
}
throw new \RuntimeException(
'Composer detected issues in your platform: ' . implode(' ', $issues)
);
}
PK \2@ u? ? vendor/composer/ClassLoader.phpnu [
* Jordi Boggiano
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Composer\Autoload;
/**
* ClassLoader implements a PSR-0, PSR-4 and classmap class loader.
*
* $loader = new \Composer\Autoload\ClassLoader();
*
* // register classes with namespaces
* $loader->add('Symfony\Component', __DIR__.'/component');
* $loader->add('Symfony', __DIR__.'/framework');
*
* // activate the autoloader
* $loader->register();
*
* // to enable searching the include path (eg. for PEAR packages)
* $loader->setUseIncludePath(true);
*
* In this example, if you try to use a class in the Symfony\Component
* namespace or one of its children (Symfony\Component\Console for instance),
* the autoloader will first look for the class under the component/
* directory, and it will then fallback to the framework/ directory if not
* found before giving up.
*
* This class is loosely based on the Symfony UniversalClassLoader.
*
* @author Fabien Potencier
* @author Jordi Boggiano
* @see https://www.php-fig.org/psr/psr-0/
* @see https://www.php-fig.org/psr/psr-4/
*/
class ClassLoader
{
/** @var \Closure(string):void */
private static $includeFile;
/** @var string|null */
private $vendorDir;
// PSR-4
/**
* @var array>
*/
private $prefixLengthsPsr4 = array();
/**
* @var array>
*/
private $prefixDirsPsr4 = array();
/**
* @var list
*/
private $fallbackDirsPsr4 = array();
// PSR-0
/**
* List of PSR-0 prefixes
*
* Structured as array('F (first letter)' => array('Foo\Bar (full prefix)' => array('path', 'path2')))
*
* @var array>>
*/
private $prefixesPsr0 = array();
/**
* @var list
*/
private $fallbackDirsPsr0 = array();
/** @var bool */
private $useIncludePath = false;
/**
* @var array
*/
private $classMap = array();
/** @var bool */
private $classMapAuthoritative = false;
/**
* @var array
*/
private $missingClasses = array();
/** @var string|null */
private $apcuPrefix;
/**
* @var array
*/
private static $registeredLoaders = array();
/**
* @param string|null $vendorDir
*/
public function __construct($vendorDir = null)
{
$this->vendorDir = $vendorDir;
self::initializeIncludeClosure();
}
/**
* @return array>
*/
public function getPrefixes()
{
if (!empty($this->prefixesPsr0)) {
return call_user_func_array('array_merge', array_values($this->prefixesPsr0));
}
return array();
}
/**
* @return array>
*/
public function getPrefixesPsr4()
{
return $this->prefixDirsPsr4;
}
/**
* @return list
*/
public function getFallbackDirs()
{
return $this->fallbackDirsPsr0;
}
/**
* @return list
*/
public function getFallbackDirsPsr4()
{
return $this->fallbackDirsPsr4;
}
/**
* @return array Array of classname => path
*/
public function getClassMap()
{
return $this->classMap;
}
/**
* @param array $classMap Class to filename map
*
* @return void
*/
public function addClassMap(array $classMap)
{
if ($this->classMap) {
$this->classMap = array_merge($this->classMap, $classMap);
} else {
$this->classMap = $classMap;
}
}
/**
* Registers a set of PSR-0 directories for a given prefix, either
* appending or prepending to the ones previously set for this prefix.
*
* @param string $prefix The prefix
* @param list|string $paths The PSR-0 root directories
* @param bool $prepend Whether to prepend the directories
*
* @return void
*/
public function add($prefix, $paths, $prepend = false)
{
$paths = (array) $paths;
if (!$prefix) {
if ($prepend) {
$this->fallbackDirsPsr0 = array_merge(
$paths,
$this->fallbackDirsPsr0
);
} else {
$this->fallbackDirsPsr0 = array_merge(
$this->fallbackDirsPsr0,
$paths
);
}
return;
}
$first = $prefix[0];
if (!isset($this->prefixesPsr0[$first][$prefix])) {
$this->prefixesPsr0[$first][$prefix] = $paths;
return;
}
if ($prepend) {
$this->prefixesPsr0[$first][$prefix] = array_merge(
$paths,
$this->prefixesPsr0[$first][$prefix]
);
} else {
$this->prefixesPsr0[$first][$prefix] = array_merge(
$this->prefixesPsr0[$first][$prefix],
$paths
);
}
}
/**
* Registers a set of PSR-4 directories for a given namespace, either
* appending or prepending to the ones previously set for this namespace.
*
* @param string $prefix The prefix/namespace, with trailing '\\'
* @param list|string $paths The PSR-4 base directories
* @param bool $prepend Whether to prepend the directories
*
* @throws \InvalidArgumentException
*
* @return void
*/
public function addPsr4($prefix, $paths, $prepend = false)
{
$paths = (array) $paths;
if (!$prefix) {
// Register directories for the root namespace.
if ($prepend) {
$this->fallbackDirsPsr4 = array_merge(
$paths,
$this->fallbackDirsPsr4
);
} else {
$this->fallbackDirsPsr4 = array_merge(
$this->fallbackDirsPsr4,
$paths
);
}
} elseif (!isset($this->prefixDirsPsr4[$prefix])) {
// Register directories for a new namespace.
$length = strlen($prefix);
if ('\\' !== $prefix[$length - 1]) {
throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
}
$this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
$this->prefixDirsPsr4[$prefix] = $paths;
} elseif ($prepend) {
// Prepend directories for an already registered namespace.
$this->prefixDirsPsr4[$prefix] = array_merge(
$paths,
$this->prefixDirsPsr4[$prefix]
);
} else {
// Append directories for an already registered namespace.
$this->prefixDirsPsr4[$prefix] = array_merge(
$this->prefixDirsPsr4[$prefix],
$paths
);
}
}
/**
* Registers a set of PSR-0 directories for a given prefix,
* replacing any others previously set for this prefix.
*
* @param string $prefix The prefix
* @param list|string $paths The PSR-0 base directories
*
* @return void
*/
public function set($prefix, $paths)
{
if (!$prefix) {
$this->fallbackDirsPsr0 = (array) $paths;
} else {
$this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths;
}
}
/**
* Registers a set of PSR-4 directories for a given namespace,
* replacing any others previously set for this namespace.
*
* @param string $prefix The prefix/namespace, with trailing '\\'
* @param list|string $paths The PSR-4 base directories
*
* @throws \InvalidArgumentException
*
* @return void
*/
public function setPsr4($prefix, $paths)
{
if (!$prefix) {
$this->fallbackDirsPsr4 = (array) $paths;
} else {
$length = strlen($prefix);
if ('\\' !== $prefix[$length - 1]) {
throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
}
$this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
$this->prefixDirsPsr4[$prefix] = (array) $paths;
}
}
/**
* Turns on searching the include path for class files.
*
* @param bool $useIncludePath
*
* @return void
*/
public function setUseIncludePath($useIncludePath)
{
$this->useIncludePath = $useIncludePath;
}
/**
* Can be used to check if the autoloader uses the include path to check
* for classes.
*
* @return bool
*/
public function getUseIncludePath()
{
return $this->useIncludePath;
}
/**
* Turns off searching the prefix and fallback directories for classes
* that have not been registered with the class map.
*
* @param bool $classMapAuthoritative
*
* @return void
*/
public function setClassMapAuthoritative($classMapAuthoritative)
{
$this->classMapAuthoritative = $classMapAuthoritative;
}
/**
* Should class lookup fail if not found in the current class map?
*
* @return bool
*/
public function isClassMapAuthoritative()
{
return $this->classMapAuthoritative;
}
/**
* APCu prefix to use to cache found/not-found classes, if the extension is enabled.
*
* @param string|null $apcuPrefix
*
* @return void
*/
public function setApcuPrefix($apcuPrefix)
{
$this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null;
}
/**
* The APCu prefix in use, or null if APCu caching is not enabled.
*
* @return string|null
*/
public function getApcuPrefix()
{
return $this->apcuPrefix;
}
/**
* Registers this instance as an autoloader.
*
* @param bool $prepend Whether to prepend the autoloader or not
*
* @return void
*/
public function register($prepend = false)
{
spl_autoload_register(array($this, 'loadClass'), true, $prepend);
if (null === $this->vendorDir) {
return;
}
if ($prepend) {
self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders;
} else {
unset(self::$registeredLoaders[$this->vendorDir]);
self::$registeredLoaders[$this->vendorDir] = $this;
}
}
/**
* Unregisters this instance as an autoloader.
*
* @return void
*/
public function unregister()
{
spl_autoload_unregister(array($this, 'loadClass'));
if (null !== $this->vendorDir) {
unset(self::$registeredLoaders[$this->vendorDir]);
}
}
/**
* Loads the given class or interface.
*
* @param string $class The name of the class
* @return true|null True if loaded, null otherwise
*/
public function loadClass($class)
{
if ($file = $this->findFile($class)) {
$includeFile = self::$includeFile;
$includeFile($file);
return true;
}
return null;
}
/**
* Finds the path to the file where the class is defined.
*
* @param string $class The name of the class
*
* @return string|false The path if found, false otherwise
*/
public function findFile($class)
{
// class map lookup
if (isset($this->classMap[$class])) {
return $this->classMap[$class];
}
if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) {
return false;
}
if (null !== $this->apcuPrefix) {
$file = apcu_fetch($this->apcuPrefix.$class, $hit);
if ($hit) {
return $file;
}
}
$file = $this->findFileWithExtension($class, '.php');
// Search for Hack files if we are running on HHVM
if (false === $file && defined('HHVM_VERSION')) {
$file = $this->findFileWithExtension($class, '.hh');
}
if (null !== $this->apcuPrefix) {
apcu_add($this->apcuPrefix.$class, $file);
}
if (false === $file) {
// Remember that this class does not exist.
$this->missingClasses[$class] = true;
}
return $file;
}
/**
* Returns the currently registered loaders keyed by their corresponding vendor directories.
*
* @return array
*/
public static function getRegisteredLoaders()
{
return self::$registeredLoaders;
}
/**
* @param string $class
* @param string $ext
* @return string|false
*/
private function findFileWithExtension($class, $ext)
{
// PSR-4 lookup
$logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
$first = $class[0];
if (isset($this->prefixLengthsPsr4[$first])) {
$subPath = $class;
while (false !== $lastPos = strrpos($subPath, '\\')) {
$subPath = substr($subPath, 0, $lastPos);
$search = $subPath . '\\';
if (isset($this->prefixDirsPsr4[$search])) {
$pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
foreach ($this->prefixDirsPsr4[$search] as $dir) {
if (file_exists($file = $dir . $pathEnd)) {
return $file;
}
}
}
}
}
// PSR-4 fallback dirs
foreach ($this->fallbackDirsPsr4 as $dir) {
if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
return $file;
}
}
// PSR-0 lookup
if (false !== $pos = strrpos($class, '\\')) {
// namespaced class name
$logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
. strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
} else {
// PEAR-like class name
$logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
}
if (isset($this->prefixesPsr0[$first])) {
foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
if (0 === strpos($class, $prefix)) {
foreach ($dirs as $dir) {
if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
return $file;
}
}
}
}
}
// PSR-0 fallback dirs
foreach ($this->fallbackDirsPsr0 as $dir) {
if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
return $file;
}
}
// PSR-0 include paths.
if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
return $file;
}
return false;
}
/**
* @return void
*/
private static function initializeIncludeClosure()
{
if (self::$includeFile !== null) {
return;
}
/**
* Scope isolated include.
*
* Prevents access to $this/self from included files.
*
* @param string $file
* @return void
*/
self::$includeFile = \Closure::bind(static function($file) {
include $file;
}, null, null);
}
}
PK \N%
# vendor/composer/autoload_static.phpnu [ __DIR__ . '/..' . '/akeeba/s3/src/aliasing.php',
);
public static $prefixLengthsPsr4 = array (
'C' =>
array (
'Composer\\CaBundle\\' => 18,
),
'A' =>
array (
'Akeeba\\WebPush\\' => 15,
'Akeeba\\UsageStats\\Collector\\' => 28,
'Akeeba\\S3\\' => 10,
'Akeeba\\PHPFinder\\' => 17,
'Akeeba\\Engine\\' => 14,
'Akeeba\\Backup\\Tests\\' => 20,
),
);
public static $prefixDirsPsr4 = array (
'Composer\\CaBundle\\' =>
array (
0 => __DIR__ . '/..' . '/composer/ca-bundle/src',
),
'Akeeba\\WebPush\\' =>
array (
0 => __DIR__ . '/..' . '/akeeba/webpush/src',
),
'Akeeba\\UsageStats\\Collector\\' =>
array (
0 => __DIR__ . '/..' . '/akeeba/stats_collector/src',
),
'Akeeba\\S3\\' =>
array (
0 => __DIR__ . '/..' . '/akeeba/s3/src',
),
'Akeeba\\PHPFinder\\' =>
array (
0 => __DIR__ . '/..' . '/akeeba/phpfinder/src',
),
'Akeeba\\Engine\\' =>
array (
0 => __DIR__ . '/..' . '/akeeba/engine/engine',
),
'Akeeba\\Backup\\Tests\\' =>
array (
0 => __DIR__ . '/../../../..' . '/Tests',
),
);
public static $prefixesPsr0 = array (
'P' =>
array (
'PHPSQLParser\\' =>
array (
0 => __DIR__ . '/..' . '/greenlion/php-sql-parser/src',
),
),
);
public static $classMap = array (
'Composer\\InstalledVersions' => __DIR__ . '/..' . '/composer/InstalledVersions.php',
);
public static function getInitializer(ClassLoader $loader)
{
return \Closure::bind(function () use ($loader) {
$loader->prefixLengthsPsr4 = ComposerStaticInit7e7ffb6f1a9e828ca7ae967d28b893af::$prefixLengthsPsr4;
$loader->prefixDirsPsr4 = ComposerStaticInit7e7ffb6f1a9e828ca7ae967d28b893af::$prefixDirsPsr4;
$loader->prefixesPsr0 = ComposerStaticInit7e7ffb6f1a9e828ca7ae967d28b893af::$prefixesPsr0;
$loader->classMap = ComposerStaticInit7e7ffb6f1a9e828ca7ae967d28b893af::$classMap;
}, null, ClassLoader::class);
}
}
PK \)A A vendor/composer/installed.jsonnu [ {
"packages": [
{
"name": "akeeba/engine",
"version": "dev-development",
"version_normalized": "dev-development",
"source": {
"type": "git",
"url": "git@github.com:akeeba/engine.git",
"reference": "ac33ea315ad7b52e81fcdedbd9ea6e6f600b6fa6"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/akeeba/engine/zipball/ac33ea315ad7b52e81fcdedbd9ea6e6f600b6fa6",
"reference": "ac33ea315ad7b52e81fcdedbd9ea6e6f600b6fa6",
"shasum": ""
},
"require": {
"akeeba/s3": "dev-development",
"ext-fileinfo": "*",
"ext-json": "*",
"ext-mbstring": "*",
"greenlion/php-sql-parser": "^4.6.0",
"php": "^7.4.0|^8.0"
},
"require-dev": {
"composer/ca-bundle": "^1.3.6",
"joomla/uri": "^3.0-dev",
"mnapoli/silly": "^1.8.3",
"phpunit/phpunit": "^9.0.0",
"rector/rector": "^0.15.21"
},
"suggest": {
"ext-curl": "*",
"ext-dom": "*",
"ext-ftp": "*",
"ext-mysqli": "*",
"ext-openssl": "*",
"ext-pdo": "*",
"ext-simplexml": "*",
"ext-sqlite3": "*",
"ext-ssh2": "*",
"ext-zip": "*"
},
"time": "2026-06-19T10:28:09+00:00",
"default-branch": true,
"type": "library",
"installation-source": "dist",
"autoload": {
"psr-4": {
"Akeeba\\Engine\\": "engine/"
}
},
"autoload-dev": {
"psr-4": {
"Akeeba\\Engine\\DevPlatform\\": "dev_platform/",
"Akeeba\\Engine\\Filter\\": "dev_platform/Platform/Filter/",
"Akeeba\\Engine\\Platform\\": "dev_platform/Platform/",
"Akeeba\\Engine\\Test\\": "Test/"
}
},
"archive": {
"exclude": [
"binned_ideas",
"connector_development",
"dev_platform",
"run",
"Test",
"tools"
]
},
"scripts": {
"test": [
"phpunit"
]
},
"license": [
"GPL-3.0-or-later"
],
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM_PLEASE@akeeba.com",
"homepage": "https://www.dionysopoulos.me",
"role": "Lead Developer"
},
{
"name": "Davide Tampellini",
"email": "davide_NO_SPAM_PLEASE@akeeba.com",
"homepage": "https://www.dionysopoulos.me",
"role": "Senior Developer"
}
],
"description": "Akeeba Engine - a site backup engine written in pure PHP",
"homepage": "https://github.com/akeeba/engine",
"keywords": [
"backup",
"mysql",
"php"
],
"support": {
"source": "https://github.com/akeeba/engine/tree/development",
"issues": "https://github.com/akeeba/engine/issues"
},
"install-path": "../akeeba/engine"
},
{
"name": "akeeba/phpfinder",
"version": "1.0.1",
"version_normalized": "1.0.1.0",
"source": {
"type": "git",
"url": "https://github.com/akeeba/phpfinder.git",
"reference": "0a00eb712c72000f6dbd4cd3a772bd327c288920"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/akeeba/phpfinder/zipball/0a00eb712c72000f6dbd4cd3a772bd327c288920",
"reference": "0a00eb712c72000f6dbd4cd3a772bd327c288920",
"shasum": ""
},
"require": {
"php": ">=7.2.0 <=8.4"
},
"time": "2025-12-22T07:08:43+00:00",
"type": "library",
"installation-source": "dist",
"autoload": {
"psr-4": {
"Akeeba\\PHPFinder\\": "src"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"GPL-3.0-or-later"
],
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM_PLEASE@akeeba.com",
"homepage": "http://www.dionysopoulos.me",
"role": "Lead Developer"
}
],
"description": "Locate the PHP CLI binary on the server",
"homepage": "https://github.com/akeeba/phpfinder",
"keywords": [
"cli",
"php"
],
"support": {
"issues": "https://github.com/akeeba/phpfinder/issues",
"source": "https://github.com/akeeba/phpfinder/tree/1.0.1"
},
"install-path": "../akeeba/phpfinder"
},
{
"name": "akeeba/s3",
"version": "dev-development",
"version_normalized": "dev-development",
"source": {
"type": "git",
"url": "https://github.com/akeeba/s3.git",
"reference": "6e251af705c5a61710b32f79bfb905483634c5fb"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/akeeba/s3/zipball/6e251af705c5a61710b32f79bfb905483634c5fb",
"reference": "6e251af705c5a61710b32f79bfb905483634c5fb",
"shasum": ""
},
"require": {
"ext-curl": "*",
"ext-simplexml": "*",
"php": "^7.4.0|^8.0"
},
"time": "2026-01-02T10:38:05+00:00",
"default-branch": true,
"type": "library",
"installation-source": "dist",
"autoload": {
"files": [
"src/aliasing.php"
],
"psr-4": {
"Akeeba\\S3\\": "src"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"GPL-3.0-or-later"
],
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM_PLEASE@akeeba.com",
"homepage": "http://www.dionysopoulos.me",
"role": "Lead Developer"
}
],
"description": "A compact, dependency-less Amazon S3 API client implementing the most commonly used features",
"homepage": "https://github.com/akeeba/s3",
"keywords": [
"s3"
],
"support": {
"issues": "https://github.com/akeeba/s3/issues",
"source": "https://github.com/akeeba/s3/tree/development"
},
"install-path": "../akeeba/s3"
},
{
"name": "akeeba/stats_collector",
"version": "dev-main",
"version_normalized": "dev-main",
"source": {
"type": "git",
"url": "https://github.com/akeeba/stats_collector.git",
"reference": "a3dc39b61bfacbd2389094b09bc0307cbdb1f81a"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/akeeba/stats_collector/zipball/a3dc39b61bfacbd2389094b09bc0307cbdb1f81a",
"reference": "a3dc39b61bfacbd2389094b09bc0307cbdb1f81a",
"shasum": ""
},
"require": {
"php": "^7.2|^8.0"
},
"suggest": {
"ext-curl": "For sending the usage stats to the server",
"ext-openssl": "Fallback when random_bytes is not available"
},
"time": "2026-01-26T13:23:28+00:00",
"default-branch": true,
"type": "library",
"installation-source": "dist",
"autoload": {
"psr-4": {
"Akeeba\\UsageStats\\Collector\\": "src"
}
},
"archive": {
"exclude": [
".idea/**",
".gitignore",
"composer.lock"
]
},
"license": [
"GPL-3.0-or-later"
],
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM@akeeba.com"
}
],
"description": "Usage Statistic collector",
"support": {
"source": "https://github.com/akeeba/stats_collector/tree/main",
"issues": "https://github.com/akeeba/stats_collector/issues"
},
"install-path": "../akeeba/stats_collector"
},
{
"name": "akeeba/webpush",
"version": "dev-main",
"version_normalized": "dev-main",
"source": {
"type": "git",
"url": "git@github.com:akeeba/webpush.git",
"reference": "325e4dd445d4048a9872539fc273b31eb1ca457f"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/akeeba/webpush/zipball/325e4dd445d4048a9872539fc273b31eb1ca457f",
"reference": "325e4dd445d4048a9872539fc273b31eb1ca457f",
"shasum": ""
},
"require": {
"ext-json": "*",
"ext-openssl": "*",
"php": "^7.4|^8.0"
},
"suggest": {
"ext-gmp": "*"
},
"time": "2026-02-12T19:00:54+00:00",
"default-branch": true,
"type": "library",
"installation-source": "dist",
"autoload": {
"psr-4": {
"Akeeba\\WebPush\\": "src"
}
},
"license": [
"GPL-3.0-or-later"
],
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas@akeeba.com"
}
],
"description": "WebPush for Joomla components",
"homepage": "https://github.com/akeeba/webpush",
"keywords": [
"Joomla",
"Push API",
"WebPush",
"notifications",
"push",
"web"
],
"support": {
"source": "https://github.com/akeeba/webpush/tree/main",
"issues": "https://github.com/akeeba/webpush/issues"
},
"install-path": "../akeeba/webpush"
},
{
"name": "composer/ca-bundle",
"version": "dev-main",
"version_normalized": "dev-main",
"source": {
"type": "git",
"url": "https://github.com/composer/ca-bundle.git",
"reference": "108ec30b5e82fbeb89b68800212cb94c849f6aad"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/composer/ca-bundle/zipball/108ec30b5e82fbeb89b68800212cb94c849f6aad",
"reference": "108ec30b5e82fbeb89b68800212cb94c849f6aad",
"shasum": ""
},
"require": {
"ext-openssl": "*",
"ext-pcre": "*",
"php": "^7.2 || ^8.0"
},
"require-dev": {
"phpstan/phpstan": "^1.10",
"phpunit/phpunit": "^8 || ^9",
"psr/log": "^1.0 || ^2.0 || ^3.0",
"symfony/process": "^4.0 || ^5.0 || ^6.0 || ^7.0"
},
"time": "2026-05-29T09:13:02+00:00",
"default-branch": true,
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "1.x-dev"
}
},
"installation-source": "dist",
"autoload": {
"psr-4": {
"Composer\\CaBundle\\": "src"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"authors": [
{
"name": "Jordi Boggiano",
"email": "j.boggiano@seld.be",
"homepage": "http://seld.be"
}
],
"description": "Lets you find a path to the system CA bundle, and includes a fallback to the Mozilla CA bundle.",
"keywords": [
"cabundle",
"cacert",
"certificate",
"ssl",
"tls"
],
"support": {
"irc": "irc://irc.freenode.org/composer",
"issues": "https://github.com/composer/ca-bundle/issues",
"source": "https://github.com/composer/ca-bundle/tree/main"
},
"funding": [
{
"url": "https://packagist.com",
"type": "custom"
},
{
"url": "https://github.com/composer",
"type": "github"
}
],
"install-path": "./ca-bundle"
},
{
"name": "greenlion/php-sql-parser",
"version": "v4.7.0",
"version_normalized": "4.7.0.0",
"source": {
"type": "git",
"url": "https://github.com/greenlion/PHP-SQL-Parser.git",
"reference": "0cd49149efc5868db9c32d1a09558ea516892586"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/greenlion/PHP-SQL-Parser/zipball/0cd49149efc5868db9c32d1a09558ea516892586",
"reference": "0cd49149efc5868db9c32d1a09558ea516892586",
"shasum": ""
},
"require": {
"php": ">=5.3.2"
},
"require-dev": {
"analog/analog": "^1.0.6",
"phpunit/phpunit": "^9.5.13",
"squizlabs/php_codesniffer": "^2.8.1"
},
"time": "2024-12-02T12:14:07+00:00",
"type": "library",
"installation-source": "dist",
"autoload": {
"psr-0": {
"PHPSQLParser\\": "src/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Justin Swanhart",
"email": "greenlion@gmail.com",
"homepage": "http://code.google.com/u/greenlion@gmail.com/",
"role": "Owner"
},
{
"name": "André Rothe",
"email": "phosco@gmx.de",
"homepage": "https://www.phosco.info",
"role": "Committer"
}
],
"description": "A pure PHP SQL (non validating) parser w/ focus on MySQL dialect of SQL",
"homepage": "https://github.com/greenlion/PHP-SQL-Parser",
"keywords": [
"creator",
"mysql",
"parser",
"sql"
],
"support": {
"issues": "https://github.com/greenlion/PHP-SQL-Parser/issues",
"source": "https://github.com/greenlion/PHP-SQL-Parser"
},
"install-path": "../greenlion/php-sql-parser"
}
],
"dev": false,
"dev-package-names": []
}
PK \ . . vendor/composer/LICENSEnu [
Copyright (c) Nils Adermann, Jordi Boggiano
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is furnished
to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
PK \
* Jordi Boggiano
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Composer;
use Composer\Autoload\ClassLoader;
use Composer\Semver\VersionParser;
/**
* This class is copied in every Composer installed project and available to all
*
* See also https://getcomposer.org/doc/07-runtime.md#installed-versions
*
* To require its presence, you can require `composer-runtime-api ^2.0`
*
* @final
*/
class InstalledVersions
{
/**
* @var string|null if set (by reflection by Composer), this should be set to the path where this class is being copied to
* @internal
*/
private static $selfDir = null;
/**
* @var mixed[]|null
* @psalm-var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array}|array{}|null
*/
private static $installed;
/**
* @var bool
*/
private static $installedIsLocalDir;
/**
* @var bool|null
*/
private static $canGetVendors;
/**
* @var array[]
* @psalm-var array}>
*/
private static $installedByVendor = array();
/**
* Returns a list of all package names which are present, either by being installed, replaced or provided
*
* @return string[]
* @psalm-return list
*/
public static function getInstalledPackages()
{
$packages = array();
foreach (self::getInstalled() as $installed) {
$packages[] = array_keys($installed['versions']);
}
if (1 === \count($packages)) {
return $packages[0];
}
return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
}
/**
* Returns a list of all package names with a specific type e.g. 'library'
*
* @param string $type
* @return string[]
* @psalm-return list
*/
public static function getInstalledPackagesByType($type)
{
$packagesByType = array();
foreach (self::getInstalled() as $installed) {
foreach ($installed['versions'] as $name => $package) {
if (isset($package['type']) && $package['type'] === $type) {
$packagesByType[] = $name;
}
}
}
return $packagesByType;
}
/**
* Checks whether the given package is installed
*
* This also returns true if the package name is provided or replaced by another package
*
* @param string $packageName
* @param bool $includeDevRequirements
* @return bool
*/
public static function isInstalled($packageName, $includeDevRequirements = true)
{
foreach (self::getInstalled() as $installed) {
if (isset($installed['versions'][$packageName])) {
return $includeDevRequirements || !isset($installed['versions'][$packageName]['dev_requirement']) || $installed['versions'][$packageName]['dev_requirement'] === false;
}
}
return false;
}
/**
* Checks whether the given package satisfies a version constraint
*
* e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call:
*
* Composer\InstalledVersions::satisfies(new VersionParser, 'foo/bar', '^2.3')
*
* @param VersionParser $parser Install composer/semver to have access to this class and functionality
* @param string $packageName
* @param string|null $constraint A version constraint to check for, if you pass one you have to make sure composer/semver is required by your package
* @return bool
*/
public static function satisfies(VersionParser $parser, $packageName, $constraint)
{
$constraint = $parser->parseConstraints((string) $constraint);
$provided = $parser->parseConstraints(self::getVersionRanges($packageName));
return $provided->matches($constraint);
}
/**
* Returns a version constraint representing all the range(s) which are installed for a given package
*
* It is easier to use this via isInstalled() with the $constraint argument if you need to check
* whether a given version of a package is installed, and not just whether it exists
*
* @param string $packageName
* @return string Version constraint usable with composer/semver
*/
public static function getVersionRanges($packageName)
{
foreach (self::getInstalled() as $installed) {
if (!isset($installed['versions'][$packageName])) {
continue;
}
$ranges = array();
if (isset($installed['versions'][$packageName]['pretty_version'])) {
$ranges[] = $installed['versions'][$packageName]['pretty_version'];
}
if (array_key_exists('aliases', $installed['versions'][$packageName])) {
$ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
}
if (array_key_exists('replaced', $installed['versions'][$packageName])) {
$ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
}
if (array_key_exists('provided', $installed['versions'][$packageName])) {
$ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
}
return implode(' || ', $ranges);
}
throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
}
/**
* @param string $packageName
* @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
*/
public static function getVersion($packageName)
{
foreach (self::getInstalled() as $installed) {
if (!isset($installed['versions'][$packageName])) {
continue;
}
if (!isset($installed['versions'][$packageName]['version'])) {
return null;
}
return $installed['versions'][$packageName]['version'];
}
throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
}
/**
* @param string $packageName
* @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
*/
public static function getPrettyVersion($packageName)
{
foreach (self::getInstalled() as $installed) {
if (!isset($installed['versions'][$packageName])) {
continue;
}
if (!isset($installed['versions'][$packageName]['pretty_version'])) {
return null;
}
return $installed['versions'][$packageName]['pretty_version'];
}
throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
}
/**
* @param string $packageName
* @return string|null If the package is being replaced or provided but is not really installed, null will be returned as reference
*/
public static function getReference($packageName)
{
foreach (self::getInstalled() as $installed) {
if (!isset($installed['versions'][$packageName])) {
continue;
}
if (!isset($installed['versions'][$packageName]['reference'])) {
return null;
}
return $installed['versions'][$packageName]['reference'];
}
throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
}
/**
* @param string $packageName
* @return string|null If the package is being replaced or provided but is not really installed, null will be returned as install path. Packages of type metapackages also have a null install path.
*/
public static function getInstallPath($packageName)
{
foreach (self::getInstalled() as $installed) {
if (!isset($installed['versions'][$packageName])) {
continue;
}
return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null;
}
throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
}
/**
* @return array
* @psalm-return array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}
*/
public static function getRootPackage()
{
$installed = self::getInstalled();
return $installed[0]['root'];
}
/**
* Returns the raw installed.php data for custom implementations
*
* @deprecated Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect.
* @return array[]
* @psalm-return array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array}
*/
public static function getRawData()
{
@trigger_error('getRawData only returns the first dataset loaded, which may not be what you expect. Use getAllRawData() instead which returns all datasets for all autoloaders present in the process.', E_USER_DEPRECATED);
if (null === self::$installed) {
// only require the installed.php file if this file is loaded from its dumped location,
// and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
if (substr(__DIR__, -8, 1) !== 'C') {
self::$installed = include __DIR__ . '/installed.php';
} else {
self::$installed = array();
}
}
return self::$installed;
}
/**
* Returns the raw data of all installed.php which are currently loaded for custom implementations
*
* @return array[]
* @psalm-return list}>
*/
public static function getAllRawData()
{
return self::getInstalled();
}
/**
* Lets you reload the static array from another file
*
* This is only useful for complex integrations in which a project needs to use
* this class but then also needs to execute another project's autoloader in process,
* and wants to ensure both projects have access to their version of installed.php.
*
* A typical case would be PHPUnit, where it would need to make sure it reads all
* the data it needs from this class, then call reload() with
* `require $CWD/vendor/composer/installed.php` (or similar) as input to make sure
* the project in which it runs can then also use this class safely, without
* interference between PHPUnit's dependencies and the project's dependencies.
*
* @param array[] $data A vendor/composer/installed.php data set
* @return void
*
* @psalm-param array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $data
*/
public static function reload($data)
{
self::$installed = $data;
self::$installedByVendor = array();
// when using reload, we disable the duplicate protection to ensure that self::$installed data is
// always returned, but we cannot know whether it comes from the installed.php in __DIR__ or not,
// so we have to assume it does not, and that may result in duplicate data being returned when listing
// all installed packages for example
self::$installedIsLocalDir = false;
}
/**
* @return string
*/
private static function getSelfDir()
{
if (self::$selfDir === null) {
self::$selfDir = strtr(__DIR__, '\\', '/');
}
return self::$selfDir;
}
/**
* @return array[]
* @psalm-return list}>
*/
private static function getInstalled()
{
if (null === self::$canGetVendors) {
self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
}
$installed = array();
$copiedLocalDir = false;
if (self::$canGetVendors) {
$selfDir = self::getSelfDir();
foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
$vendorDir = strtr($vendorDir, '\\', '/');
if (isset(self::$installedByVendor[$vendorDir])) {
$installed[] = self::$installedByVendor[$vendorDir];
} elseif (is_file($vendorDir.'/composer/installed.php')) {
/** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $required */
$required = require $vendorDir.'/composer/installed.php';
self::$installedByVendor[$vendorDir] = $required;
$installed[] = $required;
if (self::$installed === null && $vendorDir.'/composer' === $selfDir) {
self::$installed = $required;
self::$installedIsLocalDir = true;
}
}
if (self::$installedIsLocalDir && $vendorDir.'/composer' === $selfDir) {
$copiedLocalDir = true;
}
}
}
if (null === self::$installed) {
// only require the installed.php file if this file is loaded from its dumped location,
// and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
if (substr(__DIR__, -8, 1) !== 'C') {
/** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $required */
$required = require __DIR__ . '/installed.php';
self::$installed = $required;
} else {
self::$installed = array();
}
}
if (self::$installed !== array() && !$copiedLocalDir) {
$installed[] = self::$installed;
}
return $installed;
}
}
PK \zՇ' ' ' vendor/composer/ca-bundle/composer.jsonnu [ {
"name": "composer/ca-bundle",
"description": "Lets you find a path to the system CA bundle, and includes a fallback to the Mozilla CA bundle.",
"type": "library",
"license": "MIT",
"keywords": [
"cabundle",
"cacert",
"certificate",
"ssl",
"tls"
],
"authors": [
{
"name": "Jordi Boggiano",
"email": "j.boggiano@seld.be",
"homepage": "http://seld.be"
}
],
"support": {
"irc": "irc://irc.freenode.org/composer",
"issues": "https://github.com/composer/ca-bundle/issues"
},
"require": {
"ext-openssl": "*",
"ext-pcre": "*",
"php": "^7.2 || ^8.0"
},
"require-dev": {
"phpunit/phpunit": "^8 || ^9",
"phpstan/phpstan": "^1.10",
"psr/log": "^1.0 || ^2.0 || ^3.0",
"symfony/process": "^4.0 || ^5.0 || ^6.0 || ^7.0"
},
"autoload": {
"psr-4": {
"Composer\\CaBundle\\": "src"
}
},
"autoload-dev": {
"psr-4": {
"Composer\\CaBundle\\": "tests"
}
},
"extra": {
"branch-alias": {
"dev-main": "1.x-dev"
}
},
"scripts": {
"test": "@php phpunit",
"phpstan": "@php phpstan analyse"
}
}
PK \*!^` ! vendor/composer/ca-bundle/LICENSEnu [ Copyright (C) 2016 Composer
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
PK \ ] ( vendor/composer/ca-bundle/res/cacert.pemnu [ ##
## Bundle of CA Root Certificates
##
## Certificate data from Mozilla as of: Thu May 14 03:12:02 2026 GMT
##
## Find updated versions here: https://curl.se/docs/caextract.html
##
## This is a bundle of X.509 certificates of public Certificate Authorities
## (CA). These were automatically extracted from Mozilla's root certificates
## file (certdata.txt). This file can be found in the mozilla source tree:
## https://raw.githubusercontent.com/mozilla-firefox/firefox/refs/heads/release/security/nss/lib/ckfw/builtins/certdata.txt
##
## It contains the certificates in PEM format and therefore
## can be directly used with curl / libcurl / php_curl, or with
## an Apache+mod_ssl webserver for SSL client authentication.
## Just configure this file as the SSLCACertificateFile.
##
## Conversion done with mk-ca-bundle.pl version 1.33.
## SHA256: 77130ef91213772844561fbd3aa31d413b25c2ac7f576fea3bc3bbff7ef93489
##
Entrust Root Certification Authority
====================================
-----BEGIN CERTIFICATE-----
MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMCVVMxFjAUBgNV
BAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0Lm5ldC9DUFMgaXMgaW5jb3Jw
b3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMWKGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsG
A1UEAxMkRW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0
MloXDTI2MTEyNzIwNTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMu
MTkwNwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSByZWZlcmVu
Y2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNVBAMTJEVudHJ1c3QgUm9v
dCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
ALaVtkNC+sZtKm9I35RMOVcF7sN5EUFoNu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYsz
A9u3g3s+IIRe7bJWKKf44LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOww
Cj0Yzfv9KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGIrb68
j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi94DkZfs0Nw4pgHBN
rziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOBsDCBrTAOBgNVHQ8BAf8EBAMCAQYw
DwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAigA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1
MzQyWjAfBgNVHSMEGDAWgBRokORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DH
hmak8fdLQ/uEvW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA
A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9tO1KzKtvn1ISM
Y/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6ZuaAGAT/3B+XxFNSRuzFVJ7yVTa
v52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTS
W3iDVuycNsMm4hH2Z0kdkquM++v/eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0
tHuu2guQOHXvgR1m0vdXcDazv/wor3ElhVsT/h5/WrQ8
-----END CERTIFICATE-----
COMODO ECC Certification Authority
==================================
-----BEGIN CERTIFICATE-----
MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTELMAkGA1UEBhMC
R0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UE
ChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBB
dXRob3JpdHkwHhcNMDgwMzA2MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0Ix
GzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR
Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRo
b3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSRFtSrYpn1PlILBs5BAH+X
4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0JcfRK9ChQtP6IHG4/bC8vCVlbpVsLM5ni
wz2J+Wos77LTBumjQjBAMB0GA1UdDgQWBBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8E
BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VG
FAkK+qDmfQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdvGDeA
U/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY=
-----END CERTIFICATE-----
ePKI Root Certification Authority
=================================
-----BEGIN CERTIFICATE-----
MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBeMQswCQYDVQQG
EwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0ZC4xKjAoBgNVBAsMIWVQS0kg
Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMx
MjdaMF4xCzAJBgNVBAYTAlRXMSMwIQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEq
MCgGA1UECwwhZVBLSSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0B
AQEFAAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAHSyZbCUNs
IZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAhijHyl3SJCRImHJ7K2RKi
lTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3XDZoTM1PRYfl61dd4s5oz9wCGzh1NlDiv
qOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX
12ruOzjjK9SXDrkb5wdJfzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0O
WQqraffAsgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uUWH1+
ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLSnT0IFaUQAS2zMnao
lQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pHdmX2Os+PYhcZewoozRrSgx4hxyy/
vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJipNiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXi
Zo1jDiVN1Rmy5nk3pyKdVDECAwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/Qkqi
MAwGA1UdEwQFMAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH
ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGBuvl2ICO1J2B0
1GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6YlPwZpVnPDimZI+ymBV3QGypzq
KOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkPJXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdV
xrsStZf0X4OFunHB2WyBEXYKCrC/gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEP
NXubrjlpC2JgQCA2j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+r
GNm65ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUBo2M3IUxE
xJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS/jQ6fbjpKdx2qcgw+BRx
gMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2zGp1iro2C6pSe3VkQw63d4k3jMdXH7Ojy
sP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTEW9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmOD
BCEIZ43ygknQW/2xzQ+DhNQ+IIX3Sj0rnP0qCglN6oH4EZw=
-----END CERTIFICATE-----
NetLock Arany (Class Gold) Főtanúsítvány
========================================
-----BEGIN CERTIFICATE-----
MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQGEwJIVTERMA8G
A1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3MDUGA1UECwwuVGFuw7pzw610
dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNlcnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBB
cmFueSAoQ2xhc3MgR29sZCkgRsWRdGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgx
MjA2MTUwODIxWjCBpzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxO
ZXRMb2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlmaWNhdGlv
biBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNzIEdvbGQpIEbFkXRhbsO6
c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxCRec75LbRTDofTjl5Bu
0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrTlF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw
/HpYzY6b7cNGbIRwXdrzAZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAk
H3B5r9s5VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRGILdw
fzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2BJtr+UBdADTHLpl1
neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAGAQH/AgEEMA4GA1UdDwEB/wQEAwIB
BjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2MU9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwW
qZw8UQCgwBEIBaeZ5m8BiFRhbvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTta
YtOUZcTh5m2C+C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC
bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2FuLjbvrW5Kfna
NwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2XjG4Kvte9nHfRCaexOYNkbQu
dZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E=
-----END CERTIFICATE-----
Microsec e-Szigno Root CA 2009
==============================
-----BEGIN CERTIFICATE-----
MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYDVQQGEwJIVTER
MA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jv
c2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o
dTAeFw0wOTA2MTYxMTMwMThaFw0yOTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UE
BwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUt
U3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTCCASIw
DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvPkd6mJviZpWNwrZuuyjNA
fW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tccbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG
0IMZfcChEhyVbUr02MelTTMuhTlAdX4UfIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKA
pxn1ntxVUwOXewdI/5n7N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm
1HxdrtbCxkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1+rUC
AwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTLD8bf
QkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAbBgNVHREE
FDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqGSIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0o
lZMEyL/azXm4Q5DwpL7v8u8hmLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfX
I/OMn74dseGkddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775
tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c2Pm2G2JwCz02
yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5tHMN1Rq41Bab2XD0h7lbwyYIi
LXpUq3DDfSJlgnCW
-----END CERTIFICATE-----
GlobalSign Root CA - R3
=======================
-----BEGIN CERTIFICATE-----
MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4GA1UECxMXR2xv
YmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkdsb2Jh
bFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxT
aWduIFJvb3QgQ0EgLSBSMzETMBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2ln
bjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWt
iHL8RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsTgHeMCOFJ
0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmmKPZpO/bLyCiR5Z2KYVc3
rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zdQQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjl
OCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZXriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2
xmmFghcCAwEAAaNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYE
FI/wS3+oLkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZURUm7
lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMpjjM5RcOO5LlXbKr8
EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK6fBdRoyV3XpYKBovHd7NADdBj+1E
bddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQXmcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18
YIvDQVETI53O9zJrlAGomecsMx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7r
kpeDMdmztcpHWD9f
-----END CERTIFICATE-----
Izenpe.com
==========
-----BEGIN CERTIFICATE-----
MIIF8TCCA9mgAwIBAgIQALC3WhZIX7/hy/WL1xnmfTANBgkqhkiG9w0BAQsFADA4MQswCQYDVQQG
EwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6ZW5wZS5jb20wHhcNMDcxMjEz
MTMwODI4WhcNMzcxMjEzMDgyNzI1WjA4MQswCQYDVQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMu
QS4xEzARBgNVBAMMCkl6ZW5wZS5jb20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDJ
03rKDx6sp4boFmVqscIbRTJxldn+EFvMr+eleQGPicPK8lVx93e+d5TzcqQsRNiekpsUOqHnJJAK
ClaOxdgmlOHZSOEtPtoKct2jmRXagaKH9HtuJneJWK3W6wyyQXpzbm3benhB6QiIEn6HLmYRY2xU
+zydcsC8Lv/Ct90NduM61/e0aL6i9eOBbsFGb12N4E3GVFWJGjMxCrFXuaOKmMPsOzTFlUFpfnXC
PCDFYbpRR6AgkJOhkEvzTnyFRVSa0QUmQbC1TR0zvsQDyCV8wXDbO/QJLVQnSKwv4cSsPsjLkkxT
OTcj7NMB+eAJRE1NZMDhDVqHIrytG6P+JrUV86f8hBnp7KGItERphIPzidF0BqnMC9bC3ieFUCbK
F7jJeodWLBoBHmy+E60QrLUk9TiRodZL2vG70t5HtfG8gfZZa88ZU+mNFctKy6lvROUbQc/hhqfK
0GqfvEyNBjNaooXlkDWgYlwWTvDjovoDGrQscbNYLN57C9saD+veIR8GdwYDsMnvmfzAuU8Lhij+
0rnq49qlw0dpEuDb8PYZi+17cNcC1u2HGCgsBCRMd+RIihrGO5rUD8r6ddIBQFqNeb+Lz0vPqhbB
leStTIo+F5HUsWLlguWABKQDfo2/2n+iD5dPDNMN+9fR5XJ+HMh3/1uaD7euBUbl8agW7EekFwID
AQABo4H2MIHzMIGwBgNVHREEgagwgaWBD2luZm9AaXplbnBlLmNvbaSBkTCBjjFHMEUGA1UECgw+
SVpFTlBFIFMuQS4gLSBDSUYgQTAxMzM3MjYwLVJNZXJjLlZpdG9yaWEtR2FzdGVpeiBUMTA1NSBG
NjIgUzgxQzBBBgNVBAkMOkF2ZGEgZGVsIE1lZGl0ZXJyYW5lbyBFdG9yYmlkZWEgMTQgLSAwMTAx
MCBWaXRvcmlhLUdhc3RlaXowDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0O
BBYEFB0cZQ6o8iV7tJHP5LGx5r1VdGwFMA0GCSqGSIb3DQEBCwUAA4ICAQB4pgwWSp9MiDrAyw6l
Fn2fuUhfGI8NYjb2zRlrrKvV9pF9rnHzP7MOeIWblaQnIUdCSnxIOvVFfLMMjlF4rJUT3sb9fbga
kEyrkgPH7UIBzg/YsfqikuFgba56awmqxinuaElnMIAkejEWOVt+8Rwu3WwJrfIxwYJOubv5vr8q
hT/AQKM6WfxZSzwoJNu0FXWuDYi6LnPAvViH5ULy617uHjAimcs30cQhbIHsvm0m5hzkQiCeR7Cs
g1lwLDXWrzY0tM07+DKo7+N4ifuNRSzanLh+QBxh5z6ikixL8s36mLYp//Pye6kfLqCTVyvehQP5
aTfLnnhqBbTFMXiJ7HqnheG5ezzevh55hM6fcA5ZwjUukCox2eRFekGkLhObNA5me0mrZJfQRsN5
nXJQY6aYWwa9SG3YOYNw6DXwBdGqvOPbyALqfP2C2sJbUjWumDqtujWTI6cfSN01RpiyEGjkpTHC
ClguGYEQyVB1/OpaFs4R1+7vUIgtYf8/QnMFlEPVjjxOAToZpR9GTnfQXeWBIiGH/pR9hNiTrdZo
Q0iy2+tzJOeRf1SktoA+naM8THLCV8Sg1Mw4J87VBp6iSNnpn86CcDaTmjvfliHjWbcM2pE38P1Z
WrOZyGlsQyYBNWNgVYkDOnXYukrZVP/u3oDYLdE41V4tC5h9Pmzb/CaIxw==
-----END CERTIFICATE-----
Go Daddy Root Certificate Authority - G2
========================================
-----BEGIN CERTIFICATE-----
MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMxEDAOBgNVBAgT
B0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoTEUdvRGFkZHkuY29tLCBJbmMu
MTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5
MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6
b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8G
A1UEAxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI
hvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKDE6bFIEMBO4Tx5oVJnyfq
9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD
+qK+ihVqf94Lw7YZFAXK6sOoBJQ7RnwyDfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutd
fMh8+7ArU6SSYmlRJQVhGkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMl
NAJWJwGRtDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEAAaNC
MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFDqahQcQZyi27/a9
BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmXWWcDYfF+OwYxdS2hII5PZYe096ac
vNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r
5N9ss4UXnT3ZJE95kTXWXwTrgIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYV
N8Gb5DKj7Tjo2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO
LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI4uJEvlz36hz1
-----END CERTIFICATE-----
Starfield Root Certificate Authority - G2
=========================================
-----BEGIN CERTIFICATE-----
MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMxEDAOBgNVBAgT
B0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoTHFN0YXJmaWVsZCBUZWNobm9s
b2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVsZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0
eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAw
DgYDVQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQg
VGVjaG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZpY2F0ZSBB
dXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL3twQP89o/8ArFv
W59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMgnLRJdzIpVv257IzdIvpy3Cdhl+72WoTs
bhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNk
N3mSwOxGXn/hbVNMYq/NHwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7Nf
ZTD4p7dNdloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0HZbU
JtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
AQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0GCSqGSIb3DQEBCwUAA4IBAQARWfol
TwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjUsHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx
4mcujJUDJi5DnUox9g61DLu34jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUw
F5okxBDgBPfg8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K
pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1mMpYjn0q7pBZ
c2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0
-----END CERTIFICATE-----
Starfield Services Root Certificate Authority - G2
==================================================
-----BEGIN CERTIFICATE-----
MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMxEDAOBgNVBAgT
B0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoTHFN0YXJmaWVsZCBUZWNobm9s
b2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVsZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRl
IEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNV
BAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxT
dGFyZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2VydmljZXMg
Um9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCC
AQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20pOsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2
h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm28xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4Pa
hHQUw2eeBGg6345AWh1KTs9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLP
LJGmpufehRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk6mFB
rMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAwDwYDVR0TAQH/BAUw
AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+qAdcwKziIorhtSpzyEZGDMA0GCSqG
SIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMIbw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPP
E95Dz+I0swSdHynVv/heyNXBve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTy
xQGjhdByPq1zqwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd
iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn0q23KXB56jza
YyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCNsSi6
-----END CERTIFICATE-----
Certum Trusted Network CA
=========================
-----BEGIN CERTIFICATE-----
MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBMMSIwIAYDVQQK
ExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlv
biBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBUcnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIy
MTIwNzM3WhcNMjkxMjMxMTIwNzM3WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBU
ZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5
MSIwIAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0BAQEFAAOC
AQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rHUV+rpDKmYYe2bg+G0jAC
l/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LMTXPb865Px1bVWqeWifrzq2jUI4ZZJ88J
J7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVUBBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4
fOQtf/WsX+sWn7Et0brMkUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0
cvW0QM8xAcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNVHRMB
Af8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNVHQ8BAf8EBAMCAQYw
DQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15ysHhE49wcrwn9I0j6vSrEuVUEtRCj
jSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfLI9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1
mS1FhIrlQgnXdAIv94nYmem8J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5aj
Zt3hrvJBW8qYVoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI
03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw=
-----END CERTIFICATE-----
TWCA Root Certification Authority
=================================
-----BEGIN CERTIFICATE-----
MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJ
VEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlmaWNh
dGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMzWhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQG
EwJUVzESMBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NB
IFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK
AoIBAQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFEAcK0HMMx
QhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HHK3XLfJ+utdGdIzdjp9xC
oi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeXRfwZVzsrb+RH9JlF/h3x+JejiB03HFyP
4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/zrX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1r
y+UPizgN7gr8/g+YnzAx3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIB
BjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkqhkiG
9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeCMErJk/9q56YAf4lC
mtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdlsXebQ79NqZp4VKIV66IIArB6nCWlW
QtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62Dlhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVY
T0bf+215WfKEIlKuD8z7fDvnaspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocny
Yh0igzyXxfkZYiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw==
-----END CERTIFICATE-----
Security Communication RootCA2
==============================
-----BEGIN CERTIFICATE-----
MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDElMCMGA1UEChMc
U0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMeU2VjdXJpdHkgQ29tbXVuaWNh
dGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoXDTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMC
SlAxJTAjBgNVBAoTHFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3Vy
aXR5IENvbW11bmljYXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
ANAVOVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGrzbl+dp++
+T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVMVAX3NuRFg3sUZdbcDE3R
3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQhNBqyjoGADdH5H5XTz+L62e4iKrFvlNV
spHEfbmwhRkGeC7bYRr6hfVKkaHnFtWOojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1K
EOtOghY6rCcMU/Gt1SSwawNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8
QIH4D5csOPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEB
CwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpFcoJxDjrSzG+ntKEj
u/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXcokgfGT+Ok+vx+hfuzU7jBBJV1uXk
3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6q
tnRGEmyR7jTV7JqR50S+kDFy1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29
mvVXIwAHIRc/SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03
-----END CERTIFICATE-----
Actalis Authentication Root CA
==============================
-----BEGIN CERTIFICATE-----
MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UEBhMCSVQxDjAM
BgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1ODUyMDk2NzEnMCUGA1UE
AwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDky
MjExMjIwMlowazELMAkGA1UEBhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlz
IFMucC5BLi8wMzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290
IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNvUTufClrJ
wkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX4ay8IMKx4INRimlNAJZa
by/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9KK3giq0itFZljoZUj5NDKd45RnijMCO6
zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1f
YVEiVRvjRuPjPdA1YprbrxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2
oxgkg4YQ51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2Fbe8l
EfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxeKF+w6D9Fz8+vm2/7
hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4Fv6MGn8i1zeQf1xcGDXqVdFUNaBr8
EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbnfpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5
jF66CyCU3nuDuP/jVo23Eek7jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLY
iDrIn3hm7YnzezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt
ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQALe3KHwGCmSUyI
WOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70jsNjLiNmsGe+b7bAEzlgqqI0
JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDzWochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKx
K3JCaKygvU5a2hi/a5iB0P2avl4VSM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+
Xlff1ANATIGk0k9jpwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC
4yyXX04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+OkfcvHlXHo
2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7RK4X9p2jIugErsWx0Hbhz
lefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btUZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXem
OR/qnuOf0GZvBeyqdn6/axag67XH/JJULysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9
vwGYT7JZVEc+NHt4bVaTLnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg==
-----END CERTIFICATE-----
Buypass Class 2 Root CA
=======================
-----BEGIN CERTIFICATE-----
MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEdMBsGA1UECgwU
QnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3MgQ2xhc3MgMiBSb290IENBMB4X
DTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1owTjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1
eXBhc3MgQVMtOTgzMTYzMzI3MSAwHgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIw
DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1
g1Lr6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPVL4O2fuPn
9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC911K2GScuVr1QGbNgGE41b
/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHxMlAQTn/0hpPshNOOvEu/XAFOBz3cFIqU
CqTqc/sLUegTBxj6DvEr0VQVfTzh97QZQmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeff
awrbD02TTqigzXsu8lkBarcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgI
zRFo1clrUs3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLiFRhn
Bkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRSP/TizPJhk9H9Z2vX
Uq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN9SG9dKpN6nIDSdvHXx1iY8f93ZHs
M+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxPAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYD
VR0OBBYEFMmAd+BikoL1RpzzuvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsF
AAOCAgEAU18h9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s
A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3tOluwlN5E40EI
osHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo+fsicdl9sz1Gv7SEr5AcD48S
aq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYd
DnkM/crqJIByw5c/8nerQyIKx+u2DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWD
LfJ6v9r9jv6ly0UsH8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0
oyLQI+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK75t98biGC
wWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h3PFaTWwyI0PurKju7koS
CTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPzY11aWOIv4x3kqdbQCtCev9eBCfHJxyYN
rJgWVqA=
-----END CERTIFICATE-----
Buypass Class 3 Root CA
=======================
-----BEGIN CERTIFICATE-----
MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEdMBsGA1UECgwU
QnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3MgQ2xhc3MgMyBSb290IENBMB4X
DTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFowTjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1
eXBhc3MgQVMtOTgzMTYzMzI3MSAwHgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIw
DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRH
sJ8YZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3EN3coTRiR
5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9tznDDgFHmV0ST9tD+leh
7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX0DJq1l1sDPGzbjniazEuOQAnFN44wOwZ
ZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH
2xc519woe2v1n/MuwU8XKhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV
/afmiSTYzIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvSO1UQ
RwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D34xFMFbG02SrZvPA
Xpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgPK9Dx2hzLabjKSWJtyNBjYt1gD1iq
j6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYD
VR0OBBYEFEe4zf/lb+74suwvTg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsF
AAOCAgEAACAjQTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV
cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXSIGrs/CIBKM+G
uIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2HJLw5QY33KbmkJs4j1xrG0aG
Q0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsaO5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8
ZORK15FTAaggiG6cX0S5y2CBNOxv033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2
KSb12tjE8nVhz36udmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz
6MkEkbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg413OEMXbug
UZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvDu79leNKGef9JOxqDDPDe
eOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq4/g7u9xN12TyUb7mqqta6THuBrxzvxNi
Cp/HuZc=
-----END CERTIFICATE-----
T-TeleSec GlobalRoot Class 3
============================
-----BEGIN CERTIFICATE-----
MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoM
IlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBU
cnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgx
MDAxMTAyOTU2WhcNMzMxMDAxMjM1OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lz
dGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBD
ZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0GCSqGSIb3
DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN8ELg63iIVl6bmlQdTQyK
9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/RLyTPWGrTs0NvvAgJ1gORH8EGoel15YU
NpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZF
iP0Zf3WHHx+xGwpzJFu5ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W
0eDrXltMEnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGjQjBA
MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1A/d2O2GCahKqGFPr
AyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOyWL6ukK2YJ5f+AbGwUgC4TeQbIXQb
fsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzT
ucpH9sry9uetuUg/vBa3wW306gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7h
P0HHRwA11fXT91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml
e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4pTpPDpFQUWw==
-----END CERTIFICATE-----
D-TRUST Root Class 3 CA 2 2009
==============================
-----BEGIN CERTIFICATE-----
MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQK
DAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTAe
Fw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NThaME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxE
LVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIw
DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOAD
ER03UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42tSHKXzlA
BF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9RySPocq60vFYJfxLLHLGv
KZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsMlFqVlNpQmvH/pStmMaTJOKDfHR+4CS7z
p+hnUquVH+BGPtikw8paxTGA6Eian5Rp/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUC
AwEAAaOCARowggEWMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ
4PGEMA4GA1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVjdG9y
eS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUyMENBJTIwMiUyMDIw
MDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRlcmV2b2NhdGlvbmxpc3QwQ6BBoD+G
PWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAw
OS5jcmwwDQYJKoZIhvcNAQELBQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm
2H6NMLVwMeniacfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0
o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4KzCUqNQT4YJEV
dT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8PIWmawomDeCTmGCufsYkl4ph
X5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3YJohw1+qRzT65ysCQblrGXnRl11z+o+I=
-----END CERTIFICATE-----
D-TRUST Root Class 3 CA 2 EV 2009
=================================
-----BEGIN CERTIFICATE-----
MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQK
DAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAw
OTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUwNDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQK
DAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAw
OTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfS
egpnljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM03TP1YtHh
zRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6ZqQTMFexgaDbtCHu39b+T
7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lRp75mpoo6Kr3HGrHhFPC+Oh25z1uxav60
sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure35
11H3a6UCAwEAAaOCASQwggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyv
cop9NteaHNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFwOi8v
ZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xhc3MlMjAzJTIwQ0El
MjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1ERT9jZXJ0aWZpY2F0ZXJldm9jYXRp
b25saXN0MEagRKBChkBodHRwOi8vd3d3LmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xh
c3NfM19jYV8yX2V2XzIwMDkuY3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+
PPoeUSbrh/Yp3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05
nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNFCSuGdXzfX2lX
ANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7naxpeG0ILD5EJt/rDiZE4OJudA
NCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqXKVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVv
w9y4AyHqnxbxLFS1
-----END CERTIFICATE-----
CA Disig Root R2
================
-----BEGIN CERTIFICATE-----
MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNVBAYTAlNLMRMw
EQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMuMRkwFwYDVQQDExBDQSBEaXNp
ZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQyMDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sx
EzARBgNVBAcTCkJyYXRpc2xhdmExEzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERp
c2lnIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbC
w3OeNcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNHPWSb6Wia
xswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3Ix2ymrdMxp7zo5eFm1tL7
A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbeQTg06ov80egEFGEtQX6sx3dOy1FU+16S
GBsEWmjGycT6txOgmLcRK7fWV8x8nhfRyyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqV
g8NTEQxzHQuyRpDRQjrOQG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa
5Beny912H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJQfYE
koopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUDi/ZnWejBBhG93c+A
Ak9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORsnLMOPReisjQS1n6yqEm70XooQL6i
Fh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNV
HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5u
Qu0wDQYJKoZIhvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM
tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqfGopTpti72TVV
sRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkblvdhuDvEK7Z4bLQjb/D907Je
dR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka+elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W8
1k/BfDxujRNt+3vrMNDcTa/F1balTFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjx
mHHEt38OFdAlab0inSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01
utI3gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18DrG5gPcFw0
sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3OszMOl6W8KjptlwlCFtaOg
UxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8xL4ysEr3vQCj8KWefshNPZiTEUxnpHikV
7+ZtsH8tZ/3zbBt1RqPlShfppNcL
-----END CERTIFICATE-----
ACCVRAIZ1
=========
-----BEGIN CERTIFICATE-----
MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UEAwwJQUNDVlJB
SVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQswCQYDVQQGEwJFUzAeFw0xMTA1
MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQBgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwH
UEtJQUNDVjENMAsGA1UECgwEQUNDVjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4IC
DwAwggIKAoICAQCbqau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gM
jmoYHtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWoG2ioPej0
RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpAlHPrzg5XPAOBOp0KoVdD
aaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhrIA8wKFSVf+DuzgpmndFALW4ir50awQUZ
0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDG
WuzndN9wrqODJerWx5eHk6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs7
8yM2x/474KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMOm3WR
5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpacXpkatcnYGMN285J
9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPluUsXQA+xtrn13k/c4LOsOxFwYIRK
Q26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYIKwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRw
Oi8vd3d3LmFjY3YuZXMvZmlsZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEu
Y3J0MB8GCCsGAQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2
VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeTVfZW6oHlNsyM
Hj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIGCCsGAQUFBwICMIIBFB6CARAA
QQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUAcgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBh
AO0AegAgAGQAZQAgAGwAYQAgAEEAQwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUA
YwBuAG8AbABvAGcA7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBj
AHQAcgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAAQwBQAFMA
IABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUAczAwBggrBgEFBQcCARYk
aHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2MuaHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0
dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRtaW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2
MV9kZXIuY3JsMA4GA1UdDwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZI
hvcNAQEFBQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdpD70E
R9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gUJyCpZET/LtZ1qmxN
YEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+mAM/EKXMRNt6GGT6d7hmKG9Ww7Y49
nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepDvV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJ
TS+xJlsndQAJxGJ3KQhfnlmstn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3
sCPdK6jT2iWH7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h
I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szAh1xA2syVP1Xg
Nce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xFd3+YJ5oyXSrjhO7FmGYvliAd
3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2HpPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3p
EfbRD0tVNEYqi4Y7
-----END CERTIFICATE-----
TWCA Global Root CA
===================
-----BEGIN CERTIFICATE-----
MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcxEjAQBgNVBAoT
CVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMTVFdDQSBHbG9iYWwgUm9vdCBD
QTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQK
EwlUQUlXQU4tQ0ExEDAOBgNVBAsTB1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3Qg
Q0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2C
nJfF10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz0ALfUPZV
r2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfChMBwqoJimFb3u/Rk28OKR
Q4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbHzIh1HrtsBv+baz4X7GGqcXzGHaL3SekV
tTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1W
KKD+u4ZqyPpcC1jcxkt2yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99
sy2sbZCilaLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYPoA/p
yJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQABDzfuBSO6N+pjWxn
kjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcEqYSjMq+u7msXi7Kx/mzhkIyIqJdI
zshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMC
AQYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6g
cFGn90xHNcgL1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn
LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WFH6vPNOw/KP4M
8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNoRI2T9GRwoD2dKAXDOXC4Ynsg
/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlg
lPx4mI88k1HtQJAH32RjJMtOcQWh15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryP
A9gK8kxkRr05YuWW6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3m
i4TWnsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5jwa19hAM8
EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWzaGHQRiapIVJpLesux+t3
zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmyKwbQBM0=
-----END CERTIFICATE-----
T-TeleSec GlobalRoot Class 2
============================
-----BEGIN CERTIFICATE-----
MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoM
IlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBU
cnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgx
MDAxMTA0MDE0WhcNMzMxMDAxMjM1OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lz
dGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBD
ZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0GCSqGSIb3
DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUdAqSzm1nzHoqvNK38DcLZ
SBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiCFoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/F
vudocP05l03Sx5iRUKrERLMjfTlH6VJi1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx970
2cu+fjOlbpSD8DT6IavqjnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGV
WOHAD3bZwI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGjQjBA
MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/WSA2AHmgoCJrjNXy
YdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhyNsZt+U2e+iKo4YFWz827n+qrkRk4
r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPACuvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNf
vNoBYimipidx5joifsFvHZVwIEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR
3p1m0IvVVGb6g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN
9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlPBSeOE6Fuwg==
-----END CERTIFICATE-----
Atos TrustedRoot 2011
=====================
-----BEGIN CERTIFICATE-----
MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UEAwwVQXRvcyBU
cnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0xMTA3MDcxNDU4
MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMMFUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsG
A1UECgwEQXRvczELMAkGA1UEBhMCREUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCV
hTuXbyo7LjvPpvMpNb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr
54rMVD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+SZFhyBH+
DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ4J7sVaE3IqKHBAUsR320
HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0Lcp2AMBYHlT8oDv3FdU9T1nSatCQujgKR
z3bFmx5VdJx4IbHwLfELn8LVlhgf8FQieowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7R
l+lwrrw7GWzbITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZ
bNshMBgGA1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEB
CwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8jvZfza1zv7v1Apt+h
k6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kPDpFrdRbhIfzYJsdHt6bPWHJxfrrh
TZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pcmaHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a9
61qn8FYiqTxlVMYVqL2Gns2Dlmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G
3mB/ufNPRJLvKrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed
-----END CERTIFICATE-----
QuoVadis Root CA 1 G3
=====================
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQELBQAwSDELMAkG
A1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAcBgNVBAMTFVF1b1ZhZGlzIFJv
b3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJN
MRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEg
RzMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakE
PBtVwedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWerNrwU8lm
PNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF34168Xfuw6cwI2H44g4hWf6
Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh4Pw5qlPafX7PGglTvF0FBM+hSo+LdoIN
ofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXpUhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/l
g6AnhF4EwfWQvTA9xO+oabw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV
7qJZjqlc3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/GKubX
9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSthfbZxbGL0eUQMk1f
iyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KOTk0k+17kBL5yG6YnLUlamXrXXAkg
t3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOtzCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZI
hvcNAQELBQADggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC
MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2cDMT/uFPpiN3
GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUNqXsCHKnQO18LwIE6PWThv6ct
Tr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP
+V04ikkwj+3x6xn0dxoxGE1nVGwvb2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh
3jRJjehZrJ3ydlo28hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fa
wx/kNSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNjZgKAvQU6
O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhpq1467HxpvMc7hU6eFbm0
FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFtnh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOV
hMJKzRwuJIczYOXD
-----END CERTIFICATE-----
QuoVadis Root CA 2 G3
=====================
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQELBQAwSDELMAkG
A1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAcBgNVBAMTFVF1b1ZhZGlzIFJv
b3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJN
MRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIg
RzMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFh
ZiFfqq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMWn4rjyduY
NM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ymc5GQYaYDFCDy54ejiK2t
oIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+O7q414AB+6XrW7PFXmAqMaCvN+ggOp+o
MiwMzAkd056OXbxMmO7FGmh77FOm6RQ1o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+l
V0POKa2Mq1W/xPtbAd0jIaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZo
L1NesNKqIcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz8eQQ
sSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43ehvNURG3YBZwjgQQvD
6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l7ZizlWNof/k19N+IxWA1ksB8aRxh
lRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALGcC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZI
hvcNAQELBQADggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66
AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RCroijQ1h5fq7K
pVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0GaW/ZZGYjeVYg3UQt4XAoeo0L9
x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4nlv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgz
dWqTHBLmYF5vHX/JHyPLhGGfHoJE+V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6X
U/IyAgkwo1jwDQHVcsaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+Nw
mNtddbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNgKCLjsZWD
zYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeMHVOyToV7BjjHLPj4sHKN
JeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4WSr2Rz0ZiC3oheGe7IUIarFsNMkd7Egr
O3jtZsSOeWmD3n+M
-----END CERTIFICATE-----
QuoVadis Root CA 3 G3
=====================
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQELBQAwSDELMAkG
A1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAcBgNVBAMTFVF1b1ZhZGlzIFJv
b3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJN
MRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMg
RzMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286
IxSR/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNuFoM7pmRL
Mon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXRU7Ox7sWTaYI+FrUoRqHe
6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+cra1AdHkrAj80//ogaX3T7mH1urPnMNA3
I4ZyYUUpSFlob3emLoG+B01vr87ERRORFHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3U
VDmrJqMz6nWB2i3ND0/kA9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f7
5li59wzweyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634RylsSqi
Md5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBpVzgeAVuNVejH38DM
dyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0QA4XN8f+MFrXBsj6IbGB/kE+V9/Yt
rQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZI
hvcNAQELBQADggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px
KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnIFUBhynLWcKzS
t/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5WvvoxXqA/4Ti2Tk08HS6IT7SdEQ
TXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFgu/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9Du
DcpmvJRPpq3t/O5jrFc/ZSXPsoaP0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGib
Ih6BJpsQBJFxwAYf3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmD
hPbl8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+DhcI00iX
0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HNPlopNLk9hM6xZdRZkZFW
dSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/ywaZWWDYWGWVjUTR939+J399roD1B0y2
PpxxVJkES/1Y+Zj0
-----END CERTIFICATE-----
DigiCert Assured ID Root G2
===========================
-----BEGIN CERTIFICATE-----
MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBlMQswCQYDVQQG
EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQw
IgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgw
MTE1MTIwMDAwWjBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQL
ExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIw
ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSAn61UQbVH
35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4HteccbiJVMWWXvdMX0h5i89vq
bFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9HpEgjAALAcKxHad3A2m67OeYfcgnDmCXRw
VWmvo2ifv922ebPynXApVfSr/5Vh88lAbx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OP
YLfykqGxvYmJHzDNw6YuYjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+Rn
lTGNAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBTO
w0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPIQW5pJ6d1Ee88hjZv
0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I0jJmwYrA8y8678Dj1JGG0VDjA9tz
d29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4GnilmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAW
hsI6yLETcDbYz+70CjTVW0z9B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0M
jomZmWzwPDCvON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo
IhNzbM8m9Yop5w==
-----END CERTIFICATE-----
DigiCert Assured ID Root G3
===========================
-----BEGIN CERTIFICATE-----
MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQswCQYDVQQGEwJV
UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYD
VQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1
MTIwMDAwWjBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQ
BgcqhkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJfZn4f5dwb
RXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17QRSAPWXYQ1qAk8C3eNvJs
KTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgF
UaFNN6KDec6NHSrkhDAKBggqhkjOPQQDAwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5Fy
YZ5eEJJZVrmDxxDnOOlYJjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy
1vUhZscv6pZjamVFkpUBtA==
-----END CERTIFICATE-----
DigiCert Global Root G2
=======================
-----BEGIN CERTIFICATE-----
MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBhMQswCQYDVQQG
EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSAw
HgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUx
MjAwMDBaMGExCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3
dy5kaWdpY2VydC5jb20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkq
hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI2/Ou8jqJ
kTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx1x7e/dfgy5SDN67sH0NO
3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQq2EGnI/yuum06ZIya7XzV+hdG82MHauV
BJVJ8zUtluNJbd134/tJS7SsVQepj5WztCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyM
UNGPHgm+F6HmIcr9g+UQvIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQAB
o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV5uNu
5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY1Yl9PMWLSn/pvtsr
F9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4NeF22d+mQrvHRAiGfzZ0JFrabA0U
WTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NGFdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBH
QRFXGU7Aj64GxJUTFy8bJZ918rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/
iyK5S9kJRaTepLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl
MrY=
-----END CERTIFICATE-----
DigiCert Global Root G3
=======================
-----BEGIN CERTIFICATE-----
MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQswCQYDVQQGEwJV
UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSAwHgYD
VQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAw
MDBaMGExCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5k
aWdpY2VydC5jb20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0C
AQYFK4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FGfp4tn+6O
YwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPOZ9wj/wMco+I+o0IwQDAP
BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNp
Yim8S8YwCgYIKoZIzj0EAwMDaAAwZQIxAK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y
3maTD/HMsQmP3Wyr+mt/oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34
VOKa5Vt8sycX
-----END CERTIFICATE-----
DigiCert Trusted Root G4
========================
-----BEGIN CERTIFICATE-----
MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBiMQswCQYDVQQG
EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSEw
HwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1
MTIwMDAwWjBiMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0G
CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3yithZwuEp
pz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1Ifxp4VpX6+n6lXFllVcq9o
k3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDVySAdYyktzuxeTsiT+CFhmzTrBcZe7Fsa
vOvJz82sNEBfsXpm7nfISKhmV1efVFiODCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGY
QJB5w3jHtrHEtWoYOAMQjdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6
MUSaM0C/CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCiEhtm
mnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADMfRyVw4/3IbKyEbe7
f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QYuKZ3AeEPlAwhHbJUKSWJbOUOUlFH
dL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXKchYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8
oR7FwI+isX4KJpn15GkvmB0t9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud
DwEB/wQEAwIBhjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD
ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2SV1EY+CtnJYY
ZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd+SeuMIW59mdNOj6PWTkiU0Tr
yF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWcfFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy
7zBZLq7gcfJW5GqXb5JQbZaNaHqasjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iah
ixTXTBmyUEFxPT9NcCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN
5r5N0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie4u1Ki7wb
/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mIr/OSmbaz5mEP0oUA51Aa
5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tK
G48BtieVU+i2iW1bvGjUI+iLUaJW+fCmgKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP
82Z+
-----END CERTIFICATE-----
COMODO RSA Certification Authority
==================================
-----BEGIN CERTIFICATE-----
MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCBhTELMAkGA1UE
BhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgG
A1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlv
biBBdXRob3JpdHkwHhcNMTAwMTE5MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMC
R0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UE
ChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBB
dXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR6FSS0gpWsawNJN3Fz0Rn
dJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8Xpz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZ
FGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+
5eNu/Nio5JIk2kNrYrhV/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pG
x8cgoLEfZd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z+pUX
2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7wqP/0uK3pN/u6uPQL
OvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZahSL0896+1DSJMwBGB7FY79tOi4lu3
sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVICu9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+C
GCe01a60y1Dma/RMhnEw6abfFobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5
WdYgGq/yapiqcrxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E
FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8w
DQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvlwFTPoCWOAvn9sKIN9SCYPBMt
rFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+
nq6PK7o9mfjYcwlYRm6mnPTXJ9OV2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSg
tZx8jb8uk2IntznaFxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwW
sRqZCuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiKboHGhfKp
pC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmckejkk9u+UJueBPSZI9FoJA
zMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yLS0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHq
ZJx64SIDqZxubw5lT2yHh17zbqD5daWbQOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk52
7RH89elWsn2/x20Kk4yl0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7I
LaZRfyHBNVOFBkpdn627G190
-----END CERTIFICATE-----
USERTrust RSA Certification Authority
=====================================
-----BEGIN CERTIFICATE-----
MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCBiDELMAkGA1UE
BhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQK
ExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNh
dGlvbiBBdXRob3JpdHkwHhcNMTAwMjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UE
BhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQK
ExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNh
dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCAEmUXNg7D2wiz
0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2j
Y0K2dvKpOyuR+OJv0OwWIJAJPuLodMkYtJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFn
RghRy4YUVD+8M/5+bJz/Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O
+T23LLb2VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT79uq
/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6c0Plfg6lZrEpfDKE
Y1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmTYo61Zs8liM2EuLE/pDkP2QKe6xJM
lXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97lc6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8
yexDJtC/QV9AqURE9JnnV4eeUB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+
eLf8ZxXhyVeEHg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd
BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF
MAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPFUp/L+M+ZBn8b2kMVn54CVVeW
FPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KOVWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ
7l8wXEskEVX/JJpuXior7gtNn3/3ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQ
Eg9zKC7F4iRO/Fjs8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM
8WcRiQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYzeSf7dNXGi
FSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZXHlKYC6SQK5MNyosycdi
yA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9c
J2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRBVXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGw
sAvgnEzDHNb842m1R0aBL6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gx
Q+6IHdfGjjxDah2nGN59PRbxYvnKkKj9
-----END CERTIFICATE-----
USERTrust ECC Certification Authority
=====================================
-----BEGIN CERTIFICATE-----
MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDELMAkGA1UEBhMC
VVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU
aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlv
biBBdXRob3JpdHkwHhcNMTAwMjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMC
VVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU
aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlv
biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqfloI+d61SRvU8Za2EurxtW2
0eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinngo4N+LZfQYcTxmdwlkWOrfzCjtHDix6Ez
nPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0GA1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNV
HQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBB
HU6+4WMBzzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbWRNZu
9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg=
-----END CERTIFICATE-----
GlobalSign ECC Root CA - R5
===========================
-----BEGIN CERTIFICATE-----
MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEkMCIGA1UECxMb
R2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQD
EwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoXDTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMb
R2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQD
EwpHbG9iYWxTaWduMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6
SFkc8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8kehOvRnkmS
h5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAd
BgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYIKoZIzj0EAwMDaAAwZQIxAOVpEslu28Yx
uglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7
yFz9SO8NdCKoCOJuxUnOxwy8p2Fp8fc74SrL+SvzZpA3
-----END CERTIFICATE-----
IdenTrust Commercial Root CA 1
==============================
-----BEGIN CERTIFICATE-----
MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBKMQswCQYDVQQG
EwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBS
b290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQwMTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzES
MBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENB
IDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ld
hNlT3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU+ehcCuz/
mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gpS0l4PJNgiCL8mdo2yMKi
1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1bVoE/c40yiTcdCMbXTMTEl3EASX2MN0C
XZ/g1Ue9tOsbobtJSdifWwLziuQkkORiT0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl
3ZBWzvurpWCdxJ35UrCLvYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzy
NeVJSQjKVsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZKdHzV
WYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHTc+XvvqDtMwt0viAg
xGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hvl7yTmvmcEpB4eoCHFddydJxVdHix
uuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5NiGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMC
AQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZI
hvcNAQELBQADggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH
6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwtLRvM7Kqas6pg
ghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93nAbowacYXVKV7cndJZ5t+qnt
ozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3+wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmV
YjzlVYA211QC//G5Xc7UI2/YRYRKW2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUX
feu+h1sXIFRRk0pTAwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/ro
kTLql1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG4iZZRHUe
2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZmUlO+KWA2yUPHGNiiskz
Z2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7R
cGzM7vRX+Bi6hG6H
-----END CERTIFICATE-----
IdenTrust Public Sector Root CA 1
=================================
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBNMQswCQYDVQQG
EwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3Rv
ciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcNMzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJV
UzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBS
b290IENBIDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTy
P4o7ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGyRBb06tD6
Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlSbdsHyo+1W/CD80/HLaXI
rcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF/YTLNiCBWS2ab21ISGHKTN9T0a9SvESf
qy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoS
mJxZZoY+rfGwyj4GD3vwEUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFn
ol57plzy9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9VGxyh
LrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ2fjXctscvG29ZV/v
iDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsVWaFHVCkugyhfHMKiq3IXAAaOReyL
4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gDW/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8B
Af8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMw
DQYJKoZIhvcNAQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj
t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHVDRDtfULAj+7A
mgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9TaDKQGXSc3z1i9kKlT/YPyNt
GtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8GlwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFt
m6/n6J91eEyrRjuazr8FGF1NFTwWmhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMx
NRF4eKLg6TCMf4DfWN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4
Mhn5+bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJtshquDDI
ajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhAGaQdp/lLQzfcaFpPz+vC
ZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ
3Wl9af0AVqW3rLatt8o+Ae+c
-----END CERTIFICATE-----
CFCA EV ROOT
============
-----BEGIN CERTIFICATE-----
MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJDTjEwMC4GA1UE
CgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNB
IEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkxMjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEw
MC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQD
DAxDRkNBIEVWIFJPT1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnV
BU03sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpLTIpTUnrD
7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5/ZOkVIBMUtRSqy5J35DN
uF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp7hZZLDRJGqgG16iI0gNyejLi6mhNbiyW
ZXvKWfry4t3uMCz7zEasxGPrb382KzRzEpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7
xzbh72fROdOXW3NiGUgthxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9f
py25IGvPa931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqotaK8K
gWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNgTnYGmE69g60dWIol
hdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfVPKPtl8MeNPo4+QgO48BdK4PRVmrJ
tqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hvcWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAf
BgNVHSMEGDAWgBTj/i39KNALtbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB
/wQEAwIBBjAdBgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB
ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObTej/tUxPQ4i9q
ecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdLjOztUmCypAbqTuv0axn96/Ua
4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBSESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sG
E5uPhnEFtC+NiWYzKXZUmhH4J/qyP5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfX
BDrDMlI1Dlb4pd19xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjn
aH9dCi77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN5mydLIhy
PDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe/v5WOaHIz16eGWRGENoX
kbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+ZAAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3C
ekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su
-----END CERTIFICATE-----
OISTE WISeKey Global Root GB CA
===============================
-----BEGIN CERTIFICATE-----
MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBtMQswCQYDVQQG
EwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91bmRhdGlvbiBFbmRvcnNl
ZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAw
MzJaFw0zOTEyMDExNTEwMzFaMG0xCzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYD
VQQLExlPSVNURSBGb3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEds
b2JhbCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3HEokKtaX
scriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGxWuR51jIjK+FTzJlFXHtP
rby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk
9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNku7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4o
Qnc/nSMbsrY9gBQHTC5P99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvg
GUpuuy9rM2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB
/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUBBAMCAQAwDQYJKoZI
hvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrghcViXfa43FK8+5/ea4n32cZiZBKpD
dHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0
VQreUGdNZtGn//3ZwLWoo4rOZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEui
HZeeevJuQHHfaPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic
Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM=
-----END CERTIFICATE-----
SZAFIR ROOT CA2
===============
-----BEGIN CERTIFICATE-----
MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQELBQAwUTELMAkG
A1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6ZW5pb3dhIFMuQS4xGDAWBgNV
BAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkwNzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJ
BgNVBAYTAlBMMSgwJgYDVQQKDB9LcmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYD
VQQDDA9TWkFGSVIgUk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5Q
qEvNQLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT3PSQ1hNK
DJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw3gAeqDRHu5rr/gsUvTaE
2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr63fE9biCloBK0TXC5ztdyO4mTp4CEHCdJ
ckm1/zuVnsHMyAHs6A6KCpbns6aH5db5BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwi
ieDhZNRnvDF5YTy7ykHNXGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0P
AQH/BAQDAgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsFAAOC
AQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw8PRBEew/R40/cof5
O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOGnXkZ7/e7DDWQw4rtTw/1zBLZpD67
oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCPoky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul
4+vJhaAlIDf7js4MNIThPIGyd05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6
+/NNIxuZMzSgLvWpCz/UXeHPhJ/iGcJfitYgHuNztw==
-----END CERTIFICATE-----
Certum Trusted Network CA 2
===========================
-----BEGIN CERTIFICATE-----
MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCBgDELMAkGA1UE
BhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMuQS4xJzAlBgNVBAsTHkNlcnR1
bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIGA1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29y
ayBDQSAyMCIYDzIwMTExMDA2MDgzOTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQ
TDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENl
cnRpZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENB
IDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWADGSdhhuWZGc/IjoedQF9
7/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+o
CgCXhVqqndwpyeI1B+twTUrWwbNWuKFBOJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40b
Rr5HMNUuctHFY9rnY3lEfktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2p
uTRZCr+ESv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1mo130
GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02isx7QBlrd9pPPV3WZ
9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOWOZV7bIBaTxNyxtd9KXpEulKkKtVB
Rgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgezTv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pye
hizKV/Ma5ciSixqClnrDvFASadgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vM
BhBgu4M1t15n3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZI
hvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQF/xlhMcQSZDe28cmk4gmb3DW
Al45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTfCVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuA
L55MYIR4PSFk1vtBHxgP58l1cb29XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMo
clm2q8KMZiYcdywmdjWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tM
pkT/WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jbAoJnwTnb
w3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksqP/ujmv5zMnHCnsZy4Ypo
J/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Kob7a6bINDd82Kkhehnlt4Fj1F4jNy3eFm
ypnTycUm/Q1oBEauttmbjL4ZvrHG8hnjXALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLX
is7VmFxWlgPF7ncGNf/P5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7
zAYspsbiDrW5viSP
-----END CERTIFICATE-----
Hellenic Academic and Research Institutions RootCA 2015
=======================================================
-----BEGIN CERTIFICATE-----
MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1IxDzANBgNVBAcT
BkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0
aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNl
YXJjaCBJbnN0aXR1dGlvbnMgUm9vdENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAx
MTIxWjCBpjELMAkGA1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMg
QWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNV
BAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9vdENBIDIw
MTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDC+Kk/G4n8PDwEXT2QNrCROnk8Zlrv
bTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+eh
iGsxr/CL0BgzuNtFajT0AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+
6PAQZe104S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06CojXd
FPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV9Cz82XBST3i4vTwr
i5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrDgfgXy5I2XdGj2HUb4Ysn6npIQf1F
GQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2
fu/Z8VFRfS0myGlZYeCsargqNhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9mu
iNX6hME6wGkoLfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc
Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVdctA4GGqd83EkVAswDQYJKoZI
hvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0IXtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+
D1hYc2Ryx+hFjtyp8iY/xnmMsVMIM4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrM
d/K4kPFox/la/vot9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+y
d+2VZ5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/eaj8GsGsVn
82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnhX9izjFk0WaSrT2y7Hxjb
davYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQl033DlZdwJVqwjbDG2jJ9SrcR5q+ss7F
Jej6A7na+RZukYT1HCjI/CbM1xyQVqdfbzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVt
J94Cj8rDtSvK6evIIVM4pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGa
JI7ZjnHKe7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0vm9q
p/UsQu0yrbYhnr68
-----END CERTIFICATE-----
Hellenic Academic and Research Institutions ECC RootCA 2015
===========================================================
-----BEGIN CERTIFICATE-----
MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzANBgNVBAcTBkF0
aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9u
cyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJj
aCBJbnN0aXR1dGlvbnMgRUNDIFJvb3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEw
MzcxMlowgaoxCzAJBgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmlj
IEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5MUQwQgYD
VQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIEVDQyBSb290
Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKgQehLgoRc4vgxEZmGZE4JJS+dQS8KrjVP
dJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJajq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoK
Vlp8aQuqgAkkbH7BRqNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0O
BBYEFLQiC4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaeplSTA
GiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7SofTUwJCA3sS61kFyjn
dc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR
-----END CERTIFICATE-----
ISRG Root X1
============
-----BEGIN CERTIFICATE-----
MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAwTzELMAkGA1UE
BhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2VhcmNoIEdyb3VwMRUwEwYDVQQD
EwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQG
EwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMT
DElTUkcgUm9vdCBYMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54r
Vygch77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+0TM8ukj1
3Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6UA5/TR5d8mUgjU+g4rk8K
b4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sWT8KOEUt+zwvo/7V3LvSye0rgTBIlDHCN
Aymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyHB5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ
4Q7e2RCOFvu396j3x+UCB5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf
1b0SHzUvKBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWnOlFu
hjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTnjh8BCNAw1FtxNrQH
usEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbwqHyGO0aoSCqI3Haadr8faqU9GY/r
OPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CIrU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4G
A1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY
9umbbjANBgkqhkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ3BebYhtF8GaV
0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KKNFtY2PwByVS5uCbMiogziUwt
hDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJw
TdwJx4nLCgdNbOhdjsnvzqvHu7UrTkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nx
e5AW0wdeRlN8NwdCjNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZA
JzVcoyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq4RgqsahD
YVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPAmRGunUHBcnWEvgJBQl9n
JEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57demyPxgcYxn/eR44/KJ4EBs+lVDR3veyJ
m+kXQ99b21/+jh5Xos1AnX5iItreGCc=
-----END CERTIFICATE-----
AC RAIZ FNMT-RCM
================
-----BEGIN CERTIFICATE-----
MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsxCzAJBgNVBAYT
AkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBGTk1ULVJDTTAeFw0wODEw
MjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJD
TTEZMBcGA1UECwwQQUMgUkFJWiBGTk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC
ggIBALpxgHpMhm5/yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcf
qQgfBBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAzWHFctPVr
btQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxFtBDXaEAUwED653cXeuYL
j2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z374jNUUeAlz+taibmSXaXvMiwzn15Cou
08YfxGyqxRxqAQVKL9LFwag0Jl1mpdICIfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mw
WsXmo8RZZUc1g16p6DULmbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnT
tOmlcYF7wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peSMKGJ
47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2ZSysV4999AeU14EC
ll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMetUqIJ5G+GR4of6ygnXYMgrwTJbFaa
i0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
FPd9xf3E6Jobd2Sn9R2gzL+HYJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1o
dHRwOi8vd3d3LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD
nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1RXxlDPiyN8+s
D8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYMLVN0V2Ue1bLdI4E7pWYjJ2cJ
j+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrT
Qfv6MooqtyuGC2mDOL7Nii4LcK2NJpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW
+YJF1DngoABd15jmfZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7
Ixjp6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp1txyM/1d
8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B9kiABdcPUXmsEKvU7ANm
5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wokRqEIr9baRRmW1FMdW4R58MD3R++Lj8UG
rp1MYp3/RgT408m2ECVAdf4WqslKYIYvuu8wd+RU4riEmViAqhOLUTpPSPaLtrM=
-----END CERTIFICATE-----
Amazon Root CA 1
================
-----BEGIN CERTIFICATE-----
MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsFADA5MQswCQYD
VQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSAxMB4XDTE1
MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpv
bjEZMBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC
ggEBALJ4gHHKeNXjca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgH
FzZM9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qwIFAGbHrQ
gLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6VOujw5H5SNz/0egwLX0t
dHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L93FcXmn/6pUCyziKrlA4b9v7LWIbxcce
VOF34GfID5yHI9Y/QCB/IIDEgEw+OyQmjgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB
/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3
DQEBCwUAA4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDIU5PM
CCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUsN+gDS63pYaACbvXy
8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vvo/ufQJVtMVT8QtPHRh8jrdkPSHCa
2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2
xJNDd2ZhwLnoQdeXeGADbkpyrqXRfboQnoZsG4q5WTP468SQvvG5
-----END CERTIFICATE-----
Amazon Root CA 2
================
-----BEGIN CERTIFICATE-----
MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwFADA5MQswCQYD
VQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSAyMB4XDTE1
MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpv
bjEZMBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC
ggIBAK2Wny2cSkxKgXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4
kHbZW0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg1dKmSYXp
N+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K8nu+NQWpEjTj82R0Yiw9
AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvd
fLC6HM783k81ds8P+HgfajZRRidhW+mez/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAEx
kv8LV/SasrlX6avvDXbR8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSS
btqDT6ZjmUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz7Mt0
Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6+XUyo05f7O0oYtlN
c/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI0u1ufm8/0i2BWSlmy5A5lREedCf+
3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSw
DPBMMPQFWAJI/TPlUq9LhONmUjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oA
A7CXDpO8Wqj2LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY
+gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kSk5Nrp+gvU5LE
YFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl7uxMMne0nxrpS10gxdr9HIcW
xkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygmbtmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQ
gj9sAq+uEjonljYE1x2igGOpm/HlurR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbW
aQbLU8uz/mtBzUF+fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoV
Yh63n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE76KlXIx3
KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H9jVlpNMKVv/1F2Rs76gi
JUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT4PsJYGw=
-----END CERTIFICATE-----
Amazon Root CA 3
================
-----BEGIN CERTIFICATE-----
MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5MQswCQYDVQQG
EwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSAzMB4XDTE1MDUy
NjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZ
MBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZB
f8ANm+gBG1bG8lKlui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjr
Zt6jQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSrttvXBp43
rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkrBqWTrBqYaGFy+uGh0Psc
eGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteMYyRIHN8wfdVoOw==
-----END CERTIFICATE-----
Amazon Root CA 4
================
-----BEGIN CERTIFICATE-----
MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5MQswCQYDVQQG
EwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSA0MB4XDTE1MDUy
NjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZ
MBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN
/sGKe0uoe0ZLY7Bi9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri
83BkM6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNV
HQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WBMAoGCCqGSM49BAMDA2gA
MGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlwCkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1
AE47xDqUEpHJWEadIRNyp4iciuRMStuW1KyLa2tJElMzrdfkviT8tQp21KW8EA==
-----END CERTIFICATE-----
TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1
=============================================
-----BEGIN CERTIFICATE-----
MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIxGDAWBgNVBAcT
D0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxpbXNlbCB2ZSBUZWtub2xvamlr
IEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0wKwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24g
TWVya2V6aSAtIEthbXUgU00xNjA0BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRp
ZmlrYXNpIC0gU3VydW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYD
VQQGEwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXllIEJpbGlt
c2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklUQUsxLTArBgNVBAsTJEth
bXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBTTTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11
IFNNIFNTTCBLb2sgU2VydGlmaWthc2kgLSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
MIIBCgKCAQEAr3UwM6q7a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y8
6Ij5iySrLqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INrN3wc
wv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2XYacQuFWQfw4tJzh0
3+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/iSIzL+aFCr2lqBs23tPcLG07xxO9
WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4fAJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQU
ZT/HiobGPN08VFw1+DrtUgxHV8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJ
KoZIhvcNAQELBQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh
AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPfIPP54+M638yc
lNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4lzwDGrpDxpa5RXI4s6ehlj2R
e37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0j
q5Rm+K37DwhuJi1/FwcJsoz7UMCflo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM=
-----END CERTIFICATE-----
GDCA TrustAUTH R5 ROOT
======================
-----BEGIN CERTIFICATE-----
MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UEBhMCQ04xMjAw
BgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8wHQYDVQQD
DBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVow
YjELMAkGA1UEBhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ
IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0B
AQEFAAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJjDp6L3TQs
AlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBjTnnEt1u9ol2x8kECK62p
OqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+uKU49tm7srsHwJ5uu4/Ts765/94Y9cnrr
pftZTqfrlYwiOXnhLQiPzLyRuEH3FMEjqcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ
9Cy5WmYqsBebnh52nUpmMUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQ
xXABZG12ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloPzgsM
R6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3GkL30SgLdTMEZeS1SZ
D2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeCjGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4
oR24qoAATILnsn8JuLwwoC8N9VKejveSswoAHQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx
9hoh49pwBiFYFIeFd3mqgnkCAwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlR
MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg
p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZmDRd9FBUb1Ov9
H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5COmSdI31R9KrO9b7eGZONn35
6ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ryL3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd
+PwyvzeG5LuOmCd+uh8W4XAR8gPfJWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQ
HtZa37dG/OaG+svgIHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBD
F8Io2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV09tL7ECQ
8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQXR4EzzffHqhmsYzmIGrv
/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrqT8p+ck0LcIymSLumoRT2+1hEmRSuqguT
aaApJUqlyyvdimYHFngVV3Eb7PVHhPOeMTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g==
-----END CERTIFICATE-----
SSL.com Root Certification Authority RSA
========================================
-----BEGIN CERTIFICATE-----
MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxDjAM
BgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9TU0wgQ29ycG9yYXRpb24x
MTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYw
MjEyMTczOTM5WhcNNDEwMjEyMTczOTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx
EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NM
LmNvbSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcNAQEBBQAD
ggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2RxFdHaxh3a3by/ZPkPQ/C
Fp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aXqhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8
P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcCC52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/ge
oeOy3ZExqysdBP+lSgQ36YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkp
k8zruFvh/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrFYD3Z
fBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93EJNyAKoFBbZQ+yODJ
gUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVcUS4cK38acijnALXRdMbX5J+tB5O2
UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi8
1xtZPCvM8hnIk2snYxnP/Okm+Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4s
bE6x/c+cCbqiM+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV
HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4GA1UdDwEB/wQE
AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGVcpNxJK1ok1iOMq8bs3AD/CUr
dIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBcHadm47GUBwwyOabqG7B52B2ccETjit3E+ZUf
ijhDPwGFpUenPUayvOUiaPd7nNgsPgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAsl
u1OJD7OAUN5F7kR/q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjq
erQ0cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jra6x+3uxj
MxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90IH37hVZkLId6Tngr75qNJ
vTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/YK9f1JmzJBjSWFupwWRoyeXkLtoh/D1JI
Pb9s2KJELtFOt3JY04kTlf5Eq/jXixtunLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406y
wKBjYZC6VWg3dGq2ktufoYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NI
WuuA8ShYIc2wBlX7Jz9TkHCpBB5XJ7k=
-----END CERTIFICATE-----
SSL.com Root Certification Authority ECC
========================================
-----BEGIN CERTIFICATE-----
MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMCVVMxDjAMBgNV
BAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9TU0wgQ29ycG9yYXRpb24xMTAv
BgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEy
MTgxNDAzWhcNNDEwMjEyMTgxNDAzWjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAO
BgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv
bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuBBAAiA2IA
BEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI7Z4INcgn64mMU1jrYor+
8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPgCemB+vNH06NjMGEwHQYDVR0OBBYEFILR
hXMw5zUE044CkvvlpNHEIejNMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTT
jgKS++Wk0cQh6M0wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCW
e+0F+S8Tkdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+gA0z
5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl
-----END CERTIFICATE-----
SSL.com EV Root Certification Authority RSA R2
==============================================
-----BEGIN CERTIFICATE-----
MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNVBAYTAlVTMQ4w
DAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9u
MTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy
MB4XDTE3MDUzMTE4MTQzN1oXDTQyMDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQI
DAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYD
VQQDDC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMIICIjAN
BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvqM0fNTPl9fb69LT3w23jh
hqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssufOePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7w
cXHswxzpY6IXFJ3vG2fThVUCAtZJycxa4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTO
Zw+oz12WGQvE43LrrdF9HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+
B6KjBSYRaZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcAb9Zh
CBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQGp8hLH94t2S42Oim
9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQVPWKchjgGAGYS5Fl2WlPAApiiECto
RHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMOpgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+Slm
JuwgUHfbSguPvuUCYHBBXtSuUDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48
+qvWBkofZ6aYMBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV
HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa49QaAJadz20Zp
qJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBWs47LCp1Jjr+kxJG7ZhcFUZh1
++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nx
Y/hoLVUE0fKNsKTPvDxeH3jnpaAgcLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2G
guDKBAdRUNf/ktUM79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDz
OFSz/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXtll9ldDz7
CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEmKf7GUmG6sXP/wwyc5Wxq
lD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKKQbNmC1r7fSOl8hqw/96bg5Qu0T/fkreR
rwU7ZcegbLHNYhLDkBvjJc40vG93drEQw/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1
hlMYegouCRw2n5H9gooiS9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX
9hwJ1C07mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w==
-----END CERTIFICATE-----
SSL.com EV Root Certification Authority ECC
===========================================
-----BEGIN CERTIFICATE-----
MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMCVVMxDjAMBgNV
BAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9TU0wgQ29ycG9yYXRpb24xNDAy
BgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYw
MjEyMTgxNTIzWhcNNDEwMjEyMTgxNTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx
EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NM
LmNvbSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB
BAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMAVIbc/R/fALhBYlzccBYy
3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1KthkuWnBaBu2+8KGwytAJKaNjMGEwHQYDVR0O
BBYEFFvKXuXe0oGqzagtZFG22XKbl+ZPMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe
5d7SgarNqC1kUbbZcpuX5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJ
N+vp1RPZytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZgh5Mm
m7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg==
-----END CERTIFICATE-----
GlobalSign Root CA - R6
=======================
-----BEGIN CERTIFICATE-----
MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEgMB4GA1UECxMX
R2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkds
b2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQxMjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9i
YWxTaWduIFJvb3QgQ0EgLSBSNjETMBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFs
U2lnbjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQss
grRIxutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1kZguSgMpE
3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxDaNc9PIrFsmbVkJq3MQbF
vuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJwLnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqM
PKq0pPbzlUoSB239jLKJz9CgYXfIWHSw1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+
azayOeSsJDa38O+2HBNXk7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05O
WgtH8wY2SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/hbguy
CLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4nWUx2OVvq+aWh2IMP
0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpYrZxCRXluDocZXFSxZba/jJvcE+kN
b7gu3GduyYsRtYQUigAZcIN5kZeR1BonvzceMgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQE
AwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNV
HSMEGDAWgBSubAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN
nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGtIxg93eFyRJa0
lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr6155wsTLxDKZmOMNOsIeDjHfrY
BzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLjvUYAGm0CuiVdjaExUd1URhxN25mW7xocBFym
Fe944Hn+Xds+qkxV/ZoVqW/hpvvfcDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr
3TsTjxKM4kEaSHpzoHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB1
0jZpnOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfspA9MRf/T
uTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+vJJUEeKgDu+6B5dpffItK
oZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+t
JDfLRVpOoERIyNiwmcUVhAn21klJwGW45hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA=
-----END CERTIFICATE-----
OISTE WISeKey Global Root GC CA
===============================
-----BEGIN CERTIFICATE-----
MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQswCQYDVQQGEwJD
SDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91bmRhdGlvbiBFbmRvcnNlZDEo
MCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwgUm9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRa
Fw00MjA1MDkwOTU4MzNaMG0xCzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQL
ExlPSVNURSBGb3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh
bCBSb290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4nieUqjFqdr
VCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4Wp2OQ0jnUsYd4XxiWD1Ab
NTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAd
BgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7TrYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0E
AwMDaAAwZQIwJsdpW9zV57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtk
AjEA2zQgMgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9
-----END CERTIFICATE-----
UCA Global G2 Root
==================
-----BEGIN CERTIFICATE-----
MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9MQswCQYDVQQG
EwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBHbG9iYWwgRzIgUm9vdDAeFw0x
NjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0xCzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlU
cnVzdDEbMBkGA1UEAwwSVUNBIEdsb2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8A
MIICCgKCAgEAxeYrb3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmT
oni9kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzmVHqUwCoV
8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/RVogvGjqNO7uCEeBHANBS
h6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDcC/Vkw85DvG1xudLeJ1uK6NjGruFZfc8o
LTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIjtm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/
R+zvWr9LesGtOxdQXGLYD0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBe
KW4bHAyvj5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6DlNaBa
4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6iIis7nCs+dwp4wwc
OxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznPO6Q0ibd5Ei9Hxeepl2n8pndntd97
8XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O
BBYEFIHEjMz15DD/pQwIX4wVZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo
5sOASD0Ee/ojL3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5
1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl1qnN3e92mI0A
Ds0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oUb3n09tDh05S60FdRvScFDcH9
yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LVPtateJLbXDzz2K36uGt/xDYotgIVilQsnLAX
c47QN6MUPJiVAAwpBVueSUmxX8fjy88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHo
jhJi6IjMtX9Gl8CbEGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZk
bxqgDMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI+Vg7RE+x
ygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGyYiGqhkCyLmTTX8jjfhFn
RR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bXUB+K+wb1whnw0A==
-----END CERTIFICATE-----
UCA Extended Validation Root
============================
-----BEGIN CERTIFICATE-----
MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBHMQswCQYDVQQG
EwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9u
IFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMxMDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8G
A1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIi
MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrs
iWogD4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvSsPGP2KxF
Rv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aopO2z6+I9tTcg1367r3CTu
eUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dksHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR
59mzLC52LqGj3n5qiAno8geK+LLNEOfic0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH
0mK1lTnj8/FtDw5lhIpjVMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KR
el7sFsLzKuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/TuDv
B0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41Gsx2VYVdWf6/wFlth
WG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs1+lvK9JKBZP8nm9rZ/+I8U6laUpS
NwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQDfwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS
3H5aBZ8eNJr34RQwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQEL
BQADggIBADaNl8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR
ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQVBcZEhrxH9cM
aVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5c6sq1WnIeJEmMX3ixzDx/BR4
dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb
+7lsq+KePRXBOy5nAliRn+/4Qh8st2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOW
F3sGPjLtx7dCvHaj2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwi
GpWOvpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2CxR9GUeOc
GMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmxcmtpzyKEC2IPrNkZAJSi
djzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbMfjKaiJUINlK73nZfdklJrX+9ZSCyycEr
dhh2n1ax
-----END CERTIFICATE-----
Certigna Root CA
================
-----BEGIN CERTIFICATE-----
MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAwWjELMAkGA1UE
BhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAwMiA0ODE0NjMwODEwMDAzNjEZ
MBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0xMzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjda
MFoxCzAJBgNVBAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYz
MDgxMDAwMzYxGTAXBgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4IC
DwAwggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sOty3tRQgX
stmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9MCiBtnyN6tMbaLOQdLNyz
KNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPuI9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8
JXrJhFwLrN1CTivngqIkicuQstDuI7pmTLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16
XdG+RCYyKfHx9WzMfgIhC59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq
4NYKpkDfePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3YzIoej
wpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWTCo/1VTp2lc5ZmIoJ
lXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1kJWumIWmbat10TWuXekG9qxf5kBdI
jzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp/
/TBt2dzhauH8XwIDAQABo4IBGjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYw
HQYDVR0OBBYEFBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of
1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczovL3d3d3cuY2Vy
dGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilodHRwOi8vY3JsLmNlcnRpZ25h
LmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYraHR0cDovL2NybC5kaGlteW90aXMuY29tL2Nl
cnRpZ25hcm9vdGNhLmNybDANBgkqhkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOIt
OoldaDgvUSILSo3L6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxP
TGRGHVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH60BGM+RFq
7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncBlA2c5uk5jR+mUYyZDDl3
4bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdio2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd
8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS
6Cvu5zHbugRqh5jnxV/vfaci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaY
tlu3zM63Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayhjWZS
aX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw3kAP+HwV96LOPNde
E4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0=
-----END CERTIFICATE-----
emSign Root CA - G1
===================
-----BEGIN CERTIFICATE-----
MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYDVQQGEwJJTjET
MBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9sb2dpZXMgTGltaXRl
ZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBHMTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgx
ODMwMDBaMGcxCzAJBgNVBAYTAklOMRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVk
aHJhIFRlY2hub2xvZ2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIB
IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQzf2N4aLTN
LnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO8oG0x5ZOrRkVUkr+PHB1
cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aqd7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHW
DV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhMtTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ
6DqS0hdW5TUaQBw+jSztOd9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrH
hQIDAQABo0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQDAgEG
MA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31xPaOfG1vR2vjTnGs2
vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjMwiI/aTvFthUvozXGaCocV685743Q
NcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6dGNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q
+Mri/Tm3R7nrft8EI6/6nAYH6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeih
U80Bv2noWgbyRQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx
iN66zB+Afko=
-----END CERTIFICATE-----
emSign ECC Root CA - G3
=======================
-----BEGIN CERTIFICATE-----
MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQGEwJJTjETMBEG
A1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9sb2dpZXMgTGltaXRlZDEg
MB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4
MTgzMDAwWjBrMQswCQYDVQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11
ZGhyYSBUZWNobm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g
RzMwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0WXTsuwYc
58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xySfvalY8L1X44uT6EYGQIr
MgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuBzhccLikenEhjQjAOBgNVHQ8BAf8EBAMC
AQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+D
CBeQyh+KTOgNG3qxrdWBCUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7
jHvrZQnD+JbNR6iC8hZVdyR+EhCVBCyj
-----END CERTIFICATE-----
emSign Root CA - C1
===================
-----BEGIN CERTIFICATE-----
MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkGA1UEBhMCVVMx
EzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNp
Z24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAwMFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UE
BhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQD
ExNlbVNpZ24gUm9vdCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+up
ufGZBczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZHdPIWoU/
Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH3DspVpNqs8FqOp099cGX
OFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvHGPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4V
I5b2P/AgNBbeCsbEBEV5f6f9vtKppa+cxSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleooms
lMuoaJuvimUnzYnu3Yy1aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+
XJGFehiqTbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQAD
ggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87/kOXSTKZEhVb3xEp
/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4kqNPEjE2NuLe/gDEo2APJ62gsIq1
NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrGYQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9
wC68AivTxEDkigcxHpvOJpkT+xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQ
BmIMMMAVSKeoWXzhriKi4gp6D/piq1JM4fHfyr6DDUI=
-----END CERTIFICATE-----
emSign ECC Root CA - C3
=======================
-----BEGIN CERTIFICATE-----
MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQGEwJVUzETMBEG
A1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMxIDAeBgNVBAMTF2VtU2lnbiBF
Q0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAwMFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UE
BhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQD
ExdlbVNpZ24gRUNDIFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd
6bciMK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4OjavtisIGJAnB9
SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0OBBYEFPtaSNCAIEDyqOkA
B2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49BAMDA2gA
MGUCMQC02C8Cif22TGK6Q04ThHK1rt0c3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwU
ZOR8loMRnLDRWmFLpg9J0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ==
-----END CERTIFICATE-----
Hongkong Post Root CA 3
=======================
-----BEGIN CERTIFICATE-----
MIIFzzCCA7egAwIBAgIUCBZfikyl7ADJk0DfxMauI7gcWqQwDQYJKoZIhvcNAQELBQAwbzELMAkG
A1UEBhMCSEsxEjAQBgNVBAgTCUhvbmcgS29uZzESMBAGA1UEBxMJSG9uZyBLb25nMRYwFAYDVQQK
Ew1Ib25na29uZyBQb3N0MSAwHgYDVQQDExdIb25na29uZyBQb3N0IFJvb3QgQ0EgMzAeFw0xNzA2
MDMwMjI5NDZaFw00MjA2MDMwMjI5NDZaMG8xCzAJBgNVBAYTAkhLMRIwEAYDVQQIEwlIb25nIEtv
bmcxEjAQBgNVBAcTCUhvbmcgS29uZzEWMBQGA1UEChMNSG9uZ2tvbmcgUG9zdDEgMB4GA1UEAxMX
SG9uZ2tvbmcgUG9zdCBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz
iNfqzg8gTr7m1gNt7ln8wlffKWihgw4+aMdoWJwcYEuJQwy51BWy7sFOdem1p+/l6TWZ5Mwc50tf
jTMwIDNT2aa71T4Tjukfh0mtUC1Qyhi+AViiE3CWu4mIVoBc+L0sPOFMV4i707mV78vH9toxdCim
5lSJ9UExyuUmGs2C4HDaOym71QP1mbpV9WTRYA6ziUm4ii8F0oRFKHyPaFASePwLtVPLwpgchKOe
sL4jpNrcyCse2m5FHomY2vkALgbpDDtw1VAliJnLzXNg99X/NWfFobxeq81KuEXryGgeDQ0URhLj
0mRiikKYvLTGCAj4/ahMZJx2Ab0vqWwzD9g/KLg8aQFChn5pwckGyuV6RmXpwtZQQS4/t+TtbNe/
JgERohYpSms0BpDsE9K2+2p20jzt8NYt3eEV7KObLyzJPivkaTv/ciWxNoZbx39ri1UbSsUgYT2u
y1DhCDq+sI9jQVMwCFk8mB13umOResoQUGC/8Ne8lYePl8X+l2oBlKN8W4UdKjk60FSh0Tlxnf0h
+bV78OLgAo9uliQlLKAeLKjEiafv7ZkGL7YKTE/bosw3Gq9HhS2KX8Q0NEwA/RiTZxPRN+ZItIsG
xVd7GYYKecsAyVKvQv83j+GjHno9UKtjBucVtT+2RTeUN7F+8kjDf8V1/peNRY8apxpyKBpADwID
AQABo2MwYTAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBQXnc0e
i9Y5K3DTXNSguB+wAPzFYTAdBgNVHQ4EFgQUF53NHovWOStw01zUoLgfsAD8xWEwDQYJKoZIhvcN
AQELBQADggIBAFbVe27mIgHSQpsY1Q7XZiNc4/6gx5LS6ZStS6LG7BJ8dNVI0lkUmcDrudHr9Egw
W62nV3OZqdPlt9EuWSRY3GguLmLYauRwCy0gUCCkMpXRAJi70/33MvJJrsZ64Ee+bs7Lo3I6LWld
y8joRTnU+kLBEUx3XZL7av9YROXrgZ6voJmtvqkBZss4HTzfQx/0TW60uhdG/H39h4F5ag0zD/ov
+BS5gLNdTaqX4fnkGMX41TiMJjz98iji7lpJiCzfeT2OnpA8vUFKOt1b9pq0zj8lMH8yfaIDlNDc
eqFS3m6TjRgm/VWsvY+b0s+v54Ysyx8Jb6NvqYTUc79NoXQbTiNg8swOqn+knEwlqLJmOzj/2ZQw
9nKEvmhVEA/GcywWaZMH/rFF7buiVWqw2rVKAiUnhde3t4ZEFolsgCs+l6mc1X5VTMbeRRAc6uk7
nwNT7u56AQIWeNTowr5GdogTPyK7SBIdUgC0An4hGh6cJfTzPV4e0hz5sy229zdcxsshTrD3mUcY
hcErulWuBurQB7Lcq9CClnXO0lD+mefPL5/ndtFhKvshuzHQqp9HpLIiyhY6UFfEW0NnxWViA0kB
60PZ2Pierc+xYw5F9KBaLJstxabArahH9CdMOA0uG0k7UvToiIMrVCjU8jVStDKDYmlkDJGcn5fq
dBb9HxEGmpv0
-----END CERTIFICATE-----
Microsoft ECC Root Certificate Authority 2017
=============================================
-----BEGIN CERTIFICATE-----
MIICWTCCAd+gAwIBAgIQZvI9r4fei7FK6gxXMQHC7DAKBggqhkjOPQQDAzBlMQswCQYDVQQGEwJV
UzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNyb3NvZnQgRUND
IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwHhcNMTkxMjE4MjMwNjQ1WhcNNDIwNzE4
MjMxNjA0WjBlMQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYw
NAYDVQQDEy1NaWNyb3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwdjAQ
BgcqhkjOPQIBBgUrgQQAIgNiAATUvD0CQnVBEyPNgASGAlEvaqiBYgtlzPbKnR5vSmZRogPZnZH6
thaxjG7efM3beaYvzrvOcS/lpaso7GMEZpn4+vKTEAXhgShC48Zo9OYbhGBKia/teQ87zvH2RPUB
eMCjVDBSMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTIy5lycFIM
+Oa+sgRXKSrPQhDtNTAQBgkrBgEEAYI3FQEEAwIBADAKBggqhkjOPQQDAwNoADBlAjBY8k3qDPlf
Xu5gKcs68tvWMoQZP3zVL8KxzJOuULsJMsbG7X7JNpQS5GiFBqIb0C8CMQCZ6Ra0DvpWSNSkMBaR
eNtUjGUBiudQZsIxtzm6uBoiB078a1QWIP8rtedMDE2mT3M=
-----END CERTIFICATE-----
Microsoft RSA Root Certificate Authority 2017
=============================================
-----BEGIN CERTIFICATE-----
MIIFqDCCA5CgAwIBAgIQHtOXCV/YtLNHcB6qvn9FszANBgkqhkiG9w0BAQwFADBlMQswCQYDVQQG
EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNyb3NvZnQg
UlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwHhcNMTkxMjE4MjI1MTIyWhcNNDIw
NzE4MjMwMDIzWjBlMQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9u
MTYwNAYDVQQDEy1NaWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcw
ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKW76UM4wplZEWCpW9R2LBifOZNt9GkMml
7Xhqb0eRaPgnZ1AzHaGm++DlQ6OEAlcBXZxIQIJTELy/xztokLaCLeX0ZdDMbRnMlfl7rEqUrQ7e
S0MdhweSE5CAg2Q1OQT85elss7YfUJQ4ZVBcF0a5toW1HLUX6NZFndiyJrDKxHBKrmCk3bPZ7Pw7
1VdyvD/IybLeS2v4I2wDwAW9lcfNcztmgGTjGqwu+UcF8ga2m3P1eDNbx6H7JyqhtJqRjJHTOoI+
dkC0zVJhUXAoP8XFWvLJjEm7FFtNyP9nTUwSlq31/niol4fX/V4ggNyhSyL71Imtus5Hl0dVe49F
yGcohJUcaDDv70ngNXtk55iwlNpNhTs+VcQor1fznhPbRiefHqJeRIOkpcrVE7NLP8TjwuaGYaRS
MLl6IE9vDzhTyzMMEyuP1pq9KsgtsRx9S1HKR9FIJ3Jdh+vVReZIZZ2vUpC6W6IYZVcSn2i51BVr
lMRpIpj0M+Dt+VGOQVDJNE92kKz8OMHY4Xu54+OU4UZpyw4KUGsTuqwPN1q3ErWQgR5WrlcihtnJ
0tHXUeOrO8ZV/R4O03QK0dqq6mm4lyiPSMQH+FJDOvTKVTUssKZqwJz58oHhEmrARdlns87/I6KJ
ClTUFLkqqNfs+avNJVgyeY+QW5g5xAgGwax/Dj0ApQIDAQABo1QwUjAOBgNVHQ8BAf8EBAMCAYYw
DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUCctZf4aycI8awznjwNnpv7tNsiMwEAYJKwYBBAGC
NxUBBAMCAQAwDQYJKoZIhvcNAQEMBQADggIBAKyvPl3CEZaJjqPnktaXFbgToqZCLgLNFgVZJ8og
6Lq46BrsTaiXVq5lQ7GPAJtSzVXNUzltYkyLDVt8LkS/gxCP81OCgMNPOsduET/m4xaRhPtthH80
dK2Jp86519efhGSSvpWhrQlTM93uCupKUY5vVau6tZRGrox/2KJQJWVggEbbMwSubLWYdFQl3JPk
+ONVFT24bcMKpBLBaYVu32TxU5nhSnUgnZUP5NbcA/FZGOhHibJXWpS2qdgXKxdJ5XbLwVaZOjex
/2kskZGT4d9Mozd2TaGf+G0eHdP67Pv0RR0Tbc/3WeUiJ3IrhvNXuzDtJE3cfVa7o7P4NHmJweDy
AmH3pvwPuxwXC65B2Xy9J6P9LjrRk5Sxcx0ki69bIImtt2dmefU6xqaWM/5TkshGsRGRxpl/j8nW
ZjEgQRCHLQzWwa80mMpkg/sTV9HB8Dx6jKXB/ZUhoHHBk2dxEuqPiAppGWSZI1b7rCoucL5mxAyE
7+WL85MB+GqQk2dLsmijtWKP6T+MejteD+eMuMZ87zf9dOLITzNy4ZQ5bb0Sr74MTnB8G2+NszKT
c0QWbej09+CVgI+WXTik9KveCjCHk9hNAHFiRSdLOkKEW39lt2c0Ui2cFmuqqNh7o0JMcccMyj6D
5KbvtwEwXlGjefVwaaZBRA+GsCyRxj3qrg+E
-----END CERTIFICATE-----
e-Szigno Root CA 2017
=====================
-----BEGIN CERTIFICATE-----
MIICQDCCAeWgAwIBAgIMAVRI7yH9l1kN9QQKMAoGCCqGSM49BAMCMHExCzAJBgNVBAYTAkhVMREw
DwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMgTHRkLjEXMBUGA1UEYQwOVkFUSFUt
MjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25vIFJvb3QgQ0EgMjAxNzAeFw0xNzA4MjIxMjA3MDZa
Fw00MjA4MjIxMjA3MDZaMHExCzAJBgNVBAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UE
CgwNTWljcm9zZWMgTHRkLjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3pp
Z25vIFJvb3QgQ0EgMjAxNzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJbcPYrYsHtvxie+RJCx
s1YVe45DJH0ahFnuY2iyxl6H0BVIHqiQrb1TotreOpCmYF9oMrWGQd+HWyx7xf58etqjYzBhMA8G
A1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSHERUI0arBeAyxr87GyZDv
vzAEwDAfBgNVHSMEGDAWgBSHERUI0arBeAyxr87GyZDvvzAEwDAKBggqhkjOPQQDAgNJADBGAiEA
tVfd14pVCzbhhkT61NlojbjcI4qKDdQvfepz7L9NbKgCIQDLpbQS+ue16M9+k/zzNY9vTlp8tLxO
svxyqltZ+efcMQ==
-----END CERTIFICATE-----
certSIGN Root CA G2
===================
-----BEGIN CERTIFICATE-----
MIIFRzCCAy+gAwIBAgIJEQA0tk7GNi02MA0GCSqGSIb3DQEBCwUAMEExCzAJBgNVBAYTAlJPMRQw
EgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJR04gUk9PVCBDQSBHMjAeFw0xNzAy
MDYwOTI3MzVaFw00MjAyMDYwOTI3MzVaMEExCzAJBgNVBAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lH
TiBTQTEcMBoGA1UECxMTY2VydFNJR04gUk9PVCBDQSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIP
ADCCAgoCggIBAMDFdRmRfUR0dIf+DjuW3NgBFszuY5HnC2/OOwppGnzC46+CjobXXo9X69MhWf05
N0IwvlDqtg+piNguLWkh59E3GE59kdUWX2tbAMI5Qw02hVK5U2UPHULlj88F0+7cDBrZuIt4Imfk
abBoxTzkbFpG583H+u/E7Eu9aqSs/cwoUe+StCmrqzWaTOTECMYmzPhpn+Sc8CnTXPnGFiWeI8Mg
wT0PPzhAsP6CRDiqWhqKa2NYOLQV07YRaXseVO6MGiKscpc/I1mbySKEwQdPzH/iV8oScLumZfNp
dWO9lfsbl83kqK/20U6o2YpxJM02PbyWxPFsqa7lzw1uKA2wDrXKUXt4FMMgL3/7FFXhEZn91Qqh
ngLjYl/rNUssuHLoPj1PrCy7Lobio3aP5ZMqz6WryFyNSwb/EkaseMsUBzXgqd+L6a8VTxaJW732
jcZZroiFDsGJ6x9nxUWO/203Nit4ZoORUSs9/1F3dmKh7Gc+PoGD4FapUB8fepmrY7+EF3fxDTvf
95xhszWYijqy7DwaNz9+j5LP2RIUZNoQAhVB/0/E6xyjyfqZ90bp4RjZsbgyLcsUDFDYg2WD7rlc
z8sFWkz6GZdr1l0T08JcVLwyc6B49fFtHsufpaafItzRUZ6CeWRgKRM+o/1Pcmqr4tTluCRVLERL
iohEnMqE0yo7AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1Ud
DgQWBBSCIS1mxteg4BXrzkwJd8RgnlRuAzANBgkqhkiG9w0BAQsFAAOCAgEAYN4auOfyYILVAzOB
ywaK8SJJ6ejqkX/GM15oGQOGO0MBzwdw5AgeZYWR5hEit/UCI46uuR59H35s5r0l1ZUa8gWmr4UC
b6741jH/JclKyMeKqdmfS0mbEVeZkkMR3rYzpMzXjWR91M08KCy0mpbqTfXERMQlqiCA2ClV9+BB
/AYm/7k29UMUA2Z44RGx2iBfRgB4ACGlHgAoYXhvqAEBj500mv/0OJD7uNGzcgbJceaBxXntC6Z5
8hMLnPddDnskk7RI24Zf3lCGeOdA5jGokHZwYa+cNywRtYK3qq4kNFtyDGkNzVmf9nGvnAvRCjj5
BiKDUyUM/FHE5r7iOZULJK2v0ZXkltd0ZGtxTgI8qoXzIKNDOXZbbFD+mpwUHmUUihW9o4JFWklW
atKcsWMy5WHgUyIOpwpJ6st+H6jiYoD2EEVSmAYY3qXNL3+q1Ok+CHLsIwMCPKaq2LxndD0UF/tU
Sxfj03k9bWtJySgOLnRQvwzZRjoQhsmnP+mg7H/rpXdYaXHmgwo38oZJar55CJD2AhZkPuXaTH4M
NMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE1LlSVHJ7liXMvGnjSG4N
0MedJ5qq+BOS3R7fY581qRY27Iy4g/Q9iY/NtBde17MXQRBdJ3NghVdJIgc=
-----END CERTIFICATE-----
NAVER Global Root Certification Authority
=========================================
-----BEGIN CERTIFICATE-----
MIIFojCCA4qgAwIBAgIUAZQwHqIL3fXFMyqxQ0Rx+NZQTQ0wDQYJKoZIhvcNAQEMBQAwaTELMAkG
A1UEBhMCS1IxJjAkBgNVBAoMHU5BVkVSIEJVU0lORVNTIFBMQVRGT1JNIENvcnAuMTIwMAYDVQQD
DClOQVZFUiBHbG9iYWwgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MTgwODU4
NDJaFw0zNzA4MTgyMzU5NTlaMGkxCzAJBgNVBAYTAktSMSYwJAYDVQQKDB1OQVZFUiBCVVNJTkVT
UyBQTEFURk9STSBDb3JwLjEyMDAGA1UEAwwpTkFWRVIgR2xvYmFsIFJvb3QgQ2VydGlmaWNhdGlv
biBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC21PGTXLVAiQqrDZBb
UGOukJR0F0Vy1ntlWilLp1agS7gvQnXp2XskWjFlqxcX0TM62RHcQDaH38dq6SZeWYp34+hInDEW
+j6RscrJo+KfziFTowI2MMtSAuXaMl3Dxeb57hHHi8lEHoSTGEq0n+USZGnQJoViAbbJAh2+g1G7
XNr4rRVqmfeSVPc0W+m/6imBEtRTkZazkVrd/pBzKPswRrXKCAfHcXLJZtM0l/aM9BhK4dA9WkW2
aacp+yPOiNgSnABIqKYPszuSjXEOdMWLyEz59JuOuDxp7W87UC9Y7cSw0BwbagzivESq2M0UXZR4
Yb8ObtoqvC8MC3GmsxY/nOb5zJ9TNeIDoKAYv7vxvvTWjIcNQvcGufFt7QSUqP620wbGQGHfnZ3z
VHbOUzoBppJB7ASjjw2i1QnK1sua8e9DXcCrpUHPXFNwcMmIpi3Ua2FzUCaGYQ5fG8Ir4ozVu53B
A0K6lNpfqbDKzE0K70dpAy8i+/Eozr9dUGWokG2zdLAIx6yo0es+nPxdGoMuK8u180SdOqcXYZai
cdNwlhVNt0xz7hlcxVs+Qf6sdWA7G2POAN3aCJBitOUt7kinaxeZVL6HSuOpXgRM6xBtVNbv8ejy
YhbLgGvtPe31HzClrkvJE+2KAQHJuFFYwGY6sWZLxNUxAmLpdIQM201GLQIDAQABo0IwQDAdBgNV
HQ4EFgQU0p+I36HNLL3s9TsBAZMzJ7LrYEswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB
Af8wDQYJKoZIhvcNAQEMBQADggIBADLKgLOdPVQG3dLSLvCkASELZ0jKbY7gyKoNqo0hV4/GPnrK
21HUUrPUloSlWGB/5QuOH/XcChWB5Tu2tyIvCZwTFrFsDDUIbatjcu3cvuzHV+YwIHHW1xDBE1UB
jCpD5EHxzzp6U5LOogMFDTjfArsQLtk70pt6wKGm+LUx5vR1yblTmXVHIloUFcd4G7ad6Qz4G3bx
hYTeodoS76TiEJd6eN4MUZeoIUCLhr0N8F5OSza7OyAfikJW4Qsav3vQIkMsRIz75Sq0bBwcupTg
E34h5prCy8VCZLQelHsIJchxzIdFV4XTnyliIoNRlwAYl3dqmJLJfGBs32x9SuRwTMKeuB330DTH
D8z7p/8Dvq1wkNoL3chtl1+afwkyQf3NosxabUzyqkn+Zvjp2DXrDige7kgvOtB5CTh8piKCk5XQ
A76+AqAF3SAi428diDRgxuYKuQl1C/AH6GmWNcf7I4GOODm4RStDeKLRLBT/DShycpWbXgnbiUSY
qqFJu3FS8r/2/yehNq+4tneI3TqkbZs0kNwUXTC/t+sX5Ie3cdCh13cV1ELX8vMxmV2b3RZtP+oG
I/hGoiLtk/bdmuYqh7GYVPEi92tF4+KOdh2ajcQGjTa3FPOdVGm3jjzVpG2Tgbet9r1ke8LJaDmg
kpzNNIaRkPpkUZ3+/uul9XXeifdy
-----END CERTIFICATE-----
AC RAIZ FNMT-RCM SERVIDORES SEGUROS
===================================
-----BEGIN CERTIFICATE-----
MIICbjCCAfOgAwIBAgIQYvYybOXE42hcG2LdnC6dlTAKBggqhkjOPQQDAzB4MQswCQYDVQQGEwJF
UzERMA8GA1UECgwIRk5NVC1SQ00xDjAMBgNVBAsMBUNlcmVzMRgwFgYDVQRhDA9WQVRFUy1RMjgy
NjAwNEoxLDAqBgNVBAMMI0FDIFJBSVogRk5NVC1SQ00gU0VSVklET1JFUyBTRUdVUk9TMB4XDTE4
MTIyMDA5MzczM1oXDTQzMTIyMDA5MzczM1oweDELMAkGA1UEBhMCRVMxETAPBgNVBAoMCEZOTVQt
UkNNMQ4wDAYDVQQLDAVDZXJlczEYMBYGA1UEYQwPVkFURVMtUTI4MjYwMDRKMSwwKgYDVQQDDCNB
QyBSQUlaIEZOTVQtUkNNIFNFUlZJRE9SRVMgU0VHVVJPUzB2MBAGByqGSM49AgEGBSuBBAAiA2IA
BPa6V1PIyqvfNkpSIeSX0oNnnvBlUdBeh8dHsVnyV0ebAAKTRBdp20LHsbI6GA60XYyzZl2hNPk2
LEnb80b8s0RpRBNm/dfF/a82Tc4DTQdxz69qBdKiQ1oKUm8BA06Oi6NCMEAwDwYDVR0TAQH/BAUw
AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFAG5L++/EYZg8k/QQW6rcx/n0m5JMAoGCCqG
SM49BAMDA2kAMGYCMQCuSuMrQMN0EfKVrRYj3k4MGuZdpSRea0R7/DjiT8ucRRcRTBQnJlU5dUoD
zBOQn5ICMQD6SmxgiHPz7riYYqnOK8LZiqZwMR2vsJRM60/G49HzYqc8/5MuB1xJAWdpEgJyv+c=
-----END CERTIFICATE-----
GlobalSign Root R46
===================
-----BEGIN CERTIFICATE-----
MIIFWjCCA0KgAwIBAgISEdK7udcjGJ5AXwqdLdDfJWfRMA0GCSqGSIb3DQEBDAUAMEYxCzAJBgNV
BAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQDExNHbG9iYWxTaWduIFJv
b3QgUjQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAX
BgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBSNDYwggIi
MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCsrHQy6LNl5brtQyYdpokNRbopiLKkHWPd08Es
CVeJOaFV6Wc0dwxu5FUdUiXSE2te4R2pt32JMl8Nnp8semNgQB+msLZ4j5lUlghYruQGvGIFAha/
r6gjA7aUD7xubMLL1aa7DOn2wQL7Id5m3RerdELv8HQvJfTqa1VbkNud316HCkD7rRlr+/fKYIje
2sGP1q7Vf9Q8g+7XFkyDRTNrJ9CG0Bwta/OrffGFqfUo0q3v84RLHIf8E6M6cqJaESvWJ3En7YEt
bWaBkoe0G1h6zD8K+kZPTXhc+CtI4wSEy132tGqzZfxCnlEmIyDLPRT5ge1lFgBPGmSXZgjPjHvj
K8Cd+RTyG/FWaha/LIWFzXg4mutCagI0GIMXTpRW+LaCtfOW3T3zvn8gdz57GSNrLNRyc0NXfeD4
12lPFzYE+cCQYDdF3uYM2HSNrpyibXRdQr4G9dlkbgIQrImwTDsHTUB+JMWKmIJ5jqSngiCNI/on
ccnfxkF0oE32kRbcRoxfKWMxWXEM2G/CtjJ9++ZdU6Z+Ffy7dXxd7Pj2Fxzsx2sZy/N78CsHpdls
eVR2bJ0cpm4O6XkMqCNqo98bMDGfsVR7/mrLZqrcZdCinkqaByFrgY/bxFn63iLABJzjqls2k+g9
vXqhnQt2sQvHnf3PmKgGwvgqo6GDoLclcqUC4wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYD
VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA1yrc4GHqMywptWU4jaWSf8FmSwwDQYJKoZIhvcNAQEM
BQADggIBAHx47PYCLLtbfpIrXTncvtgdokIzTfnvpCo7RGkerNlFo048p9gkUbJUHJNOxO97k4Vg
JuoJSOD1u8fpaNK7ajFxzHmuEajwmf3lH7wvqMxX63bEIaZHU1VNaL8FpO7XJqti2kM3S+LGteWy
gxk6x9PbTZ4IevPuzz5i+6zoYMzRx6Fcg0XERczzF2sUyQQCPtIkpnnpHs6i58FZFZ8d4kuaPp92
CC1r2LpXFNqD6v6MVenQTqnMdzGxRBF6XLE+0xRFFRhiJBPSy03OXIPBNvIQtQ6IbbjhVp+J3pZm
OUdkLG5NrmJ7v2B0GbhWrJKsFjLtrWhV/pi60zTe9Mlhww6G9kuEYO4Ne7UyWHmRVSyBQ7N0H3qq
JZ4d16GLuc1CLgSkZoNNiTW2bKg2SnkheCLQQrzRQDGQob4Ez8pn7fXwgNNgyYMqIgXQBztSvwye
qiv5u+YfjyW6hY0XHgL+XVAEV8/+LbzvXMAaq7afJMbfc2hIkCwU9D9SGuTSyxTDYWnP4vkYxboz
nxSjBF25cfe1lNj2M8FawTSLfJvdkzrnE6JwYZ+vj+vYxXX4M2bUdGc6N3ec592kD3ZDZopD8p/7
DEJ4Y9HiD2971KE9dJeFt0g5QdYg/NA6s/rob8SKunE3vouXsXgxT7PntgMTzlSdriVZzH81Xwj3
QEUxeCp6
-----END CERTIFICATE-----
GlobalSign Root E46
===================
-----BEGIN CERTIFICATE-----
MIICCzCCAZGgAwIBAgISEdK7ujNu1LzmJGjFDYQdmOhDMAoGCCqGSM49BAMDMEYxCzAJBgNVBAYT
AkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQDExNHbG9iYWxTaWduIFJvb3Qg
RTQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNV
BAoTEEdsb2JhbFNpZ24gbnYtc2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBFNDYwdjAQBgcq
hkjOPQIBBgUrgQQAIgNiAAScDrHPt+ieUnd1NPqlRqetMhkytAepJ8qUuwzSChDH2omwlwxwEwkB
jtjqR+q+soArzfwoDdusvKSGN+1wCAB16pMLey5SnCNoIwZD7JIvU4Tb+0cUB+hflGddyXqBPCCj
QjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBQxCpCPtsad0kRL
gLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ7Zvvi5QCkxeCmb6zniz2C5GMn0oUsfZk
vLtoURMMA/cVi4RguYv/Uo7njLwcAjA8+RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+
CAezNIm8BZ/3Hobui3A=
-----END CERTIFICATE-----
ANF Secure Server Root CA
=========================
-----BEGIN CERTIFICATE-----
MIIF7zCCA9egAwIBAgIIDdPjvGz5a7EwDQYJKoZIhvcNAQELBQAwgYQxEjAQBgNVBAUTCUc2MzI4
NzUxMDELMAkGA1UEBhMCRVMxJzAlBgNVBAoTHkFORiBBdXRvcmlkYWQgZGUgQ2VydGlmaWNhY2lv
bjEUMBIGA1UECxMLQU5GIENBIFJhaXoxIjAgBgNVBAMTGUFORiBTZWN1cmUgU2VydmVyIFJvb3Qg
Q0EwHhcNMTkwOTA0MTAwMDM4WhcNMzkwODMwMTAwMDM4WjCBhDESMBAGA1UEBRMJRzYzMjg3NTEw
MQswCQYDVQQGEwJFUzEnMCUGA1UEChMeQU5GIEF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uMRQw
EgYDVQQLEwtBTkYgQ0EgUmFpejEiMCAGA1UEAxMZQU5GIFNlY3VyZSBTZXJ2ZXIgUm9vdCBDQTCC
AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANvrayvmZFSVgpCjcqQZAZ2cC4Ffc0m6p6zz
BE57lgvsEeBbphzOG9INgxwruJ4dfkUyYA8H6XdYfp9qyGFOtibBTI3/TO80sh9l2Ll49a2pcbnv
T1gdpd50IJeh7WhM3pIXS7yr/2WanvtH2Vdy8wmhrnZEE26cLUQ5vPnHO6RYPUG9tMJJo8gN0pcv
B2VSAKduyK9o7PQUlrZXH1bDOZ8rbeTzPvY1ZNoMHKGESy9LS+IsJJ1tk0DrtSOOMspvRdOoiXse
zx76W0OLzc2oD2rKDF65nkeP8Nm2CgtYZRczuSPkdxl9y0oukntPLxB3sY0vaJxizOBQ+OyRp1RM
VwnVdmPF6GUe7m1qzwmd+nxPrWAI/VaZDxUse6mAq4xhj0oHdkLePfTdsiQzW7i1o0TJrH93PB0j
7IKppuLIBkwC/qxcmZkLLxCKpvR/1Yd0DVlJRfbwcVw5Kda/SiOL9V8BY9KHcyi1Swr1+KuCLH5z
JTIdC2MKF4EA/7Z2Xue0sUDKIbvVgFHlSFJnLNJhiQcND85Cd8BEc5xEUKDbEAotlRyBr+Qc5RQe
8TZBAQIvfXOn3kLMTOmJDVb3n5HUA8ZsyY/b2BzgQJhdZpmYgG4t/wHFzstGH6wCxkPmrqKEPMVO
Hj1tyRRM4y5Bu8o5vzY8KhmqQYdOpc5LMnndkEl/AgMBAAGjYzBhMB8GA1UdIwQYMBaAFJxf0Gxj
o1+TypOYCK2Mh6UsXME3MB0GA1UdDgQWBBScX9BsY6Nfk8qTmAitjIelLFzBNzAOBgNVHQ8BAf8E
BAMCAYYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAgEATh65isagmD9uw2nAalxJ
UqzLK114OMHVVISfk/CHGT0sZonrDUL8zPB1hT+L9IBdeeUXZ701guLyPI59WzbLWoAAKfLOKyzx
j6ptBZNscsdW699QIyjlRRA96Gejrw5VD5AJYu9LWaL2U/HANeQvwSS9eS9OICI7/RogsKQOLHDt
dD+4E5UGUcjohybKpFtqFiGS3XNgnhAY3jyB6ugYw3yJ8otQPr0R4hUDqDZ9MwFsSBXXiJCZBMXM
5gf0vPSQ7RPi6ovDj6MzD8EpTBNO2hVWcXNyglD2mjN8orGoGjR0ZVzO0eurU+AagNjqOknkJjCb
5RyKqKkVMoaZkgoQI1YS4PbOTOK7vtuNknMBZi9iPrJyJ0U27U1W45eZ/zo1PqVUSlJZS2Db7v54
EX9K3BR5YLZrZAPbFYPhor72I5dQ8AkzNqdxliXzuUJ92zg/LFis6ELhDtjTO0wugumDLmsx2d1H
hk9tl5EuT+IocTUW0fJz/iUrB0ckYyfI+PbZa/wSMVYIwFNCr5zQM378BvAxRAMU8Vjq8moNqRGy
g77FGr8H6lnco4g175x2MjxNBiLOFeXdntiP2t7SxDnlF4HPOEfrf4htWRvfn0IUrn7PqLBmZdo3
r5+qPeoott7VMVgWglvquxl1AnMaykgaIZOQCo6ThKd9OyMYkomgjaw=
-----END CERTIFICATE-----
Certum EC-384 CA
================
-----BEGIN CERTIFICATE-----
MIICZTCCAeugAwIBAgIQeI8nXIESUiClBNAt3bpz9DAKBggqhkjOPQQDAzB0MQswCQYDVQQGEwJQ
TDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2Vy
dGlmaWNhdGlvbiBBdXRob3JpdHkxGTAXBgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwHhcNMTgwMzI2
MDcyNDU0WhcNNDMwMzI2MDcyNDU0WjB0MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERh
dGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkx
GTAXBgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATEKI6rGFtq
vm5kN2PkzeyrOvfMobgOgknXhimfoZTy42B4mIF4Bk3y7JoOV2CDn7TmFy8as10CW4kjPMIRBSqn
iBMY81CE1700LCeJVf/OTOffph8oxPBUw7l8t1Ot68KjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYD
VR0OBBYEFI0GZnQkdjrzife81r1HfS+8EF9LMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNo
ADBlAjADVS2m5hjEfO/JUG7BJw+ch69u1RsIGL2SKcHvlJF40jocVYli5RsJHrpka/F2tNQCMQC0
QoSZ/6vnnvuRlydd3LBbMHHOXjgaatkl5+r3YZJW+OraNsKHZZYuciUvf9/DE8k=
-----END CERTIFICATE-----
Certum Trusted Root CA
======================
-----BEGIN CERTIFICATE-----
MIIFwDCCA6igAwIBAgIQHr9ZULjJgDdMBvfrVU+17TANBgkqhkiG9w0BAQ0FADB6MQswCQYDVQQG
EwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0g
Q2VydGlmaWNhdGlvbiBBdXRob3JpdHkxHzAdBgNVBAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0Ew
HhcNMTgwMzE2MTIxMDEzWhcNNDMwMzE2MTIxMDEzWjB6MQswCQYDVQQGEwJQTDEhMB8GA1UEChMY
QXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBB
dXRob3JpdHkxHzAdBgNVBAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEB
AQUAA4ICDwAwggIKAoICAQDRLY67tzbqbTeRn06TpwXkKQMlzhyC93yZn0EGze2jusDbCSzBfN8p
fktlL5On1AFrAygYo9idBcEq2EXxkd7fO9CAAozPOA/qp1x4EaTByIVcJdPTsuclzxFUl6s1wB52
HO8AU5853BSlLCIls3Jy/I2z5T4IHhQqNwuIPMqw9MjCoa68wb4pZ1Xi/K1ZXP69VyywkI3C7Te2
fJmItdUDmj0VDT06qKhF8JVOJVkdzZhpu9PMMsmN74H+rX2Ju7pgE8pllWeg8xn2A1bUatMn4qGt
g/BKEiJ3HAVz4hlxQsDsdUaakFjgao4rpUYwBI4Zshfjvqm6f1bxJAPXsiEodg42MEx51UGamqi4
NboMOvJEGyCI98Ul1z3G4z5D3Yf+xOr1Uz5MZf87Sst4WmsXXw3Hw09Omiqi7VdNIuJGmj8PkTQk
fVXjjJU30xrwCSss0smNtA0Aq2cpKNgB9RkEth2+dv5yXMSFytKAQd8FqKPVhJBPC/PgP5sZ0jeJ
P/J7UhyM9uH3PAeXjA6iWYEMspA90+NZRu0PqafegGtaqge2Gcu8V/OXIXoMsSt0Puvap2ctTMSY
njYJdmZm/Bo/6khUHL4wvYBQv3y1zgD2DGHZ5yQD4OMBgQ692IU0iL2yNqh7XAjlRICMb/gv1SHK
HRzQ+8S1h9E6Tsd2tTVItQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSM+xx1
vALTn04uSNn5YFSqxLNP+jAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQENBQADggIBAEii1QAL
LtA/vBzVtVRJHlpr9OTy4EA34MwUe7nJ+jW1dReTagVphZzNTxl4WxmB82M+w85bj/UvXgF2Ez8s
ALnNllI5SW0ETsXpD4YN4fqzX4IS8TrOZgYkNCvozMrnadyHncI013nR03e4qllY/p0m+jiGPp2K
h2RX5Rc64vmNueMzeMGQ2Ljdt4NR5MTMI9UGfOZR0800McD2RrsLrfw9EAUqO0qRJe6M1ISHgCq8
CYyqOhNf6DR5UMEQGfnTKB7U0VEwKbOukGfWHwpjscWpxkIxYxeU72nLL/qMFH3EQxiJ2fAyQOaA
4kZf5ePBAFmo+eggvIksDkc0C+pXwlM2/KfUrzHN/gLldfq5Jwn58/U7yn2fqSLLiMmq0Uc9Nneo
WWRrJ8/vJ8HjJLWG965+Mk2weWjROeiQWMODvA8s1pfrzgzhIMfatz7DP78v3DSk+yshzWePS/Tj
6tQ/50+6uaWTRRxmHyH6ZF5v4HaUMst19W7l9o/HuKTMqJZ9ZPskWkoDbGs4xugDQ5r3V7mzKWmT
OPQD8rv7gmsHINFSH5pkAnuYZttcTVoP0ISVoDwUQwbKytu4QTbaakRnh6+v40URFWkIsr4WOZck
bxJF0WddCajJFdr60qZfE2Efv4WstK2tBZQIgx51F9NxO5NQI1mg7TyRVJ12AMXDuDjb
-----END CERTIFICATE-----
TunTrust Root CA
================
-----BEGIN CERTIFICATE-----
MIIFszCCA5ugAwIBAgIUEwLV4kBMkkaGFmddtLu7sms+/BMwDQYJKoZIhvcNAQELBQAwYTELMAkG
A1UEBhMCVE4xNzA1BgNVBAoMLkFnZW5jZSBOYXRpb25hbGUgZGUgQ2VydGlmaWNhdGlvbiBFbGVj
dHJvbmlxdWUxGTAXBgNVBAMMEFR1blRydXN0IFJvb3QgQ0EwHhcNMTkwNDI2MDg1NzU2WhcNNDQw
NDI2MDg1NzU2WjBhMQswCQYDVQQGEwJUTjE3MDUGA1UECgwuQWdlbmNlIE5hdGlvbmFsZSBkZSBD
ZXJ0aWZpY2F0aW9uIEVsZWN0cm9uaXF1ZTEZMBcGA1UEAwwQVHVuVHJ1c3QgUm9vdCBDQTCCAiIw
DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMPN0/y9BFPdDCA61YguBUtB9YOCfvdZn56eY+hz
2vYGqU8ftPkLHzmMmiDQfgbU7DTZhrx1W4eI8NLZ1KMKsmwb60ksPqxd2JQDoOw05TDENX37Jk0b
bjBU2PWARZw5rZzJJQRNmpA+TkBuimvNKWfGzC3gdOgFVwpIUPp6Q9p+7FuaDmJ2/uqdHYVy7BG7
NegfJ7/Boce7SBbdVtfMTqDhuazb1YMZGoXRlJfXyqNlC/M4+QKu3fZnz8k/9YosRxqZbwUN/dAd
gjH8KcwAWJeRTIAAHDOFli/LQcKLEITDCSSJH7UP2dl3RxiSlGBcx5kDPP73lad9UKGAwqmDrViW
VSHbhlnUr8a83YFuB9tgYv7sEG7aaAH0gxupPqJbI9dkxt/con3YS7qC0lH4Zr8GRuR5KiY2eY8f
Tpkdso8MDhz/yV3A/ZAQprE38806JG60hZC/gLkMjNWb1sjxVj8agIl6qeIbMlEsPvLfe/ZdeikZ
juXIvTZxi11Mwh0/rViizz1wTaZQmCXcI/m4WEEIcb9PuISgjwBUFfyRbVinljvrS5YnzWuioYas
DXxU5mZMZl+QviGaAkYt5IPCgLnPSz7ofzwB7I9ezX/SKEIBlYrilz0QIX32nRzFNKHsLA4KUiwS
VXAkPcvCFDVDXSdOvsC9qnyW5/yeYa1E0wCXAgMBAAGjYzBhMB0GA1UdDgQWBBQGmpsfU33x9aTI
04Y+oXNZtPdEITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFAaamx9TffH1pMjThj6hc1m0
90QhMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAqgVutt0Vyb+zxiD2BkewhpMl
0425yAA/l/VSJ4hxyXT968pk21vvHl26v9Hr7lxpuhbI87mP0zYuQEkHDVneixCwSQXi/5E/S7fd
Ao74gShczNxtr18UnH1YeA32gAm56Q6XKRm4t+v4FstVEuTGfbvE7Pi1HE4+Z7/FXxttbUcoqgRY
YdZ2vyJ/0Adqp2RT8JeNnYA/u8EH22Wv5psymsNUk8QcCMNE+3tjEUPRahphanltkE8pjkcFwRJp
adbGNjHh/PqAulxPxOu3Mqz4dWEX1xAZufHSCe96Qp1bWgvUxpVOKs7/B9dPfhgGiPEZtdmYu65x
xBzndFlY7wyJz4sfdZMaBBSSSFCp61cpABbjNhzI+L/wM9VBD8TMPN3pM0MBkRArHtG5Xc0yGYuP
jCB31yLEQtyEFpslbei0VXF/sHyz03FJuc9SpAQ/3D2gu68zngowYI7bnV2UqL1g52KAdoGDDIzM
MEZJ4gzSqK/rYXHv5yJiqfdcZGyfFoxnNidF9Ql7v/YQCvGwjVRDjAS6oz/v4jXH+XTgbzRB0L9z
ZVcg+ZtnemZoJE6AZb0QmQZZ8mWvuMZHu/2QeItBcy6vVR/cO5JyboTT0GFMDcx2V+IthSIVNg3r
AZ3r2OvEhJn7wAzMMujjd9qDRIueVSjAi1jTkD5OGwDxFa2DK5o=
-----END CERTIFICATE-----
HARICA TLS RSA Root CA 2021
===========================
-----BEGIN CERTIFICATE-----
MIIFpDCCA4ygAwIBAgIQOcqTHO9D88aOk8f0ZIk4fjANBgkqhkiG9w0BAQsFADBsMQswCQYDVQQG
EwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9u
cyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBSU0EgUm9vdCBDQSAyMDIxMB4XDTIxMDIxOTEwNTUz
OFoXDTQ1MDIxMzEwNTUzN1owbDELMAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRl
bWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgUlNB
IFJvb3QgQ0EgMjAyMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIvC569lmwVnlskN
JLnQDmT8zuIkGCyEf3dRywQRNrhe7Wlxp57kJQmXZ8FHws+RFjZiPTgE4VGC/6zStGndLuwRo0Xu
a2s7TL+MjaQenRG56Tj5eg4MmOIjHdFOY9TnuEFE+2uva9of08WRiFukiZLRgeaMOVig1mlDqa2Y
Ulhu2wr7a89o+uOkXjpFc5gH6l8Cct4MpbOfrqkdtx2z/IpZ525yZa31MJQjB/OCFks1mJxTuy/K
5FrZx40d/JiZ+yykgmvwKh+OC19xXFyuQnspiYHLA6OZyoieC0AJQTPb5lh6/a6ZcMBaD9YThnEv
dmn8kN3bLW7R8pv1GmuebxWMevBLKKAiOIAkbDakO/IwkfN4E8/BPzWr8R0RI7VDIp4BkrcYAuUR
0YLbFQDMYTfBKnya4dC6s1BG7oKsnTH4+yPiAwBIcKMJJnkVU2DzOFytOOqBAGMUuTNe3QvboEUH
GjMJ+E20pwKmafTCWQWIZYVWrkvL4N48fS0ayOn7H6NhStYqE613TBoYm5EPWNgGVMWX+Ko/IIqm
haZ39qb8HOLubpQzKoNQhArlT4b4UEV4AIHrW2jjJo3Me1xR9BQsQL4aYB16cmEdH2MtiKrOokWQ
CPxrvrNQKlr9qEgYRtaQQJKQCoReaDH46+0N0x3GfZkYVVYnZS6NRcUk7M7jAgMBAAGjQjBAMA8G
A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFApII6ZgpJIKM+qTW8VX6iVNvRLuMA4GA1UdDwEB/wQE
AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAPpBIqm5iFSVmewzVjIuJndftTgfvnNAUX15QvWiWkKQU
EapobQk1OUAJ2vQJLDSle1mESSmXdMgHHkdt8s4cUCbjnj1AUz/3f5Z2EMVGpdAgS1D0NTsY9FVq
QRtHBmg8uwkIYtlfVUKqrFOFrJVWNlar5AWMxajaH6NpvVMPxP/cyuN+8kyIhkdGGvMA9YCRotxD
QpSbIPDRzbLrLFPCU3hKTwSUQZqPJzLB5UkZv/HywouoCjkxKLR9YjYsTewfM7Z+d21+UPCfDtcR
j88YxeMn/ibvBZ3PzzfF0HvaO7AWhAw6k9a+F9sPPg4ZeAnHqQJyIkv3N3a6dcSFA1pj1bF1BcK5
vZStjBWZp5N99sXzqnTPBIWUmAD04vnKJGW/4GKvyMX6ssmeVkjaef2WdhW+o45WxLM0/L5H9MG0
qPzVMIho7suuyWPEdr6sOBjhXlzPrjoiUevRi7PzKzMHVIf6tLITe7pTBGIBnfHAT+7hOtSLIBD6
Alfm78ELt5BGnBkpjNxvoEppaZS3JGWg/6w/zgH7IS79aPib8qXPMThcFarmlwDB31qlpzmq6YR/
PFGoOtmUW4y/Twhx5duoXNTSpv4Ao8YWxw/ogM4cKGR0GQjTQuPOAF1/sdwTsOEFy9EgqoZ0njnn
kf3/W9b3raYvAwtt41dU63ZTGI0RmLo=
-----END CERTIFICATE-----
HARICA TLS ECC Root CA 2021
===========================
-----BEGIN CERTIFICATE-----
MIICVDCCAdugAwIBAgIQZ3SdjXfYO2rbIvT/WeK/zjAKBggqhkjOPQQDAzBsMQswCQYDVQQGEwJH
UjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBD
QTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBFQ0MgUm9vdCBDQSAyMDIxMB4XDTIxMDIxOTExMDExMFoX
DTQ1MDIxMzExMDEwOVowbDELMAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWlj
IGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgRUNDIFJv
b3QgQ0EgMjAyMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABDgI/rGgltJ6rK9JOtDA4MM7KKrxcm1l
AEeIhPyaJmuqS7psBAqIXhfyVYf8MLA04jRYVxqEU+kw2anylnTDUR9YSTHMmE5gEYd103KUkE+b
ECUqqHgtvpBBWJAVcqeht6NCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUyRtTgRL+BNUW
0aq8mm+3oJUZbsowDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMDA2cAMGQCMBHervjcToiwqfAi
rcJRQO9gcS3ujwLEXQNwSaSS6sUUiHCm0w2wqsosQJz76YJumgIwK0eaB8bRwoF8yguWGEEbo/Qw
CZ61IygNnxS2PFOiTAZpffpskcYqSUXm7LcT4Tps
-----END CERTIFICATE-----
Autoridad de Certificacion Firmaprofesional CIF A62634068
=========================================================
-----BEGIN CERTIFICATE-----
MIIGFDCCA/ygAwIBAgIIG3Dp0v+ubHEwDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCRVMxQjBA
BgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1hcHJvZmVzaW9uYWwgQ0lGIEE2
MjYzNDA2ODAeFw0xNDA5MjMxNTIyMDdaFw0zNjA1MDUxNTIyMDdaMFExCzAJBgNVBAYTAkVTMUIw
QAYDVQQDDDlBdXRvcmlkYWQgZGUgQ2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBB
NjI2MzQwNjgwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDD
Utd9thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQMcas9UX4P
B99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefGL9ItWY16Ck6WaVICqjaY
7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15iNA9wBj4gGFrO93IbJWyTdBSTo3OxDqqH
ECNZXyAFGUftaI6SEspd/NYrspI8IM/hX68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyI
plD9amML9ZMWGxmPsu2bm8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctX
MbScyJCyZ/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirjaEbsX
LZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/TKI8xWVvTyQKmtFLK
bpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF6NkBiDkal4ZkQdU7hwxu+g/GvUgU
vzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVhOSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMB0GA1Ud
DgQWBBRlzeurNR4APn7VdMActHNHDhpkLzASBgNVHRMBAf8ECDAGAQH/AgEBMIGmBgNVHSAEgZ4w
gZswgZgGBFUdIAAwgY8wLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuZmlybWFwcm9mZXNpb25hbC5j
b20vY3BzMFwGCCsGAQUFBwICMFAeTgBQAGEAcwBlAG8AIABkAGUAIABsAGEAIABCAG8AbgBhAG4A
bwB2AGEAIAA0ADcAIABCAGEAcgBjAGUAbABvAG4AYQAgADAAOAAwADEANzAOBgNVHQ8BAf8EBAMC
AQYwDQYJKoZIhvcNAQELBQADggIBAHSHKAIrdx9miWTtj3QuRhy7qPj4Cx2Dtjqn6EWKB7fgPiDL
4QjbEwj4KKE1soCzC1HA01aajTNFSa9J8OA9B3pFE1r/yJfY0xgsfZb43aJlQ3CTkBW6kN/oGbDb
LIpgD7dvlAceHabJhfa9NPhAeGIQcDq+fUs5gakQ1JZBu/hfHAsdCPKxsIl68veg4MSPi3i1O1il
I45PVf42O+AMt8oqMEEgtIDNrvx2ZnOorm7hfNoD6JQg5iKj0B+QXSBTFCZX2lSX3xZEEAEeiGaP
cjiT3SC3NL7X8e5jjkd5KAb881lFJWAiMxujX6i6KtoaPc1A6ozuBRWV1aUsIC+nmCjuRfzxuIgA
LI9C2lHVnOUTaHFFQ4ueCyE8S1wF3BqfmI7avSKecs2tCsvMo2ebKHTEm9caPARYpoKdrcd7b/+A
lun4jWq9GJAd/0kakFI3ky88Al2CdgtR5xbHV/g4+afNmyJU72OwFW1TZQNKXkqgsqeOSQBZONXH
9IBk9W6VULgRfhVwOEqwf9DEMnDAGf/JOC0ULGb0QkTmVXYbgBVX/8Cnp6o5qtjTcNAuuuuUavpf
NIbnYrX9ivAwhZTJryQCL2/W3Wf+47BVTwSYT6RBVuKT0Gro1vP7ZeDOdcQxWQzugsgMYDNKGbqE
ZycPvEJdvSRUDewdcAZfpLz6IHxV
-----END CERTIFICATE-----
vTrus ECC Root CA
=================
-----BEGIN CERTIFICATE-----
MIICDzCCAZWgAwIBAgIUbmq8WapTvpg5Z6LSa6Q75m0c1towCgYIKoZIzj0EAwMwRzELMAkGA1UE
BhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBS
b290IENBMB4XDTE4MDczMTA3MjY0NFoXDTQzMDczMTA3MjY0NFowRzELMAkGA1UEBhMCQ04xHDAa
BgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBSb290IENBMHYw
EAYHKoZIzj0CAQYFK4EEACIDYgAEZVBKrox5lkqqHAjDo6LN/llWQXf9JpRCux3NCNtzslt188+c
ToL0v/hhJoVs1oVbcnDS/dtitN9Ti72xRFhiQgnH+n9bEOf+QP3A2MMrMudwpremIFUde4BdS49n
TPEQo0IwQDAdBgNVHQ4EFgQUmDnNvtiyjPeyq+GtJK97fKHbH88wDwYDVR0TAQH/BAUwAwEB/zAO
BgNVHQ8BAf8EBAMCAQYwCgYIKoZIzj0EAwMDaAAwZQIwV53dVvHH4+m4SVBrm2nDb+zDfSXkV5UT
QJtS0zvzQBm8JsctBp61ezaf9SXUY2sAAjEA6dPGnlaaKsyh2j/IZivTWJwghfqrkYpwcBE4YGQL
YgmRWAD5Tfs0aNoJrSEGGJTO
-----END CERTIFICATE-----
vTrus Root CA
=============
-----BEGIN CERTIFICATE-----
MIIFVjCCAz6gAwIBAgIUQ+NxE9izWRRdt86M/TX9b7wFjUUwDQYJKoZIhvcNAQELBQAwQzELMAkG
A1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xFjAUBgNVBAMTDXZUcnVzIFJv
b3QgQ0EwHhcNMTgwNzMxMDcyNDA1WhcNNDMwNzMxMDcyNDA1WjBDMQswCQYDVQQGEwJDTjEcMBoG
A1UEChMTaVRydXNDaGluYSBDby4sTHRkLjEWMBQGA1UEAxMNdlRydXMgUm9vdCBDQTCCAiIwDQYJ
KoZIhvcNAQEBBQADggIPADCCAgoCggIBAL1VfGHTuB0EYgWgrmy3cLRB6ksDXhA/kFocizuwZots
SKYcIrrVQJLuM7IjWcmOvFjai57QGfIvWcaMY1q6n6MLsLOaXLoRuBLpDLvPbmyAhykUAyyNJJrI
ZIO1aqwTLDPxn9wsYTwaP3BVm60AUn/PBLn+NvqcwBauYv6WTEN+VRS+GrPSbcKvdmaVayqwlHeF
XgQPYh1jdfdr58tbmnDsPmcF8P4HCIDPKNsFxhQnL4Z98Cfe/+Z+M0jnCx5Y0ScrUw5XSmXX+6KA
YPxMvDVTAWqXcoKv8R1w6Jz1717CbMdHflqUhSZNO7rrTOiwCcJlwp2dCZtOtZcFrPUGoPc2BX70
kLJrxLT5ZOrpGgrIDajtJ8nU57O5q4IikCc9Kuh8kO+8T/3iCiSn3mUkpF3qwHYw03dQ+A0Em5Q2
AXPKBlim0zvc+gRGE1WKyURHuFE5Gi7oNOJ5y1lKCn+8pu8fA2dqWSslYpPZUxlmPCdiKYZNpGvu
/9ROutW04o5IWgAZCfEF2c6Rsffr6TlP9m8EQ5pV9T4FFL2/s1m02I4zhKOQUqqzApVg+QxMaPnu
1RcN+HFXtSXkKe5lXa/R7jwXC1pDxaWG6iSe4gUH3DRCEpHWOXSuTEGC2/KmSNGzm/MzqvOmwMVO
9fSddmPmAsYiS8GVP1BkLFTltvA8Kc9XAgMBAAGjQjBAMB0GA1UdDgQWBBRUYnBj8XWEQ1iO0RYg
scasGrz2iTAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOC
AgEAKbqSSaet8PFww+SX8J+pJdVrnjT+5hpk9jprUrIQeBqfTNqK2uwcN1LgQkv7bHbKJAs5EhWd
nxEt/Hlk3ODg9d3gV8mlsnZwUKT+twpw1aA08XXXTUm6EdGz2OyC/+sOxL9kLX1jbhd47F18iMjr
jld22VkE+rxSH0Ws8HqA7Oxvdq6R2xCOBNyS36D25q5J08FsEhvMKar5CKXiNxTKsbhm7xqC5PD4
8acWabfbqWE8n/Uxy+QARsIvdLGx14HuqCaVvIivTDUHKgLKeBRtRytAVunLKmChZwOgzoy8sHJn
xDHO2zTlJQNgJXtxmOTAGytfdELSS8VZCAeHvsXDf+eW2eHcKJfWjwXj9ZtOyh1QRwVTsMo554Wg
icEFOwE30z9J4nfrI8iIZjs9OXYhRvHsXyO466JmdXTBQPfYaJqT4i2pLr0cox7IdMakLXogqzu4
sEb9b91fUlV1YvCXoHzXOP0l382gmxDPi7g4Xl7FtKYCNqEeXxzP4padKar9mK5S4fNBUvupLnKW
nyfjqnN9+BojZns7q2WwMgFLFT49ok8MKzWixtlnEjUwzXYuFrOZnk1PTi07NEPhmg4NpGaXutIc
SkwsKouLgU9xGqndXHt7CMUADTdA43x7VF8vhV929vensBxXVsFy6K2ir40zSbofitzmdHxghm+H
l3s=
-----END CERTIFICATE-----
ISRG Root X2
============
-----BEGIN CERTIFICATE-----
MIICGzCCAaGgAwIBAgIQQdKd0XLq7qeAwSxs6S+HUjAKBggqhkjOPQQDAzBPMQswCQYDVQQGEwJV
UzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElT
UkcgUm9vdCBYMjAeFw0yMDA5MDQwMDAwMDBaFw00MDA5MTcxNjAwMDBaME8xCzAJBgNVBAYTAlVT
MSkwJwYDVQQKEyBJbnRlcm5ldCBTZWN1cml0eSBSZXNlYXJjaCBHcm91cDEVMBMGA1UEAxMMSVNS
RyBSb290IFgyMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEzZvVn4CDCuwJSvMWSj5cz3es3mcFDR0H
ttwW+1qLFNvicWDEukWVEYmO6gbf9yoWHKS5xcUy4APgHoIYOIvXRdgKam7mAHf7AlF9ItgKbppb
d9/w+kHsOdx1ymgHDB/qo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
HQ4EFgQUfEKWrt5LSDv6kviejM9ti6lyN5UwCgYIKoZIzj0EAwMDaAAwZQIwe3lORlCEwkSHRhtF
cP9Ymd70/aTSVaYgLXTWNLxBo1BfASdWtL4ndQavEi51mI38AjEAi/V3bNTIZargCyzuFJ0nN6T5
U6VR5CmD1/iQMVtCnwr1/q4AaOeMSQ+2b1tbFfLn
-----END CERTIFICATE-----
HiPKI Root CA - G1
==================
-----BEGIN CERTIFICATE-----
MIIFajCCA1KgAwIBAgIQLd2szmKXlKFD6LDNdmpeYDANBgkqhkiG9w0BAQsFADBPMQswCQYDVQQG
EwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0ZC4xGzAZBgNVBAMMEkhpUEtJ
IFJvb3QgQ0EgLSBHMTAeFw0xOTAyMjIwOTQ2MDRaFw0zNzEyMzExNTU5NTlaME8xCzAJBgNVBAYT
AlRXMSMwIQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEbMBkGA1UEAwwSSGlQS0kg
Um9vdCBDQSAtIEcxMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA9B5/UnMyDHPkvRN0
o9QwqNCuS9i233VHZvR85zkEHmpwINJaR3JnVfSl6J3VHiGh8Ge6zCFovkRTv4354twvVcg3Px+k
wJyz5HdcoEb+d/oaoDjq7Zpy3iu9lFc6uux55199QmQ5eiY29yTw1S+6lZgRZq2XNdZ1AYDgr/SE
YYwNHl98h5ZeQa/rh+r4XfEuiAU+TCK72h8q3VJGZDnzQs7ZngyzsHeXZJzA9KMuH5UHsBffMNsA
GJZMoYFL3QRtU6M9/Aes1MU3guvklQgZKILSQjqj2FPseYlgSGDIcpJQ3AOPgz+yQlda22rpEZfd
hSi8MEyr48KxRURHH+CKFgeW0iEPU8DtqX7UTuybCeyvQqww1r/REEXgphaypcXTT3OUM3ECoWqj
1jOXTyFjHluP2cFeRXF3D4FdXyGarYPM+l7WjSNfGz1BryB1ZlpK9p/7qxj3ccC2HTHsOyDry+K4
9a6SsvfhhEvyovKTmiKe0xRvNlS9H15ZFblzqMF8b3ti6RZsR1pl8w4Rm0bZ/W3c1pzAtH2lsN0/
Vm+h+fbkEkj9Bn8SV7apI09bA8PgcSojt/ewsTu8mL3WmKgMa/aOEmem8rJY5AIJEzypuxC00jBF
8ez3ABHfZfjcK0NVvxaXxA/VLGGEqnKG/uY6fsI/fe78LxQ+5oXdUG+3Se0CAwEAAaNCMEAwDwYD
VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ncX+l6o/vY9cdVouslGDDjYr7AwDgYDVR0PAQH/BAQD
AgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBQUfB13HAE4/+qddRxosuej6ip0691x1TPOhwEmSKsxBHi
7zNKpiMdDg1H2DfHb680f0+BazVP6XKlMeJ45/dOlBhbQH3PayFUhuaVevvGyuqcSE5XCV0vrPSl
tJczWNWseanMX/mF+lLFjfiRFOs6DRfQUsJ748JzjkZ4Bjgs6FzaZsT0pPBWGTMpWmWSBUdGSquE
wx4noR8RkpkndZMPvDY7l1ePJlsMu5wP1G4wB9TcXzZoZjmDlicmisjEOf6aIW/Vcobpf2Lll07Q
JNBAsNB1CI69aO4I1258EHBGG3zgiLKecoaZAeO/n0kZtCW+VmWuF2PlHt/o/0elv+EmBYTksMCv
5wiZqAxeJoBF1PhoL5aPruJKHJwWDBNvOIf2u8g0X5IDUXlwpt/L9ZlNec1OvFefQ05rLisY+Gpz
jLrFNe85akEez3GoorKGB1s6yeHvP2UEgEcyRHCVTjFnanRbEEV16rCf0OY1/k6fi8wrkkVbbiVg
hUbN0aqwdmaTd5a+g744tiROJgvM7XpWGuDpWsZkrUx6AEhEL7lAuxM+vhV4nYWBSipX3tUZQ9rb
yltHhoMLP7YNdnhzeSJesYAfz77RP1YQmCuVh6EfnWQUYDksswBVLuT1sw5XxJFBAJw/6KXf6vb/
yPCtbVKoF6ubYfwSUTXkJf2vqmqGOQ==
-----END CERTIFICATE-----
GlobalSign ECC Root CA - R4
===========================
-----BEGIN CERTIFICATE-----
MIIB3DCCAYOgAwIBAgINAgPlfvU/k/2lCSGypjAKBggqhkjOPQQDAjBQMSQwIgYDVQQLExtHbG9i
YWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkds
b2JhbFNpZ24wHhcNMTIxMTEzMDAwMDAwWhcNMzgwMTE5MDMxNDA3WjBQMSQwIgYDVQQLExtHbG9i
YWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkds
b2JhbFNpZ24wWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAAS4xnnTj2wlDp8uORkcA6SumuU5BwkW
ymOxuYb4ilfBV85C+nOh92VC/x7BALJucw7/xyHlGKSq2XE/qNS5zowdo0IwQDAOBgNVHQ8BAf8E
BAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVLB7rUW44kB/+wpu+74zyTyjhNUwCgYI
KoZIzj0EAwIDRwAwRAIgIk90crlgr/HmnKAWBVBfw147bmF0774BxL4YSFlhgjICICadVGNA3jdg
UM/I2O2dgq43mLyjj0xMqTQrbO/7lZsm
-----END CERTIFICATE-----
GTS Root R1
===========
-----BEGIN CERTIFICATE-----
MIIFVzCCAz+gAwIBAgINAgPlk28xsBNJiGuiFzANBgkqhkiG9w0BAQwFADBHMQswCQYDVQQGEwJV
UzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3Qg
UjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UE
ChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0G
CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaM
f/vo27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vXmX7wCl7raKb0
xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7zUjwTcLCeoiKu7rPWRnWr4+w
B7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0PfyblqAj+lug8aJRT7oM6iCsVlgmy4HqMLnXW
nOunVmSPlk9orj2XwoSPwLxAwAtcvfaHszVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk
9+aCEI3oncKKiPo4Zor8Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zq
kUspzBmkMiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOORc92wO1A
K/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYWk70paDPvOmbsB4om3xPX
V2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+DVrNVjzRlwW5y0vtOUucxD/SVRNuJLDW
cfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgFlQIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0T
AQH/BAUwAwEB/zAdBgNVHQ4EFgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQAD
ggIBAJ+qQibbC5u+/x6Wki4+omVKapi6Ist9wTrYggoGxval3sBOh2Z5ofmmWJyq+bXmYOfg6LEe
QkEzCzc9zolwFcq1JKjPa7XSQCGYzyI0zzvFIoTgxQ6KfF2I5DUkzps+GlQebtuyh6f88/qBVRRi
ClmpIgUxPoLW7ttXNLwzldMXG+gnoot7TiYaelpkttGsN/H9oPM47HLwEXWdyzRSjeZ2axfG34ar
J45JK3VmgRAhpuo+9K4l/3wV3s6MJT/KYnAK9y8JZgfIPxz88NtFMN9iiMG1D53Dn0reWVlHxYci
NuaCp+0KueIHoI17eko8cdLiA6EfMgfdG+RCzgwARWGAtQsgWSl4vflVy2PFPEz0tv/bal8xa5me
LMFrUKTX5hgUvYU/Z6tGn6D/Qqc6f1zLXbBwHSs09dR2CQzreExZBfMzQsNhFRAbd03OIozUhfJF
fbdT6u9AWpQKXCBfTkBdYiJ23//OYb2MI3jSNwLgjt7RETeJ9r/tSQdirpLsQBqvFAnZ0E6yove+
7u7Y/9waLd64NnHi/Hm3lCXRSHNboTXns5lndcEZOitHTtNCjv0xyBZm2tIMPNuzjsmhDYAPexZ3
FL//2wmUspO8IFgV6dtxQ/PeEMMA3KgqlbbC1j+Qa3bbbP6MvPJwNQzcmRk13NfIRmPVNnGuV/u3
gm3c
-----END CERTIFICATE-----
GTS Root R3
===========
-----BEGIN CERTIFICATE-----
MIICCTCCAY6gAwIBAgINAgPluILrIPglJ209ZjAKBggqhkjOPQQDAzBHMQswCQYDVQQGEwJVUzEi
MCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMw
HhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZ
R29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjO
PQIBBgUrgQQAIgNiAAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout
736GjOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2ADDL24CejQjBA
MA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTB8Sa6oC2uhYHP0/Eq
Er24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEA9uEglRR7VKOQFhG/hMjqb2sXnh5GmCCbn9MN2azT
L818+FsuVbu/3ZL3pAzcMeGiAjEA/JdmZuVDFhOD3cffL74UOO0BzrEXGhF16b0DjyZ+hOXJYKaV
11RZt+cRLInUue4X
-----END CERTIFICATE-----
GTS Root R4
===========
-----BEGIN CERTIFICATE-----
MIICCTCCAY6gAwIBAgINAgPlwGjvYxqccpBQUjAKBggqhkjOPQQDAzBHMQswCQYDVQQGEwJVUzEi
MCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQw
HhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZ
R29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjO
PQIBBgUrgQQAIgNiAATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzu
hXyiQHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/lxKvRHYqjQjBA
MA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSATNbrdP9JNqPV2Py1
PsVq8JQdjDAKBggqhkjOPQQDAwNpADBmAjEA6ED/g94D9J+uHXqnLrmvT/aDHQ4thQEd0dlq7A/C
r8deVl5c1RxYIigL9zC2L7F8AjEA8GE8p/SgguMh1YQdc4acLa/KNJvxn7kjNuK8YAOdgLOaVsjh
4rsUecrNIdSUtUlD
-----END CERTIFICATE-----
Telia Root CA v2
================
-----BEGIN CERTIFICATE-----
MIIFdDCCA1ygAwIBAgIPAWdfJ9b+euPkrL4JWwWeMA0GCSqGSIb3DQEBCwUAMEQxCzAJBgNVBAYT
AkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2
MjAeFw0xODExMjkxMTU1NTRaFw00MzExMjkxMTU1NTRaMEQxCzAJBgNVBAYTAkZJMRowGAYDVQQK
DBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2MjCCAiIwDQYJKoZI
hvcNAQEBBQADggIPADCCAgoCggIBALLQPwe84nvQa5n44ndp586dpAO8gm2h/oFlH0wnrI4AuhZ7
6zBqAMCzdGh+sq/H1WKzej9Qyow2RCRj0jbpDIX2Q3bVTKFgcmfiKDOlyzG4OiIjNLh9vVYiQJ3q
9HsDrWj8soFPmNB06o3lfc1jw6P23pLCWBnglrvFxKk9pXSW/q/5iaq9lRdU2HhE8Qx3FZLgmEKn
pNaqIJLNwaCzlrI6hEKNfdWV5Nbb6WLEWLN5xYzTNTODn3WhUidhOPFZPY5Q4L15POdslv5e2QJl
tI5c0BE0312/UqeBAMN/mUWZFdUXyApT7GPzmX3MaRKGwhfwAZ6/hLzRUssbkmbOpFPlob/E2wnW
5olWK8jjfN7j/4nlNW4o6GwLI1GpJQXrSPjdscr6bAhR77cYbETKJuFzxokGgeWKrLDiKca5JLNr
RBH0pUPCTEPlcDaMtjNXepUugqD0XBCzYYP2AgWGLnwtbNwDRm41k9V6lS/eINhbfpSQBGq6WT0E
BXWdN6IOLj3rwaRSg/7Qa9RmjtzG6RJOHSpXqhC8fF6CfaamyfItufUXJ63RDolUK5X6wK0dmBR4
M0KGCqlztft0DbcbMBnEWg4cJ7faGND/isgFuvGqHKI3t+ZIpEYslOqodmJHixBTB0hXbOKSTbau
BcvcwUpej6w9GU7C7WB1K9vBykLVAgMBAAGjYzBhMB8GA1UdIwQYMBaAFHKs5DN5qkWH9v2sHZ7W
xy+G2CQ5MB0GA1UdDgQWBBRyrOQzeapFh/b9rB2e1scvhtgkOTAOBgNVHQ8BAf8EBAMCAQYwDwYD
VR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAoDtZpwmUPjaE0n4vOaWWl/oRrfxn83EJ
8rKJhGdEr7nv7ZbsnGTbMjBvZ5qsfl+yqwE2foH65IRe0qw24GtixX1LDoJt0nZi0f6X+J8wfBj5
tFJ3gh1229MdqfDBmgC9bXXYfef6xzijnHDoRnkDry5023X4blMMA8iZGok1GTzTyVR8qPAs5m4H
eW9q4ebqkYJpCh3DflminmtGFZhb069GHWLIzoBSSRE/yQQSwxN8PzuKlts8oB4KtItUsiRnDe+C
y748fdHif64W1lZYudogsYMVoe+KTTJvQS8TUoKU1xrBeKJR3Stwbbca+few4GeXVtt8YVMJAygC
QMez2P2ccGrGKMOF6eLtGpOg3kuYooQ+BXcBlj37tCAPnHICehIv1aO6UXivKitEZU61/Qrowc15
h2Er3oBXRb9n8ZuRXqWk7FlIEA04x7D6w0RtBPV4UBySllva9bguulvP5fBqnUsvWHMtTy3EHD70
sz+rFQ47GUGKpMFXEmZxTPpT41frYpUJnlTd0cI8Vzy9OK2YZLe4A5pTVmBds9hCG1xLEooc6+t9
xnppxyd/pPiL8uSUZodL6ZQHCRJ5irLrdATczvREWeAWysUsWNc8e89ihmpQfTU2Zqf7N+cox9jQ
raVplI/owd8k+BsHMYeB2F326CjYSlKArBPuUBQemMc=
-----END CERTIFICATE-----
D-TRUST BR Root CA 1 2020
=========================
-----BEGIN CERTIFICATE-----
MIIC2zCCAmCgAwIBAgIQfMmPK4TX3+oPyWWa00tNljAKBggqhkjOPQQDAzBIMQswCQYDVQQGEwJE
RTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEJSIFJvb3QgQ0EgMSAy
MDIwMB4XDTIwMDIxMTA5NDUwMFoXDTM1MDIxMTA5NDQ1OVowSDELMAkGA1UEBhMCREUxFTATBgNV
BAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDEgMjAyMDB2MBAG
ByqGSM49AgEGBSuBBAAiA2IABMbLxyjR+4T1mu9CFCDhQ2tuda38KwOE1HaTJddZO0Flax7mNCq7
dPYSzuht56vkPE4/RAiLzRZxy7+SmfSk1zxQVFKQhYN4lGdnoxwJGT11NIXe7WB9xwy0QVK5buXu
QqOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFHOREKv/VbNafAkl1bK6CKBrqx9t
MA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6gPKA6hjhodHRwOi8vY3JsLmQtdHJ1c3Qu
bmV0L2NybC9kLXRydXN0X2JyX3Jvb3RfY2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVj
dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwQlIlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxP
PUQtVHJ1c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjOPQQD
AwNpADBmAjEAlJAtE/rhY/hhY+ithXhUkZy4kzg+GkHaQBZTQgjKL47xPoFWwKrY7RjEsK70Pvom
AjEA8yjixtsrmfu3Ubgko6SUeho/5jbiA1czijDLgsfWFBHVdWNbFJWcHwHP2NVypw87
-----END CERTIFICATE-----
D-TRUST EV Root CA 1 2020
=========================
-----BEGIN CERTIFICATE-----
MIIC2zCCAmCgAwIBAgIQXwJB13qHfEwDo6yWjfv/0DAKBggqhkjOPQQDAzBIMQswCQYDVQQGEwJE
RTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEVWIFJvb3QgQ0EgMSAy
MDIwMB4XDTIwMDIxMTEwMDAwMFoXDTM1MDIxMTA5NTk1OVowSDELMAkGA1UEBhMCREUxFTATBgNV
BAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBFViBSb290IENBIDEgMjAyMDB2MBAG
ByqGSM49AgEGBSuBBAAiA2IABPEL3YZDIBnfl4XoIkqbz52Yv7QFJsnL46bSj8WeeHsxiamJrSc8
ZRCC/N/DnU7wMyPE0jL1HLDfMxddxfCxivnvubcUyilKwg+pf3VlSSowZ/Rk99Yad9rDwpdhQntJ
raOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFH8QARY3OqQo5FD4pPfsazK2/umL
MA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6gPKA6hjhodHRwOi8vY3JsLmQtdHJ1c3Qu
bmV0L2NybC9kLXRydXN0X2V2X3Jvb3RfY2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVj
dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwRVYlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxP
PUQtVHJ1c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjOPQQD
AwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CAy/m0sRtW9XLS/BnR
AjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJbgfM0agPnIjhQW+0ZT0MW
-----END CERTIFICATE-----
DigiCert TLS ECC P384 Root G5
=============================
-----BEGIN CERTIFICATE-----
MIICGTCCAZ+gAwIBAgIQCeCTZaz32ci5PhwLBCou8zAKBggqhkjOPQQDAzBOMQswCQYDVQQGEwJV
UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJjAkBgNVBAMTHURpZ2lDZXJ0IFRMUyBFQ0MgUDM4
NCBSb290IEc1MB4XDTIxMDExNTAwMDAwMFoXDTQ2MDExNDIzNTk1OVowTjELMAkGA1UEBhMCVVMx
FzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMSYwJAYDVQQDEx1EaWdpQ2VydCBUTFMgRUNDIFAzODQg
Um9vdCBHNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABMFEoc8Rl1Ca3iOCNQfN0MsYndLxf3c1Tzvd
lHJS7cI7+Oz6e2tYIOyZrsn8aLN1udsJ7MgT9U7GCh1mMEy7H0cKPGEQQil8pQgO4CLp0zVozptj
n4S1mU1YoI71VOeVyaNCMEAwHQYDVR0OBBYEFMFRRVBZqz7nLFr6ICISB4CIfBFqMA4GA1UdDwEB
/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQCJao1H5+z8blUD2Wds
Jk6Dxv3J+ysTvLd6jLRl0mlpYxNjOyZQLgGheQaRnUi/wr4CMEfDFXuxoJGZSZOoPHzoRgaLLPIx
AJSdYsiJvRmEFOml+wG4DXZDjC5Ty3zfDBeWUA==
-----END CERTIFICATE-----
DigiCert TLS RSA4096 Root G5
============================
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIQCPm0eKj6ftpqMzeJ3nzPijANBgkqhkiG9w0BAQwFADBNMQswCQYDVQQG
EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0
MDk2IFJvb3QgRzUwHhcNMjEwMTE1MDAwMDAwWhcNNDYwMTE0MjM1OTU5WjBNMQswCQYDVQQGEwJV
UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0MDk2
IFJvb3QgRzUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz0PTJeRGd/fxmgefM1eS8
7IE+ajWOLrfn3q/5B03PMJ3qCQuZvWxX2hhKuHisOjmopkisLnLlvevxGs3npAOpPxG02C+JFvuU
AT27L/gTBaF4HI4o4EXgg/RZG5Wzrn4DReW+wkL+7vI8toUTmDKdFqgpwgscONyfMXdcvyej/Ces
tyu9dJsXLfKB2l2w4SMXPohKEiPQ6s+d3gMXsUJKoBZMpG2T6T867jp8nVid9E6P/DsjyG244gXa
zOvswzH016cpVIDPRFtMbzCe88zdH5RDnU1/cHAN1DrRN/BsnZvAFJNY781BOHW8EwOVfH/jXOnV
DdXifBBiqmvwPXbzP6PosMH976pXTayGpxi0KcEsDr9kvimM2AItzVwv8n/vFfQMFawKsPHTDU9q
TXeXAaDxZre3zu/O7Oyldcqs4+Fj97ihBMi8ez9dLRYiVu1ISf6nL3kwJZu6ay0/nTvEF+cdLvvy
z6b84xQslpghjLSR6Rlgg/IwKwZzUNWYOwbpx4oMYIwo+FKbbuH2TbsGJJvXKyY//SovcfXWJL5/
MZ4PbeiPT02jP/816t9JXkGPhvnxd3lLG7SjXi/7RgLQZhNeXoVPzthwiHvOAbWWl9fNff2C+MIk
wcoBOU+NosEUQB+cZtUMCUbW8tDRSHZWOkPLtgoRObqME2wGtZ7P6wIDAQABo0IwQDAdBgNVHQ4E
FgQUUTMc7TZArxfTJc1paPKvTiM+s0EwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8w
DQYJKoZIhvcNAQEMBQADggIBAGCmr1tfV9qJ20tQqcQjNSH/0GEwhJG3PxDPJY7Jv0Y02cEhJhxw
GXIeo8mH/qlDZJY6yFMECrZBu8RHANmfGBg7sg7zNOok992vIGCukihfNudd5N7HPNtQOa27PShN
lnx2xlv0wdsUpasZYgcYQF+Xkdycx6u1UQ3maVNVzDl92sURVXLFO4uJ+DQtpBflF+aZfTCIITfN
MBc9uPK8qHWgQ9w+iUuQrm0D4ByjoJYJu32jtyoQREtGBzRj7TG5BO6jm5qu5jF49OokYTurWGT/
u4cnYiWB39yhL/btp/96j1EuMPikAdKFOV8BmZZvWltwGUb+hmA+rYAQCd05JS9Yf7vSdPD3Rh9G
OUrYU9DzLjtxpdRv/PNn5AeP3SYZ4Y1b+qOTEZvpyDrDVWiakuFSdjjo4bq9+0/V77PnSIMx8IIh
47a+p6tv75/fTM8BuGJqIz3nCU2AG3swpMPdB380vqQmsvZB6Akd4yCYqjdP//fx4ilwMUc/dNAU
FvohigLVigmUdy7yWSiLfFCSCmZ4OIN1xLVaqBHG5cGdZlXPU8Sv13WFqUITVuwhd4GTWgzqltlJ
yqEI8pc7bZsEGCREjnwB8twl2F6GmrE52/WRMmrRpnCKovfepEWFJqgejF0pW8hL2JpqA15w8oVP
bEtoL8pU9ozaMv7Da4M/OMZ+
-----END CERTIFICATE-----
Certainly Root R1
=================
-----BEGIN CERTIFICATE-----
MIIFRzCCAy+gAwIBAgIRAI4P+UuQcWhlM1T01EQ5t+AwDQYJKoZIhvcNAQELBQAwPTELMAkGA1UE
BhMCVVMxEjAQBgNVBAoTCUNlcnRhaW5seTEaMBgGA1UEAxMRQ2VydGFpbmx5IFJvb3QgUjEwHhcN
MjEwNDAxMDAwMDAwWhcNNDYwNDAxMDAwMDAwWjA9MQswCQYDVQQGEwJVUzESMBAGA1UEChMJQ2Vy
dGFpbmx5MRowGAYDVQQDExFDZXJ0YWlubHkgUm9vdCBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIP
ADCCAgoCggIBANA21B/q3avk0bbm+yLA3RMNansiExyXPGhjZjKcA7WNpIGD2ngwEc/csiu+kr+O
5MQTvqRoTNoCaBZ0vrLdBORrKt03H2As2/X3oXyVtwxwhi7xOu9S98zTm/mLvg7fMbedaFySpvXl
8wo0tf97ouSHocavFwDvA5HtqRxOcT3Si2yJ9HiG5mpJoM610rCrm/b01C7jcvk2xusVtyWMOvwl
DbMicyF0yEqWYZL1LwsYpfSt4u5BvQF5+paMjRcCMLT5r3gajLQ2EBAHBXDQ9DGQilHFhiZ5shGI
XsXwClTNSaa/ApzSRKft43jvRl5tcdF5cBxGX1HpyTfcX35pe0HfNEXgO4T0oYoKNp43zGJS4YkN
KPl6I7ENPT2a/Z2B7yyQwHtETrtJ4A5KVpK8y7XdeReJkd5hiXSSqOMyhb5OhaRLWcsrxXiOcVTQ
AjeZjOVJ6uBUcqQRBi8LjMFbvrWhsFNunLhgkR9Za/kt9JQKl7XsxXYDVBtlUrpMklZRNaBA2Cnb
rlJ2Oy0wQJuK0EJWtLeIAaSHO1OWzaMWj/Nmqhexx2DgwUMFDO6bW2BvBlyHWyf5QBGenDPBt+U1
VwV/J84XIIwc/PH72jEpSe31C4SnT8H2TsIonPru4K8H+zMReiFPCyEQtkA6qyI6BJyLm4SGcprS
p6XEtHWRqSsjAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
DgQWBBTgqj8ljZ9EXME66C6ud0yEPmcM9DANBgkqhkiG9w0BAQsFAAOCAgEAuVevuBLaV4OPaAsz
HQNTVfSVcOQrPbA56/qJYv331hgELyE03fFo8NWWWt7CgKPBjcZq91l3rhVkz1t5BXdm6ozTaw3d
8VkswTOlMIAVRQdFGjEitpIAq5lNOo93r6kiyi9jyhXWx8bwPWz8HA2YEGGeEaIi1wrykXprOQ4v
MMM2SZ/g6Q8CRFA3lFV96p/2O7qUpUzpvD5RtOjKkjZUbVwlKNrdrRT90+7iIgXr0PK3aBLXWopB
GsaSpVo7Y0VPv+E6dyIvXL9G+VoDhRNCX8reU9ditaY1BMJH/5n9hN9czulegChB8n3nHpDYT3Y+
gjwN/KUD+nsa2UUeYNrEjvn8K8l7lcUq/6qJ34IxD3L/DCfXCh5WAFAeDJDBlrXYFIW7pw0WwfgH
JBu6haEaBQmAupVjyTrsJZ9/nbqkRxWbRHDxakvWOF5D8xh+UG7pWijmZeZ3Gzr9Hb4DJqPb1OG7
fpYnKx3upPvaJVQTA945xsMfTZDsjxtK0hzthZU4UHlG1sGQUDGpXJpuHfUzVounmdLyyCwzk5Iw
x06MZTMQZBf9JBeW0Y3COmor6xOLRPIh80oat3df1+2IpHLlOR+Vnb5nwXARPbv0+Em34yaXOp/S
X3z7wJl8OSngex2/DaeP0ik0biQVy96QXr8axGbqwua6OV+KmalBWQewLK8=
-----END CERTIFICATE-----
Certainly Root E1
=================
-----BEGIN CERTIFICATE-----
MIIB9zCCAX2gAwIBAgIQBiUzsUcDMydc+Y2aub/M+DAKBggqhkjOPQQDAzA9MQswCQYDVQQGEwJV
UzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0YWlubHkgUm9vdCBFMTAeFw0yMTA0
MDEwMDAwMDBaFw00NjA0MDEwMDAwMDBaMD0xCzAJBgNVBAYTAlVTMRIwEAYDVQQKEwlDZXJ0YWlu
bHkxGjAYBgNVBAMTEUNlcnRhaW5seSBSb290IEUxMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE3m/4
fxzf7flHh4axpMCK+IKXgOqPyEpeKn2IaKcBYhSRJHpcnqMXfYqGITQYUBsQ3tA3SybHGWCA6TS9
YBk2QNYphwk8kXr2vBMj3VlOBF7PyAIcGFPBMdjaIOlEjeR2o0IwQDAOBgNVHQ8BAf8EBAMCAQYw
DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ygYy2R17ikq6+2uI1g4hevIIgcwCgYIKoZIzj0E
AwMDaAAwZQIxALGOWiDDshliTd6wT99u0nCK8Z9+aozmut6Dacpps6kFtZaSF4fC0urQe87YQVt8
rgIwRt7qy12a7DLCZRawTDBcMPPaTnOGBtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR
-----END CERTIFICATE-----
Security Communication ECC RootCA1
==================================
-----BEGIN CERTIFICATE-----
MIICODCCAb6gAwIBAgIJANZdm7N4gS7rMAoGCCqGSM49BAMDMGExCzAJBgNVBAYTAkpQMSUwIwYD
VQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMSswKQYDVQQDEyJTZWN1cml0eSBDb21t
dW5pY2F0aW9uIEVDQyBSb290Q0ExMB4XDTE2MDYxNjA1MTUyOFoXDTM4MDExODA1MTUyOFowYTEL
MAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xKzApBgNV
BAMTIlNlY3VyaXR5IENvbW11bmljYXRpb24gRUNDIFJvb3RDQTEwdjAQBgcqhkjOPQIBBgUrgQQA
IgNiAASkpW9gAwPDvTH00xecK4R1rOX9PVdu12O/5gSJko6BnOPpR27KkBLIE+CnnfdldB9sELLo
5OnvbYUymUSxXv3MdhDYW72ixvnWQuRXdtyQwjWpS4g8EkdtXP9JTxpKULGjQjBAMB0GA1UdDgQW
BBSGHOf+LaVKiwj+KBH6vqNm+GBZLzAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAK
BggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3L
snNdo4gIxwwCMQDAqy0Obe0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70e
N9k=
-----END CERTIFICATE-----
BJCA Global Root CA1
====================
-----BEGIN CERTIFICATE-----
MIIFdDCCA1ygAwIBAgIQVW9l47TZkGobCdFsPsBsIDANBgkqhkiG9w0BAQsFADBUMQswCQYDVQQG
EwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJVFkxHTAbBgNVBAMMFEJK
Q0EgR2xvYmFsIFJvb3QgQ0ExMB4XDTE5MTIxOTAzMTYxN1oXDTQ0MTIxMjAzMTYxN1owVDELMAkG
A1UEBhMCQ04xJjAkBgNVBAoMHUJFSUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQD
DBRCSkNBIEdsb2JhbCBSb290IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPFm
CL3ZxRVhy4QEQaVpN3cdwbB7+sN3SJATcmTRuHyQNZ0YeYjjlwE8R4HyDqKYDZ4/N+AZspDyRhyS
sTphzvq3Rp4Dhtczbu33RYx2N95ulpH3134rhxfVizXuhJFyV9xgw8O558dnJCNPYwpj9mZ9S1Wn
P3hkSWkSl+BMDdMJoDIwOvqfwPKcxRIqLhy1BDPapDgRat7GGPZHOiJBhyL8xIkoVNiMpTAK+BcW
yqw3/XmnkRd4OJmtWO2y3syJfQOcs4ll5+M7sSKGjwZteAf9kRJ/sGsciQ35uMt0WwfCyPQ10WRj
eulumijWML3mG90Vr4TqnMfK9Q7q8l0ph49pczm+LiRvRSGsxdRpJQaDrXpIhRMsDQa4bHlW/KNn
MoH1V6XKV0Jp6VwkYe/iMBhORJhVb3rCk9gZtt58R4oRTklH2yiUAguUSiz5EtBP6DF+bHq/pj+b
OT0CFqMYs2esWz8sgytnOYFcuX6U1WTdno9uruh8W7TXakdI136z1C2OVnZOz2nxbkRs1CTqjSSh
GL+9V/6pmTW12xB3uD1IutbB5/EjPtffhZ0nPNRAvQoMvfXnjSXWgXSHRtQpdaJCbPdzied9v3pK
H9MiyRVVz99vfFXQpIsHETdfg6YmV6YBW37+WGgHqel62bno/1Afq8K0wM7o6v0PvY1NuLxxAgMB
AAGjQjBAMB0GA1UdDgQWBBTF7+3M2I0hxkjk49cULqcWk+WYATAPBgNVHRMBAf8EBTADAQH/MA4G
A1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAUoKsITQfI/Ki2Pm4rzc2IInRNwPWaZ+4
YRC6ojGYWUfo0Q0lHhVBDOAqVdVXUsv45Mdpox1NcQJeXyFFYEhcCY5JEMEE3KliawLwQ8hOnThJ
dMkycFRtwUf8jrQ2ntScvd0g1lPJGKm1Vrl2i5VnZu69mP6u775u+2D2/VnGKhs/I0qUJDAnyIm8
60Qkmss9vk/Ves6OF8tiwdneHg56/0OGNFK8YT88X7vZdrRTvJez/opMEi4r89fO4aL/3Xtw+zuh
TaRjAv04l5U/BXCga99igUOLtFkNSoxUnMW7gZ/NfaXvCyUeOiDbHPwfmGcCCtRzRBPbUYQaVQNW
4AB+dAb/OMRyHdOoP2gxXdMJxy6MW2Pg6Nwe0uxhHvLe5e/2mXZgLR6UcnHGCyoyx5JO1UbXHfmp
GQrI+pXObSOYqgs4rZpWDW+N8TEAiMEXnM0ZNjX+VVOg4DwzX5Ze4jLp3zO7Bkqp2IRzznfSxqxx
4VyjHQy7Ct9f4qNx2No3WqB4K/TUfet27fJhcKVlmtOJNBir+3I+17Q9eVzYH6Eze9mCUAyTF6ps
3MKCuwJXNq+YJyo5UOGwifUll35HaBC07HPKs5fRJNz2YqAo07WjuGS3iGJCz51TzZm+ZGiPTx4S
SPfSKcOYKMryMguTjClPPGAyzQWWYezyr/6zcCwupvI=
-----END CERTIFICATE-----
BJCA Global Root CA2
====================
-----BEGIN CERTIFICATE-----
MIICJTCCAaugAwIBAgIQLBcIfWQqwP6FGFkGz7RK6zAKBggqhkjOPQQDAzBUMQswCQYDVQQGEwJD
TjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJVFkxHTAbBgNVBAMMFEJKQ0Eg
R2xvYmFsIFJvb3QgQ0EyMB4XDTE5MTIxOTAzMTgyMVoXDTQ0MTIxMjAzMTgyMVowVDELMAkGA1UE
BhMCQ04xJjAkBgNVBAoMHUJFSUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRC
SkNBIEdsb2JhbCBSb290IENBMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABJ3LgJGNU2e1uVCxA/jl
SR9BIgmwUVJY1is0j8USRhTFiy8shP8sbqjV8QnjAyEUxEM9fMEsxEtqSs3ph+B99iK++kpRuDCK
/eHeGBIK9ke35xe/J4rUQUyWPGCWwf0VHKNCMEAwHQYDVR0OBBYEFNJKsVF/BvDRgh9Obl+rg/xI
1LCRMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2gAMGUCMBq8
W9f+qdJUDkpd0m2xQNz0Q9XSSpkZElaA94M04TVOSG0ED1cxMDAtsaqdAzjbBgIxAMvMh1PLet8g
UXOQwKhbYdDFUDn9hf7B43j4ptZLvZuHjw/l1lOWqzzIQNph91Oj9w==
-----END CERTIFICATE-----
Sectigo Public Server Authentication Root E46
=============================================
-----BEGIN CERTIFICATE-----
MIICOjCCAcGgAwIBAgIQQvLM2htpN0RfFf51KBC49DAKBggqhkjOPQQDAzBfMQswCQYDVQQGEwJH
QjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBTZXJ2
ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwHhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5
WjBfMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0
aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUr
gQQAIgNiAAR2+pmpbiDt+dd34wc7qNs9Xzjoq1WmVk/WSOrsfy2qw7LFeeyZYX8QeccCWvkEN/U0
NSt3zn8gj1KjAIns1aeibVvjS5KToID1AZTc8GgHHs3u/iVStSBDHBv+6xnOQ6OjQjBAMB0GA1Ud
DgQWBBTRItpMWfFLXyY4qp3W7usNw/upYTAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB
/zAKBggqhkjOPQQDAwNnADBkAjAn7qRaqCG76UeXlImldCBteU/IvZNeWBj7LRoAasm4PdCkT0RH
lAFWovgzJQxC36oCMB3q4S6ILuH5px0CMk7yn2xVdOOurvulGu7t0vzCAxHrRVxgED1cf5kDW21U
SAGKcw==
-----END CERTIFICATE-----
Sectigo Public Server Authentication Root R46
=============================================
-----BEGIN CERTIFICATE-----
MIIFijCCA3KgAwIBAgIQdY39i658BwD6qSWn4cetFDANBgkqhkiG9w0BAQwFADBfMQswCQYDVQQG
EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBT
ZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwHhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1
OTU5WjBfMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1T
ZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwggIiMA0GCSqGSIb3
DQEBAQUAA4ICDwAwggIKAoICAQCTvtU2UnXYASOgHEdCSe5jtrch/cSV1UgrJnwUUxDaef0rty2k
1Cz66jLdScK5vQ9IPXtamFSvnl0xdE8H/FAh3aTPaE8bEmNtJZlMKpnzSDBh+oF8HqcIStw+Kxwf
GExxqjWMrfhu6DtK2eWUAtaJhBOqbchPM8xQljeSM9xfiOefVNlI8JhD1mb9nxc4Q8UBUQvX4yMP
FF1bFOdLvt30yNoDN9HWOaEhUTCDsG3XME6WW5HwcCSrv0WBZEMNvSE6Lzzpng3LILVCJ8zab5vu
ZDCQOc2TZYEhMbUjUDM3IuM47fgxMMxF/mL50V0yeUKH32rMVhlATc6qu/m1dkmU8Sf4kaWD5Qaz
Yw6A3OASVYCmO2a0OYctyPDQ0RTp5A1NDvZdV3LFOxxHVp3i1fuBYYzMTYCQNFu31xR13NgESJ/A
wSiItOkcyqex8Va3e0lMWeUgFaiEAin6OJRpmkkGj80feRQXEgyDet4fsZfu+Zd4KKTIRJLpfSYF
plhym3kT2BFfrsU4YjRosoYwjviQYZ4ybPUHNs2iTG7sijbt8uaZFURww3y8nDnAtOFr94MlI1fZ
EoDlSfB1D++N6xybVCi0ITz8fAr/73trdf+LHaAZBav6+CuBQug4urv7qv094PPK306Xlynt8xhW
6aWWrL3DkJiy4Pmi1KZHQ3xtzwIDAQABo0IwQDAdBgNVHQ4EFgQUVnNYZJX5khqwEioEYnmhQBWI
IUkwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAC9c
mTz8Bl6MlC5w6tIyMY208FHVvArzZJ8HXtXBc2hkeqK5Duj5XYUtqDdFqij0lgVQYKlJfp/imTYp
E0RHap1VIDzYm/EDMrraQKFz6oOht0SmDpkBm+S8f74TlH7Kph52gDY9hAaLMyZlbcp+nv4fjFg4
exqDsQ+8FxG75gbMY/qB8oFM2gsQa6H61SilzwZAFv97fRheORKkU55+MkIQpiGRqRxOF3yEvJ+M
0ejf5lG5Nkc/kLnHvALcWxxPDkjBJYOcCj+esQMzEhonrPcibCTRAUH4WAP+JWgiH5paPHxsnnVI
84HxZmduTILA7rpXDhjvLpr3Etiga+kFpaHpaPi8TD8SHkXoUsCjvxInebnMMTzD9joiFgOgyY9m
pFuiTdaBJQbpdqQACj7LzTWb4OE4y2BThihCQRxEV+ioratF4yUQvNs+ZUH7G6aXD+u5dHn5Hrwd
Vw1Hr8Mvn4dGp+smWg9WY7ViYG4A++MnESLn/pmPNPW56MORcr3Ywx65LvKRRFHQV80MNNVIIb/b
E/FmJUNS0nAiNs2fxBx1IK1jcmMGDw4nztJqDby1ORrp0XZ60Vzk50lJLVU3aPAaOpg+VBeHVOmm
J1CJeyAvP/+/oYtKR5j/K3tJPsMpRmAYQqszKbrAKbkTidOIijlBO8n9pu0f9GBj39ItVQGL
-----END CERTIFICATE-----
SSL.com TLS RSA Root CA 2022
============================
-----BEGIN CERTIFICATE-----
MIIFiTCCA3GgAwIBAgIQb77arXO9CEDii02+1PdbkTANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQG
EwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxTU0wuY29tIFRMUyBSU0Eg
Um9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzQyMloXDTQ2MDgxOTE2MzQyMVowTjELMAkGA1UEBhMC
VVMxGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgUlNBIFJv
b3QgQ0EgMjAyMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANCkCXJPQIgSYT41I57u
9nTPL3tYPc48DRAokC+X94xI2KDYJbFMsBFMF3NQ0CJKY7uB0ylu1bUJPiYYf7ISf5OYt6/wNr/y
7hienDtSxUcZXXTzZGbVXcdotL8bHAajvI9AI7YexoS9UcQbOcGV0insS657Lb85/bRi3pZ7Qcac
oOAGcvvwB5cJOYF0r/c0WRFXCsJbwST0MXMwgsadugL3PnxEX4MN8/HdIGkWCVDi1FW24IBydm5M
R7d1VVm0U3TZlMZBrViKMWYPHqIbKUBOL9975hYsLfy/7PO0+r4Y9ptJ1O4Fbtk085zx7AGL0SDG
D6C1vBdOSHtRwvzpXGk3R2azaPgVKPC506QVzFpPulJwoxJF3ca6TvvC0PeoUidtbnm1jPx7jMEW
TO6Af77wdr5BUxIzrlo4QqvXDz5BjXYHMtWrifZOZ9mxQnUjbvPNQrL8VfVThxc7wDNY8VLS+YCk
8OjwO4s4zKTGkH8PnP2L0aPP2oOnaclQNtVcBdIKQXTbYxE3waWglksejBYSd66UNHsef8JmAOSq
g+qKkK3ONkRN0VHpvB/zagX9wHQfJRlAUW7qglFA35u5CCoGAtUjHBPW6dvbxrB6y3snm/vg1UYk
7RBLY0ulBY+6uB0rpvqR4pJSvezrZ5dtmi2fgTIFZzL7SAg/2SW4BCUvAgMBAAGjYzBhMA8GA1Ud
EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU+y437uOEeicuzRk1sTN8/9REQrkwHQYDVR0OBBYEFPsu
N+7jhHonLs0ZNbEzfP/UREK5MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAjYlt
hEUY8U+zoO9opMAdrDC8Z2awms22qyIZZtM7QbUQnRC6cm4pJCAcAZli05bg4vsMQtfhWsSWTVTN
j8pDU/0quOr4ZcoBwq1gaAafORpR2eCNJvkLTqVTJXojpBzOCBvfR4iyrT7gJ4eLSYwfqUdYe5by
iB0YrrPRpgqU+tvT5TgKa3kSM/tKWTcWQA673vWJDPFs0/dRa1419dvAJuoSc06pkZCmF8NsLzjU
o3KUQyxi4U5cMj29TH0ZR6LDSeeWP4+a0zvkEdiLA9z2tmBVGKaBUfPhqBVq6+AL8BQx1rmMRTqo
ENjwuSfr98t67wVylrXEj5ZzxOhWc5y8aVFjvO9nHEMaX3cZHxj4HCUp+UmZKbaSPaKDN7Egkaib
MOlqbLQjk2UEqxHzDh1TJElTHaE/nUiSEeJ9DU/1172iWD54nR4fK/4huxoTtrEoZP2wAgDHbICi
vRZQIA9ygV/MlP+7mea6kMvq+cYMwq7FGc4zoWtcu358NFcXrfA/rs3qr5nsLFR+jM4uElZI7xc7
P0peYNLcdDa8pUNjyw9bowJWCZ4kLOGGgYz+qxcs+sjiMho6/4UIyYOf8kpIEFR3N+2ivEC+5BB0
9+Rbu7nzifmPQdjH5FCQNYA+HLhNkNPU98OwoX6EyneSMSy4kLGCenROmxMmtNVQZlR4rmA=
-----END CERTIFICATE-----
SSL.com TLS ECC Root CA 2022
============================
-----BEGIN CERTIFICATE-----
MIICOjCCAcCgAwIBAgIQFAP1q/s3ixdAW+JDsqXRxDAKBggqhkjOPQQDAzBOMQswCQYDVQQGEwJV
UzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxTU0wuY29tIFRMUyBFQ0MgUm9v
dCBDQSAyMDIyMB4XDTIyMDgyNTE2MzM0OFoXDTQ2MDgxOTE2MzM0N1owTjELMAkGA1UEBhMCVVMx
GDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgRUNDIFJvb3Qg
Q0EgMjAyMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABEUpNXP6wrgjzhR9qLFNoFs27iosU8NgCTWy
JGYmacCzldZdkkAZDsalE3D07xJRKF3nzL35PIXBz5SQySvOkkJYWWf9lCcQZIxPBLFNSeR7T5v1
5wj4A4j3p8OSSxlUgaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSJjy+j6CugFFR7
81a4Jl9nOAuc0DAdBgNVHQ4EFgQUiY8vo+groBRUe/NWuCZfZzgLnNAwDgYDVR0PAQH/BAQDAgGG
MAoGCCqGSM49BAMDA2gAMGUCMFXjIlbp15IkWE8elDIPDAI2wv2sdDJO4fscgIijzPvX6yv/N33w
7deedWo1dlJF4AIxAMeNb0Igj762TVntd00pxCAgRWSGOlDGxK0tk/UYfXLtqc/ErFc2KAhl3zx5
Zn6g6g==
-----END CERTIFICATE-----
Atos TrustedRoot Root CA ECC TLS 2021
=====================================
-----BEGIN CERTIFICATE-----
MIICFTCCAZugAwIBAgIQPZg7pmY9kGP3fiZXOATvADAKBggqhkjOPQQDAzBMMS4wLAYDVQQDDCVB
dG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgRUNDIFRMUyAyMDIxMQ0wCwYDVQQKDARBdG9zMQswCQYD
VQQGEwJERTAeFw0yMTA0MjIwOTI2MjNaFw00MTA0MTcwOTI2MjJaMEwxLjAsBgNVBAMMJUF0b3Mg
VHJ1c3RlZFJvb3QgUm9vdCBDQSBFQ0MgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYT
AkRFMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEloZYKDcKZ9Cg3iQZGeHkBQcfl+3oZIK59sRxUM6K
DP/XtXa7oWyTbIOiaG6l2b4siJVBzV3dscqDY4PMwL502eCdpO5KTlbgmClBk1IQ1SQ4AjJn8ZQS
b+/Xxd4u/RmAo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR2KCXWfeBmmnoJsmo7jjPX
NtNPojAOBgNVHQ8BAf8EBAMCAYYwCgYIKoZIzj0EAwMDaAAwZQIwW5kp85wxtolrbNa9d+F851F+
uDrNozZffPc8dz7kUK2o59JZDCaOMDtuCCrCp1rIAjEAmeMM56PDr9NJLkaCI2ZdyQAUEv049OGY
a3cpetskz2VAv9LcjBHo9H1/IISpQuQo
-----END CERTIFICATE-----
Atos TrustedRoot Root CA RSA TLS 2021
=====================================
-----BEGIN CERTIFICATE-----
MIIFZDCCA0ygAwIBAgIQU9XP5hmTC/srBRLYwiqipDANBgkqhkiG9w0BAQwFADBMMS4wLAYDVQQD
DCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgUlNBIFRMUyAyMDIxMQ0wCwYDVQQKDARBdG9zMQsw
CQYDVQQGEwJERTAeFw0yMTA0MjIwOTIxMTBaFw00MTA0MTcwOTIxMDlaMEwxLjAsBgNVBAMMJUF0
b3MgVHJ1c3RlZFJvb3QgUm9vdCBDQSBSU0EgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNV
BAYTAkRFMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtoAOxHm9BYx9sKOdTSJNy/BB
l01Z4NH+VoyX8te9j2y3I49f1cTYQcvyAh5x5en2XssIKl4w8i1mx4QbZFc4nXUtVsYvYe+W/CBG
vevUez8/fEc4BKkbqlLfEzfTFRVOvV98r61jx3ncCHvVoOX3W3WsgFWZkmGbzSoXfduP9LVq6hdK
ZChmFSlsAvFr1bqjM9xaZ6cF4r9lthawEO3NUDPJcFDsGY6wx/J0W2tExn2WuZgIWWbeKQGb9Cpt
0xU6kGpn8bRrZtkh68rZYnxGEFzedUlnnkL5/nWpo63/dgpnQOPF943HhZpZnmKaau1Fh5hnstVK
PNe0OwANwI8f4UDErmwh3El+fsqyjW22v5MvoVw+j8rtgI5Y4dtXz4U2OLJxpAmMkokIiEjxQGMY
sluMWuPD0xeqqxmjLBvk1cbiZnrXghmmOxYsL3GHX0WelXOTwkKBIROW1527k2gV+p2kHYzygeBY
Br3JtuP2iV2J+axEoctr+hbxx1A9JNr3w+SH1VbxT5Aw+kUJWdo0zuATHAR8ANSbhqRAvNncTFd+
rrcztl524WWLZt+NyteYr842mIycg5kDcPOvdO3GDjbnvezBc6eUWsuSZIKmAMFwoW4sKeFYV+xa
fJlrJaSQOoD0IJ2azsct+bJLKZWD6TWNp0lIpw9MGZHQ9b8Q4HECAwEAAaNCMEAwDwYDVR0TAQH/
BAUwAwEB/zAdBgNVHQ4EFgQUdEmZ0f+0emhFdcN+tNzMzjkz2ggwDgYDVR0PAQH/BAQDAgGGMA0G
CSqGSIb3DQEBDAUAA4ICAQAjQ1MkYlxt/T7Cz1UAbMVWiLkO3TriJQ2VSpfKgInuKs1l+NsW4AmS
4BjHeJi78+xCUvuppILXTdiK/ORO/auQxDh1MoSf/7OwKwIzNsAQkG8dnK/haZPso0UvFJ/1TCpl
Q3IM98P4lYsU84UgYt1UU90s3BiVaU+DR3BAM1h3Egyi61IxHkzJqM7F78PRreBrAwA0JrRUITWX
AdxfG/F851X6LWh3e9NpzNMOa7pNdkTWwhWaJuywxfW70Xp0wmzNxbVe9kzmWy2B27O3Opee7c9G
slA9hGCZcbUztVdF5kJHdWoOsAgMrr3e97sPWD2PAzHoPYJQyi9eDF20l74gNAf0xBLh7tew2Vkt
afcxBPTy+av5EzH4AXcOPUIjJsyacmdRIXrMPIWo6iFqO9taPKU0nprALN+AnCng33eU0aKAQv9q
TFsR0PXNor6uzFFcw9VUewyu1rkGd4Di7wcaaMxZUa1+XGdrudviB0JbuAEFWDlN5LuYo7Ey7Nmj
1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5dDTedk+SKlOxJTnbPP/l
PqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcEoji2jbDwN/zIIX8/syQbPYtuzE2wFg2W
HYMfRsCbvUOZ58SWLs5fyQ==
-----END CERTIFICATE-----
TrustAsia Global Root CA G3
===========================
-----BEGIN CERTIFICATE-----
MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEMBQAwWjELMAkG
A1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xJDAiBgNVBAMM
G1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAeFw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEw
MTlaMFoxCzAJBgNVBAYTAkNOMSUwIwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMu
MSQwIgYDVQQDDBtUcnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUA
A4ICDwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNST1QY4Sxz
lZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqKAtCWHwDNBSHvBm3dIZwZ
Q0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/V
P68czH5GX6zfZBCK70bwkPAPLfSIC7Epqq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1Ag
dB4SQXMeJNnKziyhWTXAyB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm
9WAPzJMshH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gXzhqc
D0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAvkV34PmVACxmZySYg
WmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msTf9FkPz2ccEblooV7WIQn3MSAPmea
mseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jAuPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCF
TIcQcf+eQxuulXUtgQIDAQABo2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj
7zjKsK5Xf/IhMBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E
BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4wM8zAQLpw6o1
D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2XFNFV1pF1AWZLy4jVe5jaN/T
G3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNj
duMNhXJEIlU/HHzp/LgV6FL6qj6jITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstl
cHboCoWASzY9M/eVVHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys
+TIxxHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1onAX1daBli
2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d7XB4tmBZrOFdRWOPyN9y
aFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2NtjjgKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsAS
ZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV+Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFR
JQJ6+N1rZdVtTTDIZbpoFGWsJwt0ivKH
-----END CERTIFICATE-----
TrustAsia Global Root CA G4
===========================
-----BEGIN CERTIFICATE-----
MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMwWjELMAkGA1UE
BhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xJDAiBgNVBAMMG1Ry
dXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0yMTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJa
MFoxCzAJBgNVBAYTAkNOMSUwIwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQw
IgYDVQQDDBtUcnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
AATxs8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbwLxYI+hW8
m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJijYzBhMA8GA1UdEwEB/wQF
MAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mDpm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/
pDHel4NZg6ZvccveMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AA
bbd+NvBNEU/zy4k6LHiRUKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xk
dUfFVZDj/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA==
-----END CERTIFICATE-----
Telekom Security TLS ECC Root 2020
==================================
-----BEGIN CERTIFICATE-----
MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQswCQYDVQQGEwJE
RTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBHbWJIMSswKQYDVQQDDCJUZWxl
a29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIwMB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIz
NTk1OVowYzELMAkGA1UEBhMCREUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkg
R21iSDErMCkGA1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqG
SM49AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/OtdKPD/M1
2kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDPf8iAC8GXs7s1J8nCG6NC
MEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6fMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0P
AQH/BAQDAgEGMAoGCCqGSM49BAMDA2cAMGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZ
Mo7k+5Dck2TOrbRBR2Diz6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdU
ga/sf+Rn27iQ7t0l
-----END CERTIFICATE-----
Telekom Security TLS RSA Root 2023
==================================
-----BEGIN CERTIFICATE-----
MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBjMQswCQYDVQQG
EwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBHbWJIMSswKQYDVQQDDCJU
ZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAyMDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMy
NzIzNTk1OVowYzELMAkGA1UEBhMCREUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJp
dHkgR21iSDErMCkGA1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIw
DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9cUD/h3VC
KSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHVcp6R+SPWcHu79ZvB7JPP
GeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMAU6DksquDOFczJZSfvkgdmOGjup5czQRx
UX11eKvzWarE4GC+j4NSuHUaQTXtvPM6Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWo
l8hHD/BeEIvnHRz+sTugBTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9
FIS3R/qy8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73Jco4v
zLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg8qKrBC7m8kwOFjQg
rIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8rFEz0ciD0cmfHdRHNCk+y7AO+oML
KFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7S
WWO/gLCMk3PLNaaZlSJhZQNg+y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNV
HQ4EFgQUtqeXgj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2
p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQpGv7qHBFfLp+
sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm9S3ul0A8Yute1hTWjOKWi0Fp
kzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErwM807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy
/SKE8YXJN3nptT+/XOR0so8RYgDdGGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4
mZqTuXNnQkYRIer+CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtz
aL1txKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+w6jv/naa
oqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aKL4x35bcF7DvB7L6Gs4a8
wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+ljX273CXE2whJdV/LItM3z7gLfEdxquVeE
HVlNjM7IDiPCtyaaEBRx/pOyiriA8A4QntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0
o82bNSQ3+pCTE4FCxpgmdTdmQRCsu/WU48IxK63nI1bMNSWSs1A=
-----END CERTIFICATE-----
TWCA CYBER Root CA
==================
-----BEGIN CERTIFICATE-----
MIIFjTCCA3WgAwIBAgIQQAE0jMIAAAAAAAAAATzyxjANBgkqhkiG9w0BAQwFADBQMQswCQYDVQQG
EwJUVzESMBAGA1UEChMJVEFJV0FOLUNBMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJUV0NB
IENZQkVSIFJvb3QgQ0EwHhcNMjIxMTIyMDY1NDI5WhcNNDcxMTIyMTU1OTU5WjBQMQswCQYDVQQG
EwJUVzESMBAGA1UEChMJVEFJV0FOLUNBMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJUV0NB
IENZQkVSIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDG+Moe2Qkgfh1s
Ts6P40czRJzHyWmqOlt47nDSkvgEs1JSHWdyKKHfi12VCv7qze33Kc7wb3+szT3vsxxFavcokPFh
V8UMxKNQXd7UtcsZyoC5dc4pztKFIuwCY8xEMCDa6pFbVuYdHNWdZsc/34bKS1PE2Y2yHer43CdT
o0fhYcx9tbD47nORxc5zb87uEB8aBs/pJ2DFTxnk684iJkXXYJndzk834H/nY62wuFm40AZoNWDT
Nq5xQwTxaWV4fPMf88oon1oglWa0zbfuj3ikRRjpJi+NmykosaS3Om251Bw4ckVYsV7r8Cibt4LK
/c/WMw+f+5eesRycnupfXtuq3VTpMCEobY5583WSjCb+3MX2w7DfRFlDo7YDKPYIMKoNM+HvnKkH
IuNZW0CP2oi3aQiotyMuRAlZN1vH4xfyIutuOVLF3lSnmMlLIJXcRolftBL5hSmO68gnFSDAS9TM
fAxsNAwmmyYxpjyn9tnQS6Jk/zuZQXLB4HCX8SS7K8R0IrGsayIyJNN4KsDAoS/xUgXJP+92ZuJF
2A09rZXIx4kmyA+upwMu+8Ff+iDhcK2wZSA3M2Cw1a/XDBzCkHDXShi8fgGwsOsVHkQGzaRP6AzR
wyAQ4VRlnrZR0Bp2a0JaWHY06rc3Ga4udfmW5cFZ95RXKSWNOkyrTZpB0F8mAwIDAQABo2MwYTAO
BgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSdhWEUfMFib5do5E83
QOGt4A1WNzAdBgNVHQ4EFgQUnYVhFHzBYm+XaORPN0DhreANVjcwDQYJKoZIhvcNAQEMBQADggIB
AGSPesRiDrWIzLjHhg6hShbNcAu3p4ULs3a2D6f/CIsLJc+o1IN1KriWiLb73y0ttGlTITVX1olN
c79pj3CjYcya2x6a4CD4bLubIp1dhDGaLIrdaqHXKGnK/nZVekZn68xDiBaiA9a5F/gZbG0jAn/x
X9AKKSM70aoK7akXJlQKTcKlTfjF/biBzysseKNnTKkHmvPfXvt89YnNdJdhEGoHK4Fa0o635yDR
IG4kqIQnoVesqlVYL9zZyvpoBJ7tRCT5dEA7IzOrg1oYJkK2bVS1FmAwbLGg+LhBoF1JSdJlBTrq
/p1hvIbZv97Tujqxf36SNI7JAG7cmL3c7IAFrQI932XtCwP39xaEBDG6k5TY8hL4iuO/Qq+n1M0R
FxbIQh0UqEL20kCGoE8jypZFVmAGzbdVAaYBlGX+bgUJurSkquLvWL69J1bY73NxW0Qz8ppy6rBe
Pm6pUlvscG21h483XjyMnM7k8M4MZ0HMzvaAq07MTFb1wWFZk7Q+ptq4NxKfKjLji7gh7MMrZQzv
It6IKTtM1/r+t+FHvpw+PoP7UV31aPcuIYXcv/Fa4nzXxeSDwWrruoBa3lwtcHb4yOWHh8qgnaHl
IhInD0Q9HWzq1MKLL295q39QpsQZp6F6t5b5wR9iWqJDB0BeJsas7a5wFsWqynKKTbDPAYsDP27X
-----END CERTIFICATE-----
SecureSign Root CA12
====================
-----BEGIN CERTIFICATE-----
MIIDcjCCAlqgAwIBAgIUZvnHwa/swlG07VOX5uaCwysckBYwDQYJKoZIhvcNAQELBQAwUTELMAkG
A1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBMdGQuMR0wGwYDVQQDExRT
ZWN1cmVTaWduIFJvb3QgQ0ExMjAeFw0yMDA0MDgwNTM2NDZaFw00MDA0MDgwNTM2NDZaMFExCzAJ
BgNVBAYTAkpQMSMwIQYDVQQKExpDeWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMU
U2VjdXJlU2lnbiBSb290IENBMTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6OcE3
emhFKxS06+QT61d1I02PJC0W6K6OyX2kVzsqdiUzg2zqMoqUm048luT9Ub+ZyZN+v/mtp7JIKwcc
J/VMvHASd6SFVLX9kHrko+RRWAPNEHl57muTH2SOa2SroxPjcf59q5zdJ1M3s6oYwlkm7Fsf0uZl
fO+TvdhYXAvA42VvPMfKWeP+bl+sg779XSVOKik71gurFzJ4pOE+lEa+Ym6b3kaosRbnhW70CEBF
EaCeVESE99g2zvVQR9wsMJvuwPWW0v4JhscGWa5Pro4RmHvzC1KqYiaqId+OJTN5lxZJjfU+1Uef
NzFJM3IFTQy2VYzxV4+Kh9GtxRESOaCtAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0P
AQH/BAQDAgEGMB0GA1UdDgQWBBRXNPN0zwRL1SXm8UC2LEzZLemgrTANBgkqhkiG9w0BAQsFAAOC
AQEAPrvbFxbS8hQBICw4g0utvsqFepq2m2um4fylOqyttCg6r9cBg0krY6LdmmQOmFxv3Y67ilQi
LUoT865AQ9tPkbeGGuwAtEGBpE/6aouIs3YIcipJQMPTw4WJmBClnW8Zt7vPemVV2zfrPIpyMpce
mik+rY3moxtt9XUa5rBouVui7mlHJzWhhpmA8zNL4WukJsPvdFlseqJkth5Ew1DgDzk9qTPxpfPS
vWKErI4cqc1avTc7bgoitPQV55FYxTpE05Uo2cBl6XLK0A+9H7MV2anjpEcJnuDLN/v9vZfVvhga
aaI5gdka9at/yOPiZwud9AzqVN/Ssq+xIvEg37xEHA==
-----END CERTIFICATE-----
SecureSign Root CA14
====================
-----BEGIN CERTIFICATE-----
MIIFcjCCA1qgAwIBAgIUZNtaDCBO6Ncpd8hQJ6JaJ90t8sswDQYJKoZIhvcNAQEMBQAwUTELMAkG
A1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBMdGQuMR0wGwYDVQQDExRT
ZWN1cmVTaWduIFJvb3QgQ0ExNDAeFw0yMDA0MDgwNzA2MTlaFw00NTA0MDgwNzA2MTlaMFExCzAJ
BgNVBAYTAkpQMSMwIQYDVQQKExpDeWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMU
U2VjdXJlU2lnbiBSb290IENBMTQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDF0nqh
1oq/FjHQmNE6lPxauG4iwWL3pwon71D2LrGeaBLwbCRjOfHw3xDG3rdSINVSW0KZnvOgvlIfX8xn
bacuUKLBl422+JX1sLrcneC+y9/3OPJH9aaakpUqYllQC6KxNedlsmGy6pJxaeQp8E+BgQQ8sqVb
1MWoWWd7VRxJq3qdwudzTe/NCcLEVxLbAQ4jeQkHO6Lo/IrPj8BGJJw4J+CDnRugv3gVEOuGTgpa
/d/aLIJ+7sr2KeH6caH3iGicnPCNvg9JkdjqOvn90Ghx2+m1K06Ckm9mH+Dw3EzsytHqunQG+bOE
kJTRX45zGRBdAuVwpcAQ0BB8b8VYSbSwbprafZX1zNoCr7gsfXmPvkPx+SgojQlD+Ajda8iLLCSx
jVIHvXiby8posqTdDEx5YMaZ0ZPxMBoH064iwurO8YQJzOAUbn8/ftKChazcqRZOhaBgy/ac18iz
ju3Gm5h1DVXoX+WViwKkrkMpKBGk5hIwAUt1ax5mnXkvpXYvHUC0bcl9eQjs0Wq2XSqypWa9a4X0
dFbD9ed1Uigspf9mR6XU/v6eVL9lfgHWMI+lNpyiUBzuOIABSMbHdPTGrMNASRZhdCyvjG817XsY
AFs2PJxQDcqSMxDxJklt33UkN4Ii1+iW/RVLApY+B3KVfqs9TC7XyvDf4Fg/LS8EmjijAQIDAQAB
o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUBpOjCl4oaTeq
YR3r6/wtbyPk86AwDQYJKoZIhvcNAQEMBQADggIBAJaAcgkGfpzMkwQWu6A6jZJOtxEaCnFxEM0E
rX+lRVAQZk5KQaID2RFPeje5S+LGjzJmdSX7684/AykmjbgWHfYfM25I5uj4V7Ibed87hwriZLoA
ymzvftAj63iP/2SbNDefNWWipAA9EiOWWF3KY4fGoweITedpdopTzfFP7ELyk+OZpDc8h7hi2/Ds
Hzc/N19DzFGdtfCXwreFamgLRB7lUe6TzktuhsHSDCRZNhqfLJGP4xjblJUK7ZGqDpncllPjYYPG
FrojutzdfhrGe0K22VoF3Jpf1d+42kd92jjbrDnVHmtsKheMYc2xbXIBw8MgAGJoFjHVdqqGuw6q
nsb58Nn4DSEC5MUoFlkRudlpcyqSeLiSV5sI8jrlL5WwWLdrIBRtFO8KvH7YVdiI2i/6GaX7i+B/
OfVyK4XELKzvGUWSTLNhB9xNH27SgRNcmvMSZ4PPmz+Ln52kuaiWA3rF7iDeM9ovnhp6dB7h7sxa
OgTdsxoEqBRjrLdHEoOabPXm6RUVkRqEGQ6UROcSjiVbgGcZ3GOTEAtlLor6CZpO2oYofaphNdgO
pygau1LgePhsumywbrmHXumZNTfxPWQrqaA0k89jL9WB365jJ6UeTo3cKXhZ+PmhIIynJkBugnLN
eLLIjzwec+fBH7/PzqUqm9tEZDKgu39cJRNItX+S
-----END CERTIFICATE-----
SecureSign Root CA15
====================
-----BEGIN CERTIFICATE-----
MIICIzCCAamgAwIBAgIUFhXHw9hJp75pDIqI7fBw+d23PocwCgYIKoZIzj0EAwMwUTELMAkGA1UE
BhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBMdGQuMR0wGwYDVQQDExRTZWN1
cmVTaWduIFJvb3QgQ0ExNTAeFw0yMDA0MDgwODMyNTZaFw00NTA0MDgwODMyNTZaMFExCzAJBgNV
BAYTAkpQMSMwIQYDVQQKExpDeWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2Vj
dXJlU2lnbiBSb290IENBMTUwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQLUHSNZDKZmbPSYAi4Io5G
dCx4wCtELW1fHcmuS1Iggz24FG1Th2CeX2yF2wYUleDHKP+dX+Sq8bOLbe1PL0vJSpSRZHX+AezB
2Ot6lHhWGENfa4HL9rzatAy2KZMIaY+jQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
AgEGMB0GA1UdDgQWBBTrQciu/NWeUUj1vYv0hyCTQSvT9DAKBggqhkjOPQQDAwNoADBlAjEA2S6J
fl5OpBEHvVnCB96rMjhTKkZEBhd6zlHp4P9mLQlO4E/0BdGF9jVg3PVys0Z9AjBEmEYagoUeYWmJ
SwdLZrWeqrqgHkHZAXQ6bkU6iYAZezKYVWOr62Nuk22rGwlgMU4=
-----END CERTIFICATE-----
D-TRUST BR Root CA 2 2023
=========================
-----BEGIN CERTIFICATE-----
MIIFqTCCA5GgAwIBAgIQczswBEhb2U14LnNLyaHcZjANBgkqhkiG9w0BAQ0FADBIMQswCQYDVQQG
EwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEJSIFJvb3QgQ0Eg
MiAyMDIzMB4XDTIzMDUwOTA4NTYzMVoXDTM4MDUwOTA4NTYzMFowSDELMAkGA1UEBhMCREUxFTAT
BgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDIgMjAyMzCC
AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK7/CVmRgApKaOYkP7in5Mg6CjoWzckjYaCT
cfKri3OPoGdlYNJUa2NRb0kz4HIHE304zQaSBylSa053bATTlfrdTIzZXcFhfUvnKLNEgXtRr90z
sWh81k5M/itoucpmacTsXld/9w3HnDY25QdgrMBM6ghs7wZ8T1soegj8k12b9py0i4a6Ibn08OhZ
WiihNIQaJZG2tY/vsvmA+vk9PBFy2OMvhnbFeSzBqZCTRphny4NqoFAjpzv2gTng7fC5v2Xx2Mt6
++9zA84A9H3X4F07ZrjcjrqDy4d2A/wl2ecjbwb9Z/Pg/4S8R7+1FhhGaRTMBffb00msa8yr5LUL
QyReS2tNZ9/WtT5PeB+UcSTq3nD88ZP+npNa5JRal1QMNXtfbO4AHyTsA7oC9Xb0n9Sa7YUsOCIv
x9gvdhFP/Wxc6PWOJ4d/GUohR5AdeY0cW/jPSoXk7bNbjb7EZChdQcRurDhaTyN0dKkSw/bSuREV
MweR2Ds3OmMwBtHFIjYoYiMQ4EbMl6zWK11kJNXuHA7e+whadSr2Y23OC0K+0bpwHJwh5Q8xaRfX
/Aq03u2AnMuStIv13lmiWAmlY0cL4UEyNEHZmrHZqLAbWt4NDfTisl01gLmB1IRpkQLLddCNxbU9
CZEJjxShFHR5PtbJFR2kWVki3PaKRT08EtY+XTIvAgMBAAGjgY4wgYswDwYDVR0TAQH/BAUwAwEB
/zAdBgNVHQ4EFgQUZ5Dw1t61GNVGKX5cq/ieCLxklRAwDgYDVR0PAQH/BAQDAgEGMEkGA1UdHwRC
MEAwPqA8oDqGOGh0dHA6Ly9jcmwuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3RfYnJfcm9vdF9jYV8y
XzIwMjMuY3JsMA0GCSqGSIb3DQEBDQUAA4ICAQA097N3U9swFrktpSHxQCF16+tIFoE9c+CeJyrr
d6kTpGoKWloUMz1oH4Guaf2Mn2VsNELZLdB/eBaxOqwjMa1ef67nriv6uvw8l5VAk1/DLQOj7aRv
U9f6QA4w9QAgLABMjDu0ox+2v5Eyq6+SmNMW5tTRVFxDWy6u71cqqLRvpO8NVhTaIasgdp4D/Ca4
nj8+AybmTNudX0KEPUUDAxxZiMrcLmEkWqTqJwtzEr5SswrPMhfiHocaFpVIbVrg0M8JkiZmkdij
YQ6qgYF/6FKC0ULn4B0Y+qSFNueG4A3rvNTJ1jxD8V1Jbn6Bm2m1iWKPiFLY1/4nwSPFyysCu7Ff
/vtDhQNGvl3GyiEm/9cCnnRK3PgTFbGBVzbLZVzRHTF36SXDw7IyN9XxmAnkbWOACKsGkoHU6XCP
pz+y7YaMgmo1yEJagtFSGkUPFaUA8JR7ZSdXOUPPfH/mvTWze/EZTN46ls/pdu4D58JDUjxqgejB
WoC9EV2Ta/vH5mQ/u2kc6d0li690yVRAysuTEwrt+2aSEcr1wPrYg1UDfNPFIkZ1cGt5SAYqgpq/
5usWDiJFAbzdNpQ0qTUmiteXue4Icr80knCDgKs4qllo3UCkGJCy89UDyibK79XH4I9TjvAA46jt
n/mtd+ArY0+ew+43u3gJhJ65bvspmZDogNOfJA==
-----END CERTIFICATE-----
TrustAsia TLS ECC Root CA
=========================
-----BEGIN CERTIFICATE-----
MIICMTCCAbegAwIBAgIUNnThTXxlE8msg1UloD5Sfi9QaMcwCgYIKoZIzj0EAwMwWDELMAkGA1UE
BhMCQ04xJTAjBgNVBAoTHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xIjAgBgNVBAMTGVRy
dXN0QXNpYSBUTFMgRUNDIFJvb3QgQ0EwHhcNMjQwNTE1MDU0MTU2WhcNNDQwNTE1MDU0MTU1WjBY
MQswCQYDVQQGEwJDTjElMCMGA1UEChMcVHJ1c3RBc2lhIFRlY2hub2xvZ2llcywgSW5jLjEiMCAG
A1UEAxMZVHJ1c3RBc2lhIFRMUyBFQ0MgUm9vdCBDQTB2MBAGByqGSM49AgEGBSuBBAAiA2IABLh/
pVs/AT598IhtrimY4ZtcU5nb9wj/1WrgjstEpvDBjL1P1M7UiFPoXlfXTr4sP/MSpwDpguMqWzJ8
S5sUKZ74LYO1644xST0mYekdcouJtgq7nDM1D9rs3qlKH8kzsaNCMEAwDwYDVR0TAQH/BAUwAwEB
/zAdBgNVHQ4EFgQULIVTu7FDzTLqnqOH/qKYqKaT6RAwDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49
BAMDA2gAMGUCMFRH18MtYYZI9HlaVQ01L18N9mdsd0AaRuf4aFtOJx24mH1/k78ITcTaRTChD15K
eAIxAKORh/IRM4PDwYqROkwrULG9IpRdNYlzg8WbGf60oenUoWa2AaU2+dhoYSi3dOGiMQ==
-----END CERTIFICATE-----
TrustAsia TLS RSA Root CA
=========================
-----BEGIN CERTIFICATE-----
MIIFgDCCA2igAwIBAgIUHBjYz+VTPyI1RlNUJDxsR9FcSpwwDQYJKoZIhvcNAQEMBQAwWDELMAkG
A1UEBhMCQ04xJTAjBgNVBAoTHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xIjAgBgNVBAMT
GVRydXN0QXNpYSBUTFMgUlNBIFJvb3QgQ0EwHhcNMjQwNTE1MDU0MTU3WhcNNDQwNTE1MDU0MTU2
WjBYMQswCQYDVQQGEwJDTjElMCMGA1UEChMcVHJ1c3RBc2lhIFRlY2hub2xvZ2llcywgSW5jLjEi
MCAGA1UEAxMZVHJ1c3RBc2lhIFRMUyBSU0EgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIP
ADCCAgoCggIBAMMWuBtqpERz5dZO9LnPWwvB0ZqB9WOwj0PBuwhaGnrhB3YmH49pVr7+NmDQDIPN
lOrnxS1cLwUWAp4KqC/lYCZUlviYQB2srp10Zy9U+5RjmOMmSoPGlbYJQ1DNDX3eRA5gEk9bNb2/
mThtfWza4mhzH/kxpRkQcwUqwzIZheo0qt1CHjCNP561HmHVb70AcnKtEj+qpklz8oYVlQwQX1Fk
zv93uMltrOXVmPGZLmzjyUT5tUMnCE32ft5EebuyjBza00tsLtbDeLdM1aTk2tyKjg7/D8OmYCYo
zza/+lcK7Fs/6TAWe8TbxNRkoDD75f0dcZLdKY9BWN4ArTr9PXwaqLEX8E40eFgl1oUh63kd0Nyr
z2I8sMeXi9bQn9P+PN7F4/w6g3CEIR0JwqH8uyghZVNgepBtljhb//HXeltt08lwSUq6HTrQUNoy
IBnkiz/r1RYmNzz7dZ6wB3C4FGB33PYPXFIKvF1tjVEK2sUYyJtt3LCDs3+jTnhMmCWr8n4uIF6C
FabW2I+s5c0yhsj55NqJ4js+k8UTav/H9xj8Z7XvGCxUq0DTbE3txci3OE9kxJRMT6DNrqXGJyV1
J23G2pyOsAWZ1SgRxSHUuPzHlqtKZFlhaxP8S8ySpg+kUb8OWJDZgoM5pl+z+m6Ss80zDoWo8SnT
q1mt1tve1CuBAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFLgHkXlcBvRG/XtZ
ylomkadFK/hTMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQwFAAOCAgEAIZtqBSBdGBanEqT3
Rz/NyjuujsCCztxIJXgXbODgcMTWltnZ9r96nBO7U5WS/8+S4PPFJzVXqDuiGev4iqME3mmL5Dw8
veWv0BIb5Ylrc5tvJQJLkIKvQMKtuppgJFqBTQUYo+IzeXoLH5Pt7DlK9RME7I10nYEKqG/odv6L
TytpEoYKNDbdgptvT+Bz3Ul/KD7JO6NXBNiT2Twp2xIQaOHEibgGIOcberyxk2GaGUARtWqFVwHx
tlotJnMnlvm5P1vQiJ3koP26TpUJg3933FEFlJ0gcXax7PqJtZwuhfG5WyRasQmr2soaB82G39tp
27RIGAAtvKLEiUUjpQ7hRGU+isFqMB3iYPg6qocJQrmBktwliJiJ8Xw18WLK7nn4GS/+X/jbh87q
qA8MpugLoDzga5SYnH+tBuYc6kIQX+ImFTw3OffXvO645e8D7r0i+yiGNFjEWn9hongPXvPKnbwb
PKfILfanIhHKA9jnZwqKDss1jjQ52MjqjZ9k4DewbNfFj8GQYSbbJIweSsCI3zWQzj8C9GRh3sfI
B5XeMhg6j6JCQCTl1jNdfK7vsU1P1FeQNWrcrgSXSYk0ly4wBOeY99sLAZDBHwo/+ML+TvrbmnNz
FrwFuHnYWa8G5z9nODmxfKuU4CkUpijy323imttUQ/hHWKNddBWcwauwxzQ=
-----END CERTIFICATE-----
D-TRUST EV Root CA 2 2023
=========================
-----BEGIN CERTIFICATE-----
MIIFqTCCA5GgAwIBAgIQaSYJfoBLTKCnjHhiU19abzANBgkqhkiG9w0BAQ0FADBIMQswCQYDVQQG
EwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEVWIFJvb3QgQ0Eg
MiAyMDIzMB4XDTIzMDUwOTA5MTAzM1oXDTM4MDUwOTA5MTAzMlowSDELMAkGA1UEBhMCREUxFTAT
BgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBFViBSb290IENBIDIgMjAyMzCC
AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANiOo4mAC7JXUtypU0w3uX9jFxPvp1sjW2l1
sJkKF8GLxNuo4MwxusLyzV3pt/gdr2rElYfXR8mV2IIEUD2BCP/kPbOx1sWy/YgJ25yE7CUXFId/
MHibaljJtnMoPDT3mfd/06b4HEV8rSyMlD/YZxBTfiLNTiVR8CUkNRFeEMbsh2aJgWi6zCudR3Mf
vc2RpHJqnKIbGKBv7FD0fUDCqDDPvXPIEysQEx6Lmqg6lHPTGGkKSv/BAQP/eX+1SH977ugpbzZM
lWGG2Pmic4ruri+W7mjNPU0oQvlFKzIbRlUWaqZLKfm7lVa/Rh3sHZMdwGWyH6FDrlaeoLGPaxK3
YG14C8qKXO0elg6DpkiVjTujIcSuWMYAsoS0I6SWhjW42J7YrDRJmGOVxcttSEfi8i4YHtAxq910
7PncjLgcjmgjutDzUNzPZY9zOjLHfP7KgiJPvo5iR2blzYfi6NUPGJ/lBHJLRjwQ8kTCZFZxTnXo
nMkmdMV9WdEKWw9t/p51HBjGGjp82A0EzM23RWV6sY+4roRIPrN6TagD4uJ+ARZZaBhDM7DS3LAa
QzXupdqpRlyuhoFBAUp0JuyfBr/CBTdkdXgpaP3F9ev+R/nkhbDhezGdpn9yo7nELC7MmVcOIQxF
AZRl62UJxmMiCzNJkkg8/M3OsD6Onov4/knFNXJHAgMBAAGjgY4wgYswDwYDVR0TAQH/BAUwAwEB
/zAdBgNVHQ4EFgQUqvyREBuHkV8Wub9PS5FeAByxMoAwDgYDVR0PAQH/BAQDAgEGMEkGA1UdHwRC
MEAwPqA8oDqGOGh0dHA6Ly9jcmwuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3RfZXZfcm9vdF9jYV8y
XzIwMjMuY3JsMA0GCSqGSIb3DQEBDQUAA4ICAQCTy6UfmRHsmg1fLBWTxj++EI14QvBukEdHjqOS
Mo1wj/Zbjb6JzkcBahsgIIlbyIIQbODnmaprxiqgYzWRaoUlrRc4pZt+UPJ26oUFKidBK7GB0aL2
QHWpDsvxVUjY7NHss+jOFKE17MJeNRqrphYBBo7q3C+jisosketSjl8MmxfPy3MHGcRqwnNU73xD
UmPBEcrCRbH0O1P1aa4846XerOhUt7KR/aypH/KH5BfGSah82ApB9PI+53c0BFLd6IHyTS9URZ0V
4U/M5d40VxDJI3IXcI1QcB9WbMy5/zpaT2N6w25lBx2Eof+pDGOJbbJAiDnXH3dotfyc1dZnaVuo
dNv8ifYbMvekJKZ2t0dT741Jj6m2g1qllpBFYfXeA08mD6iL8AOWsKwV0HFaanuU5nCT2vFp4LJi
TZ6P/4mdm13NRemUAiKN4DV/6PEEeXFsVIP4M7kFMhtYVRFP0OUnR3Hs7dpn1mKmS00PaaLJvOwi
S5THaJQXfuKOKD62xur1NGyfN4gHONuGcfrNlUhDbqNPgofXNJhuS5N5YHVpD/Aa1VP6IQzCP+k/
HxiMkl14p3ZnGbuy6n/pcAlWVqOwDAstNl7F6cTVg8uGF5csbBNvh1qvSaYd2804BC5f4ko1Di1L
+KIkBI3Y4WNeApI02phhXBxvWHZks/wCuPWdCg==
-----END CERTIFICATE-----
SwissSign RSA TLS Root CA 2022 - 1
==================================
-----BEGIN CERTIFICATE-----
MIIFkzCCA3ugAwIBAgIUQ/oMX04bgBhE79G0TzUfRPSA7cswDQYJKoZIhvcNAQELBQAwUTELMAkG
A1UEBhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzErMCkGA1UEAxMiU3dpc3NTaWduIFJTQSBU
TFMgUm9vdCBDQSAyMDIyIC0gMTAeFw0yMjA2MDgxMTA4MjJaFw00NzA2MDgxMTA4MjJaMFExCzAJ
BgNVBAYTAkNIMRUwEwYDVQQKEwxTd2lzc1NpZ24gQUcxKzApBgNVBAMTIlN3aXNzU2lnbiBSU0Eg
VExTIFJvb3QgQ0EgMjAyMiAtIDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDLKmji
C8NXvDVjvHClO/OMPE5Xlm7DTjak9gLKHqquuN6orx122ro10JFwB9+zBvKK8i5VUXu7LCTLf5Im
gKO0lPaCoaTo+nUdWfMHamFk4saMla+ju45vVs9xzF6BYQ1t8qsCLqSX5XH8irCRIFucdFJtrhUn
WXjyCcplDn/L9Ovn3KlMd/YrFgSVrpxxpT8q2kFC5zyEEPThPYxr4iuRR1VPuFa+Rd4iUU1OKNlf
GUEGjw5NBuBwQCMBauTLE5tzrE0USJIt/m2n+IdreXXhvhCxqohAWVTXz8TQm0SzOGlkjIHRI36q
OTw7D59Ke4LKa2/KIj4x0LDQKhySio/YGZxH5D4MucLNvkEM+KRHBdvBFzA4OmnczcNpI/2aDwLO
EGrOyvi5KaM2iYauC8BPY7kGWUleDsFpswrzd34unYyzJ5jSmY0lpx+Gs6ZUcDj8fV3oT4MM0ZPl
EuRU2j7yrTrePjxF8CgPBrnh25d7mUWe3f6VWQQvdT/TromZhqwUtKiE+shdOxtYk8EXlFXIC+OC
eYSf8wCENO7cMdWP8vpPlkwGqnj73mSiI80fPsWMvDdUDrtaclXvyFu1cvh43zcgTFeRc5JzrBh3
Q4IgaezprClG5QtO+DdziZaKHG29777YtvTKwP1H8K4LWCDFyB02rpeNUIMmJCn3nTsPBQIDAQAB
o2MwYTAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBRvjmKLk0Ow
4UD2p8P98Q+4DxU4pTAdBgNVHQ4EFgQUb45ii5NDsOFA9qfD/fEPuA8VOKUwDQYJKoZIhvcNAQEL
BQADggIBAKwsKUF9+lz1GpUYvyypiqkkVHX1uECry6gkUSsYP2OprphWKwVDIqO310aewCoSPY6W
lkDfDDOLazeROpW7OSltwAJsipQLBwJNGD77+3v1dj2b9l4wBlgzHqp41eZUBDqyggmNzhYzWUUo
8aWjlw5DI/0LIICQ/+Mmz7hkkeUFjxOgdg3XNwwQiJb0Pr6VvfHDffCjw3lHC1ySFWPtUnWK50Zp
y1FVCypM9fJkT6lc/2cyjlUtMoIcgC9qkfjLvH4YoiaoLqNTKIftV+Vlek4ASltOU8liNr3Cjlvr
zG4ngRhZi0Rjn9UMZfQpZX+RLOV/fuiJz48gy20HQhFRJjKKLjpHE7iNvUcNCfAWpO2Whi4Z2L6M
OuhFLhG6rlrnub+xzI/goP+4s9GFe3lmozm1O2bYQL7Pt2eLSMkZJVX8vY3PXtpOpvJpzv1/THfQ
wUY1mFwjmwJFQ5Ra3bxHrSL+ul4vkSkphnsh3m5kt8sNjzdbowhq6/TdAo9QAwKxuDdollDruF/U
KIqlIgyKhPBZLtU30WHlQnNYKoH3dtvi4k0NX/a3vgW0rk4N3hY9A4GzJl5LuEsAz/+MF7psYC0n
hzck5npgL7XTgwSqT0N1osGDsieYK7EOgLrAhV5Cud+xYJHT6xh+cHiudoO+cVrQkOPKwRYlZ0rw
tnu64ZzZ
-----END CERTIFICATE-----
OISTE Server Root ECC G1
========================
-----BEGIN CERTIFICATE-----
MIICNTCCAbqgAwIBAgIQI/nD1jWvjyhLH/BU6n6XnTAKBggqhkjOPQQDAzBLMQswCQYDVQQGEwJD
SDEZMBcGA1UECgwQT0lTVEUgRm91bmRhdGlvbjEhMB8GA1UEAwwYT0lTVEUgU2VydmVyIFJvb3Qg
RUNDIEcxMB4XDTIzMDUzMTE0NDIyOFoXDTQ4MDUyNDE0NDIyN1owSzELMAkGA1UEBhMCQ0gxGTAX
BgNVBAoMEE9JU1RFIEZvdW5kYXRpb24xITAfBgNVBAMMGE9JU1RFIFNlcnZlciBSb290IEVDQyBH
MTB2MBAGByqGSM49AgEGBSuBBAAiA2IABBcv+hK8rBjzCvRE1nZCnrPoH7d5qVi2+GXROiFPqOuj
vqQycvO2Ackr/XeFblPdreqqLiWStukhEaivtUwL85Zgmjvn6hp4LrQ95SjeHIC6XG4N2xml4z+c
KrhAS93mT6NjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBQ3TYhlz/w9itWj8UnATgwQ
b0K0nDAdBgNVHQ4EFgQUN02IZc/8PYrVo/FJwE4MEG9CtJwwDgYDVR0PAQH/BAQDAgGGMAoGCCqG
SM49BAMDA2kAMGYCMQCpKjAd0MKfkFFRQD6VVCHNFmb3U2wIFjnQEnx/Yxvf4zgAOdktUyBFCxxg
ZzFDJe0CMQCSia7pXGKDYmH5LVerVrkR3SW+ak5KGoJr3M/TvEqzPNcum9v4KGm8ay3sMaE641c=
-----END CERTIFICATE-----
OISTE Server Root RSA G1
========================
-----BEGIN CERTIFICATE-----
MIIFgzCCA2ugAwIBAgIQVaXZZ5Qoxu0M+ifdWwFNGDANBgkqhkiG9w0BAQwFADBLMQswCQYDVQQG
EwJDSDEZMBcGA1UECgwQT0lTVEUgRm91bmRhdGlvbjEhMB8GA1UEAwwYT0lTVEUgU2VydmVyIFJv
b3QgUlNBIEcxMB4XDTIzMDUzMTE0MzcxNloXDTQ4MDUyNDE0MzcxNVowSzELMAkGA1UEBhMCQ0gx
GTAXBgNVBAoMEE9JU1RFIEZvdW5kYXRpb24xITAfBgNVBAMMGE9JU1RFIFNlcnZlciBSb290IFJT
QSBHMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKqu9KuCz/vlNwvn1ZatkOhLKdxV
YOPMvLO8LZK55KN68YG0nnJyQ98/qwsmtO57Gmn7KNByXEptaZnwYx4M0rH/1ow00O7brEi56rAU
jtgHqSSY3ekJvqgiG1k50SeH3BzN+Puz6+mTeO0Pzjd8JnduodgsIUzkik/HEzxux9UTl7Ko2yRp
g1bTacuCErudG/L4NPKYKyqOBGf244ehHa1uzjZ0Dl4zO8vbUZeUapU8zhhabkvG/AePLhq5Svdk
NCncpo1Q4Y2LS+VIG24ugBA/5J8bZT8RtOpXaZ+0AOuFJJkk9SGdl6r7NH8CaxWQrbueWhl/pIzY
+m0o/DjH40ytas7ZTpOSjswMZ78LS5bOZmdTaMsXEY5Z96ycG7mOaES3GK/m5Q9l3JUJsJMStR8+
lKXHiHUhsd4JJCpM4rzsTGdHwimIuQq6+cF0zowYJmXa92/GjHtoXAvuY8BeS/FOzJ8vD+HomnqT
8eDI278n5mUpezbgMxVz8p1rhAhoKzYHKyfMeNhqhw5HdPSqoBNdZH702xSu+zrkL8Fl47l6QGzw
Brd7KJvX4V84c5Ss2XCTLdyEr0YconosP4EmQufU2MVshGYRi3drVByjtdgQ8K4p92cIiBdcuJd5
z+orKu5YM+Vt6SmqZQENghPsJQtdLEByFSnTkCz3GkPVavBpAgMBAAGjYzBhMA8GA1UdEwEB/wQF
MAMBAf8wHwYDVR0jBBgwFoAU8snBDw1jALvsRQ5KH7WxszbNDo0wHQYDVR0OBBYEFPLJwQ8NYwC7
7EUOSh+1sbM2zQ6NMA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQwFAAOCAgEANGd5sjrG5T33
I3K5Ce+SrScfoE4KsvXaFwyihdJ+klH9FWXXXGtkFu6KRcoMQzZENdl//nk6HOjG5D1rd9QhEOP2
8yBOqb6J8xycqd+8MDoX0TJD0KqKchxRKEzdNsjkLWd9kYccnbz8qyiWXmFcuCIzGEgWUOrKL+ml
Sdx/PKQZvDatkuK59EvV6wit53j+F8Bdh3foZ3dPAGav9LEDOr4SfEE15fSmG0eLy3n31r8Xbk5l
8PjaV8GUgeV6Vg27Rn9vkf195hfkgSe7BYhW3SCl95gtkRlpMV+bMPKZrXJAlszYd2abtNUOshD+
FKrDgHGdPY3ofRRsYWSGRqbXVMW215AWRqWFyp464+YTFrYVI8ypKVL9AMb2kI5Wj4kI3Zaq5tNq
qYY19tVFeEJKRvwDyF7YZvZFZSS0vod7VSCd9521Kvy5YhnLbDuv0204bKt7ph6N/Ome/msVuduC
msuY33OhkKCgxeDoAaijFJzIwZqsFVAzje18KotzlUBDJvyBpCpfOZC3J8tRd/iWkx7P8nd9H0aT
olkelUTFLXVksNb54Dxp6gS1HAviRkRNQzuXSXERvSS2wq1yVAb+axj5d9spLFKebXd7Yv0PTY6Y
MjAwcRLWJTXjn/hvnLXrahut6hDTlhZyBiElxky8j3C7DOReIoMt0r7+hVu05L0=
-----END CERTIFICATE-----
e-Szigno TLS Root CA 2023
=========================
-----BEGIN CERTIFICATE-----
MIICzzCCAjGgAwIBAgINAOhvGHvWOWuYSkmYCjAKBggqhkjOPQQDBDB1MQswCQYDVQQGEwJIVTER
MA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xFzAVBgNVBGEMDlZBVEhV
LTIzNTg0NDk3MSIwIAYDVQQDDBllLVN6aWdubyBUTFMgUm9vdCBDQSAyMDIzMB4XDTIzMDcxNzE0
MDAwMFoXDTM4MDcxNzE0MDAwMFowdTELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRYw
FAYDVQQKDA1NaWNyb3NlYyBMdGQuMRcwFQYDVQRhDA5WQVRIVS0yMzU4NDQ5NzEiMCAGA1UEAwwZ
ZS1Temlnbm8gVExTIFJvb3QgQ0EgMjAyMzCBmzAQBgcqhkjOPQIBBgUrgQQAIwOBhgAEAGgP36J8
PKp0iGEKjcJMpQEiFNT3YHdCnAo4YKGMZz6zY+n6kbCLS+Y53wLCMAFSAL/fjO1ZrTJlqwlZULUZ
wmgcAOAFX9pQJhzDrAQixTpN7+lXWDajwRlTEArRzT/vSzUaQ49CE0y5LBqcvjC2xN7cS53kpDzL
Ltmt3999Cd8ukv+ho2MwYTAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4E
FgQUWYQCYlpGePVd3I8KECgj3NXW+0UwHwYDVR0jBBgwFoAUWYQCYlpGePVd3I8KECgj3NXW+0Uw
CgYIKoZIzj0EAwQDgYsAMIGHAkIBLdqu9S54tma4n7Zwf2Z0z+yOfP7AAXmazlIC58PRDHpty7Ve
7hekm9sEdu4pKeiv+62sUvTXK9Z3hBC9xdIoaDQCQTV2WnXzkoYI9bIeCvZlC9p2x1L/Cx6AcCIw
wzPbGO2E14vs7dOoY4G1VnxHx1YwlGhza9IuqbnZLBwpvQy6uWWL
-----END CERTIFICATE-----
PK \Sʉ ' vendor/composer/ca-bundle/res/.htaccessnu 7m
Order allow,deny
Deny from all
PK \>Vu1 1 # vendor/composer/ca-bundle/README.mdnu [ composer/ca-bundle
==================
Small utility library that lets you find a path to the system CA bundle,
and includes a fallback to the Mozilla CA bundle.
Originally written as part of [composer/composer](https://github.com/composer/composer),
now extracted and made available as a stand-alone library.
Installation
------------
Install the latest version with:
```bash
$ composer require composer/ca-bundle
```
Requirements
------------
* PHP 5.3.2 is required but using the latest version of PHP is highly recommended.
Basic usage
-----------
### `Composer\CaBundle\CaBundle`
- `CaBundle::getSystemCaRootBundlePath()`: Returns the system CA bundle path, or a path to the bundled one as fallback
- `CaBundle::getBundledCaBundlePath()`: Returns the path to the bundled CA file
- `CaBundle::validateCaFile($filename)`: Validates a CA file using openssl_x509_parse only if it is safe to use
- `CaBundle::isOpensslParseSafe()`: Test if it is safe to use the PHP function openssl_x509_parse()
- `CaBundle::reset()`: Resets the static caches
#### To use with curl
```php
$curl = curl_init("https://example.org/");
$caPathOrFile = \Composer\CaBundle\CaBundle::getSystemCaRootBundlePath();
if (is_dir($caPathOrFile)) {
curl_setopt($curl, CURLOPT_CAPATH, $caPathOrFile);
} else {
curl_setopt($curl, CURLOPT_CAINFO, $caPathOrFile);
}
$result = curl_exec($curl);
```
#### To use with php streams
```php
$opts = array(
'http' => array(
'method' => "GET"
)
);
$caPathOrFile = \Composer\CaBundle\CaBundle::getSystemCaRootBundlePath();
if (is_dir($caPathOrFile)) {
$opts['ssl']['capath'] = $caPathOrFile;
} else {
$opts['ssl']['cafile'] = $caPathOrFile;
}
$context = stream_context_create($opts);
$result = file_get_contents('https://example.com', false, $context);
```
#### To use with Guzzle
```php
$client = new \GuzzleHttp\Client([
\GuzzleHttp\RequestOptions::VERIFY => \Composer\CaBundle\CaBundle::getSystemCaRootBundlePath()
]);
```
License
-------
composer/ca-bundle is licensed under the MIT License, see the LICENSE file for details.
PK \N+ + * vendor/composer/ca-bundle/src/CaBundle.phpnu [
*
* For the full copyright and license information, please view
* the LICENSE file that was distributed with this source code.
*/
namespace Composer\CaBundle;
use Psr\Log\LoggerInterface;
use Symfony\Component\Process\PhpProcess;
/**
* @author Chris Smith
* @author Jordi Boggiano
*/
class CaBundle
{
/** @var string|null */
private static $caPath;
/** @var array */
private static $caFileValidity = array();
/**
* Returns the system CA bundle path, or a path to the bundled one
*
* This method was adapted from Sslurp.
* https://github.com/EvanDotPro/Sslurp
*
* (c) Evan Coury
*
* For the full copyright and license information, please see below:
*
* Copyright (c) 2013, Evan Coury
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* @param LoggerInterface $logger optional logger for information about which CA files were loaded
* @return string path to a CA bundle file or directory
*/
public static function getSystemCaRootBundlePath(?LoggerInterface $logger = null)
{
if (self::$caPath !== null) {
return self::$caPath;
}
$caBundlePaths = array();
// If SSL_CERT_FILE env variable points to a valid certificate/bundle, use that.
// This mimics how OpenSSL uses the SSL_CERT_FILE env variable.
$caBundlePaths[] = self::getEnvVariable('SSL_CERT_FILE');
// If SSL_CERT_DIR env variable points to a valid certificate/bundle, use that.
// This mimics how OpenSSL uses the SSL_CERT_FILE env variable.
$caBundlePaths[] = self::getEnvVariable('SSL_CERT_DIR');
$caBundlePaths[] = ini_get('openssl.cafile');
$caBundlePaths[] = ini_get('openssl.capath');
$otherLocations = array(
'/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem', // Fedora, RHEL, CentOS (ca-certificates package) - NEW
'/etc/pki/tls/certs/ca-bundle.crt', // Fedora, RHEL, CentOS (ca-certificates package) - Deprecated
'/etc/ssl/certs/ca-certificates.crt', // Debian, Ubuntu, Gentoo, Arch Linux (ca-certificates package)
'/etc/ssl/ca-bundle.pem', // SUSE, openSUSE (ca-certificates package)
'/usr/ssl/certs/ca-bundle.crt', // Cygwin
'/opt/local/share/curl/curl-ca-bundle.crt', // OS X macports, curl-ca-bundle package
'/usr/local/share/curl/curl-ca-bundle.crt', // Default cURL CA bunde path (without --with-ca-bundle option)
'/usr/share/ssl/certs/ca-bundle.crt', // Really old RedHat?
'/etc/ssl/cert.pem', // OpenBSD
'/usr/local/etc/openssl/cert.pem', // OS X homebrew, openssl package
'/usr/local/etc/openssl@1.1/cert.pem', // OS X homebrew, openssl@1.1 package
'/opt/homebrew/etc/openssl@3/cert.pem', // macOS silicon homebrew, openssl@3 package
'/opt/homebrew/etc/openssl@1.1/cert.pem', // macOS silicon homebrew, openssl@1.1 package
'/etc/pki/tls/certs',
'/etc/ssl/certs', // FreeBSD
);
$caBundlePaths = array_merge($caBundlePaths, $otherLocations);
foreach ($caBundlePaths as $caBundle) {
if ($caBundle && self::caFileUsable($caBundle, $logger)) {
return self::$caPath = $caBundle;
}
if ($caBundle && self::caDirUsable($caBundle, $logger)) {
return self::$caPath = $caBundle;
}
}
return self::$caPath = static::getBundledCaBundlePath(); // Bundled CA file, last resort
}
/**
* Returns the path to the bundled CA file
*
* In case you don't want to trust the user or the system, you can use this directly
*
* @return string path to a CA bundle file
*/
public static function getBundledCaBundlePath()
{
$caBundleFile = __DIR__.'/../res/cacert.pem';
// cURL does not understand 'phar://' paths
// see https://github.com/composer/ca-bundle/issues/10
if (0 === strpos($caBundleFile, 'phar://')) {
$tempCaBundleFile = tempnam(sys_get_temp_dir(), 'openssl-ca-bundle-');
if (false === $tempCaBundleFile) {
throw new \RuntimeException('Could not create a temporary file to store the bundled CA file');
}
file_put_contents(
$tempCaBundleFile,
file_get_contents($caBundleFile)
);
register_shutdown_function(function() use ($tempCaBundleFile) {
@unlink($tempCaBundleFile);
});
$caBundleFile = $tempCaBundleFile;
}
return $caBundleFile;
}
/**
* Validates a CA file using opensl_x509_parse only if it is safe to use
*
* @param string $filename
* @param LoggerInterface $logger optional logger for information about which CA files were loaded
*
* @return bool
*/
public static function validateCaFile($filename, ?LoggerInterface $logger = null)
{
static $warned = false;
if (isset(self::$caFileValidity[$filename])) {
return self::$caFileValidity[$filename];
}
$contents = file_get_contents($filename);
if (is_string($contents) && strlen($contents) > 0) {
$contents = preg_replace("/^(\\-+(?:BEGIN|END))\\s+TRUSTED\\s+(CERTIFICATE\\-+)\$/m", '$1 $2', $contents);
if (null === $contents) {
// regex extraction failed
$isValid = false;
} else {
$isValid = (bool) openssl_x509_parse($contents);
}
} else {
$isValid = false;
}
if ($logger) {
$logger->debug('Checked CA file '.realpath($filename).': '.($isValid ? 'valid' : 'invalid'));
}
return self::$caFileValidity[$filename] = $isValid;
}
/**
* Test if it is safe to use the PHP function openssl_x509_parse().
*
* This checks if OpenSSL extensions is vulnerable to remote code execution
* via the exploit documented as CVE-2013-6420.
*
* @return bool
*/
public static function isOpensslParseSafe()
{
return true;
}
/**
* Resets the static caches
* @return void
*/
public static function reset()
{
self::$caFileValidity = array();
self::$caPath = null;
}
/**
* @param string $name
* @return string|false
*/
private static function getEnvVariable($name)
{
if (isset($_SERVER[$name])) {
return (string) $_SERVER[$name];
}
if (PHP_SAPI === 'cli' && ($value = getenv($name)) !== false && $value !== null) {
return (string) $value;
}
return false;
}
/**
* @param string|false $certFile
* @param LoggerInterface|null $logger
* @return bool
*/
private static function caFileUsable($certFile, ?LoggerInterface $logger = null)
{
return $certFile
&& self::isFile($certFile, $logger)
&& self::isReadable($certFile, $logger)
&& self::validateCaFile($certFile, $logger);
}
/**
* @param string|false $certDir
* @param LoggerInterface|null $logger
* @return bool
*/
private static function caDirUsable($certDir, ?LoggerInterface $logger = null)
{
return $certDir
&& self::isDir($certDir, $logger)
&& self::isReadable($certDir, $logger)
&& self::glob($certDir . '/*', $logger);
}
/**
* @param string $certFile
* @param LoggerInterface|null $logger
* @return bool
*/
private static function isFile($certFile, ?LoggerInterface $logger = null)
{
$isFile = @is_file($certFile);
if (!$isFile && $logger) {
$logger->debug(sprintf('Checked CA file %s does not exist or it is not a file.', $certFile));
}
return $isFile;
}
/**
* @param string $certDir
* @param LoggerInterface|null $logger
* @return bool
*/
private static function isDir($certDir, ?LoggerInterface $logger = null)
{
$isDir = @is_dir($certDir);
if (!$isDir && $logger) {
$logger->debug(sprintf('Checked directory %s does not exist or it is not a directory.', $certDir));
}
return $isDir;
}
/**
* @param string $certFileOrDir
* @param LoggerInterface|null $logger
* @return bool
*/
private static function isReadable($certFileOrDir, ?LoggerInterface $logger = null)
{
$isReadable = @is_readable($certFileOrDir);
if (!$isReadable && $logger) {
$logger->debug(sprintf('Checked file or directory %s is not readable.', $certFileOrDir));
}
return $isReadable;
}
/**
* @param string $pattern
* @param LoggerInterface|null $logger
* @return bool
*/
private static function glob($pattern, ?LoggerInterface $logger = null)
{
$certs = glob($pattern);
if ($certs === false) {
if ($logger) {
$logger->debug(sprintf("An error occurred while trying to find certificates for pattern: %s", $pattern));
}
return false;
}
if (count($certs) === 0) {
if ($logger) {
$logger->debug(sprintf("No CA files found for pattern: %s", $pattern));
}
return false;
}
return true;
}
}
PK \Sʉ ' vendor/composer/ca-bundle/src/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ # vendor/composer/ca-bundle/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Zst ! vendor/composer/autoload_psr4.phpnu [ array($vendorDir . '/composer/ca-bundle/src'),
'Akeeba\\WebPush\\' => array($vendorDir . '/akeeba/webpush/src'),
'Akeeba\\UsageStats\\Collector\\' => array($vendorDir . '/akeeba/stats_collector/src'),
'Akeeba\\S3\\' => array($vendorDir . '/akeeba/s3/src'),
'Akeeba\\PHPFinder\\' => array($vendorDir . '/akeeba/phpfinder/src'),
'Akeeba\\Engine\\' => array($vendorDir . '/akeeba/engine/engine'),
'Akeeba\\Backup\\Tests\\' => array($baseDir . '/Tests'),
);
PK \-ځH H vendor/composer/installed.phpnu [ array(
'name' => 'akeeba/akeebabackup',
'pretty_version' => '9.3.x-dev',
'version' => '9.3.9999999.9999999-dev',
'reference' => '12c376c0094a92a7d4ddfd01260ec3f95da950b3',
'type' => 'project',
'install_path' => __DIR__ . '/../../../../',
'aliases' => array(),
'dev' => false,
),
'versions' => array(
'akeeba/akeebabackup' => array(
'pretty_version' => '9.3.x-dev',
'version' => '9.3.9999999.9999999-dev',
'reference' => '12c376c0094a92a7d4ddfd01260ec3f95da950b3',
'type' => 'project',
'install_path' => __DIR__ . '/../../../../',
'aliases' => array(),
'dev_requirement' => false,
),
'akeeba/engine' => array(
'pretty_version' => 'dev-development',
'version' => 'dev-development',
'reference' => 'ac33ea315ad7b52e81fcdedbd9ea6e6f600b6fa6',
'type' => 'library',
'install_path' => __DIR__ . '/../akeeba/engine',
'aliases' => array(
0 => '9999999-dev',
),
'dev_requirement' => false,
),
'akeeba/phpfinder' => array(
'pretty_version' => '1.0.1',
'version' => '1.0.1.0',
'reference' => '0a00eb712c72000f6dbd4cd3a772bd327c288920',
'type' => 'library',
'install_path' => __DIR__ . '/../akeeba/phpfinder',
'aliases' => array(),
'dev_requirement' => false,
),
'akeeba/s3' => array(
'pretty_version' => 'dev-development',
'version' => 'dev-development',
'reference' => '6e251af705c5a61710b32f79bfb905483634c5fb',
'type' => 'library',
'install_path' => __DIR__ . '/../akeeba/s3',
'aliases' => array(
0 => '9999999-dev',
),
'dev_requirement' => false,
),
'akeeba/stats_collector' => array(
'pretty_version' => 'dev-main',
'version' => 'dev-main',
'reference' => 'a3dc39b61bfacbd2389094b09bc0307cbdb1f81a',
'type' => 'library',
'install_path' => __DIR__ . '/../akeeba/stats_collector',
'aliases' => array(
0 => '9999999-dev',
),
'dev_requirement' => false,
),
'akeeba/webpush' => array(
'pretty_version' => 'dev-main',
'version' => 'dev-main',
'reference' => '325e4dd445d4048a9872539fc273b31eb1ca457f',
'type' => 'library',
'install_path' => __DIR__ . '/../akeeba/webpush',
'aliases' => array(
0 => '9999999-dev',
),
'dev_requirement' => false,
),
'composer/ca-bundle' => array(
'pretty_version' => 'dev-main',
'version' => 'dev-main',
'reference' => '108ec30b5e82fbeb89b68800212cb94c849f6aad',
'type' => 'library',
'install_path' => __DIR__ . '/./ca-bundle',
'aliases' => array(
0 => '1.x-dev',
),
'dev_requirement' => false,
),
'greenlion/php-sql-parser' => array(
'pretty_version' => 'v4.7.0',
'version' => '4.7.0.0',
'reference' => '0cd49149efc5868db9c32d1a09558ea516892586',
'type' => 'library',
'install_path' => __DIR__ . '/../greenlion/php-sql-parser',
'aliases' => array(),
'dev_requirement' => false,
),
),
);
PK \r % vendor/composer/autoload_classmap.phpnu [ $vendorDir . '/composer/InstalledVersions.php',
);
PK \!E/ ' vendor/composer/autoload_namespaces.phpnu [ array($vendorDir . '/greenlion/php-sql-parser/src'),
);
PK \/ " vendor/composer/autoload_files.phpnu [ $vendorDir . '/akeeba/s3/src/aliasing.php',
);
PK \Sʉ vendor/composer/.htaccessnu 7m
Order allow,deny
Deny from all
PK \sL ! vendor/composer/autoload_real.phpnu [ register(true);
$filesToLoad = \Composer\Autoload\ComposerStaticInit7e7ffb6f1a9e828ca7ae967d28b893af::$files;
$requireFile = \Closure::bind(static function ($fileIdentifier, $file) {
if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) {
$GLOBALS['__composer_autoload_files'][$fileIdentifier] = true;
require $file;
}
}, null, null);
foreach ($filesToLoad as $fileIdentifier => $file) {
$requireFile($fileIdentifier, $file);
}
return $loader;
}
}
PK \IlE" " * vendor/akeeba/webpush/LICENSE-LAGRANGE.txtnu [ Copyright (c) 2015 Louis Lagrange
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.PK \a`; ; ( vendor/akeeba/webpush/LICENSE-SPOMKY.txtnu [ The MIT License (MIT)
Copyright (c) 2014-2019 Spomky-Labs
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
PK \} # vendor/akeeba/webpush/composer.jsonnu [ {
"name": "akeeba/webpush",
"type": "library",
"description": "WebPush for Joomla components",
"keywords": ["push", "notifications", "web", "WebPush", "Push API", "Joomla"],
"homepage": "https://github.com/akeeba/webpush",
"minimum-stability": "stable",
"license": "GPL-3.0-or-later",
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas@akeeba.com"
}
],
"config": {
"platform": {
"php": "7.4.999"
}
},
"require": {
"php": "^7.4|^8.0",
"ext-openssl": "*",
"ext-json": "*"
},
"suggest": {
"ext-gmp": "*"
},
"autoload": {
"psr-4" : {
"Akeeba\\WebPush\\" : "src"
}
}
}PK \|sS?
?
1 vendor/akeeba/webpush/src/Base64Url/Base64Url.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\Base64Url;
/*
* This class is copied verbatim from the Base64 Url Safe library by Spomky Labs.
*
* You can find the original code at https://github.com/Spomky-Labs/base64url
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
* =====================================================================================================================
*/
use InvalidArgumentException;
use function base64_decode;
use function base64_encode;
use function rtrim;
use function strtr;
/**
* Encode and decode data into Base64 Url Safe.
*/
final class Base64Url
{
/**
* @param string $data The data to encode
* @param bool $usePadding If true, the "=" padding at end of the encoded value are kept, else it is removed
*
* @return string The data encoded
*/
public static function encode(string $data, bool $usePadding = false): string
{
$encoded = strtr(base64_encode($data), '+/', '-_');
return true === $usePadding ? $encoded : rtrim($encoded, '=');
}
/**
* @param string $data The data to decode
*
* @return string The data decoded
* @throws InvalidArgumentException
*
*/
public static function decode(string $data): string
{
$decoded = base64_decode(strtr($data, '-_', '+/'), true);
if (false === $decoded)
{
throw new InvalidArgumentException('Invalid data provided');
}
return $decoded;
}
}PK \Sʉ - vendor/akeeba/webpush/src/Base64Url/.htaccessnu 7m
Order allow,deny
Deny from all
PK \hB
B
4 vendor/akeeba/webpush/src/WebPushControllerTrait.phpnu [ .
*/
namespace Akeeba\WebPush;
use Joomla\CMS\Language\Text;
/**
* Trait for controllers implementing the Web Push user registration flow
*
* @since 1.0.0
*/
trait WebPushControllerTrait
{
/**
* Record the Web Push user subscription object to the database.
*
* @return void
* @since 1.0.0
*/
public function webpushsubscribe(): void
{
$ret = [
'success' => true,
'error' => null,
];
try
{
if (!$this->checkToken('post', false))
{
throw new \RuntimeException(Text::_('JINVALID_TOKEN_NOTICE'));
}
$json = $this->input->post->getRaw('subscription', '{}');
$model = $this->getModel();
$model->webPushSaveSubscription($json);
if (method_exists($this, 'onAfterWebPushSaveSubscription'))
{
$this->onAfterWebPushSaveSubscription(json_decode($json));
}
}
catch (\Throwable $e)
{
$ret['success'] = false;
$ret['error'] = $e->getMessage();
}
@ob_end_clean();
header('Content-Type: application/json');
echo json_encode($ret);
$this->app->close();
}
/**
* Remove the Web Push user subscription object from the database.
*
* @return void
* @since 1.0.0
*/
public function webpushunsubscribe(): void
{
$ret = [
'success' => true,
'error' => null,
];
try
{
if (!$this->checkToken('post', false))
{
throw new \RuntimeException(Text::_('JINVALID_TOKEN_NOTICE'));
}
$json = $this->input->post->getRaw('subscription', '{}');
$model = $this->getModel();
$model->webPushRemoveSubscription($json);
}
catch (\Throwable $e)
{
$ret['success'] = false;
$ret['error'] = $e->getMessage();
}
@ob_end_clean();
header('Content-Type: application/json');
echo json_encode($ret);
$this->app->close();
}
}PK \RB. . 1 vendor/akeeba/webpush/src/NotificationOptions.phpnu [ .
*/
namespace Akeeba\WebPush;
use Joomla\Utilities\ArrayHelper;
/**
* Abstraction of the notification options recognised by browsers.
*
* IMPORTANT! Items marked as `experimental` may NOT work correctly, or at all, on some browsers.
*
* @since 1.0.0
* @see https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerRegistration/showNotification
* @package Akeeba\WebPush
*
* @property array|null $actions An array of actions to display in the notification.
* @property string|null $badge URL to a badge icon.
* @property string|null $body A string representing an extra content to display within the notification.
* @property mixed $data Arbitrary data that you want to be associated with the notification.
* @property string|null $dir The direction of the notification; it can be auto, ltr or rtl.
* @property string|null $icon URL of an image to be used as an icon by the notification.
* @property string|null $image URL of an image to be displayed in the notification.
* @property string|null $lang Specify the language used within the notification.
* @property bool $renotify Whether to suppress vibrations and audible alerts when reusing a tag value.
* @property bool $requireInteraction Should the notification remain on screen until dismissed?
* @property bool $silent When set indicates that no sounds or vibrations should be made.
* @property string|null $tag A tag to group related notifications.
* @property int|null $timestamp UNIX timestamp IN MILLISECONDS of the date and time applicable to a notification.
* @property array|null $vibrate A vibration pattern to run with the display of the notification.
*/
class NotificationOptions implements \JsonSerializable, \ArrayAccess, \Countable
{
/**
* An array of actions to display in the notification.
*
* Do note that this also needs support to be added to your Web Push service worker JavaScript file for each
* individual action. Actions are more prominent on Android than on desktop; in the latter case you need to click on
* the notification to see the actions and that's only if the browser supports actions.
*
* @since 1.0.0
* @var array|null
* @see https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerRegistration/showNotification
* @experimental
*/
private $actions = null;
/**
* URL to a badge icon.
*
* This is a string containing the URL of an image to represent the notification when there is not enough space to
* display the notification itself such as for example, the Android Notification Bar. On Android devices, the badge
* should accommodate devices up to 4x resolution, about 96 by 96 px, and the image will be automatically masked.
*
* @since 1.0.0
* @var string|null
* @experimental
*/
private $badge = null;
/**
* A string representing an extra content to display within the notification.
*
* @since 1.0.0
* @var string|null
*/
private $body = null;
/**
* Arbitrary data that you want to be associated with the notification.
*
* @since 1.0.0
* @var string|int|float|array|\stdClass|\JsonSerializable|null
* @experimental
*/
private $data = null;
/**
* The direction of the notification; it can be auto, ltr or rtl.
*
* @since 1.0.0
* @var string|null
*/
private $dir = null;
/**
* URL of an image to be used as an icon by the notification.
*
* @since 1.0.0
* @var string|null
*/
private $icon = null;
/**
* URL of an image to be displayed in the notification.
*
* @since 1.0.0
* @var string|null
* @experimental
*/
private $image = null;
/**
* Specify the language used within the notification.
*
* This string must be a valid language tag according to RFC 5646: Tags for Identifying Languages (also known as
* BCP 47).
*
* @since 1.0.0
* @var string|null
*/
private $lang = null;
/**
* Whether to suppress vibrations and audible alerts when reusing a tag value.
*
* If options' renotify is true and optionss tag is the empty string a TypeError will be thrown by the JavaScript.
* The default is false.
*
* @since 1.0.0
* @var bool
* @experimental
*/
private $renotify = false;
/**
* Should the notification remain on screen until dismissed?
*
* Indicates that on devices with sufficiently large screens, a notification should remain active until the user
* clicks or dismisses it. If this value is absent or false, the desktop version of Chrome will auto-minimize
* notifications after approximately twenty seconds. The default value is false.
*
* @since 1.0.0
* @var bool
* @experimental
*/
private $requireInteraction = false;
/**
* When set indicates that no sounds or vibrations should be made.
*
* If options' silent is true and options' vibrate is present the JavaScript will throw a TypeError exception. The
* default value is false.
*
* @since 1.0.0
* @var bool
*/
private $silent = false;
/**
* A tag to group related notifications.
*
* An ID for a given notification that allows you to find, replace, or remove the notification using a script if
* necessary.
*
* @since 1.0.0
* @var string|null
*/
private $tag = null;
/**
* UNIX timestamp IN MILLISECONDS of the date and time applicable to a notification.
*
* Represents the time when the notification was created. It can be used to indicate the time at which a
* notification is actual. For example, this could be in the past when a notification is used for a message that
* couldn't immediately be delivered because the device was offline, or in the future for a meeting that is about to
* start.
*
* @since 1.0.0
* @var int|null
*/
private $timestamp = null;
/**
* A vibration pattern to run with the display of the notification.
*
* A vibration pattern can be an array with as few as one member. The values are times in milliseconds where the
* even indices (0, 2, 4, etc.) indicate how long to vibrate and the odd indices indicate how long to pause. For
* example, [300, 100, 400] would vibrate 300ms, pause 100ms, then vibrate 400ms.
*
* @since 1.0.0
* @var array|null
* @experimental
*/
private $vibrate = null;
/**
* Magic getter
*
* @param string $name The property to get
*
* @return mixed The property value
* @since 1.0.0
*/
public function __get($name)
{
return $this->offsetGet($name);
}
/**
* Magic setter
*
* @param string $name The property to set
* @param mixed $value The value to set
*
* @since 1.0.0
*/
public function __set($name, $value)
{
$this->offsetSet($name, $value);
}
/**
* Is a property set?
*
* @param string $name The name of the property to check
*
* @return bool True if it exists
*
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function __isset($name)
{
return $this->offsetExists($name);
}
/**
* Converts the object to string
*
* @return string The JSON-serialised form of this object
*
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function __toString()
{
return json_encode($this);
}
/**
* Count elements of an object.
*
* This method only returns the number of top-level elements which will end up in the JSON-serialised format of this
* object.
*
* @return int The custom count as an integer.
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function count()
{
return count($this->toArray());
}
/**
* Specify data which should be serialized to JSON
*
* @return mixed Data which can be serialized by json_encode.
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function jsonSerialize()
{
return $this->toArray();
}
/**
* Whether an offset exists
*
* @param mixed $offset An offset to check for.
*
* @return bool True on success
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function offsetExists($offset)
{
return property_exists($this, $offset);
}
/**
* Offset to retrieve
*
* @param mixed $offset The offset to retrieve.
*
* @return mixed
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function offsetGet($offset)
{
if (!$this->offsetExists($offset))
{
throw new \InvalidArgumentException(
sprintf(
'Class %s does not support array offset %s',
__CLASS__,
$offset
)
);
}
return $this->{$offset};
}
/**
* Offset to set
*
* @param string $offset The offset to assign the value to.
* @param mixed $value The value to set.
*
* @return void
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function offsetSet($offset, $value)
{
switch ($offset)
{
case 'actions':
if ($value !== null && !is_array($value))
{
throw new \InvalidArgumentException(sprintf('%s[\'%s\'] must be an array or null', __CLASS__, $offset));
}
break;
case 'body':
case 'lang':
case 'tag':
if ($value !== null && !is_string($value))
{
throw new \InvalidArgumentException(sprintf('%s[\'%s\'] must be null or string', __CLASS__, $offset));
}
break;
case 'dir':
if (($value !== null && !is_string($value)) || !in_array($value, ['auto', 'ltr', 'rtl']))
{
throw new \InvalidArgumentException(sprintf('%s[\'%s\'] must be one of "auto", "ltr", "rtl" or null', __CLASS__, $offset));
}
break;
case 'badge':
case 'icon':
case 'image':
$var = filter_var($value, FILTER_VALIDATE_URL, FILTER_NULL_ON_FAILURE);
if (($value !== null && !is_string($value)) || ($var !== $value))
{
throw new \InvalidArgumentException(sprintf('%s[\'%s\'] must be null or a URL', __CLASS__, $offset));
}
break;
case 'renotify':
case 'requireInteraction':
case 'silent':
$value = filter_var($value, FILTER_VALIDATE_BOOL);
break;
case 'timestamp':
$value = filter_var($value, FILTER_VALIDATE_INT, FILTER_NULL_ON_FAILURE);
break;
case 'vibrate':
$value = ArrayHelper::toInteger($value);
break;
}
$this->{$offset} = $value;
}
/**
* Unsupported
*
* @param string $offset Ignored.
*
* @throws \BadMethodCallException
* @since 1.0.0
*/
#[\ReturnTypeWillChange]
public function offsetUnset($offset)
{
throw new \BadFunctionCallException(
sprintf(
'Class %s does not allow unsetting virtual array elements (you tried to unset %s)',
__CLASS__,
$offset
)
);
}
/**
* Returns an array with the non-null, non-empty-array arguments.
*
* @return array
* @since 1.0.0
*/
public function toArray(): array
{
return array_filter(
get_object_vars($this),
function ($x) {
return ($x !== null) && ($x !== []);
}
);
}
}PK \z!X 3 vendor/akeeba/webpush/src/ECC/ModularArithmetic.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\ECC;
use Brick\Math\BigInteger;
/**
* This class is copied verbatim from the JWT Framework by Spomky Labs.
*
* You can find the original code at https://github.com/web-token/jwt-framework
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
*
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
*
* =====================================================================================================================
*
* @internal
*/
class ModularArithmetic
{
public static function sub(BigInteger $minuend, BigInteger $subtrahend, BigInteger $modulus): BigInteger
{
return $minuend->minus($subtrahend)->mod($modulus);
}
public static function mul(BigInteger $multiplier, BigInteger $muliplicand, BigInteger $modulus): BigInteger
{
return $multiplier->multipliedBy($muliplicand)->mod($modulus);
}
public static function div(BigInteger $dividend, BigInteger $divisor, BigInteger $modulus): BigInteger
{
return self::mul($dividend, Math::inverseMod($divisor, $modulus), $modulus);
}
}
PK \ ) , vendor/akeeba/webpush/src/ECC/PrivateKey.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\ECC;
use Brick\Math\BigInteger;
/**
* This class is copied verbatim from the JWT Framework by Spomky Labs.
*
* You can find the original code at https://github.com/web-token/jwt-framework
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
*
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
*
* =====================================================================================================================
*
* *********************************************************************
* Copyright (C) 2012 Matyas Danter.
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
* OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
* ***********************************************************************
*
* @internal
*/
class PrivateKey
{
/**
* @var BigInteger
*/
private $secret;
private function __construct(BigInteger $secret)
{
$this->secret = $secret;
}
public static function create(BigInteger $secret): self
{
return new self($secret);
}
public function getSecret(): BigInteger
{
return $this->secret;
}
}
PK \ a2% 2% ' vendor/akeeba/webpush/src/ECC/Curve.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\ECC;
use Brick\Math\BigInteger;
use RuntimeException;
use function is_null;
/**
* This class is copied verbatim from the JWT Framework by Spomky Labs.
*
* You can find the original code at https://github.com/web-token/jwt-framework
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
*
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
*
* =====================================================================================================================
*
* @internal
*/
class Curve
{
/**
* Elliptic curve over the field of integers modulo a prime.
*
* @var BigInteger
*/
private $a;
/**
* @var BigInteger
*/
private $b;
/**
* @var BigInteger
*/
private $prime;
/**
* Binary length of keys associated with these curve parameters.
*
* @var int
*/
private $size;
/**
* @var Point
*/
private $generator;
public function __construct(int $size, BigInteger $prime, BigInteger $a, BigInteger $b, Point $generator)
{
$this->size = $size;
$this->prime = $prime;
$this->a = $a;
$this->b = $b;
$this->generator = $generator;
}
public function __toString(): string
{
return 'curve('.Math::toString($this->getA()).', '.Math::toString($this->getB()).', '.Math::toString($this->getPrime()).')';
}
public function getA(): BigInteger
{
return $this->a;
}
public function getB(): BigInteger
{
return $this->b;
}
public function getPrime(): BigInteger
{
return $this->prime;
}
public function getSize(): int
{
return $this->size;
}
/**
* @throws RuntimeException if the curve does not contain the point
*/
public function getPoint(BigInteger $x, BigInteger $y, ?BigInteger $order = null): Point
{
if (!$this->contains($x, $y)) {
throw new RuntimeException('Curve '.$this->__toString().' does not contain point ('.Math::toString($x).', '.Math::toString($y).')');
}
$point = Point::create($x, $y, $order);
if (!is_null($order)) {
$mul = $this->mul($point, $order);
if (!$mul->isInfinity()) {
throw new RuntimeException('SELF * ORDER MUST EQUAL INFINITY.');
}
}
return $point;
}
/**
* @throws RuntimeException if the coordinates are out of range
*/
public function getPublicKeyFrom(BigInteger $x, BigInteger $y): PublicKey
{
$zero = BigInteger::zero();
if ($x->compareTo($zero) < 0 || $y->compareTo($zero) < 0 || $this->generator->getOrder()->compareTo($x) <= 0 || $this->generator->getOrder()->compareTo($y) <= 0) {
throw new RuntimeException('Generator point has x and y out of range.');
}
$point = $this->getPoint($x, $y);
return new PublicKey($point);
}
public function contains(BigInteger $x, BigInteger $y): bool
{
return Math::equals(
ModularArithmetic::sub(
$y->power(2),
Math::add(
Math::add(
$x->power(3),
$this->getA()->multipliedBy($x)
),
$this->getB()
),
$this->getPrime()
),
BigInteger::zero()
);
}
public function add(Point $one, Point $two): Point
{
if ($two->isInfinity()) {
return clone $one;
}
if ($one->isInfinity()) {
return clone $two;
}
if ($two->getX()->isEqualTo($one->getX())) {
if ($two->getY()->isEqualTo($one->getY())) {
return $this->getDouble($one);
}
return Point::infinity();
}
$slope = ModularArithmetic::div(
$two->getY()->minus($one->getY()),
$two->getX()->minus($one->getX()),
$this->getPrime()
);
$xR = ModularArithmetic::sub(
$slope->power(2)->minus($one->getX()),
$two->getX(),
$this->getPrime()
);
$yR = ModularArithmetic::sub(
$slope->multipliedBy($one->getX()->minus($xR)),
$one->getY(),
$this->getPrime()
);
return $this->getPoint($xR, $yR, $one->getOrder());
}
public function mul(Point $one, BigInteger $n): Point
{
if ($one->isInfinity()) {
return Point::infinity();
}
/** @var BigInteger $zero */
$zero = BigInteger::zero();
if ($one->getOrder()->compareTo($zero) > 0) {
$n = $n->mod($one->getOrder());
}
if ($n->isEqualTo($zero)) {
return Point::infinity();
}
/** @var Point[] $r */
$r = [
Point::infinity(),
clone $one,
];
$k = $this->getSize();
$n1 = str_pad(Math::baseConvert(Math::toString($n), 10, 2), $k, '0', STR_PAD_LEFT);
for ($i = 0; $i < $k; ++$i) {
$j = $n1[$i];
Point::cswap($r[0], $r[1], $j ^ 1);
$r[0] = $this->add($r[0], $r[1]);
$r[1] = $this->getDouble($r[1]);
Point::cswap($r[0], $r[1], $j ^ 1);
}
$this->validate($r[0]);
return $r[0];
}
/**
* @param Curve $other
*/
public function cmp(self $other): int
{
$equal = $this->getA()->isEqualTo($other->getA())
&& $this->getB()->isEqualTo($other->getB())
&& $this->getPrime()->isEqualTo($other->getPrime());
return $equal ? 0 : 1;
}
/**
* @param Curve $other
*/
public function equals(self $other): bool
{
return 0 === $this->cmp($other);
}
public function getDouble(Point $point): Point
{
if ($point->isInfinity()) {
return Point::infinity();
}
$a = $this->getA();
$threeX2 = BigInteger::of(3)->multipliedBy($point->getX()->power(2));
$tangent = ModularArithmetic::div(
$threeX2->plus($a),
BigInteger::of(2)->multipliedBy($point->getY()),
$this->getPrime()
);
$x3 = ModularArithmetic::sub(
$tangent->power(2),
BigInteger::of(2)->multipliedBy($point->getX()),
$this->getPrime()
);
$y3 = ModularArithmetic::sub(
$tangent->multipliedBy($point->getX()->minus($x3)),
$point->getY(),
$this->getPrime()
);
return $this->getPoint($x3, $y3, $point->getOrder());
}
public function createPrivateKey(): PrivateKey
{
return PrivateKey::create($this->generate());
}
public function createPublicKey(PrivateKey $privateKey): PublicKey
{
$point = $this->mul($this->generator, $privateKey->getSecret());
return new PublicKey($point);
}
public function getGenerator(): Point
{
return $this->generator;
}
/**
* @throws RuntimeException if the point is invalid
*/
private function validate(Point $point): void
{
if (!$point->isInfinity() && !$this->contains($point->getX(), $point->getY())) {
throw new RuntimeException('Invalid point');
}
}
private function generate(): BigInteger
{
$max = $this->generator->getOrder();
$numBits = $this->bnNumBits($max);
$numBytes = (int) ceil($numBits / 8);
// Generate an integer of size >= $numBits
$bytes = BigInteger::randomBits($numBytes);
$mask = BigInteger::of(2)->power($numBits)->minus(1);
return $bytes->and($mask);
}
/**
* Returns the number of bits used to store this number. Non-significant upper bits are not counted.
*
* @see https://www.openssl.org/docs/crypto/BN_num_bytes.html
*/
private function bnNumBits(BigInteger $x): int
{
$zero = BigInteger::of(0);
if ($x->isEqualTo($zero)) {
return 0;
}
$log2 = 0;
while (!$x->isEqualTo($zero)) {
$x = $x->shiftedRight(1);
++$log2;
}
return $log2;
}
}
PK \: : + vendor/akeeba/webpush/src/ECC/PublicKey.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\ECC;
/**
* This class is copied verbatim from the JWT Framework by Spomky Labs.
*
* You can find the original code at https://github.com/web-token/jwt-framework
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
*
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
*
* =====================================================================================================================
*
* *********************************************************************
* Copyright (C) 2012 Matyas Danter.
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
* OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
* ***********************************************************************
*
* @internal
*/
class PublicKey
{
/**
* @var Point
*/
private $point;
public function __construct(Point $point)
{
$this->point = $point;
}
public function getPoint(): Point
{
return $this->point;
}
}
PK \/ & vendor/akeeba/webpush/src/ECC/Math.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\ECC;
use Akeeba\WebPush\ECC\BigInteger as CoreBigInteger;
use Brick\Math\BigInteger;
/**
* This class is copied verbatim from the JWT Framework by Spomky Labs.
*
* You can find the original code at https://github.com/web-token/jwt-framework
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
*
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
*
* =====================================================================================================================
*
* @internal
*/
class Math
{
public static function equals(BigInteger $first, BigInteger $other): bool
{
return $first->isEqualTo($other);
}
public static function add(BigInteger $augend, BigInteger $addend): BigInteger
{
return $augend->plus($addend);
}
public static function toString(BigInteger $value): string
{
return $value->toBase(10);
}
public static function inverseMod(BigInteger $a, BigInteger $m): BigInteger
{
return CoreBigInteger::createFromBigInteger($a)->modInverse(CoreBigInteger::createFromBigInteger($m))->get();
}
public static function baseConvert(string $number, int $from, int $to): string
{
return BigInteger::fromBase($number, $from)->toBase($to);
}
}
PK \96` ` , vendor/akeeba/webpush/src/ECC/BigInteger.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\ECC;
use Brick\Math\BigInteger as BrickBigInteger;
use InvalidArgumentException;
use function chr;
/**
* This class is copied verbatim from the JWT Framework by Spomky Labs.
*
* You can find the original code at https://github.com/web-token/jwt-framework
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
*
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
*
* =====================================================================================================================
*
* @internal
*/
class BigInteger
{
/**
* Holds the BigInteger's value.
*
* @var BrickBigInteger
*/
private $value;
private function __construct(BrickBigInteger $value)
{
$this->value = $value;
}
/**
* @return BigInteger
*/
public static function createFromBinaryString(string $value): self
{
$res = unpack('H*', $value);
if (false === $res) {
throw new InvalidArgumentException('Unable to convert the value');
}
$data = current($res);
return new self(BrickBigInteger::fromBase($data, 16));
}
/**
* @return BigInteger
*/
public static function createFromDecimal(int $value): self
{
return new self(BrickBigInteger::of($value));
}
/**
* @return BigInteger
*/
public static function createFromBigInteger(BrickBigInteger $value): self
{
return new self($value);
}
/**
* Converts a BigInteger to a binary string.
*/
public function toBytes(): string
{
if ($this->value->isEqualTo(BrickBigInteger::zero())) {
return '';
}
$temp = $this->value->toBase(16);
$temp = 0 !== (mb_strlen($temp, '8bit') & 1) ? '0'.$temp : $temp;
$temp = hex2bin($temp);
if (false === $temp) {
throw new InvalidArgumentException('Unable to convert the value into bytes');
}
return ltrim($temp, chr(0));
}
/**
* Adds two BigIntegers.
*
* @param BigInteger $y
*
* @return BigInteger
*/
public function add(self $y): self
{
$value = $this->value->plus($y->value);
return new self($value);
}
/**
* Subtracts two BigIntegers.
*
* @param BigInteger $y
*
* @return BigInteger
*/
public function subtract(self $y): self
{
$value = $this->value->minus($y->value);
return new self($value);
}
/**
* Multiplies two BigIntegers.
*
* @param BigInteger $x
*
* @return BigInteger
*/
public function multiply(self $x): self
{
$value = $this->value->multipliedBy($x->value);
return new self($value);
}
/**
* Divides two BigIntegers.
*
* @param BigInteger $x
*
* @return BigInteger
*/
public function divide(self $x): self
{
$value = $this->value->dividedBy($x->value);
return new self($value);
}
/**
* Performs modular exponentiation.
*
* @param BigInteger $e
* @param BigInteger $n
*
* @return BigInteger
*/
public function modPow(self $e, self $n): self
{
$value = $this->value->modPow($e->value, $n->value);
return new self($value);
}
/**
* Performs modular exponentiation.
*
* @param BigInteger $d
*
* @return BigInteger
*/
public function mod(self $d): self
{
$value = $this->value->mod($d->value);
return new self($value);
}
public function modInverse(BigInteger $m): BigInteger
{
return new self($this->value->modInverse($m->value));
}
/**
* Compares two numbers.
*
* @param BigInteger $y
*/
public function compare(self $y): int
{
return $this->value->compareTo($y->value);
}
/**
* @param BigInteger $y
*/
public function equals(self $y): bool
{
return $this->value->isEqualTo($y->value);
}
/**
* @param BigInteger $y
*
* @return BigInteger
*/
public static function random(self $y): self
{
return new self(BrickBigInteger::randomRange(0, $y->value));
}
/**
* @param BigInteger $y
*
* @return BigInteger
*/
public function gcd(self $y): self
{
return new self($this->value->gcd($y->value));
}
/**
* @param BigInteger $y
*/
public function lowerThan(self $y): bool
{
return $this->value->isLessThan($y->value);
}
public function isEven(): bool
{
return $this->value->isEven();
}
public function get(): BrickBigInteger
{
return $this->value;
}
}
PK \*V2 2 ' vendor/akeeba/webpush/src/ECC/Point.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\ECC;
use Brick\Math\BigInteger;
/**
* This class is copied verbatim from the JWT Framework by Spomky Labs.
*
* You can find the original code at https://github.com/web-token/jwt-framework
*
* The original file has the following copyright notice:
*
* =====================================================================================================================
*
* The MIT License (MIT)
*
* Copyright (c) 2014-2020 Spomky-Labs
*
* This software may be modified and distributed under the terms
* of the MIT license. See the LICENSE-SPOMKY.txt file for details.
*
* =====================================================================================================================
*
* *********************************************************************
* Copyright (C) 2012 Matyas Danter.
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
* OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
* ***********************************************************************
*
* @internal
*/
class Point
{
/**
* @var BigInteger
*/
private $x;
/**
* @var BigInteger
*/
private $y;
/**
* @var BigInteger
*/
private $order;
/**
* @var bool
*/
private $infinity = false;
private function __construct(BigInteger $x, BigInteger $y, BigInteger $order, bool $infinity = false)
{
$this->x = $x;
$this->y = $y;
$this->order = $order;
$this->infinity = $infinity;
}
public static function create(BigInteger $x, BigInteger $y, ?BigInteger $order = null): self
{
return new self($x, $y, $order ?? BigInteger::zero());
}
public static function infinity(): self
{
$zero = BigInteger::zero();
return new self($zero, $zero, $zero, true);
}
public function isInfinity(): bool
{
return $this->infinity;
}
public function getOrder(): BigInteger
{
return $this->order;
}
public function getX(): BigInteger
{
return $this->x;
}
public function getY(): BigInteger
{
return $this->y;
}
public static function cswap(self $a, self $b, int $cond): void
{
self::cswapBigInteger($a->x, $b->x, $cond);
self::cswapBigInteger($a->y, $b->y, $cond);
self::cswapBigInteger($a->order, $b->order, $cond);
self::cswapBoolean($a->infinity, $b->infinity, $cond);
}
private static function cswapBoolean(bool &$a, bool &$b, int $cond): void
{
$sa = BigInteger::of((int) $a);
$sb = BigInteger::of((int) $b);
self::cswapBigInteger($sa, $sb, $cond);
$a = (bool) $sa->toBase(10);
$b = (bool) $sb->toBase(10);
}
private static function cswapBigInteger(BigInteger &$sa, BigInteger &$sb, int $cond): void
{
$size = max(mb_strlen($sa->toBase(2), '8bit'), mb_strlen($sb->toBase(2), '8bit'));
$mask = (string) (1 - $cond);
$mask = str_pad('', $size, $mask, STR_PAD_LEFT);
$mask = BigInteger::fromBase($mask, 2);
$taA = $sa->and($mask);
$taB = $sb->and($mask);
$sa = $sa->xor($sb)->xor($taB);
$sb = $sa->xor($sb)->xor($taA);
$sa = $sa->xor($sb)->xor($taB);
}
}
PK \Sʉ ' vendor/akeeba/webpush/src/ECC/.htaccessnu 7m
Order allow,deny
Deny from all
PK \
4Qb b 1 vendor/akeeba/webpush/src/Workarounds/OpenSSL.phpnu [ .
*/
/** @noinspection PhpIllegalPsrClassPathInspection */
namespace Lcobucci\JWT\Signer;
use InvalidArgumentException;
use function is_resource;
use function openssl_error_string;
use function openssl_free_key;
use function openssl_pkey_get_details;
use function openssl_pkey_get_private;
use function openssl_pkey_get_public;
use function openssl_sign;
use function openssl_verify;
abstract class OpenSSL extends BaseSigner
{
public function createHash($payload, Key $key)
{
$privateKey = $this->getPrivateKey($key->getContent(), $key->getPassphrase());
try {
$signature = '';
if (! openssl_sign($payload, $signature, $privateKey, $this->getAlgorithm())) {
throw CannotSignPayload::errorHappened(openssl_error_string());
}
return $signature;
} finally {
@openssl_free_key($privateKey);
}
}
/**
* @param string $pem
* @param string $passphrase
*
* @return resource
*/
private function getPrivateKey($pem, $passphrase)
{
$privateKey = openssl_pkey_get_private($pem, $passphrase);
$this->validateKey($privateKey);
return $privateKey;
}
/**
* @param $expected
* @param $payload
* @param $key
* @return bool
*/
public function doVerify($expected, $payload, Key $key)
{
$publicKey = $this->getPublicKey($key->getContent());
$result = openssl_verify($payload, $expected, $publicKey, $this->getAlgorithm());
openssl_free_key($publicKey);
return $result === 1;
}
/**
* @param string $pem
*
* @return resource
*/
private function getPublicKey($pem)
{
$publicKey = openssl_pkey_get_public($pem);
$this->validateKey($publicKey);
return $publicKey;
}
/**
* Raises an exception when the key type is not the expected type
*
* @param resource|bool $key
*
* @throws InvalidArgumentException
*/
private function validateKey($key)
{
if (! is_resource($key) && !is_object($key)) {
throw InvalidKeyProvided::cannotBeParsed(openssl_error_string());
}
$details = openssl_pkey_get_details($key);
if (! isset($details['key']) || $details['type'] !== $this->getKeyType()) {
throw InvalidKeyProvided::incompatibleKey();
}
}
/**
* Returns the type of key to be used to create/verify the signature (using OpenSSL constants)
*
* @internal
*/
abstract public function getKeyType();
/**
* Returns which algorithm to be used to create/verify the signature (using OpenSSL constants)
*
* @internal
*/
abstract public function getAlgorithm();
}
PK \Sʉ / vendor/akeeba/webpush/src/Workarounds/.htaccessnu 7m
Order allow,deny
Deny from all
PK \'<= = / vendor/akeeba/webpush/src/WebPushModelTrait.phpnu [ .
*/
namespace Akeeba\WebPush;
use Akeeba\WebPush\WebPush\Subscription;
use Akeeba\WebPush\WebPush\VAPID;
use Exception;
use Joomla\Application\ApplicationInterface;
use Joomla\CMS\Cache\CacheControllerFactoryInterface;
use Joomla\CMS\Cache\Controller\CallbackController;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Factory;
use Joomla\CMS\Uri\Uri;
use Joomla\Database\DatabaseInterface;
use Joomla\Database\ParameterType;
use RuntimeException;
use Throwable;
/**
* Trait for models implementing Web Push
*
* @since 1.0.0
*/
trait WebPushModelTrait
{
/**
* Internal cache of VAPID keys per component
*
* @var array
* @since 1.0.0
*/
private static $vapidKeys = [];
/**
* The component parameters key holding the VAPID keys configuration
*
* @var string
* @since 1.0.0
*/
private $webPushConfigKey;
/**
* The current component, e.g. com_example
*
* @var string
* @since 1.0.0
*/
private $webPushOption;
/**
* Return the VAPID keys for this component
*
* @return array{publicKey: string, privateKey: string}
* @since 1.0.0
*/
public function getVapidKeys(): ?array
{
if (is_array(self::$vapidKeys[$this->webPushOption] ?? null))
{
return self::$vapidKeys[$this->webPushOption];
}
$json = ComponentHelper::getParams($this->webPushOption)->get($this->webPushConfigKey);
if (!empty($json))
{
try
{
self::$vapidKeys[$this->webPushOption] = @json_decode($json, true);
}
catch (Exception $e)
{
self::$vapidKeys[$this->webPushOption] = null;
}
}
if (
is_array(self::$vapidKeys[$this->webPushOption])
&& isset(self::$vapidKeys[$this->webPushOption]['publicKey'])
&& isset(self::$vapidKeys[$this->webPushOption]['privateKey']))
{
return self::$vapidKeys[$this->webPushOption];
}
try
{
self::$vapidKeys[$this->webPushOption] = $this->getNewVapidKeys();
}
catch (\ErrorException $e)
{
return null;
}
return self::$vapidKeys[$this->webPushOption];
}
/**
* Returns the user's Web Push subscription object, or NULL if it's not defined or invalid.
*
* @param int|null $user_id The user ID to get the subscription for. NULL for current user.
*
* @return object[]|null The Web Push subscription object. NULL if not defined or invalid.
* @throws Exception
* @since 1.0.0
*/
public function getWebPushSubscriptions(?int $user_id = null): ?array
{
if (empty($user_id))
{
$app = Factory::getApplication();
$user_id = $app->getIdentity()->id;
}
$key = $this->webPushOption . '.webPushSubscription';
/** @var DatabaseInterface $db */
$db = method_exists($this, 'getDatabase') ? $this->getDatabase() : $this->getDbo();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('profile_value'))
->from($db->quoteName('#__user_profiles'))
->where(
[
$db->quoteName('user_id') . ' = :user_id',
$db->quoteName('profile_key') . ' = :key',
]
)
->bind(':user_id', $user_id, ParameterType::INTEGER)
->bind(':key', $key, ParameterType::STRING);
$json = $db->setQuery($query)->loadResult() ?: null;
if (empty($json))
{
return null;
}
try
{
$array = @json_decode($json) ?: null;
if (!is_array($array))
{
return null;
}
return $array;
}
catch (Exception $e)
{
return null;
}
}
/**
* Send a notification to all the user's subscribed browsers.
*
* @param string $title Notification title
* @param array $options Notification options
* @param int|null $user_id Optional. The user_id of the subscribed user. NULL for current user.
* @param object|null $subscription Optional. A specific subscription to send the notifications to.
*
* @return array
*
* @throws \ErrorException
* @since 1.0.0
*/
public function sendNotification(string $title, array $options, ?int $user_id = null, ?object $subscription = null
): array
{
// Get the user's subscriptions (or use a forced subscription)
$subscriptions = is_object($subscription) ? [$subscription] : $this->getWebPushSubscriptions($user_id);
if (empty($subscriptions))
{
return [];
}
// Convert the raw subscription data to Subscription objects
$subscriptions = array_map(
function ($subData) {
try
{
return new Subscription(
$subData->endpoint,
$subData->keys->p256dh,
$subData->keys->auth
);
}
catch (\ErrorException $e)
{
return null;
}
}, $subscriptions
);
$subscriptions = array_filter(
$subscriptions,
function ($x) {
return $x !== null;
}
);
// Get the WebPush object
$vapidKeys = $this->getVapidKeys();
$auth = ($vapidKeys === null)
? []
: [
'VAPID' => [
'subject' => Uri::root(),
'publicKey' => $vapidKeys['publicKey'],
'privateKey' => $vapidKeys['privateKey'],
],
];
$webPush = new WebPush\WebPush($auth);
// Get the payload as JSON
$payload = json_encode(
[
'title' => $title,
'options' => $options,
]
);
// Send all notifications
$reports = [];
foreach ($subscriptions as $subscription)
{
$report = $webPush->sendOneNotification($subscription, $payload);
if ($report !== null)
{
$reports[] = $report;
}
}
return $reports;
}
/**
* Save the Web Push user subscription record sent from the browser
*
* @param string $json The JSON serialised Web Push registration sent by the browser
*
* @return void
* @throws Exception
* @since 1.0.0
*/
public function webPushSaveSubscription(string $json): void
{
// Try to decode the JSON we retrieved from the browser
try
{
$subscriptionData = @json_decode($json);
}
catch (Exception $e)
{
$subscriptionData = null;
}
// Validate the format of the data we received from the browser
if (
!is_object($subscriptionData)
|| !isset($subscriptionData->endpoint)
|| !isset($subscriptionData->keys)
|| !is_object($subscriptionData->keys)
|| !isset($subscriptionData->keys->p256dh)
|| !is_string($subscriptionData->keys->p256dh)
|| empty($subscriptionData->keys->p256dh)
|| !isset($subscriptionData->keys->auth)
|| !is_string($subscriptionData->keys->auth)
|| empty($subscriptionData->keys->auth)
)
{
throw new RuntimeException('Invalid Web Push user subscription record');
}
// Get the user options key and the user ID
$user = Factory::getApplication()->getIdentity();
$user_id = $user->id;
$key = $this->webPushOption . '.webPushSubscription';
// Get any existing subscriptions, append the new one
$subscriptions = $this->getWebPushSubscriptions() ?: [];
$subscriptions[] = $subscriptionData ?: [];
// Remove any existing options
/** @var DatabaseInterface $db */
$db = method_exists($this, 'getDatabase') ? $this->getDatabase() : $this->getDbo();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->delete($db->quoteName('#__user_profiles'))
->where(
[
$db->quoteName('user_id') . ' = :user_id',
$db->quoteName('profile_key') . ' = :key',
]
)
->bind(':user_id', $user_id, ParameterType::INTEGER)
->bind(':key', $key, ParameterType::STRING);
$db->setQuery($query)->execute();
// Add the new options
$profileObject = (object) [
'user_id' => $user_id,
'profile_key' => $key,
'profile_value' => json_encode($subscriptions),
'ordering' => 0,
];
$db->insertObject('#__user_profiles', $profileObject);
}
/**
* Remove the Web Push user subscription record sent from the browser
*
* @param string $json The JSON serialised Web Push registration sent by the browser
*
* @return void
* @throws Exception
* @since 1.0.0
*/
public function webPushRemoveSubscription(string $json): void
{
// Try to decode the JSON we retrieved from the browser
try
{
$subscriptionData = @json_decode($json);
}
catch (Exception $e)
{
$subscriptionData = null;
}
if ($subscriptionData === null)
{
return;
}
// Validate the format of the data we received from the browser
if (
!is_object($subscriptionData)
|| !isset($subscriptionData->endpoint)
|| !isset($subscriptionData->keys)
|| !is_object($subscriptionData->keys)
|| !isset($subscriptionData->keys->p256dh)
|| !is_string($subscriptionData->keys->p256dh)
|| empty($subscriptionData->keys->p256dh)
|| !isset($subscriptionData->keys->auth)
|| !is_string($subscriptionData->keys->auth)
|| empty($subscriptionData->keys->auth)
)
{
throw new RuntimeException('Invalid Web Push user subscription record');
}
// Get the user options key and the user ID
$user = Factory::getApplication()->getIdentity();
$user_id = $user->id;
$key = $this->webPushOption . '.webPushSubscription';
// Get any existing subscriptions, remove the specified one
$subscriptions = $this->getWebPushSubscriptions() ?: [];
$index = null;
foreach ($subscriptions as $k => $v)
{
if (
$v->endpoint === $subscriptionData->endpoint
&& $v->keys->p256dh === $subscriptionData->keys->p256dh
&& $v->keys->auth === $subscriptionData->keys->auth
)
{
$index = $k;
break;
}
}
if ($index === null)
{
return;
}
unset($subscriptions[$k]);
$subscriptions = array_values($subscriptions);
// Remove any existing options
/** @var DatabaseInterface $db */
$db = method_exists($this, 'getDatabase') ? $this->getDatabase() : $this->getDbo();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->delete($db->quoteName('#__user_profiles'))
->where(
[
$db->quoteName('user_id') . ' = :user_id',
$db->quoteName('profile_key') . ' = :key',
]
)
->bind(':user_id', $user_id, ParameterType::INTEGER)
->bind(':key', $key, ParameterType::STRING);
$db->setQuery($query)->execute();
// Add the new options
$profileObject = (object) [
'user_id' => $user_id,
'profile_key' => $key,
'profile_value' => json_encode($subscriptions),
'ordering' => 0,
];
$db->insertObject('#__user_profiles', $profileObject);
}
/**
* Initialise the Web Push integration
*
* @param string $option The current component, e.g. com_example
* @param string $configKey The component's configuration key holding the VAPID keys
*
* @return void
* @since 1.0.0
*/
protected function initialiseWebPush(string $option, string $configKey = 'vapidKey'): void
{
$this->webPushOption = $option;
$this->webPushConfigKey = $configKey;
}
/**
* Clear a cache group.
*
* Used internally when saving the component's options after creating new VAPID keys.
*
* @param string $group The cache to clean, e.g. com_content
* @param int $client_id The application ID for which the cache will be cleaned
* @param ApplicationInterface $app The current CMS application.
*
* @return array Cache controller options, including cleaning result
* @throws Exception
* @since 1.0.0
*/
private function clearCacheGroup(string $group, int $client_id, ApplicationInterface $app): array
{
// Get the default cache folder. Start by using the JPATH_CACHE constant.
$cacheBaseDefault = JPATH_CACHE;
$appClientId = 0;
if (method_exists($app, 'getClientId'))
{
$appClientId = $app->getClientId();
}
// -- If we are asked to clean cache on the other side of the application we need to find a new cache base
if ($client_id != $appClientId)
{
$cacheBaseDefault = (($client_id) ? JPATH_SITE : JPATH_ADMINISTRATOR) . '/cache';
}
// Get the cache controller's options
$options = [
'defaultgroup' => $group,
'cachebase' => $app->get('cache_path', $cacheBaseDefault),
'result' => true,
];
try
{
$container = Factory::getContainer();
if (empty($container))
{
throw new RuntimeException('Cannot get Joomla 4 application container');
}
/** @var CacheControllerFactoryInterface $cacheControllerFactory */
$cacheControllerFactory = $container->get('cache.controller.factory');
if (empty($cacheControllerFactory))
{
throw new RuntimeException('Cannot get Joomla 4 cache controller factory');
}
/** @var CallbackController $cache */
$cache = $cacheControllerFactory->createCacheController('callback', $options);
if (empty($cache) || !property_exists($cache, 'cache') || !method_exists($cache->cache, 'clean'))
{
throw new RuntimeException('Cannot get Joomla 4 cache controller');
}
$cache->cache->clean();
}
catch (Throwable $e)
{
$options['result'] = false;
}
return $options;
}
/**
* Create, save and return new VAPID keys.
*
* DO NOT RUN MORE THAN ONCE. Doing so will invalidate all Web Push registrations for existing users!
*
* @return array{publicKey: string, privateKey: string}
* @throws \ErrorException
* @since 1.0.0
*/
private function getNewVapidKeys(): array
{
$vapidKeys = VAPID::createVapidKeys();
$params = ComponentHelper::getParams($this->webPushOption);
$params->set($this->webPushConfigKey, json_encode($vapidKeys));
/** @var DatabaseInterface $db */
$db = method_exists($this, 'getDatabase') ? $this->getDatabase() : $this->getDbo();
$data = $params->toString('JSON');
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn('#__extensions'))
->set($db->qn('params') . ' = ' . $db->q($data))
->where($db->qn('element') . ' = :option')
->where($db->qn('type') . ' = ' . $db->q('component'))
->bind(':option', $this->webPushOption);
$db->setQuery($sql);
try
{
$db->execute();
// The component parameters are cached. We just changed them. Therefore we MUST reset the system cache which holds them.
$app = Factory::getApplication();
$this->clearCacheGroup('_system', 0, $app);
$this->clearCacheGroup('_system', 1, $app);
}
catch (Exception $e)
{
// Don't sweat if it fails
}
// Reset ComponentHelper's cache
$refClass = new \ReflectionClass(ComponentHelper::class);
$refProp = $refClass->getProperty('components');
if (version_compare(PHP_VERSION, '8.1.0', 'lt'))
{
$refProp->setAccessible(true);
}
if (version_compare(PHP_VERSION, '8.3.0', 'ge'))
{
$components = $refClass->getStaticPropertyValue('components');
}
else
{
$components = $refProp->getValue();
}
$components[$this->webPushOption]->params = $params;
if (version_compare(PHP_VERSION, '8.3.0', 'ge'))
{
$refClass->setStaticPropertyValue('components', $components);
}
else
{
$refProp->setValue($components);
}
return $vapidKeys;
}
}PK \ Ϙ: : - vendor/akeeba/webpush/src/WebPush/WebPush.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\WebPush;
use Akeeba\WebPush\Base64Url\Base64Url;
use Joomla\CMS\Uri\Uri;
use Joomla\Http\Http as HttpClient;
use Joomla\Http\HttpFactory;
use Joomla\Http\Response;
use Laminas\Diactoros\Request;
use Laminas\Diactoros\StreamFactory;
use function count;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*/
class WebPush
{
/**
* @var array
*/
protected $auth;
/**
* @var int Automatic padding of payloads, if disabled, trade security for bandwidth
*/
protected $automaticPadding = Encryption::MAX_COMPATIBILITY_PAYLOAD_LENGTH;
/**
* @var HttpClient
*/
protected $client;
/**
* @var array Default options : TTL, urgency, topic, batchSize
*/
protected $defaultOptions;
/**
* @var null|array Array of array of Notifications
*/
protected $notifications;
/**
* @var bool Reuse VAPID headers in the same flush session to improve performance
*/
protected $reuseVAPIDHeaders = false;
/**
* @var array Dictionary for VAPID headers cache
*/
protected $vapidHeaders = [];
/**
* WebPush constructor.
*
* @param array $auth Some servers needs authentication
* @param array $defaultOptions TTL, urgency, topic, batchSize
* @param int|null $timeout Timeout of POST request
*
* @throws \ErrorException
*/
public function __construct(
array $auth = [], array $defaultOptions = [], ?int $timeout = 30, array $clientOptions = []
)
{
$extensions = [
'curl' => '[WebPush] curl extension is not loaded but is required. You can fix this in your php.ini.',
'mbstring' => '[WebPush] mbstring extension is not loaded but is required for sending push notifications with payload or for VAPID authentication. You can fix this in your php.ini.',
'openssl' => '[WebPush] openssl extension is not loaded but is required for sending push notifications with payload or for VAPID authentication. You can fix this in your php.ini.',
];
$phpVersion = phpversion();
if ($phpVersion && version_compare($phpVersion, '7.3.0', '<'))
{
$extensions['gmp'] = '[WebPush] gmp extension is not loaded but is required for sending push notifications with payload or for VAPID authentication. You can fix this in your php.ini.';
}
foreach ($extensions as $extension => $message)
{
if (!extension_loaded($extension))
{
trigger_error($message, E_USER_WARNING);
}
}
if (ini_get('mbstring.func_overload') >= 2)
{
trigger_error(
"[WebPush] mbstring.func_overload is enabled for str* functions. You must disable it if you want to send push notifications with payload or use VAPID. You can fix this in your php.ini.",
E_USER_NOTICE
);
}
if (isset($auth['VAPID']))
{
$auth['VAPID'] = VAPID::validate($auth['VAPID']);
}
$this->auth = $auth;
$this->setDefaultOptions($defaultOptions);
if (!array_key_exists('timeout', $clientOptions) && isset($timeout))
{
$clientOptions['timeout'] = $timeout;
}
$this->client = (new HttpFactory())->getHttp($clientOptions);
}
public function countPendingNotifications(): int
{
return null !== $this->notifications ? count($this->notifications) : 0;
}
/**
* Flush notifications. Triggers the requests.
*
* @param null|int $batchSize Defaults the value defined in defaultOptions during instantiation (which defaults
* to 1000).
*
* @return \Generator|array
* @throws \ErrorException
*/
public function flush(?int $batchSize = null): \Generator
{
if (empty($this->notifications))
{
yield from [];
return;
}
if (null === $batchSize)
{
$batchSize = $this->defaultOptions['batchSize'];
}
$batches = array_chunk($this->notifications, $batchSize);
// reset queue
$this->notifications = [];
foreach ($batches as $batch)
{
// for each endpoint server type
$requests = $this->prepare($batch);
foreach ($requests as $request)
{
try
{
// So, this SHOULD work, but it doesn't because of a Joomla Framework bug. HARD MODE ENGAGED.
//$response = $this->client->sendRequest($request);
$httpMethod = strtolower($request->getMethod());
$headers = array_map(
function ($values) {
if (!is_array($values))
{
return $values;
}
return implode(' ', $values);
},
$request->getHeaders()
);
$timeout = $this->client->getOption('timeout', 10);
switch ($httpMethod)
{
case 'options':
case 'head':
case 'get':
case 'trace':
default:
/** @var Response $response */
$response = $this->client->{$httpMethod}(new Uri($request->getUri()), $headers, $timeout);
break;
case 'post':
case 'put':
case 'delete':
case 'patch':
/** @var Response $response */
$response = $this->client->{$httpMethod}(
new Uri($request->getUri()), $request->getBody()->getContents(), $headers, $timeout
);
break;
}
$success = $response->getStatusCode() >= 200 && $response->getStatusCode() < 400;
if ($success)
{
$reason = 'OK';
}
else
{
$body = $response->getBody();
$body = $body ? (string) $body : null;
$reason = strip_tags($body ?? '') ?: $response->getReasonPhrase();
}
yield new MessageSentReport($request, $response, $success, $reason);
}
catch (\Exception $e)
{
yield null;
}
}
}
if ($this->reuseVAPIDHeaders)
{
$this->vapidHeaders = [];
}
}
/**
* @return int
*/
public function getAutomaticPadding()
{
return $this->automaticPadding;
}
/**
* @param int|bool $automaticPadding Max padding length
*
* @throws \Exception
*/
public function setAutomaticPadding($automaticPadding): WebPush
{
if ($automaticPadding > Encryption::MAX_PAYLOAD_LENGTH)
{
throw new \Exception(
'Automatic padding is too large. Max is ' . Encryption::MAX_PAYLOAD_LENGTH . '. Recommended max is '
. Encryption::MAX_COMPATIBILITY_PAYLOAD_LENGTH . ' for compatibility reasons (see README).'
);
}
elseif ($automaticPadding < 0)
{
throw new \Exception('Padding length should be positive or zero.');
}
elseif ($automaticPadding === true)
{
$this->automaticPadding = Encryption::MAX_COMPATIBILITY_PAYLOAD_LENGTH;
}
elseif ($automaticPadding === false)
{
$this->automaticPadding = 0;
}
else
{
$this->automaticPadding = $automaticPadding;
}
return $this;
}
public function getDefaultOptions(): array
{
return $this->defaultOptions;
}
/**
* @param array $defaultOptions Keys 'TTL' (Time To Live, defaults 4 weeks), 'urgency', 'topic', 'batchSize'
*
* @return WebPush
*/
public function setDefaultOptions(array $defaultOptions)
{
$this->defaultOptions['TTL'] = $defaultOptions['TTL'] ?? 2419200;
$this->defaultOptions['urgency'] = $defaultOptions['urgency'] ?? null;
$this->defaultOptions['topic'] = $defaultOptions['topic'] ?? null;
$this->defaultOptions['batchSize'] = $defaultOptions['batchSize'] ?? 1000;
return $this;
}
/**
* @return bool
*/
public function getReuseVAPIDHeaders()
{
return $this->reuseVAPIDHeaders;
}
/**
* Reuse VAPID headers in the same flush session to improve performance
*
* @return WebPush
*/
public function setReuseVAPIDHeaders(bool $enabled)
{
$this->reuseVAPIDHeaders = $enabled;
return $this;
}
public function isAutomaticPadding(): bool
{
return $this->automaticPadding !== 0;
}
/**
* Queue a notification. Will be sent when flush() is called.
*
* @param string|null $payload If you want to send an array or object, json_encode it
* @param array $options Array with several options tied to this notification. If not set, will use the
* default options that you can set in the WebPush object
* @param array $auth Use this auth details instead of what you provided when creating WebPush
*
* @throws \ErrorException
*/
public function queueNotification(
SubscriptionInterface $subscription, ?string $payload = null, array $options = [], array $auth = []
): void
{
if (isset($payload))
{
if (Utils::safeStrlen($payload) > Encryption::MAX_PAYLOAD_LENGTH)
{
throw new \ErrorException(
'Size of payload must not be greater than ' . Encryption::MAX_PAYLOAD_LENGTH . ' octets.'
);
}
$contentEncoding = $subscription->getContentEncoding();
if (!$contentEncoding)
{
throw new \ErrorException('Subscription should have a content encoding');
}
$payload = Encryption::padPayload($payload, $this->automaticPadding, $contentEncoding);
}
if (array_key_exists('VAPID', $auth))
{
$auth['VAPID'] = VAPID::validate($auth['VAPID']);
}
$this->notifications[] = new Notification($subscription, $payload, $options, $auth);
}
/**
* @param string|null $payload If you want to send an array or object, json_encode it
* @param array $options Array with several options tied to this notification. If not set, will use the
* default options that you can set in the WebPush object
* @param array $auth Use this auth details instead of what you provided when creating WebPush
*
* @throws \ErrorException
*/
public function sendOneNotification(
SubscriptionInterface $subscription, ?string $payload = null, array $options = [], array $auth = []
): ?MessageSentReport
{
$this->queueNotification($subscription, $payload, $options, $auth);
return $this->flush()->current();
}
/**
* @return array
* @throws \ErrorException
*/
protected function getVAPIDHeaders(string $audience, string $contentEncoding, array $vapid)
{
$vapidHeaders = null;
$cache_key = null;
if ($this->reuseVAPIDHeaders)
{
$cache_key = implode('#', [$audience, $contentEncoding, crc32(serialize($vapid))]);
if (array_key_exists($cache_key, $this->vapidHeaders))
{
$vapidHeaders = $this->vapidHeaders[$cache_key];
}
}
if (!$vapidHeaders)
{
$vapidHeaders = VAPID::getVapidHeaders(
$audience, $vapid['subject'], $vapid['publicKey'], $vapid['privateKey'], $contentEncoding
);
}
if ($this->reuseVAPIDHeaders)
{
$this->vapidHeaders[$cache_key] = $vapidHeaders;
}
return $vapidHeaders;
}
/**
* @return Request[]
* @throws \ErrorException
*
*/
protected function prepare(array $notifications): array
{
$requests = [];
foreach ($notifications as $notification)
{
\assert($notification instanceof Notification);
$subscription = $notification->getSubscription();
$endpoint = $subscription->getEndpoint();
$userPublicKey = $subscription->getPublicKey();
$userAuthToken = $subscription->getAuthToken();
$contentEncoding = $subscription->getContentEncoding();
$payload = $notification->getPayload();
$options = $notification->getOptions($this->getDefaultOptions());
$auth = $notification->getAuth($this->auth);
if (!empty($payload) && !empty($userPublicKey) && !empty($userAuthToken))
{
if (!$contentEncoding)
{
throw new \ErrorException('Subscription should have a content encoding');
}
$encrypted = Encryption::encrypt($payload, $userPublicKey, $userAuthToken, $contentEncoding);
$cipherText = $encrypted['cipherText'];
$salt = $encrypted['salt'];
$localPublicKey = $encrypted['localPublicKey'];
$headers = [
'Content-Type' => 'application/octet-stream',
'Content-Encoding' => $contentEncoding,
];
if ($contentEncoding === "aesgcm")
{
$headers['Encryption'] = 'salt=' . Base64Url::encode($salt);
$headers['Crypto-Key'] = 'dh=' . Base64Url::encode($localPublicKey);
}
$encryptionContentCodingHeader = Encryption::getContentCodingHeader(
$salt, $localPublicKey, $contentEncoding
);
$content = $encryptionContentCodingHeader . $cipherText;
$headers['Content-Length'] = (string) Utils::safeStrlen($content);
}
else
{
$headers = [
'Content-Length' => '0',
];
$content = '';
}
$headers['TTL'] = $options['TTL'];
if (isset($options['urgency']))
{
$headers['Urgency'] = $options['urgency'];
}
if (isset($options['topic']))
{
$headers['Topic'] = $options['topic'];
}
if (array_key_exists('VAPID', $auth) && $contentEncoding)
{
$audience = parse_url($endpoint, PHP_URL_SCHEME) . '://' . parse_url($endpoint, PHP_URL_HOST);
if (!parse_url($audience))
{
throw new \ErrorException('Audience "' . $audience . '"" could not be generated.');
}
$vapidHeaders = $this->getVAPIDHeaders($audience, $contentEncoding, $auth['VAPID']);
$headers['Authorization'] = $vapidHeaders['Authorization'];
if ($contentEncoding === 'aesgcm')
{
if (array_key_exists('Crypto-Key', $headers))
{
$headers['Crypto-Key'] .= ';' . $vapidHeaders['Crypto-Key'];
}
else
{
$headers['Crypto-Key'] = $vapidHeaders['Crypto-Key'];
}
}
}
$streamFactory = new StreamFactory();
$requests[] = new Request($endpoint, 'POST', $streamFactory->createStream($content), $headers);
}
return $requests;
}
}
PK \Uqs9 s9 0 vendor/akeeba/webpush/src/WebPush/Encryption.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\WebPush;
use Akeeba\WebPush\Base64Url\Base64Url;
use Akeeba\WebPush\ECC\Curve;
use Akeeba\WebPush\ECC\Point;
use Akeeba\WebPush\ECC\PrivateKey;
use Brick\Math\BigInteger;
use function chr;
use function hex2bin;
use function is_array;
use function mb_substr;
use function openssl_encrypt;
use function pack;
use function str_pad;
use function unpack;
use const false;
use const OPENSSL_RAW_DATA;
use const STR_PAD_LEFT;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*/
class Encryption
{
public const MAX_PAYLOAD_LENGTH = 4078;
public const MAX_COMPATIBILITY_PAYLOAD_LENGTH = 3052;
/**
* @param string $payload With padding
* @param string $userPublicKey Base 64 encoded (MIME or URL-safe)
* @param string $userAuthToken Base 64 encoded (MIME or URL-safe)
*
* @throws \ErrorException
*/
public static function encrypt(string $payload, string $userPublicKey, string $userAuthToken, string $contentEncoding): array
{
$localKeyData = self::createLocalKeyObjectUsingOpenSSL();
$salt = random_bytes(16);
$userPublicKey = Base64Url::decode($userPublicKey);
$userAuthToken = Base64Url::decode($userAuthToken);
// get local key pair
$localPublicKey = hex2bin(Utils::serializePublicKeyFromData($localKeyData));
if (!$localPublicKey)
{
throw new \ErrorException('Failed to convert local public key from hexadecimal to binary');
}
// get user public key object
[$userPublicKeyObjectX, $userPublicKeyObjectY] = Utils::unserializePublicKey($userPublicKey);
$userKeyData = [
'x' => $userPublicKeyObjectX,
'y' => $userPublicKeyObjectY,
];
// get shared secret from user public key and local private key
$sharedSecret = Encryption::calculateAgreementKey($localKeyData, $userKeyData);
$sharedSecret = str_pad($sharedSecret, 32, chr(0), STR_PAD_LEFT);
// section 4.3
$ikm = Encryption::getIKM($userAuthToken, $userPublicKey, $localPublicKey, $sharedSecret, $contentEncoding);
// section 4.2
$context = Encryption::createContext($userPublicKey, $localPublicKey, $contentEncoding);
// derive the Content Encryption Key
$contentEncryptionKeyInfo = Encryption::createInfo($contentEncoding, $context, $contentEncoding);
$contentEncryptionKey = Encryption::hkdf($salt, $ikm, $contentEncryptionKeyInfo, 16);
// section 3.3, derive the nonce
$nonceInfo = Encryption::createInfo('nonce', $context, $contentEncoding);
$nonce = Encryption::hkdf($salt, $ikm, $nonceInfo, 12);
// encrypt
// "The additional data passed to each invocation of AEAD_AES_128_GCM is a zero-length octet sequence."
$tag = '';
$encryptedText = openssl_encrypt($payload, 'aes-128-gcm', $contentEncryptionKey, OPENSSL_RAW_DATA, $nonce, $tag);
// return values in url safe base64
return [
'localPublicKey' => $localPublicKey,
'salt' => $salt,
'cipherText' => $encryptedText . $tag,
];
}
public static function getContentCodingHeader(string $salt, string $localPublicKey, string $contentEncoding): string
{
if ($contentEncoding === "aes128gcm")
{
return $salt
. pack('N*', 4096)
. pack('C*', Utils::safeStrlen($localPublicKey))
. $localPublicKey;
}
return "";
}
/**
* @return string padded payload (plaintext)
* @throws \ErrorException
*/
public static function padPayload(string $payload, int $maxLengthToPad, string $contentEncoding): string
{
$payloadLen = Utils::safeStrlen($payload);
$padLen = $maxLengthToPad ? $maxLengthToPad - $payloadLen : 0;
if ($contentEncoding === "aesgcm")
{
return pack('n*', $padLen) . str_pad($payload, $padLen + $payloadLen, chr(0), STR_PAD_LEFT);
}
elseif ($contentEncoding === "aes128gcm")
{
return str_pad($payload . chr(2), $padLen + $payloadLen, chr(0), STR_PAD_RIGHT);
}
else
{
throw new \ErrorException("This content encoding is not supported");
}
}
private static function addNullPadding(string $data): string
{
return str_pad($data, 32, chr(0), STR_PAD_LEFT);
}
private static function calculateAgreementKey(array $private_key, array $public_key): string
{
if (function_exists('openssl_pkey_derive'))
{
try
{
$publicPem = self::convertPublicKeyToPEM($public_key);
$private_key = array_map([Base64Url::class, 'encode'], $private_key);
$privatePem = self::convertPrivateKeyToPEM($private_key);
$result = openssl_pkey_derive($publicPem, $privatePem, 256);
if ($result === false)
{
throw new \Exception('Unable to compute the agreement key');
}
return $result;
}
catch (\Throwable $throwable)
{
//Does nothing. Will fallback to the pure PHP function
}
}
$curve = self::curve256();
$rec_x = self::convertBase64ToBigInteger($public_key['x']);
$rec_y = self::convertBase64ToBigInteger($public_key['y']);
$sen_d = self::convertBase64ToBigInteger($private_key['d']);
$priv_key = PrivateKey::create($sen_d);
$pub_key = $curve->getPublicKeyFrom($rec_x, $rec_y);
return hex2bin(str_pad($curve->mul($pub_key->getPoint(), $priv_key->getSecret())->getX()->toBase(16), 64, '0', STR_PAD_LEFT));
}
/**
* @throws \ErrorException
*/
private static function convertBase64ToBigInteger(string $value): BigInteger
{
try
{
$value = unpack('H*', Base64Url::decode($value));
}
catch (\Exception $e)
{
$value = unpack('H*', $value);
}
if ($value === false)
{
throw new \ErrorException('Unable to unpack hex value from string');
}
return BigInteger::fromBase($value[1], 16);
}
/**
* @throws \ErrorException
*/
private static function convertBase64ToGMP(string $value): \GMP
{
$value = unpack('H*', Base64Url::decode($value));
if ($value === false)
{
throw new \ErrorException('Unable to unpack hex value from string');
}
return gmp_init($value[1], 16);
}
/**
* Creates a context for deriving encryption parameters.
* See section 4.2 of
* {@link https://tools.ietf.org/html/draft-ietf-httpbis-encryption-encoding-00}
* From {@link https://github.com/GoogleChrome/push-encryption-node/blob/master/src/encrypt.js}.
*
* @param string $clientPublicKey The client's public key
* @param string $serverPublicKey Our public key
*
* @throws \ErrorException
*/
private static function createContext(string $clientPublicKey, string $serverPublicKey, string $contentEncoding): ?string
{
if ($contentEncoding === "aes128gcm")
{
return null;
}
if (Utils::safeStrlen($clientPublicKey) !== 65)
{
throw new \ErrorException('Invalid client public key length');
}
// This one should never happen, because it's our code that generates the key
if (Utils::safeStrlen($serverPublicKey) !== 65)
{
throw new \ErrorException('Invalid server public key length');
}
$len = chr(0) . 'A'; // 65 as Uint16BE
return chr(0) . $len . $clientPublicKey . $len . $serverPublicKey;
}
/**
* Returns an info record. See sections 3.2 and 3.3 of
* {@link https://tools.ietf.org/html/draft-ietf-httpbis-encryption-encoding-00}
* From {@link https://github.com/GoogleChrome/push-encryption-node/blob/master/src/encrypt.js}.
*
* @param string $type The type of the info record
* @param string|null $context The context for the record
*
* @throws \ErrorException
*/
private static function createInfo(string $type, ?string $context, string $contentEncoding): string
{
if ($contentEncoding === "aesgcm")
{
if (!$context)
{
throw new \ErrorException('Context must exist');
}
if (Utils::safeStrlen($context) !== 135)
{
throw new \ErrorException('Context argument has invalid size');
}
return 'Content-Encoding: ' . $type . chr(0) . 'P-256' . $context;
}
elseif ($contentEncoding === "aes128gcm")
{
return 'Content-Encoding: ' . $type . chr(0);
}
throw new \ErrorException('This content encoding is not supported.');
}
private static function createLocalKeyObjectUsingOpenSSL(): array
{
$keyResource = openssl_pkey_new([
'curve_name' => 'prime256v1',
'private_key_type' => OPENSSL_KEYTYPE_EC,
]);
if (!$keyResource)
{
throw new \RuntimeException('Unable to create the key');
}
$details = openssl_pkey_get_details($keyResource);
if (PHP_MAJOR_VERSION < 8)
{
openssl_pkey_free($keyResource);
}
if (!$details)
{
throw new \RuntimeException('Unable to get the key details');
}
return [
'x' => self::addNullPadding($details['ec']['x']),
'y' => self::addNullPadding($details['ec']['y']),
'd' => self::addNullPadding($details['ec']['d']),
];
}
/**
* @throws \ErrorException
*/
private static function getIKM(string $userAuthToken, string $userPublicKey, string $localPublicKey, string $sharedSecret, string $contentEncoding): string
{
if (!empty($userAuthToken))
{
if ($contentEncoding === "aesgcm")
{
$info = 'Content-Encoding: auth' . chr(0);
}
elseif ($contentEncoding === "aes128gcm")
{
$info = "WebPush: info" . chr(0) . $userPublicKey . $localPublicKey;
}
else
{
throw new \ErrorException("This content encoding is not supported");
}
return self::hkdf($userAuthToken, $sharedSecret, $info, 32);
}
return $sharedSecret;
}
/**
* HMAC-based Extract-and-Expand Key Derivation Function (HKDF).
*
* This is used to derive a secure encryption key from a mostly-secure shared
* secret.
*
* This is a partial implementation of HKDF tailored to our specific purposes.
* In particular, for us the value of N will always be 1, and thus T always
* equals HMAC-Hash(PRK, info | 0x01).
*
* See {@link https://www.rfc-editor.org/rfc/rfc5869.txt}
* From {@link https://github.com/GoogleChrome/push-encryption-node/blob/master/src/encrypt.js}
*
* @param string $salt A non-secret random value
* @param string $ikm Input keying material
* @param string $info Application-specific context
* @param int $length The length (in bytes) of the required output key
*/
private static function hkdf(string $salt, string $ikm, string $info, int $length): string
{
// extract
$prk = hash_hmac('sha256', $ikm, $salt, true);
// expand
return mb_substr(hash_hmac('sha256', $info . chr(1), $prk, true), 0, $length, '8bit');
}
/**
* @throws \InvalidArgumentException if the curve is not supported
*/
public static function convertPublicKeyToPEM(array $keyData): string
{
$der = pack(
'H*',
'3059' // SEQUENCE, length 89
.'3013' // SEQUENCE, length 19
.'0607' // OID, length 7
.'2a8648ce3d0201' // 1.2.840.10045.2.1 = EC Public Key
.'0608' // OID, length 8
.'2a8648ce3d030107' // 1.2.840.10045.3.1.7 = P-256 Curve
.'0342' // BIT STRING, length 66
.'00' // prepend with NUL - pubkey will follow
);
$der .= "\04"
. str_pad($keyData['x'], 32, "\0", STR_PAD_LEFT)
. str_pad($keyData['y'], 32, "\0", STR_PAD_LEFT);
$pem = '-----BEGIN PUBLIC KEY-----'.PHP_EOL;
$pem .= chunk_split(base64_encode($der), 64, PHP_EOL);
$pem .= '-----END PUBLIC KEY-----'.PHP_EOL;
return $pem;
}
/**
* @throws \InvalidArgumentException if the curve is not supported
*/
public static function convertPrivateKeyToPEM(array $keyData): string
{
$d = unpack('H*', str_pad(Base64Url::decode($keyData['d']), 32, "\0", STR_PAD_LEFT));
if (!is_array($d) || !isset($d[1]))
{
throw new \InvalidArgumentException('Unable to get the private key');
}
$der = pack(
'H*',
'3077' // SEQUENCE, length 87+length($d)=32
. '020101' // INTEGER, 1
. '0420' // OCTET STRING, length($d) = 32
. $d[1]
. 'a00a' // TAGGED OBJECT #0, length 10
. '0608' // OID, length 8
. '2a8648ce3d030107' // 1.3.132.0.34 = P-256 Curve
. 'a144' // TAGGED OBJECT #1, length 68
. '0342' // BIT STRING, length 66
. '00' // prepend with NUL - pubkey will follow
);
$der .= "\04"
. str_pad(Base64Url::decode($keyData['x']), 32, "\0", STR_PAD_LEFT)
. str_pad(Base64Url::decode($keyData['y']), 32, "\0", STR_PAD_LEFT);
$pem = '-----BEGIN EC PRIVATE KEY-----'.PHP_EOL;
$pem .= chunk_split(base64_encode($der), 64, PHP_EOL);
$pem .= '-----END EC PRIVATE KEY-----'.PHP_EOL;
return $pem;
}
/**
* Returns an NIST P-256 curve.
*/
private static function curve256(): Curve
{
$p = BigInteger::fromBase('ffffffff00000001000000000000000000000000ffffffffffffffffffffffff', 16);
$a = BigInteger::fromBase('ffffffff00000001000000000000000000000000fffffffffffffffffffffffc', 16);
$b = BigInteger::fromBase('5ac635d8aa3a93e7b3ebbd55769886bc651d06b0cc53b0f63bce3c3e27d2604b', 16);
$x = BigInteger::fromBase('6b17d1f2e12c4247f8bce6e563a440f277037d812deb33a0f4a13945d898c296', 16);
$y = BigInteger::fromBase('4fe342e2fe1a7f9b8ee7eb4a7c0f9e162bce33576b315ececbb6406837bf51f5', 16);
$n = BigInteger::fromBase('ffffffff00000000ffffffffffffffffbce6faada7179e84f3b9cac2fc632551', 16);
$generator = Point::create($x, $y, $n);
return new Curve(256, $p, $a, $b, $generator);
}
}
PK \6 2 vendor/akeeba/webpush/src/WebPush/Notification.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\WebPush;
use function count;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*/
class Notification
{
/** @var array Auth details : VAPID */
private $auth;
/** @var array Options : TTL, urgency, topic */
private $options;
/** @var null|string */
private $payload;
/** @var SubscriptionInterface */
private $subscription;
public function __construct(SubscriptionInterface $subscription, ?string $payload, array $options, array $auth)
{
$this->subscription = $subscription;
$this->payload = $payload;
$this->options = $options;
$this->auth = $auth;
}
public function getAuth(array $defaultAuth): array
{
return count($this->auth) > 0 ? $this->auth : $defaultAuth;
}
public function getOptions(array $defaultOptions = []): array
{
$options = $this->options;
$options['TTL'] = array_key_exists('TTL', $options) ? $options['TTL'] : $defaultOptions['TTL'];
$options['urgency'] = array_key_exists('urgency', $options) ? $options['urgency'] : $defaultOptions['urgency'];
$options['topic'] = array_key_exists('topic', $options) ? $options['topic'] : $defaultOptions['topic'];
return $options;
}
public function getPayload(): ?string
{
return $this->payload;
}
public function getSubscription(): SubscriptionInterface
{
return $this->subscription;
}
}
PK \`|12 2 2 vendor/akeeba/webpush/src/WebPush/Subscription.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\WebPush;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*/
class Subscription implements SubscriptionInterface
{
/** @var null|string */
private $authToken;
/** @var null|string */
private $contentEncoding;
/** @var string */
private $endpoint;
/** @var null|string */
private $publicKey;
/**
* @param string|null $contentEncoding (Optional) Must be "aesgcm"
*
* @throws \ErrorException
*/
public function __construct(
string $endpoint,
?string $publicKey = null,
?string $authToken = null,
?string $contentEncoding = null
)
{
$this->endpoint = $endpoint;
if ($publicKey || $authToken || $contentEncoding)
{
$supportedContentEncodings = ['aesgcm', 'aes128gcm'];
if ($contentEncoding && !in_array($contentEncoding, $supportedContentEncodings))
{
throw new \ErrorException('This content encoding (' . $contentEncoding . ') is not supported.');
}
$this->publicKey = $publicKey;
$this->authToken = $authToken;
$this->contentEncoding = $contentEncoding ?: "aesgcm";
}
}
/**
* @param array $associativeArray (with keys endpoint, publicKey, authToken, contentEncoding)
*
* @throws \ErrorException
*/
public static function create(array $associativeArray): self
{
if (array_key_exists('keys', $associativeArray) && is_array($associativeArray['keys']))
{
return new self(
$associativeArray['endpoint'],
$associativeArray['keys']['p256dh'] ?? null,
$associativeArray['keys']['auth'] ?? null,
$associativeArray['contentEncoding'] ?? "aesgcm"
);
}
if (array_key_exists('publicKey', $associativeArray) || array_key_exists('authToken', $associativeArray) || array_key_exists('contentEncoding', $associativeArray))
{
return new self(
$associativeArray['endpoint'],
$associativeArray['publicKey'] ?? null,
$associativeArray['authToken'] ?? null,
$associativeArray['contentEncoding'] ?? "aesgcm"
);
}
return new self(
$associativeArray['endpoint']
);
}
/**
* {@inheritDoc}
*/
public function getAuthToken(): ?string
{
return $this->authToken;
}
/**
* {@inheritDoc}
*/
public function getContentEncoding(): ?string
{
return $this->contentEncoding;
}
/**
* {@inheritDoc}
*/
public function getEndpoint(): string
{
return $this->endpoint;
}
/**
* {@inheritDoc}
*/
public function getPublicKey(): ?string
{
return $this->publicKey;
}
}
PK \5H ; vendor/akeeba/webpush/src/WebPush/SubscriptionInterface.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\WebPush;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*
* @author Sergii Bondarenko
*/
interface SubscriptionInterface
{
public function getAuthToken(): ?string;
public function getContentEncoding(): ?string;
public function getEndpoint(): string;
public function getPublicKey(): ?string;
}
PK \" " 7 vendor/akeeba/webpush/src/WebPush/MessageSentReport.phpnu [ .
*/
namespace Akeeba\WebPush\WebPush;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*
* @author Igor Timoshenkov [it@campoint.net]
* @started: 03.09.2018 9:21
*
* Standardized response from sending a message
*/
class MessageSentReport implements \JsonSerializable
{
/**
* @var string
*/
protected $reason;
/**
* @var RequestInterface
*/
protected $request;
/**
* @var ResponseInterface | null
*/
protected $response;
/**
* @var boolean
*/
protected $success;
/**
* @param string $reason
*/
public function __construct(RequestInterface $request, ?ResponseInterface $response = null, bool $success = true, $reason = 'OK')
{
$this->request = $request;
$this->response = $response;
$this->success = $success;
$this->reason = $reason;
}
public function getEndpoint(): string
{
return $this->request->getUri()->__toString();
}
public function getReason(): string
{
return $this->reason;
}
public function setReason(string $reason): MessageSentReport
{
$this->reason = $reason;
return $this;
}
public function getRequest(): RequestInterface
{
return $this->request;
}
public function setRequest(RequestInterface $request): MessageSentReport
{
$this->request = $request;
return $this;
}
public function getRequestPayload(): string
{
return $this->request->getBody()->getContents();
}
public function getResponse(): ?ResponseInterface
{
return $this->response;
}
public function setResponse(ResponseInterface $response): MessageSentReport
{
$this->response = $response;
return $this;
}
public function getResponseContent(): ?string
{
if (!$this->response)
{
return null;
}
return $this->response->getBody()->getContents();
}
public function isSubscriptionExpired(): bool
{
if (!$this->response)
{
return false;
}
return \in_array($this->response->getStatusCode(), [404, 410], true);
}
public function isSuccess(): bool
{
return $this->success;
}
public function setSuccess(bool $success): MessageSentReport
{
$this->success = $success;
return $this;
}
public function jsonSerialize(): array
{
return [
'success' => $this->isSuccess(),
'expired' => $this->isSubscriptionExpired(),
'reason' => $this->reason,
'endpoint' => $this->getEndpoint(),
'payload' => $this->request->getBody()->getContents(),
];
}
}
PK \Ť0 0 + vendor/akeeba/webpush/src/WebPush/VAPID.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\WebPush;
use Akeeba\WebPush\Base64Url\Base64Url;
use DateTimeImmutable;
use Lcobucci\JWT\Configuration;
use Lcobucci\JWT\Signer\Ecdsa\Sha256;
use Lcobucci\JWT\Signer\Key\InMemory;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*/
class VAPID
{
private const PUBLIC_KEY_LENGTH = 65;
private const PRIVATE_KEY_LENGTH = 32;
/**
* This method creates VAPID keys in case you would not be able to have a Linux bash.
* DO NOT create keys at each initialization! Save those keys and reuse them.
*
* @throws \ErrorException
*/
public static function createVapidKeys(): array
{
$keyData = self::createECKeyUsingOpenSSL();
$binaryPublicKey = hex2bin(Utils::serializePublicKeyFromData($keyData));
if (!$binaryPublicKey)
{
throw new \ErrorException('Failed to convert VAPID public key from hexadecimal to binary');
}
$binaryPrivateKey = hex2bin(str_pad(bin2hex($keyData['d']), 2 * self::PRIVATE_KEY_LENGTH, '0', STR_PAD_LEFT));
if (!$binaryPrivateKey)
{
throw new \ErrorException('Failed to convert VAPID private key from hexadecimal to binary');
}
return [
'publicKey' => Base64Url::encode($binaryPublicKey),
'privateKey' => Base64Url::encode($binaryPrivateKey),
];
}
/**
* This method takes the required VAPID parameters and returns the required
* header to be added to a Web Push Protocol Request.
*
* @param string $audience This must be the origin of the push service
* @param string $subject This should be a URL or a 'mailto:' email address
* @param string $publicKey The decoded VAPID public key
* @param string $signingKey The decoded VAPID private key
* @param null|int $expiration The expiration of the VAPID JWT. (UNIX timestamp)
*
* @return array Returns an array with the 'Authorization' and 'Crypto-Key' values to be used as headers
* @throws \ErrorException
*/
public static function getVapidHeaders(
string $audience, string $subject, string $publicKey, string $signingKey, string $contentEncoding,
?int $expiration = null
)
{
// Get the full key data from the public and private key
$keyData = Utils::unserializePublicKey($publicKey);
$keyData[] = $signingKey;
$keyData = array_combine(['x', 'y', 'd'], $keyData);
$keyData = array_map([Base64Url::class, 'encode'], $keyData);
// Get an in-memory key (see https://github.com/lcobucci/jwt/blob/3.4.x/docs/configuration.md)
$privateKeyPem = Encryption::convertPrivateKeyToPEM($keyData);
$publicKeyPem = Encryption::convertPublicKeyToPEM($keyData);
$signingKey = InMemory::plainText($privateKeyPem);
$verificationKey = InMemory::plainText($publicKeyPem);
// Calculate expiration date and time
$expirationLimit = time() + 43200; // equal margin of error between 0 and 24h
if (null === $expiration || $expiration > $expirationLimit)
{
$expiration = $expirationLimit;
}
// Get current data and time
// Get the JWT
$configuration = Configuration::forAsymmetricSigner(new Sha256(), $signingKey, $verificationKey);
$token = $configuration->builder()
->expiresAt(new DateTimeImmutable('@' . $expiration))
->issuedAt(new DateTimeImmutable())
->permittedFor($audience)
->relatedTo($subject)
->getToken($configuration->signer(), $configuration->signingKey());
$jwt = $token->toString();
// Get the authorisation headers
$encodedPublicKey = Base64Url::encode($publicKey);
if ($contentEncoding === "aesgcm")
{
return [
'Authorization' => 'WebPush ' . $jwt,
'Crypto-Key' => 'p256ecdsa=' . $encodedPublicKey,
];
}
if ($contentEncoding === 'aes128gcm')
{
return [
'Authorization' => 'vapid t=' . $jwt . ', k=' . $encodedPublicKey,
];
}
throw new \ErrorException('This content encoding is not supported');
}
/**
* @throws \ErrorException
*/
public static function validate(array $vapid): array
{
if (!isset($vapid['subject']))
{
throw new \ErrorException('[VAPID] You must provide a subject that is either a mailto: or a URL.');
}
if (!isset($vapid['publicKey']))
{
throw new \ErrorException('[VAPID] You must provide a public key.');
}
$publicKey = Base64Url::decode($vapid['publicKey']);
if (Utils::safeStrlen($publicKey) !== self::PUBLIC_KEY_LENGTH)
{
throw new \ErrorException('[VAPID] Public key should be 65 bytes long when decoded.');
}
if (!isset($vapid['privateKey']))
{
throw new \ErrorException('[VAPID] You must provide a private key.');
}
$privateKey = Base64Url::decode($vapid['privateKey']);
if (Utils::safeStrlen($privateKey) !== self::PRIVATE_KEY_LENGTH)
{
throw new \ErrorException('[VAPID] Private key should be 32 bytes long when decoded.');
}
return [
'subject' => $vapid['subject'],
'publicKey' => $publicKey,
'privateKey' => $privateKey,
];
}
/**
* Create a new elliptic curve key using the P-256 curve and OpenSSL
*
* @throws \RuntimeException if the extension OpenSSL is not available
* @throws \RuntimeException if the key cannot be created
*/
private static function createECKeyUsingOpenSSL(): array
{
if (!extension_loaded('openssl'))
{
throw new \RuntimeException('Please install the OpenSSL extension');
}
$key = openssl_pkey_new(
[
'curve_name' => 'prime256v1',
'private_key_type' => OPENSSL_KEYTYPE_EC,
]
);
if ($key === false)
{
throw new \RuntimeException('Unable to create the key');
}
$result = openssl_pkey_export($key, $out);
if ($result === false)
{
throw new \RuntimeException('Unable to create the key');
}
$res = openssl_pkey_get_private($out);
if ($res === false)
{
throw new \RuntimeException('Unable to create the key');
}
$details = openssl_pkey_get_details($res);
if ($details === false)
{
throw new \InvalidArgumentException('Unable to get the key details');
}
return [
'd' => $details['ec']['d'],
'x' => $details['ec']['x'],
'y' => $details['ec']['y'],
];
}
}
PK \>7x
x
+ vendor/akeeba/webpush/src/WebPush/Utils.phpnu [ .
*/
declare(strict_types=1);
namespace Akeeba\WebPush\WebPush;
use function mb_strlen;
use function mb_substr;
/**
* This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use
* dependencies shipped with Joomla itself and must not be confused with the original work.
*
* You can find the original code at https://github.com/web-push-libs
*
* The original code came with the following copyright notice:
*
* =====================================================================================================================
*
* This file is part of the WebPush library.
*
* (c) Louis Lagrange
*
* For the full copyright and license information, please view the LICENSE-LAGRANGE.txt
* file that was distributed with this source code.
*
* =====================================================================================================================
*/
class Utils
{
public static function safeStrlen(string $value): int
{
return mb_strlen($value, '8bit');
}
public static function serializePublicKeyFromData(array $data): string
{
$hexString = '04';
$hexString .= str_pad(bin2hex($data['x']), 64, '0', STR_PAD_LEFT);
$hexString .= str_pad(bin2hex($data['y']), 64, '0', STR_PAD_LEFT);
return $hexString;
}
public static function unserializePublicKey(string $data): array
{
$data = bin2hex($data);
if (mb_substr($data, 0, 2, '8bit') !== '04')
{
throw new \InvalidArgumentException('Invalid data: only uncompressed keys are supported.');
}
$data = mb_substr($data, 2, null, '8bit');
$dataLength = self::safeStrlen($data);
return [
hex2bin(mb_substr($data, 0, $dataLength / 2, '8bit')),
hex2bin(mb_substr($data, $dataLength / 2, null, '8bit')),
];
}
}
PK \Sʉ + vendor/akeeba/webpush/src/WebPush/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ # vendor/akeeba/webpush/src/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Ab
vendor/akeeba/webpush/CLAUDE.mdnu [ # CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
Akeeba Web Push is a PHP library implementing the W3C Web Push Protocol for Joomla 4+ components. It allows Joomla extension developers to send encrypted browser push notifications to users. It is **not** a standalone Joomla component — it's a reusable library that components include via Composer or manual file copy.
**Derived from** Louis Lagrange's WebPush library, modified to use only Joomla-bundled dependencies.
## Build & Dependencies
- **PHP**: ^7.4 | ^8.0 (platform target: 7.4.999)
- **Required extensions**: `ext-openssl`, `ext-json`
- **Optional**: `ext-gmp` (better BigInteger performance)
- **Install**: `composer install`
- **No test suite, linter, or CI pipeline exists** in this repository.
## Architecture
### Namespace & Autoloading
PSR-4: `Akeeba\WebPush\` maps to `src/`.
### Core Subsystems
**`src/WebPush/`** — Core push notification engine:
- `WebPush.php` — Main sender class. Queues notifications and flushes them in batches (default 1000) via HTTP POST to browser push services.
- `VAPID.php` — VAPID key pair generation and JWT signing (ECDSA P-256).
- `Encryption.php` — AES-128-GCM / AES-GCM payload encryption with random salt and padding.
- `Subscription.php` / `SubscriptionInterface.php` — Browser subscription data (endpoint + p256dh + auth keys).
- `Notification.php` — Internal notification wrapper.
- `MessageSentReport.php` — Delivery result per notification.
**`src/ECC/`** — Custom Elliptic Curve Cryptography implementation for VAPID public key operations. Uses `Brick\Math\BigInteger` (Joomla-bundled).
**`src/Base64Url/`** — URL-safe Base64 encoding/decoding utility.
### Joomla Integration Layer (Trait-Based)
The library integrates into Joomla MVC via two traits:
- **`WebPushControllerTrait`** — Adds `webpushsubscribe()` and `webpushunsubscribe()` endpoints to any Joomla controller. Handles CSRF validation and JSON responses. Hook: `onAfterWebPushSaveSubscription()`.
- **`WebPushModelTrait`** — Adds `initialiseWebPush()`, `getVapidKeys()`, `sendNotification()`, and subscription CRUD to any Joomla model. Stores subscriptions as JSON in Joomla's `#__user_profiles` table (key: `{component}.webPushSubscription`). VAPID keys stored in component parameters.
**`NotificationOptions.php`** — Fluent DSO with ArrayAccess for notification display options.
### Data Flow
Browser subscribes via Service Worker → Controller saves subscription to `#__user_profiles` → Later, model calls `sendNotification()` → WebPush encrypts payload with AES-GCM + VAPID JWT → HTTP POST to push service → Browser receives and displays notification.
### Cryptography
Changes to VAPID or encryption code have breaking implications — the crypto stack (ECC, VAPID JWT signing, AES-GCM encryption) is tightly coupled and must remain compatible with the Web Push standard.
## Important Constraints
- **Plugin namespace conflict**: Cannot be used unmodified in Joomla plugins; namespace must be changed to avoid version conflicts between extensions.
- **Payload limits**: Max 4,078 bytes; compatibility limit 3,052 bytes.
- **Joomla version compat**: Handles Joomla 4/5/6 database API differences and PHP 8.1–8.5 reflection changes with runtime checks.
- **Static VAPID cache**: VAPID keys are cached in a static property per component to avoid repeated DB queries.
PK \Sʉ vendor/akeeba/webpush/.htaccessnu 7m
Order allow,deny
Deny from all
PK \'L L ! vendor/akeeba/webpush/LICENSE.txtnu [ GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc.
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The GNU General Public License is a free, copyleft license for
software and other kinds of works.
The licenses for most software and other practical works are designed
to take away your freedom to share and change the works. By contrast,
the GNU General Public License is intended to guarantee your freedom to
share and change all versions of a program--to make sure it remains free
software for all its users. We, the Free Software Foundation, use the
GNU General Public License for most of our software; it applies also to
any other work released this way by its authors. You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.
To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights. Therefore, you have
certain responsibilities if you distribute copies of the software, or if
you modify it: responsibilities to respect the freedom of others.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received. You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.
Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.
For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software. For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.
Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the manufacturer
can do so. This is fundamentally incompatible with the aim of
protecting users' freedom to change the software. The systematic
pattern of such abuse occurs in the area of products for individuals to
use, which is precisely where it is most unacceptable. Therefore, we
have designed this version of the GPL to prohibit the practice for those
products. If such problems arise substantially in other domains, we
stand ready to extend this provision to those domains in future versions
of the GPL, as needed to protect the freedom of users.
Finally, every program is threatened constantly by software patents.
States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish to
avoid the special danger that patents applied to a free program could
make it effectively proprietary. To prevent this, the GPL assures that
patents cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and
modification follow.
TERMS AND CONDITIONS
0. Definitions.
"This License" refers to version 3 of the GNU General Public License.
"Copyright" also means copyright-like laws that apply to other kinds of
works, such as semiconductor masks.
"The Program" refers to any copyrightable work licensed under this
License. Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.
To "modify" a work means to copy from or adapt all or part of the work
in a fashion requiring copyright permission, other than the making of an
exact copy. The resulting work is called a "modified version" of the
earlier work or a work "based on" the earlier work.
A "covered work" means either the unmodified Program or a work based
on the Program.
To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on a
computer or modifying a private copy. Propagation includes copying,
distribution (with or without modification), making available to the
public, and in some countries other activities as well.
To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user through
a computer network, with no transfer of a copy, is not conveying.
An interactive user interface displays "Appropriate Legal Notices"
to the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to the
extent that warranties are provided), that licensees may convey the
work under this License, and how to view a copy of this License. If
the interface presents a list of user commands or options, such as a
menu, a prominent item in the list meets this criterion.
1. Source Code.
The "source code" for a work means the preferred form of the work
for making modifications to it. "Object code" means any non-source
form of a work.
A "Standard Interface" means an interface that either is an official
standard defined by a recognized standards body, or, in the case of
interfaces specified for a particular programming language, one that
is widely used among developers working in that language.
The "System Libraries" of an executable work include anything, other
than the work as a whole, that (a) is included in the normal form of
packaging a Major Component, but which is not part of that Major
Component, and (b) serves only to enable use of the work with that
Major Component, or to implement a Standard Interface for which an
implementation is available to the public in source code form. A
"Major Component", in this context, means a major essential component
(kernel, window system, and so on) of the specific operating system
(if any) on which the executable work runs, or a compiler used to
produce the work, or an object code interpreter used to run it.
The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts to
control those activities. However, it does not include the work's
System Libraries, or general-purpose tools or generally available free
programs which are used unmodified in performing those activities but
which are not part of the work. For example, Corresponding Source
includes interface definition files associated with source files for
the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require,
such as by intimate data communication or control flow between those
subprograms and other parts of the work.
The Corresponding Source need not include anything that users
can regenerate automatically from other parts of the Corresponding
Source.
The Corresponding Source for a work in source code form is that
same work.
2. Basic Permissions.
All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met. This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its
content, constitutes a covered work. This License acknowledges your
rights of fair use or other equivalent, as provided by copyright law.
You may make, run and propagate covered works that you do not
convey, without conditions so long as your license otherwise remains
in force. You may convey covered works to others for the sole purpose
of having them make modifications exclusively for you, or provide you
with facilities for running those works, provided that you comply with
the terms of this License in conveying all material for which you do
not control copyright. Those thus making or running the covered works
for you must do so exclusively on your behalf, under your direction
and control, on terms that prohibit them from making any copies of
your copyrighted material outside their relationship with you.
Conveying under any other circumstances is permitted solely under
the conditions stated below. Sublicensing is not allowed; section 10
makes it unnecessary.
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under article
11 of the WIPO copyright treaty adopted on 20 December 1996, or
similar laws prohibiting or restricting circumvention of such
measures.
When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such circumvention
is effected by exercising rights under this License with respect to
the covered work, and you disclaim any intention to limit operation or
modification of the work as a means of enforcing, against the work's
users, your or third parties' legal rights to forbid circumvention of
technological measures.
4. Conveying Verbatim Copies.
You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the code;
keep intact all notices of the absence of any warranty; and give all
recipients a copy of this License along with the Program.
You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.
5. Conveying Modified Source Versions.
You may convey a work based on the Program, or the modifications to
produce it from the Program, in the form of source code under the
terms of section 4, provided that you also meet all of these conditions:
a) The work must carry prominent notices stating that you modified
it, and giving a relevant date.
b) The work must carry prominent notices stating that it is
released under this License and any conditions added under section
7. This requirement modifies the requirement in section 4 to
"keep intact all notices".
c) You must license the entire work, as a whole, under this
License to anyone who comes into possession of a copy. This
License will therefore apply, along with any applicable section 7
additional terms, to the whole of the work, and all its parts,
regardless of how they are packaged. This License gives no
permission to license the work in any other way, but it does not
invalidate such permission if you have separately received it.
d) If the work has interactive user interfaces, each must display
Appropriate Legal Notices; however, if the Program has interactive
interfaces that do not display Appropriate Legal Notices, your
work need not make them do so.
A compilation of a covered work with other separate and independent
works, which are not by their nature extensions of the covered work,
and which are not combined with it such as to form a larger program,
in or on a volume of a storage or distribution medium, is called an
"aggregate" if the compilation and its resulting copyright are not
used to limit the access or legal rights of the compilation's users
beyond what the individual works permit. Inclusion of a covered work
in an aggregate does not cause this License to apply to the other
parts of the aggregate.
6. Conveying Non-Source Forms.
You may convey a covered work in object code form under the terms
of sections 4 and 5, provided that you also convey the
machine-readable Corresponding Source under the terms of this License,
in one of these ways:
a) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by the
Corresponding Source fixed on a durable physical medium
customarily used for software interchange.
b) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by a
written offer, valid for at least three years and valid for as
long as you offer spare parts or customer support for that product
model, to give anyone who possesses the object code either (1) a
copy of the Corresponding Source for all the software in the
product that is covered by this License, on a durable physical
medium customarily used for software interchange, for a price no
more than your reasonable cost of physically performing this
conveying of source, or (2) access to copy the
Corresponding Source from a network server at no charge.
c) Convey individual copies of the object code with a copy of the
written offer to provide the Corresponding Source. This
alternative is allowed only occasionally and noncommercially, and
only if you received the object code with such an offer, in accord
with subsection 6b.
d) Convey the object code by offering access from a designated
place (gratis or for a charge), and offer equivalent access to the
Corresponding Source in the same way through the same place at no
further charge. You need not require recipients to copy the
Corresponding Source along with the object code. If the place to
copy the object code is a network server, the Corresponding Source
may be on a different server (operated by you or a third party)
that supports equivalent copying facilities, provided you maintain
clear directions next to the object code saying where to find the
Corresponding Source. Regardless of what server hosts the
Corresponding Source, you remain obligated to ensure that it is
available for as long as needed to satisfy these requirements.
e) Convey the object code using peer-to-peer transmission, provided
you inform other peers where the object code and Corresponding
Source of the work are being offered to the general public at no
charge under subsection 6d.
A separable portion of the object code, whose source code is excluded
from the Corresponding Source as a System Library, need not be
included in conveying the object code work.
A "User Product" is either (1) a "consumer product", which means any
tangible personal property which is normally used for personal, family,
or household purposes, or (2) anything designed or sold for incorporation
into a dwelling. In determining whether a product is a consumer product,
doubtful cases shall be resolved in favor of coverage. For a particular
product received by a particular user, "normally used" refers to a
typical or common use of that class of product, regardless of the status
of the particular user or of the way in which the particular user
actually uses, or expects or is expected to use, the product. A product
is a consumer product regardless of whether the product has substantial
commercial, industrial or non-consumer uses, unless such uses represent
the only significant mode of use of the product.
"Installation Information" for a User Product means any methods,
procedures, authorization keys, or other information required to install
and execute modified versions of a covered work in that User Product from
a modified version of its Corresponding Source. The information must
suffice to ensure that the continued functioning of the modified object
code is in no case prevented or interfered with solely because
modification has been made.
If you convey an object code work under this section in, or with, or
specifically for use in, a User Product, and the conveying occurs as
part of a transaction in which the right of possession and use of the
User Product is transferred to the recipient in perpetuity or for a
fixed term (regardless of how the transaction is characterized), the
Corresponding Source conveyed under this section must be accompanied
by the Installation Information. But this requirement does not apply
if neither you nor any third party retains the ability to install
modified object code on the User Product (for example, the work has
been installed in ROM).
The requirement to provide Installation Information does not include a
requirement to continue to provide support service, warranty, or updates
for a work that has been modified or installed by the recipient, or for
the User Product in which it has been modified or installed. Access to a
network may be denied when the modification itself materially and
adversely affects the operation of the network or violates the rules and
protocols for communication across the network.
Corresponding Source conveyed, and Installation Information provided,
in accord with this section must be in a format that is publicly
documented (and with an implementation available to the public in
source code form), and must require no special password or key for
unpacking, reading or copying.
7. Additional Terms.
"Additional permissions" are terms that supplement the terms of this
License by making exceptions from one or more of its conditions.
Additional permissions that are applicable to the entire Program shall
be treated as though they were included in this License, to the extent
that they are valid under applicable law. If additional permissions
apply only to part of the Program, that part may be used separately
under those permissions, but the entire Program remains governed by
this License without regard to the additional permissions.
When you convey a copy of a covered work, you may at your option
remove any additional permissions from that copy, or from any part of
it. (Additional permissions may be written to require their own
removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work,
for which you have or can give appropriate copyright permission.
Notwithstanding any other provision of this License, for material you
add to a covered work, you may (if authorized by the copyright holders of
that material) supplement the terms of this License with terms:
a) Disclaiming warranty or limiting liability differently from the
terms of sections 15 and 16 of this License; or
b) Requiring preservation of specified reasonable legal notices or
author attributions in that material or in the Appropriate Legal
Notices displayed by works containing it; or
c) Prohibiting misrepresentation of the origin of that material, or
requiring that modified versions of such material be marked in
reasonable ways as different from the original version; or
d) Limiting the use for publicity purposes of names of licensors or
authors of the material; or
e) Declining to grant rights under trademark law for use of some
trade names, trademarks, or service marks; or
f) Requiring indemnification of licensors and authors of that
material by anyone who conveys the material (or modified versions of
it) with contractual assumptions of liability to the recipient, for
any liability that these contractual assumptions directly impose on
those licensors and authors.
All other non-permissive additional terms are considered "further
restrictions" within the meaning of section 10. If the Program as you
received it, or any part of it, contains a notice stating that it is
governed by this License along with a term that is a further
restriction, you may remove that term. If a license document contains
a further restriction but permits relicensing or conveying under this
License, you may add to a covered work material governed by the terms
of that license document, provided that the further restriction does
not survive such relicensing or conveying.
If you add terms to a covered work in accord with this section, you
must place, in the relevant source files, a statement of the
additional terms that apply to those files, or a notice indicating
where to find the applicable terms.
Additional terms, permissive or non-permissive, may be stated in the
form of a separately written license, or stated as exceptions;
the above requirements apply either way.
8. Termination.
You may not propagate or modify a covered work except as expressly
provided under this License. Any attempt otherwise to propagate or
modify it is void, and will automatically terminate your rights under
this License (including any patent licenses granted under the third
paragraph of section 11).
However, if you cease all violation of this License, then your
license from a particular copyright holder is reinstated (a)
provisionally, unless and until the copyright holder explicitly and
finally terminates your license, and (b) permanently, if the copyright
holder fails to notify you of the violation by some reasonable means
prior to 60 days after the cessation.
Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.
Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License. If your rights have been terminated and not permanently
reinstated, you do not qualify to receive new licenses for the same
material under section 10.
9. Acceptance Not Required for Having Copies.
You are not required to accept this License in order to receive or
run a copy of the Program. Ancillary propagation of a covered work
occurring solely as a consequence of using peer-to-peer transmission
to receive a copy likewise does not require acceptance. However,
nothing other than this License grants you permission to propagate or
modify any covered work. These actions infringe copyright if you do
not accept this License. Therefore, by modifying or propagating a
covered work, you indicate your acceptance of this License to do so.
10. Automatic Licensing of Downstream Recipients.
Each time you convey a covered work, the recipient automatically
receives a license from the original licensors, to run, modify and
propagate that work, subject to this License. You are not responsible
for enforcing compliance by third parties with this License.
An "entity transaction" is a transaction transferring control of an
organization, or substantially all assets of one, or subdividing an
organization, or merging organizations. If propagation of a covered
work results from an entity transaction, each party to that
transaction who receives a copy of the work also receives whatever
licenses to the work the party's predecessor in interest had or could
give under the previous paragraph, plus a right to possession of the
Corresponding Source of the work from the predecessor in interest, if
the predecessor has it or can get it with reasonable efforts.
You may not impose any further restrictions on the exercise of the
rights granted or affirmed under this License. For example, you may
not impose a license fee, royalty, or other charge for exercise of
rights granted under this License, and you may not initiate litigation
(including a cross-claim or counterclaim in a lawsuit) alleging that
any patent claim is infringed by making, using, selling, offering for
sale, or importing the Program or any portion of it.
11. Patents.
A "contributor" is a copyright holder who authorizes use under this
License of the Program or a work on which the Program is based. The
work thus licensed is called the contributor's "contributor version".
A contributor's "essential patent claims" are all patent claims
owned or controlled by the contributor, whether already acquired or
hereafter acquired, that would be infringed by some manner, permitted
by this License, of making, using, or selling its contributor version,
but do not include claims that would be infringed only as a
consequence of further modification of the contributor version. For
purposes of this definition, "control" includes the right to grant
patent sublicenses in a manner consistent with the requirements of
this License.
Each contributor grants you a non-exclusive, worldwide, royalty-free
patent license under the contributor's essential patent claims, to
make, use, sell, offer for sale, import and otherwise run, modify and
propagate the contents of its contributor version.
In the following three paragraphs, a "patent license" is any express
agreement or commitment, however denominated, not to enforce a patent
(such as an express permission to practice a patent or covenant not to
sue for patent infringement). To "grant" such a patent license to a
party means to make such an agreement or commitment not to enforce a
patent against the party.
If you convey a covered work, knowingly relying on a patent license,
and the Corresponding Source of the work is not available for anyone
to copy, free of charge and under the terms of this License, through a
publicly available network server or other readily accessible means,
then you must either (1) cause the Corresponding Source to be so
available, or (2) arrange to deprive yourself of the benefit of the
patent license for this particular work, or (3) arrange, in a manner
consistent with the requirements of this License, to extend the patent
license to downstream recipients. "Knowingly relying" means you have
actual knowledge that, but for the patent license, your conveying the
covered work in a country, or your recipient's use of the covered work
in a country, would infringe one or more identifiable patents in that
country that you have reason to believe are valid.
If, pursuant to or in connection with a single transaction or
arrangement, you convey, or propagate by procuring conveyance of, a
covered work, and grant a patent license to some of the parties
receiving the covered work authorizing them to use, propagate, modify
or convey a specific copy of the covered work, then the patent license
you grant is automatically extended to all recipients of the covered
work and works based on it.
A patent license is "discriminatory" if it does not include within
the scope of its coverage, prohibits the exercise of, or is
conditioned on the non-exercise of one or more of the rights that are
specifically granted under this License. You may not convey a covered
work if you are a party to an arrangement with a third party that is
in the business of distributing software, under which you make payment
to the third party based on the extent of your activity of conveying
the work, and under which the third party grants, to any of the
parties who would receive the covered work from you, a discriminatory
patent license (a) in connection with copies of the covered work
conveyed by you (or copies made from those copies), or (b) primarily
for and in connection with specific products or compilations that
contain the covered work, unless you entered into that arrangement,
or that patent license was granted, prior to 28 March 2007.
Nothing in this License shall be construed as excluding or limiting
any implied license or other defenses to infringement that may
otherwise be available to you under applicable patent law.
12. No Surrender of Others' Freedom.
If conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot convey a
covered work so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you may
not convey it at all. For example, if you agree to terms that obligate you
to collect a royalty for further conveying from those to whom you convey
the Program, the only way you could satisfy both those terms and this
License would be to refrain entirely from conveying the Program.
13. Use with the GNU Affero General Public License.
Notwithstanding any other provision of this License, you have
permission to link or combine any covered work with a work licensed
under version 3 of the GNU Affero General Public License into a single
combined work, and to convey the resulting work. The terms of this
License will continue to apply to the part which is the covered work,
but the special requirements of the GNU Affero General Public License,
section 13, concerning interaction through a network will apply to the
combination as such.
14. Revised Versions of this License.
The Free Software Foundation may publish revised and/or new versions of
the GNU General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the
Program specifies that a certain numbered version of the GNU General
Public License "or any later version" applies to it, you have the
option of following the terms and conditions either of that numbered
version or of any later version published by the Free Software
Foundation. If the Program does not specify a version number of the
GNU General Public License, you may choose any version ever published
by the Free Software Foundation.
If the Program specifies that a proxy can decide which future
versions of the GNU General Public License can be used, that proxy's
public statement of acceptance of a version permanently authorizes you
to choose that version for the Program.
Later license versions may give you additional or different
permissions. However, no additional obligations are imposed on any
author or copyright holder as a result of your choosing to follow a
later version.
15. Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
16. Limitation of Liability.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
17. Interpretation of Sections 15 and 16.
If the disclaimer of warranty and limitation of liability provided
above cannot be given local legal effect according to their terms,
reviewing courts shall apply local law that most closely approximates
an absolute waiver of all civil liability in connection with the
Program, unless a warranty or assumption of liability accompanies a
copy of the Program in return for a fee.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
Copyright (C)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
Also add information on how to contact you by electronic and paper mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:
Copyright (C)
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, your program's commands
might be different; for a GUI interface, you would use an "about box".
You should also get your employer (if you work as a programmer) or school,
if any, to sign a "copyright disclaimer" for the program, if necessary.
For more information on this, and how to apply and follow the GNU GPL, see
.
The GNU General Public License does not permit incorporating your program
into proprietary programs. If your program is a subroutine library, you
may consider it more useful to permit linking proprietary applications with
the library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License. But first, please read
.PK \Ea_ _ % vendor/akeeba/phpfinder/composer.locknu [ {
"_readme": [
"This file locks the dependencies of your project to a known state",
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
"This file is @generated automatically"
],
"content-hash": "7781f30ed3e550ed1cbfc9eab4b57a16",
"packages": [],
"packages-dev": [],
"aliases": [],
"minimum-stability": "stable",
"stability-flags": [],
"prefer-stable": false,
"prefer-lowest": false,
"platform": {
"php": ">=7.2.0 <=8.4"
},
"platform-dev": [],
"plugin-api-version": "2.6.0"
}
PK \F4 % vendor/akeeba/phpfinder/composer.jsonnu [ {
"name": "akeeba/phpfinder",
"type": "library",
"description": "Locate the PHP CLI binary on the server",
"require": {
"php": ">=7.2.0 <=8.4"
},
"keywords": [
"php", "cli"
],
"homepage": "https://github.com/akeeba/phpfinder",
"license": "GPL-3.0-or-later",
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM_PLEASE@akeeba.com",
"homepage": "http://www.dionysopoulos.me",
"role": "Lead Developer"
}
],
"autoload": {
"psr-4": {
"Akeeba\\PHPFinder\\": "src"
}
}
}
PK \TJA A vendor/akeeba/phpfinder/LICENSEnu [ Copyright (c) 2024-2025 Akeeba Ltd
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.PK \<5{ { ! vendor/akeeba/phpfinder/README.mdnu [ # PHPFinder
Locate the PHP CLI binary on the server.
**Please read the Caveats section thoroughly before using this library.**
## What's this?
This library locates the PHP CLI binary from the web (Apache mod_php, CGI, or FastCGI) execution context.
The environments currently supported are:
* cPanel with EasyPHP
* cPanel on CloudLinux
* Plesk on Linux, and Windows
* XAMPP on Linux, Windows, or macOS
* MAMP on Windows, and macOS
* HomeBrew on macOS
* WAMPServer on Windows
* Generic Linux server (works with Debian, Red Hat, Arch Linux, and their derivative distributions)
* Generic BSD server
* Generic Windows server, including PHP installations in C:\PHP
* Generic macOS server
You can try to locate a specific version of PHP (by `major.minor` or `major.minor.patch` version specification), or just any available PHP version.
## Use case
We have mass-distributed web applications which are meant to be installed and operated by non-technical end users.
Oftentimes we provide CLI scripts or integrations with such (e.g. integration with Joomla! CLI, or WP-CLI). The user typically needs very precise instructions to execute these CLI scripts, either directly on a terminal or inside a CRON job.
This requires two things: the path to the PHP CLI executable, and the path to the script they need to execute. The latter is straightforward to determine from within the web application. The former is not. This is what this library does. It tries to locate the PHP CLI binary on the server.
## Basic usage
At a minimum you can do:
```php
$cliPath = \Akeeba\PHPFinder\PHPFinder::make()->getBestPath(PHP_VERSION);
```
This will try to locate the PHP CLI path for the current PHP version. If it fails, it will return NULL.
## Advanced usage
Create and set up a `Configuration` object:
```php
// Check the source comments of the Configuration class to understand what each setting does.
$configuration = \Akeeba\PHPFinder\Configuration::make()
->setExtendedBinaryNameSearch(false)
->setSoftwareSpecific(false);
```
Create a `PHPFinder` object using the configuration object:
```php
$finder = \Akeeba\PHPFinder\PHPFinder::make($configuration);
```
Search for any available PHP version, or a specific one:
```php
$anyPHP = $finder->getBestPath();
$php83 = $finder->getBestPath('8.3');
```
You can also get all auto-detected PHP folders for a given PHP version:
```php
$anyPHPArray = $finder->getPossiblePaths();
$php83Array = $finder->getPossiblePaths('8.3');
```
## Caveats
**Server hangs**. The default behaviour of this library is to run the executables discovered using `exec()` to validate that the version number returned by the executable is the expected, as well as validate that the binary is the PHP CLI (and not PHP CGI/FastCGI). This may cause some servers to abort execution, resulting in an HTTP 500 Internal Server Error status code or, worse, a blank page with an HTTP 200 OK status. You can prevent that by disabling these features in the configuration object:
```php
// Check the source comments of the Configuration class to understand what each setting does.
$finder = \Akeeba\PHPFinder\PHPFinder::make(
\Akeeba\PHPFinder\Configuration::make()
->setValidateVersion(false)
->setValidateCli(false)
);
```
Another approach is to have your software store a persistent flag before and after using this library so that you can set the correct configuration options. For example:
```php
$validationFlag = $myAppStorage->get('phpfinder_validate') ?? true;
$myAppStorage->set('phpfinder_validate', false);
$finder = \Akeeba\PHPFinder\PHPFinder::make(
\Akeeba\PHPFinder\Configuration::make()
->setValidateVersion($validationFlag)
->setValidateCli($validationFlag)
);
$phpPath = $finder->getBestPath(PHP_VERSION);
$myAppStorage->set('phpfinder_validate', true);
```
If the attempt to use this library fails the flag is set to `false` since the server kills the script before we reach the final statement which resets the flag to `true`. Therefore, when the user reloads the page the flag will be `false`, and the library won't fail to execute in this or any subsequent execution. The downside of this approach is that a stark minority of users will experience an error the first time you try to determine the PHP CLI execution path with this library.
**Performance**. Searching for a specific PHP CLI can be slow in some use cases. We strongly recommend caching the results after the first run.
**Accuracy**. This library is trying to strike a balance between speed and accuracy. This may result in a perceived "wrong" PHP path to be returned. We know of the following use cases where this might happen:
* Searching for a PHP version by major and minor (but no patch) version MAY return an older patch version of PHP. This could happen if multiple PHP versions with the same minor version but different full version (including patch), are installed at the same time. For example, if you have PHP 8.3.1 and PHP 8.3.4 installed at the same time, and you search for PHP 8.3, there is no guarantee that PHP 8.3.4 will be returned.
* If you have multiple installations of the same PHP version across the system, there is no guarantee that the PHP binary you will be returned will be the one belonging in the same installation. For example, you may have a Linux server with PHP installed globally, but also as part of XAMPP. If you run a web script under XAMPP and use this library, you MAY be returned the globally installed PHP CLI version of the same version as your XAMPP PHP version.
* Likewise, if you have multiple PHP installations, and you don't specify a PHP version, there is no guarantee that the path returned will be the latest PHP version, or any particular PHP version. It will be _a_ PHP version found on the server.
**Search by major version**. Searching for a PHP version just by its major version is NOT supported for practical reasons and because minor PHP versions introduce backwards incompatible changes. Searching for PHP 8 could for example return 8.4, or 8.0. You wouldn't know which one it would return in advance, and it might be a version that's incompatible with your software! If you want to simulate this very inefficient and inaccurate search, you can look for PHP x.6, x.5, x.4, x.3, x.2, x.1, and x.0 in this order, returning whichever is found first. Do keep in mind that just because you can doesn't mean you should.
**PHP configuration**. Most servers have a _separate_ configuration for PHP CLI than the one used for the web SAPI (mod_php, CGI, or FastCGI). This is a non-obvious caveat which needs to be communicated to your users. There is no good, fool-proof way to automate using the same configuration across PHP and the web in those environments.PK \ey - vendor/akeeba/phpfinder/src/Configuration.phpnu [ $value)
{
$configuration->{$key} = $value;
}
return $configuration;
}
/**
* Magic property getter.
*
* @param string $name The property name to get.
*
* @return bool
* @since 1.0.0
*/
public function __get($name)
{
if (property_exists($this, $name))
{
return $this->{$name};
}
throw new \InvalidArgumentException(
sprintf('Undefined property: %s::$%s', get_class($this), $name)
);
}
/**
* Magic property setter.
*
* @param string $name The property name to set.
* @param bool $value The value to set the property to.
*
* @return void
* @since 1.0.0
*/
public function __set($name, $value)
{
if (property_exists($this, $name))
{
$this->{$name} = @boolval($value);
}
throw new \InvalidArgumentException(
sprintf('Undefined property: %s::$%s', get_class($this), $name)
);
}
/**
* Magic function call handler.
*
* Allows you to set configuration parameters using virtual setPropertyName methods which return $this for chaining.
*
* @param string $name The method name
* @param array $arguments Its parameters
*
* @return $this Self for chaining calls
* @since 1.0.0
*/
public function __call($name, $arguments)
{
if (substr($name, 0, 3) !== 'set')
{
throw new \BadMethodCallException(
sprintf('Call to undefined method %s::%s()', get_class($this), $name)
);
}
$name = substr($name, 3);
$name = strtolower(substr($name, 0, 1)) . substr($name, 1);
$this->{$name} = boolval($arguments[0]);
return $this;
}
}PK \a$d $d ) vendor/akeeba/phpfinder/src/PHPFinder.phpnu [ configuration = $configuration ?? new Configuration();
}
/**
* Get the best guess path for the requested PHP version's CLI executable.
*
* If the version is not found, it will return NULL.
*
* If no version is specified, any PHP CLI binary will be returned; not necessarily the one with the latest PHP
* version!
*
* If no suitable executable is found (there is no PHP CLI executable installed, or it uses an uncommon path) NULL
* will be returned as well.
*
* @param string|null $version The version to look for.
*
* @return string|null
* @since 1.0.0
*/
final public function getBestPath(?string $version = null): ?string
{
$info = $this->getBestPathMeta($version);
return $info === null ? null : $info->path;
}
/**
* Get the best guess path for the requested PHP version's CLI executable along with its metadata.
*
* See notes on getBestPath.
*
* @param string|null $version The version to look for.
*
* @return null|object{version: string, cli: bool, path: string}
* @since 1.0.0
* @see self::getBestPath
*/
final public function getBestPathMeta(?string $version = null): ?object
{
$possiblePaths = $this->getPossiblePaths($version);
if (empty($possiblePaths))
{
return null;
}
foreach ($possiblePaths as $path)
{
$info = $this->analyzePHPVersion($path);
if ($info->version === null)
{
continue;
}
if ($this->configuration->validateVersion && strpos($info->version, $version) === false)
{
continue;
}
if ($this->configuration->validateCli && !$info->cli)
{
continue;
}
$info->path = $path;
return $info;
}
return null;
}
/**
* Gets all possible PHP CLI paths available on the server.
*
* The returned paths might NOT correspond to the correct version. Some paths are generic. Use getBestPath() with
* default configuration options to guarantee the accuracy of the result.
*
* @param string|null $version The version to look for.
*
* @return array
* @since 1.0.0
*/
public function getPossiblePaths(?string $version = null): array
{
$ret = [];
// PHP constants
$ret = array_merge($ret, $this->pathsFromConstants());
// OS-specific search methods
$ret = array_merge($ret, $this->pathsUNIX($version));
$ret = array_merge($ret, $this->pathsUsingWhich($version));
$ret = array_merge($ret, $this->pathsUsingUpdateAlternatives($version));
$ret = array_merge($ret, $this->pathsUsingWhereIs($version));
$ret = array_merge($ret, $this->pathsUsingWhere($version));
$ret = array_merge($ret, $this->pathsFromCommonWindowsInstallPaths($version));
// Software-specific
$ret = array_merge($ret, $this->pathsCPanel($version));
$ret = array_merge($ret, $this->pathsCloudLinux($version));
$ret = array_merge($ret, $this->pathsPlesk($version));
$ret = array_merge($ret, $this->pathsXAMPP($version));
$ret = array_merge($ret, $this->pathsMAMP($version));
$ret = array_merge($ret, $this->pathsHomeBrew($version));
$ret = array_merge($ret, $this->pathsWAMPServer($version));
return array_filter(
array_unique($ret),
function ($filePath) {
return !empty($filePath) && @is_file($filePath);
}
);
}
/**
* Get possible paths from PHP constants.
*
* Available on all OS. Fast.
*
* @return array
* @since 1.0.0
*/
private function pathsFromConstants(): array
{
if (!$this->configuration->useConstants)
{
return [];
}
$ret = [];
defined('PHP_BINARY') && $ret[] = PHP_BINARY;
/** @noinspection PhpUndefinedConstantInspection */
defined('PHP_PATH') && $ret[] = PHP_PATH;
/** @noinspection PhpUndefinedConstantInspection */
defined('PHP_PEAR_PHP_BIN') && $ret[] = PHP_PEAR_PHP_BIN;
return $ret;
}
/**
* Return the default PHP paths for UNIX compatible systems.
*
* Available on Linux, BSD, and macOS. Very fast.
*
* @param string|null $version The optional version to look for
*
* @return array
* @since 1.0.0
*/
private function pathsUNIX(?string $version = null): array
{
if (
!$this->configuration->osSpecific
|| !$this->configuration->useWhich
|| !in_array(strtoupper(PHP_OS_FAMILY), ['LINUX', 'BSD', 'DARWIN'])
)
{
return [];
}
$possibleNames = $this->getBinaryNamesForVersion($version);
$ret = [];
foreach ($possibleNames as $binName)
{
$ret[] = '/usr/bin/' . $binName;
$ret[] = '/usr/local/bin/' . $binName;
$ret[] = '/opt/bin/' . $binName;
}
return $ret;
}
/**
* Get possible PHP paths using `which`.
*
* Available on Linux and macOS. Moderately slow (about 100 msec).
*
* @param string|null $version Optional PHP version to look for
*
* @return array
* @since 1.0.0
*/
private function pathsUsingWhich(?string $version = null): array
{
if (
!$this->configuration->osSpecific
|| !$this->configuration->useWhich
|| !in_array(strtoupper(PHP_OS_FAMILY), ['LINUX', 'BSD', 'DARWIN'])
)
{
return [];
}
if (!function_exists('exec') || !$this->executableExists('which'))
{
return [];
}
$possibleExecutables = $this->getBinaryNamesForVersion($version);
$ret = [];
foreach ($possibleExecutables as $executable)
{
$which = @exec('which ' . escapeshellarg($executable) . ' 2>/dev/null', $output, $resultCode);
if ($which === false || $resultCode !== 0)
{
continue;
}
$paths = explode("\n", $which);
$paths = array_filter($paths);
$ret = array_merge($ret, $paths);
}
return $ret;
}
/**
* Find possible PHP paths using `update-alternatives`.
*
* Available on Linux (only Debian and derivatives). Fast.
*
* @param string|null $version Optional PHP version to look for
*
* @return array
* @since 1.0.0
*/
private function pathsUsingUpdateAlternatives(?string $version): array
{
if (
!$this->configuration->osSpecific
|| !$this->configuration->useUpdateAlternatives
|| in_array(strtoupper(PHP_OS_FAMILY), ['LINUX', 'BSD'])
)
{
return [];
}
if (!function_exists('exec') || !$this->executableExists('update-alternatives'))
{
return [];
}
$possibleExecutables = $this->getBinaryNamesForVersion($version);
$ret = [];
$result = @exec('update-alternatives --list php 2>/dev/null', $output);
if ($result === false)
{
return $ret;
}
foreach ($output as $line)
{
$parts = explode(DIRECTORY_SEPARATOR, $line);
$lastPart = end($parts);
if (in_array($lastPart, $possibleExecutables, true))
{
$ret[] = $line;
continue;
}
if (strpos($lastPart, '/') === false && strpos($lastPart, '\\') === false)
{
continue;
}
$lastPart = str_replace('\\', '/', $lastPart);
$parts = explode(DIRECTORY_SEPARATOR, $lastPart);
$lastPart = end($parts);
if (in_array($lastPart, $possibleExecutables, true))
{
$ret[] = $line;
}
}
return $ret;
}
/**
* Find possible PHP paths using `whereis`.
*
* Available on Linux, macOS. Slow (over 1 second).
*
* @param string|null $version Optional PHP version to look for
*
* @return array
* @since 1.0.0
*/
private function pathsUsingWhereIs(?string $version): array
{
if (
!$this->configuration->osSpecific
|| !$this->configuration->useWhereIs
|| !in_array(strtoupper(PHP_OS_FAMILY), ['LINUX', 'BSD', 'DARWIN'])
)
{
return [];
}
if (!function_exists('exec') || !$this->executableExists('whereis'))
{
return [];
}
$possibleExecutables = $this->getBinaryNamesForVersion($version);
$ret = [];
foreach ($possibleExecutables as $executable)
{
$result = @exec('whereis -b ' . escapeshellarg($executable) . ' 2>/dev/null');
if ($result === false)
{
continue;
}
[, $rawList] = explode(':', $result);
$list = explode(' ', $rawList);
$list = array_filter($list);
if (empty($list))
{
continue;
}
foreach ($list as $path)
{
if (!@is_file($path))
{
continue;
}
$ret[] = $path;
}
}
return $ret;
}
/**
* Get possible PHP paths using `where`.
*
* Available on Windows. Fast.
*
* @param string|null $version Optional PHP version to look for
*
* @return array
* @since 1.0.0
*/
private function pathsUsingWhere(?string $version = null): array
{
if (
!$this->configuration->osSpecific
|| !$this->configuration->useWhere
|| strtoupper(PHP_OS_FAMILY) !== 'WINDOWS'
)
{
return [];
}
if (!function_exists('exec') || !$this->executableExists('where'))
{
return [];
}
$possibleExecutables = $this->getBinaryNamesForVersion($version);
$ret = [];
foreach ($possibleExecutables as $executable)
{
$where = @exec('where ' . escapeshellarg($executable), $output, $resultCode);
if ($where === false || $resultCode !== 0)
{
continue;
}
$paths = explode("\n", $where);
$paths = array_filter($paths);
$ret = array_merge($ret, $paths);
}
return $ret;
}
/**
* Get possible paths from common windows PHP installation paths
*
* @param string|null $version The version to look for
*
* @return array
* @since 1.0.0
*/
private function pathsFromCommonWindowsInstallPaths(?string $version = null): array
{
if (
!$this->configuration->osSpecific
|| !$this->configuration->usePHPCommonWinDirsSearch
|| strtoupper(PHP_OS_FAMILY) !== 'WINDOWS'
)
{
return [];
}
$possiblePaths = [];
foreach ($this->getWindowsDrives() as $drive)
{
$possiblePaths = array_merge(
$possiblePaths,
$this->getWindowsProgramFilesPHPPaths($drive, $version),
$this->getWindowsProgramFilesPHPPaths($drive . '\\Program Files', $version),
$this->getWindowsProgramFilesPHPPaths($drive . '\\Program Files (x86)', $version)
);
}
$programFiles = @getenv('PROGRAMFILES');
$programFilesx86 = @getenv('PROGRAMFILES(X86)');
$possiblePaths = array_merge($possiblePaths, $this->getWindowsProgramFilesPHPPaths($programFiles, $version));
$possiblePaths = array_merge($possiblePaths, $this->getWindowsProgramFilesPHPPaths($programFilesx86, $version));
$possiblePaths = array_unique($possiblePaths);
asort($possiblePaths);
$ret = [];
$binaryNames = $this->getBinaryNamesForVersion($version);
foreach ($possiblePaths as $path => $maxNesting)
{
$ret = array_merge(
$ret,
$this->recursivePathScanner($path, 0, $maxNesting, $binaryNames)
);
}
return array_unique($ret);
}
/**
* Return cPanel-specific PHP paths. Only works given a version.
*
* Available on Linux. Very fast.
*
* @param string|null $version The version to get paths for.
*
* @return array
* @since 1.0.0
*/
private function pathsCPanel(?string $version): array
{
/** @noinspection DuplicatedCode */
if (
empty($version)
|| !$this->configuration->softwareSpecific
|| in_array(strtoupper(PHP_OS_FAMILY), ['LINUX', 'BSD'])
)
{
return [];
}
[$major, $minor] = $this->getMajorMinor($version);
if ($major === null || $minor === null)
{
return [];
}
$suffix = $major . $minor;
return [
'/opt/cpanel/ea-php' . $suffix . '/root/usr/bin/php',
'/usr/bin/ea-php' . $suffix,
'/usr/local/bin/ea-php' . $suffix,
];
}
/**
* Return CloudLinux-specific PHP paths. Only works given a version.
*
* Available on Linux. Very fast.
*
* @param string|null $version The version to get paths for.
*
* @return array
* @since 1.0.0
*/
private function pathsCloudLinux(?string $version): array
{
/** @noinspection DuplicatedCode */
if (
empty($version)
|| !$this->configuration->softwareSpecific
|| in_array(strtoupper(PHP_OS_FAMILY), ['LINUX', 'BSD'])
)
{
return [];
}
[$major, $minor] = $this->getMajorMinor($version);
if ($major === null || $minor === null)
{
return [];
}
$suffix = $major . $minor;
return [
'/opt/cloudlinux/alt-php' . $suffix . '/root/usr/bin/php',
'/usr/bin/alt-php' . $suffix,
'/usr/local/bin/alt-php' . $suffix,
];
}
/**
* Return Plesk-specific PHP paths. Only works given a version.
*
* Available on Linux. Very fast.
*
* @param string|null $version The version to get paths for.
*
* @return array
* @since 1.0.0
*/
private function pathsPlesk(?string $version): array
{
if (
empty($version)
|| !$this->configuration->softwareSpecific
)
{
return [];
}
[$major, $minor] = $this->getMajorMinor($version);
if ($major === null || $minor === null)
{
return [];
}
$suffix = $major . '.' . $minor;
switch (strtoupper(PHP_OS_FAMILY))
{
case 'LINUX':
case 'BSD':
return [
'/opt/plesk/php/' . $suffix . '/bin/php',
'/usr/bin/php' . $suffix,
'/usr/local/bin/php' . $suffix,
];
case 'WINDOWS':
// Binary found in %plesk_dir%Additional\PHPXX\php.exe
$pleskDir = @getenv('PLESK_DIR');
if (empty($pleskDir))
{
return [];
}
return [
rtrim($pleskDir, '\\') . '\\Additional\\PHP' . $suffix . '\\php.exe',
];
default:
return [];
}
}
/**
* Returns the PHP path for XAMPP.
*
* This assumes that you are using the default installation path which is one of the following.
*
* - Windows: C:\xampp on Windows (where C: could be any known drive letter)
* - Linux: /opt/lampp
* - macOS: /Applications/XAMPP
*
* @param string|null $version Ignored; XAMPP only has one PHP version installed at a time.
*
* @return array
* @since 1.0.0
*/
private function pathsXAMPP(?string $version): array
{
if (!$this->configuration->softwareSpecific)
{
return [];
}
switch (strtoupper(PHP_OS_FAMILY))
{
case 'WINDOWS':
return array_map(
function ($drive) {
return rtrim($drive, '\\') . '\\xampp\\php\\php.exe';
},
$this->getWindowsDrives() ?: ['C:']
);
case 'LINUX':
case 'BSD':
return [
'/opt/lampp/php/php',
];
case 'DARWIN':
return [
'/Applications/XAMPP/php/php',
];
default:
return [];
}
}
/**
* Get the MAMP / MAMP Pro paths for PHP CLI.
*
* Available on macOS, and Windows. Fast.
*
* @param string|null $version The version to get paths for.
*
* @return array
* @since 1.0.0
*/
private function pathsMAMP(?string $version)
{
if (!$this->configuration->softwareSpecific)
{
return [];
}
switch (strtoupper(PHP_OS_FAMILY))
{
case 'DARWIN':
$rootPath = '/Applications/MAMP/bin/php/';
break;
case 'WINDOWS':
$drives = $this->getWindowsDrives();
foreach ($drives as $drive)
{
$rootPath = $drive . '\\MAMP\\bin\\php';
if (!@is_dir($rootPath))
{
continue;
}
$rootPath .= '\\';
break;
}
return [];
default:
return [];
}
if (!@is_dir($rootPath))
{
return [];
}
return $this->recursivePathScanner($rootPath, 0, 1, ['php']);
}
/**
* Get the HomeBrew paths for PHP CLI.
*
* Available on macOS, and Linux. Moderately fast.
*
* @param string|null $version The version to get paths for.
*
* @return array
* @since 1.0.0
*/
private function pathsHomeBrew(?string $version): array
{
if (!$this->configuration->softwareSpecific && !in_array(strtoupper(PHP_OS_FAMILY), ['LINUX', 'BSD', 'DARWIN']))
{
return [];
}
if (!function_exists('exec') || !$this->executableExists('brew'))
{
return [];
}
$checkFor = [];
[$major, $minor] = $this->getMajorMinor($version);
if ($minor !== null && $major === null)
{
$checkFor[] = 'php@' . $major . '.' . $minor;
}
$checkFor[] = 'php';
foreach ($checkFor as $package)
{
$result = @exec('brew --prefix ' . escapeshellarg($package));
if (!$result)
{
continue;
}
return [$result];
}
return [];
}
/**
* Get the WAMPServer paths for PHP CLI.
*
* IMPORTANT! This will return the paths to PHP CLI for all installed PHP versions. Unlike most other prepackaged
* xAMP servers, WAMPServer allows you to have multiple patch versions of the same minor PHP version installed at
* the same time. This makes it impossible to find a specific PHP version if you give only a minor version. This can
* be addressed by checking for the exact version during the verification stage.
*
* Available on Windows. Moderately fast.
*
* @param string|null $version The version to get paths for.
*
* @return array
* @since 1.0.0
*/
private function pathsWAMPServer(?string $version): array
{
if (!$this->configuration->softwareSpecific && strtoupper(PHP_OS_FAMILY) != 'WINDOWS')
{
return [];
}
$possiblePaths = [];
foreach ($this->getWindowsDrives() as $drive)
{
$possiblePaths[$drive . '\\wamp\\bin\\php'] = 1;
$possiblePaths[$drive . '\\wamp64\\bin\\php'] = 1;
$possiblePaths[$drive . '\\Program Files (x86)\\WampServer\\bin\\php'] = 1;
$possiblePaths[$drive . '\\Program Files\\WampServer\\bin\\php'] = 1;
}
$possiblePaths = array_filter(
$possiblePaths,
function ($path) {
return @is_dir($path);
}
);
if (empty($possiblePaths))
{
return [];
}
$ret = [];
foreach ($possiblePaths as $path => $maxDepth)
{
$ret[] = array_merge($ret, $this->recursivePathScanner($path, 0, $maxDepth, ['php']));
}
return $ret;
}
/**
* Extract the major and minor version integers from a version string.
*
* @param string|null $version The version to parse.
*
* @return array The major and minor versions. NULL elements if invalid version.
* @since 1.0.0
*/
private function getMajorMinor(?string $version = null): array
{
$major = null;
$minor = null;
if (empty ($version))
{
return [$major, $minor];
}
$parts = explode('.', $version);
$major = @intval($parts[0]);
$minor = $parts[1] ?? null;
$minor = $minor === null ? null : @intval($minor);
$major = $major ?: null;
$minor = $major === null ? null : ($minor ?: null);
return [$major, $minor];
}
/**
* Get a list of possible PHP binary names for a given PHP version.
*
* Note: this does NOT add the `.exe` suffix on Windows!
*
* @param string|null $version The optional PHP version
*
* @return string[]
* @since 1.0.0
*/
private function getBinaryNamesForVersion(?string $version = null): array
{
$possibleExecutables = ['php'];
[$major, $minor] = $this->getMajorMinor($version);
if ($major === null)
{
return $possibleExecutables;
}
$suffix = $major . ($minor ?? '');
$altSuffix = $major . ($minor === null ? '' : ':') . ($minor ?? '');
$possibleExecutables[] = 'php' . $suffix;
$possibleExecutables[] = 'php' . $altSuffix;
$possibleExecutables[] = 'ea-php' . $suffix;
$possibleExecutables[] = 'alt-php' . $suffix;
if ($this->configuration->extendedBinaryNameSearch)
{
$possibleExecutables[] = 'php-cli';
$possibleExecutables[] = 'php' . $suffix . '-cli';
$possibleExecutables[] = 'php' . $altSuffix . '-cli';
$possibleExecutables[] = 'php-' . $suffix;
$possibleExecutables[] = 'php-' . $altSuffix;
$possibleExecutables[] = 'php-' . $suffix . 'cli';
$possibleExecutables[] = 'php-cli-' . $suffix;
$possibleExecutables[] = 'php-cli' . $suffix;
}
return $possibleExecutables;
}
/**
* Gets the current list of known Windows drives.
*
* This uses the Windows Management Instrumentation (wmic), or fsutil. If both fail, it returns only %SYSTEMDRIVE%.
*
* @return string[]
* @since 1.0.0
*/
private function getWindowsDrives(): array
{
static $drives = null;
if ($drives !== null)
{
return $drives;
}
$defaultFallback = [getenv('SYSTEMDRIVE') ?: 'C:'];
if (!function_exists('exec'))
{
return $drives = $defaultFallback;
}
// First, let's try WMIC (deprecated since Windows 11)
$result = $this->executableExists('wmic')
? @exec('wmic logicaldisk get name', $output)
: false;
if ($result !== false)
{
return $drives = array_filter(
$output,
function ($item) {
return strpos($item, ':') !== false;
}
);
}
// Use fsutil as a fallback
$result = $this->executableExists('fsutil')
? @exec('fsutil fsinfo drives')
: false;
if ($result !== false)
{
$parts = explode(':', $result, 2);
return $drives = array_map(
function ($x) {
return rtrim(trim($x), '\\');
},
array_filter(explode(' ', $parts[1] ?? ''))
) ?: $defaultFallback;
}
// If all else fails, return %SYSTEMDRIVE% or if that's not available just 'C:'.
return $drives = $defaultFallback;
}
/**
* Recursively scan paths on Windows for PHP binaries
*
* @param string $path The path to scan
* @param int $depth Current depth
* @param int $maxNesting Maximum depth to scan
* @param array $binaryNames List of allowed binary names (without the .exe suffix)
*
* @return array
* @since 1.0.0
*/
private function recursivePathScanner(string $path, int $depth, int $maxNesting, array $binaryNames): array
{
if (!@is_dir($path))
{
return [];
}
$ret = [];
$isWindows = strtoupper(PHP_OS_FAMILY) === 'WINDOWS';
/** @var \DirectoryIterator $file */
foreach (new \DirectoryIterator($path) as $file)
{
if ($file->isDot())
{
continue;
}
if ($file->isDir())
{
if ($depth >= $maxNesting)
{
continue;
}
$ret = array_merge(
$ret,
$this->recursivePathScanner($file->getPathName(), $depth + 1, $maxNesting, $binaryNames)
);
continue;
}
if (!$file->isFile())
{
continue;
}
if ($isWindows)
{
if ($file->getExtension() === 'exe' && in_array($file->getBasename('.exe'), $binaryNames))
{
$ret[] = $file->getBasename();
}
}
elseif (in_array($file->getBasename(), $binaryNames))
{
$ret[] = $file->getBasename();
}
}
return $ret;
}
/**
* Analyzes the version information output of the suspected PHP CLI binary.
*
* @param string $path
*
* @return object{version: string, cli: bool}
* @since 1.0.0
*/
private function analyzePHPVersion(string $path): object
{
$ret = (object) [
'version' => null,
'cli' => false,
];
if (!function_exists('exec'))
{
return $ret;
}
$result = @file_exists($path)
&& $this->isExecutable($path)
&& @exec(escapeshellcmd($path) . ' -v', $output);
if (!$result)
{
return $ret;
}
foreach ($output as $line)
{
if (substr($line, 0, 4) !== 'PHP ')
{
continue;
}
// PHP x.y.x (cli) (built: blah blah)
$parts = explode(' ', $line);
if (count($parts) < 3)
{
return $ret;
}
$ret->version = $parts[1];
$ret->cli = $parts[2] === '(cli)';
return $ret;
}
return $ret;
}
/**
* Get Windows PHP paths for a specific Program Files directory
*
* @param string $pathPrefix
* @param string|null $version
*
* @return array
* @since 1.0.0
*/
private function getWindowsProgramFilesPHPPaths(string $pathPrefix, ?string $version): array
{
$possiblePaths = [];
if (!$pathPrefix)
{
return $possiblePaths;
}
[$major, $minor] = $this->getMajorMinor();
$possiblePaths[rtrim($pathPrefix, '\\') . '\\PHP'] = 1;
if ($minor !== null)
{
$possiblePaths[rtrim($pathPrefix, '\\') . '\\PHP' . $major . $minor] = 0;
$possiblePaths[rtrim($pathPrefix, '\\') . '\\PHP' . $major . '.' . $minor] = 0;
$possiblePaths[rtrim($pathPrefix, '\\') . '\\PHP' . $version] = 0;
}
return $possiblePaths;
}
/**
* Checks whether a command exists in the user's PATH, and points to an executable file.
*
* @param string $command The command to check for.
*
* @return bool
* @since 1.0.0
*/
private function executableExists(string $command): bool
{
$path = getenv('PATH');
if (empty($path))
{
return false;
}
$directories = explode(PATH_SEPARATOR, $path);
foreach ($directories as $directory)
{
$fullPath = rtrim($directory, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $command;
if ($this->isExecutable($fullPath))
{
return true;
}
}
return false;
}
private function isExecutable(string $fullPath): bool
{
if (@is_executable($fullPath))
{
return true;
}
if (
(strtoupper(PHP_OS_FAMILY) === 'WINDOWS')
&& (
@is_executable($fullPath . '.exe')
|| @is_executable($fullPath . '.com')
|| @is_executable($fullPath . '.bat')
)
)
{
return true;
}
return false;
}
}PK \Sʉ % vendor/akeeba/phpfinder/src/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ ! vendor/akeeba/phpfinder/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ vendor/akeeba/s3/rector.phpnu [ withPaths([
__DIR__ . '/src',
])
->withPhpVersion(Rector\ValueObject\PhpVersion::PHP_84)
->withRules([
Rector\Php84\Rector\Param\ExplicitNullableParamTypeRector::class,
]);
PK \%[ vendor/akeeba/s3/composer.jsonnu [ {
"name": "akeeba/s3",
"type": "library",
"description": "A compact, dependency-less Amazon S3 API client implementing the most commonly used features",
"require": {
"php": "^7.4.0|^8.0",
"ext-curl": "*",
"ext-simplexml": "*"
},
"keywords": [
"s3"
],
"homepage": "https://github.com/akeeba/s3",
"license": "GPL-3.0-or-later",
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM_PLEASE@akeeba.com",
"homepage": "http://www.dionysopoulos.me",
"role": "Lead Developer"
}
],
"autoload": {
"psr-4": {
"Akeeba\\S3\\": "src"
},
"files": [
"src/aliasing.php"
]
},
"archive": {
"exclude": [
"minitest",
"TODO.md"
]
}
}
PK \6 vendor/akeeba/s3/src/Acl.phpnu [ ek ek " vendor/akeeba/s3/src/Connector.phpnu [ configuration = $configuration;
}
/**
* Put an object to Amazon S3, i.e. upload a file. If the object already exists it will be overwritten.
*
* @param Input $input Input object
* @param string $bucket Bucket name. If you're using v4 signatures it MUST be on the region defined.
* @param string $uri Object URI. Think of it as the absolute path of the file in the bucket.
* @param string $acl ACL constant, by default the object is private (visible only to the uploading
* user)
* @param array $requestHeaders Array of request headers
*
* @return void
*
* @throws CannotPutFile If the upload is not possible
*/
public function putObject(Input $input, string $bucket, string $uri, string $acl = Acl::ACL_PRIVATE, array $requestHeaders = []): void
{
$request = new Request('PUT', $bucket, $uri, $this->configuration);
$request->setInput($input);
// Custom request headers (Content-Type, Content-Disposition, Content-Encoding)
if (count($requestHeaders))
{
foreach ($requestHeaders as $h => $v)
{
if (strtolower(substr($h, 0, 6)) == 'x-amz-')
{
$request->setAmzHeader(strtolower($h), $v);
}
else
{
$request->setHeader($h, $v);
}
}
}
if (isset($requestHeaders['Content-Type']))
{
$input->setType($requestHeaders['Content-Type']);
}
if (($input->getSize() <= 0) || (($input->getInputType() == Input::INPUT_DATA) && (!strlen($input->getDataReference()))))
{
if (substr($uri, -1) !== '/')
{
throw new CannotPutFile('Missing input parameters', 0);
}
}
// We need to post with Content-Length and Content-Type, MD5 is optional
$request->setHeader('Content-Type', $input->getType());
$request->setHeader('Content-Length', $input->getSize());
if ($input->getMd5sum())
{
$request->setHeader('Content-MD5', $input->getMd5sum());
}
$request->setAmzHeader('x-amz-acl', $acl);
$response = $request->getResponse();
if ($response->code !== 200)
{
if (!$response->error->isError())
{
throw new CannotPutFile("Unexpected HTTP status {$response->code}", $response->code);
}
if (is_object($response->body) && ($response->body instanceof \SimpleXMLElement) && (strpos($input->getSize(), ',') === false))
{
// For some reason, trying to single part upload files on some hosts comes back with an inexplicable
// error from Amazon that we need to set Content-Length:5242880,5242880 instead of
// Content-Length:5242880 which is AGAINST Amazon's documentation. In this case we pass the header
// 'workaround-braindead-error-from-amazon' and retry. Uh, OK?
if (isset($response->body->CanonicalRequest))
{
$amazonsCanonicalRequest = (string) $response->body->CanonicalRequest;
$lines = explode("\n", $amazonsCanonicalRequest);
foreach ($lines as $line)
{
if (substr($line, 0, 15) != 'content-length:')
{
continue;
}
[$junk, $stupidAmazonDefinedContentLength] = explode(":", $line);
if (strpos($stupidAmazonDefinedContentLength, ',') !== false)
{
if (!isset($requestHeaders['workaround-braindead-error-from-amazon']))
{
$requestHeaders['workaround-braindead-error-from-amazon'] = 'you can\'t fix stupid';
$this->putObject($input, $bucket, $uri, $acl, $requestHeaders);
return;
}
}
}
}
}
}
if ($response->error->isError())
{
throw new CannotPutFile(
sprintf(__METHOD__ . "(): [%s] %s\n\nDebug info:\n%s", $response->error->getCode(), $response->error->getMessage(), print_r($response->body, true))
);
}
}
/**
* Get (download) an object
*
* @param string $bucket Bucket name
* @param string $uri Object URI
* @param string|resource|null $saveTo Filename or resource to write to
* @param int|null $from Start of the download range, null to download the entire object
* @param int|null $to End of the download range, null to download the entire object
*
* @return string|null No return if $saveTo is specified; data as string otherwise
*
*/
public function getObject(string $bucket, string $uri, $saveTo = null, ?int $from = null, ?int $to = null): ?string
{
$request = new Request('GET', $bucket, $uri, $this->configuration);
$fp = null;
if (!is_resource($saveTo) && is_string($saveTo))
{
$fp = @fopen($saveTo, 'w');
if ($fp === false)
{
throw new CannotOpenFileForWrite($saveTo);
}
}
if (is_resource($saveTo))
{
$fp = $saveTo;
}
if (is_resource($fp))
{
$request->setFp($fp);
}
// Set the range header
if ((!empty($from) && !empty($to)) || (!is_null($from) && !empty($to)))
{
$request->setHeader('Range', "bytes=$from-$to");
}
$response = $request->getResponse(true);
if (!$response->error->isError() && (($response->code !== 200) && ($response->code !== 206)))
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
throw new CannotGetFile(
sprintf(
__METHOD__ . "({%s}, {%s}): [%s] %s\n\nDebug info:\n%s",
$bucket,
$uri,
$response->error->getCode(),
$response->error->getMessage(),
print_r($response->body, true)
)
);
}
if (!is_resource($fp))
{
return $response->body;
}
return null;
}
/**
* Get information about an object.
*
* @param string $bucket Bucket name
* @param string $uri Object URI
*
* @return array The headers returned by Amazon S3
*
* @throws CannotGetFile If the file does not exist
* @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
*/
public function headObject(string $bucket, string $uri): array
{
$request = new Request('HEAD', $bucket, $uri, $this->configuration);
$response = $request->getResponse();
if (!$response->error->isError() && (($response->code !== 200) && ($response->code !== 206)))
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
throw new CannotGetFile(
sprintf(
__METHOD__ . "({%s}, {%s}): [%s] %s\n\nDebug info:\n%s",
$bucket,
$uri,
$response->error->getCode(),
$response->error->getMessage(),
print_r($response->body, true)
)
);
}
return $response->getHeaders();
}
/**
* Delete an object
*
* @param string $bucket Bucket name
* @param string $uri Object URI
*
* @return void
*/
public function deleteObject(string $bucket, string $uri): void
{
$request = new Request('DELETE', $bucket, $uri, $this->configuration);
$response = $request->getResponse();
if (!$response->error->isError() && ($response->code !== 204))
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
throw new CannotDeleteFile(
sprintf(
__METHOD__ . "({%s}, {%s}): [%s] %s",
$bucket,
$uri,
$response->error->getCode(),
$response->error->getMessage()
)
);
}
}
/**
* Get a query string authenticated URL
*
* @param string $bucket Bucket name
* @param string $uri Object URI
* @param int|null $lifetime Lifetime in seconds
* @param bool $https Use HTTPS ($hostBucket should be false for SSL verification)?
*
* @return string
*/
public function getAuthenticatedURL(string $bucket, string $uri, ?int $lifetime = null, bool $https = false): string
{
// Get a request from the URI and bucket
$questionmarkPos = strpos($uri, '?');
$query = '';
if ($questionmarkPos !== false)
{
$query = substr($uri, $questionmarkPos + 1);
$uri = substr($uri, 0, $questionmarkPos);
}
/**
* !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
* !!!! DO NOT TOUCH THIS CODE. YOU WILL BREAK PRE-SIGNED URLS WITH v4 SIGNATURES. !!!!
* !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
*
* The following two lines seem weird and possibly extraneous at first glance. However, they are VERY important.
* If you remove them pre-signed URLs for v4 signatures will break! That's because pre-signed URLs with v4
* signatures follow different rules than with v2 signatures.
*
* Authenticated (pre-signed) URLs are always made against the generic S3 region endpoint, not the bucket's
* virtual-hosting-style domain name. The bucket is always the first component of the path.
*
* For example, given a bucket called foobar, and an object baz.txt in it, we are pre-signing the URL
* https://s3-eu-west-1.amazonaws.com/foobar/baz.txt, not
* https://foobar.s3-eu-west-1.amazonaws.com/foobar/baz.txt (as we'd be doing with v2 signatures).
*
* The problem is that the Request object needs to be created before we can convey the intent (regular request
* or generation of a pre-signed URL). As a result its constructor creates the (immutable) request URI solely
* based on whether the Configuration object's getUseLegacyPathStyle() returns false or not.
*
* Since we want to request URI to contain the bucket name we need to tell the Request object's constructor that
* we are creating a Request object for path-style access, i.e. the useLegacyPathStyle flag in the Configuration
* object is true. Naturally, the default behavior being virtual-hosting-style access to buckets, this flag is
* most likely **false**.
*
* Therefore, we need to clone the Configuration object, set the flag to true and create a Request object using
* the falsified Configuration object.
*
* Note that v2 signatures are not affected. In v2 we are always appending the bucket name to the path, despite
* the fact that we include the bucket name in the domain name.
*
* !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
* !!!! DO NOT TOUCH THIS CODE. YOU WILL BREAK PRE-SIGNED URLS WITH v4 SIGNATURES. !!!!
* !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
*/
$newConfig = clone $this->configuration;
$newConfig->setUseLegacyPathStyle(true);
// Create the request object.
$request = new Request('GET', $bucket, $uri, $newConfig);
if ($query)
{
parse_str($query, $parameters);
if (count($parameters))
{
foreach ($parameters as $k => $v)
{
$request->setParameter($k, $v);
}
}
}
// Get the signed URI from the Request object
return $request->getAuthenticatedURL($lifetime, $https);
}
/**
* Get the location (region) of a bucket. You need this to use the V4 API on that bucket!
*
* @param string $bucket Bucket name
*
* @return string
*/
public function getBucketLocation(string $bucket): string
{
$request = new Request('GET', $bucket, '', $this->configuration);
$request->setParameter('location', null);
$response = $request->getResponse();
if (!$response->error->isError() && $response->code !== 200)
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
throw new CannotGetBucket(
sprintf(__METHOD__ . "(): [%s] %s", $response->error->getCode(), $response->error->getMessage())
);
}
$result = 'us-east-1';
if ($response->hasBody())
{
$result = (string) $response->body;
}
switch ($result)
{
// "EU" is an alias for 'eu-west-1', however the canonical location name you MUST use is 'eu-west-1'
case 'EU':
case 'eu':
$result = 'eu-west-1';
break;
// If the bucket location is 'us-east-1' you get an empty string. @#$%^&*()!!
case '':
$result = 'us-east-1';
break;
}
return $result;
}
/**
* Get the contents of a bucket
*
* If maxKeys is null this method will loop through truncated result sets
*
* @param string $bucket Bucket name
* @param string|null $prefix Prefix (directory)
* @param string|null $marker Marker (last file listed)
* @param int|null $maxKeys Maximum number of keys ("files" and "directories") to return
* @param string $delimiter Delimiter, typically "/"
* @param bool $returnCommonPrefixes Set to true to return CommonPrefixes
*
* @return array
*/
public function getBucket(string $bucket, ?string $prefix = null, ?string $marker = null, ?int $maxKeys = null, string $delimiter = '/', bool $returnCommonPrefixes = false): array
{
$internalResult = $this->internalGetBucket($bucket, $prefix, $marker, $maxKeys, $delimiter, $returnCommonPrefixes);
/**
* @var array $objects
* @var ?string $nextMarker
*/
extract($internalResult);
unset($internalResult);
// Loop through truncated results if maxKeys isn't specified or we don't have enough object records yet.
if ($nextMarker !== null && ($maxKeys === null || count($objects) < $maxKeys))
{
do
{
$internalResult = $this->internalGetBucket($bucket, $prefix, $nextMarker, $maxKeys, $delimiter, $returnCommonPrefixes);
$nextMarker = $internalResult['nextMarker'];
$objects = array_merge($objects, $internalResult['objects']);
unset($internalResult);
// If the last call did not return a nextMarker I am done iterating.
if ($nextMarker === null)
{
break;
}
// If we have maxKeys AND the number of objects is at least this many I am done iterating.
if ($maxKeys !== null && count($objects) >= $maxKeys)
{
break;
}
} while (true);
}
if ($maxKeys !== null)
{
return array_splice($objects, 0, $maxKeys);
}
return $objects;
}
/**
* Get a list of buckets
*
* @param bool $detailed Returns detailed bucket list when true
*
* @return array
*/
public function listBuckets(bool $detailed = false): array
{
// When listing buckets with the AWSv4 signature method we MUST set the region to us-east-1. Don't ask...
$configuration = clone $this->configuration;
$configuration->setRegion('us-east-1');
$request = new Request('GET', '', '', $configuration);
$response = $request->getResponse();
if (!$response->error->isError() && (($response->code !== 200)))
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
throw new CannotListBuckets(
sprintf(__METHOD__ . "(): [%s] %s", $response->error->getCode(), $response->error->getMessage())
);
}
$results = [];
if (!isset($response->body->Buckets))
{
return $results;
}
if ($detailed)
{
if (isset($response->body->Owner, $response->body->Owner->ID, $response->body->Owner->DisplayName))
{
$results['owner'] = [
'id' => (string) $response->body->Owner->ID,
'name' => (string) $response->body->Owner->DisplayName,
];
}
$results['buckets'] = [];
foreach ($response->body->Buckets->Bucket as $b)
{
$results['buckets'][] = [
'name' => (string) $b->Name,
'time' => strtotime((string) $b->CreationDate),
];
}
}
else
{
foreach ($response->body->Buckets->Bucket as $b)
{
$results[] = (string) $b->Name;
}
}
return $results;
}
/**
* Start a multipart upload of an object
*
* @param Input $input Input data
* @param string $bucket Bucket name
* @param string $uri Object URI
* @param string $acl ACL constant
* @param array $requestHeaders Array of request headers
*
* @return string The upload session ID (UploadId)
*/
public function startMultipart(Input $input, string $bucket, string $uri, string $acl = Acl::ACL_PRIVATE, array $requestHeaders = []): string
{
$request = new Request('POST', $bucket, $uri, $this->configuration);
$request->setParameter('uploads', '');
// Custom request headers (Content-Type, Content-Disposition, Content-Encoding)
if (is_array($requestHeaders))
{
foreach ($requestHeaders as $h => $v)
{
if (strtolower(substr($h, 0, 6)) == 'x-amz-')
{
$request->setAmzHeader(strtolower($h), $v);
}
else
{
$request->setHeader($h, $v);
}
}
}
$request->setAmzHeader('x-amz-acl', $acl);
if (isset($requestHeaders['Content-Type']))
{
$input->setType($requestHeaders['Content-Type']);
}
$request->setHeader('Content-Type', $input->getType());
$response = $request->getResponse();
if (!$response->error->isError() && ($response->code !== 200))
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
throw new CannotPutFile(
sprintf(
__METHOD__ . "(): [%s] %s\n\nDebug info:\n%s",
$response->error->getCode(),
$response->error->getMessage(),
print_r($response->body, true)
)
);
}
return (string) $response->body->UploadId;
}
/**
* Uploads a part of a multipart object upload
*
* @param Input $input Input data. You MUST specify the UploadID and PartNumber
* @param string $bucket Bucket name
* @param string $uri Object URI
* @param array $requestHeaders Array of request headers or content type as a string
* @param int $chunkSize Size of each upload chunk, in bytes. It cannot be less than 5242880 bytes (5Mb)
*
* @return null|string The ETag of the upload part of null if we have ran out of parts to upload
*/
public function uploadMultipart(Input $input, string $bucket, string $uri, array $requestHeaders = [], int $chunkSize = 5242880): ?string
{
if ($chunkSize < 5242880)
{
$chunkSize = 5242880;
}
// We need a valid UploadID and PartNumber
$UploadID = $input->getUploadID();
$PartNumber = $input->getPartNumber();
if (empty($UploadID))
{
throw new CannotPutFile(
__METHOD__ . '(): No UploadID specified'
);
}
if (empty($PartNumber))
{
throw new CannotPutFile(
__METHOD__ . '(): No PartNumber specified'
);
}
//$UploadID = urlencode($UploadID);
$PartNumber = (int) $PartNumber;
$request = new Request('PUT', $bucket, $uri, $this->configuration);
$request->setParameter('partNumber', $PartNumber);
$request->setParameter('uploadId', $UploadID);
$request->setInput($input);
// Full data length
$totalSize = $input->getSize();
// No Content-Type for multipart uploads
$input->setType(null);
// Calculate part offset
$partOffset = $chunkSize * ($PartNumber - 1);
if ($partOffset > $totalSize)
{
// This is to signify that we ran out of parts ;)
return null;
}
// How many parts are there?
$totalParts = floor($totalSize / $chunkSize);
if ($totalParts * $chunkSize < $totalSize)
{
$totalParts++;
}
// Calculate Content-Length
$size = $chunkSize;
if ($PartNumber >= $totalParts)
{
$size = $totalSize - ($PartNumber - 1) * $chunkSize;
}
if ($size <= 0)
{
// This is to signify that we ran out of parts ;)
return null;
}
$input->setSize($size);
switch ($input->getInputType())
{
case Input::INPUT_DATA:
$input->setData(substr($input->getData(), ($PartNumber - 1) * $chunkSize, $input->getSize()));
break;
case Input::INPUT_FILE:
case Input::INPUT_RESOURCE:
$fp = $input->getFp();
fseek($fp, ($PartNumber - 1) * $chunkSize);
break;
}
// Custom request headers (Content-Type, Content-Disposition, Content-Encoding)
if (is_array($requestHeaders))
{
foreach ($requestHeaders as $h => $v)
{
if (strtolower(substr($h, 0, 6)) == 'x-amz-')
{
$request->setAmzHeader(strtolower($h), $v);
}
else
{
$request->setHeader($h, $v);
}
}
}
$request->setHeader('Content-Length', $input->getSize());
if ($input->getInputType() === Input::INPUT_DATA)
{
$request->setHeader('Content-Type', "application/x-www-form-urlencoded");
}
$response = $request->getResponse();
if ($response->code !== 200)
{
if (!$response->error->isError())
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if (is_object($response->body) && ($response->body instanceof \SimpleXMLElement) && (strpos($input->getSize(), ',') === false))
{
// For some moronic reason, trying to multipart upload files on some hosts comes back with a crazy
// error from Amazon that we need to set Content-Length:5242880,5242880 instead of
// Content-Length:5242880 which is AGAINST Amazon's documentation. In this case we pass the header
// 'workaround-broken-content-length' and retry. Whatever.
if (isset($response->body->CanonicalRequest))
{
$amazonsCanonicalRequest = (string) $response->body->CanonicalRequest;
$lines = explode("\n", $amazonsCanonicalRequest);
foreach ($lines as $line)
{
if (substr($line, 0, 15) != 'content-length:')
{
continue;
}
[$junk, $stupidAmazonDefinedContentLength] = explode(":", $line);
if (strpos($stupidAmazonDefinedContentLength, ',') !== false)
{
if (!isset($requestHeaders['workaround-broken-content-length']))
{
$requestHeaders['workaround-broken-content-length'] = true;
// This is required to reset the input size to its default value. If you don't do that
// only one part will ever be uploaded. Oops!
$input->setSize(-1);
return $this->uploadMultipart($input, $bucket, $uri, $requestHeaders, $chunkSize);
}
}
}
}
}
throw new CannotPutFile(
sprintf(__METHOD__ . "(): [%s] %s\n\nDebug info:\n%s", $response->error->getCode(), $response->error->getMessage(), print_r($response->body, true))
);
}
// Return the ETag header
return $response->headers['hash'];
}
/**
* Finalizes the multi-part upload. The $input object should contain two keys, etags an array of ETags of the
* uploaded parts and UploadID the multipart upload ID.
*
* @param Input $input The array of input elements
* @param string $bucket The bucket where the object is being stored
* @param string $uri The key (path) to the object
*
* @return void
*/
public function finalizeMultipart(Input $input, string $bucket, string $uri): void
{
$etags = $input->getEtags();
$UploadID = $input->getUploadID();
if (empty($etags))
{
throw new CannotPutFile(
__METHOD__ . '(): No ETags array specified'
);
}
if (empty($UploadID))
{
throw new CannotPutFile(
__METHOD__ . '(): No UploadID specified'
);
}
// Create the message
$message = "\n";
$part = 0;
foreach ($etags as $etag)
{
$part++;
$message .= "\t\n\t\t$part\n\t\t\"$etag\"\n\t\n";
}
$message .= "";
// Get a request query
$reqInput = Input::createFromData($message);
$request = new Request('POST', $bucket, $uri, $this->configuration);
$request->setParameter('uploadId', $UploadID);
$request->setInput($reqInput);
// Do post
$request->setHeader('Content-Type', 'application/xml'); // Even though the Amazon API doc doesn't mention it, it's required... :(
$response = $request->getResponse();
if (!$response->error->isError() && ($response->code != 200))
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
if ($response->error->getCode() == 'RequestTimeout')
{
return;
}
throw new CannotPutFile(
sprintf(__METHOD__ . "(): [%s] %s\n\nDebug info:\n%s", $response->error->getCode(), $response->error->getMessage(), print_r($response->body, true))
);
}
}
/**
* Returns the configuration object
*
* @return Configuration
*/
public function getConfiguration(): Configuration
{
return $this->configuration;
}
private function internalGetBucket(string $bucket, ?string $prefix = null, ?string $marker = null, ?int $maxKeys = null, string $delimiter = '/', bool $returnCommonPrefixes = false): array
{
$request = new Request('GET', $bucket, '', $this->configuration);
if (!empty($prefix))
{
$request->setParameter('prefix', $prefix);
}
if (!empty($marker))
{
$request->setParameter('marker', $marker);
}
if (!empty($maxKeys))
{
$request->setParameter('max-keys', $maxKeys);
}
if (!empty($delimiter))
{
$request->setParameter('delimiter', $delimiter);
}
$response = $request->getResponse();
if (!$response->error->isError() && $response->code !== 200)
{
$response->error = new Error(
$response->code,
"Unexpected HTTP status {$response->code}"
);
}
if ($response->error->isError())
{
throw new CannotGetBucket(
sprintf(__METHOD__ . "(): [%s] %s", $response->error->getCode(), $response->error->getMessage())
);
}
$results = [
'objects' => [],
'nextMarker' => null,
];
if ($response->hasBody() && isset($response->body->Contents))
{
foreach ($response->body->Contents as $c)
{
$results['objects'][(string) $c->Key] = [
'name' => (string) $c->Key,
'time' => strtotime((string) $c->LastModified),
'size' => (int) $c->Size,
'hash' => substr((string) $c->ETag, 1, -1),
];
$results['nextMarker'] = (string) $c->Key;
}
}
if ($returnCommonPrefixes && $response->hasBody() && isset($response->body->CommonPrefixes))
{
foreach ($response->body->CommonPrefixes as $c)
{
$results['objects'][(string) $c->Prefix] = ['prefix' => (string) $c->Prefix];
}
}
if ($response->hasBody() && isset($response->body->IsTruncated) &&
((string) $response->body->IsTruncated == 'false')
)
{
$results['nextMarker'] = null;
return $results;
}
if ($response->hasBody() && isset($response->body->NextMarker))
{
$results['nextMarker'] = (string) $response->body->NextMarker;
}
return $results;
}
}
PK \
X( ( & vendor/akeeba/s3/src/Configuration.phpnu [ setAccess($access);
$this->setSecret($secret);
$this->setSignatureMethod($signatureMethod);
$this->setRegion($region);
}
/**
* Get the Amazon access key
*
* @return string
*/
public function getAccess(): string
{
return $this->access;
}
/**
* Set the Amazon access key
*
* @param string $access The access key to set
*
* @throws Exception\InvalidAccessKey
*/
public function setAccess(string $access): void
{
if (empty($access))
{
throw new Exception\InvalidAccessKey;
}
$this->access = $access;
}
/**
* Get the Amazon secret key
*
* @return string
*/
public function getSecret(): string
{
return $this->secret;
}
/**
* Set the Amazon secret key
*
* @param string $secret The secret key to set
*
* @throws Exception\InvalidSecretKey
*/
public function setSecret(string $secret): void
{
if (empty($secret))
{
throw new Exception\InvalidSecretKey;
}
$this->secret = $secret;
}
/**
* Return the security token. Only for temporary credentials provisioned through an EC2 instance.
*
* @return string
*/
public function getToken(): string
{
return $this->token;
}
/**
* Set the security token. Only for temporary credentials provisioned through an EC2 instance.
*
* @param string $token
*/
public function setToken(string $token): void
{
$this->token = $token;
}
/**
* Get the signature method to use
*
* @return string
*/
public function getSignatureMethod(): string
{
return $this->signatureMethod;
}
/**
* Set the signature method to use
*
* @param string $signatureMethod One of v2 or v4
*
* @throws Exception\InvalidSignatureMethod
*/
public function setSignatureMethod(string $signatureMethod): void
{
$signatureMethod = strtolower($signatureMethod);
$signatureMethod = trim($signatureMethod);
if (!in_array($signatureMethod, ['v2', 'v4']))
{
throw new Exception\InvalidSignatureMethod;
}
$this->signatureMethod = $signatureMethod;
// If you switch to v2 signatures we unset the region.
if ($signatureMethod == 'v2')
{
$this->setRegion('');
/**
* If we are using Amazon S3 proper (not a custom endpoint) we have to set path style access to false.
* Amazon S3 does not support v2 signatures with path style access at all (it returns an error telling
* us to use the virtual hosting endpoint BUCKETNAME.s3.amazonaws.com).
*/
if (strpos($this->endpoint, 'amazonaws.com') !== false)
{
$this->setUseLegacyPathStyle(false);
}
}
}
/**
* Get the Amazon S3 region
*
* @return string
*/
public function getRegion(): string
{
return $this->region;
}
/**
* Set the Amazon S3 region
*
* @param string $region
*/
public function setRegion(string $region): void
{
/**
* You can only leave the region empty if you're using v2 signatures. Anything else gets you an exception.
*/
if (empty($region) && ($this->signatureMethod == 'v4'))
{
throw new Exception\InvalidRegion;
}
/**
* Setting a Chinese-looking region force-changes the endpoint but ONLY if you were using the original Amazon S3
* endpoint. If you're using a custom endpoint and provide a region with 'cn-' in its name we don't override
* your custom endpoint.
*/
if (($this->endpoint == 's3.amazonaws.com') && (substr($region, 0, 3) == 'cn-'))
{
$this->setEndpoint('amazonaws.com.cn');
}
$this->region = $region;
}
/**
* Is the connection to be made over HTTPS?
*
* @return bool
*/
public function isSSL(): bool
{
return $this->useSSL;
}
/**
* Set the connection SSL preference
*
* @param bool $useSSL True to use HTTPS
*/
public function setSSL(bool $useSSL): void
{
$this->useSSL = $useSSL ? true : false;
}
/**
* Get the Amazon S3 endpoint
*
* @return string
*/
public function getEndpoint(): string
{
return $this->endpoint;
}
/**
* Set the Amazon S3 endpoint. Do NOT use a protocol
*
* @param string $endpoint Custom endpoint, e.g. 's3.example.com' or 'www.example.com/s3api'
*/
public function setEndpoint(string $endpoint): void
{
if (stristr($endpoint, '://'))
{
throw new Exception\InvalidEndpoint;
}
/**
* If you set a custom endpoint we have to switch to v2 signatures since our v4 implementation only supports
* Amazon endpoints.
*/
if ((strpos($endpoint, 'amazonaws.com') === false))
{
$this->setSignatureMethod('v2');
}
$this->endpoint = $endpoint;
}
/**
* Should I use legacy, path-style access to the bucket? You should only use it with custom endpoints. Amazon itself
* is currently deprecating support for path-style access but has extended the migration date to an unknown
* time https://aws.amazon.com/blogs/aws/amazon-s3-path-deprecation-plan-the-rest-of-the-story/
*
* @return bool
*/
public function getUseLegacyPathStyle(): bool
{
return $this->useLegacyPathStyle;
}
/**
* Set the flag for using legacy, path-style access to the bucket
*
* @param bool $useLegacyPathStyle
*/
public function setUseLegacyPathStyle(bool $useLegacyPathStyle): void
{
$this->useLegacyPathStyle = $useLegacyPathStyle;
/**
* If we are using Amazon S3 proper (not a custom endpoint) we have to set path style access to false.
* Amazon S3 does not support v2 signatures with path style access at all (it returns an error telling
* us to use the virtual hosting endpoint BUCKETNAME.s3.amazonaws.com).
*/
if ((strpos($this->endpoint, 'amazonaws.com') !== false) && ($this->signatureMethod == 'v2'))
{
$this->useLegacyPathStyle = false;
}
}
/**
* Should we use the dualstack URL (which will ship traffic over ipv6 in most cases). For more information on these
* endpoints please read https://docs.aws.amazon.com/AmazonS3/latest/dev/dual-stack-endpoints.html
*
* @return bool
*/
public function getDualstackUrl(): bool
{
return $this->useDualstackUrl;
}
/**
* Set the flag for using legacy, path-style access to the bucket
*
* @param bool $useDualstackUrl
*/
public function setUseDualstackUrl(bool $useDualstackUrl): void
{
$this->useDualstackUrl = $useDualstackUrl;
}
/**
* Get the flag for using an alternate date format for non-Amazon, S3-compatible services.
*
* @return bool
*/
public function getAlternateDateHeaderFormat(): bool
{
return $this->alternateDateHeaderFormat;
}
/**
* Set the flag for using an alternate date format for non-Amazon, S3-compatible services.
*
* @param bool $alternateDateHeaderFormat
*
* @return void
*/
public function setAlternateDateHeaderFormat(bool $alternateDateHeaderFormat): void
{
$this->alternateDateHeaderFormat = $alternateDateHeaderFormat;
}
/**
* Get the flag indicating whether to use the HTTP Date header
*
* @return bool Flag indicating whether to use the HTTP Date header
*/
public function getUseHTTPDateHeader(): bool
{
return $this->useHTTPDateHeader;
}
/**
* Set the flag indicating whether to use the HTTP Date header.
*
* @param bool $useHTTPDateHeader Whether to use the HTTP Date header
*
* @return void
*/
public function setUseHTTPDateHeader(bool $useHTTPDateHeader): void
{
$this->useHTTPDateHeader = $useHTTPDateHeader;
}
public function getPreSignedBucketInURL(): bool
{
return $this->preSignedBucketInURL;
}
public function setPreSignedBucketInURL(bool $preSignedBucketInURL): void
{
$this->preSignedBucketInURL = $preSignedBucketInURL;
}
}
PK \j. ! vendor/akeeba/s3/src/Response.phpnu [ error = new Error();
}
/**
* Is this an error response?
*
* @return bool
*/
public function isError(): bool
{
return is_null($this->error) || $this->error->isError();
}
/**
* Does this response have a body?
*
* @return bool
*/
public function hasBody(): bool
{
return !empty($this->body);
}
/**
* Get the response error object
*
* @return Error
*/
public function getError(): Error
{
return $this->error;
}
/**
* Set the response error object
*
* @param Error $error
*/
public function setError(Error $error): void
{
$this->error = $error;
}
/**
* Get the response body
*
* If there is no body set up you get NULL.
*
* If the body is binary data (e.g. downloading a file) or other non-XML data you get a string.
*
* If the body was an XML string – the standard Amazon S3 REST API response type – you get a SimpleXMLElement
* object.
*
* @return string|SimpleXMLElement|null
*/
public function getBody()
{
return $this->body;
}
/**
* Set the response body. If it's a string we'll try to parse it as XML.
*
* @param string|SimpleXMLElement|null $body
*/
public function setBody($body, bool $rawResponse = false): void
{
$this->body = null;
if (empty($body))
{
return;
}
$this->body = $body;
$this->finaliseBody($rawResponse);
}
public function resetBody(): void
{
$this->body = null;
}
public function addToBody(string $data): void
{
if (empty($this->body))
{
$this->body = '';
}
$this->body .= $data;
}
public function finaliseBody(bool $rawResponse = false): void
{
if (!$this->hasBody())
{
return;
}
if (!isset($this->headers['type']))
{
$this->headers['type'] = 'text/plain';
}
if (
!$rawResponse
&& is_string($this->body)
&&
(
($this->headers['type'] == 'application/xml')
|| (substr($this->body, 0, 5) == 'body = simplexml_load_string($this->body);
}
if (is_object($this->body) && ($this->body instanceof SimpleXMLElement))
{
$this->parseBody();
}
}
/**
* Returns the status code of the response
*
* @return int
*/
public function getCode(): int
{
return $this->code;
}
/**
* Sets the status code of the response
*
* @param int $code
*/
public function setCode(int $code): void
{
$this->code = $code;
}
/**
* Get the response headers
*
* @return array
*/
public function getHeaders(): array
{
return $this->headers;
}
/**
* Set the response headers
*
* @param array $headers
*/
public function setHeaders(array $headers): void
{
$this->headers = $headers;
}
/**
* Set a single header
*
* @param string $name The header name
* @param string $value The header value
*
* @return void
*/
public function setHeader(string $name, string $value): void
{
$this->headers[$name] = $value;
}
/**
* Does a header by this name exist?
*
* @param string $name The header to look for
*
* @return bool True if it exists
*/
public function hasHeader(string $name): bool
{
return array_key_exists($name, $this->headers);
}
/**
* Unset a response header
*
* @param string $name The header to unset
*
* @return void
*/
public function unsetHeader(string $name): void
{
if ($this->hasHeader($name))
{
unset ($this->headers[$name]);
}
}
/**
* Magic getter for the protected properties
*
* @param string $name
*
* @return mixed
*/
public function __get(string $name)
{
switch ($name)
{
case 'error':
return $this->getError();
break;
case 'body':
return $this->getBody();
break;
case 'code':
return $this->getCode();
break;
case 'headers':
return $this->getHeaders();
break;
}
throw new PropertyNotFound("Property $name not found in " . get_class($this));
}
/**
* Magic setter for the protected properties
*
* @param string $name The name of the property
* @param mixed $value The value of the property
*
* @return void
*/
public function __set(string $name, $value): void
{
switch ($name)
{
case 'error':
$this->setError($value);
break;
case 'body':
$this->setBody($value);
break;
case 'code':
$this->setCode($value);
break;
case 'headers':
$this->setHeaders($value);
break;
default:
throw new PropertyNotFound("Property $name not found in " . get_class($this));
}
}
/**
* Scans the SimpleXMLElement body for errors and propagates them to the Error object
*/
protected function parseBody(): void
{
if (!in_array($this->code, [200, 204]) &&
isset($this->body->Code, $this->body->Message)
)
{
$this->error = new Error(
500,
(string) $this->body->Code . ':' . (string) $this->body->Message
);
if (isset($this->body->Resource))
{
$this->error->setResource((string) $this->body->Resource);
}
}
}
}
PK \S ʃN N vendor/akeeba/s3/src/Request.phpnu [ '',
'Date' => '',
'Content-MD5' => '',
'Content-Type' => '',
];
/**
* Input data for the request
*
* @var Input
*/
private $input = null;
/**
* The file resource we are writing data to
*
* @var resource|null
*/
private $fp = null;
/**
* The Amazon S3 configuration object
*
* @var Configuration
*/
private $configuration = null;
/**
* The response object
*
* @var Response
*/
private $response = null;
/**
* The location of the CA certificate cache. It can be a file or a directory. If it's not specified, the location
* set in AKEEBA_CACERT_PEM will be used
*
* @var string|null
*/
private $caCertLocation = null;
/**
* Constructor
*
* @param string $verb HTTP verb, e.g. 'POST'
* @param string $bucket Bucket name, e.g. 'example-bucket'
* @param string $uri Object URI
* @param Configuration $configuration The Amazon S3 configuration object to use
*
* @return void
*/
function __construct(string $verb, string $bucket, string $uri, Configuration $configuration)
{
$this->verb = $verb;
$this->bucket = $bucket;
$this->uri = '/';
$this->configuration = $configuration;
if (!empty($uri))
{
$this->uri = '/' . str_replace('%2F', '/', rawurlencode($uri));
}
$this->headers['Host'] = $this->getHostName($configuration, $this->bucket);
$this->resource = $this->uri;
if (($this->bucket !== '') && $configuration->getUseLegacyPathStyle())
{
$this->resource = '/' . $this->bucket . $this->uri;
$this->uri = $this->resource;
}
// The date must always be added as a header
$this->headers['Date'] = gmdate('D, d M Y H:i:s O');
// S3-"compatible" services use a different date format. Because why not?
if ($this->configuration->getAlternateDateHeaderFormat() && strpos($this->headers['Host'], '.amazonaws.com') === false)
{
$this->headers['Date'] = gmdate('D, d M Y H:i:s T');
}
// If there is a security token we need to set up the X-Amz-Security-Token header
$token = $this->configuration->getToken();
if (!empty($token))
{
$this->setAmzHeader('x-amz-security-token', $token);
}
// Initialize the response object
$this->response = new Response();
}
/**
* Get the input object
*
* @return Input|null
*/
public function getInput(): ?Input
{
return $this->input;
}
/**
* Set the input object
*
* @param Input $input
*
* @return void
*/
public function setInput(Input $input): void
{
$this->input = $input;
}
/**
* Set a request parameter
*
* @param string $key The parameter name
* @param string|null $value The parameter value
*
* @return void
*/
public function setParameter(string $key, ?string $value): void
{
$this->parameters[$key] = $value;
}
/**
* Set a request header
*
* @param string $key The header name
* @param string $value The header value
*
* @return void
*/
public function setHeader(string $key, string $value): void
{
$this->headers[$key] = $value;
}
/**
* Set an x-amz-meta-* header
*
* @param string $key The header name
* @param string $value The header value
*
* @return void
*/
public function setAmzHeader(string $key, string $value): void
{
$this->amzHeaders[$key] = $value;
}
/**
* Get the HTTP verb of this request
*
* @return string
*/
public function getVerb(): string
{
return $this->verb;
}
/**
* Get the S3 bucket's name
*
* @return string
*/
public function getBucket(): string
{
return $this->bucket;
}
/**
* Get the absolute URI of the resource we're accessing
*
* @return string
*/
public function getResource(): string
{
return $this->resource;
}
/**
* Get the parameters array
*
* @return array
*/
public function getParameters(): array
{
return $this->parameters;
}
/**
* Get the Amazon headers array
*
* @return array
*/
public function getAmzHeaders(): array
{
return $this->amzHeaders;
}
/**
* Get the other headers array
*
* @return array
*/
public function getHeaders(): array
{
return $this->headers;
}
/**
* Get a reference to the Amazon configuration object
*
* @return Configuration
*/
public function getConfiguration(): Configuration
{
return $this->configuration;
}
/**
* Get the file pointer resource (for PUT and POST requests)
*
* @return resource|null
*/
public function &getFp()
{
return $this->fp;
}
/**
* Set the data resource as a file pointer
*
* @param resource $fp
*/
public function setFp($fp): void
{
$this->fp = $fp;
}
/**
* Get the certificate authority location
*
* @return string|null
*/
public function getCaCertLocation(): ?string
{
if (!empty($this->caCertLocation))
{
return $this->caCertLocation;
}
if (defined('AKEEBA_CACERT_PEM'))
{
return AKEEBA_CACERT_PEM;
}
return null;
}
/**
* @param null|string $caCertLocation
*/
public function setCaCertLocation(?string $caCertLocation): void
{
if (empty($caCertLocation))
{
$caCertLocation = null;
}
if (!is_null($caCertLocation) && !is_file($caCertLocation) && !is_dir($caCertLocation))
{
$caCertLocation = null;
}
$this->caCertLocation = $caCertLocation;
}
/**
* Get a pre-signed URL for the request.
*
* Typically used to pre-sign GET requests to objects, i.e. give shareable pre-authorized URLs for downloading
* private or otherwise inaccessible files from S3.
*
* @param int|null $lifetime Lifetime in seconds
* @param bool $https Use HTTPS ($hostBucket should be false for SSL verification)?
*
* @return string The authenticated URL, complete with signature
*/
public function getAuthenticatedURL(?int $lifetime = null, bool $https = false): string
{
$this->processParametersIntoResource();
$signer = Signature::getSignatureObject($this, $this->configuration->getSignatureMethod());
return $signer->getAuthenticatedURL($lifetime, $https);
}
/**
* Get the S3 response
*
* @return Response
*/
public function getResponse(bool $rawResponse = false): Response
{
$this->processParametersIntoResource();
$schema = 'http://';
if ($this->configuration->isSSL())
{
$schema = 'https://';
}
// Very special case. IF the URI ends in /?location AND the region is us-east-1 (Host is
// s3-external-1.amazonaws.com) THEN the host MUST become s3.amazonaws.com for the request to work. This is case
// of us not knowing the region of the bucket, therefore having to use a special endpoint which lets us query
// the region of the bucket without knowing its region. See
// http://stackoverflow.com/questions/27091816/retrieve-buckets-objects-without-knowing-buckets-region-with-aws-s3-rest-api
if ((substr($this->uri, -10) == '/?location') && ($this->headers['Host'] == 's3-external-1.amazonaws.com'))
{
$this->headers['Host'] = 's3.amazonaws.com';
}
$url = $schema . $this->headers['Host'] . $this->uri;
// Basic setup
$curl = curl_init();
curl_setopt($curl, CURLOPT_USERAGENT, 'AkeebaBackupProfessional/S3PostProcessor');
if ($this->configuration->isSSL())
{
// Set the CA certificate cache location
$caCert = $this->getCaCertLocation();
if (!empty($caCert))
{
if (is_dir($caCert))
{
@curl_setopt($curl, CURLOPT_CAPATH, $caCert);
}
else
{
@curl_setopt($curl, CURLOPT_CAINFO, $caCert);
}
}
/**
* Verify the host name in the certificate and the certificate itself.
*
* Caveat: if your bucket contains dots in the name we have to turn off host verification due to the way the
* S3 SSL certificates are set up.
*/
$isAmazonS3 = (substr($this->headers['Host'], -14) == '.amazonaws.com')
|| substr(
$this->headers['Host'], -16
) == 'amazonaws.com.cn';
$tooManyDots = substr_count($this->headers['Host'], '.') > 4;
$verifyHost = ($isAmazonS3 && $tooManyDots) ? 0 : 2;
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, $verifyHost);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, true);
}
curl_setopt($curl, CURLOPT_URL, $url);
/**
* Set the optional x-amz-date header instead of the standard HTTP Date header.
*
* Amazon S3 proper expects to get the date from the Date header. It also allows you to instead use the optional
* X-Amz-Date header as a means to resolve situations where your HTTP library does not let you control the
* standard Date header. In other words, it accepts both, it encourages the standard Date header, but it will
* give priority to the X-Amz-Date header to help you get out of a sticky situation.
*
* Unfortunately, third party services which claim to be "S3-compatible" are written by people with poor reading
* skills or, more likely, under unrealistic time constraints to deliver working code. They are implementing the
* date handling behaviout wrong. Instead of using the Date header unless the X-Amz-Date header is set, they
* **expect** to only ever see the X-Amz-Date header. If it's missing, they do not fall back to the standard
* Date header; they just spit out a message about the signature being wrong. Wasabi and ExoScale are two prime
* examples of that, and only when using v2 signatures.
*
* To avoid this problem, we are now defaulting to always using the X-Amz-Date header everywhere. If you want to
* revert to using the Date header with S3 proper please use setUseHTTPDateHeader(true) to your configuration
* object. In this case DO NOT set the X-Amz-Date header yourself, or you're going to have a *really* bad time.
*/
if (!$this->configuration->getUseHTTPDateHeader())
{
$this->amzHeaders['x-amz-date'] = (new \DateTime($this->headers['Date']))->format('Ymd\THis\Z');
unset ($this->headers['Date']);
}
/**
* Remove empty headers.
*
* While Amazon S3 proper and most third party implementations have no problem with that, there a few of them
* (such as Synology C2) which choke on empty headers.
*/
$this->headers = array_filter($this->headers);
// Get the request signature
$signer = Signature::getSignatureObject($this, $this->configuration->getSignatureMethod());
$signer->preProcessHeaders($this->headers, $this->amzHeaders);
// Headers
$headers = [];
foreach ($this->amzHeaders as $header => $value)
{
if (strlen($value) > 0)
{
$headers[] = $header . ': ' . $value;
}
}
foreach ($this->headers as $header => $value)
{
if (strlen($value) > 0)
{
$headers[] = $header . ': ' . $value;
}
}
$headers[] = 'Authorization: ' . $signer->getAuthorizationHeader();
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, false);
curl_setopt($curl, CURLOPT_WRITEFUNCTION, [$this, '__responseWriteCallback']);
curl_setopt($curl, CURLOPT_HEADERFUNCTION, [$this, '__responseHeaderCallback']);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
// Request types
switch ($this->verb)
{
case 'GET':
break;
case 'PUT':
case 'POST':
if (!is_object($this->input) || !($this->input instanceof Input))
{
$this->input = new Input();
}
$size = $this->input->getSize();
$type = $this->input->getInputType();
if ($type == Input::INPUT_DATA)
{
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $this->verb);
$data = $this->input->getDataReference();
if (strlen($data ?? ''))
{
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
}
if ($size > 0)
{
curl_setopt($curl, CURLOPT_BUFFERSIZE, $size);
}
}
else
{
curl_setopt($curl, CURLOPT_PUT, true);
curl_setopt($curl, CURLOPT_INFILE, $this->input->getFp());
if ($size > 0)
{
curl_setopt($curl, CURLOPT_INFILESIZE, $size);
}
}
break;
case 'HEAD':
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'HEAD');
curl_setopt($curl, CURLOPT_NOBODY, true);
break;
case 'DELETE':
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'DELETE');
break;
default:
break;
}
// Execute, grab errors
$this->response->resetBody();
if (curl_exec($curl))
{
$this->response->code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
}
else
{
$this->response->error = new Error(
curl_errno($curl),
curl_error($curl),
$this->resource
);
}
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
@curl_close($curl);
}
// Set the body data
$this->response->finaliseBody($rawResponse);
// Clean up file resources
if (!is_null($this->fp) && is_resource($this->fp))
{
try
{
@fclose($this->fp);
}
catch (\Throwable $e)
{
}
}
return $this->response;
}
/**
* cURL write callback
*
* @param resource &$curl cURL resource
* @param string &$data Data
*
* @return int Length in bytes
*/
protected function __responseWriteCallback($curl, string $data): int
{
if (in_array($this->response->code, [0, 200, 206]) && !is_null($this->fp) && is_resource($this->fp))
{
return fwrite($this->fp, $data);
}
$this->response->addToBody($data);
return strlen($data);
}
/**
* cURL header callback
*
* @param resource $curl cURL resource
* @param string &$data Data
*
* @return int Length in bytes
*/
protected function __responseHeaderCallback($curl, string $data): int
{
if (($strlen = strlen($data)) <= 2)
{
return $strlen;
}
if (substr($data, 0, 4) == 'HTTP')
{
$this->response->code = (int) substr($data, 9, 3);
return $strlen;
}
// Ignore malformed headers without a value.
if (strpos($data, ':') === false)
{
return $strlen;
}
[$header, $value] = explode(':', trim($data), 2);
$header = trim($header ?? '');
$value = trim($value ?? '');
switch (strtolower($header))
{
case 'last-modified':
$this->response->setHeader('time', strtotime($value));
break;
case 'content-length':
$this->response->setHeader('size', (int) $value);
break;
case 'content-type':
$this->response->setHeader('type', $value);
break;
case 'etag':
$this->response->setHeader('hash', trim($value, '"'));
break;
default:
$this->response->setHeader(strtolower($header), is_numeric($value) ? (int) $value : $value);
if (preg_match('/^x-amz-meta-.*$/', $header))
{
$this->setHeader($header, is_numeric($value) ? (int) $value : $value);
}
break;
}
return $strlen;
}
/**
* Processes $this->parameters as a query string into $this->resource
*
* @return void
*/
private function processParametersIntoResource(): void
{
if (count($this->parameters))
{
$query = substr($this->uri, -1) !== '?' ? '?' : '&';
ksort($this->parameters);
foreach ($this->parameters as $var => $value)
{
if ($value == null || $value == '')
{
$query .= $var . '&';
}
else
{
// Parameters must be URL-encoded
$query .= $var . '=' . rawurlencode($value) . '&';
}
}
$query = substr($query, 0, -1);
$this->uri .= $query;
if (array_key_exists('acl', $this->parameters) || array_key_exists('location', $this->parameters)
|| array_key_exists('torrent', $this->parameters)
|| array_key_exists('logging', $this->parameters)
|| array_key_exists('uploads', $this->parameters)
|| array_key_exists('uploadId', $this->parameters)
|| array_key_exists('partNumber', $this->parameters)
)
{
$this->resource .= $query;
}
}
}
/**
* Get the region-specific hostname for an operation given a configuration and a bucket name. This ensures we can
* always use an HTTPS connection, even with buckets containing dots in their names, without SSL certificate host
* name validation issues.
*
* Please note that this requires the pathStyle flag to be set in Configuration because Amazon RECOMMENDS using the
* virtual-hosted style request where applicable. See http://docs.aws.amazon.com/AmazonS3/latest/API/APIRest.html
* Quoting this documentation:
* "Although the path-style is still supported for legacy applications, we recommend using the virtual-hosted style
* where applicable."
*
* @param Configuration $configuration
* @param string $bucket
*
* @return string
*/
private function getHostName(Configuration $configuration, string $bucket): string
{
// http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
$endpoint = $configuration->getEndpoint();
$region = $configuration->getRegion();
// If it's a bucket in China we need to use a different endpoint
if (($endpoint == 's3.amazonaws.com') && (substr($region, 0, 3) == 'cn-'))
{
$endpoint = 'amazonaws.com.cn';
}
/**
* If there is no bucket we use the default endpoint, whatever it is. For Amazon S3 this format is only used
* when we are making account-level, cross-region requests, e.g. list all buckets. For S3-compatible APIs it
* depends on the API, but generally it's just for listing available buckets.
*/
if (empty($bucket))
{
return $endpoint;
}
/**
* Are we using v2 signatures? In this case we use the endpoint defined by the user without translating it.
*/
if ($configuration->getSignatureMethod() != 'v4')
{
// Legacy path style: the hostname is the endpoint
if ($configuration->getUseLegacyPathStyle())
{
return $endpoint;
}
// Virtual hosting style: the hostname is the bucket, dot and endpoint.
return $bucket . '.' . $endpoint;
}
/**
* Only applies to Amazon S3 proper.
*
* When using the Amazon S3 with the v4 signature API we have to use a different hostname per region. The
* mapping can be found in https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_region
*
* This means changing the endpoint to s3.REGION.amazonaws.com with the following exceptions:
* For China: s3.REGION.amazonaws.com.cn
*
* v4 signing does NOT support non-Amazon endpoints.
*/
if (in_array($endpoint, ['s3.amazonaws.com', 'amazonaws.com.cn']))
{
// Most endpoints: s3-REGION.amazonaws.com
$regionalEndpoint = $region . '.amazonaws.com';
// Exception: China
if (substr($region, 0, 3) == 'cn-')
{
// Chinese endpoint, e.g.: s3.cn-north-1.amazonaws.com.cn
$regionalEndpoint = $regionalEndpoint . '.cn';
}
// If dual-stack URLs are enabled then prepend the endpoint
if ($configuration->getDualstackUrl())
{
$endpoint = 's3.dualstack.' . $regionalEndpoint;
}
else
{
$endpoint = 's3.' . $regionalEndpoint;
}
}
// Legacy path style access: return just the endpoint
if ($configuration->getUseLegacyPathStyle())
{
return $endpoint;
}
// Recommended virtual hosting access: bucket, dot, endpoint.
return $bucket . '.' . $endpoint;
}
}
PK \ׇX
X
% vendor/akeeba/s3/src/StorageClass.phpnu [ StorageClass::STANDARD)
* in the $headers array of Connector::putObject().
*
* Alternatively, run the $headers array through setStorageClass(), e.g.
* $headers = array(); // You can put your stuff here
* StorageClass::setStorageClass($headers, StorageClass::STANDARD);
* $connector->putObject($myInput, 'bucketname', 'path/to/object.dat', Acl::PRIVATE, $headers)
*
* @see https://aws.amazon.com/s3/storage-classes/
*/
class StorageClass
{
/**
* Amazon S3 Standard (S3 Standard)
*/
public const STANDARD = 'STANDARD';
/**
* Reduced redundancy storage
*
* Not recommended anymore. Use INTELLIGENT_TIERING instead.
*/
public const REDUCED_REDUNDANCY = 'REDUCED_REDUNDANCY';
/**
* Amazon S3 Intelligent-Tiering (S3 Intelligent-Tiering)
*/
public const INTELLIGENT_TIERING = 'INTELLIGENT_TIERING';
/**
* Amazon S3 Standard-Infrequent Access (S3 Standard-IA)
*/
public const STANDARD_IA = 'STANDARD_IA';
/**
* Amazon S3 One Zone-Infrequent Access (S3 One Zone-IA)
*/
public const ONEZONE_IA = 'ONEZONE_IA';
/**
* Amazon S3 Glacier (S3 Glacier)
*/
public const GLACIER = 'GLACIER';
/**
* Amazon S3 Glacier Deep Archive (S3 Glacier Deep Archive)
*/
public const DEEP_ARCHIVE = 'DEEP_ARCHIVE';
/**
* Manipulate the $headers array, setting the X-Amz-Storage-Class header for the requested storage class.
*
* This method will automatically remove any previously set X-Amz-Storage-Class header, case-insensitive. The reason
* for that is that Amazon headers **are** case-insensitive and you could easily end up having two separate headers
* with competing storage classes. This would mess up the signature and your request would promptly fail.
*
* @param array $headers
* @param string $storageClass
*
* @return void
*/
public static function setStorageClass(array &$headers, string $storageClass): void
{
// Remove all previously set X-Amz-Storage-Class headers (case-insensitive)
$killList = [];
foreach ($headers as $key => $value)
{
if (strtolower($key) === 'x-amz-storage-class')
{
$killList[] = $key;
}
}
foreach ($killList as $key)
{
unset($headers[$key]);
}
// Add the new X-Amz-Storage-Class header
$headers['X-Amz-Storage-Class'] = $storageClass;
}
}PK \Q! 5 vendor/akeeba/s3/src/Exception/InvalidFilePointer.phpnu [
Order allow,deny
Deny from all
PK \7!ax x 2 vendor/akeeba/s3/src/Exception/CannotGetBucket.phpnu [ request = $request;
}
/**
* Get a signature object for the request
*
* @param Request $request The request which needs signing
* @param string $method The signature method, "v2" or "v4"
*
* @return Signature
*/
public static function getSignatureObject(Request $request, string $method = 'v2'): self
{
$className = __NAMESPACE__ . '\\Signature\\' . ucfirst($method);
return new $className($request);
}
/**
* Returns the authorization header for the request
*
* @return string
*/
abstract public function getAuthorizationHeader(): string;
/**
* Pre-process the request headers before we convert them to cURL-compatible format. Used by signature engines to
* add custom headers, e.g. x-amz-content-sha256
*
* @param array $headers The associative array of headers to process
* @param array $amzHeaders The associative array of amz-* headers to process
*
* @return void
*/
abstract public function preProcessHeaders(array &$headers, array &$amzHeaders): void;
/**
* Get a pre-signed URL for the request. Typically used to pre-sign GET requests to objects, i.e. give shareable
* pre-authorized URLs for downloading files from S3.
*
* @param integer|null $lifetime Lifetime in seconds. NULL for default lifetime.
* @param bool $https Use HTTPS ($hostBucket should be false for SSL verification)?
*
* @return string The authenticated URL, complete with signature
*/
abstract public function getAuthenticatedURL(?int $lifetime = null, bool $https = false): string;
}
PK \; ' vendor/akeeba/s3/src/Response/Error.phpnu [ setCode($code);
$this->setMessage($message);
$this->setResource($resource);
}
/**
* Get the error code
*
* @return int
*/
public function getCode(): int
{
return $this->code;
}
/**
* Set the error code
*
* @param int $code Set to zeroo or a negative value to clear errors
*
* @return void
*/
public function setCode(int $code): void
{
if ($code <= 0)
{
$code = 0;
$this->setMessage('');
$this->setResource('');
}
$this->code = $code;
}
/**
* Get the error message
*
* @return string
*/
public function getMessage(): string
{
return $this->message;
}
/**
* Set the error message
*
* @param string $message The error message to set
*
* @return void
*/
public function setMessage(string $message): void
{
$this->message = $message;
}
/**
* Get the URI of the resource throwing the error
*
* @return string
*/
public function getResource(): string
{
return $this->resource;
}
/**
* Set the URI of the resource throwing the error
*
* @param string $resource
*
* @return void
*/
public function setResource(string $resource): void
{
$this->resource = $resource;
}
/**
* Do we actually have an error?
*
* @return bool
*/
public function isError(): bool
{
return ($this->code > 0) || !empty($this->message);
}
}
PK \Sʉ ' vendor/akeeba/s3/src/Response/.htaccessnu 7m
Order allow,deny
Deny from all
PK \=ݖ.> .> vendor/akeeba/s3/src/Input.phpnu [ setFile($file);
$input->setMd5sum($md5sum);
$input->setSha256($sha256sum);
return $input;
}
/**
* Create an input object from a stream resource / file pointer.
*
* Please note that the contentLength cannot be calculated automatically unless you have a seekable stream resource.
*
* @param resource $resource The file pointer or stream resource
* @param int $contentLength The length of the content in bytes. Set to -1 for auto calculation.
* @param null|string $md5sum The MD5 sum. null to auto calculate, empty string to never calculate.
* @param null|string $sha256sum The SHA256 sum. null to auto calculate.
*
* @return Input
*/
public static function createFromResource(&$resource, int $contentLength, ?string $md5sum = null, ?string $sha256sum = null): self
{
$input = new Input();
$input->setFp($resource);
$input->setSize($contentLength);
$input->setMd5sum($md5sum);
$input->setSha256($sha256sum);
return $input;
}
/**
* Create an input object from raw data.
*
* Please bear in mind that the data is being duplicated in memory. Therefore you'll need at least 2xstrlen($data)
* of free memory when you are using this method. You can instantiate an object and use assignData to work around
* this limitation when handling large amounts of data which may cause memory outages (typically: over 10Mb).
*
* @param string $data The data to use.
* @param null|string $md5sum The MD5 sum. null to auto calculate, empty string to never calculate.
* @param null|string $sha256sum The SHA256 sum. null to auto calculate.
*
* @return Input
*/
public static function createFromData(string &$data, ?string $md5sum = null, ?string $sha256sum = null): self
{
$input = new Input();
$input->setData($data);
$input->setMd5sum($md5sum);
$input->setSha256($sha256sum);
return $input;
}
/**
* Destructor.
*/
function __destruct()
{
if (is_resource($this->fp))
{
try
{
@fclose($this->fp);
}
catch (\Throwable $e)
{
}
}
}
/**
* Returns the input type (resource, file or data)
*
* @return int
*/
public function getInputType(): int
{
if (!empty($this->file))
{
return self::INPUT_FILE;
}
if (!empty($this->fp))
{
return self::INPUT_RESOURCE;
}
return self::INPUT_DATA;
}
/**
* Return the file pointer to the data, or null if this is not a resource input
*
* @return resource|null
*/
public function getFp()
{
if (!is_resource($this->fp))
{
return null;
}
return $this->fp;
}
/**
* Set the file pointer (or, generally, stream resource)
*
* @param resource $fp
*/
public function setFp($fp): void
{
if (!is_resource($fp))
{
throw new Exception\InvalidFilePointer('$fp is not a file resource');
}
$this->fp = $fp;
}
/**
* Get the absolute path to the input file, or null if this is not a file input
*
* @return string|null
*/
public function getFile(): ?string
{
if (empty($this->file))
{
return null;
}
return $this->file;
}
/**
* Set the absolute path to the input file
*
* @param string $file
*/
public function setFile(string $file): void
{
$this->file = $file;
$this->data = null;
if (is_resource($this->fp))
{
try
{
@fclose($this->fp);
}
catch (\Throwable $e)
{
}
}
$this->fp = @fopen($file, 'r');
if ($this->fp === false)
{
throw new Exception\CannotOpenFileForRead($file);
}
}
/**
* Return the raw input data, or null if this is a file or stream input
*
* @return string|null
*/
public function getData(): ?string
{
if (empty($this->data) && ($this->getInputType() != self::INPUT_DATA))
{
return null;
}
return $this->data;
}
/**
* Set the raw input data
*
* @param string $data
*/
public function setData(string $data): void
{
$this->data = $data;
if (is_resource($this->fp))
{
try
{
@fclose($this->fp);
}
catch (\Throwable $e)
{
}
}
$this->file = null;
$this->fp = null;
}
/**
* Return a reference to the raw input data
*
* @return string|null
*/
public function &getDataReference(): ?string
{
if (empty($this->data) && ($this->getInputType() != self::INPUT_DATA))
{
$this->data = null;
}
return $this->data;
}
/**
* Set the raw input data by doing an assignment instead of memory copy. While this conserves memory you cannot use
* this with hardcoded strings, method results etc without going through a variable first.
*
* @param string $data
*/
public function assignData(string &$data): void
{
$this->data = $data;
if (is_resource($this->fp))
{
try
{
@fclose($this->fp);
}
catch (\Throwable $e)
{
}
}
$this->file = null;
$this->fp = null;
}
/**
* Returns the size of the data to be uploaded, in bytes. If it's not already specified it will try to guess.
*
* @return int
*/
public function getSize(): int
{
if ($this->size < 0)
{
$this->size = $this->getInputSize();
}
return $this->size;
}
/**
* Set the size of the data to be uploaded.
*
* @param int $size
*/
public function setSize(int $size)
{
$this->size = $size;
}
/**
* Get the MIME type of the data
*
* @return string|null
*/
public function getType(): ?string
{
if (empty($this->type))
{
$this->type = 'application/octet-stream';
if ($this->getInputType() == self::INPUT_FILE)
{
$this->type = $this->getMimeType($this->file);
}
}
return $this->type;
}
/**
* Set the MIME type of the data
*
* @param string|null $type
*/
public function setType(?string $type)
{
$this->type = $type;
}
/**
* Get the MD5 sum of the content
*
* @return null|string
*/
public function getMd5sum(): ?string
{
if ($this->md5sum === '')
{
return null;
}
if (is_null($this->md5sum))
{
$this->md5sum = $this->calculateMd5();
}
return $this->md5sum;
}
/**
* Set the MD5 sum of the content as a base64 encoded string of the raw MD5 binary value.
*
* WARNING: Do not set a binary MD5 sum or a hex-encoded MD5 sum, it will result in an invalid signature error!
*
* Set to null to automatically calculate it from the raw data. Set to an empty string to force it to never be
* calculated and no value for it set either.
*
* @param string|null $md5sum
*/
public function setMd5sum(?string $md5sum): void
{
$this->md5sum = $md5sum;
}
/**
* Get the SHA-256 hash of the content
*
* @return string
*/
public function getSha256(): string
{
if (empty($this->sha256))
{
$this->sha256 = $this->calculateSha256();
}
return $this->sha256;
}
/**
* Set the SHA-256 sum of the content. It must be a lowercase hexadecimal encoded string.
*
* Set to null to automatically calculate it from the raw data.
*
* @param string|null $sha256
*/
public function setSha256(?string $sha256): void
{
$this->sha256 = is_null($sha256) ? null : strtolower($sha256);
}
/**
* Get the Upload Session ID for multipart uploads
*
* @return string|null
*/
public function getUploadID(): ?string
{
return $this->UploadID;
}
/**
* Set the Upload Session ID for multipart uploads
*
* @param string|null $UploadID
*/
public function setUploadID(?string $UploadID): void
{
$this->UploadID = $UploadID;
}
/**
* Get the part number for multipart uploads.
*
* Returns null if the part number has not been set yet.
*
* @return int|null
*/
public function getPartNumber(): ?int
{
return $this->PartNumber;
}
/**
* Set the part number for multipart uploads
*
* @param int $PartNumber
*/
public function setPartNumber(int $PartNumber): void
{
// Clamp the part number to integers greater than zero.
$this->PartNumber = max(1, (int) $PartNumber);
}
/**
* Get the list of ETags for multipart uploads
*
* @return string[]
*/
public function getEtags(): array
{
return $this->etags;
}
/**
* Set the list of ETags for multipart uploads
*
* @param string[] $etags
*/
public function setEtags(array $etags): void
{
$this->etags = $etags;
}
/**
* Calculates the upload size from the input source. For data it's the entire raw string length. For a file resource
* it's the entire file's length. For seekable stream resources it's the remaining data from the current seek
* position to EOF.
*
* WARNING: You should never try to specify files or resources over 2Gb minus 1 byte otherwise 32-bit versions of
* PHP (anything except Linux x64 builds) will fail in unpredictable ways: the internal int representation in PHP
* depends on the target platform and is typically a signed 32-bit integer.
*
* @return int
*/
private function getInputSize(): int
{
switch ($this->getInputType())
{
case self::INPUT_DATA:
return function_exists('mb_strlen') ? mb_strlen($this->data ?? '', '8bit') : strlen($this->data ?? '');
break;
case self::INPUT_FILE:
clearstatcache(true, $this->file);
$filesize = @filesize($this->file);
return ($filesize === false) ? 0 : $filesize;
break;
case self::INPUT_RESOURCE:
$meta = stream_get_meta_data($this->fp);
if ($meta['seekable'])
{
$pos = ftell($this->fp);
$endPos = fseek($this->fp, 0, SEEK_END);
fseek($this->fp, $pos, SEEK_SET);
return $endPos - $pos + 1;
}
break;
}
return 0;
}
/**
* Get the MIME type of a file
*
* @param string $file The absolute path to the file for which we want to get the MIME type
*
* @return string The MIME type of the file
*/
private function getMimeType(string $file): string
{
$type = false;
// Fileinfo documentation says fileinfo_open() will use the
// MAGIC env var for the magic file
if (extension_loaded('fileinfo') && isset($_ENV['MAGIC']) &&
($finfo = finfo_open(FILEINFO_MIME, $_ENV['MAGIC'])) !== false
)
{
if (($type = finfo_file($finfo, $file)) !== false)
{
// Remove the charset and grab the last content-type
$type = explode(' ', str_replace('; charset=', ';charset=', $type));
$type = array_pop($type);
$type = explode(';', $type);
$type = trim(array_shift($type));
}
finfo_close($finfo);
}
elseif (function_exists('mime_content_type'))
{
$type = trim(mime_content_type($file));
}
if ($type !== false && strlen($type) > 0)
{
return $type;
}
// Otherwise do it the old fashioned way
static $exts = [
'jpg' => 'image/jpeg',
'gif' => 'image/gif',
'png' => 'image/png',
'tif' => 'image/tiff',
'tiff' => 'image/tiff',
'ico' => 'image/x-icon',
'swf' => 'application/x-shockwave-flash',
'pdf' => 'application/pdf',
'zip' => 'application/zip',
'gz' => 'application/x-gzip',
'tar' => 'application/x-tar',
'bz' => 'application/x-bzip',
'bz2' => 'application/x-bzip2',
'txt' => 'text/plain',
'asc' => 'text/plain',
'htm' => 'text/html',
'html' => 'text/html',
'css' => 'text/css',
'js' => 'text/javascript',
'xml' => 'text/xml',
'xsl' => 'application/xsl+xml',
'ogg' => 'application/ogg',
'mp3' => 'audio/mpeg',
'wav' => 'audio/x-wav',
'avi' => 'video/x-msvideo',
'mpg' => 'video/mpeg',
'mpeg' => 'video/mpeg',
'mov' => 'video/quicktime',
'flv' => 'video/x-flv',
'php' => 'text/x-php',
];
$ext = strtolower(pathInfo($file, PATHINFO_EXTENSION));
return $exts[$ext] ?? 'application/octet-stream';
}
/**
* Calculate the MD5 sum of the input data
*
* @return string Base-64 encoded MD5 sum
*/
private function calculateMd5(): string
{
switch ($this->getInputType())
{
case self::INPUT_DATA:
return base64_encode(
function_exists('hash')
? hash('md5', $this->data, true)
: md5($this->data, true)
);
break;
case self::INPUT_FILE:
return base64_encode(
function_exists('hash_file')
? hash_file('md5', $this->file, true)
: md5_file($this->file, true)
);
break;
case self::INPUT_RESOURCE:
$ctx = hash_init('md5');
$pos = ftell($this->fp);
$size = $this->getSize();
$done = 0;
$batch = min(1048576, $size);
while ($done < $size)
{
$toRead = min($batch, $done - $size);
$data = @fread($this->fp, $toRead);
hash_update($ctx, $data);
unset($data);
}
fseek($this->fp, $pos, SEEK_SET);
return base64_encode(hash_final($ctx, true));
break;
}
return '';
}
/**
* Calcualte the SHA256 data of the input data
*
* @return string Lowercase hex representation of the SHA-256 sum
*/
private function calculateSha256(): string
{
$inputType = $this->getInputType();
switch ($inputType)
{
case self::INPUT_DATA:
return hash('sha256', $this->data, false);
break;
case self::INPUT_FILE:
case self::INPUT_RESOURCE:
if ($inputType == self::INPUT_FILE)
{
$filesize = @filesize($this->file);
$fPos = @ftell($this->fp);
if (($filesize == $this->getSize()) && ($fPos === 0))
{
return hash_file('sha256', $this->file, false);
}
}
$ctx = hash_init('sha256');
$pos = ftell($this->fp);
$size = $this->getSize();
$done = 0;
$batch = min(1048576, $size);
while ($done < $size)
{
$toRead = min($batch, $size - $done);
$data = @fread($this->fp, $toRead);
$done += $toRead;
hash_update($ctx, $data);
unset($data);
}
fseek($this->fp, $pos, SEEK_SET);
return hash_final($ctx, false);
break;
}
return '';
}
}
PK \Sʉ vendor/akeeba/s3/src/.htaccessnu 7m
Order allow,deny
Deny from all
PK \`ܢkF kF % vendor/akeeba/s3/src/Signature/V4.phpnu [ request->getInput();
if (is_object($input))
{
$requestPayloadHash = $input->getSha256();
}
else
{
$requestPayloadHash = hash('sha256', '', false);
}
$amzHeaders['x-amz-content-sha256'] = $requestPayloadHash;
}
/**
* Get a pre-signed URL for the request. Typically used to pre-sign GET requests to objects, i.e. give shareable
* pre-authorized URLs for downloading files from S3.
*
* @param integer|null $lifetime Lifetime in seconds. NULL for default lifetime.
* @param bool $https Use HTTPS ($hostBucket should be false for SSL verification)?
*
* @return string The presigned URL
*/
public function getAuthenticatedURL(?int $lifetime = null, bool $https = false): string
{
// Set the Expires header
if (is_null($lifetime))
{
$lifetime = 10;
}
/**
* Authenticated URLs must always go through the generic regional endpoint, not the virtual hosting-style domain
* name. This means that if you have a bucket "example" in the EU West 1 (Ireland) region we have to go through
* http://s3-eu-west-1.amazonaws.com/example instead of http://example.amazonaws.com/ for all authenticated URLs
*/
$region = $this->request->getConfiguration()->getRegion();
$bucket = $this->request->getBucket();
$hostname = $this->getPresignedHostnameForRegion($region);
if (!$this->request->getConfiguration()->getPreSignedBucketInURL() && $this->isValidBucketName($bucket))
{
$hostname = $bucket . '.' . $hostname;
}
$this->request->setHeader('Host', $hostname);
// Set the expiration time in seconds
$this->request->setHeader('Expires', (int) $lifetime);
// Get the query parameters, including the calculated signature
$uri = $this->request->getResource();
$headers = $this->request->getHeaders();
$protocol = $https ? 'https' : 'http';
$serialisedParams = $this->getAuthorizationHeader();
// The query parameters are returned serialized; unserialize them, then build and return the URL.
$queryParameters = unserialize($serialisedParams);
// This should be toggleable
if (
!$this->request->getConfiguration()->getPreSignedBucketInURL()
&& $this->isValidBucketName($bucket)
&& strpos($uri, '/' . $bucket) === 0)
{
$uri = substr($uri, strlen($bucket) + 1);
}
$query = http_build_query($queryParameters);
$url = $protocol . '://' . $headers['Host'] . $uri;
$url .= (strpos($uri, '?') !== false) ? '&' : '?';
$url .= $query;
return $url;
}
/**
* Returns the authorization header for the request
*
* @return string
*/
public function getAuthorizationHeader(): string
{
$verb = strtoupper($this->request->getVerb());
$resourcePath = $this->request->getResource();
$headers = $this->request->getHeaders();
$amzHeaders = $this->request->getAmzHeaders();
$parameters = $this->request->getParameters();
$bucket = $this->request->getBucket();
$isPresignedURL = false;
// See the Connector class for the explanation behind this ugly workaround
$amazonIsBraindead = isset($headers['workaround-braindead-error-from-amazon']);
if ($amazonIsBraindead)
{
unset ($headers['workaround-braindead-error-from-amazon']);
}
// Get the credentials scope
$signatureDate = new DateTime($headers['Date'] ?? $amzHeaders['x-amz-date']);
$credentialScope = $signatureDate->format('Ymd') . '/' .
$this->request->getConfiguration()->getRegion() . '/' .
's3/aws4_request';
/**
* If the Expires header is set up we're pre-signing a download URL. The string to sign is a bit
* different in this case and we have to pass certain headers as query string parameters.
*
* @see http://docs.aws.amazon.com/general/latest/gr/sigv4-create-string-to-sign.html
*/
if (isset($headers['Expires']))
{
$gmtDate = clone $signatureDate;
$gmtDate->setTimezone(new \DateTimeZone('GMT'));
$parameters['X-Amz-Algorithm'] = "AWS4-HMAC-SHA256";
$parameters['X-Amz-Credential'] = $this->request->getConfiguration()->getAccess() . '/' . $credentialScope;
$parameters['X-Amz-Date'] = $gmtDate->format('Ymd\THis\Z');
$parameters['X-Amz-Expires'] = sprintf('%u', $headers['Expires']);
$token = $this->request->getConfiguration()->getToken();
if (!empty($token))
{
$parameters['x-amz-security-token'] = $token;
}
unset($headers['Expires']);
unset($headers['Date']);
unset($headers['Content-MD5']);
unset($headers['Content-Type']);
$isPresignedURL = true;
}
// ========== Step 1: Create a canonical request ==========
// See http://docs.aws.amazon.com/general/latest/gr/sigv4-create-canonical-request.html
$canonicalHeaders = "";
$signedHeadersArray = [];
// Calculate the canonical headers and the signed headers
if ($isPresignedURL)
{
// Presigned URLs use UNSIGNED-PAYLOAD instead
unset($amzHeaders['x-amz-content-sha256']);
}
$allHeaders = array_merge($headers, $amzHeaders);
ksort($allHeaders);
foreach ($allHeaders as $k => $v)
{
$lowercaseHeaderName = strtolower($k);
if ($amazonIsBraindead && ($lowercaseHeaderName == 'content-length'))
{
/**
* I know it looks crazy. It is. Somehow Amazon requires me to do this and only on _some_ servers, mind
* you. This is something undocumented and which is not covered by their official SDK. I had to write
* my own library because of that and the official SDK's inability to upload large files without using
* at least as much memory as the file itself (which doesn't fly well for files around 2Gb, let me tell
* you that!).
*/
$v = "$v,$v";
}
$canonicalHeaders .= $lowercaseHeaderName . ':' . trim($v) . "\n";
$signedHeadersArray[] = $lowercaseHeaderName;
}
$signedHeaders = implode(';', $signedHeadersArray);
if ($isPresignedURL)
{
$parameters['X-Amz-SignedHeaders'] = $signedHeaders;
}
// The canonical URI is the resource path
$canonicalURI = $resourcePath;
$bucketResource = '/' . $bucket . '/';
$regionalHostname = ($headers['Host'] != 's3.amazonaws.com')
&& ($headers['Host'] != $bucket . '.s3.amazonaws.com');
/**
* Yet another special case for third party, S3-compatible services, when using pre-signed URLs.
*
* Given a bucket `example` and filepath `foo/bar.txt` the canonical URI to sign is supposed to be
* /example/foo/bar.txt regardless of whether we are using path style or subdomain hosting style access to the
* bucket.
*
* When calculating a pre-signed URL, the URL we will be accessing will be something to the tune of
* example.endpoint.com/foo/bar.txt. Amazon S3 proper allows us to use EITHER the nominal canonical URI
* /foo/bar.txt OR the /example/foo/bar.txt canonical URI for consistency. Some third party providers, like
* Wasabi, will choke on the former and complain about the signature being invalid.
*
* To address this issue we check if all the following conditions are met:
* - We are calculating a signature for a pre-signed URL.
* - The service is NOT Amazon S3 proper.
* - The domain name starts with the bucket name.
* In this case, and this case only, we set $regionalHostname to false. This triggers an if-block further down
* which strips the `/bucketName/` prefix from the canonical URI, converting it to `/`. Therefore, the canonical
* URI in the signature becomes the nominal URI we will be accessing in the bucket, solving the problem with
* those third party services.
*/
// Figuring out whether it's a regional hostname DOES NOT work above if it's not AWS S3 proper. Let's fix that.
if ($isPresignedURL && strpos($headers['Host'], 'amazonaws.com') === false && !strpos($headers['Host'], $bucket . '.'))
{
$regionalHostname = false;
}
// Special case: if the canonical URI ends in /?location the bucket name DOES count as part of the canonical URL
// even though the Host is s3.amazonaws.com (in which case it normally shouldn't count). Yeah, I know, it makes
// no sense!!!
if (!$regionalHostname && ($headers['Host'] == 's3.amazonaws.com')
&& (substr($canonicalURI, -10) == '/?location'))
{
$regionalHostname = true;
}
if (!$regionalHostname && (strpos($canonicalURI, $bucketResource) === 0 || strpos($canonicalURI, substr($bucketResource, 0, -1)) === 0))
{
if ($canonicalURI === substr($bucketResource, 0, -1))
{
$canonicalURI = '/';
}
else
{
$canonicalURI = substr($canonicalURI, strlen($bucketResource) - 1);
}
}
// If the resource path has a query yank it and parse it into the parameters array
$questionMarkPos = strpos($canonicalURI, '?');
if ($questionMarkPos !== false)
{
$canonicalURI = substr($canonicalURI, 0, $questionMarkPos);
$queryString = @substr($canonicalURI, $questionMarkPos + 1);
@parse_str($queryString, $extraQuery);
if (count($extraQuery))
{
$parameters = array_merge($parameters, $extraQuery);
}
}
// The canonical query string is the string representation of $parameters, alpha sorted by key
ksort($parameters);
// We build the query the hard way because http_build_query in PHP 5.3 does NOT have the fourth parameter
// (encoding type), defaulting to RFC 1738 encoding whereas S3 expects RFC 3986 encoding
$canonicalQueryString = '';
if (!empty($parameters))
{
$temp = [];
foreach ($parameters as $k => $v)
{
$temp[] = $this->urlencode($k) . '=' . $this->urlencode($v);
}
$canonicalQueryString = implode('&', $temp);
}
// Get the payload hash
$requestPayloadHash = 'UNSIGNED-PAYLOAD';
if (isset($amzHeaders['x-amz-content-sha256']))
{
$requestPayloadHash = $amzHeaders['x-amz-content-sha256'];
}
// Calculate the canonical request
$canonicalRequest = $verb . "\n" .
$canonicalURI . "\n" .
$canonicalQueryString . "\n" .
$canonicalHeaders . "\n" .
$signedHeaders . "\n" .
$requestPayloadHash;
$hashedCanonicalRequest = hash('sha256', $canonicalRequest);
// ========== Step 2: Create a string to sign ==========
// See http://docs.aws.amazon.com/general/latest/gr/sigv4-create-string-to-sign.html
if (!isset($headers['Date']))
{
$headers['Date'] = '';
}
/**
* The Date in the String-to-Sign is a messy situation.
*
* Amazon's documentation says it must be in ISO 8601 format: `Ymd\THis\Z`. Unfortunately, Amazon's
* documentation is actually wrong :troll_face: The actual Amazon S3 service expects the date to be formatted as
* per RFC1123.
*
* Most third party implementations have caught up to the fact that Amazon has documented the v4 signatures
* wrongly (naughty AWS!) and accept either format.
*
* Some other third party implementations, which never bothered to validate their implementations against Amazon
* S3 proper, only expect what Amazon has documented as "ISO 8601". Therefore, we detect third party services
* and switch to the as-documented date format.
*
* Some other third party services, like Wasabi, are broken in yet a different way. They will only use the date
* from the x-amz-date header, WITHOUT falling back to the Date header if the former is not present. This is
* the opposite of Amazon S3 proper which does expect the Date header. That's why the Request class sets both
* headers if the request is made to a service _other_ than Amazon S3 proper.
*/
$dateToSignFor = strpos($headers['Host'], '.amazonaws.com') !== false
? (($headers['Date'] ?? null) ?: ($amzHeaders['x-amz-date'] ?? null) ?: $signatureDate->format('Ymd\THis\Z'))
: $signatureDate->format('Ymd\THis\Z');
$stringToSign = "AWS4-HMAC-SHA256\n" .
$dateToSignFor . "\n" .
$credentialScope . "\n" .
$hashedCanonicalRequest;
if ($isPresignedURL)
{
$stringToSign = "AWS4-HMAC-SHA256\n" .
$parameters['X-Amz-Date'] . "\n" .
$credentialScope . "\n" .
$hashedCanonicalRequest;
}
// ========== Step 3: Calculate the signature ==========
// See http://docs.aws.amazon.com/general/latest/gr/sigv4-calculate-signature.html
$kSigning = $this->getSigningKey($signatureDate);
$signature = hash_hmac('sha256', $stringToSign, $kSigning, false);
// ========== Step 4: Add the signing information to the Request ==========
// See http://docs.aws.amazon.com/general/latest/gr/sigv4-add-signature-to-request.html
$authorization = 'AWS4-HMAC-SHA256 Credential=' .
$this->request->getConfiguration()->getAccess() . '/' . $credentialScope . ', ' .
'SignedHeaders=' . $signedHeaders . ', ' .
'Signature=' . $signature;
// For presigned URLs we only return the Base64-encoded signature without the AWS format specifier and the
// public access key.
if ($isPresignedURL)
{
$parameters['X-Amz-Signature'] = $signature;
return serialize($parameters);
}
return $authorization;
}
/**
* Calculate the AWS4 signing key
*
* @param DateTime $signatureDate The date the signing key is good for
*
* @return string
*/
private function getSigningKey(DateTime $signatureDate): string
{
$kSecret = $this->request->getConfiguration()->getSecret();
$kDate = hash_hmac('sha256', $signatureDate->format('Ymd'), 'AWS4' . $kSecret, true);
$kRegion = hash_hmac('sha256', $this->request->getConfiguration()->getRegion(), $kDate, true);
$kService = hash_hmac('sha256', 's3', $kRegion, true);
$kSigning = hash_hmac('sha256', 'aws4_request', $kService, true);
return $kSigning;
}
private function urlencode(?string $toEncode): string
{
return empty($toEncode) ? '' : rawurlencode($toEncode);
}
/**
* Get the correct hostname for the given AWS region
*
* @param string $region
*
* @return string
*/
private function getPresignedHostnameForRegion(string $region): string
{
$config = $this->request->getConfiguration();
$endpoint = $config->getEndpoint();
if (empty($endpoint))
{
$endpoint = 's3.' . $region . '.amazonaws.com';
}
// As of October 2023, AWS does not consider DualStack signed URLs as valid. Whatever.
$dualstackEnabled = false && $this->request->getConfiguration()->getDualstackUrl();
// If dual-stack URLs are enabled then prepend the endpoint
if ($dualstackEnabled)
{
$endpoint = 's3.dualstack.' . $region . '.amazonaws.com';
}
if ($region == 'cn-north-1')
{
return $endpoint . '.cn';
}
return $endpoint;
}
/**
* Is this a valid bucket name?
*
* @param string $bucketName The bucket name to check
* @param bool $asSubdomain Should I put additional restrictions for use as a subdomain?
*
* @return bool
* @since 2.3.1
*
* @see https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html
*/
private function isValidBucketName(string $bucketName, bool $asSubdomain = true): bool
{
/**
* If there are dots in the bucket name I can't use it as a subdomain.
*
* "If you include dots in a bucket's name, you can't use virtual-host-style addressing over HTTPS, unless you
* perform your own certificate validation. This is because the security certificates used for virtual hosting
* of buckets don't work for buckets with dots in their names."
*/
if ($asSubdomain && strpos($bucketName, '.') !== false)
{
return false;
}
/**
* - Bucket names must be between 3 (min) and 63 (max) characters long.
* - Bucket names can consist only of lowercase letters, numbers, dots (.), and hyphens (-).
*/
if (!preg_match('/^[a-z0-9\-.]{3,63}$/', $bucketName))
{
return false;
}
// Bucket names must begin and end with a letter or number.
if (!preg_match('/^[a-z0-9].*[a-z0-9]$/', $bucketName))
{
return false;
}
// Bucket names must not contain two adjacent periods.
if (preg_match('/\.\./', $bucketName))
{
return false;
}
// Bucket names must not be formatted as an IP address (for example, 192.168.5.4).
if (preg_match('/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/', $bucketName))
{
return false;
}
// Bucket names must not start with the prefix xn--.
if (strpos($bucketName, 'xn--') === 0)
{
return false;
}
// Bucket names must not start with the prefix sthree- and the prefix sthree-configurator.
if (strpos($bucketName, 'sthree-') === 0)
{
return false;
}
// Bucket names must not end with the suffix -s3alias.
if (substr($bucketName, -8) === '-s3alias')
{
return false;
}
// Bucket names must not end with the suffix --ol-s3.
if (substr($bucketName, -7) === '--ol-s3')
{
return false;
}
return true;
}
}
PK \dž!P P % vendor/akeeba/s3/src/Signature/V2.phpnu [ request->setHeader('Expires', $expires);
$bucket = $this->request->getBucket();
$uri = $this->request->getResource();
$headers = $this->request->getHeaders();
$accessKey = $this->request->getConfiguration()->getAccess();
$protocol = $https ? 'https' : 'http';
$signature = $this->getAuthorizationHeader();
$search = '/' . $bucket;
// This does not look right... The bucket name must be included in the URL.
// if (strpos($uri, $search) === 0)
// {
// $uri = substr($uri, strlen($search));
// }
$queryParameters = array_merge($this->request->getParameters(), [
'AWSAccessKeyId' => $accessKey,
'Expires' => sprintf('%u', $expires),
'Signature' => $signature,
]);
$query = http_build_query($queryParameters);
// fix authenticated url for Google Cloud Storage - https://cloud.google.com/storage/docs/access-control/create-signed-urls-program
if ($this->request->getConfiguration()->getEndpoint() === "storage.googleapis.com")
{
// replace host with endpoint
$headers['Host'] = 'storage.googleapis.com';
// replace "AWSAccessKeyId" with "GoogleAccessId"
$query = str_replace('AWSAccessKeyId', 'GoogleAccessId', $query);
// add bucket to url
$uri = '/' . $bucket . $uri;
}
$url = $protocol . '://' . $headers['Host'] . $uri;
$url .= (strpos($uri, '?') !== false) ? '&' : '?';
$url .= $query;
return $url;
}
/**
* Returns the authorization header for the request
*
* @return string
*/
public function getAuthorizationHeader(): string
{
$verb = strtoupper($this->request->getVerb());
$resourcePath = $this->request->getResource();
$headers = $this->request->getHeaders();
$amzHeaders = $this->request->getAmzHeaders();
$parameters = $this->request->getParameters();
$bucket = $this->request->getBucket();
$isPresignedURL = false;
$amz = [];
$amzString = '';
// Collect AMZ headers for signature
foreach ($amzHeaders as $header => $value)
{
if (strlen($value) > 0)
{
$amz[] = strtolower($header) . ':' . $value;
}
}
// AMZ headers must be sorted and sent as separate lines
if (count($amz) > 0)
{
sort($amz);
$amzString = "\n" . implode("\n", $amz);
}
// If the Expires query string parameter is set up we're pre-signing a download URL. The string to sign is a bit
// different in this case; it does not include the Date, it includes the Expires.
// See http://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html#RESTAuthenticationQueryStringAuth
if (isset($headers['Expires']))
{
if (isset($headers['Date']))
{
$headers['Date'] = $headers['Expires'];
}
else
{
$amzHeaders['x-amz-date'] = $headers['Expires'];
}
unset ($headers['Expires']);
$isPresignedURL = true;
}
/**
* The resource path in S3 V2 signatures must ALWAYS contain the bucket name if a bucket is defined, even if we
* are not using path-style access to the resource
*/
if (!empty($bucket) && !$this->request->getConfiguration()->getUseLegacyPathStyle())
{
$resourcePath = '/' . $bucket . $resourcePath;
}
$stringToSign = $verb . "\n" .
($headers['Content-MD5'] ?? '') . "\n" .
($headers['Content-Type'] ?? '') . "\n" .
($headers['Date'] ?? '') .
$amzString . "\n" .
$resourcePath;
// CloudFront only requires a date to be signed
if ($headers['Host'] == 'cloudfront.amazonaws.com')
{
$stringToSign = $headers['Date'] ?? $amzHeaders['x-amz-date'] ?? '';
}
$amazonV2Hash = $this->amazonV2Hash($stringToSign);
// For presigned URLs we only return the Base64-encoded signature without the AWS format specifier and the
// public access key.
if ($isPresignedURL)
{
return $amazonV2Hash;
}
return 'AWS ' .
$this->request->getConfiguration()->getAccess() . ':' .
$amazonV2Hash;
}
/**
* Creates a HMAC-SHA1 hash. Uses the hash extension if present, otherwise falls back to slower, manual calculation.
*
* @param string $stringToSign String to sign
*
* @return string
*/
private function amazonV2Hash(string $stringToSign): string
{
$secret = $this->request->getConfiguration()->getSecret();
if (extension_loaded('hash'))
{
$raw = hash_hmac('sha1', $stringToSign, $secret, true);
return base64_encode($raw);
}
$raw = pack('H*', sha1(
(str_pad($secret, 64, chr(0x00)) ^ (str_repeat(chr(0x5c), 64))) .
pack('H*', sha1(
(str_pad($secret, 64, chr(0x00)) ^ (str_repeat(chr(0x36), 64))) . $stringToSign
)
)
)
);
return base64_encode($raw);
}
}
PK \Sʉ ( vendor/akeeba/s3/src/Signature/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ vendor/akeeba/s3/.htaccessnu 7m
Order allow,deny
Deny from all
PK \d + vendor/akeeba/stats_collector/composer.jsonnu [ {
"name": "akeeba/stats_collector",
"description": "Usage Statistic collector",
"minimum-stability": "stable",
"license": "GPL-3.0-or-later",
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM@akeeba.com"
}
],
"require": {
"php": "^7.2|^8.0"
},
"suggest": {
"ext-openssl": "Fallback when random_bytes is not available",
"ext-curl": "For sending the usage stats to the server"
},
"config": {
"platform": {
"php": "7.2.999"
}
},
"autoload": {
"psr-4": {
"Akeeba\\UsageStats\\Collector\\": "src"
}
},
"archive": {
"exclude": [
".idea/**",
".gitignore",
"composer.lock"
]
}
}PK \!n^L L ( vendor/akeeba/stats_collector/LICENSE.mdnu [ # GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc.
Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.
## Preamble
The GNU General Public License is a free, copyleft license for
software and other kinds of works.
The licenses for most software and other practical works are designed
to take away your freedom to share and change the works. By contrast,
the GNU General Public License is intended to guarantee your freedom
to share and change all versions of a program--to make sure it remains
free software for all its users. We, the Free Software Foundation, use
the GNU General Public License for most of our software; it applies
also to any other work released this way by its authors. You can apply
it to your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.
To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights. Therefore, you
have certain responsibilities if you distribute copies of the
software, or if you modify it: responsibilities to respect the freedom
of others.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received. You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.
Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.
For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software. For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.
Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the
manufacturer can do so. This is fundamentally incompatible with the
aim of protecting users' freedom to change the software. The
systematic pattern of such abuse occurs in the area of products for
individuals to use, which is precisely where it is most unacceptable.
Therefore, we have designed this version of the GPL to prohibit the
practice for those products. If such problems arise substantially in
other domains, we stand ready to extend this provision to those
domains in future versions of the GPL, as needed to protect the
freedom of users.
Finally, every program is threatened constantly by software patents.
States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish
to avoid the special danger that patents applied to a free program
could make it effectively proprietary. To prevent this, the GPL
assures that patents cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and
modification follow.
## TERMS AND CONDITIONS
### 0. Definitions.
"This License" refers to version 3 of the GNU General Public License.
"Copyright" also means copyright-like laws that apply to other kinds
of works, such as semiconductor masks.
"The Program" refers to any copyrightable work licensed under this
License. Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.
To "modify" a work means to copy from or adapt all or part of the work
in a fashion requiring copyright permission, other than the making of
an exact copy. The resulting work is called a "modified version" of
the earlier work or a work "based on" the earlier work.
A "covered work" means either the unmodified Program or a work based
on the Program.
To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on a
computer or modifying a private copy. Propagation includes copying,
distribution (with or without modification), making available to the
public, and in some countries other activities as well.
To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user
through a computer network, with no transfer of a copy, is not
conveying.
An interactive user interface displays "Appropriate Legal Notices" to
the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to the
extent that warranties are provided), that licensees may convey the
work under this License, and how to view a copy of this License. If
the interface presents a list of user commands or options, such as a
menu, a prominent item in the list meets this criterion.
### 1. Source Code.
The "source code" for a work means the preferred form of the work for
making modifications to it. "Object code" means any non-source form of
a work.
A "Standard Interface" means an interface that either is an official
standard defined by a recognized standards body, or, in the case of
interfaces specified for a particular programming language, one that
is widely used among developers working in that language.
The "System Libraries" of an executable work include anything, other
than the work as a whole, that (a) is included in the normal form of
packaging a Major Component, but which is not part of that Major
Component, and (b) serves only to enable use of the work with that
Major Component, or to implement a Standard Interface for which an
implementation is available to the public in source code form. A
"Major Component", in this context, means a major essential component
(kernel, window system, and so on) of the specific operating system
(if any) on which the executable work runs, or a compiler used to
produce the work, or an object code interpreter used to run it.
The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts to
control those activities. However, it does not include the work's
System Libraries, or general-purpose tools or generally available free
programs which are used unmodified in performing those activities but
which are not part of the work. For example, Corresponding Source
includes interface definition files associated with source files for
the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require,
such as by intimate data communication or control flow between those
subprograms and other parts of the work.
The Corresponding Source need not include anything that users can
regenerate automatically from other parts of the Corresponding Source.
The Corresponding Source for a work in source code form is that same
work.
### 2. Basic Permissions.
All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met. This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its
content, constitutes a covered work. This License acknowledges your
rights of fair use or other equivalent, as provided by copyright law.
You may make, run and propagate covered works that you do not convey,
without conditions so long as your license otherwise remains in force.
You may convey covered works to others for the sole purpose of having
them make modifications exclusively for you, or provide you with
facilities for running those works, provided that you comply with the
terms of this License in conveying all material for which you do not
control copyright. Those thus making or running the covered works for
you must do so exclusively on your behalf, under your direction and
control, on terms that prohibit them from making any copies of your
copyrighted material outside their relationship with you.
Conveying under any other circumstances is permitted solely under the
conditions stated below. Sublicensing is not allowed; section 10 makes
it unnecessary.
### 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under article
11 of the WIPO copyright treaty adopted on 20 December 1996, or
similar laws prohibiting or restricting circumvention of such
measures.
When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such
circumvention is effected by exercising rights under this License with
respect to the covered work, and you disclaim any intention to limit
operation or modification of the work as a means of enforcing, against
the work's users, your or third parties' legal rights to forbid
circumvention of technological measures.
### 4. Conveying Verbatim Copies.
You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the code;
keep intact all notices of the absence of any warranty; and give all
recipients a copy of this License along with the Program.
You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.
### 5. Conveying Modified Source Versions.
You may convey a work based on the Program, or the modifications to
produce it from the Program, in the form of source code under the
terms of section 4, provided that you also meet all of these
conditions:
- a) The work must carry prominent notices stating that you modified
it, and giving a relevant date.
- b) The work must carry prominent notices stating that it is
released under this License and any conditions added under
section 7. This requirement modifies the requirement in section 4
to "keep intact all notices".
- c) You must license the entire work, as a whole, under this
License to anyone who comes into possession of a copy. This
License will therefore apply, along with any applicable section 7
additional terms, to the whole of the work, and all its parts,
regardless of how they are packaged. This License gives no
permission to license the work in any other way, but it does not
invalidate such permission if you have separately received it.
- d) If the work has interactive user interfaces, each must display
Appropriate Legal Notices; however, if the Program has interactive
interfaces that do not display Appropriate Legal Notices, your
work need not make them do so.
A compilation of a covered work with other separate and independent
works, which are not by their nature extensions of the covered work,
and which are not combined with it such as to form a larger program,
in or on a volume of a storage or distribution medium, is called an
"aggregate" if the compilation and its resulting copyright are not
used to limit the access or legal rights of the compilation's users
beyond what the individual works permit. Inclusion of a covered work
in an aggregate does not cause this License to apply to the other
parts of the aggregate.
### 6. Conveying Non-Source Forms.
You may convey a covered work in object code form under the terms of
sections 4 and 5, provided that you also convey the machine-readable
Corresponding Source under the terms of this License, in one of these
ways:
- a) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by the
Corresponding Source fixed on a durable physical medium
customarily used for software interchange.
- b) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by a
written offer, valid for at least three years and valid for as
long as you offer spare parts or customer support for that product
model, to give anyone who possesses the object code either (1) a
copy of the Corresponding Source for all the software in the
product that is covered by this License, on a durable physical
medium customarily used for software interchange, for a price no
more than your reasonable cost of physically performing this
conveying of source, or (2) access to copy the Corresponding
Source from a network server at no charge.
- c) Convey individual copies of the object code with a copy of the
written offer to provide the Corresponding Source. This
alternative is allowed only occasionally and noncommercially, and
only if you received the object code with such an offer, in accord
with subsection 6b.
- d) Convey the object code by offering access from a designated
place (gratis or for a charge), and offer equivalent access to the
Corresponding Source in the same way through the same place at no
further charge. You need not require recipients to copy the
Corresponding Source along with the object code. If the place to
copy the object code is a network server, the Corresponding Source
may be on a different server (operated by you or a third party)
that supports equivalent copying facilities, provided you maintain
clear directions next to the object code saying where to find the
Corresponding Source. Regardless of what server hosts the
Corresponding Source, you remain obligated to ensure that it is
available for as long as needed to satisfy these requirements.
- e) Convey the object code using peer-to-peer transmission,
provided you inform other peers where the object code and
Corresponding Source of the work are being offered to the general
public at no charge under subsection 6d.
A separable portion of the object code, whose source code is excluded
from the Corresponding Source as a System Library, need not be
included in conveying the object code work.
A "User Product" is either (1) a "consumer product", which means any
tangible personal property which is normally used for personal,
family, or household purposes, or (2) anything designed or sold for
incorporation into a dwelling. In determining whether a product is a
consumer product, doubtful cases shall be resolved in favor of
coverage. For a particular product received by a particular user,
"normally used" refers to a typical or common use of that class of
product, regardless of the status of the particular user or of the way
in which the particular user actually uses, or expects or is expected
to use, the product. A product is a consumer product regardless of
whether the product has substantial commercial, industrial or
non-consumer uses, unless such uses represent the only significant
mode of use of the product.
"Installation Information" for a User Product means any methods,
procedures, authorization keys, or other information required to
install and execute modified versions of a covered work in that User
Product from a modified version of its Corresponding Source. The
information must suffice to ensure that the continued functioning of
the modified object code is in no case prevented or interfered with
solely because modification has been made.
If you convey an object code work under this section in, or with, or
specifically for use in, a User Product, and the conveying occurs as
part of a transaction in which the right of possession and use of the
User Product is transferred to the recipient in perpetuity or for a
fixed term (regardless of how the transaction is characterized), the
Corresponding Source conveyed under this section must be accompanied
by the Installation Information. But this requirement does not apply
if neither you nor any third party retains the ability to install
modified object code on the User Product (for example, the work has
been installed in ROM).
The requirement to provide Installation Information does not include a
requirement to continue to provide support service, warranty, or
updates for a work that has been modified or installed by the
recipient, or for the User Product in which it has been modified or
installed. Access to a network may be denied when the modification
itself materially and adversely affects the operation of the network
or violates the rules and protocols for communication across the
network.
Corresponding Source conveyed, and Installation Information provided,
in accord with this section must be in a format that is publicly
documented (and with an implementation available to the public in
source code form), and must require no special password or key for
unpacking, reading or copying.
### 7. Additional Terms.
"Additional permissions" are terms that supplement the terms of this
License by making exceptions from one or more of its conditions.
Additional permissions that are applicable to the entire Program shall
be treated as though they were included in this License, to the extent
that they are valid under applicable law. If additional permissions
apply only to part of the Program, that part may be used separately
under those permissions, but the entire Program remains governed by
this License without regard to the additional permissions.
When you convey a copy of a covered work, you may at your option
remove any additional permissions from that copy, or from any part of
it. (Additional permissions may be written to require their own
removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work,
for which you have or can give appropriate copyright permission.
Notwithstanding any other provision of this License, for material you
add to a covered work, you may (if authorized by the copyright holders
of that material) supplement the terms of this License with terms:
- a) Disclaiming warranty or limiting liability differently from the
terms of sections 15 and 16 of this License; or
- b) Requiring preservation of specified reasonable legal notices or
author attributions in that material or in the Appropriate Legal
Notices displayed by works containing it; or
- c) Prohibiting misrepresentation of the origin of that material,
or requiring that modified versions of such material be marked in
reasonable ways as different from the original version; or
- d) Limiting the use for publicity purposes of names of licensors
or authors of the material; or
- e) Declining to grant rights under trademark law for use of some
trade names, trademarks, or service marks; or
- f) Requiring indemnification of licensors and authors of that
material by anyone who conveys the material (or modified versions
of it) with contractual assumptions of liability to the recipient,
for any liability that these contractual assumptions directly
impose on those licensors and authors.
All other non-permissive additional terms are considered "further
restrictions" within the meaning of section 10. If the Program as you
received it, or any part of it, contains a notice stating that it is
governed by this License along with a term that is a further
restriction, you may remove that term. If a license document contains
a further restriction but permits relicensing or conveying under this
License, you may add to a covered work material governed by the terms
of that license document, provided that the further restriction does
not survive such relicensing or conveying.
If you add terms to a covered work in accord with this section, you
must place, in the relevant source files, a statement of the
additional terms that apply to those files, or a notice indicating
where to find the applicable terms.
Additional terms, permissive or non-permissive, may be stated in the
form of a separately written license, or stated as exceptions; the
above requirements apply either way.
### 8. Termination.
You may not propagate or modify a covered work except as expressly
provided under this License. Any attempt otherwise to propagate or
modify it is void, and will automatically terminate your rights under
this License (including any patent licenses granted under the third
paragraph of section 11).
However, if you cease all violation of this License, then your license
from a particular copyright holder is reinstated (a) provisionally,
unless and until the copyright holder explicitly and finally
terminates your license, and (b) permanently, if the copyright holder
fails to notify you of the violation by some reasonable means prior to
60 days after the cessation.
Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.
Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License. If your rights have been terminated and not permanently
reinstated, you do not qualify to receive new licenses for the same
material under section 10.
### 9. Acceptance Not Required for Having Copies.
You are not required to accept this License in order to receive or run
a copy of the Program. Ancillary propagation of a covered work
occurring solely as a consequence of using peer-to-peer transmission
to receive a copy likewise does not require acceptance. However,
nothing other than this License grants you permission to propagate or
modify any covered work. These actions infringe copyright if you do
not accept this License. Therefore, by modifying or propagating a
covered work, you indicate your acceptance of this License to do so.
### 10. Automatic Licensing of Downstream Recipients.
Each time you convey a covered work, the recipient automatically
receives a license from the original licensors, to run, modify and
propagate that work, subject to this License. You are not responsible
for enforcing compliance by third parties with this License.
An "entity transaction" is a transaction transferring control of an
organization, or substantially all assets of one, or subdividing an
organization, or merging organizations. If propagation of a covered
work results from an entity transaction, each party to that
transaction who receives a copy of the work also receives whatever
licenses to the work the party's predecessor in interest had or could
give under the previous paragraph, plus a right to possession of the
Corresponding Source of the work from the predecessor in interest, if
the predecessor has it or can get it with reasonable efforts.
You may not impose any further restrictions on the exercise of the
rights granted or affirmed under this License. For example, you may
not impose a license fee, royalty, or other charge for exercise of
rights granted under this License, and you may not initiate litigation
(including a cross-claim or counterclaim in a lawsuit) alleging that
any patent claim is infringed by making, using, selling, offering for
sale, or importing the Program or any portion of it.
### 11. Patents.
A "contributor" is a copyright holder who authorizes use under this
License of the Program or a work on which the Program is based. The
work thus licensed is called the contributor's "contributor version".
A contributor's "essential patent claims" are all patent claims owned
or controlled by the contributor, whether already acquired or
hereafter acquired, that would be infringed by some manner, permitted
by this License, of making, using, or selling its contributor version,
but do not include claims that would be infringed only as a
consequence of further modification of the contributor version. For
purposes of this definition, "control" includes the right to grant
patent sublicenses in a manner consistent with the requirements of
this License.
Each contributor grants you a non-exclusive, worldwide, royalty-free
patent license under the contributor's essential patent claims, to
make, use, sell, offer for sale, import and otherwise run, modify and
propagate the contents of its contributor version.
In the following three paragraphs, a "patent license" is any express
agreement or commitment, however denominated, not to enforce a patent
(such as an express permission to practice a patent or covenant not to
sue for patent infringement). To "grant" such a patent license to a
party means to make such an agreement or commitment not to enforce a
patent against the party.
If you convey a covered work, knowingly relying on a patent license,
and the Corresponding Source of the work is not available for anyone
to copy, free of charge and under the terms of this License, through a
publicly available network server or other readily accessible means,
then you must either (1) cause the Corresponding Source to be so
available, or (2) arrange to deprive yourself of the benefit of the
patent license for this particular work, or (3) arrange, in a manner
consistent with the requirements of this License, to extend the patent
license to downstream recipients. "Knowingly relying" means you have
actual knowledge that, but for the patent license, your conveying the
covered work in a country, or your recipient's use of the covered work
in a country, would infringe one or more identifiable patents in that
country that you have reason to believe are valid.
If, pursuant to or in connection with a single transaction or
arrangement, you convey, or propagate by procuring conveyance of, a
covered work, and grant a patent license to some of the parties
receiving the covered work authorizing them to use, propagate, modify
or convey a specific copy of the covered work, then the patent license
you grant is automatically extended to all recipients of the covered
work and works based on it.
A patent license is "discriminatory" if it does not include within the
scope of its coverage, prohibits the exercise of, or is conditioned on
the non-exercise of one or more of the rights that are specifically
granted under this License. You may not convey a covered work if you
are a party to an arrangement with a third party that is in the
business of distributing software, under which you make payment to the
third party based on the extent of your activity of conveying the
work, and under which the third party grants, to any of the parties
who would receive the covered work from you, a discriminatory patent
license (a) in connection with copies of the covered work conveyed by
you (or copies made from those copies), or (b) primarily for and in
connection with specific products or compilations that contain the
covered work, unless you entered into that arrangement, or that patent
license was granted, prior to 28 March 2007.
Nothing in this License shall be construed as excluding or limiting
any implied license or other defenses to infringement that may
otherwise be available to you under applicable patent law.
### 12. No Surrender of Others' Freedom.
If conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot convey a
covered work so as to satisfy simultaneously your obligations under
this License and any other pertinent obligations, then as a
consequence you may not convey it at all. For example, if you agree to
terms that obligate you to collect a royalty for further conveying
from those to whom you convey the Program, the only way you could
satisfy both those terms and this License would be to refrain entirely
from conveying the Program.
### 13. Use with the GNU Affero General Public License.
Notwithstanding any other provision of this License, you have
permission to link or combine any covered work with a work licensed
under version 3 of the GNU Affero General Public License into a single
combined work, and to convey the resulting work. The terms of this
License will continue to apply to the part which is the covered work,
but the special requirements of the GNU Affero General Public License,
section 13, concerning interaction through a network will apply to the
combination as such.
### 14. Revised Versions of this License.
The Free Software Foundation may publish revised and/or new versions
of the GNU General Public License from time to time. Such new versions
will be similar in spirit to the present version, but may differ in
detail to address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies that a certain numbered version of the GNU General Public
License "or any later version" applies to it, you have the option of
following the terms and conditions either of that numbered version or
of any later version published by the Free Software Foundation. If the
Program does not specify a version number of the GNU General Public
License, you may choose any version ever published by the Free
Software Foundation.
If the Program specifies that a proxy can decide which future versions
of the GNU General Public License can be used, that proxy's public
statement of acceptance of a version permanently authorizes you to
choose that version for the Program.
Later license versions may give you additional or different
permissions. However, no additional obligations are imposed on any
author or copyright holder as a result of your choosing to follow a
later version.
### 15. Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
CORRECTION.
### 16. Limitation of Liability.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR
CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT
NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR
LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM
TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
### 17. Interpretation of Sections 15 and 16.
If the disclaimer of warranty and limitation of liability provided
above cannot be given local legal effect according to their terms,
reviewing courts shall apply local law that most closely approximates
an absolute waiver of all civil liability in connection with the
Program, unless a warranty or assumption of liability accompanies a
copy of the Program in return for a fee.
END OF TERMS AND CONDITIONS
## How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these
terms.
To do so, attach the following notices to the program. It is safest to
attach them to the start of each source file to most effectively state
the exclusion of warranty; and each file should have at least the
"copyright" line and a pointer to where the full notice is found.
Copyright (C)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
Also add information on how to contact you by electronic and paper
mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:
Copyright (C)
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands \`show w' and \`show c' should show the
appropriate parts of the General Public License. Of course, your
program's commands might be different; for a GUI interface, you would
use an "about box".
You should also get your employer (if you work as a programmer) or
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. For more information on this, and how to apply and follow
the GNU GPL, see .
The GNU General Public License does not permit incorporating your
program into proprietary programs. If your program is a subroutine
library, you may consider it more useful to permit linking proprietary
applications with the library. If this is what you want to do, use the
GNU Lesser General Public License instead of this License. But first,
please read .PK \m ' vendor/akeeba/stats_collector/README.mdnu [ # Akeeba Anonymous Usage Statistic Collection
This library is used to collect Joomla, WordPress, PHP, database, and software version numbers from installations of Akeeba software.
## Information for end users
### What we collect and store, and where
We only collect the versions of your CMS (Joomla, or WordPress), PHP, database server (MySQL or MariaDB), and our software, along with a randomly generated mostly-unique site identifier. This information is sent to [our statistics collection server](https://abrandnewsite.com). The site identifier is generated randomly, and is only used to deduplicate the collected information, i.e. not count your site two or more times. We cannot link the site identifier to a specific site or person.
We **NEVER** communicate any personally identifiable information (indicatively: your Download ID, email address, full name etc) to the usage statistics collection server.
The IP addresses of the requests made to our statistics collection server are stored for 12 to 24 months for server security and legal compliance reasons only.
### How this information is used
The information collected is aggregated into trend graphs which allow us to determine when it is meaningful and fair to drop support for older Joomla, WordPress, PHP, and database versions.
Without this information, we would be dropping support of old versions of Joomla, WordPress, PHP, and database servers after 3 to 6 months since the date they become End of Life, regardless of how many users were still using them on their sites.
### Compliance with GDPR, CCPA, and other privacy-related legislation
We do NOT collect any personally identifiable information. The site identifier is randomly generated, and cannot be linked to a specific site, or natural person. As a result, **the collected information is truly anonymous**, satisfying the requirements of privacy-related legislation for information collection without explicit consent.
On top of making absolutely sure that we protect your privacy, we also offer you the option to opt-out of the anonymous usage statistics collection in our software.
## Information for developers
### Usage
Define the repository in `composer.json`:
```json
"repositories": [
{
"type": "github",
"url": "git@github.com:akeeba/stats_collector.git"
},
]
```
Require the library in `composer.json`:
```json
"require": {
"akeeba/stats_collector": "dev-main"
}
```
In your code, initialise the `StatsCollector` object with the software information and call its `conditionalSendStatistics()` method.
For example, this is how to do it for Akeeba Backup for Joomla:
```php
(new \Akeeba\UsageStats\Collector\StatsCollector(
\Akeeba\UsageStats\Collector\Constants\SoftwareType::AB_JOOMLA_CORE,
AKEEBABACKUP_VERSION,
AKEEBABACKUP_PRO
))->conditionalSendStatistics();
```
The above example works for _both_ Akeeba Backup Core and Professional. The software type mutates automatically to the correct Core / Pro identifier based on the rules included prescribed in `\Akeeba\UsageStats\Collector\Constants\SoftwareType::changeCoreOrPro`.
### Adding new platforms / CMS
To support a new software platform / CMS you need to modify the following:
- Create the new platform / CMS in the Usage Stats site.
- Update `\Akeeba\UsageStats\Collector\Constants\CmsType` with the new platform / CMS ID.
- Update `\Akeeba\UsageStats\Collector\Constants\SoftwareType::getCMSType` with the new platform / CMS ID for the corresponding software.
- Create a new adapter in the `Akeeba\UsageStats\Collector\CmsInfo\Adapter` namespace to get the CMS information.
- Create a new adapter in the `Akeeba\UsageStats\Collector\CommonVariables\Adapter` namespace to get/set the common variables in persistent storage.
- Create a new adapter in the `Akeeba\UsageStats\Collector\DatabaseInfo\Adapter` namespace to collect the database information.
- Create a new adapter in the `Akeeba\UsageStats\Collector\Sender\Adapter` namespace to send an HTTP GET query.
- Create a new adapter in the `Akeeba\UsageStats\Collector\SiteUrl\Adapter` namespace to get the site's URL.
### Adding a new database type
To support a new database type you need to modify the following
- Create the new database type in the Usage Stats site.
- Update `\Akeeba\UsageStats\Collector\Constants\DatabaseType` with the new Database Type ID.
- Update the adapters in `Akeeba\UsageStats\Collector\DatabaseInfo\Adapter` to account for the new database type.
### Adding a new software type, or split a software type to Core and Pro
- Create the new software type in the Usage Stats site.
- Update `\Akeeba\UsageStats\Collector\Constants\SoftwareType` with the new Software Type ID.
- Update `\Akeeba\UsageStats\Collector\Constants\SoftwareType::getCMSType` to return the correct platform for the new software type (not needed for Standalone software).
- Update `\Akeeba\UsageStats\Collector\Constants\SoftwareType::changeCoreOrPro` if there is a Core and Pro version for the software
If the software is based on AWF you need to create a few more adapters:
- Create a new adapter in the `Akeeba\UsageStats\Collector\CommonVariables\Adapter` namespace to get/set the common variables in persistent storage.
- Create a new adapter in the `Akeeba\UsageStats\Collector\DatabaseInfo\Adapter` namespace to collect the database information.
- Create a new adapter in the `Akeeba\UsageStats\Collector\Sender\Adapter` namespace to send an HTTP GET query.
- Create a new adapter in the `Akeeba\UsageStats\Collector\SiteUrl\Adapter` namespace to get the site's URL.
PK \G~. ~. 4 vendor/akeeba/stats_collector/src/StatsCollector.phpnu [ commonVariables = new CommonVariables();
$this->randomGenerator = new Random();
$this->statsInterval = new DateInterval('P1W');
// Set the software and software version from the constructor arguments
$this->setSoftware($softwareType, $softwareVersion, $softwarePro);
// Auto-detect the database information
$databaseInfo = new DatabaseInfo();
$this->setDatabase($databaseInfo->getType(), $databaseInfo->getVersion());
// Auto-detect the CMS information
$this->cmsType = SoftwareType::getCMSType($this->softwareType) ?: null;
$cmsInfo = new CmsInfo();
$this->cmsType = $this->cmsType ?? $cmsInfo->getType();
$this->cmsVersion = $cmsInfo->getVersion();
// Auto-detect the site URL (used to decide whether the unique Site ID needs to be regenerated; never transmitted!)
$siteUrl = new SiteUrl();
$this->siteUrl = trim($siteUrl->getUrl()) ?: '';
}
/**
* Sends the usage statistics information to the collection server
*
* @return void
* @since 1.0.0
*/
public function sendStatistics(): void
{
$sender = new Sender($this->serverUrl, $this->timeout);
$sender->sendStatistics($this->getQueryParameters());
$this->commonVariables->setCommonVariable('stats_lastrun', (new DateTime())->getTimestamp());
}
/**
* Should I send the statistics information to the server?
*
* @param bool $updateLastRun True to also update the last sent flag
* @param bool $useForbiddenDomains True to prevent sending information if the site belongs to the forbidden
* domains.
*
* @return bool
* @since 1.0.0
*/
public function shouldSendStatistics(bool $updateLastRun = true, bool $useForbiddenDomains = true): bool
{
// Check 1. Forbidden domain
if ($useForbiddenDomains)
{
$currentUrl = $this->siteUrl ?? $this->commonVariables->getCommonVariable('stats_siteurl', null);
if ($this->isForbiddenDomain($currentUrl))
{
return false;
}
}
// Check 2. Minimum interval between successive information reporting
$lastTimeStamp = (int) $this->commonVariables->getCommonVariable('stats_lastrun', 0);
try
{
$lastDateTime = new DateTime('@' . $lastTimeStamp);
$nextReportDate = (clone $lastDateTime)->add($this->statsInterval);
$now = new DateTime();
}
catch (Throwable $e)
{
return false;
}
$mustSendStatistics = $nextReportDate->diff($now)->invert == 0;
if (!$mustSendStatistics)
{
return false;
}
// Should I update the last statistics sending date and time?
if ($updateLastRun)
{
$this->commonVariables->setCommonVariable('stats_lastrun', $now->getTimestamp());
}
return true;
}
/**
* Conditionally send usage statistics
*
* @param bool $useForbiddenDomains True to prevent sending information if the site belongs to the forbidden
* domains.
*
* @return void
* @since 1.0.0
*/
public function conditionalSendStatistics(bool $useForbiddenDomains = true): void
{
if (!$this->shouldSendStatistics(true, $useForbiddenDomains))
{
return;
}
$this->sendStatistics();
}
/**
* Get (or generate) the pseudonymous Site ID.
*
* The Site ID is generated randomly and is guaranteed to be **most likely** unique. This allows us to collect
* statistics without counting the same site multiple times, without violating the privacy of the user.
*
* @return string
* @since 1.0.0
*/
public function getSiteId(): string
{
$siteId = $this->commonVariables->getCommonVariable('stats_siteid', null);
$currentUrl = $this->siteUrl ?? $this->commonVariables->getCommonVariable('stats_siteurl', null);
if (empty($siteId)
|| (!empty($currentUrl)
&& HashHelper::md5($currentUrl) !== $this->commonVariables->getCommonVariable(
'stats_siteurl', null
)))
{
$siteUrl = HashHelper::md5($currentUrl);
$this->commonVariables->setCommonVariable('stats_siteurl', $siteUrl);
$siteId = HashHelper::sha1($this->randomGenerator->getRandomBytes(120));
$this->commonVariables->setCommonVariable('stats_siteid', $siteId);
}
return $siteId;
}
/**
* Set the software information.
*
* @param int $type The software type
* @param string $version The software version
* @param bool $isPro Is this the Professional version of the software? FALSE for software without a Pro
* version.
*
* @return self
* @since 1.0.0
*/
public function setSoftware(int $type, string $version, bool $isPro = false): self
{
$this->softwareType = $type;
$this->softwareVersion = $version;
$this->softwarePro = $isPro;
return $this;
}
/**
* Set the CMS type and version we are running under
*
* @param int $cmsType The CMS type
* @param string $cmsVersion The CMS version
*
* @return self
*/
public function setCms(int $cmsType, string $cmsVersion): self
{
$this->cmsType = $cmsType;
$this->cmsVersion = $cmsVersion;
return $this;
}
/**
* Set the database information
*
* @param int $type The database type
* @param string $version The database version
*
* @return self
* @since 1.0.0
*/
public function setDatabase(int $type, string $version): self
{
$this->databaseType = $type;
$this->databaseVersion = $version;
return $this;
}
/**
* Set the URL of the current site
*
* @param null $siteUrl
*
* @return self
* @since 1.0.0
*/
public function setSiteUrl($siteUrl): self
{
$this->siteUrl = $siteUrl;
return $this;
}
/**
* Get the URL query parameters corresponding to the information currently set in the object
*
* @return array
* @since 1.0.0
*/
public function getQueryParameters(): array
{
$swVersion = new Version($this->softwareVersion);
$phpVersion = new Version(PHP_VERSION);
$dbVersion = new Version($this->databaseVersion);
$cmsVersion = new Version($this->cmsVersion);
return [
'sid' => $this->getSiteId(),
'sw' => SoftwareType::changeCoreOrPro($this->softwareType, $this->softwarePro),
'pro' => $this->softwarePro ? 1 : 0,
'sm' => $swVersion->major(),
'sn' => $swVersion->minor(),
'sr' => $swVersion->patch(),
'pm' => $phpVersion->major(),
'pn' => $phpVersion->minor(),
'pr' => $phpVersion->patch(),
'pq' => $phpVersion->tag(),
'dt' => $this->databaseType,
'dm' => $dbVersion->major(),
'dn' => $dbVersion->minor(),
'dr' => $dbVersion->patch(),
'dq' => $dbVersion->tag(),
'ct' => $this->cmsType,
'cm' => $cmsVersion->major(),
'cn' => $cmsVersion->minor(),
'cr' => $cmsVersion->patch(),
];
}
/**
* Set the statistics collection server URL.
*
* @param string $serverUrl The URL to set
*
* @return self
* @since 1.0.0
*/
public function setServerUrl(string $serverUrl): self
{
$this->serverUrl = $serverUrl;
return $this;
}
/**
* Returns the statistics collection server URL.
*
* @return string
* @since 1.0.0
*/
public function getServerUrl(): string
{
return $this->serverUrl;
}
/**
* Sets the request timeout, in seconds, for sending the statistics to the server.
*
* @param int $timeout The request timeout, in seconds
*
* @return self
* @since 1.0.0
*/
public function setTimeout(int $timeout): self
{
$this->timeout = $timeout;
return $this;
}
/**
* Sets the minimum period between successive reports of information to the server.
*
* @param DateInterval $statsInterval
*
* @return self
*/
public function setStatsInterval(DateInterval $statsInterval): self
{
$this->statsInterval = $statsInterval;
return $this;
}
/**
* Does the domain name of the given URL belong in the list of forbidden domains?
*
* @param string|null $currentUrl
*
* @return bool
* @since 1.0.0
*/
private function isForbiddenDomain(?string $currentUrl): bool
{
if (empty($currentUrl))
{
return false;
}
$host = @parse_url($currentUrl, PHP_URL_HOST);
if (empty($host))
{
return false;
}
foreach (self::FORBIDDEN_DOMAINS as $domain)
{
if (!empty($host) && $this->str_ends_with($host, $domain))
{
return true;
}
}
return false;
}
/**
* Polyfill for str_ends_with, for hosts running on PHP 7.
*
* @param string $haystack
* @param string $needle
*
* @return bool
*/
private function str_ends_with(string $haystack, string $needle): bool
{
if (function_exists('str_ends_with'))
{
return str_ends_with($haystack, $needle);
}
if ($needle === '' || $needle === $haystack)
{
return true;
}
if ($haystack === '')
{
return false;
}
$needleLength = strlen($needle);
return $needleLength <= strlen($haystack) && 0 === substr_compare($haystack, $needle, -$needleLength);
}
}PK \ ? 3 vendor/akeeba/stats_collector/src/Random/Random.phpnu [ getAdapter()->getRandomBytes(120);
}
/**
* Get the appropriate adapter for generating random bytes
*
* @return AdapterInterface|null
* @since 1.0.0
*/
private function getAdapter(): ?AdapterInterface
{
if ($this->adapter !== null)
{
return $this->adapter;
}
foreach (self::ADAPTERS as $className)
{
if (!class_exists($className))
{
continue;
}
/** @var AdapterInterface $o */
$o = new $className;
if (!$o->isAvailable())
{
continue;
}
return $this->adapter = $o;
}
return null;
}
}PK \ I vendor/akeeba/stats_collector/src/Random/Adapter/CompatibilityAdapter.phpnu [ strlen($randomStr))
{
$bytes = ($total > $shaHashLength) ? $shaHashLength : $total;
$total -= $bytes;
/*
* Collect any entropy available from the PHP system and filesystem.
* If we have ssl data that isn't strong, we use it once.
*/
$entropy = function_exists('random_bytes') && function_exists('bin2hex')
? bin2hex(random_bytes($bytes))
: uniqid(mt_rand(), true);
$entropy .= rand();
$entropy .= implode('', @fstat(fopen(__FILE__, 'r')));
$entropy .= memory_get_usage();
if ($urandom)
{
stream_set_read_buffer($handle, 0);
$entropy .= @fread($handle, $bytes);
}
else
{
/*
* There is no external source of entropy so we repeat calls
* to mt_rand until we are assured there's real randomness in
* the result.
*
* Measure the time that the operations will take on average.
*/
$samples = 3;
$duration = 0;
for ($pass = 0; $pass < $samples; ++$pass)
{
$microStart = microtime(true) * 1000000;
$hash = HashHelper::sha1(mt_rand(), true);
for ($count = 0; $count < 50; ++$count)
{
$hash = HashHelper::sha1($hash, true);
}
$microEnd = microtime(true) * 1000000;
$entropy .= $microStart . $microEnd;
if ($microStart >= $microEnd)
{
$microEnd += 1000000;
}
$duration += $microEnd - $microStart;
}
$duration = $duration / $samples;
/*
* Based on the average time, determine the total rounds so that
* the total running time is bounded to a reasonable number.
*/
$rounds = (int) (($maxTimeMicro / $duration) * 50);
/*
* Take additional measurements. On average we can expect
* at least $bitsPerRound bits of entropy from each measurement.
*/
$iter = $bytes * (int) ceil(8 / $bitsPerRound);
for ($pass = 0; $pass < $iter; ++$pass)
{
$microStart = microtime(true);
$hash = HashHelper::sha1(mt_rand(), true);
for ($count = 0; $count < $rounds; ++$count)
{
$hash = HashHelper::sha1($hash, true);
}
$entropy .= $microStart . microtime(true);
}
}
$randomStr .= HashHelper::sha1($entropy, true);
}
if ($urandom)
{
@fclose($handle);
}
return substr($randomStr, 0, $length);
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return true;
}
}PK \U C vendor/akeeba/stats_collector/src/Random/Adapter/OpenSSLAdapter.phpnu [
Order allow,deny
Deny from all
PK \Sʉ 2 vendor/akeeba/stats_collector/src/Random/.htaccessnu 7m
Order allow,deny
Deny from all
PK \SF F 5 vendor/akeeba/stats_collector/src/SiteUrl/SiteUrl.phpnu [ getAdapter();
if ($adapter === null)
{
return '';
}
return $this->getAdapter()->getUrl() ?: '';
}
/**
* Get the appropriate adapter for handling common variables
*
* @return AdapterInterface|null
* @since 1.0.0
*/
private function getAdapter(): ?AdapterInterface
{
if ($this->adapter !== null)
{
return $this->adapter;
}
foreach (self::ADAPTERS as $className)
{
if (!class_exists($className))
{
continue;
}
/** @var AdapterInterface $o */
$o = new $className;
if (!$o->isAvailable())
{
continue;
}
return $this->adapter = $o;
}
return null;
}
}PK \` ` A vendor/akeeba/stats_collector/src/SiteUrl/Adapter/SoloAdapter.phpnu [ getUrlReal();
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
global $akeebaBackupWordPressContainer;
global $akeebaSoloContainer;
return !defined('WPINC')
&& !isset($akeebaBackupWordPressContainer)
&& isset($akeebaSoloContainer)
&& class_exists(Uri::class)
&& class_exists(Container::class)
&& !empty($this->getUrlReal());
}
/**
* Get the URL in the adapter-specific way
*
* @return string|null NULL if we cannot determine it
* @since 1.0.0
*/
private function getUrlReal(): ?string
{
/** @var Container $akeebaSoloContainer */
global $akeebaSoloContainer;
if (PHP_SAPI !== 'cli')
{
return Uri::base();
}
try
{
return $akeebaSoloContainer->application->getContainer()->appConfig->get('options.siteurl');
}
catch (Throwable $e)
{
return null;
}
}
}PK \
%u J vendor/akeeba/stats_collector/src/SiteUrl/Adapter/GenericJoomlaAdapter.phpnu [ getUrlReal() ?? '';
}
/** @inheritDoc */
public function isAvailable(): bool
{
return defined('_JEXEC')
&& !empty($this->getUrlReal());
}
/**
* Get the URL in the adapter-specific way
*
* @return string|null NULL if we cannot determine it
* @since 1.0.0
*/
private function getUrlReal(): ?string
{
if (PHP_SAPI !== 'cli')
{
return Uri::base();
}
/**
* Under CLI the default is to set the site URL to https://joomla.invalid/set/by/console/application so that the
* CLI application does not crash. If this is the case, we cannot return a valid URL.
*
* The user can pass the site's URL in the --live-site parameter.
*/
$possibleUrl = Uri::base();
if (strpos($possibleUrl, 'joomla.invalid') !== false)
{
return null;
}
return $possibleUrl;
}
}PK \7 P vendor/akeeba/stats_collector/src/SiteUrl/Adapter/AdminToolsWordPressAdapter.phpnu [ componentName = 'com_admintools';
$this->paramName = 'siteurl';
}
}PK \QU
/i i F vendor/akeeba/stats_collector/src/SiteUrl/Adapter/AdapterInterface.phpnu [ componentName = 'com_ats';
$this->paramName = 'siteurl';
}
}PK \ q T vendor/akeeba/stats_collector/src/SiteUrl/Adapter/AbstractJoomlaComponentAdapter.phpnu [ getUrlReal() ?? '';
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return defined('_JEXEC')
&& class_exists(ComponentHelper::class)
&& ComponentHelper::isEnabled($this->componentName)
&& !empty($this->getUrlReal());
}
/**
* Get the URL in the adapter-specific way
*
* @return string|null NULL if we cannot determine it
* @since 1.0.0
*/
private function getUrlReal(): ?string
{
if (PHP_SAPI !== 'cli')
{
return Uri::base();
}
try
{
$params = ComponentHelper::getParams($this->componentName);
return $params->get($this->paramName, null);
}
catch (Throwable $e)
{
return null;
}
}
}PK \~5 G vendor/akeeba/stats_collector/src/SiteUrl/Adapter/GenericAwfAdapter.phpnu [ getUrlReal() ?? '';
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return !defined('WPINC')
&& !isset($akeebaBackupWordPressContainer)
&& class_exists(Uri::class)
&& class_exists(Application::class)
&& class_exists(Container::class)
&& !empty($this->getUrlReal());
}
/**
* Get the URL in the adapter-specific way
*
* @return string|null NULL if we cannot determine it
* @since 1.0.0
*/
private function getUrlReal(): ?string
{
if (PHP_SAPI !== 'cli')
{
return Uri::base();
}
try
{
return Application::getInstance()->getContainer()->appConfig->get('options.siteurl');
}
catch (Throwable $e)
{
return null;
}
}
}PK \H> O vendor/akeeba/stats_collector/src/SiteUrl/Adapter/AkeebaBackupJoomlaAdapter.phpnu [ componentName = 'com_akeebabackup';
$this->paramName = 'siteurl';
}
}PK \(8\R R R vendor/akeeba/stats_collector/src/SiteUrl/Adapter/AkeebaBackupWordPressAdapter.phpnu [ getUrlReal() ?? '';
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
global $akeebaBackupWordPressContainer;
return defined('WPINC')
&& isset($akeebaBackupWordPressContainer)
&& class_exists(Uri::class)
&& class_exists(Container::class)
&& !empty($this->getUrlReal());
}
/**
* Get the URL in the adapter-specific way
*
* @return string|null NULL if we cannot determine it
* @since 1.0.0
*/
private function getUrlReal(): ?string
{
/** @var Container $akeebaBackupWordPressContainer */
global $akeebaBackupWordPressContainer;
if (PHP_SAPI !== 'cli')
{
return Uri::base();
}
try
{
return $akeebaBackupWordPressContainer->application->getContainer()->appConfig->get('options.siteurl');
}
catch (Throwable $e)
{
return null;
}
}
}PK \`-vzV V M vendor/akeeba/stats_collector/src/SiteUrl/Adapter/GenericWordPressAdapter.phpnu [
Order allow,deny
Deny from all
PK \!˕c E vendor/akeeba/stats_collector/src/SiteUrl/Adapter/DarkLinkAdapter.phpnu [
Order allow,deny
Deny from all
PK \&[X X ? vendor/akeeba/stats_collector/src/DatabaseInfo/DatabaseInfo.phpnu [ getAdapter();
if ($adapter === null)
{
return DatabaseType::UNKNOWN;
}
return $adapter->getType();
}
/**
* Get the database version
*
* @return string
* @since 1.0.0
*/
public function getVersion(): string
{
$adapter = $this->getAdapter();
if ($adapter === null)
{
return '0.0.0';
}
return $adapter->getVersion();
}
/**
* Get the appropriate adapter for getting database information
*
* @return AdapterInterface|null
* @since 1.0.0
*/
private function getAdapter(): ?AdapterInterface
{
if ($this->adapter !== null)
{
return $this->adapter;
}
foreach (self::ADAPTERS as $className)
{
if (!class_exists($className))
{
continue;
}
/** @var AdapterInterface $o */
$o = new $className;
if (!$o->isAvailable())
{
continue;
}
return $this->adapter = $o;
}
return null;
}
}PK \ N vendor/akeeba/stats_collector/src/DatabaseInfo/Adapter/AkeebaEngineAdapter.phpnu [ getDriverType();
switch ($driverType)
{
default:
return DatabaseType::UNKNOWN;
case 'sqlite':
return DatabaseType::SQLITE;
case 'mysql':
$rawVersion = $db->getVersion();
$isMariaDB = strpos($rawVersion, '-MariaDB') !== false;
return $isMariaDB ? DatabaseType::MARIADB : DatabaseType::MYSQL;
}
}
/**
* @inheritDoc
*/
public function getVersion(): string
{
try
{
$db = Factory::getDatabase();
}
catch (Throwable $e)
{
return '0.0.0';
}
$driverType = $db->getDriverType();
$rawVersion = $db->getVersion();
if ($driverType !== 'mysql')
{
return $rawVersion;
}
// Old MariaDB versions on Windows report their version as something like `5.5.5-10.0.17-MariaDB-log`
if (strpos($rawVersion, '-MariaDB') !== false && strpos('5.5.5-', $rawVersion) === 0)
{
$rawVersion = substr($rawVersion, 6);
}
return $rawVersion;
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return defined('AKEEBA') && class_exists(Factory::class);
}
}PK \XFG K vendor/akeeba/stats_collector/src/DatabaseInfo/Adapter/WordPressAdapter.phpnu [ is_mysql)
{
return DatabaseType::UNKNOWN;
}
}
catch (Throwable $e)
{
return DatabaseType::UNKNOWN;
}
$rawVersion = $wpdb->db_server_info();
$isMariaDB = false;
// Old MariaDB versions on Windows report their version as something like `5.5.5-10.0.17-MariaDB-log`
$isMariaDB = strpos($rawVersion, '-MariaDB') !== false;
return $isMariaDB ? DatabaseType::MARIADB : DatabaseType::MYSQL;
}
/**
* @inheritDoc
*/
public function getVersion(): string
{
global $wpdb;
// Our WordPress software only runs on MySQL and MariaDB.
try
{
if (!$wpdb->is_mysql)
{
return '0.0.0';
}
}
catch (Throwable $e)
{
return '0.0.0';
}
$rawVersion = $wpdb->db_server_info();
// Old MariaDB versions on Windows report their version as something like `5.5.5-10.0.17-MariaDB-log`
if (strpos($rawVersion, '-MariaDB') !== false && strpos('5.5.5-', $rawVersion) === 0)
{
$rawVersion = substr($rawVersion, 6);
}
return $rawVersion;
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return defined('WPINC') && class_exists(wpdb::class);
}
}PK \s> K vendor/akeeba/stats_collector/src/DatabaseInfo/Adapter/AdapterInterface.phpnu [ getContainer()->db;
}
catch (Throwable $e)
{
return DatabaseType::UNKNOWN;
}
switch ($db->name)
{
default:
return DatabaseType::UNKNOWN;
case 'sqlsrv':
case 'sqlzure':
case 'sqlazure':
return DatabaseType::SQLSERVER;
case 'postgresql':
case 'pgsql':
return DatabaseType::POSTGRESQL;
case 'sqlite':
return DatabaseType::SQLITE;
case 'mysql':
case 'mysqli':
case 'pdomysql':
$rawVersion = $db->getVersion();
$isMariaDB = strpos($rawVersion, '-MariaDB') !== false;
return $isMariaDB ? DatabaseType::MARIADB : DatabaseType::MYSQL;
}
}
/**
* @inheritDoc
*/
public function getVersion(): string
{
try
{
$db = $this->getContainer()->db;
}
catch (Throwable $e)
{
return '0.0.0';
}
$rawVersion = $db->getVersion();
if (!in_array($db->name, ['mysql', 'mysqli', 'pdomysql']))
{
return $rawVersion;
}
// Old MariaDB versions on Windows report their version as something like `5.5.5-10.0.17-MariaDB-log`
if (strpos($rawVersion, '-MariaDB') !== false && strpos('5.5.5-', $rawVersion) === 0)
{
$rawVersion = substr($rawVersion, 6);
}
return $rawVersion;
}
/** @inheritDoc */
public function isAvailable(): bool
{
return class_exists(Driver::class) && $this->getContainer() !== null;
}
/**
* Get the container for this AWF-based software
*
* @return Container|null
* @since 1.0.0
*/
abstract protected function getContainer(): ?Container;
}PK \ H vendor/akeeba/stats_collector/src/DatabaseInfo/Adapter/JoomlaAdapter.phpnu [ get(DatabaseInterface::class);
$serverType = $db->getServerType();
}
catch (Throwable $e)
{
return DatabaseType::UNKNOWN;
}
switch ($serverType)
{
case 'mysql':
if (method_exists($db, 'isMariaDb') && $db->isMariaDb())
{
return DatabaseType::MARIADB;
}
return DatabaseType::MYSQL;
case 'postgresql':
return DatabaseType::POSTGRESQL;
case 'sqlite':
return DatabaseType::SQLITE;
case 'mssql':
return DatabaseType::SQLSERVER;
default:
return DatabaseType::UNKNOWN;
}
}
/**
* @inheritDoc
*/
public function getVersion(): string
{
try
{
/** @var DatabaseDriver $db */
$db = Factory::getContainer()->get(DatabaseInterface::class);
return $db->getVersion();
}
catch (Throwable $e)
{
return '0.0.0';
}
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return defined('_JEXEC') && interface_exists(DatabaseInterface::class);
}
}PK \Sʉ @ vendor/akeeba/stats_collector/src/DatabaseInfo/Adapter/.htaccessnu 7m
Order allow,deny
Deny from all
PK \@v J vendor/akeeba/stats_collector/src/DatabaseInfo/Adapter/DarkLinkAdapter.phpnu [
Order allow,deny
Deny from all
PK \>j! ! F vendor/akeeba/stats_collector/src/Sender/Adapter/AkeebaSoloAdapter.phpnu [ getUrl($queryParameters), [
'timeout' => $this->getTimeout(),
'user-agent' => $this->getUserAgent(),
]
);
}
}PK \fZ Z E vendor/akeeba/stats_collector/src/Sender/Adapter/AdapterInterface.phpnu [ serverUrl = $url;
}
/**
* Get the request timeout, in seconds
*
* @return int
* @since 1.0.0
*/
protected function getTimeout(): int
{
return $this->timeout;
}
/**
* Set the request timeout
*
* @param int $timeout The timeout, in seconds
*
* @return void
* @since 1.0.0
*/
public function setTimeout(int $timeout): void
{
$this->timeout = $timeout;
}
/**
* Get the URL to fetch
*
* @param array $queryParameters
*
* @return string
* @since 1.0.0
*/
protected function getUrl(array $queryParameters): string
{
return $this->serverUrl . '?' . http_build_query($queryParameters);
}
/**
* Returns a custom User Agent string.
*
* @return string
* @since 1.0.0
*/
protected function getUserAgent(): string
{
return 'AkeebaUsageStats/1.0';
}
}PK \ql_ _ F vendor/akeeba/stats_collector/src/Sender/Adapter/PanopticonAdapter.phpnu [ getContainer() !== null;
}
/**
* @inheritDoc
*/
public function sendStatistics(array $queryParameters): void
{
$download = new Download($this->getContainer());
$timeout = $this->getTimeout();
$userAgent = $this->getUserAgent();
if ($download->getAdapterName() === 'curl')
{
$download->setAdapterOptions(
[
CURLOPT_TIMEOUT => $timeout,
CURLOPT_USERAGENT => $userAgent,
]
);
}
elseif ($download->getAdapterName() === 'fopen')
{
$download->setAdapterOptions(
[
'http' => [
'timeout' => (float) $timeout,
'user_agent' => $userAgent,
],
]
);
}
$download->getFromURL($this->getUrl($queryParameters));
}
/**
* Get the AWF Container for the current application
*
* @return Container|null
* @since 1.0.0
*/
abstract protected function getContainer(): ?Container;
}PK \z3ª B vendor/akeeba/stats_collector/src/Sender/Adapter/JoomlaAdapter.phpnu [ getHttp(
[
'follow_location' => true,
'userAgent' => $this->getUserAgent(),
'timeout' => $this->getTimeout(),
]
);
$http->get($this->getUrl($queryParameters));
}
}PK \6
Order allow,deny
Deny from all
PK \XY Y D vendor/akeeba/stats_collector/src/Sender/Adapter/DarkLinkAdapter.phpnu [ serverUrl = $serverUrl;
$this->timeout = $timeout;
}
/**
* Send the usage statistics information to the server
*
* @param array $queryParameters The information to send
*
* @return void
* @since 1.0.0
*/
public function sendStatistics(array $queryParameters): void
{
$adapter = $this->getAdapter();
if ($adapter === null)
{
return;
}
$adapter->sendStatistics($queryParameters);
}
/**
* Get the appropriate adapter for sending statistics to the server
*
* @return AdapterInterface|null
* @since 1.0.0
*/
private function getAdapter(): ?AdapterInterface
{
if ($this->adapter !== null)
{
return $this->adapter;
}
foreach (self::ADAPTERS as $className)
{
if (!class_exists($className))
{
continue;
}
/** @var AdapterInterface $o */
$o = new $className;
if (!$o->isAvailable())
{
continue;
}
$o->setServerUrl($this->serverUrl);
$o->setTimeout($this->timeout);
return $this->adapter = $o;
}
return null;
}
}PK \Sʉ 2 vendor/akeeba/stats_collector/src/Sender/.htaccessnu 7m
Order allow,deny
Deny from all
PK \m ; vendor/akeeba/stats_collector/src/LegacyShim/HashHelper.phpnu [
Order allow,deny
Deny from all
PK \o|i^& ^& 5 vendor/akeeba/stats_collector/src/Version/Version.phpnu [
*
* The original code carries the following copyright notice:
* ====== ORIGINAL COPYRIGHT NOTICE START ======
* MIT License
*
* Copyright (c) 2020 Mistralys
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
* ====== ORIGINAL COPYRIGHT NOTICE END ======
*
* @since 1.0.0
*/
final class Version
{
const TAG_TYPE_NONE = 'none';
const TAG_TYPE_DEV = 'dev';
const TAG_TYPE_BETA = 'beta';
const TAG_TYPE_ALPHA = 'alpha';
const TAG_TYPE_RELEASE_CANDIDATE = 'rc';
/**
* The version number we are processing
*
* @var string
* @since 1.0.0
*/
private $version;
/**
* The literal tag (qualifiers) of this version
*
* @var string
* @since 1.0.0
*/
private $tag = '';
/**
* The parts the version number consists of
*
* @var array
* @since 1.0.0
*/
private $parts = [];
/**
* The normalised tag of this version
*
* @var string
* @since 1.0.0
*/
private $tagType = self::TAG_TYPE_NONE;
/**
* The sub-minor version number in the tag
*
* @var int
* @since 1.0.0
*/
private $tagNumber = 0;
/**
* The branch name, if present in the version string
*
* @var string
* @since 1.0.0
*/
private $branchName = '';
/**
* Internal map of tag weights
*
* @var array|int[]
* @since 1.0.0
*/
private $tagWeights = [
self::TAG_TYPE_DEV => 8,
self::TAG_TYPE_ALPHA => 6,
self::TAG_TYPE_BETA => 4,
self::TAG_TYPE_RELEASE_CANDIDATE => 2,
self::TAG_TYPE_NONE => 0,
];
/**
* Public constructor
*
* @param string $version The version to parse
*
* @since 1.0.0
*/
public function __construct(string $version)
{
$this->version = $version;
$this->parse();
$this->postParse();
}
/**
* Major version, e.g. 1 for 1.2.3.4-beta4
*
* @return int
* @since 1.0.0
*/
public function major(): int
{
return $this->parts[0];
}
/**
* Minor version, e.g. 2 for 1.2.3.4-beta4
*
* @return int
* @since 1.0.0
*/
public function minor(): int
{
return $this->parts[1];
}
/**
* Patch version, e.g. 3 for 1.2.3.4-beta4
*
* @return int
* @since 1.0.0
*/
public function patch(): int
{
return $this->parts[2];
}
/**
* Returns the normalised full version
*
* @return string
* @since 1.0.0
*/
public function fullVersion(): string
{
$version = $this->version;
if (!$this->hasTag())
{
return $version;
}
return $version . '-' . $this->tag();
}
/**
* Returns the short version (x.y.z)
*
* @param bool $forceThreeParts To force three parts, even if minor and patch are zero
*
* @return string
* @since 1.0.0
*/
public function shortVersion(bool $forceThreeParts = false): string
{
$keep = [];
if ($forceThreeParts || $this->parts[2] > 0)
{
$keep = $this->parts;
}
elseif ($this->parts[1] > 0)
{
$keep = [$this->parts[0], $this->parts[1]];
}
else
{
$keep = [$this->parts[0]];
}
return implode('.', $keep);
}
/**
* Returns the version family, e.g. 1.2
*
* @return string
* @since 1.0.0
*/
public function versionFamily(): string
{
return implode('.', [$this->major(), $this->minor()]);
}
/**
* Returns the tag of the parsed version
*
* @return string
* @since 1.0.0
*/
public function tag(): string
{
return $this->tag;
}
/**
* Does the version have a tag?
*
* @return bool
* @since 1.0.0
*/
public function hasTag(): bool
{
return !empty($this->tag);
}
/**
* The type of the version tag
*
* @return string
* @since 1.0.0
*
* @see self::TAG_TYPE_NONE
* @see self::TAG_TYPE_DEV
* @see self::TAG_TYPE_ALPHA
* @see self::TAG_TYPE_BETA,
* @see self::TAG_TYPE_RELEASE_CANDIDATE
*/
public function tagType(): string
{
return $this->tagType;
}
/**
* The number in the tag, if one exists
*
* @return int
* @since 1.0.0
*/
public function tagNumber(): int
{
return $this->tagNumber;
}
/**
* Is this a beta version?
*
* @return bool
* @since 1.0.0
*/
public function isBeta(): bool
{
return $this->tagType() === self::TAG_TYPE_BETA;
}
/**
* Is this an alpha version?
*
* @return bool
* @since 1.0.0
*/
public function isAlpha(): bool
{
return $this->tagType() === self::TAG_TYPE_ALPHA;
}
/**
* Is this a Release Candidate version?
*
* @return bool
* @since 1.0.0
*/
public function isRC(): bool
{
return $this->tagType() === self::TAG_TYPE_RELEASE_CANDIDATE;
}
/**
* Is this a Development version?
*
* @return bool
* @since 1.0.0
*/
public function isDev(): bool
{
return $this->tagType() === self::TAG_TYPE_DEV;
}
/**
* Is this a stable version?
*
* @return bool
* @since 1.0.0
*/
public function isStable(): bool
{
return $this->tagType() === self::TAG_TYPE_NONE;
}
/**
* Is this a testing (dev, alpha, beta, RC) version?
*
* @return bool
* @since 1.0.0
*/
public function isTesting(): bool
{
return !$this->isStable();
}
/**
* Is a branch name present in the version?
*
* @return bool
* @since 1.0.0
*/
public function hasBranch(): bool
{
return !empty($this->branchName);
}
/**
* The branch name of the version string
*
* @return string
* @since 1.0.0
*/
public function branchName(): string
{
return $this->branchName;
}
/**
* Parse the version number
*
* @internal
* @return void
* @since 1.0.0
*/
private function parse(): void
{
$parts = explode('.', $this->extractTag());
$parts = array_map('trim', $parts);
while (count($parts) < 3)
{
$parts[] = 0;
}
for ($i = 0; $i < 3; $i++)
{
$this->parts[] = intval($parts[$i]);
}
}
/**
* Extract the tag from the version
*
* @internal
* @return string
* @since 1.0.0
*/
private function extractTag(): string
{
$version = $this->version;
$version = str_replace('_', '-', $version);
$hyphen = strpos($version, '-');
if ($hyphen !== false)
{
$tag = substr($version, $hyphen + 1);
$version = substr($version, 0, $hyphen);
$this->parseTag($tag);
}
return $version;
}
/**
* Runs after parsing the version number
*
* @internal
* @return void
* @since 1.0.0
*/
private function postParse(): void
{
$this->tag = $this->normalizeTag();
}
/**
* Normalises the tag representation
*
* @internal
* @return string
* @since 1.0.0
*/
private function normalizeTag(): string
{
if ($this->tagType === self::TAG_TYPE_NONE)
{
return $this->branchName();
}
$tag = $this->tagType;
if ($this->tagNumber > 1)
{
$tag .= $this->tagNumber;
}
if ($this->hasBranch())
{
$tag = $this->branchName() . '-' . $tag;
}
return $tag;
}
/**
* Returns the formatted tag number
*
* @internal
* @return string
* @since 1.0.0
*/
private function formatTagNumber(): string
{
$positions = 2 * 3;
$weight = $this->tagWeights[$this->tagType()];
if ($weight > 0)
{
$number = sprintf('%0' . $weight . 'd', $this->tagNumber);
$number = str_pad($number, $positions, '0', STR_PAD_RIGHT);
$number = intval(str_repeat('9', $positions)) - intval($number);
return '.' . $number;
}
return '';
}
/**
* Parse the tag specified in the version
*
* @param string $tag
*
* @internal
* @return void
* @since 1.0.0
*/
private function parseTag(string $tag): void
{
$parts = explode('-', $tag);
foreach ($parts as $part)
{
$this->parseTagPart($part);
}
if ($this->tagNumber === 0)
{
$this->tagNumber = 1;
}
if ($this->tagType === self::TAG_TYPE_NONE)
{
$this->tagNumber = 0;
}
}
/**
* Parse a part of the tag specified in the version
*
* @param string $part
*
* @internal
* @return void
* @since 1.0.0
*/
private function parseTagPart(string $part): void
{
if (is_numeric($part))
{
$this->tagNumber = intval($part);
return;
}
$types = array_keys($this->tagWeights);
$type = '';
$lower = strtolower($part);
foreach ($types as $tagType)
{
if (strstr($lower, $tagType))
{
$type = $tagType;
$part = str_replace($tagType, '', $lower);
}
}
if (empty($type))
{
if (!empty($part))
{
$this->branchName = $part;
}
return;
}
$this->tagType = $type;
if (is_numeric($part))
{
$this->tagNumber = intval($part);
}
}
}
PK \Sʉ 3 vendor/akeeba/stats_collector/src/Version/.htaccessnu 7m
Order allow,deny
Deny from all
PK \3/2 2 < vendor/akeeba/stats_collector/src/Constants/DatabaseType.phpnu [
Order allow,deny
Deny from all
PK \,Y 5 vendor/akeeba/stats_collector/src/CmsInfo/CmsInfo.phpnu [ getAdapter();
if ($adapter === null)
{
return CmsType::STANDALONE;
}
return $adapter->getType();
}
/**
* Get the CMS version
*
* @return string
* @since 1.0.0
*/
public function getVersion(): string
{
$adapter = $this->getAdapter();
if ($adapter === null)
{
return '0.0.0';
}
return $adapter->getVersion();
}
/**
* Get the appropriate adapter for getting CMS information
*
* @return AdapterInterface|null
* @since 1.0.0
*/
private function getAdapter(): ?AdapterInterface
{
if ($this->adapter !== null)
{
return $this->adapter;
}
foreach (self::ADAPTERS as $className)
{
if (!class_exists($className))
{
continue;
}
/** @var AdapterInterface $o */
$o = new $className;
if (!$o->isAvailable())
{
continue;
}
return $this->adapter = $o;
}
return null;
}
}PK \eN N F vendor/akeeba/stats_collector/src/CmsInfo/Adapter/WordPressAdapter.phpnu [ getWPVersion() ?? '0.0.0';
}
/** @inheritDoc */
public function isAvailable(): bool
{
return defined('WPINC') && defined('ABSPATH') && $this->getWPVersion() !== false;
}
/**
* Try to get the WordPress version by including its version.php file directly.
*
* @return string|null The WordPress version. NULL when it cannot be determined.
* @since 1.0.0
*/
private function getWPVersion(): ?string
{
$filePath = ABSPATH . '/' . WPINC . '/version.php';
if (!@file_exists($filePath) || !@is_file($filePath) || !@is_readable($filePath))
{
return null;
}
try
{
include $filePath;
}
catch (Throwable $e)
{
return null;
}
if (function_exists('classicpress_version'))
{
/** @noinspection PhpUndefinedFunctionInspection */
return classicpress_version();
}
if (isset($cp_version))
{
return $cp_version;
}
/** @noinspection PhpUndefinedVariableInspection */
return $wp_version;
}
}PK \F6 C vendor/akeeba/stats_collector/src/CmsInfo/Adapter/JoomlaAdapter.phpnu [
Order allow,deny
Deny from all
PK \Sʉ 3 vendor/akeeba/stats_collector/src/CmsInfo/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ + vendor/akeeba/stats_collector/src/.htaccessnu 7m
Order allow,deny
Deny from all
PK \|]@
E vendor/akeeba/stats_collector/src/CommonVariables/CommonVariables.phpnu [ getAdapter();
return ($adapter === null) ? $default : $adapter->getCommonVariable($key, $default);
}
/**
* Set a variable to the common variables table.
*
* @param string $key The key to set
* @param string|null $value The value to set
*
* @return void
* @since 1.0.0
*/
public function setCommonVariable(string $key, ?string $value): void
{
$adapter = $this->getAdapter();
if (empty($adapter))
{
return;
}
$adapter->setCommonVariable($key, $value);
}
/**
* Get the appropriate adapter for handling common variables
*
* @return AdapterInterface|null
* @since 1.0.0
*/
private function getAdapter(): ?AdapterInterface
{
if ($this->adapter !== null)
{
return $this->adapter;
}
foreach (self::ADAPTERS as $className)
{
if (!class_exists($className))
{
continue;
}
/** @var AdapterInterface $o */
$o = new $className;
if (!$o->isAvailable())
{
continue;
}
return $this->adapter = $o;
}
return null;
}
}PK \ˡ\p Q vendor/akeeba/stats_collector/src/CommonVariables/Adapter/AkeebaEngineAdapter.phpnu [ getDatabase();
if ($db === null)
{
return $default;
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('value'))
->from($db->qn('#__akeeba_common'))
->where($db->qn('key') . ' = ' . $db->q($key));
try
{
$db->setQuery($query);
$result = $db->loadResult();
}
catch (Throwable $e)
{
$result = $default;
}
return $result;
}
/**
* @inheritDoc
*/
public function setCommonVariable(string $key, ?string $value): void
{
$db = $this->getDatabase();
if ($db === null)
{
return;
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('COUNT(*)')
->from($db->qn('#__akeeba_common'))
->where($db->qn('key') . ' = ' . $db->q($key));
try
{
$db->setQuery($query);
$count = $db->loadResult();
}
catch (Throwable $e)
{
return;
}
if (!$count)
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->insert($db->qn('#__akeeba_common'))
->columns([$db->qn('key'), $db->qn('value')])
->values($db->q($key) . ', ' . $db->q($value));
}
else
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn('#__akeeba_common'))
->set($db->qn('value') . ' = ' . $db->q($value))
->where($db->qn('key') . ' = ' . $db->q($key));
}
try
{
$db->setQuery($query)->execute();
}
catch (Throwable $e)
{
}
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return defined('AKEEBAENGINE')
&& class_exists(Factory::class)
&& class_exists(BaseDriver::class);
}
/**
* Get the database driver from the Akeeba Engine (backup engine)
*
* @return BaseDriver|null
* @since 1.0.0
*/
private function getDatabase(): ?BaseDriver
{
try
{
return Factory::getDatabase();
}
catch (Throwable $e)
{
return null;
}
}
}PK \ܡ N vendor/akeeba/stats_collector/src/CommonVariables/Adapter/WordPressAdapter.phpnu [ getDatabase();
if ($db === null)
{
return $default;
}
$tableName = $db->prefix . 'akeeba_common';
$query = 'SELECT `value` FROM `' . $tableName . '` WHERE `key` = %s';
$query = $db->prepare($query, $key);
return $db->get_var($query) ?? $default;
}
/**
* @inheritDoc
*/
public function setCommonVariable(string $key, ?string $value): void
{
$db = $this->getDatabase();
if ($db === null)
{
return;
}
$tableName = $db->prefix . 'akeeba_common';
$data = [
'key' => $key,
'value' => $value,
];
$db->replace($tableName, $data);
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return defined('WPINC') && ($this->getDatabase() !== null);
}
/**
* Get the WordPress database object
*
* @return wpdb|null
* @since 1.0.0
*/
private function getDatabase(): ?wpdb
{
global $wpdb;
if (!class_exists(wpdb::class) || !isset($wpdb) || (!$wpdb instanceof wpdb) || !$wpdb->is_mysql)
{
return null;
}
return $wpdb;
}
}PK \X`3 N vendor/akeeba/stats_collector/src/CommonVariables/Adapter/AdapterInterface.phpnu [ getContainer()->db;
}
catch (Throwable $e)
{
return $default;
}
if ($db === null)
{
return $default;
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->quoteName('value'))
->from($db->quoteName('#__akeeba_common'))
->where($db->quoteName('key') . ' = ' . $db->quote($key));
try
{
$db->setQuery($query);
$result = $db->loadResult();
}
catch (Throwable $e)
{
$result = $default;
}
return $result;
}
/**
* @inheritDoc
*/
public function setCommonVariable(string $key, ?string $value): void
{
try
{
$db = $this->getContainer()->db;
}
catch (Throwable $e)
{
return;
}
if ($db === null)
{
return;
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('COUNT(*)')
->from($db->quoteName('#__akeeba_common'))
->where($db->quoteName('key') . ' = ' . $db->quote($key));
try
{
$db->setQuery($query);
$count = $db->loadResult();
}
catch (Throwable $e)
{
return;
}
if (!$count)
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->insert($db->quoteName('#__akeeba_common'))
->columns([$db->quoteName('key'), $db->quoteName('value')])
->values($db->quote($key) . ', ' . $db->quote($value));
}
else
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->quoteName('#__akeeba_common'))
->set($db->quoteName('value') . ' = ' . $db->quote($value))
->where($db->quoteName('key') . ' = ' . $db->quote($key));
}
try
{
$db->setQuery($query)->execute();
}
catch (Throwable $e)
{
}
}
/**
* Returns the AWF container for the specific application
*
* @return Container
* @since 1.0.0
*/
protected abstract function getContainer(): Container;
}PK \Utl K vendor/akeeba/stats_collector/src/CommonVariables/Adapter/JoomlaAdapter.phpnu [ getDatabase();
if (!$db instanceof DatabaseInterface)
{
return $default;
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('value'))
->from($db->qn('#__akeeba_common'))
->where($db->qn('key') . ' = :key')
->bind(':key', $key);
try
{
$db->setQuery($query);
$result = $db->loadResult();
}
catch (Throwable $e)
{
$result = $default;
}
return $result;
}
/**
* @inheritDoc
*/
public function setCommonVariable(string $key, ?string $value): void
{
$db = $this->getDatabase();
if (!$db instanceof DatabaseInterface)
{
return;
}
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('COUNT(*)')
->from($db->qn('#__akeeba_common'))
->where($db->qn('key') . ' = :key')
->bind(':key', $key);
try
{
$db->setQuery($query);
$count = $db->loadResult();
}
catch (Throwable $e)
{
return;
}
try
{
$commonVariableObject = (object) [
'key' => $key,
'value' => $value,
];
if (!$count)
{
$db->insertObject('#__akeeba_common', $commonVariableObject);
}
else
{
$db->updateObject('#__akeeba_common', $commonVariableObject, 'key');
}
}
catch (Throwable $e)
{
}
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return defined('JVERSION')
&& version_compare(JVERSION, '4.0.0', 'ge')
&& defined('_JEXEC')
&& interface_exists(DatabaseInterface::class)
&& class_exists(Factory::class)
&& ($this->getDatabase() instanceof DatabaseInterface);
}
/**
* Get the Joomla database object
*
* @return DatabaseInterface|null
* @since 1.0.0
*/
private function getDatabase(): ?DatabaseInterface
{
try
{
return Factory::getContainer()->get(DatabaseInterface::class);
}
catch (Throwable $e)
{
return null;
}
}
}PK \How; Q vendor/akeeba/stats_collector/src/CommonVariables/Adapter/AdminToolsWPAdapter.phpnu [ getDatabase();
if ($db === null)
{
return $default;
}
try
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('value'))
->from($db->qn('#__akeeba_common'))
->where($db->qn('key') . ' = ' . $db->q($key));
$db->setQuery($query);
$result = $db->loadResult();
}
catch (Throwable $e)
{
$result = $default;
}
return $result;
}
/**
* @inheritDoc
*/
public function setCommonVariable(string $key, ?string $value): void
{
$db = $this->getDatabase();
if ($db === null)
{
return;
}
try
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('COUNT(*)')
->from($db->qn('#__akeeba_common'))
->where($db->qn('key') . ' = ' . $db->q($key));
$db->setQuery($query);
$count = $db->loadResult();
}
catch (Throwable $e)
{
return;
}
if (!$count)
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->insert($db->qn('#__akeeba_common'))
->columns([$db->qn('key'), $db->qn('value')])
->values($db->q($key) . ', ' . $db->q($value));
}
else
{
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn('#__akeeba_common'))
->set($db->qn('value') . ' = ' . $db->q($value))
->where($db->qn('key') . ' = ' . $db->q($key));
}
try
{
$db->setQuery($query)->execute();
}
catch (Throwable $e)
{
}
}
/**
* @inheritDoc
*/
public function isAvailable(): bool
{
return class_exists(Driver::class) && ($this->getDatabase() !== null);
}
/**
* Get the WordPress database object
*
* @return Driver|null
* @since 1.0.0
*/
private function getDatabase(): ?Driver
{
try
{
return Wordpress::getDb();
}
catch (Throwable $e)
{
return null;
}
}
}PK \Sʉ C vendor/akeeba/stats_collector/src/CommonVariables/Adapter/.htaccessnu 7m
Order allow,deny
Deny from all
PK \h{ M vendor/akeeba/stats_collector/src/CommonVariables/Adapter/DarkLinkAdapter.phpnu [
Order allow,deny
Deny from all
PK \Sʉ ' vendor/akeeba/stats_collector/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Y/ / " vendor/akeeba/engine/composer.jsonnu [ {
"name": "akeeba/engine",
"type": "library",
"description": "Akeeba Engine - a site backup engine written in pure PHP",
"keywords": [
"backup",
"php",
"mysql"
],
"homepage": "https://github.com/akeeba/engine",
"license": "GPL-3.0-or-later",
"authors": [
{
"name": "Nicholas K. Dionysopoulos",
"email": "nicholas_NO_SPAM_PLEASE@akeeba.com",
"homepage": "https://www.dionysopoulos.me",
"role": "Lead Developer"
},
{
"name": "Davide Tampellini",
"email": "davide_NO_SPAM_PLEASE@akeeba.com",
"homepage": "https://www.dionysopoulos.me",
"role": "Senior Developer"
}
],
"require": {
"akeeba/s3": "dev-development",
"greenlion/php-sql-parser": "^4.6.0",
"php": "^7.4.0|^8.0",
"ext-fileinfo": "*",
"ext-json": "*",
"ext-mbstring": "*"
},
"require-dev": {
"phpunit/phpunit": "^9.0.0",
"rector/rector": "^0.15.21",
"mnapoli/silly": "^1.8.3",
"composer/ca-bundle": "^1.3.6",
"joomla/uri": "^3.0-dev"
},
"suggest": {
"ext-curl": "*",
"ext-dom": "*",
"ext-ftp": "*",
"ext-mysqli": "*",
"ext-openssl": "*",
"ext-pdo": "*",
"ext-simplexml": "*",
"ext-sqlite3": "*",
"ext-ssh2": "*",
"ext-zip": "*"
},
"platform": {
"php": "7.4.999"
},
"autoload": {
"psr-4": {
"Akeeba\\Engine\\": "engine/"
}
},
"autoload-dev": {
"psr-4": {
"Akeeba\\Engine\\DevPlatform\\": "dev_platform/",
"Akeeba\\Engine\\Filter\\": "dev_platform/Platform/Filter/",
"Akeeba\\Engine\\Platform\\": "dev_platform/Platform/",
"Akeeba\\Engine\\Test\\": "Test/"
}
},
"scripts": {
"test": "phpunit"
},
"archive": {
"exclude": [
"binned_ideas", "connector_development", "dev_platform", "run", "Test", "tools"
]
}
}PK \B
- vendor/akeeba/engine/run-integration-tests.shnu [ #!/usr/bin/env bash
# =============================================================================
# Akeeba Engine — MySQL/MariaDB integration test runner
#
# Spins up ephemeral Docker containers for each configured server version,
# runs the PHPUnit integration suite against each one, then tears them down.
#
# Usage:
# ./run-integration-tests.sh # test all configured images
# ./run-integration-tests.sh mysql:8.0 # test one specific image
#
# Override the database password or name via environment variables:
# DB_PASSWORD=secret DB_NAME=mydb ./run-integration-tests.sh
#
# Requirements: Docker, PHP CLI (with mysqli and PDO/mysql extensions)
# =============================================================================
set -euo pipefail
# ---------------------------------------------------------------------------
# Configuration — edit here to add or remove server versions
# ---------------------------------------------------------------------------
DEFAULT_IMAGES=(
"mysql:8.0"
"mysql:8.4"
"mariadb:11.4"
"mariadb:12.3"
)
# Host port that Docker will map to the container's 3306.
# Change this if 13306 is already occupied on your machine.
DB_HOST_PORT="${DB_HOST_PORT:-13306}"
# Database credentials used inside the container.
DB_PASSWORD="${DB_PASSWORD:-akeebatest}"
DB_NAME="${DB_NAME:-akeebatest}"
# How long (in seconds × 2) to wait for the server to become ready.
MAX_WAIT_TRIES=60
# ---------------------------------------------------------------------------
# Resolve which images to test
# ---------------------------------------------------------------------------
if [ "${1:-}" != "" ]; then
IMAGES=("$1")
else
IMAGES=("${DEFAULT_IMAGES[@]}")
fi
# ---------------------------------------------------------------------------
# Helpers
# ---------------------------------------------------------------------------
CONTAINER_NAME="akeebaengine_integration_$$"
FAILED=0
cleanup_container() {
docker stop "$CONTAINER_NAME" >/dev/null 2>&1 || true
docker rm "$CONTAINER_NAME" >/dev/null 2>&1 || true
}
wait_for_db() {
local tries=0
echo " Waiting for database server to accept connections..."
until docker exec "$CONTAINER_NAME" mysql \
--user=root \
"--password=${DB_PASSWORD}" \
--execute="SELECT 1" \
"${DB_NAME}" >/dev/null 2>&1
do
tries=$((tries + 1))
if [ $tries -ge $MAX_WAIT_TRIES ]; then
echo " Timed out after $((MAX_WAIT_TRIES * 2)) seconds."
return 1
fi
sleep 2
done
echo " Database is ready."
return 0
}
run_tests_against() {
local image="$1"
echo ""
echo "=========================================="
echo " Image : $image"
echo "=========================================="
# Remove any leftover container with the same name.
cleanup_container
# Start the container. Both MYSQL_* and MARIADB_* env vars are supplied
# so the image works regardless of which set it recognises.
docker run --detach \
--name "$CONTAINER_NAME" \
--env "MYSQL_ROOT_PASSWORD=${DB_PASSWORD}" \
--env "MARIADB_ROOT_PASSWORD=${DB_PASSWORD}" \
--env "MYSQL_DATABASE=${DB_NAME}" \
--env "MARIADB_DATABASE=${DB_NAME}" \
--publish "127.0.0.1:${DB_HOST_PORT}:3306" \
"$image" >/dev/null
if ! wait_for_db; then
echo " FAILED: server did not become ready ($image)"
cleanup_container
return 1
fi
# Run the PHPUnit integration suite with the connection details exported.
if INTEGRATION_DB_HOST=127.0.0.1 \
INTEGRATION_DB_PORT="$DB_HOST_PORT" \
INTEGRATION_DB_USER=root \
INTEGRATION_DB_PASSWORD="$DB_PASSWORD" \
INTEGRATION_DB_NAME="$DB_NAME" \
vendor/bin/phpunit --configuration phpunit.integration.xml; then
echo ""
echo " PASSED: $image"
else
echo ""
echo " FAILED: $image (test failures above)"
cleanup_container
return 1
fi
cleanup_container
return 0
}
# ---------------------------------------------------------------------------
# Main loop
# ---------------------------------------------------------------------------
for IMAGE in "${IMAGES[@]}"; do
if ! run_tests_against "$IMAGE"; then
FAILED=$((FAILED + 1))
fi
done
# ---------------------------------------------------------------------------
# Summary
# ---------------------------------------------------------------------------
echo ""
echo "=========================================="
TOTAL="${#IMAGES[@]}"
PASSED=$((TOTAL - FAILED))
echo " Results: $PASSED/$TOTAL image(s) passed"
echo "=========================================="
if [ $FAILED -ne 0 ]; then
exit 1
fi
PK \v 5 vendor/akeeba/engine/engine/Filter/Regexskipfiles.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Directory contents (files) exclusion filter based on regular expressions
*/
class Regexskipfiles extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'content';
$this->method = 'regex';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \xUC . vendor/akeeba/engine/engine/Filter/Multidb.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Multiple Database inclusion filter
*/
class Multidb extends Base
{
public function __construct()
{
$this->object = 'db';
$this->subtype = 'inclusion';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \8A - vendor/akeeba/engine/engine/Filter/Tables.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Database table exclusion filter
*/
class Tables extends Base
{
public function __construct()
{
$this->object = 'dbobject';
$this->subtype = 'all';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \+gL L 0 vendor/akeeba/engine/engine/Filter/Tabledata.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Database table records exclusion filter
*
* This is simple stuff. If a table's on the list, it will backup just its structure, not
* its contents. Fair and square...
*/
class Tabledata extends Base
{
public function __construct()
{
$this->object = 'dbobject';
$this->subtype = 'content';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \ 5 7 vendor/akeeba/engine/engine/Filter/Regexdirectories.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Directory exclusion filter based on regular expressions
*/
class Regexdirectories extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'all';
$this->method = 'regex';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \$ : vendor/akeeba/engine/engine/Filter/Tablesalwaysskipped.phpnu [ .
*/
/**
* @package Akeeba\Engine\Filter
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
class Tablesalwaysskipped extends Base
{
private $skipTablesWithBackticks = false;
public function __construct()
{
$this->object = 'dbobject';
$this->subtype = 'content';
$this->method = 'api';
parent::__construct();
}
/**
* This method must be overridden by API-type exclusion filters.
*
* @param string $test The object to test for exclusion
* @param string $root The object's root
*
* @return bool Return true if it matches your filters
*/
protected function is_excluded_by_api($test, $root)
{
static $alwaysExcludeTables = [
// Tables from a certain service connector
'bf_core_hashes',
'bf_files',
'bf_files_last',
'bf_folders',
'bf_folders_to_scan',
];
// Is it one of the always excluded tables?
if (in_array($test, $alwaysExcludeTables))
{
return true;
}
// Tables with backticks in their name
if ($this->skipTablesWithBackticks && strpos($test, '`') !== false)
{
return true;
}
return false;
}
}PK \\ 0 vendor/akeeba/engine/engine/Filter/Extradirs.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Extra Directories inclusion filter
*/
class Extradirs extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'inclusion';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \S
/ 1 vendor/akeeba/engine/engine/Filter/Regexfiles.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Files exclusion filter based on regular expressions
*/
class Regexfiles extends Base
{
public function __construct()
{
$this->object = 'file';
$this->subtype = 'all';
$this->method = 'regex';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \ؿ ; vendor/akeeba/engine/engine/Filter/Stack/StackHoststats.phpnu [ .
*/
namespace Akeeba\Engine\Filter\Stack;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Filter\Base;
/**
* Exclude folders and files belonging to the host web stat (ie Webalizer)
*/
class StackHoststats extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'all';
$this->method = 'api';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
protected function is_excluded_by_api($test, $root)
{
if ($test == 'stats')
{
return true;
}
// No match? Just include the file!
return false;
}
}
PK \ [Y Y A vendor/akeeba/engine/engine/Filter/Stack/StackDateconditional.phpnu [ .
*/
namespace Akeeba\Engine\Filter\Stack;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Filter\Base;
/**
* Date conditional filter
*
* It will only backup files modified after a specific date and time
*/
class StackDateconditional extends Base
{
public function __construct()
{
$this->object = 'file';
$this->subtype = 'all';
$this->method = 'api';
}
protected function is_excluded_by_api($test, $root)
{
static $from_datetime;
$config = Factory::getConfiguration();
if (is_null($from_datetime))
{
$user_setting = $config->get('core.filters.dateconditional.start');
$from_datetime = strtotime($user_setting);
}
// Get the filesystem path for $root
$fsroot = $config->get('volatile.filesystem.current_root', '');
$ds = ($fsroot == '') || ($fsroot == '/') ? '' : DIRECTORY_SEPARATOR;
$filename = $fsroot . $ds . $test;
// Get the timestamp of the file
$timestamp = @filemtime($filename);
// If we could not get this information, include the file in the archive
if ($timestamp === false)
{
return false;
}
// Compare it with the user-defined minimum timestamp and exclude if it's older than that
if ($timestamp <= $from_datetime)
{
return true;
}
// No match? Just include the file!
return false;
}
}
PK \ > 4 vendor/akeeba/engine/engine/Filter/Stack/README.htmlnu [
AkeebaBackup :: Filter Stack
What is this directory?
In this directory, Akeeba Backup and Akeeba Solo store the optional filters (Optional Filters in the Configuration
page). Unlike regular filters which are always loaded, optional filters are only loaded when the user chooses to
enable them. Each filter consists of two files: filtername.ini and filtername.php. The former
contains the filter-specific configuration options and the later contains the actual filter code.
If you want to create new optional filters, put them in here. Do note that the INI file must always contain a
boolean key named core.filters.filtername.enabled which controls the loading of this particular filter.
Optional filters are always named Akeeba\Engine\Filter\Stack\StackFiltername so that the autoloader can
find them. For the same reason their filename must be StackFiltername.php Please watch out for the
letter case in the names, it's important.
PK \&Y 7 vendor/akeeba/engine/engine/Filter/Stack/errorlogs.jsonnu [ {
"core.filters.errorlogs.enabled": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_ERRORLOGS_ENABLED_TITLE",
"description": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_ERRORLOGS_ENABLED_DESCRIPTION",
"bold": "1"
}
}PK \=}TC ; vendor/akeeba/engine/engine/Filter/Stack/StackErrorlogs.phpnu [ .
*/
namespace Akeeba\Engine\Filter\Stack;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Filter\Base;
/**
* Files exclusion filter based on regular expressions
*/
class StackErrorlogs extends Base
{
function __construct()
{
$this->object = 'file';
$this->subtype = 'all';
$this->method = 'api';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
protected function is_excluded_by_api($test, $root)
{
// Is it an error log? Exclude the file.
if (in_array(basename($test), [
'php_error',
'php_errorlog',
'error_log',
'error.log',
]))
{
return true;
}
// No match? Just include the file!
return false;
}
}
PK \ = vendor/akeeba/engine/engine/Filter/Stack/dateconditional.jsonnu [ {
"core.filters.dateconditional.enabled": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_DATECONDITIONAL_ENABLED_TITLE",
"description": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_DATECONDITIONAL_ENABLED_DESCRIPTION",
"bold": "1"
},
"core.filters.dateconditional.start": {
"default": "1970-01-01 00:00 GMT",
"type": "string",
"title": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_DATECONDITIONAL_START_TITLE",
"description": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_DATECONDITIONAL_START_DESCRIPTION",
"showon": "core.filters.dateconditional.enabled:1"
}
}PK \D 7 vendor/akeeba/engine/engine/Filter/Stack/hoststats.jsonnu [ {
"core.filters.hoststats.enabled": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_HOSTSTATS_ENABLED_TITLE",
"description": "COM_AKEEBA_CONFIG_OPTIONALFILTERS_HOSTSTATS_ENABLED_DESCRIPTION",
"bold": "1"
}
}PK \Sʉ 2 vendor/akeeba/engine/engine/Filter/Stack/.htaccessnu 7m
Order allow,deny
Deny from all
PK \T~P P 5 vendor/akeeba/engine/engine/Filter/Regextabledata.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Database table records exclusion filter
*
* This is simple stuff. If a table's on the list, it will backup just its structure, not
* its contents. Fair and square...
*/
class Regextabledata extends Base
{
public function __construct()
{
$this->object = 'dbobject';
$this->subtype = 'content';
$this->method = 'regex';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \; 0 vendor/akeeba/engine/engine/Filter/Skipfiles.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Directory contents (files) exclusion filter
*/
class Skipfiles extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'content';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \o2 4 vendor/akeeba/engine/engine/Filter/Regexskipdirs.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Subdirectories exclusion filter based on regular expressions
*/
class Regexskipdirs extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'children';
$this->method = 'regex';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \Θ7g g 2 vendor/akeeba/engine/engine/Filter/Incremental.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use DateTime;
use DateTimeZone;
/**
* Incremental file filter
*
* It will only backup files which are newer than the last backup taken with this profile
*/
class Incremental extends Base
{
public function __construct()
{
$this->object = 'file';
$this->subtype = 'all';
$this->method = 'api';
}
protected function is_excluded_by_api($test, $root)
{
static $filter_switch = null;
static $last_backup = null;
if (is_null($filter_switch))
{
$config = Factory::getConfiguration();
$filter_switch = Factory::getEngineParamsProvider()->getScriptingParameter('filter.incremental', 0);
$filter_switch = ($filter_switch == 1);
$last_backup = $config->get('volatile.filter.last_backup', null);
if (is_null($last_backup) && $filter_switch)
{
// Get a list of backups on this profile
$backups = Platform::getInstance()->get_statistics_list([
'filters' => [
[
'field' => 'profile_id',
'value' => Platform::getInstance()->get_active_profile(),
],
],
]);
// Find this backup's ID
$model = Factory::getStatistics();
$id = $model->getId();
if (is_null($id))
{
$id = -1;
}
// Initialise
$last_backup = time();
$now = $last_backup;
// Find the last time a successful backup with this profile was made
if (count($backups))
{
foreach ($backups as $backup)
{
// Skip the current backup
if ($backup['id'] == $id)
{
continue;
}
// Skip non-complete backups
if ($backup['status'] != 'complete')
{
continue;
}
$tzUTC = new DateTimeZone('UTC');
$dateTime = new DateTime($backup['backupstart'], $tzUTC);
$backuptime = $dateTime->getTimestamp();
$last_backup = $backuptime;
break;
}
}
if ($last_backup == $now)
{
// No suitable backup found; disable this filter
$config->set('volatile.scripting.incfile.filter.incremental', 0);
$filter_switch = false;
}
else
{
// Cache the last backup timestamp
$config->set('volatile.filter.last_backup', $last_backup);
}
}
}
if (!$filter_switch)
{
return false;
}
// Get the filesystem path for $root
$config = Factory::getConfiguration();
$fsroot = $config->get('volatile.filesystem.current_root', '');
$ds = ($fsroot == '') || ($fsroot == '/') ? '' : DIRECTORY_SEPARATOR;
$filename = $fsroot . $ds . $test;
// Get the timestamp of the file
$timestamp = @filemtime($filename);
// If we could not get this information, include the file in the archive
if ($timestamp === false)
{
return false;
}
// Compare it with the last backup timestamp and exclude if it's older than the last backup
if ($timestamp <= $last_backup)
{
//Factory::getLog()->debug("Excluding $filename due to incremental backup restrictions");
return true;
}
// No match? Just include the file!
return false;
}
}
PK \Z1~? ? + vendor/akeeba/engine/engine/Filter/Base.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\FileSystem;
abstract class Base
{
/** @var string Filter's internal name; defaults to filename without .php extension */
public $filter_name = '';
/** @var string The filtering object: dir|file|dbobject|db */
public $object = 'dir';
/** @var string The filtering subtype (all|content|children|inclusion) */
public $subtype = null;
/** @var string The filtering method (direct|regex|api) */
public $method = 'direct';
/** @var bool Is the filter active? */
public $enabled = true;
/** @var array An array holding filter or regex strings per root, i.e. $filter_data[$root] = array() */
protected $filter_data = null;
/** @var FileSystem Used by treatDirectory */
protected $fsTools = null;
/**
* Public constructor
*/
public function __construct()
{
// Set the filter name if it's missing (filename in lowercase, minus the .php extension)
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
}
/**
* Extra SQL statements to append to the SQL dump file. Useful for extension
* filters which have to filter out specific database records. This method
* must be overridden in children classes.
*
* @param string $root The database for which to get the extra SQL statements
*
* @return array Extra SQL statements
*/
public function getExtraSQL(string $root): array
{
return [];
}
public $canFilterDatabaseRowContent = false;
public function filterDatabaseRowContent(string $root, string $tableAbstract, array &$row): void
{
// No operation
}
/**
* Returns filtering (exclusion) status of the $test object
*
* @param string $test The string to check for filter status (e.g. filename, dir name, table name, etc)
* @param string $root The exclusion root test belongs to
* @param string $object What type of object is it? dir|file|dbobject
* @param string $subtype Filter subtype (all|content|children)
*
* @return bool True if it excluded, false otherwise
*/
public function isFiltered($test, $root, $object, $subtype)
{
if (!$this->enabled)
{
return false;
}
//Factory::getLog()->log(LogLevel::DEBUG,"Filtering [$object:$subtype] $root // $test");
// Inclusion filters do not qualify for exclusion
if ($this->subtype == 'inclusion')
{
return false;
}
// The object and subtype must match
if (($this->object != $object) || ($this->subtype != $subtype))
{
return false;
}
if (in_array($this->method, ['direct', 'regex']))
{
// -- Direct or regex based filters --
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
// Check if the root exists and if there's a filter for the $test
if (!array_key_exists($root, $this->filter_data))
{
// Root not found
return false;
}
else
{
// Root found, search in the array
if ($this->method == 'direct')
{
// Direct filtering
return in_array($test, $this->filter_data[$root]);
}
else
{
// Regex matching
foreach ($this->filter_data[$root] as $regex)
{
if (substr($regex, 0, 1) == '!')
{
// Custom Akeeba Backup extension to PCRE notation. If you put a ! before the PCRE, it negates the result of the PCRE.
if (!preg_match(substr($regex, 1), $test))
{
return true;
}
}
else
{
// Normal PCRE
if (preg_match($regex, $test))
{
return true;
}
}
}
// if we're here, no match exists
return false;
}
}
}
else
{
// -- API-based filters --
return $this->is_excluded_by_api($test, $root);
}
}
/**
* Returns the inclusion filters defined by this class for the requested $object
*
* @param string $object The object to get inclusions for (dir|db)
*
* @return array The inclusion filters
*/
public function &getInclusions($object)
{
$dummy = [];
if (!$this->enabled)
{
return $dummy;
}
if (($this->subtype != 'inclusion') || ($this->object != $object))
{
return $dummy;
}
switch ($this->method)
{
case 'api':
return $this->get_inclusions_by_api();
break;
case 'direct':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
return $this->filter_data;
break;
default:
// regex inclusion is not supported at the moment
$dummy = [];
return $dummy;
break;
}
}
/**
* Adds an exclusion filter, or add/replace an inclusion filter
*
* @param string $root Filter's root
* @param mixed $test Exclusion: the filter string. Inclusion: the root definition data
*
* @return bool True on success
*/
public function set($root, $test)
{
if (in_array($this->subtype, ['all', 'content', 'children']))
{
return $this->setExclusion($root, $test);
}
else
{
return $this->setInclusion($root, $test);
}
}
/**
* Unsets a given filter
*
* @param string $root Filter's root
* @param string $test The filter to remove
*
* @return bool
*/
public function remove($root, $test = null)
{
if ($this->subtype == 'inclusion')
{
return $this->removeInclusion($root);
}
else
{
return $this->removeExclusion($root, $test);
}
}
/**
* Completely removes all filters off a specific root
*
* @param string $root
*
* @return bool
*/
public function reset($root)
{
switch ($this->method)
{
default:
case 'api':
return false;
break;
case 'direct':
case 'regex':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
// Direct filters
if (array_key_exists($root, $this->filter_data))
{
unset($this->filter_data[$root]);
}
else
{
// Root not found
return false;
}
break;
}
$filters = Factory::getFilters();
$filters->setFilterData($this->filter_name, $this->filter_data);
return true;
}
/**
* Toggles a filter
*
* @param string $root The filter root object
* @param string $test The filter string to toggle
* @param bool $new_status The new filter status after the operation (true: enabled, false: disabled)
*
* @return bool True on successful change, false if we failed to change it
*/
public function toggle($root, $test, &$new_status)
{
// Can't toggle inclusion filters!
if ($this->subtype == 'inclusion')
{
return false;
}
$is_set = $this->isFiltered($test, $root, $this->object, $this->subtype);
$new_status = !$is_set;
if ($is_set)
{
$status = $this->remove($root, $test);
}
else
{
$status = $this->set($root, $test);
}
if (!$status)
{
$new_status = $is_set;
}
return $status;
}
/**
* Does this class has any filters? If it doesn't, its methods are never called by
* Akeeba's engine to speed things up.
* @return bool
*/
public function hasFilters()
{
if (!$this->enabled)
{
return false;
}
switch ($this->method)
{
default:
case 'api':
// API filters always have data!
return true;
break;
case 'direct':
case 'regex':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
return !empty($this->filter_data);
break;
}
}
/**
* Returns a list of filter strings for the given root. Used by MySQLDump engine.
*
* @param string $root
*
* @return array
*/
public function getFilters($root)
{
$dummy = [];
if (!$this->enabled)
{
return $dummy;
}
switch ($this->method)
{
default:
case 'api':
// API filters never have a list
return $dummy;
break;
case 'direct':
case 'regex':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
if (is_null($root))
{
// When NULL is passed as the root, we return all roots
return $this->filter_data;
}
elseif (array_key_exists($root, $this->filter_data))
{
// The root exists, return its data
return $this->filter_data[$root];
}
else
{
// The root doesn't exist, return an empty array
return $dummy;
}
break;
}
}
/**
* This method must be overriden by API-type exclusion filters.
*
* @param string $test The object to test for exclusion
* @param string $root The object's root
*
* @return bool Return true if it matches your filters
*
* @codeCoverageIgnore
*/
protected function is_excluded_by_api($test, $root)
{
return false;
}
/**
* This method must be overriden by API-type inclusion filters.
*
* @return array The inclusion filters
*
* @codeCoverageIgnore
*/
protected function &get_inclusions_by_api()
{
$dummy = [];
return $dummy;
}
/**
* Remove the root prefix from an absolute path
*
* @param string $directory The absolute path
*
* @return string The translated path, relative to the root directory of the backup job
*/
protected function treatDirectory($directory)
{
if (!is_object($this->fsTools))
{
$this->fsTools = Factory::getFilesystemTools();
}
// Get the site's root
$configuration = Factory::getConfiguration();
if ($configuration->get('akeeba.platform.override_root', 0))
{
$root = $configuration->get('akeeba.platform.newroot', '[SITEROOT]');
}
else
{
$root = '[SITEROOT]';
}
if (stristr($root, '['))
{
$root = $this->fsTools->translateStockDirs($root);
}
$site_root = $this->fsTools->TrimTrailingSlash($this->fsTools->TranslateWinPath($root));
$directory = $this->fsTools->TrimTrailingSlash($this->fsTools->TranslateWinPath($directory));
// Trim site root from beginning of directory
if (substr($directory, 0, strlen($site_root)) == $site_root)
{
$directory = substr($directory, strlen($site_root));
if (substr($directory, 0, 1) == '/')
{
$directory = substr($directory, 1);
}
}
return $directory;
}
/**
* Sets a filter, for direct and regex exclusion filter types
*
* @param string $root The filter root object
* @param string $test The filter string to set
*
* @return bool True on success
*
* @codeCoverageIgnore
*/
private function setExclusion($root, $test)
{
switch ($this->method)
{
default:
case 'api':
// we can't set new filter elements for API-type filters
return false;
break;
case 'direct':
case 'regex':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
// Direct filters
if (array_key_exists($root, $this->filter_data))
{
if (!in_array($test, $this->filter_data[$root]))
{
$this->filter_data[$root][] = $test;
}
else
{
return false;
}
}
else
{
$this->filter_data[$root] = [$test];
}
break;
}
$filters = Factory::getFilters();
$filters->setFilterData($this->filter_name, $this->filter_data);
return true;
}
/**
* Sets a filter, for direct inclusion filter types
*
* @param string $root The inclusion filter key (root)
* @param string $test The inclusion filter raw data
*
* @return bool True on success
*
* @codeCoverageIgnore
*/
private function setInclusion($root, $test)
{
switch ($this->method)
{
default:
case 'api':
case 'regex':
// we can't set new filter elements for API or regex type filters
return false;
break;
case 'direct':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
$this->filter_data[$root] = $test;
break;
}
$filters = Factory::getFilters();
$filters->setFilterData($this->filter_name, $this->filter_data);
return true;
}
/**
* Remove a key from direct and regex filters
*
* @param string $root The filter root object
* @param string $test The filter string to set
*
* @return bool True on success
*
* @codeCoverageIgnore
*/
private function removeExclusion($root, $test)
{
switch ($this->method)
{
default:
case 'api':
// we can't remove filter elements from API-type filters
return false;
break;
case 'direct':
case 'regex':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
// Direct filters
if (array_key_exists($root, $this->filter_data))
{
if (in_array($test, $this->filter_data[$root]))
{
if (count($this->filter_data[$root]) == 1)
{
// If it's the only element, remove the entire root key
unset($this->filter_data[$root]);
}
else
{
// If there are more elements, remove just the $test value
$key = array_search($test, $this->filter_data[$root]);
unset($this->filter_data[$root][$key]);
}
}
else
{
// Filter object not found
return false;
}
}
else
{
// Root not found
return false;
}
break;
}
$filters = Factory::getFilters();
$filters->setFilterData($this->filter_name, $this->filter_data);
return true;
}
/**
* Remove an inclusion filter
*
* @param string $root The root of the filter to remove
*
* @return bool
*
* @codeCoverageIgnore
*/
private function removeInclusion($root)
{
switch ($this->method)
{
default:
case 'api':
case 'regex':
// we can't remove filter elements from API or regex type filters
return false;
break;
case 'direct':
// Get a local reference of the filter data, if necessary
if (is_null($this->filter_data))
{
$filters = Factory::getFilters();
$this->filter_data = $filters->getFilterData($this->filter_name);
}
if (array_key_exists($root, $this->filter_data))
{
unset($this->filter_data[$root]);
}
else
{
// Root not found
return false;
}
break;
}
$filters = Factory::getFilters();
$filters->setFilterData($this->filter_name, $this->filter_data);
return true;
}
}
PK \"`m 2 vendor/akeeba/engine/engine/Filter/Regextables.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Database table exclusion filter
*/
class Regextables extends Base
{
public function __construct()
{
$this->object = 'dbobject';
$this->subtype = 'all';
$this->method = 'regex';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \Y龾 / vendor/akeeba/engine/engine/Filter/Skipdirs.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Subdirectories exclusion filter
*/
class Skipdirs extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'children';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \oK , vendor/akeeba/engine/engine/Filter/Files.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Files exclusion filter
*/
class Files extends Base
{
public function __construct()
{
$this->object = 'file';
$this->subtype = 'all';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \E 2 vendor/akeeba/engine/engine/Filter/Directories.phpnu [ .
*/
namespace Akeeba\Engine\Filter;
defined('AKEEBAENGINE') || die();
/**
* Directory exclusion filter
*/
class Directories extends Base
{
public function __construct()
{
$this->object = 'dir';
$this->subtype = 'all';
$this->method = 'direct';
if (empty($this->filter_name))
{
$this->filter_name = strtolower(basename(__FILE__, '.php'));
}
parent::__construct();
}
}
PK \Sʉ , vendor/akeeba/engine/engine/Filter/.htaccessnu 7m
Order allow,deny
Deny from all
PK \}LV V 3 vendor/akeeba/engine/engine/Psr/Log/LoggerTrait.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
/**
* This is a simple Logger trait that classes unable to extend AbstractLogger
* (because they extend another class, etc) can include.
*
* It simply delegates all log-level-specific methods to the `log` method to
* reduce boilerplate code that a simple Logger that does the same thing with
* messages regardless of the error level has to implement.
*/
trait LoggerTrait
{
/**
* System is unusable.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function emergency($message, array $context = [])
{
$this->log(LogLevel::EMERGENCY, $message, $context);
}
/**
* Action must be taken immediately.
*
* Example: Entire website down, database unavailable, etc. This should
* trigger the SMS alerts and wake you up.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function alert($message, array $context = [])
{
$this->log(LogLevel::ALERT, $message, $context);
}
/**
* Critical conditions.
*
* Example: Application component unavailable, unexpected exception.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function critical($message, array $context = [])
{
$this->log(LogLevel::CRITICAL, $message, $context);
}
/**
* Runtime errors that do not require immediate action but should typically
* be logged and monitored.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function error($message, array $context = [])
{
$this->error($message, $context);
}
/**
* Exceptional occurrences that are not errors.
*
* Example: Use of deprecated APIs, poor use of an API, undesirable things
* that are not necessarily wrong.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function warning($message, array $context = [])
{
$this->warning($message, $context);
}
/**
* Normal but significant events.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function notice($message, array $context = [])
{
$this->log(LogLevel::NOTICE, $message, $context);
}
/**
* Interesting events.
*
* Example: User logs in, SQL logs.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function info($message, array $context = [])
{
$this->info($message, $context);
}
/**
* Detailed debug information.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function debug($message, array $context = [])
{
$this->debug($message, $context);
}
/**
* Logs with an arbitrary level.
*
* @param mixed $level
* @param string $message
* @param array $context
*
* @return null
*/
abstract public function log($level, $message, array $context = []);
}
PK \悘N> > @ vendor/akeeba/engine/engine/Psr/Log/InvalidArgumentException.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
class InvalidArgumentException extends \InvalidArgumentException
{
}
PK \UL 0 vendor/akeeba/engine/engine/Psr/Log/LogLevel.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
/**
* Describes log levels
*/
class LogLevel
{
const EMERGENCY = 'emergency';
const ALERT = 'alert';
const CRITICAL = 'critical';
const ERROR = 'error';
const WARNING = 'warning';
const NOTICE = 'notice';
const INFO = 'info';
const DEBUG = 'debug';
}
PK \rs
8 vendor/akeeba/engine/engine/Psr/Log/LoggerAwareTrait.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
/**
* Basic Implementation of LoggerAwareInterface.
*/
trait LoggerAwareTrait
{
/** @var LoggerInterface */
protected $logger;
/**
* Sets a logger.
*
* @param LoggerInterface $logger
*/
public function setLogger(LoggerInterface $logger)
{
$this->logger = $logger;
}
}
PK \z 7 vendor/akeeba/engine/engine/Psr/Log/LoggerInterface.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
/**
* Describes a logger instance
*
* The message MUST be a string or object implementing __toString().
*
* The message MAY contain placeholders in the form: {foo} where foo
* will be replaced by the context data in key "foo".
*
* The context array can contain arbitrary data, the only assumption that
* can be made by implementors is that if an Exception instance is given
* to produce a stack trace, it MUST be in a key named "exception".
*
* See https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md
* for the full interface specification.
*/
interface LoggerInterface
{
/**
* System is unusable.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function emergency($message, array $context = []);
/**
* Action must be taken immediately.
*
* Example: Entire website down, database unavailable, etc. This should
* trigger the SMS alerts and wake you up.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function alert($message, array $context = []);
/**
* Critical conditions.
*
* Example: Application component unavailable, unexpected exception.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function critical($message, array $context = []);
/**
* Runtime errors that do not require immediate action but should typically
* be logged and monitored.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function error($message, array $context = []);
/**
* Exceptional occurrences that are not errors.
*
* Example: Use of deprecated APIs, poor use of an API, undesirable things
* that are not necessarily wrong.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function warning($message, array $context = []);
/**
* Normal but significant events.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function notice($message, array $context = []);
/**
* Interesting events.
*
* Example: User logs in, SQL logs.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function info($message, array $context = []);
/**
* Detailed debug information.
*
* @param string $message
* @param array $context
*
* @return null
*/
public function debug($message, array $context = []);
/**
* Logs with an arbitrary level.
*
* @param mixed $level
* @param string $message
* @param array $context
*
* @return null
*/
public function log($level, $message, array $context = []);
}
PK \v` < vendor/akeeba/engine/engine/Psr/Log/LoggerAwareInterface.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
/**
* Describes a logger-aware instance
*/
interface LoggerAwareInterface
{
/**
* Sets a logger instance on the object
*
* @param LoggerInterface $logger
*
* @return null
*/
public function setLogger(LoggerInterface $logger);
}
PK \N7 6 vendor/akeeba/engine/engine/Psr/Log/AbstractLogger.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
/**
* This is a simple Logger implementation that other Loggers can inherit from.
*
* It simply delegates all log-level-specific methods to the `log` method to
* reduce boilerplate code that a simple Logger that does the same thing with
* messages regardless of the error level has to implement.
*/
abstract class AbstractLogger implements LoggerInterface
{
/**
* System is unusable.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function emergency($message, array $context = [])
{
$this->log(LogLevel::EMERGENCY, $message, $context);
}
/**
* Action must be taken immediately.
*
* Example: Entire website down, database unavailable, etc. This should
* trigger the SMS alerts and wake you up.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function alert($message, array $context = [])
{
$this->log(LogLevel::ALERT, $message, $context);
}
/**
* Critical conditions.
*
* Example: Application component unavailable, unexpected exception.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function critical($message, array $context = [])
{
$this->log(LogLevel::CRITICAL, $message, $context);
}
/**
* Runtime errors that do not require immediate action but should typically
* be logged and monitored.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function error($message, array $context = [])
{
$this->log(LogLevel::ERROR, $message, $context);
}
/**
* Exceptional occurrences that are not errors.
*
* Example: Use of deprecated APIs, poor use of an API, undesirable things
* that are not necessarily wrong.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function warning($message, array $context = [])
{
$this->log(LogLevel::WARNING, $message, $context);
}
/**
* Normal but significant events.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function notice($message, array $context = [])
{
$this->log(LogLevel::NOTICE, $message, $context);
}
/**
* Interesting events.
*
* Example: User logs in, SQL logs.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function info($message, array $context = [])
{
$this->log(LogLevel::INFO, $message, $context);
}
/**
* Detailed debug information.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function debug($message, array $context = [])
{
$this->log(LogLevel::DEBUG, $message, $context);
}
}
PK \ӕB B 2 vendor/akeeba/engine/engine/Psr/Log/NullLogger.phpnu [ .
*/
namespace Akeeba\Engine\Psr\Log;
/**
* This file is part of a privately namespaced copy of PSR-3 version 1.
*
* You can find the original PSR-3 in https://www.php-fig.org/psr/psr-3/ and the original code in
* https://github.com/php-fig/log
*
* The license of the original code can be found below.
*
* Copyright (c) 2012 PHP Framework Interoperability Group
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
defined('AKEEBAENGINE') || die();
/**
* This Logger can be used to avoid conditional log calls
*
* Logging should always be optional, and if no logger is provided to your
* library creating a NullLogger instance to have something to throw logs at
* is a good way to avoid littering your code with `if ($this->logger) { }`
* blocks.
*/
class NullLogger extends AbstractLogger
{
/**
* Logs with an arbitrary level.
*
* @param mixed $level
* @param string $message
* @param array $context
*
* @return null
*/
public function log($level, $message, array $context = [])
{
// noop
}
}
PK \Sʉ - vendor/akeeba/engine/engine/Psr/Log/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ ) vendor/akeeba/engine/engine/Psr/.htaccessnu 7m
Order allow,deny
Deny from all
PK \c + vendor/akeeba/engine/engine/Scan/smart.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_SCAN_SMART_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_SCAN_SMART_DESCRIPTION"
},
"engine.scan.smart.large_dir_threshold": {
"default": "100",
"type": "integer",
"min": "0",
"max": "500",
"shortcuts": "20|50|100|200|300|400|500",
"scale": "1",
"uom": "",
"title": "COM_AKEEBA_CONFIG_LARGEDIRTHRESHOLD_TITLE",
"description": "COM_AKEEBA_CONFIG_LARGEDIRTHRESHOLD_DESCRIPTION"
},
"engine.scan.common.largefile": {
"default": "10485760",
"type": "integer",
"min": "1048576",
"max": "1048576000",
"shortcuts": "1048576|2097152|5242880|10485760|15728640|20971520|26214400|31457280|41943040|52428800|78643200|104857600",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_LARGEFILE_TITLE",
"description": "COM_AKEEBA_CONFIG_LARGEFILE_DESCRIPTION"
}
}PK \z*P P * vendor/akeeba/engine/engine/Scan/Smart.phpnu [ .
*/
namespace Akeeba\Engine\Scan;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\WarningException;
use Akeeba\Engine\Factory;
use DirectoryIterator;
use Exception;
use RuntimeException;
/* Windows system detection */
if (!defined('_AKEEBA_IS_WINDOWS'))
{
$isWindows = DIRECTORY_SEPARATOR == '\\';
if (function_exists('php_uname'))
{
$isWindows = stristr(php_uname(), 'windows');
}
define('_AKEEBA_IS_WINDOWS', $isWindows);
}
/**
* A filesystem scanner which uses opendir() and is smart enough to make large directories
* be scanned inside a step of their own.
*
* The idea is that if it's not the first operation of this step and the number of contained
* directories AND files is more than double the number of allowed files per fragment, we should
* break the step immediately.
*
*/
class Smart extends Base
{
public function getFiles($folder, &$position)
{
$registry = Factory::getConfiguration();
// Was the breakflag set BEFORE starting? -- This workaround is required due to PHP5 defaulting to assigning variables by reference
$breakflag_before_process = $registry->get('volatile.breakflag', false);
// Reset break flag before continuing
$breakflag = false;
// Initialize variables
$arr = [];
$false = false;
if (!@is_dir($folder) && !@is_dir($folder . '/'))
{
return $false;
}
$counter = 0;
$registry = Factory::getConfiguration();
$maxCounter = $registry->get('engine.scan.smart.large_dir_threshold', 100);
$allowBreakflag = ($registry->get('volatile.operation_counter', 0) != 0) && !$breakflag_before_process;
if (!@is_dir($folder))
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP reports it as not a folder.');
}
if (!@is_readable($folder))
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP reports it as not readable.');
}
try
{
$di = new DirectoryIterator($folder);
}
catch (Exception $e)
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP\'s DirectoryIterator reports the path cannot be opened.', 0, $e);
}
if (!$di->valid())
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP\'s DirectoryIterator could open the folder but immediately reports itself as not valid. If this happens your server is about to die.');
}
$ds = ($folder == '') || ($folder == '/') || (@substr($folder, -1) == '/') || (@substr($folder, -1) == DIRECTORY_SEPARATOR) ? '' : DIRECTORY_SEPARATOR;
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if ($breakflag)
{
break;
}
/**
* If the directory entry is a link pointing somewhere outside the allowed directories per open_basedir we
* will get a RuntimeException (tested on PHP 5.3 onwards). Catching it lets us report the link as
* unreadable without suffering a PHP Fatal Error.
*/
try
{
$file->isLink();
}
catch (RuntimeException $e)
{
if (!in_array($di->getFilename(), ['.', '..']))
{
Factory::getLog()->warning(sprintf("Link %s is inaccessible. Check the open_basedir restrictions in your server's PHP configuration", $file->getPathname()));
}
continue;
}
if ($file->isDot())
{
continue;
}
if ($file->isDir())
{
continue;
}
$dir = $folder . $ds . $file->getFilename();
$data = $dir;
if (_AKEEBA_IS_WINDOWS)
{
$data = Factory::getFilesystemTools()->TranslateWinPath($dir);
}
if ($data)
{
$arr[] = $data;
}
$counter++;
if ($counter >= $maxCounter)
{
$breakflag = $allowBreakflag;
}
}
// Save break flag status
$registry->set('volatile.breakflag', $breakflag);
return $arr;
}
public function getFolders($folder, &$position)
{
// Was the breakflag set BEFORE starting? -- This workaround is required due to PHP5 defaulting to assigning variables by reference
$registry = Factory::getConfiguration();
$breakflag_before_process = $registry->get('volatile.breakflag', false);
// Reset break flag before continuing
$breakflag = false;
// Initialize variables
$arr = [];
$false = false;
if (!is_dir($folder) && !is_dir($folder . '/'))
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP reports it as not a folder.');
}
if (!@is_readable($folder))
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP reports it as not readable.');
}
$counter = 0;
$registry = Factory::getConfiguration();
$maxCounter = $registry->get('engine.scan.smart.large_dir_threshold', 100);
$allowBreakflag = ($registry->get('volatile.operation_counter', 0) != 0) && !$breakflag_before_process;
try
{
$di = new DirectoryIterator($folder);
}
catch (Exception $e)
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP\'s DirectoryIterator reports the path cannot be opened.', 0, $e);
}
if (!$di->valid())
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP\'s DirectoryIterator could open the folder but immediately reports itself as not valid. If this happens your server is about to die.');
}
$ds = ($folder == '') || ($folder == '/') || (@substr($folder, -1) == '/') || (@substr($folder, -1) == DIRECTORY_SEPARATOR) ? '' : DIRECTORY_SEPARATOR;
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if ($breakflag)
{
break;
}
/**
* If the directory entry is a link pointing somewhere outside the allowed directories per open_basedir we
* will get a RuntimeException (tested on PHP 5.3 onwards). Catching it lets us report the link as
* unreadable without suffering a PHP Fatal Error.
*/
try
{
$file->isLink();
}
catch (RuntimeException $e)
{
if (!in_array($di->getFilename(), ['.', '..']))
{
Factory::getLog()->warning(sprintf("Link %s is inaccessible. Check the open_basedir restrictions in your server's PHP configuration", $file->getPathname()));
}
continue;
}
if ($file->isDot())
{
continue;
}
if (!$file->isDir())
{
continue;
}
$dir = $folder . $ds . $file->getFilename();
$data = $dir;
if (_AKEEBA_IS_WINDOWS)
{
$data = Factory::getFilesystemTools()->TranslateWinPath($dir);
}
if ($data)
{
$arr[] = $data;
}
$counter++;
if ($counter >= $maxCounter)
{
$breakflag = $allowBreakflag;
}
}
// Save break flag status
$registry->set('volatile.breakflag', $breakflag);
return $arr;
}
}
PK \jz^ ^ ) vendor/akeeba/engine/engine/Scan/Base.phpnu [ .
*/
namespace Akeeba\Engine\Scan;
defined('AKEEBAENGINE') || die();
abstract class Base
{
/**
* Gets all the files of a given folder
*
* @param string $folder The absolute path to the folder to scan for files
* @param integer $position The position in the file list to seek to. Use null for the start of list.
*
* @return array A simple array of files
*/
abstract public function getFiles($folder, &$position);
/**
* Gets all the folders (subdirectories) of a given folder
*
* @param string $folder The absolute path to the folder to scan for files
* @param integer $position The position in the file list to seek to. Use null for the start of list.
*
* @return array A simple array of folders
*/
abstract public function getFolders($folder, &$position);
}
PK \fJ] ] + vendor/akeeba/engine/engine/Scan/large.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_SCAN_LARGE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_SCAN_LARGE_DESCRIPTION"
},
"engine.scan.large.dir_threshold": {
"default": "100",
"type": "integer",
"min": "1",
"max": "1000",
"shortcuts": "20|50|100|200|300|400|500",
"scale": "1",
"uom": "",
"title": "COM_AKEEBA_CONFIG_LARGE_DIRTHRESHOLD_TITLE",
"description": "COM_AKEEBA_CONFIG_LARGE_DIRTHRESHOLD_DESCRIPTION"
},
"engine.scan.large.file_threshold": {
"default": "50",
"type": "integer",
"min": "1",
"max": "1000",
"shortcuts": "10|20|50|100|200|300|400|500",
"scale": "1",
"uom": "",
"title": "COM_AKEEBA_CONFIG_LARGE_FILESTHRESHOLD_TITLE",
"description": "COM_AKEEBA_CONFIG_LARGE_FILESTHRESHOLD_DESCRIPTION"
},
"engine.scan.common.largefile": {
"default": "10485760",
"type": "integer",
"min": "1048576",
"max": "1048576000",
"shortcuts": "1048576|2097152|5242880|10485760|15728640|20971520|26214400|31457280|41943040|52428800|78643200|104857600",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_LARGEFILE_TITLE",
"description": "COM_AKEEBA_CONFIG_LARGEFILE_DESCRIPTION"
}
}PK \SŒr * vendor/akeeba/engine/engine/Scan/Large.phpnu [ .
*/
namespace Akeeba\Engine\Scan;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\WarningException;
use Akeeba\Engine\Factory;
use DirectoryIterator;
use Exception;
use RuntimeException;
/* Windows system detection */
if (!defined('_AKEEBA_IS_WINDOWS'))
{
$isWindows = DIRECTORY_SEPARATOR == '\\';
if (function_exists('php_uname'))
{
$isWindows = stristr(php_uname(), 'windows');
}
define('_AKEEBA_IS_WINDOWS', $isWindows);
}
/**
* A filesystem scanner which uses opendir() and is smart enough to make large directories
* be scanned inside a step of their own.
*
* The idea is that if it's not the first operation of this step and the number of contained
* directories AND files is more than double the number of allowed files per fragment, we should
* break the step immediately.
*
*/
class Large extends Base
{
public function getFiles($folder, &$position)
{
return $this->scanFolder($folder, $position, false, 'file', 100);
}
public function getFolders($folder, &$position)
{
return $this->scanFolder($folder, $position, true, 'dir', 50);
}
protected function scanFolder($folder, &$position, $forFolders = true, $threshold_key = 'dir', $threshold_default = 50)
{
$registry = Factory::getConfiguration();
// Initialize variables
$arr = [];
$false = false;
if (!is_dir($folder) && !is_dir($folder . '/'))
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP reports it as not a folder.');
}
if (!@is_readable($folder))
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP reports it as not readable.');
}
try
{
$di = new DirectoryIterator($folder);
}
catch (Exception $e)
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP\'s DirectoryIterator reports the path cannot be opened.', 0, $e);
}
if (!$di->valid())
{
throw new WarningException('Cannot list contents of directory ' . $folder . ' -- PHP\'s DirectoryIterator could open the folder but immediately reports itself as not valid. If this happens your server is about to die.');
}
if (!empty($position))
{
$di->seek($position);
if ($di->key() != $position)
{
$position = null;
return $arr;
}
}
$counter = 0;
$maxCounter = $registry->get("engine.scan.large.{$threshold_key}_threshold", $threshold_default);
while ($di->valid())
{
/**
* If the directory entry is a link pointing somewhere outside the allowed directories per open_basedir we
* will get a RuntimeException (tested on PHP 5.3 onwards). Catching it lets us report the link as
* unreadable without suffering a PHP Fatal Error.
*/
try
{
$di->isLink();
}
catch (RuntimeException $e)
{
if (!in_array($di->getFilename(), ['.', '..']))
{
Factory::getLog()->warning(sprintf("Link %s is inaccessible. Check the open_basedir restrictions in your server's PHP configuration", $di->getPathname()));
}
$di->next();
continue;
}
if ($di->isDot())
{
$di->next();
continue;
}
if ($di->isDir() != $forFolders)
{
$di->next();
continue;
}
$ds = ($folder == '') || ($folder == '/') || (@substr($folder, -1) == '/') || (@substr($folder, -1) == DIRECTORY_SEPARATOR) ? '' : DIRECTORY_SEPARATOR;
$dir = $folder . $ds . $di->getFilename();
$data = _AKEEBA_IS_WINDOWS ? Factory::getFilesystemTools()->TranslateWinPath($dir) : $dir;
if ($data)
{
$counter++;
$arr[] = $data;
}
if ($counter == $maxCounter)
{
break;
}
$di->next();
}
// Determine the new value for the position
$di->next();
$position = $di->valid() ? ($di->key() - 1) : null;
return $arr;
}
}
PK \Sʉ * vendor/akeeba/engine/engine/Scan/.htaccessnu 7m
Order allow,deny
Deny from all
PK \0 0 : vendor/akeeba/engine/engine/Platform/PlatformInterface.phpnu [ .
*/
namespace Akeeba\Engine\Platform;
defined('AKEEBAENGINE') || die();
use Exception;
/**
* Interface PlatformInterface
*
* @property string $tableNameProfiles The name of the table where backup profiles are stored
* @property string $tableNameStats The name of the table where backup records are stored
* @property array $configOverrides Configuration overrides
*/
interface PlatformInterface
{
/**
* Returns an array with the directory/-ies in which the magic autoloader should look for platform overrides.
*
* @return array
*/
public function getPlatformDirectories();
/**
* Performs heuristics to determine if this platform object is the ideal
* candidate for the environment Akeeba Engine is running in.
*
* @return bool
*/
public function isThisPlatform();
/**
* Saves the current configuration to the database table
*
* @param int $profile_id The profile where to save the configuration
* to, defaults to current profile
*
* @return bool True if everything was saved properly
*/
public function save_configuration($profile_id = null);
/**
* Loads the current configuration off the database table
*
* @param int $profile_id The profile where to read the configuration from, defaults to current profile
*
* @return bool True if everything was read properly
*/
public function load_configuration($profile_id = null);
/**
* Returns an associative array of stock platform directories
*
* @return array
*/
public function get_stock_directories();
/**
* Returns the absolute path to the site's root
*
* @return string
*/
public function get_site_root();
/**
* Returns the absolute path to the installer images directory
*
* @return string
*/
public function get_installer_images_path();
/**
* Returns the active profile number
*
* @return integer
*/
public function get_active_profile();
/**
* Returns the selected profile's name. If no ID is specified, the current
* profile's name is returned.
*
* @param integer|null $id The ID of the profile, skip for current profile
*
* @return string
*/
public function get_profile_name($id = null);
/**
* Returns the backup origin
*
* @return string Backup origin: backend|frontend
*/
public function get_backup_origin();
/**
* Returns a timestamp formatted for the current site's database driver
*
* @param string $date [optional] The timestamp to use. Omit to use current timestamp.
*
* @return string
*/
public function get_timestamp_database($date = 'now');
/**
* Returns the current timestamp, taking into account any TZ information,
* in the format specified by $format.
*
* @param string $format Timestamp format string (standard PHP format string)
*
* @return string
*/
public function get_local_timestamp($format);
/**
* Returns the current host name
*
* @return string
*/
public function get_host();
/**
* Returns the current site's name
*
* @return string
*/
public function get_site_name();
/**
* Creates or updates the statistics record of the current backup attempt
*
* @param int $id Backup record ID, use null for new record
* @param array $data The data to store
*
* @return int|null The new record id, or null if this doesn't apply
*
* @throws Exception On database error
*/
public function set_or_update_statistics($id = null, $data = []);
/**
* Loads and returns a backup statistics record as a hash array
*
* @param int $id Backup record ID
*
* @return array
*/
public function get_statistics($id);
/**
* Completely removes a backup statistics record
*
* @param int $id Backup record ID
*
* @return bool True on success
*/
public function delete_statistics($id);
/**
* Returns a list of backup statistics records, respecting the pagination
*
* The $config array allows the following options to be set:
* limitstart int Offset in the recordset to start from
* limit int How many records to return at once
* filters array An array of filters to apply to the results. Alternatively you can just pass a profile
* ID to filter by that profile. order array Record ordering information (by and ordering)
*
* @param array $config See above
*
* @return array
*/
function &get_statistics_list($config = []);
/**
* Return the total number of statistics records
*
* @param array $filters An array of filters to apply to the results. Alternatively you can just pass a profile
* ID to filter by that profile.
*
* @return integer
*/
function get_statistics_count($filters = null);
/**
* Returns an array with the specifics of running backups
*
* @param string $tag The backup type (e.g. backend)
*
* @return array
*/
public function get_running_backups($tag = null);
/**
* Multiple backup attempts can share the same backup file name. Only
* the last backup attempt's file is considered valid. Previous attempts
* have to be deemed "obsolete". This method returns a list of backup
* statistics ID's with "valid"-looking names. IT DOES NOT CHECK FOR THE
* EXISTENCE OF THE BACKUP FILE!
*
* @param bool $useprofile If true, it will only return backup records of the current profile
* @param array $tagFilters Which tags to include; leave blank for all. If the first item is "NOT", then all
* tags EXCEPT those listed will be included.
* @param string $ordering Ordering of the records, default DESC (descending), use DESC or ASC
*
* @return array A list of ID's for records w/ "valid"-looking backup files
*/
public function &get_valid_backup_records($useprofile = false, $tagFilters = [], $ordering = 'DESC');
/**
* Invalidates older records sharing the same $archivename
*
* @param string $archivename The archive name
*
* @return void
*/
public function remove_duplicate_backup_records($archivename);
/**
* Marks the specified backup records as having no files
*
* @param array $ids Array of backup record IDs to ivalidate
*
* @return void
*/
public function invalidate_backup_records($ids);
/**
* Gets a list of records with remotely stored files in the selected remote storage
* provider and profile.
*
* @param int $profile (optional) The profile to use. Skip or use null for active profile.
* @param string $engine (optional) The remote engine to looks for. Skip or use null for the active profile's
* engine.
*
* @return array
*/
public function get_valid_remote_records($profile = null, $engine = null);
/**
* Returns the filter data for the entire filter group collection
*
* @return array
*/
public function &load_filters();
/**
* Saves the nested filter data array $filter_data to the database
*
* @param array $filter_data The filter data to save
*
* @return bool True on success
*/
public function save_filters(&$filter_data);
/**
* Gets the best matching database driver class, according to CMS settings
*
* @param bool $use_platform If set to false, it will forcibly try to assign one of the primitive type
* (Mysql/Mysqli) and NEVER tell you to use an platform driver
*
* @return string
*/
public function get_default_database_driver($use_platform = true);
/**
* Returns a set of options to connect to the default database of the current CMS
*
* @return array
*/
public function get_platform_database_options();
/**
* Provides a platform-specific translation function
*
* @param string $key The translation key
*
* @return string
*/
public function translate($key);
/**
* Populates global constants holding the Akeeba version
*
* @return void
*/
public function load_version_defines();
/**
* Returns the platform name and version
*
* @return array Contains the platform name and version
*/
public function getPlatformVersion();
/**
* Logs platform-specific directories with LogLevel::INFO log level
*
* @return string If there are any extra notes / warnings on this platform
*/
public function log_platform_special_directories();
/**
* Loads a platform-specific software configuration option. These are
* configuration values for the backup engine, but unlike the rest of the
* configuration options they are not stored in the backup profile.
* Instead, these are stored globally using a platform-specific method.
* So these are not configuration values for the platform itself.
*
* @param string $key The configuration option to retrieve
* @param mixed $default The default value to return if it's not defined
*
* @return mixed
*/
public function get_platform_configuration_option($key, $default);
/**
* Returns a list of emails to the administrators
*
* @return array
*/
public function get_administrator_emails();
/**
* Sends a very simple email using the platform's emailer facility
*
* @param string $to Recipient address
* @param string $subject Email subject line
* @param string $body Email body (plain text)
* @param string $attachFile (optional) Full path to the file being attached
*
* @return bool True on success
*/
public function send_email($to, $subject, $body, $attachFile = null);
/**
* Deletes a file from the local server using direct file access or FTP
*
* @param string $file The file to unlink
*
* @return bool True on success
*/
public function unlink($file);
/**
* Moves a file around within the local server using direct file access or FTP
*
* @param string $from Full path of the file to move
* @param string $to Full path of where the file will be moved to
*
* @return bool True on success
*/
public function move($from, $to);
/**
* Stores a flash (temporary) variable in the session.
*
* @param string $name The name of the variable to store
* @param string $value The value of the variable to store
*
* @return void
*/
public function set_flash_variable($name, $value);
/**
* Return the value of a flash (temporary) variable from the session and
* immediately removes it.
*
* @param string $name The name of the flash variable
* @param mixed $default Default value, if the variable is not defined
*
* @return mixed The value of the variable or $default if it's not set
*/
public function get_flash_variable($name, $default = null);
/**
* Perform an immediate redirection to the defined URL
*
* @param string $url The URL to redirect to
*
* @return void
*/
public function redirect($url);
/**
* Get the proxy configuration for this platform.
*
* @return array{enabled: bool, host: string, port: int, user: string, pass: string}
* @since 9.0.7
*/
public function getProxySettings();
/**
* Set the proxy configuration for this platform
*
* @param false $useProxy Should I use a proxy at all?
* @param string $host Proxy hostname or IP address
* @param int $port Proxy port
* @param string $username Proxy username. Optional. Leavel blank to turn off authentication.
* @param string $password Proxy password.
*
* @return void
* @since 9.0.7
*/
public function setProxySettings($useProxy = false, $host = '', $port = 8080, $username = '', $password = '');
}
PK \st;y ;y - vendor/akeeba/engine/engine/Platform/Base.phpnu [ .
*/
namespace Akeeba\Engine\Platform;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Mysqli;
use Akeeba\Engine\Driver\QueryException;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform\Exception\DecryptionException;
use Akeeba\Engine\Util\ProfileMigration;
use DateTime;
use DateTimeZone;
use Exception;
use RuntimeException;
abstract class Base implements PlatformInterface
{
/** @var array Configuration overrides */
public $configOverrides = [];
/** @var bool Should I throw an exception when settings decryption fails? */
public $decryptionException = false;
/** @var string The name of the platform (same as the directory name) */
public $platformName = null;
/** @var int Priority of this platform. A lower number denotes higher priority. */
public $priority = 50;
/** @var string The name of the table where backup profiles are stored */
public $tableNameProfiles = '#__ak_profiles';
/** @var string The name of the table where backup records are stored */
public $tableNameStats = '#__ak_stats';
/** @var bool Have I initialised the proxy configuration settings? */
protected $hasInitialisedProxySettings = false;
/** @var bool Should I use a proxy? */
protected $proxyEnabled = false;
/** @var string Proxy hostname or IP address */
protected $proxyHost = '';
/** @var string Proxy password; only applied with a non-empty username */
protected $proxyPass = '';
/** @var int Proxy port */
protected $proxyPort = 8080;
/** @var string Proxy username; empty means no authentication */
protected $proxyUser = '';
/**
* Completely removes a backup statistics record
*
* @param int $id Backup record ID
*
* @return bool True on success
*/
public function delete_statistics($id)
{
$db = Factory::getDatabase($this->get_platform_database_options());
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->delete($db->qn($this->tableNameStats))
->where($db->qn('id') . ' = ' . $db->q($id));
$db->setQuery($query);
$result = true;
try
{
$db->query();
}
catch (Exception $exc)
{
$result = false;
}
return $result;
}
public function getPlatformDirectories()
{
return [dirname(__FILE__) . '/' . $this->platformName];
}
public function getPlatformVersion()
{
return [
'name' => 'Platform',
'version' => 'unknown',
];
}
/**
* @inheritdoc
*/
public final function getProxySettings()
{
if (!$this->hasInitialisedProxySettings)
{
$this->detectProxySettings();
}
return [
'enabled' => $this->proxyEnabled ?? false,
'host' => $this->proxyHost ?: '',
'port' => $this->proxyPort ?: 8080,
'user' => $this->proxyUser ?: '',
'pass' => $this->proxyPass ?: '',
];
}
public function get_active_profile()
{
return 1;
}
public function get_administrator_emails()
{
return [];
}
public function get_backup_origin()
{
return 'backend';
}
public function get_default_database_driver($use_platform = true)
{
return Mysqli::class;
}
public function get_host()
{
return '';
}
public function get_installer_images_path()
{
return '';
}
public function get_local_timestamp($format)
{
$dateNow = new DateTime('now', new DateTimeZone('UTC'));
return $dateNow->format($format);
}
public function get_platform_configuration_option($key, $default)
{
return '';
}
public function get_platform_database_options()
{
return [];
}
public function get_profile_name($id = null)
{
return '';
}
/**
* Returns an array with the specifics of running backups
*
* @param string $tag
*
* @return array Array list of associative arrays
* @throws QueryException
*
*/
public function get_running_backups($tag = null)
{
$db = Factory::getDatabase($this->get_platform_database_options());
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn($this->tableNameStats))
->where($db->qn('status') . ' = ' . $db->q('run'))
->where(' NOT ' . $db->qn('archivename') . ' = ' . $db->q(''));
if (!empty($tag))
{
$query->where($db->qn('origin') . ' LIKE ' . $db->q($tag . '%'));
}
$db->setQuery($query);
return $db->loadAssocList();
}
public function get_site_name()
{
return '';
}
public function get_site_root()
{
return '';
}
/**
* Loads and returns a backup statistics record as a hash array
*
* @param int $id Backup record ID
*
* @return array
*/
public function get_statistics($id)
{
$db = Factory::getDatabase($this->get_platform_database_options());
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn($this->tableNameStats))
->where($db->qn('id') . ' = ' . $db->q($id));
$db->setQuery($query);
return $db->loadAssoc();
}
/**
* Return the total number of statistics records
*
* @param array $filters An array of filters to apply to the results. Alternatively, you can just pass a
* profile ID to filter by that profile.
*
* @return int
*/
function get_statistics_count($filters = null)
{
$db = Factory::getDatabase($this->get_platform_database_options());
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true));
if (!empty($filters))
{
if (is_array($filters))
{
// Parse the filters array
foreach ($filters as $f)
{
$clause = $db->quoteName($f['field']);
$operand = strtoupper($f['operand'] ?? '=');
switch ($operand)
{
case 'BETWEEN':
case 'NOT BETWEEN':
$clause .= $operand . ' ' . $db->q($f['value']) . ' AND ' . $db->q($f['value2']);
break;
case 'LIKE':
case 'NOT LIKE':
$clause .= $operand . ' ' . '\'%' . $db->escape($f['value']) . '%\'';
break;
case 'IN':
case 'NOT IN':
$clause .= ' ' . $operand . ' (' . implode(', ', array_map([$db, 'quote'], array_filter($f['value']))) . ')';
break;
case 'EMPTY':
$field = $db->quoteName($f['field']);
$empty = $db->quote('');
$clause = "($field IS NULL OR $field = $empty)";
default:
$clause .= $operand . ' ' . $db->q($f['value']);
break;
}
$query->where($clause);
}
}
else
{
// Legacy mode: profile ID given
$query->where($db->qn('profile_id') . ' = ' . $db->q($filters));
}
}
$query->select('COUNT(*)')
->from($db->quoteName($this->tableNameStats));
$db->setQuery($query);
return $db->loadResult();
}
/**
* Returns a list of backup statistics records, respecting the pagination
*
* The $config array allows the following options to be set:
* limitstart int Offset in the recordset to start from
* limit int How many records to return at once
* filters array An array of filters to apply to the results. Alternatively you can just pass a profile
* ID to filter by that profile. order array Record ordering information (by and ordering)
*
* @return array
*/
function &get_statistics_list($config = [])
{
$defaultConfiguration = [
'limitstart' => 0,
'limit' => 0,
'filters' => [],
'order' => null,
];
$config = (object) array_merge($defaultConfiguration, $config);
$db = Factory::getDatabase($this->get_platform_database_options());
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true));
if (!empty($config->filters))
{
if (is_array($config->filters))
{
if (!empty($config->filters))
{
// Parse the filters array
foreach ($config->filters as $f)
{
$clause = $db->qn($f['field']);
$operand = array_key_exists('operand', $f) ? strtoupper($f['operand']) : '=';
if ($operand == 'BETWEEN')
{
$clause .= ' BETWEEN ' . $db->q($f['value']) . ' AND ' . $db->q($f['value2']);
}
elseif ($operand == 'LIKE')
{
$clause .= ' LIKE \'%' . $db->escape($f['value']) . '%\'';
}
elseif ($operand == 'IN')
{
$values = is_array($f['value']) ? $f['value'] : [$f['value']];
$clause .= ' IN (' . implode(', ', array_map([$db, 'q'], $values)) . ')';
}
elseif ($operand == 'EMPTY')
{
$clause = '(' . $db->qn($f['field']) . ' IS NULL OR ' . $db->qn($f['field']) . " = '')";
}
else
{
$clause .= ' ' . $operand . ' ' . $db->q($f['value']);
}
$query->where($clause);
}
}
}
else
{
// Legacy mode: profile ID given
$query->where($db->qn('profile_id') . ' = ' . $db->q($config->filters));
}
}
if (empty($config->order) || !is_array($config->order))
{
$config->order = [
'by' => 'id',
'order' => 'DESC',
];
}
$query->select('*')
->from($db->qn($this->tableNameStats))
->order($db->qn($config->order['by']) . " " . strtoupper($config->order['order']));
$db->setQuery($query, $config->limitstart, $config->limit);
$list = $db->loadAssocList();
return $list;
}
public function get_stock_directories()
{
return [];
}
public function get_timestamp_database($date = 'now')
{
return '';
}
/**
* Multiple backup attempts can share the same backup file name. Only
* the last backup attempt's file is considered valid. Previous attempts
* have to be deemed "obsolete". This method returns a list of backup
* statistics ID's with "valid"-looking names. IT DOES NOT CHECK FOR THE
* EXISTENCE OF THE BACKUP FILE!
*
* @param bool $useprofile If true, it will only return backup records of the current profile
* @param array $tagFilters Which tags to include; leave blank for all. If the first item is "NOT", then all
* tags EXCEPT those listed will be included. *
* @param string $ordering
*
* @return array A list of ID's for records w/ "valid"-looking backup files
* @throws QueryException
*
*/
public function &get_valid_backup_records($useprofile = false, $tagFilters = [], $ordering = 'DESC')
{
$db = Factory::getDatabase($this->get_platform_database_options());
$query2 = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('MAX(' . $db->qn('id') . ') AS ' . $db->qn('id'))
->from($db->qn($this->tableNameStats))
->where($db->qn('status') . ' = ' . $db->q('complete'))
->group($db->qn('absolute_path'));
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('id'))
->from($db->qn($this->tableNameStats))
->where($db->qn('filesexist') . ' = ' . $db->q(1))
->where($db->qn('id') . ' IN (' . $query2 . ')')
->where('NOT ' . $db->qn('absolute_path') . ' = ' . $db->q(''))
->order($db->qn('id') . ' ' . $ordering);
if ($useprofile)
{
$profile_id = $this->get_active_profile();
$query->where($db->qn('profile_id') . " = " . $db->q($profile_id));
}
if (!empty($tagFilters))
{
$operator = '';
$first = array_shift($tagFilters);
if ($first == 'NOT')
{
$operator = 'NOT';
}
else
{
array_unshift($tagFilters, $first);
}
$quotedTags = [];
foreach ($tagFilters as $tag)
{
$quotedTags[] = $db->q($tag);
}
$filter = implode(', ', $quotedTags);
unset($quotedTags);
$query->where($operator . ' ' . $db->quoteName('tag') . ' IN (' . $filter . ')');
}
$db->setQuery($query);
$array = $db->loadColumn();
return $array;
}
/**
* Gets a list of records with remotely stored files in the selected remote storage
* provider and profile.
*
* @param $profile int (optional) The profile to use. Skip or use null for active profile.
* @param $engine string (optional) The remote engine to looks for. Skip or use null for the active profile's
* engine.
*
* @return array
*/
public function get_valid_remote_records($profile = null, $engine = null)
{
$config = Factory::getConfiguration();
$result = [];
if (is_null($profile))
{
$profile = $this->get_active_profile();
}
if (is_null($engine))
{
$engine = $config->get('akeeba.advanced.postproc_engine', '');
}
if (empty($engine))
{
return $result;
}
$db = Factory::getDatabase($this->get_platform_database_options());
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn($this->tableNameStats))
->where($db->qn('profile_id') . ' = ' . $db->q($profile))
->where($db->qn('remote_filename') . ' LIKE ' . $db->q($engine . '://%'))
->order($db->qn('id') . ' DESC');
$db->setQuery($sql);
return $db->loadAssocList();
}
/**
* Marks the specified backup records as having no files
*
* @param array $ids Array of backup record IDs to ivalidate
*/
public function invalidate_backup_records($ids)
{
if (empty($ids))
{
return false;
}
$db = Factory::getDatabase($this->get_platform_database_options());
$temp = [];
foreach ($ids as $id)
{
$temp[] = $db->q($id);
}
$list = implode(',', $temp);
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn($this->tableNameStats))
->set($db->qn('filesexist') . ' = ' . $db->q('0'))
->where($db->qn('id') . ' IN (' . $list . ')');;
$db->setQuery($sql);
try
{
$db->query();
}
catch (Exception $exc)
{
return false;
}
return true;
}
public function isThisPlatform()
{
return true;
}
/**
* Loads the current configuration off the database table
*
* @param int $profile_id The profile where to read the configuration from, defaults to current profile
* @param bool $reset Should I reset the Configuration object before loading the profile? Default: true.
*
* @return bool True if everything was read properly
*/
public function load_configuration($profile_id = null, $reset = true)
{
// Load the database class
$db = Factory::getDatabase($this->get_platform_database_options());
// Get the active profile number, if no profile was specified
if (is_null($profile_id))
{
$profile_id = $this->get_active_profile();
}
// Initialize the registry
$registry = Factory::getConfiguration();
if ($reset)
{
/**
* I need to unset the protected keys to perform a full reset.
*
* If I do not, what I am getting is the default profile's values for all protected keys. That's because the
* engine always loads profile #1 before trying to load the current backup profile. This is not what I want,
* though. Profile #1 is meant to be a fallback if the current profile ID no longer exists (deleted), not if
* it's incomplete! Incomplete backup profiles are supposed to fall back to the default values coming from
* the configuration areas' JSON files.
*/
$pKeys = $registry->getProtectedKeys();
$registry->resetProtectedKeys();
$registry->reset();
$registry->setProtectedKeys($pKeys);
}
// Is the database connected?
if (!$db->connected())
{
return false;
}
try
{
// Load the INI format local configuration dump off the database
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('configuration'))
->from($db->qn($this->tableNameProfiles))
->where($db->qn('id') . ' = ' . $db->q($profile_id));
$databaseData = $db->setQuery($sql)->loadResult();
}
catch (Exception $e)
{
$databaseData = null;
}
/**
* If the profile is not the default and we can't load anything let's switch back to the default profile.
*
* You will end up here when you have opened the application in two different browsers and Browser A is used to
* delete the active profile you were using with Browser B. If we were not to load the default profile Browser B
* would try to save the default configuration data to the deleted profile. However, since the profile does not
* exist in the database any more the load_configuration at the end of the following if-block would trigger the
* same code path, recursively, infinitely until you reached the maximum nesting level in PHP, run out of memory
* or hit the execution time limit.
*/
if ((empty($databaseData) || is_null($databaseData)) && ($profile_id != 1))
{
return $this->load_configuration(1);
}
if (empty($databaseData) || is_null($databaseData))
{
// No configuration was saved yet - store the defaults
$saved = $this->save_configuration($profile_id);
// If this is the case we probably don't have the necessary table. Throw an exception.
if (!$saved)
{
throw new RuntimeException("Could not save data to backup profile #$profile_id", 500);
}
return $this->load_configuration($profile_id);
}
// Decrypt the data if required
$secureSettings = Factory::getSecureSettings();
$noData = empty($databaseData);
$signature = ($noData || (strlen($databaseData) < 12)) ? '' : substr($databaseData, 0, 12);
$parsedData = [];
/**
* Special case: profile data is encrypted but encryption is set to false. This means that the user has just
* asked for the encryption to be disabled. We have to NOT load the settings so that the application has the
* chance to decode the data and write the decoded data back to the database.
*/
if (!$secureSettings->supportsEncryption() && in_array($signature, ['###AES128###', '###CTR128###']))
{
$dataArray = ['volatile' => ['fake_decrypt_flag' => 1]];
}
else
{
$databaseData = $secureSettings->decryptSettings($databaseData);
$isMigrationRequired = false; // Do I have to migrate the data from INI to JSON
$corruptedINI = false; // Is the INI data corrupted?
// Handle legacy, INI-encoded data
if (ProfileMigration::looksLikeIni($databaseData))
{
$isMigrationRequired = true;
$corruptedINI = strpos($databaseData, '[akeeba]') === false;
$databaseData = ProfileMigration::convertINItoJSON($databaseData);
}
// Detect corrupt JSON data
$corruptedJSON = strpos($databaseData, '"akeeba"') === false;
// Did the decryption fail and we were asked to throw an exception?
if ($this->decryptionException && !$noData)
{
// The decryption failed, it returned empty data
if (!$isMigrationRequired && empty($databaseData))
{
throw new DecryptionException(
$this->translate('COM_AKEEBA_CONFIG_ERR_DECRYPTION') .
"\nAdditional info: Empty data after decryption."
);
}
// We tried to migrate but the INI data is corrupt
if ($isMigrationRequired && $corruptedINI)
{
throw new DecryptionException(
$this->translate('COM_AKEEBA_CONFIG_ERR_DECRYPTION') .
"\nAdditional info: old format INI data was corrupt and could not be migrated to JSON."
);
}
// We tried to migrate but the resulting JSON data is corrupt
if ($isMigrationRequired && $corruptedJSON)
{
throw new DecryptionException(
$this->translate('COM_AKEEBA_CONFIG_ERR_DECRYPTION') .
"\nAdditional info: JSON data was corrupt after migrating it from INI data."
);
}
// We decrypted something but it does not look like JSON. Wrong encryption key?
if ($corruptedJSON)
{
throw new DecryptionException(
$this->translate('COM_AKEEBA_CONFIG_ERR_DECRYPTION') .
"\nAdditional info: configuration JSON data was corrupt after decryption."
);
}
}
$dataArray = json_decode($databaseData, true);
}
unset($databaseData);
if (!is_array($dataArray))
{
$dataArray = [];
}
foreach ($dataArray as $section => $row)
{
if ($section == 'volatile')
{
continue;
}
$row = $this->arrayToRegistryDefinitions($row);
if (is_array($row) && !empty($row))
{
foreach ($row as $key => $value)
{
$parsedData["$section.$key"] = $value;
}
}
}
unset($dataArray);
// Import the configuration array
$protected_keys = $registry->getProtectedKeys();
$registry->resetProtectedKeys();
$registry->mergeArray($parsedData, false, false);
// Old profiles have advanced.proc_engine instead of advanced.postproc_engine. Migrate them.
$procEngine = $registry->get('akeeba.advanced.proc_engine', null);
if (!empty($procEngine))
{
$registry->set('akeeba.advanced.postproc_engine', $procEngine);
$registry->set('akeeba.advanced.proc_engine', null);
}
// Apply config overrides
if (is_array($this->configOverrides) && !empty($this->configOverrides))
{
$registry->mergeArray($this->configOverrides, false, false);
}
$registry->setProtectedKeys($protected_keys);
$registry->activeProfile = $profile_id;
return true;
}
/**
* Returns the filter data for the entire filter group collection
*
* @return array
*/
public function &load_filters()
{
// Load the filter data from the database
$profile_id = $this->get_active_profile();
$db = Factory::getDatabase($this->get_platform_database_options());
// Load the INI format local configuration dump off the database
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('filters'))
->from($db->qn($this->tableNameProfiles))
->where($db->qn('id') . ' = ' . $db->q($profile_id));
$db->setQuery($sql);
$all_filter_data = $db->loadResult();
if (is_null($all_filter_data) || empty($all_filter_data))
{
$all_filter_data = [];
return $all_filter_data;
}
if (ProfileMigration::looksLikeSerialized($all_filter_data))
{
$all_filter_data = ProfileMigration::convertSerializedToJSON($all_filter_data);
}
$all_filter_data = json_decode($all_filter_data, true);
// Catch unserialization errors
if (empty($all_filter_data))
{
$all_filter_data = [];
}
return $all_filter_data;
}
public function load_version_defines()
{
}
public function log_platform_special_directories()
{
}
public function move($from, $to)
{
$result = @rename($from, $to);
if (!$result)
{
$result = @copy($from, $to);
if ($result)
{
$result = $this->unlink($from);
}
}
return $result;
}
public function register_autoloader()
{
}
/**
* Invalidates older records sharing the same $archivename
*
* @param string $archivename
*/
public function remove_duplicate_backup_records($archivename)
{
Factory::getLog()->debug("Removing any old records with $archivename filename");
$db = Factory::getDatabase($this->get_platform_database_options());
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($db->qn('id'))
->from($db->qn($this->tableNameStats))
->where($db->qn('archivename') . ' = ' . $db->q($archivename))
->order($db->qn('id') . ' DESC');
$db->setQuery($query);
$array = $db->loadColumn();
Factory::getLog()->debug((is_array($array) || $array instanceof \Countable ? count($array) : 0) . " records found");
// No records?! Quit.
if (empty($array))
{
return;
}
// Only one record. Quit.
if ((is_array($array) || $array instanceof \Countable ? count($array) : 0) == 1)
{
return;
}
// Shift the first (latest) element off the array
$currentID = array_shift($array);
// Invalidate older records
$this->invalidate_backup_records($array);
}
/**
* Saves the current configuration to the database table
*
* @param int $profile_id The profile where to save the configuration to, defaults to current profile
*
* @return bool True if everything was saved properly
*/
public function save_configuration($profile_id = null)
{
// Load the database class
$db = Factory::getDatabase($this->get_platform_database_options());
if (!$db->connected())
{
return false;
}
// Get the active profile number, if no profile was specified
if (is_null($profile_id))
{
$profile_id = $this->get_active_profile();
}
// Get an INI format registry dump
$registry = Factory::getConfiguration();
$dump_profile = $registry->exportAsJSON();
// Encrypt the registry dump if required
$secureSettings = Factory::getSecureSettings();
$dump_profile = $secureSettings->encryptSettings($dump_profile);
// Does the record already exist?
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('COUNT(*)')
->from($db->qn($this->tableNameProfiles))
->where($db->qn('id') . ' = ' . $db->q($profile_id));
try
{
$count = $db->setQuery($sql)->loadResult();
$exists = ($count > 0);
}
catch (Exception $e)
{
$exists = true;
}
if ($exists)
{
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn($this->tableNameProfiles))
->set($db->qn('configuration') . ' = ' . $db->q($dump_profile))
->where($db->qn('id') . ' = ' . $db->q($profile_id));
}
else
{
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->insert($db->qn($this->tableNameProfiles))
->columns([
$db->qn('id'), $db->qn('description'), $db->qn('configuration'),
$db->qn('filters'), $db->qn('quickicon'),
])
->values(
$db->q(1) . ', ' .
$db->q("Default backup profile") . ', ' .
$db->q($dump_profile) . ', ' .
$db->q('') . ', ' .
$db->q(1)
);
}
$db->setQuery($sql);
try
{
$result = $db->query();
}
catch (Exception $exc)
{
return false;
}
return ($result == true);
}
/**
* Saves the nested filter data array $filter_data to the database
*
* @param array $filter_data The filter data to save
*
* @return bool True on success
*/
public function save_filters(&$filter_data)
{
$profile_id = $this->get_active_profile();
$db = Factory::getDatabase($this->get_platform_database_options());
$encodedFilterData = json_encode($filter_data, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_FORCE_OBJECT | JSON_PRETTY_PRINT);
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn($this->tableNameProfiles))
->set($db->qn('filters') . '=' . $db->q($encodedFilterData))
->where($db->qn('id') . ' = ' . $db->q($profile_id));
try
{
$db->setQuery($sql)->query();
}
catch (Exception $exc)
{
return false;
}
return true;
}
public function send_email($to, $subject, $body, $attachFile = null)
{
return false;
}
/** @inheritdoc */
public final function setProxySettings($useProxy = false, $host = '', $port = 8080, $username = '', $password = '')
{
$host = trim($host);
$port = (int) $port;
$this->hasInitialisedProxySettings = true;
$this->proxyEnabled = $useProxy && !empty($host) && ($port > 0) && ($port < 65536);
$this->proxyHost = $host;
$this->proxyPort = $port;
$this->proxyUser = trim($username ?? '') ?: '';
$this->proxyPass = trim($password ?? '') ?: '';
}
/**
* Creates or updates the statistics record of the current backup attempt
*
* @param int $id Backup record ID, use null for new record
* @param array $data The data to store
*
* @return int|null The new record id, or null if this doesn't apply
*
* @throws Exception On database error
*/
public function set_or_update_statistics($id = null, $data = [])
{
// No valid data?
if (!is_array($data))
{
return null;
}
// No data at all?
if (empty($data))
{
return null;
}
$db = Factory::getDatabase($this->get_platform_database_options());
$tableFields = $db->getTableColumns($this->tableNameStats);
$tableFields = array_keys($tableFields);
if (is_null($id))
{
// Create a new record
$sql_fields = [];
$sql_values = '';
foreach ($data as $key => $value)
{
if (!in_array($key, $tableFields))
{
continue;
}
$sql_fields[] = $db->qn($key);
$sql_values .= (!empty($sql_values) ? ',' : '') . $db->quote($value);
}
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->insert($db->quoteName($this->tableNameStats))
->columns($sql_fields)
->values($sql_values);
$db->setQuery($sql);
$db->query();
return $db->insertid();
}
else
{
$sql_set = [];
foreach ($data as $key => $value)
{
if ($key == 'id')
{
continue;
}
$sql_set[] = $db->qn($key) . '=' . $db->q($value);
}
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn($this->tableNameStats))
->set($sql_set)
->where($db->qn('id') . '=' . $db->q($id));
$db->setQuery($sql);
$db->query();
return null;
}
}
public function translate($key)
{
return '';
}
public function unlink($file)
{
return @unlink($file);
}
/**
* Flattens a hierarchical array to a set of registry keys.
*
* For example
* [ 'foo' => [ 'bar' => [ 'baz' => 1, 'bat' => 2 ] ] ]
* becomes
* [ 'foo.bar.baz' => 1, 'foo.bar.bat' => 2 ]
*
* @param array $array The array to flatten
* @param string $prefix The prefix to use (leave blank; it's used in recursive calls)
*
* @return array An array with flattened keys
*
* @since 6.4.1
*/
protected function arrayToRegistryDefinitions(array $array, $prefix = '')
{
$keys = [];
foreach ($array as $k => $v)
{
if (is_array($v))
{
$keys = array_merge($keys, $this->arrayToRegistryDefinitions($v, $prefix . $k . "."));
continue;
}
$keys[$prefix . $k] = $v;
}
return $keys;
}
/**
* Automatically-detect the proxy settings for this platform.
*
* Implement this method to detect the proxy settings. Use $this->setProxysettings() to apply them.
*
* This method is called by getProxySettings automatically. You do NOT need to call it yourself when initialising
* the platform.
*
* @return void
* @since 9.0.7
*/
protected function detectProxySettings()
{
}
}
PK \J~ŋ F vendor/akeeba/engine/engine/Platform/Exception/DecryptionException.phpnu [ .
*/
namespace Akeeba\Engine\Platform\Exception;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Platform;
use Exception;
use RuntimeException;
/**
* Thrown when the settings cannot be decrypted, e.g. when the server no longer has encyrption enabled or the key has
* changed.
*/
class DecryptionException extends RuntimeException
{
public function __construct($message = null, $code = 500, ?Exception $previous = null)
{
if (empty($message))
{
$message = Platform::getInstance()->translate('COM_AKEEBA_CONFIG_ERR_DECRYPTION');
}
parent::__construct($message, $code, $previous);
}
}
PK \Sʉ 8 vendor/akeeba/engine/engine/Platform/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ . vendor/akeeba/engine/engine/Platform/.htaccessnu 7m
Order allow,deny
Deny from all
PK \˱'U U . vendor/akeeba/engine/engine/Core/04.quota.jsonnu [ {
"_group": {
"description": "COM_AKEEBA_CONFIG_HEADER_QUOTA"
},
"akeeba.quota.maxage.enable": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.quota.obsolete_quota": {
"default": "50",
"type": "integer",
"min": "0",
"max": "500",
"shortcuts": "1|10|20|30|40|50",
"scale": "1",
"uom": "items",
"title": "COM_AKEEBA_CONFIG_OBSOLETEQUOTA_ENABLE_TITLE",
"description": "COM_AKEEBA_CONFIG_OBSOLETEQUOTA_ENABLE_DESCRIPTION"
},
"akeeba.quota.enable_logfiles": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_LOGFILES_TITLE",
"description": "COM_AKEEBA_CONFIG_LOGFILES_DESCRIPTION"
},
"akeeba.quota.logfiles.type": {
"default": "count",
"type": "enum",
"protected": "1",
"enumkeys": "COM_AKEEBA_CONFIG_LOGFILES_TYPE_SIZE|COM_AKEEBA_CONFIG_LOGFILES_TYPE_COUNT|COM_AKEEBA_CONFIG_LOGFILES_TYPE_DAYS",
"enumvalues": "size|count|days",
"title": "COM_AKEEBA_CONFIG_LOGFILES_TYPE_TITLE",
"description": "COM_AKEEBA_CONFIG_LOGFILES_TYPE_DESCRIPTION",
"showon": "akeeba.quota.enable_logfiles:1"
},
"akeeba.quota.logfiles.count": {
"default": "3",
"type": "integer",
"min": "0",
"max": "10000",
"shortcuts": "1|3|7|10|30|100",
"scale": "1",
"title": "COM_AKEEBA_CONFIG_LOGFILES_COUNT_TITLE",
"description": "COM_AKEEBA_CONFIG_LOGFILES_COUNT_DESCRIPTION",
"showon": "akeeba.quota.enable_logfiles:1[AND]akeeba.quota.logfiles.type:count"
},
"akeeba.quota.logfiles.size": {
"default": "10485760",
"type": "integer",
"min": "1",
"max": "1125899906842624",
"shortcuts": "15728640|52428800|104857600|268435456|536870912|1073741824|2147483648|5368709120|10737418240|21474836480|1099511627776",
"scale": "1048576",
"uom": "Mb",
"title": "COM_AKEEBA_CONFIG_LOGFILES_SIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_LOGFILES_SIZE_DESCRIPTION",
"showon": "akeeba.quota.enable_logfiles:1[AND]akeeba.quota.logfiles.type:size"
},
"akeeba.quota.logfiles.days": {
"default": "30",
"type": "integer",
"min": "1",
"max": "365",
"shortcuts": "31|60|182|365",
"scale": "1",
"uom": "days",
"title": "COM_AKEEBA_CONFIG_LOGFILES_DAYS_TITLE",
"description": "COM_AKEEBA_CONFIG_LOGFILES_DAYS_DESCRIPTION",
"showon": "akeeba.quota.enable_logfiles:1[AND]akeeba.quota.logfiles.type:days"
},
"akeeba.quota.enable_size_quota": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_SIZEQUOTA_ENABLE_TITLE",
"description": "COM_AKEEBA_CONFIG_SIZEQUOTA_ENABLE_DESCRIPTION"
},
"akeeba.quota.size_quota": {
"default": "15728640",
"type": "integer",
"min": "1",
"max": "1125899906842624",
"shortcuts": "15728640|52428800|104857600|268435456|536870912|1073741824|2147483648|5368709120|10737418240|21474836480|1099511627776",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_SIZEQUOTA_VALUE_TITLE",
"description": "COM_AKEEBA_CONFIG_SIZEQUOTA_VALUE_DESCRIPTION",
"showon": "akeeba.quota.size_quota:1"
},
"akeeba.quota.enable_count_quota": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_COUNTQUOTA_ENABLE_TITLE",
"description": "COM_AKEEBA_CONFIG_COUNTQUOTA_ENABLE_DESCRIPTION"
},
"akeeba.quota.count_quota": {
"default": "3",
"type": "integer",
"min": "1",
"max": "200",
"shortcuts": "1|5|10|50|100|200",
"scale": "1",
"uom": "",
"title": "COM_AKEEBA_CONFIG_COUNTQUOTA_VALUE_TITLE",
"description": "COM_AKEEBA_CONFIG_COUNTQUOTA_VALUE_DESCRIPTION",
"showon": "akeeba.quota.enable_count_quota:1"
},
"akeeba.quota.remotely.maxage.enable": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.quota.remotely.enable_count_quota": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.quota.remotely.enable_size_quota": {
"default": "0",
"type": "none",
"protected": "1"
}
}PK \uP# # H vendor/akeeba/engine/engine/Core/Domain/Finalizer/MailAdministrators.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
/**
* Sends an email to the site administrators on backup completion
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*/
final class MailAdministrators extends AbstractFinalizer
{
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep('Processing emails to administrators');
$this->setSubstep('');
$platform = Platform::getInstance();
// Skip email for back-end backups
if ($platform->get_backup_origin() == 'backend')
{
return true;
}
// Is the feature enabled?
if ($platform->get_platform_configuration_option('frontend_email_on_finish', 0) == 0)
{
return true;
}
Factory::getLog()->debug("Preparing to send e-mail to administrators");
$emails = $this->getEmailAddresses();
if (empty($emails))
{
Factory::getLog()->debug("No email recipients found! Skipping email.");
return true;
}
Factory::getLog()->debug("Creating email subject and body");
// Get the statistics
$statistics = Factory::getStatistics();
$profileNumber = $platform->get_active_profile();
$db = Factory::getDatabase();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))->select('1');
$dummy = $db->setQuery($query)->loadResult();
$profileName = $platform->get_profile_name($profileNumber);
$statsRecord = $statistics->getRecord();
$partsCount = max(1, $statsRecord['multipart']);
$allFilenames = $this->getPartFilenames($statsRecord);
$filesList = implode(
"\n", array_map(function ($file) {
return "\t" . $file;
}, $allFilenames)
);
$totalSize = (int) ($statsRecord['total_size'] ?? 0);
// Get the approximate part sizes and create a list of files and sizes
$configuration = Factory::getConfiguration();
$partSize = $configuration->get('engine.archiver.common.part_size', 0);
$lastPartSize = $totalSize - (($partsCount - 1) * $partSize);
$partSizes = array_fill(0, $partsCount - 1, $partSize);
$partSizes[] = $lastPartSize;
$filesAndSizesList = implode(
"\n",
array_map(
function ($file, $size) {
return sprintf(
"\t%s (approx. %s)",
$file,
$this->formatByteSize($size)
);
},
$allFilenames,
$partSizes
)
);
// Determine the upload to remote storage status
$remoteStatus = '';
$failedUpdate = false;
$postProcEngine = Factory::getConfiguration()->get('akeeba.advanced.postproc_engine');
if (!empty($postProcEngine) && ($postProcEngine != 'none'))
{
$remoteStatus = $platform->translate('COM_AKEEBA_EMAIL_POSTPROCESSING_SUCCESS');
if (empty($statsRecord['remote_filename']))
{
$failedUpdate = true;
$remoteStatus = $platform->translate('COM_AKEEBA_EMAIL_POSTPROCESSING_FAILED');
}
}
// Did the user ask to be emailed only on failed uploads but the upload has succeeded?
if (
!$failedUpdate
&& ($platform->get_platform_configuration_option('frontend_email_when', 'always') == 'failedupload')
)
{
return true;
}
// Fetch user's preferences
$subject = trim($platform->get_platform_configuration_option('frontend_email_subject', ''));
$body = trim($platform->get_platform_configuration_option('frontend_email_body', ''));
// Get a default subject or post-process a manually defined subject
$subject = empty($subject)
? $platform->translate('COM_AKEEBA_COMMON_EMAIL_SUBJECT_OK')
: Factory::getFilesystemTools()->replace_archive_name_variables($subject);
// Do we need a default body?
if (empty($body))
{
$body = $platform->translate('COM_AKEEBA_COMMON_EMAIL_BODY_OK');
$body .= "\n\n";
$body .= sprintf(
$platform->translate('COM_AKEEBA_COMMON_EMAIL_BODY_INFO'),
$profileNumber,
$partsCount
);
$body .= "\n\n";
$body .= $filesAndSizesList;
}
else
{
// Post-process the body
$body = Factory::getFilesystemTools()->replace_archive_name_variables($body);
$body = str_replace('[PROFILENUMBER]', $profileNumber, $body);
$body = str_replace('[PROFILENAME]', $profileName, $body);
$body = str_replace('[PARTCOUNT]', $partsCount, $body);
$body = str_replace('[FILELIST]', $filesList, $body);
$body = str_replace('[FILESIZESLIST]', $filesAndSizesList, $body);
$body = str_replace('[REMOTESTATUS]', $remoteStatus, $body);
$body = str_replace('[TOTALSIZE]', $this->formatByteSize($totalSize), $body);
}
// Post-process the subject (support the [REMOTESTATUS] variable)
$subject = str_replace('[REMOTESTATUS]', $remoteStatus, $subject);
// Sometimes $body contains literal \n instead of newlines
$body = str_replace('\\n', "\n", $body);
foreach ($emails as $email)
{
Factory::getLog()->debug("Sending email to $email");
try
{
$platform->send_email($email, $subject, $body);
}
catch (\Exception $e)
{
// Don't cry if we cannot send an email; just log it as a warning
Factory::getLog()->warning(
sprintf(
'Cannot send email to ‘%s’. Error message: “%s”',
$email,
$e->getMessage()
)
);
}
}
return true;
}
/**
* Returns a list of files' base names for the given backup statistics record
*
* @param array $statsRecord The statistics record
*
* @return array List of file names
*
* @since 9.3.1
*/
private function getPartFilenames(array $statsRecord): array
{
$baseFile = basename(
$statsRecord['absolute_path'] ?? $statsRecord['archivename'] ?? $statsRecord['remote_filename'] ?? ''
);
if (empty($baseFile))
{
return [];
}
$partsCount = max($statsRecord['multipart'] ?? 1, 1);
if ($partsCount === 1)
{
return [$baseFile];
}
$ret = [];
$extension = substr($baseFile, strrpos($baseFile, '.'));
$bareName = basename($baseFile, $extension);
for ($i = 1; $i < $partsCount; $i++)
{
$ret[] = $bareName . substr($extension, 0, 2) . sprintf('%02d', $i);
}
$ret[] = $baseFile;
return $ret;
}
/**
* Formats a number of bytes in human-readable format
*
* @param int|float $size The size in bytes to format, e.g. 8254862
*
* @return string The human-readable representation of the byte size, e.g. "7.87 Mb"
* @since 9.3.1
*/
private function formatByteSize($size): string
{
$unit = ['b', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'];
return @round($size / 1024 ** ($i = floor(log($size, 1024))), 2) . ' ' . $unit[$i];
}
/**
* Get the addresses to send emails to.
*
* @return array
* @since 9.4.9
*/
private function getEmailAddresses(): array
{
$platform = Platform::getInstance();
$configuration = Factory::getConfiguration();
// Check if we have a list of emails saved inside the profile
$email = trim($configuration->get('akeeba.basic.email_recipients', '') ?? '');
if (!empty($email))
{
Factory::getLog()->debug("Using list of emails stored inside profile configuration");
$list = array_map(
function ($x) {
return trim ($x ?? '');
},
explode(',', $email)
);
$list = array_filter(
$list,
function ($x)
{
return !empty($x);
}
);
if (!empty($list))
{
return $list;
}
}
$email = trim($platform->get_platform_configuration_option('frontend_email_address', '') ?? '');
if (!empty($email))
{
Factory::getLog()->debug("Using pre-defined list of emails");
$list = array_map(
function ($x) {
return trim ($x ?? '');
},
explode(',', $email)
);
$list = array_filter(
$list,
function ($x)
{
return !empty($x);
}
);
if (!empty($list))
{
return $list;
}
}
Factory::getLog()->debug("Fetching list of site administrator emails");
return $platform->get_administrator_emails();
}
}PK \[=y& & D vendor/akeeba/engine/engine/Core/Domain/Finalizer/PostProcessing.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Base;
use Akeeba\Engine\Postproc\PostProcInterface;
use Exception;
use Akeeba\Engine\Psr\Log\LogLevel;
/**
* Performs any necessary post-processing (remote file uploading) still pending.
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*
*/
final class PostProcessing extends AbstractFinalizer
{
/** @var array A list of all backup parts to process */
private $backupParts = [];
/** @var int The backup part we are currently processing */
private $backupPartsIndex = -1;
/** @var int How many finalisation substeps I have already done */
private $subStepsDone = 0;
/** @var int How many finalisation substeps I have in total */
private $subStepsTotal = 0;
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep('Post-processing');
$this->setSubstep('');
// Do not run if the archive engine doesn't produce archives
$configuration = Factory::getConfiguration();
$engineName = $configuration->get('akeeba.advanced.postproc_engine');
$shouldAbortOnFailed = $configuration->get('engine.postproc.common.abort_on_fail', false);
Factory::getLog()->debug("Loading post-processing engine object ($engineName)");
$postProcEngine = Factory::getPostprocEngine($engineName);
if (!is_object($postProcEngine) || !($postProcEngine instanceof Base))
{
Factory::getLog()->debug(
sprintf(
'Post-processing engine “%s” not found.',
$engineName
)
);
Factory::getLog()->debug("The post-processing engine has either been removed or you are trying to use a profile created with the Professional version of the backup software in the Core version which doesn't have this post-processing engine.");
return true;
}
// Initialize the archive part list if required
if (empty($this->backupParts))
{
$ret = $this->initialiseBackupParts($postProcEngine);
if ($ret !== null)
{
return $ret;
}
}
// Make sure we don't accidentally break the step when not required to do so
$configuration->set('volatile.breakflag', false);
// Do we have a filename from the previous run of the post-proc engine?
$filename = $configuration->get('volatile.postproc.filename', null);
if (empty($filename))
{
$filename = $this->backupParts[$this->backupPartsIndex];
Factory::getLog()->info('Beginning post processing file ' . $filename);
}
else
{
Factory::getLog()->info('Continuing post processing file ' . $filename);
}
$this->setStep('Post-processing');
$this->setSubstep(basename($filename));
$timer = Factory::getTimer();
$startTime = $timer->getRunningTime();
$processingException = null;
try
{
$finishedProcessing = $postProcEngine->processPart($filename);
}
catch (Exception $e)
{
$finishedProcessing = false;
$processingException = $e;
}
if (!is_null($processingException))
{
Factory::getLog()->warning('Failed to process file ' . $filename);
Factory::getLog()->warning('Error received from the post-processing engine:');
$this->logErrorsFromException($processingException, $shouldAbortOnFailed ? LogLevel::ERROR : LogLevel::WARNING);
if ($shouldAbortOnFailed)
{
throw new ErrorException(sprintf('Failed to process backup archive file %s', basename($filename)));
}
}
elseif ($finishedProcessing === true)
{
// The post-processing of this file ended successfully
Factory::getLog()->info('Finished post-processing file ' . $filename);
$configuration->set('volatile.postproc.filename', null);
}
else
{
// More work required
Factory::getLog()->info('More post-processing steps required for file ' . $filename);
$configuration->set('volatile.postproc.filename', $filename);
// Do we need to break the step?
$endTime = $timer->getRunningTime();
$stepTime = $endTime - $startTime;
$timeLeft = $timer->getTimeLeft();
// By default, we assume that we have enough time to run yet another step
$configuration->set('volatile.breakflag', false);
/**
* However, if the last step took longer than the time we already have left on the timer we can predict
* that we are running out of time, therefore we need to break the step.
*/
if ($timeLeft < $stepTime)
{
$configuration->set('volatile.breakflag', true);
}
}
// Should we delete the file afterwards?
$canAndShouldDeleteFileAfterwards =
$configuration->get('engine.postproc.common.delete_after', false)
&& $postProcEngine->isFileDeletionAfterProcessingAdvisable();
if ($canAndShouldDeleteFileAfterwards && $finishedProcessing)
{
Factory::getLog()->debug('Deleting already processed file ' . $filename);
Platform::getInstance()->unlink($filename);
}
elseif ($canAndShouldDeleteFileAfterwards && !$finishedProcessing)
{
Factory::getLog()->debug('Not removing the non-processed file ' . $filename);
}
else
{
Factory::getLog()->debug('Not removing processed file ' . $filename);
}
if ($finishedProcessing === true)
{
// Move the index forward if the part finished processing
$this->backupPartsIndex++;
// Mark substep done
$this->subStepsDone++;
// Break step after processing?
if (
$postProcEngine->recommendsBreakAfter()
&& !Factory::getConfiguration()->get('akeeba.tuning.nobreak.finalization', 0)
)
{
$configuration->set('volatile.breakflag', true);
}
// If we just finished processing the first archive part, save its remote path in the statistics.
if (($this->subStepsDone == 1) || ($this->subStepsTotal == 0))
{
$this->updateStatistics($postProcEngine, $engineName);
}
// Are we past the end of the array (i.e. we're finished)?
if ($this->backupPartsIndex >= count($this->backupParts))
{
Factory::getLog()->info('Post-processing has finished for all files');
return true;
}
}
if (!is_null($processingException))
{
// If the post-processing failed, make sure we don't process anything else
$this->backupPartsIndex = count($this->backupParts);
Factory::getLog()->warning('Post-processing interrupted -- no more files will be transferred');
return true;
}
// Indicate we're not done yet
return false;
}
/**
* Update the backup record upon post-processing the first part.
*
* @param PostProcInterface $postProcEngine The post-processing engine we're using
* @param string $engineName The name of the post-processing engine we're using
*
* @throws Exception
* @since 9.3.1
*/
public function updateStatistics(PostProcInterface $postProcEngine, string $engineName): void
{
if (empty($postProcEngine->getRemotePath()))
{
return;
}
$configuration = Factory::getConfiguration();
$statistics = Factory::getStatistics();
$remote_filename = $engineName . '://';
$remote_filename .= $postProcEngine->getRemotePath();
$data = [
'remote_filename' => $remote_filename,
];
$remove_after = $configuration->get('engine.postproc.common.delete_after', false);
if ($remove_after)
{
$data['filesexist'] = 0;
}
$statistics->setStatistics($data);
}
/**
* Initialise the backup parts information
*
* @param PostProcInterface $postProcEngine The post-processing engine we're using
*
* @return bool|null
*
* @since 9.3.1
*/
private function initialiseBackupParts(PostProcInterface $postProcEngine): ?bool
{
$configuration = Factory::getConfiguration();
Factory::getLog()->info('Initializing post-processing engine');
// Initialize the flag for multistep post-processing of parts
$configuration->set('volatile.postproc.filename', null);
$configuration->set('volatile.postproc.directory', null);
// Populate array w/ absolute names of backup parts
$statistics = Factory::getStatistics();
$stat = $statistics->getRecord();
$this->backupParts = Factory::getStatistics()->get_all_filenames($stat, false);
if (is_null($this->backupParts))
{
// No archive produced, or they are all already post-processed
Factory::getLog()->info('No archive files found to post-process');
return true;
}
Factory::getLog()->debug(count($this->backupParts) . ' files to process found');
$this->subStepsTotal = count($this->backupParts);
$this->subStepsDone = 0;
$this->backupPartsIndex = 0;
// If we have an empty array, do not run
if (empty($this->backupParts))
{
return true;
}
// Break step before processing?
if (
$postProcEngine->recommendsBreakBefore()
&& !$configuration->get(
'akeeba.tuning.nobreak.finalization', 0
)
)
{
Factory::getLog()->debug('Breaking step before post-processing run');
$configuration->set('volatile.breakflag', true);
return false;
}
return null;
}
}PK \^^ ^ B vendor/akeeba/engine/engine/Core/Domain/Finalizer/RemoteQuotas.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Core\Domain\Finalization;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use DateTime;
use Exception;
class RemoteQuotas extends AbstractQuotaManagement
{
/** @inheritDoc */
public function __construct(Finalization $finalizationPart)
{
$this->quotaType = 'remote';
$this->configKeys = [
'maxAgeEnable' => 'akeeba.quota.remotely.maxage.enable',
'maxAgeDays' => 'akeeba.quota.remotely.maxage.maxdays',
'maxAgeKeep' => 'akeeba.quota.remotely.maxage.keepday',
'countEnable' => 'akeeba.quota.remotely.enable_count_quota',
'countValue' => 'akeeba.quota.remotely.count_quota',
'sizeEnable' => 'akeeba.quota.remotely.enable_size_quota',
'sizeValue' => 'akeeba.quota.remotely.size_quota',
];
parent::__construct($finalizationPart);
}
/** @inheritDoc */
protected function getAllRecords(): array
{
$configuration = Factory::getConfiguration();
$useLatest = $configuration->get('akeeba.quota.remote_latest', '1') == 1;
// Get all records with a remote filename and filter out the current record and frozen records
$allRecords = array_filter(
Platform::getInstance()->get_valid_remote_records() ?: [],
function (array $stat) use ($useLatest): bool {
// Exclude frozen records from quota management
if (isset($stat['frozen']) && $stat['frozen'])
{
Factory::getLog()->debug(
sprintf(
'Excluding frozen backup id %d from %s quota management',
$stat['id'],
$this->quotaType
)
);
return false;
}
// Exclude the current record from the remote quota management
return $useLatest ? true : ($stat['id'] != $this->latestBackupId);
}
);
// Convert stat records to entries used in quota management
return array_map(
function (array $stat): array {
$remoteFilenames = $this->getRemoteFiles($stat['remote_filename'], $stat['multipart']);
try
{
$backupStart = new DateTime($stat['backupstart']);
$backupTS = $backupStart->format('U');
$backupDay = $backupStart->format('d');
}
catch (Exception $e)
{
$backupTS = 0;
$backupDay = 0;
}
// Get the log file name
$tag = $stat['tag'] ?? 'backend';
$backupId = $stat['backupid'] ?? '';
$logName = '';
if (!empty($backupId))
{
$logName = 'akeeba.' . $tag . '.' . $backupId . '.log.php';
}
return [
'id' => $stat['id'],
'filenames' => $remoteFilenames,
'size' => $stat['total_size'],
'backupstart' => $backupTS,
'day' => $backupDay,
'logname' => $logName,
'absolute_path' => $stat['absolute_path'],
];
},
$allRecords
);
}
/**
* Performs the actual removal.
*
* @param array $removeBackupIDs The backup IDs which will have their files removed
* @param array $filesToRemove The flat list of files to remove
* @param array $removeLogPaths The flat list of log paths to remove
*
* @return bool True if we are done, false to come back in the next step of the engine
* @throws Exception
* @since 9.3.1
*/
protected function processRemovals(array &$removeBackupIDs, array &$filesToRemove, array &$removeLogPaths): bool
{
$timer = Factory::getTimer();
// Update the statistics record with the removed remote files
if (!empty($removeBackupIDs))
{
Factory::getLog()->debug(
sprintf(
'Applying %s quotas: updating backup records',
$this->quotaType
)
);
}
while (!empty($removeBackupIDs) && $timer->getTimeLeft() > 0)
{
$id = array_shift($removeBackupIDs);
$data = ['remote_filename' => ''];
Platform::getInstance()->set_or_update_statistics($id, $data);
}
// Check if I have enough time
if ($timer->getTimeLeft() <= 0)
{
return false;
}
// Apply quotas upon backup records
if (!empty($filesToRemove) > 0)
{
Factory::getLog()->debug(
sprintf(
'Applying %s quotas: removing backup archives',
$this->quotaType
)
);
}
while (!empty($filesToRemove) && $timer->getTimeLeft() > 0)
{
$filename = array_shift($filesToRemove);
[$engineName, $path] = explode('://', $filename);
$engine = Factory::getPostprocEngine($engineName);
if (!$engine->supportsDelete())
{
continue;
}
Factory::getLog()->debug(
sprintf(
'Removing remotely stored file %s',
$filename
)
);
try
{
$engine->delete($path);
}
catch (Exception $e)
{
Factory::getLog()->debug(
sprintf(
'Could not remove remotely stored file. Error: %s',
$e->getMessage()
)
);
}
}
// Check if I have enough time
if ($timer->getTimeLeft() <= 0)
{
return false;
}
// Apply quotas to log files
if (!empty($removeLogPaths))
{
Factory::getLog()->debug(
sprintf(
'Applying %s quotas: removing obsolete log files',
$this->quotaType
)
);
Factory::getLog()->debug('Removing obsolete log files');
}
while (!empty($removeLogPaths) && $timer->getTimeLeft() > 0)
{
$logPath = array_shift($removeLogPaths);
if (@Platform::getInstance()->unlink($logPath))
{
continue;
}
Factory::getLog()->debug(
sprintf(
'Failed to remove old log file %s',
$logPath
)
);
}
// Check if I have enough time
if ($timer->getTimeLeft() <= 0)
{
return false;
}
return true;
}
/**
* Get the full paths to all remote backup parts
*
* @param string $filename The full filename of the last part stored in the database
* @param int $multipart How many parts does this archive consist of?
*
* @return array A list of the full paths of all remotely stored backup archive parts
* @since 9.3.1
*/
private function getRemoteFiles(string $filename, int $multipart): array
{
$result = [];
$extension = substr($filename, -3);
$base = substr($filename, 0, -4);
$extensionPrefix = substr($extension, 0, 1);
$result[] = $filename;
if ($multipart <= 1)
{
return $result;
}
for ($i = 1; $i < $multipart; $i++)
{
$newExt = $extensionPrefix . sprintf('%02u', $i);
$result[] = $base . '.' . $newExt;
}
return $result;
}
}PK \7 7 M vendor/akeeba/engine/engine/Core/Domain/Finalizer/AbstractQuotaManagement.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
use DateTime;
use Exception;
abstract class AbstractQuotaManagement extends AbstractFinalizer
{
/**
* Abstraction for the engine configuration keys used in the concrete quota management class.
*
* @since 9.3.1
* @var string[]
*/
protected $configKeys = [
'maxAgeEnable' => 'akeeba.quota.maxage.enable',
'maxAgeDays' => 'akeeba.quota.maxage.maxdays',
'maxAgeKeep' => 'akeeba.quota.maxage.keepday',
'countEnable' => 'akeeba.quota.enable_count_quota',
'countValue' => 'akeeba.quota.count_quota',
'sizeEnable' => 'akeeba.quota.enable_size_quota',
'sizeValue' => 'akeeba.quota.size_quota',
];
/**
* The ID of the latest backup (the one we are running in right now)
*
* @since 9.3.1
* @var int
*/
protected $latestBackupId;
/**
* Human-readable quote type e.g. 'local', 'remote', etc. for the concrete quota management class.
*
* @since 9.3.1
* @var string
*/
protected $quotaType = 'local';
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep(
sprintf(
'Applying %s quotas',
$this->quotaType
)
);
$this->setSubstep('');
// If no quota settings are enabled, quit
$configuration = Factory::getConfiguration();
$timer = Factory::getTimer();
$useDayQuotas = $configuration->get($this->configKeys['maxAgeEnable']);
$useCountQuotas = $configuration->get($this->configKeys['countEnable']);
$useSizeQuotas = $configuration->get($this->configKeys['sizeEnable']);
if (!($useDayQuotas || $useCountQuotas || $useSizeQuotas))
{
Factory::getLog()->debug(
sprintf(
'No %s quotas were defined; old backup files will be kept intact',
$this->quotaType
)
);
return true;
}
// Get the latest backup ID
$statistics = Factory::getStatistics();
$this->latestBackupId = $statistics->getId();
// Try to load the calculated quotas from the volatile keys
$keyIsCalculated = sprintf('volatile.quotas.%s.calculated', $this->quotaType);
$keyRemoveBackupIDs = sprintf('volatile.quotas.%s.removeBackupIDs', $this->quotaType);
$keyRemoveLogPaths = sprintf('volatile.quotas.%s.removeLogPaths', $this->quotaType);
$keyFilesToRemove = sprintf('volatile.quotas.%s.filesToRemove', $this->quotaType);
$isCalculated = $configuration->get($keyIsCalculated, false);
$removeBackupIDs = $configuration->get($keyRemoveBackupIDs, []);
$removeLogPaths = $configuration->get($keyRemoveLogPaths, []);
$filesToRemove = $configuration->get($keyFilesToRemove, []);
// Calculate the quotas if nothing was calculated just yet.
if (!$isCalculated)
{
// Calculate the quotas. If nothing is found, return immediately.
if ($this->calculateQuotas($allRecords, $removeBackupIDs, $removeLogPaths, $filesToRemove) === false)
{
return true;
}
$this->saveCalculatedQuotas($removeBackupIDs, $removeLogPaths, $filesToRemove);
// Do I have enough time to process removals?
if ($timer->getTimeLeft() <= 0)
{
return false;
}
}
// Process a chunk of removals
if (!$this->processRemovals($removeBackupIDs, $filesToRemove, $removeLogPaths))
{
$this->saveCalculatedQuotas($removeBackupIDs, $removeLogPaths, $filesToRemove);
return false;
}
$removeBackupIDs = null;
$removeLogPaths = null;
$filesToRemove = null;
$this->saveCalculatedQuotas($removeBackupIDs, $removeLogPaths, $filesToRemove);
return true;
}
/**
* Get all the backup records to apply quotas on.
*
* @return array
*
* @since 9.3.1
*/
abstract protected function getAllRecords(): array;
/**
* Processes a list of records for removal. The removal DOES NOT take place here.
*
* @param array $allRecords The records to process
* @param array $removeBackupIDs Running tally of backup IDs to remove files from
* @param array $removeLogPaths Running tally of log entries to remove
* @param array $ret Running tally of arrays of files to remove
* @param array $leftover Leftover records to be processed by the next quota rule
*
* @since 9.3.1
*/
protected function markAllRecordsForRemoval(array &$allRecords, array &$removeBackupIDs, array &$removeLogPaths, array &$ret, array &$leftover)
{
foreach ($allRecords as $def)
{
if ($def['id'] != $this->latestBackupId)
{
continue;
}
$temp = array_pop($leftover);
$leftover[] = $def;
array_unshift($allRecords, $temp);
break;
}
foreach ($allRecords as $def)
{
$ret[] = $def['filenames'];
$removeBackupIDs[] = $def['id'];
if (empty($def['logname']))
{
continue;
}
$filePath = $def['absolute_path'];
if (empty($filePath))
{
continue;
}
$logPath = dirname($filePath) . '/' . $def['logname'];
if (@file_exists($logPath))
{
$removeLogPaths[] = $logPath;
continue;
}
$altLogPath = substr($logPath, 0, -4);
if (@file_exists($altLogPath))
{
/**
* Bad host: the log file akeeba.tag.log.php may not exist but the akeeba.tag.log file
* does. This code addresses this problem.
*/
$removeLogPaths[] = $altLogPath;
}
}
}
/**
* Performs the actual removal.
*
* @param array $removeBackupIDs The backup IDs which will have their files removed
* @param array $filesToRemove The flat list of files to remove
* @param array $removeLogPaths The flat list of log paths to remove
*
* @return bool True if we are done, false to come back in the next step of the engine
* @throws Exception
* @since 9.3.1
*/
abstract protected function processRemovals(array &$removeBackupIDs, array &$filesToRemove, array &$removeLogPaths): bool;
/**
* Applies the Count Quotas.
*
* @param array $allRecords All records left to process
* @param array $removeBackupIDs Running tally of backup IDs to remove files from
* @param array $removeLogPaths Running tally of log entries to remove
* @param array $ret Running tally of arrays of files to remove
*
* @return void
* @since 9.3.1
*/
private function applyCountQuotas(array &$allRecords, array &$removeBackupIDs, array &$removeLogPaths, array &$ret)
{
$configuration = Factory::getConfiguration();
$useCountQuotas = $configuration->get($this->configKeys['countEnable']);
$countQuota = $configuration->get($this->configKeys['countValue']);
// Do we need to apply count quotas?
if (!$useCountQuotas || !is_numeric($countQuota) || $countQuota <= 0)
{
return;
}
// We should only run a count quota if there are more files than the set limit
if (count($allRecords) <= $countQuota)
{
return;
}
Factory::getLog()->debug(
sprintf(
'Processing %s count quotas',
$this->quotaType
)
);
/**
* Backups are sorted by reverse ID order, e.g. 200, 199, 198, 197, 196, 195, 194, 193, 192, 191, 190, 189, 188.
* I need to keep the first $countQuota records in $leftover and process the remaining records.
*/
$leftover = array_slice($allRecords, 0, $countQuota);
$allRecords = array_slice($allRecords, $countQuota);
$this->markAllRecordsForRemoval($allRecords, $removeBackupIDs, $removeLogPaths, $ret, $leftover);
$allRecords = $leftover;
}
/**
* Applies the Day-Based Quotas.
*
* @param array $allRecords All records left to process
* @param array $removeBackupIDs Running tally of backup IDs to remove files from
* @param array $removeLogPaths Running tally of log entries to remove
* @param array $ret Running tally of arrays of files to remove
*
* @return void
* @since 9.3.1
*/
private function applyDayQuotas(array &$allRecords, array &$removeBackupIDs, array &$removeLogPaths, array &$ret): void
{
$configuration = Factory::getConfiguration();
$daysQuota = $configuration->get($this->configKeys['maxAgeDays']);
$preserveDay = $configuration->get($this->configKeys['maxAgeKeep']);
$leftover = [];
$killDatetime = new DateTime();
$killDatetime->modify('-' . $daysQuota . ($daysQuota == 1 ? ' day' : ' days'));
$killTS = $killDatetime->format('U');
/**
* Move the following kind of records FROM allRecords TO leftover:
* - Current backup record
* - Backups on a preserve day
* - Backups newer than the earliest removal date
*/
$allRecords = array_filter(
$allRecords,
function (array $def) use ($killDatetime, $killTS, $preserveDay, &$leftover): bool {
if ($def['id'] == $this->latestBackupId)
{
$leftover[] = $def;
return false;
}
// Is this on a preserve day?
if ($preserveDay > 0 && $def['day'] == $preserveDay)
{
$leftover[] = $def;
return false;
}
// Otherwise, check the timestamp
if ($def['backupstart'] >= $killTS)
{
$leftover[] = $def;
return false;
}
return true;
}
);
$this->markAllRecordsForRemoval($allRecords, $removeBackupIDs, $removeLogPaths, $ret, $leftover);
$allRecords = $leftover;
}
/**
* Applies the Maximum Size Quotas.
*
* @param array $allRecords All records left to process
* @param array $removeBackupIDs Running tally of backup IDs to remove files from
* @param array $removeLogPaths Running tally of log entries to remove
* @param array $ret Running tally of arrays of files to remove
*
* @return void
* @since 9.3.1
*/
private function applySizeQuotas(array &$allRecords, array &$removeBackupIDs, array &$removeLogPaths, array &$ret)
{
$configuration = Factory::getConfiguration();
$useSizeQuotas = $configuration->get($this->configKeys['sizeEnable']);
$sizeQuota = $configuration->get($this->configKeys['sizeValue']);
// Do we need to apply size quotas?
if (!$useSizeQuotas || !is_numeric($sizeQuota) || $sizeQuota <= 0 || count($allRecords) <= 0)
{
return;
}
Factory::getLog()->debug(
sprintf(
'Processing %s size quotas',
$this->quotaType
)
);
// First I will find how many elements of the array I need to get to the $sizeQuota size.
$runningSize = 0;
$numberOfRecords = 0;
foreach ($allRecords as $def)
{
$numberOfRecords++;
if ($def['id'] == $this->latestBackupId)
{
continue;
}
$runningSize += $def['size'];
if ($runningSize >= $sizeQuota)
{
break;
}
}
$leftover = array_slice($allRecords, 0, $numberOfRecords);
$allRecords = array_slice($allRecords, $numberOfRecords);
$this->markAllRecordsForRemoval($allRecords, $removeBackupIDs, $removeLogPaths, $ret, $leftover);
$allRecords = $leftover;
}
private function calculateQuotas(&$allRecords, &$removeBackupIDs, &$removeLogPaths, &$filesToRemove): bool
{
$configuration = Factory::getConfiguration();
$useDayQuotas = $configuration->get($this->configKeys['maxAgeEnable']);
$allRecords = $this->getAllRecords();
// If there are no files, exit early
if (count($allRecords) == 0)
{
Factory::getLog()->debug(
sprintf(
'There were no old backup records to apply %s quotas on',
$this->quotaType
)
);
return false;
}
// Init arrays
$removeBackupIDs = [];
$removeLogPaths = [];
$ret = [];
// Do we need to apply maximum backup age quotas?
if ($useDayQuotas)
{
$this->applyDayQuotas($allRecords, $removeBackupIDs, $removeLogPaths, $ret);
}
else
{
$this->applyCountQuotas($allRecords, $removeBackupIDs, $removeLogPaths, $ret);
$this->applySizeQuotas($allRecords, $removeBackupIDs, $removeLogPaths, $ret);
}
// Convert the $ret 2-dimensional array to single dimensional
$filesToRemove = [];
foreach ($ret as $temp)
{
$filesToRemove = array_merge($filesToRemove ?? [], $temp);
}
return true;
}
/**
* Save the calculated quotas into the volatile storage
*
* @param array|null $removeBackupIDs Running tally of backup IDs to remove files from
* @param array|null $removeLogPaths Running tally of log entries to remove
* @param array|null $filesToRemove The flat list of files to remove
*
* @return void
* @since 9.3.1
*/
private function saveCalculatedQuotas(?array &$removeBackupIDs, ?array &$removeLogPaths, ?array &$filesToRemove): void
{
$configuration = Factory::getConfiguration();
$keyIsCalculated = sprintf('volatile.quotas.%s.calculated', $this->quotaType);
$keyRemoveBackupIDs = sprintf('volatile.quotas.%s.removeBackupIDs', $this->quotaType);
$keyRemoveLogPaths = sprintf('volatile.quotas.%s.removeLogPaths', $this->quotaType);
$keyFilesToRemove = sprintf('volatile.quotas.%s.filesToRemove', $this->quotaType);
$isCalculated = $removeBackupIDs !== null || $removeLogPaths !== null || $filesToRemove !== null;
if ($isCalculated)
{
$configuration->set($keyIsCalculated, true);
$configuration->set($keyRemoveBackupIDs, $removeBackupIDs);
$configuration->set($keyRemoveLogPaths, $removeLogPaths);
$configuration->set($keyFilesToRemove, $filesToRemove);
return;
}
$configuration->remove($keyIsCalculated);
$configuration->remove($keyRemoveBackupIDs);
$configuration->remove($keyRemoveLogPaths);
$configuration->remove($keyFilesToRemove);
}
}PK \&m E vendor/akeeba/engine/engine/Core/Domain/Finalizer/UploadKickstart.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Exception;
use Akeeba\Engine\Psr\Log\LogLevel;
/**
* Uploads Kickstart using the post-processing engine
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*/
final class UploadKickstart extends AbstractFinalizer
{
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep('Post-processing Kickstart');
$this->setSubstep('');
$configuration = Factory::getConfiguration();
// Do not run if we are not told to upload Kickstart
$uploadKickstart = $configuration->get('akeeba.advanced.uploadkickstart', 0);
if (!$uploadKickstart)
{
return true;
}
$engineName = $configuration->get('akeeba.advanced.postproc_engine');
Factory::getLog()->debug("Loading post-processing engine object ($engineName)");
$postProcEngine = Factory::getPostprocEngine($engineName);
// Prefer XOR-encoded kickstart.dat (obfuscated to defeat host scanners); fall back to plain kickstart.txt.
$xorKey = 'ThisIsKickstartCoreWhichIsNotMaliciousYouCanDownloadItFromAkeebaDotComIfYouWant';
$installerPath = Platform::getInstance()->get_installer_images_path();
$encodedPath = $installerPath . '/kickstart.dat';
$plainPath = $installerPath . '/kickstart.txt';
$isTempFile = false;
if (@file_exists($encodedPath) && is_file($encodedPath))
{
$encoded = file_get_contents($encodedPath);
$fullKey = str_repeat($xorKey, (int) ceil(strlen($encoded) / strlen($xorKey)));
$filename = tempnam(sys_get_temp_dir(), 'ksdat_');
$isTempFile = true;
file_put_contents($filename, $encoded ^ substr($fullKey, 0, strlen($encoded)));
}
elseif (@file_exists($plainPath) && is_file($plainPath))
{
$filename = $plainPath;
}
else
{
Factory::getLog()->warning(
sprintf('Failed to upload kickstart.php. Missing file %s', $encodedPath)
);
// Indicate we're done.
return true;
}
// Post-process the file
$this->setSubstep('kickstart.php');
$exception = null;
$finishedProcessing = false;
try
{
$finishedProcessing = $postProcEngine->processPart($filename, 'kickstart.php');
}
catch (Exception $e)
{
$exception = $e;
}
finally
{
if ($isTempFile)
{
@unlink($filename);
}
}
if (!is_null($exception))
{
Factory::getLog()->warning('Failed to upload kickstart.php');
Factory::getLog()->warning('Error received from the post-processing engine:');
$this->logErrorsFromException($exception, LogLevel::WARNING);
}
elseif ($finishedProcessing === true)
{
// The post-processing of this file ended successfully
Factory::getLog()->info('Finished uploading kickstart.php');
$configuration->set('volatile.postproc.filename', null);
}
// Indicate we're done
return true;
}
}PK \X.
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
/**
* Removes temporary files.
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*
*/
final class RemoveTemporaryFiles extends AbstractFinalizer
{
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep('Removing temporary files');
$this->setSubstep('');
Factory::getLog()->debug("Removing temporary files");
Factory::getTempFiles()->deleteTempFiles();
return true;
}
}PK \g A vendor/akeeba/engine/engine/Core/Domain/Finalizer/LocalQuotas.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use DateTime;
use Exception;
final class LocalQuotas extends AbstractQuotaManagement
{
/**
* Get all the backup records to apply quotas on.
*
* @return array
*
* @since 9.3.1
*/
protected function getAllRecords(): array
{
// Get valid-looking backup ID's
$validIDs = Platform::getInstance()->get_valid_backup_records(true) ?: [];
// Create a list of valid files
$allFiles = [];
$statistics = Factory::getStatistics();
foreach ($validIDs as $id)
{
$stat = Platform::getInstance()->get_statistics($id);
// Exclude frozen record from quota management
if (isset($stat['frozen']) && $stat['frozen'])
{
Factory::getLog()->debug(
sprintf(
'Excluding frozen backup id %d from %s quota management',
$id,
$this->quotaType
)
);
continue;
}
try
{
$backupstart = new DateTime($stat['backupstart']);
$backupTS = $backupstart->format('U');
$backupDay = $backupstart->format('d');
}
catch (Exception $e)
{
$backupTS = 0;
$backupDay = 0;
}
// Get the log file name
$tag = $stat['tag'];
$backupId = $stat['backupid'] ?? '';
$logName = '';
if (!empty($backupId))
{
$logName = 'akeeba.' . $tag . '.' . $backupId . '.log.php';
}
// Multipart processing
$filenames = $statistics->get_all_filenames($stat, true);
// Only process existing files
if (is_null($filenames))
{
continue;
}
$filesize = 0;
foreach ($filenames as $filename)
{
$filesize += @filesize($filename);
}
$allFiles[] = [
'id' => $id,
'filenames' => $filenames,
'size' => $filesize,
'backupstart' => $backupTS,
'day' => $backupDay,
'logname' => $logName,
'absolute_path' => $stat['absolute_path'],
];
}
return $allFiles;
}
/**
* Performs the actual removal.
*
* @param array $removeBackupIDs The backup IDs which will have their files removed
* @param array $filesToRemove The flat list of files to remove
* @param array $removeLogPaths The flat list of log paths to remove
*
* @return bool True if we are done, false to come back in the next step of the engine
* @throws Exception
* @since 9.3.1
*/
protected function processRemovals(array &$removeBackupIDs, array &$filesToRemove, array &$removeLogPaths): bool
{
$timer = Factory::getTimer();
// Update the statistics record with the removed remote files
if (!empty($removeBackupIDs))
{
Factory::getLog()->debug(
sprintf(
'Applying %s quotas: updating backup records',
$this->quotaType
)
);
}
while (!empty($removeBackupIDs) && $timer->getTimeLeft() > 0)
{
$id = array_shift($removeBackupIDs);
$data = ['filesexist' => '0'];
Platform::getInstance()->set_or_update_statistics($id, $data);
}
// Check if I have enough time
if ($timer->getTimeLeft() <= 0)
{
return false;
}
// Apply quotas upon backup records
if (!empty($filesToRemove) > 0)
{
Factory::getLog()->debug(
sprintf(
'Applying %s quotas: removing backup archives',
$this->quotaType
)
);
}
while (!empty($filesToRemove) && $timer->getTimeLeft() > 0)
{
$file = array_shift($filesToRemove);
if (@Platform::getInstance()->unlink($file))
{
continue;
}
Factory::getLog()->warning(
sprintf(
'Failed to remove old backup file %s',
$file
)
);
}
// Check if I have enough time
if ($timer->getTimeLeft() <= 0)
{
return false;
}
// Apply quotas to log files
if (!empty($removeLogPaths))
{
Factory::getLog()->debug(
sprintf(
'Applying %s quotas: removing obsolete log files',
$this->quotaType
)
);
Factory::getLog()->debug('Removing obsolete log files');
}
while (!empty($removeLogPaths) && $timer->getTimeLeft() > 0)
{
$logPath = array_shift($removeLogPaths);
if (@Platform::getInstance()->unlink($logPath))
{
continue;
}
Factory::getLog()->debug(
sprintf(
'Failed to remove old log file %s',
$logPath
)
);
}
// Check if I have enough time
if ($timer->getTimeLeft() <= 0)
{
return false;
}
return true;
}
}PK \kcn
n
E vendor/akeeba/engine/engine/Core/Domain/Finalizer/UpdateFileSizes.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
/**
* Updates the file sizes in the statistics records
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*
*/
final class UpdateFileSizes extends AbstractFinalizer
{
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep('Updating file sizes');
$this->setSubstep('');
Factory::getLog()->debug("Updating statistics with file sizes");
// Fetch the stats record
$statistics = Factory::getStatistics();
$configuration = Factory::getConfiguration();
$record = $statistics->getRecord();
$filenames = $statistics->get_all_filenames($record) ?: [];
$filesize = 0.0;
// Calculate file sizes of files remaining on the server
foreach ($filenames as $file)
{
$filesize += ((@filesize($file)) ?: 0) * 1.0;
}
// Get the part size in volatile storage, set from the immediate part uploading effected by the
// "Process each part immediately" option, and add it to the total file size
$config = $configuration;
$postProcImmediately = $config->get('engine.postproc.common.after_part', 0, false);
$deleteAfter = $config->get('engine.postproc.common.delete_after', 0, false);
$postProcEngine = $config->get('akeeba.advanced.postproc_engine', 'none');
if ($postProcImmediately && $deleteAfter && ($postProcEngine != 'none'))
{
$filesize += $configuration->get('volatile.engine.archiver.totalsize', 0) ?: 0;
}
$data = [
'total_size' => $filesize,
];
Factory::getLog()->debug("Total size of backup archive (in bytes): $filesize");
$statistics->setStatistics($data);
return true;
}
}PK \x F vendor/akeeba/engine/engine/Core/Domain/Finalizer/UpdateStatistics.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Exception;
/**
* Updates the backup statistics record
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*/
final class UpdateStatistics extends AbstractFinalizer
{
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep('Updating backup record information');
$this->setSubstep('');
Factory::getLog()->debug('Updating statistics');
// We finished normally. Fetch the stats record
$statistics = Factory::getStatistics();
$registry = Factory::getConfiguration();
$data = [
'backupend' => Platform::getInstance()->get_timestamp_database(),
'status' => 'complete',
'multipart' => $registry->get('volatile.statistics.multipart', 0),
];
try
{
$result = $statistics->setStatistics($data);
}
catch (Exception $e)
{
$result = false;
}
if ($result === false)
{
// Most likely a "MySQL has gone away" issue...
$configuration = Factory::getConfiguration();
$configuration->set('volatile.breakflag', true);
return false;
}
/**
* We could have handled it in $data above. However, if the schema has not been updated this function will
* continue failing infinitely, causing the backup to never end.
*/
$statistics->updateInStep(false);
$stat = (object) $statistics->getRecord();
Platform::getInstance()->remove_duplicate_backup_records($stat->archivename);
return true;
}
}PK \ht G vendor/akeeba/engine/engine/Core/Domain/Finalizer/AbstractFinalizer.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Core\Domain\Finalization;
use Akeeba\Engine\Psr\Log\LogLevel;
/**
* Abstract implementation of a finalizer class
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*/
abstract class AbstractFinalizer implements FinalizerInterface
{
/**
* The part we belong to
*
* @since 9.3.1
* @var Finalization
*/
private $finalizationPart;
/**
* Public constructor
*
* @param Finalization $finalizationPart The part we belong to.
*
* @since 9.3.1
*/
public function __construct(Finalization $finalizationPart)
{
$this->finalizationPart = $finalizationPart;
}
/**
* Relays an exception so it can be logged
*
* @param \Throwable $e
* @param string $logLevel
*
* @return void
* @since 9.3.1
*/
protected function logErrorsFromException(\Throwable $e, string $logLevel = LogLevel::ERROR): void
{
$this->finalizationPart->relayException($e, $logLevel);
}
/**
* Relays the current step back to the parent finalization engine part
*
* @param string $step The step name to set
*
* @return void
* @since 9.3.1
*/
protected function setStep(string $step): void
{
$this->finalizationPart->relayStep($step);
}
/**
* Relays the current sub-step back to the parent finalization engine part
*
* @param string $substep The sub-step name to set
*
* @return void
* @since 9.3.1
*/
protected function setSubstep(string $substep): void
{
$this->finalizationPart->relaySubstep($substep);
}
}PK \NGy y H vendor/akeeba/engine/engine/Core/Domain/Finalizer/FinalizerInterface.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Core\Domain\Finalization;
use Exception;
/**
* Interface to a finalizer invokable class.
*
* @since 9.3.1
*/
interface FinalizerInterface
{
/**
* Public constructor
*
* @param Finalization $finalizationPart The part we belong to.
*
* @since 9.3.1
*/
public function __construct(Finalization $finalizationPart);
/**
* Executes the finalizer job. Returns true when done, false if it needs to run further.
*
* @return bool True if we are fully done. False if we must be called again.
* @throws Exception When an error occurs.
*
* @since 9.3.1
*/
public function __invoke();
}PK \)l % % C vendor/akeeba/engine/engine/Core/Domain/Finalizer/LogFileQuotas.phpnu [ .
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use DateTime;
use Exception;
/**
* Applies quota management to backup log files, deleting old log files per the configured policy.
*
* @since 10.3.3
* @package Akeeba\Engine\Core\Domain\Finalizer
*/
final class LogFileQuotas extends AbstractFinalizer
{
private const KEY_CALCULATED = 'volatile.quotas.logfiles.calculated';
private const KEY_REMOVE_LOG_PATHS = 'volatile.quotas.logfiles.removeLogPaths';
/**
* @inheritDoc
*/
public function __invoke(): bool
{
$this->setStep('Applying log file quotas');
$this->setSubstep('');
$configuration = Factory::getConfiguration();
$timer = Factory::getTimer();
$quotaMode = (int) $configuration->get('akeeba.quota.enable_logfiles', 0);
if ($quotaMode === 0)
{
Factory::getLog()->debug('Log file quotas are disabled; log files will be kept intact.');
return true;
}
$isCalculated = (bool) $configuration->get(self::KEY_CALCULATED, false);
$removeLogPaths = $configuration->get(self::KEY_REMOVE_LOG_PATHS, []) ?: [];
if (!$isCalculated)
{
$candidates = $this->collectCandidates();
$removeLogPaths = $this->calculateRemovePaths($candidates, $configuration);
$configuration->set(self::KEY_CALCULATED, true);
$configuration->set(self::KEY_REMOVE_LOG_PATHS, $removeLogPaths);
if ($timer->getTimeLeft() <= 0)
{
return false;
}
}
while (!empty($removeLogPaths) && $timer->getTimeLeft() > 0)
{
$logPath = array_shift($removeLogPaths);
if (!@Platform::getInstance()->unlink($logPath))
{
Factory::getLog()->warning(sprintf('Failed to remove log file %s', $logPath));
}
else
{
Factory::getLog()->debug(sprintf('Removed log file %s', $logPath));
}
}
$configuration->set(self::KEY_REMOVE_LOG_PATHS, $removeLogPaths);
if (!empty($removeLogPaths))
{
return false;
}
$configuration->remove(self::KEY_CALCULATED);
$configuration->remove(self::KEY_REMOVE_LOG_PATHS);
return true;
}
/**
* Collects log file candidates from the database for the current profile.
*
* @return array Each entry has keys: id, logpath, size, backupstart
* @since 10.3.3
*/
private function collectCandidates(): array
{
$platform = Platform::getInstance();
$db = Factory::getDatabase($platform->get_platform_database_options());
$statsTable = $platform->tableNameStats;
$profileId = $platform->get_active_profile();
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
$db->qn('tag'),
$db->qn('backupid'),
$db->qn('absolute_path'),
$db->qn('backupstart'),
$db->qn('frozen'),
])
->from($db->qn($statsTable))
->where($db->qn('profile_id') . ' = ' . $db->q($profileId))
->order($db->qn('id') . ' DESC');
$db->setQuery($query);
$records = $db->loadAssocList();
$candidates = [];
foreach ($records as $stat)
{
if (!empty($stat['frozen']))
{
Factory::getLog()->debug(
sprintf('Excluding frozen backup id %d from log file quota management', $stat['id'])
);
continue;
}
if (empty($stat['absolute_path']) || empty($stat['backupid']))
{
continue;
}
$logPath = $this->resolveLogPath($stat);
if ($logPath === null)
{
continue;
}
$backupTS = 0;
if (!empty($stat['backupstart']))
{
try
{
$dt = new DateTime($stat['backupstart']);
$backupTS = (int) $dt->format('U');
}
catch (Exception $e)
{
$backupTS = 0;
}
}
$candidates[] = [
'id' => (int) $stat['id'],
'logpath' => $logPath,
'size' => (int) (@filesize($logPath) ?: 0),
'backupstart' => $backupTS,
];
}
return $candidates;
}
/**
* Resolves the log file path for a backup record, handling the transitional .log.php → .log fallback.
*
* @param array $stat The backup record fields
*
* @return string|null The path to the log file, or null if no log file exists on disk
* @since 10.3.3
*/
private function resolveLogPath(array $stat): ?string
{
$logDir = dirname($stat['absolute_path']);
$logFilename = 'akeeba.' . $stat['tag'] . '.' . $stat['backupid'] . '.log.php';
$primaryPath = $logDir . '/' . $logFilename;
if (@file_exists($primaryPath))
{
return $primaryPath;
}
// Transitional period: the .log.php file may not exist but the .log file does
$altPath = substr($primaryPath, 0, -4);
if (@file_exists($altPath))
{
return $altPath;
}
return null;
}
/**
* Determines which log files to remove based on the configured quota type.
*
* @param array $candidates Log file candidates, sorted newest-first
* @param object $configuration The engine configuration object
*
* @return array List of log file paths to remove
* @since 10.3.3
*/
private function calculateRemovePaths(array $candidates, $configuration): array
{
if (empty($candidates))
{
Factory::getLog()->debug('No log file candidates found for quota management.');
return [];
}
$latestId = Factory::getStatistics()->getId();
$quotaType = $configuration->get('akeeba.quota.logfiles.type', 'count');
switch ($quotaType)
{
case 'size':
return $this->applyLogSizeQuota($candidates, $latestId, $configuration);
case 'days':
return $this->applyLogDaysQuota($candidates, $latestId, $configuration);
case 'count':
default:
return $this->applyLogCountQuota($candidates, $latestId, $configuration);
}
}
/**
* Applies a count-based quota: keep the N most recent log files.
*
* @param array $candidates Log file candidates, sorted newest-first
* @param int $latestId The current backup ID (never deleted)
* @param object $configuration The engine configuration object
*
* @return array
* @since 10.3.3
*/
private function applyLogCountQuota(array $candidates, int $latestId, $configuration): array
{
$count = max(1, (int) $configuration->get('akeeba.quota.logfiles.count', 3));
Factory::getLog()->debug(sprintf('Applying log file count quota: keep %d log files.', $count));
if (count($candidates) <= $count)
{
return [];
}
$toRemove = array_slice($candidates, $count);
$removePaths = [];
foreach ($toRemove as $entry)
{
if ($entry['id'] === $latestId)
{
continue;
}
$removePaths[] = $entry['logpath'];
}
return $removePaths;
}
/**
* Applies a size-based quota: keep log files totalling up to X bytes.
*
* @param array $candidates Log file candidates, sorted newest-first
* @param int $latestId The current backup ID (never deleted)
* @param object $configuration The engine configuration object
*
* @return array
* @since 10.3.3
*/
private function applyLogSizeQuota(array $candidates, int $latestId, $configuration): array
{
$sizeLimit = (int) $configuration->get('akeeba.quota.logfiles.size', 0);
if ($sizeLimit <= 0)
{
Factory::getLog()->debug('Log file size quota: limit is 0 or not set; no files removed.');
return [];
}
Factory::getLog()->debug(
sprintf('Applying log file size quota: keep up to %d bytes of log files.', $sizeLimit)
);
$runningSize = 0;
$keepCount = 0;
foreach ($candidates as $entry)
{
$keepCount++;
$runningSize += $entry['size'];
if ($entry['id'] !== $latestId && $runningSize >= $sizeLimit)
{
break;
}
}
$toRemove = array_slice($candidates, $keepCount);
$removePaths = [];
foreach ($toRemove as $entry)
{
if ($entry['id'] === $latestId)
{
continue;
}
$removePaths[] = $entry['logpath'];
}
return $removePaths;
}
/**
* Applies a days-based quota: keep log files from the last X days.
*
* @param array $candidates Log file candidates, sorted newest-first
* @param int $latestId The current backup ID (never deleted)
* @param object $configuration The engine configuration object
*
* @return array
* @since 10.3.3
*/
private function applyLogDaysQuota(array $candidates, int $latestId, $configuration): array
{
$days = max(1, (int) $configuration->get('akeeba.quota.logfiles.days', 30));
Factory::getLog()->debug(
sprintf('Applying log file days quota: keep log files from the last %d days.', $days)
);
$killDatetime = new DateTime();
$killDatetime->modify('-' . $days . ($days === 1 ? ' day' : ' days'));
$killTS = (int) $killDatetime->format('U');
$removePaths = [];
foreach ($candidates as $entry)
{
if ($entry['id'] === $latestId)
{
continue;
}
if ($entry['backupstart'] < $killTS)
{
$removePaths[] = $entry['logpath'];
}
}
return $removePaths;
}
}
PK \Sʉ ; vendor/akeeba/engine/engine/Core/Domain/Finalizer/.htaccessnu 7m
Order allow,deny
Deny from all
PK \>Ƥ K vendor/akeeba/engine/engine/Core/Domain/Finalizer/ObsoleteRecordsQuotas.phpnu [ .
*/
/**
* @package Akeeba\Engine\Core\Domain\Finalizer
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Core\Domain\Finalizer;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
/**
* Keeps a maximum number of "obsolete" records
*
* @since 9.3.1
* @package Akeeba\Engine\Core\Domain\Finalizer
*/
final class ObsoleteRecordsQuotas extends AbstractFinalizer
{
/**
* @inheritDoc
*/
public function __invoke()
{
$this->setStep('Applying quota limit on obsolete backup records');
$this->setSubstep('');
$registry = Factory::getConfiguration();
$limit = $registry->get('akeeba.quota.obsolete_quota', 0);
$limit = (int) $limit;
if ($limit <= 0)
{
return true;
}
$platform = Platform::getInstance();
$statsTable = $platform->tableNameStats;
$db = Factory::getDatabase($platform->get_platform_database_options());
$query =
(method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select([
$db->qn('id'),
$db->qn('tag'),
$db->qn('backupid'),
$db->qn('absolute_path'),
])
->from($db->qn($statsTable))
->where($db->qn('profile_id') . ' = ' . $db->q($platform->get_active_profile()))
->where($db->qn('status') . ' = ' . $db->q('complete'))
->where($db->qn('filesexist') . '=' . $db->q('0'))
->where(
'(' .
$db->qn('remote_filename') . '=' . $db->q('') . ' OR ' .
$db->qn('remote_filename') . ' IS NULL'
. ')'
)
->order($db->qn('id') . ' DESC');
$db->setQuery($query, $limit, 100000);
$records = $db->loadAssocList();
if (empty($records))
{
return true;
}
$array = [];
// Delete backup-specific log files if they exist and add the IDs of the records to delete in the $array
foreach ($records as $stat)
{
$array[] = $stat['id'];
// We can't delete logs if there is no backup ID in the record
if (!isset($stat['backupid']) || empty($stat['backupid']))
{
continue;
}
$logFileName = 'akeeba.' . $stat['tag'] . '.' . $stat['backupid'] . '.log.php';
$logPath = dirname($stat['absolute_path']) . '/' . $logFileName;
if (@file_exists($logPath))
{
@unlink($logPath);
}
/**
* Transitional period: the log file akeeba.tag.log.php may not exist but the akeeba.tag.log does. This
* addresses this transition.
*/
$logPath = dirname($stat['absolute_path']) . '/' . substr($logFileName, 0, -4);
if (@file_exists($logPath))
{
@unlink($logPath);
}
}
$ids = [];
foreach ($array as $id)
{
$ids[] = $db->q($id);
}
$ids = implode(',', $ids);
$query = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->delete($db->qn($statsTable))
->where($db->qn('id') . " IN ($ids)");
$db->setQuery($query);
$db->query();
return true;
}
}PK \z K K 5 vendor/akeeba/engine/engine/Core/Domain/Installer.phpnu [ .
*/
namespace Akeeba\Engine\Core\Domain;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\HashTrait;
/**
* Installer deployment
*/
final class Installer extends Part
{
use HashTrait;
/** @var int Installer image file offset last read */
private $offset;
/** @var int How much installer data I have processed yet */
private $runningSize = 0;
/** @var int Installer image file index last read */
private $xformIndex = 0;
/** @var int Percentage of process done */
private $progress = 0;
/**
* Public constructor
*
* @return void
*/
public function __construct()
{
parent::__construct();
Factory::getLog()->debug(__CLASS__ . " :: New instance");
}
/**
* Implements the _prepare abstract method
*
*/
function _prepare()
{
$archive = Factory::getArchiverEngine();
// Add the backup description and comment in a README.html file in the
// installation directory. This makes it the first file in the archive.
if (!empty($this->installerSettings->readme ?? ''))
{
$data = $this->createReadme();
$archive->addFileVirtual('README.html', $this->installerSettings->installerroot, $data);
}
if (!empty($this->installerSettings->extrainfo ?? ''))
{
$data = $this->createExtrainfo();
$archive->addFileVirtual('extrainfo.json', $this->installerSettings->installerroot, $data);
}
if (!empty($this->installerSettings->password ?? ''))
{
$data = $this->createPasswordFile();
if (!empty($data))
{
$archive->addFileVirtual('password.php', $this->installerSettings->installerroot, $data);
}
}
$this->progress = 0;
// Set our state to prepared
$this->setState(self::STATE_PREPARED);
}
/**
* Implements the _run() abstract method
*/
function _run()
{
if ($this->getState() == self::STATE_POSTRUN)
{
Factory::getLog()->debug(__CLASS__ . " :: Already finished");
$this->setStep('');
$this->setSubstep('');
}
else
{
$this->setState(self::STATE_RUNNING);
}
// Try to step the archiver
$archive = Factory::getArchiverEngine();
$ret = $archive->transformJPA($this->xformIndex, $this->offset);
if ($ret !== false)
{
$this->offset = $ret['offset'];
$this->xformIndex = $ret['index'];
$this->setStep($ret['filename']);
}
// Check for completion
if ($ret['done'])
{
Factory::getLog()->debug(__CLASS__ . ":: archive is initialized");
$this->setState(self::STATE_FINISHED);
}
// Calculate percentage
$this->runningSize += $ret['chunkProcessed'] ?? 0;
if ($ret['filesize'] > 0)
{
$this->progress = $this->runningSize / $ret['filesize'];
}
}
/**
* Implements the _finalize() abstract method
*
*/
function _finalize()
{
$this->setState(self::STATE_FINISHED);
$this->progress = 1;
}
/**
* Implements the progress calculation based on how much of the installer image
* archive we have processed so far.
*/
public function getProgress()
{
return $this->progress;
}
/**
* Creates the contents of an HTML file with the description and comment of
* the backup. This file will be saved as README.html in the installer's root
* directory, as specified by the embedded installer's settings.
*
* @return string The contents of the HTML file.
*/
protected function createReadme()
{
$config = Factory::getConfiguration();
$version = defined('AKEEBABACKUP_VERSION') ? AKEEBABACKUP_VERSION : AKEEBA_VERSION;
$date = defined('AKEEBABACKUP_DATE') ? AKEEBABACKUP_DATE : AKEEBA_DATE;
$pro = defined('AKEEBABACKUP_PRO') ? AKEEBABACKUP_PRO : AKEEBA_PRO;
$lbl_version = $version . ' (' . $date . ')';
$lbl_coreorpro = ($pro == 1) ? 'Professional' : 'Core';
$description = $config->get('volatile.core.description', '');
$comment = $config->get('volatile.core.comment', '');
$config->set('volatile.core.description', null);
$config->set('volatile.core.comment', null);
return <<Akeeba Backup Archive Identity
Akeeba Backup Archive Identity
Backup Description
$description
Backup Comment
$comment
Created with Akeeba Backup $lbl_coreorpro $lbl_version
ENDHTML;
}
protected function createExtrainfo()
{
$abversion = defined('AKEEBABACKUP_VERSION') ? AKEEBABACKUP_VERSION : AKEEBA_VERSION;
$host = Platform::getInstance()->get_host();
$backupdate = gmdate('Y-m-d H:i:s');
$phpversion = PHP_VERSION;
$rootPath = Platform::getInstance()->get_site_root();
$data = [
'host' => $host,
'backup_date' => $backupdate,
'akeeba_version' => $abversion,
'php_version' => $phpversion,
'root' => $rootPath,
];
$platform = Platform::getInstance();
try
{
$extraData = $platform->get_extra_info();
}
catch (\Exception $e)
{
// Not all platform classes implement get_extra_info(), therefore Platform will throw an Exception
$extraData = [];
}
$data = array_merge($data, $extraData);
$ret = json_encode($data, JSON_PRETTY_PRINT);
return $ret;
}
protected function createPasswordFile()
{
$config = Factory::getConfiguration();
$ret = '';
$password = $config->get('engine.installer.angie.key', '');
if (empty($password))
{
return $ret;
}
$randVal = Factory::getRandval();
$salt = $randVal->generateString(32);
$passhash = self::md5($password . $salt) . ':' . $salt;
$ret = ".
*/
namespace Akeeba\Engine\Core\Domain;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Dump\Base as DumpBase;
use Akeeba\Engine\Factory;
use RuntimeException;
/**
* Multiple database backup engine.
*/
final class Db extends Part
{
/** @var array A list of the databases to be packed */
private $database_list = [];
/** @var array The current database configuration data */
private $database_config = null;
/** @var DumpBase The current dumper engine used to backup tables */
private $dump_engine = null;
/** @var string The contents of the databases.json file */
private $databases_json = '';
/** @var array An array containing the database definitions of all dumped databases so far */
private $dumpedDatabases = [];
/** @var int Total number of databases left to be processed */
private $total_databases = 0;
/**
* Implements the constructor of the class
*
* @return void
*/
public function __construct()
{
parent::__construct();
Factory::getLog()->debug(__CLASS__ . " :: New instance");
}
/**
* Implements the getProgress() percentage calculation based on how many
* databases we have fully dumped and how much of the current database we
* have dumped.
*
* @return float
*/
public function getProgress()
{
if (!$this->total_databases)
{
return 0;
}
// Get the overall percentage (based on databases fully dumped so far)
$remaining_steps = count($this->database_list);
$remaining_steps++;
$overall = 1 - ($remaining_steps / $this->total_databases);
// How much is this step worth?
$this_max = 1 / $this->total_databases;
// Get the percentage done of the current database
$local = is_object($this->dump_engine) ? $this->dump_engine->getProgress() : 0;
$percentage = $overall + $local * $this_max;
if ($percentage < 0)
{
$percentage = 0;
}
elseif ($percentage > 1)
{
$percentage = 1;
}
return $percentage;
}
/**
* Implements the _prepare abstract method
*
* @return void
*/
protected function _prepare()
{
Factory::getLog()->debug(__CLASS__ . " :: Preparing instance");
// Populating the list of databases
$this->populate_database_list();
$this->total_databases = count($this->database_list);
$this->setState(self::STATE_PREPARED);
}
/**
* Implements the _run() abstract method
*
* @return void
*/
protected function _run()
{
if ($this->getState() == self::STATE_POSTRUN)
{
Factory::getLog()->debug(__CLASS__ . " :: Already finished");
$this->setStep('');
$this->setSubstep('');
}
else
{
$this->setState(self::STATE_RUNNING);
}
// Make sure we have a dumper instance loaded!
if (is_null($this->dump_engine) && !empty($this->database_list))
{
Factory::getLog()->debug(__CLASS__ . " :: Iterating next database");
// Reset the volatile key holding the table names for this database
Factory::getConfiguration()->set('volatile.database.table_names', []);
// Create a new instance
$this->dump_engine = Factory::getDumpEngine(true);
// Configure the dumper instance and pass on the volatile database root registry key
$registry = Factory::getConfiguration();
$rootkeys = array_keys($this->database_list);
$root = array_shift($rootkeys);
$registry->set('volatile.database.root', $root);
$this->database_config = array_shift($this->database_list);
$this->database_config['root'] = $root;
$this->database_config['process_empty_prefix'] = ($root == '[SITEDB]') ? true : false;
Factory::getLog()->debug(sprintf("%s :: Now backing up %s (%s)", __CLASS__, $root, $this->database_config['database']));
$this->dump_engine->setup($this->database_config);
}
elseif (is_null($this->dump_engine) && empty($this->database_list))
{
throw new RuntimeException('Current dump engine died while resuming the step');
}
// Try to step the instance
$retArray = $this->dump_engine->tick();
// Error propagation
$this->lastException = $retArray['ErrorException'];
if (!is_null($this->lastException))
{
throw $this->lastException;
}
$this->setStep($retArray['Step']);
$this->setSubstep($retArray['Substep']);
// Check if the instance has finished
if (!$retArray['HasRun'])
{
// Set the number of parts
$this->database_config['parts'] = $this->dump_engine->partNumber + 1;
// Push the list of tables in the database into the definition of the last database backed up
$this->database_config['tables'] = Factory::getConfiguration()->get('volatile.database.table_names', []);
Factory::getConfiguration()->set('volatile.database.table_names', []);
// Get the (possibly updated) database table name prefix
$this->database_config['prefix'] = $this->dump_engine->getPrefix();
// Push the definition of the last database backed up into dumpedDatabases
array_push($this->dumpedDatabases, $this->database_config);
// Go to the next entry in the list and dispose the old AkeebaDumperDefault instance
$this->dump_engine = null;
// Are we past the end of the list?
if (empty($this->database_list))
{
Factory::getLog()->debug(__CLASS__ . " :: No more databases left to iterate");
$this->setState(self::STATE_POSTRUN);
}
}
}
/**
* Implements the _finalize() abstract method
*
* @return void
*/
protected function _finalize()
{
$this->setState(self::STATE_FINISHED);
// If we are in db backup mode, don't create a databases.json
$configuration = Factory::getConfiguration();
if (!Factory::getEngineParamsProvider()->getScriptingParameter('db.databasesini', 1))
{
Factory::getLog()->debug(__CLASS__ . " :: Skipping databases.json");
}
// Create the databases.json contents
// P.A. This still has the old name with the "ini" string. That's for legacy support. Must update it in the future
elseif ($this->installerSettings->databasesini)
{
$this->createDatabasesJSON();
Factory::getLog()->debug(__CLASS__ . " :: Creating databases.json");
// Create a new string
$databasesJSON = json_encode($this->databases_json, JSON_PRETTY_PRINT);
Factory::getLog()->debug(__CLASS__ . " :: Writing databases.json contents");
$archiver = Factory::getArchiverEngine();
$virtualLocation = (Factory::getEngineParamsProvider()->getScriptingParameter('db.saveasname', 'normal') == 'short') ? '' : $this->installerSettings->sqlroot;
$archiver->addFileVirtual('databases.json', $virtualLocation, $databasesJSON);
}
// On alldb mode, we have to finalize the archive as well
if (Factory::getEngineParamsProvider()->getScriptingParameter('db.finalizearchive', 0))
{
Factory::getLog()->info("Finalizing database dump archive");
$archiver = Factory::getArchiverEngine();
$archiver->finalize();
}
// In CLI mode we'll also close the database connection
if (defined('AKEEBACLI'))
{
Factory::getLog()->info("Closing the database connection to the main database");
Factory::unsetDatabase();
}
}
/**
* Populates database_list with the list of databases in the settings
*
* @return void
*/
protected function populate_database_list()
{
// Get database inclusion filters
$filters = Factory::getFilters();
$this->database_list = $filters->getInclusions('db');
if (
Factory::getEngineParamsProvider()->getScriptingParameter('db.skipextradb', 0)
)
{
// On database only backups we prune extra databases
Factory::getLog()->debug(__CLASS__ . " :: Adding only main database");
if (count($this->database_list) == 1)
{
Factory::getLog()->debug(__CLASS__ . " :: Only the main site database was defined (good!)");
return;
}
$this->database_list = [
'[SITEDB]' => $this->database_list['[SITEDB]'] ?? array_shift($this->database_list)
];
}
}
protected function createDatabasesJSON()
{
// caching databases.json contents
Factory::getLog()->debug(__CLASS__ . " :: Creating databases.json data");
// Create a new array
$this->databases_json = [];
$registry = Factory::getConfiguration();
$blankOutPass = $registry->get('engine.dump.common.blankoutpass', 0);
$siteRoot = $registry->get('akeeba.platform.newroot', '');
// Loop through databases list
foreach ($this->dumpedDatabases as $definition)
{
$section = basename($definition['dumpFile']);
$dboInstance = Factory::getDatabase($definition);
$type = $dboInstance->name;
$tech = $dboInstance->getDriverType();
// If the database is a sqlite one, we have to process the database name which contains the path
// At the moment we only handle the case where the db file is UNDER site root
if ($tech == 'sqlite')
{
$definition['database'] = str_replace($siteRoot, '#SITEROOT#', $definition['database']);
}
$this->databases_json[$section] = [
'dbtype' => $type,
'dbtech' => $tech,
'dbname' => $definition['database'],
'sqlfile' => $definition['dumpFile'],
'marker' => "\n/**ABDB**/",
'dbhost' => $definition['host'] ?? '',
'dbport' => $definition['port'] ?? '',
'dbsocket' => $definition['socket'] ?? '',
'dbuser' => $definition['username'] ?? '',
'dbpass' => $definition['password'] ?? '',
'prefix' => $definition['prefix'] ?? '',
'dbencryption' => $definition['dbencryption'] ?? 0,
'dbsslcipher' => $definition['dbsslcipher'] ?? '',
'dbsslca' => $definition['dbsslca'] ?? '',
'dbsslkey' => $definition['dbsslkey'] ?? '',
'dbsslcert' => $definition['dbsslcert'] ?? '',
'dbsslverifyservercert' => $definition['dbsslverifyservercert'] ?? 0,
'parts' => $definition['parts'],
'tables' => $definition['tables'],
];
if ($blankOutPass)
{
$this->databases_json[$section]['dbuser'] = '';
$this->databases_json[$section]['dbpass'] = '';
$this->databases_json[$section]['dbsslca'] = '';
$this->databases_json[$section]['dbsslkey'] = '';
$this->databases_json[$section]['dbsslcert'] = '';
}
}
}
}
PK \ 8 vendor/akeeba/engine/engine/Core/Domain/Finalization.phpnu [ .
*/
namespace Akeeba\Engine\Core\Domain;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Core\Domain\Finalizer\LocalQuotas;
use Akeeba\Engine\Core\Domain\Finalizer\LogFileQuotas;
use Akeeba\Engine\Core\Domain\Finalizer\MailAdministrators;
use Akeeba\Engine\Core\Domain\Finalizer\ObsoleteRecordsQuotas;
use Akeeba\Engine\Core\Domain\Finalizer\PostProcessing;
use Akeeba\Engine\Core\Domain\Finalizer\RemoteQuotas;
use Akeeba\Engine\Core\Domain\Finalizer\RemoveTemporaryFiles;
use Akeeba\Engine\Core\Domain\Finalizer\UpdateFileSizes;
use Akeeba\Engine\Core\Domain\Finalizer\UpdateStatistics;
use Akeeba\Engine\Core\Domain\Finalizer\UploadKickstart;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use DateTime;
use Exception;
use Akeeba\Engine\Psr\Log\LogLevel;
/**
* Backup finalization domain
*/
final class Finalization extends Part
{
/** @var array The finalisation actions we have to execute (FIFO queue) */
private $actionQueue = [];
/** @var string The current method, shifted from the action queye */
private $currentActionClass = '';
private $currentActionObject = null;
/** @var int How many finalisation steps I have already done */
private $stepsDone = 0;
/** @var int How many finalisation steps I have in total */
private $stepsTotal = 0;
/** @var int How many finalisation substeps I have already done */
private $subStepsDone = 0;
/** @var int How many finalisation substeps I have in total */
private $subStepsTotal = 0;
/**
* Get the percentage of finalization steps done
*
* @return float
*/
public function getProgress()
{
if ($this->stepsTotal <= 0)
{
return 0;
}
$overall = $this->stepsDone / $this->stepsTotal;
$local = 0;
if ($this->subStepsTotal > 0)
{
$local = $this->subStepsDone / $this->subStepsTotal;
}
return $overall + ($local / $this->stepsTotal);
}
/**
* Relays and logs an exception
*
* @param \Throwable $e The exception or throwable to log
* @param string $logLevel The log level to log it with
*
* @return void
* @since 9.3.1
*/
public function relayException(\Throwable $e, string $logLevel = LogLevel::ERROR): void
{
self::logErrorsFromException($e, $logLevel);
}
/**
* Used by additional handler classes to relay their step to us
*
* @param string $step The current step
*/
public function relayStep($step)
{
$this->setStep($step);
}
/**
* Used by additional handler classes to relay their substep to us
*
* @param string $substep The current sub-step
*/
public function relaySubstep($substep)
{
$this->setSubstep($substep);
}
/**
* Implements the abstract method
*
* @return void
*/
protected function _finalize()
{
$this->setState(self::STATE_FINISHED);
}
/**
* Initialise the finalisation engine
*/
protected function _prepare()
{
// Make sure the break flag is not set
$configuration = Factory::getConfiguration();
$configuration->get('volatile.breakflag', false);
// Get the quota actions
$quotaActions = $configuration->get('volatile.core.finalization.quotaActions', null);
$quotaActions = is_array($quotaActions) ? $quotaActions : [
LocalQuotas::class,
RemoteQuotas::class,
ObsoleteRecordsQuotas::class,
LogFileQuotas::class,
];
// Get the default finalization actions
$defaultActions = array_merge(
[
RemoveTemporaryFiles::class,
UpdateStatistics::class,
UpdateFileSizes::class,
PostProcessing::class,
UploadKickstart::class,
],
$quotaActions,
[
MailAdministrators::class,
// Run it a second time to update the backup end time after post-processing, emails, etc
UpdateStatistics::class,
]
);
// Populate the actions queue, if it's not already set in a subclass
$this->actionQueue = $this->actionQueue ?: $defaultActions;
// Apply action queue customisations
$customQueue = $configuration->get('volatile.core.finalization.action_queue', null);
$customQueueBefore = $configuration->get('volatile.core.finalization.action_queue_before', null);
$customQueueAfter = $configuration->get('volatile.core.finalization.action_queue_after', null);
if (is_array($customQueue) && !empty($customQueue))
{
Factory::getLog()->debug('Overriding action queue');
$this->actionQueue = $customQueue;
}
else
{
if (is_array($customQueueBefore) && !empty($customQueueBefore))
{
Factory::getLog()->debug('Adding finalization actions before post-processing');
$before = array_slice($this->actionQueue, 0, 3);
$after = array_slice($this->actionQueue, 3);
$this->actionQueue = array_merge($before, $customQueueBefore, $after);
}
if (is_array($customQueueAfter) && !empty($customQueueAfter))
{
Factory::getLog()->debug('Adding finalization actions at the end of the queue');
$before = array_slice($this->actionQueue, 0, -1);
$after = array_slice($this->actionQueue, -1, 1);
$this->actionQueue = array_merge($before, $customQueueAfter, $after);
}
}
// Log the actions queue
Factory::getLog()->debug('Finalization action queue: ' . implode(', ', $this->actionQueue));
// Initialise actions processing
$this->stepsTotal = count($this->actionQueue);
$this->stepsDone = 0;
$this->subStepsTotal = 0;
$this->subStepsDone = 0;
// Seed the method
$this->currentActionClass = array_shift($this->actionQueue);
// Set ourselves to running state
$this->setState(self::STATE_RUNNING);
}
/**
* Implements the abstract method
*
* @return void
*/
protected function _run()
{
$configuration = Factory::getConfiguration();
if ($this->getState() == self::STATE_POSTRUN)
{
return;
}
$finished = (empty($this->actionQueue)) && ($this->currentActionClass == '');
if ($finished)
{
$this->setState(self::STATE_POSTRUN);
return;
}
$this->setState(self::STATE_RUNNING);
$timer = Factory::getTimer();
// Continue processing while we have still enough time and stuff to do
while (($timer->getTimeLeft() > 0) && (!$finished) && (!$configuration->get('volatile.breakflag', false)))
{
if (empty($this->currentActionObject))
{
$className = $this->currentActionClass;
Factory::getLog()->debug(__CLASS__ . "::_run() Running new finalization object $className");
$this->currentActionObject = new $className($this);
}
else
{
Factory::getLog()->debug(__CLASS__ . "::_run() Resuming finalization object $this->currentActionClass");
}
$finalizer = $this->currentActionObject;
if ($finalizer() !== true)
{
continue;
}
$this->currentActionClass = '';
$this->currentActionObject = null;
$this->stepsDone++;
$finished = empty($this->actionQueue);
if ($finished)
{
continue;
}
$this->currentActionClass = array_shift($this->actionQueue);
$this->subStepsTotal = 0;
$this->subStepsDone = 0;
}
if ($finished)
{
$this->setState(self::STATE_POSTRUN);
$this->setStep('');
$this->setSubstep('');
}
}
}
PK \%V1D? D? 0 vendor/akeeba/engine/engine/Core/Domain/Init.phpnu [ .
*/
namespace Akeeba\Engine\Core\Domain;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use RuntimeException;
/**
* Backup initialization domain
*/
final class Init extends Part
{
/** @var string The backup description */
private $description = '';
/** @var string The backup comment */
private $comment = '';
/**
* Implements the constructor of the class
*
* @return void
*/
public function __construct()
{
parent::__construct();
Factory::getLog()->debug(__CLASS__ . " :: New instance");
}
/**
* Converts a PHP error to a string
*
* @return string
*/
public static function error2string()
{
if (!function_exists('error_reporting'))
{
return "Not applicable; host too restrictive";
}
$value = error_reporting();
$level_names = [
E_ERROR => 'E_ERROR', E_WARNING => 'E_WARNING',
E_PARSE => 'E_PARSE', E_NOTICE => 'E_NOTICE',
E_CORE_ERROR => 'E_CORE_ERROR', E_CORE_WARNING => 'E_CORE_WARNING',
E_COMPILE_ERROR => 'E_COMPILE_ERROR', E_COMPILE_WARNING => 'E_COMPILE_WARNING',
E_USER_ERROR => 'E_USER_ERROR', E_USER_WARNING => 'E_USER_WARNING',
E_USER_NOTICE => 'E_USER_NOTICE',
];
// E_STRICT is deprecated in PHP 8.4.0, therefore we are no longer handling starting with this version.
if (defined('E_STRICT') && version_compare(PHP_VERSION, '8.4.0', 'lt'))
{
$level_names[E_STRICT] = 'E_STRICT';
}
$levels = [];
if (($value & E_ALL) == E_ALL)
{
$levels[] = 'E_ALL';
$value &= ~E_ALL;
}
foreach ($level_names as $level => $name)
{
if (($value & $level) == $level)
{
$levels[] = $name;
}
}
return implode(' | ', $levels);
}
/**
* Reports whether the error display (output to HTML) is enabled or not
*
* @return string
*/
public static function errordisplay()
{
if (!function_exists('ini_get'))
{
return "Not applicable; host too restrictive";
}
return ini_get('display_errors') ? 'on' : 'off';
}
/**
* Implements the _prepare abstract method
*
* @return void
*/
protected function _prepare()
{
// Load parameters (description and comment)
$jpskey = '';
$angiekey = '';
if (!empty($this->_parametersArray))
{
$params = $this->_parametersArray;
if (isset($params['description']))
{
$this->description = $params['description'];
}
if (isset($params['comment']))
{
$this->comment = $params['comment'];
}
if (isset($params['jpskey']))
{
$jpskey = $params['jpskey'];
}
if (isset($params['angiekey']))
{
$angiekey = $params['angiekey'];
}
}
// Load configuration -- No. This is already done by the model. Doing it again removes all overrides.
// Platform::getInstance()->load_configuration();
// Initialize counters
$registry = Factory::getConfiguration();
if (!empty($jpskey))
{
$registry->set('engine.archiver.jps.key', $jpskey);
}
if (!empty($angiekey))
{
$registry->set('engine.installer.angie.key', $angiekey);
}
// Initialize temporary storage
Factory::getFactoryStorage()->reset();
// Force load the tag -- do not delete!
$kettenrad = Factory::getKettenrad();
$tag = $kettenrad->getTag(); // Yes, this is an unused variable by we MUST run this method. DO NOT DELETE.
// Push the comment and description in temp vars for use in the installer phase
$registry->set('volatile.core.description', $this->description);
$registry->set('volatile.core.comment', $this->comment);
$this->setState(self::STATE_PREPARED);
}
/**
* Implements the _run() abstract method
*
* @return void
*/
protected function _run()
{
if ($this->getState() == self::STATE_POSTRUN)
{
Factory::getLog()->debug(__CLASS__ . " :: Already finished");
$this->setStep('');
$this->setSubstep('');
return;
}
else
{
$this->setState(self::STATE_RUNNING);
}
// Initialise the extra notes variable, used by platform classes to return warnings and errors
$extraNotes = null;
// Load the version defines
Platform::getInstance()->load_version_defines();
$registry = Factory::getConfiguration();
// Write log file's header
$version = defined('AKEEBABACKUP_VERSION') ? AKEEBABACKUP_VERSION : AKEEBA_VERSION;
$date = defined('AKEEBABACKUP_DATE') ? AKEEBABACKUP_DATE : AKEEBA_DATE;
Factory::getLog()->info("--------------------------------------------------------------------------------");
Factory::getLog()->info("Akeeba Backup " . $version . ' (' . $date . ')');
Factory::getLog()->info("--------------------------------------------------------------------------------");
// PHP configuration variables are tried to be logged only for debug and info log levels
if ($registry->get('akeeba.basic.log_level') >= 2)
{
Factory::getLog()->info("--- System Information ---");
Factory::getLog()->info("PHP Version :" . PHP_VERSION);
Factory::getLog()->info("PHP OS :" . PHP_OS);
Factory::getLog()->info("PHP SAPI :" . PHP_SAPI);
if (function_exists('php_uname'))
{
Factory::getLog()->info("OS Version :" . php_uname('s'));
}
$db = Factory::getDatabase();
Factory::getLog()->info("DB Version :" . $db->getVersion());
if (isset($_SERVER['SERVER_SOFTWARE']))
{
$server = $_SERVER['SERVER_SOFTWARE'];
}
elseif (($sf = getenv('SERVER_SOFTWARE')))
{
$server = $sf;
}
else
{
$server = 'n/a';
}
Factory::getLog()->info("Web Server :" . $server);
$platform = 'Unknown platform';
$version = '(unknown version)';
$platformData = Platform::getInstance()->getPlatformVersion();
Factory::getLog()->info($platformData['name'] . " version :" . $platformData['version']);
if (isset($_SERVER['HTTP_USER_AGENT']))
{
Factory::getLog()->info("User agent :" . $_SERVER['HTTP_USER_AGENT']);
}
Factory::getLog()->info("Safe mode :" . ini_get("safe_mode"));
Factory::getLog()->info("Display errors :" . ini_get("display_errors"));
Factory::getLog()->info("Error reporting :" . self::error2string());
Factory::getLog()->info("Error display :" . self::errordisplay());
Factory::getLog()->info("Disabled functions :" . ini_get("disable_functions"));
Factory::getLog()->info("open_basedir restr.:" . ini_get('open_basedir'));
Factory::getLog()->info("Max. exec. time :" . ini_get("max_execution_time"));
Factory::getLog()->info("Memory limit :" . ini_get("memory_limit"));
if (function_exists("memory_get_usage"))
{
Factory::getLog()->info("Current mem. usage :" . memory_get_usage());
}
if (function_exists("gzcompress"))
{
Factory::getLog()->info("GZIP Compression : available (good)");
}
else
{
Factory::getLog()->info("GZIP Compression : n/a (no compression)");
}
$extraNotes = Platform::getInstance()->log_platform_special_directories();
if (!empty($extraNotes) && is_array($extraNotes))
{
if (isset($extraNotes['warnings']) && is_array($extraNotes['warnings']))
{
foreach ($extraNotes['warnings'] as $warning)
{
Factory::getLog()->warning($warning);
}
}
if (isset($extraNotes['errors']) && is_array($extraNotes['errors']))
{
foreach ($extraNotes['errors'] as $error)
{
Factory::getLog()->error($error);
}
if (!empty($extraNotes['errors']))
{
throw new RuntimeException($extraNotes['errors'][0]);
}
}
}
$min_time = $registry->get('akeeba.tuning.min_exec_time');
$max_time = $registry->get('akeeba.tuning.max_exec_time');
$bias = $registry->get('akeeba.tuning.run_time_bias');
Factory::getLog()->info("Min/Max/Bias :" . $min_time . '/' . $max_time . '/' . $bias);
Factory::getLog()->info("Output directory :" . $registry->get('akeeba.basic.output_directory'), ['root_translate' => false]);
Factory::getLog()->info("Part size (bytes) :" . $registry->get('engine.archiver.common.part_size', 0));
Factory::getLog()->info("--------------------------------------------------------------------------------");
}
// Quirks reporting
$quirks = Factory::getConfigurationChecks()->getDetailedStatus(true);
if (!empty($quirks))
{
Factory::getLog()->info("Akeeba Backup has detected the following potential problems:");
foreach ($quirks as $q)
{
Factory::getLog()->info('- ' . $q['code'] . ' ' . $q['description'] . ' (' . $q['severity'] . ')');
}
Factory::getLog()->info("You probably do not have to worry about them, but you should be aware of them.");
Factory::getLog()->info("--------------------------------------------------------------------------------");
}
$phpVersion = PHP_VERSION;
if (version_compare($phpVersion, '7.3.0', 'lt'))
{
Factory::getLog()->warning("You are using PHP $phpVersion which is officially End of Life. We recommend using PHP 7.4 or later for best results. Your version of PHP, $phpVersion, will stop being supported by this backup software in the future.");
}
$this->warnAboutLegacyMysqlDriver();
// Report profile ID
$profile_id = Platform::getInstance()->get_active_profile();
Factory::getLog()->info("Loaded profile #$profile_id");
// Get archive name
[$relativeArchiveName, $absoluteArchiveName] = $this->getArchiveName();
// ==== Stats initialisation ===
$origin = Platform::getInstance()->get_backup_origin(); // Get backup origin
$profile_id = Platform::getInstance()->get_active_profile(); // Get active profile
$registry = Factory::getConfiguration();
$backupType = $registry->get('akeeba.basic.backup_type');
Factory::getLog()->debug("Backup type is now set to '" . $backupType . "'");
// Substitute "variables" in the archive name
$fsUtils = Factory::getFilesystemTools();
$description = $fsUtils->replace_archive_name_variables($this->description);
$comment = $fsUtils->replace_archive_name_variables($this->comment);
if ($registry->get('volatile.writer.store_on_server', true))
{
// Archive files are stored on our server
$stat_relativeArchiveName = $relativeArchiveName;
$stat_absoluteArchiveName = $absoluteArchiveName;
}
else
{
// Archive files are not stored on our server (FTP backup, cloud backup, sent by email, etc)
$stat_relativeArchiveName = '';
$stat_absoluteArchiveName = '';
}
$kettenrad = Factory::getKettenrad();
$temp = [
'description' => $description,
'comment' => $comment,
'backupstart' => Platform::getInstance()->get_timestamp_database(),
'status' => 'run',
'origin' => $origin,
'type' => $backupType,
'profile_id' => $profile_id,
'archivename' => $stat_relativeArchiveName,
'absolute_path' => $stat_absoluteArchiveName,
'multipart' => 0,
'filesexist' => 1,
'tag' => $kettenrad->getTag(),
'backupid' => $kettenrad->getBackupId(),
];
// Save the entry
$statistics = Factory::getStatistics();
$statistics->setStatistics($temp);
$statistics->release_multipart_lock();
// Initialize the archive.
if (Factory::getEngineParamsProvider()->getScriptingParameter('core.createarchive', true))
{
Factory::getLog()->debug("Expanded archive file name: " . $absoluteArchiveName);
Factory::getLog()->debug("Initializing archiver engine");
$archiver = Factory::getArchiverEngine();
$archiver->initialize($absoluteArchiveName);
$archiver->setComment($comment); // Add the comment to the archive itself.
}
$this->setState(self::STATE_POSTRUN);
}
/**
* Warns in the log if any configured database (main site or extra) uses the legacy mysql driver.
*
* The PHP mysql extension was removed in PHP 7.0 and is therefore never available on any PHP version we support.
* Users who have backup profiles configured with this driver should update their configuration.
*
* @return void
*/
private function warnAboutLegacyMysqlDriver(): void
{
$databases = Factory::getFilters()->getInclusions('db');
foreach ($databases as $key => $definition)
{
$driver = strtolower($definition['driver'] ?? '');
if ($driver !== 'mysql')
{
continue;
}
$label = ($key === '[SITEDB]')
? 'The main site database'
: sprintf('Extra configured database "%s"', $definition['database'] ?? $key);
Factory::getLog()->warning(
sprintf(
'%s is configured to use the driver MySQL which is not supported since PHP 7.0 (you are using PHP %s). Please edit your backup profile configuration to address this issue. The backup will continue using the MySQLi driver.',
$label,
PHP_VERSION
)
);
}
}
/**
* Implements the abstract _finalize method
*
* @return void
*/
protected function _finalize()
{
$this->setState(self::STATE_FINISHED);
}
/**
* Returns the relative and absolute path to the archive
*/
protected function getArchiveName()
{
$registry = Factory::getConfiguration();
// Import volatile scripting keys to the registry
Factory::getEngineParamsProvider()->importScriptingToRegistry();
// Determine the extension
$force_extension = Factory::getEngineParamsProvider()->getScriptingParameter('core.forceextension', null);
if (is_null($force_extension))
{
$archiver = Factory::getArchiverEngine();
$extension = $archiver->getExtension();
}
else
{
$extension = $force_extension;
}
// Get the template name
$templateName = $registry->get('akeeba.basic.archive_name');
Factory::getLog()->debug("Archive template name: $templateName");
/**
* Security: Protect archives in the default backup output directory
*
* If the configured backup output directory is the same as the default backup output directory the following
* actions are taken:
*
* 1. The backup archive name must include [RANDOM]. If it doesn't, '-[RANDOM]' will be appended to it.
* 2. We make sure that the direct web access blocking files .htaccess, web.config, index.html, index.htm and
* index.php exist in that directory. If they do not they will be forcibly added.
*/
$configuredOutputPath = $registry->get('akeeba.basic.output_directory');
$stockDirs = Platform::getInstance()->get_stock_directories();
$defaultOutputPath = $stockDirs['[DEFAULT_OUTPUT]'];
$fsUtils = Factory::getFilesystemTools();
if (@realpath($configuredOutputPath) === @realpath($defaultOutputPath))
{
$this->ensureHasRandom($templateName);
$fsUtils->ensureNoAccess($defaultOutputPath);
}
// Parse all tags
$fsUtils = Factory::getFilesystemTools();
$templateName = $fsUtils->replace_archive_name_variables($templateName);
Factory::getLog()->debug("Expanded template name: $templateName");
$relative_path = $templateName . $extension;
$absolute_path = $fsUtils->TranslateWinPath($configuredOutputPath . DIRECTORY_SEPARATOR . $relative_path);
return [$relative_path, $absolute_path];
}
/**
* Make sure that the archive template name contains the [RANDOM] variable.
*
* @param string $templateName
*
* @return void
*/
protected function ensureHasRandom(&$templateName)
{
if (strpos($templateName, '[RANDOM]') !== false)
{
return;
}
$templateName .= '-[RANDOM]';
}
}
PK \?c
h h 0 vendor/akeeba/engine/engine/Core/Domain/Pack.phpnu [ .
*/
namespace Akeeba\Engine\Core\Domain;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Archiver\Base as BaseArchiverClass;
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Base\Exceptions\WarningException;
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Configuration;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Exception;
use Akeeba\Engine\Psr\Log\LogLevel;
use RuntimeException;
/* Windows system detection */
if (!defined('_AKEEBA_IS_WINDOWS'))
{
$isWindows = DIRECTORY_SEPARATOR == '\\';
if (function_exists('php_uname'))
{
$isWindows = stristr(php_uname(), 'windows');
}
define('_AKEEBA_IS_WINDOWS', $isWindows);
}
/**
* Packing engine. Takes care of putting gathered files (the file list) into
* an archive.
*/
final class Pack extends Part
{
/** @var array Directories left to be scanned */
private $directory_list;
/** @var array Files left to be put into the archive */
private $file_list;
/**
* Have we finished scanning all subdirectories of the current directory?
*
* @var boolean
*/
private $done_subdir_scanning = false;
/**
* Have we finished scanning all files of the current directory?
*
* @var boolean
*/
private $done_file_scanning = true;
/**
* Is the current directory completely excluded?
*
* @var boolean
*/
private $excluded_folder = false;
/**
* Are the current directory's subdirectories excluded?
*
* @var boolean
*/
private $excluded_subdirectories = false;
/**
* Are the current directory's files excluded?
*
* @var boolean
*/
private $excluded_files = false;
/** @var string Path to add to scanned files */
private $path_prefix;
/** @var string Path to remove from scanned files */
private $remove_path_prefix;
/** @var array An array of root directories to scan */
private $root_definitions = [];
/** @var integer How many files have been processed in the current step */
private $processed_files_counter;
/** @var string Current directory being scanned */
private $current_directory;
/** @var integer|null The position in the file list scanning */
private $getFiles_position = null;
/** @var integer|null The position in the folder list scanning */
private $getFolders_position = null;
/** @var string Current root directory being processed */
private $root = '[SITEROOT]';
/** @var integer Total root directories to scan, used in percentage calculation */
private $total_roots = 0;
/** @var integer Total files to process */
private $total_files = 0;
/** @var integer Total files already processed */
private $done_files = 0;
/** @var integer Total folders to process */
private $total_folders = 0;
/** @var integer Total folders already processed */
private $done_folders = 0;
/**
* Public constructor of the class
*
* @return void
*/
public function __construct()
{
parent::__construct();
Factory::getLog()->debug(__CLASS__ . " :: new instance");
}
/**
* Immediate post-processing of a part file that's just been completed.
*
* This method returns false when no post-processing was possible, or if it failed.
*
* The method returns true when it's post-processed a part file, even if such post-processing has only been partial.
*
* @param BaseArchiverClass $archiver The archiver engine
* @param Configuration $configuration Reference to the Factory configuration object
*
* @return bool True to indicate our caller should return immediately.
*/
public static function postProcessDonePartFile(BaseArchiverClass $archiver, Configuration $configuration)
{
// Get configuration parameters
$postprocEngine = Factory::getPostprocEngine();
$allowImmediatePostProcessing = $configuration->get('engine.postproc.common.after_part', 0);
$filename = $configuration->get('volatile.postproc.filename', null);
$shouldDeleteProcessedPart = $configuration->get('engine.postproc.common.delete_after', false);
$shouldAbortOnFailed = $configuration->get('engine.postproc.common.abort_on_fail', false);
$engineCanDeleteFiles = $postprocEngine->isFileDeletionAfterProcessingAdvisable();
// Is the immediate post-processing disabled? Return false.
if (!$allowImmediatePostProcessing)
{
return false;
}
// Are we continuing the post-processing of a previous file?
if (!empty($filename))
{
Factory::getLog()->info(sprintf("Continuing immediate post-processing of part file %s", basename($filename)));
}
// Do we have a NEW file to post-process?
if (empty($filename) && !empty($archiver->finishedPart))
{
$filename = array_shift($archiver->finishedPart);
if (!empty($filename))
{
Factory::getLog()->info(sprintf("Starting immediate post-processing of part file %s", basename($filename)));
}
}
// Not continuing post-processing and no new file to process? Return false and let the caller carry on.
if (empty($filename))
{
return false;
}
// Store the file to post-process in volatile storage
$configuration->set('volatile.postproc.filename', $filename);
// Try to post-process the file
$timer = Factory::getTimer();
$startTime = $timer->getRunningTime();
try
{
$postProcessingResult = $postprocEngine->processPart($filename);
$endTime = $timer->getRunningTime();
$stepTime = $endTime - $startTime;
$notEnoughTimeLeft = $timer->getTimeLeft() < $stepTime;
/**
* FINISHED POST-PROCESSING THE FILE
*/
if ($postProcessingResult === true)
{
Factory::getLog()->info('Successfully processed file ' . basename($filename));
// Indicate the file has finished post-processing
$configuration->set('volatile.postproc.filename', null);
// Add this part's size to the volatile storage variable holding the total size of the backup set
$volatileTotalSize = $configuration->get('volatile.engine.archiver.totalsize', 0);
$volatileTotalSize += (int) @filesize($filename);
$configuration->set('volatile.engine.archiver.totalsize', $volatileTotalSize);
// If the engine recommends breaking the step after post-processing let's set the break flag
if ($postprocEngine->recommendsBreakAfter())
{
$configuration->set('volatile.breakflag', true);
}
// If I don't need to delete the post-processed part just return
if (!$shouldDeleteProcessedPart)
{
return true;
}
if (!$engineCanDeleteFiles)
{
return true;
}
Factory::getLog()->debug(sprintf("Deleting post-processed file %s", basename($filename)));
Platform::getInstance()->unlink($filename);
return true;
}
/**
* MORE WORK REQUIRED
*/
Factory::getLog()->info(sprintf("More post-processing steps required for file %s", basename($filename)));
/**
* If the time left is not at least as much as the previous post-processing step took us we break the step.
* This prevents a time-out trying to post-process another chunk of the file.
*/
if ($notEnoughTimeLeft)
{
$configuration->set('volatile.breakflag', true);
}
}
/**
* POST-PROCESSING FAILED
*/
catch (Exception $e)
{
// Indicate no further processing is possible on this file.
$configuration->set('volatile.postproc.filename', null);
Factory::getLog()->warning('Failed to process file ' . basename($filename));
Factory::getLog()->warning('Error received from the post-processing engine:');
self::logErrorsFromException($e, $shouldAbortOnFailed ? LogLevel::ERROR : LogLevel::WARNING);
// Fail the backup if we're configured to do so
if ($shouldAbortOnFailed)
{
throw new ErrorException(sprintf('Failed to process backup archive file %s', basename($filename)));
}
return false;
}
// No further processing necessary
return true;
}
/**
* Implements the getProgress() percentage calculation based on how many
* roots we have fully backed up and how much of the current root we
* have backed up.
*/
public function getProgress()
{
if (empty($this->total_roots))
{
return 0;
}
// Get the overall percentage (based on databases fully dumped so far)
$remaining_steps = count($this->root_definitions);
$remaining_steps++;
$overall = 1 - ($remaining_steps / $this->total_roots);
// How much is this step worth?
$this_max = 1 / $this->total_roots;
// Get the percentage done of the current root. Hey, the calculation *is* dodgy, I know it!
$local = 0;
if ($this->total_files > 0)
{
$local += 0.05 * $this->done_files / $this->total_files;
}
if ($this->total_folders > 0)
{
$local += 0.95 * $this->done_folders / $this->total_folders;
}
$percentage = $overall + $local * $this_max;
if ($percentage < 0)
{
$percentage = 0;
}
if ($percentage > 1)
{
$percentage = 1;
}
return $percentage;
}
/**
* Implements the _prepare() abstract method
*
* @return void
*/
protected function _prepare()
{
Factory::getLog()->debug(__CLASS__ . " :: Starting _prepare()");
$registry = Factory::getConfiguration();
// Get a list of directories to include
Factory::getLog()->debug(__CLASS__ . " :: Getting directory inclusion filters");
$filters = Factory::getFilters();
$this->root_definitions = $filters->getInclusions('dir');
$this->total_roots = count($this->root_definitions);
// Add the mapping text file if there are external directories defined!
if (count($this->root_definitions) > 1)
{
// The site's root is the last directory to be backed up. Um, no,
// this is not what we need
$temp = array_pop($this->root_definitions);
array_unshift($this->root_definitions, $temp);
// We add a README.txt file in our virtual directory...
Factory::getLog()->debug("Creating README.txt in the EFF virtual folder");
$virtualContents = <<get('akeeba.advanced.virtual_folder'), '/') . '/';
$effini = ['eff' => []];
$rootsToPack = array_filter(
$this->root_definitions,
function ($data) {
return $data[0] != '[SITEROOT]';
}
);
foreach ($rootsToPack as $dir)
{
$counter++;
$test = trim($dir[1]);
if ($test == '/')
{
$counter--;
continue;
}
$virtualContents .= $dir[1] . "\tis the backup of\t" . $dir[0] . "\n";
$effini['eff'][$dir[0]] = $vdir . $dir[1];
}
$effini = json_encode($effini, JSON_PRETTY_PRINT);
// Add the file to our archive
$archiver = Factory::getArchiverEngine();
if ($counter >= 1)
{
$archiver->addFileVirtual('README.txt', $registry->get('akeeba.advanced.virtual_folder'), $virtualContents);
$archiver->addFileVirtual('eff.json', $this->installerSettings->installerroot, $effini);
}
else
{
Factory::getLog()->debug("README.txt was not created; all EFF directories are being backed up to the archive's root");
}
}
// Find the site's root element and shift it into the directory list
$dir_definition = array_shift($this->root_definitions);
$count = 0;
$max_dir_count = count($this->root_definitions);
while (!is_null($dir_definition[1]) && ($count < $max_dir_count))
{
$count++;
array_push($this->root_definitions, $dir_definition);
$dir_definition = array_shift($this->root_definitions);
}
// Settling with whatever we have, let's put it to use, shall we?
$this->remove_path_prefix = $dir_definition[0]; // Remove absolute path to directory when storing the file
if (is_null($dir_definition[1]))
{
$this->path_prefix = ''; // No added path for main site
if (empty($dir_definition[0]))
{
$this->root = '[SITEROOT]';
}
else
{
$this->root = $dir_definition[0];
}
}
else
{
$dir_definition[1] = trim($dir_definition[1]);
if (empty($dir_definition[1]) || $dir_definition[1] == '/')
{
$this->path_prefix = '';
}
else
{
$this->path_prefix = $registry->get('akeeba.advanced.virtual_folder') . '/' . $dir_definition[1];
}
$this->root = $dir_definition[0];
}
// Translate the root into an absolute path
$stock_dirs = Platform::getInstance()->get_stock_directories();
$absolute_dir = substr($this->root, 0);
if (!empty($stock_dirs))
{
foreach ($stock_dirs as $key => $replacement)
{
$absolute_dir = str_replace($key, $replacement, $absolute_dir);
}
}
$this->directory_list[] = $absolute_dir;
$this->remove_path_prefix = $absolute_dir;
$registry = Factory::getConfiguration();
$registry->set('volatile.filesystem.current_root', $absolute_dir);
$this->done_subdir_scanning = true;
$this->done_file_scanning = true;
$this->total_files = 0;
$this->done_files = 0;
$this->total_folders = 0;
$this->done_folders = 0;
$this->setState(self::STATE_PREPARED);
Factory::getLog()->debug(__CLASS__ . " :: prepared");
}
// ============================================================================================
// PRIVATE METHODS
// ============================================================================================
/**
* @return void
* @throws Exception
*/
protected function _run()
{
if ($this->getState() == self::STATE_POSTRUN)
{
Factory::getLog()->debug(__CLASS__ . " :: Already finished");
$this->setStep("-");
$this->setSubstep("");
return;
}
// If I'm done scanning files and subdirectories and there are no more files to pack get the next
// directory. This block is triggered in the first step in a new root.
if (empty($this->file_list) && $this->done_subdir_scanning && $this->done_file_scanning)
{
$this->progressMarkFolderDone();
if (!$this->getNextDirectory())
{
if ($this->getNextRoot())
{
if (!$this->getNextDirectory())
{
return;
}
}
else
{
return;
}
}
}
/**
* Automated tests override
*
* If the file .akeeba_engine_automated_tests_error file is present in the site's root I will throw an error.
*/
[$root, $translated_root, $dir] = $this->getCleanDirectoryComponents();
if (@file_exists($translated_root . '/.akeeba_engine_automated_tests_error'))
{
throw new RuntimeException("Akeeba Engine automated tests: I am throwing an error because the file .akeeba_engine_automated_tests_error is present in the site's root folder.");
}
// If I'm not done scanning for files and the file list is empty then scan for more files
if (!$this->done_file_scanning && empty($this->file_list))
{
$this->scanFiles();
}
// If I have files left, pack them
elseif (!empty($this->file_list))
{
$this->pack_files();
}
// If I'm not done scanning subdirectories, go ahead and scan some more of them
elseif (!$this->done_subdir_scanning)
{
$this->scanSubdirs();
}
/**
* If we have excluded contained files or subdirectories BUT NOT the entire folder itself AND there are
* no files in this directory THEN add an empty directory to the archive.
**/
elseif (
($this->excluded_files || $this->excluded_subdirectories)
&&
!$this->excluded_folder
&&
empty($this->file_list)
)
{
Factory::getLog()->info("Empty directory " . $this->current_directory . ' (files and directories are filtered)');
$archiver = Factory::getArchiverEngine();
if ($this->current_directory != $this->remove_path_prefix)
{
$archiver->addFile($this->current_directory, $this->remove_path_prefix, $this->path_prefix);
}
}
}
/**
* Implements the _finalize() abstract method
*
*/
protected function _finalize()
{
Factory::getLog()->info("Finalizing archive");
$archive = Factory::getArchiverEngine();
$archive->finalize();
Factory::getLog()->debug("Archive is finalized");
$this->setState(self::STATE_FINISHED);
}
/**
* Gets the next directory to scan from the stack. It also applies folder
* filters (directory exclusion, subdirectory exclusion, file exclusion),
* updating the operation toggle properties of the class.
*
* @return boolean True if we found a directory, false if the directory
* stack is empty. It also returns true if the folder is
* filtered (we are told to skip it)
*/
protected function getNextDirectory()
{
// Reset the file / folder scanning positions
$this->getFiles_position = null;
$this->getFolders_position = null;
$this->done_file_scanning = false;
$this->done_subdir_scanning = false;
$this->excluded_folder = false;
$this->excluded_subdirectories = false;
$this->excluded_files = false;
if ((is_array($this->directory_list) || $this->directory_list instanceof \Countable ? count($this->directory_list) : 0) == 0)
{
// No directories left to scan
return false;
}
else
{
// Get and remove the last entry from the $directory_list array
$this->current_directory = array_pop($this->directory_list);
$this->setStep($this->current_directory);
$this->processed_files_counter = 0;
}
[$root, $translated_root, $dir] = $this->getCleanDirectoryComponents();
// Get a filters instance
$filters = Factory::getFilters();
// Apply DEF (directory exclusion filters)
// Note: the !empty($dir) prevents the site's root from being filtered out
if ($filters->isFiltered($dir, $root, 'dir', 'all') && !empty($dir))
{
Factory::getLog()->info("Skipping directory " . $this->current_directory);
$this->done_subdir_scanning = true;
$this->done_file_scanning = true;
$this->excluded_folder = true;
return true;
}
// Apply Skip Contained Directories Filters
if ($filters->isFiltered($dir, $root, 'dir', 'children'))
{
$this->excluded_subdirectories = true;
Factory::getLog()->info("Skipping subdirectories of directory " . $this->current_directory);
$this->done_subdir_scanning = true;
}
// Apply Skipfiles
if ($filters->isFiltered($dir, $root, 'dir', 'content'))
{
$this->excluded_files = true;
Factory::getLog()->info("Skipping files of directory " . $this->current_directory);
$this->done_file_scanning = true;
// When the files of a folder are skipped we will have to add some
// files anyway if they are present. These are files used to
// prevent direct access to the folder.
// Try to find and include .htaccess and index.htm(l) files
// # Fix 2.4: Do not add DIRECTORY_SEPARATOR if we are on the site's root and it's an empty string
$ds = ($this->current_directory == '') || ($this->current_directory == '/') ? '' : DIRECTORY_SEPARATOR;
$checkForTheseFiles = [
$this->current_directory . $ds . '.htaccess',
$this->current_directory . $ds . 'web.config',
$this->current_directory . $ds . 'index.html',
$this->current_directory . $ds . 'index.htm',
$this->current_directory . $ds . 'robots.txt',
];
$this->processed_files_counter = 0;
foreach ($checkForTheseFiles as $fileName)
{
if (@file_exists($fileName))
{
// Fix 3.3 - We have to also put them through other filters, ahem!
if (!$filters->isFiltered($fileName, $root, 'file', 'all'))
{
$this->file_list[] = $fileName;
$this->processed_files_counter++;
}
}
}
}
return true;
}
/**
* Try to add some files from the $file_list into the archive
*
* @return boolean True if there were files packed, false otherwise
* (empty filelist or fatal error)
*/
protected function pack_files()
{
// Get a reference to the archiver and the timer classes
$archiver = Factory::getArchiverEngine();
$timer = Factory::getTimer();
$configuration = Factory::getConfiguration();
// Check whether we need to immediately post-processing a done part
if (self::postProcessDonePartFile($archiver, $configuration))
{
return true;
}
// If the archiver has work to do, make sure it finished up before continuing
if ($configuration->get('volatile.engine.archiver.processingfile', false))
{
Factory::getLog()->debug("Continuing file packing from previous step");
$archiver->addFile('', '', '');
// If that was the last step for packing this file, mark a file done
if (!$configuration->get('volatile.engine.archiver.processingfile', false))
{
$this->progressMarkFileDone();
}
}
// Did it finish, or does it have more work to do?
if ($configuration->get('volatile.engine.archiver.processingfile', false))
{
// More work to do. Let's just tell our parent that we finished up successfully.
return true;
}
// Normal file backup loop; we keep on processing the file list, packing files as we go.
if ((is_array($this->file_list) || $this->file_list instanceof \Countable ? count($this->file_list) : 0) == 0)
{
// No files left to pack. Return true and let the engine loop
$this->progressMarkFolderDone();
return true;
}
else
{
Factory::getLog()->debug("Packing files");
$packedSize = 0;
$numberOfFiles = 0;
[$usec, $sec] = explode(" ", microtime());
$opStartTime = ((float) $usec + (float) $sec);
$largeFileThreshold = Factory::getConfiguration()->get('engine.scan.common.largefile', 10485760);
while (((is_array($this->file_list) || $this->file_list instanceof \Countable ? count($this->file_list) : 0) > 0))
{
$file = @array_shift($this->file_list);
$size = 0;
if (file_exists($file))
{
$size = @filesize($file);
}
// Anticipatory file size algorithm
if (($numberOfFiles > 0) && ($size > $largeFileThreshold))
{
if (!Factory::getConfiguration()->get('akeeba.tuning.nobreak.beforelargefile', 0))
{
// If the file is bigger than the big file threshold, break the step
// to avoid potential timeouts
$this->setBreakFlag();
Factory::getLog()->info("Breaking step _before_ large file: " . $file . " - size: " . $size);
// Push the file back to the list.
array_unshift($this->file_list, $file);
// Return true and let the engine loop
return true;
}
}
// Proactive potential timeout detection
// Rough estimation of packing speed in bytes per second
[$usec, $sec] = explode(" ", microtime());
$opEndTime = ((float) $usec + (float) $sec);
if (($opEndTime - $opStartTime) == 0)
{
$_packSpeed = 0;
}
else
{
$_packSpeed = $packedSize / ($opEndTime - $opStartTime);
}
// Estimate required time to pack next file. If it's the first file of this operation,
// do not impose any limitations.
$_reqTime = ($_packSpeed - 0.01) <= 0 ? 0 : $size / $_packSpeed;
// Do we have enough time?
if ($timer->getTimeLeft() < $_reqTime)
{
if (!Factory::getConfiguration()->get('akeeba.tuning.nobreak.proactive', 0))
{
array_unshift($this->file_list, $file);
Factory::getLog()->info("Proactive step break - file: " . $file . " - size: " . $size . " - req. time " . sprintf('%2.2f', $_reqTime));
$this->setBreakFlag();
return true;
}
}
$packedSize += $size;
$numberOfFiles++;
$archiver->addFile($file, $this->remove_path_prefix, $this->path_prefix);
// If no more processing steps are required, mark a done file
if (!$configuration->get('volatile.engine.archiver.processingfile', false))
{
$this->progressMarkFileDone();
}
// If this was the first file packed and we've already gone past
// the large file size threshold break the step. Continuing with
// more operations after packing such a big file is increasing
// the risk to hit a timeout.
if (($packedSize > $largeFileThreshold) && ($numberOfFiles == 1))
{
if (!Factory::getConfiguration()->get('akeeba.tuning.nobreak.afterlargefile', 0))
{
Factory::getLog()->info("Breaking step *after* large file: " . $file . " - size: " . $size);
$this->setBreakFlag();
return true;
}
}
// If we have to continue processing the file, break the file packing loop forcibly
if ($configuration->get('volatile.engine.archiver.processingfile', false))
{
return true;
}
}
// True if we have more files, false if we're done packing
return ((is_array($this->file_list) || $this->file_list instanceof \Countable ? count($this->file_list) : 0) > 0);
}
}
protected function progressAddFile()
{
$this->total_files++;
}
protected function progressMarkFileDone()
{
$this->done_files++;
}
protected function progressAddFolder()
{
$this->total_folders++;
}
protected function progressMarkFolderDone()
{
$this->done_folders++;
}
/**
* Returns the site root, the translated site root and the translated current directory
*
* @return array
*/
protected function getCleanDirectoryComponents()
{
$fsUtils = Factory::getFilesystemTools();
// Break directory components
if (Factory::getConfiguration()->get('akeeba.platform.override_root', 0))
{
$siteroot = Factory::getConfiguration()->get('akeeba.platform.newroot', '[SITEROOT]');
}
else
{
$siteroot = '[SITEROOT]';
}
$root = $this->root;
if ($this->root == $siteroot)
{
$translated_root = $fsUtils->translateStockDirs($siteroot, true);
}
else
{
$translated_root = $this->remove_path_prefix;
}
$dir = $fsUtils->TrimTrailingSlash($this->current_directory);
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN')
{
$translated_root = $fsUtils->TranslateWinPath($translated_root);
$dir = $fsUtils->TranslateWinPath($dir);
}
if (substr($dir, 0, strlen($translated_root)) == $translated_root)
{
$dir = substr($dir, strlen($translated_root));
}
elseif (in_array(substr($translated_root, -1), ['/', '\\']))
{
$new_translated_root = rtrim($translated_root, '/\\');
if (substr($dir, 0, strlen($new_translated_root)) == $new_translated_root)
{
$dir = substr($dir, strlen($new_translated_root));
}
}
if (substr($dir, 0, 1) == '/')
{
$dir = substr($dir, 1);
}
return [$root, $translated_root, $dir];
}
/**
* Steps the subdirectory scanning of the current directory
*
* @return boolean True on success, false on fatal error
*/
protected function scanSubdirs()
{
$engine = Factory::getScanEngine();
$subdirectories = false;
[$root, $translated_root, $dir] = $this->getCleanDirectoryComponents();
// Get a filters instance
$filters = Factory::getFilters();
if (is_null($this->getFolders_position))
{
Factory::getLog()->info("Scanning directories of " . $this->current_directory);
}
else
{
Factory::getLog()->info("Resuming scanning directories of " . $this->current_directory);
}
// Get subdirectories
$exception = null;
try
{
$subdirectories = $engine->getFolders($this->current_directory, $this->getFolders_position);
}
catch (WarningException $e)
{
Factory::getLog()->warning($e->getMessage());
$subdirectories = false;
}
catch (Exception $e)
{
$exception = $e;
}
// If the list contains "too many" items, please break this step!
if (Factory::getConfiguration()->get('volatile.breakflag', false))
{
// Log the step break decision, for debugging reasons
Factory::getLog()->info("Large directory " . $this->current_directory . " while scanning for subdirectories; I will resume scanning in next step.");
// Return immediately, marking that we are not done yet!
return true;
}
// Error control
if (!is_null($exception))
{
throw $exception;
}
// Start adding the subdirectories
if (!empty($subdirectories) && is_array($subdirectories))
{
$dereferenceSymlinks = Factory::getConfiguration()->get('engine.archiver.common.dereference_symlinks');
// If we have to treat symlinks as real directories just add everything
if ($dereferenceSymlinks)
{
// Treat symlinks to directories as actual directories
foreach ($subdirectories as $subdirectory)
{
$this->directory_list[] = $subdirectory;
$this->progressAddFolder();
}
}
// If we are told not to dereference symlinks we'll need to check each subdirectory thoroughly
else
{
// Treat symlinks to directories as simple symlink files (ONLY WORKS WITH CERTAIN ARCHIVERS!)
foreach ($subdirectories as $subdirectory)
{
if (is_link($subdirectory))
{
// Symlink detected; apply directory filters to it
if (empty($dir))
{
$dirSlash = $dir;
}
else
{
$dirSlash = $dir . '/';
}
$check = $dirSlash . basename($subdirectory);
Factory::getLog()->debug("Directory symlink detected: $check");
if (_AKEEBA_IS_WINDOWS)
{
$check = Factory::getFilesystemTools()->TranslateWinPath($check);
}
// Do I need this? $dir contains a path relative to the root anyway...
$check = ltrim(str_replace($translated_root, '', $check), '/');
// Check for excluded symlinks (note that they are excluded as DIRECTORIES in the GUI)
if ($filters->isFiltered($check, $root, 'dir', 'all'))
{
Factory::getLog()->info("Skipping directory symlink " . $check);
}
else
{
Factory::getLog()->debug('Adding folder symlink: ' . $check);
$this->file_list[] = $subdirectory;
$this->progressAddFile();
}
}
else
{
$this->directory_list[] = $subdirectory;
$this->progressAddFolder();
}
}
}
}
// If the scanner nullified the next position to scan, we're done
// scanning for subdirectories
if (is_null($this->getFolders_position))
{
$this->done_subdir_scanning = true;
}
return true;
}
/**
* Steps the files scanning of the current directory
*
* @return void True on success, false on fatal error
* @throws Exception
*/
protected function scanFiles()
{
$engine = Factory::getScanEngine();
$fileList = false;
[$root, $translated_root, $dir] = $this->getCleanDirectoryComponents();
// Get a filters instance
$filters = Factory::getFilters();
if (is_null($this->getFiles_position))
{
Factory::getLog()->info("Scanning files of " . $this->current_directory);
$this->processed_files_counter = 0;
}
else
{
Factory::getLog()->info("Resuming scanning files of " . $this->current_directory);
}
// Get file listing
$exception = null;
try
{
$fileList = $engine->getFiles($this->current_directory, $this->getFiles_position);
}
catch (WarningException $e)
{
Factory::getLog()->warning($e->getMessage());
$fileList = false;
}
catch (Exception $e)
{
$exception = $e;
}
// If the list contains "too many" items, please break this step!
if (Factory::getConfiguration()->get('volatile.breakflag', false))
{
// Log the step break decision, for debugging reasons
Factory::getLog()->info("Large directory " . $this->current_directory . " while scanning for files; I will resume scanning in next step.");
// Return immediately, marking that we are not done yet!
return;
}
// Error control
if (!is_null($exception))
{
throw $exception;
}
// Do I have an unreadable directory?
if ($fileList === false)
{
Factory::getLog()->warning('Unreadable directory ' . $this->current_directory);
$this->done_file_scanning = true;
}
// Directory was readable, process the file list
elseif (is_array($fileList) && !empty($fileList))
{
// Add required trailing slash to $dir
if (!empty($dir))
{
$dir .= '/';
}
// Scan all directory entries
foreach ($fileList as $fileName)
{
$check = $dir . basename($fileName);
if (_AKEEBA_IS_WINDOWS)
{
$check = Factory::getFilesystemTools()->TranslateWinPath($check);
}
// Do I need this? $dir contains a path relative to the root anyway...
$check = ltrim(str_replace($translated_root, '', $check), '/');
$byFilter = '';
$skipThisFile = $filters->isFilteredExtended($check, $root, 'file', 'all', $byFilter);
if ($skipThisFile)
{
Factory::getLog()->info("Skipping file $fileName (filter: $byFilter)");
}
else
{
$this->file_list[] = $fileName;
$this->processed_files_counter++;
$this->progressAddFile();
}
}
}
// If the scanner engine nullified the next position we are done
// scanning for files
if (is_null($this->getFiles_position))
{
$this->done_file_scanning = true;
}
// If the directory was genuinely empty we will have to add an empty
// directory entry in the archive, otherwise this directory will never
// be restored.
if ($this->done_file_scanning && ($this->processed_files_counter == 0))
{
Factory::getLog()->info("Empty directory " . $this->current_directory);
$archiver = Factory::getArchiverEngine();
if ($this->current_directory != $this->remove_path_prefix)
{
$archiver->addFile($this->current_directory, $this->remove_path_prefix, $this->path_prefix);
}
unset($archiver);
}
return;
}
/**
* Try to determine the next root folder to scan
*
* @return boolean True if there was a new root to scan
*/
protected function getNextRoot()
{
// We have finished with our directory list. Hmm... Do we have extra directories?
if (count($this->root_definitions) > 0)
{
Factory::getLog()->debug("More off-site directories detected");
$registry = Factory::getConfiguration();
$dir_definition = array_shift($this->root_definitions);
$this->remove_path_prefix = $dir_definition[0]; // Remove absolute path to directory when storing the file
if (is_null($dir_definition[1]))
{
$this->path_prefix = ''; // No added path for main site
}
else
{
$dir_definition[1] = trim($dir_definition[1]);
if (empty($dir_definition[1]) || $dir_definition[1] == '/')
{
$this->path_prefix = '';
}
else
{
$this->path_prefix = $registry->get('akeeba.advanced.virtual_folder') . '/' . $dir_definition[1];
}
}
$this->done_scanning = false; // Make sure we process this file list!
$this->root = $dir_definition[0];
// Translate the root into an absolute path
$stock_dirs = Platform::getInstance()->get_stock_directories();
$absolute_dir = substr($this->root, 0);
if (!empty($stock_dirs))
{
foreach ($stock_dirs as $key => $replacement)
{
$absolute_dir = str_replace($key, $replacement, $absolute_dir);
}
}
$this->directory_list[] = $absolute_dir;
$this->remove_path_prefix = $absolute_dir;
$registry->set('volatile.filesystem.current_root', $absolute_dir);
$this->total_files = 0;
$this->done_files = 0;
$this->total_folders = 0;
$this->done_folders = 0;
Factory::getLog()->info("Including new off-site directory to " . $dir_definition[1]);
return true;
}
else
// Nope, we are completely done!
{
$this->setState(self::STATE_POSTRUN);
return false;
}
}
}
PK \Sʉ 1 vendor/akeeba/engine/engine/Core/Domain/.htaccessnu 7m
Order allow,deny
Deny from all
PK \-;d d . vendor/akeeba/engine/engine/Core/Kettenrad.phpnu [ .
*/
namespace Akeeba\Engine\Core;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Exception;
use RuntimeException;
use Throwable;
/**
* Kettenrad is the main controller of Akeeba Engine. It's responsible for setting the engine into motion, running each
* and all domain objects to their completion.
*/
class Kettenrad extends Part
{
/**
* Set to true when akeebaBackupErrorHandler is registered as an error handler
*
* @var bool
*/
public static $registeredErrorHandler = false;
/**
* Set to true when deadOnTimeout is registered as a shutdown function
*
* @var bool
*/
public static $registeredShutdownCallback = false;
/**
* Cached copy of the response array
*
* @var array
*/
private $array_cache = null;
/**
* A unique backup ID which allows us to run multiple parallel backups using the same backup origin (tag)
*
* @var string
*/
private $backup_id = '';
/**
* The active domain's class name
*
* @var string
*/
private $class = '';
/**
* The current domain's name
*
* @var string
*/
private $domain = '';
/**
* The list of remaining steps
*
* @var array
*/
private $domain_chain = [];
/**
* The current backup's tag (actually: the backup's origin)
*
* @var string
*/
private $tag = null;
/**
* How many steps the domain_chain array contained when the backup began. Used for percentage calculations.
*
* @var int
*/
private $total_steps = 0;
/**
* Set to true when there are warnings available when getStatusArray() is called. This is used at the end of the
* backup to send a different push message depending on whether the backup completed with or without warnings.
*
* @var bool
*/
private $warnings_issued = false;
/**
* Kettenrad constructor.
*
* Overrides the Part constructor to initialize Kettenrad-specific properties.
*
* @return void
*/
public function __construct()
{
parent::__construct();
// Register the error handler
if (!static::$registeredErrorHandler)
{
static::$registeredErrorHandler = true;
set_error_handler('\\Akeeba\\Engine\\Core\\akeebaEngineErrorHandler');
}
}
public function _onSerialize()
{
parent::_onSerialize();
$this->array_cache = null;
}
/**
* Returns the unique Backup ID
*
* @return string
*/
public function getBackupId()
{
return $this->backup_id;
}
/**
* Sets the unique backup ID.
*
* @param string $backup_id
*
* @return void
*/
public function setBackupId($backup_id = null)
{
$this->backup_id = $backup_id;
}
/**
* Gets the percentage of the backup process done so far.
*
* @return string
*/
public function getProgress()
{
// Get the overall percentage (based on domains complete so far)
$remainingSteps = count($this->domain_chain) + 1;
$totalSteps = max($this->total_steps, 1);
$overall = 1 - ($remainingSteps / $totalSteps);
// How much is this step worth?
$currentStepMaxContribution = 1 / $totalSteps;
// Get the percentage reported from the domain object, zero if we can't get a domain object.
$object = !empty($this->class) ? Factory::getDomainObject($this->class) : null;
$local = is_object($object) ? $object->getProgress() : 0;
// Calculate the percentage and apply [0, 100] bounds.
$percentage = (int) (100 * ($overall + $local * $currentStepMaxContribution));
$percentage = max(0, $percentage);
$percentage = min(100, $percentage);
return $percentage;
}
/**
* Returns a copy of the class's status array
*
* @return array
*/
public function getStatusArray()
{
// Get the cached array
if (!empty($this->array_cache))
{
return $this->array_cache;
}
// Get the default table
$array = $this->makeReturnTable();
// Add the warnings
$array['Warnings'] = Factory::getLog()->getWarnings();
// Did we have warnings?
if (is_array($array['Warnings']) || $array['Warnings'] instanceof \Countable ? count($array['Warnings']) : 0)
{
$this->warnings_issued = true;
}
// Get the current step number
$stepCounter = Factory::getConfiguration()->get('volatile.step_counter', 0);
// Add the archive name
$statistics = Factory::getStatistics();
$record = $statistics->getRecord();
$array['Archive'] = $record['archivename'] ?? '';
// Translate HasRun to what the rest of the suite expects
$array['HasRun'] = ($this->getState() == self::STATE_FINISHED) ? 1 : 0;
$array['Error'] = is_null($array['ErrorException']) ? '' : $array['Error'];
$array['tag'] = $this->tag;
$array['Progress'] = $this->getProgress();
$array['backupid'] = $this->getBackupId();
$array['sleepTime'] = $this->waitTimeMsec;
$array['stepNumber'] = $stepCounter;
$array['stepState'] = $this->stateToString($this->getState());
$this->array_cache = $array;
return $this->array_cache;
}
/**
* Returns the current backup tag. If none is specified, it sets it to be the
* same as the current backup origin and returns the new setting.
*
* @return string
*/
public function getTag()
{
if (empty($this->tag))
{
// If no tag exists, we resort to the pre-set backup origin
$tag = Platform::getInstance()->get_backup_origin();
$this->tag = $tag;
}
return $this->tag;
}
/**
* Obsolete method.
*
* @deprecated 7.0
*/
public function resetWarnings()
{
Factory::getLog()->debug('DEPRECATED: Akeeba Engine consumers must remove calls to resetWarnings()');
}
/**
* The public interface to Kettenrad.
*
* Internally it calls Part::tick(), wrapped in a try-catch block which traps any runaway Exception (PHP 5) or
* Throwable we didn't manage to successfully suppress yet.
*
* @param int $nesting
*
* @return array A response array
*/
public function tick($nesting = 0)
{
$ret = null;
$e = null;
// PHP 7.x -- catch any unhandled Throwable, including PHP fatal errors
try
{
$ret = parent::tick($nesting);
}
catch (Throwable $e)
{
$this->setState(self::STATE_ERROR);
$this->lastException = $e;
}
// If an error occurred we don't have a return table. If that's the case create one and do log our errors.
if (!isset($ret))
{
// Log the existence of an unhandled exception
Factory::getLog()->warning("Kettenrad :: Caught unhandled exception. The backup will now fail.");
// Recursively log unhandled exceptions
self::logErrorsFromException($e);
// Create the missing return table
$ret = $this->makeReturnTable();
$this->array_cache = array_merge(is_null($this->array_cache) ? [] : $this->array_cache, $ret);
}
return $ret;
}
/**
* Finalization. Sets the state to STATE_FINISHED.
*
* @return void
*/
protected function _finalize()
{
// Open the log
$logTag = $this->getLogTag();
Factory::getLog()->open($logTag);
// Kill the cached array
$this->array_cache = null;
// Remove the memory file
$tempVarsTag = $this->tag . (empty($this->backup_id) ? '' : ('.' . $this->backup_id));
Factory::getFactoryStorage()->reset($tempVarsTag);
// All done.
Factory::getLog()->debug("Kettenrad :: Just finished");
$this->setState(self::STATE_FINISHED);
// Send a push message to mark the end of backup
$pushSubjectKey = $this->warnings_issued ? 'COM_AKEEBA_PUSH_ENDBACKUP_WARNINGS_SUBJECT' : 'COM_AKEEBA_PUSH_ENDBACKUP_SUCCESS_SUBJECT';
$pushBodyKey = $this->warnings_issued ? 'COM_AKEEBA_PUSH_ENDBACKUP_WARNINGS_BODY' : 'COM_AKEEBA_PUSH_ENDBACKUP_SUCCESS_BODY';
$platform = Platform::getInstance();
$timeStamp = date($platform->translate('DATE_FORMAT_LC2'));
$pushSubject = sprintf($platform->translate($pushSubjectKey), $platform->get_site_name(), $platform->get_host());
$pushDetails = sprintf($platform->translate($pushBodyKey), $platform->get_site_name(), $platform->get_host(), $timeStamp);
try
{
Factory::getPush()->message($pushSubject, $pushDetails);
}
catch (Throwable $e)
{
Factory::getLog()->notice(sprintf("Sending push notification failed: %s", $e->getMessage()));
}
}
/**
* Initialization. Sets the state to STATE_PREPARED.
*
* @return void
*/
protected function _prepare()
{
// Initialize the timer class. Do not remove, even though we don't use the object it needs to be initialized!
$timer = Factory::getTimer();
// Do we have a tag?
if (!empty($this->_parametersArray['tag']))
{
$this->tag = $this->_parametersArray['tag'];
}
// Make sure a tag exists (or create a new one)
$this->tag = $this->getTag();
// Reset the log
$logTag = $this->getLogTag();
Factory::getLog()->open($logTag);
Factory::getLog()->reset($logTag);
// Reset the storage
$factoryStorageTag = $this->tag . (empty($this->backup_id) ? '' : ('.' . $this->backup_id));
Factory::getFactoryStorage()->reset($factoryStorageTag);
// Apply the configuration overrides
$overrides = Platform::getInstance()->configOverrides;
if (is_array($overrides) && @count($overrides))
{
$registry = Factory::getConfiguration();
$protected_keys = $registry->getProtectedKeys();
$registry->resetProtectedKeys();
foreach ($overrides as $k => $v)
{
$registry->set($k, $v);
}
$registry->setProtectedKeys($protected_keys);
}
// Get the domain chain
$this->domain_chain = Factory::getEngineParamsProvider()->getDomainChain();
$this->total_steps = count($this->domain_chain) - 1; // Init shouldn't count in the progress bar
// Mark this engine for Nesting Logging
$this->nest_logging = true;
// Preparation is over
$this->array_cache = null;
$this->setState(self::STATE_PREPARED);
// Send a push message to mark the start of backup
$platform = Platform::getInstance();
$timeStamp = date($platform->translate('DATE_FORMAT_LC2'));
$pushSubject = sprintf($platform->translate('COM_AKEEBA_PUSH_STARTBACKUP_SUBJECT'), $platform->get_site_name(), $platform->get_host());
$pushDetails = sprintf($platform->translate('COM_AKEEBA_PUSH_STARTBACKUP_BODY'), $platform->get_site_name(), $platform->get_host(), $timeStamp, $this->getLogTag());
try
{
Factory::getPush()->message($pushSubject, $pushDetails);
}
catch (Throwable $e)
{
Factory::getLog()->notice(sprintf("Sending push notification failed: %s", $e->getMessage()));
}
}
/**
* Main backup process. Sets the state to STATE_RUNNING or STATE_POSTRUN.
*
* @return void
*/
protected function _run()
{
$result = null;
$logTag = $this->getLogTag();
$logger = Factory::getLog();
$logger->open($logTag);
// Maybe we're already done or in an error state?
if (in_array($this->getState(), [self::STATE_POSTRUN, self::STATE_ERROR]))
{
return;
}
// Set running state
$this->setState(self::STATE_RUNNING);
// Do I even have enough time...?
$timer = Factory::getTimer();
$registry = Factory::getConfiguration();
if (($timer->getTimeLeft() <= 0))
{
// We need to set the break flag for the part processing to not batch successive steps
$registry->set('volatile.breakflag', true);
return;
}
// Initialize operation counter
$registry->set('volatile.operation_counter', 0);
// Advance step counter
$stepCounter = $registry->get('volatile.step_counter', 0);
$registry->set('volatile.step_counter', ++$stepCounter);
// Log step start number
$logger->debug('====== Starting Step number ' . $stepCounter . ' ======');
if (defined('AKEEBADEBUG'))
{
$root = Platform::getInstance()->get_site_root();
$logger->debug('Site root: ' . $root);
}
$finished = false;
$error = false;
// BREAKFLAG is optionally passed by domains to force-break current operation
$breakFlag = false;
// Apply an infinite time limit if required
if ($registry->get('akeeba.tuning.settimelimit', 0))
{
if (function_exists('ini_set'))
{
@ini_set('max_execution_time', 844000);
}
if (function_exists('set_time_limit'))
{
set_time_limit(0);
}
}
// Apply a large memory limit (1Gb) if required
if ($registry->get('akeeba.tuning.setmemlimit', 0))
{
if (function_exists('ini_set'))
{
ini_set('memory_limit', '17179869184');
}
}
// Update statistics, marking the backup as currently processing a backup step.
Factory::getStatistics()->updateInStep(true);
// Loop until time's up, we're done or an error occurred, or BREAKFLAG is set
$this->array_cache = null;
$object = null;
while (($timer->getTimeLeft() > 0) && (!$finished) && (!$error) && (!$breakFlag))
{
// Reset the break flag
$registry->set('volatile.breakflag', false);
// Do we have to switch domains? This only happens if there is no active
// domain, or the current domain has finished
$have_to_switch = false;
$object = null;
if ($this->class == '')
{
$have_to_switch = true;
}
else
{
$object = Factory::getDomainObject($this->class);
if (!is_object($object))
{
$have_to_switch = true;
}
elseif (!in_array('getState', get_class_methods($object)))
{
$have_to_switch = true;
}
elseif ($object->getState() == self::STATE_FINISHED)
{
$have_to_switch = true;
}
}
// Switch domain if necessary
if ($have_to_switch)
{
$logger->debug('Kettenrad :: Switching domains');
if (!Factory::getConfiguration()->get('akeeba.tuning.nobreak.domains', 0))
{
$logger->debug("Kettenrad :: BREAKING STEP BEFORE SWITCHING DOMAIN");
$registry->set('volatile.breakflag', true);
}
// Free last domain
$object = null;
if (empty($this->domain_chain))
{
// Aw, we're done! No more domains to run.
$this->setState(self::STATE_POSTRUN);
$logger->debug("Kettenrad :: No more domains to process");
$logger->debug('====== Finished Step number ' . $stepCounter . ' ======');
$this->array_cache = null;
return;
}
// Shift the next definition off the stack
$this->array_cache = null;
$new_definition = array_shift($this->domain_chain);
if (array_key_exists('class', $new_definition))
{
$logger->debug("Switching to domain {$new_definition['domain']}, class {$new_definition['class']}");
$this->domain = $new_definition['domain'];
$this->class = $new_definition['class'];
// Get a working object
$object = Factory::getDomainObject($this->class);
$object->setup($this->_parametersArray);
}
else
{
$logger->warning("Kettenrad :: No class defined trying to switch domains. The backup will crash.");
$this->domain = null;
$this->class = null;
}
}
elseif (!is_object($object))
{
$logger->debug("Kettenrad :: Getting domain object of class {$this->class}");
$object = Factory::getDomainObject($this->class);
}
// Tick the object
$logger->debug('Kettenrad :: Ticking the domain object');
$this->lastException = null;
try
{
// We ask the domain object to execute and return its output array
$result = $object->tick();
$hasErrorException = array_key_exists('ErrorException', $result) && is_object($result['ErrorException']);
$hasErrorString = array_key_exists('Error', $result) && !empty($result['Error']);
/**
* Legacy objects may not be throwing exceptions on error, instead returning an Error string in the
* output array. The code below addresses this discrepancy.
*/
if (!$hasErrorException && $hasErrorString)
{
$result['ErrorException'] = new RuntimeException($result['Error']);
$hasErrorException = true;
}
/**
* Some domain objects may be acting as nested Parts, e.g. the Database domain. In this case the
* internal Engine (itself a Part object) is absorbing the thrown exception and relays it in the output
* table's ErrorException key. This means that the code above will NOT catch the error. This code below
* addresses that situation by rethrowing the exception.
*
* Practical example: cannot connect to MySQL is thrown by the MySQL Dump engine. The Native database
* backup engine absorbs the exception and reports it back to the Database domain object through the
* returned output array. However, the Database domain object does not rethrow it, simply relaying it
* back to Kettenrad through its own returned output array. As a result we enter an infinite loop where
* Kettenrad asks the Database domain to tick, it asks the Native engine to tick which asks the MySQL
* Dump object to tick. However the latter fails again to connect to MySQL and the whole process is
* repeated ad nauseam. By rethrowing the propagated ErrorException we alleviate this problem.
*/
if ($hasErrorException)
{
throw $result['ErrorException'];
}
$logger->debug('Kettenrad :: Domain object returned without errors; propagating');
}
catch (Exception $e)
{
/**
* Exceptions are used to propagate error conditions through the engine. Catching them and storing them
* in $this->lastException lets us detect and report the error condition in Kettenrad, the integration-
* facing interface of the backup engine.
*/
$this->lastException = $e;
$logger->debug('Kettenrad :: Domain object returned with errors; propagating');
self::logErrorsFromException($this->lastException);
$this->setState(self::STATE_ERROR);
}
// Advance operation counter
$currentOperationNumber = $registry->get('volatile.operation_counter', 0);
$currentOperationNumber++;
$registry->set('volatile.operation_counter', $currentOperationNumber);
// Process return array
$this->setDomain($this->domain);
$this->setStep($result['Step']);
$this->setSubstep($result['Substep']);
// Check for BREAKFLAG
$breakFlag = $registry->get('volatile.breakflag', false);
$logger->debug("Kettenrad :: Break flag status: " . ($breakFlag ? 'YES' : 'no'));
// Process errors
$error = $this->getState() === self::STATE_ERROR;
// Check if the backup procedure should finish now
$finished = $error ? true : !($result['HasRun']);
// Log operation end
$logger->debug('----- Finished operation ' . $currentOperationNumber . ' ------');
}
// Log the result
$objectStepType = is_object($object) ? get_class($object) : 'INVALID OBJECT';
if (!is_object($object))
{
$reason = ($timer->getTimeLeft() <= 0)
? 'we already ran out of time'
: 'a step break has already been requested';
$logger->debug(
sprintf(
"Finishing step immediately because %s", $reason
)
);
}
elseif (!$error)
{
$logger->debug("Successful Smart algorithm on " . $objectStepType);
}
else
{
$logger->error("Failed Smart algorithm on " . $objectStepType);
}
// Log if we have to do more work or not
/**
* The domain object is not set in the following cases:
*
* - There is no time left, the while loop never ran.
* - The break flag was already set, the while loop never ran.
* - We are already finished, the while loop never ran. Shouldn't happen, the step status is set to POSTRUN.
* - There was an error, the while loop never ran. Shouldn't happen, we return immediately upon an error.
* - We tried to go to the next domain but something went wrong. Shouldn't happen.
*
* If we get to a condition that shouldn't happen we will throw a Runtime exception. In any other case we let
* the step finish.
*/
if (!is_object($object) && ($timer->getTimeLeft() > 0) && !$breakFlag)
{
throw new RuntimeException(
sprintf(
"Kettenrad :: Empty object found when processing domain '%s'. This should never happen.",
$this->domain
)
);
}
/** @noinspection PhpStatementHasEmptyBodyInspection */
elseif (!is_object($object))
{
// This is an expected case.
// I have to use an empty case because $object->getState() below would cause a PHP error on a NULL variable.
}
elseif ($object->getState() == self::STATE_RUNNING)
{
$logger->debug("Kettenrad :: More work required in domain '" . $this->domain . "'");
// We need to set the break flag for the part processing to not batch successive steps
$registry->set('volatile.breakflag', true);
}
elseif ($object->getState() == self::STATE_FINISHED)
{
$logger->debug("Kettenrad :: Domain '" . $this->domain . "' has finished.");
$registry->set('volatile.breakflag', false);
}
elseif ($object->getState() == self::STATE_ERROR)
{
$logger->debug("Kettenrad :: Domain '" . $this->domain . "' has experienced an error.");
$registry->set('volatile.breakflag', false);
}
// Log step end
$logger->debug('====== Finished Step number ' . $stepCounter . ' ======');
// Update statistics, marking the backup as having just finished processing a backup step.
Factory::getStatistics()->updateInStep(false);
if (!$registry->get('akeeba.tuning.nobreak.domains', 0))
{
// Force break between steps
$logger->debug('Kettenrad :: Setting the break flag between domains');
$registry->set('volatile.breakflag', true);
}
}
/**
* Returns the tag used to open the correct log file
*
* @return string
*/
protected function getLogTag()
{
$tag = $this->getTag();
if (!empty($this->backup_id))
{
$tag .= '.' . $this->backup_id;
}
return $tag;
}
}
/**
* Timeout error handler
*/
function akeebaEnginePHPTimeoutHandler()
{
if (connection_status() == 1)
{
Factory::getLog()->error('The process was aborted on user\'s request');
return;
}
if (connection_status() >= 2)
{
Factory::getLog()->error('Akeeba Backup has timed out. Please read the documentation.');
return;
}
}
// Register the timeout error handler
if (!Kettenrad::$registeredShutdownCallback)
{
Kettenrad::$registeredShutdownCallback = true;
register_shutdown_function("\\Akeeba\\Engine\\Core\\akeebaEnginePHPTimeoutHandler");
}
/**
* Custom PHP error handler to log catchable PHP errors to the backup log file
*
* @param int $errno
* @param string $errstr
* @param string $errfile
* @param int $errline
*
* @return bool|null
*/
function akeebaEngineErrorHandler($errno, $errstr, $errfile, $errline)
{
// Sanity check
if (!function_exists('error_reporting'))
{
return false;
}
/**
* Special consideration: Joomla.
*
* Joomla logs a crapton of user deprecated notices **from its own core code**. If we have a user deprecated notice
* in Joomla and the source file does not look like it is part of our software, we will not log it.
*/
$realFile = realpath($errfile);
$realLibs = defined('JPATH_LIBRARIES') ? realpath(JPATH_LIBRARIES) : null;
if (defined('_JEXEC')
&& $errno === E_USER_DEPRECATED
&& !empty($realLibs)
&& !empty($realFile)
&& str_starts_with($realFile, $realLibs)
)
{
return false;
}
// Do not proceed if the error springs from an @function() construct, or if
// the overall error reporting level is set to report no errors.
$error_reporting = error_reporting();
if ($error_reporting == 0)
{
return false;
}
$loggable = false;
$type = '';
$logMode = 'debug';
switch ($errno)
{
case E_ERROR:
case E_USER_ERROR:
case E_RECOVERABLE_ERROR:
/**
* This will only work for E_RECOVERABLE_ERROR and E_USER_ERROR, not E_ERROR. In PHP 7+ all errors throw an
* Error throwable (a special kind of exception) which propagates nicely within our architecture.
*/
Factory::getLog()->error("PHP FATAL ERROR on line $errline in file $errfile:");
Factory::getLog()->error($errstr);
Factory::getLog()->error("Execution aborted due to PHP fatal error");
break;
case E_WARNING:
$loggable = true;
$type = 'WARNING';
$logMode = defined('AKEEBADEBUG') ? 'warning' : 'debug';
break;
case E_USER_WARNING:
$loggable = defined('AKEEBADEBUG');
$type = 'User Warning';
break;
case E_NOTICE:
$loggable = defined('AKEEBADEBUG');
$type = 'Notice';
break;
case E_USER_NOTICE:
$loggable = defined('AKEEBADEBUG');
$type = 'User Notice';
break;
case E_DEPRECATED:
$loggable = defined('AKEEBADEBUG');
$type = 'Deprecated';
break;
case E_USER_DEPRECATED:
$loggable = defined('AKEEBADEBUG');
$type = 'User Deprecated';
break;
case E_STRICT:
$loggable = defined('AKEEBADEBUG');
$type = 'Strict Notice';
break;
default:
// Anything other. Let PHP handle it.
return false;
break;
}
if ($loggable)
{
Factory::getLog()->{$logMode}(
sprintf("PHP %s (not an error; you can ignore) on line %s in file %s:", $type, $errline, $realFile)
);
Factory::getLog()->{$logMode}($errstr);
}
// Uncomment to prevent the execution of PHP's internal error handler
//return true;
// Let PHP's internal error handler take care of the error.
return false;
}
PK \N / vendor/akeeba/engine/engine/Core/scripting.jsonnu [ {
"volatile.akeebaengine.domains": "init|installer|packdb|packing|finale",
"volatile.akeebaengine.scripts": "full|dbonly|fileonly|alldb|incfile|incfull",
"volatile.domain.init.domain": "init",
"volatile.domain.init.class": "Init",
"volatile.domain.init.text": "COM_AKEEBA_BACKUP_LABEL_DOMAIN_INIT",
"volatile.domain.installer.domain": "installer",
"volatile.domain.installer.class": "Installer",
"volatile.domain.installer.text": "COM_AKEEBA_BACKUP_LABEL_DOMAIN_INSTALLER",
"volatile.domain.packdb.domain": "PackDB",
"volatile.domain.packdb.class": "Db",
"volatile.domain.packdb.text": "COM_AKEEBA_BACKUP_LABEL_DOMAIN_PACKDB",
"volatile.domain.packing.domain": "Packing",
"volatile.domain.packing.class": "Pack",
"volatile.domain.packing.text": "COM_AKEEBA_BACKUP_LABEL_DOMAIN_PACKING",
"volatile.domain.finale.domain": "finale",
"volatile.domain.finale.class": "Finalization",
"volatile.domain.finale.text": "COM_AKEEBA_BACKUP_LABEL_DOMAIN_FINISHED",
"volatile.scripting.full.chain": "init|installer|packdb|packing|finale",
"volatile.scripting.full.text": "COM_AKEEBA_CONFIG_BACKUPTYPE_FULL",
"volatile.scripting.full.db.saveasname": "normal",
"volatile.scripting.full.db.databasesini": "1",
"volatile.scripting.full.db.skipextradb": "0",
"volatile.scripting.full.db.abstractnames": "1",
"volatile.scripting.full.db.dropstatements": "0",
"volatile.scripting.full.db.delimiterstatements": "0",
"volatile.scripting.full.core.createarchive": "1",
"volatile.scripting.dbonly.chain": "init|packdb|finale",
"volatile.scripting.dbonly.text": "COM_AKEEBA_CONFIG_BACKUPTYPE_DBONLY",
"volatile.scripting.dbonly.db.saveasname": "output",
"volatile.scripting.dbonly.db.databasesini": "0",
"volatile.scripting.dbonly.db.skipextradb": "1",
"volatile.scripting.dbonly.db.abstractnames": "0",
"volatile.scripting.dbonly.db.dropstatements": "1",
"volatile.scripting.dbonly.db.delimiterstatements": "1",
"volatile.scripting.dbonly.core.forceextension": ".sql",
"volatile.scripting.dbonly.core.createarchive": "0",
"volatile.scripting.fileonly.chain": "init|packing|finale",
"volatile.scripting.fileonly.text": "COM_AKEEBA_CONFIG_BACKUPTYPE_FILEONLY",
"volatile.scripting.fileonly.core.createarchive": "1",
"volatile.scripting.alldb.chain": "init|installer|packdb|finale",
"volatile.scripting.alldb.text": "COM_AKEEBA_CONFIG_BACKUPTYPE_ALLDB",
"volatile.scripting.alldb.db.tempfile": "temporary",
"volatile.scripting.alldb.db.saveasname": "normal",
"volatile.scripting.alldb.db.databasesini": "1",
"volatile.scripting.alldb.db.skipextradb": "0",
"volatile.scripting.alldb.db.abstractnames": "1",
"volatile.scripting.alldb.db.dropstatements": "0",
"volatile.scripting.alldb.db.delimiterstatements": "0",
"volatile.scripting.alldb.db.finalizearchive": "1",
"volatile.scripting.alldb.core.createarchive": "1",
"volatile.scripting.incfile.chain": "init|packing|finale",
"volatile.scripting.incfile.text": "COM_AKEEBA_CONFIG_BACKUPTYPE_INCFILE",
"volatile.scripting.incfile.filter.incremental": "1",
"volatile.scripting.incfull.chain": "init|installer|packdb|packing|finale",
"volatile.scripting.incfull.text": "COM_AKEEBA_CONFIG_BACKUPTYPE_INCFULL",
"volatile.scripting.incfull.db.saveasname": "normal",
"volatile.scripting.incfull.db.databasesini": "1",
"volatile.scripting.incfull.db.skipextradb": "0",
"volatile.scripting.incfull.db.abstractnames": "1",
"volatile.scripting.incfull.db.dropstatements": "0",
"volatile.scripting.incfull.db.delimiterstatements": "0",
"volatile.scripting.incfull.core.createarchive": "1",
"volatile.scripting.incfull.filter.incremental": "1"
}PK \J J - vendor/akeeba/engine/engine/Core/Database.phpnu [ .
*/
namespace Akeeba\Engine\Core;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Base as DriverBase;
use Akeeba\Engine\Driver\Mysqli;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\HashTrait;
/**
* A utility class to return a database connection object
*/
class Database
{
use HashTrait;
private static $instances = [];
/**
* Returns a database connection object. It caches the created objects for future use.
*
* @param array $options The database driver connection options
*
* @return DriverBase|object A DriverBase object or something with magic methods that's compatible with it
*/
public static function &getDatabase(array $options)
{
// Get the options signature.
$signature = self::md5(serialize($options));
// If there's a cached object return it.
if (!empty(self::$instances[$signature]))
{
return self::$instances[$signature];
}
// Get the driver name / class
$driver = preg_replace('/[^A-Z0-9_\\\.-]/i', '', $options['driver'] ?? '');
// If there is no driver specified ask the Platform to guess it.
if (empty($driver))
{
$default_signature = self::md5(serialize(Platform::getInstance()->get_platform_database_options()));
$driver = Platform::getInstance()->get_default_database_driver($signature === $default_signature);
}
// Ensure we have the FQN of the driver class
if ((substr($driver, 0, 7) != '\\Akeeba') && substr($driver, 0, 7) != 'Akeeba\\')
{
$driver = '\\Akeeba\\Engine\\Driver\\' . ucfirst($driver);
}
// Map the legacy MySQL driver to the newer MySQLi
if (($driver == '\\Akeeba\\Engine\\Driver\\Mysql') && !function_exists('mysql_connect'))
{
$driver = Mysqli::class;
}
// Translate MySQL SSL options
if (!isset($options['ssl']) || !is_array($options['ssl']))
{
$options['ssl'] = [
'enable' => (bool) ($options['dbencryption'] ?? false),
'cipher' => ($options['dbsslcipher'] ?? '') ?: '',
'ca' => ($options['dbsslca'] ?? '') ?: '',
'capath' => ($options['dbsslcapath'] ?? '') ?: '',
'key' => ($options['dbsslkey'] ?? '') ?: '',
'cert' => ($options['dbsslcert'] ?? '') ?: '',
'verify_server_cert' => ($options['dbsslverifyservercert'] ?? false) ?: false,
];
}
// Instantiate the database driver object and return it
self::$instances[$signature] = new $driver($options);
return self::$instances[$signature];
}
/**
* Un-cache a database driver object
*
* @param array $options The database driver connection options
*
* @return void
*/
public static function unsetDatabase(array $options): void
{
$signature = self::md5(serialize($options));
if (!isset(self::$instances[$signature]))
{
return;
}
unset(self::$instances[$signature]);
}
}
PK \~;ӟ * vendor/akeeba/engine/engine/Core/Timer.phpnu [ .
*/
namespace Akeeba\Engine\Core;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
/**
* Timer class
*/
class Timer
{
/** @var float Maximum execution time allowance per step */
private $max_exec_time = null;
/** @var int Timestamp of execution start */
private $start_time = null;
/**
* Public constructor, creates the timer object and calculates the execution time limits
*
* @param int|null $maxExecTime Maximum execution time, in seconds (minimum 1 second)
* @param int|null $bias Execution time bias, in percentage points (10-100)
*/
public function __construct(?int $maxExecTime = null, ?int $bias = null)
{
// Initialize start time
$this->start_time = $this->microtime_float();
// Make sure we have max execution time and execution time bias or use the ones configured in the backup profile
$configuration = Factory::getConfiguration();
$maxExecTime = $maxExecTime ?? (int) $configuration->get('akeeba.tuning.max_exec_time', 14);
$bias = $bias ?? (int) $configuration->get('akeeba.tuning.run_time_bias', 75);
// Make sure both max exec time and bias are positive integers within the allowed range of values
$maxExecTime = max(1, $maxExecTime);
$bias = min(100, max(10, $bias));
$this->max_exec_time = $maxExecTime * $bias / 100;
}
/**
* Wake-up function to reset internal timer when we get unserialized
*/
public function __wakeup()
{
// Re-initialize start time on wake-up
$this->start_time = $this->microtime_float();
}
/**
* Gets the number of seconds left, before we hit the "must break" threshold
*
* @return float
*/
public function getTimeLeft()
{
return $this->max_exec_time - $this->getRunningTime();
}
/**
* Gets the time elapsed since object creation/unserialization, effectively how
* long Akeeba Engine has been processing data
*
* @return float
*/
public function getRunningTime()
{
return $this->microtime_float() - $this->start_time;
}
/**
* Enforce the minimum execution time
*
* @param bool $log Should I log what I'm doing? Default is true.
* @param bool $serverSideSleep Should I sleep on the server side? If false we return the amount of time to
* wait in msec
*
* @return int Wait time to reach min_execution_time in msec
*/
public function enforce_min_exec_time($log = true, $serverSideSleep = true)
{
// Try to get a sane value for PHP's maximum_execution_time INI parameter
if (@function_exists('ini_get'))
{
$php_max_exec = @ini_get("maximum_execution_time");
}
else
{
$php_max_exec = 10;
}
if (($php_max_exec == "") || ($php_max_exec == 0))
{
$php_max_exec = 10;
}
// Decrease $php_max_exec time by 500 msec we need (approx.) to tear down
// the application, as well as another 500msec added for rounding
// error purposes. Also make sure this is never gonna be less than 0.
$php_max_exec = max($php_max_exec * 1000 - 1000, 0);
// Get the "minimum execution time per step" Akeeba Backup configuration variable
$configuration = Factory::getConfiguration();
$minexectime = $configuration->get('akeeba.tuning.min_exec_time', 0);
if (!is_numeric($minexectime))
{
$minexectime = 0;
}
// Make sure we are not over PHP's time limit!
if ($minexectime > $php_max_exec)
{
$minexectime = $php_max_exec;
}
// Get current running time
$elapsed_time = $this->getRunningTime() * 1000;
$clientSideSleep = 0;
// Only run a sleep delay if we haven't reached the minexectime execution time
if (($minexectime > $elapsed_time) && ($elapsed_time > 0))
{
$sleep_msec = (int)($minexectime - $elapsed_time);
if (!$serverSideSleep)
{
Factory::getLog()->debug("Asking client to sleep for $sleep_msec msec");
$clientSideSleep = $sleep_msec;
}
elseif (function_exists('usleep'))
{
if ($log)
{
Factory::getLog()->debug("Sleeping for $sleep_msec msec, using usleep()");
}
usleep(1000 * $sleep_msec);
}
elseif (function_exists('time_nanosleep'))
{
if ($log)
{
Factory::getLog()->debug("Sleeping for $sleep_msec msec, using time_nanosleep()");
}
$sleep_sec = floor($sleep_msec / 1000);
$sleep_nsec = 1000000 * ($sleep_msec - ($sleep_sec * 1000));
time_nanosleep($sleep_sec, $sleep_nsec);
}
elseif (function_exists('time_sleep_until'))
{
if ($log)
{
Factory::getLog()->debug("Sleeping for $sleep_msec msec, using time_sleep_until()");
}
$until_timestamp = time() + $sleep_msec / 1000;
time_sleep_until($until_timestamp);
}
elseif (function_exists('sleep'))
{
$sleep_sec = ceil($sleep_msec / 1000);
if ($log)
{
Factory::getLog()->debug("Sleeping for $sleep_sec seconds, using sleep()");
}
sleep($sleep_sec);
}
}
elseif ($elapsed_time > 0)
{
// No sleep required, even if user configured us to be able to do so.
if ($log)
{
Factory::getLog()->debug("No need to sleep; execution time: $elapsed_time msec; min. exec. time: $minexectime msec");
}
}
return $clientSideSleep;
}
/**
* Reset the timer. It should only be used in CLI mode!
*/
public function resetTime()
{
$this->start_time = $this->microtime_float();
}
/**
* Returns the current timestamp in decimal seconds
*/
protected function microtime_float()
{
[$usec, $sec] = explode(" ", microtime());
return ((float) $usec + (float) $sec);
}
}
PK \y
/ vendor/akeeba/engine/engine/Core/05.tuning.jsonnu [ {
"_group": {
"description": "COM_AKEEBA_CONFIG_HEADER_TUNING"
},
"akeeba.tuning.min_exec_time": {
"default": "2000",
"type": "integer",
"min": "0",
"max": "20000",
"shortcuts": "0|250|500|1000|2000|3000|4000|5000|7500|10000|15000|20000",
"scale": "1000",
"uom": "s",
"title": "COM_AKEEBA_CONFIG_MINEXECTIME_TITLE",
"description": "COM_AKEEBA_CONFIG_MINEXECTIME_DESCRIPTION"
},
"akeeba.tuning.max_exec_time": {
"default": "14",
"type": "integer",
"min": "0",
"max": "180",
"shortcuts": "1|2|3|5|7|10|14|15|20|23|25|30|45|60|90|120|180",
"scale": "1",
"uom": "s",
"title": "COM_AKEEBA_CONFIG_MAXEXECTIME_TITLE",
"description": "COM_AKEEBA_CONFIG_MAXEXECTIME_DESCRIPTION"
},
"akeeba.tuning.run_time_bias": {
"default": "75",
"type": "integer",
"min": "10",
"max": "100",
"shortcuts": "10|20|25|30|40|50|60|75|80|90|100",
"scale": "1",
"uom": "%",
"title": "COM_AKEEBA_CONFIG_RUNTIMEBIAS_TITLE",
"description": "COM_AKEEBA_CONFIG_RUNTIMEBIAS_DESCRIPTION"
},
"akeeba.advanced.autoresume": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_AUTORESUME_TITLE",
"description": "COM_AKEEBA_CONFIG_AUTORESUME_DESCRIPTION"
},
"akeeba.advanced.autoresume_timeout": {
"default": "10",
"type": "integer",
"min": "1",
"max": "36000",
"scale": "1",
"uom": "s",
"shortcuts": "3|5|10|15|20|30|45|60|90|120|300|600|900|1800|3600",
"title": "COM_AKEEBA_CONFIG_AUTORESUME_TIMEOUT_TITLE",
"description": "COM_AKEEBA_CONFIG_AUTORESUME_TIMEOUT_DESCRIPTION",
"showon": "akeeba.advanced.autoresume:1"
},
"akeeba.advanced.autoresume_maxretries": {
"default": "3",
"type": "integer",
"min": "1",
"max": "1000",
"scale": "1",
"shortcuts": "1|3|5|7|10|15|20|30|50|100",
"title": "COM_AKEEBA_CONFIG_AUTORESUME_MAXRETRIES_TITLE",
"description": "COM_AKEEBA_CONFIG_AUTORESUME_MAXRETRIES_DESCRIPTION",
"showon": "akeeba.advanced.autoresume:1"
},
"akeeba.tuning.nobreak.beforelargefile": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.tuning.nobreak.afterlargefile": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.tuning.nobreak.proactive": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.tuning.nobreak.domains": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.tuning.nobreak.finalization": {
"default": "0",
"type": "none",
"protected": "1"
},
"akeeba.tuning.settimelimit": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_ADVANCED_SETTIMELIMIT_LABEL",
"description": "COM_AKEEBA_CONFIG_ADVANCED_SETTIMELIMIT_DESC"
},
"akeeba.tuning.setmemlimit": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_ADVANCED_SETMEMLIMIT_LABEL",
"description": "COM_AKEEBA_CONFIG_ADVANCED_SETMEMLIMIT_DESC"
}
}PK \3 . vendor/akeeba/engine/engine/Core/01.basic.jsonnu [ {
"_group": {
"description": "COM_AKEEBA_CONFIG_HEADER_BASIC"
},
"akeeba.basic.output_directory": {
"default": "[DEFAULT_OUTPUT]",
"type": "browsedir",
"title": "COM_AKEEBA_CONFIG_OUTDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_OUTDIR_DESCRIPTION"
},
"akeeba.basic.log_level": {
"default": "4",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_LOGLEVEL_NONE|COM_AKEEBA_CONFIG_LOGLEVEL_WARNING|COM_AKEEBA_CONFIG_LOGLEVEL_DEBUG",
"enumvalues": "0|2|4",
"title": "COM_AKEEBA_CONFIG_LOGLEVEL_TITLE",
"description": "COM_AKEEBA_CONFIG_LOGLEVEL_DESCRIPTION"
},
"akeeba.basic.archive_name": {
"default": "site-[HOST]-[DATE]-[TIME_TZ]-[RANDOM]",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ARCHIVENAME_TITLE",
"description": "COM_AKEEBA_CONFIG_ARCHIVENAME_DESCRIPTION"
},
"akeeba.basic.backup_type": {
"default": "full",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_BACKUPTYPE_FULL|COM_AKEEBA_CONFIG_BACKUPTYPE_DBONLY",
"enumvalues": "full|dbonly",
"title": "COM_AKEEBA_CONFIG_BACKUPTYPE_TITLE",
"description": "COM_AKEEBA_CONFIG_BACKUPTYPE_DESCRIPTION"
},
"akeeba.basic.clientsidewait": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_CLIENTSIDEWAIT_TITLE",
"description": "COM_AKEEBA_CONFIG_CLIENTSIDEWAIT_DESCRIPTION"
}
}PK \-y|r* r* , vendor/akeeba/engine/engine/Core/Filters.phpnu [ .
*/
namespace Akeeba\Engine\Core;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Filter\Base as FilterBase;
use Akeeba\Engine\Platform;
use DirectoryIterator;
use RuntimeException;
/**
* Akeeba filtering feature
*/
class Filters
{
/** @var array An array holding data for all defined filters */
private $filter_registry = [];
/** @var FilterBase[] Hash array with instances of all filters as $filter_name => filter_object */
private $filters = [];
/** @var bool True after the filter clean up has run */
private $cleanup_has_run = false;
/**
* Public constructor, loads filter data and filter classes
*/
public function __construct()
{
// Load filter data from platform's database
Factory::getLog()->debug('Fetching filter data from database');
$this->filter_registry = Platform::getInstance()->load_filters();
// Load platform, plugin and core filters
$this->filters = [];
$locations = [
Factory::getAkeebaRoot() . '/Filter',
];
$platform_paths = Platform::getInstance()->getPlatformDirectories();
foreach ($platform_paths as $p)
{
$locations[] = $p . '/Filter';
}
Factory::getLog()->debug('Loading filters');
foreach ($locations as $folder)
{
if (!@is_dir($folder))
{
continue;
}
if (!@is_readable($folder))
{
continue;
}
$di = new DirectoryIterator($folder);
foreach ($di as $file)
{
if (!$file->isFile())
{
continue;
}
// PHP 5.3.5 and earlier do not support getExtension
if ($file->getExtension() != 'php')
{
continue;
}
$filename = $file->getFilename();
// Skip filter files starting with dot or dash
if (in_array(substr($filename, 0, 1), ['.', '_']))
{
continue;
}
// Some hosts copy .json and .php files, renaming them (ie foobar.1.php)
// We need to exclude them, otherwise we'll get a fatal error for declaring the same class twice
$bare_name = $file->getBasename('.php');
if (preg_match('/[^a-zA-Z0-9]/', $bare_name))
{
continue;
}
// Extract filter base name
$filter_name = ucfirst($bare_name);
// This is an abstract class; do not try to create instance
if ($filter_name == 'Base')
{
continue;
}
// Skip already loaded filters
if (array_key_exists($filter_name, $this->filters))
{
continue;
}
Factory::getLog()->debug('-- Loading filter ' . $filter_name);
// Add the filter
$this->filters[$filter_name] = Factory::getFilterObject($filter_name);
}
}
// Load platform, plugin and core stacked filters
$locations = [
Factory::getAkeebaRoot() . '/Filter/Stack',
];
$platform_paths = Platform::getInstance()->getPlatformDirectories();
$platform_stack_paths = [];
foreach ($platform_paths as $p)
{
$locations[] = $p . '/Filter';
$locations[] = $p . '/Filter/Stack';
$platform_stack_paths[] = $p . '/Filter/Stack';
}
$config = Factory::getConfiguration();
Factory::getLog()->debug('Loading optional filters');
foreach ($locations as $folder)
{
if (!@is_dir($folder))
{
continue;
}
if (!@is_readable($folder))
{
continue;
}
$di = new DirectoryIterator($folder);
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if (!$file->isFile())
{
continue;
}
// PHP 5.3.5 and earlier do not support getExtension
// if ($file->getExtension() != 'php')
if (substr($file->getBasename(), -4) != '.php')
{
continue;
}
// Some hosts copy .json and .php files, renaming them (ie foobar.1.php)
// We need to exclude them, otherwise we'll get a fatal error for declaring the same class twice
$bare_name = strtolower($file->getBasename('.php'));
if (preg_match('/[^A-Za-z0-9]/', $bare_name))
{
continue;
}
// Extract filter base name
if (substr($bare_name, 0, 5) == 'stack')
{
$bare_name = substr($bare_name, 5);
}
$filter_name = 'Stack\\Stack' . ucfirst($bare_name);
// Skip already loaded filters
if (array_key_exists($filter_name, $this->filters))
{
continue;
}
// Make sure the JSON file also exists
if (!file_exists($folder . '/' . $bare_name . '.json'))
{
continue;
}
$key = "core.filters.$bare_name.enabled";
if ($config->get($key, 0))
{
Factory::getLog()->debug('-- Loading optional filter ' . $filter_name);
// Add the filter
$this->filters[$filter_name] = Factory::getFilterObject($filter_name);
}
}
}
}
/**
* Extended filtering information of a given object. Applies only to exclusion filters.
*
* @param string|array $test The string to check for filter status (e.g. filename, dir name, table name,
* etc)
* @param string $root The exclusion root test belongs to
* @param string $object What type of object is it? dir|file|dbobject
* @param string $subtype Filter subtype (all|content|children)
* @param string $by_filter [out] The filter name which first matched $test, or an empty string
*
* @return bool True if it is a filtered element
*/
public function isFilteredExtended($test, $root, $object, $subtype, &$by_filter)
{
if (!$this->cleanup_has_run)
{
// Loop the filters and clean up those with no data
/**
* @var string $filter_name
* @var FilterBase $filter
*/
foreach ($this->filters as $filter_name => $filter)
{
if (!$filter->hasFilters())
{
unset($this->filters[$filter_name]);
} // Remove empty filters
}
$this->cleanup_has_run = true;
}
$by_filter = '';
if (!empty($this->filters))
{
foreach ($this->filters as $filter_name => $filter)
{
if ($filter->isFiltered($test, $root, $object, $subtype))
{
$by_filter = strtolower($filter_name);
return true;
}
}
// If we are still here, no filter matched
return false;
}
else
{
return false;
}
}
/**
* Returns the filtering status of a given object
*
* @param string|array $test The string to check for filter status (e.g. filename, dir name, table name, etc)
* @param string $root The exclusion root test belongs to
* @param string $object What type of object is it? dir|file|dbobject
* @param string $subtype Filter subtype (all|content|children)
*
* @return bool True if it is a filtered element
*/
public function isFiltered($test, $root, $object, $subtype)
{
$by_filter = '';
return $this->isFilteredExtended($test, $root, $object, $subtype, $by_filter);
}
/**
* Returns the inclusion filters for a specific object type
*
* @param string $object The inclusion object (dir|db)
*
* @return array
*/
public function &getInclusions($object)
{
$inclusions = [];
if (!empty($this->filters))
{
/**
* @var string $filter_name
* @var FilterBase $filter
*/
foreach ($this->filters as $filter_name => $filter)
{
if (!is_object($filter))
{
throw new RuntimeException("Object for filter $filter_name not found. The engine will now crash.");
}
$new_inclusions = $filter->getInclusions($object);
if (!empty($new_inclusions))
{
$inclusions = array_merge($inclusions, $new_inclusions);
}
}
}
return $inclusions;
}
/**
* Returns the filter registry information for a specified filter class
*
* @param string $filter_name The name of the filter we want data for
*
* @return array The filter data for the requested filter
*/
public function &getFilterData($filter_name)
{
if (array_key_exists($filter_name, $this->filter_registry))
{
return $this->filter_registry[$filter_name];
}
else
{
$dummy = [];
return $dummy;
}
}
/**
* Replaces the filter data of a specific filter with the new data
*
* @param string $filter_name The filter for which to modify the stored data
* @param string $data The new data
*/
public function setFilterData($filter_name, &$data)
{
$this->filter_registry[$filter_name] = $data;
}
/**
* Saves all filters to the platform defined database
*
* @return bool True on success
*/
public function save()
{
return Platform::getInstance()->save_filters($this->filter_registry);
}
/**
* Get SQL statements to append to the database backup file
*
* @param string $root
*
* @return array
*/
public function getExtraSQL(string $root): array
{
if (count($this->filters) < 1)
{
return [];
}
$ret = [];
/**
* @var FilterBase $filter
*/
foreach ($this->filters as $filter)
{
$ret = array_merge($ret, $filter->getExtraSQL($root));
}
return $ret;
}
public function filterDatabaseRowContent(string $root, string $tableAbstract, array &$row): void
{
foreach ($this->filters as $filter)
{
$filter->filterDatabaseRowContent($root, $tableAbstract, $row);
}
}
public function canFilterDatabaseRowContent(): bool
{
return array_reduce($this->filters, function (bool $carry, FilterBase $filter) {
return $carry || $filter->canFilterDatabaseRowContent;
}, false);
}
/**
* Checks if there is an active filter for the object/subtype requested.
*
* @param string $object The filtering object: dir|file|dbobject|db
* @param string $subtype The filtering subtype: all|content|children|inclusion
*
* @return bool
*/
public function hasFilterType($object, $subtype = null)
{
foreach ($this->filters as $filter_name => $filter)
{
if ($filter->object == $object)
{
if (is_null($subtype))
{
return true;
}
elseif ($filter->subtype == $subtype)
{
return true;
}
}
}
return false;
}
/**
* Resets all filters, reverting them to a blank state
*
* @return void
*
* @since 5.4.0
*/
public function reset()
{
$this->filter_registry = [];
}
}
PK \ 1 vendor/akeeba/engine/engine/Core/02.advanced.jsonnu [ {
"_group": {
"description": "COM_AKEEBA_CONFIG_ADVANCED"
},
"akeeba.advanced.dump_engine": {
"default": "native",
"type": "engine",
"subtype": "dump",
"protected": "1",
"title": "COM_AKEEBA_CONFIG_DUMPENGINE_TITLE",
"description": "COM_AKEEBA_CONFIG_DUMPENGINE_DESCRIPTION"
},
"akeeba.advanced.scan_engine": {
"default": "smart",
"type": "engine",
"subtype": "scan",
"protected": "1",
"title": "COM_AKEEBA_CONFIG_SCANENGINE_TITLE",
"description": "COM_AKEEBA_CONFIG_SCANENGINE_DESCRIPTION"
},
"akeeba.advanced.archiver_engine": {
"default": "jpa",
"type": "engine",
"subtype": "archiver",
"title": "COM_AKEEBA_CONFIG_ARCHIVERENGINE_TITLE",
"description": "COM_AKEEBA_CONFIG_ARCHIVERENGINE_DESCRIPTION"
},
"akeeba.advanced.postproc_engine": {
"default": "none",
"type": "none",
"protected": "1"
},
"akeeba.advanced.embedded_installer": {
"default": "brs",
"type": "none",
"protected": "1"
},
"engine.installer.angie.key": {
"default": "",
"type": "none",
"protected": "1"
}
}PK \Sʉ * vendor/akeeba/engine/engine/Core/.htaccessnu 7m
Order allow,deny
Deny from all
PK \t%9 %9 - vendor/akeeba/engine/engine/Configuration.phpnu [ .
*/
namespace Akeeba\Engine;
defined('AKEEBAENGINE') || die();
use DirectoryIterator;
use stdClass;
/**
* The Akeeba Engine configuration registry class
*/
class Configuration
{
/**
* The currently loaded profile
*
* @var integer
*/
public $activeProfile = null;
/**
* Default namespace
*
* @var string
*/
private $defaultNameSpace = 'global';
/**
* Array keys which may contain stock directory definitions
*
* @var array
*/
private $directory_containing_keys = [
'akeeba.basic.output_directory',
];
/**
* Keys whose default values should never be overridden
*
* @var array
*/
private $protected_nodes = [];
/** The registry data
*
* @var array
*/
private $registry = [];
/**
* Constructor
*
* @return void
*/
public function __construct()
{
// Create the default namespace
$this->makeNameSpace($this->defaultNameSpace);
// Create a default configuration
$this->reset();
}
/**
* Create a namespace
*
* @param string $namespace Name of the namespace to create
*
* @return void
*/
public function makeNameSpace($namespace)
{
$this->registry[$namespace] = ['data' => new stdClass()];
}
/**
* Get the list of namespaces
*
* @return array List of namespaces
*/
public function getNameSpaces()
{
return array_keys($this->registry);
}
/**
* Get a registry value
*
* @param string $regpath Registry path (e.g. global.directory.temporary)
* @param mixed $default Optional default value
* @param boolean $process_special_vars Optional. If true (default), it processes special variables, e.g.
* [SITEROOT] in folder names
*
* @return mixed Value of entry or null
*/
public function get($regpath, $default = null, $process_special_vars = true)
{
// Cache the platform-specific stock directories
static $stock_directories = [];
if (empty($stock_directories))
{
$stock_directories = Platform::getInstance()->get_stock_directories();
}
$result = $default;
// Explode the registry path into an array
if ($nodes = explode('.', $regpath))
{
// Get the namespace
$count = count($nodes);
if ($count < 2)
{
$namespace = $this->defaultNameSpace;
$nodes[1] = $nodes[0];
}
else
{
$namespace = $nodes[0];
}
if (isset($this->registry[$namespace]))
{
$ns = $this->registry[$namespace]['data'];
$pathNodes = $count - 1;
for ($i = 1; $i < $pathNodes; $i++)
{
if ((isset($ns->{$nodes[$i]})))
{
$ns = $ns->{$nodes[$i]};
}
}
if (isset($ns->{$nodes[$i]}))
{
$result = $ns->{$nodes[$i]};
}
}
}
// Post-process certain directory-containing variables
if ($process_special_vars && in_array($regpath, $this->directory_containing_keys))
{
if (!empty($stock_directories))
{
foreach ($stock_directories as $tag => $content)
{
$result = str_replace($tag, $content, $result);
}
}
}
return $result;
}
/**
* Set a registry value
*
* @param string $regpath Registry Path (e.g. global.directory.temporary)
* @param mixed $value Value of entry
* @param bool $process_special_vars Optional. If true (default), it processes special variables, e.g.
* [SITEROOT] in folder names
*
* @return mixed Value of old value or boolean false if operation failed
*/
public function set($regpath, $value, $process_special_vars = true)
{
// Cache the platform-specific stock directories
static $stock_directories = [];
if (empty($stock_directories))
{
$stock_directories = Platform::getInstance()->get_stock_directories();
}
if (in_array($regpath, $this->protected_nodes))
{
return $this->get($regpath);
}
// Explode the registry path into an array
$nodes = explode('.', $regpath);
// Get the namespace
$count = count($nodes);
if ($count < 2)
{
$namespace = $this->defaultNameSpace;
}
else
{
$namespace = array_shift($nodes);
$count--;
}
if (!isset($this->registry[$namespace]))
{
$this->makeNameSpace($namespace);
}
$ns = $this->registry[$namespace]['data'];
$pathNodes = $count - 1;
if ($pathNodes < 0)
{
$pathNodes = 0;
}
for ($i = 0; $i < $pathNodes; $i++)
{
// If any node along the registry path does not exist, or is not an object, create it
if (!isset($ns->{$nodes[$i]}) || !is_object($ns->{$nodes[$i]}))
{
$ns->{$nodes[$i]} = new stdClass();
}
$ns = $ns->{$nodes[$i]};
}
// Set the new values
if (is_string($value))
{
if (substr($value, 0, 10) == '###json###')
{
$value = json_decode(substr($value, 10));
}
}
// Post-process certain directory-containing variables
if ($process_special_vars && in_array($regpath, $this->directory_containing_keys))
{
if (!empty($stock_directories))
{
$data = $value;
foreach ($stock_directories as $tag => $content)
{
$data = str_replace($tag, $content, $data);
}
$ns->{$nodes[$i]} = $data;
return $ns->{$nodes[$i]};
}
}
// This is executed if any of the previous two if's is false
if (empty($nodes[$i]))
{
return false;
}
$ns->{$nodes[$i]} = $value;
return $ns->{$nodes[$i]};
}
/**
* Unset (remove) a registry value
*
* @param string $regpath Registry Path (e.g. global.directory.temporary)
*
* @return boolean True if the node was removed
*/
public function remove($regpath)
{
// Explode the registry path into an array
$nodes = explode('.', $regpath);
// Get the namespace
$count = count($nodes);
if ($count < 2)
{
$namespace = $this->defaultNameSpace;
}
else
{
$namespace = array_shift($nodes);
$count--;
}
if (!isset($this->registry[$namespace]))
{
$this->makeNameSpace($namespace);
}
$ns = $this->registry[$namespace]['data'];
$pathNodes = $count - 1;
if ($pathNodes < 0)
{
$pathNodes = 0;
}
for ($i = 0; $i < $pathNodes; $i++)
{
// If any node along the registry path does not exist, return false
if (!isset($ns->{$nodes[$i]}))
{
return false;
}
$ns = $ns->{$nodes[$i]};
}
unset($ns->{$nodes[$i]});
return true;
}
/**
* Resets the registry to the default values
*/
public function reset()
{
// Load the Akeeba Engine INI files
$root_path = __DIR__;
$paths = [
$root_path . '/Core',
$root_path . '/Archiver',
$root_path . '/Dump',
$root_path . '/Scan',
$root_path . '/Writer',
$root_path . '/Proc',
$root_path . '/Platform/Filter/Stack',
$root_path . '/Filter/Stack',
];
$platform_paths = Platform::getInstance()->getPlatformDirectories();
foreach ($platform_paths as $p)
{
$paths[] = $p . '/Filter/Stack';
$paths[] = $p . '/Config';
}
foreach ($paths as $root)
{
if (!(is_dir($root) || is_link($root)))
{
continue;
}
if (!is_readable($root))
{
continue;
}
$di = new DirectoryIterator($root);
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if (!$file->isFile())
{
continue;
}
if ($file->getExtension() == 'json')
{
$this->mergeEngineJSON($file->getRealPath());
}
}
}
}
/**
* Merges an associative array of key/value pairs into the registry.
* If noOverride is set, only non set or null values will be applied.
*
* @param array $array An associative array. Its keys are registry paths.
* @param bool $noOverride [optional] Do not override pre-set values.
* @param bool $process_special_vars Optional. If true (default), it processes special variables, e.g.
* [SITEROOT] in folder names
*/
public function mergeArray($array, $noOverride = false, $process_special_vars = true)
{
if (!$noOverride)
{
foreach ($array as $key => $value)
{
$this->set($key, $value, $process_special_vars);
}
}
else
{
foreach ($array as $key => $value)
{
if (is_null($this->get($key, null)))
{
$this->set($key, $value, $process_special_vars);
}
}
}
}
/**
* Merges a JSON file into the registry. Its top level keys are registry paths,
* child keys are appended to the section-defined paths and then set equal to the
* values. If noOverride is set, only non set or null values will be applied.
* Top level keys beginning with an underscore will be ignored.
*
* @param string $jsonPath The full path to the INI file to load
* @param boolean $noOverride [optional] Do not override pre-set values.
*
* @return boolean True on success
*/
public function mergeJSON($jsonPath, $noOverride = false)
{
if (!file_exists($jsonPath))
{
return false;
}
$rawData = file_get_contents($jsonPath);
$jsonData = empty($rawData) ? [] : json_decode($rawData, true);
foreach ($jsonData as $rootkey => $rootvalue)
{
if (!is_array($rootvalue))
{
if (!$noOverride)
{
$this->set($rootkey, $rootvalue);
}
elseif (is_null($this->get($rootkey, null)))
{
$this->set($rootkey, $rootvalue);
}
}
elseif (substr($rootkey, 0, 1) != '_')
{
foreach ($rootvalue as $key => $value)
{
if (!$noOverride)
{
$this->set($rootkey . '.' . $key, $value);
}
elseif (is_null($this->get($rootkey . '.' . $key, null)))
{
$this->set($rootkey . '.' . $key, $value);
}
}
}
}
return true;
}
/**
* Merges an engine JSON file to the configuration. Each top level key defines a full
* registry path (section.subsection.key). It searches each top level key for the
* child key named "default" and merges its value to the configuration. The other keys
* are simply ignored.
*
* @param string $jsonPath The absolute path to an JSON file
* @param bool $noOverride [optional] If true, values from the JSON file will not override the configuration
*
* @return boolean True on success
*/
public function mergeEngineJSON($jsonPath, $noOverride = false)
{
if (!file_exists($jsonPath))
{
return false;
}
$rawData = file_get_contents($jsonPath);
$jsonData = empty($rawData) ? [] : json_decode($rawData, true);
foreach ($jsonData ?? [] as $section => $nodes)
{
if (is_array($nodes))
{
if (substr($section, 0, 1) != '_')
{
// Is this a protected node?
$protected = false;
if (array_key_exists('protected', $nodes))
{
$protected = $nodes['protected'];
}
// If overrides are allowed, unprotect until we can set the value
if (!$noOverride)
{
if (in_array($section, $this->protected_nodes))
{
$pnk = array_search($section, $this->protected_nodes);
unset($this->protected_nodes[$pnk]);
}
}
if (array_key_exists('remove', $nodes))
{
// Remove a node if it has "remove" set
$this->remove($section);
}
elseif (isset($nodes['default']))
{
if (!$noOverride)
{
// Update the default value if No Override is set
$this->set($section, $nodes['default']);
}
elseif (is_null($this->get($section, null)))
{
// Set the default value if it does not exist
$this->set($section, $nodes['default']);
}
}
// Finally, if it's a protected node, enable the protection
if ($protected)
{
$this->protected_nodes[] = $section;
}
else
{
$idx = array_search($section, $this->protected_nodes);
if ($idx !== false)
{
unset($this->protected_nodes[$idx]);
}
}
}
}
}
return true;
}
/**
* Exports the current registry snapshot as a JSON-encoded object. Each namespace is a property of the top-level
* JSON object.
*
* @return string The JSON-encoded representation of the registry
*
* @since 6.4.1
*/
public function exportAsJSON()
{
$forJSON = [];
$namespaces = $this->getNameSpaces();
foreach ($namespaces as $namespace)
{
if ($namespace == 'volatile')
{
continue;
}
$forJSON[$namespace] = $this->registry[$namespace]['data'];
}
return json_encode($forJSON, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_FORCE_OBJECT | JSON_PRETTY_PRINT);
}
/**
* Sets the protection status for a specific configuration key
*
* @param string|array $node The node to protect/unprotect
* @param boolean $protect True to protect, false to unprotect
*
* @return void
*/
public function setKeyProtection($node, $protect = false)
{
if (is_array($node))
{
foreach ($node as $k)
{
$this->setKeyProtection($k, $protect);
}
}
elseif (is_string($node))
{
if (is_array($this->protected_nodes))
{
$protected = in_array($node, $this->protected_nodes);
}
else
{
$this->protected_nodes = [];
$protected = false;
}
if ($protect)
{
if (!$protected)
{
$this->protected_nodes[] = $node;
}
}
else
{
if ($protected)
{
$pnk = array_search($node, $this->protected_nodes);
unset($this->protected_nodes[$pnk]);
}
}
}
}
/**
* Returns a list of protected keys
*
* @return array
*/
public function getProtectedKeys()
{
return $this->protected_nodes;
}
/**
* Resets the protected keys
*
* @return void
*/
public function resetProtectedKeys()
{
$this->protected_nodes = [];
}
/**
* Sets the protected keys
*
* @param array $keys A list of keys to protect
*
* @return void
*/
public function setProtectedKeys($keys)
{
$this->protected_nodes = $keys;
}
}
PK \}q q ( vendor/akeeba/engine/engine/Platform.phpnu [ .
*/
namespace Akeeba\Engine;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Platform\Base;
use Akeeba\Engine\Platform\PlatformInterface;
use DirectoryIterator;
use Exception;
/**
* Platform abstraction. Manages the loading of platform connector objects and delegates calls to itself the them.
*
* @property string $tableNameProfiles The name of the table where backup profiles are stored
* @property string $tableNameStats The name of the table where backup records are stored
*
* @since 3.4
*/
class Platform
{
/** @var Base|null The currently loaded platform connector object instance */
protected static $platformConnectorInstance = null;
/** @var array A list of additional directories where platform classes can be found */
protected static $knownPlatformsDirectories = [];
/** @var Platform The currently loaded object instance of this class. WARNING: This is NOT the platform connector! */
protected static $instance = null;
/**
* Public class constructor
*
* @param string $platform Optional; platform name. Leave blank to auto-detect.
*
* @throws Exception When the platform cannot be loaded
*/
public function __construct($platform = null)
{
if (empty($platform) || is_null($platform))
{
$platform = static::detectPlatform();
}
if (empty($platform))
{
throw new Exception('Can not find a suitable Akeeba Engine platform for your site');
}
static::$platformConnectorInstance = static::loadPlatform($platform);
if (!is_object(static::$platformConnectorInstance))
{
throw new Exception("Can not load Akeeba Engine platform $platform");
}
}
/**
* Implements the Singleton pattern for this class
*
* @staticvar Platform $instance The static object instance
*
* @param string $platform Optional; platform name. Autodetect if blank.
*
* @return PlatformInterface
*/
public static function &getInstance($platform = null)
{
if (!is_object(static::$instance))
{
static::$instance = new Platform($platform);
}
return static::$instance;
}
/**
* Get a list of all directories where platform classes can be found
*
* @return array
*/
public static function getPlatformDirectories()
{
$defaultPath = [];
if (is_object(static::$platformConnectorInstance))
{
$defaultPath[] = __DIR__ . '/Platform/' . static::$platformConnectorInstance->platformName;
}
return array_merge(
static::$knownPlatformsDirectories,
$defaultPath
);
}
/**
* Lists available platforms
*
* @staticvar array $platforms Static cache of the available platforms
*
* @return array The list of available platforms
*/
static public function listPlatforms()
{
if (empty(static::$knownPlatformsDirectories))
{
$di = new DirectoryIterator(__DIR__ . '/Platform');
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if (!$file->isDir())
{
continue;
}
if ($file->isDot())
{
continue;
}
if ($file->getExtension() !== 'php')
{
continue;
}
$shortName = $file->getFilename();
$bareName = basename($shortName, '.php');
/**
* We never have dots in our filenames but some hosts will rename files similar to foo.1.php when their
* broken security scanners detect a false positive. This is our defence against that.
*/
if (strpos($bareName, '.') !== false)
{
continue;
}
static::$knownPlatformsDirectories[$shortName] = $file->getRealPath();
}
}
return static::$knownPlatformsDirectories;
}
/**
* Add a platform to the list of known platforms
*
* @param string $slug Short name of the platform
* @param string $platformDirectory The path where you can find it
*
* @return void
*/
public static function addPlatform($slug, $platformDirectory)
{
if (empty(static::$knownPlatformsDirectories))
{
static::listPlatforms();
static::$knownPlatformsDirectories[$slug] = $platformDirectory;
}
}
/**
* Auto-detect the suitable platform for this site
*
* @return string
*
* @throws Exception When no platform is detected
*/
protected static function detectPlatform()
{
$platforms = static::listPlatforms();
if (empty($platforms))
{
throw new Exception('No Akeeba Engine platform class found');
}
$bestPlatform = (object) [
'name' => null,
'priority' => 0,
];
foreach ($platforms as $platform => $path)
{
$o = static::loadPlatform($platform, $path);
if (is_null($o))
{
continue;
}
if ($o->isThisPlatform())
{
if ($o->priority > $bestPlatform->priority)
{
$bestPlatform->priority = $o->priority;
$bestPlatform->name = $platform;
}
}
}
return $bestPlatform->name;
}
/**
* Load a given platform and return the platform object
*
* @param string $platform Platform name
* @param string $path The path to laod the platform from (optional)
*
* @return Base
*/
protected static function &loadPlatform($platform, $path = null)
{
if (empty($path))
{
if (isset(static::$knownPlatformsDirectories[$platform]))
{
$path = static::$knownPlatformsDirectories[$platform];
}
}
if (empty($path))
{
$path = dirname(__FILE__) . '/' . $platform;
}
$classFile = $path . '/Platform.php';
$className = '\\Akeeba\\Engine\\Platform\\' . ucfirst($platform);
$null = null;
if (!file_exists($classFile))
{
return $null;
}
require_once($classFile);
if (!class_exists($className, false))
{
return $null;
}
$o = new $className;
return $o;
}
/**
* Magic method to proxy all calls to the loaded platform object
*
* @param string $name The name of the method to call
* @param array $arguments The arguments to pass
*
* @return mixed The result of the method being called
*
* @throws Exception When the platform isn't loaded or an non-existent method is called
*/
public function __call($name, array $arguments)
{
if (is_null(static::$platformConnectorInstance))
{
throw new Exception('Akeeba Engine platform is not loaded');
}
if (method_exists(static::$platformConnectorInstance, $name))
{
return static::$platformConnectorInstance->$name(...$arguments);
}
else
{
throw new Exception('Method ' . $name . ' not found in Akeeba Platform');
}
}
/**
* Magic getter for the properties of the loaded platform
*
* @param string $name The name of the property to get
*
* @return mixed The value of the property
*/
public function __get($name)
{
if (!isset(static::$platformConnectorInstance->$name) || !property_exists(static::$platformConnectorInstance, $name))
{
static::$platformConnectorInstance->$name = null;
user_error(__CLASS__ . ' does not support property ' . $name, E_NOTICE);
}
return static::$platformConnectorInstance->$name;
}
/**
* Magic setter for the properties of the loaded platform
*
* @param string $name The name of the property to set
* @param mixed $value The value of the property to set
*/
public function __set($name, $value)
{
if (isset(static::$platformConnectorInstance->$name) || property_exists(static::$platformConnectorInstance, $name))
{
static::$platformConnectorInstance->$name = $value;
}
else
{
static::$platformConnectorInstance->$name = null;
user_error(__CLASS__ . ' does not support property ' . $name, E_NOTICE);
}
}
}
PK \J.Bt Bt ' vendor/akeeba/engine/engine/Factory.phpnu [ .
*/
namespace Akeeba\Engine;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Core\Database;
use Akeeba\Engine\Core\Filters;
use Akeeba\Engine\Core\Kettenrad;
use Akeeba\Engine\Core\Timer;
use Akeeba\Engine\Driver\Base;
use Akeeba\Engine\Dump\Native;
use Akeeba\Engine\Postproc\PostProcInterface;
use Akeeba\Engine\Util\ConfigurationCheck;
use Akeeba\Engine\Util\Encrypt;
use Akeeba\Engine\Util\EngineParameters;
use Akeeba\Engine\Util\FactoryStorage;
use Akeeba\Engine\Util\FileLister;
use Akeeba\Engine\Util\FileSystem;
use Akeeba\Engine\Util\Logger;
use Akeeba\Engine\Util\PushMessagesInterface;
use Akeeba\Engine\Util\RandomValue;
use Akeeba\Engine\Util\SecureSettings;
use Akeeba\Engine\Util\Statistics;
use Akeeba\Engine\Util\TemporaryFiles;
use DateTime;
use DateTimeZone;
use Exception;
use RuntimeException;
// Try to kill errors display
if (function_exists('ini_set') && !defined('AKEEBADEBUG'))
{
ini_set('display_errors', false);
}
// Make sure the class autoloader is loaded
require_once __DIR__ . '/Autoloader.php';
/**
* The Akeeba Engine Factory class
*
* This class is responsible for instantiating all Akeeba Engine classes
*/
abstract class Factory
{
/**
* The absolute path to Akeeba Engine's installation
*
* @var string
*/
private static $root;
/**
* Partial class names of the loaded engines e.g. 'archiver' => 'Archiver\\Jpa'. Survives serialization.
*
* @var array
*/
private static $engineClassnames = [];
/**
* A list of instantiated objects which will persist after serialisation / unserialisation
*
* @var array
*/
private static $objectList = [];
/**
* A list of instantiated objects which will NOT persist after serialisation / unserialisation
*
* @var array
*/
private static $temporaryObjectList = [];
/**
* The class to use for push messages
*
* @since 9.3.1
* @var string
*/
private static $pushClassName = 'Util\\PushMessages';
/**
* Gets a serialized snapshot of the Factory for safekeeping (hibernate)
*
* @return string The serialized snapshot of the Factory
*/
public static function serialize(): string
{
// Call _onSerialize in all objects known to the factory
foreach (static::$objectList as $object)
{
if (method_exists($object, '_onSerialize'))
{
call_user_func([$object, '_onSerialize']);
}
}
// Serialise an array with all the engine information
$engineInfo = [
'root' => static::$root,
'objectList' => static::$objectList,
'engineClassnames' => static::$engineClassnames,
'pushClassname' => static::$pushClassName,
];
// Serialize the factory
return base64_encode(serialize($engineInfo));
}
/**
* Regenerates the full Factory state from a serialized snapshot (resume)
*
* @param string $serializedData The serialized snapshot to resume from
*
* @return void
*/
public static function unserialize(string $serializedData): void
{
static::nuke();
$engineInfo = unserialize(base64_decode($serializedData));
static::$root = $engineInfo['root'] ?? '';
static::$objectList = $engineInfo['objectList'] ?? [];
static::$engineClassnames = $engineInfo['engineClassnames'] ?? [];
static::$pushClassName = $engineInfo['pushClassname'] ?? 'Utils\\PushMessages';
static::$temporaryObjectList = [];
}
/**
* Reset the internal factory state, freeing all previously created objects
*
* @return void
*/
public static function nuke()
{
foreach (static::$objectList as &$object)
{
$object = null;
}
foreach (static::$temporaryObjectList as &$object)
{
$object = null;
}
static::$objectList = [];
static::$temporaryObjectList = [];
}
/**
* Saves the engine state to temporary storage
*
* @param string|null $tag The backup origin to save. Leave empty to get from already loaded Kettenrad
* instance.
* @param string|null $backupId The backup ID to save. Leave empty to get from already loaded Kettenrad
* instance.
*
* @return void
*
* @throws RuntimeException When the state save fails for any reason
* @noinspection PhpUnused
*/
public static function saveState(?string $tag = null, ?string $backupId = null): void
{
$kettenrad = static::getKettenrad();
$tag = $tag ?: $kettenrad->getTag();
$backupId = $backupId ?: $kettenrad->getBackupId();
$saveTag = rtrim($tag . '.' . ($backupId ?: ''), '.');
$ret = $kettenrad->getStatusArray();
if ($ret['HasRun'] == 1)
{
Factory::getLog()->debug("Will not save a finished Kettenrad instance");
return;
}
Factory::getLog()->debug("Saving Kettenrad instance $tag");
// Save a Factory snapshot
$factoryStorage = static::getFactoryStorage();
$logger = static::getLog();
$logger->resetWarnings();
$serializedFactoryData = static::serialize();
$memoryFileExtension = 'php';
$result = $factoryStorage->set($serializedFactoryData, $saveTag, $memoryFileExtension);
/**
* Some hosts, such as WPEngine, do not allow us to save the memory files in .php files. In this case we use the
* far more insecure .dat extension.
*/
if ($result === false)
{
$memoryFileExtension = 'dat';
$result = $factoryStorage->set($serializedFactoryData, $saveTag, $memoryFileExtension);
}
if ($result === false)
{
$saveKey = $factoryStorage->get_storage_filename($saveTag, $memoryFileExtension);
$errorMessage = "Cannot save factory state in storage, storage filename $saveKey";
$logger->error($errorMessage);
throw new RuntimeException($errorMessage);
}
}
/**
* Loads the engine state from the storage (if it exists).
*
* When failIfMissing is true (default) an exception will be thrown if the memory file / database record is no
* longer there. This is a clear indication of an issue with the storage engine, e.g. the host deleting the memory
* files in the middle of the backup step. Therefore, we'll switch the storage engine type before throwing the
* exception.
*
* When failIfMissing is false we do NOT throw an exception. Instead, we do a hard reset of the backup factory. This
* is required by the resetState method when we ask it to reset multiple origins at once.
*
* @param string|null $tag The backup origin to load
* @param string|null $backupId The backup ID to load
* @param bool $failIfMissing Throw an exception if the memory data is no longer there
*
* @return void
*/
public static function loadState(?string $tag = null, ?string $backupId = null, bool $failIfMissing = true): void
{
/** @noinspection PhpUndefinedConstantInspection */
$tag = $tag ?: (defined('AKEEBA_BACKUP_ORIGIN') ? AKEEBA_BACKUP_ORIGIN : 'backend');
$loadTag = rtrim($tag . '.' . ($backupId ?: ''), '.');
// In order to load anything, we need to have the correct profile loaded. Let's assume
// that the latest backup record in this tag has the correct profile number set.
$config = static::getConfiguration();
if (empty($config->activeProfile))
{
$profile = Platform::getInstance()->get_active_profile();
if (empty($profile) || ($profile <= 1))
{
// Only bother loading a configuration if none has been already loaded
$filters = [
['field' => 'tag', 'value' => $tag],
];
if (!empty($backupId))
{
$filters[] = ['field' => 'backupid', 'value' => $backupId];
}
$statList = Platform::getInstance()->get_statistics_list([
'filters' => $filters, 'order' => [
'by' => 'id', 'order' => 'DESC',
],
]
);
if (is_array($statList))
{
$stat = array_pop($statList) ?? [];
$profile = $stat['profile_id'] ?? 1;
}
}
Platform::getInstance()->load_configuration($profile);
}
$profile = $config->activeProfile;
Factory::getLog()->open($loadTag);
Factory::getLog()->debug("Kettenrad :: Attempting to load from database ($tag) [$loadTag]");
$serializedFactory = static::getFactoryStorage()->get($loadTag);
if ($serializedFactory === null)
{
if ($failIfMissing)
{
throw new RuntimeException("Akeeba Engine detected a problem while saving temporary data. Please restart your backup.", 500);
}
// There is no serialized factory. Nuke the in-memory factory.
Factory::getLog()->debug(" -- Stored Akeeba Factory ($tag) [$loadTag] not found - hard reset");
static::nuke();
Platform::getInstance()->load_configuration($profile);
}
else
{
Factory::getLog()->debug(" -- Loaded stored Akeeba Factory ($tag) [$loadTag]");
static::unserialize($serializedFactory);
}
unset($serializedFactory);
}
// ========================================================================
// Public factory interface
// ========================================================================
/**
* Resets the engine state, wiping out any pending backups and/or stale temporary data.
*
* The configuration parameters are:
*
* * global `bool` True to reset all backups, regardless of the origin or profile ID
* * log `bool` True to log our actions (default: false)
* * maxrun `int` Only backup records older than this number of seconds will be reset (default: 180)
*
* Special considerations:
*
* * If global = true all backups from all origins are taken into account to determine which ones are stuck (over
* the maxrun threshold since their last database entry).
*
* * If global = false only backups from the current backup origin are taken into account.
*
* * If global = false AND the current origin is 'backend' all pending and idle backups with the 'backup' origin are
* considered stuck regardless of their age. In other words, maxrun is effectively set to 0. The idea is that only
* a single person, from a single browser, should be taking backend backups at a time. Resetting single origin
* backups is only ever meant to be called by the consumer when starting a backup.
*
* * Corollary to the above: starting a frontend, CLI or JSON API backup with the same backup profile DOES NOT reset
* a previously failed backup if the new backup starts less than 'maxrun' seconds since the last step of the
* failed backup started.
*
* * The time information for the backup age is taken from the database, namely the backupend field. If no time
* is recorded for the last step we use the backupstart field instead.
*
* @param array $config Configuration parameters for the reset operation
*
* @return void
* @throws Exception
* @noinspection PhpUnused
*/
public static function resetState(array $config = []): void
{
$defaultConfig = [
'global' => true,
'log' => false,
'maxrun' => 180,
];
$config = (object) array_merge($defaultConfig, $config);
// Pause logging if so desired
if (!$config->log)
{
Factory::getLog()->pause();
}
// Get the origin to clear, depending on the 'global' setting
$originTag = $config->global ? null : Platform::getInstance()->get_backup_origin();
// Cache the factory before proceeding
$factory = static::serialize();
// Get all running backups for the selected origin (or all origins, if global was false).
$runningList = Platform::getInstance()->get_running_backups($originTag);
// Sanity check
if (!is_array($runningList))
{
$runningList = [];
}
// If the current origin is 'backend' we assume maxrun = 0 per the method docblock notes.
$maxRun = ($originTag == 'backend') ? 0 : $config->maxrun;
// Filter out entries by backup age
$now = time();
$cutOff = $now - $maxRun;
$runningList = array_filter($runningList, function (array $running) use ($cutOff, $maxRun) {
// No cutoff time: include all currently running backup records
if ($maxRun == 0)
{
return true;
}
// Try to get the last backup tick timestamp
try
{
$backupTickTime = !empty($running['backupend']) ? $running['backupend'] : $running['backupstart'];
$tz = new DateTimeZone('UTC');
$tstamp = (new DateTime($backupTickTime, $tz))->getTimestamp();
}
catch (Exception $e)
{
$tstamp = Factory::getLog()->getLastTimestamp($running['origin']);
}
if (is_null($tstamp))
{
return false;
}
// Only include still running backups whose last tick was BEFORE the cutoff time
return $tstamp <= $cutOff;
});
// Mark running backups as failed
foreach ($runningList as $running)
{
// Delete the failed backup's leftover archive parts
$filenames = Factory::getStatistics()->get_all_filenames($running, false);
$filenames = is_null($filenames) ? [] : $filenames;
$totalSize = 0;
foreach ($filenames as $failedArchive)
{
if (!@file_exists($failedArchive))
{
continue;
}
$totalSize += (int) @filesize($failedArchive);
Platform::getInstance()->unlink($failedArchive);
}
// Mark the backup failed
$running['status'] = 'fail';
$running['instep'] = 0;
$running['total_size'] = empty($running['total_size']) ? $totalSize : $running['total_size'];
$running['multipart'] = 0;
Platform::getInstance()->set_or_update_statistics($running['id'], $running);
// Remove the temporary data
$backupId = isset($running['backupid']) ? ('.' . $running['backupid']) : '';
self::removeTemporaryData($running['origin'] . $backupId);
}
// Reload the factory
static::unserialize($factory);
unset($factory);
// Unpause logging if it was previously paused
if (!$config->log)
{
Factory::getLog()->unpause();
}
}
/**
* Returns an Akeeba Configuration object
*
* @return Configuration The Akeeba Configuration object
*/
public static function getConfiguration(): Configuration
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance(Configuration::class);
}
/**
* Returns a statistics object, used to track current backup's progress
*
* @return Statistics
*/
public static function getStatistics(): Statistics
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance(Statistics::class);
}
/**
* Returns the currently configured archiver engine
*
* @param bool $reset Should I try to forcibly create a new instance?
*
* @return Archiver\Base|null
*/
public static function getArchiverEngine(bool $reset = false): ?Archiver\Base
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getEngineInstance(
'archiver', 'akeeba.advanced.archiver_engine',
'Archiver\\', 'Archiver\\Jpa',
$reset
);
}
/**
* Returns the currently configured dump engine
*
* @param boolean $reset Should I try to forcibly create a new instance?
*
* @return Dump\Base|Native|null
*/
public static function getDumpEngine(bool $reset = false): ?object
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getEngineInstance(
'dump', 'akeeba.advanced.dump_engine',
'Dump\\', 'Dump\\Native',
$reset
);
}
/**
* Returns the filesystem scanner engine instance
*
* @param bool $reset Should I try to forcibly create a new instance?
*
* @return Scan\Base|null The scanner engine
*/
public static function getScanEngine(bool $reset = false): ?Scan\Base
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getEngineInstance(
'scan', 'akeeba.advanced.scan_engine',
'Scan\\', 'Scan\\Large',
$reset
);
}
/**
* Returns the current post-processing engine. If no class is specified we
* return the post-processing engine configured in akeeba.advanced.postproc_engine
*
* @param string|null $engine The name of the post-processing class to forcibly return
*
* @return PostProcInterface|null
*/
public static function getPostprocEngine(?string $engine = null): ?PostProcInterface
{
if (!is_null($engine))
{
static::$engineClassnames['postproc'] = 'Postproc\\' . ucfirst($engine);
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance(static::$engineClassnames['postproc']);
}
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getEngineInstance(
'postproc', 'akeeba.advanced.postproc_engine',
'Postproc\\', 'Postproc\\None',
true
);
}
// ========================================================================
// Core objects which are part of the engine state
// ========================================================================
/**
* Returns an instance of the Filters feature class
*
* @return Filters The Filters feature class' object instance
*/
public static function getFilters(): Filters
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance(Filters::class);
}
/**
* Returns an instance of the specified filter group class. Do note that it does not
* work with platform filter classes. They are handled internally by AECoreFilters.
*
* @param string $filter_name The filter class to load, without AEFilter prefix
*
* @return Filter\Base|null The filter class' object instance
*/
public static function getFilterObject(string $filter_name): ?Filter\Base
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance('Filter\\' . ucfirst($filter_name));
}
/**
* Loads an engine domain class and returns its associated object
*
* @param string $domainName The name of the domain, e.g. installer for AECoreDomainInstaller
*
* @return Part|null
*/
public static function getDomainObject(string $domainName): ?Part
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance('Core\\Domain\\' . ucfirst($domainName));
}
/**
* Returns a database connection object. It's an alias of AECoreDatabase::getDatabase()
*
* !!! IMPORTANT !!!
* DO NOT STATIC TYPE THIS METHOD.
*
* Akeeba Backup for Joomla is using a decorator to the Joomla DB object which makes use of the magic __call method
* to proxy driver calls. As a result it cannot adhere to an object declaration or interface. Until this is
* refactored we have to keep this method untyped.
*
* @param array|null $options Options to use when instantiating the database connection
*
* @return Base
*/
public static function getDatabase(?array $options = null)
{
if (is_null($options))
{
$options = Platform::getInstance()->get_platform_database_options();
}
if (isset($options['username']) && !isset($options['user']))
{
$options['user'] = $options['username'];
}
return Database::getDatabase($options);
}
/**
* Returns a database connection object. It's an alias of AECoreDatabase::getDatabase()
*
* @param array|null $options Options to use when instantiating the database connection
*
* @return void
*/
public static function unsetDatabase(?array $options = null): void
{
if (is_null($options))
{
$options = Platform::getInstance()->get_platform_database_options();
}
$db = Database::getDatabase($options);
$db->close();
Database::unsetDatabase($options);
}
/**
* Get a reference to the Akeeba Engine's timer
*
* @return Timer
*/
public static function getTimer(): Timer
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance(Timer::class);
}
/**
* Get a reference to Akeeba Engine's main controller called Kettenrad
*
* @return Kettenrad
*/
public static function getKettenrad(): Kettenrad
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance(Kettenrad::class);
}
/**
* Returns an instance of the factory temporary storage class
*
* @return FactoryStorage
*/
public static function getFactoryStorage(): FactoryStorage
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(FactoryStorage::class);
}
/**
* Returns an instance of the encryption class
*
* @return Encrypt
*/
public static function getEncryption(): Encrypt
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(Encrypt::class);
}
/**
* Returns an instance of the crypto-safe random value generator class
*
* @return RandomValue
*/
public static function getRandval(): RandomValue
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(RandomValue::class);
}
/**
* Returns an instance of the filesystem tools class
*
* @return FileSystem
*/
public static function getFilesystemTools(): FileSystem
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(FileSystem::class);
}
/**
* Returns an instance of the filesystem tools class
*
* @return FileLister
* @noinspection PhpUnused
*/
public static function getFileLister(): FileLister
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(FileLister::class);
}
// ========================================================================
// Temporary objects which are not part of the engine state
// ========================================================================
/**
* Returns an instance of the engine parameters provider which provides information on scripting, GUI configuration
* elements and engine parts
*
* @return EngineParameters
*/
public static function getEngineParamsProvider(): EngineParameters
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(EngineParameters::class);
}
/**
* Returns an instance of the log object
*
* @return Logger
*/
public static function getLog(): Logger
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(Logger::class);
}
/**
* Returns an instance of the configuration checks object
*
* @return ConfigurationCheck
*/
public static function getConfigurationChecks(): ConfigurationCheck
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(ConfigurationCheck::class);
}
/**
* Returns an instance of the secure settings handling object
*
* @return SecureSettings
*/
public static function getSecureSettings(): SecureSettings
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(SecureSettings::class);
}
/**
* Returns an instance of the secure settings handling object
*
* @return TemporaryFiles
*/
public static function getTempFiles(): TemporaryFiles
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getTempObjectInstance(TemporaryFiles::class);
}
/**
* Get the connector object for push messages
*
* !!! WARNING !!! DO NOT STATIC TYPE
*
* The object type may change using setPushClass.
*
* @return PushMessagesInterface
*/
public static function getPush()
{
/** @noinspection PhpIncompatibleReturnTypeInspection */
return static::getObjectInstance(self::$pushClassName);
}
/**
* Set the push notifications helper class to use with this factory
*
* @param string $className The classname to use
*
* @since 9.3.1
* @noinspection PhpUnused
*/
public static function setPushClass(string $className): void
{
self::$pushClassName = $className;
}
/**
* Returns the absolute path to Akeeba Engine's installation
*
* @return string
*/
public static function getAkeebaRoot(): string
{
if (empty(static::$root))
{
static::$root = __DIR__;
}
return static::$root;
}
/**
* @param string $engineType Engine type, e.g. 'archiver', 'postproc', ...
* @param string $configKey Profile config key with configured engine e.g. 'akeeba.advanced.archiver_engine'
* @param string $prefix Prefix for engine classes, e.g. 'Archiver\\'
* @param string $fallback Fallback class if the configured one doesn't exist e.g. 'Archiver\\Jpa'. Empty for
* no fallback.
* @param bool $reset Should I force-reload the engine? Default: false.
*
* @return object|null The Singleton engine object instance
*/
protected static function getEngineInstance(string $engineType, string $configKey, string $prefix, string $fallback, bool $reset = false): ?object
{
if (!$reset && !empty(static::$engineClassnames[$engineType]))
{
return static::getObjectInstance(static::$engineClassnames[$engineType]);
}
// Unset the existing engine object
if (!empty(static::$engineClassnames[$engineType]))
{
static::unsetObjectInstance(static::$engineClassnames[$engineType]);
}
// Get the engine name from the backup profile, construct a class name and check if it exists
$registry = static::getConfiguration();
$engine = $registry->get($configKey);
static::$engineClassnames[$engineType] = $prefix . ucfirst($engine);
$object = static::getObjectInstance(static::$engineClassnames[$engineType]);
// If the engine object does not exist, fall back to the default
if (!empty($fallback) && !is_object($object))
{
static::unsetObjectInstance(static::$engineClassnames[$engineType]);
static::$engineClassnames[$engineType] = $fallback;
}
return static::getObjectInstance(static::$engineClassnames[$engineType]);
}
/**
* Internal function which instantiates an object of a class named $class_name.
*
* @param string $className
*
* @return object|null
*/
protected static function getObjectInstance(string $className): ?object
{
$className = trim($className, '\\');
if (substr($className, 0, 14) === 'Akeeba\\Engine\\')
{
$searchClass = $className;
$className = substr($className, 14);
}
else
{
$searchClass = '\\Akeeba\\Engine\\' . $className;
}
if (isset(static::$objectList[$className]))
{
return static::$objectList[$className];
}
static::$objectList[$className] = null;
if (class_exists($searchClass))
{
static::$objectList[$className] = new $searchClass;
}
elseif (class_exists($className))
{
static::$objectList[$className] = new $className;
}
return static::$objectList[$className];
}
// ========================================================================
// Handy functions
// ========================================================================
/**
* Internal function which removes the object of the class named $class_name
*
* @param string $className
*
* @return void
*/
protected static function unsetObjectInstance(string $className): void
{
if (substr($className, 0, 14) === 'Akeeba\\Engine\\')
{
$className = substr($className, 14);
}
if (isset(static::$objectList[$className]))
{
static::$objectList[$className] = null;
unset(static::$objectList[$className]);
}
}
/**
* Internal function which instantiates an object of a class named $class_name. This is a temporary instance which
* will not survive serialisation and subsequent unserialisation.
*
* @param string $className
*
* @return object|null
*/
protected static function getTempObjectInstance(string $className): ?object
{
$className = trim($className, '\\');
if (substr($className, 0, 14) === 'Akeeba\\Engine\\')
{
$searchClass = $className;
$className = substr($className, 14);
}
else
{
$searchClass = '\\Akeeba\\Engine\\' . $className;
}
if (!isset(static::$temporaryObjectList[$className]))
{
static::$temporaryObjectList[$className] = null;
if (class_exists($searchClass))
{
static::$temporaryObjectList[$className] = new $searchClass;
}
}
return static::$temporaryObjectList[$className];
}
/**
* Remote the temporary data for a specific backup tag.
*
* @param string $originTag The backup tag to reset e.g. 'backend.id123' or 'frontend'.
*
* @return void
*/
protected static function removeTemporaryData(string $originTag): void
{
static::loadState($originTag, null, false);
// Remove temporary files
Factory::getTempFiles()->deleteTempFiles();
// Delete any stale temporary data
static::getFactoryStorage()->reset($originTag);
}
}
/**
* Timeout handler. It is registered as a global PHP shutdown function.
*
* If a PHP reports a timeout we will log this before letting PHP kill us.
*/
function AkeebaTimeoutTrap(): void
{
if (connection_status() >= 2)
{
Factory::getLog()->error('Akeeba Engine has timed out');
}
}
register_shutdown_function("\\Akeeba\\Engine\\AkeebaTimeoutTrap");
PK \ ?I I / vendor/akeeba/engine/engine/Driver/Pdomysql.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Pdomysql as QueryPdomysql;
use Akeeba\Engine\FixMySQLHostname;
use Exception;
use PDO;
use PDOException;
use PDOStatement;
use ReflectionClass;
use RuntimeException;
/**
* PDO MySQL database driver for Akeeba Engine
*
* Based on Joomla! Platform 12.1
*/
#[\AllowDynamicProperties]
class Pdomysql extends Mysql
{
use FixMySQLHostname;
/**
* The default cipher suite for TLS connections.
*
* @var array
*/
protected static $defaultCipherSuite = [
'AES128-GCM-SHA256',
'AES256-GCM-SHA384',
'AES128-CBC-SHA256',
'AES256-CBC-SHA384',
'DES-CBC3-SHA',
];
/**
* The name of the database driver.
*
* @var string
*/
public $name = 'pdomysql';
/** @var string Connection character set */
protected $charset = 'utf8mb4';
/** @var PDO The db connection resource */
protected $connection = null;
/** @var PDOStatement The database connection cursor from the last query. */
protected $cursor;
/** @var array Driver options for PDO */
protected $driverOptions = [];
protected $ssl = [];
/** @var bool Are we in the process of reconnecting to the database server? */
private $isReconnecting = false;
/**
* Database object constructor
*
* @param array $options List of options used to configure the connection
*/
public function __construct($options)
{
$this->driverType = 'mysql';
// Init
$this->nameQuote = '`';
$options['ssl'] = $options['ssl'] ?? [];
$options['ssl'] = is_array($options['ssl']) ? $options['ssl'] : [];
$options['ssl']['enable'] =
($options['ssl']['enable'] ?? $options['dbencryption'] ?? false) ?: false;
$options['ssl']['cipher'] = ($options['ssl']['cipher'] ?? $options['dbsslcipher'] ?? null) ?: null;
$options['ssl']['ca'] = ($options['ssl']['ca'] ?? $options['dbsslca'] ?? null) ?: null;
$options['ssl']['capath'] = ($options['ssl']['capath'] ?? $options['dbsslcapath'] ?? null) ?: null;
$options['ssl']['key'] = ($options['ssl']['key'] ?? $options['dbsslkey'] ?? null) ?: null;
$options['ssl']['cert'] = ($options['ssl']['cert'] ?? $options['dbsslcert'] ?? null) ?: null;
$options['ssl']['verify_server_cert'] =
($options['ssl']['verify_server_cert'] ?? $options['dbsslverifyservercert'] ?? false) ?: false;
// Figure out if a port is included in the host name
$this->fixHostnamePortSocket($options['host'], $options['port'], $options['socket']);
// Open the connection
$this->host = $options['host'] ?? 'localhost';
$this->user = $options['user'] ?? '';
$this->password = $options['password'] ?? '';
$this->port = $options['port'] ?? '';
$this->socket = $options['socket'] ?? '';
$this->_database = $options['database'] ?? '';
$this->selectDatabase = $options['select'] ?? true;
$this->ssl = $options['ssl'] ?? [];
$this->charset = $options['charset'] ?? 'utf8mb4';
$this->driverOptions = $options['driverOptions'] ?? [];
$this->tablePrefix = $options['prefix'] ?? '';
$this->connection = $options['connection'] ?? null;
$this->errorNum = 0;
$this->count = 0;
$this->log = [];
$this->options = $options;
if (!is_object($this->connection))
{
$this->open();
}
}
/**
* Test to see if the MySQL connector is available.
*
* @return boolean True on success, false otherwise.
*/
public static function isSupported()
{
if (!defined('\PDO::ATTR_DRIVER_NAME'))
{
return false;
}
return in_array('mysql', PDO::getAvailableDrivers());
}
/**
* PDO does not support serialize
*
* @return array
*/
public function __sleep()
{
$serializedProperties = [];
$reflect = new ReflectionClass($this);
// Get properties of the current class
$properties = $reflect->getProperties();
foreach ($properties as $property)
{
// Do not serialize properties that are \PDO
if ($property->isStatic() == false && !($this->{$property->name} instanceof PDO))
{
array_push($serializedProperties, $property->name);
}
}
return $serializedProperties;
}
/**
* Wake up after serialization
*
* @return array
*/
public function __wakeup()
{
// Get connection back
$this->__construct($this->options);
}
public function close()
{
$return = false;
if (is_object($this->cursor))
{
try
{
$this->cursor->closeCursor();
}
catch (\Throwable $e)
{
}
}
$this->connection = null;
return $return;
}
/**
* Determines if the connection to the server is active.
*
* @return boolean True if connected to the database engine.
*/
public function connected()
{
if (!is_object($this->connection))
{
return false;
}
try
{
/** @var PDOStatement $statement */
$statement = $this->connection->prepare('SELECT 1');
$executed = $statement->execute();
$ret = 0;
if ($executed)
{
$row = [0];
if (!empty($statement) && $statement instanceof PDOStatement)
{
$row = $statement->fetch(PDO::FETCH_NUM);
}
$ret = $row[0];
}
$status = $ret == 1;
$statement->closeCursor();
$statement = null;
}
// If we catch an exception here, we must not be connected.
catch (\Throwable $e)
{
$status = false;
}
return $status;
}
/**
* Method to escape a string for usage in an SQL statement.
*
* @param string $text The string to be escaped.
* @param boolean $extra Optional parameter to provide extra escaping.
*
* @return string The escaped string.
*/
public function escape($text, $extra = false)
{
if (is_int($text) || is_float($text))
{
return $text;
}
if (is_null($text))
{
return 'NULL';
}
$result = substr($this->connection->quote($text), 1, -1);
if ($extra)
{
$result = addcslashes($result, '%_');
}
return $result;
}
/**
* Method to fetch a row from the result set cursor as an associative array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
public function fetchAssoc($cursor = null)
{
$ret = null;
if (!empty($cursor) && $cursor instanceof PDOStatement)
{
$ret = $cursor->fetch(PDO::FETCH_ASSOC);
}
elseif ($this->cursor instanceof PDOStatement)
{
$ret = $this->cursor->fetch(PDO::FETCH_ASSOC);
}
return $ret;
}
/**
* Method to free up the memory used for the result set.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return void
*/
public function freeResult($cursor = null)
{
if ($cursor instanceof PDOStatement)
{
$cursor->closeCursor();
$cursor = null;
}
if ($this->cursor instanceof PDOStatement)
{
$this->cursor->closeCursor();
$this->cursor = null;
}
}
/**
* Get the number of affected rows for the previous executed SQL statement.
*
* @return integer The number of affected rows.
*/
public function getAffectedRows()
{
if ($this->cursor instanceof PDOStatement)
{
return $this->cursor->rowCount();
}
return 0;
}
/**
* Get the number of returned rows for the previous executed SQL statement.
*
* @param resource $cursor An optional database cursor resource to extract the row count from.
*
* @return integer The number of returned rows.
*/
public function getNumRows($cursor = null)
{
if ($cursor instanceof PDOStatement)
{
return $cursor->rowCount();
}
if ($this->cursor instanceof PDOStatement)
{
return $this->cursor->rowCount();
}
return 0;
}
/**
* Get the current or query, or new JDatabaseQuery object.
*
* @param boolean $new False to return the last query set, True to return a new JDatabaseQuery object.
*
* @return mixed The current value of the internal SQL variable or a new JDatabaseQuery object.
*/
public function getQuery($new = false)
{
if ($new)
{
return new QueryPdomysql($this);
}
else
{
return $this->sql;
}
}
public function createQuery()
{
return new QueryPdomysql($this);
}
/**
* Get the version of the database connector.
*
* @return string The database connector version.
*/
public function getVersion()
{
$version = $this->connection->getAttribute(\PDO::ATTR_SERVER_VERSION);
if (stripos($version, 'mariadb') !== false)
{
// MariaDB: Strip off any leading '5.5.5-', if present
return preg_replace('/^5\.5\.5-/', '', $version);
}
return $version;
}
/**
* Determines if the database engine supports UTF-8 character encoding.
*
* @return boolean True if supported.
*/
public function hasUTF()
{
$serverVersion = $this->getVersion();
$mariadb = stripos($serverVersion, 'mariadb') !== false;
// At this point we know the client supports utf8mb4. Now we must check if the server supports utf8mb4 as well.
$utf8mb4 = version_compare($serverVersion, '5.5.3', '>=');
if ($mariadb && version_compare($serverVersion, '10.0.0', '<'))
{
$utf8mb4 = false;
}
return $utf8mb4;
}
/**
* Method to get the auto-incremented value from the last INSERT statement.
*
* @return integer The value of the auto-increment field from the last inserted row.
*/
public function insertid()
{
// Error suppress this to prevent PDO warning us that the driver doesn't support this operation.
return @$this->connection->lastInsertId();
}
/**
* Method to get the next row in the result set from the database query as an object.
*
* @param string $class The class name to use for the returned row object.
*
* @return mixed The result of the query as an array, false if there are no more rows.
*/
public function loadNextObject($class = 'stdClass')
{
// Execute the query and get the result set cursor.
if (!$this->cursor)
{
if (!($this->execute()))
{
return $this->errorNum ? null : false;
}
}
// Get the next row from the result set as an object of type $class.
if ($row = $this->fetchObject(null, $class))
{
return $row;
}
// Free up system resources and return.
$this->freeResult();
return false;
}
/**
* Method to get the next row in the result set from the database query as an array.
*
* @return mixed The result of the query as an array, false if there are no more rows.
*/
public function loadNextRow()
{
// Execute the query and get the result set cursor.
if (!$this->cursor)
{
if (!($this->execute()))
{
return $this->errorNum ? null : false;
}
}
// Get the next row from the result set as an object of type $class.
if ($row = $this->fetchArray())
{
return $row;
}
// Free up system resources and return.
$this->freeResult();
return false;
}
public function open()
{
if ($this->connected())
{
return;
}
else
{
$this->close();
}
if (!isset($this->charset))
{
$this->charset = 'utf8mb4';
}
$this->port = $this->port ?: 3306;
$format = 'mysql:host=#HOST#;port=#PORT#;dbname=#DBNAME#;charset=#CHARSET#';
if ($this->socket)
{
$format = 'mysql:socket=#SOCKET#;dbname=#DBNAME#;charset=#CHARSET#';
}
$replace = ['#HOST#', '#PORT#', '#SOCKET#', '#DBNAME#', '#CHARSET#'];
$with = [$this->host, $this->port, $this->socket, $this->_database, $this->charset];
// Create the connection string:
$connectionString = str_replace($replace, $with, $format);
// For SSL/TLS connection encryption.
if ($this->ssl !== [] && $this->ssl['enable'] === true)
{
$sslContextIsNull = true;
// If customised, add cipher suite, ca file path, ca path, private key file path and certificate file path to PDO driver options.
foreach (['cipher', 'ca', 'capath', 'key', 'cert'] as $key => $value)
{
if ($this->ssl[$value] !== null)
{
$this->driverOptions[constant('\PDO::MYSQL_ATTR_SSL_' . strtoupper($value))] = $this->ssl[$value];
$sslContextIsNull = false;
}
}
// PDO, if no cipher, ca, capath, cert and key are set, can't start TLS one-way connection, set a common ciphers suite to force it.
if ($sslContextIsNull === true)
{
$this->driverOptions[\PDO::MYSQL_ATTR_SSL_CIPHER] = implode(':', static::$defaultCipherSuite);
}
// If customised, for capable systems (PHP 7.0.14+ and 7.1.4+) verify certificate chain and Common Name to driver options.
if ($this->ssl['verify_server_cert'] !== null && defined('\PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT'))
{
$this->driverOptions[\PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT] = $this->ssl['verify_server_cert'];
}
}
// connect to the server
try
{
$this->connection = new PDO(
$connectionString,
$this->user,
$this->password,
$this->driverOptions
);
}
catch (PDOException $e)
{
// If we tried connecting through utf8mb4 and we failed let's retry with regular utf8
if ($this->charset == 'utf8mb4')
{
$this->charset = 'UTF8';
$this->open();
return;
}
$this->errorNum = 2;
$this->errorMsg = 'Could not connect to MySQL via PDO: ' . $e->getMessage();
return;
}
// Reset the SQL mode of the connection
try
{
$this->connection->exec("SET @@SESSION.sql_mode = '';");
}
// Ignore any exceptions (incompatible MySQL versions)
catch (Exception $e)
{
}
$this->connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$this->connection->setAttribute(PDO::ATTR_EMULATE_PREPARES, true);
if ($this->selectDatabase && !empty($this->_database))
{
$this->select($this->_database);
}
$this->freeResult();
}
/**
* Execute the SQL statement.
*
* @return mixed A database cursor resource on success, boolean false on failure.
*/
public function query()
{
if (!is_object($this->connection))
{
$this->open();
}
$this->freeResult();
// Take a local copy so that we don't modify the original query and cause issues later
$query = $this->replacePrefix((string)$this->sql);
if ($this->limit > 0 || $this->offset > 0)
{
$query .= ' LIMIT ' . $this->offset . ', ' . $this->limit;
}
// Increment the query counter.
$this->count++;
// If debugging is enabled then let's log the query.
if ($this->debug)
{
// Add the query to the object queue.
$this->log[] = $query;
}
// Reset the error values.
$this->errorNum = 0;
$this->errorMsg = '';
// Execute the query. Error suppression is used here to prevent warnings/notices that the connection has been lost.
try
{
$this->cursor = $this->connection->query($query);
}
catch (Exception $e)
{
}
// If an error occurred handle it.
if (!$this->cursor)
{
$errorInfo = $this->connection->errorInfo();
$this->errorNum = $errorInfo[1];
$this->errorMsg = $errorInfo[2] . ' SQL=' . $query;
// Check if the server was disconnected.
if (!$this->connected() && !$this->isReconnecting)
{
$this->isReconnecting = true;
try
{
// Attempt to reconnect.
$this->connection = null;
$this->open();
}
// If connect fails, ignore that exception and throw the normal exception.
catch (RuntimeException $e)
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
// Since we were able to reconnect, run the query again.
$result = $this->query();
$this->isReconnecting = false;
return $result;
}
// The server was not disconnected.
else
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
}
return $this->cursor;
}
/**
* Select a database for use.
*
* @param string $database The name of the database to select for use.
*
* @return boolean True if the database was successfully selected.
*/
public function select($database)
{
try
{
$this->connection->exec('USE ' . $this->quoteName($database));
}
catch (Exception $e)
{
$errorInfo = $this->connection->errorInfo();
$this->errorNum = $errorInfo[1];
$this->errorMsg = $errorInfo[2];
return false;
}
return true;
}
/**
* Set the connection to use UTF-8 character encoding.
*
* @return boolean True on success.
*/
public function setUTF()
{
return true;
}
/**
* Method to commit a transaction.
*
* @return void
*/
public function transactionCommit()
{
$this->connection->commit();
}
/**
* Method to roll back a transaction.
*
* @return void
*/
public function transactionRollback()
{
$this->connection->rollBack();
}
/**
* Method to initialize a transaction.
*
* @return void
*/
public function transactionStart()
{
$this->connection->beginTransaction();
}
/**
* Method to fetch a row from the result set cursor as an array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
protected function fetchArray($cursor = null)
{
$ret = null;
if (!empty($cursor) && $cursor instanceof PDOStatement)
{
$ret = $cursor->fetch(PDO::FETCH_NUM);
}
elseif ($this->cursor instanceof PDOStatement)
{
$ret = $this->cursor->fetch(PDO::FETCH_NUM);
}
return $ret;
}
/**
* Method to fetch a row from the result set cursor as an object.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
* @param string $class The class name to use for the returned row object.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
protected function fetchObject($cursor = null, $class = 'stdClass')
{
$ret = null;
if (!empty($cursor) && $cursor instanceof PDOStatement)
{
$ret = $cursor->fetchObject($class);
}
elseif ($this->cursor instanceof PDOStatement)
{
$ret = $this->cursor->fetchObject($class);
}
return $ret;
}
}
PK \Sw w , vendor/akeeba/engine/engine/Driver/Mysql.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
/**
* MySQL classic driver for Akeeba Engine — compatibility stub.
*
* The PHP mysql extension was removed in PHP 7.0. Since the minimum supported PHP version is 7.4 the mysql extension
* is never available. This class is a compatibility stub that extends the MySQLi driver, which uses the mysqli
* extension supported since PHP 5.0.
*/
#[\AllowDynamicProperties]
class Mysql extends Mysqli
{
/**
* The name of the database driver.
*
* @var string
* @since 11.1
*/
public $name = 'mysql';
}
PK \e( 5 vendor/akeeba/engine/engine/Driver/Query/Pdomysql.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
/**
* Query Building Class.
*
* Based on Joomla! Platform 11.3
*/
class Pdomysql extends Mysqli implements Limitable
{
}
PK \ 2 vendor/akeeba/engine/engine/Driver/Query/Mysql.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
/**
* Query Building Class.
*
* Based on Joomla! Platform 11.3
*/
class Mysql extends Mysqli
{
}
PK \) 6 vendor/akeeba/engine/engine/Driver/Query/Limitable.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Base as BaseQuery;
/**
* Query Limitable Interface.
* Adds bind/unbind methods as well as a getBounded() method
* to retrieve the stored bounded variables on demand prior to
* query execution.
*
* Based on Joomla! Platform 11.2
*/
interface Limitable
{
/**
* Method to modify a query already in string format with the needed
* additions to make the query limited to a particular number of
* results, or start at a particular offset. This method is used
* automatically by the __toString() method if it detects that the
* query implements the Limitable interface.
*
* @param string $query The query in string format
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return string
*
* @since 12.1
*/
public function processLimit($query, $limit, $offset = 0);
/**
* Sets the offset and limit for the result set, if the database driver supports it.
*
* Usage:
* $query->setLimit(100, 0); (retrieve 100 rows, starting at first record)
* $query->setLimit(50, 50); (retrieve 50 rows, starting at 50th record)
*
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return BaseQuery Returns this object to allow chaining.
*
* @since 12.1
*/
public function setLimit($limit = 0, $offset = 0);
}
PK \dB5 3 vendor/akeeba/engine/engine/Driver/Query/Sqlite.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
use PDO;
use stdClass;
/**
* SQLite Query Building Class.
*
* @since 1.0
*/
class Sqlite extends Base implements Preparable, Limitable
{
/**
* The limit for the result set.
*
* @var integer
* @since 1.0
*/
protected $limit;
/**
* The offset for the result set.
*
* @var integer
* @since 1.0
*/
protected $offset;
/**
* Holds key / value pair of bound objects.
*
* @var mixed
* @since 1.0
*/
protected $bounded = [];
/**
* Method to add a variable to an internal array that will be bound to a prepared SQL statement before query execution. Also
* removes a variable that has been bounded from the internal bounded array when the passed in value is null.
*
* @param string|integer $key The key that will be used in your SQL query to reference the value. Usually of
* the form ':key', but can also be an integer.
* @param mixed &$value The value that will be bound. The value is passed by reference to support output
* parameters such as those possible with stored procedures.
* @param integer $dataType Constant corresponding to a SQL datatype.
* @param integer $length The length of the variable. Usually required for OUTPUT parameters.
* @param array $driverOptions Optional driver options to be used.
*
* @return Sqlite Returns this object to allow chaining.
*
* @since 1.0
*/
public function bind($key = null, &$value = null, $dataType = PDO::PARAM_STR, $length = 0, $driverOptions = [])
{
// Case 1: Empty Key (reset $bounded array)
if (empty($key))
{
$this->bounded = [];
return $this;
}
// Case 2: Key Provided, null value (unset key from $bounded array)
if (is_null($value))
{
if (isset($this->bounded[$key]))
{
unset($this->bounded[$key]);
}
return $this;
}
$obj = new stdClass;
$obj->value = &$value;
$obj->dataType = $dataType;
$obj->length = $length;
$obj->driverOptions = $driverOptions;
// Case 3: Simply add the Key/Value into the bounded array
$this->bounded[$key] = $obj;
return $this;
}
/**
* Retrieves the bound parameters array when key is null and returns it by reference. If a key is provided then that item is
* returned.
*
* @param mixed $key The bounded variable key to retrieve.
*
* @return mixed
*
* @since 1.0
*/
public function &getBounded($key = null)
{
if (empty($key))
{
return $this->bounded;
}
else
{
if (isset($this->bounded[$key]))
{
return $this->bounded[$key];
}
}
}
/**
* Gets the number of characters in a string.
*
* Note, use 'length' to find the number of bytes in a string.
*
* Usage:
* $query->select($query->charLength('a'));
*
* @param string $field A value.
* @param string $operator Comparison operator between charLength integer value and $condition
* @param string $condition Integer value to compare charLength with.
*
* @return string The required char length call.
*
* @since 1.1.0
*/
public function charLength($field, $operator = null, $condition = null)
{
return 'length(' . $field . ')' . (isset($operator) && isset($condition) ? ' ' . $operator . ' ' . $condition : '');
}
/**
* Clear data from the query or a specific clause of the query.
*
* @param string $clause Optionally, the name of the clause to clear, or nothing to clear the whole query.
*
* @return Sqlite Returns this object to allow chaining.
*
* @since 1.0
*/
public function clear($clause = null)
{
switch ($clause)
{
case null:
$this->bounded = [];
break;
}
return parent::clear($clause);
}
/**
* Concatenates an array of column names or values.
*
* Usage:
* $query->select($query->concatenate(array('a', 'b')));
*
* @param array $values An array of values to concatenate.
* @param string $separator As separator to place between each value.
*
* @return string The concatenated values.
*
* @since 1.1.0
*/
public function concatenate($values, $separator = null)
{
if ($separator)
{
return implode(' || ' . $this->quote($separator) . ' || ', $values);
}
else
{
return implode(' || ', $values);
}
}
/**
* Method to modify a query already in string format with the needed
* additions to make the query limited to a particular number of
* results, or start at a particular offset. This method is used
* automatically by the __toString() method if it detects that the
* query implements the LimitableInterface.
*
* @param string $query The query in string format
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return string
*
* @since 1.0
*/
public function processLimit($query, $limit, $offset = 0)
{
if ($limit > 0 || $offset > 0)
{
$query .= ' LIMIT ' . $offset . ', ' . $limit;
}
return $query;
}
/**
* Sets the offset and limit for the result set, if the database driver supports it.
*
* Usage:
* $query->setLimit(100, 0); (retrieve 100 rows, starting at first record)
* $query->setLimit(50, 50); (retrieve 50 rows, starting at 50th record)
*
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return Sqlite Returns this object to allow chaining.
*
* @since 1.0
*/
public function setLimit($limit = 0, $offset = 0)
{
$this->limit = (int) $limit;
$this->offset = (int) $offset;
return $this;
}
}
PK \4gf f 7 vendor/akeeba/engine/engine/Driver/Query/Postgresql.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Base as BaseQuery;
/**
* Query Building Class for PostgreSQL.
*/
class Postgresql extends Base implements Limitable
{
/**
* @var integer The offset for the result set.
*/
protected $offset;
/**
* @var integer The limit for the result set.
*/
protected $limit;
/**
* Method to modify a query already in string format with the needed
* additions to make the query limited to a particular number of
* results, or start at a particular offset.
*
* @param string $query The query in string format
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return string
*/
public function processLimit($query, $limit, $offset = 0)
{
if ($limit > 0)
{
$query .= ' LIMIT ' . (int) $limit;
}
if ($offset > 0)
{
$query .= ' OFFSET ' . (int) $offset;
}
return $query;
}
/**
* Sets the offset and limit for the result set, if the database driver supports it.
*
* Usage:
* $query->setLimit(100, 0); (retrieve 100 rows, starting at first record)
* $query->setLimit(50, 50); (retrieve 50 rows, starting at 50th record)
*
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return BaseQuery Returns this object to allow chaining.
*/
public function setLimit($limit = 0, $offset = 0)
{
$this->limit = (int) $limit;
$this->offset = (int) $offset;
return $this;
}
/**
* Concatenates an array of column names or values.
*
* @param array $values An array of values to concatenate.
* @param string $separator As separator to place between each value.
*
* @return string The concatenated values.
*/
public function concatenate($values, $separator = null)
{
if ($separator)
{
return 'CONCAT_WS(' . $this->quote($separator) . ', ' . implode(', ', $values) . ')';
}
else
{
return '(' . implode(' || ', $values) . ')';
}
}
}
PK \4 3 vendor/akeeba/engine/engine/Driver/Query/Mysqli.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Base as BaseQuery;
/**
* Query Building Class.
*
* Based on Joomla! Platform 11.3
*/
class Mysqli extends Base implements Limitable
{
/**
* @var integer The offset for the result set.
*/
protected $offset;
/**
* @var integer The limit for the result set.
*/
protected $limit;
/**
* Method to modify a query already in string format with the needed
* additions to make the query limited to a particular number of
* results, or start at a particular offset.
*
* @param string $query The query in string format
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return string
*/
public function processLimit($query, $limit, $offset = 0)
{
if ($limit > 0 || $offset > 0)
{
$query .= ' LIMIT ' . $offset . ', ' . $limit;
}
return $query;
}
/**
* Sets the offset and limit for the result set, if the database driver supports it.
*
* Usage:
* $query->setLimit(100, 0); (retrieve 100 rows, starting at first record)
* $query->setLimit(50, 50); (retrieve 50 rows, starting at 50th record)
*
* @param integer $limit The limit for the result set
* @param integer $offset The offset for the result set
*
* @return BaseQuery Returns this object to allow chaining.
*/
public function setLimit($limit = 0, $offset = 0)
{
$this->limit = (int) $limit;
$this->offset = (int) $offset;
return $this;
}
/**
* Concatenates an array of column names or values.
*
* @param array $values An array of values to concatenate.
* @param string $separator As separator to place between each value.
*
* @return string The concatenated values.
*/
public function concatenate($values, $separator = null)
{
if ($separator)
{
$concat_string = 'CONCAT_WS(' . $this->quote($separator);
foreach ($values as $value)
{
$concat_string .= ', ' . $value;
}
return $concat_string . ')';
}
else
{
return 'CONCAT(' . implode(',', $values) . ')';
}
}
}
PK \!7
7
7 vendor/akeeba/engine/engine/Driver/Query/Preparable.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
use PDO;
/**
* Database Query Preparable Interface.
*
* Adds bind/unbind methods as well as a getBounded() method
* to retrieve the stored bounded variables on demand prior to
* query execution.
*
* @since 1.0
*
* @codeCoverageIgnore
*/
interface Preparable
{
/**
* Method to add a variable to an internal array that will be bound to a prepared SQL statement before query execution. Also
* removes a variable that has been bounded from the internal bounded array when the passed in value is null.
*
* @param string|integer $key The key that will be used in your SQL query to reference the value. Usually of
* the form ':key', but can also be an integer.
* @param mixed &$value The value that will be bound. The value is passed by reference to support output
* parameters such as those possible with stored procedures.
* @param integer $dataType Constant corresponding to a SQL datatype.
* @param integer $length The length of the variable. Usually required for OUTPUT parameters.
* @param array $driverOptions Optional driver options to be used.
*
* @return Preparable
*
* @since 1.0
*/
public function bind($key = null, &$value = null, $dataType = PDO::PARAM_STR, $length = 0, $driverOptions = []);
/**
* Retrieves the bound parameters array when key is null and returns it by reference. If a key is provided then that item is
* returned.
*
* @param mixed $key The bounded variable key to retrieve.
*
* @return mixed
*
* @since 1.0
*/
public function &getBounded($key = null);
}
PK \}h 1 vendor/akeeba/engine/engine/Driver/Query/Base.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Base as DriverBase;
use Akeeba\Engine\Driver\Query\Element as QueryElement;
use Akeeba\Engine\Driver\Query\Limitable as QueryLimitable;
use Akeeba\Engine\Driver\QueryException;
/**
* Query Building Class.
*
* Based on Joomla! Platform 11.3
*/
abstract class Base
{
/**
* @var DriverBase The database connection resource.
*/
protected $db = null;
/**
* @var string The SQL query (if a direct query string was provided).
*/
protected $sql = null;
/**
* @var string The query type.
*/
protected $type = '';
/**
* @var QueryElement The query element for a generic query (type = null).
*/
protected $element = null;
/**
* @var QueryElement The select element.
*/
protected $select = null;
/**
* @var QueryElement The delete element.
*/
protected $delete = null;
/**
* @var QueryElement The update element.
*/
protected $update = null;
/**
* @var QueryElement The insert element.
*/
protected $insert = null;
/**
* @var QueryElement The from element.
*/
protected $from = null;
/**
* @var QueryElement The join element.
*/
protected $join = null;
/**
* @var QueryElement The set element.
*/
protected $set = null;
/**
* @var QueryElement The where element.
*/
protected $where = null;
/**
* @var QueryElement The group by element.
*/
protected $group = null;
/**
* @var QueryElement The having element.
*/
protected $having = null;
/**
* @var QueryElement The column list for an INSERT statement.
*/
protected $columns = null;
/**
* @var QueryElement The values list for an INSERT statement.
*/
protected $values = null;
/**
* @var QueryElement The order element.
*/
protected $order = null;
/**
* @var object The auto increment insert field element.
*/
protected $autoIncrementField = null;
/**
* @var QueryElement The call element.
*/
protected $call = null;
/**
* @var QueryElement The exec element.
*/
protected $exec = null;
/**
* @var QueryElement The union element.
*/
protected $union = null;
/**
* @var QueryElement The unionAll element.
*/
protected $unionAll = null;
/**
* Class constructor.
*
* @param DriverBase $db The database connector resource.
*/
public function __construct(?DriverBase $db = null)
{
$this->db = $db;
}
/**
* Magic method to provide method alias support for quote() and quoteName().
*
* @param string $method The called method.
* @param array $args The array of arguments passed to the method.
*
* @return string The aliased method's return value or null.
*/
public function __call($method, $args)
{
if (empty($args))
{
return null;
}
switch ($method)
{
case 'q':
return $this->quote($args[0], $args[1] ?? true);
break;
case 'qn':
return $this->quoteName($args[0]);
break;
case 'e':
return $this->escape($args[0], $args[1] ?? false);
break;
}
return null;
}
/**
* Magic function to convert the query to a string.
*
* @return string The completed query.
*/
public function __toString()
{
$query = '';
if ($this->sql)
{
return $this->sql;
}
switch ($this->type)
{
case 'element':
$query .= (string) $this->element;
break;
case 'select':
$query .= (string) $this->select;
$query .= (string) $this->from;
if ($this->join)
{
// Special case for joins
foreach ($this->join as $join)
{
$query .= (string) $join;
}
}
if ($this->where)
{
$query .= (string) $this->where;
}
if ($this->group)
{
$query .= (string) $this->group;
}
if ($this->having)
{
$query .= (string) $this->having;
}
if ($this->order)
{
$query .= (string) $this->order;
}
break;
case 'union':
$query .= (string) $this->union;
break;
case 'unionAll':
$query .= (string) $this->unionAll;
break;
case 'delete':
$query .= (string) $this->delete;
$query .= (string) $this->from;
if ($this->join)
{
// Special case for joins
foreach ($this->join as $join)
{
$query .= (string) $join;
}
}
if ($this->where)
{
$query .= (string) $this->where;
}
break;
case 'update':
$query .= (string) $this->update;
if ($this->join)
{
// Special case for joins
foreach ($this->join as $join)
{
$query .= (string) $join;
}
}
$query .= (string) $this->set;
if ($this->where)
{
$query .= (string) $this->where;
}
break;
case 'insert':
$query .= (string) $this->insert;
// Set method
if ($this->set)
{
$query .= (string) $this->set;
}
// Columns-Values method
elseif ($this->values)
{
if ($this->columns)
{
$query .= (string) $this->columns;
}
$elements = $this->values->getElements();
if (!($elements[0] instanceof $this))
{
$query .= ' VALUES ';
}
$query .= (string) $this->values;
}
break;
case 'call':
$query .= (string) $this->call;
break;
case 'exec':
$query .= (string) $this->exec;
break;
}
if ($this instanceof QueryLimitable)
{
$query = $this->processLimit($query, $this->limit, $this->offset);
}
return $query;
}
/**
* Magic function to get protected variable value
*
* @param string $name The name of the variable.
*
* @return mixed
*/
public function __get($name)
{
return $this->$name ?? null;
}
/**
* Add a single column, or array of columns to the CALL clause of the query.
*
* Note that you must not mix insert, update, delete and select method calls when building a query.
* The call method can, however, be called multiple times in the same query.
*
* Usage:
* $query->call('a.*')->call('b.id');
* $query->call(array('a.*', 'b.id'));
*
* @param mixed $columns A string or an array of field names.
*
* @return Base Returns this object to allow chaining.
*/
public function call($columns)
{
$this->type = 'call';
if (is_null($this->call))
{
$this->call = new QueryElement('CALL', $columns);
}
else
{
$this->call->append($columns);
}
return $this;
}
/**
* Casts a value to a char.
*
* Ensure that the value is properly quoted before passing to the method.
*
* Usage:
* $query->select($query->castAsChar('a'));
*
* @param string $value The value to cast as a char.
*
* @return string Returns the cast value.
*/
public function castAsChar($value)
{
return $value;
}
/**
* Gets the number of characters in a string.
*
* Note, use 'length' to find the number of bytes in a string.
*
* Usage:
* $query->select($query->charLength('a'));
*
* @param string $field A value.
* @param string $operator Comparison operator between charLength integer value and $condition
* @param string $condition Integer value to compare charLength with.
*
* @return string The required char length call.
*/
public function charLength($field, $operator = null, $condition = null)
{
return 'CHAR_LENGTH(' . $field . ')' . (isset($operator) && isset($condition) ? ' ' . $operator . ' ' . $condition : '');
}
/**
* Clear data from the query or a specific clause of the query.
*
* @param string $clause Optionally, the name of the clause to clear, or nothing to clear the whole query.
*
* @return Base Returns this object to allow chaining.
*/
public function clear($clause = null)
{
$this->sql = null;
switch ($clause)
{
case 'select':
$this->select = null;
$this->type = null;
break;
case 'delete':
$this->delete = null;
$this->type = null;
break;
case 'update':
$this->update = null;
$this->type = null;
break;
case 'insert':
$this->insert = null;
$this->type = null;
$this->autoIncrementField = null;
break;
case 'from':
$this->from = null;
break;
case 'join':
$this->join = null;
break;
case 'set':
$this->set = null;
break;
case 'where':
$this->where = null;
break;
case 'group':
$this->group = null;
break;
case 'having':
$this->having = null;
break;
case 'order':
$this->order = null;
break;
case 'columns':
$this->columns = null;
break;
case 'values':
$this->values = null;
break;
case 'exec':
$this->exec = null;
$this->type = null;
break;
case 'call':
$this->call = null;
$this->type = null;
break;
case 'limit':
$this->offset = 0;
$this->limit = 0;
break;
case 'union':
$this->union = null;
break;
case 'unionAll':
$this->unionAll = null;
break;
default:
$this->type = null;
$this->select = null;
$this->delete = null;
$this->update = null;
$this->insert = null;
$this->from = null;
$this->join = null;
$this->set = null;
$this->where = null;
$this->group = null;
$this->having = null;
$this->order = null;
$this->columns = null;
$this->values = null;
$this->autoIncrementField = null;
$this->exec = null;
$this->call = null;
$this->union = null;
$this->unionAll = null;
$this->offset = 0;
$this->limit = 0;
break;
}
return $this;
}
/**
* Adds a column, or array of column names that would be used for an INSERT INTO statement.
*
* @param mixed $columns A column name, or array of column names.
*
* @return Base Returns this object to allow chaining.
*/
public function columns($columns)
{
if (is_null($this->columns))
{
$this->columns = new QueryElement('()', $columns);
}
else
{
$this->columns->append($columns);
}
return $this;
}
/**
* Concatenates an array of column names or values.
*
* Usage:
* $query->select($query->concatenate(array('a', 'b')));
*
* @param array $values An array of values to concatenate.
* @param string $separator As separator to place between each value.
*
* @return string The concatenated values.
*/
public function concatenate($values, $separator = null)
{
if ($separator)
{
return 'CONCATENATE(' . implode(' || ' . $this->quote($separator) . ' || ', $values) . ')';
}
else
{
return 'CONCATENATE(' . implode(' || ', $values) . ')';
}
}
/**
* Gets the current date and time.
*
* Usage:
* $query->where('published_up < '.$query->currentTimestamp());
*
* @return string
*/
public function currentTimestamp()
{
return 'CURRENT_TIMESTAMP()';
}
/**
* Returns a PHP date() function compliant date format for the database driver.
*
* This method is provided for use where the query object is passed to a function for modification.
* If you have direct access to the database object, it is recommended you use the getDateFormat method directly.
*
* @return string The format string.
*/
public function dateFormat()
{
if (!($this->db instanceof DriverBase))
{
throw new QueryException('Invalid database object');
}
return $this->db->getDateFormat();
}
/**
* Creates a formatted dump of the query for debugging purposes.
*
* Usage:
* echo $query->dump();
*
* @return string
*/
public function dump()
{
return '
';
}
/**
* Add a table name to the DELETE clause of the query.
*
* Note that you must not mix insert, update, delete and select method calls when building a query.
*
* Usage:
* $query->delete('#__a')->where('id = 1');
*
* @param string $table The name of the table to delete from.
*
* @return Base Returns this object to allow chaining.
*/
public function delete($table = null)
{
$this->type = 'delete';
$this->delete = new QueryElement('DELETE', null);
if (!empty($table))
{
$this->from($table);
}
return $this;
}
/**
* Method to escape a string for usage in an SQL statement.
*
* This method is provided for use where the query object is passed to a function for modification.
* If you have direct access to the database object, it is recommended you use the escape method directly.
*
* Note that 'e' is an alias for this method as it is in DriverBase.
*
* @param string $text The string to be escaped.
* @param boolean $extra Optional parameter to provide extra escaping.
*
* @return string The escaped string.
*/
public function escape($text, $extra = false)
{
if (!($this->db instanceof DriverBase))
{
throw new QueryException('Invalid database object');
}
return $this->db->escape($text, $extra);
}
/**
* Add a single column, or array of columns to the EXEC clause of the query.
*
* Note that you must not mix insert, update, delete and select method calls when building a query.
* The exec method can, however, be called multiple times in the same query.
*
* Usage:
* $query->exec('a.*')->exec('b.id');
* $query->exec(array('a.*', 'b.id'));
*
* @param mixed $columns A string or an array of field names.
*
* @return Base Returns this object to allow chaining.
*/
public function exec($columns)
{
$this->type = 'exec';
if (is_null($this->exec))
{
$this->exec = new QueryElement('EXEC', $columns);
}
else
{
$this->exec->append($columns);
}
return $this;
}
/**
* Add a table to the FROM clause of the query.
*
* Note that while an array of tables can be provided, it is recommended you use explicit joins.
*
* Usage:
* $query->select('*')->from('#__a');
*
* @param mixed $tables A string or array of table names.
* This can be a Base object (or a child of it) when used
* as a subquery in FROM clause along with a value for $subQueryAlias.
* @param string $subQueryAlias Alias used when $tables is a Base.
*
* @return Base Returns this object to allow chaining.
*/
public function from($tables, $subQueryAlias = null)
{
if (is_null($this->from))
{
if ($tables instanceof $this)
{
if (is_null($subQueryAlias))
{
throw new QueryException('Null subquery defined');
}
$tables = '( ' . (string) $tables . ' ) AS ' . $this->quoteName($subQueryAlias);
}
$this->from = new QueryElement('FROM', $tables);
}
else
{
$this->from->append($tables);
}
return $this;
}
/**
* Used to get a string to extract year from date column.
*
* Usage:
* $query->select($query->year($query->quoteName('dateColumn')));
*
* @param string $date Date column containing year to be extracted.
*
* @return string Returns string to extract year from a date.
*/
public function year($date)
{
return 'YEAR(' . $date . ')';
}
/**
* Used to get a string to extract month from date column.
*
* Usage:
* $query->select($query->month($query->quoteName('dateColumn')));
*
* @param string $date Date column containing month to be extracted.
*
* @return string Returns string to extract month from a date.
*/
public function month($date)
{
return 'MONTH(' . $date . ')';
}
/**
* Used to get a string to extract day from date column.
*
* Usage:
* $query->select($query->day($query->quoteName('dateColumn')));
*
* @param string $date Date column containing day to be extracted.
*
* @return string Returns string to extract day from a date.
*/
public function day($date)
{
return 'DAY(' . $date . ')';
}
/**
* Used to get a string to extract hour from date column.
*
* Usage:
* $query->select($query->hour($query->quoteName('dateColumn')));
*
* @param string $date Date column containing hour to be extracted.
*
* @return string Returns string to extract hour from a date.
*/
public function hour($date)
{
return 'HOUR(' . $date . ')';
}
/**
* Used to get a string to extract minute from date column.
*
* Usage:
* $query->select($query->minute($query->quoteName('dateColumn')));
*
* @param string $date Date column containing minute to be extracted.
*
* @return string Returns string to extract minute from a date.
*/
public function minute($date)
{
return 'MINUTE(' . $date . ')';
}
/**
* Used to get a string to extract seconds from date column.
*
* Usage:
* $query->select($query->second($query->quoteName('dateColumn')));
*
* @param string $date Date column containing second to be extracted.
*
* @return string Returns string to extract second from a date.
*/
public function second($date)
{
return 'SECOND(' . $date . ')';
}
/**
* Add a grouping column to the GROUP clause of the query.
*
* Usage:
* $query->group('id');
*
* @param mixed $columns A string or array of ordering columns.
*
* @return Base Returns this object to allow chaining.
*/
public function group($columns)
{
if (is_null($this->group))
{
$this->group = new QueryElement('GROUP BY', $columns);
}
else
{
$this->group->append($columns);
}
return $this;
}
/**
* A conditions to the HAVING clause of the query.
*
* Usage:
* $query->group('id')->having('COUNT(id) > 5');
*
* @param mixed $conditions A string or array of columns.
* @param string $glue The glue by which to join the conditions. Defaults to AND.
*
* @return Base Returns this object to allow chaining.
*/
public function having($conditions, $glue = 'AND')
{
if (is_null($this->having))
{
$glue = strtoupper($glue);
$this->having = new QueryElement('HAVING', $conditions, " $glue ");
}
else
{
$this->having->append($conditions);
}
return $this;
}
/**
* Add an INNER JOIN clause to the query.
*
* Usage:
* $query->innerJoin('b ON b.id = a.id')->innerJoin('c ON c.id = b.id');
*
* @param string $condition The join condition.
*
* @return Base Returns this object to allow chaining.
*/
public function innerJoin($condition)
{
$this->join('INNER', $condition);
return $this;
}
/**
* Add a table name to the INSERT clause of the query.
*
* Note that you must not mix insert, update, delete and select method calls when building a query.
*
* Usage:
* $query->insert('#__a')->set('id = 1');
* $query->insert('#__a')->columns('id, title')->values('1,2')->values('3,4');
* $query->insert('#__a')->columns('id, title')->values(array('1,2', '3,4'));
*
* @param mixed $table The name of the table to insert data into.
* @param boolean $incrementField The name of the field to auto increment.
*
* @return Base Returns this object to allow chaining.
*/
public function insert($table, $incrementField = false)
{
$this->type = 'insert';
$this->insert = new QueryElement('INSERT INTO', $table);
$this->autoIncrementField = $incrementField;
return $this;
}
/**
* Add a JOIN clause to the query.
*
* Usage:
* $query->join('INNER', 'b ON b.id = a.id);
*
* @param string $type The type of join. This string is prepended to the JOIN keyword.
* @param string $conditions A string or array of conditions.
*
* @return Base Returns this object to allow chaining.
*/
public function join($type, $conditions)
{
if (is_null($this->join))
{
$this->join = [];
}
$this->join[] = new QueryElement(strtoupper($type) . ' JOIN', $conditions);
return $this;
}
/**
* Add a LEFT JOIN clause to the query.
*
* Usage:
* $query->leftJoin('b ON b.id = a.id')->leftJoin('c ON c.id = b.id');
*
* @param string $condition The join condition.
*
* @return Base Returns this object to allow chaining.
*/
public function leftJoin($condition)
{
$this->join('LEFT', $condition);
return $this;
}
/**
* Get the length of a string in bytes.
*
* Note, use 'charLength' to find the number of characters in a string.
*
* Usage:
* query->where($query->length('a').' > 3');
*
* @param string $value The string to measure.
*
* @return int
*/
public function length($value)
{
return 'LENGTH(' . $value . ')';
}
/**
* Get the null or zero representation of a timestamp for the database driver.
*
* This method is provided for use where the query object is passed to a function for modification.
* If you have direct access to the database object, it is recommended you use the nullDate method directly.
*
* Usage:
* $query->where('modified_date <> '.$query->nullDate());
*
* @param boolean $quoted Optionally wraps the null date in database quotes (true by default).
*
* @return string Null or zero representation of a timestamp.
*/
public function nullDate($quoted = true)
{
if (!($this->db instanceof DriverBase))
{
throw new QueryException('Invalid database object');
}
$result = $this->db->getNullDate();
if ($quoted)
{
return $this->db->quote($result);
}
return $result;
}
/**
* Add a ordering column to the ORDER clause of the query.
*
* Usage:
* $query->order('foo')->order('bar');
* $query->order(array('foo','bar'));
*
* @param mixed $columns A string or array of ordering columns.
*
* @return Base Returns this object to allow chaining.
*/
public function order($columns)
{
if (is_null($this->order))
{
$this->order = new QueryElement('ORDER BY', $columns);
}
else
{
$this->order->append($columns);
}
return $this;
}
/**
* Add an OUTER JOIN clause to the query.
*
* Usage:
* $query->outerJoin('b ON b.id = a.id')->outerJoin('c ON c.id = b.id');
*
* @param string $condition The join condition.
*
* @return Base Returns this object to allow chaining.
*/
public function outerJoin($condition)
{
$this->join('OUTER', $condition);
return $this;
}
/**
* Method to quote and optionally escape a string to database requirements for insertion into the database.
*
* This method is provided for use where the query object is passed to a function for modification.
* If you have direct access to the database object, it is recommended you use the quote method directly.
*
* Note that 'q' is an alias for this method as it is in DriverBase.
*
* Usage:
* $query->quote('fulltext');
* $query->q('fulltext');
* $query->q(array('option', 'fulltext'));
*
* @param mixed $text A string or an array of strings to quote.
* @param boolean $escape True to escape the string, false to leave it unchanged.
*
* @return string The quoted input string.
*
* @throws QueryException if the internal db property is not a valid object.
*/
public function quote($text, $escape = true)
{
if (!($this->db instanceof DriverBase))
{
throw new QueryException('Invalid database object');
}
return $this->db->quote($text, $escape);
}
/**
* Wrap an SQL statement identifier name such as column, table or database names in quotes to prevent injection
* risks and reserved word conflicts.
*
* This method is provided for use where the query object is passed to a function for modification.
* If you have direct access to the database object, it is recommended you use the quoteName method directly.
*
* Note that 'qn' is an alias for this method as it is in DriverBase.
*
* Usage:
* $query->quoteName('#__a');
* $query->qn('#__a');
*
* @param mixed $name The identifier name to wrap in quotes, or an array of identifier names to wrap in quotes.
* Each type supports dot-notation name.
* @param mixed $as The AS query part associated to $name. It can be string or array, in latter case it has
* to be same length of $name; if is null there will not be any AS part for string or array
* element.
*
* @return mixed The quote wrapped name, same type of $name.
*
* @throws QueryException if the internal db property is not a valid object.
*/
public function quoteName($name, $as = null)
{
if (!($this->db instanceof DriverBase))
{
throw new QueryException('Invalid database object');
}
return $this->db->quoteName($name, $as);
}
/**
* Add a RIGHT JOIN clause to the query.
*
* Usage:
* $query->rightJoin('b ON b.id = a.id')->rightJoin('c ON c.id = b.id');
*
* @param string $condition The join condition.
*
* @return Base Returns this object to allow chaining.
*/
public function rightJoin($condition)
{
$this->join('RIGHT', $condition);
return $this;
}
/**
* Add a single column, or array of columns to the SELECT clause of the query.
*
* Note that you must not mix insert, update, delete and select method calls when building a query.
* The select method can, however, be called multiple times in the same query.
*
* Usage:
* $query->select('a.*')->select('b.id');
* $query->select(array('a.*', 'b.id'));
*
* @param mixed $columns A string or an array of field names.
*
* @return Base Returns this object to allow chaining.
*/
public function select($columns)
{
$this->type = 'select';
if (is_null($this->select))
{
$this->select = new QueryElement('SELECT', $columns);
}
else
{
$this->select->append($columns);
}
return $this;
}
/**
* Add a single condition string, or an array of strings to the SET clause of the query.
*
* Usage:
* $query->set('a = 1')->set('b = 2');
* $query->set(array('a = 1', 'b = 2');
*
* @param mixed $conditions A string or array of string conditions.
* @param string $glue The glue by which to join the condition strings. Defaults to ,.
* Note that the glue is set on first use and cannot be changed.
*
* @return Base Returns this object to allow chaining.
*/
public function set($conditions, $glue = ',')
{
if (is_null($this->set))
{
$glue = strtoupper($glue);
$this->set = new QueryElement('SET', $conditions, "\n\t$glue ");
}
else
{
$this->set->append($conditions);
}
return $this;
}
/**
* Allows a direct query to be provided to the database
* driver's setQuery() method, but still allow queries
* to have bounded variables.
*
* Usage:
* $query->setQuery('select * from #__users');
*
* @param mixed $query An SQL Query
*
* @return QueryElement Returns this object to allow chaining.
*/
public function setQuery($query)
{
$this->sql = $query;
return $this;
}
/**
* Add a table name to the UPDATE clause of the query.
*
* Note that you must not mix insert, update, delete and select method calls when building a query.
*
* Usage:
* $query->update('#__foo')->set(...);
*
* @param string $table A table to update.
*
* @return Base Returns this object to allow chaining.
*/
public function update($table)
{
$this->type = 'update';
$this->update = new QueryElement('UPDATE', $table);
return $this;
}
/**
* Adds a tuple, or array of tuples that would be used as values for an INSERT INTO statement.
*
* Usage:
* $query->values('1,2,3')->values('4,5,6');
* $query->values(array('1,2,3', '4,5,6'));
*
* @param string $values A single tuple, or array of tuples.
*
* @return Base Returns this object to allow chaining.
*/
public function values($values)
{
if (is_null($this->values))
{
$this->values = new QueryElement('()', $values, '),(');
}
else
{
$this->values->append($values);
}
return $this;
}
/**
* Add a single condition, or an array of conditions to the WHERE clause of the query.
*
* Usage:
* $query->where('a = 1')->where('b = 2');
* $query->where(array('a = 1', 'b = 2'));
*
* @param mixed $conditions A string or array of where conditions.
* @param string $glue The glue by which to join the conditions. Defaults to AND.
* Note that the glue is set on first use and cannot be changed.
*
* @return Base Returns this object to allow chaining.
*/
public function where($conditions, $glue = 'AND')
{
if (is_null($this->where))
{
$glue = strtoupper($glue);
$this->where = new QueryElement('WHERE', $conditions, " $glue ");
}
else
{
$this->where->append($conditions);
}
return $this;
}
/**
* Method to provide deep copy support to nested objects and
* arrays when cloning.
*
* @return void
*/
public function __clone()
{
foreach ($this as $k => $v)
{
if ($k === 'db')
{
continue;
}
if (is_object($v) || is_array($v))
{
$this->$k = unserialize(serialize($v));
}
}
}
/**
* Add a query to UNION with the current query.
* Multiple unions each require separate statements and create an array of unions.
*
* Usage:
* $query->union('SELECT name FROM #__foo')
* $query->union('SELECT name FROM #__foo','distinct')
* $query->union(array('SELECT name FROM #__foo','SELECT name FROM #__bar'))
*
* @param mixed $query The Base object or string to union.
* @param boolean $distinct True to only return distinct rows from the union.
* @param string $glue The glue by which to join the conditions.
*
* @return mixed The Base object on success or boolean false on failure.
*/
public function union($query, $distinct = false, $glue = '')
{
// Clear any ORDER BY clause in UNION query
// See http://dev.mysql.com/doc/refman/5.0/en/union.html
if (!is_null($this->order))
{
$this->clear('order');
}
// Set up the DISTINCT flag, the name with parentheses, and the glue.
if ($distinct)
{
$name = 'UNION DISTINCT ()';
$glue = ')' . PHP_EOL . 'UNION DISTINCT (';
}
else
{
$glue = ')' . PHP_EOL . 'UNION (';
$name = 'UNION ()';
}
// Get the QueryElement if it does not exist
if (is_null($this->union))
{
$this->union = new QueryElement($name, $query, "$glue");
}
// Otherwise append the second UNION.
else
{
$glue = '';
$this->union->append($query);
}
return $this;
}
/**
* Add a query to UNION DISTINCT with the current query. Simply a proxy to Union with the Distinct clause.
*
* Usage:
* $query->unionDistinct('SELECT name FROM #__foo')
*
* @param mixed $query The Base object or string to union.
* @param string $glue The glue by which to join the conditions.
*
* @return mixed The Base object on success or boolean false on failure.
*/
public function unionDistinct($query, $glue = '')
{
$distinct = true;
// Apply the distinct flag to the union.
return $this->union($query, $distinct, $glue);
}
/**
* Find and replace sprintf-like tokens in a format string.
* Each token takes one of the following forms:
* %% - A literal percent character.
* %[t] - Where [t] is a type specifier.
* %[n]$[x] - Where [n] is an argument specifier and [t] is a type specifier.
*
* Types:
* a - Numeric: Replacement text is coerced to a numeric type but not quoted or escaped.
* e - Escape: Replacement text is passed to $this->escape().
* E - Escape (extra): Replacement text is passed to $this->escape() with true as the second argument.
* n - Name Quote: Replacement text is passed to $this->quoteName().
* q - Quote: Replacement text is passed to $this->quote().
* Q - Quote (no escape): Replacement text is passed to $this->quote() with false as the second argument.
* r - Raw: Replacement text is used as-is. (Be careful)
*
* Date Types:
* - Replacement text automatically quoted (use uppercase for Name Quote).
* - Replacement text should be a string in date format or name of a date column.
* y/Y - Year
* m/M - Month
* d/D - Day
* h/H - Hour
* i/I - Minute
* s/S - Second
*
* Invariable Types:
* - Takes no argument.
* - Argument index not incremented.
* t - Replacement text is the result of $this->currentTimestamp().
* z - Replacement text is the result of $this->nullDate(false).
* Z - Replacement text is the result of $this->nullDate(true).
*
* Usage:
* $query->format('SELECT %1$n FROM %2$n WHERE %3$n = %4$a', 'foo', '#__foo', 'bar', 1);
* Returns: SELECT `foo` FROM `#__foo` WHERE `bar` = 1
*
* Notes:
* The argument specifier is optional but recommended for clarity.
* The argument index used for unspecified tokens is incremented only when used.
*
* @param string $format The formatting string.
*
* @return string Returns a string produced according to the formatting string.
*/
public function format($format)
{
$query = $this;
$args = array_slice(func_get_args(), 1);
array_unshift($args, null);
$i = 1;
$func = function ($match) use ($query, $args, &$i) {
if (isset($match[6]) && $match[6] == '%')
{
return '%';
}
// No argument required, do not increment the argument index.
switch ($match[5])
{
case 't':
return $query->currentTimestamp();
break;
case 'z':
return $query->nullDate(false);
break;
case 'Z':
return $query->nullDate(true);
break;
}
// Increment the argument index only if argument specifier not provided.
$index = is_numeric($match[4]) ? (int) $match[4] : $i++;
if (!$index || !isset($args[$index]))
{
$replacement = '';
}
else
{
$replacement = $args[$index];
}
switch ($match[5])
{
case 'a':
return 0 + $replacement;
break;
case 'e':
return $query->escape($replacement);
break;
case 'E':
return $query->escape($replacement, true);
break;
case 'n':
return $query->quoteName($replacement);
break;
case 'q':
return $query->quote($replacement);
break;
case 'Q':
return $query->quote($replacement, false);
break;
case 'r':
return $replacement;
break;
// Dates
case 'y':
return $query->year($query->quote($replacement));
break;
case 'Y':
return $query->year($query->quoteName($replacement));
break;
case 'm':
return $query->month($query->quote($replacement));
break;
case 'M':
return $query->month($query->quoteName($replacement));
break;
case 'd':
return $query->day($query->quote($replacement));
break;
case 'D':
return $query->day($query->quoteName($replacement));
break;
case 'h':
return $query->hour($query->quote($replacement));
break;
case 'H':
return $query->hour($query->quoteName($replacement));
break;
case 'i':
return $query->minute($query->quote($replacement));
break;
case 'I':
return $query->minute($query->quoteName($replacement));
break;
case 's':
return $query->second($query->quote($replacement));
break;
case 'S':
return $query->second($query->quoteName($replacement));
break;
}
return '';
};
/**
* Regexp to find an replace all tokens.
* Matched fields:
* 0: Full token
* 1: Everything following '%'
* 2: Everything following '%' unless '%'
* 3: Argument specifier and '$'
* 4: Argument specifier
* 5: Type specifier
* 6: '%' if full token is '%%'
*/
return preg_replace_callback('#%(((([\d]+)\$)?([aeEnqQryYmMdDhHiIsStzZ]))|(%))#', $func, $format);
}
/**
* Add to the current date and time.
* Usage:
* $query->select($query->dateAdd());
* Prefixing the interval with a - (negative sign) will cause subtraction to be used.
* Note: Not all drivers support all units.
*
* @param string $date The SQL-formatted date to add to. May be a date or datetime string.
* @param string $interval The string representation of the appropriate number of units
* @param string $datePart The part of the date to perform the addition on
*
* @return string The string with the appropriate sql for addition of dates
*
* @see http://dev.mysql.com/doc/refman/5.1/en/date-and-time-functions.html#function_date-add
*/
public function dateAdd($date, $interval, $datePart)
{
return trim("DATE_ADD('" . $date . "', INTERVAL " . $interval . ' ' . $datePart . ')');
}
/**
* Add a query to UNION ALL with the current query.
* Multiple unions each require separate statements and create an array of unions.
*
* Usage:
* $query->union('SELECT name FROM #__foo')
* $query->union('SELECT name FROM #__foo','distinct')
* $query->union(array('SELECT name FROM #__foo','SELECT name FROM #__bar'))
*
* @param mixed $query The Base object or string to union.
* @param boolean $distinct True to only return distinct rows from the union.
* @param string $glue The glue by which to join the conditions.
*
* @return mixed The Base object on success or boolean false on failure.
*/
public function unionAll($query, $distinct = false, $glue = '')
{
$glue = ')' . PHP_EOL . 'UNION ALL (';
$name = 'UNION ALL ()';
// Get the QueryElement if it does not exist
if (is_null($this->unionAll))
{
$this->unionAll = new QueryElement($name, $query, "$glue");
}
// Otherwise append the second UNION.
else
{
$glue = '';
$this->unionAll->append($query);
}
return $this;
}
}
PK \ Jٝ
4 vendor/akeeba/engine/engine/Driver/Query/Element.phpnu [ .
*/
namespace Akeeba\Engine\Driver\Query;
defined('AKEEBAENGINE') || die();
/**
* Query Element Class.
*
* Based on Joomla! Platform 11.3
*/
class Element
{
/**
* @var string The name of the element.
*/
protected $name = null;
/**
* @var array An array of elements.
*/
protected $elements = null;
/**
* @var string Glue piece.
*/
protected $glue = null;
/**
* Constructor.
*
* @param string $name The name of the element.
* @param mixed $elements String or array.
* @param string $glue The glue for elements.
*/
public function __construct($name, $elements, $glue = ',')
{
$this->elements = [];
$this->name = $name;
$this->glue = $glue;
$this->append($elements);
}
/**
* Magic function to convert the query element to a string.
*
* @return string
*/
public function __toString()
{
if (substr($this->name, -2) == '()')
{
return PHP_EOL . substr($this->name, 0, -2) . '(' . implode($this->glue, $this->elements) . ')';
}
else
{
return PHP_EOL . $this->name . ' ' . implode($this->glue, $this->elements);
}
}
/**
* Appends element parts to the internal list.
*
* @param mixed $elements String or array.
*
* @return void
*/
public function append($elements)
{
if (is_array($elements))
{
$this->elements = array_merge($this->elements, $elements);
}
else
{
$this->elements = array_merge($this->elements, [$elements]);
}
}
/**
* Gets the elements of this element.
*
* @return string
*/
public function getElements()
{
return $this->elements;
}
/**
* Method to provide deep copy support to nested objects and arrays
* when cloning.
*
* @return void
*/
public function __clone()
{
foreach ($this as $k => $v)
{
if (is_object($v) || is_array($v))
{
$this->{$k} = unserialize(serialize($v));
}
}
}
}
PK \Sʉ 2 vendor/akeeba/engine/engine/Driver/Query/.htaccessnu 7m
Order allow,deny
Deny from all
PK \8 @3O 3O - vendor/akeeba/engine/engine/Driver/Sqlite.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Base as QueryBase;
use Akeeba\Engine\Driver\Query\Limitable;
use Akeeba\Engine\Driver\Query\Preparable;
use PDO;
use PDOException;
use PDOStatement;
use RuntimeException;
use SQLite3;
/**
* SQLite database driver supporting PDO based connections
*
* @see http://php.net/manual/en/ref.pdo-sqlite.php
* @since 1.0
*/
#[\AllowDynamicProperties]
class Sqlite extends Base
{
public static $dbtech = 'sqlite';
/**
* The name of the database driver.
*
* @var string
* @since 1.0
*/
public $name = 'sqlite';
/** @var PDOStatement The database connection cursor from the last query. */
protected $cursor;
/** @var array Contains the current query execution status */
protected $executed = false;
/**
* The character(s) used to quote SQL statement names such as table names or field names,
* etc. The child classes should define this as necessary. If a single character string the
* same character is used for both sides of the quoted name, else the first character will be
* used for the opening quote and the second for the closing quote.
*
* @var string
* @since 1.0
*/
protected $nameQuote = '`';
/** @var resource The prepared statement. */
protected $prepared;
/** @var bool Are we in the process of reconnecting to the database server? */
private $isReconnecting = false;
public function __construct(array $options)
{
$this->driverType = 'sqlite';
parent::__construct($options);
if (!is_object($this->connection))
{
$this->open();
}
}
/**
* Test to see if the PDO ODBC connector is available.
*
* @return boolean True on success, false otherwise.
*
* @since 1.0
*/
public static function isSupported()
{
return class_exists('\\PDO') && in_array('sqlite', PDO::getAvailableDrivers());
}
/**
* Destructor.
*
* @since 1.0
*/
public function __destruct()
{
$this->freeResult();
unset($this->connection);
}
public function close()
{
$return = false;
if (is_object($this->cursor))
{
$this->cursor->closeCursor();
}
$this->connection = null;
return $return;
}
/**
* Determines if the connection to the server is active.
*
* @return boolean True if connected to the database engine.
*/
public function connected()
{
return !empty($this->connection);
}
/**
* Disconnects the database.
*
* @return void
*
* @since 1.0
*/
public function disconnect()
{
$this->freeResult();
unset($this->connection);
}
/**
* Drops a table from the database.
*
* @param string $tableName The name of the database table to drop.
* @param boolean $ifExists Optionally specify that the table must exist before it is dropped.
*
* @return Sqlite Returns this object to support chaining.
*
* @since 1.0
*/
public function dropTable($tableName, $ifExists = true)
{
$this->open();
$query = $this->getQuery(true);
$this->setQuery('DROP TABLE ' . ($ifExists ? 'IF EXISTS ' : '') . $query->quoteName($tableName));
$this->execute();
return $this;
}
/**
* Method to escape a string for usage in an SQLite statement.
*
* Note: Using query objects with bound variables is preferable to the below.
*
* @param string $text The string to be escaped.
* @param boolean $extra Unused optional parameter to provide extra escaping.
*
* @return string The escaped string.
*
* @since 1.0
*/
public function escape($text, $extra = false)
{
if (is_int($text) || is_float($text))
{
return $text;
}
if (is_null($text))
{
return 'NULL';
}
if (is_object($this->connection))
{
return substr($this->connection->quote($text), 1, -1);
}
if (class_exists('SQLite3'))
{
return SQLite3::escapeString($text);
}
return str_replace("'", "''", $text);
}
public function fetchAssoc($cursor = null)
{
if (!empty($cursor) && $cursor instanceof PDOStatement)
{
return $cursor->fetch(PDO::FETCH_ASSOC);
}
if ($this->prepared instanceof PDOStatement)
{
return $this->prepared->fetch(PDO::FETCH_ASSOC);
}
}
public function freeResult($cursor = null)
{
$this->executed = false;
if ($cursor instanceof PDOStatement)
{
$cursor->closeCursor();
$cursor = null;
}
if ($this->prepared instanceof PDOStatement)
{
$this->prepared->closeCursor();
$this->prepared = null;
}
}
public function getAffectedRows()
{
$this->open();
if ($this->prepared instanceof PDOStatement)
{
return $this->prepared->rowCount();
}
else
{
return 0;
}
}
/**
* Method to get the database collation in use by sampling a text field of a table in the database.
*
* @return mixed The collation in use by the database or boolean false if not supported.
*
* @since 1.0
*/
public function getCollation()
{
return $this->charset;
}
public function getNumRows($cursor = null)
{
$this->open();
if ($cursor instanceof PDOStatement)
{
return $cursor->rowCount();
}
elseif ($this->prepared instanceof PDOStatement)
{
return $this->prepared->rowCount();
}
else
{
return 0;
}
}
/**
* Retrieve a PDO database connection attribute
* http://www.php.net/manual/en/pdo.getattribute.php
*
* Usage: $db->getOption(PDO::ATTR_CASE);
*
* @param mixed $key One of the PDO::ATTR_* Constants
*
* @return mixed
*
* @since 1.0
*/
public function getOption($key)
{
$this->open();
return $this->connection->getAttribute($key);
}
/**
* Get the current query object or a new Query object.
* We have to override the parent method since it will always return a PDO query, while we have a
* specialized class for SQLite
*
* @param boolean $new False to return the current query object, True to return a new Query object.
*
* @return QueryBase The current query object or a new object extending the Query class.
*
* @throws RuntimeException
*/
public function getQuery($new = false)
{
if ($new)
{
return new Query\Sqlite($this);
}
return $this->sql;
}
public function createQuery()
{
return new Query\Sqlite($this);
}
/**
* Retrieves field information about a given table.
*
* @param string $table The name of the database table.
* @param boolean $typeOnly True to only return field types.
*
* @return array An array of fields for the database table.
*
* @throws RuntimeException
* @since 1.0
*/
public function getTableColumns($table, $typeOnly = true)
{
$this->open();
$columns = [];
$query = $this->getQuery(true);
$fieldCasing = $this->getOption(PDO::ATTR_CASE);
$this->setOption(PDO::ATTR_CASE, PDO::CASE_UPPER);
$table = strtoupper($table);
$query->setQuery('pragma table_info(' . $table . ')');
$this->setQuery($query);
$fields = $this->loadObjectList();
if ($typeOnly)
{
foreach ($fields as $field)
{
$columns[$field->NAME] = $field->TYPE;
}
}
else
{
foreach ($fields as $field)
{
// Do some dirty translation to MySQL output.
$columns[$field->NAME] = (object) [
'Field' => $field->NAME,
'Type' => $field->TYPE,
'Null' => ($field->NOTNULL == '1' ? 'NO' : 'YES'),
'Default' => $field->DFLT_VALUE,
'Key' => ($field->PK == '1' ? 'PRI' : ''),
];
}
}
$this->setOption(PDO::ATTR_CASE, $fieldCasing);
return $columns;
}
/**
* Shows the table CREATE statement that creates the given tables.
*
* Note: Doesn't appear to have support in SQLite
*
* @param mixed $tables A table name or a list of table names.
*
* @return array A list of the create SQL for the tables.
*
* @throws RuntimeException
* @since 1.0
*/
public function getTableCreate($tables)
{
$this->open();
// Sanitize input to an array and iterate over the list.
$tables = (array) $tables;
return $tables;
}
/**
* Get the details list of keys for a table.
*
* @param string $table The name of the table.
*
* @return array An array of the column specification for the table.
*
* @throws RuntimeException
* @since 1.0
*/
public function getTableKeys($table)
{
$this->open();
$keys = [];
$query = $this->getQuery(true);
$fieldCasing = $this->getOption(PDO::ATTR_CASE);
$this->setOption(PDO::ATTR_CASE, PDO::CASE_UPPER);
$table = strtoupper($table);
$query->setQuery('pragma table_info( ' . $table . ')');
// $query->bind(':tableName', $table);
$this->setQuery($query);
$rows = $this->loadObjectList();
foreach ($rows as $column)
{
if ($column->PK == 1)
{
$keys[$column->NAME] = $column;
}
}
$this->setOption(PDO::ATTR_CASE, $fieldCasing);
return $keys;
}
/**
* Method to get an array of all tables in the database (schema).
*
* @return array An array of all the tables in the database.
*
* @throws RuntimeException
* @since 1.0
*/
public function getTableList()
{
$this->open();
/* @type Query\Sqlite $query */
$query = $this->getQuery(true);
$type = 'table';
$query->select('name');
$query->from('sqlite_master');
$query->where('type = :type');
$query->bind(':type', $type);
$query->order('name');
$this->setQuery($query);
$tables = $this->loadColumn();
return $tables;
}
/**
* There's no point on return "a list of tables" inside a SQLite database: we are simple going to
* copy the whole database file in the new location
*
* @param bool $abstract
*
* @return array
*/
public function getTables($abstract = true)
{
return [];
}
/**
* Get the version of the database connector.
*
* @return string The database connector version.
*
* @since 1.0
*/
public function getVersion()
{
$this->open();
$this->setQuery("SELECT sqlite_version()");
return $this->loadResult();
}
public function insertid()
{
$this->open();
// Error suppress this to prevent PDO warning us that the driver doesn't support this operation.
return @$this->connection->lastInsertId();
}
/**
* Locks a table in the database.
*
* @param string $table The name of the table to unlock.
*
* @return Sqlite Returns this object to support chaining.
*
* @throws RuntimeException
* @since 1.0
*/
public function lockTable($table)
{
return $this;
}
public function open()
{
if ($this->connected())
{
return;
}
else
{
$this->close();
}
if (isset($this->options['version']) && $this->options['version'] == 2)
{
$format = 'sqlite2:#DBNAME#';
}
else
{
$format = 'sqlite:#DBNAME#';
}
$replace = ['#DBNAME#'];
$with = [$this->options['database']];
// Create the connection string:
$connectionString = str_replace($replace, $with, $format);
try
{
$this->connection = new PDO(
$connectionString,
$this->options['user'],
$this->options['password']
);
}
catch (PDOException $e)
{
throw new RuntimeException('Could not connect to PDO' . ': ' . $e->getMessage(), 2, $e);
}
}
public function query()
{
$this->open();
if (!is_object($this->connection))
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
// Take a local copy so that we don't modify the original query and cause issues later
$sql = $this->replacePrefix((string) $this->sql);
if ($this->limit > 0 || $this->offset > 0)
{
$sql .= ' LIMIT ' . $this->limit;
if ($this->offset > 0)
{
$sql .= ' OFFSET ' . $this->offset;
}
}
// Increment the query counter.
$this->count++;
// If debugging is enabled then let's log the query.
if ($this->debug)
{
// Add the query to the object queue.
$this->log[] = $sql;
}
// Reset the error values.
$this->errorNum = 0;
$this->errorMsg = '';
// Execute the query.
$this->executed = false;
if ($this->prepared instanceof PDOStatement)
{
// Bind the variables:
if ($this->sql instanceof Preparable)
{
$bounded =& $this->sql->getBounded();
foreach ($bounded as $key => $obj)
{
$this->prepared->bindParam($key, $obj->value, $obj->dataType, $obj->length, $obj->driverOptions);
}
}
$this->executed = $this->prepared->execute();
}
// If an error occurred handle it.
if (!$this->executed)
{
// Get the error number and message before we execute any more queries.
$errorNum = (int) $this->connection->errorCode();
$errorMsg = (string) 'SQL: ' . implode(", ", $this->connection->errorInfo());
// Check if the server was disconnected.
if (!$this->connected() && !$this->isReconnecting)
{
$this->isReconnecting = true;
try
{
// Attempt to reconnect.
$this->connection = null;
$this->open();
}
catch (RuntimeException $e)
// If connect fails, ignore that exception and throw the normal exception.
{
// Get the error number and message.
$this->errorNum = (int) $this->connection->errorCode();
$this->errorMsg = (string) 'SQL: ' . implode(", ", $this->connection->errorInfo());
// Throw the normal query exception.
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
// Since we were able to reconnect, run the query again.
$result = $this->query();
$this->isReconnecting = false;
return $result;
}
else
// The server was not disconnected.
{
// Get the error number and message from before we tried to reconnect.
$this->errorNum = $errorNum;
$this->errorMsg = $errorMsg;
// Throw the normal query exception.
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
}
return $this->prepared;
}
/**
* Renames a table in the database.
*
* @param string $oldTable The name of the table to be renamed
* @param string $newTable The new name for the table.
* @param string $backup Not used by Sqlite.
* @param string $prefix Not used by Sqlite.
*
* @return Sqlite Returns this object to support chaining.
*
* @throws RuntimeException
* @since 1.0
*/
public function renameTable($oldTable, $newTable, $backup = null, $prefix = null)
{
$this->setQuery('ALTER TABLE ' . $oldTable . ' RENAME TO ' . $newTable)->execute();
return $this;
}
/**
* Select a database for use.
*
* @param string $database The name of the database to select for use.
*
* @return boolean True if the database was successfully selected.
*
* @throws RuntimeException
* @since 1.0
*/
public function select($database)
{
$this->open();
$this->_database = $database;
return true;
}
/**
* Sets an attribute on the PDO database handle.
* http://www.php.net/manual/en/pdo.setattribute.php
*
* Usage: $db->setOption(PDO::ATTR_CASE, PDO::CASE_UPPER);
*
* @param integer $key One of the PDO::ATTR_* Constants
* @param mixed $value One of the associated PDO Constants
* related to the particular attribute
* key.
*
* @return boolean
*
* @since 1.0
*/
public function setOption($key, $value)
{
$this->open();
return $this->connection->setAttribute($key, $value);
}
/**
* Sets the SQL statement string for later execution.
*
* @param mixed $query The SQL statement to set either as a JDatabaseQuery object or a string.
* @param integer $offset The affected row offset to set.
* @param integer $limit The maximum affected rows to set.
* @param array $driverOptions The optional PDO driver options
*
* @return Base This object to support method chaining.
*
* @since 1.0
*/
public function setQuery($query, $offset = null, $limit = null, $driverOptions = [])
{
$this->open();
$this->freeResult();
if (is_string($query))
{
// Allows taking advantage of bound variables in a direct query:
$query = $this->getQuery(true)->setQuery($query);
}
if ($query instanceof Limitable && !is_null($offset) && !is_null($limit))
{
$query->setLimit($limit, $offset);
}
$sql = $this->replacePrefix((string) $query);
$this->prepared = $this->connection->prepare($sql, $driverOptions);
// Store reference to the DatabaseQuery instance:
parent::setQuery($query, $offset, $limit);
return $this;
}
/**
* Set the connection to use UTF-8 character encoding.
*
* Returns false automatically for the Oracle driver since
* you can only set the character set when the connection
* is created.
*
* @return boolean True on success.
*
* @since 1.0
*/
public function setUTF()
{
$this->open();
return false;
}
/**
* Method to commit a transaction.
*
* @param boolean $toSavepoint If true, commit to the last savepoint.
*
* @return void
*
* @throws RuntimeException
* @since 1.0
*/
public function transactionCommit($toSavepoint = false)
{
$this->open();
if (!$toSavepoint || $this->transactionDepth <= 1)
{
$this->open();
if (!$toSavepoint || $this->transactionDepth == 1)
{
$this->connection->commit();
}
$this->transactionDepth--;
}
else
{
$this->transactionDepth--;
}
}
/**
* Method to roll back a transaction.
*
* @param boolean $toSavepoint If true, rollback to the last savepoint.
*
* @return void
*
* @throws RuntimeException
* @since 1.0
*/
public function transactionRollback($toSavepoint = false)
{
$this->connected();
if (!$toSavepoint || $this->transactionDepth <= 1)
{
$this->open();
if (!$toSavepoint || $this->transactionDepth == 1)
{
$this->connection->rollBack();
}
$this->transactionDepth--;
}
else
{
$savepoint = 'SP_' . ($this->transactionDepth - 1);
$this->setQuery('ROLLBACK TO ' . $this->quoteName($savepoint));
if ($this->execute())
{
$this->transactionDepth--;
}
}
}
/**
* Method to initialize a transaction.
*
* @param boolean $asSavepoint If true and a transaction is already active, a savepoint will be created.
*
* @return void
*
* @throws RuntimeException
* @since 1.0
*/
public function transactionStart($asSavepoint = false)
{
$this->connected();
if (!$asSavepoint || !$this->transactionDepth)
{
$this->open();
if (!$asSavepoint || !$this->transactionDepth)
{
$this->connection->beginTransaction();
}
$this->transactionDepth++;
}
else
{
$savepoint = 'SP_' . $this->transactionDepth;
$this->setQuery('SAVEPOINT ' . $this->quoteName($savepoint));
if ($this->execute())
{
$this->transactionDepth++;
}
}
}
/**
* Unlocks tables in the database.
*
* @return Sqlite Returns this object to support chaining.
*
* @throws RuntimeException
* @since 1.0
*/
public function unlockTables()
{
return $this;
}
protected function fetchArray($cursor = null)
{
if (!empty($cursor) && $cursor instanceof PDOStatement)
{
return $cursor->fetch(PDO::FETCH_NUM);
}
if ($this->prepared instanceof PDOStatement)
{
return $this->prepared->fetch(PDO::FETCH_NUM);
}
}
protected function fetchObject($cursor = null, $class = 'stdClass')
{
if (!empty($cursor) && $cursor instanceof PDOStatement)
{
return $cursor->fetchObject($class);
}
if ($this->prepared instanceof PDOStatement)
{
return $this->prepared->fetchObject($class);
}
}
}
PK \# 5 vendor/akeeba/engine/engine/Driver/QueryException.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
use Exception;
class QueryException extends Exception
{
}
PK \8:6 6 1 vendor/akeeba/engine/engine/Driver/Postgresql.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Postgresql as QueryPostgresql;
use PDO;
use PDOException;
use PDOStatement;
use ReflectionClass;
use RuntimeException;
use Throwable;
/**
* PDO PostgreSQL database driver for Akeeba Engine
*/
#[\AllowDynamicProperties]
class Postgresql extends Base
{
/**
* The name of the database driver.
*
* @var string
*/
public $name = 'postgresql';
/** @var string Connection character set */
protected $charset = 'UTF8';
/** @var PDO The db connection resource */
protected $connection = null;
/** @var PDOStatement The database connection cursor from the last query. */
protected $cursor;
/** @var array Driver options for PDO */
protected $driverOptions = [];
/**
* Database object constructor
*
* @param array $options List of options used to configure the connection
*/
public function __construct($options)
{
$this->driverType = 'postgresql';
// Init
$this->nameQuote = '"';
// Open the connection
$this->host = $options['host'] ?? 'localhost';
$this->user = $options['user'] ?? '';
$this->password = $options['password'] ?? '';
$this->port = ($options['port'] ?? 5432) ?: 5432;
$this->_database = $options['database'] ?? '';
$this->selectDatabase = $options['select'] ?? true;
$this->charset = $options['charset'] ?? 'UTF8';
$this->driverOptions = $options['driverOptions'] ?? [];
$this->tablePrefix = $options['prefix'] ?? '';
$this->connection = $options['connection'] ?? null;
$this->errorNum = 0;
$this->count = 0;
$this->log = [];
$this->options = $options;
if (!is_object($this->connection))
{
$this->open();
}
}
/**
* Test to see if the PostgreSQL connector is available.
*
* @return boolean True on success, false otherwise.
*/
public static function isSupported()
{
if (!defined('\PDO::ATTR_DRIVER_NAME'))
{
return false;
}
return in_array('pgsql', PDO::getAvailableDrivers());
}
/**
* PDO does not support serialize
*
* @return array
*/
public function __sleep()
{
$serializedProperties = [];
$reflect = new ReflectionClass($this);
// Get properties of the current class
$properties = $reflect->getProperties();
foreach ($properties as $property)
{
// Do not serialize properties that are \PDO
if (!$property->isStatic() && !($this->{$property->name} instanceof PDO))
{
$serializedProperties[] = $property->name;
}
}
return $serializedProperties;
}
/**
* Wake up after serialization
*
* @return void
*/
public function __wakeup()
{
// Get connection back
$this->__construct($this->options);
}
/**
* Quote a value as a hex string.
*
* @param string $text The value to quote as hex.
*
* @return string The hex-quoted value.
* @since 10.3
*/
public function quoteHex(string $text): string
{
return "'\\x" . bin2hex($text) . "'";
}
/**
* Replaces the table prefix in identifiers, excluding string literals and comments.
*
* @param string $sql The SQL statement to prepare.
* @param string $prefix The common table prefix.
*
* @return string The processed SQL statement.
* @since 10.3
*/
public function replacePrefix($sql, $prefix = '#__')
{
$sql = trim((string) $sql);
$n = strlen($sql);
$out = '';
$i = 0;
$pl = strlen($prefix);
while ($i < $n)
{
$ch = $sql[$i];
// Skip single-quoted literals
if ($ch === "'")
{
$out .= $ch;
$i++;
while ($i < $n)
{
$ch = $sql[$i];
$out .= $ch;
$i++;
if ($ch === "'")
{
if ($i < $n && $sql[$i] === "'")
{
$out .= $sql[$i];
$i++;
continue;
}
break;
}
}
continue;
}
// Skip dollar-quoted literals
if ($ch === '$')
{
$j = $i + 1;
while ($j < $n)
{
$c = $sql[$j];
if (($c >= 'a' && $c <= 'z') || ($c >= 'A' && $c <= 'Z') || ($c >= '0' && $c <= '9') || $c === '_')
{
$j++;
continue;
}
break;
}
if ($j < $n && $sql[$j] === '$')
{
$tag = substr($sql, $i, $j - $i + 1);
$k = strpos($sql, $tag, $j + 1);
if ($k !== false)
{
$out .= substr($sql, $i, $k - $i + strlen($tag));
$i = $k + strlen($tag);
continue;
}
}
}
// Skip line comments
if ($ch === '-' && ($i + 1 < $n) && $sql[$i + 1] === '-')
{
$k = strpos($sql, "\n", $i + 2);
if ($k === false)
{
$out .= substr($sql, $i);
break;
}
$out .= substr($sql, $i, $k - $i + 1);
$i = $k + 1;
continue;
}
// Skip block comments
if ($ch === '/' && ($i + 1 < $n) && $sql[$i + 1] === '*')
{
$k = strpos($sql, '*/', $i + 2);
if ($k === false)
{
$out .= substr($sql, $i);
break;
}
$out .= substr($sql, $i, $k - $i + 2);
$i = $k + 2;
continue;
}
// Replace prefix in identifiers and other SQL tokens (not in literals/comments)
if ($pl > 0 && substr($sql, $i, $pl) === $prefix)
{
$out .= $this->tablePrefix;
$i += $pl;
continue;
}
$out .= $ch;
$i++;
}
return $out;
}
public function close()
{
$return = false;
if (is_object($this->cursor))
{
try
{
$this->cursor->closeCursor();
}
catch (Throwable $e)
{
}
$this->cursor = null;
}
if (is_object($this->connection))
{
$this->connection = null;
$return = true;
}
return $return;
}
public function connected()
{
if (is_object($this->connection))
{
try
{
$this->connection->query('SELECT 1');
return true;
}
catch (PDOException $e)
{
}
}
return false;
}
public function escape($text, $extra = false)
{
if (is_object($this->connection))
{
$result = substr($this->connection->quote($text), 1, -1);
}
else
{
$result = str_replace("'", "''", $text);
}
if ($extra)
{
$result = addcslashes($result, '%_');
}
return $result;
}
public function fetchAssoc($cursor = null)
{
$cursor = $cursor ?: $this->cursor;
if (is_object($cursor))
{
return $cursor->fetch(PDO::FETCH_ASSOC);
}
return null;
}
public function freeResult($cursor = null)
{
$cursor = $cursor ?: $this->cursor;
if (is_object($cursor))
{
$cursor->closeCursor();
}
}
public function getAffectedRows()
{
if (is_object($this->cursor))
{
return $this->cursor->rowCount();
}
return 0;
}
public function getNumRows($cursor = null)
{
$cursor = $cursor ?: $this->cursor;
if (is_object($cursor))
{
return $cursor->rowCount();
}
return 0;
}
public function getQuery($new = false)
{
if ($new || empty($this->sql))
{
return new QueryPostgresql($this);
}
return $this->sql;
}
public function createQuery()
{
return new QueryPostgresql($this);
}
public function getVersion()
{
return $this->connection->getAttribute(PDO::ATTR_SERVER_VERSION);
}
public function hasUTF()
{
return true;
}
public function insertid()
{
return $this->connection->lastInsertId();
}
public function loadNextObject($class = 'stdClass')
{
if ($row = $this->fetchObject($this->cursor, $class))
{
return $row;
}
$this->freeResult();
return false;
}
public function loadNextRow()
{
if ($row = $this->fetchArray($this->cursor))
{
return $row;
}
$this->freeResult();
return false;
}
public function open()
{
if ($this->connected())
{
return;
}
else
{
$this->close();
}
$dsn = "pgsql:host={$this->host};port={$this->port};dbname={$this->_database}";
if (!empty($this->options['schema']))
{
$dsn .= ";options='--search_path=" . addslashes((string)$this->options['schema']) . "'";
}
try
{
$this->connection = new PDO(
$dsn,
$this->user,
$this->password,
$this->driverOptions
);
}
catch (PDOException $e)
{
$this->errorNum = 2;
$this->errorMsg = 'Could not connect to PostgreSQL via PDO: ' . $e->getMessage();
return;
}
$this->connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$this->connection->setAttribute(PDO::ATTR_EMULATE_PREPARES, true);
if (!empty($this->charset))
{
$this->connection->exec("SET client_encoding TO " . $this->connection->quote($this->charset));
}
$this->freeResult();
}
public function query()
{
if (!is_object($this->connection))
{
$this->open();
}
$this->freeResult();
// Take a local copy so that we don't modify the original query and cause issues later
$query = $this->replacePrefix((string)$this->sql);
// Apply query limit and offset, if specified
if ($this->limit > 0 || $this->offset > 0)
{
if ($this->limit > 0)
{
$query .= ' LIMIT ' . $this->limit;
}
if ($this->offset > 0)
{
$query .= ' OFFSET ' . $this->offset;
}
}
// Increment the query counter.
$this->count++;
// If debugging is enabled then let's log the query.
if ($this->debug)
{
// Add the query to the object queue.
$this->log[] = $query;
}
// Reset the error values.
$this->errorNum = 0;
$this->errorMsg = '';
// Execute the query. Error suppression is used here to prevent warnings/notices that the connection has been lost.
try
{
$this->cursor = $this->connection->query($query);
}
catch (Throwable $e)
{
}
// If an error occurred handle it.
if (!$this->cursor)
{
$errorInfo = $this->connection->errorInfo();
$this->errorNum = $errorInfo[1];
$this->errorMsg = $errorInfo[2] . ' SQL=' . $query;
// Check if the server was disconnected.
if (!$this->connected() && !$this->isReconnecting)
{
$this->isReconnecting = true;
try
{
// Attempt to reconnect.
$this->connection = null;
$this->open();
}
// If connect fails, ignore that exception and throw the normal exception.
catch (RuntimeException $e)
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
// Since we were able to reconnect, run the query again.
$result = $this->query();
$this->isReconnecting = false;
return $result;
}
// The server was not disconnected.
else
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
}
return $this->cursor;
}
public function select($database)
{
$this->_database = $database;
$this->open();
return true;
}
public function setUTF()
{
$this->connection->exec("SET client_encoding TO 'UTF8'");
}
public function transactionCommit()
{
$this->connection->commit();
}
public function transactionRollback()
{
$this->connection->rollBack();
}
public function transactionStart()
{
$this->connection->beginTransaction();
}
public function fetchArray($cursor = null)
{
$cursor = $cursor ?: $this->cursor;
if (is_object($cursor))
{
return $cursor->fetch(PDO::FETCH_NUM);
}
return null;
}
public function fetchObject($cursor = null, $class = 'stdClass')
{
$cursor = $cursor ?: $this->cursor;
if (is_object($cursor))
{
return $cursor->fetchObject($class);
}
return null;
}
public function getTableList()
{
$schema = $this->options['schema'] ?? 'public';
$this->setQuery('SELECT tablename FROM pg_catalog.pg_tables WHERE schemaname = ' . $this->quote($schema));
return $this->loadColumn();
}
public function getTableColumns($table, $typeOnly = true)
{
$table = $this->replacePrefix($table);
$schema = $this->options['schema'] ?? 'public';
$sql = "SELECT column_name, data_type
FROM information_schema.columns
WHERE table_schema = " . $this->quote($schema) . "
AND table_name = " . $this->quote($table);
$this->setQuery($sql);
$fields = $this->loadObjectList();
if ($typeOnly)
{
$result = [];
foreach ($fields as $field)
{
$result[$field->column_name] = $field->data_type;
}
return $result;
}
return $fields;
}
public function dropTable($table, $ifExists = true)
{
$query = 'DROP TABLE ' . ($ifExists ? 'IF EXISTS ' : '') . $this->quoteName($table);
$this->setQuery($query)->execute();
}
public function getCollation()
{
$this->setQuery("SELECT datcollate FROM pg_database WHERE datname = " . $this->quote($this->_database));
return $this->loadResult();
}
public function getTableCreate($tables)
{
return [];
}
public function getTableKeys($tables)
{
return [];
}
public function getTables($abstract = true)
{
$tables = $this->getTableList();
$result = [];
foreach ($tables as $table)
{
$name = $abstract ? $this->getAbstract($table) : $table;
$result[$name] = 'table';
}
return $result;
}
public function lockTable($tableName)
{
$this->setQuery('LOCK TABLE ' . $this->quoteName($tableName) . ' IN SHARE MODE')->execute();
}
public function renameTable($oldTable, $newTable, $backup = null, $prefix = null)
{
$query = 'ALTER TABLE ' . $this->quoteName($oldTable) . ' RENAME TO ' . $this->quoteName($newTable);
$this->setQuery($query)->execute();
}
public function unlockTables()
{
return $this;
}
}
PK \`:q :q - vendor/akeeba/engine/engine/Driver/Mysqli.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Mysqli as QueryMysqli;
use Akeeba\Engine\Factory;
use Akeeba\Engine\FixMySQLHostname;
use Exception;
use mysqli_result;
use RuntimeException;
/**
* MySQL Improved (mysqli) database driver for Akeeba Engine
*
* Based on Joomla! Platform 11.2
*/
#[\AllowDynamicProperties]
class Mysqli extends Base
{
use FixMySQLHostname;
/**
* The name of the database driver.
*
* @var string
* @since 11.1
*/
public $name = 'mysqli';
/** @var \mysqli|null The db connection resource */
protected $connection = '';
/** @var mysqli_result|null The database connection cursor from the last query. */
protected $cursor;
/** @var string Hostname */
protected $host;
/**
* The character(s) used to quote SQL statement names such as table names or field names,
* etc.
*
* @var string
* @since 11.1
*/
protected $nameQuote = '`';
/**
* The null or zero representation of a timestamp for the database driver.
*
* @var string
* @since 11.1
*/
protected $nullDate = '0000-00-00 00:00:00';
/** @var string Password */
protected $password;
protected $port;
/** @var bool Should I select a database? */
protected $selectDatabase;
protected $socket;
protected $ssl = [];
/** @var string Username */
protected $user;
/** @var bool Are we in the process of reconnecting to the database server? */
private $isReconnecting = false;
/** @var array|null A cache of the tables contained in the currently connected database */
public $tablesCache = null;
/**
* Database object constructor
*
* @param array $options List of options used to configure the connection
*/
public function __construct($options)
{
$this->driverType = 'mysql';
// Init
$this->nameQuote = '`';
$options['ssl'] = $options['ssl'] ?? [];
$options['ssl'] = is_array($options['ssl']) ? $options['ssl'] : [];
$options['ssl']['enable'] = ($options['ssl']['enable'] ?? $options['dbencryption'] ?? false) ?: false;
$options['ssl']['cipher'] = ($options['ssl']['cipher'] ?? $options['dbsslcipher'] ?? null) ?: null;
$options['ssl']['ca'] = ($options['ssl']['ca'] ?? $options['dbsslca'] ?? null) ?: null;
$options['ssl']['capath'] = ($options['ssl']['capath'] ?? $options['dbsslcapath'] ?? null) ?: null;
$options['ssl']['key'] = ($options['ssl']['key'] ?? $options['dbsslkey'] ?? null) ?: null;
$options['ssl']['cert'] = ($options['ssl']['cert'] ?? $options['dbsslcert'] ?? null) ?: null;
$options['ssl']['verify_server_cert'] = ($options['ssl']['verify_server_cert'] ?? $options['dbsslverifyservercert'] ?? false) ?: false;
// Figure out if a port is included in the host name
$this->fixHostnamePortSocket($options['host'], $options['port'], $options['socket']);
// Set the information
$this->host = $options['host'] ?? 'localhost';
$this->user = $options['user'] ?? '';
$this->password = $options['password'] ?? '';
$this->port = $options['port'] ?? '';
$this->socket = $options['socket'] ?? '';
$this->_database = $options['database'] ?? '';
$this->selectDatabase = $options['select'] ?? true;
$this->ssl = $options['ssl'] ?? [];
// Finalize initialization.
parent::__construct($options);
// Open the connection.
$this->open();
}
/**
* Test to see if the MySQL connector is available.
*
* @return boolean True on success, false otherwise.
*/
public static function isSupported()
{
return (function_exists('mysqli_connect'));
}
public function close()
{
$return = false;
if (is_object($this->cursor) && ($this->cursor instanceof mysqli_result))
{
try
{
@$this->cursor->free();
}
catch (\Throwable $e)
{
}
$this->cursor = null;
}
if (is_object($this->connection) && ($this->connection instanceof \mysqli))
{
try
{
$return = @$this->connection->close();
}
catch (\Throwable $e)
{
$return = false;
}
}
$this->connection = null;
return $return;
}
/**
* Determines if the connection to the server is active.
*
* @return boolean True if connected to the database engine.
*/
public function connected()
{
if (!is_object($this->connection))
{
return false;
}
// mysqli_ping is deprecated since PHP 8.4.
if (version_compare(PHP_VERSION, '8.4.0', '<'))
{
try
{
return @mysqli_ping($this->connection);
}
catch (\Throwable $e)
{
return false;
}
}
try
{
$cursor = @mysqli_query($this->connection, 'SELECT 1');
if (!$cursor)
{
return false;
}
mysqli_free_result($cursor);
return true;
}
catch (\Throwable $e)
{
return false;
}
}
/**
* Drops a table from the database.
*
* @param string $tableName The name of the database table to drop.
* @param boolean $ifExists Optionally specify that the table must exist before it is dropped.
*
* @return Mysqli Returns this object to support chaining.
*/
public function dropTable($tableName, $ifExists = true)
{
$query = $this->getQuery(true);
$this->setQuery('DROP TABLE ' . ($ifExists ? 'IF EXISTS ' : '') . $query->quoteName($tableName));
$this->query();
return $this;
}
/**
* Method to escape a string for usage in an SQL statement.
*
* @param string $text The string to be escaped.
* @param boolean $extra Optional parameter to provide extra escaping.
*
* @return string The escaped string.
*/
public function escape($text, $extra = false)
{
if (is_null($text))
{
return 'NULL';
}
$result = @mysqli_real_escape_string($this->getConnection(), $text);
if ($result === false)
{
// Attempt to reconnect.
try
{
$this->connection = null;
$this->open();
$result = @mysqli_real_escape_string($this->getConnection(), $text);;
}
catch (RuntimeException $e)
{
$result = $this->unsafe_escape($text);
}
}
if ($extra)
{
$result = addcslashes($result, '%_');
}
return $result;
}
/**
* Method to fetch a row from the result set cursor as an associative array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
public function fetchAssoc($cursor = null)
{
return mysqli_fetch_assoc($cursor ?: $this->cursor);
}
/**
* Method to free up the memory used for the result set.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return void
*/
public function freeResult($cursor = null)
{
mysqli_free_result($cursor ?: $this->cursor);
}
/**
* Get the number of affected rows for the previous executed SQL statement.
*
* @return integer The number of affected rows.
*/
public function getAffectedRows()
{
return mysqli_affected_rows($this->connection);
}
/**
* Method to get the database collation in use by sampling a text field of a table in the database.
*
* @return mixed The collation in use by the database (string) or boolean false if not supported.
*/
public function getCollation()
{
$this->setQuery('SHOW FULL COLUMNS FROM #__ak_stats');
$array = $this->loadAssocList();
return $array['2']['Collation'];
}
/**
* Get the number of returned rows for the previous executed SQL statement.
*
* @param mysqli_result $cursor An optional database cursor resource to extract the row count from.
*
* @return integer The number of returned rows.
*/
public function getNumRows($cursor = null)
{
return mysqli_num_rows($cursor ?: $this->cursor);
}
/**
* Get the current or query, or new JDatabaseQuery object.
*
* @param boolean $new False to return the last query set, True to return a new JDatabaseQuery object.
*
* @return mixed The current value of the internal SQL variable or a new JDatabaseQuery object.
*/
public function getQuery($new = false)
{
if ($new)
{
return new QueryMysqli($this);
}
else
{
return $this->sql;
}
}
public function createQuery()
{
return new QueryMysqli($this);
}
/**
* Retrieves field information about a given table.
*
* @param string $table The name of the database table.
* @param boolean $typeOnly True to only return field types.
*
* @return array An array of fields for the database table.
*/
public function getTableColumns($table, $typeOnly = true)
{
$result = [];
// Set the query to get the table fields statement.
$this->setQuery('SHOW FULL COLUMNS FROM ' . $this->quoteName($this->escape($table)));
$fields = $this->loadObjectList();
// If we only want the type as the value add just that to the list.
if ($typeOnly)
{
foreach ($fields as $field)
{
$result[$field->Field] = preg_replace("/[(0-9)]/", '', $field->Type);
}
}
// If we want the whole field data object add that to the list.
else
{
foreach ($fields as $field)
{
$result[$field->Field] = $field;
}
}
return $result;
}
/**
* Shows the table CREATE statement that creates the given tables.
*
* @param mixed $tables A table name or a list of table names.
*
* @return array A list of the create SQL for the tables.
*/
public function getTableCreate($tables)
{
// Initialise variables.
$result = [];
// Sanitize input to an array and iterate over the list.
$tables = (array) $tables;
foreach ($tables as $table)
{
// Set the query to get the table CREATE statement.
$this->setQuery('SHOW CREATE table ' . $this->quoteName($this->escape($table)));
$row = $this->loadRow();
// Populate the result array based on the create statements.
$result[$table] = $row[1];
}
return $result;
}
/**
* Get the details list of keys for a table.
*
* @param string $table The name of the table.
*
* @return array An array of the column specification for the table.
*/
public function getTableKeys($table)
{
// Get the details columns information.
$this->setQuery('SHOW KEYS FROM ' . $this->quoteName($table));
$keys = $this->loadObjectList();
return $keys;
}
/**
* Method to get an array of all tables in the database.
*
* @return array An array of all the tables in the database.
*/
public function getTableList()
{
// Set the query to get the tables statement.
$this->setQuery('SHOW TABLES');
$tables = $this->loadColumn();
return $tables;
}
/**
* Returns an array with the names of tables, views, procedures, functions and triggers
* in the database. The table names are the keys of the tables, whereas the value is
* the type of each element: table, view, merge, temp, procedure, function or trigger.
* Note that merge are MRG_MYISAM tables and temp is non-permanent data table, usually
* set up as temporary, black hole or federated tables. These two types should never,
* ever, have their data dumped in the SQL dump file.
*
* @param bool $abstract Return abstract or normal names? Defaults to true (abstract names)
*
* @return array
*/
public function getTables($abstract = true)
{
if (!empty($this->tablesCache[$this->_database]))
{
return $this->tablesCache[$this->_database];
}
$sql = "SHOW TABLES";
$this->setQuery($sql);
$all_tables = $this->loadColumn();
if (!empty($all_tables))
{
// Start by adding tables and views to the list
foreach ($all_tables as $table_name)
{
if ($abstract)
{
$table_name = $this->getAbstract($table_name);
}
$this->tablesCache[$this->_database][$table_name] = 'table';
}
// Loop all metadatas
foreach ($all_tables as $table_metadata)
{
$table_name = $table_metadata;
$table_abstract = $this->getAbstract($table_metadata);
$type = 'table';
if ($abstract)
{
$table_metadata = $table_abstract;
}
$create = $this->get_create($table_abstract, $table_name, $type);
// Scan for the table engine.
$engine = null; // So that we detect VIEWs correctly
if ($type == 'table')
{
$engine = 'MyISAM'; // So that even with MySQL 4 hosts we don't screw this up
$engine_keys = ['ENGINE=', 'TYPE='];
foreach ($engine_keys as $engine_key)
{
$start_pos = strrpos($create, $engine_key);
if ($start_pos !== false)
{
// Advance the start position just after the position of the ENGINE keyword
$start_pos += strlen($engine_key);
// Try to locate the space after the engine type
$end_pos = stripos($create, ' ', $start_pos);
if ($end_pos === false)
{
// Uh... maybe it ends with ENGINE=EngineType;
$end_pos = stripos($create, ';');
}
if ($end_pos !== '')
{
// Grab the string
$engine = substr($create, $start_pos, $end_pos - $start_pos);
}
}
}
$engine = strtoupper($engine);
}
switch ($engine)
{
// Views -- FIX: They are detected based on their CREATE STATEMENT
case null:
$this->tablesCache[$this->_database][$table_metadata] = 'view';
break;
// Merge tables
case 'MRG_MYISAM':
$this->tablesCache[$this->_database][$table_metadata] = 'merge';
break;
// Tables whose data we do not back up (memory, federated and can-have-no-data tables)
case 'MEMORY':
case 'EXAMPLE':
case 'BLACKHOLE':
case 'FEDERATED':
$this->tablesCache[$this->_database][$table_metadata] = 'temp';
break;
// Normal tables
default:
break;
} // switch
} // foreach
} // if !empty
// If we have MySQL > 5.0 add the list of stored procedures, stored functions
// and triggers
$registry = Factory::getConfiguration();
$enable_entities = $registry->get('engine.dump.native.advanced_entitites', true);
if ($enable_entities)
{
// 1. Stored procedures
$sql = "SHOW PROCEDURE STATUS WHERE " . $this->quoteName('Db') . "=" . $this->quote($this->_database);
$this->setQuery($sql);
try
{
$all_entries = $this->loadAssocList();
}
catch (Exception $e)
{
$all_entries = [];
}
if (is_array($all_entries) || $all_entries instanceof \Countable ? count($all_entries) : 0)
{
foreach ($all_entries as $entry)
{
$table_name = $entry['Name'];
if ($abstract)
{
$table_name = $this->getAbstract($table_name);
}
$this->tablesCache[$this->_database][$table_name] = 'procedure';
}
}
// 2. Stored functions
$sql = "SHOW FUNCTION STATUS WHERE " . $this->quoteName('Db') . "=" . $this->quote($this->_database);
$this->setQuery($sql);
try
{
$all_entries = $this->loadColumn(1);
}
catch (Exception $e)
{
$all_entries = [];
}
// If we have filters, make sure the tables pass the filtering
if (is_array($all_entries))
{
if (count($all_entries))
{
foreach ($all_entries as $table_name)
{
if ($abstract)
{
$table_name = $this->getAbstract($table_name);
}
$this->tablesCache[$this->_database][$table_name] = 'function';
}
}
}
// 3. Triggers
$sql = "SHOW TRIGGERS";
$this->setQuery($sql);
try
{
$all_entries = $this->loadColumn();
}
catch (Exception $e)
{
$all_entries = [];
}
// If we have filters, make sure the tables pass the filtering
if (is_array($all_entries))
{
if (count($all_entries))
{
foreach ($all_entries as $table_name)
{
if ($abstract)
{
$table_name = $this->getAbstract($table_name);
}
$this->tablesCache[$this->_database][$table_name] = 'trigger';
}
}
}
}
return $this->tablesCache[$this->_database];
}
/**
* Get the version of the database connector.
*
* @return string The database connector version.
*/
public function getVersion()
{
return mysqli_get_server_info($this->connection);
}
/**
* Determines if the database engine supports UTF-8 character encoding.
*
* @return boolean True if supported.
*/
public function hasUTF()
{
$mariadb = stripos($this->connection->server_info, 'mariadb') !== false;
$client_version = mysqli_get_client_info();
$server_version = $this->getVersion();
if (version_compare($server_version, '5.5.3', '<'))
{
return false;
}
if ($mariadb && version_compare($server_version, '10.0.0', '<'))
{
return false;
}
if (strpos($client_version, 'mysqlnd') !== false)
{
$client_version = preg_replace('/^\D+([\d.]+).*/', '$1', $client_version);
return version_compare($client_version, '5.0.9', '>=');
}
return version_compare($client_version, '5.5.3', '>=');
}
/**
* Method to get the auto-incremented value from the last INSERT statement.
*
* @return integer The value of the auto-increment field from the last inserted row.
*/
public function insertid()
{
return mysqli_insert_id($this->connection);
}
/**
* Locks a table in the database.
*
* @param string $table The name of the table to unlock.
*
* @return Mysqli Returns this object to support chaining.
*/
public function lockTable($table)
{
$this->setQuery('LOCK TABLES ' . $this->quoteName($table) . ' WRITE')->query();
return $this;
}
public function open()
{
if ($this->connected())
{
return;
}
else
{
$this->close();
}
// perform a number of fatality checks, then return gracefully
if (!function_exists('mysqli_connect'))
{
$this->errorNum = 1;
$this->errorMsg = 'The MySQL adapter "mysqli" is not available.';
return;
}
// Let's prepare a connection
$this->connection = mysqli_init();
$connectionFlags = 0;
// For SSL/TLS connection encryption.
if ($this->ssl !== [] && $this->ssl['enable'] === true)
{
$connectionFlags = $connectionFlags | MYSQLI_CLIENT_SSL;
// Verify server certificate is only available in PHP 5.6.16+. See https://www.php.net/ChangeLog-5.php#5.6.16
if (isset($this->ssl['verify_server_cert']))
{
// New constants in PHP 5.6.16+. See https://www.php.net/ChangeLog-5.php#5.6.16
if ($this->ssl['verify_server_cert'] === true && defined('MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT'))
{
$connectionFlags = $connectionFlags | MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT;
}
elseif ($this->ssl['verify_server_cert'] === false && defined('MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT'))
{
$connectionFlags = $connectionFlags | MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT;
}
elseif (defined('MYSQLI_OPT_SSL_VERIFY_SERVER_CERT'))
{
$this->connection->options(MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, $this->ssl['verify_server_cert']);
}
}
// Add SSL/TLS options only if changed.
$this->connection->ssl_set(
($this->ssl['key'] ?? null) ?: null,
($this->ssl['cert'] ?? null) ?: null,
($this->ssl['ca'] ?? null) ?: null,
($this->ssl['capath'] ?? null) ?: null,
($this->ssl['cipher'] ?? null) ?: null
);
}
// Attempt to connect to the server, use error suppression to silence warnings and allow us to throw an Exception separately.
try
{
$connected = @$this->connection->real_connect(
$this->host,
$this->user,
$this->password ?: null,
null,
$this->port ?: 3306,
$this->socket ?: null,
$connectionFlags
);
}
catch (\Throwable $e)
{
$connected = false;
}
// connect to the server
if (!$connected)
{
$this->errorNum = 2;
$this->errorMsg = 'Could not connect to MySQL';
return;
}
// Set sql_mode to non_strict mode
mysqli_query($this->connection, "SET @@SESSION.sql_mode = '';");
if ($this->selectDatabase && !empty($this->_database))
{
if (!$this->select($this->_database))
{
$this->errorNum = 3;
$this->errorMsg = "Cannot select database {$this->_database}";
return;
}
}
$this->setUTF();
}
/**
* Execute the SQL statement.
*
* @return mixed A database cursor resource on success, boolean false on failure.
*/
public function query()
{
$this->open();
if (!is_object($this->connection))
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
// Take a local copy so that we don't modify the original query and cause issues later
$query = $this->replacePrefix((string) $this->sql);
if ($this->limit > 0 || $this->offset > 0)
{
$query .= ' LIMIT ' . $this->offset . ', ' . $this->limit;
}
// Increment the query counter.
$this->count++;
// If debugging is enabled then let's log the query.
if ($this->debug)
{
// Add the query to the object queue.
$this->log[] = $query;
}
// Reset the error values.
$this->errorNum = 0;
$this->errorMsg = '';
// Execute the query. Error suppression is used here to prevent warnings/notices that the connection has been lost.
$this->cursor = @mysqli_query($this->connection, $query);
// If an error occurred handle it.
if (!$this->cursor)
{
$this->errorNum = 0;
$this->errorMsg = '';
if ($this->connection)
{
$this->errorNum = (int) @mysqli_errno($this->connection);
$this->errorMsg = (string) @mysqli_error($this->connection) . ' SQL=' . $query;
}
// Check if the server was disconnected.
if (!$this->connected() && !$this->isReconnecting)
{
$this->isReconnecting = true;
try
{
// Attempt to reconnect.
$this->connection = null;
$this->open();
}
// If connect fails, ignore that exception and throw the normal exception.
catch (RuntimeException $e)
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
// Since we were able to reconnect, run the query again.
$result = $this->query();
$this->isReconnecting = false;
return $result;
}
// The server was not disconnected.
elseif ($this->errorNum != 0)
{
throw new RuntimeException($this->errorMsg, $this->errorNum);
}
}
return $this->cursor;
}
/**
* Renames a table in the database.
*
* @param string $oldTable The name of the table to be renamed
* @param string $newTable The new name for the table.
* @param string $backup Not used by MySQL.
* @param string $prefix Not used by MySQL.
*
* @return Mysqli Returns this object to support chaining.
*/
public function renameTable($oldTable, $newTable, $backup = null, $prefix = null)
{
$this->setQuery('RENAME TABLE ' . $oldTable . ' TO ' . $newTable)->query();
return $this;
}
/**
* Select a database for use.
*
* @param string $database The name of the database to select for use.
*
* @return boolean True if the database was successfully selected.
*/
public function select($database)
{
if (!$database)
{
return false;
}
if (!mysqli_select_db($this->connection, $database))
{
return false;
}
return true;
}
/**
* Set the connection to use UTF-8 character encoding.
*
* @return boolean True on success.
*/
public function setUTF()
{
$result = false;
if ($this->supportsUtf8mb4())
{
$result = @mysqli_set_charset($this->connection, 'utf8mb4');
}
if (!$result)
{
$result = @mysqli_set_charset($this->connection, 'utf8');
}
return $result;
}
/**
* Method to commit a transaction.
*
* @return void
*/
public function transactionCommit()
{
$this->setQuery('COMMIT');
$this->execute();
}
/**
* Method to roll back a transaction.
*
* @return void
*/
public function transactionRollback()
{
$this->setQuery('ROLLBACK');
$this->execute();
}
/**
* Method to initialize a transaction.
*
* @return void
*/
public function transactionStart()
{
$this->setQuery('START TRANSACTION');
$this->execute();
}
/**
* Unlocks tables in the database.
*
* @return Mysqli Returns this object to support chaining.
*
* @throws Exception
* @since 11.4
*/
public function unlockTables()
{
$this->setQuery('UNLOCK TABLES')->execute();
return $this;
}
/**
* Method to fetch a row from the result set cursor as an array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
protected function fetchArray($cursor = null)
{
return mysqli_fetch_row($cursor ?: $this->cursor);
}
/**
* Method to fetch a row from the result set cursor as an object.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
* @param string $class The class name to use for the returned row object.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
protected function fetchObject($cursor = null, $class = 'stdClass')
{
return mysqli_fetch_object($cursor ?: $this->cursor, $class);
}
/**
* Gets the CREATE TABLE command for a given table/view
*
* @param string $table_abstract The abstracted name of the entity
* @param string $table_name The name of the table
* @param string $type The type of the entity to scan. If it's found to differ, the correct type is
* returned.
*
* @return string The CREATE command, w/out newlines
*/
protected function get_create($table_abstract, $table_name, &$type)
{
$sql = "SHOW CREATE TABLE " . $this->quoteName($table_name);
$this->setQuery($sql);
$temp = $this->loadRowList();
$table_sql = $temp[0][1];
unset($temp);
// Smart table type detection
if (in_array($type, ['table', 'merge', 'view']))
{
// Check for CREATE VIEW
$pattern = '/^CREATE(.*) VIEW (.*)/i';
$result = preg_match($pattern, $table_sql);
if ($result === 1)
{
// This is a view.
$type = 'view';
}
else
{
// This is a table.
$type = 'table';
}
// Is it a VIEW but we don't have SHOW VIEW privileges?
if (empty($table_sql))
{
$type = 'view';
}
}
$table_sql = str_replace($table_name, $table_abstract, $table_sql);
// Replace newlines with spaces
$table_sql = str_replace("\n", " ", $table_sql) . ";\n";
$table_sql = str_replace("\r", " ", $table_sql);
$table_sql = str_replace("\t", " ", $table_sql);
// Post-process CREATE VIEW
if ($type == 'view')
{
$pos_view = strpos($table_sql, ' VIEW ');
if ($pos_view > 7)
{
// Only post process if there are view properties between the CREATE and VIEW keywords
$propstring = substr($table_sql, 7, $pos_view - 7); // Properties string
// Fetch the ALGORITHM={UNDEFINED | MERGE | TEMPTABLE} keyword
$algostring = '';
$algo_start = strpos($propstring, 'ALGORITHM=');
if ($algo_start !== false)
{
$algo_end = strpos($propstring, ' ', $algo_start);
$algostring = substr($propstring, $algo_start, $algo_end - $algo_start + 1);
}
// Create our modified create statement
$table_sql = 'CREATE OR REPLACE ' . $algostring . substr($table_sql, $pos_view);
}
}
return $table_sql;
}
/**
* Does this database server support UTF-8 four byte (utf8mb4) collation?
*
* libmysql supports utf8mb4 since 5.5.3 (same version as the MySQL server). mysqlnd supports utf8mb4 since 5.0.9.
*
* This method's code is based on WordPress' wpdb::has_cap() method
*
* @return bool
*/
public function supportsUtf8mb4()
{
$client_version = mysqli_get_client_info();
if (strpos($client_version, 'mysqlnd') !== false)
{
$client_version = preg_replace('/^\D+([\d.]+).*/', '$1', $client_version);
return version_compare($client_version, '5.0.9', '>=');
}
else
{
return version_compare($client_version, '5.5.3', '>=');
}
}
protected function unsafe_escape($string)
{
if (function_exists('mb_ereg_replace'))
{
return mb_ereg_replace('[\x00\x0A\x0D\x1A\x22\x27\x5C]', '\\\0', $string);
}
return preg_replace('~[\x00\x0A\x0D\x1A\x22\x27\x5C]~u', '\\\$0', $string);
}
}
PK \T# T# + vendor/akeeba/engine/engine/Driver/None.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Base as QueryBase;
/**
* Dummy driver class for flat-file CMS
*/
#[\AllowDynamicProperties]
class None extends Base
{
public static $dbtech = 'none';
/**
* The name of the database driver.
*
* @var string
* @since 1.0
*/
public $name = 'none';
public function __construct(array $options)
{
$this->driverType = 'none';
parent::__construct($options);
}
/**
* Test to see if this db driver is available
*
* @return boolean True on success, false otherwise.
*
* @since 1.0
*/
public static function isSupported()
{
return true;
}
public function open()
{
return $this;
}
/**
* Closes the database connection
*/
public function close()
{
return;
}
/**
* Determines if the connection to the server is active.
*
* @return boolean True if connected to the database engine.
*/
public function connected()
{
return true;
}
/**
* Drops a table from the database.
*
* @param string $table The name of the database table to drop.
* @param boolean $ifExists Optionally specify that the table must exist before it is dropped.
*
* @return Base Returns this object to support chaining.
*/
public function dropTable($table, $ifExists = true)
{
return $this;
}
/**
* Method to escape a string for usage in an SQL statement.
*
* @param string $text The string to be escaped.
* @param boolean $extra Optional parameter to provide extra escaping.
*
* @return string The escaped string.
*/
public function escape($text, $extra = false)
{
return '';
}
/**
* Method to fetch a row from the result set cursor as an associative array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
public function fetchAssoc($cursor = null)
{
return false;
}
/**
* Method to free up the memory used for the result set.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return void
*/
public function freeResult($cursor = null)
{
return;
}
/**
* Get the number of affected rows for the previous executed SQL statement.
*
* @return integer The number of affected rows.
*/
public function getAffectedRows()
{
return 0;
}
/**
* Method to get the database collation in use by sampling a text field of a table in the database.
*
* @return mixed The collation in use by the database or boolean false if not supported.
*/
public function getCollation()
{
return false;
}
/**
* Get the number of returned rows for the previous executed SQL statement.
*
* @param resource $cursor An optional database cursor resource to extract the row count from.
*
* @return integer The number of returned rows.
*/
public function getNumRows($cursor = null)
{
return 0;
}
/**
* Get the current query object or a new QueryBase object.
*
* @param boolean $new False to return the current query object, True to return a new QueryBase object.
*
* @return QueryBase The current query object or a new object extending the QueryBase class.
*/
public function getQuery($new = false)
{
return $this->sql;
}
public function createQuery()
{
return $this->sql;
}
/**
* Retrieves field information about the given tables.
*
* @param string $table The name of the database table.
* @param boolean $typeOnly True (default) to only return field types.
*
* @return array An array of fields by table.
*/
public function getTableColumns($table, $typeOnly = true)
{
return [];
}
/**
* Shows the table CREATE statement that creates the given tables.
*
* @param mixed $tables A table name or a list of table names.
*
* @return array A list of the create SQL for the tables.
*/
public function getTableCreate($tables)
{
return [];
}
/**
* Retrieves field information about the given tables.
*
* @param mixed $tables A table name or a list of table names.
*
* @return array An array of keys for the table(s).
*/
public function getTableKeys($tables)
{
return [];
}
/**
* Method to get an array of all tables in the database.
*
* @return array An array of all the tables in the database.
*/
public function getTableList()
{
return [];
}
/**
* Returns an array with the names of tables, views, procedures, functions and triggers
* in the database. The table names are the keys of the tables, whereas the value is
* the type of each element: table, view, merge, temp, procedure, function or trigger.
* Note that merge are MRG_MYISAM tables and temp is non-permanent data table, usually
* set up as temporary, black hole or federated tables. These two types should never,
* ever, have their data dumped in the SQL dump file.
*
* @param bool $abstract Return or normal names? Defaults to true (names)
*
* @return array
*/
public function getTables($abstract = true)
{
return [];
}
/**
* Get the version of the database connector
*
* @return string The database connector version.
*/
public function getVersion()
{
return '0.0.0';
}
/**
* Method to get the auto-incremented value from the last INSERT statement.
*
* @return integer The value of the auto-increment field from the last inserted row.
*/
public function insertid()
{
return 0;
}
/**
* Locks a table in the database.
*
* @param string $tableName The name of the table to unlock.
*
* @return Base Returns this object to support chaining.
*/
public function lockTable($tableName)
{
return $this;
}
/**
* Execute the SQL statement.
*
* @return mixed A database cursor resource on success, boolean false on failure.
*/
public function query()
{
return false;
}
/**
* Renames a table in the database.
*
* @param string $oldTable The name of the table to be renamed
* @param string $newTable The new name for the table.
* @param string $backup Table prefix
* @param string $prefix For the table - used to rename constraints in non-mysql databases
*
* @return Base Returns this object to support chaining.
*/
public function renameTable($oldTable, $newTable, $backup = null, $prefix = null)
{
return $this;
}
/**
* Select a database for use.
*
* @param string $database The name of the database to select for use.
*
* @return boolean True if the database was successfully selected.
*/
public function select($database)
{
return true;
}
/**
* Set the connection to use UTF-8 character encoding.
*
* @return boolean True on success.
*/
public function setUTF()
{
return true;
}
/**
* Method to commit a transaction.
*
* @return void
*/
public function transactionCommit()
{
return;
}
/**
* Method to roll back a transaction.
*
* @return void
*/
public function transactionRollback()
{
return;
}
/**
* Method to initialize a transaction.
*
* @return void
*/
public function transactionStart()
{
return;
}
/**
* Unlocks tables in the database.
*
* @return Base Returns this object to support chaining.
*/
public function unlockTables()
{
return $this;
}
/**
* Method to fetch a row from the result set cursor as an array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
protected function fetchArray($cursor = null)
{
return false;
}
/**
* Method to fetch a row from the result set cursor as an object.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
* @param string $class The class name to use for the returned row object.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
protected function fetchObject($cursor = null, $class = 'stdClass')
{
return false;
}
}
PK \ + vendor/akeeba/engine/engine/Driver/Base.phpnu [ .
*/
namespace Akeeba\Engine\Driver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\Query\Base as QueryBase;
use RuntimeException;
/**
* Database driver superclass. Used as the base of all Akeeba Engine database drivers.
* Strongly based on Joomla Platform's JDatabase class.
*
* @method qn(string $name, string $as = null) Alias for quoteName
* @method q(string $text, bool $escape = true) Alias for quote
*/
#[\AllowDynamicProperties]
abstract class Base
{
/** @var string The minimum supported database version. */
protected static $dbMinimum;
/** @var array JDatabaseDriver instances container. */
protected static $instances = [];
/** @var string The name of the database driver. */
public $name;
/** @var string The name of the database. */
protected $_database;
/** @var resource The db connection resource */
protected $connection = '';
/** @var integer The number of SQL statements executed by the database driver. */
protected $count = 0;
/** @var resource The database connection cursor from the last query. */
protected $cursor;
/** @var boolean The database driver debugging state. */
protected $debug = false;
/** @var string Driver type. This should always be mysql as we don't support anything else anymore. */
protected $driverType = '';
/** @var string The db server's error string */
protected $errorMsg = '';
/** @var int The db server's error number */
protected $errorNum = 0;
/** @var int Query's limit */
protected $limit = 0;
/** @var array The log of executed SQL statements by the database driver. */
protected $log = [];
/** @var string Quote for named objects */
protected $nameQuote = '';
/** @var string The null or zero representation of a timestamp for the database driver. */
protected $nullDate;
/** @var int Query's offset */
protected $offset = 0;
/** @var array Passed in upon instantiation and saved. */
protected $options;
/** @var mixed The SQL query string */
protected $sql = '';
/** @var string The prefix used in the database, if any */
protected $tablePrefix = '';
/** @var bool Support for UTF-8 */
protected $utf = true;
/**
* Database object constructor
*
* @param array $options List of options used to configure the connection
*/
public function __construct($options)
{
$prefix = array_key_exists('prefix', $options) ? $options['prefix'] : '';
$database = array_key_exists('database', $options) ? $options['database'] : '';
$connection = array_key_exists('connection', $options) ? $options['connection'] : null;
$this->tablePrefix = $prefix;
$this->_database = $database;
$this->connection = $connection;
$this->errorNum = 0;
$this->count = 0;
$this->log = [];
$this->options = $options;
}
/**
* Is this driver class supported on this server? Child classes are supposed to override this and perform a
* compatibility check.
*
* @return bool True if the driver class is supported on the server
*/
public static function isSupported()
{
return false;
}
/**
* Splits a string of multiple queries into an array of individual queries.
*
* @param string $query Input SQL string with which to split into individual queries.
*
* @return array The queries from the input string separated into an array.
*/
public static function splitSql($query)
{
$start = 0;
$open = false;
$char = '';
$end = strlen($query);
$queries = [];
for ($i = 0; $i < $end; $i++)
{
$current = substr($query, $i, 1);
if (($current == '"' || $current == '\''))
{
$n = 2;
while (substr($query, $i - $n + 1, 1) == '\\' && $n < $i)
{
$n++;
}
if ($n % 2 == 0)
{
if ($open)
{
if ($current == $char)
{
$open = false;
$char = '';
}
}
else
{
$open = true;
$char = $current;
}
}
}
if (($current == ';' && !$open) || $i == $end - 1)
{
$queries[] = substr($query, $start, ($i - $start + 1));
$start = $i + 1;
}
}
return $queries;
}
/**
* Is this driver supported under the current system configuration?
*
* @return bool
*/
public static function test()
{
return self::isSupported();
}
/**
* Magic method to provide method alias support for quote() and quoteName().
*
* @param string $method The called method.
* @param array $args The array of arguments passed to the method.
*
* @return string The aliased method's return value or null.
*/
public function __call($method, $args)
{
if (empty($args))
{
return null;
}
switch ($method)
{
case 'q':
return $this->quote($args[0], $args[1] ?? true);
break;
case 'nq':
case 'qn':
return $this->quoteName($args[0]);
break;
}
return null;
}
/**
* Database object destructor
*
* @return bool
*/
public function __destruct()
{
return $this->close();
}
public function __wakeup()
{
$this->open();
}
/**
* By default, when the object is shutting down, the connection is closed
*/
public function _onSerialize()
{
$this->close();
}
/**
* Alter database's character set, obtaining query string from protected member.
*
* @param string $dbName The database name that will be altered
*
* @return string The query that alter the database query string
*
* @throws RuntimeException
*/
public function alterDbCharacterSet($dbName)
{
if (is_null($dbName))
{
throw new RuntimeException('Database name must not be null.');
}
$this->setQuery($this->getAlterDbCharacterSet($dbName));
return $this->execute();
}
/**
* Closes the database connection
*/
abstract public function close();
/**
* Determines if the connection to the server is active.
*
* @return boolean True if connected to the database engine.
*/
abstract public function connected();
/**
* Create a new database using information from $options object, obtaining query string
* from protected member.
*
* @param object $options Object used to pass user and database name to database driver.
* This object must have "db_name" and "db_user" set.
* @param boolean $utf True if the database supports the UTF-8 character set.
*
* @return string The query that creates database
*
* @throws RuntimeException
*/
public function createDatabase($options, $utf = true)
{
if (is_null($options))
{
throw new RuntimeException('$options object must not be null.');
}
elseif (empty($options->db_name))
{
throw new RuntimeException('$options object must have db_name set.');
}
elseif (empty($options->db_user))
{
throw new RuntimeException('$options object must have db_user set.');
}
$this->setQuery($this->getCreateDatabaseQuery($options, $utf));
return $this->execute();
}
/**
* Drops a table from the database.
*
* @param string $table The name of the database table to drop.
* @param boolean $ifExists Optionally specify that the table must exist before it is dropped.
*
* @return Base Returns this object to support chaining.
*/
public abstract function dropTable($table, $ifExists = true);
/**
* Method to escape a string for usage in an SQL statement.
*
* @param string $text The string to be escaped.
* @param boolean $extra Optional parameter to provide extra escaping.
*
* @return string The escaped string.
*/
abstract public function escape($text, $extra = false);
/**
* An alias for query()
*
* @return mixed A database cursor resource on success, boolean false on failure.
*/
public function execute()
{
return $this->query();
}
/**
* Method to fetch a row from the result set cursor as an associative array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
abstract public function fetchAssoc($cursor = null);
/**
* Method to free up the memory used for the result set.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return void
*/
abstract public function freeResult($cursor = null);
/**
* Returns the abstracted name of a database object
*
* @param string $tableName
*
* @return string
*/
public function getAbstract($tableName)
{
$prefix = $this->getPrefix();
// Don't return abstract names for non-CMS tables
if (is_null($prefix))
{
return $tableName;
}
switch ($prefix)
{
case '':
// This is more of a hack; it assumes all tables are CMS tables if the prefix is empty.
return '#__' . $tableName;
break;
default:
// Normal behaviour for 99% of sites
$tableAbstract = $tableName;
if (!empty($prefix))
{
if (substr($tableName, 0, strlen($prefix)) == $prefix)
{
$tableAbstract = '#__' . substr($tableName, strlen($prefix));
}
else
{
$tableAbstract = $tableName;
}
}
return $tableAbstract;
break;
}
}
/**
* Get the number of affected rows for the previous executed SQL statement.
*
* @return integer The number of affected rows.
*/
abstract public function getAffectedRows();
/**
* Method to get the database collation in use by sampling a text field of a table in the database.
*
* @return mixed The collation in use by the database or boolean false if not supported.
*/
abstract public function getCollation();
/**
* Method that provides access to the underlying database connection.
*
* @return resource The underlying database connection resource.
*/
public function getConnection()
{
return $this->connection;
}
/**
* Inherits the connection of another database driver. Useful for cloning
* the CMS database connection into an Akeeba Engine database driver.
*
* @param resource $connection
*/
public function setConnection($connection)
{
$this->connection = $connection;
}
/**
* Get the total number of SQL statements executed by the database driver.
*
* @return integer
*
* @since 11.1
*/
public function getCount()
{
return $this->count;
}
/**
* Returns a PHP date() function compliant date format for the database driver.
*
* @return string The format string.
*/
public function getDateFormat()
{
return 'Y-m-d H:i:s';
}
/**
* Return the database driver type, e.g. "mysql" for all drivers which can talk to MySQL
*
* @return string
*/
public function getDriverType()
{
return $this->driverType;
}
/**
* Get the error message
*
* @return string The error message for the most recent query
*/
public function getErrorMsg($escaped = false)
{
if ($escaped)
{
return addslashes($this->errorMsg);
}
else
{
return $this->errorMsg;
}
}
/**
* Get the error number
*
* @return int The error number for the most recent query
*/
public function getErrorNum()
{
return $this->errorNum;
}
/**
* Method to escape a string for usage in an SQL statement.
*
* @param string $text The string to be escaped.
* @param boolean $extra Optional parameter to provide extra escaping.
*
* @return string The escaped string.
*/
public function getEscaped($text, $extra = false)
{
return $this->escape($text, $extra);
}
/**
* Get the database driver SQL statement log.
*
* @return array SQL statements executed by the database driver.
*
* @since 11.1
*/
public function getLog()
{
return $this->log;
}
/**
* Get the minimum supported database version.
*
* @return string The minimum version number for the database driver.
*
* @since 12.1
*/
public function getMinimum()
{
return static::$dbMinimum;
}
/**
* Get the null or zero representation of a timestamp for the database driver.
*
* @return string Null or zero representation of a timestamp.
*/
public function getNullDate()
{
return $this->nullDate;
}
/**
* Get the number of returned rows for the previous executed SQL statement.
*
* @param resource $cursor An optional database cursor resource to extract the row count from.
*
* @return integer The number of returned rows.
*/
abstract public function getNumRows($cursor = null);
/**
* Get the database table prefix
*
* @return string The database prefix
*/
public function getPrefix()
{
return $this->tablePrefix;
}
/**
* Get the current query object or a new QueryBase object.
*
* @param boolean $new False to return the current query object, True to return a new QueryBase object.
*
* @return QueryBase The current query object or a new object extending the QueryBase class.
*/
abstract public function getQuery($new = false);
/**
* Create a new QueryBase object.
*
* @return QueryBase The current query object or a new object extending the QueryBase class.
*/
abstract public function createQuery();
/**
* Retrieves field information about the given tables.
*
* @param string $table The name of the database table.
* @param boolean $typeOnly True (default) to only return field types.
*
* @return array An array of fields by table.
*/
abstract public function getTableColumns($table, $typeOnly = true);
/**
* Shows the table CREATE statement that creates the given tables.
*
* @param mixed $tables A table name or a list of table names.
*
* @return array A list of the create SQL for the tables.
*/
abstract public function getTableCreate($tables);
/**
* Retrieves field information about the given tables.
*
* @param mixed $tables A table name or a list of table names.
* @param boolean $typeOnly True to only return field types.
*
* @return array An array of fields by table.
*/
public function getTableFields($tables, $typeOnly = true)
{
$results = [];
$tables = (array) $tables;
foreach ($tables as $table)
{
$results[$table] = $this->getTableColumns($table, $typeOnly);
}
return $results;
}
/**
* Retrieves field information about the given tables.
*
* @param mixed $tables A table name or a list of table names.
*
* @return array An array of keys for the table(s).
*/
abstract public function getTableKeys($tables);
/**
* Method to get an array of all tables in the database.
*
* @return array An array of all the tables in the database.
*/
abstract public function getTableList();
/**
* Returns an array with the names of tables, views, procedures, functions and triggers
* in the database. The table names are the keys of the tables, whereas the value is
* the type of each element: table, view, merge, temp, procedure, function or trigger.
* Note that merge are MRG_MYISAM tables and temp is non-permanent data table, usually
* set up as temporary, black hole or federated tables. These two types should never,
* ever, have their data dumped in the SQL dump file.
*
* @param bool $abstract Return abstract or normal names? Defaults to true (abstract names)
*
* @return array
*/
abstract public function getTables($abstract = true);
/**
* Determine whether or not the database engine supports UTF-8 character encoding.
*
* @return boolean True if the database engine supports UTF-8 character encoding.
*/
public function getUTFSupport()
{
return $this->utf;
}
/**
* Get the version of the database connector
*
* @return string The database connector version.
*/
abstract public function getVersion();
/**
* Determines if the database engine supports UTF-8 character encoding.
*
* @return boolean True if supported.
*/
public function hasUTF()
{
return $this->utf;
}
/**
* Determine whether or not the database engine supports UTF-8 character encoding.
*
* @return boolean True if the database engine supports UTF-8 character encoding.
*/
public function hasUTFSupport()
{
return $this->utf;
}
/**
* Inserts a row into a table based on an object's properties.
*
* @param string $table The name of the database table to insert into.
* @param object &$object A reference to an object whose public properties match the table fields.
* @param string $key The name of the primary key. If provided the object property is updated.
*
* @return boolean True on success.
*/
public function insertObject($table, &$object, $key = null)
{
$fields = [];
$values = [];
// Iterate over the object variables to build the query fields and values.
foreach (get_object_vars($object) as $k => $v)
{
// Only process non-null scalars.
if (is_array($v) || is_object($v) || ($v === null))
{
continue;
}
// Ignore any internal fields.
if ($k[0] == '_')
{
continue;
}
// Prepare and sanitize the fields and values for the database query.
$fields[] = $this->quoteName($k);
$values[] = $this->quote($v);
}
// Create the base insert statement.
$query = $this->getQuery(true)
->insert($this->quoteName($table))
->columns($fields)
->values(implode(',', $values));
// Set the query and execute the insert.
$this->setQuery($query);
if (!$this->execute())
{
return false;
}
// Update the primary key if it exists.
$id = $this->insertid();
if ($key && $id && is_string($key))
{
$object->$key = $id;
}
return true;
}
/**
* Method to get the auto-incremented value from the last INSERT statement.
*
* @return integer The value of the auto-increment field from the last inserted row.
*/
abstract public function insertid();
/**
* Method to check whether the installed database version is supported by the database driver
*
* @return boolean True if the database version is supported
*
* @since 12.1
*/
public function isMinimumVersion()
{
return version_compare($this->getVersion(), static::$dbMinimum) >= 0;
}
/**
* Method to get the first row of the result set from the database query as an associative array
* of ['field_name' => 'row_value'].
*
* @return mixed The return value or null if the query failed.
*/
public function loadAssoc()
{
$ret = null;
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get the first row from the result set as an associative array.
if ($array = $this->fetchAssoc($cursor))
{
$ret = $array;
}
// Free up system resources and return.
$this->freeResult($cursor);
return $ret;
}
/**
* Method to get an array of the result set rows from the database query where each row is an associative array
* of ['field_name' => 'row_value']. The array of rows can optionally be keyed by a field name, but defaults to
* a sequential numeric array.
*
* NOTE: Chosing to key the result array by a non-unique field name can result in unwanted
* behavior and should be avoided.
*
* @param string $key The name of a field on which to key the result array.
* @param string $column An optional column name. Instead of the whole row, only this column value will be in
* the result array.
*
* @return mixed The return value or null if the query failed.
*/
public function loadAssocList($key = null, $column = null)
{
$array = [];
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get all of the rows from the result set.
while ($row = $this->fetchAssoc($cursor))
{
$value = ($column) ? ($row[$column] ?? $row) : $row;
if ($key)
{
$array[$row[$key]] = $value;
}
else
{
$array[] = $value;
}
}
// Free up system resources and return.
$this->freeResult($cursor);
return $array;
}
/**
* Method to get an array of values from the $offset field in each row of the result set from
* the database query.
*
* @param integer $offset The row offset to use to build the result array.
*
* @return mixed The return value or null if the query failed.
*/
public function loadColumn($offset = 0)
{
$array = [];
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get all of the rows from the result set as arrays.
while ($row = $this->fetchArray($cursor))
{
$array[] = $row[$offset];
}
// Free up system resources and return.
$this->freeResult($cursor);
return $array;
}
/**
* Method to get the next row in the result set from the database query as an object.
*
* @param string $class The class name to use for the returned row object.
*
* @return mixed The result of the query as an array, false if there are no more rows.
*/
public function loadNextObject($class = 'stdClass')
{
// Execute the query and get the result set cursor.
if (is_null($this->cursor))
{
if (!($this->cursor = $this->execute()))
{
return $this->errorNum ? null : false;
}
}
// Get the next row from the result set as an object of type $class.
if ($row = $this->fetchObject($this->cursor, $class))
{
return $row;
}
// Free up system resources and return.
$this->freeResult($this->cursor);
$this->cursor = null;
return false;
}
/**
* Method to get the next row in the result set from the database query as an array.
*
* @return mixed The result of the query as an array, false if there are no more rows.
*/
public function loadNextRow()
{
// Execute the query and get the result set cursor.
if (is_null($this->cursor))
{
if (!($this->cursor = $this->execute()))
{
return $this->errorNum ? null : false;
}
}
// Get the next row from the result set as an object of type $class.
if ($row = $this->fetchArray($this->cursor))
{
return $row;
}
// Free up system resources and return.
$this->freeResult($this->cursor);
$this->cursor = null;
return false;
}
/**
* Method to get the first row of the result set from the database query as an object.
*
* @param string $class The class name to use for the returned row object.
*
* @return mixed The return value or null if the query failed.
*/
public function loadObject($class = 'stdClass')
{
$ret = null;
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get the first row from the result set as an object of type $class.
if ($object = $this->fetchObject($cursor, $class))
{
$ret = $object;
}
// Free up system resources and return.
$this->freeResult($cursor);
return $ret;
}
/**
* Method to get an array of the result set rows from the database query where each row is an object. The array
* of objects can optionally be keyed by a field name, but defaults to a sequential numeric array.
*
* NOTE: Choosing to key the result array by a non-unique field name can result in unwanted
* behavior and should be avoided.
*
* @param string $key The name of a field on which to key the result array.
* @param string $class The class name to use for the returned row objects.
*
* @return mixed The return value or null if the query failed.
*/
public function loadObjectList($key = '', $class = 'stdClass')
{
$array = [];
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get all of the rows from the result set as objects of type $class.
while ($row = $this->fetchObject($cursor, $class))
{
if ($key)
{
$array[$row->$key] = $row;
}
else
{
$array[] = $row;
}
}
// Free up system resources and return.
$this->freeResult($cursor);
return $array;
}
/**
* Method to get the first field of the first row of the result set from the database query.
*
* @return mixed The return value or null if the query failed.
*/
public function loadResult()
{
$ret = null;
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get the first row from the result set as an array.
if ($row = $this->fetchArray($cursor))
{
$ret = $row[0];
}
// Free up system resources and return.
$this->freeResult($cursor);
return $ret;
}
/**
* Method to get an array of values from the $offset field in each row of the result set from
* the database query.
*
* @param integer $offset The row offset to use to build the result array.
*
* @return mixed The return value or null if the query failed.
*/
public function loadResultArray($offset = 0)
{
return $this->loadColumn($offset);
}
/**
* Method to get the first row of the result set from the database query as an array. Columns are indexed
* numerically so the first column in the result set would be accessible via $row[0], etc.
*
* @return mixed The return value or null if the query failed.
*/
public function loadRow()
{
$ret = null;
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get the first row from the result set as an array.
if ($row = $this->fetchArray($cursor))
{
$ret = $row;
}
// Free up system resources and return.
$this->freeResult($cursor);
return $ret;
}
/**
* Method to get an array of the result set rows from the database query where each row is an array. The array
* of objects can optionally be keyed by a field offset, but defaults to a sequential numeric array.
*
* NOTE: Choosing to key the result array by a non-unique field can result in unwanted
* behavior and should be avoided.
*
* @param string $key The name of a field on which to key the result array.
*
* @return mixed The return value or null if the query failed.
*/
public function loadRowList($key = null)
{
$array = [];
// Execute the query and get the result set cursor.
if (!($cursor = $this->execute()))
{
return null;
}
// Get all of the rows from the result set as arrays.
while ($row = $this->fetchArray($cursor))
{
if ($key !== null)
{
$array[$row[$key]] = $row;
}
else
{
$array[] = $row;
}
}
// Free up system resources and return.
$this->freeResult($cursor);
return $array;
}
/**
* Locks a table in the database.
*
* @param string $tableName The name of the table to unlock.
*
* @return Base Returns this object to support chaining.
*/
public abstract function lockTable($tableName);
/**
* Wrap an SQL statement identifier name such as column, table or database names in quotes to prevent injection
* risks and reserved word conflicts.
*
* @param string $name The identifier name to wrap in quotes.
*
* @return string The quote wrapped name.
*/
public function nameQuote($name)
{
return $this->quoteName($name);
}
/**
* Opens a database connection. It MUST be overriden by children classes
*
* @return Base
*/
public function open()
{
// Don't try to reconnect if we're already connected
if (is_resource($this->connection) && !is_null($this->connection))
{
return $this;
}
// Determine utf-8 support
$this->utf = $this->hasUTF();
// Set charactersets (needed for MySQL 4.1.2+)
if ($this->utf)
{
$this->setUTF();
}
// Select the current database
$this->select($this->_database);
return $this;
}
/**
* Execute the SQL statement.
*
* @return mixed A database cursor resource on success, boolean false on failure.
*/
abstract public function query();
/**
* Method to quote and optionally escape a string to database requirements for insertion into the database.
*
* @param string $text The string to quote.
* @param boolean $escape True (default) to escape the string, false to leave it unchanged.
*/
public function quote($text, $escape = true)
{
return '\'' . ($escape ? $this->escape($text) : $text) . '\'';
}
/**
* Wrap an SQL statement identifier name such as column, table or database names in quotes to prevent injection
* risks and reserved word conflicts.
*
* @param mixed $name The identifier name to wrap in quotes, or an array of identifier names to wrap in
* quotes. Each type supports dot-notation name.
* @param mixed $as The AS query part associated to $name. It can be string or array, in latter case it
* has to be same length of $name; if is null there will not be any AS part for string
* or array element.
*/
public function quoteName($name, $as = null)
{
if (!is_array($name))
{
$quotedName = $this->quoteNameStr(explode('.', $name));
$quotedAs = '';
if (!is_null($as))
{
$as = (array) $as;
$quotedAs .= ' AS ' . $this->quoteNameStr($as);
}
return $quotedName . $quotedAs;
}
else
{
$fin = [];
if (is_null($as))
{
foreach ($name as $str)
{
$fin[] = $this->quoteName($str);
}
}
elseif (is_array($name) && (count($name) == (is_array($as) || $as instanceof \Countable ? count($as) : 0)))
{
$count = count($name);
for ($i = 0; $i < $count; $i++)
{
$fin[] = $this->quoteName($name[$i], $as[$i]);
}
}
return $fin;
}
}
/**
* Quote a value as a hex string.
*
* @param string $text The value to quote as hex.
*
* @return string The hex-quoted value.
* @since 10.3
*/
public function quoteHex(string $text): string
{
return "x'" . bin2hex($text) . "'";
}
/**
* Renames a table in the database.
*
* @param string $oldTable The name of the table to be renamed
* @param string $newTable The new name for the table.
* @param string $backup Table prefix
* @param string $prefix For the table - used to rename constraints in non-mysql databases
*
* @return Base Returns this object to support chaining.
*/
public abstract function renameTable($oldTable, $newTable, $backup = null, $prefix = null);
/**
* This function replaces a string identifier $prefix with the string held is the
* tablePrefix class variable.
*
* @param string $query The SQL statement to prepare.
* @param string $prefix The common table prefix.
*
* @return string The processed SQL statement.
*/
public function replacePrefix($query, $prefix = '#__')
{
$escaped = false;
$startPos = 0;
$quoteChar = '';
$literal = '';
$query = trim($query);
$n = strlen($query);
while ($startPos < $n)
{
$ip = strpos($query, $prefix, $startPos);
if ($ip === false)
{
break;
}
$j = strpos($query, "'", $startPos);
$k = strpos($query, '"', $startPos);
if (($k !== false) && (($k < $j) || ($j === false)))
{
$quoteChar = '"';
$j = $k;
}
else
{
$quoteChar = "'";
}
if ($j === false)
{
$j = $n;
}
$literal .= str_replace($prefix, $this->tablePrefix, substr($query, $startPos, $j - $startPos));
$startPos = $j;
$j = $startPos + 1;
if ($j >= $n)
{
break;
}
// Quote comes first, find end of quote
while (true)
{
$k = strpos($query, $quoteChar, $j);
$escaped = false;
if ($k === false)
{
break;
}
$l = $k - 1;
while ($l >= 0 && $query[$l] == '\\')
{
$l--;
$escaped = !$escaped;
}
if ($escaped)
{
$j = $k + 1;
continue;
}
break;
}
if ($k === false)
{
// Error in the query - no end quote; ignore it
break;
}
$literal .= substr($query, $startPos, $k - $startPos + 1);
$startPos = $k + 1;
}
if ($startPos < $n)
{
$literal .= substr($query, $startPos, $n - $startPos);
}
return $literal;
}
/**
* Resets the error condition in the driver. Useful to reset the error state after handling a thrown exception.
*
* @return $this for chaining
*/
public function resetErrors()
{
$this->errorNum = 0;
$this->errorMsg = '';
return $this;
}
/**
* Select a database for use.
*
* @param string $database The name of the database to select for use.
*
* @return boolean True if the database was successfully selected.
*/
abstract public function select($database);
/**
* Sets the database debugging state for the driver.
*
* @param boolean $level True to enable debugging.
*
* @return boolean The old debugging level.
*/
public function setDebug($level)
{
$previous = $this->debug;
$this->debug = (bool) $level;
return $previous;
}
/**
* Sets the SQL statement string for later execution.
*
* @param mixed $query The SQL statement to set either as a QueryBase object or a string.
* @param integer $offset The affected row offset to set.
* @param integer $limit The maximum affected rows to set.
*
* @return self This object to support method chaining.
*/
public function setQuery($query, $offset = 0, $limit = 0)
{
$this->sql = $query;
$this->limit = (int) $limit;
$this->offset = (int) $offset;
return $this;
}
/**
* Set the connection to use UTF-8 character encoding.
*
* @return boolean True on success.
*/
abstract public function setUTF();
/**
* Method to commit a transaction.
*
* @return void
*/
abstract public function transactionCommit();
/**
* Method to roll back a transaction.
*
* @return void
*/
abstract public function transactionRollback();
/**
* Method to initialize a transaction.
*
* @return void
*/
abstract public function transactionStart();
/**
* Method to truncate a table.
*
* @param string $table The table to truncate
*
* @return void
*/
public function truncateTable($table)
{
$this->setQuery('TRUNCATE TABLE ' . $this->quoteName($table));
$this->query();
}
/**
* Unlocks tables in the database.
*
* @return Base Returns this object to support chaining.
*/
public abstract function unlockTables();
/**
* Updates a row in a table based on an object's properties.
*
* @param string $table The name of the database table to update.
* @param object &$object A reference to an object whose public properties match the table fields.
* @param string $key The name of the primary key.
* @param boolean $nulls True to update null fields or false to ignore them.
*
* @return boolean True on success.
*/
public function updateObject($table, &$object, $key, $nulls = false)
{
$fields = [];
$where = [];
if (is_string($key))
{
$key = [$key];
}
if (is_object($key))
{
$key = (array) $key;
}
// Create the base update statement.
$statement = 'UPDATE ' . $this->quoteName($table) . ' SET %s WHERE %s';
// Iterate over the object variables to build the query fields/value pairs.
foreach (get_object_vars($object) as $k => $v)
{
// Only process scalars that are not internal fields.
if (is_array($v) || is_object($v) || ($k[0] == '_'))
{
continue;
}
// Set the primary key to the WHERE clause instead of a field to update.
if (in_array($k, $key))
{
$where[] = $this->quoteName($k) . '=' . $this->quote($v);
continue;
}
// Prepare and sanitize the fields and values for the database query.
if ($v === null)
{
// If the value is null and we want to update nulls then set it.
if ($nulls)
{
$val = 'NULL';
}
// If the value is null and we do not want to update nulls then ignore this field.
else
{
continue;
}
}
// The field is not null so we prep it for update.
else
{
$val = $this->quote($v);
}
// Add the field to be updated.
$fields[] = $this->quoteName($k) . '=' . $val;
}
// We don't have any fields to update.
if (empty($fields))
{
return true;
}
// Set the query and execute the update.
$this->setQuery(sprintf($statement, implode(",", $fields), implode(' AND ', $where)));
return $this->execute();
}
/**
* Method to fetch a row from the result set cursor as an array.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
abstract protected function fetchArray($cursor = null);
/**
* Method to fetch a row from the result set cursor as an object.
*
* @param mixed $cursor The optional result set cursor from which to fetch the row.
* @param string $class The class name to use for the returned row object.
*
* @return mixed Either the next row from the result set or false if there are no more rows.
*/
abstract protected function fetchObject($cursor = null, $class = 'stdClass');
/**
* Return the query string to alter the database character set.
*
* @param string $dbName The database name
*
* @return string The query that alter the database query string
*/
protected function getAlterDbCharacterSet($dbName)
{
$query = 'ALTER DATABASE ' . $this->quoteName($dbName) . ' CHARACTER SET `utf8`';
return $query;
}
/**
* Return the query string to create new Database.
* Each database driver, other than MySQL, need to override this member to return correct string.
*
* @param object $options Object used to pass user and database name to database driver.
* This object must have "db_name" and "db_user" set.
* @param boolean $utf True if the database supports the UTF-8 character set.
*
* @return string The query that creates database
*/
protected function getCreateDatabaseQuery($options, $utf)
{
if ($utf)
{
$query = 'CREATE DATABASE ' . $this->quoteName($options->db_name) . ' CHARACTER SET `utf8`';
}
else
{
$query = 'CREATE DATABASE ' . $this->quoteName($options->db_name);
}
return $query;
}
/**
* Gets the name of the database used by this connection.
*
* @return string
*/
protected function getDatabase()
{
return $this->_database;
}
/**
* Quote strings coming from quoteName call.
*
* @param array $strArr Array of strings coming from quoteName dot-explosion.
*
* @return string Dot-imploded string of quoted parts.
*/
protected function quoteNameStr($strArr)
{
$parts = [];
$q = $this->nameQuote;
foreach ($strArr as $part)
{
if (is_null($part))
{
continue;
}
if (strlen($q) == 1)
{
// MySQL: Escape a backtick as two backticks
if (strpos($part, $q) !== false)
{
$part = str_replace($q, $q . $q, $part);
}
$parts[] = $q . $part . $q;
}
else
{
// SQL Server: Escape a closing square bracket as two closing square brackets
if (strpos($part, $q[1]) !== false)
{
$part = str_replace($q[1], $q[1] . $q[1], $part);
}
$parts[] = $q[0] . $part . $q[1];
}
}
return implode('.', $parts);
}
}
PK \Sʉ , vendor/akeeba/engine/engine/Driver/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ o 3 vendor/akeeba/engine/engine/Postproc/sugarsync.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_SUGARSYNC_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_SUGARSYNC_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.sugarsync.access": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_SUGARSYNC_ACCESS_TITLE",
"description": "COM_AKEEBA_CONFIG_SUGARSYNC_ACCESS_DESCRIPTION"
},
"engine.postproc.sugarsync.private": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_SUGARSYNC_PRIVATE_TITLE",
"description": "COM_AKEEBA_CONFIG_SUGARSYNC_PRIVATE_DESCRIPTION"
},
"engine.postproc.sugarsync.email": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_SUGARSYNC_EMAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_SUGARSYNC_EMAIL_DESCRIPTION"
},
"engine.postproc.sugarsync.password": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_SUGARSYNC_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_SUGARSYNC_PASSWORD_DESCRIPTION"
},
"engine.postproc.sugarsync.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_SUGARSYNC_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_SUGARSYNC_DIRECTORY_DESCRIPTION"
}
}PK \) 2 vendor/akeeba/engine/engine/Postproc/dropbox2.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_DROPBOX2_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_DROPBOX2_DESCRIPTION"
},
"engine.postproc.dropbox2.oauth2_type": {
"default": "akeeba",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_OPT_AKEEBA|COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_OPT_CUSTOM",
"enumvalues": "akeeba|custom",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_DESCRIPTION"
},
"engine.postproc.dropbox2.oauth2_helper": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_HELPER_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_HELPER_DESCRIPTION",
"showon": "engine.postproc.dropbox2.oauth2_type:custom"
},
"engine.postproc.dropbox2.oauth2_refresh": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_REFRESH_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_REFRESH_DESCRIPTION",
"showon": "engine.postproc.dropbox2.oauth2_type:custom"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.dropbox2.chunk_upload": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_ENABLE"
},
"engine.postproc.dropbox2.chunk_upload_size": {
"default": "20",
"type": "integer",
"min": "5",
"max": "100",
"shortcuts": "5|10|20|40|60|80",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE",
"showon": "engine.postproc.dropbox2.chunk_upload:1"
},
"engine.postproc.dropbox2.openoauth": {
"default": "",
"type": "button",
"title": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_TITLE",
"description": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_DESC",
"hook": "akconfig_dropbox2_openoauth"
},
"engine.postproc.dropbox2.team": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DROPBOX_TEAM_TITLE",
"description": "COM_AKEEBA_CONFIG_DROPBOX_TEAM_DESC"
},
"engine.postproc.dropbox2.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DROPBOXDIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_DROPBOXDIRECTORY_DESCRIPTION"
},
"engine.postproc.dropbox2.access_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DROPBOXTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_DROPBOXTOKEN_DESCRIPTION"
},
"engine.postproc.dropbox2.refresh_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DROPBOXREFRESHTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_DROPBOXREFRESHTOKEN_DESCRIPTION"
}
}PK \xEJ J 2 vendor/akeeba/engine/engine/Postproc/Backblaze.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\Backblaze as ConnectorBackblaze;
use Akeeba\Engine\Postproc\Connector\Backblaze\Exception\Base as BackblazeBaseException;
use Akeeba\Engine\Postproc\Connector\Backblaze\Exception\UnexpectedHTTPStatus;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Exception;
use OutOfBoundsException;
use RuntimeException;
/**
* Upload to Backblaze post-processing engine for Akeeba Engine
*/
class Backblaze extends Base
{
/**
* The upload ID of the multipart upload in progress
*
* @var null|string
*/
protected $fileId = null;
/**
* The Upload URL structure returned by Backblaze, required in multipart uplaods
*
* @var ConnectorBackblaze\UploadURL
*/
protected $uploadUrl = null;
/**
* The part number for the multipart upload in progress
*
* @var null|int
*/
protected $partNumber = null;
/**
* The SHA-1 checksums of the uploaded chunks, used to finalise the multipart upload
*
* @var array
*/
protected $sha1Parts = [];
/**
* Used in log messages.
*
* @var string
*/
protected $engineLogName = 'BackBlaze B2';
/**
* The prefix to use for volatile key storage
*
* @var string
*/
protected $volatileKeyPrefix = 'volatile.postproc.backblaze.';
/**
* The ID of the bucket specified in the engine configuration
*
* @var string
*/
protected $bucketId = '';
/**
* Initialise the class, setting its capabilities
*/
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToBrowser = true;
$this->supportsDownloadToFile = true;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
// Retrieve engine configuration data
$akeebaConfig = Factory::getConfiguration();
// Load multipart information from temporary storage
$this->fileId = $akeebaConfig->get($this->volatileKeyPrefix . 'fileId', null);
$this->uploadUrl = new ConnectorBackblaze\UploadURL($akeebaConfig->get($this->volatileKeyPrefix . 'uploadUrl', []));
// Get the configuration parameters
$engineConfig = $this->getEngineConfiguration();
$disableMultipart = $engineConfig['disableMultipart'];
// The directory is a special case. First try getting a cached directory
$directory = $akeebaConfig->get('volatile.postproc.directory', null);
$processDirectory = false;
// If there is no cached directory, fetch it from the engine configuration
if (is_null($directory))
{
$directory = $engineConfig['directory'];
$processDirectory = true;
}
// The very first time we deal with the directory we need to process it.
if ($processDirectory)
{
$directory = empty($directory) ? '' : $directory;
$directory = str_replace('\\', '/', $directory);
$directory = rtrim($directory, '/');
$directory = trim($directory);
$directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
// Store the parsed directory in temporary storage
$akeebaConfig->set('volatile.postproc.directory', $directory);
}
/**
* Get the file size and disable multipart uploads for files smaller than 5Mb or the configured chunk size,
* whichever is bigger.
*/
$fileSize = @filesize($localFilepath);
$partSize = max($this->getPartSizeForFile($localFilepath), 5242880);
if ($fileSize <= $partSize)
{
$disableMultipart = true;
}
// Calculate relative remote filename
$remoteKey = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
if (!empty($directory) && ($directory != '/'))
{
$remoteKey = $directory . '/' . $remoteKey;
}
// Store the absolute remote path in the class property
$this->remotePath = $remoteKey;
/** @var ConnectorBackblaze $connector */
$connector = $this->getConnector();
$bucketId = $this->getBucketId();
// Are we already processing a multipart upload or asked to perform a multipart upload?
if (!empty($this->fileId) || !$disableMultipart)
{
$this->partNumber = $akeebaConfig->get($this->volatileKeyPrefix . 'partNumber', null);
$this->sha1Parts = $akeebaConfig->get($this->volatileKeyPrefix . 'sha1Parts', '[]');
$this->sha1Parts = json_decode($this->sha1Parts, true);
$this->sha1Parts = empty($this->sha1Parts) ? [] : $this->sha1Parts;
return $this->multipartUpload($bucketId, $remoteKey, $localFilepath, $connector);
}
return $this->simpleUpload($bucketId, $remoteKey, $localFilepath, $connector);
}
public function delete($path)
{
/** @var ConnectorBackblaze $connector */
$connector = $this->getConnector();
$bucketId = $this->getBucketId();
$connector->deleteByFileName($bucketId, $path);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
/** @var ConnectorBackblaze $connector */
$connector = $this->getConnector();
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'];
$bucket = str_replace('/', '', $bucket);
$headers = [];
if (!is_null($fromOffset) && $length)
{
$toOffset = $fromOffset + $length - 1;
$headers[] = 'Range: bytes=' . $fromOffset . '-' . $toOffset;
}
$connector->downloadFile($bucket, $remotePath, $localFile, $headers);
}
public function downloadToBrowser($remotePath)
{
/** @var ConnectorBackblaze $connector */
$connector = $this->getConnector();
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'];
$bucket = str_replace('/', '', $bucket);
return $connector->getSignedUrl($bucket, $remotePath, 30);
}
protected function makeConnector()
{
// Retrieve engine configuration data
$config = $this->getEngineConfiguration();
// Get the configuration parameters
$accountId = $config['accountId'];
$applicationKey = $config['applicationKey'];
$bucket = $config['bucket'];
// Remove any slashes from the bucket
$bucket = str_replace('/', '', $bucket);
// Sanity checks
if (empty($accountId))
{
throw new BadConfiguration('You have not set up your ' . $this->engineLogName . ' Account ID');
}
if (empty($applicationKey))
{
throw new BadConfiguration('You have not set up your ' . $this->engineLogName . ' Application Key');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
if (empty($bucket))
{
throw new BadConfiguration('You have not set up your ' . $this->engineLogName . ' Bucket');
}
// Create the API connector instance
return new ConnectorBackblaze($accountId, $applicationKey);
}
/**
* Start a multipart upload
*
* @param string $bucketId The bucket ID to upload to
* @param string $remoteKey The remote filename
* @param string $sourceFile The full path to the local source file
* @param ConnectorBackblaze $connector The S3 client object instance
*
* @return bool True when we're done uploading, false if we have more parts
*
* @throws Exception When an error occurs
*/
private function multipartUpload($bucketId, $remoteKey, $sourceFile, ConnectorBackblaze $connector)
{
if (empty($this->fileId))
{
Factory::getLog()->debug(sprintf(
"%s -- Beginning multipart upload of %s", $this->engineLogName, $sourceFile
));
// Initialise the multipart upload if necessary
try
{
$fileInfo = $connector->startUpload($bucketId, $remoteKey);
$this->fileId = $fileInfo->fileId;
Factory::getLog()->debug(sprintf(
"%s -- Got fileID %s", $this->engineLogName, $this->fileId
));
$this->uploadUrl = $connector->getPartUploadUrl($this->fileId);
$this->partNumber = 1;
$this->sha1Parts = [];
Factory::getLog()->debug(sprintf(
"%s -- Got uploadURL %s - Upload Authorization %s",
$this->engineLogName, $this->uploadUrl->uploadUrl, $this->uploadUrl->authorizationToken
));
}
catch (Exception $e)
{
Factory::getLog()->debug(sprintf(
"%s -- Failed to initialize multipart upload of %s", $this->engineLogName, $sourceFile
));
throw new RuntimeException('Multipart upload cannot be initialised.', 500, $e);
}
}
else
{
Factory::getLog()
->debug(sprintf(
"%s -- Continuing multipart upload of %s (fileId: %s –– Part number %d)",
$this->engineLogName, $sourceFile, $this->fileId, $this->partNumber
));
}
// Upload a chunk
$mustFinalize = false;
try
{
$partSize = $this->getPartSizeForFile($sourceFile);
$fileInfo = $connector->uploadPart($this->uploadUrl, $sourceFile, $this->partNumber, $partSize);
$this->sha1Parts[] = $fileInfo->contentSha1;
$this->partNumber++;
}
catch (UnexpectedHTTPStatus $e)
{
/**
* If we get an HTTP 500 or 503 it means that the BackBlaze B2 storage pod is full. In this case B2 tells us
* to request a new upload URL (which will be in another pod) and retry the upload. Rinse and repeat until
* the upload completes.
*
* Implementation:
*
* - If the unexpected HTTP status is not 500 or 503 I need to rethrow the exception. In this case something
* actually went wrong and we need to stop.
* - I need to notify the user that no, the chunk did not upload.
* - I DO NOT need to roll back the current chunk number or remove its stored SHA1 from the cache. Remember,
* we failed at $connector->uploadPart which comes BEFORE we modify $this->sha1Parts and $this->partNumber
* - I do need to get a new upload URL with the stored file ID.
* - I need to return false, indicating we have more work to do here.
*/
if (!in_array($e->getCode(), [500, 503]))
{
throw $e;
}
Factory::getLog()
->debug(sprintf(
"%s -- BackBlaze B2 storage pod full (BackBlaze B2 returned HTTP %u). Getting new part upload URL. The upload will resume later.",
$this->engineLogName, $e->getCode()
));
// Get a new upload URL
$this->uploadUrl = $connector->getPartUploadUrl($this->fileId);
return false;
}
catch (OutOfBoundsException $e)
{
$mustFinalize = true;
}
catch (Exception $e)
{
Factory::getLog()->debug(sprintf(
"%s -- Multipart upload of %s has failed.", $this->engineLogName, $sourceFile
));
// Reset the multipart markers in temporary storage
$akeebaConfig = Factory::getConfiguration();
$akeebaConfig->set($this->volatileKeyPrefix . 'fileId', null);
$akeebaConfig->set($this->volatileKeyPrefix . 'uploadUrl', null);
$akeebaConfig->set($this->volatileKeyPrefix . 'partNumber', null);
$akeebaConfig->set($this->volatileKeyPrefix . 'sha1Parts', null);
throw new RuntimeException(sprintf(
"Upload cannot proceed. %s returned an error.", $this->engineLogName
), 500, $e);
}
// When we are done uploading we have to finalize
if ($mustFinalize)
{
$count = count($this->sha1Parts);
Factory::getLog()->debug(sprintf(
"%s -- Finalising multipart upload of %s (fileId: %s –– %s parts in total)",
$this->engineLogName, $sourceFile, $this->fileId, $count
));
$fileInfo = $connector->finishUpload($this->fileId, $this->sha1Parts);
Factory::getLog()->debug(sprintf(
"%s -- Finalised multipart upload of %s (fileId: %s)",
$this->engineLogName, $sourceFile, $fileInfo->fileId
));
$this->fileId = null;
$this->uploadUrl = null;
$this->partNumber = null;
$this->sha1Parts = [];
}
// Save the internal tracking variables
$akeebaConfig = Factory::getConfiguration();
$uploadURLAsArray = is_null($this->uploadUrl) ? [] : $this->uploadUrl->toArray();
$akeebaConfig->set($this->volatileKeyPrefix . 'fileId', $this->fileId);
$akeebaConfig->set($this->volatileKeyPrefix . 'uploadUrl', $uploadURLAsArray);
$akeebaConfig->set($this->volatileKeyPrefix . 'partNumber', $this->partNumber);
$akeebaConfig->set($this->volatileKeyPrefix . 'sha1Parts', json_encode($this->sha1Parts));
// If I have an upload ID I have to do more work
if (is_string($this->fileId) && !empty($this->fileId))
{
return false;
}
// In any other case I'm done uploading the file
return true;
}
/**
* Perform a single-step upload of a file
*
* @param string $bucketId The bucket ID to upload to
* @param string $remoteKey The remote filename
* @param string $sourceFile The full path to the local source file
* @param ConnectorBackblaze $connector The S3 client object instance
*
* @return bool True when we're done uploading, false if we have more parts
*
* @throws Exception When an error occurs
*/
private function simpleUpload($bucketId, $remoteKey, $sourceFile, ConnectorBackblaze $connector)
{
Factory::getLog()->debug(sprintf(
"%s -- Single part upload of %s", $this->engineLogName, basename($sourceFile)
));
$tries = 0;
while (true)
{
$tries++;
try
{
$connector->uploadSingleFile($bucketId, $remoteKey, $sourceFile);
}
catch (UnexpectedHTTPStatus $e)
{
/**
* If we get an HTTP 500 or 503 it means that the BackBlaze B2 storage pod is full. In this case B2 tells us
* to request a new upload URL (which will be in another pod) and retry the upload. Rinse and repeat until
* the upload completes.
*
* Implementation:
*
* - If this is the third try we give up (rethrow the exception). Something is actually wrong with B2.
* - If the unexpected HTTP status is not 500 or 503 I need to rethrow the exception. In this case
* something actually went wrong and we need to stop.
* - I need to notify the user that no, the chunk did not upload.
* - I DO NOT need to roll back the current chunk number or remove its stored SHA1 from the cache. Remember,
* we failed at $connector->uploadPart which comes BEFORE we modify $this->sha1Parts and $this->partNumber
* - I do need to get a new upload URL with the stored file ID.
* - I need to return false, indicating we have more work to do here.
*/
if (($tries >= 3) || !in_array($e->getCode(), [500, 503]))
{
throw $e;
}
Factory::getLog()
->debug(sprintf(
"%s -- BackBlaze B2 storage pod full (BackBlaze B2 returned HTTP %u). Retrying upload (attempt %d of a maximum of 2).",
$this->engineLogName, $e->getCode(), $tries
));
continue;
}
break;
}
return true;
}
/**
* Get the configuration information for this post-processing engine
*
* @return array
*/
private function getEngineConfiguration()
{
$akeebaConfig = Factory::getConfiguration();
return [
'accountId' => $akeebaConfig->get('engine.postproc.backblaze.accountId', ''),
'applicationKey' => $akeebaConfig->get('engine.postproc.backblaze.applicationKey', ''),
'disableMultipart' => $akeebaConfig->get('engine.postproc.backblaze.disableMultipart', 0),
'bucket' => $akeebaConfig->get('engine.postproc.backblaze.bucket', null),
'directory' => $akeebaConfig->get('engine.postproc.backblaze.directory', null),
'chunkInMB' => $akeebaConfig->get('engine.postproc.backblaze.chunk_upload_size', null),
];
}
/**
* Get the bucket ID, fetching it from BackBlaze if it's not already populated
*
* @return string The bucket ID
*
* @throws BackblazeBaseException When fetching the bucket ID is impossible
* @throws Exception When we cannot get a connector object
*/
private function getBucketId()
{
if (!empty($this->bucketId))
{
return $this->bucketId;
}
$akeebaConfig = Factory::getConfiguration();
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'];
$bucket = str_replace('/', '', $bucket);
$connector = $this->getConnector();
$this->bucketId = $connector->getBucketId($bucket);
$akeebaConfig->set($this->volatileKeyPrefix . 'bucketId', $this->bucketId);
return $this->bucketId;
}
/**
* Get the applicable part size for a given file. The part size cannot be smaller than the absolute minimum part
* size reported by Backblaze (typically 5MB). It also cannot be smaller than the file size divided by 10,000 as
* Backblaze will only allow us to upload up to 10,000 parts. This algorithm will try to use the user selected
* part size unless it is smaller than these hard requirements.
*
* Finally note that the part size is cached in volatile storage so that subsequent queries about it will not result
* in a performance penalty.
*
* @param string $sourceFile The local file we want to figure out the part size for
*
* @return int
*
* @throws Exception If getting the connector object is not possible
*/
private function getPartSizeForFile($sourceFile)
{
$akeebaConfig = Factory::getConfiguration();
$savedSourceFile = $akeebaConfig->get($this->volatileKeyPrefix . 'partSizeFile', null);
$savedPartSize = $akeebaConfig->get($this->volatileKeyPrefix . 'partSizeValue', null);
if ($savedSourceFile == $sourceFile)
{
return $savedPartSize;
}
// Get the part size. Must be <= 100 MB
$engineConfig = $this->getEngineConfiguration();
$connector = $this->getConnector();
$minPartSize = $connector->getAccountInformation()->absoluteMinimumPartSize;
$partSize = min($engineConfig['chunkInMB'], 100);
$partSize = $partSize * 1024 * 1024;
$partSize = max($minPartSize, $partSize);
clearstatcache(false, $sourceFile);
$fileSize = @filesize($sourceFile);
/**
* Backblaze supports up to 10000 parts. We have to try increasing the part size until we're sure our file
* will upload in a number of parts that's less than that.
*/
while ($fileSize / $partSize > 10000)
{
// Increase by 5M in each step
$partSize += 5242880;
}
$akeebaConfig->set($this->volatileKeyPrefix . 'partSizeFile', $sourceFile);
$akeebaConfig->set($this->volatileKeyPrefix . 'partSizeValue', $partSize);
return $partSize;
}
}
PK \l , vendor/akeeba/engine/engine/Postproc/Ftp.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Akeeba\Engine\Util\Transfer\Ftp as TransferFtp;
use Exception;
use RuntimeException;
class Ftp extends Base
{
protected $engineKey = 'engine.postproc.ftp.';
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToBrowser = true;
$this->supportsDownloadToFile = true;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
/** @var TransferFtp $connector */
$connector = $this->getConnector();
$config = $this->getConfig();
$subDirectory = $config['subdir'];
$initialDirectory = $config['directory'];
// If supplied, change to the subdirectory
if ($subDirectory)
{
$subDirectory = trim(Factory::getFilesystemTools()->replace_archive_name_variables($subDirectory), '/');
if (!$connector->isDir($initialDirectory . '/' . $subDirectory))
{
// Got an error? This means that the directory doesn't exist, let's try to create it
if (!$connector->mkdir($initialDirectory . '/' . $subDirectory))
{
// Ok, I really can't do anything, let's stop here
throw new RuntimeException(sprintf(
"Could not create the subdirectory %s in the remote FTP server", $subDirectory
));
}
// Let's move into the new directory
if (!$connector->isDir($initialDirectory . '/' . $subDirectory))
{
// This should never happen, anyway better be safe than sorry
throw new RuntimeException(sprintf(
"Could not move into the subdirectory %s in the remote FTP server", $subDirectory
));
}
}
}
Factory::getLog()->debug(sprintf("%s:: Starting FTP upload of $localFilepath", __CLASS__));
$absoluteRemoteDirectory = $initialDirectory;
if (substr($initialDirectory, -1) == '/')
{
$absoluteRemoteDirectory = substr($initialDirectory, 0, strlen($initialDirectory) - 1);
}
if (!empty($subDirectory))
{
$absoluteRemoteDirectory .= '/' . $subDirectory;
}
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$absoluteRemoteFilepath = $absoluteRemoteDirectory . '/' . $basename;
$this->remotePath = $absoluteRemoteFilepath;
$res = $connector->upload($localFilepath, $absoluteRemoteFilepath);
if (!$res)
{
if (is_readable($localFilepath))
{
throw new RuntimeException(sprintf("Uploading %s has failed.", $localFilepath));
}
throw new RuntimeException(sprintf("Uploading %s has failed because the file is unreadable.", $localFilepath));
}
return true;
}
public function delete($path)
{
/** @var TransferFtp $connector */
$connector = $this->getConnector();
try
{
$connector->delete($path);
}
catch (Exception $e)
{
throw new RuntimeException(sprintf('Deleting %s failed.', $path), 500, $e);
}
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset))
{
throw new RangeDownloadNotSupported();
}
/** @var TransferFtp $connector */
$connector = $this->getConnector();
$connector->download($remotePath, $localFile);
}
public function downloadToBrowser($remotePath)
{
$config = $this->getConfig();
$host = $config['host'];
$port = $config['port'];
$user = $config['username'];
$pass = $config['password'];
$ssl = $config['ssl'];
$uri = $ssl ? 'ftps://' : 'ftp://';
if ($user && $pass)
{
$uri .= urlencode($user) . ':' . urlencode($pass) . '@';
}
$uri .= $host;
if ($port && ($port != 21))
{
$uri .= ':' . $port;
}
if (substr($remotePath, 0, 1) != '/')
{
$uri .= '/';
}
$uri .= $remotePath;
return $uri;
}
/**
* Return the engine configuration
*
* @return array
*/
protected function getConfig()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$host = $config->get($this->engineKey . 'host', '');
$port = $config->get($this->engineKey . 'port', 21);
$username = $config->get($this->engineKey . 'user', '');
$password = $config->get($this->engineKey . 'pass', 0);
$defaultDirectory = $config->get($this->engineKey . 'initial_directory', '');
$directory = $config->get('volatile.postproc.directory', $defaultDirectory);
$subdir = trim($config->get($this->engineKey . 'subdirectory', ''), '/');
$ssl = $config->get($this->engineKey . 'ftps', 0) == 0 ? false : true;
$passive = $config->get($this->engineKey . 'passive_mode', 0) == 0 ? false : true;
$workaround = $config->get($this->engineKey . 'passive_mode_workaround', null);
// Process the initial directory
$directory = '/' . ltrim(trim($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
$config->set('volatile.postproc.directory', $directory);
// Try to automatically fix protocol in the hostname
if (strtolower(substr($host, 0, 6)) == 'ftp://')
{
Factory::getLog()->warning('YOU ARE *** N O T *** SUPPOSED TO ENTER THE ftp:// PROTOCOL PREFIX IN THE FTP HOSTNAME FIELD OF THE Upload to Remote FTP POST-PROCESSING ENGINE.');
Factory::getLog()->warning('I am trying to fix your bad configuration setting, but the backup might fail anyway. You MUST fix this in your configuration.');
$host = substr($host, 6);
}
return [
'host' => $host,
'port' => $port,
'username' => $username,
'password' => $password,
'directory' => $directory,
'ssl' => $ssl,
'passive' => $passive,
'passive_fix' => $workaround,
'subdir' => $subdir,
];
}
protected function makeConnector()
{
Factory::getLog()->debug(__CLASS__ . ':: Connecting to remote FTP');
$config = $this->getConfig();
return new TransferFtp($config);
}
}
PK \ 0 vendor/akeeba/engine/engine/Postproc/Cloudme.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
class Cloudme extends Webdav
{
public function __construct()
{
$this->settingsKey = 'cloudme';
parent::__construct();
}
protected function modifySettings(array &$settings)
{
$settings['baseUri'] = 'https://webdav.cloudme.com/' . $settings['userName'] . '/CloudDrive/Documents/CloudMe';
}
}
PK \YQ~ 3 vendor/akeeba/engine/engine/Postproc/backblaze.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_BACKBLAZE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_BACKBLAZE_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.backblaze.accountId": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_BACKBLAZE_ACCOUNTID_TITLE",
"description": "COM_AKEEBA_CONFIG_BACKBLAZE_ACCOUNTID_DESCRIPTION"
},
"engine.postproc.backblaze.applicationKey": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_BACKBLAZE_APPLICATIONKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_BACKBLAZE_APPLICATIONKEY_DESCRIPTION"
},
"engine.postproc.backblaze.bucket": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_BACKBLAZE_BUCKET_TITLE",
"description": "COM_AKEEBA_CONFIG_BACKBLAZE_BUCKET_DESCRIPTION"
},
"engine.postproc.backblaze.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG__BACKBLAZE_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_BACKBLAZE_DIRECTORY_DESCRIPTION"
},
"engine.postproc.backblaze.disableMultipart": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BACKBLAZE_DISABLEMULTIPART_TITLE",
"description": "COM_AKEEBA_CONFIG_BACKBLAZE_DISABLEMULTIPART_DESCRIPTION"
},
"engine.postproc.backblaze.chunk_upload_size": {
"default": "20",
"type": "integer",
"min": "5",
"max": "100",
"shortcuts": "5|10|20|40|60|80|100",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE",
"shown": "engine.postproc.backblaze.disableMultipart:0"
}
}PK \40 0 / vendor/akeeba/engine/engine/Postproc/email.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_EMAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_EMAIL_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.email.address": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_PROCEMAIL_ADDRESS_TITLE",
"description": "COM_AKEEBA_CONFIG_PROCEMAIL_ADDRESS_DESCRIPTION"
},
"engine.postproc.email.subject": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_PROCEMAIL_SUBJECT_TITLE",
"description": "COM_AKEEBA_CONFIG_PROCEMAIL_SUBJECT_DESCRIPTION"
}
}PK \&%:)u u 2 vendor/akeeba/engine/engine/Postproc/amazons3.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_S3_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_S3_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.amazons3.accesskey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_S3ACCESSKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_S3ACCESSKEY_DESCRIPTION"
},
"engine.postproc.amazons3.secretkey": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_S3SECRETKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_S3SECRETKEY_DESCRIPTION"
},
"engine.postproc.amazons3.usessl": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_S3USESSL_TITLE",
"description": "COM_AKEEBA_CONFIG_S3USESSL_DESCRIPTION"
},
"engine.postproc.amazons3.dualstack": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_S3_DUALSTACK_TITLE",
"description": "COM_AKEEBA_CONFIG_S3_DUALSTACK_DESCRIPTION"
},
"engine.postproc.amazons3.bucket": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_S3BUCKET_TITLE",
"description": "COM_AKEEBA_CONFIG_S3BUCKET_DESCRIPTION"
},
"engine.postproc.amazons3.signature": {
"default": "v4",
"type": "enum",
"enumkeys": "COM_AKEEBA_S3_SIGNATURE_V4|COM_AKEEBA_S3_SIGNATURE_V2",
"enumvalues": "v4|v2",
"title": "COM_AKEEBA_S3_SIGNATURE_TITLE",
"description": "COM_AKEEBA_S3_SIGNATURE_DESCRIPTION"
},
"engine.postproc.amazons3.region": {
"default": "us-east-1",
"type": "enum",
"enumkeys": "COM_AKEEBA_S3_REGION_CUSTOM_OR_NONE|COM_AKEEBA_S3_REGION_USEAST1|COM_AKEEBA_S3_REGION_USEAST2|COM_AKEEBA_S3_REGION_USWEST1|COM_AKEEBA_S3_REGION_USWEST2|COM_AKEEBA_S3_REGION_CACENTRAL1|COM_AKEEBA_S3_REGION_EUCENTRAL1|COM_AKEEBA_S3_REGION_EUCENTRAL2|COM_AKEEBA_S3_REGION_EUNORTH1|COM_AKEEBA_S3_REGION_EUSOUTH1|COM_AKEEBA_S3_REGION_EUSOUTH2|COM_AKEEBA_S3_REGION_EUWEST1|COM_AKEEBA_S3_REGION_EUWEST2|COM_AKEEBA_S3_REGION_EUWEST3|COM_AKEEBA_S3_REGION_APEAST1|COM_AKEEBA_S3_REGION_APNORTHEAST1|COM_AKEEBA_S3_REGION_APNORTHEAST2|COM_AKEEBA_S3_REGION_APNORTHEAST3|COM_AKEEBA_S3_REGION_APSOUTH1|COM_AKEEBA_S3_REGION_APSOUTH2|COM_AKEEBA_S3_REGION_APSOUTHEAST1|COM_AKEEBA_S3_REGION_APSOUTHEAST2|COM_AKEEBA_S3_REGION_APSOUTHEAST3|COM_AKEEBA_S3_REGION_APSOUTHEAST4|COM_AKEEBA_S3_REGION_SAEAST1|COM_AKEEBA_S3_REGION_MECENTRAL1|COM_AKEEBA_S3_REGION_MESOUTH1|COM_AKEEBA_S3_REGION_AFSOUTH1|COM_AKEEBA_S3_REGION_CNNORTH1|COM_AKEEBA_S3_REGION_CNNORTHWEST1|COM_AKEEBA_S3_REGION_USGOVEAST1|COM_AKEEBA_S3_REGION_USGOVEAST2",
"enumvalues": "|us-east-1|us-east-2|us-west-1|us-west-2|ca-central-1|eu-central-1|eu-central-2|eu-north-1|eu-south-1|eu-south-2|eu-west-1|eu-west-2|eu-west-3|ap-east-1|ap-northeast-1|ap-northeast-2|ap-northeast-3|ap-south-1|ap-south-2|ap-southeast-1|ap-southeast-2|ap-southeast-3|ap-southeast-4|sa-east-1|me-central-1|me-south-1|af-south-1|cn-north-1|cn-northwest-1|us-gov-east-1|us-gov-west-1",
"title": "COM_AKEEBA_S3_REGION_TITLE",
"description": "COM_AKEEBA_S3_REGION_DESCRIPTION",
"showon": "engine.postproc.amazons3.signature:v4"
},
"engine.postproc.amazons3.custom_region": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_S3_CUSTOM_REGION_TITLE",
"description": "COM_AKEEBA_S3_CUSTOM_REGION_DESCRIPTION",
"showon": "engine.postproc.amazons3.signature:v4[AND]engine.postproc.amazons3.region:"
},
"engine.postproc.amazons3.pathaccess": {
"default": "0",
"type": "enum",
"enumkeys": "COM_AKEEBA_S3_ACCESS_VIRTUALHOST|COM_AKEEBA_S3_ACCESS_PATH",
"enumvalues": "0|1",
"title": "COM_AKEEBA_S3_ACCESS_TITLE",
"description": "COM_AKEEBA_S3_ACCESS_DESCRIPTION"
},
"engine.postproc.amazons3.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_S3DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_S3DIRECTORY_DESCRIPTION"
},
"engine.postproc.amazons3.acl": {
"default": "bucket-owner-full-control",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_S3_ACL_PRIVATE|COM_AKEEBA_CONFIG_S3_ACL_PUBLIC_READ|COM_AKEEBA_CONFIG_S3_ACL_PUBLIC_READ_WRITE|COM_AKEEBA_CONFIG_S3_ACL_AUTHENTICATED_READ|COM_AKEEBA_CONFIG_S3_ACL_BUCKET_OWNER_READ|COM_AKEEBA_CONFIG_S3_ACL_BUCKET_OWNER_FULL_CONTROL",
"enumvalues": "private|public-read|public-read-write|authenticated-read|bucket-owner-read|bucket-owner-full-control",
"title": "COM_AKEEBA_CONFIG_S3_ACL_TITLE",
"description": "COM_AKEEBA_CONFIG_S3_ACL_DESCRIPTION"
},
"engine.postproc.amazons3.legacy": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_S3LEGACY_TITLE",
"description": "COM_AKEEBA_CONFIG_S3LEGACY_DESCRIPTION"
},
"engine.postproc.amazons3.rrs": {
"default": "0",
"type": "enum",
"enumkeys": "COM_AKEEBA_S3_RRS_STANDARD|COM_AKEEBA_S3_RRS_RRS|COM_AKEEBA_S3_RRS_STANDARD_IA|COM_AKEEBA_S3_RRS_ONEZONE_IA|COM_AKEEBA_S3_RRS_INTELLIGENT_TIERING|COM_AKEEBA_S3_RRS_GLACIER|COM_AKEEBA_S3_RRS_DEEP_ARCHIVE",
"enumvalues": "0|1|2|3|4|5|6",
"title": "COM_AKEEBA_CONFIG_S3RRS_TITLE",
"description": "COM_AKEEBA_CONFIG_S3RRS_DESCRIPTION"
},
"engine.postproc.amazons3.customendpoint": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_S3CUSTOMENDPOINT_TITLE",
"description": "COM_AKEEBA_CONFIG_S3CUSTOMENDPOINT_DESCRIPTION"
},
"engine.postproc.amazons3.alternateDateHeaderFormat": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_S3_ALTERNATEDATEHEADERFORMAT_TITLE",
"description": "COM_AKEEBA_CONFIG_S3_ALTERNATEDATEHEADERFORMAT_DESCRIPTION",
"showon": "engine.postproc.amazons3.customendpoint!:"
},
"engine.postproc.amazons3.useHTTPDateHeader": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_S3_USEHTTPDATEHEADER_TITLE",
"description": "COM_AKEEBA_CONFIG_S3_USEHTTPDATEHEADER_DESCRIPTION"
},
"engine.postproc.amazons3.preSignedBucketInURL": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_S3_PRESIGNEDBUCKETINURL_TITLE",
"description": "COM_AKEEBA_CONFIG_S3_PRESIGNEDBUCKETINURL_DESCRIPTION",
"showon": "engine.postproc.amazons3.signature:v4"
}
}PK \#AQ Q 2 vendor/akeeba/engine/engine/Postproc/onedrive.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_ONEDRIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_ONEDRIVE_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.onedrive.chunk_upload": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_ENABLE"
},
"engine.postproc.onedrive.chunk_upload_size": {
"default": "10",
"type": "integer",
"min": "4",
"max": "60",
"shortcuts": "5|10|20|40|60",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE",
"showon": "engine.postproc.onedrive.chunk_upload:1"
},
"engine.postproc.onedrive.openoauth": {
"default": "",
"type": "button",
"title": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_TITLE",
"description": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_DESC",
"hook": "akconfig_onedrive_openoauth"
},
"engine.postproc.onedrive.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_DIRECTORY_DESCRIPTION"
},
"engine.postproc.onedrive.access_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_ACCESSTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_ACCESSTOKEN_DESCRIPTION"
},
"engine.postproc.onedrive.refresh_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_REFRESHTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_REFRESHTOKEN_DESCRIPTION"
}
}PK \@̘V: : 4 vendor/akeeba/engine/engine/Postproc/Googledrive.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Connector\GoogleDrive as ConnectorGoogleDrive;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Awf\Text\Text;
use Exception;
use Joomla\CMS\Language\Text as JText;
use RuntimeException;
class Googledrive extends Base
{
/**
* The retry count of this file (allow up to 2 retries after the first upload failure)
*
* @var int
*/
private $tryCount = 0;
/**
* The currently configured directory
*
* @var string
*/
private $directory;
/**
* Chunk size (MB)
*
* @var int
*/
private $chunkSize = 10;
/**
* Overrides of any configuration variables when creating a connector object. Used when trying to get a list of
* drives through AJAX.
*
* @var array
*/
private $configOverrides = [];
public function __construct()
{
$this->supportsDownloadToBrowser = false;
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
$this->allowedCustomAPICallMethods[] = 'getDrives';
}
public function oauthCallback(array $params)
{
$input = $params['input'];
$data = (object) [
'access_token' => $input['access_token'],
'refresh_token' => $input['refresh_token'],
];
$serialisedData = json_encode($data);
return <<< HTML
HTML;
}
/**
* Used by the interface to display a list of drives to choose from.
*
* @param array $params
*
* @return array
*
* @throws Exception
*/
public function getDrives($params = [])
{
// Get the default item (the personal Drive)
$baseItem = 'Google Drive (personal)';
if (class_exists('\Joomla\CMS\Language\Text'))
{
$baseItem = JText::_('COM_AKEEBA_CONFIG_GOOGLEDRIVE_TEAMDRIVE_OPT_PERSONAL');
if ($baseItem === 'COM_AKEEBA_CONFIG_GOOGLEDRIVE_TEAMDRIVE_OPT_PERSONAL')
{
$baseItem = JText::_('COM_AKEEBABACKUP_CONFIG_GOOGLEDRIVE_TEAMDRIVE_OPT_PERSONAL');
}
}
if (class_exists('\Awf\Text\Text'))
{
$baseItem = Text::_('COM_AKEEBA_CONFIG_GOOGLEDRIVE_TEAMDRIVE_OPT_PERSONAL');
if ($baseItem === 'COM_AKEEBA_CONFIG_GOOGLEDRIVE_TEAMDRIVE_OPT_PERSONAL')
{
$baseItem = Text::_('COM_AKEEBABACKUP_CONFIG_GOOGLEDRIVE_TEAMDRIVE_OPT_PERSONAL');
}
}
$items = [
'' => $baseItem,
];
// Try to get a list of Team Drives
try
{
$this->configOverrides = $params;
/** @var ConnectorGoogleDrive $connector */
$connector = $this->getConnector(true);
$connector->ping();
$items = array_merge($items, $connector->getTeamDrives());
}
catch (Exception $e)
{
// No worries, the user hasn't configured Google Drive correctly just yet.
}
$ret = [];
foreach ($items as $k => $v)
{
$ret[] = [$k, $v];
}
return $ret;
}
/**
* This function takes care of post-processing a backup archive's part, or the
* whole backup archive if it's not a split archive type. If the process fails
* it should return false. If it succeeds and the entirety of the file has been
* processed, it should return true. If only a part of the file has been uploaded,
* it must return 1.
*
* @param string $localFilepath Absolute path to the part we'll have to process
* @param string $remoteBaseName Base name of the uploaded file, skip to use $absolute_filename's
*
* @return boolean|integer False on failure, true on success, 1 if more work is required
*
* @throws Exception
*/
public function processPart($localFilepath, $remoteBaseName = null)
{
/** @var ConnectorGoogleDrive $connector */
$connector = $this->getConnector(true);
// Get a reference to the engine configuration
$config = Factory::getConfiguration();
// Store the absolute remote path in the class property
$directory = $this->directory;
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$this->remotePath = trim($directory, '/') . '/' . $basename;
// Have I already made sure the remote directory exists?
$folderId = $config->get('volatile.engine.postproc.googledrive.check_directory', 0);
$teamDriveID = $config->get('engine.postproc.googledrive.team_drive', '');
if (!$folderId)
{
try
{
Factory::getLog()->debug(sprintf(
"%s - Preparing to upload to Google Drive, file path = %s.",
__METHOD__, $this->remotePath
));
$connector->ping();
[$fileName, $folderId] = $connector->preprocessUploadPath($this->remotePath, $teamDriveID);
Factory::getLog()->debug(sprintf(
"%s - Google Drive folder ID = %s",
__METHOD__, $folderId
));
}
catch (Exception $e)
{
throw new RuntimeException(sprintf(
"Could not create Google Drive directory %s. ", $directory
), 500, $e);
}
$config->set('volatile.engine.postproc.googledrive.check_directory', $folderId);
}
// Get the remote file's pathname
$remotePath = $this->remotePath;
// Check if the size of the file is compatible with chunked uploading
clearstatcache();
$totalSize = filesize($localFilepath);
/**
* Google Drive is broken.
*
* When you use Simple Upload it will upload your files in two(!!!) places at the same time: the folder you tell
* it and the Drive's root. Why? Nobody knows. It's not what the documentation purports the API should be doing.
*
* The kinda daft way around this is using chunked upload even for tiny files, less than the part size. Many
* more requests to the API server yet it works. That's Google for you, man...
*/
Factory::getLog()->debug(sprintf(
"%s - Using chunked upload, part size %d",
__METHOD__, $this->chunkSize
));
$offset = $config->get('volatile.engine.postproc.googledrive.offset', 0);
$upload_id = $config->get('volatile.engine.postproc.googledrive.upload_id', null);
if (empty($upload_id))
{
// Convert path to folder ID and file ID, creating missing folders and deleting existing files in the process
Factory::getLog()->debug(sprintf(
"%s - Trying to create possibly missing directories and remove existing file by the same name (%s)",
__METHOD__, $remotePath
));
$connector->ping();
[$fileName, $folderId] = $connector->preprocessUploadPath($remotePath, $teamDriveID);
Factory::getLog()->debug(sprintf(
"%s - Creating new upload session",
__METHOD__
));
try
{
$upload_id = $connector->createUploadSession($folderId, $localFilepath, $fileName);
}
catch (Exception $e)
{
throw new RuntimeException(sprintf(
"The upload session for remote file %s cannot be created.", $remotePath
), 500, $e);
}
Factory::getLog()->debug(sprintf(
"%s - New upload session %s",
__METHOD__, $upload_id
));
$config->set('volatile.engine.postproc.googledrive.upload_id', $upload_id);
}
$exception = null;
try
{
if (empty($offset))
{
$offset = 0;
}
Factory::getLog()->debug(sprintf(
"%s - Uploading chunked part (offset:$offset // chunk size: %d)",
__METHOD__, $this->chunkSize
));
$result = $connector->uploadPart($upload_id, $localFilepath, $offset, $this->chunkSize);
Factory::getLog()->debug(sprintf(
"%s - Got uploadPart result %s",
__METHOD__, print_r($result, true)
));
}
catch (Exception $e)
{
Factory::getLog()->debug(sprintf(
"%s - Got uploadPart Exception %s: %s",
__METHOD__, $e->getCode(), $e->getMessage()
));
$exception = $e;
$result = false;
}
// Did we fail uploading?
if ($result === false)
{
// Let's retry
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
throw new RuntimeException(sprintf(
"%s - Maximum number of retries exceeded. The upload has failed.",
__METHOD__
), 500, $exception);
}
Factory::getLog()->debug(sprintf(
"%s - Error detected, trying to force-refresh the tokens",
__METHOD__
));
$this->forceRefreshTokens();
Factory::getLog()->debug(sprintf(
"%s - Retrying chunk upload",
__METHOD__
));
return false;
}
// Are we done uploading?
$nextOffset = $offset + $this->chunkSize - 1;
if (isset($result['name']) || ($nextOffset > $totalSize))
{
Factory::getLog()->debug(sprintf(
"%s - Chunked upload is now complete",
__METHOD__
));
$config->set('volatile.engine.postproc.googledrive.offset', null);
$config->set('volatile.engine.postproc.googledrive.upload_id', null);
$this->tryCount = 0;
return true;
}
// Otherwise, continue uploading
$config->set('volatile.engine.postproc.googledrive.offset', $offset + $this->chunkSize);
return false;
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset))
{
throw new RangeDownloadNotSupported();
}
/** @var ConnectorGoogleDrive $connector */
$connector = $this->getConnector(true);
$connector->ping();
// Download the file
$engineConfig = Factory::getConfiguration();
$teamDriveID = $engineConfig->get('engine.postproc.googledrive.team_drive', '');
$fileId = $connector->getIdForFile($remotePath, false, $teamDriveID);
$connector->download($fileId, $localFile);
}
public function delete($path)
{
/** @var ConnectorGoogleDrive $connector */
$connector = $this->getConnector(true);
$connector->ping();
$engineConfig = Factory::getConfiguration();
$teamDriveID = $engineConfig->get('engine.postproc.googledrive.team_drive', '');
$fileId = $connector->getIdForFile($path, false, $teamDriveID);
$connector->delete($fileId, true);
}
protected function getOAuth2HelperUrl()
{
$config = Factory::getConfiguration();
$oauth2HelperType = $config->get('engine.postproc.googledrive.oauth2_type', 'akeeba');
switch ($oauth2HelperType)
{
case 'custom':
return $config->get('engine.postproc.googledrive.oauth2_helper', '');
default:
return ConnectorGoogleDrive::helperUrl;
}
}
protected function makeConnector()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
if (!empty($this->configOverrides))
{
$config->mergeArray($this->configOverrides);
}
$accessToken = trim($config->get('engine.postproc.googledrive.access_token', ''));
$refreshToken = trim($config->get('engine.postproc.googledrive.refresh_token', ''));
$this->chunkSize = $config->get('engine.postproc.googledrive.chunk_upload_size', 10) * 1024 * 1024;
$defaultDirectory = $config->get('engine.postproc.googledrive.directory', '');
$this->directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Sanity checks
if (empty($refreshToken))
{
throw new BadConfiguration('You have not linked Akeeba Backup with your Google Drive account');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
$dlid = Platform::getInstance()->get_platform_configuration_option('update_dlid', '');
if (empty($dlid))
{
throw new BadConfiguration('You must enter your Download ID in the application configuration before using the “Upload to Google Drive” feature.');
}
// Fix the directory name, if required
$this->directory = empty($this->directory) ? '' : $this->directory;
$this->directory = trim($this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
$connector = new ConnectorGoogleDrive(
$accessToken,
$refreshToken,
$dlid,
$config->get('engine.postproc.googledrive.oauth2_refresh')
);
// Restore the persisted access-token expiry so the connector can refresh proactively (before the token lapses)
// across stepped backup runs, instead of only reacting after a request has already failed.
$connector->setTokenExpiration((int) $config->get('engine.postproc.googledrive.token_expiration', 0));
// Validate the tokens
Factory::getLog()->debug(sprintf(
"%s - Validating the Google Drive tokens",
__METHOD__
));
$pingResult = $connector->ping();
// Save new configuration if there was a refresh
if ($pingResult['needs_refresh'])
{
Factory::getLog()->debug(sprintf(
"%s - Google Drive tokens were refreshed",
__METHOD__
));
$config->set('engine.postproc.googledrive.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.googledrive.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
$connector->setUploadToSharedWithMe(
$config->get('engine.postproc.googledrive.uploadtosharedwithme', 0) == 1
);
return $connector;
}
/**
* Forcibly refresh the Google Drive tokens
*
* @return void
*
* @throws Exception
*/
protected function forceRefreshTokens()
{
/** @var ConnectorGoogleDrive $connector */
$connector = $this->getConnector(true);
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$pingResult = $connector->ping(true);
Factory::getLog()->debug(sprintf(
"%s - Google Drive tokens were forcibly refreshed",
__METHOD__
));
$config->set('engine.postproc.googledrive.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.googledrive.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
}
PK \;V\W> W> 1 vendor/akeeba/engine/engine/Postproc/Onedrive.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Connector\OneDrive as ConnectorOneDrive;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Exception;
use RuntimeException;
/**
* OneDrive (consumer / personal) post-processing engine.
*
* @deprecated Legacy consumer OneDrive integration. Superseded by the Onedrivebusiness engine using the modern
* Microsoft Graph API. Retained only for backwards compatibility with existing backup profiles.
*/
class Onedrive extends Base
{
/**
* The retry count of this file (allow up to 2 retries after the first upload failure)
*
* @var int
*/
protected $tryCount = 0;
/**
* The currently configured directory
*
* @var string
*/
protected $directory;
/**
* Are we using chunk uploads?
*
* @var bool
*/
protected $isChunked = false;
/**
* Chunk size (bytes)
*
* @var int
*/
protected $chunkSize = 10485760;
/**
* The name of the OAuth2 callback method in the parent window (the configuration page)
*
* @var string
*/
protected $callbackMethod = 'akeeba_onedrive_oauth_callback';
/**
* The key in Akeeba Engine's settings registry for this post-processing method
*
* @var string
*/
protected $settingsKey = 'onedrive';
public function __construct()
{
$this->supportsDownloadToBrowser = true;
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
}
public function oauthCallback(array $params)
{
$input = $params['input'];
$data = (object) [
'access_token' => $input['access_token'],
'refresh_token' => $input['refresh_token'],
];
$serialisedData = json_encode($data);
return sprintf(
'',
$this->callbackMethod, $serialisedData
);
}
public function processPart($localFilepath, $remoteBaseName = null)
{
// Do not remove, required to set up $this->directory used below.
/** @var ConnectorOneDrive $connector */
$connector = $this->getConnector();
// Store the absolute remote path in the class property
$directory = $this->directory;
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$this->remotePath = $directory . '/' . $basename;
// Get a reference to the engine configuration
$config = Factory::getConfiguration();
// Have I already made sure the remote directory exists?
$haveCheckedRemoteDirectory = $config->get('volatile.engine.postproc.' . $this->settingsKey . '.check_directory', 0);
if (!$haveCheckedRemoteDirectory)
{
Factory::getLog()->debug(
sprintf(
"%s -- Checking if OneDrive directory %s already exists or needs to be created.",
__METHOD__, $directory
)
);
try
{
$connector->ping();
$connector->makeDirectory($directory);
}
catch (Exception $e)
{
throw new RuntimeException("Could not create directory $directory.", 500, $e);
}
$config->set('volatile.engine.postproc.' . $this->settingsKey . '.check_directory', 1);
}
// Get the remote file's pathname. This MUST use the same basename as $this->remotePath (which getRemotePath()
// reports and downloadToFile()/delete() are later called with), otherwise the file would be stored under the
// local temp file's name instead of the requested remote name and every later lookup would 404.
$remotePath = trim($directory, '/') . '/' . $basename;
// Check if the size of the file is compatible with chunked uploading
clearstatcache();
$totalSize = filesize($localFilepath) ?: 0;
// Chunked uploads if the feature is enabled and the file is at least as big as the chunk size.
if ($this->mustChunk($totalSize) || ($this->isChunked && !$this->mustSingeUpload($totalSize)))
{
return $this->multipartUpload($localFilepath, $remotePath, $totalSize);
}
// Single part upload
return $this->simpleUpload($localFilepath, $remotePath);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset))
{
// Ranges are not supported
throw new RangeDownloadNotSupported();
}
/** @var ConnectorOneDrive $connector */
$connector = $this->getConnector();
$connector->ping();
// Download the file
$connector->download($remotePath, $localFile);
}
public function downloadToBrowser($remotePath)
{
/** @var ConnectorOneDrive $connector */
$connector = $this->getConnector();
$connector->ping();
return $connector->getSignedUrl($remotePath);
}
public function delete($path)
{
/** @var ConnectorOneDrive $connector */
$connector = $this->getConnector();
$connector->ping();
$connector->delete($path);
}
/**
* Do I have to force a chunked upload?
*
* @param int $fileSize
*
* @return bool
*/
protected function mustChunk(int $fileSize): bool
{
return $fileSize > 104857600;
}
/**
* Do I have to force a single part upload?
*
* @param int $fileSize
*
* @return bool
*/
protected function mustSingeUpload(int $fileSize): bool
{
return ($fileSize <= $this->chunkSize) || ($fileSize <= 4194304);
}
protected function makeConnector()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$access_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.access_token', ''));
$refresh_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.refresh_token', ''));
$this->isChunked = $config->get('engine.postproc.' . $this->settingsKey . '.chunk_upload', true);
$this->chunkSize = $config->get('engine.postproc.' . $this->settingsKey . '.chunk_upload_size', 10) * 1024 * 1024;
$defaultDirectory = rtrim($config->get('engine.postproc.' . $this->settingsKey . '.directory', ''), '/');
$this->directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Sanity checks
if (empty($refresh_token))
{
throw new BadConfiguration('You have not linked Akeeba Backup with your OneDrive account');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$this->directory = empty($this->directory) ? '' : $this->directory;
$this->directory = trim($this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
// Get Download ID
$dlid = Platform::getInstance()->get_platform_configuration_option('update_dlid', '');
if (empty($dlid))
{
throw new BadConfiguration('You must enter your Download ID in the application configuration before using the “Upload to OneDrive” feature.');
}
$connector = new ConnectorOneDrive($access_token, $refresh_token, $dlid);
// Restore the persisted access-token expiry so the connector can refresh proactively (before the token lapses)
// across stepped backup runs, instead of only reacting after a request has already failed.
$connector->setTokenExpiration((int) $config->get('engine.postproc.' . $this->settingsKey . '.token_expiration', 0));
// Validate the tokens
Factory::getLog()->debug(__METHOD__ . " - Validating the OneDrive tokens");
$pingResult = $connector->ping();
// Save new configuration if there was a refresh
if ($pingResult['needs_refresh'])
{
Factory::getLog()->debug(__METHOD__ . " - OneDrive tokens were refreshed");
$config->set('engine.postproc.' . $this->settingsKey . '.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.refresh_token', $pingResult['refresh_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
return $connector;
}
/**
* Forcibly refresh the OneDrive tokens
*
* @return void
*
* @throws Exception
*/
protected function forceRefreshTokens()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
/** @var ConnectorOneDrive $connector */
$connector = $this->getConnector();
$pingResult = $connector->ping(true);
Factory::getLog()->debug(__METHOD__ . " - OneDrive tokens were forcibly refreshed");
$config->set('engine.postproc.' . $this->settingsKey . '.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.refresh_token', $pingResult['refresh_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
protected function getOAuth2HelperUrl()
{
return ConnectorOneDrive::helperUrl;
}
/**
* Performs a multipart (chunked) upload.
*
* @param string $localFilepath The path to the local file we'll be uploading.
* @param string $remotePath The path to the file in remote storage
* @param int $totalSize The total size of the file, in bytes.
*
* @return bool True if the upload is complete, false if more work is necessary
* @throws Exception If an upload error occurs
*/
private function multipartUpload($localFilepath, $remotePath, $totalSize)
{
/** @var ConnectorOneDrive $connector */
$connector = $this->getConnector();
// Get a reference to the engine configuration
$config = Factory::getConfiguration();
// Are we already processing a multipart upload?
Factory::getLog()->debug(
sprintf(
"%s - Using chunked upload, part size %d",
__METHOD__, $this->chunkSize
)
);
$offset = $config->get('volatile.engine.postproc.' . $this->settingsKey . '.offset', 0);
$upload_id = $config->get('volatile.engine.postproc.' . $this->settingsKey . '.upload_id', null);
if (empty($upload_id))
{
Factory::getLog()->debug(
sprintf(
"%s - Trying to remove existing file by the same name (%s)",
__METHOD__, $remotePath
)
);
// Try deleting the file first because OneDrive doesn't allow replacing files when using multipart uploads
$connector->delete($remotePath, false);
Factory::getLog()->debug(
sprintf(
"%s - Creating new upload session",
__METHOD__
)
);
try
{
$upload_id = $connector->createUploadSession($remotePath);
}
catch (Exception $e)
{
Factory::getLog()->debug(
sprintf(
"%s - Failed to create a new upload session; will try to refresh the tokens first",
__METHOD__
)
);
$upload_id = null;
}
if (is_null($upload_id))
{
try
{
$this->forceRefreshTokens();
$upload_id = $connector->createUploadSession($remotePath);
}
catch (Exception $e)
{
throw new RuntimeException(
sprintf(
"The upload session for remote file %s cannot be created",
$remotePath
), 500, $e
);
}
}
Factory::getLog()->debug(
sprintf(
"%s - New upload session %s",
__METHOD__, $upload_id
)
);
$config->set('volatile.engine.postproc.' . $this->settingsKey . '.upload_id', $upload_id);
}
try
{
if (empty($offset))
{
$offset = 0;
}
Factory::getLog()->debug(
sprintf(
"%s - Uploading chunked part",
__METHOD__
)
);
$result = $connector->uploadPart($upload_id, $localFilepath, $offset, $this->chunkSize);
Factory::getLog()->debug(
sprintf(
"%s - Got uploadPart result %s",
__METHOD__, print_r($result, true)
)
);
}
catch (Exception $e)
{
Factory::getLog()->debug(
sprintf(
"%s - Got uploadPart Exception %s: %s",
__METHOD__, $e->getCode(), $e->getMessage()
)
);
// Let's retry
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
throw new RuntimeException(
sprintf(
"%s - Maximum number of retries exceeded. The upload has failed.",
__METHOD__
), 500, $e
);
}
Factory::getLog()->debug(
sprintf(
"%s - Error detected, trying to force-refresh the tokens",
__METHOD__
)
);
$this->forceRefreshTokens();
Factory::getLog()->debug(
sprintf(
"%s - Retrying chunk upload",
__METHOD__
)
);
return false;
}
// Are we done uploading?
$nextOffset = $offset + $this->chunkSize - 1;
if (isset($result['name']) || ($nextOffset > $totalSize))
{
Factory::getLog()->debug(
sprintf(
"%s - Chunked upload is now complete",
__METHOD__
)
);
$config->set('volatile.engine.postproc.' . $this->settingsKey . '.offset', null);
$config->set('volatile.engine.postproc.' . $this->settingsKey . '.upload_id', null);
$this->tryCount = 0;
return true;
}
// Otherwise, continue uploading
$config->set('volatile.engine.postproc.' . $this->settingsKey . '.offset', $offset + $this->chunkSize);
return false;
}
/**
* Performs a single part upload
*
* @param string $localFilepath
* @param string $remotePath
*
* @return bool True if the upload is complete, false if more work is necessary
* @throws Exception If an upload error occurs
*/
private function simpleUpload($localFilepath, $remotePath)
{
/** @var ConnectorOneDrive $connector */
$connector = $this->getConnector();
// Get a reference to the engine configuration
$config = Factory::getConfiguration();
try
{
Factory::getLog()->debug(__METHOD__ . " - Simple upload. Proactively deleting files with remote path " . $remotePath);
// Try deleting the file first because OneDrive doesn't allow replacing files when using multipart uploads
$connector->delete($remotePath, false);
Factory::getLog()->debug(__METHOD__ . " - Performing simple upload");
$connector->simpleUpload($remotePath, $localFilepath);
}
catch (Exception $e)
{
Factory::getLog()->debug(__METHOD__ . " - Simple upload failed, " . $e->getCode() . ": " . $e->getMessage());
// Let's retry
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
throw new RuntimeException(__METHOD__ . " - Maximum number of retries exceeded. The upload has failed.", 500, $e);
}
Factory::getLog()->debug(__METHOD__ . " - Error detected, trying to force-refresh the tokens");
$this->forceRefreshTokens();
Factory::getLog()->debug(__METHOD__ . " - Retrying upload");
return false;
}
// Upload complete. Reset the retry counter.
$this->tryCount = 0;
return true;
}
}
PK \KbNA
A
1 vendor/akeeba/engine/engine/Postproc/ftpcurl.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_FTPCURL_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_FTPCURL_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.ftpcurl.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_HOST_DESCRIPTION"
},
"engine.postproc.ftpcurl.port": {
"default": "21",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_PORT_DESCRIPTION"
},
"engine.postproc.ftpcurl.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_USER_DESCRIPTION"
},
"engine.postproc.ftpcurl.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSWORD_DESCRIPTION"
},
"engine.postproc.ftpcurl.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_INITDIR_DESCRIPTION"
},
"engine.postproc.ftpcurl.subdirectory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_OPTSUBDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_OPTSUBDIR_DESCRIPTION"
},
"engine.postproc.ftpcurl.ftps": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_FTPS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_FTPS_DESCRIPTION"
},
"engine.postproc.ftpcurl.passive_mode": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSIVE_DESCRIPTION"
},
"engine.postproc.ftpcurl.passive_mode_workaround": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTPCURL_PASVWORKAROUND_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTPCURL_PASVWORKAROUND_DESCRIPTION",
"showon": "engine.postproc.ftpcurl.passive_mode:1"
},
"engine.postproc.ftpcurl.ftp_test": {
"default": "0",
"type": "button",
"hook": "postprocftpcurl_test_connection",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_TEST_DESCRIPTION"
}
}PK \DEH : vendor/akeeba/engine/engine/Postproc/onedrivebusiness.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_ONEDRIVEBUSINESS_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_ONEDRIVEBUSINESS_DESCRIPTION"
},
"engine.postproc.onedrivebusiness.oauth2_type": {
"default": "akeeba",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_OPT_AKEEBA|COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_OPT_CUSTOM",
"enumvalues": "akeeba|custom",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_DESCRIPTION"
},
"engine.postproc.onedrivebusiness.oauth2_helper": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_HELPER_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_HELPER_DESCRIPTION",
"showon": "engine.postproc.onedrivebusiness.oauth2_type:custom"
},
"engine.postproc.onedrivebusiness.oauth2_refresh": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_REFRESH_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_REFRESH_DESCRIPTION",
"showon": "engine.postproc.onedrivebusiness.oauth2_type:custom"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.onedrivebusiness.chunk_upload": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_ENABLE"
},
"engine.postproc.onedrivebusiness.chunk_upload_size": {
"default": "10",
"type": "integer",
"min": "4",
"max": "60",
"shortcuts": "5|10|20|40|60",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE",
"showon": "engine.postproc.onedrivebusiness.chunk_upload:1"
},
"engine.postproc.onedrivebusiness.openoauth": {
"default": "",
"type": "button",
"title": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_TITLE",
"description": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_DESC",
"hook": "akconfig_onedrivebusiness_openoauth"
},
"engine.postproc.onedrivebusiness.drive": {
"default": "",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_ONEDRIVE_DRIVE_OPT_PERSONAL",
"enumvalues": "",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_DRIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_DRIVE_DESCRIPTION"
},
"engine.postproc.onedrivebusiness.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_DIRECTORY_DESCRIPTION"
},
"engine.postproc.onedrivebusiness.access_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_ACCESSTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_ACCESSTOKEN_DESCRIPTION"
},
"engine.postproc.onedrivebusiness.refresh_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_REFRESHTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_REFRESHTOKEN_DESCRIPTION"
}
}PK \[g, , 6 vendor/akeeba/engine/engine/Postproc/dreamobjects.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_DREAMOBJECTS_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_DREAMOBJECTS_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.dreamobjects.accesskey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DREAMOBJECTSACCESSKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_DREAMOBJECTSACCESSKEY_DESCRIPTION"
},
"engine.postproc.dreamobjects.secretkey": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_DREAMOBJECTSSECRETKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_DREAMOBJECTSSECRETKEY_DESCRIPTION"
},
"engine.postproc.dreamobjects.usessl": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DREAMOBJECTSUSESSL_TITLE",
"description": "COM_AKEEBA_CONFIG_DREAMOBJECTSUSESSL_DESCRIPTION"
},
"engine.postproc.dreamobjects.bucket": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DREAMOBJECTSBUCKET_TITLE",
"description": "COM_AKEEBA_CONFIG_DREAMOBJECTSBUCKET_DESCRIPTION"
},
"engine.postproc.dreamobjects.lowercase": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DREAMOBJECTSLOWERCASE_TITLE",
"description": "COM_AKEEBA_CONFIG_DREAMOBJECTSLOWERCASE_DESCRIPTION"
},
"engine.postproc.dreamobjects.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DREAMOBJECTSDIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_DREAMOBJECTSDIRECTORY_DESCRIPTION"
}
}PK \Ğ^ . vendor/akeeba/engine/engine/Postproc/none.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_NONE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_NONE_DESCRIPTION"
}
}PK \ ! ! / vendor/akeeba/engine/engine/Postproc/Webdav.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\Davclient as ConnectorDavclient;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Exception;
use RuntimeException;
class Webdav extends Base
{
/**
* WebDAV username
*
* @var string
*/
protected $username;
/**
* WebDAV password
*
* @var string
*/
protected $password;
/**
* The retry count of this file (allow up to 2 retries after the first upload failure)
*
* @var int
*/
protected $tryCount = 0;
/**
* The currently configured directory
*
* @var string
*/
protected $directory;
/**
* The key used for storing settings in the Configuration registry
*
* @var string
*/
protected $settingsKey = 'webdav';
public function __construct()
{
$this->supportsDownloadToBrowser = false;
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
try
{
$this->putFile($localFilepath, $basename);
}
catch (Exception $e)
{
// Upload failed. Let's log the failure first.
Factory::getLog()->debug(sprintf("%s - WebDAV upload failed, %s: %s", __METHOD__, $e->getCode(), $e->getMessage()));
// Increase the try counter
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
Factory::getLog()->debug(sprintf("%s - Maximum number of retries exceeded. The upload has failed.", __METHOD__));
throw new RuntimeException('Uploading to WebDAV failed.', 500, $e);
}
Factory::getLog()->debug(sprintf("%s - The upload will be retried", __METHOD__));
return false;
}
// Upload complete. Reset the retry counter.
$this->tryCount = 0;
return true;
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset))
{
// Ranges are not supported
throw new RangeDownloadNotSupported();
}
/** @var ConnectorDavclient $connector */
$connector = $this->getConnector();
$try = 0;
$handle = null;
while ($try < 2)
{
try
{
$handle = fopen($localFile, 'w+');
if ($handle === false)
{
throw new RuntimeException(sprintf('Can not open file %s for writing.', $localFile));
}
$connector->request('GET', $remotePath, $handle);
return;
}
catch (Exception $e)
{
if ($try > 0)
{
throw $e;
}
$try++;
}
finally
{
$this->conditionalFileClose($handle);
}
}
throw new RuntimeException('WebDAV download failed without a reason we can report. This should never happen.');
}
public function delete($path)
{
/** @var ConnectorDavclient $connector */
$connector = $this->getConnector();
// Remove starting slash, or some servers will read it as an absolute path
$path = '/' . ltrim($path, '/');
$try = 0;
while ($try < 2)
{
try
{
$connector->request('DELETE', $path);
return;
}
catch (Exception $e)
{
if ($try > 0)
{
throw $e;
}
$try++;
}
}
throw new RuntimeException('WebDAV file delete failed without a reason we can report. This should never happen.');
}
/**
* Get the WebDAV settings from the backup profile configuration
*
* @return array
*
* @throws BadConfiguration If there's a configuration issue
*/
protected function getSettings()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$username = trim($config->get('engine.postproc.' . $this->settingsKey . '.username', ''));
$password = trim($config->get('engine.postproc.' . $this->settingsKey . '.password', ''));
$url = trim($config->get('engine.postproc.' . $this->settingsKey . '.url', ''));
$defaultDirectory = $config->get('engine.postproc.' . $this->settingsKey . '.directory', '');
$this->directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Sanity checks
if (empty($username) || empty($password))
{
throw new BadConfiguration('You have not linked Akeeba Backup with your WebDav account');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$this->directory = empty($this->directory) ? '' : $this->directory;
$this->directory = trim($this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
$settings = [
'baseUri' => $url,
'userName' => $username,
'password' => $password,
];
// Last chance to modify the settings!
$this->modifySettings($settings);
return $settings;
}
protected function makeConnector()
{
$settings = $this->getSettings();
$connector = new ConnectorDavclient($settings);
$connector->addTrustedCertificates(AKEEBA_CACERT_PEM);
return $connector;
}
/**
* Last chance to modify the settings before we create a WebDAV client.
*
* @param array $settings
*
* @return void
*/
protected function modifySettings(array &$settings)
{
// No changes made in the default class. Only subclasses implement this.
}
/**
* Sends a file to WebDAV. It checks if the path to the file already exists. If not, it creates it.
*
* @param string $absolute_filename The path to the local file which will be uploaded to WebDAV.
* @param string $basename The name
*
* @return array
*
* @throws Exception
*/
protected function putFile($absolute_filename, $basename)
{
/** @var ConnectorDavclient $connector */
$connector = $this->getConnector();
// Normalize double slashes
$directory = str_replace('//', '/', $this->directory);
$basename = str_replace('//', '/', $basename);
// Store the absolute remote path in the class property
// Let's remove the starting slash, otherwise it read as an absolute path
$this->remotePath = trim(trim($directory, '/') . '/' . trim($basename, '/'), '/');
$this->remotePath = str_replace('//', '/', $this->remotePath);
// A directory is supplied, let's check if it really exists or not
if ($directory)
{
$checkPath = '';
$parts = explode('/', $directory);
foreach ($parts as $part)
{
if (empty($part))
{
continue;
}
$checkPath .= $part . '/';
try
{
Factory::getLog()->debug("Checking if the following remote path exists: " . $checkPath);
$connector->propFind($checkPath, ['{DAV:}resourcetype']);
}
catch (Exception $e)
{
/**
* If the folder doesn't exists an error 404 is returned and I can suppress it. If the error code,
* however, is anything different then something went wrong and I have to re-throw the exception and
* let it bubble up.
*/
if ($e->getCode() != 404)
{
throw new $e;
}
Factory::getLog()->debug(sprintf("Remote path %s does not exists, I'm going to create it", $checkPath));
// Folder doesn't exist, let's create it. Throws exception if it fails.
$connector->request('MKCOL', $checkPath);
Factory::getLog()->debug(sprintf("Remote path %s created", $checkPath));
}
}
}
$this->remotePath = '/' . ltrim($this->remotePath, '/');
$result = $connector->request('PUT', $this->remotePath, file_get_contents($absolute_filename));
return $result;
}
}
PK \j 0 vendor/akeeba/engine/engine/Postproc/Ftpcurl.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Transfer\FtpCurl as TransferFtpCurl;
class Ftpcurl extends Ftp
{
public function __construct()
{
parent::__construct();
$this->engineKey = 'engine.postproc.ftpcurl.';
}
protected function makeConnector()
{
Factory::getLog()->debug(__CLASS__ . ':: Connecting to remote FTP');
$options = $this->getConfig();
return new TransferFtpCurl($options);
}
}
PK \4@ 5 vendor/akeeba/engine/engine/Postproc/Dreamobjects.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
/**
* DreamObjects is a sub-case of the Amazon S3 engine with a custom endpoint
*
* @package Akeeba\Engine\Postproc
*/
class Dreamobjects extends Amazons3
{
/**
* Used in log messages.
*
* @var string
*/
protected $engineLogName = 'DreamObjects';
/**
* The prefix to use for volatile key storage
*
* @var string
*/
protected $volatileKeyPrefix = 'volatile.postproc.dreamobjects.';
public function downloadToBrowser($remotePath)
{
$url = parent::downloadToBrowser($remotePath);
// We need to inject the bucket name into the download path since DreamObjects doesn't use virtual-hosting-style access
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'];
$bucket = str_replace('/', '', $bucket);
$url = str_replace('https://objects-us-east-1.dream.io/', 'https://objects-us-east-1.dream.io/' . $bucket . '/', $url);
return $url;
}
/**
* Get the configuration information for this post-processing engine
*
* @return array
*/
protected function getEngineConfiguration(): array
{
$config = Factory::getConfiguration();
$endpoint = "objects-us-east-1.dream.io";
Factory::getLog()->info("DreamObjects: using S3 compatible endpoint $endpoint");
$ret = [
'accessKey' => $config->get('engine.postproc.dreamobjects.accesskey', ''),
'secretKey' => $config->get('engine.postproc.dreamobjects.secretkey', ''),
'token' => '',
'useSSL' => $config->get('engine.postproc.dreamobjects.usessl', 1),
'dualStack' => 0,
'customEndpoint' => $endpoint,
'signatureMethod' => 'v2',
'useLegacyPathAccess' => false,
'region' => '',
'disableMultipart' => 1,
'bucket' => $config->get('engine.postproc.dreamobjects.bucket', null),
'directory' => $config->get('engine.postproc.dreamobjects.directory', null),
'rrs' => 0,
'lowercase' => $config->get('engine.postproc.dreamobjects.lowercase', 1),
'alternateDateHeaderFormat' => true,
'useHTTPDateHeader' => true,
'preSignedBucketInURL' => false,
];
if ($ret['lowercase'] && !empty($ret['bucket']))
{
$ret['bucket'] = strtolower($ret['bucket']);
}
return $ret;
}
}
PK \,z : vendor/akeeba/engine/engine/Postproc/PostProcInterface.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Exception\DeleteNotSupported;
use Akeeba\Engine\Postproc\Exception\DownloadToBrowserNotSupported;
use Akeeba\Engine\Postproc\Exception\DownloadToServerNotSupported;
use Akeeba\Engine\Postproc\Exception\OAuthNotSupported;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Exception;
interface PostProcInterface
{
/**
* This function takes care of post-processing a file (typically a backup archive part file).
*
* If the process has ran to completion it returns true.
*
* If more work is required (the file has only been partially uploaded) it returns false.
*
* It the process has failed an Exception is thrown.
*
* @param string $localFilepath Absolute path to the part we'll have to process
* @param string|null $remoteBaseName Base name of the uploaded file, skip to use $absolute_filename's
*
* @return bool True on success, false if more work is required
*
* @throws Exception When an error occurred during post-processing
*/
public function processPart($localFilepath, $remoteBaseName = null);
/**
* Deletes a remote file
*
* @param string $path The absolute, remote storage path to the file we're deleting
*
* @return void
*
* @throws DeleteNotSupported When this feature is not supported at all.
* @throws Exception When an engine error occurs
*/
public function delete($path);
/**
* Downloads a remotely stored file back to the site's server. It can optionally do a range download. If range
* downloads are not supported we throw a RangeDownloadNotSupported exception. Any other type of Exception means
* that the download failed.
*
* @param string $remotePath The path to the remote file
* @param string $localFile The absolute path to the local file we're writing to
* @param int|null $fromOffset The offset (in bytes) to start downloading from
* @param int|null $length The amount of data (in bytes) to download
*
* @return void
*
* @throws DownloadToServerNotSupported When this feature is not supported at all.
* @throws RangeDownloadNotSupported When range downloads are not supported.
* @throws Exception On failure.
*/
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null);
/**
* Downloads a remotely stored file to the user's browser, without storing it on the site's web server first.
*
* If $this->inlineDownloadToBrowser is true the method outputs a byte stream to the browser and returns null.
*
* If $this->inlineDownloadToBrowser is false it returns a string containing a public download URL. The user's
* browser will be redirected to that URL.
*
* If this feature is not supported a DownloadToBrowserNotSupported exception will be thrown.
*
* Any other Exception indicates an error while trying to download to browser such as file not found, problem with
* the remote service etc.
*
* @param string $remotePath The absolute, remote storage path to the file we want to download
*
* @return string|null
*
* @throws DownloadToBrowserNotSupported When this feature is not supported at all.
* @throws Exception When an error occurs.
*/
public function downloadToBrowser($remotePath);
/**
* A proxy which allows us to execute arbitrary methods in this engine. Used for AJAX calls, typically to update UI
* elements with information fetched from the remote storage service.
*
* For security reasons, only methods whitelisted in the $this->allowedCustomAPICallMethods array can be called.
*
* @param string $method The method to call.
* @param array $params Any parameters to send to the method, in array format
*
* @return mixed The return value of the method.
*/
public function customAPICall($method, $params = []);
/**
* Opens an OAuth window (performs an HTTP redirection).
*
* @param array $params Any parameters required to launch OAuth
*
* @return void
*
* @throws OAuthNotSupported When not supported.
* @throws Exception When an error occurred.
*/
public function oauthOpen($params = []);
/**
* Fetches the authentication token from the OAuth helper script, after you've run the first step of the OAuth
* authentication process. Must be overridden in subclasses.
*
* @param array $params
*
* @return void
*
* @throws OAuthNotSupported
*/
public function oauthCallback(array $params);
/**
* Does the engine recommend doing a step break before post-processing backup archives with it?
*
* @return bool
*/
public function recommendsBreakBefore();
/**
* Does the engine recommend doing a step break after post-processing backup archives with it?
*
* @return bool
*/
public function recommendsBreakAfter();
/**
* Is it advisable to delete files successfully post-processed by this post-processing engine?
*
* Currently only the “None” method advises against deleting successfully post-processed files for the simple reason
* that it does absolutely nothing with the files. The only copy is still on the server.
*
* @return bool
*/
public function isFileDeletionAfterProcessingAdvisable();
/**
* Does this engine support deleting remotely stored files?
*
* Most engines support deletion. However, some engines such as “Send by email”, do not have a way to find files
* already processed and delete them. Or it may be that we are sending the file to a write-only storage service
* which does not support deletions.
*
* @return bool
*/
public function supportsDelete();
/**
* Does this engine support downloading backup archives back to the site's web server?
*
* @return bool
*/
public function supportsDownloadToFile();
/**
* Does this engine support downloading backup archives directly to the user's browser?
*
* @return bool
*/
public function supportsDownloadToBrowser();
/**
* Does this engine return a bytestream when asked to download backup archives directly to the user's browser?
*
* @return bool
*/
public function doesInlineDownloadToBrowser();
/**
* Returns the remote absolute path to the file which was just processed.
*
* @return string
*/
public function getRemotePath();
}
PK \,
; vendor/akeeba/engine/engine/Postproc/googlestoragejson.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_GOOGLESTORAGEJSON_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_GOOGLESTORAGEJSON_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.googlestoragejson.chunk_upload": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_ENABLE"
},
"engine.postproc.googlestoragejson.chunk_upload_size": {
"default": "10",
"type": "integer",
"min": "1",
"max": "1024",
"shortcuts": "1|5|10|20|40|60|100",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE",
"showon": "engine.postproc.googlestoragejson.chunk_upload:1"
},
"engine.postproc.googlestoragejson.bucket": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGEBUCKET_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGEBUCKET_DESCRIPTION"
},
"engine.postproc.googlestoragejson.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGEDIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGEDIRECTORY_DESCRIPTION"
},
"engine.postproc.googlestoragejson.storageclass": {
"default": "0",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_GOOGLESTORAGE_STORAGECLASS_NONE|COM_AKEEBA_CONFIG_GOOGLESTORAGE_STORAGECLASS_STANDARD|COM_AKEEBA_CONFIG_GOOGLESTORAGE_STORAGECLASS_NEARLINE|COM_AKEEBA_CONFIG_GOOGLESTORAGE_STORAGECLASS_COLDLINE",
"enumvalues": "|standard|nearline|coldline",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGE_STORAGECLASS_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGE_STORAGECLASS_DESCRIPTION"
},
"engine.postproc.googlestoragejson.jsoncreds": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGEJSON_CREDS_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGEJSON_CREDS_DESC"
}
}PK \$6.NL L 5 vendor/akeeba/engine/engine/Postproc/googledrive.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_GOOGLEDRIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_GOOGLEDRIVE_DESCRIPTION",
"activation_callback": "akeeba_googledrive_refreshdrives"
},
"engine.postproc.googledrive.oauth2_type": {
"default": "akeeba",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_OPT_AKEEBA|COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_OPT_CUSTOM",
"enumvalues": "akeeba|custom",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_TYPE_DESCRIPTION"
},
"engine.postproc.googledrive.oauth2_helper": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_HELPER_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_HELPER_DESCRIPTION",
"showon": "engine.postproc.googledrive.oauth2_type:custom"
},
"engine.postproc.googledrive.oauth2_refresh": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_REFRESH_TITLE",
"description": "COM_AKEEBA_CONFIG_COMMON_OAUTH2_REFRESH_DESCRIPTION",
"showon": "engine.postproc.googledrive.oauth2_type:custom"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.googledrive.chunk_upload_size": {
"default": "10",
"type": "integer",
"min": "4",
"max": "60",
"shortcuts": "1|5|10|20|40|60|100",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE"
},
"engine.postproc.googledrive.openoauth": {
"default": "",
"type": "button",
"title": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_TITLE",
"description": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_DESC",
"hook": "akconfig_googledrive_openoauth"
},
"engine.postproc.googledrive.refreshdrives": {
"default": "",
"type": "button",
"title": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_REFRESHTEAMDRIVES_TITLE",
"hook": "akeeba_googledrive_refreshdrives"
},
"engine.postproc.googledrive.team_drive": {
"default": "",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_TEAMDRIVE_OPT_PERSONAL",
"enumvalues": "",
"title": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_TEAMDRIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_TEAMDRIVE_DESCRIPTION"
},
"engine.postproc.googledrive.uploadtosharedwithme": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_UPLOADTOSHAREDWITHME_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_UPLOADTOSHAREDWITHME_DESCRIPTION"
},
"engine.postproc.googledrive.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_DIRECTORY_DESCRIPTION"
},
"engine.postproc.googledrive.access_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_ACCESSTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_ACCESSTOKEN_DESCRIPTION"
},
"engine.postproc.googledrive.refresh_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_REFRESHTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLEDRIVE_ACCESSTOKEN_DESCRIPTION"
}
}PK \z;D 9 vendor/akeeba/engine/engine/Postproc/Onedrivebusiness.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Connector\OneDriveBusiness as ConnectorOneDrive;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Awf\Text\Text;
use Exception;
use Joomla\CMS\Language\Text as JText;
class Onedrivebusiness extends Onedrive
{
/**
* The name of the OAuth2 callback method in the parent window (the configuration page)
*
* @var string
*/
protected $callbackMethod = 'akeeba_onedrivebusiness_oauth_callback';
/**
* The key in Akeeba Engine's settings registry for this post-processing method
*
* @var string
*/
protected $settingsKey = 'onedrivebusiness';
public function __construct()
{
parent::__construct();
$this->allowedCustomAPICallMethods[] = 'getDrives';
}
protected function makeConnector()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$access_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.access_token', ''));
$refresh_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.refresh_token', ''));
$this->isChunked = $config->get('engine.postproc.' . $this->settingsKey . '.chunk_upload', true);
$this->chunkSize = $config->get('engine.postproc.' . $this->settingsKey . '.chunk_upload_size', 10) * 1024 * 1024;
$defaultDirectory = rtrim($config->get('engine.postproc.' . $this->settingsKey . '.directory', ''), '/');
$this->directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Sanity checks
if (empty($refresh_token))
{
throw new BadConfiguration('You have not linked Akeeba Backup with your OneDrive account');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$this->directory = empty($this->directory) ? '' : $this->directory;
$this->directory = trim($this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
// Get Download ID
$dlid = Platform::getInstance()->get_platform_configuration_option('update_dlid', '');
if (empty($dlid))
{
throw new BadConfiguration('You must enter your Download ID in the application configuration before using the “Upload to OneDrive” feature.');
}
$driveId = $config->get('engine.postproc.onedrivebusiness.drive', null);
$driveId = $driveId ?: null;
$connector = new ConnectorOneDrive(
$access_token,
$refresh_token,
$dlid,
$driveId,
$config->get('engine.postproc.onedrivebusiness.oauth2_refresh')
);
// Restore the persisted access-token expiry so the connector can refresh proactively (before the token lapses)
// across stepped backup runs, instead of only reacting after a request has already failed.
$connector->setTokenExpiration((int) $config->get('engine.postproc.' . $this->settingsKey . '.token_expiration', 0));
// Validate the tokens
Factory::getLog()->debug(__METHOD__ . " - Validating the OneDrive tokens");
$pingResult = $connector->ping();
// Save new configuration if there was a refresh
if ($pingResult['needs_refresh'])
{
Factory::getLog()->debug(__METHOD__ . " - OneDrive tokens were refreshed");
$config->set('engine.postproc.' . $this->settingsKey . '.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.refresh_token', $pingResult['refresh_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
return $connector;
}
/**
* Used by the interface to display a list of drives to choose from.
*
* @param array $params
*
* @return array
*
* @throws Exception
*/
public function getDrives($params = [])
{
// Get the default item (the personal Drive)
$baseItem = 'Drive (OneDrive Personal)';
if (class_exists('\Joomla\CMS\Language\Text'))
{
$baseItem = JText::_('COM_AKEEBA_CONFIG_ONEDRIVE_DRIVE_OPT_PERSONAL');
if ($baseItem === 'COM_AKEEBA_CONFIG_ONEDRIVE_DRIVE_OPT_PERSONAL')
{
$baseItem = JText::_('COM_AKEEBABACKUP_CONFIG_ONEDRIVE_DRIVE_OPT_PERSONAL');
}
}
if (class_exists('\Awf\Text\Text'))
{
$baseItem = \Awf\Text\Text::_('COM_AKEEBA_CONFIG_ONEDRIVE_DRIVE_OPT_PERSONAL');
if ($baseItem === 'COM_AKEEBA_CONFIG_ONEDRIVE_DRIVE_OPT_PERSONAL')
{
$baseItem = \Awf\Text\Text::_('COM_AKEEBABACKUP_CONFIG_ONEDRIVE_DRIVE_OPT_PERSONAL');
}
}
$items = [
'' => $baseItem,
];
// Try to get a list of Team Drives
try
{
$this->configOverrides = $params;
/** @var \Akeeba\Engine\Postproc\Connector\OneDriveBusiness $connector */
$connector = $this->getConnector(true);
$connector->ping();
$items = array_merge($items, $connector->getDrives());
}
catch (Exception $e)
{
// No worries, the user hasn't configured Google Drive correctly just yet.
}
$ret = [];
foreach ($items as $k => $v)
{
$ret[] = [$k, $v];
}
return $ret;
}
protected function getOAuth2HelperUrl()
{
$config = Factory::getConfiguration();
$oauth2HelperType = $config->get('engine.postproc.onedrivebusiness.oauth2_type', 'akeeba');
switch ($oauth2HelperType)
{
case 'custom':
return $config->get('engine.postproc.onedrivebusiness.oauth2_helper', '');
default:
return ConnectorOneDrive::helperUrl;
}
}
/** @inheritDoc */
protected function mustChunk(int $fileSize): bool
{
return $fileSize > 4194304;
}
/** @inheritDoc */
protected function mustSingeUpload(int $fileSize): bool
{
return ($fileSize <= $this->chunkSize) || ($fileSize <= 4194304);
}
}
PK \vB
. vendor/akeeba/engine/engine/Postproc/sftp.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_SFTP_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_SFTP_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.sftp.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_HOST_DESCRIPTION"
},
"engine.postproc.sftp.port": {
"default": "22",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PORT_DESCRIPTION"
},
"engine.postproc.sftp.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_USER_DESCRIPTION"
},
"engine.postproc.sftp.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PASSWORD_DESCRIPTION"
},
"engine.postproc.sftp.privkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_DESCRIPTION"
},
"engine.postproc.sftp.pubkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_DESCRIPTION"
},
"engine.postproc.sftp.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_INITDIR_DESCRIPTION"
},
"engine.postproc.sftp.sftp_test": {
"default": "0",
"type": "button",
"hook": "postprocsftp_test_connection",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_TEST_DESCRIPTION"
}
}PK \(Y.
*/
namespace Akeeba\Engine\Postproc;
use Akeeba\Engine\Platform;
trait ProxyAware
{
/**
* Apply the platform proxy configuration to the cURL resource.
*
* @param resource $ch The cURL resource, returned by curl_init();
*/
protected function applyProxySettingsToCurl($ch)
{
if (defined('AKEEBA_NO_PROXY_AWARE'))
{
return;
}
$proxySettings = Platform::getInstance()->getProxySettings();
if (!$proxySettings['enabled'])
{
return;
}
curl_setopt($ch, CURLOPT_PROXY, $proxySettings['host'] . ':' . $proxySettings['port']);
if (empty($proxySettings['user']))
{
return;
}
curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxySettings['user'] . ':' . $proxySettings['pass']);
}
protected function getProxyStreamContext()
{
if (defined('AKEEBA_NO_PROXY_AWARE'))
{
return [];
}
$ret = [];
$proxySettings = Platform::getInstance()->getProxySettings();
if (!$proxySettings['enabled'])
{
return $ret;
}
$ret['http'] = [
'proxy' => $proxySettings['host'] . ':' . $proxySettings['port'],
'request_fulluri' => true,
];
$ret['ftp'] = [
'proxy' => $proxySettings['host'] . ':' . $proxySettings['port'],
// So, request_fulluri isn't documented for the FTP transport but seems to be required...?!
'request_fulluri' => true,
];
if (empty($proxySettings['user']))
{
return $ret;
}
$ret['http']['header'] = ['Proxy-Authorization: Basic ' . base64_encode($proxySettings['user'] . ':' . $proxySettings['pass'])];
$ret['ftp']['header'] = ['Proxy-Authorization: Basic ' . base64_encode($proxySettings['user'] . ':' . $proxySettings['pass'])];
return $ret;
}
}PK \DSt - vendor/akeeba/engine/engine/Postproc/ovh.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_OVH_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_OVH_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.ovh.projectid": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_OVH_PROJECTID_TITLE",
"description": "COM_AKEEBA_CONFIG_OVH_PROJECTID_DESCRIPTION"
},
"engine.postproc.ovh.username": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_OVH_USERNAME_TITLE",
"description": "COM_AKEEBA_CONFIG_OVH_USERNAME_DESCRIPTION"
},
"engine.postproc.ovh.password": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_OVH_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_OVH_PASSWORD_DESCRIPTION"
},
"engine.postproc.ovh.containerurl": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_OVH_CONTAINERURL_TITLE",
"description": "COM_AKEEBA_CONFIG_OVH_CONTAINERURL_DESCRIPTION"
},
"engine.postproc.ovh.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_OVH_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_OVH_DIRECTORY_DESCRIPTION"
}
}PK \"6# > vendor/akeeba/engine/engine/Postproc/Connector/OneDriveApp.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
/**
* OneDrive (custom Azure AD application) API connector.
*
* @deprecated Legacy OneDrive connector tied to a per-user custom OAuth2 application. Superseded by the
* OneDriveBusiness connector using the modern Microsoft Graph API. Retained only for backwards compatibility.
*/
class OneDriveApp extends OneDrive
{
/**
* The URL of the helper script which is used to get fresh API tokens
*/
public const helperUrl = 'https://www.akeeba.com/oauth2/onedriveapp.php';
/**
* Size limit for single part uploads.
*
* This is 4MB per https://docs.microsoft.com/en-us/graph/api/driveitem-put-content?view=graph-rest-1.0&tabs=http
*/
public const simpleUploadSizeLimit = 4194304;
/**
* Item property to set the name conflict behavior
*
* @see https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/direct-endpoint-differences?view=odsp-graph-online#instance-annotations
*/
public const nameConflictBehavior = '@microsoft.graph.conflictBehavior';
/**
* The root URL for the MS Graph API
*
* @see https://docs.microsoft.com/en-us/graph/api/resources/onedrive?view=graph-rest-1.0
*/
protected $rootUrl = 'https://graph.microsoft.com/v1.0/me/drive/special/approot';
/**
* Get the raw listing of a folder
*
* @param string $path The relative path of the folder to list its contents
* @param string $searchString If set returns only items matching the search criteria
*
* @return array See http://onedrive.github.io/items/list.htm
*
* @see https://docs.microsoft.com/en-us/graph/api/driveitem-list-children?view=graph-rest-1.0&tabs=http
* @see https://docs.microsoft.com/en-us/graph/api/driveitem-search?view=graph-rest-1.0&tabs=http
*/
public function getRawContents($path, $searchString = null)
{
$collection = empty($searchString) ? 'children' : 'search';
$relativeUrl = $this->normalizeDrivePath($path, $collection);
/**
* Search for items?
*
* @see https://docs.microsoft.com/en-us/graph/api/driveitem-search?view=graph-rest-1.0&tabs=http
*/
if ($searchString)
{
$relativeUrl .= sprintf('(q=\'%s\')', urlencode($searchString));
}
$result = $this->fetch('GET', $relativeUrl);
return $result;
}
/**
* Creates a new multipart upload session and returns its upload URL
*
* @param string $path Relative path in the Drive
*
* @return string The upload URL for the session
*/
public function createUploadSession($path)
{
$relativeUrl = $this->normalizeDrivePath($path, 'createUploadSession');
$explicitPost = (object) [
'item' => [
static::nameConflictBehavior => 'replace',
'name' => basename($path),
],
];
$explicitPost = json_encode($explicitPost);
$info = $this->fetch('POST', $relativeUrl, [
'headers' => [
'Content-Type: application/json',
],
], $explicitPost);
return $info['uploadUrl'];
}
/**
* Return information about the application folder
*
* @return array See https://learn.microsoft.com/en-us/graph/api/drive-get-specialfolder?view=graph-rest-1.0&tabs=http
*/
public function getDriveInformation()
{
return $this->fetch('GET', '');
}
protected function normalizeDrivePath($relativePath, $collection = '')
{
$path = trim($relativePath, '/');
if (!empty($path))
{
$path = ':/' . $path;
}
if (!empty($collection))
{
if ($path !== ':/')
{
$path .= ':/';
}
$path .= $collection;
}
return $path;
}
}PK \MF_ 1 1 < vendor/akeeba/engine/engine/Postproc/Connector/Backblaze.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Backblaze\AccountInformation;
use Akeeba\Engine\Postproc\Connector\Backblaze\BucketInformation;
use Akeeba\Engine\Postproc\Connector\Backblaze\Exception\APIError;
use Akeeba\Engine\Postproc\Connector\Backblaze\Exception\cURLError;
use Akeeba\Engine\Postproc\Connector\Backblaze\Exception\InvalidJSON;
use Akeeba\Engine\Postproc\Connector\Backblaze\Exception\NotAllowed;
use Akeeba\Engine\Postproc\Connector\Backblaze\Exception\UnexpectedHTTPStatus;
use Akeeba\Engine\Postproc\Connector\Backblaze\FileInformation;
use Akeeba\Engine\Postproc\Connector\Backblaze\UploadURL;
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use Akeeba\Engine\Util\HashTrait;
use DomainException;
use OutOfBoundsException;
use RuntimeException;
/**
* Backblaze B2 API connector
*/
class Backblaze
{
use HashTrait;
use FileCloseAware;
use ProxyAware;
/**
* The API entry point URL, only used to retrieve the authorization token.
* Backblaze retired v1–v3 of b2_authorize_account on 2026-05-29; only v4 is accepted.
* Other endpoints still resolve against the per-account apiUrl returned by authorize.
*/
public const apiURL = "https://api.backblazeb2.com/b2api/v4/";
/** @var string The Backblaze B2 Account ID */
private $accountId;
/** @var AccountInformation Account information returned from authorizeAccount */
private $accountInformation;
/** @var string The Backblaze B2 Application Key */
private $applicationKey;
/** @var BucketInformation[] A list of the buckets in this account, used by getBucketId */
private $buckets;
/**
* Default cURL options
*
* @var array
*/
private $defaultOptions = [
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
CURLOPT_VERBOSE => false,
CURLOPT_HEADER => false,
CURLINFO_HEADER_OUT => false,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
];
/**
* Creates a new Backblaze B2 API Connector object.
*
* @param string $accountId The Backblaze B2 Account ID
* @param string $applicationKey The Backblaze B2 Application Key
*/
public function __construct($accountId, $applicationKey)
{
$this->accountId = $accountId;
$this->applicationKey = $applicationKey;
}
/**
* Cancel a multipart upload
*
* @param string $fileId The fileId returned by startUpload
*
* @return FileInformation The information of the file being canceled
*/
public function cancelUpload($fileId)
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
$apiUrl = $this->getApiUrl();
$explicitPost = json_encode([
'fileId' => $fileId,
]);
$additional = [
'headers' => [
'Accept: application/json',
],
];
$apiReturn = $this->fetch('POST', $apiUrl, 'b2api/v1/b2_cancel_large_file', $additional, $explicitPost);
return new FileInformation($apiReturn);
}
/**
* Deletes a specific version of a file, given a file ID.
*
* @param string $fileName The filename to delete all versions of. Can be a path.
* @param string $fileId The file ID to delete.
*
* @return void
*/
public function deleteByFileId($fileName, $fileId)
{
if (!$this->getAccountInformation()->allowed->canDeleteFiles())
{
throw new NotAllowed('Deleting files');
}
$apiUrl = $this->getApiUrl();
$body = [
'fileName' => $fileName,
'fileId' => $fileId,
];
$additional = [
'headers' => [
'Accept: application/json',
],
];
$this->fetch('POST', $apiUrl, '/b2api/v1/b2_delete_file_version', $additional, json_encode($body));
}
/**
* Deletes all versions of a file, given a filename. Uses getFileVersions internally.
*
* @param string $bucketId The bucket ID. Use getBucketId.
* @param string $fileName The filename to delete all versions of. Can be a path.
*
* @return void
*/
public function deleteByFileName($bucketId, $fileName)
{
if (!$this->getAccountInformation()->allowed->canDeleteFiles())
{
throw new NotAllowed('Deleting files');
}
$files = $this->getFileVersions($bucketId, $fileName);
if (empty($files))
{
return;
}
foreach ($files as $file)
{
$this->deleteByFileId($file->fileName, $file->fileId);
}
}
/**
* Download a file when you know its name
*
* @param string $bucketName The name of the bucket you are downloading from
* @param string $fileName The path of the file in the bucket you are downloading
* @param string $localFile The path of the file in your local filesystem (download target)
* @param array $headers HTTP headers to pass, see the link below
*
* @return void
*
* @see https://www.backblaze.com/b2/docs/b2_download_file_by_name.html
*/
public function downloadFile($bucketName, $fileName, $localFile, $headers = [])
{
if (!$this->getAccountInformation()->allowed->canReadFiles())
{
throw new NotAllowed('Reading files');
}
if (!$this->getAccountInformation()->allowed->isBucketAllowed($bucketName))
{
throw new NotAllowed("Accessing the $bucketName bucket");
}
if (!$this->getAccountInformation()->allowed->isPrefixAllowed($fileName))
{
throw new NotAllowed("Accessing the $fileName file; the prefix (directory) is not allowed)");
}
$accountInfo = $this->getAccountInformation();
$url = rtrim($accountInfo->downloadUrl, '/') . '/';
$relativeUrl = 'file/' . $bucketName . '/' . ltrim($fileName, '/');
$this->fetch('GET', $url, $relativeUrl, [
'headers' => $headers,
'file' => $localFile,
'file_mode' => 'wb',
]);
}
/**
* Download a file when you know its ID
*
* @param string $fileId The file ID returned when uploading or by getFileVersions
* @param string $localFile The path of the file in your local filesystem (download target)
* @param array $headers HTTP headers to pass, see the link below
*
* @return void
*
* @see https://www.backblaze.com/b2/docs/b2_download_file_by_id.html
*/
public function downloadFileById($fileId, $localFile, $headers = [])
{
if (!$this->getAccountInformation()->allowed->canReadFiles())
{
throw new NotAllowed('Reading files');
}
$accountInfo = $this->getAccountInformation();
$url = rtrim($accountInfo->downloadUrl, '/') . '/';
$relativeUrl = 'b2api/v1/b2_download_file_by_id?fileId=' . $fileId;
$this->fetch('GET', $url, $relativeUrl, [
'headers' => $headers,
'file' => $localFile,
'file_mode' => 'wb',
]);
}
/**
* Finishes a multipart file upload.
*
* @param string $fileId The ID of the file being uploaded
* @param string[] $sha1PerPart List of SHA-1 sums per uploaded part. First part at array index 0.
*
* @return FileInformation Note that you should not expect to get the SHA-1 of the entire file, per API docs.
*/
public function finishUpload($fileId, $sha1PerPart)
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
$apiUrl = $this->getApiUrl();
$explicitPost = json_encode([
'fileId' => $fileId,
'partSha1Array' => $sha1PerPart,
]);
$additional = [
'headers' => [
'Accept: application/json',
],
];
$apiReturn = $this->fetch('POST', $apiUrl, 'b2api/v1/b2_finish_large_file', $additional, $explicitPost);
return new FileInformation($apiReturn);
}
/**
* Get the account information stored in this connector API object
*
* @return AccountInformation
*/
public function getAccountInformation()
{
if (empty($this->accountInformation))
{
$this->authorizeAccount();
}
if (!$this->accountInformation->isValid())
{
$this->authorizeAccount();
}
return $this->accountInformation;
}
/**
* Reinitialize the connector API object with a stored account information object. If the object is out of date or
* you pass null we will retrieve a new AccountInformation object through the B2 API.
*
* @param AccountInformation $accountInformation
*/
public function setAccountInformation($accountInformation)
{
if (is_null($accountInformation) || (!$accountInformation->isValid()))
{
$this->authorizeAccount();
return;
}
$this->accountInformation = $accountInformation;
}
/**
* Get the bucket ID, required for use in the API, from the unique bucket name which the end user knows and sees in
* the BackBlaze B2 interface.
*
* @param string $name The name of the bucket you want the ID for
* @param bool $forceRefresh This method caches the list of buckets. Pass true to force reloading this list
* from BackBlaze B2 (useful if you just added a bucket)
*
* @return string The bucket ID
*/
public function getBucketId($name, $forceRefresh = false)
{
if ($this->getAccountInformation()->allowed->bucketName == $name)
{
return $this->getAccountInformation()->allowed->bucketId;
}
if (empty($this->buckets) || $forceRefresh)
{
$this->buckets = $this->listBuckets();
}
foreach ($this->buckets as $bucket)
{
if ($bucket->bucketName == $name)
{
return $bucket->bucketId;
}
}
throw new DomainException(sprintf('Bucket %s not found under this BackBlaze B2 account', $name));
}
/**
* Returns the available file versions for a given file path.
*
* @param string $bucketId The bucket ID. Use getBucketId.
* @param string $fileName The filename to return versions for. Can be a path.
*
* @return FileInformation[] The FileInformation objects for each file version.
*/
public function getFileVersions($bucketId, $fileName)
{
if (!$this->getAccountInformation()->allowed->canReadFiles())
{
throw new NotAllowed('Reading files');
}
$apiUrl = $this->getApiUrl();
$body = [
'bucketId' => $bucketId,
'prefix' => $fileName,
];
$additional = [
'headers' => [
'Accept: application/json',
],
];
$apiReturn = $this->fetch('POST', $apiUrl, '/b2api/v1/b2_list_file_versions', $additional, json_encode($body));
$return = [];
foreach ($apiReturn['files'] as $file)
{
// If no fileName is returned that's a folder
if (empty($file['fileName']))
{
continue;
}
// The API returns versions for all files, starting with the one we requested. Hence the filtering here.
if ($file['fileName'] != $fileName)
{
continue;
}
$return[] = new FileInformation($file);
}
return $return;
}
/**
* Get the upload URL, including the special upload authorization token, for multipart file uploads.
*
* This is the second step. The next steps are uploadPart and either finishUpload to finalize the upload, or
* cancelUpload to abort the multipart upload process.
*
* @param string $fileId
*
* @return UploadURL
*/
public function getPartUploadUrl($fileId)
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
$apiUrl = $this->getApiUrl();
$explicitPost = json_encode([
'fileId' => $fileId,
]);
$additional = [
'headers' => [
'Accept: application/json',
],
];
$apiReturn = $this->fetch('POST', $apiUrl, 'b2api/v1/b2_get_upload_part_url', $additional, $explicitPost);
return new UploadURL($apiReturn);
}
/**
* Create a singed URL which allows anyone to download a file for a specific period of time.
*
* @param string $bucketName The name of the bucket you are downloading from
* @param string $fileName The path of the file in the bucket you are downloading
* @param int $expiresIn How many seconds will the URL be valid for. Default is the maximum, one week.
*
* @return string The signed download URL which can be shared
*/
public function getSignedUrl($bucketName, $fileName, $expiresIn = 604800)
{
if (!$this->getAccountInformation()->allowed->canReadFiles())
{
throw new NotAllowed('Reading files');
}
// Let's get the bucket ID
$bucketId = $this->getBucketId($bucketName);
// $expiresIn must be between 1 and 604800 seconds
$expiresIn = min($expiresIn, 604800);
$expiresIn = max(1, $expiresIn);
// Use b2_get_download_authorization to get a temporary authorization code
$apiUrl = $this->getApiUrl();
$body = [
'bucketId' => $bucketId,
'fileNamePrefix' => $fileName,
'validDurationInSeconds' => $expiresIn,
];
$additional = [
'headers' => [
'Accept: application/json',
],
];
$authResponse = $this->fetch('POST', $apiUrl, '/b2api/v1/b2_get_download_authorization', $additional, json_encode($body));
// Construct the signed URL
$accountInfo = $this->getAccountInformation();
$url = rtrim($accountInfo->downloadUrl, '/');
$url .= '/file/' . $bucketName . '/' . ltrim($fileName, '/');
$url .= '?Authorization=' . $authResponse['authorizationToken'];
return $url;
}
/**
* Gets the URL for the upload API of the given bucket
*
* @param string $bucketId The ID of the bucket (NOT the name!). Use getBucketId to retrieve it.
*
* @return UploadURL The Upload URL object
*/
public function getUploadUrl($bucketId)
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
$apiUrl = $this->getApiUrl();
$explicitPost = json_encode([
'bucketId' => $bucketId,
]);
$additional = [
'headers' => [
'Accept: application/json',
],
];
$apiReturn = $this->fetch('POST', $apiUrl, 'b2api/v1/b2_get_upload_url', $additional, $explicitPost);
return new UploadURL($apiReturn);
}
/**
* List all of the buckets in the account
*
* @return BucketInformation[]
*
* @see https://www.backblaze.com/b2/docs/b2_list_buckets.html
*/
public function listBuckets()
{
if (!$this->getAccountInformation()->allowed->canListBuckets())
{
throw new NotAllowed('Retrieving a list of your BackBlaze B2 buckets');
}
$apiUrl = $this->getApiUrl();
$explicitPost = json_encode([
'accountId' => $this->getAccountInformation()->accountId,
]);
$additional = [
'headers' => [
'Accept: application/json',
],
];
$apiReturn = $this->fetch('POST', $apiUrl, 'b2api/v1/b2_list_buckets', $additional, $explicitPost);
$return = [];
foreach ($apiReturn['buckets'] as $bucket)
{
$return[] = new BucketInformation($bucket);
}
return $return;
}
/**
* Start a multipart upload of a large file.
*
* This is the first step. The next step is getPartUploadUrl.
*
* @param string $bucketId The ID of the bucket where the file is being uploaded to
* @param string $remoteFile The path of the file in Backblaze
* @param string $contentType MIME content type of the file
*
* @return FileInformation
*/
public function startUpload($bucketId, $remoteFile, $contentType = 'application/octet-stream')
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
if (!$this->getAccountInformation()->allowed->isPrefixAllowed($remoteFile))
{
throw new NotAllowed("Accessing the $remoteFile file; the prefix (directory) is not allowed)");
}
$apiUrl = $this->getApiUrl();
$explicitPost = json_encode([
'bucketId' => $bucketId,
'fileName' => $remoteFile,
'contentType' => $contentType,
]);
$additional = [
'headers' => [
'Accept: application/json',
],
];
$apiReturn = $this->fetch('POST', $apiUrl, 'b2api/v1/b2_start_large_file', $additional, $explicitPost);
return new FileInformation($apiReturn);
}
/**
* Upload a file. Automatically determines single- or multi-part upload based on the size of the file, the part
* size and the absolute minimum part size that's possible.
*
* @param string $bucketId The ID of the bucket. Use getBucketId.
* @param string $remoteFile The path of the uploaded file in B2
* @param string $localFile Path to the file to upload
* @param int $partSize Part size for multipart uploads, default 5M
* @param string $contentType MIME content type of the uploaded file
*
* @return FileInformation
*/
public function uploadFile($bucketId, $remoteFile, $localFile, $partSize = 5242880, $contentType = 'application/octet-stream')
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
clearstatcache(false, $localFile);
$fileSize = @filesize($localFile);
$minPartSize = $this->getAccountInformation()->absoluteMinimumPartSize;
if (($fileSize < $minPartSize) || ($partSize < $minPartSize))
{
return $this->uploadSingleFile($bucketId, $remoteFile, $localFile, $contentType);
}
/**
* Backblaze supports up to 10000 parts. We have to try increasing the part size until we're sure our file
* will upload in a number of parts that's less than that.
*/
while ($fileSize / $partSize > 10000)
{
// Increase by 5M in each step
$partSize += 5242880;
}
return $this->uploadLargeFile($bucketId, $remoteFile, $localFile, $partSize, $contentType);
}
/**
* Upload a file using a multipart upload.
*
* @param string $bucketId The ID of the bucket. Use getBucketId.
* @param string $remoteFile The path of the uploaded file in B2
* @param string $localFile Path to the file to upload
* @param int $partSize Part size for multipart uploads, default 5M
* @param string $contentType MIME content type of the uploaded file
*
* @return FileInformation
*/
public function uploadLargeFile($bucketId, $remoteFile, $localFile, $partSize = 5242880, $contentType = 'application/octet-stream')
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
if (!$this->getAccountInformation()->allowed->isPrefixAllowed($remoteFile))
{
throw new NotAllowed("Accessing the $remoteFile file; the prefix (directory) is not allowed)");
}
$fileStartInfo = $this->startUpload($bucketId, $remoteFile, $contentType);
$uploadUrl = $this->getPartUploadUrl($fileStartInfo->fileId);
$partNumber = 0;
$sha1Array = [];
while (true)
{
try
{
$partInfo = $this->uploadPart($uploadUrl, $localFile, ++$partNumber, $partSize);
$sha1Array[] = $partInfo->contentSha1;
}
catch (OutOfBoundsException $e)
{
// I am done uploading parts
break;
}
}
return $this->finishUpload($fileStartInfo->fileId, $sha1Array);
}
/**
* Upload a part of a large file.
*
* @param UploadURL $uploadUrl The upload URL information returned by getPartUploadUrl
* @param string $localFile The local file to read from. Must be readable.
* @param int $partNumber The part number, 1 to 10,000.
* @param int $partSize The part size in bytes.
*
* @return FileInformation Keep that in an array. You'll need to pass that to finishUpload.
*/
public function uploadPart(UploadURL $uploadUrl, $localFile, $partNumber, $partSize = 5242880)
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
clearstatcache(false, $localFile);
$filesize = filesize($localFile);
// The offset to read from the file. Remember: part numbers start at 1, file offsets start at 0.
$offset = ($partNumber - 1) * $partSize;
// Sanity check: does this part even exist?
if ($filesize <= $offset)
{
throw new OutOfBoundsException(sprintf("Cannot read part %d of file %s. The file only has %d bytes, requested offset is at %d bytes.", $partNumber, $localFile, $filesize, $offset));
}
// Read the part off the file and calculate the information required by Backblaze
$fp = @fopen($localFile, 'r');
if ($fp === false)
{
throw new RuntimeException(sprintf('Failed to multipart upload file %s to BackBlaze: cannot open file for reading', $localFile));
}
if (fseek($fp, $offset) == -1)
{
$this->conditionalFileClose($fp);
throw new RuntimeException(sprintf('Failed to multipart upload file %s to BackBlaze: cannot seek to offset %d', $localFile, $offset));
}
$data = fread($fp, $partSize);
if ($data === false)
{
$this->conditionalFileClose($fp);
throw new RuntimeException(sprintf('Failed to multipart upload file %s to BackBlaze: cannot read from file at offset %d, data length %d', $localFile, $offset, $partSize));
}
$this->conditionalFileClose($fp);
$sha1 = self::sha1($data);
$contentLength = strlen($data);
$additional = [
'headers' => [
'Accept: application/json',
sprintf('Content-Length: %s', $contentLength),
sprintf('X-Bz-Part-Number: %d', $partNumber),
sprintf('X-Bz-Content-Sha1: %s', $sha1),
// WARNING: Uploads use a different authorization token than the API itself!
sprintf('Authorization: %s', $uploadUrl->authorizationToken),
],
];
$apiReturn = $this->fetch('POST', $uploadUrl->uploadUrl, '', $additional, $data);
return new FileInformation($apiReturn);
}
/**
* Single part upload of a file to BackBlaze B2
*
* @param string $bucketId The ID of the bucket to upload to. Use getBucketId to fetch it.
* @param string $remoteFile The path of the file in the bucket.
* @param string $localFile The path to the local file to upload.
* @param string $contentType The MIME content type of the uploaded file.
*
* @return FileInformation
*/
public function uploadSingleFile($bucketId, $remoteFile, $localFile, $contentType = 'application/octet-stream')
{
if (!$this->getAccountInformation()->allowed->canWriteFiles())
{
throw new NotAllowed('Writing to files');
}
if (!$this->getAccountInformation()->allowed->isPrefixAllowed($remoteFile))
{
throw new NotAllowed("Accessing the $remoteFile file; the prefix (directory) is not allowed)");
}
$uploadUrl = $this->getUploadUrl($bucketId);
clearstatcache(false, $localFile);
$sha1 = self::sha1_file($localFile);
$contentLength = filesize($localFile);
$additional = [
'headers' => [
'Accept: application/json',
sprintf('X-Bz-File-Name: %s', $remoteFile),
sprintf('Content-Type: %s', $contentType),
sprintf('Content-Length: %s', $contentLength),
sprintf('X-Bz-Content-Sha1: %s', $sha1),
// WARNING: Uploads use a different authorization token than the API itself!
sprintf('Authorization: %s', $uploadUrl->authorizationToken),
],
'file' => $localFile,
];
$apiReturn = $this->fetch('POST', $uploadUrl->uploadUrl, '', $additional);
return new FileInformation($apiReturn);
}
/**
* Uses the account ID and application key to retrieve a (temporary) authorization token which will be used in all
* subsequent operations. Furthermore, it will retrieve information regarding the account-specific API URLs, the
* account-specific download URLs and the supported part sizes. The information is retrieved as an immutable
* AccountInformation object which you can retrieve through getAccountInformation.
*
* If you have already run this and have an AccountInformation object you can use the applyAccountInformation
* method to re-initialize this object
*
* @return void
*/
protected function authorizeAccount()
{
$additional = [
'headers' => [
sprintf('Authorization: Basic %s', base64_encode($this->accountId . ':' . $this->applicationKey)),
'Accept: application/json',
],
];
$apiReturn = $this->fetch('GET', static::apiURL, 'b2_authorize_account', $additional);
$this->accountInformation = new AccountInformation($apiReturn);
}
/**
* Execute an API call
*
* @param string $method The HTTP method
* @param string $baseUrl The base URL. Use one of self::rootUrl or self::contentRootUrl
* @param string $relativeUrl The relative URL to ping
* @param array $additional Additional parameters
* @param mixed $explicitPost Passed explicitly to POST requests if set, otherwise $additional is passed.
*
* @return array
* @throws RuntimeException
*
*/
protected function fetch($method, $baseUrl, $relativeUrl, array $additional = [], $explicitPost = null)
{
// Get full URL, if required
$url = $relativeUrl;
if (substr($relativeUrl, 0, 6) != 'https:')
{
$url = $baseUrl . ltrim($relativeUrl, '/');
}
// Should I expect a specific header?
$expectHttpStatus = [];
if (isset($additional['expect-status']))
{
$expectHttpStatus = $additional['expect-status'];
if (!is_array($expectHttpStatus))
{
$expectHttpStatus = [$expectHttpStatus];
}
unset($additional['expect-status']);
}
// Am I told to not parse the result?
$noParse = false;
if (isset($additional['no-parse']))
{
$noParse = $additional['no-parse'];
unset ($additional['no-parse']);
}
// Am I told not to follow redirections?
$followRedirect = true;
if (isset($additional['follow-redirect']))
{
$followRedirect = $additional['follow-redirect'];
unset ($additional['follow-redirect']);
}
// Initialise and execute a cURL request
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
// Get the default options array
$options = $this->defaultOptions;
// Do I have explicit cURL options to add?
if (isset($additional['curl-options']) && is_array($additional['curl-options']))
{
// We can't use array_merge since we have integer keys and array_merge reassigns them :(
foreach ($additional['curl-options'] as $k => $v)
{
$options[$k] = $v;
}
}
// Set up custom headers
$headers = [];
$hasAuthorizationHeader = false;
if (isset($additional['headers']))
{
$headers = $additional['headers'];
unset ($additional['headers']);
}
// Add the authorization header, if it doesn't exist
array_walk($headers, function ($header) use (&$hasAuthorizationHeader) {
if (substr($header, 0, 15) == 'Authorization: ')
{
$hasAuthorizationHeader = true;
}
});
if (!$hasAuthorizationHeader)
{
$headers[] = 'Authorization: ' . $this->getAccountInformation()->authorizationToken;
}
$options[CURLOPT_HTTPHEADER] = $headers;
// Handle files
$file = null;
$fp = null;
$fileMode = null;
if (isset($additional['file']))
{
$file = $additional['file'];
unset ($additional['file']);
}
if (isset($additional['file_mode']))
{
$fileMode = $additional['file_mode'];
unset ($additional['file_mode']);
}
if (!isset($additional['fp']) && !empty($file))
{
if (is_null($fileMode))
{
$fileMode = ($method == 'GET') ? 'w' : 'r';
}
$fp = @fopen($file, $fileMode);
}
elseif (isset($additional['fp']))
{
$fp = $additional['fp'];
unset($additional['fp']);
}
// Set up additional options
if ($method == 'GET' && $fp)
{
$options[CURLOPT_RETURNTRANSFER] = false;
$options[CURLOPT_HEADER] = false;
$options[CURLOPT_FILE] = $fp;
if (empty($expectHttpStatus))
{
$expectHttpStatus = [200, 206];
}
}
elseif (in_array($method, ['POST', 'PUT']) && $fp)
{
$options[CURLOPT_PUT] = true;
$options[CURLOPT_CUSTOMREQUEST] = $method;
$options[CURLOPT_INFILE] = $fp;
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
$options[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
}
if ($file)
{
clearstatcache();
$options[CURLOPT_INFILESIZE] = @filesize($file);
}
else
{
$options[CURLOPT_INFILESIZE] = strlen(stream_get_contents($fp));
}
fseek($fp, 0);
}
elseif ($method == 'POST')
{
$options[CURLOPT_POST] = true;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
// This is required for some broken servers, e.g. SiteGround
else
{
$options[CURLOPT_POSTFIELDS] = '';
}
}
else // Any other HTTP method, e.g. DELETE
{
$options[CURLOPT_CUSTOMREQUEST] = $method;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
// Set the cURL options at once
@curl_setopt_array($ch, $options);
// Set the follow location flag
if ($followRedirect)
{
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
}
// Execute and parse the response
$response = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
$lastHttpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
// Close open file pointers
$hadFile = false;
if ($fp)
{
$hadFile = true;
$this->conditionalFileClose($fp);
}
// Did we have a cURL error?
if ($errNo)
{
throw new cURLError($errNo, $error);
}
// Close open file pointers
if ($hadFile && !empty($expectHttpStatus) && !in_array($lastHttpCode, $expectHttpStatus))
{
if ($file && ($method == 'GET'))
{
@unlink($file);
}
throw new UnexpectedHTTPStatus($lastHttpCode);
}
if (!empty($expectHttpStatus) && in_array($lastHttpCode, $expectHttpStatus))
{
return [];
}
if ($noParse)
{
return $response;
}
// Parse the response
$originalResponse = $response;
$response = json_decode($response, true);
// Did we get invalid JSON data?
if (!$response)
{
throw new InvalidJSON("Invalid JSON Data: $originalResponse");
}
unset($originalResponse);
if (!empty($response) && ($lastHttpCode != 200))
{
$response = ['error' => $response];
}
// Did we get an error response?
if (isset($response['error']) && is_array($response['error']))
{
$decodedError = $response['error'];
$actualException = new APIError($decodedError['code'], $decodedError['message'], 500);
/**
* BackBlaze's blog post (see below) states that we need to retry getting an upload URL upon HTTP error 500
* or 503. However, the reality is different. We get an HTTP 200 with an error document that contains the
* error code literal 'service_unavailable'. In this case we'd simply throw an APIError exception and stop
* the upload attempt. In an effort to keep the error handling code simple (since PHP doesn't allow catching
* two disparate exception types in a single catch) we will simulate an HTTP exception here, attaching the
* actual APIException as its previous exception to facilitate troubleshooting. The UnexpectedHTTPStatus
* exception bubbles up to Akeeba\Engine\Postproc\Backblaze where it's intercepted, allowing us to ask for a
* new upload URL and continue the upload.
*
* @see https://www.backblaze.com/blog/b2-503-500-server-error/
* @see https://www.akeeba.com/support/32973
*/
if ($decodedError['code'] == 'service_unavailable')
{
throw new UnexpectedHTTPStatus('503 (Simulated – received API error code ‘service_unavailable’ per parent exception)', 503, $actualException);
}
throw $actualException;
}
return $response;
}
/**
* Return the API URL for all operations except file downloads. It includes the all important trailing slash which
* fetch() expects to be present.
*
* @return string
*/
protected function getApiUrl()
{
$apiUrl = $this->getAccountInformation()->apiUrl;
$apiUrl = rtrim($apiUrl, '/');
return $apiUrl . '/';
}
/**
* Return the API URL for file download operations only. It includes the all important trailing slash which fetch()
* expects to be present.
*
* @return string
*/
protected function getDownloadUrl()
{
$downloadUrl = $this->getAccountInformation()->downloadUrl;
$downloadUrl = rtrim($downloadUrl, '/');
return $downloadUrl . '/';
}
}
PK \.
*/
/**
* SabreDAV DAV client
*
* This client wraps around Curl to provide a convenient API to a WebDAV
* server.
*
* NOTE: This class is experimental, its api will likely change in the future.
*
* @copyright Copyright (C) 2007-2016 fruux GmbH (https://fruux.com/).
* @author Evert Pot (http://evertpot.com/)
* @license http://code.google.com/p/sabredav/wiki/License Modified BSD License
*
* Modified by Akeeba Ltd for use in Akeeba Backup in accordance with the aforementioned
* license of the original source code. Original source code can be found at https://github.com/fruux/sabre-dav.
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\Davclient\Xml;
use Akeeba\Engine\Postproc\ProxyAware;
use Exception;
use InvalidArgumentException;
class Davclient
{
use ProxyAware;
/**
* Basic authentication
*/
public const AUTH_BASIC = 1;
/**
* Digest authentication
*/
public const AUTH_DIGEST = 2;
/**
* The propertyMap is a key-value array.
*
* If you use the propertyMap, any {DAV:}multistatus responses with the
* proeprties listed in this array, will automatically be mapped to a
* respective class.
*
* The {DAV:}resourcetype property is automatically added. This maps to
* Sabre\DAV\Property\ResourceType
*
* @var array
*/
public $propertyMap = [];
protected $headers = '';
protected $baseUri;
protected $userName;
protected $password;
protected $proxy;
protected $trustedCertificates;
/**
* The authentication type we're using.
*
* This is a bitmask of AUTH_BASIC and AUTH_DIGEST.
*
* If DIGEST is used, the client makes 1 extra request per request, to get
* the authentication tokens.
*
* @var int
*/
protected $authType;
/**
* Indicates if SSL verification is enabled or not.
*
* @var boolean
*/
protected $verifyPeer;
/**
* Constructor
*
* Settings are provided through the 'settings' argument. The following
* settings are supported:
*
* * baseUri
* * userName (optional)
* * password (optional)
* * proxy (optional)
*
* @param array $settings
*
* @throws InvalidArgumentException
*/
public function __construct(array $settings)
{
if (!isset($settings['baseUri']))
{
throw new InvalidArgumentException('A baseUri must be provided');
}
$validSettings = [
'baseUri',
'userName',
'password',
'proxy',
];
foreach ($validSettings as $validSetting)
{
if (isset($settings[$validSetting]))
{
$this->$validSetting = $settings[$validSetting];
}
}
if (isset($settings['authType']))
{
$this->authType = $settings['authType'];
}
else
{
$this->authType = self::AUTH_BASIC | self::AUTH_DIGEST;
}
// We just need this class to unserialize a node collection. However in our case we really don't need it
// since we are just checking if exists or not, we don't have to iterate on it, so we can use a (very)
// simplified method just to avoid PHP warnings
$this->propertyMap['{DAV:}resourcetype'] = Xml::class;
}
/**
* Add trusted root certificates to the webdav client.
*
* The parameter certificates should be a absolute path to a file
* which contains all trusted certificates
*
* @param string $certificates
*/
public function addTrustedCertificates($certificates)
{
$this->trustedCertificates = $certificates;
}
/**
* Enables/disables SSL peer verification
*
* @param boolean $value
*/
public function setVerifyPeer($value)
{
$this->verifyPeer = $value;
}
/**
* Does a PROPFIND request
*
* The list of requested properties must be specified as an array, in clark
* notation.
*
* The returned array will contain a list of filenames as keys, and
* properties as values.
*
* The properties array will contain the list of properties. Only properties
* that are actually returned from the server (without error) will be
* returned, anything else is discarded.
*
* Depth should be either 0 or 1. A depth of 1 will cause a request to be
* made to the server to also return all child resources.
*
* @param string $url
* @param array $properties
* @param int $depth
*
* @return array
*/
public function propFind($url, array $properties, $depth = 0)
{
$body = '' . "\n";
$body .= '' . "\n";
$body .= ' ' . "\n";
foreach ($properties as $property)
{
[$namespace, $elementName] = Xml::parseClarkNotation($property);
if ($namespace === 'DAV:')
{
$body .= ' ' . "\n";
}
else
{
$body .= " \n";
}
}
$body .= ' ' . "\n";
$body .= '';
$response = $this->request('PROPFIND', $url, $body, [
'Depth' => $depth,
'Content-Type' => 'application/xml',
]);
$result = $this->parseMultiStatus($response['body']);
// If depth was 0, we only return the top item
if ($depth === 0)
{
reset($result);
$result = current($result);
return $result[200] ?? [];
}
$newResult = [];
foreach ($result as $href => $statusList)
{
$newResult[$href] = $statusList[200] ?? [];
}
return $newResult;
}
/**
* Updates a list of properties on the server
*
* The list of properties must have clark-notation properties for the keys,
* and the actual (string) value for the value. If the value is null, an
* attempt is made to delete the property.
*
* @param string $url
* @param array $properties
*
* @return void
*/
public function propPatch($url, array $properties)
{
$body = '' . "\n";
$body .= '' . "\n";
foreach ($properties as $propName => $propValue)
{
[$namespace, $elementName] = Xml::parseClarkNotation($propName);
if ($propValue === null)
{
$body .= "\n";
if ($namespace === 'DAV:')
{
$body .= ' ' . "\n";
}
else
{
$body .= " \n";
}
$body .= "\n";
}
else
{
$body .= "\n";
if ($namespace === 'DAV:')
{
$body .= ' ';
}
else
{
$body .= " ";
}
// I know
$body .= htmlspecialchars($propValue, ENT_NOQUOTES, 'UTF-8');
if ($namespace === 'DAV:')
{
$body .= '' . "\n";
}
else
{
$body .= "\n";
}
$body .= "\n";
}
}
$body .= '';
$this->request('PROPPATCH', $url, $body, [
'Content-Type' => 'application/xml',
]);
}
/**
* Performs an HTTP options request
*
* This method returns all the features from the 'DAV:' header as an array.
* If there was no DAV header, or no contents this method will return an
* empty array.
*
* @return array
*/
public function options()
{
$result = $this->request('OPTIONS');
if (!isset($result['headers']['dav']))
{
return [];
}
$features = explode(',', $result['headers']['dav']);
foreach ($features as &$v)
{
$v = trim($v);
}
return $features;
}
/**
* Performs an actual HTTP request, and returns the result.
*
* If the specified url is relative, it will be expanded based on the base
* url.
*
* The returned array contains 3 keys:
* * body - the response body
* * httpCode - a HTTP code (200, 404, etc)
* * headers - a list of response http headers. The header names have
* been lowercased.
*
* @param string $method
* @param string $url
* @param string $body
* @param array $headers
*
* @return array
* @throws Exception
*
*/
public function request($method, $url = '', $body = null, $headers = [])
{
$this->headers = '';
Factory::getLog()->debug("Remote relative WebDav URL: " . $url);
$url = $this->getAbsoluteUrl($url);
// WebDAV requires spaces (AND SPACES ONLY!) to be encoded
$url = str_replace(' ', '%20', $url);
Factory::getLog()->debug("Absolute WebDav URL: " . $url);
$curlSettings = [
CURLOPT_RETURNTRANSFER => true,
// I can't get the headers in the response, since it would corrupt my downloads
CURLOPT_HEADER => false,
CURLOPT_HEADERFUNCTION => [$this, 'storeHeaders'],
CURLOPT_POSTFIELDS => $body,
// Automatically follow redirects
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
];
if ($this->verifyPeer !== null)
{
$curlSettings[CURLOPT_SSL_VERIFYPEER] = $this->verifyPeer;
}
if ($this->trustedCertificates)
{
$curlSettings[CURLOPT_CAINFO] = $this->trustedCertificates;
}
switch ($method)
{
case 'HEAD' :
// do not read body with HEAD requests (this is necessary because cURL does not ignore the body with HEAD
// requests when the Content-Length header is given - which in turn is perfectly valid according to HTTP
// specs...) cURL does unfortunately return an error in this case ("transfer closed transfer closed with
// ... bytes remaining to read") this can be circumvented by explicitly telling cURL to ignore the
// response body
$curlSettings[CURLOPT_NOBODY] = true;
$curlSettings[CURLOPT_CUSTOMREQUEST] = 'HEAD';
break;
case 'GET':
$curlSettings[CURLOPT_CUSTOMREQUEST] = 'GET';
if (is_resource($body))
{
$curlSettings[CURLOPT_FILE] = $body;
unset($curlSettings[CURLOPT_POSTFIELDS]);
}
break;
case 'PUT':
// ATTENTION!!! If you want to upload a file, you have to directly supply the file content inside the request body.
// This is necessary because if we hit a redirect, cURL will screw up since he can't automatically rewind
// a file pointer resource, but he can do that with a string.
$curlSettings[CURLOPT_CUSTOMREQUEST] = $method;
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
$curlSettings[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
}
break;
default:
$curlSettings[CURLOPT_CUSTOMREQUEST] = $method;
break;
}
// Adding HTTP headers
// OwnCloud needs the the Content-Type header to be set
$nHeaders = ['Content-Type: application/octet-stream'];
foreach ($headers as $key => $value)
{
$nHeaders[] = $key . ': ' . $value;
}
$curlSettings[CURLOPT_HTTPHEADER] = $nHeaders;
if ($this->proxy)
{
$curlSettings[CURLOPT_PROXY] = $this->proxy;
}
if ($this->userName && $this->authType)
{
$curlType = 0;
if ($this->authType & self::AUTH_BASIC)
{
$curlType |= CURLAUTH_BASIC;
}
if ($this->authType & self::AUTH_DIGEST)
{
$curlType |= CURLAUTH_DIGEST;
}
$curlSettings[CURLOPT_HTTPAUTH] = $curlType;
$curlSettings[CURLOPT_USERPWD] = $this->userName . ':' . $this->password;
}
[$response, $curlInfo, $curlErrNo, $curlError] = $this->curlRequest($url, $curlSettings);
$this->parseHeaders();
$response = [
'body' => $response,
'statusCode' => $curlInfo['http_code'],
'headers' => $this->headers,
];
if ($curlErrNo)
{
throw new Exception('[CURL] Error while making request: ' . $curlError . ' (error code: ' . $curlErrNo . ')');
}
if ($response['statusCode'] >= 400)
{
switch ($response['statusCode'])
{
case 400 :
throw new Exception('Bad request', 400);
case 401 :
throw new Exception('Not authenticated', 401);
case 402 :
throw new Exception('Payment required', 402);
case 403 :
throw new Exception('Forbidden', 403);
case 404:
throw new Exception('Resource not found.', 404);
case 405 :
throw new Exception('Method not allowed', 405);
case 409 :
throw new Exception('Conflict', 409);
case 412 :
throw new Exception('Precondition failed', 412);
case 413 :
throw new Exception('Request Entity Too Large', 413);
case 416 :
throw new Exception('Requested Range Not Satisfiable', 416);
case 500 :
throw new Exception('Internal server error', 500);
case 501 :
throw new Exception('Not Implemented', 501);
case 507 :
throw new Exception('Insufficient storage', 507);
default:
throw new Exception('HTTP error response. (errorcode ' . $response['statusCode'] . ')');
}
}
return $response;
}
/**
* Parses a WebDAV multistatus response body
*
* This method returns an array with the following structure
*
* array(
* 'url/to/resource' => array(
* '200' => array(
* '{DAV:}property1' => 'value1',
* '{DAV:}property2' => 'value2',
* ),
* '404' => array(
* '{DAV:}property1' => null,
* '{DAV:}property2' => null,
* ),
* )
* 'url/to/resource2' => array(
* .. etc ..
* )
* )
*
*
* @param string $body xml body
*
* @return array
* @throws InvalidArgumentException
*
*/
public function parseMultiStatus($body)
{
$body = Xml::convertDAVNamespace($body);
$responseXML = simplexml_load_string($body, null, LIBXML_NOBLANKS | LIBXML_NOCDATA);
if ($responseXML === false)
{
throw new InvalidArgumentException('The passed data is not valid XML');
}
$responseXML->registerXPathNamespace('d', 'urn:DAV');
$propResult = [];
foreach ($responseXML->xpath('d:response') as $response)
{
$response->registerXPathNamespace('d', 'urn:DAV');
$href = $response->xpath('d:href');
$href = (string) $href[0];
$properties = [];
foreach ($response->xpath('d:propstat') as $propStat)
{
$propStat->registerXPathNamespace('d', 'urn:DAV');
$status = $propStat->xpath('d:status');
[$httpVersion, $statusCode, $message] = explode(' ', (string) $status[0], 3);
// Only using the propertymap for results with status 200.
$propertyMap = $statusCode === '200' ? $this->propertyMap : [];
$properties[$statusCode] = Xml::parseProperties(dom_import_simplexml($propStat), $propertyMap);
}
$propResult[$href] = $properties;
}
return $propResult;
}
/**
* Callback function used to collect all the headers.
* Headers are important since it's the only way to detected
* failures, but we can't add them to the response body since this would corrupt downloaded files (and doing a
* substr on a potentially 100Mb file is not efficient)
*
* @param resource $ch Pointer to a cURL resource
* @param string $ch_headers Header
*
* @return int Length of the header
*/
protected function storeHeaders($ch, $ch_headers)
{
$this->headers .= $ch_headers;
return strlen($ch_headers);
}
/**
* Parses the stored headers and updates the internal member with the last one for error detection
*
* @return void
*/
protected function parseHeaders()
{
// In the case of 100 Continue, or redirects we'll have multiple lists
// of headers for each separate HTTP response. We can easily split this
// because they are separated by \r\n\r\n
$headerBlob = explode("\r\n\r\n", trim($this->headers, "\r\n"));
// We only care about the last set of headers
$headerBlob = $headerBlob[count($headerBlob) - 1];
// Splitting headers
$headerBlob = explode("\r\n", $headerBlob);
$headers = [];
foreach ($headerBlob as $header)
{
$parts = explode(':', $header, 2);
if (count($parts) == 2)
{
$name = strtolower(trim($parts[0]));
$value = trim($parts[1]);
// A header may legitimately appear more than once (e.g. Apache mod_dav sends several `DAV:` headers).
// Per RFC 7230 §3.2.2 that is equivalent to a single comma-folded header, so we join repeats rather than
// letting the last occurrence overwrite the earlier ones — otherwise options() would lose DAV classes.
$headers[$name] = isset($headers[$name]) ? $headers[$name] . ', ' . $value : $value;
}
}
$this->headers = $headers;
}
/**
* Wrapper for all curl functions.
*
* The only reason this was split out in a separate method, is so it
* becomes easier to unittest.
*
* @param string $url
* @param array $settings
*
* @return array
*/
protected function curlRequest($url, $settings)
{
$curl = curl_init($url);
$this->applyProxySettingsToCurl($curl);
$followLocation = false;
$maxRedirs = 5;
if (isset($settings[CURLOPT_FOLLOWLOCATION]))
{
$followLocation = $settings[CURLOPT_FOLLOWLOCATION];
unset($settings[CURLOPT_FOLLOWLOCATION]);
}
if (isset($settings[CURLOPT_MAXREDIRS]))
{
$maxRedirs = $settings[CURLOPT_MAXREDIRS];
unset($settings[CURLOPT_MAXREDIRS]);
}
curl_setopt_array($curl, $settings);
if ($followLocation)
{
@curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
@curl_setopt($curl, CURLOPT_MAXREDIRS, $maxRedirs);
}
return [
curl_exec($curl),
curl_getinfo($curl),
curl_errno($curl),
curl_error($curl),
];
}
/**
* Returns the full url based on the given url (which may be relative). All
* urls are expanded based on the base url as given by the server.
*
* @param string $url
*
* @return string
*/
protected function getAbsoluteUrl($url)
{
// If the url starts with http:// or https://, the url is already absolute.
if (preg_match('/^http(s?):\/\//', $url))
{
return $url;
}
$parts = parse_url($this->baseUri);
$schemeAndHost = $parts['scheme'] . '://' . $parts['host'];
$portString = isset($parts['port']) ? (':' . $parts['port']) : '';
$path = (isset($parts['path']) && !empty($parts['path'])) ? $parts['path'] : '';
$path = trim($path, '/') . '/';
$path = (strpos($path, '/') !== 0) ? ('/' . $path) : $path;
return $schemeAndHost . ($portString) . $path . ltrim($url, '/');
}
}
PK \琰 F vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/UploadURL.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze;
defined('AKEEBAENGINE') || die();
use DomainException;
/**
* An immutable object which contains the information returned by BackBlaze when uploading files, single- or multipart.
*
* @see https://www.backblaze.com/b2/docs/b2_authorize_account.html
*
* @property-read string fileId The file ID, used for multipart uploads
* @property-read string bucketId The bucket ID, used for single part uploads
* @property-read string uploadUrl The URL that can be used to upload files to this bucket / file
* @property-read string authorizationToken The authorizationToken that must be used when uploading files to this bucket
*/
class UploadURL
{
private $fileId;
private $bucketId;
private $uploadUrl;
private $authorizationToken;
/**
* Construct an object from a key-value array
*
* @param array $data The raw data array returned by the Backblaze B2 API
*/
public function __construct(array $data)
{
if (empty($data))
{
return;
}
foreach ($data as $key => $value)
{
if (property_exists($this, $key))
{
$this->$key = $value;
}
}
}
/**
* Magic getter, channels the private property values. This lets the object have immutable, publicly accessible
* properties.
*
* @param string $name The property name being read
*
* @return mixed
*
* @throws DomainException If you ask for a property that's not there
*/
public function __get($name)
{
if (property_exists($this, $name))
{
return $this->$name;
}
throw new DomainException(sprintf("Property %s does not exist in class %s", $name, __CLASS__));
}
/**
* Exports the data as an array which can be used with __construct to reconstruct this object. The array data is
* easier to serialize since they can be converted to JSON, for example.
*
* @return array
*/
public function toArray()
{
return [
'fileId' => $this->fileId,
'bucketId' => $this->bucketId,
'uploadUrl' => $this->uploadUrl,
'authorizationToken' => $this->authorizationToken,
];
}
}
PK \7 7 L vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/FileInformation.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze;
defined('AKEEBAENGINE') || die();
use DomainException;
/**
* An immutable object which contains the information returned by BackBlaze when uploading files.
*
* @see https://www.backblaze.com/b2/docs/b2_authorize_account.html
*
* @property-read string fileId The unique identifier for this version of this file.
* @property-read string fileName The name of this file
* @property-read string accountId Backblaze account ID
* @property-read string bucketId The bucket that the file is in
* @property-read string contentLength The number of bytes stored in the file.
* @property-read string contentSha1 The SHA1 of the bytes stored in the file.
* @property-read string contentType The MIME type of the file.
* @property-read string fileInfo The custom information that was uploaded with the file.
* @property-read string action Always "upload".
* @property-read string uploadTimestamp This is a UTC time when this file was uploaded.
* @property-read string partNumber Part number, when this is a part of a multipart upload, not a single file
*/
class FileInformation
{
private $fileId;
private $fileName;
private $accountId;
private $bucketId;
private $contentLength;
private $contentSha1;
private $contentType;
private $fileInfo;
private $action;
private $uploadTimestamp;
private $partNumber;
/**
* Construct an object from a key-value array
*
* @param array $data The raw data array returned by the Backblaze B2 API
*/
public function __construct(array $data)
{
if (empty($data))
{
return;
}
foreach ($data as $key => $value)
{
if (property_exists($this, $key))
{
$this->$key = $value;
}
}
}
/**
* Magic getter, channels the private property values. This lets the object have immutable, publicly accessible
* properties.
*
* @param string $name The property name being read
*
* @return mixed
*
* @throws DomainException If you ask for a property that's not there
*/
public function __get($name)
{
if (property_exists($this, $name))
{
return $this->$name;
}
throw new DomainException(sprintf("Property %s does not exist in class %s", $name, __CLASS__));
}
}
PK \O܍M' ' N vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/BucketInformation.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze;
defined('AKEEBAENGINE') || die();
use DomainException;
/**
* An immutable object which contains the information returned by Backblaze b2_list_buckets API method
*
* @see https://www.backblaze.com/b2/docs/b2_list_buckets.html
*
* @property-read string accountId Backblaze account ID
* @property-read string bucketId The ID of the bucket (you will need to use this in the API)
* @property-read array bucketInfo User data stored in this bucket
* @property-read string bucketName The unique name of the bucket, i.e. what the user calls the bucket by
* @property-read string bucketType allPublic, allPrivate, snapshot (possibly more values in the future)
* @property-read array lifecycleRules List of lifecycle rules for this bucket
*/
class BucketInformation
{
/** @var string Backblaze account ID */
private $accountId;
/** @var string The ID of the bucket (you will need to use this in the API) */
private $bucketId;
/** @var array User data stored in this bucket */
private $bucketInfo;
/** @var string The unique name of the bucket, i.e. what the user calls the bucket by */
private $bucketName;
/** @var string allPublic, allPrivate, snapshot (possibly more values in the future) */
private $bucketType;
/** @var string List of lifecycle rules for this bucket */
private $lifecycleRules;
/**
* Construct an BucketInformation object from a key-value array
*
* @param array $data The raw data array returned by the Backblaze B2 API
*/
public function __construct(array $data)
{
if (empty($data))
{
return;
}
foreach ($data as $key => $value)
{
if (property_exists($this, $key))
{
$this->$key = $value;
}
}
}
/**
* Magic getter, channels the private property values. This lets the object have immutable, publicly accessible
* properties.
*
* @param string $name The property name being read
*
* @return mixed
*
* @throws DomainException If you ask for a property that's not there
*/
public function __get($name)
{
if (property_exists($this, $name))
{
return $this->$name;
}
throw new DomainException(sprintf("Property %s does not exist in class %s", $name, __CLASS__));
}
}
PK \%| [ vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Exception/UnexpectedHTTPStatus.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class UnexpectedHTTPStatus extends Base
{
public function __construct($errNo = "500", $code = 0, ?Exception $previous = null)
{
$message = "Unexpected HTTP status $errNo";
parent::__construct($message, (int) $errNo, $previous);
}
}
PK \BEˆ P vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Exception/cURLError.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class cURLError extends Base
{
public function __construct($errNo = "500", $code = '', ?Exception $previous = null)
{
$message = "cURL error $errNo: $code";
parent::__construct($message, (int) $errNo, $previous);
}
}
PK \<_E O vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Exception/APIError.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class APIError extends Base
{
/**
* APIError constructor.
*
* @param string $error Short error code
* @param string $errorDescription Long error description
* @param int $code Numeric error ID (default: 500)
* @param Exception|null $previous Previous exception
*/
public function __construct($error, $errorDescription, $code = 500, ?Exception $previous = null)
{
$message = "Backblaze B2 API Error $error: $errorDescription";
parent::__construct($message, (int) $code, $previous);
}
}
PK \ K vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Exception/Base.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze\Exception;
defined('AKEEBAENGINE') || die();
use RuntimeException;
class Base extends RuntimeException
{
}
PK \ Q vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Exception/NotAllowed.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class NotAllowed extends Base
{
public function __construct($errorDescription, $code = '500', ?Exception $previous = null)
{
$message = "The following action is not allowed by the Backblaze B2 Application Key you have provided: $errorDescription";
parent::__construct($message, (int) $code, $previous);
}
}
PK \'y y R vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Exception/InvalidJSON.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class InvalidJSON extends Base
{
public function __construct($message = "Invalid JSON data received", $code = '500', ?Exception $previous = null)
{
parent::__construct($message, (int) $code, $previous);
}
}
PK \Sʉ L vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ O vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/AccountInformation.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze;
defined('AKEEBAENGINE') || die();
use DomainException;
/**
* An immutable object which contains the information returned by Backblaze b2_authorize_account API method
*
* @see https://www.backblaze.com/b2/docs/b2_authorize_account.html
*
* @property-read string accountId Backblaze account ID
* @property-read string authorizationToken Temporary authorization token
* @property-read Allowed allowed Backblaze account ID
* @property-read string apiUrl API URL for everything except download operations
* @property-read string downloadUrl API URL for download operations
* @property-read string recommendedPartSize Recommended part size, in bytes
* @property-read string absoluteMinimumPartSize Minimum possible part size, in bytes
* @property-read string minimumPartSize DEPRECATED: This field will always have the same value as recommendedPartSize.
*/
class AccountInformation
{
/** @var string Minimum possible part size, in bytes */
private $absoluteMinimumPartSize;
/** @var string Backblaze account ID */
private $accountId;
/** @var Allowed An object describing what we are allowed to do with the current ID and key pair */
private $allowed;
/** @var string API URL for everything except download operations */
private $apiUrl;
/** @var string Temporary authorization token */
private $authorizationToken;
/** @var string API URL for download operations */
private $downloadUrl;
/** @var string DEPRECATED: Alias of recommendedPartSize */
private $minimumPartSize;
/** @var string Recommended part size, in bytes */
private $recommendedPartSize;
/** @var int This object is valid until this UNIX timestamp */
private $validTo;
/**
* Construct an AccountInformation object from a key-value array
*
* @param array $data The raw data array returned by the Backblaze B2 API
*/
public function __construct(array $data)
{
// The authorization token is valid for up to 24 hours
$this->validTo = time() + 86400;
if (empty($data))
{
return;
}
// v4 b2_authorize_account nests apiUrl, downloadUrl, and part sizes under apiInfo.storageApi.
// Lift them to the top level so the existing property-assignment loop handles both shapes.
if (isset($data['apiInfo']['storageApi']) && is_array($data['apiInfo']['storageApi']))
{
$data = array_merge($data['apiInfo']['storageApi'], $data);
unset($data['apiInfo']);
}
foreach ($data as $key => $value)
{
if ($key == 'allowed')
{
$this->allowed = new Allowed($value);
continue;
}
if (property_exists($this, $key))
{
$this->$key = $value;
}
}
if (is_null($this->allowed))
{
$this->allowed = new Allowed([]);
}
if (empty($this->minimumPartSize))
{
$this->minimumPartSize = $this->recommendedPartSize;
}
}
/**
* Magic getter, channels the private property values. This lets the object have immutable, publicly accessible
* properties.
*
* @param string $name The property name being read
*
* @return mixed
*
* @throws DomainException If you ask for a property that's not there
*/
public function __get($name)
{
if (property_exists($this, $name))
{
return $this->$name;
}
throw new DomainException(sprintf("Property %s does not exist in class %s", $name, __CLASS__));
}
/**
* Is the authorization token still valid? We consider it valid for up to 23 hours since it was issued, to prevent
* the chance of the token timing out while we are trying to do an upload.
*
* @return bool
*/
public function isValid()
{
$now = time();
$validTo = $this->validTo - 3600;
return ($validTo >= $now);
}
}
PK \q]/ / D vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/Allowed.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Backblaze;
defined('AKEEBAENGINE') || die();
use DomainException;
/**
* An immutable object which contains the 'allowed' key information returned by Backblaze b2_authorize_account API
* method.
*
* @see https://www.backblaze.com/b2/docs/b2_authorize_account.html
*
* @property-read string $bucketId The ID of the bucket we are limited to. Empty if we are not limited to a bucket.
* @property-read string $bucketName The name of the bucket we are limited to. Empty if we are not limited to a bucket.
* @property-read array $buckets v4: list of {bucketId, bucketName} objects the key may access.
* @property-read array $capabilities An array containing one or more of listKeys, writeKeys, deleteKeys, listBuckets, writeBuckets, deleteBuckets, listFiles, readFiles, shareFiles, writeFiles, and deleteFiles
* @property-read string $namePrefix The prefix inside the bucket we are allowed to write to
*/
class Allowed
{
/**
* The ID of the bucket we are limited to. Empty if we are not limited to a bucket.
*
* @var string
*/
private $bucketId;
/**
* The name of the bucket we are limited to. Empty if we are not limited to a bucket.
*
* @var string
*/
private $bucketName;
/**
* v4: list of {bucketId, bucketName} objects the key may access. Empty means unrestricted.
*
* @var array
*/
private $buckets = [];
/**
* An array containing one or more of listKeys, writeKeys, deleteKeys, listBuckets, writeBuckets, deleteBuckets, listFiles, readFiles, shareFiles, writeFiles, and deleteFiles
*
* @var array
*/
private $capabilities = [];
/**
* The prefix inside the bucket we are allowed to write to
*
* @var string
*/
private $namePrefix;
/**
* Construct an Allowed object from a key-value array
*
* @param array $data The raw data array returned by the Backblaze B2 API
*/
public function __construct(array $data)
{
if (empty($data))
{
return;
}
foreach ($data as $key => $value)
{
if (property_exists($this, $key))
{
$this->$key = $value;
}
}
// v4 replaces bucketId/bucketName with a buckets[] array for multi-bucket keys. The live API keys each entry
// id/name; earlier documentation used bucketId/bucketName. Normalise every entry to {bucketId, bucketName} so
// all read sites see a single, consistent shape regardless of which key spelling the API sends.
if (!empty($this->buckets) && is_array($this->buckets))
{
$this->buckets = array_map(
static function ($entry) {
$entry = (array) $entry;
return [
'bucketId' => $entry['bucketId'] ?? $entry['id'] ?? '',
'bucketName' => $entry['bucketName'] ?? $entry['name'] ?? '',
];
},
array_values($this->buckets)
);
// Seed the scalar fields from the first entry so single-bucket callers keep working.
if (empty($this->bucketId))
{
$this->bucketId = $this->buckets[0]['bucketId'];
$this->bucketName = $this->buckets[0]['bucketName'];
}
}
}
/**
* Magic getter, channels the private property values. This lets the object have immutable, publicly accessible
* properties.
*
* @param string $name The property name being read
*
* @return mixed
*
* @throws DomainException If you ask for a property that's not there
*/
public function __get($name)
{
if (property_exists($this, $name))
{
return $this->$name;
}
throw new DomainException(sprintf("Property %s does not exist in class %s", $name, __CLASS__));
}
/**
* Are we granted a specific capability by the API? recommended to use the can*() methods instead.
*
* @param string $cap The capability to check
*
* @return bool
*/
public function hasCapability($cap)
{
if (!is_array($this->capabilities))
{
return false;
}
return in_array($cap, $this->capabilities);
}
/**
* Are we allowed to list keys?
*
* @return bool
*/
public function canListKeys()
{
return $this->hasCapability('listKeys');
}
/**
* Are we allowed to write keys?
*
* @return bool
*/
public function canWriteKeys()
{
return $this->hasCapability('writeKeys');
}
/**
* Are we allowed to delete keys?
*
* @return bool
*/
public function canDeleteKeys()
{
return $this->hasCapability('deleteKeys');
}
/**
* Are we allowed to list buckets?
*
* @return bool
*/
public function canListBuckets()
{
return $this->hasCapability('listBuckets');
}
/**
* Are we allowed to write (create new) buckets?
*
* @return bool
*/
public function canWriteBuckets()
{
return $this->hasCapability('writeBuckets');
}
/**
* Are we allowed to delete buckets?
*
* @return bool
*/
public function canDeleteBuckets()
{
return $this->hasCapability('deleteBuckets');
}
/**
* Are we allowed to list files?
*
* @return bool
*/
public function canListFiles()
{
return $this->hasCapability('listFiles');
}
/**
* Are we allowed to read files?
*
* @return bool
*/
public function canReadFiles()
{
return $this->hasCapability('readFiles');
}
/**
* Are we allowed to share files?
*
* @return bool
*/
public function canShareFiles()
{
return $this->hasCapability('shareFiles');
}
/**
* Are we allowed to write to files?
*
* @return bool
*/
public function canWriteFiles()
{
return $this->hasCapability('writeFiles');
}
/**
* Are we allowed to delete files?
*
* @return bool
*/
public function canDeleteFiles()
{
return $this->hasCapability('deleteFiles');
}
/**
* Are we allowed to access the bucket in question?
*
* @param string $bucket The bucket you need to know if we are allowed to access
*
* @return bool
*/
public function isBucketAllowed($bucket)
{
// v4 multi-bucket keys: check against the full buckets list.
if (!empty($this->buckets) && is_array($this->buckets))
{
foreach ($this->buckets as $entry)
{
$entry = (array) $entry;
if (($entry['bucketName'] ?? '') === $bucket)
{
return true;
}
}
return false;
}
if (empty($this->bucketName))
{
return true;
}
return $this->bucketName === $bucket;
}
/**
* Are we allowed to access files / folders with the given prefix?
*
* @param string $prefix Path to a file or folder you want to test. Whole or partial (the leading part
* must be provided in this case)
*
* @return bool
*/
public function isPrefixAllowed($prefix)
{
if (empty($this->namePrefix))
{
return true;
}
return strpos(ltrim($prefix, '/'), $this->namePrefix) === 0;
}
}
PK \Sʉ B vendor/akeeba/engine/engine/Postproc/Connector/Backblaze/.htaccessnu 7m
Order allow,deny
Deny from all
PK \o U vendor/akeeba/engine/engine/Postproc/Connector/Box/Exception/UnexpectedHTTPStatus.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Box\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class UnexpectedHTTPStatus extends Base
{
public function __construct($errNo = "500", $code = 0, ?Exception $previous = null)
{
$message = "Unexpected HTTP status $errNo";
parent::__construct($message, (int) $errNo, $previous);
}
}
PK \C` J vendor/akeeba/engine/engine/Postproc/Connector/Box/Exception/cURLError.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Box\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class cURLError extends Base
{
public function __construct($errNo = "500", $code = '', ?Exception $previous = null)
{
$message = "cURL error $errNo: $code";
parent::__construct($message, (int) $errNo, $previous);
}
}
PK \zn I vendor/akeeba/engine/engine/Postproc/Connector/Box/Exception/APIError.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Box\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class APIError extends Base
{
/**
* APIError constructor.
*
* @param string $error Short error code
* @param string $errorDescription Long error description
* @param int $code Numeric error ID (default: 500)
* @param Exception|null $previous Previous exception
*/
public function __construct($error, $errorDescription, $code = 500, ?Exception $previous = null)
{
$message = "Box API Error $error: $errorDescription";
parent::__construct($message, (int) $code, $previous);
}
}
PK \S[ E vendor/akeeba/engine/engine/Postproc/Connector/Box/Exception/Base.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Box\Exception;
defined('AKEEBAENGINE') || die();
use RuntimeException;
class Base extends RuntimeException
{
}
PK \6es s L vendor/akeeba/engine/engine/Postproc/Connector/Box/Exception/InvalidJSON.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Box\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class InvalidJSON extends Base
{
public function __construct($message = "Invalid JSON data received", $code = '500', ?Exception $previous = null)
{
parent::__construct($message, (int) $code, $previous);
}
}
PK \Sʉ F vendor/akeeba/engine/engine/Postproc/Connector/Box/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ < vendor/akeeba/engine/engine/Postproc/Connector/Box/.htaccessnu 7m
Order allow,deny
Deny from all
PK \1R? ? > vendor/akeeba/engine/engine/Postproc/Connector/GoogleDrive.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use Exception;
use RuntimeException;
/**
* Google Drive v3 API integration for Akeeba Engine
*
* @package Akeeba\Engine\Postproc\Connector
*/
class GoogleDrive
{
use FileCloseAware;
use ProxyAware;
/**
* The root URL for the Google Drive v3 API
*/
public const rootUrl = 'https://www.googleapis.com/drive/v3/';
/**
* The root URL for the Google Drive v3 upload API
*/
public const uploadUrl = 'https://www.googleapis.com/upload/drive/v3/';
/**
* The URL of the helper script which is used to get fresh API tokens
*/
public const helperUrl = 'https://www.akeeba.com/oauth2/googledrive.php';
/**
* Refresh the access token proactively when it is within this many seconds of expiring. Google Drive access tokens
* are short-lived (typically 1 hour); refreshing a little before expiry prevents the token from lapsing in the
* middle of a long-running backup, which is the cause of intermittent, hard-to-reproduce upload/download failures.
*/
private const tokenExpirationThreshold = 300;
/**
* The access token for connecting to Google Drive
*
* @var string
*/
private $accessToken = '';
/**
* The refresh token used to get a new access token for Google Drive
*
* @var string
*/
private $refreshToken = '';
/**
* Download ID to use with the helper URL
*
* @var string
*/
private $dlid = '';
/**
* Default cURL options
*
* @var array
*/
private $defaultOptions = [
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => true,
CURLOPT_VERBOSE => false,
CURLOPT_HEADER => false,
CURLINFO_HEADER_OUT => false,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
];
private $uploadToSharedWithMe = false;
private $refreshUrl = '';
/**
* UNIX timestamp at which the current access token expires. 0 means "unknown" — e.g. a token supplied from saved
* configuration whose lifetime we have not learned yet. It is populated from the `expires_in` value Google returns
* whenever the token is refreshed.
*
* @var int
*/
private $tokenExpiration = 0;
/**
* Public constructor
*
* @param string $accessToken The access token for accessing OneDrive
* @param string $refreshToken The refresh token for getting new access tokens for OneDrive
* @param string $dlid The akeeba.com Download ID, used whenever you try to refresh the token
*/
public function __construct($accessToken, $refreshToken, $dlid, $refreshUrl = '')
{
$this->accessToken = $accessToken;
$this->refreshToken = $refreshToken;
$this->dlid = $dlid;
$this->refreshUrl = $refreshUrl ?: self::helperUrl;
}
/**
* Try to ping Google Drive, refresh the token if it's expired and return the refresh results.
*
* If no refresh was required 'needs_refresh' will be false.
*
* If refresh was required 'needs_refresh' will be true and the rest of the keys will be as returned by Google Drive.
*
* If the refresh failed you'll get a RuntimeException.
*
* @param bool $forceRefresh Set to true to forcibly refresh the tokens
*
* @return array
*
* @throws RuntimeException
*/
public function ping($forceRefresh = false)
{
// Initialization
$response = [
'needs_refresh' => false,
];
if (!$forceRefresh)
{
if (!empty($this->tokenExpiration))
{
// We know when the token expires: refresh PROACTIVELY once it is at — or within a safety margin of —
// expiry, so it cannot lapse mid-operation. This avoids the race where a "test" call succeeds but the
// token then expires moments later during the real request (the cause of intermittent failures).
$response['needs_refresh'] = (time() + self::tokenExpirationThreshold) >= $this->tokenExpiration;
}
else
{
// We do NOT know this token's expiry (e.g. it was supplied from saved configuration). Fall back to
// probing the API with it (getDriveInformation) and refreshing only if that probe fails.
try
{
$this->getDriveInformation();
}
catch (RuntimeException $e)
{
$response['needs_refresh'] = true;
}
}
}
// If there is no need to refresh the tokens, return
if (!$response['needs_refresh'] && !$forceRefresh)
{
return $response;
}
if (empty($this->refreshUrl))
{
throw new \RuntimeException('The OAuth2 Refresh URL is empty. Please check your backup profile\'s configuration.');
}
$refreshUrl = $this->refreshUrl .
(strpos($this->refreshUrl, '?') === false ? '?' : '&')
. 'refresh_token=' . urlencode($this->refreshToken);
if (strpos($refreshUrl, self::helperUrl) === 0)
{
$refreshUrl .= '&dlid=' . urlencode($this->dlid);
}
$refreshResponse = $this->fetch('GET', $refreshUrl);
$this->accessToken = $refreshResponse['access_token'] ?? '';
// Record when the freshly minted access token will expire so ping() can refresh it proactively next time.
if (isset($refreshResponse['expires_in']))
{
$this->tokenExpiration = time() + (int) $refreshResponse['expires_in'];
}
$refreshResponse['token_expiration'] = $this->tokenExpiration;
return array_merge($response, $refreshResponse);
}
/**
* Get the UNIX timestamp at which the current access token expires (0 if unknown).
*
* @return int
*/
public function getTokenExpiration()
{
return $this->tokenExpiration;
}
/**
* Restore a previously persisted access-token expiry timestamp, so ping() can refresh proactively without first
* having to probe the API. Pass 0 to mark the expiry as unknown.
*
* @param int $tokenExpiration UNIX timestamp at which the access token expires.
*
* @return void
*/
public function setTokenExpiration($tokenExpiration)
{
$this->tokenExpiration = (int) $tokenExpiration;
}
/**
* Return information about Google Drive
*
* @return array See https://developers.google.com/drive/v3/reference/about/get
*/
public function getDriveInformation()
{
$relativeUrl = 'about';
$result = $this->fetch('GET', $relativeUrl, [
'fields' => 'appInstalled,kind,maxUploadSize,storageQuota,user',
]);
return $result;
}
/**
* Get a list of Google Team Drives as an array of ID => Team Drive Name. If there are no team drives or the account
* does not support team drives you will receive an empty list.
*
* @return array See https://developers.google.com/drive/api/v3/reference/drives/list
*/
public function getTeamDrives()
{
$ret = [];
$relativeUrl = 'drives';
$result = $this->fetch('GET', $relativeUrl, [
'pageSize' => 100
]);
if (!isset($result['drives']) || empty($result['drives']))
{
return $ret;
}
foreach ($result['drives'] as $drive)
{
$ret[$drive['id']] = $drive['name'];
}
return $ret;
}
/**
* Get the raw listing of a folder
*
* @param string $parentId The parent folder Id (default: 'root')
* @param string $search Additional search criteria to apply, see https://developers.google.com/drive/v3/web/search-parameters
* @param int $pageSize The pagination size, default 100
* @param string $pageToken The page continuation token from a previous request
* @param string $orderBy Ordering for the results, defaults to "folder,name" (folders first, then sort by name ascending)
* @param string $teamDriveID The ID of the Google Team Drive. Empty means we should use the personal Drive (default).
*
* @return array See https://developers.google.com/drive/v3/reference/files/list
*/
public function getRawContents($parentId = 'root', $search = null, $pageSize = 100, $pageToken = null, $orderBy = 'folder,name', $teamDriveID = '')
{
$params = [
'supportsAllDrives' => 'true',
'orderBy' => $orderBy,
'pageSize' => $pageSize,
'pageToken' => $pageToken,
'q' => '',
'spaces' => 'drive',
'corpora' => 'user',
'fields' => 'files(fileExtension,id,kind,mimeType,name,parents,size,spaces,starred),nextPageToken',
];
if ($this->uploadToSharedWithMe)
{
$params['corpora'] = 'user';
}
if (!empty($teamDriveID))
{
$params = array_merge($params, [
'corpora' => 'drive',
'includeItemsFromAllDrives' => 'true',
'driveId' => $teamDriveID,
]);
}
if (empty($pageToken))
{
unset ($params['pageToken']);
}
$searchParam = '';
if (!empty($parentId))
{
$parentIdQuoted = str_replace('\'', '\\\'', $parentId);
$searchParam = "'$parentIdQuoted' in parents";
if ($this->uploadToSharedWithMe && $parentId === 'root')
{
$searchParam .= ' or sharedWithMe = true';
}
}
if ($search)
{
if (!empty($searchParam))
{
$searchParam .= " and ($search)";
}
else
{
$searchParam = $search;
}
}
$params['q'] = $searchParam;
$result = $this->fetch('GET', 'files', $params);
return $result;
}
/**
* Get the processed listing of a folder
*
* @param string $parentId The parent folder Id (default: 'root')
* @param string $search Additional search criteria to apply, see https://developers.google.com/drive/v3/web/search-parameters
* @param int $pageSize The pagination size, default 100
* @param string $pageToken The page continuation token from a previous request
* @param string $orderBy Ordering for the results, defaults to "folder,name" (folders first, then sort by name ascending)
* @param string $teamDriveID The ID of the Google Team Drive. Empty means we should use the personal Drive (default).
*
* @return array Two arrays under keys folders and files. Each array's key is the file/folder name. For the values see above.
*/
public function listContents($parentId = 'root', $search = null, $pageSize = 100, $pageToken = null, $orderBy = 'folder,name', $teamDriveID = '')
{
$result = $this->getRawContents($parentId, $search, $pageSize, $pageToken, $orderBy, $teamDriveID);
$return = [
'files' => [],
'folders' => [],
];
if (!isset($result['files']) || !count($result['files']))
{
return $return;
}
foreach ($result['files'] as $item)
{
if ($item['mimeType'] == 'application/vnd.google-apps.folder')
{
$return['folders'][$item['name']] = [
'id' => $item['id'],
'parents' => $item['parents'],
];
continue;
}
$return['files'][$item['name']] = [
'id' => $item['id'],
'parents' => $item['parents'],
'size' => $item['size'],
'fileExtension' => $item['fileExtension'],
];
}
return $return;
}
/**
* Try to get the ID for a file.
*
* @param string $path Human readable path to the file
* @param bool $createFolders Should I create the enclosing folders if they do not exist?
* @param string $teamDriveID The ID of the Google Team Drive. Empty means we should use the personal Drive (default).
*
* @return null|string Null if the file doesn't exist (but the path does), the ID otherwise
*
* @throws RuntimeException When the path does not exist
*/
public function getIdForFile($path, $createFolders = false, $teamDriveID = '')
{
$parentPath = dirname($path);
$fileName = basename($path);
$parentPath = trim($parentPath, '/');
$parentId = empty($teamDriveID) ? 'root' : $teamDriveID;
if (!empty($parentPath))
{
$parentId = $this->getIdForFolder($parentPath, $createFolders, $teamDriveID);
}
if (is_null($parentId))
{
throw new RuntimeException("The path $parentPath does not exist in your Google Drive");
}
// Try to find the last part
$search = 'name = \'' . str_replace('\'', '\\\'', $fileName) . '\'';
$results = $this->getRawContents($parentId, $search, 1, null, 'folder,name', $teamDriveID);
if (empty($results['files']))
{
return null;
}
return $results['files'][0]['id'];
}
/**
* Try to get the ID to a folder
*
* @param string $path Human readable path to the folder
* @param bool $createFolders Should I create any missing folders?
* @param string $teamDriveID The ID of the Google Team Drive. Empty means we should use the personal Drive (default).
*
* @return null|string Null if the folder doesn't exist, the ID of the folder otherwise
*/
public function getIdForFolder($path, $createFolders = false, $teamDriveID = '')
{
if (empty($path))
{
return empty($teamDriveID) ? 'root' : $teamDriveID;
}
$folders = explode('/', $path);
$parentId = empty($teamDriveID) ? 'root' : $teamDriveID;
foreach ($folders as $folder)
{
// Search for a folder by the name $folder that has a parent $parentId
$search = 'name = \'' . str_replace('\'', '\\\'', $folder) . '\'' .
' and mimeType = \'application/vnd.google-apps.folder\'';
$results = $this->getRawContents($parentId, $search, 1, null, 'folder,name', $teamDriveID);
// If found, set $parentId to this folder's ID
if (!empty($results['files']))
{
$parentId = $results['files'][0]['id'];
continue;
}
// Not found and we're told to not create the missing folders. Return null.
if (!$createFolders)
{
return null;
}
// Not found, but we're asked to create the missing folders
$parentId = $this->createFolder($parentId, $folder);
/**
* Welcome to Google Insanity. Let me be your guide.
*
* If the folder does not exist we ask the Google Drive API to create it. If we try to use files.list to
* check if the folder is there the API returns the folder we just created. However, if we try to upload a
* new file into it the folder is reported as being non-existent and Google Drive tries to create a new
* folder with the same name. The problem is that we reasonably expect that our file is uploaded in the
* folder we created, not some a different folder with the same name and different file ID. This discrepancy
* causes uploads to fail.
*
* If I wait one second the same things happens. Two seconds? Same story. Three seconds? Well, this is
* interesting. If I wait THREE (3) seconds after I've created the folder then everything works as expected.
* Google Drive sees the folder we created and does use it during upload. So please do NOT remove this sleep
* or everything breaks. Peace.
*/
sleep(3);
}
return $parentId;
}
/**
* Create a folder named $name under the parent folder with id $parentId.
*
* If you know the human-readable path to the folder you want to create but not its parentId and/or you are not sure
* if the folder exists but want its Id anyway use:
* $this->getIdForFolder('/human/readable/path', true).
*
* @param string $parentId The ID of the enclosing folder
* @param string $name The name of the folder to create
*
* @return string The ID of the created folder
*/
public function createFolder($parentId, $name)
{
$folderName = str_replace('"', '\\"', $name);
$jsonDocument = <<< JSON
{
"name": "$folderName",
"parents": [
"$parentId"
],
"mimeType": "application/vnd.google-apps.folder"
}
JSON;
$contentLength = strlen($jsonDocument);
$result = $this->fetch('POST', 'files?supportsAllDrives=true&fields=id', [
'headers' => [
'Content-Type: application/json; charset="utf-8"',
'Content-Length: ' . $contentLength,
],
], $jsonDocument);
return $result['id'];
}
/**
* Delete a file
*
* @param string $fileId The ID of the file to delete
* @param bool $failOnError Throw exception if the deletion fails? Default true.
*
* @return bool True on success
*
* @throws Exception
*/
public function delete($fileId, $failOnError = true)
{
try
{
$result = $this->fetch('DELETE', 'files/' . $fileId, [
'supportsAllDrives' => 'true',
]);
}
catch (Exception $e)
{
if (!$failOnError)
{
return false;
}
throw $e;
}
return true;
}
/**
* Download a remote file
*
* @param string $fileId The ID of the file in Google Drive
* @param string $localFile The absolute filesystem path where the file will be downloaded to
*/
public function download($fileId, $localFile)
{
$this->fetch('GET', "files/$fileId?alt=media", [
'supportsAllDrives' => 'true',
'file' => $localFile,
]);
}
/**
* Uploads a file as a single part. Up to 5Mb uploads.
*
* @param string $folderId The ID of the folder to upload to
* @param string $localFile The absolute local filesystem path
* @param string $remoteName The name of the file on the remote storage, null to derive from localFile
* @param string $mimeType The MIME type of the file. Defaults to application/octet-stream.
*
* @return array See https://developers.google.com/drive/v3/reference/files#resource-representations
*/
public function simpleUpload($folderId, $localFile, $remoteName = null, $mimeType = 'application/octet-stream')
{
// Make sure this file is 5Mb or smaller
clearstatcache();
$filesize = @filesize($localFile);
if ($filesize > 5242880)
{
throw new RuntimeException("File size too big for simpleUpload ($filesize bigger than 5Mb).", 500);
}
// Make sure we have a remote name
if (empty($remoteName))
{
$remoteName = basename($localFile);
}
// First we need to upload the file and get its ID
$additional = [
'file' => $localFile,
'headers' => [
'Content-Type: ' . $mimeType,
'Content-Length: ' . $filesize,
],
];
$response = $this->fetch('POST', self::uploadUrl . 'files?uploadType=media&supportsAllDrives=true', $additional);
if (!isset($response['id']))
{
throw new RuntimeException("Could not upload $localFile");
}
$fileId = $response['id'];
// Now we need to add to the parents list
$remoteName = str_replace('"', '\\"', $remoteName);
$jsonDocument = <<< JSON
{
"name": "$remoteName"
}
JSON;
$additional = [
'headers' => [
'Content-Type: application/json',
],
'supportsAllDrives' => 'true',
];
$patchResponse = $this->fetch('PATCH', 'files/' . $fileId . '?&supportsAllDrives=true&addParents=' . $folderId, $additional, $jsonDocument);
return $patchResponse;
}
/**
* Creates a new multipart upload session and returns its upload URL
*
* @param string $folderId The ID of the folder to upload to
* @param string $localFile The absolute local filesystem path
* @param string $remoteName The name of the file on the remote storage, null to derive from localFile
* @param string $mimeType The MIME type of the file. Defaults to application/octet-stream.
*
* @return string|null The upload URL for the session, null if the upload session wasn't created
*
* @see https://developers.google.com/drive/api/v3/resumable-upload
*/
public function createUploadSession($folderId, $localFile, $remoteName = null, $mimeType = 'application/octet-stream')
{
clearstatcache();
$filesize = @filesize($localFile);
$explicitPost = (object) [
'name' => $remoteName,
'parents' => [
$folderId,
],
];
$explicitPost = json_encode($explicitPost);
$response = $this->fetch('POST', self::uploadUrl . 'files?supportsAllDrives=true&uploadType=resumable', [
'headers' => [
'Content-Type: application/json',
'Content-Length: ' . strlen($explicitPost),
'X-Upload-Content-Type: ' . $mimeType,
'X-Upload-Content-Length: ' . $filesize,
],
'follow-redirect' => false,
'no-parse' => true,
'curl-options' => [
CURLOPT_HEADER => true,
],
], $explicitPost);
$lines = explode("\r", $response);
foreach ($lines as $line)
{
$line = trim($line);
if (empty($line))
{
continue;
}
if (strpos($line, ':') === false)
{
continue;
}
[$header, $value] = explode(": ", $line);
if (strtolower($header) != 'location')
{
continue;
}
return $value;
}
return null;
}
/**
* Upload a part
*
* @param string $sessionUrl The upload session URL, see createUploadSession
* @param string $localFile Absolute filesystem path of the source file
* @param int $from Starting byte to begin uploading, default is 0 (start of file)
* @param int $length Chunk size in bytes, default 10Mb, must NOT be over 60Mb! MUST be a multiple of 320Kb.
*
* @return array The upload information, see https://developers.google.com/drive/v3/reference/files#resource-representations
*
* @see https://developers.google.com/drive/api/v3/resumable-upload
*/
public function uploadPart($sessionUrl, $localFile, $from = 0, $length = 10485760)
{
clearstatcache();
$totalSize = filesize($localFile);
$to = $from + $length - 1;
if ($to > ($totalSize - 1))
{
$to = $totalSize - 1;
}
$contentLength = $to - $from + 1;
$range = "$from-$to/$totalSize";
$additional = [
'headers' => [
'Content-Length: ' . $contentLength,
'Content-Range: bytes ' . $range,
],
'supportsAllDrives' => 'true',
];
$fp = @fopen($localFile, 'r');
if ($fp === false)
{
throw new RuntimeException("Could not open $localFile for reading", 500);
}
fseek($fp, $from);
$data = fread($fp, $contentLength);
$this->conditionalFileClose($fp);
return $this->fetch('PUT', $sessionUrl, $additional, $data);
}
/**
* Upload a file using multipart uploads. Useful for files over 100Mb and up to 2Gb.
*
* @param string $path Relative path in the Drive
* @param string $localFile Absolute filesystem path of the source file
* @param int $partSize Part size in bytes, default 10Mb
* @param string $mimeType The MIME type of the uploaded file, defaults to application/octet-stream
* @param string $teamDriveID The ID of the Google Team Drive. Empty means we should use the personal Drive (default).
*
* @return array See https://developers.google.com/drive/v3/reference/files#resource-representations
*
* @throws Exception
*
* @see https://developers.google.com/drive/api/v3/resumable-upload
*/
public function resumableUpload($path, $localFile, $partSize = 10485760, $mimeType = 'application/octet-stream', $teamDriveID = '')
{
[$fileName, $folderId] = $this->preprocessUploadPath($path, $teamDriveID);
$sessionUrl = $this->createUploadSession($folderId, $localFile, $fileName, $mimeType);
$from = 0;
while (true)
{
$result = $this->uploadPart($sessionUrl, $localFile, $from, $partSize);
$from += $partSize;
// If the result doesn't have nextExpectedRanges we have finished uploading.
if (isset($result['name']))
{
return $result;
}
}
}
/**
* Automatically decides which upload method to use to upload a file to Google Drive. This method will return when
* the entire file has been uploaded. If you want to implement staggered uploads use the createUploadSession and
* uploadPart methods.
*
* @param string $path The remote path relative to Drive root
* @param string $localFile The absolute local filesystem path
* @param int $partSize Part size in bytes, default 10Mb
* @param string $mimeType The MIME type of the uploaded file, defaults to application/octet-stream
* @param string $teamDriveID The ID of the Google Team Drive. Empty means we should use the personal Drive (default).
*
* @return array See https://developers.google.com/drive/v3/reference/files#resource-representations
*
* @throws Exception
*/
public function upload($path, $localFile, $partSize = 10485760, $mimeType = 'application/octet-stream', $teamDriveID = '')
{
clearstatcache();
$filesize = @filesize($localFile);
/**
* Google Drive has a hard limit of 5MB for simple uploads. If the file is bigger than 5MB **OR** bigger than
* the part size (whatever is smaller) **THEN** we have to use resumable uploads.
*/
$smallestSizeForSinglePartUpload = min(5242880, $partSize);
if ($filesize > $smallestSizeForSinglePartUpload)
{
return $this->resumableUpload($path, $localFile, $partSize, $mimeType, $teamDriveID);
}
// Smaller files, use simple upload
[$fileName, $folderId] = $this->preprocessUploadPath($path, $teamDriveID);
return $this->simpleUpload($folderId, $localFile, $fileName, $mimeType);
}
/**
* Converts a human readable path into a folder ID and directory name. If any folder in the path does not exist it
* will be created. If a file by the same name already exists in the folder it will be deleted.
*
* @param string $path The human readable path to the file
* @param string $teamDriveID The ID of the Google Team Drive. Empty means we should use the personal Drive (default).
*
* @return array array($fileName, $folderId)
*
* @throws Exception
*/
public function preprocessUploadPath($path, $teamDriveID = '')
{
// Get the folder and file name
$folderName = dirname($path);
$fileName = basename($path);
$folderName = trim($folderName, '/');
$folderId = empty($teamDriveID) ? 'root' : $teamDriveID;
// Find or create the folder
if (!empty($folderName))
{
$folderId = $this->getIdForFolder($folderName, true, $teamDriveID);
}
// If I have a file by the same name in this directory, kill it
$search = 'name = \'' . str_replace('\'', '\\\'', $fileName) . '\'';
$results = $this->getRawContents($folderId, $search, 1, null, 'folder,name', $teamDriveID);
if (!empty($results['files']))
{
$fileId = $results['files'][0]['id'];
$this->delete($fileId, false);
return [$fileName, $folderId];
}
return [$fileName, $folderId];
}
public function setUploadToSharedWithMe(bool $uploadToSharedWithMe): self
{
$this->uploadToSharedWithMe = $uploadToSharedWithMe;
return $this;
}
public function isUploadToSharedWithMe(): bool
{
return $this->uploadToSharedWithMe;
}
/**
* Execute an API call
*
* @param string $method The HTTP method
* @param string $relativeUrl The relative URL to ping
* @param array $additional Additional parameters
* @param mixed $explicitPost Passed explicitly to POST requests if set, otherwise $additional is passed.
*
* @return array
* @throws RuntimeException
*
*/
protected function fetch($method, $relativeUrl, array $additional = [], $explicitPost = null)
{
// Get full URL, if required
$url = $relativeUrl;
if (substr($relativeUrl, 0, 6) != 'https:')
{
$url = self::rootUrl . ltrim($relativeUrl, '/');
}
// Should I expect a specific header?
$expectHttpStatus = false;
if (isset($additional['expect-status']))
{
$expectHttpStatus = $additional['expect-status'];
unset($additional['expect-status']);
}
// Am I told to not parse the result?
$noParse = false;
if (isset($additional['no-parse']))
{
$noParse = $additional['no-parse'];
unset ($additional['no-parse']);
}
// Am I told not to follow redirections?
$followRedirect = true;
if (isset($additional['follow-redirect']))
{
$followRedirect = $additional['follow-redirect'];
unset ($additional['follow-redirect']);
}
// Initialise and execute a cURL request
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
// Get the default options array
$options = $this->defaultOptions;
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
$options[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
}
// Do I have explicit cURL options to add?
if (isset($additional['curl-options']) && is_array($additional['curl-options']))
{
// We can't use array_merge since we have integer keys and array_merge reassigns them :(
foreach ($additional['curl-options'] as $k => $v)
{
$options[$k] = $v;
}
}
// Set up custom headers
$headers = [];
if (isset($additional['headers']))
{
$headers = $additional['headers'];
unset ($additional['headers']);
}
// Add the authorization header
$headers[] = 'Authorization: Bearer ' . $this->accessToken;
$options[CURLOPT_HTTPHEADER] = $headers;
// Handle files
$file = null;
$fp = null;
if (isset($additional['file']))
{
$file = $additional['file'];
unset ($additional['file']);
}
if (!isset($additional['fp']) && !empty($file))
{
$mode = ($method == 'GET') ? 'w' : 'r';
$fp = @fopen($file, $mode);
}
elseif (isset($additional['fp']))
{
$fp = $additional['fp'];
unset($additional['fp']);
}
// Set up additional options
if ($method == 'GET' && $fp)
{
$options[CURLOPT_RETURNTRANSFER] = false;
$options[CURLOPT_HEADER] = false;
$options[CURLOPT_FILE] = $fp;
if (!$expectHttpStatus)
{
$expectHttpStatus = 200;
}
}
elseif (($method == 'POST' && !$fp))
{
$options[CURLOPT_POST] = true;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
elseif ($method == 'POST' && $fp)
{
$options[CURLOPT_POST] = true;
$data = '';
while (!feof($fp))
{
$data .= fread($fp, 1024768);
}
$options[CURLOPT_POSTFIELDS] = $data;
}
elseif ($method == 'GET' && !empty($additional))
{
$extraQuery = http_build_query($additional);
$glue = (strpos($url, '?') === false) ? '?' : '&';
$url .= $glue . $extraQuery;
curl_setopt($ch, CURLOPT_URL, $url);
}
else // Any other HTTP method, e.g. DELETE
{
$options[CURLOPT_CUSTOMREQUEST] = $method;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
// Set the cURL options at once
@curl_setopt_array($ch, $options);
// Set the follow location flag
if ($followRedirect)
{
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
}
// Execute and parse the response
//@curl_setopt($ch, CURLOPT_VERBOSE, true);
$response = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
$lastHttpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
// Close open file pointers
if ($fp)
{
$this->conditionalFileClose($fp);
if ($expectHttpStatus && ($expectHttpStatus != $lastHttpCode))
{
if ($file)
{
@unlink($file);
}
throw new RuntimeException("Unexpected HTTP status $lastHttpCode", $lastHttpCode);
}
}
// Did we have a cURL error?
if ($errNo)
{
throw new RuntimeException("cURL error $errNo: $error", 500);
}
if ($expectHttpStatus)
{
if ($expectHttpStatus == $lastHttpCode)
{
return [];
}
}
if ($noParse)
{
return $response;
}
// Parse the response
$originalResponse = $response;
$response = json_decode($response, true);
// Did we get invalid JSON data?
if (!empty($originalResponse) && !$response)
{
throw new RuntimeException("Invalid JSON data received: $originalResponse", 500);
}
elseif (empty($originalResponse))
{
$response = [];
}
unset($originalResponse);
// Did we get an error response?
if (isset($response['error']) && is_array($response['error']))
{
$error = $response['error']['code'];
$errorDescription = $response['error']['message'] ?? 'No error description provided';
throw new RuntimeException("Error $error: $errorDescription", 500);
}
// Did we get an error response (from the helper script)?
if (isset($response['error']))
{
$error = $response['error'];
$errorDescription = $response['error_description'] ?? 'No error description provided';
throw new RuntimeException("Error $error: $errorDescription", 500);
}
return $response;
}
}
PK \098- Z vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2/Exception/UnexpectedHTTPStatus.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Dropbox2\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class UnexpectedHTTPStatus extends Base
{
public function __construct($errNo = "500", $code = 0, ?Exception $previous = null)
{
$message = "Unexpected HTTP status $errNo";
parent::__construct($message, (int) $errNo, $previous);
}
}
PK \P5 O vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2/Exception/cURLError.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Dropbox2\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class cURLError extends Base
{
public function __construct($errNo = "500", $code = '', ?Exception $previous = null)
{
$message = "cURL error $errNo: $code";
parent::__construct($message, (int) $errNo, $previous);
}
}
PK \ES0. N vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2/Exception/APIError.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Dropbox2\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class APIError extends Base
{
/**
* APIError constructor.
*
* @param string $error Short error code
* @param string $errorDescription Long error description
* @param int $code Numeric error ID (default: 500)
* @param Exception|null $previous Previous exception
*/
public function __construct($error, $errorDescription, $code = 500, ?Exception $previous = null)
{
$message = "Error $error: $errorDescription";
parent::__construct($message, (int) $code, $previous);
}
}
PK \} J vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2/Exception/Base.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Dropbox2\Exception;
defined('AKEEBAENGINE') || die();
use RuntimeException;
class Base extends RuntimeException
{
}
PK \SJx x Q vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2/Exception/InvalidJSON.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Dropbox2\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class InvalidJSON extends Base
{
public function __construct($message = "Invalid JSON data received", $code = '500', ?Exception $previous = null)
{
parent::__construct($message, (int) $code, $previous);
}
}
PK \Sʉ K vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ A vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2/.htaccessnu 7m
Order allow,deny
Deny from all
PK \/I L vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Blob/Instance.phpnu [ .
*/
/**
* @package Akeeba\Engine\Postproc\Connector\AzureModern\Blob
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Blob;
use Exception;
/**
* @category Microsoft
* @package Microsoft_WindowsAzure
* @subpackage Storage
* @copyright Copyright (c) 2009, RealDolmen (http://www.realdolmen.com)
* @license http://phpazure.codeplex.com/license
*
* @property string $Container Container name
* @property string $Name Name
* @property string $Etag Etag
* @property string $LastModified Last modified date
* @property string $Url Url
* @property int $Size Size
* @property string $ContentType Content Type
* @property string $ContentEncoding Content Encoding
* @property string $ContentLanguage Content Language
* @property boolean $IsPrefix Is Prefix?
* @property array $Metadata Key/value pairs of meta data
*/
class Instance
{
/**
* Data
*
* @var array
*/
protected $_data = null;
/**
* Constructor
*
* @param string $containerName Container name
* @param string $name Name
* @param string $etag Etag
* @param string $lastModified Last modified date
* @param string $url Url
* @param int $size Size
* @param string $contentType Content Type
* @param string $contentEncoding Content Encoding
* @param string $contentLanguage Content Language
* @param boolean $isPrefix Is Prefix?
* @param array $metadata Key/value pairs of meta data
*/
public function __construct($containerName, $name, $etag, $lastModified, $url = '', $size = 0, $contentType = '', $contentEncoding = '', $contentLanguage = '', $isPrefix = false, $metadata = [])
{
$this->_data = [
'container' => $containerName,
'name' => $name,
'etag' => $etag,
'lastmodified' => $lastModified,
'url' => $url,
'size' => $size,
'contenttype' => $contentType,
'contentencoding' => $contentEncoding,
'contentlanguage' => $contentLanguage,
'isprefix' => $isPrefix,
'metadata' => $metadata,
];
}
/**
* Magic overload for getting properties
*
* @param string $name Name of the property
*/
public function __get($name)
{
if (array_key_exists(strtolower($name), $this->_data))
{
return $this->_data[strtolower($name)];
}
throw new Exception("Unknown property: " . $name);
}
/**
* Magic overload for setting properties
*
* @param string $name Name of the property
* @param string $value Value to set
*/
public function __set($name, $value)
{
if (array_key_exists(strtolower($name), $this->_data))
{
$this->_data[strtolower($name)] = $value;
return;
}
throw new Exception("Unknown property: " . $name);
}
}PK \N;' M vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Blob/Container.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Blob;
defined('AKEEBAENGINE') || die();
use Exception;
/**
* @property string $Name Name of the container
* @property string $Etag Etag of the container
* @property string $LastModified Last modified date of the container
* @property array $Metadata Key/value pairs of meta data
*
* @since 9.2.1
*/
class Container
{
/**
* Data
*
* @var array
*/
protected $_data = null;
/**
* Constructor
*
* @param string $name Name
* @param string $etag Etag
* @param string $lastModified Last modified date
* @param array $metadata Key/value pairs of meta data
*/
public function __construct(string $name, string $etag, string $lastModified, array $metadata = [])
{
$this->_data = [
'name' => $name,
'etag' => $etag,
'lastmodified' => $lastModified,
'metadata' => $metadata,
];
}
/**
* Magic overload for getting properties
*
* @param string $name Name of the property
*
* @throws Exception
*/
public function __get($name)
{
if (array_key_exists(strtolower($name), $this->_data))
{
return $this->_data[strtolower($name)];
}
throw new Exception("Unknown property: " . $name);
}
/**
* Magic overload for setting properties
*
* @param string $name Name of the property
* @param string $value Value to set
*
* @throws Exception
*/
public function __set($name, $value)
{
if (array_key_exists(strtolower($name), $this->_data))
{
$this->_data[strtolower($name)] = $value;
return;
}
throw new Exception("Unknown property: " . $name);
}
}
PK \0J J H vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Blob/Blob.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Blob;
defined('AKEEBAENGINE') || die();
use Exception;
/**
* BLOB entry
*
* @property string $Container Container name
* @property string $Name Name
* @property string $Etag Etag
* @property string $LastModified Last modified date
* @property string $Url Url
* @property int $Size Size
* @property string $ContentType Content Type
* @property string $ContentEncoding Content Encoding
* @property string $ContentLanguage Content Language
* @property boolean $IsPrefix Is Prefix?
* @property array $Metadata Key/value pairs of meta data
*
* @since 9.2.1
*/
class Blob
{
/**
* Data
*
* @var array
* @since 9.2.1
*/
protected $_data = null;
/**
* Constructor
*
* @param string $containerName Container name
* @param string $name Name
* @param string $etag Etag
* @param string $lastModified Last modified date
* @param string $url Url
* @param int $size Size
* @param string $contentType Content Type
* @param string $contentEncoding Content Encoding
* @param string $contentLanguage Content Language
* @param bool $isPrefix Is Prefix?
* @param array $metadata Key/value pairs of meta data
*/
public function __construct(
string $containerName, string $name, string $etag, string $lastModified, string $url = '', int $size = 0,
string $contentType = '', string $contentEncoding = '', string $contentLanguage = '',
bool $isPrefix = false, array $metadata = []
)
{
$this->_data = [
'container' => $containerName,
'name' => $name,
'etag' => $etag,
'lastmodified' => $lastModified,
'url' => $url,
'size' => $size,
'contenttype' => $contentType,
'contentencoding' => $contentEncoding,
'contentlanguage' => $contentLanguage,
'isprefix' => $isPrefix,
'metadata' => $metadata,
];
}
/**
* Magic overload for getting properties
*
* @param string $name Name of the property
*
* @throws Exception
*/
public function __get($name)
{
if (array_key_exists(strtolower($name), $this->_data))
{
return $this->_data[strtolower($name)];
}
throw new Exception("Unknown property: " . $name);
}
/**
* Magic overload for setting properties
*
* @param string $name Name of the property
* @param string $value Value to set
*
* @throws Exception
*/
public function __set($name, $value)
{
if (array_key_exists(strtolower($name), $this->_data))
{
$this->_data[strtolower($name)] = $value;
return;
}
throw new Exception("Unknown property: " . $name);
}
}
PK \Sʉ I vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Blob/.htaccessnu 7m
Order allow,deny
Deny from all
PK \xT H vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Connector.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\AzureModern\Blob\Instance;
use Akeeba\Engine\Postproc\Connector\AzureModern\Blob\Container;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\ApiException;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\FileTooBigToChunk;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\FileTooBigToSingleUpload;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\ForwardSlashNotAllowed;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\InvalidContainerName;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\LocalFileNotFound;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\MaxBlockSizeExceeded;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\NoBlobName;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\NoBlocks;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\NoContainerName;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\NoData;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\NoLocalFileName;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\TooManyBlocks;
use Akeeba\Engine\Postproc\Connector\AzureModern\Exception\UnexpectedHTTPStatus;
use Akeeba\Engine\Util\HashTrait;
use Akeeba\S3\Response;
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use SimpleXMLElement;
/**
* Microsoft Azure connector, modernized
*/
class Connector
{
use HashTrait;
use FileCloseAware;
use ProxyAware;
/**
* The version of the API we are using
*
* @const string
* @since 9.2.1
*/
private const API_VERSION = '2019-12-12';
/**
* Default cURL options
*
* @since 9.2.1
*/
private const DEFAULT_CURL_OPTIONS = [
CURLOPT_USERAGENT => 'AkeebaEngine/9',
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
CURLOPT_VERBOSE => false,
CURLOPT_HEADER => false,
CURLINFO_HEADER_OUT => false,
CURLOPT_RETURNTRANSFER => false,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
CURLOPT_FOLLOWLOCATION => true,
];
/**
* The credentials signing object
*
* @var Credentials
* @since 9.2.1
*/
private $credentials;
/**
* The endpoint domain name for Microsoft Azure
*
* @var bool
* @since 9.2.1
*/
private $endPoint = 'core.windows.net';
/**
* Should I use HTTPS for accessing Microsoft Azure?
*
* @var bool
* @since 9.2.1
*/
private $useSSL;
/**
* The response being worked on by performRequest()
*
* @var Response|null
* @since 9.2.1
*/
private $response = null;
/**
* The output file pointer used in performRequest();
*
* @var resource|null
* @since 9.2.1
*/
private $fp = null;
/**
* Creates a new Credentials instance
*
* @param string $accountName Account name for Microsoft Azure
* @param string $accountKey Account key for Microsoft Azure
* @param bool $usePathStyleUri Use path-style URI's? Default false.
* @param bool $useSSL Should I use HTTPS? Default true.
* @param string $endPoint Endpoint domain name, default core.windows.net
*
* @since 9.2.1
*/
public function __construct(string $accountName, string $accountKey, bool $usePathStyleUri = false, bool $useSSL = true, string $endPoint = 'core.windows.net')
{
$this->credentials = new Credentials($accountName, $accountKey, $usePathStyleUri);
$this->useSSL = $useSSL;
$this->endPoint = $endPoint;
}
/**
* Get a connector object given a connection string.
*
* The connection string looks like this:
* DefaultEndpointsProtocol=https;AccountName=foobar;AccountKey=AAAAAA=;EndpointSuffix=core.windows.net
*
* @param string $connectionString The connection string to parse
*
* @return static
* @since 9.2.1
*/
public static function fromConnectionString(string $connectionString): self
{
$lines = explode(';', $connectionString);
$data = [];
foreach ($lines as $line)
{
$parts = explode('=', $line, 2);
if (count($parts) != 2)
{
continue;
}
$data[strtolower($parts[0])] = $parts[1];
}
return new self(
$data['accountname'] ?? '',
$data['accountkey'] ?? '',
false,
strtolower($data['defaultendpointsprotocol'] ?? '') != 'http',
$data['endpointsuffix'] ?? 'core.windows.net'
);
}
/**
* Get the container properties
*
* @param string $containerName Container name
*
* @return Container
*
* @throws ApiException
* @since 9.2.1
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-properties
*/
public function getContainer(string $containerName = ''): Container
{
if ($containerName === '')
{
throw new NoContainerName();
}
if (!self::isValidContainerName($containerName))
{
throw new InvalidContainerName();
}
// Perform request
$response = $this->performRequest('GET', $containerName, '?restype=container');
if ($response->getCode() > 399)
{
throw new UnexpectedHTTPStatus($response->getCode());
}
elseif ($response->error->isError())
{
throw new ApiException($response->error->getMessage(), $response->error->getCode());
}
// Parse metadata
$metadata = [];
foreach ($response->getHeaders() as $key => $value)
{
if (substr(strtolower($key), 0, 10) == "x-ms-meta-")
{
$metadata[str_replace("x-ms-meta-", '', strtolower($key))] = $value;
}
}
$headers = $response->getHeaders();
return new Container(
$containerName,
$this->extractHeader($headers, 'Etag'),
$this->extractHeader($headers, 'Last-modified'),
$metadata
);
}
/**
* Put blob
*
* @param string $containerName Container name
* @param string $blobName Blob name
* @param string $localFileName Local file name to be uploaded
* @param array $metadata Key/value pairs of meta data
* @param array $additionalHeaders Additional headers.
*
* @return Instance Partial blob properties
* @throws ApiException
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Specifying-Conditional-Headers-for-Blob-Service-Operations
*
* @since 9.2.1
*/
public function putBlob(
string $containerName = '', string $blobName = '', string $localFileName = '', array $metadata = [],
array $additionalHeaders = []
)
{
if ($containerName === '')
{
throw new NoContainerName();
}
if (!self::isValidContainerName($containerName))
{
throw new InvalidContainerName();
}
if ($blobName === '')
{
throw new NoBlobName();
}
if ($localFileName === '')
{
throw new NoLocalFileName();
}
if (!file_exists($localFileName))
{
throw new LocalFileNotFound();
}
if (($containerName === '$root') && strpos($blobName, '/') !== false)
{
throw new ForwardSlashNotAllowed();
}
/**
* Mandatory headers for this API version
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Put-Blob
*/
$headers = [
'x-ms-blob-type' => 'BlockBlob',
];
// Create metadata headers
foreach ($metadata as $key => $value)
{
$headers["x-ms-meta-" . strtolower($key)] = $value;
}
// Additional headers?
foreach ($additionalHeaders as $key => $value)
{
$headers[$key] = $value;
}
// File contents
$contentLength = (int) filesize($localFileName);
$headers['file'] = $localFileName;
$headers['Content-Length'] = $contentLength;
// Is this file too big to upload?
$chunkSize = $this->getBestBlockSize($localFileName, 0);
if ($chunkSize > 0)
{
throw new FileTooBigToSingleUpload();
}
// Resource name
$resourceName = self::createResourceName($containerName, $blobName);
// Perform request
$response = $this->performRequest('PUT', $resourceName, '', $headers);
if ($response->error->isError())
{
throw new ApiException($response->error->getMessage(), $response->error->getCode());
}
if ($response->getCode() > 399)
{
throw new ApiException($this->getErrorMessage($response, 'Resource could not be accessed.'), $response->getCode());
}
$headers = $response->getHeaders();
return new Instance(
$containerName,
$blobName,
$this->extractHeader($headers, 'Etag'),
$this->extractHeader($headers, 'Last-modified'),
$this->getBaseUrl() . '/' . $containerName . '/' . $blobName,
$contentLength,
'',
'',
'',
false,
$metadata
);
}
/**
* Put blob block.
*
* Used for chunked uploading.
*
* Make sure the $additionalHeaders array contains a `blockid` key. If it's missing, a random one will be created
* and returned by this method.
*
* @param string $containerName Container name
* @param string $blobName Blob name
* @param string $data Binary data to upload into the blob object's block
* @param array $metadata Key/value pairs of meta data
* @param array $additionalHeaders Additional headers
*
* @return string The block ID which was sent to Azure
* @throws ApiException
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/put-block
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Specifying-Conditional-Headers-for-Blob-Service-Operations
*
* @since 9.2.1
*/
public function putBlock(
string $containerName = '', string $blobName = '', string $data = '', array $metadata = [],
array $additionalHeaders = []
): string
{
if ($containerName === '')
{
throw new NoContainerName();
}
if (!self::isValidContainerName($containerName))
{
throw new InvalidContainerName();
}
if ($blobName === '')
{
throw new NoBlobName();
}
if (($containerName === '$root') && strpos($blobName, '/') !== false)
{
throw new ForwardSlashNotAllowed();
}
if ($data === '')
{
throw new NoData();
}
// Blob block size check
$currentSize = function_exists('mb_strlen') ? mb_strlen($data, '8bit') : strlen($data);
$utcTz = new \DateTimeZone('utc');
$versionAsTime = new \DateTime(self::API_VERSION, $utcTz);
if ($versionAsTime->getTimestamp() >= (new \DateTime('2019-12-12', $utcTz))->getTimestamp())
{
$maxSize = 4000 * 1024 * 1024;
}
elseif ($versionAsTime->getTimestamp() >= (new \DateTime('2016-05-31', $utcTz))->getTimestamp())
{
$maxSize = 10 * 1024 * 1024;
}
else
{
$maxSize = 4 * 1024 * 1024;
}
if ($currentSize > $maxSize)
{
throw new MaxBlockSizeExceeded($currentSize, $maxSize);
}
// Make sure I have a block ID
$encodedBlockId = $additionalHeaders['blockid'] ?? null;
if (empty($encodedBlockId))
{
$additionalHeaders['blockid'] = '';
$encodedBlockId = base64_encode(self::sha1(microtime() . random_bytes(12)));
}
unset($additionalHeaders['blockid']);
/**
* Mandatory headers for this API version
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Put-Blob
*/
$headers = [
'x-ms-blob-type' => 'BlockBlob',
];
// Create metadata headers
foreach ($metadata as $key => $value)
{
$headers["x-ms-meta-" . strtolower($key)] = $value;
}
// Additional headers?
foreach ($additionalHeaders as $key => $value)
{
$headers[$key] = $value;
}
// File contents
$headers['explicit_post'] = &$data;
$headers['Content-Length'] = $currentSize;
$headers['Content-Type'] = 'application/x-www-form-urlencoded';
// Resource name
$resourceName = self::createResourceName($containerName, $blobName);
// Perform request
$queryParams = [
'comp' => 'block',
'blockid' => $encodedBlockId,
];
$response = $this->performRequest('PUT', $resourceName, '?' . http_build_query($queryParams), $headers);
if ($response->error->isError())
{
throw new ApiException($response->error->getMessage(), $response->error->getCode());
}
if ($response->getCode() != 201)
{
throw new ApiException($this->getErrorMessage($response, 'Resource could not be accessed.'), $response->getCode());
}
return base64_decode($encodedBlockId);
}
/**
* Finalize a chunked upload
*
* @param string $containerName Container name
* @param string $blobName Blob name
* @param array $blockIds List of the NON-encoded block IDs to commit
*
* @return void
* @since 9.2.1
*/
public function putBlockList(string $containerName = '', string $blobName = '', array $blockIds = []): void
{
if ($containerName === '')
{
throw new NoContainerName();
}
if (!self::isValidContainerName($containerName))
{
throw new InvalidContainerName();
}
if ($blobName === '')
{
throw new NoBlobName();
}
if (($containerName === '$root') && strpos($blobName, '/') !== false)
{
throw new ForwardSlashNotAllowed();
}
if (empty($blockIds))
{
throw new NoBlocks();
}
if (count($blockIds) > 50000)
{
throw new TooManyBlocks();
}
// Construct the document to PUT.
$data = '' . "\n" .
array_reduce($blockIds, function (string $carry, string $item) {
return sprintf("%s%s\n", $carry, base64_encode($item));
}, '') . '';
$headers = [
'Content-Type' => 'text/plain; charset=UTF-8',
'Content-Length' => function_exists('mb_strlen') ? mb_strlen($data, '8bit') : strlen($data),
'explicit_post' => $data,
];
// Resource name
$resourceName = self::createResourceName($containerName, $blobName);
// Perform request
$response = $this->performRequest('PUT', $resourceName, '?comp=blocklist', $headers);
if ($response->error->isError())
{
throw new ApiException($response->error->getMessage(), $response->error->getCode());
}
if ($response->getCode() != 201)
{
throw new ApiException($this->getErrorMessage($response, 'Resource could not be accessed.'), $response->getCode());
}
}
/**
* Find the best block size for putBlock for a given file.
*
* The best block size is one which does not cause the block count to exceed 50,000 (Azure's hard limit on the
* number of blocks a BLOB object can consist of) and is not lower than $desirableBlockSize.
*
* For example, a 100Gb file has a minimum block size of 2100Kb (just over 2Mb). If the $desirableBlockSize is 10Mb
* then this method will return 10Mb. If the $desirableBlockSize is 1Mb this method will return 2100Kb (higher than
* the desirable), otherwise you'd need more than 50,000 blocks which is not allowed.
*
* Each block size can also not be higher than 4000MiB, 100MiB or 4MiB depending on the API version. This is also
* taken into account. If the desirable block size is higher than that it is squashed down to the limit. If the
* calculated minimum block size exceeds that you will get an exception.
*
* In practical terms, each API version defines a maximum file size limit (max block size x 50,000):
* - < 2016-05-31: 195GiB (4MiB x 50,000 blocks)
* - 2016-05-31 to 2019-07-07: 4.75TiB (100MiB x 50,000 blocks)
* - >= 2019-12-12: 190.7TiB (4000MiB x 50,000 blocks)
*
* If the $desirableBlockSize is 0 this is understood as a query to whether the file can be uploaded with a putBlob
* in one go. In this case the value returned is either 0 (you can upload with putBlob) or the minimum block size.
*
* Each API version has a different maximum file size for direct file upload:
* - < 2016-05-31: 64MiB
* - 2016-05-31 to 2019-07-07: 256MiB
* - >= 2019-12-12: 5000MiB (in preview status as of April 2022 when this code was last updated)
*
* @param string $fileName
* @param int $desirableBlockSize
*
* @return int
* @throws ApiException
* @since 9.2.1
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/put-block-list
*/
public function getBestBlockSize(string $fileName, int $desirableBlockSize = 10485760): int
{
// Make sure the file exists and we can get its file size.
@clearstatcache($fileName);
if (!file_exists($fileName) || !is_file($fileName))
{
return $desirableBlockSize;
}
$fileSize = @filesize($fileName);
if (!$fileSize)
{
return $desirableBlockSize;
}
// What is the minimum block size we have to use to upload this file?
$minBlockSize = ceil($fileSize / 50000);
// Find the limits for each API version
$utcTz = new \DateTimeZone('utc');
$versionAsTime = new \DateTime(self::API_VERSION, $utcTz);
if ($versionAsTime->getTimestamp() >= (new \DateTime('2019-12-12', $utcTz))->getTimestamp())
{
$maxBlockSize = 4000 * 1024 * 1024;
$maxBlobSize = 5000 * 1024 * 1024;
}
elseif ($versionAsTime->getTimestamp() >= (new \DateTime('2016-05-31', $utcTz))->getTimestamp())
{
$maxBlockSize = 10 * 1024 * 1024;
$maxBlobSize = 256 * 1024 * 1024;
}
else
{
$maxBlockSize = 4 * 1024 * 1024;
$maxBlobSize = 64 * 1024 * 1024;
}
// If the $desirableBlockSize is 0 we are querying whether the file can be uploaded in one go.
if (empty($desirableBlockSize) && ($fileSize <= $maxBlobSize))
{
return 0;
}
// The $desirableBlockSize must be smaller than $maxBlockSize
$desirableBlockSize = min($desirableBlockSize, $maxBlockSize);
// The $minBlockSize must be lower than $maxBlockSize
if ($minBlockSize > $maxBlockSize)
{
throw new FileTooBigToChunk();
}
// In any other case return the largest between the $minBlockSize and $desirableBlockSize.
return max($minBlockSize, $desirableBlockSize);
}
/**
* Get the blob contents into a file
*
* @param string $containerName Container name
* @param string $blobName Blob name
* @param string $localFileName The filename in the local filesystem to write to
* @param string|null $snapshotId Snapshot identifier
* @param string|null $leaseId Lease identifier
* @param array $additionalHeaders Additional headers.
*
* @return void
* @throws ApiException
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Specifying-Conditional-Headers-for-Blob-Service-Operations
*
*/
public function getBlob(
string $containerName = '', string $blobName = '', string $localFileName = '', ?string $snapshotId = null,
?string $leaseId = null, array $additionalHeaders = []
)
{
$additionalHeaders = array_merge($additionalHeaders, ['file' => $localFileName]);
$this->getBlobData($containerName, $blobName, $snapshotId, $leaseId, $additionalHeaders);
}
/**
* Get blob data
*
* @param string $containerName Container name
* @param string $blobName Blob name
* @param string|null $snapshotId Snapshot identifier
* @param string|null $leaseId Lease identifier
* @param array $additionalHeaders Additional headers.
*
* @return mixed Blob contents
*
* @throws ApiException
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Specifying-Conditional-Headers-for-Blob-Service-Operations
*
* @since 9.2.1
*/
public function getBlobData(
string $containerName = '', string $blobName = '', ?string $snapshotId = null, ?string $leaseId = null,
array $additionalHeaders = []
)
{
if ($containerName === '')
{
throw new NoContainerName();
}
if (!self::isValidContainerName($containerName))
{
throw new InvalidContainerName();
}
if ($blobName === '')
{
throw new NoBlobName();
}
// Build query string
$queryString = [];
if (!is_null($snapshotId))
{
$queryString['snapshot'] = $snapshotId;
}
$queryString = '?' . http_build_query($queryString);
// Additional headers?
$headers = [];
if (!is_null($leaseId))
{
$headers['x-ms-lease-id'] = $leaseId;
}
foreach ($additionalHeaders as $key => $value)
{
$headers[$key] = $value;
}
// Resource name
$resourceName = self::createResourceName($containerName, $blobName);
// Perform request
$response = $this->performRequest('GET', $resourceName, $queryString, $headers);
if ($response->error->isError())
{
throw new ApiException($response->error->getMessage(), $response->error->getCode());
}
if ($response->getCode() > 399)
{
throw new ApiException($this->getErrorMessage($response, 'Resource could not be accessed.'));
}
return $response->getBody();
}
/**
* Delete blob
*
* @param string $containerName Container name
* @param string $blobName Blob name
* @param string|null $snapshotId Snapshot identifier
* @param string|null $leaseId Lease identifier
* @param array $additionalHeaders Additional headers.
*
* @throws ApiException
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Specifying-Conditional-Headers-for-Blob-Service-Operations
*/
public function deleteBlob(
string $containerName = '', string $blobName = '', ?string $snapshotId = null, ?string $leaseId = null,
array $additionalHeaders = []
)
{
if ($containerName === '')
{
throw new NoContainerName();
}
if (!self::isValidContainerName($containerName))
{
throw new InvalidContainerName();
}
if ($blobName === '')
{
throw new NoBlobName();
}
if (($containerName === '$root') && strpos($blobName, '/') !== false)
{
throw new ForwardSlashNotAllowed();
}
$queryString = [];
if (!is_null($snapshotId))
{
$queryString['snapshot'] = $snapshotId;
}
$queryString = '?' . http_build_query($queryString);
// Additional headers?
$headers = [];
if (!is_null($leaseId))
{
$headers['x-ms-lease-id'] = $leaseId;
}
foreach ($additionalHeaders as $key => $value)
{
$headers[$key] = $value;
}
// Resource name
$resourceName = self::createResourceName($containerName, $blobName);
// Perform request
$response = $this->performRequest('DELETE', $resourceName, $queryString, $headers);
if ($response->error->isError())
{
throw new ApiException($response->error->getMessage(), $response->error->getCode());
}
if ($response->getCode() > 399)
{
throw new ApiException($this->getErrorMessage($response, 'Resource could not be accessed.'));
}
}
/**
* Returns a signed download (GET) URL for a specific blob
*
* @param string $container The name of the container where the Blob is in
* @param string $remotePath Remote path to the Blob, relative to the container's root
* @param int $expiresInSeconds How many seconds from now does the link expire (default: 900 seconds)
*
* @return string Signed download URL
* @since 9.2.1
*/
public function getSignedURL($container, $remotePath, $expiresInSeconds = 900)
{
$account = $this->credentials->getAccountName();
$canonicalURL = '/' . $account . '/' . $container . '/' . ltrim($remotePath, '/');
// Signing API version
$signedVersion = '2012-02-12';
// Signature resource type (Blob)
$signedresource = 'b';
// Signed start
$signedStart = gmdate('Y-m-d\TH:i:s', time()) . 'Z';
// Signed expiration
$signedExpiry = gmdate('Y-m-d\TH:i:s', time() + $expiresInSeconds) . 'Z';
// Signed permissions (read only)
$signedPermissions = 'r';
/**
* Calculate the string to sign
*
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-service-sas#version-2012-02-12
*/
// Signed Permissions
$stringToSign = $signedPermissions . "\n";
// Signed Start
$stringToSign .= $signedStart . "\n";
// Signed Expiry
$stringToSign .= $signedExpiry . "\n";
// Canonicalized resource
$stringToSign .= $canonicalURL . "\n";
// Signed Identifier
$stringToSign .= "\n";
// Signed Version
$stringToSign .= $signedVersion;
$sig = base64_encode(hash_hmac('sha256', $stringToSign, $this->credentials->getAccountKey(), true));
$query = http_build_query([
'sv' => $signedVersion,
'st' => $signedStart,
'se' => $signedExpiry,
'sr' => $signedresource,
'sp' => $signedPermissions,
'sig' => $sig,
]);
return $this->getBaseUrl() . '/' . $container . '/' . ltrim($remotePath, '/') . '?' . $query;
}
/**
* cURL write callback
*
* @param resource $curl cURL resource
* @param string $data Data
*
* @return int Length in bytes
* @since 9.2.1
*/
protected function __responseWriteCallback($curl, string $data): int
{
if (in_array($this->response->code, [200, 206]) && !is_null($this->fp) && is_resource($this->fp))
{
return fwrite($this->fp, $data);
}
$this->response->addToBody($data);
return strlen($data);
}
/**
* cURL header callback
*
* @param resource $curl cURL resource
* @param string $data Data
*
* @return int Length in bytes
* @since 9.2.1
*/
protected function __responseHeaderCallback($curl, string $data): int
{
if (($strlen = strlen($data)) <= 2)
{
return $strlen;
}
if (substr($data, 0, 4) == 'HTTP')
{
$this->response->code = (int) substr($data, 9, 3);
return $strlen;
}
[$header, $value] = explode(': ', trim($data), 2);
if (is_string($value) && strlen($value) > 0 && substr($value, 0, 1) === '"' && substr($value, -1) === '"')
{
$value = trim($value, '"');
}
$this->response->setHeader($header, is_numeric($value) ? (int) $value : $value);
return $strlen;
}
/**
* Parse result from Response
*
* @param Response|null $response Response from HTTP call
*
* @return SimpleXMLElement
* @since 9.2.1
*/
private function parseResponse(?Response $response = null)
{
if (is_null($response))
{
throw new ApiException('Response should not be null.');
}
$xml = @simplexml_load_string($response->getBody());
if ($xml !== false)
{
// Fetch all namespaces
$namespaces = array_merge($xml->getNamespaces(true), $xml->getDocNamespaces(true));
// Register all namespace prefixes
foreach ($namespaces as $prefix => $ns)
{
if ($prefix != '')
{
$xml->registerXPathNamespace($prefix, $ns);
}
}
}
return $xml;
}
/**
* Get error message from Response
*
* @param Response $rawResponse Response
* @param string $alternativeError Alternative error message
*
* @return string
*
* @throws ApiException
* @since 9.2.1
*/
private function getErrorMessage(Response $rawResponse, string $alternativeError = 'Unknown error.')
{
$response = $this->parseResponse($rawResponse);
if ($response && $response->Message)
{
$error = (string) $response->Message;
// And add some debug information
$error .= "\n\nRAW REPLY (FOR DEBUGGING):\n\n" . $rawResponse->getBody();
return $error;
}
return $alternativeError;
}
/**
* Create resource name
*
* @param string $containerName Container name
* @param string $blobName Blob name
*
* @return string
* @since 9.2.1
*/
private function createResourceName(string $containerName = '', string $blobName = ''): string
{
if ($blobName === '')
{
return $containerName;
}
if ($containerName === '' || $containerName === '$root')
{
return $blobName;
}
return $containerName . '/' . $blobName;
}
/**
* Is valid container name?
*
* @param string $containerName Container name
*
* @return boolean
* @since 9.2.1
*
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/Naming-and-Referencing-Containers--Blobs--and-Metadata
*/
private function isValidContainerName($containerName = '')
{
if ($containerName == '$root')
{
return true;
}
if (!preg_match('/^[a-z0-9][a-z0-9-]*$/', $containerName))
{
return false;
}
if (strpos($containerName, '--') !== false)
{
return false;
}
if (strtolower($containerName) != $containerName)
{
return false;
}
if (strlen($containerName) < 3 || strlen($containerName) > 63)
{
return false;
}
if (substr($containerName, -1) == '-')
{
return false;
}
return true;
}
/**
* Perform a request to Windows Azure.
*
* @param string $verb The HTTP verb (GET, POST, PUT, DELETE, ...)
* @param string $path The path to the BLOB object
* @param string $queryString The query string to append to the path when constructing the URL
* @param array $headers A dictionary of HTTP headers
*
* @return Response
* @since 9.2.1
*/
private function performRequest(string $verb, string $path, string $queryString, array $headers = []): Response
{
$path = '/' . ltrim($path, '/');
$path = $this->urlencode($path);
$queryString = $this->urlencode($queryString);
$url = $this->getBaseUrl() . $path . $queryString;
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
$options = self::DEFAULT_CURL_OPTIONS;
$options[CURLOPT_WRITEFUNCTION] = [$this, '__responseWriteCallback'];
$options[CURLOPT_HEADERFUNCTION] = [$this, '__responseHeaderCallback'];
// Try to use at least TLS 1.2. Requires cURL 7.34.0 or later.
if (defined('CURLOPT_SSLVERSION') && defined('CURL_SSLVERSION_TLSv1_2'))
{
$options[CURLOPT_SSLVERSION] = CURL_SSLVERSION_TLSv1_2;
}
else
{
Factory::getLog()->warning('Your server does nor support making requests with TLSv1.2 or later. Microsoft Azure discontinues support for TLSv1.0 and TLSv1.1 on October 31st, 2024. Please make sure that your server is using a version of PHP compiled against the cURL library version 7.34.0 or later. Failure to do so will result in inability to use this software with Microsoft Azure BLOB storage.');
}
// Do I have explicit cURL options to add?
if (isset($headers['curl-options']) && is_array($headers['curl-options']))
{
// We can't use array_merge since we have integer keys and array_merge reassigns them :(
foreach ($headers['curl-options'] as $k => $v)
{
$options[$k] = $v;
}
unset($headers['curl-options']);
}
// Handle files
$file = $headers['file'] ?? null;
$this->fp = $headers['fp'] ?? null;
$fileMode = $headers['file_mode'] ?? null;
$explicitPost = $headers['explicit_post'] ?? null;
foreach (['file', 'fp', 'file_mode', 'explicit_post'] as $k)
{
if (isset($headers[$k]))
{
unset($headers[$k]);
}
}
if (($this->fp === null) && !empty($file))
{
$fileMode = $fileMode ?: ($verb == 'GET' ? 'w' : 'r');
$this->fp = @fopen($file, $fileMode);
}
// Set up additional options
if ($verb == 'GET' && $this->fp)
{
unset($options[CURLOPT_WRITEFUNCTION]);
$options[CURLOPT_HTTPGET] = true;
$options[CURLOPT_HEADER] = false;
$options[CURLOPT_FILE] = $this->fp;
}
elseif ($verb == 'GET')
{
$options[CURLOPT_HTTPGET] = true;
}
elseif ($verb == 'POST')
{
$options[CURLOPT_POST] = true;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
// This is required for some broken servers, e.g. SiteGround
else
{
$options[CURLOPT_POSTFIELDS] = '';
}
}
elseif ($verb == 'PUT' && $this->fp)
{
$options[CURLOPT_PUT] = true;
$options[CURLOPT_INFILE] = $this->fp;
if ($file)
{
clearstatcache();
$options[CURLOPT_INFILESIZE] = @filesize($file);
}
else
{
$options[CURLOPT_INFILESIZE] = strlen(stream_get_contents($this->fp));
}
fseek($this->fp, 0);
}
else
{
$options[CURLOPT_CUSTOMREQUEST] = $verb;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif ($verb === 'HEAD')
{
/** @see http://stackoverflow.com/questions/770179/php-curl-head-request-takes-a-long-time-on-some-sites */
$options[CURLOPT_NOBODY] = true;
}
}
// Sign and apply headers
$headers['x-ms-version'] = self::API_VERSION;
$requestHeaders = $this->credentials->signRequestHeaders($verb, $path, $queryString, $headers);
$requestHeaders = array_map(function ($k, $v) {
return "$k:$v";
}, array_keys($requestHeaders), array_values($requestHeaders));
$options[CURLOPT_HTTPHEADER] = $requestHeaders;
@curl_setopt_array($ch, $options);
$this->response = new Response();
if (curl_exec($ch))
{
$this->response->code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
}
else
{
$this->response->error = new Response\Error(
curl_errno($ch),
curl_error($ch),
$url
);
}
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
@curl_close($ch);
}
// Close open file pointers
if (($this->fp !== false) && is_resource($this->fp))
{
$this->conditionalFileClose($this->fp);
if ($this->response->getCode() > 399 && !empty($file) && ($verb == 'GET'))
{
@unlink($file);
}
}
$this->fp = null;
return $this->response;
}
/**
* (Partial) URL encode function
*
* @param string $value Value to encode
*
* @return string Encoded value
* @since 9.2.1
*/
private function urlencode(string $value): string
{
return str_replace(' ', '%20', $value);
}
/**
* Get base URL for creating requests
*
* @return string
* @since 9.2.1
*/
private function getBaseUrl(): string
{
$schema = $this->useSSL ? 'https://' : 'http://';
if ($this->credentials->isUsePathStyleUri())
{
return $schema . 'blob.' . $this->endPoint . '/' . $this->credentials->getAccountName();
}
return $schema . $this->credentials->getAccountName() . '.' . 'blob.' . $this->endPoint;
}
/**
* Extract a header value, case-insensitive
*
* @param array $headers The dictionary of headers
* @param string $key The key to extract, case-insensitive
* @param string|null $default The default value to return if the key is missing
*
* @return string|null
* @since 9.2.1
*/
private function extractHeader(array $headers, string $key, ?string $default = null): ?string
{
static $convertedHeaders = [];
if (self::md5(serialize($convertedHeaders)) != self::md5(serialize($headers)))
{
$convertedHeaders = array_combine(
array_map('strtolower', array_keys($headers)),
array_values($headers)
);
}
return $convertedHeaders[strtolower($key)] ?? $default;
}
}PK \"z# z# J vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Credentials.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern;
use Akeeba\Engine\Util\HashTrait;
defined('AKEEBAENGINE') || die();
/**
* Microsoft Azure Storage request signing with the Storage account key access method.
*
* @since 9.2.1
*/
class Credentials
{
use HashTrait;
/**
* Account name for Microsoft Azure
*
* @var string
* @since 9.2.1
*/
private $accountName = '';
/**
* Account key for Microsoft Azure
*
* @var string
* @since 9.2.1
*/
private $accountKey = '';
/**
* Use path-style URI's
*
* @var bool
* @since 9.2.1
*/
private $usePathStyleUri = false;
/**
* Creates a new Credentials instance
*
* @param string $accountName Account name for Microsoft Azure
* @param string $accountKey Account key for Microsoft Azure
* @param bool $usePathStyleUri Use path-style URI's?
*
* @since 9.2.1
*/
public function __construct(string $accountName, string $accountKey, bool $usePathStyleUri = false)
{
$this->accountName = $accountName;
$this->accountKey = base64_decode($accountKey);
$this->usePathStyleUri = $usePathStyleUri;
}
/**
* Get a credentials object given a connection string.
*
* The connection string looks like this:
* DefaultEndpointsProtocol=https;AccountName=foobar;AccountKey=AAAAAA=;EndpointSuffix=core.windows.net
*
* @param string $connectionString The connection string to parse
*
* @return static
* @since 9.2.1
*/
public static function fromConnectionString(string $connectionString): self
{
$lines = explode(';', $connectionString);
$data = [];
foreach ($lines as $line)
{
$parts = explode('=', $line, 2);
if (count($parts) != 2)
{
continue;
}
$data[strtolower($parts[0])] = $parts[1];
}
return new self($data['accountname'] ?? '', $data['accountkey'] ?? '', false);
}
/**
* Set account name for Microsoft Azure
*
* @param string $value
*
* @since 9.2.1
*/
public function setAccountName(string $value): void
{
$this->accountName = $value;
}
/**
* Set account key for Microsoft Azure
*
* @param string $value The base64-encoded Key
*
* @since 9.2.1
*/
public function setAccountKey(string $value): void
{
$this->accountKey = base64_decode($value);
}
/**
* Set use path-style URI's
*
* @param boolean $value
*
* @since 9.2.1
*/
public function setUsePathStyleUri(bool $value)
{
$this->usePathStyleUri = $value;
}
/**
* Sign request headers with credentials
*
* @param string $httpVerb HTTP verb the request will use
* @param string $path Path for the request
* @param string $queryString Query string for the request
* @param array $headers x-ms headers to add
*
* @return array Array of headers
* @see https://docs.microsoft.com/en-us/azure/storage/common/storage-rest-api-auth#creating-the-authorization-header
* @since 9.2.1
*/
public function signRequestHeaders(string $httpVerb, string $path = '/', string $queryString = '', array $headers = [])
{
// Determine path and query
$queryString = $this->prepareQueryStringForSigning($queryString);
// Request date (RFC 1123) must always be present
$requestDate = $this->extractHeader(
$headers, 'x-ms-date',
$this->extractHeader($headers, 'Date', gmdate('D, d M Y H:i:s', time()) . ' GMT')
);
$headers['x-ms-date'] = $requestDate;
// Cast header values to strings
$headers = array_map(function ($x) {
if (is_bool($x))
{
$x = $x ? 'True' : 'False';
}
elseif (is_scalar($x))
{
$x = (string) $x;
}
else
{
$x = null;
}
return $x;
}, $headers);
$headers = array_filter($headers, function ($x) {
return $x !== null;
});
// Build canonicalized headers
$canonicalizedHeaders = array_filter($headers, function ($x) {
return strpos(strtolower($x), 'x-ms-') === 0;
}, ARRAY_FILTER_USE_KEY);
$canonicalizedHeaders = array_map(function ($k, $v) {
return strtolower($k) . ':' . $v;
}, array_keys($canonicalizedHeaders), array_values($canonicalizedHeaders));
sort($canonicalizedHeaders);
// Build canonicalized resource string
$canonicalizedResource = '/' . $this->accountName
. ($this->usePathStyleUri ? ('/' . $this->accountName) : '')
. ($this->usePathStyleUri ? substr($path, strpos($path, '/')) : $path)
. ($queryString ?: '');
/**
* Create the string to sign. It consists of the following:
* VERB + "\n" +
* Content-Encoding + "\n" +
* Content-Language + "\n" +
* Content-Length + "\n" +
* Content-MD5 + "\n" +
* Content-Type + "\n" +
* Date + "\n" +
* If-Modified-Since + "\n" +
* If-Match + "\n" +
* If-None-Match + "\n" +
* If-Unmodified-Since + "\n" +
* Range + "\n" +
* CanonicalizedHeaders +
* CanonicalizedResource
*
* @see https://docs.microsoft.com/en-us/rest/api/storageservices/authorize-with-shared-key#specifying-the-authorization-header
*/
$stringToSign = implode(
"\n", array_filter([
strtoupper($httpVerb), // VERB
$this->extractHeader($headers, 'Content-Encoding', '') ?: '',
$this->extractHeader($headers, 'Content-Language', '') ?: '',
intval($this->extractHeader($headers, 'Content-Length', 0)) ?: '',
$this->extractHeader($headers, 'Content-MD5', '') ?: '',
$this->extractHeader($headers, 'Content-Type', '') ?: '',
$this->extractHeader($headers, 'Date', '') ?: '',
$this->extractHeader($headers, 'If-Modified-Since', '') ?: '',
$this->extractHeader($headers, 'If-Match', '') ?: '',
$this->extractHeader($headers, 'If-None-Match', '') ?: '',
$this->extractHeader($headers, 'If-Unmodified-Since', '') ?: '',
$this->extractHeader($headers, 'Range', '') ?: '',
count($canonicalizedHeaders) ? implode("\n", $canonicalizedHeaders) : null,
$canonicalizedResource,
], function ($x) {
return $x !== null;
})
);
//echo "\n/**/" . $stringToSign . "/**/\n";
$signString = base64_encode(hash_hmac('sha256', $stringToSign, $this->accountKey, true));
// Sign request
$headers['x-ms-date'] = $requestDate;
$headers['Authorization'] = 'SharedKey ' . $this->accountName . ':' . $signString;
// Return headers
return $headers;
}
/**
* Am I supposed to use path style URIs?
*
* @return bool
* @since 9.2.1
*/
public function isUsePathStyleUri(): bool
{
return $this->usePathStyleUri;
}
/**
* Get the Microsoft Azure account name
*
* @return string
* @since 9.2.1
*/
public function getAccountName(): string
{
return $this->accountName;
}
/**
* Get the (decoded) account key
*
* @return string
*/
public function getAccountKey(): string
{
return $this->accountKey;
}
/**
* Prepare query string for signing
*
* @param string $value Original query string
*
* @return string Query string for signing
* @since 9.2.1
*/
private function prepareQueryStringForSigning($value): string
{
$value = substr($value, 0, 1) === '?' ? substr($value, 1) : $value;
parse_str($value, $variables);
$variables = array_map(function ($k, $v) {
if (!is_scalar($v))
{
return null;
}
return strtolower($k) . ':' . $v;
}, array_keys($variables), array_values($variables));
$variables = array_filter($variables, function ($x) {
return !empty($x);
});
if (empty($variables))
{
return '';
}
asort($variables);
return "\n" . (implode("\n", $variables));
}
/**
* Extract a header value, case-insensitive
*
* @param array $headers The dictionary of headers
* @param string $key The key to extract, case-insensitive
* @param string|null $default The default value to return if the key is missing
*
* @return string|null
* @since 9.2.1
*/
private function extractHeader(array $headers, string $key, ?string $default = null): ?string
{
static $convertedHeaders = [];
if (self::md5(serialize($convertedHeaders)) != self::md5(serialize($headers)))
{
$convertedHeaders = array_combine(
array_map('strtolower', array_keys($headers)),
array_values($headers)
);
}
return $convertedHeaders[strtolower($key)] ?? $default;
}
}PK \ ?v ] vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/UnexpectedHTTPStatus.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class UnexpectedHTTPStatus extends ApiException
{
public function __construct($errNo = "500", $code = 0, ?\Throwable $previous = null)
{
$message = "Unexpected HTTP status $errNo";
parent::__construct($message, (int) $errNo, $previous);
}
}PK \& & ] vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/InvalidContainerName.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class InvalidContainerName extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Container name does not adhere to container naming conventions. See https://docs.microsoft.com/en-us/rest/api/storageservices/Naming-and-Referencing-Containers--Blobs--and-Metadata for more information.';
parent::__construct($message, $code, $previous);
}
}PK \=ȀӴ V vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/TooManyBlocks.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class TooManyBlocks extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Too many BLOB blocks. Azure supports up to 50,000 committed blocks. Upload finalisation failed.';
parent::__construct($message, $code, $previous);
}
}PK \yPq Z vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/FileTooBigToChunk.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class FileTooBigToChunk extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'The file is too big to upload either directly or in blocks (chunked). Please use a smaller Part Size for Split Archives and retry taking a backup.';
parent::__construct($message, $code, $previous);
}
}PK \n n Z vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/LocalFileNotFound.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class LocalFileNotFound extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Local file not found.';
parent::__construct($message, $code, $previous);
}
}PK \-hw w X vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/NoContainerName.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class NoContainerName extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Container name is not specified.';
parent::__construct($message, $code, $previous);
}
}PK \RI Q vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/NoBlocks.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class NoBlocks extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Empty list of BLOB blocks to finalize. Upload finalisation failed.';
parent::__construct($message, $code, $previous);
}
}PK \t _ vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/ForwardSlashNotAllowed.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class ForwardSlashNotAllowed extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Blobs stored in the root container can not have a name containing a forward slash (/).';
parent::__construct($message, $code, $previous);
}
}PK \'r U vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/ApiException.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class ApiException extends \RuntimeException
{
}PK \ uB a vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/FileTooBigToSingleUpload.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class FileTooBigToSingleUpload extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'The file is too big to upload directly. Please use a smaller Part Size for Split Archives or uncheck the Disable Chunked Upload option and retry taking a backup.';
parent::__construct($message, $code, $previous);
}
}PK \nSx x X vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/NoLocalFileName.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class NoLocalFileName extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Local file name is not specified.';
parent::__construct($message, $code, $previous);
}
}PK \Yk8 8 ] vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/MaxBlockSizeExceeded.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class MaxBlockSizeExceeded extends ApiException
{
public function __construct(int $currentSize, int $maxSize, $code = 500, ?\Throwable $previous = null)
{
$currentMb = $currentSize / 1024 / 1024;
$maxMb = $maxSize / 1024 / 1024;
$message = sprintf('Cannot put a BLOB block larger than %0.0fMb. Current block size is %0.2f Mb', $maxMb, $currentMb);
parent::__construct($message, $code, $previous);
}
}PK \:r r O vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/NoData.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class NoData extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'No data provided for the BLOB block.';
parent::__construct($message, $code, $previous);
}
}PK \<m m S vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/NoBlobName.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\AzureModern\Exception;
defined('AKEEBAENGINE') || die();
class NoBlobName extends ApiException
{
public function __construct($code = 500, ?\Throwable $previous = null)
{
$message = 'Blob name is not specified.';
parent::__construct($message, $code, $previous);
}
}PK \Sʉ N vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ D vendor/akeeba/engine/engine/Postproc/Connector/AzureModern/.htaccessnu 7m
Order allow,deny
Deny from all
PK \0d K vendor/akeeba/engine/engine/Postproc/Connector/Sugarsync/Exception/Base.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Sugarsync\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
class Base extends Exception
{
}
PK \Sʉ L vendor/akeeba/engine/engine/Postproc/Connector/Sugarsync/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ B vendor/akeeba/engine/engine/Postproc/Connector/Sugarsync/.htaccessnu 7m
Order allow,deny
Deny from all
PK \p, @ vendor/akeeba/engine/engine/Postproc/Connector/Davclient/Xml.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Davclient;
defined('AKEEBAENGINE') || die();
use DOMDocument;
use DOMElement;
use DOMNode;
use Exception;
use InvalidArgumentException;
/**
* XML utilities for WebDAV
*
* @copyright Copyright (C) 2007-2016 fruux GmbH (https://fruux.com/).
* @author Evert Pot (http://evertpot.com/)
* @license http://code.google.com/p/sabredav/wiki/License Modified BSD License
*
* Modified by Akeeba Ltd for use in Akeeba Backup in accordance with the aforementioned
* license of the original source code. Original source code can be found at https://github.com/fruux/sabre-dav.
*/
class Xml
{
/**
* Returns the 'clark notation' for an element.
*
* For example, and element encoded as:
*
* will be returned as:
* {http://www.example.org}myelem
*
* This format is used throughout the SabreDAV sourcecode.
* Elements encoded with the urn:DAV namespace will
* be returned as if they were in the DAV: namespace. This is to avoid
* compatibility problems.
*
* This function will return null if a nodetype other than an Element is passed.
*
* @param DOMNode $dom
*
* @return string
*/
static function toClarkNotation(DOMNode $dom)
{
if ($dom->nodeType !== XML_ELEMENT_NODE)
{
return null;
}
// Mapping back to the real namespace, in case it was dav
if ($dom->namespaceURI == 'urn:DAV')
{
$ns = 'DAV:';
}
else
{
$ns = $dom->namespaceURI;
}
// Mapping to clark notation
return '{' . $ns . '}' . $dom->localName;
}
/**
* Parses a clark-notation string, and returns the namespace and element
* name components.
*
* If the string was invalid, it will throw an InvalidArgumentException.
*
* @param string $str
*
* @return array
* @throws InvalidArgumentException
*/
static function parseClarkNotation($str)
{
if (!preg_match('/^{([^}]*)}(.*)$/', $str, $matches))
{
throw new InvalidArgumentException('\'' . $str . '\' is not a valid clark-notation formatted string');
}
return [
$matches[1],
$matches[2],
];
}
/**
* This method takes an XML document (as string) and converts all instances of the
* DAV: namespace to urn:DAV
*
* This is unfortunately needed, because the DAV: namespace violates the xml namespaces
* spec, and causes the DOM to throw errors
*
* @param string $xmlDocument
*
* @return array|string|null
*/
static function convertDAVNamespace($xmlDocument)
{
// This is used to map the DAV: namespace to urn:DAV. This is needed, because the DAV:
// namespace is actually a violation of the XML namespaces specification, and will cause errors
return preg_replace("/xmlns(:[A-Za-z0-9_]*)?=(\"|\')DAV:(\\2)/", "xmlns\\1=\\2urn:DAV\\2", $xmlDocument);
}
/**
* This method provides a generic way to load a DOMDocument for WebDAV use.
*
* This method throws a Sabre\DAV\Exception\BadRequest exception for any xml errors.
* It does not preserve whitespace, and it converts the DAV: namespace to urn:DAV.
*
* @param string $xml
*
* @return DOMDocument
* @throws Exception
*
*/
static function loadDOMDocument($xml)
{
if (empty($xml))
{
throw new Exception('Empty XML document sent');
}
// The BitKinex client sends xml documents as UTF-16. PHP 5.3.1 (and presumably lower)
// does not support this, so we must intercept this and convert to UTF-8.
if (substr($xml, 0, 12) === "\x3c\x00\x3f\x00\x78\x00\x6d\x00\x6c\x00\x20\x00")
{
// Note: the preceeding byte sequence is "]*)encoding="UTF-16"([^>]*)>|u', '', $xml);
}
// Retaining old error setting
$oldErrorSetting = libxml_use_internal_errors(true);
// Clearing any previous errors
libxml_clear_errors();
$dom = new DOMDocument();
// We don't generally care about any whitespace
$dom->preserveWhiteSpace = false;
$dom->loadXML(self::convertDAVNamespace($xml), LIBXML_NOWARNING | LIBXML_NOERROR);
if ($error = libxml_get_last_error())
{
libxml_clear_errors();
throw new Exception('The request body had an invalid XML body. (message: ' . $error->message . ', errorcode: ' . $error->code . ', line: ' . $error->line . ')');
}
// Restoring old mechanism for error handling
if ($oldErrorSetting === false)
{
libxml_use_internal_errors(false);
}
return $dom;
}
/**
* Parses all WebDAV properties out of a DOM Element
*
* Generally WebDAV properties are enclosed in {DAV:}prop elements. This
* method helps by going through all these and pulling out the actual
* propertynames, making them array keys and making the property values,
* well.. the array values.
*
* If no value was given (self-closing element) null will be used as the
* value. This is used in for example PROPFIND requests.
*
* Complex values are supported through the propertyMap argument. The
* propertyMap should have the clark-notation properties as it's keys, and
* classnames as values.
*
* When any of these properties are found, the unserialize() method will be
* (statically) called. The result of this method is used as the value.
*
* @param DOMElement $parentNode
* @param array $propertyMap
*
* @return array
*/
static function parseProperties(DOMElement $parentNode, array $propertyMap = [])
{
$propList = [];
foreach ($parentNode->childNodes as $propNode)
{
if (self::toClarkNotation($propNode) !== '{DAV:}prop')
{
continue;
}
foreach ($propNode->childNodes as $propNodeData)
{
/* If there are no elements in here, we actually get 1 text node, this special case is dedicated to netdrive */
if ($propNodeData->nodeType != XML_ELEMENT_NODE)
{
continue;
}
$propertyName = self::toClarkNotation($propNodeData);
if (isset($propertyMap[$propertyName]))
{
$propList[$propertyName] = call_user_func([
$propertyMap[$propertyName], 'unserializeNode',
], $propNodeData);
}
else
{
$propList[$propertyName] = $propNodeData->textContent;
}
}
}
return $propList;
}
public static function unserializeNode(DOMElement $dom)
{
$value = [];
foreach ($dom->childNodes as $child)
{
$value[] = self::toClarkNotation($child);
}
return $value;
}
}
PK \Sʉ B vendor/akeeba/engine/engine/Postproc/Connector/Davclient/.htaccessnu 7m
Order allow,deny
Deny from all
PK \QgRY RY < vendor/akeeba/engine/engine/Postproc/Connector/Sugarsync.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Sugarsync\Exception\Base as SugarsyncException;
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use Akeeba\Engine\Util\Utf8;
use DOMDocument;
use DOMElement;
/**
* SugarSync PHP API class for Akeeba Engine
*
* @obsolete SugarSync discontinued its consumer file-sync service and its public REST API
* (https://api.sugarsync.com) is no longer generally available. This connector can therefore no longer be
* exercised against a live service, and no integration test exists for it (see GitHub issue #146). It is
* retained only for backward compatibility with the equally-obsolete Sugarsync post-processing engine; do
* not build new functionality on top of it.
*/
class Sugarsync
{
use FileCloseAware;
use ProxyAware;
/** @var string The URL to the SugarSync API endpoint */
private $apiURL = 'https://api.sugarsync.com';
private $userAgent = 'AkeebaEngine/7.0.0.dev';
/** @var string The developer's access key */
private $accessKey = '';
/** @var string The developer's private key */
private $privateKey = '';
/** @var string The user's email address */
private $userEmail = '';
/** @var string The user's password */
private $userPassword = '';
/** @var string The API access token */
private $accessToken = null;
/** @var string The ID of the authenticated SugarSync user */
private $userID = null;
/**
* Public constructor. Remember to pass a configuration array with the keys
* access, private, email and password. Read the code for more info.
*
* @param array $config The configuration array
*
* @throws SugarsyncException
*/
public function __construct($config = [])
{
// Fetch the configuration parameters
$this->accessKey = array_key_exists('access', $config) ? $config['access'] : '';
$this->privateKey = array_key_exists('private', $config) ? $config['private'] : '';
$this->userEmail = array_key_exists('email', $config) ? $config['email'] : '';
$this->userPassword = array_key_exists('password', $config) ? $config['password'] : '';
// Update the user agent with the version of the engine
$this->userAgent = 'AkeebaEngine/' . (defined('AKEEBABACKUP_VERSION') ? AKEEBABACKUP_VERSION : AKEEBA_VERSION);
}
/**
* Is this object connected (authenticated) to SugarSync yet?
*
* @return bool
*/
public function isConnected()
{
return !empty($this->accessToken) && !empty($this->userID);
}
/**
* (Re-)Connect to SugarSync
*
* @param array $config Optional override for configuration parameters
*
* @throws SugarsyncException
*/
public function connect($config = [])
{
// Apply configuration overrides
if (array_key_exists('access', $config))
{
$this->accessKey = $config['access'];
}
if (array_key_exists('private', $config))
{
$this->privateKey = $config['private'];
}
if (array_key_exists('email', $config))
{
$this->userEmail = $config['email'];
}
if (array_key_exists('password', $config))
{
$this->userPassword = $config['password'];
}
// Check that all configuration parameters are in place
if (empty($this->accessKey))
{
throw new SugarsyncException('You must set the developer access key');
}
if (empty($this->privateKey))
{
throw new SugarsyncException('You must set the developer private key');
}
if (empty($this->userEmail))
{
throw new SugarsyncException('You must set the user\'s email address');
}
if (empty($this->userPassword))
{
throw new SugarsyncException('You must set the user\'s password');
}
$xml = '' . "\n";
$xml .= '' . "\n";
$xml .= '' . Utf8::utf8_encode($this->userEmail) . '' . "\n";
$xml .= '' . Utf8::utf8_encode($this->userPassword) . '' . "\n";
$xml .= '' . Utf8::utf8_encode($this->accessKey) . '' . "\n";
$xml .= '' . Utf8::utf8_encode($this->privateKey) . '' . "\n";
$xml .= '';
$descriptor = [
'method' => 'authorization',
'verb' => 'POST',
'data' => $xml,
'auth' => false,
'return_headers' => true,
];
$this->accessToken = null;
$this->userID = null;
$ret = $this->apiCall($descriptor);
$result = $ret['result'];
// Extract the token
if (preg_match('/Location:(.*?)\r/i', $result, $m))
{
$this->accessToken = $m[1];
}
// Extract the user ID
$userStart = strpos($result, '') + 6;
$userEnd = strpos($result, '');
$userURL = substr($result, $userStart, $userEnd - $userStart);
$userParts = explode('/', $userURL);
$this->userID = array_pop($userParts);
}
/**
* Get a list of the top-level sync folders of the user's account
*
* @staticvar array|null $folders Caches the sync folders list
* @return array Sync folders as a display_name => internal_ID hash array
*/
public function getSyncFolders()
{
static $folders = null;
if (is_null($folders))
{
if (!$this->isConnected())
{
$this->connect();
}
$descriptor = [
'method' => 'user/' . $this->userID . '/folders/contents',
'verb' => 'GET',
];
$ret = $this->apiCall($descriptor);
$xml = $ret['result'];
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->loadXML($xml);
$collections = $dom->getElementsByTagName('collection');
$folders = [];
for ($i = 0; $i < $collections->length; $i++)
{
/** @var DOMElement $item */
$item = $collections->item($i);
$name = $item->getElementsByTagName('displayName')->item(0)->nodeValue;
$ref = $item->getElementsByTagName('ref')->item(0)->nodeValue;
$refParts = explode('/', $ref);
$id = array_pop($refParts);
$folders[$name] = $id;
}
unset($dom);
}
return $folders;
}
/**
* Creates a new folder and returns its ID
*
* @param string $container Container folder's ID or path
* @param string $newFoldername The display name of the new folder
*
* @return string The ID of the created folder
*
* @throws SugarsyncException
*/
public function createFolder($container, $newFoldername)
{
if (substr($container, 0, 4) != ':sc:')
{
$container = $this->resolveFolder($container);
}
$xml = '';
$xml .= '' . Utf8::utf8_encode($newFoldername) . '';
$descriptor = [
'method' => 'folder/' . $container,
'verb' => 'POST',
'data' => $xml,
'return_headers' => true,
];
$ret = $this->apiCall($descriptor);
$result = $ret['result'];
// Extract the URL
if (preg_match('/Location:(.*?)\r/i', $result, $m))
{
$url = $m[1];
}
else
{
$url = '/';
}
$urlParts = explode('/', $url);
return array_pop($urlParts);
}
/**
* Lists all subfolders of a folder
*
* @param string $container Folder ID or path to list
*
* @return array Hashed array, folder name => folder ID
*
* @throws SugarsyncException
*/
public function getFolders($container)
{
if (substr($container, 0, 4) != ':sc:')
{
$container = $this->resolveFolder($container);
}
$descriptor = [
'method' => 'folder/' . $container . '/contents?type=folder',
'verb' => 'GET',
];
$ret = $this->apiCall($descriptor);
$xml = $ret['result'];
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->loadXML($xml);
$collections = $dom->getElementsByTagName('collection');
$folders = [];
for ($i = 0; $i < $collections->length; $i++)
{
/** @var DOMElement $item */
$item = $collections->item($i);
$name = $item->getElementsByTagName('displayName')->item(0)->nodeValue;
$ref = $item->getElementsByTagName('ref')->item(0)->nodeValue;
$refParts = explode('/', $ref);
$xid = array_pop($refParts);
$folders[$name] = $xid;
}
unset($dom);
return $folders;
}
/**
* Lists all files of a folder
*
* @param string $container Folder ID or path to list
*
* @return array Hashed array, file name => file ID
*
* @throws SugarsyncException
*/
public function getFiles($container)
{
if (substr($container, 0, 4) != ':sc:')
{
$container = $this->resolveFolder($container);
}
$descriptor = [
'method' => 'folder/' . $container . '/contents?type=file',
'verb' => 'GET',
];
$ret = $this->apiCall($descriptor);
$xml = $ret['result'];
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->loadXML($xml);
$collections = $dom->getElementsByTagName('file');
$files = [];
for ($i = 0; $i < $collections->length; $i++)
{
/** @var DOMElement $item */
$item = $collections->item($i);
$name = $item->getElementsByTagName('displayName')->item(0)->nodeValue;
$ref = $item->getElementsByTagName('ref')->item(0)->nodeValue;
$refParts = explode('/', $ref);
$xid = array_pop($refParts);
$files[$name] = $xid;
}
unset($dom);
return $files;
}
/**
* Uploads a file, overwriting a file by the same name if one exists.
*
* @param string $container Folder ID, or path to the folder, or full path to the file
* @param string|null $fileName Name of the remote file, or null if a full path is provided in $container
* @param string $localFile Full path to the local file to upload
*
* @return boolean True on success
*
* @throws SugarsyncException
*/
public function uploadFile($container, $fileName = null, $localFile = null)
{
if (substr($container, 0, 4) != ':sc:')
{
if (empty($fileName))
{
$pathParts = explode('/', $container);
$fileName = array_pop($pathParts);
$container = implode('/', $pathParts);
}
$container = $this->resolveFolder($container, true);
}
// First check if the file already exists
$files = $this->getFiles($container);
if (!array_key_exists($fileName, $files))
{
$fileID = $this->createFile($container, $fileName);
}
else
{
$fileID = $files[$fileName];
}
$descriptor = [
'method' => 'file/' . $fileID . '/data',
'verb' => 'PUT',
'data' => $localFile,
];
$ret = $this->apiCall($descriptor);
return true;
}
/**
* Creates an (empty) file
*
* @param string $container Folder ID, or path to the folder, or full path to the file
* @param string|null $fileName Name of the remote file, or null if a full path is provided in $container
*
* @return string The file ID
*
* @throws SugarsyncException
*/
public function createFile($container, $fileName = null, $mimeType = 'application/octet-stream')
{
if (substr($container, 0, 4) != ':sc:')
{
if (empty($fileName))
{
$pathParts = explode('/', $container);
$fileName = array_pop($pathParts);
$container = implode('/', $pathParts);
}
$container = $this->resolveFolder($container, true);
}
// First check if the file already exists
$files = $this->getFiles($container);
if (array_key_exists($fileName, $files))
{
return $files[$fileName];
}
$xml = '';
$xml .= '';
$xml .= '' . Utf8::utf8_encode($fileName) . '';
$xml .= '' . $mimeType . '';
$xml .= '';
$descriptor = [
'method' => 'folder/' . $container,
'verb' => 'POST',
'data' => $xml,
'return_headers' => true,
];
$ret = $this->apiCall($descriptor);
$result = $ret['result'];
// Extract the URL
if (preg_match('/Location:(.*?)\r/i', $result, $m))
{
$url = $m[1];
}
else
{
$url = '/';
}
$urlParts = explode('/', $url);
return array_pop($urlParts);
}
/**
* Downloads a file
*
* @param string $container A folder ID, or a folder path or a full path to the file to download
* @param string|null $file Remote filename or null if $container is a full path
* @param string|null $localFile Full path to the local file to write the data. If null, the raw file data will
* be returned by this method.
*/
public function downloadFile($container, $file, $localFile = null)
{
if (substr($container, 0, 4) != ':sc:')
{
if (empty($file))
{
$pathParts = explode('/', $container);
$file = array_pop($pathParts);
$container = implode('/', $pathParts);
}
$container = $this->resolveFolder($container);
}
// First check if the file already exists
$files = $this->getFiles($container);
if (array_key_exists($file, $files))
{
$fileID = $files[$file];
}
else
{
throw new SugarsyncException("File not found");
}
$descriptor = [
'method' => 'file/' . $fileID . '/data',
'verb' => 'GET',
'data' => $localFile,
];
$ret = $this->apiCall($descriptor);
if (empty($localFile))
{
return $ret['result'];
}
}
public function deleteFile($container, $file = null)
{
if (substr($container, 0, 4) != ':sc:')
{
if (empty($file))
{
$pathParts = explode('/', $container);
$file = array_pop($pathParts);
$container = implode('/', $pathParts);
}
$container = $this->resolveFolder($container);
}
// First check if the file already exists
$files = $this->getFiles($container);
if (array_key_exists($file, $files))
{
$fileID = $files[$file];
}
else
{
throw new SugarsyncException("File not found");
}
$descriptor = [
'method' => 'file/' . $fileID,
'verb' => 'DELETE',
];
$ret = $this->apiCall($descriptor);
return true;
}
/**
* Resolves a folder path to a folder ID
*
* @staticvar array $mappedFolders Cache of folder names to folder IDs
*
* @param string $folder The path to the folder
* @param bool $createMissing Should I create any folders which do not exist along the way?
*
* @return string The folder ID
*/
protected function resolveFolder($folder, $createMissing = false)
{
static $mappedFolders = [];
if (!array_key_exists($folder, $mappedFolders))
{
// Break the folder into bits and pieces
$folderParts = explode('/', $folder);
// First, let's fetch a list of top-level sync folders
$syncFolders = $this->getSyncFolders();
// Is our top-level folder really a top-level folder?
if (!array_key_exists($folderParts[0], $syncFolders))
{
// Treason! The user did not use a top-level folder!
if (array_key_exists('Magic Briefcase', $syncFolders))
{
// OK, let's use the user's "Magic Briefcase"
array_unshift($folderParts, 'Magic Briefcase');
}
else
{
// This should normally never, ever be executed
$randomFolder = array_shift($syncFolders);
array_unshift($syncFolders, $randomFolder);
array_unshift($folderParts, 'Magic Briefcase');
}
}
// Get the ID of the top-level folder
$toplevelFolder = array_shift($folderParts);
$toplevelID = $syncFolders[$toplevelFolder];
$folderID = $this->folderReduce($folderParts, $toplevelID, $createMissing);
$mappedFolders[$folder] = $folderID;
}
return $mappedFolders[$folder];
}
/**
* Recursive internal function to reduce a stack of path parts to an ID.
* Used by resolveFolder().
*
* @param array $stack Stack of path parts to resolve
* @param string $id Folder ID relative to which I should resolve the stack
* @param bool $createMissing Should I create missing folders along the way
*
* @return string The folder ID to which the stack resolves
*
* @throws SugarsyncException
*/
protected function folderReduce($stack, $id, $createMissing = false)
{
// Is the path fully reduced?
if (empty($stack))
{
return $id;
}
// No? Get the next path fragment
$search = array_shift($stack);
// If the fragment is empty the path is, in fact, fully reduced.
if (empty($search))
{
return $id;
}
$descriptor = [
'method' => 'folder/' . $id . '/contents?type=folder',
'verb' => 'GET',
];
$ret = $this->apiCall($descriptor);
$xml = $ret['result'];
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->loadXML($xml);
$collections = $dom->getElementsByTagName('collection');
$folders = [];
for ($i = 0; $i < $collections->length; $i++)
{
/** @var DOMElement $item */
$item = $collections->item($i);
$name = $item->getElementsByTagName('displayName')->item(0)->nodeValue;
$ref = $item->getElementsByTagName('ref')->item(0)->nodeValue;
$refParts = explode('/', $ref);
$xid = array_pop($refParts);
$folders[$name] = $xid;
}
unset($dom);
if (array_key_exists($search, $folders))
{
// Folder found; recurse
return $this->folderReduce($stack, $folders[$search], $createMissing);
}
else
{
// The folder was not found
if ($createMissing)
{
$newId = $this->createFolder($id, $search);
return $this->folderReduce($stack, $newId, $createMissing);
}
else
{
throw new SugarsyncException("The requested folder could not be located in your SugarSync account");
}
}
}
/**
* Calls SugarSync's API and returns the results
*
* @param array $descriptor An array describing the API call you want to make
*
* @return array
* @throws SugarsyncException
*/
protected function apiCall($descriptor = [])
{
// Get data from descriptor
$suffix = array_key_exists('method', $descriptor) ? $descriptor['method'] : '';
$data = array_key_exists('data', $descriptor) ? $descriptor['data'] : '';
$verb = array_key_exists('verb', $descriptor) ? $descriptor['verb'] : 'GET';
$auth = array_key_exists('auth', $descriptor) ? $descriptor['auth'] : true;
$heads = array_key_exists('headers', $descriptor) ? $descriptor['headers'] : [];
$returnHeaders = array_key_exists('return_headers', $descriptor) ? $descriptor['return_headers'] : false;
$silenceErrors = array_key_exists('shutup', $descriptor) ? $descriptor['shutup'] : false;
// Make sure the HTTP verb is a supported one
if (!in_array($verb, ['GET', 'POST', 'PUT', 'DELETE']))
{
$verb = 'GET';
}
// Calculate the URL
$url = $this->apiURL . '/' . $suffix;
// Create the HTTP headers array
$headers = [
'Expect:',
];
$headers = array_merge($headers, $heads);
// Handle extra headers for authorised API calls
if ($auth && !$this->isConnected())
{
$this->connect();
}
if ($auth)
{
$headers[] = 'Authorization: ' . $this->accessToken;
}
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
curl_setopt($ch, CURLOPT_USERAGENT, $this->userAgent);
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
@curl_setopt($ch, CURLOPT_CAINFO, AKEEBA_CACERT_PEM);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$fp = null;
switch ($verb)
{
case 'POST':
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_POST, true);
$headers[] = 'Content-Type: application/xml; charset=UTF-8';
$headers[] = 'Content-Length: ' . strlen($data);
break;
case 'PUT':
if (is_file($data) && is_readable($data))
{
$headers[] = 'Content-Length: ' . filesize($data);
$fp = fopen($data, 'r');
curl_setopt($ch, CURLOPT_PUT, true);
curl_setopt($ch, CURLOPT_INFILE, $fp);
curl_setopt($ch, CURLOPT_INFILESIZE, filesize($data));
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
}
}
else
{
throw new SugarsyncException("$data is not readable; can not upload to SugarSync");
}
break;
case 'DELETE':
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
break;
case 'GET':
if (!empty($data))
{
$fp = fopen($data, 'w');
curl_setopt($ch, CURLOPT_FILE, $fp);
}
curl_setopt($ch, CURLOPT_POST, false);
break;
}
curl_setopt($ch, CURLINFO_HEADER_OUT, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
if ($returnHeaders)
{
curl_setopt($ch, CURLOPT_HEADER, true);
}
$result = curl_exec($ch);
$info = curl_getinfo($ch);
$errno = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
@curl_close($ch);
}
if (!is_null($fp))
{
$this->conditionalFileClose($fp);
}
if (!$silenceErrors && ($errno != 0))
{
throw new SugarsyncException("Network error [$errno]: $error");
}
$ret = [
'result' => $result,
'info' => $info,
'errno' => $errno,
'error' => $error,
];
$http_code = $info['http_code'];
if ($silenceErrors || (($http_code >= 200) && ($http_code <= 299)))
{
return $ret;
}
if ($http_code == 400)
{
throw new SugarsyncException("HTTP Error [$http_code]: Required information was not provided to SugarSync");
}
if ($http_code == 401)
{
throw new SugarsyncException("HTTP Error [$http_code]: The credentials were rejected by SugarSync. Check the Access Key ID, Private Access Key, Email and Password in your configuration.");
}
if ($http_code == 403)
{
throw new SugarsyncException("HTTP Error [$http_code]: Failed authentication.");
}
if ($http_code == 404)
{
throw new SugarsyncException("HTTP Error [$http_code]: Not found.");
}
throw new SugarsyncException("HTTP Error [$http_code]: Server Error; SugarSync's API service may be down or experiencing a technical problem");
}
}
PK \dA,a a ; vendor/akeeba/engine/engine/Postproc/Connector/OneDrive.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use Exception;
use RuntimeException;
/**
* OneDrive (consumer / personal) API connector.
*
* @deprecated Legacy consumer OneDrive (api.onedrive.com) connector. Superseded by the OneDriveBusiness connector
* using the modern Microsoft Graph API. Retained only for backwards compatibility.
*/
class OneDrive
{
use FileCloseAware;
use ProxyAware;
/**
* The URL of the helper script which is used to get fresh API tokens
*/
public const helperUrl = 'https://www.akeeba.com/oauth2/onedrive.php';
/**
* Size limit for single part uploads
*/
public const simpleUploadSizeLimit = 104857600;
/**
* Item property to set the name conflict behavior
*/
public const nameConflictBehavior = '@name.conflictBehavior';
/**
* Refresh the access token proactively when it is within this many seconds of expiring. OneDrive / Microsoft Graph
* access tokens are short-lived (typically one hour); refreshing a little before expiry prevents the token from
* lapsing in the middle of a long-running backup, which is the cause of intermittent, hard-to-reproduce
* upload/download failures.
*/
private const tokenExpirationThreshold = 300;
/**
* The access token for connecting to OneDrive
*
* @var string
*/
protected $accessToken = '';
/**
* The refresh token used to get a new access token for OneDrive
*
* @var string
*/
protected $refreshToken = '';
/**
* The root URL for the OneDrive API, ref http://onedrive.github.io/README.htm
*/
protected $rootUrl = 'https://api.onedrive.com/v1.0/';
/**
* Default cURL options
*
* @var array
*/
protected $defaultOptions = [
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => true,
CURLOPT_VERBOSE => false,
CURLOPT_HEADER => false,
CURLINFO_HEADER_OUT => false,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
];
/**
* Download ID to use with the helper URL
*
* @var string
*/
protected $dlid = '';
/**
* UNIX timestamp at which the current access token expires. 0 means "unknown" — e.g. a token supplied from saved
* configuration whose lifetime we have not learned yet. It is populated from the `expires_in` value OneDrive returns
* whenever the token is refreshed.
*
* @var int
*/
private $tokenExpiration = 0;
/**
* Public constructor
*
* @param string $accessToken The access token for accessing OneDrive
* @param string $refreshToken The refresh token for getting new access tokens for OneDrive
* @param string $dlid The akeeba.com Download ID, used whenever you try to refresh the token
*/
public function __construct($accessToken, $refreshToken, $dlid)
{
$this->accessToken = $accessToken;
$this->refreshToken = $refreshToken;
$this->dlid = $dlid;
}
/**
* Try to ping OneDrive, refresh the token if it's expired and return the refresh results.
*
* If no refresh was required 'needs_refresh' will be false.
*
* If refresh was required 'needs_refresh' will be true and the rest of the keys will be as returned by OneDrive.
*
* If the refresh failed you'll get a RuntimeException.
*
* @param bool $forceRefresh Set to true to forcibly refresh the tokens
*
* @return array
*
* @throws RuntimeException
*/
public function ping($forceRefresh = false)
{
// Initialization
$response = [
'needs_refresh' => false,
];
if (!$forceRefresh)
{
if (!empty($this->tokenExpiration))
{
// We know when the token expires: refresh PROACTIVELY once it is at — or within a safety margin of —
// expiry, so it cannot lapse mid-operation. This avoids the race where a "test" call succeeds but the
// token then expires moments later during the real request (the cause of intermittent failures).
$response['needs_refresh'] = (time() + self::tokenExpirationThreshold) >= $this->tokenExpiration;
}
else
{
// We do NOT know this token's expiry (e.g. it was supplied from saved configuration). Fall back to
// probing the API with it and refreshing only if that probe fails.
try
{
$this->getDriveInformation();
}
catch (RuntimeException $e)
{
$response['needs_refresh'] = true;
}
}
}
// If there is no need to refresh the tokens, return
if (!$response['needs_refresh'] && !$forceRefresh)
{
return $response;
}
$refreshResponse = $this->refreshToken();
return array_merge($response, $refreshResponse);
}
/**
* Return information about the default Drive in the account
*
* @return array See http://onedrive.github.io/resources/drive.htm
*/
public function getDriveInformation()
{
$relativeUrl = 'drive';
$result = $this->fetch('GET', $relativeUrl);
return $result;
}
/**
* Get the raw listing of a folder
*
* @param string $path The relative path of the folder to list its contents
* @param string $searchString If set returns only items matching the search criteria
*
* @return array See http://onedrive.github.io/items/list.htm
*/
public function getRawContents($path, $searchString = null)
{
$relativeUrl = $this->normalizeDrivePath($path, 'children');
if ($searchString)
{
$relativeUrl = $this->normalizeDrivePath($path, 'view.search');
}
$relativeUrl .= '?orderby=name%20asc';
if ($searchString)
{
$relativeUrl .= '&q=' . urlencode($searchString);
}
$result = $this->fetch('GET', $relativeUrl);
return $result;
}
/**
* Get the processed listing of a folder
*
* @param string $path The relative path of the folder to list its contents
* @param string $searchString If set returns only items matching the search criteria
*
* @return array Two arrays under keys folders and files. Each array's key is the file/folder name, the value is
* number of children (folder) or size in bytes (file)
*/
public function listContents($path = '/', $searchString = null)
{
$result = $this->getRawContents($path, $searchString);
$return = [
'files' => [],
'folders' => [],
];
if (!isset($result['value']) || !count($result['value']))
{
return $return;
}
foreach ($result['value'] as $item)
{
if (isset($item['folder']) && isset($item['folder']['childCount']))
{
$return['folders'][$item['name']] = $item['folder']['childCount'];
continue;
}
$return['files'][$item['name']] = $item['size'];
}
return $return;
}
/**
* Delete a file
*
* @param string $path The relative path to the file to delete
* @param bool $failOnError Throw exception if the deletion fails? Default true.
*
* @return bool True on success
*
* @throws Exception
*/
public function delete($path, $failOnError = true)
{
$relativeUrl = $this->normalizeDrivePath($path);
try
{
$result = $this->fetch('DELETE', $relativeUrl, ['expect-status' => '204']);
}
catch (Exception $e)
{
if (!$failOnError)
{
return false;
}
throw $e;
}
return true;
}
/**
* Download a remote file
*
* @param string $path The path of the file in OneDrive
* @param string $localFile The absolute filesystem path where the file will be downloaded to
*/
public function download($path, $localFile)
{
$relativeUrl = $this->normalizeDrivePath($path, 'content');
$this->fetch('GET', $relativeUrl, [
'file' => $localFile,
]);
}
/**
* Get a signed download URL for the remote file with the specified relative path to Drive's root
*
* @param string $path Relative path to Drive's root
* @param bool $retry Should I try to refresh the token and retry getting a URL if getting the URL fails?
*
* @return string Signed URL to download the file's contents
*/
public function getSignedUrl($path, $retry = true)
{
$relativeUrl = $this->normalizeDrivePath($path, 'content');
$additional = [
'curl-options' => [
CURLOPT_HEADER => 1,
],
'no-parse' => true,
'follow-redirect' => false,
];
$response = $this->fetch('GET', $relativeUrl, $additional);
$lines = explode("\r\n", $response);
foreach ($lines as $line)
{
if (stripos($line, 'Location: ') === 0)
{
[$header, $location] = explode(': ', $line, 2);
return $location . '?access_token=' . $this->accessToken;
}
}
// Hm, we seem to have failed. This probably means that we need to refresh the tokens. Should I?
if ($retry)
{
$this->refreshToken();
return $this->getSignedUrl($path, false);
}
throw new RuntimeException('Could not get the download URL', 500);
}
/**
* Uploads a file of up to 100Mb in size.
*
* @param string $path The remote path relative to Drive root
* @param string $localFile The absolute local filesystem path
*
* @return array See http://onedrive.github.io/items/upload_put.htm
*/
public function simpleUpload($path, $localFile)
{
// Make sure this file is 100Mb or smaller
clearstatcache();
$filesize = @filesize($localFile);
if ($filesize > static::simpleUploadSizeLimit)
{
throw new RuntimeException(sprintf("File size too big for simpleUpload (%s bigger than %u bytes).", $filesize, static::simpleUploadSizeLimit), 500);
}
// Get the relative URL
$relativeUrl = $this->normalizeDrivePath($path, 'content') . '?' . urlencode(static::nameConflictBehavior) . '=replace';
$additional = [
'file' => $localFile,
'headers' => [
'Content-Type: application/octet-stream',
],
];
$response = $this->fetch('PUT', $relativeUrl, $additional);
return $response;
}
/**
* Creates a new multipart upload session and returns its upload URL
*
* @param string $path Relative path in the Drive
*
* @return string The upload URL for the session
*/
public function createUploadSession($path)
{
$relativeUrl = $this->normalizeDrivePath($path, 'upload.createSession');
$explicitPost = (object) [
'item' => [
static::nameConflictBehavior => 'replace',
'name' => basename($path),
],
];
$explicitPost = json_encode($explicitPost);
$info = $this->fetch('POST', $relativeUrl, [
'headers' => [
'Content-Type: application/json',
],
], $explicitPost);
return $info['uploadUrl'];
}
/**
* Destroy an already started upload session
*
* @param string $url The URL of the upload session
*
* @return void
*/
public function destroyUploadSession($url)
{
$this->fetch('DELETE', $url, [
'expect-status' => 204,
]);
}
/**
* Upload a part
*
* @param string $sessionUrl The upload session URL, see createUploadSession
* @param string $localFile Absolute filesystem path of the source file
* @param int $from Starting byte to begin uploading, default is 0 (start of file)
* @param int $length Chunk size in bytes, default 10Mb, must NOT be over 60Mb! MUST be a multiple of
* 320Kb.
*
* @return array The upload information, see http://onedrive.github.io/items/upload_large_files.htm
*/
public function uploadPart($sessionUrl, $localFile, $from = 0, $length = 10485760)
{
clearstatcache();
$totalSize = filesize($localFile);
$to = $from + $length - 1;
if ($to > ($totalSize - 1))
{
$to = $totalSize - 1;
}
$contentLength = $to - $from + 1;
$range = "$from-$to/$totalSize";
$additional = [
'headers' => [
'Content-Length: ' . $contentLength,
'Content-Range: bytes ' . $range,
],
];
$fp = @fopen($localFile, 'r');
if ($fp === false)
{
throw new RuntimeException("Could not open $localFile for reading", 500);
}
fseek($fp, $from);
$data = fread($fp, $contentLength);
$this->conditionalFileClose($fp);
return $this->fetch('PUT', $sessionUrl, $additional, $data);
}
/**
* Upload a file using multipart uploads. Useful for large files.
*
* @param string $path Relative path in the Drive
* @param string $localFile Absolute filesystem path of the source file
* @param int $partSize Part size in bytes, default 10Mb, must NOT be over 60Mb! MUST be a multiple of
* 320Kb.
*
* @return array See http://onedrive.github.io/items/upload_large_files.htm
*/
public function resumableUpload($path, $localFile, $partSize = 10485760)
{
$sessionUrl = $this->createUploadSession($path);
$from = 0;
while (true)
{
try
{
$result = $this->uploadPart($sessionUrl, $localFile, $from, $partSize);
}
catch (RuntimeException $e)
{
try
{
$this->destroyUploadSession($sessionUrl);
}
catch (RuntimeException $ex)
{
}
throw $e;
}
$from += $partSize;
// If the result doesn't have nextExpectedRanges we have finished uploading.
if (isset($result['name']))
{
return $result;
}
}
}
/**
* Automatically decides which upload method to use to upload a file to OneDrive. This method will return when the
* entire file has been uploaded. If you want to implement staggered uploads use the createUploadSession and
* uploadPart methods.
*
* @param string $path The remote path relative to Drive root
* @param string $localFile The absolute local filesystem path
*
* @return array See http://onedrive.github.io/items/upload_put.htm
*/
public function upload($path, $localFile)
{
clearstatcache();
$filesize = @filesize($localFile);
// Bigger than the single part upload limit: use resumable uploads with default size (10Mb) parts
if ($filesize > static::simpleUploadSizeLimit)
{
return $this->resumableUpload($path, $localFile);
}
// Smaller files, use simple upload
return $this->simpleUpload($path, $localFile);
}
/**
* Make a directory (including all of its parent directories) if the directory doesn't exist. If it already exists
* nothing happens. If it doesn't exist and cannot be created an exception is raised.
*
* @param string $path The path to create
*
* @throws Exception
*/
public function makeDirectory($path)
{
$path = trim($path, '/');
// Empty path means that it already exists (it's the Drive's root)
if (empty($path))
{
return;
}
// Get the parent path and the directory components of the path
$parentPath = '/';
$folder = $path;
if (strpos($path, '/') !== false)
{
$pathParts = explode('/', $path);
$folder = array_pop($pathParts);
$parentPath = implode('/', $pathParts);
}
// Try to list parent contents. If an error occurs, it means the folder doesn't exist
try
{
$this->listContents($parentPath, $folder);
}
catch (Exception $e)
{
// The parent folder doesn't exist. Create it!
$this->makeDirectory($parentPath);
}
// We have to create a new folder $folder in parent folder $parentPath.
$relativeUrl = $this->normalizeDrivePath($parentPath, 'children');
$request = (object) [
'name' => $folder,
'folder' => (object) [],
];
$requestJSON = json_encode($request);
// We always try to create the directory and handle the exception. We have to do that since OneDrive
// has a kind of cache: this means that if we create a directory and then try to list the parent folder
// it *may* be not listed. So the only workaround is to always try to create it
// and ignore "nameAlreadyExists" exceptions
try
{
$this->fetch('POST', $relativeUrl, [
'headers' => [
'Content-Type: application/json',
],
], $requestJSON);
}
// Seems OneDrive has no named exceptions, so I have to catch everything and re-throw it
catch (Exception $e)
{
// If it's not an "already exist" error, re-throw it
if (stripos($e->getMessage(), 'nameAlreadyExists') === false)
{
throw $e;
}
}
}
/**
* Refresh the access token.
*
* @return array|string The result coming from OneDrive
*/
public function refreshToken()
{
$refreshUrl = $this->getRefreshUrl();
$refreshResponse = $this->fetch('GET', $refreshUrl);
$this->refreshToken = $refreshResponse['refresh_token'] ?? $this->refreshToken;
$this->accessToken = $refreshResponse['access_token'] ?? $this->accessToken;
// Record when the freshly minted access token will expire so ping() can refresh it proactively next time.
if (isset($refreshResponse['expires_in']))
{
$this->tokenExpiration = time() + (int) $refreshResponse['expires_in'];
}
$refreshResponse['refresh_token'] = $this->refreshToken;
$refreshResponse['access_token'] = $this->accessToken;
$refreshResponse['token_expiration'] = $this->tokenExpiration;
return $refreshResponse;
}
/**
* Get the UNIX timestamp at which the current access token expires (0 if unknown).
*
* @return int
*/
public function getTokenExpiration()
{
return $this->tokenExpiration;
}
/**
* Restore a previously persisted access-token expiry timestamp, so ping() can refresh proactively without first
* having to probe the API. Pass 0 to mark the expiry as unknown.
*
* @param int $tokenExpiration UNIX timestamp at which the access token expires.
*
* @return void
*/
public function setTokenExpiration($tokenExpiration)
{
$this->tokenExpiration = (int) $tokenExpiration;
}
/**
* Execute an API call
*
* @param string $method The HTTP method
* @param string $relativeUrl The relative URL to ping
* @param array $additional Additional parameters
* @param mixed $explicitPost Passed explicitly to POST requests if set, otherwise $additional is passed.
*
* @return array|string
* @throws RuntimeException
*
*/
protected function fetch($method, $relativeUrl, array $additional = [], $explicitPost = null)
{
// Get full URL, if required
$url = $relativeUrl;
$useAuth = true;
if (substr($relativeUrl, 0, 6) != 'https:')
{
$url = $this->rootUrl . ltrim($relativeUrl, '/');
}
else
{
$useAuth = false;
}
// Should I expect a specific header?
$expectHttpStatus = false;
if (isset($additional['expect-status']))
{
$expectHttpStatus = $additional['expect-status'];
unset($additional['expect-status']);
}
// Am I told to not parse the result?
$noParse = false;
if (isset($additional['no-parse']))
{
$noParse = $additional['no-parse'];
unset ($additional['no-parse']);
}
// Am I told not to follow redirections?
$followRedirect = true;
if (isset($additional['follow-redirect']))
{
$followRedirect = $additional['follow-redirect'];
unset ($additional['follow-redirect']);
}
// Initialise and execute a cURL request
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
// Get the default options array
$options = $this->defaultOptions;
// Do I have explicit cURL options to add?
if (isset($additional['curl-options']) && is_array($additional['curl-options']))
{
// We can't use array_merge since we have integer keys and array_merge reassigns them :(
foreach ($additional['curl-options'] as $k => $v)
{
$options[$k] = $v;
}
}
// Set up custom headers
$headers = [];
if (isset($additional['headers']))
{
$headers = $additional['headers'];
unset ($additional['headers']);
}
// Add the authorization header
if ($useAuth)
{
$headers[] = 'Authorization: bearer ' . $this->accessToken;
}
$options[CURLOPT_HTTPHEADER] = $headers;
// Handle files
$file = null;
$fp = null;
if (isset($additional['file']))
{
$file = $additional['file'];
unset ($additional['file']);
}
if (!isset($additional['fp']) && !empty($file))
{
$mode = ($method == 'GET') ? 'w' : 'r';
$fp = @fopen($file, $mode);
}
elseif (isset($additional['fp']))
{
$fp = $additional['fp'];
unset($additional['fp']);
}
// Set up additional options
if ($method == 'GET' && $fp)
{
$options[CURLOPT_RETURNTRANSFER] = false;
$options[CURLOPT_HEADER] = false;
$options[CURLOPT_FILE] = $fp;
if (!$expectHttpStatus)
{
$expectHttpStatus = 200;
}
}
elseif ($method == 'POST')
{
$options[CURLOPT_POST] = true;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
elseif ($method == 'PUT' && $fp)
{
$options[CURLOPT_PUT] = true;
$options[CURLOPT_INFILE] = $fp;
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
$options[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
}
if ($file)
{
clearstatcache();
$options[CURLOPT_INFILESIZE] = @filesize($file);
}
else
{
$options[CURLOPT_INFILESIZE] = strlen(stream_get_contents($fp));
}
fseek($fp, 0);
}
else // Any other HTTP method, e.g. DELETE
{
$options[CURLOPT_CUSTOMREQUEST] = $method;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
// Set the cURL options at once
@curl_setopt_array($ch, $options);
// Set the follow location flag
if ($followRedirect)
{
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
}
// Execute and parse the response
$response = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
$lastHttpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
// Close open file pointers
if ($fp)
{
$this->conditionalFileClose($fp);
if ($expectHttpStatus && ($expectHttpStatus != $lastHttpCode))
{
if ($file)
{
@unlink($file);
}
throw new RuntimeException("Unexpected HTTP status $lastHttpCode", $lastHttpCode);
}
}
// Did we have a cURL error?
if ($errNo)
{
throw new RuntimeException("cURL error $errNo: $error", 500);
}
if ($expectHttpStatus)
{
if ($expectHttpStatus == $lastHttpCode)
{
return [];
}
}
if ($noParse)
{
return $response;
}
// Parse the response
$response = json_decode($response, true);
// Did we get invalid JSON data?
if (!$response)
{
throw new RuntimeException("Invalid JSON data received", 500);
}
// Did we get an error response?
if (isset($response['error']) && is_array($response['error']))
{
$error = $response['error']['code'];
$errorDescription = $response['error']['message'] ?? 'No error description provided';
throw new RuntimeException("Error $error: $errorDescription", 500);
}
// Did we get an error response (from the helper script)?
if (isset($response['error']))
{
$error = $response['error'];
$errorDescription = $response['error_description'] ?? 'No error description provided';
throw new RuntimeException("Error $error: $errorDescription", 500);
}
return $response;
}
/**
* Normalize the path of a resource inside the Drive
*
* @param string $relativePath The relative path to the Drive's root
* @param string $collection The collection of the path you want to access or an action, e.g. 'children',
* 'content', 'action.copy' etc
*
* @return string
*/
protected function normalizeDrivePath($relativePath, $collection = '')
{
$relativePath = trim($relativePath, '/');
if (empty($relativePath))
{
$path = '/drive/root';
if ($collection)
{
$path .= '/' . $collection;
}
return $path;
}
$path = '/drive/root:/' . $relativePath;
if ($collection)
{
$path .= ':/' . $collection;
}
$path = str_replace(' ', '%20', $path);
return $path;
}
/**
* @return string
*/
protected function getRefreshUrl()
{
return static::helperUrl . '?refresh_token=' . urlencode($this->refreshToken) . '&dlid=' . urlencode($this->dlid);
}
}
PK \Ż;" ;" C vendor/akeeba/engine/engine/Postproc/Connector/OneDriveBusiness.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
class OneDriveBusiness extends OneDrive
{
/**
* The URL of the helper script which is used to get fresh API tokens
*/
public const helperUrl = 'https://www.akeeba.com/oauth2/onedrivebusiness.php';
/**
* Size limit for single part uploads.
*
* This is 4MB per https://docs.microsoft.com/en-us/graph/api/driveitem-put-content?view=graph-rest-1.0&tabs=http
*/
public const simpleUploadSizeLimit = 4194304;
/**
* Item property to set the name conflict behavior
*
* @see https://docs.microsoft.com/en-us/onedrive/developer/rest-api/concepts/direct-endpoint-differences?view=odsp-graph-online#instance-annotations
*/
public const nameConflictBehavior = '@microsoft.graph.conflictBehavior';
/**
* The root URL for the MS Graph API
*
* @see https://docs.microsoft.com/en-us/graph/api/resources/onedrive?view=graph-rest-1.0
*/
protected $rootUrl = 'https://graph.microsoft.com/v1.0/me/';
/**
* The Drive ID we are connecting to.
*
* @var string|null
* @since 9.2.2
*/
private $driveId;
private $refreshUrl = '';
public function __construct(?string $accessToken, ?string $refreshToken, ?string $dlid = null, ?string $driveId = null, $refreshUrl = '')
{
parent::__construct($accessToken, $refreshToken, $dlid);
$this->setDriveId($driveId);
$this->refreshUrl = $refreshUrl ?: self::helperUrl;
}
/**
* Get the raw listing of a folder
*
* @param string $path The relative path of the folder to list its contents
* @param string $searchString If set returns only items matching the search criteria
*
* @return array See http://onedrive.github.io/items/list.htm
*
* @see https://docs.microsoft.com/en-us/graph/api/driveitem-list-children?view=graph-rest-1.0&tabs=http
* @see https://docs.microsoft.com/en-us/graph/api/driveitem-search?view=graph-rest-1.0&tabs=http
*/
public function getRawContents($path, $searchString = null)
{
$collection = empty($searchString) ? 'children' : 'search';
$relativeUrl = $this->normalizeDrivePath($path, $collection);
/**
* Search for items?
*
* @see https://docs.microsoft.com/en-us/graph/api/driveitem-search?view=graph-rest-1.0&tabs=http
*/
if ($searchString)
{
$relativeUrl .= sprintf('(q=\'%s\')', urlencode($searchString));
}
$result = $this->fetch('GET', $relativeUrl);
return $result;
}
/**
* Creates a new multipart upload session and returns its upload URL
*
* @param string $path Relative path in the Drive
*
* @return string The upload URL for the session
*/
public function createUploadSession($path)
{
$relativeUrl = $this->normalizeDrivePath($path, 'createUploadSession');
$explicitPost = (object) [
'item' => [
static::nameConflictBehavior => 'replace',
'name' => basename($path),
],
];
$explicitPost = json_encode($explicitPost);
$info = $this->fetch('POST', $relativeUrl, [
'headers' => [
'Content-Type: application/json',
],
], $explicitPost);
return $info['uploadUrl'];
}
/**
* Get a signed (pre-authenticated) download URL for the remote file.
*
* Unlike the legacy consumer OneDrive API, the Microsoft Graph API does not expose a usable download URL through the
* redirect Location of the `/content` endpoint with an appended `access_token`: that produces a short-lived,
* download.aspx URL that breaks when query parameters are tacked on, returning an HTML error page instead of the
* file. Graph instead surfaces a fully pre-authenticated, time-limited URL as the `@microsoft.graph.downloadUrl`
* property of the item's metadata. We use that directly.
*
* @param string $path Relative path to the Drive's root
* @param bool $retry Should I refresh the token and retry once if the URL cannot be retrieved?
*
* @return string Pre-authenticated URL to download the file's contents
*
* @see https://docs.microsoft.com/en-us/graph/api/driveitem-get?view=graph-rest-1.0&tabs=http#download-a-file
*/
public function getSignedUrl($path, $retry = true)
{
$relativeUrl = $this->normalizeDrivePath($path);
$metadata = $this->fetch('GET', $relativeUrl);
$downloadUrl = $metadata['@microsoft.graph.downloadUrl'] ?? $metadata['@content.downloadUrl'] ?? null;
if (!empty($downloadUrl))
{
return $downloadUrl;
}
// We failed to get a download URL. This usually means the access token has expired. Refresh it and retry once.
if ($retry)
{
$this->refreshToken();
return $this->getSignedUrl($path, false);
}
throw new \RuntimeException('Could not get the download URL', 500);
}
/**
* Get a list of Drives accessible to this user's account.
*
* @return array String indexed array of Drive ID => User readable name.
*
* @since 9.2.2
*/
public function getDrives()
{
$relativeUrl = 'drives';
$result = $this->fetch('GET', $relativeUrl);
$translate = function ($string)
{
$translation = $string;
if (class_exists(\Joomla\CMS\Language\Text::class))
{
$translation = \Joomla\CMS\Language\Text::_($string);
}
if (class_exists(\Awf\Text\Text::class))
{
$translation = \Awf\Text\Text::_($string);
}
if ($translation === $string && substr($string, 0, 11) === 'COM_AKEEBA_')
{
$string = 'COM_AKEEBABACKUP_' . substr($string, 11);
}
if (class_exists(\Joomla\CMS\Language\Text::class))
{
$translation = \Joomla\CMS\Language\Text::_($string);
}
if (class_exists(\Awf\Text\Text::class))
{
$translation = \Awf\Text\Text::_($string);
}
return $translation;
};
if (empty($result) || !is_array($result) || !isset($result['value']) || !is_array($result['value']) || empty($result['value']))
{
return [
'' => 'Drive (OneDrive Personal)',
];
}
$keys = array_map(function ($driveArray) {
return $driveArray['id'] ?? '';
}, $result['value']);
$values = array_map(function ($driveArray) {
$description = $driveArray['description'] ?? 'Drive';
switch ($driveArray['driveType'] ?? 'personal')
{
case 'personal':
$type = 'OneDrive Personal';
break;
case 'business':
$type = 'OneDrive for Business';
break;
case 'documentLibrary':
$type = 'SharePoint';
break;
}
return sprintf('%s (%s)', $description, $type);
}, $result['value']);
return array_combine($keys, $values);
}
/**
* Set the effective Drive ID
*
* @param string|null $driveId
*
* @return void
*/
public function setDriveId(?string $driveId)
{
$this->driveId = $driveId;
$this->rootUrl = empty($this->driveId) ? 'https://graph.microsoft.com/v1.0/me/' : 'https://graph.microsoft.com/v1.0/';
}
protected function normalizeDrivePath($relativePath, $collection = '')
{
if (empty($this->driveId))
{
return parent::normalizeDrivePath($relativePath, $collection);
}
$relativePath = trim($relativePath, '/');
if (empty($relativePath))
{
$path = '/drives/' . $this->driveId . '/items/root';
if ($collection)
{
$path .= '/' . $collection;
}
return $path;
}
$path = '/drives/' . $this->driveId . '/items/root:/' . $relativePath;
if ($collection)
{
$path = sprintf("/drives/%s/root:/%s:/%s", $this->driveId, $relativePath, $collection);
}
$path = str_replace(' ', '%20', $path);
return $path;
}
protected function getRefreshUrl()
{
if (empty($this->refreshUrl))
{
throw new \RuntimeException('The OAuth2 Refresh URL is empty. Please check your backup profile\'s configuration.');
}
$refreshUrl = $this->refreshUrl .
(strpos($this->refreshUrl, '?') === false ? '?' : '&')
. 'refresh_token=' . urlencode($this->refreshToken);
if (strpos($refreshUrl, self::helperUrl) === 0)
{
$refreshUrl .= '&dlid=' . urlencode($this->dlid);
}
return $refreshUrl;
}
}
PK \Iei i @ vendor/akeeba/engine/engine/Postproc/Connector/GoogleStorage.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use Exception;
use RuntimeException;
class GoogleStorage
{
use FileCloseAware;
use ProxyAware;
/**
* The root URL for the Google Storage v1 JSON API
*
* Note: as of June 20th, 2019 the recommended API domain is storage.googleapis.com instead of www.googleapis.com.
* This is an optional change until June 20th, 2020, when the old endpoint is turned off.
*
* @see https://cloud.google.com/storage/docs/json_api/v1/
*/
public const rootUrl = 'https://storage.googleapis.com/storage/v1/';
/**
* The upload URL for the Google Storage v1 file storage API
*
* @see https://cloud.google.com/storage/docs/json_api/v1/how-tos/simple-upload
*/
public const uploadUrl = 'https://www.googleapis.com/upload/storage/v1/';
/**
* The URL of the OAuth2 token service
*/
public const tokenUrl = 'https://www.googleapis.com/oauth2/v4/token';
/**
* The access token for connecting to Google Storage
*
* @var string
*/
private $accessToken = '';
/**
* The PEM-encoded private key for the Google Cloud Service Account we are going to use. This is given to you by
* Google in a JSON file.
*
* @var string
*/
private $privateKey = '';
/**
* The Google Cloud Service Account (fake) email address. This is given to you by Google in a JSON file.
*
* @var string
*/
private $clientEmail = '';
/**
* When does the access token expire (in UNIX epoch)?
*
* @var int
*/
private $expires = 0;
/**
* A pre-calculated JWT assertion, used to make a request for an access token to Google's servers
*
* @var string
*/
private $jwtAssertion = '';
/**
* Default cURL options
*
* @var array
*/
private $defaultOptions = [
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => true,
CURLOPT_VERBOSE => false,
CURLOPT_HEADER => false,
CURLINFO_HEADER_OUT => false,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
];
/**
* Public constructor. Both parameters are given to you by Google in a JSON file.
*
* Instructions:
* Go to https://console.developers.google.com/permissions/serviceaccounts?pli=1
* Select the API Project where your Google Storage bucket is already located in.
* Click on Create Service Account
* Set the Service Account Name to Akeeba Backup Service Account
* Click on Role and select Storage > Storage Admin (do NOT select Storage Object Admin instead IT WILL NOT WORK!!!)
* Check the "Furnish a new private key" checkbox. The Key Type section appears. Make sure JSON is selected.
* Click on the CREATE link at the bottom right.
* Your server prompts you to download a file. Save it as googlestorage.json
* Open the googlestorage.json. client_email --> $serviceEmail, private_key --> $privateKeyPEM
*
* @param string $serviceEmail The Google Cloud Service Account (fake) email address.
* @param string $privateKeyPEM The Google Cloud Service Account private key in PEM format.
*/
public function __construct($serviceEmail, $privateKeyPEM)
{
$this->clientEmail = $serviceEmail;
$this->privateKey = $privateKeyPEM;
$this->accessToken = null;
$this->expires = time() - 1;
}
/**
* List all buckets under the user's account
*
* @param string $project_id A valid API project identifier
*
* @return array See https://cloud.google.com/storage/docs/json_api/v1/buckets/list
*/
public function listBuckets($project_id)
{
$relativeUrl = 'b?project=' . urlencode($project_id);
$result = $this->fetch('GET', $relativeUrl);
return $result;
}
/**
* Get the raw listing of a bucket (either root or a specific path)
*
* @param string $bucket The bucket containing the path
* @param string $path The relative path of the folder to list its contents
* @param int $maxResults Maximum number of results to return per page
* @param string $pageToken Page token returned by the API, for resuming listing paginated results
*
* @return array See http://onedrive.github.io/items/list.htm
*
* @see https://cloud.google.com/storage/docs/json_api/v1/objects/list
*/
public function getRawContents($bucket, $path = '/', $maxResults = 1000, $pageToken = null)
{
$relativeUrl = 'b/' . $bucket . '/o';
$path = $this->normalizePath($path);
// Normalize maxResults in the range 1-1000
$maxResults = max(1, $maxResults);
$maxResults = min($maxResults, 1000);
$relativeUrl .= '?orderby=name%20asc&delimiter=/&maxResults=' . $maxResults;
if (!empty($path))
{
$relativeUrl .= '&prefix=' . $this->normalizePath($path);
}
if (!empty($pageToken))
{
$relativeUrl .= '&pageToken=' . $pageToken;
}
$result = $this->fetch('GET', $relativeUrl);
return $result;
}
/**
* Get the processed listing of a folder. Goes through all the pages of the results.
*
* @param string $bucket The bucket containing the path to list
* @param string $path The relative path of the folder to list its contents
*
* @return array Two arrays under keys folders and files. Folders is a list of folders (prefixes). Files has the
* file name as key and size in bytes as value
*/
public function listContents($bucket, $path = '/')
{
$return = [
'files' => [],
'folders' => [],
];
$pageToken = null;
do
{
$result = $this->getRawContents($bucket, $path);
$pageToken = $result['nextPageToken'] ?? null;
if (isset($result['prefixes']))
{
$return['folders'] = $result['prefixes'];
}
if (!isset($result['items']) && !(is_array($result['items']) || $result['items'] instanceof \Countable ? count($result['items']) : 0))
{
return $return;
}
foreach ($result['items'] as $item)
{
/** @see https://cloud.google.com/storage/docs/json_api/v1/objects#resource */
$return['files'][$item['name']] = $item['size'];
}
} while (!is_null($pageToken));
return $return;
}
/**
* Delete a file
*
* @param string $bucket The bucket containing the path
* @param string $path The relative path to the file to delete
* @param bool $failOnError Throw exception if the deletion fails? Default true.
*
* @return bool True on success
*
* @throws Exception
*/
public function delete($bucket, $path, $failOnError = true)
{
$relativeUrl = 'b/' . $bucket . '/o/' . $this->normalizePath($path);
try
{
$result = $this->fetch('DELETE', $relativeUrl);
}
catch (Exception $e)
{
if (!$failOnError)
{
return false;
}
throw $e;
}
return true;
}
/**
* Download a remote file
*
* @param string $bucket The bucket containing the path
* @param string $path The path of the file in Google Storage
* @param string $localFile The absolute filesystem path where the file will be downloaded to
*/
public function download($bucket, $path, $localFile)
{
$relativeUrl = 'b/' . $bucket . '/o/' . $this->normalizePath($path) . '?alt=media';
$this->fetch('GET', $relativeUrl, [
'file' => $localFile,
]);
}
/**
* Uploads a file. You should only use it for files up to 5Mb.
*
* @param string $bucket The bucket containing the path
* @param string $path The path of the file in Google Storage
* @param string $localFile The absolute local filesystem path to upload from
* @param null|string $storageClass Storage Class. Leave null to use the bucket's default storage class.
*
* @return array See
*
* @see https://cloud.google.com/storage/docs/json_api/v1/how-tos/simple-upload
*/
public function simpleUpload($bucket, $path, $localFile, $storageClass = null)
{
// Get the file size
clearstatcache();
$filesize = @filesize($localFile);
// Normalize the storage class
$storageClass = $this->normalizeStorageClass($storageClass);
// Get the relative URL
$relativeUrl =
self::uploadUrl .
'b/' . $bucket . '/o?uploadType=media&name=' . $this->normalizePath($path);
if (!empty($storageClass))
{
$relativeUrl .= '&storageClass=' . urlencode($storageClass);
}
$additional = [
'file' => $localFile,
'headers' => [
'Content-Type: application/octet-stream',
'Content-Length: ' . $filesize,
],
'no-parse' => true,
];
$response = $this->fetch('POST', $relativeUrl, $additional);
return $response;
}
/**
* Creates a new resumable upload session and returns its upload URL
*
* @param string $bucket The bucket containing the path
* @param string $path The path of the file in Google Storage
* @param string $localFile The absolute local filesystem path to upload from
* @param null|string $storageClass Storage Class. Leave null to use the bucket's default storage class.
*
* @return string The upload URL for the session
*
* @see https://cloud.google.com/storage/docs/json_api/v1/how-tos/resumable-upload
*/
public function createUploadSession($bucket, $path, $localFile, $storageClass = null)
{
// Get the file size
clearstatcache();
$filesize = @filesize($localFile);
// Normalize the storage class
$storageClass = $this->normalizeStorageClass($storageClass);
// Get the relative URL
$relativeUrl =
self::uploadUrl .
'b/' . $bucket . '/o?uploadType=resumable';
/**
* IMPORTANT! Despite the Google API docs claiming that all paths need to have special characters URL-encoded,
* this is NOT the case for resumable uploads *even when POSTing the filename in a JSON payload*. You
* need to pass it raw to json_encode and let the JSON encoder escape it. This is completely against
* the documentation and completely different to literally every other API call!
*/
$payloadData = [
'name' => $path,
];
if (!empty($storageClass))
{
$payloadData['storageClass'] = $storageClass;
}
$json = json_encode($payloadData);
$response = $this->fetch('POST', $relativeUrl, [
'headers' => [
'Content-Type: application/json; charset=UTF-8',
'X-Upload-Content-Type: application/octet-stream',
'X-Upload-Content-Length: ' . (int) $filesize,
],
'curl-options' => [
CURLOPT_HEADER => 1,
],
'no-parse' => true,
'follow-redirect' => false,
], $json);
$lines = explode("\r\n", $response);
foreach ($lines as $line)
{
if (stripos($line, 'Location: ') === 0)
{
[$header, $location] = explode(': ', $line, 2);
return $location;
}
}
throw new RuntimeException('Could not start an upload session', 500);
}
/**
* Upload a part
*
* @param string $sessionUrl The upload session URL, see createUploadSession
* @param string $localFile Absolute filesystem path of the source file
* @param int $from Starting byte to begin uploading, default is 0 (start of file)
* @param int $length Chunk size in bytes, default 1MB.
*
* @return array Empty while the upload is incomplete, upload information when complete
*
* @see https://cloud.google.com/storage/docs/json_api/v1/how-tos/resumable-upload
*/
public function uploadPart($sessionUrl, $localFile, $from = 0, $length = 1048576)
{
clearstatcache();
$totalSize = filesize($localFile);
$to = $from + $length - 1;
if ($to > ($totalSize - 1))
{
$to = $totalSize - 1;
}
$contentLength = $to - $from + 1;
$range = "$from-$to/$totalSize";
$additional = [
'headers' => [
'Content-Length: ' . $contentLength,
'Content-Range: bytes ' . $range,
],
'expect-status' => [308, 200, 201],
];
$fp = @fopen($localFile, 'r');
if ($fp === false)
{
throw new RuntimeException("Could not open $localFile for reading", 500);
}
fseek($fp, $from);
$data = fread($fp, $contentLength);
$this->conditionalFileClose($fp);
return $this->fetch('PUT', $sessionUrl, $additional, $data);
}
/**
* Upload a file using multipart uploads. Useful for files over 100Mb and up to 2Gb.
*
* @param string $bucket The bucket containing the path
* @param string $path Relative path in the Drive
* @param string $localFile Absolute filesystem path of the source file
* @param int $partSize Part size in bytes, default 1MB.
*
* @return array File metadata
*/
public function resumableUpload($bucket, $path, $localFile, $partSize = 1048576)
{
$sessionUrl = $this->createUploadSession($bucket, $path, $localFile);
$from = 0;
while (true)
{
$result = $this->uploadPart($sessionUrl, $localFile, $from, $partSize);
$from += $partSize;
// If the result doesn't have nextExpectedRanges we have finished uploading.
if (isset($result['name']))
{
return $result;
}
}
return $result;
}
/**
* Automatically decides which upload method to use to upload a file to Google Storage. This method will return
* when the entire file has been uploaded. If you want to implement staggered uploads use the createUploadSession
* and uploadPart methods.
*
* @param string $bucket The bucket containing the path
* @param string $path The remote path relative to Drive root
* @param string $localFile The absolute local filesystem path
* @param int $partSize The part size for resumable upload. Default 1MB.
*
* @return array
*/
public function upload($bucket, $path, $localFile, $partSize = 1048576)
{
clearstatcache();
$filesize = @filesize($localFile);
// Bigger than 100Mb: use resumable uploads with default (10Mb) parts
if ($filesize > $partSize)
{
return $this->resumableUpload($bucket, $path, $localFile);
}
// Smaller files, use simple upload
return $this->simpleUpload($bucket, $path, $localFile);
}
/**
* Returns the service access token.
*
* If there is no access token, or if it has expired, we are fetching a new one.
*
* @return null|string
*/
protected function getToken()
{
// Less than a minute before the token expires? Expire it immediately.
if ($this->expires < (time() - 60))
{
$this->accessToken = '';
}
if (empty($this->accessToken))
{
$explicitPost = 'grant_type=' . urlencode('urn:ietf:params:oauth:grant-type:jwt-bearer') .
'&assertion=' . $this->getJWTAssertion($this->clientEmail, $this->privateKey);
$result = $this->fetch('POST', self::tokenUrl, [
'authenticated_request' => false,
'headers' => [
'Content-Type: application/x-www-form-urlencoded',
],
], $explicitPost);
if (!is_array($result) || empty($result) || !isset($result['access_token']) || !isset($result['expires_in']))
{
throw new RuntimeException("Cannot get access token from Google Cloud: invalid response", 500);
}
$this->accessToken = $result['access_token'];
$this->expires = time() + (int) $result['expires_in'];
}
return $this->accessToken;
}
/**
* Execute an API call
*
* @param string $method The HTTP method
* @param string $relativeUrl The relative URL to ping
* @param array $additional Additional parameters
* @param mixed $explicitPost Passed explicitly to POST requests if set, otherwise $additional is passed.
*
* @return array
* @throws RuntimeException
*
*/
protected function fetch($method, $relativeUrl, array $additional = [], $explicitPost = null)
{
// Get full URL, if required
$url = $relativeUrl;
if (substr($relativeUrl, 0, 6) != 'https:')
{
$url = self::rootUrl . ltrim($relativeUrl, '/');
}
// Should I expect a specific header?
$expectHttpStatus = false;
if (isset($additional['expect-status']))
{
$expectHttpStatus = $additional['expect-status'];
unset($additional['expect-status']);
}
// Am I told to not parse the result?
$noParse = false;
if (isset($additional['no-parse']))
{
$noParse = $additional['no-parse'];
unset ($additional['no-parse']);
}
// Am I told not to follow redirections?
$followRedirect = true;
if (isset($additional['follow-redirect']))
{
$followRedirect = $additional['follow-redirect'];
unset ($additional['follow-redirect']);
}
// Initialise and execute a cURL request
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
// Get the default options array
$options = $this->defaultOptions;
// Do I have explicit cURL options to add?
if (isset($additional['curl-options']) && is_array($additional['curl-options']))
{
// We can't use array_merge since we have integer keys and array_merge reassigns them :(
foreach ($additional['curl-options'] as $k => $v)
{
$options[$k] = $v;
}
}
// Set up custom headers
$headers = [];
if (isset($additional['headers']))
{
$headers = $additional['headers'];
unset ($additional['headers']);
}
// Add the authorization header
$authenticated = true;
if (isset($additional['authenticated_request']))
{
$authenticated = $additional['authenticated_request'];
unset($additional['authenticated_request']);
}
if ($authenticated)
{
$headers[] = 'Authorization: Bearer ' . $this->getToken();
}
$options[CURLOPT_HTTPHEADER] = $headers;
// Handle files
$file = null;
$fp = null;
if (isset($additional['file']))
{
$file = $additional['file'];
unset ($additional['file']);
}
if (!isset($additional['fp']) && !empty($file))
{
$mode = ($method == 'GET') ? 'w' : 'r';
$fp = @fopen($file, $mode);
}
elseif (isset($additional['fp']))
{
$fp = $additional['fp'];
unset($additional['fp']);
}
// Set up additional options
if ($method == 'GET' && $fp)
{
$options[CURLOPT_RETURNTRANSFER] = false;
$options[CURLOPT_HEADER] = false;
$options[CURLOPT_FILE] = $fp;
if (!$expectHttpStatus)
{
$expectHttpStatus = 200;
}
}
elseif ($method == 'POST' && $fp)
{
$options[CURLOPT_POST] = true;
$options[CURLOPT_INFILE] = $fp;
if ($file)
{
clearstatcache();
$options[CURLOPT_INFILESIZE] = @filesize($file);
}
else
{
$options[CURLOPT_INFILESIZE] = strlen(stream_get_contents($fp));
}
fseek($fp, 0);
}
elseif ($method == 'POST')
{
$options[CURLOPT_POST] = true;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
elseif ($method == 'PUT' && $fp)
{
$options[CURLOPT_PUT] = true;
$options[CURLOPT_INFILE] = $fp;
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
$options[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
}
if ($file)
{
clearstatcache();
$options[CURLOPT_INFILESIZE] = @filesize($file);
}
else
{
$options[CURLOPT_INFILESIZE] = strlen(stream_get_contents($fp));
}
fseek($fp, 0);
}
else // Any other HTTP method, e.g. DELETE
{
$options[CURLOPT_CUSTOMREQUEST] = $method;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
// Set the cURL options at once
@curl_setopt_array($ch, $options);
// Set the follow location flag
if ($followRedirect)
{
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
}
// Execute and parse the response
$response = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
$lastHttpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
// Close open file pointers
if ($fp)
{
$this->conditionalFileClose($fp);
if (!empty($expectHttpStatus))
{
if (is_array($expectHttpStatus))
{
$correctStatus = in_array($lastHttpCode, $expectHttpStatus);
}
else
{
$correctStatus = $expectHttpStatus == $lastHttpCode;
}
if (!$correctStatus)
{
if ($file)
{
@unlink($file);
}
throw new RuntimeException("Unexpected HTTP status $lastHttpCode", $lastHttpCode);
}
}
}
// Did we have a cURL error?
if ($errNo)
{
throw new RuntimeException("cURL error $errNo: $error", 500);
}
if ($expectHttpStatus)
{
if ($expectHttpStatus == $lastHttpCode)
{
return [];
}
}
if ($noParse)
{
return $response;
}
if (empty($response))
{
return [];
}
// Parse the response
$response = json_decode($response, true);
// Did we get invalid JSON data?
if (!$response)
{
throw new RuntimeException("Invalid JSON data received from Google Storage (something is broken on Google's side).", 500);
}
// Did we get an error response?
if (isset($response['error']) && is_array($response['error']))
{
$error = $response['error']['code'];
$errorDescription = $response['error']['message'] ?? 'No error description provided';
throw new RuntimeException("Error $error: $errorDescription", 500);
}
// Did we get an error response (from the helper script)?
if (isset($response['error']))
{
$error = $response['error'];
$errorDescription = $response['error_description'] ?? 'No error description provided';
throw new RuntimeException("Error $error: $errorDescription", 500);
}
return $response;
}
/**
* Removes leading and trailing forward slashes, then encodes the file path per the JSON API requirements,
*
* @param string $path
*
* @return string
*
* @see https://cloud.google.com/storage/docs/json_api/
*/
protected function normalizePath($path)
{
$path = trim($path, '/');
// No path? Nothing to escape.
if (empty($path))
{
return $path;
}
// Can we cheat?
if (urlencode($path) == $path)
{
return $path;
}
$safeChars = [
'-', '.', '_', '~', '!', '$', '&', '\'', '(', ')', '*', '+', ',', ';', '=', ':', '@',
'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't',
'u', 'v', 'w', 'x', 'y', 'z',
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T',
'U', 'V', 'W', 'X', 'Y', 'Z',
];
$ret = '';
$chars = str_split($path);
foreach ($chars as $char)
{
if (in_array($chars, $safeChars))
{
$ret .= $char;
continue;
}
if ($char == ' ')
{
$ret .= '%20';
continue;
}
$ret .= urlencode($char);
}
return $ret;
}
/**
* Utility method to base sixty four encode data and then URL encode the result in a format that's compatible with
* Google Cloud.
*
* @param string $data The data to encode
*
* @return string
*/
private function bsfUrlEncode($data)
{
/**
* Working around hosts with broken malware scanners. Ironically, the best way for benign software like ours to
* do that is by following the same code obscuring techniques as legitimate malware. You know, of the kind that
* these hosts' malware scanners fail to catch.
*/
$funcName = substr('baseball', 0, 4);
$funcName .= (string) (4 * 4 * 4);
$funcName .= '_' . substr('length', 1, 2);
$funcName .= substr('barcode', -4);
$bsfEncData = call_user_func_array($funcName, [$data]);
return rtrim(strtr($bsfEncData, '+/', '-_'), '=');
}
/**
* Returns a pre-calculated JWT assertion which you need to retrieve an access token from Google. If the assertion
* does not exist it will be calculated.
*
* @param string $serviceAccountEmail The Google Cloud Service Account (fake) email address
* @param string $privateKey The Google Cloud Service Account private key in PEM format
*
* @return string The JWT assertion
*/
private function getJWTAssertion($serviceAccountEmail, $privateKey)
{
if (empty($this->jwtAssertion))
{
// Base Sixty Four Encoded JSON header
$jwtHeader = $this->bsfUrlEncode(json_encode([
"alg" => "RS256",
"typ" => "JWT",
]));
/**
* Base Sixty Four Encoded JSON claim set.
*
* If you need multiple scopes they must be SPACE-DELIMITED in the scope field below. Yes, SPACE, NOT COMMA.
* For valid scopes see https://developers.google.com/identity/protocols/googlescopes#storagev1
*/
$now = time();
$jwtClaim = $this->bsfUrlEncode(json_encode([
"iss" => $serviceAccountEmail,
"scope" => "https://www.googleapis.com/auth/devstorage.full_control",
"aud" => "https://www.googleapis.com/oauth2/v4/token",
"exp" => $now + 3600,
"iat" => $now,
]));
// The base string for the signature: {Encoded JSON header}.{Encoded JSON claim set}
openssl_sign(
$jwtHeader . "." . $jwtClaim,
$jwtSig,
$privateKey,
"sha256WithRSAEncryption"
);
$jwtSign = $this->bsfUrlEncode($jwtSig);
//{Base64url encoded JSON header}.{Base64url encoded JSON claim set}.{Base64url encoded signature}
$this->jwtAssertion = $jwtHeader . "." . $jwtClaim . "." . $jwtSign;
}
return $this->jwtAssertion;
}
/**
* Normalizes the name of a Google Storage storage class. If an unsupported class is provided it returns null.
*
* This is compatible with how the rest of this API implementation expects the storage class to be provided. If it's
* a string it's passed straight to the Google Storage JSON API. If it's null we do not pass a storage class,
* letting Google Storage use the storage class of the bucket.
*
* @param null|string $storageClass The Google Storage storage class to normalize.
*
* @return string|null
* @since 7.0.0.a1
*
* @see https://cloud.google.com/storage/docs/storage-classes#available_storage_classes
*/
private function normalizeStorageClass($storageClass)
{
if (empty($storageClass))
{
return null;
}
$storageClass = strtolower($storageClass);
if (in_array($storageClass, ['standard', 'nearline', 'coldline']))
{
return $storageClass;
}
return null;
}
}
PK \Rfڂ ڂ ; vendor/akeeba/engine/engine/Postproc/Connector/Dropbox2.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Dropbox2\Exception\APIError;
use Akeeba\Engine\Postproc\Connector\Dropbox2\Exception\cURLError;
use Akeeba\Engine\Postproc\Connector\Dropbox2\Exception\InvalidJSON;
use Akeeba\Engine\Postproc\Connector\Dropbox2\Exception\UnexpectedHTTPStatus;
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use Exception;
use RuntimeException;
/**
* Dropbox (API v2) post-processing engine for Akeeba Engine
*
* @package Akeeba\Engine\Postproc\Connector
*/
class Dropbox2
{
use FileCloseAware;
use ProxyAware;
/**
* The root URL for the Dropbox RPC API, ref https://www.dropbox.com/developers/documentation/http
*/
public const rootUrl = 'https://api.dropboxapi.com/2/';
/**
* The root URL for the Dropbox Content API, ref https://www.dropbox.com/developers/documentation/http
*/
public const contentRootUrl = 'https://content.dropboxapi.com/2/';
/**
* The URL of the helper script which is used to authenticate you with Dropbox
*/
public const helperUrl = 'https://www.akeeba.com/oauth2/dropbox2.php';
/**
* Refresh the access token proactively when it is within this many seconds of expiring. Dropbox access tokens are
* short-lived (typically 4 hours); refreshing a little before expiry prevents the token from lapsing in the middle
* of a long-running backup, which is the cause of intermittent, hard-to-reproduce upload/download failures.
*/
private const tokenExpirationThreshold = 300;
/**
* The refresh token used to get a new access token for OneDrive
*
* @var string
*/
protected $refreshToken = '';
/**
* The access token for connecting to Dropbox
*
* @var string
*/
private $accessToken = '';
/**
* Download ID to use with the helper URL
*
* @var string
*/
private $dlid = '';
/**
* Default cURL options
*
* @var array
*/
private $defaultOptions = [
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
CURLOPT_VERBOSE => false,
CURLOPT_HEADER => false,
CURLINFO_HEADER_OUT => false,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
];
private $namespaceId = '';
private $refreshUrl = '';
/**
* UNIX timestamp at which the current access token expires. 0 means "unknown" — e.g. a token supplied from saved
* configuration whose lifetime we have not learned yet. It is populated from the `expires_in` value Dropbox returns
* whenever the token is refreshed.
*
* @var int
*/
private $tokenExpiration = 0;
/**
* Public constructor
*
* @param string $accessToken The access token for accessing Dropbox
* @param string $dlid The akeeba.com Download ID, used whenever you try to refresh the token
*/
public function __construct($accessToken, $refreshToken, $dlid, $refreshUrl = '')
{
$this->accessToken = $accessToken;
$this->refreshToken = $refreshToken;
$this->dlid = $dlid;
$this->refreshUrl = $refreshUrl ?: self::helperUrl;
}
/**
* Return information about the current user's account
*
* @return array See https://www.dropbox.com/developers/documentation/http#documentation-users-get_current_account
*/
public function getCurrentAccount()
{
$relativeUrl = 'users/get_current_account';
$result = $this->fetch('POST', self::rootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/json; charset=utf-8',
],
], 'null');
return $result;
}
/**
* Get the raw listing of a folder
*
* @param string $path The relative path of the folder to list its contents
* @param bool $recursive Produce a recursive listing? [false]
* @param bool $includeMediaInfo Include media information in the metadata? [false]
*
* @return array See https://www.dropbox.com/developers/documentation/http#documentation-files-list_folder
*/
public function getRawContents($path = '/', $recursive = false, $includeMediaInfo = false)
{
$relativeUrl = 'files/list_folder';
$path = $this->normalizePath($path);
$params = [
'path' => $path,
'recursive' => $recursive ? true : false,
'include_media_info' => $includeMediaInfo ? true : false,
];
$paramsForPost = json_encode($params);
$result = $this->fetch('POST', self::rootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/json; charset=utf-8',
],
], $paramsForPost);
return $result;
}
/**
* Get the raw listing of a folder
*
* @param string $cursor The cursor recieved from getRawContents
*
* @return array See
* https://www.dropbox.com/developers/documentation/http#documentation-files-list_folder-continue
*/
public function getRawContentsContinue($cursor)
{
$relativeUrl = 'files/list_folder/continue';
$params = [
'cursor' => $cursor,
];
$paramsForPost = json_encode($params);
$result = $this->fetch('POST', self::rootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/json; charset=utf-8',
],
], $paramsForPost);
return $result;
}
/**
* Get the processed listing of a folder
*
* @param string $path The relative path of the folder to list its contents
*
* @return array Two arrays under keys folders and files. Each array's key is the file/folder name, the value is
* the Dropbox Folder ID (folder) or size in bytes (file)
*/
public function listContents($path = '/')
{
$result = [];
$rawContents = $this->getRawContents($path);
$result = $rawContents['entries'];
while ($rawContents['has_more'])
{
$cursor = $rawContents['cursor'];
$rawContents = $this->getRawContentsContinue($cursor);
$result = array_merge($result, $rawContents['entries']);
}
$return = [
'files' => [],
'folders' => [],
];
foreach ($result as $item)
{
if ($item['.tag'] == 'folder')
{
$return['folders'][$item['name']] = $item['id'];
continue;
}
$return['files'][$item['name']] = $item['size'];
}
return $return;
}
/**
* Return the metadata for a file or folder
*
* @param string $path The relative path of the file/folder to fetch the metadata for
* @param bool $includeMediaInfo Include media information in the metadata? [false]
*
* @return array See https://www.dropbox.com/developers/documentation/http#documentation-files-get_metadata
*/
public function getMetadata($path, $includeMediaInfo = false)
{
$relativeUrl = 'files/get_metadata';
$path = $this->normalizePath($path);
$params = [
'path' => $path,
'include_media_info' => $includeMediaInfo ? true : false,
];
$paramsForPost = json_encode($params);
$result = $this->fetch('POST', self::rootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/json; charset=utf-8',
],
], $paramsForPost);
return $result;
}
/**
* Delete a file. See https://www.dropbox.com/developers/documentation/http#documentation-files-delete
*
* @param string $path The relative path to the file to delete
* @param bool $failOnError Throw exception if the deletion fails? Default true.
*
* @return bool True on success
*
* @throws Exception
*/
public function delete($path, $failOnError = true)
{
$relativeUrl = 'files/delete_v2';
$path = $this->normalizePath($path);
$params = [
'path' => $path,
];
$paramsForPost = json_encode($params);
try
{
$result = $this->fetch('POST', self::rootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/json; charset=utf-8',
],
], $paramsForPost);
}
catch (Exception $e)
{
if (!$failOnError)
{
return false;
}
throw $e;
}
return true;
}
/**
* Download a remote file
*
* @param string $path The path of the file in Dropbox
* @param string $localFile The absolute filesystem path where the file will be downloaded to
*/
public function download($path, $localFile)
{
$relativeUrl = 'files/download';
$path = $this->normalizePath($path);
$params = [
'path' => $path,
];
$paramsForPost = json_encode($params);
$this->fetch('GET', self::contentRootUrl, $relativeUrl, [
'headers' => [
'Content-Type:', // WARNING: Content-Type MUST be empty!
'Dropbox-API-Arg: ' . $paramsForPost,
],
'file' => $localFile,
'file_mode' => 'wb',
]);
}
/**
* Get a shared download URL for the remote file with the specified path to Dropbox root. This kind of URL is
* suitable for sharing with third parties. It doesn't the (secret) authentication token.
*
* @param string $path Relative path to Dropbox root
*
* @return string Shared URL to download the file's contents
*
* @see https://www.dropbox.com/developers/documentation/http#documentation-sharing-create_shared_link
*/
public function getSharedUrl($path, $expires = null)
{
$relativeUrl = 'sharing/create_shared_link_with_settings';
$path = $this->normalizePath($path);
$settings = [
'requested_visibility' => 'public',
];
$params = [
'path' => $path,
'settings' => $settings,
];
$paramsForPost = json_encode($params);
$result = $this->fetch('POST', self::rootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/json; charset=utf-8',
],
], $paramsForPost);
return $result['url'];
}
/**
* Returns an fully qualified, authenticated URL from a relative URL. This URL is NOT meant for sharing! It contains
* the (secret) authentication token!
*
* @param string $path The URL to apply
*
* @return string
*/
public function getAuthenticatedUrl($path, $retry = true)
{
$path = $this->normalizePath($path);
// Use Dropbox's documented files/get_temporary_link endpoint. It returns a short-lived (~4 hour) direct-download
// URL that needs NO access token. This is robust and secure: unlike embedding the bearer token as a query
// parameter on the content endpoint (which Dropbox rejects intermittently once the token is near expiry, and
// which would leak the token into browser history, server logs and referrers), the temporary link keeps working
// for its whole lifetime regardless of what happens to the access token afterwards.
try
{
$result = $this->fetch('POST', self::rootUrl, 'files/get_temporary_link', [
'headers' => [
'Content-Type: application/json; charset=utf-8',
],
], json_encode(['path' => $path]));
}
catch (RuntimeException $e)
{
// The access token may have expired between minting and use. Refresh it and retry once.
if ($retry)
{
$this->refreshToken();
return $this->getAuthenticatedUrl($path, false);
}
throw $e;
}
if (empty($result['link']))
{
throw new RuntimeException('Could not obtain a temporary download link from Dropbox', 500);
}
return $result['link'];
}
/**
* Creates a new multipart upload session and returns its upload URL
*
* @return string The upload session ID
*
* @see https://www.dropbox.com/developers/documentation/http#documentation-files-upload_session-start
*/
public function createUploadSession()
{
$relativeUrl = 'files/upload_session/start';
$info = $this->fetch('POST', self::contentRootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/octet-stream',
],
]);
return $info['session_id'];
}
/**
* Finish an already started upload session and commits the file to a specific location in Dropbox
*
* @param string $sessionId The upload session ID
* @param string $path Relative path of the file in Dropbox
* @param int $offset The file size that's been already uploaded
* @param bool $mute If true, the Dropbox desktop/mobile app will NOT notify users of the uploaded file
*
* @return array See
* https://www.dropbox.com/developers/documentation/http#documentation-files-upload_session-finish
*/
public function finishUploadSession($sessionId, $path, $offset, $mute = false)
{
$relativeUrl = 'files/upload_session/finish';
$path = $this->normalizePath($path);
$params = [
'cursor' => [
'session_id' => $sessionId,
'offset' => $offset,
],
'commit' => [
'path' => $path,
'mode' => 'overwrite',
'autorename' => false,
'mute' => $mute ? true : false,
],
];
$paramsForPost = json_encode($params);
return $this->fetch('POST', self::contentRootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/octet-stream',
'Dropbox-API-Arg: ' . $paramsForPost,
],
]);
}
/**
* Upload a part
*
* @param string $sessionId The upload session URL, see createUploadSession
* @param string $localFile Absolute filesystem path of the source file
* @param int $from Starting byte to begin uploading, default is 0 (start of file)
* @param int $length Chunk size in bytes, default 10Mb, must NOT be over 60Mb! MUST be a multiple of
* 320Kb.
*
* @return void
*/
public function uploadPart($sessionId, $localFile, $from = 0, $length = 10485760)
{
$relativeUrl = 'files/upload_session/append_v2';
clearstatcache();
$totalSize = filesize($localFile);
$to = $from + $length - 1;
if ($to > ($totalSize - 1))
{
$to = $totalSize - 1;
}
$contentLength = $to - $from + 1;
if ($contentLength <= 0)
{
return;
}
$params = [
'cursor' => [
'session_id' => $sessionId,
'offset' => $from,
],
'close' => false,
];
$paramsForPost = json_encode($params);
$additional = [
'headers' => [
'Content-Type: application/octet-stream',
'Dropbox-API-Arg: ' . $paramsForPost,
],
'no-parse' => true,
];
$fp = @fopen($localFile, 'r');
if ($fp === false)
{
throw new RuntimeException("Could not open $localFile for reading", 500);
}
fseek($fp, $from);
$data = fread($fp, $contentLength);
$this->conditionalFileClose($fp);
$this->fetch('POST', self::contentRootUrl, $relativeUrl, $additional, $data);
}
/**
* Upload a file using multipart uploads. Useful for files over 100Mb and up to 2Gb.
*
* @param string $path Relative path in Dropbox
* @param string $localFile Absolute filesystem path of the source file
* @param int $partSize Part size in bytes, default 10Mb.
* @param bool $mute If true, the Dropbox desktop/mobile app will NOT notify users of the uploaded file
*
* @return array See
* https://www.dropbox.com/developers/documentation/http#documentation-files-upload_session-finish
*/
public function resumableUpload($path, $localFile, $partSize = 10485760, $mute = false)
{
clearstatcache();
$totalSize = filesize($localFile);
$sessionId = $this->createUploadSession();
$from = 0;
while (true)
{
$this->uploadPart($sessionId, $localFile, $from, $partSize);
$from += $partSize;
if ($from >= $totalSize)
{
break;
}
}
return $this->finishUploadSession($sessionId, $path, $totalSize, $mute);
}
/**
* Automatically decides which upload method to use to upload a file to Dropbox. This method will return when the
* entire file has been uploaded. If you want to implement staggered uploads use the createUploadSession and
* uploadPart methods.
*
* @param string $path The remote path relative to Dropbox root
* @param string $localFile The absolute local filesystem path
*
* @return array See
* https://www.dropbox.com/developers/documentation/http#documentation-files-upload_session-finish
*/
public function upload($path, $localFile)
{
clearstatcache();
$filesize = @filesize($localFile);
// Use resumable uploads with up to 1Mb parts
return $this->resumableUpload($path, $localFile, 1048576);
}
/**
* Make a directory (including all of its parent directories) if the directory doesn't exist. If it already exists
* nothing happens. If it doesn't exist and cannot be created an exception is raised.
*
* @param string $path The path to create
*
* @return array See https://www.dropbox.com/developers/documentation/http#documentation-files-create_folder
*/
public function makeDirectory($path)
{
$path = $this->normalizePath($path);
try
{
$ownMetaData = $this->getMetadata($path);
}
catch (Exception $e)
{
$ownMetaData = null;
}
// Empty path means that it already exists (it's the root)
if (empty($path))
{
return [$ownMetaData];
}
// Get the parent path and the directory components of the path
$parentPath = '/';
$folder = $path;
if (strpos($path, '/') !== false)
{
$pathParts = explode('/', $path);
$folder = array_pop($pathParts);
$parentPath = implode('/', $pathParts);
}
// Does this path exist in the parent path?
$mustCreate = false;
try
{
if (is_null($ownMetaData))
{
$parentMetaData = $this->getMetadata($parentPath);
}
}
catch (Exception $e)
{
// The parent folder doesn't exist. Create it!
$this->makeDirectory($parentPath);
}
if (!is_null($ownMetaData))
{
return $ownMetaData;
}
// We have to create a new folder $folder in parent folder $parentPath.
$relativeUrl = 'files/create_folder_v2';
$params = [
'path' => $path,
'autorename' => false,
];
$paramsForPost = json_encode($params);
return $this->fetch('POST', self::rootUrl, $relativeUrl, [
'headers' => [
'Content-Type: application/json',
],
], $paramsForPost);
}
/**
* Get the namespace ID.
*
* This is used for Dropbox for Business only.
*
* @see https://www.dropbox.com/developers/reference/namespace-guide
*
* @return string
*/
public function getNamespaceId()
{
return $this->namespaceId;
}
/**
* Set the namespace ID. Set to empty to use the user's personal space (default behavior).
*
* This is used for Dropbox for Business only.
*
* @param string $namespaceId The namespace ID. Get it with $this->getCurrentAccount
*
* @return void
* @see https://www.dropbox.com/developers/reference/namespace-guide
*
*/
public function setNamespaceId($namespaceId)
{
$this->namespaceId = $namespaceId;
}
/**
* Try to ping Dropbox, refresh the token if it's expired and return the refresh results.
*
* If no refresh was required 'needs_refresh' will be false.
*
* If refresh was required 'needs_refresh' will be true and the rest of the keys will be as returned by Dropbox.
*
* If the refresh failed you'll get a RuntimeException.
*
* @param bool $forceRefresh Set to true to forcibly refresh the tokens
*
* @return array
*
* @throws RuntimeException
*/
public function ping($forceRefresh = false)
{
// Initialization
$response = [
'needs_refresh' => false,
];
if (!$forceRefresh)
{
if (!empty($this->tokenExpiration))
{
// We know when the token expires: refresh PROACTIVELY once it is at — or within a safety margin of —
// expiry, so it cannot lapse mid-operation. This avoids the race where a "test" call succeeds but the
// token then expires moments later during the real request (the cause of intermittent failures).
$response['needs_refresh'] = (time() + self::tokenExpirationThreshold) >= $this->tokenExpiration;
}
else
{
// We do NOT know this token's expiry (e.g. it was supplied from saved configuration). Fall back to
// probing the API with it and refreshing only if that probe fails.
try
{
$this->getCurrentAccount();
}
catch (RuntimeException $e)
{
$response['needs_refresh'] = true;
}
}
}
// If there is no need to refresh the tokens, return
if (!$response['needs_refresh'] && !$forceRefresh)
{
return $response;
}
$refreshResponse = $this->refreshToken();
return array_merge($response, $refreshResponse);
}
/**
* Refresh the access token.
*
* @return array|string The result coming from OneDrive
*/
public function refreshToken()
{
$refreshUrl = $this->getRefreshUrl();
$refreshResponse = $this->fetch('GET', '', $refreshUrl);
$this->refreshToken = $refreshResponse['refresh_token'] ?? $this->refreshToken;
$this->accessToken = $refreshResponse['access_token'] ?? $this->accessToken;
// Record when the freshly minted access token will expire so ping() can refresh it proactively next time.
if (isset($refreshResponse['expires_in']))
{
$this->tokenExpiration = time() + (int) $refreshResponse['expires_in'];
}
$refreshResponse['refresh_token'] = $this->refreshToken;
$refreshResponse['access_token'] = $this->accessToken;
$refreshResponse['token_expiration'] = $this->tokenExpiration;
return $refreshResponse;
}
/**
* Get the UNIX timestamp at which the current access token expires (0 if unknown).
*
* @return int
*/
public function getTokenExpiration()
{
return $this->tokenExpiration;
}
/**
* Restore a previously persisted access-token expiry timestamp, so ping() can refresh proactively without first
* having to probe the API. Pass 0 to mark the expiry as unknown.
*
* @param int $tokenExpiration UNIX timestamp at which the access token expires.
*
* @return void
*/
public function setTokenExpiration($tokenExpiration)
{
$this->tokenExpiration = (int) $tokenExpiration;
}
/**
* Execute an API call
*
* @param string $method The HTTP method
* @param string $baseUrl The base URL. Use one of self::rootUrl or self::contentRootUrl
* @param string $relativeUrl The relative URL to ping
* @param array $additional Additional parameters
* @param mixed $explicitPost Passed explicitly to POST requests if set, otherwise $additional is passed.
*
* @return array
* @throws RuntimeException
*
*/
protected function fetch($method, $baseUrl, $relativeUrl, array $additional = [], $explicitPost = null)
{
// Get full URL, if required
$url = $relativeUrl;
if (substr($relativeUrl, 0, 6) != 'https:')
{
$url = $baseUrl . ltrim($relativeUrl, '/');
}
// Should I expect a specific header?
$expectHttpStatus = false;
if (isset($additional['expect-status']))
{
$expectHttpStatus = $additional['expect-status'];
unset($additional['expect-status']);
}
// Am I told to not parse the result?
$noParse = false;
if (isset($additional['no-parse']))
{
$noParse = $additional['no-parse'];
unset ($additional['no-parse']);
}
// Am I told not to follow redirections?
$followRedirect = true;
if (isset($additional['follow-redirect']))
{
$followRedirect = $additional['follow-redirect'];
unset ($additional['follow-redirect']);
}
// Initialise and execute a cURL request
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
// Get the default options array
$options = $this->defaultOptions;
// Try to use at least TLS 1.2. Requires cURL 7.34.0 or later.
if (defined('CURLOPT_SSLVERSION') && defined('CURL_SSLVERSION_TLSv1_2'))
{
$options[CURLOPT_SSLVERSION] = CURL_SSLVERSION_TLSv1_2;
}
// Do I have explicit cURL options to add?
if (isset($additional['curl-options']) && is_array($additional['curl-options']))
{
// We can't use array_merge since we have integer keys and array_merge reassigns them :(
foreach ($additional['curl-options'] as $k => $v)
{
$options[$k] = $v;
}
}
// Set up custom headers
$headers = [];
if (isset($additional['headers']))
{
$headers = $additional['headers'];
unset ($additional['headers']);
}
// Add the authorization header
$headers[] = 'Authorization: Bearer ' . $this->accessToken;
// Add the Dropbox-API-Path-Root header
$apiRootHeader = '{".tag": "home"}';
if (!empty($this->namespaceId))
{
$apiRootHeader = sprintf('{".tag": "namespace_id", "namespace_id": "%s"}', $this->namespaceId);
}
$headers[] = 'Dropbox-API-Path-Root: ' . $apiRootHeader;
// Apply the headers
$options[CURLOPT_HTTPHEADER] = $headers;
// Handle files
$file = null;
$fp = null;
$fileMode = null;
if (isset($additional['file']))
{
$file = $additional['file'];
unset ($additional['file']);
}
if (isset($additional['file_mode']))
{
$fileMode = $additional['file_mode'];
unset ($additional['file_mode']);
}
if (!isset($additional['fp']) && !empty($file))
{
if (is_null($fileMode))
{
$fileMode = ($method == 'GET') ? 'w' : 'r';
}
$fp = @fopen($file, $fileMode);
}
elseif (isset($additional['fp']))
{
$fp = $additional['fp'];
unset($additional['fp']);
}
// Set up additional options
if ($method == 'GET' && $fp)
{
$options[CURLOPT_RETURNTRANSFER] = false;
$options[CURLOPT_HEADER] = false;
$options[CURLOPT_FILE] = $fp;
if (!$expectHttpStatus)
{
$expectHttpStatus = 200;
}
}
elseif ($method == 'POST')
{
$options[CURLOPT_POST] = true;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
// This is required for some broken servers, e.g. SiteGround
else
{
$options[CURLOPT_POSTFIELDS] = '';
}
}
elseif ($method == 'PUT' && $fp)
{
$options[CURLOPT_PUT] = true;
$options[CURLOPT_INFILE] = $fp;
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
$options[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
}
if ($file)
{
clearstatcache();
$options[CURLOPT_INFILESIZE] = @filesize($file);
}
else
{
$options[CURLOPT_INFILESIZE] = strlen(stream_get_contents($fp));
}
fseek($fp, 0);
}
else // Any other HTTP method, e.g. DELETE
{
$options[CURLOPT_CUSTOMREQUEST] = $method;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
// Set the cURL options at once
@curl_setopt_array($ch, $options);
// Set the follow location flag
if ($followRedirect)
{
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
}
// Execute and parse the response
$response = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
$lastHttpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
// Close open file pointers
if ($fp)
{
$this->conditionalFileClose($fp);
if ($expectHttpStatus && ($expectHttpStatus != $lastHttpCode))
{
if ($file && ($method == 'GET'))
{
@unlink($file);
}
throw new UnexpectedHTTPStatus($lastHttpCode);
}
}
// Did we have a cURL error?
if ($errNo)
{
throw new cURLError($errNo, $error);
}
if ($expectHttpStatus)
{
if ($expectHttpStatus == $lastHttpCode)
{
return [];
}
}
if ($noParse)
{
return $response;
}
// Parse the response
$originalResponse = $response;
$response = json_decode($response, true);
// Did we get invalid JSON data?
if (!$response)
{
throw new InvalidJSON("Invalid JSON Data: $originalResponse");
}
unset($originalResponse);
// Did we get an error response?
if (isset($response['error']) && is_array($response['error']))
{
$decodedError = $this->decodeError($response['error']);
throw new APIError($decodedError['code'], $decodedError['description'], 500);
}
// Did we get an error response (from the helper script)?
if (isset($response['error']))
{
$error = $response['error'];
$errorDescription = $response['error_description'] ?? 'No error description provided';
throw new APIError($error, $errorDescription, 500);
}
return $response;
}
/**
* Normalize the path of a resource inside the Dropbox account
*
* @param string $relativePath The relative path to the Dropbox root
*
* @return string
*/
protected function normalizePath($relativePath)
{
/**
* Some users enter the base path as /foo/bar/ instead of /foo/bar. This results in relative paths in the form
* of /foo/bar//baz.bat instead of /foo/bar/baz.bat. While the former doesn't cause a problem uploading(!) it
* causes the download to fail with a 400 error and the signed URL to fail entirely with a Dropbox-side error
* message. Therefore we need to replace // with / in the $relativePath.
*/
$relativePath = str_replace('//', '/', $relativePath);
// Remove trailing slashes from the relative path
$relativePath = trim($relativePath, '/');
// An empty path is normalized to an empty string.
if (empty($relativePath))
{
$path = '';
return $path;
}
// The path MUST start with a forward slash
$path = '/' . $relativePath;
/**
* If the path is just a forward slash OR a double forward slash then it's the root which MUST be normalized to
* an empty string. Normally the check for the double forward slash should always be false (unless someone
* screwed up the code above).
*/
if (($path == '/') || $path == '//')
{
$path = '';
}
return $path;
}
/**
* Decodes the error messages returned by Dropbox
*
* @param array $error The error structure returned by Dropbox
*
* @return array Error code and description
*/
protected function decodeError($error)
{
// Initialise
$ret = [
'code' => 'unknown',
'description' => 'No error description provided. Raw error: ' . print_r($error, true),
];
// Make sure there's an error tag
if (!isset($error['.tag']))
{
$error['.tag'] = 'other';
}
$ret['code'] = $error['.tag'];
switch ($error['.tag'])
{
case 'path':
case 'path_lookup':
$tag = $error['.tag'];
if (!isset($error[$tag]['.tag']))
{
$error[$tag]['.tag'] = 'other';
}
$ret['code'] = $error[$tag]['.tag'];
switch ($ret['code'])
{
case 'malformed_path':
$ret['description'] = 'This field is optional.';
break;
case 'not_found':
$ret['description'] = 'There is nothing at the given path.';
break;
case 'not_file':
$ret['description'] = 'Dropbox was expecting a file, but the given path refers to something that isn\'t a file.';
break;
case 'not_folder':
$ret['description'] = 'Dropbox was expecting a folder, but the given path refers to something that isn\'t a folder.';
break;
case 'restricted_content':
$ret['description'] = 'The file cannot be transferred because the content is restricted. For example, sometimes there are legal restrictions due to copyright claims.';
break;
}
break;
case 'path_write':
if (!isset($error['path_write']['.tag']))
{
$error['path_write']['.tag'] = 'other';
}
$ret['code'] = $error['path_write']['.tag'];
switch ($ret['code'])
{
case 'malformed_path':
$ret['description'] = 'This field is optional.';
break;
case 'conflict':
$ret['description'] = 'Couldn\'t write to the target path because of a conflict.';
break;
case 'no_write_permission':
$ret['description'] = 'You do not have permissions to write to the target location.';
break;
case 'insufficient_space':
$ret['description'] = 'You do not have enough available space (bytes) to write more data.';
break;
case 'disallowed_name':
$ret['description'] = 'Dropbox will not save the file or folder because its name contains characters that are not allowed.';
break;
}
break;
case 'reset':
$ret['description'] = 'The folder listing cursor has been invalidated. Try getting a new folder list.';
break;
}
return $ret;
}
protected function getRefreshUrl()
{
if (empty($this->refreshUrl))
{
throw new \RuntimeException('The OAuth2 Refresh URL is empty. Please check your backup profile\'s configuration.');
}
$refreshUrl = $this->refreshUrl .
(strpos($this->refreshUrl, '?') === false ? '?' : '&')
. 'refresh_token=' . urlencode($this->refreshToken);
if (strpos($refreshUrl, self::helperUrl) === 0)
{
$refreshUrl .= '&dlid=' . urlencode($this->dlid);
}
return $refreshUrl;
}
}
PK \{ { 6 vendor/akeeba/engine/engine/Postproc/Connector/Ovh.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Http;
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing\Apikey;
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing\Tenantid;
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing\Username;
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Request;
use DateTime;
class Ovh extends Swift
{
/**
* Ovh constructor.
*
* @param string $tenantId The OpenStack tenant ID.
* @param string $username The OpenStack username.
* @param string $password The OpenStack password.
*
* @throws Apikey
* @throws Tenantid
* @throws Username
* @since 6.1.0
*
*/
public function __construct($tenantId, $username, $password)
{
// OVH is now using Keystone v3
$authEndpoint = 'https://auth.cloud.ovh.net';
// Data validation
if (empty($tenantId))
{
throw new TenantId('You have not specified your OVH OpenStack Project ID');
}
if (empty($username))
{
throw new Username('You have not specified your OVH OpenStack Username');
}
if (empty($username))
{
throw new Apikey('You have not specified your OVH OpenStack Password');
}
parent::__construct('v3', $authEndpoint, $tenantId, $username, $password, 'Default');
}
}
PK \D D 8 vendor/akeeba/engine/engine/Postproc/Connector/Swift.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Http;
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Request;
use Akeeba\Engine\Util\FileCloseAware;
use DateTime;
use stdClass;
/**
* Generic OpenStack SWIFT object storage API implementation
*/
class Swift
{
use FileCloseAware;
/**
* The Keystone version to use for authenticating. One of v2, v3.
*
* @var string
* @since 9.3.0
*/
protected $keystoneVersion = 'v2';
/**
* The authentication server (Keystone) endpoint, e.g. https://auth.cloud.ovh.net/v2.0
*
* @var string
* @since 6.1.0
*/
protected $authEndpoint = '';
/**
* The endpoint for accessing the storage container, e.g. https://storage.de1.cloud.ovh.net/v1/AUTH_abcdef0123456789abcdef0123456789/my-container
*
* @var string
* @since 6.1.0
*/
protected $storageEndpoint = '';
/**
* The token retrieved from the authentication service (Keystone)
*
* @var string
* @since 6.1.0
*/
protected $token;
/**
* The expiration timestamp of the token
*
* @var int
* @since 6.1.0
*/
protected $tokenExpiration;
/**
* The tenant ID of the OpenStack cloud
*
* @var string
* @since 6.1.0
*/
protected $tenantId;
/**
* The Keystone v3 authentication domain
*
* @var string
* @since 9.3.0
*/
protected $domain;
/**
* The OpenStack username
*
* @var string
* @since 6.1.0
*/
protected $username;
/**
* The OpenStack password
*
* @var string
* @since 6.1.0
*/
protected $password;
/**
* The endpoints of the SWIFT service, as returned by the Keystone service, indexed by region. Each endpoint is
* raw object.
*
* @var stdClass[]
* @since 6.1.0
*/
protected $endPoints = [];
/**
* A callable which is passed the authentication information and result to cater for non-standard SWIFT
* implementations.
*
* @var callable
* @since 6.1.0
*/
protected $authenticationCallback;
/**
* Swift constructor.
*
* @param string $authEndpoint The authentication endpoint URL.
* @param string $tenantId The OpenStack tenant ID.
* @param string $username The OpenStack username.
* @param string $password The OpenStack password.
*
*
* @since 6.1.0
*/
public function __construct($keystoneVersion, $authEndpoint, $tenantId, $username, $password, $keystoneDomain = 'default')
{
$this->keystoneVersion = $keystoneVersion;
$this->authEndpoint = $authEndpoint;
$this->tenantId = $tenantId;
$this->username = $username;
$this->password = $password;
$this->domain = $keystoneDomain;
}
/**
* Get the authentication endpoint URL
*
* @return string
* @since 6.1.0
*/
public function getAuthEndpoint()
{
return $this->authEndpoint;
}
/**
* Set the authentication endpoint
*
* @param string $authEndpoint The new authentication endpoint URL
*
* @return Swift
* @since 6.1.0
*/
public function setAuthEndpoint($authEndpoint)
{
$this->authEndpoint = $authEndpoint;
return $this;
}
/**
* Get the storage container's endpoint URL
*
* @return string
* @since 6.1.0
*/
public function getStorageEndpoint()
{
return $this->storageEndpoint;
}
/**
* Set the storage container's endpoint URL
*
* @param string $storageEndpoint The storage container's endpoint URL
*
* @return Swift
* @since 6.1.0
*/
public function setStorageEndpoint($storageEndpoint)
{
$this->storageEndpoint = $storageEndpoint;
return $this;
}
/**
* @return string
*/
public function getTenantId()
{
return $this->tenantId;
}
/**
* @param string $tenantId
*
* @return Swift
*/
public function setTenantId($tenantId)
{
$this->tenantId = $tenantId;
return $this;
}
/**
* @return string
*/
public function getUsername()
{
return $this->username;
}
/**
* @param string $username
*
* @return Swift
*/
public function setUsername($username)
{
$this->username = $username;
return $this;
}
/**
* @return string
*/
public function getPassword()
{
return $this->password;
}
/**
* @param string $password
*
* @return Swift
*/
public function setPassword($password)
{
$this->password = $password;
return $this;
}
/**
* @return int
*/
public function getTokenExpiration()
{
return $this->tokenExpiration;
}
/**
* @return stdClass[]
*/
public function getEndPoints()
{
return $this->endPoints;
}
/**
* Get the token. If the token is expired or missing, or if the force parameter is set, we will re-authenticate
* against the OpenStack cloud.
*
* @param bool $force Tru to force re-authentication
*
* @return string
* @throws Http
* @since 6.1.0
*
*/
public function getToken($force = false)
{
// Am I forced to get a fresh token?
if ($force)
{
$this->authenticate();
}
// If I don't have a token I must authenticate
if (empty($this->token))
{
$this->authenticate();
}
// The expiration time of the token is less than an hour away. Let's re-authenticate.
if ($this->tokenExpiration < (time() + 3600))
{
$this->authenticate();
}
return $this->token;
}
/**
* Lists the containers in the SWIFT account
*
* @param bool $assoc Should I return an associative array, where the key is the container name? (def: no)
* @param string $lastContainer Start listing AFTER this last container (pagination)
* @param int $limit How many containers to list
*
* @return stdClass[] Array or objects. Internal objects have keys count, bytes, name
*
* @throws Http
* @since 6.1.0
*/
public function listContainers($assoc = false, $lastContainer = null, $limit = 10000)
{
// Re-authenticate if necessary
$token = $this->getToken();
// Get the URL to list containers. It's the container endpoint minus the actual container name.
$url = $this->getStorageEndpoint();
$lastSlash = strrpos($url, '/');
$url = substr($url, 0, $lastSlash);
// Get the request object
$request = new Request('GET', $url);
$request->setHeader('X-Auth-Token', $token);
$request->setHeader('Accept', 'application/json');
$request->setParameter('format', 'json');
if (!empty($lastContainer))
{
$request->setParameter('marker', $lastContainer);
}
if (!is_numeric($limit))
{
$limit = 10000;
}
if ($limit <= 0)
{
$limit = 10000;
}
$request->setParameter('limit', $limit);
$response = $request->getResponse();
if (!$assoc)
{
return $response->body;
}
$ret = [];
if (!empty($response->body))
{
foreach ($response->body as $container)
{
$ret[$container->name] = $container;
}
}
return $ret;
}
/**
* Lists the contents of a directory inside the container
*
* @param string $path The path to the directory you want to list, '' for the root.
* @param bool $assoc Should I return an associative array with filenames as keys?
* @param null $lastEntry The entry AFTER which to start listing
* @param int $limit How many files to show (1000 by default)
* @param string $prefix The common prefix of files to list
*
* @return array Array of objects. Object keys: hash, last_modified, bytes, name, content_type
* @throws Http
* @since 6.1.0
*
*/
public function listContents($path = '', $assoc = false, $lastEntry = null, $limit = 1000, $prefix = '')
{
// Re-authenticate if necessary
$token = $this->getToken();
// Get the URL to list containers
$url = $this->getStorageEndpoint();
$url = rtrim($url, '\\/');
$path = ltrim($path, '\\/');
$url .= '/' . $path;
// Get the request object
$request = new Request('GET', $url);
$request->setHeader('X-Auth-Token', $token);
$request->setHeader('Accept', 'application/json');
$request->setParameter('format', 'json');
if (!empty($lastEntry))
{
$request->setParameter('marker', $lastEntry);
}
if (!empty($prefix))
{
$request->setParameter('prefix', $prefix);
}
if (!is_numeric($limit))
{
$limit = 1000;
}
if ($limit <= 0)
{
$limit = 1000;
}
$request->setParameter('limit', $limit);
$request->setParameter('delimiter', '/');
$response = $request->getResponse();
if (!$assoc)
{
return $response->body;
}
$ret = [];
if (!empty($response->body))
{
foreach ($response->body as $file)
{
$ret[$file->name] = $file;
}
}
return $ret;
}
/**
* Uploads a file. The $input array can have one of the following formats:
*
* 1. A string with the contents of the file to be put to CloudFiles
*
* 2. An array('fp' => $fp) containing a file pointer, open in read binary mode, to the file to upload
*
* 3. An array('file' => $pathToFile) containing the path to the file to upload
*
* 4. An array('data' => $rawData) which is the same as passing a string (case 1)
*
* When using an array you can also pass the following optional parameters in the array:
* size The size of the uploaded content in bytes
*
* @param string|array $input See the method description
* @param string $path The path inside the container of the uploaded file
* @param string $contentType The content type of the uploaded file
*
* @throws Http
* @since 6.1.0
*
*/
public function putObject($input, $path, $contentType = null)
{
// Re-authenticate if necessary
$token = $this->getToken();
// Get the URL to list containers
$url = $this->getStorageEndpoint();
$url = rtrim($url, '\\/');
$path = ltrim($path, '\\/');
$url .= '/' . $path;
// Get the request object
$request = new Request('PUT', $url);
$request->setHeader('X-Auth-Token', $token);
// Decide what to do based on the $input format
if (is_string($input))
{
$input = [
'data' => $input,
'size' => strlen($input),
];
}
// Data
if (isset($input['fp']))
{
$request->fp = $input['fp'];
}
elseif (isset($input['file']))
{
$request->fp = @fopen($input['file'], 'r');
}
elseif (isset($input['data']))
{
$request->data = $input['data'];
}
// Content-Length (required)
if (isset($input['size']) && $input['size'] >= 0)
{
$request->size = $input['size'];
}
else
{
if (isset($input['file']))
{
clearstatcache(false, $input['file']);
$request->size = @filesize($input['file']);
}
elseif (isset($input['data']))
{
$request->size = strlen($input['data']);
}
}
if (empty($contentType))
{
$contentType = 'application/octet-stream';
}
$request->setParameter('Content-Type', $contentType);
$request->setParameter('Content-Length', $request->size);
$request->getResponse();
if (isset($input['file']))
{
$this->conditionalFileClose($request->fp);
}
}
/**
* Downloads a file from CloudFiles back to your server
*
* @param string $path The path to the file to download
* @param resource $fp A file pointer, opened in write binary mode, to write out the downloaded file
* @param array $headers An array of headers to send during the download, e.g. ['Range' => '1-100']
*
* @return void
*
* @throws Http
* @since 6.1.0
*
*/
public function downloadObject($path, &$fp, $headers = [])
{
// Re-authenticate if necessary
$token = $this->getToken();
// Get the URL to list containers
$url = $this->getStorageEndpoint();
$url = rtrim($url, '\\/');
$path = ltrim($path, '\\/');
$url .= '/' . $path;
// Get the request object
$request = new Request('GET', $url);
$request->setHeader('X-Auth-Token', $token);
if (!empty($headers))
{
foreach ($headers as $k => $v)
{
$request->setHeader($k, $v);
}
}
$request->fp = $fp;
$request->getResponse();
}
/**
* Delete a file from CloudFiles
*
* @param string $path The path to the file to download
*
* @return void
*
* @throws Http
* @since 6.1.0
*
*/
public function deleteObject($path)
{
// Re-authenticate if necessary
$token = $this->getToken();
// Get the URL to list containers
$url = $this->getStorageEndpoint();
$url = rtrim($url, '\\/');
$path = ltrim($path, '\\/');
$url .= '/' . $path;
// Get the request object
$request = new Request('DELETE', $url);
$request->setHeader('X-Auth-Token', $token);
$request->getResponse();
}
/**
* Authenticate to the OpenStack cloud and retrieve a fresh token
*
* @return string
* @throws Http
*
* @since 6.1.0
*/
protected function authenticate()
{
switch ($this->keystoneVersion)
{
case 'v2':
return $this->authenticateV2();
break;
case 'v3':
default:
return $this->authenticateV3();
break;
}
}
/**
* Authenticate to the OpenStack cloud using Keystone v2 and retrieve a fresh token
*
* @return string
* @throws Http
*
* @since 6.1.0
*/
protected function authenticateV2()
{
// Send the token request to Keystone
$message = [
'auth' => [
'tenantId' => $this->tenantId,
'passwordCredentials' => [
'username' => $this->username,
'password' => $this->password,
],
],
];
$json = json_encode($message);
$url = rtrim($this->authEndpoint, '/') . '/tokens';
$request = new Request('POST', $url);
$request->data = $json;
$request->setHeader('Accept', 'application/json');
$request->setHeader('Content-Type', 'application/json');
$request->setHeader('Content-Length', strlen($request->data));
$response = $request->getResponse();
// Get the tenant ID
$this->tenantId = $response->body->access->token->tenant->id;
// Get the token and its expiration
$this->token = $response->body->access->token->id;
$date = new DateTime($response->body->access->token->expires);
$this->tokenExpiration = $date->getTimestamp();
// Loop through the serviceCatalog and index the Swift endpoints
if (isset($request->body) && isset($request->body->serviceCatalog))
{
foreach ($request->body->serviceCatalog as $service)
{
if ($service->name != 'swift')
{
continue;
}
if (!isset($service->endpoints))
{
continue;
}
foreach ($service->endpoints as $endpoint)
{
$this->endPoints[$endpoint->region] = $endpoint->publicURL;
}
}
}
// Callback
if (is_callable($this->authenticationCallback))
{
call_user_func_array($this->authenticationCallback, [&$this, $response]);
}
return $this->token;
}
/**
* Returns the authentication token using Keystone v3 authentication.
*
* @return string
* @throws Http
*
* @since 9.3.0
*/
protected function authenticateV3()
{
// Send the scoped token request to Keystone
$message = [
'auth' => [
'identity' => [
'methods' => [
'password',
],
'password' => [
'user' => [
'name' => $this->username,
'domain' => [
'name' => $this->domain,
],
'password' => $this->password,
],
],
],
'scope' => [
'project' => [
'id' => $this->tenantId,
'domain' => [
'name' => $this->domain,
],
],
],
],
];
$json = json_encode($message);
$url = rtrim($this->authEndpoint, '/') . '/v3/auth/tokens';
$request = new Request('POST', $url);
$request->data = $json;
$request->setHeader('Accept', 'application/json');
$request->setHeader('Content-Type', 'application/json');
$request->setHeader('Content-Length', strlen($request->data));
$response = $request->getResponse();
// Get the tenant (project) ID
$this->tenantId = $response->body->token->project->id;
// Get the token and its expiration
$this->token = $response->headers['x-subject-token'];
$date = new DateTime($response->body->token->expires_at);
$this->tokenExpiration = $date->getTimestamp();
// Loop through the serviceCatalog and index the Swift endpoints
if (isset($response->body->token->catalog))
{
foreach ($response->body->token->catalog as $service)
{
if ($service->type != 'object-store')
{
continue;
}
if (!isset($service->endpoints))
{
continue;
}
foreach ($service->endpoints as $endpoint)
{
$this->endPoints[$endpoint->region_id] = $endpoint->url;
}
}
}
// Callback
if (is_callable($this->authenticationCallback))
{
call_user_func_array($this->authenticationCallback, [&$this, $response]);
}
return $this->token;
}
}
PK \ _ _ 6 vendor/akeeba/engine/engine/Postproc/Connector/Box.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Box\Exception\APIError;
use Akeeba\Engine\Postproc\Connector\Box\Exception\cURLError;
use Akeeba\Engine\Postproc\Connector\Box\Exception\InvalidJSON;
use Akeeba\Engine\Postproc\Connector\Box\Exception\UnexpectedHTTPStatus;
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use Akeeba\Engine\Util\HashTrait;
use CURLFile;
use RuntimeException;
/**
* Box.com API connector
*
* @see https://developer.box.com/v2.0/reference
*
* WARNING! WE DO NOT SUPPORT CHUNKED UPLOADS FOR A VERY GOOD REASON.
*
* The Box.com API does not allow us to select the chunk size when uploading files. The chunked upload methods returns
* a part size when you create a chunked upload session and you MUST use EXACTLY this part size. This tends to be rather
* high, defeating the purpose of using it to work around server timeout limitations. Therefore we only implement single
* part uploads. You can prevent timeouts by setting the "Part size for archive splitting" option in the archiver to
* create smaller files which will upload without timing out.
*/
class Box
{
use HashTrait;
use FileCloseAware;
use ProxyAware;
/**
* The root URL for the Box API
*/
public const rootUrl = 'https://api.box.com/2.0/';
/**
* The root URL for the Box API
*/
public const uploadUrl = 'https://upload.box.com/api/2.0/';
/**
* The URL of the helper script which is used to get fresh API tokens
*/
public const helperUrl = 'https://www.akeeba.com/oauth2/box.php';
/**
* Refresh the access token proactively when it is within this many seconds of expiring. Box access tokens are
* short-lived (typically 1 hour); refreshing a little before expiry prevents the token from lapsing in the middle
* of a long-running backup, which is the cause of intermittent, hard-to-reproduce upload/download failures.
*/
private const tokenExpirationThreshold = 300;
/**
* The access token for connecting to Box.com
*
* @var string
*/
private $accessToken = '';
/**
* The refresh token for connecting to Box.com
*
* @var string
*/
private $refreshToken = '';
/**
* Download ID to use with the helper URL
*
* @var string
*/
private $dlid = '';
private $refreshUrl = '';
/**
* UNIX timestamp at which the current access token expires. 0 means "unknown" — e.g. a token supplied from saved
* configuration whose lifetime we have not learned yet. It is populated from the `expires_in` value Box returns
* whenever the token is refreshed.
*
* @var int
*/
private $tokenExpiration = 0;
/**
* Default cURL options
*
* @var array
*/
private $defaultOptions = [
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
CURLOPT_VERBOSE => false,
CURLOPT_HEADER => false,
CURLINFO_HEADER_OUT => false,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CAINFO => AKEEBA_CACERT_PEM,
];
/**
* Box constructor.
*
* @param string $accessToken The Box access token
* @param string $refreshToken The Box refresh token
* @param string $dlid The akeeba.com Download ID, used whenever you try to refresh the token
*/
public function __construct($accessToken, $refreshToken, $dlid, $refreshUrl = '')
{
$this->accessToken = $accessToken;
$this->refreshToken = $refreshToken;
$this->dlid = $dlid;
$this->refreshUrl = $refreshUrl ?: self::helperUrl;
}
/**
* Try to ping Box.com, refresh the token if it's expired and return the refresh results.
*
* If no refresh was required 'needs_refresh' will be false.
*
* If refresh was required 'needs_refresh' will be true and the rest of the keys will be as returned by Box.com.
*
* If the refresh failed you'll get a RuntimeException.
*
* @param bool $forceRefresh Set to true to forcibly refresh the tokens
*
* @return array
*
* @throws RuntimeException
*/
public function ping($forceRefresh = false)
{
// Initialization
$response = [
'needs_refresh' => false,
];
if (!$forceRefresh)
{
if (!empty($this->tokenExpiration))
{
// We know when the token expires: refresh PROACTIVELY once it is at — or within a safety margin of —
// expiry, so it cannot lapse mid-operation. This avoids the race where a "test" call succeeds but the
// token then expires moments later during the real request (the cause of intermittent failures).
$response['needs_refresh'] = (time() + self::tokenExpirationThreshold) >= $this->tokenExpiration;
}
else
{
// We do NOT know this token's expiry (e.g. it was supplied from saved configuration). Fall back to
// probing the API with it and refreshing only if that probe fails.
try
{
$this->getCurrentUser();
}
catch (UnexpectedHTTPStatus $e)
{
$response['needs_refresh'] = true;
}
}
}
// If there is no need to refresh the tokens, return
if (!$response['needs_refresh'] && !$forceRefresh)
{
return $response;
}
$refreshResponse = $this->refreshToken();
return array_merge($response, $refreshResponse);
}
/**
* Refresh the access token.
*
* @return array|string The result coming from Box
*/
public function refreshToken()
{
if (empty($this->refreshUrl))
{
throw new \RuntimeException('The OAuth2 Refresh URL is empty. Please check your backup profile\'s configuration.');
}
$refreshUrl = $this->refreshUrl .
(strpos($this->refreshUrl, '?') === false ? '?' : '&')
. 'refresh_token=' . urlencode($this->refreshToken);
if (strpos($refreshUrl, self::helperUrl) === 0)
{
$refreshUrl .= '&dlid=' . urlencode($this->dlid);
}
[$baseUrl, $query] = explode('?', $refreshUrl, 2);
$refreshResponse = $this->fetch('GET', $baseUrl, $refreshUrl);
$this->refreshToken = $refreshResponse['refresh_token'] ?? $this->refreshToken;
$this->accessToken = $refreshResponse['access_token'] ?? $this->accessToken;
// Record when the freshly minted access token will expire so ping() can refresh it proactively next time.
if (isset($refreshResponse['expires_in']))
{
$this->tokenExpiration = time() + (int) $refreshResponse['expires_in'];
}
$refreshResponse['refresh_token'] = $this->refreshToken;
$refreshResponse['access_token'] = $this->accessToken;
$refreshResponse['token_expiration'] = $this->tokenExpiration;
return $refreshResponse;
}
/**
* Get the UNIX timestamp at which the current access token expires (0 if unknown).
*
* @return int
*/
public function getTokenExpiration()
{
return $this->tokenExpiration;
}
/**
* Restore a previously persisted access-token expiry timestamp, so ping() can refresh proactively without first
* having to probe the API. Pass 0 to mark the expiry as unknown.
*
* @param int $tokenExpiration UNIX timestamp at which the access token expires.
*
* @return void
*/
public function setTokenExpiration($tokenExpiration)
{
$this->tokenExpiration = (int) $tokenExpiration;
}
/**
* Returns information about the current user. The most important fields are:
* * space_amount: how much total space is available to you (in bytes)
* * space_user: how much space you have already used (in bytes)
* * max_upload_size: maximum uploaded file size
* You need to issue an error when the uploaded file is larger than EITHER space_amount - space_user OR
* max_upload_size because either would cause the upload to fail. In the first case the Box account is running out
* of free space. In the latter case you would be trying to exceed the maximum upload size limitation (as low as
* 250MB on free / personal accounts).
*
* @return array
*/
public function getCurrentUser()
{
return $this->fetch('GET', self::rootUrl, 'users/me');
}
/**
* Lists the contents of a folder.
*
* @param int $parentId The ID of the folder to list. 0 is the root folder.
* @param int $offset Offset of the pagianted listing, 0 to start from the very beginning.
*
* @return array An array with keys files and folders. Each sub-array is keyed on file/folder name and the value
* is the file's/folder's numeric ID.
*/
public function listFolder($parentId = 0, $offset = 0)
{
$parentId = (int) $parentId;
$offset = max((int) $offset, 0);
$url = "folders/$parentId/items?limit=1000";
if ($offset > 0)
{
$url .= '&offset=' . $offset;
}
$ret = [
'files' => [],
'folders' => [],
];
$apiReturn = $this->fetch('GET', self::rootUrl, $url);
if (!is_array($apiReturn))
{
return $ret;
}
$totalCount = $apiReturn['total_count'] ?? 0;
if ($totalCount === 0)
{
return $ret;
}
if (!isset($apiReturn['entries']) || empty($apiReturn['entries']))
{
return $ret;
}
foreach ($apiReturn['entries'] as $entry)
{
if (!in_array($entry['type'], ['file', 'folder']))
{
continue;
}
$target = ($entry['type'] == 'file') ? 'files' : 'folders';
$name = $entry['name'];
$id = $entry['id'];
$ret[$target][$name] = $id;
}
/**
* The API paginates at $limit (default: 1000) items. If the items returned so far (offset + items on this page)
* do not yet account for the folder's total_count, there are more pages to fetch. This recurses through them.
*/
$limit = $apiReturn['limit'] ?? 1000;
$offset = $apiReturn['offset'] ?? $offset;
$itemsSoFar = $offset + count($apiReturn['entries']);
if ($itemsSoFar < $totalCount)
{
$offset += $limit;
$moreItems = $this->listFolder($parentId, $offset);
$ret = array_merge_recursive($ret, $moreItems);
}
return $ret;
}
/**
* Create a folder
*
* @param string $name The name of the folder to create
* @param int $parentId The ID of the parent folder. 0 is always the root folder
*
* @return int The ID of the created folder
*/
public function createFolder($name, $parentId = 0)
{
$apiReturn = [];
$parentId = (int) $parentId;
$url = "folders";
$postData = json_encode([
'name' => $name,
'parent' => [
'id' => $parentId,
],
]);
$additional = [];
try
{
$apiReturn = $this->fetch('POST', self::rootUrl, $url, $additional, $postData);
}
catch (UnexpectedHTTPStatus $e)
{
$httpResponse = $e->getCode();
if ($httpResponse == '409')
{
throw new APIError("already_exists", "Subfolder “{$name}” already exists under folder ID $parentId", 409, $e);
}
}
if (!isset($apiReturn['id']))
{
throw new APIError("", "Cannot create subfolder “{$name}” under folder ID $parentId");
}
return $apiReturn['id'];
}
/**
* Look for a folder relative to the $parentId folder and return its ID
*
* @param string $path The folder path to look for
* @param int $parentId The parent folder to start searching in (0 = root)
* @param bool $createMissing Should I create any missing folders? Default: true.
*
* @return int The folder ID
*
* @throws APIError When the folder cannot be found and/or we can't create a new folder by that name
*/
public function getFolderId($path, $parentId = 0, $createMissing = true)
{
$created = false;
$path = trim($path, '/');
while (strpos($path, '//') !== false)
{
$path = str_replace('//', '/', $path);
}
$path = trim($path, '/');
if (empty($path))
{
return $parentId;
}
$parts = explode('/', $path);
foreach ($parts as $folderName)
{
$foundId = false;
// Only search for folders if the current parent folder was not just created by us (saves us some useless requests)
if (!$created)
{
// Get the parent folder's contents
$contents = $this->listFolder($parentId);
// Trawl the folder list for the one that matches our folder name
foreach ($contents['folders'] as $key => $id)
{
if ($key == $folderName)
{
$foundId = $id;
break;
}
}
}
if (($foundId === false) && !$createMissing)
{
throw new APIError("not_found", "Folder $path does not exist", 404);
}
elseif ($foundId === false)
{
$created = true;
$foundId = $this->createFolder($folderName, $parentId);
}
$parentId = $foundId;
}
return $parentId;
}
/**
* Delete a file stored in Box given its path
*
* @param string $remoteFile The path of the file to delete
*
* @return bool
*/
public function deleteFileByName($remoteFile)
{
$fileId = $this->findFileId($remoteFile);
if ($fileId === false)
{
return false;
}
// Delete the file
$this->fetch('DELETE', self::rootUrl, "files/$fileId", [
'expect-status' => 204,
]);
return true;
}
/**
* Preflight check. Makes sure that the file can be uploaded to the selected path.
*
* @param string $remoteFile Path of the file in the Box.com account
* @param string $localFile Local filesystem path of the file to upload
*/
public function preflight($remoteFile, $localFile)
{
$remotePath = dirname($remoteFile);
$parentFolderId = empty($remotePath) ? 0 : $this->getFolderId($remotePath);
$sha1 = @self::sha1_file($localFile);
$postfields = json_encode([
'name' => basename($remoteFile),
'parent' => [
'id' => $parentFolderId,
],
'size' => @filesize($localFile),
]);
$additional = [
'headers' => [
// Yes, the header is named wrong. It's actually the SHA1 hash, not the MD5.
'Content-MD5' => $sha1,
],
];
if (empty($sha1))
{
unset($additional['headers']['Content-MD5']);
}
try
{
$this->fetch('OPTIONS', self::rootUrl, 'files/content', $additional, $postfields);
}
catch (UnexpectedHTTPStatus $e)
{
switch ($e->getCode())
{
case 409:
$error = 'file_exists';
$errorDesc = 'File already exists';
break;
case 403:
$error = 'permissions_error';
$errorDesc = 'Permissions error. The file is too big for your account type, you do not have enough space or the permissions of the target directory do not allow uploading this file.';
break;
default:
$error = 'unexpected_status';
$errorDesc = 'Unexpected HTTP status ' . $e->getCode();
}
throw new APIError($error, $errorDesc, $e->getCode(), $e);
}
}
/**
* Single part upload of a file
*
* @param string $remoteFile Path of the file in the Box.com account
* @param string $localFile Local filesystem path of the file to upload
*
* @return string The ID of the uploaded file
*/
public function uploadSingleFile($remoteFile, $localFile)
{
clearstatcache(false, $localFile);
// Find the parent folder ID if other than root
$remotePath = dirname($remoteFile);
$parentFolderId = empty($remotePath) ? 0 : $this->getFolderId($remotePath);
$sha1 = @self::sha1_file($localFile);
$postfields = [
"attributes" => json_encode([
'name' => basename($remoteFile),
'parent' => [
'id' => $parentFolderId,
],
]),
"file" => "@$localFile",
];
/**
* PHP 5.6 and later, using CURLFile instead of the at-path notation for file uploads.
*
* This is the recommended method in PHP 5.6 and the only supported method in PHP 7.0 and later.
*/
if (class_exists('\CURLFile'))
{
$postfields['file'] = new CURLFile($localFile);
}
$additional = [
'headers' => [
// Yes, the header is named wrong. It's actually the SHA1 hash, not the MD5.
'Content-MD5' => $sha1,
],
];
if (empty($sha1))
{
unset($additional['headers']['Content-MD5']);
}
$apiReturn = $this->fetch('POST', self::uploadUrl, 'files/content', $additional, $postfields);
if (
is_array($apiReturn) &&
isset($apiReturn['entries']) &&
is_array($apiReturn['entries']) &&
isset($apiReturn['entries'][0]) &&
isset($apiReturn['entries'][0]['id'])
)
{
return $apiReturn['entries'][0]['id'];
}
throw new APIError('cannot_create', "Cannot create file $remoteFile on Box.com");
}
public function download($remoteFile, $localFile)
{
$fileId = $this->findFileId($remoteFile);
if ($fileId === false)
{
throw new RuntimeException("The file $remoteFile does not exist in your Box.com account");
}
$fp = @fopen($localFile, 'w');
if ($fp === false)
{
throw new RuntimeException("Cannot open local file $localFile for writing");
}
$this->fetch('GET', self::rootUrl, "files/$fileId/content", [
'fp' => $fp,
'no-parse' => true,
]);
return true;
}
/**
* Execute an API call
*
* @param string $method The HTTP method
* @param string $baseUrl The base URL. Use one of self::rootUrl or self::contentRootUrl
* @param string $relativeUrl The relative URL to ping
* @param array $additional Additional parameters
* @param mixed $explicitPost Passed explicitly to POST requests if set, otherwise $additional is passed.
*
* @return array
* @throws RuntimeException
*
*/
protected function fetch($method, $baseUrl, $relativeUrl, array $additional = [], $explicitPost = null)
{
// Get full URL, if required
$url = $relativeUrl;
if (substr($relativeUrl, 0, 6) != 'https:')
{
$url = $baseUrl . ltrim($relativeUrl, '/');
}
// Should I expect a specific header?
$expectHttpStatus = [];
if (isset($additional['expect-status']))
{
$expectHttpStatus = $additional['expect-status'];
if (!is_array($expectHttpStatus))
{
$expectHttpStatus = [$expectHttpStatus];
}
unset($additional['expect-status']);
}
// Am I told to not parse the result?
$noParse = false;
if (isset($additional['no-parse']))
{
$noParse = $additional['no-parse'];
unset ($additional['no-parse']);
}
// Am I told not to follow redirections?
$followRedirect = true;
if (isset($additional['follow-redirect']))
{
$followRedirect = $additional['follow-redirect'];
unset ($additional['follow-redirect']);
}
// Initialise and execute a cURL request
$ch = curl_init($url);
$this->applyProxySettingsToCurl($ch);
// Get the default options array
$options = $this->defaultOptions;
// Do I have explicit cURL options to add?
if (isset($additional['curl-options']) && is_array($additional['curl-options']))
{
// We can't use array_merge since we have integer keys and array_merge reassigns them :(
foreach ($additional['curl-options'] as $k => $v)
{
$options[$k] = $v;
}
}
// Set up custom headers
$headers = [];
$hasAuthorizationHeader = false;
if (isset($additional['headers']))
{
$headers = $additional['headers'];
unset ($additional['headers']);
}
// Add the authorization header, if it doesn't exist
array_walk($headers, function ($header) use (&$hasAuthorizationHeader) {
if (substr($header, 0, 15) == 'Authorization: ')
{
$hasAuthorizationHeader = true;
}
});
if (!$hasAuthorizationHeader)
{
$headers[] = 'Authorization: Bearer ' . $this->accessToken;
}
$options[CURLOPT_HTTPHEADER] = $headers;
// Handle files
$file = null;
$fp = null;
$fileMode = null;
if (isset($additional['file']))
{
$file = $additional['file'];
unset ($additional['file']);
}
if (isset($additional['file_mode']))
{
$fileMode = $additional['file_mode'];
unset ($additional['file_mode']);
}
if (!isset($additional['fp']) && !empty($file))
{
if (is_null($fileMode))
{
$fileMode = ($method == 'GET') ? 'w' : 'r';
}
$fp = @fopen($file, $fileMode);
}
elseif (isset($additional['fp']))
{
$fp = $additional['fp'];
unset($additional['fp']);
}
// Set up additional options
if ($method == 'GET' && $fp)
{
$options[CURLOPT_RETURNTRANSFER] = false;
$options[CURLOPT_HEADER] = false;
$options[CURLOPT_FILE] = $fp;
if (empty($expectHttpStatus))
{
$expectHttpStatus = [200, 206];
}
}
elseif (in_array($method, ['POST', 'PUT']) && $fp)
{
$options[CURLOPT_POST] = true;
$options[CURLOPT_INFILE] = $fp;
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
$options[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
}
if ($file)
{
clearstatcache();
$options[CURLOPT_INFILESIZE] = @filesize($file);
}
else
{
$options[CURLOPT_INFILESIZE] = strlen(stream_get_contents($fp));
}
fseek($fp, 0);
}
elseif ($method == 'POST')
{
$options[CURLOPT_POST] = true;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
// This is required for some broken servers, e.g. SiteGround
else
{
$options[CURLOPT_POSTFIELDS] = '';
}
}
else // Any other HTTP method, e.g. DELETE
{
$options[CURLOPT_CUSTOMREQUEST] = $method;
if ($explicitPost)
{
$options[CURLOPT_POSTFIELDS] = $explicitPost;
}
elseif (!empty($additional))
{
$options[CURLOPT_POSTFIELDS] = $additional;
}
}
// Set the cURL options at once
@curl_setopt_array($ch, $options);
// Set the follow location flag
if ($followRedirect)
{
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
}
// Execute and parse the response
$response = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
$lastHttpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
// Close open file pointers
$hadFile = false;
if ($fp)
{
$hadFile = true;
$this->conditionalFileClose($fp);
}
// Did we have a cURL error?
if ($errNo)
{
throw new cURLError($errNo, $error);
}
// Close open file pointers
if ($hadFile && !empty($expectHttpStatus) && !in_array($lastHttpCode, $expectHttpStatus))
{
if ($file && ($method == 'GET'))
{
@unlink($file);
}
throw new UnexpectedHTTPStatus($lastHttpCode);
}
if (!empty($expectHttpStatus) && in_array($lastHttpCode, $expectHttpStatus))
{
return [];
}
if (empty($expectHttpStatus) && ($lastHttpCode >= 400))
{
throw new UnexpectedHTTPStatus($lastHttpCode);
}
if ($noParse)
{
return $response;
}
// Parse the response
$originalResponse = $response;
$response = json_decode($response, true);
// Did we get invalid JSON data?
if (!$response)
{
throw new InvalidJSON("Invalid JSON Data: $originalResponse");
}
unset($originalResponse);
if (!empty($response) && ($lastHttpCode > 201))
{
$response = ['error' => $response];
}
// Did we get an error response?
if (isset($response['error']) && is_array($response['error']))
{
$decodedError = $response['error'];
throw new APIError($decodedError['code'], $decodedError['message'], 500);
}
return $response;
}
/**
* @param $remoteFile
*
* @return bool|int
*/
private function findFileId($remoteFile)
{
$remoteName = basename($remoteFile);
$remotePath = dirname($remoteFile);
$parentFolderId = empty($remotePath) ? 0 : $this->getFolderId($remotePath);
$contents = $this->listFolder($parentFolderId);
$fileId = 0;
// Get the file ID
foreach ($contents['files'] as $name => $id)
{
if ($name == $remoteName)
{
$fileId = $id;
}
}
// File not found
if (empty($fileId))
{
return false;
}
return $fileId;
}
}
PK \~\C( E vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Request.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Cloudfiles;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Http;
use Akeeba\Engine\Postproc\ProxyAware;
use Akeeba\Engine\Util\FileCloseAware;
use stdClass;
/**
* RESTful API request abstraction
*/
class Request
{
use FileCloseAware;
use ProxyAware;
/** @var bool|resource File pointer for GET and POST data */
public $fp = false;
/** @var int Size of the POST data */
public $size = 0;
/** @var bool|string POST data */
public $data = false;
/** @var null|stdClass The response object */
public $response = null;
/** @var string The HTTP verb to use, e.g. GET, POST, PUT, HEAD, DELETE */
private $verb;
/** @var string The API URL to call */
private $url;
/** @var array Query string parameters */
private $parameters = [];
/** @var array Headers to send with the request */
private $headers = [];
/**
* Constructor
*
* @param string $verb Verb
* @param string $url Object URI
*
* @return void
*/
function __construct($verb, $url = '')
{
$this->verb = $verb;
$this->url = $url;
$this->response = new stdClass();
$this->response->error = false;
}
/**
* Set request parameter
*
* @param string $key Key
* @param string $value Value
*
* @return void
*/
public function setParameter($key, $value)
{
$this->parameters[$key] = $value;
}
/**
* Set request header
*
* @param string $key Key
* @param string $value Value
*
* @return void
*/
public function setHeader($key, $value)
{
$this->headers[$key] = $value;
}
/**
* Get the response
*
* @return object | false
*
* @throws Http When something goes awry
*/
public function getResponse()
{
$query = '';
if (count($this->parameters) > 0)
{
$query = substr($this->url, -1) !== '?' ? '?' : '&';
foreach ($this->parameters as $var => $value)
{
$addToQuery = $var . '&';
if (!($value == null || $value == ''))
{
$addToQuery = $var . '=' . rawurlencode($value) . '&';
}
$query .= $addToQuery;
}
$query = substr($query, 0, -1);
$this->url .= $query;
}
// Basic setup
$curl = curl_init();
$this->applyProxySettingsToCurl($curl);
@curl_setopt($curl, CURLOPT_CAINFO, AKEEBA_CACERT_PEM);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($curl, CURLOPT_USERAGENT, 'AkeebaBackup/4.0');
curl_setopt($curl, CURLOPT_URL, $this->url);
// Set an infinite timeout and hope for the best
curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 0);
curl_setopt($curl, CURLOPT_TIMEOUT, 0);
// Headers
$headers = [];
foreach ($this->headers as $header => $value)
{
if (strlen($value) > 0)
{
$headers[] = $header . ': ' . $value;
}
}
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, false);
curl_setopt($curl, CURLOPT_WRITEFUNCTION, [$this, '__responseWriteCallback']);
curl_setopt($curl, CURLOPT_HEADERFUNCTION, [$this, '__responseHeaderCallback']);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
// Request types
switch ($this->verb)
{
case 'GET':
break;
case 'PUT':
case 'POST': // POST only used for CloudFront
if ($this->fp !== false)
{
curl_setopt($curl, CURLOPT_PUT, true);
curl_setopt($curl, CURLOPT_INFILE, $this->fp);
if ($this->size >= 0)
{
curl_setopt($curl, CURLOPT_INFILESIZE, $this->size);
}
// Some broken cURL versions cause an error. Forcing HTTP/1.1 seems to be fixing it.
if (defined('CURLOPT_HTTP_VERSION') && defined('CURL_HTTP_VERSION_1_1'))
{
curl_setopt($curl, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
}
}
elseif ($this->data !== false)
{
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $this->verb);
curl_setopt($curl, CURLOPT_POSTFIELDS, $this->data);
if ($this->size >= 0)
{
curl_setopt($curl, CURLOPT_BUFFERSIZE, $this->size);
}
}
else
{
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $this->verb);
}
break;
case 'HEAD':
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'HEAD');
curl_setopt($curl, CURLOPT_NOBODY, true);
break;
case 'DELETE':
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'DELETE');
break;
default:
break;
}
// Execute, grab errors
if (curl_exec($curl))
{
$this->response->code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
}
else
{
$this->response->error = [
'code' => curl_errno($curl),
'message' => curl_error($curl),
'url' => $this->url,
];
}
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
@curl_close($curl);
}
// Parse body into XML
if (
($this->response->error === false)
&& isset($this->response->headers['content-type'])
&& (strstr($this->response->headers['content-type'], 'application/json') !== false)
&& isset($this->response->body)
)
{
$this->response->body = json_decode($this->response->body);
}
if ($this->response->error || ($this->response->code >= 400))
{
if (!empty($this->response->body))
{
$body = json_encode($this->response->body);
$body = json_decode($body, true);
$this->response->code = '-1';
$this->response->error = $this->response->body;
if (is_array($body))
{
$allKeys = array_keys($body);
$firstKey = array_shift($allKeys);
$errorInfo = $body[$firstKey];
if (isset($errorInfo['code']))
{
$this->response->code = $errorInfo['code'];
}
if (isset($errorInfo['message']))
{
$this->response->error = $errorInfo['message'];
}
else
{
$this->response->error = $firstKey;
}
}
}
if (empty($this->response->error) || empty($this->response->code))
{
$this->response->error = 'Timeout';
$this->response->code = 0;
}
throw new Http($this->response->error, $this->response->code);
}
// Clean up file resources
if (($this->fp !== false) && is_resource($this->fp))
{
$this->conditionalFileClose($this->fp);
}
return $this->response;
}
/**
* CURL write callback
*
* @param resource &$curl CURL resource
* @param string &$data Data
*
* @return integer
*/
protected function __responseWriteCallback($curl, $data)
{
if (in_array($this->response->code, [200, 206]) && $this->fp !== false)
{
return fwrite($this->fp, $data);
}
else
{
if (!isset($this->response->body))
{
$this->response->body = '';
}
$this->response->body .= $data;
}
return strlen($data);
}
/**
* CURL header callback
*
* @param resource &$curl CURL resource
* @param string &$data Data
*
* @return integer
*/
protected function __responseHeaderCallback($curl, $data)
{
$strlen = strlen($data);
if ($strlen <= 2)
{
return $strlen;
}
if (substr($data, 0, 4) == 'HTTP')
{
$this->response->code = (int) substr($data, 9, 3);
}
else
{
[$header, $value] = explode(': ', trim($data), 2);
$this->response->headers[strtolower($header)] = is_numeric($value) ? (int) $value : $value;
}
return $strlen;
}
}
PK \ L vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Exception/Http.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception;
defined('AKEEBAENGINE') || die();
/**
* Generic exception thrown upon failure of a REST API call
*/
class Http extends Base
{
}
PK \yM L vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Exception/Base.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception;
defined('AKEEBAENGINE') || die();
use Exception;
/**
* Base exception class
*/
class Base extends Exception
{
}
PK \L
X vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Exception/Missing/Tenantid.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing;
defined('AKEEBAENGINE') || die();
use Exception;
/**
* \Exception thrown when the Tenant ID is missing
*/
class Tenantid extends Exception
{
}
PK \u X vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Exception/Missing/Username.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing;
defined('AKEEBAENGINE') || die();
use Exception;
/**
* \Exception thrown when the username is missing
*/
class Username extends Exception
{
}
PK \v V vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Exception/Missing/Apikey.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing;
defined('AKEEBAENGINE') || die();
use Exception;
/**
* \Exception thrown when the API key is missing
*/
class Apikey extends Exception
{
}
PK \Sʉ U vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Exception/Missing/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ M vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ C vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles/.htaccessnu 7m
Order allow,deny
Deny from all
PK \l = vendor/akeeba/engine/engine/Postproc/Connector/Cloudfiles.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Connector;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing\Apikey as MissingApikey;
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Exception\Missing\Username as MissingUsername;
use Akeeba\Engine\Postproc\Connector\Cloudfiles\Request;
use DateTime;
/**
* Self-contained implementation of the RackSpace CloudFiles in PHP
*/
class Cloudfiles extends Swift
{
/** @var string The user contract (MossoCloudFS_aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee) returned by CloudFiles */
protected $userContract = '';
/** @var string The authentication endpoint. This is a universal endpoint for all accounts now. */
protected $authEndpoint = 'https://identity.api.rackspacecloud.com/v2.0';
/** @var array List of storage endpoints per region */
protected $storageEndpoints = [
'ORD' => 'https://storage101.ord1.clouddrive.com',
'DFW' => 'https://storage101.dfw1.clouddrive.com',
'HKG' => 'https://storage101.hkg1.clouddrive.com',
'LON' => 'https://storage101.lon3.clouddrive.com',
'IAD' => 'https://storage101.iad3.clouddrive.com',
'SYD' => 'https://storage101.syd2.clouddrive.com',
];
/** @var string The region of the account. It is kindly reported by the Swift API, no need to set it. */
protected $region = 'LON';
/** @var string The storage API version to use */
protected $apiVersion = 'v1';
protected $container = '';
/**
* Public constructor
*
* @param string $username The CloudFiles username
* @param string $apiKey The CloudFiles API key
* @param array $options Configuration options (authEndpoint, storageEndpoint, apiVersion, userContract, tenantId, tokenExpiration, token)
*
* @throws MissingUsername You have not given me a username
* @throws MissingApikey You have not given me an API key
*/
public function __construct($username, $apiKey, $options = [])
{
// Data validation
if (empty($username))
{
throw new MissingUsername('You have not specified your CloudFiles username');
}
if (empty($apiKey))
{
throw new MissingApikey('You have not specified your CloudFiles API key');
}
parent::__construct('v2', 'https://identity.api.rackspacecloud.com/v2.0', '', $username, $apiKey, 'default');
// Very simplistic options parsing
if (is_array($options) && count($options))
{
foreach ($options as $key => $value)
{
if (in_array($key, ['username', 'password', 'apiKey']))
{
continue;
}
if (isset($this->$key))
{
$this->$key = $value;
}
}
}
}
/**
* Return the current options, useful to instantiate a new object without having to re-authenticate to CloudFiles
*
* @return array
*/
public function getCurrentOptions()
{
return [
'token' => $this->token,
'tokenExpiration' => $this->tokenExpiration,
'tenantId' => $this->tenantId,
'container' => $this->container,
'userContract' => $this->userContract,
'authEndpoint' => $this->authEndpoint,
'region' => $this->region,
'storageEndpoint' => $this->storageEndpoint,
'apiVersion' => $this->apiVersion,
];
}
/**
* Authenticate the user and obtain a new token. If there is a token and it's not expired yet we will reuse it.
*
* @param bool $force Force authentication?
*/
public function authenticate($force = false)
{
// Should I proceed?
if (!$force)
{
if (!empty($this->token) && !empty($this->tokenExpiration))
{
if ($this->tokenExpiration > (time() + 3600))
{
// I have a token and its expiration time is more than one hour into the future. No need to re-auth.
return;
}
}
}
$request = new Request('POST', $this->authEndpoint . '/tokens');
$dataRaw = (object) [
'auth' => [
"RAX-KSKEY:apiKeyCredentials" => [
'username' => $this->username,
'apiKey' => $this->password,
],
],
];
$dataForPost = json_encode($dataRaw);
$request->data = $dataForPost;
$request->setHeader('Accept', 'application/json');
$request->setHeader('Content-Type', 'application/json');
$request->setHeader('Content-Length', strlen($request->data));
$response = $request->getResponse();
$this->token = $response->body->access->token->id;
$this->tenantId = $response->body->access->token->tenant->id;
$date = new DateTime($response->body->access->token->expires);
$this->tokenExpiration = $date->getTimestamp();
$raxAuthRegionKey = 'RAX-AUTH:defaultRegion';
$defaultRegion = $response->body->access->user->$raxAuthRegionKey;
$this->region = strtoupper($defaultRegion);
$needsEndpoint = false;
if (empty($this->storageEndpoint))
{
$this->storageEndpoint = $this->storageEndpoints[$this->region];
$needsEndpoint = true;
}
foreach ($response->body->access->serviceCatalog as $service)
{
if ($service->name != 'cloudFiles')
{
continue;
}
foreach ($service->endpoints as $endpoint)
{
if ($endpoint->region != $defaultRegion)
{
continue;
}
$this->userContract = $endpoint->tenantId;
break;
}
}
// Finally, set up the storage endpoint in the way the API class expects it
if ($needsEndpoint)
{
$this->storageEndpoint .= '/' . $this->apiVersion . '/' . $this->userContract . '/' . $this->container;
}
}
}
PK \Sʉ 8 vendor/akeeba/engine/engine/Postproc/Connector/.htaccessnu 7m
Order allow,deny
Deny from all
PK \H&sb b . vendor/akeeba/engine/engine/Postproc/Email.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Awf\Text\Text;
use Joomla\CMS\Language\Text as JText;
use RuntimeException;
class Email extends Base
{
public function processPart($localFilepath, $remoteBaseName = null)
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$address = trim($config->get('engine.postproc.email.address', ''));
$subject = $config->get('engine.postproc.email.subject', '0');
// Sanity checks
if (empty($address))
{
throw new BadConfiguration('You have not set up a recipient\'s email address for the backup files');
}
// Send the file
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
Factory::getLog()->info(sprintf("Preparing to email %s to %s", $basename, $address));
if (empty($subject))
{
$subject = "You have a new backup part";
if (class_exists('\Awf\Text\Text'))
{
$subject = Text::_('COM_AKEEBA_COMMON_EMAIL_DEAFULT_SUBJECT');
if ($subject === 'COM_AKEEBA_COMMON_EMAIL_DEAFULT_SUBJECT')
{
$subject = JText::_('COM_AKEEBABACKUP_COMMON_EMAIL_DEAFULT_SUBJECT');
}
}
elseif (class_exists('\Joomla\CMS\Language\Text'))
{
$subject = JText::_('COM_AKEEBA_COMMON_EMAIL_DEAFULT_SUBJECT');
if ($subject === 'COM_AKEEBA_COMMON_EMAIL_DEAFULT_SUBJECT')
{
$subject = JText::_('COM_AKEEBABACKUP_COMMON_EMAIL_DEAFULT_SUBJECT');
}
}
}
$body = "Emailing $basename";
Factory::getLog()->debug("Subject: $subject");
Factory::getLog()->debug("Body: $body");
$result = Platform::getInstance()->send_email($address, $subject, $body, $localFilepath);
// Return the result
if ($result !== true)
{
// An error occurred
throw new RuntimeException($result);
}
// Return success
Factory::getLog()->info("Email sent successfully");
return true;
}
protected function makeConnector()
{
/**
* This method does not use a connector.
*/
return;
}
}
PK \81 4 vendor/akeeba/engine/engine/Postproc/Onedriveapp.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Connector\OneDriveApp as ConnectorOneDrive;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
/**
* OneDrive (custom Azure AD application) post-processing engine.
*
* @deprecated Legacy OneDrive integration tied to a per-user custom OAuth2 application. Superseded by the
* Onedrivebusiness engine using the modern Microsoft Graph API. Retained only for backwards compatibility.
*/
class Onedriveapp extends Onedrivebusiness
{
/**
* The name of the OAuth2 callback method in the parent window (the configuration page)
*
* @var string
*/
protected $callbackMethod = 'akeeba_onedriveapp_oauth_callback';
/**
* The key in Akeeba Engine's settings registry for this post-processing method
*
* @var string
*/
protected $settingsKey = 'onedriveapp';
public function __construct()
{
parent::__construct();
// This OneDrive integration does not allow the getDrives method.
array_pop($this->allowedCustomAPICallMethods);
}
protected function makeConnector()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$access_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.access_token', ''));
$refresh_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.refresh_token', ''));
$this->isChunked = $config->get('engine.postproc.' . $this->settingsKey . '.chunk_upload', true);
$this->chunkSize = $config->get('engine.postproc.' . $this->settingsKey . '.chunk_upload_size', 10) * 1024 * 1024;
$defaultDirectory = rtrim($config->get('engine.postproc.' . $this->settingsKey . '.directory', ''), '/');
$this->directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Sanity checks
if (empty($refresh_token))
{
throw new BadConfiguration('You have not linked Akeeba Backup with your OneDrive account');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$this->directory = empty($this->directory) ? '' : $this->directory;
$this->directory = trim($this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
// Get Download ID
$dlid = Platform::getInstance()->get_platform_configuration_option('update_dlid', '');
if (empty($dlid))
{
throw new BadConfiguration('You must enter your Download ID in the application configuration before using the “Upload to OneDrive” feature.');
}
$connector = new ConnectorOneDrive($access_token, $refresh_token, $dlid);
// Validate the tokens
Factory::getLog()->debug(__METHOD__ . " - Validating the OneDrive tokens");
$pingResult = $connector->ping();
// Save new configuration if there was a refresh
if ($pingResult['needs_refresh'])
{
Factory::getLog()->debug(__METHOD__ . " - OneDrive tokens were refreshed");
$config->set('engine.postproc.' . $this->settingsKey . '.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.refresh_token', $pingResult['refresh_token'], false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
return $connector;
}
protected function getOAuth2HelperUrl()
{
return ConnectorOneDrive::helperUrl;
}
}PK \ss.
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Transfer\Sftp as SftpTransfer;
use Akeeba\Engine\Util\Transfer\TransferInterface;
use RuntimeException;
class Sftp extends Ftp
{
public function __construct()
{
parent::__construct();
$this->supportsDownloadToBrowser = false;
$this->engineKey = 'engine.postproc.sftp.';
}
/**
* Return the engine configuration
*
* @return array
*/
protected function getConfig()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$host = $config->get($this->engineKey . 'host', '');
$port = $config->get($this->engineKey . 'port', 21);
$username = $config->get($this->engineKey . 'user', '');
$password = $config->get($this->engineKey . 'pass', 0);
$privKey = $config->get($this->engineKey . 'privkey', '');
$pubKey = $config->get($this->engineKey . 'pubkey', '');
$defaultDirectory = $config->get($this->engineKey . 'initial_directory', '');
$directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Process the initial directory
$directory = '/' . ltrim(trim($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
$config->set('volatile.postproc.directory', $directory);
// Try to automatically fix protocol in the hostname
if (strtolower(substr($host, 0, 7)) == 'sftp://')
{
Factory::getLog()->warning('YOU ARE *** N O T *** SUPPOSED TO ENTER THE sftp:// PROTOCOL PREFIX IN THE SFTP HOSTNAME FIELD OF THE Upload to Remote SFTP POST-PROCESSING ENGINE.');
Factory::getLog()->warning('I am trying to fix your bad configuration setting, but the backup might fail anyway. You MUST fix this in your configuration.');
$host = substr($host, 7);
}
return [
'host' => $host,
'port' => $port,
'username' => $username,
'password' => $password,
'directory' => $directory,
'privateKey' => $privKey,
'publicKey' => $pubKey,
'subdir' => null,
];
}
protected function makeConnector()
{
Factory::getLog()->debug(__CLASS__ . ':: Connecting to remote SFTP');
$options = $this->getConfig();
$sftphandle = new SftpTransfer($options);
if (!$this->sftp_chdir($options['directory'], $sftphandle))
{
throw new RuntimeException(sprintf(
"Invalid initial directory %s for the remote SFTP server",
$options['directory']
));
}
return $sftphandle;
}
/**
* Changes to the requested directory in the remote server. You give only the
* path relative to the initial directory and it does all the rest by itself,
* including doing nothing if the remote directory is the one we want. If the
* directory doesn't exist, it creates it.
*
* @param string $dir
* @param TransferInterface $sftphandle
*
* @return boolean
*/
protected function sftp_chdir($dir, &$sftphandle)
{
// Calculate "real" (absolute) SFTP path
$result = $sftphandle->isDir($dir);
if ($result === false)
{
// The directory doesn't exist, let's try to create it...
if (!$this->makeDirectory($dir, $sftphandle))
{
return false;
}
}
// Update the private "current remote directory" variable
return true;
}
/**
* Creates a nested directory structure on the remote SFTP server
*
* @param string $dir
* @param TransferInterface $sftphandle
*
* @return boolean
*/
protected function makeDirectory($dir, &$sftphandle)
{
$alldirs = explode('/', $dir);
$previousDir = '';
foreach ($alldirs as $curdir)
{
// Avoid empty dir
if (!$curdir)
{
continue;
}
$check = $previousDir . '/' . $curdir;
if (!$sftphandle->isDir($check))
{
if ($sftphandle->mkdir($check) === false)
{
throw new RuntimeException('Could not create SFTP directory ' . $check);
}
}
$previousDir = $check;
}
return true;
}
}
PK \zdq 2 vendor/akeeba/engine/engine/Postproc/Sugarsync.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\Sugarsync as ConnectorSugarsync;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Exception;
/**
* SugarSync post-processing class for Akeeba Backup
*
* @obsolete SugarSync discontinued its consumer file-sync service and its public REST API
* (https://api.sugarsync.com) is no longer generally available. This engine can therefore no longer be
* exercised against a live service, and no integration test exists for it (see GitHub issue #146). It is
* retained only so that pre-existing backup profiles do not break on load; do not target it for new backups
* and do not expect it to function. Use any of the other, actively-supported remote storage engines instead.
*/
class Sugarsync extends Base
{
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
$this->supportsDownloadToBrowser = false;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
/** @var ConnectorSugarsync $connector */
$connector = $this->getConnector();
$settings = $this->getSettings();
// Calculate relative remote filename
$filename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$directory = $settings['directory'];
if (empty($directory) || ($directory == '/'))
{
$directory = '';
}
// Store the absolute remote path in the class property
$this->remotePath = $directory . '/' . $filename;
$connector->uploadFile($directory, $filename, $localFilepath);
return true;
}
public function delete($path)
{
/** @var ConnectorSugarsync $connector */
$connector = $this->getConnector();
$connector->deleteFile($path);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset) || !is_null($length))
{
throw new RangeDownloadNotSupported();
}
/** @var ConnectorSugarsync $connector */
$connector = $this->getConnector();
$connector->downloadFile($remotePath, null, $localFile);
}
/**
* Returns the engine configuration
*
* @return array
*
* @throws Exception If something is wrong
*/
protected function getSettings()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$access = trim($config->get('engine.postproc.sugarsync.access', ''));
$private = trim($config->get('engine.postproc.sugarsync.private', ''));
$email = trim($config->get('engine.postproc.sugarsync.email', ''));
$password = trim($config->get('engine.postproc.sugarsync.password', ''));
$defaultDirectory = $config->get('engine.postproc.sugarsync.directory', '');
$directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Sanity checks
if (empty($access))
{
throw new BadConfiguration('You have not set up your SugarSync Access Key ID');
}
if (empty($private))
{
throw new BadConfiguration('You have not set up your SugarSync Private Access Key');
}
if (empty($email))
{
throw new BadConfiguration('You have not set up your SugarSync email address');
}
if (empty($password))
{
throw new BadConfiguration('You have not set up your SugarSync password');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$directory = empty($directory) ? '' : $directory;
$directory = trim($directory);
$directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
$config->set('volatile.postproc.directory', $directory);
return [
'access' => $access,
'private' => $private,
'email' => $email,
'password' => $password,
'directory' => $directory,
];
}
protected function makeConnector()
{
$settings = $this->getSettings();
return new ConnectorSugarsync($settings);
}
}
PK \:4@ @ 7 vendor/akeeba/engine/engine/Postproc/googlestorage.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_GOOGLESTORAGE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_GOOGLESTORAGE_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.googlestorage.accesskey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGEACCESSKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGEACCESSKEY_DESCRIPTION"
},
"engine.postproc.googlestorage.secretkey": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGESECRETKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGESECRETKEY_DESCRIPTION"
},
"engine.postproc.googlestorage.usessl": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGEUSESSL_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGEUSESSL_DESCRIPTION"
},
"engine.postproc.googlestorage.bucket": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGEBUCKET_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGEBUCKET_DESCRIPTION"
},
"engine.postproc.googlestorage.lowercase": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGELOWERCASE_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGELOWERCASE_DESCRIPTION"
},
"engine.postproc.googlestorage.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_GOOGLESTORAGEDIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_GOOGLESTORAGEDIRECTORY_DESCRIPTION"
}
}PK \|3 - vendor/akeeba/engine/engine/Postproc/None.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
class None extends Base
{
public function __construct()
{
// No point in breaking the step; we simply do nothing :)
$this->recommendsBreakAfter = false;
$this->recommendsBreakBefore = false;
$this->advisesDeletionAfterProcessing = false;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
// Really nothing to do!!
return true;
}
protected function makeConnector()
{
// I have to return an object to satisfy the definition.
return (object) [
'foo' => 'bar',
];
}
}
PK \$ $ 1 vendor/akeeba/engine/engine/Postproc/Sftpcurl.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Transfer\SftpCurl as SftpTransferCurl;
use RuntimeException;
class Sftpcurl extends Sftp
{
public function __construct()
{
parent::__construct();
$this->engineKey = 'engine.postproc.sftpcurl.';
}
protected function makeConnector()
{
Factory::getLog()->debug(__CLASS__ . ':: Connecting to remote SFTP');
$options = $this->getConfig();
$sftphandle = new SftpTransferCurl($options);
if (!$this->sftp_chdir($options['directory'], $sftphandle))
{
throw new RuntimeException(sprintf(
"Invalid initial directory %s for the remote SFTP server",
$options['directory']
));
}
return $sftphandle;
}
}
PK \/0/|* * 4 vendor/akeeba/engine/engine/Postproc/cloudfiles.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_CLOUDFILES_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_CLOUDFILES_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.cloudfiles.username": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_CLOUDFILESUSERNAME_TITLE",
"description": "COM_AKEEBA_CONFIG_CLOUDFILESUSERNAME_DESCRIPTION"
},
"engine.postproc.cloudfiles.apikey": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_CLOUDFILESAPIKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_CLOUDFILESAPIKEY_DESCRIPTION"
},
"engine.postproc.cloudfiles.container": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_CLOUDFILESCONTAINER_TITLE",
"description": "COM_AKEEBA_CONFIG_CLOUDFILESCONTAINER_DESCRIPTION"
},
"engine.postproc.cloudfiles.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_CLOUDFILESDIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_CLOUDFILESDIRECTORY_DESCRIPTION"
}
}PK \\}t$ $ 1 vendor/akeeba/engine/engine/Postproc/cloudme.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_CLOUDME_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_CLOUDME_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.cloudme.username": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_CLOUDME_USERNAME_TITLE",
"description": "COM_AKEEBA_CONFIG_CLOUDME_USERNAME_DESCRIPTION"
},
"engine.postproc.cloudme.password": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_CLOUDME_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_CLOUDME_PASSWORD_DESCRIPTION"
},
"engine.postproc.cloudme.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_CLOUDME_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_CLOUDME_DIRECTORY_DESCRIPTION"
}
}PK \ - vendor/akeeba/engine/engine/Postproc/ftp.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_FTP_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_FTP_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.ftp.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_HOST_DESCRIPTION"
},
"engine.postproc.ftp.port": {
"default": "21",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_PORT_DESCRIPTION"
},
"engine.postproc.ftp.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_USER_DESCRIPTION"
},
"engine.postproc.ftp.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSWORD_DESCRIPTION"
},
"engine.postproc.ftp.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_INITDIR_DESCRIPTION"
},
"engine.postproc.ftp.subdirectory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_OPTSUBDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_OPTSUBDIR_DESCRIPTION"
},
"engine.postproc.ftp.ftps": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_FTPS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_FTPS_DESCRIPTION"
},
"engine.postproc.ftp.passive_mode": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_PASSIVE_DESCRIPTION"
},
"engine.postproc.ftp.ftp_test": {
"default": "0",
"type": "button",
"hook": "postprocftp_test_connection",
"title": "COM_AKEEBA_CONFIG_POSTPROCFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCFTP_TEST_DESCRIPTION"
}
}PK \@ - vendor/akeeba/engine/engine/Postproc/Base.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\DeleteNotSupported;
use Akeeba\Engine\Postproc\Exception\DownloadToBrowserNotSupported;
use Akeeba\Engine\Postproc\Exception\DownloadToServerNotSupported;
use Akeeba\Engine\Postproc\Exception\OAuthNotSupported;
use Akeeba\Engine\Util\FileCloseAware;
use Exception;
/**
* Akeeba Engine post-processing abstract class. Provides the default implementation of most of the PostProcInterface
* methods.
*/
abstract class Base implements PostProcInterface
{
use FileCloseAware;
/**
* Should we break the step before post-processing?
*
* The only engine which does not require a step break before is the None engine.
*
* @var bool
*/
protected $recommendsBreakBefore = true;
/**
* Should we break the step after post-processing?
*
* @var bool
*/
protected $recommendsBreakAfter = true;
/**
* Does this engine processes the files in a way that makes deleting the originals safe?
*
* @var bool
*/
protected $advisesDeletionAfterProcessing = true;
/**
* Does this engine support remote file deletes?
*
* @var bool
*/
protected $supportsDelete = false;
/**
* Does this engine support downloads to files?
*
* @var bool
*/
protected $supportsDownloadToFile = false;
/**
* Does this engine support downloads to browser?
*
* @var bool
*/
protected $supportsDownloadToBrowser = false;
/**
* Does this engine push raw data to the browser when downloading a file?
*
* Set to true if raw data will be dumped to the browser when downloading the file to the browser. Set to false if
* a URL is returned instead.
*
* @var bool
*/
protected $inlineDownloadToBrowser = false;
/**
* The remote absolute path to the file which was just processed. Leave null if the file is meant to
* be non-retrievable, i.e. sent to email or any other one way service.
*
* @var string
*/
protected $remotePath = null;
/**
* Whitelist of method names you can call using customAPICall().
*
* @var array
*/
protected $allowedCustomAPICallMethods = ['oauthCallback'];
/**
* The connector object for this post-processing engine
*
* @var object|null
*/
private $connector;
public function delete($path)
{
throw new DeleteNotSupported();
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
throw new DownloadToServerNotSupported();
}
public function downloadToBrowser($remotePath)
{
throw new DownloadToBrowserNotSupported();
}
public final function customAPICall($method, $params = [])
{
if (!in_array($method, $this->allowedCustomAPICallMethods) || !method_exists($this, $method))
{
header('HTTP/1.0 501 Not Implemented');
exit();
}
return call_user_func_array([$this, $method], [$params]);
}
public function oauthOpen($params = [])
{
$callback = $params['callbackURI'] . '&method=oauthCallback';
$url = $this->getOAuth2HelperUrl();
$url .= (strpos($url, '?') !== false) ? '&' : '?';
$url .= 'callback=' . urlencode($callback);
$url .= '&dlid=' . urlencode(Platform::getInstance()->get_platform_configuration_option('update_dlid', ''));
Platform::getInstance()->redirect($url);
}
/**
* Fetches the authentication token from the OAuth helper script, after you've run the first step of the OAuth
* authentication process. Must be overridden in subclasses.
*
* @param array $params
*
* @return void
*
* @throws OAuthNotSupported
*/
public function oauthCallback(array $params)
{
throw new OAuthNotSupported();
}
public function recommendsBreakBefore()
{
return $this->recommendsBreakBefore;
}
public function recommendsBreakAfter()
{
return $this->recommendsBreakAfter;
}
public function isFileDeletionAfterProcessingAdvisable()
{
return $this->advisesDeletionAfterProcessing;
}
public function supportsDelete()
{
return $this->supportsDelete;
}
public function supportsDownloadToFile()
{
return $this->supportsDownloadToFile;
}
public function supportsDownloadToBrowser()
{
return $this->supportsDownloadToBrowser;
}
public function doesInlineDownloadToBrowser()
{
return $this->inlineDownloadToBrowser;
}
public function getRemotePath()
{
return $this->remotePath;
}
/**
* Returns the URL to the OAuth2 helper script. Used by the oauthOpen method. Must be overridden in subclasses.
*
* @return string
*
* @throws OAuthNotSupported
*/
protected function getOAuth2HelperUrl()
{
throw new OAuthNotSupported();
}
/**
* Returns an instance of the connector object.
*
* @param bool $forceNew Should I force the creation of a new connector object?
*
* @return object The connector object
*
* @throws BadConfiguration If there is a configuration error which prevents creating a connector object.
* @throws Exception
*/
final protected function getConnector($forceNew = false)
{
if ($forceNew)
{
$this->resetConnector();
}
if (empty($this->connector))
{
$this->connector = $this->makeConnector();
}
return $this->connector;
}
/**
* Resets the connector.
*
* If the connector requires any special handling upon destruction you must handle it in its __destruct method.
*
* @return void
*/
final protected function resetConnector()
{
$this->connector = null;
}
/**
* Creates a new connector object based on the engine configuration stored in the backup profile.
*
* Do not use this method directly. Use getConnector() instead.
*
* @return object The connector object
*
* @throws BadConfiguration If there is a configuration error which prevents creating a connector object.
* @throws Exception Any other error when creating or initializing the connector object.
*/
protected abstract function makeConnector();
}
PK \t E vendor/akeeba/engine/engine/Postproc/Exception/DeleteNotSupported.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Exception;
defined('AKEEBAENGINE') || die();
/**
* Indicates that the post-processing engine does not support deleting remotely stored files.
*/
class DeleteNotSupported extends EngineException
{
protected $messagePrototype = 'The %s post-processing engine does not support deletion of backup archives.';
}
PK \o L vendor/akeeba/engine/engine/Postproc/Exception/RangeDownloadNotSupported.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Exception;
defined('AKEEBAENGINE') || die();
/**
* Indicates that the post-processing engine does not support range downloads.
*/
class RangeDownloadNotSupported extends EngineException
{
protected $messagePrototype = 'The %s post-processing engine does not support range downloads of backup archives to the server.';
}
PK \|~u P vendor/akeeba/engine/engine/Postproc/Exception/DownloadToBrowserNotSupported.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Exception;
defined('AKEEBAENGINE') || die();
/**
* Indicates that the post-processing engine does not support downloading remotely stored files to the user's browser.
*/
class DownloadToBrowserNotSupported extends EngineException
{
protected $messagePrototype = 'The %s post-processing engine does not support downloading of backup archives to the browser.';
}
PK \D,ʴ O vendor/akeeba/engine/engine/Postproc/Exception/DownloadToServerNotSupported.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Exception;
defined('AKEEBAENGINE') || die();
/**
* Indicates that the post-processing engine does not support downloading remotely stored files to the server
*/
class DownloadToServerNotSupported extends EngineException
{
protected $messagePrototype = 'The %s post-processing engine does not support downloading of backup archives to the server.';
}
PK \߸5 D vendor/akeeba/engine/engine/Postproc/Exception/OAuthNotSupported.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Exception;
defined('AKEEBAENGINE') || die();
/**
* Indicates that the post-processing engine does not support OAuth2 or similar redirection-based authentication with
* the remote storage provider.
*/
class OAuthNotSupported extends EngineException
{
protected $messagePrototype = 'The %s post-processing engine does not support opening an authentication window to the remote storage provider.';
}
PK \E=W C vendor/akeeba/engine/engine/Postproc/Exception/BadConfiguration.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Exception;
defined('AKEEBAENGINE') || die();
use RuntimeException;
/**
* Indicates an error with the post-processing engine's configuration
*/
class BadConfiguration extends RuntimeException
{
}
PK \-G G B vendor/akeeba/engine/engine/Postproc/Exception/EngineException.phpnu [ .
*/
namespace Akeeba\Engine\Postproc\Exception;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\Base;
use Exception;
use RuntimeException;
use Throwable;
class EngineException extends RuntimeException
{
protected $messagePrototype = 'The %s post-processing engine has experienced an unspecified error.';
/**
* Construct the exception. If a message is not defined the default message for the exception will be used.
*
* @param string $message [optional] The Exception message to throw.
* @param int $code [optional] The Exception code.
* @param Exception|Throwable $previous [optional] The previous throwable used for the exception chaining.
*/
public function __construct($message = "", $code = 0, $previous = null)
{
if (empty($message))
{
$engineName = $this->getEngineKeyFromBacktrace();
$message = sprintf($this->messagePrototype, $engineName);
}
parent::__construct($message, $code, $previous);
}
/**
* Returns the engine name (class name without the namespace) from the PHP execution backtrace.
*
* @return mixed|string
*/
protected function getEngineKeyFromBacktrace()
{
// Make sure the backtrace is at least 3 levels deep
$backtrace = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT, 5);
// We need to be at least two levels deep
if (count($backtrace) < 2)
{
return 'current';
}
for ($i = 1; $i < count($backtrace); $i++)
{
// Get the fully qualified class
$object = $backtrace[$i]['object'];
// We need a backtrace element with an object attached.
if (!is_object($object))
{
continue;
}
// If the object is not a Postproc\Base object go to the next entry.
if (!($object instanceof Base))
{
continue;
}
// Get the bare class name
$fqnClass = $backtrace[$i]['class'];
$parts = explode('\\', $fqnClass);
$bareClass = array_pop($parts);
// Do not return the base object!
if ($bareClass == 'Base')
{
continue;
}
return $bareClass;
}
return 'current';
}
}
PK \Sʉ 8 vendor/akeeba/engine/engine/Postproc/Exception/.htaccessnu 7m
Order allow,deny
Deny from all
PK \d*7 7 : vendor/akeeba/engine/engine/Postproc/Googlestoragejson.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\GoogleStorage as ConnectorGoogleStorage;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Exception;
use RuntimeException;
class Googlestoragejson extends Base
{
/**
* The retry count of this file (allow up to 2 retries after the first upload failure)
*
* @var int
*/
private $tryCount = 0;
/**
* The currently configured bucket
*
* @var string
*/
private $bucket;
/**
* The currently configured directory
*
* @var string
*/
private $directory;
/**
* Are we using chunk uploads?
*
* @var bool
*/
private $isChunked = false;
/**
* Chunk size (MB)
*
* @var int
*/
private $chunkSize = 10;
/**
* The decoded Google Cloud JSON configuration file
*
* @var array
*/
private $config = [];
public function __construct()
{
$this->supportsDownloadToBrowser = false;
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
if ($this->tryCount >= 2)
{
throw new RuntimeException(sprintf(
"%s - Maximum number of retries exceeded. The upload has failed. Check the log file for more information.",
__METHOD__
), 500);
}
// Do NOT remove. This is necessary to set up $this->directory used below.
/** @var ConnectorGoogleStorage $connector */
$connector = $this->getConnector();
/**
* Store the absolute remote path in the object property.
*
* Something interesting. When the directory is empty (saving at the bucket's root) we MUST NOT use a slash
* prefix. This means that the remotePath /foobar.jpa IS WRONG. The correct is foobar.jpa without a leading
* slash. Hence the $directoryGlue variable below.
*/
$directory = $this->directory;
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$directoryGlue = empty($directory) ? '' : '/';
$this->remotePath = $directory . $directoryGlue . $basename;
// Get a reference to the engine configuration
$config = Factory::getConfiguration();
// Check if the size of the file is compatible with chunked uploading
clearstatcache();
$totalSize = filesize($localFilepath);
$isBigEnough = $this->isChunked ? ($totalSize > $this->chunkSize) : false;
// Chunked uploads if the feature is enabled and the file is at least as big as the chunk size.
if ($this->isChunked && $isBigEnough)
{
return $this->multipartUpload($localFilepath, $totalSize);
}
// Single part upload
return $this->simpleUpload($localFilepath);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset))
{
// Ranges are not supported
throw new RangeDownloadNotSupported();
}
/** @var ConnectorGoogleStorage $connector */
$connector = $this->getConnector();
// Download the file
$connector->download($this->bucket, $remotePath, $localFile);
}
public function delete($path)
{
/** @var ConnectorGoogleStorage $connector */
$connector = $this->getConnector();
$connector->delete($this->bucket, $path, true);
}
protected function makeConnector()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
// Try to load and parse the Google JSON configuration
$this->parseJsonConfig();
$this->isChunked = $config->get('engine.postproc.googlestoragejson.chunk_upload', true);
$this->chunkSize = $config->get('engine.postproc.googlestoragejson.chunk_upload_size', 10) * 1024 * 1024;
$this->bucket = $config->get('engine.postproc.googlestoragejson.bucket', null);
$defaultDirectory = $config->get('engine.postproc.googlestoragejson.directory', '');
$this->directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Environment checks
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
if (!function_exists('openssl_sign') || !function_exists('openssl_get_md_methods'))
{
throw new BadConfiguration('The PHP module for OpenSSL integration is not enabled or openssl_sign() is disabled. Please contact your host and ask them to fix this issue for the version of PHP you are currently using on your site (PHP reports itself as version ' . PHP_VERSION . ').');
}
$openSSLAlgos = openssl_get_md_methods(true);
if (!in_array('sha256WithRSAEncryption', $openSSLAlgos))
{
throw new BadConfiguration('The PHP module for OpenSSL integration does not support the sha256WithRSAEncryption signature algorithm. Please ask your host to compile BOTH a newer version of the OpenSSL library AND the OpenSSL module for PHP against this (new) OpenSSL library for the version of PHP you are currently using on your site (PHP reports itself as version ' . PHP_VERSION . ').');
}
// Fix the directory name, if required
$this->directory = empty($this->directory) ? '' : $this->directory;
$this->directory = trim($this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
return new ConnectorGoogleStorage($this->config['client_email'], $this->config['private_key']);
}
/**
* Tries to read the Google Cloud JSON credentials from the configuration.
*
* @return void
*
* @throws RuntimeException If the JSON credentials are missing or can not be parsed.
*/
private function parseJsonConfig()
{
$config = Factory::getConfiguration();
$hasJsonConfig = false;
$jsonConfig = trim($config->get('engine.postproc.googlestoragejson.jsoncreds', ''));
$jsonConfig = $this->fixStoredJSON($jsonConfig);
if (!empty($jsonConfig))
{
$hasJsonConfig = true;
$this->config = @json_decode($jsonConfig, true);
}
if (empty($this->config))
{
$hasJsonConfig = false;
}
if ($hasJsonConfig && (
!isset($this->config['type']) ||
!isset($this->config['project_id']) ||
!isset($this->config['private_key']) ||
!isset($this->config['client_email'])
)
)
{
$hasJsonConfig = false;
}
if ($hasJsonConfig && (
($this->config['type'] != 'service_account') ||
(empty($this->config['project_id'])) ||
(empty($this->config['private_key'])) ||
(empty($this->config['client_email']))
)
)
{
$hasJsonConfig = false;
}
if (!$hasJsonConfig)
{
$this->config = [];
throw new RuntimeException('You have not provided a valid Google Cloud JSON configuration (googlestorage.json) in the configuration page. As a result I cannot connect to Google Storage.');
}
}
/**
* The Google JSON API file has the string literal "\n" inside the Private Key. However, the INI parser will
* unescape this into a newline character. This causes a newline character to appear inside a string literal in the
* JSON file, therefore rendering the JSON invalid.
*
* Before Akeeba Engine 6.3.4 we used to deal with that by using the PHP INI parser in INI_SCANNER_NORMAL mode.
* However, this caused some problems, e.g. with the sequence \$ being squashed to $. The correct solution is using
* INI_SCANNER_RAW. However, this does not expand \n in values which is something we need elsewhere in the Engine.
*
* We needed to do this because before 6.3.4 if your server had disabled parse_ini_string our PHP-based parser would
* yield different results than calling PHP's parse_ini_file(). This also meant that on these hosts Google Storage
* JSON API was broken.
*
* The only solution is having this method which recodes the private key in a way that the JSON is valid and the
* private key is also usable with Google's API.
*
* @param string $jsonConfig
*
* @return string
*/
private function fixStoredJSON($jsonConfig)
{
// Remove all newlines
$jsonConfig = str_replace("\n", '', $jsonConfig);
// Extract the private key
$startPos = strpos($jsonConfig, '-----BEGIN PRIVATE KEY-----');
$endPos = strpos($jsonConfig, '-----END PRIVATE KEY-----') + 25;
$pk = substr($jsonConfig, $startPos, $endPos - $startPos);
// Recode the private key
$innerPK = trim(substr($pk, 27, -25));
$innerPK = implode("\\n", str_split($innerPK, 64));
$pk = "-----BEGIN PRIVATE KEY-----\\n" . $innerPK . "\\n-----END PRIVATE KEY-----";
$pk = str_replace("\\n\\n", "\\n", $pk);
// Assemble a usable JSON string
return rtrim(substr($jsonConfig, 0, $startPos)) . $pk . ltrim(substr($jsonConfig, $endPos));
}
/**
* Performs a multipart (chunked) upload.
*
* @param string $localFilepath The path to the local file we'll be uploading.
* @param int $totalSize The total size of the file, in bytes.
*
* @return bool True if the upload is complete, false if more work is necessary
* @throws Exception If an upload error occurs
*/
private function multipartUpload($localFilepath, $totalSize)
{
/** @var ConnectorGoogleStorage $connector */
$connector = $this->getConnector();
// Get a reference to the engine configuration
$config = Factory::getConfiguration();
Factory::getLog()->debug(sprintf(
"%s - Using chunked upload, part size %d",
__METHOD__, $this->chunkSize
));
$offset = $config->get('volatile.engine.postproc.googlestoragejson.offset', 0);
$upload_id = $config->get('volatile.engine.postproc.googlestoragejson.upload_id', null);
if (empty($upload_id))
{
Factory::getLog()->debug(sprintf(
"%s - Creating new upload session",
__METHOD__
));
try
{
$storageClass = $config->get('engine.postproc.googlestoragejson.storageclass', null, false);
$upload_id = $connector->createUploadSession($this->bucket, $this->remotePath, $localFilepath, $storageClass);
}
catch (Exception $e)
{
// Note: do not pass the parent exception; it's a simple RuntimeException
throw new RuntimeException(sprintf("The upload session for remote file %s cannot be created", $this->remotePath));
}
Factory::getLog()->debug(sprintf(
"%s - New upload session $upload_id",
__METHOD__
));
$config->set('volatile.engine.postproc.googlestoragejson.upload_id', $upload_id);
}
try
{
if (empty($offset))
{
$offset = 0;
}
Factory::getLog()->debug(sprintf(
"%s - Uploading chunked part",
__METHOD__
));
$result = $connector->uploadPart($upload_id, $localFilepath, $offset, $this->chunkSize);
Factory::getLog()->debug(sprintf(
"%s - Got uploadPart result %s",
__METHOD__, print_r($result, true)
));
}
catch (Exception $e)
{
Factory::getLog()->debug(sprintf(
"%s - Got uploadPart Exception %s: %s",
__METHOD__, $e->getCode(), $e->getMessage()
));
// Let's retry
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
throw new RuntimeException(sprintf(
"%s - Maximum number of retries exceeded. The upload has failed.",
__METHOD__
), 500, $e);
}
Factory::getLog()->debug(sprintf(
"%s - Error detected, retrying chunk upload",
__METHOD__
));
return false;
}
// Are we done uploading?
$nextOffset = $offset + $this->chunkSize - 1;
if (isset($result['name']) || ($nextOffset > $totalSize))
{
Factory::getLog()->debug(sprintf(
"%s - Chunked upload is now complete", __METHOD__
));
$config->set('volatile.engine.postproc.googlestoragejson.offset', null);
$config->set('volatile.engine.postproc.googlestoragejson.upload_id', null);
$this->tryCount = 0;
return true;
}
// Otherwise, continue uploading
$config->set('volatile.engine.postproc.googlestoragejson.offset', $offset + $this->chunkSize);
return false;
}
/**
* Performs a single part upload
*
* @param string $localFilepath
*
* @return bool True if the upload is complete, false if more work is necessary
* @throws Exception If an upload error occurs
*/
private function simpleUpload($localFilepath)
{
/** @var ConnectorGoogleStorage $connector */
$connector = $this->getConnector();
try
{
Factory::getLog()->debug(sprintf("%s - Performing simple upload.", __METHOD__));
$storageClass = Factory::getConfiguration()->get('engine.postproc.googlestoragejson.storageclass', null, false);
$connector->simpleUpload($this->bucket, $this->remotePath, $localFilepath, $storageClass);
}
catch (Exception $e)
{
Factory::getLog()->debug(sprintf("%s - Simple upload failed, %s: %s", __METHOD__, $e->getCode(), $e->getMessage()));
// Let's retry
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
throw new RuntimeException(sprintf("%s - Maximum number of retries exceeded. The upload has failed.", __METHOD__), 500, $e);
}
Factory::getLog()->debug(sprintf("%s - Error detected, retrying upload", __METHOD__));
return false;
}
// Upload complete. Reset the retry counter.
$this->tryCount = 0;
return true;
}
}
PK \-F F 1 vendor/akeeba/engine/engine/Postproc/Dropbox2.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Configuration;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Connector\Dropbox2 as ConnectorDropboxV2;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Exception;
use RuntimeException;
class Dropbox2 extends Base
{
/**
* The retry count of this file (allow up to 2 retries after the first upload failure)
*
* @var int
*/
private $tryCount = 0;
/**
* The currently configured directory
*
* @var string
*/
private $directory;
/**
* Are we using chunk uploads?
*
* @var bool
*/
private $chunked = false;
/**
* Chunk size (MB)
*
* @var int
*/
private $chunk_size = 10;
public function __construct()
{
$this->supportsDownloadToBrowser = true;
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
}
public function oauthCallback(array $params)
{
$input = $params['input'];
$data = (object) [
'access_token' => $input['access_token'],
'refresh_token' => $input['refresh_token'],
];
$serialisedData = json_encode($data);
return <<< HTML
HTML;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
/** @var ConnectorDropboxV2 $connector */
$connector = $this->getConnector();
$config = Factory::getConfiguration();
// Store the absolute remote path in the class property
$directory = $this->directory;
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$this->remotePath = $directory . '/' . $basename;
// Have I already made sure the remote directory exists?
$haveCheckedRemoteDirectory = $config->get('volatile.engine.postproc.dropbox2.check_directory', 0);
if (!$haveCheckedRemoteDirectory)
{
try
{
$this->pingAndPersist($connector);
$connector->makeDirectory($directory);
$config->set('volatile.engine.postproc.dropbox2.check_directory', 1);
}
catch (Exception $e)
{
throw new RuntimeException(sprintf("Could not create Dropbox directory %s.", $directory), 500, $e);
}
}
// Get the remote file's pathname. Use the resolved $basename (which honours an explicit $remoteBaseName) rather
// than re-deriving it from the local file path; otherwise the file is stored under the local (temporary) file
// name and every subsequent lookup (download, delete, metadata, listing) by the reported remote path fails.
$remotePath = trim($directory, '/') . '/' . $basename;
// Check if the size of the file is compatible with chunked uploading
clearstatcache();
$totalSize = filesize($localFilepath);
$isBigEnough = $this->chunked ? ($totalSize > $this->chunk_size) : false;
// Chunked uploads if the feature is enabled and the file is at least as big as the chunk size.
if ($this->chunked && $isBigEnough)
{
return $this->processPartChunked($config, $localFilepath, $remotePath, $totalSize);
}
// Single part upload
return $this->processPartSingleUpload($localFilepath, $remotePath);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
/** @var ConnectorDropboxV2 $connector */
$connector = $this->getConnector();
if (!is_null($fromOffset))
{
throw new RangeDownloadNotSupported();
}
// Download the file
$this->pingAndPersist($connector);
$connector->download($remotePath, $localFile);
return true;
}
public function downloadToBrowser($remotePath)
{
/** @var ConnectorDropboxV2 $connector */
$connector = $this->getConnector();
$this->pingAndPersist($connector);
return $connector->getAuthenticatedUrl($remotePath);
}
public function delete($path)
{
/** @var ConnectorDropboxV2 $connector */
$connector = $this->getConnector();
$this->pingAndPersist($connector);
$connector->delete($path);
}
protected function getOAuth2HelperUrl()
{
$config = Factory::getConfiguration();
$oauth2HelperType = $config->get('engine.postproc.dropbox2.oauth2_type', 'akeeba');
switch ($oauth2HelperType)
{
case 'custom':
return $config->get('engine.postproc.dropbox2.oauth2_helper', '');
default:
return ConnectorDropboxV2::helperUrl;
}
}
/**
* Returns the Dropbox configuration settings
*
* @return array
*/
protected function getSettings()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$accessToken = trim($config->get('engine.postproc.dropbox2.access_token', ''));
$refreshToken = trim($config->get('engine.postproc.dropbox2.refresh_token', ''));
$this->chunked = $config->get('engine.postproc.dropbox2.chunk_upload', true);
$this->chunk_size = $config->get('engine.postproc.dropbox2.chunk_upload_size', 10) * 1024 * 1024;
$defaultDirectory = $config->get('engine.postproc.dropbox2.directory', '');
$this->directory = $config->get('volatile.postproc.directory', $defaultDirectory);
// Sanity checks
$dlid = Platform::getInstance()->get_platform_configuration_option('update_dlid', '');
if (empty($dlid))
{
throw new BadConfiguration('You must enter your Download ID in the application configuration before using the “Upload to Dropbox” feature.');
}
if (empty($accessToken) && empty($refreshToken))
{
throw new BadConfiguration('You have not linked Akeeba Backup with your Dropbox account');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
/**
* Remove the trailing and leading slashes from the directory. Why? The directory must never have a trailing
* slash. The directory must have a leading slash UNLESS it's the root, in which case it needs to be normalized
* to an empty string. So we first remove leading & trailing slashes, then check if it's empty (root) or not.
*
* Then remove any leftover leading/trailing slash. They will produce an invalid path in Dropbox. However, if
* the directory is not empty we must prefix it with a leading slash.
*/
$this->directory = trim($this->directory, '/');
$this->directory = trim($this->directory);
$this->directory = empty($this->directory) ? '' : ('/' . $this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
return [
'token' => $accessToken,
'refresh_token' => $refreshToken,
'dlid' => $dlid,
];
}
protected function makeConnector()
{
// Do we have a cached root namespace ID?
$configuration = Factory::getConfiguration();
$namespaceId = $configuration->get('volatile.engine.postproc.dropbox2.namespaceId', null);
// Get and cache the root namespace ID.
if (is_null($namespaceId))
{
$namespaceId = $this->getDropboxForBusinessRootNamespaceId();
$configuration->set('volatile.engine.postproc.dropbox2.namespaceId', $namespaceId);
}
$config = $this->getSettings();
$connector = new ConnectorDropboxV2(
$config['token'],
$config['refresh_token'],
$config['dlid'],
Factory::getConfiguration()->get('engine.postproc.dropbox2.oauth2_refresh')
);
$connector->setNamespaceId($namespaceId);
// Restore the persisted access-token expiry so the connector can refresh proactively (before the token lapses)
// across stepped backup runs, instead of only reacting after a request has already failed.
$connector->setTokenExpiration((int) Factory::getConfiguration()->get('engine.postproc.dropbox2.token_expiration', 0));
return $connector;
}
/**
* Ping the connector (refreshing the access token if needed) and persist any refreshed tokens back to the profile
* configuration, so the next backup step starts from the fresh tokens and their known expiry instead of refreshing
* again from scratch.
*
* @param ConnectorDropboxV2 $connector The connector to ping.
*
* @return void
*/
protected function pingAndPersist($connector)
{
$pingResult = $connector->ping();
if (empty($pingResult['needs_refresh']) || !isset($pingResult['access_token']))
{
return;
}
$config = Factory::getConfiguration();
$config->set('engine.postproc.dropbox2.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.dropbox2.refresh_token', $pingResult['refresh_token'], false);
$config->set('engine.postproc.dropbox2.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
/**
* Forcibly refresh the Dropbox tokens
*
* @param ConnectorDropboxV2|null $connector The connector to use
*
* @return void
*
* @throws Exception
*/
protected function forceRefreshTokens($connector = null)
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
/** @var ConnectorDropboxV2 $connector */
if (empty($connector))
{
$connector = $this->getConnector();
}
$pingResult = $connector->ping(true);
Factory::getLog()->debug(__METHOD__ . " - Dropbox tokens were forcibly refreshed");
$config->set('engine.postproc.dropbox2.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.dropbox2.refresh_token', $pingResult['refresh_token'], false);
$config->set('engine.postproc.dropbox2.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
/**
* Returns the root namespace for the Dropbox for Business team space
*
* @see https://www.dropbox.com/developers/reference/namespace-guide
*
* @param bool $refreshTokensOnFailure Should I try to forcibly update the token on connection failure?
*
* @return string
* @throws Exception
*/
private function getDropboxForBusinessRootNamespaceId($refreshTokensOnFailure = true)
{
// Do I need to use a folder under a team space?
$configuration = Factory::getConfiguration();
$useTeam = $configuration->get('engine.postproc.dropbox2.team', 0) == 1;
// Team space is not in use. Default to the user's home (same as the legacy behavior)
if (!$useTeam)
{
return '';
}
// Try to get the current account information
try
{
$config = $this->getSettings();
$connector = new ConnectorDropboxV2($config['token'], $config['refresh_token'], $config['dlid']);
$currentAccount = $connector->getCurrentAccount();
}
catch (Exception $e)
{
if ($refreshTokensOnFailure)
{
$this->forceRefreshTokens($connector);
return $this->getDropboxForBusinessRootNamespaceId(false);
}
throw new ErrorException("Cannot connect to Dropbox for Business", 0, $e);
}
if (
!is_array($currentAccount)
|| !array_key_exists('root_info', $currentAccount)
|| !is_array($currentAccount['root_info'])
|| !array_key_exists('root_namespace_id', $currentAccount['root_info'])
)
{
throw new ErrorException("Dropbox for Business did not return any user account information");
}
return $currentAccount['root_info']['root_namespace_id'];
}
/**
* Handles the multipart upload of a file to Dropbox
*
* @param Configuration $config
* @param string $absolute_filename
* @param string $remotePath
* @param int $totalSize
*
* @return bool
*
* @throws Exception
*/
private function processPartChunked(Configuration $config, $absolute_filename, $remotePath, $totalSize)
{
/** @var ConnectorDropboxV2 $connector */
$connector = $this->getConnector();
// Are we already processing a multipart upload?
Factory::getLog()->debug(sprintf(
"%s - Using chunked upload, part size {$this->chunk_size}", __METHOD__
));
$offset = $config->get('volatile.engine.postproc.dropbox2.offset', 0);
$upload_id = $config->get('volatile.engine.postproc.dropbox2.upload_id', null);
if (empty($upload_id))
{
Factory::getLog()->debug(sprintf(
"%s - Creating new upload session", __METHOD__
));
try
{
$upload_id = $connector->createUploadSession();
}
catch (Exception $e)
{
// Fail immediately if there is no refresh token
$config = $this->getSettings();
if (empty($config['refresh_token']))
{
throw new RuntimeException("Cannot create upload session", 500, $e);
}
Factory::getLog()->debug(sprintf(
"%s - Failed to create a new upload session; will try to refresh the tokens first",
__METHOD__
));
$upload_id = null;
}
if (is_null($upload_id))
{
try
{
$this->forceRefreshTokens();
$upload_id = $connector->createUploadSession();
}
catch (Exception $e)
{
throw new RuntimeException("Cannot create upload session", 500, $e);
}
}
Factory::getLog()->debug(sprintf(
"%s - New upload session $upload_id", __METHOD__
));
$config->set('volatile.engine.postproc.dropbox2.upload_id', $upload_id);
}
$exception = null;
try
{
if (empty($offset))
{
$offset = 0;
}
Factory::getLog()->debug(sprintf("%s - Uploading chunked part", __METHOD__));
$connector->uploadPart($upload_id, $absolute_filename, $offset, $this->chunk_size);
$result = true;
}
catch (Exception $e)
{
Factory::getLog()->debug(sprintf(
"%s - Got uploadPart Exception %s: %s",
__METHOD__, 500, $e->getMessage())
);
$exception = $e;
$result = false;
}
// Did we fail uploading?
if ($result === false)
{
// Let's retry
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
throw new RuntimeException(sprintf(
"%s - Maximum number of retries exceeded. The upload has failed.",
__METHOD__
), 500, $exception);
}
// Retry to refresh the Access Token if a Refresh Token is provided.
$config = $this->getSettings();
if (!empty($config['refresh_token']))
{
Factory::getLog()->debug(sprintf(
"%s - Error detected, trying to force-refresh the tokens",
__METHOD__
));
$this->forceRefreshTokens();
}
Factory::getLog()->debug(sprintf("%s - Retrying chunk upload", __METHOD__));
return false;
}
// Are we done uploading?
$nextOffset = $offset + $this->chunk_size - 1;
if (isset($result['name']) || ($nextOffset > $totalSize))
{
Factory::getLog()->debug(sprintf(
"%s - Finializing chunked upload, saving uploaded file as %s",
__METHOD__, $remotePath
));
try
{
$connector->finishUploadSession($upload_id, $remotePath, $totalSize);
}
catch (Exception $e)
{
throw new RuntimeException('Chunk upload finalization failed', 500, $e);
}
Factory::getLog()->debug(sprintf(
"%s - Chunked upload is now complete",
__METHOD__
));
$config->set('volatile.engine.postproc.dropbox2.offset', null);
$config->set('volatile.engine.postproc.dropbox2.upload_id', null);
return true;
}
// Otherwise, continue uploading
$config->set('volatile.engine.postproc.dropbox2.offset', $offset + $this->chunk_size);
return false;
}
/**
* Handles the single part upload of a file to Dropbox
*
* @param string $absolute_filename
* @param string $remotePath
*
* @return bool
*
* @throws Exception
*/
private function processPartSingleUpload($absolute_filename, $remotePath)
{
/** @var ConnectorDropboxV2 $connector */
$connector = $this->getConnector();
$exception = null;
try
{
Factory::getLog()->debug(sprintf(
"%s - Performing simplified upload of %s to %s",
__METHOD__, $absolute_filename, $remotePath
));
$result = $connector->upload($remotePath, $absolute_filename);
}
catch (Exception $e)
{
Factory::getLog()->debug(sprintf(
"%s - Simplified upload failed, %s: %s",
__METHOD__, $e->getCode(), $e->getMessage()
));
$exception = $e;
$result = false;
}
if ($result === false)
{
// Let's retry
$this->tryCount++;
// However, if we've already retried twice, we stop retrying and call it a failure
if ($this->tryCount > 2)
{
throw new RuntimeException(sprintf(
"%s - Maximum number of retries exceeded. The upload has failed.",
__METHOD__
), 500, $exception);
}
// Retry to refresh the Access Token if a Refresh Token is provided.
$config = $this->getSettings();
if (!empty($config['refresh_token']))
{
Factory::getLog()->debug(sprintf(
"%s - Error detected, trying to force-refresh the tokens",
__METHOD__
));
$this->forceRefreshTokens();
}
Factory::getLog()->debug(sprintf("%s - Retrying upload", __METHOD__));
return false;
}
// Upload complete. Reset the retry counter.
$this->tryCount = 0;
return true;
}
}
PK \bV V , vendor/akeeba/engine/engine/Postproc/Ovh.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\Ovh as OvhConnector;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Exception;
/**
* A post processing engine used to upload files to OVH object storage
*/
class Ovh extends Base
{
/**
* Public constructor. Initialises the advertised properties of this processing engine
*/
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
$this->supportsDownloadToBrowser = false;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
/** @var OvhConnector $connector */
$connector = $this->getConnector();
$settings = $this->getSettings();
// Calculate relative remote filename
$filename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$directory = $settings['directory'];
if (!empty($directory) && ($directory != '/'))
{
$filename = $directory . '/' . $filename;
}
// Store the absolute remote path in the class property
$this->remotePath = $filename;
// Upload the file
Factory::getLog()->debug(sprintf("Uploading %s", basename($localFilepath)));
$input = [
'file' => $localFilepath,
];
$connector->putObject($input, $filename, 'application/octet-stream');
return true;
}
public function delete($path)
{
/** @var OvhConnector $connector */
$connector = $this->getConnector();
$connector->deleteObject($path);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
/** @var OvhConnector $connector */
$connector = $this->getConnector();
// Do we need to set a range header?
$headers = [];
if (!is_null($fromOffset) && is_null($length))
{
$headers['Range'] = 'bytes=' . $fromOffset;
}
elseif (!is_null($fromOffset) && !is_null($length))
{
$headers['Range'] = 'bytes=' . $fromOffset . '-' . ($fromOffset + $length - 1);
}
elseif (!is_null($length))
{
$headers['Range'] = 'bytes=0-' . ($fromOffset + $length);
}
if (!empty($headers))
{
Factory::getLog()->debug(sprintf("Sending Range header «%s»", $headers['Range']));
}
$fp = @fopen($localFile, 'w');
if ($fp === false)
{
throw new Exception(sprintf("Can't open %s for writing", $localFile));
}
Factory::getLog()->debug(sprintf("Downloading %s", $remotePath));
try
{
$connector->downloadObject($remotePath, $fp, $headers);
}
finally
{
$this->conditionalFileClose($fp);
}
}
/**
* Returns the post-processing engine settings in array format. If something is amiss it returns boolean false.
*
* @return array
*
* @throws Exception
*/
protected function getSettings()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$projectid = trim($config->get('engine.postproc.ovh.projectid', ''));
$username = trim($config->get('engine.postproc.ovh.username', ''));
$password = trim($config->get('engine.postproc.ovh.password', ''));
$containerurl = $config->get('engine.postproc.ovh.containerurl', 0);
$directory = $config->get('volatile.postproc.directory', null);
if (empty($directory))
{
$directory = $config->get('engine.postproc.ovh.directory', 0);
}
// Sanity checks
if (empty($projectid))
{
throw new BadConfiguration('You have not set up your OVH Project ID');
}
if (empty($username))
{
throw new BadConfiguration('You have not set up your OVH OpenStack Username');
}
if (empty($password))
{
throw new BadConfiguration('You have not set up your OVH OpenStack Password');
}
if (empty($containerurl))
{
throw new BadConfiguration('You have not set up your Container URL');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$directory = empty($directory) ? '' : $directory;
$directory = trim($directory);
$directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
$config->set('volatile.postproc.directory', $directory);
return [
'projectid' => $projectid,
'username' => $username,
'password' => $password,
'containerurl' => $containerurl,
'directory' => $directory,
];
}
protected function makeConnector()
{
$settings = $this->getSettings();
// Create the API connector object
$connector = new OvhConnector($settings['projectid'], $settings['username'], $settings['password']);
$connector->setStorageEndpoint($settings['containerurl']);
Factory::getLog()->debug('Authenticating to OVH');
// Authenticate
$connector->getToken();
return $connector;
}
}
PK \[ 0 vendor/akeeba/engine/engine/Postproc/webdav.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_WEBDAV_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_WEBDAV_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.webdav.username": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_WEBDAV_USERNAME_TITLE",
"description": "COM_AKEEBA_CONFIG_WEBDAV_USERNAME_DESCRIPTION"
},
"engine.postproc.webdav.password": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_WEBDAV_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_WEBDAV_PASSWORD_DESCRIPTION"
},
"engine.postproc.webdav.url": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_WEBDAV_URL_TITLE",
"description": "COM_AKEEBA_CONFIG_WEBDAV_URL_DESCRIPTION"
},
"engine.postproc.webdav.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_WEBDAV_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_WEBDAV_DIRECTORY_DESCRIPTION"
}
}PK \|< . vendor/akeeba/engine/engine/Postproc/Swift.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\Swift as SwiftConnector;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use RuntimeException;
/**
* A post processing engine used to upload files to OpenStack Swift object storage
*/
class Swift extends Base
{
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
$this->supportsDownloadToBrowser = false;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
/** @var SwiftConnector $connector */
$connector = $this->getConnector();
$settings = $this->getSettings();
// Calculate relative remote filename
$filename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$directory = $settings['directory'];
if (!empty($directory) && ($directory != '/'))
{
$filename = $directory . '/' . $filename;
}
// Store the absolute remote path in the class property
$this->remotePath = $filename;
// Upload the file
Factory::getLog()->debug(sprintf("Uploading %s", basename($localFilepath)));
$input = [
'file' => $localFilepath,
];
$connector->putObject($input, $filename, 'application/octet-stream');
return true;
}
public function delete($path)
{
/** @var SwiftConnector $connector */
$connector = $this->getConnector();
// Delete the file
$connector->deleteObject($path);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
/** @var SwiftConnector $connector */
$connector = $this->getConnector();
// Do we need to set a range header?
$headers = [];
if (!is_null($fromOffset) && is_null($length))
{
$headers['Range'] = 'bytes=' . $fromOffset;
}
elseif (!is_null($fromOffset) && !is_null($length))
{
$headers['Range'] = 'bytes=' . $fromOffset . '-' . ($fromOffset + $length - 1);
}
elseif (!is_null($length))
{
$headers['Range'] = 'bytes=0-' . ($fromOffset + $length);
}
if (!empty($headers))
{
Factory::getLog()->debug(sprintf("Sending Range header «%s»", $headers['Range']));
}
$fp = @fopen($localFile, 'w');
if ($fp === false)
{
throw new RuntimeException(sprintf("Can't open %s for writing", $localFile));
}
try
{
$connector->downloadObject($remotePath, $fp, $headers);
}
finally
{
$this->conditionalFileClose($fp);
}
}
/**
* Returns the post-processing engine settings in array format. If something is amiss it returns boolean false.
*
* @return array
*/
protected function getSettings()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$version = trim($config->get('engine.postproc.swift.keystone_version', 'v2'));
$authurl = trim($config->get('engine.postproc.swift.authurl', ''));
$tenantid = trim($config->get('engine.postproc.swift.tenantid', ''));
$domain = trim($config->get('engine.postproc.swift.domain', 'default'));
$username = trim($config->get('engine.postproc.swift.username', ''));
$password = trim($config->get('engine.postproc.swift.password', ''));
$containerurl = $config->get('engine.postproc.swift.containerurl', 0);
$directory = $config->get('volatile.postproc.directory', null);
if (empty($directory))
{
$directory = $config->get('engine.postproc.swift.directory', 0);
}
// Sanity checks
if (empty($authurl))
{
throw new BadConfiguration('You have not set up your Authentication URL');
}
if (empty($tenantid))
{
throw new BadConfiguration('You have not set up your Tenant ID');
}
if (empty($username))
{
throw new BadConfiguration('You have not set up your OpenStack Username');
}
if (empty($password))
{
throw new BadConfiguration('You have not set up your OpenStack Password');
}
if (empty($containerurl))
{
throw new BadConfiguration('You have not set up your Container URL');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$directory = empty($directory) ? '' : $directory;
$directory = trim($directory);
$directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
$config->set('volatile.postproc.directory', $directory);
return [
'version' => $version,
'authurl' => $authurl,
'tenantid' => $tenantid,
'domain' => $domain,
'username' => $username,
'password' => $password,
'containerurl' => $containerurl,
'directory' => $directory,
];
}
protected function makeConnector()
{
$settings = $this->getSettings();
// Create the API connector object
$connector = new SwiftConnector($settings['version'], $settings['authurl'], $settings['tenantid'], $settings['username'], $settings['password'], $settings['domain']);
$connector->setStorageEndpoint($settings['containerurl']);
// Authenticate
Factory::getLog()->debug('Authenticating to OpenStack Swift');
$connector->getToken();
return $connector;
}
}
PK \ 0" 0" , vendor/akeeba/engine/engine/Postproc/Box.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Postproc\Connector\Box as ConnectorBox;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
use Exception;
use RuntimeException;
class Box extends Base
{
/**
* The retry count of this file (allow up to 2 retries after the first upload failure)
*
* @var int
*/
protected $tryCount = 0;
/**
* The currently configured directory
*
* @var string
*/
protected $directory;
/**
* The name of the OAuth2 callback method in the parent window (the configuration page)
*
* @var string
*/
protected $callbackMethod = 'akconfig_box_oauth_callback';
/**
* The key in Akeeba Engine's settings registry for this post-processing method
*
* @var string
*/
protected $settingsKey = 'box';
public function __construct()
{
$this->supportsDownloadToBrowser = false;
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
}
public function oauthCallback(array $params)
{
$input = $params['input'];
$data = [
'access_token' => $input['access_token'],
'refresh_token' => $input['refresh_token'],
];
$serialisedData = json_encode($data);
return <<< HTML
HTML;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
/** @var ConnectorBox $connector */
$connector = $this->getConnector();
$connector->ping();
// Store the absolute remote path in the property
$directory = $this->directory;
$basename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
$this->remotePath = $directory . '/' . $basename;
// Get the remote file's pathname
$remotePath = trim($directory, '/') . '/' . $basename;
// Single part upload
$exception = null;
// Try deleting the file first because Box doesn't allow replacing files
Factory::getLog()->debug(sprintf("%s - Simple upload. Proactively deleting files with remote path $remotePath", __METHOD__));
$connector->deleteFileByName($remotePath);
try
{
// Try to upload the file (single part upload)
Factory::getLog()->debug(sprintf("%s - Performing simple upload", __METHOD__));
$connector->uploadSingleFile($remotePath, $localFilepath);
}
catch (Exception $e)
{
// Upload failed. Let's log the failure first.
Factory::getLog()->debug(sprintf("%s - Simple upload failed, %s: %s", __METHOD__, 500, $e->getMessage()));
// Increase the try counter
$this->tryCount++;
// If I exceeded my retry count I will throw am exception (hard failure)
if ($this->tryCount > 2)
{
Factory::getLog()->debug(sprintf("%s - Maximum number of retries exceeded. The upload has failed.", __METHOD__));
throw new RuntimeException('Uploading to Box failed.', 500, $e);
}
// I need to retry.
Factory::getLog()->debug(__METHOD__ . " - Error detected, trying to force-refresh the tokens");
$this->forceRefreshTokens();
Factory::getLog()->debug(__METHOD__ . " - The upload will be retried");
return false;
}
$this->tryCount = 0;
return true;
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset))
{
// Ranges are not supported
throw new RangeDownloadNotSupported();
}
/** @var ConnectorBox $connector */
$connector = $this->getConnector();
$connector->ping();
$connector->download($remotePath, $localFile);
}
public function delete($path)
{
/** @var ConnectorBox $connector */
$connector = $this->getConnector();
$connector->ping();
$connector->deleteFileByName($path);
}
protected function getOAuth2HelperUrl()
{
$config = Factory::getConfiguration();
$oauth2HelperType = $config->get('engine.postproc.box.oauth2_type', 'akeeba');
switch ($oauth2HelperType)
{
case 'custom':
return $config->get('engine.postproc.box.oauth2_helper', '');
default:
return ConnectorBox::helperUrl;
}
}
protected function makeConnector()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$access_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.access_token', ''));
$refresh_token = trim($config->get('engine.postproc.' . $this->settingsKey . '.refresh_token', ''));
$this->directory = $config->get('volatile.postproc.directory', null);
if (empty($this->directory))
{
$this->directory = $config->get('engine.postproc.' . $this->settingsKey . '.directory', '');
}
// Sanity checks
if (empty($refresh_token))
{
throw new BadConfiguration('You have not linked Akeeba Backup with your Box account');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$this->directory = empty($this->directory) ? '' : $this->directory;
$this->directory = trim($this->directory);
$this->directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($this->directory), '/');
$this->directory = Factory::getFilesystemTools()->replace_archive_name_variables($this->directory);
$config->set('volatile.postproc.directory', $this->directory);
// Get Download ID
$dlid = Platform::getInstance()->get_platform_configuration_option('update_dlid', '');
if (empty($dlid))
{
throw new BadConfiguration('You must enter your Download ID in the application configuration before using the “Upload to Box.com” feature.');
}
$connector = new ConnectorBox(
$access_token,
$refresh_token,
$dlid,
$config->get('engine.postproc.box.oauth2_refresh')
);
// Restore the persisted access-token expiry so the connector can refresh proactively (before the token lapses)
// across stepped backup runs, instead of only reacting after a request has already failed.
$connector->setTokenExpiration((int) $config->get('engine.postproc.' . $this->settingsKey . '.token_expiration', 0));
// Validate the tokens
Factory::getLog()->debug(sprintf("%s - Validating the Box tokens", __METHOD__));
$pingResult = $connector->ping();
// Save new configuration if there was a refresh
if ($pingResult['needs_refresh'])
{
Factory::getLog()->debug(sprintf("%s - Box tokens were refreshed", __METHOD__));
$config->set('engine.postproc.' . $this->settingsKey . '.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.refresh_token', $pingResult['refresh_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
return $connector;
}
/**
* Forcibly refresh the Box tokens
*
* @return void
*
* @throws Exception
*/
protected function forceRefreshTokens()
{
/** @var ConnectorBox $connector */
$connector = $this->getConnector();
$config = Factory::getConfiguration();
$pingResult = $connector->ping(true);
Factory::getLog()->debug(sprintf("%s - Box tokens were forcibly refreshed", __METHOD__));
$config->set('engine.postproc.' . $this->settingsKey . '.access_token', $pingResult['access_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.refresh_token', $pingResult['refresh_token'], false);
$config->set('engine.postproc.' . $this->settingsKey . '.token_expiration', $pingResult['token_expiration'] ?? 0, false);
$profile_id = Platform::getInstance()->get_active_profile();
Platform::getInstance()->save_configuration($profile_id);
}
}
PK \z^ ^ 2 vendor/akeeba/engine/engine/Postproc/sftpcurl.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_SFTPCURL_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_SFTPCURL_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.sftpcurl.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_HOST_DESCRIPTION"
},
"engine.postproc.sftpcurl.port": {
"default": "22",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PORT_DESCRIPTION"
},
"engine.postproc.sftpcurl.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_USER_DESCRIPTION"
},
"engine.postproc.sftpcurl.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PASSWORD_DESCRIPTION"
},
"engine.postproc.sftpcurl.privkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_DESCRIPTION"
},
"engine.postproc.sftpcurl.pubkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_DESCRIPTION"
},
"engine.postproc.sftpcurl.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_INITDIR_DESCRIPTION",
"hook": "akeeba_postprocsftpcurl_init_browser",
"buttontitle": "UI-BROWSE"
},
"engine.postproc.sftpcurl.sftp_test": {
"default": "0",
"type": "button",
"hook": "postprocsftpcurl_test_connection",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_TEST_DESCRIPTION"
}
}PK \p]u u 5 vendor/akeeba/engine/engine/Postproc/onedriveapp.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_ONEDRIVEAPP_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_ONEDRIVEAPP_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.onedriveapp.chunk_upload": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_ENABLE"
},
"engine.postproc.onedriveapp.chunk_upload_size": {
"default": "10",
"type": "integer",
"min": "4",
"max": "60",
"shortcuts": "5|10|20|40|60",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE",
"showon": "engine.postproc.onedriveapp.chunk_upload:1"
},
"engine.postproc.onedriveapp.openoauth": {
"default": "",
"type": "button",
"title": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_TITLE",
"description": "COM_AKEEBA_CONFIG_BOX_OPENOAUTH_DESC",
"hook": "akconfig_onedriveapp_openoauth"
},
"engine.postproc.onedriveapp.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVEAPP_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVEAPP_DIRECTORY_DESCRIPTION"
},
"engine.postproc.onedriveapp.access_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_ACCESSTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_ACCESSTOKEN_DESCRIPTION"
},
"engine.postproc.onedriveapp.refresh_token": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_ONEDRIVE_REFRESHTOKEN_TITLE",
"description": "COM_AKEEBA_CONFIG_ONEDRIVE_REFRESHTOKEN_DESCRIPTION"
}
}PK \T+ + 3 vendor/akeeba/engine/engine/Postproc/Cloudfiles.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\Cloudfiles as ConnectorCloudfiles;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use RuntimeException;
/**
* A post processing engine used to upload files to RackSpace CloudFiles
*/
class Cloudfiles extends Base
{
/**
* Public constructor. Initialises the advertised properties of this processing engine
*/
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
$this->supportsDownloadToBrowser = false;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
$settings = $this->getEngineConfiguration();
$directory = $settings['directory'];
// Calculate relative remote filename
$filename = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
if (!empty($directory) && ($directory != '/'))
{
$filename = $directory . '/' . $filename;
}
// Store the absolute remote path in the class property
$this->remotePath = $filename;
/** @var ConnectorCloudfiles $connector */
$connector = $this->getConnector();
// Cache the tokens in the volatile engine parameters to speed up further uploads
Factory::getConfiguration()->set('volatile.postproc.cloudfiles.options', $connector->getCurrentOptions());
// Upload the file
Factory::getLog()->debug(sprintf("Uploading %s", basename($localFilepath)));
$input = [
'file' => $localFilepath,
];
$connector->putObject($input, $filename, 'application/octet-stream');
return true;
}
public function delete($path)
{
/** @var ConnectorCloudfiles $connector */
$connector = $this->getConnector();
$connector->deleteObject($path);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
/** @var ConnectorCloudfiles $connector */
$connector = $this->getConnector();
// Do we need to set a range header?
$headers = [];
if (!is_null($fromOffset) && is_null($length))
{
$headers['Range'] = 'bytes=' . $fromOffset;
}
elseif (!is_null($fromOffset) && !is_null($length))
{
$headers['Range'] = 'bytes=' . $fromOffset . '-' . ($fromOffset + $length - 1);
}
elseif (!is_null($length))
{
$headers['Range'] = 'bytes=0-' . ($fromOffset + $length);
}
$fp = @fopen($localFile, 'w');
if ($fp === false)
{
throw new RuntimeException(sprintf("Can't open %s for writing", $localFile));
}
$connector->downloadObject($remotePath, $fp, $headers);
$this->conditionalFileClose($fp);
}
/**
* Returns the post-processing engine settings in array format. If something is amiss it returns boolean false.
*
* @return array
*/
protected function getEngineConfiguration()
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$username = trim($config->get('engine.postproc.cloudfiles.username', ''));
$apikey = trim($config->get('engine.postproc.cloudfiles.apikey', ''));
$container = $config->get('engine.postproc.cloudfiles.container', 0);
$directory = $config->get('volatile.postproc.directory', null);
if (empty($directory))
{
$directory = $config->get('engine.postproc.cloudfiles.directory', 0);
}
// Sanity checks
if (empty($username))
{
throw new BadConfiguration('You have not set up your CloudFiles user name');
}
if (empty($apikey))
{
throw new BadConfiguration('You have not set up your CoudFiles API Key');
}
if (empty($container))
{
throw new BadConfiguration('You have not set up your CloudFiles container');
}
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
// Fix the directory name, if required
$directory = empty($directory) ? '' : $directory;
$directory = trim($directory);
$directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
$config->set('volatile.postproc.directory', $directory);
return [
'username' => $username,
'apikey' => $apikey,
'container' => $container,
'directory' => $directory,
];
}
protected function makeConnector()
{
$settings = $this->getEngineConfiguration();
// Do I have authorisation options already stored in the volatile settings?
$options = Factory::getConfiguration()->get('volatile.postproc.cloudfiles.options', [], false);
$options = array_merge([
'container' => $settings['container'],
], $options);
$connector = new ConnectorCloudfiles($settings['username'], $settings['apikey'], $options);
Factory::getLog()->debug('Authenticating to CloudFiles');
$connector->authenticate();
return $connector;
}
}
PK \#g . vendor/akeeba/engine/engine/Postproc/Azure.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Connector\AzureModern\Connector as AzureConnector;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\Engine\Postproc\Exception\RangeDownloadNotSupported;
class Azure extends Base
{
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToFile = true;
$this->supportsDownloadToBrowser = true;
$this->inlineDownloadToBrowser = false;
}
public function processPart($localFilepath, $remoteBaseName = null)
{
// Retrieve engine configuration data
$config = Factory::getConfiguration();
$container = $config->get('engine.postproc.azure.container', 0);
$disableMultipart = $config->get('engine.postproc.azure.chunk_upload', 1) == 0;
$preferredChunkSize = $config->get('engine.postproc.azure.chunk_upload_size', 10) * 1048576;
$directory = $config->get('volatile.postproc.directory', null);
$partList = $config->get('volatile.postproc.partList', []);
// Treat directory and place it in volatile storage if it's not already there
if (is_null($directory))
{
$directory = $config->get('engine.postproc.azure.directory', '');
$directory = trim($directory);
$directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($directory), '/');
$directory = empty($directory) ? '' : $directory;
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
$config->set('volatile.postproc.directory', $directory);
}
// Calculate relative remote filename
$filename = basename($localFilepath);
if (!empty($directory) && ($directory != '/'))
{
$filename = $directory . '/' . $filename;
}
// Store the absolute remote path in the class property
$this->remotePath = $filename;
// Get the connector
/** @var AzureConnector $connector */
$connector = $this->getConnector();
// Get the total file size
@clearstatcache($localFilepath);
$fileSize = @filesize($localFilepath) ?: 0;
// Get facts about multipart support
$canDoSinglePart = $connector->getBestBlockSize($localFilepath, 0) === 0;
$chunkSize = $config->get('volatile.postproc.chunkSize', null);
$chunkSize = $chunkSize ?: $connector->getBestBlockSize($localFilepath, $preferredChunkSize);
// Only allow $disableMultipart if I can do a single part upload.
$disableMultipart = $disableMultipart && $canDoSinglePart;
// Force disable multipart if the file size is under the chunk size.
$disableMultipart = $disableMultipart || ($canDoSinglePart && $fileSize <= $chunkSize);
$config->set('volatile.postproc.chunkSize', $chunkSize);
// Simplest case: single part upload
if ($disableMultipart)
{
Factory::getLog()->debug(sprintf('Azure BLOB Storage -- Using single part upload of %s', $localFilepath));
$config->remove('volatile.postproc.directory');
$config->remove('volatile.postproc.partList');
$config->remove('volatile.postproc.chunkSize');
$connector->putBlob($container, $filename, $localFilepath);
return true;
}
// Multipart upload.
$chunksProcessed = count($partList);
$offset = $chunksProcessed * $chunkSize;
if (empty($offset))
{
Factory::getLog()->debug(
sprintf(
'Azure BLOB Storage -- Starting multipart upload of %s (total size %d, chunk size %d)',
$localFilepath, $fileSize, $chunkSize
)
);
}
else
{
Factory::getLog()->debug(
sprintf(
'Azure BLOB Storage -- Continuing multipart upload of %s, chunk #%d, chunk size %d',
$localFilepath, $chunksProcessed + 1, $chunkSize
)
);
}
$fp = @fopen($localFilepath, 'r');
if ($fp === false)
{
// TODO Throw
}
if ($offset > 0)
{
fseek($fp, $offset);
}
$data = fread($fp, $chunkSize);
$lastChunk = feof($fp);
fclose($fp);
$partList[] = $connector->putBlock($container, $filename, $data);
$config->set('volatile.postproc.partList', $partList);
// If we have not reached EOF there's more work to do uploading this file
if (!$lastChunk)
{
return false;
}
// If we're here, we have finished uploading all chunks. Let's tell Azure to stitch them together.
Factory::getLog()->debug(sprintf('Azure BLOB Storage -- Finalising multipart upload of %s', $localFilepath));
$connector->putBlockList($container, $filename, $partList);
Factory::getLog()->debug(sprintf('Azure BLOB Storage -- Multipart uploading of %s is now complete', $localFilepath));
// Teardown of volatile data and return marking everything as all done
$config->remove('volatile.postproc.directory');
$config->remove('volatile.postproc.partList');
$config->remove('volatile.postproc.chunkSize');
return true;
}
public function delete($path)
{
$connector = $this->getConnector();
$config = Factory::getConfiguration();
$container = $config->get('engine.postproc.azure.container', 0);
$connector->deleteBlob($container, $path);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
if (!is_null($fromOffset))
{
// Ranges are not supported
throw new RangeDownloadNotSupported();
}
/** @var AzureConnector $connector */
$connector = $this->getConnector();
$config = Factory::getConfiguration();
$container = $config->get('engine.postproc.azure.container', 0);
$connector->getBlob($container, $remotePath, $localFile);
}
public function downloadToBrowser($remotePath)
{
/** @var AzureConnector $connector */
$connector = $this->getConnector();
$config = Factory::getConfiguration();
$container = $config->get('engine.postproc.azure.container', 0);
return $connector->getSignedURL($container, $remotePath, 600);
}
protected function makeConnector()
{
$config = Factory::getConfiguration();
$account = trim($config->get('engine.postproc.azure.account', ''));
$key = trim($config->get('engine.postproc.azure.key', ''));
$container = $config->get('engine.postproc.azure.container', 0);
$useSSL = $config->get('engine.postproc.azure.usessl', 1) == 1;
// Sanity checks
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
if (empty($account))
{
throw new BadConfiguration('You have not set up your Microsoft Azure account name');
}
if (empty($key))
{
throw new BadConfiguration('You have not set up your Microsoft Azure account key');
}
if (empty($container))
{
throw new BadConfiguration('You have not set up your Microsoft Azure container name');
}
return new AzureConnector($account, $key, false, $useSSL);
}
}
PK \J۩/ o o 1 vendor/akeeba/engine/engine/Postproc/Amazons3.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Postproc\Exception\BadConfiguration;
use Akeeba\S3\Acl;
use Akeeba\S3\Configuration;
use Akeeba\S3\Connector;
use Akeeba\S3\Input;
use DateTime;
use Exception;
use RuntimeException;
/**
* Amazon S3 post-processing engine
*/
class Amazons3 extends Base
{
use ProxyAware;
public const STORAGE_STANDARD = 0;
public const STORAGE_REDUCED_REDUNDANCY = 1;
public const STORAGE_STANDARD_IA = 2;
public const STORAGE_ONEZONE_IA = 3;
public const STORAGE_INTELLIGENT_TIERING = 4;
public const STORAGE_GLACIER = 5;
public const STORAGE_DEEP_ARCHIVE = 6;
/**
* Used in log messages. Check out children classes to understand why we have this here.
*
* @var string
*/
protected $engineLogName = 'Amazon S3';
/**
* The prefix to use for volatile key storage
*
* @var string
*/
protected $volatileKeyPrefix = 'volatile.postproc.amazons3.';
/**
* HTTP headers. Used when trying to fetch the S3 credentials from an EC2 instance's attached role.
*
* @var array
*/
protected $headers = [];
/**
* Cached copy of the S3 credentials provisioned by the EC2 instance's attached role.
*
* @var array|null
*/
protected $provisionedCredentials = null;
/**
* The upload ID of the multipart upload in progress
*
* @var string|null
*/
private $uploadId = null;
/**
* The part number for the multipart upload in progress
*
* @var int|null
*/
private $partNumber = null;
/**
* The ETags of the uploaded chunks, used to finalise the multipart upload
*
* @var array
*/
private $eTags = [];
/**
* Initialise the class, setting its capabilities
*
* @return void
*/
public function __construct()
{
$this->supportsDelete = true;
$this->supportsDownloadToBrowser = true;
$this->supportsDownloadToFile = true;
}
final public function processPart($localFilepath, $remoteBaseName = null): bool
{
// Retrieve engine configuration data
$akeebaConfig = Factory::getConfiguration();
// Load multipart information from temporary storage
$this->uploadId = $akeebaConfig->get($this->volatileKeyPrefix . 'uploadId', null);
// Get the configuration parameters
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'] ?? '';
$disableMultipart = $engineConfig['disableMultipart'] ?? false;
$storageType = $engineConfig['rrs'] ?? self::STORAGE_STANDARD;
$acl = $engineConfig['acl'] ?? Acl::ACL_BUCKET_OWNER_FULL_CONTROL;
// The directory is a special case. First try getting a cached directory
$directory = $akeebaConfig->get('volatile.postproc.directory', null);
// If there is no cached directory, fetch it from the engine configuration
if (is_null($directory))
{
$directory = $engineConfig['directory'] ?? '';
// The very first time we deal with the directory we need to process it.
$directory = str_replace('\\', '/', $directory);
$directory = rtrim($directory, '/');
$directory = trim($directory);
$directory = ltrim(Factory::getFilesystemTools()->TranslateWinPath($directory), '/');
$directory = Factory::getFilesystemTools()->replace_archive_name_variables($directory);
// Store the parsed directory in temporary storage
$akeebaConfig->set('volatile.postproc.directory', $directory);
}
// Remove any slashes from the bucket
$bucket = str_replace('/', '', $bucket);
// Get the file size and disable multipart uploads for files shorter than 5Mb
$fileSize = @filesize($localFilepath);
if ($fileSize <= 5242880)
{
$disableMultipart = true;
}
// Calculate relative remote filename
$remoteKey = empty($remoteBaseName) ? basename($localFilepath) : $remoteBaseName;
if (!empty($directory) && ($directory != '/'))
{
$remoteKey = $directory . '/' . $remoteKey;
}
// Store the absolute remote path in the class property
$this->remotePath = $remoteKey;
// Create the S3 client instance
/** @var Connector $connector */
$connector = $this->getConnector();
// Are we already processing a multipart upload or asked to perform a multipart upload?
if (!empty($this->uploadId) || !$disableMultipart)
{
$this->partNumber = $akeebaConfig->get($this->volatileKeyPrefix . 'partNumber', null);
$this->eTags = $akeebaConfig->get($this->volatileKeyPrefix . 'eTags', '{}');
$this->eTags = json_decode($this->eTags, true);
$this->eTags = empty($this->eTags) ? [] : $this->eTags;
return $this->multipartUpload($bucket, $remoteKey, $localFilepath, $connector, $acl, $storageType);
}
return $this->simpleUpload($bucket, $remoteKey, $localFilepath, $connector, $acl, $storageType);
}
final public function delete($path)
{
// Get the configuration parameters
/** @var Connector $connector */
$connector = $this->getConnector();
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'];
$bucket = str_replace('/', '', $bucket);
$connector->deleteObject($bucket, $path);
}
public function downloadToFile($remotePath, $localFile, $fromOffset = null, $length = null)
{
// Get the configuration parameters
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'];
$bucket = str_replace('/', '', $bucket);
// Create the S3 client instance
/** @var Connector $connector */
$connector = $this->getConnector();
$toOffset = null;
if (!is_null($fromOffset) && $length)
{
$toOffset = $fromOffset + $length - 1;
}
$connector->getObject($bucket, $remotePath, $localFile, $fromOffset, $toOffset);
}
public function downloadToBrowser($remotePath)
{
// Create the S3 client instance
/** @var Connector $connector */
$connector = $this->getConnector();
// Get the configuration parameters
$engineConfig = $this->getEngineConfiguration();
$bucket = $engineConfig['bucket'];
$bucket = str_replace('/', '', $bucket);
// Add custom content headers so the file is always downloaded to the browser instead of read inline
$queryParameters = [
'response-content-type' => 'application/octet-stream',
'response-content-disposition' => sprintf('attachment; filename="%s"', basename($remotePath)),
];
$uri = $remotePath . '?' . http_build_query($queryParameters);
return $connector->getAuthenticatedURL($bucket, $uri, 10, true);
}
/**
* Get the configuration information for this post-processing engine. Can be overridden by subclasses.
*
* @return array
*/
protected function getEngineConfiguration(): array
{
$akeebaConfig = Factory::getConfiguration();
$config = [
'accessKey' => $akeebaConfig->get('engine.postproc.amazons3.accesskey', ''),
'secretKey' => $akeebaConfig->get('engine.postproc.amazons3.secretkey', ''),
'token' => '',
'useSSL' => $akeebaConfig->get('engine.postproc.amazons3.usessl', 0) == 1,
'dualStack' => $akeebaConfig->get('engine.postproc.amazons3.dualstack', 0) == 1,
'customEndpoint' => $akeebaConfig->get('engine.postproc.amazons3.customendpoint', ''),
'signatureMethod' => $akeebaConfig->get('engine.postproc.amazons3.signature', 'v2'),
'useLegacyPathAccess' => $akeebaConfig->get('engine.postproc.amazons3.pathaccess', '0') == 1,
'region' => $akeebaConfig->get('engine.postproc.amazons3.region', '')
?: $akeebaConfig->get('engine.postproc.amazons3.custom_region', ''),
'disableMultipart' => $akeebaConfig->get('engine.postproc.amazons3.legacy', 0) == 1,
'bucket' => $akeebaConfig->get('engine.postproc.amazons3.bucket', null),
'directory' => $akeebaConfig->get('engine.postproc.amazons3.directory', null),
'acl' => $akeebaConfig->get(
'engine.postproc.amazons3.acl', Acl::ACL_BUCKET_OWNER_FULL_CONTROL
),
'rrs' => (int) $akeebaConfig->get(
'engine.postproc.amazons3.rrs', self::STORAGE_STANDARD
),
'alternateDateHeaderFormat' => $akeebaConfig->get('engine.postproc.amazons3.alternateDateHeaderFormat', 1)
== 1,
'useHTTPDateHeader' => $akeebaConfig->get('engine.postproc.amazons3.useHTTPDateHeader', 0) == 1,
'preSignedBucketInURL' => $akeebaConfig->get('engine.postproc.amazons3.preSignedBucketInURL', 0) == 1,
];
// No access and secret key? Try to fetch from the EC2 configuration
if (empty($config['accessKey']) && empty($config['secretKey']))
{
Factory::getLog()->debug(
"There is no configured Access and Secret key. I will try to provision these credentials automatically. This only works when your site runs inside an EC2 instance and you have attached an IAM Role to it which allows access to the configured bucket."
);
$config = $this->provisionCredentials($config);
}
return $config;
}
final protected function makeConnector(): Connector
{
// Retrieve engine configuration data
$config = $this->getEngineConfiguration();
// Get the configuration parameters
$accessKey = $config['accessKey'];
$secretKey = $config['secretKey'];
$useSSL = $config['useSSL'];
$dualStack = $config['dualStack'];
$customEndpoint = $config['customEndpoint'];
$signatureMethod = $config['signatureMethod'];
$region = $config['region'];
$useLegacyPathAccess = $config['useLegacyPathAccess'];
$disableMultipart = $config['disableMultipart'];
$bucket = $config['bucket'] ?? '';
if ($signatureMethod == 's3')
{
$signatureMethod = 'v2';
}
Factory::getLog()->debug(
sprintf(
"%s -- Using signature method %s, %s uploads",
$this->engineLogName, $signatureMethod, $disableMultipart ? 'single-part' : 'multipart'
)
);
// Makes sure the custom endpoint has no protocol and no trailing slash
$customEndpoint = trim($customEndpoint);
if (!empty($customEndpoint))
{
$protoPos = strpos($customEndpoint, ':\\');
if ($protoPos !== false)
{
$customEndpoint = substr($customEndpoint, $protoPos + 3);
}
$customEndpoint = rtrim($customEndpoint, '/');
Factory::getLog()->debug(
sprintf(
"%s -- Using custom endpoint %s", $this->engineLogName, $customEndpoint
)
);
}
// Remove any slashes from the bucket
$bucket = str_replace('/', '', $bucket);
// Sanity checks
if (!function_exists('curl_init'))
{
throw new BadConfiguration('cURL is not enabled, please enable it in order to post-process your archives');
}
if (empty($accessKey))
{
throw new BadConfiguration(sprintf("You have not set up your %s Access Key", $this->engineLogName));
}
if (empty($secretKey))
{
throw new BadConfiguration(sprintf("You have not set up your %s Secret Key", $this->engineLogName));
}
if (empty($bucket))
{
throw new BadConfiguration(sprintf("You have not set up your %s Bucket", $this->engineLogName));
}
// Prepare the configuration
$configuration = new Configuration($accessKey ?? '', $secretKey ?? '', $signatureMethod ?? 'v2', $region ?? '');
$configuration->setSSL($useSSL ?? true);
$configuration->setUseDualstackUrl($dualStack ?? true);
if (!empty($config['token']))
{
$configuration->setToken($config['token']);
}
if ($customEndpoint)
{
$configuration->setEndpoint($customEndpoint);
$configuration->setSignatureMethod($signatureMethod ?? 'v2');
$configuration->setRegion($region ?? '');
}
// Set path-style vs virtual hosting style access
$configuration->setUseLegacyPathStyle($useLegacyPathAccess);
// Set feature flags
$configuration->setAlternateDateHeaderFormat($config['alternateDateHeaderFormat']);
$configuration->setUseHTTPDateHeader($config['useHTTPDateHeader']);
$configuration->setPreSignedBucketInURL($config['preSignedBucketInURL']);
// Return the new S3 client instance
return new Connector($configuration);
}
/**
* Try to automatically provision the S3 credentials. The credentials are searched in the following places (the
* first one to be found wins):
*
* - The provisionedCredentials volatile key for this post-processing engine
* - The provisionedCredentials property
* - Querying the EC2 instance we are running under (assuming we run under an EC2 instance)
*
* If the cached provisionedCredentials have expired new ones will be fetched by querying the metadata of the
* underlying EC2 instance.
*
* If no provisioned credentials are found, the returned $config array is identical to the input, presumably lacking
* access and secret keys to connect to S3.
*
* @param array $config
*
* @return array
*/
private function provisionCredentials(array $config): array
{
// First, try to fetch credentials from the volatile engine configuration
$akeebaConfig = Factory::getConfiguration();
$this->provisionedCredentials = $akeebaConfig->get(
$this->volatileKeyPrefix . 'provisionedCredentials', $this->provisionedCredentials
);
// I must fetch new credentials if I don't have any provisioned credentials
$mustFetchCredentials = !is_array($this->provisionedCredentials) || empty($this->provisionedCredentials);
if (!$mustFetchCredentials)
{
Factory::getLog()->debug('Cached S3 credentials were found');
}
// I must fetch new credentials if the provisioned credentials have already expired
if (!$mustFetchCredentials && is_array($this->provisionedCredentials)
&& isset($this->provisionedCredentials['expires'])
&& !empty($this->provisionedCredentials['expires']))
{
$mustFetchCredentials = ($this->provisionedCredentials['expires'] + 30) < time();
if ($mustFetchCredentials)
{
Factory::getLog()->debug('The cached S3 credentials are about to or have already expired.');
}
}
if ($mustFetchCredentials)
{
Factory::getLog()->debug(
'Attempting to retrieve S3 credentials from the underlying EC2 instance (if the site is running inside an EC2 instance)'
);
try
{
$this->provisionedCredentials = $this->getEC2RoleCredentials();
$akeebaConfig->set($this->volatileKeyPrefix . 'provisionedCredentials', $this->provisionedCredentials);
}
catch (RuntimeException $e)
{
Factory::getLog()->debug(
"No Amazon S3 credentials found. Moreover, I got an error trying to detect whether this site is running inside an Amazon EC2 instance and possibly retrieve Amazon S3 credentials from the EC2 instance's role."
);
Factory::getLog()->debug($e->getMessage());
return $config;
}
}
Factory::getLog()->debug('Applying provisioned S3 credentials');
$config['accessKey'] = $this->provisionedCredentials['access'];
$config['secretKey'] = $this->provisionedCredentials['secret'];
$config['token'] = $this->provisionedCredentials['token'];
return $config;
}
/**
* Attempt to retrieve the Amazon S3 credentials from the attached Amazon EC2 instance role.
*
* This will only work if you are running Akeeba Engine in an Amazon EC2 instance with an attached role. The
* attached role must give access to the Amazon S3 bucket you have specified in the configuration of this post-
* processing engine.
*
* @return array (access, secret, expiration)
*
* @throws RuntimeException
*/
private function getEC2RoleCredentials(): array
{
$hasCurl = function_exists('curl_init') && function_exists('curl_exec');
if (!$hasCurl)
{
throw new RuntimeException('The PHP cURL module is not activated or installed on this server.');
}
$token = $this->getURL('http://169.254.169.254/latest/api/token', 'PUT',
'X-aws-ec2-metadata-token-ttl-seconds: 21600');
$roleName = $this->getURL('http://169.254.169.254/latest/meta-data/iam/security-credentials/', 'GET',
'X-aws-ec2-metadata-token: ' . $token);
if (empty($roleName))
{
throw new RuntimeException(
"Could not find an attached IAM Role on this EC2 instance or we are not running on an EC2 instance."
);
}
Factory::getLog()->debug(sprintf("Getting S3 credentials from EC2 attached IAM Role ‘%s’.", $roleName));
$credentialsDocument = $this->getURL(
'http://169.254.169.254/latest/meta-data/iam/security-credentials/' . $roleName, 'GET',
'X-aws-ec2-metadata-token: ' . $token);
$result = @json_decode($credentialsDocument, true);
if (is_null($result) || empty($result))
{
throw new RuntimeException(sprintf("Cannot retrieve credentials from IAM role %s", $roleName));
}
if (!array_key_exists('Code', $result) || ($result['Code'] != 'Success'))
{
throw new RuntimeException("Querying the IAM role did not return a successful result.");
}
$keys = ['AccessKeyId', 'AccessKeyId', 'Expiration', 'Token'];
foreach ($keys as $key)
{
if (!array_key_exists($key, $result))
{
throw new RuntimeException(
sprintf(
"Cannot find key ‘%s’ in EC2 metadata document. Automatic provisioning of S3 credentials is not possible.",
$key
)
);
}
}
try
{
$expiresOn = new DateTime($result['Expiration']);
$expires = $expiresOn->getTimestamp();
}
catch (Exception $e)
{
Factory::getLog()->debug(
'Could not determine the expiration time of the automatically provisioned credentials. Assuming an expiration period of 10 minutes (minimum expiration period).'
);
$expires = time() + 600;
}
return [
'access' => $result['AccessKeyId'],
'secret' => $result['SecretAccessKey'],
'token' => $result['Token'],
'expires' => $expires,
];
}
/**
* Returns the contents of a URL. We use this internally to fetch the Amazon S3 credentials from the attached
* Amazon EC2 instance role.
*
* @param string $url The URL to fetch
*
* @return string The contents of the URL
*
* @throws RuntimeException
*/
private function getURL(string $url, string $method, string $header): string
{
$ch = curl_init();
$this->applyProxySettingsToCurl($ch);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_AUTOREFERER, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($ch, CURLOPT_SSLVERSION, 0);
curl_setopt($ch, CURLOPT_CAINFO, AKEEBA_CACERT_PEM);
curl_setopt($ch, CURLOPT_HEADERFUNCTION, [$this, 'reponseHeaderCallback']);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, [$header]);
$result = curl_exec($ch);
$errno = curl_errno($ch);
$errmsg = curl_error($ch);
$error = '';
$http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($result === false)
{
$error = sprintf("(cURL Error %u) %s", $errno, $errmsg);
}
elseif (($http_status >= 300) && ($http_status <= 399) && isset($this->headers['location'])
&& !empty($this->headers['location']))
{
return $this->getURL($this->headers['location'], 'GET', $header);
}
elseif ($http_status > 399)
{
$errno = $http_status;
$error = sprintf('HTTP %u error', $http_status);
}
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($result === false)
{
throw new RuntimeException($error, $errno);
}
return $result;
}
/**
* Start a multipart upload
*
* @param string $bucket The bucket to upload to
* @param string $remoteKey The remote filename
* @param string $sourceFile The full path to the local source file
* @param Connector $connector The S3 client object instance
* @param string $acl Canned ACL privileges to use
* @param int $storageType The Amazon S3 storage type. See the constants in this class.
*
* @return bool True when we're done uploading, false if we have more parts.
*
* @throws Exception When something goes wrong.
*/
private function multipartUpload(
string $bucket, string $remoteKey, string $sourceFile, Connector $connector,
string $acl = Acl::ACL_BUCKET_OWNER_FULL_CONTROL, int $storageType = 0
): bool
{
$endpoint = $connector->getConfiguration()->getEndpoint();
$headers = $this->getStorageTypeHeaders($storageType, $endpoint);
$input = Input::createFromFile($sourceFile, null, null);
$headers['Content-Disposition'] = sprintf('attachment; filename="%s"', basename($sourceFile));
if (empty($this->uploadId))
{
Factory::getLog()->debug(
sprintf(
"%s -- Beginning multipart upload of %s", $this->engineLogName, $sourceFile
)
);
// Initialise the multipart upload if necessary
try
{
$this->uploadId = $connector->startMultipart($input, $bucket, $remoteKey, $acl, $headers);
$this->partNumber = 1;
$this->eTags = [];
Factory::getLog()->debug(
sprintf(
"%s -- Got uploadID %s", $this->engineLogName, $this->uploadId
)
);
}
catch (Exception $e)
{
Factory::getLog()->debug(
sprintf(
"%s -- Failed to initialize multipart upload of %s", $this->engineLogName, $sourceFile
)
);
throw new RuntimeException(
sprintf(
'Upload cannot be initialised. %s returned an error.', $this->engineLogName
), 500, $e
);
}
}
else
{
Factory::getLog()->debug(
sprintf(
"%s -- Continuing multipart upload of %s (UploadId: %s –– Part number %d)",
$this->engineLogName, $sourceFile, $this->uploadId, $this->partNumber
)
);
}
// Upload a chunk
try
{
//$input = Input::createFromFile($sourceFile, null, null);
$input->setUploadID($this->uploadId);
$input->setPartNumber($this->partNumber);
$input->setEtags($this->eTags);
// Do NOT send $headers when uploading parts. The RRS header MUST ONLY be sent when we're beginning the multipart upload.
$eTag = $connector->uploadMultipart($input, $bucket, $remoteKey);
if (!is_null($eTag))
{
$this->eTags[] = $eTag;
$this->partNumber = $input->getPartNumber();
$this->partNumber++;
}
else
{
// We just finished. Let's finalise the upload
$count = count($this->eTags);
Factory::getLog()->debug(
sprintf(
"%s -- Finalising multipart upload of %s (UploadId: %s –– %d parts in total",
$this->engineLogName, $sourceFile, $this->uploadId, $count
)
);
//$input = Input::createFromFile($sourceFile, null, null);
$input->setUploadID($this->uploadId);
$input->setPartNumber($this->partNumber);
$input->setEtags($this->eTags);
$connector->finalizeMultipart($input, $bucket, $remoteKey);
$this->uploadId = null;
$this->partNumber = null;
$this->eTags = [];
}
}
catch (Exception $e)
{
Factory::getLog()->debug(
sprintf(
"%s -- Multipart upload of %s has failed.", $this->engineLogName, $sourceFile
)
);
// Reset the multipart markers in temporary storage
$akeebaConfig = Factory::getConfiguration();
$akeebaConfig->set($this->volatileKeyPrefix . 'uploadId', null);
$akeebaConfig->set($this->volatileKeyPrefix . 'partNumber', null);
$akeebaConfig->set($this->volatileKeyPrefix . 'eTags', null);
throw new RuntimeException(
sprintf(
"Upload cannot proceed. %s returned an error.", $this->engineLogName
), 500, $e
);
}
// Save the internal tracking variables
$akeebaConfig = Factory::getConfiguration();
$akeebaConfig->set($this->volatileKeyPrefix . 'uploadId', $this->uploadId);
$akeebaConfig->set($this->volatileKeyPrefix . 'partNumber', $this->partNumber);
$akeebaConfig->set($this->volatileKeyPrefix . 'eTags', json_encode($this->eTags));
// If I have an upload ID I have to do more work
if (is_string($this->uploadId) && !empty($this->uploadId))
{
return false;
}
// In any other case I'm done uploading the file
return true;
}
/**
* Get the Amazon request headers required to set the storage type of an upload to the specified type.
*
* @param int $storageType The storage type. See the constants in this class.
* @param string $endpoint The API endpoint. Used to determine whether it's Amazon or a third party service.
*
* @return array The headers
*/
private function getStorageTypeHeaders($storageType = self::STORAGE_STANDARD, $endpoint = 's3.amazonaws.com')
{
$headers = [];
if (!in_array($endpoint, ['s3.amazonaws.com', 'amazonaws.com.cn']))
{
return $headers;
}
switch ($storageType)
{
case self::STORAGE_STANDARD:
$headers['X-Amz-Storage-Class'] = 'STANDARD';
break;
case self::STORAGE_REDUCED_REDUNDANCY:
$headers['X-Amz-Storage-Class'] = 'REDUCED_REDUNDANCY';
break;
case self::STORAGE_STANDARD_IA:
$headers['X-Amz-Storage-Class'] = 'STANDARD_IA';
break;
case self::STORAGE_ONEZONE_IA:
$headers['X-Amz-Storage-Class'] = 'ONEZONE_IA';
break;
case self::STORAGE_INTELLIGENT_TIERING:
$headers['X-Amz-Storage-Class'] = 'INTELLIGENT_TIERING';
break;
case self::STORAGE_GLACIER:
$headers['X-Amz-Storage-Class'] = 'GLACIER';
break;
case self::STORAGE_DEEP_ARCHIVE:
$headers['X-Amz-Storage-Class'] = 'DEEP_ARCHIVE';
break;
}
return $headers;
}
/**
* Perform a single-step upload of a file
*
* @param string $bucket The bucket to upload to
* @param string $remoteKey The remote filename
* @param string $sourceFile The full path to the local source file
* @param Connector $s3Client The S3 client object instance
* @param string $acl Canned ACL privileges to use
* @param int $storageType The Amazon S3 storage type. See the constants in this class.
*
* @return bool True when we're done uploading, false if we have more parts
*
* @throws Exception When something goes wrong.
*/
private function simpleUpload(
string $bucket, string $remoteKey, string $sourceFile, Connector $s3Client,
string $acl = Acl::ACL_BUCKET_OWNER_FULL_CONTROL, int $storageType = 0
): bool
{
Factory::getLog()->debug(
sprintf(
"%s -- Legacy (single part) upload of %s", $this->engineLogName, basename($sourceFile)
)
);
$endpoint = $s3Client->getConfiguration()->getEndpoint();
$headers = $this->getStorageTypeHeaders($storageType, $endpoint);
$input = Input::createFromFile($sourceFile, null, null);
$headers['Content-Disposition'] = sprintf('attachment; filename="%s"', basename($sourceFile));
$s3Client->putObject($input, $bucket, $remoteKey, $acl, $headers);
return true;
}
/**
* Handles the HTTP headers returned by cURL.
*
* @param resource $ch cURL resource handle (unused)
* @param string $data Each header line, as returned by the server
*
* @return int The length of the $data string
*/
private function reponseHeaderCallback($ch, $data)
{
$strlen = strlen($data);
if (($strlen) <= 2)
{
return $strlen;
}
$testForHTTP = substr($data, 0, 4);
if (strtoupper($testForHTTP) == 'HTTP')
{
return $strlen;
}
[$header, $value] = explode(': ', trim($data), 2);
$this->headers[strtolower($header)] = $value;
return $strlen;
}
}
PK \vf 6 vendor/akeeba/engine/engine/Postproc/Googlestorage.phpnu [ .
*/
namespace Akeeba\Engine\Postproc;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
/**
* Google Storage is a sub-case of the Amazon S3 engine with a custom endpoint
*
* @package Akeeba\Engine\Postproc
*/
class Googlestorage extends Amazons3
{
public function __construct()
{
parent::__construct();
$this->engineLogName = 'Google Storage';
$this->volatileKeyPrefix = 'volatile.postproc.googlestorage.';
$this->supportsDownloadToBrowser = false;
Factory::getLog()->warning("The old Google Storage integration you are currently using, the one that makes use of the legacy S3 API, is deprecated and will be removed in a future version. Please switch to the new Upload to Google Storage (JSON API) integration.");
}
/**
* Get the configuration information for this post-processing engine
*
* @return array
*/
protected function getEngineConfiguration(): array
{
$config = Factory::getConfiguration();
$endpoint = 'storage.googleapis.com';
Factory::getLog()->info("GoogleStorage: using S3 compatible endpoint $endpoint");
$ret = [
'accessKey' => $config->get('engine.postproc.googlestorage.accesskey', ''),
'secretKey' => $config->get('engine.postproc.googlestorage.secretkey', ''),
'token' => '',
'useSSL' => $config->get('engine.postproc.googlestorage.usessl', 1),
'dualStack' => 0,
'customEndpoint' => $endpoint,
'signatureMethod' => 'v2',
'useLegacyPathAccess' => false,
'region' => '',
'disableMultipart' => 1,
'bucket' => $config->get('engine.postproc.googlestorage.bucket', null),
'directory' => $config->get('engine.postproc.googlestorage.directory', null),
'rrs' => 0,
'lowercase' => $config->get('engine.postproc.googlestorage.lowercase', 1),
'alternateDateHeaderFormat' => false,
'useHTTPDateHeader' => true,
'preSignedBucketInURL' => false,
];
if ($ret['lowercase'] && !empty($ret['bucket']))
{
$ret['bucket'] = strtolower($ret['bucket']);
}
return $ret;
}
}
PK \Sʉ . vendor/akeeba/engine/engine/Postproc/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ۯz / vendor/akeeba/engine/engine/Postproc/azure.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_AZURE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_POSTPROC_AZURE_DESCRIPTION"
},
"engine.postproc.common.after_part": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROCPARTS_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCPARTS_DESCRIPTION"
},
"engine.postproc.common.abort_on_fail": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROC_ABORT_ON_FAIL_DESCRIPTION"
},
"engine.postproc.common.delete_after": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DELETEAFTER_TITLE",
"description": "COM_AKEEBA_CONFIG_DELETEAFTER_DESCRIPTION"
},
"engine.postproc.azure.chunk_upload": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_ENABLE"
},
"engine.postproc.azure.chunk_upload_size": {
"default": "20",
"type": "integer",
"min": "1",
"max": "4000",
"shortcuts": "5|10|20|40|50|75|100|250|1024|2047",
"scale": "1",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BOX_CHUNKUPLOAD_SIZE",
"showon": "engine.postproc.azure.chunk_upload:1"
},
"engine.postproc.azure.account": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_AZURE_ACCOUNTNAME_TITLE",
"description": "COM_AKEEBA_CONFIG_AZURE_ACCOUNTNAME_DESCRIPTION"
},
"engine.postproc.azure.key": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_AZURE_KEY_TITLE",
"description": "COM_AKEEBA_CONFIG_AZURE_KEY_DESCRIPTION"
},
"engine.postproc.azure.usessl": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_S3USESSL_TITLE",
"description": "COM_AKEEBA_CONFIG_S3USESSL_DESCRIPTION"
},
"engine.postproc.azure.container": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_AZURE_CONTAINER_TITLE",
"description": "COM_AKEEBA_CONFIG_AZURE_CONTAINER_DESCRIPTION"
},
"engine.postproc.azure.directory": {
"default": "\/",
"type": "string",
"title": "COM_AKEEBA_CONFIG_AZURE_DIRECTORY_TITLE",
"description": "COM_AKEEBA_CONFIG_AZURE_DIRECTORY_DESCRIPTION"
}
}PK \
z z 0 vendor/akeeba/engine/engine/FixMySQLHostname.phpnu [ .
*/
namespace Akeeba\Engine;
defined('AKEEBAENGINE') || die();
trait FixMySQLHostname
{
/**
* Tries to parse all the weird hostname definitions and normalize them into something that the MySQLi connector
* will understand. Please note that there are some differences to the old MySQL driver:
*
* * Port and socket MUST be provided separately from the hostname. Hostnames in the form of 127.0.0.1:8336 are no
* longer acceptable.
*
* * The hostname "localhost" has special meaning. It means "use named pipes / sockets". Anything else uses TCP/IP.
* This is the ONLY way to specify a. TCP/IP or b. named pipes / sockets connection.
*
* * You SHOULD NOT use a numeric TCP/IP port with hostname localhost. For some strange reason it's still allowed
* but the manual is self-contradicting over what this really does...
*
* * Likewise you CANNOT use a socket / named pipe path with hostname other than localhost. Named pipes and sockets
* can only be used with the local machine, therefore the hostname MUST be localhost.
*
* * You cannot give a TCP/IP port number in the socket parameter or a named pipe / socket path to the port
* parameter. This leads to an error.
*
* * You cannot use an empty string, 0 or any other non-null value when you want to omit either of the port or
* socket parameters.
*
* * Persistent connections must be prefixed with the string literal 'p:'. Therefore you cannot have a hostname
* called 'p' (not to mention that'd be daft). You can also not specify something like 'p:1234' to make a
* persistent connection to a port. This wasn't even supported by the old MySQL driver. As a result we don't even
* try to catch that degenerate case.
*
* This method will try to apply all of the aforementioned rules with one additional disambiguation rule:
*
* A port / socket set in the hostname overrides a port specified separately. A port specified separately overrides
* a socket specified separately.
*
* @param string $host The hostname. Can contain legacy hostname:port or hostname:sc=ocket definitions.
* @param int $port The port. Alternatively it can contain the path to the socket.
* @param string $socket The path to the socket. You could abuse it to enter the port number. DON'T!
*
* @return void All parameters are passed by reference.
*
* @since 9.2.3
*/
protected function fixHostnamePortSocket(&$host, &$port, &$socket)
{
// Is this a persistent connection? Persistent connections are indicated by the literal "p:" in front of the hostname
$isPersistent = (substr($host, 0, 2) == 'p:');
$host = $isPersistent ? substr($host, 2) : $host;
// If the hostname looks like a *NIX filename we need to treat it as a socket.
if (preg_match('#^/([^/]*/)?[^/]#', $host))
{
$socket = $host;
$host = null;
}
// Special case: Windows named pipe (\\.\something\or\another), with or without parentheses.
$isNamedPipe = false;
if (preg_match("#^\(?\\\\\\\\\.\\\\#", $host))
{
$isNamedPipe = true;
$socket = $host;
$host = '.';
}
/*
* Unlike mysql_connect(), mysqli_connect() takes the port and socket as separate arguments. Therefore, we
* have to extract them from the host string.
*/
$port = !empty($port) ? $port : 3306;
if ($host === 'localhost')
{
$port = null;
}
// UNIX socket URI, e.g. 'unix:/path/to/unix/socket.sock'
elseif (preg_match('/^unix:(?P[^:]+)$/', $host, $matches))
{
$host = null;
$socket = $matches['socket'];
$port = null;
}
// It's an IPv4 address with or without port
elseif (preg_match('/^(?P((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?))(:(?P.+))?$/', $host, $matches))
{
$host = $matches['host'];
if (!empty($matches['port']))
{
$port = $matches['port'];
}
}
// Square-bracketed IPv6 address with or without port, e.g. [fe80:102::2%eth1]:3306
elseif (preg_match('/^(?P\[.*\])(:(?P.+))?$/', $host, $matches))
{
$host = $matches['host'];
if (!empty($matches['port']))
{
$port = $matches['port'];
}
}
// Named host (e.g example.com or localhost) with or without port
elseif (preg_match('/^(?P(\w+:\/{2,3})?[a-z0-9\.\-]+)(:(?P[^:]+))?$/i', $host, $matches))
{
$host = $matches['host'];
if (!empty($matches['port']))
{
$port = $matches['port'];
}
}
// Empty host, just port, e.g. ':3306'
elseif (preg_match('/^:(?P[^:]+)$/', $host, $matches))
{
$host = '127.0.0.1';
$port = $matches['port'];
}
// ... else we assume normal (naked) IPv6 address, so host and port stay as they are or default
// If there is both a valid port and a valid socket we will choose the socket instead
if (is_numeric($port) && !empty($socket))
{
$port = null;
}
// Get the port number or socket name
if (is_numeric($port))
{
$port = (int) $port;
$socket = '';
}
elseif (is_string($port) && empty($socket))
{
$socket = $port;
$port = null;
}
// If there is a socket the hostname must be null
if (!empty($socket))
{
$host = null;
}
// If there is a socket the port must be null
if (!empty($socket))
{
$port = null;
}
// If there is a numeric port and the hostname is 'localhost' convert to 127.0.0.1
if (is_numeric($port) && ($host === 'localhost'))
{
$host = '127.0.0.1';
}
/**
* Special case: MySQL sockets on Windows need to be enclosed with parentheses and have \\.\ in front.
*
* @see https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-connection-socket.html
* @see https://www.php.net/manual/en/mysqli.quickstart.connections.php
*/
if (!empty($socket) && $isNamedPipe)
{
$host = '.';
/**
* Remove any existing parentheses, otherwise URL-decode the socket (in case it was given in the correct
* percent encoded format).
*/
if (substr($socket, 0, 1) === '(' && substr($socket, -1) === ')')
{
$socket = substr($socket, 1, -1);
}
else
{
$socket = rawurldecode($socket);
}
// If the socket doesn't already start with \\.\ add it
if (substr($socket, 0, 4) !== '\\\\.\\')
{
$socket = '\\\\.\\' . $socket;
}
$socket = '(' . $socket . ')';
}
// Finally, if it's a persistent connection we have to prefix the hostname with 'p:'
$host = ($isPersistent && $host !== null) ? "p:$host" : $host;
}
}PK \T
- vendor/akeeba/engine/engine/Archiver/jps.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_JPS_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_JPS_DESCRIPTION"
},
"engine.archiver.jps.key": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_JPS_KEY_TITLE",
"description": "COM_AKEEBA_CONFIG_JPS_KEY_DESCRIPTION"
},
"engine.archiver.jps.pbkdf2usestaticsalt": {
"default": "1",
"type": "hidden",
"title": "COM_AKEEBA_CONFIG_JPS_PBKDF2USESTATICSALT_TITLE",
"description": "COM_AKEEBA_CONFIG_JPS_PBKDF2USESTATICSALT_DESCRIPTION"
},
"engine.archiver.common.dereference_symlinks": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DEREFERENCESYMLINKS_TITLE",
"description": "COM_AKEEBA_CONFIG_DEREFERENCESYMLINKS_DESCRIPTION"
},
"engine.archiver.common.part_size": {
"default": "0",
"type": "integer",
"min": "0",
"max": "2147483648",
"shortcuts": "0|131072|262144|524288|1048576|2097152|5242880|10485760|20971520|52428800|104857600|268435456|536870912|1073741824|1610612736|2097152000",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_PARTSIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_PARTSIZE_DESCRIPTION"
},
"engine.archiver.common.permissions": {
"default": "0666",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_PERMISSIONS_0600|COM_AKEEBA_CONFIG_PERMISSIONS_0644|COM_AKEEBA_CONFIG_PERMISSIONS_0666",
"enumvalues": "0600|0644|0666",
"title": "COM_AKEEBA_CONFIG_PERMISSIONS_TITLE",
"description": "COM_AKEEBA_CONFIG_PERMISSIONS_DESCRIPTION"
}
}PK \yY? ? 3 vendor/akeeba/engine/engine/Archiver/zipnative.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_ZIPNATIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_ZIPNATIVE_DESCRIPTION"
},
"engine.archiver.common.permissions": {
"default": "0666",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_PERMISSIONS_0600|COM_AKEEBA_CONFIG_PERMISSIONS_0644|COM_AKEEBA_CONFIG_PERMISSIONS_0666",
"enumvalues": "0600|0644|0666",
"title": "COM_AKEEBA_CONFIG_PERMISSIONS_TITLE",
"description": "COM_AKEEBA_CONFIG_PERMISSIONS_DESCRIPTION"
}
}PK \ ^\& & 2 vendor/akeeba/engine/engine/Archiver/Directftp.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Transfer\Ftp;
use Exception;
use RuntimeException;
/**
* Direct Transfer Over FTP archiver class
*
* Transfers the files to a remote FTP server instead of putting them in
* an archive
*
*/
class Directftp extends Base
{
/** @var bool Could we connect to the server? */
public $connect_ok = false;
/** @var Ftp FTP resource handle */
protected $ftpTransfer;
/** @var string FTP hostname */
protected $host;
/** @var string FTP port */
protected $port;
/** @var string FTP username */
protected $user;
/** @var string FTP password */
protected $pass;
/** @var bool Should we use FTP over SSL? */
protected $usessl;
/** @var bool Should we use passive FTP? */
protected $passive;
/** @var string FTP initial directory */
protected $initdir;
/**
* Initialises the archiver class, seeding the remote installation
* from an existent installer's JPA archive.
*
* @param string $targetArchivePath Absolute path to the generated archive (ignored in this class)
* @param array $options A named key array of options (optional)
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: new instance");
$registry = Factory::getConfiguration();
$this->host = $registry->get('engine.archiver.directftp.host', '');
$this->port = $registry->get('engine.archiver.directftp.port', '21');
$this->user = $registry->get('engine.archiver.directftp.user', '');
$this->pass = $registry->get('engine.archiver.directftp.pass', '');
$this->initdir = $registry->get('engine.archiver.directftp.initial_directory', '');
$this->usessl = $registry->get('engine.archiver.directftp.ftps', false);
$this->passive = $registry->get('engine.archiver.directftp.passive_mode', true);
if (isset($options['host']))
{
$this->host = $options['host'];
}
if (isset($options['port']))
{
$this->port = $options['port'];
}
if (isset($options['user']))
{
$this->user = $options['user'];
}
if (isset($options['pass']))
{
$this->pass = $options['pass'];
}
if (isset($options['initdir']))
{
$this->initdir = $options['initdir'];
}
if (isset($options['usessl']))
{
$this->usessl = $options['usessl'];
}
if (isset($options['passive']))
{
$this->passive = $options['passive'];
}
// You can't fix stupid, but at least you get to shout at them
if (strtolower(substr($this->host, 0, 6)) == 'ftp://')
{
Factory::getLog()->warning('YOU ARE *** N O T *** SUPPOSED TO ENTER THE ftp:// PROTOCOL PREFIX IN THE FTP HOSTNAME FIELD OF THE DirectFTP ARCHIVER ENGINE.');
Factory::getLog()->warning('I am trying to fix your bad configuration setting, but the backup might fail anyway. You MUST fix this in your configuration.');
$this->host = substr($this->host, 6);
}
$this->connect_ok = $this->connectFTP();
Factory::getLog()->debug(__CLASS__ . " :: FTP connection status: " . ($this->connect_ok ? 'success' : 'FAIL'));
}
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
public function getExtension()
{
return '';
}
public function finalize()
{
// Nothing to do
}
/**
* "Magic" function called just before serialization of the object. Disconnects
* from the FTP server and allows PHP to serialize like normal.
*
* @return array The variables to serialize
*/
public function _onSerialize()
{
// Explicitally unset the ftpTransfer class so the destructor magic method is called (and the connection is closed)
unset($this->ftpTransfer);
return array_keys(get_object_vars($this));
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param bool $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual is
* true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return boolean True on success, false otherwise
*/
protected function _addFile($isVirtual, &$sourceNameOrData, $targetName)
{
// Are we connected to a server?
if (!$this->ftpTransfer)
{
if (!$this->connectFTP())
{
return false;
}
}
// See if it's a directory
$isDir = $isVirtual ? false : is_dir($sourceNameOrData);
if ($isDir)
{
// Just try to create the remote directory
return $this->makeDirectory($targetName);
}
else
{
// We have a file we need to upload
if ($isVirtual)
{
// Create a temporary file, upload, rename it
$tempFileName = Factory::getTempFiles()->createRegisterTempFile();
// Easy writing using file_put_contents
if (@file_put_contents($tempFileName, $sourceNameOrData) === false)
{
throw new RuntimeException('Could not store virtual file ' . $targetName . ' to ' . $tempFileName . ' using file_put_contents() before uploading.');
}
// Upload the temporary file under the final name
$res = $this->upload($tempFileName, $targetName);
// Remove the temporary file
Factory::getTempFiles()->unregisterAndDeleteTempFile($tempFileName, true);
return $res;
}
else
{
// Upload a file
return $this->upload($sourceNameOrData, $targetName);
}
}
}
/**
* Tries to connect to the remote FTP server and change into the initial directory
*
* @return bool True is connection successful, false otherwise
*
* @throws Exception
*/
protected function connectFTP()
{
Factory::getLog()->debug('Connecting to remote FTP');
$options = [
'host' => $this->host,
'port' => $this->port,
'username' => $this->user,
'password' => $this->pass,
'directory' => $this->initdir,
'ssl' => $this->usessl,
'passive' => $this->passive,
];
// Let the exceptions bubble up
$this->ftpTransfer = new Ftp($options);
return true;
}
/**
* Changes to the requested directory in the remote server. You give only the
* path relative to the initial directory and it does all the rest by itself,
* including doing nothing if the remote directory is the one we want. If the
* directory doesn't exist, it creates it.
*
* @param $dir string The (realtive) remote directory
*
* @return bool True if successful, false otherwise.
*/
protected function ftp_chdir($dir)
{
// Calculate "real" (absolute) FTP path
$realdir = $this->ftpTransfer->getPath($dir);
if ($this->initdir == $realdir)
{
// Already there, do nothing
return true;
}
$result = $this->ftpTransfer->isDir($realdir);
if ($result === false)
{
// The directory doesn't exist, let's try to create it...
if (!$this->makeDirectory($dir))
{
return false;
}
}
return true;
}
/**
* Recursively create a directory in the FTP server
*
* @param string $dir The directory to create
*
* @return bool True on success
*/
protected function makeDirectory($dir)
{
$alldirs = explode('/', $dir);
$previousDir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$previousDir = substr($previousDir, 0, 1) == '/' ? $previousDir : '/' . $previousDir;
foreach ($alldirs as $curdir)
{
$check = $previousDir . '/' . $curdir;
if (!$this->ftpTransfer->isDir($check))
{
if (@$this->ftpTransfer->mkdir($check) === false)
{
throw new RuntimeException('Could not create directory ' . $dir);
}
}
$previousDir = $check;
}
return true;
}
/**
* Uploads a file to the remote server
*
* @param $sourceName string The absolute path to the source local file
* @param $targetName string The relative path to the targer remote file
*
* @return bool True if successful
*/
protected function upload($sourceName, $targetName)
{
// Try to change into the remote directory, possibly creating it if it doesn't exist
$dir = dirname($targetName);
if (!$this->ftp_chdir($dir))
{
return false;
}
// Upload
$realdir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$realdir .= '/' . $dir;
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
$realname = $realdir . '/' . basename($targetName);
try
{
$res = $this->ftpTransfer->upload($sourceName, $realname);
}
catch (RuntimeException $e)
{
$res = false;
}
if (!$res)
{
// If the file was unreadable, just skip it...
if (is_readable($sourceName))
{
throw new RuntimeException('Uploading ' . $targetName . ' has failed.');
}
Factory::getLog()->warning('Uploading ' . $targetName . ' has failed because the file is unreadable.');
return true;
}
$this->ftpTransfer->chmod($realname, 0644);
return true;
}
}
PK \a 3 vendor/akeeba/engine/engine/Archiver/directftp.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTP_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTP_DESCRIPTION"
},
"engine.archiver.directftp.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_HOST_DESCRIPTION"
},
"engine.archiver.directftp.port": {
"default": "21",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_PORT_DESCRIPTION"
},
"engine.archiver.directftp.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_USER_DESCRIPTION"
},
"engine.archiver.directftp.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSWORD_DESCRIPTION"
},
"engine.archiver.directftp.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_INITDIR_DESCRIPTION"
},
"engine.archiver.directftp.ftps": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_FTPS_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_FTPS_DESCRIPTION"
},
"engine.archiver.directftp.passive_mode": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSIVE_DESCRIPTION"
},
"engine.archiver.directftp.ftp_test": {
"default": "0",
"type": "button",
"hook": "directftp_test_connection",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_TEST_DESCRIPTION"
}
}PK \ j j 8 vendor/akeeba/engine/engine/Archiver/directsftpcurl.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTSFTPCURL_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTSFTPCURL_DESCRIPTION"
},
"engine.archiver.directsftpcurl.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_HOST_DESCRIPTION"
},
"engine.archiver.directsftpcurl.port": {
"default": "22",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_PORT_DESCRIPTION"
},
"engine.archiver.directsftpcurl.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_USER_DESCRIPTION"
},
"engine.archiver.directsftpcurl.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_PASSWORD_DESCRIPTION"
},
"engine.archiver.directsftpcurl.privkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_DESCRIPTION"
},
"engine.archiver.directsftpcurl.pubkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_DESCRIPTION"
},
"engine.archiver.directsftpcurl.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_INITDIR_DESCRIPTION"
},
"engine.archiver.directsftpcurl.sftp_test": {
"default": "0",
"type": "button",
"hook": "directsftp_test_connection",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_TEST_DESCRIPTION"
}
}PK \_$ $ 3 vendor/akeeba/engine/engine/Archiver/Directsftp.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Transfer\Sftp;
use RuntimeException;
/**
* Direct Transfer Over SFTP archiver class
*
* Transfers the files to a remote SFTP server instead of putting them in
* an archive
*
*/
class Directsftp extends Base
{
/** @var bool Could we connect to the server? */
public $connect_ok = false;
/** @var Sftp SFTP resource handle */
private $sftpTransfer = false;
/** @var string SFTP hostname */
private $host;
/** @var string SFTP port */
private $port;
/** @var string SFTP username */
private $user;
/** @var string SFTP password */
private $pass;
/** @var string Private key file */
private $privkey;
/** @var string Private key file */
private $pubkey;
/** @var string FTP initial directory */
private $initdir;
/**
* Initialises the archiver class, seeding the remote installation
* from an existent installer's JPA archive.
*
* @param string $targetArchivePath Absolute path to the generated archive (ignored in this class)
* @param array $options A named key array of options (optional)
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: new instance");
$registry = Factory::getConfiguration();
$this->host = $registry->get('engine.archiver.directsftp.host', '');
$this->port = $registry->get('engine.archiver.directsftp.port', '22');
$this->user = $registry->get('engine.archiver.directsftp.user', '');
$this->pass = $registry->get('engine.archiver.directsftp.pass', '');
$this->privkey = $registry->get('engine.archiver.directsftp.privkey', '');
$this->pubkey = $registry->get('engine.archiver.directsftp.pubkey', '');
$this->initdir = $registry->get('engine.archiver.directsftp.initial_directory', '');
if (isset($options['host']))
{
$this->host = $options['host'];
}
if (isset($options['port']))
{
$this->port = $options['port'];
}
if (isset($options['user']))
{
$this->user = $options['user'];
}
if (isset($options['pass']))
{
$this->pass = $options['pass'];
}
if (isset($options['privkey']))
{
$this->privkey = $options['privkey'];
}
if (isset($options['pubkey']))
{
$this->pubkey = $options['pubkey'];
}
if (isset($options['initdir']))
{
$this->initdir = $options['initdir'];
}
// You can't fix stupid, but at least you get to shout at them
if (strtolower(substr($this->host, 0, 7)) == 'sftp://')
{
Factory::getLog()->warning('YOU ARE *** N O T *** SUPPOSED TO ENTER THE sftp:// PROTOCOL PREFIX IN THE FTP HOSTNAME FIELD OF THE DirectSFTP ARCHIVER ENGINE.');
Factory::getLog()->warning('I am trying to fix your bad configuration setting, but the backup might fail anyway. You MUST fix this in your configuration.');
$this->host = substr($this->host, 7);
}
$this->connect_ok = $this->connectSFTP();
Factory::getLog()->debug(__CLASS__ . " :: SFTP connection status: " . ($this->connect_ok ? 'success' : 'FAIL'));
}
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
public function getExtension()
{
return '';
}
public function finalize()
{
// Nothing to do
}
/**
* "Magic" function called just before serialization of the object. Disconnects
* from the FTP server and allows PHP to serialize like normal.
*
* @return array The variables to serialize
*/
public function _onSerialize()
{
// Explicitally unset the sftpTransfer class so the destructor magic method is called (and the connection is closed)
unset($this->sftpTransfer);
return array_keys(get_object_vars($this));
}
/**
* Tries to connect to the remote SFTP server and change into the initial directory
*
* @return bool True is connection successful, false otherwise
*/
protected function connectSFTP()
{
Factory::getLog()->debug('Connecting to remote SFTP server');
$options = [
'host' => $this->host,
'port' => $this->port,
'username' => $this->user,
'password' => $this->pass,
'directory' => $this->initdir,
'privateKey' => $this->privkey,
'publicKey' => $this->pubkey,
];
$this->sftpTransfer = new Sftp($options);
return true;
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param bool $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual is
* true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return boolean True on success, false otherwise
*/
protected function _addFile($isVirtual, &$sourceNameOrData, $targetName)
{
// Are we connected to a server?
if (!$this->sftpTransfer)
{
if (!$this->connectSFTP())
{
return false;
}
}
// See if it's a directory
$isDir = $isVirtual ? false : is_dir($sourceNameOrData);
if ($isDir)
{
// Just try to create the remote directory
return $this->makeDirectory($targetName);
}
else
{
// We have a file we need to upload
if ($isVirtual)
{
// Create a temporary file, upload, rename it
$tempFileName = Factory::getTempFiles()->createRegisterTempFile();
// Easy writing using file_put_contents
if (@file_put_contents($tempFileName, $sourceNameOrData) === false)
{
throw new RuntimeException('Could not store virtual file ' . $targetName . ' to ' . $tempFileName . ' using file_put_contents() before uploading.');
}
// Upload the temporary file under the final name
$res = $this->upload($tempFileName, $targetName);
// Remove the temporary file
Factory::getTempFiles()->unregisterAndDeleteTempFile($tempFileName, true);
return $res;
}
else
{
// Upload a file
return $this->upload($sourceNameOrData, $targetName);
}
}
}
protected function makeDirectory($dir)
{
$alldirs = explode('/', $dir);
$previousDir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$previousDir = substr($previousDir, 0, 1) == '/' ? $previousDir : '/' . $previousDir;
foreach ($alldirs as $curdir)
{
$check = $previousDir . '/' . $curdir;
if (!@$this->sftpTransfer->isDir($check))
{
if ($this->sftpTransfer->mkdir($check) === false)
{
throw new RuntimeException('Could not create directory ' . $check);
}
}
$previousDir = $check;
}
return true;
}
/**
* Uploads a file to the remote server
*
* @param $sourceName string The absolute path to the source local file
* @param $targetName string The relative path to the targer remote file
*
* @return bool True if successful
*/
protected function upload($sourceName, $targetName)
{
// Try to change into the remote directory, possibly creating it if it doesn't exist
$dir = dirname($targetName);
if (!$this->sftp_chdir($dir))
{
return false;
}
// Upload
$realdir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$realdir .= '/' . $dir;
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
$realname = $realdir . '/' . basename($targetName);
$this->sftpTransfer->upload($sourceName, $realname);
return true;
}
/**
* Changes to the requested directory in the remote server. You give only the
* path relative to the initial directory and it does all the rest by itself,
* including doing nothing if the remote directory is the one we want. If the
* directory doesn't exist, it creates it.
*
* @param $dir string The (realtive) remote directory
*
* @return bool True if successful, false otherwise.
*/
protected function sftp_chdir($dir)
{
// Calculate "real" (absolute) SFTP path
$realdir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$realdir .= '/' . $dir;
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
if ($this->initdir == $realdir)
{
// Already there, do nothing
return true;
}
$result = $this->sftpTransfer->isDir($realdir);
if ($result === false)
{
// The directory doesn't exist, let's try to create it...
if (!$this->makeDirectory($dir))
{
return false;
}
}
return true;
}
}
PK \_
- vendor/akeeba/engine/engine/Archiver/zip.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_ZIP_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_ZIP_DESCRIPTION"
},
"engine.archiver.common.dereference_symlinks": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DEREFERENCESYMLINKS_TITLE",
"description": "COM_AKEEBA_CONFIG_DEREFERENCESYMLINKS_DESCRIPTION"
},
"engine.archiver.common.part_size": {
"default": "0",
"type": "integer",
"min": "0",
"max": "2147483648",
"shortcuts": "0|131072|262144|524288|1048576|2097152|5242880|10485760|20971520|52428800|104857600|268435456|536870912|1073741824|1610612736|2097152000",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_PARTSIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_PARTSIZE_DESCRIPTION"
},
"engine.archiver.common.chunk_size": {
"default": "1048576",
"type": "integer",
"min": "65536",
"max": "10485760",
"shortcuts": "65536|131072|262144|524288|1048576|2097152|5242880|10485760",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_CHUNKSIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_CHUNKSIZE_DESCRIPTION"
},
"engine.archiver.common.permissions": {
"default": "0666",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_PERMISSIONS_0600|COM_AKEEBA_CONFIG_PERMISSIONS_0644|COM_AKEEBA_CONFIG_PERMISSIONS_0666",
"enumvalues": "0600|0644|0666",
"title": "COM_AKEEBA_CONFIG_PERMISSIONS_TITLE",
"description": "COM_AKEEBA_CONFIG_PERMISSIONS_DESCRIPTION"
},
"engine.archiver.common.big_file_threshold": {
"default": "1048576",
"type": "integer",
"min": "65536",
"max": "10485760",
"shortcuts": "65536|131072|262144|524288|1048576|2097152|5242880|10485760",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BIGFILETHRESHOLD_TITLE",
"description": "COM_AKEEBA_CONFIG_BIGFILETHRESHOLD_DESCRIPTION"
},
"engine.archiver.zip.cd_glue_chunk_size": {
"default": "1048576",
"type": "integer",
"min": "65536",
"max": "10485760",
"shortcuts": "65536|131072|262144|524288|1048576|2097152|5242880|10485760",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_ZIPCDGLUECHUNKSIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_ZIPCDGLUECHUNKSIZE_DESCRIPTION"
}
}PK \U 6 vendor/akeeba/engine/engine/Archiver/Directftpcurl.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Transfer\Ftp;
use Akeeba\Engine\Util\Transfer\FtpCurl;
use RuntimeException;
/**
* Direct Transfer Over FTP Over cURL archiver class
*
* Transfers the files to a remote FTP server instead of putting them in
* an archive
*
*/
class Directftpcurl extends Directftp
{
/** @var bool Could we connect to the server? */
public $connect_ok = false;
/** @var Ftp FTP resource handle */
protected $ftpTransfer;
/** @var string FTP hostname */
protected $host;
/** @var string FTP port */
protected $port;
/** @var string FTP username */
protected $user;
/** @var string FTP password */
protected $pass;
/** @var bool Should we use FTP over SSL? */
protected $usessl;
/** @var bool Should we use passive FTP? */
protected $passive;
/** @var bool Enable the passive mode workaround? */
protected $passiveWorkaround = true;
/** @var string FTP initial directory */
protected $initdir;
/**
* Initialises the archiver class, seeding the remote installation
* from an existent installer's JPA archive.
*
* @param string $targetArchivePath Absolute path to the generated archive (ignored in this class)
* @param array $options A named key array of options (optional)
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: new instance");
$registry = Factory::getConfiguration();
$this->host = $registry->get('engine.archiver.directftpcurl.host', '');
$this->port = $registry->get('engine.archiver.directftpcurl.port', '21');
$this->user = $registry->get('engine.archiver.directftpcurl.user', '');
$this->pass = $registry->get('engine.archiver.directftpcurl.pass', '');
$this->initdir = $registry->get('engine.archiver.directftpcurl.initial_directory', '');
$this->usessl = $registry->get('engine.archiver.directftpcurl.ftps', false);
$this->passive = $registry->get('engine.archiver.directftpcurl.passive_mode', true);
$this->passiveWorkaround = $registry->get('engine.archiver.directftpcurl.passive_mode_workaround', true);
if (isset($options['host']))
{
$this->host = $options['host'];
}
if (isset($options['port']))
{
$this->port = $options['port'];
}
if (isset($options['user']))
{
$this->user = $options['user'];
}
if (isset($options['pass']))
{
$this->pass = $options['pass'];
}
if (isset($options['initdir']))
{
$this->initdir = $options['initdir'];
}
if (isset($options['usessl']))
{
$this->usessl = $options['usessl'];
}
if (isset($options['passive']))
{
$this->passive = $options['passive'];
}
if (isset($options['passive_fix']))
{
$this->passiveWorkaround = $options['passive_fix'] ? true : false;
}
// You can't fix stupid, but at least you get to shout at them
if (strtolower(substr($this->host, 0, 6)) == 'ftp://')
{
Factory::getLog()->warning('YOU ARE *** N O T *** SUPPOSED TO ENTER THE ftp:// PROTOCOL PREFIX IN THE FTP HOSTNAME FIELD OF THE DirectFTP ARCHIVER ENGINE.');
Factory::getLog()->warning('I am trying to fix your bad configuration setting, but the backup might fail anyway. You MUST fix this in your configuration.');
$this->host = substr($this->host, 6);
}
$this->connect_ok = $this->connectFTP();
Factory::getLog()->debug(__CLASS__ . " :: FTP connection status: " . ($this->connect_ok ? 'success' : 'FAIL'));
}
/**
* Tries to connect to the remote FTP server and change into the initial directory
*
* @return bool True is connection successful, false otherwise
*
* @throws RuntimeException
*/
protected function connectFTP()
{
Factory::getLog()->debug('Connecting to remote FTP');
$options = [
'host' => $this->host,
'port' => $this->port,
'username' => $this->user,
'password' => $this->pass,
'directory' => $this->initdir,
'ssl' => $this->usessl,
'passive' => $this->passive,
'passive_fix' => $this->passiveWorkaround,
];
$this->ftpTransfer = new FtpCurl($options);
return true;
}
}
PK \JԲN N , vendor/akeeba/engine/engine/Archiver/Zip.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Base\Exceptions\WarningException;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\CRC32;
use RuntimeException;
class Zip extends BaseArchiver
{
/** @var string Beginning of central directory record. */
private $centralDirectoryRecordStartSignature = "\x50\x4b\x01\x02";
/** @var string End of central directory record. */
private $centralDirectoryRecordEndSignature = "\x50\x4b\x05\x06";
/** @var string Beginning of file contents. */
private $fileHeaderSignature = "\x50\x4b\x03\x04";
/** @var string The name of the temporary file holding the ZIP's Central Directory */
private $centralDirectoryFilename;
/** @var integer The total number of files and directories stored in the ZIP archive */
private $totalFilesCount;
/** @var integer The total size of data in the archive. Note: On 32-bit versions of PHP, this will overflow for archives over 2Gb! */
private $totalCompressedSize = 0;
/** @var integer The chunk size for CRC32 calculations */
private $AkeebaPackerZIP_CHUNK_SIZE;
/** @var int Current part file number */
private $currentPartNumber = 1;
/** @var int Total number of part files */
private $totalParts = 1;
/**
* Class constructor - initializes internal operating parameters
*
* @return void
*/
public function __construct()
{
Factory::getLog()->debug(__CLASS__ . " :: New instance");
// Find the optimal chunk size for ZIP archive processing
$this->findOptimalChunkSize();
Factory::getLog()->debug("Chunk size for CRC is now " . $this->AkeebaPackerZIP_CHUNK_SIZE . " bytes");
// Should I use Symlink Target Storage?
$this->enableSymlinkTargetStorage();
parent::__construct();
if (!function_exists('hash_file') || !function_exists('hash'))
{
$action = version_compare(PHP_VERSION, '7.4.0', 'lt')
? 'Please ask your host to enable the PHP hash extension and to make sure the hash_file() and hash() functions are not disabled.'
: 'Please ask your host to change their PHP configuration so that the hash_file() and hash() functions are not disabled.';
Factory::getLog()->warning(
sprintf(
'Your server lacks support for the hash_file() and/or hash() functions. CRC32 checksum cannot be calculated. Third party ZIP extraction tools may report the backup archive as broken. %s',
$action
)
);
}
}
/**
* Initialises the archiver class, creating the archive from an existent
* installer's JPA archive.
*
* @param string $sourceJPAPath Absolute path to an installer's JPA archive
* @param string $targetArchivePath Absolute path to the generated archive
* @param array $options A named key array of options (optional). This is currently not supported
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: initialize - archive $targetArchivePath");
// Get names of temporary files
$this->_dataFileName = $targetArchivePath;
// Should we enable split archive feature?
$this->enableSplitArchives();
// Create the Central Directory temporary file
$this->createCentralDirectoryTempFile();
// Try to kill the archive if it exists
$this->createNewBackupArchive();
// On split archives, include the "Split ZIP" header, for PKZIP 2.50+ compatibility
if ($this->useSplitArchive)
{
$this->openArchiveForOutput();
$this->fwrite($this->fp, "\x50\x4b\x07\x08");
}
}
public function finalize()
{
$this->finalizeZIPFile();
}
/**
* Glues the Central Directory of the ZIP file to the archive and takes care about the differences between single
* and multipart archives.
*
* Official ZIP file format: http://www.pkware.com/appnote.txt
*
* @return void
*/
public function finalizeZIPFile()
{
// 1. Get size of central directory
clearstatcache();
$cdOffset = @filesize($this->_dataFileName);
$this->totalCompressedSize += $cdOffset;
$cdSize = @filesize($this->centralDirectoryFilename);
// 2. Append Central Directory to data file and remove the CD temp file afterwards
if (!is_null($this->fp))
{
$this->fclose($this->fp);
}
if (!is_null($this->cdfp))
{
$this->fclose($this->cdfp);
}
$this->openArchiveForOutput(true);
/**
* Do not remove the fcloseByName line! This is required for post-processing multipart archives when for any
* reason $this->filePointers[$this->centralDirectoryFilename] contains null instead of boolean false. In this
* case the while loop would be stuck forever and the backup would fail. This HAS happened and I have been able
* to reproduce it but I did not have enough time to identify the real root cause. This workaround, however,
* works.
*/
$this->fcloseByName($this->centralDirectoryFilename);
$this->cdfp = $this->fopen($this->centralDirectoryFilename, "r");
if ($this->cdfp === false)
{
// Already glued, return
$this->fclose($this->fp);
$this->fp = null;
$this->cdfp = null;
return;
}
// Comment length (I need it before I start gluing the archive)
$comment_length = akstrlen($this->_comment);
// Special consideration for split ZIP files
if ($this->useSplitArchive)
{
// Calculate size of Central Directory + EOCD records
$total_cd_eocd_size = $cdSize + 22 + $comment_length;
// Free space on the part
$free_space = $this->getPartFreeSize();
if (($free_space < $total_cd_eocd_size) && ($total_cd_eocd_size > 65536))
{
// Not enough space on archive for CD + EOCD, will go on separate part
$this->createAndOpenNewPart(true);
}
}
/**
* Write the CD record
*
* Note about is_resource: in some circumstances where multipart ZIP files are generated, the $this->cdfp will
* contain a null value. This seems to happen when $this->fopen returns null, i.e. $this->filePointers has a
* null value instead of a file pointer (resource). Why this happens is unclear but the workaround is to remove
* the null value from $this->filePointers and retry $this->fopen. Normally this should not be required since we
* already to the fcloseByName/fopen dance above. This if-block is our last hope to catch a potential issue
* which would either make the while loop go infinite (not anymore, I've patched it) or the Central Directory
* not get written to the archive, which results in a broken archive.
*/
if (!is_resource($this->cdfp))
{
$this->fcloseByName($this->centralDirectoryFilename);
$this->cdfp = $this->fopen($this->centralDirectoryFilename, "r");
// We tried reopening the central directory file and failed again. Time to report a fatal error.
if (!$this->cdfp)
{
throw new RuntimeException("Cannot open central directory temporary file {$this->centralDirectoryFilename} for reading.");
}
}
while (!feof($this->cdfp) && is_resource($this->cdfp))
{
/**
* Why not split the Central Directory between parts?
*
* APPNOTE.TXT §8.5.2 "The central directory may span segment boundaries, but no single record in the
* central directory should be split across segments."
*
* This would require parsing the CD temp file to prevent any CD record from spanning across two parts.
* But how many bytes is each CD record? It's about 100 bytes per file which gives us about 10,400 files
* per MB. Even a 2MB part size holds more than 20,000 file records. A typical 10Mb part size holds more
* files than the largest backup I've ever seen. Therefore there is no need to waste computational power
* to see if we need to span the Central Directory between parts.
*/
$chunk = fread($this->cdfp, _AKEEBA_DIRECTORY_READ_CHUNK);
$this->fwrite($this->fp, $chunk);
}
unset($chunk);
// Delete the temporary CD file
$this->fclose($this->cdfp);
$this->cdfp = null;
Factory::getTempFiles()->unregisterAndDeleteTempFile($this->centralDirectoryFilename);
// 3. Write the rest of headers to the end of the ZIP file
$this->fwrite($this->fp, $this->centralDirectoryRecordEndSignature);
if ($this->useSplitArchive)
{
// Split ZIP files, enter relevant disk number information
$this->fwrite($this->fp, pack('v', $this->totalParts - 1)); /* Number of this disk. */
$this->fwrite($this->fp, pack('v', $this->totalParts - 1)); /* Disk with central directory start. */
}
else
{
// Non-split ZIP files, the disk number MUST be 0
$this->fwrite($this->fp, pack('V', 0));
}
$this->fwrite($this->fp, pack('v', $this->totalFilesCount)); /* Total # of entries "on this disk". */
$this->fwrite($this->fp, pack('v', $this->totalFilesCount)); /* Total # of entries overall. */
$this->fwrite($this->fp, pack('V', $cdSize)); /* Size of central directory. */
$this->fwrite($this->fp, pack('V', $cdOffset)); /* Offset to start of central dir. */
// 2.0.b2 -- Write a ZIP file comment
$this->fwrite($this->fp, pack('v', $comment_length)); /* ZIP file comment length. */
$this->fwrite($this->fp, $this->_comment);
$this->fclose($this->fp);
// If Split ZIP and there is no .zip file, rename the last fragment to .ZIP
if ($this->useSplitArchive)
{
$extension = substr($this->_dataFileName, -3);
if ($extension != '.zip')
{
Factory::getLog()->debug('Renaming last ZIP part to .ZIP extension');
$newName = $this->dataFileNameWithoutExtension . '.zip';
if (!@rename($this->_dataFileName, $newName))
{
throw new RuntimeException('Could not rename last ZIP part to .ZIP extension.');
}
$this->_dataFileName = $newName;
}
// If Split ZIP and only one fragment, change the signature
if ($this->totalParts == 1)
{
$this->fp = $this->fopen($this->_dataFileName, 'r+');
$this->fwrite($this->fp, "\x50\x4b\x30\x30");
}
}
@chmod($this->_dataFileName, $this->getPermissions());
}
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
public function getExtension()
{
return '.zip';
}
/**
* Extend the bootstrap code to add some define's used by the ZIP format engine
*
* @return void
*/
protected function __bootstrap_code()
{
if (!defined('_AKEEBA_COMPRESSION_THRESHOLD'))
{
$config = Factory::getConfiguration();
define("_AKEEBA_COMPRESSION_THRESHOLD", $config->get('engine.archiver.common.big_file_threshold')); // Don't compress files over this size
define("_AKEEBA_DIRECTORY_READ_CHUNK", $config->get('engine.archiver.zip.cd_glue_chunk_size')); // How much data to read at once when finalizing ZIP archives
}
parent::__bootstrap_code();
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param bool $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual is
* true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return bool True on success, false otherwise
*/
protected function _addFile($isVirtual, &$sourceNameOrData, $targetName)
{
$configuration = Factory::getConfiguration();
// Note down the starting disk number for Split ZIP archives
$starting_disk_number_for_this_file = 0;
if ($this->useSplitArchive)
{
$starting_disk_number_for_this_file = $this->currentPartNumber - 1;
}
// Open data file for output
$this->openArchiveForOutput();
// Should I continue backing up a file from the previous step?
$continueProcessingFile = $configuration->get('volatile.engine.archiver.processingfile', false);
// Initialize with the default values. Why are *these* values default? If we are continuing file packing, by
// definition we have an uncompressed, non-virtual file. Hence the default values.
$isDir = false;
$isSymlink = false;
$compressionMethod = 1;
$zdata = null;
// If we are continuing file packing we have an uncompressed, non-virtual file.
$isVirtual = $continueProcessingFile ? false : $isVirtual;
$resume = $continueProcessingFile ? 0 : null;
if (!$continueProcessingFile)
{
// Log the file being added
$messageSource = $isVirtual ? '(virtual data)' : "(source: $sourceNameOrData)";
Factory::getLog()->debug("-- Adding $targetName to archive $messageSource");
$this->writeFileHeader($sourceNameOrData, $targetName, $isVirtual, $isSymlink, $isDir,
$compressionMethod, $zdata, $unc_len,
$storedName, $crc, $c_len, $hexdtime, $old_offset);
}
else
{
// Since we are continuing archiving, it's an uncompressed regular file. Set up the variables.
$sourceNameOrData = $configuration->get('volatile.engine.archiver.sourceNameOrData', '');
$resume = $configuration->get('volatile.engine.archiver.resume', 0);
$unc_len = $configuration->get('volatile.engine.archiver.unc_len');
$storedName = $configuration->get('volatile.engine.archiver.storedName');
$crc = $configuration->get('volatile.engine.archiver.crc');
$c_len = $configuration->get('volatile.engine.archiver.c_len');
$hexdtime = $configuration->get('volatile.engine.archiver.hexdtime');
$old_offset = $configuration->get('volatile.engine.archiver.old_offset');
// Log the file we continue packing
Factory::getLog()->debug("-- Resuming adding file $sourceNameOrData to archive from position $resume (total size $unc_len)");
}
/* "File data" segment. */
if ($compressionMethod == 8)
{
$this->putRawDataIntoArchive($zdata);
}
elseif ($isVirtual)
{
// Virtual data. Put into the archive.
$this->putRawDataIntoArchive($sourceNameOrData);
}
elseif ($isSymlink)
{
$this->fwrite($this->fp, @readlink($sourceNameOrData));
}
elseif ((!$isDir) && (!$isSymlink))
{
// Uncompressed file.
if ($this->putUncompressedFileIntoArchive($sourceNameOrData, $unc_len, $resume) === true)
{
// If it returns true we are doing a step break to resume packing in the next step. So we need to return
// true here to avoid running the final bit of code which writes the central directory record and
// uncaches the file resume data.
return true;
}
}
// Open the central directory file for append
if (is_null($this->cdfp))
{
$this->cdfp = @$this->fopen($this->centralDirectoryFilename, "a");
}
if ($this->cdfp === false)
{
throw new ErrorException("Could not open Central Directory temporary file for append!");
}
$this->fwrite($this->cdfp, $this->centralDirectoryRecordStartSignature);
if (!$isSymlink)
{
$this->fwrite($this->cdfp, "\x14\x00"); /* Version made by (always set to 2.0). */
$this->fwrite($this->cdfp, "\x14\x00"); /* Version needed to extract */
$this->fwrite($this->cdfp, pack('v', 2048)); /* General purpose bit flag */
$this->fwrite($this->cdfp, ($compressionMethod == 8) ? "\x08\x00" : "\x00\x00"); /* Compression method. */
}
else
{
// Symlinks get special treatment
$this->fwrite($this->cdfp, "\x14\x03"); /* Version made by (version 2.0 with UNIX extensions). */
$this->fwrite($this->cdfp, "\x0a\x03"); /* Version needed to extract */
$this->fwrite($this->cdfp, pack('v', 2048)); /* General purpose bit flag */
$this->fwrite($this->cdfp, "\x00\x00"); /* Compression method. */
}
$this->fwrite($this->cdfp, $hexdtime); /* Last mod time/date. */
$this->fwrite($this->cdfp, $crc); /* CRC 32 information. */
$this->fwrite($this->cdfp, pack('V', $c_len)); /* Compressed filesize. */
if ($compressionMethod == 0)
{
// When we are not compressing, $unc_len is being reduced to 0 while backing up.
// With this trick, we always store the correct length, as in this case the compressed
// and uncompressed length is always the same.
$this->fwrite($this->cdfp, pack('V', $c_len)); /* Uncompressed filesize. */
}
else
{
// When compressing, the uncompressed length differs from compressed length
// and this line writes the correct value.
$this->fwrite($this->cdfp, pack('V', $unc_len)); /* Uncompressed filesize. */
}
$fn_length = akstrlen($storedName);
$this->fwrite($this->cdfp, pack('v', $fn_length)); /* Length of filename. */
$this->fwrite($this->cdfp, pack('v', 0)); /* Extra field length. */
$this->fwrite($this->cdfp, pack('v', 0)); /* File comment length. */
$this->fwrite($this->cdfp, pack('v', $starting_disk_number_for_this_file)); /* Disk number start. */
$this->fwrite($this->cdfp, pack('v', 0)); /* Internal file attributes. */
/* External file attributes */
if (!$isSymlink)
{
// Archive bit set
$this->fwrite($this->cdfp, pack('V', $isDir ? 0x41FF0010 : 0xFE49FFE0));
}
else
{
// For SymLinks we store UNIX file attributes
$this->fwrite($this->cdfp, "\x20\x80\xFF\xA1");
}
$this->fwrite($this->cdfp, pack('V', $old_offset)); /* Relative offset of local header. */
$this->fwrite($this->cdfp, $storedName); /* File name. */
/* Optional extra field, file comment goes here. */
// Finally, increase the file counter by one
$this->totalFilesCount++;
// Uncache data
$configuration->set('volatile.engine.archiver.sourceNameOrData', null);
$configuration->set('volatile.engine.archiver.unc_len', null);
$configuration->set('volatile.engine.archiver.resume', null);
$configuration->set('volatile.engine.archiver.hexdtime', null);
$configuration->set('volatile.engine.archiver.crc', null);
$configuration->set('volatile.engine.archiver.c_len', null);
$configuration->set('volatile.engine.archiver.fn_length', null);
$configuration->set('volatile.engine.archiver.old_offset', null);
$configuration->set('volatile.engine.archiver.storedName', null);
$configuration->set('volatile.engine.archiver.sourceNameOrData', null);
$configuration->set('volatile.engine.archiver.processingfile', false);
// ... and return TRUE = success
return true;
}
/**
* Write the file header before putting the file data into the archive
*
* @param string $sourceNameOrData The path to the file being compressed, or the raw file data for virtual files
* @param string $targetName The target path to be stored inside the archive
* @param bool $isVirtual Is this a virtual file?
* @param bool $isSymlink Is this a symlink?
* @param bool $isDir Is this a directory?
* @param int $compressionMethod The compression method chosen for this file
* @param string $zdata If we have compression method other than 0 this holds the compressed data.
* We return that from this method to avoid having to compress the same data
* twice (once to write the compressed data length in the header and once to
* write the compressed data to the archive).
* @param int $unc_len The uncompressed size of the file / source data
*
* @param string $storedName The file path stored in the archive
* @param string $crc CRC-32 for the file
* @param int $c_len Compressed data length
* @param string $hexdtime ZIP's hexadecimal notation if the file's modification date
* @param int $old_offset Offset of the file header in the part file
*/
protected function writeFileHeader(&$sourceNameOrData, $targetName, &$isVirtual, &$isSymlink, &$isDir,
&$compressionMethod, &$zdata, &$unc_len, &$storedName, &$crc, &$c_len,
&$hexdtime, &$old_offset)
{
static $memLimit = null;
if (is_null($memLimit))
{
$memLimit = $this->getMemoryLimit();
}
$configuration = Factory::getConfiguration();
// See if it's a directory
$isDir = $isVirtual ? false : is_dir($sourceNameOrData);
// See if it's a symlink (w/out dereference)
$isSymlink = false;
if ($this->storeSymlinkTarget && !$isVirtual)
{
$isSymlink = is_link($sourceNameOrData);
}
// Get real size before compression
[$unc_len, $fileModTime] =
$this->getFileSizeAndModificationTime($sourceNameOrData, $isVirtual, $isSymlink, $isDir);
// Decide if we will compress
$compressionMethod = $this->getCompressionMethod($unc_len, $memLimit, $isDir, $isSymlink);
if ($isVirtual)
{
Factory::getLog()->debug(' Virtual add:' . $targetName . ' (' . $unc_len . ') - ' . $compressionMethod);
}
/* "Local file header" segment. */
$crc = $this->getCRCForEntity($sourceNameOrData, $isVirtual, $isDir, $isSymlink);
$storedName = $targetName;
if (!$isSymlink && $isDir)
{
$storedName .= "/";
$unc_len = 0;
}
// Test for non-existing or unreadable files
$this->testIfFileExists($sourceNameOrData, $isVirtual, $isDir, $isSymlink);
// Default compressed (archived) length = uncompressed length – valid unless we can actually compress the data.
$c_len = $unc_len;
// If we have to compress, read the data in memory and compress it
if ($compressionMethod == 8)
{
$this->getZData($sourceNameOrData, $isVirtual, $compressionMethod, $zdata, $unc_len, $c_len);
// The method modifies $compressionMethod to 0 (uncompressed) or 1 (Deflate) but the ZIP format needs it
// to be 0 (uncompressed) or 8 (Deflate). So I just multiply by 8.
$compressionMethod *= 8;
}
// Get the hex time.
$hexdtime = pack('V', $this->unix2DOSTime($fileModTime));
// If it's a split ZIP file, we've got to make sure that the header can fit in the part
if ($this->useSplitArchive)
{
// Get header size, taking into account any extra header necessary
$header_size = 30 + akstrlen($storedName);
// Compare to free part space
$free_space = $this->getPartFreeSize();
if ($free_space <= $header_size)
{
// Not enough space on current part, create new part
$this->createAndOpenNewPart();
}
}
$old_offset = @ftell($this->fp);
if ($this->useSplitArchive && ($old_offset == 0))
{
// Because in split ZIPs we have the split ZIP marker in the first four bytes.
@fseek($this->fp, 4);
$old_offset = @ftell($this->fp);
}
// Get the file name length in bytes
$fn_length = akstrlen($storedName);
$this->fwrite($this->fp, $this->fileHeaderSignature); /* Begin creating the ZIP data. */
/* Version needed to extract. */
if (!$isSymlink)
{
$this->fwrite($this->fp, "\x14\x00");
}
else
{
$this->fwrite($this->fp, "\x0a\x03");
}
$this->fwrite($this->fp, pack('v', 2048)); /* General purpose bit flag. Bit 11 set = use UTF-8 encoding for filenames & comments */
$this->fwrite($this->fp, ($compressionMethod == 8) ? "\x08\x00" : "\x00\x00"); /* Compression method. */
$this->fwrite($this->fp, $hexdtime); /* Last modification time/date. */
$this->fwrite($this->fp, $crc); /* CRC 32 information. */
$this->fwrite($this->fp, pack('V', $c_len)); /* Compressed filesize. */
$this->fwrite($this->fp, pack('V', $unc_len)); /* Uncompressed filesize. */
$this->fwrite($this->fp, pack('v', $fn_length)); /* Length of filename. */
$this->fwrite($this->fp, pack('v', 0)); /* Extra field length. */
$this->fwrite($this->fp, $storedName); /* File name. */
// Cache useful information about the file
if (!$isDir && !$isSymlink && !$isVirtual)
{
$configuration->set('volatile.engine.archiver.unc_len', $unc_len);
$configuration->set('volatile.engine.archiver.hexdtime', $hexdtime);
$configuration->set('volatile.engine.archiver.crc', $crc);
$configuration->set('volatile.engine.archiver.c_len', $c_len);
$configuration->set('volatile.engine.archiver.fn_length', $fn_length);
$configuration->set('volatile.engine.archiver.old_offset', $old_offset);
$configuration->set('volatile.engine.archiver.storedName', $storedName);
$configuration->set('volatile.engine.archiver.sourceNameOrData', $sourceNameOrData);
}
}
/**
* Get the preferred compression method for a file
*
* @param int $fileSize File size in bytes
* @param int $memLimit Memory limit in bytes
* @param bool $isDir Is it a directory?
* @param bool $isSymlink Is it a symlink?
*
* @return int Compression method to use
*/
protected function getCompressionMethod($fileSize, $memLimit, $isDir, $isSymlink)
{
// ZIP uses 0 for uncompressed and 8 for GZip Deflate whereas the parent method returns 0 and 1 respectively
return 8 * parent::getCompressionMethod($fileSize, $memLimit, $isDir, $isSymlink);
}
/**
* Calculate the CRC-32 checksum
*
* @param string $sourceNameOrData The path to the file being compressed, or the raw file data for virtual files
* @param bool $isVirtual Is this a virtual file?
* @param bool $isSymlink Is this a symlink?
* @param bool $isDir Is this a directory?
*
* @return int The CRC-32
*/
protected function getCRCForEntity(&$sourceNameOrData, &$isVirtual, &$isDir, &$isSymlink)
{
// No hash? No CRC32!
if (!function_exists('hash'))
{
return pack('V', 0);
}
// Do I need to reverse the endianness of CRC32b data?
static $reverseEndianness = null;
if ($reverseEndianness === null)
{
$reverseEndianness = hash('crc32b', 'The quick brown fox jumped over the lazy dog.', true) === pack('N', 2191738434);
}
$entityType = 'file';
$loggedName = null;
// Directories: dummy CRC-32
if (!$isSymlink && $isDir)
{
$entityType = 'folder';
$crc = pack('V', 0);
}
// Symlinks: CRC32 of the link source
elseif ($isSymlink)
{
$entityType = 'symlink';
$crc = hash('crc32b', @readlink($sourceNameOrData) ?: '', true);
}
// Virtual files: CRC32 of the contents
elseif ($isVirtual)
{
$entityType = 'virtual file';
$loggedName = sprintf('of size %u', strlen($sourceNameOrData));
$crc = hash('crc32b', $sourceNameOrData ?: '', true);
}
// Files: CRC32 of the file contents
else
{
// Get the CRC32 for the file
$crc = function_exists("hash_file") ? @hash_file('crc32b', $sourceNameOrData, true) : null;
// If the file was unreadable skip it
if ($crc === false)
{
throw new WarningException('Could not calculate CRC32 for ' . $sourceNameOrData . '. Looks like it is an unreadable file.');
}
// If hash_file is not available use a fake CRC32
$crc = $crc ?: pack('V', 0);
}
/**
* If CRC32 returns Big Endian data I'll have to convert it to Little Endian, as required by ZIP.
*
* I cannot unpack as Big Endian and repack as Little Endian. The intermediate conversion to integer might
* overflow 32-bit versions of PHP as its internal integer type is platform-dependent.
*
* I cannot reverse the string using string functions because the internal character encoding may be something
* other than ASCII / 8-bit and mb_string might not be available.
*
* Instead, I am unpacking the binary string as an array of unsigned bytes and then repacking the bytes, in
* reverse order, into a binary string. pack() and unpack() are not affected by the character encoding. Using
* unsigned bytes guarantees they will fit into internal integer variables regardless of the platform used.
*/
if ($crc !== "\000\000\000\000" && $reverseEndianness)
{
$temp = array_values(unpack('C4', $crc));
$crc = pack('C*', $temp[3], $temp[2], $temp[1], $temp[0]);
}
// Log the calculated CRC32 if the site is in debug mode
if (defined('AKEEBADEBUG'))
{
$asHexChars = array_map(
function ($c) {
return dechex($c);
}, unpack('C*', $crc)
);
Factory::getLog()->debug(
sprintf(
'%s %s - CRC32 = %s',
$entityType,
$loggedName ?? $sourceNameOrData,
implode('', $reverseEndianness ? array_reverse($asHexChars) : $asHexChars)
)
);
}
return $crc;
}
/**
* Converts a UNIX timestamp to a 4-byte DOS date and time format
* (date in high 2-bytes, time in low 2-bytes allowing magnitude
* comparison).
*
* @param integer $unixtime The current UNIX timestamp.
*
* @return integer The current date in a 4-byte DOS format.
*/
protected function unix2DOSTime($unixtime = null)
{
$timearray = (is_null($unixtime)) ? getdate() : getdate($unixtime);
if ($timearray['year'] < 1980)
{
$timearray['year'] = 1980;
$timearray['mon'] = 1;
$timearray['mday'] = 1;
$timearray['hours'] = 0;
$timearray['minutes'] = 0;
$timearray['seconds'] = 0;
}
return (($timearray['year'] - 1980) << 25) |
($timearray['mon'] << 21) |
($timearray['mday'] << 16) |
($timearray['hours'] << 11) |
($timearray['minutes'] << 5) |
($timearray['seconds'] >> 1);
}
/**
* Creates a new part for the spanned archive
*
* @param bool $finalPart Is this the final archive part?
*
* @return bool True on success
*/
protected function createNewPartFile($finalPart = false)
{
// Close any open file pointers
if (is_resource($this->fp))
{
$this->fclose($this->fp);
}
if (is_resource($this->cdfp))
{
$this->fclose($this->cdfp);
}
// Remove the just finished part from the list of resumable offsets
$this->removeFromOffsetsList($this->_dataFileName);
// Set the file pointers to null
$this->fp = null;
$this->cdfp = null;
// Push the previous part if we have to post-process it immediately
$configuration = Factory::getConfiguration();
if ($configuration->get('engine.postproc.common.after_part', 0))
{
$this->finishedPart[] = $this->_dataFileName;
}
// Add the part's size to our rolling sum
clearstatcache();
$this->totalCompressedSize += filesize($this->_dataFileName);
$this->totalParts++;
$this->currentPartNumber = $this->totalParts;
if ($finalPart)
{
$this->_dataFileName = $this->dataFileNameWithoutExtension . '.zip';
}
else
{
$this->_dataFileName = $this->dataFileNameWithoutExtension . '.z' . sprintf('%02d', $this->currentPartNumber);
}
Factory::getLog()->info('Creating new ZIP part #' . $this->currentPartNumber . ', file ' . $this->_dataFileName);
// Inform the backup engine that we have changed the multipart number
$statistics = Factory::getStatistics();
$statistics->updateMultipart($this->totalParts);
// Try to remove any existing file
@clearstatcache($this->_dataFileName);
if (file_exists($this->_dataFileName))
{
@unlink($this->_dataFileName);
}
// Touch the new file
$result = @touch($this->_dataFileName);
@chmod($this->_dataFileName, $this->getPermissions());
return $result;
}
/**
* Find the optimal chunk size for CRC32 calculations and file processing
*
* @return void
*/
private function findOptimalChunkSize()
{
$configuration = Factory::getConfiguration();
// The user has entered their own preference
if ($configuration->get('engine.archiver.common.chunk_size', 0) > 0)
{
$this->AkeebaPackerZIP_CHUNK_SIZE = AKEEBA_CHUNK;
return;
}
// Get the PHP memory limit
$memLimit = $this->getMemoryLimit();
// Can't get a PHP memory limit? Use 2Mb chunks (fairly large, right?)
if (is_null($memLimit))
{
$this->AkeebaPackerZIP_CHUNK_SIZE = 2097152;
return;
}
if (!function_exists("memory_get_usage"))
{
// PHP can't report memory usage, use a conservative 512Kb
$this->AkeebaPackerZIP_CHUNK_SIZE = 524288;
return;
}
// PHP *can* report memory usage, see if there's enough available memory
$availableRAM = $memLimit - memory_get_usage();
if ($availableRAM > 0)
{
$this->AkeebaPackerZIP_CHUNK_SIZE = $availableRAM * 0.5;
return;
}
// NEGATIVE AVAILABLE MEMORY?!! Some borked PHP implementations also return the size of the httpd footprint.
if (($memLimit - 6291456) > 0)
{
$this->AkeebaPackerZIP_CHUNK_SIZE = $memLimit - 6291456;
return;
}
// If all else fails, use 2Mb and cross your fingers
$this->AkeebaPackerZIP_CHUNK_SIZE = 2097152;
}
/**
* Create a Central Directory temporary file
*
* @return void
*
* @throws ErrorException
*/
private function createCentralDirectoryTempFile()
{
$configuration = Factory::getConfiguration();
$this->centralDirectoryFilename = tempnam($configuration->get('akeeba.basic.output_directory'), 'akzcd');
$this->centralDirectoryFilename = basename($this->centralDirectoryFilename);
$pos = strrpos($this->centralDirectoryFilename, '/');
if ($pos !== false)
{
$this->centralDirectoryFilename = substr($this->centralDirectoryFilename, $pos + 1);
}
$pos = strrpos($this->centralDirectoryFilename, '\\');
if ($pos !== false)
{
$this->centralDirectoryFilename = substr($this->centralDirectoryFilename, $pos + 1);
}
$this->centralDirectoryFilename = Factory::getTempFiles()->registerTempFile($this->centralDirectoryFilename);
Factory::getLog()->debug(__CLASS__ . " :: CntDir Tempfile = " . $this->centralDirectoryFilename);
// Create temporary file
if (!@touch($this->centralDirectoryFilename))
{
throw new ErrorException("Could not open temporary file for ZIP archiver. Please check your temporary directory's permissions!");
}
@chmod($this->centralDirectoryFilename, $this->getPermissions());
}
}
PK \Rp-a -a , vendor/akeeba/engine/engine/Archiver/Jps.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Base\Exceptions\WarningException;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Encrypt;
use Akeeba\Engine\Util\HashTrait;
use Akeeba\Engine\Util\RandomValue;
if (!defined('_JPS_MAJOR'))
{
define('_JPS_MAJOR', 2);
define('_JPS_MINOR', 0);
}
/**
* JoomlaPack Archive Secure (JPS) creation class
*
* JPS Format 1.9 implemented, minus BZip2 compression support
*/
class Jps extends BaseArchiver
{
use HashTrait;
/** @var integer How many files are contained in the archive */
private $totalFilesCount = 0;
/** @var integer The total size of files contained in the archive as they are stored */
private $totalCompressedSize = 0;
/** @var integer The total size of files contained in the archive when they are extracted to disk. */
private $totalUncompressedSize = 0;
/** @var string Standard Header signature */
private $archiveSignature = "\x4A\x50\x53"; // JPS
/** @var string Standard Header signature */
private $endOfArchiveSignature = "\x4A\x50\x45"; // JPE
/** @var string Entity Block signature */
private $fileHeaderSignature = "\x4A\x50\x46"; // JPF
/** @var int Current part file number */
private $currentPartNumber = 1;
/** @var int Total number of part files */
private $totalParts = 1;
/** @var string The password to use */
private $password = null;
/** @var Encrypt The encryption object used in this class */
private $encryptionObject = null;
/** @var array Static Salt for PBKDF2 */
private $staticSalt = "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
/**
* Also remove the encryption object reference
*
* @codeCoverageIgnore
*
* @return void
*/
public function _onSerialize()
{
parent::_onSerialize();
$this->encryptionObject = null;
}
/**
* Initialises the archiver class, creating the archive from an existent
* installer's JPA archive.
*
* @param string $targetArchivePath Absolute path to the generated archive
* @param array $options A named key array of options (optional)
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: new instance - archive $targetArchivePath");
$this->_dataFileName = $targetArchivePath;
// Make sure the encryption functions are all there
$this->testEncryptionAvailability();
// Get and memorise the password
$config = Factory::getConfiguration();
$this->password = $config->get('engine.archiver.jps.key', '');
if (empty($this->password))
{
Factory::getLog()->warning('You are using an empty password. This is not secure at all!');
}
// Set up the key expansion based on preferences
$pbkdf2UseStaticSalt = $config->get('engine.archiver.jps.pbkdf2usestaticsalt', 1);
$this->encryptionObject
->setPbkdf2Algorithm('sha1')
->setPbkdf2Iterations($pbkdf2UseStaticSalt ? 128000 : 2500)
->setPbkdf2UseStaticSalt($pbkdf2UseStaticSalt);
// If a static salt is to be used let's create one
if ($pbkdf2UseStaticSalt)
{
$rand = new RandomValue();
$this->staticSalt = $rand->generate(64);
$this->encryptionObject->setPbkdf2StaticSalt($this->staticSalt);
}
// Should we enable split archive feature?
$this->enableSplitArchives();
// Should I use Symlink Target Storage?
$this->enableSymlinkTargetStorage();
// Create the new backup archive
$this->createNewBackupArchive();
// Write the initial instance of the archive header
$this->writeArchiveHeader();
}
/**
* Updates the Standard Header with current information
*
* @return void
*/
public function finalize()
{
// Close any open file pointers
if (is_resource($this->fp))
{
$this->fclose($this->fp);
}
if (is_resource($this->cdfp))
{
$this->fclose($this->cdfp);
}
$this->_closeAllFiles();
// If spanned JPS and there is no .jps file, rename the last part to .jps
$this->renameLastPartToJps();
// Write the end of archive header
$this->writeEndOfArchiveHeader();
}
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
public function getExtension()
{
return '.jps';
}
/**
* Returns the length of a string in BYTES, not characters
*
* @param string $string The string to get the length for
*
* @return int The size in BYTES
*/
public function stringLength($string)
{
return function_exists('mb_strlen') ? mb_strlen($string, '8bit') : strlen($string);
}
/**
* Attempt to use mbstring for getting parts of strings
*
* @param string $string
* @param int $start
* @param int|null $length
*
* @return string
*/
public function subString($string, $start, $length = null)
{
return function_exists('mb_substr') ? mb_substr($string, $start, $length, '8bit') :
substr($string, $start, $length);
}
/**
* Outputs a Standard Header at the top of the file
*
* @return void
*
* @throws ErrorException
*/
protected function writeArchiveHeader()
{
if (is_null($this->fp))
{
$this->fp = @$this->fopen($this->_dataFileName, 'r+');
}
if ($this->fp === false)
{
throw new ErrorException('Could not open ' . $this->_dataFileName . ' for writing. Check permissions and open_basedir restrictions.');
}
// === HEADER ===
$this->fwrite($this->fp, $this->archiveSignature); // ID string (JPS)
$this->fwrite($this->fp, pack('C', _JPS_MAJOR)); // Major version
$this->fwrite($this->fp, pack('C', _JPS_MINOR)); // Minor version
$this->fwrite($this->fp, pack('C', $this->useSplitArchive ? 1 : 0)); // Is it a split archive?
// === EXTRA HEADERS (JPS v2.0) ===
// Extra headers length (76 bytes for key expansion header)
$this->fwrite($this->fp, pack('v', 76));
// Password expansion header (28 bytes)
$this->writeKeyExpansionArchiveExtraHeader();
// Change the permissions of the file
@chmod($this->_dataFileName, $this->getPermissions());
}
/**
* Outputs the end of the Standard Header at the file
*
* @return void
*/
protected function writeEndOfArchiveHeader()
{
if (!is_null($this->fp))
{
$this->fclose($this->fp);
$this->fp = null;
}
$this->openArchiveForOutput(true);
$this->fwrite($this->fp, $this->endOfArchiveSignature); // ID string (JPE)
$this->fwrite($this->fp, pack('v', $this->totalParts)); // Total number of parts
$this->fwrite($this->fp, pack('V', $this->totalFilesCount)); // Total number of files
$this->fwrite($this->fp, pack('V', $this->totalUncompressedSize)); // Uncompressed size
$this->fwrite($this->fp, pack('V', $this->totalCompressedSize)); // Compressed size
}
/**
* Extend the bootstrap code to add some define's used by the JPS format engine
*
* @return void
*/
protected function __bootstrap_code()
{
if (!defined('_JPS_MAJOR'))
{
define('_JPS_MAJOR', 1); // JPS Format major version number
define('_JPS_MINOR', 9); // JPS Format minor version number
}
// Set up the key expansion
$this->encryptionObject = Factory::getEncryption();
$config = Factory::getConfiguration();
$pbkdf2UseStaticSalt = $config->get('engine.archiver.jps.pbkdf2usestaticsalt', 1);
$this->encryptionObject
->setPbkdf2Algorithm('sha1')
->setPbkdf2Iterations($pbkdf2UseStaticSalt ? 128000 : 2500)
->setPbkdf2UseStaticSalt($pbkdf2UseStaticSalt);
if ($pbkdf2UseStaticSalt)
{
$this->encryptionObject->setPbkdf2StaticSalt($this->staticSalt);
}
parent::__bootstrap_code();
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param bool $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual is
* true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return boolean True on success, false otherwise
*/
protected function _addFile($isVirtual, &$sourceNameOrData, $targetName)
{
// Get references to engine objects we're going to be using
$configuration = Factory::getConfiguration();
// Is this a virtual file?
$isVirtual = (bool) $isVirtual;
// Open data file for output
$this->openArchiveForOutput();
// Should I continue backing up a file from the previous step?
$continueProcessingFile = $configuration->get('volatile.engine.archiver.processingfile', false);
// Initialize with the default values. Why are *these* values default? If we are continuing file packing, by
// definition we have an uncompressed, non-virtual file. Hence the default values.
$isDir = false;
$isSymlink = false;
if (!$continueProcessingFile)
{
// Log the file being added
$messageSource = $isVirtual ? '(virtual data)' : "(source: $sourceNameOrData)";
Factory::getLog()->debug("-- Adding $targetName to archive $messageSource");
$this->writeFileHeader($sourceNameOrData, $targetName, $isVirtual, $isSymlink, $isDir, $compressionMethod, $fileSize);
}
else
{
$sourceNameOrData = $configuration->get('volatile.engine.archiver.sourceNameOrData', '');
$resume = $configuration->get('volatile.engine.archiver.resume', 0);
$fileSize = $configuration->get('volatile.engine.archiver.unc_len', 0);
// Log the file we continue packing
Factory::getLog()->debug("-- Resuming adding file $sourceNameOrData to archive from position $resume (total size $fileSize)");
}
if ($isSymlink)
{
// Symlink: Single step, one block, uncompressed
$this->putSymlinkToArchive($sourceNameOrData);
}
elseif ($isVirtual)
{
// Virtual: Single step, multiple blocks, compressed
$this->putVirtualFileToArchive($sourceNameOrData);
}
elseif (!$isDir)
{
// Regular file: multiple step, multiple blocks, compressed
if ($this->putFileIntoArchive($sourceNameOrData, $fileSize) === true)
{
return true;
}
}
return true;
}
/**
* Writes an encrypted block to the archive
*
* @param string $data Raw binary data to encrypt and write
*
* @return bool True on success
*/
protected function _writeEncryptedBlock($data)
{
$decryptedSize = akstrlen($data);
$data = $this->encryptionObject->AESEncryptCBC($data, $this->password);
$encryptedSize = akstrlen($data);
// Initialize the value with something suitable for single part archives
$free_space = $encryptedSize + 8;
// Do we have enough space to store the 8 byte header?
if ($this->useSplitArchive)
{
// Compare to free part space
$free_space = $this->getPartFreeSize();
if ($free_space <= 8)
{
$this->createAndOpenNewPart();
}
}
// Write the header
$this->fwrite($this->fp,
pack('V', $encryptedSize) .
pack('V', $decryptedSize)
);
$free_space -= 8;
// Do we have enough space to write the data in one part?
if ($free_space >= $encryptedSize)
{
$this->fwrite($this->fp, $data);
return true;
}
while ($encryptedSize > 0)
{
// Split between parts - Write first part
$dataMD5 = self::md5($data);
$firstPart = aksubstr($data, 0, $free_space);
$data = aksubstr($data, $free_space);
$firstPartLength = akstrlen($firstPart);
if (self::md5($firstPart . $data) != $dataMD5)
{
throw new ErrorException('Multibyte character problems detected');
}
// Try to write to the archive. We can only write as much bytes as the free space in the backup archive OR
// the total data bytes left, whichever is lower.
$bytesWritten = $this->fwrite($this->fp, $firstPart, $firstPartLength);
// Since we may have written fewer bytes than anticipated we use the real bytes written for calculations
$free_space -= $bytesWritten;
$encryptedSize -= $bytesWritten;
// Not all bytes were written. The rest must be placed in front of the remaining data so we can write it
// in the next archive part.
if ($bytesWritten < $firstPartLength)
{
$data = aksubstr($firstPart, $bytesWritten) . $data;
}
// If the part file is full create a new one
if ($free_space <= 0)
{
// Create new part
$this->createAndOpenNewPart();
// Get its free space
$free_space = $this->getPartFreeSize();
}
}
return true;
}
/**
* Creates a new archive part
*
* @param bool $finalPart Set to true if it is the final part (therefore has the .jps extension)
*
* @return bool True on success
*/
protected function createNewPartFile($finalPart = false)
{
// Close any open file pointers
if (is_resource($this->fp))
{
$this->fclose($this->fp);
}
if (is_resource($this->cdfp))
{
$this->fclose($this->cdfp);
}
// Remove the just finished part from the list of resumable offsets
$this->removeFromOffsetsList($this->_dataFileName);
// Set the file pointers to null
$this->fp = null;
$this->cdfp = null;
// Push the previous part if we have to post-process it immediately
$configuration = Factory::getConfiguration();
if ($configuration->get('engine.postproc.common.after_part', 0))
{
$this->finishedPart[] = $this->_dataFileName;
}
$this->totalParts++;
$this->currentPartNumber = $this->totalParts;
if ($finalPart)
{
$this->_dataFileName = $this->dataFileNameWithoutExtension . '.jps';
}
else
{
$this->_dataFileName =
$this->dataFileNameWithoutExtension . '.j' . sprintf('%02d', $this->currentPartNumber);
}
Factory::getLog()->info('Creating new JPS part #' . $this->currentPartNumber . ', file ' . $this->_dataFileName);
// Inform that we have chenged the multipart number
$statistics = Factory::getStatistics();
$statistics->updateMultipart($this->totalParts);
// Try to remove any existing file
@clearstatcache($this->_dataFileName);
if (file_exists($this->_dataFileName))
{
@unlink($this->_dataFileName);
}
// Touch the new file
$result = @touch($this->_dataFileName);
@chmod($this->_dataFileName, $this->getPermissions());
return $result;
}
/**
* Write the header for key expansion into the archive
*
* @return void
*
* @since 5.3.0
*/
protected function writeKeyExpansionArchiveExtraHeader()
{
$expansionParams = $this->encryptionObject->getKeyDerivationParameters();
switch ($expansionParams['algorithm'])
{
default:
case 'sha1':
$algo = 0;
break;
case 'sha256':
$algo = 1;
break;
case 'sha512':
$algo = 2;
break;
}
$hasStaticSalt = $expansionParams['useStaticSalt'];
$staticSalt = $expansionParams['staticSalt'];
if (!$hasStaticSalt)
{
$staticSalt = "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
$staticSalt .= "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
$staticSalt .= "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
$staticSalt .= "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
}
// -- Header
$this->fwrite($this->fp, "JH\x00\x01");
// -- Field length (with header)
$this->fwrite($this->fp, pack('v', 12 + $this->stringLength($staticSalt)));
// -- Algorithm, iterations, has static salt
$this->fwrite($this->fp, pack('CVC', $algo, $expansionParams['iterations'], $hasStaticSalt));
// -- Static salt
$this->fwrite($this->fp, $staticSalt);
}
/**
* Test whether encryption and compression is available and operational on this server.
*
* @return void
*
* @throws ErrorException
*/
private function testEncryptionAvailability()
{
$test = $this->encryptionObject->AESEncryptCBC('test', 'test');
if ($test === false)
{
throw new ErrorException('Sorry, your server does not support AES-128 encryption. Please use a different archive format.');
}
// Make sure we can really compress stuff
if (!function_exists('gzcompress'))
{
throw new ErrorException('Sorry, your server does not support GZip compression which is required for the JPS format. Please use a different archive format.');
}
}
/**
* Rename the extension of the last part of a split archive to .jps
*
* @return void
*
* @throws ErrorException
*/
private function renameLastPartToJps()
{
if (!$this->useSplitArchive)
{
return;
}
$extension = substr($this->_dataFileName, -3);
if ($extension == '.jps')
{
return;
}
Factory::getLog()->debug('Renaming last JPS part to .JPS extension');
$newName = $this->dataFileNameWithoutExtension . '.jps';
if (!@rename($this->_dataFileName, $newName))
{
throw new ErrorException('Could not rename last JPS part to .JPS extension.');
}
$this->_dataFileName = $newName;
}
/**
* Write the file header to the backup archive.
*
* Only the first three parameters are input. All other are ignored for input and are overwritten.
*
* @param string $sourceNameOrData The path to the file being compressed, or the raw file data for virtual files
* @param string $targetName The target path to be stored inside the archive
* @param bool $isVirtual Is this a virtual file?
* @param bool $isSymlink Is this a symlink?
* @param bool $isDir Is this a directory?
* @param int $compressionMethod The compression method chosen for this file
* @param int $fileSize The uncompressed size of the file / source data
*
* @return void
*/
private function writeFileHeader(&$sourceNameOrData, $targetName, &$isVirtual, &$isSymlink, &$isDir, &$compressionMethod, &$fileSize)
{
$configuration = Factory::getConfiguration();
// Uncache data
$configuration->set('volatile.engine.archiver.sourceNameOrData', null);
$configuration->set('volatile.engine.archiver.unc_len', null);
$configuration->set('volatile.engine.archiver.resume', null);
$configuration->set('volatile.engine.archiver.processingfile', false);
// See if it's a directory
$isDir = $isVirtual ? false : is_dir($sourceNameOrData);
// See if it's a symlink (w/out dereference)
$isSymlink = false;
if ($this->storeSymlinkTarget && !$isVirtual)
{
$isSymlink = is_link($sourceNameOrData);
}
// Get real size before compression
[$fileSize, $fileModTime] =
$this->getFileSizeAndModificationTime($sourceNameOrData, $isVirtual, $isSymlink, $isDir);
// Decide if we will compress
$compressionMethod = ($isDir || $isSymlink) ? 0 : 1;
// Fix stored name for directories
$storedName = $targetName;
$storedName .= ($isDir) ? "/" : "";
// Get file permissions
$perms = $isVirtual ? 0644 : @fileperms($sourceNameOrData);
// Get file type
$fileType = 1;
if ($isSymlink)
{
$fileType = 2;
}
elseif ($isDir)
{
$fileType = 0;
}
// Create the Entity Description Block Data
$headerData =
pack('v', akstrlen($storedName)) // Length of entity path
. $storedName // Entity path
. pack('c', $fileType) // Entity type
. pack('c', $compressionMethod) // Compression type
. pack('V', $fileSize) // Uncompressed size
. pack('V', $perms) // Entity permissions
. pack('V', $fileModTime) // File Modification Time
;
// Create and write the Entity Description Block Header
$decryptedSize = akstrlen($headerData);
$headerData = $this->encryptionObject->AESEncryptCBC($headerData, $this->password);
$encryptedSize = akstrlen($headerData);
$headerData =
$this->fileHeaderSignature . // JPF
pack('v', $encryptedSize) . // Encrypted size
pack('v', $decryptedSize) . // Decrypted size
$headerData // Encrypted Entity Description Block Data
;
// Do we have enough space to store the header?
if ($this->useSplitArchive)
{
// Compare to free part space
$free_space = $this->getPartFreeSize();
if ($free_space <= akstrlen($headerData))
{
// Not enough space on current part, create new part
$this->createAndOpenNewPart();
}
}
// Write the header data
$this->fwrite($this->fp, $headerData);
// Cache useful information about the file
$configuration->set('volatile.engine.archiver.sourceNameOrData', $sourceNameOrData);
$configuration->set('volatile.engine.archiver.unc_len', $fileSize);
// Update global stats
$this->totalFilesCount++;
$this->totalUncompressedSize += $fileSize;
}
/**
* Put a symlink into the archive
*
* @param string $sourceNameOrData The link to add to the archive
*/
private function putSymlinkToArchive(&$sourceNameOrData)
{
$data = @readlink($sourceNameOrData);
$this->_writeEncryptedBlock($data);
$this->totalCompressedSize += akstrlen($data);
}
/**
* Put a virtual file into the archive
*
* @param string $sourceNameOrData The file contents to put into the archive
*
* @return void
*
* @throws ErrorException
*/
private function putVirtualFileToArchive(&$sourceNameOrData)
{
if (akstrlen($sourceNameOrData) <= 0)
{
return;
}
// Loop in 64Kb blocks
while (akstrlen($sourceNameOrData) > 0)
{
// Get up to 64Kb
$data = aksubstr($sourceNameOrData, 0, 65535);
// Compress and encrypt data
$data = gzcompress($data);
$data = aksubstr(aksubstr($data, 0, -4), 2);
$this->_writeEncryptedBlock($data);
// Update the compressed size counter
$this->totalCompressedSize += akstrlen($data);
// Remove the portion of the data we just handled from the source
if (akstrlen($data) < akstrlen($sourceNameOrData))
{
$sourceNameOrData = aksubstr($sourceNameOrData, 65535);
}
else
{
$sourceNameOrData = '';
}
}
}
/**
* Begin or resume adding a file to the archive
*
* @param string $sourceNameOrData Path to the file being added to the archive
*
* @return bool True if we must resume file processing in the next step
*/
private function putFileIntoArchive(&$sourceNameOrData, $fileSize)
{
$configuration = Factory::getConfiguration();
$timer = Factory::getTimer();
$resume = null;
// Get resume information of required
$continueProcessingFile = $configuration->get('volatile.engine.archiver.processingfile', false);
if ($continueProcessingFile)
{
$resume = $configuration->get('volatile.engine.archiver.resume', 0);
Factory::getLog()->debug("(cont) Source: $sourceNameOrData - Size: $fileSize - Resume: $resume");
}
// Open the file
$zdatafp = @fopen($sourceNameOrData, "rb");
if ($zdatafp === false)
{
throw new WarningException('Unreadable file ' . $sourceNameOrData . '. Check permissions');
}
// Seek to the resume point if required
if ($continueProcessingFile)
{
// Seek to new offset
$seek_result = @fseek($zdatafp, $resume);
if ($seek_result === -1)
{
// What?! We can't resume!
$this->conditionalFileClose($zdatafp);
throw new ErrorException(sprintf('Could not resume packing of file %s. Your archive is damaged!', $sourceNameOrData));
}
// Doctor the uncompressed size to match the remainder of the data
$fileSize = $fileSize - $resume;
}
while (!@feof($zdatafp) && ($timer->getTimeLeft() > 0) && ($fileSize > 0))
{
$zdata = @fread($zdatafp, AKEEBA_CHUNK);
$fileSize -= min(akstrlen($zdata), AKEEBA_CHUNK);
$zdata = gzcompress($zdata);
$zdata = aksubstr(aksubstr($zdata, 0, -4), 2);
try
{
$this->_writeEncryptedBlock($zdata);
}
catch (ErrorException $e)
{
$this->conditionalFileClose($zdatafp);
throw $e;
}
$this->totalCompressedSize += akstrlen($zdata);
}
$mustResume = false;
$resume = null;
// WARNING!!! The extra $fileSize != 0 check is necessary as PHP won't reach EOF for 0-byte files.
if (!feof($zdatafp) && ($fileSize != 0))
{
// We have to break, or we'll time out!
$mustResume = true;
$resume = @ftell($zdatafp);
}
$configuration->set('volatile.engine.archiver.resume', $resume);
$configuration->set('volatile.engine.archiver.processingfile', $mustResume);
$this->conditionalFileClose($zdatafp);
return $mustResume;
}
}
PK \C+g g 5 vendor/akeeba/engine/engine/Archiver/BaseArchiver.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Base\Exceptions\WarningException;
use Akeeba\Engine\Factory;
if (!defined('AKEEBA_CHUNK'))
{
$configuration = Factory::getConfiguration();
$chunksize = $configuration->get('engine.archiver.common.chunk_size', 1048576);
define('AKEEBA_CHUNK', $chunksize);
}
if (!function_exists('aksubstr'))
{
/**
* Attempt to use mbstring for getting parts of strings
*
* @param string $string
* @param int $start
* @param int|null $length
*
* @return string
*/
function aksubstr($string, $start, $length = null)
{
return function_exists('mb_substr') ? mb_substr($string, $start, $length, '8bit') :
substr($string, $start, $length);
}
}
/**
* Abstract class for custom archiver implementations
*/
abstract class BaseArchiver extends BaseFileManagement
{
/** @var array The last part which has been finalized and waits to be post-processed */
public $finishedPart = [];
/** @var resource File pointer to the archive being currently written to */
protected $fp = null;
/** @var resource File pointer to the archive's central directory file (for ZIP) */
protected $cdfp = null;
/** @var string The name of the file holding the archive's data, which becomes the final archive */
protected $_dataFileName;
/** @var string Archive full path without extension */
protected $dataFileNameWithoutExtension = '';
/** @var bool Should I store symlinks as such (no dereferencing?) */
protected $storeSymlinkTarget = false;
/** @var int Part size for split archives, in bytes */
protected $partSize = 0;
/** @var bool Should I use Split ZIP? */
protected $useSplitArchive = false;
/** @var int Permissions for the backup archive part files */
protected $permissions = null;
/**
* Release file pointers when the object is being serialized
*
* @codeCoverageIgnore
*
* @return void
*/
public function _onSerialize()
{
$this->_closeAllFiles();
$this->fp = null;
$this->cdfp = null;
}
/**
* Release file pointers when the object is being destroyed
*
* @codeCoverageIgnore
*
* @return void
*/
public function __destruct()
{
$this->_closeAllFiles();
$this->fp = null;
$this->cdfp = null;
}
/**
* Create a new archive part file (but does NOT open it for writing)
*
* @param bool $finalPart True if this is the final part
*
* @return bool False if creating a new part fails
*/
abstract protected function createNewPartFile($finalPart = false);
/**
* Create a new part file and open it for writing
*
* @param bool $finalPart Is this the final part?
*
* @return void
*/
protected function createAndOpenNewPart($finalPart = false)
{
@$this->fclose($this->fp);
$this->fp = null;
// Not enough space on current part, create new part
if (!$this->createNewPartFile($finalPart))
{
$extension = $this->getExtension();
$extension = ltrim(strtoupper($extension), '.');
throw new ErrorException("Could not create new $extension part file " . basename($this->_dataFileName));
}
$this->openArchiveForOutput(true);
}
/**
* Create a new backup archive
*
* @return void
*
* @throws ErrorException
*/
protected function createNewBackupArchive()
{
Factory::getLog()->debug(__CLASS__ . " :: Killing old archive");
$this->fp = $this->fopen($this->_dataFileName, "w");
if ($this->fp === false)
{
if (file_exists($this->_dataFileName))
{
@unlink($this->_dataFileName);
}
@touch($this->_dataFileName);
@chmod($this->_dataFileName, 0666);
$this->fp = $this->fopen($this->_dataFileName, "w");
if ($this->fp !== false)
{
throw new ErrorException("Could not open archive file '{$this->_dataFileName}' for append!");
}
}
@ftruncate($this->fp, 0);
}
/**
* Opens the backup archive file for output. Returns false if the archive file cannot be opened in binary append
* mode.
*
* @param bool $force Should I forcibly reopen the file? If false, I'll only open the file if the current
* file pointer is null.
*
* @return void
*/
protected function openArchiveForOutput($force = false)
{
if (is_null($this->fp) || $force)
{
$this->fp = $this->fopen($this->_dataFileName, "a");
}
if ($this->fp === false)
{
$this->fp = null;
throw new ErrorException("Could not open archive file '{$this->_dataFileName}' for append!");
}
}
/**
* Converts a human formatted size to integer representation of bytes,
* e.g. 1M to 1024768
*
* @param string $setting The value in human readable format, e.g. "1M"
*
* @return integer The value in bytes
*/
protected function humanToIntegerBytes($setting)
{
$val = trim($setting);
$last = strtolower($val[strlen($val) - 1]);
if (is_numeric($last))
{
return $setting;
}
switch ($last)
{
case 't':
$val *= 1024;
case 'g':
$val *= 1024;
case 'm':
$val *= 1024;
case 'k':
$val *= 1024;
}
return (int) $val;
}
/**
* Get the PHP memory limit in bytes
*
* @return int|null Memory limit in bytes or null if we can't figure it out.
*/
protected function getMemoryLimit()
{
if (!function_exists('ini_get'))
{
return null;
}
$memLimit = ini_get("memory_limit");
if ((is_numeric($memLimit) && ($memLimit < 0)) || !is_numeric($memLimit))
{
$memLimit = 0; // 1.2a3 -- Rare case with memory_limit < 0, e.g. -1Mb!
}
$memLimit = $this->humanToIntegerBytes($memLimit);
return $memLimit;
}
/**
* Enable storing of symlink target if we are not on Windows
*
* @return void
*/
protected function enableSymlinkTargetStorage()
{
$configuration = Factory::getConfiguration();
$dereferenceSymlinks = $configuration->get('engine.archiver.common.dereference_symlinks', true);
if ($dereferenceSymlinks)
{
return;
}
// We are told not to dereference symlinks. Are we on Windows?
$isWindows = (DIRECTORY_SEPARATOR == '\\');
if (function_exists('php_uname'))
{
$isWindows = stristr(php_uname(), 'windows');
}
// If we are not on Windows, enable symlink target storage
$this->storeSymlinkTarget = !$isWindows;
}
/**
* Gets the file size and last modification time (also works on virtual files and symlinks)
*
* @param string $sourceNameOrData File path to the source file or source data (if $isVirtual is true)
* @param bool $isVirtual Is this a virtual file?
* @param bool $isSymlink Is this a symlink?
* @param bool $isDir Is this a directory?
*
* @return array
*/
protected function getFileSizeAndModificationTime(&$sourceNameOrData, $isVirtual, $isSymlink, $isDir)
{
// Get real size before compression
if ($isVirtual)
{
$fileSize = akstrlen($sourceNameOrData);
$fileModTime = time();
return [$fileSize, $fileModTime];
}
if ($isSymlink)
{
$fileSize = akstrlen(@readlink($sourceNameOrData));
$fileModTime = 0;
return [$fileSize, $fileModTime];
}
// Is the file readable?
if (!is_readable($sourceNameOrData) && !$isDir)
{
// Really, REALLY check if it is readable (PHP sometimes lies, dammit!)
$myFP = @$this->fopen($sourceNameOrData, 'r');
if ($myFP === false)
{
// Unreadable file, skip it.
throw new WarningException('Unreadable file ' . $sourceNameOrData . '. Check permissions');
}
@$this->fclose($myFP);
}
// Get the file size
$fileSize = $isDir ? 0 : @filesize($sourceNameOrData);
$fileModTime = $isDir ? 0 : @filemtime($sourceNameOrData);
return [$fileSize, $fileModTime];
}
/**
* Get the preferred compression method for a file
*
* @param int $fileSize File size in bytes
* @param int $memLimit Memory limit in bytes
* @param bool $isDir Is it a directory?
* @param bool $isSymlink Is it a symlink?
*
* @return int Compression method to use: 0 (uncompressed) or 1 (gzip deflate)
*/
protected function getCompressionMethod($fileSize, $memLimit, $isDir, $isSymlink)
{
// If we don't have gzip installed we can't compress anything
if (!function_exists("gzcompress"))
{
return 0;
}
// Don't compress directories or symlinks
if ($isDir || $isSymlink)
{
return 0;
}
// Do not compress files over the compression threshold
if ($fileSize >= _AKEEBA_COMPRESSION_THRESHOLD)
{
return 0;
}
// No memory limit, file smaller than the compression threshold: always compress.
if (is_numeric($memLimit) && ($memLimit == 0))
{
return 1;
}
// Non-zero memory limit, PHP can report memory usage, see if there's enough memory.
if (is_numeric($memLimit) && function_exists("memory_get_usage"))
{
$availableRAM = $memLimit - memory_get_usage();
// Conservative approach: if the file size is over 40% of the available memory we won't compress.
$compressionMethod = (($availableRAM / 2.5) >= $fileSize) ? 1 : 0;
return $compressionMethod;
}
// Non-zero memory limit, PHP can't report memory usage, compress only files up to 512Kb (very conservative)
return ($fileSize <= 524288) ? 1 : 0;
}
/**
* Checks if the file exists and is readable
*
* @param string $sourceNameOrData The path to the file being compressed, or the raw file data for virtual files
* @param bool $isVirtual Is this a virtual file?
* @param bool $isSymlink Is this a symlink?
* @param bool $isDir Is this a directory?
*
* @return void
*
* @throws WarningException
*/
protected function testIfFileExists(&$sourceNameOrData, &$isVirtual, &$isDir, &$isSymlink)
{
if ($isVirtual || $isDir)
{
return;
}
if (!@file_exists($sourceNameOrData))
{
if ($isSymlink)
{
throw new WarningException('The symlink ' . $sourceNameOrData . ' points to a file or folder that no longer exists and will NOT be backed up.');
}
throw new WarningException('The file ' . $sourceNameOrData . ' no longer exists and will NOT be backed up. Are you backing up temporary or cache data?');
}
if (!@is_readable($sourceNameOrData))
{
throw new WarningException('Unreadable file ' . $sourceNameOrData . '. Check permissions.');
}
}
/**
* Try to get the compressed data for a file
*
* @param string $sourceNameOrData
* @param bool $isVirtual
* @param int $compressionMethod
* @param string $zdata
* @param int $unc_len
* @param int $c_len
*
* @return void
*/
protected function getZData(&$sourceNameOrData, &$isVirtual, &$compressionMethod, &$zdata, &$unc_len, &$c_len)
{
// Get uncompressed data
$udata =& $sourceNameOrData;
if (!$isVirtual)
{
$udata = @file_get_contents($sourceNameOrData);
if ($udata === false)
{
@clearstatcache($sourceNameOrData);
$fileExists = @file_exists($sourceNameOrData);
if (!$fileExists)
{
throw new ErrorException(
sprintf(
'The file %s went away before we could start putting it in the backup archive. We cannot continue the backup. Your archive is damaged! If this is a temporary, cache, or log file we advise you to exclude it from the backup. If its containing directory is meant to include temporary, cache, or log file we recommend that you exclude the contents of the file\'s containing folder.',
$sourceNameOrData
)
);
}
throw new ErrorException('Unreadable file ' . $sourceNameOrData . '. Check permissions. Your archive is corrupt!');
}
}
// If the compression fails, we will let it behave like no compression was available
$c_len = $unc_len;
$compressionMethod = 0;
// Proceed with compression
$zdata = @gzcompress($udata);
if ($zdata !== false)
{
// The compression succeeded
unset($udata);
$compressionMethod = 1;
$zdata = aksubstr($zdata, 2, -4);
$c_len = akstrlen($zdata);
}
}
/**
* Returns the bytes available for writing data to the current part file (i.e. part size minus current offset)
*
* @return int
*/
protected function getPartFreeSize()
{
clearstatcache();
$current_part_size = @filesize($this->_dataFileName);
return (int) $this->partSize - ($current_part_size === false ? 0 : $current_part_size);
}
/**
* Enable split archive creation where possible
*
* @return void
*/
protected function enableSplitArchives()
{
$configuration = Factory::getConfiguration();
$partSize = $configuration->get('engine.archiver.common.part_size', 0);
// If the part size is less than 64Kb we won't enable split archives
if ($partSize < 65536)
{
return;
}
$extension = $this->getExtension();
$altExtension = substr($extension, 0, 2) . '01';
$archiveTypeUppercase = strtoupper(substr($extension, 1));
Factory::getLog()->info(__CLASS__ . " :: Split $archiveTypeUppercase creation enabled");
$this->useSplitArchive = true;
$this->partSize = $partSize;
$this->dataFileNameWithoutExtension =
dirname($this->_dataFileName) . '/' . basename($this->_dataFileName, $extension);
$this->_dataFileName = $this->dataFileNameWithoutExtension . $altExtension;
// Indicate that we have at least 1 part
$statistics = Factory::getStatistics();
$statistics->updateMultipart(1);
}
/**
* Write a file's GZip compressed data to the archive, taking into account archive splitting
*
* @param string $zdata The compressed data to write to the archive
*
* @return void
*/
protected function putRawDataIntoArchive(&$zdata)
{
// Single part archive. Just dump the compressed data.
if (!$this->useSplitArchive)
{
$this->fwrite($this->fp, $zdata);
return;
}
// Split JPA. Check if we need to split the part in the middle of the data.
$freeSpaceInPart = $this->getPartFreeSize();
// Nope. We have enough space to write all of the data in this part.
if ($freeSpaceInPart >= akstrlen($zdata))
{
$this->fwrite($this->fp, $zdata);
return;
}
$bytesLeftInData = akstrlen($zdata);
while ($bytesLeftInData > 0)
{
// Try to write to the archive. We can only write as much bytes as the free space in the backup archive OR
// the total data bytes left, whichever is lower.
$bytesWritten = $this->fwrite($this->fp, $zdata, min($bytesLeftInData, $freeSpaceInPart));
// Since we may have written fewer bytes than anticipated we use the real bytes written for calculations
$freeSpaceInPart -= $bytesWritten;
$bytesLeftInData -= $bytesWritten;
// If we still have data to write, remove the part already written and keep the rest
if ($bytesLeftInData > 0)
{
$zdata = aksubstr($zdata, -$bytesLeftInData);
}
// If the part file is full create a new one
if ($freeSpaceInPart <= 0)
{
// Create new part
$this->createAndOpenNewPart();
// Get its free space
$freeSpaceInPart = $this->getPartFreeSize();
}
}
// Tell PHP to free up some memory
$zdata = null;
}
/**
* Begin or resume adding an uncompressed file into the archive.
*
* IMPORTANT! Only this case can be spanned across steps: uncompressed, non-virtual data
*
* @param string $sourceNameOrData The path to the file we are reading from.
* @param int $fileLength The file size we are supposed to read, in bytes.
* @param int $resumeOffset Offset in the file to resume reading from
*
* @return bool True to indicate more processing is required in the next step
*/
protected function putUncompressedFileIntoArchive(&$sourceNameOrData, $fileLength = 0, $resumeOffset = null)
{
$expectedTotalLength = $fileLength;
// Copy the file contents, ignore directories
$sourceFilePointer = @fopen($sourceNameOrData, "r");
if ($sourceFilePointer === false)
{
clearstatcache($sourceNameOrData);
$fileExists = @file_exists($sourceNameOrData);
if (!$fileExists && $resumeOffset === null)
{
throw new ErrorException(
sprintf(
'The file %s went away before we could start putting it in the backup archive. We cannot continue the backup. Your archive is damaged! If this is a temporary, cache, or log file we advise you to exclude it from the backup. If its containing directory is meant to include temporary, cache, or log file we recommend that you exclude the contents of the file\'s containing folder.',
$sourceNameOrData
)
);
}
if (!$fileExists)
{
throw new ErrorException(
sprintf(
'The file %s went away while putting it in the backup archive. We cannot continue the backup. Your archive is damaged! If this is a temporary, cache, or log file we advise you to exclude it from the backup. If its containing directory is meant to include temporary, cache, or log file we recommend that you exclude the contents of the file\'s containing folder.',
$sourceNameOrData
)
);
}
// If we have already written the file header and can't read the data your archive is busted.
throw new ErrorException('Unreadable file ' . $sourceNameOrData . '. Check permissions. Your archive is corrupt!');
}
// Seek to the resume point if required
if (!is_null($resumeOffset))
{
// Seek to new offset
$seek_result = @fseek($sourceFilePointer, $resumeOffset);
if ($seek_result === -1)
{
// What?! We can't resume!
$this->conditionalFileClose($sourceFilePointer);
Factory::getLog()->warning(
sprintf('The file %s went away!', $sourceNameOrData)
);
throw new ErrorException(sprintf('Could not resume packing of file %s. Your archive is damaged!', $sourceNameOrData));
}
// Change the uncompressed size to reflect the remaining data
$fileLength -= $resumeOffset;
}
$mustBreak = $this->putDataFromFileIntoArchive($sourceFilePointer, $fileLength, $expectedTotalLength);
$this->conditionalFileClose($sourceFilePointer);
return $mustBreak;
}
/**
* Return the requested permissions for the backup archive file.
*
* @return int
* @since 8.0.0
*/
protected function getPermissions(): int
{
if (!is_null($this->permissions))
{
return $this->permissions;
}
$configuration = Factory::getConfiguration();
$permissions = $configuration->get('engine.archiver.common.permissions', '0666') ?: '0666';
$this->permissions = octdec($permissions);
return $this->permissions;
}
/**
* Put up to $fileLength bytes of the file pointer $sourceFilePointer into the backup archive. Returns true if we
* ran out of time and need to perform a step break. Returns false when the whole quantity of data has been copied.
* Throws an ErrorException if something terrible happens.
*
* @param resource $sourceFilePointer The pointer to the input file
* @param int $fileLength How many bytes to copy
*
* @return bool True to indicate we need to resume packing the file in the next step
*/
private function putDataFromFileIntoArchive(&$sourceFilePointer, &$fileLength, $expectedTotalLength)
{
// Get references to engine objects we're going to be using
$configuration = Factory::getConfiguration();
$timer = Factory::getTimer();
$isEOF = false;
// Quick copy data into the archive, AKEEBA_CHUNK bytes at a time
while (!$isEOF && ($timer->getTimeLeft() > 0) && ($fileLength > 0))
{
// DEBUG - Artificial delay for development purposes
if (defined('AKEEBA_DEBUG_BIG_FILE_MULTIPART_DELAY'))
{
usleep(AKEEBA_DEBUG_BIG_FILE_MULTIPART_DELAY);
}
// Normally I read up to AKEEBA_CHUNK bytes at a time, unless the remaining $fileLength is smaller.
$chunkSize = min(AKEEBA_CHUNK, $fileLength);
// Do I have a split ZIP?
if ($this->useSplitArchive)
{
// I must only read up to the free space in the part file if it's less than AKEEBA_CHUNK.
$free_space = $this->getPartFreeSize();
$chunkSize = min($free_space, AKEEBA_CHUNK, $fileLength);
// If I ran out of free space I have to create a new part file.
if ($free_space <= 0)
{
$this->createAndOpenNewPart();
// We have created the part. If the user asked for immediate post-proc, break step now.
if ($configuration->get('engine.postproc.common.after_part', 0))
{
$resumeOffset = @ftell($sourceFilePointer);
$this->conditionalFileClose($sourceFilePointer);
$configuration->set('volatile.engine.archiver.resume', $resumeOffset);
$configuration->set('volatile.engine.archiver.processingfile', true);
$configuration->set('volatile.breakflag', true);
// Always close the open part when immediate post-processing is requested
@$this->fclose($this->fp);
$this->fp = null;
return true;
}
// No immediate post-proc. Recalculate the optimal chunk size.
$free_space = $this->getPartFreeSize();
$chunkSize = min($free_space, AKEEBA_CHUNK, $fileLength);
}
}
// Read some data and write it to the backup archive part file
$data = fread($sourceFilePointer, $chunkSize);
$bytesWritten = $this->fwrite($this->fp, $data, akstrlen($data));
// Subtract the written bytes from the bytes left to write
$fileLength -= $bytesWritten;
// Have we reached the End of File?
$isEOF = feof($sourceFilePointer);
/**
* CATCH FILE SIZE CHANGE: THE FILE GREW
*
* PHP claims we have not reached EOF, but $fileLength is 0 which means that we have read as much data as
* there was to read from the file. This is suspicious.
*
* First, we check if this is really true by trying to read one more byte. If this fails, it means that we
* actually have reached EOF, but either PHP or the underlying Operating System did something funky. In this
* case we just shrug and move on.
*
* If, however, we COULD read another byte it means that the file grew between starting to back it up and
* reaching this point. In this case we will warn the user. Most likely we have a temporary, or log file
* (usually a PHP error log) which should be **excluded** from the backup.
*/
if (!$isEOF && $fileLength === 0)
{
$junk = fread($sourceFilePointer, 1);
if ($junk === false || is_string($junk) && strlen($junk) === 0)
{
break;
}
$metaData = stream_get_meta_data($sourceFilePointer);
@clearstatcache($metaData['uri']);
$actualFileSize = @filesize($metaData['uri']);
Factory::getLog()->warning(
sprintf(
'The file %s grew while putting it in the backup archive. Expected size: %u bytes. Actual size: %u. If this is a temporary, cache, or log file we advise you to exclude it from the backup. If its containing directory is meant to include temporary, cache, or log file we recommend that you exclude the contents of the file\'s containing folder.',
$metaData['uri'], $expectedTotalLength, $actualFileSize
)
);
break;
}
/**
* CATCH FILE SIZE CHANGE: THE FILE SHRUNK
*
* PHP claims that we have reached EOF, but $fileLength is greater than zero, i.e. we have not read as much
* data from the file as its size was at the start of the backup. This means that the file shrunk between
* start of backup and now.
*
* Since we cannot create data out of nothing we have to warn the user about this problem and immediately
* fail the backup. Most likely this was a temporary file, therefore it (or its containing directory) needs
* to be excluded from the backup.
*/
if ($isEOF && ($fileLength > 0))
{
$metaData = stream_get_meta_data($sourceFilePointer);
@clearstatcache($metaData['uri']);
$fileExists = @file_exists($metaData['uri']);
$actualFileSize = $fileExists ? @filesize($metaData['uri']) : null;
if ($fileExists)
{
Factory::getLog()->warning(
sprintf('The file %s shrunk during backup.', $metaData['uri'])
);
throw new ErrorException(
sprintf(
'The file %s shrunk while putting it in the backup archive. Expected size: %u bytes. Actual size: %u. We cannot continue the backup. Your archive is damaged! If this is a temporary, cache, or log file we advise you to exclude it from the backup. If its containing directory is meant to include temporary, cache, or log file we recommend that you exclude the contents of the file\'s containing folder.',
$metaData['uri'], $expectedTotalLength, $actualFileSize
)
);
}
else
{
Factory::getLog()->warning(
sprintf('The file %s went away during backup.', $metaData['uri'])
);
throw new ErrorException(
sprintf(
'The file %s went away while putting it in the backup archive. We cannot continue the backup. Your archive is damaged! If this is a temporary, cache, or log file we advise you to exclude it from the backup. If its containing directory is meant to include temporary, cache, or log file we recommend that you exclude the contents of the file\'s containing folder.',
$metaData['uri']
)
);
}
}
}
// WARNING!!! The extra $unc_len != 0 check is necessary as PHP won't reach EOF for 0-byte files.
if (!feof($sourceFilePointer) && ($fileLength != 0))
{
// We have to break, or we'll time out!
$resumeOffset = @ftell($sourceFilePointer);
$this->conditionalFileClose($sourceFilePointer);
$configuration->set('volatile.engine.archiver.resume', $resumeOffset);
$configuration->set('volatile.engine.archiver.processingfile', true);
return true;
}
return false;
}
}
PK \T. ; vendor/akeeba/engine/engine/Archiver/BaseFileManagement.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Factory;
if (!function_exists('akstrlen'))
{
/**
* Attempt to use mbstring for calculating the binary string length.
*
* @param $string
*
* @return int
*/
function akstrlen($string)
{
return function_exists('mb_strlen') ? mb_strlen($string, '8bit') : strlen($string);
}
}
/**
* Abstract class for an archiver using managed file pointers
*/
abstract class BaseFileManagement extends Base
{
/** @var resource File pointer to the archive's central directory file (for ZIP) */
protected $cdfp = null;
/** @var resource File pointer to the archive being currently written to */
protected $fp = null;
/** @var array An array of the last open files for writing and their last written to offsets */
private $fileOffsets = [];
/** @var array An array of open file pointers */
private $filePointers = [];
/** @var null|string The last filename fwrite() wrote to */
private $lastFileName = null;
/** @var null|resource The last file pointer fwrite() wrote to */
private $lastFilePointer = null;
/**
* Release file pointers when the object is being destroyed
*
* @codeCoverageIgnore
*
* @return void
*/
public function __destruct()
{
$this->_closeAllFiles();
$this->fp = null;
$this->cdfp = null;
}
/**
* Release file pointers when the object is being serialized
*
* @codeCoverageIgnore
*
* @return void
*/
public function _onSerialize()
{
$this->_closeAllFiles();
$this->fp = null;
$this->cdfp = null;
}
/**
* Closes all open files known to this archiver object
*
* @return void
*/
protected function _closeAllFiles()
{
if (!empty($this->filePointers))
{
foreach ($this->filePointers as $file => $fp)
{
$this->conditionalFileClose($fp);
unset($this->filePointers[$file]);
}
}
}
/**
* Closes an already open file
*
* @param resource $fp The file pointer to close
*
* @return boolean
*/
protected function fclose(&$fp)
{
$result = true;
$offset = array_search($fp, $this->filePointers, true);
if (!is_null($fp) && is_resource($fp))
{
$result = $this->conditionalFileClose($fp);
}
if ($offset !== false)
{
unset($this->filePointers[$offset]);
}
$fp = null;
return $result;
}
protected function fcloseByName($file)
{
if (!array_key_exists($file, $this->filePointers))
{
return true;
}
$ret = $this->fclose($this->filePointers[$file]);
if (array_key_exists($file, $this->filePointers))
{
unset($this->filePointers[$file]);
}
return $ret;
}
/**
* Opens a file, if it's not already open, or returns its cached file pointer if it's already open
*
* @param string $file The filename to open
* @param string $mode File open mode, defaults to binary write
*
* @return resource
*/
protected function fopen($file, $mode = 'w')
{
if (!array_key_exists($file, $this->filePointers))
{
//Factory::getLog()->debug("Opening backup archive $file with mode $mode");
$this->filePointers[$file] = @fopen($file, $mode);
// If we open a file for append we have to seek to the correct offset
if (substr($mode, 0, 1) == 'a')
{
if (isset($this->fileOffsets[$file]))
{
Factory::getLog()->debug("Truncating backup archive file $file to " . $this->fileOffsets[$file] . " bytes");
@ftruncate($this->filePointers[$file], $this->fileOffsets[$file]);
}
fseek($this->filePointers[$file], 0, SEEK_END);
}
}
return $this->filePointers[$file];
}
/**
* Write to file, defeating magic_quotes_runtime settings (pure binary write)
*
* @param resource $fp Handle to a file
* @param string $data The data to write to the file
* @param integer $p_len Maximum length of data to write
*
* @return int The number of bytes written
*
* @throws ErrorException When writing to the file is not possible
*/
protected function fwrite($fp, $data, $p_len = null)
{
if ($fp !== $this->lastFilePointer)
{
$this->lastFilePointer = $fp;
$this->lastFileName = array_search($fp, $this->filePointers, true);
}
$len = is_null($p_len) ? (akstrlen($data)) : $p_len;
$ret = fwrite($fp, $data, $len);
if (($ret === false) || (abs(($ret - $len)) >= 1))
{
// Log debug information about the archive file's existence and current size. This helps us figure out if
// there is a server-imposed maximum file size limit.
clearstatcache();
$fileExists = @file_exists($this->lastFileName) ? 'exists' : 'does NOT exist';
$currentSize = @filesize($this->lastFileName);
Factory::getLog()->debug(sprintf("%s::_fwrite() ERROR!! Cannot write to archive file %s. The file %s. File size %s bytes after writing %s of %d bytes. Please check the output directory permissions and make sure you have enough disk space available. If this does not help, please set up a Part Size for Split Archives LOWER than this size and retry backing up.", __CLASS__, $this->lastFileName, $fileExists, $currentSize, $ret, $len));
throw new ErrorException(sprintf("Couldn\'t write to the archive file; check the output directory permissions and make sure you have enough disk space available. [len=%s / %s]", $ret, $len));
}
if ($this->lastFileName !== false)
{
$this->fileOffsets[$this->lastFileName] = @ftell($fp);
}
return $ret;
}
/**
* Removes a file path from the list of resumable offsets
*
* @param $filename
*/
protected function removeFromOffsetsList($filename)
{
if (isset($this->fileOffsets[$filename]))
{
unset($this->fileOffsets[$filename]);
}
}
}
PK \Қf f - vendor/akeeba/engine/engine/Archiver/Base.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Base\Exceptions\WarningException;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\FileCloseAware;
use Akeeba\Engine\Util\FileSystem;
use Exception;
use RuntimeException;
/**
* Abstract parent class of all archiver engines
*/
abstract class Base
{
use FileCloseAware;
/** @var string The archive's comment. It's currently used ONLY in the ZIP file format */
protected $_comment;
/** @var Filesystem Filesystem utilities object */
protected $fsUtils = null;
/** @var resource JPA transformation source handle */
private $_xform_fp;
/** @var int The total size of the source JPA file */
private $totalSourceJPASize = 0;
/**
* Public constructor
*
* @codeCoverageIgnore
*
* @return void
*/
public function __construct()
{
$this->__bootstrap_code();
}
/**
* Wakeup (unserialization) function
*
* @codeCoverageIgnore
*
* @return void
*/
public function __wakeup()
{
$this->__bootstrap_code();
}
/**
* Adds a single file in the archive
*
* @param string $file The absolute path to the file to add
* @param string $removePath Path to remove from $file
* @param string $addPath Path to prepend to $file
*
* @return void
*
* @throws Exception
*/
public final function addFile($file, $removePath = '', $addPath = '')
{
$storedName = $this->addRemovePaths($file, $removePath, $addPath);
$this->addFileRenamed($file, $storedName);
}
/**
* Adds a list of files into the archive, removing $removePath from the
* file names and adding $addPath to them.
*
* @param array $fileList A simple string array of filepaths to include
* @param string $removePath Paths to remove from the filepaths
* @param string $addPath Paths to add in front of the filepaths
*
* @return void
*
* @throws Exception
*/
public final function addFileList(&$fileList, $removePath = '', $addPath = '')
{
if (!is_array($fileList))
{
Factory::getLog()->warning('addFileList called without a file list array');
return;
}
foreach ($fileList as $file)
{
$this->addFile($file, $removePath, $addPath);
}
}
/**
* Adds a file to the archive, with a name that's different from the source
* filename
*
* @param string $sourceFile Absolute path to the source file
* @param string $targetFile Relative filename to store in archive
*
* @return void
*
* @throws Exception
*/
public function addFileRenamed($sourceFile, $targetFile)
{
$mb_encoding = '8bit';
if (function_exists('mb_internal_encoding'))
{
$mb_encoding = mb_internal_encoding();
mb_internal_encoding('ISO-8859-1');
}
try
{
$this->_addFile(false, $sourceFile, $targetFile);
}
catch (WarningException $e)
{
Factory::getLog()->warning($e->getMessage());
}
finally
{
if (function_exists('mb_internal_encoding'))
{
mb_internal_encoding($mb_encoding);
}
}
}
/**
* Adds a file to the archive, given the stored name and its contents
*
* @param string $fileName The base file name
* @param string $addPath The relative path to prepend to file name
* @param string $virtualContent The contents of the file to be archived
*
* @return void
*/
public final function addFileVirtual($fileName, $addPath, &$virtualContent)
{
$storedName = $this->addRemovePaths($fileName, '', $addPath);
$mb_encoding = '8bit';
if (function_exists('mb_internal_encoding'))
{
$mb_encoding = mb_internal_encoding();
mb_internal_encoding('ISO-8859-1');
}
try
{
$this->_addFile(true, $virtualContent, $storedName);
}
catch (WarningException $e)
{
Factory::getLog()->warning($e->getMessage());
}
finally
{
if (function_exists('mb_internal_encoding'))
{
mb_internal_encoding($mb_encoding);
}
}
}
/**
* Adds a file to the archive, given the stored name and its contents
*
* @param string $fileName The base file name
* @param string $addPath The relative path to prepend to file name
* @param string $virtualContent The contents of the file to be archived
*
* @return void
*
* @deprecated 7.0.0
*/
public final function addVirtualFile($fileName, $addPath, &$virtualContent)
{
Factory::getLog()->debug('DEPRECATED: addVirtualFile() has been renamed to addFileVirtual().');
$this->addFileVirtual($fileName, $addPath, $virtualContent);
}
/**
* Makes whatever finalization is needed for the archive to be considered
* complete and useful (or, generally, clean up)
*
* @return void
*/
abstract public function finalize();
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
abstract public function getExtension();
/**
* Initialises the archiver class, creating the archive from an existent
* installer's JPA archive. MUST BE OVERRIDEN BY CHILDREN CLASSES.
*
* @param string $targetArchivePath Absolute path to the generated archive
* @param array $options A named key array of options (optional)
*
* @return void
*/
abstract public function initialize($targetArchivePath, $options = []);
/**
* Notifies the engine on the backup comment and converts it to plain text for
* inclusion in the archive file, if applicable.
*
* @param string $comment The archive's comment
*
* @return void
*/
public function setComment($comment)
{
// First, sanitize the comment in a text-only format
$comment = str_replace("\n", " ", $comment); // Replace newlines with spaces
$comment = str_replace(" ", "\n", $comment); // Replace HTML4 with single newlines
$comment = str_replace(" ", "\n", $comment); // Replace HTML4 with single newlines
$comment = str_replace(" ", "\n", $comment); // Replace HTML with single newlines
$comment = str_replace("", "\n\n", $comment); // Replace paragraph endings with double newlines
$comment = str_replace("", "*", $comment); // Replace bold with star notation
$comment = str_replace("", "*", $comment); // Replace bold with star notation
$comment = str_replace("", "_", $comment); // Replace italics with underline notation
$comment = str_replace("", "_", $comment); // Replace italics with underline notation
$this->_comment = strip_tags($comment, '');
}
/**
* Transforms a JPA archive (containing an installer) to the native archive format
* of the class. It actually extracts the source JPA in memory and instructs the
* class to include each extracted file.
*
* @codeCoverageIgnore
*
* @param integer $index The index in the source JPA archive's list currently in use
* @param integer $offset The source JPA archive's offset to use
*
* @return array|bool False if an error occurred, return array otherwise
*/
public function transformJPA($index, $offset)
{
$xform_source = null;
// Do we have to open the file?
if (!$this->_xform_fp)
{
// Get the source path
$registry = Factory::getConfiguration();
$embedded_installer = $registry->get('akeeba.advanced.embedded_installer');
// Fetch the name of the installer image
$installerDescriptors = Factory::getEngineParamsProvider()->getInstallerList();
$xform_source = Platform::getInstance()->get_installer_images_path() .
'/foobar.jpa'; // We need this as a "safe fallback"
// Try to find a sane default if we are not given a valid embedded installer
if (!array_key_exists($embedded_installer, $installerDescriptors))
{
// This shoud only be necessary if the post-installation script failed to execute.
if (strpos($embedded_installer, 'angie') === 0)
{
$embedded_installer = $this->fromAngieToBrs($embedded_installer);
}
// Implements a safe fallback to the generic restoration script included in all backup products.
if (!array_key_exists($embedded_installer, $installerDescriptors))
{
$embedded_installer = 'brs-generic';
}
// Even the default fallback does not exist! Pick ANY installer present, and hope it works.
if (!array_key_exists($embedded_installer, $installerDescriptors))
{
Factory::getLog()->warning('I cannot find the selected restoration script, or even the safe fallback. I am picking a random restoration script, and hope it works. This should NEVER, EVER happen! If you see this message, something has gone catastrophically wrong; try reinstalling the backup software.');
$allInstallers = array_keys($installerDescriptors);
foreach ($allInstallers as $anInstaller)
{
if ($anInstaller == 'none')
{
continue;
}
$embedded_installer = $anInstaller;
break;
}
}
$registry->set('akeeba.advanced.embedded_installer', $embedded_installer);
}
if (array_key_exists($embedded_installer, $installerDescriptors))
{
$packages = $installerDescriptors[$embedded_installer]['package'] ?? '';
$langPacks = $installerDescriptors[$embedded_installer]['language'] ?? '';
if (empty($packages))
{
// No installer package specified. Pretend we are done!
$retArray = [
"filename" => '', // File name extracted
"data" => '', // File data
"index" => 0, // How many source JPA files I have
"offset" => 0, // Offset in JPA file
"skip" => false, // Skip this?
"done" => true, // Are we done yet?
"filesize" => 0,
];
return $retArray;
}
$packages = explode(',', $packages);
$langPacks = explode(',', $langPacks);
$this->totalSourceJPASize = 0;
$pathPrefix = Platform::getInstance()->get_installer_images_path() . '/';
foreach ($packages as $package)
{
$filePath = $pathPrefix . $package;
$this->totalSourceJPASize += (int) @filesize($filePath);
}
foreach ($langPacks as $langPack)
{
$filePath = $pathPrefix . $langPack;
if (!is_file($filePath))
{
continue;
}
$packages[] = $langPack;
$this->totalSourceJPASize += (int) @filesize($filePath);
}
if (count($packages) < $index)
{
throw new RuntimeException(__CLASS__ . ":: Installer package index $index not found for embedded installer $embedded_installer");
}
$package = $packages[$index];
// A package is specified, use it!
$xform_source = $pathPrefix . $package;
}
// 2.3: Try to use sane default if the indicated installer doesn't exist
if (!is_null($xform_source) && !file_exists($xform_source) && (basename($xform_source) != 'brs.jpa'))
{
throw new RuntimeException(__CLASS__ . ":: Installer package $xform_source of embedded installer $embedded_installer not found. Please go to the configuration page, select an Embedded Installer, save the configuration and try backing up again.");
}
// Try opening the file
if (!is_null($xform_source) && file_exists($xform_source))
{
$this->_xform_fp = @fopen($xform_source, 'r');
if ($this->_xform_fp === false)
{
throw new RuntimeException(__CLASS__ . ":: Can't seed archive with installer package " . $xform_source);
}
}
else
{
throw new RuntimeException(__CLASS__ . ":: Installer package " . $xform_source . " does not exist!");
}
}
$headerDataLength = 0;
if (!$offset)
{
// First run detected!
Factory::getLog()->debug('Initializing with JPA package ' . $xform_source);
// Skip over the header and check no problem exists
$offset = $this->_xformReadHeader();
if ($offset === false)
{
throw new RuntimeException('JPA package file was not read');
}
$headerDataLength = $offset;
}
$ret = $this->_xformExtract($offset);
$ret['index'] = $index;
if (is_array($ret))
{
$ret['chunkProcessed'] = $headerDataLength + $ret['offset'] - $offset;
$offset = $ret['offset'];
if (!$ret['skip'] && !$ret['done'])
{
Factory::getLog()->debug(' Adding ' . $ret['filename'] . '; Next offset:' . $offset);
$this->addFileVirtual($ret['filename'], '', $ret['data']);
}
elseif ($ret['done'])
{
$registry = Factory::getConfiguration();
$embedded_installer = $registry->get('akeeba.advanced.embedded_installer');
$installerDescriptors = Factory::getEngineParamsProvider()->getInstallerList();
$packages = $installerDescriptors[$embedded_installer]['package'];
$packages = explode(',', $packages);
$pathPrefix = Platform::getInstance()->get_installer_images_path() . '/';
$langPacks = $installerDescriptors[$embedded_installer]['language'];
$langPacks = explode(',', $langPacks);
foreach ($langPacks as $langPack)
{
$filePath = $pathPrefix . $langPack;
if (!is_file($filePath))
{
continue;
}
$packages[] = $langPack;
}
Factory::getLog()->debug(' Done with package ' . $packages[$index]);
if (count($packages) > ($index + 1))
{
$ret['done'] = false;
$ret['index'] = $index + 1;
$ret['offset'] = 0;
$this->_xform_fp = null;
}
else
{
Factory::getLog()->debug(' Done with installer seeding.');
}
}
else
{
$reason = ' Skipping ' . $ret['filename'];
Factory::getLog()->debug($reason);
}
}
else
{
throw new RuntimeException('JPA extraction returned FALSE. The installer image is corrupt.');
}
if ($ret['done'])
{
// We are finished! Close the file
$this->conditionalFileClose($this->_xform_fp);
Factory::getLog()->debug('Initializing with JPA package has finished');
}
$ret['filesize'] = $this->totalSourceJPASize;
return $ret;
}
/**
* Common code which gets called on instance creation or wake-up (unserialization)
*
* @codeCoverageIgnore
*
* @return void
*/
protected function __bootstrap_code()
{
$this->fsUtils = Factory::getFilesystemTools();
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param boolean $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual
* is true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return boolean True on success, false otherwise. DEPRECATED: Use exceptions instead.
*
* @throws WarningException When there's a warning (the backup integrity is NOT compromised)
* @throws ErrorException When there's an error (the backup integrity is compromised – backup dead)
*/
abstract protected function _addFile($isVirtual, &$sourceNameOrData, $targetName);
/**
* This function indicates if the path $p_path is under the $p_dir tree. Or,
* said in an other way, if the file or sub-dir $p_path is inside the dir
* $p_dir.
* The function indicates also if the path is exactly the same as the dir.
* This function supports path with duplicated '/' like '//', but does not
* support '.' or '..' statements.
*
* Copied verbatim from pclZip library
*
* @codeCoverageIgnore
*
* @param string $p_dir Source tree
* @param string $p_path Check if this is part of $p_dir
*
* @return integer 0 if $p_path is not inside directory $p_dir,
* 1 if $p_path is inside directory $p_dir
* 2 if $p_path is exactly the same as $p_dir
*/
private function _PathInclusion($p_dir, $p_path)
{
$v_result = 1;
// ----- Explode dir and path by directory separator
$v_list_dir = explode("/", $p_dir);
$v_list_dir_size = count($v_list_dir);
$v_list_path = explode("/", $p_path);
$v_list_path_size = count($v_list_path);
// ----- Study directories paths
$i = 0;
$j = 0;
while (($i < $v_list_dir_size) && ($j < $v_list_path_size) && ($v_result))
{
// ----- Look for empty dir (path reduction)
if ($v_list_dir[$i] == '')
{
$i++;
continue;
}
if ($v_list_path[$j] == '')
{
$j++;
continue;
}
// ----- Compare the items
if (($v_list_dir[$i] != $v_list_path[$j]) && ($v_list_dir[$i] != '') && ($v_list_path[$j] != ''))
{
$v_result = 0;
}
// ----- Next items
$i++;
$j++;
}
// ----- Look if everything seems to be the same
if ($v_result)
{
// ----- Skip all the empty items
while (($j < $v_list_path_size) && ($v_list_path[$j] == ''))
{
$j++;
}
while (($i < $v_list_dir_size) && ($v_list_dir[$i] == ''))
{
$i++;
}
if (($i >= $v_list_dir_size) && ($j >= $v_list_path_size))
{
// ----- There are exactly the same
$v_result = 2;
}
else if ($i < $v_list_dir_size)
{
// ----- The path is shorter than the dir
$v_result = 0;
}
}
// ----- Return
return $v_result;
}
/**
* Extracts a file from the JPA archive and returns an in-memory array containing it
* and its file data. The data returned is an array, consisting of the following keys:
* "filename" => relative file path stored in the archive
* "data" => file data
* "offset" => next offset to use
* "skip" => if this is not a file, just skip it...
* "done" => No more files left in archive
*
* @codeCoverageIgnore
*
* @param integer $offset The absolute data offset from archive's header
*
* @return array|bool See description for more information
*/
private function &_xformExtract($offset)
{
$false = false; // Used to return false values in case an error occurs
// Generate a return array
$retArray = [
"filename" => '', // File name extracted
"data" => '', // File data
"offset" => 0, // Offset in ZIP file
"skip" => false, // Skip this?
"done" => false // Are we done yet?
];
// If we can't open the file, return an error condition
if ($this->_xform_fp === false)
{
return $false;
}
// Go to the offset specified
if (!fseek($this->_xform_fp, $offset) == 0)
{
return $false;
}
// Get and decode Entity Description Block
$signature = fread($this->_xform_fp, 3);
// Check signature
if ($signature == 'JPF')
{
// This a JPA Entity Block. Process the header.
// Read length of EDB and of the Entity Path Data
$length_array = unpack('vblocksize/vpathsize', fread($this->_xform_fp, 4));
// Read the path data
$file = fread($this->_xform_fp, $length_array['pathsize']);
// Read and parse the known data portion
$bin_data = fread($this->_xform_fp, 14);
$header_data = unpack('Ctype/Ccompression/Vcompsize/Vuncompsize/Vperms', $bin_data);
// Read any unknwon data
$restBytes = $length_array['blocksize'] - (21 + $length_array['pathsize']);
if ($restBytes > 0)
{
$junk = fread($this->_xform_fp, $restBytes);
}
$compressionType = $header_data['compression'];
// Populate the return array
$retArray['filename'] = $file;
$retArray['skip'] = ($header_data['compsize'] == 0); // Skip over directories
switch ($header_data['type'])
{
case 0:
// directory
break;
case 1:
// file
switch ($compressionType)
{
case 0: // No compression
if ($header_data['compsize'] > 0) // 0 byte files do not have data to be read
{
$retArray['data'] = fread($this->_xform_fp, $header_data['compsize']);
}
break;
case 1: // GZip compression
$zipData = fread($this->_xform_fp, $header_data['compsize']);
$retArray['data'] = gzinflate($zipData);
break;
case 2: // BZip2 compression
$zipData = fread($this->_xform_fp, $header_data['compsize']);
$retArray['data'] = bzdecompress($zipData);
break;
}
break;
}
}
else
{
// This is not a file header. This means we are done.
$retArray['done'] = true;
}
$retArray['offset'] = ftell($this->_xform_fp);
return $retArray;
}
/**
* Skips over the JPA header entry and returns the offset file data starts from
*
* @codeCoverageIgnore
*
* @return boolean|integer False on failure, offset otherwise
*/
private function _xformReadHeader()
{
// Fail for unreadable files
if ($this->_xform_fp === false)
{
return false;
}
// Go to the beggining of the file
rewind($this->_xform_fp);
// Read the signature
$sig = fread($this->_xform_fp, 3);
// Not a JPA Archive?
if ($sig != 'JPA')
{
return false;
}
// Read and parse header length
$header_length_array = unpack('v', fread($this->_xform_fp, 2));
$header_length = $header_length_array[1];
// Read and parse the known portion of header data (14 bytes)
$bin_data = fread($this->_xform_fp, 14);
$header_data = unpack('Cmajor/Cminor/Vcount/Vuncsize/Vcsize', $bin_data);
// Load any remaining header data (forward compatibility)
$rest_length = $header_length - 19;
if ($rest_length > 0)
{
$junk = fread($this->_xform_fp, $rest_length);
}
return ftell($this->_xform_fp);
}
/**
* Removes the $p_remove_dir from $p_filename, while prepending it with $p_add_dir.
* Largely based on code from the pclZip library.
*
* @param string $p_filename The absolute file name to treat
* @param string $p_remove_dir The path to remove
* @param string $p_add_dir The path to prefix the treated file name with
*
* @return string The treated file name
*/
private function addRemovePaths($p_filename, $p_remove_dir, $p_add_dir)
{
$p_filename = $this->fsUtils->TranslateWinPath($p_filename);
$p_remove_dir = ($p_remove_dir == '') ? '' :
$this->fsUtils->TranslateWinPath($p_remove_dir); //should fix corrupt backups, fix by nicholas
$v_stored_filename = $p_filename;
if (!($p_remove_dir == ""))
{
if (substr($p_remove_dir, -1) != '/')
{
$p_remove_dir .= "/";
}
if ((substr($p_filename, 0, 2) == "./") || (substr($p_remove_dir, 0, 2) == "./"))
{
if ((substr($p_filename, 0, 2) == "./") && (substr($p_remove_dir, 0, 2) != "./"))
{
$p_remove_dir = "./" . $p_remove_dir;
}
if ((substr($p_filename, 0, 2) != "./") && (substr($p_remove_dir, 0, 2) == "./"))
{
$p_remove_dir = substr($p_remove_dir, 2);
}
}
$v_compare = $this->_PathInclusion($p_remove_dir, $p_filename);
if ($v_compare > 0)
{
if ($v_compare == 2)
{
$v_stored_filename = "";
}
else
{
$v_stored_filename =
substr($p_filename, (function_exists('mb_strlen') ? mb_strlen($p_remove_dir, '8bit') :
strlen($p_remove_dir)));
}
}
}
else
{
$v_stored_filename = $p_filename;
}
if (!($p_add_dir == ""))
{
if (substr($p_add_dir, -1) == "/")
{
$v_stored_filename = $p_add_dir . $v_stored_filename;
}
else
{
$v_stored_filename = $p_add_dir . "/" . $v_stored_filename;
}
}
return $v_stored_filename;
}
/**
* Automatically convert the installer from ANGIE to BRS.
*
* In February 2025 the restoration script was renamed from ANGIE to BRS, and was rewritten with a new framework.
* The naming convention remains similar to the older ANGIE installer:
* * `angie` becomes `brs` and it's the Joomla-specific restoration script.
* * `angie-wordpress` becomes `brs-wordpress` and it's the WordPress-specific restoration script.
* * `angie-generic` becomes `brs-generic` and it's the generic / bespoke PHP application restoration script.
*
* This method converts the various ANGIE installer slugs into the corresponding BRS slugs.
*
* Since we (veyr briefly) had some other ANGIE installers (`angiesolo`, `angie-drupal`, `angie-prestashop`) we will
* catch these and convert them to the appropriate slug.
*
* @param string|null $embedded_installer
*
* @return string
*/
private function fromAngieToBrs(?string $embedded_installer): string
{
// Do not remove the ABSPATH check; it's used by the CLI script in ABWP instead of WPCLI.
if (defined('WPINC') || defined('ABSPATH'))
{
$defaultInstaller = 'brs-wordpress';
}
// Joomla-specific installer, if we are running under Joomla!.
elseif (defined('_JEXEC'))
{
$defaultInstaller = 'brs';
}
// Fallback to the generic installer
else
{
$defaultInstaller = 'brs-generic';
}
// When no installer is specified, fall back to the default.
if (empty($embedded_installer ?? ''))
{
return $defaultInstaller;
}
// Translate `angie` to `brs`.
$altInstaller = str_replace('angie', 'brs', $embedded_installer);
if (!in_array($altInstaller, ['brs', 'brs-generic', 'brs-wordpress']))
{
// Obsolete installers are converted to the generic case.
if (str_ends_with($altInstaller, 'drupal') || str_ends_with($altInstaller, 'prestashop'))
{
return 'brs-generic';
}
// Anything below here is either `angiesolo`, or some rubbish. Fall back to the default installer.
return $defaultInstaller;
}
return $altInstaller;
}
}
PK \% % 7 vendor/akeeba/engine/engine/Archiver/Directsftpcurl.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Transfer\SftpCurl;
use Exception;
use RuntimeException;
/**
* Direct Transfer Over SFTP archiver class
*
* Transfers the files to a remote SFTP server instead of putting them in
* an archive
*
*/
class Directsftpcurl extends Base
{
/** @var bool Could we connect to the server? */
public $connect_ok = false;
/** @var SftpCurl SFTP transport engine */
private $sftpTransfer = false;
/** @var string SFTP hostname */
private $host;
/** @var string SFTP port */
private $port;
/** @var string SFTP username */
private $user;
/** @var string SFTP password */
private $pass;
/** @var string Private key file */
private $privkey;
/** @var string Private key file */
private $pubkey;
/** @var string FTP initial directory */
private $initdir;
/**
* Initialises the archiver class, seeding the remote installation
* from an existent installer's JPA archive.
*
* @param string $targetArchivePath Absolute path to the generated archive (ignored in this class)
* @param array $options A named key array of options (optional)
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: new instance");
$registry = Factory::getConfiguration();
$this->host = $registry->get('engine.archiver.directsftpcurl.host', '');
$this->port = $registry->get('engine.archiver.directsftpcurl.port', '22');
$this->user = $registry->get('engine.archiver.directsftpcurl.user', '');
$this->pass = $registry->get('engine.archiver.directsftpcurl.pass', '');
$this->privkey = $registry->get('engine.archiver.directsftpcurl.privkey', '');
$this->pubkey = $registry->get('engine.archiver.directsftpcurl.pubkey', '');
$this->initdir = $registry->get('engine.archiver.directsftpcurl.initial_directory', '');
if (isset($options['host']))
{
$this->host = $options['host'];
}
if (isset($options['port']))
{
$this->port = $options['port'];
}
if (isset($options['user']))
{
$this->user = $options['user'];
}
if (isset($options['pass']))
{
$this->pass = $options['pass'];
}
if (isset($options['privkey']))
{
$this->privkey = $options['privkey'];
}
if (isset($options['pubkey']))
{
$this->pubkey = $options['pubkey'];
}
if (isset($options['initdir']))
{
$this->initdir = $options['initdir'];
}
// You can't fix stupid, but at least you get to shout at them
if (strtolower(substr($this->host, 0, 7)) == 'sftp://')
{
Factory::getLog()->warning('YOU ARE *** N O T *** SUPPOSED TO ENTER THE sftp:// PROTOCOL PREFIX IN THE FTP HOSTNAME FIELD OF THE DirectSFTP ARCHIVER ENGINE.');
Factory::getLog()->warning('I am trying to fix your bad configuration setting, but the backup might fail anyway. You MUST fix this in your configuration.');
$this->host = substr($this->host, 7);
}
$this->connect_ok = $this->connectSFTP();
Factory::getLog()->debug(__CLASS__ . " :: SFTP connection status: " . ($this->connect_ok ? 'success' : 'FAIL'));
}
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
public function getExtension()
{
return '';
}
public function finalize()
{
// Nothing to do
}
/**
* "Magic" function called just before serialization of the object. Disconnects
* from the FTP server and allows PHP to serialize like normal.
*
* @return array The variables to serialize
*/
public function _onSerialize()
{
// Explicitally unset the sftpTransfer class so the destructor magic method is called (and the connection is closed)
unset($this->sftpTransfer);
return array_keys(get_object_vars($this));
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param bool $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual is
* true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return boolean True on success, false otherwise
*/
protected function _addFile($isVirtual, &$sourceNameOrData, $targetName)
{
// Are we connected to a server?
if (!$this->sftpTransfer)
{
if (!$this->connectSFTP())
{
return false;
}
}
// See if it's a directory
$isDir = $isVirtual ? false : is_dir($sourceNameOrData);
if ($isDir)
{
// Just try to create the remote directory
return $this->makeDirectory($targetName);
}
else
{
// We have a file we need to upload
if ($isVirtual)
{
// Create a temporary file, upload, rename it
$tempFileName = Factory::getTempFiles()->createRegisterTempFile();
// Easy writing using file_put_contents
if (@file_put_contents($tempFileName, $sourceNameOrData) === false)
{
throw new RuntimeException('Could not store virtual file ' . $targetName . ' to ' . $tempFileName . ' using file_put_contents() before uploading.');
}
// Upload the temporary file under the final name
$res = $this->upload($tempFileName, $targetName);
// Remove the temporary file
Factory::getTempFiles()->unregisterAndDeleteTempFile($tempFileName, true);
return $res;
}
else
{
// Upload a file
return $this->upload($sourceNameOrData, $targetName);
}
}
}
/**
* Tries to connect to the remote SFTP server and change into the initial directory
*
* @return bool True is connection successful, false otherwise
*
* @throws Exception
*/
protected function connectSFTP()
{
Factory::getLog()->debug('Connecting to remote SFTP server');
$options = [
'host' => $this->host,
'port' => $this->port,
'username' => $this->user,
'password' => $this->pass,
'directory' => $this->initdir,
'privateKey' => $this->privkey,
'publicKey' => $this->pubkey,
];
$this->sftpTransfer = new SftpCurl($options);
return true;
}
/**
* Changes to the requested directory in the remote server. You give only the
* path relative to the initial directory and it does all the rest by itself,
* including doing nothing if the remote directory is the one we want. If the
* directory doesn't exist, it creates it.
*
* @param $dir string The (realtive) remote directory
*
* @return bool True if successful, false otherwise.
*/
protected function sftp_chdir($dir)
{
// Calculate "real" (absolute) SFTP path
$realdir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$realdir .= '/' . $dir;
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
if ($this->initdir == $realdir)
{
// Already there, do nothing
return true;
}
$result = $this->sftpTransfer->isDir($realdir);
if ($result === false)
{
// The directory doesn't exist, let's try to create it...
if (!$this->makeDirectory($dir))
{
return false;
}
}
return true;
}
protected function makeDirectory($dir)
{
$alldirs = explode('/', $dir);
$previousDir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$previousDir = substr($previousDir, 0, 1) == '/' ? $previousDir : '/' . $previousDir;
foreach ($alldirs as $curdir)
{
$check = $previousDir . '/' . $curdir;
if (!@$this->sftpTransfer->isDir($check))
{
if ($this->sftpTransfer->mkdir($check) === false)
{
throw new RuntimeException('Could not create directory ' . $check);
}
}
$previousDir = $check;
}
return true;
}
/**
* Uploads a file to the remote server
*
* @param $sourceName string The absolute path to the source local file
* @param $targetName string The relative path to the targer remote file
*
* @return bool True if successful
*/
protected function upload($sourceName, $targetName)
{
// Try to change into the remote directory, possibly creating it if it doesn't exist
$dir = dirname($targetName);
if (!$this->sftp_chdir($dir))
{
return false;
}
// Upload
$realdir = substr($this->initdir, -1) == '/' ? substr($this->initdir, 0, strlen($this->initdir) - 1) : $this->initdir;
$realdir .= '/' . $dir;
$realdir = substr($realdir, 0, 1) == '/' ? $realdir : '/' . $realdir;
$realname = $realdir . '/' . basename($targetName);
try
{
$this->sftpTransfer->upload($sourceName, $realname);
}
catch (RuntimeException $e)
{
Factory::getLog()->warning($e->getMessage());
return false;
}
return true;
}
}
PK \ 2 vendor/akeeba/engine/engine/Archiver/Zipnative.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use RuntimeException;
use ZipArchive;
/**
* Class Zipnative
*
* This file uses the ZipArchive class to create and add files to existing ZIP
* archives. For more information on the use of this class, please see:
* 1. http://devzone.zend.com/article/2105 (tutorial)
* 2. http://www.php.net/manual/en/class.ziparchive.php (reference)
*
* That said, the ZipArchive class is terribly inflexible when it comes down to
* features already implemented in Akeeba Engine's Zip such as archive
* splitting, chunked processing of very large files and processing of symlinks.
* We deem it only suitable for small sites, without large files, running on a
* decent hosting facility.
*/
class Zipnative extends Base
{
/** @var string The name of the file holding the ZIP's data, which becomes the final archive */
private $_dataFileName;
/** @var ZipArchive An instance of the PHP ZIPArchive class */
private $zip = null;
/** @var int Running sum of bytes added to the archive */
private $runningSum = 0;
/** @var int Permissions for the backup archive part files */
protected $permissions = null;
/**
* Class constructor - initializes internal operating parameters
*
* @throws RuntimeException
*/
public function __construct()
{
Factory::getLog()->debug(__CLASS__ . " :: New instance");
if (!class_exists('\ZipArchive'))
{
throw new RuntimeException('Your server does not support the ZipArchive extension. Please use a different Archiver Engine and retry backing up your site');
}
parent::__construct();
}
/**
* Common code which gets called on instance creation or wake-up (unserialization)
*
* @codeCoverageIgnore
*
* @return void
*/
public function __bootstrap_code()
{
parent::__bootstrap_code();
// So that the first run doesn't crash!
if (empty($this->_dataFileName))
{
return;
}
// Try to reopen the ZIP
$this->zip = new ZipArchive;
if (!file_exists($this->_dataFileName))
{
$res = $this->zip->open($this->_dataFileName, ZipArchive::CREATE | ZipArchive::OVERWRITE);
}
else
{
$res = $this->zip->open($this->_dataFileName);
}
if ($res !== true)
{
switch ($res)
{
case ZipArchive::ER_EXISTS:
throw new RuntimeException("The archive {$this->_dataFileName} already exists");
break;
case ZipArchive::ER_INCONS:
throw new RuntimeException("Inconsistent archive {$this->_dataFileName} detected");
break;
case ZipArchive::ER_INVAL:
throw new RuntimeException("Invalid archive {$this->_dataFileName} detected");
break;
case ZipArchive::ER_MEMORY:
throw new RuntimeException("Not enough memory to process archive {$this->_dataFileName}");
break;
case ZipArchive::ER_NOENT:
throw new RuntimeException("Unexpected ZipArchive::ER_NOENT error processing archive {$this->_dataFileName}");
break;
case ZipArchive::ER_NOZIP:
throw new RuntimeException("File {$this->_dataFileName} is not a ZIP archive!");
break;
case ZipArchive::ER_OPEN:
throw new RuntimeException("Could not open archive file {$this->_dataFileName} for writing");
break;
case ZipArchive::ER_READ:
throw new RuntimeException("Could not read from archive file {$this->_dataFileName}");
break;
case ZipArchive::ER_SEEK:
throw new RuntimeException("Could not seek into position while processing archive file {$this->_dataFileName}");
break;
}
}
}
/**
* Initialises the archiver class, creating the archive from an existent
* installer's JPA archive.
*
* @param string $targetArchivePath Absolute path to the generated archive
* @param array $options A named key array of options (optional). This is currently not supported
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: initialize - archive $targetArchivePath");
// Get names of temporary files
$this->_dataFileName = $targetArchivePath;
// Try to kill the archive if it exists
Factory::getLog()->debug(__CLASS__ . " :: Killing old archive");
$fp = fopen($this->_dataFileName, "w");
if (!($fp === false))
{
ftruncate($fp, 0);
$this->conditionalFileClose($fp);
}
else
{
@unlink($this->_dataFileName);
}
$this->runningSum = 0;
// Make sure we open the file
$this->__bootstrap_code();
}
/**
* In this engine, we have no finalization, really
*
* @return void
*/
public function finalize()
{
$this->zip->close();
@chmod($this->_dataFileName, $this->getPermissions());
}
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
public function getExtension()
{
return '.zip';
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param bool $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual is
* true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return bool True on success, false otherwise
*/
protected function _addFile($isVirtual, &$sourceNameOrData, $targetName)
{
if (!is_object($this->zip))
{
return false;
}
if (!$isVirtual)
{
Factory::getLog()->debug(__CLASS__ . " :: Adding $sourceNameOrData");
if (is_dir($sourceNameOrData))
{
$result = $this->zip->addEmptyDir($targetName);
}
else
{
$this->runningSum += filesize($sourceNameOrData);
$result = $this->zip->addFile($sourceNameOrData, $targetName);
}
}
else
{
Factory::getLog()->debug(' Virtual add:' . $targetName . ' (' . strlen($sourceNameOrData) . ')');
$this->runningSum += strlen($sourceNameOrData);
if (empty($sourceNameOrData))
{
$result = $this->zip->addEmptyDir($targetName);
}
else
{
$result = $this->zip->addFromString($targetName, $sourceNameOrData);
}
}
$this->zip->close();
$this->__bootstrap_code();
return true;
}
/**
* Return the requested permissions for the backup archive file.
*
* @return int
* @since 8.0.0
*/
protected function getPermissions(): int
{
if (!is_null($this->permissions))
{
return $this->permissions;
}
$configuration = Factory::getConfiguration();
$permissions = $configuration->get('engine.archiver.common.permissions', '0666') ?: '0666';
$this->permissions = octdec($permissions);
return $this->permissions;
}
}
PK \3pP P - vendor/akeeba/engine/engine/Archiver/jpa.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_JPA_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_JPA_DESCRIPTION"
},
"engine.archiver.common.dereference_symlinks": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DEREFERENCESYMLINKS_TITLE",
"description": "COM_AKEEBA_CONFIG_DEREFERENCESYMLINKS_DESCRIPTION"
},
"engine.archiver.common.part_size": {
"default": "0",
"type": "integer",
"min": "0",
"max": "2147483648",
"shortcuts": "0|131072|262144|524288|1048576|2097152|5242880|10485760|20971520|52428800|104857600|268435456|536870912|1073741824|1610612736|2097152000",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_PARTSIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_PARTSIZE_DESCRIPTION"
},
"engine.archiver.common.permissions": {
"default": "0666",
"type": "enum",
"enumkeys": "COM_AKEEBA_CONFIG_PERMISSIONS_0600|COM_AKEEBA_CONFIG_PERMISSIONS_0644|COM_AKEEBA_CONFIG_PERMISSIONS_0666",
"enumvalues": "0600|0644|0666",
"title": "COM_AKEEBA_CONFIG_PERMISSIONS_TITLE",
"description": "COM_AKEEBA_CONFIG_PERMISSIONS_DESCRIPTION"
},
"engine.archiver.common.chunk_size": {
"default": "1048576",
"type": "integer",
"min": "65536",
"max": "10485760",
"shortcuts": "65536|131072|262144|524288|1048576|2097152|5242880|10485760",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_CHUNKSIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_CHUNKSIZE_DESCRIPTION"
},
"engine.archiver.common.big_file_threshold": {
"default": "1048576",
"type": "integer",
"min": "65536",
"max": "10485760",
"shortcuts": "65536|131072|262144|524288|1048576|2097152|5242880|10485760",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_BIGFILETHRESHOLD_TITLE",
"description": "COM_AKEEBA_CONFIG_BIGFILETHRESHOLD_DESCRIPTION"
}
}PK \>fB B 4 vendor/akeeba/engine/engine/Archiver/directsftp.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTSFTP_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTSFTP_DESCRIPTION"
},
"engine.archiver.directsftp.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_HOST_DESCRIPTION"
},
"engine.archiver.directsftp.port": {
"default": "22",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_PORT_DESCRIPTION"
},
"engine.archiver.directsftp.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_USER_DESCRIPTION"
},
"engine.archiver.directsftp.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_PASSWORD_DESCRIPTION"
},
"engine.archiver.directsftp.privkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PRIVKEY_DESCRIPTION"
},
"engine.archiver.directsftp.pubkey": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_TITLE",
"description": "COM_AKEEBA_CONFIG_POSTPROCSFTP_PUBKEY_DESCRIPTION"
},
"engine.archiver.directsftp.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_INITDIR_DESCRIPTION"
},
"engine.archiver.directsftp.sftp_test": {
"default": "0",
"type": "button",
"hook": "directsftp_test_connection",
"title": "COM_AKEEBA_CONFIG_DIRECTSFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTSFTP_TEST_DESCRIPTION"
}
}PK \^ez z 7 vendor/akeeba/engine/engine/Archiver/directftpcurl.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTPCURL_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTPCURL_DESCRIPTION"
},
"engine.archiver.directftpcurl.host": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_HOST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_HOST_DESCRIPTION"
},
"engine.archiver.directftpcurl.port": {
"default": "21",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_PORT_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_PORT_DESCRIPTION"
},
"engine.archiver.directftpcurl.user": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_USER_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_USER_DESCRIPTION"
},
"engine.archiver.directftpcurl.pass": {
"default": "",
"type": "password",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSWORD_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSWORD_DESCRIPTION"
},
"engine.archiver.directftpcurl.initial_directory": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_INITDIR_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_INITDIR_DESCRIPTION"
},
"engine.archiver.directftpcurl.ftps": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_FTPS_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_FTPS_DESCRIPTION"
},
"engine.archiver.directftpcurl.passive_mode": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_PASSIVE_DESCRIPTION"
},
"engine.archiver.directftpcurl.passive_mode_workaround": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTPCURL_PASVWORKAROUND_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_ARCHIVER_DIRECTFTPCURL_PASVWORKAROUND_DESCRIPTION"
},
"engine.archiver.directftpcurl.ftp_test": {
"default": "0",
"type": "button",
"hook": "directftpcurl_test_connection",
"title": "COM_AKEEBA_CONFIG_DIRECTFTP_TEST_TITLE",
"description": "COM_AKEEBA_CONFIG_DIRECTFTP_TEST_DESCRIPTION"
}
}PK \RL L , vendor/akeeba/engine/engine/Archiver/Jpa.phpnu [ .
*/
namespace Akeeba\Engine\Archiver;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Factory;
use RuntimeException;
/**
* JPA creation class
*
* JPA Format 1.2 implemented, minus BZip2 compression support
*/
class Jpa extends BaseArchiver
{
/** @var string Standard Header signature */
private const ARCHIVE_SIGNATURE = "\x4A\x50\x41";
/** @var string Entity Block signature */
private const FILE_HEADER_SIGNATURE = "\x4A\x50\x46";
/** @var string Marks the split archive's extra header */
private const SPLIT_ARCHIVE_EXTRA_HEADER = "\x4A\x50\x01\x01";
/** @var string Marks the archive's 64-bit integer representations of file sizes (JPA v1.3) */
private const ARCHIVE_LONGLONG_SIZES_EXTRA_HEADER = "\x4A\x50\x01\x02";
/** @var integer How many files are contained in the archive */
private $totalFilesCount = 0;
/** @var integer The total size of files contained in the archive as they are stored */
private $totalCompressedSize = 0;
/** @var integer The total size of files contained in the archive when they are extracted to disk. */
private $totalUncompressedSize = 0;
/** @var int Current part file number */
private $currentPartNumber = 1;
/** @var int Total number of part files */
private $totalParts = 1;
/**
* Initialises the archiver class, creating the archive from an existent
* installer's JPA archive.
*
* @param string $targetArchivePath Absolute path to the generated archive
* @param array $options A named key array of options (optional)
*
* @return void
*/
public function initialize($targetArchivePath, $options = [])
{
Factory::getLog()->debug(__CLASS__ . " :: new instance - archive $targetArchivePath");
$this->_dataFileName = $targetArchivePath;
// Should we enable Split ZIP feature?
$this->enableSplitArchives();
// Should I use Symlink Target Storage?
$this->enableSymlinkTargetStorage();
// Try to kill the archive if it exists
$this->createNewBackupArchive();
// Write the initial instance of the archive header
$this->_writeArchiveHeader();
}
/**
* Updates the Standard Header with current information
*
* @return void
*/
public function finalize()
{
if (is_resource($this->fp))
{
$this->fclose($this->fp);
}
if (is_resource($this->cdfp))
{
$this->fclose($this->cdfp);
}
$this->_closeAllFiles();
// If Spanned JPA and there is no .jpa file, rename the last fragment to .jpa
if ($this->useSplitArchive)
{
$extension = substr($this->_dataFileName, -4);
if ($extension != '.jpa')
{
Factory::getLog()->debug('Renaming last JPA part to .JPA extension');
$newName = $this->dataFileNameWithoutExtension . '.jpa';
if (!@rename($this->_dataFileName, $newName))
{
throw new RuntimeException('Could not rename last JPA part to .JPA extension.');
}
$this->_dataFileName = $newName;
}
// Finally, point to the first part so that we can re-write the correct header information
if ($this->totalParts > 1)
{
$this->_dataFileName = $this->dataFileNameWithoutExtension . '.j01';
}
}
// Re-write the archive header
$this->_writeArchiveHeader();
}
/**
* Returns a string with the extension (including the dot) of the files produced
* by this class.
*
* @return string
*/
public function getExtension()
{
return '.jpa';
}
/**
* Outputs a Standard Header at the top of the file
*
* @return void
*/
protected function _writeArchiveHeader()
{
if (!is_null($this->fp))
{
$this->fclose($this->fp);
$this->fp = null;
}
$this->fp = $this->fopen($this->_dataFileName, 'c');
if ($this->fp === false)
{
throw new ErrorException('Could not open ' . $this->_dataFileName . ' for writing. Check permissions and open_basedir restrictions.');
}
// Calculate total header size
$headerSize = 19; // Standard Header
if ($this->useSplitArchive)
{
// Spanned JPA header
$headerSize += 8;
}
$is64Bit = $this->is64Bit();
if ($is64Bit)
{
// Version 1.3 long long sizes
$headerSize += 22;
}
// Write the archive header
$this->fwrite($this->fp, self::ARCHIVE_SIGNATURE); // ID string (JPA)
$this->fwrite($this->fp, pack('v', $headerSize)); // Header length; fixed to 19 bytes
$this->fwrite($this->fp, pack('C', _JPA_MAJOR)); // Major version
$this->fwrite($this->fp, pack('C', _JPA_MINOR)); // Minor version
$this->fwrite($this->fp, pack('V', $this->totalFilesCount)); // File count
$this->fwrite($this->fp, pack('V', $this->totalUncompressedSize)); // Size of files when extracted
$this->fwrite($this->fp, pack('V', $this->totalCompressedSize)); // Size of files when stored
// Do I need to add a split archive's header too?
if ($this->useSplitArchive)
{
$this->fwrite($this->fp, self::SPLIT_ARCHIVE_EXTRA_HEADER); // Signature
$this->fwrite($this->fp, pack('v', 4)); // Extra field length
$this->fwrite($this->fp, pack('v', $this->totalParts)); // Number of parts
}
if ($is64Bit)
{
// Version 1.3
$this->fwrite($this->fp, self::ARCHIVE_LONGLONG_SIZES_EXTRA_HEADER); // Signature
$this->fwrite($this->fp, pack('v', 18)); // Extra field length
$this->fwrite($this->fp, pack('P', $this->totalUncompressedSize)); // Size of files when extracted
$this->fwrite($this->fp, pack('P', $this->totalCompressedSize)); // Size of files when stored
}
$this->fclose($this->fp);
@chmod($this->_dataFileName, $this->getPermissions());
}
/**
* Extend the bootstrap code to add some define's used by the JPA format engine
*
* @codeCoverageIgnore
*
* @return void
*/
protected function __bootstrap_code()
{
if (!defined('_AKEEBA_COMPRESSION_THRESHOLD'))
{
$config = Factory::getConfiguration();
define("_AKEEBA_COMPRESSION_THRESHOLD", $config->get('engine.archiver.common.big_file_threshold')); // Don't compress files over this size
/**
* Akeeba Backup and JPA Format version change chart:
* Akeeba Backup 3.0: JPA Format 1.1
* Akeeba Backup 3.1: JPA Format 1.2 with file modification timestamp is used
* Akeeba Backup for Joomla 8.3/9.6, Solo/Akeeba Backup for WordPress 7.9: JPA Format 1.3
*/
define('_JPA_MAJOR', 1); // JPA Format major version number
if ($this->is64Bit())
{
define('_JPA_MINOR', 3); // JPA Format minor version number
}
else
{
define('_JPA_MINOR', 2); // JPA Format minor version number
}
}
parent::__bootstrap_code();
}
/**
* The most basic file transaction: add a single entry (file or directory) to
* the archive.
*
* @param bool $isVirtual If true, the next parameter contains file data instead of a file name
* @param string $sourceNameOrData Absolute file name to read data from or the file data itself is $isVirtual is
* true
* @param string $targetName The (relative) file name under which to store the file in the archive
*
* @return boolean True on success, false otherwise
*
* @since 1.2.1
*/
protected function _addFile($isVirtual, &$sourceNameOrData, $targetName)
{
// Get references to engine objects we're going to be using
$configuration = Factory::getConfiguration();
// Is this a virtual file?
$isVirtual = (bool) $isVirtual;
// Open data file for output
$this->openArchiveForOutput();
// Should I continue backing up a file from the previous step?
$continueProcessingFile = $configuration->get('volatile.engine.archiver.processingfile', false);
// Initialize with the default values. Why are *these* values default? If we are continuing file packing, by
// definition we have an uncompressed, non-virtual file. Hence the default values.
$isDir = false;
$isSymlink = false;
$compressionMethod = 0;
$zdata = null;
// If we are continuing file packing we have an uncompressed, non-virtual file.
$isVirtual = $continueProcessingFile ? false : $isVirtual;
$resume = $continueProcessingFile ? 0 : null;
if (!$continueProcessingFile)
{
// Log the file being added
$messageSource = $isVirtual ? '(virtual data)' : "(source: $sourceNameOrData)";
Factory::getLog()->debug("-- Adding $targetName to archive $messageSource");
// Write a file header
$this->writeFileHeader($sourceNameOrData, $targetName, $isVirtual, $isSymlink, $isDir, $compressionMethod, $zdata, $unc_len);
}
else
{
$sourceNameOrData = $configuration->get('volatile.engine.archiver.sourceNameOrData', '');
$unc_len = $configuration->get('volatile.engine.archiver.unc_len', 0);
$resume = $configuration->get('volatile.engine.archiver.resume', 0);
// Log the file we continue packing
Factory::getLog()->debug("-- Resuming adding file $sourceNameOrData to archive from position $resume (total size $unc_len)");
}
/* "File data" segment. */
if ($compressionMethod == 1)
{
// Compressed data. Put into the archive.
$this->putRawDataIntoArchive($zdata);
}
elseif ($isVirtual)
{
// Virtual data. Put into the archive.
$this->putRawDataIntoArchive($sourceNameOrData);
}
elseif ($isSymlink)
{
// Symlink. Just put the link target into the archive.
$this->fwrite($this->fp, @readlink($sourceNameOrData));
}
elseif ((!$isDir) && (!$isSymlink))
{
// Uncompressed file.
if ($this->putUncompressedFileIntoArchive($sourceNameOrData, $unc_len, $resume) === true)
{
// If it returns true we are doing a step break to resume packing in the next step. So we need to return
// true here to avoid running the final bit of code which uncaches the file resume data.
return true;
}
}
// Factory::getLog()->debug("DEBUG -- Added $targetName to archive");
// Uncache data
$configuration->set('volatile.engine.archiver.sourceNameOrData', null);
$configuration->set('volatile.engine.archiver.unc_len', null);
$configuration->set('volatile.engine.archiver.resume', null);
$configuration->set('volatile.engine.archiver.processingfile', false);
// ... and return TRUE = success
return true;
}
/**
* Write the file header to the backup archive.
*
* Only the first three parameters are input. All other are ignored for input and are overwritten.
*
* @param string $sourceNameOrData The path to the file being compressed, or the raw file data for virtual files
* @param string $targetName The target path to be stored inside the archive
* @param bool $isVirtual Is this a virtual file?
* @param bool $isSymlink Is this a symlink?
* @param bool $isDir Is this a directory?
* @param int $compressionMethod The compression method chosen for this file
* @param string $zdata If we have compression method other than 0 this holds the compressed data.
* We return that from this method to avoid having to compress the same data
* twice (once to write the compressed data length in the header and once to
* write the compressed data to the archive).
* @param int $unc_len The uncompressed size of the file / source data
*
* @return void
*/
protected function writeFileHeader(&$sourceNameOrData, &$targetName, &$isVirtual, &$isSymlink, &$isDir, &$compressionMethod, &$zdata, &$unc_len)
{
static $memLimit = null;
if (is_null($memLimit))
{
$memLimit = $this->getMemoryLimit();
}
$configuration = Factory::getConfiguration();
// Uncache data -- WHY DO THAT?!
/**
* $configuration->set('volatile.engine.archiver.sourceNameOrData', null);
* $configuration->set('volatile.engine.archiver.unc_len', null);
* $configuration->set('volatile.engine.archiver.resume', null);
* $configuration->set('volatile.engine.archiver.processingfile',false);
* /**/
// See if it's a directory
$isDir = $isVirtual ? false : is_dir($sourceNameOrData);
// See if it's a symlink (w/out dereference)
$isSymlink = false;
if ($this->storeSymlinkTarget && !$isVirtual)
{
$isSymlink = is_link($sourceNameOrData);
}
// Get real size before compression
[$fileSize, $fileModTime] =
$this->getFileSizeAndModificationTime($sourceNameOrData, $isVirtual, $isSymlink, $isDir);
// Decide if we will compress
$compressionMethod = $this->getCompressionMethod($fileSize, $memLimit, $isDir, $isSymlink);
$storedName = $targetName;
/* "Entity Description Block" segment. */
$unc_len = $fileSize; // File size
$storedName .= ($isDir) ? "/" : "";
/**
* !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
* !!!! WARNING!!! DO NOT MOVE THIS BLOCK OF CODE AFTER THE testIfFileExists OR getZData!!!! !!!!
* !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
*
* PHP 5.6.3 IS BROKEN. Possibly the same applies for all old versions of PHP. If you try to get the file
* permissions after reading its contents PHP segfaults.
*/
// Get file permissions
$perms = 0644;
if (!$isVirtual)
{
$perms = @fileperms($sourceNameOrData);
}
// Test for non-existing or unreadable files
$this->testIfFileExists($sourceNameOrData, $isVirtual, $isDir, $isSymlink);
// Default compressed (archived) length = uncompressed length – valid unless we can actually compress the data.
$c_len = $unc_len;
if ($compressionMethod == 1)
{
$this->getZData($sourceNameOrData, $isVirtual, $compressionMethod, $zdata, $unc_len, $c_len);
}
$this->totalCompressedSize += $c_len; // Update global data
$this->totalUncompressedSize += $fileSize; // Update global data
$this->totalFilesCount++;
// Calculate Entity Description Block length
$blockLength = 21 + akstrlen($storedName);
// If we need to store the file mod date
if ($fileModTime > 0)
{
$blockLength += 8;
}
$is64Bit = $this->is64Bit();
if ($is64Bit)
{
// We need to account for the Long Long File Sizes Extra Field in JPA v1.3
$blockLength += 20;
}
// Get file type
$fileType = 1;
if ($isSymlink)
{
$fileType = 2;
}
elseif ($isDir)
{
$fileType = 0;
}
// If it's a split JPA file, we've got to make sure that the header can fit in the part
if ($this->useSplitArchive)
{
// Compare to free part space
$free_space = $this->getPartFreeSize();
if ($free_space <= $blockLength)
{
// Not enough space on current part, create new part
$this->createAndOpenNewPart();
}
}
$this->fwrite($this->fp, self::FILE_HEADER_SIGNATURE); // Entity Description Block header
$this->fwrite($this->fp, pack('v', $blockLength)); // Entity Description Block header length
$this->fwrite($this->fp, pack('v', akstrlen($storedName))); // Length of entity path
$this->fwrite($this->fp, $storedName); // Entity path
$this->fwrite($this->fp, pack('C', $fileType)); // Entity type
$this->fwrite($this->fp, pack('C', $compressionMethod)); // Compression method
$this->fwrite($this->fp, pack('V', $c_len)); // Compressed size
$this->fwrite($this->fp, pack('V', $unc_len)); // Uncompressed size
$this->fwrite($this->fp, pack('V', $perms)); // Entity permissions
// Timestamp Extra Field, only for files
if ($fileModTime > 0)
{
$this->fwrite($this->fp, "\x00\x01"); // Extra Field Identifier
$this->fwrite($this->fp, pack('v', 8)); // Extra Field Length
$this->fwrite($this->fp, pack('V', $fileModTime)); // Timestamp
}
if ($is64Bit)
{
// The Long Long File Sizes Extra Field
$this->fwrite($this->fp, "\x00\x02"); // Extra Field Identifier
$this->fwrite($this->fp, pack('v', 20)); // Extra Field Length
$this->fwrite($this->fp, pack('P', $c_len)); // Compressed size
$this->fwrite($this->fp, pack('P', $unc_len)); // Uncompressed size
}
// Cache useful information about the file
if (!$isDir && !$isSymlink && !$isVirtual)
{
$configuration->set('volatile.engine.archiver.unc_len', $unc_len);
$configuration->set('volatile.engine.archiver.sourceNameOrData', $sourceNameOrData);
}
}
/**
* Creates a new part for the spanned archive
*
* @param bool $finalPart Is this the final archive part?
*
* @return bool True on success
*/
protected function createNewPartFile($finalPart = false)
{
// Close any open file pointers
if (!is_resource($this->fp))
{
$this->fclose($this->fp);
}
if (is_resource($this->cdfp))
{
$this->fclose($this->cdfp);
}
// Remove the just finished part from the list of resumable offsets
$this->removeFromOffsetsList($this->_dataFileName);
// Set the file pointers to null
$this->fp = null;
$this->cdfp = null;
// Push the previous part if we have to post-process it immediately
$configuration = Factory::getConfiguration();
if ($configuration->get('engine.postproc.common.after_part', 0))
{
// The first part needs its header overwritten during archive
// finalization. Skip it from immediate processing.
if ($this->currentPartNumber != 1)
{
$this->finishedPart[] = $this->_dataFileName;
}
}
$this->totalParts++;
$this->currentPartNumber = $this->totalParts;
if ($finalPart)
{
$this->_dataFileName = $this->dataFileNameWithoutExtension . '.jpa';
}
else
{
$this->_dataFileName = $this->dataFileNameWithoutExtension . '.j' . sprintf('%02d', $this->currentPartNumber);
}
Factory::getLog()->info('Creating new JPA part #' . $this->currentPartNumber . ', file ' . $this->_dataFileName);
$statistics = Factory::getStatistics();
$statistics->updateMultipart($this->totalParts);
// Try to remove any existing file
@clearstatcache($this->_dataFileName);
if (file_exists($this->_dataFileName))
{
@unlink($this->_dataFileName);
}
// Touch the new file
$result = @touch($this->_dataFileName);
chmod($this->_dataFileName, $this->getPermissions());
// Try to write 6 bytes to it
if ($result)
{
$result = @file_put_contents($this->_dataFileName, 'AKEEBA') == 6;
}
if ($result)
{
@clearstatcache($this->_dataFileName);
if (file_exists($this->_dataFileName))
{
@unlink($this->_dataFileName);
}
$result = @touch($this->_dataFileName);
@chmod($this->_dataFileName, $this->getPermissions());
}
return $result;
}
/**
* Is this a 64-bit version of PHP?
*
* @return bool
*
* @since 9.6.1
* @see https://www.php.net/manual/en/reserved.constants.php
*/
private function is64Bit(): bool
{
// 64-bit versions use 8 bytes for the Integer intrinsic type. We use >= for forward compatibility.
return PHP_INT_SIZE >= 8;
}
}
PK \Sʉ . vendor/akeeba/engine/engine/Archiver/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ * vendor/akeeba/engine/engine/Autoloader.phpnu [ .
*/
namespace Akeeba\Engine;
defined('AKEEBAENGINE') || die();
/**
* The main class autoloader for AkeebaEngine
*/
class Autoloader
{
/**
* An instance of this autoloader
*
* @var Autoloader
*/
public static $autoloader = null;
/**
* The path to the Akeeba Engine root directory
*
* @var string
*/
public static $enginePath = null;
/**
* The directories where Akeeba Engine platforms are stored
*
* @var array
*/
public static $platformDirs = null;
/**
* Public constructor. Registers the autoloader with PHP.
*/
public function __construct()
{
self::$enginePath = __DIR__;
spl_autoload_register([$this, 'autoload_akeeba_engine']);
}
/**
* Initialise this autoloader
*
* @return Autoloader
*/
public static function init()
{
if (self::$autoloader == null)
{
self::$autoloader = new self;
}
return self::$autoloader;
}
/**
* The actual autoloader
*
* @param string $className The name of the class to load
*
* @return void
*/
public function autoload_akeeba_engine($className)
{
// Trim the trailing backslash
$className = ltrim($className, '\\');
// Make sure the class has an Akeeba\Engine prefix
if (substr($className, 0, 13) != 'Akeeba\\Engine')
{
return;
}
// Remove the prefix and explode on backslashes
$className = substr($className, 14);
$class = explode('\\', $className);
// Do we have a list of platform directories?
if (is_null(self::$platformDirs) && class_exists('\\Akeeba\\Engine\\Platform', false))
{
self::$platformDirs = Platform::getPlatformDirectories();
if (!is_array(self::$platformDirs))
{
self::$platformDirs = [];
}
}
$rootPaths = [self::$enginePath];
if (is_array(self::$platformDirs))
{
$rootPaths = array_merge(
self::$platformDirs, [self::$enginePath]
);
}
foreach ($rootPaths as $rootPath)
{
// First try finding in structured directory format (preferred)
$path = $rootPath . '/' . implode('/', $class) . '.php';
if (@file_exists($path))
{
include_once $path;
}
// Then try the duplicate last name structured directory format (not recommended)
if (!class_exists($className, false))
{
reset($class);
$lastPart = end($class);
$path = $rootPath . '/' . implode('/', $class) . '/' . $lastPart . '.php';
if (@file_exists($path))
{
include_once $path;
}
}
}
}
}
// Register the Akeeba Engine autoloader
Autoloader::init();
PK \Bar r 3 vendor/akeeba/engine/engine/Util/FactoryStorage.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use InvalidArgumentException;
use RuntimeException;
/**
* Management class for temporary storage of the serialised engine state.
*/
class FactoryStorage
{
protected static $tempFileStoragePath;
/**
* Returns the fully qualified path to the storage file
*
* @param string $tag Backup tag
* @param string $extension File extension, default is php
*
* @return string
*/
public function get_storage_filename($tag = null, $extension = 'php')
{
if (is_null(self::$tempFileStoragePath))
{
$registry = Factory::getConfiguration();
self::$tempFileStoragePath = $registry->get('akeeba.basic.output_directory', '');
if (empty(self::$tempFileStoragePath))
{
throw new InvalidArgumentException('You have not set a backup output directory.');
}
self::$tempFileStoragePath = rtrim(self::$tempFileStoragePath, '/\\');
if (!is_writable(self::$tempFileStoragePath) || !is_readable(self::$tempFileStoragePath))
{
throw new InvalidArgumentException(sprintf('Backup output directory %s needs to be both readable and writeable to PHP for this backup software to function correctly.', self::$tempFileStoragePath));
}
}
$tag = empty($tag) ? '' : $tag;
$filename = sprintf("akstorage%s%s.%s", empty($tag) ? '' : '_', $tag, $extension);
return self::$tempFileStoragePath . DIRECTORY_SEPARATOR . $filename;
}
/**
* Resets the storage. This method removes all stored values.
*
* @param null $tag
*
* @return bool True on success
*/
public function reset($tag = null)
{
$filename = $this->get_storage_filename($tag);
if (!is_file($filename) && !is_link($filename))
{
$filename = $this->get_storage_filename($tag, 'dat');
}
if (!is_file($filename) && !is_link($filename))
{
return false;
}
return @unlink($this->get_storage_filename($tag));
}
/**
* Stores a value to the storage
*
* @param string $value Serialised value to store
* @param string|null $tag Backup tag
* @param string $extension File extension to use, default is php
*
* @return bool True on success
*/
public function set($value, $tag = null, $extension = 'php')
{
$storage_filename = $this->get_storage_filename($tag, $extension);
if (file_exists($storage_filename))
{
@unlink($storage_filename);
}
$isPHPFile = strtolower($extension) == 'php';
return @file_put_contents($storage_filename, $this->encode($value, $isPHPFile)) !== false;
}
/**
* Retrieves a value from storage
*
* @param string|null $tag Backup tag. Used to determine the session state (memory) file name.
*
* @return string|null
*/
public function &get($tag = null)
{
$ret = null;
$storage_filename = $this->get_storage_filename($tag);
$isPHPFile = true;
$data = @file_get_contents($storage_filename);
/**
* Some hosts, like WPEngine, do not allow us to use .php files for storing the factory state. In these case we
* fall back to using the far less secure .dat extension. This if-block caters for that case.
*/
if ($data === false)
{
$storage_filename = $this->get_storage_filename($tag, 'dat');
$isPHPFile = false;
$data = @file_get_contents($storage_filename);
}
if ($data === false)
{
return $ret;
}
try
{
$ret = $this->decode($data, $isPHPFile);
}
catch (RuntimeException $e)
{
$ret = null;
}
unset($data);
return $ret;
}
/**
* Encodes the (serialized) data in a format suitable for storing in a deliberately web-inaccessible PHP file.
*
* IMPORTANT: On some hosts we HAVE to fall back to a .dat file. This is nowhere near as secure. This is not a
* problem with Akeeba Backup but with the host, e.g. WPEngine. We WANT to do things securely but hosts' misguided
* attempts at "security" force us to have a very insecure fallback. Please do not report this as a security issue
* with us. report it to the host. We can't do something the host doesn't allow our code to do, obviously!
*
* @param string $data The data to encode
* @param bool $isPHPFile Is this file extension .php?
*
* @return string The encoded data
*/
public function encode(&$data, $isPHPFile = true)
{
$encodingMethod = $this->getEncodingMethod();
switch ($encodingMethod)
{
case 'base64':
$ret = base64_encode($data);
break;
case 'uuencode':
$ret = convert_uuencode($data);
break;
case 'plain':
default:
$ret = $data;
break;
}
if ($isPHPFile)
{
return '<' . '?' . 'php die(); ' . '>' . '?' . "\n" .
$encodingMethod . "\n" . $ret;
}
return $encodingMethod . "\n" . $ret;
}
/**
* Decodes the data read from the deliberately web-inaccessible PHP file.
*
* @param string $data The data read from the file
* @param bool $isPHPFile Does the memory file have a .php extension?
*
* @return false|string The decoded data. False if the decoding failed.
*/
public function decode(&$data, $isPHPFile = true)
{
// Parts: 0 = PHP die line; 1 = encoding mode; 2 = data
$parts = explode("\n", $data, 3);
$expectedPartsCount = $isPHPFile ? 3 : 2;
if (count($parts) != $expectedPartsCount)
{
throw new RuntimeException("Invalid backup temporary data (memory file)");
}
$encodingIndex = $isPHPFile ? 1 : 0;
$dataIndex = $isPHPFile ? 2 : 1;
switch ($parts[$encodingIndex])
{
case 'base64':
return base64_decode($parts[$dataIndex]);
break;
case 'uuencode':
return convert_uudecode($parts[$dataIndex]);
break;
case 'plain':
return $parts[$dataIndex];
break;
default:
throw new RuntimeException(sprintf('Unsupported encoding method “%s”', $parts[$encodingIndex]));
break;
}
}
/**
* Get the recommended method for encoding the temporary data
*
* @return string
*/
protected function getEncodingMethod()
{
// Preferred encoding: base sixty four, handled by PHP
if (function_exists('base64_encode') && function_exists('base64_decode'))
{
return 'base64';
}
// Fallback: UUencoding
if (function_exists('convert_uuencode') && function_exists('convert_uudecode'))
{
return 'uuencode';
}
// Final fallback (should NOT be necessary): plain text encoding
return 'plain';
}
}
PK \!vyC C 1 vendor/akeeba/engine/engine/Util/Transfer/Ftp.phpnu [ .
*/
namespace Akeeba\Engine\Util\Transfer;
defined('AKEEBAENGINE') || die();
use Exception;
use RuntimeException;
/**
* FTP transfer object, using PHP as the transport backend
*/
class Ftp implements TransferInterface, RemoteResourceInterface
{
/**
* FTP server's hostname or IP address
*
* @var string
*/
protected $host = 'localhost';
/**
* FTP server's port, default: 21
*
* @var integer
*/
protected $port = 21;
/**
* Username used to authenticate to the FTP server
*
* @var string
*/
protected $username = '';
/**
* Password used to authenticate to the FTP server
*
* @var string
*/
protected $password = '';
/**
* FTP initial directory
*
* @var string
*/
protected $directory = '/';
/**
* Should I use SSL to connect to the server (FTP over explicit SSL, a.k.a. FTPS)?
*
* @var boolean
*/
protected $ssl = false;
/**
* Should I use FTP passive mode?
*
* @var bool
*/
protected $passive = true;
/**
* Timeout for connecting to the FTP server, default: 10
*
* @var integer
*/
protected $timeout = 10;
/**
* The FTP connection handle
*
* @var resource|null
*/
private $connection = null;
/**
* Public constructor
*
* @param array $options Configuration options
*
* @return void
*
* @throws RuntimeException
*/
public function __construct(array $options)
{
if (isset($options['host']))
{
$this->host = $options['host'];
}
if (isset($options['port']))
{
$this->port = (int) $options['port'];
}
if (isset($options['username']))
{
$this->username = $options['username'];
}
if (isset($options['password']))
{
$this->password = $options['password'];
}
if (isset($options['directory']))
{
$this->directory = '/' . ltrim(trim($options['directory']), '/');
}
if (isset($options['ssl']))
{
$this->ssl = $options['ssl'];
}
if (isset($options['passive']))
{
$this->passive = $options['passive'];
}
if (isset($options['timeout']))
{
$this->timeout = max(1, (int) $options['timeout']);
}
$this->connect();
}
/**
* Is this transfer method blocked by a server firewall?
*
* @param array $params Any additional parameters you might need to pass
*
* @return boolean True if the firewall blocks connections to a known host
*/
public static function isFirewalled(array $params = [])
{
try
{
$connector = new static([
'host' => 'test.rebex.net',
'port' => 21,
'username' => 'demo',
'password' => 'password',
'directory' => '',
'ssl' => $params['ssl'] ?? false,
'passive' => true,
'timeout' => 5,
]);
$data = $connector->read('readme.txt');
if (empty($data))
{
return true;
}
}
catch (Exception $e)
{
return true;
}
return false;
}
/**
* Save all parameters on serialization except the connection resource
*
* @return array
*/
public function __sleep()
{
return ['host', 'port', 'username', 'password', 'directory', 'ssl', 'passive', 'timeout'];
}
/**
* Reconnect to the server on unserialize
*
* @return void
*/
public function __wakeup()
{
$this->connect();
}
/**
* Connect to the FTP server
*
* @throws RuntimeException
*/
public function connect()
{
// Try to connect to the server
if ($this->ssl)
{
if (function_exists('ftp_ssl_connect'))
{
$this->connection = @ftp_ssl_connect($this->host, $this->port);
}
else
{
$this->connection = false;
throw new RuntimeException('ftp_ssl_connect not available on this server', 500);
}
}
else
{
$this->connection = @ftp_connect($this->host, $this->port, $this->timeout);
}
if ($this->connection === false)
{
throw new RuntimeException(sprintf('Cannot connect to FTP server [host:port] = %s:%s', $this->host, $this->port), 500);
}
// Attempt to authenticate
if (!@ftp_login($this->connection, $this->username, $this->password))
{
@ftp_close($this->connection);
$this->connection = null;
throw new RuntimeException(sprintf('Cannot log in to FTP server [username:password] = %s:%s', $this->username, $this->password), 500);
}
// Attempt to change to the initial directory
$defaultDir = @ftp_pwd($this->connection) ?: '/';
$directories = [
$this->directory,
rtrim($this->directory, '/'),
trim($this->directory, '/'),
$defaultDir,
];
foreach ($directories as $dir)
{
$changedDir = @ftp_chdir($this->connection, $dir);
if ($changedDir)
{
$this->directory = $dir;
break;
}
}
if (!$changedDir)
{
@ftp_close($this->connection);
$this->connection = null;
throw new RuntimeException(sprintf('Cannot change to initial FTP directory "%s" – make sure the folder exists and that you have adequate permissions to it. Pro tip: the default directory of your FTP connection is reported to be %s', $this->directory, $defaultDir), 500);
}
// Apply the passive mode preference
@ftp_pasv($this->connection, $this->passive);
}
/**
* Public destructor, closes any open FTP connections
*/
public function __destruct()
{
if (!is_null($this->connection))
{
@ftp_close($this->connection);
}
}
/**
* Write the contents into the file
*
* @param string $fileName The full path to the file
* @param string $contents The contents to write to the file
*
* @return boolean True on success
*/
public function write($fileName, $contents)
{
// Make sure the buffer:// wrapper is loaded
class_exists('\\Akeeba\\Engine\\Util\\Buffer', true);
$handle = fopen('buffer://akeeba_engine_transfer_ftp', 'r+');
fwrite($handle, $contents);
rewind($handle);
$cwd = $this->cwd();
$remoteFilename = '/' . ltrim($fileName, '/');
$remotePath = dirname($remoteFilename);
$remoteName = basename($remoteFilename);
if (!$this->isDir($remotePath))
{
$this->mkdir($remotePath);
}
$changedDir = @ftp_chdir($this->connection, $remotePath);
$ret = $changedDir && @ftp_fput($this->connection, $remoteName, $handle, FTP_BINARY);
if ($changedDir)
{
@ftp_chdir($this->connection, $cwd);
}
fclose($handle);
return $ret;
}
/**
* Uploads a local file to the remote storage
*
* @param string $localFilename The full path to the local file
* @param string $remoteFilename The full path to the remote file
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function upload($localFilename, $remoteFilename, $useExceptions = true)
{
$handle = @fopen($localFilename, 'r');
if ($handle === false)
{
if ($useExceptions)
{
throw new RuntimeException("Unreadable local file $localFilename");
}
return false;
}
$cwd = $this->cwd();
$remoteFilename = '/' . ltrim($remoteFilename, '/');
$remotePath = dirname($remoteFilename);
$remoteName = basename($remoteFilename);
if (!$this->isDir($remotePath))
{
$this->mkdir($remotePath);
}
$changedDir = @ftp_chdir($this->connection, $remotePath);
$ret = $changedDir && @ftp_fput($this->connection, $remoteName, $handle, FTP_BINARY);
if ($changedDir)
{
@ftp_chdir($this->connection, $cwd);
}
@fclose($handle);
return $ret;
}
/**
* Read the contents of a remote file into a string
*
* @param string $fileName The full path to the remote file
*
* @return string The contents of the remote file
*/
public function read($fileName)
{
// Make sure the buffer:// wrapper is loaded
class_exists('\\Akeeba\\Engine\\Util\\Buffer', true);
$handle = fopen('buffer://akeeba_engine_transfer_ftp', 'r+');
$cwd = $this->cwd();
$remoteFilename = '/' . ltrim($fileName, '/');
$remotePath = dirname($remoteFilename);
$remoteName = basename($remoteFilename);
$changedDir = @ftp_chdir($this->connection, $remotePath);
$result = $changedDir && @ftp_fget($this->connection, $handle, $remoteName, FTP_BINARY);
if ($changedDir)
{
@ftp_chdir($this->connection, $cwd);
}
if ($result === false)
{
fclose($handle);
throw new RuntimeException("Can not download remote file $fileName");
}
rewind($handle);
$ret = '';
while (!feof($handle))
{
$ret .= fread($handle, 131072);
}
fclose($handle);
return $ret;
}
/**
* Download a remote file into a local file
*
* @param string $remoteFilename The remote file path to download from
* @param string $localFilename The local file path to download to
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function download($remoteFilename, $localFilename, $useExceptions = true)
{
$cwd = $this->cwd();
$remoteFilename = '/' . ltrim($remoteFilename, '/');
$remotePath = dirname($remoteFilename);
$remoteName = basename($remoteFilename);
$changedDir = @ftp_chdir($this->connection, $remotePath);
$ret = $changedDir && @ftp_get($this->connection, $localFilename, $remoteName, FTP_BINARY);
if ($changedDir)
{
@ftp_chdir($this->connection, $cwd);
}
if (!$ret && $useExceptions)
{
throw new RuntimeException("Cannot download remote file $remoteFilename through FTP.");
}
return $ret;
}
/**
* Delete a file (remove it from the disk)
*
* @param string $fileName The full path to the file
*
* @return boolean True on success
*/
public function delete($fileName)
{
$cwd = $this->cwd();
$remoteFilename = '/' . ltrim($fileName, '/');
$remotePath = dirname($remoteFilename);
$remoteName = basename($remoteFilename);
if (!$this->isDir($remotePath))
{
$this->mkdir($remotePath);
}
$changedDir = @ftp_chdir($this->connection, $remotePath);
$ret = $changedDir && @ftp_delete($this->connection, $remoteName);;
if ($changedDir)
{
ftp_chdir($this->connection, $cwd);
}
return $ret;
}
/**
* Create a copy of the file. Actually, we have to read it in memory and upload it again.
*
* @param string $from The full path of the file to copy from
* @param string $to The full path of the file that will hold the copy
*
* @return boolean True on success
*/
public function copy($from, $to)
{
// Make sure the buffer:// wrapper is loaded
class_exists('\\Akeeba\\Engine\\Util\\Buffer', true);
$handle = fopen('buffer://akeeba_engine_transfer_ftp', 'r+');
$cwd = $this->cwd();
$remoteFilename = '/' . ltrim($from, '/');
$remotePath = dirname($remoteFilename);
$remoteName = basename($remoteFilename);
$changedDir = @ftp_chdir($this->connection, $remotePath);
$ret = $changedDir && @ftp_fget($this->connection, $handle, $remoteName, FTP_BINARY);
if ($ret !== false)
{
rewind($handle);
$remoteFilename = '/' . ltrim($to, '/');
$remotePath = dirname($remoteFilename);
$remoteName = basename($remoteFilename);
if (!$this->isDir($remotePath))
{
$this->mkdir($remotePath);
}
$changedDir = @ftp_chdir($this->connection, $remotePath);
$ret = $changedDir && @ftp_fput($this->connection, $remoteName, $handle, FTP_BINARY);
}
if ($changedDir)
{
@ftp_chdir($this->connection, $cwd);
}
fclose($handle);
return $ret;
}
/**
* Move or rename a file
*
* @param string $from The full path of the file to move
* @param string $to The full path of the target file
*
* @return boolean True on success
*/
public function move($from, $to)
{
return @ftp_rename($this->connection, $from, $to);
}
/**
* Change the permissions of a file
*
* @param string $fileName The full path of the file whose permissions will change
* @param integer $permissions The new permissions, e.g. 0644 (remember the leading zero in octal numbers!)
*
* @return boolean True on success
*/
public function chmod($fileName, $permissions)
{
if (@ftp_chmod($this->connection, $permissions, $fileName) !== false)
{
return true;
}
$permissionsOctal = decoct((int) $permissions);
if (@ftp_site($this->connection, "CHMOD $permissionsOctal $fileName") !== false)
{
return true;
}
return false;
}
/**
* Create a directory if it doesn't exist. The operation is implicitly recursive, i.e. it will create all
* intermediate directories if they do not already exist.
*
* @param string $dirName The full path of the directory to create
* @param integer $permissions The permissions of the created directory
*
* @return boolean True on success
*/
public function mkdir($dirName, $permissions = 0755)
{
$targetDir = rtrim($dirName, '/');
$directories = explode('/', $targetDir);
$remoteDir = '';
foreach ($directories as $dir)
{
if (!$dir)
{
continue;
}
$remoteDir .= '/' . $dir;
// Continue if the folder already exists. Otherwise I'll get a an error even if everything is fine
if ($this->isDir($remoteDir))
{
continue;
}
$ret = @ftp_mkdir($this->connection, $remoteDir);
if ($ret === false)
{
return $ret;
}
}
$this->chmod($dirName, $permissions);
return true;
}
/**
* Checks if the given directory exists
*
* @param string $path The full path of the remote directory to check
*
* @return boolean True if the directory exists
*/
public function isDir($path)
{
$cur_dir = ftp_pwd($this->connection);
if (@ftp_chdir($this->connection, $path))
{
// If it is a directory, then change the directory back to the original directory
ftp_chdir($this->connection, $cur_dir);
return true;
}
else
{
return false;
}
}
/**
* Get the current working directory
*
* @return string
*/
public function cwd()
{
return ftp_pwd($this->connection);
}
/**
* Returns the absolute remote path from a path relative to the initial directory configured when creating the
* transfer object.
*
* @param string $fileName The relative path of a file or directory
*
* @return string The absolute path for use by the transfer object
*/
public function getPath($fileName)
{
$fileName = str_replace('\\', '/', $fileName);
if (strpos($fileName, $this->directory) === 0)
{
return $fileName;
}
$fileName = trim($fileName, '/');
$fileName = rtrim($this->directory, '/') . '/' . $fileName;
return $fileName;
}
/**
* Lists the subdirectories inside an FTP directory
*
* @param null|string $dir The directory to scan. Skip to use the current directory.
*
* @return array|bool A list of folders, or false if we could not get a listing
*
* @throws RuntimeException When the server is incompatible with our FTP folder scanner
*/
public function listFolders($dir = null)
{
if (!@ftp_chdir($this->connection, $dir))
{
throw new RuntimeException(sprintf('Cannot change to FTP directory "%s" – make sure the folder exists and that you have adequate permissions to it', $dir), 500);
}
$list = @ftp_rawlist($this->connection, '.');
if ($list === false)
{
throw new RuntimeException("Sorry, your FTP server doesn't support our FTP directory browser.");
}
$folders = [];
foreach ($list as $v)
{
$vInfo = preg_split("/[\s]+/", $v, 9);
if ($vInfo[0] !== "total")
{
$perms = $vInfo[0];
if (substr($perms, 0, 1) == 'd')
{
$folders[] = $vInfo[8];
}
}
}
asort($folders);
return $folders;
}
/**
* Return a string with the appropriate stream wrapper protocol for $path. You can use the result with all PHP
* functions / classes which accept file paths such as DirectoryIterator, file_get_contents, file_put_contents,
* fopen etc.
*
* @param string $path
*
* @return string
*/
public function getWrapperStringFor($path)
{
$usernameEncoded = urlencode($this->username);
$passwordEncoded = urlencode($this->password);
$hostname = $this->host . ($this->port ? ":{$this->port}" : '');
$protocol = $this->ssl ? "ftps" : "ftp";
return "{$protocol}://{$usernameEncoded}:{$passwordEncoded}@{$hostname}{$path}";
}
/**
* Return the raw server listing for the requested folder.
*
* @param string $folder The path name to list
*
* @return string
*/
public function getRawList($folder)
{
return ftp_rawlist($this->connection, $folder);
}
}
PK \r7i i E vendor/akeeba/engine/engine/Util/Transfer/RemoteResourceInterface.phpnu [ .
*/
namespace Akeeba\Engine\Util\Transfer;
defined('AKEEBAENGINE') || die();
/**
* An interface for Transfer adapters which support remote resources, allowing us to efficient read from / write to
* remote locations as if they were local files.
*/
interface RemoteResourceInterface
{
/**
* Return a string with the appropriate stream wrapper protocol for $path. You can use the result with all PHP
* functions / classes which accept file paths such as DirectoryIterator, file_get_contents, file_put_contents,
* fopen etc.
*
* @param string $path
*
* @return string
*/
public function getWrapperStringFor($path);
/**
* Return the raw server listing for the requested folder.
*
* @param string $folder The path name to list
*
* @return string
*/
public function getRawList($folder);
}
PK \erN N 5 vendor/akeeba/engine/engine/Util/Transfer/FtpCurl.phpnu [ .
*/
namespace Akeeba\Engine\Util\Transfer;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\ProxyAware;
use RuntimeException;
/**
* FTP transfer object, using cURL as the transport backend
*/
class FtpCurl extends Ftp implements TransferInterface
{
use ProxyAware;
/**
* Timeout for transferring data to the FTP server, default: 10 minutes
*
* @var integer
*/
protected $timeout = 600;
/**
* Should I ignore the IP returned by the server during Passive mode transfers?
*
* @var bool
*
* @see http://www.elitehosts.com/blog/php-ftp-passive-ftp-server-behind-nat-nightmare/
*/
private $skipPassiveIP = true;
/**
* Should we enable verbose output to STDOUT? Useful for debugging.
*
* @var bool
*/
private $verbose = false;
/**
* Public constructor
*
* @param array $options Configuration options
*
* @throws RuntimeException
*/
public function __construct(array $options)
{
parent::__construct($options);
if (isset($options['passive_fix']))
{
$this->skipPassiveIP = $options['passive_fix'] ? true : false;
}
if (isset($options['verbose']))
{
$this->verbose = $options['verbose'] ? true : false;
}
}
/**
* Save all parameters on serialization except the connection resource
*
* @return array
*/
public function __sleep()
{
return [
'host',
'port',
'username',
'password',
'directory',
'ssl',
'passive',
'timeout',
'skipPassiveIP',
'verbose',
];
}
/**
* Test the connection to the FTP server and whether the initial directory is correct. This is done by attempting to
* list the contents of the initial directory. The listing is not parsed (we don't really care!) and we do NOT check
* if we can upload files to that remote folder.
*
* @throws RuntimeException
*/
public function connect()
{
$ch = $this->getCurlHandle($this->directory . '/');
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_NOBODY, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
throw new RuntimeException("cURL Error $errNo connecting to remote FTP server: $error", 500);
}
}
/**
* Write the contents into the file
*
* @param string $fileName The full path to the file
* @param string $contents The contents to write to the file
*
* @return boolean True on success
*/
public function write($fileName, $contents)
{
// Make sure the buffer:// wrapper is loaded
class_exists('\\Akeeba\\Engine\\Util\\Buffer', true);
$handle = fopen('buffer://akeeba_engine_transfer_ftp_curl', 'r+');
fwrite($handle, $contents);
// Note: don't manually close the file pointer, it's closed automatically by uploadFromHandle
try
{
$this->uploadFromHandle($fileName, $handle);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Uploads a local file to the remote storage
*
* @param string $localFilename The full path to the local file
* @param string $remoteFilename The full path to the remote file
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function upload($localFilename, $remoteFilename, $useExceptions = true)
{
$fp = @fopen($localFilename, 'r');
if ($fp === false)
{
throw new RuntimeException("Unreadable local file $localFilename");
}
// Note: don't manually close the file pointer, it's closed automatically by uploadFromHandle
try
{
$this->uploadFromHandle($remoteFilename, $fp);
}
catch (RuntimeException $e)
{
if ($useExceptions)
{
throw $e;
}
return false;
}
return true;
}
/**
* Read the contents of a remote file into a string
*
* @param string $fileName The full path to the remote file
*
* @return string The contents of the remote file
*/
public function read($fileName)
{
try
{
return $this->downloadToString($fileName);
}
catch (RuntimeException $e)
{
throw new RuntimeException("Can not download remote file $fileName", 500, $e);
}
}
/**
* Download a remote file into a local file
*
* @param string $remoteFilename The remote file path to download from
* @param string $localFilename The local file path to download to
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function download($remoteFilename, $localFilename, $useExceptions = true)
{
$fp = @fopen($localFilename, 'w');
if ($fp === false)
{
if ($useExceptions)
{
throw new RuntimeException(sprintf('Download from FTP failed. Can not open local file %s for writing.', $localFilename));
}
return false;
}
// Note: don't manually close the file pointer, it's closed automatically by downloadToHandle
try
{
$this->downloadToHandle($remoteFilename, $fp);
}
catch (RuntimeException $e)
{
if ($useExceptions)
{
throw $e;
}
return false;
}
return true;
}
/**
* Delete a file (remove it from the disk)
*
* @param string $fileName The full path to the file
*
* @return boolean True on success
*/
public function delete($fileName)
{
$commands = [
'DELE ' . $this->getPath($fileName),
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Create a copy of the file. Actually, we have to read it in memory and upload it again.
*
* @param string $from The full path of the file to copy from
* @param string $to The full path of the file that will hold the copy
*
* @return boolean True on success
*/
public function copy($from, $to)
{
// Make sure the buffer:// wrapper is loaded
class_exists('\\Akeeba\\Engine\\Util\\Buffer', true);
$handle = fopen('buffer://akeeba_engine_transfer_ftp', 'r+');
try
{
$this->downloadToHandle($from, $handle, false);
$this->uploadFromHandle($to, $handle);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Move or rename a file
*
* @param string $from The full path of the file to move
* @param string $to The full path of the target file
*
* @return boolean True on success
*/
public function move($from, $to)
{
$from = $this->getPath($from);
$to = $this->getPath($to);
$commands = [
'RNFR /' . $from,
'RNTO /' . $to,
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Change the permissions of a file
*
* @param string $fileName The full path of the file whose permissions will change
* @param integer $permissions The new permissions, e.g. 0644 (remember the leading zero in octal numbers!)
*
* @return boolean True on success
*/
public function chmod($fileName, $permissions)
{
// Make sure permissions are in an octal string representation
if (!is_string($permissions))
{
$permissions = decoct($permissions);
}
$commands = [
'SITE CHMOD ' . $permissions . ' /' . $this->getPath($fileName),
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Create a directory if it doesn't exist. The operation is implicitly recursive, i.e. it will create all
* intermediate directories if they do not already exist.
*
* @param string $dirName The full path of the directory to create
* @param integer $permissions The permissions of the created directory
*
* @return boolean True on success
*/
public function mkdir($dirName, $permissions = 0755)
{
$targetDir = rtrim($dirName, '/');
$directories = explode('/', $targetDir);
$remoteDir = '';
foreach ($directories as $dir)
{
if (!$dir)
{
continue;
}
$remoteDir .= '/' . $dir;
// Continue if the folder already exists. Otherwise I'll get a an error even if everything is fine
if ($this->isDir($remoteDir))
{
continue;
}
$commands = [
'MKD ' . $remoteDir,
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
}
$this->chmod($dirName, $permissions);
return true;
}
/**
* Checks if the given directory exists
*
* @param string $path The full path of the remote directory to check
*
* @return boolean True if the directory exists
*/
public function isDir($path)
{
$ch = $this->getCurlHandle($path . '/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_exec($ch);
$errNo = curl_errno($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
return false;
}
return true;
}
/**
* Get the current working directory. NOT IMPLEMENTED.
*
* @return string
*/
public function cwd()
{
$commands = [
'PWD',
];
try
{
$result = $this->executeServerCommands($commands, '');
}
catch (RuntimeException $e)
{
return '/';
}
return $result;
}
/**
* Lists the subdirectories inside an FTP directory
*
* @param null|string $dir The directory to scan. Skip to use the current directory.
*
* @return array|bool A list of folders, or false if we could not get a listing
*
* @throws RuntimeException When the server is incompatible with our FTP folder scanner
*/
public function listFolders($dir = null)
{
if (empty($dir))
{
$dir = $this->directory;
}
$dir = rtrim($dir, '/');
$ch = $this->getCurlHandle($dir . '/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$list = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
throw new RuntimeException(sprintf("cURL Error $errNo ($error) while listing contents of directory \"%s\" – make sure the folder exists and that you have adequate permissions to it", $dir), 500);
}
if (empty($list))
{
throw new RuntimeException("Sorry, your FTP server doesn't support our FTP directory browser.");
}
$folders = [];
// Convert the directory listing into an array of lines without *NIX/Windows/Mac line ending characters
$list = explode("\n", $list);
$list = array_map('rtrim', $list);
foreach ($list as $v)
{
$vInfo = preg_split("/[\s]+/", $v, 9);
if ($vInfo[0] !== "total")
{
$perms = $vInfo[0];
if (substr($perms, 0, 1) == 'd')
{
$folders[] = $vInfo[8];
}
}
}
asort($folders);
return $folders;
}
/**
* Is the verbose debug option set?
*
* @return boolean
*/
public function isVerbose()
{
return $this->verbose;
}
/**
* Set the verbose debug option
*
* @param boolean $verbose
*
* @return void
*/
public function setVerbose($verbose)
{
$this->verbose = $verbose;
}
/**
* Returns the absolute remote path from a path relative to the initial directory configured when creating the
* transfer object.
*
* @param string $fileName The relative path of a file or directory
*
* @return string The absolute path for use by the transfer object
*/
public function getPath($fileName)
{
$fileName = ltrim(str_replace('\\', '/', $fileName), '/');
$isInitialDirectory = $fileName === $this->directory;
$startsWithInitialDirectory = (strpos($fileName, rtrim($this->directory, '/') . '/') === 0)
|| (strpos($fileName, trim($this->directory, '/') . '/') === 0);
// Relative file? Add the initial directory
if (!$isInitialDirectory && !$startsWithInitialDirectory)
{
$fileName = '/' . trim($this->directory, '/') .
(empty($fileName) ? '' : '/') . $fileName;
}
return '/' . ltrim($fileName, '/');
}
/**
* Returns a cURL resource handler for the remote FTP server
*
* @param string $remoteFile Optional. The remote file / folder on the FTP server you'll be manipulating with cURL.
*
* @return resource
*/
protected function getCurlHandle($remoteFile = '')
{
/**
* Get the FTP URI
*
* VERY IMPORTANT! WE NEED THE DOUBLE SLASH AFTER THE HOST NAME since we are giving an absolute path.
* @see https://technicalsanctuary.wordpress.com/2012/11/01/curl-curl-9-server-denied-you-to-change-to-the-given-directory/
*/
$ftpUri = 'ftp://' . $this->host . '//';
$isInitialDirectory = $remoteFile === $this->directory;
$startsWithInitialDirectory = (strpos($remoteFile, rtrim($this->directory, '/') . '/') === 0)
|| (strpos($remoteFile, trim($this->directory, '/') . '/') === 0);
// Relative file? Add the initial directory
if (!$isInitialDirectory && !$startsWithInitialDirectory)
{
$ftpUri .= '/' . trim($this->directory, '/');
}
if (!empty($remoteFile) && substr($ftpUri, -2) !== '//')
{
$ftpUri .= '/';
}
// Add a remote file if necessary. The filename must be URL encoded since we're creating a URI.
if (!empty($remoteFile))
{
$suffix = '';
if (substr($remoteFile, -7, 6) == ';type=')
{
$suffix = substr($remoteFile, -7);
$remoteFile = substr($remoteFile, 0, -7);
}
$dirname = dirname($remoteFile);
// Windows messing up dirname('/'). KILL ME.
if ($dirname == '\\')
{
$dirname = '';
}
$dirname = trim($dirname, '/');
$basename = basename($remoteFile);
if ((substr($remoteFile, -1) == '/') && !empty($basename))
{
$suffix = '/' . $suffix;
}
$ftpUri .= '/' . $dirname . (empty($dirname) ? '' : '/') . urlencode($basename) . $suffix;
}
// Colons in usernames must be URL escaped
$username = str_replace(':', '%3A', $this->username);
$ch = curl_init();
$this->applyProxySettingsToCurl($ch);
curl_setopt($ch, CURLOPT_URL, $ftpUri);
curl_setopt($ch, CURLOPT_USERPWD, $username . ":" . $this->password);
curl_setopt($ch, CURLOPT_PORT, $this->port);
curl_setopt($ch, CURLOPT_TIMEOUT, $this->timeout);
// Should I enable Implict SSL?
if ($this->ssl)
{
curl_setopt($ch, CURLOPT_FTP_SSL, CURLFTPSSL_ALL);
curl_setopt($ch, CURLOPT_FTPSSLAUTH, CURLFTPAUTH_DEFAULT);
// Most FTPS servers use self-signed certificates. That's the only way to connect to them :(
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
}
// Should I ignore the server-supplied passive mode IP address?
if ($this->passive && $this->skipPassiveIP)
{
curl_setopt($ch, CURLOPT_FTP_SKIP_PASV_IP, 1);
}
// Should I enable active mode?
if (!$this->passive)
{
/**
* cURL always uses passive mode for FTP transfers. Setting the CURLOPT_FTPPORT flag enables the FTP PORT
* command which makes the connection active. Setting it to '-' lets the library use your system's default
* IP address.
*
* @see https://curl.haxx.se/libcurl/c/CURLOPT_FTPPORT.html
*/
curl_setopt($ch, CURLOPT_FTPPORT, '-');
}
// Should I enable verbose output? Useful for debugging.
if ($this->verbose)
{
curl_setopt($ch, CURLOPT_VERBOSE, 1);
}
// Automatically create missing directories
curl_setopt($ch, CURLOPT_FTP_CREATE_MISSING_DIRS, 1);
return $ch;
}
/**
* Uploads a file using file contents provided through a file handle
*
* @param string $remoteFilename Remote file to write contents to
* @param resource $fp File or stream handler of the source data to upload
*
* @return void
*
* @throws RuntimeException
*/
protected function uploadFromHandle($remoteFilename, $fp)
{
// We need the file size. We can do that by getting the file position at EOF
fseek($fp, 0, SEEK_END);
$filesize = ftell($fp);
rewind($fp);
/**
* The ;type=i suffix forces Binary file transfer mode
*
* @see https://curl.haxx.se/mail/archive-2008-05/0089.html
*/
$ch = $this->getCurlHandle($remoteFilename . ';type=i');
curl_setopt($ch, CURLOPT_UPLOAD, 1);
curl_setopt($ch, CURLOPT_INFILE, $fp);
curl_setopt($ch, CURLOPT_INFILESIZE, $filesize);
curl_exec($ch);
$error_no = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
fclose($fp);
if ($error_no)
{
throw new RuntimeException($error, $error_no);
}
}
/**
* Downloads a remote file to the provided file handle
*
* @param string $remoteFilename Filename on the remote server
* @param resource $fp File handle where the downloaded content will be written to
* @param bool $close Optional. Should I close the file handle when I'm done? (Default: true)
*
* @return void
*
* @throws RuntimeException
*/
protected function downloadToHandle($remoteFilename, $fp, $close = true)
{
/**
* The ;type=i suffix forces Binary file transfer mode
*
* @see https://curl.haxx.se/mail/archive-2008-05/0089.html
*/
$ch = $this->getCurlHandle($remoteFilename . ';type=i');
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_exec($ch);
$error_no = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($close)
{
fclose($fp);
}
if ($error_no)
{
throw new RuntimeException($error, $error_no);
}
}
/**
* Downloads a remote file and returns it as a string
*
* @param string $remoteFilename Filename on the remote server
*
* @return string
*
* @throws RuntimeException
*/
protected function downloadToString($remoteFilename)
{
/**
* The ;type=i suffix forces Binary file transfer mode
*
* @see https://curl.haxx.se/mail/archive-2008-05/0089.html
*/
$ch = $this->getCurlHandle($remoteFilename . ';type=i');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
$ret = curl_exec($ch);
$error_no = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($error_no)
{
throw new RuntimeException($error, $error_no);
}
return $ret;
}
/**
* Executes arbitrary FTP commands
*
* @param string[] $commands An array with the FTP commands to be executed
* @param string|null $remoteFile The remote file / folder to use in the cURL URI when executing the commands
*
* @return string The output of the executed commands
*
*/
protected function executeServerCommands(array $commands, ?string $remoteFile = null): string
{
$remoteFile = $remoteFile ?? ($this->directory . '/');
$ch = $this->getCurlHandle($remoteFile);
curl_setopt($ch, CURLOPT_QUOTE, $commands);
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_NOBODY, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$listing = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
throw new RuntimeException($error, $errNo);
}
return $listing;
}
}
PK \1: : 2 vendor/akeeba/engine/engine/Util/Transfer/Sftp.phpnu [ .
*/
namespace Akeeba\Engine\Util\Transfer;
defined('AKEEBAENGINE') || die();
use DirectoryIterator;
use Exception;
use RuntimeException;
/**
* SFTP transfer object
*/
class Sftp implements TransferInterface, RemoteResourceInterface
{
/**
* SFTP server's hostname or IP address
*
* @var string
*/
private $host = 'localhost';
/**
* SFTP server's port, default: 21
*
* @var integer
*/
private $port = 22;
/**
* Username used to authenticate to the SFTP server
*
* @var string
*/
private $username = '';
/**
* Password used to authenticate to the SFTP server
*
* @var string
*/
private $password = '';
/**
* SFTP initial directory
*
* @var string
*/
private $directory = '/';
/**
* The absolute filesystem path to a private key file used for authentication instead of a password.
*
* @var string
*/
private $privateKey = '';
/**
* The absolute filesystem path to a public key file used for authentication instead of a password.
*
* @var string
*/
private $publicKey = '';
/**
* The SSH2 connection handle
*
* @var resource|null
*/
private $connection = null;
/**
* The SFTP connection handle
*
* @var resource|null
*/
private $sftpHandle = null;
/**
* Public constructor
*
* @param array $options Configuration options for the filesystem abstraction object
*
* @return Sftp
*
* @throws RuntimeException
*/
public function __construct(array $options)
{
if (isset($options['host']))
{
$this->host = $options['host'];
}
if (isset($options['port']))
{
$this->port = (int) $options['port'];
}
if (isset($options['username']))
{
$this->username = $options['username'];
}
if (isset($options['password']))
{
$this->password = $options['password'];
}
if (isset($options['directory']))
{
$this->directory = '/' . ltrim(trim($options['directory']), '/');
}
if (isset($options['privateKey']))
{
$this->privateKey = $options['privateKey'];
}
if (isset($options['publicKey']))
{
$this->publicKey = $options['publicKey'];
}
$this->connect();
}
/**
* Is this transfer method blocked by a server firewall?
*
* @param array $params Any additional parameters you might need to pass
*
* @return boolean True if the firewall blocks connections to a known host
*/
public static function isFirewalled(array $params = [])
{
try
{
$connector = new static([
'host' => 'test.rebex.net',
'port' => 22,
'username' => 'demo',
'password' => 'password',
'directory' => '',
]);
$data = $connector->read('readme.txt');
if (empty($data))
{
return true;
}
}
catch (Exception $e)
{
return true;
}
return false;
}
/**
* Save all parameters on serialization except the connection resource
*
* @return array
*/
public function __sleep()
{
return ['host', 'port', 'username', 'password', 'directory', 'privateKey', 'publicKey'];
}
/**
* Reconnect to the server on unserialize
*
* @return void
*/
public function __wakeup()
{
$this->connect();
}
public function __destruct()
{
if (is_resource($this->connection))
{
@ssh2_exec($this->connection, 'exit;');
$this->connection = null;
$this->sftpHandle = null;
}
}
/**
* Connect to the FTP server
*
* @throws RuntimeException
*/
public function connect()
{
// Try to connect to the SSH server
if (!function_exists('ssh2_connect'))
{
throw new RuntimeException('Your web server does not have the SSH2 PHP module, therefore can not connect to SFTP servers.', 500);
}
$this->connection = ssh2_connect($this->host, $this->port);
if ($this->connection === false)
{
$this->connection = null;
throw new RuntimeException(sprintf('Cannot connect to SFTP server [host:port] = %s:%s', $this->host, $this->port), 500);
}
// Attempt to authenticate
if (!empty($this->publicKey) && !empty($this->privateKey))
{
if (!@ssh2_auth_pubkey_file($this->connection, $this->username, $this->publicKey, $this->privateKey, $this->password))
{
$this->connection = null;
throw new RuntimeException(sprintf('Cannot log in to SFTP server using key files [username:private_key_file:public_key_file:password] = %s:%s:%s:%s', $this->username, $this->privateKey, $this->publicKey, $this->password), 500);
}
}
else
{
if (!@ssh2_auth_password($this->connection, $this->username, $this->password))
{
$this->connection = null;
throw new RuntimeException(sprintf('Cannot log in to SFTP server [username:password] = %s:%s', $this->username, $this->password), 500);
}
}
// Get an SFTP handle
$this->sftpHandle = ssh2_sftp($this->connection);
if ($this->sftpHandle === false)
{
throw new RuntimeException('Cannot start an SFTP session with the server', 500);
}
}
/**
* Write the contents into the file
*
* @param string $fileName The full path to the file
* @param string $contents The contents to write to the file
*
* @return boolean True on success
*/
public function write($fileName, $contents)
{
$fp = @fopen("ssh2.sftp://{$this->sftpHandle}/$fileName", 'w');
if ($fp === false)
{
return false;
}
$ret = @fwrite($fp, $contents);
@fclose($fp);
return $ret;
}
/**
* Uploads a local file to the remote storage
*
* @param string $localFilename The full path to the local file
* @param string $remoteFilename The full path to the remote file
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function upload($localFilename, $remoteFilename, $useExceptions = true)
{
$fp = @fopen("ssh2.sftp://{$this->sftpHandle}/$remoteFilename", 'w');
if ($fp === false)
{
if ($useExceptions)
{
throw new RuntimeException("Could not open remote SFTP file $remoteFilename for writing");
}
return false;
}
$localFp = @fopen($localFilename, 'r');
if ($localFp === false)
{
fclose($fp);
if ($useExceptions)
{
throw new RuntimeException("Could not open local file $localFilename for reading");
}
return false;
}
while (!feof($localFp))
{
$data = fread($localFp, 131072);
$ret = @fwrite($fp, $data);
if ($ret < strlen($data))
{
fclose($fp);
fclose($localFp);
if ($useExceptions)
{
throw new RuntimeException("An error occurred while copying file $localFilename to $remoteFilename");
}
return false;
}
}
@fclose($fp);
@fclose($localFp);
return true;
}
/**
* Read the contents of a remote file into a string
*
* @param string $fileName The full path to the remote file
*
* @return string The contents of the remote file
*/
public function read($fileName)
{
$fp = @fopen("ssh2.sftp://{$this->sftpHandle}/$fileName", 'r');
if ($fp === false)
{
throw new RuntimeException("Can not download remote file $fileName");
}
$ret = '';
while (!feof($fp))
{
$ret .= fread($fp, 131072);
}
@fclose($fp);
return $ret;
}
/**
* Download a remote file into a local file
*
* @param string $remoteFilename The remote file path to download from
* @param string $localFilename The local file path to download to
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function download($remoteFilename, $localFilename, $useExceptions = true)
{
$fp = @fopen("ssh2.sftp://{$this->sftpHandle}/$remoteFilename", 'r');
if ($fp === false)
{
if ($useExceptions)
{
throw new RuntimeException("Could not open remote SFTP file $remoteFilename for reading");
}
return false;
}
$localFp = @fopen($localFilename, 'w');
if ($localFp === false)
{
fclose($fp);
if ($useExceptions)
{
throw new RuntimeException("Could not open local file $localFilename for writing");
}
return false;
}
while (!feof($fp))
{
$chunk = fread($fp, 131072);
if ($chunk === false)
{
fclose($fp);
fclose($localFp);
if ($useExceptions)
{
throw new RuntimeException("An error occurred while copying file $remoteFilename to $localFilename");
}
return false;
}
fwrite($localFp, $chunk);
}
@fclose($fp);
@fclose($localFp);
return true;
}
/**
* Delete a file (remove it from the disk)
*
* @param string $fileName The full path to the file
*
* @return boolean True on success
*/
public function delete($fileName)
{
try
{
$ret = @ssh2_sftp_unlink($this->sftpHandle, $fileName);
}
catch (Exception $e)
{
$ret = false;
}
return $ret;
}
/**
* Create a copy of the file. Actually, we have to read it in memory and upload it again.
*
* @param string $from The full path of the file to copy from
* @param string $to The full path of the file that will hold the copy
*
* @return boolean True on success
*/
public function copy($from, $to)
{
$contents = @file_get_contents($from);
return $this->write($to, $contents);
}
/**
* Move or rename a file. Actually, we have to read it, upload it again and then delete the original.
*
* @param string $from The full path of the file to move
* @param string $to The full path of the target file
*
* @return boolean True on success
*/
public function move($from, $to)
{
$ret = $this->copy($from, $to);
if ($ret)
{
$ret = $this->delete($from);
}
return $ret;
}
/**
* Change the permissions of a file
*
* @param string $fileName The full path of the file whose permissions will change
* @param integer $permissions The new permissions, e.g. 0644 (remember the leading zero in octal numbers!)
*
* @return boolean True on success
*/
public function chmod($fileName, $permissions)
{
// Prefer the SFTP way, if available
if (function_exists('ssh2_sftp_chmod'))
{
return @ssh2_sftp_chmod($this->sftpHandle, $fileName, $permissions);
}
// Otherwise fall back to the (likely to fail) raw command mode
else
{
$cmd = 'chmod ' . decoct($permissions) . ' ' . escapeshellarg($fileName);
return @ssh2_exec($this->connection, $cmd);
}
}
/**
* Create a directory if it doesn't exist. The operation is implicitly recursive, i.e. it will create all
* intermediate directories if they do not already exist.
*
* @param string $dirName The full path of the directory to create
* @param integer $permissions The permissions of the created directory
*
* @return boolean True on success
*/
public function mkdir($dirName, $permissions = 0755)
{
$targetDir = rtrim($dirName, '/');
$ret = @ssh2_sftp_mkdir($this->sftpHandle, $targetDir, $permissions, true);
return $ret;
}
/**
* Checks if the given directory exists
*
* @param string $path The full path of the remote directory to check
*
* @return boolean True if the directory exists
*/
public function isDir($path)
{
return @ssh2_sftp_stat($this->sftpHandle, $path);
}
/**
* Get the current working directory
*
* @return string
*/
public function cwd()
{
return ssh2_sftp_realpath($this->sftpHandle, ".");
}
/**
* Returns the absolute remote path from a path relative to the initial directory configured when creating the
* transfer object.
*
* @param string $fileName The relative path of a file or directory
*
* @return string The absolute path for use by the transfer object
*/
public function getPath($fileName)
{
$fileName = str_replace('\\', '/', $fileName);
$fileName = rtrim($this->directory, '/') . '/' . $fileName;
return $fileName;
}
/**
* Lists the subdirectories inside an SFTP directory
*
* @param null|string $dir The directory to scan. Skip to use the current directory.
*
* @return array|bool A list of folders, or false if we could not get a listing
*
* @throws RuntimeException When the server is incompatible with our SFTP folder scanner
*/
public function listFolders($dir = null)
{
if (empty($dir))
{
$dir = $this->directory;
}
// Get a raw directory listing (hoping it's a UNIX server!)
$list = [];
$dir = ltrim($dir, '/');
try
{
$di = new DirectoryIterator("ssh2.sftp://" . $this->sftpHandle . "/$dir");
}
catch (Exception $e)
{
throw new RuntimeException(sprintf('Cannot change to SFTP directory "%s" – make sure the folder exists and that you have adequate permissions to it', $dir), 500);
}
if (!$di->valid())
{
throw new RuntimeException(sprintf('Cannot change to SFTP directory "%s" – make sure the folder exists and that you have adequate permissions to it', $dir), 500);
}
/** @var DirectoryIterator $entry */
foreach ($di as $entry)
{
if ($entry->isDot())
{
continue;
}
if (!$entry->isDir())
{
continue;
}
$list[] = $entry->getFilename();
}
unset($di);
if (!empty($list))
{
asort($list);
}
return $list;
}
/**
* Return a string with the appropriate stream wrapper protocol for $path. You can use the result with all PHP
* functions / classes which accept file paths such as DirectoryIterator, file_get_contents, file_put_contents,
* fopen etc.
*
* @param string $path
*
* @return string
*/
public function getWrapperStringFor($path)
{
return "ssh2.sftp://{$this->sftpHandle}{$path}";
}
/**
* Return the raw server listing for the requested folder.
*
* @param string $folder The path name to list
*
* @return string
*/
public function getRawList($folder)
{
// First try the command for Linxu servers
$res = $this->ssh2cmd('ls -l ' . escapeshellarg($folder));
// If an error occurred let's try the command for Windows servers
if (empty($res))
{
$res = $this->ssh2cmd('CMD /C ' . escapeshellarg($folder));
}
return $res;
}
private function ssh2cmd($command)
{
$stream = ssh2_exec($this->connection, $command);
stream_set_blocking($stream, true);
$res = @stream_get_contents($stream);
@fclose($stream);
return $res;
}
}
PK \ e)O )O 6 vendor/akeeba/engine/engine/Util/Transfer/SftpCurl.phpnu [ .
*/
namespace Akeeba\Engine\Util\Transfer;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\ProxyAware;
use RuntimeException;
/**
* SFTP transfer object, using cURL as the transport backend
*/
class SftpCurl extends Sftp implements TransferInterface
{
use ProxyAware;
/**
* SFTP server's hostname or IP address
*
* @var string
*/
private $host = 'localhost';
/**
* SFTP server's port, default: 21
*
* @var integer
*/
private $port = 22;
/**
* Username used to authenticate to the SFTP server
*
* @var string
*/
private $username = '';
/**
* Password used to authenticate to the SFTP server
*
* @var string
*/
private $password = '';
/**
* SFTP initial directory
*
* @var string
*/
private $directory = '/';
/**
* The absolute filesystem path to a private key file used for authentication instead of a password.
*
* @var string
*/
private $privateKey = '';
/**
* The absolute filesystem path to a public key file used for authentication instead of a password.
*
* @var string
*/
private $publicKey = '';
/**
* Timeout for connecting to the SFTP server, default: 10 minutes
*
* @var integer
*/
private $timeout = 600;
/**
* Should we enable verbose output to STDOUT? Useful for debugging.
*
* @var bool
*/
private $verbose = false;
/**
* Should I enabled the passive IP workaround for cURL?
*
* @var bool
*/
private $skipPassiveIP = false;
/**
* Public constructor
*
* @param array $options Configuration options
*
* @return self
*
* @throws RuntimeException
*/
public function __construct(array $options)
{
if (isset($options['host']))
{
$this->host = $options['host'];
}
if (isset($options['port']))
{
$this->port = (int) $options['port'];
}
if (isset($options['username']))
{
$this->username = $options['username'];
}
if (isset($options['password']))
{
$this->password = $options['password'];
}
if (isset($options['directory']))
{
$this->directory = '/' . ltrim(trim($options['directory']), '/');
}
if (isset($options['privateKey']))
{
$this->privateKey = $options['privateKey'];
}
if (isset($options['publicKey']))
{
$this->publicKey = $options['publicKey'];
}
if (isset($options['timeout']))
{
$this->timeout = max(1, (int) $options['timeout']);
}
if (isset($options['passive_fix']))
{
$this->skipPassiveIP = $options['passive_fix'] ? true : false;
}
if (isset($options['verbose']))
{
$this->verbose = $options['verbose'] ? true : false;
}
}
/**
* Save all parameters on serialization except the connection resource
*
* @return array
*/
public function __sleep()
{
return [
'host',
'port',
'username',
'password',
'directory',
'privateKey',
'publicKey',
'timeout',
'skipPassiveIP',
'verbose',
];
}
/**
* Test the connection to the SFTP server and whether the initial directory is correct. This is done by attempting to
* list the contents of the initial directory. The listing is not parsed (we don't really care!) and we do NOT check
* if we can upload files to that remote folder.
*
* @throws RuntimeException
*/
public function connect()
{
$ch = $this->getCurlHandle($this->directory . '/');
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_NOBODY, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$listing = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
throw new RuntimeException("cURL Error $errNo connecting to remote SFTP server: $error", 500);
}
}
/**
* Write the contents into the file
*
* @param string $fileName The full path to the file
* @param string $contents The contents to write to the file
*
* @return boolean True on success
*/
public function write($fileName, $contents)
{
// Make sure the buffer:// wrapper is loaded
class_exists('\\Akeeba\\Engine\\Util\\Buffer', true);
$handle = fopen('buffer://akeeba_engine_transfer_ftp_curl', 'r+');
fwrite($handle, $contents);
// Note: don't manually close the file pointer, it's closed automatically by uploadFromHandle
try
{
$this->uploadFromHandle($fileName, $handle);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Uploads a local file to the remote storage
*
* @param string $localFilename The full path to the local file
* @param string $remoteFilename The full path to the remote file
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function upload($localFilename, $remoteFilename, $useExceptions = true)
{
$fp = @fopen($localFilename, 'r');
if ($fp === false)
{
throw new RuntimeException("Unreadable local file $localFilename");
}
// Note: don't manually close the file pointer, it's closed automatically by uploadFromHandle
try
{
$this->uploadFromHandle($remoteFilename, $fp);
}
catch (RuntimeException $e)
{
if ($useExceptions)
{
throw $e;
}
return false;
}
return true;
}
/**
* Read the contents of a remote file into a string
*
* @param string $fileName The full path to the remote file
*
* @return string The contents of the remote file
*/
public function read($fileName)
{
try
{
return $this->downloadToString($fileName);
}
catch (RuntimeException $e)
{
throw new RuntimeException("Can not download remote file $fileName", 500, $e);
}
}
/**
* Download a remote file into a local file
*
* @param string $remoteFilename The remote file path to download from
* @param string $localFilename The local file path to download to
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function download($remoteFilename, $localFilename, $useExceptions = true)
{
$fp = @fopen($localFilename, 'w');
if ($fp === false)
{
if ($useExceptions)
{
throw new RuntimeException(sprintf('Download from FTP failed. Can not open local file %s for writing.', $localFilename));
}
return false;
}
// Note: don't manually close the file pointer, it's closed automatically by downloadToHandle
try
{
$this->downloadToHandle($remoteFilename, $fp);
}
catch (RuntimeException $e)
{
if ($useExceptions)
{
throw $e;
}
return false;
}
return true;
}
/**
* Delete a file (remove it from the disk)
*
* @param string $fileName The full path to the file
*
* @return boolean True on success
*/
public function delete($fileName)
{
$commands = [
'rm ' . $this->getPath($fileName),
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Create a copy of the file. Actually, we have to read it in memory and upload it again.
*
* @param string $from The full path of the file to copy from
* @param string $to The full path of the file that will hold the copy
*
* @return boolean True on success
*/
public function copy($from, $to)
{
// Make sure the buffer:// wrapper is loaded
class_exists('\\Akeeba\\Engine\\Util\\Buffer', true);
$handle = fopen('buffer://akeeba_engine_transfer_ftp', 'r+');
try
{
$this->downloadToHandle($from, $handle, false);
$this->uploadFromHandle($to, $handle);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Move or rename a file
*
* @param string $from The full path of the file to move
* @param string $to The full path of the target file
*
* @return boolean True on success
*/
public function move($from, $to)
{
$from = $this->getPath($from);
$to = $this->getPath($to);
$commands = [
'rename ' . $from . ' ' . $to,
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Change the permissions of a file
*
* @param string $fileName The full path of the file whose permissions will change
* @param integer $permissions The new permissions, e.g. 0644 (remember the leading zero in octal numbers!)
*
* @return boolean True on success
*/
public function chmod($fileName, $permissions)
{
// Make sure permissions are in an octal string representation
if (!is_string($permissions))
{
$permissions = decoct($permissions);
}
$commands = [
'chmod ' . $permissions . ' ' . $this->getPath($fileName),
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
return true;
}
/**
* Create a directory if it doesn't exist. The operation is implicitly recursive, i.e. it will create all
* intermediate directories if they do not already exist.
*
* @param string $dirName The full path of the directory to create
* @param integer $permissions The permissions of the created directory
*
* @return boolean True on success
*/
public function mkdir($dirName, $permissions = 0755)
{
$targetDir = rtrim($dirName, '/');
$directories = explode('/', $targetDir);
$remoteDir = '';
foreach ($directories as $dir)
{
if (!$dir)
{
continue;
}
$remoteDir .= '/' . $dir;
// Continue if the folder already exists. Otherwise I'll get a an error even if everything is fine
if ($this->isDir($remoteDir))
{
continue;
}
$commands = [
'mkdir ' . $remoteDir,
];
try
{
$this->executeServerCommands($commands);
}
catch (RuntimeException $e)
{
return false;
}
}
$this->chmod($dirName, $permissions);
return true;
}
/**
* Checks if the given directory exists
*
* @param string $path The full path of the remote directory to check
*
* @return boolean True if the directory exists
*/
public function isDir($path)
{
$ch = $this->getCurlHandle($path . '/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$list = curl_exec($ch);
$errNo = curl_errno($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
return false;
}
return true;
}
/**
* Get the current working directory. NOT IMPLEMENTED.
*
* @return string
*/
public function cwd()
{
return '';
}
/**
* Returns the absolute remote path from a path relative to the initial directory configured when creating the
* transfer object.
*
* @param string $fileName The relative path of a file or directory
*
* @return string The absolute path for use by the transfer object
*/
public function getPath($fileName)
{
$fileName = str_replace('\\', '/', $fileName);
if (strpos($fileName, $this->directory) === 0)
{
return $fileName;
}
$fileName = trim($fileName, '/');
$fileName = rtrim($this->directory, '/') . '/' . $fileName;
return $fileName;
}
/**
* Lists the subdirectories inside an SFTP directory
*
* @param null|string $dir The directory to scan. Skip to use the current directory.
*
* @return array|bool A list of folders, or false if we could not get a listing
*
* @throws RuntimeException When the server is incompatible with our SFTP folder scanner
*/
public function listFolders($dir = null)
{
if (empty($dir))
{
$dir = $this->directory;
}
$dir = rtrim($dir, '/');
$ch = $this->getCurlHandle($dir . '/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$list = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
throw new RuntimeException(sprintf("cURL Error $errNo ($error) while listing contents of directory \"%s\" – make sure the folder exists and that you have adequate permissions to it", $dir), 500);
}
if (empty($list))
{
throw new RuntimeException("Sorry, your SFTP server doesn't support our SFTP directory browser.");
}
$folders = [];
// Convert the directory listing into an array of lines without *NIX/Windows/Mac line ending characters
$list = explode("\n", $list);
$list = array_map('rtrim', $list);
foreach ($list as $v)
{
$vInfo = preg_split("/[\s]+/", $v, 9);
if ($vInfo[0] !== "total")
{
$perms = $vInfo[0];
if (substr($perms, 0, 1) == 'd')
{
$folders[] = $vInfo[8];
}
}
}
asort($folders);
return $folders;
}
/**
* Is the verbose debug option set?
*
* @return boolean
*/
public function isVerbose()
{
return $this->verbose;
}
/**
* Set the verbose debug option
*
* @param boolean $verbose
*
* @return void
*/
public function setVerbose($verbose)
{
$this->verbose = $verbose;
}
/**
* Returns a cURL resource handler for the remote SFTP server
*
* @param string $remoteFile Optional. The remote file / folder on the SFTP server you'll be manipulating with cURL.
*
* @return resource
*/
protected function getCurlHandle($remoteFile = '')
{
// Remember, the username has to be URL encoded as it's part of a URI!
$authentication = urlencode($this->username);
// We will only use username and password authentication if there are no certificates configured.
if (empty($this->publicKey))
{
// Remember, both the username and password have to be URL encoded as they're part of a URI!
$password = urlencode($this->password);
$authentication .= ':' . $password;
}
$ftpUri = 'sftp://' . $authentication . '@' . $this->host;
if (!empty($this->port))
{
$ftpUri .= ':' . (int) $this->port;
}
// Relative path? Append the initial directory.
if (substr($remoteFile, 0, 1) != '/')
{
$ftpUri .= $this->directory;
}
// Add a remote file if necessary. The filename must be URL encoded since we're creating a URI.
if (!empty($remoteFile))
{
$suffix = '';
$dirname = dirname($remoteFile);
// Windows messing up dirname('/'). KILL ME.
if ($dirname == '\\')
{
$dirname = '';
}
$dirname = trim($dirname, '/');
$basename = basename($remoteFile);
if ((substr($remoteFile, -1) == '/') && !empty($basename))
{
$suffix = '/' . $suffix;
}
$ftpUri .= '/' . $dirname . (empty($dirname) ? '' : '/') . urlencode($basename) . $suffix;
}
$ch = curl_init();
$this->applyProxySettingsToCurl($ch);
curl_setopt($ch, CURLOPT_URL, $ftpUri);
curl_setopt($ch, CURLOPT_TIMEOUT, $this->timeout);
// Do I have to use certificate authentication?
if (!empty($this->publicKey))
{
// We always need to provide a public key file
curl_setopt($ch, CURLOPT_SSH_PUBLIC_KEYFILE, $this->publicKey);
// Since SSH certificates are self-signed we cannot have cURL verify their signatures against a CA.
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYSTATUS, 0);
/**
* This is optional because newer versions of cURL can extract the private key file from a combined
* certificate file.
*/
if (!empty($this->privateKey))
{
curl_setopt($ch, CURLOPT_SSH_PRIVATE_KEYFILE, $this->privateKey);
}
/**
* In case of encrypted (a.k.a. password protected) private key files you need to also specify the
* certificate decryption key in the password field. However, if libcurl is compiled against the GnuTLS
* library (instead of OpenSSL) this will NOT work because of bugs / missing features in GnuTLS. It's the
* same problem you get when libssh is compiled against GnuTLS. The solution to that is having an
* unencrypted private key file.
*/
if (!empty($this->password))
{
curl_setopt($ch, CURLOPT_KEYPASSWD, $this->password);
}
}
// Should I enable verbose output? Useful for debugging.
if ($this->verbose)
{
curl_setopt($ch, CURLOPT_VERBOSE, 1);
}
// Automatically create missing directories
curl_setopt($ch, CURLOPT_FTP_CREATE_MISSING_DIRS, 1);
return $ch;
}
/**
* Uploads a file using file contents provided through a file handle
*
* @param string $remoteFilename
* @param resource $fp
*
* @return void
*
* @throws RuntimeException
*/
protected function uploadFromHandle($remoteFilename, $fp)
{
// We need the file size. We can do that by getting the file position at EOF
fseek($fp, 0, SEEK_END);
$filesize = ftell($fp);
rewind($fp);
$ch = $this->getCurlHandle($remoteFilename);
curl_setopt($ch, CURLOPT_UPLOAD, 1);
curl_setopt($ch, CURLOPT_INFILE, $fp);
curl_setopt($ch, CURLOPT_INFILESIZE, $filesize);
curl_exec($ch);
$error_no = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
fclose($fp);
if ($error_no)
{
throw new RuntimeException($error, $error_no);
}
}
/**
* Downloads a remote file to the provided file handle
*
* @param string $remoteFilename Filename on the remote server
* @param resource $fp File handle where the downloaded content will be written to
* @param bool $close Optional. Should I close the file handle when I'm done? (Default: true)
*
* @return void
*
* @throws RuntimeException
*/
protected function downloadToHandle($remoteFilename, $fp, $close = true)
{
$ch = $this->getCurlHandle($remoteFilename);
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_exec($ch);
$error_no = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($close)
{
fclose($fp);
}
if ($error_no)
{
throw new RuntimeException($error, $error_no);
}
}
/**
* Downloads a remote file and returns it as a string
*
* @param string $remoteFilename Filename on the remote server
*
* @return string
*
* @throws RuntimeException
*/
protected function downloadToString($remoteFilename)
{
$ch = $this->getCurlHandle($remoteFilename);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
$ret = curl_exec($ch);
$error_no = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($error_no)
{
throw new RuntimeException($error, $error_no);
}
return $ret;
}
/**
* Executes arbitrary SFTP commands
*
* @param array $commands An array with the SFTP commands to be executed
*
* @return string The output of the executed commands
*
* @throws RuntimeException
*/
protected function executeServerCommands($commands)
{
$ch = $this->getCurlHandle($this->directory . '/');
curl_setopt($ch, CURLOPT_QUOTE, $commands);
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_NOBODY, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$listing = curl_exec($ch);
$errNo = curl_errno($ch);
$error = curl_error($ch);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($ch);
}
if ($errNo)
{
throw new RuntimeException($error, $errNo);
}
return $listing;
}
}
PK \(d d ? vendor/akeeba/engine/engine/Util/Transfer/TransferInterface.phpnu [ .
*/
namespace Akeeba\Engine\Util\Transfer;
defined('AKEEBAENGINE') || die();
use RuntimeException;
/**
* An interface for Transfer adapters, used to transfer files to remote servers over FTP, FTPS, SFTP and possibly other
* file transfer methods we might implement.
*
* @package Akeeba\Engine\Util\Transfer
*/
interface TransferInterface
{
/**
* Creates the uploader
*
* @param array $config
*/
public function __construct(array $config);
/**
* Is this transfer method blocked by a server firewall?
*
* @param array $params Any additional parameters you might need to pass
*
* @return boolean True if the firewall blocks connections to a known host
*/
public static function isFirewalled(array $params = []);
/**
* Write the contents into the file
*
* @param string $fileName The full path to the remote file
* @param string $contents The contents to write to the file
*
* @return boolean True on success
*/
public function write($fileName, $contents);
/**
* Uploads a local file to the remote storage
*
* @param string $localFilename The full path to the local file
* @param string $remoteFilename The full path to the remote file
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function upload($localFilename, $remoteFilename, $useExceptions = true);
/**
* Read the contents of a remote file into a string
*
* @param string $fileName The full path to the remote file
*
* @return string The contents of the remote file
*/
public function read($fileName);
/**
* Download a remote file into a local file
*
* @param string $remoteFilename The remote file path to download from
* @param string $localFilename The local file path to download to
* @param bool $useExceptions Throw an exception instead of returning "false" on connection error.
*
* @return boolean True on success
*/
public function download($remoteFilename, $localFilename, $useExceptions = true);
/**
* Delete a remote file
*
* @param string $fileName The full path to the remote file
*
* @return boolean True on success
*/
public function delete($fileName);
/**
* Create a copy of the remote file
*
* @param string $from The full path of the remote file to copy from
* @param string $to The full path of the remote file that will hold the copy
*
* @return boolean True on success
*/
public function copy($from, $to);
/**
* Move or rename a file
*
* @param string $from The full remote path of the file to move
* @param string $to The full remote path of the target file
*
* @return boolean True on success
*/
public function move($from, $to);
/**
* Change the permissions of a file
*
* @param string $fileName The full path of the remote file whose permissions will change
* @param integer $permissions The new permissions, e.g. 0644 (remember the leading zero in octal numbers!)
*
* @return boolean True on success
*/
public function chmod($fileName, $permissions);
/**
* Create a directory if it doesn't exist. The operation is implicitly recursive, i.e. it will create all
* intermediate directories if they do not already exist.
*
* @param string $dirName The full path of the remote directory to create
* @param integer $permissions The permissions of the created directory
*
* @return boolean True on success
*/
public function mkdir($dirName, $permissions = 0755);
/**
* Checks if the given directory exists
*
* @param string $path The full path of the remote directory to check
*
* @return boolean True if the directory exists
*/
public function isDir($path);
/**
* Get the current working directory
*
* @return string
*/
public function cwd();
/**
* Returns the absolute remote path from a path relative to the initial directory configured when creating the
* transfer object.
*
* @param string $fileName The relative path of a file or directory
*
* @return string The absolute path for use by the transfer object
*/
public function getPath($fileName);
/**
* Lists the subdirectories inside a directory
*
* @param null|string $dir The directory to scan. Skip to use the current directory.
*
* @return array|bool A list of folders, or false if we could not get a listing
*
* @throws RuntimeException When the server is incompatible with our folder scanner
*/
public function listFolders($dir = null);
}
PK \Sʉ 3 vendor/akeeba/engine/engine/Util/Transfer/.htaccessnu 7m
Order allow,deny
Deny from all
PK \i[m ) vendor/akeeba/engine/engine/Util/Phin.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
class Phin
{
private static array $map = [
'a' => 'k', 'b' => 'm', 'c' => 'z', 'd' => 'p', 'e' => 'h',
'f' => 'q', 'g' => 'w', 'h' => 'y', 'i' => 'x', 'j' => 'n',
'k' => 'v', 'l' => 'u', 'm' => 't', 'n' => 's', 'o' => 'r',
'p' => 'j', 'q' => 'o', 'r' => 'i', 's' => 'g', 't' => 'f',
'u' => 'e', 'v' => 'd', 'w' => 'c', 'x' => 'b', 'y' => 'a',
'z' => 'l',
'A' => 'N', 'B' => 'Q', 'C' => 'K', 'D' => 'Z', 'E' => 'V',
'F' => 'J', 'G' => 'X', 'H' => 'B', 'I' => 'M', 'J' => 'F',
'K' => 'W', 'L' => 'P', 'M' => 'S', 'N' => 'H', 'O' => 'C',
'P' => 'E', 'Q' => 'Y', 'R' => 'G', 'S' => 'T', 'T' => 'A',
'U' => 'L', 'V' => 'O', 'W' => 'R', 'X' => 'D', 'Y' => 'U',
'Z' => 'I',
];
public static function cee(string $string): string
{
return strtr($string, self::$map);
}
public static function artoo(string $string): string
{
return strtr($string, array_flip(self::$map));
}
}
PK \?SK K 3 vendor/akeeba/engine/engine/Util/SecureSettings.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
/**
* Implements encrypted settings handling features
*
* @author nicholas
*/
class SecureSettings
{
/**
* The filename for the settings encryption key
*
* @var string
*/
protected $keyFilename = 'serverkey.php';
protected $key = null;
/**
* Set the key filename e.g. 'serverkey.php';
*
* @param string $filename The new filename to use
*
* @return void
*/
public function setKeyFilename($filename)
{
$this->keyFilename = $filename;
}
/**
* Sets the server key, overriding an already loaded key.
*
* @param $key
*/
public function setKey($key)
{
$this->key = $key;
}
/**
* Gets the configured server key, automatically loading the server key storage file
* if required.
*
* @return string
*/
public function getKey()
{
if (is_null($this->key))
{
$this->key = '';
if (!defined('AKEEBA_SERVERKEY'))
{
$filename = dirname(__FILE__) . '/../' . $this->keyFilename;
$altFilename = $this->keyFilename;
if (file_exists($filename))
{
include_once $filename;
}
elseif (file_exists($altFilename))
{
include_once $altFilename;
}
}
if (defined('AKEEBA_SERVERKEY'))
{
$this->key = base64_decode(AKEEBA_SERVERKEY);
}
}
return $this->key;
}
/**
* Do the server options allow us to use settings encryption?
*
* @return bool
*/
public function supportsEncryption()
{
// Do we have the encrypt.php plugin?
if (!class_exists('\\Akeeba\\Engine\\Util\\Encrypt', true))
{
return false;
}
// Did the user intentionally disable settings encryption?
$useEncryption = Platform::getInstance()->get_platform_configuration_option('useencryption', -1);
if ($useEncryption == 0)
{
return false;
}
// Do we have base64_encode/_decode required for encryption?
if (!function_exists('base64_encode') || !function_exists('base64_decode'))
{
return false;
}
// Pre-requisites met. We can encrypt and decrypt!
return true;
}
/**
* Gets the preferred encryption mode. Currently, if mcrypt is installed and activated we will
* use AES128.
*
* @return string
*/
public function preferredEncryption()
{
$aes = new Encrypt();
$adapter = $aes->getAdapter();
if (!$adapter->isSupported())
{
return 'CTR128';
}
return 'AES128';
}
/**
* Encrypts the settings using the automatically detected preferred algorithm
*
* @param $rawSettings string The raw settings string
* @param $key string The encryption key. Set to NULL to automatically find the key.
*
* @return string The encrypted data to store in the database
*/
public function encryptSettings($rawSettings, $key = null)
{
// Do we really support encryption?
if (!$this->supportsEncryption())
{
return $rawSettings;
}
// Does any of the preferred encryption engines exist?
$encryption = $this->preferredEncryption();
if (empty($encryption))
{
return $rawSettings;
}
// Do we have a non-empty key to begin with?
if (empty($key))
{
$key = $this->getKey();
}
if (empty($key))
{
return $rawSettings;
}
if ($encryption == 'AES128')
{
$encrypted = Factory::getEncryption()->AESEncryptCBC($rawSettings, $key);
if (empty($encrypted))
{
$encryption = 'CTR128';
}
else
{
// Note: CBC returns the encrypted data as a binary string and requires Base 64 encoding
$rawSettings = '###AES128###' . base64_encode($encrypted);
}
}
if ($encryption == 'CTR128')
{
$encrypted = Factory::getEncryption()->AESEncryptCtr($rawSettings, $key, 128);
if (!empty($encrypted))
{
// Note: CTR returns the encrypted data readily encoded in Base 64
$rawSettings = '###CTR128###' . $encrypted;
}
}
return $rawSettings;
}
/**
* Decrypts the encrypted settings and returns the plaintext INI string
*
* @param string $encrypted The encrypted data
*
* @return string The decrypted data
*/
public function decryptSettings($encrypted, $key = null)
{
if (substr($encrypted, 0, 12) == '###AES128###')
{
$mode = 'AES128';
}
elseif (substr($encrypted, 0, 12) == '###CTR128###')
{
$mode = 'CTR128';
}
else
{
return $encrypted;
}
if (empty($key))
{
$key = $this->getKey();
}
if (empty($key))
{
return '';
}
$encrypted = substr($encrypted, 12);
switch ($mode)
{
default:
case 'AES128':
$encrypted = base64_decode($encrypted);
$decrypted = rtrim(Factory::getEncryption()->AESDecryptCBC($encrypted, $key), "\0");
break;
case 'CTR128':
$decrypted = Factory::getEncryption()->AESDecryptCtr($encrypted, $key, 128);
break;
}
if (empty($decrypted))
{
$decrypted = '';
}
return $decrypted;
}
}
PK \Gi: i: + vendor/akeeba/engine/engine/Util/Logger.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\Log\LogInterface;
use Akeeba\Engine\Util\Log\WarningsLoggerAware;
use Akeeba\Engine\Util\Log\WarningsLoggerInterface;
use Akeeba\Engine\Psr\Log\InvalidArgumentException;
use Akeeba\Engine\Psr\Log\LoggerInterface;
use Akeeba\Engine\Psr\Log\LogLevel;
/**
* Writes messages to the backup log file
*/
class Logger implements LoggerInterface, LogInterface, WarningsLoggerInterface
{
use WarningsLoggerAware;
/** @var string Full path to log file */
protected $logName = null;
/** @var string The current log tag */
protected $currentTag = null;
/** @var resource The file pointer to the current log file */
protected $fp = null;
/** @var bool Is the logging currently paused? */
protected $paused = false;
/** @var int The minimum log level */
protected $configuredLoglevel;
/** @var string The untranslated path to the site's root */
protected $site_root_untranslated;
/** @var string The translated path to the site's root */
protected $site_root;
/**
* Public constructor. Initialises the properties with the parameters from the backup profile and platform.
*/
public function __construct()
{
$this->initialiseWithProfileParameters();
}
/**
* When shutting down this class always close any open log files.
*/
public function __destruct()
{
$this->close();
}
/**
* Clears the logfile
*
* @param string $tag Backup origin
*/
public function reset($tag = null)
{
// Pause logging
$this->pause();
// Get the file names for the default log and the tagged log
$currentLogName = $this->logName;
$this->logName = $this->getLogFilename($tag);
// Close the file if it's open
if ($currentLogName == $this->logName)
{
$this->close();
}
// Remove the log file if it exists
@unlink($this->logName);
// Reset the log file
$fp = @fopen($this->logName, 'w');
$hasWritten = false;
if ($fp !== false)
{
$hasWritten = fwrite($fp, '<' . '?' . 'php die(); ' . '?' . '>' . "\n") !== false;
@fclose($fp);
}
// If I could not write to a .log.php file try using a .log file instead.
if (!$hasWritten)
{
$this->logName = $this->getLogFilename($tag, '');
$fp = @fopen($this->logName, 'w');
$hasWritten = false;
if ($fp !== false)
{
$hasWritten = fwrite($fp, "\n") !== false;
@fclose($fp);
}
}
// Delete the default log file(s) if they exists
$defaultLog = $this->getLogFilename(null);
if (!empty($tag) && @file_exists($defaultLog))
{
@unlink($defaultLog);
}
$defaultLog = $this->getLogFilename(null, '');
if (!empty($tag) && @file_exists($defaultLog))
{
@unlink($defaultLog);
}
// Set the current log tag
$this->currentTag = $tag;
// Unpause logging
$this->unpause();
}
/**
* Writes a line to the log, if the log level is high enough
*
* @param string $level The log level
* @param string $message The message to write to the log
* @param array $context The logging context. For PSR-3 compatibility but not used in text file logs.
*
* @return void
*/
public function log($level, $message = '', array $context = [])
{
// Warnings are enqueued no matter what is the minimum log level to report in the log file
if (in_array($level, [LogLevel::WARNING, LogLevel::NOTICE]))
{
$this->enqueueWarning($message);
}
// If we are told to not log anything we can't continue
if ($this->configuredLoglevel == 0)
{
return;
}
// Open the log if it's closed
if (is_null($this->fp))
{
$this->open($this->currentTag);
}
// If the log could not be opened we can't continue
if (is_null($this->fp))
{
return;
}
// If the logging is paused we can't continue
if ($this->paused)
{
return;
}
// Get the log level as an integer (compatibility with our minimum log level configuration parameter)
switch ($level)
{
case LogLevel::EMERGENCY:
case LogLevel::ALERT:
case LogLevel::CRITICAL:
case LogLevel::ERROR:
$intLevel = 1;
break;
case LogLevel::WARNING:
case LogLevel::NOTICE:
$intLevel = 2;
break;
case LogLevel::INFO:
$intLevel = 3;
break;
case LogLevel::DEBUG:
$intLevel = 4;
break;
default:
throw new InvalidArgumentException("Unknown log level $level", 500);
break;
}
// If the minimum log level is lower than what we're trying to log we cannot continue
if ($this->configuredLoglevel < $intLevel)
{
return;
}
$translateRoot = boolval($context['root_translate'] ?? false);
// Replace the site's root with in the log file
if ($translateRoot && !defined('AKEEBADEBUG'))
{
$message = str_replace($this->site_root_untranslated, "", $message);
$message = str_replace($this->site_root, "", $message);
}
// Replace new lines
$message = str_replace("\r\n", "\n", $message);
$message = str_replace("\r", "\n", $message);
$message = str_replace("\n", ' \n ', $message);
switch ($level)
{
case LogLevel::EMERGENCY:
case LogLevel::ALERT:
case LogLevel::CRITICAL:
case LogLevel::ERROR:
$string = "ERROR |";
break;
case LogLevel::WARNING:
case LogLevel::NOTICE:
$string = "WARNING |";
break;
case LogLevel::INFO:
$string = "INFO |";
break;
default:
$string = "DEBUG |";
break;
}
$string .= gmdate('Ymd H:i:s') . "|$message\r\n";
@fwrite($this->fp, $string);
}
/**
* Calculates the absolute path to the log file
*
* @param string $tag The backup run's tag
*
* @return string The absolute path to the log file
*/
public function getLogFilename($tag = null, $extension = '.php')
{
if (empty($tag))
{
$fileName = 'akeeba.log' . $extension;
}
else
{
$fileName = "akeeba.$tag.log" . $extension;
}
// Get output directory
$registry = Factory::getConfiguration();
$outputDirectory = $registry->get('akeeba.basic.output_directory');
// Get the log file name
$absoluteLogFilename = Factory::getFilesystemTools()->TranslateWinPath($outputDirectory . DIRECTORY_SEPARATOR . $fileName);
return $absoluteLogFilename;
}
/**
* Close the currently active log and set the current tag to null.
*
* @return void
*/
public function close()
{
// The log file changed. Close the old log.
if (is_resource($this->fp))
{
@fclose($this->fp);
}
$this->fp = null;
$this->currentTag = null;
}
/**
* Open a new log instance with the specified tag. If another log is already open it is closed before switching to
* the new log tag. If the tag is null use the default log defined in the logging system.
*
* @param string|null $tag The log to open
*
* @return void
*/
public function open($tag = null, $extension = '.php')
{
// If the log is already open do nothing
if (is_resource($this->fp) && ($tag == $this->currentTag))
{
return;
}
// If another log is open, close it
if (is_resource($this->fp))
{
$this->close();
}
// Re-initialise site root and minimum log level since the active profile might have changed in the meantime
$this->initialiseWithProfileParameters();
// Set the current tag
$this->currentTag = $tag;
// Get the log filename
$this->logName = $this->getLogFilename($tag, $extension);
// Touch the file
@touch($this->logName);
// Open the log file. DO NOT USE APPEND ('ab') MODE. I NEED TO SEEK INTO THE FILE. SEE FURTHER BELOW!
$this->fp = @fopen($this->logName, 'c');
// If we couldn't open the file set the file pointer to null
if ($this->fp === false)
{
$this->fp = null;
return;
}
// Go to the end of the file, emulating append mode. DO NOT REPLACE THE fopen() FILE MODE!
if (@fseek($this->fp, 0, SEEK_END) === -1)
{
@fclose($this->fp);
@unlink($this->logName);
$this->fp = null;
return;
}
/**
* The following sounds pretty stupid but there is a reason for that convoluted code.
*
* Some hosts, like WP Engine, will now allow you to write to a log file with a .php extension. The code below
* tries to anticipate that when the log extension is .php. It will try to write to the *.log.php file and the
* text is actually resembling PHP code. Hosts like WP Engine will fail the fwrite() which will cause this
* method to terminate early and return a null pointer. Our code will catch this case and try to use a .log
* extension as a safe fallback.
*/
if ($extension !== '.php')
{
return;
}
// Try to write something into the file
$written = @fwrite($this->fp, '' . "\n");
if ($written === false)
{
@fclose($this->fp);
@unlink($this->logName);
$this->fp = null;
$this->open($tag, '');
return;
}
// Store truncate offset, we will have to rewind the internal pointer to it
$truncate_point = ftell($this->fp) - $written;
if (ftruncate($this->fp, $truncate_point) === false)
{
@fclose($this->fp);
@unlink($this->logName);
$this->fp = null;
$this->open($tag, '');
return;
}
// Finally, move the file pointer at the truncation point. Otherwise PHP will append NULL bytes to the string
// to "pad" the file length to the internal file pointer. No need to check if the operation was successful,
// worst case scenario we will have some extra NULL bytes, there's no need to kill the log operation
@fseek($this->fp, $truncate_point);
}
/**
* Temporarily pause log output. The log() method MUST respect this.
*
* @return void
*/
public function pause()
{
$this->paused = true;
}
/**
* Resume the previously paused log output. The log() method MUST respect this.
*
* @return void
*/
public function unpause()
{
$this->paused = false;
}
/**
* Returns the timestamp (in UNIX time long integer format) of the last log message written to the log with the
* specific tag. The timestamp MUST be read from the log itself, not from the logger object. It is used by the
* engine to find out the age of stalled backups which may have crashed.
*
* @param string|null $tag The log tag for which the last timestamp is returned
*
* @return int|null The timestamp of the last log message, in UNIX time. NULL if we can't get the timestamp.
*/
public function getLastTimestamp($tag = null)
{
$fileName = $this->getLogFilename($tag);
/**
* The log file akeeba.tag.log.php may not exist but the akeeba.tag.log does. This would be the case in some bad
* hosts, like WPEngine, which do not allow us to create .php files EVEN THOUGH that's the only way to ensure
* the privileged information in the log file is not readable over the web. You can't fix bad hosts, you can
* only work around them.
*/
if (!@file_exists($fileName) && @file_exists(substr($fileName, 0, -4)))
{
$fileName = substr($fileName, 0, -4);
}
$timestamp = @filemtime($fileName);
if ($timestamp === false)
{
return null;
}
return $timestamp;
}
/**
* System is unusable.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function emergency($message, array $context = [])
{
$this->log(LogLevel::EMERGENCY, $message, $context);
}
/**
* Action must be taken immediately.
*
* Example: Entire website down, database unavailable, etc. This should
* trigger the SMS alerts and wake you up.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function alert($message, array $context = [])
{
$this->log(LogLevel::ALERT, $message, $context);
}
/**
* Critical conditions.
*
* Example: Application component unavailable, unexpected exception.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function critical($message, array $context = [])
{
$this->log(LogLevel::CRITICAL, $message, $context);
}
/**
* Runtime errors that do not require immediate action but should typically
* be logged and monitored.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function error($message, array $context = [])
{
$this->log(LogLevel::ERROR, $message, $context);
}
/**
* \Exceptional occurrences that are not errors.
*
* Example: Use of deprecated APIs, poor use of an API, undesirable things
* that are not necessarily wrong.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function warning($message, array $context = [])
{
$this->log(LogLevel::WARNING, $message, $context);
}
/**
* Normal but significant events.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function notice($message, array $context = [])
{
$this->log(LogLevel::NOTICE, $message, $context);
}
/**
* Interesting events.
*
* Example: User logs in, SQL logs.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function info($message, array $context = [])
{
$this->log(LogLevel::INFO, $message, $context);
}
/**
* Detailed debug information.
*
* @param string $message
* @param array $context
*
* @return void
*/
public function debug($message, array $context = [])
{
$this->log(LogLevel::DEBUG, $message, $context);
}
/**
* Initialise the logger properties with parameters from the backup profile and the platform
*
* @return void
*/
protected function initialiseWithProfileParameters()
{
// Get the site's translated and untranslated root
$this->site_root_untranslated = Platform::getInstance()->get_site_root();
$this->site_root = Factory::getFilesystemTools()->TranslateWinPath($this->site_root_untranslated);
// Load the registry and fetch log level
$registry = Factory::getConfiguration();
$this->configuredLoglevel = $registry->get('akeeba.basic.log_level');
$this->configuredLoglevel = $this->configuredLoglevel * 1;
}
}
PK \rF F / vendor/akeeba/engine/engine/Util/Collection.phpnu [ .
*/
namespace Akeeba\Engine\Util;
use ArrayAccess;
use ArrayIterator;
use CachingIterator;
use Countable;
use IteratorAggregate;
use JsonSerializable;
use ReturnTypeWillChange;
class Collection implements ArrayAccess, Countable, IteratorAggregate, JsonSerializable
{
/**
* The items contained in the collection.
*
* @var array
*/
protected array $items = [];
/**
* Create a new collection.
*
* @param array $items
*/
public function __construct(array $items = [])
{
$this->items = $items;
}
/**
* Create a new collection instance if the value isn't one already.
*
* @param mixed $items
*
* @return static
*/
public static function make($items): self
{
if (is_null($items))
{
return new static;
}
if ($items instanceof Collection)
{
return $items;
}
return new static(is_array($items) ? $items : [$items]);
}
/**
* Get all of the items in the collection.
*
* @return array
*/
public function all(): array
{
return $this->items;
}
/**
* Collapse the collection items into a single array.
*
* @return static
*/
public function collapse(): self
{
$results = [];
foreach ($this->items as $values)
{
$results = array_merge($results, $values);
}
return new static($results);
}
/**
* Diff the collection with the given items.
*
* @param static|array $items
*
* @return static
*/
public function diff($items): Collection
{
return new static(array_diff($this->items, $this->getArrayableItems($items)));
}
/**
* Execute a callback over each item.
*
* @param callable $callback
*
* @return static
*/
public function each(callable $callback): self
{
array_map($callback, $this->items);
return $this;
}
/**
* Fetch a nested element of the collection.
*
* @param string $key
*
* @return static
*/
public function fetch(string $key): self
{
return new static($this->array_fetch($this->items, $key));
}
/**
* Run a filter over each of the items.
*
* @param callable $callback
*
* @return static
*/
public function filter(callable $callback): self
{
return new static(array_filter($this->items, $callback));
}
/**
* Get the first item from the collection.
*
* @param callable|null $callback
* @param mixed $default
*
* @return mixed|null
*/
public function first(?callable $callback = null, $default = null)
{
if (is_null($callback))
{
return count($this->items) > 0 ? reset($this->items) : null;
}
else
{
return $this->array_first($this->items, $callback, $default);
}
}
/**
* Get a flattened array of the items in the collection.
*
* @return static
*/
public function flatten(): self
{
return new static($this->array_flatten($this->items));
}
/**
* Remove an item from the collection by key.
*
* @param mixed $key
*
* @return void
*/
public function forget($key)
{
unset($this->items[$key]);
}
/**
* Get an item from the collection by key.
*
* @param mixed $key
* @param mixed $default
*
* @return mixed
*/
public function get($key, $default = null)
{
if (array_key_exists($key, $this->items))
{
return $this->items[$key];
}
return $this->collapseValue($default);
}
/**
* Group an associative array by a field or callable value.
*
* @param callable|string $groupBy
*
* @return static
*/
public function groupBy($groupBy): self
{
$results = [];
foreach ($this->items as $key => $value)
{
$key = is_callable($groupBy) ? $groupBy($value, $key) : $this->array_get($value, $groupBy);
$results[$key][] = $value;
}
return new static($results);
}
/**
* Determine if an item exists in the collection by key.
*
* @param mixed $key
*
* @return bool
*/
public function has($key): bool
{
return array_key_exists($key, $this->items);
}
/**
* Concatenate values of a given key as a string.
*
* @param string $value
* @param string|null $glue
*
* @return string
*/
public function implode(string $value, ?string $glue = null): string
{
if (is_null($glue))
{
return implode($this->lists($value));
}
return implode($glue, $this->lists($value));
}
/**
* Intersect the collection with the given items.
*
* @param Collection|array $items
*
* @return static
*/
public function intersect($items): self
{
return new static(array_intersect($this->items, $this->getArrayableItems($items)));
}
/**
* Determine if the collection is empty or not.
*
* @return bool
*/
public function isEmpty(): bool
{
return empty($this->items);
}
/**
* Get the last item from the collection.
*
* @return mixed|null
*/
public function last()
{
return count($this->items) > 0 ? end($this->items) : null;
}
/**
* Get an array with the values of a given key.
*
* @param string $value
* @param string|null $key
*
* @return array
*/
public function lists(string $value, ?string $key = null): array
{
return $this->array_pluck($this->items, $value, $key);
}
/**
* Run a map over each of the items.
*
* @param callable $callback
*
* @return static
*/
public function map(callable $callback): Collection
{
return new static(array_map($callback, $this->items, array_keys($this->items)));
}
/**
* Run a map over each of the items, preserving the keys.
*
* @param callable $callback
*
* @return static
*/
public function mapPreserve(callable $callback): Collection
{
return new static(array_map($callback, $this->items));
}
/**
* Merge the collection with the given items.
*
* @param Collection|array $items
*
* @return static
*/
public function merge($items): Collection
{
return new static(array_merge($this->items, $this->getArrayableItems($items)));
}
/**
* Get and remove the last item from the collection.
*
* @return mixed|null
*/
public function pop()
{
return array_pop($this->items);
}
/**
* Push an item onto the beginning of the collection.
*
* @param mixed $value
*
* @return void
*/
public function prepend($value)
{
array_unshift($this->items, $value);
}
/**
* Push an item onto the end of the collection.
*
* @param mixed $value
*
* @return void
*/
public function push($value)
{
$this->items[] = $value;
}
/**
* Put an item in the collection by key.
*
* @param mixed $key
* @param mixed $value
*
* @return void
*/
public function put($key, $value)
{
$this->items[$key] = $value;
}
/**
* Reduce the collection to a single value.
*
* @param callable $callback
* @param mixed $initial
*
* @return mixed
*/
public function reduce(callable $callback, $initial = null)
{
return array_reduce($this->items, $callback, $initial);
}
/**
* Get one or more items randomly from the collection.
*
* @param int $amount
*
* @return mixed
*/
public function random(int $amount = 1)
{
$keys = array_rand($this->items, $amount);
return is_array($keys) ? array_intersect_key($this->items, array_flip($keys)) : $this->items[$keys];
}
/**
* Reverse items order.
*
* @return static
*/
public function reverse(): Collection
{
return new static(array_reverse($this->items));
}
/**
* Get and remove the first item from the collection.
*
* @return mixed|null
*/
public function shift()
{
return array_shift($this->items);
}
/**
* Slice the underlying collection array.
*
* @param int $offset
* @param int|null $length
* @param bool $preserveKeys
*
* @return static
*/
public function slice(int $offset, ?int $length = null, bool $preserveKeys = false): Collection
{
return new static(array_slice($this->items, $offset, $length, $preserveKeys));
}
/**
* Sort through each item with a callback.
*
* @param callable $callback
*
* @return static
*/
public function sort(callable $callback): self
{
uasort($this->items, $callback);
return $this;
}
/**
* Sort the collection using the given callable.
*
* @param callable|string $callback
* @param int $options
* @param bool $descending
*
* @return static
*/
public function sortBy($callback, int $options = SORT_REGULAR, bool $descending = false): self
{
$results = [];
if (is_string($callback))
{
$callback =
$this->valueRetriever($callback);
}
// First we will loop through the items and get the comparator from a callback
// function which we were given. Then, we will sort the returned values and
// and grab the corresponding values for the sorted keys from this array.
foreach ($this->items as $key => $value)
{
$results[$key] = $callback($value);
}
$descending ? arsort($results, $options)
: asort($results, $options);
// Once we have sorted all of the keys in the array, we will loop through them
// and grab the corresponding model so we can set the underlying items list
// to the sorted version. Then we'll just return the collection instance.
foreach (array_keys($results) as $key)
{
$results[$key] = $this->items[$key];
}
$this->items = $results;
return $this;
}
/**
* Sort the collection in descending order using the given callable.
*
* @param callable|string $callback
* @param int $options
*
* @return static
*/
public function sortByDesc($callback, int $options = SORT_REGULAR): Collection
{
return $this->sortBy($callback, $options, true);
}
/**
* Splice portion of the underlying collection array.
*
* @param int $offset
* @param int $length
* @param mixed $replacement
*
* @return static
*/
public function splice(int $offset, int $length = 0, $replacement = []): self
{
return new static(array_splice($this->items, $offset, $length, $replacement));
}
/**
* Get the sum of the given values.
*
* @param callable|string $callback
*
* @return mixed
*/
public function sum($callback)
{
if (is_string($callback))
{
$callback = $this->valueRetriever($callback);
}
return $this->reduce(
function ($result, $item) use ($callback) {
return $result += $callback($item);
}, 0
);
}
/**
* Take the first or last {$limit} items.
*
* @param int|null $limit
*
* @return static
*/
public function take(?int $limit = null): self
{
if ($limit < 0)
{
return $this->slice($limit, abs($limit));
}
return $this->slice(0, $limit);
}
/**
* Transform each item in the collection using a callback.
*
* @param callable $callback
*
* @return static
*/
public function transform(callable $callback): self
{
$this->items = array_map($callback, $this->items);
return $this;
}
/**
* Return only unique items from the collection array.
*
* @return static
*/
public function unique(): self
{
return new static(array_unique($this->items));
}
/**
* Reset the keys on the underlying array.
*
* @return static
*/
public function values(): self
{
$this->items = array_values($this->items);
return $this;
}
/**
* Get the collection of items as a plain array.
*
* @return array
*/
public function toArray(): array
{
return array_map(
function ($value) {
return (is_object($value) && method_exists($value, 'toArray')) ? $value->toArray() : $value;
}, $this->items
);
}
/**
* Convert the object into something JSON serializable.
*
* @return array
*/
#[ReturnTypeWillChange]
public function jsonSerialize()
{
return $this->toArray();
}
/**
* Get the collection of items as JSON.
*
* @param int $options
*
* @return string
*/
public function toJson(int $options = 0): string
{
return json_encode($this->toArray(), $options);
}
/**
* Get an iterator for the items.
*
* @return ArrayIterator
*/
#[ReturnTypeWillChange]
public function getIterator()
{
return new ArrayIterator($this->items);
}
/**
* Get a CachingIterator instance.
*
* @param integer $flags Caching iterator flags
*
* @return CachingIterator
*/
public function getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING): CachingIterator
{
return new CachingIterator($this->getIterator(), $flags);
}
/**
* Count the number of items in the collection.
*
* @return int
*/
#[ReturnTypeWillChange]
public function count()
{
return count($this->items);
}
/**
* Determine if an item exists at an offset.
*
* @param mixed $key
*
* @return bool
*/
#[ReturnTypeWillChange]
public function offsetExists($key)
{
return array_key_exists($key, $this->items);
}
/**
* Get an item at a given offset.
*
* @param mixed $key
*
* @return mixed
*/
#[ReturnTypeWillChange]
public function offsetGet($key)
{
return $this->items[$key];
}
/**
* Set the item at a given offset.
*
* @param mixed $key
* @param mixed $value
*
* @return void
*/
#[ReturnTypeWillChange]
public function offsetSet($key, $value)
{
if (is_null($key))
{
$this->items[] = $value;
}
else
{
$this->items[$key] = $value;
}
}
/**
* Unset the item at a given offset.
*
* @param string $key
*
* @return void
*/
#[ReturnTypeWillChange]
public function offsetUnset($key)
{
unset($this->items[$key]);
}
/**
* Convert the collection to its string representation.
*
* @return string
*/
#[ReturnTypeWillChange]
public function __toString()
{
return $this->toJson();
}
/**
* Get a value retrieving callback.
*
* @param string $value
*
* @return callable
*/
protected function valueRetriever(string $value): callable
{
return function ($item) use ($value) {
return is_object($item) ? $item->{$value} : $this->array_get($item, $value);
};
}
/**
* Fetch a flattened array of a nested array element.
*
* @param array $array
* @param string $key
*
* @return array
*/
private function array_fetch(array $array, string $key): array
{
foreach (explode('.', $key) as $segment)
{
$results = [];
foreach ($array as $value)
{
$value = (array) $value;
$results[] = $value[$segment];
}
$array = array_values($results);
}
return array_values($results);
}
/**
* Return the first element in an array passing a given truth test.
*
* @param array $array
* @param callable $callback
* @param mixed $default
*
* @return mixed
*/
private function array_first(array $array, callable $callback, $default = null)
{
foreach ($array as $key => $value)
{
if (call_user_func($callback, $key, $value))
{
return $value;
}
}
return $this->collapseValue($default);
}
/**
* Return the default value of the given value.
*
* @param mixed $value
*
* @return mixed
*/
private function collapseValue($value)
{
return is_callable($value) ? $value() : $value;
}
/**
* Flatten a multi-dimensional array into a single level.
*
* @param array $array
*
* @return array
*/
private function array_flatten(array $array): array
{
$return = [];
array_walk_recursive(
$array, function ($x) use (&$return) {
$return[] = $x;
}
);
return $return;
}
/**
* Get an item from an array using "dot" notation.
*
* @param array $array
* @param string $key
* @param mixed $default
*
* @return mixed
*/
private function array_get(array $array, string $key, $default = null)
{
if (is_null($key))
{
return $array;
}
if (isset($array[$key]))
{
return $array[$key];
}
foreach (explode('.', $key) as $segment)
{
if (!is_array($array) || !array_key_exists($segment, $array))
{
return $this->collapseValue($default);
}
$array = $array[$segment];
}
return $array;
}
/**
* Pluck an array of values from an array.
*
* @param array $array
* @param string $value
* @param string|null $key
*
* @return array
*/
private function array_pluck(array $array, string $value, ?string $key = null): array
{
$results = [];
foreach ($array as $item)
{
$itemValue = is_object($item) ? $item->{$value} : $item[$value];
// If the key is "null", we will just append the value to the array and keep
// looping. Otherwise we will key the array using the value of the key we
// received from the developer. Then we'll return the final array form.
if (is_null($key))
{
$results[] = $itemValue;
}
else
{
$itemKey = is_object($item) ? $item->{$key} : $item[$key];
$results[$itemKey] = $itemValue;
}
}
return $results;
}
/**
* Results array of items from Collection.
*
* @param Collection|array $items
*
* @return array
*/
private function getArrayableItems($items): array
{
if ($items instanceof Collection)
{
$items = $items->all();
}
elseif (is_object($items) && method_exists($items, 'toArray'))
{
$items = $items->toArray();
}
return $items;
}
}PK \` ^ ^ 3 vendor/akeeba/engine/engine/Util/FileCloseAware.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Throwable;
trait FileCloseAware
{
protected function conditionalFileClose($fp): bool
{
if (!is_resource($fp))
{
return false;
}
try
{
return @fclose($fp);
}
catch (Throwable $e)
{
return false;
}
}
}PK \SW W / vendor/akeeba/engine/engine/Util/Statistics.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Exception;
class Statistics
{
/** @var bool used to block multipart updating initializing the backup */
private $multipart_lock = true;
/** @var int The statistics record number of the current backup attempt */
private $statistics_id = null;
/** @var array Local cache of the stat record data */
private $cached_data = [];
/**
* Returns all the filenames of the backup archives for the specified stat record,
* or null if the backup type is wrong or the file doesn't exist. It takes into
* account the multipart nature of Split Backup Archives.
*
* @param array $stat The backup statistics record
* @param bool $skipNonComplete Skips over backups with no files produced
*
* @return array|null The filenames or null if it's not applicable
*/
public static function get_all_filenames($stat, $skipNonComplete = true)
{
// Shortcut for database entries marked as having no files
if ($stat['filesexist'] == 0)
{
return [];
}
// Initialize
$base_directory = @dirname($stat['absolute_path']);
$base_filename = $stat['archivename'];
$filenames = [$base_filename];
if (empty($base_filename))
{
// This is a backup with a writer which doesn't store files on the server
return null;
}
// Calculate all the filenames for this backup
if ($stat['multipart'] > 1)
{
// Find the base filename and extension
$dotpos = strrpos($base_filename, '.');
$extension = substr($base_filename, $dotpos);
$basefile = substr($base_filename, 0, $dotpos);
// Calculate the multiple names
$multipart = $stat['multipart'];
for ($i = 1; $i < $multipart; $i++)
{
// Note: For $multipart = 10, it will produce i.e. .z01 through .z10
// This is intentional. If the backup aborts and multipart=1, we
// might be stuck with a .z01 file instead of a .zip. So do not
// change the less than or equal with a straight less than.
$filenames[] = $basefile . substr($extension, 0, 2) . sprintf('%02d', $i);
}
}
// Check if the files exist, otherwise attempt to provide relocated filename
$ret = [];
$ds = DIRECTORY_SEPARATOR;
// $test_file is the first file which must have been created
$test_file = count($filenames) == 1 ? $filenames[0] : $filenames[1];
if (
(!@file_exists($base_directory . $ds . $test_file)) ||
(!is_dir($base_directory))
)
{
// The test file wasn't detected. Use the configured output directory.
$registry = Factory::getConfiguration();
$base_directory = $registry->get('akeeba.basic.output_directory');
}
foreach ($filenames as $filename)
{
// Turn relative path to absolute
$filename = $base_directory . $ds . $filename;
// Return the new filename IF IT EXISTS!
if (!@file_exists($filename))
{
$filename = '';
}
// Do not return filename for invalid backups
if (!empty($filename))
{
$ret[] = $filename;
}
}
// Edge case: still running backups, we have to brute force the scan
// of existing files (multipart may be lying)
if ($stat['status'] == 'run')
{
$base_filename = $stat['archivename'];
$dotpos = strrpos($base_filename, '.');
$extension = substr($base_filename, $dotpos);
$basefile = substr($base_filename, 0, $dotpos);
$registry = Factory::getConfiguration();
$dirs = [
@dirname($stat['absolute_path']),
$registry->get('akeeba.basic.output_directory'),
];
// Look for base file
foreach ($dirs as $dir)
{
if (@file_exists($dir . $ds . $base_filename))
{
$ret[] = $dir . $ds . $base_filename;
break;
}
}
// Look for added files
$found = true;
$i = 0;
while ($found)
{
$i++;
$found = false;
$part_file_name = $basefile . substr($extension, 0, 2) . sprintf('%02d', $i);
foreach ($dirs as $dir)
{
if (@file_exists($dir . $ds . $part_file_name))
{
$ret[] = $dir . $ds . $part_file_name;
$found = true;
break;
}
}
}
}
if ((count($ret) == 0) && $skipNonComplete)
{
$ret = null;
}
if (!empty($ret) && is_array($ret))
{
$ret = array_unique($ret);
}
return $ret;
}
/**
* Releases the initial multipart lock
*/
public function release_multipart_lock()
{
$this->multipart_lock = false;
}
/**
* Updates the multipart status of the current backup attempt's statistics record
*
* @param int $multipart The new multipart status
*/
public function updateMultipart($multipart)
{
if ($this->multipart_lock)
{
return;
}
Factory::getLog()->debug('Updating multipart status to ' . $multipart);
// Cache this change and commit to db only after the backup is done, or failed
$registry = Factory::getConfiguration();
$registry->set('volatile.statistics.multipart', $multipart);
}
/**
* Sets or updates the statistics record of the current backup attempt
*
* @param array $data
*
* @return bool
* @throws Exception
*/
public function setStatistics($data)
{
$ret = Platform::getInstance()->set_or_update_statistics($this->statistics_id, $data);
if ($ret === false)
{
return false;
}
if (!is_null($ret))
{
$this->statistics_id = $ret;
}
$this->cached_data = array_merge($this->cached_data, $data);
return true;
}
/**
* Returns the statistics record ID (used in DB backup classes)
* @return int
*/
public function getId()
{
return $this->statistics_id;
}
/**
* Returns a copy of the cached data
* @return array
*/
public function getRecord()
{
return $this->cached_data;
}
/**
* Updates the "in step" flag of the current backup record.
*
* @param false $inStep Am I currently executing a backup step? False if just finished.
*
* @return bool
*/
public function updateInStep($inStep = false)
{
if (!$this->getId())
{
return false;
}
$data = $this->getRecord();
/**
* We will only update the instep of running backups for two reasons:
*
* 1. The very last Kettenrad entry is after the backup process is complete. The record is marked 'complete'. I
* must not touch it in this case.
*
* 2. When a record is marked 'fail' its instep is also set to 0. This happens in Factory::resetState().
*/
//
if ($data['status'] == 'complete')
{
return true;
}
$data['instep'] = $inStep ? 1 : 0;
$data['backupend'] = Platform::getInstance()->get_timestamp_database();
try
{
return $this->setStatistics($data);
}
catch (Exception $e)
{
return false;
}
}
}
PK \m%
tf tf 5 vendor/akeeba/engine/engine/Util/EngineParameters.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use DirectoryIterator;
use LogicException;
/**
* Unified engine parameters helper class. Deals with scripting, GUI configuration elements and information on engine
* parts (filters, dump engines, scan engines, archivers, installers).
*/
class EngineParameters
{
/**
* Holds the parsed scripting.json contents
*
* @var array
*/
public $scripting = null;
/**
* The currently active scripting type
*
* @var string
*/
protected $activeType = null;
/**
* Holds the known paths holding JSON definitions of engines, installers and configuration gui elements
*
* @var array
*/
protected $enginePartPaths = [];
/**
* Cache of the engines known to this object
*
* @var array
*/
protected $engine_list = [];
/**
* Cache of the GUI configuration elements known to this object
*
* @var array
*/
protected $gui_list = [];
/**
* Cache of the installers known to this object
*
* @var array
*/
protected $installer_list = [];
/**
* Append a path to the end of the paths list for a specific section
*
* @param string $path Absolute filesystem path to add
* @param string $section The section to add it to (gui, engine, installer, filters)
*
* @return void
*/
public function addPath(string $path, string $section = 'gui')
{
$path = Factory::getFilesystemTools()->TranslateWinPath($path);
// If the array is empty, populate with the defaults
if (!array_key_exists($section, $this->enginePartPaths))
{
$this->getEnginePartPaths($section);
}
// If the path doesn't already exist, add it
if (!in_array($path, $this->enginePartPaths[$section]))
{
$this->enginePartPaths[$section][] = $path;
}
}
/**
* Returns an array with domain keys and domain class names for the current
* backup type. The idea is that shifting this array walks through the backup
* process. When the array is empty, the backup is done.
*
* Each element of the array is an array with two keys: domain and class.
*
* @return array
*/
public function getDomainChain(): array
{
$configuration = Factory::getConfiguration();
$script = $configuration->get('akeeba.basic.backup_type', 'full');
$scripting = $this->loadScripting();
$domains = $scripting['domains'];
$keys = $scripting['scripts'][$script]['chain'];
$result = [];
foreach ($keys as $domain_key)
{
$result[] = [
'domain' => $domains[$domain_key]['domain'],
'class' => $domains[$domain_key]['class'],
];
}
return $result;
}
/**
* Get the paths for a specific section
*
* @param string $section The section to get the path list for (engine, installer, gui, filter)
*
* @return array
*/
public function getEnginePartPaths(string $section = 'gui')
{
// Create the key if it's not already present
if (!array_key_exists($section, $this->enginePartPaths))
{
$this->enginePartPaths[$section] = [];
}
if (!empty($this->enginePartPaths[$section]))
{
return $this->enginePartPaths[$section];
}
// Add the defaults if the list is empty
switch ($section)
{
case 'engine':
$this->enginePartPaths[$section] = [
Factory::getFilesystemTools()->TranslateWinPath(Factory::getAkeebaRoot()),
];
break;
case 'installer':
$this->enginePartPaths[$section] = [
Factory::getFilesystemTools()->TranslateWinPath(Platform::getInstance()->get_installer_images_path()),
];
break;
case 'gui':
// Add core GUI definitions
$this->enginePartPaths[$section] = [
Factory::getFilesystemTools()->TranslateWinPath(Factory::getAkeebaRoot() . '/Core'),
];
// Add platform GUI definition files
$platform_paths = Platform::getInstance()->getPlatformDirectories();
foreach ($platform_paths as $p)
{
$this->enginePartPaths[$section][] = Factory::getFilesystemTools()->TranslateWinPath($p . '/Config');
$pro = defined('AKEEBA_PRO') && AKEEBA_PRO;
$pro = defined('AKEEBABACKUP_PRO') ? (AKEEBABACKUP_PRO ? true : false) : $pro;
if ($pro)
{
$this->enginePartPaths[$section][] = Factory::getFilesystemTools()->TranslateWinPath($p . '/Config/Pro');
}
}
break;
case 'filter':
$this->enginePartPaths[$section] = [
Factory::getFilesystemTools()->TranslateWinPath(Factory::getAkeebaRoot() . '/Platform/Filter/Stack'),
Factory::getFilesystemTools()->TranslateWinPath(Factory::getAkeebaRoot() . '/Filter/Stack'),
];
$platform_paths = Platform::getInstance()->getPlatformDirectories();
foreach ($platform_paths as $p)
{
$this->enginePartPaths[$section][] = Factory::getFilesystemTools()->TranslateWinPath($p . '/Filter/Stack');
}
break;
default:
throw new LogicException(sprintf('Can not get paths for engine section ‘%s’. No section by this name is known to Akeeba Engine.', $section));
}
return $this->enginePartPaths[$section];
}
/**
* Returns a hash list of Akeeba engines and their data. Each entry has the engine name as key and contains two
* arrays, under the 'information' and 'parameters' keys.
*
* @param string $engine_type The engine type to return information for
*
* @return array
*/
public function getEnginesList(string $engine_type): array
{
$engine_type = ucfirst($engine_type);
// Try to serve cached data first
if (isset($this->engine_list[$engine_type]))
{
return $this->engine_list[$engine_type];
}
// Find absolute path to normal and plugins directories
$temp = $this->getEnginePartPaths('engine');
$path_list = [];
foreach ($temp as $path)
{
$path_list[] = $path . '/' . $engine_type;
}
// Initialize the array where we store our data
$this->engine_list[$engine_type] = [];
// Loop for the paths where engines can be found
foreach ($path_list as $path)
{
if (!@is_dir($path))
{
continue;
}
if (!@is_readable($path))
{
continue;
}
$di = new DirectoryIterator($path);
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if (!$file->isFile())
{
continue;
}
if ($file->getExtension() !== 'json')
{
continue;
}
$bare_name = ucfirst($file->getBasename('.json'));
// Some hosts copy .json and .php files, renaming them (ie foobar.1.php)
// We need to exclude them, otherwise we'll get a fatal error for declaring the same class twice
if (preg_match('/[^A-Za-z0-9]/', $bare_name))
{
continue;
}
$information = [];
$parameters = [];
$this->parseEngineJSON($file->getRealPath(), $information, $parameters);
$this->engine_list[$engine_type][lcfirst($bare_name)] = [
'information' => $information,
'parameters' => $parameters,
];
}
}
return $this->engine_list[$engine_type];
}
/**
* Parses the GUI JSON files and returns an array of groups and their data
*
* @return array
*/
public function getGUIGroups(): array
{
// Try to serve cached data first
if (!empty($this->gui_list) && is_array($this->gui_list))
{
if (count($this->gui_list) > 0)
{
return $this->gui_list;
}
}
// Find absolute path to normal and plugins directories
$path_list = $this->getEnginePartPaths('gui');
// Initialize the array where we store our data
$this->gui_list = [];
// Loop for the paths where engines can be found
foreach ($path_list as $path)
{
if (!@is_dir($path))
{
continue;
}
if (!@is_readable($path))
{
continue;
}
$allJSONFiles = [];
$di = new DirectoryIterator($path);
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if (!$file->isFile())
{
continue;
}
// PHP 5.3.5 and earlier do not support getExtension
if ($file->getExtension() !== 'json')
{
continue;
}
$allJSONFiles[] = $file->getRealPath();
}
if (empty($allJSONFiles))
{
continue;
}
// Sort GUI files alphabetically
asort($allJSONFiles);
// Include each GUI def file
foreach ($allJSONFiles as $filename)
{
$information = [];
$parameters = [];
$this->parseInterfaceJSON($filename, $information, $parameters);
// This effectively skips non-GUI JSONs (e.g. the scripting JSON)
if (!empty($information['description']))
{
if (!isset($information['merge']))
{
$information['merge'] = 0;
}
$group_name = substr(basename($filename), 0, -5);
$def = [
'information' => $information,
'parameters' => $parameters,
];
if (!$information['merge'] || !isset($this->gui_list[$group_name]))
{
$this->gui_list[$group_name] = $def;
}
else
{
$this->gui_list[$group_name]['information'] = array_merge($this->gui_list[$group_name]['information'], $def['information']);
$this->gui_list[$group_name]['parameters'] = array_merge($this->gui_list[$group_name]['parameters'], $def['parameters']);
}
}
}
}
ksort($this->gui_list);
// Push stack filter settings to the 03.filters section
$path_list = $this->getEnginePartPaths('filter');
// Loop for the paths where optional filters can be found
foreach ($path_list as $path)
{
if (!@is_dir($path))
{
continue;
}
if (!@is_readable($path))
{
continue;
}
// Store JSON names in temp array because we'll sort based on filename (GUI order IS IMPORTANT!!)
$allJSONFiles = [];
$di = new DirectoryIterator($path);
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if (!$file->isFile())
{
continue;
}
// PHP 5.3.5 and earlier do not support getExtension
if ($file->getExtension() !== 'json')
{
continue;
}
$allJSONFiles[] = $file->getRealPath();
}
if (empty($allJSONFiles))
{
continue;
}
// Sort filter files alphabetically
asort($allJSONFiles);
// Include each filter def file
foreach ($allJSONFiles as $filename)
{
$information = [];
$parameters = [];
$this->parseInterfaceJSON($filename, $information, $parameters);
if (!array_key_exists('03.filters', $this->gui_list))
{
$this->gui_list['03.filters'] = ['parameters' => []];
}
if (!array_key_exists('parameters', $this->gui_list['03.filters']))
{
$this->gui_list['03.filters']['parameters'] = [];
}
if (!is_array($parameters))
{
$parameters = [];
}
$this->gui_list['03.filters']['parameters'] = array_merge($this->gui_list['03.filters']['parameters'], $parameters);
}
}
/**
* Parse showon attributes
*
* The GUI list array format is like this:
* ```
* [
* '01.sectionName' => [
* 'information' => [...],
* 'parameters' => [
* 'some.parameter.name' => [
* 'title' => 'something',
* ...
* 'showon' => 'some.other.parameter.name:1'
* ],
* ...
* ]
* ],
* ...
* ]
* ```
*
* We need to convert the shown of the parameters to JSON data which can be used by the `showon` JavaScript
* code. The assumption only made here is that all parameter keys are turned into `INPUT` elements with an
* attribute `name="var[some.parameter.name]"`. This is how the GUI code in all backup applications our company
* makes works.
*
* For backup applications which do not have showon support (they lack the JavaScript code) this does not matter
* and neither does it break anything. All parameters are shown all the time like we have been doing for years.
*/
$this->gui_list = array_map(
function (array $section): array {
foreach ($section['parameters'] as $paramName => &$paramDef)
{
if (isset($paramDef['showon']))
{
// Parse showon
$paramDef['showon'] = $this->parseShowOnConditions($paramDef['showon']);
}
}
return $section;
},
$this->gui_list
);
return $this->gui_list;
}
/**
* Parses the installer JSON files and returns an array of installers and their data
*
* @param boolean $forDisplay If true only returns the information relevant for displaying the GUI
*
* @return array
*/
public function getInstallerList(bool $forDisplay = false): array
{
// Try to serve cached data first
if (!empty($this->installer_list) && is_array($this->installer_list))
{
if (count($this->installer_list) > 0)
{
return $this->installer_list;
}
}
// Find absolute path to normal and plugins directories
$path_list = [
Platform::getInstance()->get_installer_images_path(),
];
// Initialize the array where we store our data
$this->installer_list = [];
// Loop for the paths where engines can be found
foreach ($path_list as $path)
{
if (!@is_dir($path))
{
continue;
}
if (!@is_readable($path))
{
continue;
}
$di = new DirectoryIterator($path);
/** @var DirectoryIterator $file */
foreach ($di as $file)
{
if (!$file->isFile())
{
continue;
}
// PHP 5.3.5 and earlier do not support getExtension
if ($file->getExtension() !== 'json')
{
continue;
}
$rawData = file_get_contents($file->getRealPath());
$data = empty($rawData) ? [] : json_decode($rawData, true);
if ($forDisplay)
{
$innerData = reset($data);
if (array_key_exists('listinoptions', $innerData))
{
if ($innerData['listinoptions'] == 0)
{
continue;
}
}
}
foreach ($data as $key => $values)
{
$this->installer_list[$key] = [];
foreach ($values as $key2 => $value)
{
$this->installer_list[$key][$key2] = $value;
}
}
}
}
return $this->installer_list;
}
/**
* Returns the JSON representation of the GUI definition and the associated values
*
* @return string
*/
public function getJsonGuiDefinition(): string
{
// Initialize the array which will be converted to JSON representation
$json_array = [
'engines' => [],
'installers' => [],
'gui' => [],
];
// Get a reference to the configuration
$configuration = Factory::getConfiguration();
// Get data for all engines
$engine_types = [
'archiver',
'dump',
'scan',
'writer',
'postproc',
];
foreach ($engine_types as $type)
{
$engines = $this->getEnginesList($type);
$tempArray = [];
$engineTitles = [];
foreach ($engines as $engine_name => $engine_data)
{
// Translate information
foreach ($engine_data['information'] as $key => $value)
{
switch ($key)
{
case 'title':
case 'content':
case 'description':
$value = Platform::getInstance()->translate($value);
break;
}
$tempArray[$engine_name]['information'][$key] = $value;
if ($key == 'title')
{
$engineTitles[$engine_name] = $value;
}
}
// Process parameters
$parameters = [];
foreach ($engine_data['parameters'] as $param_key => $param)
{
$param['default'] = $configuration->get($param_key, $param['default'], false);
foreach ($param as $option_key => $option_value)
{
// Translate title, description, enumkeys
switch ($option_key)
{
case 'title':
case 'description':
case 'content':
case 'labelempty':
case 'labelnotempty':
$param[$option_key] = Platform::getInstance()->translate($option_value);
break;
case 'enumkeys':
$enumkeys = explode('|', $option_value);
$new_keys = [];
foreach ($enumkeys as $old_key)
{
$new_keys[] = Platform::getInstance()->translate($old_key);
}
$param[$option_key] = implode('|', $new_keys);
break;
case 'showon':
$param[$option_key] = $this->parseShowOnConditions($param[$option_key]);
default:
}
}
$parameters[$param_key] = $param;
}
// Add processed parameters
$tempArray[$engine_name]['parameters'] = $parameters;
}
asort($engineTitles);
foreach ($engineTitles as $engineName => $title)
{
$json_array['engines'][$type][$engineName] = $tempArray[$engineName];
}
}
// Get data for GUI elements
$json_array['gui'] = [];
$groupdefs = $this->getGUIGroups();
foreach ($groupdefs as $groupKey => $definition)
{
$group_name = '';
if (isset($definition['information']) && isset($definition['information']['description']))
{
$group_name = Platform::getInstance()->translate($definition['information']['description']);
}
// Skip no-name groups
if (empty($group_name))
{
continue;
}
$parameters = [];
foreach ($definition['parameters'] as $param_key => $param)
{
$param['default'] = $configuration->get($param_key, $param['default'], false);
foreach ($param as $option_key => $option_value)
{
// Translate title, description, enumkeys
switch ($option_key)
{
case 'title':
case 'description':
case 'content':
$param[$option_key] = Platform::getInstance()->translate($option_value);
break;
case 'enumkeys':
$enumkeys = explode('|', $option_value);
$new_keys = [];
foreach ($enumkeys as $old_key)
{
$new_keys[] = Platform::getInstance()->translate($old_key);
}
$param[$option_key] = implode('|', $new_keys);
break;
default:
}
}
$parameters[$param_key] = $param;
}
$json_array['gui'][$group_name] = $parameters;
}
// Get data for the installers
$json_array['installers'] = $this->getInstallerList(true);
uasort($json_array['installers'], function ($a, $b) {
if ($a['name'] == $b['name'])
{
return 0;
}
return ($a['name'] < $b['name']) ? -1 : 1;
});
$json = json_encode($json_array);
return $json;
}
/**
* Returns a volatile scripting parameter for the active backup type
*
* @param string $key The relative key, e.g. core.createarchive
* @param mixed $default Default value
*
* @return mixed The scripting parameter's value
*/
public function getScriptingParameter(string $key, $default = null)
{
$configuration = Factory::getConfiguration();
if (is_null($this->activeType))
{
$this->activeType = $configuration->get('akeeba.basic.backup_type', 'full');
}
return $configuration->get('volatile.scripting.' . $this->activeType . '.' . $key, $default);
}
/**
* Imports the volatile scripting parameters to the registry
*
* @return void
*/
public function importScriptingToRegistry(): void
{
$scripting = $this->loadScripting();
$configuration = Factory::getConfiguration();
$configuration->mergeArray($scripting['data'], false);
}
/**
* Loads the scripting.json and returns an array with the domains, the scripts and the raw data
*
* @return array The parsed scripting.json. Array keys: domains, scripts, data
*/
public function loadScripting(?string $jsonPath = ''): ?array
{
if (!empty($this->scripting))
{
return $this->scripting;
}
$this->scripting = [];
$jsonPath = $jsonPath ?: Factory::getAkeebaRoot() . '/Core/scripting.json';
if (!@file_exists($jsonPath))
{
return $this->scripting;
}
$rawData = file_get_contents($jsonPath);
$rawScriptingData = empty($rawData) ? [] : json_decode($rawData, true);
$domain_keys = explode('|', $rawScriptingData['volatile.akeebaengine.domains']);
$domains = [];
foreach ($domain_keys as $key)
{
$record = [
'domain' => $rawScriptingData['volatile.domain.' . $key . '.domain'],
'class' => $rawScriptingData['volatile.domain.' . $key . '.class'],
'text' => $rawScriptingData['volatile.domain.' . $key . '.text'],
];
$domains[$key] = $record;
}
$script_keys = explode('|', $rawScriptingData['volatile.akeebaengine.scripts']);
$scripts = [];
foreach ($script_keys as $key)
{
$record = [
'chain' => explode('|', $rawScriptingData['volatile.scripting.' . $key . '.chain']),
'text' => $rawScriptingData['volatile.scripting.' . $key . '.text'],
];
$scripts[$key] = $record;
}
$this->scripting = [
'domains' => $domains,
'scripts' => $scripts,
'data' => $rawScriptingData,
];
return $this->scripting;
}
/**
* Parses an engine JSON file returning two arrays, one with the general information
* of that engine and one with its configuration variables' definitions
*
* @param string $jsonPath Absolute path to engine JSON file
* @param array $information [out] The engine information hash array
* @param array $parameters [out] The parameters hash array
*
* @return bool True if the file was loaded
*/
public function parseEngineJSON(string $jsonPath, array &$information, array &$parameters): bool
{
if (!file_exists($jsonPath))
{
return false;
}
$information = [
'title' => '',
'description' => '',
];
$parameters = [];
$rawData = file_get_contents($jsonPath);
$jsonData = empty($rawData) ? [] : json_decode($rawData, true);
foreach ($jsonData ?? [] as $section => $data)
{
if (is_array($data))
{
if ($section == '_information')
{
// Parse information
foreach ($data as $key => $value)
{
$information[$key] = $value;
}
}
elseif (substr($section, 0, 1) != '_')
{
// Parse parameters
$newparam = [
'title' => '',
'description' => '',
'type' => 'string',
'default' => '',
];
foreach ($data as $key => $value)
{
$newparam[$key] = $value;
}
$parameters[$section] = $newparam;
}
}
}
return true;
}
/**
* Parses a graphical interface JSON file returning two arrays, one with the general
* information of that configuration section and one with its configuration variables'
* definitions.
*
* @param string $jsonPath Absolute path to engine JSON file
* @param array $information [out] The GUI information hash array
* @param array $parameters [out] The parameters hash array
*
* @return bool True if the file was loaded
*/
public function parseInterfaceJSON(string $jsonPath, array &$information, array &$parameters): bool
{
if (!file_exists($jsonPath))
{
return false;
}
$information = [
'description' => '',
];
$parameters = [];
$rawData = file_get_contents($jsonPath);
$jsonData = empty($rawData) ? [] : json_decode($rawData, true);
foreach ($jsonData as $section => $data)
{
if (is_array($data))
{
if ($section == '_group')
{
// Parse information
foreach ($data as $key => $value)
{
$information[$key] = $value;
}
continue;
}
if (substr($section, 0, 1) != '_')
{
// Parse parameters
$newparam = [
'title' => '',
'description' => '',
'type' => 'string',
'default' => '',
'protected' => 0,
];
foreach ($data as $key => $value)
{
$newparam[$key] = $value;
}
$parameters[$section] = $newparam;
}
}
}
return true;
}
/**
* Add a path to the beginning of the paths list for a specific section
*
* @param string $path Absolute filesystem path to add
* @param string $section The section to add it to (gui, engine, installer, filters)
*
* @return void
*/
public function prependPath(string $path, string $section = 'gui'): void
{
$path = Factory::getFilesystemTools()->TranslateWinPath($path);
// If the array is empty, populate with the defaults
if (!array_key_exists($section, $this->enginePartPaths))
{
$this->getEnginePartPaths($section);
}
// If the path doesn't already exist, add it
if (!in_array($path, $this->enginePartPaths[$section]))
{
array_unshift($this->enginePartPaths[$section], $path);
}
}
/**
* Parse the `showon` conditions text into an instructions array for the ShowOn JavaScript
*
* @param string|null $showOn The `showon` conditions text
* @param string|null $arrayName The array all of our parameters are members of, default 'var'.
*
* @return array The ShowOn JavaScript instructions
*
* @since 9.3.1
*/
private function parseShowOnConditions(?string $showOn, ?string $arrayName = 'var'): array
{
if (empty($showOn))
{
return [];
}
$showOnData = [];
$showOnParts = preg_split('#(\[AND\]|\[OR\])#', $showOn, -1, PREG_SPLIT_DELIM_CAPTURE);
$op = '';
foreach ($showOnParts as $showOnPart)
{
if (in_array($showOnPart, ['[AND]', '[OR]']))
{
$op = trim($showOnPart, '[]');
continue;
}
$compareEqual = strpos($showOnPart, '!:') === false;
$showOnPartBlocks = explode(($compareEqual ? ':' : '!:'), $showOnPart, 2);
$field = $arrayName
? sprintf("%s[%s]", $arrayName, $showOnPartBlocks[0])
: $showOnPartBlocks[0];
$showOnData[] = [
'field' => $field,
'values' => explode(',', $showOnPartBlocks[1]),
'sign' => $compareEqual === true ? '=' : '!=',
'op' => $op,
];
$op = '';
}
return $showOnData;
}
}
PK \m? ? 7 vendor/akeeba/engine/engine/Util/ConfigurationCheck.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
/**
* Quirk detection helper class
*/
class ConfigurationCheck
{
/**
* The configuration checks to perform
*
* @var array
*/
protected $configurationChecks = [
['code' => '001', 'severity' => 'critical', 'callback' => [null, 'q001'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q001',
],
['code' => '003', 'severity' => 'critical', 'callback' => [null, 'q003'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q003',
],
['code' => '004', 'severity' => 'critical', 'callback' => [null, 'q004'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q004',
],
['code' => '101', 'severity' => 'high', 'callback' => [null, 'q101'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q101',
],
['code' => '103', 'severity' => 'high', 'callback' => [null, 'q103'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q103',
],
['code' => '104', 'severity' => 'high', 'callback' => [null, 'q104'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q104',
],
['code' => '106', 'severity' => 'high', 'callback' => [null, 'q106'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q106',
],
['code' => '107', 'severity' => 'high', 'callback' => [null, 'q107'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q107',
],
['code' => '201', 'severity' => 'medium', 'callback' => [null, 'q201'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q201',
],
['code' => '202', 'severity' => 'medium', 'callback' => [null, 'q202'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q202',
],
['code' => '204', 'severity' => 'medium', 'callback' => [null, 'q204'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q204',
],
['code' => '203', 'severity' => 'medium', 'callback' => [null, 'q203'],
'description' => 'COM_AKEEBA_CPANEL_WARNING_Q203',
],
// ['code' => '401', 'severity' => 'low', 'callback' => [null, 'q401'],
// 'description' => 'COM_AKEEBA_CPANEL_WARNING_Q401',
// ],
];
/**
* The public constructor replaces the missing object reference in the configuration check callbacks
*/
function __construct()
{
$temp = [];
foreach ($this->configurationChecks as $check)
{
$check['callback'] = [$this, $check['callback'][1]];
$temp[] = $check;
}
$this->configurationChecks = $temp;
}
/**
* Returns the output & temporary folder writable status
*
* @return array A hash array with the writable status
*/
public function getFolderStatus()
{
static $status = null;
if (is_null($status))
{
$stock_dirs = Platform::getInstance()->get_stock_directories();
// Get output writable status
$registry = Factory::getConfiguration();
$outdir = $registry->get('akeeba.basic.output_directory');
foreach ($stock_dirs as $macro => $replacement)
{
$outdir = str_replace($macro, $replacement, $outdir);
}
$status['output'] = @is_writable($outdir);
}
return $status;
}
/**
* Returns the overall status. It's true when both the temporary and output directories are writable and there are
* no critical configuration check failures.
*
* @return boolean
*/
public function getShortStatus()
{
// Base the status on directory writeable status
$status = $this->getFolderStatus();
$ret = $status['output'];
// Scan for high severity configuration check errors
$detailedStatus = $this->getDetailedStatus();
if (!empty($detailedStatus))
{
foreach ($detailedStatus as $configCheck)
{
if ($configCheck['severity'] == 'critical')
{
$ret = false;
}
}
}
// Return status
return $ret;
}
/**
* Add a configuration check definition
*
* @param string $code The configuration check code (three digit number)
* @param string $severity The severity (low, medium, high, critical)
* @param string $description The description key for this configuration check
* @param null $callback The callback used to determine the status of the configuration check
*
* @return void
*/
public function addConfigurationCheckDefinition($code, $severity = 'low', $description = null, $callback = null)
{
if (!is_callable($callback))
{
$callback = [$this, 'q' . $code];
}
if (empty($description))
{
$description = 'COM_AKEEBA_CPANEL_WARNING_Q' . $code;
}
$newConfigurationCheck = [
'code' => $code,
'severity' => $severity,
'description' => $description,
'callback' => $callback,
];
$this->configurationChecks[$code] = $newConfigurationCheck;
}
/**
* Remove a configuration check definition
*
* @param string $code The code of the configuration check to remove
*
* @return void
*/
public function removeConfigurationCheckDefinition($code)
{
if (isset($this->configurationChecks[$code]))
{
unset($this->configurationChecks[$code]);
}
}
/**
* Clear the configuration check definitions
*
* @return void
*/
public function clearConfigurationCheckDefinitions()
{
$this->configurationChecks = [];
}
/**
* Runs the configuration check scripts. These are potential problems related to server
* configuration, out of Akeeba's control. They are intended to give the user a
* chance to fix them before they cause the backup to fail.
*
* Numbering scheme:
* Q0xx No-go errors
* Q1xx Critical system configuration errors
* Q2xx Medium and low system configuration warnings
* Q3xx Critical software configuration errors
* Q4xx Medium and low component configuration warnings
*
* @param boolean $low_priority Should I include low priority quirks?
* @param string $help_url_template The sprintf template from creating a help URL from a config check code
*
* @return array
*/
public function getDetailedStatus($low_priority = false, $help_url_template = 'https://www.akeeba.com/documentation/warnings/q%s.html')
{
static $detailedStatus = null;
if (is_null($detailedStatus) || $low_priority)
{
$detailedStatus = [];
foreach ($this->configurationChecks as $quirkDef)
{
if (!$low_priority && ($quirkDef['severity'] == 'low'))
{
continue;
}
$this->checkConfiguration($detailedStatus, $quirkDef, $help_url_template);
}
}
return $detailedStatus;
}
/**
* Checks if a path is restricted by open_basedirs
*
* @param string $check The path to check
*
* @return bool True if the path is restricted (which is bad)
*/
public function checkOpenBasedirs($check)
{
static $paths;
if (empty($paths))
{
$open_basedir = ini_get('open_basedir');
if (empty($open_basedir))
{
return false;
}
$delimiter = strpos($open_basedir, ';') !== false ? ';' : ':';
$paths_temp = explode($delimiter, $open_basedir);
// Some open_basedirs are using environment variables
$paths = [];
foreach ($paths_temp as $path)
{
if (array_key_exists($path, $_ENV))
{
$paths[] = $_ENV[$path];
}
else
{
$paths[] = $path;
}
}
}
if (empty($paths))
{
return false; // no restrictions
}
else
{
$newcheck = @realpath($check); // Resolve symlinks, like PHP does
if (!($newcheck === false))
{
$check = $newcheck;
}
$included = false;
foreach ($paths as $path)
{
/**
* This catches the empty path caused by open_basedir values with a trailing colon.
*
* For example, `/var/www:/tmp:` is THREE directories: /var/www, /tmp, and an empty directory. Yes, it
* is invalid. Yes, people are stupid.
*/
if (empty($path))
{
continue;
}
/**
* The try-catch here will catch any other kind of invalid path. For example, we may get a $path with
* NULL bytes, or pointing to an invalid / inaccessible location which doesn't just return FALSE but
* causes realpath() to throw.
*
* For our purposes, we want to skip any invalid paths and continue checking the rest.
*/
try
{
$newpath = @realpath($path);
}
catch (\Throwable $e)
{
continue;
}
if (!($newpath === false))
{
$path = $newpath;
}
if (strlen($check) >= strlen($path))
{
/**
* Only check if the path to check is longer than the inclusion path. Shorter paths are, by
* definition, not included (e.g. a 10-character path cannot be under a 15-character parent path).
* If the path to check begins with an inclusion path we consider it permitted
*/
if (substr($check, 0, strlen($path)) == $path)
{
$included = true;
}
}
}
return !$included;
}
}
/**
* Make a configuration check and adds it to the list if it raises a warning / error
*
* @param array $detailedStatus The configuration checks status array
* @param array $quirkDef The configuration check definition
* @param string $help_url_template The sprintf template from creating a help URL from a quirk code
*
* @return void
*/
protected function checkConfiguration(&$detailedStatus, $quirkDef, $help_url_template)
{
if (call_user_func($quirkDef['callback']))
{
$description = Platform::getInstance()->translate($quirkDef['description']);
$detailedStatus[(string) $quirkDef['code']] = [
'code' => $quirkDef['code'],
'severity' => $quirkDef['severity'],
'description' => $description,
'help_url' => sprintf($help_url_template, $quirkDef['code']),
];
}
}
/**
* Q001 - HIGH - Output directory unwriteable
*
* @return bool
*/
private function q001()
{
$status = $this->getFolderStatus();
return !$status['output'];
}
/**
* Q003 - HIGH - Backup output or temporary set to site's root
*
* @return bool
*/
private function q003()
{
$stock_dirs = Platform::getInstance()->get_stock_directories();
$registry = Factory::getConfiguration();
$outdir = $registry->get('akeeba.basic.output_directory');
foreach ($stock_dirs as $macro => $replacement)
{
$outdir = str_replace($macro, $replacement, $outdir);
}
$outdir_real = @realpath($outdir);
if (!empty($outdir_real))
{
$outdir = $outdir_real;
}
$siteroot = Platform::getInstance()->get_site_root();
$siteroot_real = @realpath($siteroot);
if (!empty($siteroot_real))
{
$siteroot = $siteroot_real;
}
return ($siteroot == $outdir);
}
/**
* Q004 - HIGH - Free memory too low
*
* @return bool
*/
private function q004()
{
// If we can't figure this out, don't report a problem. It doesn't
// really matter, as the backup WILL crash eventually.
if (!function_exists('ini_get'))
{
return false;
}
$memLimit = ini_get("memory_limit");
$memLimit = $this->_return_bytes($memLimit);
if ($memLimit <= 0)
{
return false;
}
// No limit?
$availableRAM = $memLimit - memory_get_usage();
// We need at least 12Mb of free memory
return ($availableRAM <= (12 * 1024 * 1024));
}
/**
* Q101 - HIGH - open_basedir on output directory
*
* @return bool
*/
private function q101()
{
$stock_dirs = Platform::getInstance()->get_stock_directories();
// Get output writable status
$registry = Factory::getConfiguration();
$outdir = $registry->get('akeeba.basic.output_directory');
foreach ($stock_dirs as $macro => $replacement)
{
$outdir = str_replace($macro, $replacement, $outdir);
}
return $this->checkOpenBasedirs($outdir);
}
/**
* Q103 - HIGH - Less than 10" of max_execution_time with PHP Safe Mode enabled
*
* @return bool
*/
private function q103()
{
$exectime = ini_get('max_execution_time');
$safemode = ini_get('safe_mode');
if (!$safemode)
{
return false;
}
if (!is_numeric($exectime))
{
return false;
}
if ($exectime <= 0)
{
return false;
}
return $exectime < 10;
}
/**
* Q104 - HIGH - Temp directory is the same as the site's root
*
* @return bool
*/
private function q104()
{
$siteroot = Platform::getInstance()->get_site_root();
$siteroot_real = @realpath($siteroot);
if (!empty($siteroot_real))
{
$siteroot = $siteroot_real;
}
$stockDirs = Platform::getInstance()->get_stock_directories();
$temp_directory = $stockDirs['[SITETMP]'];
$temp_directory = @realpath($temp_directory);
if (empty($temp_directory))
{
$temp_directory = $siteroot;
}
return ($siteroot == $temp_directory);
}
/**
* Q106 - HIGH - Table name prefix contains uppercase characters
*
* @return bool
*/
private function q106()
{
$filters = Factory::getFilters();
$databases = $filters->getInclusions('db');
foreach ($databases as $db)
{
if (!isset($db['prefix']))
{
continue;
}
if (preg_match('/[A-Z]/', $db['prefix']))
{
return true;
}
}
return false;
}
/**
* Q107 - HIGH - Using bak_ as the database table name prefix
*
* @return bool
*/
private function q107()
{
$filters = Factory::getFilters();
$databases = $filters->getInclusions('db');
foreach ($databases as $db)
{
if (!isset($db['prefix']))
{
continue;
}
if ($db['prefix'] === 'bak_')
{
return true;
}
}
return false;
}
/**
* Q201 - MEDIUM - Outdated PHP version.
*
* We currently check for PHP lower than 8.0.
*
* @return bool
*/
private function q201()
{
return version_compare(PHP_VERSION, '8.0.0', 'lt');
}
/**
* Q202 - MED - CRC problems with hash extension not present
*
* @return bool
*/
private function q202()
{
$registry = Factory::getConfiguration();
$archiver = $registry->get('akeeba.advanced.archiver_engine');
if ($archiver != 'zip')
{
return false;
}
return !function_exists('hash_file');
}
/**
* Q203 - MED - Default output directory in use
*
* @return bool
*/
private function q203()
{
$stock_dirs = Platform::getInstance()->get_stock_directories();
$registry = Factory::getConfiguration();
$outdir = $registry->get('akeeba.basic.output_directory');
foreach ($stock_dirs as $macro => $replacement)
{
$outdir = str_replace($macro, $replacement, $outdir);
}
$default = $stock_dirs['[DEFAULT_OUTPUT]'];
$outdir = Factory::getFilesystemTools()->TranslateWinPath($outdir);
$default = Factory::getFilesystemTools()->TranslateWinPath($default);
return $outdir == $default;
}
/**
* Q204 - MED - Disabled functions may affect operation
*
* @return bool
*/
private function q204()
{
$disabled = ini_get('disabled_functions');
return (!empty($disabled));
}
/**
* Q401 - LOW - ZIP format selected
*
* @return bool
*/
private function q401()
{
$registry = Factory::getConfiguration();
$archiver = $registry->get('akeeba.advanced.archiver_engine');
return $archiver == 'zip';
}
private function _return_bytes($setting)
{
$val = trim($setting);
$last = strtolower(substr($val, -1));
$val = substr($val, 0, -1);
if (is_numeric($last))
{
return $setting;
}
switch ($last)
{
case 't':
$val *= 1024;
case 'g':
$val *= 1024;
case 'm':
$val *= 1024;
case 'k':
$val *= 1024;
}
return (int) $val;
}
}
PK \ %)b b 3 vendor/akeeba/engine/engine/Util/TemporaryFiles.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
/**
* Temporary files management class. Handles creation, tracking and cleanup.
*/
class TemporaryFiles
{
/**
* Creates a randomly-named temporary file, registers it with the temporary
* files management and returns its absolute path
*
* @return string The temporary file name
*/
public function createRegisterTempFile()
{
// Create a randomly named file in the temp directory
$registry = Factory::getConfiguration();
$tempFile = tempnam($registry->get('akeeba.basic.output_directory'), 'ak');
// Register it and return its absolute path
$tempName = basename($tempFile);
return Factory::getTempFiles()->registerTempFile($tempName);
}
/**
* Registers a temporary file with the Akeeba Engine, storing the list of temporary files
* in another temporary flat database file.
*
* @param string $fileName The path of the file, relative to the temporary directory
*
* @return string The absolute path to the temporary file, for use in file operations
*/
public function registerTempFile($fileName)
{
$configuration = Factory::getConfiguration();
$tempFiles = $configuration->get('volatile.tempfiles', false);
if ($tempFiles === false)
{
$tempFiles = [];
}
else
{
$tempFiles = @unserialize($tempFiles);
if ($tempFiles === false)
{
$tempFiles = [];
}
}
if (!in_array($fileName, $tempFiles))
{
$tempFiles[] = $fileName;
$configuration->set('volatile.tempfiles', serialize($tempFiles));
}
return Factory::getFilesystemTools()->TranslateWinPath($configuration->get('akeeba.basic.output_directory') . '/' . $fileName);
}
/**
* Unregister and delete a temporary file
*
* @param string $fileName The filename to unregister and delete
* @param bool $removePrefix The prefix to remove
*
* @return bool True on success
*/
public function unregisterAndDeleteTempFile($fileName, $removePrefix = false)
{
$configuration = Factory::getConfiguration();
if ($removePrefix)
{
$fileName = str_replace(Factory::getFilesystemTools()->TranslateWinPath($configuration->get('akeeba.basic.output_directory')), '', $fileName);
if ((substr($fileName, 0, 1) == '/') || (substr($fileName, 0, 1) == '\\'))
{
$fileName = substr($fileName, 1);
}
if ((substr($fileName, -1) == '/') || (substr($fileName, -1) == '\\'))
{
$fileName = substr($fileName, 0, -1);
}
}
// Make sure this file is registered
$configuration = Factory::getConfiguration();
$serialised = $configuration->get('volatile.tempfiles', false);
$tempFiles = [];
if ($serialised !== false)
{
$tempFiles = @unserialize($serialised);
}
if (!is_array($tempFiles))
{
return false;
}
if (!in_array($fileName, $tempFiles))
{
return false;
}
$file = $configuration->get('akeeba.basic.output_directory') . '/' . $fileName;
Factory::getLog()->debug("-- Removing temporary file $fileName");
$platform = strtoupper(PHP_OS);
// Chown normally doesn't work on Windows but many years ago I found it necessary to delete temp files. No idea.
if ((substr($platform, 0, 6) == 'CYGWIN') || (substr($platform, 0, 3) == 'WIN'))
{
// On Windows we have to chown() the file first to make it owned by Nobody
Factory::getLog()->debug("-- Windows hack: chowning $fileName");
@chown($file, 600);
}
$result = @$this->nullifyAndDelete($file);
// Make sure the file is removed before unregistering it
if (!@file_exists($file))
{
$aPos = array_search($fileName, $tempFiles);
if ($aPos !== false)
{
unset($tempFiles[$aPos]);
$configuration->set('volatile.tempfiles', serialize($tempFiles));
}
}
return $result;
}
/**
* Deletes all temporary files
*
* @return void
*/
public function deleteTempFiles()
{
$configuration = Factory::getConfiguration();
$serialised = $configuration->get('volatile.tempfiles', false);
$tempFiles = [];
if ($serialised !== false)
{
$tempFiles = @unserialize($serialised);
}
if (!is_array($tempFiles))
{
$tempFiles = [];
}
$fileName = null;
if (!empty($tempFiles))
{
foreach ($tempFiles as $fileName)
{
Factory::getLog()->debug("-- Removing temporary file $fileName");
$file = $configuration->get('akeeba.basic.output_directory') . '/' . $fileName;
$platform = strtoupper(PHP_OS);
// Chown normally doesn't work on Windows but many years ago I found it necessary to delete temp files. No idea.
if ((substr($platform, 0, 6) == 'CYGWIN') || (substr($platform, 0, 3) == 'WIN'))
{
// On Windows we have to chwon() the file first to make it owned by Nobody
@chown($file, 600);
}
$ret = @$this->nullifyAndDelete($file);
}
}
$tempFiles = [];
$configuration->set('volatile.tempfiles', serialize($tempFiles));
}
/**
* Nullify the contents of the file and try to delete it as well
*
* @param string $filename The absolute path to the file to delete
*
* @return bool True of the deletion is successful
*/
public function nullifyAndDelete($filename)
{
// Try to nullify (method #1)
$fp = @fopen($filename, 'w');
if (is_resource($fp))
{
@fclose($fp);
}
else
{
// Try to nullify (method #2)
@file_put_contents($filename, '');
}
// Unlink
return @unlink($filename);
}
}
PK \|q : vendor/akeeba/engine/engine/Util/PushMessagesInterface.phpnu [ .
*/
/**
* @package Akeeba\Engine\Util
* @subpackage
*
* @copyright A copyright
* @license A "Slug" license name e.g. GPL2
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
interface PushMessagesInterface
{
/**
* Sends a push message to all connected devices. The intent is to provide the user with an information message,
* e.g. notify them about the progress of the backup.
*
* @param string $subject The subject of the message, shown in the lock screen. Keep it short.
* @param string $details Long(er) description of what the message is about. Plain text (no HTML).
*
* @return void
*/
public function message($subject, $details = null);
/**
* Sends a push message, containing a URL/URI, to all connected devices. The URL will be rendered as something
* clickable on most devices.
*
* @param string $url The URL/URI
* @param string $subject The subject of the message, shown in the lock screen. Keep it short.
* @param string $details Long(er) description of what the message is about. Plain text (no HTML).
*
* @return void
*/
public function link($url, $subject, $details = null);
}PK \>ot t - vendor/akeeba/engine/engine/Util/ParseIni.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
/**
* A utility class to parse INI files.
*
* This is marked deprecated since Akeeba Engine 6.4.1. The configuration of the engine is no longer stored as INI data.
* Moreover, we will be migrating away from the current INI files used for defining engine and GUI configuration
* parameters.
*
* @package Akeeba\Engine\Util
*
* @deprecated 6.4.1
*/
abstract class ParseIni
{
/**
* Parse an INI file and return an associative array. This monstrosity is required because some so-called hosts
* have disabled PHP's parse_ini_file() function for "security reasons". Apparently their blatant ignorance doesn't
* allow them to discern between the innocuous parse_ini_file and the potentially dangerous ini_set, leading them to
* disable the former and let the latter enabled.
*
* @param string $file The file name or raw INI data to process
* @param bool $process_sections True to also process INI sections
* @param bool $rawdata Is this raw INI data? False when $file is a filepath.
* @param bool $forcePHP Should I force the use of the pure-PHP INI file parser?
*
* @return array An associative array of sections, keys and values
*/
public static function parse_ini_file($file, $process_sections = false, $rawdata = false, $forcePHP = false)
{
/**
* WARNING: DO NOT USE INI_SCANNER_RAW IN THE parse_ini_string / parse_ini_file FUNCTION CALLS WITHOUT POST-
* PROCESSING!
*
* Sometimes we need to save data which is either multiline or has double quotes in the Engine's
* configuration. For this reason we have to manually escape \r, \n, \t and \" in
* Akeeba\Engine\Configuration::dumpObject(). If we don't we end up with multiline INI values which
* won't work. However, if we are using INI_SCANNER_RAW these characters are not escaped back to their
* original form. As a result we end up with broken data which cause various problems, the most visible
* of which is that Google Storage integration is broken since the JSON data included in the config is
* now unparseable.
*
* However, not using raw mode introduces other problems. For example, the sequence \$ is converted to $ because
* it's assumed to be an escaped dollar sign. Things like $foo are addressed as variable interpolation, i.e.
* "This is ${foo} wrong" results in "This is wrong" because $foo is considered as an interpolated variable.
*
* The solution to that is to use raw mode to parse the INI files and THEN unescape the variables. However, we
* cannot simply use stripslashes/stripcslashes because we could end up replacing more than we should (unlike
* addcslashes we cannot specify a list of escaped characters to consider). We have to do a slower string
* replace instead.
*
* The next problem to consider is that when $process_sections is true some of the values generated are arrays
* or even nested arrays. If you try to string replace on them hilarity ensues. Therefore we have the recursive
* unescape method which takes care of that. To make things faster and maintain the array keys we use array_map
* to apply recursiveUnescape to the array.
*/
if ($rawdata)
{
if (!function_exists('parse_ini_string'))
{
return self::parse_ini_file_php($file, $process_sections, $rawdata);
}
// !!! VERY IMPORTANT !!! Read the warning above before touching this line
return array_map([
__CLASS__, 'recursiveUnescape',
], parse_ini_string($file, $process_sections, INI_SCANNER_RAW));
}
if (!function_exists('parse_ini_file'))
{
return self::parse_ini_file_php($file, $process_sections);
}
// !!! VERY IMPORTANT !!! Read the warning above before touching this line
return array_map([__CLASS__, 'recursiveUnescape'], parse_ini_file($file, $process_sections, INI_SCANNER_RAW));
}
/**
* Recursively unescape values which have been escaped by Akeeba\Engine\Configuration::dumpObject().
*
* @param string|array $value
*
* @return string|array Unescaped result
*/
static function recursiveUnescape($value)
{
if (is_array($value))
{
return array_map([__CLASS__, 'recursiveUnescape'], $value);
}
return str_replace(['\r', '\n', '\t', '\"'], ["\r", "\n", "\t", '"'], $value);
}
/**
* A PHP based INI file parser.
*
* Thanks to asohn ~at~ aircanopy ~dot~ net for posting this handy function on
* the parse_ini_file page on http://gr.php.net/parse_ini_file
*
* @param string $file Filename to process
* @param bool $process_sections True to also process INI sections
* @param bool $rawdata If true, the $file contains raw INI data, not a filename
*
* @return array An associative array of sections, keys and values
*/
static function parse_ini_file_php($file, $process_sections = false, $rawdata = false)
{
$process_sections = ($process_sections !== true) ? false : true;
if (!$rawdata)
{
$ini = file($file);
}
else
{
$file = str_replace("\r", "", $file);
$ini = explode("\n", $file);
}
if (!is_array($ini))
{
return [];
}
if (count($ini) == 0)
{
return [];
}
$sections = [];
$values = [];
$result = [];
$globals = [];
$i = 0;
foreach ($ini as $line)
{
$line = trim($line);
$line = str_replace("\t", " ", $line);
// Comments
if (!preg_match('/^[a-zA-Z0-9[]/', $line))
{
continue;
}
// Sections
if ($line[0] == '[')
{
$tmp = explode(']', $line);
$sections[] = trim(substr($tmp[0], 1));
$i++;
continue;
}
// Key-value pair
$lineParts = explode('=', $line, 2);
if (count($lineParts) != 2)
{
continue;
}
$key = trim($lineParts[0]);
$value = trim($lineParts[1]);
unset($lineParts);
if (strstr($value, ";"))
{
$tmp = explode(';', $value);
if (count($tmp) == 2)
{
if ((($value[0] != '"') && ($value[0] != "'")) ||
preg_match('/^".*"\s*;/', $value) || preg_match('/^".*;[^"]*$/', $value) ||
preg_match("/^'.*'\s*;/", $value) || preg_match("/^'.*;[^']*$/", $value)
)
{
$value = $tmp[0];
}
}
else
{
if ($value[0] == '"')
{
$value = preg_replace('/^"(.*)".*/', '$1', $value);
}
elseif ($value[0] == "'")
{
$value = preg_replace("/^'(.*)'.*/", '$1', $value);
}
else
{
$value = $tmp[0];
}
}
}
$value = trim($value);
$value = trim($value, "'\"");
if ($i == 0)
{
if (substr($line, -1, 2) == '[]')
{
$globals[$key][] = $value;
}
else
{
$globals[$key] = $value;
}
}
else
{
if (substr($line, -1, 2) == '[]')
{
$values[$i - 1][$key][] = $value;
}
else
{
$values[$i - 1][$key] = $value;
}
}
}
for ($j = 0; $j < $i; $j++)
{
if ($process_sections === true)
{
if (isset($sections[$j]) && isset($values[$j]))
{
$result[$sections[$j]] = $values[$j];
}
}
else
{
if (isset($values[$j]))
{
$result[] = $values[$j];
}
}
}
return $result + $globals;
}
}
PK \ G + vendor/akeeba/engine/engine/Util/Buffer.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
/**
* Generic Buffer stream handler
*
* This class provides a generic buffer stream. It can be used to store/retrieve/manipulate
* string buffers with the standard PHP filesystem I/O methods.
*/
class Buffer
{
/**
* Stream position
*
* @var integer
*/
public $position = 0;
/**
* Buffer name
*
* @var string
*/
public $name = null;
/**
* Buffer hash
*
* @var array
*/
public $_buffers = [];
/**
* Function to open file or url
*
* @param string $path The URL that was passed
* @param string $mode Mode used to open the file @see fopen
* @param integer $options Flags used by the API, may be STREAM_USE_PATH and
* STREAM_REPORT_ERRORS
* @param string &$opened_path Full path of the resource. Used with STREAM_USE_PATH option
*
* @return boolean
*
* @see streamWrapper::stream_open
*/
public function stream_open($path, $mode, $options, &$opened_path)
{
$url = parse_url($path);
$this->name = $url["host"];
$this->_buffers[$this->name] = null;
$this->position = 0;
return true;
}
/**
* Read stream
*
* @param integer $count How many bytes of data from the current position should be returned.
*
* @return mixed The data from the stream up to the specified number of bytes (all data if
* the total number of bytes in the stream is less than $count. Null if
* the stream is empty.
*
* @see streamWrapper::stream_read
*/
public function stream_read($count)
{
$ret = substr($this->_buffers[$this->name], $this->position, $count);
$this->position += strlen($ret);
return $ret;
}
/**
* Write stream
*
* @param string $data The data to write to the stream.
*
* @return integer
*
* @see streamWrapper::stream_write
*/
public function stream_write($data)
{
$left = substr($this->_buffers[$this->name], 0, $this->position);
$right = substr($this->_buffers[$this->name], $this->position + strlen($data));
$this->_buffers[$this->name] = $left . $data . $right;
$this->position += strlen($data);
return strlen($data);
}
/**
* Function to get the current position of the stream
*
* @return integer
*
* @see streamWrapper::stream_tell
*/
public function stream_tell()
{
return $this->position;
}
/**
* Function to test for end of file pointer
*
* @return boolean True if the pointer is at the end of the stream
*
* @see streamWrapper::stream_eof
*/
public function stream_eof()
{
return $this->position >= strlen($this->_buffers[$this->name]);
}
/**
* The read write position updates in response to $offset and $whence
*
* @param integer $offset The offset in bytes
* @param integer $whence Position the offset is added to
* Options are SEEK_SET, SEEK_CUR, and SEEK_END
*
* @return boolean True if updated
*
* @see streamWrapper::stream_seek
*/
public function stream_seek($offset, $whence)
{
switch ($whence)
{
case SEEK_SET:
if ($offset < strlen($this->_buffers[$this->name]) && $offset >= 0)
{
$this->position = $offset;
return true;
}
else
{
return false;
}
break;
case SEEK_CUR:
if ($offset >= 0)
{
$this->position += $offset;
return true;
}
else
{
return false;
}
break;
case SEEK_END:
if (strlen($this->_buffers[$this->name]) + $offset >= 0)
{
$this->position = strlen($this->_buffers[$this->name]) + $offset;
return true;
}
else
{
return false;
}
break;
default:
return false;
}
}
}
// Register the stream
stream_wrapper_register("buffer", Buffer::class);
PK \]' ' . vendor/akeeba/engine/engine/Util/HashTrait.phpnu [ .
*/
namespace Akeeba\Engine\Util;
/**
* PHP 8.4+ workaround for standalone MD5 and SHA-1 functions.
*
* PHP 8.4 deprecates the standalone md5(), md5_file(), sha1(), and sha1_file() functions. This trait creates shims
* which use the hash() and hash_file() functions instead where available.
*
* IMPORTANT! PHP 7.4 made the ext/hash extension mandatory. These shims are here only as a backwards compatibility aid.
* Eventually, we need to remove them, replacing their use by the direct use of hash() and hash_file().
*
* @deprecated 10.0
*/
trait HashTrait
{
/**
* @deprecated 10.0 Use hash() instead
*/
private static function md5($string, $binary = false)
{
static $shouldUseHash = null;
if ($shouldUseHash === null)
{
$shouldUseHash = function_exists('hash')
&& function_exists('hash_algos')
&& in_array('md5', hash_algos());
}
return $shouldUseHash ? hash('md5', $string, $binary) : md5($string, $binary);
}
/**
* @deprecated 10.0 Use hash() instead
*/
private static function sha1($string, $binary = false)
{
static $shouldUseHash = null;
if ($shouldUseHash === null)
{
$shouldUseHash = function_exists('hash')
&& function_exists('hash_algos')
&& in_array('sha1', hash_algos());
}
return $shouldUseHash ? hash('sha1', $string, $binary) : sha1($string, $binary);
}
/**
* @deprecated 10.0 Use hash_file() instead
*/
private static function md5_file($filename, $binary = false)
{
static $shouldUseHash = null;
if ($shouldUseHash === null)
{
$shouldUseHash = function_exists('hash')
&& function_exists('hash_algos')
&& in_array('md5', hash_algos());
}
return $shouldUseHash ? hash_file('md5', $filename, $binary) : md5_file($filename, $binary);
}
/**
* @deprecated 10.0 Use hash_file() instead
*/
private static function sha1_file($filename, $binary = false)
{
static $shouldUseHash = null;
if ($shouldUseHash === null)
{
$shouldUseHash = function_exists('hash')
&& function_exists('hash_algos')
&& in_array('sha1', hash_algos());
}
return $shouldUseHash ? hash_file('sha1', $filename, $binary) : sha1_file($filename, $binary);
}
}PK \Mg g 7 vendor/akeeba/engine/engine/Util/AesAdapter/OpenSSL.phpnu [ .
*/
namespace Akeeba\Engine\Util\AesAdapter;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Util\RandomValue;
class OpenSSL extends AbstractAdapter implements AdapterInterface
{
/**
* The OpenSSL options for encryption / decryption
*
* @var int
*/
protected $openSSLOptions = 0;
/**
* The encryption method to use
*
* @var string
*/
protected $method = 'aes-128-cbc';
public function __construct()
{
$this->openSSLOptions = OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING;
}
public function setEncryptionMode($mode = 'cbc', $strength = 128)
{
static $availableAlgorithms = null;
static $defaultAlgo = 'aes-128-cbc';
if (!is_array($availableAlgorithms))
{
$availableAlgorithms = openssl_get_cipher_methods();
foreach ([
'aes-256-cbc', 'aes-256-ecb', 'aes-192-cbc',
'aes-192-ecb', 'aes-128-cbc', 'aes-128-ecb',
] as $algo)
{
if (in_array($algo, $availableAlgorithms))
{
$defaultAlgo = $algo;
break;
}
}
}
$strength = (int) $strength;
$mode = strtolower($mode);
if (!in_array($strength, [128, 192, 256]))
{
$strength = 256;
}
if (!in_array($mode, ['cbc', 'ebc']))
{
$mode = 'cbc';
}
$algo = 'aes-' . $strength . '-' . $mode;
if (!in_array($algo, $availableAlgorithms))
{
$algo = $defaultAlgo;
}
$this->method = $algo;
}
public function encrypt($plainText, $key, $iv = null)
{
$iv_size = $this->getBlockSize();
$key = $this->resizeKey($key, $iv_size);
$iv = $this->resizeKey($iv, $iv_size);
if (empty($iv))
{
$randVal = new RandomValue();
$iv = $randVal->generate($iv_size);
}
$plainText .= $this->getZeroPadding($plainText, $iv_size);
$cipherText = openssl_encrypt($plainText, $this->method, $key, $this->openSSLOptions, $iv);
$cipherText = $iv . $cipherText;
return $cipherText;
}
public function decrypt($cipherText, $key)
{
$iv_size = $this->getBlockSize();
$key = $this->resizeKey($key, $iv_size);
$iv = substr($cipherText, 0, $iv_size);
$cipherText = substr($cipherText, $iv_size);
$plainText = openssl_decrypt($cipherText, $this->method, $key, $this->openSSLOptions, $iv);
return $plainText;
}
public function isSupported()
{
if (!function_exists('openssl_get_cipher_methods'))
{
return false;
}
if (!function_exists('openssl_random_pseudo_bytes'))
{
return false;
}
if (!function_exists('openssl_cipher_iv_length'))
{
return false;
}
if (!function_exists('openssl_encrypt'))
{
return false;
}
if (!function_exists('openssl_decrypt'))
{
return false;
}
if (!function_exists('hash'))
{
return false;
}
if (!function_exists('hash_algos'))
{
return false;
}
$algorightms = openssl_get_cipher_methods();
if (!in_array('aes-128-cbc', $algorightms))
{
return false;
}
$algorightms = hash_algos();
if (!in_array('sha256', $algorightms))
{
return false;
}
return true;
}
/**
* @return int
*/
public function getBlockSize()
{
return openssl_cipher_iv_length($this->method);
}
}
PK \P
6 vendor/akeeba/engine/engine/Util/AesAdapter/Mcrypt.phpnu [ .
*/
namespace Akeeba\Engine\Util\AesAdapter;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Util\RandomValue;
class Mcrypt extends AbstractAdapter implements AdapterInterface
{
protected $cipherType = MCRYPT_RIJNDAEL_128;
protected $cipherMode = MCRYPT_MODE_CBC;
public function setEncryptionMode($mode = 'cbc', $strength = 128)
{
switch ((int) $strength)
{
default:
case '128':
$this->cipherType = MCRYPT_RIJNDAEL_128;
break;
case '192':
$this->cipherType = MCRYPT_RIJNDAEL_192;
break;
case '256':
$this->cipherType = MCRYPT_RIJNDAEL_256;
break;
}
switch (strtolower($mode))
{
case 'ecb':
$this->cipherMode = MCRYPT_MODE_ECB;
break;
default:
case 'cbc':
$this->cipherMode = MCRYPT_MODE_CBC;
break;
}
}
public function encrypt($plainText, $key, $iv = null)
{
$iv_size = $this->getBlockSize();
$key = $this->resizeKey($key, $iv_size);
$iv = $this->resizeKey($iv, $iv_size);
if (empty($iv))
{
$randVal = new RandomValue();
$iv = $randVal->generate($iv_size);
}
$cipherText = mcrypt_encrypt($this->cipherType, $key, $plainText, $this->cipherMode, $iv);
$cipherText = $iv . $cipherText;
return $cipherText;
}
public function decrypt($cipherText, $key)
{
$iv_size = $this->getBlockSize();
$key = $this->resizeKey($key, $iv_size);
$iv = substr($cipherText, 0, $iv_size);
$cipherText = substr($cipherText, $iv_size);
$plainText = mcrypt_decrypt($this->cipherType, $key, $cipherText, $this->cipherMode, $iv);
return $plainText;
}
public function isSupported()
{
if (!function_exists('mcrypt_get_key_size'))
{
return false;
}
if (!function_exists('mcrypt_get_iv_size'))
{
return false;
}
if (!function_exists('mcrypt_create_iv'))
{
return false;
}
if (!function_exists('mcrypt_encrypt'))
{
return false;
}
if (!function_exists('mcrypt_decrypt'))
{
return false;
}
if (!function_exists('mcrypt_list_algorithms'))
{
return false;
}
if (!function_exists('hash'))
{
return false;
}
if (!function_exists('hash_algos'))
{
return false;
}
$algorightms = mcrypt_list_algorithms();
if (!in_array('rijndael-128', $algorightms))
{
return false;
}
if (!in_array('rijndael-192', $algorightms))
{
return false;
}
if (!in_array('rijndael-256', $algorightms))
{
return false;
}
$algorightms = hash_algos();
if (!in_array('sha256', $algorightms))
{
return false;
}
return true;
}
public function getBlockSize()
{
return mcrypt_get_iv_size($this->cipherType, $this->cipherMode);
}
}
PK \k ? vendor/akeeba/engine/engine/Util/AesAdapter/AbstractAdapter.phpnu [ .
*/
namespace Akeeba\Engine\Util\AesAdapter;
defined('AKEEBAENGINE') || die();
/**
* Abstract AES encryption class
*/
abstract class AbstractAdapter
{
/**
* Trims or zero-pads a key / IV
*
* @param string $key The key or IV to treat
* @param int $size The block size of the currently used algorithm
*
* @return null|string Null if $key is null, treated string of $size byte length otherwise
*/
public function resizeKey($key, $size)
{
if (empty($key))
{
return null;
}
$keyLength = strlen($key);
if (function_exists('mb_strlen'))
{
$keyLength = mb_strlen($key, 'ASCII');
}
if ($keyLength == $size)
{
return $key;
}
if ($keyLength > $size)
{
if (function_exists('mb_substr'))
{
return mb_substr($key, 0, $size, 'ASCII');
}
return substr($key, 0, $size);
}
return $key . str_repeat("\0", ($size - $keyLength));
}
/**
* Returns null bytes to append to the string so that it's zero padded to the specified block size
*
* @param string $string The binary string which will be zero padded
* @param int $blockSize The block size
*
* @return string The zero bytes to append to the string to zero pad it to $blockSize
*/
protected function getZeroPadding($string, $blockSize)
{
$stringSize = strlen($string);
if (function_exists('mb_strlen'))
{
$stringSize = mb_strlen($string, 'ASCII');
}
if ($stringSize == $blockSize)
{
return '';
}
if ($stringSize < $blockSize)
{
return str_repeat("\0", $blockSize - $stringSize);
}
$paddingBytes = $stringSize % $blockSize;
return str_repeat("\0", $blockSize - $paddingBytes);
}
}
PK \n @ vendor/akeeba/engine/engine/Util/AesAdapter/AdapterInterface.phpnu [ .
*/
namespace Akeeba\Engine\Util\AesAdapter;
defined('AKEEBAENGINE') || die();
/**
* Interface for AES encryption adapters
*/
interface AdapterInterface
{
/**
* Sets the AES encryption mode.
*
* WARNING: The strength is deprecated as it has a different effect in MCrypt and OpenSSL. MCrypt was abandoned in
* 2003 before the Rijndael-128 algorithm was officially the Advanced Encryption Standard (AES). MCrypt also offered
* Rijndael-192 and Rijndael-256 algorithms with different block sizes. These are NOT used in AES. OpenSSL, however,
* implements AES correctly. It always uses a 128-bit (16 byte) block. The 192 and 256 bit strengths refer to the
* key size, not the block size. Therefore using different strengths in MCrypt and OpenSSL will result in different
* and incompatible ciphertexts.
*
* TL;DR: Always use $strength = 128!
*
* @param string $mode Choose between CBC (recommended) or ECB
* @param int $strength Bit strength of the key (128, 192 or 256 bits). DEPRECATED. READ NOTES ABOVE.
*
* @return mixed
*/
public function setEncryptionMode($mode = 'cbc', $strength = 128);
/**
* Encrypts a string. Returns the raw binary ciphertext.
*
* WARNING: The plaintext is zero-padded to the algorithm's block size. You are advised to store the size of the
* plaintext and trim the string to that length upon decryption.
*
* @param string $plainText The plaintext to encrypt
* @param string $key The raw binary key (will be zero-padded or chopped if its size is different than the block size)
* @param null|string $iv The initialization vector (for CBC mode algorithms)
*
* @return string The raw encrypted binary string.
*/
public function encrypt($plainText, $key, $iv = null);
/**
* Decrypts a string. Returns the raw binary plaintext.
*
* $ciphertext MUST start with the IV followed by the ciphertext, even for EBC data (the first block of data is
* dropped in EBC mode since there is no concept of IV in EBC).
*
* WARNING: The returned plaintext is zero-padded to the algorithm's block size during encryption. You are advised
* to trim the string to the original plaintext's length upon decryption. While rtrim($decrypted, "\0") sounds
* appealing it's NOT the correct approach for binary data (zero bytes may actually be part of your plaintext, not
* just padding!).
*
* @param string $cipherText The ciphertext to encrypt
* @param string $key The raw binary key (will be zero-padded or chopped if its size is different than the block size)
*
* @return string The raw unencrypted binary string.
*/
public function decrypt($cipherText, $key);
/**
* Returns the encryption block size in bytes
*
* @return int
*/
public function getBlockSize();
/**
* Is this adapter supported?
*
* @return bool
*/
public function isSupported();
}
PK \Sʉ 5 vendor/akeeba/engine/engine/Util/AesAdapter/.htaccessnu 7m
Order allow,deny
Deny from all
PK \q
n n 5 vendor/akeeba/engine/engine/Util/Log/LogInterface.phpnu [ .
*/
namespace Akeeba\Engine\Util\Log;
defined('AKEEBAENGINE') || die();
/**
* The interface for Akeeba Engine logger objects
*/
interface LogInterface
{
/**
* Open a new log instance with the specified tag. If another log is already open it is closed before switching to
* the new log tag. If the tag is null use the default log defined in the logging system.
*
* @param string|null $tag The log to open
* @param string $extension The log file extension (default: .php, use empty string for .log files)
*
* @return void
*/
public function open($tag = null, $extension = '.php');
/**
* Close the currently active log and set the current tag to null.
*
* @return void
*/
public function close();
/**
* Reset (remove entries) of the log with the specified tag.
*
* @param string|null $tag The log to reset
*
* @return void
*/
public function reset($tag = null);
/**
* Add a message to the log
*
* @param string $level One of the Akeeba\Engine\Psr\Log\LogLevel constants
* @param string $message The message to log
* @param array $context Currently not used. Left here for PSR-3 compatibility.
*
* @return void
*/
public function log($level, $message, array $context = []);
/**
* Temporarily pause log output. The log() method MUST respect this.
*
* @return void
*/
public function pause();
/**
* Resume the previously paused log output. The log() method MUST respect this.
*
* @return void
*/
public function unpause();
/**
* Returns the timestamp (in UNIX time long integer format) of the last log message written to the log with the
* specific tag. The timestamp MUST be read from the log itself, not from the logger object. It is used by the
* engine to find out the age of stalled backups which may have crashed.
*
* @param string|null $tag The log tag for which the last timestamp is returned
*
* @return int|null The timestamp of the last log message, in UNIX time. NULL if we can't get the timestamp.
*/
public function getLastTimestamp($tag = null);
}
PK \ށ @ vendor/akeeba/engine/engine/Util/Log/WarningsLoggerInterface.phpnu [ .
*/
namespace Akeeba\Engine\Util\Log;
defined('AKEEBAENGINE') || die();
interface WarningsLoggerInterface
{
/**
* Returns an array with all warnings logged since the last time warnings were reset. The maximum number of warnings
* returned is controlled by setWarningsQueueSize().
*
* @return array
*/
public function getWarnings();
/**
* Resets the warnings queue.
*
* @return void
*/
public function resetWarnings();
/**
* A combination of getWarnings() and resetWarnings(). Returns the warnings and immediately resets the warnings
* queue.
*
* @return array
*/
public function getAndResetWarnings();
/**
* Set the warnings queue size. A size of 0 means "no limit".
*
* @param int $queueSize The size of the warnings queue (in number of warnings items)
*
* @return void
*/
public function setWarningsQueueSize($queueSize = 0);
/**
* Returns the warnings queue size.
*
* @return int
*/
public function getWarningsQueueSize();
}
PK \7Sr r < vendor/akeeba/engine/engine/Util/Log/WarningsLoggerAware.phpnu [ .
*/
namespace Akeeba\Engine\Util\Log;
defined('AKEEBAENGINE') || die();
trait WarningsLoggerAware
{
/**
* The warnings in the current queue
*
* @var string[]
*/
private $warningsQueue = [];
/**
* The maximum length of the warnings queue
*
* @var int
*/
private $warningsQueueSize = 0;
/**
* A combination of getWarnings() and resetWarnings(). Returns the warnings and immediately resets the warnings
* queue.
*
* @return array
*/
final public function getAndResetWarnings()
{
$ret = $this->getWarnings();
$this->resetWarnings();
return $ret;
}
/**
* Returns an array with all warnings logged since the last time warnings were reset. The maximum number of warnings
* returned is controlled by setWarningsQueueSize().
*
* @return array
*/
final public function getWarnings()
{
return $this->warningsQueue;
}
/**
* Resets the warnings queue.
*
* @return void
*/
final public function resetWarnings()
{
$this->warningsQueue = [];
}
/**
* Returns the warnings queue size.
*
* @return int
*/
final public function getWarningsQueueSize()
{
return $this->warningsQueueSize;
}
/**
* Set the warnings queue size. A size of 0 means "no limit".
*
* @param int $queueSize The size of the warnings queue (in number of warnings items)
*
* @return void
*/
final public function setWarningsQueueSize($queueSize = 0)
{
if (!is_numeric($queueSize) || empty($queueSize) || ($queueSize < 0))
{
$queueSize = 0;
}
$this->warningsQueueSize = $queueSize;
}
/**
* Adds a warning to the warnings queue.
*
* @param string $warning
*/
final protected function enqueueWarning($warning)
{
$this->warningsQueue[] = $warning;
// If there is no queue size limit there's nothing else to be done.
if ($this->warningsQueueSize <= 0)
{
return;
}
// If the queue size is exceeded remove as many of the earliest elements as required
if (count($this->warningsQueue) > $this->warningsQueueSize)
{
$this->warningsQueueSize = array_slice($this->warningsQueue, -$this->warningsQueueSize);
}
}
}
PK \Sʉ . vendor/akeeba/engine/engine/Util/Log/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Ab8 b8 / vendor/akeeba/engine/engine/Util/FileSystem.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
/**
* Utility functions related to filesystem objects, e.g. path translation
*/
class FileSystem
{
/**
* Are we running under Windows?
*
* @var bool
*/
private $isWindows = false;
/**
* Local cache of the platform stock directories
*
* @var array|null
* @since 7.0.3
*/
protected static $stockDirs = null;
/**
* Initialise the object
*/
public function __construct()
{
$this->isWindows = (DIRECTORY_SEPARATOR == '\\');
}
/**
* Makes a Windows path more UNIX-like, by turning backslashes to forward slashes.
* It takes into account UNC paths, e.g. \\myserver\some\folder becomes
* \\myserver/some/folder.
*
* This function will also fix paths with multiple slashes, e.g. convert /var//www////html to /var/www/html
*
* @param string $p_path The path to transform
*
* @return string
*/
public function TranslateWinPath($p_path)
{
$is_unc = false;
if ($this->isWindows)
{
// Is this a UNC path?
$is_unc = (substr($p_path, 0, 2) == '\\\\') || (substr($p_path, 0, 2) == '//');
// Change potential windows directory separator
if ((strpos($p_path, '\\') > 0) || (substr($p_path, 0, 1) == '\\'))
{
$p_path = strtr($p_path, '\\', '/');
}
}
// Remove multiple slashes
if (!is_null($p_path))
{
$p_path = str_replace('///', '/', $p_path);
$p_path = str_replace('//', '/', $p_path);
}
// Fix UNC paths
if ($is_unc)
{
$p_path = '//' . ltrim($p_path, '/');
}
return $p_path;
}
/**
* Removes trailing slash or backslash from a pathname
*
* @param string $path The path to treat
*
* @return string The path without the trailing slash/backslash
*/
public function TrimTrailingSlash($path)
{
$newpath = $path;
if (substr($path, strlen($path) - 1, 1) == '\\')
{
$newpath = substr($path, 0, strlen($path) - 1);
}
if (substr($path, strlen($path) - 1, 1) == '/')
{
$newpath = substr($path, 0, strlen($path) - 1);
}
return $newpath;
}
/**
* Returns an array with the archive name variables and their values. This is used to replace variables in archive
* and directory names, etc.
*
* If there is a non-empty configuration value called volatile.core.archivenamevars with a serialised array it will
* be unserialised and used. Otherwise the name variables will be calculated on-the-fly.
*
* IMPORTANT: These variables do NOT include paths such as [SITEROOT]
*
* @return array
*/
public function get_archive_name_variables()
{
$variables = [];
$registry = Factory::getConfiguration();
$serialized = $registry->get('volatile.core.archivenamevars', null);
if (!empty($serialized))
{
$variables = @unserialize($serialized);
}
if (empty($variables) || !is_array($variables))
{
$host = Platform::getInstance()->get_host();
$version = defined('AKEEBA_VERSION') ? AKEEBA_VERSION : 'svn';
$version = defined('AKEEBABACKUP_VERSION') ? AKEEBABACKUP_VERSION : $version;
$platformVars = Platform::getInstance()->getPlatformVersion();
$siteName = $this->stringUrlUnicodeSlug(Platform::getInstance()->get_site_name());
if (strlen($siteName) > 50)
{
$siteName = substr($siteName, 0, 50);
}
/**
* Time components. Expressed in whatever timezone the Platform decides to use.
*/
// Raw timezone, e.g. "EEST"
$rawTz = Platform::getInstance()->get_local_timestamp("T");
// Filename-safe timezone, e.g. "eest". Note the lowercase letters.
$fsSafeTZ = strtolower(str_replace([' ', '/', ':'], ['_', '_', '_'], $rawTz));
$randVal = new RandomValue();
$variables = [
'[DATE]' => Platform::getInstance()->get_local_timestamp("Ymd"),
'[YEAR]' => Platform::getInstance()->get_local_timestamp("Y"),
'[MONTH]' => Platform::getInstance()->get_local_timestamp("m"),
'[DAY]' => Platform::getInstance()->get_local_timestamp("d"),
'[TIME]' => Platform::getInstance()->get_local_timestamp("His"),
'[TIME_TZ]' => Platform::getInstance()->get_local_timestamp("His") . $fsSafeTZ,
'[WEEK]' => Platform::getInstance()->get_local_timestamp("W"),
'[WEEKDAY]' => Platform::getInstance()->get_local_timestamp("l"),
'[TZ]' => $fsSafeTZ,
'[TZ_RAW]' => $rawTz,
'[GMT_OFFSET]' => Platform::getInstance()->get_local_timestamp("O"),
'[HOST]' => empty($host) ? 'unknown_host' : $host,
'[VERSION]' => $version,
'[PLATFORM_NAME]' => $platformVars['name'],
'[PLATFORM_VERSION]' => $platformVars['version'],
'[SITENAME]' => $siteName,
'[RANDOM]' => $randVal->generateString(16, 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_0123456789'),
];
}
return $variables;
}
/**
* Expands the archive name variables in $source. For example "[DATE]-foobar" would be expanded to something
* like "141101-foobar". IMPORTANT: These variables do NOT include paths.
*
* @param string $source The input string, possibly containing variables in the form of [VARIABLE]
*
* @return string The expanded string
*/
public function replace_archive_name_variables($source)
{
$tagReplacements = $this->get_archive_name_variables();
return str_replace(array_keys($tagReplacements), array_values($tagReplacements), $source);
}
/**
* Expand the platform-specific stock directories variables in the input string. For example "[SITEROOT]/foobar"
* would be expanded to something like "/var/www/html/mysite/foobar"
*
* @param string $folder The input string to expand
* @param bool $translate_win_dirs Should I translate Windows path separators to UNIX path separators? (default: false)
* @param bool $trim_trailing_slash Should I remove the trailing slash (default: false)
*
* @return string The expanded string
*/
public function translateStockDirs($folder, $translate_win_dirs = false, $trim_trailing_slash = false)
{
if (is_null(self::$stockDirs))
{
self::$stockDirs = Platform::getInstance()->get_stock_directories();
}
$temp = $folder;
foreach (self::$stockDirs as $find => $replace)
{
$temp = str_replace($find, $replace, $temp);
}
if ($translate_win_dirs)
{
$temp = $this->TranslateWinPath($temp);
}
if ($trim_trailing_slash)
{
$temp = $this->TrimTrailingSlash($temp);
}
return $temp;
}
/**
* Rebase a path to the platform filesystem variables (most to least specific).
*
* This is the inverse procedure of translateStockDirs().
*
* @param string $path
*
* @return string
* @since 7.3.0
*/
public function rebaseFolderToStockDirs(string $path): string
{
// Normalize the path
$path = $this->TrimTrailingSlash($path);
$path = $this->TranslateWinPath($path);
// Get the stock directories, normalize them and sort them by longest to shortest
$stock_directories = Platform::getInstance()->get_stock_directories();
$stock_directories = array_map(function ($path) {
$path = $this->TrimTrailingSlash($path);
return $this->TranslateWinPath($path);
}, $stock_directories);
uasort($stock_directories, function ($a, $b) {
return -($a <=> $b);
});
// Start replacing paths with variables
foreach ($stock_directories as $var => $stockPath)
{
if (empty($stockPath))
{
continue;
}
if (strpos($path, $stockPath) !== 0)
{
continue;
}
$path = $var . substr($path, strlen($stockPath));
}
return $path;
}
/**
* Generates a set of files which prevent direct web access or at least web listing of the folder contents.
*
* This method generates a .htaccess for Apache, Lighttpd and Litespeed; a web.config file for IIS 7 or later; an
* index.php, index.html and index.htm file for all other browsers.
*
* Despite this security precaution it is STRONGLY advised to keep your backup archives in a directory outside the
* site's web root as explained in the Security Information chapter of the documentation. This method is designed
* to only provide a defence of last resort.
*
* @param string $dir The output directory to secure against web access
* @param bool $force Forcibly overwrite existing files
*
* @return void
* @since 7.0.3
*/
public function ensureNoAccess($dir, $force = false)
{
// Create a .htaccess file to prevent all web access (Apache 1.3+, Lightspeed, Lighttpd, ...)
if (!is_file($dir . '/.htaccess') || $force)
{
$htaccess = <<< APACHE
## This file was generated automatically by the Akeeba Backup Engine
##
## DO NOT REMOVE THIS FILE
##
## This file makes sure that your backup output directory is not directly accessible from the web if you are using
## the Apache, Lighttpd and Litespeed web server. This prevents unauthorized access to your backup archive files and
## backup log files. Removing this file could have security implications for your site.
##
## You are strongly advised to never delete or modify any of the files automatically created in this folder by the
## Akeeba Backup Engine, namely:
##
## * .htaccess
## * web.config
## * index.html
## * index.htm
## * index.php
##
Order deny,allow
Deny from all
Require all denied
APACHE;
@file_put_contents($dir . '/.htaccess', $htaccess);
}
// Create a web.config to prevent all web access (IIS 7+)
if (!is_file($dir . '/web.config') || $force)
{
$webConfig = <<< XML
XML;
@file_put_contents($dir . '/web.config', $webConfig);
}
// Create a blank index.html or index.htm to prevent directory listings (all servers)
$blankHtml = <<< HTML
Access Denied
Access Denied
HTML;
if (!is_file($dir . '/index.html') || $force)
{
@file_put_contents($dir . '/index.html', $blankHtml);
}
if (!is_file($dir . '/index.htm') || $force)
{
@file_put_contents($dir . '/index.htm', $blankHtml);
}
// Create a default index.php to prevent directory listings with an error (all servers)
if (!is_file($dir . '/index.php') || $force)
{
$deadPHP = '<' . '?' . 'php header(\'HTTP/1.1 403 Forbidden\'); return;' . '?' . ">\n";
$deadPHP .= <<< TEXT
This file was generated automatically by the Akeeba Backup Engine
DO NOT REMOVE THIS FILE
This file tells your web server to not list the contents of this directory, instead returning an HTTP 403 Forbidden
error. This makes it implausible for a malicious third party to successfully guess the filenames of your backup
archives. Therefore, even if this folder is directly web accessible – despite the .htaccess and web.config file already
put in place by the Akeeba Backup Engine – it will still be reasonably protected against malicious users trying to
download your backup archives.
Please do not remove this file as it could have security implications for your site.
You are strongly advised to never delete or modify any of the files automatically created in this folder by the
Akeeba Backup Engine, namely:
* .htaccess
* web.config
* index.html
* index.htm
* index.php
TEXT;
@file_put_contents($dir . '/index.php', $deadPHP);
}
}
/**
* Convert a string to a (Unicode) slug
*
* @param string $string String to process
*
* @return string Processed string
*
* @since 7.5.0
*/
public function stringUrlUnicodeSlug(string $string): string
{
// Replace double byte whitespaces by single byte (East Asian languages)
$str = preg_replace('/\xE3\x80\x80/', ' ', $string);
// Remove any '-' from the string as they will be used as concatenator.
$str = str_replace('-', ' ', $str);
// Replace forbidden characters by whitespaces
$str = preg_replace('#[:\?\#\*"@+=;!><&\.%()\]\/\'\\\\|\[]#', "\x20", $str);
// Delete all '?'
$str = str_replace('?', '', $str);
// Trim white spaces at beginning and end of alias and make lowercase
$str = trim(strtolower($str));
// Remove any duplicate whitespace and replace whitespaces by hyphens
$str = preg_replace('#\x20+#', '-', $str);
return $str;
}
}
PK \I I ) vendor/akeeba/engine/engine/Util/Utf8.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
/**
* Replacement for the utf8_encode and utf8_decode functions on PHP 8.2 and later.
*
* @see https://wiki.php.net/rfc/remove_utf8_decode_and_utf8_encode
*/
class Utf8
{
public static function utf8_encode($s)
{
if (function_exists('mb_convert_encoding'))
{
return mb_convert_encoding($s, 'UTF-8', 'ISO-8859-1');
}
if (class_exists('UConverter'))
{
return UConverter::transcode($s, 'UTF8', 'ISO-8859-1');
}
if (function_exists('iconv'))
{
return iconv('ISO-8859-1', 'UTF-8', $s);
}
/**
* Fallback to the pure PHP implementation from Symfony Polyfill for PHP 7.2
*
* @see https://github.com/symfony/polyfill-php72/blob/v1.26.0/Php72.php
*/
$s .= $s;
$len = \strlen($s);
for ($i = $len >> 1, $j = 0; $i < $len; ++$i, ++$j) {
switch (true) {
case $s[$i] < "\x80": $s[$j] = $s[$i]; break;
case $s[$i] < "\xC0": $s[$j] = "\xC2"; $s[++$j] = $s[$i]; break;
default: $s[$j] = "\xC3"; $s[++$j] = \chr(\ord($s[$i]) - 64); break;
}
}
return substr($s, 0, $j);
}
public static function utf8_decode($s)
{
if (function_exists('mb_convert_encoding'))
{
return mb_convert_encoding($s, 'ISO-8859-1', 'UTF-8');
}
if (class_exists('UConverter'))
{
return UConverter::transcode($s, 'ISO-8859-1', 'UTF8');
}
if (function_exists('iconv'))
{
return iconv('UTF-8', 'ISO-8859-1', $s);
}
/**
* Fallback to the pure PHP implementation from Symfony Polyfill for PHP 7.2
*
* @see https://github.com/symfony/polyfill-php72/blob/v1.26.0/Php72.php
*/
$s = (string) $s;
$len = \strlen($s);
for ($i = 0, $j = 0; $i < $len; ++$i, ++$j) {
switch ($s[$i] & "\xF0") {
case "\xC0":
case "\xD0":
$c = (\ord($s[$i] & "\x1F") << 6) | \ord($s[++$i] & "\x3F");
$s[$j] = $c < 256 ? \chr($c) : '?';
break;
case "\xF0":
++$i;
// no break
case "\xE0":
$s[$j] = '?';
$i += 2;
break;
default:
$s[$j] = $s[$i];
}
}
return substr($s, 0, $j);
}
}PK \ˮ'= = / vendor/akeeba/engine/engine/Util/Complexify.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Platform;
use RuntimeException;
/**
* PHP port of http://github.com/danpalmer/jquery.complexify.js
* Retrieved from https://github.com/mcrumley/php-complexify/blob/master/src/Complexify/Complexify.php
* Error reporting is based on https://github.com/kislyuk/node-complexify
*/
class Complexify
{
private static $MIN_COMPLEXITY = 66;
private static $MAX_COMPLEXITY = 120; // 25 chars, all charsets
private static $CHARSETS = [
// Commonly Used
////////////////////
[0x0020, 0x0020], // Space
[0x0030, 0x0039], // Numbers
[0x0041, 0x005A], // Uppercase
[0x0061, 0x007A], // Lowercase
[0x0021, 0x002F], // Punctuation
[0x003A, 0x0040], // Punctuation
[0x005B, 0x0060], // Punctuation
[0x007B, 0x007E], // Punctuation
// Everything Else
////////////////////
[0x0080, 0x00FF], // Latin-1 Supplement
[0x0100, 0x017F], // Latin Extended-A
[0x0180, 0x024F], // Latin Extended-B
[0x0250, 0x02AF], // IPA Extensions
[0x02B0, 0x02FF], // Spacing Modifier Letters
[0x0300, 0x036F], // Combining Diacritical Marks
[0x0370, 0x03FF], // Greek
[0x0400, 0x04FF], // Cyrillic
[0x0530, 0x058F], // Armenian
[0x0590, 0x05FF], // Hebrew
[0x0600, 0x06FF], // Arabic
[0x0700, 0x074F], // Syriac
[0x0780, 0x07BF], // Thaana
[0x0900, 0x097F], // Devanagari
[0x0980, 0x09FF], // Bengali
[0x0A00, 0x0A7F], // Gurmukhi
[0x0A80, 0x0AFF], // Gujarati
[0x0B00, 0x0B7F], // Oriya
[0x0B80, 0x0BFF], // Tamil
[0x0C00, 0x0C7F], // Telugu
[0x0C80, 0x0CFF], // Kannada
[0x0D00, 0x0D7F], // Malayalam
[0x0D80, 0x0DFF], // Sinhala
[0x0E00, 0x0E7F], // Thai
[0x0E80, 0x0EFF], // Lao
[0x0F00, 0x0FFF], // Tibetan
[0x1000, 0x109F], // Myanmar
[0x10A0, 0x10FF], // Georgian
[0x1100, 0x11FF], // Hangul Jamo
[0x1200, 0x137F], // Ethiopic
[0x13A0, 0x13FF], // Cherokee
[0x1400, 0x167F], // Unified Canadian Aboriginal Syllabics
[0x1680, 0x169F], // Ogham
[0x16A0, 0x16FF], // Runic
[0x1780, 0x17FF], // Khmer
[0x1800, 0x18AF], // Mongolian
[0x1E00, 0x1EFF], // Latin Extended Additional
[0x1F00, 0x1FFF], // Greek Extended
[0x2000, 0x206F], // General Punctuation
[0x2070, 0x209F], // Superscripts and Subscripts
[0x20A0, 0x20CF], // Currency Symbols
[0x20D0, 0x20FF], // Combining Marks for Symbols
[0x2100, 0x214F], // Letterlike Symbols
[0x2150, 0x218F], // Number Forms
[0x2190, 0x21FF], // Arrows
[0x2200, 0x22FF], // Mathematical Operators
[0x2300, 0x23FF], // Miscellaneous Technical
[0x2400, 0x243F], // Control Pictures
[0x2440, 0x245F], // Optical Character Recognition
[0x2460, 0x24FF], // Enclosed Alphanumerics
[0x2500, 0x257F], // Box Drawing
[0x2580, 0x259F], // Block Elements
[0x25A0, 0x25FF], // Geometric Shapes
[0x2600, 0x26FF], // Miscellaneous Symbols
[0x2700, 0x27BF], // Dingbats
[0x2800, 0x28FF], // Braille Patterns
[0x2E80, 0x2EFF], // CJK Radicals Supplement
[0x2F00, 0x2FDF], // Kangxi Radicals
[0x2FF0, 0x2FFF], // Ideographic Description Characters
[0x3000, 0x303F], // CJK Symbols and Punctuation
[0x3040, 0x309F], // Hiragana
[0x30A0, 0x30FF], // Katakana
[0x3100, 0x312F], // Bopomofo
[0x3130, 0x318F], // Hangul Compatibility Jamo
[0x3190, 0x319F], // Kanbun
[0x31A0, 0x31BF], // Bopomofo Extended
[0x3200, 0x32FF], // Enclosed CJK Letters and Months
[0x3300, 0x33FF], // CJK Compatibility
[0x3400, 0x4DB5], // CJK Unified Ideographs Extension A
[0x4E00, 0x9FFF], // CJK Unified Ideographs
[0xA000, 0xA48F], // Yi Syllables
[0xA490, 0xA4CF], // Yi Radicals
[0xAC00, 0xD7A3], // Hangul Syllables
[0xD800, 0xDB7F], // High Surrogates
[0xDB80, 0xDBFF], // High Private Use Surrogates
[0xDC00, 0xDFFF], // Low Surrogates
[0xE000, 0xF8FF], // Private Use
[0xF900, 0xFAFF], // CJK Compatibility Ideographs
[0xFB00, 0xFB4F], // Alphabetic Presentation Forms
[0xFB50, 0xFDFF], // Arabic Presentation Forms-A
[0xFE20, 0xFE2F], // Combining Half Marks
[0xFE30, 0xFE4F], // CJK Compatibility Forms
[0xFE50, 0xFE6F], // Small Form Variants
[0xFE70, 0xFEFE], // Arabic Presentation Forms-B
[0xFEFF, 0xFEFF], // Specials
[0xFF00, 0xFFEF], // Halfwidth and Fullwidth Forms
[0xFFF0, 0xFFFD] // Specials
];
// Generated from 500 worst passwords and 370 Banned Twitter lists found at
// @source http://www.skullsecurity.org/wiki/index.php/Passwords
private static $BANLIST = [
'0', '1111', '1212', '1234', '1313', '2000', '2112', '2222',
'3333', '4128', '4321', '4444', '5150', '5555', '6666', '6969', '7777', 'aaaa',
'alex', 'asdf', 'baby', 'bear', 'beer', 'bill', 'blue', 'cock', 'cool', 'cunt',
'dave', 'dick', 'eric', 'fire', 'fish', 'ford', 'fred', 'fuck', 'girl', 'golf',
'jack', 'jake', 'john', 'king', 'love', 'mark', 'matt', 'mike', 'mine', 'pass',
'paul', 'porn', 'rock', 'sexy', 'shit', 'slut', 'star', 'test', 'time', 'tits',
'wolf', 'xxxx', '11111', '12345', 'angel', 'apple', 'beach', 'billy', 'bitch',
'black', 'boobs', 'booty', 'brian', 'bubba', 'buddy', 'chevy', 'chris', 'cream',
'david', 'dirty', 'eagle', 'enjoy', 'enter', 'frank', 'girls', 'great', 'green',
'happy', 'hello', 'horny', 'house', 'james', 'japan', 'jason', 'juice', 'kelly',
'kevin', 'kitty', 'lover', 'lucky', 'magic', 'money', 'movie', 'music', 'naked',
'ou812', 'paris', 'penis', 'peter', 'porno', 'power', 'pussy', 'qwert', 'sammy',
'scott', 'smith', 'stars', 'steve', 'super', 'teens', 'tiger', 'video', 'viper',
'white', 'women', 'xxxxx', 'young', '111111', '112233', '121212', '123123',
'123456', '131313', '232323', '654321', '666666', '696969', '777777', '987654',
'aaaaaa', 'abc123', 'abcdef', 'access', 'action', 'albert', 'alexis', 'amanda',
'andrea', 'andrew', 'angela', 'angels', 'animal', 'apollo', 'apples', 'arthur',
'asdfgh', 'ashley', 'august', 'austin', 'badboy', 'bailey', 'banana', 'barney',
'batman', 'beaver', 'beavis', 'bigdog', 'birdie', 'biteme', 'blazer', 'blonde',
'blowme', 'bonnie', 'booboo', 'booger', 'boomer', 'boston', 'brandy', 'braves',
'brazil', 'bronco', 'buster', 'butter', 'calvin', 'camaro', 'canada', 'carlos',
'carter', 'casper', 'cheese', 'coffee', 'compaq', 'cookie', 'cooper', 'cowboy',
'dakota', 'dallas', 'daniel', 'debbie', 'dennis', 'diablo', 'doctor', 'doggie',
'donald', 'dragon', 'dreams', 'driver', 'eagle1', 'eagles', 'edward', 'erotic',
'falcon', 'fender', 'flower', 'flyers', 'freddy', 'fucked', 'fucker', 'fuckme',
'gators', 'gemini', 'george', 'giants', 'ginger', 'golden', 'golfer', 'gordon',
'guitar', 'gunner', 'hammer', 'hannah', 'harley', 'helpme', 'hentai', 'hockey',
'horney', 'hotdog', 'hunter', 'iceman', 'iwantu', 'jackie', 'jaguar', 'jasper',
'jeremy', 'johnny', 'jordan', 'joseph', 'joshua', 'junior', 'justin', 'killer',
'knight', 'ladies', 'lakers', 'lauren', 'legend', 'little', 'london', 'lovers',
'maddog', 'maggie', 'magnum', 'marine', 'martin', 'marvin', 'master', 'matrix',
'member', 'merlin', 'mickey', 'miller', 'monica', 'monkey', 'morgan', 'mother',
'muffin', 'murphy', 'nascar', 'nathan', 'nicole', 'nipple', 'oliver', 'orange',
'parker', 'peanut', 'pepper', 'player', 'please', 'pookie', 'prince', 'purple',
'qazwsx', 'qwerty', 'rabbit', 'rachel', 'racing', 'ranger', 'redsox', 'robert',
'rocket', 'runner', 'russia', 'samson', 'sandra', 'saturn', 'scooby', 'secret',
'sexsex', 'shadow', 'shaved', 'sierra', 'silver', 'skippy', 'slayer', 'smokey',
'snoopy', 'soccer', 'sophie', 'spanky', 'sparky', 'spider', 'squirt', 'steven',
'sticky', 'stupid', 'suckit', 'summer', 'surfer', 'sydney', 'taylor', 'tennis',
'teresa', 'tester', 'theman', 'thomas', 'tigers', 'tigger', 'tomcat', 'topgun',
'toyota', 'travis', 'tucker', 'turtle', 'united', 'vagina', 'victor', 'viking',
'voodoo', 'walter', 'willie', 'wilson', 'winner', 'winter', 'wizard', 'xavier',
'xxxxxx', 'yamaha', 'yankee', 'yellow', 'zxcvbn', 'zzzzzz', '1234567', '7777777',
'8675309', 'abgrtyu', 'amateur', 'anthony', 'arsenal', 'asshole', 'bigcock',
'bigdick', 'bigtits', 'bitches', 'blondes', 'blowjob', 'bond007', 'brandon',
'broncos', 'bulldog', 'cameron', 'captain', 'charles', 'charlie', 'chelsea',
'chester', 'chicago', 'chicken', 'college', 'cowboys', 'crystal', 'cumming',
'cumshot', 'diamond', 'dolphin', 'extreme', 'ferrari', 'fishing', 'florida',
'forever', 'freedom', 'fucking', 'fuckyou', 'gandalf', 'gateway', 'gregory',
'heather', 'hooters', 'hunting', 'jackson', 'jasmine', 'jessica', 'johnson',
'leather', 'letmein', 'madison', 'matthew', 'maxwell', 'melissa', 'michael',
'monster', 'mustang', 'naughty', 'ncc1701', 'newyork', 'nipples', 'packers',
'panther', 'panties', 'patrick', 'peaches', 'phantom', 'phoenix', 'porsche',
'private', 'pussies', 'raiders', 'rainbow', 'rangers', 'rebecca', 'richard',
'rosebud', 'scooter', 'scorpio', 'shannon', 'success', 'testing', 'thunder',
'thx1138', 'tiffany', 'trouble', 'twitter', 'voyager', 'warrior', 'welcome',
'william', 'winston', 'yankees', 'zxcvbnm', '11111111', '12345678', 'access14',
'baseball', 'bigdaddy', 'butthead', 'cocacola', 'computer', 'corvette',
'danielle', 'dolphins', 'einstein', 'firebird', 'football', 'hardcore',
'iloveyou', 'internet', 'jennifer', 'marlboro', 'maverick', 'mercedes',
'michelle', 'midnight', 'mistress', 'mountain', 'nicholas', 'password',
'princess', 'qwertyui', 'redskins', 'redwings', 'rush2112', 'samantha',
'scorpion', 'srinivas', 'startrek', 'starwars', 'steelers', 'sunshine',
'superman', 'swimming', 'trustno1', 'victoria', 'whatever', 'xxxxxxxx',
'password1', 'password12', 'password123',
];
private $minimumChars = 8;
private $strengthScaleFactor = 1;
private $bannedPasswords = [];
private $banMode = 'strict'; // (strict|loose)
private $encoding = 'UTF-8';
/**
* Constructor
*
* @param array $options Override default options using an associative array of options
*
* Options:
* - minimumChars: Minimum password length (default: 8)
* - strengthScaleFactor: Required password strength multiplier (default: 1)
* - bannedPasswords: Custom list of banned passwords (default: long list of common passwords)
* - banMode: Use strict or loose comparisons for banned passwords. "strict" = don't allow a substring of a banned
* password, "loose" = only ban exact matches (default: strict)
* - encoding: Character set encoding of the password (default: UTF-8)
*/
public function __construct(array $options = [])
{
$this->bannedPasswords = self::$BANLIST;
foreach ($options as $opt => $val)
{
if ($opt === 'banmode')
{
trigger_error('The lowercase banmode option is deprecated. Use banMode instead.', E_USER_DEPRECATED);
$opt = 'banMode';
}
$this->{$opt} = $val;
}
}
/**
* Checks if a password is strong enough for use on a live site. Used to check the front-end Secret Word.
*
* @param string $password The password to check
* @param bool $throwExceptions Throw an exception if the password is not strong enough?
*
* @return bool
*/
public static function isStrongEnough($password, $throwExceptions = true)
{
$complexify = new self();
$res = (object) [
'valid' => strlen($password) >= 32,
'complexity' => 50,
'errors' => (strlen($password) >= 32) ? [] : ['tooshort'],
];
if (function_exists('mb_strlen') && function_exists('mb_convert_encoding') &&
function_exists('mb_substr') && function_exists('mb_convert_case'))
{
$res = $complexify->evaluateSecurity($password);
}
if ($res->valid)
{
return true;
}
if (!$throwExceptions)
{
return false;
}
$error = count($res->errors) ? array_shift($res->errors) : 'toosimple';
$errorMessage = Platform::getInstance()->translate('COM_AKEEBA_CPANEL_ERR_FESECRETWORD_' . $error);
throw new RuntimeException($errorMessage, 403);
}
/**
* Check the complexity of a password
*
* @param string $password The password to check
*
* @return object StdClass object with properties "valid", "complexity", and "error"
* - valid: TRUE if the password is complex enough, FALSE if it is not
* - complexity: The complexity of the password as a percent
* - errors: Array containing descriptions of what made the password fail. Possible values are: banned, toosimple,
* tooshort
*/
public function evaluateSecurity($password)
{
$complexity = 0;
$error = [];
// Reset complexity to 0 when banned password is found
if (!$this->inBanlist($password))
{
// Add character complexity
foreach (self::$CHARSETS as $charset)
{
$complexity += $this->additionalComplexityForCharset($password, $charset);
}
}
else
{
array_push($error, 'banned');
$complexity = 1;
}
// Use natural log to produce linear scale
$complexity = log($complexity ** mb_strlen($password, $this->encoding)) * (1 / $this->strengthScaleFactor);
if ($complexity <= self::$MIN_COMPLEXITY)
{
array_push($error, 'toosimple');
}
if (mb_strlen($password, $this->encoding) < $this->minimumChars)
{
array_push($error, 'tooshort');
}
// Scale to percentage, so it can be used for a progress bar
$complexity = ($complexity / self::$MAX_COMPLEXITY) * 100;
$complexity = ($complexity > 100) ? 100 : $complexity;
return (object) ['valid' => (is_array($error) || $error instanceof \Countable ? count($error) : 0) === 0, 'complexity' => $complexity, 'errors' => $error];
}
/**
* Determine the complexity added from a character set if it is used in a string
*
* @param string $str String to check
* @param int [2] $charset Array of unicode code points representing the lower and upper bound of the
* character range
*
* @return int 0 if there are no characters from the character set, size of the character set if there are any
* characters used in the string
*/
private function additionalComplexityForCharset($str, $charset)
{
$len = mb_strlen($str, $this->encoding);
for ($i = 0; $i < $len; $i++)
{
$c =
unpack('Nord', mb_convert_encoding(mb_substr($str, $i, 1, $this->encoding), 'UCS-4BE', $this->encoding));
if ($charset[0] <= $c['ord'] && $c['ord'] <= $charset[1])
{
return $charset[1] - $charset[0] + 1;
}
}
return 0;
}
/**
* Check if a string is in the banned password list
*
* @param string $str String to check
*
* @return bool TRUE if $str is a banned password, or if it is a substring of a banned password and
* $this->banMode is 'strict'
*/
private function inBanlist($str)
{
if ($str == '')
{
return false;
}
$str = mb_convert_case($str, MB_CASE_LOWER, $this->encoding);
if ($this->banMode === 'strict')
{
for ($i = 0; $i < count($this->bannedPasswords); $i++)
{
if (mb_strpos($this->bannedPasswords[$i], $str, 0, $this->encoding) !== false)
{
return true;
}
}
return false;
}
return in_array($str, $this->bannedPasswords);
}
}
PK \Q Q / vendor/akeeba/engine/engine/Util/FileLister.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
/* Windows system detection */
if (!defined('_AKEEBA_IS_WINDOWS'))
{
$isWindows = DIRECTORY_SEPARATOR == '\\';
if (function_exists('php_uname'))
{
$isWindows = stristr(php_uname(), 'windows');
}
define('_AKEEBA_IS_WINDOWS', $isWindows);
}
/**
* A filesystem scanner, for internal use
*/
class FileLister
{
public function &getFiles($folder, $fullpath = false)
{
// Initialize variables
$arr = [];
$false = false;
if (!is_dir($folder) && !is_dir($folder . '/'))
{
return $false;
}
$handle = @opendir($folder);
if ($handle === false)
{
$handle = @opendir($folder . '/');
}
// If directory is not accessible, just return FALSE
if ($handle === false)
{
return $false;
}
$registry = Factory::getConfiguration();
$dereferencesymlinks = $registry->get('engine.archiver.common.dereference_symlinks');
while ((($file = @readdir($handle)) !== false))
{
if (($file != '.') && ($file != '..'))
{
// # Fix 2.4.b1: Do not add DS if we are on the site's root and it's an empty string
// # Fix 2.4.b2: Do not add DS is the last character _is_ DS
$ds = ($folder == '') || ($folder == '/') || (@substr($folder, -1) == '/') || (@substr($folder, -1) == DIRECTORY_SEPARATOR) ? '' : DIRECTORY_SEPARATOR;
$dir = "$folder/$file";
$isDir = @is_dir($dir);
$isLink = @is_link($dir);
//if (!$isDir || ($isDir && $isLink && !$dereferencesymlinks) ) {
if (!$isDir)
{
if ($fullpath)
{
$data = _AKEEBA_IS_WINDOWS ? Factory::getFilesystemTools()->TranslateWinPath($dir) : $dir;
}
else
{
$data = _AKEEBA_IS_WINDOWS ? Factory::getFilesystemTools()->TranslateWinPath($file) : $file;
}
if ($data)
{
$arr[] = $data;
}
}
}
}
@closedir($handle);
return $arr;
}
public function &getFolders($folder, $fullpath = false)
{
// Initialize variables
$arr = [];
$false = false;
if (!is_dir($folder) && !is_dir($folder . '/'))
{
return $false;
}
$handle = @opendir($folder);
if ($handle === false)
{
$handle = @opendir($folder . '/');
}
// If directory is not accessible, just return FALSE
if ($handle === false)
{
return $false;
}
$registry = Factory::getConfiguration();
$dereferencesymlinks = $registry->get('engine.archiver.common.dereference_symlinks');
while ((($file = @readdir($handle)) !== false))
{
if (($file != '.') && ($file != '..'))
{
$dir = "$folder/$file";
$isDir = @is_dir($dir);
$isLink = @is_link($dir);
if ($isDir)
{
//if(!$dereferencesymlinks && $isLink) continue;
if ($fullpath)
{
$data = _AKEEBA_IS_WINDOWS ? Factory::getFilesystemTools()->TranslateWinPath($dir) : $dir;
}
else
{
$data = _AKEEBA_IS_WINDOWS ? Factory::getFilesystemTools()->TranslateWinPath($file) : $file;
}
if ($data)
{
$arr[] = $data;
}
}
}
}
@closedir($handle);
return $arr;
}
}
PK \anz 1 vendor/akeeba/engine/engine/Util/PushMessages.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\Pushbullet\Connector;
use Exception;
class PushMessages implements PushMessagesInterface
{
/**
* The PushBullet connector
*
* @var Connector[]
*/
private $connectors = [];
/**
* Should we send push messages?
*
* @var bool
*/
private $enabled = true;
/**
* Creates the push messaging object
*/
public function __construct()
{
$pushPreference = Platform::getInstance()->get_platform_configuration_option('push_preference', '0');
$apiKey = Platform::getInstance()->get_platform_configuration_option('push_apikey', '');
// No API key? No push messages are enabled, so no point continuing really...
if (empty($apiKey))
{
$pushPreference = 0;
}
// We use a switch in case we add support for more push APIs in the future. The push_preference platform
// option will tell us which service to use. In that case we'll have to refactor this class, but the public
// API will remain the same.
switch ($pushPreference)
{
default:
case 0:
$this->enabled = false;
break;
case 1:
$keys = explode(',', $apiKey);
$keys = array_map('trim', $keys);
foreach ($keys as $key)
{
try
{
$connector = new Connector($key);
$connector->getDevices();
$this->connectors[] = $connector;
}
catch (Exception $e)
{
Factory::getLog()->warning("Push messages cannot be sent with API key $key. Error received when trying to establish PushBullet connection: " . $e->getMessage());
}
}
if (empty($this->connectors))
{
Factory::getLog()->warning('No push messages can be sent: none of the provided API keys is usable. Push messages have been deactivated.');
$this->enabled = false;
}
break;
}
}
/**
* Sends a push message to all connected devices. The intent is to provide the user with an information message,
* e.g. notify them about the progress of the backup.
*
* @param string $subject The subject of the message, shown in the lock screen. Keep it short.
* @param string $details Long(er) description of what the message is about. Plain text (no HTML).
*
* @return void
*/
public function message($subject, $details = null)
{
if (!$this->enabled)
{
return;
}
foreach ($this->connectors as $connector)
{
try
{
$connector->pushNote('', $subject, $details);
}
catch (Exception $e)
{
Factory::getLog()->warning('Push messages suspended. Error received when trying to send push message:' . $e->getMessage());
$this->enabled = false;
}
}
}
/**
* Sends a push message, containing a URL/URI, to all connected devices. The URL will be rendered as something
* clickable on most devices.
*
* @param string $url The URL/URI
* @param string $subject The subject of the message, shown in the lock screen. Keep it short.
* @param string $details Long(er) description of what the message is about. Plain text (no HTML).
*
* @return void
*/
public function link($url, $subject, $details = null)
{
if (!$this->enabled)
{
return;
}
foreach ($this->connectors as $connector)
{
try
{
$connector->pushLink('', $subject, $url, $details);
}
catch (Exception $e)
{
Factory::getLog()->warning('Push messages suspended. Error received when trying to send push message with a link:' . $e->getMessage());
$this->enabled = false;
}
}
}
}
PK \O o o 0 vendor/akeeba/engine/engine/Util/RandomValue.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
/**
* Crypto-safe random value generator. Based on the Randval class of the Aura for PHP's Session package.
* The following is the license file accompanying the original file.
*
* ********************************************************************************
* Copyright (c) 2011-2016, Aura for PHP
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* - Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* - Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
* ********************************************************************************
*
* Please note that this is a MODIFIED copy of the Randval class, mainly to allow it to be used on hosts
* which lack both mbcrypt and OpenSSL PHP modules.
*/
class RandomValue
{
/**
*
* Returns a cryptographically secure random value.
*
* @param integer $bytes How many bytes to return
*
* @return string
*/
public function generate($bytes = 32)
{
return random_bytes($bytes);
}
/**
* Generates a random string with the specified length. WARNING: You get to specify the number of
* random characters in the string, not the number of random bytes. The character pool is 64 characters
* (6 bits) long. The entropy of your string is 6 * $characters bits. This means that a random string
* of 32 characters has an entropy of 192 bits whereas a random sequence of 32 bytes returned by generate()
* has an entropy of 8 * 32 = 256 bits.
*
* @param int $characters Number of characters
* @param string $characterSet Characters to pick from
*
* @return string
*/
public function generateString($characters = 32, $characterSet = 'abcdefghijklmnopqrstuvwxyz-ABCDEFGHIJKLMNOPQRSTUVWXYZ_0123456789')
{
$sourceString = str_split(
!empty($characterSet) ? $characterSet : 'abcdefghijklmnopqrstuvwxyz-ABCDEFGHIJKLMNOPQRSTUVWXYZ_0123456789',
1
);
$sourceLen = count($sourceString);
$ret = '';
$bytes = ceil($characters / 4) * 3;
$randBytes = $this->generate($bytes);
for ($i = 0; $i < $bytes; $i += 3)
{
$subBytes = substr($randBytes, $i, 3);
$subBytes = str_split($subBytes, 1);
$subBytes = ord($subBytes[0]) * 65536 + ord($subBytes[1]) * 256 + ord($subBytes[2]);
$subBytes = $subBytes & bindec('00000000111111111111111111111111');
$b = [];
$b[0] = ($subBytes >> 18) % $sourceLen;
$b[1] = (($subBytes >> 12) & bindec('111111')) % $sourceLen;
$b[2] = (($subBytes >> 6) & bindec('111111')) % $sourceLen;
$b[3] = ($subBytes & bindec('111111')) % $sourceLen;
$ret .= $sourceString[$b[0]] . $sourceString[$b[1]] . $sourceString[$b[2]] . $sourceString[$b[3]];
}
return substr($ret, 0, $characters);
}
}
PK \HP; ; 5 vendor/akeeba/engine/engine/Util/ProfileMigration.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Exception;
/**
* This helper class is used to migrate Akeeba Backup profiles to the new storage format implemented since version
* 6.4.1
*
* @since 6.4.1
*/
abstract class ProfileMigration
{
/**
* Tries to migrate a backup profile to the new JSON-based storage format used since version 6.4.1.
*
* @param int $profileID The ID of the profile to migrate
*
* @return bool Whether we converted the profile
*
* @since 6.4.1
*/
public static function migrateProfile($profileID)
{
$platform = Platform::getInstance();
$db = Factory::getDatabase($platform->get_platform_database_options());
// Is the database connected?
if (!$db->connected())
{
return false;
}
// Load the raw data from the database
try
{
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('*')
->from($db->qn($platform->tableNameProfiles))
->where($db->qn('id') . ' = ' . $db->q($profileID));
$rawData = $db->setQuery($sql)->loadAssoc();
}
catch (Exception $e)
{
return false;
}
// Decrypt the configuration data if required
$rawData['configuration'] = self::decryptConfiguration($rawData['configuration']);
$migrated = false;
// Migrate the configuration from INI to JSON format
if (self::looksLikeIni($rawData['configuration']))
{
$rawData['configuration'] = self::convertINItoJSON($rawData['configuration']);
$migrated = true;
}
// Migrate the filters from INI to JSON format
if (self::looksLikeSerialized($rawData['filters']))
{
$rawData['filters'] = self::convertSerializedToJSON($rawData['filters']);
$migrated = true;
}
if (!$migrated)
{
return false;
}
$rawData['configuration'] = self::encryptConfiguration($rawData['configuration']);
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->update($db->qn($platform->tableNameProfiles))
->set($db->qn('configuration') . ' = ' . $db->q($rawData['configuration']))
->set($db->qn('filters') . ' = ' . $db->q($rawData['filters']))
->where($db->qn('id') . ' = ' . $db->q($profileID));
$db->setQuery($sql);
try
{
$result = $db->query();
}
catch (Exception $exc)
{
return false;
}
return ($result == true);
}
/**
* Decrypt the configuration data if necessary. Returns the decrypted data.
*
* @param string $configData The possibly encrypted data.
*
* @return string The decrypted data
*
* @since 6.4.1
*/
public static function decryptConfiguration($configData)
{
$noData = empty($configData);
$signature = ($noData || (strlen($configData) < 12)) ? '' : substr($configData, 0, 12);
if (in_array($signature, ['###AES128###', '###CTR128###']))
{
return Factory::getSecureSettings()->decryptSettings($configData);
}
return $configData;
}
/**
* Encrypt the configuration data if necessary.
*
* @param string $configData The raw configuration data
*
* @return string The possibly encrypted configuration data
*
* @since 6.4.1
*/
public static function encryptConfiguration($configData)
{
$secureSettings = Factory::getSecureSettings();
return $secureSettings->encryptSettings($configData);
}
/**
* Does the provided configuration data look like it's INI encoded?
*
* @param string $configData The unencrypted configuration data we read from the database.
*
* @return bool
*
* @since 6.4.1
*/
public static function looksLikeIni($configData)
{
if (empty($configData))
{
return false;
}
if (strlen($configData) < 8)
{
return false;
}
if ((substr($configData, 0, 8) == '[global]') || substr($configData, 0, 8) == '[akeeba]')
{
return true;
}
return false;
}
/**
* Convert the INI-encoded data to JSON-encoded data
*
* @param string $configData The INI-encoded data
*
* @return string The JSON-encoded data
*
* @since 6.4.1
*/
public static function convertINItoJSON($configData)
{
$dataArray = ParseIni::parse_ini_file($configData, true, true);
return json_encode($dataArray, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_FORCE_OBJECT | JSON_PRETTY_PRINT);
}
/**
* Does the raw filters string provided seems to use serialized data? We actually check if it looks like JSON.
* If it's not, we assume it's serialized data.
*
* @param string $rawFilters The raw filters string
*
* @return bool Does it look like a serialized string?
*
* @since 6.4.1
*/
public static function looksLikeSerialized($rawFilters)
{
if (empty($rawFilters))
{
return false;
}
if (substr($rawFilters, 0, 1) == '{')
{
return false;
}
return true;
}
/**
* Convert the serialized array in $rawFilters to JSON representation
*
* @param string $rawFilters Raw serialized string
*
* @return string JSON-encoded string
*
* @since 6.4.1
*/
public static function convertSerializedToJSON($rawFilters)
{
$filters = unserialize($rawFilters);
if (empty($filters))
{
$filters = [];
}
return json_encode($filters, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_FORCE_OBJECT | JSON_PRETTY_PRINT);
}
}
PK \>2 >2 9 vendor/akeeba/engine/engine/Util/Pushbullet/Connector.phpnu [ .
*/
namespace Akeeba\Engine\Util\Pushbullet;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Postproc\ProxyAware;
use CURLFile;
/**
* Based on Pushbullet-for-PHP 2.10.1 – https://github.com/ivkos/Pushbullet-for-PHP/tree/v2
*
* The license for the original class is as follows:
* ----------
* The MIT License (MIT)
*
* Copyright (c) 2014 Ivaylo Stoyanov
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
* ----------
*
* The following class is a derivative work, NOT the original work.
*/
class Connector
{
use ProxyAware;
public const URL_PUSHES = 'https://api.pushbullet.com/v2/pushes';
public const URL_DEVICES = 'https://api.pushbullet.com/v2/devices';
public const URL_CONTACTS = 'https://api.pushbullet.com/v2/contacts';
public const URL_UPLOAD_REQUEST = 'https://api.pushbullet.com/v2/upload-request';
public const URL_USERS = 'https://api.pushbullet.com/v2/users';
public const URL_SUBSCRIPTIONS = 'https://api.pushbullet.com/v2/subscriptions';
public const URL_CHANNEL_INFO = 'https://api.pushbullet.com/v2/channel-info';
public const URL_EPHEMERALS = 'https://api.pushbullet.com/v2/ephemerals';
public const URL_PHONEBOOK = 'https://api.pushbullet.com/v2/permanents/phonebook';
private $_apiKey;
private $_curlCallback;
/**
* Pushbullet constructor.
*
* @param string $apiKey API key.
*
* @throws ApiException
*/
public function __construct($apiKey)
{
$this->_apiKey = $apiKey;
if (!function_exists('curl_init'))
{
throw new ApiException('cURL library is not loaded.');
}
}
/**
* Parse recipient.
*
* @param string $recipient Recipient string.
* @param array $data Data array to populate with the correct recipient parameter.
*/
private static function _parseRecipient($recipient, array &$data)
{
if (!empty($recipient))
{
if (filter_var($recipient, FILTER_VALIDATE_EMAIL) !== false)
{
$data['email'] = $recipient;
}
else
{
if (substr($recipient, 0, 1) == "#")
{
$data['channel_tag'] = substr($recipient, 1);
}
else
{
$data['device_iden'] = $recipient;
}
}
}
}
/**
* Push a note.
*
* @param string $recipient Recipient. Can be device_iden, email or channel #tagname.
* @param string $title The note's title.
* @param string $body The note's message.
*
* @return object Response.
* @throws ApiException
*/
public function pushNote($recipient, $title, $body = null)
{
$data = [];
Connector::_parseRecipient($recipient, $data);
$data['type'] = 'note';
$data['title'] = $title;
$data['body'] = $body;
return $this->_curlRequest(self::URL_PUSHES, 'POST', $data);
}
/**
* Push a link.
*
* @param string $recipient Recipient. Can be device_iden, email or channel #tagname.
* @param string $title The link's title.
* @param string $url The URL to open.
* @param string $body A message associated with the link.
*
* @return object Response.
* @throws ApiException
*/
public function pushLink($recipient, $title, $url, $body = null)
{
$data = [];
Connector::_parseRecipient($recipient, $data);
$data['type'] = 'link';
$data['title'] = $title;
$data['url'] = $url;
$data['body'] = $body;
return $this->_curlRequest(self::URL_PUSHES, 'POST', $data);
}
/**
* Push a checklist.
*
* @param string $recipient Recipient. Can be device_iden, email or channel #tagname.
* @param string $title The list's title.
* @param string[] $items The list items.
*
* @return object Response.
* @throws ApiException
*/
public function pushList($recipient, $title, array $items)
{
$data = [];
Connector::_parseRecipient($recipient, $data);
$data['type'] = 'list';
$data['title'] = $title;
$data['items'] = $items;
return $this->_curlRequest(self::URL_PUSHES, 'POST', $data);
}
/**
* Push a file.
*
* @param string $recipient Recipient. Can be device_iden, email or channel #tagname.
* @param string $filePath The path of the file to push.
* @param string $mimeType The MIME type of the file. If null, we'll try to guess it.
* @param string $title The title of the push notification.
* @param string $body The body of the push notification.
* @param string $altFileName Alternative file name to use instead of the original one.
* For example, you might want to push 'someFile.tmp' as 'image.jpg'.
*
* @return object Response.
* @throws ApiException
*/
public function pushFile($recipient, $filePath, $mimeType = null, $title = null, $body = null, $altFileName = null)
{
$data = [];
$fullFilePath = realpath($filePath);
if (!is_readable($fullFilePath))
{
throw new ApiException('File: File does not exist or is unreadable.');
}
if (filesize($fullFilePath) > 25 * 1024 * 1024)
{
throw new ApiException('File: File size exceeds 25 MB.');
}
$data['file_name'] = $altFileName ?? basename($fullFilePath);
// Try to guess the MIME type if the argument is NULL
$data['file_type'] = $mimeType ?? mime_content_type($fullFilePath);
// Request authorization to upload the file
$response = $this->_curlRequest(self::URL_UPLOAD_REQUEST, 'GET', $data);
$data['file_url'] = $response->file_url;
$response->data->file = new CURLFile($fullFilePath);
// Upload the file
$this->_curlRequest($response->upload_url, 'POST', $response->data, false, false);
Connector::_parseRecipient($recipient, $data);
$data['type'] = 'file';
$data['title'] = $title;
$data['body'] = $body;
return $this->_curlRequest(self::URL_PUSHES, 'POST', $data);
}
/**
* Get push history.
*
* @param int $modifiedAfter Request pushes modified after this UNIX timestamp.
* @param string $cursor Request the next page via its cursor from a previous response. See the API
* documentation (https://docs.pushbullet.com/http/) for a detailed description.
* @param int $limit Maximum number of objects on each page.
*
* @return object Response.
* @throws ApiException
*/
public function getPushHistory($modifiedAfter = 0, $cursor = null, $limit = null)
{
$data = [];
$data['modified_after'] = $modifiedAfter;
if ($cursor !== null)
{
$data['cursor'] = $cursor;
}
if ($limit !== null)
{
$data['limit'] = $limit;
}
return $this->_curlRequest(self::URL_PUSHES, 'GET', $data);
}
/**
* Dismiss a push.
*
* @param string $pushIden push_iden of the push notification.
*
* @return object Response.
* @throws ApiException
*/
public function dismissPush($pushIden)
{
return $this->_curlRequest(self::URL_PUSHES . '/' . $pushIden, 'POST', ['dismissed' => true]);
}
/**
* Delete a push.
*
* @param string $pushIden push_iden of the push notification.
*
* @return object Response.
* @throws ApiException
*/
public function deletePush($pushIden)
{
return $this->_curlRequest(self::URL_PUSHES . '/' . $pushIden, 'DELETE');
}
/**
* Get a list of available devices.
*
* @param int $modifiedAfter Request devices modified after this UNIX timestamp.
* @param string $cursor Request the next page via its cursor from a previous response. See the API
* documentation (https://docs.pushbullet.com/http/) for a detailed description.
* @param int $limit Maximum number of objects on each page.
*
* @return object Response.
* @throws ApiException
*/
public function getDevices($modifiedAfter = 0, $cursor = null, $limit = null)
{
$data = [];
$data['modified_after'] = $modifiedAfter;
if ($cursor !== null)
{
$data['cursor'] = $cursor;
}
if ($limit !== null)
{
$data['limit'] = $limit;
}
return $this->_curlRequest(self::URL_DEVICES, 'GET', $data);
}
/**
* Get information about the current user.
*
* @return object Response.
* @throws ApiException
*/
public function getUserInformation()
{
return $this->_curlRequest(self::URL_USERS . '/me', 'GET');
}
/**
* Update preferences for the current user.
*
* @param array $preferences Preferences.
*
* @return object Response.
* @throws ApiException
*/
public function updateUserPreferences($preferences)
{
return $this->_curlRequest(self::URL_USERS . '/me', 'POST', ['preferences' => $preferences]);
}
/**
* Add a callback function that will be invoked right before executing each cURL request.
*
* @param callable $callback The callback function.
*/
public function addCurlCallback(callable $callback)
{
$this->_curlCallback = $callback;
}
/**
* Send a request to a remote server using cURL.
*
* @param string $url URL to send the request to.
* @param string $method HTTP method.
* @param array $data Query data.
* @param bool $sendAsJSON Send the request as JSON.
* @param bool $auth Use the API key to authenticate
*
* @return object Response.
* @throws ApiException
*/
private function _curlRequest($url, $method, $data = null, $sendAsJSON = true, $auth = true)
{
$curl = curl_init();
$this->applyProxySettingsToCurl($curl);
if ($method == 'GET' && $data !== null)
{
$url .= '?' . http_build_query($data);
}
curl_setopt($curl, CURLOPT_URL, $url);
if ($auth)
{
curl_setopt($curl, CURLOPT_USERPWD, $this->_apiKey);
}
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
if ($method == 'POST' && $data !== null)
{
if ($sendAsJSON)
{
$data = json_encode($data);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Content-Length: ' . strlen($data),
]);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
}
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, false);
@curl_setopt($curl, CURLOPT_CAINFO, AKEEBA_CACERT_PEM);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, true);
if ($this->_curlCallback !== null)
{
$curlCallback = $this->_curlCallback;
$curlCallback($curl);
}
$response = curl_exec($curl);
if ($response === false)
{
$curlError = curl_error($curl);
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($curl);
}
throw new ApiException('cURL Error: ' . $curlError);
}
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
if ($httpCode >= 400)
{
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($curl);
}
$responseParsed = json_decode($response);
throw new ApiException('HTTP Error ' . $httpCode .
' (' . $responseParsed->error->type . '): ' . $responseParsed->error->message);
}
if (version_compare(PHP_VERSION, '8.5.0', 'lt'))
{
curl_close($curl);
}
return json_decode($response);
}
}
PK \)1 < vendor/akeeba/engine/engine/Util/Pushbullet/ApiException.phpnu [ .
*/
namespace Akeeba\Engine\Util\Pushbullet;
defined('AKEEBAENGINE') || die();
use Exception;
class ApiException extends Exception
{
// Exception thrown by Pushbullet
}
PK \Sʉ 5 vendor/akeeba/engine/engine/Util/Pushbullet/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ * vendor/akeeba/engine/engine/Util/.htaccessnu 7m
Order allow,deny
Deny from all
PK \h/ h/ 2 vendor/akeeba/engine/engine/Util/ListingParser.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
/**
* Parses directory listings of the standard UNIX or MS-DOS style, i.e. what is most commonly returned by FTP and SFTP
* servers running on *NIX and Windows machines.
*
* This class is intended to be used with the result RemoteResourceInterface::getRawList, parsing the raw folder listing
* returned by an (S)FTP server -meant to be read by a human- into something you can programmatically work with. Using
* RemoteResourceInterface::getWrapperStringFor with DirectoryIterator is generally preferable, if only much slower due
* to the synchronous nature of remote stat() requests on each iterated element.
*/
class ListingParser
{
/**
* Parse a UNIX- or MS-DOS-style directory listing.
*
* You get a hash array with entries. Each entry has the following keys:
* name: the file / folder name.
* type: file, dir or link.
* target: link target (when type == link).
* user: owner user, numeric or text. IIS FTP fakes this with the literal string "owner".
* group: owner group, numeric or text. IIS FTP fakes this with the literal string "group".
* size: size in bytes; note that some Linux servers report non-zero sizes for directories.
* date: file creation date, most likely blatantly wrong; see below
* perms: permissions in decimal format. Cast with dec2oct to get the 4 digit permissions string, e.g. 1755
*
* Important Notes
*
* Some UNIX systems report a size for directories. Do not assume that something is a directory if it's size is 0,
* you will be surprised. Look at the 'type' element instead.
*
* Dates can be off. UNIX-style directory listings state either the year or the time, not both. If the file was
* modified during this year you will get a date with a resolution of 1 minute. If the file was modified on a
* different year you'll get a date with a resolution of 1 day. MS-DOS listings always contain the time. Again, the
* resolution is 1 minute.
*
* Most MS-DOS style listings don't list junctions and symlinks. As a result they will be reported as regular
* directories / files. This is the case for the IIS FTP server. Other servers may return the raw "dir" command
* results (as CMD.EXE would parse it) in which case links and link targets do get reported.
*
* @param string $list The raw listing
* @param bool $quick True to only include name, type, size and link target for each file.
*
* @return array
*/
public function parseListing($list, $quick = false)
{
$res = $this->parseUnixListing($list, $quick);
if (empty($res))
{
$res = $this->parseMSDOSListing($list, $quick);
}
return $res;
}
/**
* Parse a UNIX-style directory listing. This is the format produced by ls -la on *NIX systems.
*
* You get a hash array with entries. Each entry has the following keys:
* name: the file / folder name.
* type: file, dir or link.
* target: link target (when type == link).
* user: owner user, numeric or text. IIS FTP fakes this with the literal string "owner".
* group: owner group, numeric or text. IIS FTP fakes this with the literal string "group".
* size: size in bytes; note that some Linux servers report non-zero sizes for directories.
* date: file creation date, most likely blatantly wrong; see below
* perms: permissions in decimal format. Cast with dec2oct to get the 4 digit permissions string, e.g. 1755
*
* @param string $list The raw listing
* @param bool $quick True to only include name, type, size and link target for each file.
*
* @return array
*/
protected function parseUnixListing($list, $quick = false)
{
$ret = [];
$list = str_replace(["\r\n", "\r", "\n\n"], ["\n", "\n", "\n"], $list);
$list = explode("\n", $list);
$list = array_map('rtrim', $list);
foreach ($list as $v)
{
$vInfo = preg_split("/[\s]+/", $v, 9);
if ((is_array($vInfo) || $vInfo instanceof \Countable ? count($vInfo) : 0) != 9)
{
continue;
}
$entry = [
'name' => '',
'type' => 'file',
'target' => '',
'user' => '0',
'group' => '0',
'size' => '0',
'date' => '0',
'perms' => '0',
];
if ($quick)
{
$entry = [
'name' => '',
'type' => 'file',
'size' => '0',
'target' => '',
];
}
// ===== Parse permissions =====
$permString = $vInfo[0];
$permStringLen = strlen($permString);
$typeBit = '-';
$userPerms = 'r--';
$groupPerms = 'r--';
$otherPerms = 'r--';
if ($permStringLen)
{
$typeBit = substr($permString, 0, 1);
}
switch ($typeBit)
{
case "d":
$entry['type'] = 'dir';
break;
case "l":
$entry['type'] = 'link';
break;
}
// ===== Parse size =====
$entry['size'] = $vInfo[4];
if (!$quick)
{
if ($permStringLen >= 4)
{
$userPerms = substr($permString, 1, 3);
}
if ($permStringLen >= 7)
{
$groupPerms = substr($permString, 4, 3);
}
if ($permStringLen >= 10)
{
$otherPerms = substr($permString, 7, 3);
}
$bitPart = 0;
$permsPart = '';
[$thisPerms, $thisBit] = $this->textPermsDecode($userPerms);
$bitPart += 4 * $thisBit; // SetUID
$permsPart .= $thisPerms;
[$thisPerms, $thisBit] = $this->textPermsDecode($groupPerms);
$bitPart += 2 * $thisBit; // SetGID
$permsPart .= $thisPerms;
[$thisPerms, $thisBit] = $this->textPermsDecode($otherPerms);
$bitPart += $thisBit; // Sticky (restricted deletion)
$permsPart .= $thisPerms;
$entry['perms'] = octdec($bitPart . $permsPart);
// ===== Parse ownership =====
$entry['user'] = $vInfo[2];
$entry['group'] = $vInfo[3];
// ===== Parse date =====
$dateString = $vInfo[6] . ' ' . $vInfo[5] . ' ' . $vInfo[7];
$x = date_create($dateString);
$entry['date'] = ($x === false) ? 0 : $x->getTimestamp();
}
// ===== Parse name =====
$name = $vInfo[8];
// Ubuntu (possibly others?) tacks a start when either suid/sgid bits is set
if (substr($name, -1) == '*')
{
$name = substr($name, 0, -1);
}
// Link target parsing
if (strpos($name, '->') !== false)
{
[$name, $target] = explode('->', $name);
$entry['target'] = trim($target);
}
$entry['name'] = trim($name);
// ===== Return the entry =====
$ret[] = $entry;
}
return $ret;
}
/**
* Parse am MS-DOS-style directory listing. This is the format produced by dir on MS-DOS and Windows systems.
*
* You get a hash array with entries. Each entry has the following keys:
* name: the file / folder name.
* type: file, dir or link.
* target: link target (when type == link).
* user: owner user, numeric or text. IIS FTP fakes this with the literal string "owner".
* group: owner group, numeric or text. IIS FTP fakes this with the literal string "group".
* size: size in bytes; note that some Linux servers report non-zero sizes for directories.
* date: file creation date, most likely blatantly wrong; see below
* perms: permissions in decimal format. Cast with dec2oct to get the 4 digit permissions string, e.g. 1755
*
* @param string $list The raw listing
* @param bool $quick True to only include name, type, size and link target for each file.
*
* @return array
*/
protected function parseMSDOSListing($list, $quick = false)
{
$ret = [];
$list = str_replace(["\r\n", "\r", "\n\n"], ["\n", "\n", "\n"], $list);
$list = explode("\n", $list);
$list = array_map('rtrim', $list);
foreach ($list as $v)
{
$vInfo = preg_split("/[\s]+/", $v, 5);
if ((is_array($vInfo) || $vInfo instanceof \Countable ? count($vInfo) : 0) < 4)
{
continue;
}
$entry = [
'name' => '',
'type' => 'file',
'target' => '',
'user' => '0',
'group' => '0',
'size' => '0',
'date' => '0',
'perms' => '0',
];
if ($quick)
{
$entry = [
'name' => '',
'type' => 'file',
'size' => '0',
'target' => '',
];
}
// The first two fields are date and time
$dateString = $vInfo[0] . ' ' . $vInfo[1];
// If position 2 is AM/PM append it and remove it from the list
if (in_array(strtoupper($vInfo[2]), ['AM', 'PM']))
{
$dateString .= ' ' . $vInfo[2];
// This trick is required to remove the element and fix the indices for the rest of the parsing to work.
unset ($vInfo[2]);
$vInfo = array_merge($vInfo);
}
if (!$quick)
{
$x = date_create($dateString);
$entry['date'] = ($x === false) ? 0 : $x->getTimestamp();
}
// The third field is either a special type indicator or the file size
switch (strtoupper($vInfo[2]))
{
// Regular directory
case '':
$entry['type'] = 'dir';
break;
// Junction (like a directory symlink, pre-Win7)
case '':
// File symlink
case '':
// Directory symlink
case '':
$entry['type'] = 'link';
break;
default:
$entry['size'] = (int) $vInfo[2];
break;
}
// And finally the file name. If it's a link it's in the format 'name [target]'
preg_match('/(.*)[\s]+\[(.*)\]/', $vInfo[3], $matches);
if (empty($matches))
{
$entry['name'] = $vInfo[3];
// In 24h format (no AM/PM), the target '[...]' may be in the next field
if (empty($entry['target']) && isset($vInfo[4]))
{
preg_match('/(.*)[\s]+\[(.*)\]/', $vInfo[3] . ' ' . $vInfo[4], $matches);
if (!empty($matches))
{
$entry['type'] = 'link';
$entry['name'] = $matches[1];
$entry['target'] = $matches[2];
}
}
}
else
{
$entry['type'] = 'link';
$entry['name'] = $matches[1];
$entry['target'] = $matches[2];
}
// ===== Return the entry =====
$ret[] = $entry;
}
return $ret;
}
/**
* Decode a textual permissions representation for a user, group or others to a pair of octal digits (permissions
* and flags). For example "r--" is converted to [4, 0], "r-x" to [5, 0], "r-t" to [5, 1]
*
* @param string $perms The textual permissions representation for a user, group or others
*
* @return array Two octal digits for permissions and flags (suid/sgid/sticky bit)
*/
private function textPermsDecode($perms)
{
$permBit = 0;
$flagBits = 0;
if (strpos($perms, 'r') !== false)
{
$permBit += 4;
}
if (strpos($perms, 'w') !== false)
{
$permBit += 2;
}
/**
* Both s and t denote flag set and imply the execute permissions is also granted. For user/groups it's
* SetUID/SetGID respectively, for others it's the "sticky" bit (restricted deletion). Since only one of x, s
* and t can be present at one time we use an if/elseif block. I don't use a switch because a. I am not 100%
* sure that all servers will report the text permissions in rwx order and b. I am not sure that switch and
* substr are faster than strpos (and too lazy to benchmark; sorry).
*/
if (strpos($perms, 'x') !== false)
{
$permBit += 1;
}
elseif (strpos($perms, 't') !== false)
{
$flagBits += 1;
}
elseif (strpos($perms, 's') !== false)
{
$flagBits += 1;
}
return [$permBit, $flagBits];
}
}
PK \m m , vendor/akeeba/engine/engine/Util/Encrypt.phpnu [ .
*/
namespace Akeeba\Engine\Util;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Util\AesAdapter\AdapterInterface;
use Akeeba\Engine\Util\AesAdapter\Mcrypt;
use Akeeba\Engine\Util\AesAdapter\OpenSSL;
/**
* AES implementation in PHP (c) Chris Veness 2005-2016.
* Right to use and adapt is granted for under a simple creative commons attribution
* licence. No warranty of any form is offered.
*
* Heavily modified for Akeeba Backup by Nicholas K. Dionysopoulos
* Also added AES-128 CBC mode (with mcrypt and OpenSSL) on top of AES CTR
*/
class Encrypt
{
use HashTrait;
// Sbox is pre-computed multiplicative inverse in GF(2^8) used in SubBytes and KeyExpansion [�5.1.1]
protected $Sbox =
[
0x63, 0x7c, 0x77, 0x7b, 0xf2, 0x6b, 0x6f, 0xc5, 0x30, 0x01, 0x67, 0x2b, 0xfe, 0xd7, 0xab, 0x76,
0xca, 0x82, 0xc9, 0x7d, 0xfa, 0x59, 0x47, 0xf0, 0xad, 0xd4, 0xa2, 0xaf, 0x9c, 0xa4, 0x72, 0xc0,
0xb7, 0xfd, 0x93, 0x26, 0x36, 0x3f, 0xf7, 0xcc, 0x34, 0xa5, 0xe5, 0xf1, 0x71, 0xd8, 0x31, 0x15,
0x04, 0xc7, 0x23, 0xc3, 0x18, 0x96, 0x05, 0x9a, 0x07, 0x12, 0x80, 0xe2, 0xeb, 0x27, 0xb2, 0x75,
0x09, 0x83, 0x2c, 0x1a, 0x1b, 0x6e, 0x5a, 0xa0, 0x52, 0x3b, 0xd6, 0xb3, 0x29, 0xe3, 0x2f, 0x84,
0x53, 0xd1, 0x00, 0xed, 0x20, 0xfc, 0xb1, 0x5b, 0x6a, 0xcb, 0xbe, 0x39, 0x4a, 0x4c, 0x58, 0xcf,
0xd0, 0xef, 0xaa, 0xfb, 0x43, 0x4d, 0x33, 0x85, 0x45, 0xf9, 0x02, 0x7f, 0x50, 0x3c, 0x9f, 0xa8,
0x51, 0xa3, 0x40, 0x8f, 0x92, 0x9d, 0x38, 0xf5, 0xbc, 0xb6, 0xda, 0x21, 0x10, 0xff, 0xf3, 0xd2,
0xcd, 0x0c, 0x13, 0xec, 0x5f, 0x97, 0x44, 0x17, 0xc4, 0xa7, 0x7e, 0x3d, 0x64, 0x5d, 0x19, 0x73,
0x60, 0x81, 0x4f, 0xdc, 0x22, 0x2a, 0x90, 0x88, 0x46, 0xee, 0xb8, 0x14, 0xde, 0x5e, 0x0b, 0xdb,
0xe0, 0x32, 0x3a, 0x0a, 0x49, 0x06, 0x24, 0x5c, 0xc2, 0xd3, 0xac, 0x62, 0x91, 0x95, 0xe4, 0x79,
0xe7, 0xc8, 0x37, 0x6d, 0x8d, 0xd5, 0x4e, 0xa9, 0x6c, 0x56, 0xf4, 0xea, 0x65, 0x7a, 0xae, 0x08,
0xba, 0x78, 0x25, 0x2e, 0x1c, 0xa6, 0xb4, 0xc6, 0xe8, 0xdd, 0x74, 0x1f, 0x4b, 0xbd, 0x8b, 0x8a,
0x70, 0x3e, 0xb5, 0x66, 0x48, 0x03, 0xf6, 0x0e, 0x61, 0x35, 0x57, 0xb9, 0x86, 0xc1, 0x1d, 0x9e,
0xe1, 0xf8, 0x98, 0x11, 0x69, 0xd9, 0x8e, 0x94, 0x9b, 0x1e, 0x87, 0xe9, 0xce, 0x55, 0x28, 0xdf,
0x8c, 0xa1, 0x89, 0x0d, 0xbf, 0xe6, 0x42, 0x68, 0x41, 0x99, 0x2d, 0x0f, 0xb0, 0x54, 0xbb, 0x16,
];
// Rcon is Round Constant used for the Key Expansion [1st col is 2^(r-1) in GF(2^8)] [�5.2]
protected $Rcon = [
[0x00, 0x00, 0x00, 0x00],
[0x01, 0x00, 0x00, 0x00],
[0x02, 0x00, 0x00, 0x00],
[0x04, 0x00, 0x00, 0x00],
[0x08, 0x00, 0x00, 0x00],
[0x10, 0x00, 0x00, 0x00],
[0x20, 0x00, 0x00, 0x00],
[0x40, 0x00, 0x00, 0x00],
[0x80, 0x00, 0x00, 0x00],
[0x1b, 0x00, 0x00, 0x00],
[0x36, 0x00, 0x00, 0x00],
];
protected $passwords = [];
/**
* The algorithm to use for PBKDF2. Must be a supported hash_hmac algorithm. Default: sha1
*
* @var string
*/
private $pbkdf2Algorithm = 'sha1';
/**
* Number of iterations to use for PBKDF2
*
* @var int
*/
private $pbkdf2Iterations = 1000;
/**
* Should we use a static salt for PBKDF2?
*
* @var int
*/
private $pbkdf2UseStaticSalt = 0;
/**
* The static salt to use for PBKDF2
*
* @var string
*/
private $pbkdf2StaticSalt = "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
/**
* AES Cipher function: encrypt 'input' with Rijndael algorithm
*
* @param string $input message as byte-array (16 bytes)
* @param array $w key schedule as 2D byte-array (Nr+1 x Nb bytes) -
* generated from the cipher key by KeyExpansion()
*
* @return array ciphertext as byte-array (16 bytes)
*/
public function Cipher($input, $w)
{
// main Cipher function [�5.1]
$Nb = 4; // block size (in words): no of columns in state (fixed at 4 for AES)
$Nr = count($w) / $Nb - 1; // no of rounds: 10/12/14 for 128/192/256-bit keys
$state = []; // initialise 4xNb byte-array 'state' with input [�3.4]
for ($i = 0; $i < 4 * $Nb; $i++)
{
$state[$i % 4][(int) floor($i / 4)] = $input[$i];
}
$state = $this->AddRoundKey($state, $w, 0, $Nb);
for ($round = 1; $round < $Nr; $round++)
{
// apply Nr rounds
$state = $this->SubBytes($state, $Nb);
$state = $this->ShiftRows($state, $Nb);
$state = $this->MixColumns($state, $Nb);
$state = $this->AddRoundKey($state, $w, $round, $Nb);
}
$state = $this->SubBytes($state, $Nb);
$state = $this->ShiftRows($state, $Nb);
$state = $this->AddRoundKey($state, $w, $Nr, $Nb);
$output = [4 * $Nb]; // convert state to 1-d array before returning [�3.4]
for ($i = 0; $i < 4 * $Nb; $i++)
{
$output[$i] = $state[$i % 4][(int) floor($i / 4)];
}
return $output;
}
/**
* Key expansion for Rijndael Cipher(): performs key expansion on cipher key
* to generate a key schedule
*
* @param array $key cipher key byte-array (16 bytes)
*
* @return array key schedule as 2D byte-array (Nr+1 x Nb bytes)
*/
public function KeyExpansion($key)
{
// generate Key Schedule from Cipher Key [�5.2]
$Nb = 4; // block size (in words): no of columns in state (fixed at 4 for AES)
$Nk = count($key) / 4; // key length (in words): 4/6/8 for 128/192/256-bit keys
$Nr = $Nk + 6; // no of rounds: 10/12/14 for 128/192/256-bit keys
$w = [];
$temp = [];
for ($i = 0; $i < $Nk; $i++)
{
$r = [$key[4 * $i], $key[4 * $i + 1], $key[4 * $i + 2], $key[4 * $i + 3]];
$w[$i] = $r;
}
for ($i = $Nk; $i < ($Nb * ($Nr + 1)); $i++)
{
$w[(int) $i] = [];
for ($t = 0; $t < 4; $t++)
{
$temp[$t] = $w[(int) $i - 1][$t];
}
if ($i % $Nk == 0)
{
$temp = $this->SubWord($this->RotWord($temp));
for ($t = 0; $t < 4; $t++)
{
$temp[$t] ^= $this->Rcon[(int) ($i / $Nk)][$t];
}
}
elseif ($Nk > 6 && $i % $Nk == 4)
{
$temp = $this->SubWord($temp);
}
for ($t = 0; $t < 4; $t++)
{
$w[(int) $i][$t] = $w[(int) $i - $Nk][$t] ^ $temp[$t];
}
}
return $w;
}
/**
* Encrypt a text using AES encryption in Counter mode of operation
* - see http://csrc.nist.gov/publications/nistpubs/800-38a/sp800-38a.pdf
*
* Unicode multi-byte character safe
*
* @param string $plaintext source text to be encrypted
* @param string $password the password to use to generate a key
* @param int $nBits number of bits to be used in the key (128, 192, or 256)
*
* @return string encrypted text
*/
public function AESEncryptCtr($plaintext, $password, $nBits)
{
$blockSize = 16; // block size fixed at 16 bytes / 128 bits (Nb=4) for AES
// standard allows 128/192/256 bit keys
if (!($nBits == 128 || $nBits == 192 || $nBits == 256))
{
return '';
}
// note PHP (5) gives us plaintext and password in UTF8 encoding!
// use AES itself to encrypt password to get cipher key (using plain password as source for
// key expansion) - gives us well encrypted key
$nBytes = $nBits / 8; // no bytes in key
$pwBytes = [];
for ($i = 0; $i < $nBytes; $i++)
{
$pwBytes[$i] = ord(substr($password, $i, 1)) & 0xff;
}
$key = $this->Cipher($pwBytes, $this->KeyExpansion($pwBytes));
$key = array_merge($key, array_slice($key, 0, $nBytes - 16)); // expand key to 16/24/32 bytes long
// initialise counter block (NIST SP800-38A �B.2): millisecond time-stamp for nonce in
// 1st 8 bytes, block counter in 2nd 8 bytes
$counterBlock = [];
$nonce = floor(microtime(true) * 1000); // timestamp: milliseconds since 1-Jan-1970
$nonceSec = floor($nonce / 1000);
$nonceMs = $nonce % 1000;
// encode nonce with seconds in 1st 4 bytes, and (repeated) ms part filling 2nd 4 bytes
for ($i = 0; $i < 4; $i++)
{
$counterBlock[$i] = $this->urs($nonceSec, $i * 8) & 0xff;
}
for ($i = 0; $i < 4; $i++)
{
$counterBlock[$i + 4] = $nonceMs & 0xff;
}
// and convert it to a string to go on the front of the ciphertext
$ctrTxt = '';
for ($i = 0; $i < 8; $i++)
{
$ctrTxt .= chr($counterBlock[$i]);
}
// generate key schedule - an expansion of the key into distinct Key Rounds for each round
$keySchedule = $this->KeyExpansion($key);
$blockCount = ceil(strlen($plaintext) / $blockSize);
$ciphertxt = []; // ciphertext as array of strings
for ($b = 0; $b < $blockCount; $b++)
{
// set counter (block #) in last 8 bytes of counter block (leaving nonce in 1st 8 bytes)
// done in two stages for 32-bit ops: using two words allows us to go past 2^32 blocks (68GB)
for ($c = 0; $c < 4; $c++)
{
$counterBlock[15 - $c] = $this->urs($b, $c * 8) & 0xff;
}
for ($c = 0; $c < 4; $c++)
{
$counterBlock[15 - $c - 4] = $this->urs($b / 0x100000000, $c * 8);
}
$cipherCntr = $this->Cipher($counterBlock, $keySchedule); // -- encrypt counter block --
// block size is reduced on final block
$blockLength = $b < $blockCount - 1 ? $blockSize : (strlen($plaintext) - 1) % $blockSize + 1;
$cipherByte = [];
for ($i = 0; $i < $blockLength; $i++)
{ // -- xor plaintext with ciphered counter byte-by-byte --
$cipherByte[$i] = $cipherCntr[$i] ^ ord(substr($plaintext, $b * $blockSize + $i, 1));
$cipherByte[$i] = chr($cipherByte[$i]);
}
$ciphertxt[$b] = implode('', $cipherByte); // escape troublesome characters in ciphertext
}
// implode is more efficient than repeated string concatenation
$ciphertext = $ctrTxt . implode('', $ciphertxt);
$ciphertext = base64_encode($ciphertext);
return $ciphertext;
}
/**
* Decrypt a text encrypted by AES in counter mode of operation
*
* @param string $ciphertext source text to be decrypted
* @param string $password the password to use to generate a key
* @param int $nBits number of bits to be used in the key (128, 192, or 256)
*
* @return string decrypted text
*/
public function AESDecryptCtr($ciphertext, $password, $nBits)
{
$blockSize = 16; // block size fixed at 16 bytes / 128 bits (Nb=4) for AES
// standard allows 128/192/256 bit keys
if (!($nBits == 128 || $nBits == 192 || $nBits == 256))
{
return '';
}
$ciphertext = base64_decode($ciphertext);
// use AES to encrypt password (mirroring encrypt routine)
$nBytes = $nBits / 8; // no bytes in key
$pwBytes = [];
for ($i = 0; $i < $nBytes; $i++)
{
$pwBytes[$i] = ord(substr($password, $i, 1)) & 0xff;
}
$key = $this->Cipher($pwBytes, $this->KeyExpansion($pwBytes));
$key = array_merge($key, array_slice($key, 0, $nBytes - 16)); // expand key to 16/24/32 bytes long
// recover nonce from 1st element of ciphertext
$counterBlock = [];
$ctrTxt = substr($ciphertext, 0, 8);
for ($i = 0; $i < 8; $i++)
{
$counterBlock[$i] = ord(substr($ctrTxt, $i, 1));
}
// generate key schedule
$keySchedule = $this->KeyExpansion($key);
// separate ciphertext into blocks (skipping past initial 8 bytes)
$nBlocks = ceil((strlen($ciphertext) - 8) / $blockSize);
$ct = [];
for ($b = 0; $b < $nBlocks; $b++)
{
$ct[$b] = substr($ciphertext, 8 + $b * $blockSize, 16);
}
$ciphertext = $ct; // ciphertext is now array of block-length strings
// plaintext will get generated block-by-block into array of block-length strings
$plaintxt = [];
for ($b = 0; $b < $nBlocks; $b++)
{
// set counter (block #) in last 8 bytes of counter block (leaving nonce in 1st 8 bytes)
for ($c = 0; $c < 4; $c++)
{
$counterBlock[15 - $c] = $this->urs($b, $c * 8) & 0xff;
}
for ($c = 0; $c < 4; $c++)
{
$counterBlock[15 - $c - 4] = $this->urs(($b + 1) / 0x100000000 - 1, $c * 8) & 0xff;
}
$cipherCntr = $this->Cipher($counterBlock, $keySchedule); // encrypt counter block
$plaintxtByte = [];
for ($i = 0; $i < strlen($ciphertext[$b]); $i++)
{
// -- xor plaintext with ciphered counter byte-by-byte --
$plaintxtByte[$i] = $cipherCntr[$i] ^ ord(substr($ciphertext[$b], $i, 1));
$plaintxtByte[$i] = chr($plaintxtByte[$i]);
}
$plaintxt[$b] = implode('', $plaintxtByte);
}
// join array of blocks into single plaintext string
$plaintext = implode('', $plaintxt);
return $plaintext;
}
/**
* AES encryption in CBC mode. This is the standard mode (the CTR methods
* actually use Rijndael-128 in CTR mode, which - technically - isn't AES).
* The data length is tucked as a 32-bit unsigned integer (little endian)
* after the ciphertext. It supports AES-128 only.
*
* @param string $plaintext The data to encrypt
* @param string $password Encryption password
*
* @return string The ciphertext
* @author Nicholas K. Dionysopoulos
*
* @since 3.0.1
*/
public function AESEncryptCBC($plaintext, $password)
{
$adapter = $this->getAdapter();
if (!$adapter->isSupported())
{
return false;
}
// Get encryption parameters
$rand = new RandomValue();
$params = $this->getKeyDerivationParameters();
$useStaticSalt = $params['useStaticSalt'];
$keySizeBytes = $params['keySize'];
$salt = null;
if ($useStaticSalt)
{
$key = $this->getStaticSaltExpandedKey($password);
}
else
{
// Create a salt and derive a key from the password using PBKDF2
$algorithm = $params['algorithm'];
$iterations = $params['iterations'];
$salt = $rand->generate(64);
$key = $this->pbkdf2($password, $salt, $algorithm, $iterations, $keySizeBytes);
}
// Also create a new, random IV
$iv = $rand->generate($keySizeBytes);
// The ciphertext is the encrypted string...
$ciphertext = $adapter->encrypt($plaintext, $key, $iv);
// ...minus the IV which was placed in front
$ciphertext = substr($ciphertext, $keySizeBytes);
if (!$useStaticSalt)
{
// ...plus the PBKDF2 setup values at the end (68 bytes)...
$ciphertext .= 'JPST' . $salt;
}
// ...plus the IV at the end (20 bytes)...
$ciphertext .= 'JPIV' . $iv;
// ...plus the plaintext length (4 bytes).
$ciphertext .= pack('V', strlen($plaintext));
return $ciphertext;
}
/**
* Get the parameters fed into PBKDF2 to expand the user password into an encryption key. These are the static
* parameters (key size, hashing algorithm and number of iterations). A new salt is used for each encryption block
* to minimize the risk of attacks against the password.
*
* @return array
*/
public function getKeyDerivationParameters()
{
return [
'keySize' => 16,
'algorithm' => $this->pbkdf2Algorithm,
'iterations' => $this->pbkdf2Iterations,
'useStaticSalt' => $this->pbkdf2UseStaticSalt,
'staticSalt' => $this->pbkdf2StaticSalt,
];
}
/**
* AES decryption in CBC mode. This is the standard mode (the CTR methods
* actually use Rijndael-128 in CTR mode, which - technically - isn't AES).
*
* It supports AES-128 only. It assumes that the last 4 bytes
* contain a little-endian unsigned long integer representing the unpadded
* data length.
*
* @param string $ciphertext The data to encrypt
* @param string $password Encryption password
*
* @return string The plaintext
* @author Nicholas K. Dionysopoulos
*
* @since 3.0.1
*/
public function AESDecryptCBC($ciphertext, $password)
{
$adapter = $this->getAdapter();
if (!$adapter->isSupported())
{
return false;
}
// Read the data size
$unpacked = unpack('V', substr($ciphertext, -4));
$data_size = $unpacked[1];
// Do I have a PBKDF2 salt?
$salt = substr($ciphertext, -92, 68);
$rightStringLimit = -4;
$params = $this->getKeyDerivationParameters();
$keySizeBytes = $params['keySize'];
$algorithm = $params['algorithm'];
$iterations = $params['iterations'];
$useStaticSalt = $params['useStaticSalt'];
if (substr($salt, 0, 4) == 'JPST')
{
// We have a stored salt. Retrieve it and tell decrypt to process the string minus the last 44 bytes
// (4 bytes for JPST, 16 bytes for the salt, 4 bytes for JPIV, 16 bytes for the IV, 4 bytes for the
// uncompressed string length - note that using PBKDF2 means we're also using a randomized IV per the
// format specification).
$salt = substr($salt, 4);
$rightStringLimit -= 68;
$key = $this->pbkdf2($password, $salt, $algorithm, $iterations, $keySizeBytes);
}
elseif ($useStaticSalt)
{
// We have a static salt. Use it for PBKDF2.
$key = $this->getStaticSaltExpandedKey($password);
}
else
{
// Get the expanded key from the password. THIS USES THE OLD, INSECURE METHOD.
$key = $this->expandKey($password);
}
// Try to get the IV from the data
$iv = substr($ciphertext, -24, 20);
if (substr($iv, 0, 4) == 'JPIV')
{
// We have a stored IV. Retrieve it and tell mdecrypt to process the string minus the last 24 bytes
// (4 bytes for JPIV, 16 bytes for the IV, 4 bytes for the uncompressed string length)
$iv = substr($iv, 4);
$rightStringLimit -= 20;
}
else
{
// No stored IV. Do it the dumb way.
$iv = $this->createTheWrongIV($password);
}
// Decrypt
$plaintext = $adapter->decrypt($iv . substr($ciphertext, 0, $rightStringLimit), $key);
// Trim padding, if necessary
if (strlen($plaintext) > $data_size)
{
$plaintext = substr($plaintext, 0, $data_size);
}
return $plaintext;
}
/**
* That's the old way of creating an IV that's definitely not cryptographically sound.
*
* DO NOT USE, EVER, UNLESS YOU WANT TO DECRYPT LEGACY DATA
*
* @param string $password The raw password from which we create an IV in a super bozo way
*
* @return string A 16-byte IV string
*
* @since 4.6.0
* @author Nicholas K. Dionysopoulos
*/
function createTheWrongIV($password)
{
static $ivs = [];
$key = self::md5($password);
if (!isset($ivs[$key]))
{
// Create an Initialization Vector (IV) based on the password, using the same technique as for the key
$nBytes = 16; // AES uses a 128 -bit (16 byte) block size, hence the IV size is always 16 bytes
$pwBytes = [];
for ($i = 0; $i < $nBytes; $i++)
{
$pwBytes[$i] = ord(substr($password, $i, 1)) & 0xff;
}
$iv = $this->Cipher($pwBytes, $this->KeyExpansion($pwBytes));
$newIV = '';
foreach ($iv as $int)
{
$newIV .= chr($int);
}
$ivs[$key] = $newIV;
}
return $ivs[$key];
}
/*
* Unsigned right shift function, since PHP has neither >>> operator nor unsigned ints
*
* @param a number to be shifted (32-bit integer)
* @param b number of bits to shift a to the right (0..31)
* @return a right-shifted and zero-filled by b bits
*/
/**
* Expand the password to an appropriate 128-bit encryption key. THIS CODE IS OBSOLETE. DO NOT USE.
*
* @param string $password
*
* @return string
*
* @since 5.2.0
* @author Nicholas K. Dionysopoulos
*/
public function expandKey($password)
{
// Try to fetch cached key or create it if it doesn't exist
$nBits = 128;
$lookupKey = self::md5($password . '-' . $nBits);
if (array_key_exists($lookupKey, $this->passwords))
{
$key = $this->passwords[$lookupKey];
return $key;
}
// use AES itself to encrypt password to get cipher key (using plain password as source for
// key expansion) - gives us well encrypted key.
$nBytes = $nBits / 8; // Number of bytes in key
$pwBytes = [];
for ($i = 0; $i < $nBytes; $i++)
{
$pwBytes[$i] = ord(substr($password, $i, 1)) & 0xff;
}
$key = $this->Cipher($pwBytes, $this->KeyExpansion($pwBytes));
$key = array_merge($key, array_slice($key, 0, $nBytes - 16)); // expand key to 16/24/32 bytes long
$newKey = '';
foreach ($key as $int)
{
$newKey .= chr($int);
}
$key = $newKey;
$this->passwords[$lookupKey] = $key;
return $key;
}
/**
* Returns the correct AES-128 CBC encryption adapter
*
* @return AdapterInterface
*
* @since 5.2.0
* @author Nicholas K. Dionysopoulos
*/
public function getAdapter()
{
static $adapter = null;
if (is_object($adapter) && ($adapter instanceof AdapterInterface))
{
return $adapter;
}
$adapter = new OpenSSL();
if (!$adapter->isSupported())
{
$adapter = new Mcrypt();
}
return $adapter;
}
/**
* Returns the length of a string in BYTES, not characters
*
* @param string $string The string to get the length for
*
* @return int The size in BYTES
*/
public function stringLength($string)
{
return function_exists('mb_strlen') ? mb_strlen($string, '8bit') : strlen($string);
}
/**
* Attempt to use mbstring for getting parts of strings
*
* @param string $string
* @param int $start
* @param int|null $length
*
* @return string
*/
public function subString($string, $start, $length = null)
{
return function_exists('mb_substr') ? mb_substr($string, $start, $length, '8bit') :
substr($string, $start, $length);
}
/**
* PBKDF2 key derivation function as defined by RSA's PKCS #5: https://www.ietf.org/rfc/rfc2898.txt
*
* Test vectors can be found here: https://www.ietf.org/rfc/rfc6070.txt
*
* This implementation of PBKDF2 was originally created by https://defuse.ca
* With improvements by http://www.variations-of-shadow.com
* Modified for Akeeba Engine by Akeeba Ltd (removed unnecessary checks to make it faster)
*
* @param string $password The password.
* @param string $salt A salt that is unique to the password.
* @param string $algorithm The hash algorithm to use. Default is sha1.
* @param int $count Iteration count. Higher is better, but slower. Default: 1000.
* @param int $key_length The length of the derived key in bytes.
*
* @return string A string of $key_length bytes
*/
public function pbkdf2($password, $salt, $algorithm = 'sha1', $count = 1000, $key_length = 16)
{
if (function_exists("hash_pbkdf2"))
{
return hash_pbkdf2($algorithm, $password, $salt, $count, $key_length, true);
}
$hash_length = $this->stringLength(hash($algorithm, "", true));
$block_count = ceil($key_length / $hash_length);
$output = "";
for ($i = 1; $i <= $block_count; $i++)
{
// $i encoded as 4 bytes, big endian.
$last = $salt . pack("N", $i);
// First iteration
$xorResult = hash_hmac($algorithm, $last, $password, true);
$last = $xorResult;
// Perform the other $count - 1 iterations
for ($j = 1; $j < $count; $j++)
{
$last = hash_hmac($algorithm, $last, $password, true);
$xorResult ^= $last;
}
$output .= $xorResult;
}
return $this->subString($output, 0, $key_length);
}
/**
* @return string
*/
public function getPbkdf2Algorithm()
{
return $this->pbkdf2Algorithm;
}
/**
* @param string $pbkdf2Algorithm
*
* @return Encrypt
*/
public function setPbkdf2Algorithm($pbkdf2Algorithm)
{
$this->pbkdf2Algorithm = $pbkdf2Algorithm;
return $this;
}
/**
* @return int
*/
public function getPbkdf2Iterations()
{
return $this->pbkdf2Iterations;
}
/**
* @param int $pbkdf2Iterations
*
* @return Encrypt
*/
public function setPbkdf2Iterations($pbkdf2Iterations)
{
$this->pbkdf2Iterations = $pbkdf2Iterations;
return $this;
}
/**
* @return int
*/
public function getPbkdf2UseStaticSalt()
{
return $this->pbkdf2UseStaticSalt;
}
/**
* @param int $pbkdf2UseStaticSalt
*
* @return Encrypt
*/
public function setPbkdf2UseStaticSalt($pbkdf2UseStaticSalt)
{
$this->pbkdf2UseStaticSalt = $pbkdf2UseStaticSalt;
return $this;
}
/**
* @return string
*/
public function getPbkdf2StaticSalt()
{
return $this->pbkdf2StaticSalt;
}
/**
* @param string $pbkdf2StaticSalt
*
* @return Encrypt
*/
public function setPbkdf2StaticSalt($pbkdf2StaticSalt)
{
$this->pbkdf2StaticSalt = $pbkdf2StaticSalt;
return $this;
}
/**
* Get the expanded key from the user supplied password using a static salt. The results are cached for performance
* reasons.
*
* @param string $password The user-supplied password, UTF-8 encoded.
*
* @return string The expanded key
*/
public function getStaticSaltExpandedKey($password)
{
$params = $this->getKeyDerivationParameters();
$keySizeBytes = $params['keySize'];
$algorithm = $params['algorithm'];
$iterations = $params['iterations'];
$staticSalt = $params['staticSalt'];
$lookupKey = "PBKDF2-$algorithm-$iterations-" . self::md5($password . $staticSalt);
if (!array_key_exists($lookupKey, $this->passwords))
{
$this->passwords[$lookupKey] = $this->pbkdf2($password, $staticSalt, $algorithm, $iterations, $keySizeBytes);
}
return $this->passwords[$lookupKey];
}
protected function AddRoundKey($state, $w, $rnd, $Nb)
{
// xor Round Key into state S [�5.1.4]
for ($r = 0; $r < 4; $r++)
{
for ($c = 0; $c < $Nb; $c++)
{
$state[$r][$c] ^= $w[$rnd * 4 + $c][$r];
}
}
return $state;
}
protected function SubBytes($s, $Nb)
{
// apply SBox to state S [�5.1.1]
for ($r = 0; $r < 4; $r++)
{
for ($c = 0; $c < $Nb; $c++)
{
$s[$r][$c] = $this->Sbox[$s[$r][$c]];
}
}
return $s;
}
protected function ShiftRows($s, $Nb)
{
// shift row r of state S left by r bytes [�5.1.2]
$t = [4];
for ($r = 1; $r < 4; $r++)
{
// shift into temp copy
for ($c = 0; $c < 4; $c++)
{
$t[$c] = $s[$r][($c + $r) % $Nb];
}
// and copy back
for ($c = 0; $c < 4; $c++)
{
$s[$r][$c] = $t[$c];
}
}
// note that this will work for Nb=4,5,6, but not 7,8 (always 4 for AES):
return $s; // see fp.gladman.plus.com/cryptography_technology/rijndael/aes.spec.311.pdf
}
protected function MixColumns($s, $Nb)
{
// combine bytes of each col of state S [�5.1.3]
for ($c = 0; $c < 4; $c++)
{
$a = [4]; // 'a' is a copy of the current column from 's'
$b = [4]; // 'b' is a�{02} in GF(2^8)
for ($i = 0; $i < 4; $i++)
{
$a[$i] = $s[$i][$c];
$b[$i] = $s[$i][$c] & 0x80 ? $s[$i][$c] << 1 ^ 0x011b : $s[$i][$c] << 1;
}
// a[n] ^ b[n] is a�{03} in GF(2^8)
$s[0][$c] = $b[0] ^ $a[1] ^ $b[1] ^ $a[2] ^ $a[3]; // 2*a0 + 3*a1 + a2 + a3
$s[1][$c] = $a[0] ^ $b[1] ^ $a[2] ^ $b[2] ^ $a[3]; // a0 * 2*a1 + 3*a2 + a3
$s[2][$c] = $a[0] ^ $a[1] ^ $b[2] ^ $a[3] ^ $b[3]; // a0 + a1 + 2*a2 + 3*a3
$s[3][$c] = $a[0] ^ $b[0] ^ $a[1] ^ $a[2] ^ $b[3]; // 3*a0 + a1 + a2 + 2*a3
}
return $s;
}
protected function SubWord($w)
{
// apply SBox to 4-byte word w
for ($i = 0; $i < 4; $i++)
{
$w[$i] = $this->Sbox[$w[$i]];
}
return $w;
}
protected function RotWord($w)
{
// rotate 4-byte word w left by one byte
$tmp = $w[0];
for ($i = 0; $i < 3; $i++)
{
$w[$i] = $w[$i + 1];
}
$w[3] = $tmp;
return $w;
}
protected function urs($a, $b)
{
$a &= 0xffffffff;
$b &= 0x1f; // (bounds check)
if ($a & 0x80000000 && $b > 0)
{
// if left-most bit set
$a = ($a >> 1) & 0x7fffffff; // right-shift one bit & clear left-most bit
$a = $a >> ($b - 1); // remaining right-shifts
}
else
{
// otherwise
$a = ($a >> $b); // use normal right-shift
}
return $a;
}
}
PK \P: : ) vendor/akeeba/engine/engine/Base/Part.phpnu [ .
*/
namespace Akeeba\Engine\Base;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Factory;
use Exception;
use Akeeba\Engine\Psr\Log\LogLevel;
use Throwable;
/**
* Base class for all Akeeba Engine parts.
*
* Parts are objects which perform a specific function during the backup process, e.g. backing up files or dumping
* database contents. They have a fully defined and controlled lifecycle, from initialization to finalization. The
* transition between lifecycle phases is handled by the `tick()` method which is essentially the only public interface
* to interacting with an engine part.
*/
abstract class Part
{
public const STATE_INIT = 0;
public const STATE_PREPARED = 1;
public const STATE_RUNNING = 2;
public const STATE_POSTRUN = 3;
public const STATE_FINISHED = 4;
public const STATE_ERROR = 99;
/**
* The current state of this part; see the constants at the top of this class
*
* @var int
*/
protected $currentState = self::STATE_INIT;
/**
* The name of the engine part (a.k.a. Domain), used in return table
* generation.
*
* @var string
*/
protected $activeDomain = "";
/**
* The step this engine part is in. Used verbatim in return table and
* should be set by the code in the _run() method.
*
* @var string
*/
protected $activeStep = "";
/**
* A more detailed description of the step this engine part is in. Used
* verbatim in return table and should be set by the code in the _run()
* method.
*
* @var string
*/
protected $activeSubstep = "";
/**
* Any configuration variables, in the form of an array.
*
* @var array
*/
protected $_parametersArray = [];
/**
* The database root key
*
* @var string
*/
protected $databaseRoot = [];
/**
* Should we log the step nesting?
*
* @var bool
*/
protected $nest_logging = false;
/**
* Embedded installer preferences
*
* @var object
*/
protected $installerSettings;
/**
* How much milliseconds should we wait to reach the min exec time
*
* @var int
*/
protected $waitTimeMsec = 0;
/**
* Should I ignore the minimum execution time altogether?
*
* @var bool
*/
protected $ignoreMinimumExecutionTime = false;
/**
* The last exception thrown during the tick() method's execution.
*
* @var null|Exception
*/
protected $lastException = null;
public function _onSerialize()
{
$this->lastException = null;
}
/**
* Public constructor
*
* @return void
*/
public function __construct()
{
// Fetch the installer settings
$this->installerSettings = (object) [
'installerroot' => 'installation',
'sqlroot' => 'installation/sql',
'databasesini' => 1,
'readme' => 1,
'extrainfo' => 1,
'password' => 0,
'typedtablelist' => 0,
];
$config = Factory::getConfiguration();
$installerKey = $config->get('akeeba.advanced.embedded_installer');
$installerDescriptors = Factory::getEngineParamsProvider()->getInstallerList();
// Fall back to default ANGIE installer if the selected installer is not found
if (!array_key_exists($installerKey, $installerDescriptors))
{
$installerKey = 'brs';
}
if (array_key_exists($installerKey, $installerDescriptors))
{
$this->installerSettings = (object) $installerDescriptors[$installerKey];
}
}
/**
* Nested logging of exceptions
*
* The message is logged using the specified log level. The detailed information of the Throwable and its trace are
* logged using the DEBUG level.
*
* If the Throwable is nested, its parents are logged recursively. This should create a thorough trace leading to
* the root cause of an error.
*
* @param Exception|Throwable $exception The Exception or Throwable to log
* @param string $logLevel The log level to use, default ERROR
*/
protected static function logErrorsFromException($exception, $logLevel = LogLevel::ERROR)
{
$logger = Factory::getLog();
$logger->log($logLevel, $exception->getMessage());
$logger->debug(sprintf('[%s] %s(%u) – #%u ‹%s›', get_class($exception), $exception->getFile(), $exception->getLine(), $exception->getCode(), $exception->getMessage()));
foreach (explode("\n", $exception->getTraceAsString()) as $line)
{
$logger->debug(rtrim($line));
}
$previous = $exception->getPrevious();
if (!is_null($previous))
{
self::logErrorsFromException($previous, $logLevel);
}
}
/**
* The public interface to an engine part. This method takes care for
* calling the correct method in order to perform the initialisation -
* run - finalisation cycle of operation and return a proper response array.
*
* @param int $nesting
*
* @return array A response array
*/
public function tick($nesting = 0)
{
$configuration = Factory::getConfiguration();
$timer = Factory::getTimer();
$this->waitTimeMsec = 0;
$this->lastException = null;
// Add a small wait based on the existence of a constant. Used in testing, to simulate slow servers.
if (defined('AKEEBA_BACKUP_TESTING_STEP_THROTTLING'))
{
/** @noinspection PhpUndefinedConstantInspection */
usleep((int) AKEEBA_BACKUP_TESTING_STEP_THROTTLING);
}
/**
* Call the right action method, depending on engine part state.
*
* The action method may throw an exception to signal failure, hence the try-catch. If there is an exception we
* will set the part's state to STATE_ERROR and store the last exception.
*/
try
{
switch ($this->getState())
{
case self::STATE_INIT:
$this->_prepare();
break;
case self::STATE_PREPARED:
case self::STATE_RUNNING:
$this->_run();
break;
case self::STATE_POSTRUN:
$this->_finalize();
break;
}
}
catch (Exception $e)
{
$this->lastException = $e;
$this->setState(self::STATE_ERROR);
}
// If there is still time, we are not finished and there is no break flag set, re-run the tick()
// method.
$breakFlag = $configuration->get('volatile.breakflag', false);
if (
!in_array($this->getState(), [self::STATE_FINISHED, self::STATE_ERROR]) &&
($timer->getTimeLeft() > 0) &&
!$breakFlag &&
($nesting < 20) &&
($this->nest_logging)
)
{
// Nesting is only applied if $this->nest_logging == true (currently only Kettenrad has this)
$nesting++;
if ($this->nest_logging)
{
Factory::getLog()->debug("*** Batching successive steps (nesting level $nesting)");
}
return $this->tick($nesting);
}
// Return the output array
$out = $this->makeReturnTable();
// If it's not a nest-logged part (basically, anything other than Kettenrad) return the output array.
if (!$this->nest_logging)
{
return $out;
}
// From here on: things to do for nest-logged parts (i.e. Kettenrad)
if ($breakFlag)
{
Factory::getLog()->debug("*** Engine steps batching: Break flag detected.");
}
// Reset the break flag
$configuration->set('volatile.breakflag', false);
// Log that we're breaking the step
Factory::getLog()->debug("*** Batching of engine steps finished. I will now return control to the caller.");
// Detect whether I need server-side sleep
$serverSideSleep = $this->needsServerSideSleep();
// Enforce minimum execution time
if (!$this->ignoreMinimumExecutionTime)
{
$timer = Factory::getTimer();
$this->waitTimeMsec = (int) $timer->enforce_min_exec_time(true, $serverSideSleep);
}
// Send a Return Table back to the caller
return $out;
}
/**
* Returns a copy of the class's status array
*
* @return array The response array
*/
public function getStatusArray()
{
return $this->makeReturnTable();
}
/**
* Sends any kind of setup information to the engine part. Using this,
* we avoid passing parameters to the constructor of the class. These
* parameters should be passed as an indexed array and should be taken
* into account during the preparation process only. This function will
* set the error flag if it's called after the engine part is prepared.
*
* @param array $parametersArray The parameters to be passed to the engine part.
*
* @return void
*/
public function setup($parametersArray)
{
if ($this->currentState == self::STATE_PREPARED)
{
$this->setState(self::STATE_ERROR);
throw new ErrorException(__CLASS__ . ":: Can't modify configuration after the preparation of " . $this->activeDomain);
}
$this->_parametersArray = $parametersArray;
if (array_key_exists('root', $parametersArray))
{
$this->databaseRoot = $parametersArray['root'];
}
}
/**
* Returns the state of this engine part.
*
* @return int The state of this engine part.
*/
public function getState()
{
if (!is_null($this->lastException))
{
$this->currentState = self::STATE_ERROR;
}
return $this->currentState;
}
/**
* Translate the integer state to a string, used by consumers of the public Engine API.
*
* @param int $state The part state to translate to string
*
* @return string
*/
public function stateToString($state)
{
switch ($state)
{
case self::STATE_ERROR:
return 'error';
break;
case self::STATE_INIT:
return 'init';
break;
case self::STATE_PREPARED:
return 'prepared';
break;
case self::STATE_RUNNING:
return 'running';
break;
case self::STATE_POSTRUN:
return 'postrun';
break;
case self::STATE_FINISHED:
return 'finished';
break;
}
return 'init';
}
/**
* Get the current domain of the engine
*
* @return string The current domain
*/
public function getDomain()
{
return $this->activeDomain;
}
/**
* Get the current step of the engine
*
* @return string The current step
*/
public function getStep()
{
return $this->activeStep;
}
/**
* Get the current sub-step of the engine
*
* @return string The current sub-step
*/
public function getSubstep()
{
return $this->activeSubstep;
}
/**
* Implement this if your Engine Part can return the percentage of its work already complete
*
* @return float A number from 0 (nothing done) to 1 (all done)
*/
public function getProgress()
{
return 0;
}
/**
* Get the value of the minimum execution time ignore flag.
*
* DO NOT REMOVE. It is used by the Engine consumers.
*
* @return boolean
*/
public function isIgnoreMinimumExecutionTime()
{
return $this->ignoreMinimumExecutionTime;
}
/**
* Set the value of the minimum execution time ignore flag. When set, the nested logging parts (basically,
* Kettenrad) will ignore the minimum execution time parameter.
*
* DO NOT REMOVE. It is used by the Engine consumers.
*
* @param boolean $ignoreMinimumExecutionTime
*/
public function setIgnoreMinimumExecutionTime($ignoreMinimumExecutionTime)
{
$this->ignoreMinimumExecutionTime = $ignoreMinimumExecutionTime;
}
/**
* Runs any initialization code. Must set the state to STATE_PREPARED.
*
* @return void
*/
abstract protected function _prepare();
/**
* Runs any finalisation code. Must set the state to STATE_FINISHED.
*
* @return void
*/
abstract protected function _finalize();
/**
* Performs the main objective of this part. While still processing the state must be set to STATE_RUNNING. When the
* main objective is complete and we're ready to proceed to finalization the state must be set to STATE_POSTRUN.
*
* @return void
*/
abstract protected function _run();
/**
* Sets the BREAKFLAG, which instructs this engine part that the current step must break immediately,
* in fear of timing out.
*
* @return void
*/
protected function setBreakFlag()
{
$registry = Factory::getConfiguration();
$registry->set('volatile.breakflag', true);
}
/**
* Sets the engine part's internal state, in an easy to use manner
*
* @param int $state The part state to set
*
* @return void
*/
protected function setState($state = self::STATE_INIT)
{
$this->currentState = $state;
}
/**
* Constructs a Response Array based on the engine part's state.
*
* @return array The Response Array for the current state
*/
protected function makeReturnTable()
{
$errors = [];
$e = $this->lastException;
while (!empty($e))
{
$errors[] = $e->getMessage();
$e = $e->getPrevious();
}
return [
'HasRun' => $this->currentState != self::STATE_FINISHED,
'Domain' => $this->activeDomain,
'Step' => $this->activeStep,
'Substep' => $this->activeSubstep,
'Error' => implode("\n", $errors),
'Warnings' => [],
'ErrorException' => $this->lastException,
];
}
/**
* Set the current domain of the engine
*
* @param string $new_domain The domain to set
*
* @return void
*/
protected function setDomain($new_domain)
{
$this->activeDomain = $new_domain;
}
/**
* Set the current step of the engine
*
* @param string $new_step The step to set
*
* @return void
*/
protected function setStep($new_step)
{
$this->activeStep = $new_step;
}
/**
* Set the current sub-step of the engine
*
* @param string $new_substep The sub-step to set
*
* @return void
*/
protected function setSubstep($new_substep)
{
$this->activeSubstep = $new_substep;
}
/**
* Do I need to apply server-side sleep for the time difference between the elapsed time and the minimum execution
* time?
*
* @return bool
*/
private function needsServerSideSleep()
{
/**
* If the part doesn't support tagging, i.e. I can't determine if this is a backend backup or not, I will always
* use server-side sleep.
*/
if (!method_exists($this, 'getTag'))
{
return true;
}
/**
* If this is not a backend backup I will always use server-side sleep. That is to say that legacy front-end,
* remote JSON API and CLI backups must always use server-side sleep since they do not support client-side
* sleep.
*/
if (!in_array($this->getTag(), ['backend']))
{
return true;
}
return Factory::getConfiguration()->get('akeeba.basic.clientsidewait', 0) == 0;
}
}
PK \ @ vendor/akeeba/engine/engine/Base/Exceptions/WarningException.phpnu [ .
*/
namespace Akeeba\Engine\Base\Exceptions;
defined('AKEEBAENGINE') || die();
use RuntimeException;
/**
* An exception which leads to a warning in the backup process
*/
class WarningException extends RuntimeException
{
}
PK \Me! ! > vendor/akeeba/engine/engine/Base/Exceptions/ErrorException.phpnu [ .
*/
namespace Akeeba\Engine\Base\Exceptions;
defined('AKEEBAENGINE') || die();
use RuntimeException;
/**
* An exception which leads to an error (and complete halt) in the backup process
*/
class ErrorException extends RuntimeException
{
}
PK \Sʉ 5 vendor/akeeba/engine/engine/Base/Exceptions/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ * vendor/akeeba/engine/engine/Base/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ : vendor/akeeba/engine/engine/Dump/Dependencies/Resolver.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Dependencies;
class Resolver
{
private array $tree;
private array $resolved;
private array $unresolved;
public function __construct(array $tree = [])
{
$this->tree = $tree;
}
public function add(string $dependent, string $dependency = ''): void
{
$this->tree[$dependent] ??= [];
if ($dependency !== '')
{
$this->tree[$dependent][] = $dependency;
}
}
public function remove(string $dependent, string $dependency): void
{
if (!$this->tree[$dependent])
{
return;
}
if (!in_array($dependency, $this->tree[$dependent]))
{
return;
}
$this->tree[$dependent] = array_values(array_diff($this->tree[$dependent], [$dependency]));
}
public function snip(string $dependent): void
{
if (!$this->tree[$dependent])
{
return;
}
unset($this->tree[$dependent]);
}
public function resolve(): array
{
$this->resolved = [];
$this->unresolved = [];
// Resolve dependencies for each table
foreach (array_keys($this->tree) as $table)
{
$this->resolver($table);
}
return $this->resolved;
}
private function resolver($item): void
{
$this->unresolved[] = $item;
foreach ($this->tree[$item] as $dep)
{
if (!array_key_exists($dep, $this->tree))
{
continue;
}
if (in_array($dep, $this->resolved, true))
{
continue;
}
if (in_array($dep, $this->unresolved, true))
{
continue;
}
$this->unresolved[] = $dep;
$this->resolver($dep);
}
if (!in_array($item, $this->resolved, true))
{
$this->resolved[] = $item;
}
while (($index = array_search($item, $this->unresolved, true)) !== false)
{
unset($this->unresolved[$index]);
}
}
}PK \Sʉ 7 vendor/akeeba/engine/engine/Dump/Dependencies/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Yw(
(
8 vendor/akeeba/engine/engine/Dump/Dependencies/Entity.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Dependencies;
/**
* Describes a database entity to be backed up.
*
* @property string $type
* @property string|null $name
* @property string|null $abstractName
* @property bool $dumpContents
*/
class Entity
{
private string $type = 'table';
private ?string $name = null;
private ?string $abstractName = null;
private bool $dumpContents = true;
public function __construct(
string $type, string $name, ?string $abstractName = null, bool $dumpContents = true
)
{
$this->setType($type);
$this->setName($name);
$this->setAbstractName($abstractName);
$this->setDumpContents($dumpContents);
}
public function __get($name)
{
$method = 'get' . ucfirst($name);
if (!method_exists($this, $method))
{
throw new \DomainException(
sprintf("Invalid property “%s”", $name)
);
}
return $this->{$method}();
}
public function __set($name, $value)
{
$method = 'set' . ucfirst($name);
if (!method_exists($this, $method))
{
throw new \DomainException(
sprintf("Invalid property “%s”", $name)
);
}
$this->{$method}($value);
}
public function getType(): string
{
return $this->type;
}
public function setType(string $type): self
{
$type = strtolower($type);
if (in_array($type, ['table', 'view', 'procedure', 'function', 'trigger', 'event']))
{
$this->type = $type;
return $this;
}
if (strpos($type, 'table') !== false)
{
$type = 'table';
}
elseif (strpos($type, 'view') !== false)
{
$type = 'view';
}
else
{
throw new \InvalidArgumentException(
sprintf("Invalid database entity type “%s”", $type)
);
}
$this->type = $type;
return $this;
}
public function getDumpContents(): bool
{
return $this->dumpContents;
}
public function setDumpContents(bool $dumpContents): self
{
$this->dumpContents = $dumpContents;
return $this;
}
public function getName(): ?string
{
return $this->name;
}
public function setName(?string $name): self
{
$this->name = $name;
$this->abstractName = null;
return $this;
}
public function getAbstractName(): ?string
{
return $this->abstractName;
}
public function setAbstractName(?string $abstractName): self
{
$this->abstractName = $abstractName;
return $this;
}
public function isRoutine(): bool
{
return !in_array($this->type, ['table', 'view']);
}
public function isTable()
{
return $this->type === 'table';
}
public function isView()
{
return $this->type === 'view';
}
}PK \+ , vendor/akeeba/engine/engine/Dump/native.jsonnu [ {
"_information": {
"title": "COM_AKEEBA_CONFIG_ENGINE_DUMP_NATIVE_TITLE",
"description": "COM_AKEEBA_CONFIG_ENGINE_DUMP_NATIVE_DESCRIPTION"
},
"engine.dump.divider.common": {
"default": "0",
"type": "separator",
"title": "COM_AKEEBA_CONFIG_DUMP_DIVIDER_COMMON",
"bold": "1"
},
"engine.dump.common.blankoutpass": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_BLANKOUTPASS_TITLE",
"description": "COM_AKEEBA_CONFIG_BLANKOUTPASS_DESCRIPTION"
},
"engine.dump.common.extended_inserts": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_EXTENDEDINSERTS_TITLE",
"description": "COM_AKEEBA_CONFIG_EXTENDEDINSERTS_DESCRIPTION"
},
"engine.dump.common.packet_size": {
"default": "131072",
"type": "integer",
"min": "1",
"max": "1048576",
"shortcuts": "16384|32768|65536|131072|262144|524288|1048576",
"scale": "1024",
"uom": "KB",
"title": "COM_AKEEBA_CONFIG_MAXPACKET_TITLE",
"description": "COM_AKEEBA_CONFIG_MAXPACKET_DESCRIPTION"
},
"engine.dump.common.splitsize": {
"default": "524288",
"type": "integer",
"min": "0",
"max": "10485760",
"shortcuts": "524288|1048576|2097152|5242880|10485760",
"scale": "1048576",
"uom": "MB",
"title": "COM_AKEEBA_CONFIG_SPLITDBDUMP_TITLE",
"description": "COM_AKEEBA_CONFIG_SPLITDBDUMP_DESCRIPTION"
},
"engine.dump.common.batchsize": {
"default": "100000",
"type": "integer",
"min": "0",
"max": "1000000",
"shortcuts": "10|20|50|100|200|500|1000|2000|2500|5000|10000|20000|25000|50000|100000|250000|500000|1000000",
"scale": "1",
"uom": "queries",
"title": "COM_AKEEBA_CONFIG_BACTHSIZE_TITLE",
"description": "COM_AKEEBA_CONFIG_BACTHSIZE_DESCRIPTION"
},
"engine.dump.divider.mysql": {
"default": "0",
"type": "separator",
"title": "COM_AKEEBA_CONFIG_DUMP_DIVIDER_MYSQL",
"bold": "1"
},
"engine.dump.native.advanced_entitites": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_MYSQL5FEATURES_ENABLE_TITLE",
"description": "COM_AKEEBA_CONFIG_MYSQL5FEATURES_ENABLE_DESCRIPTION"
},
"engine.dump.native.nodependencies": {
"default": "0",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_NODEPENDENCIES_TITLE",
"description": "COM_AKEEBA_CONFIG_NODEPENDENCIES_DESCRIPTION"
},
"engine.dump.native.nobtree": {
"default": "1",
"type": "bool",
"title": "COM_AKEEBA_CONFIG_MYSQLNOBTREE_TITLE",
"description": "COM_AKEEBA_CONFIG_MYSQLNOBTREE_TIP"
},
"engine.dump.divider.postgres": {
"default": "0",
"type": "separator",
"title": "COM_AKEEBA_CONFIG_DUMP_DIVIDER_POSTGRES",
"bold": "1"
},
"engine.dump.postgres.pgdump_path": {
"default": "",
"type": "string",
"title": "COM_AKEEBA_CONFIG_PGDUMP_PATH_TITLE",
"description": "COM_AKEEBA_CONFIG_PGDUMP_PATH_DESCRIPTION"
}
}PK \0z 0z 1 vendor/akeeba/engine/engine/Dump/Native/Mysql.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\QueryException;
use Akeeba\Engine\Dump\Base;
use Akeeba\Engine\Dump\Dependencies\Entity;
use Akeeba\Engine\Dump\Native\MySQL\BadEntityNamesTrait;
use Akeeba\Engine\Dump\Native\MySQL\CreateStatementTrait;
use Akeeba\Engine\Dump\Native\MySQL\DropStatementTrait;
use Akeeba\Engine\Dump\Native\MySQL\ListEntitiesTrait;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\Collection;
use AllowDynamicProperties;
use Countable;
use Exception;
use RuntimeException;
use Throwable;
use function array_map;
use function array_shift;
use function count;
use function intval;
use function max;
use function memory_get_usage;
use function min;
use function str_replace;
/**
* A generic MySQL database dump class.
*
* Configuration parameters:
* host MySQL database server host name or IP address
* port MySQL database server port (optional)
* username MySQL user name, for authentication
* password MySQL password, for authentication
* database MySQL database
* dumpFile Absolute path to dump file; must be writable (optional; if left blank it is
* automatically calculated)
*/
#[AllowDynamicProperties]
class Mysql extends Base
{
use BadEntityNamesTrait;
use ListEntitiesTrait;
use CreateStatementTrait;
use DropStatementTrait;
/**
* The primary key structure of the currently backed up table. The keys contained are:
* - table The name of the table being backed up
* - field The name of the primary key field
* - value The last value of the PK field
*
* @var array
*/
protected $table_autoincrement = [
'table' => null,
'field' => null,
'value' => null,
];
/** @var Entity|null The next table or DB entity to back up */
protected $nextTable;
private $columnListColumnType = [];
private $columnListSelectColumn = '*';
private $lastTableColumnType = null;
private $lastTableSelectColumn = null;
private Collection $entities;
private bool $useAbstractNames;
private ?string $dbRoot;
private bool $mustFilterRows;
private bool $mustFilterContents;
private int $defaultBatchSize;
private bool $createDropStatements;
private bool $useDelimiterStatements;
/**
* Implements the constructor of the class
*
* @return void
*/
public function __construct()
{
parent::__construct();
Factory::getLog()->debug(__CLASS__ . " :: New instance");
$engineParams = Factory::getEngineParamsProvider();
$this->useAbstractNames = $engineParams->getScriptingParameter('db.abstractnames', 1) == 1;
$this->createDropStatements = $engineParams->getScriptingParameter('db.dropstatements', 0) == 1;
$this->useDelimiterStatements = $engineParams->getScriptingParameter('db.delimiterstatements', 0) == 1;
$this->dbRoot = Factory::getConfiguration()->get('volatile.database.root', '[SITEDB]');
$filters = Factory::getFilters();
$this->mustFilterRows = $filters->hasFilterType('dbobject', 'children');
$this->mustFilterContents = $filters->canFilterDatabaseRowContent();
$this->defaultBatchSize = $this->getDefaultBatchSize();
}
/**
* Get the current DB name, as reported by the DB server.
*
* @return string
*/
protected function getDatabaseNameFromConnection(): string
{
try
{
return $this->getDB()->setQuery('SELECT DATABASE()')->loadResult() ?: '';
}
catch (Throwable $e)
{
return '';
}
}
/**
* Return a list of columns to use in the SELECT query for dumping table data.
*
* This is used to filter out all generated rows.
*
* @param string $tableAbstract
*
* @return string|array An array of table columns, or the string literal '*' to quickly select all columns.
*
* @see https://dev.mysql.com/doc/refman/5.7/en/create-table-generated-columns.html
*/
protected function getSelectColumns($tableAbstract)
{
if ($this->lastTableSelectColumn === $tableAbstract)
{
return $this->columnListSelectColumn;
}
$this->lastTableSelectColumn = $tableAbstract;
$this->columnListSelectColumn = '*';
try
{
$tableCols = $this
->getDB()
->setQuery('SHOW COLUMNS FROM ' . $this->getDB()->qn($tableAbstract))
->loadAssocList();
}
catch (Throwable $e)
{
return $this->columnListSelectColumn;
}
$totalColumns = empty($tableCols) ? 0 : count($tableCols);
$this->columnListSelectColumn = [];
$hasInvisibleColumns = false;
foreach ($tableCols as $col)
{
// Skip over generated columns
$attribs = array_map(
'strtoupper',
empty($col['Extra']) ? [] : explode(' ', $col['Extra'])
);
if (in_array('GENERATED', $attribs))
{
continue;
}
if (in_array('INVISIBLE', $attribs))
{
$hasInvisibleColumns = true;
}
$this->columnListSelectColumn[] = $col['Field'];
}
if (!$hasInvisibleColumns && ($totalColumns === count($this->columnListSelectColumn)))
{
$this->columnListSelectColumn = '*';
}
return $this->columnListSelectColumn;
}
/** @inheritDoc */
protected function getAllTables(): array
{
// Get a database connection
$this->enforceSQLCompatibility();
try
{
return $this->getDB()->setQuery('SHOW TABLES')->loadColumn() ?: [];
}
catch (Throwable $e)
{
return [];
}
}
/**
* Adds tables, views, and routines to the backup queue.
*
* This method will add procedures, functions, tables, views, triggers, and events to the backup queue.
*
* Everything but tables and views will only be added if the option to back up stored routines is enabled.
*
* Tables and views will be added in the order determined by resolving their dependencies. If dependency tracking is
* disabled, they are backed up at the order they appear in the database listing.
*
* @return void
* @throws Exception
*/
protected function getTablesToBackup(): void
{
// Makes the MySQL connection compatible with our class
$this->enforceSQLCompatibility();
/**
* The order routines, tables, and views are added is IMPORTANT. See the linked GitHub issue for information on
* the reasoning behind this decision.
*
* @link https://github.com/akeeba/engine/issues/136
*/
$this->entities = new Collection();
$this->entities = $this->entities->merge($this->getRoutinesCollection('procedure'));
$this->entities = $this->entities->merge($this->getRoutinesCollection('function'));
$this->entities = $this->entities->merge(
$this->resolveDependencies($this->getTablesViewCollection())->values()
);
$this->entities = $this->entities->merge($this->getRoutinesCollection('trigger'));
$this->entities = $this->entities->merge($this->getRoutinesCollection('event'));
// Create a naming map
$this->table_name_map = array_combine(
$this->entities->map(fn(Entity $e) => $e->name)->toArray(),
$this->entities->map(fn(Entity $e) => $e->abstractName)->toArray()
);
/**
* Store all abstract entity names (tables, views, triggers etc) into a volatile variable, so we can fetch
* it later when creating the databases.json file
*/
if ($this->installerSettings->typedtablelist ?? false)
{
// BRS 10.x: typed list of entities
$typedEntityList = [];
/** @var \Akeeba\Engine\Dump\Dependencies\Entity $entity */
foreach ($this->entities as $entity)
{
$typedEntityList[$entity->getType()] ??= [];
$typedEntityList[$entity->getType()][] = $entity->getAbstractName();
}
Factory::getConfiguration()->set('volatile.database.table_names', $typedEntityList);
}
else
{
// Support for legacy installers: flat list of entity names
Factory::getConfiguration()->set('volatile.database.table_names', array_values($this->table_name_map));
}
}
/**
* Populate the next entity to back up.
*
* @return void
*/
protected function goToNextTable(): void
{
$this->nextTable = $this->entities->shift();
$this->nextRange = 0;
}
/**
* Performs one more step of dumping database data.
*
* DO NOT BREAK INTO MULTIPLE METHODS.
*
* Calling methods incurs a performance penalty. Since this is a very tight loop which runs thousands to millions of
* times per backup job any such small performance penalties accrue into something impractical.
*
* @return void
*
* @throws QueryException
* @throws Exception
*/
protected function stepDatabaseDump(): void
{
// Initialize local variables
$db = $this->getDB();
$configuration = Factory::getConfiguration();
$filters = Factory::getFilters();
if (!is_object($db) || ($db === false))
{
throw new RuntimeException(__CLASS__ . '::_run() Could not connect to database?!');
}
// Apply MySQL compatibility option
$this->enforceSQLCompatibility();
// Touch SQL dump file
$nada = "";
$this->writeline($nada);
// Get this table's information
$this->setStep($this->nextTable->name);
$this->setSubstep('');
// Restore any previously information about the largest query we had to run
$this->largest_query = Factory::getConfiguration()->get('volatile.database.largest_query', 0);
// If it is the first run, find number of rows and get the CREATE TABLE command.
if ($this->nextRange == 0)
{
$outCreate = $this->getCreateStatement(
$this->nextTable->abstractName, $this->nextTable->name, $this->nextTable->type
);
if (empty($outCreate))
{
Factory::getLog()->warning(
sprintf(
"Cannot get the CREATE statement for %s %s -- skipping", $this->nextTable->type,
$this->nextTable->abstractName
)
);
$this->nextRange = 1;
$this->maxRange = 0;
}
$suffix = "/*ABDE:{$this->nextTable->abstractName}*/\n";
// Create drop statements if required (the key is defined by the scripting engine)
if ($this->createDropStatements && !empty($outCreate))
{
$dropStatement = $this->createDrop($this->nextTable);
if (!empty($dropStatement))
{
$dropStatement .= $suffix;
if (!$this->writeDump($dropStatement, true))
{
return;
}
}
}
/**
* If we have a PROCEDURE, FUNCTION or TRIGGER and we are doing a SQL export meant to be run directly by
* MySQL (the scripting db.delimiterstatements flag is set to 1) we need to surround the CREATE statement
* with DELIMITER $$ commands.
*/
if (
!$this->nextTable->isTable() && !$this->nextTable->isView()
&& $this->useDelimiterStatements
)
{
$outCreate = rtrim($outCreate, ";\n");
$outCreate = "DELIMITER $$\n$outCreate$$\nDELIMITER ;" . $suffix;
}
// Write the CREATE command after any DROP command which might be necessary.
if (!$this->writeDump(rtrim($outCreate, "\n") . $suffix, true))
{
return;
}
if ($this->nextTable->dumpContents)
{
// We are dumping data from a table, get the row count
$this->getRowCount($this->nextTable->abstractName);
// If we can't get the row count we cannot back up this table's data
if (is_null($this->maxRange))
{
Factory::getLog()->warning(
sprintf(
"Cannot get the row count for %s %s -- skipping data dump", $this->nextTable->type,
$this->nextTable->abstractName
)
);
$this->nextRange = 1;
$this->maxRange = 0;
}
}
elseif (!$this->nextTable->dumpContents)
{
/**
* Do NOT move this line to the if-block below. We need to only log this message on tables which are
* filtered, not on tables we simply cannot get the row count information for!
*/
Factory::getLog()->info(
sprintf("Skipping dumping data of %s %s", $this->nextTable->type, $this->nextTable->abstractName)
);
}
// The table is either filtered, or we cannot get the row count. Either way we should not dump any data.
if (!$this->nextTable->dumpContents)
{
$this->nextRange = 1;
$this->maxRange = 0;
}
// Output any data preamble commands, e.g. SET IDENTITY_INSERT for SQL Server
if ($this->nextTable->dumpContents && $this->createDropStatements)
{
$preamble = $this->getDataDumpPreamble(
$this->nextTable->abstractName, $this->nextTable->name, $this->maxRange
);
if (!empty($preamble))
{
Factory::getLog()->debug("Writing data dump preamble for " . $this->nextTable->abstractName);
if (!$this->writeDump($preamble, true))
{
return;
}
}
}
$this->nextRange ??= 0;
$this->maxRange ??= 0;
// Get the table's auto increment information
if ($this->nextTable->dumpContents && $this->nextRange < $this->maxRange)
{
$this->setAutoIncrementInfo();
}
}
// Get the default and the current (optimal) batch size
$batchSize = $configuration->get('volatile.database.batchsize', $this->defaultBatchSize);
// Check if we have more work to do on this table
if ($this->nextRange < $this->maxRange)
{
$timer = Factory::getTimer();
// Get the number of rows left to dump from the current table
$columns = $this->getSelectColumns($this->nextTable->abstractName);
$columnTypes = $this->getColumnTypes($this->nextTable->abstractName);
$columnsForQuery = is_array($columns) ? array_map([$db, 'qn'], $columns) : $columns;
$sql = $db->getQuery(true)
->select($columnsForQuery)
->from($db->nameQuote($this->nextTable->abstractName));
if (!is_null($this->table_autoincrement['field']))
{
$sql->order($db->qn($this->table_autoincrement['field']) . ' ASC');
}
if ($this->nextRange == 0)
{
// Get the optimal batch size for this table and save it to the volatile data
$batchSize = $this->getOptimalBatchSize($this->nextTable->abstractName);
$configuration->set('volatile.database.batchsize', $batchSize);
// First run, get a cursor to all records
$db->setQuery($sql, 0, $batchSize);
Factory::getLog()->info("Beginning dump of " . $this->nextTable->abstractName);
Factory::getLog()->debug("Up to $batchSize records will be read at once.");
}
else
{
// Subsequent runs, get a cursor to the rest of the records
$this->setSubstep($this->nextRange . ' / ' . $this->maxRange);
// If we have an auto_increment value and the table has over $batchsize records use the indexed select instead of a plain limit
if (!is_null($this->table_autoincrement['field']) && !is_null($this->table_autoincrement['value']))
{
Factory::getLog()
->info(
"Continuing dump of " . $this->nextTable->abstractName
. " from record #{$this->nextRange} using auto_increment column {$this->table_autoincrement['field']} and value {$this->table_autoincrement['value']}"
);
$sql->where(
$db->qn($this->table_autoincrement['field']) . ' > ' . $db->q(
$this->table_autoincrement['value']
)
);
$db->setQuery($sql, 0, $batchSize);
}
else
{
Factory::getLog()
->info(
"Continuing dump of " . $this->nextTable->abstractName
. " from record #{$this->nextRange}"
);
$db->setQuery($sql, $this->nextRange, $batchSize);
}
}
$this->query = '';
$numRows = 0;
try
{
$cursor = $db->query();
}
catch (Exception $exc)
{
// Issue a warning about the failure to dump data
$errno = $exc->getCode();
$error = $exc->getMessage();
Factory::getLog()->warning(
"Failed dumping {$this->nextTable->abstractName} from record #{$this->nextRange}. MySQL error $errno: $error"
);
// Reset the database driver's state (we will try to dump other tables anyway)
$db->resetErrors();
$cursor = null;
// Mark this table as done since we are unable to dump it.
$this->nextRange = $this->maxRange;
}
$statsTableAbstract = Platform::getInstance()->tableNameStats;
while (is_array($myRow = $db->fetchAssoc()) && ($numRows < ($this->maxRange - $this->nextRange)))
{
if (!$this->createNewPartIfRequired())
{
/**
* When createNewPartIfRequired returns false it means that we have began adding a SQL part to the
* backup archive but it hasn't finished. If we don't return here, the code below will keep adding
* data to that dump file. Yes, despite being closed. When you call writeDump the file is reopened.
* As a result of writing data of length Y, the file that had a size X now has a size of X + Y. This
* means that the loop in BaseArchiver which tries to add it to the archive will never see its End
* Of File since we are trying to resume the backup from *beyond* the file position that was
* recorded as the file size. The archive can detect a file shrinking but not a file growing!
* Therefore we hit an infinite loop a.k.a. runaway backup.
*/
return;
}
$numRows++;
$numOfFields = is_array($myRow) || $myRow instanceof Countable ? count($myRow) : 0;
// On MS SQL Server there's always a RowNumber pseudocolumn added at the end, screwing up the backup (GRRRR!)
if ($db->getDriverType() == 'mssql')
{
$numOfFields--;
}
if ($numOfFields === 0)
{
Factory::getLog()->warning(
sprintf(
"No columns for %s %s -- skipping data dump.",
$this->nextTable->type, $this->nextTable->abstractName
)
);
$numRows = $this->maxRange - $this->nextRange;
break;
}
// If row-level filtering is enabled, please run the filtering
if ($this->mustFilterRows)
{
$isFiltered = $filters->isFiltered(
[
'table' => $this->nextTable->abstractName,
'row' => $myRow,
],
$this->dbRoot,
'dbobject',
'children'
);
if ($isFiltered)
{
// Update the auto_increment value to avoid edge cases when the batch size is one
if (!is_null($this->table_autoincrement['field'])
&& isset($myRow[$this->table_autoincrement['field']]))
{
$this->table_autoincrement['value'] = $myRow[$this->table_autoincrement['field']];
}
continue;
}
}
if ($this->mustFilterContents)
{
$filters->filterDatabaseRowContent($this->dbRoot, $this->nextTable->abstractName, $myRow);
}
// Add header on simple INSERTs, or on extended INSERTs if there are no other data, yet
$newQuery = false;
if (
!$this->extendedInserts || ($this->extendedInserts && empty($this->query))
)
{
$newQuery = true;
$fieldList = $this->getFieldListSQL($columns);
$this->query = "INSERT INTO " . $db->nameQuote(
(!$this->useAbstractNames ? $this->nextTable->name : $this->nextTable->abstractName)
) . " {$fieldList} VALUES \n";
}
$outData = '(';
// Step through each of the row's values
$fieldID = 0;
// Used in running backup fix
$isCurrentBackupEntry = false;
// Fix 1.2a - NULL values were being skipped
foreach ($myRow as $fieldName => $value)
{
// The ID of the field, used to determine placement of commas
$fieldID++;
if ($fieldID > $numOfFields)
{
// This is required for SQL Server backups, do NOT remove!
continue;
}
// Fix 2.0: Mark currently running backup as successful in the DB snapshot
if ($this->nextTable->abstractName == $statsTableAbstract)
{
if ($fieldID == 1)
{
// Compare the ID to the currently running
$statistics = Factory::getStatistics();
$isCurrentBackupEntry = ($value == $statistics->getId());
}
elseif ($fieldID == 6)
{
// Treat the status field
$value = $isCurrentBackupEntry ? 'complete' : $value;
}
}
// Post-process the value
if (is_null($value))
{
$outData .= "NULL"; // Cope with null values
}
else
{
// Accommodate for runtime magic quotes
if (function_exists('get_magic_quotes_runtime'))
{
$value = @get_magic_quotes_runtime() ? stripslashes($value) : $value;
}
switch ($columnTypes[$fieldName] ?? '')
{
// Hex encode spatial data
case 'BYTEA':
case 'JSONB':
case 'GEOMETRY':
case 'GEOGRAPHY':
case 'POINT':
case 'LINESTRING':
case 'POLYGON':
case 'MULTIPOINT':
case 'MULTILINESTRING':
case 'MULTIPOLYGON':
case 'GEOMETRYCOLLECTION':
$value = $db->quoteHex($value);
break;
// VARCHAR, CHAR, TEXT etc: the database makes sure it's quoted appropriately.
default:
$value = $db->quote($value);
break;
}
if ($this->postProcessValues)
{
$value = $this->postProcessQuotedValue($value);
}
$outData .= $value;
}
if ($fieldID < $numOfFields)
{
$outData .= ', ';
}
}
$outData .= ')';
if ($numOfFields)
{
// If it's an existing query and we have extended inserts
if ($this->extendedInserts && !$newQuery)
{
// Check the existing query size
$query_length = strlen($this->query);
$data_length = strlen($outData);
if (($query_length + $data_length) > $this->packetSize)
{
// We are about to exceed the packet size. Write the data so far.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$fieldList = $this->getFieldListSQL($columns);
$this->query = '';
$this->query = "INSERT INTO " . $db->nameQuote(
(!$this->useAbstractNames ? $this->nextTable->name : $this->nextTable->abstractName)
) . " {$fieldList} VALUES \n";
$this->query .= $outData;
}
else
{
// We have room for more data. Append $outData to the query.
$this->query .= ",\n";
$this->query .= $outData;
}
}
// If it's a brand new insert statement in an extended INSERTs set
elseif ($this->extendedInserts && $newQuery)
{
// Append the data to the INSERT statement
$this->query .= $outData;
// Let's see the size of the dumped data...
$query_length = strlen($this->query);
if ($query_length >= $this->packetSize)
{
// This was a BIG query. Write the data to disk.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$this->query = '';
}
}
// It's a normal (not extended) INSERT statement
else
{
// Append the data to the INSERT statement
$this->query .= $outData;
// Write the data to disk.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$this->query = '';
}
}
// Update the auto_increment value to avoid edge cases when the batch size is one
if (!is_null($this->table_autoincrement['field']))
{
$this->table_autoincrement['value'] = $myRow[$this->table_autoincrement['field']];
}
unset($myRow);
// Check for imminent timeout
if ($timer->getTimeLeft() <= 0)
{
Factory::getLog()
->debug(
"Breaking dump of {$this->nextTable->abstractName} after $numRows rows; will continue on next step"
);
break;
}
}
$db->freeResult($cursor);
// Advance the _nextRange pointer
$this->nextRange += ($numRows != 0) ? $numRows : 1;
$this->setStep($this->nextTable->name);
$this->setSubstep($this->nextRange . ' / ' . $this->maxRange);
}
// Finalize any pending query
// WARNING! If we do not do that now, the query will be emptied in the next operation and all
// accumulated data will go away...
if (!empty($this->query))
{
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
$this->query = '';
}
// Check for end of table dump (so that it happens inside the same operation)
if ($this->nextRange >= $this->maxRange)
{
// Tell the user we are done with the table
Factory::getLog()->debug("Done dumping " . $this->nextTable->abstractName);
// Output any data preamble commands, e.g. SET IDENTITY_INSERT for SQL Server
if ($this->nextTable->dumpContents && $this->createDropStatements)
{
Factory::getLog()->debug("Writing data dump epilogue for " . $this->nextTable->abstractName);
$epilogue = $this->getDataDumpEpilogue(
$this->nextTable->abstractName, $this->nextTable->name, $this->maxRange
);
if (!empty($epilogue) && !$this->writeDump($epilogue, true))
{
return;
}
}
if ($this->entities->isEmpty())
{
// We have finished dumping the database!
Factory::getLog()->info("End of database detected; flushing the dump buffers...");
$this->writeDump(null);
Factory::getLog()->info("Database has been successfully dumped to SQL file(s)");
$this->setState(self::STATE_POSTRUN);
$this->setStep('');
$this->setSubstep('');
$this->nextTable = null;
$this->nextRange = 0;
/**
* At the end of the database dump, if any query was longer than 1Mb, let's put a warning file in the
* installation folder, but ONLY if the backup is not a SQL-only backup (which has no backup archive).
*/
$isSQLOnly = $configuration->get('akeeba.basic.backup_type') == 'dbonly';
if (!$isSQLOnly && ($this->largest_query >= 1024 * 1024))
{
$archive = Factory::getArchiverEngine();
$archive->addFileVirtual(
'large_tables_detected', $this->installerSettings->installerroot, $this->largest_query
);
}
}
else
{
// Switch tables
$this->goToNextTable();
$this->setStep($this->nextTable->name);
$this->setSubstep('');
}
}
}
/**
* Detect the auto_increment field of the table being currently backed up.
*
* This method populates the $this->table_autoincrement array.
*
* @return void
*/
private function setAutoIncrementInfo(): void
{
$this->table_autoincrement = [
'table' => $this->nextTable,
'field' => null,
'value' => null,
];
$db = $this->getDB();
$query = 'SHOW COLUMNS FROM ' . $db->qn($this->nextTable->name) . ' WHERE ' . $db->qn('Extra') . ' = ' .
$db->q('auto_increment') . ' AND ' . $db->qn('Null') . ' = ' . $db->q('NO');
$keyInfo = $db->setQuery($query)->loadAssocList();
if (!empty($keyInfo))
{
$row = array_shift($keyInfo);
$this->table_autoincrement['field'] = $row['Field'];
}
}
/**
* Get the default database dump batch size from the configuration
*
* @return int
*/
private function getDefaultBatchSize(): ?int
{
$configuration = Factory::getConfiguration();
$batchSize = intval($configuration->get('engine.dump.common.batchsize', 100000));
if ($batchSize <= 0)
{
$batchSize = 100000;
}
return $batchSize;
}
/**
* Get the optimal row batch size for a given table based on the available memory
*
* @param string $tableAbstract The abstract table name, e.g. #__foobar
*
* @return int
*/
private function getOptimalBatchSize($tableAbstract)
{
$db = $this->getDB();
try
{
$info = $db->setQuery('SHOW TABLE STATUS LIKE ' . $db->q($tableAbstract))->loadAssoc();
}
catch (Exception $e)
{
return $this->defaultBatchSize;
}
if (!isset($info['Avg_row_length']) || empty($info['Avg_row_length']))
{
return $this->defaultBatchSize;
}
// That's the average row size as reported by MySQL.
$avgRow = str_replace([',', '.'], ['', ''], $info['Avg_row_length']);
// The memory available for manipulating data is less than the free memory
$memoryLimit = $this->getMemoryLimit();
$memoryLimit = empty($memoryLimit) ? 33554432 : $memoryLimit;
$usedMemory = memory_get_usage();
$memoryLeft = 0.75 * ($memoryLimit - $usedMemory);
// The 3.25 factor is empirical and leans on the safe side.
$maxRows = (int) ($memoryLeft / (3.25 * $avgRow));
return max(1, min($maxRows, $this->defaultBatchSize));
}
/**
* Applies the SQL compatibility setting
*
* @return void
*/
private function enforceSQLCompatibility()
{
try
{
$this->getDB()->setQuery('SET sql_big_selects=1')->query();
}
catch (Throwable $e)
{
// Do nothing; some versions of MySQL don't allow you to use the BIG_SELECTS option.
}
finally
{
$this->getDB()->resetErrors();
}
}
/**
* Gets the row count for table $tableAbstract. Also updates the $this->maxRange variable.
*
* @param string $tableAbstract The abstract name of the table (works with canonical names too, though)
*
* @return void
*
* @throws QueryException
*/
private function getRowCount($tableAbstract)
{
$db = $this->getDB();
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('COUNT(*)')
->from($db->nameQuote($tableAbstract));
$errno = 0;
$error = '';
try
{
$db->setQuery($sql);
$this->maxRange = $db->loadResult();
if (is_null($this->maxRange))
{
$errno = $db->getErrorNum();
$error = $db->getErrorMsg(false);
}
}
catch (Exception $e)
{
$this->maxRange = null;
$errno = $e->getCode();
$error = $e->getMessage();
}
if (is_null($this->maxRange))
{
Factory::getLog()->warning("Cannot get number of rows of $tableAbstract. MySQL error $errno: $error");
return;
}
Factory::getLog()->debug("Rows on " . $tableAbstract . " : " . $this->maxRange);
}
/**
* Return a list of columns and their data types.
*
* @param string $tableAbstract
*
* @return array An array of table columns and their data types.
*/
private function getColumnTypes($tableAbstract)
{
if ($this->lastTableColumnType == $tableAbstract)
{
return $this->columnListColumnType;
}
$this->lastTableColumnType = $tableAbstract;
try
{
$db = $this->getDB();
$db->setQuery('SHOW COLUMNS FROM ' . $db->qn($tableAbstract));
$tableCols = $db->loadAssocList();
}
catch (Exception $e)
{
return $this->columnListColumnType;
}
foreach ($tableCols as $col)
{
$typeParts = explode('(', $col['Type'], 2);
$this->columnListColumnType[$col['Field']] = strtoupper($typeParts[0]);
}
return $this->columnListColumnType;
}
}PK \\SQ Q 2 vendor/akeeba/engine/engine/Dump/Native/Sqlite.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native;
defined('AKEEBAENGINE') || die();
use RuntimeException;
/**
* Dump class for the "None" database driver (ie no database used by the application)
*/
#[\AllowDynamicProperties]
class Sqlite extends None
{
public function __construct()
{
parent::__construct();
throw new RuntimeException("Please do not add SQLite databases, they are files. If they are under your site's root they are backed up automatically. Otherwise use the Off-site Directories Inclusion to include them in the backup.");
}
}
PK \"I I A vendor/akeeba/engine/engine/Dump/Native/Pgsql/Adapter/Sistima.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\Pgsql\Adapter;
defined('AKEEBAENGINE') || die();
/**
* @since 10.3
*/
class Sistima implements AdapterInterface
{
public function diathesimo(): bool
{
return function_exists('system');
}
public function ektelesi(string $command, array &$output): int
{
$suffix = PHP_OS_FAMILY === 'Windows' ? '' : ' 2>&1';
$exitCode = -1;
ob_start();
@system($command . $suffix, $exitCode);
$result = ob_get_clean();
$output = explode("\n", rtrim($result));
return (int) $exitCode;
}
}
PK \"M M I vendor/akeeba/engine/engine/Dump/Native/Pgsql/Adapter/EktelesiKelifos.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\Pgsql\Adapter;
defined('AKEEBAENGINE') || die();
/**
* @since 10.3
*/
class EktelesiKelifos implements AdapterInterface
{
public function diathesimo(): bool
{
return function_exists('shell_exec');
}
public function ektelesi(string $command, array &$output): int
{
$suffix = PHP_OS_FAMILY === 'Windows' ? '' : ' 2>&1';
$result = @shell_exec($command . $suffix);
if ($result !== null)
{
$output = explode("\n", rtrim($result));
return 0;
}
$output = [];
return -1;
}
}
PK \nE E J vendor/akeeba/engine/engine/Dump/Native/Pgsql/Adapter/AdapterInterface.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\Pgsql\Adapter;
defined('AKEEBAENGINE') || die();
/**
* Διεπαφή μετατροπέα εκτέλεσης σε γραμμή εντολών.
*
* Comments are in Greek because shoddy av software throws false positives on certain English keywords.
*
* @since 10.3
*/
interface AdapterInterface
{
/**
* Επιστρέφει αληθές αν η συνάρτηση υπάρχει και είναι ενεργή.
*
* @return bool
* @since 10.3
*/
public function diathesimo(): bool;
/**
* Τρέχει την εντολή.
*
* @param string $command Προς εκτέλεση εντολή
* @param array &$output Συνδυασμένη κανονική έξοδος και έξοδος μηνυμάτων σφάλματος.
*
* @return int Ο κωδικός κατάστασης που επεστράφη. Η τιμή -1 δηλώνει μη διαθεσιμότητα.
* @since 10.3
*/
public function ektelesi(string $command, array &$output): int;
}
PK \lR R F vendor/akeeba/engine/engine/Dump/Native/Pgsql/Adapter/Diapernontas.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\Pgsql\Adapter;
defined('AKEEBAENGINE') || die();
/**
* @since 10.3
*/
class Diapernontas implements AdapterInterface
{
public function diathesimo(): bool
{
return function_exists('passthru');
}
public function ektelesi(string $command, array &$output): int
{
$suffix = PHP_OS_FAMILY === 'Windows' ? '' : ' 2>&1';
$exitCode = -1;
ob_start();
@passthru($command . $suffix, $exitCode);
$result = ob_get_clean();
$output = explode("\n", rtrim($result));
return (int) $exitCode;
}
}
PK \% F vendor/akeeba/engine/engine/Dump/Native/Pgsql/Adapter/ApliEktelesi.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\Pgsql\Adapter;
defined('AKEEBAENGINE') || die();
/**
* @since 10.3
*/
class ApliEktelesi implements AdapterInterface
{
public function diathesimo(): bool
{
return function_exists('exec');
}
public function ektelesi(string $command, array &$output): int
{
$suffix = PHP_OS_FAMILY === 'Windows' ? '' : ' 2>&1';
$exitCode = -1;
@exec($command . $suffix, $output, $exitCode);
return (int) $exitCode;
}
}
PK \Sʉ ? vendor/akeeba/engine/engine/Dump/Native/Pgsql/Adapter/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ 7 vendor/akeeba/engine/engine/Dump/Native/Pgsql/.htaccessnu 7m
Order allow,deny
Deny from all
PK \cy
6 vendor/akeeba/engine/engine/Dump/Native/Postgresql.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Dump\Base;
use Akeeba\Engine\Dump\Dependencies\Entity;
use Akeeba\Engine\Dump\Dependencies\Resolver;
use Akeeba\Engine\Dump\Native\MySQL\BadEntityNamesTrait;
use Akeeba\Engine\Dump\Native\MySQL\DropStatementTrait;
use Akeeba\Engine\Dump\Native\Pgsql\Adapter\AdapterInterface;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\Collection;
use Akeeba\Engine\Util\Phin;
use Countable;
use Exception;
use RuntimeException;
use Throwable;
/**
* PostgreSQL native dump engine adapter.
*/
class Postgresql extends Base
{
use BadEntityNamesTrait;
use DropStatementTrait;
/**
* The schema to use. Defaults to 'public'.
*
* @var string
* @since 10.3
*/
protected $schema = 'public';
/**
* The largest query encountered so far.
*
* @var string
* @since 10.3
*/
protected $largest_query = 0;
/**
* The database root filter path
* @var string|null
* @since 10.3
*/
private ?string $dbRoot;
/**
* The primary key structure of the currently backed up table. The keys contained are:
* - table The name of the table being backed up
* - field The name of the primary key field
* - value The last value of the PK field
*
* @var array
*/
protected $table_autoincrement = [
'table' => null,
'field' => null,
'value' => null,
];
/** @var Entity|null The next table or DB entity to back up */
protected $nextTable;
private $columnListColumnType = [];
private $columnListSelectColumn = '*';
private $lastTableColumnType = null;
private $lastTableSelectColumn = null;
private Collection $entities;
private bool $useAbstractNames;
private bool $mustFilterRows;
private bool $mustFilterContents;
private int $defaultBatchSize;
private bool $createDropStatements;
/**
* Constructor for the class.
*
* Initialises the database root directory based on configuration settings or defaults to '[SITEDB]'.
*
* @return void
* @since 10.3
*/
public function __construct()
{
parent::__construct();
$engineParams = Factory::getEngineParamsProvider();
$this->useAbstractNames = $engineParams->getScriptingParameter('db.abstractnames', 1) == 1;
$this->createDropStatements = $engineParams->getScriptingParameter('db.dropstatements', 0) == 1;
$this->dbRoot = Factory::getConfiguration()->get('volatile.database.root', '[SITEDB]');
$filters = Factory::getFilters();
$this->mustFilterRows = $filters->hasFilterType('dbobject', 'children');
$this->mustFilterContents = $filters->canFilterDatabaseRowContent();
$this->defaultBatchSize = $this->getDefaultBatchSize();
}
/**
* Get the current DB name, as reported by the DB server.
*
* @return string
*/
protected function getDatabaseNameFromConnection(): string
{
try
{
return $this->getDB()->setQuery('SELECT current_database()')->loadResult() ?: '';
}
catch (Throwable $e)
{
return '';
}
}
protected function getSchemaName(): string
{
if (empty($this->schema) && $this->schema !== '0')
{
$this->schema = $this->getSchemaNameFromConnection();
}
return $this->schema;
}
/**
* Get the current schema name, as reported by the DB server.
*
* @return string
*/
protected function getSchemaNameFromConnection(): string
{
try
{
return $this->getDB()->setQuery('SELECT current_schema()')->loadResult() ?: '';
}
catch (Throwable $e)
{
return 'public';
}
}
/**
* Return a list of columns to use in the SELECT query for dumping table data.
*
* This is used to filter out all generated rows.
*
* @param string $tableAbstract
*
* @return string|array An array of table columns, or the string literal '*' to quickly select all columns.
*
* @see https://dev.mysql.com/doc/refman/5.7/en/create-table-generated-columns.html
*/
protected function getSelectColumns($tableAbstract)
{
if ($this->lastTableSelectColumn === $tableAbstract)
{
return $this->columnListSelectColumn;
}
$this->lastTableSelectColumn = $tableAbstract;
$this->columnListSelectColumn = '*';
$db = $this->getDB();
try
{
$query = $db
->createQuery(true)
->select([
$db->quoteName('column_name'),
$db->quoteName('data_type'),
$db->quoteName('is_nullable'),
$db->quoteName('column_default'),
$db->quoteName('is_generated'),
$db->quoteName('is_updatable'),
])
->from($db->quoteName('information_schema.columns'))
->where([
$db->quoteName('table_catalog') . '=' . $db->quote($this->getDatabaseName()),
$db->quoteName('table_schema') . '=' . $db->quote($this->getSchemaName()),
$db->quoteName('table_name') . '=' . $db->quote($tableAbstract),
]);
$tableCols = $db->setQuery($query)->loadAssocList();
}
catch (Throwable $e)
{
return $this->columnListSelectColumn;
}
$totalColumns = empty($tableCols) ? 0 : count($tableCols);
$this->columnListSelectColumn = [];
foreach ($tableCols as $col)
{
// Skip over generated columns
if (strtoupper(trim($col['is_generated'] ?: '')) !== 'NEVER')
{
continue;
}
$this->columnListSelectColumn[] = $col['column_name'];
}
if ($totalColumns === count($this->columnListSelectColumn))
{
$this->columnListSelectColumn = '*';
}
return $this->columnListSelectColumn;
}
/**
* Returns a list of all tables in the database.
*
* @return array
* @since 10.3
*/
public function getAllTables(): array
{
$db = $this->getDB();
$query = $db->getQuery(true)
->select('table_name')
->from('information_schema.tables')
->where($db->quoteName('table_schema') . '=' . $db->quote($this->schema));
try
{
return $db->setQuery($query)->loadResultArray() ?: [];
}
catch (Throwable $e)
{
return [];
}
}
/**
* Method to retrieve tables and database objects that need to be backed up.
*
* This method populates the internal entity collection with information about
* tables, views, functions, procedures, and triggers within the current schema. It
* queries the information_schema for these entities and adds them to a backup list,
* filtering out any errors during the retrieval process without interrupting normal
* execution.
*
* @return void
* @since 10.3
*/
public function getTablesToBackup(): void
{
$db = $this->getDB();
$this->entities = new Collection();
$this->entities = $this->entities->merge($this->getRoutinesCollection('procedure'));
$this->entities = $this->entities->merge($this->getRoutinesCollection('function'));
$this->entities = $this->entities->merge(
$this->resolveDependencies($this->getTablesViewCollection())->values()
);
// Triggers are automatically dumped together with the table; there is no way to not dump them.
// $this->entities = $this->entities->merge($this->getRoutinesCollection('trigger'));
// Create a naming map
$this->table_name_map = array_combine(
$this->entities->map(fn(Entity $e) => $e->name)->toArray(),
$this->entities->map(fn(Entity $e) => $e->abstractName)->toArray()
);
/**
* Store all abstract entity names (tables, views, triggers etc) into a volatile variable, so we can fetch
* it later when creating the databases.json file
*/
if ($this->installerSettings->typedtablelist ?? false)
{
// BRS 10.x: typed list of entities
$typedEntityList = [];
/** @var \Akeeba\Engine\Dump\Dependencies\Entity $entity */
foreach ($this->entities as $entity)
{
$typedEntityList[$entity->getType()] ??= [];
$typedEntityList[$entity->getType()][] = $entity->getAbstractName();
}
Factory::getConfiguration()->set('volatile.database.table_names', $typedEntityList);
}
else
{
// Support for legacy installers: flat list of entity names
Factory::getConfiguration()->set('volatile.database.table_names', array_values($this->table_name_map));
}
}
/**
* Populate the next entity to back up.
*
* @return void
* @since 10.3
*/
protected function goToNextTable(): void
{
$this->nextTable = $this->entities->shift();
$this->nextRange = 0;
}
/**
* Prepares the engine for dumping the database.
*
* @since 10.3
*/
protected function _prepare()
{
parent::_prepare();
$this->schema = $this->_parametersArray['schema'] ?? $this->getSchemaName();
if (empty($this->schema))
{
$this->schema = 'public';
}
}
/**
* Main backup loop.
*/
protected function stepDatabaseDump(): void
{
$db = $this->getDB();
$configuration = Factory::getConfiguration();
$filters = Factory::getFilters();
if (!is_object($db) || ($db === false))
{
throw new RuntimeException(__CLASS__ . '::_run() Could not connect to database?!');
}
// Touch SQL dump file
$nada = "";
$this->writeline($nada);
// Get this table's information
$this->setStep($this->nextTable->name);
$this->setSubstep('');
// Restore any previously information about the largest query we had to run
$this->largest_query = Factory::getConfiguration()->get('volatile.database.largest_query', 0);
// If it is the first run, find number of rows and get the DDL.
if ($this->nextRange == 0)
{
try
{
$outCreate = $this->getCreateStatement(
$this->nextTable->abstractName, $this->nextTable->name, $this->nextTable->type, $this->createDropStatements
);
}
catch (Exception $e)
{
$outCreate = '';
}
if (empty($outCreate))
{
Factory::getLog()->warning(
sprintf(
"Cannot get the CREATE statement for %s %s -- skipping", $this->nextTable->type,
$this->nextTable->abstractName
)
);
$this->nextRange = 1;
$this->maxRange = 0;
}
else
{
$statements = $this->splitSql($outCreate);
$suffix = "/*ABDE:{$this->nextTable->abstractName}*/\n";
foreach ($statements as $statement)
{
if (!$this->writeDump($statement . $suffix, true))
{
return;
}
}
}
if ($this->nextTable->dumpContents)
{
// We are dumping data from a table, get the row count
$this->getRowCount($this->nextTable->abstractName);
// If we can't get the row count we cannot back up this table's data
if (is_null($this->maxRange))
{
Factory::getLog()->warning(
sprintf(
"Cannot get the row count for %s %s -- skipping data dump", $this->nextTable->type,
$this->nextTable->abstractName
)
);
$this->nextRange = 1;
$this->maxRange = 0;
}
}
else
{
/**
* Do NOT move this line to the if-block below. We need to only log this message on tables which are
* filtered, not on tables we simply cannot get the row count information for!
*/
Factory::getLog()->info(
sprintf("Skipping dumping data of %s %s", $this->nextTable->type, $this->nextTable->abstractName)
);
}
// The table is either filtered, or we cannot get the row count. Either way we should not dump any data.
if (!$this->nextTable->dumpContents)
{
$this->nextRange = 1;
$this->maxRange = 0;
}
// Output any data preamble commands, e.g. SET IDENTITY_INSERT for SQL Server
if ($this->nextTable->dumpContents && $this->createDropStatements)
{
$preamble = $this->getDataDumpPreamble(
$this->nextTable->abstractName, $this->nextTable->name, $this->maxRange
);
if (!empty($preamble))
{
Factory::getLog()->debug("Writing data dump preamble for " . $this->nextTable->abstractName);
if (!$this->writeDump($preamble, true))
{
return;
}
}
}
$this->nextRange ??= 0;
$this->maxRange ??= 0;
}
// Get the table's auto increment information
if ($this->nextTable->dumpContents && $this->nextRange < $this->maxRange)
{
$this->setAutoIncrementInfo();
}
// Get the default and the current (optimal) batch size
$batchSize = $configuration->get('volatile.database.batchsize', $this->defaultBatchSize);
// Check if we have more work to do on this table
if ($this->nextRange < $this->maxRange)
{
$timer = Factory::getTimer();
// Get the number of rows left to dump from the current table
$columns = $this->getSelectColumns($this->nextTable->abstractName);
$columnTypes = $this->getColumnTypes($this->nextTable->abstractName);
$columnsForQuery = is_array($columns) ? array_map([$db, 'qn'], $columns) : $columns;
$sql = $db->getQuery(true)
->select($columnsForQuery)
->from($db->nameQuote($this->nextTable->abstractName));
if (!is_null($this->table_autoincrement['field']))
{
$sql->order($db->qn($this->table_autoincrement['field']) . ' ASC');
}
if ($this->nextRange == 0)
{
// Get the optimal batch size for this table and save it to the volatile data
$batchSize = $this->getOptimalBatchSize($this->nextTable->abstractName);
$configuration->set('volatile.database.batchsize', $batchSize);
// First run, get a cursor to all records
$db->setQuery($sql, 0, $batchSize);
Factory::getLog()->info("Beginning dump of " . $this->nextTable->abstractName);
Factory::getLog()->debug("Up to $batchSize records will be read at once.");
}
else
{
// Subsequent runs, get a cursor to the rest of the records
$this->setSubstep($this->nextRange . ' / ' . $this->maxRange);
// If we have an auto_increment value and the table has over $batchsize records use the indexed select instead of a plain limit
if (!is_null($this->table_autoincrement['field']) && !is_null($this->table_autoincrement['value']))
{
Factory::getLog()
->info(
"Continuing dump of " . $this->nextTable->abstractName
. " from record #{$this->nextRange} using auto_increment column {$this->table_autoincrement['field']} and value {$this->table_autoincrement['value']}"
);
$sql->where(
$db->qn($this->table_autoincrement['field']) . ' > ' . $db->q(
$this->table_autoincrement['value']
)
);
$db->setQuery($sql, 0, $batchSize);
}
else
{
Factory::getLog()
->info(
"Continuing dump of " . $this->nextTable->abstractName
. " from record #{$this->nextRange}"
);
$db->setQuery($sql, $this->nextRange, $batchSize);
}
}
$this->query = '';
$numRows = 0;
try
{
$cursor = $db->query();
}
catch (Exception $exc)
{
// Issue a warning about the failure to dump data
$errno = $exc->getCode();
$error = $exc->getMessage();
Factory::getLog()->warning(
"Failed dumping {$this->nextTable->abstractName} from record #{$this->nextRange}. MySQL error $errno: $error"
);
// Reset the database driver's state (we will try to dump other tables anyway)
$db->resetErrors();
$cursor = null;
// Mark this table as done since we are unable to dump it.
$this->nextRange = $this->maxRange;
}
$statsTableAbstract = Platform::getInstance()->tableNameStats;
while (is_array($myRow = $db->fetchAssoc()) && ($numRows < ($this->maxRange - $this->nextRange)))
{
if (!$this->createNewPartIfRequired())
{
/**
* When createNewPartIfRequired returns false it means that we have began adding a SQL part to the
* backup archive but it hasn't finished. If we don't return here, the code below will keep adding
* data to that dump file. Yes, despite being closed. When you call writeDump the file is reopened.
* As a result of writing data of length Y, the file that had a size X now has a size of X + Y. This
* means that the loop in BaseArchiver which tries to add it to the archive will never see its End
* Of File since we are trying to resume the backup from *beyond* the file position that was
* recorded as the file size. The archive can detect a file shrinking but not a file growing!
* Therefore we hit an infinite loop a.k.a. runaway backup.
*/
return;
}
$numRows++;
$numOfFields = is_array($myRow) || $myRow instanceof Countable ? count($myRow) : 0;
// On MS SQL Server there's always a RowNumber pseudocolumn added at the end, screwing up the backup (GRRRR!)
if ($db->getDriverType() == 'mssql')
{
$numOfFields--;
}
if ($numOfFields === 0)
{
Factory::getLog()->warning(
sprintf(
"No columns for %s %s -- skipping data dump.",
$this->nextTable->type, $this->nextTable->abstractName
)
);
$numRows = $this->maxRange - $this->nextRange;
break;
}
// If row-level filtering is enabled, please run the filtering
if ($this->mustFilterRows)
{
$isFiltered = $filters->isFiltered(
[
'table' => $this->nextTable->abstractName,
'row' => $myRow,
],
$this->dbRoot,
'dbobject',
'children'
);
if ($isFiltered)
{
// Update the auto_increment value to avoid edge cases when the batch size is one
if (!is_null($this->table_autoincrement['field'])
&& isset($myRow[$this->table_autoincrement['field']]))
{
$this->table_autoincrement['value'] = $myRow[$this->table_autoincrement['field']];
}
continue;
}
}
if ($this->mustFilterContents)
{
$filters->filterDatabaseRowContent($this->dbRoot, $this->nextTable->abstractName, $myRow);
}
// Add header on simple INSERTs, or on extended INSERTs if there are no other data, yet
$newQuery = false;
if (
!$this->extendedInserts || ($this->extendedInserts && empty($this->query))
)
{
$newQuery = true;
$fieldList = $this->getFieldListSQL($columns);
$this->query = "INSERT INTO " . $db->nameQuote(
(!$this->useAbstractNames ? $this->nextTable->name : $this->nextTable->abstractName)
) . " {$fieldList} VALUES \n";
}
$outData = '(';
// Step through each of the row's values
$fieldID = 0;
// Used in running backup fix
$isCurrentBackupEntry = false;
// Fix 1.2a - NULL values were being skipped
foreach ($myRow as $fieldName => $value)
{
// The ID of the field, used to determine placement of commas
$fieldID++;
if ($fieldID > $numOfFields)
{
// This is required for SQL Server backups, do NOT remove!
continue;
}
// Fix 2.0: Mark currently running backup as successful in the DB snapshot
if ($this->nextTable->abstractName == $statsTableAbstract)
{
if ($fieldID == 1)
{
// Compare the ID to the currently running
$statistics = Factory::getStatistics();
$isCurrentBackupEntry = ($value == $statistics->getId());
}
elseif ($fieldID == 6)
{
// Treat the status field
$value = $isCurrentBackupEntry ? 'complete' : $value;
}
}
// Post-process the value
if (is_null($value))
{
$outData .= "NULL"; // Cope with null values
}
else
{
// Accommodate for runtime magic quotes
if (function_exists('get_magic_quotes_runtime'))
{
$value = @get_magic_quotes_runtime() ? stripslashes($value) : $value;
}
switch ($columnTypes[$fieldName] ?? '')
{
// Hex encode spatial data and special types
case 'BYTEA':
case 'JSONB':
case 'GEOMETRY':
case 'GEOGRAPHY':
case 'POINT':
case 'LINESTRING':
case 'POLYGON':
case 'MULTIPOINT':
case 'MULTILINESTRING':
case 'MULTIPOLYGON':
case 'GEOMETRYCOLLECTION':
$value = $db->quoteHex((string) $value);
break;
// VARCHAR, CHAR, TEXT etc: the database makes sure it's quoted appropriately.
default:
$value = $db->quote($value);
break;
}
if ($this->postProcessValues)
{
$value = $this->postProcessQuotedValue($value);
}
$outData .= $value;
}
if ($fieldID < $numOfFields)
{
$outData .= ', ';
}
}
$outData .= ')';
if ($numOfFields)
{
// If it's an existing query and we have extended inserts
if ($this->extendedInserts && !$newQuery)
{
// Check the existing query size
$query_length = strlen($this->query);
$data_length = strlen($outData);
if (($query_length + $data_length) > $this->packetSize)
{
// We are about to exceed the packet size. Write the data so far.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$fieldList = $this->getFieldListSQL($columns);
$this->query = '';
$this->query = "INSERT INTO " . $db->nameQuote(
(!$this->useAbstractNames ? $this->nextTable->name : $this->nextTable->abstractName)
) . " {$fieldList} VALUES \n";
$this->query .= $outData;
}
else
{
// We have room for more data. Append $outData to the query.
$this->query .= ",\n";
$this->query .= $outData;
}
}
// If it's a brand new insert statement in an extended INSERTs set
elseif ($this->extendedInserts && $newQuery)
{
// Append the data to the INSERT statement
$this->query .= $outData;
// Let's see the size of the dumped data...
$query_length = strlen($this->query);
if ($query_length >= $this->packetSize)
{
// This was a BIG query. Write the data to disk.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$this->query = '';
}
}
// It's a normal (not extended) INSERT statement
else
{
// Append the data to the INSERT statement
$this->query .= $outData;
// Write the data to disk.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$this->query = '';
}
}
// Update the auto_increment value to avoid edge cases when the batch size is one
if (!is_null($this->table_autoincrement['field']))
{
$this->table_autoincrement['value'] = $myRow[$this->table_autoincrement['field']];
}
unset($myRow);
// Check for imminent timeout
if ($timer->getTimeLeft() <= 0)
{
Factory::getLog()
->debug(
"Breaking dump of {$this->nextTable->abstractName} after $numRows rows; will continue on next step"
);
break;
}
}
$db->freeResult($cursor);
// Advance the _nextRange pointer
$this->nextRange += ($numRows != 0) ? $numRows : 1;
$this->setStep($this->nextTable->name);
$this->setSubstep($this->nextRange . ' / ' . $this->maxRange);
}
// Finalize any pending query
// WARNING! If we do not do that now, the query will be emptied in the next operation and all
// accumulated data will go away...
if (!empty($this->query))
{
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
$this->query = '';
}
// Check for end of table dump (so that it happens inside the same operation)
if ($this->nextRange >= $this->maxRange)
{
// Tell the user we are done with the table
Factory::getLog()->debug("Done dumping " . $this->nextTable->abstractName);
// Output any data preamble commands, e.g. SET IDENTITY_INSERT for SQL Server
if ($this->nextTable->dumpContents && $this->createDropStatements)
{
Factory::getLog()->debug("Writing data dump epilogue for " . $this->nextTable->abstractName);
$epilogue = $this->getDataDumpEpilogue(
$this->nextTable->abstractName, $this->nextTable->name, $this->maxRange
);
if (!empty($epilogue) && !$this->writeDump($epilogue, true))
{
return;
}
}
if ($this->entities->isEmpty())
{
// We have finished dumping the database!
Factory::getLog()->info("End of database detected; flushing the dump buffers...");
$this->writeDump(null);
Factory::getLog()->info("Database has been successfully dumped to SQL file(s)");
$this->setState(self::STATE_POSTRUN);
$this->setStep('');
$this->setSubstep('');
$this->nextTable = null;
$this->nextRange = 0;
/**
* At the end of the database dump, if any query was longer than 1Mb, let's put a warning file in the
* installation folder, but ONLY if the backup is not a SQL-only backup (which has no backup archive).
*/
$isSQLOnly = $configuration->get('akeeba.basic.backup_type') == 'dbonly';
if (!$isSQLOnly && ($this->largest_query >= 1024 * 1024))
{
$archive = Factory::getArchiverEngine();
$archive->addFileVirtual(
'large_tables_detected', $this->installerSettings->installerroot, $this->largest_query
);
}
}
else
{
// Switch tables
$this->goToNextTable();
$this->setStep($this->nextTable->name);
$this->setSubstep('');
}
}
}
/**
* Gets the DDL for an entity using pg_dump.
*/
protected function getCreateStatement(string $abstractName, string $tableName, string $type, bool $withDrop = false): string
{
$configuration = Factory::getConfiguration();
$pgDumpPath = $configuration->get(
'volatile.database.postgres.pgdump_path',
$configuration->get('engine.dump.postgres.pgdump_path', '')
);
if (empty($pgDumpPath) || !is_file($pgDumpPath))
{
$pgDumpPath = $this->findPgDump();
$configuration->set('volatile.database.postgres.pgdump_path', $pgDumpPath);
}
if (empty($pgDumpPath) || !is_file($pgDumpPath))
{
throw new RuntimeException("Cannot locate pg_dump; please review your backup profile configuration");
}
$db = $this->getDB();
$dbName = $this->database;
$host = $this->_parametersArray['host'] ?? 'localhost';
$port = $this->_parametersArray['port'] ?? '5432';
$user = $this->_parametersArray['user'] ?? ($this->_parametersArray['username'] ?? '');
$password = $this->_parametersArray['password'] ?? '';
$schema = $this->schema;
$command = escapeshellarg($pgDumpPath);
$command .= ' -s'; // Schema only
$command .= ' -O'; // Disable owner information
$command .= ' --no-comments'; // Disable comments
$command .= ' --no-policies'; // Disable dumping security policies
$command .= ' --no-security-labels'; // Disable dumping security labels
$command .= ' --quote-all-identifiers';
if ($withDrop)
{
$command .= ' --if-exists --clean';
}
$command .= ' --host=' . escapeshellarg($host);
$command .= ' --port=' . escapeshellarg($port);
$command .= ' --username=' . escapeshellarg($user);
if (!empty($schema))
{
$command .= ' --schema=' . escapeshellarg($schema);
}
$command .= ' --table=' . escapeshellarg($tableName);
$command .= ' ' . escapeshellarg($dbName);
// Set pw environment variable
$derp = Phin::artoo('EXENTTRCGZ');
$dorp = sprintf("%s=%s", $derp, $password);
putenv($dorp);
$output = [];
$exitCode = $this->ektelese($command, $output);
// Unset pw env var
putenv($derp);
if ($exitCode !== 0)
{
$errorMessage = implode(' ', $output);
$errorMessage = str_replace(["\r", "\n"], ' ', $errorMessage);
throw new RuntimeException("Failed to run pg_dump. Return code $exitCode, error: $errorMessage");
}
$sql = implode("\n", $output);
// Post-process the SQL to replace concrete table name with abstract name
$search = [
$db->quoteName($schema . '.' . $tableName),
$db->quoteName($tableName),
//$schema . '.' . $tableName,
//$tableName,
];
$replace = $db->quoteName($abstractName);
foreach ($search as $s)
{
$sql = str_replace($s, $replace, $sql);
}
// Also handle sequences and indexes that might start with the prefix
if (!empty($this->getPrefix()))
{
$sql = str_replace($db->quoteName($schema) . '."' . $this->getPrefix(), '"#__', $sql);
$sql = str_replace('"' . $this->getPrefix(), '"#__', $sql);
}
// Post-process the SQL
$lines = array_map('rtrim', explode("\n", $sql));
// -- Remove comments
$lines = array_filter($lines, function ($line) {
return strpos($line, '--') !== 0;
});
// -- Remove empty lines
$lines = array_filter($lines, function ($line) {
return trim($line) !== '';
});
// -- Remove lines starting with `\restrict` and `\unrestrict`
$lines = array_filter($lines, function ($line) {
return strpos($line, '\restrict') !== 0 && strpos($line, '\unrestrict') !== 0;
});
// -- Remove all lines starting with `SET ` or `SELECT ` and which end with a semicolon
$lines = array_filter($lines, function ($line) {
return !preg_match('/^(SET|SELECT).*;$/i', $line);
});
// -- Remove all ALTER ... OWNED BY statements
$lines = array_filter($lines, function ($line) {
return !preg_match('/^ALTER .* OWNED BY .*;$/i', $line);
});
// -- Remove all ALTER ... OWNER TO statements
$lines = array_filter($lines, function ($line) {
return !preg_match('/^ALTER .* OWNER TO .*;$/i', $line);
});
// -- Change all `CREATE ... "#__` to `CREATE ... IF NOT EXISTS "#__`
$lines = array_map(function ($line) {
// CREATE INDEX... must NOT be converted!!!
if (str_contains($line, 'CREATE INDEX'))
{
return $line;
}
return preg_replace('/^CREATE (.*) "#__/i', 'CREATE \1 IF NOT EXISTS "#__', $line);
}, $lines);
$sql = implode("\n", $lines);
return $sql;
}
/**
* Finds the path to the system's `pg_dump` executable using an OS-dependent method.
*
* @return ?string Path to pg_dump or null if not found
* @since 10.3
*/
protected function findPgDump(): ?string
{
if (PHP_OS_FAMILY === 'Windows')
{
return $this->findPgDumpWindows();
}
return $this->findPgDumpUnix();
}
/**
* Auto-detect `pg_dump.exe` on Windows.
*
* @return string|null The first match; `null` when nothing is found.
* @since 10.3
*/
protected function findPgDumpWindows(): ?string
{
// ------------------------------------------------------------------
// 1. Ask Windows "where pg_dump"
// ------------------------------------------------------------------
$output = [];
$exitCode = $this->ektelese('where pg_dump.exe 2>NUL', $output);
if ($exitCode === 0 && !empty($output))
{
// where.exe can return several matches; pick the first
$candidate = trim($output[0]);
if (is_file($candidate))
{
return $candidate;
}
}
// ------------------------------------------------------------------
// 2. Manually scan every directory in %PATH%
// ------------------------------------------------------------------
$pathEnv = getenv('PATH') ?: '';
$dirs = array_filter(array_map('trim', explode(PATH_SEPARATOR, $pathEnv)));
foreach ($dirs as $dir)
{
// Skip relative entries such as "."
if ($dir === '' || $dir === '.')
{
continue;
}
// Make sure we have a standard back-slash-terminated path
$candidate = rtrim($dir, "\\/") . DIRECTORY_SEPARATOR . 'pg_dump.exe';
if (is_file($candidate))
{
return $candidate;
}
// Also try without .exe for non-Windows systems
$candidate = rtrim($dir, "\\/") . DIRECTORY_SEPARATOR . 'pg_dump';
if (is_file($candidate))
{
return $candidate;
}
}
// Nothing found
return null;
}
/**
* Auto-detect `pg_dump` on Unix.
*
* @return string|null The first match; `null` when nothing is found.
* @since 10.3
*/
protected function findPgDumpUnix(): ?string
{
// ------------------------------------------------------------------
// 1. Ask Unix "which pg_dump"
// ------------------------------------------------------------------
$output = [];
$exitCode = $this->ektelese('which pg_dump 2>/dev/null', $output);
if ($exitCode === 0 && !empty($output))
{
$candidate = trim($output[0]);
if (is_file($candidate))
{
return $candidate;
}
}
// ------------------------------------------------------------------
// 2. Manually scan every directory in $PATH
// ------------------------------------------------------------------
$pathEnv = getenv('PATH') ?: '';
$dirs = array_filter(array_map('trim', explode(PATH_SEPARATOR, $pathEnv)));
foreach ($dirs as $dir)
{
// Skip relative entries such as "."
if ($dir === '' || $dir === '.')
{
continue;
}
$candidate = rtrim($dir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . 'pg_dump';
if (is_file($candidate))
{
return $candidate;
}
}
// Nothing found
return null;
}
/**
* Returns the number of rows in a table.
*
* @param string $tableAbstract
*
* @return void
* @throws Exception
* @since 10.3
*/
protected function getRowCount(string $tableAbstract): void
{
$db = $this->getDB();
$sql = "SELECT COUNT(*) FROM " . $db->quoteName($tableAbstract);
$errno = 0;
$error = '';
try
{
$db->setQuery($sql);
$this->maxRange = $db->loadResult();
if (is_null($this->maxRange))
{
$errno = $db->getErrorNum();
$error = $db->getErrorMsg(false);
}
}
catch (Throwable $e)
{
$this->maxRange = null;
$errno = $e->getCode();
$error = $e->getMessage();
}
if (is_null($this->maxRange))
{
Factory::getLog()->warning("Cannot get number of rows of $tableAbstract. MySQL error $errno: $error");
return;
}
Factory::getLog()->debug("Rows on " . $tableAbstract . " : " . $this->maxRange);
}
/**
* Returns the column types of a table.
*
* @param string $tableAbstract
*
* @return array
* @since 10.3
*/
protected function getColumnTypes($tableAbstract): array
{
$db = $this->getDB();
return array_map('strtoupper', $db->getTableColumns($tableAbstract, true));
}
/**
* Returns the optimal batch size for a table.
*
* TODO Not yet implemented for PostgreSQL
*
* @param string $abstractName
*
* @return int
* @since 10.3
*/
protected function getOptimalBatchSize($abstractName): int
{
return $this->defaultBatchSize;
}
/**
* Retrieves the concrete name of an entity based on its abstract name.
*
* @param string $abstractName The abstract name to be mapped to a concrete name
*
* @return string The concrete name corresponding to the abstract name, or the modified abstract name if not found
* @since 10.3
*/
protected function getConcreteName(string $abstractName): string
{
foreach ($this->entities as $entity)
{
if ($entity->abstractName == $abstractName)
{
return $entity->name;
}
}
return str_replace('#__', $this->getPrefix(), $abstractName);
}
/**
* Εκτελεί μια εντολή με την πρώτη διαθέσιμη μέθοδο.
*
* (I wrote that in Greek because shoddy av software throws false positives on certain English keywords).
*
* @param string $command The command to execute
* @param array &$output The output of the command
*
* @return int The exit code of the command
* @since 10.3
*/
private function ektelese(string $command, array &$output): int
{
/**
* These are deliberately in badly transliterated Greek to prevent false positives by shoddy av software. Yeah,
* I am not happy about it either.
*/
$sillogi = [
new Pgsql\Adapter\ApliEktelesi(),
new Pgsql\Adapter\EktelesiKelifos(),
new Pgsql\Adapter\Diapernontas(),
new Pgsql\Adapter\Sistima(),
];
/** @var AdapterInterface $antikimeno */
foreach ($sillogi as $antikimeno)
{
if (!$antikimeno->diathesimo())
{
continue;
}
return $antikimeno->ektelesi($command, $output);
}
$output = [];
return -1;
}
/**
* Get the default database dump batch size from the configuration
*
* @return int
* @since 10.3
*/
private function getDefaultBatchSize(): ?int
{
$configuration = Factory::getConfiguration();
$batchSize = intval($configuration->get('engine.dump.common.batchsize', 100000));
if ($batchSize <= 0)
{
$batchSize = 100000;
}
return $batchSize;
}
/**
* Get a collection with the routines of the specified type found in the database.
*
* The routines are returned in the default database order. We don't need a dependency resolver for them. See the
* linked GitHub issue.
*
* @param string $type The routine type (procedure, function)
*
* @return Collection
* @throws Exception
* @link https://github.com/akeeba/engine/issues/136
* @since 10.3
*/
private function getRoutinesCollection(string $type): Collection
{
$entities = new Collection();
$registry = Factory::getConfiguration();
$enableEntities = $registry->get('engine.dump.native.advanced_entitites', true);
if (!$enableEntities)
{
Factory::getLog()->debug(sprintf("%s :: NOT listing %ss (you told me not to)", __CLASS__, $type));
return $entities;
}
$db = $this->getDB();
$filters = Factory::getFilters();
Factory::getLog()->debug(
sprintf("%s :: Listing %ss", __CLASS__, strtoupper($type))
);
switch ($type)
{
case 'table':
$query = $db->getQuery(true)
->select([
$db->quoteName('table_name'),
])
->from($db->quoteName('information_schema.tables'))
->where([
$db->quoteName('table_catalog') . '=' . $db->quote($this->getDatabaseName()),
$db->quoteName('table_schema') . '=' . $db->quote($this->getSchemaName()),
]);
break;
case 'trigger':
$query = $db->getQuery(true)
->select([
$db->quoteName('trigger_name'),
])
->from($db->quoteName('information_schema.triggers'))
->where([
$db->quoteName('trigger_catalog') . '=' . $db->quote($this->getDatabaseName()),
$db->quoteName('trigger_schema') . '=' . $db->quote($this->getSchemaName()),
]);
break;
default:
$query = $db->getQuery(true)
->select([
$db->quoteName('routine_name'),
])
->from($db->quoteName('information_schema.routines'))
->where([
$db->quoteName('routine_catalog') . '=' . $db->quote($this->getDatabaseName()),
$db->quoteName('routine_schema') . '=' . $db->quote($this->getSchemaName()),
]);
break;
}
try
{
$allNames = $db->setQuery($query)->loadResultArray();
}
catch (Exception $e)
{
Factory::getLog()->debug(
sprintf("%s :: Cannot list %ss: %s", __CLASS__, strtoupper($type), $e->getMessage())
);
$db->resetErrors();
return $entities;
}
if (!is_countable($allNames) || !count($allNames))
{
Factory::getLog()->debug(
sprintf("%s :: No %ss found", __CLASS__, strtoupper($type))
);
return $entities;
}
foreach ($allNames as $name)
{
try
{
$entity = new Entity($type, $name, $this->getAbstract($name), false);
// Is the table/view name “bad”, preventing us from backing it up?
if ($this->isBadEntityName($entity->type, $entity->name))
{
// No need to log; the called method logs any bad naming reasons for us.
continue;
}
// Is the entity filtered?
if ($filters->isFiltered($entity->abstractName, $this->dbRoot, 'dbobject', 'all'))
{
Factory::getLog()->info(
sprintf(
"%s :: Skipping %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
continue;
}
// All good. Log it, and add it to the collection.
Factory::getLog()->info(
sprintf(
"%s :: Adding %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
$entities->push($entity);
}
catch (Throwable $e)
{
Factory::getLog()->warning(
sprintf(
'%s %s will not be backed up (%s)',
strtolower($type), $name, $e->getMessage()
)
);
}
}
return $entities;
}
/**
* Get a collection of all tables and views in the database
*
* @return Collection
* @throws RuntimeException|Exception
* @since 10.3
*/
private function getTablesViewCollection(): Collection
{
Factory::getLog()->debug(
sprintf("%s :: Listing tables and views", __CLASS__)
);
$db = $this->getDB();
// Get the names of all tables and views, along with the metadata I need to process them
try
{
$sql = $db->getQuery(true)
->select(
[
$db->quoteName('table_name', 'name'),
$db->quoteName('table_type', 'type'),
]
)
->from($db->quoteName('information_schema.tables'))
->where([
$db->quoteName('table_catalog') . '=' . $db->quote($this->getDatabaseName()),
$db->quoteName('table_schema') . '=' . $db->quote($this->getSchemaName()),
]);
$meta = $db->setQuery($sql)->loadObjectList();
}
catch (Throwable $e)
{
throw new RuntimeException(
sprintf('Cannot list tables and views for database %s', $this->database),
500,
$e
);
}
// Create an entities collection, keyed by the concrete table/view name.
$entities = new Collection();
$filters = Factory::getFilters();
foreach ($meta as $tableMeta)
{
try
{
$entity = new Entity($tableMeta->type, $tableMeta->name, $this->getAbstract($tableMeta->name));
// Is the table/view name “bad”, preventing us from backing it up?
if ($this->isBadEntityName($entity->type, $entity->name))
{
// No need to log; the called method logs any bad naming reasons for us.
continue;
}
// Is the entity filtered?
if ($filters->isFiltered($entity->abstractName, $this->dbRoot, 'dbobject', 'all'))
{
Factory::getLog()->info(
sprintf(
"%s :: Skipping %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
continue;
}
// All good. Log it and add it to the collection.
Factory::getLog()->info(
sprintf(
"%s :: Adding %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
$entities->put(
$entity->name,
$entity->setDumpContents($this->canDumpData($entity->type, $entity->abstractName))
);
}
catch (Throwable $e)
{
Factory::getLog()->warning(
sprintf(
'%s %s will not be backed up (%s)',
strtolower($tableMeta->type), $tableMeta->name, $e->getMessage()
)
);
}
}
return $entities;
}
/**
* Are we allowed to dump the data of this table or view?
*
* @param string $type Entity type: view or table
* @param string|null $abstractName The abstract table/view name
*
* @return bool
* @since 10.3
*/
private function canDumpData(string $type, ?string $abstractName): bool
{
static $filters = null;
$filters ??= Factory::getFilters();
// We cannot dump data of views, foreign tables, or local temporary tables
if (strtolower($type) !== 'base table' && strtolower($type) !== 'table')
{
return false;
}
// User-defined filters for everything else
return !$filters->isFiltered($abstractName, $this->dbRoot, 'dbobject', 'content');
}
/**
* Resolve the table/view dependencies, and return the collection sorted by the resolved order.
*
* @param Collection $entities The unsorted entities collection
*
* @return Collection The sorted entities collection
*/
private function resolveDependencies(Collection $entities): Collection
{
// Am I allowed to track dependencies?
if (Factory::getConfiguration()->get('engine.dump.native.nodependencies', 0))
{
Factory::getLog()->debug(
__CLASS__
. " :: Dependency tracking is disabled. Tables will be backed up in the default database order."
);
return $entities;
}
Factory::getLog()->debug(__CLASS__ . " :: Processing table and view dependencies.");
// Generate a dependencies collection
$resolver = new Resolver($entities->mapPreserve(fn(Entity $entity): array => [])->toArray());
// Get the table dependency information from the database
$db = $this->getDB();
$schemaName = $db->quote($this->getSchemaName());
$sql = /** @lang PostgreSQL */
<<< PostgreSQL
SELECT DISTINCT
kcu1.table_name AS dependent,
kcu2.table_name AS dependency
FROM
information_schema.referential_constraints rc
JOIN
information_schema.key_column_usage kcu1
ON rc.constraint_name = kcu1.constraint_name
JOIN
information_schema.key_column_usage kcu2
ON rc.unique_constraint_name = kcu2.constraint_name
AND kcu1.ordinal_position = kcu2.ordinal_position
WHERE
kcu1.table_schema = $schemaName
PostgreSQL;
try
{
$rawDependencies = $db->setQuery($sql)->loadObjectList();
}
catch (Throwable $e)
{
Factory::getLog()->warning(
__CLASS__
. " :: Cannot process table dependencies in the database. Tables will be backed up in the default database order."
);
$db->resetErrors();
return $entities;
}
// Get the view dependency information from the database
$useAlternateViewScanner = false;
$sql = /** @lang PostgreSQL */
<<< PostgreSQL
SELECT DISTINCT
view_name AS dependent,
table_name AS dependency
FROM
information_schema.view_table_usage
WHERE
view_schema = $schemaName
AND table_schema = view_schema;
PostgreSQL;
try
{
$rawViewDependencies = $db->setQuery($sql)->loadObjectList();
}
catch (Throwable $e)
{
Factory::getLog()->warning(
__CLASS__
. " :: Cannot process view dependencies in the database. Tables will be backed up in the default database order."
);
$db->resetErrors();
return $entities;
}
$rawDependencies = array_merge($rawDependencies, $rawViewDependencies);
// Push the dependencies into the tree, and resolve it
foreach ($rawDependencies as $dependency)
{
$resolver->add($dependency->dependent, $dependency->dependency);
}
$orderedKeys = $resolver->resolve();
// Create and return an ordered collection
$orderedCollection = new Collection();
foreach ($orderedKeys as $key)
{
if (!$entities->has($key))
{
continue;
}
$value = $entities->get($key, null);
if ($value === null)
{
continue;
}
$entities->forget($key);
$orderedCollection->put($key, $value);
}
return $orderedCollection;
}
/**
* Detect the auto_increment field of the table being currently backed up.
*
* This does not do anything in Postgres databases.
*
* @return void
*/
private function setAutoIncrementInfo(): void
{
$this->table_autoincrement = [
'table' => $this->nextTable,
'field' => null,
'value' => null,
];
}
/**
* Splits a SQL string into individual statements, taking into account PostgreSQL-specific quoting.
*
* The quoting taken into account is dollar quoting and single quotes.
*
* @param string $sql The SQL string to split
*
* @return array An array of SQL statements
*/
private function splitSql(string $sql): array
{
$statements = [];
$current = '';
$isInString = false;
$dollarTag = null;
$len = strlen($sql);
for ($i = 0; $i < $len; $i++)
{
$char = $sql[$i];
$current .= $char;
// Handle single quotes (standard SQL strings)
if ($char === "'" && !$dollarTag)
{
if ($isInString)
{
// PostgreSQL escapes a single quote by doubling it ('').
if ($i + 1 < $len && $sql[$i + 1] === "'")
{
$current .= $sql[$i + 1];
$i++;
continue;
}
$isInString = false;
}
else
{
$isInString = true;
}
}
// Handle dollar quoting ($$ or $tag$)
if ($char === '$' && !$isInString)
{
if ($dollarTag !== null)
{
// We are inside a dollar-quoted block, check if this is the end tag
$tagLen = strlen($dollarTag);
if (substr($sql, $i, $tagLen) === $dollarTag)
{
$current .= substr($sql, $i + 1, $tagLen - 1);
$i += $tagLen - 1;
$dollarTag = null;
}
}
else
{
// We are not in a quote, check if this is an opening dollar tag
if (preg_match('/^\$([a-zA-Z0-9_]*)\$/', substr($sql, $i), $matches))
{
$dollarTag = $matches[0];
$current .= substr($sql, $i + 1, strlen($dollarTag) - 1);
$i += strlen($dollarTag) - 1;
}
}
}
// If we find a semicolon and we are not in any quote, it's a statement terminator
if ($char === ';' && !$isInString && $dollarTag === null)
{
$statements[] = trim($current);
$current = '';
}
}
$current = trim($current);
if ($current !== '')
{
$statements[] = $current;
}
return $statements;
}
}
PK \|. 4 vendor/akeeba/engine/engine/Dump/Native/Oldmysql.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Driver\QueryException;
use Akeeba\Engine\Dump\Base;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Exception;
use RuntimeException;
/**
* A generic MySQL database dump class.
* Now supports views; merge, in-memory, federated, blackhole, etc tables
* Configuration parameters:
* host MySQL database server host name or IP address
* port MySQL database server port (optional)
* username MySQL user name, for authentication
* password MySQL password, for authentication
* database MySQL database
* dumpFile Absolute path to dump file; must be writable (optional; if left blank it is
* automatically calculated)
*/
#[\AllowDynamicProperties]
class Oldmysql extends Base
{
/**
* The primary key structure of the currently backed up table. The keys contained are:
* - table The name of the table being backed up
* - field The name of the primary key field
* - value The last value of the PK field
*
* @var array
*/
protected $table_autoincrement = [
'table' => null,
'field' => null,
'value' => null,
];
private $columnListColumnType = [];
private $columnListSelectColumn = '*';
private $lastTableColumnType = null;
private $lastTableSelectColumn = null;
/**
* Implements the constructor of the class
*
* @return void
*/
public function __construct()
{
parent::__construct();
Factory::getLog()->debug(__CLASS__ . " :: New instance");
}
/**
* Replaces the table names in the CREATE query with their abstract form. Optionally updates dependencies.
*
* @param string $tableName The table name the CREATE query is for
* @param string $tableSql The CREATE query itself
* @param bool $withDependecies Should I update dependencies?
*
* @return array [$dependencies, $modifiedSQLQuery] - Dependency information for the table (if $withDependencies)
* and the new CREATE query with all table names replaced with abstract versions.
*
* @throws Exception When we cannot get the DB object
*/
public function replaceTableNamesWithAbstracts($tableName, $tableSql, $withDependecies = false)
{
// Initialization
$dependencies = [];
$tableNameMap = $this->table_name_map;
$db = $this->getDB();
if (!array_key_exists($tableName, $tableNameMap))
{
$tableNameMap[$tableName] = $this->getAbstract($tableName);
}
foreach ($tableNameMap as $fullName => $abstractName)
{
$quotedFullName = $db->quoteName($fullName);
$quotedAbstractName = $db->quoteName($abstractName);
$pos = strpos($tableSql, $quotedFullName);
$numReplacements = 0;
if ($pos !== false)
{
$numReplacements = 1;
// Do the replacement
$tableSql = str_replace($quotedFullName, $quotedAbstractName, $tableSql);
}
elseif (!is_numeric($fullName))
{
$offset = 0;
$fullNameLength = strlen($fullName);
$quotedAbstractNameLength = strlen($quotedAbstractName);
/**
* We need to detect the edges of table names. If they are enclosed in backticks it's pretty clear. If they are
* not, e.g. in the definitions of TRIGGERs, we need to base our detection on the valid characters for
* unquoted MySQL table names per https://dev.mysql.com/doc/refman/5.7/en/identifiers.html
*/
[$bareCharRegex, $regexFlags] = $this->getMySQLIdentifierCharacterRegEx();
$fullCharRegex = "/$bareCharRegex/$regexFlags";
while (true)
{
$pos = strpos($tableSql, $fullName, $offset);
if ($pos === false)
{
break;
}
// Skip over table-name-like strings in strings enclosed by single quotes
$quotePos = strpos($tableSql, "'", $offset);
if ($quotePos !== false && $quotePos < $pos)
{
// The table-like token is inside a string. Find its end.
while (true)
{
$nextPos = strpos($tableSql, "'", $quotePos + 1);
if ($nextPos === false)
{
break;
}
$prevChar = $nextPos > 0 ? $tableSql[$nextPos - 1] : null;
$nextChar = strlen($tableSql) > $nextPos + 1 ? $tableSql[$nextPos + 1] : null;
// Catch quote escaped as \'
if ($prevChar === '\\')
{
$quotePos = $nextPos;
continue;
}
// Catch quote escaped as ''
if ($nextChar === "'")
{
$quotePos = $nextPos + 1;
continue;
}
$offset = $nextPos + 1;
continue 2;
}
}
// Skip over table-name-like strings in strings enclosed by double quotes
$quotePos = strpos($tableSql, '"', $offset);
if ($quotePos !== false && $quotePos < $pos)
{
// The table-like token is inside a string. Find its end.
while (true)
{
$nextPos = strpos($tableSql, '"', $quotePos + 1);
if ($nextPos === false)
{
break;
}
$prevChar = $nextPos > 0 ? $tableSql[$nextPos - 1] : null;
$nextChar = strlen($tableSql) > $nextPos + 1 ? $tableSql[$nextPos + 1] : null;
// Catch quote escaped as \"
if ($prevChar === '\\')
{
$quotePos = $nextPos;
continue;
}
// Catch quote escaped as ""
if ($nextChar === '"')
{
$quotePos = $nextPos + 1;
continue;
}
$offset = $nextPos + 1;
continue 2;
}
}
// Catch table-name-like substring inside another table's name
$previousChar = ($pos > 0) ? substr($tableSql, $pos - 1, 1) : '';
$nextChar = ($pos < (strlen($tableSql) - $fullNameLength)) ? substr($tableSql, $pos + $fullNameLength, 1) : '';
$prevIsTableChar = $previousChar === '' ? false : preg_match($fullCharRegex, $previousChar);
$nextIsTableChar = $nextChar === '' ? false : preg_match($fullCharRegex, $nextChar);
if ($prevIsTableChar || $nextIsTableChar)
{
$offset = $pos + 1;
continue;
}
$before = ($pos > 0) ? substr($tableSql, 0, $pos) : '';
$after = ($pos < (strlen($tableSql) - $fullNameLength)) ? substr($tableSql, $pos + $fullNameLength) : '';
$numReplacements++;
$tableSql = $before . $quotedAbstractName . $after;
$offset = $pos + $quotedAbstractNameLength;
}
}
if ($withDependecies && $numReplacements && ($fullName != $tableName))
{
// Add a reference hit
$this->dependencies[$fullName][] = $tableName;
// Add the dependency to this table's metadata
$dependencies[] = $fullName;
}
}
return [$dependencies, $tableSql];
}
/**
* Creates a drop query from a CREATE query
*
* @param string $query The CREATE query to process
*
* @return string The DROP statement
*/
protected function createDrop($query)
{
$type = $this->getTypeFromCreateQuery($query);
if (empty($type))
{
return '';
}
$marker = ' ' . strtoupper(trim($type)) . ' ';
$markerPosition = strpos($query, $marker);
// Rest of query, after entity key string
$restOfQuery = trim(substr($query, $markerPosition + strlen($marker)));
// Is there a backtick?
if (substr($restOfQuery, 0, 1) == '`')
{
// There is a backtick. Iterate character-by-character to find the ending backtick.
$pos = 0;
while (true)
{
$pos++;
// We need visibility in both of the next characters to find escaped backticks.
$thisChar = substr($restOfQuery, $pos, 1);
$nextChar = substr($restOfQuery, $pos + 1, 1);
// Did we reach the end of the string?
if ($thisChar === false || $thisChar === '')
{
break;
}
// Two backticks side-by-side is an escaped backtick; skip over it
if ($thisChar === '`' && $nextChar === '`')
{
$pos++;
continue;
}
// Current char is a backtick, the next one is not, we found the ending backtick.
if ($thisChar === '`' && $nextChar !== '`')
{
break;
}
}
$entityName = substr($restOfQuery, 1, $pos - 1);
}
else
{
// Nope, let's assume the entity name ends in the next blank character.
$pos = strpos($restOfQuery, ' ', 1);
$entityName = substr($restOfQuery, 0, $pos);
}
return sprintf(
"DROP %s IF EXISTS %s;",
strtoupper(trim($type)),
$this->getDB()->nameQuote($entityName)
);
}
/**
* Applies the SQL compatibility setting
*
* @return void
*/
protected function enforceSQLCompatibility()
{
$db = $this->getDB();
// Try to enforce SQL_BIG_SELECTS option
try
{
$db->setQuery('SET sql_big_selects=1');
$db->query();
}
catch (Exception $e)
{
// Do nothing; some versions of MySQL don't allow you to use the BIG_SELECTS option.
}
$db->resetErrors();
}
/**
* Return a list of columns and their data types.
*
* @param string $tableAbstract
*
* @return array An array of table columns and their data types.
*/
protected function getColumnTypes($tableAbstract)
{
if ($this->lastTableColumnType == $tableAbstract)
{
return $this->columnListColumnType;
}
$this->lastTableColumnType = $tableAbstract;
try
{
$db = $this->getDB();
$db->setQuery('SHOW COLUMNS FROM ' . $db->qn($tableAbstract));
$tableCols = $db->loadAssocList();
}
catch (Exception $e)
{
return $this->columnListColumnType;
}
foreach ($tableCols as $col)
{
$typeParts = explode('(', $col['Type'], 2);
$this->columnListColumnType[$col['Field']] = strtoupper($typeParts[0]);
}
return $this->columnListColumnType;
}
/**
* Return the current database name by querying the database connection object (e.g. SELECT DATABASE() in MySQL)
*
* @return string
*/
protected function getDatabaseNameFromConnection(): string
{
$db = $this->getDB();
try
{
$ret = $db->setQuery('SELECT DATABASE()')->loadResult();
}
catch (Exception $e)
{
return '';
}
return empty($ret) ? '' : $ret;
}
/**
* Get the default database dump batch size from the configuration
*
* @return int
*/
protected function getDefaultBatchSize()
{
static $batchSize = null;
if (is_null($batchSize))
{
$configuration = Factory::getConfiguration();
$batchSize = intval($configuration->get('engine.dump.common.batchsize', 1000));
if ($batchSize <= 0)
{
$batchSize = 1000;
}
}
return $batchSize;
}
/**
* Get a regular expression and its options for valid characters of an unquoted MySQL identifier.
*
* This is used wherever we need to detect an arbitrary, unquoted MySQL identifier per
* https://dev.mysql.com/doc/refman/5.7/en/identifiers.html
*
* Also what if Unicode support is not compiled in PCRE? In this case we will fall back to a much simpler regex
* which only supports the ASCII subset of the allowed characters. In this case your database dump will be wrong
* if you use table names with non-ASCII characters.
*
* Since the detection is horribly slow we cache its results in an internal static variable.
*
* @return array In the format [$regex, $flags]
* @since 7.0.0
*/
protected function getMySQLIdentifierCharacterRegEx()
{
static $validCharRegEx = null;
static $unicodeFlag = null;
if (is_null($validCharRegEx) || is_null($unicodeFlag))
{
$noUnicode = @preg_match('/\p{L}/u', 'σ') !== 1;
$unicodeFlag = $noUnicode ? '' : 'u';
$validCharRegEx = $noUnicode ? '[0-9a-zA-Z$_]' : '[0-9a-zA-Z$_]|[\x{0080}-\x{FFFF}]';
}
return [$validCharRegEx, $unicodeFlag];
}
/**
* Get the optimal row batch size for a given table based on the available memory
*
* @param string $tableAbstract The abstract table name, e.g. #__foobar
* @param int $defaultBatchSize The default row batch size in the application configuration
*
* @return int
*/
protected function getOptimalBatchSize($tableAbstract, $defaultBatchSize)
{
$db = $this->getDB();
try
{
$info = $db->setQuery('SHOW TABLE STATUS LIKE ' . $db->q($tableAbstract))->loadAssoc();
}
catch (Exception $e)
{
return $defaultBatchSize;
}
if (!isset($info['Avg_row_length']) || empty($info['Avg_row_length']))
{
return $defaultBatchSize;
}
// That's the average row size as reported by MySQL.
$avgRow = str_replace([',', '.'], ['', ''], $info['Avg_row_length']);
// The memory available for manipulating data is less than the free memory
$memoryLimit = $this->getMemoryLimit();
$memoryLimit = empty($memoryLimit) ? 33554432 : $memoryLimit;
$usedMemory = memory_get_usage();
$memoryLeft = 0.75 * ($memoryLimit - $usedMemory);
// The 3.25 factor is empirical and leans on the safe side.
$maxRows = (int) ($memoryLeft / (3.25 * $avgRow));
return max(1, min($maxRows, $defaultBatchSize));
}
/**
* Gets the row count for table $tableAbstract. Also updates the $this->maxRange variable.
*
* @param string $tableAbstract The abstract name of the table (works with canonical names too, though)
*
* @return void
*
* @throws QueryException
*/
protected function getRowCount($tableAbstract)
{
$db = $this->getDB();
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select('COUNT(*)')
->from($db->nameQuote($tableAbstract));
$errno = 0;
$error = '';
try
{
$db->setQuery($sql);
$this->maxRange = $db->loadResult();
if (is_null($this->maxRange))
{
$errno = $db->getErrorNum();
$error = $db->getErrorMsg(false);
}
}
catch (Exception $e)
{
$this->maxRange = null;
$errno = $e->getCode();
$error = $e->getMessage();
}
if (is_null($this->maxRange))
{
Factory::getLog()->warning("Cannot get number of rows of $tableAbstract. MySQL error $errno: $error");
return;
}
Factory::getLog()->debug("Rows on " . $tableAbstract . " : " . $this->maxRange);
}
/**
* Return a list of columns to use in the SELECT query for dumping table data.
*
* This is used to filter out all generated rows.
*
* @param string $tableAbstract
*
* @return string|array An array of table columns or the string literal '*' to quickly select all columns.
*
* @see https://dev.mysql.com/doc/refman/5.7/en/create-table-generated-columns.html
*/
protected function getSelectColumns($tableAbstract)
{
if ($this->lastTableSelectColumn == $tableAbstract)
{
return $this->columnListSelectColumn;
}
$this->lastTableSelectColumn = $tableAbstract;
try
{
$db = $this->getDB();
$db->setQuery('SHOW COLUMNS FROM ' . $db->qn($tableAbstract));
$tableCols = $db->loadAssocList();
}
catch (Exception $e)
{
return $this->columnListSelectColumn;
}
$totalColumns = is_array($tableCols) || $tableCols instanceof \Countable ? count($tableCols) : 0;
$this->columnListSelectColumn = [];
$hasInvisibleColumns = false;
foreach ($tableCols as $col)
{
// Skip over generated columns
$attribs = array_map('strtoupper', empty($col['Extra']) ? [] : explode(' ', $col['Extra']));
if (in_array('GENERATED', $attribs))
{
continue;
}
if (in_array('INVISIBLE', $attribs))
{
$hasInvisibleColumns = true;
}
$this->columnListSelectColumn[] = $col['Field'];
}
if (!$hasInvisibleColumns && ($totalColumns == count($this->columnListSelectColumn)))
{
$this->columnListSelectColumn = '*';
}
return $this->columnListSelectColumn;
}
/**
* Scans the database for tables to be backed up and sorts them according to
* their dependencies on one another. Updates $this->dependencies.
*
* @return void
*/
protected function getTablesToBackup(): void
{
// Makes the MySQL connection compatible with our class
$this->enforceSQLCompatibility();
$configuration = Factory::getConfiguration();
$notracking = $configuration->get('engine.dump.native.nodependencies', 0);
// First, get a map of table names <--> abstract names
$this->populateTableNameMap();
if ($notracking)
{
// Do not process table & view dependencies
$this->populateTablesDataWithoutDependencies();
}
// Process table & view dependencies (default)
else
{
// Find the type and CREATE command of each table/view in the database
$this->populateTablesData();
// Process dependencies and rearrange tables respecting them
$this->processDependencies();
// Remove dependencies array
$this->dependencies = [];
}
}
/**
* Gets the CREATE TABLE command for a given table, view, procedure, event, function, or trigger.
*
* @param string $abstractName The abstracted name of the entity.
* @param string $concreteName The concrete (database) name of the entity.
* @param string $type The type of the entity to scan. May be updated.
* @param array $dependencies The dependencies of this entity.
*
* @return string|null The CREATE statement
*/
protected function getCreateStatement(
string $abstractName, string $concreteName, string &$type, array &$dependencies
): ?string
{
$db = $this->getDB();
$sql = sprintf("SHOW CREATE %s %s", strtoupper($type), $db->quoteName($abstractName));
$db->setQuery($sql);
try
{
$temp = $db->loadAssocList();
}
catch (Exception $e)
{
// If the query failed we don't have the necessary SHOW privilege. Log the error and fake an empty reply.
$entityType = ($type == 'merge') ? 'table' : $type;
$msg = $e->getMessage();
Factory::getLog()->warning(
"Cannot get the structure of $entityType $abstractName. Database returned error $msg running $sql Please check your database privileges. Your database backup may be incomplete."
);
$db->resetErrors();
$temp = [
['', '', ''],
];
}
$columnKey = 'Create ' . ucfirst(strtolower($type));
$table_sql = $temp[0][$columnKey] ?? null;
if ($table_sql === null)
{
$columnId = $type === 'event' ? 3 : 2;
$table_sql = array_values($temp[0])[$columnId] ?? null;
}
unset($temp);
if (empty($table_sql))
{
Factory::getLog()->warning(
"Cannot get the structure of $type $abstractName. The database refused to return the CREATE command for this $type. Please check your database privileges. Your database backup may be incomplete."
);
return null;
}
Factory::getLog()->debug(
sprintf(
'Got create for %s %s (internal name %s)',
$type,
$concreteName,
$abstractName
)
);
$isEntity = in_array($type, ['procedure', 'event', 'function', 'trigger']);
$type = (!$isEntity && $this->isCreateView($table_sql)) ? 'view' : $type;
switch ($type)
{
case 'procedure':
case 'event':
case 'function':
case 'trigger':
$table_sql = $this->preProcessCreateSQLForEntity($table_sql, $type);
break;
case 'view':
$table_sql = $this->preProcessCreateSQLForView($table_sql);
break;
case 'table':
case 'merge':
default:
$table_sql = $this->preProcessCreateSQLForTable($table_sql);
}
$configuration = Factory::getConfiguration();
$noTracking = $configuration->get('engine.dump.native.nodependencies', 0);
// On DB only backup we don't want to replace table / view / entity names with abstracts.
$mustAbstractTableNames = Factory::getEngineParamsProvider()->getScriptingParameter('db.abstractnames', 1);
/**
* Replace table name and names of referenced tables with their abstracted forms and populate dependency tables
* at the same time.
*/
if (!$mustAbstractTableNames)
{
$old_table_sql = $table_sql;
}
/**
* Abstract table names AND update dependency tracking information.
*
* Because this updates the tracking information we can not skip it when $mustAbstractTableNames is false. This
* is why we restore $table_sql in this case, and this case only.
*
* We have to quote the table name. If we don't we'll get wrong results. Imagine that you have a column whose
* name starts with the string literal of the table name itself.
*
* Example: table `poll`, column `poll_id` would become #__poll, #__poll_id
*
* By quoting before we make sure this won't happen.
*/
[$dependencies, $table_sql] = $this->replaceTableNamesWithAbstracts($concreteName, $table_sql, !$noTracking);
if (!$mustAbstractTableNames)
{
$table_sql = $old_table_sql;
}
return $this->postProcessCreateSQL($table_sql, $type);
}
/**
* Populate the table and entities metadata.
*
* This method updates $this->tables_data with the metadata of MySQL tables, views, procedures, events, functions,
* and triggers. The metadata include the CREATE SQL statement, and whether to dump data.
*
* Moreover, the dependency information is generated as part of this process.
*
* @return void
*/
protected function populateTablesData()
{
Factory::getLog()->debug(__CLASS__ . " :: Starting CREATE TABLE and dependency scanning");
// Get a database connection
$db = $this->getDB();
Factory::getLog()->debug(__CLASS__ . " :: Got database connection");
// Reset internal tables
$this->tables_data = [];
$this->dependencies = [];
$registry = Factory::getConfiguration();
// Get a list of tables where their engine type is shown
$this->generateMetadataForTables();
// If we have MySQL > 5.0 add stored procedures, events, functions and triggers
$enable_entities = $registry->get('engine.dump.native.advanced_entitites', true);
if ($enable_entities)
{
Factory::getLog()->debug(__CLASS__ . " :: Listing MySQL entities");
$this->generateMetadataForEntity('procedure');
$this->generateMetadataForEntity('event');
$this->generateMetadataForEntity('function');
$this->generateMetadataForEntity('trigger');
Factory::getLog()->debug(__CLASS__ . " :: Got MySQL entities list");
}
}
/**
* Populates the _tables array with the metadata of each table.
* Updates $this->tables_data and $this->tables.
*
* @return void
*/
protected function populateTablesDataWithoutDependencies()
{
Factory::getLog()->debug(__CLASS__ . " :: Pushing table data (without dependency tracking)");
// Reset internal tables
$this->tables_data = [];
$this->dependencies = [];
// Get filters and filter root
$registry = Factory::getConfiguration();
$root = $registry->get('volatile.database.root', '[SITEDB]');
$filters = Factory::getFilters();
foreach ($this->table_name_map as $table_name => $table_abstract)
{
$new_entry = [
'type' => 'table',
'dump_records' => true,
];
// Table Data Filter: skip dumping table contents of filtered out tables
if ($filters->isFiltered($table_abstract, $root, 'dbobject', 'content'))
{
$new_entry['dump_records'] = false;
}
$this->tables_data[$table_name] = $new_entry;
$this->tables[] = $table_name;
}
Factory::getLog()->debug(__CLASS__ . " :: Got table list");
}
/**
* Generate a map of table/entity names to their abstract versions.
*
* This method updates $this->table_name_map
*
* @return void
*/
protected function populateTableNameMap(): void
{
// Get a database connection
Factory::getLog()->debug(__CLASS__ . " :: Finding tables to include in the backup set");
// Reset internal tables
$this->table_name_map = [];
$registry = Factory::getConfiguration();
$enableEntities = $registry->get('engine.dump.native.advanced_entitites', true);
$noTracking = $registry->get('engine.dump.native.nodependencies', 0);
// Generate mapping for tables and views
$this->generateMappingForEntities('table');
/**
* If configured, we will process MySQL procedures, events, functions, and triggers.
*
* However, if dependency tracking is disabled we cannot do that, as we cannot guarantee that the result will
* be possible to be restored.
*/
if (!$enableEntities)
{
Factory::getLog()->debug(__CLASS__ . " :: NOT listing stored PROCEDUREs, FUNCTIONs and TRIGGERs (you told me not to)");
}
elseif ($noTracking != 0)
{
Factory::getLog()->debug(__CLASS__ . " :: NOT listing stored PROCEDUREs, FUNCTIONs and TRIGGERs (you have disabled dependency tracking, therefore I can't handle advanced entities)");
}
else
{
Factory::getLog()->debug(__CLASS__ . " :: Finding stored PROCEDUREs, EVENTs, FUNCTIONs and TRIGGERs to include in the backup set");
$this->generateMappingForEntities('procedure');
$this->generateMappingForEntities('event');
$this->generateMappingForEntities('function');
$this->generateMappingForEntities('trigger');
}
/**
* Store all abstract entity names (tables, views, triggers etc) into a volatile variable, so we can fetch
* it later when creating the databases.json file
*/
ksort($this->table_name_map);
$registry->set('volatile.database.table_names', array_values($this->table_name_map));
/**
* IMPORTANT -- DO NOT REMOVE
*
* We now need to reverse sort the table_name_map. This is of paramount importance in how the
* replaceTableNamesWithAbstracts method works. Consider the following case:
* foo_test_2 => #__test_2
* foo_test_20 => #__test_20
* If foo_test_2 comes before foo_test_2 (alpha sort) the CREATE command of foo_test_20 will end up as
* CREATE TABLE ``#__test_2`0` (...)
* instead of the correct
* CREATE TABLE `#__test_20` (...)
* That's because the first table replacement done there will be foo_test_2 => `#__test_2`. Ouch.
*
* By doing a reverse alpha sort on the keys we ENSURE that the longer table names which may be a superset of
* another table's name will always end up first on the list.
*
* In our example the first replacement made is foo_test_20 => `#__test_20`. When we reach the next possible
* replacement (foo_test_2) we no longer have the concrete table name foo_test_2 therefore we won't accidentally
* break the CREATE command.
*
* Of course the same replacement problem exists within VIEWs, TRIGGERs, PROCEDUREs and FUNCTIONs. Again, the
* reverse alpha sort by concrete table name solves this issue elegantly.
*/
krsort($this->table_name_map);
}
/**
* Process all table dependencies
*
* @return void
*/
protected function processDependencies()
{
if (!is_countable($this->table_name_map) || !count($this->table_name_map))
{
Factory::getLog()->debug(__CLASS__ . " :: No dependencies to process");
return;
}
foreach ($this->table_name_map as $table_name => $table_abstract)
{
$this->push_table($table_name);
}
Factory::getLog()->debug(__CLASS__ . " :: Processed dependencies");
}
/**
* Push an entity into the stack, taking dependencies into account.
*
* This method pushes an entity into the $this->tables stack, making sure it will appear after its dependencies.
* Other entities depending on it will eventually appear after it.
*
* WARNING! Circular dependencies WILL fail on restoration, unless they were only caused by foreign keys (checking
* foreign keys consistency is disabled during restoration). Anything else cannot be handled as it would require
* knowing the previous state(s) of the schema, replaying them during restoration. For what it's worth, this kind of
* circular dependencies won't work with phpMyAdmin, mysqldump etc. Circular references are evil, insane, and
* should always be avoided!
*
* @param string $tableName The canonical name of the table to push.
* @param array $stack When called recursive, other views/tables previously processed to detect
* *ahem* dependency loops...
*
* @return void
*/
protected function push_table($tableName, $stack = [], $currentRecursionDepth = 0)
{
if (!isset($this->tables_data[$tableName]))
{
return;
}
// Load information
$table_data = $this->tables_data[$tableName];
if (array_key_exists('dependencies', $table_data))
{
$referenced = $table_data['dependencies'];
}
else
{
$referenced = [];
}
unset($table_data);
// Try to find the minimum insert position, so as to appear after the last referenced table
$insertpos = false;
if (is_array($referenced) || $referenced instanceof \Countable ? count($referenced) : 0)
{
foreach ($referenced as $referenced_table)
{
if (is_array($this->tables) || $this->tables instanceof \Countable ? count($this->tables) : 0)
{
$newpos = array_search($referenced_table, $this->tables);
if ($newpos !== false)
{
if ($insertpos === false)
{
$insertpos = $newpos;
}
else
{
$insertpos = max($insertpos, $newpos);
}
}
}
}
}
// Add to the tables array
if ((is_array($this->tables) || $this->tables instanceof \Countable ? count($this->tables) : 0) && ($insertpos !== false))
{
array_splice($this->tables, $insertpos + 1, 0, $tableName);
}
else
{
$this->tables[] = $tableName;
}
// Here's what... Some other table/view might depend on us, so we must appear
// before it (actually, it must appear after us). So, we scan for such
// tables/views and relocate them
if (is_array($this->dependencies) || $this->dependencies instanceof \Countable ? count($this->dependencies) : 0)
{
if (array_key_exists($tableName, $this->dependencies))
{
foreach ($this->dependencies[$tableName] as $depended_table)
{
// First, make sure that either there is no stack, or the
// depended table doesn't belong it. In any other case, we
// were fooled to follow an endless dependency loop and we
// will simply bail out and let the user sort things out.
if (count($stack) > 0)
{
if (in_array($depended_table, $stack))
{
continue;
}
}
$my_position = array_search($tableName, $this->tables);
$remove_position = array_search($depended_table, $this->tables);
if (($remove_position !== false) && ($remove_position < $my_position))
{
$stack[] = $tableName;
array_splice($this->tables, $remove_position, 1);
// Where should I put the other table/view now? Don't tell me.
// I have to recurse...
if ($currentRecursionDepth < 19)
{
$this->push_table($depended_table, $stack, ++$currentRecursionDepth);
}
else
{
// We're hitting a circular dependency. We'll add the removed $depended_table
// in the penultimate position of the table and cross our virtual fingers...
array_splice($this->tables, (is_array($this->tables) || $this->tables instanceof \Countable ? count($this->tables) : 0) - 1, 0, $depended_table);
}
}
}
}
}
}
/**
* Detect the auto_increment field of the table being currently backed up.
*
* This method populates the $this->table_autoincrement array.
*
* @return void
*/
protected function setAutoIncrementInfo()
{
$this->table_autoincrement = [
'table' => $this->nextTable,
'field' => null,
'value' => null,
];
$db = $this->getDB();
$query = 'SHOW COLUMNS FROM ' . $db->qn($this->nextTable) . ' WHERE ' . $db->qn('Extra') . ' = ' .
$db->q('auto_increment') . ' AND ' . $db->qn('Null') . ' = ' . $db->q('NO');
$keyInfo = $db->setQuery($query)->loadAssocList();
if (!empty($keyInfo))
{
$row = array_shift($keyInfo);
$this->table_autoincrement['field'] = $row['Field'];
}
}
/**
* Performs one more step of dumping database data
*
* @return void
*
* @throws QueryException
* @throws Exception
*/
protected function stepDatabaseDump(): void
{
// Initialize local variables
$db = $this->getDB();
if (!is_object($db) || ($db === false))
{
throw new RuntimeException(__CLASS__ . '::_run() Could not connect to database?!');
}
$outData = ''; // Used for outputting INSERT INTO commands
$this->enforceSQLCompatibility(); // Apply MySQL compatibility option
// Touch SQL dump file
$nada = "";
$this->writeline($nada);
// Get this table's information
$tableName = $this->nextTable;
$this->setStep($tableName);
$this->setSubstep('');
$tableAbstract = trim($this->table_name_map[$tableName]);
$dump_records = $this->tables_data[$tableName]['dump_records'];
// Restore any previously information about the largest query we had to run
$this->largest_query = Factory::getConfiguration()->get('volatile.database.largest_query', 0);
// If it is the first run, find number of rows and get the CREATE TABLE command
if ($this->nextRange == 0)
{
$outCreate = '';
if (is_array($this->tables_data[$tableName]))
{
if (array_key_exists('create', $this->tables_data[$tableName]))
{
$outCreate = $this->tables_data[$tableName]['create'];
}
}
if (empty($outCreate) && !empty($tableName))
{
// The CREATE command wasn't cached. Time to create it. The $type and $dependencies
// variables will be thrown away.
$type = $this->tables_data[$tableName]['type'] ?? 'table';
$dependencies = [];
$outCreate = $this->getCreateStatement($tableAbstract, $tableName, $type, $dependencies);
}
// Create drop statements if required (the key is defined by the scripting engine)
if (!empty($outCreate) && Factory::getEngineParamsProvider()->getScriptingParameter('db.dropstatements', 0))
{
if (array_key_exists('create', $this->tables_data[$tableName]))
{
$dropStatement = $this->createDrop($this->tables_data[$tableName]['create']);
}
else
{
$type = 'table';
$createStatement = $this->getCreateStatement($tableAbstract, $tableName, $type, $dependencies);
$dropStatement = $this->createDrop($createStatement);
}
if (!empty($dropStatement))
{
$dropStatement .= "\n";
if (!$this->writeDump($dropStatement, true))
{
return;
}
}
}
/**
* If we have a PROCEDURE, FUNCTION or TRIGGER and we are doing a SQL export meant to be run directly by
* MySQL (the scripting db.delimiterstatements flag is set to 1) we need to surround the CREATE statement
* with DELIMITER $$ commands.
*/
if (
!empty($outCreate) &&
(Factory::getEngineParamsProvider()->getScriptingParameter('db.delimiterstatements', 0) == 1)
&& in_array($this->tables_data[$tableName]['type'], ['trigger', 'function', 'event', 'procedure'])
)
{
$outCreate = rtrim($outCreate, ";\n");
$outCreate = "DELIMITER $$\n$outCreate$$\nDELIMITER ;\n";
}
// Write the CREATE command after any DROP command which might be necessary.
if (!empty($outCreate) && !$this->writeDump($outCreate, true))
{
return;
}
if (!empty($outCreate) && $dump_records)
{
// We are dumping data from a table, get the row count
$this->getRowCount($tableAbstract);
// If we can't get the row count we cannot back up this table's data
if (is_null($this->maxRange))
{
$dump_records = false;
}
}
elseif (!$dump_records)
{
/**
* Do NOT move this line to the if-block below. We need to only log this message on tables which are
* filtered, not on tables we simply cannot get the row count information for!
*/
Factory::getLog()->info("Skipping dumping data of " . $tableAbstract);
}
// The table is either filtered or we cannot get the row count. Either way we should not dump any data.
if (!$dump_records || empty($outCreate))
{
$this->maxRange = 0;
$this->nextRange = 1;
$outData = '';
$numRows = 0;
$dump_records = false;
}
// Output any data preamble commands, e.g. SET IDENTITY_INSERT for SQL Server
if ($dump_records && Factory::getEngineParamsProvider()->getScriptingParameter('db.dropstatements', 0))
{
Factory::getLog()->debug("Writing data dump preamble for " . $tableAbstract);
$preamble = $this->getDataDumpPreamble($tableAbstract, $tableName, $this->maxRange);
if (!empty($preamble))
{
if (!$this->writeDump($preamble, true))
{
return;
}
}
}
// Get the table's auto increment information
if ($dump_records)
{
$this->setAutoIncrementInfo();
}
}
// Load the active database root
$configuration = Factory::getConfiguration();
$dbRoot = $configuration->get('volatile.database.root', '[SITEDB]');
// Get the default and the current (optimal) batch size
$defaultBatchSize = $this->getDefaultBatchSize();
$batchSize = $configuration->get('volatile.database.batchsize', $defaultBatchSize);
// Check if we have more work to do on this table
if (($this->nextRange < $this->maxRange))
{
$timer = Factory::getTimer();
// Get the number of rows left to dump from the current table
$columns = $this->getSelectColumns($tableAbstract);
$columnTypes = $this->getColumnTypes($tableAbstract);
$columnsForQuery = is_array($columns) ? array_map([$db, 'qn'], $columns) : $columns;
$sql = (method_exists($db, 'createQuery') ? $db->createQuery() : $db->getQuery(true))
->select($columnsForQuery)
->from($db->nameQuote($tableAbstract));
if (!is_null($this->table_autoincrement['field']))
{
$sql->order($db->qn($this->table_autoincrement['field']) . ' ASC');
}
if ($this->nextRange == 0)
{
// Get the optimal batch size for this table and save it to the volatile data
$batchSize = $this->getOptimalBatchSize($tableAbstract, $defaultBatchSize);
$configuration->set('volatile.database.batchsize', $batchSize);
// First run, get a cursor to all records
$db->setQuery($sql, 0, $batchSize);
Factory::getLog()->info("Beginning dump of " . $tableAbstract);
Factory::getLog()->debug("Up to $batchSize records will be read at once.");
}
else
{
// Subsequent runs, get a cursor to the rest of the records
$this->setSubstep($this->nextRange . ' / ' . $this->maxRange);
// If we have an auto_increment value and the table has over $batchsize records use the indexed select instead of a plain limit
if (!is_null($this->table_autoincrement['field']) && !is_null($this->table_autoincrement['value']))
{
Factory::getLog()
->info("Continuing dump of " . $tableAbstract . " from record #{$this->nextRange} using auto_increment column {$this->table_autoincrement['field']} and value {$this->table_autoincrement['value']}");
$sql->where($db->qn($this->table_autoincrement['field']) . ' > ' . $db->q($this->table_autoincrement['value']));
$db->setQuery($sql, 0, $batchSize);
}
else
{
Factory::getLog()
->info("Continuing dump of " . $tableAbstract . " from record #{$this->nextRange}");
$db->setQuery($sql, $this->nextRange, $batchSize);
}
}
$this->query = '';
$numRows = 0;
$use_abstract = Factory::getEngineParamsProvider()->getScriptingParameter('db.abstractnames', 1);
$filters = Factory::getFilters();
$mustFilterRows = $filters->hasFilterType('dbobject', 'children');
$mustFilterContents = $filters->canFilterDatabaseRowContent();
try
{
$cursor = $db->query();
}
catch (Exception $exc)
{
// Issue a warning about the failure to dump data
$errno = $exc->getCode();
$error = $exc->getMessage();
Factory::getLog()->warning("Failed dumping $tableAbstract from record #{$this->nextRange}. MySQL error $errno: $error");
// Reset the database driver's state (we will try to dump other tables anyway)
$db->resetErrors();
$cursor = null;
// Mark this table as done since we are unable to dump it.
$this->nextRange = $this->maxRange;
}
$statsTableAbstract = Platform::getInstance()->tableNameStats;
while (is_array($myRow = $db->fetchAssoc()) && ($numRows < ($this->maxRange - $this->nextRange)))
{
if ($this->createNewPartIfRequired() == false)
{
/**
* When createNewPartIfRequired returns false it means that we have began adding a SQL part to the
* backup archive but it hasn't finished. If we don't return here, the code below will keep adding
* data to that dump file. Yes, despite being closed. When you call writeDump the file is reopened.
* As a result of writing data of length Y, the file that had a size X now has a size of X + Y. This
* means that the loop in BaseArchiver which tries to add it to the archive will never see its End
* Of File since we are trying to resume the backup from *beyond* the file position that was
* recorded as the file size. The archive can detect a file shrinking but not a file growing!
* Therefore we hit an infinite loop a.k.a. runaway backup.
*/
return;
}
$numRows++;
$numOfFields = is_array($myRow) || $myRow instanceof \Countable ? count($myRow) : 0;
// On MS SQL Server there's always a RowNumber pseudocolumn added at the end, screwing up the backup (GRRRR!)
if ($db->getDriverType() == 'mssql')
{
$numOfFields--;
}
// If row-level filtering is enabled, please run the filtering
if ($mustFilterRows)
{
$isFiltered = $filters->isFiltered(
[
'table' => $tableAbstract,
'row' => $myRow,
],
$dbRoot,
'dbobject',
'children'
);
if ($isFiltered)
{
// Update the auto_increment value to avoid edge cases when the batch size is one
if (!is_null($this->table_autoincrement['field']) && isset($myRow[$this->table_autoincrement['field']]))
{
$this->table_autoincrement['value'] = $myRow[$this->table_autoincrement['field']];
}
continue;
}
}
if ($mustFilterContents)
{
$filters->filterDatabaseRowContent($dbRoot, $tableAbstract, $myRow);
}
if (
(!$this->extendedInserts) || // Add header on simple INSERTs, or...
($this->extendedInserts && empty($this->query)) //...on extended INSERTs if there are no other data, yet
)
{
$newQuery = true;
$fieldList = $this->getFieldListSQL($columns);
if ($numOfFields > 0)
{
$this->query = "INSERT INTO " . $db->nameQuote((!$use_abstract ? $tableName : $tableAbstract)) . " {$fieldList} VALUES \n";
}
}
else
{
// On other cases, just mark that we should add a comma and start a new VALUES entry
$newQuery = false;
}
$outData = '(';
// Step through each of the row's values
$fieldID = 0;
// Used in running backup fix
$isCurrentBackupEntry = false;
// Fix 1.2a - NULL values were being skipped
if ($numOfFields > 0)
{
foreach ($myRow as $fieldName => $value)
{
// The ID of the field, used to determine placement of commas
$fieldID++;
if ($fieldID > $numOfFields)
{
// This is required for SQL Server backups, do NOT remove!
continue;
}
// Fix 2.0: Mark currently running backup as successful in the DB snapshot
if ($tableAbstract == $statsTableAbstract)
{
if ($fieldID == 1)
{
// Compare the ID to the currently running
$statistics = Factory::getStatistics();
$isCurrentBackupEntry = ($value == $statistics->getId());
}
elseif ($fieldID == 6)
{
// Treat the status field
$value = $isCurrentBackupEntry ? 'complete' : $value;
}
}
// Post-process the value
if (is_null($value))
{
$outData .= "NULL"; // Cope with null values
}
else
{
// Accommodate for runtime magic quotes
if (function_exists('get_magic_quotes_runtime'))
{
$value = @get_magic_quotes_runtime() ? stripslashes($value) : $value;
}
switch ($columnTypes[$fieldName] ?? '')
{
// Hex encode spatial data
case 'GEOMETRY':
case 'POINT':
case 'LINESTRING':
case 'POLYGON':
case 'MULTIPOINT':
case 'MULTILINESTRING':
case 'MULTIPOLYGON':
case 'GEOMETRYCOLLECTION':
$hexEncoded = bin2hex($value);
$value = "x'$hexEncoded'";
break;
default:
$value = $db->quote($value);
break;
}
if ($this->postProcessValues)
{
$value = $this->postProcessQuotedValue($value);
}
$outData .= $value;
}
if ($fieldID < $numOfFields)
{
$outData .= ', ';
}
}
}
$outData .= ')';
if ($numOfFields)
{
// If it's an existing query and we have extended inserts
if ($this->extendedInserts && !$newQuery)
{
// Check the existing query size
$query_length = strlen($this->query);
$data_length = strlen($outData);
if (($query_length + $data_length) > $this->packetSize)
{
// We are about to exceed the packet size. Write the data so far.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$fieldList = $this->getFieldListSQL($columns);
$this->query = '';
$this->query = "INSERT INTO " . $db->nameQuote((!$use_abstract ? $tableName : $tableAbstract)) . " {$fieldList} VALUES \n";
$this->query .= $outData;
}
else
{
// We have room for more data. Append $outData to the query.
$this->query .= ",\n";
$this->query .= $outData;
}
}
// If it's a brand new insert statement in an extended INSERTs set
elseif ($this->extendedInserts && $newQuery)
{
// Append the data to the INSERT statement
$this->query .= $outData;
// Let's see the size of the dumped data...
$query_length = strlen($this->query);
if ($query_length >= $this->packetSize)
{
// This was a BIG query. Write the data to disk.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$this->query = '';
}
}
// It's a normal (not extended) INSERT statement
else
{
// Append the data to the INSERT statement
$this->query .= $outData;
// Write the data to disk.
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
// Then, start a new query
$this->query = '';
}
}
$outData = '';
// Update the auto_increment value to avoid edge cases when the batch size is one
if (!is_null($this->table_autoincrement['field']))
{
$this->table_autoincrement['value'] = $myRow[$this->table_autoincrement['field']];
}
unset($myRow);
// Check for imminent timeout
if ($timer->getTimeLeft() <= 0)
{
Factory::getLog()
->debug("Breaking dump of $tableAbstract after $numRows rows; will continue on next step");
break;
}
}
$db->freeResult($cursor);
// Advance the _nextRange pointer
$this->nextRange += ($numRows != 0) ? $numRows : 1;
$this->setStep($tableName);
$this->setSubstep($this->nextRange . ' / ' . $this->maxRange);
}
// Finalize any pending query
// WARNING! If we do not do that now, the query will be emptied in the next operation and all
// accumulated data will go away...
if (!empty($this->query))
{
$this->query .= ";\n";
if (!$this->writeDump($this->query, true))
{
return;
}
$this->query = '';
}
// Check for end of table dump (so that it happens inside the same operation)
if ($this->nextRange >= $this->maxRange)
{
// Tell the user we are done with the table
Factory::getLog()->debug("Done dumping " . $tableAbstract);
// Output any data preamble commands, e.g. SET IDENTITY_INSERT for SQL Server
if ($dump_records && Factory::getEngineParamsProvider()->getScriptingParameter('db.dropstatements', 0))
{
Factory::getLog()->debug("Writing data dump epilogue for " . $tableAbstract);
$epilogue = $this->getDataDumpEpilogue($tableAbstract, $tableName, $this->maxRange);
if (!empty($epilogue))
{
if (!$this->writeDump($epilogue, true))
{
return;
}
}
}
if ((is_array($this->tables) || $this->tables instanceof \Countable ? count($this->tables) : 0) == 0)
{
// We have finished dumping the database!
Factory::getLog()->info("End of database detected; flushing the dump buffers...");
$this->writeDump(null);
Factory::getLog()->info("Database has been successfully dumped to SQL file(s)");
$this->setState(self::STATE_POSTRUN);
$this->setStep('');
$this->setSubstep('');
$this->nextTable = '';
$this->nextRange = 0;
/**
* At the end of the database dump, if any query was longer than 1Mb, let's put a warning file in the
* installation folder, but ONLY if the backup is not a SQL-only backup (which has no backup archive).
*/
$isSQLOnly = $configuration->get('akeeba.basic.backup_type') == 'dbonly';
if (!$isSQLOnly && ($this->largest_query >= 1024 * 1024))
{
$archive = Factory::getArchiverEngine();
$archive->addFileVirtual('large_tables_detected', $this->installerSettings->installerroot, $this->largest_query);
}
}
elseif ((is_array($this->tables) || $this->tables instanceof \Countable ? count($this->tables) : 0) != 0)
{
// Switch tables
$this->nextTable = array_shift($this->tables);
$this->nextRange = 0;
$this->setStep($this->nextTable);
$this->setSubstep('');
}
}
}
/** @inheritDoc */
protected function getAllTables(): array
{
// Get a database connection
$db = $this->getDB();
$this->enforceSQLCompatibility();
$sql = 'SHOW TABLES';
$db->setQuery($sql);
return $db->loadColumn() ?: [];
}
/**
* Get the MySQL entity type given a `CREATE ` SQL query.
*
* @param string $query
*
* @return string|null
*/
private function getTypeFromCreateQuery(string $query): ?string
{
if (substr($query, 0, 7) !== 'CREATE ')
{
return null;
}
foreach (['TABLE', 'VIEW', 'PROCEDURE', 'EVENT', 'FUNCTION', 'TRIGGER'] as $entity)
{
if (strpos($query, ' ' . $entity . ' ', 7))
{
return strtolower($entity);
}
}
return null;
}
/**
* Generate metadata for TABLEs and VIEWs
*
* @return void
* @throws Exception
*/
private function generateMetadataForTables(): void
{
$db = $this->getDB();
$sql = 'SHOW TABLES';
$db->setQuery($sql);
$allTableNames = $db->loadResultArray(0);
Factory::getLog()->debug(__CLASS__ . " :: Got SHOW TABLES");
// Get filters and filter root
$registry = Factory::getConfiguration();
$root = $registry->get('volatile.database.root', '[SITEDB]');
$filters = Factory::getFilters();
foreach ($allTableNames as $tableName)
{
// Skip over tables not included in the backup set
if (!array_key_exists($tableName, $this->table_name_map))
{
continue;
}
// Basic information
$abstractName = $this->table_name_map[$tableName];
$newEntry = [
'type' => 'table',
'dump_records' => true,
];
// Get the CREATE command
$dependencies = [];
$newEntry['create'] = $this->getCreateStatement($abstractName, $tableName, $newEntry['type'], $dependencies);
if ($newEntry['create'] === null)
{
continue;
}
$newEntry['dependencies'] = $dependencies;
if ($newEntry['type'] === 'view')
{
$newEntry['dump_records'] = false;
}
// Scan for the table engine.
if ($newEntry['type'] === 'table')
{
switch ($this->getTableEngineFromCreateStatement($newEntry['create']))
{
// Merge tables
case 'MRG_MYISAM':
$newEntry['type'] = 'merge';
$newEntry['dump_records'] = false;
break;
// Tables whose data we do not back up (memory, federated and can-have-no-data tables)
case 'MEMORY':
case 'EXAMPLE':
case 'BLACKHOLE':
case 'FEDERATED':
$newEntry['dump_records'] = false;
break;
// Normal tables
default:
break;
}
}
// Table Data Filter: skip dumping table contents of filtered out tables.
if ($filters->isFiltered($abstractName, $root, 'dbobject', 'content'))
{
$newEntry['dump_records'] = false;
}
$this->tables_data[$tableName] = $newEntry;
}
Factory::getLog()->debug(__CLASS__ . " :: Got table list");
}
/**
* Generate metadata for PROCEDUREs, EVENTs, FUNCTIONs, or TRIGGERs
*
* @param string $type The entity type to generate metadata for
*
* @return void
* @throws Exception
*/
private function generateMetadataForEntity(string $type): void
{
$db = $this->getDB();
switch ($type)
{
case 'event':
$sql = 'SHOW EVENTS WHERE `Db`=' . $db->quote($this->database);
$offset = 1;
break;
case 'trigger':
$sql = 'SHOW TRIGGERS IN ' . $db->quoteName($this->database);
$offset = 0;
break;
default:
$sql = 'SHOW ' . $type . ' STATUS WHERE `Db`=' . $db->quote($this->database);
$offset = 1;
break;
}
$db->setQuery($sql);
try
{
$metadata_list = $db->loadRowList();
}
catch (Exception $e)
{
return;
}
if (!is_countable($metadata_list) || !count($metadata_list))
{
return;
}
foreach ($metadata_list as $entity_metadata)
{
$entity_name = $entity_metadata[$offset];
// Skip over entities not included in the backup set
if (!array_key_exists($entity_name, $this->table_name_map))
{
continue;
}
// Basic information
$entity_abstract = $this->table_name_map[$entity_name];
$new_entry = [
'type' => $type,
'dump_records' => false,
];
$dependencies = [];
$new_entry['create'] = $this->getCreateStatement(
$entity_abstract, $entity_name, $new_entry['type'], $dependencies
);
if ($new_entry['create'] === null)
{
continue;
}
$new_entry['dependencies'] = $dependencies;
$this->tables_data[$entity_name] = $new_entry;
}
}
/**
* Figure out the table's data storage engine given its CREATE statement.
*
* @param string $createSql The CREATE statement for the table.
*
* @return string
*/
private function getTableEngineFromCreateStatement(string $createSql): string
{
$engine = 'MyISAM'; // So that even with MySQL 4 hosts we don't screw this up
$engine_keys = ['ENGINE=', 'TYPE='];
foreach ($engine_keys as $engine_key)
{
$start_pos = strrpos($createSql, $engine_key);
if ($start_pos === false)
{
continue;
}
// Advance the start position just after the position of the ENGINE keyword
$start_pos += strlen($engine_key);
// Try to locate the space after the engine type
$end_pos = stripos($createSql, ' ', $start_pos);
if ($end_pos === false)
{
// Uh... maybe it ends with ENGINE=EngineType;
$end_pos = stripos($createSql, ';', $start_pos);
}
if ($end_pos !== false)
{
// Grab the string
$engine = substr($createSql, $start_pos, $end_pos - $start_pos);
}
}
return strtoupper($engine);
}
/**
* Does the entity name include a newline or carriage return?
*
* These entity names are rarely, if ever, legitimate. They are likely to trigger the MySQL vulnerability
* CVE-2017-3600 (“Bad Dump”). As a result, they will be excluded from the database dump.
*
* @param string $type The entity type: table, merge, view, procedure, event, function, or trigger.
* @param string $name The name of the entity to process.
*
* @return bool
*/
private function isCVEBadDump(string $type, string $name): bool
{
if ((strpos($name, "\r") === false) && (strpos($name, "\n") === false))
{
return false;
}
$name = str_replace(["\r", "\n"], ['\\r', '\\n'], $name);
Factory::getLog()->warning(
sprintf(
"%s :: [SECURITY] %s %s includes newline characters. Skipping table to protect you against possible MySQL vulnerability CVE-2017-3600 (“Bad Dump”).",
__CLASS__,
ucfirst($type),
$name
)
);
return true;
}
/**
* Does the entity name start with the literal prefix `bak_`?
*
* These are backup copies of tables, views, etc created during a previous restoration. They will be automatically
* skipped from the backup to avoid restoration woes.
*
* @param string $type The entity type: table, merge, view, procedure, event, function, or trigger.
* @param string $name The name of the entity to process.
*
* @return bool
*/
private function isBackupPrefix(string $type, string $name): bool
{
if (substr($name, 0, 4) != 'bak_')
{
return false;
}
Factory::getLog()->info(
sprintf(
"%s :: Backup %s %s automatically skipped.",
__CLASS__,
ucfirst($type),
$name
)
);
return true;
}
/**
* Does the entity name in the database start with the literal prefix `#__`?
*
* If this is the case, the entity will be automatically skipped from the backup as the literal prefix `#__` will
* clash with our abstract naming pattern during restoration.
*
* @param string $type The entity type: table, merge, view, procedure, event, function, or trigger.
* @param string $name The name of the entity to process.
*
* @return bool
*/
private function isAbstractNamedInDatabase(string $type, string $name): bool
{
if (substr($name, 0, 3) !== '#__')
{
return false;
}
Factory::getLog()->warning(
sprintf(
"%s :: %s %s has a prefix of #__. This would cause restoration errors; table skipped.", __CLASS__,
ucfirst($type),
$name
)
);
return true;
}
/**
* Generate the concrete to abstract map for TABLEs / VIEWs, PROCEDUREs, EVENTs, FUNCTIONs, or TRIGGERs.
*
* @param string $type The entity type: table, procedire, event, function, trigger
*
* @return void
* @throws Exception
*/
private function generateMappingForEntities(string $type = 'procedure'): void
{
$db = $this->getDB();
$registry = Factory::getConfiguration();
$filters = Factory::getFilters();
$root = $registry->get('volatile.database.root', '[SITEDB]');
Factory::getLog()->debug(
sprintf("%s :: Listing stored %ss", __CLASS__, strtoupper($type))
);
switch ($type)
{
case 'table':
$sql = 'SHOW TABLES';
$offset = 0;
break;
case 'event':
$sql = "SHOW EVENTS WHERE `Db`=" . $db->quote($this->database);
$offset = 1;
break;
case 'trigger':
$sql = 'SHOW TRIGGERS IN ' . $db->quoteName($this->database);
$offset = 0;
break;
default:
$sql = "SHOW " . $type . " STATUS WHERE `Db`=" . $db->quote($this->database);
$offset = 1;
break;
}
$db->setQuery($sql);
try
{
$allNames = $db->loadResultArray($offset);
}
catch (Exception $e)
{
return;
}
if (!is_countable($allNames) || !count($allNames))
{
return;
}
// If we have filters, make sure the tables pass the filtering.
foreach ($allNames as $name)
{
if (
$this->isAbstractNamedInDatabase($type, $name)
|| $this->isCVEBadDump($type, $name)
|| $this->isBackupPrefix($type, $name)
)
{
continue;
}
$abstract = $this->getAbstract($name);
if ($filters->isFiltered($abstract, $root, 'dbobject', 'all'))
{
Factory::getLog()->info(__CLASS__ . " :: Skipping $type $name (internal name $abstract)");
continue;
}
Factory::getLog()->info(__CLASS__ . " :: Adding $type $name (internal name $abstract)");
$this->table_name_map[$name] = $abstract;
}
}
/**
* Is the CREATE statement one which creates a VIEW?
*
* @param string $table_sql The CREATE statement
*
* @return bool
*/
private function isCreateView(string $table_sql): bool
{
return (bool) preg_match('/^CREATE(.*?) VIEW\s/i', $table_sql);
}
/**
* Pre-process the CREATE SQL command of a procedure, event, function, or trigger.
*
* Remove the definer from the CREATE PROCEDURE/EVENT/TRIGGER/FUNCTION. For example, MySQL returns this:
* CREATE DEFINER=`myuser`@`localhost` PROCEDURE `abc_myProcedure`() ...
* If you're restoring on a different machine the definer will probably be invalid, therefore we need to
* remove it from the (portable) output.
*
* @param string $table_sql The CREATE SQL statement
* @param string $type The entity type: procedure, event, function, or trigger
*
* @return string
* @throws Exception
*/
private function preProcessCreateSQLForEntity(string $table_sql, string $type): string
{
$db = $this->getDB();
// MySQL adds the database name into everything. We have to remove it.
$dbName = $db->qn($this->database) . '.`';
$table_sql = str_replace($dbName, '`', $table_sql);
// These can contain comment lines, starting with a double dash. Remove them.
$table_sql = trim($table_sql);
/**
* Remember, $table_sql may be multiline.
*
* Therefore, we need to process only the first line and append any further lines to the CREATE statement.
*/
$table_sql = trim($table_sql);
$lines = explode("\n", $table_sql);
$firstLine = array_shift($lines);
$pattern = '/^CREATE(.*?) ' . strtoupper($type) . ' (.*)/i';
$result = preg_match($pattern, $firstLine, $matches);
$table_sql = 'CREATE ' . strtoupper($type) . ' ' . $matches[2] . "\n" . implode("\n", $lines);
$table_sql = trim($table_sql);
return $table_sql;
}
/**
* Pre-process the CREATE VIEW command.
*
* Newer MySQL versions add the definer and other information in the CREATE VIEW output, e.g.
* CREATE ALGORITHM=UNDEFINED DEFINER=`muyser`@`localhost` SQL SECURITY DEFINER VIEW `abc_myview` AS ...
* We need to remove that to prevent restoration troubles.
*
* @param string $table_sql The CREATE VIEW SQL statement
*
* @return string
*/
private function preProcessCreateSQLForView(string $table_sql): string
{
preg_match('/^CREATE(.*?) VIEW (.*)/i', $table_sql, $matches);
return 'CREATE VIEW ' . $matches[2];
}
/**
* Pre-process the CREATE TABLE command.
*
* This method addresses a lot of cross-server issues which may arise by using several not-so-important MYSQL and
* MariaDB features in tables such as:
* - Using BTREE / HASH statements for indices.
* - Tablespaces.
* - DATA/INDEX DIRECTORY.
* - ROW_FORMAT in InnoDB tables.
* - PAGE_CHECKSUM in MariaDB's MyISAM.
* - References to foreign tables in constraints and indices.
*
* @param string $table_sql The CREATE VIEW SQL statement
*
* @return string
*/
private function preProcessCreateSQLForTable(string $table_sql): string
{
// USING BTREE / USING HASH in indices causes issues migrating from MySQL 5.1+ hosts to MySQL 5.0 hosts
if (Factory::getConfiguration()->get('engine.dump.native.nobtree', 1))
{
$table_sql = str_replace(' USING BTREE', ' ', $table_sql);
$table_sql = str_replace(' USING HASH', ' ', $table_sql);
}
// Translate TYPE= to ENGINE=
$table_sql = str_replace('TYPE=', 'ENGINE=', $table_sql);
/**
* Remove the TABLESPACE option.
*
* The format of the TABLESPACE table option is:
* TABLESPACE tablespace_name [STORAGE {DISK|MEMORY}]
* where tablespace_name can be a quoted or unquoted identifier.
*/
[$validCharRegEx, $unicodeFlag] = $this->getMySQLIdentifierCharacterRegEx();
$tablespaceName = "((($validCharRegEx){1,})|(`.*`))";
$suffix = 'STORAGE\s{1,}(DISK|MEMORY)';
$regex = "#TABLESPACE\s{1,}$tablespaceName\s{0,}($suffix){0,1}#i" . $unicodeFlag;
$table_sql = preg_replace($regex, '', $table_sql);
// Remove table options {DATA|INDEX} DIRECTORY
$regex = "#(DATA|INDEX)\s{1,}DIRECTORY\s*=?\s*'.*'#i";
$table_sql = preg_replace($regex, '', $table_sql);
// Remove table options ROW_FORMAT=whatever
$regex = "#ROW_FORMAT\s*=\s*[A-Z]{1,}#i";
$table_sql = preg_replace($regex, '', $table_sql);
// Remove MariaDB MyISAM option PAGE_CHECKSUM
$regex = "#PAGE_CHECKSUM\s*=\s*[\d]{1,}#i";
$table_sql = preg_replace($regex, '', $table_sql);
// Abstract the names of table constraints and indices
$regex = "#(CONSTRAINT|KEY|INDEX)\s{1,}`{$this->prefix}#i";
$table_sql = preg_replace($regex, '$1 `#__', $table_sql);
return $table_sql;
}
/**
* Post-process the CREATE command for a view, table, procedure, event, function, or trigger.
*
* @param string $table_sql
* @param string $type
*
* @return string
* @throws Exception
*/
private function postProcessCreateSQL(string $table_sql, string $type): string
{
$db = $this->getDB();
// Add a final semicolon and newline character
$table_sql = rtrim($table_sql);
$table_sql = rtrim($table_sql, ';');
$table_sql .= ";\n";
/**
* Views, procedures, functions and triggers may contain the database name followed by the table name, always
* quoted e.g. `db`.`table_name` We need to replace all these instances with just the table name. The only
* reliable way to do that is to look for "`db`.`" and replace it with "`"
*/
if (in_array($type, ['view', 'procedure', 'function', 'trigger', 'event']))
{
$dbName = $db->qn($this->getDatabaseName());
$dummyQuote = $db->qn('foo');
$findWhat = $dbName . '.' . substr($dummyQuote, 0, 1);
$replaceWith = substr($dummyQuote, 0, 1);
$table_sql = str_replace($findWhat, $replaceWith, $table_sql);
}
// Post-process CREATE VIEW
if ($type == 'view')
{
$pos_view = strpos($table_sql, ' VIEW ');
if ($pos_view > 7)
{
// Only post process if there are view properties between the CREATE and VIEW keywords
// -- Properties string
$propstring = substr($table_sql, 7, $pos_view - 7);
// -- Fetch the ALGORITHM={UNDEFINED | MERGE | TEMPTABLE} keyword
$algostring = '';
$algo_start = strpos($propstring, 'ALGORITHM=');
if ($algo_start !== false)
{
$algo_end = strpos($propstring, ' ', $algo_start);
$algostring = substr($propstring, $algo_start, $algo_end - $algo_start + 1);
}
// Create our modified create statement
return 'CREATE OR REPLACE ' . $algostring . substr($table_sql, $pos_view);
}
}
$pos_entity = stripos($table_sql, sprintf(" %s ", strtoupper($type)));
if ($pos_entity !== false)
{
$table_sql = 'CREATE' . substr($table_sql, $pos_entity);
}
return $table_sql;
}
}PK \l~ 0 vendor/akeeba/engine/engine/Dump/Native/None.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Dump\Base;
use Akeeba\Engine\Factory;
/**
* Dump class for the "None" database driver (ie no database used by the application)
*/
#[\AllowDynamicProperties]
class None extends Base
{
public function __construct()
{
parent::__construct();
}
/** @inheritDoc */
protected function getTablesToBackup(): void
{
}
/** @inheritDoc */
protected function stepDatabaseDump(): void
{
Factory::getLog()->info("Reminder: database definitions using the 'None' driver result in no data being backed up.");
$this->setState(self::STATE_FINISHED);
}
/** @inheritDoc */
protected function getDatabaseNameFromConnection(): string
{
return '';
}
/** @inheritDoc */
protected function getAllTables(): array
{
return [];
}
protected function _run()
{
Factory::getLog()->info("Reminder: database definitions using the 'None' driver result in no data being backed up.");
$this->setState(self::STATE_POSTRUN);
}
protected function _finalize()
{
Factory::getLog()->info("Reminder: database definitions using the 'None' driver result in no data being backed up.");
$this->setState(self::STATE_FINISHED);
}
}
PK \, , E vendor/akeeba/engine/engine/Dump/Native/MySQL/BadEntityNamesTrait.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\MySQL;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
/**
* Trait to filter out entities which have a name that prevents us from backing them up.
*
* This is used to prevent security and functional issues during restoration.
*
* @since 9.10.0
*/
trait BadEntityNamesTrait
{
/**
* Is the entity name “bad”, preventing us from backing it up?
*
* @param string $type Entity type, e.g. 'table'.
* @param string $name Entity name, as reported by the database server.
*
* @return bool
*/
private function isBadEntityName(string $type, string $name): bool
{
return $this->isCVEBadDump($type, $name)
|| $this->isBackupPrefix($type, $name)
|| $this->isAbstractNamedInDatabase($type, $name);
}
/**
* Does the entity name include a newline or carriage return?
*
* These entity names are rarely, if ever, legitimate. They are likely to trigger the MySQL vulnerability
* CVE-2017-3600 (“Bad Dump”). As a result, they will be excluded from the database dump.
*
* @param string $type The entity type: table, merge, view, procedure, event, function, or trigger.
* @param string $name The name of the entity to process.
*
* @return bool
*/
private function isCVEBadDump(string $type, string $name): bool
{
if ((strpos($name, "\r") === false) && (strpos($name, "\n") === false))
{
return false;
}
$name = str_replace(["\r", "\n"], ['\\r', '\\n'], $name);
Factory::getLog()->warning(
sprintf(
"%s :: [SECURITY] %s %s includes newline characters. Skipping table to protect you against possible MySQL vulnerability CVE-2017-3600 (“Bad Dump”).",
__CLASS__,
ucfirst($type),
$name
)
);
return true;
}
/**
* Does the entity name start with the literal prefix `bak_`?
*
* These are backup copies of tables, views, etc created during a previous restoration. They will be automatically
* skipped from the backup to avoid restoration woes.
*
* @param string $type The entity type: table, merge, view, procedure, event, function, or trigger.
* @param string $name The name of the entity to process.
*
* @return bool
*/
private function isBackupPrefix(string $type, string $name): bool
{
if (substr($name, 0, 4) != 'bak_')
{
return false;
}
Factory::getLog()->info(
sprintf(
"%s :: Backup %s %s automatically skipped.",
__CLASS__,
ucfirst($type),
$name
)
);
return true;
}
/**
* Does the entity name in the database start with the literal prefix `#__`?
*
* If this is the case, the entity will be automatically skipped from the backup as the literal prefix `#__` will
* clash with our abstract naming pattern during restoration.
*
* @param string $type The entity type: table, merge, view, procedure, event, function, or trigger.
* @param string $name The name of the entity to process.
*
* @return bool
*/
private function isAbstractNamedInDatabase(string $type, string $name): bool
{
if (substr($name, 0, 3) !== '#__')
{
return false;
}
Factory::getLog()->warning(
sprintf(
"%s :: %s %s has a prefix of #__. This would cause restoration errors; table skipped.", __CLASS__,
ucfirst($type),
$name
)
);
return true;
}
}PK \sa@ @ F vendor/akeeba/engine/engine/Dump/Native/MySQL/CreateStatementTrait.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\MySQL;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Factory;
use Exception;
trait CreateStatementTrait
{
/**
* Gets the CREATE TABLE command for a given table, view, procedure, event, function, or trigger.
*
* @param string $abstractName The abstracted name of the entity.
* @param string $concreteName The concrete (database) name of the entity.
* @param string $type The type of the entity to scan.
*
* @return string|null The CREATE statement
*/
private function getCreateStatement(
string $abstractName, string $concreteName, string $type
): ?string
{
$db = $this->getDB();
try
{
$sql = sprintf("SHOW CREATE %s %s", strtoupper($type), $db->quoteName($abstractName));
$temp = $db->setQuery($sql)->loadAssocList();
}
catch (Exception $e)
{
// If the query failed we don't have the necessary SHOW privilege. Log the error and fake an empty reply.
$msg = $e->getMessage();
Factory::getLog()->warning(
"Cannot get the structure of $type $abstractName. Database returned error “{$msg}” running $sql Please check your database privileges. Your database backup may be incomplete."
);
$db->resetErrors();
$temp = [
['', '', ''],
];
}
$columnKey = 'Create ' . ucfirst(strtolower($type));
$table_sql = $temp[0][$columnKey] ?? null;
if ($table_sql === null)
{
$columnId = $type === 'event' ? 3 : 2;
$table_sql = array_values($temp[0])[$columnId] ?? null;
}
unset($temp);
if (empty($table_sql))
{
Factory::getLog()->warning(
"Cannot get the structure of $type $abstractName. The database refused to return the CREATE command for this $type. Please check your database privileges. Your database backup may be incomplete."
);
return null;
}
Factory::getLog()->debug(
sprintf(
'Got create for %s %s (internal name %s)',
$type,
$concreteName,
$abstractName
)
);
switch ($type)
{
case 'procedure':
case 'event':
case 'function':
case 'trigger':
$table_sql = $this->preProcessCreateSQLForRoutine($table_sql, $type);
break;
case 'view':
$table_sql = $this->preProcessCreateSQLForView($table_sql);
break;
case 'table':
case 'merge':
default:
$table_sql = $this->preProcessCreateSQLForTable($table_sql);
}
/**
* Replace table name and names of referenced tables with their abstracted forms and populate dependency tables
* at the same time.
*/
if (!$this->useAbstractNames)
{
$old_table_sql = $table_sql;
}
/**
* Abstract table names AND update dependency tracking information.
*
* Because this updates the tracking information we can not skip it when $mustAbstractTableNames is false. This
* is why we restore $table_sql in this case, and this case only.
*
* We have to quote the table name. If we don't we'll get wrong results. Imagine that you have a column whose
* name starts with the string literal of the table name itself.
*
* Example: table `poll`, column `poll_id` would become #__poll, #__poll_id
*
* By quoting before we make sure this won't happen.
*/
$table_sql = $this->replaceTableNamesWithAbstracts($concreteName, $table_sql);
if (!$this->useAbstractNames)
{
$table_sql = $old_table_sql;
}
return $this->postProcessCreateSQL($table_sql, $type);
}
/**
* Pre-process the CREATE SQL command of a procedure, event, function, or trigger.
*
* Remove the definer from the CREATE PROCEDURE/EVENT/TRIGGER/FUNCTION. For example, MySQL returns this:
* CREATE DEFINER=`myuser`@`localhost` PROCEDURE `abc_myProcedure`() ...
* If you're restoring on a different machine the definer will probably be invalid, therefore we need to
* remove it from the (portable) output.
*
* @param string $table_sql The CREATE SQL statement
* @param string $type The entity type: procedure, event, function, or trigger
*
* @return string
* @throws Exception
*/
private function preProcessCreateSQLForRoutine(string $table_sql, string $type): string
{
$db = $this->getDB();
// MySQL adds the database name into everything. We have to remove it.
$dbName = $db->qn($this->database) . '.`';
$table_sql = str_replace($dbName, '`', $table_sql);
// These can contain comment lines, starting with a double dash. Remove them.
$table_sql = trim($table_sql);
/**
* Remember, $table_sql may be multiline.
*
* Therefore, we need to process only the first line and append any further lines to the CREATE statement.
*/
$table_sql = trim($table_sql);
$lines = explode("\n", $table_sql);
$firstLine = array_shift($lines);
$pattern = '/^CREATE(.*?) ' . strtoupper($type) . ' (.*)/i';
$result = preg_match($pattern, $firstLine, $matches);
$table_sql = 'CREATE ' . strtoupper($type) . ' ' . $matches[2] . "\n" . implode("\n", $lines);
$table_sql = trim($table_sql);
return $table_sql;
}
/**
* Pre-process the CREATE VIEW command.
*
* Newer MySQL versions add the definer and other information in the CREATE VIEW output, e.g.
* CREATE ALGORITHM=UNDEFINED DEFINER=`muyser`@`localhost` SQL SECURITY DEFINER VIEW `abc_myview` AS ...
* We need to remove that to prevent restoration troubles.
*
* @param string $table_sql The CREATE VIEW SQL statement
*
* @return string
*/
private function preProcessCreateSQLForView(string $table_sql): string
{
preg_match('/^CREATE(.*?) VIEW (.*)/i', $table_sql, $matches);
return 'CREATE VIEW ' . $matches[2];
}
/**
* Pre-process the CREATE TABLE command.
*
* This method addresses a lot of cross-server issues which may arise by using several not-so-important MYSQL and
* MariaDB features in tables such as:
* - Using BTREE / HASH statements for indices.
* - Tablespaces.
* - DATA/INDEX DIRECTORY.
* - ROW_FORMAT in InnoDB tables.
* - PAGE_CHECKSUM in MariaDB's MyISAM.
* - References to foreign tables in constraints and indices.
*
* @param string $table_sql The CREATE VIEW SQL statement
*
* @return string
*/
private function preProcessCreateSQLForTable(string $table_sql): string
{
// USING BTREE / USING HASH in indices causes issues migrating from MySQL 5.1+ hosts to MySQL 5.0 hosts
if (Factory::getConfiguration()->get('engine.dump.native.nobtree', 1))
{
$table_sql = str_replace(' USING BTREE', ' ', $table_sql);
$table_sql = str_replace(' USING HASH', ' ', $table_sql);
}
// Translate TYPE= to ENGINE=
$table_sql = str_replace('TYPE=', 'ENGINE=', $table_sql);
/**
* Remove the TABLESPACE option.
*
* The format of the TABLESPACE table option is:
* TABLESPACE tablespace_name [STORAGE {DISK|MEMORY}]
* where tablespace_name can be a quoted or unquoted identifier.
*/
[$validCharRegEx, $unicodeFlag] = $this->getMySQLIdentifierCharacterRegEx();
$tablespaceName = "((($validCharRegEx){1,})|(`.*`))";
$suffix = 'STORAGE\s{1,}(DISK|MEMORY)';
$regex = "#TABLESPACE\s{1,}$tablespaceName\s{0,}($suffix){0,1}#i" . $unicodeFlag;
$table_sql = preg_replace($regex, '', $table_sql);
// Remove table options {DATA|INDEX} DIRECTORY
$regex = "#(DATA|INDEX)\s{1,}DIRECTORY\s*=?\s*'.*'#i";
$table_sql = preg_replace($regex, '', $table_sql);
// Remove table options ROW_FORMAT=whatever
$regex = "#ROW_FORMAT\s*=\s*[A-Z]{1,}#i";
$table_sql = preg_replace($regex, '', $table_sql);
// Remove MariaDB MyISAM option PAGE_CHECKSUM
$regex = "#PAGE_CHECKSUM\s*=\s*[\d]{1,}#i";
$table_sql = preg_replace($regex, '', $table_sql);
// Remove MySQL option KEY_BLOCK_SIZE
// @link https://www.akeeba.com/support/akeeba-backup/41463-incorrect-usage-placement-of-key-block-size.html
$regex = "#KEY_BLOCK_SIZE\s*=\s*[\d]{1,}#i";
$table_sql = preg_replace($regex, '', $table_sql);
// Abstract the names of table constraints and indices
$regex = "#(CONSTRAINT|KEY|INDEX)\s{1,}`{$this->prefix}#i";
$table_sql = preg_replace($regex, '$1 `#__', $table_sql);
return $table_sql;
}
/**
* Get a regular expression and its options for valid characters of an unquoted MySQL identifier.
*
* This is used wherever we need to detect an arbitrary, unquoted MySQL identifier per
* https://dev.mysql.com/doc/refman/5.7/en/identifiers.html
*
* Also what if Unicode support is not compiled in PCRE? In this case we will fall back to a much simpler regex
* which only supports the ASCII subset of the allowed characters. In this case your database dump will be wrong
* if you use table names with non-ASCII characters.
*
* Since the detection is horribly slow we cache its results in an internal static variable.
*
* @return array In the format [$regex, $flags]
* @since 7.0.0
*/
private function getMySQLIdentifierCharacterRegEx(): array
{
static $validCharRegEx = null;
static $unicodeFlag = null;
if (is_null($validCharRegEx) || is_null($unicodeFlag))
{
$noUnicode = @preg_match('/\p{L}/u', 'σ') !== 1;
$unicodeFlag = $noUnicode ? '' : 'u';
$validCharRegEx = $noUnicode ? '[0-9a-zA-Z$_]' : '[0-9a-zA-Z$_]|[\x{0080}-\x{FFFF}]';
}
return [$validCharRegEx, $unicodeFlag];
}
/**
* Replaces the table names in the CREATE query with their abstract form. Optionally updates dependencies.
*
* @param string $tableName The table name the CREATE query is for
* @param string $tableSql The CREATE query itself
*
* @return string
*
* @throws Exception When we cannot get the DB object
*/
private function replaceTableNamesWithAbstracts(string $tableName, string $tableSql): string
{
// Initialization
$tableNameMap = $this->table_name_map;
$db = $this->getDB();
if (!array_key_exists($tableName, $tableNameMap))
{
$tableNameMap[$tableName] = $this->getAbstract($tableName);
}
foreach ($tableNameMap as $fullName => $abstractName)
{
$quotedFullName = $db->quoteName($fullName);
$quotedAbstractName = $db->quoteName($abstractName);
$pos = strpos($tableSql, $quotedFullName);
if ($pos !== false)
{
// Do the replacement
$tableSql = str_replace($quotedFullName, $quotedAbstractName, $tableSql);
continue;
}
if (is_numeric($fullName))
{
continue;
}
$offset = 0;
$fullNameLength = strlen($fullName);
$quotedAbstractNameLength = strlen($quotedAbstractName);
/**
* We need to detect the edges of table names. If they are enclosed in backticks it's pretty clear. If they are
* not, e.g. in the definitions of TRIGGERs, we need to base our detection on the valid characters for
* unquoted MySQL table names per https://dev.mysql.com/doc/refman/5.7/en/identifiers.html
*/
[$bareCharRegex, $regexFlags] = $this->getMySQLIdentifierCharacterRegEx();
$fullCharRegex = "/$bareCharRegex/$regexFlags";
while (true)
{
$pos = strpos($tableSql, $fullName, $offset);
if ($pos === false)
{
break;
}
// Skip over table-name-like strings in strings enclosed by single quotes
$quotePos = strpos($tableSql, "'", $offset);
if ($quotePos !== false && $quotePos < $pos)
{
// The table-like token is inside a string. Find its end.
while (true)
{
$nextPos = strpos($tableSql, "'", $quotePos + 1);
if ($nextPos === false)
{
break;
}
$prevChar = $nextPos > 0 ? $tableSql[$nextPos - 1] : null;
$nextChar = strlen($tableSql) > $nextPos + 1 ? $tableSql[$nextPos + 1] : null;
// Catch quote escaped as \'
if ($prevChar === '\\')
{
$quotePos = $nextPos;
continue;
}
// Catch quote escaped as ''
if ($nextChar === "'")
{
$quotePos = $nextPos + 1;
continue;
}
$offset = $nextPos + 1;
continue 2;
}
}
// Skip over table-name-like strings in strings enclosed by double quotes
$quotePos = strpos($tableSql, '"', $offset);
if ($quotePos !== false && $quotePos < $pos)
{
// The table-like token is inside a string. Find its end.
while (true)
{
$nextPos = strpos($tableSql, '"', $quotePos + 1);
if ($nextPos === false)
{
break;
}
$prevChar = $nextPos > 0 ? $tableSql[$nextPos - 1] : null;
$nextChar = strlen($tableSql) > $nextPos + 1 ? $tableSql[$nextPos + 1] : null;
// Catch quote escaped as \"
if ($prevChar === '\\')
{
$quotePos = $nextPos;
continue;
}
// Catch quote escaped as ""
if ($nextChar === '"')
{
$quotePos = $nextPos + 1;
continue;
}
$offset = $nextPos + 1;
continue 2;
}
}
// Catch table-name-like substring inside another table's name
$previousChar = ($pos > 0) ? substr($tableSql, $pos - 1, 1) : '';
$nextChar = ($pos < (strlen($tableSql) - $fullNameLength)) ? substr($tableSql, $pos + $fullNameLength, 1) : '';
$prevIsTableChar = $previousChar === '' ? false : preg_match($fullCharRegex, $previousChar);
$nextIsTableChar = $nextChar === '' ? false : preg_match($fullCharRegex, $nextChar);
if ($prevIsTableChar || $nextIsTableChar)
{
$offset = $pos + 1;
continue;
}
$before = ($pos > 0) ? substr($tableSql, 0, $pos) : '';
$after = ($pos < (strlen($tableSql) - $fullNameLength)) ? substr($tableSql, $pos + $fullNameLength) : '';
$tableSql = $before . $quotedAbstractName . $after;
$offset = $pos + $quotedAbstractNameLength;
}
}
return $tableSql;
}
/**
* Post-process the CREATE command for a view, table, procedure, event, function, or trigger.
*
* @param string $table_sql
* @param string $type
*
* @return string
* @throws Exception
*/
private function postProcessCreateSQL(string $table_sql, string $type): string
{
$db = $this->getDB();
// Add a final semicolon and newline character
$table_sql = rtrim($table_sql);
$table_sql = rtrim($table_sql, ';');
$table_sql .= ";\n";
/**
* Views, procedures, functions and triggers may contain the database name followed by the table name, always
* quoted e.g. `db`.`table_name` We need to replace all these instances with just the table name. The only
* reliable way to do that is to look for "`db`.`" and replace it with "`"
*/
if (in_array($type, ['view', 'procedure', 'function', 'trigger', 'event']))
{
$dbName = $db->qn($this->getDatabaseName());
$dummyQuote = $db->qn('foo');
$findWhat = $dbName . '.' . substr($dummyQuote, 0, 1);
$replaceWith = substr($dummyQuote, 0, 1);
$table_sql = str_replace($findWhat, $replaceWith, $table_sql);
}
// Post-process CREATE VIEW
if ($type == 'view')
{
$pos_view = strpos($table_sql, ' VIEW ');
if ($pos_view > 7)
{
// Only post process if there are view properties between the CREATE and VIEW keywords
// -- Properties string
$propstring = substr($table_sql, 7, $pos_view - 7);
// -- Fetch the ALGORITHM={UNDEFINED | MERGE | TEMPTABLE} keyword
$algostring = '';
$algo_start = strpos($propstring, 'ALGORITHM=');
if ($algo_start !== false)
{
$algo_end = strpos($propstring, ' ', $algo_start);
$algostring = substr($propstring, $algo_start, $algo_end - $algo_start + 1);
}
// Create our modified create statement
return 'CREATE OR REPLACE ' . $algostring . substr($table_sql, $pos_view);
}
}
$pos_entity = stripos($table_sql, sprintf(" %s ", strtoupper($type)));
if ($pos_entity !== false)
{
$table_sql = 'CREATE' . substr($table_sql, $pos_entity);
}
return $table_sql;
}
}PK \+Iw w D vendor/akeeba/engine/engine/Dump/Native/MySQL/DropStatementTrait.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\MySQL;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Dump\Dependencies\Entity;
use Akeeba\Engine\Factory;
use Exception;
trait DropStatementTrait
{
/**
* Creates a drop query from an entity
*
* @param Entity $entity
*
* @return string The DROP statement
* @throws Exception
*/
private function createDrop(Entity $entity): string
{
return sprintf(
"DROP %s IF EXISTS %s;",
strtoupper(trim($entity->type)),
$this->getDB()->nameQuote($this->useAbstractNames ? $entity->abstractName : $entity->name)
);
}
}PK \3
H5 5 C vendor/akeeba/engine/engine/Dump/Native/MySQL/ListEntitiesTrait.phpnu [ .
*/
namespace Akeeba\Engine\Dump\Native\MySQL;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Dump\Dependencies\Entity;
use Akeeba\Engine\Dump\Dependencies\Resolver;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Util\Collection;
use Exception;
use RuntimeException;
use Throwable;
/**
* Trait to list the entities which will be backed up.
*
* This uses an integrated view/table dependency resolver.
*
* @since 9.10.0
*/
trait ListEntitiesTrait
{
/**
* Get a collection of all tables and views in the database
*
* @return Collection
* @throws RuntimeException|Exception
*/
private function getTablesViewCollection(): Collection
{
Factory::getLog()->debug(
sprintf("%s :: Listing tables and views", __CLASS__)
);
$db = $this->getDB();
// Get the names of all tables and views, along with the metadata I need to process them
try
{
$sql = $db->getQuery(true)
->select(
[
$db->quoteName('TABLE_NAME', 'name'),
$db->quoteName('TABLE_TYPE', 'type'),
$db->quoteName('ENGINE', 'engine'),
]
)
->from($db->quoteName('INFORMATION_SCHEMA.TABLES'))
->where($db->quoteName('TABLE_SCHEMA') . ' = DATABASE()');
$meta = $db->setQuery($sql)->loadObjectList();
}
catch (Throwable $e)
{
throw new RuntimeException(
sprintf('Cannot list tables and views for database %s', $this->database),
500,
$e
);
}
// Create entities collection, keyed by the concrete table/view name.
$entities = new Collection();
$filters = Factory::getFilters();
foreach ($meta as $tableMeta)
{
try
{
$entity = new Entity($tableMeta->type, $tableMeta->name, $this->getAbstract($tableMeta->name));
// Is the table/view name “bad”, preventing us from backing it up?
if ($this->isBadEntityName($entity->type, $entity->name))
{
// No need to log; the called method logs any bad naming reasons for us.
continue;
}
// Is the entity filtered?
if ($filters->isFiltered($entity->abstractName, $this->dbRoot, 'dbobject', 'all'))
{
Factory::getLog()->info(
sprintf(
"%s :: Skipping %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
continue;
}
// All good. Log it, and add it to the collection.
Factory::getLog()->info(
sprintf(
"%s :: Adding %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
$entities->put(
$entity->name,
$entity->setDumpContents(
$this->canDumpData($entity->type, $entity->abstractName, $tableMeta->engine)
)
);
}
catch (Throwable $e)
{
Factory::getLog()->warning(
sprintf(
'%s %s will not be backed up (%s)',
strtolower($tableMeta->type), $tableMeta->name, $e->getMessage()
)
);
}
}
return $entities;
}
/**
* Get a collection with the routines of the specified type found in the database.
*
* The routines are returned in the default database order. We don't need a dependency resolver for them. See the
* linked GitHub issue.
*
* @param string $type The routine type (procedure, function, trigger, event)
*
* @return Collection
* @throws Exception
* @link https://github.com/akeeba/engine/issues/136
*/
private function getRoutinesCollection(string $type): Collection
{
$entities = new Collection();
$registry = Factory::getConfiguration();
$enableEntities = $registry->get('engine.dump.native.advanced_entitites', true);
if (!$enableEntities)
{
Factory::getLog()->debug(sprintf("%s :: NOT listing %ss (you told me not to)", __CLASS__, $type));
return $entities;
}
$db = $this->getDB();
$filters = Factory::getFilters();
Factory::getLog()->debug(
sprintf("%s :: Listing %ss", __CLASS__, strtoupper($type))
);
switch ($type)
{
case 'table':
$sql = 'SHOW TABLES';
$offset = 0;
break;
case 'event':
$sql = "SHOW EVENTS WHERE `Db`=" . $db->quote($this->database);
$offset = 1;
break;
case 'trigger':
$sql = 'SHOW TRIGGERS IN ' . $db->quoteName($this->database);
$offset = 0;
break;
default:
$sql = "SHOW " . $type . " STATUS WHERE `Db`=" . $db->quote($this->database);
$offset = 1;
break;
}
try
{
$allNames = $db->setQuery($sql)->loadResultArray($offset);
}
catch (Exception $e)
{
Factory::getLog()->debug(
sprintf("%s :: Cannot list %ss: %s", __CLASS__, strtoupper($type), $e->getMessage())
);
$db->resetErrors();
return $entities;
}
if (!is_countable($allNames) || !count($allNames))
{
Factory::getLog()->debug(
sprintf("%s :: No %ss found", __CLASS__, strtoupper($type))
);
return $entities;
}
foreach ($allNames as $name)
{
try
{
$entity = new Entity($type, $name, $this->getAbstract($name), false);
// Is the table/view name “bad”, preventing us from backing it up?
if ($this->isBadEntityName($entity->type, $entity->name))
{
// No need to log; the called method logs any bad naming reasons for us.
continue;
}
// Is the entity filtered?
if ($filters->isFiltered($entity->abstractName, $this->dbRoot, 'dbobject', 'all'))
{
Factory::getLog()->info(
sprintf(
"%s :: Skipping %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
continue;
}
// All good. Log it, and add it to the collection.
Factory::getLog()->info(
sprintf(
"%s :: Adding %s %s (internal name %s)",
__CLASS__, $entity->type, $entity->name, $entity->abstractName
)
);
$entities->push($entity);
}
catch (Throwable $e)
{
Factory::getLog()->warning(
sprintf(
'%s %s will not be backed up (%s)',
strtolower($type), $name, $e->getMessage()
)
);
}
}
return $entities;
}
/**
* Isolates parsed SQL nodes by their type.
*
* @param array $parsed The parsed SQL nodes tree
* @param string $type The node type to extract
*
* @return array|string
* @see self::getViewDependencies()
*/
private function isolateParsedNodes(array $parsed, string $type)
{
if (isset($parsed[$type]))
{
return $parsed[$type];
}
$ret = [];
foreach ($parsed as $key => $node)
{
if (is_array($node) && ($maybe = $this->isolateParsedNodes($node, $type)))
{
$ret[] = $maybe;
}
}
return $ret;
}
/**
* Extract table names from a list of parsed SQL nodes
*
* @param array $parsed The parsed SQL nodes tree
*
* @return array|string
* @see self::getViewDependencies()
*/
private function extractTablesFromParsedNodes(array $parsed)
{
if (isset($parsed['expr_type']) && $parsed['expr_type'] == 'table')
{
return end($parsed['no_quotes']['parts']) ?: null;
}
$ret = [];
foreach ($parsed as $key => $node)
{
if (is_array($node) && ($maybe = $this->extractTablesFromParsedNodes($node)))
{
$ret[] = $maybe;
}
}
return $ret;
}
/**
* Flattens a deeply nested array
*
* @param array $nestedArray The nested array to flatten
*
* @return array
* @see self::getViewDependencies()
*/
private function flattenArray(array $nestedArray): array
{
$ret = [];
array_walk_recursive(
$nestedArray,
function ($value) use (&$ret) {
$ret[] = $value;
}
);
return $ret;
}
/**
* Get the VIEW dependencies by parsing the DDL stored in the database for each view.
*
* This is a slower, less accurate method for old database servers, e.g. MySQL 5.7 and MariaDB 10.11.
*
* @param Collection $entities
*
* @return array
* @throws Exception
* @see self::resolveDependencies()
*/
private function getViewDependencies(Collection $entities): array
{
$ret = [];
/** @var Entity $entity */
foreach ($entities as $entity)
{
if ($entity->type !== 'view')
{
continue;
}
$db = $this->getDB();
$sql = 'SHOW CREATE VIEW ' . $db->quoteName($entity->name);
$viewInfo = $db->setQuery($sql)->loadAssoc();
$parsed = (new \PHPSQLParser\PHPSQLParser())->parse($viewInfo['Create View']);
$referencedTables = [];
foreach ($this->isolateParsedNodes($parsed, 'FROM') as $node)
{
$temp = $this->extractTablesFromParsedNodes($node);
$referencedTables = array_merge(
$referencedTables,
is_array($temp) ? $temp : [$temp]
);
}
foreach (array_unique($this->flattenArray($referencedTables)) as $refTable)
{
$ret[] = (object) [
'dependent' => $entity->name,
'dependency' => $refTable,
];
}
}
return $ret;
}
/**
* Resolve the table/view dependencies, and return the collection sorted by the resolved order.
*
* @param Collection $entities The unsorted entities collection
*
* @return Collection The sorted entities collection
*/
private function resolveDependencies(Collection $entities): Collection
{
// Am I allowed to track dependencies?
if (Factory::getConfiguration()->get('engine.dump.native.nodependencies', 0))
{
Factory::getLog()->debug(
__CLASS__
. " :: Dependency tracking is disabled. Tables will be backed up in the default database order."
);
return $entities;
}
Factory::getLog()->debug(__CLASS__ . " :: Processing table and view dependencies.");
// Generate a dependencies collection
$resolver = new Resolver($entities->mapPreserve(fn(Entity $entity): array => [])->toArray());
// Get the table dependency information from the database
$sql = /** @lang MySQL */
<<< MySQL
SELECT DISTINCT `TABLE_NAME` AS `dependent`,
`REFERENCED_TABLE_NAME` AS `dependency`
FROM `INFORMATION_SCHEMA`.`KEY_COLUMN_USAGE`
WHERE `TABLE_SCHEMA` = DATABASE()
AND `REFERENCED_TABLE_SCHEMA` = `TABLE_SCHEMA`
MySQL;
$db = $this->getDB();
try
{
$rawDependencies = $db->setQuery($sql)->loadObjectList();
}
catch (Throwable $e)
{
Factory::getLog()->warning(
__CLASS__
. " :: Cannot process table and view dependencies in the database. Tables will be backed up in the default database order."
);
$db->resetErrors();
return $entities;
}
// Get the view dependency information from the database
$useAlternateViewScanner = false;
$sql = /** @lang MySQL */
<<< MySQL
SELECT DISTINCT `VIEW_NAME` AS `dependent`,
`TABLE_NAME` AS `dependency`
FROM `INFORMATION_SCHEMA`.`VIEW_TABLE_USAGE`
WHERE `VIEW_SCHEMA` = DATABASE()
AND `TABLE_SCHEMA` = DATABASE();
MySQL;
try
{
$rawViewDependencies = $db->setQuery($sql)->loadObjectList();
}
catch (Throwable $e)
{
$useAlternateViewScanner = true;
$db->resetErrors();
}
// Get the view dependency information from the database (fallback using SQL parsing)
if ($useAlternateViewScanner)
{
try
{
$rawViewDependencies = $this->getViewDependencies($entities);
}
catch (Exception $e)
{
Factory::getLog()->warning(
__CLASS__
. " :: Cannot process table and view dependencies in the database. Tables will be backed up in the default database order."
);
$db->resetErrors();
return $entities;
}
}
$rawDependencies = array_merge($rawDependencies, $rawViewDependencies);
// Push the dependencies into the tree, and resolve it
foreach ($rawDependencies as $dependency)
{
$resolver->add($dependency->dependent, $dependency->dependency);
}
$orderedKeys = $resolver->resolve();
// Create and return an ordered collection
$orderedCollection = new Collection();
foreach ($orderedKeys as $key)
{
if (!$entities->has($key))
{
continue;
}
$value = $entities->get($key, null);
if ($value === null)
{
continue;
}
$entities->forget($key);
$orderedCollection->put($key, $value);
}
return $orderedCollection;
}
/**
* Are we allowed to dump the data of this table or view?
*
* @param string $type Entity type: view or table
* @param string|null $abstractName The abstract table/view name
* @param string|null $engine The engine type, only applies to tables
*
* @return bool
* @since 9.10.0
*/
private function canDumpData(string $type, ?string $abstractName, ?string $engine)
{
static $filters = null;
$filters ??= Factory::getFilters();
// We cannot dump data of views
if ($type === 'view')
{
return false;
}
// We cannot dump data of tables with these database engines
if (in_array(strtoupper($engine ?? ''), ['MRG_MYISAM', 'MEMORY', 'EXAMPLE', 'BLACKHOLE', 'FEDERATED']))
{
return false;
}
// User-defined filters for everything else
return !$filters->isFiltered(
$abstractName,
$this->dbRoot,
'dbobject',
'content'
);
}
}PK \Sʉ 7 vendor/akeeba/engine/engine/Dump/Native/MySQL/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ 1 vendor/akeeba/engine/engine/Dump/Native/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ âd d ) vendor/akeeba/engine/engine/Dump/Base.phpnu [ .
*/
namespace Akeeba\Engine\Dump;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Core\Domain\Pack;
use Akeeba\Engine\Driver\Base as DriverBase;
use Akeeba\Engine\Dump\Dependencies\Entity;
use Akeeba\Engine\Factory;
use Akeeba\Engine\Platform;
use Akeeba\Engine\Util\FileCloseAware;
use Akeeba\Engine\Util\HashTrait;
use Exception;
use RuntimeException;
#[\AllowDynamicProperties]
abstract class Base extends Part
{
use HashTrait;
use FileCloseAware;
// **********************************************************************
// Configuration parameters
// **********************************************************************
/** @var int Current dump file part number */
public $partNumber = 0;
/** @var string Prefix to this database */
protected $prefix = '';
/** @var string MySQL database server host name or IP address */
protected $host = '';
/** @var string MySQL database server port (optional) */
protected $port = '';
/** @var string MySQL socket or named pipe (optional) */
protected $socket = '';
/** @var string MySQL user name, for authentication */
protected $username = '';
/** @var string MySQL password, for authentication */
protected $password = '';
/** @var string MySQL database */
protected $database = '';
/** @var string The database driver to use */
protected $driver = '';
/** @var array|null The MySQL SSL options */
protected $ssl;
// **********************************************************************
// File handling fields
// **********************************************************************
/** @var boolean Should I post process quoted values */
protected $postProcessValues = false;
/** @var string Absolute path to dump file; must be writable (optional; if left blank it is automatically calculated) */
protected $dumpFile = '';
/** @var string Data cache, used to cache data before being written to disk */
protected $data_cache = '';
/** @var int */
protected $largest_query = 0;
/** @var int Size of the data cache, default 128Kb */
protected $cache_size = 131072;
/** @var bool Should I process empty prefixes when creating abstracted names? */
protected $processEmptyPrefix = true;
/** @var string Absolute path to the temp file */
protected $tempFile = '';
/** @var string Relative path of how the file should be saved in the archive */
protected $saveAsName = '';
/** @var array Contains the sorted (by dependencies) list of tables/views to backup */
protected $tables = [];
// **********************************************************************
// Protected fields (data handling)
// **********************************************************************
/** @var array Contains the configuration data of the tables */
protected $tables_data = [];
/** @var array Maps database table names to their abstracted format */
protected $table_name_map = [];
/** @var array Contains the dependencies of tables and views (temporary) */
protected $dependencies = [];
/** @var mixed The next table or DB entity to back up */
protected $nextTable;
/** @var integer The next row of the table to start backing up from */
protected $nextRange;
/** @var integer Current table's row count */
protected $maxRange;
/** @var bool Use extended INSERTs */
protected $extendedInserts = false;
/** @var integer Maximum packet size for extended INSERTs, in bytes */
protected $packetSize = 0;
/** @var string Extended INSERT query, while it's being constructed */
protected $query = '';
/** @var int Dump part's maximum size */
protected $partSize = 0;
/** @var resource Filepointer to the current dump part */
private $fp = null;
/**
* Should I be using an abstract prefix (#__) for table names?
*
* @var bool
* @since 9.1.0
*/
private $useAbstractPrefix;
/**
* Public constructor.
*
* @return void
* @since 9.1.0
*/
public function __construct()
{
$this->useAbstractPrefix =
Factory::getEngineParamsProvider()->getScriptingParameter('db.saveasname', 'normal') !== 'output';
parent::__construct();
}
/**
* This method is called when the factory is being serialized and is used to perform necessary cleanup steps.
*
* @return void
*/
public function _onSerialize()
{
$this->closeFile();
}
/**
* This method is called when the object is destroyed and is used to perform necessary cleanup steps.
*/
public function __destruct()
{
$this->closeFile();
}
/**
* Close any open SQL dump (output) file.
*/
public function closeFile()
{
if (!is_resource($this->fp))
{
return;
}
Factory::getLog()->debug("Closing SQL dump file.");
$this->conditionalFileClose($this->fp);
$this->fp = null;
}
/**
* Call a specific stage of the dump engine
*
* @param string $stage
*
* @throws Exception
*/
public function callStage($stage)
{
switch ($stage)
{
case '_prepare':
$this->_prepare();
break;
case '_run':
$this->_run();
break;
case '_finalize':
$this->_finalize();
break;
}
}
public function getPrefix(): string
{
return $this->prefix ?: '';
}
/**
* Find where to store the backup files
*
* @param $partNumber int The SQL part number, default is 0 (.sql)
*/
protected function getBackupFilePaths($partNumber = 0)
{
Factory::getLog()->debug(__CLASS__ . " :: Getting temporary file");
$basename = substr(self::md5(microtime() . random_bytes(8)), random_int(0, 16), 16);
$this->tempFile = Factory::getTempFiles()->registerTempFile($basename . '.sql');
Factory::getLog()->debug(__CLASS__ . " :: Temporary file is {$this->tempFile}");
// Get the base name of the dump file
$partNumber = intval($partNumber);
$baseName = $this->dumpFile;
if ($partNumber > 0)
{
// The file names are in the format dbname.sql, dbname.s01, dbname.s02, etc
if (strtolower(substr($baseName, -4)) == '.sql')
{
$baseName = substr($baseName, 0, -4) . '.s' . sprintf('%02u', $partNumber);
}
else
{
$baseName = $baseName . '.s' . sprintf('%02u', $partNumber);
}
}
if (empty($this->installerSettings))
{
// Fetch the installer settings
$this->installerSettings = (object) [
'installerroot' => 'installation',
'sqlroot' => 'installation/sql',
'databasesini' => 1,
'readme' => 1,
'extrainfo' => 1,
'password' => 0,
'typedtablelist' => 0,
];
$config = Factory::getConfiguration();
$installerKey = $config->get('akeeba.advanced.embedded_installer');
$installerDescriptors = Factory::getEngineParamsProvider()->getInstallerList();
if (array_key_exists($installerKey, $installerDescriptors))
{
// The selected installer exists, use it
$this->installerSettings = (object) $installerDescriptors[$installerKey];
}
elseif (array_key_exists('brs', $installerDescriptors))
{
// The selected installer doesn't exist, but ANGIE exists; use that instead
$this->installerSettings = (object) $installerDescriptors['brs'];
}
}
switch (Factory::getEngineParamsProvider()->getScriptingParameter('db.saveasname', 'normal'))
{
case 'output':
// The SQL file will be stored uncompressed in the output directory
$statistics = Factory::getStatistics();
$statRecord = $statistics->getRecord();
$this->saveAsName = $statRecord['absolute_path'];
break;
case 'normal':
// The SQL file will be stored in the SQL root of the archive, as
// specified by the particular embedded installer's settings
$this->saveAsName = $this->installerSettings->sqlroot . '/' . $baseName;
break;
case 'short':
// The SQL file will be stored on archive's root
$this->saveAsName = $baseName;
break;
}
if ($partNumber > 0)
{
Factory::getLog()->debug("AkeebaDomainDBBackup :: Creating new SQL dump part #$partNumber");
}
Factory::getLog()->debug("AkeebaDomainDBBackup :: SQL temp file is " . $this->tempFile);
Factory::getLog()->debug("AkeebaDomainDBBackup :: SQL file location in archive is " . $this->saveAsName);
}
/**
* Deletes any leftover files from previous backup attempts
*
*/
protected function removeOldFiles()
{
Factory::getLog()->debug("AkeebaDomainDBBackup :: Deleting leftover files, if any");
if (file_exists($this->tempFile))
{
@unlink($this->tempFile);
}
}
/**
* Populates the table arrays with the information for the db entities to back up
*
* @return void
*/
abstract protected function getTablesToBackup(): void;
/**
* Runs a step of the database dump
*
* @return void
*/
abstract protected function stepDatabaseDump(): void;
/**
* Return the current database name by querying the database connection object (e.g. SELECT DATABASE() in MySQL)
*
* @return string
*/
abstract protected function getDatabaseNameFromConnection(): string;
abstract protected function getAllTables(): array;
/**
* Implements the _prepare abstract method
*
* @throws Exception
*/
protected function _prepare()
{
$this->setStep('Initialization');
$this->setSubstep('');
// Process parameters, passed to us using the setup() public method
Factory::getLog()->debug(__CLASS__ . " :: Processing parameters");
if (is_array($this->_parametersArray))
{
$this->parametersArrayToProperties();
}
// Try to detect and rectify the wrong database table naming prefix
$this->workaroundWrongPrefix();
// Make sure we have self-assigned the first part
$this->partNumber = 0;
// Get DB backup only mode
$configuration = Factory::getConfiguration();
// Find tables to be included and put them in the $_tables variable
$this->getTablesToBackup();
// Find where to store the database backup files
$this->getBackupFilePaths($this->partNumber);
// Remove any leftovers
$this->removeOldFiles();
// Initialize the extended INSERTs feature
$this->extendedInserts = ($configuration->get('engine.dump.common.extended_inserts', 0) != 0);
$this->packetSize = (int) $configuration->get('engine.dump.common.packet_size', 0);
if ($this->packetSize == 0)
{
$this->extendedInserts = false;
}
// Initialize the split dump feature
$this->partSize = $configuration->get('engine.dump.common.splitsize', 1048576);
if (Factory::getEngineParamsProvider()->getScriptingParameter('db.saveasname', 'normal') == 'output')
{
$this->partSize = 0;
}
if (($this->partSize != 0) && ($this->packetSize != 0) && ($this->packetSize > $this->partSize))
{
$this->packetSize = floor($this->partSize / 2);
}
// Initialize the algorithm
Factory::getLog()->debug(__CLASS__ . " :: Initializing algorithm for first run");
$this->goToNextTable();
// If there is no table to back up we are done with the database backup
if ($this->nextTable === null)
{
$this->setState(self::STATE_POSTRUN);
return;
}
$this->nextRange = 0;
$this->query = '';
// FIX 2.2: First table of extra databases was not being written to disk.
// This deserved a place in the Bug Fix Hall Of Fame. In subsequent calls to _init, the $fp in
// _writeline() was not nullified. Therefore, the first dump chunk (that is, the first table's
// definition and first chunk of its data) were not written to disk. This call causes $fp to be
// nullified, causing it to be recreated, pointing to the correct file.
$null = null;
$this->writeline($null);
// Finally, mark ourselves "prepared".
$this->setState(self::STATE_PREPARED);
}
/**
* Get the next table to back up.
*
* Engines can override it to queue up more complex objects. Set $this->nextTable to NULL to indicate there is
* nothing else to back up.
*
* @return void
* @since 9.10.0
*/
protected function goToNextTable(): void
{
$this->nextTable = null;
if (empty($this->tables))
{
return;
}
$this->nextTable = array_shift($this->tables);
}
/**
* Implements the _run() abstract method
*
* @throws Exception
*/
protected function _run()
{
// Check if we are already done
if ($this->getState() == self::STATE_POSTRUN)
{
Factory::getLog()->debug(__CLASS__ . " :: Already finished");
$this->setStep("");
$this->setSubstep("");
return;
}
// Mark ourselves as still running (we will test if we actually do towards the end ;) )
$this->setState(self::STATE_RUNNING);
/**
* Resume packing / post-processing part files if necessary.
*
* @see \Akeeba\Engine\Archiver\BaseArchiver::putDataFromFileIntoArchive
*
* Sometimes the SQL part file may be bigger than the big file threshold (engine.archiver.common.
* big_file_threshold). In this case when we try to add it to the backup archive the archiver engine figures
* out it has to be added uncompressed, one chunk (engine.archiver.common.chunk_size) bytes at a time. This
* happens in a loop. We read a chunk, push it to the archive, rinse and repeat.
*
* There are two cases when we might break the loop:
*
* 1. Not enough free space in the backup archive part and engine.postproc.common.after_part (immediate post-
* processing) is enabled. We break the step to let the backup part be post-processed.
*
* 2. We ran out of time copying data.
*
* The following if-blocks deal with these two cases.
*/
if (Factory::getEngineParamsProvider()->getScriptingParameter('db.saveasname', 'normal') != 'output')
{
$archiver = Factory::getArchiverEngine();
$configuration = Factory::getConfiguration();
// Check whether we need to immediately post-processing a done part
if (Pack::postProcessDonePartFile($archiver, $configuration))
{
return;
}
// We had already started putting the DB dump file into the archive but it needs more time
if ($configuration->get('volatile.engine.archiver.processingfile', false))
{
/**
* We MUST NOT try to continue adding the file to the backup archive manually. Instead, we have to go
* through getNextDumpPart. This method will continue adding the part to the backup archive and when
* this is done it will remove the file and create a new one.
*
* If that method returns false it means that we either hit an error or the archiver didn't have enough
* time to add the part to the backup archive. In either case we have to return and let the Engine step.
*/
if ($this->getNextDumpPart() === false)
{
return;
}
}
}
$this->stepDatabaseDump();
$null = null;
$this->writeline($null);
}
/**
* Implements the _finalize() abstract method
*
* @throws Exception
*/
protected function _finalize()
{
Factory::getLog()->debug("Adding any extra SQL statements imposed by the filters");
foreach (Factory::getFilters()->getExtraSQL($this->databaseRoot) as $sqlStatement)
{
$sqlStatement = trim($sqlStatement) . "\n";
$this->writeDump($sqlStatement, true);
}
// We need this to write out the cached extra SQL statements before closing the file.
$this->writeDump(null, true);
// Close the file pointer (otherwise the SQL file is left behind)
$this->closeFile();
// If we are not just doing a main db only backup, add the SQL file to the archive
$finished = true;
if (Factory::getEngineParamsProvider()->getScriptingParameter('db.saveasname', 'normal') != 'output')
{
$archiver = Factory::getArchiverEngine();
$configuration = Factory::getConfiguration();
if ($configuration->get('volatile.engine.archiver.processingfile', false))
{
// We had already started archiving the db file, but it needs more time
Factory::getLog()->debug("Continuing adding the SQL dump to the archive");
$archiver->addFile(null, null, null);
$finished = !$configuration->get('volatile.engine.archiver.processingfile', false);
}
else
{
// We have to add the dump file to the archive
Factory::getLog()->debug("Adding the final SQL dump to the archive");
$archiver->addFileRenamed($this->tempFile, $this->saveAsName);
$finished = !$configuration->get('volatile.engine.archiver.processingfile', false);
}
}
else
{
// We just have to move the dump file to its final destination
Factory::getLog()->debug("Moving the SQL dump to its final location");
$result = Platform::getInstance()->move($this->tempFile, $this->saveAsName);
if (!$result)
{
Factory::getLog()->debug("Removing temporary file of final SQL dump");
Factory::getTempFiles()->unregisterAndDeleteTempFile($this->tempFile, true);
throw new RuntimeException('Could not move the SQL dump to its final location');
}
}
// Make sure that if the archiver needs more time to process the file we can supply it
if ($finished)
{
Factory::getLog()->debug("Removing temporary file of final SQL dump");
Factory::getTempFiles()->unregisterAndDeleteTempFile($this->tempFile, true);
$this->setState(self::STATE_FINISHED);
}
}
/**
* Creates a new dump part
*
* @return bool
* @throws Exception
*/
protected function getNextDumpPart()
{
// On database dump only mode we mustn't create part files!
if (Factory::getEngineParamsProvider()->getScriptingParameter('db.saveasname', 'normal') == 'output')
{
return false;
}
// Is the archiver still processing?
$configuration = Factory::getConfiguration();
$archiver = Factory::getArchiverEngine();
$stillProcessing = $configuration->get('volatile.engine.archiver.processingfile', false);
if ($stillProcessing)
{
/**
* The archiver is still adding the previous dump part. This means that we are called from the top few lines
* of the _run method. We must continue adding the previous dump part.
*/
Factory::getLog()->debug("Continuing adding the SQL dump part to the archive");
$archiver->addFile('', '', '');
}
else
{
/**
* There is no other dump part being processed. Therefore the current SQL dump part is still open. We must
* close it and ask the archiver to add it to the backup archive.
*/
$this->closeFile();
Factory::getLog()->debug("Adding the SQL dump part to the archive");
$archiver->addFileRenamed($this->tempFile, $this->saveAsName);
}
// Return false if the file didn't finish getting added to the archive
if ($configuration->get('volatile.engine.archiver.processingfile', false))
{
Factory::getLog()->debug("The SQL dump file has not been processed thoroughly by the archiver. Resuming in the next step.");
return false;
}
/**
* If you are here the SQL dump part file is completely added to the backup archive. All we have to do now is
* remove it and create a new dump part file.
*/
// Remove the old file
Factory::getLog()->debug("Removing dump part's temporary file");
Factory::getTempFiles()->unregisterAndDeleteTempFile($this->tempFile, true);
// Create the new dump part
$this->partNumber++;
$this->getBackupFilePaths($this->partNumber);
$null = null;
$this->writeline($null);
return true;
}
/**
* Creates a new dump part, but only if required to do so
*
* @return bool
* @throws Exception
*/
protected function createNewPartIfRequired()
{
if ($this->partSize == 0)
{
return true;
}
$filesize = 0;
if (@file_exists($this->tempFile))
{
$filesize = @filesize($this->tempFile);
}
$projectedSize = $filesize + strlen($this->query);
if ($this->extendedInserts)
{
$projectedSize = $filesize + $this->packetSize;
}
if ($projectedSize > $this->partSize)
{
return $this->getNextDumpPart();
}
return true;
}
/**
* Returns a table's abstract name (replacing the prefix with the magic #__ string)
*
* @param string $tableName The canonical name, e.g. 'jos_content'
*
* @return string The abstract name, e.g. '#__content'
*/
protected function getAbstract($tableName)
{
// Don't return abstract names for non-CMS tables
if (is_null($this->prefix))
{
return $tableName;
}
switch ($this->prefix)
{
case '':
if ($this->processEmptyPrefix)
{
// This is more of a hack; it assumes all tables are core CMS tables if the prefix is empty.
return '#__' . $tableName;
}
// If $this->processEmptyPrefix (the process_empty_prefix config flag) is false, we don't
// assume anything.
return $tableName;
break;
default:
// Normal behaviour for 99% of sites. Start by assuming the table has no prefix, therefore is non-core.
$tableAbstract = $tableName;
// If there's a prefix use the abstract name
if (!empty($this->prefix) && (substr($tableName, 0, strlen($this->prefix)) == $this->prefix))
{
$tableAbstract = '#__' . substr($tableName, strlen($this->prefix));
}
return $tableAbstract;
break;
}
}
/**
* Writes the SQL dump into the output files. If it fails, it sets the error
*
* @param string $data Data to write to the dump file. Pass NULL to force flushing to file.
* @param bool $addMarker Should I prefix the data with a marker?
*
* @return boolean TRUE on successful write, FALSE otherwise
* @throws Exception
*/
protected function writeDump($data, $addMarker = false)
{
if (!empty($data))
{
if ($addMarker && $this->useAbstractPrefix)
{
$this->data_cache .= '/**ABDB**/';
}
elseif (!$this->useAbstractPrefix)
{
// Replace #__ with the prefix when writing plain .sql files
$db = $this->getDB();
$data = $db->replacePrefix($data) . "\n";
}
$this->data_cache .= $data;
if (strlen($data) > $this->largest_query)
{
$this->largest_query = strlen($data);
Factory::getConfiguration()->set('volatile.database.largest_query', $this->largest_query);
}
}
if ((strlen($this->data_cache) >= $this->cache_size) || (is_null($data) && (!empty($this->data_cache))))
{
$this->data_cache = rtrim($this->data_cache, "\n");
if ($this->useAbstractPrefix && $addMarker && substr($this->data_cache, -10) !== '/**ABDB**/')
{
$this->data_cache .= '/**ABDB**/';
}
$this->data_cache .= "\n";
Factory::getLog()->debug("Writing " . strlen($this->data_cache) . " bytes to the dump file");
$result = $this->writeline($this->data_cache);
if (!$result)
{
$errorMessage = sprintf('Couldn\'t write to the SQL dump file %s; check the temporary directory permissions and make sure you have enough disk space available.', $this->tempFile);
throw new RuntimeException($errorMessage);
}
$this->data_cache = '';
}
return true;
}
/**
* Saves the string in $fileData to the file $backupfile. Returns TRUE. If saving
* failed, return value is FALSE.
*
* @param string $fileData Data to write. Set to null to close the file handle.
*
* @return boolean TRUE is saving to the file succeeded
* @throws Exception
*/
protected function writeline(&$fileData)
{
if (!is_resource($this->fp))
{
$this->fp = @fopen($this->tempFile, 'a');
if ($this->fp === false)
{
throw new RuntimeException('Could not open ' . $this->tempFile . ' for append, in DB dump.');
}
}
if (is_null($fileData))
{
$this->conditionalFileClose($this->fp);
$this->fp = null;
return true;
}
else
{
if ($this->fp)
{
$ret = fwrite($this->fp, $fileData);
@clearstatcache();
// Make sure that all data was written to disk
return ($ret == strlen($fileData));
}
return false;
}
}
/**
* Return an instance of DriverBase
*
* @return DriverBase|bool
*
* @throws Exception
*/
protected function &getDB()
{
$ssl = $this->ssl ?? [];
$ssl = is_array($ssl) ? $ssl : [];
$options = [
'driver' => $this->driver,
'host' => $this->host,
'port' => $this->port,
'socket' => $this->socket,
'user' => $this->username,
'password' => $this->password,
'database' => $this->database,
'prefix' => is_null($this->prefix) ? '' : $this->prefix,
'ssl' => $ssl,
];
$db = Factory::getDatabase($options);
if ($db->getErrorNum() > 0)
{
$error = $db->getErrorMsg();
throw new RuntimeException(__CLASS__ . ' :: Database Error: ' . $error);
}
return $db;
}
/**
* Returns the database name. If the name was not declared when the object was created we will go through the
* getDatabaseNameFromConnection method to populate it.
*
* @return string
*/
protected function getDatabaseName()
{
if (empty($this->database) && $this->database !== '0')
{
$this->database = $this->getDatabaseNameFromConnection();
}
return $this->database;
}
/**
* Post process a quoted value before it's written to the database dump.
* So far it's only required for SQL Server which has a problem escaping
* newline characters...
*
* @param string $value The quoted value to post-process
*
* @return string
*/
protected function postProcessQuotedValue($value)
{
return $value;
}
/**
* Returns a preamble for the data dump portion of the SQL backup. This is
* used to output commands before the first INSERT INTO statement for a
* table when outputting a plain SQL file.
*
* Practical use: the SET IDENTITY_INSERT sometable ON required for SQL Server
*
* @param string $tableAbstract Abstract name of the table, e.g. #__foobar
* @param string $tableName Real name of the table, e.g. abc_foobar
* @param integer $maxRange Row count on this table
*
* @return string The SQL commands you want to be written in the dump file
*/
protected function getDataDumpPreamble($tableAbstract, $tableName, $maxRange)
{
return '';
}
/**
* Returns an epilogue for the data dump portion of the SQL backup. This is
* used to output commands after the last INSERT INTO statement for a
* table when outputting a plain SQL file.
*
* Practical use: the SET IDENTITY_INSERT sometable OFF required for SQL Server
*
* @param string $tableAbstract Abstract name of the table, e.g. #__foobar
* @param string $tableName Real name of the table, e.g. abc_foobar
* @param integer $maxRange Row count on this table
*
* @return string The SQL commands you want to be written in the dump file
*/
protected function getDataDumpEpilogue($tableAbstract, $tableName, $maxRange)
{
return '';
}
/**
* Return a list of field names for the INSERT INTO statements. This is only
* required for Microsoft SQL Server because without it the SET IDENTITY_INSERT
* has no effect.
*
* @param array|string $fieldNames A list of field names in array format or '*' if it's all fields
*
* @return string
* @throws Exception
*/
protected function getFieldListSQL($fieldNames)
{
// If we get a literal '*' we dumped all columns so we don't need to add column names in the INSERT.
if ($fieldNames === '*')
{
return '';
}
return '(' . implode(', ', array_map([$this->getDB(), 'qn'], $fieldNames)) . ')';
}
/**
* Return a list of columns to use in the SELECT query for dumping table data.
*
* This is used to filter out all generated rows.
*
* @param string $tableAbstract
*
* @return string|array An array of table columns or the string literal '*' to quickly select all columns.
*
* @see https://dev.mysql.com/doc/refman/5.7/en/create-table-generated-columns.html
*/
protected function getSelectColumns($tableAbstract)
{
return '*';
}
/**
* Converts a human formatted size to integer representation of bytes,
* e.g. 1M to 1024768
*
* @param string $setting The value in human readable format, e.g. "1M"
*
* @return integer The value in bytes
*/
protected function humanToIntegerBytes($setting)
{
$val = trim($setting);
$last = strtolower($val[strlen($val) - 1]);
if (is_numeric($last))
{
return $setting;
}
switch ($last)
{
case 't':
$val *= 1024;
case 'g':
$val *= 1024;
case 'm':
$val *= 1024;
case 'k':
$val *= 1024;
}
return (int) $val;
}
/**
* Get the PHP memory limit in bytes
*
* @return int|null Memory limit in bytes or null if we can't figure it out.
*/
protected function getMemoryLimit()
{
if (!function_exists('ini_get'))
{
return null;
}
$memLimit = ini_get("memory_limit");
if ((is_numeric($memLimit) && ($memLimit < 0)) || !is_numeric($memLimit))
{
$memLimit = 0; // 1.2a3 -- Rare case with memory_limit < 0, e.g. -1Mb!
}
$memLimit = $this->humanToIntegerBytes($memLimit);
return $memLimit;
}
/**
* @return void
*/
private function parametersArrayToProperties(): void
{
$this->driver = $this->_parametersArray['driver'] ?? $this->driver;
$this->host = $this->_parametersArray['host'] ?? $this->host;
$this->port = $this->_parametersArray['port'] ?? $this->port;
$this->socket = $this->_parametersArray['socket'] ?? $this->socket;
$this->username = $this->_parametersArray['username'] ?? $this->username;
$this->username = $this->_parametersArray['user'] ?? $this->username;
$this->password = $this->_parametersArray['password'] ?? $this->password;
$this->database = $this->_parametersArray['database'] ?? $this->database;
$this->prefix = $this->_parametersArray['prefix'] ?? $this->prefix;
$this->dumpFile = $this->_parametersArray['dumpFile'] ?? $this->dumpFile;
$this->processEmptyPrefix = $this->_parametersArray['process_empty_prefix'] ?? $this->processEmptyPrefix;
$this->ssl = $this->_parametersArray['ssl'] ?? $this->ssl;
$this->ssl = is_array($this->ssl) ? $this->ssl : [];
$this->ssl['enable'] = (bool) (($this->ssl['enable'] ?? $this->_parametersArray['dbencryption'] ?? false) ?: false);
$this->ssl['cipher'] = ($this->ssl['cipher'] ?? $this->_parametersArray['dbsslcipher'] ?? null) ?: null;
$this->ssl['ca'] = ($this->ssl['ca'] ?? $this->_parametersArray['dbsslca'] ?? null) ?: null;
$this->ssl['capath'] = ($this->ssl['capath'] ?? $this->_parametersArray['dbsslcapath'] ?? null) ?: null;
$this->ssl['key'] = ($this->ssl['key'] ?? $this->_parametersArray['dbsslkey'] ?? null) ?: null;
$this->ssl['cert'] = ($this->ssl['cert'] ?? $this->_parametersArray['dbsslcert'] ?? null) ?: null;
$this->ssl['verify_server_cert'] = (bool) (($this->ssl['verify_server_cert'] ?? $this->_parametersArray['dbsslverifyservercert'] ?? false) ?: false);
}
private function workaroundWrongPrefix(): void
{
// Let's see what kind of prefix I have
$allLowerCasePrefix = strtolower($this->prefix);
$allUpperCasePrefix = strtoupper($this->prefix);
$isUpperCasePrefix = $this->prefix === $allUpperCasePrefix;
$isLowerCasePrefix = $this->prefix === $allLowerCasePrefix;
$isMixedCasePrefix = !$isUpperCasePrefix && !$isLowerCasePrefix;
// Log a message
if ($isUpperCasePrefix)
{
Factory::getLog()->info(
sprintf(
'You have an all uppercase database prefix (%s). This might cause backup and restoration issues. We are applying automatic mitigations.',
$this->prefix
)
);
}
elseif (!$isLowerCasePrefix)
{
Factory::getLog()->info(
sprintf(
'You have a mixed-case database prefix (%s). This might cause backup and restoration issues. We are applying automatic mitigations.',
$this->prefix
)
);
}
// Check if I have any tables with any form of the prefix
$allTables = $this->getAllTables();
$hasOriginalTables = array_reduce(
$allTables,
function (bool $carry, string $table): bool {
return $carry || substr($table, 0, strlen($this->prefix)) === $this->prefix;
},
false
);
$hasLowercaseTables = array_reduce(
$allTables,
function (bool $carry, string $table) use ($allLowerCasePrefix): bool {
return $carry || substr($table, 0, strlen($allLowerCasePrefix)) === $allLowerCasePrefix;
},
false
);
$hasUppercaseTables = array_reduce(
$allTables,
function (bool $carry, string $table) use ($allUpperCasePrefix): bool {
return $carry || substr($table, 0, strlen($allUpperCasePrefix)) === $allUpperCasePrefix;
},
false
);
$hasWrongMixedCaseTables = array_reduce(
$allTables,
function (bool $carry, string $table) use ($allUpperCasePrefix, $allLowerCasePrefix): bool {
if ($carry)
{
return $carry;
}
$prefix = substr($table, 0, strlen($allUpperCasePrefix));
if ($prefix === $allUpperCasePrefix || $prefix === $allLowerCasePrefix || $prefix === $this->prefix)
{
return false;
}
return strtolower($prefix) === strtolower($this->prefix);
},
false
);
// Set up the warning message
$warningMessage = sprintf(
'You have database tables whose name starts with a form of the database prefix (%s) which has a different letter case. This WILL cause problems if you restore your site on Windows or macOS. We strongly recommend excluding all tables which do not start with the configured prefix, exactly as shown above (case-sensitive).',
$this->prefix
);
/**
* We have tables returned with the original prefix (e.g. fOo_).
*
* We won't change the prefix, but we have to warn the user if there is a mix of prefixes in the installed
* tables.
*
* We warn when:
* - Any kind of prefix, there are tables with a mixed case prefix which doesn't match the configured one.
* - Lowercase prefix, there are uppercase tables
* - Uppercase prefix, there are lowercase tables
* - Mixed case prefix, there are upper- or lowercase tables
*/
if ($hasOriginalTables)
{
if (
$hasWrongMixedCaseTables
|| ($isLowerCasePrefix && $hasUppercaseTables)
|| ($isUpperCasePrefix && $hasLowercaseTables)
|| ($isMixedCasePrefix && ($hasLowercaseTables || $hasUppercaseTables))
)
{
Factory::getLog()->warning($warningMessage);
}
return;
}
/**
* No tables with this prefix. Nothing for me to do.
*
* At this point we have checked if there are any tables with the mixed case prefix, the all lowercase prefix,
* and the uppercase prefix. None was found in any of these cases.
*
* I will not change the prefix to back up. However, if there are tables with the wrong mixed case format of the
* prefix I will have to issue a warning.
*/
if (!$hasLowercaseTables && !$hasUppercaseTables)
{
if ($hasWrongMixedCaseTables)
{
Factory::getLog()->warning($warningMessage);
}
return;
}
if (
($isLowerCasePrefix && !$hasLowercaseTables && $hasUppercaseTables)
|| ($isMixedCasePrefix && $hasUppercaseTables)
)
{
Factory::getLog()->info(
sprintf(
'Auto-fixing the database prefix: you have configured the database table name prefix %s but we could not find any tables with this prefix. Instead, we found tables with the %s prefix; using that instead.',
$this->prefix, $allUpperCasePrefix
)
);
$this->_parametersArray['prefix'] = $allUpperCasePrefix;
$this->prefix = $allUpperCasePrefix;
}
elseif (
($isUpperCasePrefix && !$hasUppercaseTables && $hasLowercaseTables)
|| ($isMixedCasePrefix && $hasLowercaseTables)
)
{
Factory::getLog()->info(
sprintf(
'Auto-fixing the database prefix: you have configured the database table name prefix %s but we could not find any tables with this prefix. Instead, we found tables with the %s prefix; using that instead.',
$this->prefix, $allLowerCasePrefix
)
);
$this->_parametersArray['prefix'] = $allLowerCasePrefix;
$this->prefix = $allLowerCasePrefix;
}
else
{
Factory::getLog()->warning(
sprintf(
'WRONG DATABASE PREFIX. You have configured the database table name prefix %s but we could not find any tables with this prefix, its lowercase (%s) or uppercase (%s) form. THIS WILL CAUSE RESTORATION PROBLEMS. Please rename your tables starting with different forms of the %1$s prefix so that they all start with its lowercase form (%2$s), then retake the backup.',
$this->prefix, $allLowerCasePrefix, $allUpperCasePrefix
)
);
return;
}
if ($hasLowercaseTables && $hasUppercaseTables)
{
Factory::getLog()->warning($warningMessage);
}
}
}
PK \qۙ + vendor/akeeba/engine/engine/Dump/Native.phpnu [ .
*/
namespace Akeeba\Engine\Dump;
defined('AKEEBAENGINE') || die();
use Akeeba\Engine\Base\Exceptions\ErrorException;
use Akeeba\Engine\Base\Part;
use Akeeba\Engine\Dump\Base as DumpBase;
use Akeeba\Engine\Factory;
use RuntimeException;
#[\AllowDynamicProperties]
class Native extends Part
{
/** @var DumpBase */
private $_engine = null;
private $tablePrefix;
/**
* Implements the constructor of the class
*
* @return void
*/
public function __construct()
{
parent::__construct();
Factory::getLog()->debug(__CLASS__ . " :: New instance");
}
/**
* Runs the preparation for this part. Should set _isPrepared
* to true
*
* @return void
*/
protected function _prepare()
{
Factory::getLog()->debug(__CLASS__ . " :: Processing parameters");
$options = null;
// Get the DB connection parameters
if (is_array($this->_parametersArray))
{
$driver = $this->_parametersArray['driver'] ?? 'mysql';
$prefix = $this->_parametersArray['prefix'] ?? '';
if (($driver == 'mysql') && !function_exists('mysql_connect'))
{
$driver = 'mysqli';
}
$options = [
'driver' => $driver,
'host' => $this->_parametersArray['host'] ?? '',
'port' => $this->_parametersArray['port'] ?? '',
'user' => $this->_parametersArray['user'] ?? ($this->_parametersArray['username'] ?? ''),
'password' => $this->_parametersArray['password'] ?? '',
'database' => $this->_parametersArray['database'] ?? '',
'schema' => $this->_parametersArray['schema'] ?? '',
'prefix' => is_null($prefix) ? '' : $prefix,
];
$options['ssl'] = $this->_parametersArray['ssl'] ?? [];
$options['ssl'] = is_array($options['ssl']) ? $options['ssl'] : [];
$options['ssl']['enable'] = (bool) ($options['ssl']['enable'] ?? $this->_parametersArray['dbencryption'] ?? false);
$options['ssl']['cipher'] = ($options['ssl']['cipher'] ?? $this->_parametersArray['dbsslcipher'] ?? null) ?: null;
$options['ssl']['ca'] = ($options['ssl']['ca'] ?? $this->_parametersArray['dbsslca'] ?? null) ?: null;
$options['ssl']['capath'] = ($options['ssl']['capath'] ?? $this->_parametersArray['dbsslcapath'] ?? null) ?: null;
$options['ssl']['key'] = ($options['ssl']['key'] ?? $this->_parametersArray['dbsslkey'] ?? null) ?: null;
$options['ssl']['cert'] = ($options['ssl']['cert'] ?? $this->_parametersArray['dbsslcert'] ?? null) ?: null;
$options['ssl']['verify_server_cert'] = (bool) (($options['ssl']['verify_server_cert'] ?? $this->_parametersArray['dbsslverifyservercert'] ?? false) ?: false);
}
$db = Factory::getDatabase($options);
if ($db->getErrorNum() > 0)
{
$error = $db->getErrorMsg();
throw new RuntimeException(__CLASS__ . ' :: Database Error: ' . $error);
}
$driverType = $db->getDriverType();
if ($driverType == 'pgsql')
{
$driverType = 'postgres';
}
$className = '\\Akeeba\\Engine\\Dump\\Native\\' . ucfirst($driverType);
// Check if we have a native dump driver
if (!class_exists($className, true))
{
$this->setState(self::STATE_ERROR);
throw new ErrorException('Akeeba Engine does not have a native dump engine for ' . $driverType . ' databases');
}
Factory::getLog()->debug(__CLASS__ . " :: Instanciating new native database dump engine $className");
$this->_engine = new $className;
$this->_engine->setup($this->_parametersArray);
$this->_engine->callStage('_prepare');
$this->setState($this->_engine->getState());
$this->tablePrefix = $this->_engine->getPrefix();
}
/**
* Runs the finalisation process for this part. Should set
* _isFinished to true.
*
* @return void
*/
protected function _finalize()
{
$this->_engine->callStage('_finalize');
$this->setState($this->_engine->getState());
}
/**
* Runs the main functionality loop for this part. Upon calling,
* should set the _isRunning to true. When it finished, should set
* the _hasRan to true. If an error is encountered, setError should
* be used.
*
* @return void
*/
protected function _run()
{
$this->_engine->callStage('_run');
$this->setState($this->_engine->getState());
$this->setStep($this->_engine->getStep());
$this->setSubstep($this->_engine->getSubstep());
$this->partNumber = $this->_engine->partNumber;
}
/**
* Get the database table prefix
*
* @return string The database prefix
*/
public function getPrefix()
{
return $this->tablePrefix;
}
}
PK \Sʉ * vendor/akeeba/engine/engine/Dump/.htaccessnu 7m
Order allow,deny
Deny from all
PK \|N & vendor/akeeba/engine/engine/web.confignu [
PK \Sʉ % vendor/akeeba/engine/engine/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ vendor/akeeba/engine/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ vendor/akeeba/.htaccessnu 7m
Order allow,deny
Deny from all
PK \o + vendor/greenlion/php-sql-parser/phpunit.xmlnu [
tests./src
PK \K:0 0 @ vendor/greenlion/php-sql-parser/examples/OracleSQLTranslator.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser;
require_once dirname(__FILE__) . '/../vendor/autoload.php';
include_once $rootdir . '/classes/adodb/adodb.inc.php';
$_ENV['DEBUG'] = 1;
/**
* This class enhances the PHPSQLCreator to translate incoming
* parser output into another SQL dialect (here: Oracle SQL).
*
* @author arothe
*
*/
class OracleSQLTranslator extends PHPSQLCreator {
private $con; # this is the database connection from LimeSurvey
private $preventColumnRefs = array();
private $allTables = array();
const ASTERISK_ALIAS = "[#RePl#]";
public function __construct($con) {
parent::__construct();
$this->con = $con;
$this->initGlobalVariables();
}
private function initGlobalVariables() {
$this->preventColumnRefs = false;
$this->allTables = array();
}
public static function dbgprint($txt) {
if (isset($_ENV['DEBUG'])) {
print $txt;
}
}
public static function preprint($s, $return = false) {
$x = "
";
$x .= print_r($s, 1);
$x .= "
";
if ($return) {
return $x;
}
self::dbgprint($x . " \n");
}
protected function processAlias($parsed) {
if ($parsed === false) {
return "";
}
# we don't need an AS between expression and alias
$sql = " " . $parsed['name'];
return $sql;
}
protected function processDELETE($parsed) {
if (count($parsed['TABLES']) > 1) {
die("cannot translate delete statement into Oracle dialect, multiple tables are not allowed.");
}
return "DELETE";
}
public static function getColumnNameFor($column) {
if (strtolower($column) === 'uid') {
$column = "uid_";
}
// TODO: add more here, if necessary
return $column;
}
public static function getShortTableNameFor($table) {
if (strtolower($table) === 'surveys_languagesettings') {
$table = 'surveys_lngsettings';
}
// TODO: add more here, if necessary
return $table;
}
protected function processTable($parsed, $index) {
if ($parsed['expr_type'] !== 'table') {
return "";
}
$sql = $this->getShortTableNameFor($parsed['table']);
$alias = $this->processAlias($parsed['alias']);
$sql .= $alias;
if ($index !== 0) {
$sql = $this->processJoin($parsed['join_type']) . " " . $sql;
$sql .= $this->processRefType($parsed['ref_type']);
$sql .= $this->processRefClause($parsed['ref_clause']);
}
# store the table and its alias for later use
$last = array_pop($this->allTables);
$last['tables'][] = array('table' => $this->getShortTableNameFor($parsed['table']), 'alias' => trim($alias));
$this->allTables[] = $last;
return $sql;
}
protected function processFROM($parsed) {
$this->allTables[] = array('tables' => array(), 'alias' => '');
return parent::processFROM($parsed);
}
protected function processTableExpression($parsed, $index) {
if ($parsed['expr_type'] !== 'table_expression') {
return "";
}
$sql = substr($this->processFROM($parsed['sub_tree']), 5); // remove FROM keyword
$sql = "(" . $sql . ")";
$alias .= $this->processAlias($parsed['alias']);
$sql .= $alias;
# store the tables-expression-alias for later use
$last = array_pop($this->allTables);
$last['alias'] = trim($alias);
$this->allTables[] = $last;
if ($index !== 0) {
$sql = $this->processJoin($parsed['join_type']) . " " . $sql;
$sql .= $this->processRefType($parsed['ref_type']);
$sql .= $this->processRefClause($parsed['ref_clause']);
}
return $sql;
}
private function getTableNameFromExpression($expr) {
$pos = strpos($expr, ".");
if ($pos === false) {
$pos = -1;
}
return trim(substr($expr, 0, $pos + 1), ".");
}
private function getColumnNameFromExpression($expr) {
$pos = strpos($expr, ".");
if ($pos === false) {
$pos = -1;
}
return substr($expr, $pos + 1);
}
private function isCLOBColumnInDB($table, $column) {
$res = $this->con->GetOne(
"SELECT count(*) FROM user_lobs WHERE table_name='" . strtoupper($table) . "' AND column_name='"
. strtoupper($column) . "'");
return ($res >= 1);
}
protected function isCLOBColumn($table, $column) {
$tables = end($this->allTables);
if ($table === "") {
foreach ($tables['tables'] as $k => $v) {
if ($this->isCLOBColumn($v['table'], $column)) {
return true;
}
}
return false;
}
# check the aliases, $table cannot be empty
foreach ($tables['tables'] as $k => $v) {
if ((strtolower($v['alias']) === strtolower($table))
|| (strtolower($tables['alias']) === strtolower($table))) {
if ($this->isCLOBColumnInDB($v['table'], $column)) {
return true;
}
}
}
# it must be a valid table name
return $this->isCLOBColumnInDB($table, $column);
}
protected function processOrderByExpression($parsed) {
if ($parsed['expr_type'] !== 'expression') {
return "";
}
$table = $this->getTableNameFromExpression($parsed['base_expr']);
$col = $this->getColumnNameFromExpression($parsed['base_expr']);
$sql = ($table !== "" ? $table . "." : "") . $col;
# check, if the column is a CLOB
if ($this->isCLOBColumn($table, $col)) {
$sql = "cast(substr(" . $sql . ",1,200) as varchar2(200))";
}
return $sql . " " . $parsed['direction'];
}
protected function processColRef($parsed) {
if ($parsed['expr_type'] !== 'colref') {
return "";
}
$table = $this->getTableNameFromExpression($parsed['base_expr']);
$col = $this->getColumnNameFromexpression($parsed['base_expr']);
# we have to change the column name, if the column is uid
# we have to change the tablereference, if the tablename is too long
$col = $this->getColumnNameFor($col);
$table = $this->getShortTableNameFor($table);
# if we have * as colref, we cannot use other columns
# we have to add alias.* if we know all table aliases
if (($table === "") && ($col === "*")) {
array_pop($this->preventColumnRefs);
$this->preventColumnRefs[] = true;
return ASTERISK_ALIAS; # this is the position, we have to replace later
}
$alias = "";
if (isset($parsed['alias'])) {
$alias = $this->processAlias($parsed['alias']);
}
return (($table !== "") ? ($table . "." . $col) : $col) . $alias;
}
protected function processFunctionOnSelect($parsed) {
$old = end($this->preventColumnRefs);
$sql = $this->processFunction($parsed);
if ($old !== end($this->preventColumnRefs)) {
# prevents wrong handling of count(*)
array_pop($this->preventColumnRefs);
$this->preventColumnRefs[] = $old;
$sql = str_replace(ASTERISK_ALIAS, "*", $sql);
}
return $sql;
}
protected function processSELECT($parsed) {
$this->preventColumnRefs[] = false;
$sql = "";
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->processColRef($v);
$sql .= $this->processSelectExpression($v);
$sql .= $this->processFunctionOnSelect($v);
$sql .= $this->processConstant($v);
if ($len == strlen($sql)) {
$this->stop('SELECT', $k, $v, 'expr_type');
}
$sql .= ",";
}
$sql = substr($sql, 0, -1);
return "SELECT " . $sql;
}
private function correctColRefStatement($sql) {
$alias = "";
$tables = end($this->allTables);
# should we correct the selection list?
if (array_pop($this->preventColumnRefs)) {
# do we have a table-expression alias?
if ($tables['alias'] !== "") {
$alias = $tables['alias'] . ".*";
} else {
foreach ($tables['tables'] as $k => $v) {
$alias .= ($v['alias'] === "" ? $v['table'] : $v['alias']) . ".*,";
}
$alias = substr($alias, 0, -1);
}
$sql = str_replace(ASTERISK_ALIAS, $alias, $sql);
}
return $sql;
}
protected function processSelectStatement($parsed) {
$sql = $this->processSELECT($parsed['SELECT']);
$from = $this->processFROM($parsed['FROM']);
# correct * references with tablealias.*
# this must be called after processFROM(), because we need the table information
$sql = $this->correctColRefStatement($sql) . " " . $from;
if (isset($parsed['WHERE'])) {
$sql .= " " . $this->processWHERE($parsed['WHERE']);
}
if (isset($parsed['GROUP'])) {
$sql .= " " . $this->processGROUP($parsed['GROUP']);
}
if (isset($parsed['ORDER'])) {
$sql .= " " . $this->processORDER($parsed['ORDER']);
}
# select finished, we remove its tables
# FIXME: we should add it to the previous tablelist with the
# global alias, if such one exists
array_pop($this->allTables);
return $sql;
}
public function create($parsed) {
$k = key($parsed);
switch ($k) {
case "USE":
# this statement is not an Oracle statement
$this->created = "";
break;
default:
$this->created = parent::create($parsed);
break;
}
return $this->created;
}
public function process($sql) {
self::dbgprint($sql . " ");
$this->initGlobalVariables();
$parser = new PHPSQLParser($sql);
self::preprint($parser->parsed);
$sql = $this->create($parser->parsed);
self::dbgprint($sql . " ");
return $sql;
}
}
//$translator = new OracleSQLTranslator(false);
//$translator->process("SELECT q.qid, question, gid FROM questions as q WHERE (select count(*) from answers as a where a.qid=q.qid and scale_id=0)=0 and sid=11929 AND type IN ('F', 'H', 'W', 'Z', '1') and q.parent_qid=0");
//$translator->process("SELECT *, (SELECT a from xyz WHERE b>1) haha, (SELECT *, b from zks,abc WHERE d=1) hoho FROM blubb d, blibb c WHERE d.col = c.col");
?>PK \1A 4 vendor/greenlion/php-sql-parser/examples/example.phpnu [ parsed);
echo "parse time simplest query:" . ($stop - $start) . "\n";
/*You can use the constuctor for parsing. The parsed statement is stored at the ->parsed property.*/
$sql = 'REPLACE INTO table (a,b,c) VALUES (1,2,3)';
echo $sql . "\n";
$start = microtime(true);
$parser = new PHPSQLParser($sql);
$stop = microtime(true);
print_r($parser->parsed);
echo "parse time very somewhat simple statement:" . ($stop - $start) . "\n";
/* You can use the ->parse() method too. The parsed structure is returned, and
also available in the ->parsed property. */
$sql = 'SELECT a,b,c
from some_table an_alias
where d > 5;';
echo $sql . "\n";
print_r($parser->parse($sql, true));
$sql = 'SELECT a,b,c
from some_table an_alias
join `another` as `another table` using(id)
where d > 5;';
echo $sql . "\n";
$parser = new PHPSQLParser($sql, true);
print_r($parser->parsed);
$sql = 'SELECT a,b,c
from some_table an_alias
join (select d, max(f) max_f
from some_table
where id = 37
group by d) `subqry` on subqry.d = an_alias.d
where d > 5;';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = "(select `c2`, `c```, \"quoted \'string\' \\\" with `embedded`\\\"\\\" quotes\" as `an``alias` from table table)
UNION ALL (select `c2`, `c```, \"quoted \'string\' \\\" with `embedded`\\\"\\\" quotes\" as `an``alias` from table table)";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = "(select `c2`, `c```, \"quoted \'string\' \\\" with `embedded`\\\"\\\" quotes\" as `an``alias` from table table)
UNION (select `c2`, `c```, \"quoted \'string\' \\\" with `embedded`\\\"\\\" quotes\" as `an``alias` from table table)";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = "select `c2`, `c```, \"quoted \'string\' \\\" with `embedded`\\\"\\\" quotes\" as `an``alias` from table table";
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = "alter table xyz add key my_key(a,b,c), drop primay key";
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'INSERT INTO table (a,b,c) VALUES (1,2,3)
ON DUPLICATE KEY UPDATE id=LAST_INSERT_ID(id), c=3;';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'UPDATE t1 SET col1 = col1 + 1, col2 = col1;';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'DELETE FROM t1, t2 USING t1 INNER JOIN t2 INNER JOIN t3
WHERE t1.id=t2.id AND t2.id=t3.id;';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'delete low_priority partitioned_table.* from partitioned_table where partition_id = 1;';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = "UPDATE t1 SET col1 = col1 + 1, col2 = col1;";
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'insert into partitioned_table (partition_id, some_col) values (1,2);';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'delete from partitioned_table where partition_id = 1;';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'SELECT 1';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'SHOW TABLE STATUS';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'SHOW TABLES';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'select DISTINCT 1+2 c1, 1+ 2 as
`c2`, sum(c2),"Status" = CASE
WHEN quantity > 0 THEN \'in stock\'
ELSE \'out of stock\'
END
, t4.c1, (select c1+c2 from t1 inner_t1 limit 1) as subquery into @a1, @a2, @a3 from t1 the_t1 left outer join t2 using(c1,c2) join t3 as tX on tX.c1 = the_t1.c1 natural join t4 t4_x using(cX) where c1 = 1 and c2 in (1,2,3, "apple") and exists ( select 1 from some_other_table another_table where x > 1) and ("zebra" = "orange" or 1 = 1) group by 1, 2 having sum(c2) > 1 ORDER BY 2, c1 DESC LIMIT 0, 10 into outfile "/xyz" FOR UPDATE LOCK IN SHARE MODE';
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = "(select 1, 1, 1, 1 from dual dual1) union all (select 2, 2, 2, 2 from dual dual2) union all (select c1,c2,c3,sum(c4) from (select c1,c2,c3,c4 from a_table where c2 = 1) subquery group by 1,2,3) limit 10";
echo $sql . "\n";
$parser = new PHPSQLParser($sql);
print_r($parser->parsed);
$sql = 'select DISTINCT 1+2 c1, 1+ 2 as
`c2`, sum(c2),"Status" = CASE
WHEN quantity > 0 THEN "in stock"
ELSE "out of stock"
END
, t4.c1, (select c1+c2 from t1 table limit 1) as subquery into @a1, @a2, @a3 from `table` the_t1 left outer join t2 using(c1,c2) join
(select a, b, length(concat(a,b,c)) from ( select 1 a,2 b,3 c from some_Table ) table ) subquery_in_from join t3 as tX on tX.c1 = the_t1.c1 natural join t4 t4_x using(cX) where c1 = 1 and c2 in (1,2,3, "apple") and exists ( select 1 from some_other_table another_table where x > 1) and ("zebra" = "orange" or 1 = 1) group by 1, 2 having sum(c2) > 1 ORDER BY 2, c1 DESC LIMIT 0, 10 into outfile "/xyz" FOR UPDATE LOCK IN SHARE MODE
UNION ALL
SELECT NULL,NULL,NULL,NULL,NULL FROM DUAL LIMIT 1';
$start = microtime(true);
$parser = new PHPSQLParser($sql);
$stop = microtime(true);
echo "Parse time highly complex statement: " . ($stop - $start) . "\n";
?>
PK \Sʉ 2 vendor/greenlion/php-sql-parser/examples/.htaccessnu 7m
Order allow,deny
Deny from all
PK \]M M * vendor/greenlion/php-sql-parser/.buildpathnu [
PK \'d7 7 - vendor/greenlion/php-sql-parser/composer.jsonnu [ {
"name" : "greenlion/php-sql-parser",
"type" : "library",
"description" : "A pure PHP SQL (non validating) parser w/ focus on MySQL dialect of SQL",
"keywords" : [
"sql",
"parser",
"creator",
"MySQL"
],
"homepage" : "https://github.com/greenlion/PHP-SQL-Parser",
"license" : "BSD-3-Clause",
"authors" : [{
"name" : "Justin Swanhart",
"email" : "greenlion@gmail.com",
"homepage" : "http://code.google.com/u/greenlion@gmail.com/",
"role" : "Owner"
}, {
"name" : "André Rothe",
"email" : "phosco@gmx.de",
"homepage" : "https://www.phosco.info",
"role" : "Committer"
}
],
"support" : {
"issues" : "https://github.com/greenlion/PHP-SQL-Parser/issues",
"source" : "https://github.com/greenlion/PHP-SQL-Parser"
},
"autoload" : {
"psr-0" : {
"PHPSQLParser\\" : "src/"
}
},
"autoload-dev" : {
"psr-4" : {
"PHPSQLParser\\Test\\" : "tests/cases/"
}
},
"require" : {
"php" : ">=5.3.2"
},
"require-dev" : {
"squizlabs/php_codesniffer" : "^2.8.1",
"phpunit/phpunit" : "^9.5.13",
"analog/analog" : "^1.0.6"
}
}
PK \\?6 6 + vendor/greenlion/php-sql-parser/.travis.ymlnu [ language: php
dist: trusty
php:
- 5.4
- 5.5
- 5.6
- 7.0
- 7.1
- 7.2
- 7.3
- nightly
cache:
directories:
- $HOME/.composer/cache
before_script:
- composer install
script: vendor/bin/phpunit --configuration phpunit.xml
matrix:
fast_finish: true
allow_failures:
- php: nightlyPK \WZ
' vendor/greenlion/php-sql-parser/LICENSEnu [ Copyright (c) 2014, Justin Swanhart and André Rothe
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the {organization} nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
PK \X` ( vendor/greenlion/php-sql-parser/.projectnu [
PHP-SQL-Parserorg.eclipse.wst.validation.validationbuilderorg.eclipse.dltk.core.scriptbuilderorg.eclipse.php.core.PHPNature
PK \ B vendor/greenlion/php-sql-parser/.settings/org.eclipse.php.ui.prefsnu [ #Mon Dec 16 10:33:48 CET 2013
eclipse.preferences.version=1
org.eclipse.php.ui.text.custom_code_templates=/**\n * @return the ${bare_field_name}\n *//**\n * @param ${field_type} ${bare_field_name}\n *//**\n * Enter description here ...\n * ${tags}\n *//**\n * Enter description here...\n *\n * PHP version 5\n *\n * LICENSE\:\n * Copyright (c) 2010-2014 Justin Swanhart and Andr\u00E9 Rothe\n * All rights reserved.\n *\n * Redistribution and use in source and binary forms, with or without\n * modification, are permitted provided that the following conditions\n * are met\:\n * 1. Redistributions of source code must retain the above copyright\n * notice, this list of conditions and the following disclaimer.\n * 2. Redistributions in binary form must reproduce the above copyright\n * notice, this list of conditions and the following disclaimer in the\n * documentation and/or other materials provided with the distribution.\n * 3. The name of the author may not be used to endorse or promote products\n * derived from this software without specific prior written permission.\n *\n * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR\n * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES\n * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.\n * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,\n * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT\n * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\n * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\n * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n * \n * @author Andr\u00E9 Rothe <andre.rothe@phosco.info>\n * @copyright 2010-2014 Justin Swanhart and Andr\u00E9 Rothe\n * @license http\://www.debian.org/misc/bsd.license BSD License (3 Clause)\n * @version SVN\: $$Id\:$$\n * \n *//**\n * Enter description here ...\n * @author ${user}\n *\n * ${tags}\n *//**\n * Enter description here ...\n * @var ${field_type}\n *//**\n * Enter description here ...\n * ${cursor}${tags}\n *//* (non-PHPdoc)\n * ${see_to_overridden}\n *//**\n * ${tags}\n * ${see_to_target}\n */${filecomment}\n${package_declaration}\n\n${typecomment}\n${type_declaration}/**\n * @author Andr\u00E9 Rothe <andre.rothe@phosco.info>\n * @license http\://www.debian.org/misc/bsd.license BSD License (3 Clause)\n */\n// ${TODO} Auto-generated catch block\n${exception_var}.printStackTrace();// ${TODO} Auto-generated method stub\n${body_statement}${body_statement}\n// ${TODO} Auto-generated constructor stubreturn ${field};${field} \= ${param};<?php\n${cursor}<\!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN">\n<html>\n<head>\n<meta http-equiv\="Content-Type" content\="text/html; charset\=${encoding}">\n<title>Insert title here</title>\n</head>\n<frameset>\n <frame>\n <frame>\n <noframes>\n <body>\n <p>This page uses frames. The current browser you are using does not support frames.</p>\n <?php\n${cursor}\n\t?>\n </body>\n </noframes>\n</frameset>\n</html>
PK \ D vendor/greenlion/php-sql-parser/.settings/org.eclipse.php.core.prefsnu [ #Tue Apr 15 09:40:02 CEST 2014
eclipse.preferences.version=1
include_path=0;/PHP-SQL-Parser
org.eclipse.php.core.phpDoc=false
phpVersion=php5.3
useShortTags=true
PK \k P vendor/greenlion/php-sql-parser/.settings/org.eclipse.ltk.core.refactoring.prefsnu [ #Tue Apr 15 09:40:02 CEST 2014
eclipse.preferences.version=1
org.eclipse.ltk.core.refactoring.enable.project.refactoring.history=false
PK \; d vendor/greenlion/php-sql-parser/.settings/org.eclipse.php.debug.core.Debug_Process_Preferences.prefsnu [ #Tue Apr 15 09:40:02 CEST 2014
DefaultProjectBasePath=/PHP-SQL-Parser
eclipse.preferences.version=1
org.eclipse.php.debug.core.use-project-settings=true
org.eclipse.php.debug.coredefaultPHP=PHP 5.3.2 (CGI)
org.eclipse.php.debug.coreoutput_encoding=UTF-8
org.eclipse.php.debug.corephp_debugger_id=org.eclipse.php.debug.core.zendDebugger
org.eclipse.php.debug.corestop_at_first_line_string=true
org.eclipse.php.debug.coretransfer_encoding=UTF-8
PK \Sʉ 3 vendor/greenlion/php-sql-parser/.settings/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Ug g : vendor/greenlion/php-sql-parser/.eclipse-PHP-formatter.xmlnu [
PK \ۯ l vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/ControlStructures/MultiLineConditionSniff.phpnu [
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
/**
* PEAR_Sniffs_ControlStructures_MultiLineConditionSniff.
*
* Ensure multi-line IF conditions are defined correctly.
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @version Release: 1.5.1
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
class PhOSCo_Sniffs_ControlStructures_MultiLineConditionSniff implements PHP_CodeSniffer_Sniff
{
/**
* The number of spaces code should be indented.
*
* @var int
*/
public $indent = 4;
/**
* Returns an array of tokens this test wants to listen for.
*
* @return array
*/
public function register()
{
return array(
T_IF,
T_ELSEIF,
);
}//end register()
/**
* Processes this test, when one of its tokens is encountered.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
*
* @return void
*/
public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr)
{
$tokens = $phpcsFile->getTokens();
// We need to work out how far indented the if statement
// itself is, so we can work out how far to indent conditions.
$statementIndent = 0;
for ($i = ($stackPtr - 1); $i >= 0; $i--) {
if ($tokens[$i]['line'] !== $tokens[$stackPtr]['line']) {
$i++;
break;
}
}
if ($i >= 0 && $tokens[$i]['code'] === T_WHITESPACE) {
$statementIndent = strlen($tokens[$i]['content']);
}
// Each line between the parenthesis should be indented 4 spaces
// and start with an operator, unless the line is inside a
// function call, in which case it is ignored.
$openBracket = $tokens[$stackPtr]['parenthesis_opener'];
$closeBracket = $tokens[$stackPtr]['parenthesis_closer'];
$lastLine = $tokens[$openBracket]['line'];
for ($i = ($openBracket + 1); $i < $closeBracket; $i++) {
if ($tokens[$i]['line'] !== $lastLine) {
if ($tokens[$i]['line'] === $tokens[$closeBracket]['line']) {
$next = $phpcsFile->findNext(T_WHITESPACE, $i, null, true);
if ($next === $closeBracket) {
// Closing bracket is not on the same line as a condition.
$error = 'Closing parenthesis of a multi-line IF statement must be on the same line as the last condition';
$phpcsFile->addError($error, $i, 'CloseBracketNewLine');
$expectedIndent = ($statementIndent + $this->indent);
} else {
// Closing brace needs to be indented to the same level
// as the function.
$expectedIndent = $statementIndent + $this->indent;
}
} else {
$expectedIndent = ($statementIndent + $this->indent);
}
// We changed lines, so this should be a whitespace indent token.
if ($tokens[$i]['code'] !== T_WHITESPACE) {
$foundIndent = 0;
} else {
$foundIndent = strlen($tokens[$i]['content']);
}
if ($expectedIndent !== $foundIndent) {
$error = 'Multi-line IF statement not indented correctly; expected %s spaces but found %s';
$data = array(
$expectedIndent,
$foundIndent,
);
$phpcsFile->addError($error, $i, 'Alignment', $data);
}
if ($tokens[$i]['line'] !== $tokens[$closeBracket]['line']) {
$next = $phpcsFile->findNext(T_WHITESPACE, $i, null, true);
if (in_array($tokens[$next]['code'], PHP_CodeSniffer_Tokens::$booleanOperators) === false) {
$error = 'Each line in a multi-line IF statement must begin with a boolean operator';
$phpcsFile->addError($error, $i, 'StartWithBoolean');
}
}
$lastLine = $tokens[$i]['line'];
}//end if
if ($tokens[$i]['code'] === T_STRING) {
$next = $phpcsFile->findNext(T_WHITESPACE, ($i + 1), null, true);
if ($tokens[$next]['code'] === T_OPEN_PARENTHESIS) {
// This is a function call, so skip to the end as they
// have their own indentation rules.
$i = $tokens[$next]['parenthesis_closer'];
$lastLine = $tokens[$i]['line'];
continue;
}
}
}//end for
// From here on, we are checking the spacing of the opening and closing
// braces. If this IF statement does not use braces, we end here.
if (isset($tokens[$stackPtr]['scope_opener']) === false) {
return;
}
// The opening brace needs to be one space away from the closing parenthesis.
if ($tokens[($closeBracket + 1)]['code'] !== T_WHITESPACE) {
$length = 0;
} else if ($tokens[($closeBracket + 1)]['content'] === $phpcsFile->eolChar) {
$length = -1;
} else {
$length = strlen($tokens[($closeBracket + 1)]['content']);
}
if ($length !== 1) {
$data = array($length);
$code = 'SpaceBeforeOpenBrace';
$error = 'There must be a single space between the closing parenthesis and the opening brace of a multi-line IF statement; found ';
if ($length === -1) {
$error .= 'newline';
$code = 'NewlineBeforeOpenBrace';
} else {
$error .= '%s spaces';
}
$phpcsFile->addError($error, ($closeBracket + 1), $code, $data);
}
// And just in case they do something funny before the brace...
$next = $phpcsFile->findNext(T_WHITESPACE, ($closeBracket + 1), null, true);
if ($next !== false
&& $tokens[$next]['code'] !== T_OPEN_CURLY_BRACKET
&& $tokens[$next]['code'] !== T_COLON
) {
$error = 'There must be a single space between the closing parenthesis and the opening brace of a multi-line IF statement';
$phpcsFile->addError($error, $next, 'NoSpaceBeforeOpenBrace');
}
}//end process()
}//end class
?>
PK \Sʉ Z vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/ControlStructures/.htaccessnu 7m
Order allow,deny
Deny from all
PK \<0
` vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/Classes/ClassDeclarationSniff.phpnu [
* @author Marc McIntyre
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
/**
* Class Declaration Test.
*
* Checks the declaration of the class is correct.
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood
* @author Marc McIntyre
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @version Release: 1.5.1
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
class PhOSCo_Sniffs_Classes_ClassDeclarationSniff implements PHP_CodeSniffer_Sniff {
/**
* The number of spaces code should be indented.
*
* @var int
*/
public $indent = 4;
/**
* Returns an array of tokens this test wants to listen for.
*
* @return array
*/
public function register() {
return array(T_CLASS, T_INTERFACE,);
}//end register()
/**
* Processes this test, when one of its tokens is encountered.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param integer $stackPtr The position of the current token in the
* stack passed in $tokens.
*
* @return void
*/
public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr) {
$tokens = $phpcsFile->getTokens();
$errorData = array($tokens[$stackPtr]['content']);
if (isset($tokens[$stackPtr]['scope_opener']) === false) {
$error = 'Possible parse error: %s missing opening or closing brace';
$phpcsFile->addWarning($error, $stackPtr, 'MissingBrace', $errorData);
return;
}
$curlyBrace = $tokens[$stackPtr]['scope_opener'];
$lastContent = $phpcsFile->findPrevious(T_WHITESPACE, ($curlyBrace - 1), $stackPtr, true);
$classLine = $tokens[$lastContent]['line'];
$braceLine = $tokens[$curlyBrace]['line'];
if ($braceLine !== $classLine) {
$error = 'Opening brace of a %s must be on the same line as the definition';
$phpcsFile->addError($error, $curlyBrace, 'OpenBraceNewLine', $errorData);
return;
}
if ($tokens[($curlyBrace - 1)]['code'] === T_WHITESPACE) {
$prevContent = $tokens[($curlyBrace - 1)]['content'];
if ($prevContent === $phpcsFile->eolChar) {
$spaces = 0;
} else {
$blankSpace = substr($prevContent, strpos($prevContent, $phpcsFile->eolChar));
$spaces = strlen($blankSpace);
}
$expected = 1;
if ($spaces !== $expected) {
$error = 'Expected %s spaces before opening brace; %s found';
$data = array($expected, $spaces,);
$phpcsFile->addError($error, $curlyBrace, 'SpaceBeforeBrace', $data);
}
}
}//end process()
}//end class
?>
PK \Sʉ P vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/Classes/.htaccessnu 7m
Order allow,deny
Deny from all
PK \:R" R" _ vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/Commenting/ClassCommentSniff.phpnu [
* @author Marc McIntyre
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
if (class_exists('PHP_CodeSniffer_CommentParser_ClassCommentParser', true) === false) {
$error = 'Class PHP_CodeSniffer_CommentParser_ClassCommentParser not found';
throw new PHP_CodeSniffer_Exception($error);
}
if (class_exists('PhOSCo_Sniffs_Commenting_FileCommentSniff', true) === false) {
$error = 'Class PhOSCo_Sniffs_Commenting_FileCommentSniff not found';
throw new PHP_CodeSniffer_Exception($error);
}
/**
* Parses and verifies the doc comments for classes.
*
* Verifies that :
*
*
A doc comment exists.
*
There is a blank newline after the short description.
*
There is a blank newline between the long and short description.
*
There is a blank newline between the long description and tags.
*
Check the order of the tags.
*
Check the indentation of each tag.
*
Check required and optional tags and the format of their content.
*
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood
* @author Marc McIntyre
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @version Release: 1.5.1
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
class PhOSCo_Sniffs_Commenting_ClassCommentSniff extends PhOSCo_Sniffs_Commenting_FileCommentSniff {
/**
* Returns an array of tokens this test wants to listen for.
*
* @return array
*/
public function register() {
return array(T_CLASS, T_INTERFACE,);
}//end register()
/**
* Processes this test, when one of its tokens is encountered.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
*
* @return void
*/
public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr) {
$this->currentFile = $phpcsFile;
$tokens = $phpcsFile->getTokens();
$type = strtolower($tokens[$stackPtr]['content']);
$errorData = array($type);
$find = array(T_ABSTRACT, T_WHITESPACE, T_FINAL,);
// Extract the class comment docblock.
$commentEnd = $phpcsFile->findPrevious($find, ($stackPtr - 1), null, true);
if ($commentEnd !== false && $tokens[$commentEnd]['code'] === T_COMMENT) {
$error = 'You must use "/**" style comments for a %s comment';
$phpcsFile->addError($error, $stackPtr, 'WrongStyle', $errorData);
return;
} else if ($commentEnd === false || $tokens[$commentEnd]['code'] !== T_DOC_COMMENT) {
$phpcsFile->addError('Missing %s doc comment', $stackPtr, 'Missing', $errorData);
return;
}
$commentStart = ($phpcsFile->findPrevious(T_DOC_COMMENT, ($commentEnd - 1), null, true) + 1);
$commentNext = $phpcsFile->findPrevious(T_WHITESPACE, ($commentEnd + 1), $stackPtr, false, $phpcsFile->eolChar);
// Distinguish file and class comment.
$prevClassToken = $phpcsFile->findPrevious(T_CLASS, ($stackPtr - 1));
if ($prevClassToken === false) {
// This is the first class token in this file, need extra checks.
$prevNonComment = $phpcsFile->findPrevious(T_DOC_COMMENT, ($commentStart - 1), null, true);
if ($prevNonComment !== false) {
$prevComment = $phpcsFile->findPrevious(T_DOC_COMMENT, ($prevNonComment - 1));
if ($prevComment === false) {
// There is only 1 doc comment between open tag and class token.
$newlineToken = $phpcsFile->findNext(T_WHITESPACE, ($commentEnd + 1), $stackPtr, false,
$phpcsFile->eolChar);
if ($newlineToken !== false) {
$newlineToken = $phpcsFile->findNext(T_WHITESPACE, ($newlineToken + 1), $stackPtr, false,
$phpcsFile->eolChar);
if ($newlineToken !== false) {
// Blank line between the class and the doc block.
// The doc block is most likely a file comment.
$error = 'Missing %s doc comment';
$phpcsFile->addError($error, ($stackPtr + 1), 'Missing', $errorData);
return;
}
}//end if
}//end if
}//end if
}//end if
$comment = $phpcsFile->getTokensAsString($commentStart, ($commentEnd - $commentStart + 1));
// Parse the class comment.docblock.
try {
$this->commentParser = new PHP_CodeSniffer_CommentParser_ClassCommentParser($comment, $phpcsFile);
$this->commentParser->parse();
} catch (PHP_CodeSniffer_CommentParser_ParserException $e) {
$line = ($e->getLineWithinComment() + $commentStart);
$phpcsFile->addError($e->getMessage(), $line, 'FailedParse');
return;
}
$comment = $this->commentParser->getComment();
if (is_null($comment) === true) {
$error = 'Doc comment is empty for %s';
$phpcsFile->addError($error, $commentStart, 'Empty', $errorData);
return;
}
// No extra newline before short description.
$short = $comment->getShortComment();
$newlineCount = 0;
$newlineSpan = strspn($short, $phpcsFile->eolChar);
if ($short !== '' && $newlineSpan > 0) {
$error = 'Extra newline(s) found before %s comment short description';
$phpcsFile->addError($error, ($commentStart + 1), 'SpacingBeforeShort', $errorData);
}
$newlineCount = (substr_count($short, $phpcsFile->eolChar) + 1);
// Exactly one blank line between short and long description.
$long = $comment->getLongComment();
if (empty($long) === false) {
$between = $comment->getWhiteSpaceBetween();
$newlineBetween = substr_count($between, $phpcsFile->eolChar);
if ($newlineBetween !== 2) {
$error = 'There must be exactly one blank line between descriptions in %s comments';
$phpcsFile->addError($error, ($commentStart + $newlineCount + 1), 'SpacingAfterShort', $errorData);
}
$newlineCount += $newlineBetween;
}
// Exactly one blank line before tags.
$tags = $this->commentParser->getTagOrders();
if (count($tags) > 1) {
$newlineSpan = $comment->getNewlineAfter();
if ($newlineSpan !== 2) {
$error = 'There must be exactly one blank line before the tags in %s comments';
if ($long !== '') {
$newlineCount += (substr_count($long, $phpcsFile->eolChar) - $newlineSpan + 1);
}
$phpcsFile->addError($error, ($commentStart + $newlineCount), 'SpacingBeforeTags', $errorData);
$short = rtrim($short, $phpcsFile->eolChar . ' ');
}
}
// Check each tag.
$this->processTags($commentStart, $commentEnd);
}//end process()
/**
* Process the version tag.
*
* @param int $errorPos The line number where the error occurs.
*
* @return void
*/
protected function processVersion($errorPos) {
$version = $this->commentParser->getVersion();
if ($version !== null) {
$content = $version->getContent();
$matches = array();
if (empty($content) === true) {
$error = 'Content missing for @version tag in doc comment';
$this->currentFile->addError($error, $errorPos, 'EmptyVersion');
} else if ((strstr($content, 'Release:') === false)) {
$error = 'Invalid version "%s" in doc comment; consider "Release: " instead';
$data = array($content);
$this->currentFile->addWarning($error, $errorPos, 'InvalidVersion', $data);
}
}
}//end processVersion()
}//end class
?>
PK \L2\Ji i ^ vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/Commenting/FileCommentSniff.phpnu [
* @author Marc McIntyre
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
if (class_exists('PHP_CodeSniffer_CommentParser_ClassCommentParser', true) === false) {
throw new PHP_CodeSniffer_Exception('Class PHP_CodeSniffer_CommentParser_ClassCommentParser not found');
}
/**
* Parses and verifies the doc comments for files.
*
* Verifies that :
*
*
A doc comment exists.
*
There is a blank newline after the short description.
*
There is a blank newline between the long and short description.
*
There is a blank newline between the long description and tags.
*
A PHP version is specified.
*
Check the order of the tags.
*
Check the indentation of each tag.
*
Check required and optional tags and the format of their content.
*
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood
* @author Marc McIntyre
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @version Release: 1.5.1
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
class PhOSCo_Sniffs_Commenting_FileCommentSniff implements PHP_CodeSniffer_Sniff {
/**
* The header comment parser for the current file.
*
* @var PHP_CodeSniffer_Comment_Parser_ClassCommentParser
*/
protected $commentParser = null;
/**
* The current PHP_CodeSniffer_File object we are processing.
*
* @var PHP_CodeSniffer_File
*/
protected $currentFile = null;
/**
* Tags in correct order and related info.
*
* @var array
*/
protected $tags = array(
'author' => array('required' => true, 'allow_multiple' => true,
'order_text' => 'follows @subpackage (if used) or @package',),
'copyright' => array('required' => false, 'allow_multiple' => true, 'order_text' => 'follows @author',),
'license' => array('required' => true, 'allow_multiple' => false,
'order_text' => 'follows @copyright (if used) or @author',),
'version' => array('required' => false, 'allow_multiple' => false, 'order_text' => 'follows @license',),
'see' => array('required' => false, 'allow_multiple' => true, 'order_text' => 'follows @link',),
'since' => array('required' => false, 'allow_multiple' => false,
'order_text' => 'follows @see (if used) or @link',),
'deprecated' => array('required' => false, 'allow_multiple' => false,
'order_text' => 'follows @since (if used) or @see (if used) or @link',),);
/**
* Returns an array of tokens this test wants to listen for.
*
* @return array
*/
public function register() {
return array(T_OPEN_TAG);
}//end register()
/**
* Processes this test, when one of its tokens is encountered.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
*
* @return void
*/
public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr) {
$this->currentFile = $phpcsFile;
// We are only interested if this is the first open tag.
if ($stackPtr !== 0) {
if ($phpcsFile->findPrevious(T_OPEN_TAG, ($stackPtr - 1)) !== false) {
return;
}
}
$tokens = $phpcsFile->getTokens();
// Find the next non whitespace token.
$commentStart = $phpcsFile->findNext(T_WHITESPACE, ($stackPtr + 1), null, true);
// Allow declare() statements at the top of the file.
if ($tokens[$commentStart]['code'] === T_DECLARE) {
$semicolon = $phpcsFile->findNext(T_SEMICOLON, ($commentStart + 1));
$commentStart = $phpcsFile->findNext(T_WHITESPACE, ($semicolon + 1), null, true);
}
// Ignore vim header.
if ($tokens[$commentStart]['code'] === T_COMMENT) {
if (strstr($tokens[$commentStart]['content'], 'vim:') !== false) {
$commentStart = $phpcsFile->findNext(T_WHITESPACE, ($commentStart + 1), null, true);
}
}
$errorToken = ($stackPtr + 1);
if (isset($tokens[$errorToken]) === false) {
$errorToken--;
}
if ($tokens[$commentStart]['code'] === T_CLOSE_TAG) {
// We are only interested if this is the first open tag.
return;
} else if ($tokens[$commentStart]['code'] === T_COMMENT) {
$error = 'You must use "/**" style comments for a file comment';
$phpcsFile->addError($error, $errorToken, 'WrongStyle');
return;
} else if ($commentStart === false || $tokens[$commentStart]['code'] !== T_DOC_COMMENT) {
$phpcsFile->addError('Missing file doc comment', $errorToken, 'Missing');
return;
} else {
// Extract the header comment docblock.
$commentEnd = $phpcsFile->findNext(T_DOC_COMMENT, ($commentStart + 1), null, true);
$commentEnd--;
// Check if there is only 1 doc comment between the
// open tag and class token.
$nextToken = array(T_ABSTRACT, T_CLASS, T_FUNCTION, T_DOC_COMMENT,);
$commentNext = $phpcsFile->findNext($nextToken, ($commentEnd + 1));
if ($commentNext !== false && $tokens[$commentNext]['code'] !== T_DOC_COMMENT) {
// Found a class token right after comment doc block.
$newlineToken = $phpcsFile->findNext(T_WHITESPACE, ($commentEnd + 1), $commentNext, false,
$phpcsFile->eolChar);
if ($newlineToken !== false) {
$newlineToken = $phpcsFile->findNext(T_WHITESPACE, ($newlineToken + 1), $commentNext, false,
$phpcsFile->eolChar);
if ($newlineToken === false) {
// No blank line between the class token and the doc block.
// The doc block is most likely a class comment.
$error = 'Missing file doc comment';
$phpcsFile->addError($error, $errorToken, 'Missing');
return;
}
}
}//end if
$comment = $phpcsFile->getTokensAsString($commentStart, ($commentEnd - $commentStart + 1));
// Parse the header comment docblock.
try {
$this->commentParser = new PHP_CodeSniffer_CommentParser_ClassCommentParser($comment, $phpcsFile);
$this->commentParser->parse();
} catch (PHP_CodeSniffer_CommentParser_ParserException $e) {
$line = ($e->getLineWithinComment() + $commentStart);
$phpcsFile->addError($e->getMessage(), $line, 'FailedParse');
return;
}
$comment = $this->commentParser->getComment();
if (is_null($comment) === true) {
$error = 'File doc comment is empty';
$phpcsFile->addError($error, $commentStart, 'Empty');
return;
}
// No extra newline before short description.
$short = $comment->getShortComment();
$newlineCount = 0;
$newlineSpan = strspn($short, $phpcsFile->eolChar);
if ($short !== '' && $newlineSpan > 0) {
$error = 'Extra newline(s) found before file comment short description';
$phpcsFile->addError($error, ($commentStart + 1), 'SpacingBefore');
}
$newlineCount = (substr_count($short, $phpcsFile->eolChar) + 1);
// Exactly one blank line between short and long description.
$long = $comment->getLongComment();
if (empty($long) === false) {
$between = $comment->getWhiteSpaceBetween();
$newlineBetween = substr_count($between, $phpcsFile->eolChar);
if ($newlineBetween !== 2) {
$error = 'There must be exactly one blank line between descriptions in file comment';
$phpcsFile->addError($error, ($commentStart + $newlineCount + 1), 'DescriptionSpacing');
}
$newlineCount += $newlineBetween;
}
// Exactly one blank line before tags.
$tags = $this->commentParser->getTagOrders();
if (count($tags) > 1) {
$newlineSpan = $comment->getNewlineAfter();
if ($newlineSpan !== 2) {
$error = 'There must be exactly one blank line before the tags in file comment';
if ($long !== '') {
$newlineCount += (substr_count($long, $phpcsFile->eolChar) - $newlineSpan + 1);
}
$phpcsFile->addError($error, ($commentStart + $newlineCount), 'SpacingBeforeTags');
$short = rtrim($short, $phpcsFile->eolChar . ' ');
}
}
// Check the PHP Version.
$this->processPHPVersion($commentStart, $commentEnd, $long);
// Check each tag.
$this->processTags($commentStart, $commentEnd);
}//end if
}//end process()
/**
* Check that the PHP version is specified.
*
* @param int $commentStart Position in the stack where the comment started.
* @param int $commentEnd Position in the stack where the comment ended.
* @param string $commentText The text of the function comment.
*
* @return void
*/
protected function processPHPVersion($commentStart, $commentEnd, $commentText) {
if (strstr(strtolower($commentText), 'php version') === false) {
$error = 'PHP version not specified';
$this->currentFile->addWarning($error, $commentEnd, 'MissingVersion');
}
}//end processPHPVersion()
/**
* Processes each required or optional tag.
*
* @param int $commentStart Position in the stack where the comment started.
* @param int $commentEnd Position in the stack where the comment ended.
*
* @return void
*/
protected function processTags($commentStart, $commentEnd) {
$docBlock = (get_class($this) === 'PhOSCo_Sniffs_Commenting_FileCommentSniff') ? 'file' : 'class';
$foundTags = $this->commentParser->getTagOrders();
$orderIndex = 0;
$indentation = array();
$longestTag = 0;
$errorPos = 0;
foreach ($this->tags as $tag => $info) {
// Required tag missing.
if ($info['required'] === true && in_array($tag, $foundTags) === false) {
$error = 'Missing @%s tag in %s comment';
$data = array($tag, $docBlock,);
$this->currentFile->addError($error, $commentEnd, 'MissingTag', $data);
continue;
}
// Get the line number for current tag.
$tagName = ucfirst($tag);
if ($info['allow_multiple'] === true) {
$tagName .= 's';
}
$getMethod = 'get' . $tagName;
$tagElement = $this->commentParser->$getMethod();
if (is_null($tagElement) === true || empty($tagElement) === true) {
continue;
}
$errorPos = $commentStart;
if (is_array($tagElement) === false) {
$errorPos = ($commentStart + $tagElement->getLine());
}
// Get the tag order.
$foundIndexes = array_keys($foundTags, $tag);
if (count($foundIndexes) > 1) {
// Multiple occurrence not allowed.
if ($info['allow_multiple'] === false) {
$error = 'Only 1 @%s tag is allowed in a %s comment';
$data = array($tag, $docBlock,);
$this->currentFile->addError($error, $errorPos, 'DuplicateTag', $data);
} else {
// Make sure same tags are grouped together.
$i = 0;
$count = $foundIndexes[0];
foreach ($foundIndexes as $index) {
if ($index !== $count) {
$errorPosIndex = ($errorPos + $tagElement[$i]->getLine());
$error = '@%s tags must be grouped together';
$data = array($tag);
$this->currentFile->addError($error, $errorPosIndex, 'TagsNotGrouped', $data);
}
$i++;
$count++;
}
}
}//end if
// Check tag order.
if ($foundIndexes[0] > $orderIndex) {
$orderIndex = $foundIndexes[0];
} else {
if (is_array($tagElement) === true && empty($tagElement) === false) {
$errorPos += $tagElement[0]->getLine();
}
$error = 'The @%s tag is in the wrong order; the tag %s';
$data = array($tag, $info['order_text'],);
$this->currentFile->addError($error, $errorPos, 'WrongTagOrder', $data);
}
// Store the indentation for checking.
$len = strlen($tag);
if ($len > $longestTag) {
$longestTag = $len;
}
if (is_array($tagElement) === true) {
foreach ($tagElement as $key => $element) {
$indentation[] = array('tag' => $tag, 'space' => $this->getIndentation($tag, $element),
'line' => $element->getLine(),);
}
} else {
$indentation[] = array('tag' => $tag, 'space' => $this->getIndentation($tag, $tagElement),);
}
$method = 'process' . $tagName;
if (method_exists($this, $method) === true) {
// Process each tag if a method is defined.
call_user_func(array($this, $method), $errorPos);
} else {
if (is_array($tagElement) === true) {
foreach ($tagElement as $key => $element) {
$element->process($this->currentFile, $commentStart, $docBlock);
}
} else {
$tagElement->process($this->currentFile, $commentStart, $docBlock);
}
}
}//end foreach
foreach ($indentation as $indentInfo) {
if ($indentInfo['space'] !== 0 && $indentInfo['space'] !== ($longestTag + 1)) {
$expected = (($longestTag - strlen($indentInfo['tag'])) + 1);
$space = ($indentInfo['space'] - strlen($indentInfo['tag']));
$error = '@%s tag comment indented incorrectly; expected %s spaces but found %s';
$data = array($indentInfo['tag'], $expected, $space,);
$getTagMethod = 'get' . ucfirst($indentInfo['tag']);
if ($this->tags[$indentInfo['tag']]['allow_multiple'] === true) {
$line = $indentInfo['line'];
} else {
$tagElem = $this->commentParser->$getTagMethod();
$line = $tagElem->getLine();
}
$this->currentFile->addError($error, ($commentStart + $line), 'TagIndent', $data);
}
}
}//end processTags()
/**
* Get the indentation information of each tag.
*
* @param string $tagName The name of the
* doc comment
* element.
* @param PHP_CodeSniffer_CommentParser_DocElement $tagElement The doc comment
* element.
*
* @return void
*/
protected function getIndentation($tagName, $tagElement) {
if ($tagElement instanceof PHP_CodeSniffer_CommentParser_SingleElement) {
if ($tagElement->getContent() !== '') {
return (strlen($tagName) + substr_count($tagElement->getWhitespaceBeforeContent(), ' '));
}
} else if ($tagElement instanceof PHP_CodeSniffer_CommentParser_PairElement) {
if ($tagElement->getValue() !== '') {
return (strlen($tagName) + substr_count($tagElement->getWhitespaceBeforeValue(), ' '));
}
}
return 0;
}//end getIndentation()
/**
* Process the category tag.
*
* @param int $errorPos The line number where the error occurs.
*
* @return void
*/
protected function processCategory($errorPos) {
$category = $this->commentParser->getCategory();
if ($category !== null) {
$content = $category->getContent();
if ($content !== '') {
if (PHP_CodeSniffer::isUnderscoreName($content) !== true) {
$newContent = str_replace(' ', '_', $content);
$nameBits = explode('_', $newContent);
$firstBit = array_shift($nameBits);
$newName = ucfirst($firstBit) . '_';
foreach ($nameBits as $bit) {
$newName .= ucfirst($bit) . '_';
}
$error = 'Category name "%s" is not valid; consider "%s" instead';
$validName = trim($newName, '_');
$data = array($content, $validName,);
$this->currentFile->addError($error, $errorPos, 'InvalidCategory', $data);
}
} else {
$error = '@category tag must contain a name';
$this->currentFile->addError($error, $errorPos, 'EmptyCategory');
}
}
}//end processCategory()
/**
* Process the package tag.
*
* @param int $errorPos The line number where the error occurs.
*
* @return void
*/
protected function processPackage($errorPos) {
$package = $this->commentParser->getPackage();
if ($package === null) {
return;
}
$content = $package->getContent();
if ($content === '') {
$error = '@package tag must contain a name';
$this->currentFile->addError($error, $errorPos, 'EmptyPackage');
return;
}
if (PHP_CodeSniffer::isUnderscoreName($content) === true) {
return;
}
$newContent = str_replace(' ', '_', $content);
$newContent = preg_replace('/[^A-Za-z_]/', '', $newContent);
$nameBits = explode('_', $newContent);
$firstBit = array_shift($nameBits);
$newName = strtoupper($firstBit{0}) . substr($firstBit, 1) . '_';
foreach ($nameBits as $bit) {
$newName .= strtoupper($bit{0}) . substr($bit, 1) . '_';
}
$error = 'Package name "%s" is not valid; consider "%s" instead';
$validName = trim($newName, '_');
$data = array($content, $validName,);
$this->currentFile->addError($error, $errorPos, 'InvalidPackage', $data);
}//end processPackage()
/**
* Process the subpackage tag.
*
* @param int $errorPos The line number where the error occurs.
*
* @return void
*/
protected function processSubpackage($errorPos) {
$package = $this->commentParser->getSubpackage();
if ($package !== null) {
$content = $package->getContent();
if ($content !== '') {
if (PHP_CodeSniffer::isUnderscoreName($content) !== true) {
$newContent = str_replace(' ', '_', $content);
$nameBits = explode('_', $newContent);
$firstBit = array_shift($nameBits);
$newName = strtoupper($firstBit{0}) . substr($firstBit, 1) . '_';
foreach ($nameBits as $bit) {
$newName .= strtoupper($bit{0}) . substr($bit, 1) . '_';
}
$error = 'Subpackage name "%s" is not valid; consider "%s" instead';
$validName = trim($newName, '_');
$data = array($content, $validName,);
$this->currentFile->addError($error, $errorPos, 'InvalidSubpackage', $data);
}
} else {
$error = '@subpackage tag must contain a name';
$this->currentFile->addError($error, $errorPos, 'EmptySubpackage');
}
}
}//end processSubpackage()
/**
* Process the author tag(s) that this header comment has.
*
* This function is different from other _process functions
* as $authors is an array of SingleElements, so we work out
* the errorPos for each element separately
*
* @param int $commentStart The position in the stack where
* the comment started.
*
* @return void
*/
protected function processAuthors($commentStart) {
$authors = $this->commentParser->getAuthors();
// Report missing return.
if (empty($authors) === false) {
foreach ($authors as $author) {
$errorPos = ($commentStart + $author->getLine());
$content = $author->getContent();
if ($content !== '') {
$local = '\da-zA-Z-_+';
// Dot character cannot be the first or last character
// in the local-part.
$localMiddle = $local . '.\w';
if (preg_match(
'/^([^<]*)\s+<([' . $local . ']([' . $localMiddle . ']*[' . $local
. '])*@[\da-zA-Z][-.\w]*[\da-zA-Z]\.[a-zA-Z]{2,7})>$/', $content) === 0) {
$error = 'Content of the @author tag must be in the form "Display Name "';
$this->currentFile->addError($error, $errorPos, 'InvalidAuthors');
}
} else {
$error = 'Content missing for @author tag in %s comment';
$docBlock = (get_class($this) === 'PhOSCo_Sniffs_Commenting_FileCommentSniff') ? 'file' : 'class';
$data = array($docBlock);
$this->currentFile->addError($error, $errorPos, 'EmptyAuthors', $data);
}
}
}
}//end processAuthors()
/**
* Process the copyright tags.
*
* @param int $commentStart The position in the stack where
* the comment started.
*
* @return void
*/
protected function processCopyrights($commentStart) {
$copyrights = $this->commentParser->getCopyrights();
foreach ($copyrights as $copyright) {
$errorPos = ($commentStart + $copyright->getLine());
$content = $copyright->getContent();
if ($content !== '') {
$matches = array();
if (preg_match('/^([0-9]{4})((.{1})([0-9]{4}))? (.+)$/', $content, $matches) !== 0) {
// Check earliest-latest year order.
if ($matches[3] !== '') {
if ($matches[3] !== '-') {
$error = 'A hyphen must be used between the earliest and latest year';
$this->currentFile->addError($error, $errorPos, 'CopyrightHyphen');
}
if ($matches[4] !== '' && $matches[4] < $matches[1]) {
$error = "Invalid year span \"$matches[1]$matches[3]$matches[4]\" found; consider \"$matches[4]-$matches[1]\" instead";
$this->currentFile->addWarning($error, $errorPos, 'InvalidCopyright');
}
}
} else {
$error = '@copyright tag must contain a year and the name of the copyright holder';
$this->currentFile->addError($error, $errorPos, 'EmptyCopyright');
}
} else {
$error = '@copyright tag must contain a year and the name of the copyright holder';
$this->currentFile->addError($error, $errorPos, 'EmptyCopyright');
}//end if
}//end if
}//end processCopyrights()
/**
* Process the license tag.
*
* @param int $errorPos The line number where the error occurs.
*
* @return void
*/
protected function processLicense($errorPos) {
$license = $this->commentParser->getLicense();
if ($license !== null) {
$value = $license->getValue();
$comment = $license->getComment();
if ($value === '' || $comment === '') {
$error = '@license tag must contain a URL and a license name';
$this->currentFile->addError($error, $errorPos, 'EmptyLicense');
}
}
}//end processLicense()
/**
* Process the version tag.
*
* @param int $errorPos The line number where the error occurs.
*
* @return void
*/
protected function processVersion($errorPos) {
$version = $this->commentParser->getVersion();
if ($version !== null) {
$content = $version->getContent();
$matches = array();
if (empty($content) === true) {
$error = 'Content missing for @version tag in file comment';
$this->currentFile->addError($error, $errorPos, 'EmptyVersion');
} else if (strstr($content, 'CVS:') === false && strstr($content, 'SVN:') === false
&& strstr($content, 'GIT:') === false && strstr($content, 'HG:') === false) {
$error = 'Invalid version "%s" in file comment; consider "CVS: " or "SVN: " or "GIT: " or "HG: " instead';
$data = array($content);
$this->currentFile->addWarning($error, $errorPos, 'InvalidVersion', $data);
}
}
}//end processVersion()
}//end class
?>
PK \Sʉ S vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/Commenting/.htaccessnu 7m
Order allow,deny
Deny from all
PK \n`D0 D0 e vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/Functions/FunctionDeclarationSniff.phpnu [
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
/**
* PEAR_Sniffs_Functions_FunctionDeclarationSniff.
*
* Ensure single and multi-line function declarations are defined correctly.
*
* @category PHP
* @package PHP_CodeSniffer
* @author Greg Sherwood
* @copyright 2006-2012 Squiz Pty Ltd (ABN 77 084 670 600)
* @license https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
* @version Release: 1.5.1
* @link http://pear.php.net/package/PHP_CodeSniffer
*/
class PhOSCo_Sniffs_Functions_FunctionDeclarationSniff implements PHP_CodeSniffer_Sniff {
/**
* The number of spaces code should be indented.
*
* @var int
*/
public $indent = 4;
/**
* Returns an array of tokens this test wants to listen for.
*
* @return array
*/
public function register() {
return array(T_FUNCTION, T_CLOSURE,);
}//end register()
/**
* Processes this test, when one of its tokens is encountered.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
*
* @return void
*/
public function process(PHP_CodeSniffer_File $phpcsFile, $stackPtr) {
$tokens = $phpcsFile->getTokens();
$spaces = 0;
if ($tokens[($stackPtr + 1)]['code'] === T_WHITESPACE) {
$spaces = strlen($tokens[($stackPtr + 1)]['content']);
}
if ($spaces !== 1) {
$error = 'Expected 1 space after FUNCTION keyword; %s found';
$data = array($spaces);
$phpcsFile->addError($error, $stackPtr, 'SpaceAfterFunction', $data);
}
// Must be one space before and after USE keyword for closures.
$openBracket = $tokens[$stackPtr]['parenthesis_opener'];
$closeBracket = $tokens[$stackPtr]['parenthesis_closer'];
if ($tokens[$stackPtr]['code'] === T_CLOSURE) {
$use = $phpcsFile->findNext(T_USE, ($closeBracket + 1), $tokens[$stackPtr]['scope_opener']);
if ($use !== false) {
if ($tokens[($use + 1)]['code'] !== T_WHITESPACE) {
$length = 0;
} else if ($tokens[($use + 1)]['content'] === "\t") {
$length = '\t';
} else {
$length = strlen($tokens[($use + 1)]['content']);
}
if ($length !== 1) {
$error = 'Expected 1 space after USE keyword; found %s';
$data = array($length);
$phpcsFile->addError($error, $use, 'SpaceAfterUse', $data);
}
if ($tokens[($use - 1)]['code'] !== T_WHITESPACE) {
$length = 0;
} else if ($tokens[($use - 1)]['content'] === "\t") {
$length = '\t';
} else {
$length = strlen($tokens[($use - 1)]['content']);
}
if ($length !== 1) {
$error = 'Expected 1 space before USE keyword; found %s';
$data = array($length);
$phpcsFile->addError($error, $use, 'SpaceBeforeUse', $data);
}
}//end if
}//end if
// Check if this is a single line or multi-line declaration.
$singleLine = true;
if ($tokens[$openBracket]['line'] === $tokens[$closeBracket]['line']) {
// Closures may use the USE keyword and so be multi-line in this way.
if ($tokens[$stackPtr]['code'] === T_CLOSURE) {
if ($use !== false) {
// If the opening and closing parenthesis of the use statement
// are also on the same line, this is a single line declaration.
$open = $phpcsFile->findNext(T_OPEN_PARENTHESIS, ($use + 1));
$close = $tokens[$open]['parenthesis_closer'];
if ($tokens[$open]['line'] !== $tokens[$close]['line']) {
$singleLine = false;
}
}
}
} else {
$singleLine = false;
}
if ($singleLine === true) {
$this->processSingleLineDeclaration($phpcsFile, $stackPtr, $tokens);
} else {
$this->processMultiLineDeclaration($phpcsFile, $stackPtr, $tokens);
}
}//end process()
/**
* Processes single-line declarations.
*
* Just uses the Generic BSD-Allman brace sniff.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
* @param array $tokens The stack of tokens that make up
* the file.
*
* @return void
*/
public function processSingleLineDeclaration(PHP_CodeSniffer_File $phpcsFile, $stackPtr, $tokens) {
if (class_exists('Generic_Sniffs_Functions_OpeningFunctionBraceKernighanRitchieSniff', true) === false) {
throw new PHP_CodeSniffer_Exception(
'Class Generic_Sniffs_Functions_OpeningFunctionBraceKernighanRitchieSniff not found');
}
$sniff = new Generic_Sniffs_Functions_OpeningFunctionBraceKernighanRitchieSniff();
$sniff->process($phpcsFile, $stackPtr);
}//end processSingleLineDeclaration()
/**
* Processes mutli-line declarations.
*
* @param PHP_CodeSniffer_File $phpcsFile The file being scanned.
* @param int $stackPtr The position of the current token
* in the stack passed in $tokens.
* @param array $tokens The stack of tokens that make up
* the file.
*
* @return void
*/
public function processMultiLineDeclaration(PHP_CodeSniffer_File $phpcsFile, $stackPtr, $tokens) {
// We need to work out how far indented the function
// declaration itself is, so we can work out how far to
// indent parameters.
$functionIndent = 0;
for ($i = ($stackPtr - 1); $i >= 0; $i--) {
if ($tokens[$i]['line'] !== $tokens[$stackPtr]['line']) {
$i++;
break;
}
}
if ($tokens[$i]['code'] === T_WHITESPACE) {
$functionIndent = strlen($tokens[$i]['content']);
}
// The closing parenthesis must be on a new line, even
// when checking abstract function definitions.
$closeBracket = $tokens[$stackPtr]['parenthesis_closer'];
$prev = $phpcsFile->findPrevious(T_WHITESPACE, ($closeBracket - 1), null, true);
if ($tokens[$closeBracket]['line'] !== $tokens[$tokens[$closeBracket]['parenthesis_opener']]['line']) {
if ($tokens[$prev]['line'] === $tokens[$closeBracket]['line']) {
$error = 'The closing parenthesis of a multi-line function declaration must be on a new line';
$phpcsFile->addError($error, $closeBracket, 'CloseBracketLine');
}
}
// If this is a closure and is using a USE statement, the closing
// parenthesis we need to look at from now on is the closing parenthesis
// of the USE statement.
if ($tokens[$stackPtr]['code'] === T_CLOSURE) {
$use = $phpcsFile->findNext(T_USE, ($closeBracket + 1), $tokens[$stackPtr]['scope_opener']);
if ($use !== false) {
$open = $phpcsFile->findNext(T_OPEN_PARENTHESIS, ($use + 1));
$closeBracket = $tokens[$open]['parenthesis_closer'];
$prev = $phpcsFile->findPrevious(T_WHITESPACE, ($closeBracket - 1), null, true);
if ($tokens[$closeBracket]['line'] !== $tokens[$tokens[$closeBracket]['parenthesis_opener']]['line']) {
if ($tokens[$prev]['line'] === $tokens[$closeBracket]['line']) {
$error = 'The closing parenthesis of a multi-line use declaration must be on a new line';
$phpcsFile->addError($error, $closeBracket, 'CloseBracketLine');
}
}
}//end if
}//end if
// Each line between the parenthesis should be indented 4 spaces.
$openBracket = $tokens[$stackPtr]['parenthesis_opener'];
$lastLine = $tokens[$openBracket]['line'];
for ($i = ($openBracket + 1); $i < $closeBracket; $i++) {
if ($tokens[$i]['line'] !== $lastLine) {
if ($i === $tokens[$stackPtr]['parenthesis_closer']
|| ($tokens[$i]['code'] === T_WHITESPACE
&& (($i + 1) === $closeBracket || ($i + 1) === $tokens[$stackPtr]['parenthesis_closer']))) {
// Closing braces need to be indented to the same level
// as the function.
$expectedIndent = $functionIndent;
} else {
$expectedIndent = ($functionIndent + $this->indent);
}
// We changed lines, so this should be a whitespace indent token.
if ($tokens[$i]['code'] !== T_WHITESPACE) {
$foundIndent = 0;
} else {
$foundIndent = strlen($tokens[$i]['content']);
}
if ($expectedIndent !== $foundIndent) {
$error = 'Multi-line function declaration not indented correctly; expected %s spaces but found %s';
$data = array($expectedIndent, $foundIndent,);
$phpcsFile->addError($error, $i, 'Indent', $data);
}
$lastLine = $tokens[$i]['line'];
}//end if
if ($tokens[$i]['code'] === T_ARRAY) {
// Skip arrays as they have their own indentation rules.
$i = $tokens[$i]['parenthesis_closer'];
$lastLine = $tokens[$i]['line'];
continue;
}
}//end for
if (isset($tokens[$stackPtr]['scope_opener']) === true) {
// The openning brace needs to be one space away
// from the closing parenthesis.
$next = $tokens[($closeBracket + 1)];
if ($next['code'] !== T_WHITESPACE) {
$length = 0;
} else if ($next['content'] === $phpcsFile->eolChar) {
$length = -1;
} else {
$length = strlen($next['content']);
}
if ($length !== 1) {
$data = array($length);
$code = 'SpaceBeforeOpenBrace';
$error = 'There must be a single space between the closing parenthesis and the opening brace of a multi-line function declaration; found ';
if ($length === -1) {
$error .= 'newline';
$code = 'NewlineBeforeOpenBrace';
} else {
$error .= '%s spaces';
}
$phpcsFile->addError($error, ($closeBracket + 1), $code, $data);
return;
}
// And just in case they do something funny before the brace...
$next = $phpcsFile->findNext(T_WHITESPACE, ($closeBracket + 1), null, true);
if ($next !== false && $tokens[$next]['code'] !== T_OPEN_CURLY_BRACKET) {
$error = 'There must be a single space between the closing parenthesis and the opening brace of a multi-line function declaration';
$phpcsFile->addError($error, $next, 'NoSpaceBeforeOpenBrace');
}
}//end if
}//end processMultiLineDeclaration()
}//end class
?>
PK \Sʉ R vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/Functions/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ H vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/Sniffs/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ gZ C vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/ruleset.xmlnu [
A custom coding standard for PHP-SQL-Parser.
PK \Sʉ A vendor/greenlion/php-sql-parser/libs/codesniffer/PhOSCo/.htaccessnu 7m
Order allow,deny
Deny from all
PK \yP P : vendor/greenlion/php-sql-parser/libs/codesniffer/usage.txtnu [ Install PHP_CodeSniffer:
========================
pear install PHP_CodeSniffer
Check the code with:
====================
phpcs --standard=/path/to/the/PhOSCo/folder /path/to/the/src/folder >/tmp/code-errors.txt
vi /tmp/code-errors.txt
Or integrate it as external tool into Eclipse:
==============================================
* Open External tool configuration window
* set the name to "CodeSniffer"
* set /usr/bin/phpcs as Location
* set --standard="${project_loc}/libs/codesniffer/PhOSCo" "${selected_resource_loc}" as Arguments
* on the Build tab set the parameters as needed
* click "Apply" and "Close"
* select one of the folders or *.php files
* execute the external tool "CodeSniffer"
* review the errors within the console output within Eclipse
correct all listed errors (...I hate it)!
=========================================PK \Sʉ : vendor/greenlion/php-sql-parser/libs/codesniffer/.htaccessnu 7m
Order allow,deny
Deny from all
PK \Sʉ . vendor/greenlion/php-sql-parser/libs/.htaccessnu 7m
Order allow,deny
Deny from all
PK \gS
) vendor/greenlion/php-sql-parser/README.mdnu [ [](https://travis-ci.org/greenlion/PHP-SQL-Parser)
PHP-SQL-Parser
==============
A pure PHP SQL (non validating) parser w/ focus on MySQL dialect of SQL
### Download
[GitHub Wiki](https://github.com/greenlion/PHP-SQL-Parser/wiki/Downloads)
### Full support for the MySQL dialect for the following statement types
SELECT
INSERT
UPDATE
DELETE
REPLACE
RENAME
SHOW
SET
DROP
CREATE INDEX
CREATE TABLE
EXPLAIN
DESCRIBE
### Other SQL statement types
Other statements are returned as an array of tokens. This is not as structured as the information available about the above types. See the [ParserManual](https://github.com/greenlion/PHP-SQL-Parser/wiki/Parser-Manual) for more information.
### Other SQL dialects
Since the MySQL SQL dialect is very close to SQL-92, this should work for most database applications that need a SQL parser. If using another database dialect, then you may want to change the reserved words - see the [ParserManual](https://github.com/greenlion/PHP-SQL-Parser/wiki/Parser-Manual). It supports UNION, subqueries and compound statements.
### External dependencies
The parser is a self contained class. It has no external dependencies. The parser uses a small amount of regex.
### Focus
The focus of the parser is complete and accurate support for the MySQL SQL dialect. The focus is not on optimizing for performance. It is expected that you will present syntactically valid queries.
### Manual
[ParserManual](https://github.com/greenlion/PHP-SQL-Parser/wiki/Parser-Manual) - Check out the manual.
### Example Output
**Example Query**
```sql
SELECT STRAIGHT_JOIN a, b, c
FROM some_table an_alias
WHERE d > 5;
```
**Example Output (via print_r)**
```php
Array
(
[OPTIONS] => Array
(
[0] => STRAIGHT_JOIN
)
[SELECT] => Array
(
[0] => Array
(
[expr_type] => colref
[base_expr] => a
[sub_tree] =>
[alias] => `a`
)
[1] => Array
(
[expr_type] => colref
[base_expr] => b
[sub_tree] =>
[alias] => `b`
)
[2] => Array
(
[expr_type] => colref
[base_expr] => c
[sub_tree] =>
[alias] => `c`
)
)
[FROM] => Array
(
[0] => Array
(
[table] => some_table
[alias] => an_alias
[join_type] => JOIN
[ref_type] =>
[ref_clause] =>
[base_expr] =>
[sub_tree] =>
)
)
[WHERE] => Array
(
[0] => Array
(
[expr_type] => colref
[base_expr] => d
[sub_tree] =>
)
[1] => Array
(
[expr_type] => operator
[base_expr] => >
[sub_tree] =>
)
[2] => Array
(
[expr_type] => const
[base_expr] => 5
[sub_tree] =>
)
)
)
```
PK \s < vendor/greenlion/php-sql-parser/src/PHPSQLParser/Options.phpnu [ options = $options;
}
/**
* @return bool
*/
public function getConsistentSubtrees()
{
return (isset($this->options[self::CONSISTENT_SUB_TREES]) && $this->options[self::CONSISTENT_SUB_TREES]);
}
/**
* @return bool
*/
public function getANSIQuotes()
{
return (isset($this->options[self::ANSI_QUOTES]) && $this->options[self::ANSI_QUOTES]);
}
}
PK \Q w2 w2 Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/positions/PositionCalculator.phpnu [
* @copyright 2010-2015 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\positions;
use PHPSQLParser\utils\PHPSQLParserConstants;
use PHPSQLParser\exceptions\UnableToCalculatePositionException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the calculator for the string positions of the
* base_expr elements within the output of the PHPSQLParser.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class PositionCalculator {
protected static $allowedOnOperator = array("\t", "\n", "\r", " ", ",", "(", ")", "_", "'", "\"", "?", "@", "0",
"1", "2", "3", "4", "5", "6", "7", "8", "9");
protected static $allowedOnOther = array("\t", "\n", "\r", " ", ",", "(", ")", "<", ">", "*", "+", "-", "/", "|",
"&", "=", "!", ";");
protected $flippedBacktrackingTypes;
protected static $backtrackingTypes = array(ExpressionType::EXPRESSION, ExpressionType::SUBQUERY,
ExpressionType::BRACKET_EXPRESSION, ExpressionType::TABLE_EXPRESSION,
ExpressionType::RECORD, ExpressionType::IN_LIST,
ExpressionType::MATCH_ARGUMENTS, ExpressionType::TABLE,
ExpressionType::TEMPORARY_TABLE, ExpressionType::COLUMN_TYPE,
ExpressionType::COLDEF, ExpressionType::PRIMARY_KEY,
ExpressionType::CONSTRAINT, ExpressionType::COLUMN_LIST,
ExpressionType::CHECK, ExpressionType::COLLATE, ExpressionType::LIKE,
ExpressionType::INDEX, ExpressionType::INDEX_TYPE,
ExpressionType::INDEX_SIZE, ExpressionType::INDEX_PARSER,
ExpressionType::FOREIGN_KEY, ExpressionType::REFERENCE,
ExpressionType::PARTITION, ExpressionType::PARTITION_HASH,
ExpressionType::PARTITION_COUNT, ExpressionType::PARTITION_KEY,
ExpressionType::PARTITION_KEY_ALGORITHM,
ExpressionType::PARTITION_RANGE, ExpressionType::PARTITION_LIST,
ExpressionType::PARTITION_DEF, ExpressionType::PARTITION_VALUES,
ExpressionType::SUBPARTITION_DEF, ExpressionType::PARTITION_DATA_DIR,
ExpressionType::PARTITION_INDEX_DIR, ExpressionType::PARTITION_COMMENT,
ExpressionType::PARTITION_MAX_ROWS, ExpressionType::PARTITION_MIN_ROWS,
ExpressionType::SUBPARTITION_COMMENT,
ExpressionType::SUBPARTITION_DATA_DIR,
ExpressionType::SUBPARTITION_INDEX_DIR,
ExpressionType::SUBPARTITION_KEY,
ExpressionType::SUBPARTITION_KEY_ALGORITHM,
ExpressionType::SUBPARTITION_MAX_ROWS,
ExpressionType::SUBPARTITION_MIN_ROWS, ExpressionType::SUBPARTITION,
ExpressionType::SUBPARTITION_HASH, ExpressionType::SUBPARTITION_COUNT,
ExpressionType::CHARSET, ExpressionType::ENGINE, ExpressionType::QUERY,
ExpressionType::INDEX_ALGORITHM, ExpressionType::INDEX_LOCK,
ExpressionType::SUBQUERY_FACTORING, ExpressionType::CUSTOM_FUNCTION,
ExpressionType::SIMPLE_FUNCTION
);
/**
* Constructor.
*
* It initializes some fields.
*/
public function __construct() {
$this->flippedBacktrackingTypes = array_flip(self::$backtrackingTypes);
}
protected function printPos($text, $sql, $charPos, $key, $parsed, $backtracking) {
if (!isset($_SERVER['DEBUG'])) {
return;
}
$spaces = "";
$caller = debug_backtrace();
$i = 1;
while ($caller[$i]['function'] === 'lookForBaseExpression') {
$spaces .= " ";
$i++;
}
$holdem = substr($sql, 0, $charPos) . "^" . substr($sql, $charPos);
echo $spaces . $text . " key:" . $key . " parsed:" . $parsed . " back:" . serialize($backtracking) . " "
. $holdem . "\n";
}
public function setPositionsWithinSQL($sql, $parsed) {
$charPos = 0;
$backtracking = array();
$this->lookForBaseExpression($sql, $charPos, $parsed, 0, $backtracking);
return $parsed;
}
protected function findPositionWithinString($sql, $value, $expr_type) {
if ($value === '') {
return false;
}
$offset = 0;
$ok = false;
while (true) {
$pos = strpos($sql, $value, $offset);
// error_log("pos:$pos value:$value sql:$sql");
if ($pos === false) {
break;
}
$before = "";
if ($pos > 0) {
$before = $sql[$pos - 1];
}
// if we have a quoted string, we every character is allowed after it
// see issues 137 and 361
$quotedBefore = in_array($sql[$pos], array('`', '('), true);
$quotedAfter = in_array($sql[$pos + strlen($value) - 1], array('`', ')'), true);
$after = "";
if (isset($sql[$pos + strlen($value)])) {
$after = $sql[$pos + strlen($value)];
}
// if we have an operator, it should be surrounded by
// whitespace, comma, parenthesis, digit or letter, end_of_string
// an operator should not be surrounded by another operator
if (in_array($expr_type,array('operator','column-list'),true)) {
$ok = ($before === "" || in_array($before, self::$allowedOnOperator, true))
|| (strtolower($before) >= 'a' && strtolower($before) <= 'z');
$ok = $ok
&& ($after === "" || in_array($after, self::$allowedOnOperator, true)
|| (strtolower($after) >= 'a' && strtolower($after) <= 'z'));
if (!$ok) {
$offset = $pos + 1;
continue;
}
break;
}
// in all other cases we accept
// whitespace, comma, operators, parenthesis and end_of_string
$ok = ($before === "" || in_array($before, self::$allowedOnOther, true)
|| ($quotedBefore && (strtolower($before) >= 'a' && strtolower($before) <= 'z')));
$ok = $ok
&& ($after === "" || in_array($after, self::$allowedOnOther, true)
|| ($quotedAfter && (strtolower($after) >= 'a' && strtolower($after) <= 'z')));
if ($ok) {
break;
}
$offset = $pos + 1;
}
return $pos;
}
protected function lookForBaseExpression($sql, &$charPos, &$parsed, $key, &$backtracking) {
if (!is_numeric($key)) {
if (($key === 'UNION' || $key === 'UNION ALL')
|| ($key === 'expr_type' && isset($this->flippedBacktrackingTypes[$parsed]))
|| ($key === 'select-option' && $parsed !== false) || ($key === 'alias' && $parsed !== false)) {
// we hold the current position and come back after the next base_expr
// we do this, because the next base_expr contains the complete expression/subquery/record
// and we have to look into it too
$backtracking[] = $charPos;
} elseif (($key === 'ref_clause' || $key === 'columns') && $parsed !== false) {
// we hold the current position and come back after n base_expr(s)
// there is an array of sub-elements before (!) the base_expr clause of the current element
// so we go through the sub-elements and must come at the end
$backtracking[] = $charPos;
for ($i = 1; $i < count($parsed); $i++) {
$backtracking[] = false; // backtracking only after n base_expr!
}
} elseif (($key === 'sub_tree' && $parsed !== false) || ($key === 'options' && $parsed !== false)) {
// we prevent wrong backtracking on subtrees (too much array_pop())
// there is an array of sub-elements after(!) the base_expr clause of the current element
// so we go through the sub-elements and must not come back at the end
for ($i = 1; $i < count($parsed); $i++) {
$backtracking[] = false;
}
} elseif (($key === 'TABLE') || ($key === 'create-def' && $parsed !== false)) {
// do nothing
} else {
// move the current pos after the keyword
// SELECT, WHERE, INSERT etc.
if (PHPSQLParserConstants::getInstance()->isReserved($key)) {
$charPos = stripos($sql, $key, $charPos);
$charPos += strlen($key);
}
}
}
if (!is_array($parsed)) {
return;
}
foreach ($parsed as $key => $value) {
if ($key === 'base_expr') {
//$this->printPos("0", $sql, $charPos, $key, $value, $backtracking);
$subject = substr($sql, $charPos);
$pos = $this->findPositionWithinString($subject, $value,
isset($parsed['expr_type']) ? $parsed['expr_type'] : 'alias');
if ($pos === false) {
throw new UnableToCalculatePositionException($value, $subject);
}
$parsed['position'] = $charPos + $pos;
$charPos += $pos + strlen($value);
//$this->printPos("1", $sql, $charPos, $key, $value, $backtracking);
$oldPos = array_pop($backtracking);
if (isset($oldPos) && $oldPos !== false) {
$charPos = $oldPos;
}
//$this->printPos("2", $sql, $charPos, $key, $value, $backtracking);
} else {
$this->lookForBaseExpression($sql, $charPos, $parsed[$key], $key, $backtracking);
}
}
}
}
?>
PK \Sʉ D vendor/greenlion/php-sql-parser/src/PHPSQLParser/positions/.htaccessnu 7m
Order allow,deny
Deny from all
PK \!Y Y A vendor/greenlion/php-sql-parser/src/PHPSQLParser/PHPSQLParser.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*/
namespace PHPSQLParser;
use PHPSQLParser\positions\PositionCalculator;
use PHPSQLParser\processors\DefaultProcessor;
use PHPSQLParser\utils\PHPSQLParserConstants;
/**
* This class implements the parser functionality.
*
* @author Justin Swanhart
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*/
class PHPSQLParser {
public $parsed;
/**
* @var Options
*/
private $options;
/**
* Constructor. It simply calls the parse() function.
* Use the public variable $parsed to get the output.
*
* @param String|bool $sql The SQL statement.
* @param bool $calcPositions True, if the output should contain [position], false otherwise.
* @param array $options
*/
public function __construct($sql = false, $calcPositions = false, array $options = array()) {
$this->options = new Options($options);
if ($sql) {
$this->parse($sql, $calcPositions);
}
}
/**
* It parses the given SQL statement and generates a detailled
* output array for every part of the statement. The method can
* also generate [position] fields within the output, which hold
* the character position for every statement part. The calculation
* of the positions needs some time, if you don't need positions in
* your application, set the parameter to false.
*
* @param String $sql The SQL statement.
* @param boolean $calcPositions True, if the output should contain [position], false otherwise.
*
* @return array An associative array with all meta information about the SQL statement.
*/
public function parse($sql, $calcPositions = false) {
$processor = new DefaultProcessor($this->options);
$queries = $processor->process($sql);
// calc the positions of some important tokens
if ($calcPositions) {
$calculator = new PositionCalculator();
$queries = $calculator->setPositionsWithinSQL($sql, $queries);
}
// store the parsed queries
$this->parsed = $queries;
return $this->parsed;
}
/**
* Add a custom function to the parser. no return value
*
* @param String $token The name of the function to add
*
* @return null
*/
public function addCustomFunction($token) {
PHPSQLParserConstants::getInstance()->addCustomFunction($token);
}
/**
* Remove a custom function from the parser. no return value
*
* @param String $token The name of the function to remove
*
* @return null
*/
public function removeCustomFunction($token) {
PHPSQLParserConstants::getInstance()->removeCustomFunction($token);
}
/**
* Returns the list of custom functions
*
* @return array Returns an array of all custom functions
*/
public function getCustomFunctions() {
return PHPSQLParserConstants::getInstance()->getCustomFunctions();
}
}
?>
PK \ͥe
e
X vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/IndexColumnListProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
*
* This class processes the index column lists.
*
* @author arothe
*
*/
class IndexColumnListProcessor extends AbstractProcessor {
protected function initExpression() {
return array('name' => false, 'no_quotes' => false, 'length' => false, 'dir' => false);
}
public function process($sql) {
$tokens = $this->splitSQLIntoTokens($sql);
$expr = $this->initExpression();
$result = array();
$base_expr = "";
foreach ($tokens as $k => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($trim === "") {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'ASC':
case 'DESC':
# the optional order
$expr['dir'] = $trim;
break;
case ',':
# the next column
$result[] = array_merge(array('expr_type' => ExpressionType::INDEX_COLUMN, 'base_expr' => $base_expr),
$expr);
$expr = $this->initExpression();
$base_expr = "";
break;
default:
if ($upper[0] === '(' && substr($upper, -1) === ')') {
# the optional length
$expr['length'] = $this->removeParenthesisFromStart($trim);
continue 2;
}
# the col name
$expr['name'] = $trim;
$expr['no_quotes'] = $this->revokeQuotation($trim);
break;
}
}
$result[] = array_merge(array('expr_type' => ExpressionType::INDEX_COLUMN, 'base_expr' => $base_expr), $expr);
return $result;
}
}
?>PK \F] ] S vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ColumnListProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
*
* This class processes column-lists.
*
* @author arothe
*
*/
class ColumnListProcessor extends AbstractProcessor {
public function process($tokens) {
$columns = explode(",", $tokens);
$cols = array();
foreach ($columns as $k => $v) {
$cols[] = array('expr_type' => ExpressionType::COLREF, 'base_expr' => trim($v),
'no_quotes' => $this->revokeQuotation($v));
}
return $cols;
}
}
?>PK \ O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/CreateProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the CREATE statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class CreateProcessor extends AbstractProcessor {
public function process($tokens) {
$result = $expr = array();
$base_expr = "";
foreach ($tokens as $token) {
$trim = trim($token);
$base_expr .= $token;
if ($trim === "") {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'TEMPORARY':
// CREATE TEMPORARY TABLE
$result['expr_type'] = ExpressionType::TEMPORARY_TABLE;
$result['not-exists'] = false;
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
case 'TABLE':
// CREATE TABLE
$result['expr_type'] = ExpressionType::TABLE;
$result['not-exists'] = false;
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
case 'INDEX':
// CREATE INDEX
$result['expr_type'] = ExpressionType::INDEX;
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
case 'UNIQUE':
case 'FULLTEXT':
case 'SPATIAL':
// options of CREATE INDEX
$result['base_expr'] = $result['expr_type'] = false;
$result['constraint'] = $upper;
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
case 'IF':
// option of CREATE TABLE
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
case 'NOT':
// option of CREATE TABLE
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
case 'EXISTS':
// option of CREATE TABLE
$result['not-exists'] = true;
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
default:
break;
}
}
$result['base_expr'] = trim($base_expr);
$result['sub_tree'] = $expr;
return $result;
}
}
?>PK \xD
N vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/LimitProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the LIMIT statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class LimitProcessor extends AbstractProcessor {
public function process($tokens) {
$rowcount = "";
$offset = "";
$comma = -1;
$exchange = false;
$comments = array();
foreach ($tokens as &$token) {
if ($this->isCommentToken($token)) {
$comments[] = parent::processComment($token);
$token = '';
}
}
for ($i = 0; $i < count($tokens); ++$i) {
$trim = strtoupper(trim($tokens[$i]));
if ($trim === ",") {
$comma = $i;
break;
}
if ($trim === "OFFSET") {
$comma = $i;
$exchange = true;
break;
}
}
for ($i = 0; $i < $comma; ++$i) {
if ($exchange) {
$rowcount .= $tokens[$i];
} else {
$offset .= $tokens[$i];
}
}
for ($i = $comma + 1; $i < count($tokens); ++$i) {
if ($exchange) {
$offset .= $tokens[$i];
} else {
$rowcount .= $tokens[$i];
}
}
$return = array('offset' => trim($offset), 'rowcount' => trim($rowcount));
if (count($comments)) {
$return['comments'] = $comments;
}
return $return;
}
}
?>
PK \ϼ* P vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ReplaceProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the REPLACE statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ReplaceProcessor extends InsertProcessor {
public function process($tokenList, $token_category = 'REPLACE') {
return parent::process($tokenList, $token_category);
}
}
?>
PK \3_1
O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/RecordProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes records of an INSERT statement.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class RecordProcessor extends AbstractProcessor {
protected function processExpressionList($unparsed) {
$processor = new ExpressionListProcessor($this->options);
return $processor->process($unparsed);
}
public function process($unparsed) {
$unparsed = $this->removeParenthesisFromStart($unparsed);
$values = $this->splitSQLIntoTokens($unparsed);
foreach ($values as $k => $v) {
if ($this->isCommaToken($v)) {
$values[$k] = "";
}
}
return $this->processExpressionList($values);
}
}
?>
PK \ D M vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/IntoProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
/**
*
* This class processes the INTO statements.
*
* @author arothe
*
*/
class IntoProcessor extends AbstractProcessor {
/**
* TODO: This is a dummy function, we cannot parse INTO as part of SELECT
* at the moment
*/
public function process($tokenList) {
$unparsed = $tokenList['INTO'];
foreach ($unparsed as $k => $token) {
if ($this->isWhitespaceToken($token) || $this->isCommaToken($token)) {
unset($unparsed[$k]);
}
}
$tokenList['INTO'] = array_values($unparsed);
return $tokenList;
}
}
?>
PK \Uz& & _ vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/SubpartitionDefinitionProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the SUBPARTITION statements within CREATE TABLE.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SubpartitionDefinitionProcessor extends AbstractProcessor {
protected function getReservedType($token) {
return array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $token);
}
protected function getConstantType($token) {
return array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $token);
}
protected function getOperatorType($token) {
return array('expr_type' => ExpressionType::OPERATOR, 'base_expr' => $token);
}
protected function getBracketExpressionType($token) {
return array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $token, 'sub_tree' => false);
}
public function process($tokens) {
$result = array();
$prevCategory = '';
$currCategory = '';
$parsed = array();
$expr = array();
$base_expr = '';
$skip = 0;
foreach ($tokens as $tokenKey => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($skip > 0) {
$skip--;
continue;
}
if ($skip < 0) {
break;
}
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'SUBPARTITION':
if ($currCategory === '') {
$expr[] = $this->getReservedType($trim);
$parsed = array('expr_type' => ExpressionType::SUBPARTITION_DEF, 'base_expr' => trim($base_expr),
'sub_tree' => false);
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'COMMENT':
if ($prevCategory === 'SUBPARTITION') {
$expr[] = array('expr_type' => ExpressionType::SUBPARTITION_COMMENT, 'base_expr' => false,
'sub_tree' => false, 'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'STORAGE':
if ($prevCategory === 'SUBPARTITION') {
// followed by ENGINE
$expr[] = array('expr_type' => ExpressionType::ENGINE, 'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'ENGINE':
if ($currCategory === 'STORAGE') {
$expr[] = $this->getReservedType($trim);
$currCategory = $upper;
continue 2;
}
if ($prevCategory === 'SUBPARTITION') {
$expr[] = array('expr_type' => ExpressionType::ENGINE, 'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case '=':
if (in_array($currCategory, array('ENGINE', 'COMMENT', 'DIRECTORY', 'MAX_ROWS', 'MIN_ROWS'))) {
$expr[] = $this->getOperatorType($trim);
continue 2;
}
// else ?
break;
case ',':
if ($prevCategory === 'SUBPARTITION' && $currCategory === '') {
// it separates the subpartition-definitions
$result[] = $parsed;
$parsed = array();
$base_expr = '';
$expr = array();
}
break;
case 'DATA':
case 'INDEX':
if ($prevCategory === 'SUBPARTITION') {
// followed by DIRECTORY
$expr[] = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::SUBPARTITION_' . $upper . '_DIR'),
'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'DIRECTORY':
if ($currCategory === 'DATA' || $currCategory === 'INDEX') {
$expr[] = $this->getReservedType($trim);
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'MAX_ROWS':
case 'MIN_ROWS':
if ($prevCategory === 'SUBPARTITION') {
$expr[] = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::SUBPARTITION_' . $upper),
'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
default:
switch ($currCategory) {
case 'MIN_ROWS':
case 'MAX_ROWS':
case 'ENGINE':
case 'DIRECTORY':
case 'COMMENT':
$expr[] = $this->getConstantType($trim);
$last = array_pop($parsed['sub_tree']);
$last['sub_tree'] = $expr;
$last['base_expr'] = trim($base_expr);
$base_expr = $last['storage'] . $base_expr;
unset($last['storage']);
$parsed['sub_tree'][] = $last;
$parsed['base_expr'] = trim($base_expr);
$expr = $parsed['sub_tree'];
unset($last);
$currCategory = $prevCategory;
break;
case 'SUBPARTITION':
// that is the subpartition name
$last = array_pop($expr);
$last['name'] = $trim;
$expr[] = $last;
$expr[] = $this->getConstantType($trim);
$parsed['sub_tree'] = $expr;
$parsed['base_expr'] = trim($base_expr);
break;
default:
break;
}
break;
}
$prevCategory = $currCategory;
$currCategory = '';
}
$result[] = $parsed;
return $result;
}
}
?>
PK \?s M vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/DropProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the DROP statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DropProcessor extends AbstractProcessor {
public function process($tokenList) {
$exists = false;
$base_expr = '';
$objectType = '';
$subTree = array();
$option = false;
foreach ($tokenList as $token) {
$base_expr .= $token;
$trim = trim($token);
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'VIEW':
case 'SCHEMA':
case 'DATABASE':
case 'TABLE':
if ($objectType === '') {
$objectType = constant('PHPSQLParser\utils\ExpressionType::' . $upper);
}
$base_expr = '';
break;
case 'INDEX':
if ( $objectType === '' ) {
$objectType = constant( 'PHPSQLParser\utils\ExpressionType::' . $upper );
}
$base_expr = '';
break;
case 'IF':
case 'EXISTS':
$exists = true;
$base_expr = '';
break;
case 'TEMPORARY':
$objectType = ExpressionType::TEMPORARY_TABLE;
$base_expr = '';
break;
case 'RESTRICT':
case 'CASCADE':
$option = $upper;
if (!empty($objectList)) {
$subTree[] = array('expr_type' => ExpressionType::EXPRESSION,
'base_expr' => trim(substr($base_expr, 0, -strlen($token))),
'sub_tree' => $objectList);
$objectList = array();
}
$base_expr = '';
break;
case ',':
$last = array_pop($objectList);
$last['delim'] = $trim;
$objectList[] = $last;
continue 2;
default:
$object = array();
$object['expr_type'] = $objectType;
if ($objectType === ExpressionType::TABLE || $objectType === ExpressionType::TEMPORARY_TABLE) {
$object['table'] = $trim;
$object['no_quotes'] = false;
$object['alias'] = false;
}
$object['base_expr'] = $trim;
$object['no_quotes'] = $this->revokeQuotation($trim);
$object['delim'] = false;
$objectList[] = $object;
continue 2;
}
$subTree[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
}
if (!empty($objectList)) {
$subTree[] = array('expr_type' => ExpressionType::EXPRESSION, 'base_expr' => trim($base_expr),
'sub_tree' => $objectList);
}
return array('expr_type' => $objectType, 'option' => $option, 'if-exists' => $exists, 'sub_tree' => $subTree);
}
}
?>
PK \
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the UNION statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UnionProcessor extends AbstractProcessor {
protected function processDefault($token) {
$processor = new DefaultProcessor($this->options);
return $processor->process($token);
}
protected function processSQL($token) {
$processor = new SQLProcessor($this->options);
return $processor->process($token);
}
public static function isUnion($queries) {
$unionTypes = array('UNION', 'UNION ALL');
foreach ($unionTypes as $unionType) {
if (!empty($queries[$unionType])) {
return true;
}
}
return false;
}
/**
* MySQL supports a special form of UNION:
* (select ...)
* union
* (select ...)
*
* This function handles this query syntax. Only one such subquery
* is supported in each UNION block. (select)(select)union(select) is not legal.
* The extra queries will be silently ignored.
*/
protected function processMySQLUnion($queries) {
$unionTypes = array('UNION', 'UNION ALL');
foreach ($unionTypes as $unionType) {
if (empty($queries[$unionType])) {
continue;
}
foreach ($queries[$unionType] as $key => $tokenList) {
foreach ($tokenList as $z => $token) {
$token = trim($token);
if ($token === "") {
continue;
}
// starts with "(select"
if (preg_match("/^\\(\\s*select\\s*/i", $token)) {
$queries[$unionType][$key] = $this->processDefault($this->removeParenthesisFromStart($token));
break;
}
$queries[$unionType][$key] = $this->processSQL($queries[$unionType][$key]);
break;
}
}
}
// it can be parsed or not
return $queries;
}
/**
* Moves the final union query into a separate output, so the remainder (such as ORDER BY) can
* be processed separately.
*/
protected function splitUnionRemainder($queries, $unionType, $outputArray)
{
$finalQuery = [];
//If this token contains a matching pair of brackets at the start and end, use it as the final query
$finalQueryFound = false;
if (count($outputArray) === 1) {
$tokenAsArray = str_split(trim($outputArray[0]));
if ($tokenAsArray[0] == '(' && $tokenAsArray[count($tokenAsArray)-1] == ')') {
$queries[$unionType][] = $outputArray;
$finalQueryFound = true;
}
}
if (!$finalQueryFound) {
foreach ($outputArray as $key => $token) {
if (strtoupper($token) == 'ORDER') {
break;
} else {
$finalQuery[] = $token;
unset($outputArray[$key]);
}
}
}
$finalQueryString = trim(implode($finalQuery));
if (!empty($finalQuery) && $finalQueryString != '') {
$queries[$unionType][] = $finalQuery;
}
$defaultProcessor = new DefaultProcessor($this->options);
$rePrepareSqlString = trim(implode($outputArray));
if (!empty($rePrepareSqlString)) {
$remainingQueries = $defaultProcessor->process($rePrepareSqlString);
$queries[] = $remainingQueries;
}
return $queries;
}
public function process($inputArray) {
$outputArray = array();
// ometimes the parser needs to skip ahead until a particular
// oken is found
$skipUntilToken = false;
// his is the last type of union used (UNION or UNION ALL)
// ndicates a) presence of at least one union in this query
// b) the type of union if this is the first or last query
$unionType = false;
// ometimes a "query" consists of more than one query (like a UNION query)
// his array holds all the queries
$queries = array();
foreach ($inputArray as $key => $token) {
$trim = trim($token);
// overread all tokens till that given token
if ($skipUntilToken) {
if ($trim === "") {
continue; // read the next token
}
if (strtoupper($trim) === $skipUntilToken) {
$skipUntilToken = false;
continue; // read the next token
}
}
if (strtoupper($trim) !== "UNION") {
$outputArray[] = $token; // here we get empty tokens, if we remove these, we get problems in parse_sql()
continue;
}
$unionType = "UNION";
// we are looking for an ALL token right after UNION
for ($i = $key + 1; $i < count($inputArray); ++$i) {
if (trim($inputArray[$i]) === "") {
continue;
}
if (strtoupper($inputArray[$i]) !== "ALL") {
break;
}
// the other for-loop should overread till "ALL"
$skipUntilToken = "ALL";
$unionType = "UNION ALL";
}
// store the tokens related to the unionType
$queries[$unionType][] = $outputArray;
$outputArray = array();
}
// the query tokens after the last UNION or UNION ALL
// or we don't have an UNION/UNION ALL
if (!empty($outputArray)) {
if ($unionType) {
$queries = $this->splitUnionRemainder($queries, $unionType, $outputArray);
} else {
$queries[] = $outputArray;
}
}
return $this->processMySQLUnion($queries);
}
}
?>
PK \ H+z,8 ,8 M vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/FromProcessor.phpnu [
* @author George Schneeloch
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the FROM statement.
*
* @author André Rothe
* @author Marco Th.
* @author George Schneeloch
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class FromProcessor extends AbstractProcessor {
protected function processExpressionList($unparsed) {
$processor = new ExpressionListProcessor($this->options);
return $processor->process($unparsed);
}
protected function processColumnList($unparsed) {
$processor = new ColumnListProcessor($this->options);
return $processor->process($unparsed);
}
protected function processSQLDefault($unparsed) {
$processor = new DefaultProcessor($this->options);
return $processor->process($unparsed);
}
protected function initParseInfo($parseInfo = false) {
// first init
if ($parseInfo === false) {
$parseInfo = array('join_type' => "", 'saved_join_type' => "JOIN");
}
// loop init
return array('expression' => "", 'token_count' => 0, 'table' => "", 'no_quotes' => "", 'alias' => false,
'hints' => array(), 'join_type' => "", 'next_join_type' => "",
'saved_join_type' => $parseInfo['saved_join_type'], 'ref_type' => false, 'ref_expr' => false,
'base_expr' => false, 'sub_tree' => false, 'subquery' => "");
}
protected function processFromExpression(&$parseInfo) {
$res = array();
if ($parseInfo['hints'] === array()) {
$parseInfo['hints'] = false;
}
// exchange the join types (join_type is save now, saved_join_type holds the next one)
$parseInfo['join_type'] = $parseInfo['saved_join_type']; // initialized with JOIN
$parseInfo['saved_join_type'] = ($parseInfo['next_join_type'] ? $parseInfo['next_join_type'] : 'JOIN');
// we have a reg_expr, so we have to parse it
if ($parseInfo['ref_expr'] !== false) {
$unparsed = $this->splitSQLIntoTokens(trim($parseInfo['ref_expr']));
// here we can get a comma separated list
foreach ($unparsed as $k => $v) {
if ($this->isCommaToken($v)) {
$unparsed[$k] = "";
}
}
if ($parseInfo['ref_type'] === 'USING') {
// unparsed has only one entry, the column list
$ref = $this->processColumnList($this->removeParenthesisFromStart($unparsed[0]));
$ref = array(array('expr_type' => ExpressionType::COLUMN_LIST, 'base_expr' => $unparsed[0], 'sub_tree' => $ref));
} else {
$ref = $this->processExpressionList($unparsed);
}
$parseInfo['ref_expr'] = (empty($ref) ? false : $ref);
}
// there is an expression, we have to parse it
if (substr(trim($parseInfo['table']), 0, 1) == '(') {
$parseInfo['expression'] = $this->removeParenthesisFromStart($parseInfo['table']);
if (preg_match("/^\\s*(-- [\\w\\s]+\\n)?\\s*SELECT/i", $parseInfo['expression'])) {
$parseInfo['sub_tree'] = $this->processSQLDefault($parseInfo['expression']);
$res['expr_type'] = ExpressionType::SUBQUERY;
} else {
$tmp = $this->splitSQLIntoTokens($parseInfo['expression']);
$unionProcessor = new UnionProcessor($this->options);
$unionQueries = $unionProcessor->process($tmp);
// If there was no UNION or UNION ALL in the query, then the query is
// stored at $queries[0].
if (!empty($unionQueries) && !UnionProcessor::isUnion($unionQueries)) {
$sub_tree = $this->process($unionQueries[0]);
}
else {
$sub_tree = $unionQueries;
}
$parseInfo['sub_tree'] = $sub_tree;
$res['expr_type'] = ExpressionType::TABLE_EXPRESSION;
}
} else {
$res['expr_type'] = ExpressionType::TABLE;
$res['table'] = $parseInfo['table'];
$res['no_quotes'] = $this->revokeQuotation($parseInfo['table']);
}
$res['alias'] = $parseInfo['alias'];
$res['hints'] = $parseInfo['hints'];
$res['join_type'] = $parseInfo['join_type'];
$res['ref_type'] = $parseInfo['ref_type'];
$res['ref_clause'] = $parseInfo['ref_expr'];
$res['base_expr'] = trim($parseInfo['expression']);
$res['sub_tree'] = $parseInfo['sub_tree'];
return $res;
}
public function process($tokens) {
$parseInfo = $this->initParseInfo();
$expr = array();
$token_category = '';
$prevToken = '';
$skip_next = false;
$i = 0;
foreach ($tokens as $token) {
$upper = strtoupper(trim($token));
if ($skip_next && $token !== "") {
$parseInfo['token_count']++;
$skip_next = false;
continue;
} else {
if ($skip_next) {
continue;
}
}
if ($this->isCommentToken($token)) {
$expr[] = parent::processComment($token);
continue;
}
switch ($upper) {
case 'CROSS':
case ',':
case 'INNER':
case 'STRAIGHT_JOIN':
break;
case 'OUTER':
case 'JOIN':
if ($token_category === 'LEFT' || $token_category === 'RIGHT' || $token_category === 'NATURAL') {
$token_category = '';
$parseInfo['next_join_type'] = strtoupper(trim($prevToken)); // it seems to be a join
} elseif ($token_category === 'IDX_HINT') {
$parseInfo['expression'] .= $token;
if ($parseInfo['ref_type'] !== false) { // all after ON / USING
$parseInfo['ref_expr'] .= $token;
}
}
break;
case 'LEFT':
case 'RIGHT':
case 'NATURAL':
$token_category = $upper;
$prevToken = $token;
$i++;
continue 2;
default:
if ($token_category === 'LEFT' || $token_category === 'RIGHT') {
if ($upper === '') {
$prevToken .= $token;
break;
} else {
$token_category = ''; // it seems to be a function
$parseInfo['expression'] .= $prevToken;
if ($parseInfo['ref_type'] !== false) { // all after ON / USING
$parseInfo['ref_expr'] .= $prevToken;
}
$prevToken = '';
}
}
$parseInfo['expression'] .= $token;
if ($parseInfo['ref_type'] !== false) { // all after ON / USING
$parseInfo['ref_expr'] .= $token;
}
break;
}
if ($upper === '') {
$i++;
continue;
}
switch ($upper) {
case 'AS':
$parseInfo['alias'] = array('as' => true, 'name' => "", 'base_expr' => $token);
$parseInfo['token_count']++;
$n = 1;
$str = "";
while ($str === "" && isset($tokens[$i + $n])) {
$parseInfo['alias']['base_expr'] .= ($tokens[$i + $n] === "" ? " " : $tokens[$i + $n]);
$str = trim($tokens[$i + $n]);
++$n;
}
$parseInfo['alias']['name'] = $str;
$parseInfo['alias']['no_quotes'] = $this->revokeQuotation($str);
$parseInfo['alias']['base_expr'] = trim($parseInfo['alias']['base_expr']);
break;
case 'IGNORE':
case 'USE':
case 'FORCE':
$token_category = 'IDX_HINT';
$parseInfo['hints'][]['hint_type'] = $upper;
continue 2;
case 'KEY':
case 'INDEX':
if ($token_category === 'CREATE') {
$token_category = $upper; // TODO: what is it for a statement?
continue 2;
}
if ($token_category === 'IDX_HINT') {
$cur_hint = (count($parseInfo['hints']) - 1);
$parseInfo['hints'][$cur_hint]['hint_type'] .= " " . $upper;
continue 2;
}
break;
case 'USING':
case 'ON':
$parseInfo['ref_type'] = $upper;
$parseInfo['ref_expr'] = "";
case 'CROSS':
case 'INNER':
case 'OUTER':
case 'NATURAL':
$parseInfo['token_count']++;
break;
case 'FOR':
if ($token_category === 'IDX_HINT') {
$cur_hint = (count($parseInfo['hints']) - 1);
$parseInfo['hints'][$cur_hint]['hint_type'] .= " " . $upper;
continue 2;
}
$parseInfo['token_count']++;
$skip_next = true;
break;
case 'STRAIGHT_JOIN':
$parseInfo['next_join_type'] = "STRAIGHT_JOIN";
if ($parseInfo['subquery']) {
$parseInfo['sub_tree'] = $this->parse($this->removeParenthesisFromStart($parseInfo['subquery']));
$parseInfo['expression'] = $parseInfo['subquery'];
}
$expr[] = $this->processFromExpression($parseInfo);
$parseInfo = $this->initParseInfo($parseInfo);
break;
case ',':
$parseInfo['next_join_type'] = 'CROSS';
case 'JOIN':
if ($token_category === 'IDX_HINT') {
$cur_hint = (count($parseInfo['hints']) - 1);
$parseInfo['hints'][$cur_hint]['hint_type'] .= " " . $upper;
continue 2;
}
if ($parseInfo['subquery']) {
$parseInfo['sub_tree'] = $this->parse($this->removeParenthesisFromStart($parseInfo['subquery']));
$parseInfo['expression'] = $parseInfo['subquery'];
}
$expr[] = $this->processFromExpression($parseInfo);
$parseInfo = $this->initParseInfo($parseInfo);
break;
case 'GROUP BY':
if ($token_category === 'IDX_HINT') {
$cur_hint = (count($parseInfo['hints']) - 1);
$parseInfo['hints'][$cur_hint]['hint_type'] .= " " . $upper;
continue 2;
}
default:
// TODO: enhance it, so we can have base_expr to calculate the position of the keywords
// build a subtree under "hints"
if ($token_category === 'IDX_HINT') {
$token_category = '';
$cur_hint = (count($parseInfo['hints']) - 1);
$parseInfo['hints'][$cur_hint]['hint_list'] = $token;
break;
}
if ($parseInfo['token_count'] === 0) {
if ($parseInfo['table'] === "") {
$parseInfo['table'] = $token;
$parseInfo['no_quotes'] = $this->revokeQuotation($token);
}
} else if ($parseInfo['token_count'] === 1) {
$parseInfo['alias'] = array('as' => false, 'name' => trim($token),
'no_quotes' => $this->revokeQuotation($token),
'base_expr' => trim($token));
}
$parseInfo['token_count']++;
break;
}
$i++;
}
$expr[] = $this->processFromExpression($parseInfo);
return $expr;
}
}
?>
PK \U1 \ vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ReferenceDefinitionProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
*
* This class processes the reference definition part of the CREATE TABLE statements.
*
* @author arothe
*/
class ReferenceDefinitionProcessor extends AbstractProcessor {
protected function buildReferenceDef($expr, $base_expr, $key) {
$expr['till'] = $key;
$expr['base_expr'] = $base_expr;
return $expr;
}
public function process($tokens) {
$expr = array('expr_type' => ExpressionType::REFERENCE, 'base_expr' => false, 'sub_tree' => array());
$base_expr = '';
foreach ($tokens as $key => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case ',':
# we stop on a single comma
# or at the end of the array $tokens
$expr = $this->buildReferenceDef($expr, trim(substr($base_expr, 0, -strlen($token))), $key - 1);
break 2;
case 'REFERENCES':
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$currCategory = $upper;
break;
case 'MATCH':
if ($currCategory === 'REF_COL_LIST') {
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$currCategory = 'REF_MATCH';
continue 2;
}
# else?
break;
case 'FULL':
case 'PARTIAL':
case 'SIMPLE':
if ($currCategory === 'REF_MATCH') {
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr['match'] = $upper;
$currCategory = 'REF_COL_LIST';
continue 2;
}
# else?
break;
case 'ON':
if ($currCategory === 'REF_COL_LIST') {
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$currCategory = 'REF_ACTION';
continue 2;
}
# else ?
break;
case 'UPDATE':
case 'DELETE':
if ($currCategory === 'REF_ACTION') {
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$currCategory = 'REF_OPTION_' . $upper;
continue 2;
}
# else ?
break;
case 'RESTRICT':
case 'CASCADE':
if (strpos($currCategory, 'REF_OPTION_') === 0) {
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr['on_' . strtolower(substr($currCategory, -6))] = $upper;
continue 2;
}
# else ?
break;
case 'SET':
case 'NO':
if (strpos($currCategory, 'REF_OPTION_') === 0) {
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr['on_' . strtolower(substr($currCategory, -6))] = $upper;
$currCategory = 'SEC_' . $currCategory;
continue 2;
}
# else ?
break;
case 'NULL':
case 'ACTION':
if (strpos($currCategory, 'SEC_REF_OPTION_') === 0) {
$expr['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr['on_' . strtolower(substr($currCategory, -6))] .= ' ' . $upper;
$currCategory = 'REF_COL_LIST';
continue 2;
}
# else ?
break;
default:
switch ($currCategory) {
case 'REFERENCES':
if ($upper[0] === '(' && substr($upper, -1) === ')') {
# index_col_name list
$processor = new IndexColumnListProcessor($this->options);
$cols = $processor->process($this->removeParenthesisFromStart($trim));
$expr['sub_tree'][] = array('expr_type' => ExpressionType::COLUMN_LIST, 'base_expr' => $trim,
'sub_tree' => $cols);
$currCategory = 'REF_COL_LIST';
continue 3;
}
# foreign key reference table name
$expr['sub_tree'][] = array('expr_type' => ExpressionType::TABLE, 'table' => $trim,
'base_expr' => $trim, 'no_quotes' => $this->revokeQuotation($trim));
continue 3;
default:
# else ?
break;
}
break;
}
}
if (!isset($expr['till'])) {
$expr = $this->buildReferenceDef($expr, trim($base_expr), -1);
}
return $expr;
}
}
?>PK \̯H H Y vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ColumnDefinitionProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
*
* This class processes the column definition part of a CREATE TABLE statement.
*
* @author arothe
*
*/
class ColumnDefinitionProcessor extends AbstractProcessor {
protected function processExpressionList($parsed) {
$processor = new ExpressionListProcessor($this->options);
$expr = $this->removeParenthesisFromStart($parsed);
$expr = $this->splitSQLIntoTokens($expr);
$expr = $this->removeComma($expr);
return $processor->process($expr);
}
protected function processReferenceDefinition($parsed) {
$processor = new ReferenceDefinitionProcessor($this->options);
return $processor->process($parsed);
}
protected function removeComma($tokens) {
$res = array();
foreach ($tokens as $token) {
if (trim($token) !== ',') {
$res[] = $token;
}
}
return $res;
}
protected function buildColDef($expr, $base_expr, $options, $refs, $key) {
$expr = array('expr_type' => ExpressionType::COLUMN_TYPE, 'base_expr' => $base_expr, 'sub_tree' => $expr);
// add options first
$expr['sub_tree'] = array_merge($expr['sub_tree'], $options['sub_tree']);
unset($options['sub_tree']);
$expr = array_merge($expr, $options);
// followed by references
if (sizeof($refs) !== 0) {
$expr['sub_tree'] = array_merge($expr['sub_tree'], $refs);
}
$expr['till'] = $key;
return $expr;
}
protected function peekAtNextToken($tokens, $index)
{
$offset = $index + 1;
while (isset($tokens[$offset])) {
$token = trim($tokens[$offset]);
if ($token !== '') {
return strtoupper($token);
}
$offset++;
}
return '';
}
public function process($tokens) {
$trim = '';
$base_expr = '';
$currCategory = '';
$expr = array();
$refs = array();
$options = array('unique' => false, 'nullable' => true, 'auto_inc' => false, 'primary' => false,
'sub_tree' => array());
$skip = 0;
foreach ($tokens as $key => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($skip > 0) {
$skip--;
continue;
}
if ($skip < 0) {
break;
}
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case ',':
// we stop on a single comma and return
// the $expr entry and the index $key
$expr = $this->buildColDef($expr, trim(substr($base_expr, 0, -strlen($token))), $options, $refs,
$key - 1);
break 2;
case 'VARCHAR':
case 'VARCHARACTER': // Alias for VARCHAR
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'length' => false);
$prevCategory = 'TEXT';
$currCategory = 'SINGLE_PARAM_PARENTHESIS';
continue 2;
case 'VARBINARY':
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'length' => false);
$prevCategory = $upper;
$currCategory = 'SINGLE_PARAM_PARENTHESIS';
continue 2;
case 'UNSIGNED':
foreach (array_reverse(array_keys($expr)) as $i) {
if (isset($expr[$i]['expr_type']) && (ExpressionType::DATA_TYPE === $expr[$i]['expr_type'])) {
$expr[$i]['unsigned'] = true;
break;
}
}
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
case 'ZEROFILL':
$last = array_pop($expr);
$last['zerofill'] = true;
$expr[] = $last;
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
case 'BIT':
case 'TINYBIT':
case 'TINYINT':
case 'SMALLINT':
case 'INT2': // Alias of SMALLINT
case 'MEDIUMINT':
case 'INT3': // Alias of MEDIUMINT
case 'MIDDLEINT': // Alias of MEDIUMINT
case 'INT':
case 'INTEGER':
case 'INT4': // Alias of INT
case 'BIGINT':
case 'INT8': // Alias of BIGINT
case 'BOOL':
case 'BOOLEAN':
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'unsigned' => false,
'zerofill' => false, 'length' => false);
$currCategory = 'SINGLE_PARAM_PARENTHESIS';
$prevCategory = $upper;
continue 2;
case 'BINARY':
if ($currCategory === 'TEXT') {
$last = array_pop($expr);
$last['binary'] = true;
$last['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr[] = $last;
continue 2;
}
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'length' => false);
$currCategory = 'SINGLE_PARAM_PARENTHESIS';
$prevCategory = $upper;
continue 2;
case 'CHAR':
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'length' => false);
$currCategory = 'SINGLE_PARAM_PARENTHESIS';
$prevCategory = 'TEXT';
continue 2;
case 'REAL':
case 'DOUBLE':
case 'FLOAT8': // Alias for DOUBLE
case 'FLOAT':
case 'FLOAT4': // Alias for FLOAT
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'unsigned' => false,
'zerofill' => false);
$currCategory = 'TWO_PARAM_PARENTHESIS';
$prevCategory = $upper;
continue 2;
case 'DECIMAL':
case 'NUMERIC':
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'unsigned' => false,
'zerofill' => false);
$currCategory = 'TWO_PARAM_PARENTHESIS';
$prevCategory = $upper;
continue 2;
case 'YEAR':
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'length' => false);
$currCategory = 'SINGLE_PARAM_PARENTHESIS';
$prevCategory = $upper;
continue 2;
case 'DATE':
case 'TIME':
case 'TIMESTAMP':
case 'DATETIME':
case 'TINYBLOB':
case 'BLOB':
case 'MEDIUMBLOB':
case 'LONGBLOB':
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim);
$prevCategory = $currCategory = $upper;
continue 2;
// the next token can be BINARY
case 'TINYTEXT':
case 'TEXT':
case 'MEDIUMTEXT':
case 'LONGTEXT':
$prevCategory = $currCategory = 'TEXT';
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'binary' => false);
continue 2;
case 'ENUM':
$currCategory = 'MULTIPLE_PARAM_PARENTHESIS';
$prevCategory = 'TEXT';
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim, 'sub_tree' => false);
continue 2;
case 'GEOMETRY':
case 'POINT':
case 'LINESTRING':
case 'POLYGON':
case 'MULTIPOINT':
case 'MULTILINESTRING':
case 'MULTIPOLYGON':
case 'GEOMETRYCOLLECTION':
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim);
$prevCategory = $currCategory = $upper;
// TODO: is it right?
// spatial types
continue 2;
case 'CHARSET':
$currCategory = 'CHARSET';
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
case 'CHARACTER':
// Alias of CHAR as well as pre-running for CHARACTER SET
// To determine which we peek at the next token to see if it's a SET or not.
if ($this->peekAtNextToken($tokens, $key) == 'SET') {
$currCategory = 'CHARSET';
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
// If it's not a SET we assume that it is a CHARACTER type definition
} else {
$expr[] = array('expr_type' => ExpressionType::DATA_TYPE, 'base_expr' => $trim, 'length' => false);
$currCategory = 'SINGLE_PARAM_PARENTHESIS';
$prevCategory = 'TEXT';
}
continue 2;
case 'SET':
if ($currCategory == 'CHARSET') {
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
} else {
$currCategory = 'MULTIPLE_PARAM_PARENTHESIS';
$prevCategory = 'TEXT';
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim, 'sub_tree' => false);
}
continue 2;
case 'COLLATE':
$currCategory = $upper;
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
case 'NOT':
case 'NULL':
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
if ($options['nullable']) {
$options['nullable'] = ($upper === 'NOT' ? false : true);
}
continue 2;
case 'DEFAULT':
case 'COMMENT':
$currCategory = $upper;
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
case 'AUTO_INCREMENT':
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$options['auto_inc'] = true;
continue 2;
case 'COLUMN_FORMAT':
case 'STORAGE':
$currCategory = $upper;
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
case 'UNIQUE':
// it can follow a KEY word
$currCategory = $upper;
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$options['unique'] = true;
continue 2;
case 'PRIMARY':
// it must follow a KEY word
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
case 'KEY':
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
if ($currCategory !== 'UNIQUE') {
$options['primary'] = true;
}
continue 2;
case 'REFERENCES':
$refs = $this->processReferenceDefinition(array_splice($tokens, $key - 1, null, true));
$skip = $refs['till'] - $key;
unset($refs['till']);
// TODO: check this, we need the last comma
continue 2;
default:
switch ($currCategory) {
case 'STORAGE':
if ($upper === 'DISK' || $upper === 'MEMORY' || $upper === 'DEFAULT') {
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$options['storage'] = $trim;
continue 3;
}
// else ?
break;
case 'COLUMN_FORMAT':
if ($upper === 'FIXED' || $upper === 'DYNAMIC' || $upper === 'DEFAULT') {
$options['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$options['col_format'] = $trim;
continue 3;
}
// else ?
break;
case 'COMMENT':
// this is the comment string
$options['sub_tree'][] = array('expr_type' => ExpressionType::COMMENT, 'base_expr' => $trim);
$options['comment'] = $trim;
$currCategory = $prevCategory;
break;
case 'DEFAULT':
// this is the default value
$options['sub_tree'][] = array('expr_type' => ExpressionType::DEF_VALUE, 'base_expr' => $trim);
$options['default'] = $trim;
$currCategory = $prevCategory;
break;
case 'COLLATE':
// this is the collation name
$options['sub_tree'][] = array('expr_type' => ExpressionType::COLLATE, 'base_expr' => $trim);
$options['collate'] = $trim;
$currCategory = $prevCategory;
break;
case 'CHARSET':
// this is the character set name
$options['sub_tree'][] = array('expr_type' => ExpressionType::CHARSET, 'base_expr' => $trim);
$options['charset'] = $trim;
$currCategory = $prevCategory;
break;
case 'SINGLE_PARAM_PARENTHESIS':
$parsed = $this->removeParenthesisFromStart($trim);
$parsed = array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => trim($parsed));
$last = array_pop($expr);
$last['length'] = $parsed['base_expr'];
$expr[] = $last;
$expr[] = array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $trim,
'sub_tree' => array($parsed));
$currCategory = $prevCategory;
break;
case 'TWO_PARAM_PARENTHESIS':
// maximum of two parameters
$parsed = $this->processExpressionList($trim);
$last = array_pop($expr);
$last['length'] = $parsed[0]['base_expr'];
$last['decimals'] = isset($parsed[1]) ? $parsed[1]['base_expr'] : false;
$expr[] = $last;
$expr[] = array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $trim,
'sub_tree' => $parsed);
$currCategory = $prevCategory;
break;
case 'MULTIPLE_PARAM_PARENTHESIS':
// some parameters
$parsed = $this->processExpressionList($trim);
$last = array_pop($expr);
$subTree = array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $trim,
'sub_tree' => $parsed);
if ($this->options->getConsistentSubtrees()) {
$subTree = array($subTree);
}
$last['sub_tree'] = $subTree;
$expr[] = $last;
$currCategory = $prevCategory;
break;
default:
break;
}
}
$prevCategory = $currCategory;
$currCategory = '';
}
if (!isset($expr['till'])) {
// end of $tokens array
$expr = $this->buildColDef($expr, trim($base_expr), $options, $refs, -1);
}
return $expr;
}
}
?>
PK \CO- - N vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/IndexProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the INDEX statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class IndexProcessor extends AbstractProcessor {
protected function getReservedType($token) {
return array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $token);
}
protected function getConstantType($token) {
return array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $token);
}
protected function getOperatorType($token) {
return array('expr_type' => ExpressionType::OPERATOR, 'base_expr' => $token);
}
protected function processIndexColumnList($parsed) {
$processor = new IndexColumnListProcessor($this->options);
return $processor->process($parsed);
}
public function process($tokens) {
$currCategory = 'INDEX_NAME';
$result = array('base_expr' => false, 'name' => false, 'no_quotes' => false, 'index-type' => false, 'on' => false,
'options' => array());
$expr = array();
$base_expr = '';
$skip = 0;
foreach ($tokens as $tokenKey => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($skip > 0) {
$skip--;
continue;
}
if ($skip < 0) {
break;
}
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'USING':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'TYPE_OPTION';
continue 2;
}
if ($prevCategory === 'TYPE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'INDEX_TYPE';
continue 2;
}
// else ?
break;
case 'KEY_BLOCK_SIZE':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'INDEX_OPTION';
continue 2;
}
// else ?
break;
case 'WITH':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'INDEX_PARSER';
continue 2;
}
// else ?
break;
case 'PARSER':
if ($currCategory === 'INDEX_PARSER') {
$expr[] = $this->getReservedType($trim);
continue 2;
}
// else ?
break;
case 'COMMENT':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'INDEX_COMMENT';
continue 2;
}
// else ?
break;
case 'ALGORITHM':
case 'LOCK':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = $upper . '_OPTION';
continue 2;
}
// else ?
break;
case '=':
// the optional operator
if (substr($currCategory, -7, 7) === '_OPTION') {
$expr[] = $this->getOperatorType($trim);
continue 2; // don't change the category
}
// else ?
break;
case 'ON':
if ($prevCategory === 'CREATE_DEF' || $prevCategory === 'TYPE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'TABLE_DEF';
continue 2;
}
// else ?
break;
default:
switch ($currCategory) {
case 'COLUMN_DEF':
if ($upper[0] === '(' && substr($upper, -1) === ')') {
$cols = $this->processIndexColumnList($this->removeParenthesisFromStart($trim));
$result['on']['base_expr'] .= $base_expr;
$result['on']['sub_tree'] = array('expr_type' => ExpressionType::COLUMN_LIST,
'base_expr' => $trim, 'sub_tree' => $cols);
}
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
break;
case 'TABLE_DEF':
// the table name
$expr[] = $this->getConstantType($trim);
// TODO: the base_expr should contain the column-def too
$result['on'] = array('expr_type' => ExpressionType::TABLE, 'base_expr' => $base_expr,
'name' => $trim, 'no_quotes' => $this->revokeQuotation($trim),
'sub_tree' => false);
$expr = array();
$base_expr = '';
$currCategory = 'COLUMN_DEF';
continue 3;
case 'INDEX_NAME':
$result['base_expr'] = $result['name'] = $trim;
$result['no_quotes'] = $this->revokeQuotation($trim);
$expr = array();
$base_expr = '';
$currCategory = 'TYPE_DEF';
break;
case 'INDEX_PARSER':
// the parser name
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::INDEX_PARSER,
'base_expr' => trim($base_expr), 'sub_tree' => $expr);
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
break;
case 'INDEX_COMMENT':
// the index comment
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::COMMENT,
'base_expr' => trim($base_expr), 'sub_tree' => $expr);
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
break;
case 'INDEX_OPTION':
// the key_block_size
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::INDEX_SIZE,
'base_expr' => trim($base_expr), 'size' => $upper,
'sub_tree' => $expr);
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
break;
case 'INDEX_TYPE':
case 'TYPE_OPTION':
// BTREE or HASH
$expr[] = $this->getReservedType($trim);
if ($currCategory === 'INDEX_TYPE') {
$result['index-type'] = array('expr_type' => ExpressionType::INDEX_TYPE,
'base_expr' => trim($base_expr), 'using' => $upper,
'sub_tree' => $expr);
} else {
$result['options'][] = array('expr_type' => ExpressionType::INDEX_TYPE,
'base_expr' => trim($base_expr), 'using' => $upper,
'sub_tree' => $expr);
}
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
break;
case 'LOCK_OPTION':
// DEFAULT|NONE|SHARED|EXCLUSIVE
$expr[] = $this->getReservedType($trim);
$result['options'][] = array('expr_type' => ExpressionType::INDEX_LOCK,
'base_expr' => trim($base_expr), 'lock' => $upper,
'sub_tree' => $expr);
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
break;
case 'ALGORITHM_OPTION':
// DEFAULT|INPLACE|COPY
$expr[] = $this->getReservedType($trim);
$result['options'][] = array('expr_type' => ExpressionType::INDEX_ALGORITHM,
'base_expr' => trim($base_expr), 'algorithm' => $upper,
'sub_tree' => $expr);
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
break;
default:
break;
}
break;
}
$prevCategory = $currCategory;
$currCategory = '';
}
if ($result['options'] === array()) {
$result['options'] = false;
}
return $result;
}
}
?>
PK \6 O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/RenameProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
use PHPSQLParser\utils\ExpressionToken;
/**
* This class processes the RENAME statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class RenameProcessor extends AbstractProcessor {
public function process($tokenList) {
$base_expr = "";
$resultList = array();
$tablePair = array();
foreach ($tokenList as $k => $v) {
$token = new ExpressionToken($k, $v);
if ($token->isWhitespaceToken()) {
continue;
}
switch ($token->getUpper()) {
case 'TO':
// separate source table from destination
$tablePair['source'] = array('expr_type' => ExpressionType::TABLE, 'table' => trim($base_expr),
'no_quotes' => $this->revokeQuotation($base_expr),
'base_expr' => $base_expr);
$base_expr = "";
break;
case ',':
// split rename operations
$tablePair['destination'] = array('expr_type' => ExpressionType::TABLE, 'table' => trim($base_expr),
'no_quotes' => $this->revokeQuotation($base_expr),
'base_expr' => $base_expr);
$resultList[] = $tablePair;
$tablePair = array();
$base_expr = "";
break;
case 'TABLE':
$objectType = ExpressionType::TABLE;
$resultList[] = array('expr_type'=>ExpressionType::RESERVED, 'base_expr'=>$token->getTrim());
continue 2;
default:
$base_expr .= $token->getToken();
break;
}
}
if ($base_expr !== "") {
$tablePair['destination'] = array('expr_type' => ExpressionType::TABLE, 'table' => trim($base_expr),
'no_quotes' => $this->revokeQuotation($base_expr),
'base_expr' => $base_expr);
$resultList[] = $tablePair;
}
return array('expr_type' => $objectType, 'sub_tree'=>$resultList);
}
}
?>PK \EI/ / P vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/BracketProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the parentheses around the statement.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class BracketProcessor extends AbstractProcessor {
protected function processTopLevel($sql) {
$processor = new DefaultProcessor($this->options);
return $processor->process($sql);
}
public function process($tokens) {
$token = $this->removeParenthesisFromStart($tokens[0]);
$subtree = $this->processTopLevel($token);
$remainingExpressions = $this->getRemainingNotBracketExpression($subtree);
if (isset($subtree['BRACKET'])) {
$subtree = $subtree['BRACKET'];
}
if (isset($subtree['SELECT'])) {
$subtree = array(
array('expr_type' => ExpressionType::QUERY, 'base_expr' => $token, 'sub_tree' => $subtree));
}
return array(
array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => trim($tokens[0]),
'sub_tree' => $subtree, 'remaining_expressions' => $remainingExpressions));
}
private function getRemainingNotBracketExpression($subtree)
{
// https://github.com/greenlion/PHP-SQL-Parser/issues/279
// https://github.com/sinri/PHP-SQL-Parser/commit/eac592a0e19f1df6f420af3777a6d5504837faa7
// as there is no pull request for 279 by the user. His solution works and tested.
if (empty($subtree)) $subtree = array();// as a fix by Sinri 20180528
$remainingExpressions = array();
$ignoredKeys = array('BRACKET', 'SELECT', 'FROM');
$subtreeKeys = array_keys($subtree);
foreach($subtreeKeys as $key) {
if(!in_array($key, $ignoredKeys)) {
$remainingExpressions[$key] = $subtree[$key];
}
}
return $remainingExpressions;
}
}
?>
PK \hI I W vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ExpressionListProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
use PHPSQLParser\utils\ExpressionToken;
use PHPSQLParser\utils\PHPSQLParserConstants;
/**
* This class processes expression lists.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ExpressionListProcessor extends AbstractProcessor {
public function process($tokens) {
$resultList = array();
$skip_next = false;
$prev = new ExpressionToken();
foreach ($tokens as $k => $v) {
if ($this->isCommentToken($v)) {
$resultList[] = parent::processComment($v);
continue;
}
$curr = new ExpressionToken($k, $v);
if ($curr->isWhitespaceToken()) {
continue;
}
if ($skip_next) {
// skip the next non-whitespace token
$skip_next = false;
continue;
}
/* is it a subquery? */
if ($curr->isSubQueryToken()) {
$processor = new DefaultProcessor($this->options);
$curr->setSubTree($processor->process($this->removeParenthesisFromStart($curr->getTrim())));
$curr->setTokenType(ExpressionType::SUBQUERY);
} elseif ($curr->isEnclosedWithinParenthesis()) {
/* is it an in-list? */
$localTokenList = $this->splitSQLIntoTokens($this->removeParenthesisFromStart($curr->getTrim()));
if ($prev->getUpper() === 'IN') {
foreach ($localTokenList as $k => $v) {
$tmpToken = new ExpressionToken($k, $v);
if ($tmpToken->isCommaToken()) {
unset($localTokenList[$k]);
}
}
$localTokenList = array_values($localTokenList);
$curr->setSubTree($this->process($localTokenList));
$curr->setTokenType(ExpressionType::IN_LIST);
} elseif ($prev->getUpper() === 'AGAINST') {
$match_mode = false;
foreach ($localTokenList as $k => $v) {
$tmpToken = new ExpressionToken($k, $v);
switch ($tmpToken->getUpper()) {
case 'WITH':
$match_mode = 'WITH QUERY EXPANSION';
break;
case 'IN':
$match_mode = 'IN BOOLEAN MODE';
break;
default:
}
if ($match_mode !== false) {
unset($localTokenList[$k]);
}
}
$tmpToken = $this->process($localTokenList);
if ($match_mode !== false) {
$match_mode = new ExpressionToken(0, $match_mode);
$match_mode->setTokenType(ExpressionType::MATCH_MODE);
$tmpToken[] = $match_mode->toArray();
}
$curr->setSubTree($tmpToken);
$curr->setTokenType(ExpressionType::MATCH_ARGUMENTS);
$prev->setTokenType(ExpressionType::SIMPLE_FUNCTION);
} elseif ($prev->isColumnReference() || $prev->isFunction() || $prev->isAggregateFunction()
|| $prev->isCustomFunction()) {
// if we have a colref followed by a parenthesis pair,
// it isn't a colref, it is a user-function
// TODO: this should be a method, because we need the same code
// below for unspecified tokens (expressions).
$localExpr = new ExpressionToken();
$tmpExprList = array();
foreach ($localTokenList as $k => $v) {
$tmpToken = new ExpressionToken($k, $v);
if (!$tmpToken->isCommaToken()) {
$localExpr->addToken($v);
$tmpExprList[] = $v;
} else {
// an expression could have multiple parts split by operands
// if we have a comma, it is a split-point for expressions
$tmpExprList = array_values($tmpExprList);
$localExprList = $this->process($tmpExprList);
if (count($localExprList) > 1) {
$localExpr->setSubTree($localExprList);
$localExpr->setTokenType(ExpressionType::EXPRESSION);
$localExprList = $localExpr->toArray();
$localExprList['alias'] = false;
$localExprList = array($localExprList);
}
if (!$curr->getSubTree()) {
if (!empty($localExprList)) {
$curr->setSubTree($localExprList);
}
} else {
$tmpExprList = $curr->getSubTree();
$curr->setSubTree(array_merge($tmpExprList, $localExprList));
}
$tmpExprList = array();
$localExpr = new ExpressionToken();
}
}
$tmpExprList = array_values($tmpExprList);
$localExprList = $this->process($tmpExprList);
if (count($localExprList) > 1) {
$localExpr->setSubTree($localExprList);
$localExpr->setTokenType(ExpressionType::EXPRESSION);
$localExprList = $localExpr->toArray();
$localExprList['alias'] = false;
$localExprList = array($localExprList);
}
if (!$curr->getSubTree()) {
if (!empty($localExprList)) {
$curr->setSubTree($localExprList);
}
} else {
$tmpExprList = $curr->getSubTree();
$curr->setSubTree(array_merge($tmpExprList, $localExprList));
}
$prev->setSubTree($curr->getSubTree());
if ($prev->isColumnReference()) {
if (PHPSQLParserConstants::getInstance()->isCustomFunction($prev->getUpper())) {
$prev->setTokenType(ExpressionType::CUSTOM_FUNCTION);
} else {
$prev->setTokenType(ExpressionType::SIMPLE_FUNCTION);
}
$prev->setNoQuotes(null, null, $this->options);
}
array_pop($resultList);
$curr = $prev;
}
// we have parenthesis, but it seems to be an expression
if ($curr->isUnspecified()) {
$tmpExprList = array_values($localTokenList);
$localExprList = $this->process($tmpExprList);
$curr->setTokenType(ExpressionType::BRACKET_EXPRESSION);
if (!$curr->getSubTree()) {
if (!empty($localExprList)) {
$curr->setSubTree($localExprList);
}
} else {
$tmpExprList = $curr->getSubTree();
$curr->setSubTree(array_merge($tmpExprList, $localExprList));
}
}
} elseif ($curr->isVariableToken()) {
# a variable
# it can be quoted
$curr->setTokenType($this->getVariableType($curr->getUpper()));
$curr->setSubTree(false);
$curr->setNoQuotes(trim(trim($curr->getToken()), '@'), "`'\"", $this->options);
} else {
/* it is either an operator, a colref or a constant */
switch ($curr->getUpper()) {
case '*':
$curr->setSubTree(false); // o subtree
// single or first element of expression list -> all-column-alias
if (empty($resultList)) {
$curr->setTokenType(ExpressionType::COLREF);
break;
}
// if the last token is colref, const or expression
// then * is an operator
// but if the previous colref ends with a dot, the * is the all-columns-alias
if (
!$prev->isColumnReference()
&& !$prev->isConstant()
&& !$prev->isExpression()
&& !$prev->isBracketExpression()
&& !$prev->isAggregateFunction()
&& !$prev->isVariable()
&& !$prev->isFunction()
) {
$curr->setTokenType(ExpressionType::COLREF);
break;
}
if ($prev->isColumnReference() && $prev->endsWith(".")) {
$prev->addToken('*'); // tablealias dot *
continue 2; // skip the current token
}
$curr->setTokenType(ExpressionType::OPERATOR);
break;
case ':=':
case 'AND':
case '&&':
case 'BETWEEN':
case 'BINARY':
case '&':
case '~':
case '|':
case '^':
case 'DIV':
case '/':
case '<=>':
case '=':
case '>=':
case '>':
case 'IS':
case 'NOT':
case '<<':
case '<=':
case '<':
case 'LIKE':
case '%':
case '!=':
case '<>':
case 'REGEXP':
case '!':
case '||':
case 'OR':
case '>>':
case 'RLIKE':
case 'SOUNDS':
case 'XOR':
case 'IN':
$curr->setSubTree(false);
$curr->setTokenType(ExpressionType::OPERATOR);
break;
case 'NULL':
$curr->setSubTree(false);
$curr->setTokenType(ExpressionType::CONSTANT);
break;
case '-':
case '+':
// differ between preceding sign and operator
$curr->setSubTree(false);
if ($prev->isColumnReference() || $prev->isFunction() || $prev->isAggregateFunction()
|| $prev->isConstant() || $prev->isSubQuery() || $prev->isExpression()
|| $prev->isBracketExpression() || $prev->isVariable() || $prev->isCustomFunction()) {
$curr->setTokenType(ExpressionType::OPERATOR);
} else {
$curr->setTokenType(ExpressionType::SIGN);
}
break;
default:
$curr->setSubTree(false);
switch ($curr->getToken(0)) {
case "'":
// it is a string literal
$curr->setTokenType(ExpressionType::CONSTANT);
break;
case '"':
if (!$this->options->getANSIQuotes()) {
// If we're not using ANSI quotes, this is a string literal.
$curr->setTokenType(ExpressionType::CONSTANT);
break;
}
// Otherwise continue to the next case
case '`':
// it is an escaped colum name
$curr->setTokenType(ExpressionType::COLREF);
$curr->setNoQuotes($curr->getToken(), null, $this->options);
break;
default:
if (is_numeric($curr->getToken())) {
if ($prev->isSign()) {
$prev->addToken($curr->getToken()); // it is a negative numeric constant
$prev->setTokenType(ExpressionType::CONSTANT);
continue 3;
// skip current token
} else {
$curr->setTokenType(ExpressionType::CONSTANT);
}
} else {
$curr->setTokenType(ExpressionType::COLREF);
$curr->setNoQuotes($curr->getToken(), null, $this->options);
}
break;
}
}
}
/* is a reserved word? */
if (!$curr->isOperator() && !$curr->isInList() && !$curr->isFunction() && !$curr->isAggregateFunction()
&& !$curr->isCustomFunction() && PHPSQLParserConstants::getInstance()->isReserved($curr->getUpper())) {
$next = isset( $tokens[ $k + 1 ] ) ? new ExpressionToken( $k + 1, $tokens[ $k + 1 ] ) : new ExpressionToken();
$isEnclosedWithinParenthesis = $next->isEnclosedWithinParenthesis();
if ($isEnclosedWithinParenthesis && PHPSQLParserConstants::getInstance()->isCustomFunction($curr->getUpper())) {
$curr->setTokenType(ExpressionType::CUSTOM_FUNCTION);
$curr->setNoQuotes(null, null, $this->options);
} elseif ($isEnclosedWithinParenthesis && PHPSQLParserConstants::getInstance()->isAggregateFunction($curr->getUpper())) {
$curr->setTokenType(ExpressionType::AGGREGATE_FUNCTION);
$curr->setNoQuotes(null, null, $this->options);
} elseif ($curr->getUpper() === 'NULL') {
// it is a reserved word, but we would like to set it as constant
$curr->setTokenType(ExpressionType::CONSTANT);
} else {
if ($isEnclosedWithinParenthesis && PHPSQLParserConstants::getInstance()->isParameterizedFunction($curr->getUpper())) {
// issue 60: check functions with parameters
// -> colref (we check parameters later)
// -> if there is no parameter, we leave the colref
$curr->setTokenType(ExpressionType::COLREF);
} elseif ($isEnclosedWithinParenthesis && PHPSQLParserConstants::getInstance()->isFunction($curr->getUpper())) {
$curr->setTokenType(ExpressionType::SIMPLE_FUNCTION);
$curr->setNoQuotes(null, null, $this->options);
} elseif (!$isEnclosedWithinParenthesis && PHPSQLParserConstants::getInstance()->isFunction($curr->getUpper())) {
// Colname using function name.
$curr->setTokenType(ExpressionType::COLREF);
} else {
$curr->setTokenType(ExpressionType::RESERVED);
$curr->setNoQuotes(null, null, $this->options);
}
}
}
// issue 94, INTERVAL 1 MONTH
if ($curr->isConstant() && PHPSQLParserConstants::getInstance()->isParameterizedFunction($prev->getUpper())) {
$prev->setTokenType(ExpressionType::RESERVED);
$prev->setNoQuotes(null, null, $this->options);
}
if ($prev->isConstant() && PHPSQLParserConstants::getInstance()->isParameterizedFunction($curr->getUpper())) {
$curr->setTokenType(ExpressionType::RESERVED);
$curr->setNoQuotes(null, null, $this->options);
}
if ($curr->isUnspecified()) {
$curr->setTokenType(ExpressionType::EXPRESSION);
$curr->setNoQuotes(null, null, $this->options);
$curr->setSubTree($this->process($this->splitSQLIntoTokens($curr->getTrim())));
}
$resultList[] = $curr;
$prev = $curr;
} // end of for-loop
return $this->toArray($resultList);
}
}
?>
PK \8][O O N vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/WhereProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the WHERE statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class WhereProcessor extends ExpressionListProcessor {
}
?>
PK \J] O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ValuesProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the VALUES statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ValuesProcessor extends AbstractProcessor {
protected function processExpressionList($unparsed) {
$processor = new ExpressionListProcessor($this->options);
return $processor->process($unparsed);
}
protected function processRecord($unparsed) {
$processor = new RecordProcessor($this->options);
return $processor->process($unparsed);
}
public function process($tokens) {
$currCategory = '';
$parsed = array();
$base_expr = '';
foreach ($tokens['VALUES'] as $k => $v) {
if ($this->isCommentToken($v)) {
$parsed[] = parent::processComment($v);
continue;
}
$base_expr .= $v;
$trim = trim($v);
if ($this->isWhitespaceToken($v)) {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'ON':
if ($currCategory === '') {
$base_expr = trim(substr($base_expr, 0, -strlen($v)));
$parsed[] = array('expr_type' => ExpressionType::RECORD, 'base_expr' => $base_expr,
'data' => $this->processRecord($base_expr), 'delim' => false);
$base_expr = '';
$currCategory = 'DUPLICATE';
$parsed[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
}
// else ?
break;
case 'DUPLICATE':
case 'KEY':
case 'UPDATE':
if ($currCategory === 'DUPLICATE') {
$parsed[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$base_expr = '';
}
// else ?
break;
case ',':
if ($currCategory === 'DUPLICATE') {
$base_expr = trim(substr($base_expr, 0, -strlen($v)));
$res = $this->processExpressionList($this->splitSQLIntoTokens($base_expr));
$parsed[] = array('expr_type' => ExpressionType::EXPRESSION, 'base_expr' => $base_expr,
'sub_tree' => (empty($res) ? false : $res), 'delim' => $trim);
$base_expr = '';
continue 2;
}
$parsed[] = array('expr_type' => ExpressionType::RECORD, 'base_expr' => trim($base_expr),
'data' => $this->processRecord(trim($base_expr)), 'delim' => $trim);
$base_expr = '';
break;
default:
break;
}
}
if (trim($base_expr) !== '') {
if ($currCategory === '') {
$parsed[] = array('expr_type' => ExpressionType::RECORD, 'base_expr' => trim($base_expr),
'data' => $this->processRecord(trim($base_expr)), 'delim' => false);
}
if ($currCategory === 'DUPLICATE') {
$res = $this->processExpressionList($this->splitSQLIntoTokens($base_expr));
$parsed[] = array('expr_type' => ExpressionType::EXPRESSION, 'base_expr' => trim($base_expr),
'sub_tree' => (empty($res) ? false : $res), 'delim' => false);
}
}
$tokens['VALUES'] = $parsed;
return $tokens;
}
}
?>
PK \BPL Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/DescribeProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the DESCRIBE statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DescribeProcessor extends ExplainProcessor {
protected function isStatement($keys, $needle = "DESCRIBE") {
return parent::isStatement($keys, $needle);
}
}
?>
PK \`2 2 Y vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/SelectExpressionProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
*
* This class processes the SELECT expressions.
*
* @author arothe
*
*/
class SelectExpressionProcessor extends AbstractProcessor {
protected function processExpressionList($unparsed) {
$processor = new ExpressionListProcessor($this->options);
return $processor->process($unparsed);
}
/**
* This fuction processes each SELECT clause.
* We determine what (if any) alias
* is provided, and we set the type of expression.
*/
public function process($expression) {
$tokens = $this->splitSQLIntoTokens($expression);
$token_count = count($tokens);
if ($token_count === 0) {
return null;
}
/*
* Determine if there is an explicit alias after the AS clause.
* If AS is found, then the next non-whitespace token is captured as the alias.
* The tokens after (and including) the AS are removed.
*/
$base_expr = "";
$stripped = array();
$capture = false;
$alias = false;
$processed = false;
for ($i = 0; $i < $token_count; ++$i) {
$token = $tokens[$i];
$upper = strtoupper($token);
if ($upper === 'AS') {
$alias = array('as' => true, "name" => "", "base_expr" => $token);
$tokens[$i] = "";
$capture = true;
continue;
}
if (!$this->isWhitespaceToken($upper)) {
$stripped[] = $token;
}
// we have an explicit AS, next one can be the alias
// but also a comment!
if ($capture) {
if (!$this->isWhitespaceToken($upper) && !$this->isCommentToken($upper)) {
$alias['name'] .= $token;
array_pop($stripped);
}
$alias['base_expr'] .= $token;
$tokens[$i] = "";
continue;
}
$base_expr .= $token;
}
if ($alias) {
// remove quotation from the alias
$alias['no_quotes'] = $this->revokeQuotation($alias['name']);
$alias['name'] = trim($alias['name']);
$alias['base_expr'] = trim($alias['base_expr']);
}
$stripped = $this->processExpressionList($stripped);
// TODO: the last part can also be a comment, don't use array_pop
// we remove the last token, if it is a colref,
// it can be an alias without an AS
$last = array_pop($stripped);
if (!$alias && $this->isColumnReference($last)) {
// TODO: it can be a comment, don't use array_pop
// check the token before the colref
$prev = array_pop($stripped);
if ($this->isReserved($prev) || $this->isConstant($prev) || $this->isAggregateFunction($prev)
|| $this->isFunction($prev) || $this->isExpression($prev) || $this->isSubQuery($prev)
|| $this->isColumnReference($prev) || $this->isBracketExpression($prev)|| $this->isCustomFunction($prev)) {
$alias = array('as' => false, 'name' => trim($last['base_expr']),
'no_quotes' => $this->revokeQuotation($last['base_expr']),
'base_expr' => trim($last['base_expr']));
// remove the last token
array_pop($tokens);
}
}
$base_expr = $expression;
// TODO: this is always done with $stripped, how we do it twice?
$processed = $this->processExpressionList($tokens);
// if there is only one part, we copy the expr_type
// in all other cases we use "EXPRESSION" as global type
$type = ExpressionType::EXPRESSION;
if (count($processed) === 1) {
if (!$this->isSubQuery($processed[0])) {
$type = $processed[0]['expr_type'];
$base_expr = $processed[0]['base_expr'];
$no_quotes = isset($processed[0]['no_quotes']) ? $processed[0]['no_quotes'] : null;
$processed = $processed[0]['sub_tree']; // it can be FALSE
}
}
$result = array();
$result['expr_type'] = $type;
$result['alias'] = $alias;
$result['base_expr'] = trim($base_expr);
if (!empty($no_quotes)) {
$result['no_quotes'] = $no_quotes;
}
$result['sub_tree'] = (empty($processed) ? false : $processed);
return $result;
}
}
?>
PK \VXv v Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/SQLChunkProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the SQL chunks.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SQLChunkProcessor extends AbstractProcessor {
protected function moveLIKE(&$out) {
if (!isset($out['TABLE']['like'])) {
return;
}
$out = $this->array_insert_after($out, 'TABLE', array('LIKE' => $out['TABLE']['like']));
unset($out['TABLE']['like']);
}
public function process($out) {
if (!$out) {
return false;
}
if (!empty($out['BRACKET'])) {
// TODO: this field should be a global STATEMENT field within the output
// we could add all other categories as sub_tree, it could also work with multipe UNIONs
$processor = new BracketProcessor($this->options);
$processedBracket = $processor->process($out['BRACKET']);
$remainingExpressions = $processedBracket[0]['remaining_expressions'];
unset($processedBracket[0]['remaining_expressions']);
if(!empty($remainingExpressions)) {
foreach($remainingExpressions as $key=>$expression) {
$processedBracket[][$key] = $expression;
}
}
$out['BRACKET'] = $processedBracket;
}
if (!empty($out['CREATE'])) {
$processor = new CreateProcessor($this->options);
$out['CREATE'] = $processor->process($out['CREATE']);
}
if (!empty($out['TABLE'])) {
$processor = new TableProcessor($this->options);
$out['TABLE'] = $processor->process($out['TABLE']);
$this->moveLIKE($out);
}
if (!empty($out['INDEX'])) {
$processor = new IndexProcessor($this->options);
$out['INDEX'] = $processor->process($out['INDEX']);
}
if (!empty($out['EXPLAIN'])) {
$processor = new ExplainProcessor($this->options);
$out['EXPLAIN'] = $processor->process($out['EXPLAIN'], array_keys($out));
}
if (!empty($out['DESCRIBE'])) {
$processor = new DescribeProcessor($this->options);
$out['DESCRIBE'] = $processor->process($out['DESCRIBE'], array_keys($out));
}
if (!empty($out['DESC'])) {
$processor = new DescProcessor($this->options);
$out['DESC'] = $processor->process($out['DESC'], array_keys($out));
}
if (!empty($out['SELECT'])) {
$processor = new SelectProcessor($this->options);
$out['SELECT'] = $processor->process($out['SELECT']);
}
if (!empty($out['FROM'])) {
$processor = new FromProcessor($this->options);
$out['FROM'] = $processor->process($out['FROM']);
}
if (!empty($out['USING'])) {
$processor = new UsingProcessor($this->options);
$out['USING'] = $processor->process($out['USING']);
}
if (!empty($out['UPDATE'])) {
$processor = new UpdateProcessor($this->options);
$out['UPDATE'] = $processor->process($out['UPDATE']);
}
if (!empty($out['GROUP'])) {
// set empty array if we have partial SQL statement
$processor = new GroupByProcessor($this->options);
$out['GROUP'] = $processor->process($out['GROUP'], isset($out['SELECT']) ? $out['SELECT'] : array());
}
if (!empty($out['ORDER'])) {
// set empty array if we have partial SQL statement
$processor = new OrderByProcessor($this->options);
$out['ORDER'] = $processor->process($out['ORDER'], isset($out['SELECT']) ? $out['SELECT'] : array());
}
if (!empty($out['LIMIT'])) {
$processor = new LimitProcessor($this->options);
$out['LIMIT'] = $processor->process($out['LIMIT']);
}
if (!empty($out['WHERE'])) {
$processor = new WhereProcessor($this->options);
$out['WHERE'] = $processor->process($out['WHERE']);
}
if (!empty($out['HAVING'])) {
$processor = new HavingProcessor($this->options);
$out['HAVING'] = $processor->process($out['HAVING'], isset($out['SELECT']) ? $out['SELECT'] : array());
}
if (!empty($out['SET'])) {
$processor = new SetProcessor($this->options);
$out['SET'] = $processor->process($out['SET'], isset($out['UPDATE']));
}
if (!empty($out['DUPLICATE'])) {
$processor = new DuplicateProcessor($this->options);
$out['ON DUPLICATE KEY UPDATE'] = $processor->process($out['DUPLICATE']);
unset($out['DUPLICATE']);
}
if (!empty($out['INSERT'])) {
$processor = new InsertProcessor($this->options);
$out = $processor->process($out);
}
if (!empty($out['REPLACE'])) {
$processor = new ReplaceProcessor($this->options);
$out = $processor->process($out);
}
if (!empty($out['DELETE'])) {
$processor = new DeleteProcessor($this->options);
$out = $processor->process($out);
}
if (!empty($out['VALUES'])) {
$processor = new ValuesProcessor($this->options);
$out = $processor->process($out);
}
if (!empty($out['INTO'])) {
$processor = new IntoProcessor($this->options);
$out = $processor->process($out);
}
if (!empty($out['DROP'])) {
$processor = new DropProcessor($this->options);
$out['DROP'] = $processor->process($out['DROP']);
}
if (!empty($out['RENAME'])) {
$processor = new RenameProcessor($this->options);
$out['RENAME'] = $processor->process($out['RENAME']);
}
if (!empty($out['SHOW'])) {
$processor = new ShowProcessor($this->options);
$out['SHOW'] = $processor->process($out['SHOW']);
}
if (!empty($out['OPTIONS'])) {
$processor = new OptionsProcessor($this->options);
$out['OPTIONS'] = $processor->process($out['OPTIONS']);
}
if (!empty($out['WITH'])) {
$processor = new WithProcessor($this->options);
$out['WITH'] = $processor->process($out['WITH']);
}
return $out;
}
}
?>
PK \AF F R vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/DuplicateProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
/**
*
* This class processes the DUPLICATE statements.
*
* @author arothe
*
*/
class DuplicateProcessor extends SetProcessor {
public function process($tokens, $isUpdate = false) {
return parent::process($tokens, $isUpdate);
}
}
?>
PK \( ( Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/AbstractProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\lexer\PHPSQLLexer;
use PHPSQLParser\Options;
use PHPSQLParser\utils\ExpressionType;
/**
* This class contains some general functions for a processor.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
abstract class AbstractProcessor {
/**
* @var Options
*/
protected $options;
/**
* AbstractProcessor constructor.
*
* @param Options $options
*/
public function __construct(?Options $options = null)
{
$this->options = $options;
}
/**
* This function implements the main functionality of a processor class.
* Always use default valuses for additional parameters within overridden functions.
*/
public abstract function process($tokens);
/**
* this function splits up a SQL statement into easy to "parse"
* tokens for the SQL processor
*/
public function splitSQLIntoTokens($sql) {
$lexer = new PHPSQLLexer();
return $lexer->split($sql);
}
/**
* Revokes the quoting characters from an expression
* Possibibilies:
* `a`
* 'a'
* "a"
* `a`.`b`
* `a.b`
* a.`b`
* `a`.b
* It is also possible to have escaped quoting characters
* within an expression part:
* `a``b` => a`b
* And you can use whitespace between the parts:
* a . `b` => [a,b]
*/
protected function revokeQuotation($sql) {
$tmp = trim($sql);
$result = array();
$quote = false;
$start = 0;
$i = 0;
$len = strlen($tmp);
while ($i < $len) {
$char = $tmp[$i];
switch ($char) {
case '`':
case '\'':
case '"':
if ($quote === false) {
// start
$quote = $char;
$start = $i + 1;
break;
}
if ($quote !== $char) {
break;
}
if (isset($tmp[$i + 1]) && ($quote === $tmp[$i + 1])) {
// escaped
$i++;
break;
}
// end
$char = substr($tmp, $start, $i - $start);
$result[] = str_replace($quote . $quote, $quote, $char);
$start = $i + 1;
$quote = false;
break;
case '.':
if ($quote === false) {
// we have found a separator
$char = trim(substr($tmp, $start, $i - $start));
if ($char !== '') {
$result[] = $char;
}
$start = $i + 1;
}
break;
default:
// ignore
break;
}
$i++;
}
if ($quote === false && ($start < $len)) {
$char = trim(substr($tmp, $start, $i - $start));
if ($char !== '') {
$result[] = $char;
}
}
return array('delim' => (count($result) === 1 ? false : '.'), 'parts' => $result);
}
/**
* This method removes parenthesis from start of the given string.
* It removes also the associated closing parenthesis.
*/
protected function removeParenthesisFromStart($token) {
$parenthesisRemoved = 0;
$trim = trim($token);
if ($trim !== '' && $trim[0] === '(') { // remove only one parenthesis pair now!
$parenthesisRemoved++;
$trim[0] = ' ';
$trim = trim($trim);
}
$parenthesis = $parenthesisRemoved;
$i = 0;
$string = 0;
// Whether a string was opened or not, and with which character it was open (' or ")
$stringOpened = '';
while ($i < strlen($trim)) {
if ($trim[$i] === "\\") {
$i += 2; // an escape character, the next character is irrelevant
continue;
}
if ($trim[$i] === "'") {
if ($stringOpened === '') {
$stringOpened = "'";
} elseif ($stringOpened === "'") {
$stringOpened = '';
}
}
if ($trim[$i] === '"') {
if ($stringOpened === '') {
$stringOpened = '"';
} elseif ($stringOpened === '"') {
$stringOpened = '';
}
}
if (($stringOpened === '') && ($trim[$i] === '(')) {
$parenthesis++;
}
if (($stringOpened === '') && ($trim[$i] === ')')) {
if ($parenthesis == $parenthesisRemoved) {
$trim[$i] = ' ';
$parenthesisRemoved--;
}
$parenthesis--;
}
$i++;
}
return trim($trim);
}
protected function getVariableType($expression) {
// $expression must contain only upper-case characters
if ($expression[1] !== '@') {
return ExpressionType::USER_VARIABLE;
}
$type = substr($expression, 2, strpos($expression, '.', 2));
switch ($type) {
case 'GLOBAL':
$type = ExpressionType::GLOBAL_VARIABLE;
break;
case 'LOCAL':
$type = ExpressionType::LOCAL_VARIABLE;
break;
case 'SESSION':
default:
$type = ExpressionType::SESSION_VARIABLE;
break;
}
return $type;
}
protected function isCommaToken($token) {
return (trim($token) === ',');
}
protected function isWhitespaceToken($token) {
return (trim($token) === '');
}
protected function isCommentToken($token) {
return isset($token[0]) && isset($token[1])
&& (($token[0] === '-' && $token[1] === '-') || ($token[0] === '/' && $token[1] === '*'));
}
protected function isColumnReference($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::COLREF);
}
protected function isReserved($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::RESERVED);
}
protected function isConstant($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::CONSTANT);
}
protected function isAggregateFunction($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::AGGREGATE_FUNCTION);
}
protected function isCustomFunction($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::CUSTOM_FUNCTION);
}
protected function isFunction($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::SIMPLE_FUNCTION);
}
protected function isExpression($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::EXPRESSION);
}
protected function isBracketExpression($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::BRACKET_EXPRESSION);
}
protected function isSubQuery($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::SUBQUERY);
}
protected function isComment($out) {
return (isset($out['expr_type']) && $out['expr_type'] === ExpressionType::COMMENT);
}
public function processComment($expression) {
$result = array();
$result['expr_type'] = ExpressionType::COMMENT;
$result['value'] = $expression;
return $result;
}
/**
* translates an array of objects into an associative array
*/
public function toArray($tokenList) {
$expr = array();
foreach ($tokenList as $token) {
if ($token instanceof \PHPSQLParser\utils\ExpressionToken) {
$expr[] = $token->toArray();
} else {
$expr[] = $token;
}
}
return $expr;
}
protected function array_insert_after($array, $key, $entry) {
$idx = array_search($key, array_keys($array));
$array = array_slice($array, 0, $idx + 1, true) + $entry
+ array_slice($array, $idx + 1, count($array) - 1, true);
return $array;
}
}
?>
PK \ P vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/DefaultProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the incoming sql string.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DefaultProcessor extends AbstractProcessor {
protected function isUnion($tokens) {
return UnionProcessor::isUnion($tokens);
}
protected function processUnion($tokens) {
// this is the highest level lexical analysis. This is the part of the
// code which finds UNION and UNION ALL query parts
$processor = new UnionProcessor($this->options);
return $processor->process($tokens);
}
protected function processSQL($tokens) {
$processor = new SQLProcessor($this->options);
return $processor->process($tokens);
}
public function process($sql) {
$inputArray = $this->splitSQLIntoTokens($sql);
$queries = $this->processUnion($inputArray);
// If there was no UNION or UNION ALL in the query, then the query is
// stored at $queries[0].
if (!empty($queries) && !$this->isUnion($queries)) {
$queries = $this->processSQL($queries[0]);
}
return $queries;
}
public function revokeQuotation($sql) {
return parent::revokeQuotation($sql);
}
}
?>
PK \%!6 !6 Y vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/PartitionOptionsProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the PARTITION BY statements within CREATE TABLE.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class PartitionOptionsProcessor extends AbstractProcessor {
protected function processExpressionList($unparsed) {
$processor = new ExpressionListProcessor($this->options);
$expr = $this->removeParenthesisFromStart($unparsed);
$expr = $this->splitSQLIntoTokens($expr);
return $processor->process($expr);
}
protected function processColumnList($unparsed) {
$processor = new ColumnListProcessor($this->options);
$expr = $this->removeParenthesisFromStart($unparsed);
return $processor->process($expr);
}
protected function processPartitionDefinition($unparsed) {
$processor = new PartitionDefinitionProcessor($this->options);
$expr = $this->removeParenthesisFromStart($unparsed);
$expr = $this->splitSQLIntoTokens($expr);
return $processor->process($expr);
}
protected function getReservedType($token) {
return array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $token);
}
protected function getConstantType($token) {
return array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $token);
}
protected function getOperatorType($token) {
return array('expr_type' => ExpressionType::OPERATOR, 'base_expr' => $token);
}
protected function getBracketExpressionType($token) {
return array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $token, 'sub_tree' => false);
}
public function process($tokens) {
$result = array('partition-options' => array(), 'last-parsed' => false);
$prevCategory = '';
$currCategory = '';
$parsed = array();
$expr = array();
$base_expr = '';
$skip = 0;
foreach ($tokens as $tokenKey => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($skip > 0) {
$skip--;
continue;
}
if ($skip < 0) {
break;
}
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'PARTITION':
$currCategory = $upper;
$expr[] = $this->getReservedType($trim);
$parsed[] = array('expr_type' => ExpressionType::PARTITION, 'base_expr' => trim($base_expr),
'sub_tree' => false);
break;
case 'SUBPARTITION':
$currCategory = $upper;
$expr[] = $this->getReservedType($trim);
$parsed[] = array('expr_type' => ExpressionType::SUBPARTITION, 'base_expr' => trim($base_expr),
'sub_tree' => false);
break;
case 'BY':
if ($prevCategory === 'PARTITION' || $prevCategory === 'SUBPARTITION') {
$expr[] = $this->getReservedType($trim);
continue 2;
}
break;
case 'PARTITIONS':
case 'SUBPARTITIONS':
$currCategory = 'PARTITION_NUM';
$expr = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::' . substr($upper, 0, -1) . '_COUNT'),
'base_expr' => false, 'sub_tree' => array($this->getReservedType($trim)),
'storage' => substr($base_expr, 0, -strlen($token)));
$base_expr = $token;
continue 2;
case 'LINEAR':
// followed by HASH or KEY
$currCategory = $upper;
$expr[] = $this->getReservedType($trim);
continue 2;
case 'HASH':
case 'KEY':
$expr[] = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::' . $prevCategory . '_' . $upper),
'base_expr' => false, 'linear' => ($currCategory === 'LINEAR'), 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$last = array_pop($parsed);
$last['by'] = trim($currCategory . ' ' . $upper); // $currCategory will be empty or LINEAR!
$last['sub_tree'] = $expr;
$parsed[] = $last;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
case 'ALGORITHM':
if ($currCategory === 'KEY') {
$expr[] = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::' . $prevCategory . '_KEY_ALGORITHM'),
'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$last = array_pop($parsed);
$subtree = array_pop($last['sub_tree']);
$subtree['sub_tree'] = $expr;
$last['sub_tree'][] = $subtree;
$parsed[] = $last;
unset($subtree);
unset($last);
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
break;
case 'RANGE':
case 'LIST':
$expr[] = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::PARTITION_' . $upper), 'base_expr' => false,
'sub_tree' => false, 'storage' => substr($base_expr, 0, -strlen($token)));
$last = array_pop($parsed);
$last['by'] = $upper;
$last['sub_tree'] = $expr;
$parsed[] = $last;
unset($last);
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper . '_EXPR';
continue 2;
case 'COLUMNS':
if ($currCategory === 'RANGE_EXPR' || $currCategory === 'LIST_EXPR') {
$expr[] = $this->getReservedType($trim);
$currCategory = substr($currCategory, 0, -4) . $upper;
continue 2;
}
break;
case '=':
if ($currCategory === 'ALGORITHM') {
// between ALGORITHM and a constant
$expr[] = $this->getOperatorType($trim);
continue 2;
}
break;
default:
switch ($currCategory) {
case 'PARTITION_NUM':
// the number behind PARTITIONS or SUBPARTITIONS
$expr['base_expr'] = trim($base_expr);
$expr['sub_tree'][] = $this->getConstantType($trim);
$base_expr = $expr['storage'] . $base_expr;
unset($expr['storage']);
$last = array_pop($parsed);
$last['count'] = $trim;
$last['sub_tree'][] = $expr;
$last['base_expr'] .= $base_expr;
$parsed[] = $last;
unset($last);
$expr = array();
$base_expr = '';
$currCategory = $prevCategory;
break;
case 'ALGORITHM':
// the number of the algorithm
$expr[] = $this->getConstantType($trim);
$last = array_pop($parsed);
$subtree = array_pop($last['sub_tree']);
$key = array_pop($subtree['sub_tree']);
$key['sub_tree'] = $expr;
$key['base_expr'] = trim($base_expr);
$base_expr = $key['storage'] . $base_expr;
unset($key['storage']);
$subtree['sub_tree'][] = $key;
unset($key);
$expr = $subtree['sub_tree'];
$subtree['sub_tree'] = false;
$subtree['algorithm'] = $trim;
$last['sub_tree'][] = $subtree;
unset($subtree);
$parsed[] = $last;
unset($last);
$currCategory = 'KEY';
continue 3;
case 'LIST_EXPR':
case 'RANGE_EXPR':
case 'HASH':
// parenthesis around an expression
$last = $this->getBracketExpressionType($trim);
$res = $this->processExpressionList($trim);
$last['sub_tree'] = (empty($res) ? false : $res);
$expr[] = $last;
$last = array_pop($parsed);
$subtree = array_pop($last['sub_tree']);
$subtree['base_expr'] = $base_expr;
$subtree['sub_tree'] = $expr;
$base_expr = $subtree['storage'] . $base_expr;
unset($subtree['storage']);
$last['sub_tree'][] = $subtree;
$last['base_expr'] = trim($base_expr);
$parsed[] = $last;
unset($last);
unset($subtree);
$expr = array();
$base_expr = '';
$currCategory = $prevCategory;
break;
case 'LIST_COLUMNS':
case 'RANGE_COLUMNS':
case 'KEY':
// the columnlist
$expr[] = array('expr_type' => ExpressionType::COLUMN_LIST, 'base_expr' => $trim,
'sub_tree' => $this->processColumnList($trim));
$last = array_pop($parsed);
$subtree = array_pop($last['sub_tree']);
$subtree['base_expr'] = $base_expr;
$subtree['sub_tree'] = $expr;
$base_expr = $subtree['storage'] . $base_expr;
unset($subtree['storage']);
$last['sub_tree'][] = $subtree;
$last['base_expr'] = trim($base_expr);
$parsed[] = $last;
unset($last);
unset($subtree);
$expr = array();
$base_expr = '';
$currCategory = $prevCategory;
break;
case '':
if ($prevCategory === 'PARTITION' || $prevCategory === 'SUBPARTITION') {
if ($upper[0] === '(' && substr($upper, -1) === ')') {
// last part to process, it is only one token!
$last = $this->getBracketExpressionType($trim);
$last['sub_tree'] = $this->processPartitionDefinition($trim);
$parsed[] = $last;
break;
}
}
// else ?
break;
default:
break;
}
break;
}
$prevCategory = $currCategory;
$currCategory = '';
}
$result['partition-options'] = $parsed;
if ($result['last-parsed'] === false) {
$result['last-parsed'] = $tokenKey;
}
return $result;
}
}
?>
PK \!N- - P vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/OptionsProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the statement options.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class OptionsProcessor extends AbstractProcessor {
public function process($tokens) {
$resultList = array();
foreach ($tokens as $token) {
$tokenList = $this->splitSQLIntoTokens($token);
$result = array();
foreach ($tokenList as $reserved) {
$trim = trim($reserved);
if ($trim === '') {
continue;
}
$result[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
}
$resultList[] = array('expr_type' => ExpressionType::EXPRESSION, 'base_expr' => trim($token),
'sub_tree' => $result);
}
return $resultList;
}
}
?>
PK \zFZ Z M vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/WithProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
*
* This class processes Oracle's WITH statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class WithProcessor extends AbstractProcessor {
protected function processTopLevel($sql) {
$processor = new DefaultProcessor($this->options);
return $processor->process($sql);
}
protected function buildTableName($token) {
return array('expr_type' => ExpressionType::TEMPORARY_TABLE, 'name'=>$token, 'base_expr' => $token, 'no_quotes' => $this->revokeQuotation($token));
}
public function process($tokens) {
$out = array();
$resultList = array();
$category = '';
$base_expr = '';
$prev = '';
foreach ($tokens as $token) {
$base_expr .= $token;
$upper = strtoupper(trim($token));
if ($this->isWhitespaceToken($token)) {
continue;
}
$trim = trim($token);
switch ($upper) {
case 'AS':
if ($prev !== 'TABLENAME') {
// error or tablename is AS
$resultList[] = $this->buildTableName($trim);
$category = 'TABLENAME';
break;
}
$resultList[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$category = $upper;
break;
case ',':
// ignore
$base_expr = '';
break;
default:
switch ($prev) {
case 'AS':
// it follows a parentheses pair
$subtree = $this->processTopLevel($this->removeParenthesisFromStart($token));
$resultList[] = array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $trim, 'sub_tree' => $subtree);
$out[] = array('expr_type' => ExpressionType::SUBQUERY_FACTORING, 'base_expr' => trim($base_expr), 'sub_tree' => $resultList);
$resultList = array();
$category = '';
break;
case '':
// we have the name of the table
$resultList[] = $this->buildTableName($trim);
$category = 'TABLENAME';
break;
default:
// ignore
break;
}
break;
}
$prev = $category;
}
return $out;
}
}
?>PK \0E E N vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/UsingProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the USING statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UsingProcessor extends FromProcessor {
}
?>
PK \7 7 \ vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/PartitionDefinitionProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the PARTITION statements within CREATE TABLE.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class PartitionDefinitionProcessor extends AbstractProcessor {
protected function processExpressionList($unparsed) {
$processor = new ExpressionListProcessor($this->options);
$expr = $this->removeParenthesisFromStart($unparsed);
$expr = $this->splitSQLIntoTokens($expr);
return $processor->process($expr);
}
protected function processSubpartitionDefinition($unparsed) {
$processor = new SubpartitionDefinitionProcessor($this->options);
$expr = $this->removeParenthesisFromStart($unparsed);
$expr = $this->splitSQLIntoTokens($expr);
return $processor->process($expr);
}
protected function getReservedType($token) {
return array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $token);
}
protected function getConstantType($token) {
return array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $token);
}
protected function getOperatorType($token) {
return array('expr_type' => ExpressionType::OPERATOR, 'base_expr' => $token);
}
protected function getBracketExpressionType($token) {
return array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $token, 'sub_tree' => false);
}
public function process($tokens) {
$result = array();
$prevCategory = '';
$currCategory = '';
$parsed = array();
$expr = array();
$base_expr = '';
$skip = 0;
foreach ($tokens as $tokenKey => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($skip > 0) {
$skip--;
continue;
}
if ($skip < 0) {
break;
}
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'PARTITION':
if ($currCategory === '') {
$expr[] = $this->getReservedType($trim);
$parsed = array('expr_type' => ExpressionType::PARTITION_DEF, 'base_expr' => trim($base_expr),
'sub_tree' => false);
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'VALUES':
if ($prevCategory === 'PARTITION') {
$expr[] = array('expr_type' => ExpressionType::PARTITION_VALUES, 'base_expr' => false,
'sub_tree' => false, 'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'LESS':
if ($currCategory === 'VALUES') {
$expr[] = $this->getReservedType($trim);
continue 2;
}
// else ?
break;
case 'THAN':
if ($currCategory === 'VALUES') {
// followed by parenthesis and (value-list or expr)
$expr[] = $this->getReservedType($trim);
continue 2;
}
// else ?
break;
case 'MAXVALUE':
if ($currCategory === 'VALUES') {
$expr[] = $this->getConstantType($trim);
$last = array_pop($parsed['sub_tree']);
$last['base_expr'] = $base_expr;
$last['sub_tree'] = $expr;
$base_expr = $last['storage'] . $base_expr;
unset($last['storage']);
$parsed['sub_tree'][] = $last;
$parsed['base_expr'] = trim($base_expr);
$expr = $parsed['sub_tree'];
unset($last);
$currCategory = $prevCategory;
}
// else ?
break;
case 'IN':
if ($currCategory === 'VALUES') {
// followed by parenthesis and value-list
$expr[] = $this->getReservedType($trim);
continue 2;
}
break;
case 'COMMENT':
if ($prevCategory === 'PARTITION') {
$expr[] = array('expr_type' => ExpressionType::PARTITION_COMMENT, 'base_expr' => false,
'sub_tree' => false, 'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'STORAGE':
if ($prevCategory === 'PARTITION') {
// followed by ENGINE
$expr[] = array('expr_type' => ExpressionType::ENGINE, 'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'ENGINE':
if ($currCategory === 'STORAGE') {
$expr[] = $this->getReservedType($trim);
$currCategory = $upper;
continue 2;
}
if ($prevCategory === 'PARTITION') {
$expr[] = array('expr_type' => ExpressionType::ENGINE, 'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case '=':
if (in_array($currCategory, array('ENGINE', 'COMMENT', 'DIRECTORY', 'MAX_ROWS', 'MIN_ROWS'))) {
$expr[] = $this->getOperatorType($trim);
continue 2;
}
// else ?
break;
case ',':
if ($prevCategory === 'PARTITION' && $currCategory === '') {
// it separates the partition-definitions
$result[] = $parsed;
$parsed = array();
$base_expr = '';
$expr = array();
}
break;
case 'DATA':
case 'INDEX':
if ($prevCategory === 'PARTITION') {
// followed by DIRECTORY
$expr[] = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::PARTITION_' . $upper . '_DIR'),
'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'DIRECTORY':
if ($currCategory === 'DATA' || $currCategory === 'INDEX') {
$expr[] = $this->getReservedType($trim);
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'MAX_ROWS':
case 'MIN_ROWS':
if ($prevCategory === 'PARTITION') {
$expr[] = array('expr_type' => constant('PHPSQLParser\utils\ExpressionType::PARTITION_' . $upper),
'base_expr' => false, 'sub_tree' => false,
'storage' => substr($base_expr, 0, -strlen($token)));
$parsed['sub_tree'] = $expr;
$base_expr = $token;
$expr = array($this->getReservedType($trim));
$currCategory = $upper;
continue 2;
}
// else ?
break;
default:
switch ($currCategory) {
case 'MIN_ROWS':
case 'MAX_ROWS':
case 'ENGINE':
case 'DIRECTORY':
case 'COMMENT':
$expr[] = $this->getConstantType($trim);
$last = array_pop($parsed['sub_tree']);
$last['sub_tree'] = $expr;
$last['base_expr'] = trim($base_expr);
$base_expr = $last['storage'] . $base_expr;
unset($last['storage']);
$parsed['sub_tree'][] = $last;
$parsed['base_expr'] = trim($base_expr);
$expr = $parsed['sub_tree'];
unset($last);
$currCategory = $prevCategory;
break;
case 'PARTITION':
// that is the partition name
$last = array_pop($expr);
$last['name'] = $trim;
$expr[] = $last;
$expr[] = $this->getConstantType($trim);
$parsed['sub_tree'] = $expr;
$parsed['base_expr'] = trim($base_expr);
break;
case 'VALUES':
// we have parenthesis and have to process an expression/in-list
$last = $this->getBracketExpressionType($trim);
$res = $this->processExpressionList($trim);
$last['sub_tree'] = (empty($res) ? false : $res);
$expr[] = $last;
$last = array_pop($parsed['sub_tree']);
$last['base_expr'] = $base_expr;
$last['sub_tree'] = $expr;
$base_expr = $last['storage'] . $base_expr;
unset($last['storage']);
$parsed['sub_tree'][] = $last;
$parsed['base_expr'] = trim($base_expr);
$expr = $parsed['sub_tree'];
unset($last);
$currCategory = $prevCategory;
break;
case '':
if ($prevCategory === 'PARTITION') {
// last part to process, it is only one token!
if ($upper[0] === '(' && substr($upper, -1) === ')') {
$last = $this->getBracketExpressionType($trim);
$last['sub_tree'] = $this->processSubpartitionDefinition($trim);
$expr[] = $last;
unset($last);
$parsed['base_expr'] = trim($base_expr);
$parsed['sub_tree'] = $expr;
$currCategory = $prevCategory;
break;
}
}
// else ?
break;
default:
break;
}
break;
}
$prevCategory = $currCategory;
$currCategory = '';
}
$result[] = $parsed;
return $result;
}
}
?>
PK \0V}͆ P vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ExplainProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the EXPLAIN statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ExplainProcessor extends AbstractProcessor {
protected function isStatement($keys, $needle = "EXPLAIN") {
$pos = array_search($needle, $keys);
if (isset($keys[$pos + 1])) {
return in_array($keys[$pos + 1], array('SELECT', 'DELETE', 'INSERT', 'REPLACE', 'UPDATE'), true);
}
return false;
}
// TODO: refactor that function
public function process($tokens, $keys = array()) {
$base_expr = "";
$expr = array();
$currCategory = "";
if ($this->isStatement($keys)) {
foreach ($tokens as $token) {
$trim = trim($token);
$base_expr .= $token;
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'EXTENDED':
case 'PARTITIONS':
return array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $token);
break;
case 'FORMAT':
if ($currCategory === '') {
$currCategory = $upper;
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
}
// else?
break;
case '=':
if ($currCategory === 'FORMAT') {
$expr[] = array('expr_type' => ExpressionType::OPERATOR, 'base_expr' => $trim);
}
// else?
break;
case 'TRADITIONAL':
case 'JSON':
if ($currCategory === 'FORMAT') {
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
return array('expr_type' => ExpressionType::EXPRESSION, 'base_expr' => trim($base_expr),
'sub_tree' => $expr);
}
// else?
break;
default:
// ignore the other stuff
break;
}
}
return empty($expr) ? null : $expr;
}
foreach ($tokens as $token) {
$trim = trim($token);
if ($trim === '') {
continue;
}
switch ($currCategory) {
case 'TABLENAME':
$currCategory = 'WILD';
$expr[] = array('expr_type' => ExpressionType::COLREF, 'base_expr' => $trim,
'no_quotes' => $this->revokeQuotation($trim));
break;
case '':
$currCategory = 'TABLENAME';
$expr[] = array('expr_type' => ExpressionType::TABLE, 'table' => $trim,
'no_quotes' => $this->revokeQuotation($trim), 'alias' => false, 'base_expr' => $trim);
break;
default:
break;
}
}
return empty($expr) ? null : $expr;
}
}
?>
PK \Y2I I O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/UpdateProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the UPDATE statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UpdateProcessor extends FromProcessor {
}
?>
PK \ w w P vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/OrderByProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the ORDER-BY statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class OrderByProcessor extends AbstractProcessor {
protected function processSelectExpression($unparsed) {
$processor = new SelectExpressionProcessor($this->options);
return $processor->process($unparsed);
}
protected function initParseInfo() {
return array('base_expr' => "", 'dir' => "ASC", 'expr_type' => ExpressionType::EXPRESSION);
}
protected function processOrderExpression(&$parseInfo, $select) {
$parseInfo['base_expr'] = trim($parseInfo['base_expr']);
if ($parseInfo['base_expr'] === "") {
return false;
}
if (is_numeric($parseInfo['base_expr'])) {
$parseInfo['expr_type'] = ExpressionType::POSITION;
} else {
$parseInfo['no_quotes'] = $this->revokeQuotation($parseInfo['base_expr']);
// search to see if the expression matches an alias
foreach ($select as $clause) {
if (empty($clause['alias'])) {
continue;
}
if ($clause['alias']['no_quotes'] === $parseInfo['no_quotes']) {
$parseInfo['expr_type'] = ExpressionType::ALIAS;
break;
}
}
}
if ($parseInfo['expr_type'] === ExpressionType::EXPRESSION) {
$expr = $this->processSelectExpression($parseInfo['base_expr']);
$expr['direction'] = $parseInfo['dir'];
unset($expr['alias']);
return $expr;
}
$result = array();
$result['expr_type'] = $parseInfo['expr_type'];
$result['base_expr'] = $parseInfo['base_expr'];
if (isset($parseInfo['no_quotes'])) {
$result['no_quotes'] = $parseInfo['no_quotes'];
}
$result['direction'] = $parseInfo['dir'];
return $result;
}
public function process($tokens, $select = array()) {
$out = array();
$parseInfo = $this->initParseInfo();
if (!$tokens) {
return false;
}
foreach ($tokens as $token) {
$upper = strtoupper(trim($token));
switch ($upper) {
case ',':
$out[] = $this->processOrderExpression($parseInfo, $select);
$parseInfo = $this->initParseInfo();
break;
case 'DESC':
$parseInfo['dir'] = "DESC";
break;
case 'ASC':
$parseInfo['dir'] = "ASC";
break;
default:
if ($this->isCommentToken($token)) {
$out[] = parent::processComment($token);
break;
}
$parseInfo['base_expr'] .= $token;
}
}
$out[] = $this->processOrderExpression($parseInfo, $select);
return $out;
}
}
?>
PK \![ [ M vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/DescProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
/**
*
* This class processes the DESC statement.
*
* @author arothe
*
*/
class DescProcessor extends ExplainProcessor {
protected function isStatement($keys, $needle = "DESC") {
return parent::isStatement($keys, $needle);
}
}
?>
PK \S L vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/SetProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
*
* This class processes the SET statements.
*
* @author arothe
*
*/
class SetProcessor extends AbstractProcessor {
protected function processExpressionList($tokens) {
$processor = new ExpressionListProcessor($this->options);
return $processor->process($tokens);
}
/**
* A SET list is simply a list of key = value expressions separated by comma (,).
* This function produces a list of the key/value expressions.
*/
protected function processAssignment($base_expr) {
$assignment = $this->processExpressionList($this->splitSQLIntoTokens($base_expr));
// TODO: if the left side of the assignment is a reserved keyword, it should be changed to colref
return array('expr_type' => ExpressionType::EXPRESSION, 'base_expr' => trim($base_expr),
'sub_tree' => (empty($assignment) ? false : $assignment));
}
public function process($tokens, $isUpdate = false) {
$result = array();
$baseExpr = "";
$assignment = false;
$varType = false;
foreach ($tokens as $token) {
$trim = trim($token);
$upper = strtoupper($trim);
switch ($upper) {
case 'LOCAL':
case 'SESSION':
case 'GLOBAL':
if (!$isUpdate) {
$result[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$varType = $this->getVariableType("@@" . $upper . ".");
$baseExpr = "";
continue 2;
}
break;
case ',':
$assignment = $this->processAssignment($baseExpr);
if (!$isUpdate && $varType !== false) {
$assignment['sub_tree'][0]['expr_type'] = $varType;
}
$result[] = $assignment;
$baseExpr = "";
$varType = false;
continue 2;
default:
}
$baseExpr .= $token;
}
if (trim($baseExpr) !== "") {
$assignment = $this->processAssignment($baseExpr);
if (!$isUpdate && $varType !== false) {
$assignment['sub_tree'][0]['expr_type'] = $varType;
}
$result[] = $assignment;
}
return $result;
}
}
?>PK \. P vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/GroupByProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
/**
*
* This class processes the GROUP-BY statements.
*
* @author arothe
*
*/
class GroupByProcessor extends OrderByProcessor {
public function process($tokens, $select = array()) {
$out = array();
$parseInfo = $this->initParseInfo();
if (!$tokens) {
return false;
}
foreach ($tokens as $token) {
$trim = strtoupper(trim($token));
switch ($trim) {
case ',':
$parsed = $this->processOrderExpression($parseInfo, $select);
unset($parsed['direction']);
$out[] = $parsed;
$parseInfo = $this->initParseInfo();
break;
default:
$parseInfo['base_expr'] .= $token;
}
}
$parsed = $this->processOrderExpression($parseInfo, $select);
unset($parsed['direction']);
$out[] = $parsed;
return $out;
}
}
?>
PK \9: : N vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/TableProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the TABLE statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class TableProcessor extends AbstractProcessor {
protected function getReservedType($token) {
return array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $token);
}
protected function getConstantType($token) {
return array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $token);
}
protected function getOperatorType($token) {
return array('expr_type' => ExpressionType::OPERATOR, 'base_expr' => $token);
}
protected function processPartitionOptions($tokens) {
$processor = new PartitionOptionsProcessor($this->options);
return $processor->process($tokens);
}
protected function processCreateDefinition($tokens) {
$processor = new CreateDefinitionProcessor($this->options);
return $processor->process($tokens);
}
protected function clear(&$expr, &$base_expr, &$category) {
$expr = array();
$base_expr = '';
$category = 'CREATE_DEF';
}
public function process($tokens) {
$currCategory = 'TABLE_NAME';
$result = array('base_expr' => false, 'name' => false, 'no_quotes' => false, 'create-def' => false,
'options' => array(), 'like' => false, 'select-option' => false);
$expr = array();
$base_expr = '';
$skip = 0;
foreach ($tokens as $tokenKey => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($skip > 0) {
$skip--;
continue;
}
if ($skip < 0) {
break;
}
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case ',':
// it is possible to separate the table options with comma!
if ($prevCategory === 'CREATE_DEF') {
$last = array_pop($result['options']);
$last['delim'] = ',';
$result['options'][] = $last;
$base_expr = '';
}
continue 2;
case 'UNION':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'UNION';
continue 2;
}
break;
case 'LIKE':
// like without parenthesis
if ($prevCategory === 'TABLE_NAME') {
$currCategory = $upper;
continue 2;
}
break;
case '=':
// the optional operator
if ($prevCategory === 'TABLE_OPTION') {
$expr[] = $this->getOperatorType($trim);
continue 2; // don't change the category
}
break;
case 'CHARACTER':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'TABLE_OPTION';
}
if ($prevCategory === 'TABLE_OPTION') {
// add it to the previous DEFAULT
$expr[] = $this->getReservedType($trim);
continue 2;
}
break;
case 'SET':
case 'CHARSET':
if ($prevCategory === 'TABLE_OPTION') {
// add it to a previous CHARACTER
$expr[] = $this->getReservedType($trim);
$currCategory = 'CHARSET';
continue 2;
}
break;
case 'COLLATE':
if ($prevCategory === 'TABLE_OPTION' || $prevCategory === 'CREATE_DEF') {
// add it to the previous DEFAULT
$expr[] = $this->getReservedType($trim);
$currCategory = 'COLLATE';
continue 2;
}
break;
case 'DIRECTORY':
if ($currCategory === 'INDEX_DIRECTORY' || $currCategory === 'DATA_DIRECTORY') {
// after INDEX or DATA
$expr[] = $this->getReservedType($trim);
continue 2;
}
break;
case 'INDEX':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'INDEX_DIRECTORY';
continue 2;
}
break;
case 'DATA':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = 'DATA_DIRECTORY';
continue 2;
}
break;
case 'INSERT_METHOD':
case 'DELAY_KEY_WRITE':
case 'ROW_FORMAT':
case 'PASSWORD':
case 'MAX_ROWS':
case 'MIN_ROWS':
case 'PACK_KEYS':
case 'CHECKSUM':
case 'COMMENT':
case 'CONNECTION':
case 'AUTO_INCREMENT':
case 'AVG_ROW_LENGTH':
case 'ENGINE':
case 'TYPE':
case 'STATS_AUTO_RECALC':
case 'STATS_PERSISTENT':
case 'KEY_BLOCK_SIZE':
if ($prevCategory === 'CREATE_DEF') {
$expr[] = $this->getReservedType($trim);
$currCategory = $prevCategory = 'TABLE_OPTION';
continue 2;
}
break;
case 'DYNAMIC':
case 'FIXED':
case 'COMPRESSED':
case 'REDUNDANT':
case 'COMPACT':
case 'NO':
case 'FIRST':
case 'LAST':
case 'DEFAULT':
if ($prevCategory === 'CREATE_DEF') {
// DEFAULT before CHARACTER SET and COLLATE
$expr[] = $this->getReservedType($trim);
$currCategory = 'TABLE_OPTION';
}
if ($prevCategory === 'TABLE_OPTION') {
// all assignments with the keywords
$expr[] = $this->getReservedType($trim);
$result['options'][] = array('expr_type' => ExpressionType::EXPRESSION,
'base_expr' => trim($base_expr), 'delim' => ' ', 'sub_tree' => $expr);
$this->clear($expr, $base_expr, $currCategory);
}
break;
case 'IGNORE':
case 'REPLACE':
$expr[] = $this->getReservedType($trim);
$result['select-option'] = array('base_expr' => trim($base_expr), 'duplicates' => $trim, 'as' => false,
'sub_tree' => $expr);
continue 2;
case 'AS':
$expr[] = $this->getReservedType($trim);
if (!isset($result['select-option']['duplicates'])) {
$result['select-option']['duplicates'] = false;
}
$result['select-option']['as'] = true;
$result['select-option']['base_expr'] = trim($base_expr);
$result['select-option']['sub_tree'] = $expr;
continue 2;
case 'PARTITION':
if ($prevCategory === 'CREATE_DEF') {
$part = $this->processPartitionOptions(array_slice($tokens, $tokenKey - 1, null, true));
$skip = $part['last-parsed'] - $tokenKey;
$result['partition-options'] = $part['partition-options'];
continue 2;
}
// else
break;
default:
switch ($currCategory) {
case 'CHARSET':
// the charset name
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::CHARSET,
'base_expr' => trim($base_expr), 'delim' => ' ', 'sub_tree' => $expr);
$this->clear($expr, $base_expr, $currCategory);
break;
case 'COLLATE':
// the collate name
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::COLLATE,
'base_expr' => trim($base_expr), 'delim' => ' ', 'sub_tree' => $expr);
$this->clear($expr, $base_expr, $currCategory);
break;
case 'DATA_DIRECTORY':
// we have the directory name
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::DIRECTORY, 'kind' => 'DATA',
'base_expr' => trim($base_expr), 'delim' => ' ', 'sub_tree' => $expr);
$this->clear($expr, $base_expr, $prevCategory);
continue 3;
case 'INDEX_DIRECTORY':
// we have the directory name
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::DIRECTORY, 'kind' => 'INDEX',
'base_expr' => trim($base_expr), 'delim' => ' ', 'sub_tree' => $expr);
$this->clear($expr, $base_expr, $prevCategory);
continue 3;
case 'TABLE_NAME':
$result['base_expr'] = $result['name'] = $trim;
$result['no_quotes'] = $this->revokeQuotation($trim);
$this->clear($expr, $base_expr, $prevCategory);
break;
case 'LIKE':
$result['like'] = array('expr_type' => ExpressionType::TABLE, 'table' => $trim,
'base_expr' => $trim, 'no_quotes' => $this->revokeQuotation($trim));
$this->clear($expr, $base_expr, $currCategory);
break;
case '':
// after table name
if ($prevCategory === 'TABLE_NAME' && $upper[0] === '(' && substr($upper, -1) === ')') {
$unparsed = $this->splitSQLIntoTokens($this->removeParenthesisFromStart($trim));
$coldef = $this->processCreateDefinition($unparsed);
$result['create-def'] = array('expr_type' => ExpressionType::BRACKET_EXPRESSION,
'base_expr' => $base_expr, 'sub_tree' => $coldef['create-def']);
$expr = array();
$base_expr = '';
$currCategory = 'CREATE_DEF';
}
break;
case 'UNION':
// TODO: this token starts and ends with parenthesis
// and contains a list of table names (comma-separated)
// split the token and add the list as subtree
// we must change the DefaultProcessor
$unparsed = $this->splitSQLIntoTokens($this->removeParenthesisFromStart($trim));
$expr[] = array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $trim,
'sub_tree' => '***TODO***');
$result['options'][] = array('expr_type' => ExpressionType::UNION, 'base_expr' => trim($base_expr),
'delim' => ' ', 'sub_tree' => $expr);
$this->clear($expr, $base_expr, $currCategory);
break;
default:
// strings and numeric constants
$expr[] = $this->getConstantType($trim);
$result['options'][] = array('expr_type' => ExpressionType::EXPRESSION,
'base_expr' => trim($base_expr), 'delim' => ' ', 'sub_tree' => $expr);
$this->clear($expr, $base_expr, $currCategory);
break;
}
break;
}
$prevCategory = $currCategory;
$currCategory = '';
}
if ($result['like'] === false) {
unset($result['like']);
}
if ($result['select-option'] === false) {
unset($result['select-option']);
}
if ($result['options'] === array()) {
$result['options'] = false;
}
return $result;
}
}
?>PK \"]'X O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/InsertProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the INSERT statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class InsertProcessor extends AbstractProcessor {
protected function processOptions($tokenList) {
if (!isset($tokenList['OPTIONS'])) {
return array();
}
$result = array();
foreach ($tokenList['OPTIONS'] as $token) {
$result[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => trim($token));
}
return $result;
}
protected function processKeyword($keyword, $tokenList) {
if (!isset($tokenList[$keyword])) {
return array('', false, array());
}
$table = '';
$cols = false;
$result = array();
foreach ($tokenList[$keyword] as $token) {
$trim = trim($token);
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'INTO':
$result[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
break;
case 'INSERT':
case 'REPLACE':
break;
default:
if ($table === '') {
$table = $trim;
break;
}
if ($cols === false) {
$cols = $trim;
}
break;
}
}
return array($table, $cols, $result);
}
protected function processColumns($cols) {
if ($cols === false) {
return $cols;
}
if ($cols[0] === '(' && substr($cols, -1) === ')') {
$parsed = array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $cols,
'sub_tree' => false);
}
$cols = $this->removeParenthesisFromStart($cols);
if (stripos($cols, 'SELECT') === 0) {
$processor = new DefaultProcessor($this->options);
$parsed['sub_tree'] = array(
array('expr_type' => ExpressionType::QUERY, 'base_expr' => $cols,
'sub_tree' => $processor->process($cols)));
} else {
$processor = new ColumnListProcessor($this->options);
$parsed['sub_tree'] = $processor->process($cols);
$parsed['expr_type'] = ExpressionType::COLUMN_LIST;
}
return $parsed;
}
public function process($tokenList, $token_category = 'INSERT') {
$table = '';
$cols = false;
$comments = array();
foreach ($tokenList as $key => &$token) {
if ($key == 'VALUES') {
continue;
}
foreach ($token as &$value) {
if ($this->isCommentToken($value)) {
$comments[] = parent::processComment($value);
$value = '';
}
}
}
$parsed = $this->processOptions($tokenList);
unset($tokenList['OPTIONS']);
list($table, $cols, $key) = $this->processKeyword('INTO', $tokenList);
$parsed = array_merge($parsed, $key);
unset($tokenList['INTO']);
if ($table === '' && in_array($token_category, array('INSERT', 'REPLACE'))) {
list($table, $cols, $key) = $this->processKeyword($token_category, $tokenList);
}
$parsed[] = array('expr_type' => ExpressionType::TABLE, 'table' => $table,
'no_quotes' => $this->revokeQuotation($table), 'alias' => false, 'base_expr' => $table);
$cols = $this->processColumns($cols);
if ($cols !== false) {
$parsed[] = $cols;
}
$parsed = array_merge($parsed, $comments);
$tokenList[$token_category] = $parsed;
return $tokenList;
}
}
?>
PK \*q O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/SelectProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
/**
*
* This class processes the SELECT statements.
*
* @author arothe
*
*/
class SelectProcessor extends SelectExpressionProcessor {
public function process($tokens) {
$expression = "";
$expressionList = array();
foreach ($tokens as $token) {
if ($this->isCommaToken($token)) {
$expression = parent::process(trim($expression));
$expression['delim'] = ',';
$expressionList[] = $expression;
$expression = "";
} else if ($this->isCommentToken($token)) {
$expressionList[] = parent::processComment($token);
} else {
switch (strtoupper($token)) {
// add more SELECT options here
case 'DISTINCT':
case 'DISTINCTROW':
case 'HIGH_PRIORITY':
case 'SQL_CACHE':
case 'SQL_NO_CACHE':
case 'SQL_CALC_FOUND_ROWS':
case 'STRAIGHT_JOIN':
case 'SQL_SMALL_RESULT':
case 'SQL_BIG_RESULT':
case 'SQL_BUFFER_RESULT':
$expression = parent::process(trim($token));
$expression['delim'] = ' ';
$expressionList[] = $expression;
$expression = "";
break;
default:
$expression .= $token;
}
}
}
if ($expression) {
$expression = parent::process(trim($expression));
$expression['delim'] = false;
$expressionList[] = $expression;
}
return $expressionList;
}
}
?>
PK \D D Y vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/CreateDefinitionProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class processes the create definition of the TABLE statements.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class CreateDefinitionProcessor extends AbstractProcessor {
protected function processExpressionList($parsed) {
$processor = new ExpressionListProcessor($this->options);
return $processor->process($parsed);
}
protected function processIndexColumnList($parsed) {
$processor = new IndexColumnListProcessor($this->options);
return $processor->process($parsed);
}
protected function processColumnDefinition($parsed) {
$processor = new ColumnDefinitionProcessor($this->options);
return $processor->process($parsed);
}
protected function processReferenceDefinition($parsed) {
$processor = new ReferenceDefinitionProcessor($this->options);
return $processor->process($parsed);
}
protected function correctExpressionType(&$expr) {
$type = ExpressionType::EXPRESSION;
if (!isset($expr[0]) || !isset($expr[0]['expr_type'])) {
return $type;
}
// replace the constraint type with a more descriptive one
switch ($expr[0]['expr_type']) {
case ExpressionType::CONSTRAINT:
$type = $expr[1]['expr_type'];
$expr[1]['expr_type'] = ExpressionType::RESERVED;
break;
case ExpressionType::COLREF:
$type = ExpressionType::COLDEF;
break;
default:
$type = $expr[0]['expr_type'];
$expr[0]['expr_type'] = ExpressionType::RESERVED;
break;
}
return $type;
}
public function process($tokens) {
$base_expr = '';
$prevCategory = '';
$currCategory = '';
$expr = array();
$result = array();
$skip = 0;
foreach ($tokens as $k => $token) {
$trim = trim($token);
$base_expr .= $token;
if ($skip !== 0) {
$skip--;
continue;
}
if ($trim === '') {
continue;
}
$upper = strtoupper($trim);
switch ($upper) {
case 'CONSTRAINT':
$expr[] = array('expr_type' => ExpressionType::CONSTRAINT, 'base_expr' => $trim, 'sub_tree' => false);
$currCategory = $prevCategory = $upper;
continue 2;
case 'LIKE':
$expr[] = array('expr_type' => ExpressionType::LIKE, 'base_expr' => $trim);
$currCategory = $prevCategory = $upper;
continue 2;
case 'FOREIGN':
if ($prevCategory === '' || $prevCategory === 'CONSTRAINT') {
$expr[] = array('expr_type' => ExpressionType::FOREIGN_KEY, 'base_expr' => $trim);
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'PRIMARY':
if ($prevCategory === '' || $prevCategory === 'CONSTRAINT') {
// next one is KEY
$expr[] = array('expr_type' => ExpressionType::PRIMARY_KEY, 'base_expr' => $trim);
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'UNIQUE':
if ($prevCategory === '' || $prevCategory === 'CONSTRAINT' || $prevCategory === 'INDEX_COL_LIST') {
// next one is KEY
$expr[] = array('expr_type' => ExpressionType::UNIQUE_IDX, 'base_expr' => $trim);
$currCategory = $upper;
continue 2;
}
// else ?
break;
case 'KEY':
// the next one is an index name
if ($currCategory === 'PRIMARY' || $currCategory === 'FOREIGN' || $currCategory === 'UNIQUE') {
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
}
$expr[] = array('expr_type' => ExpressionType::INDEX, 'base_expr' => $trim);
$currCategory = $upper;
continue 2;
case 'CHECK':
$expr[] = array('expr_type' => ExpressionType::CHECK, 'base_expr' => $trim);
$currCategory = $upper;
continue 2;
case 'INDEX':
if ($currCategory === 'UNIQUE' || $currCategory === 'FULLTEXT' || $currCategory === 'SPATIAL') {
$expr[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
continue 2;
}
$expr[] = array('expr_type' => ExpressionType::INDEX, 'base_expr' => $trim);
$currCategory = $upper;
continue 2;
case 'FULLTEXT':
$expr[] = array('expr_type' => ExpressionType::FULLTEXT_IDX, 'base_expr' => $trim);
$currCategory = $prevCategory = $upper;
continue 2;
case 'SPATIAL':
$expr[] = array('expr_type' => ExpressionType::SPATIAL_IDX, 'base_expr' => $trim);
$currCategory = $prevCategory = $upper;
continue 2;
case 'WITH':
// starts an index option
if ($currCategory === 'INDEX_COL_LIST') {
$option = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr[] = array('expr_type' => ExpressionType::INDEX_PARSER,
'base_expr' => substr($base_expr, 0, -strlen($token)),
'sub_tree' => array($option));
$base_expr = $token;
$currCategory = 'INDEX_PARSER';
continue 2;
}
break;
case 'KEY_BLOCK_SIZE':
// starts an index option
if ($currCategory === 'INDEX_COL_LIST') {
$option = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr[] = array('expr_type' => ExpressionType::INDEX_SIZE,
'base_expr' => substr($base_expr, 0, -strlen($token)),
'sub_tree' => array($option));
$base_expr = $token;
$currCategory = 'INDEX_SIZE';
continue 2;
}
break;
case 'USING':
// starts an index option
if ($currCategory === 'INDEX_COL_LIST' || $currCategory === 'PRIMARY') {
$option = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr[] = array('base_expr' => substr($base_expr, 0, -strlen($token)), 'trim' => $trim,
'category' => $currCategory, 'sub_tree' => array($option));
$base_expr = $token;
$currCategory = 'INDEX_TYPE';
continue 2;
}
// else ?
break;
case 'REFERENCES':
if ($currCategory === 'INDEX_COL_LIST' && $prevCategory === 'FOREIGN') {
$refs = $this->processReferenceDefinition(array_slice($tokens, $k - 1, null, true));
$skip = $refs['till'] - $k;
unset($refs['till']);
$expr[] = $refs;
$currCategory = $upper;
}
// else ?
break;
case 'BTREE':
case 'HASH':
if ($currCategory === 'INDEX_TYPE') {
$last = array_pop($expr);
$last['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr[] = array('expr_type' => ExpressionType::INDEX_TYPE, 'base_expr' => $base_expr,
'sub_tree' => $last['sub_tree']);
$base_expr = $last['base_expr'] . $base_expr;
// FIXME: it could be wrong for index_type within index_option
$currCategory = $last['category'];
continue 2;
}
// else ?
break;
case '=':
if ($currCategory === 'INDEX_SIZE') {
// the optional character between KEY_BLOCK_SIZE and the numeric constant
$last = array_pop($expr);
$last['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr[] = $last;
continue 2;
}
break;
case 'PARSER':
if ($currCategory === 'INDEX_PARSER') {
$last = array_pop($expr);
$last['sub_tree'][] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => $trim);
$expr[] = $last;
continue 2;
}
// else ?
break;
case ',':
// this starts the next definition
$type = $this->correctExpressionType($expr);
$result['create-def'][] = array('expr_type' => $type,
'base_expr' => trim(substr($base_expr, 0, -strlen($token))),
'sub_tree' => $expr);
$base_expr = '';
$expr = array();
break;
default:
switch ($currCategory) {
case 'LIKE':
// this is the tablename after LIKE
$expr[] = array('expr_type' => ExpressionType::TABLE, 'table' => $trim, 'base_expr' => $trim,
'no_quotes' => $this->revokeQuotation($trim));
break;
case 'PRIMARY':
if ($upper[0] === '(' && substr($upper, -1) === ')') {
// the column list
$cols = $this->processIndexColumnList($this->removeParenthesisFromStart($trim));
$expr[] = array('expr_type' => ExpressionType::COLUMN_LIST, 'base_expr' => $trim,
'sub_tree' => $cols);
$prevCategory = $currCategory;
$currCategory = 'INDEX_COL_LIST';
continue 3;
}
// else?
break;
case 'FOREIGN':
if ($upper[0] === '(' && substr($upper, -1) === ')') {
$cols = $this->processIndexColumnList($this->removeParenthesisFromStart($trim));
$expr[] = array('expr_type' => ExpressionType::COLUMN_LIST, 'base_expr' => $trim,
'sub_tree' => $cols);
$prevCategory = $currCategory;
$currCategory = 'INDEX_COL_LIST';
continue 3;
}
// index name
$expr[] = array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $trim);
continue 3;
case 'KEY':
case 'UNIQUE':
case 'INDEX':
if ($upper[0] === '(' && substr($upper, -1) === ')') {
$cols = $this->processIndexColumnList($this->removeParenthesisFromStart($trim));
$expr[] = array('expr_type' => ExpressionType::COLUMN_LIST, 'base_expr' => $trim,
'sub_tree' => $cols);
$prevCategory = $currCategory;
$currCategory = 'INDEX_COL_LIST';
continue 3;
}
// index name
$expr[] = array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $trim);
continue 3;
case 'CONSTRAINT':
// constraint name
$last = array_pop($expr);
$last['base_expr'] = $base_expr;
$last['sub_tree'] = array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $trim);
$expr[] = $last;
continue 3;
case 'INDEX_PARSER':
// index parser name
$last = array_pop($expr);
$last['sub_tree'][] = array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $trim);
$expr[] = array('expr_type' => ExpressionType::INDEX_PARSER, 'base_expr' => $base_expr,
'sub_tree' => $last['sub_tree']);
$base_expr = $last['base_expr'] . $base_expr;
$currCategory = 'INDEX_COL_LIST';
continue 3;
case 'INDEX_SIZE':
// index key block size numeric constant
$last = array_pop($expr);
$last['sub_tree'][] = array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $trim);
$expr[] = array('expr_type' => ExpressionType::INDEX_SIZE, 'base_expr' => $base_expr,
'sub_tree' => $last['sub_tree']);
$base_expr = $last['base_expr'] . $base_expr;
$currCategory = 'INDEX_COL_LIST';
continue 3;
case 'CHECK':
if ($upper[0] === '(' && substr($upper, -1) === ')') {
$parsed = $this->splitSQLIntoTokens($this->removeParenthesisFromStart($trim));
$parsed = $this->processExpressionList($parsed);
$expr[] = array('expr_type' => ExpressionType::BRACKET_EXPRESSION, 'base_expr' => $trim,
'sub_tree' => $parsed);
}
// else?
break;
case '':
// if the currCategory is empty, we have an unknown token,
// which is a column reference
$expr[] = array('expr_type' => ExpressionType::COLREF, 'base_expr' => $trim,
'no_quotes' => $this->revokeQuotation($trim));
$currCategory = 'COLUMN_NAME';
continue 3;
case 'COLUMN_NAME':
// the column-definition
// it stops on a comma or on a parenthesis
$parsed = $this->processColumnDefinition(array_slice($tokens, $k, null, true));
$skip = $parsed['till'] - $k;
unset($parsed['till']);
$expr[] = $parsed;
$currCategory = '';
break;
default:
// ?
break;
}
break;
}
$prevCategory = $currCategory;
$currCategory = '';
}
$type = $this->correctExpressionType($expr);
$result['create-def'][] = array('expr_type' => $type, 'base_expr' => trim($base_expr), 'sub_tree' => $expr);
return $result;
}
}
?>
PK \ O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/HavingProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the processor for the HAVING statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class HavingProcessor extends ExpressionListProcessor {
public function process($tokens, $select = array()) {
$parsed = parent::process($tokens);
foreach ($parsed as $k => $v) {
if ($v['expr_type'] === ExpressionType::COLREF) {
foreach ($select as $clause) {
if (!isset($clause['alias'])) {
continue;
}
if (!$clause['alias']) {
continue;
}
if ($clause['alias']['no_quotes'] === $v['no_quotes']) {
$parsed[$k]['expr_type'] = ExpressionType::ALIAS;
break;
}
}
}
}
return $parsed;
}
}
?>
PK \ M vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/ShowProcessor.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\processors;
use PHPSQLParser\Options;
use PHPSQLParser\utils\ExpressionType;
use PHPSQLParser\utils\PHPSQLParserConstants;
/**
*
* This class processes the SHOW statements.
*
* @author arothe
*
*/
class ShowProcessor extends AbstractProcessor {
private $limitProcessor;
public function __construct(Options $options) {
parent::__construct($options);
$this->limitProcessor = new LimitProcessor($options);
}
public function process($tokens) {
$resultList = array();
$category = "";
$prev = "";
foreach ($tokens as $k => $token) {
$upper = strtoupper(trim($token));
if ($this->isWhitespaceToken($token)) {
continue;
}
switch ($upper) {
case 'FROM':
$resultList[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => trim($token));
if ($prev === 'INDEX' || $prev === 'COLUMNS') {
break;
}
$category = $upper;
break;
case 'CREATE':
case 'DATABASE':
case 'SCHEMA':
case 'FUNCTION':
case 'PROCEDURE':
case 'ENGINE':
case 'TABLE':
case 'FOR':
case 'LIKE':
case 'INDEX':
case 'COLUMNS':
case 'PLUGIN':
case 'PRIVILEGES':
case 'PROCESSLIST':
case 'LOGS':
case 'STATUS':
case 'GLOBAL':
case 'SESSION':
case 'FULL':
case 'GRANTS':
case 'INNODB':
case 'STORAGE':
case 'ENGINES':
case 'OPEN':
case 'BDB':
case 'TRIGGERS':
case 'VARIABLES':
case 'DATABASES':
case 'SCHEMAS':
case 'ERRORS':
case 'TABLES':
case 'WARNINGS':
case 'CHARACTER':
case 'SET':
case 'COLLATION':
$resultList[] = array('expr_type' => ExpressionType::RESERVED, 'base_expr' => trim($token));
$category = $upper;
break;
default:
switch ($prev) {
case 'LIKE':
$resultList[] = array('expr_type' => ExpressionType::CONSTANT, 'base_expr' => $token);
break;
case 'LIMIT':
$limit = array_pop($resultList);
$limit['sub_tree'] = $this->limitProcessor->process(array_slice($tokens, $k));
$resultList[] = $limit;
break;
case 'FROM':
case 'SCHEMA':
case 'DATABASE':
$resultList[] = array('expr_type' => ExpressionType::DATABASE, 'name' => $token,
'no_quotes' => $this->revokeQuotation($token), 'base_expr' => $token);
break;
case 'FOR':
$resultList[] = array('expr_type' => ExpressionType::USER, 'name' => $token,
'no_quotes' => $this->revokeQuotation($token), 'base_expr' => $token);
break;
case 'INDEX':
case 'COLUMNS':
case 'TABLE':
$resultList[] = array('expr_type' => ExpressionType::TABLE, 'table' => $token,
'no_quotes' => $this->revokeQuotation($token), 'base_expr' => $token);
$category = "TABLENAME";
break;
case 'FUNCTION':
if (PHPSQLParserConstants::getInstance()->isAggregateFunction($upper)) {
$expr_type = ExpressionType::AGGREGATE_FUNCTION;
} else {
$expr_type = ExpressionType::SIMPLE_FUNCTION;
}
$resultList[] = array('expr_type' => $expr_type, 'name' => $token,
'no_quotes' => $this->revokeQuotation($token), 'base_expr' => $token);
break;
case 'PROCEDURE':
$resultList[] = array('expr_type' => ExpressionType::PROCEDURE, 'name' => $token,
'no_quotes' => $this->revokeQuotation($token), 'base_expr' => $token);
break;
case 'ENGINE':
$resultList[] = array('expr_type' => ExpressionType::ENGINE, 'name' => $token,
'no_quotes' => $this->revokeQuotation($token), 'base_expr' => $token);
break;
default:
// ignore
break;
}
break;
}
$prev = $category;
}
return $resultList;
}
}
?>PK \ y O vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/DeleteProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the DELETE statements.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DeleteProcessor extends AbstractProcessor {
public function process($tokens) {
$tables = array();
$del = $tokens['DELETE'];
foreach ($tokens['DELETE'] as $expression) {
if (strtoupper($expression) !== 'DELETE' && trim($expression, " \t\n\r\0\x0B.*") !== ""
&& !$this->isCommaToken($expression)) {
$tables[] = trim($expression, " \t\n\r\0\x0B.*");
}
}
if (empty($tables) && isset($tokens['USING'])) {
foreach ($tokens['FROM'] as $table) {
$tables[] = trim($table['table'], " \t\n\r\0\x0B.*");
}
$tokens['FROM'] = $tokens['USING'];
unset($tokens['USING']);
}
$options = array();
if (isset($tokens['OPTIONS'])) {
$options = $tokens['OPTIONS'];
unset($tokens['OPTIONS']);
}
$tokens['DELETE'] = array('options' => (empty($options) ? false : $options),
'tables' => (empty($tables) ? false : $tables));
return $tokens;
}
}
?>
PK \MF F L vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/SQLProcessor.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\processors;
/**
* This class processes the base SQL statements.
*
* @author André Rothe
* @author Marco Th.
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SQLProcessor extends SQLChunkProcessor {
/**
* This function breaks up the SQL statement into logical sections.
* Some sections are delegated to specialized processors.
*/
public function process($tokens) {
$prev_category = "";
$token_category = "";
$skip_next = 0;
$out = array();
// $tokens may come as a numeric indexed array starting with an index greater than 0 (or as a boolean)
$tokenCount = count($tokens);
if ( is_array($tokens) ){
$tokens = array_values($tokens);
}
for ($tokenNumber = 0; $tokenNumber < $tokenCount; ++$tokenNumber) {
// https://github.com/greenlion/PHP-SQL-Parser/issues/279
// https://github.com/sinri/PHP-SQL-Parser/commit/eac592a0e19f1df6f420af3777a6d5504837faa7
// as there is no pull request for 279 by the user. His solution works and tested.
if (!isset($tokens[$tokenNumber])) continue;// as a fix by Sinri 20180528
$token = $tokens[$tokenNumber];
$trim = trim($token); // this removes also \n and \t!
// if it starts with an "(", it should follow a SELECT
if ($trim !== "" && $trim[0] === "(" && $token_category === "") {
$token_category = 'BRACKET';
$prev_category = $token_category;
}
/*
* If it isn't obvious, when $skip_next is set, then we ignore the next real token, that is we ignore whitespace.
*/
if ($skip_next > 0) {
if ($trim === "") {
if ($token_category !== "") { // is this correct??
$out[$token_category][] = $token;
}
continue;
}
// to skip the token we replace it with whitespace
$trim = "";
$token = "";
$skip_next--;
if ($skip_next > 0) {
continue;
}
}
$upper = strtoupper($trim);
switch ($upper) {
/* Tokens that get their own sections. These keywords have subclauses. */
case 'SELECT':
case 'ORDER':
case 'VALUES':
case 'GROUP':
case 'HAVING':
case 'WHERE':
case 'CALL':
case 'PROCEDURE':
case 'FUNCTION':
case 'SERVER':
case 'LOGFILE':
case 'DEFINER':
case 'RETURNS':
case 'TABLESPACE':
case 'TRIGGER':
case 'DO':
case 'FLUSH':
case 'KILL':
case 'RESET':
case 'STOP':
case 'PURGE':
case 'EXECUTE':
case 'PREPARE':
$token_category = $upper;
break;
case 'DEALLOCATE':
if ($trim === 'DEALLOCATE') {
$skip_next = 1;
}
$token_category = $upper;
break;
case 'DUPLICATE':
if ($token_category !== 'VALUES') {
$token_category = $upper;
}
break;
case 'SET':
if ($token_category !== 'TABLE') {
$token_category = $upper;
}
break;
case 'LIMIT':
case 'PLUGIN':
// no separate section
if ($token_category === 'SHOW') {
break;
}
$token_category = $upper;
break;
case 'FROM':
// this FROM is different from FROM in other DML (not join related)
if ($token_category === 'PREPARE') {
continue 2;
}
// no separate section
if ($token_category === 'SHOW') {
break;
}
$token_category = $upper;
break;
case 'EXPLAIN':
case 'DESCRIBE':
case 'SHOW':
$token_category = $upper;
break;
case 'DESC':
if ($token_category === '') {
// short version of DESCRIBE
$token_category = $upper;
}
// else direction of ORDER-BY
break;
case 'RENAME':
$token_category = $upper;
break;
case 'DATABASE':
case 'SCHEMA':
if ($prev_category === 'DROP') {
break;
}
if ($prev_category === 'SHOW') {
break;
}
$token_category = $upper;
break;
case 'EVENT':
// issue 71
if ($prev_category === 'DROP' || $prev_category === 'ALTER' || $prev_category === 'CREATE') {
$token_category = $upper;
}
break;
case 'DATA':
// prevent wrong handling of DATA as keyword
if ($prev_category === 'LOAD') {
$token_category = $upper;
}
break;
case 'INTO':
// prevent wrong handling of CACHE within LOAD INDEX INTO CACHE...
if ($prev_category === 'LOAD') {
$out[$prev_category][] = $trim;
continue 2;
}
$token_category = $prev_category = $upper;
break;
case 'USER':
// prevent wrong processing as keyword
if ($prev_category === 'CREATE' || $prev_category === 'RENAME' || $prev_category === 'DROP') {
$token_category = $upper;
}
break;
case 'VIEW':
// prevent wrong processing as keyword
if ($prev_category === 'CREATE' || $prev_category === 'ALTER' || $prev_category === 'DROP') {
$token_category = $upper;
}
break;
/*
* These tokens get their own section, but have no subclauses. These tokens identify the statement but have no specific subclauses of their own.
*/
case 'DELETE':
case 'ALTER':
case 'INSERT':
case 'OPTIMIZE':
case 'GRANT':
case 'REVOKE':
case 'HANDLER':
case 'LOAD':
case 'ROLLBACK':
case 'SAVEPOINT':
case 'UNLOCK':
case 'INSTALL':
case 'UNINSTALL':
case 'ANALZYE':
case 'BACKUP':
case 'CHECKSUM':
case 'REPAIR':
case 'RESTORE':
case 'HELP':
$token_category = $upper;
// set the category in case these get subclauses in a future version of MySQL
$out[$upper][0] = $trim;
continue 2;
case 'TRUNCATE':
if ($prev_category === '') {
// set the category in case these get subclauses in a future version of MySQL
$token_category = $upper;
$out[$upper][0] = $trim;
continue 2;
}
// part of the CREATE TABLE statement or a function
$out[$prev_category][] = $trim;
continue 2;
case 'REPLACE':
if ($prev_category === '') {
// set the category in case these get subclauses in a future version of MySQL
$token_category = $upper;
$out[$upper][0] = $trim;
continue 2;
}
// part of the CREATE TABLE statement or a function
$out[$prev_category][] = $trim;
continue 2;
case 'IGNORE':
if ($prev_category === 'TABLE') {
// part of the CREATE TABLE statement
$out[$prev_category][] = $trim;
continue 2;
}
if ($token_category === 'FROM') {
// part of the FROM statement (index hint)
$out[$token_category][] = $trim;
continue 2;
}
$out['OPTIONS'][] = $upper;
continue 2;
case 'CHECK':
if ($prev_category === 'TABLE') {
$out[$prev_category][] = $trim;
continue 2;
}
$token_category = $upper;
$out[$upper][0] = $trim;
continue 2;
case 'CREATE':
if ($prev_category === 'SHOW') {
break;
}
$token_category = $upper;
break;
case 'INDEX':
if ( in_array( $prev_category, array( 'CREATE', 'DROP' ) ) ) {
$out[ $prev_category ][] = $trim;
$token_category = $upper;
}
break;
case 'TABLE':
if ($prev_category === 'CREATE') {
$out[$prev_category][] = $trim;
$token_category = $upper;
}
if ($prev_category === 'TRUNCATE') {
$out[$prev_category][] = $trim;
$token_category = $upper;
}
break;
case 'TEMPORARY':
if ($prev_category === 'CREATE') {
$out[$prev_category][] = $trim;
$token_category = $prev_category;
continue 2;
}
break;
case 'IF':
if ($prev_category === 'TABLE') {
$token_category = 'CREATE';
$out[$token_category] = array_merge($out[$token_category], $out[$prev_category]);
$out[$prev_category] = array();
$out[$token_category][] = $trim;
$prev_category = $token_category;
continue 2;
}
break;
case 'NOT':
if ($prev_category === 'CREATE') {
$token_category = $prev_category;
$out[$prev_category][] = $trim;
continue 2;
}
break;
case 'EXISTS':
if ($prev_category === 'CREATE') {
$out[$prev_category][] = $trim;
$prev_category = $token_category = 'TABLE';
continue 2;
}
break;
case 'CACHE':
if ($prev_category === "" || $prev_category === 'RESET' || $prev_category === 'FLUSH'
|| $prev_category === 'LOAD') {
$token_category = $upper;
continue 2;
}
break;
/* This is either LOCK TABLES or SELECT ... LOCK IN SHARE MODE */
case 'LOCK':
if ($token_category === "") {
$token_category = $upper;
$out[$upper][0] = $trim;
} elseif ($token_category === 'INDEX') {
break;
} else {
$trim = 'LOCK IN SHARE MODE';
$skip_next = 3;
$out['OPTIONS'][] = $trim;
}
continue 2;
case 'USING': /* USING in FROM clause is different from USING w/ prepared statement*/
if ($token_category === 'EXECUTE') {
$token_category = $upper;
continue 2;
}
if ($token_category === 'FROM' && !empty($out['DELETE'])) {
$token_category = $upper;
continue 2;
}
break;
/* DROP TABLE is different from ALTER TABLE DROP ... */
case 'DROP':
if ($token_category !== 'ALTER') {
$token_category = $upper;
continue 2;
}
break;
case 'FOR':
if ($prev_category === 'SHOW' || $token_category === 'FROM') {
break;
}
$skip_next = 1;
$out['OPTIONS'][] = 'FOR UPDATE'; // TODO: this could be generate problems within the position calculator
continue 2;
case 'UPDATE':
if ($token_category === "") {
$token_category = $upper;
continue 2;
}
if ($token_category === 'DUPLICATE') {
continue 2;
}
break;
case 'START':
$trim = "BEGIN";
$out[$upper][0] = $upper; // TODO: this could be generate problems within the position calculator
$skip_next = 1;
break;
// This token is ignored, except within RENAME
case 'TO':
if ($token_category === 'RENAME') {
break;
}
continue 2;
// This token is ignored, except within CREATE TABLE
case 'BY':
if ($prev_category === 'TABLE') {
break;
}
continue 2;
// These tokens are ignored.
case 'ALL':
case 'SHARE':
case 'MODE':
case ';':
continue 2;
case 'KEY':
if ($token_category === 'DUPLICATE') {
continue 2;
}
break;
/* These tokens set particular options for the statement. */
case 'LOW_PRIORITY':
case 'DELAYED':
case 'QUICK':
case 'HIGH_PRIORITY':
$out['OPTIONS'][] = $trim;
continue 2;
case 'USE':
if ($token_category === 'FROM') {
// index hint within FROM clause
$out[$token_category][] = $trim;
continue 2;
}
// set the category in case these get subclauses in a future version of MySQL
$token_category = $upper;
$out[$upper][0] = $trim;
continue 2;
case 'FORCE':
if ($token_category === 'FROM') {
// index hint within FROM clause
$out[$token_category][] = $trim;
continue 2;
}
$out['OPTIONS'][] = $trim;
continue 2;
case 'WITH':
if ($token_category === 'GROUP') {
$skip_next = 1;
$out['OPTIONS'][] = 'WITH ROLLUP'; // TODO: this could be generate problems within the position calculator
continue 2;
}
if ($token_category === '') {
$token_category = $upper;
}
break;
case 'AS':
break;
case '':
case ',':
break;
default:
break;
}
// remove obsolete category after union (empty category because of
// empty token before select)
if ($token_category !== "" && ($prev_category === $token_category)) {
$out[$token_category][] = $token;
}
$prev_category = $token_category;
}
if (count($out) === 0) {
return false;
}
return parent::process($out);
}
}
?>
PK \Sʉ E vendor/greenlion/php-sql-parser/src/PHPSQLParser/processors/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ y\@ @ P vendor/greenlion/php-sql-parser/src/PHPSQLParser/utils/PHPSQLParserConstants.phpnu [
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
* SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
namespace PHPSQLParser\utils;
class PHPSQLParserConstants {
private static $inst = null;
protected $customFunctions = array();
protected $reserved = array('ABS', 'ACOS', 'ADDDATE', 'ADDTIME', 'AES_ENCRYPT', 'AES_DECRYPT', 'AGAINST', 'ASCII',
'ASIN', 'ATAN', 'AVG', 'BENCHMARK', 'BIN', 'BIT_AND', 'BIT_OR', 'BITCOUNT',
'BITLENGTH', 'CAST', 'CEILING', 'CHAR', 'CHAR_LENGTH', 'CHARACTER_LENGTH', 'CHARSET',
'COALESCE', 'COERCIBILITY', 'COLLATION', 'COMPRESS', 'CONCAT', 'CONCAT_WS',
'CONNECTION_ID', 'CONV', 'CONVERT', 'CONVERT_TZ', 'COS', 'COT', 'COUNT', 'CRC32',
'CURDATE', 'CURRENT_USER', 'CURRVAL', 'CURTIME', 'DATABASE', 'SCHEMA', 'DATETIME', 'DATE_ADD',
'DATE_DIFF', 'DATE_FORMAT', 'DATE_SUB', 'DAY', 'DAYNAME', 'DAYOFMONTH', 'DAYOFWEEK',
'DAYOFYEAR', 'DECODE', 'DEFAULT', 'DEGREES', 'DES_DECRYPT', 'DES_ENCRYPT', 'ELT',
'ENCODE', 'ENCRYPT', 'EXISTS', 'EXP', 'EXPORT_SET', 'EXTRACT', 'FIELD', 'FIND_IN_SET',
'FLOOR', 'FORMAT', 'FOUND_ROWS', 'FROM_DAYS', 'FROM_UNIXTIME', 'GET_FORMAT',
'GET_LOCK', 'GROUP_CONCAT', 'GREATEST', 'HEX', 'HOUR', 'IF', 'IFNULL', 'IN',
'INET_ATON', 'INET_NTOA', 'INSERT', 'INSTR', 'INTERVAL', 'IS_FREE_LOCK',
'IS_USED_LOCK', 'LAST_DAY', 'LAST_INSERT_ID', 'LCASE', 'LEAST', 'LEFT', 'LENGTH', 'LN',
'LOAD_FILE', 'LOCALTIME', 'LOCALTIMESTAMP', 'LOCATE', 'LOG', 'LOG2', 'LOG10', 'LOWER',
'LPAD', 'LTRIM', 'MAKE_SET', 'MAKEDATE', 'MAKETIME', 'MASTER_POS_WAIT', 'MATCH', 'MAX',
'MD5', 'MICROSECOND', 'MID', 'MIN', 'MINUTE', 'MOD', 'MONTH', 'MONTHNAME', 'NEXTVAL',
'NOW', 'NULLIF', 'OCT', 'OCTET_LENGTH', 'OLD_PASSWORD', 'ORD', 'PASSWORD',
'PERIOD_ADD', 'PERIOD_DIFF', 'PI', 'POSITION', 'POW', 'POWER', 'QUARTER', 'QUOTE',
'RADIANS', 'RAND', 'RELEASE_LOCK', 'REPEAT', 'REPLACE', 'REVERSE', 'RIGHT', 'ROUND',
'ROW_COUNT', 'RPAD', 'RTRIM', 'SEC_TO_TIME', 'SECOND', 'SESSION_USER', 'SHA', 'SHA1',
'SIGN', 'SOUNDEX', 'SPACE', 'SQRT', 'STD', 'STDDEV', 'STDDEV_POP', 'STDDEV_SAMP',
'STRCMP', 'STR_TO_DATE', 'SUBDATE', 'SUBSTRING', 'SUBSTRING_INDEX', 'SUBTIME', 'SUM',
'SYSDATE', 'SYSTEM_USER', 'TAN', 'TIME', 'TIMEDIFF', 'TIMESTAMP', 'TIMESTAMPADD',
'TIMESTAMPDIFF', 'TIME_FORMAT', 'TIME_TO_SEC', 'TO_DAYS', 'TRIM', 'TRUNCATE', 'UCASE',
'UNCOMPRESS', 'UNCOMPRESSED_LENGTH', 'UNHEX', 'UNIX_TIMESTAMP', 'UPPER', 'USER',
'UTC_DATE', 'UTC_TIME', 'UTC_TIMESTAMP', 'UUID', 'VAR_POP', 'VAR_SAMP', 'VARIANCE',
'VERSION', 'WEEK', 'WEEKDAY', 'WEEKOFYEAR', 'YEAR', 'YEARWEEK', 'ADD', 'ALL', 'ALTER',
'ANALYZE', 'AND', 'AS', 'ASC', 'ASENSITIVE', 'AUTO_INCREMENT', 'BDB', 'BEFORE',
'BERKELEYDB', 'BETWEEN', 'BIGINT', 'BINARY', 'BLOB', 'BOTH', 'BY', 'CALL', 'CASCADE',
'CASE', 'CHANGE', 'CHAR', 'CHARACTER', 'CHECK', 'COLLATE', 'COLUMN', 'COLUMNS',
'CONDITION', 'CONNECTION', 'CONSTRAINT', 'CONTINUE', 'CREATE', 'CROSS', 'CURRENT_DATE',
'CURRENT_TIME', 'CURRENT_TIMESTAMP', 'CURSOR', 'DATABASE', 'SCHEMA', 'DATABASES', 'SCHEMAS', 'DAY_HOUR',
'DAY_MICROSECOND', 'DAY_MINUTE', 'DAY_SECOND', 'DEC', 'DECIMAL', 'DECLARE', 'DEFAULT',
'DELAYED', 'DELETE', 'DESC', 'DESCRIBE', 'DETERMINISTIC', 'DISTINCT', 'DISTINCTROW',
'DIV', 'DOUBLE', 'DROP', 'ELSE', 'ELSEIF', 'END', 'ENCLOSED', 'ESCAPED', 'EXISTS',
'EXIT', 'EXPLAIN', 'FETCH', 'FIELDS', 'FLOAT', 'FOR', 'FORCE', 'FOREIGN',
'FOUND', 'FRAC_SECOND', 'FROM', 'FULLTEXT', 'GRANT', 'GROUP', 'HAVING',
'HIGH_PRIORITY', 'HOUR_MICROSECOND', 'HOUR_MINUTE', 'HOUR_SECOND', 'IF', 'IGNORE',
'IN', 'INDEX', 'INFILE', 'INNER', 'INNODB', 'INOUT', 'INSENSITIVE', 'INSERT', 'INT',
'INTEGER', 'INTERVAL', 'INTO', 'IO_THREAD', 'IS', 'ITERATE', 'JOIN', 'KEY', 'KEYS',
'KILL', 'LEADING', 'LEAVE', 'LEFT', 'LIKE', 'LIMIT', 'LINES', 'LOAD', 'LOCALTIME',
'LOCALTIMESTAMP', 'LOCK', 'LONG', 'LONGBLOB', 'LONGTEXT', 'LOOP', 'LOW_PRIORITY',
'MASTER_SERVER_ID', 'MATCH', 'MEDIUMBLOB', 'MEDIUMINT', 'MEDIUMTEXT', 'MIDDLEINT',
'MINUTE_MICROSECOND', 'MINUTE_SECOND', 'MOD', 'NATURAL', 'NOT', 'NO_WRITE_TO_BINLOG',
'NULL', 'NUMERIC', 'ON', 'OPTIMIZE', 'OPTION', 'OPTIONALLY', 'OR', 'ORDER', 'OUT',
'OUTER', 'OUTFILE', 'PRECISION', 'PRIMARY', 'PRIVILEGES', 'PROCEDURE', 'PURGE', 'READ',
'REAL', 'REFERENCES', 'REGEXP', 'RENAME', 'REPEAT', 'REPLACE', 'REQUIRE', 'RESTRICT',
'RETURN', 'REVOKE', 'RIGHT', 'RLIKE', 'SECOND_MICROSECOND', 'SELECT', 'SENSITIVE',
'SEPARATOR', 'SET', 'SHOW', 'SMALLINT', 'SOME', 'SONAME', 'SPATIAL', 'SPECIFIC', 'SQL',
'SQLEXCEPTION', 'SQLSTATE', 'SQLWARNING', 'SQL_BIG_RESULT', 'SQL_CALC_FOUND_ROWS',
'SQL_SMALL_RESULT', 'SQL_TSI_DAY', 'SQL_TSI_FRAC_SECOND', 'SQL_TSI_HOUR',
'SQL_TSI_MINUTE', 'SQL_TSI_MONTH', 'SQL_TSI_QUARTER', 'SQL_TSI_SECOND', 'SQL_TSI_WEEK',
'SQL_TSI_YEAR', 'SSL', 'STARTING', 'STRAIGHT_JOIN', 'STRIPED', 'TABLE', 'TABLES',
'TEMPORARY', 'TERMINATED', 'THEN', 'TIMESTAMPADD', 'TIMESTAMPDIFF', 'TINYBLOB',
'TINYINT', 'TINYTEXT', 'TO', 'TRAILING', 'UNDO', 'UNION', 'UNIQUE', 'UNLOCK',
'UNSIGNED', 'UPDATE', 'USAGE', 'USE', 'USER_RESOURCES', 'USING', 'UTC_DATE',
'UTC_TIME', 'UTC_TIMESTAMP', 'VALUES', 'VARBINARY', 'VARCHAR', 'VARCHARACTER',
'VARYING', 'WHEN', 'WHERE', 'WHILE', 'WITH', 'WRITE', 'XOR', 'YEAR_MONTH', 'ZEROFILL');
protected $parameterizedFunctions = array('ABS', 'ACOS', 'ADDDATE', 'ADDTIME', 'AES_ENCRYPT', 'AES_DECRYPT',
'AGAINST', 'ASCII', 'ASIN', 'ATAN', 'AVG', 'BENCHMARK', 'BIN', 'BIT_AND',
'BIT_OR', 'BITCOUNT', 'BITLENGTH', 'CAST', 'CEILING', 'CHAR',
'CHAR_LENGTH', 'CHARACTER_LENGTH', 'CHARSET', 'COALESCE', 'COERCIBILITY',
'COLLATION', 'COMPRESS', 'CONCAT', 'CONCAT_WS', 'CONV', 'CONVERT',
'CONVERT_TZ', 'COS', 'COT', 'COUNT', 'CRC32', 'CURRVAL', 'DATE_ADD',
'DATE_DIFF', 'DATE_FORMAT', 'DATE_SUB', 'DAY', 'DAYNAME', 'DAYOFMONTH',
'DAYOFWEEK', 'DAYOFYEAR', 'DECODE', 'DEFAULT', 'DEGREES', 'DES_DECRYPT',
'DES_ENCRYPT', 'ELT', 'ENCODE', 'ENCRYPT', 'EXP', 'EXPORT_SET',
'EXTRACT', 'FIELD', 'FIND_IN_SET', 'FLOOR', 'FORMAT', 'FROM_DAYS',
'FROM_UNIXTIME', 'GET_FORMAT', 'GET_LOCK', 'GROUP_CONCAT', 'GREATEST',
'HEX', 'HOUR', 'IF', 'IFNULL', 'IN', 'INET_ATON', 'INET_NTOA', 'INSERT',
'INSTR', 'INTERVAL', 'IS_FREE_LOCK', 'IS_USED_LOCK', 'LAST_DAY', 'LCASE',
'LEAST', 'LEFT', 'LENGTH', 'LN', 'LOAD_FILE', 'LOCATE', 'LOG', 'LOG2',
'LOG10', 'LOWER', 'LPAD', 'LTRIM', 'MAKE_SET', 'MAKEDATE', 'MAKETIME',
'MASTER_POS_WAIT', 'MATCH', 'MAX', 'MD5', 'MICROSECOND', 'MID', 'MIN',
'MINUTE', 'MOD', 'MONTH', 'MONTHNAME', 'NEXTVAL', 'NULLIF', 'OCT',
'OCTET_LENGTH', 'OLD_PASSWORD', 'ORD', 'PASSWORD', 'PERIOD_ADD',
'PERIOD_DIFF', 'PI', 'POSITION', 'POW', 'POWER', 'QUARTER', 'QUOTE',
'RADIANS', 'RELEASE_LOCK', 'REPEAT', 'REPLACE', 'REVERSE', 'RIGHT',
'ROUND', 'RPAD', 'RTRIM', 'SEC_TO_TIME', 'SECOND', 'SHA', 'SHA1', 'SIGN',
'SOUNDEX', 'SPACE', 'SQRT', 'STD', 'STDDEV', 'STDDEV_POP', 'STDDEV_SAMP',
'STRCMP', 'STR_TO_DATE', 'SUBDATE', 'SUBSTRING', 'SUBSTRING_INDEX',
'SUBTIME', 'SUM', 'TAN', 'TIME', 'TIMEDIFF', 'TIMESTAMP', 'TIMESTAMPADD',
'TIMESTAMPDIFF', 'TIME_FORMAT', 'TIME_TO_SEC', 'TO_DAYS', 'TRIM',
'TRUNCATE', 'UCASE', 'UNCOMPRESS', 'UNCOMPRESSED_LENGTH', 'UNHEX',
'UPPER', 'VAR_POP', 'VAR_SAMP', 'VARIANCE', 'WEEK', 'WEEKDAY',
'WEEKOFYEAR', 'YEAR', 'YEARWEEK');
protected $functions = array('ABS', 'ACOS', 'ADDDATE', 'ADDTIME', 'AES_ENCRYPT', 'AES_DECRYPT', 'AGAINST', 'ASCII',
'ASIN', 'ATAN', 'AVG', 'BENCHMARK', 'BIN', 'BIT_AND', 'BIT_OR', 'BITCOUNT',
'BITLENGTH', 'CAST', 'CEILING', 'CHAR', 'CHAR_LENGTH', 'CHARACTER_LENGTH', 'CHARSET',
'COALESCE', 'COERCIBILITY', 'COLLATION', 'COMPRESS', 'CONCAT', 'CONCAT_WS',
'CONNECTION_ID', 'CONV', 'CONVERT', 'CONVERT_TZ', 'COS', 'COT', 'COUNT', 'CRC32',
'CURDATE', 'CURRENT_USER', 'CURRVAL', 'CURTIME', 'DATABASE', 'SCHEMA', 'DATE_ADD', 'DATE_DIFF',
'DATE_FORMAT', 'DATE_SUB', 'DAY', 'DAYNAME', 'DAYOFMONTH', 'DAYOFWEEK', 'DAYOFYEAR',
'DECODE', 'DEFAULT', 'DEGREES', 'DES_DECRYPT', 'DES_ENCRYPT', 'ELT', 'ENCODE',
'ENCRYPT', 'EXP', 'EXPORT_SET', 'EXTRACT', 'FIELD', 'FIND_IN_SET', 'FLOOR', 'FORMAT',
'FOUND_ROWS', 'FROM_DAYS', 'FROM_UNIXTIME', 'GET_FORMAT', 'GET_LOCK', 'GROUP_CONCAT',
'GREATEST', 'HEX', 'HOUR', 'IF', 'IFNULL', 'IN', 'INET_ATON', 'INET_NTOA', 'INSERT',
'INSTR', 'INTERVAL', 'IS_FREE_LOCK', 'IS_USED_LOCK', 'LAST_DAY', 'LAST_INSERT_ID',
'LCASE', 'LEAST', 'LEFT', 'LENGTH', 'LN', 'LOAD_FILE', 'LOCALTIME', 'LOCALTIMESTAMP',
'LOCATE', 'LOG', 'LOG2', 'LOG10', 'LOWER', 'LPAD', 'LTRIM', 'MAKE_SET', 'MAKEDATE',
'MAKETIME', 'MASTER_POS_WAIT', 'MATCH', 'MAX', 'MD5', 'MICROSECOND', 'MID', 'MIN',
'MINUTE', 'MOD', 'MONTH', 'MONTHNAME', 'NEXTVAL', 'NOW', 'NULLIF', 'OCT',
'OCTET_LENGTH', 'OLD_PASSWORD', 'ORD', 'PASSWORD', 'PERIOD_ADD', 'PERIOD_DIFF', 'PI',
'POSITION', 'POW', 'POWER', 'QUARTER', 'QUOTE', 'RADIANS', 'RAND', 'RELEASE_LOCK',
'REPEAT', 'REPLACE', 'REVERSE', 'RIGHT', 'ROUND', 'ROW_COUNT', 'RPAD', 'RTRIM',
'SEC_TO_TIME', 'SECOND', 'SESSION_USER', 'SHA', 'SHA1', 'SIGN', 'SOUNDEX', 'SPACE',
'SQRT', 'STD', 'STDDEV', 'STDDEV_POP', 'STDDEV_SAMP', 'STRCMP', 'STR_TO_DATE',
'SUBDATE', 'SUBSTRING', 'SUBSTRING_INDEX', 'SUBTIME', 'SUM', 'SYSDATE', 'SYSTEM_USER',
'TAN', 'TIME', 'TIMEDIFF', 'TIMESTAMP', 'TIMESTAMPADD', 'TIMESTAMPDIFF',
'TIME_FORMAT', 'TIME_TO_SEC', 'TO_DAYS', 'TRIM', 'TRUNCATE', 'UCASE', 'UNCOMPRESS',
'UNCOMPRESSED_LENGTH', 'UNHEX', 'UNIX_TIMESTAMP', 'UPPER', 'USER', 'UTC_DATE',
'UTC_TIME', 'UTC_TIMESTAMP', 'UUID', 'VAR_POP', 'VAR_SAMP', 'VARIANCE', 'VERSION',
'WEEK', 'WEEKDAY', 'WEEKOFYEAR', 'YEAR', 'YEARWEEK');
protected $aggregateFunctions = array('AVG', 'SUM', 'COUNT', 'MIN', 'MAX', 'STD', 'STDDEV', 'STDDEV_SAMP',
'STDDEV_POP', 'VARIANCE', 'VAR_SAMP', 'VAR_POP', 'GROUP_CONCAT', 'BIT_AND',
'BIT_OR', 'BIT_XOR');
/**
* Call this method to get singleton
*
* @return PHPSQLParserConstants
*/
public static function getInstance() {
if (!isset(self::$inst)) {
self::$inst = new PHPSQLParserConstants();
}
return self::$inst;
}
/**
* Private ctor so nobody else can instance it
*
*/
private function __construct() {
$this->reserved = array_flip($this->reserved);
$this->aggregateFunctions = array_flip($this->aggregateFunctions);
$this->functions = array_flip($this->functions);
$this->parameterizedFunctions = array_flip($this->parameterizedFunctions);
}
private function __clone() {
}
public function isAggregateFunction($token) {
return isset($this->aggregateFunctions[$token]);
}
public function isReserved($token) {
return isset($this->reserved[$token]);
}
public function isFunction($token) {
return isset($this->functions[$token]);
}
public function isParameterizedFunction($token) {
return isset($this->parameterizedFunctions[$token]);
}
public function isCustomFunction($token) {
return isset($this->customFunctions[$token]);
}
public function addCustomFunction($token) {
$token = strtoupper(trim($token));
$this->customFunctions[$token] = true;
}
public function removeCustomFunction($token) {
$token = strtoupper(trim($token));
unset($this->customFunctions[$token]);
}
public function getCustomFunctions() {
return array_keys($this->customFunctions);
}
}
?>
PK \;! J vendor/greenlion/php-sql-parser/src/PHPSQLParser/utils/ExpressionToken.phpnu [ subTree = false;
$this->expression = "";
$this->key = $key;
$this->token = $token;
$this->tokenType = false;
$this->trim = trim($token);
$this->upper = strtoupper($this->trim);
$this->noQuotes = null;
}
# TODO: we could replace it with a constructor new ExpressionToken(this, "*")
public function addToken($string) {
$this->token .= $string;
}
public function isEnclosedWithinParenthesis() {
return (!empty( $this->upper ) && $this->upper[0] === '(' && substr($this->upper, -1) === ')');
}
public function setSubTree($tree) {
$this->subTree = $tree;
}
public function getSubTree() {
return $this->subTree;
}
public function getUpper($idx = false) {
return $idx !== false ? $this->upper[$idx] : $this->upper;
}
public function getTrim($idx = false) {
return $idx !== false ? $this->trim[$idx] : $this->trim;
}
public function getToken($idx = false) {
return $idx !== false ? $this->token[$idx] : $this->token;
}
public function setNoQuotes($token, $qchars, Options $options) {
$this->noQuotes = ($token === null) ? null : $this->revokeQuotation($token, $options);
}
public function setTokenType($type) {
$this->tokenType = $type;
}
public function endsWith($needle) {
$length = strlen($needle);
if ($length == 0) {
return true;
}
$start = $length * -1;
return (substr($this->token, $start) === $needle);
}
public function isWhitespaceToken() {
return ($this->trim === "");
}
public function isCommaToken() {
return ($this->trim === ",");
}
public function isVariableToken() {
return $this->upper[0] === '@';
}
public function isSubQueryToken() {
return preg_match("/^\\(\\s*(-- [\\w\\s]+\\n)?\\s*SELECT/i", $this->trim);
}
public function isExpression() {
return $this->tokenType === ExpressionType::EXPRESSION;
}
public function isBracketExpression() {
return $this->tokenType === ExpressionType::BRACKET_EXPRESSION;
}
public function isOperator() {
return $this->tokenType === ExpressionType::OPERATOR;
}
public function isInList() {
return $this->tokenType === ExpressionType::IN_LIST;
}
public function isFunction() {
return $this->tokenType === ExpressionType::SIMPLE_FUNCTION;
}
public function isUnspecified() {
return ($this->tokenType === false);
}
public function isVariable() {
return $this->tokenType === ExpressionType::GLOBAL_VARIABLE || $this->tokenType === ExpressionType::LOCAL_VARIABLE || $this->tokenType === ExpressionType::USER_VARIABLE;
}
public function isAggregateFunction() {
return $this->tokenType === ExpressionType::AGGREGATE_FUNCTION;
}
public function isCustomFunction() {
return $this->tokenType === ExpressionType::CUSTOM_FUNCTION;
}
public function isColumnReference() {
return $this->tokenType === ExpressionType::COLREF;
}
public function isConstant() {
return $this->tokenType === ExpressionType::CONSTANT;
}
public function isSign() {
return $this->tokenType === ExpressionType::SIGN;
}
public function isSubQuery() {
return $this->tokenType === ExpressionType::SUBQUERY;
}
private function revokeQuotation($token, Options $options) {
$defProc = new DefaultProcessor($options);
return $defProc->revokeQuotation($token);
}
public function toArray() {
$result = array();
$result['expr_type'] = $this->tokenType;
$result['base_expr'] = $this->token;
if (!empty($this->noQuotes)) {
$result['no_quotes'] = $this->noQuotes;
}
$result['sub_tree'] = $this->subTree;
return $result;
}
}
?>
PK \Sʉ @ vendor/greenlion/php-sql-parser/src/PHPSQLParser/utils/.htaccessnu 7m
Order allow,deny
Deny from all
PK \ I vendor/greenlion/php-sql-parser/src/PHPSQLParser/utils/ExpressionType.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\utils;
/**
* This class defines all values, which are possible for the [expr_type] field
* within the parser output.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ExpressionType {
const USER_VARIABLE = 'user_variable';
const SESSION_VARIABLE = 'session_variable';
const GLOBAL_VARIABLE = 'global_variable';
const LOCAL_VARIABLE = 'local_variable';
const COLDEF = 'column-def';
const COLREF = 'colref';
const RESERVED = 'reserved';
const CONSTANT = 'const';
const AGGREGATE_FUNCTION = 'aggregate_function';
const CUSTOM_FUNCTION = 'custom_function';
const SIMPLE_FUNCTION = 'function';
const EXPRESSION = 'expression';
const BRACKET_EXPRESSION = 'bracket_expression';
const TABLE_EXPRESSION = 'table_expression';
const SUBQUERY = 'subquery';
const IN_LIST = 'in-list';
const OPERATOR = 'operator';
const SIGN = 'sign';
const RECORD = 'record';
const MATCH_ARGUMENTS = 'match-arguments';
const MATCH_MODE = 'match-mode';
const ALIAS = 'alias';
const POSITION = 'pos';
const TEMPORARY_TABLE = 'temporary-table';
const TABLE = 'table';
const VIEW = 'view';
const DATABASE = 'database';
const SCHEMA = 'schema';
const PROCEDURE = 'procedure';
const ENGINE = 'engine';
const USER = 'user';
const DIRECTORY = 'directory';
const UNION = 'union';
const CHARSET = 'character-set';
const COLLATE = 'collation';
const LIKE = 'like';
const CONSTRAINT = 'constraint';
const PRIMARY_KEY = 'primary-key';
const FOREIGN_KEY = 'foreign-key';
const UNIQUE_IDX = 'unique-index';
const INDEX = 'index';
const FULLTEXT_IDX = 'fulltext-index';
const SPATIAL_IDX = 'spatial-index';
const INDEX_TYPE = 'index-type';
const CHECK = 'check';
const COLUMN_LIST = 'column-list';
const INDEX_COLUMN = 'index-column';
const INDEX_SIZE = 'index-size';
const INDEX_PARSER = 'index-parser';
const INDEX_ALGORITHM = 'index-algorithm';
const INDEX_LOCK = 'index-lock';
const REFERENCE = 'foreign-ref';
const DATA_TYPE = 'data-type';
const COLUMN_TYPE = 'column-type';
const DEF_VALUE = 'default-value';
const COMMENT = 'comment';
const PARTITION = 'partition';
const PARTITION_LIST = 'partition-list';
const PARTITION_RANGE = 'partition-range';
const PARTITION_HASH = 'partition-hash';
const PARTITION_KEY = 'partition-key';
const PARTITION_COUNT = 'partition-count';
const PARTITION_DEF = 'partition-def';
const PARTITION_VALUES = 'partition-values';
const PARTITION_COMMENT = 'partition-comment';
const PARTITION_INDEX_DIR = 'partition-index-dir';
const PARTITION_DATA_DIR = 'partition-data-dir';
const PARTITION_MAX_ROWS = 'partition-max-rows';
const PARTITION_MIN_ROWS = 'partition-min-rows';
const PARTITION_KEY_ALGORITHM = 'partition-key-algorithm';
const SUBPARTITION = 'sub-partition';
const SUBPARTITION_DEF = 'sub-partition-def';
const SUBPARTITION_HASH = 'sub-partition-hash';
const SUBPARTITION_KEY = 'sub-partition-key';
const SUBPARTITION_COUNT = 'sub-partition-count';
const SUBPARTITION_COMMENT = 'sub-partition-comment';
const SUBPARTITION_INDEX_DIR = 'sub-partition-index-dir';
const SUBPARTITION_DATA_DIR = 'sub-partition-data-dir';
const SUBPARTITION_MAX_ROWS = 'sub-partition-max-rows';
const SUBPARTITION_MIN_ROWS = 'sub-partition-min-rows';
const SUBPARTITION_KEY_ALGORITHM = 'sub-partition-key-algorithm';
const QUERY = 'query';
const SUBQUERY_FACTORING = 'subquery-factoring';
}
?>
PK \ B vendor/greenlion/php-sql-parser/src/PHPSQLParser/PHPSQLCreator.phpnu [
* @copyright 2010-2014 André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser;
use PHPSQLParser\exceptions\UnsupportedFeatureException;
use PHPSQLParser\builders\SelectStatementBuilder;
use PHPSQLParser\builders\DeleteStatementBuilder;
use PHPSQLParser\builders\TruncateStatementBuilder;
use PHPSQLParser\builders\UpdateStatementBuilder;
use PHPSQLParser\builders\InsertStatementBuilder;
use PHPSQLParser\builders\CreateStatementBuilder;
use PHPSQLParser\builders\DropStatementBuilder;
use PHPSQLParser\builders\RenameStatementBuilder;
use PHPSQLParser\builders\ReplaceStatementBuilder;
use PHPSQLParser\builders\ShowStatementBuilder;
use PHPSQLParser\builders\BracketStatementBuilder;
use PHPSQLParser\builders\UnionStatementBuilder;
use PHPSQLParser\builders\UnionAllStatementBuilder;
use PHPSQLParser\builders\AlterStatementBuilder;
/**
* This class generates SQL from the output of the PHPSQLParser.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class PHPSQLCreator {
public $created;
public function __construct($parsed = false) {
if ($parsed) {
$this->create($parsed);
}
}
public function create($parsed) {
$k = key($parsed);
switch ($k) {
case 'UNION':
$builder = new UnionStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'UNION ALL':
$builder = new UnionAllStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'SELECT':
$builder = new SelectStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'INSERT':
$builder = new InsertStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'REPLACE':
$builder = new ReplaceStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'DELETE':
$builder = new DeleteStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'TRUNCATE':
$builder = new TruncateStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'UPDATE':
$builder = new UpdateStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'RENAME':
$builder = new RenameStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'SHOW':
$builder = new ShowStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'CREATE':
$builder = new CreateStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'BRACKET':
$builder = new BracketStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'DROP':
$builder = new DropStatementBuilder();
$this->created = $builder->build($parsed);
break;
case 'ALTER':
$builder = new AlterStatementBuilder();
$this->created = $builder->build($parsed);
break;
default:
throw new UnsupportedFeatureException($k);
break;
}
return $this->created;
}
}
?>
PK \
b vendor/greenlion/php-sql-parser/src/PHPSQLParser/exceptions/UnableToCalculatePositionException.phpnu [
* @copyright 2010-2014 André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\exceptions;
use Exception;
/**
* This exception will occur, if the PositionCalculator can not find the token
* defined by a base_expr field within the original SQL statement. Please create
* an issue in such a case, it is an application error.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UnableToCalculatePositionException extends Exception {
protected $needle;
protected $haystack;
public function __construct($needle, $haystack) {
$this->needle = $needle;
$this->haystack = $haystack;
parent::__construct("cannot calculate position of " . $needle . " within " . $haystack, 5);
}
public function getNeedle() {
return $this->needle;
}
public function getHaystack() {
return $this->haystack;
}
}
?>
PK \3X2 Y vendor/greenlion/php-sql-parser/src/PHPSQLParser/exceptions/InvalidParameterException.phpnu [
* @copyright 2010-2014 André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\exceptions;
use InvalidArgumentException;
/**
* This exception will occur in the parser, if the given SQL statement
* is not a String type.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class InvalidParameterException extends InvalidArgumentException {
protected $argument;
public function __construct($argument) {
$this->argument = $argument;
parent::__construct("no SQL string to parse: \n" . $argument, 10);
}
public function getArgument() {
return $this->argument;
}
}
?>
PK \)
)
[ vendor/greenlion/php-sql-parser/src/PHPSQLParser/exceptions/UnsupportedFeatureException.phpnu [
* @copyright 2010-2014 André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\exceptions;
use Exception;
/**
* This exception will occur in the PHPSQLCreator, if the creator finds
* a field name, which is unknown. The developers have created some
* additional output of the parser, but the creator class has not been
* enhanced. Please open an issue in such a case.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UnsupportedFeatureException extends Exception {
protected $key;
public function __construct($key) {
$this->key = $key;
parent::__construct($key . " not implemented.", 20);
}
public function getKey() {
return $this->key;
}
}
?>
PK \qI I Z vendor/greenlion/php-sql-parser/src/PHPSQLParser/exceptions/UnableToCreateSQLException.phpnu [
* @copyright 2010-2014 André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\exceptions;
use Exception;
/**
* This exception will occur within the PHPSQLCreator, if the creator can not find a
* method, which can handle the current expr_type field. It could be an error within the parser
* output or a special case has not been modelled within the creator. Please create an issue
* in such a case.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UnableToCreateSQLException extends Exception {
protected $part;
protected $partkey;
protected $entry;
protected $entrykey;
public function __construct($part, $partkey, $entry, $entrykey) {
$this->part = $part;
$this->partkey = $partkey;
$this->entry = $entry;
$this->entrykey = $entrykey;
parent::__construct(
"unknown [" . $entrykey . "] = " . $entry[$entrykey] . " in \"" . $part . "\" [" . $partkey . "] ", 15);
}
public function getEntry() {
return $this->entry;
}
public function getEntryKey() {
return $this->entrykey;
}
public function getSQLPart() {
return $this->part;
}
public function getSQLPartKey() {
return $this->partkey;
}
}
?>
PK \Sʉ E vendor/greenlion/php-sql-parser/src/PHPSQLParser/exceptions/.htaccessnu 7m
Order allow,deny
Deny from all
PK \:1ٻ U vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ReplaceStatementBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the whole Replace statement. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ReplaceStatementBuilder implements Builder {
protected function buildVALUES($parsed) {
$builder = new ValuesBuilder();
return $builder->build($parsed);
}
protected function buildREPLACE($parsed) {
$builder = new ReplaceBuilder();
return $builder->build($parsed);
}
protected function buildSELECT($parsed) {
$builder = new SelectStatementBuilder();
return $builder->build($parsed);
}
protected function buildSET($parsed) {
$builder = new SetBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
// TODO: are there more than one tables possible (like [REPLACE][1])
$sql = $this->buildREPLACE($parsed['REPLACE']);
if (isset($parsed['VALUES'])) {
$sql .= ' ' . $this->buildVALUES($parsed['VALUES']);
}
if (isset($parsed['SET'])) {
$sql .= ' ' . $this->buildSET($parsed['SET']);
}
if (isset($parsed['SELECT'])) {
$sql .= ' ' . $this->buildSELECT($parsed);
}
return $sql;
}
}
?>
PK \aX8
8
O vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ForeignRefBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the FOREIGN KEY REFERENCES statement
* part of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ForeignRefBuilder implements Builder {
protected function buildTable($parsed) {
$builder = new TableBuilder();
return $builder->build($parsed, 0);
}
protected function buildColumnList($parsed) {
$builder = new ColumnListBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::REFERENCE) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildTable($v);
$sql .= $this->buildReserved($v);
$sql .= $this->buildColumnList($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE foreign ref subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \E^*
*
V vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/OrderByExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for expressions within the ORDER-BY part.
* It must contain the direction.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class OrderByExpressionBuilder extends WhereExpressionBuilder {
protected function buildDirection($parsed) {
$builder = new DirectionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = parent::build($parsed);
if ($sql !== '') {
$sql .= $this->buildDirection($parsed);
}
return $sql;
}
}
?>
PK \ sU I vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/FromBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the [FROM] part. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class FromBuilder implements Builder {
protected function buildTable($parsed, $key) {
$builder = new TableBuilder();
return $builder->build($parsed, $key);
}
protected function buildTableExpression($parsed, $key) {
$builder = new TableExpressionBuilder();
return $builder->build($parsed, $key);
}
protected function buildSubQuery($parsed, $key) {
$builder = new SubQueryBuilder();
return $builder->build($parsed, $key);
}
public function build(array $parsed) {
$sql = "";
if (array_key_exists("UNION ALL", $parsed) || array_key_exists("UNION", $parsed)) {
foreach ($parsed as $union_type => $outer_v) {
$first = true;
foreach ($outer_v as $item) {
if (!$first) {
$sql .= " $union_type ";
}
else {
$first = false;
}
$select_builder = new SelectStatementBuilder();
$len = strlen($sql);
$sql .= $select_builder->build($item);
if ($len === strlen($sql)) {
throw new UnableToCreateSQLException('FROM', $union_type, $outer_v, 'expr_type');
}
}
}
}
else {
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildTable($v, $k);
$sql .= $this->buildTableExpression($v, $k);
$sql .= $this->buildSubquery($v, $k);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('FROM', $k, $v, 'expr_type');
}
}
}
return "FROM " . $sql;
}
}
?>
PK \t/? ? I vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/SignBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for unary operators.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SignBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::SIGN) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \ .i i K vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/SchemaBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for a schema within DROP statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SchemaBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::SCHEMA) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \g!
!
M vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ConstantBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for constants.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ConstantBuilder implements Builder {
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::CONSTANT) {
return "";
}
$sql = $parsed['base_expr'];
$sql .= $this->buildAlias($parsed);
return $sql;
}
}
?>
PK \7 J vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/AliasBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for aliases.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class AliasBuilder implements Builder {
public function hasAlias($parsed) {
return isset($parsed['alias']);
}
public function build(array $parsed) {
if (!isset($parsed['alias']) || $parsed['alias'] === false) {
return "";
}
$sql = "";
if ($parsed['alias']['as']) {
$sql .= " AS";
}
$sql .= " " . $parsed['alias']['name'];
return $sql;
}
}
?>
PK \m
V vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/TruncateStatementBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the whole Truncate statement. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class TruncateStatementBuilder implements Builder {
protected function buildTRUNCATE($parsed) {
$builder = new TruncateBuilder();
return $builder->build($parsed);
}
protected function buildFROM($parsed) {
$builder = new FromBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = $this->buildTRUNCATE($parsed);
// $sql .= " " . $this->buildTRUNCATE($parsed) // Uncomment when parser fills in expr_type=table
return $sql;
}
}
?>
PK \9TTk k S vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/AliasReferenceBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for alias references.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class AliasReferenceBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::ALIAS) {
return "";
}
$sql = $parsed['base_expr'];
return $sql;
}
}
?>
PK \`'
'
M vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/TruncateBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the [TRUNCATE] part. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class TruncateBuilder implements Builder {
public function build(array $parsed) {
$sql = "TRUNCATE TABLE ";
$right = -1;
// works for one table only
$parsed['tables'] = array($parsed['TABLE']['base_expr']);
if ($parsed['tables'] !== false) {
foreach ($parsed['tables'] as $k => $v) {
$sql .= $v . ", ";
$right = -2;
}
}
return substr($sql, 0, $right);
}
}
?>
PK \1
J vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/TableBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the table name and join options.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class TableBuilder implements Builder {
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
protected function buildIndexHintList($parsed) {
$builder = new IndexHintListBuilder();
return $builder->build($parsed);
}
protected function buildJoin($parsed) {
$builder = new JoinBuilder();
return $builder->build($parsed);
}
protected function buildRefType($parsed) {
$builder = new RefTypeBuilder();
return $builder->build($parsed);
}
protected function buildRefClause($parsed) {
$builder = new RefClauseBuilder();
return $builder->build($parsed);
}
public function build(array $parsed, $index = 0) {
if ($parsed['expr_type'] !== ExpressionType::TABLE) {
return '';
}
$sql = $parsed['table'];
$sql .= $this->buildAlias($parsed);
$sql .= $this->buildIndexHintList($parsed);
if ($index !== 0) {
$sql = $this->buildJoin($parsed['join_type']) . $sql;
$sql .= $this->buildRefType($parsed['ref_type']);
$sql .= $parsed['ref_clause'] === false ? '' : $this->buildRefClause($parsed['ref_clause']);
}
return $sql;
}
}
?>
PK \Ì
J vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/QueryBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for queries within parentheses (no subqueries).
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class QueryBuilder implements Builder {
protected function buildRefClause($parsed) {
$builder = new RefClauseBuilder();
return $builder->build($parsed);
}
protected function buildRefType($parsed) {
$builder = new RefTypeBuilder();
return $builder->build($parsed);
}
protected function buildJoin($parsed) {
$builder = new JoinBuilder();
return $builder->build($parsed);
}
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
protected function buildSelectStatement($parsed) {
$builder = new SelectStatementBuilder();
return $builder->build($parsed);
}
public function build(array $parsed, $index = 0) {
if ($parsed['expr_type'] !== ExpressionType::QUERY) {
return '';
}
// TODO: should we add a numeric level (0) between sub_tree and SELECT?
$sql = $this->buildSelectStatement($parsed['sub_tree']);
$sql .= $this->buildAlias($parsed);
if ($index !== 0) {
$sql = $this->buildJoin($parsed['join_type']) . $sql;
$sql .= $this->buildRefType($parsed['ref_type']);
$sql .= $parsed['ref_clause'] === false ? '' : $this->buildRefClause($parsed['ref_clause']);
}
return $sql;
}
}
?>
PK \ ? P vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/IndexColumnBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for index column entries of the column-list
* parts of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class IndexColumnBuilder implements Builder {
protected function buildLength($parsed) {
return ($parsed === false ? '' : ('(' . $parsed . ')'));
}
protected function buildDirection($parsed) {
return ($parsed === false ? '' : (' ' . $parsed));
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::INDEX_COLUMN) {
return "";
}
$sql = $parsed['name'];
$sql .= $this->buildLength($parsed['length']);
$sql .= $this->buildDirection($parsed['dir']);
return $sql;
}
}
?>
PK \Z
M vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/IndexKeyBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the index key part of a CREATE TABLE statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class IndexKeyBuilder implements Builder {
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildIndexType($parsed) {
$builder = new IndexTypeBuilder();
return $builder->build($parsed);
}
protected function buildColumnList($parsed) {
$builder = new ColumnListBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::INDEX) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildColumnList($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildIndexType($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE index key subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \SC? ? M vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/OperatorBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for operators.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class OperatorBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::OPERATOR) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \6KJ$
$
Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/OrderByAliasBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for an alias within the ORDER-BY clause.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class OrderByAliasBuilder implements Builder {
protected function buildDirection($parsed) {
$builder = new DirectionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::ALIAS) {
return "";
}
return $parsed['base_expr'] . $this->buildDirection($parsed);
}
}
?>
PK \db T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/InsertStatementBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the whole Insert statement. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class InsertStatementBuilder implements Builder {
protected function buildVALUES($parsed) {
$builder = new ValuesBuilder();
return $builder->build($parsed);
}
protected function buildINSERT($parsed) {
$builder = new InsertBuilder();
return $builder->build($parsed);
}
protected function buildSELECT($parsed) {
$builder = new SelectStatementBuilder();
return $builder->build($parsed);
}
protected function buildSET($parsed) {
$builder = new SetBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
// TODO: are there more than one tables possible (like [INSERT][1])
$sql = $this->buildINSERT($parsed['INSERT']);
if (isset($parsed['VALUES'])) {
$sql .= ' ' . $this->buildVALUES($parsed['VALUES']);
}
if (isset($parsed['SET'])) {
$sql .= ' ' . $this->buildSET($parsed['SET']);
}
if (isset($parsed['SELECT'])) {
$sql .= ' ' . $this->buildSELECT($parsed);
}
return $sql;
}
}
?>
PK \F
K vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/UpdateBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the UPDATE statement parts.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UpdateBuilder implements Builder {
protected function buildTable($parsed, $idx) {
$builder = new TableBuilder();
return $builder->build($parsed, $idx);
}
public function build(array $parsed) {
$sql = '';
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildTable($v, $k);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('UPDATE table list', $k, $v, 'expr_type');
}
}
return 'UPDATE ' . $sql;
}
}
?>
PK \6l+
U vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/HavingExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for expressions within the HAVING part.
* You can overwrite all functions to achieve another handling.
*
* @author Ian Barker
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class HavingExpressionBuilder extends WhereExpressionBuilder {
protected function buildHavingExpression($parsed) {
return $this->build($parsed);
}
protected function buildHavingBracketExpression($parsed) {
$builder = new HavingBracketExpressionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::EXPRESSION) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildInList($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildHavingExpression($v);
$sql .= $this->buildHavingBracketExpression($v);
$sql .= $this->buildUserVariable($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('HAVING expression subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
$sql = substr($sql, 0, -1);
return $sql;
}
}
?>
PK \|뜺
R vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/IndexHintListBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for index hint lists.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class IndexHintListBuilder implements Builder {
public function hasHint($parsed) {
return isset($parsed['hints']);
}
// TODO: the hint list should be enhanced to get base_expr fro position calculation
public function build(array $parsed) {
if (!isset($parsed['hints']) || $parsed['hints'] === false) {
return "";
}
$sql = "";
foreach ($parsed['hints'] as $k => $v) {
$sql .= $v['hint_type'] . " " . $v['hint_list'] . " ";
}
return " " . substr($sql, 0, -1);
}
}
?>
PK \2Z K vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/RecordBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the records within INSERT statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class RecordBuilder implements Builder {
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::RECORD) {
return isset($parsed['base_expr']) ? $parsed['base_expr'] : '';
}
$sql = "";
foreach ($parsed['data'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildConstant($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildColRef($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException(ExpressionType::RECORD, $k, $v, 'expr_type');
}
$sql .= ", ";
}
$sql = substr($sql, 0, -2);
return "(" . $sql . ")";
}
}
?>
PK \"L8
8
Z vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/CreateTableDefinitionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the create definitions of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class CreateTableDefinitionBuilder implements Builder {
protected function buildTableBracketExpression($parsed) {
$builder = new TableBracketExpressionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if (!isset($parsed) || $parsed['create-def'] === false) {
return "";
}
return $this->buildTableBracketExpression($parsed['create-def']);
}
}
?>
PK \2
2
K vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/InListBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder list of values for the IN statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class InListBuilder implements Builder {
protected function buildSubTree($parsed, $delim) {
$builder = new SubTreeBuilder();
return $builder->build($parsed, $delim);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::IN_LIST) {
return "";
}
$sql = $this->buildSubTree($parsed, ", ");
return "(" . $sql . ")";
}
}
?>
PK \wjZ Z Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/UserVariableBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for an user variable.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UserVariableBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::USER_VARIABLE) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \b% S vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/AlterStatementBuilder.phpnu [ build($parsed);
}
private function buildAlter($parsed)
{
$builder = new AlterBuilder();
return $builder->build($parsed);
}
public function build(array $parsed)
{
$alter = $parsed['ALTER'];
$sql = $this->buildAlter($alter);
return $sql;
}
}
PK \"1 1 N vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/DropIndexBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the DROP INDEX statement. You can overwrite
* all functions to achieve another handling.
*/
class DropIndexBuilder implements Builder {
protected function buildIndexTable($parsed) {
$builder = new DropIndexTableBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = $parsed['name'];
$sql = trim($sql);
$sql .= ' ' . $this->buildIndexTable($parsed);
return trim($sql);
}
}
?>
PK \U
T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/TableExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the table name and join options.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class TableExpressionBuilder implements Builder {
protected function buildFROM($parsed) {
$builder = new FromBuilder();
return $builder->build($parsed);
}
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
protected function buildJoin($parsed) {
$builder = new JoinBuilder();
return $builder->build($parsed);
}
protected function buildRefType($parsed) {
$builder = new RefTypeBuilder();
return $builder->build($parsed);
}
protected function buildRefClause($parsed) {
$builder = new RefClauseBuilder();
return $builder->build($parsed);
}
public function build(array $parsed, $index = 0) {
if ($parsed['expr_type'] !== ExpressionType::TABLE_EXPRESSION) {
return '';
}
$sql = substr($this->buildFROM($parsed['sub_tree']), 5); // remove FROM keyword
$sql = '(' . $sql . ')';
$sql .= $this->buildAlias($parsed);
if ($index !== 0) {
$sql = $this->buildJoin($parsed['join_type']) . $sql;
$sql .= $this->buildRefType($parsed['ref_type']);
$sql .= $parsed['ref_clause'] === false ? '' : $this->buildRefClause($parsed['ref_clause']);
}
return $sql;
}
}
?>
PK \
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the GROUP-BY clause.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class GroupByBuilder implements Builder {
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildPosition($parsed) {
$builder = new PositionBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildGroupByAlias($parsed) {
$builder = new GroupByAliasBuilder();
return $builder->build($parsed);
}
protected function buildGroupByExpression($parsed) {
$builder = new GroupByExpressionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = "";
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildPosition($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildGroupByExpression($v);
$sql .= $this->buildGroupByAlias($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('GROUP', $k, $v, 'expr_type');
}
$sql .= ", ";
}
$sql = substr($sql, 0, -2);
return "GROUP BY " . $sql;
}
}
?>
PK \wks O vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ColumnListBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for column-list parts of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ColumnListBuilder implements Builder {
protected function buildIndexColumn($parsed) {
$builder = new IndexColumnBuilder();
return $builder->build($parsed);
}
protected function buildColumnReference($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
public function build(array $parsed, $delim = ', ') {
if ($parsed['expr_type'] !== ExpressionType::COLUMN_LIST) {
return '';
}
$sql = '';
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildIndexColumn($v);
$sql .= $this->buildColumnReference($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE column-list subtree', $k, $v, 'expr_type');
}
$sql .= $delim;
}
return '(' . substr($sql, 0, -strlen($delim)) . ')';
}
}
?>
PK \
S vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/DropIndexTableBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the table part of a DROP INDEX statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DropIndexTableBuilder implements Builder {
public function build(array $parsed) {
if (!isset($parsed['on']) || $parsed['on'] === false) {
return '';
}
$table = $parsed['on'];
if ($table['expr_type'] !== ExpressionType::TABLE) {
return '';
}
return 'ON ' . $table['name'];
}
}
?>
PK \s]7
O vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ForeignKeyBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the FOREIGN KEY statement part of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ForeignKeyBuilder implements Builder {
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildColumnList($parsed) {
$builder = new ColumnListBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildForeignRef($parsed) {
$builder = new ForeignRefBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::FOREIGN_KEY) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildConstant($v);
$sql .= $this->buildReserved($v);
$sql .= $this->buildColumnList($v);
$sql .= $this->buildForeignRef($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE foreign key subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \+dD J vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/LimitBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder LIMIT statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class LimitBuilder implements Builder {
public function build(array $parsed) {
$sql = ($parsed['rowcount']) . ($parsed['offset'] ? " OFFSET " . $parsed['offset'] : "");
if ($sql === "") {
throw new UnableToCreateSQLException('LIMIT', 'rowcount', $parsed, 'rowcount');
}
return "LIMIT " . $sql;
}
}
?>
PK \{ר K vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/SelectBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the [SELECT] field. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SelectBuilder implements Builder {
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildSelectExpression($parsed) {
$builder = new SelectExpressionBuilder();
return $builder->build($parsed);
}
protected function buildSelectBracketExpression($parsed) {
$builder = new SelectBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
/**
* Returns a well-formatted delimiter string. If you don't need nice SQL,
* you could simply return $parsed['delim'].
*
* @param array $parsed The part of the output array, which contains the current expression.
* @return a string, which is added right after the expression
*/
protected function getDelimiter($parsed) {
return (!isset($parsed['delim']) || $parsed['delim'] === false ? '' : (trim($parsed['delim']) . ' '));
}
public function build(array $parsed) {
$sql = "";
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildSelectBracketExpression($v);
$sql .= $this->buildSelectExpression($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildReserved($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('SELECT', $k, $v, 'expr_type');
}
$sql .= $this->getDelimiter($v);
}
return "SELECT " . $sql;
}
}
?>
PK \B S vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/DropExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the object list of a DROP statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DropExpressionBuilder implements Builder {
protected function buildTable($parsed, $index) {
$builder = new TableBuilder();
return $builder->build($parsed, $index);
}
protected function buildDatabase($parsed) {
$builder = new DatabaseBuilder();
return $builder->build($parsed);
}
protected function buildSchema($parsed) {
$builder = new SchemaBuilder();
return $builder->build($parsed);
}
protected function buildTemporaryTable($parsed) {
$builder = new TempTableBuilder();
return $builder->build($parsed);
}
protected function buildView($parsed) {
$builder = new ViewBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::EXPRESSION) {
return "";
}
$sql = '';
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildTable($v, 0);
$sql .= $this->buildView($v);
$sql .= $this->buildSchema($v);
$sql .= $this->buildDatabase($v);
$sql .= $this->buildTemporaryTable($v, 0);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('DROP object-list subtree', $k, $v, 'expr_type');
}
$sql .= ', ';
}
return substr($sql, 0, -2);
}
}
?>
PK \ݡ@
@
[ vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/OrderByColumnReferenceBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for column references within the ORDER-BY part.
* It must contain the direction.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class OrderByColumnReferenceBuilder extends ColumnReferenceBuilder {
protected function buildDirection($parsed) {
$builder = new DirectionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = parent::build($parsed);
if ($sql !== '') {
$sql .= $this->buildDirection($parsed);
}
return $sql;
}
}
?>
PK \V U vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ColumnDefinitionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the columndefinition statement part
* of CREATE TABLE. You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ColumnDefinitionBuilder implements Builder {
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildColumnType($parsed) {
$builder = new ColumnTypeBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::COLDEF) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildColumnType($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE primary key subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \Ob
b
R vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ShowStatementBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the SHOW statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ShowStatementBuilder implements Builder {
protected function buildWHERE($parsed) {
$builder = new WhereBuilder();
return $builder->build($parsed);
}
protected function buildSHOW($parsed) {
$builder = new ShowBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = $this->buildSHOW($parsed);
if (isset($parsed['WHERE'])) {
$sql .= " " . $this->buildWHERE($parsed['WHERE']);
}
return $sql;
}
}
?>
PK \
N vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/IndexLockBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the index lock of CREATE INDEX statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class IndexLockBuilder implements Builder {
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::INDEX_LOCK) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildOperator($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE INDEX lock subtree', $k, $v, 'expr_type');
}
$sql .= ' ';
}
return substr($sql, 0, -1);
}
}
?>
PK \ M vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ReservedBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for reserved keywords.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ReservedBuilder implements Builder {
public function isReserved($parsed) {
return (isset($parsed['expr_type']) && $parsed['expr_type'] === ExpressionType::RESERVED);
}
public function build(array $parsed) {
if (!$this->isReserved($parsed)) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \ȩ N vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/TempTableBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the temporary table name and join options.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class TempTableBuilder implements Builder {
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
protected function buildJoin($parsed) {
$builder = new JoinBuilder();
return $builder->build($parsed);
}
protected function buildRefType($parsed) {
$builder = new RefTypeBuilder();
return $builder->build($parsed);
}
protected function buildRefClause($parsed) {
$builder = new RefClauseBuilder();
return $builder->build($parsed);
}
public function build(array $parsed, $index = 0) {
if ($parsed['expr_type'] !== ExpressionType::TEMPORARY_TABLE) {
return '';
}
$sql = $parsed['table'];
$sql .= $this->buildAlias($parsed);
if ($index !== 0) {
$sql = $this->buildJoin($parsed['join_type']) . $sql;
$sql .= $this->buildRefType($parsed['ref_type']);
$sql .= $parsed['ref_clause'] === false ? '' : $this->buildRefClause($parsed['ref_clause']);
}
return $sql;
}
}
?>
PK \*
M vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/SubQueryBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for sub-queries.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SubQueryBuilder implements Builder {
protected function buildRefClause($parsed) {
$builder = new RefClauseBuilder();
return $builder->build($parsed);
}
protected function buildRefType($parsed) {
$builder = new RefTypeBuilder();
return $builder->build($parsed);
}
protected function buildJoin($parsed) {
$builder = new JoinBuilder();
return $builder->build($parsed);
}
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
protected function buildSelectStatement($parsed) {
$builder = new SelectStatementBuilder();
return $builder->build($parsed);
}
public function build(array $parsed, $index = 0) {
if ($parsed['expr_type'] !== ExpressionType::SUBQUERY) {
return '';
}
// TODO: should we add a numeric level (0) between sub_tree and SELECT?
$sql = $this->buildSelectStatement($parsed['sub_tree']);
$sql = '(' . $sql . ')';
$sql .= $this->buildAlias($parsed);
if ($index !== 0) {
$sql = $this->buildJoin($parsed['join_type']) . $sql;
$sql .= $this->buildRefType($parsed['ref_type']);
$sql .= $parsed['ref_clause'] === false ? '' : $this->buildRefClause($parsed['ref_clause']);
}
return $sql;
}
}
?>
PK \7H [ vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/WhereBracketExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for bracket expressions within the WHERE part.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class WhereBracketExpressionBuilder implements Builder {
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildInList($parsed) {
$builder = new InListBuilder();
return $builder->build($parsed);
}
protected function buildWhereExpression($parsed) {
$builder = new WhereExpressionBuilder();
return $builder->build($parsed);
}
protected function buildUserVariable($parsed) {
$builder = new UserVariableBuilder();
return $builder->build($parsed);
}
protected function buildSubQuery($parsed) {
$builder = new SubQueryBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::BRACKET_EXPRESSION) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildInList($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildWhereExpression($v);
$sql .= $this->build($v);
$sql .= $this->buildUserVariable($v);
// $sql .= $this->buildSubQuery($v);
$sql .= $this->buildReserved($v);
$sql .= $this->buildSubQuery($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('WHERE expression subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
$sql = "(" . substr($sql, 0, -1) . ")";
return $sql;
}
}
?>
PK \B
L vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ReplaceBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the [REPLACE] statement parts.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ReplaceBuilder implements Builder {
protected function buildTable($parsed) {
$builder = new TableBuilder();
return $builder->build($parsed, 0);
}
protected function buildSubQuery($parsed) {
$builder = new SubQueryBuilder();
return $builder->build($parsed, 0);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildBracketExpression($parsed) {
$builder = new SelectBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildColumnList($parsed) {
$builder = new ReplaceColumnListBuilder();
return $builder->build($parsed, 0);
}
public function build(array $parsed) {
$sql = '';
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildTable($v);
$sql .= $this->buildSubQuery($v);
$sql .= $this->buildColumnList($v);
$sql .= $this->buildReserved($v);
$sql .= $this->buildBracketExpression($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('REPLACE', $k, $v, 'expr_type');
}
$sql .= " ";
}
return 'REPLACE ' . substr($sql, 0, -1);
}
}
?>
PK \QpKK K N vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/RefClauseBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the references clause within a JOIN.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class RefClauseBuilder implements Builder {
protected function buildInList($parsed) {
$builder = new InListBuilder();
return $builder->build($parsed);
}
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildBracketExpression($parsed) {
$builder = new SelectBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildColumnList($parsed) {
$builder = new ColumnListBuilder();
return $builder->build($parsed);
}
protected function buildSubQuery($parsed) {
$builder = new SubQueryBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed === false) {
return '';
}
$sql = '';
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildBracketExpression($v);
$sql .= $this->buildInList($v);
$sql .= $this->buildColumnList($v);
$sql .= $this->buildSubQuery($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('expression ref_clause', $k, $v, 'expr_type');
}
$sql .= ' ';
}
return substr($sql, 0, -1);
}
}
?>
PK \_* Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/DefaultValueBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the default value statement part of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DefaultValueBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::DEF_VALUE) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \m5
N vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/CollationBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the collation statement part of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class CollationBuilder implements Builder {
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::COLLATE) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildConstant($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE options collation subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \e~ S vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/LikeExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the (LIKE) keyword within a
* CREATE TABLE statement. There are difference to LIKE (without parenthesis),
* the latter is a top-level element of the output array.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class LikeExpressionBuilder implements Builder {
protected function buildTable($parsed, $index) {
$builder = new TableBuilder();
return $builder->build($parsed, $index);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::LIKE) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildTable($v, 0);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE create-def (like) subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \SD
K vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/InsertBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the [INSERT] statement parts.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class InsertBuilder implements Builder {
protected function buildTable($parsed) {
$builder = new TableBuilder();
return $builder->build($parsed, 0);
}
protected function buildSubQuery($parsed) {
$builder = new SubQueryBuilder();
return $builder->build($parsed, 0);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildBracketExpression($parsed) {
$builder = new SelectBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildColumnList($parsed) {
$builder = new InsertColumnListBuilder();
return $builder->build($parsed, 0);
}
public function build(array $parsed) {
$sql = '';
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildTable($v);
$sql .= $this->buildSubQuery($v);
$sql .= $this->buildColumnList($v);
$sql .= $this->buildReserved($v);
$sql .= $this->buildBracketExpression($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('INSERT', $k, $v, 'expr_type');
}
$sql .= " ";
}
return 'INSERT ' . substr($sql, 0, -1);
}
}
?>
PK \|yn
` vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ColumnTypeBracketExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for bracket expressions within a column type.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ColumnTypeBracketExpressionBuilder implements Builder {
protected function buildSubTree($parsed, $delim) {
$builder = new SubTreeBuilder();
return $builder->build($parsed, $delim);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::BRACKET_EXPRESSION) {
return "";
}
$sql = $this->buildSubTree($parsed, ",");
$sql = "(" . $sql . ")";
return $sql;
}
}
?>
PK \ޡY U vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/InsertColumnListBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for column-list parts of INSERT statements.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class InsertColumnListBuilder implements Builder {
protected function buildColumn($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::COLUMN_LIST) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColumn($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('INSERT column-list subtree', $k, $v, 'expr_type');
}
$sql .= ", ";
}
return "(" . substr($sql, 0, -2) . ")";
}
}
?>
PK \s s M vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/DatabaseBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for a database within SHOW statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DatabaseBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::DATABASE) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \I! L vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/RefTypeBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnsupportedFeatureException;
/**
* This class implements the references type within a JOIN.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class RefTypeBuilder {
public function build($parsed) {
if ($parsed === false) {
return "";
}
if ($parsed === 'ON') {
return " ON ";
}
if ($parsed === 'USING') {
return " USING ";
}
// TODO: add more
throw new UnsupportedFeatureException($parsed);
}
}
?>
PK \~$ [ vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/TableBracketExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the table expressions
* within the create definitions of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class TableBracketExpressionBuilder implements Builder {
protected function buildColDef($parsed) {
$builder = new ColumnDefinitionBuilder();
return $builder->build($parsed);
}
protected function buildPrimaryKey($parsed) {
$builder = new PrimaryKeyBuilder();
return $builder->build($parsed);
}
protected function buildForeignKey($parsed) {
$builder = new ForeignKeyBuilder();
return $builder->build($parsed);
}
protected function buildCheck($parsed) {
$builder = new CheckBuilder();
return $builder->build($parsed);
}
protected function buildLikeExpression($parsed) {
$builder = new LikeExpressionBuilder();
return $builder->build($parsed);
}
protected function buildIndexKey($parsed) {
$builder = new IndexKeyBuilder();
return $builder->build($parsed);
}
protected function buildUniqueIndex($parsed) {
$builder = new UniqueIndexBuilder();
return $builder->build($parsed);
}
protected function buildFulltextIndex($parsed) {
$builder = new FulltextIndexBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::BRACKET_EXPRESSION) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColDef($v);
$sql .= $this->buildPrimaryKey($v);
$sql .= $this->buildCheck($v);
$sql .= $this->buildLikeExpression($v);
$sql .= $this->buildForeignKey($v);
$sql .= $this->buildIndexKey($v);
$sql .= $this->buildUniqueIndex($v);
$sql .= $this->buildFulltextIndex($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE create-def expression subtree', $k, $v, 'expr_type');
}
$sql .= ", ";
}
$sql = " (" . substr($sql, 0, -2) . ")";
return $sql;
}
}
?>
PK \8#t t J vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/CheckBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the CHECK statement part of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class CheckBuilder implements Builder {
protected function buildSelectBracketExpression($parsed) {
$builder = new SelectBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::CHECK) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildSelectBracketExpression($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE check subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \i( T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/CreateIndexTypeBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the index type of a CREATE INDEX
* statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class CreateIndexTypeBuilder extends IndexTypeBuilder {
public function build(array $parsed) {
if (!isset($parsed['index-type']) || $parsed['index-type'] === false) {
return '';
}
return parent::build($parsed['index-type']);
}
}
?>
PK \#Oh
T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/OrderByFunctionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for functions within the ORDER-BY part.
* It must contain the direction.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class OrderByFunctionBuilder extends FunctionBuilder {
protected function buildDirection($parsed) {
$builder = new DirectionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = parent::build($parsed);
if ($sql !== '') {
$sql .= $this->buildDirection($parsed);
}
return $sql;
}
}
?>
PK \gT
P vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/UniqueIndexBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the index key part of a CREATE TABLE statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UniqueIndexBuilder implements Builder {
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildIndexType($parsed) {
$builder = new IndexTypeBuilder();
return $builder->build($parsed);
}
protected function buildColumnList($parsed) {
$builder = new ColumnListBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::UNIQUE_IDX) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildColumnList($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildIndexType($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE unique-index key subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \l l N vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/DirectionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for directions (e.g. of the order-by clause).
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class DirectionBuilder implements Builder {
public function build(array $parsed) {
if (!isset($parsed['direction']) || $parsed['direction'] === false) {
return "";
}
return (" " . $parsed['direction']);
}
}
?>
PK \rzG^r r T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/CreateStatementBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the whole Create statement. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class CreateStatementBuilder implements Builder {
protected function buildLIKE($parsed) {
$builder = new LikeBuilder();
return $builder->build($parsed);
}
protected function buildSelectStatement($parsed) {
$builder = new SelectStatementBuilder();
return $builder->build($parsed);
}
protected function buildCREATE($parsed) {
$builder = new CreateBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = $this->buildCREATE($parsed);
if (isset($parsed['LIKE'])) {
$sql .= " " . $this->buildLIKE($parsed['LIKE']);
}
if (isset($parsed['SELECT'])) {
$sql .= " " . $this->buildSelectStatement($parsed);
}
return $sql;
}
}
?>
PK \sC*x! ! R vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/FulltextIndexBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the index key part of a CREATE TABLE statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class FulltextIndexBuilder implements Builder {
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildIndexKey($parsed) {
if ($parsed['expr_type'] !== ExpressionType::INDEX) {
return "";
}
return $parsed['base_expr'];
}
protected function buildColumnList($parsed) {
$builder = new ColumnListBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::FULLTEXT_IDX) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildColumnList($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildIndexKey($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE TABLE fulltext-index key subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \U3
T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ColumnReferenceBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for column references.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ColumnReferenceBuilder implements Builder {
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::COLREF) {
return "";
}
$sql = $parsed['base_expr'];
$sql .= $this->buildAlias($parsed);
return $sql;
}
}
?>
PK \({ T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/SelectStatementBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the whole Select statement. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SelectStatementBuilder implements Builder {
protected function buildSELECT($parsed) {
$builder = new SelectBuilder();
return $builder->build($parsed);
}
protected function buildFROM($parsed) {
$builder = new FromBuilder();
return $builder->build($parsed);
}
protected function buildWHERE($parsed) {
$builder = new WhereBuilder();
return $builder->build($parsed);
}
protected function buildGROUP($parsed) {
$builder = new GroupByBuilder();
return $builder->build($parsed);
}
protected function buildHAVING($parsed) {
$builder = new HavingBuilder();
return $builder->build($parsed);
}
protected function buildORDER($parsed) {
$builder = new OrderByBuilder();
return $builder->build($parsed);
}
protected function buildLIMIT($parsed) {
$builder = new LimitBuilder();
return $builder->build($parsed);
}
protected function buildUNION($parsed) {
$builder = new UnionStatementBuilder();
return $builder->build($parsed);
}
protected function buildUNIONALL($parsed) {
$builder = new UnionAllStatementBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = "";
if (isset($parsed['SELECT'])) {
$sql .= $this->buildSELECT($parsed['SELECT']);
}
if (isset($parsed['FROM'])) {
$sql .= " " . $this->buildFROM($parsed['FROM']);
}
if (isset($parsed['WHERE'])) {
$sql .= " " . $this->buildWHERE($parsed['WHERE']);
}
if (isset($parsed['GROUP'])) {
$sql .= " " . $this->buildGROUP($parsed['GROUP']);
}
if (isset($parsed['HAVING'])) {
$sql .= " " . $this->buildHAVING($parsed['HAVING']);
}
if (isset($parsed['ORDER'])) {
$sql .= " " . $this->buildORDER($parsed['ORDER']);
}
if (isset($parsed['LIMIT'])) {
$sql .= " " . $this->buildLIMIT($parsed['LIMIT']);
}
if (isset($parsed['UNION'])) {
$sql .= " " . $this->buildUNION($parsed);
}
if (isset($parsed['UNION ALL'])) {
$sql .= " " . $this->buildUNIONALL($parsed);
}
return $sql;
}
}
?>
PK \Mf
f
I vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/LikeBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the LIKE statement part of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class LikeBuilder implements Builder {
protected function buildTable($parsed, $index) {
$builder = new TableBuilder();
return $builder->build($parsed, $index);
}
public function build(array $parsed) {
$sql = $this->buildTable($parsed, 0);
if (strlen($sql) === 0) {
throw new UnableToCreateSQLException('LIKE', "", $parsed, 'table');
}
return "LIKE " . $sql;
}
}
?>
PK \ E vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/Builder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* A builder can create a part of an SQL statement. The necessary information
* are provided by the function parameter as array. This array is a subtree
* of the PHPSQLParser output.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*/
interface Builder {
/**
* Builds a part of an SQL statement.
*
* @param array $parsed a subtree of the PHPSQLParser output array
*
* @return A string, which contains a part of an SQL statement.
*/
public function build(array $parsed);
}
?>
PK \X+ U vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/SelectExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for simple expressions within a SELECT statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SelectExpressionBuilder implements Builder {
protected function buildSubTree($parsed, $delim) {
$builder = new SubTreeBuilder();
return $builder->build($parsed, $delim);
}
protected function buildAlias($parsed) {
$builder = new AliasBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::EXPRESSION) {
return "";
}
$sql = $this->buildSubTree($parsed, " ");
$sql .= $this->buildAlias($parsed);
return $sql;
}
}
?>
PK \t/Z.R R I vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/DropBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the [DROP] part. You can overwrite
* all functions to achieve another handling.
*/
class DropBuilder implements Builder {
protected function buildDropIndex( $parsed ) {
$builder = new DropIndexBuilder();
return $builder->build( $parsed );
}
protected function buildReserved( $parsed ) {
$builder = new ReservedBuilder();
return $builder->build( $parsed );
}
protected function buildExpression( $parsed ) {
$builder = new DropExpressionBuilder();
return $builder->build( $parsed );
}
protected function buildSubTree( $parsed ) {
$sql = '';
foreach ( $parsed['sub_tree'] as $k => $v ) {
$len = strlen( $sql );
$sql .= $this->buildReserved( $v );
$sql .= $this->buildExpression( $v );
if ( $len == strlen( $sql ) ) {
throw new UnableToCreateSQLException( 'DROP subtree', $k, $v, 'expr_type' );
}
$sql .= ' ';
}
return $sql;
}
public function build( array $parsed ) {
$drop = $parsed['DROP'];
$sql = $this->buildSubTree( $drop );
if ( $drop['expr_type'] === ExpressionType::INDEX ) {
$sql .= '' . $this->buildDropIndex( $parsed['INDEX'] ) . ' ';
}
return 'DROP ' . substr( $sql, 0, -1 );
}
}
?>
PK \ĸ T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/UpdateStatementBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
/**
* This class implements the builder for the whole Update statement. You can overwrite
* all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class UpdateStatementBuilder implements Builder {
protected function buildWHERE($parsed) {
$builder = new WhereBuilder();
return $builder->build($parsed);
}
protected function buildSET($parsed) {
$builder = new SetBuilder();
return $builder->build($parsed);
}
protected function buildUPDATE($parsed) {
$builder = new UpdateBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = $this->buildUPDATE($parsed['UPDATE']) . " " . $this->buildSET($parsed['SET']);
if (isset($parsed['WHERE'])) {
$sql .= " " . $this->buildWHERE($parsed['WHERE']);
}
return $sql;
}
}
?>
PK \mHD\ \ V vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/GroupByExpressionBuilder.phpnu [
* @copyright 2010-2016 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
* @example group by id desc
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for an alias within the GROUP-BY clause.
* You can overwrite all functions to achieve another handling.
*
* @author oohook
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class GroupByExpressionBuilder implements Builder {
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::EXPRESSION) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildReserved($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('GROUP expression subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
$sql = substr($sql, 0, -1);
return $sql;
}
}
?>
PK \TJ>x x N vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/ProcedureBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for a procedure within SHOW statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class ProcedureBuilder implements Builder {
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::PROCEDURE) {
return "";
}
return $parsed['base_expr'];
}
}
?>
PK \ަf\ \ L vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/SubTreeBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for [sub_tree] fields.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class SubTreeBuilder implements Builder {
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildInList($parsed) {
$builder = new InListBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildSubQuery($parsed) {
$builder = new SubQueryBuilder();
return $builder->build($parsed);
}
protected function buildQuery($parsed) {
$builder = new QueryBuilder();
return $builder->build($parsed);
}
protected function buildSelectBracketExpression($parsed) {
$builder = new SelectBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildUserVariable($parsed) {
$builder = new UserVariableBuilder();
return $builder->build($parsed);
}
protected function buildSign($parsed) {
$builder = new SignBuilder();
return $builder->build($parsed);
}
public function build(array $parsed, $delim = " ") {
if ($parsed['sub_tree'] === '' || $parsed['sub_tree'] === false) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildInList($v);
$sql .= $this->buildSubQuery($v);
$sql .= $this->buildSelectBracketExpression($v);
$sql .= $this->buildReserved($v);
$sql .= $this->buildQuery($v);
$sql .= $this->buildUserVariable($v);
$sign = $this->buildSign($v);
$sql .= $sign;
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('expression subtree', $k, $v, 'expr_type');
}
// We don't need whitespace between a sign and the following part.
if ($sign === '') {
$sql .= $delim;
}
}
return substr($sql, 0, -strlen($delim));
}
}
?>
PK \%nb b Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/IndexCommentBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the index comment of CREATE INDEX statement.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class IndexCommentBuilder implements Builder {
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::COMMENT) {
return '';
}
$sql = '';
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildReserved($v);
$sql .= $this->buildConstant($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('CREATE INDEX comment subtree', $k, $v, 'expr_type');
}
$sql .= ' ';
}
return substr($sql, 0, -1);
}
}
?>
PK \: J vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/WhereBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the WHERE part.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class WhereBuilder implements Builder {
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildSubQuery($parsed) {
$builder = new SubQueryBuilder();
return $builder->build($parsed);
}
protected function buildInList($parsed) {
$builder = new InListBuilder();
return $builder->build($parsed);
}
protected function buildWhereExpression($parsed) {
$builder = new WhereExpressionBuilder();
return $builder->build($parsed);
}
protected function buildWhereBracketExpression($parsed) {
$builder = new WhereBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildUserVariable($parsed) {
$builder = new UserVariableBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = "WHERE ";
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildOperator($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildColRef($v);
$sql .= $this->buildSubQuery($v);
$sql .= $this->buildInList($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildWhereExpression($v);
$sql .= $this->buildWhereBracketExpression($v);
$sql .= $this->buildUserVariable($v);
$sql .= $this->buildReserved($v);
if (strlen($sql) == $len) {
throw new UnableToCreateSQLException('WHERE', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \/!
K vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/HavingBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
/**
* This class implements the builder for the HAVING part.
* You can overwrite all functions to achieve another handling.
*
* @author Ian Barker
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class HavingBuilder extends WhereBuilder {
protected function buildAliasReference($parsed) {
$builder = new AliasReferenceBuilder();
return $builder->build($parsed);
}
protected function buildHavingExpression($parsed) {
$builder = new HavingExpressionBuilder();
return $builder->build($parsed);
}
protected function buildHavingBracketExpression($parsed) {
$builder = new HavingBracketExpressionBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
$sql = "HAVING ";
foreach ($parsed as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildAliasReference($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildColRef($v);
$sql .= $this->buildSubQuery($v);
$sql .= $this->buildInList($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildHavingExpression($v);
$sql .= $this->buildHavingBracketExpression($v);
$sql .= $this->buildUserVariable($v);
if (strlen($sql) == $len) {
throw new UnableToCreateSQLException('HAVING', $k, $v, 'expr_type');
}
$sql .= " ";
}
return substr($sql, 0, -1);
}
}
?>
PK \82 2 T vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/WhereExpressionBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for expressions within the WHERE part.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
*
*/
class WhereExpressionBuilder implements Builder {
protected function buildColRef($parsed) {
$builder = new ColumnReferenceBuilder();
return $builder->build($parsed);
}
protected function buildConstant($parsed) {
$builder = new ConstantBuilder();
return $builder->build($parsed);
}
protected function buildOperator($parsed) {
$builder = new OperatorBuilder();
return $builder->build($parsed);
}
protected function buildFunction($parsed) {
$builder = new FunctionBuilder();
return $builder->build($parsed);
}
protected function buildInList($parsed) {
$builder = new InListBuilder();
return $builder->build($parsed);
}
protected function buildWhereExpression($parsed) {
return $this->build($parsed);
}
protected function buildWhereBracketExpression($parsed) {
$builder = new WhereBracketExpressionBuilder();
return $builder->build($parsed);
}
protected function buildUserVariable($parsed) {
$builder = new UserVariableBuilder();
return $builder->build($parsed);
}
protected function buildSubQuery($parsed) {
$builder = new SubQueryBuilder();
return $builder->build($parsed);
}
protected function buildReserved($parsed) {
$builder = new ReservedBuilder();
return $builder->build($parsed);
}
public function build(array $parsed) {
if ($parsed['expr_type'] !== ExpressionType::EXPRESSION) {
return "";
}
$sql = "";
foreach ($parsed['sub_tree'] as $k => $v) {
$len = strlen($sql);
$sql .= $this->buildColRef($v);
$sql .= $this->buildConstant($v);
$sql .= $this->buildOperator($v);
$sql .= $this->buildInList($v);
$sql .= $this->buildFunction($v);
$sql .= $this->buildWhereExpression($v);
$sql .= $this->buildWhereBracketExpression($v);
$sql .= $this->buildUserVariable($v);
$sql .= $this->buildSubQuery($v);
$sql .= $this->buildReserved($v);
if ($len == strlen($sql)) {
throw new UnableToCreateSQLException('WHERE expression subtree', $k, $v, 'expr_type');
}
$sql .= " ";
}
$sql = substr($sql, 0, -1);
return $sql;
}
}
?>
PK \91
1
Q vendor/greenlion/php-sql-parser/src/PHPSQLParser/builders/CharacterSetBuilder.phpnu [
* @copyright 2010-2014 Justin Swanhart and André Rothe
* @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
* @version SVN: $Id$
*
*/
namespace PHPSQLParser\builders;
use PHPSQLParser\exceptions\UnableToCreateSQLException;
use PHPSQLParser\utils\ExpressionType;
/**
* This class implements the builder for the CHARACTER SET statement part of CREATE TABLE.
* You can overwrite all functions to achieve another handling.
*
* @author André Rothe
 ?>media/com_akeebabackup/icons/loading.gif){kind=icon}
 ?>/media/com_akeebabackup/icons/spinner.gif){kind=icon}