File manager - Edit - /home/opticamezl/www/newok/joomla.zip
Back
PK �^�\�V� index.htmlnu &1i� <!DOCTYPE html><title></title> PK �^�\��&�B B joomla.phpnu &1i� <?php /** * @package ThemeXpert Extension Framework (XEF) * @copyright Copyright (c)2010-2012 ThemeXpert.com * @license GNU General Public License version 3, or later **/ // Protect from unauthorized access defined('_JEXEC') or die(); // Require XEF helper class require_once JPATH_LIBRARIES . '/xef/xef.php'; // Require Content router require_once JPATH_SITE.'/components/com_content/helpers/route.php'; class XEFSourceJoomla extends XEFHelper { public function getItems() { jimport('joomla.application.component.model'); $app = JFactory::getApplication('site', array(), 'J'); // Get the dbo $db = JFactory::getDbo(); // Get an instance of the generic articles model if(XEF_JVERSION == '25') { JModel::addIncludePath(JPATH_SITE.'/components/com_content/models'); $model = JModel::getInstance('Articles', 'ContentModel', array('ignore_request' => true)); }else{ JModelLegacy::addIncludePath(JPATH_SITE.'/components/com_content/models'); $model = JModelLegacy::getInstance('Articles', 'ContentModel', array('ignore_request' => true)); } // Set application parameters in model $appParams = $app->getParams(); $model->setState('params', $appParams); // Set the filters based on the module params $model->setState('list.start', 0); $model->setState('list.limit', $this->get( 'count', 4 )); $model->setState('filter.published', 1); // Access filter $access = !JComponentHelper::getParams('com_content')->get('show_noauth'); $authorised = JAccess::getAuthorisedViewLevels(JFactory::getUser()->get('id')); $model->setState('filter.access', $access); // Category filter switch( $this->get('jomcatfilter') ) { case 0: // All $catid = ''; break; case 1: // From specific category $catid = $this->get('jom_catid',array()); break; } $model->setState( 'filter.category_id', $catid ); // User filter $userId = JFactory::getUser()->get('id'); switch ($this->get('jom_user_id')) { case 'by_me': $model->setState('filter.author_id', (int) $userId); break; case 'not_me': $model->setState('filter.author_id', $userId); $model->setState('filter.author_id.include', false); break; case '0': break; default: $model->setState('filter.author_id', (int) $this->get('jom_user_id')); break; } // Filter by language $model->setState('filter.language',$app->getLanguageFilter()); // Featured switch switch ($this->get('jom_show_featured')) { case '1': $model->setState('filter.featured', 'only'); break; case '0': $model->setState('filter.featured', 'hide'); break; default: $model->setState('filter.featured', 'show'); break; } // Set ordering $order_map = array( 'm_dsc' => 'a.modified DESC, a.created', 'mc_dsc' => 'CASE WHEN (a.modified = '.$db->quote($db->getNullDate()).') THEN a.created ELSE a.modified END', 'c_dsc' => 'a.created', 'p_dsc' => 'a.publish_up', 'hits_dsc' => 'a.hits' ); $ordering = JArrayHelper::getValue($order_map, $this->get('jom_ordering'), 'a.publish_up'); $dir = 'DESC'; $model->setState('list.ordering', $ordering); $model->setState('list.direction', $dir); $items = $model->getItems(); // Prepare the items with options $items = $this->prepareItems($items); //XEFUtility::debug($catid); return $items; } public function getLink($item) { $access = !JComponentHelper::getParams('com_content')->get('show_noauth'); $authorised = JAccess::getAuthorisedViewLevels(JFactory::getUser()->get('id')); $link = ''; $item->slug = $item->id.':'.$item->alias; $item->catslug = $item->catid.':'.$item->category_alias; if ($access || in_array($item->access, $authorised)) { // We know that user has the privilege to view the article $link = JRoute::_( ContentHelperRoute::getArticleRoute($item->slug, $item->catslug) . $this->getMenuItemId() ); } else { $link = JRoute::_('index.php?option=com_users&view=login'); } return $link; } public function getCategory($item) { return $item->category_title; } public function getCategoryLink($item) { return JRoute::_( ContentHelperRoute::getCategoryRoute($item->catid) . $this->getMenuItemId() ); } public function getImage($item) { $path = ''; //Take advantage from joomla default Intro image system if( isset($item->images) ) { $images = json_decode($item->images); } if( isset($images->image_intro) and !empty($images->image_intro) ) { $path = $images->image_intro; }else{ //get image from article intro text $path = XEFUtility::getImage($item->introtext); } return $path; } public function getDate($item) { return JHTML::_('date',$item->created, JText::_('DATE_FORMAT_LC3')); } }PK X`�\O]��C �C src/Extension/Joomla.phpnu �[��� <?php /** * @package Joomla.Plugin * @subpackage User.joomla * * @copyright (C) 2006 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE.txt */ namespace Joomla\Plugin\User\Joomla\Extension; use Joomla\CMS\Component\ComponentHelper; use Joomla\CMS\Factory; use Joomla\CMS\Language\LanguageFactoryInterface; use Joomla\CMS\Log\Log; use Joomla\CMS\Mail\MailTemplate; use Joomla\CMS\Plugin\CMSPlugin; use Joomla\CMS\Uri\Uri; use Joomla\CMS\User\User; use Joomla\CMS\User\UserHelper; use Joomla\Database\DatabaseAwareTrait; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\ParameterType; use Joomla\Registry\Registry; // phpcs:disable PSR1.Files.SideEffects \defined('_JEXEC') or die; // phpcs:enable PSR1.Files.SideEffects /** * Joomla User plugin * * @since 1.5 */ final class Joomla extends CMSPlugin { use DatabaseAwareTrait; /** * Set as required the passwords fields when mail to user is set to No * * @param \Joomla\CMS\Form\Form $form The form to be altered. * @param mixed $data The associated data for the form. * * @return boolean * * @since 4.0.0 */ public function onContentPrepareForm($form, $data) { // Check we are manipulating a valid user form before modifying it. $name = $form->getName(); if ($name === 'com_users.user') { // In case there is a validation error (like duplicated user), $data is an empty array on save. // After returning from error, $data is an array but populated if (!$data) { $data = $this->getApplication()->getInput()->get('jform', [], 'array'); } if (is_array($data)) { $data = (object) $data; } // Passwords fields are required when mail to user is set to No if (empty($data->id) && !$this->params->get('mail_to_user', 1)) { $form->setFieldAttribute('password', 'required', 'true'); $form->setFieldAttribute('password2', 'required', 'true'); } } return true; } /** * Remove all sessions for the user name * * Method is called after user data is deleted from the database * * @param array $user Holds the user data * @param boolean $success True if user was successfully stored in the database * @param string $msg Message * * @return void * * @since 1.6 */ public function onUserAfterDelete($user, $success, $msg): void { if (!$success) { return; } $userId = (int) $user['id']; // Only execute this if the session metadata is tracked if ($this->getApplication()->get('session_metadata', true)) { UserHelper::destroyUserSessions($userId, true); } $db = $this->getDatabase(); try { $db->setQuery( $db->getQuery(true) ->delete($db->quoteName('#__messages')) ->where($db->quoteName('user_id_from') . ' = :userId') ->bind(':userId', $userId, ParameterType::INTEGER) )->execute(); } catch (ExecutionFailureException $e) { // Do nothing. } // Delete Multi-factor Authentication user profile records $profileKey = 'mfa.%'; $query = $db->getQuery(true) ->delete($db->quoteName('#__user_profiles')) ->where($db->quoteName('user_id') . ' = :userId') ->where($db->quoteName('profile_key') . ' LIKE :profileKey') ->bind(':userId', $userId, ParameterType::INTEGER) ->bind(':profileKey', $profileKey, ParameterType::STRING); try { $db->setQuery($query)->execute(); } catch (\Exception $e) { // Do nothing } // Delete Multi-factor Authentication records $query = $db->getQuery(true) ->delete($db->quoteName('#__user_mfa')) ->where($db->quoteName('user_id') . ' = :userId') ->bind(':userId', $userId, ParameterType::INTEGER); try { $db->setQuery($query)->execute(); } catch (\Exception $e) { // Do nothing } } /** * Utility method to act on a user after it has been saved. * * This method sends a registration email to new users created in the backend. * * @param array $user Holds the new user data. * @param boolean $isnew True if a new user is stored. * @param boolean $success True if user was successfully stored in the database. * @param string $msg Message. * * @return void * * @since 1.6 */ public function onUserAfterSave($user, $isnew, $success, $msg): void { $mail_to_user = $this->params->get('mail_to_user', 1); if (!$isnew || !$mail_to_user) { return; } $app = $this->getApplication(); $language = $app->getLanguage(); $defaultLocale = $language->getTag(); // @todo: Suck in the frontend registration emails here as well. Job for a rainy day. // The method check here ensures that if running as a CLI Application we don't get any errors if (method_exists($app, 'isClient') && ($app->isClient('site') || $app->isClient('cli'))) { return; } // Check if we have a sensible from email address, if not bail out as mail would not be sent anyway if (strpos($app->get('mailfrom'), '@') === false) { $app->enqueueMessage($language->_('JERROR_SENDING_EMAIL'), 'warning'); return; } /** * Look for user language. Priority: * 1. User frontend language * 2. User backend language */ $userParams = new Registry($user['params']); $userLocale = $userParams->get('language', $userParams->get('admin_language', $defaultLocale)); // Temporarily set application language to user's language. if ($userLocale !== $defaultLocale) { Factory::$language = Factory::getContainer() ->get(LanguageFactoryInterface::class) ->createLanguage($userLocale, $app->get('debug_lang', false)); if (method_exists($app, 'loadLanguage')) { $app->loadLanguage(Factory::$language); } } // Load plugin language files. $this->loadLanguage(); // Collect data for mail $data = [ 'name' => $user['name'], 'sitename' => $app->get('sitename'), 'url' => Uri::root(), 'username' => $user['username'], 'password' => $user['password_clear'], 'email' => $user['email'], ]; $mailer = new MailTemplate('plg_user_joomla.mail', $userLocale); $mailer->addTemplateData($data); $mailer->addUnsafeTags(['username', 'password', 'name', 'email']); $mailer->addRecipient($user['email'], $user['name']); try { $res = $mailer->send(); } catch (\Exception $exception) { try { Log::add($language->_($exception->getMessage()), Log::WARNING, 'jerror'); $res = false; } catch (\RuntimeException $exception) { $app->enqueueMessage($language->_($exception->getMessage()), 'warning'); $res = false; } } if ($res === false) { $app->enqueueMessage($language->_('JERROR_SENDING_EMAIL'), 'warning'); } // Set application language back to default if we changed it if ($userLocale !== $defaultLocale) { Factory::$language = $language; if (method_exists($app, 'loadLanguage')) { $app->loadLanguage($language); } } } /** * This method should handle any login logic and report back to the subject * * @param array $user Holds the user data * @param array $options Array holding options (remember, autoregister, group) * * @return boolean True on success * * @since 1.5 */ public function onUserLogin($user, $options = []) { $instance = $this->getUser($user, $options); // If getUser returned an error, then pass it back. if ($instance instanceof \Exception) { return false; } // If the user is blocked, redirect with an error if ($instance->block == 1) { $this->getApplication()->enqueueMessage($this->getApplication()->getLanguage()->_('JERROR_NOLOGIN_BLOCKED'), 'warning'); return false; } // Authorise the user based on the group information if (!isset($options['group'])) { $options['group'] = 'USERS'; } // Check the user can login. $result = $instance->authorise($options['action']); if (!$result) { $this->getApplication()->enqueueMessage($this->getApplication()->getLanguage()->_('JERROR_LOGIN_DENIED'), 'warning'); return false; } // Mark the user as logged in $instance->guest = 0; // Load the logged in user to the application $this->getApplication()->loadIdentity($instance); $session = $this->getApplication()->getSession(); // Grab the current session ID $oldSessionId = $session->getId(); // Fork the session $session->fork(); // Register the needed session variables $session->set('user', $instance); // Update the user related fields for the Joomla sessions table if tracking session metadata. if ($this->getApplication()->get('session_metadata', true)) { $this->getApplication()->checkSession(); } $db = $this->getDatabase(); // Purge the old session $query = $db->getQuery(true) ->delete($db->quoteName('#__session')) ->where($db->quoteName('session_id') . ' = :sessionid') ->bind(':sessionid', $oldSessionId); try { $db->setQuery($query)->execute(); } catch (\RuntimeException $e) { // The old session is already invalidated, don't let this block logging in } // Hit the user last visit field $instance->setLastVisit(); // Add "user state" cookie used for reverse caching proxies like Varnish, Nginx etc. if ($this->getApplication()->isClient('site')) { $this->getApplication()->getInput()->cookie->set( 'joomla_user_state', 'logged_in', 0, $this->getApplication()->get('cookie_path', '/'), $this->getApplication()->get('cookie_domain', ''), $this->getApplication()->isHttpsForced(), true ); } return true; } /** * This method should handle any logout logic and report back to the subject * * @param array $user Holds the user data. * @param array $options Array holding options (client, ...). * * @return boolean True on success * * @since 1.5 */ public function onUserLogout($user, $options = []) { $my = Factory::getUser(); $session = Factory::getSession(); $userid = (int) $user['id']; // Make sure we're a valid user first if ($user['id'] === 0 && !$my->get('tmp_user')) { return true; } $sharedSessions = $this->getApplication()->get('shared_session', '0'); // Check to see if we're deleting the current session if ($my->id == $userid && ($sharedSessions || (!$sharedSessions && $options['clientid'] == $this->getApplication()->getClientId()))) { // Hit the user last visit field $my->setLastVisit(); // Destroy the php session for this user $session->destroy(); } // Enable / Disable Forcing logout all users with same userid, but only if session metadata is tracked $forceLogout = $this->params->get('forceLogout', 1) && $this->getApplication()->get('session_metadata', true); if ($forceLogout) { $clientId = $sharedSessions ? null : (int) $options['clientid']; UserHelper::destroyUserSessions($user['id'], false, $clientId); } // Delete "user state" cookie used for reverse caching proxies like Varnish, Nginx etc. if ($this->getApplication()->isClient('site')) { $this->getApplication()->getInput()->cookie->set('joomla_user_state', '', 1, $this->getApplication()->get('cookie_path', '/'), $this->getApplication()->get('cookie_domain', '')); } return true; } /** * Hooks on the Joomla! login event. Detects silent logins and disables the Multi-Factor * Authentication page in this case. * * Moreover, it will save the redirection URL and the Captive URL which is necessary in Joomla 4. You see, in Joomla * 4 having unified sessions turned on makes the backend login redirect you to the frontend of the site AFTER * logging in, something which would cause the Captive page to appear in the frontend and redirect you to the public * frontend homepage after successfully passing the Two Step verification process. * * @param array $options Passed by Joomla. user: a User object; responseType: string, authentication response type. * * @return void * @since 4.2.0 */ public function onUserAfterLogin(array $options): void { if (!($this->getApplication()->isClient('administrator')) && !($this->getApplication()->isClient('site'))) { return; } $this->disableMfaOnSilentLogin($options); } /** * Detect silent logins and disable MFA if the relevant com_users option is set. * * @param array $options The array of login options and login result * * @return void * @since 4.2.0 */ private function disableMfaOnSilentLogin(array $options): void { $userParams = ComponentHelper::getParams('com_users'); $doMfaOnSilentLogin = $userParams->get('mfaonsilent', 0) == 1; // Should I show MFA even on silent logins? Default: 1 (yes, show) if ($doMfaOnSilentLogin) { return; } // Make sure I have a valid user /** @var User $user */ $user = $options['user']; if (!is_object($user) || !($user instanceof User) || $user->guest) { return; } $silentResponseTypes = array_map( 'trim', explode(',', $userParams->get('silentresponses', '') ?: '') ); $silentResponseTypes = $silentResponseTypes ?: ['cookie', 'passwordless']; // Only proceed if this is not a silent login if (!in_array(strtolower($options['responseType'] ?? ''), $silentResponseTypes)) { return; } // Set the flag indicating that MFA is already checked. $this->getApplication()->getSession()->set('com_users.mfa_checked', 1); } /** * This method will return a user object * * If options['autoregister'] is true, if the user doesn't exist yet they will be created * * @param array $user Holds the user data. * @param array $options Array holding options (remember, autoregister, group). * * @return User * * @since 1.5 */ private function getUser($user, $options = []) { $instance = User::getInstance(); $id = (int) UserHelper::getUserId($user['username']); if ($id) { $instance->load($id); return $instance; } // @todo : move this out of the plugin $params = ComponentHelper::getParams('com_users'); // Read the default user group option from com_users $defaultUserGroup = $params->get('new_usertype', $params->get('guest_usergroup', 1)); $instance->id = 0; $instance->name = $user['fullname']; $instance->username = $user['username']; $instance->password_clear = $user['password_clear']; // Result should contain an email (check). $instance->email = $user['email']; $instance->groups = [$defaultUserGroup]; // If autoregister is set let's register the user $autoregister = $options['autoregister'] ?? $this->params->get('autoregister', 1); if ($autoregister) { if (!$instance->save()) { Log::add('Failed to automatically create account for user ' . $user['username'] . '.', Log::WARNING, 'error'); } } else { // No existing user and autoregister off, this is a temporary user. $instance->set('tmp_user', true); } return $instance; } } PK X`�\��P9� � joomla.xmlnu �[��� <?xml version="1.0" encoding="UTF-8"?> <extension type="plugin" group="user" method="upgrade"> <name>plg_user_joomla</name> <author>Joomla! Project</author> <creationDate>2006-12</creationDate> <copyright>(C) 2006 Open Source Matters, Inc.</copyright> <license>GNU General Public License version 2 or later; see LICENSE.txt</license> <authorEmail>admin@joomla.org</authorEmail> <authorUrl>www.joomla.org</authorUrl> <version>3.0.0</version> <description>PLG_USER_JOOMLA_XML_DESCRIPTION</description> <namespace path="src">Joomla\Plugin\User\Joomla</namespace> <files> <folder plugin="joomla">services</folder> <folder>src</folder> </files> <languages> <language tag="en-GB">language/en-GB/plg_user_joomla.ini</language> <language tag="en-GB">language/en-GB/plg_user_joomla.sys.ini</language> </languages> <config> <fields name="params"> <fieldset name="basic"> <field name="autoregister" type="radio" layout="joomla.form.field.radio.switcher" label="PLG_USER_JOOMLA_FIELD_AUTOREGISTER_LABEL" default="1" > <option value="0">JNO</option> <option value="1">JYES</option> </field> <field name="mail_to_user" type="radio" layout="joomla.form.field.radio.switcher" label="PLG_USER_JOOMLA_FIELD_MAILTOUSER_LABEL" default="1" > <option value="0">JNO</option> <option value="1">JYES</option> </field> <field name="forceLogout" type="radio" layout="joomla.form.field.radio.switcher" label="PLG_USER_JOOMLA_FIELD_FORCELOGOUT_LABEL" default="1" > <option value="0">JNO</option> <option value="1">JYES</option> </field> </fieldset> </fields> </config> </extension> PK X`�\�a0� � services/provider.phpnu �[��� <?php /** * @package Joomla.Plugin * @subpackage User.joomla * * @copyright (C) 2023 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE.txt */ defined('_JEXEC') or die; use Joomla\CMS\Extension\PluginInterface; use Joomla\CMS\Factory; use Joomla\CMS\Plugin\PluginHelper; use Joomla\Database\DatabaseInterface; use Joomla\DI\Container; use Joomla\DI\ServiceProviderInterface; use Joomla\Event\DispatcherInterface; use Joomla\Plugin\User\Joomla\Extension\Joomla; return new class () implements ServiceProviderInterface { /** * Registers the service provider with a DI container. * * @param Container $container The DI container. * * @return void * * @since 4.4.0 */ public function register(Container $container): void { $container->set( PluginInterface::class, function (Container $container) { $dispatcher = $container->get(DispatcherInterface::class); $plugin = new Joomla( $dispatcher, (array) PluginHelper::getPlugin('user', 'joomla') ); $plugin->setApplication(Factory::getApplication()); $plugin->setDatabase($container->get(DatabaseInterface::class)); return $plugin; } ); } }; PK c�\�P�E �E event/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\8�d�~ ~ event/src/EventInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * Interface for events. * An event has a name and its propagation can be stopped. * * @since 1.0 */ interface EventInterface { /** * Get an event argument value. * * @param string $name The argument name. * @param mixed $default The default value if not found. * * @return mixed The argument value or the default value. * * @since 2.0.0 */ public function getArgument($name, $default = null); /** * Get the event name. * * @return string The event name. * * @since 1.0 */ public function getName(); /** * Tell if the event propagation is stopped. * * @return boolean True if stopped, false otherwise. * * @since 1.0 */ public function isStopped(); /** * Stops the propagation of the event to further event listeners. * * @return void * * @since 2.0.0 */ public function stopPropagation(): void; } PK c�\,�d�H H ! event/src/SubscriberInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * Interface for event subscribers. * * @since 2.0.0 */ interface SubscriberInterface { /** * Returns an array of events this subscriber will listen to. * * The array keys are event names and the value can be: * * - The method name to call (priority defaults to 0) * - An array composed of the method name to call and the priority * * For instance: * * * array('eventName' => 'methodName') * * array('eventName' => array('methodName', $priority)) * * @return array * * @since 2.0.0 */ public static function getSubscribedEvents(): array; } PK c�\�� event/src/Priority.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * An enumeration of priorities for event listeners that you are encouraged to use when adding them in the Dispatcher. * * @since 1.0 */ final class Priority { /** * Indicates the event listener should have a minimum priority. * * @var integer * @since 1.0 */ public const MIN = -3; /** * Indicates the event listener should have a low priority. * * @var integer * @since 1.0 */ public const LOW = -2; /** * Indicates the event listener should have a below normal priority. * * @var integer * @since 1.0 */ public const BELOW_NORMAL = -1; /** * Indicates the event listener should have a normal priority. This is the default priority. * * @var integer * @since 1.0 */ public const NORMAL = 0; /** * Indicates the event listener should have a above normal priority. * * @var integer * @since 1.0 */ public const ABOVE_NORMAL = 1; /** * Indicates the event listener should have a high priority. * * @var integer * @since 1.0 */ public const HIGH = 2; /** * Indicates the event listener should have a maximum priority. * * @var integer * @since 1.0 */ public const MAX = 3; /** * Disallow instantiation of this class * * @since 1.0 */ private function __construct() { } } PK c�\�Cu� � & event/src/DispatcherAwareInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * Interface to be implemented by classes depending on a dispatcher. * * @since 1.0 */ interface DispatcherAwareInterface { /** * Set the dispatcher to use. * * @param DispatcherInterface $dispatcher The dispatcher to use. * * @return DispatcherAwareInterface This method is chainable. * * @since 1.0 */ public function setDispatcher(DispatcherInterface $dispatcher); } PK c�\9���D D & event/src/LazyServiceEventListener.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; use Psr\Container\ContainerInterface; /** * Decorator for an event listener to be pulled from the service container. * * @since 2.0.0 */ final class LazyServiceEventListener { /** * The service container to load the service from * * @var string * @since 2.0.0 */ private $container; /** * The ID of the service from the container to be used * * @var string * @since 2.0.0 */ private $serviceId; /** * The method from the service to be called * * @var string * @since 2.0.0 */ private $method; /** * Constructor. * * @param ContainerInterface $container The service container to load the service from when it shall be executed * @param string $serviceId The ID of the service from the container to be used * @param string $method The method from the service to be called if necessary. If left empty, the service must be a callable; * (i.e. have an `__invoke()` method on a class) * * @since 2.0.0 * @throws \InvalidArgumentException if the service ID is empty */ public function __construct(ContainerInterface $container, string $serviceId, string $method = '') { if (empty($serviceId)) { throw new \InvalidArgumentException( sprintf( 'The $serviceId parameter cannot be empty in %s', self::class ) ); } $this->container = $container; $this->serviceId = $serviceId; $this->method = $method; } /** * Load a service from the container to listen to an event. * * @param EventInterface $event The event to process * * @return void * * @since 2.0.0 * @throws \InvalidArgumentException if the constructor's $method parameter is empty when not executing a callable service * @throws \RuntimeException if the service cannot be executed */ public function __invoke(EventInterface $event): void { if (!$this->container->has($this->serviceId)) { throw new \RuntimeException( sprintf( 'The "%s" service has not been registered to the service container', $this->serviceId ) ); } $service = $this->container->get($this->serviceId); // If the service is callable on its own, just execute it if (\is_callable($service)) { \call_user_func($service, $event); return; } if (empty($this->method)) { throw new \InvalidArgumentException( sprintf( 'The $method argument is required when creating a "%s" to call a method from the "%s" service.', self::class, $this->serviceId ) ); } if (!method_exists($service, $this->method)) { throw new \RuntimeException( sprintf( 'The "%s" method does not exist on "%s" (from service "%s")', $this->method, \get_class($service), $this->serviceId ) ); } \call_user_func([$service, $this->method], $event); } } PK c�\��4Ƥ � event/src/Event.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; use InvalidArgumentException; /** * Default Event class. * * @since 1.0 */ class Event extends AbstractEvent { /** * Add an event argument, only if it is not existing. * * @param string $name The argument name. * @param mixed $value The argument value. * * @return $this * * @since 1.0 */ public function addArgument($name, $value) { if (!isset($this->arguments[$name])) { $this->arguments[$name] = $value; } return $this; } /** * Add argument to event. * * @param string $name Argument name. * @param mixed $value Value. * * @return $this * * @since 1.0 */ public function setArgument($name, $value) { $this->arguments[$name] = $value; return $this; } /** * Remove an event argument. * * @param string $name The argument name. * * @return mixed The old argument value or null if it is not existing. * * @since 1.0 */ public function removeArgument($name) { $return = null; if (isset($this->arguments[$name])) { $return = $this->arguments[$name]; unset($this->arguments[$name]); } return $return; } /** * Clear all event arguments. * * @return array The old arguments. * * @since 1.0 */ public function clearArguments() { $arguments = $this->arguments; $this->arguments = []; return $arguments; } /** * Stop the event propagation. * * @return void * * @since 1.0 * @deprecated 3.0 Use stopPropogation instead */ public function stop() { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::stopPropagation() instead.', __METHOD__, EventInterface::class ); $this->stopPropagation(); } /** * Set the value of an event argument. * * @param string $name The argument name. * @param mixed $value The argument value. * * @return void * * @since 1.0 * @throws InvalidArgumentException If the argument name is null. */ #[\ReturnTypeWillChange] public function offsetSet($name, $value) { if ($name === null) { throw new InvalidArgumentException('The argument name cannot be null.'); } $this->setArgument($name, $value); } /** * Remove an event argument. * * @param string $name The argument name. * * @return void * * @since 1.0 */ #[\ReturnTypeWillChange] public function offsetUnset($name) { $this->removeArgument($name); } } PK c�\�)�x $ event/src/ListenersPriorityQueue.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * A class containing an inner listeners priority queue that can be iterated multiple times. * * @since 1.0 * @internal */ final class ListenersPriorityQueue implements \IteratorAggregate, \Countable { /** * The listeners for an event. * * @var array * @since 2.0.0 */ private $listeners = []; /** * Add a listener with the given priority only if not already present. * * @param callable $callback A callable function acting as an event listener. * @param integer $priority The listener priority. * * @return $this * * @since 1.0 */ public function add(callable $callback, int $priority): self { $this->listeners[$priority][] = $callback; return $this; } /** * Remove a listener from the queue. * * @param callable $callback A callable function acting as an event listener. * * @return $this * * @since 1.0 */ public function remove(callable $callback): self { foreach ($this->listeners as $priority => $listeners) { if (($key = array_search($callback, $listeners, true)) !== false) { unset($this->listeners[$priority][$key]); } } return $this; } /** * Tell if the listener exists in the queue. * * @param callable $callback A callable function acting as an event listener. * * @return boolean True if it exists, false otherwise. * * @since 1.0 */ public function has(callable $callback): bool { foreach ($this->listeners as $priority => $listeners) { if (($key = array_search($callback, $listeners, true)) !== false) { return true; } } return false; } /** * Get the priority of the given listener. * * @param callable $callback A callable function acting as an event listener. * @param mixed $default The default value to return if the listener doesn't exist. * * @return mixed The listener priority if it exists or the specified default value * * @since 1.0 */ public function getPriority(callable $callback, $default = null) { foreach ($this->listeners as $priority => $listeners) { if (($key = array_search($callback, $listeners, true)) !== false) { return $priority; } } return $default; } /** * Get all listeners contained in this queue, sorted according to their priority. * * @return callable[] An array of listeners. * * @since 1.0 */ public function getAll(): array { if (empty($this->listeners)) { return []; } krsort($this->listeners); return \call_user_func_array('array_merge', $this->listeners); } /** * Get the priority queue. * * @return \ArrayIterator * * @since 1.0 */ #[\ReturnTypeWillChange] public function getIterator() { return new \ArrayIterator($this->getAll()); } /** * Count the number of listeners in the queue. * * @return integer The number of listeners in the queue. * * @since 1.0 */ #[\ReturnTypeWillChange] public function count() { $count = 0; foreach ($this->listeners as $priority) { $count += \count($priority); } return $count; } } PK c�\<j� event/src/EventImmutable.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; use BadMethodCallException; /** * Implementation of an immutable Event. * An immutable event cannot be modified after instanciation : * * - its propagation cannot be stopped * - its arguments cannot be modified * * You may want to use this event when you want to ensure that * the listeners won't manipulate it. * * @since 1.0 */ final class EventImmutable extends AbstractEvent { /** * A flag to see if the constructor has been * already called. * * @var boolean */ private $constructed = false; /** * Constructor. * * @param string $name The event name. * @param array $arguments The event arguments. * * @throws BadMethodCallException * * @since 1.0 */ public function __construct($name, array $arguments = []) { if ($this->constructed) { throw new BadMethodCallException( sprintf('Cannot reconstruct the EventImmutable %s.', $this->name) ); } $this->constructed = true; parent::__construct($name, $arguments); } /** * Set the value of an event argument. * * @param string $name The argument name. * @param mixed $value The argument value. * * @return void * * @since 1.0 * @throws BadMethodCallException */ public function offsetSet($name, $value) { throw new BadMethodCallException( sprintf( 'Cannot set the argument %s of the immutable event %s.', $name, $this->name ) ); } /** * Remove an event argument. * * @param string $name The argument name. * * @return void * * @throws BadMethodCallException * * @since 1.0 */ public function offsetUnset($name) { throw new BadMethodCallException( sprintf( 'Cannot remove the argument %s of the immutable event %s.', $name, $this->name ) ); } } PK c�\� �� ! event/src/DispatcherInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * Interface for event dispatchers. * * @since 1.0 */ interface DispatcherInterface { /** * Dispatches an event to all registered listeners. * * @param string $name The name of the event to dispatch. * @param EventInterface $event The event to pass to the event handlers/listeners. * If not supplied, an empty EventInterface instance is created. * Note, not passing an event is deprecated and will be required as of 3.0. * * @return EventInterface * * @since 2.0.0 */ public function dispatch(string $name, ?EventInterface $event = null): EventInterface; /** * Attaches a listener to an event * * @param string $eventName The event to listen to. * @param callable $callback A callable function. * @param integer $priority The priority at which the $callback executed. * * @return boolean * * @since 2.0.0 */ public function addListener(string $eventName, callable $callback, int $priority = 0): bool; /** * Clear the listeners in this dispatcher. * * If an event is specified, the listeners will be cleared only for that event. * * @param string $event The event name. * * @return $this * * @since 2.0.0 */ public function clearListeners($event = null); /** * Count the number of registered listeners for the given event. * * @param string $event The event name. * * @return integer * * @since 2.0.0 */ public function countListeners($event); /** * Get the listeners registered to the given event. * * @param string|null $event The event to fetch listeners for or null to fetch all listeners * * @return callable[] An array of registered listeners sorted according to their priorities. * * @since 2.0.0 */ public function getListeners(?string $event = null); /** * Tell if the given listener has been added. * * If an event is specified, it will tell if the listener is registered for that event. * * @param callable $callback The callable to check is listening to the event. * @param string|null $eventName An optional event name to check a listener is subscribed to. * * @return boolean True if the listener is registered, false otherwise. * * @since 2.0.0 */ public function hasListener(callable $callback, ?string $eventName = null); /** * Removes an event listener from the specified event. * * @param string $eventName The event to remove a listener from. * @param callable $listener The listener to remove. * * @return void * * @since 2.0.0 */ public function removeListener(string $eventName, callable $listener): void; /** * Adds an event subscriber. * * @param SubscriberInterface $subscriber The subscriber. * * @return void * * @since 2.0.0 */ public function addSubscriber(SubscriberInterface $subscriber): void; /** * Removes an event subscriber. * * @param SubscriberInterface $subscriber The subscriber. * * @return void * * @since 2.0.0 */ public function removeSubscriber(SubscriberInterface $subscriber): void; } PK c�\���� � event/src/AbstractEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; use ArrayAccess; use Countable; use Serializable; /** * Implementation of EventInterface. * * @since 1.0 */ abstract class AbstractEvent implements EventInterface, ArrayAccess, Serializable, Countable { /** * The event name. * * @var string * @since 1.0 */ protected $name; /** * The event arguments. * * @var array * @since 1.0 */ protected $arguments; /** * A flag to see if the event propagation is stopped. * * @var boolean * @since 1.0 */ protected $stopped = false; /** * Constructor. * * @param string $name The event name. * @param array $arguments The event arguments. * * @since 1.0 */ public function __construct($name, array $arguments = []) { $this->name = $name; $this->arguments = $arguments; } /** * Get the event name. * * @return string The event name. * * @since 1.0 */ public function getName() { return $this->name; } /** * Get an event argument value. * * @param string $name The argument name. * @param mixed $default The default value if not found. * * @return mixed The argument value or the default value. * * @since 1.0 */ public function getArgument($name, $default = null) { if (isset($this->arguments[$name])) { return $this->arguments[$name]; } return $default; } /** * Tell if the given event argument exists. * * @param string $name The argument name. * * @return boolean True if it exists, false otherwise. * * @since 1.0 */ public function hasArgument($name) { return isset($this->arguments[$name]); } /** * Get all event arguments. * * @return array An associative array of argument names as keys and their values as values. * * @since 1.0 */ public function getArguments() { return $this->arguments; } /** * Tell if the event propagation is stopped. * * @return boolean True if stopped, false otherwise. * * @since 1.0 */ public function isStopped() { return $this->stopped === true; } /** * Stops the propagation of the event to further event listeners. * * @return void * * @since 2.0.0 */ public function stopPropagation(): void { $this->stopped = true; } /** * Count the number of arguments. * * @return integer The number of arguments. * * @since 1.0 */ #[\ReturnTypeWillChange] public function count() { return \count($this->arguments); } /** * Serialize the event. * * @return string The serialized event. * * @since 1.0 */ public function serialize() { return serialize($this->__serialize()); } /** * Serialize the event. * * @return array The data to be serialized * * @since 2.0.0 */ public function __serialize() { return [ 'name' => $this->name, 'arguments' => $this->arguments, 'stopped' => $this->stopped, ]; } /** * Unserialize the event. * * @param string $serialized The serialized event. * * @return void * * @since 1.0 */ public function unserialize($serialized) { $this->__unserialize(unserialize($serialized)); } /** * Unserialize the event. * * @param array $data The serialized event. * * @return void * * @since 2.0.0 */ public function __unserialize(array $data) { $this->name = $data['name']; $this->arguments = $data['arguments']; $this->stopped = $data['stopped']; } /** * Tell if the given event argument exists. * * @param string $name The argument name. * * @return boolean True if it exists, false otherwise. * * @since 1.0 */ #[\ReturnTypeWillChange] public function offsetExists($name) { return $this->hasArgument($name); } /** * Get an event argument value. * * @param string $name The argument name. * * @return mixed The argument value or null if not existing. * * @since 1.0 */ #[\ReturnTypeWillChange] public function offsetGet($name) { return $this->getArgument($name); } } PK c�\���J. J. event/src/Dispatcher.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * Implementation of a DispatcherInterface supporting prioritized listeners. * * @since 1.0 */ class Dispatcher implements DispatcherInterface { /** * An array of registered events indexed by the event names. * * @var EventInterface[] * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ protected $events = []; /** * An array of ListenersPriorityQueue indexed by the event names. * * @var ListenersPriorityQueue[] * @since 1.0 */ protected $listeners = []; /** * Set an event to the dispatcher. It will replace any event with the same name. * * @param EventInterface $event The event. * * @return $this * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function setEvent(EventInterface $event) { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); $this->events[$event->getName()] = $event; return $this; } /** * Add an event to this dispatcher, only if it is not existing. * * @param EventInterface $event The event. * * @return $this * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function addEvent(EventInterface $event) { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); if (!isset($this->events[$event->getName()])) { $this->events[$event->getName()] = $event; } return $this; } /** * Tell if the given event has been added to this dispatcher. * * @param EventInterface|string $event The event object or name. * * @return boolean True if the listener has the given event, false otherwise. * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function hasEvent($event) { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); if ($event instanceof EventInterface) { $event = $event->getName(); } return isset($this->events[$event]); } /** * Get the event object identified by the given name. * * @param string $name The event name. * @param mixed $default The default value if the event was not registered. * * @return EventInterface|mixed The event of the default value. * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function getEvent($name, $default = null) { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); if (isset($this->events[$name])) { return $this->events[$name]; } return $default; } /** * Remove an event from this dispatcher. The registered listeners will remain. * * @param EventInterface|string $event The event object or name. * * @return $this * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function removeEvent($event) { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); if ($event instanceof EventInterface) { $event = $event->getName(); } if (isset($this->events[$event])) { unset($this->events[$event]); } return $this; } /** * Get the registered events. * * @return EventInterface[] The registered event. * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function getEvents() { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); return $this->events; } /** * Clear all events. * * @return EventInterface[] The old events. * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function clearEvents() { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); $events = $this->events; $this->events = []; return $events; } /** * Count the number of registered event. * * @return integer The numer of registered events. * * @since 1.0 * @deprecated 3.0 Default event objects will no longer be supported */ public function countEvents() { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); return \count($this->events); } /** * Attaches a listener to an event * * @param string $eventName The event to listen to. * @param callable $callback A callable function * @param integer $priority The priority at which the $callback executed * * @return boolean * * @since 1.0 */ public function addListener(string $eventName, callable $callback, int $priority = 0): bool { if (!isset($this->listeners[$eventName])) { $this->listeners[$eventName] = new ListenersPriorityQueue; } $this->listeners[$eventName]->add($callback, $priority); return true; } /** * Get the priority of the given listener for the given event. * * @param string $eventName The event to listen to. * @param callable $callback A callable function * * @return mixed The listener priority or null if the listener doesn't exist. * * @since 1.0 */ public function getListenerPriority($eventName, callable $callback) { if (isset($this->listeners[$eventName])) { return $this->listeners[$eventName]->getPriority($callback); } } /** * Get the listeners registered to the given event. * * @param string|null $event The event to fetch listeners for or null to fetch all listeners * * @return callable[] An array of registered listeners sorted according to their priorities. * * @since 1.0 */ public function getListeners(?string $event = null) { if ($event !== null) { if (isset($this->listeners[$event])) { return $this->listeners[$event]->getAll(); } return []; } $dispatcherListeners = []; foreach ($this->listeners as $registeredEvent => $listeners) { $dispatcherListeners[$registeredEvent] = $listeners->getAll(); } return $dispatcherListeners; } /** * Tell if the given listener has been added. * * If an event is specified, it will tell if the listener is registered for that event. * * @param callable $callback The callable to check is listening to the event. * @param string $eventName An optional event name to check a listener is subscribed to. * * @return boolean True if the listener is registered, false otherwise. * * @since 1.0 */ public function hasListener(callable $callback, ?string $eventName = null) { if ($eventName) { if (isset($this->listeners[$eventName])) { return $this->listeners[$eventName]->has($callback); } } else { foreach ($this->listeners as $queue) { if ($queue->has($callback)) { return true; } } } return false; } /** * Removes an event listener from the specified event. * * @param string $eventName The event to remove a listener from. * @param callable $listener The listener to remove. * * @return void * * @since 2.0.0 */ public function removeListener(string $eventName, callable $listener): void { if (isset($this->listeners[$eventName])) { $this->listeners[$eventName]->remove($listener); } } /** * Clear the listeners in this dispatcher. * * If an event is specified, the listeners will be cleared only for that event. * * @param string $event The event name. * * @return $this * * @since 1.0 */ public function clearListeners($event = null) { if ($event) { if (isset($this->listeners[$event])) { unset($this->listeners[$event]); } } else { $this->listeners = []; } return $this; } /** * Count the number of registered listeners for the given event. * * @param string $event The event name. * * @return integer * * @since 1.0 */ public function countListeners($event) { return isset($this->listeners[$event]) ? \count($this->listeners[$event]) : 0; } /** * Adds an event subscriber. * * @param SubscriberInterface $subscriber The subscriber. * * @return void * * @since 2.0.0 */ public function addSubscriber(SubscriberInterface $subscriber): void { foreach ($subscriber->getSubscribedEvents() as $eventName => $params) { if (\is_array($params)) { $this->addListener($eventName, [$subscriber, $params[0]], $params[1] ?? Priority::NORMAL); } else { $this->addListener($eventName, [$subscriber, $params]); } } } /** * Removes an event subscriber. * * @param SubscriberInterface $subscriber The subscriber. * * @return void * * @since 2.0.0 */ public function removeSubscriber(SubscriberInterface $subscriber): void { foreach ($subscriber->getSubscribedEvents() as $eventName => $params) { if (\is_array($params)) { $this->removeListener($eventName, [$subscriber, $params[0]]); } else { $this->removeListener($eventName, [$subscriber, $params]); } } } /** * Dispatches an event to all registered listeners. * * @param string $name The name of the event to dispatch. * @param EventInterface $event The event to pass to the event handlers/listeners. * If not supplied, an empty EventInterface instance is created. * Note, not passing an event is deprecated and will be required as of 3.0. * * @return EventInterface * * @since 2.0.0 */ public function dispatch(string $name, ?EventInterface $event = null): EventInterface { if (!($event instanceof EventInterface)) { trigger_deprecation( 'joomla/event', '2.0.0', 'Not passing an event object to %s() is deprecated, as of 3.0 the $event argument will be required.', __METHOD__ ); $event = $this->getDefaultEvent($name); } if (isset($this->listeners[$event->getName()])) { foreach ($this->listeners[$event->getName()] as $listener) { if ($event->isStopped()) { return $event; } $listener($event); } } return $event; } /** * Trigger an event. * * @param EventInterface|string $event The event object or name. * * @return EventInterface The event after being passed through all listeners. * * @since 1.0 * @deprecated 3.0 Use dispatch() instead. */ public function triggerEvent($event) { trigger_deprecation( 'joomla/event', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::dispatch() instead.', __METHOD__, DispatcherInterface::class ); if (!($event instanceof EventInterface)) { $event = $this->getDefaultEvent($event); } return $this->dispatch($event->getName(), $event); } /** * Get an event object for the specified event name * * @param string $name The event name to get an EventInterface object for * * @return EventInterface * * @since 2.0.0 * @deprecated 3.0 Default event objects will no longer be supported */ private function getDefaultEvent(string $name): EventInterface { if (isset($this->events[$name])) { return $this->events[$name]; } return new Event($name); } } PK c�\u��f f " event/src/DispatcherAwareTrait.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event; /** * Defines the trait for a Dispatcher Aware Class. * * @since 1.2.0 */ trait DispatcherAwareTrait { /** * Event Dispatcher * * @var DispatcherInterface|null * @since 1.2.0 */ private $dispatcher; /** * Get the event dispatcher. * * @return DispatcherInterface * * @since 1.2.0 * @throws \UnexpectedValueException May be thrown if the dispatcher has not been set. */ public function getDispatcher() { if ($this->dispatcher) { return $this->dispatcher; } throw new \UnexpectedValueException('Dispatcher not set in ' . __CLASS__); } /** * Set the dispatcher to use. * * @param DispatcherInterface $dispatcher The dispatcher to use. * * @return $this * * @since 1.2.0 */ public function setDispatcher(DispatcherInterface $dispatcher) { $this->dispatcher = $dispatcher; return $this; } } PK c�\���_� � 1 event/src/Command/DebugEventDispatcherCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Event Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Event\Command; use Joomla\Console\Command\AbstractCommand; use Joomla\Event\DispatcherAwareInterface; use Joomla\Event\DispatcherAwareTrait; use Joomla\Event\DispatcherInterface; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Style\SymfonyStyle; /** * Command listing information about the application's event dispatcher. * * @since 2.0.0 */ class DebugEventDispatcherCommand extends AbstractCommand implements DispatcherAwareInterface { use DispatcherAwareTrait; /** * The default command name * * @var string * @since 2.0.0 */ protected static $defaultName = 'debug:event-dispatcher'; /** * Instantiate the command. * * @param DispatcherInterface $dispatcher The application event dispatcher. * * @since 2.0.0 */ public function __construct(DispatcherInterface $dispatcher) { $this->setDispatcher($dispatcher); parent::__construct(); } /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { $this->setDescription("Displays information about the application's event dispatcher"); $this->addArgument('event', InputArgument::OPTIONAL, 'Show the listeners for a specific event'); $this->setHelp(<<<'EOF' The <info>%command.name%</info> command lists all of the registered event handlers in an application's event dispatcher: <info>php %command.full_name%</info> To get specific listeners for an event, specify its name: <info>php %command.full_name% application.before_execute</info> EOF ); } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ protected function doExecute(InputInterface $input, OutputInterface $output): int { $io = new SymfonyStyle($input, $output); if ($event = $input->getArgument('event')) { $listeners = $this->dispatcher->getListeners($event); if (empty($listeners)) { $io->warning(sprintf('The event "%s" does not have any registered listeners.', $event)); return 0; } $io->title(sprintf('%s Registered Listeners for "%s" Event', $this->getApplication()->getName(), $event)); $this->renderEventListenerTable($listeners, $io); return 0; } $listeners = $this->dispatcher->getListeners(); if (empty($listeners)) { $io->comment('There are no listeners registered to the event dispatcher.'); return 0; } $io->title(sprintf('%s Registered Listeners Grouped By Event', $this->getApplication()->getName())); ksort($listeners); foreach ($listeners as $subscribedEvent => $eventListeners) { $io->section(sprintf('"%s" event', $subscribedEvent)); $this->renderEventListenerTable($eventListeners, $io); } return 0; } /** * Formats a callable resource to be displayed in the console output * * @param callable $callable A callable resource to format * * @return string * * @since 2.0.0 * @throws \ReflectionException * @note This method is based on \Symfony\Bundle\FrameworkBundle\Console\Descriptor\TextDescriptor::formatCallable() */ private function formatCallable($callable): string { if (\is_array($callable)) { if (\is_object($callable[0])) { return sprintf('%s::%s()', \get_class($callable[0]), $callable[1]); } return sprintf('%s::%s()', $callable[0], $callable[1]); } if (\is_string($callable)) { return sprintf('%s()', $callable); } if ($callable instanceof \Closure) { $r = new \ReflectionFunction($callable); if (strpos($r->name, '{closure}') !== false) { return 'Closure()'; } if (null !== $class = $r->getClosureScopeClass()) { return sprintf('%s::%s()', $class->name, $r->name); } return $r->name . '()'; } if (method_exists($callable, '__invoke')) { return sprintf('%s::__invoke()', \get_class($callable)); } throw new \InvalidArgumentException('Callable is not describable.'); } /** * Renders the table of listeners for an event * * @param array $eventListeners The listeners for an event * @param SymfonyStyle $io The I/O helper * * @return void * * @since 2.0.0 */ private function renderEventListenerTable(array $eventListeners, SymfonyStyle $io): void { $tableHeaders = ['Order', 'Callable']; $tableRows = []; foreach ($eventListeners as $order => $listener) { $tableRows[] = [ sprintf('#%d', $order + 1), $this->formatCallable($listener), ]; } $io->table($tableHeaders, $tableRows); } } PK c�\�M filter/PATCHES.txtnu �[��� This file was automatically generated by Composer Patches (https://github.com/cweagans/composer-patches) Patches applied to this directory: InputFilter:remove XSS evasion chars in attribute Source: ./build/composer_patches/4.4.14-2025-09-23_php-InputFilter.patch PK c�\� �g �g filter/src/InputFilter.phpnu �[��� <?php /** * Part of the Joomla Framework Filter Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filter; use Joomla\String\StringHelper; /** * InputFilter is a class for filtering input from any data source * * Forked from the php input filter library by: Daniel Morris <dan@rootcube.com> * Original Contributors: Gianpaolo Racca, Ghislain Picard, Marco Wandschneider, Chris Tobin and Andrew Eddie. * * @since 1.0 */ class InputFilter { /** * Defines the InputFilter instance should only allow the supplied list of HTML tags. * * @var integer * @since 1.4.0 */ const ONLY_ALLOW_DEFINED_TAGS = 0; /** * Defines the InputFilter instance should block the defined list of HTML tags and allow all others. * * @var integer * @since 1.4.0 */ const ONLY_BLOCK_DEFINED_TAGS = 1; /** * Defines the InputFilter instance should only allow the supplied list of attributes. * * @var integer * @since 1.4.0 */ const ONLY_ALLOW_DEFINED_ATTRIBUTES = 0; /** * Defines the InputFilter instance should block the defined list of attributes and allow all others. * * @var integer * @since 1.4.0 */ const ONLY_BLOCK_DEFINED_ATTRIBUTES = 1; /** * The array of permitted tags. * * @var array * @since 1.0 */ public $tagsArray; /** * The array of permitted tag attributes. * * @var array * @since 1.0 */ public $attrArray; /** * The method for sanitising tags * * @var integer * @since 1.0 */ public $tagsMethod; /** * The method for sanitising attributes * * @var integer * @since 1.0 */ public $attrMethod; /** * A flag for XSS checks. Only auto clean essentials = 0, Allow clean blocked tags/attr = 1 * * @var integer * @since 1.0 */ public $xssAuto; /** * The list the blocked tags for the instance. * * @var string[] * @since 1.0 */ public $blockedTags = [ 'applet', 'body', 'bgsound', 'base', 'basefont', 'canvas', 'embed', 'frame', 'frameset', 'head', 'html', 'id', 'iframe', 'ilayer', 'layer', 'link', 'meta', 'name', 'object', 'script', 'style', 'title', 'xml', ]; /** * The list of blocked tag attributes for the instance. * * @var string[] * @since 1.0 */ public $blockedAttributes = [ 'action', 'background', 'codebase', 'dynsrc', 'formaction', 'lowsrc', ]; /** * A special list of blocked characters. * * @var string[] * @since 1.3.3 */ private $blockedChars = [ '&tab;', '&space;', ':', '&column;', ]; /** * Constructor for InputFilter class. * * @param array $tagsArray List of permitted HTML tags * @param array $attrArray List of permitted HTML tag attributes * @param integer $tagsMethod Method for filtering tags, should be one of the `ONLY_*_DEFINED_TAGS` constants * @param integer $attrMethod Method for filtering attributes, should be one of the `ONLY_*_DEFINED_ATTRIBUTES` constants * @param integer $xssAuto Only auto clean essentials = 0, Allow clean blocked tags/attributes = 1 * * @since 1.0 */ public function __construct(array $tagsArray = [], array $attrArray = [], $tagsMethod = self::ONLY_ALLOW_DEFINED_TAGS, $attrMethod = self::ONLY_ALLOW_DEFINED_ATTRIBUTES, $xssAuto = 1 ) { // Make sure user defined arrays are in lowercase $tagsArray = array_map('strtolower', (array) $tagsArray); $attrArray = array_map('strtolower', (array) $attrArray); // Assign member variables $this->tagsArray = $tagsArray; $this->attrArray = $attrArray; $this->tagsMethod = $tagsMethod; $this->attrMethod = $attrMethod; $this->xssAuto = $xssAuto; } /** * Cleans the given input source based on the instance configuration and specified data type * * @param string|string[]|object $source Input string/array-of-string/object to be 'cleaned' * @param string $type The return type for the variable: * INT: An integer * UINT: An unsigned integer * FLOAT: A floating point number * BOOLEAN: A boolean value * WORD: A string containing A-Z or underscores only (not case sensitive) * ALNUM: A string containing A-Z or 0-9 only (not case sensitive) * CMD: A string containing A-Z, 0-9, underscores, periods or hyphens (not case * sensitive) * BASE64: A string containing A-Z, 0-9, forward slashes, plus or equals (not case * sensitive) * STRING: A fully decoded and sanitised string (default) * HTML: A sanitised string * ARRAY: An array * PATH: A sanitised file path * TRIM: A string trimmed from normal, non-breaking and multibyte spaces * USERNAME: Do not use (use an application specific filter) * RAW: The raw string is returned with no filtering * unknown: An unknown filter will act like STRING. If the input is an array it will * return an array of fully decoded and sanitised strings. * * @return mixed 'Cleaned' version of the `$source` parameter * * @since 1.0 */ public function clean($source, $type = 'string') { $type = ucfirst(strtolower($type)); if ($type === 'Array') { return (array) $source; } if ($type === 'Raw') { return $source; } if (\is_array($source)) { $result = []; foreach ($source as $key => $value) { $result[$key] = $this->clean($value, $type); } return $result; } if (\is_object($source)) { foreach (get_object_vars($source) as $key => $value) { $source->$key = $this->clean($value, $type); } return $source; } $method = 'clean' . $type; if (method_exists($this, $method)) { return $this->$method((string) $source); } // Unknown filter method if (\is_string($source) && !empty($source)) { // Filter source for XSS and other 'bad' code etc. return $this->cleanString($source); } // Not an array or string... return the passed parameter return $source; } /** * Function to determine if contents of an attribute are safe * * @param array $attrSubSet A 2 element array for attribute's name, value * * @return boolean True if bad code is detected * * @since 1.0 */ public static function checkAttribute($attrSubSet) { $attrSubSet[0] = strtolower($attrSubSet[0]); $attrSubSet[1] = html_entity_decode(strtolower($attrSubSet[1]), ENT_QUOTES | ENT_HTML401, 'UTF-8'); // Remove common XSS-evasion characters $attrSubSet[1] = str_replace(["\t", "\n", " ", "\0"], "", $attrSubSet[1]); return (strpos($attrSubSet[1], 'expression') !== false && $attrSubSet[0] === 'style') || preg_match('/(?:(?:java|vb|live)script|behaviour|mocha)(?::|:|&column;)/', $attrSubSet[1]) !== 0; } /** * Internal method to iteratively remove all unwanted tags and attributes * * @param string $source Input string to be 'cleaned' * * @return string 'Cleaned' version of input parameter * * @since 1.0 */ protected function remove($source) { // Iteration provides nested tag protection do { $temp = $source; $source = $this->cleanTags($source); } while ($temp !== $source); return $source; } /** * Internal method to strip a string of disallowed tags * * @param string $source Input string to be 'cleaned' * * @return string 'Cleaned' version of input parameter * * @since 1.0 */ protected function cleanTags($source) { // First, pre-process this for illegal characters inside attribute values $source = $this->escapeAttributeValues($source); // In the beginning we don't really have a tag, so everything is postTag $preTag = null; $postTag = $source; $currentSpace = false; // Setting to null to deal with undefined variables $attr = ''; // Is there a tag? If so it will certainly start with a '<'. $tagOpenStart = strpos($source, '<'); while ($tagOpenStart !== false) { // Get some information about the tag we are processing $preTag .= substr($postTag, 0, $tagOpenStart); $postTag = substr($postTag, $tagOpenStart); $fromTagOpen = substr($postTag, 1); $tagOpenEnd = strpos($fromTagOpen, '>'); // Check for mal-formed tag where we have a second '<' before the first '>' $nextOpenTag = (strlen($postTag) > $tagOpenStart) ? strpos($postTag, '<', $tagOpenStart + 1) : false; if (($nextOpenTag !== false) && ($nextOpenTag < $tagOpenEnd)) { // At this point we have a mal-formed tag -- remove the offending open $postTag = substr($postTag, 0, $tagOpenStart) . substr($postTag, $tagOpenStart + 1); $tagOpenStart = strpos($postTag, '<'); continue; } // Let's catch any non-terminated tags and skip over them if ($tagOpenEnd === false) { $postTag = substr($postTag, $tagOpenStart + 1); $tagOpenStart = strpos($postTag, '<'); continue; } // Do we have a nested tag? $tagOpenNested = strpos($fromTagOpen, '<'); if (($tagOpenNested !== false) && ($tagOpenNested < $tagOpenEnd)) { $preTag .= substr($postTag, 1, $tagOpenNested); $postTag = substr($postTag, ($tagOpenNested + 1)); $tagOpenStart = strpos($postTag, '<'); continue; } // Let's get some information about our tag and setup attribute pairs $tagOpenNested = (strpos($fromTagOpen, '<') + $tagOpenStart + 1); $currentTag = substr($fromTagOpen, 0, $tagOpenEnd); $tagLength = strlen($currentTag); $tagLeft = $currentTag; $attrSet = []; $currentSpace = strpos($tagLeft, ' '); // Are we an open tag or a close tag? if (substr($currentTag, 0, 1) === '/') { // Close Tag $isCloseTag = true; list($tagName) = explode(' ', $currentTag); $tagName = substr($tagName, 1); } else { // Open Tag $isCloseTag = false; list($tagName) = explode(' ', $currentTag); } /* * Exclude all "non-regular" tagnames * OR no tagname * OR remove if xssauto is on and tag is blocked */ if ((!preg_match('/^[a-z][a-z0-9]*$/i', $tagName)) || (!$tagName) || ((\in_array(strtolower($tagName), $this->blockedTags)) && $this->xssAuto)) { $postTag = substr($postTag, ($tagLength + 2)); $tagOpenStart = strpos($postTag, '<'); // Strip tag continue; } /* * Time to grab any attributes from the tag... need this section in * case attributes have spaces in the values. */ while ($currentSpace !== false) { $attr = ''; $fromSpace = substr($tagLeft, ($currentSpace + 1)); $nextEqual = strpos($fromSpace, '='); $nextSpace = strpos($fromSpace, ' '); $openQuotes = strpos($fromSpace, '"'); $closeQuotes = strpos(substr($fromSpace, ($openQuotes + 1)), '"') + $openQuotes + 1; $startAtt = ''; $startAttPosition = 0; // Find position of equal and open quotes ignoring if (preg_match('#\s*=\s*\"#', $fromSpace, $matches, \PREG_OFFSET_CAPTURE)) { $stringBeforeAttr = substr($fromSpace, 0, $matches[0][1]); $startAttPosition = strlen($stringBeforeAttr); $startAtt = $matches[0][0]; $closeQuotePos = strpos( substr($fromSpace, ($startAttPosition + strlen($startAtt))), '"' ); $closeQuotes = $closeQuotePos + $startAttPosition + strlen($startAtt); $nextEqual = $startAttPosition + strpos($startAtt, '='); $openQuotes = $startAttPosition + strpos($startAtt, '"'); $nextSpace = strpos(substr($fromSpace, $closeQuotes), ' ') + $closeQuotes; } // Do we have an attribute to process? [check for equal sign] if ($fromSpace !== '/' && (($nextEqual && $nextSpace && $nextSpace < $nextEqual) || !$nextEqual)) { if (!$nextEqual) { $attribEnd = strpos($fromSpace, '/') - 1; } else { $attribEnd = $nextSpace - 1; } // If there is an ending, use this, if not, do not worry. if ($attribEnd > 0) { $fromSpace = substr($fromSpace, $attribEnd + 1); } } if (strpos($fromSpace, '=') !== false) { /* * If the attribute value is wrapped in quotes we need to grab the substring from the closing quote, * otherwise grab until the next space. */ if (($openQuotes !== false) && (strpos(substr($fromSpace, ($openQuotes + 1)), '"') !== false)) { $attr = substr($fromSpace, 0, ($closeQuotes + 1)); } else { $attr = substr($fromSpace, 0, $nextSpace); } } else { // No more equal signs so add any extra text in the tag into the attribute array [eg. checked] if ($fromSpace !== '/') { $attr = substr($fromSpace, 0, $nextSpace); } } // Last Attribute Pair if (!$attr && $fromSpace !== '/') { $attr = $fromSpace; } // Add attribute pair to the attribute array $attrSet[] = $attr; // Move search point and continue iteration $tagLeft = substr($fromSpace, strlen($attr)); $currentSpace = strpos($tagLeft, ' '); } // Is our tag in the user input array? $tagFound = \in_array(strtolower($tagName), $this->tagsArray); // If the tag is allowed let's append it to the output string. if ((!$tagFound && $this->tagsMethod) || ($tagFound && !$this->tagsMethod)) { // Reconstruct tag with allowed attributes if (!$isCloseTag) { // Open or single tag $attrSet = $this->cleanAttributes($attrSet); $preTag .= '<' . $tagName; for ($i = 0, $count = \count($attrSet); $i < $count; $i++) { $preTag .= ' ' . $attrSet[$i]; } // Reformat single tags to XHTML if (strpos($fromTagOpen, '</' . $tagName)) { $preTag .= '>'; } else { $preTag .= ' />'; } } else { // Closing tag $preTag .= '</' . $tagName . '>'; } } // Find next tag's start and continue iteration $postTag = substr($postTag, ($tagLength + 2)); $tagOpenStart = strpos($postTag, '<'); } // Append any code after the end of tags and return if ($postTag !== '<') { $preTag .= $postTag; } return $preTag; } /** * Internal method to strip a tag of disallowed attributes * * @param array $attrSet Array of attribute pairs to filter * * @return array Filtered array of attribute pairs * * @since 1.0 */ protected function cleanAttributes(array $attrSet) { $newSet = []; $count = \count($attrSet); // Iterate through attribute pairs for ($i = 0; $i < $count; $i++) { // Skip blank spaces if (!$attrSet[$i]) { continue; } // Split into name/value pairs $attrSubSet = explode('=', trim($attrSet[$i]), 2); // Take the last attribute in case there is an attribute with no value $attrSubSet0 = explode(' ', trim($attrSubSet[0])); $attrSubSet[0] = array_pop($attrSubSet0); $attrSubSet[0] = strtolower($attrSubSet[0]); $quoteStyle = \ENT_QUOTES | \ENT_HTML401; // Remove all spaces as valid attributes does not have spaces. $attrSubSet[0] = html_entity_decode($attrSubSet[0], $quoteStyle, 'UTF-8'); $attrSubSet[0] = preg_replace('/^[\pZ\pC]+|[\pZ\pC]+$/u', '', $attrSubSet[0]); $attrSubSet[0] = preg_replace('/\s+/u', '', $attrSubSet[0]); // Remove blocked chars from the attribute name foreach ($this->blockedChars as $blockedChar) { $attrSubSet[0] = str_ireplace($blockedChar, '', $attrSubSet[0]); } // Remove all symbols $attrSubSet[0] = preg_replace('/[^\p{L}\p{N}\-\s]/u', '', $attrSubSet[0]); // Remove all "non-regular" attribute names // AND blocked attributes if ((!preg_match('/[a-z]*$/i', $attrSubSet[0])) || ($this->xssAuto && ((\in_array(strtolower($attrSubSet[0]), $this->blockedAttributes)) || substr($attrSubSet[0], 0, 2) == 'on'))) { continue; } // XSS attribute value filtering if (!isset($attrSubSet[1])) { continue; } // Remove blocked chars from the attribute value foreach ($this->blockedChars as $blockedChar) { $attrSubSet[1] = str_ireplace($blockedChar, '', $attrSubSet[1]); } // Trim leading and trailing spaces $attrSubSet[1] = trim($attrSubSet[1]); // Strips unicode, hex, etc $attrSubSet[1] = str_replace('&#', '', $attrSubSet[1]); // Strip normal newline within attr value $attrSubSet[1] = preg_replace('/[\n\r]/', '', $attrSubSet[1]); // Strip double quotes $attrSubSet[1] = str_replace('"', '', $attrSubSet[1]); // Convert single quotes from either side to doubles (Single quotes shouldn't be used to pad attr values) if ((substr($attrSubSet[1], 0, 1) == "'") && (substr($attrSubSet[1], (\strlen($attrSubSet[1]) - 1), 1) == "'")) { $attrSubSet[1] = substr($attrSubSet[1], 1, (\strlen($attrSubSet[1]) - 2)); } // Strip slashes $attrSubSet[1] = stripslashes($attrSubSet[1]); // Autostrip script tags if (static::checkAttribute($attrSubSet)) { continue; } // Is our attribute in the user input array? $attrFound = \in_array(strtolower($attrSubSet[0]), $this->attrArray); // If the tag is allowed lets keep it if ((!$attrFound && $this->attrMethod) || ($attrFound && !$this->attrMethod)) { // Does the attribute have a value? if (empty($attrSubSet[1]) === false) { $newSet[] = $attrSubSet[0] . '="' . $attrSubSet[1] . '"'; } elseif ($attrSubSet[1] === '0') { // Special Case // Is the value 0? $newSet[] = $attrSubSet[0] . '="0"'; } else { // Leave empty attributes alone $newSet[] = $attrSubSet[0] . '=""'; } } } return $newSet; } /** * Try to convert to plaintext * * @param string $source The source string. * * @return string Plaintext string * * @since 1.0 * @deprecated This method will be removed once support for PHP 5.3 is discontinued. */ protected function decode($source) { return html_entity_decode($source, \ENT_QUOTES, 'UTF-8'); } /** * Escape < > and " inside attribute values * * @param string $source The source string. * * @return string Filtered string * * @since 1.0 */ protected function escapeAttributeValues($source) { $alreadyFiltered = ''; $remainder = $source; $badChars = ['<', '"', '>']; $escapedChars = ['<', '"', '>']; // Process each portion based on presence of =" and "<space>, "/>, or "> // See if there are any more attributes to process while (preg_match('#<[^>]*?=\s*?(\"|\')#s', $remainder, $matches, \PREG_OFFSET_CAPTURE)) { $stringBeforeTag = substr($remainder, 0, $matches[0][1]); $tagPosition = strlen($stringBeforeTag); // Get the character length before the attribute value $nextBefore = $tagPosition + strlen($matches[0][0]); // Figure out if we have a single or double quote and look for the matching closing quote // Closing quote should be "/>, ">, "<space>, or " at the end of the string $quote = substr($matches[0][0], -1); $pregMatch = ($quote == '"') ? '#(\"\s*/\s*>|\"\s*>|\"\s+|\"$)#' : "#(\'\s*/\s*>|\'\s*>|\'\s+|\'$)#"; // Get the portion after attribute value $attributeValueRemainder = substr($remainder, $nextBefore); if (preg_match($pregMatch, $attributeValueRemainder, $matches, \PREG_OFFSET_CAPTURE)) { $stringBeforeQuote = substr($attributeValueRemainder, 0, $matches[0][1]); $closeQuoteChars = strlen($stringBeforeQuote); $nextAfter = $nextBefore + $closeQuoteChars; } else { // No closing quote $nextAfter = strlen($remainder); } // Get the actual attribute value $attributeValue = substr($remainder, $nextBefore, $nextAfter - $nextBefore); // Escape bad chars $attributeValue = str_replace($badChars, $escapedChars, $attributeValue); $attributeValue = $this->stripCssExpressions($attributeValue); $alreadyFiltered .= substr($remainder, 0, $nextBefore) . $attributeValue . $quote; $remainder = substr($remainder, $nextAfter + 1); } // At this point, we just have to return the $alreadyFiltered and the $remainder return $alreadyFiltered . $remainder; } /** * Remove CSS Expressions in the form of <property>:expression(...) * * @param string $source The source string. * * @return string Filtered string * * @since 1.0 */ protected function stripCssExpressions($source) { // Strip any comments out (in the form of /*...*/) $test = preg_replace('#\/\*.*\*\/#U', '', $source); // Test for :expression if (!stripos($test, ':expression')) { // Not found, so we are done return $source; } // At this point, we have stripped out the comments and have found :expression // Test stripped string for :expression followed by a '(' if (preg_match_all('#:expression\s*\(#', $test, $matches)) { // If found, remove :expression return str_ireplace(':expression', '', $test); } return $source; } /** * Integer filter * * @param string $source The string to be filtered * * @return integer The filtered value */ private function cleanInt($source) { $pattern = '/[-+]?[0-9]+/'; preg_match($pattern, $source, $matches); return isset($matches[0]) ? (int) $matches[0] : 0; } /** * Alias for cleanInt() * * @param string $source The string to be filtered * * @return integer The filtered value */ private function cleanInteger($source) { return $this->cleanInt($source); } /** * Unsigned integer filter * * @param string $source The string to be filtered * * @return integer The filtered value */ private function cleanUint($source) { $pattern = '/[-+]?[0-9]+/'; preg_match($pattern, $source, $matches); return isset($matches[0]) ? abs((int) $matches[0]) : 0; } /** * Float filter * * @param string $source The string to be filtered * * @return float The filtered value */ private function cleanFloat($source) { $pattern = '/[-+]?[0-9]+(\.[0-9]+)?([eE][-+]?[0-9]+)?/'; preg_match($pattern, $source, $matches); return isset($matches[0]) ? (float) $matches[0] : 0.0; } /** * Alias for cleanFloat() * * @param string $source The string to be filtered * * @return float The filtered value */ private function cleanDouble($source) { return $this->cleanFloat($source); } /** * Boolean filter * * @param string $source The string to be filtered * * @return boolean The filtered value */ private function cleanBool($source) { return (bool) $source; } /** * Alias for cleanBool() * * @param string $source The string to be filtered * * @return boolean The filtered value */ private function cleanBoolean($source) { return $this->cleanBool($source); } /** * Word filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanWord($source) { $pattern = '/[^A-Z_]/i'; return preg_replace($pattern, '', $source); } /** * Alphanumerical filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanAlnum($source) { $pattern = '/[^A-Z0-9]/i'; return preg_replace($pattern, '', $source); } /** * Command filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanCmd($source) { $pattern = '/[^A-Z0-9_\.-]/i'; $result = preg_replace($pattern, '', $source); $result = ltrim($result, '.'); return $result; } /** * Base64 filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanBase64($source) { $pattern = '/[^A-Z0-9\/+=]/i'; return preg_replace($pattern, '', $source); } /** * String filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanString($source) { return $this->remove($this->decode($source)); } /** * HTML filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanHtml($source) { return $this->remove($source); } /** * Path filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanPath($source) { $linuxPattern = '/^[A-Za-z0-9_\/-]+[A-Za-z0-9_\.-]*([\\\\\/]+[A-Za-z0-9_-]+[A-Za-z0-9_\.-]*)*$/'; if (preg_match($linuxPattern, $source)) { return preg_replace('~/+~', '/', $source); } $windowsPattern = '/^([A-Za-z]:(\\\\|\/))?[A-Za-z0-9_-]+[A-Za-z0-9_\.-]*((\\\\|\/)+[A-Za-z0-9_-]+[A-Za-z0-9_\.-]*)*$/'; if (preg_match($windowsPattern, $source)) { return preg_replace('~(\\\\|\/)+~', '\\', $source); } return ''; } /** * Trim filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanTrim($source) { $result = trim($source); $result = StringHelper::trim($result, \chr(0xE3) . \chr(0x80) . \chr(0x80)); $result = StringHelper::trim($result, \chr(0xC2) . \chr(0xA0)); return $result; } /** * Username filter * * @param string $source The string to be filtered * * @return string The filtered string */ private function cleanUsername($source) { $pattern = '/[\x00-\x1F\x7F<>"\'%&]/'; return preg_replace($pattern, '', $source); } } PK c�\VAf� � filter/src/OutputFilter.phpnu �[��� <?php /** * Part of the Joomla Framework Filter Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filter; use Joomla\Language\Language; use Joomla\Language\Transliterate; use Joomla\String\StringHelper; /** * OutputFilter is a class for processing an output string for "safe" display * * @since 1.0 */ class OutputFilter { /** * Language instance for making a string URL safe * * @var Language|null * @since 2.0.0 */ private static $language; /** * Makes an object safe to display in forms. * * Object parameters that are non-string, array, object or start with underscore will be converted * * @param object $mixed An object to be parsed * @param integer $quoteStyle The optional quote style for the htmlspecialchars function * @param mixed $excludeKeys An optional string single field name or array of field names not to be parsed (eg, for a textarea) * * @return void * * @since 1.0 */ public static function objectHtmlSafe(&$mixed, $quoteStyle = \ENT_QUOTES, $excludeKeys = '') { if (\is_null($quoteStyle)) { $quoteStyle = \ENT_QUOTES; } if (\is_object($mixed)) { foreach (get_object_vars($mixed) as $k => $v) { if (\is_array($v) || \is_object($v) || $v == null || substr($k, 1, 1) == '_') { continue; } if (\is_string($excludeKeys) && $k == $excludeKeys) { continue; } if (\is_array($excludeKeys) && \in_array($k, $excludeKeys)) { continue; } $mixed->$k = htmlspecialchars($v, $quoteStyle, 'UTF-8'); } } } /** * Makes a string safe for XHTML output by escaping ampersands in links. * * @param string $input String to process * * @return string Processed string * * @since 1.0 */ public static function linkXhtmlSafe($input) { $regex = 'href="([^"]*(&(amp;){0})[^"]*)*?"'; return preg_replace_callback( "#$regex#i", function ($m) { return preg_replace('#&(?!amp;)#', '&', $m[0]); }, $input ); } /** * Processes a string and escapes it for use in JavaScript * * @param string $string String to process * * @return string Processed text * * @since 3.0 */ public static function stringJSSafe($string) { $chars = preg_split('//u', $string, -1, PREG_SPLIT_NO_EMPTY); $newStr = ''; foreach ($chars as $chr) { $code = str_pad(dechex(StringHelper::ord($chr)), 4, '0', STR_PAD_LEFT); if (strlen($code) < 5) { $newStr .= '\\u' . $code; } else { $newStr .= '\\u{' . $code . '}'; } } return $newStr; } /** * Generates a URL safe version of the specified string with language transliteration. * * This method processes a string and replaces all accented UTF-8 characters by unaccented * ASCII-7 "equivalents"; whitespaces are replaced by hyphens and the string is lowercased. * * @param string $string String to process * @param string $language Language to transliterate to * * @return string Processed string * * @since 1.0 */ public static function stringUrlSafe($string, $language = '') { // Remove any '-' from the string since they will be used as concatenaters $str = str_replace('-', ' ', $string); if (self::$language) { /* * Transliterate on the language requested (fallback to current language if not specified) * * 1) If the language is empty, is an asterisk (used in the CMS for "All"), or the language matches, use the active Language instance * 2) If the language does not match the active Language instance, build a new one to get the right transliterator */ if (empty($language) || $language === '*' || self::$language->getLanguage() === $language) { $str = self::$language->transliterate($str); } else { $str = (new Language(self::$language->getBasePath(), $language, self::$language->getDebug()))->transliterate($str); } } else { // Fallback behavior based on the Language package's en-GB LocaliseInterface implementation $str = StringHelper::strtolower((new Transliterate)->utf8_latin_to_ascii($string)); } // Trim white spaces at beginning and end of alias and make lowercase $str = trim(StringHelper::strtolower($str)); // Remove any duplicate whitespace, and ensure all characters are alphanumeric $str = preg_replace('/(\s|[^A-Za-z0-9\-])+/', '-', $str); // Trim dashes at beginning and end of alias $str = trim($str, '-'); return $str; } /** * Generates a URL safe version of the specified string with unicode character replacement. * * @param string $string String to process * * @return string Processed string * * @since 1.0 */ public static function stringUrlUnicodeSlug($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. // Would be great to let the spaces in but only Firefox is friendly with this $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(StringHelper::strtolower($str)); // Remove any duplicate whitespace and replace whitespaces by hyphens $str = preg_replace('#\x20+#', '-', $str); return $str; } /** * Makes a string safe for XHTML output by escaping ampersands. * * @param string $text Text to process * * @return string Processed string. * * @since 1.0 */ public static function ampReplace($text) { return preg_replace('/(?<!&)&(?!&|#|[\w]+;)/', '&', $text); } /** * Cleans text of all formatting and scripting code. * * @param string $text Text to clean * * @return string Cleaned text. * * @since 1.0 */ public static function cleanText(&$text) { $text = preg_replace("'<script[^>]*>.*?</script>'si", '', $text); $text = preg_replace('/<a\s+.*?href="([^"]+)"[^>]*>([^<]+)<\/a>/is', '\2 (\1)', $text); $text = preg_replace('/<!--.+?-->/', '', $text); $text = preg_replace('/{.+?}/', '', $text); $text = preg_replace('/ /', ' ', $text); $text = preg_replace('/&/', ' ', $text); $text = preg_replace('/"/', ' ', $text); $text = strip_tags($text); $text = htmlspecialchars($text, \ENT_COMPAT, 'UTF-8'); return $text; } /** * Set a Language instance for use * * @param Language $language The Language instance to use. * * @return void * * @since 2.0.0 */ public static function setLanguage(Language $language): void { self::$language = $language; } /** * Strips `<img>` tags from a string. * * @param string $string Sting to be cleaned. * * @return string Cleaned string * * @since 1.0 */ public static function stripImages($string) { while (preg_match('#(<[/]?img.*>)#Ui', $string)) { $string = preg_replace('#(<[/]?img.*>)#Ui', '', $string); } return $string; } /** * Strips `<iframe>` tags from a string. * * @param string $string Sting to be cleaned. * * @return string Cleaned string * * @since 1.0 */ public static function stripIframes($string) { while (preg_match('#(<[/]?iframe.*>)#Ui', $string)) { $string = preg_replace('#(<[/]?iframe.*>)#Ui', '', $string); } return $string; } } PK c�\�P�E �E filter/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\ma�o o oauth1/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: bb7605212d460e1d4f700d615e9f0bbd96241dfac87b0376da09dd30655662b2 ... PK c�\�P�E �E oauth1/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\���<x6 x6 oauth1/src/Client.phpnu �[��� <?php /** * Part of the Joomla Framework OAuth1 Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\OAuth1; use Joomla\Application\SessionAwareWebApplicationInterface; use Joomla\Http\Http; use Joomla\Http\HttpFactory; use Joomla\Input\Input; use Joomla\Uri\Uri; /** * Joomla Framework class for interacting with an OAuth 1.0 and 1.0a server. * * @since 1.0 */ abstract class Client { /** * Options for the Client object. * * @var array|\ArrayAccess * @since 1.0 */ protected $options; /** * Contains access token key, secret and verifier. * * @var array * @since 1.0 */ protected $token = []; /** * The HTTP client object to use in sending HTTP requests. * * @var Http * @since 1.0 */ protected $client; /** * The input object to use in retrieving GET/POST data. * * @var Input * @since 1.0 */ protected $input; /** * The application object to send HTTP headers for redirects. * * @var SessionAwareWebApplicationInterface * @since 1.0 */ protected $application; /** * Selects which version of OAuth to use: 1.0 or 1.0a. * * @var string * @since 1.0 */ protected $version; /** * Constructor. * * @param SessionAwareWebApplicationInterface $application The application object * @param Http $client The HTTP client object. * @param Input $input The input object * @param array|\ArrayAccess $options OAuth1 Client options. * @param string $version Specify the OAuth version. By default we are using 1.0a. * * @since 1.0 */ public function __construct( SessionAwareWebApplicationInterface $application, Http $client = null, Input $input = null, $options = [], $version = '1.0a' ) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->application = $application; $this->client = $client ?: (new HttpFactory)->getHttp($options); $this->input = $input ?: $application->getInput(); $this->options = $options; $this->version = $version; } /** * Method to form the oauth flow. * * @return array|null The access token. * * @since 1.0 * @throws \DomainException */ public function authenticate() { // Already got some credentials stored? if ($this->token) { $response = $this->verifyCredentials(); if ($response) { return $this->token; } $this->token = null; } // Check for callback. if (strcmp($this->version, '1.0a') === 0) { $verifier = $this->input->get('oauth_verifier'); } else { $verifier = $this->input->get('oauth_token'); } if (!empty($verifier)) { $session = $this->application->getSession(); // Get token form session. $this->token = [ 'key' => $session->get('oauth_token.key'), 'secret' => $session->get('oauth_token.secret'), ]; // Verify the returned request token. if (strcmp($this->token['key'], $this->input->get('oauth_token')) !== 0) { throw new \DomainException('Bad session!'); } // Set token verifier for 1.0a. if (strcmp($this->version, '1.0a') === 0) { $this->token['verifier'] = $this->input->get('oauth_verifier'); } // Generate access token. $this->generateAccessToken(); // Return the access token. return $this->token; } // Generate a request token. $this->generateRequestToken(); // Authenticate the user and authorise the app. $this->authorise(); } /** * Method used to get a request token. * * @return void * * @since 1.1.2 * @throws \DomainException */ private function generateRequestToken() { $parameters = []; // Set the callback URL. if ($this->getOption('callback')) { $parameters['oauth_callback'] = $this->getOption('callback'); } // Make an OAuth request for the Request Token. $response = $this->oauthRequest($this->getOption('requestTokenURL'), 'POST', $parameters); parse_str($response->body, $params); if (strcmp($this->version, '1.0a') === 0 && strcmp($params['oauth_callback_confirmed'], 'true') !== 0) { throw new \DomainException('Bad request token!'); } // Save the request token. $this->token = ['key' => $params['oauth_token'], 'secret' => $params['oauth_token_secret']]; // Save the request token in session $session = $this->application->getSession(); $session->set('oauth_token.key', $this->token['key']); $session->set('oauth_token.secret', $this->token['secret']); } /** * Method used to authorise the application. * * @return void * * @since 1.1.2 */ private function authorise() { $url = $this->getOption('authoriseURL') . '?oauth_token=' . $this->token['key']; if ($this->getOption('scope')) { $scope = \is_array($this->getOption('scope')) ? implode(' ', $this->getOption('scope')) : $this->getOption('scope'); $url .= '&scope=' . urlencode($scope); } if ($this->getOption('sendheaders')) { $this->application->redirect($url); } } /** * Method used to get an access token. * * @return void * * @since 1.1.2 */ private function generateAccessToken() { // Set the parameters. $parameters = [ 'oauth_token' => $this->token['key'], ]; if (strcmp($this->version, '1.0a') === 0) { $parameters = array_merge($parameters, ['oauth_verifier' => $this->token['verifier']]); } // Make an OAuth request for the Access Token. $response = $this->oauthRequest($this->getOption('accessTokenURL'), 'POST', $parameters); parse_str($response->body, $params); // Save the access token. $this->token = ['key' => $params['oauth_token'], 'secret' => $params['oauth_token_secret']]; } /** * Method used to make an OAuth request. * * @param string $url The request URL. * @param string $method The request method. * @param array $parameters Array containing request parameters. * @param mixed $data The POST request data. * @param array $headers An array of name-value pairs to include in the header of the request * * @return \Joomla\Http\Response * * @since 1.0 * @throws \DomainException */ public function oauthRequest($url, $method, $parameters, $data = [], $headers = []) { // Set the parameters. $defaults = [ 'oauth_consumer_key' => $this->getOption('consumer_key'), 'oauth_signature_method' => 'HMAC-SHA1', 'oauth_version' => '1.0', 'oauth_nonce' => $this->generateNonce(), 'oauth_timestamp' => time(), ]; $parameters = array_merge($parameters, $defaults); // Do not encode multipart parameters. Do not include $data in the signature if $data is not array. if (isset($headers['Content-Type']) && strpos($headers['Content-Type'], 'multipart/form-data') !== false || !\is_array($data)) { $oauthHeaders = $parameters; } else { // Use all parameters for the signature. $oauthHeaders = array_merge($parameters, $data); } // Sign the request. $oauthHeaders = $this->signRequest($url, $method, $oauthHeaders); // Get parameters for the Authorisation header. if (\is_array($data)) { $oauthHeaders = array_diff_key($oauthHeaders, $data); } // Send the request. switch ($method) { case 'GET': $url = $this->toUrl($url, $data); $response = $this->client->get($url, ['Authorization' => $this->createHeader($oauthHeaders)]); break; case 'POST': $headers = array_merge($headers, ['Authorization' => $this->createHeader($oauthHeaders)]); $response = $this->client->post($url, $data, $headers); break; case 'PUT': $headers = array_merge($headers, ['Authorization' => $this->createHeader($oauthHeaders)]); $response = $this->client->put($url, $data, $headers); break; case 'DELETE': $headers = array_merge($headers, ['Authorization' => $this->createHeader($oauthHeaders)]); $response = $this->client->delete($url, $headers); break; } // Validate the response code. $this->validateResponse($url, $response); return $response; } /** * Method to validate a response. * * @param string $url The request URL. * @param Response $response The response to validate. * * @return void * * @since 1.0 * @throws \DomainException */ abstract public function validateResponse($url, $response); /** * Method used to create the header for the POST request. * * @param array $parameters Array containing request parameters. * * @return string The header. * * @since 1.1.2 */ private function createHeader(array $parameters): string { $header = 'OAuth '; foreach ($parameters as $key => $value) { if (!strcmp($header, 'OAuth ')) { $header .= $key . '="' . $this->safeEncode($value) . '"'; } else { $header .= ', ' . $key . '="' . $value . '"'; } } return $header; } /** * Method to create the URL formed string with the parameters. * * @param string $url The request URL. * @param array $parameters Array containing request parameters. * * @return string The formed URL. * * @since 1.0 */ public function toUrl($url, $parameters) { $uri = new Uri($url); $uri->setQuery($parameters); return (string) $uri; } /** * Method used to sign requests. * * @param string $url The URL to sign. * @param string $method The request method. * @param array $parameters Array containing request parameters. * * @return array The array containing the request parameters, including signature. * * @since 1.1.2 */ private function signRequest(string $url, string $method, array $parameters): array { // Create the signature base string. $base = $this->baseString($url, $method, $parameters); $parameters['oauth_signature'] = $this->safeEncode( base64_encode( hash_hmac('sha1', $base, $this->prepareSigningKey(), true) ) ); return $parameters; } /** * Prepare the signature base string. * * @param string $url The URL to sign. * @param string $method The request method. * @param array $parameters Array containing request parameters. * * @return string The base string. * * @since 1.1.2 */ private function baseString(string $url, string $method, array $parameters): string { // Sort the parameters alphabetically uksort($parameters, 'strcmp'); // Encode parameters. foreach ($parameters as $key => $value) { $key = $this->safeEncode($key); if (\is_array($value)) { foreach ($value as $k => $v) { $v = $this->safeEncode($v); $kv[] = "{$key}={$v}"; } } else { $value = $this->safeEncode($value); $kv[] = "{$key}={$value}"; } } // Form the parameter string. $params = implode('&', $kv); // Signature base string elements. $base = [ $method, $url, $params, ]; // Return the base string. return implode('&', $this->safeEncode($base)); } /** * Encodes the string or array passed in a way compatible with OAuth. * If an array is passed each array value will will be encoded. * * @param mixed $data The scalar or array to encode. * * @return string $data encoded in a way compatible with OAuth. * * @since 1.0 */ public function safeEncode($data) { if (\is_array($data)) { return array_map([$this, 'safeEncode'], $data); } if (is_scalar($data)) { return str_ireplace( ['+', '%7E'], [' ', '~'], rawurlencode($data) ); } return ''; } /** * Method used to generate the current nonce. * * @return string The current nonce. * * @since 1.0 */ public static function generateNonce() { // The md5s look nicer than numbers. return md5(microtime() . random_bytes(16)); } /** * Prepares the OAuth signing key. * * @return string The prepared signing key. * * @since 1.1.2 */ private function prepareSigningKey(): string { return $this->safeEncode($this->getOption('consumer_secret')) . '&' . $this->safeEncode(($this->token) ? $this->token['secret'] : ''); } /** * Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; * returns a 401 status code and an error message if not. * * @return array The decoded JSON response * * @since 1.0 */ abstract public function verifyCredentials(); /** * Get an option from the OAuth1 Client instance. * * @param string $key The name of the option to get * @param mixed $default Optional default value if the option does not exist * * @return mixed The option value * * @since 1.0 */ public function getOption($key, $default = null) { return $this->options[$key] ?? $default; } /** * Set an option for the OAuth1 Client instance. * * @param string $key The name of the option to set * @param mixed $value The option value to set * * @return $this * * @since 1.0 */ public function setOption($key, $value) { $this->options[$key] = $value; return $this; } /** * Get the oauth token key or secret. * * @return array The oauth token key and secret. * * @since 1.0 */ public function getToken() { return $this->token; } /** * Set the oauth token. * * @param array $token The access token key and secret. * * @return $this * * @since 1.0 */ public function setToken($token) { $this->token = $token; return $this; } } PK c�\�+�m� � oauth1/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\����s s crypt/src/Cipher/Sodium.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Cipher; use Joomla\Crypt\CipherInterface; use Joomla\Crypt\Exception\DecryptionException; use Joomla\Crypt\Exception\EncryptionException; use Joomla\Crypt\Exception\InvalidKeyException; use Joomla\Crypt\Exception\InvalidKeyTypeException; use Joomla\Crypt\Exception\UnsupportedCipherException; use Joomla\Crypt\Key; use ParagonIE\Sodium\Compat; /** * Cipher for sodium algorithm encryption, decryption and key generation. * * @since 1.4.0 */ class Sodium implements CipherInterface { /** * The message nonce to be used with encryption/decryption * * @var string * @since 1.4.0 */ private $nonce; /** * Method to decrypt a data string. * * @param string $data The encrypted string to decrypt. * @param Key $key The key object to use for decryption. * * @return string The decrypted data string. * * @since 1.4.0 * @throws DecryptionException if the data cannot be decrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher */ public function decrypt($data, Key $key) { // Validate key. if ($key->getType() !== 'sodium') { throw new InvalidKeyTypeException('sodium', $key->getType()); } if (!$this->nonce) { throw new DecryptionException('Missing nonce to decrypt data'); } // Use the sodium extension (PHP 7.2 native, PECL 2.x, or paragonie/sodium_compat) if able if (\function_exists('sodium_crypto_box_open')) { try { $decrypted = sodium_crypto_box_open( $data, $this->nonce, sodium_crypto_box_keypair_from_secretkey_and_publickey($key->getPrivate(), $key->getPublic()) ); if ($decrypted === false) { throw new DecryptionException('Malformed message or invalid MAC'); } } catch (\SodiumException $exception) { throw new DecryptionException('Malformed message or invalid MAC', $exception->getCode(), $exception); } return $decrypted; } // Use the libsodium extension (PECL 1.x) if able; purposefully skipping sodium_compat fallback here as that will match the above check if (\extension_loaded('libsodium')) { $decrypted = \Sodium\crypto_box_open( $data, $this->nonce, \Sodium\crypto_box_keypair_from_secretkey_and_publickey($key->getPrivate(), $key->getPublic()) ); if ($decrypted === false) { throw new DecryptionException('Malformed message or invalid MAC'); } return $decrypted; } // Well this is awkward throw new UnsupportedCipherException(static::class); } /** * Method to encrypt a data string. * * @param string $data The data string to encrypt. * @param Key $key The key object to use for encryption. * * @return string The encrypted data string. * * @since 1.4.0 * @throws EncryptionException if the data cannot be encrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher */ public function encrypt($data, Key $key) { // Validate key. if ($key->getType() !== 'sodium') { throw new InvalidKeyTypeException('sodium', $key->getType()); } if (!$this->nonce) { throw new EncryptionException('Missing nonce to decrypt data'); } // Use the sodium extension (PHP 7.2 native, PECL 2.x, or paragonie/sodium_compat) if able if (\function_exists('sodium_crypto_box')) { try { return sodium_crypto_box( $data, $this->nonce, sodium_crypto_box_keypair_from_secretkey_and_publickey($key->getPrivate(), $key->getPublic()) ); } catch (\SodiumException $exception) { throw new EncryptionException('Could not encrypt file.', $exception->getCode(), $exception); } } // Use the libsodium extension (PECL 1.x) if able; purposefully skipping sodium_compat fallback here as that will match the above check if (\extension_loaded('libsodium')) { return \Sodium\crypto_box( $data, $this->nonce, \Sodium\crypto_box_keypair_from_secretkey_and_publickey($key->getPrivate(), $key->getPublic()) ); } // Well this is awkward throw new UnsupportedCipherException(static::class); } /** * Method to generate a new encryption key object. * * @param array $options Key generation options. * * @return Key * * @since 1.4.0 * @throws InvalidKeyException if the key cannot be generated * @throws UnsupportedCipherException if the cipher is not supported on the current environment */ public function generateKey(array $options = []) { // Use the sodium extension (PHP 7.2 native, PECL 2.x, or paragonie/sodium_compat) if able if (\function_exists('sodium_crypto_box_keypair')) { try { // Generate the encryption key. $pair = sodium_crypto_box_keypair(); return new Key('sodium', sodium_crypto_box_secretkey($pair), sodium_crypto_box_publickey($pair)); } catch (\SodiumException $exception) { throw new InvalidKeyException('Could not generate encryption key.', $exception->getCode(), $exception); } } // Use the libsodium extension (PECL 1.x) if able; purposefully skipping sodium_compat fallback here as that will match the above check if (\extension_loaded('libsodium')) { // Generate the encryption key. $pair = \Sodium\crypto_box_keypair(); return new Key('sodium', \Sodium\crypto_box_secretkey($pair), \Sodium\crypto_box_publickey($pair)); } // Well this is awkward throw new UnsupportedCipherException(static::class); } /** * Check if the cipher is supported in this environment. * * @return boolean * * @since 2.0.0 */ public static function isSupported(): bool { // Prefer ext/sodium, then ext/libsodium, then presence of paragonie/sodium_compat return \function_exists('sodium_crypto_box') || \extension_loaded('libsodium') || class_exists(Compat::class); } /** * Set the nonce to use for encrypting/decrypting messages * * @param string $nonce The message nonce * * @return void * * @since 1.4.0 */ public function setNonce($nonce) { $this->nonce = $nonce; } } PK c�\��{ { crypt/src/Cipher/OpenSSL.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Cipher; use Joomla\Crypt\CipherInterface; use Joomla\Crypt\Exception\DecryptionException; use Joomla\Crypt\Exception\EncryptionException; use Joomla\Crypt\Exception\InvalidKeyException; use Joomla\Crypt\Exception\InvalidKeyTypeException; use Joomla\Crypt\Key; /** * Joomla cipher for encryption, decryption and key generation via the openssl extension. * * @since 2.0.0 */ class OpenSSL implements CipherInterface { /** * Initialisation vector for key generator method. * * @var string * @since 2.0.0 */ private $iv; /** * Method to use for encryption. * * @var string * @since 2.0.0 */ private $method; /** * Instantiate the cipher. * * @param string $iv The initialisation vector to use * @param string $method The encryption method to use * * @since 2.0.0 */ public function __construct(string $iv, string $method) { $this->iv = $iv; $this->method = $method; } /** * Method to decrypt a data string. * * @param string $data The encrypted string to decrypt. * @param Key $key The key object to use for decryption. * * @return string The decrypted data string. * * @since 2.0.0 * @throws DecryptionException if the data cannot be decrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher */ public function decrypt($data, Key $key) { // Validate key. if ($key->getType() !== 'openssl') { throw new InvalidKeyTypeException('openssl', $key->getType()); } $cleartext = openssl_decrypt($data, $this->method, $key->getPrivate(), true, $this->iv); if ($cleartext === false) { throw new DecryptionException('Failed to decrypt data'); } return $cleartext; } /** * Method to encrypt a data string. * * @param string $data The data string to encrypt. * @param Key $key The key object to use for encryption. * * @return string The encrypted data string. * * @since 2.0.0 * @throws EncryptionException if the data cannot be encrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher */ public function encrypt($data, Key $key) { // Validate key. if ($key->getType() !== 'openssl') { throw new InvalidKeyTypeException('openssl', $key->getType()); } $encrypted = openssl_encrypt($data, $this->method, $key->getPrivate(), true, $this->iv); if ($encrypted === false) { throw new EncryptionException('Unable to encrypt data'); } return $encrypted; } /** * Method to generate a new encryption key object. * * @param array $options Key generation options. * * @return Key * * @since 2.0.0 * @throws InvalidKeyException if the key cannot be generated */ public function generateKey(array $options = []) { $passphrase = $options['passphrase'] ?? false; if ($passphrase === false) { throw new InvalidKeyException('Missing passphrase file'); } return new Key('openssl', $passphrase, 'unused'); } /** * Check if the cipher is supported in this environment. * * @return boolean * * @since 2.0.0 */ public static function isSupported(): bool { return \extension_loaded('openssl'); } } PK c�\��#I� � crypt/src/Cipher/Crypto.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Cipher; use Defuse\Crypto\Crypto as DefuseCrypto; use Defuse\Crypto\Exception\EnvironmentIsBrokenException; use Defuse\Crypto\Exception\WrongKeyOrModifiedCiphertextException; use Defuse\Crypto\Key as DefuseKey; use Defuse\Crypto\RuntimeTests; use Joomla\Crypt\CipherInterface; use Joomla\Crypt\Exception\DecryptionException; use Joomla\Crypt\Exception\EncryptionException; use Joomla\Crypt\Exception\InvalidKeyException; use Joomla\Crypt\Exception\InvalidKeyTypeException; use Joomla\Crypt\Key; /** * Joomla cipher for encryption, decryption and key generation via the php-encryption library. * * @since 2.0.0 */ class Crypto implements CipherInterface { /** * Method to decrypt a data string. * * @param string $data The encrypted string to decrypt. * @param Key $key The key object to use for decryption. * * @return string The decrypted data string. * * @since 2.0.0 * @throws DecryptionException if the data cannot be decrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher */ public function decrypt($data, Key $key) { // Validate key. if ($key->getType() !== 'crypto') { throw new InvalidKeyTypeException('crypto', $key->getType()); } // Decrypt the data. try { return DefuseCrypto::decrypt($data, DefuseKey::loadFromAsciiSafeString($key->getPrivate())); } catch (WrongKeyOrModifiedCiphertextException $ex) { throw new DecryptionException('DANGER! DANGER! The ciphertext has been tampered with!', $ex->getCode(), $ex); } catch (EnvironmentIsBrokenException $ex) { throw new DecryptionException('Cannot safely perform decryption', $ex->getCode(), $ex); } } /** * Method to encrypt a data string. * * @param string $data The data string to encrypt. * @param Key $key The key object to use for encryption. * * @return string The encrypted data string. * * @since 2.0.0 * @throws EncryptionException if the data cannot be encrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher */ public function encrypt($data, Key $key) { // Validate key. if ($key->getType() !== 'crypto') { throw new InvalidKeyTypeException('crypto', $key->getType()); } // Encrypt the data. try { return DefuseCrypto::encrypt($data, DefuseKey::loadFromAsciiSafeString($key->getPrivate())); } catch (EnvironmentIsBrokenException $ex) { throw new EncryptionException('Cannot safely perform encryption', $ex->getCode(), $ex); } } /** * Method to generate a new encryption key object. * * @param array $options Key generation options. * * @return Key * * @since 2.0.0 * @throws InvalidKeyException if the key cannot be generated */ public function generateKey(array $options = []) { // Generate the encryption key. try { $public = DefuseKey::createNewRandomKey(); } catch (EnvironmentIsBrokenException $ex) { throw new InvalidKeyException('Cannot safely create a key', $ex->getCode(), $ex); } // Create the new encryption key object. return new Key('crypto', $public->saveToAsciiSafeString(), $public->getRawBytes()); } /** * Check if the cipher is supported in this environment. * * @return boolean * * @since 2.0.0 */ public static function isSupported(): bool { try { RuntimeTests::runtimeTest(); return true; } catch (EnvironmentIsBrokenException $e) { return false; } } } PK c�\�m:z� � crypt/src/Key.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt; /** * Encryption key object for the Joomla Framework. * * @since 1.0 */ class Key { /** * The private key. * * @var string * @since 1.0 */ private $private; /** * The public key. * * @var string * @since 1.0 */ private $public; /** * The key type. * * @var string * @since 1.0 */ private $type; /** * Constructor. * * @param string $type The key type. * @param string $private The private key. * @param string $public The public key. * * @since 1.0 */ public function __construct(string $type, string $private, string $public) { // Set the key type. $this->type = $type; // Set the public/private key strings. $this->private = $private; $this->public = $public; } /** * Retrieve the private key * * @return string * * @since 2.0.0 */ public function getPrivate(): string { return $this->private; } /** * Retrieve the public key * * @return string * * @since 2.0.0 */ public function getPublic(): string { return $this->public; } /** * Retrieve the key type * * @return string * * @since 2.0.0 */ public function getType(): string { return $this->type; } } PK c�\U��h� � crypt/src/CipherInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt; use Joomla\Crypt\Exception\DecryptionException; use Joomla\Crypt\Exception\EncryptionException; use Joomla\Crypt\Exception\InvalidKeyException; use Joomla\Crypt\Exception\InvalidKeyTypeException; use Joomla\Crypt\Exception\UnsupportedCipherException; /** * Joomla Framework Cipher interface. * * @since 1.0 */ interface CipherInterface { /** * Method to decrypt a data string. * * @param string $data The encrypted string to decrypt. * @param Key $key The key[/pair] object to use for decryption. * * @return string The decrypted data string. * * @since 1.0 * @throws DecryptionException if the data cannot be decrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher * @throws UnsupportedCipherException if the cipher is not supported on the current environment */ public function decrypt($data, Key $key); /** * Method to encrypt a data string. * * @param string $data The data string to encrypt. * @param Key $key The key[/pair] object to use for encryption. * * @return string The encrypted data string. * * @since 1.0 * @throws EncryptionException if the data cannot be encrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher * @throws UnsupportedCipherException if the cipher is not supported on the current environment */ public function encrypt($data, Key $key); /** * Method to generate a new encryption key[/pair] object. * * @param array $options Key generation options. * * @return Key * * @since 1.0 * @throws InvalidKeyException if the key cannot be generated * @throws UnsupportedCipherException if the cipher is not supported on the current environment */ public function generateKey(array $options = []); /** * Check if the cipher is supported in this environment. * * @return boolean * * @since 2.0.0 */ public static function isSupported(): bool; } PK c�\ Ab� � 2 crypt/src/Exception/UnsupportedCipherException.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Exception; /** * Exception representing an error encrypting data * * @since 2.0.0 */ class UnsupportedCipherException extends \LogicException implements CryptExceptionInterface { /** * UnsupportedCipherException constructor. * * @param string $class The class name of the unsupported cipher. * * @since 2.0.0 */ public function __construct(string $class) { parent::__construct("The '$class' cipher is not supported in this environment."); } } PK c�\�_��8 8 / crypt/src/Exception/InvalidKeyTypeException.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Exception; /** * Exception representing an invalid Joomla\Crypt\Key type for a cipher * * @since 1.4.0 */ class InvalidKeyTypeException extends \InvalidArgumentException implements CryptExceptionInterface { /** * InvalidKeyTypeException constructor. * * @param string $expectedKeyType The expected key type. * @param string $actualKeyType The actual key type. * * @since 1.4.0 */ public function __construct($expectedKeyType, $actualKeyType) { parent::__construct("Invalid key of type: $actualKeyType. Expected $expectedKeyType."); } } PK c�\�>�� � + crypt/src/Exception/InvalidKeyException.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Exception; /** * Exception representing an error generating an encryption key * * @since 2.0.0 */ class InvalidKeyException extends \RuntimeException implements CryptExceptionInterface { } PK c�\V�-�� � + crypt/src/Exception/EncryptionException.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Exception; /** * Exception representing an error encrypting data * * @since 2.0.0 */ class EncryptionException extends \RuntimeException implements CryptExceptionInterface { } PK c�\�o3Í � / crypt/src/Exception/CryptExceptionInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Exception; /** * Interface defining all crypt package exceptions * * @since 2.0.0 */ interface CryptExceptionInterface extends \Throwable { } PK c�\�l�� � + crypt/src/Exception/DecryptionException.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt\Exception; /** * Exception representing an error decrypting data * * @since 2.0.0 */ class DecryptionException extends \RuntimeException implements CryptExceptionInterface { } PK c�\��h�y y crypt/src/Crypt.phpnu �[��� <?php /** * Part of the Joomla Framework Crypt Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Crypt; use Joomla\Crypt\Cipher\Crypto; use Joomla\Crypt\Exception\DecryptionException; use Joomla\Crypt\Exception\EncryptionException; use Joomla\Crypt\Exception\InvalidKeyException; use Joomla\Crypt\Exception\InvalidKeyTypeException; use Joomla\Crypt\Exception\UnsupportedCipherException; /** * Crypt is a Joomla Framework class for handling basic encryption/decryption of data. * * @since 1.0 */ class Crypt { /** * The encryption cipher object. * * @var CipherInterface * @since 1.0 */ private $cipher; /** * The encryption key[/pair)]. * * @var Key * @since 1.0 */ private $key; /** * Object Constructor takes an optional key to be used for encryption/decryption. If no key is given then the * secret word from the configuration object is used. * * @param CipherInterface $cipher The encryption cipher object. * @param Key $key The encryption key[/pair)]. * * @since 1.0 */ public function __construct(?CipherInterface $cipher = null, ?Key $key = null) { // Set the encryption cipher. $this->cipher = $cipher ?: new Crypto; // Set the encryption key[/pair)]. $this->key = $key ?: $this->generateKey(); } /** * Method to decrypt a data string. * * @param string $data The encrypted string to decrypt. * * @return string The decrypted data string. * * @since 1.0 * @throws DecryptionException if the data cannot be decrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher * @throws UnsupportedCipherException if the cipher is not supported on the current environment */ public function decrypt($data) { return $this->cipher->decrypt($data, $this->key); } /** * Method to encrypt a data string. * * @param string $data The data string to encrypt. * * @return string The encrypted data string. * * @since 1.0 * @throws EncryptionException if the data cannot be encrypted * @throws InvalidKeyTypeException if the key is not valid for the cipher * @throws UnsupportedCipherException if the cipher is not supported on the current environment */ public function encrypt($data) { return $this->cipher->encrypt($data, $this->key); } /** * Method to generate a new encryption key[/pair] object. * * @param array $options Key generation options. * * @return Key * * @since 1.0 * @throws InvalidKeyException if the key cannot be generated * @throws UnsupportedCipherException if the cipher is not supported on the current environment */ public function generateKey(array $options = []) { return $this->cipher->generateKey($options); } /** * Method to set the encryption key[/pair] object. * * @param Key $key The key object to set. * * @return Crypt Instance of $this to allow chaining. * * @since 1.0 */ public function setKey(Key $key) { $this->key = $key; return $this; } /** * Generate random bytes. * * @param integer $length Length of the random data to generate * * @return string Random binary data * * @since 1.0 */ public static function genRandomBytes($length = 16) { return random_bytes($length); } } PK c�\�P�E �E crypt/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�P�E �E console/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\C�߯� � + console/src/Event/ApplicationErrorEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Event; use Joomla\Console\Application; use Joomla\Console\Command\AbstractCommand; use Joomla\Console\ConsoleEvents; /** * Event triggered when an uncaught Throwable is received by the application. * * @since 2.0.0 */ class ApplicationErrorEvent extends ConsoleEvent { /** * The Throwable object with the error data. * * @var \Throwable * @since 2.0.0 */ private $error; /** * The exit code to use for the application. * * @var integer|null * @since 2.0.0 */ private $exitCode; /** * Event constructor. * * @param \Throwable $error The Throwable object with the error data. * @param Application $application The active application. * @param AbstractCommand|null $command The command being executed. * * @since 2.0.0 */ public function __construct(\Throwable $error, Application $application, ?AbstractCommand $command = null) { parent::__construct(ConsoleEvents::APPLICATION_ERROR, $application, $command); $this->error = $error; } /** * Get the error object. * * @return \Throwable * * @since 2.0.0 */ public function getError(): \Throwable { return $this->error; } /** * Gets the exit code. * * @return integer * * @since 2.0.0 */ public function getExitCode(): int { return $this->exitCode ?: (\is_int($this->error->getCode()) && $this->error->getCode() !== 0 ? $this->error->getCode() : 1); } /** * Set the error object. * * @param \Throwable $error The error object to set to the event. * * @return void * * @since 2.0.0 */ public function setError(\Throwable $error): void { $this->error = $error; } /** * Sets the exit code. * * @param integer $exitCode The command exit code. * * @return void * * @since 2.0.0 */ public function setExitCode(int $exitCode): void { $this->exitCode = $exitCode; $r = new \ReflectionProperty($this->error, 'code'); $r->setAccessible(true); $r->setValue($this->error, $this->exitCode); } } PK c�\�^y�2 2 ' console/src/Event/CommandErrorEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Event; use Joomla\Console\Application; use Joomla\Console\Command\AbstractCommand; use Joomla\Console\ConsoleEvents; /** * Event triggered when an uncaught Throwable is received by the application from a command. * * @since 2.0.0 */ class CommandErrorEvent extends ConsoleEvent { /** * The Throwable object with the error data. * * @var \Throwable * @since 2.0.0 */ private $error; /** * The exit code to use for the application. * * @var integer|null * @since 2.0.0 */ private $exitCode; /** * Event constructor. * * @param \Throwable $error The Throwable object with the error data. * @param Application $application The active application. * @param AbstractCommand|null $command The command being executed. * * @since 2.0.0 */ public function __construct(\Throwable $error, Application $application, ?AbstractCommand $command = null) { parent::__construct(ConsoleEvents::COMMAND_ERROR, $application, $command); $this->error = $error; } /** * Get the error object. * * @return \Throwable * * @since 2.0.0 */ public function getError(): \Throwable { return $this->error; } /** * Gets the exit code. * * @return integer * * @since 2.0.0 */ public function getExitCode(): int { if ($this->exitCode !== null) { return $this->exitCode; } return \is_int($this->error->getCode()) && $this->error->getCode() !== 0 ? $this->error->getCode() : 1; } /** * Set the error object. * * @param \Throwable $error The error object to set to the event. * * @return void * * @since 2.0.0 */ public function setError(\Throwable $error): void { $this->error = $error; } /** * Sets the exit code. * * @param integer $exitCode The command exit code. * * @return void * * @since 2.0.0 */ public function setExitCode(int $exitCode): void { $this->exitCode = $exitCode; $r = new \ReflectionProperty($this->error, 'code'); $r->setAccessible(true); $r->setValue($this->error, $this->exitCode); } } PK c�\ْ��� � $ console/src/Event/TerminateEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Event; use Joomla\Console\Application; use Joomla\Console\Command\AbstractCommand; use Joomla\Console\ConsoleEvents; /** * Event triggered immediately before the process is terminated. * * @since 2.0.0 */ class TerminateEvent extends ConsoleEvent { /** * The exit code to use for the application. * * @var integer * @since 2.0.0 */ private $exitCode; /** * Event constructor. * * @param integer $exitCode The Throwable object with the error data. * @param Application $application The active application. * @param AbstractCommand|null $command The command being executed. * * @since 2.0.0 */ public function __construct(int $exitCode, Application $application, ?AbstractCommand $command = null) { parent::__construct(ConsoleEvents::TERMINATE, $application, $command); $this->exitCode = $exitCode; } /** * Gets the exit code. * * @return integer * * @since 2.0.0 */ public function getExitCode(): int { return $this->exitCode; } /** * Sets the exit code. * * @param integer $exitCode The command exit code. * * @return void * * @since 2.0.0 */ public function setExitCode(int $exitCode): void { $this->exitCode = $exitCode; } } PK c�\NE� " console/src/Event/ConsoleEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Event; use Joomla\Console\Application; use Joomla\Console\Command\AbstractCommand; use Joomla\Event\Event; /** * Base event class for console events. * * @since 2.0.0 */ class ConsoleEvent extends Event { /** * The active application. * * @var Application * @since 2.0.0 */ private $application; /** * The command being executed. * * @var AbstractCommand|null * @since 2.0.0 */ private $command; /** * Event constructor. * * @param string $name The event name. * @param Application $application The active application. * @param AbstractCommand|null $command The command being executed. * * @since 2.0.0 */ public function __construct(string $name, Application $application, ?AbstractCommand $command = null) { parent::__construct($name); $this->application = $application; $this->command = $command; } /** * Get the active application. * * @return Application * * @since 2.0.0 */ public function getApplication(): Application { return $this->application; } /** * Get the command being executed. * * @return AbstractCommand|null * * @since 2.0.0 */ public function getCommand(): ?AbstractCommand { return $this->command; } } PK c�\�I�B� � / console/src/Event/BeforeCommandExecuteEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Event; use Joomla\Console\Application; use Joomla\Console\Command\AbstractCommand; use Joomla\Console\ConsoleEvents; /** * Event triggered before a command is executed. * * @since 2.0.0 */ class BeforeCommandExecuteEvent extends ConsoleEvent { /** * The return code for a command disabled by this event. * * @var integer * @since 2.0.0 */ public const RETURN_CODE_DISABLED = 113; /** * Flag indicating the command is enabled * * @var boolean * @since 2.0.0 */ private $commandEnabled = true; /** * Event constructor. * * @param Application $application The active application. * @param AbstractCommand|null $command The command being executed. * * @since 2.0.0 */ public function __construct(Application $application, ?AbstractCommand $command = null) { parent::__construct(ConsoleEvents::BEFORE_COMMAND_EXECUTE, $application, $command); if ($command) { $this->commandEnabled = $command->isEnabled(); } } /** * Disable the command. * * @return void * * @since 2.0.0 */ public function disableCommand(): void { $this->commandEnabled = false; } /** * Enable the command. * * @return void * * @since 2.0.0 */ public function enableCommand(): void { $this->commandEnabled = false; } /** * Check if the command is enabled. * * @return boolean * * @since 2.0.0 */ public function isCommandEnabled(): bool { return $this->commandEnabled; } } PK c�\0 ] ] console/src/ConsoleEvents.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console; /** * Class defining the events available in the console application. * * @since 2.0.0 */ final class ConsoleEvents { /** * The APPLICATION_ERROR event is an event triggered when an uncaught Throwable is received at the main application executor. * * This event allows developers to handle the Throwable. * * @var string * @since 2.0.0 */ public const APPLICATION_ERROR = 'console.application_error'; /** * The BEFORE_COMMAND_EXECUTE event is an event triggered before a command is executed. * * This event allows developers to modify information about the command or the command's * dependencies prior to the command being executed. * * @var string * @since 2.0.0 */ public const BEFORE_COMMAND_EXECUTE = 'console.before_command_execute'; /** * The COMMAND_ERROR event is an event triggered when an uncaught Throwable from a command is received. * * This event allows developers to handle the Throwable. * * @var string * @since 2.0.0 */ public const COMMAND_ERROR = 'console.command_error'; /** * The TERMINATE event is an event triggered immediately before the application is exited. * * This event allows developers to perform any post-process actions and to manipulate * the process' exit code. * * @var string * @since 2.0.0 */ public const TERMINATE = 'console.terminate'; } PK c�\ ��i i ' console/src/Helper/DescriptorHelper.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Helper; use Joomla\Console\Descriptor\TextDescriptor; use Symfony\Component\Console\Helper\Helper; use Symfony\Component\Console\Output\OutputInterface; /** * Describes an object. * * @since 2.0.0 */ class DescriptorHelper extends Helper { /** * Describes an object if supported. * * @param OutputInterface $output The output object to use. * @param object $object The object to describe. * @param array $options Options for the descriptor. * * @return void * * @since _2.0.0 */ public function describe(OutputInterface $output, $object, array $options = []) { (new TextDescriptor)->describe($output, $object, $options); } /** * Returns the canonical name of this helper. * * @return string The canonical name * * @since _2.0.0 */ public function getName() { return 'descriptor'; } } PK c�\Q ��w w 1 console/src/Descriptor/ApplicationDescription.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Descriptor; use Joomla\Console\Application; use Joomla\Console\Command\AbstractCommand; use Symfony\Component\Console\Exception\CommandNotFoundException; /** * Describes an application. * * @since 2.0.0 */ final class ApplicationDescription { /** * Placeholder for commands in the global namespace. * * @var string * @since 2.0.0 */ public const GLOBAL_NAMESPACE = '_global'; /** * The application's aliased commands. * * @var AbstractCommand[] * @since 2.0.0 */ private $aliases; /** * The application being described. * * @var Application * @since 2.0.0 */ private $application; /** * The application's commands. * * @var AbstractCommand[] * @since 2.0.0 */ private $commands; /** * The command namespace to process. * * @var string * @since 2.0.0 */ private $namespace = ''; /** * The application's command namespaces. * * @var array[] * @since 2.0.0 */ private $namespaces; /** * Flag indicating hidden commands should be displayed. * * @var boolean * @since 2.0.0 */ private $showHidden; /** * Constructor. * * @param Application $application The application being described. * @param string $namespace The command namespace to process. * @param boolean $showHidden Flag indicating hidden commands should be displayed. * * @since 2.0.0 */ public function __construct(Application $application, string $namespace = '', bool $showHidden = false) { $this->application = $application; $this->namespace = $namespace; $this->showHidden = $showHidden; } /** * Get the application's command namespaces. * * @return array[] * * @since 2.0.0 */ public function getNamespaces(): array { if ($this->namespaces === null) { $this->inspectApplication(); } return $this->namespaces; } /** * Get the application's commands. * * @return AbstractCommand[] * * @since 2.0.0 */ public function getCommands(): array { if ($this->commands === null) { $this->inspectApplication(); } return $this->commands; } /** * Get a command by name. * * @param string $name The name of the command to retrieve. * * @return AbstractCommand * * @since 2.0.0 * @throws CommandNotFoundException */ public function getCommand(string $name): AbstractCommand { if (!isset($this->commands[$name]) && !isset($this->aliases[$name])) { throw new CommandNotFoundException(sprintf('Command %s does not exist.', $name)); } return $this->commands[$name] ?? $this->aliases[$name]; } /** * Returns the namespace part of the command name. * * @param string $name The command name to process * @param integer $limit The maximum number of parts of the namespace * * @return string * * @since 2.0.0 */ private function extractNamespace(string $name, ?int $limit = null): string { $parts = explode(':', $name); array_pop($parts); return implode(':', $limit === null ? $parts : \array_slice($parts, 0, $limit)); } /** * Inspects the application. * * @return void * * @since 2.0.0 */ private function inspectApplication(): void { $this->commands = []; $this->namespaces = []; $all = $this->application->getAllCommands($this->namespace ? $this->application->findNamespace($this->namespace) : ''); foreach ($this->sortCommands($all) as $namespace => $commands) { $names = []; foreach ($commands as $name => $command) { if (!$command->getName() || (!$this->showHidden && $command->isHidden())) { continue; } if ($command->getName() === $name) { $this->commands[$name] = $command; } else { $this->aliases[$name] = $command; } $names[] = $name; } $this->namespaces[$namespace] = ['id' => $namespace, 'commands' => $names]; } } /** * Sort a set of commands. * * @param AbstractCommand[] $commands The commands to sort. * * @return AbstractCommand[][] * * @since 2.0.0 */ private function sortCommands(array $commands): array { $namespacedCommands = []; $globalCommands = []; foreach ($commands as $name => $command) { $key = $this->extractNamespace($name, 1); if (!$key) { $globalCommands[self::GLOBAL_NAMESPACE][$name] = $command; } else { $namespacedCommands[$key][$name] = $command; } } ksort($namespacedCommands); $namespacedCommands = array_merge($globalCommands, $namespacedCommands); foreach ($namespacedCommands as &$commandsSet) { ksort($commandsSet); } // Unset reference to keep scope clear unset($commandsSet); return $namespacedCommands; } } PK c�\h��m� � ) console/src/Descriptor/TextDescriptor.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Descriptor; use Joomla\Console\Application; use Joomla\Console\Command\AbstractCommand; use Joomla\String\StringHelper; use Symfony\Component\Console\Descriptor\TextDescriptor as SymfonyTextDescriptor; use Symfony\Component\Console\Input\InputDefinition; use Symfony\Component\Console\Output\OutputInterface; /** * Text object descriptor. * * @since 2.0.0 */ final class TextDescriptor extends SymfonyTextDescriptor { /** * Describes an object. * * @param OutputInterface $output The output object to use. * @param object $object The object to describe. * @param array $options Descriptor options. * * @return void * * @since 2.0.0 */ public function describe(OutputInterface $output, $object, array $options = []) { $this->output = $output; switch (true) { case $object instanceof Application: $this->describeJoomlaApplication($object, $options); break; case $object instanceof AbstractCommand: $this->describeConsoleCommand($object, $options); break; default: parent::describe($output, $object, $options); } } /** * Formats command aliases to show them in the command description. * * @param AbstractCommand $command The command to process * * @return string * * @since 2.0.0 */ private function getCommandAliasesText(AbstractCommand $command): string { $text = ''; $aliases = $command->getAliases(); if ($aliases) { $text = '[' . implode('|', $aliases) . '] '; } return $text; } /** * Describes a command. * * @param AbstractCommand $command The command being described. * @param array $options Descriptor options. * * @return void * * @since 2.0.0 */ private function describeConsoleCommand(AbstractCommand $command, array $options): void { $command->getSynopsis(true); $command->getSynopsis(false); $command->mergeApplicationDefinition(false); $this->writeText('<comment>Usage:</comment>', $options); foreach (array_merge([$command->getSynopsis(true)], $command->getAliases()) as $usage) { $this->writeText("\n"); $this->writeText(' ' . $usage, $options); } $this->writeText("\n"); $definition = $command->getDefinition(); if ($definition->getOptions() || $definition->getArguments()) { $this->writeText("\n"); $this->describeInputDefinition($definition, $options); $this->writeText("\n"); } if ($help = $command->getProcessedHelp()) { $this->writeText("\n"); $this->writeText('<comment>Help:</comment>', $options); $this->writeText("\n"); $this->writeText(' ' . str_replace("\n", "\n ", $help), $options); $this->writeText("\n"); } } /** * Describes an application. * * @param Application $app The application being described. * @param array $options Descriptor options. * * @return void * * @since 2.0.0 */ private function describeJoomlaApplication(Application $app, array $options): void { $describedNamespace = $options['namespace'] ?? ''; $description = new ApplicationDescription($app, $describedNamespace); $version = $app->getLongVersion(); if ($version !== '') { $this->writeText("$version\n\n", $options); } $this->writeText("<comment>Usage:</comment>\n"); $this->writeText(" command [options] [arguments]\n\n"); $this->describeInputDefinition(new InputDefinition($app->getDefinition()->getOptions()), $options); $this->writeText("\n"); $this->writeText("\n"); $commands = $description->getCommands(); $namespaces = $description->getNamespaces(); if ($describedNamespace && $namespaces) { // Ensure all aliased commands are included when describing a specific namespace $describedNamespaceInfo = reset($namespaces); foreach ($describedNamespaceInfo['commands'] as $name) { $commands[$name] = $description->getCommand($name); } } $width = $this->getColumnWidth( \call_user_func_array( 'array_merge', array_map( function ($namespace) use ($commands) { return array_intersect($namespace['commands'], array_keys($commands)); }, array_values($namespaces) ) ) ); if ($describedNamespace) { $this->writeText(sprintf('<comment>Available commands for the "%s" namespace:</comment>', $describedNamespace), $options); } else { $this->writeText('<comment>Available commands:</comment>', $options); } foreach ($namespaces as $namespace) { $namespace['commands'] = array_filter( $namespace['commands'], function ($name) use ($commands) { return isset($commands[$name]); } ); if (!$namespace['commands']) { continue; } if (!$describedNamespace && $namespace['id'] !== ApplicationDescription::GLOBAL_NAMESPACE) { $this->writeText("\n"); $this->writeText(' <comment>' . $namespace['id'] . '</comment>', $options); } foreach ($namespace['commands'] as $name) { $this->writeText("\n"); $spacingWidth = $width - StringHelper::strlen($name); $command = $commands[$name]; $commandAliases = $name === $command->getName() ? $this->getCommandAliasesText($command) : ''; $this->writeText( sprintf( ' <info>%s</info>%s%s', $name, str_repeat(' ', $spacingWidth), $commandAliases . $command->getDescription() ), $options ); } } $this->writeText("\n"); } /** * Calculate the column width for a group of commands. * * @param AbstractCommand[]|string[] $commands The commands to use for processing a width. * * @return integer * * @since 2.0.0 */ private function getColumnWidth(array $commands): int { $widths = []; foreach ($commands as $command) { if ($command instanceof AbstractCommand) { $widths[] = StringHelper::strlen($command->getName()); foreach ($command->getAliases() as $alias) { $widths[] = StringHelper::strlen($alias); } } else { $widths[] = StringHelper::strlen($command); } } return $widths ? max($widths) + 2 : 0; } /** * Writes text to the output. * * @param string $content The message. * @param array $options The options to use for formatting the output. * * @return void * * @since 2.0.0 */ private function writeText($content, array $options = []): void { $this->write( isset($options['raw_text']) && $options['raw_text'] ? strip_tags($content) : $content, isset($options['raw_output']) ? !$options['raw_output'] : true ); } } PK c�\O �j� � # console/src/Command/ListCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Command; use Joomla\Console\Helper\DescriptorHelper; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Output\OutputInterface; /** * Command listing all available commands. * * @since 2.0.0 */ class ListCommand extends AbstractCommand { /** * The default command name * * @var string * @since 2.0.0 */ protected static $defaultName = 'list'; /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { $this->setDescription("List the application's available commands"); $this->addArgument('namespace', InputArgument::OPTIONAL, 'The namespace name'); $this->setHelp(<<<'EOF' The <info>%command.name%</info> command lists all of the application's commands: <info>php %command.full_name%</info> EOF ); } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ protected function doExecute(InputInterface $input, OutputInterface $output): int { $descriptor = new DescriptorHelper; if ($this->getHelperSet() !== null) { $this->getHelperSet()->set($descriptor); } $descriptor->describe( $output, $this->getApplication(), [ 'namespace' => $input->getArgument('namespace'), ] ); return 0; } } PK c�\� # console/src/Command/HelpCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Command; use Joomla\Console\Helper\DescriptorHelper; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Output\OutputInterface; /** * Command to render a command's help data. * * @since 2.0.0 */ class HelpCommand extends AbstractCommand { /** * The default command name * * @var string * @since 2.0.0 */ protected static $defaultName = 'help'; /** * The command to process help for * * @var AbstractCommand|null * @since 2.0.0 */ private $command; /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { $this->setDescription('Show the help for a command'); $this->setHelp(<<<'EOF' The <info>%command.name%</info> command displays a command's help information: <info>php %command.full_name% list</info> To display the list of available commands, please use the <info>list</info> command. EOF ); $this->addArgument('command_name', InputArgument::OPTIONAL, 'The command name', 'help'); } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ protected function doExecute(InputInterface $input, OutputInterface $output): int { if (!$this->command) { $this->command = $this->getApplication()->getCommand($input->getArgument('command_name')); } $descriptor = new DescriptorHelper; if ($this->getHelperSet() !== null) { $this->getHelperSet()->set($descriptor); } $descriptor->describe($output, $this->command); return 0; } /** * Set the command whose help is being presented. * * @param AbstractCommand $command The command to process help for. * * @return void * * @since 2.0.0 */ public function setCommand(AbstractCommand $command): void { $this->command = $command; } } PK c�\��fE�1 �1 ' console/src/Command/AbstractCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Command; use Joomla\Console\Application; use Symfony\Component\Console\Helper\HelperSet; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputDefinition; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Input\InputOption; use Symfony\Component\Console\Output\OutputInterface; /** * Base command class for a Joomla! command line application. * * @since 2.0.0 */ abstract class AbstractCommand { /** * The default command name * * @var string|null * @since 2.0.0 */ protected static $defaultName; /** * The command's aliases. * * @var string[] * @since 2.0.0 */ private $aliases = []; /** * The application running this command. * * @var Application|null * @since 2.0.0 */ private $application; /** * Flag tracking whether the application definition has been merged to this command. * * @var boolean * @since 2.0.0 */ private $applicationDefinitionMerged = false; /** * Flag tracking whether the application definition with arguments has been merged to this command. * * @var boolean * @since 2.0.0 */ private $applicationDefinitionMergedWithArgs = false; /** * The command's input definition. * * @var InputDefinition * @since 2.0.0 */ private $definition; /** * The command's description. * * @var string * @since 2.0.0 */ private $description = ''; /** * The command's help. * * @var string * @since 2.0.0 */ private $help = ''; /** * The command's input helper set. * * @var HelperSet|null * @since 2.0.0 */ private $helperSet; /** * Flag tracking whether the command is hidden from the command listing. * * @var boolean * @since 2.0.0 */ private $hidden = false; /** * The command's name. * * @var string * @since 2.0.0 */ private $name; /** * The command's synopses. * * @var string[] * @since 2.0.0 */ private $synopsis = []; /** * Command constructor. * * @param string|null $name The name of the command; if the name is empty and no default is set, a name must be set in the configure() method * * @since 2.0.0 */ public function __construct(?string $name = null) { $this->definition = new InputDefinition; if ($name !== null || null !== $name = static::getDefaultName()) { $this->setName($name); } $this->configure(); } /** * Adds an argument to the input definition. * * @param string $name The argument name * @param integer $mode The argument mode: InputArgument::REQUIRED or InputArgument::OPTIONAL * @param string $description A description text * @param mixed $default The default value (for InputArgument::OPTIONAL mode only) * * @return $this * * @since 2.0.0 */ public function addArgument(string $name, ?int $mode = null, string $description = '', $default = null): self { $this->definition->addArgument(new InputArgument($name, $mode, $description, $default)); return $this; } /** * Adds an option to the input definition. * * @param string $name The option name * @param string|array $shortcut The shortcuts, can be null, a string of shortcuts delimited by | or an array of shortcuts * @param integer $mode The option mode: One of the VALUE_* constants * @param string $description A description text * @param mixed $default The default value (must be null for InputOption::VALUE_NONE) * * @return $this * * @since 2.0.0 */ public function addOption(string $name, $shortcut = null, ?int $mode = null, $description = '', $default = null): self { $this->definition->addOption(new InputOption($name, $shortcut, $mode, $description, $default)); return $this; } /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ abstract protected function doExecute(InputInterface $input, OutputInterface $output): int; /** * Executes the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ public function execute(InputInterface $input, OutputInterface $output): int { // Force the creation of the synopsis before the merge with the app definition $this->getSynopsis(true); $this->getSynopsis(false); // Add the application arguments and options $this->mergeApplicationDefinition(); // Bind the input against the command specific arguments/options $input->bind($this->getDefinition()); $this->initialise($input, $output); // Ensure that the command has a `command` argument so it does not fail validation if ($input->hasArgument('command') && $input->getArgument('command') === null) { $input->setArgument('command', $this->getName()); } $input->validate(); return $this->doExecute($input, $output); } /** * Get the command's aliases. * * @return string[] * * @since 2.0.0 */ public function getAliases(): array { return $this->aliases; } /** * Get the application object. * * @return Application The application object. * * @since 2.0.0 * @throws \UnexpectedValueException if the application has not been set. */ public function getApplication(): Application { if ($this->application) { return $this->application; } throw new \UnexpectedValueException('Application not set in ' . \get_class($this)); } /** * Get the default command name for this class. * * This allows a command name to defined and referenced without instantiating the full command class. * * @return string|null * * @since 2.0.0 */ public static function getDefaultName(): ?string { $class = \get_called_class(); $r = new \ReflectionProperty($class, 'defaultName'); return $class === $r->class ? static::$defaultName : null; } /** * Gets the InputDefinition attached to this command. * * @return InputDefinition * * @since 2.0.0 */ public function getDefinition(): InputDefinition { return $this->definition; } /** * Get the command's description. * * @return string * * @since 2.0.0 */ public function getDescription(): string { return $this->description; } /** * Get the command's help. * * @return string * * @since 2.0.0 */ public function getHelp(): string { return $this->help; } /** * Get the command's input helper set. * * @return HelperSet|null * * @since 2.0.0 */ public function getHelperSet(): ?HelperSet { return $this->helperSet; } /** * Get the command's name. * * @return string|null * * @since 2.0.0 */ public function getName(): ?string { return $this->name; } /** * Returns the processed help for the command. * * This method is used to replace placeholders in commands with the real values. * By default, this supports `%command.name%` and `%command.full_name`. * * @return string * * @since 2.0.0 */ public function getProcessedHelp(): string { $name = $this->getName(); $placeholders = [ '%command.name%', '%command.full_name%', ]; $replacements = [ $name, $_SERVER['PHP_SELF'] . ' ' . $name, ]; return str_replace($placeholders, $replacements, $this->getHelp() ?: $this->getDescription()); } /** * Get the command's synopsis. * * @param boolean $short Flag indicating whether the short or long version of the synopsis should be returned * * @return string * * @since 2.0.0 */ public function getSynopsis(bool $short = false): string { $key = $short ? 'short' : 'long'; if (!isset($this->synopsis[$key])) { $this->synopsis[$key] = trim(sprintf('%s %s', $this->getName(), $this->getDefinition()->getSynopsis($short))); } return $this->synopsis[$key]; } /** * Internal hook to initialise the command after the input has been bound and before the input is validated. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return void * * @since 2.0.0 */ protected function initialise(InputInterface $input, OutputInterface $output): void { } /** * Check if the command is enabled in this environment. * * @return boolean * * @since 2.0.0 */ public function isEnabled(): bool { return true; } /** * Check if the command is hidden from the command listing. * * @return boolean * * @since 2.0.0 */ public function isHidden(): bool { return $this->hidden; } /** * Merges the application definition with the command definition. * * @param boolean $mergeArgs Flag indicating whether the application's definition arguments should be merged * * @return void * * @since 2.0.0 * @internal This method should not be relied on as part of the public API */ final public function mergeApplicationDefinition(bool $mergeArgs = true): void { if (!$this->application || ($this->applicationDefinitionMerged && ($this->applicationDefinitionMergedWithArgs || !$mergeArgs))) { return; } $this->getDefinition()->addOptions($this->getApplication()->getDefinition()->getOptions()); $this->applicationDefinitionMerged = true; if ($mergeArgs) { $currentArguments = $this->getDefinition()->getArguments(); $this->getDefinition()->setArguments($this->getApplication()->getDefinition()->getArguments()); $this->getDefinition()->addArguments($currentArguments); $this->applicationDefinitionMergedWithArgs = true; } } /** * Set the command's aliases. * * @param string[] $aliases The command aliases * * @return void * * @since 2.0.0 */ public function setAliases(array $aliases): void { $this->aliases = $aliases; } /** * Set the command's application. * * @param Application $application The command's application * * @return void * * @since 2.0.0 */ public function setApplication(?Application $application = null): void { $this->application = $application; if ($application) { $this->setHelperSet($application->getHelperSet()); } else { $this->helperSet = null; } } /** * Sets the input definition for the command. * * @param array|InputDefinition $definition Either an InputDefinition object or an array of objects to write to the definition. * * @return void * * @since 2.0.0 */ public function setDefinition($definition): void { if ($definition instanceof InputDefinition) { $this->definition = $definition; } else { $this->definition->setDefinition($definition); } $this->applicationDefinitionMerged = false; } /** * Sets the description for the command. * * @param string $description The description for the command * * @return void * * @since 2.0.0 */ public function setDescription(string $description): void { $this->description = $description; } /** * Sets the help for the command. * * @param string $help The help for the command * * @return void * * @since 2.0.0 */ public function setHelp(string $help): void { $this->help = $help; } /** * Set the command's input helper set. * * @param HelperSet $helperSet The helper set. * * @return void * * @since 2.0.0 */ public function setHelperSet(HelperSet $helperSet): void { $this->helperSet = $helperSet; } /** * Set whether this command is hidden from the command listing. * * @param boolean $hidden Flag if this command is hidden. * * @return void * * @since 2.0.0 */ public function setHidden(bool $hidden): void { $this->hidden = $hidden; } /** * Set the command's name. * * @param string $name The command name * * @return void * * @since 2.0.0 */ public function setName(string $name): void { $this->name = $name; } } PK c�\bs "� � 4 console/src/Exception/NamespaceNotFoundException.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Exception; use Symfony\Component\Console\Exception\CommandNotFoundException; /** * Exception indicating a missing command namespace. * * @since 2.0.0 */ class NamespaceNotFoundException extends CommandNotFoundException { } PK c�\Y)�U� U� console/src/Application.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console; use Joomla\Application\AbstractApplication; use Joomla\Application\ApplicationEvents; use Joomla\Console\Command\AbstractCommand; use Joomla\Console\Command\HelpCommand; use Joomla\Console\Event\ApplicationErrorEvent; use Joomla\Console\Event\BeforeCommandExecuteEvent; use Joomla\Console\Event\CommandErrorEvent; use Joomla\Console\Event\TerminateEvent; use Joomla\Console\Exception\NamespaceNotFoundException; use Joomla\Registry\Registry; use Joomla\String\StringHelper; use Symfony\Component\Console\Exception\CommandNotFoundException; use Symfony\Component\Console\Exception\ExceptionInterface; use Symfony\Component\Console\Exception\LogicException; use Symfony\Component\Console\Formatter\OutputFormatter; use Symfony\Component\Console\Helper\DebugFormatterHelper; use Symfony\Component\Console\Helper\FormatterHelper; use Symfony\Component\Console\Helper\HelperSet; use Symfony\Component\Console\Helper\ProcessHelper; use Symfony\Component\Console\Helper\QuestionHelper; use Symfony\Component\Console\Input\ArgvInput; use Symfony\Component\Console\Input\ArrayInput; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputAwareInterface; use Symfony\Component\Console\Input\InputDefinition; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Input\InputOption; use Symfony\Component\Console\Output\ConsoleOutput; use Symfony\Component\Console\Output\ConsoleOutputInterface; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Style\SymfonyStyle; use Symfony\Component\Console\Terminal; use Symfony\Component\ErrorHandler\ErrorHandler; /** * Base application class for a Joomla! command line application. * * @since 2.0.0 */ class Application extends AbstractApplication { /** * Flag indicating the application should automatically exit after the command is run. * * @var boolean * @since 2.0.0 */ private $autoExit = true; /** * Flag indicating the application should catch and handle Throwables. * * @var boolean * @since 2.0.0 */ private $catchThrowables = true; /** * The available commands. * * @var AbstractCommand[] * @since 2.0.0 */ private $commands = []; /** * The command loader. * * @var Loader\LoaderInterface|null * @since 2.0.0 */ private $commandLoader; /** * Console input handler. * * @var InputInterface * @since 2.0.0 */ private $consoleInput; /** * Console output handler. * * @var OutputInterface * @since 2.0.0 */ private $consoleOutput; /** * The default command for the application. * * @var string * @since 2.0.0 */ private $defaultCommand = 'list'; /** * The application input definition. * * @var InputDefinition|null * @since 2.0.0 */ private $definition; /** * The application helper set. * * @var HelperSet|null * @since 2.0.0 */ private $helperSet; /** * Internal flag tracking if the command store has been initialised. * * @var boolean * @since 2.0.0 */ private $initialised = false; /** * The name of the application. * * @var string * @since 2.0.0 */ private $name = ''; /** * Reference to the currently running command. * * @var AbstractCommand|null * @since 2.0.0 */ private $runningCommand; /** * The console terminal helper. * * @var Terminal * @since 2.0.0 */ private $terminal; /** * The version of the application. * * @var string * @since 2.0.0 */ private $version = ''; /** * Internal flag tracking if the user is seeking help for the given command. * * @var boolean * @since 2.0.0 */ private $wantsHelp = false; /** * Class constructor. * * @param InputInterface $input An optional argument to provide dependency injection for the application's input object. If the argument is * an InputInterface object that object will become the application's input object, otherwise a default input * object is created. * @param OutputInterface $output An optional argument to provide dependency injection for the application's output object. If the argument * is an OutputInterface object that object will become the application's output object, otherwise a default * output object is created. * @param Registry $config An optional argument to provide dependency injection for the application's config object. If the argument * is a Registry object that object will become the application's config object, otherwise a default config * object is created. * * @since 2.0.0 */ public function __construct(?InputInterface $input = null, ?OutputInterface $output = null, ?Registry $config = null) { // Close the application if we are not executed from the command line. if (!\defined('STDOUT') || !\defined('STDIN') || !isset($_SERVER['argv'])) { $this->close(); } $this->consoleInput = $input ?: new ArgvInput; $this->consoleOutput = $output ?: new ConsoleOutput; $this->terminal = new Terminal; // Call the constructor as late as possible (it runs `initialise`). parent::__construct($config); } /** * Adds a command object. * * If a command with the same name already exists, it will be overridden. If the command is not enabled it will not be added. * * @param AbstractCommand $command The command to add to the application. * * @return AbstractCommand * * @since 2.0.0 * @throws LogicException */ public function addCommand(AbstractCommand $command): AbstractCommand { $this->initCommands(); if (!$command->isEnabled()) { return $command; } $command->setApplication($this); try { $command->getDefinition(); } catch (\TypeError $exception) { throw new LogicException(sprintf('Command class "%s" is not correctly initialised.', \get_class($command)), 0, $exception); } if (!$command->getName()) { throw new LogicException(sprintf('The command class "%s" does not have a name.', \get_class($command))); } $this->commands[$command->getName()] = $command; foreach ($command->getAliases() as $alias) { $this->commands[$alias] = $command; } return $command; } /** * Configures the console input and output instances for the process. * * @return void * * @since 2.0.0 */ protected function configureIO(): void { if ($this->consoleInput->hasParameterOption(['--ansi'], true)) { $this->consoleOutput->setDecorated(true); } elseif ($this->consoleInput->hasParameterOption(['--no-ansi'], true)) { $this->consoleOutput->setDecorated(false); } if ($this->consoleInput->hasParameterOption(['--no-interaction', '-n'], true)) { $this->consoleInput->setInteractive(false); } if ($this->consoleInput->hasParameterOption(['--quiet', '-q'], true)) { $this->consoleOutput->setVerbosity(OutputInterface::VERBOSITY_QUIET); $this->consoleInput->setInteractive(false); } else { if ($this->consoleInput->hasParameterOption('-vvv', true) || $this->consoleInput->hasParameterOption('--verbose=3', true) || $this->consoleInput->getParameterOption('--verbose', false, true) === 3 ) { $this->consoleOutput->setVerbosity(OutputInterface::VERBOSITY_DEBUG); } elseif ($this->consoleInput->hasParameterOption('-vv', true) || $this->consoleInput->hasParameterOption('--verbose=2', true) || $this->consoleInput->getParameterOption('--verbose', false, true) === 2 ) { $this->consoleOutput->setVerbosity(OutputInterface::VERBOSITY_VERY_VERBOSE); } elseif ($this->consoleInput->hasParameterOption('-v', true) || $this->consoleInput->hasParameterOption('--verbose=1', true) || $this->consoleInput->hasParameterOption('--verbose', true) || $this->consoleInput->getParameterOption('--verbose', false, true) ) { $this->consoleOutput->setVerbosity(OutputInterface::VERBOSITY_VERBOSE); } } } /** * Method to run the application routines. * * @return integer The exit code for the application * * @since 2.0.0 * @throws \Throwable */ protected function doExecute(): int { $input = $this->consoleInput; $output = $this->consoleOutput; // If requesting the version, short circuit the application and send the version data if ($input->hasParameterOption(['--version', '-V'], true)) { $output->writeln($this->getLongVersion()); return 0; } try { // Makes ArgvInput::getFirstArgument() able to distinguish an option from an argument. $input->bind($this->getDefinition()); } catch (ExceptionInterface $e) { // Errors must be ignored, full binding/validation happens later when the command is known. } $name = $this->getCommandName($input); // Redirect to the help command if requested if ($input->hasParameterOption(['--help', '-h'], true)) { // If no command name was given, use the help command with a minimal input; otherwise flag the request for processing later if (!$name) { $name = 'help'; $input = new ArrayInput(['command_name' => $this->defaultCommand]); } else { $this->wantsHelp = true; } } // If we still do not have a command name, then the user has requested the application's default command if (!$name) { $name = $this->defaultCommand; $definition = $this->getDefinition(); // Overwrite the default value of the command argument with the default command name $definition->setArguments( array_merge( $definition->getArguments(), [ 'command' => new InputArgument( 'command', InputArgument::OPTIONAL, $definition->getArgument('command')->getDescription(), $name ), ] ) ); } try { $this->runningCommand = null; $command = $this->getCommand($name); } catch (\Throwable $e) { if ($e instanceof CommandNotFoundException && !($e instanceof NamespaceNotFoundException)) { (new SymfonyStyle($input, $output))->block(sprintf("\nCommand \"%s\" is not defined.\n", $name), null, 'error'); } $event = new CommandErrorEvent($e, $this); $this->dispatchEvent(ConsoleEvents::COMMAND_ERROR, $event); if ($event->getExitCode() === 0) { return 0; } $e = $event->getError(); throw $e; } $this->runningCommand = $command; $exitCode = $this->runCommand($command, $input, $output); $this->runningCommand = null; return $exitCode; } /** * Execute the application. * * @return void * * @since 2.0.0 * @throws \Throwable */ public function execute() { putenv('LINES=' . $this->terminal->getHeight()); putenv('COLUMNS=' . $this->terminal->getWidth()); $this->configureIO(); $renderThrowable = function (\Throwable $e) { $this->renderThrowable($e); }; if ($phpHandler = set_exception_handler($renderThrowable)) { restore_exception_handler(); if (!\is_array($phpHandler) || !$phpHandler[0] instanceof ErrorHandler) { $errorHandler = true; } elseif ($errorHandler = $phpHandler[0]->setExceptionHandler($renderThrowable)) { $phpHandler[0]->setExceptionHandler($errorHandler); } } try { $this->dispatchEvent(ApplicationEvents::BEFORE_EXECUTE); // Perform application routines. $exitCode = $this->doExecute(); $this->dispatchEvent(ApplicationEvents::AFTER_EXECUTE); } catch (\Throwable $throwable) { if (!$this->shouldCatchThrowables()) { throw $throwable; } $renderThrowable($throwable); $event = new ApplicationErrorEvent($throwable, $this, $this->runningCommand); $this->dispatchEvent(ConsoleEvents::APPLICATION_ERROR, $event); $exitCode = $event->getExitCode(); if (is_numeric($exitCode)) { $exitCode = (int) $exitCode; if ($exitCode === 0) { $exitCode = 1; } } else { $exitCode = 1; } } finally { // If the exception handler changed, keep it; otherwise, unregister $renderThrowable if (!$phpHandler) { if (set_exception_handler($renderThrowable) === $renderThrowable) { restore_exception_handler(); } restore_exception_handler(); } elseif (!$errorHandler) { $finalHandler = $phpHandler[0]->setExceptionHandler(null); if ($finalHandler !== $renderThrowable) { $phpHandler[0]->setExceptionHandler($finalHandler); } } if ($this->shouldAutoExit() && isset($exitCode)) { $exitCode = $exitCode > 255 ? 255 : $exitCode; $this->close($exitCode); } } } /** * Finds a registered namespace by a name. * * @param string $namespace A namespace to search for * * @return string * * @since 2.0.0 * @throws NamespaceNotFoundException When namespace is incorrect or ambiguous */ public function findNamespace(string $namespace): string { $allNamespaces = $this->getNamespaces(); $expr = preg_replace_callback( '{([^:]+|)}', function ($matches) { return preg_quote($matches[1]) . '[^:]*'; }, $namespace ); $namespaces = preg_grep('{^' . $expr . '}', $allNamespaces); if (empty($namespaces)) { throw new NamespaceNotFoundException(sprintf('There are no commands defined in the "%s" namespace.', $namespace)); } $exact = \in_array($namespace, $namespaces, true); if (\count($namespaces) > 1 && !$exact) { throw new NamespaceNotFoundException(sprintf('The namespace "%s" is ambiguous.', $namespace)); } return $exact ? $namespace : reset($namespaces); } /** * Gets all commands, including those available through a command loader, optionally filtered on a command namespace. * * @param string $namespace An optional command namespace to filter by. * * @return AbstractCommand[] * * @since 2.0.0 */ public function getAllCommands(string $namespace = ''): array { $this->initCommands(); if ($namespace === '') { $commands = $this->commands; if (!$this->commandLoader) { return $commands; } foreach ($this->commandLoader->getNames() as $name) { if (!isset($commands[$name])) { $commands[$name] = $this->getCommand($name); } } return $commands; } $commands = []; foreach ($this->commands as $name => $command) { if ($namespace === $this->extractNamespace($name, substr_count($namespace, ':') + 1)) { $commands[$name] = $command; } } if ($this->commandLoader) { foreach ($this->commandLoader->getNames() as $name) { if (!isset($commands[$name]) && $namespace === $this->extractNamespace($name, substr_count($namespace, ':') + 1)) { $commands[$name] = $this->getCommand($name); } } } return $commands; } /** * Returns a registered command by name or alias. * * @param string $name The command name or alias * * @return AbstractCommand * * @since 2.0.0 * @throws CommandNotFoundException */ public function getCommand(string $name): AbstractCommand { $this->initCommands(); if (!$this->hasCommand($name)) { throw new CommandNotFoundException(sprintf('The command "%s" does not exist.', $name)); } // If the command isn't registered, pull it from the loader if registered if (!isset($this->commands[$name]) && $this->commandLoader) { $this->addCommand($this->commandLoader->get($name)); } $command = $this->commands[$name]; // If the user requested help, we'll fetch the help command now and inject the user's command into it if ($this->wantsHelp) { $this->wantsHelp = false; /** @var HelpCommand $helpCommand */ $helpCommand = $this->getCommand('help'); $helpCommand->setCommand($command); return $helpCommand; } return $command; } /** * Get the name of the command to run. * * @param InputInterface $input The input to read the argument from * * @return string|null * * @since 2.0.0 */ protected function getCommandName(InputInterface $input): ?string { return $input->getFirstArgument(); } /** * Get the registered commands. * * This method only retrieves commands which have been explicitly registered. To get all commands including those from a * command loader, use the `getAllCommands()` method. * * @return AbstractCommand[] * * @since 2.0.0 */ public function getCommands(): array { return $this->commands; } /** * Get the console input handler. * * @return InputInterface * * @since 2.0.0 */ public function getConsoleInput(): InputInterface { return $this->consoleInput; } /** * Get the console output handler. * * @return OutputInterface * * @since 2.0.0 */ public function getConsoleOutput(): OutputInterface { return $this->consoleOutput; } /** * Get the commands which should be registered by default to the application. * * @return AbstractCommand[] * * @since 2.0.0 */ protected function getDefaultCommands(): array { return [ new Command\ListCommand, new Command\HelpCommand, ]; } /** * Builds the default input definition. * * @return InputDefinition * * @since 2.0.0 */ protected function getDefaultInputDefinition(): InputDefinition { return new InputDefinition( [ new InputArgument('command', InputArgument::REQUIRED, 'The command to execute'), new InputOption('--help', '-h', InputOption::VALUE_NONE, 'Display the help information'), new InputOption('--quiet', '-q', InputOption::VALUE_NONE, 'Flag indicating that all output should be silenced'), new InputOption( '--verbose', '-v|vv|vvv', InputOption::VALUE_NONE, 'Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug' ), new InputOption('--version', '-V', InputOption::VALUE_NONE, 'Displays the application version'), new InputOption('--ansi', '', InputOption::VALUE_NONE, 'Force ANSI output'), new InputOption('--no-ansi', '', InputOption::VALUE_NONE, 'Disable ANSI output'), new InputOption('--no-interaction', '-n', InputOption::VALUE_NONE, 'Flag to disable interacting with the user'), ] ); } /** * Builds the default helper set. * * @return HelperSet * * @since 2.0.0 */ protected function getDefaultHelperSet(): HelperSet { return new HelperSet( [ new FormatterHelper, new DebugFormatterHelper, new ProcessHelper, new QuestionHelper, ] ); } /** * Gets the InputDefinition related to this Application. * * @return InputDefinition * * @since 2.0.0 */ public function getDefinition(): InputDefinition { if (!$this->definition) { $this->definition = $this->getDefaultInputDefinition(); } return $this->definition; } /** * Get the helper set associated with the application. * * @return HelperSet */ public function getHelperSet(): HelperSet { if (!$this->helperSet) { $this->helperSet = $this->getDefaultHelperSet(); } return $this->helperSet; } /** * Get the long version string for the application. * * Typically, this is the application name and version and is used in the application help output. * * @return string * * @since 2.0.0 */ public function getLongVersion(): string { $name = $this->getName(); if ($name === '') { $name = 'Joomla Console Application'; } if ($this->getVersion() !== '') { return sprintf('%s <info>%s</info>', $name, $this->getVersion()); } return $name; } /** * Get the name of the application. * * @return string * * @since 2.0.0 */ public function getName(): string { return $this->name; } /** * Returns an array of all unique namespaces used by currently registered commands. * * Note that this does not include the global namespace which always exists. * * @return string[] * * @since 2.0.0 */ public function getNamespaces(): array { $namespaces = []; foreach ($this->getAllCommands() as $command) { $namespaces = array_merge($namespaces, $this->extractAllNamespaces($command->getName())); foreach ($command->getAliases() as $alias) { $namespaces = array_merge($namespaces, $this->extractAllNamespaces($alias)); } } return array_values(array_unique(array_filter($namespaces))); } /** * Get the version of the application. * * @return string * * @since 2.0.0 */ public function getVersion(): string { return $this->version; } /** * Check if the application has a command with the given name. * * @param string $name The name of the command to check for existence. * * @return boolean * * @since 2.0.0 */ public function hasCommand(string $name): bool { $this->initCommands(); // If command is already registered, we're good if (isset($this->commands[$name])) { return true; } // If there is no loader, we can't look for a command there if (!$this->commandLoader) { return false; } return $this->commandLoader->has($name); } /** * Custom initialisation method. * * @return void * * @since 2.0.0 */ protected function initialise(): void { // Set the current directory. $this->set('cwd', getcwd()); } /** * Renders an error message for a Throwable object * * @param \Throwable $throwable The Throwable object to render the message for. * * @return void * * @since 2.0.0 */ public function renderThrowable(\Throwable $throwable): void { $output = $this->consoleOutput instanceof ConsoleOutputInterface ? $this->consoleOutput->getErrorOutput() : $this->consoleOutput; $output->writeln('', OutputInterface::VERBOSITY_QUIET); $this->doRenderThrowable($throwable, $output); if (null !== $this->runningCommand) { $output->writeln( sprintf( '<info>%s</info>', sprintf($this->runningCommand->getSynopsis(), $this->getName()) ), OutputInterface::VERBOSITY_QUIET ); $output->writeln('', OutputInterface::VERBOSITY_QUIET); } } /** * Handles recursively rendering error messages for a Throwable and all previous Throwables contained within. * * @param \Throwable $throwable The Throwable object to render the message for. * @param OutputInterface $output The output object to send the message to. * * @return void * * @since 2.0.0 */ protected function doRenderThrowable(\Throwable $throwable, OutputInterface $output): void { do { $message = trim($throwable->getMessage()); if ($message === '' || OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) { $class = \get_class($throwable); if ($class[0] === 'c' && strpos($class, "class@anonymous\0") === 0) { $class = get_parent_class($class) ?: key(class_implements($class)); } $title = sprintf(' [%s%s] ', $class, ($code = $throwable->getCode()) !== 0 ? ' (' . $code . ')' : ''); $len = StringHelper::strlen($title); } else { $len = 0; } if (strpos($message, "class@anonymous\0") !== false) { $message = preg_replace_callback( '/class@anonymous\x00.*?\.php(?:0x?|:[0-9]++\$)[0-9a-fA-F]++/', function ($m) { return class_exists($m[0], false) ? (get_parent_class($m[0]) ?: key(class_implements($m[0]))) . '@anonymous' : $m[0]; }, $message ); } $width = $this->terminal->getWidth() ? $this->terminal->getWidth() - 1 : PHP_INT_MAX; $lines = []; foreach ($message !== '' ? preg_split('/\r?\n/', $message) : [] as $line) { foreach ($this->splitStringByWidth($line, $width - 4) as $line) { // Pre-format lines to get the right string length $lineLength = StringHelper::strlen($line) + 4; $lines[] = [$line, $lineLength]; $len = max($lineLength, $len); } } $messages = []; if (!$throwable instanceof ExceptionInterface || OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) { $messages[] = sprintf( '<comment>%s</comment>', OutputFormatter::escape( sprintf( 'In %s line %s:', basename($throwable->getFile()) ?: 'n/a', $throwable->getLine() ?: 'n/a' ) ) ); } $messages[] = $emptyLine = sprintf('<error>%s</error>', str_repeat(' ', $len)); if ($message === '' || OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) { $messages[] = sprintf('<error>%s%s</error>', $title, str_repeat(' ', max(0, $len - StringHelper::strlen($title)))); } foreach ($lines as $line) { $messages[] = sprintf('<error> %s %s</error>', OutputFormatter::escape($line[0]), str_repeat(' ', $len - $line[1])); } $messages[] = $emptyLine; $messages[] = ''; $output->writeln($messages, OutputInterface::VERBOSITY_QUIET); if (OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) { $output->writeln('<comment>Exception trace:</comment>', OutputInterface::VERBOSITY_QUIET); // Exception related properties $trace = $throwable->getTrace(); array_unshift( $trace, [ 'function' => '', 'file' => $throwable->getFile() ?: 'n/a', 'line' => $throwable->getLine() ?: 'n/a', 'args' => [], ] ); for ($i = 0, $count = \count($trace); $i < $count; ++$i) { $class = $trace[$i]['class'] ?? ''; $type = $trace[$i]['type'] ?? ''; $function = $trace[$i]['function'] ?? ''; $file = $trace[$i]['file'] ?? 'n/a'; $line = $trace[$i]['line'] ?? 'n/a'; $output->writeln( sprintf( ' %s%s at <info>%s:%s</info>', $class, $function ? $type . $function . '()' : '', $file, $line ), OutputInterface::VERBOSITY_QUIET ); } $output->writeln('', OutputInterface::VERBOSITY_QUIET); } } while ($throwable = $throwable->getPrevious()); } /** * Splits a string for a specified width for use in an output. * * @param string $string The string to split. * @param integer $width The maximum width of the output. * * @return string[] * * @since 2.0.0 */ private function splitStringByWidth(string $string, int $width): array { /* * The str_split function is not suitable for multi-byte characters, we should use preg_split to get char array properly. * Additionally, array_slice() is not enough as some character has doubled width. * We need a function to split string not by character count but by string width */ if (false === $encoding = mb_detect_encoding($string, null, true)) { return str_split($string, $width); } $utf8String = mb_convert_encoding($string, 'utf8', $encoding); $lines = []; $line = ''; $offset = 0; while (preg_match('/.{1,10000}/u', $utf8String, $m, 0, $offset)) { $offset += \strlen($m[0]); foreach (preg_split('//u', $m[0]) as $char) { // Test if $char could be appended to current line if (mb_strwidth($line . $char, 'utf8') <= $width) { $line .= $char; continue; } // If not, push current line to array and make a new line $lines[] = str_pad($line, $width); $line = $char; } } $lines[] = \count($lines) ? str_pad($line, $width) : $line; mb_convert_variables($encoding, 'utf8', $lines); return $lines; } /** * Run the given command. * * @param AbstractCommand $command The command to run. * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer * * @since 2.0.0 * @throws \Throwable */ protected function runCommand(AbstractCommand $command, InputInterface $input, OutputInterface $output): int { if ($command->getHelperSet() !== null) { foreach ($command->getHelperSet() as $helper) { if ($helper instanceof InputAwareInterface) { $helper->setInput($input); } } } // If the application doesn't have an event dispatcher, we can short circuit and just execute the command try { $this->getDispatcher(); } catch (\UnexpectedValueException $exception) { return $command->execute($input, $output); } // Bind before dispatching the event so the listeners have access to input options/arguments try { $command->mergeApplicationDefinition(); $input->bind($command->getDefinition()); } catch (ExceptionInterface $e) { // Ignore invalid options/arguments for now } $event = new BeforeCommandExecuteEvent($this, $command); $exception = null; try { $this->dispatchEvent(ConsoleEvents::BEFORE_COMMAND_EXECUTE, $event); if ($event->isCommandEnabled()) { $exitCode = $command->execute($input, $output); } else { $exitCode = BeforeCommandExecuteEvent::RETURN_CODE_DISABLED; } } catch (\Throwable $exception) { $event = new CommandErrorEvent($exception, $this, $command); $this->dispatchEvent(ConsoleEvents::COMMAND_ERROR, $event); $exception = $event->getError(); $exitCode = $event->getExitCode(); if ($exitCode === 0) { $exception = null; } } $event = new TerminateEvent($exitCode, $this, $command); $this->dispatchEvent(ConsoleEvents::TERMINATE, $event); if ($exception !== null) { throw $exception; } return $event->getExitCode(); } /** * Set whether the application should auto exit. * * @param boolean $autoExit The auto exit state. * * @return void * * @since 2.0.0 */ public function setAutoExit(bool $autoExit): void { $this->autoExit = $autoExit; } /** * Set whether the application should catch Throwables. * * @param boolean $catchThrowables The catch Throwables state. * * @return void * * @since 2.0.0 */ public function setCatchThrowables(bool $catchThrowables): void { $this->catchThrowables = $catchThrowables; } /** * Set the command loader. * * @param Loader\LoaderInterface $loader The new command loader. * * @return void * * @since 2.0.0 */ public function setCommandLoader(Loader\LoaderInterface $loader): void { $this->commandLoader = $loader; } /** * Set the application's helper set. * * @param HelperSet $helperSet The new HelperSet. * * @return void * * @since 2.0.0 */ public function setHelperSet(HelperSet $helperSet): void { $this->helperSet = $helperSet; } /** * Set the name of the application. * * @param string $name The new application name. * * @return void * * @since 2.0.0 */ public function setName(string $name): void { $this->name = $name; } /** * Set the version of the application. * * @param string $version The new application version. * * @return void * * @since 2.0.0 */ public function setVersion(string $version): void { $this->version = $version; } /** * Get the application's auto exit state. * * @return boolean * * @since 2.0.0 */ public function shouldAutoExit(): bool { return $this->autoExit; } /** * Get the application's catch Throwables state. * * @return boolean * * @since 2.0.0 */ public function shouldCatchThrowables(): bool { return $this->catchThrowables; } /** * Returns all namespaces of the command name. * * @param string $name The full name of the command * * @return string[] * * @since 2.0.0 */ private function extractAllNamespaces(string $name): array { // -1 as third argument is needed to skip the command short name when exploding $parts = explode(':', $name, -1); $namespaces = []; foreach ($parts as $part) { if (\count($namespaces)) { $namespaces[] = end($namespaces) . ':' . $part; } else { $namespaces[] = $part; } } return $namespaces; } /** * Returns the namespace part of the command name. * * @param string $name The command name to process * @param integer $limit The maximum number of parts of the namespace * * @return string * * @since 2.0.0 */ private function extractNamespace(string $name, ?int $limit = null): string { $parts = explode(':', $name); array_pop($parts); return implode(':', $limit === null ? $parts : \array_slice($parts, 0, $limit)); } /** * Internal function to initialise the command store, this allows the store to be lazy loaded only when needed. * * @return void * * @since 2.0.0 */ private function initCommands(): void { if ($this->initialised) { return; } $this->initialised = true; foreach ($this->getDefaultCommands() as $command) { $this->addCommand($command); } } } PK c�\�U}; & console/src/Loader/LoaderInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Loader; use Joomla\Console\Command\AbstractCommand; use Symfony\Component\Console\Exception\CommandNotFoundException; /** * Interface defining a command loader. * * @since 2.0.0 */ interface LoaderInterface { /** * Loads a command. * * @param string $name The command to load. * * @return AbstractCommand * * @since 2.0.0 * @throws CommandNotFoundException */ public function get(string $name): AbstractCommand; /** * Get the names of the registered commands. * * @return string[] * * @since 2.0.0 */ public function getNames(): array; /** * Checks if a command exists. * * @param string $name The command to check. * * @return boolean * * @since 2.0.0 */ public function has($name): bool; } PK c�\;"�� & console/src/Loader/ContainerLoader.phpnu �[��� <?php /** * Part of the Joomla Framework Console Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Console\Loader; use Joomla\Console\Command\AbstractCommand; use Psr\Container\ContainerInterface; use Symfony\Component\Console\Exception\CommandNotFoundException; /** * PSR-11 compatible command loader. * * @since 2.0.0 */ final class ContainerLoader implements LoaderInterface { /** * The service container. * * @var ContainerInterface * @since 2.0.0 */ private $container; /** * The command name to service ID map. * * @var string[] * @since 2.0.0 */ private $commandMap; /** * Constructor. * * @param ContainerInterface $container A container from which to load command services. * @param array $commandMap An array with command names as keys and service IDs as values. * * @since 2.0.0 */ public function __construct(ContainerInterface $container, array $commandMap) { $this->container = $container; $this->commandMap = $commandMap; } /** * Loads a command. * * @param string $name The command to load. * * @return AbstractCommand * * @since 2.0.0 * @throws CommandNotFoundException */ public function get(string $name): AbstractCommand { if (!$this->has($name)) { throw new CommandNotFoundException(sprintf('Command "%s" does not exist.', $name)); } return $this->container->get($this->commandMap[$name]); } /** * Get the names of the registered commands. * * @return string[] * * @since 2.0.0 */ public function getNames(): array { return array_keys($this->commandMap); } /** * Checks if a command exists. * * @param string $name The command to check. * * @return boolean * * @since 2.0.0 */ public function has($name): bool { return isset($this->commandMap[$name]) && $this->container->has($this->commandMap[$name]); } } PK c�\S�ao o console/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: d08e6f776c4c8e1ced520d903f1d524f96319eafcc8da82d2936b4473df36a3f ... PK c�\�+�m� � console/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\�P�E �E uri/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�+�m� � uri/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\�/�1o o uri/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: 2f694b65e34b9eafbca3bcd06a984cab6e57211a3dffab512363ed14d3176886 ... PK c�\��"�� � uri/src/Uri.phpnu �[��� <?php /** * Part of the Joomla Framework Uri Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Uri; /** * Uri Class * * This class parses a URI and provides a common interface for the Joomla Framework to access and manipulate a URI. * * @since 1.0 */ class Uri extends AbstractUri { /** * Adds a query variable and value, replacing the value if it already exists and returning the old value * * @param string $name Name of the query variable to set. * @param string $value Value of the query variable. * * @return string Previous value for the query variable. * * @since 1.0 */ public function setVar($name, $value) { $tmp = $this->vars[$name] ?? null; $this->vars[$name] = $value; // Empty the query $this->query = null; return $tmp; } /** * Removes an item from the query string variables if it exists * * @param string $name Name of variable to remove. * * @return void * * @since 1.0 */ public function delVar($name) { if (array_key_exists($name, $this->vars)) { unset($this->vars[$name]); // Empty the query $this->query = null; } } /** * Sets the query to a supplied string in format foo=bar&x=y * * @param array|string $query The query string or array. * * @return void * * @since 1.0 */ public function setQuery($query) { if (\is_array($query)) { $this->vars = $query; } else { if (strpos($query, '&') !== false) { $query = str_replace('&', '&', $query); } parse_str($query, $this->vars); } // Empty the query $this->query = null; } /** * Set the URI scheme (protocol) * * @param string $scheme The URI scheme. * * @return Uri This method supports chaining. * * @since 1.0 */ public function setScheme($scheme) { $this->scheme = $scheme; return $this; } /** * Set the URI username * * @param string $user The URI username. * * @return Uri This method supports chaining. * * @since 1.0 */ public function setUser($user) { $this->user = $user; return $this; } /** * Set the URI password * * @param string $pass The URI password. * * @return Uri This method supports chaining. * * @since 1.0 */ public function setPass($pass) { $this->pass = $pass; return $this; } /** * Set the URI host * * @param string $host The URI host. * * @return Uri This method supports chaining. * * @since 1.0 */ public function setHost($host) { $this->host = $host; return $this; } /** * Set the URI port * * @param integer $port The URI port number. * * @return Uri This method supports chaining. * * @since 1.0 */ public function setPort($port) { $this->port = $port; return $this; } /** * Set the URI path string * * @param string $path The URI path string. * * @return Uri This method supports chaining. * * @since 1.0 */ public function setPath($path) { $this->path = $this->cleanPath($path); return $this; } /** * Set the URI anchor string * * @param string $anchor The URI anchor string. * * @return Uri This method supports chaining. * * @since 1.0 */ public function setFragment($anchor) { $this->fragment = $anchor; return $this; } } PK c�\�$j�� � uri/src/UriImmutable.phpnu �[��� <?php /** * Part of the Joomla Framework Uri Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Uri; /** * UriImmutable Class * * This is an immutable version of the AbstractUri class. * * @since 1.0 */ final class UriImmutable extends AbstractUri { /** * Flag if the class been instantiated * * @var boolean * @since 1.0 */ private $constructed = false; /** * Prevent setting undeclared properties. * * @param string $name This is an immutable object, setting $name is not allowed. * @param mixed $value This is an immutable object, setting $value is not allowed. * * @return void This method always throws an exception. * * @since 1.0 * @throws \BadMethodCallException */ public function __set($name, $value) { throw new \BadMethodCallException('This is an immutable object'); } /** * This is a special constructor that prevents calling the __construct method again. * * @param string $uri The optional URI string * * @since 1.0 * @throws \BadMethodCallException */ public function __construct($uri = null) { if ($this->constructed === true) { throw new \BadMethodCallException('This is an immutable object'); } $this->constructed = true; parent::__construct($uri); } } PK c�\��� uri/src/UriHelper.phpnu �[��� <?php /** * Part of the Joomla Framework Uri Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Uri; /** * Uri Helper * * This class provides a UTF-8 safe version of parse_url(). * * @since 1.0 */ class UriHelper { /** * Does a UTF-8 safe version of PHP parse_url function * * @param string $url URL to parse * @param integer $component Retrieve just a specific URL component * * @return array|boolean Associative array or false if badly formed URL. * * @link https://www.php.net/manual/en/function.parse-url.php * @since 1.0 */ public static function parse_url($url, $component = -1) { $result = []; // If no UTF-8 chars in the url just parse it using php native parse_url which is faster. if (extension_loaded('mbstring') && mb_convert_encoding($url, 'ISO-8859-1', 'UTF-8') === $url) { return parse_url($url, $component); } // URL with UTF-8 chars in the url. // Build the reserved uri encoded characters map. $reservedUriCharactersMap = [ '%21' => '!', '%2A' => '*', '%27' => "'", '%28' => '(', '%29' => ')', '%3B' => ';', '%3A' => ':', '%40' => '@', '%26' => '&', '%3D' => '=', '%24' => '$', '%2C' => ',', '%2F' => '/', '%3F' => '?', '%23' => '#', '%5B' => '[', '%5D' => ']', ]; // Encode the URL (so UTF-8 chars are encoded), revert the encoding in the reserved uri characters and parse the url. $parts = parse_url(strtr(urlencode($url), $reservedUriCharactersMap), $component); // With a well formed url decode the url (so UTF-8 chars are decoded). return $parts ? array_map('urldecode', $parts) : $parts; } } PK c�\� �!: : uri/src/UriInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Uri Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Uri; /** * Uri Interface * * Interface for read-only access to URIs. * * @since 1.0 */ interface UriInterface { /** * Include the scheme (http, https, etc.) * * @var integer * @since 1.2.0 */ public const SCHEME = 1; /** * Include the user * * @var integer * @since 1.2.0 */ public const USER = 2; /** * Include the password * * @var integer * @since 1.2.0 */ public const PASS = 4; /** * Include the host * * @var integer * @since 1.2.0 */ public const HOST = 8; /** * Include the port * * @var integer * @since 1.2.0 */ public const PORT = 16; /** * Include the path * * @var integer * @since 1.2.0 */ public const PATH = 32; /** * Include the query string * * @var integer * @since 1.2.0 */ public const QUERY = 64; /** * Include the fragment * * @var integer * @since 1.2.0 */ public const FRAGMENT = 128; /** * Include all available url parts (scheme, user, pass, host, port, path, query, fragment) * * @var integer * @since 1.2.0 */ public const ALL = 255; /** * Magic method to get the string representation of the URI object. * * @return string * * @since 1.0 */ public function __toString(); /** * Returns full URI string. * * @param array $parts An array of strings specifying the parts to render. * * @return string The rendered URI string. * * @since 1.0 */ public function toString($parts = ['scheme', 'user', 'pass', 'host', 'port', 'path', 'query', 'fragment']); /** * Checks if variable exists. * * @param string $name Name of the query variable to check. * * @return boolean True if the variable exists. * * @since 1.0 */ public function hasVar($name); /** * Returns a query variable by name. * * @param string $name Name of the query variable to get. * @param string $default Default value to return if the variable is not set. * * @return mixed Requested query variable if present otherwise the default value. * * @since 1.0 */ public function getVar($name, $default = null); /** * Returns flat query string. * * @param boolean $toArray True to return the query as a key => value pair array. * * @return array|string Query string, optionally as an array. * * @since 1.0 */ public function getQuery($toArray = false); /** * Get the URI scheme (protocol) * * @return string The URI scheme. * * @since 1.0 */ public function getScheme(); /** * Get the URI username * * @return string The username, or null if no username was specified. * * @since 1.0 */ public function getUser(); /** * Get the URI password * * @return string The password, or null if no password was specified. * * @since 1.0 */ public function getPass(); /** * Get the URI host * * @return string The hostname/IP or null if no hostname/IP was specified. * * @since 1.0 */ public function getHost(); /** * Get the URI port * * @return integer The port number, or null if no port was specified. * * @since 1.0 */ public function getPort(); /** * Gets the URI path string * * @return string The URI path string. * * @since 1.0 */ public function getPath(); /** * Get the URI archor string * * @return string The URI anchor string. * * @since 1.0 */ public function getFragment(); /** * Checks whether the current URI is using HTTPS. * * @return boolean True if using SSL via HTTPS. * * @since 1.0 */ public function isSsl(); } PK c�\b銦. . uri/src/AbstractUri.phpnu �[��� <?php /** * Part of the Joomla Framework Uri Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Uri; /** * Base Joomla Uri Class * * @since 1.0 */ abstract class AbstractUri implements UriInterface { /** * Original URI * * @var string * @since 1.0 */ protected $uri; /** * Protocol * * @var string * @since 1.0 */ protected $scheme; /** * Host * * @var string * @since 1.0 */ protected $host; /** * Port * * @var integer * @since 1.0 */ protected $port; /** * Username * * @var string * @since 1.0 */ protected $user; /** * Password * * @var string * @since 1.0 */ protected $pass; /** * Path * * @var string * @since 1.0 */ protected $path; /** * Query * * @var string * @since 1.0 */ protected $query; /** * Anchor * * @var string * @since 1.0 */ protected $fragment; /** * Query variable hash * * @var array * @since 1.0 */ protected $vars = []; /** * Constructor. * * You can pass a URI string to the constructor to initialise a specific URI. * * @param string $uri The optional URI string * * @since 1.0 */ public function __construct($uri = null) { if ($uri !== null) { $this->parse($uri); } } /** * Magic method to get the string representation of the UriInterface object. * * @return string * * @since 1.0 */ public function __toString() { return $this->toString(); } /** * Returns full URI string. * * @param array $parts An array of strings specifying the parts to render. * * @return string The rendered URI string. * * @since 1.0 */ public function toString($parts = ['scheme', 'user', 'pass', 'host', 'port', 'path', 'query', 'fragment']) { $bitmask = 0; foreach ($parts as $part) { $const = 'static::' . strtoupper($part); if (\defined($const)) { $bitmask |= \constant($const); } } return $this->render($bitmask); } /** * Returns full uri string. * * @param integer $parts A bitmask specifying the parts to render. * * @return string The rendered URI string. * * @since 1.2.0 */ public function render($parts = self::ALL) { // Make sure the query is created $query = $this->getQuery(); $uri = ''; $uri .= $parts & static::SCHEME ? (!empty($this->scheme) ? $this->scheme . '://' : '') : ''; $uri .= $parts & static::USER ? $this->user : ''; $uri .= $parts & static::PASS ? (!empty($this->pass) ? ':' : '') . $this->pass . (!empty($this->user) ? '@' : '') : ''; $uri .= $parts & static::HOST ? $this->host : ''; $uri .= $parts & static::PORT ? (!empty($this->port) ? ':' : '') . $this->port : ''; $uri .= $parts & static::PATH ? $this->path : ''; $uri .= $parts & static::QUERY ? (!empty($query) ? '?' . $query : '') : ''; $uri .= $parts & static::FRAGMENT ? (!empty($this->fragment) ? '#' . $this->fragment : '') : ''; return $uri; } /** * Checks if variable exists. * * @param string $name Name of the query variable to check. * * @return boolean True if the variable exists. * * @since 1.0 */ public function hasVar($name) { return array_key_exists($name, $this->vars); } /** * Returns a query variable by name. * * @param string $name Name of the query variable to get. * @param string $default Default value to return if the variable is not set. * * @return mixed Requested query variable if present otherwise the default value. * * @since 1.0 */ public function getVar($name, $default = null) { if (array_key_exists($name, $this->vars)) { return $this->vars[$name]; } return $default; } /** * Returns flat query string. * * @param boolean $toArray True to return the query as a key => value pair array. * * @return string|array Query string or Array of parts in query string depending on the function param * * @since 1.0 */ public function getQuery($toArray = false) { if ($toArray) { return $this->vars; } // If the query is empty build it first if ($this->query === null) { $this->query = static::buildQuery($this->vars); } return $this->query; } /** * Get the URI scheme (protocol) * * @return string The URI scheme. * * @since 1.0 */ public function getScheme() { return $this->scheme; } /** * Get the URI username * * @return string The username, or null if no username was specified. * * @since 1.0 */ public function getUser() { return $this->user; } /** * Get the URI password * * @return string The password, or null if no password was specified. * * @since 1.0 */ public function getPass() { return $this->pass; } /** * Get the URI host * * @return string The hostname/IP or null if no hostname/IP was specified. * * @since 1.0 */ public function getHost() { return $this->host; } /** * Get the URI port * * @return integer The port number, or null if no port was specified. * * @since 1.0 */ public function getPort() { return $this->port; } /** * Gets the URI path string * * @return string The URI path string. * * @since 1.0 */ public function getPath() { return $this->path; } /** * Get the URI anchor string * * @return string The URI anchor string. * * @since 1.0 */ public function getFragment() { return $this->fragment; } /** * Checks whether the current URI is using HTTPS. * * @return boolean True if using SSL via HTTPS. * * @since 1.0 */ public function isSsl() { return strtolower($this->getScheme()) === 'https'; } /** * Build a query from an array (reverse of the PHP parse_str()). * * @param array $params The array of key => value pairs to return as a query string. * * @return string The resulting query string. * * @see parse_str() * @since 1.0 */ protected static function buildQuery(array $params) { return urldecode(http_build_query($params, '', '&')); } /** * Parse a given URI and populate the class fields. * * @param string $uri The URI string to parse. * * @return boolean True on success. * * @since 1.0 */ protected function parse($uri) { // Set the original URI to fall back on $this->uri = $uri; /* * Parse the URI and populate the object fields. If URI is parsed properly, * set method return value to true. */ $parts = UriHelper::parse_url($uri); if ($parts === false) { throw new \RuntimeException(sprintf('Could not parse the requested URI %s', $uri)); } $retval = ($parts) ? true : false; // We need to replace & with & for parse_str to work right... if (isset($parts['query']) && strpos($parts['query'], '&') !== false) { $parts['query'] = str_replace('&', '&', $parts['query']); } foreach ($parts as $key => $value) { $this->$key = $value; } // Parse the query if (isset($parts['query'])) { parse_str($parts['query'], $this->vars); } return $retval; } /** * Resolves //, ../ and ./ from a path and returns the result. * * For example: * /foo/bar/../boo.php => /foo/boo.php * /foo/bar/../../boo.php => /boo.php * /foo/bar/.././/boo.php => /foo/boo.php * * @param string $path The URI path to clean. * * @return string Cleaned and resolved URI path. * * @since 1.0 */ protected function cleanPath($path) { $path = explode('/', preg_replace('#(/+)#', '/', $path)); for ($i = 0, $n = \count($path); $i < $n; $i++) { if ($path[$i] == '.' || $path[$i] == '..') { if (($path[$i] == '.') || ($path[$i] == '..' && $i == 1 && $path[0] == '')) { unset($path[$i]); $path = array_values($path); $i--; $n--; } elseif ($path[$i] == '..' && ($i > 1 || ($i == 1 && $path[0] != ''))) { unset($path[$i], $path[$i - 1]); $path = array_values($path); $i -= 2; $n -= 2; } } } return implode('/', $path); } } PK c�\K�u�o o oauth2/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: 691e9c5085d48143bd6e6c1271c4bd44f95fd9ad6526c7a67e0647a3b2ccaffd ... PK c�\�P�E �E oauth2/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�0��& �& oauth2/src/Client.phpnu �[��� <?php /** * Part of the Joomla Framework OAuth2 Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\OAuth2; use Joomla\Application\WebApplicationInterface; use Joomla\Http\Exception\UnexpectedResponseException; use Joomla\Http\Http; use Joomla\Http\HttpFactory; use Joomla\Input\Input; use Joomla\Uri\Uri; /** * Joomla Framework class for interacting with an OAuth 2.0 server. * * @since 1.0 */ class Client { /** * Options for the Client object. * * @var array|\ArrayAccess * @since 1.0 */ protected $options; /** * The HTTP client object to use in sending HTTP requests. * * @var Http * @since 1.0 */ protected $http; /** * The input object to use in retrieving GET/POST data. * * @var Input * @since 1.0 */ protected $input; /** * The application object to send HTTP headers for redirects. * * @var WebApplicationInterface * @since 1.0 */ protected $application; /** * Constructor. * * @param array|\ArrayAccess $options OAuth2 Client options object * @param Http $http The HTTP client object * @param Input $input The input object * @param WebApplicationInterface $application The application object * * @since 1.0 */ public function __construct($options = [], Http $http = null, Input $input = null, WebApplicationInterface $application = null) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->options = $options; $this->http = $http ?: (new HttpFactory)->getHttp($this->options); $this->input = $input ?: ($application ? $application->getInput() : new Input); $this->application = $application; } /** * Get the access token or redirect to the authentication URL. * * @return array|boolean The access token or false on failure * * @since 1.0 * @throws UnexpectedResponseException * @throws \RuntimeException */ public function authenticate() { if ($data['code'] = $this->input->get('code', false, 'raw')) { $data = [ 'grant_type' => 'authorization_code', 'redirect_uri' => $this->getOption('redirecturi'), 'client_id' => $this->getOption('clientid'), 'client_secret' => $this->getOption('clientsecret'), ]; $response = $this->http->post($this->getOption('tokenurl'), $data); if (!($response->code >= 200 && $response->code < 400)) { throw new UnexpectedResponseException( $response, sprintf( 'Error code %s received requesting access token: %s.', $response->code, $response->body ) ); } if (strpos($response->headers['Content-Type'], 'application/json') !== false) { $token = array_merge(json_decode($response->body, true), ['created' => time()]); } else { parse_str($response->body, $token); $token = array_merge($token, ['created' => time()]); } $this->setToken($token); return $token; } if ($this->getOption('sendheaders')) { if (!($this->application instanceof WebApplicationInterface)) { throw new \RuntimeException( \sprintf('A "%s" implementation is required to process authentication.', WebApplicationInterface::class) ); } $this->application->redirect($this->createUrl()); } return false; } /** * Verify if the client has been authenticated * * @return boolean Is authenticated * * @since 1.0 */ public function isAuthenticated() { $token = $this->getToken(); if (!$token || !array_key_exists('access_token', $token)) { return false; } if (array_key_exists('expires_in', $token) && $token['created'] + $token['expires_in'] < time() + 20) { return false; } return true; } /** * Create the URL for authentication. * * @return string * * @since 1.0 * @throws \InvalidArgumentException */ public function createUrl() { if (!$this->getOption('authurl') || !$this->getOption('clientid')) { throw new \InvalidArgumentException('Authorization URL and client_id are required'); } $url = new Uri($this->getOption('authurl')); $url->setVar('response_type', 'code'); $url->setVar('client_id', urlencode($this->getOption('clientid'))); if ($redirect = $this->getOption('redirecturi')) { $url->setVar('redirect_uri', urlencode($redirect)); } if ($scope = $this->getOption('scope')) { $scope = \is_array($scope) ? implode(' ', $scope) : $scope; $url->setVar('scope', urlencode($scope)); } if ($state = $this->getOption('state')) { $url->setVar('state', urlencode($state)); } if (\is_array($this->getOption('requestparams'))) { foreach ($this->getOption('requestparams') as $key => $value) { $url->setVar($key, urlencode($value)); } } return (string) $url; } /** * Send a signed OAuth request. * * @param string $url The URL for the request * @param mixed $data Either an associative array or a string to be sent with the request * @param array $headers The headers to send with the request * @param string $method The method with which to send the request * @param integer $timeout The timeout for the request * * @return \Joomla\Http\Response * * @since 1.0 * @throws \InvalidArgumentException * @throws \RuntimeException */ public function query($url, $data = null, $headers = [], $method = 'get', $timeout = null) { $token = $this->getToken(); if (array_key_exists('expires_in', $token) && $token['created'] + $token['expires_in'] < time() + 20) { if (!$this->getOption('userefresh')) { return false; } $token = $this->refreshToken($token['refresh_token']); } $url = new Uri($url); if (!$this->getOption('authmethod') || $this->getOption('authmethod') == 'bearer') { $headers['Authorization'] = 'Bearer ' . $token['access_token']; } elseif ($this->getOption('authmethod') == 'get') { $url->setVar($this->getOption('getparam', 'access_token'), $token['access_token']); } switch ($method) { case 'head': case 'get': case 'delete': case 'trace': $response = $this->http->$method($url, $headers, $timeout); break; case 'post': case 'put': case 'patch': $response = $this->http->$method($url, $data, $headers, $timeout); break; default: throw new \InvalidArgumentException('Unknown HTTP request method: ' . $method . '.'); } if ($response->code < 200 || $response->code >= 400) { throw new UnexpectedResponseException( $response, sprintf( 'Error code %s received requesting data: %s.', $response->code, $response->body ) ); } return $response; } /** * Get an option from the OAuth2 Client instance. * * @param string $key The name of the option to get * @param mixed $default Optional default value, returned if the requested option does not exist. * * @return mixed The option value * * @since 1.0 */ public function getOption($key, $default = null) { return $this->options[$key] ?? $default; } /** * Set an option for the OAuth2 Client instance. * * @param string $key The name of the option to set * @param mixed $value The option value to set * * @return Client This object for method chaining * * @since 1.0 */ public function setOption($key, $value) { $this->options[$key] = $value; return $this; } /** * Get the access token from the Client instance. * * @return array The access token * * @since 1.0 */ public function getToken() { return $this->getOption('accesstoken'); } /** * Set an option for the Client instance. * * @param array $value The access token * * @return Client This object for method chaining * * @since 1.0 */ public function setToken($value) { if (\is_array($value) && !array_key_exists('expires_in', $value) && array_key_exists('expires', $value)) { $value['expires_in'] = $value['expires']; unset($value['expires']); } $this->setOption('accesstoken', $value); return $this; } /** * Refresh the access token instance. * * @param string $token The refresh token * * @return array The new access token * * @since 1.0 * @throws UnexpectedResponseException * @throws \RuntimeException */ public function refreshToken($token = null) { if (!$this->getOption('userefresh')) { throw new \RuntimeException('Refresh token is not supported for this OAuth instance.'); } if (!$token) { $token = $this->getToken(); if (!array_key_exists('refresh_token', $token)) { throw new \RuntimeException('No refresh token is available.'); } $token = $token['refresh_token']; } $data = [ 'grant_type' => 'refresh_token', 'refresh_token' => $token, 'client_id' => $this->getOption('clientid'), 'client_secret' => $this->getOption('clientsecret'), ]; $response = $this->http->post($this->getOption('tokenurl'), $data); if (!($response->code >= 200 || $response->code < 400)) { throw new UnexpectedResponseException( $response, sprintf( 'Error code %s received refreshing token: %s.', $response->code, $response->body ) ); } if (strpos($response->headers['Content-Type'], 'application/json') !== false) { $token = array_merge(json_decode($response->body, true), ['created' => time()]); } else { parse_str($response->body, $token); $token = array_merge($token, ['created' => time()]); } $this->setToken($token); return $token; } } PK c�\�+�m� � oauth2/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\���# # 6 authentication/src/AuthenticationStrategyInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication; /** * Joomla Framework AuthenticationStrategy Interface * * @since 1.0 */ interface AuthenticationStrategyInterface { /** * Attempt authentication. * * @return string|boolean A string containing a username if authentication is successful, false otherwise. * * @since 1.0 */ public function authenticate(); /** * Get last authentication result. * * @return integer An integer from Authentication class constants with the authentication result. * * @since 1.0 */ public function getResult(); } PK c�\��i� � D authentication/src/Exception/UnsupportedPasswordHandlerException.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication\Exception; /** * Exception class defining an unsupported password handler * * @since 2.0.0 */ class UnsupportedPasswordHandlerException extends \LogicException { } PK c�\�» | | E authentication/src/AbstractUsernamePasswordAuthenticationStrategy.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication; use Joomla\Authentication\Password\BCryptHandler; use Joomla\Authentication\Password\HandlerInterface; /** * Abstract AuthenticationStrategy for username/password based authentication * * @since 1.1.0 */ abstract class AbstractUsernamePasswordAuthenticationStrategy implements AuthenticationStrategyInterface { /** * The password handler to validate the password against. * * @var HandlerInterface * @since 1.2.0 */ protected $passwordHandler; /** * The last authentication status. * * @var integer * @since 1.1.0 */ protected $status; /** * Constructor. * * @param HandlerInterface $passwordHandler The password handler. * * @since 1.2.0 */ public function __construct(?HandlerInterface $passwordHandler = null) { $this->passwordHandler = $passwordHandler ?: new BCryptHandler; } /** * Attempt to authenticate the username and password pair. * * @param string $username The username to authenticate. * @param string $password The password to attempt authentication with. * * @return string|boolean A string containing a username if authentication is successful, false otherwise. * * @since 1.1.0 */ protected function doAuthenticate($username, $password) { $hashedPassword = $this->getHashedPassword($username); if ($hashedPassword === false) { $this->status = Authentication::NO_SUCH_USER; return false; } if (!$this->verifyPassword($username, $password, $hashedPassword)) { $this->status = Authentication::INVALID_CREDENTIALS; return false; } $this->status = Authentication::SUCCESS; return $username; } /** * Retrieve the hashed password for the specified user. * * @param string $username Username to lookup. * * @return string|boolean Hashed password on success or boolean false on failure. * * @since 1.1.0 */ abstract protected function getHashedPassword($username); /** * Get the status of the last authentication attempt. * * @return integer Authentication class constant result. * * @since 1.1.0 */ public function getResult() { return $this->status; } /** * Attempt to verify the username and password pair. * * @param string $username The username to authenticate. * @param string $password The password to attempt authentication with. * @param string $hashedPassword The hashed password to attempt authentication against. * * @return boolean * * @since 1.1.0 */ protected function verifyPassword($username, $password, $hashedPassword) { return $this->passwordHandler->validatePassword($password, $hashedPassword); } } PK c�\���� � / authentication/src/Strategies/LocalStrategy.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication\Strategies; use Joomla\Authentication\AbstractUsernamePasswordAuthenticationStrategy; use Joomla\Authentication\Authentication; use Joomla\Authentication\Password\HandlerInterface; use Joomla\Input\Input; /** * Joomla Framework Local Strategy Authentication class * * @since 1.0 */ class LocalStrategy extends AbstractUsernamePasswordAuthenticationStrategy { /** * The credential store. * * @var array * @since 1.0 */ private $credentialStore; /** * The Input object * * @var Input * @since 1.0 */ private $input; /** * Strategy Constructor * * @param Input $input The input object from which to retrieve the request credentials. * @param array $credentialStore Hash of username and hash pairs. * @param HandlerInterface $passwordHandler The password handler. * * @since 1.0 */ public function __construct(Input $input, array $credentialStore = [], ?HandlerInterface $passwordHandler = null) { parent::__construct($passwordHandler); $this->credentialStore = $credentialStore; $this->input = $input; } /** * Attempt to authenticate the username and password pair. * * @return string|boolean A string containing a username if authentication is successful, false otherwise. * * @since 1.0 */ public function authenticate() { $username = $this->input->get('username', false, 'username'); $password = $this->input->get('password', false, 'raw'); if (!$username || !$password) { $this->status = Authentication::NO_CREDENTIALS; return false; } return $this->doAuthenticate($username, $password); } /** * Retrieve the hashed password for the specified user. * * @param string $username Username to lookup. * * @return string|boolean Hashed password on success or boolean false on failure. * * @since 1.1.0 */ protected function getHashedPassword($username) { return $this->credentialStore[$username] ?? false; } } PK c�\�� � 2 authentication/src/Strategies/DatabaseStrategy.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication\Strategies; use Joomla\Authentication\AbstractUsernamePasswordAuthenticationStrategy; use Joomla\Authentication\Authentication; use Joomla\Authentication\Password\HandlerInterface; use Joomla\Database\DatabaseInterface; use Joomla\Input\Input; /** * Joomla Framework Database Strategy Authentication class * * @since 1.1.0 */ class DatabaseStrategy extends AbstractUsernamePasswordAuthenticationStrategy { /** * DatabaseInterface object * * @var DatabaseInterface * @since 1.1.0 */ private $db; /** * Database connection options * * @var array * @since 1.1.0 */ private $dbOptions; /** * The Input object * * @var Input * @since 1.1.0 */ private $input; /** * Strategy Constructor * * @param Input $input The input object from which to retrieve the request credentials. * @param DatabaseInterface $database DatabaseDriver for retrieving user credentials. * @param array $options Optional options array for configuring the credential storage connection. * @param HandlerInterface $passwordHandler The password handler. * * @since 1.1.0 */ public function __construct(Input $input, DatabaseInterface $database, array $options = [], ?HandlerInterface $passwordHandler = null) { parent::__construct($passwordHandler); $this->input = $input; $this->db = $database; $options['database_table'] = $options['database_table'] ?? '#__users'; $options['username_column'] = $options['username_column'] ?? 'username'; $options['password_column'] = $options['password_column'] ?? 'password'; $this->dbOptions = $options; } /** * Attempt to authenticate the username and password pair. * * @return string|boolean A string containing a username if authentication is successful, false otherwise. * * @since 1.1.0 */ public function authenticate() { $username = $this->input->get('username', false, 'username'); $password = $this->input->get('password', false, 'raw'); if (!$username || !$password) { $this->status = Authentication::NO_CREDENTIALS; return false; } return $this->doAuthenticate($username, $password); } /** * Retrieve the hashed password for the specified user. * * @param string $username Username to lookup. * * @return string|boolean Hashed password on success or boolean false on failure. * * @since 1.1.0 */ protected function getHashedPassword($username) { try { $password = $this->db->setQuery( $this->db->getQuery(true) ->select($this->db->quoteName($this->dbOptions['password_column'])) ->from($this->db->quoteName($this->dbOptions['database_table'])) ->where($this->db->quoteName($this->dbOptions['username_column']) . ' = ?') ->bind(1, $username) )->loadResult(); } catch (\RuntimeException $exception) { return false; } if (!$password) { return false; } return $password; } } PK c�\롭 % authentication/src/Authentication.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication; /** * Joomla Framework Authentication Class * * @since 1.0 */ class Authentication { /** * Authentication was successful. * * @since 1.0 */ public const SUCCESS = 1; /** * Credentials were provided but they were invalid. * * @since 1.0 */ public const INVALID_CREDENTIALS = 2; /** * Credentials were provided but the user did not exist in the credential store. * * @since 1.0 */ public const NO_SUCH_USER = 3; /** * There were no credentials found. * * @since 1.0 */ public const NO_CREDENTIALS = 4; /** * There were partial credentials found but they were not complete. * * @since 1.0 */ public const INCOMPLETE_CREDENTIALS = 5; /** * The array of strategies. * * @var AuthenticationStrategyInterface[] * @since 1.0 */ private $strategies = []; /** * The array of results. * * @var integer[] * @since 1.0 */ private $results = []; /** * Register a new strategy * * @param string $strategyName The name to use for the strategy. * @param AuthenticationStrategyInterface $strategy The authentication strategy object to add. * * @return void * * @since 1.0 */ public function addStrategy($strategyName, AuthenticationStrategyInterface $strategy) { $this->strategies[$strategyName] = $strategy; } /** * Perform authentication * * @param string[] $strategies Array of strategies to try - empty to try all strategies. * * @return string|boolean A string containing a username if authentication is successful, false otherwise. * * @since 1.0 * @throws \RuntimeException */ public function authenticate(array $strategies = []) { if (empty($strategies)) { $strategyObjects = $this->strategies; } else { $strategyObjects = []; foreach ($strategies as $strategy) { if (!isset($this->strategies[$strategy])) { throw new \RuntimeException('Authentication Strategy Not Found'); } $strategyObjects[$strategy] = $this->strategies[$strategy]; } } if (empty($strategyObjects)) { throw new \RuntimeException('No strategies have been set'); } /** @var AuthenticationStrategyInterface $strategyObject */ foreach ($strategyObjects as $strategy => $strategyObject) { $username = $strategyObject->authenticate(); $this->results[$strategy] = $strategyObject->getResult(); if (\is_string($username)) { return $username; } } return false; } /** * Get authentication results. * * Use this if you want to get more detailed information about the results of an authentication attempts. * * @return integer[] An array containing authentication results. * * @since 1.0 */ public function getResults() { return $this->results; } } PK c�\d�u~� � - authentication/src/Password/BCryptHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication\Password; /** * Password handler for BCrypt hashed passwords * * @since 1.2.0 */ class BCryptHandler implements HandlerInterface { /** * Generate a hash for a plaintext password * * @param string $plaintext The plaintext password to validate * @param array $options Options for the hashing operation * * @return string * * @since 1.2.0 */ public function hashPassword($plaintext, array $options = []) { return password_hash($plaintext, \PASSWORD_BCRYPT, $options); } /** * Check that the password handler is supported in this environment * * @return boolean * * @since 1.2.0 */ public static function isSupported() { // Check the password_verify() function exists, either as part of PHP core or through a polyfill return \function_exists('password_verify'); } /** * Validate a password * * @param string $plaintext The plain text password to validate * @param string $hashed The password hash to validate against * * @return boolean * * @since 1.2.0 */ public function validatePassword($plaintext, $hashed) { return password_verify($plaintext, $hashed); } } PK c�\:5�m m 0 authentication/src/Password/HandlerInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication\Password; /** * Interface defining a password handler * * @since 1.2.0 */ interface HandlerInterface { /** * Generate a hash for a plaintext password * * @param string $plaintext The plaintext password to validate * @param array $options Options for the hashing operation * * @return string * * @since 1.2.0 */ public function hashPassword($plaintext, array $options = []); /** * Check that the password handler is supported in this environment * * @return boolean * * @since 1.2.0 */ public static function isSupported(); /** * Validate a password * * @param string $plaintext The plain text password to validate * @param string $hashed The password hash to validate against * * @return boolean * * @since 1.2.0 */ public function validatePassword($plaintext, $hashed); } PK c�\��Q� � / authentication/src/Password/Argon2idHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication\Password; use Joomla\Authentication\Exception\UnsupportedPasswordHandlerException; /** * Password handler for Argon2id hashed passwords * * @since 1.3.0 */ class Argon2idHandler implements HandlerInterface { /** * Generate a hash for a plaintext password * * @param string $plaintext The plaintext password to validate * @param array $options Options for the hashing operation * * @return string * * @since 1.3.0 * @throws UnsupportedPasswordHandlerException if the password handler is not supported */ public function hashPassword($plaintext, array $options = []) { // Use the password extension if able if (version_compare(\PHP_VERSION, '7.3', '>=') && \defined('PASSWORD_ARGON2ID')) { return password_hash($plaintext, \PASSWORD_ARGON2ID, $options); } throw new UnsupportedPasswordHandlerException('Argon2id algorithm is not supported.'); } /** * Check that the password handler is supported in this environment * * @return boolean * * @since 1.3.0 */ public static function isSupported() { // Check for native PHP engine support in the password extension if (version_compare(\PHP_VERSION, '7.3', '>=') && \defined('PASSWORD_ARGON2ID')) { return true; } return false; } /** * Validate a password * * @param string $plaintext The plain text password to validate * @param string $hashed The password hash to validate against * * @return boolean * * @since 1.3.0 * @throws UnsupportedPasswordHandlerException if the password handler is not supported */ public function validatePassword($plaintext, $hashed) { // Use the password extension if able if (version_compare(\PHP_VERSION, '7.3', '>=') && \defined('PASSWORD_ARGON2ID')) { return password_verify($plaintext, $hashed); } throw new UnsupportedPasswordHandlerException('Argon2id algorithm is not supported.'); } } PK c�\ԴmI� � . authentication/src/Password/Argon2iHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Authentication Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Authentication\Password; use Joomla\Authentication\Exception\UnsupportedPasswordHandlerException; /** * Password handler for Argon2i hashed passwords * * @since 1.2.0 */ class Argon2iHandler implements HandlerInterface { /** * Generate a hash for a plaintext password * * @param string $plaintext The plaintext password to validate * @param array $options Options for the hashing operation * * @return string * * @since 1.2.0 * @throws UnsupportedPasswordHandlerException if the password handler is not supported */ public function hashPassword($plaintext, array $options = []) { // Use the password extension if able if (\defined('PASSWORD_ARGON2I')) { return password_hash($plaintext, \PASSWORD_ARGON2I, $options); } // Use the sodium extension (PHP 7.2 native or PECL 2.x) if able if (\function_exists('sodium_crypto_pwhash_str_verify')) { $hash = sodium_crypto_pwhash_str( $plaintext, \SODIUM_CRYPTO_PWHASH_OPSLIMIT_INTERACTIVE, \SODIUM_CRYPTO_PWHASH_MEMLIMIT_INTERACTIVE ); sodium_memzero($plaintext); return $hash; } // Use the libsodium extension (PECL 1.x) if able if (\extension_loaded('libsodium')) { $hash = \Sodium\crypto_pwhash_str( $plaintext, \Sodium\CRYPTO_PWHASH_OPSLIMIT_INTERACTIVE, \Sodium\CRYPTO_PWHASH_MEMLIMIT_INTERACTIVE ); \Sodium\memzero($plaintext); return $hash; } throw new UnsupportedPasswordHandlerException('Argon2i algorithm is not supported.'); } /** * Check that the password handler is supported in this environment * * @return boolean * * @since 1.2.0 */ public static function isSupported() { // Check for native PHP engine support in the password extension if (\defined('PASSWORD_ARGON2I')) { return true; } // Check if the sodium_compat polyfill is installed and look for compatibility through that if (class_exists('\\ParagonIE_Sodium_Compat') && method_exists('\\ParagonIE_Sodium_Compat', 'crypto_pwhash_is_available')) { return \ParagonIE_Sodium_Compat::crypto_pwhash_is_available(); } // Check for support from the (lib)sodium extension return \function_exists('sodium_crypto_pwhash_str') || \extension_loaded('libsodium'); } /** * Validate a password * * @param string $plaintext The plain text password to validate * @param string $hashed The password hash to validate against * * @return boolean * * @since 1.2.0 * @throws UnsupportedPasswordHandlerException if the password handler is not supported */ public function validatePassword($plaintext, $hashed) { // Use the password extension if able if (\defined('PASSWORD_ARGON2I')) { return password_verify($plaintext, $hashed); } // Use the sodium extension (PHP 7.2 native or PECL 2.x) if able if (\function_exists('sodium_crypto_pwhash_str_verify')) { $valid = sodium_crypto_pwhash_str_verify($hashed, $plaintext); sodium_memzero($plaintext); return $valid; } // Use the libsodium extension (PECL 1.x) if able if (\extension_loaded('libsodium')) { $valid = \Sodium\crypto_pwhash_str_verify($hashed, $plaintext); \Sodium\memzero($plaintext); return $valid; } throw new UnsupportedPasswordHandlerException('Argon2i algorithm is not supported.'); } } PK c�\(��&;g ;g authentication/LICENSEnu �[��� GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999 Copyright (C) 1991, 1999 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.] Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This license, the Lesser General Public License, applies to some specially designated software packages--typically libraries--of the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the explanations below. When we speak of free software, we are referring to freedom of use, 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 this service if you wish); that you receive source code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are informed that you can do these things. To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it. For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must provide complete object files to the recipients, so that they can relink them with the library after making changes to the library and recompiling it. And you must show them these terms so they know their rights. We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library. To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the original author's reputation will not be affected by problems that might be introduced by others. Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license. Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU Lesser General Public License, applies to certain designated libraries, and is quite different from the ordinary General Public License. We use this license for certain libraries in order to permit linking those libraries into non-free programs. When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library. We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license provides advantages in certain special circumstances. For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it becomes a de-facto standard. To achieve this, non-free programs must be allowed to use the library. A more frequent case is that a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License. In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the whole GNU operating system, as well as its variant, the GNU/Linux operating system. Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library. The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run. GNU LESSER GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this License"). Each licensee is addressed as "you". A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".) "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library. Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does. 1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) The modified work must itself be a software library. b) You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change. c) You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License. d) If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful. (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library. In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices. Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy. This option is useful when you wish to copy part of the code of the Library into a program that is not a library. 4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange. If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code. 5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License. However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables. When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law. If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.) Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. 6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things: a) Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.) b) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time a copy of the library already present on the user's computer system, rather than copying library functions into the executable, and (2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is interface-compatible with the version that the work was made with. c) Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution. d) If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place. e) Verify that the user has already received a copy of these materials or that you have already sent this user a copy. For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute. 7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above. b) Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it. 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties with this License. 11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 13. The Free Software Foundation may publish revised and/or new versions of the Lesser 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 Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation. 14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "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 LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY 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 LIBRARY (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 LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Libraries If you develop a new library, and you want it to be of the greatest possible use to the public, we recommend making it free software that everyone can redistribute and change. You can do so by permitting redistribution under these terms (or, alternatively, under the terms of the ordinary General Public License). To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the library's name and a brief idea of what it does.> Copyright (C) <year> <name of author> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Also add information on how to contact you by electronic and paper mail. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the library `Frob' (a library for tweaking knobs) written by James Random Hacker. <signature of Ty Coon>, 1 April 1990 Ty Coon, President of Vice That's all there is to it! PK c�\��.F� � database/phpunit.mysqli.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="mysqli" /> <env name="JOOMLA_TEST_DB_HOST" value="mysqli" /> <env name="JOOMLA_TEST_DB_PORT" value="3306" /> <env name="JOOMLA_TEST_DB_USER" value="root" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests/Mysqli</directory> </testsuite> </testsuites> </phpunit> PK c�\�P�E �E database/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\u5D � � database/phpunit.sqlsrv.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="sqlsrv" /> <env name="JOOMLA_TEST_DB_HOST" value="sqlsrv" /> <env name="JOOMLA_TEST_DB_PORT" value="1433" /> <env name="JOOMLA_TEST_DB_USER" value="sa" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="JoomlaFramework123" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests/Sqlsrv</directory> </testsuite> </testsuites> </phpunit> PK c�\ ��O� � * database/phpunit.appveyor_sql2014.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="sqlsrv" /> <env name="JOOMLA_TEST_DB_HOST" value="(local)\SQL2014" /> <env name="JOOMLA_TEST_DB_PORT" value="" /> <env name="JOOMLA_TEST_DB_USER" value="sa" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="Password12!" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests</directory> </testsuite> </testsuites> </phpunit> PK c�\��zX� � database/phpunit.pgsql.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="pgsql" /> <env name="JOOMLA_TEST_DB_HOST" value="pgsql" /> <env name="JOOMLA_TEST_DB_PORT" value="5433" /> <env name="JOOMLA_TEST_DB_USER" value="postgres" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="JOOMLA_TEST_DB_SELECT" value="yes" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests/Pgsql</directory> </testsuite> </testsuites> </phpunit> PK c�\��Ք� � ! database/phpunit.mariadb.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="mysqli" /> <env name="JOOMLA_TEST_DB_HOST" value="mariadb" /> <env name="JOOMLA_TEST_DB_PORT" value="3306" /> <env name="JOOMLA_TEST_DB_USER" value="root" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests/Mysqli</directory> </testsuite> </testsuites> </phpunit> PK c�\1P{��0 �0 database/.drone.jsonnetnu &1i� local volumes = [ { name: 'composer-cache', path: '/tmp/composer-cache', }, ]; local hostvolumes = [ { name: 'composer-cache', host: { path: '/tmp/composer-cache' }, }, ]; local composer(phpversion, params) = { name: 'Composer', image: 'joomlaprojects/docker-images:php' + phpversion, volumes: volumes, commands: [ 'php -v', 'sleep 20', 'composer update ' + params, ], }; local phpunit_common(phpversion) = { name: 'PHPUnit', image: 'joomlaprojects/docker-images:php' + phpversion, [if phpversion == '8.2' then 'failure']: 'ignore', commands: [ 'vendor/bin/phpunit --configuration phpunit.xml.dist --testdox', ], }; local phpunit_mysql(phpversion, driver) = { name: 'PHPUnit', image: 'joomlaprojects/docker-images:php' + phpversion, [if phpversion == '8.2' then 'failure']: 'ignore', commands: [ 'php --ri ' + driver + ' || true', 'sleep 20', 'vendor/bin/phpunit --configuration phpunit.' + driver + '.xml.dist --testdox', ], }; local phpunit(phpversion, driver) = { name: 'PHPUnit', image: 'joomlaprojects/docker-images:php' + phpversion, [if phpversion == '8.2' then 'failure']: 'ignore', commands: [ 'php --ri ' + driver + ' || true', 'vendor/bin/phpunit --configuration phpunit.' + driver + '.xml.dist --testdox', ], }; local phpunit_sqlsrv(phpversion) = { name: 'PHPUnit with MS SQL Server', image: 'joomlaprojects/docker-images:php' + phpversion, commands: [ 'apt-get update', 'apt-get install -y software-properties-common lsb-release gnupg', 'curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -', 'echo "deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/debian/11/prod bullseye main" >> /etc/apt/sources.list', 'apt-get update', 'ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev', 'pecl install sqlsrv && docker-php-ext-enable sqlsrv', 'pecl install pdo_sqlsrv && docker-php-ext-enable pdo_sqlsrv', 'php --ri sqlsrv', 'php --ri pdo_sqlsrv', 'vendor/bin/phpunit --configuration phpunit.sqlsrv.xml.dist --testdox', ], }; local pipeline_sqlite(phpversion, driver, params) = { kind: 'pipeline', name: 'PHP ' + phpversion + ' with SQLite (' + driver + ')', environment: { DB: driver }, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion, driver), ], }; local pipeline_mysql(phpversion, driver, dbversion, params) = { kind: 'pipeline', name: 'PHP ' + phpversion + ' with MySQL ' + dbversion + ' (' + driver + ')', environment: { DB: driver }, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit_mysql(phpversion, driver), ], services: [ { name: driver, image: 'bitnami/mysql:' + dbversion, environment: { ALLOW_EMPTY_PASSWORD: 'yes', MYSQL_DATABASE: 'joomla_ut', MYSQL_ROOT_PASSWORD: '', MYSQL_AUTHENTICATION_PLUGIN: 'mysql_native_password', }, ports: [ { container: 3306, host: 3306, }, ], }, ], }; local pipeline_mariadb(phpversion, driver, dbversion, params) = { kind: 'pipeline', name: 'PHP ' + phpversion + ' with MariaDB ' + dbversion + ' (' + driver + ')', environment: { DB: driver }, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion, driver), ], services: [ { name: driver, image: 'mariadb:' + dbversion, environment: { MARIADB_ALLOW_EMPTY_ROOT_PASSWORD: 'yes', MARIADB_DATABASE: 'joomla_ut', MARIADB_ROOT_PASSWORD: '', # Provide MySQL environments variables for MariaDB < 10.2. MYSQL_ALLOW_EMPTY_PASSWORD: 'yes', MYSQL_DATABASE: 'joomla_ut', MYSQL_ROOT_PASSWORD: '', }, ports: [ { container: 3306, host: 3306, }, ], }, ], }; local pipeline_postgres(phpversion, driver, dbversion, params) = { kind: 'pipeline', name: 'PHP ' + phpversion + ' with PostgreSQL ' + dbversion + ' (' + driver + ')', environment: { DB: driver }, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion, driver), ], services: [ { name: driver, image: 'postgres:' + dbversion, environment: { POSTGRES_HOST_AUTH_METHOD: 'trust', POSTGRES_PASSWORD: '', POSTGRES_USER: 'postgres', }, ports: [ { container: 5432, host: 5432, }, ], commands: [ 'psql -U postgres -c ', 'psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql', ], }, ], }; local pipeline_sqlsrv(phpversion, driver, dbversion, params) = { kind: 'pipeline', name: 'PHP ' + phpversion + ' with MS SQL Server ' + dbversion + ' (' + driver + ')', environment: { DB: driver }, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit_sqlsrv(phpversion), ], services: [ { name: driver, image: 'mcr.microsoft.com/mssql/server:' + dbversion, environment: { ACCEPT_EULA: 'Y', SA_PASSWORD: 'JoomlaFramework123', }, ports: [ { container: 1433, host: 1433, }, ], }, ], }; [ { kind: 'pipeline', name: 'Codequality', volumes: hostvolumes, steps: [ { name: 'composer', image: 'joomlaprojects/docker-images:php7.4', volumes: volumes, commands: [ 'php -v', 'composer update', 'composer require phpmd/phpmd phpstan/phpstan', ], }, { name: 'phpcs', image: 'joomlaprojects/docker-images:php7.4', depends: [ 'composer' ], commands: [ 'vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards', 'vendor/bin/phpcs --standard=ruleset.xml src/', ], }, { name: 'phpmd', image: 'joomlaprojects/docker-images:php7.4', depends: [ 'composer' ], failure: 'ignore', commands: [ 'vendor/bin/phpmd src text cleancode', 'vendor/bin/phpmd src text codesize', 'vendor/bin/phpmd src text controversial', 'vendor/bin/phpmd src text design', 'vendor/bin/phpmd src text unusedcode', ], }, { name: 'phpstan', image: 'joomlaprojects/docker-images:php7.4', depends: [ 'composer' ], failure: 'ignore', commands: [ 'vendor/bin/phpstan analyse src', ], }, { name: 'phploc', image: 'joomlaprojects/docker-images:php7.4', depends: [ 'composer' ], failure: 'ignore', commands: [ 'phploc src', ], }, { name: 'phpcpd', image: 'joomlaprojects/docker-images:php7.4', depends: [ 'composer' ], failure: 'ignore', commands: [ 'phpcpd src', ], }, ], }, pipeline_sqlite('7.2', 'sqlite', '--prefer-stable --prefer-lowest'), pipeline_sqlite('7.3', 'sqlite', '--prefer-stable'), pipeline_sqlite('7.4', 'sqlite', '--prefer-stable'), pipeline_sqlite('8.0', 'sqlite', '--prefer-stable --ignore-platform-reqs'), pipeline_sqlite('8.1', 'sqlite', '--prefer-stable --ignore-platform-reqs'), pipeline_sqlite('8.2', 'sqlite', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('7.2', 'mysql', '5.7', '--prefer-stable --prefer-lowest'), pipeline_mysql('7.3', 'mysql', '5.7', '--prefer-stable'), pipeline_mysql('7.4', 'mysql', '5.7', '--prefer-stable'), pipeline_mysql('8.0', 'mysql', '5.7', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.1', 'mysql', '5.7', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.2', 'mysql', '5.7', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('7.3', 'mysql', '8.0', '--prefer-stable'), pipeline_mysql('7.4', 'mysql', '8.0', '--prefer-stable'), pipeline_mysql('8.0', 'mysql', '8.0', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.1', 'mysql', '8.0', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.2', 'mysql', '8.0', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('7.2', 'mysqli', '5.7', '--prefer-stable --prefer-lowest'), pipeline_mysql('7.3', 'mysqli', '5.7', '--prefer-stable'), pipeline_mysql('7.4', 'mysqli', '5.7', '--prefer-stable'), pipeline_mysql('8.0', 'mysqli', '5.7', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.1', 'mysqli', '5.7', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.2', 'mysqli', '5.7', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('7.3', 'mysqli', '8.0', '--prefer-stable'), pipeline_mysql('7.4', 'mysqli', '8.0', '--prefer-stable'), pipeline_mysql('8.0', 'mysqli', '8.0', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.1', 'mysqli', '8.0', '--prefer-stable --ignore-platform-reqs'), pipeline_mysql('8.2', 'mysqli', '8.0', '--prefer-stable --ignore-platform-reqs'), pipeline_mariadb('7.2', 'mariadb', '10.2', '--prefer-stable --prefer-lowest'), pipeline_mariadb('7.3', 'mariadb', '10.2', '--prefer-stable'), pipeline_mariadb('7.4', 'mariadb', '10.0', '--prefer-stable'), pipeline_mariadb('7.4', 'mariadb', '10.1', '--prefer-stable'), pipeline_mariadb('7.4', 'mariadb', '10.2', '--prefer-stable'), pipeline_mariadb('8.0', 'mariadb', '10.2', '--prefer-stable --ignore-platform-reqs'), pipeline_mariadb('8.1', 'mariadb', '10.2', '--prefer-stable --ignore-platform-reqs'), pipeline_mariadb('8.2', 'mariadb', '10.2', '--prefer-stable --ignore-platform-reqs'), pipeline_postgres('7.2', 'pgsql', '9.4', '--prefer-stable --prefer-lowest'), pipeline_postgres('7.2', 'pgsql', '9.5', '--prefer-stable --prefer-lowest'), pipeline_postgres('7.3', 'pgsql', '9.6', '--prefer-stable'), pipeline_postgres('7.3', 'pgsql', '10', '--prefer-stable'), pipeline_postgres('7.4', 'pgsql', '10', '--prefer-stable'), pipeline_postgres('8.0', 'pgsql', '10', '--prefer-stable --ignore-platform-reqs'), pipeline_postgres('8.1', 'pgsql', '10', '--prefer-stable --ignore-platform-reqs'), pipeline_postgres('8.2', 'pgsql', '10', '--prefer-stable --ignore-platform-reqs'), pipeline_postgres('7.3', 'pgsql', '11', '--prefer-stable'), pipeline_postgres('7.4', 'pgsql', '11', '--prefer-stable'), pipeline_postgres('8.0', 'pgsql', '11', '--prefer-stable --ignore-platform-reqs'), pipeline_postgres('8.1', 'pgsql', '11', '--prefer-stable --ignore-platform-reqs'), pipeline_postgres('8.2', 'pgsql', '11', '--prefer-stable --ignore-platform-reqs'), pipeline_sqlsrv('7.3', 'sqlsrv', '2017-latest', '--prefer-stable'), pipeline_sqlsrv('7.4', 'sqlsrv', '2017-latest', '--prefer-stable'), pipeline_sqlsrv('8.0', 'sqlsrv', '2017-latest', '--prefer-stable --ignore-platform-reqs'), pipeline_sqlsrv('8.1', 'sqlsrv', '2017-latest', '--prefer-stable --ignore-platform-reqs'), pipeline_sqlsrv('8.2', 'sqlsrv', '2017-latest', '--prefer-stable --ignore-platform-reqs'), ] PK c�\z� �3 3 ' database/src/Monitor/ChainedMonitor.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Monitor; use Joomla\Database\QueryMonitorInterface; /** * Chained query monitor allowing multiple monitors to be executed. * * @since 2.0.0 */ class ChainedMonitor implements QueryMonitorInterface { /** * The query monitors stored to this chain * * @var QueryMonitorInterface[] * @since 2.0.0 */ private $monitors = []; /** * Register a monitor to the chain. * * @param QueryMonitorInterface $monitor The monitor to add. * * @return void * * @since 2.0.0 */ public function addMonitor(QueryMonitorInterface $monitor): void { $this->monitors[] = $monitor; } /** * Act on a query being started. * * @param string $sql The SQL to be executed. * @param object[]|null $boundParams List of bound params, used with the query. * Each item is an object that holds: value, dataType * * @return void * * @since 2.0.0 */ public function startQuery(string $sql, ?array $boundParams = null): void { foreach ($this->monitors as $monitor) { $monitor->startQuery($sql, $boundParams); } } /** * Act on a query being stopped. * * @return void * * @since 2.0.0 */ public function stopQuery(): void { foreach ($this->monitors as $monitor) { $monitor->stopQuery(); } } } PK c�\��Կ � % database/src/Monitor/DebugMonitor.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Monitor; use Joomla\Database\QueryMonitorInterface; /** * Query monitor handling logging of queries. * * @since 2.0.0 */ final class DebugMonitor implements QueryMonitorInterface { /** * The log of executed SQL statements call stacks by the database driver. * * @var array * @since 2.0.0 */ private $callStacks = []; /** * The log of executed SQL statements by the database driver. * * @var array * @since 2.0.0 */ private $logs = []; /** * List of bound params, used with the query. * * @var array * @since 2.0.0 */ private $boundParams = []; /** * The log of executed SQL statements memory usage (start and stop memory_get_usage) by the database driver. * * @var array * @since 2.0.0 */ private $memoryLogs = []; /** * The log of executed SQL statements timings (start and stop microtimes) by the database driver. * * @var array * @since 2.0.0 */ private $timings = []; /** * Act on a query being started. * * @param string $sql The SQL to be executed. * @param object[]|null $boundParams List of bound params, used with the query. * Each item is an object that holds: value, dataType * * @return void * * @since 2.0.0 */ public function startQuery(string $sql, ?array $boundParams = null): void { $this->logs[] = $sql; // Dereference bound parameters to prevent reporting wrong value when reusing the same query object. $this->boundParams[] = unserialize(serialize($boundParams)); $this->callStacks[] = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS); $this->memoryLogs[] = memory_get_usage(); $this->timings[] = microtime(true); } /** * Act on a query being stopped. * * @return void * * @since 2.0.0 */ public function stopQuery(): void { $this->timings[] = microtime(true); $this->memoryLogs[] = memory_get_usage(); } /** * Get the logged call stacks. * * @return array * * @since 2.0.0 */ public function getCallStacks(): array { return $this->callStacks; } /** * Get the logged queries. * * @return array * * @since 2.0.0 */ public function getLogs(): array { return $this->logs; } /** * Get the logged bound params. * * @return array * * @since 2.0.0 */ public function getBoundParams(): array { return $this->boundParams; } /** * Get the logged memory logs. * * @return array * * @since 2.0.0 */ public function getMemoryLogs(): array { return $this->memoryLogs; } /** * Get the logged timings. * * @return array * * @since 2.0.0 */ public function getTimings(): array { return $this->timings; } } PK c�\1�)� ' database/src/Monitor/LoggingMonitor.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Monitor; use Joomla\Database\QueryMonitorInterface; use Psr\Log\LoggerAwareInterface; use Psr\Log\LoggerAwareTrait; /** * Query monitor handling logging of queries. * * @since 2.0.0 */ class LoggingMonitor implements QueryMonitorInterface, LoggerAwareInterface { use LoggerAwareTrait; /** * Act on a query being started. * * @param string $sql The SQL to be executed. * @param object[]|null $boundParams List of bound params, used with the query. * Each item is an object that holds: value, dataType * @return void * * @since 2.0.0 */ public function startQuery(string $sql, ?array $boundParams = null): void { if ($this->logger) { // Add the query to the object queue. $this->logger->info( 'Query Executed: {sql}', ['sql' => $sql, 'trace' => debug_backtrace()] ); } } /** * Act on a query being stopped. * * @return void * * @since 2.0.0 */ public function stopQuery(): void { // Nothing to do } } PK c�\��3E E & database/src/Event/ConnectionEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Event; use Joomla\Database\DatabaseInterface; use Joomla\Event\Event; /** * Database connection event * * @since 2.0.0 */ class ConnectionEvent extends Event { /** * DatabaseInterface object for this event * * @var DatabaseInterface * @since 2.0.0 */ private $driver; /** * Constructor. * * @param string $name The event name. * @param DatabaseInterface $driver The DatabaseInterface object for this event. * * @since 2.0.0 */ public function __construct(string $name, DatabaseInterface $driver) { parent::__construct($name); $this->driver = $driver; } /** * Retrieve the DatabaseInterface object attached to this event. * * @return DatabaseInterface * * @since 2.0.0 */ public function getDriver(): DatabaseInterface { return $this->driver; } } PK c�\��kT� � ( database/src/UTF8MB4SupportInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Interface defining a driver which has support for the MySQL `utf8mb4` character set * * @since 2.0.0 */ interface UTF8MB4SupportInterface { /** * Automatically downgrade a CREATE TABLE or ALTER TABLE query from utf8mb4 (UTF-8 Multibyte) to plain utf8. * * Used when the server doesn't support UTF-8 Multibyte. * * @param string $query The query to convert * * @return string The converted query * * @since 2.0.0 */ public function convertUtf8mb4QueryToUtf8($query); /** * Check whether the database engine supports the UTF-8 Multibyte (utf8mb4) character encoding. * * @return boolean True if the database engine supports UTF-8 Multibyte. * * @since 2.0.0 */ public function hasUtf8mb4Support(); } PK c�\��y�U� U� database/src/DatabaseDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; use Joomla\Database\Event\ConnectionEvent; use Joomla\Database\Exception\ConnectionFailureException; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\Exception\PrepareStatementFailureException; use Joomla\Event\DispatcherAwareInterface; use Joomla\Event\DispatcherAwareTrait; use Joomla\Event\EventInterface; /** * Joomla Framework Database Driver Class * * @since 1.0 */ abstract class DatabaseDriver implements DatabaseInterface, DispatcherAwareInterface { use DispatcherAwareTrait; /** * The name of the database. * * @var string * @since 1.0 */ private $database; /** * The name of the database driver. * * @var string * @since 1.0 */ protected $name; /** * The type of the database server family supported by this driver. * * @var string * @since 1.4.0 */ public $serverType; /** * The database connection resource. * * @var resource * @since 1.0 */ protected $connection; /** * Holds the list of available db connectors. * * @var array * @since 1.0 */ protected static $connectors = []; /** * The number of SQL statements executed by the database driver. * * @var integer * @since 1.0 */ protected $count = 0; /** * The database connection cursor from the last query. * * @var resource * @since 1.0 */ protected $cursor; /** * Contains the current query execution status * * @var boolean * @since 2.0.0 */ protected $executed = false; /** * The affected row limit for the current SQL statement. * * @var integer * @since 1.0 */ protected $limit = 0; /** * The character(s) used to quote SQL statement names such as table names or field names, etc. * * 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; /** * The null or zero representation of a timestamp for the database driver. * * @var string * @since 1.0 */ protected $nullDate; /** * The affected row offset to apply for the current SQL statement. * * @var integer * @since 1.0 */ protected $offset = 0; /** * Passed in upon instantiation and saved. * * @var array * @since 1.0 */ protected $options; /** * The current SQL statement to execute. * * @var mixed * @since 1.0 */ protected $sql; /** * The prepared statement. * * @var StatementInterface * @since 2.0.0 */ protected $statement; /** * The common database table prefix. * * @var string * @since 1.0 */ protected $tablePrefix; /** * True if the database engine supports UTF-8 character encoding. * * @var boolean * @since 1.0 */ protected $utf = true; /** * The database error number. * * @var integer * @since 1.0 */ protected $errorNum = 0; /** * The database error message. * * @var string * @since 1.0 */ protected $errorMsg; /** * DatabaseDriver instances container. * * @var DatabaseDriver[] * @since 1.0 * @deprecated 3.0 Singleton storage will no longer be supported. */ protected static $instances = []; /** * The minimum supported database version. * * @var string * @since 1.0 */ protected static $dbMinimum; /** * The depth of the current transaction. * * @var integer * @since 1.0 */ protected $transactionDepth = 0; /** * DatabaseFactory object * * @var DatabaseFactory * @since 2.0.0 */ protected $factory; /** * Query monitor object * * @var QueryMonitorInterface * @since 2.0.0 */ protected $monitor; /** * Get a list of available database connectors. * * The list will only be populated with connectors that the class exists for and the environment supports its use. * This gives us the ability to have a multitude of connector classes that are self-aware as to whether or not they * are able to be used on a given system. * * @return array An array of available database connectors. * * @since 1.0 */ public static function getConnectors() { if (empty(self::$connectors)) { // Get an iterator and loop trough the driver classes. $dir = __DIR__; $iterator = new \DirectoryIterator($dir); /** @var $file \DirectoryIterator */ foreach ($iterator as $file) { // Only load for php files. if (!$file->isDir()) { continue; } $baseName = $file->getBasename(); // Derive the class name from the type. /** @var $class DatabaseDriver */ $class = __NAMESPACE__ . '\\' . ucfirst(strtolower($baseName)) . '\\' . ucfirst(strtolower($baseName)) . 'Driver'; // If the class doesn't exist, or if it's not supported on this system, move on to the next type. if (!class_exists($class) || !$class::isSupported()) { continue; } // Everything looks good, add it to the list. self::$connectors[] = $baseName; } } return self::$connectors; } /** * Method to return a DatabaseDriver instance based on the given options. * * There are three global options and then the rest are specific to the database driver. * * - The 'driver' option defines which DatabaseDriver class is used for the connection -- the default is 'mysqli'. * - The 'database' option determines which database is to be used for the connection. * - The 'select' option determines whether the connector should automatically select the chosen database. * * Instances are unique to the given options and new objects are only created when a unique options array is * passed into the method. This ensures that we don't end up with unnecessary database connection resources. * * @param array $options Parameters to be passed to the database driver. * * @return DatabaseDriver * * @since 1.0 * @throws \RuntimeException * @deprecated 3.0 Use DatabaseFactory::getDriver() instead */ public static function getInstance(array $options = []) { trigger_deprecation( 'joomla/database', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::getDriver() instead.', __METHOD__, DatabaseFactory::class ); // Sanitize the database connector options. $options['driver'] = isset($options['driver']) ? preg_replace('/[^A-Z0-9_\.-]/i', '', $options['driver']) : 'mysqli'; $options['database'] = $options['database'] ?? null; $options['select'] = $options['select'] ?? true; $options['factory'] = $options['factory'] ?? new DatabaseFactory; $options['monitor'] = $options['monitor'] ?? null; // Get the options signature for the database connector. $signature = md5(serialize($options)); // If we already have a database connector instance for these options then just use that. if (empty(self::$instances[$signature])) { // Set the new connector to the global instances based on signature. self::$instances[$signature] = $options['factory']->getDriver($options['driver'], $options); } return self::$instances[$signature]; } /** * Splits a string of multiple queries into an array of individual queries. * * @param string $sql Input SQL string with which to split into individual queries. * * @return array * * @since 1.0 */ public static function splitSql($sql) { $start = 0; $open = false; $comment = false; $endString = ''; $end = \strlen($sql); $queries = []; $query = ''; for ($i = 0; $i < $end; $i++) { $current = substr($sql, $i, 1); $current2 = substr($sql, $i, 2); $current3 = substr($sql, $i, 3); $lenEndString = \strlen($endString); $testEnd = substr($sql, $i, $lenEndString); if ($current === '"' || $current === "'" || $current2 === '--' || ($current2 === '/*' && $current3 !== '/*!' && $current3 !== '/*+') || ($current === '#' && $current3 !== '#__') || ($comment && $testEnd === $endString)) { // Check if quoted with previous backslash $n = 2; while (substr($sql, $i - $n + 1, 1) === '\\' && $n < $i) { $n++; } // Not quoted if ($n % 2 === 0) { if ($open) { if ($testEnd === $endString) { if ($comment) { $comment = false; if ($lenEndString > 1) { $i += ($lenEndString - 1); $current = substr($sql, $i, 1); } $start = $i + 1; } $open = false; $endString = ''; } } else { $open = true; if ($current2 === '--') { $endString = "\n"; $comment = true; } elseif ($current2 === '/*') { $endString = '*/'; $comment = true; } elseif ($current === '#') { $endString = "\n"; $comment = true; } else { $endString = $current; } if ($comment && $start < $i) { $query .= substr($sql, $start, $i - $start); } } } } if ($comment) { $start = $i + 1; } if (($current === ';' && !$open) || $i === $end - 1) { if ($start <= $i) { $query .= substr($sql, $start, $i - $start + 1); } $query = trim($query); if ($query) { if (($i === $end - 1) && ($current !== ';')) { $query .= ';'; } $queries[] = $query; } $query = ''; $start = $i + 1; } $endComment = false; } return $queries; } /** * Magic method to access properties of the database driver. * * @param string $name The name of the property. * * @return mixed A value if the property name is valid, null otherwise. * * @since 1.4.0 * @deprecated 3.0 This is a B/C proxy since $this->name was previously public */ public function __get($name) { switch ($name) { case 'name': trigger_deprecation( 'joomla/database', '1.4.0', 'Accessing the name property of %s is deprecated, use the getName() method instead.', self::class ); return $this->getName(); default: $trace = debug_backtrace(); trigger_error( sprintf( 'Undefined property via __get(): %1$s in %2$s on line %3$s', $name, $trace[0]['file'], $trace[0]['line'] ), \E_USER_NOTICE ); } } /** * Constructor. * * @param array $options List of options used to configure the connection * * @since 1.0 */ public function __construct(array $options) { // Initialise object variables. $this->database = $options['database'] ?? ''; $this->tablePrefix = $options['prefix'] ?? ''; $this->count = 0; $this->errorNum = 0; // Set class options. $this->options = $options; // Register the DatabaseFactory $this->factory = $options['factory'] ?? new DatabaseFactory; // Register the query monitor if available $this->monitor = $options['monitor'] ?? null; } /** * Destructor. * * @since 2.0.0 */ public function __destruct() { $this->disconnect(); } /** * Alter database's character set. * * @param string $dbName The database name that will be altered * * @return boolean|resource * * @since 2.0.0 * @throws \RuntimeException */ public function alterDbCharacterSet($dbName) { if ($dbName === null) { throw new \RuntimeException('Database name must not be null.'); } $this->setQuery($this->getAlterDbCharacterSet($dbName)); return $this->execute(); } /** * Create a new database using information from $options object. * * @param \stdClass $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 boolean|resource * * @since 2.0.0 * @throws \RuntimeException */ public function createDatabase($options, $utf = true) { if ($options === null) { throw new \RuntimeException('$options object must not be null.'); } if (empty($options->db_name)) { throw new \RuntimeException('$options object must have db_name set.'); } if (empty($options->db_user)) { throw new \RuntimeException('$options object must have db_user set.'); } $this->setQuery($this->getCreateDatabaseQuery($options, $utf)); return $this->execute(); } /** * Create a new DatabaseQuery object. * * @return QueryInterface * * @since 2.2 */ public function createQuery(): QueryInterface { return $this->factory->getQuery($this->name, $this); } /** * Disconnects the database. * * @return void * * @since 2.0.0 */ public function disconnect() { $this->freeResult(); $this->connection = null; $this->dispatchEvent(new ConnectionEvent(DatabaseEvents::POST_DISCONNECT, $this)); } /** * Dispatch an event. * * @param EventInterface $event The event to dispatch * * @return void * * @since 2.0.0 */ protected function dispatchEvent(EventInterface $event) { try { $this->getDispatcher()->dispatch($event->getName(), $event); } catch (\UnexpectedValueException $exception) { // Don't error if a dispatcher hasn't been set } } /** * 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 $this * * @since 2.0.0 * @throws \RuntimeException */ public function dropTable($table, $ifExists = true) { $this->connect(); $this->setQuery('DROP TABLE ' . ($ifExists ? 'IF EXISTS ' : '') . $this->quoteName($table)) ->execute(); return $this; } /** * Execute the SQL statement. * * @return boolean * * @since 2.0.0 * @throws \RuntimeException */ public function execute() { $this->connect(); // Increment the query counter. $this->count++; // Get list of bound parameters $bounded =& $this->sql->getBounded(); // If there is a monitor registered, let it know we are starting this query if ($this->monitor) { // Take a local copy so that we don't modify the original query and cause issues later $sql = $this->replacePrefix((string) $this->sql); $this->monitor->startQuery($sql, $bounded); } // Execute the query. $this->executed = false; // Bind the variables foreach ($bounded as $key => $obj) { $this->statement->bindParam($key, $obj->value, $obj->dataType); } try { $this->executed = $this->statement->execute(); // If there is a monitor registered, let it know we have finished this query if ($this->monitor) { $this->monitor->stopQuery(); } return true; } catch (ExecutionFailureException $exception) { // If there is a monitor registered, let it know we have finished this query if ($this->monitor) { $this->monitor->stopQuery(); } // Check if the server was disconnected. if (!$this->connected()) { try { // Attempt to reconnect. $this->connection = null; $this->connect(); } catch (ConnectionFailureException $e) { // If connect fails, ignore that exception and throw the normal exception. throw $exception; } // Since we were able to reconnect, run the query again. return $this->execute(); } // Throw the normal query exception. throw $exception; } } /** * Method to fetch a row from the result set cursor as an array. * * @return mixed Either the next row from the result set or false if there are no more rows. * * @since 1.0 */ protected function fetchArray() { if ($this->statement) { return $this->statement->fetch(FetchMode::NUMERIC); } } /** * Method to fetch a row from the result set cursor as an associative array. * * @return mixed Either the next row from the result set or false if there are no more rows. * * @since 1.0 */ protected function fetchAssoc() { if ($this->statement) { return $this->statement->fetch(FetchMode::ASSOCIATIVE); } } /** * Method to fetch a row from the result set cursor as an object. * * Note, the fetch mode should be configured before calling this method using `StatementInterface::setFetchMode()`. * * @return mixed Either the next row from the result set or false if there are no more rows. * * @since 1.0 */ protected function fetchObject() { if ($this->statement) { return $this->statement->fetch(); } } /** * Method to free up the memory used for the result set. * * @return void * * @since 1.0 */ protected function freeResult() { $this->executed = false; if ($this->statement) { $this->statement->closeCursor(); } } /** * Get the number of affected rows for the previous executed SQL statement. * * @return integer The number of affected rows in the previous operation * * @since 2.0.0 */ public function getAffectedRows() { $this->connect(); if ($this->statement) { return $this->statement->rowCount(); } return 0; } /** * Method that provides access to the underlying database connection. * * @return resource The underlying database connection resource. * * @since 1.0 */ public function getConnection() { return $this->connection; } /** * Get the total number of SQL statements executed by the database driver. * * @return integer * * @since 1.0 */ public function getCount() { return $this->count; } /** * 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 * * @since 1.6.0 */ protected function getAlterDbCharacterSet($dbName) { return 'ALTER DATABASE ' . $this->quoteName($dbName) . ' CHARACTER SET ' . $this->quote('UTF8'); } /** * Return the query string to create new Database. * * @param stdClass $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 * * @since 2.0.0 */ protected function getCreateDatabaseQuery($options, $utf) { return 'CREATE DATABASE ' . $this->quoteName($options->db_name); } /** * Gets the name of the database used by this connection. * * @return string * * @since 1.0 */ protected function getDatabase() { return $this->database; } /** * Returns a PHP date() function compliant date format for the database driver. * * @return string * * @since 1.0 */ public function getDateFormat() { return 'Y-m-d H:i:s'; } /** * Get the minimum supported database version. * * @return string * * @since 1.0 */ public function getMinimum() { return static::$dbMinimum; } /** * Get the name of the database driver. * * If $this->name is not set it will try guessing the driver name from the class name. * * @return string * * @since 1.4.0 */ public function getName() { if (empty($this->name)) { $reflect = new \ReflectionClass($this); $this->name = strtolower(str_replace('Driver', '', $reflect->getShortName())); } return $this->name; } /** * Get the number of returned rows for the previous executed SQL statement. * * @return integer The number of returned rows. * * @since 2.0.0 */ public function getNumRows() { $this->connect(); if ($this->statement) { return $this->statement->rowCount(); } return 0; } /** * Get the server family type. * * If $this->serverType is not set it will attempt guessing the server family type from the driver name. If this is not possible the driver * name will be returned instead. * * @return string * * @since 1.4.0 */ public function getServerType() { if (empty($this->serverType)) { $name = $this->getName(); if (stristr($name, 'mysql') !== false) { $this->serverType = 'mysql'; } elseif (stristr($name, 'postgre') !== false) { $this->serverType = 'postgresql'; } elseif (stristr($name, 'pgsql') !== false) { $this->serverType = 'postgresql'; } elseif (stristr($name, 'oracle') !== false) { $this->serverType = 'oracle'; } elseif (stristr($name, 'sqlite') !== false) { $this->serverType = 'sqlite'; } elseif (stristr($name, 'sqlsrv') !== false) { $this->serverType = 'mssql'; } elseif (stristr($name, 'sqlazure') !== false) { $this->serverType = 'mssql'; } elseif (stristr($name, 'mssql') !== false) { $this->serverType = 'mssql'; } else { $this->serverType = $name; } } return $this->serverType; } /** * Get the null or zero representation of a timestamp for the database driver. * * @return string * * @since 1.0 */ public function getNullDate() { return $this->nullDate; } /** * Get the common table prefix for the database driver. * * @return string The common database table prefix. * * @since 1.0 */ public function getPrefix() { return $this->tablePrefix; } /** * Gets an exporter class object. * * @return DatabaseExporter An exporter object. * * @since 1.0 * @throws \RuntimeException */ public function getExporter() { return $this->factory->getExporter($this->name, $this); } /** * Gets an importer class object. * * @return DatabaseImporter * * @since 1.0 */ public function getImporter() { return $this->factory->getImporter($this->name, $this); } /** * Get the current query object or a new DatabaseQuery object. * * @param boolean $new False to return the current query object, True to return a new DatabaseQuery object. * The $new parameter is deprecated in 2.2 and will be removed in 4.0, use createQuery() instead. * * @return DatabaseQuery * * @since 1.0 */ public function getQuery($new = false) { if ($new) { trigger_deprecation( 'joomla/database', '2.2.0', 'The parameter $new is deprecated and will be removed in 4.0, use %s::createQuery() instead.', self::class ); return $this->createQuery(); } return $this->sql; } /** * Get a new iterator on the current query. * * @param string $column An option column to use as the iterator key. * @param string $class The class of object that is returned. * * @return DatabaseIterator * * @since 1.0 */ public function getIterator($column = null, $class = \stdClass::class) { if (!$this->executed) { $this->execute(); } /** * Calling setQuery free's the statement from the iterator which will break the iterator. * So we set statement to null so that freeResult on the statement here has no affect. * If you unset the iterator object then that will close the cursor and free the result. */ $iterator = $this->factory->getIterator($this->name, $this->statement, $column, $class); $this->statement = null; return $iterator; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ abstract public function getTableCreate($tables); /** * Determine whether or not the database engine supports UTF-8 character encoding. * * @return boolean True if the database engine supports UTF-8 character encoding. * * @since 1.0 */ 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 * * @since 1.0 * @throws \RuntimeException */ public function insertObject($table, &$object, $key = null) { $fields = []; $values = []; $tableColumns = $this->getTableColumns($table); // Iterate over the object variables to build the query fields and values. foreach (get_object_vars($object) as $k => $v) { // Skip columns that don't exist in the table. if (!\array_key_exists($k, $tableColumns)) { continue; } // 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->createQuery() ->insert($this->quoteName($table)) ->columns($fields) ->values(implode(',', $values)); // Set the query and execute the insert. $this->setQuery($query)->execute(); // Update the primary key if it exists. $id = $this->insertid(); if ($key && $id && \is_string($key)) { $object->$key = $id; } return true; } /** * Method to check whether the installed database version is supported by the database driver * * @return boolean True if the database version is supported * * @since 1.0 */ public function isMinimumVersion() { return version_compare($this->getVersion(), $this->getMinimum()) >= 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. * * @since 1.0 * @throws \RuntimeException */ public function loadAssoc() { $this->connect(); $ret = null; // Execute the query and get the result set cursor. $this->execute(); // Get the first row from the result set as an associative array. $array = $this->fetchAssoc(); if ($array) { $ret = $array; } // Free up system resources and return. $this->freeResult(); 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: 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 $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. * * @since 1.0 * @throws \RuntimeException */ public function loadAssocList($key = null, $column = null) { $this->connect(); $array = []; // Execute the query and get the result set cursor. $this->execute(); // Get all of the rows from the result set. while ($row = $this->fetchAssoc()) { $value = $column ? ($row[$column] ?? $row) : $row; if ($key) { $array[$row[$key]] = $value; } else { $array[] = $value; } } // Free up system resources and return. $this->freeResult(); return $array; } /** * Method to get an array of values from the <var>$offset</var> 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. * * @since 1.0 * @throws \RuntimeException */ public function loadColumn($offset = 0) { $this->connect(); $array = []; // Execute the query and get the result set cursor. $this->execute(); // Get all of the rows from the result set as arrays. while ($row = $this->fetchArray()) { $array[] = $row[$offset]; } // Free up system resources and return. $this->freeResult(); return $array; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function loadObject($class = \stdClass::class) { $this->connect(); $ret = null; if ($this->statement) { $fetchMode = $class === \stdClass::class ? FetchMode::STANDARD_OBJECT : FetchMode::CUSTOM_OBJECT; // PDO doesn't allow extra arguments for \PDO::FETCH_CLASS, so only forward the class for the custom object mode if ($fetchMode === FetchMode::STANDARD_OBJECT) { $this->statement->setFetchMode($fetchMode); } else { $this->statement->setFetchMode($fetchMode, $class); } } // Execute the query and get the result set cursor. $this->execute(); // Get the first row from the result set as an object of type $class. $object = $this->fetchObject(); if ($object) { $ret = $object; } // Free up system resources and return. $this->freeResult(); 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. * * @since 1.0 * @throws \RuntimeException */ public function loadObjectList($key = '', $class = \stdClass::class) { $this->connect(); $array = []; if ($this->statement) { $fetchMode = $class === \stdClass::class ? FetchMode::STANDARD_OBJECT : FetchMode::CUSTOM_OBJECT; // PDO doesn't allow extra arguments for \PDO::FETCH_CLASS, so only forward the class for the custom object mode if ($fetchMode === FetchMode::STANDARD_OBJECT) { $this->statement->setFetchMode($fetchMode); } else { $this->statement->setFetchMode($fetchMode, $class); } } // Execute the query and get the result set cursor. $this->execute(); // Get all of the rows from the result set as objects of type $class. while ($row = $this->fetchObject()) { if ($key) { $array[$row->$key] = $row; } else { $array[] = $row; } } // Free up system resources and return. $this->freeResult(); 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. * * @since 1.0 * @throws \RuntimeException */ public function loadResult() { $this->connect(); $ret = null; // Execute the query and get the result set cursor. $this->execute(); // Get the first row from the result set as an array. $row = $this->fetchArray(); if ($row) { $ret = $row[0]; } // Free up system resources and return. $this->freeResult(); return $ret; } /** * 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 <var>$row[0]</var>, etc. * * @return mixed The return value or null if the query failed. * * @since 1.0 * @throws \RuntimeException */ public function loadRow() { $this->connect(); $ret = null; // Execute the query and get the result set cursor. $this->execute(); // Get the first row from the result set as an array. $row = $this->fetchArray(); if ($row) { $ret = $row; } // Free up system resources and return. $this->freeResult(); 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 array An array of results. * * @since 1.0 * @throws \RuntimeException */ public function loadRowList($key = null) { $this->connect(); $array = []; // Execute the query and get the result set cursor. $this->execute(); // Get all of the rows from the result set as arrays. while ($row = $this->fetchArray()) { if ($key !== null) { $array[$row[$key]] = $row; } else { $array[] = $row; } } // Free up system resources and return. $this->freeResult(); return $array; } /** * Prepares a SQL statement for execution * * @param string $query The SQL query to be prepared. * * @return StatementInterface * * @since 2.0.0 * @throws PrepareStatementFailureException */ abstract protected function prepareStatement(string $query): StatementInterface; /** * Alias for quote method * * @param array|string $text A string or an array of strings to quote. * @param boolean $escape True (default) to escape the string, false to leave it unchanged. * * @return string The quoted input string. * * @since 1.0 */ public function q($text, $escape = true) { return $this->quote($text, $escape); } /** * Quotes and optionally escapes a string to database requirements for use in database queries. * * @param array|string $text A string or an array of strings to quote. * @param boolean $escape True (default) to escape the string, false to leave it unchanged. * * @return array|string The quoted input string. * * @since 1.0 */ public function quote($text, $escape = true) { if (\is_array($text)) { foreach ($text as $k => $v) { $text[$k] = $this->quote($v, $escape); } return $text; } return '\'' . ($escape ? $this->escape($text) : $text) . '\''; } /** * Quotes a binary string to database requirements for use in database queries. * * @param string $data A binary string to quote. * * @return string The binary quoted input string. * * @since 1.7.0 */ public function quoteBinary($data) { // SQL standard syntax for hexadecimal literals return "X'" . bin2hex($data) . "'"; } /** * Replace special placeholder representing binary field with the original string. * * @param string|resource $data Encoded string or resource. * * @return string The original string. * * @since 1.7.0 */ public function decodeBinary($data) { return $data; } /** * Alias for quoteName method * * @param array|string $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 array|string $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 array|string The quote wrapped name, same type of $name. * * @since 1.0 */ public function qn($name, $as = null) { return $this->quoteName($name, $as); } /** * Wrap an SQL statement identifier name such as column, table or database names in quotes to prevent injection * risks and reserved word conflicts. * * @param array|string $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 array|string $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 array|string The quote wrapped name, same type of $name. * * @since 1.0 */ public function quoteName($name, $as = null) { if (\is_string($name)) { $name = $this->quoteNameString($name); if ($as !== null) { $name .= ' AS ' . $this->quoteNameString($as, true); } return $name; } $fin = []; if ($as === null) { foreach ($name as $str) { $fin[] = $this->quoteName($str); } } elseif (\is_array($name) && (\count($name) === \count($as))) { $count = \count($name); for ($i = 0; $i < $count; $i++) { $fin[] = $this->quoteName($name[$i], $as[$i]); } } return $fin; } /** * Quote string coming from quoteName call. * * @param string $name Identifier name to be quoted. * @param boolean $asSinglePart Treat the name as a single part of the identifier. * * @return string Quoted identifier string. * * @since 1.7.0 */ protected function quoteNameString($name, $asSinglePart = false) { $q = $this->nameQuote . $this->nameQuote; // Double quote reserved keyword $name = str_replace($q[1], $q[1] . $q[1], $name); if ($asSinglePart) { return $q[0] . $name . $q[1]; } return $q[0] . str_replace('.', "$q[1].$q[0]", $name) . $q[1]; } /** * 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. * * @since 1.0 * @deprecated 2.0 Use quoteNameString instead */ protected function quoteNameStr($strArr) { $parts = []; foreach ($strArr as $part) { if ($part === null) { continue; } $parts[] = $this->quoteNameString($part, true); } return implode('.', $parts); } /** * This function replaces a string identifier with the configured table prefix. * * @param string $sql The SQL statement to prepare. * @param string $prefix The table prefix. * * @return string The processed SQL statement. * * @since 1.0 */ public function replacePrefix($sql, $prefix = '#__') { $escaped = false; $startPos = 0; $quoteChar = ''; $literal = ''; $sql = trim($sql); $n = \strlen($sql); while ($startPos < $n) { $ip = strpos($sql, $prefix, $startPos); if ($ip === false) { break; } $j = strpos($sql, "'", $startPos); $k = strpos($sql, '"', $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($sql, $startPos, $j - $startPos)); $startPos = $j; $j = $startPos + 1; if ($j >= $n) { break; } // Quote comes first, find end of quote while (true) { $k = strpos($sql, $quoteChar, $j); $escaped = false; if ($k === false) { break; } $l = $k - 1; while ($l >= 0 && $sql[$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($sql, $startPos, $k - $startPos + 1); $startPos = $k + 1; } if ($startPos < $n) { $literal .= substr($sql, $startPos, $n - $startPos); } return $literal; } /** * Get the query monitor. * * @return QueryMonitorInterface|null The query monitor or null if not set. * * @since 2.0.0 */ public function getMonitor() { return $this->monitor; } /** * Set a query monitor. * * @param QueryMonitorInterface|null $monitor The query monitor. * * @return $this * * @since 2.0.0 */ public function setMonitor(QueryMonitorInterface $monitor = null) { $this->monitor = $monitor; return $this; } /** * Sets the SQL statement string for later execution. * * @param string|QueryInterface $query The SQL statement to set either as a Query object or a string. * @param integer $offset The affected row offset to set. {@deprecated 3.0 Use LimitableInterface::setLimit() instead} * @param integer $limit The maximum affected rows to set. {@deprecated 3.0 Use LimitableInterface::setLimit() instead} * * @return $this * * @since 1.0 * @throws \InvalidArgumentException */ public function setQuery($query, $offset = 0, $limit = 0) { $this->connect(); $this->freeResult(); if (\is_string($query)) { // Allows taking advantage of bound variables in a direct query: $query = $this->createQuery()->setQuery($query); } elseif (!($query instanceof QueryInterface)) { throw new \InvalidArgumentException( sprintf( 'A query must be a string or a %s instance, a %s was given.', QueryInterface::class, \gettype($query) === 'object' ? (\get_class($query) . ' instance') : \gettype($query) ) ); } if ($offset > 0 || $limit > 0) { trigger_deprecation( 'joomla/database', '2.0.0', 'The "$offset" and "$limit" arguments of %s() are deprecated and will be removed in 3.0, use %s::setLimit() instead.', __METHOD__, QueryInterface::class ); } // Check for values set on the query object and use those if there is a zero value passed here if ($limit === 0 && $query->limit > 0) { $limit = $query->limit; } if ($offset === 0 && $query->offset > 0) { $offset = $query->offset; } $query->setLimit($limit, $offset); $sql = $this->replacePrefix((string) $query); $this->statement = $this->prepareStatement($sql); $this->sql = $query; $this->limit = (int) max(0, $limit); $this->offset = (int) max(0, $offset); return $this; } /** * Set the connection to use UTF-8 character encoding. * * @return boolean True on success. * * @since 1.0 */ abstract public function setUtf(); /** * Method to truncate a table. * * @param string $table The table to truncate * * @return void * * @since 1.0 * @throws \RuntimeException */ public function truncateTable($table) { $this->setQuery('TRUNCATE TABLE ' . $this->quoteName($table)) ->execute(); } /** * 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 array|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. * * @since 1.0 * @throws \RuntimeException */ public function updateObject($table, &$object, $key, $nulls = false) { $fields = []; $where = []; $tableColumns = $this->getTableColumns($table); 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) { // Skip columns that don't exist in the table. if (!\array_key_exists($k, $tableColumns)) { continue; } // 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, true)) { $where[] = $this->quoteName($k) . ($v === null ? ' IS NULL' : ' = ' . $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'; } else { // If the value is null and we do not want to update nulls then ignore this field. continue; } } else { // The field is not null so we prep it for update. $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)))->execute(); return true; } } PK c�\"�d�� � database/src/FetchMode.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Class defining the fetch mode for prepared statements * * The values of the constants in this class match the `PDO::FETCH_*` constants. * * @since 2.0.0 */ final class FetchMode { /** * Specifies that the fetch method shall return each row as an array indexed by column name as returned in the corresponding result set. * * If the result set contains multiple columns with the same name, the statement returns only a single value per column name. * * @var integer * @since 2.0.0 * @see \PDO::FETCH_ASSOC */ public const ASSOCIATIVE = 2; /** * Specifies that the fetch method shall return each row as an array indexed by column number as returned in the corresponding result set, * starting at column 0. * * @var integer * @since 2.0.0 * @see \PDO::FETCH_NUM */ public const NUMERIC = 3; /** * Specifies that the fetch method shall return each row as an array indexed by both column name and number as returned in the corresponding * result set, starting at column 0. * * @var integer * @since 2.0.0 * @see \PDO::FETCH_BOTH */ public const MIXED = 4; /** * Specifies that the fetch method shall return each row as an object with property names that correspond to the column names returned in the * result set. * * @var integer * @since 2.0.0 * @see \PDO::FETCH_OBJ */ public const STANDARD_OBJECT = 5; /** * Specifies that the fetch method shall return only a single requested column from the next row in the result set. * * @var integer * @since 2.0.0 * @see \PDO::FETCH_COLUMN */ public const COLUMN = 7; /** * Specifies that the fetch method shall return a new instance of the requested class, mapping the columns to named properties in the class. * * @var integer * @since 2.0.0 * @see \PDO::FETCH_CLASS */ public const CUSTOM_OBJECT = 8; /** * Private constructor to prevent instantiation of this class * * @since 2.0.0 */ private function __construct() { } } PK c�\�h�� � ! database/src/Mysql/MysqlQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysql; use Joomla\Database\Pdo\PdoQuery; use Joomla\Database\Query\MysqlQueryBuilder; /** * MySQL Query Building Class. * * @since 1.0 */ class MysqlQuery extends PdoQuery { use MysqlQueryBuilder; /** * The list of zero or null representation of a datetime. * * @var array * @since 2.0.0 */ protected $nullDatetimeList = ['0000-00-00 00:00:00', '1000-01-01 00:00:00']; } PK c�\�m~ Q Q " database/src/Mysql/MysqlDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysql; use Joomla\Database\Exception\ConnectionFailureException; use Joomla\Database\Pdo\PdoDriver; use Joomla\Database\UTF8MB4SupportInterface; /** * MySQL database driver supporting PDO based connections * * @link https://www.php.net/manual/en/ref.pdo-mysql.php * @since 1.0 */ class MysqlDriver extends PdoDriver implements UTF8MB4SupportInterface { /** * The name of the database driver. * * @var string * @since 1.0 */ public $name = 'mysql'; /** * The character(s) used to quote SQL statement names such as table names or field names, etc. * * 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 = '`'; /** * The null or zero representation of a timestamp for the database driver. * * @var string * @since 1.0 */ protected $nullDate = '0000-00-00 00:00:00'; /** * True if the database engine supports UTF-8 Multibyte (utf8mb4) character encoding. * * @var boolean * @since 1.4.0 */ protected $utf8mb4 = false; /** * True if the database engine is MariaDB. * * @var boolean * @since 2.0.0 */ protected $mariadb = false; /** * The minimum supported database version. * * @var string * @since 1.0 */ protected static $dbMinimum = '5.6'; /** * The minimum supported MariaDB database version. * * @var string * @since 2.0.0 */ protected static $dbMinMariadb = '10.0'; /** * The default cipher suite for TLS connections. * * @var array * @since 2.0.0 */ protected static $defaultCipherSuite = [ 'AES128-GCM-SHA256', 'AES256-GCM-SHA384', 'AES128-CBC-SHA256', 'AES256-CBC-SHA384', 'DES-CBC3-SHA', ]; /** * The default charset. * * @var string * @since 2.0.0 */ public $charset = 'utf8'; /** * Constructor. * * @param array $options Array of database options with keys: host, user, password, database, select. * * @since 1.0 */ public function __construct(array $options) { /** * sql_mode to MySql 5.7.8+ default strict mode minus ONLY_FULL_GROUP_BY * * @link https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-8.html#mysqld-5-7-8-sql-mode */ $sqlModes = [ 'STRICT_TRANS_TABLES', 'ERROR_FOR_DIVISION_BY_ZERO', 'NO_ENGINE_SUBSTITUTION', ]; // Get some basic values from the options. $options['driver'] = 'mysql'; $options['charset'] = $options['charset'] ?? 'utf8'; $options['sqlModes'] = isset($options['sqlModes']) ? (array) $options['sqlModes'] : $sqlModes; $this->charset = $options['charset']; /* * Pre-populate the UTF-8 Multibyte compatibility flag. Unfortunately PDO won't report the server version unless we're connected to it, * and we cannot connect to it unless we know if it supports utf8mb4, which requires us knowing the server version. Because of this * chicken and egg issue, we _assume_ it's supported and we'll just catch any problems at connection time. */ $this->utf8mb4 = $options['charset'] === 'utf8mb4'; // Finalize initialisation. parent::__construct($options); } /** * Connects to the database if needed. * * @return void Returns void if the database connected successfully. * * @since 1.0 * @throws \RuntimeException */ public function connect() { if ($this->getConnection()) { return; } // For SSL/TLS connection encryption. if ($this->options['ssl'] !== [] && $this->options['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->options['ssl'][$value] !== null) { $this->options['driverOptions'][constant('\PDO::MYSQL_ATTR_SSL_' . strtoupper($value))] = $this->options['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->options['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->options['ssl']['verify_server_cert'] !== null && defined('\PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT')) { $this->options['driverOptions'][\PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT] = $this->options['ssl']['verify_server_cert']; } } try { // Try to connect to MySQL parent::connect(); } catch (ConnectionFailureException $e) { // If the connection failed, but not because of the wrong character set, then bubble up the exception. if (!$this->utf8mb4) { throw $e; } /* * Otherwise, try connecting again without using utf8mb4 and see if maybe that was the problem. If the connection succeeds, then we * will have learned that the client end of the connection does not support utf8mb4. */ $this->utf8mb4 = false; $this->options['charset'] = 'utf8'; parent::connect(); } $serverVersion = $this->getVersion(); $this->mariadb = stripos($serverVersion, 'mariadb') !== false; if ($this->utf8mb4) { // At this point we know the client supports utf8mb4. Now we must check if the server supports utf8mb4 as well. $this->utf8mb4 = version_compare($serverVersion, '5.5.3', '>='); if ($this->mariadb && version_compare($serverVersion, '10.0.0', '<')) { $this->utf8mb4 = false; } if (!$this->utf8mb4) { // Reconnect with the utf8 character set. parent::disconnect(); $this->options['charset'] = 'utf8'; parent::connect(); } } // If needed, set the sql modes. if ($this->options['sqlModes'] !== []) { $this->connection->query('SET @@SESSION.sql_mode = \'' . implode(',', $this->options['sqlModes']) . '\';'); } $this->setOption(\PDO::ATTR_EMULATE_PREPARES, true); } /** * Automatically downgrade a CREATE TABLE or ALTER TABLE query from utf8mb4 (UTF-8 Multibyte) to plain utf8. * * Used when the server doesn't support UTF-8 Multibyte. * * @param string $query The query to convert * * @return string The converted query * * @since 1.4.0 */ public function convertUtf8mb4QueryToUtf8($query) { if ($this->hasUTF8mb4Support()) { return $query; } // If it's not an ALTER TABLE or CREATE TABLE command there's nothing to convert $beginningOfQuery = substr($query, 0, 12); $beginningOfQuery = strtoupper($beginningOfQuery); if (!\in_array($beginningOfQuery, ['ALTER TABLE ', 'CREATE TABLE'], true)) { return $query; } // Replace utf8mb4 with utf8 return str_replace('utf8mb4', 'utf8', $query); } /** * Test to see if the MySQL connector is available. * * @return boolean True on success, false otherwise. * * @since 1.0 */ public static function isSupported() { return class_exists('\\PDO') && \in_array('mysql', \PDO::getAvailableDrivers(), true); } /** * Select a database for use. * * @param string $database The name of the database to select for use. * * @return boolean * * @since 1.0 * @throws \RuntimeException */ public function select($database) { $this->connect(); $this->setQuery('USE ' . $this->quoteName($database)) ->execute(); return true; } /** * 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 * * @since 2.0.0 */ public function getAlterDbCharacterSet($dbName) { $charset = $this->utf8mb4 ? 'utf8mb4' : 'utf8'; return 'ALTER DATABASE ' . $this->quoteName($dbName) . ' CHARACTER SET `' . $charset . '`'; } /** * Method to get the database collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database (string) or boolean false if not supported. * * @since 1.0 * @throws \RuntimeException */ public function getCollation() { $this->connect(); return $this->setQuery('SELECT @@collation_database;')->loadResult(); } /** * Method to get the database connection collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database connection (string) or boolean false if not supported. * * @since 1.6.0 * @throws \RuntimeException */ public function getConnectionCollation() { $this->connect(); return $this->setQuery('SELECT @@collation_connection;')->loadResult(); } /** * Method to get the database encryption details (cipher and protocol) in use. * * @return string The database encryption details. * * @since 2.0.0 * @throws \RuntimeException */ public function getConnectionEncryption(): string { $this->connect(); $variables = $this->setQuery('SHOW SESSION STATUS WHERE `Variable_name` IN (\'Ssl_version\', \'Ssl_cipher\')') ->loadObjectList('Variable_name'); if (!empty($variables['Ssl_cipher']->Value)) { return $variables['Ssl_version']->Value . ' (' . $variables['Ssl_cipher']->Value . ')'; } return ''; } /** * Method to test if the database TLS connections encryption are supported. * * @return boolean Whether the database supports TLS connections encryption. * * @since 2.0.0 */ public function isConnectionEncryptionSupported(): bool { $this->connect(); $variables = $this->setQuery('SHOW SESSION VARIABLES WHERE `Variable_name` IN (\'have_ssl\')')->loadObjectList('Variable_name'); return !empty($variables['have_ssl']->Value) && $variables['have_ssl']->Value === 'YES'; } /** * Return the query string to create new Database. * * @param stdClass $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 * * @since 2.0.0 */ protected function getCreateDatabaseQuery($options, $utf) { if ($utf) { $charset = $this->utf8mb4 ? 'utf8mb4' : 'utf8'; $collation = $charset . '_unicode_ci'; return 'CREATE DATABASE ' . $this->quoteName($options->db_name) . ' CHARACTER SET `' . $charset . '` COLLATE `' . $collation . '`'; } return 'CREATE DATABASE ' . $this->quoteName($options->db_name); } /** * Shows the table CREATE statement that creates the given tables. * * @param array|string $tables A table name or a list of table names. * * @return array A list of the create SQL for the tables. * * @since 1.0 * @throws \RuntimeException */ public function getTableCreate($tables) { $this->connect(); // Initialise variables. $result = []; // Sanitize input to an array and iterate over the list. $tables = (array) $tables; foreach ($tables as $table) { $row = $this->setQuery('SHOW CREATE TABLE ' . $this->quoteName($table))->loadRow(); // Populate the result array based on the create statements. $result[$table] = $row[1]; } return $result; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableColumns($table, $typeOnly = true) { $this->connect(); $result = []; // Set the query to get the table fields statement. $fields = $this->setQuery('SHOW FULL COLUMNS FROM ' . $this->quoteName($table))->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; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableKeys($table) { $this->connect(); // Get the details columns information. return $this->setQuery('SHOW KEYS FROM ' . $this->quoteName($table))->loadObjectList(); } /** * Method to get an array of all tables in the database. * * @return array An array of all the tables in the database. * * @since 1.0 * @throws \RuntimeException */ public function getTableList() { $this->connect(); // Set the query to get the tables statement. return $this->setQuery('SHOW TABLES')->loadColumn(); } /** * Get the version of the database connector. * * @return string The database connector version. * * @since 2.0.0 */ public function getVersion() { $this->connect(); $version = $this->getOption(\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; } /** * Get the minimum supported database version. * * @return string * * @since 2.0.0 */ public function getMinimum() { return $this->mariadb ? static::$dbMinMariadb : static::$dbMinimum; } /** * Get the null or zero representation of a timestamp for the database driver. * * @return string * * @since 2.0.0 */ public function getNullDate() { // Check the session sql mode; if (\in_array('NO_ZERO_DATE', $this->options['sqlModes']) !== false) { $this->nullDate = '1000-01-01 00:00:00'; } return $this->nullDate; } /** * Determine whether the database engine support the UTF-8 Multibyte (utf8mb4) character encoding. * * @return boolean True if the database engine supports UTF-8 Multibyte. * * @since 2.0.0 */ public function hasUTF8mb4Support() { return $this->utf8mb4; } /** * Determine if the database engine is MariaDB. * * @return boolean * * @since 2.0.0 */ public function isMariaDb(): bool { $this->connect(); return $this->mariadb; } /** * Locks a table in the database. * * @param string $table The name of the table to unlock. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function lockTable($table) { $this->setQuery('LOCK TABLES ' . $this->quoteName($table) . ' WRITE') ->execute(); return $this; } /** * 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 $this * * @since 1.0 * @throws \RuntimeException */ public function renameTable($oldTable, $newTable, $backup = null, $prefix = null) { $this->setQuery('RENAME TABLE ' . $this->quoteName($oldTable) . ' TO ' . $this->quoteName($newTable)) ->execute(); return $this; } /** * 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 * * @since 2.0.0 * @throws \RuntimeException */ public function insertObject($table, &$object, $key = null) { $fields = []; $values = []; $tableColumns = $this->getTableColumns($table); // Iterate over the object variables to build the query fields and values. foreach (get_object_vars($object) as $k => $v) { // Skip columns that don't exist in the table. if (!array_key_exists($k, $tableColumns)) { continue; } // Only process non-null scalars. if (\is_array($v) || \is_object($v) || $v === null) { continue; } // Ignore any internal fields. if ($k[0] === '_') { continue; } // Ignore null datetime fields. if ($tableColumns[$k] === 'datetime' && empty($v)) { continue; } // Ignore null integer fields. if (stristr($tableColumns[$k], 'int') !== false && $v === '') { 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->createQuery() ->insert($this->quoteName($table)) ->columns($fields) ->values(implode(',', $values)); // Set the query and execute the insert. $this->setQuery($query)->execute(); // Update the primary key if it exists. $id = $this->insertid(); if ($key && $id && \is_string($key)) { $object->$key = $id; } return true; } /** * Method to escape a string for usage in an SQL statement. * * Oracle escaping reference: * http://www.orafaq.com/wiki/SQL_FAQ#How_does_one_escape_special_characters_when_writing_SQL_queries.3F * * SQLite escaping notes: * http://www.sqlite.org/faq.html#q14 * * Method body is as implemented by the Zend Framework * * 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)) { return $text; } if (\is_float($text)) { // Force the dot as a decimal point. return str_replace(',', '.', (string) $text); } $this->connect(); $result = substr($this->connection->quote($text), 1, -1); if ($extra) { $result = addcslashes($result, '%_'); } return $result; } /** * Unlocks tables in the database. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function unlockTables() { $this->setQuery('UNLOCK TABLES') ->execute(); return $this; } /** * Method to commit a transaction. * * @param boolean $toSavepoint If true, commit to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionCommit($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { parent::transactionCommit($toSavepoint); } else { $this->transactionDepth--; } } /** * Method to roll back a transaction. * * @param boolean $toSavepoint If true, rollback to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionRollback($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { parent::transactionRollback($toSavepoint); } else { $savepoint = 'SP_' . ($this->transactionDepth - 1); $this->setQuery('ROLLBACK TO SAVEPOINT ' . $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 * * @since 1.0 * @throws \RuntimeException */ public function transactionStart($asSavepoint = false) { $this->connect(); if (!$asSavepoint || !$this->transactionDepth) { parent::transactionStart($asSavepoint); } else { $savepoint = 'SP_' . $this->transactionDepth; $this->setQuery('SAVEPOINT ' . $this->quoteName($savepoint)); if ($this->execute()) { $this->transactionDepth++; } } } } PK c�\�H&]. ]. $ database/src/Mysql/MysqlImporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysql; use Joomla\Database\DatabaseImporter; /** * MySQL Database Importer. * * @since 1.0 */ class MysqlImporter extends DatabaseImporter { /** * Checks if all data and options are in order prior to exporting. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function check() { // Check if the db connector has been set. if (!($this->db instanceof MysqlDriver)) { throw new \RuntimeException('Database connection wrong type.'); } // Check if the tables have been specified. if (empty($this->from)) { throw new \RuntimeException('ERROR: No Tables Specified'); } return $this; } /** * Get the SQL syntax to add a key. * * @param string $table The table name. * @param array $keys An array of the fields pertaining to this key. * * @return string * * @since 1.0 */ protected function getAddKeySql($table, $keys) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' ADD ' . $this->getKeySql($keys); } /** * Get alters for table if there is a difference. * * @param \SimpleXMLElement $structure The XML structure of the table. * * @return array * * @since 1.0 */ protected function getAlterTableSql(\SimpleXMLElement $structure) { // Initialise variables. $table = $this->getRealTableName($structure['name']); $oldFields = $this->db->getTableColumns($table); $oldKeys = $this->db->getTableKeys($table); $alters = []; // Get the fields and keys from the XML that we are aiming for. $newFields = $structure->xpath('field'); $newKeys = $structure->xpath('key'); // Loop through each field in the new structure. foreach ($newFields as $field) { $fName = (string) $field['Field']; if (isset($oldFields[$fName])) { // The field exists, check it's the same. $column = $oldFields[$fName]; // Test whether there is a change. $change = ((string) $field['Type'] !== $column->Type) || ((string) $field['Null'] !== $column->Null) || ((string) $field['Default'] !== $column->Default) || ((string) $field['Extra'] !== $column->Extra); if ($change) { $alters[] = $this->getChangeColumnSql($table, $field); } // Unset this field so that what we have left are fields that need to be removed. unset($oldFields[$fName]); } else { // The field is new. $alters[] = $this->getAddColumnSql($table, $field); } } // Any columns left are orphans foreach ($oldFields as $name => $column) { // Delete the column. $alters[] = $this->getDropColumnSql($table, $name); } // Get the lookups for the old and new keys. $oldLookup = $this->getKeyLookup($oldKeys); $newLookup = $this->getKeyLookup($newKeys); // Loop through each key in the new structure. foreach ($newLookup as $name => $keys) { // Check if there are keys on this field in the existing table. if (isset($oldLookup[$name])) { $same = true; $newCount = \count($newLookup[$name]); $oldCount = \count($oldLookup[$name]); // There is a key on this field in the old and new tables. Are they the same? if ($newCount === $oldCount) { // Need to loop through each key and do a fine grained check. for ($i = 0; $i < $newCount; $i++) { $same = (((string) $newLookup[$name][$i]['Non_unique'] === $oldLookup[$name][$i]->Non_unique) && ((string) $newLookup[$name][$i]['Column_name'] === $oldLookup[$name][$i]->Column_name) && ((string) $newLookup[$name][$i]['Seq_in_index'] === $oldLookup[$name][$i]->Seq_in_index) && ((string) $newLookup[$name][$i]['Collation'] === $oldLookup[$name][$i]->Collation) && ((string) $newLookup[$name][$i]['Sub_part'] === $oldLookup[$name][$i]->Sub_part) && ((string) $newLookup[$name][$i]['Index_type'] === $oldLookup[$name][$i]->Index_type)); /* Debug. echo '<pre>'; echo '<br>Non_unique: '. ((string) $newLookup[$name][$i]['Non_unique'] == $oldLookup[$name][$i]->Non_unique ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Non_unique'].' vs '.$oldLookup[$name][$i]->Non_unique; echo '<br>Column_name: '. ((string) $newLookup[$name][$i]['Column_name'] == $oldLookup[$name][$i]->Column_name ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Column_name'].' vs '.$oldLookup[$name][$i]->Column_name; echo '<br>Seq_in_index: '. ((string) $newLookup[$name][$i]['Seq_in_index'] == $oldLookup[$name][$i]->Seq_in_index ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Seq_in_index'].' vs '.$oldLookup[$name][$i]->Seq_in_index; echo '<br>Collation: '. ((string) $newLookup[$name][$i]['Collation'] == $oldLookup[$name][$i]->Collation ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Collation'].' vs '.$oldLookup[$name][$i]->Collation; echo '<br>Sub_part: '. ((string) $newLookup[$name][$i]['Sub_part'] == $oldLookup[$name][$i]->Sub_part ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Sub_part'].' vs '.$oldLookup[$name][$i]->Sub_part; echo '<br>Index_type: '. ((string) $newLookup[$name][$i]['Index_type'] == $oldLookup[$name][$i]->Index_type ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Index_type'].' vs '.$oldLookup[$name][$i]->Index_type; echo '<br>Same = '.($same ? 'true' : 'false'); echo '</pre>'; */ if (!$same) { // Break out of the loop. No need to check further. break; } } } else { // Count is different, just drop and add. $same = false; } if (!$same) { $alters[] = $this->getDropKeySql($table, $name); $alters[] = $this->getAddKeySql($table, $keys); } // Unset this field so that what we have left are fields that need to be removed. unset($oldLookup[$name]); } else { // This is a new key. $alters[] = $this->getAddKeySql($table, $keys); } } // Any keys left are orphans. foreach ($oldLookup as $name => $keys) { if (strtoupper($name) === 'PRIMARY') { $alters[] = $this->getDropPrimaryKeySql($table); } else { $alters[] = $this->getDropKeySql($table, $name); } } return $alters; } /** * Get the syntax to alter a column. * * @param string $table The name of the database table to alter. * @param \SimpleXMLElement $field The XML definition for the field. * * @return string * * @since 1.0 */ protected function getChangeColumnSql($table, \SimpleXMLElement $field) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' CHANGE COLUMN ' . $this->db->quoteName((string) $field['Field']) . ' ' . $this->getColumnSql($field); } /** * Get the SQL syntax for a single column that would be included in a table create or alter statement. * * @param \SimpleXMLElement $field The XML field definition. * * @return string * * @since 1.0 */ protected function getColumnSql(\SimpleXMLElement $field) { // Initialise variables. // TODO Incorporate into parent class and use $this. $blobs = ['text', 'smalltext', 'mediumtext', 'largetext']; $fName = (string) $field['Field']; $fType = (string) $field['Type']; $fNull = (string) $field['Null']; $fDefault = isset($field['Default']) ? (string) $field['Default'] : null; $fExtra = (string) $field['Extra']; $sql = $this->db->quoteName($fName) . ' ' . $fType; if ($fNull === 'NO') { if ($fDefault === null || \in_array($fType, $blobs, true)) { $sql .= ' NOT NULL'; } else { // TODO Don't quote numeric values. if (stristr($fDefault, 'CURRENT') !== false) { $sql .= ' NOT NULL DEFAULT CURRENT_TIMESTAMP()'; } else { $sql .= ' NOT NULL DEFAULT ' . $this->db->quote($fDefault); } } } else { if ($fDefault === null) { $sql .= ' DEFAULT NULL'; } else { // TODO Don't quote numeric values. $sql .= ' DEFAULT ' . $this->db->quote($fDefault); } } if ($fExtra) { // MySql 8.0 introduces DEFAULT_GENERATED in the extra column and should be replaced with the default value if (stristr($fExtra, 'DEFAULT_GENERATED') !== false) { $sql .= ' ' . strtoupper(str_ireplace('DEFAULT_GENERATED', 'DEFAULT ' . $fDefault, $fExtra)); } else { $sql .= ' ' . strtoupper($fExtra); } } return $sql; } /** * Get the SQL syntax to drop a key. * * @param string $table The table name. * @param string $name The name of the key to drop. * * @return string * * @since 1.0 */ protected function getDropKeySql($table, $name) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' DROP KEY ' . $this->db->quoteName($name); } /** * Get the SQL syntax to drop a key. * * @param string $table The table name. * * @return string * * @since 1.0 */ protected function getDropPrimaryKeySql($table) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' DROP PRIMARY KEY'; } /** * Get the details list of keys for a table. * * @param array $keys An array of objects that comprise the keys for the table. * * @return array The lookup array. array({key name} => array(object, ...)) * * @since 1.0 * @throws \Exception */ protected function getKeyLookup($keys) { // First pass, create a lookup of the keys. $lookup = []; foreach ($keys as $key) { if ($key instanceof \SimpleXMLElement) { $kName = (string) $key['Key_name']; } else { $kName = $key->Key_name; } if (empty($lookup[$kName])) { $lookup[$kName] = []; } $lookup[$kName][] = $key; } return $lookup; } /** * Get the SQL syntax for a key. * * @param array $columns An array of SimpleXMLElement objects comprising the key. * * @return string * * @since 1.0 */ protected function getKeySql($columns) { $kNonUnique = (string) $columns[0]['Non_unique']; $kName = (string) $columns[0]['Key_name']; $prefix = ''; if ($kName === 'PRIMARY') { $prefix = 'PRIMARY '; } elseif ($kNonUnique == 0) { $prefix = 'UNIQUE '; } $kColumns = []; foreach ($columns as $column) { $kLength = ''; if (!empty($column['Sub_part'])) { $kLength = '(' . $column['Sub_part'] . ')'; } $kColumns[] = $this->db->quoteName((string) $column['Column_name']) . $kLength; } return $prefix . 'KEY ' . ($kName !== 'PRIMARY' ? $this->db->quoteName($kName) : '') . ' (' . implode(',', $kColumns) . ')'; } /** * Get the SQL syntax to add a table. * * @param \SimpleXMLElement $table The table information. * * @return string * * @since 2.0.0 * @throws \RuntimeException */ protected function xmlToCreate(\SimpleXMLElement $table) { $existingTables = $this->db->getTableList(); $tableName = (string) $table['name']; if (\in_array($tableName, $existingTables)) { throw new \RuntimeException('The table you are trying to create already exists'); } $createTableStatement = 'CREATE TABLE ' . $this->db->quoteName($tableName) . ' ('; foreach ($table->xpath('field') as $field) { $createTableStatement .= $this->getColumnSql($field) . ', '; } $newLookup = $this->getKeyLookup($table->xpath('key')); foreach ($newLookup as $key) { $createTableStatement .= $this->getKeySql($key) . ', '; } $createTableStatement = rtrim($createTableStatement, ', '); $createTableStatement .= ')'; return $createTableStatement; } } PK c�\���� � $ database/src/Mysql/MysqlExporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysql; use Joomla\Database\DatabaseExporter; /** * MySQL Database Exporter. * * @since 1.0 */ class MysqlExporter extends DatabaseExporter { /** * Builds the XML data for the tables to export. * * @return string An XML string * * @since 1.0 * @throws \Exception if an error occurs. */ protected function buildXml() { $buffer = []; $buffer[] = '<?xml version="1.0"?>'; $buffer[] = '<mysqldump xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">'; $buffer[] = ' <database name="">'; if ($this->options->withStructure) { $buffer = array_merge($buffer, $this->buildXmlStructure()); } if ($this->options->withData) { $buffer = array_merge($buffer, $this->buildXmlData()); } $buffer[] = ' </database>'; $buffer[] = '</mysqldump>'; return implode("\n", $buffer); } /** * Builds the XML structure to export. * * @return array An array of XML lines (strings). * * @since 1.0 * @throws \Exception if an error occurs. */ protected function buildXmlStructure() { $buffer = []; foreach ($this->from as $table) { // Replace the magic prefix if found. $table = $this->getGenericTableName($table); // Get the details columns information. $fields = $this->db->getTableColumns($table, false); $keys = $this->db->getTableKeys($table); $buffer[] = ' <table_structure name="' . $table . '">'; foreach ($fields as $field) { $buffer[] = ' <field Field="' . $field->Field . '" Type="' . $field->Type . '" Null="' . $field->Null . '" Key="' . $field->Key . '"' . (isset($field->Default) ? ' Default="' . $field->Default . '"' : '') . ' Extra="' . $field->Extra . '"' . ' />'; } foreach ($keys as $key) { $buffer[] = ' <key Table="' . $table . '" Non_unique="' . $key->Non_unique . '" Key_name="' . $key->Key_name . '"' . ' Seq_in_index="' . $key->Seq_in_index . '" Column_name="' . $key->Column_name . '" Collation="' . $key->Collation . '"' . ' Null="' . $key->Null . '" Index_type="' . $key->Index_type . '"' . ' Sub_part="' . $key->Sub_part . '"' . ' Comment="' . htmlspecialchars($key->Comment, \ENT_COMPAT, 'UTF-8') . '"' . ' />'; } $buffer[] = ' </table_structure>'; } return $buffer; } /** * Checks if all data and options are in order prior to exporting. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function check() { // Check if the db connector has been set. if (!($this->db instanceof MysqlDriver)) { throw new \RuntimeException('Database connection wrong type.'); } // Check if the tables have been specified. if (empty($this->from)) { throw new \RuntimeException('ERROR: No Tables Specified'); } return $this; } } PK c�\��TO� � & database/src/QueryMonitorInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Interface defining a query monitor. * * @since 2.0.0 */ interface QueryMonitorInterface { /** * Act on a query being started. * * @param string $sql The SQL to be executed. * @param object[]|null $boundParams List of bound params, used with the query. * Each item is an object that holds: value, dataType * * @return void * * @since 2.0.0 */ public function startQuery(string $sql, ?array $boundParams = null): void; /** * Act on a query being stopped. * * @return void * * @since 2.0.0 */ public function stopQuery(): void; } PK c�\ �m ! database/src/DatabaseIterator.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Joomla Framework Database Driver Class * * @since 1.0 */ class DatabaseIterator implements \Countable, \Iterator { /** * The class of object to create. * * @var string * @since 1.0 */ protected $class; /** * The name of the column to use for the key of the database record. * * @var mixed * @since 1.0 */ private $column; /** * The current database record. * * @var mixed * @since 1.0 */ private $current; /** * A numeric or string key for the current database record. * * @var scalar * @since 1.0 */ private $key; /** * The number of fetched records. * * @var integer * @since 1.0 */ private $fetched = 0; /** * The statement holding the result set to iterate. * * @var StatementInterface * @since 1.0 */ protected $statement; /** * Database iterator constructor. * * @param StatementInterface $statement The statement holding the result set to iterate. * @param string $column An option column to use as the iterator key. * @param string $class The class of object that is returned. * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct(StatementInterface $statement, $column = null, $class = \stdClass::class) { if (!class_exists($class)) { throw new \InvalidArgumentException(sprintf('new %s(*%s*, cursor)', \get_class($this), \gettype($class))); } if ($statement) { $fetchMode = $class === \stdClass::class ? FetchMode::STANDARD_OBJECT : FetchMode::CUSTOM_OBJECT; // PDO doesn't allow extra arguments for \PDO::FETCH_CLASS, so only forward the class for the custom object mode if ($fetchMode === FetchMode::STANDARD_OBJECT) { $statement->setFetchMode($fetchMode); } else { $statement->setFetchMode($fetchMode, $class); } } $this->statement = $statement; $this->class = $class; $this->column = $column; $this->fetched = 0; $this->next(); } /** * Database iterator destructor. * * @since 1.0 */ public function __destruct() { if ($this->statement) { $this->freeResult(); } } /** * Get the number of rows in the result set for the executed SQL given by the cursor. * * @return integer The number of rows in the result set. * * @see Countable::count() * @since 1.0 */ #[\ReturnTypeWillChange] public function count() { if ($this->statement) { return $this->statement->rowCount(); } return 0; } /** * The current element in the iterator. * * @return object * * @see Iterator::current() * @since 1.0 */ #[\ReturnTypeWillChange] public function current() { return $this->current; } /** * The key of the current element in the iterator. * * @return scalar * * @see Iterator::key() * @since 1.0 */ #[\ReturnTypeWillChange] public function key() { return $this->key; } /** * Moves forward to the next result from the SQL query. * * @return void * * @see Iterator::next() * @since 1.0 */ #[\ReturnTypeWillChange] public function next() { // Set the default key as being the number of fetched object $this->key = $this->fetched; // Try to get an object $this->current = $this->fetchObject(); // If an object has been found if ($this->current) { // Set the key as being the indexed column (if it exists) if ($this->column && isset($this->current->{$this->column})) { $this->key = $this->current->{$this->column}; } // Update the number of fetched object $this->fetched++; } } /** * Rewinds the iterator. * * This iterator cannot be rewound. * * @return void * * @see Iterator::rewind() * @since 1.0 */ #[\ReturnTypeWillChange] public function rewind() { } /** * Checks if the current position of the iterator is valid. * * @return boolean * * @see Iterator::valid() * @since 1.0 */ #[\ReturnTypeWillChange] public function valid() { return (boolean) $this->current; } /** * Method to fetch a row from the result set cursor as an object. * * @return mixed Either the next row from the result set or false if there are no more rows. * * @since 1.0 */ protected function fetchObject() { if ($this->statement) { return $this->statement->fetch(); } return false; } /** * Method to free up the memory used for the result set. * * @return void * * @since 1.0 */ protected function freeResult() { if ($this->statement) { $this->statement->closeCursor(); } } } PK c�\x eG& & ) database/src/Service/DatabaseProvider.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Service; use Joomla\Database\DatabaseDriver; use Joomla\Database\DatabaseFactory; use Joomla\Database\DatabaseInterface; use Joomla\DI\Container; use Joomla\DI\ServiceProviderInterface; /** * Database service provider * * @since 2.0.0 */ class DatabaseProvider implements ServiceProviderInterface { /** * Registers the service provider with a DI container. * * @param Container $container The DI container. * * @return void * * @since 2.0.0 */ public function register(Container $container) { $container->alias(DatabaseInterface::class, DatabaseDriver::class) ->share( DatabaseDriver::class, function (Container $container) { /** @var \Joomla\Registry\Registry $config */ $config = $container->get('config'); $options = (array) $config->get('database'); return $container->get(DatabaseFactory::class)->getDriver($options['driver'], $options); } ); $container->share( DatabaseFactory::class, function (Container $container) { return new DatabaseFactory; } ); } } PK c�\X��R8 8 ' database/src/DatabaseAwareInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Defines the interface for a DatabaseInterface aware class. * * @since 2.1.0 */ interface DatabaseAwareInterface { /** * Set the database. * * @param DatabaseInterface $db The database. * * @return void * * @since 2.1.0 */ public function setDatabase(DatabaseInterface $db): void; } PK c�\����s s $ database/src/Mysqli/MysqliDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysqli; use Joomla\Database\DatabaseDriver; use Joomla\Database\DatabaseEvents; use Joomla\Database\Event\ConnectionEvent; use Joomla\Database\Exception\ConnectionFailureException; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\Exception\PrepareStatementFailureException; use Joomla\Database\Exception\UnsupportedAdapterException; use Joomla\Database\StatementInterface; use Joomla\Database\UTF8MB4SupportInterface; /** * MySQLi Database Driver * * @link https://www.php.net/manual/en/book.mysqli.php * @since 1.0 */ class MysqliDriver extends DatabaseDriver implements UTF8MB4SupportInterface { /** * The database connection resource. * * @var \mysqli * @since 1.0 */ protected $connection; /** * The name of the database driver. * * @var string * @since 1.0 */ public $name = 'mysqli'; /** * The character(s) used to quote SQL statement names such as table names or field names, etc. * * 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 = '`'; /** * The null or zero representation of a timestamp for the database driver. * * @var string * @since 1.0 */ protected $nullDate = '0000-00-00 00:00:00'; /** * True if the database engine supports UTF-8 Multibyte (utf8mb4) character encoding. * * @var boolean * @since 1.4.0 */ protected $utf8mb4 = false; /** * True if the database engine is MariaDB. * * @var boolean * @since 2.0.0 */ protected $mariadb = false; /** * The minimum supported MySQL database version. * * @var string * @since 1.0 */ protected static $dbMinimum = '5.6'; /** * The minimum supported MariaDB database version. * * @var string * @since 2.0.0 */ protected static $dbMinMariadb = '10.0'; /** * Constructor. * * @param array $options List of options used to configure the connection * * @since 1.0 */ public function __construct(array $options) { /** * sql_mode to MySql 5.7.8+ default strict mode minus ONLY_FULL_GROUP_BY * * @link https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-8.html#mysqld-5-7-8-sql-mode */ $sqlModes = [ 'STRICT_TRANS_TABLES', 'ERROR_FOR_DIVISION_BY_ZERO', 'NO_ENGINE_SUBSTITUTION', ]; // Get some basic values from the options. $options['host'] = $options['host'] ?? 'localhost'; $options['user'] = $options['user'] ?? 'root'; $options['password'] = $options['password'] ?? ''; $options['database'] = $options['database'] ?? ''; $options['select'] = isset($options['select']) ? (bool) $options['select'] : true; $options['port'] = isset($options['port']) ? (int) $options['port'] : null; $options['socket'] = $options['socket'] ?? null; $options['utf8mb4'] = isset($options['utf8mb4']) ? (bool) $options['utf8mb4'] : false; $options['sqlModes'] = isset($options['sqlModes']) ? (array) $options['sqlModes'] : $sqlModes; $options['ssl'] = isset($options['ssl']) ? $options['ssl'] : []; if ($options['ssl'] !== []) { $options['ssl']['enable'] = isset($options['ssl']['enable']) ? $options['ssl']['enable'] : false; $options['ssl']['cipher'] = isset($options['ssl']['cipher']) ? $options['ssl']['cipher'] : null; $options['ssl']['ca'] = isset($options['ssl']['ca']) ? $options['ssl']['ca'] : null; $options['ssl']['capath'] = isset($options['ssl']['capath']) ? $options['ssl']['capath'] : null; $options['ssl']['key'] = isset($options['ssl']['key']) ? $options['ssl']['key'] : null; $options['ssl']['cert'] = isset($options['ssl']['cert']) ? $options['ssl']['cert'] : null; $options['ssl']['verify_server_cert'] = isset($options['ssl']['verify_server_cert']) ? $options['ssl']['verify_server_cert'] : null; } // Finalize initialisation. parent::__construct($options); } /** * Check if the database server is responsive. * * @param string $host The host name or IP address. * @param int $port The port number. Optional; default is the MySQL default. * @param int $initialWaitInSeconds The number of seconds to wait before pinging the server. Optional; default is 0 seconds. * @param int $intervalWaitInSeconds The number of seconds to wait between pinging the server. Optional; default is 3 seconds. * @param int $timeoutInSeconds The timeout in seconds for the server to respond. Optional; default is 1 second. * @param int $retries The number of retries. Optional; default is 3. * * @return boolean * @todo This should maybe be moved to the parent class. * */ public function healthCheck(string $host, int $port = 3306, int $initialWaitInSeconds = 0, int $intervalWaitInSeconds = 3, int $timeoutInSeconds = 1, int $retries = 3 ): bool { sleep($initialWaitInSeconds); for ($i = 0; $i < $retries; $i++) { $file = @fsockopen($host, $port, $errno, $errstr, $timeoutInSeconds); if ($file) { fclose($file); return true; } sleep($intervalWaitInSeconds); } return false; } /** * Connects to the database if needed. * * @return void Returns void if the database connected successfully. * * @since 1.0 * @throws \RuntimeException */ public function connect() { if ($this->connection) { return; } // Make sure the MySQLi extension for PHP is installed and enabled. if (!static::isSupported()) { throw new UnsupportedAdapterException('The MySQLi extension is not available'); } /* * Unlike mysql_connect(), mysqli_connect() takes the port and socket as separate arguments. Therefore, we * have to extract them from the host string. */ $port = isset($this->options['port']) ? $this->options['port'] : 3306; if (preg_match('/^unix:(?P<socket>[^:]+)$/', $this->options['host'], $matches)) { // UNIX socket URI, e.g. 'unix:/path/to/unix/socket.sock' $this->options['host'] = null; $this->options['socket'] = $matches['socket']; $this->options['port'] = null; } elseif (preg_match( '/^(?P<host>((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<port>.+))?$/', $this->options['host'], $matches )) { // It's an IPv4 address with or without port $this->options['host'] = $matches['host']; if (!empty($matches['port'])) { $port = $matches['port']; } } elseif (preg_match('/^(?P<host>\[.*\])(:(?P<port>.+))?$/', $this->options['host'], $matches)) { // We assume square-bracketed IPv6 address with or without port, e.g. [fe80:102::2%eth1]:3306 $this->options['host'] = $matches['host']; if (!empty($matches['port'])) { $port = $matches['port']; } } elseif (preg_match('/^(?P<host>(\w+:\/{2,3})?[a-z0-9\.\-]+)(:(?P<port>[^:]+))?$/i', $this->options['host'], $matches)) { // Named host (e.g example.com or localhost) with or without port $this->options['host'] = $matches['host']; if (!empty($matches['port'])) { $port = $matches['port']; } } elseif (preg_match('/^:(?P<port>[^:]+)$/', $this->options['host'], $matches)) { // Empty host, just port, e.g. ':3306' $this->options['host'] = 'localhost'; $port = $matches['port']; } // ... else we assume normal (naked) IPv6 address, so host and port stay as they are or default // Get the port number or socket name if (is_numeric($port)) { $this->options['port'] = (int) $port; } else { $this->options['socket'] = $port; } $this->connection = mysqli_init(); $connectionFlags = 0; // For SSL/TLS connection encryption. if ($this->options['ssl'] !== [] && $this->options['ssl']['enable'] === true) { $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->options['ssl']['verify_server_cert'])) { // New constants in PHP 5.6.16+. See https://www.php.net/ChangeLog-5.php#5.6.16 if ($this->options['ssl']['verify_server_cert'] === true && defined('MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT')) { $connectionFlags += MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT; } elseif ($this->options['ssl']['verify_server_cert'] === false && defined('MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT')) { $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->options['ssl']['verify_server_cert']); } } // Add SSL/TLS options only if changed. $this->connection->ssl_set( $this->options['ssl']['key'], $this->options['ssl']['cert'], $this->options['ssl']['ca'], $this->options['ssl']['capath'], $this->options['ssl']['cipher'] ); } // Attempt to connect to the server, use error suppression to silence warnings and allow us to throw an Exception separately. $connected = @$this->connection->real_connect( $this->options['host'], $this->options['user'], $this->options['password'], null, $this->options['port'], $this->options['socket'], $connectionFlags ); if (!$connected) { throw new ConnectionFailureException( 'Could not connect to database: ' . $this->connection->connect_error, $this->connection->connect_errno ); } // If needed, set the sql modes. if ($this->options['sqlModes'] !== []) { $this->connection->query('SET @@SESSION.sql_mode = \'' . implode(',', $this->options['sqlModes']) . '\';'); } // And read the real sql mode to mitigate changes in mysql > 5.7.+ $this->options['sqlModes'] = explode(',', $this->setQuery('SELECT @@SESSION.sql_mode;')->loadResult()); // If auto-select is enabled select the given database. if ($this->options['select'] && !empty($this->options['database'])) { $this->select($this->options['database']); } $this->mariadb = stripos($this->connection->server_info, 'mariadb') !== false; $this->utf8mb4 = $this->serverClaimsUtf8mb4Support(); // Set character sets (needed for MySQL 4.1.2+ and MariaDB). $this->utf = $this->setUtf(); $this->dispatchEvent(new ConnectionEvent(DatabaseEvents::POST_CONNECT, $this)); } /** * Automatically downgrade a CREATE TABLE or ALTER TABLE query from utf8mb4 (UTF-8 Multibyte) to plain utf8. * * Used when the server doesn't support UTF-8 Multibyte. * * @param string $query The query to convert * * @return string The converted query * * @since 1.4.0 */ public function convertUtf8mb4QueryToUtf8($query) { if ($this->utf8mb4) { return $query; } // If it's not an ALTER TABLE or CREATE TABLE command there's nothing to convert if (!preg_match('/^(ALTER|CREATE)\s+TABLE\s+/i', $query)) { return $query; } // Don't do preg replacement if string does not exist if (stripos($query, 'utf8mb4') === false) { return $query; } // Replace utf8mb4 with utf8 if not within single or double quotes or name quotes return preg_replace('/[`"\'][^`"\']*[`"\'](*SKIP)(*FAIL)|utf8mb4/i', 'utf8', $query); } /** * Disconnects the database. * * @return void * * @since 1.0 */ public function disconnect() { // Close the connection. if (\is_callable($this->connection, 'close')) { $this->connection->close(); } parent::disconnect(); } /** * 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. * * @since 1.0 */ public function escape($text, $extra = false) { if (\is_int($text)) { return $text; } if (\is_float($text)) { // Force the dot as a decimal point. return str_replace(',', '.', (string) $text); } $this->connect(); $result = $this->connection->real_escape_string((string) $text); if ($extra) { $result = addcslashes($result, '%_'); } return $result; } /** * Test to see if the MySQLi connector is available. * * @return boolean True on success, false otherwise. * * @since 1.0 */ public static function isSupported() { return \extension_loaded('mysqli'); } /** * Determines if the connection to the server is active. * * @return boolean True if connected to the database engine. * * @since 1.0 */ public function connected() { if (\is_object($this->connection)) { return $this->connection->ping(); } return false; } /** * 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 * * @since 2.0.0 */ public function getAlterDbCharacterSet($dbName) { $charset = $this->utf8mb4 ? 'utf8mb4' : 'utf8'; return 'ALTER DATABASE ' . $this->quoteName($dbName) . ' CHARACTER SET `' . $charset . '`'; } /** * Method to get the database collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database (string) or boolean false if not supported. * * @since 1.0 * @throws \RuntimeException */ public function getCollation() { $this->connect(); return $this->setQuery('SELECT @@collation_database;')->loadResult(); } /** * Method to get the database connection collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database connection (string) or boolean false if not supported. * * @since 1.6.0 * @throws \RuntimeException */ public function getConnectionCollation() { $this->connect(); return $this->setQuery('SELECT @@collation_connection;')->loadResult(); } /** * Method to get the database encryption details (cipher and protocol) in use. * * @return string The database encryption details. * * @since 2.0.0 * @throws \RuntimeException */ public function getConnectionEncryption(): string { $this->connect(); $variables = $this->setQuery('SHOW SESSION STATUS WHERE `Variable_name` IN (\'Ssl_version\', \'Ssl_cipher\')') ->loadObjectList('Variable_name'); if (!empty($variables['Ssl_cipher']->Value)) { return $variables['Ssl_version']->Value . ' (' . $variables['Ssl_cipher']->Value . ')'; } return ''; } /** * Method to test if the database TLS connections encryption are supported. * * @return boolean Whether the database supports TLS connections encryption. * * @since 2.0.0 */ public function isConnectionEncryptionSupported(): bool { $this->connect(); $variables = $this->setQuery('SHOW SESSION VARIABLES WHERE `Variable_name` IN (\'have_ssl\')')->loadObjectList('Variable_name'); return !empty($variables['have_ssl']->Value) && $variables['have_ssl']->Value === 'YES'; } /** * Return the query string to create new Database. * * @param \stdClass $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 * * @since 2.0.0 */ protected function getCreateDatabaseQuery($options, $utf) { if ($utf) { $charset = $this->utf8mb4 ? 'utf8mb4' : 'utf8'; $collation = $charset . '_unicode_ci'; return 'CREATE DATABASE ' . $this->quoteName($options->db_name) . ' CHARACTER SET `' . $charset . '` COLLATE `' . $collation . '`'; } return 'CREATE DATABASE ' . $this->quoteName($options->db_name); } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableCreate($tables) { $this->connect(); $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. $row = $this->setQuery('SHOW CREATE TABLE ' . $this->quoteName($this->escape($table)))->loadRow(); // Populate the result array based on the create statements. $result[$table] = $row[1]; } return $result; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableColumns($table, $typeOnly = true) { $this->connect(); $result = []; // Set the query to get the table fields statement. $fields = $this->setQuery('SHOW FULL COLUMNS FROM ' . $this->quoteName($this->escape($table)))->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); } } else { // If we want the whole field data object add that to the list. foreach ($fields as $field) { $result[$field->Field] = $field; } } 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableKeys($table) { $this->connect(); // Get the details columns information. return $this->setQuery('SHOW KEYS FROM ' . $this->quoteName($table))->loadObjectList(); } /** * Method to get an array of all tables in the database. * * @return array An array of all the tables in the database. * * @since 1.0 * @throws \RuntimeException */ public function getTableList() { $this->connect(); // Set the query to get the tables statement. return $this->setQuery('SHOW TABLES')->loadColumn(); } /** * Get the version of the database connector. * * @return string The database connector version. * * @since 1.0 */ public function getVersion() { $this->connect(); if ($this->mariadb) { // MariaDB: Strip off any leading '5.5.5-', if present return preg_replace('/^5\.5\.5-/', '', $this->connection->server_info); } return $this->connection->server_info; } /** * Get the minimum supported database version. * * @return string * * @since 2.0.0 */ public function getMinimum() { return $this->mariadb ? static::$dbMinMariadb : static::$dbMinimum; } /** * Determine whether the database engine support the UTF-8 Multibyte (utf8mb4) character encoding. * * @return boolean True if the database engine supports UTF-8 Multibyte. * * @since 2.0.0 */ public function hasUTF8mb4Support() { return $this->utf8mb4; } /** * Determine if the database engine is MariaDB. * * @return boolean * * @since 2.0.0 */ public function isMariaDb(): bool { $this->connect(); return $this->mariadb; } /** * Method to get the auto-incremented value from the last INSERT statement. * * @return mixed The value of the auto-increment field from the last inserted row. * If the value is greater than maximal int value, it will return a string. * * @since 1.0 */ public function insertid() { $this->connect(); return $this->connection->insert_id; } /** * 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 * * @since 2.0.0 * @throws \RuntimeException */ public function insertObject($table, &$object, $key = null) { $fields = []; $values = []; $tableColumns = $this->getTableColumns($table); // Iterate over the object variables to build the query fields and values. foreach (get_object_vars($object) as $k => $v) { // Skip columns that don't exist in the table. if (!array_key_exists($k, $tableColumns)) { continue; } // Only process non-null scalars. if (\is_array($v) || \is_object($v) || $v === null) { continue; } // Ignore any internal fields. if ($k[0] === '_') { continue; } // Ignore null datetime fields. if ($tableColumns[$k] === 'datetime' && empty($v)) { continue; } // Ignore null integer fields. if (stristr($tableColumns[$k], 'int') !== false && $v === '') { 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->createQuery() ->insert($this->quoteName($table)) ->columns($fields) ->values(implode(',', $values)); // Set the query and execute the insert. $this->setQuery($query)->execute(); // Update the primary key if it exists. $id = $this->insertid(); if ($key && $id && \is_string($key)) { $object->$key = $id; } return true; } /** * Locks a table in the database. * * @param string $table The name of the table to unlock. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function lockTable($table) { $this->executeUnpreparedQuery($this->replacePrefix('LOCK TABLES ' . $this->quoteName($table) . ' WRITE')); return $this; } /** * 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 $this * * @since 1.0 * @throws \RuntimeException */ public function renameTable($oldTable, $newTable, $backup = null, $prefix = null) { $this->setQuery('RENAME TABLE ' . $oldTable . ' 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. * * @since 1.0 * @throws \RuntimeException */ public function select($database) { $this->connect(); if (!$database) { return false; } if (!$this->connection->select_db($database)) { throw new ConnectionFailureException('Could not connect to database.'); } return true; } /** * Set the connection to use UTF-8 character encoding. * * @return boolean True on success. * * @since 1.0 */ public function setUtf() { // If UTF is not supported return false immediately if (!$this->utf) { return false; } // Make sure we're connected to the server $this->connect(); // Which charset should I use, plain utf8 or multibyte utf8mb4? $charset = $this->utf8mb4 && $this->options['utf8mb4'] ? 'utf8mb4' : 'utf8'; $result = @$this->connection->set_charset($charset); /* * If I could not set the utf8mb4 charset then the server doesn't support utf8mb4 despite claiming otherwise. This happens on old MySQL * server versions (less than 5.5.3) using the mysqlnd PHP driver. Since mysqlnd masks the server version and reports only its own we * can not be sure if the server actually does support UTF-8 Multibyte (i.e. it's MySQL 5.5.3 or later). Since the utf8mb4 charset is * undefined in this case we catch the error and determine that utf8mb4 is not supported! */ if (!$result && $this->utf8mb4 && $this->options['utf8mb4']) { $this->utf8mb4 = false; $result = @$this->connection->set_charset('utf8'); } return $result; } /** * Method to commit a transaction. * * @param boolean $toSavepoint If true, commit to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionCommit($toSavepoint = false) { if (!$toSavepoint || $this->transactionDepth <= 1) { $this->connect(); if ($this->connection->commit()) { $this->transactionDepth = 0; } return; } $this->transactionDepth--; } /** * Method to roll back a transaction. * * @param boolean $toSavepoint If true, rollback to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionRollback($toSavepoint = false) { if (!$toSavepoint || $this->transactionDepth <= 1) { $this->connect(); if ($this->connection->rollback()) { $this->transactionDepth = 0; } return; } $savepoint = 'SP_' . ($this->transactionDepth - 1); if ($this->executeUnpreparedQuery('ROLLBACK TO SAVEPOINT ' . $this->quoteName($savepoint))) { $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 * * @since 1.0 * @throws \RuntimeException */ public function transactionStart($asSavepoint = false) { $this->connect(); if (!$asSavepoint || !$this->transactionDepth) { if ($this->connection->begin_transaction()) { $this->transactionDepth = 1; } return; } $savepoint = 'SP_' . $this->transactionDepth; if ($this->connection->savepoint($savepoint)) { $this->transactionDepth++; } } /** * Internal method to execute queries which cannot be run as prepared statements. * * @param string $sql SQL statement to execute. * * @return boolean * * @since 1.5.0 */ protected function executeUnpreparedQuery($sql) { $this->connect(); $cursor = $this->connection->query($sql); // If an error occurred handle it. if (!$cursor) { $errorNum = (int) $this->connection->errno; $errorMsg = (string) $this->connection->error; // Check if the server was disconnected. if (!$this->connected()) { try { // Attempt to reconnect. $this->connection = null; $this->connect(); } catch (ConnectionFailureException $e) { // If connect fails, ignore that exception and throw the normal exception. throw new ExecutionFailureException($sql, $errorMsg, $errorNum); } // Since we were able to reconnect, run the query again. return $this->executeUnpreparedQuery($sql); } // The server was not disconnected. throw new ExecutionFailureException($sql, $errorMsg, $errorNum); } $this->freeResult(); if ($cursor instanceof \mysqli_result) { $cursor->free_result(); } return true; } /** * Prepares a SQL statement for execution * * @param string $query The SQL query to be prepared. * * @return StatementInterface * * @since 2.0.0 * @throws PrepareStatementFailureException */ protected function prepareStatement(string $query): StatementInterface { return new MysqliStatement($this->connection, $query); } /** * Unlocks tables in the database. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function unlockTables() { $this->executeUnpreparedQuery('UNLOCK TABLES'); return $this; } /** * Does the database server claim to have support for UTF-8 Multibyte (utf8mb4) collation? * * libmysql supports utf8mb4 since 5.5.3 (same version as the MySQL server). mysqlnd supports utf8mb4 since 5.0.9. * * @return boolean * * @since 1.4.0 */ private function serverClaimsUtf8mb4Support() { $client_version = mysqli_get_client_info(); $server_version = $this->getVersion(); if (version_compare($server_version, '5.5.3', '<')) { return false; } if ($this->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', '>='); } /** * Get the null or zero representation of a timestamp for the database driver. * * @return string * * @since 2.0.0 */ public function getNullDate() { // Check the session sql mode; if (\in_array('NO_ZERO_DATE', $this->options['sqlModes']) !== false) { $this->nullDate = '1000-01-01 00:00:00'; } return $this->nullDate; } } PK c�\e�Bl� � & database/src/Mysqli/MysqliExporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysqli; use Joomla\Database\DatabaseExporter; /** * MySQLi Database Exporter. * * @since 1.0 */ class MysqliExporter extends DatabaseExporter { /** * Builds the XML data for the tables to export. * * @return string An XML string * * @since 1.0 * @throws \Exception if an error occurs. */ protected function buildXml() { $buffer = []; $buffer[] = '<?xml version="1.0"?>'; $buffer[] = '<mysqldump xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">'; $buffer[] = ' <database name="">'; if ($this->options->withStructure) { $buffer = array_merge($buffer, $this->buildXmlStructure()); } if ($this->options->withData) { $buffer = array_merge($buffer, $this->buildXmlData()); } $buffer[] = ' </database>'; $buffer[] = '</mysqldump>'; return implode("\n", $buffer); } /** * Builds the XML structure to export. * * @return array An array of XML lines (strings). * * @since 1.0 * @throws \Exception if an error occurs. */ protected function buildXmlStructure() { $buffer = []; foreach ($this->from as $table) { // Replace the magic prefix if found. $table = $this->getGenericTableName($table); // Get the details columns information. $fields = $this->db->getTableColumns($table, false); $keys = $this->db->getTableKeys($table); $buffer[] = ' <table_structure name="' . $table . '">'; foreach ($fields as $field) { $buffer[] = ' <field Field="' . $field->Field . '" Type="' . $field->Type . '" Null="' . $field->Null . '" Key="' . $field->Key . '"' . (isset($field->Default) ? ' Default="' . $field->Default . '"' : '') . ' Extra="' . $field->Extra . '"' . ' />'; } foreach ($keys as $key) { $buffer[] = ' <key Table="' . $table . '" Non_unique="' . $key->Non_unique . '" Key_name="' . $key->Key_name . '"' . ' Seq_in_index="' . $key->Seq_in_index . '" Column_name="' . $key->Column_name . '" Collation="' . $key->Collation . '"' . ' Null="' . $key->Null . '" Index_type="' . $key->Index_type . '"' . ' Sub_part="' . $key->Sub_part . '"' . ' Comment="' . htmlspecialchars($key->Comment, \ENT_COMPAT, 'UTF-8') . '"' . ' />'; } $buffer[] = ' </table_structure>'; } return $buffer; } /** * Checks if all data and options are in order prior to exporting. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function check() { // Check if the db connector has been set. if (!($this->db instanceof MysqliDriver)) { throw new \RuntimeException('Database connection wrong type.'); } // Check if the tables have been specified. if (empty($this->from)) { throw new \RuntimeException('ERROR: No Tables Specified'); } return $this; } } PK c�\RH �9 �9 ' database/src/Mysqli/MysqliStatement.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysqli; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\Exception\PrepareStatementFailureException; use Joomla\Database\FetchMode; use Joomla\Database\FetchOrientation; use Joomla\Database\ParameterType; use Joomla\Database\StatementInterface; /** * MySQLi Database Statement. * * This class is modeled on \Doctrine\DBAL\Driver\Mysqli\MysqliStatement * * @since 2.0.0 */ class MysqliStatement implements StatementInterface { /** * Values which have been bound to the statement. * * @var array * @since 2.0.0 */ protected $bindedValues; /** * Mapping between named parameters and position in query. * * @var array * @since 2.0.0 */ protected $parameterKeyMapping; /** * Mapping array for parameter types. * * @var array * @since 2.0.0 */ protected $parameterTypeMapping = [ ParameterType::BOOLEAN => 'i', ParameterType::INTEGER => 'i', ParameterType::LARGE_OBJECT => 's', ParameterType::NULL => 's', ParameterType::STRING => 's', ]; /** * Column names from the executed statement. * * @var array|boolean|null * @since 2.0.0 */ protected $columnNames; /** * The database connection resource. * * @var \mysqli * @since 2.0.0 */ protected $connection; /** * The default fetch mode for the statement. * * @var integer * @since 2.0.0 */ protected $defaultFetchStyle = FetchMode::MIXED; /** * The query string being prepared. * * @var string * @since 2.0.0 */ protected $query; /** * Internal tracking flag to set whether there is a result set available for processing * * @var boolean * @since 2.0.0 */ private $result = false; /** * Values which have been bound to the rows of each result set. * * @var array * @since 2.0.0 */ protected $rowBindedValues; /** * The prepared statement. * * @var \mysqli_stmt * @since 2.0.0 */ protected $statement; /** * Bound parameter types. * * @var array * @since 2.0.0 */ protected $typesKeyMapping; /** * Constructor. * * @param \mysqli $connection The database connection resource * @param string $query The query this statement will process * * @since 2.0.0 * @throws PrepareStatementFailureException */ public function __construct(\mysqli $connection, string $query) { $this->connection = $connection; $this->query = $query; $query = $this->prepareParameterKeyMapping($query); $this->statement = $connection->prepare($query); if (!$this->statement) { throw new PrepareStatementFailureException($this->connection->error, $this->connection->errno); } } /** * Replace named parameters with numbered parameters * * @param string $sql The SQL statement to prepare. * * @return string The processed SQL statement. * * @since 2.0.0 */ public function prepareParameterKeyMapping($sql) { $escaped = false; $startPos = 0; $quoteChar = ''; $literal = ''; $mapping = []; $replace = []; $matches = []; $pattern = '/([:][a-zA-Z0-9_]+)/'; if (!preg_match($pattern, $sql, $matches)) { return $sql; } $sql = trim($sql); $n = \strlen($sql); while ($startPos < $n) { if (!preg_match($pattern, $sql, $matches, 0, $startPos)) { break; } $j = strpos($sql, "'", $startPos); $k = strpos($sql, '"', $startPos); if (($k !== false) && (($k < $j) || ($j === false))) { $quoteChar = '"'; $j = $k; } else { $quoteChar = "'"; } if ($j === false) { $j = $n; } // Search for named prepared parameters and replace it with ? and save its position $substring = substr($sql, $startPos, $j - $startPos); if (preg_match_all($pattern, $substring, $matches, PREG_PATTERN_ORDER + PREG_OFFSET_CAPTURE)) { foreach ($matches[0] as $i => $match) { if ($i === 0) { $literal .= substr($substring, 0, $match[1]); } $mapping[$match[0]] = \count($mapping); $endOfPlaceholder = $match[1] + strlen($match[0]); $beginOfNextPlaceholder = $matches[0][$i + 1][1] ?? strlen($substring); $beginOfNextPlaceholder -= $endOfPlaceholder; $literal .= '?' . substr($substring, $endOfPlaceholder, $beginOfNextPlaceholder); } } else { $literal .= $substring; } $startPos = $j; $j++; if ($j >= $n) { break; } // Quote comes first, find end of quote while (true) { $k = strpos($sql, $quoteChar, $j); $escaped = false; if ($k === false) { break; } $l = $k - 1; while ($l >= 0 && $sql[$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($sql, $startPos, $k - $startPos + 1); $startPos = $k + 1; } if ($startPos < $n) { $literal .= substr($sql, $startPos, $n - $startPos); } $this->parameterKeyMapping = $mapping; return $literal; } /** * Binds a parameter to the specified variable name. * * @param string|integer $parameter Parameter identifier. For a prepared statement using named placeholders, this will be a parameter * name of the form `:name`. For a prepared statement using question mark placeholders, this will be * the 1-indexed position of the parameter. * @param mixed $variable Name of the PHP variable to bind to the SQL statement parameter. * @param integer $dataType Constant corresponding to a SQL datatype, this should be the processed type from the QueryInterface. * @param integer $length The length of the variable. Usually required for OUTPUT parameters. * @param array $driverOptions Optional driver options to be used. * * @return boolean * * @since 2.0.0 */ public function bindParam($parameter, &$variable, string $dataType = ParameterType::STRING, ?int $length = null, ?array $driverOptions = null) { $this->bindedValues[$parameter] =& $variable; // Validate parameter type if (!isset($this->parameterTypeMapping[$dataType])) { throw new \InvalidArgumentException(sprintf('Unsupported parameter type `%s`', $dataType)); } $this->typesKeyMapping[$parameter] = $this->parameterTypeMapping[$dataType]; return true; } /** * Binds a array of values to bound parameters. * * @param array $values The values to bind to the statement * * @return boolean * * @since 2.0.0 */ private function bindValues(array $values) { $params = []; $types = str_repeat('s', \count($values)); if (!empty($this->parameterKeyMapping)) { foreach ($values as $key => &$value) { $params[$this->parameterKeyMapping[$key]] =& $value; } ksort($params); } else { foreach ($values as $key => &$value) { $params[] =& $value; } } array_unshift($params, $types); return \call_user_func_array([$this->statement, 'bind_param'], $params); } /** * Closes the cursor, enabling the statement to be executed again. * * @return void * * @since 2.0.0 */ public function closeCursor(): void { $this->statement->free_result(); $this->result = false; } /** * Fetches the SQLSTATE associated with the last operation on the statement handle. * * @return string * * @since 2.0.0 */ public function errorCode() { return $this->statement->errno; } /** * Fetches extended error information associated with the last operation on the statement handle. * * @return array * * @since 2.0.0 */ public function errorInfo() { return $this->statement->error; } /** * Executes a prepared statement * * @param array|null $parameters An array of values with as many elements as there are bound parameters in the SQL statement being executed. * * @return boolean * * @since 2.0.0 */ public function execute(?array $parameters = null) { if ($this->bindedValues !== null) { $params = []; $types = []; if (!empty($this->parameterKeyMapping)) { foreach ($this->bindedValues as $key => &$value) { $params[$this->parameterKeyMapping[$key]] =& $value; $types[$this->parameterKeyMapping[$key]] = $this->typesKeyMapping[$key]; } } else { foreach ($this->bindedValues as $key => &$value) { $params[] =& $value; $types[$key] = $this->typesKeyMapping[$key]; } } ksort($params); ksort($types); array_unshift($params, implode('', $types)); if (!\call_user_func_array([$this->statement, 'bind_param'], $params)) { throw new PrepareStatementFailureException($this->statement->error, $this->statement->errno); } } elseif ($parameters !== null) { if (!$this->bindValues($parameters)) { throw new PrepareStatementFailureException($this->statement->error, $this->statement->errno); } } try { if (!$this->statement->execute()) { throw new ExecutionFailureException($this->query, $this->statement->error, $this->statement->errno); } } catch (\Throwable $e) { throw new ExecutionFailureException($this->query, $e->getMessage(), $e->getCode(), $e); } if ($this->columnNames === null) { $meta = $this->statement->result_metadata(); if ($meta !== false) { $columnNames = []; foreach ($meta->fetch_fields() as $col) { $columnNames[] = $col->name; } $meta->free(); $this->columnNames = $columnNames; } else { $this->columnNames = false; } } if ($this->columnNames !== false) { $this->statement->store_result(); $this->rowBindedValues = array_fill(0, \count($this->columnNames), null); $refs = []; foreach ($this->rowBindedValues as $key => &$value) { $refs[$key] =& $value; } if (!\call_user_func_array([$this->statement, 'bind_result'], $refs)) { throw new \RuntimeException($this->statement->error, $this->statement->errno); } } $this->result = true; return true; } /** * Fetches the next row from a result set * * @param integer|null $fetchStyle Controls how the next row will be returned to the caller. This value must be one of the * FetchMode constants, defaulting to value of FetchMode::MIXED. * @param integer $cursorOrientation For a StatementInterface object representing a scrollable cursor, this value determines which row * will be returned to the caller. This value must be one of the FetchOrientation constants, * defaulting to FetchOrientation::NEXT. * @param integer $cursorOffset For a StatementInterface object representing a scrollable cursor for which the cursorOrientation * parameter is set to FetchOrientation::ABS, this value specifies the absolute number of the row in * the result set that shall be fetched. For a StatementInterface object representing a scrollable * cursor for which the cursorOrientation parameter is set to FetchOrientation::REL, this value * specifies the row to fetch relative to the cursor position before `fetch()` was called. * * @return mixed The return value of this function on success depends on the fetch type. In all cases, boolean false is returned on failure. * * @since 2.0.0 */ public function fetch(?int $fetchStyle = null, int $cursorOrientation = FetchOrientation::NEXT, int $cursorOffset = 0) { if (!$this->result) { return false; } $fetchStyle = $fetchStyle ?: $this->defaultFetchStyle; if ($fetchStyle === FetchMode::COLUMN) { return $this->fetchColumn(); } $values = $this->fetchData(); if ($values === null) { return false; } if ($values === false) { throw new \RuntimeException($this->statement->error, $this->statement->errno); } switch ($fetchStyle) { case FetchMode::NUMERIC: return $values; case FetchMode::ASSOCIATIVE: return array_combine($this->columnNames, $values); case FetchMode::MIXED: $ret = array_combine($this->columnNames, $values); $ret += $values; return $ret; case FetchMode::STANDARD_OBJECT: return (object) array_combine($this->columnNames, $values); default: throw new \InvalidArgumentException("Unknown fetch type '{$fetchStyle}'"); } } /** * Returns a single column from the next row of a result set * * @param integer $columnIndex 0-indexed number of the column you wish to retrieve from the row. * If no value is supplied, the first column is retrieved. * * @return mixed Returns a single column from the next row of a result set or boolean false if there are no more rows. * * @since 2.0.0 */ public function fetchColumn($columnIndex = 0) { $row = $this->fetch(FetchMode::NUMERIC); if ($row === false) { return false; } return $row[$columnIndex] ?? null; } /** * Fetch the data from the statement. * * @return array|boolean * * @since 2.0.0 */ private function fetchData() { $return = $this->statement->fetch(); if ($return === true) { $values = []; foreach ($this->rowBindedValues as $v) { $values[] = $v; } return $values; } return $return; } /** * Returns the number of rows affected by the last SQL statement. * * @return integer * * @since 2.0.0 */ public function rowCount(): int { if ($this->columnNames === false) { return $this->statement->affected_rows; } return $this->statement->num_rows; } /** * Sets the fetch mode to use while iterating this statement. * * @param integer $fetchMode The fetch mode, must be one of the FetchMode constants. * @param mixed ...$args Optional mode-specific arguments. * * @return void * * @since 2.0.0 */ public function setFetchMode(int $fetchMode, ...$args): void { $this->defaultFetchStyle = $fetchMode; } } PK c�\�h# . . & database/src/Mysqli/MysqliImporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysqli; use Joomla\Database\DatabaseImporter; /** * MySQLi Database Importer. * * @since 1.0 */ class MysqliImporter extends DatabaseImporter { /** * Checks if all data and options are in order prior to exporting. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function check() { // Check if the db connector has been set. if (!($this->db instanceof MysqliDriver)) { throw new \RuntimeException('Database connection wrong type.'); } // Check if the tables have been specified. if (empty($this->from)) { throw new \RuntimeException('ERROR: No Tables Specified'); } return $this; } /** * Get the SQL syntax to add a table. * * @param \SimpleXMLElement $table The table information. * * @return string * * @since 1.4.0 * @throws \RuntimeException */ protected function xmlToCreate(\SimpleXMLElement $table) { $existingTables = $this->db->getTableList(); $tableName = (string) $table['name']; if (\in_array($tableName, $existingTables, true)) { throw new \RuntimeException('The table you are trying to create already exists'); } $createTableStatement = 'CREATE TABLE ' . $this->db->quoteName($tableName) . ' ('; foreach ($table->xpath('field') as $field) { $createTableStatement .= $this->getColumnSql($field) . ', '; } $newLookup = $this->getKeyLookup($table->xpath('key')); foreach ($newLookup as $key) { $createTableStatement .= $this->getKeySql($key) . ', '; } $createTableStatement = rtrim($createTableStatement, ', '); $createTableStatement .= ')'; return $createTableStatement; } /** * Get the SQL syntax to add a key. * * @param string $table The table name. * @param array $keys An array of the fields pertaining to this key. * * @return string * * @since 1.0 */ protected function getAddKeySql($table, $keys) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' ADD ' . $this->getKeySql($keys); } /** * Get alters for table if there is a difference. * * @param \SimpleXMLElement $structure The XML structure of the table. * * @return array * * @since 1.0 */ protected function getAlterTableSql(\SimpleXMLElement $structure) { $table = $this->getRealTableName($structure['name']); $oldFields = $this->db->getTableColumns($table, false); $oldKeys = $this->db->getTableKeys($table); $alters = []; // Get the fields and keys from the XML that we are aiming for. $newFields = $structure->xpath('field'); $newKeys = $structure->xpath('key'); // Loop through each field in the new structure. foreach ($newFields as $field) { $fName = (string) $field['Field']; if (isset($oldFields[$fName])) { // The field exists, check it's the same. $column = $oldFields[$fName]; // Test whether there is a change. $change = ((string) $field['Type'] !== $column->Type) || ((string) $field['Null'] !== $column->Null) || ((string) $field['Default'] !== $column->Default) || ((string) $field['Extra'] !== $column->Extra); if ($change) { $alters[] = $this->getChangeColumnSql($table, $field); } // Unset this field so that what we have left are fields that need to be removed. unset($oldFields[$fName]); } else { // The field is new. $alters[] = $this->getAddColumnSql($table, $field); } } // Any columns left are orphans foreach ($oldFields as $name => $column) { // Delete the column. $alters[] = $this->getDropColumnSql($table, $name); } // Get the lookups for the old and new keys. $oldLookup = $this->getKeyLookup($oldKeys); $newLookup = $this->getKeyLookup($newKeys); // Loop through each key in the new structure. foreach ($newLookup as $name => $keys) { // Check if there are keys on this field in the existing table. if (isset($oldLookup[$name])) { $same = true; $newCount = \count($newLookup[$name]); $oldCount = \count($oldLookup[$name]); // There is a key on this field in the old and new tables. Are they the same? if ($newCount === $oldCount) { // Need to loop through each key and do a fine grained check. for ($i = 0; $i < $newCount; $i++) { $same = (((string) $newLookup[$name][$i]['Non_unique'] === $oldLookup[$name][$i]->Non_unique) && ((string) $newLookup[$name][$i]['Column_name'] === $oldLookup[$name][$i]->Column_name) && ((string) $newLookup[$name][$i]['Seq_in_index'] === $oldLookup[$name][$i]->Seq_in_index) && ((string) $newLookup[$name][$i]['Collation'] === $oldLookup[$name][$i]->Collation) && ((string) $newLookup[$name][$i]['Sub_part'] == $oldLookup[$name][$i]->Sub_part) && ((string) $newLookup[$name][$i]['Index_type'] === $oldLookup[$name][$i]->Index_type)); /* Debug. echo '<pre>'; echo '<br>Non_unique: '. ((string) $newLookup[$name][$i]['Non_unique'] == $oldLookup[$name][$i]->Non_unique ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Non_unique'].' vs '.$oldLookup[$name][$i]->Non_unique; echo '<br>Column_name: '. ((string) $newLookup[$name][$i]['Column_name'] == $oldLookup[$name][$i]->Column_name ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Column_name'].' vs '.$oldLookup[$name][$i]->Column_name; echo '<br>Seq_in_index: '. ((string) $newLookup[$name][$i]['Seq_in_index'] == $oldLookup[$name][$i]->Seq_in_index ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Seq_in_index'].' vs '.$oldLookup[$name][$i]->Seq_in_index; echo '<br>Collation: '. ((string) $newLookup[$name][$i]['Collation'] == $oldLookup[$name][$i]->Collation ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Collation'].' vs '.$oldLookup[$name][$i]->Collation; echo '<br>Sub_part: '. ((string) $newLookup[$name][$i]['Sub_part'] == $oldLookup[$name][$i]->Sub_part ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Sub_part'].' vs '.$oldLookup[$name][$i]->Sub_part; echo '<br>Index_type: '. ((string) $newLookup[$name][$i]['Index_type'] == $oldLookup[$name][$i]->Index_type ? 'Pass' : 'Fail').' '. (string) $newLookup[$name][$i]['Index_type'].' vs '.$oldLookup[$name][$i]->Index_type; echo '<br>Same = '.($same ? 'true' : 'false'); echo '</pre>'; */ if (!$same) { // Break out of the loop. No need to check further. break; } } } else { // Count is different, just drop and add. $same = false; } if (!$same) { $alters[] = $this->getDropKeySql($table, $name); $alters[] = $this->getAddKeySql($table, $keys); } // Unset this field so that what we have left are fields that need to be removed. unset($oldLookup[$name]); } else { // This is a new key. $alters[] = $this->getAddKeySql($table, $keys); } } // Any keys left are orphans. foreach ($oldLookup as $name => $keys) { if (strtoupper($name) === 'PRIMARY') { $alters[] = $this->getDropPrimaryKeySql($table); } else { $alters[] = $this->getDropKeySql($table, $name); } } return $alters; } /** * Get the syntax to alter a column. * * @param string $table The name of the database table to alter. * @param \SimpleXMLElement $field The XML definition for the field. * * @return string * * @since 1.0 */ protected function getChangeColumnSql($table, \SimpleXMLElement $field) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' CHANGE COLUMN ' . $this->db->quoteName((string) $field['Field']) . ' ' . $this->getColumnSql($field); } /** * Get the SQL syntax for a single column that would be included in a table create or alter statement. * * @param \SimpleXMLElement $field The XML field definition. * * @return string * * @since 1.0 */ protected function getColumnSql(\SimpleXMLElement $field) { // TODO Incorporate into parent class and use $this. $blobs = ['text', 'smalltext', 'mediumtext', 'largetext']; $fName = (string) $field['Field']; $fType = (string) $field['Type']; $fNull = (string) $field['Null']; $fDefault = isset($field['Default']) ? (string) $field['Default'] : null; $fExtra = (string) $field['Extra']; $sql = $this->db->quoteName($fName) . ' ' . $fType; if ($fNull === 'NO') { if ($fDefault === null || \in_array($fType, $blobs, true)) { $sql .= ' NOT NULL'; } else { // TODO Don't quote numeric values. if (stristr($fDefault, 'CURRENT') !== false) { $sql .= ' NOT NULL DEFAULT CURRENT_TIMESTAMP()'; } else { $sql .= ' NOT NULL DEFAULT ' . $this->db->quote($fDefault); } } } else { if ($fDefault === null) { $sql .= ' DEFAULT NULL'; } else { // TODO Don't quote numeric values. $sql .= ' DEFAULT ' . $this->db->quote($fDefault); } } if ($fExtra) { // MySql 8.0 introduces DEFAULT_GENERATED in the extra column and should be replaced with the default value if (stristr($fExtra, 'DEFAULT_GENERATED') !== false) { $sql .= ' ' . strtoupper(str_ireplace('DEFAULT_GENERATED', 'DEFAULT ' . $fDefault, $fExtra)); } else { $sql .= ' ' . strtoupper($fExtra); } } return $sql; } /** * Get the SQL syntax to drop a key. * * @param string $table The table name. * @param string $name The name of the key to drop. * * @return string * * @since 1.0 */ protected function getDropKeySql($table, $name) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' DROP KEY ' . $this->db->quoteName($name); } /** * Get the SQL syntax to drop a key. * * @param string $table The table name. * * @return string * * @since 1.0 */ protected function getDropPrimaryKeySql($table) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' DROP PRIMARY KEY'; } /** * Get the details list of keys for a table. * * @param array $keys An array of objects that comprise the keys for the table. * * @return array The lookup array. array({key name} => array(object, ...)) * * @since 1.0 */ protected function getKeyLookup($keys) { // First pass, create a lookup of the keys. $lookup = []; foreach ($keys as $key) { if ($key instanceof \SimpleXMLElement) { $kName = (string) $key['Key_name']; } else { $kName = $key->Key_name; } if (empty($lookup[$kName])) { $lookup[$kName] = []; } $lookup[$kName][] = $key; } return $lookup; } /** * Get the SQL syntax for a key. * * @param array $columns An array of SimpleXMLElement objects comprising the key. * * @return string * * @since 1.0 */ protected function getKeySql($columns) { $kNonUnique = (string) $columns[0]['Non_unique']; $kName = (string) $columns[0]['Key_name']; $prefix = ''; if ($kName === 'PRIMARY') { $prefix = 'PRIMARY '; } elseif ($kNonUnique == 0) { $prefix = 'UNIQUE '; } $kColumns = []; foreach ($columns as $column) { $kLength = ''; if (!empty($column['Sub_part'])) { $kLength = '(' . $column['Sub_part'] . ')'; } $kColumns[] = $this->db->quoteName((string) $column['Column_name']) . $kLength; } return $prefix . 'KEY ' . ($kName !== 'PRIMARY' ? $this->db->quoteName($kName) : '') . ' (' . implode(',', $kColumns) . ')'; } } PK c�\�?�� � # database/src/Mysqli/MysqliQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Mysqli; use Joomla\Database\DatabaseQuery; use Joomla\Database\Query\MysqlQueryBuilder; /** * MySQLi Query Building Class. * * @since 1.0 */ class MysqliQuery extends DatabaseQuery { use MysqlQueryBuilder; /** * The list of zero or null representation of a datetime. * * @var array * @since 2.0.0 */ protected $nullDatetimeList = ['0000-00-00 00:00:00', '1000-01-01 00:00:00']; } PK c�\�3�T T ! database/src/FetchOrientation.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Class defining the fetch orientation for prepared statements * * The values of the constants in this class match the `PDO::FETCH_ORI_*` constants. * * @since 2.0.0 */ final class FetchOrientation { /** * Fetch the next row in the result set. Valid only for scrollable cursors. * * @var integer * @since 2.0.0 */ public const NEXT = 0; /** * Fetch the previous row in the result set. Valid only for scrollable cursors. * * @var integer * @since 2.0.0 */ public const PRIOR = 1; /** * Fetch the first row in the result set. Valid only for scrollable cursors. * * @var integer * @since 2.0.0 */ public const FIRST = 2; /** * Fetch the last row in the result set. Valid only for scrollable cursors. * * @var integer * @since 2.0.0 */ public const LAST = 3; /** * Fetch the requested row by row number from the result set. Valid only for scrollable cursors. * * @var integer * @since 2.0.0 */ public const ABS = 4; /** * Fetch the requested row by relative position from the current position of the cursor in the result set. Valid only for scrollable cursors. * * @var integer * @since 2.0.0 */ public const REL = 5; /** * Private constructor to prevent instantiation of this class * * @since 2.0.0 */ private function __construct() { } } PK c�\�`�w- w- $ database/src/Sqlite/SqliteDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Sqlite; use Joomla\Database\Pdo\PdoDriver; /** * SQLite database driver supporting PDO based connections * * @link https://www.php.net/manual/en/ref.pdo-sqlite.php * @since 1.0 */ class SqliteDriver extends PdoDriver { /** * The name of the database driver. * * @var string * @since 1.0 */ public $name = 'sqlite'; /** * The character(s) used to quote SQL statement names such as table names or field names, etc. * * 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 = '`'; /** * Destructor. * * @since 1.0 */ public function __destruct() { $this->disconnect(); } /** * Alter database's character set. * * @param string $dbName The database name that will be altered * * @return boolean|resource * * @since 2.0.0 * @throws \RuntimeException */ public function alterDbCharacterSet($dbName) { return false; } /** * Connects to the database if needed. * * @return void Returns void if the database connected successfully. * * @since 2.0.0 * @throws RuntimeException */ public function connect() { if ($this->connection) { return; } parent::connect(); $this->connection->sqliteCreateFunction( 'ROW_NUMBER', function ($init = null) { static $rownum, $partition; if ($init !== null) { $rownum = $init; $partition = null; return $rownum; } $args = \func_get_args(); array_shift($args); $partitionBy = $args ? implode(',', $args) : null; if ($partitionBy === null || $partitionBy === $partition) { $rownum++; } else { $rownum = 1; $partition = $partitionBy; } return $rownum; } ); } /** * Create a new database using information from $options object. * * @param \stdClass $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 boolean|resource * * @since 2.0.0 * @throws \RuntimeException */ public function createDatabase($options, $utf = true) { // SQLite doesn't have a query for this return true; } /** * 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)) { return $text; } if (\is_float($text)) { // Force the dot as a decimal point. return str_replace(',', '.', $text); } return \SQLite3::escapeString($text); } /** * Method to get the database collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database or boolean false if not supported. * * @since 1.0 */ public function getCollation() { return false; } /** * Method to get the database connection collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database connection (string) or boolean false if not supported. * * @since 1.6.0 * @throws \RuntimeException */ public function getConnectionCollation() { return false; } /** * Method to get the database encryption details (cipher and protocol) in use. * * @return string The database encryption details. * * @since 2.0.0 * @throws \RuntimeException */ public function getConnectionEncryption(): string { // TODO: Not fake this return ''; } /** * Method to test if the database TLS connections encryption are supported. * * @return boolean Whether the database supports TLS connections encryption. * * @since 2.0.0 */ public function isConnectionEncryptionSupported(): bool { // TODO: Not fake this return false; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableCreate($tables) { $this->connect(); // Sanitize input to an array and iterate over the list. $tables = (array) $tables; return $tables; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableColumns($table, $typeOnly = true) { $this->connect(); $columns = []; $fieldCasing = $this->getOption(\PDO::ATTR_CASE); $this->setOption(\PDO::ATTR_CASE, \PDO::CASE_UPPER); $table = strtoupper($table); $fields = $this->setQuery('pragma table_info(' . $table . ')')->loadObjectList(); if ($typeOnly) { foreach ($fields as $field) { $columns[$field->NAME] = $field->TYPE; } } else { foreach ($fields as $field) { // Do some dirty translation to MySQL output. // TODO: Come up with and implement a standard across databases. $columns[$field->NAME] = (object) [ 'Field' => $field->NAME, 'Type' => $field->TYPE, 'Null' => $field->NOTNULL == '1' ? 'NO' : 'YES', 'Default' => $field->DFLT_VALUE, 'Key' => $field->PK != '0' ? 'PRI' : '', ]; } } $this->setOption(\PDO::ATTR_CASE, $fieldCasing); return $columns; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableKeys($table) { $this->connect(); $keys = []; $fieldCasing = $this->getOption(\PDO::ATTR_CASE); $this->setOption(\PDO::ATTR_CASE, \PDO::CASE_UPPER); $table = strtoupper($table); $rows = $this->setQuery('pragma table_info( ' . $table . ')')->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. * * @since 1.0 * @throws \RuntimeException */ public function getTableList() { $this->connect(); $type = 'table'; $query = $this->createQuery() ->select('name') ->from('sqlite_master') ->where('type = :type') ->bind(':type', $type) ->order('name'); return $this->setQuery($query)->loadColumn(); } /** * Get the version of the database connector. * * @return string The database connector version. * * @since 1.0 */ public function getVersion() { $this->connect(); return $this->setQuery('SELECT sqlite_version()')->loadResult(); } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function select($database) { $this->connect(); return true; } /** * 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->connect(); return false; } /** * Locks a table in the database. * * @param string $table The name of the table to unlock. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function lockTable($table) { return $this; } /** * 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 $this * * @since 1.0 * @throws \RuntimeException */ public function renameTable($oldTable, $newTable, $backup = null, $prefix = null) { $this->setQuery('ALTER TABLE ' . $oldTable . ' RENAME TO ' . $newTable)->execute(); return $this; } /** * Method to truncate a table. * * @param string $table The table to truncate * * @return void * * @since 1.2.1 * @throws \RuntimeException */ public function truncateTable($table) { $this->setQuery('DELETE FROM ' . $this->quoteName($table)) ->execute(); } /** * Unlocks tables in the database. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function unlockTables() { return $this; } /** * 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') && class_exists('\\SQLite3') && \in_array('sqlite', \PDO::getAvailableDrivers(), true); } /** * Method to commit a transaction. * * @param boolean $toSavepoint If true, commit to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionCommit($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { parent::transactionCommit($toSavepoint); } else { $this->transactionDepth--; } } /** * Method to roll back a transaction. * * @param boolean $toSavepoint If true, rollback to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionRollback($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { parent::transactionRollback($toSavepoint); } else { $savepoint = 'SP_' . ($this->transactionDepth - 1); $this->setQuery('ROLLBACK TO ' . $this->quoteName($savepoint))->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 * * @since 1.0 * @throws \RuntimeException */ public function transactionStart($asSavepoint = false) { $this->connect(); if (!$asSavepoint || !$this->transactionDepth) { parent::transactionStart($asSavepoint); } else { $savepoint = 'SP_' . $this->transactionDepth; $this->setQuery('SAVEPOINT ' . $this->quoteName($savepoint))->execute(); $this->transactionDepth++; } } } PK c�\�B oo o # database/src/Sqlite/SqliteQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Sqlite; use Joomla\Database\DatabaseQuery; use Joomla\Database\Pdo\PdoQuery; use Joomla\Database\Query\QueryElement; /** * SQLite Query Building Class. * * @since 1.0 */ class SqliteQuery extends PdoQuery { /** * Magic function to convert the query to a string. * * @return string The completed query. * * @since 2.0.0 */ public function __toString() { switch ($this->type) { case 'select': if ($this->selectRowNumber) { $orderBy = $this->selectRowNumber['orderBy']; $orderColumnAlias = $this->selectRowNumber['orderColumnAlias']; $column = "ROW_NUMBER() AS $orderColumnAlias"; if ($this->select === null) { $query = PHP_EOL . 'SELECT 1' . (string) $this->from . (string) $this->where; } else { $tmpOffset = $this->offset; $tmpLimit = $this->limit; $this->offset = 0; $this->limit = 0; $tmpOrder = $this->order; $this->order = null; $query = parent::__toString(); $column = "w.*, $column"; $this->order = $tmpOrder; $this->offset = $tmpOffset; $this->limit = $tmpLimit; } // Special sqlite query to count ROW_NUMBER $query = PHP_EOL . "SELECT $column" . PHP_EOL . "FROM ($query" . PHP_EOL . "ORDER BY $orderBy" . PHP_EOL . ') AS w,(SELECT ROW_NUMBER(0)) AS r' // Forbid to flatten subqueries. . ((string) $this->order ?: PHP_EOL . 'ORDER BY NULL'); return $this->processLimit($query, $this->limit, $this->offset); } break; case 'querySet': $query = $this->querySet; if ($query->order || $query->limit || $query->offset) { // If ORDER BY or LIMIT statement exist then parentheses is required for the first query $query = PHP_EOL . "SELECT * FROM ($query)"; } if ($this->merge) { // Special case for merge foreach ($this->merge as $element) { $query .= (string) $element; } } if ($this->order) { $query .= (string) $this->order; } return $query; case 'update': if ($this->join) { $table = $this->update->getElements(); $table = $table[0]; $tableName = explode(' ', $table); $tableName = $tableName[0]; if ($this->columns === null) { $fields = $this->db->getTableColumns($tableName); foreach ($fields as $key => $value) { $fields[$key] = $key; } $this->columns = new QueryElement('()', $fields); } $fields = $this->columns->getElements(); $elements = $this->set->getElements(); foreach ($elements as $nameValue) { $setArray = explode(' = ', $nameValue, 2); if ($setArray[0][0] === '`') { // Unquote column name $setArray[0] = substr($setArray[0], 1, -1); } $fields[$setArray[0]] = $setArray[1]; } $select = new static($this->db); $select->select(array_values($fields)) ->from($table); $select->join = $this->join; $select->where = $this->where; return 'INSERT OR REPLACE INTO ' . $tableName . ' (' . implode(',', array_keys($fields)) . ')' . (string) $select; } } return parent::__toString(); } /** * 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|null $operator Comparison operator between charLength integer value and $condition * @param string|null $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) { $statement = 'length(' . $field . ')'; if ($operator !== null && $condition !== null) { $statement .= ' ' . $operator . ' ' . $condition; } return $statement; } /** * Concatenates an array of column names or values. * * Usage: * $query->select($query->concatenate(array('a', 'b'))); * * @param string[] $values An array of values to concatenate. * @param string|null $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 !== null) { return implode(' || ' . $this->quote($separator) . ' || ', $values); } 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. * * @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; } /** * Return the number of the current row. * * Usage: * $query->select('id'); * $query->selectRowNumber('ordering,publish_up DESC', 'new_ordering'); * $query->from('#__content'); * * @param string $orderBy An expression of ordering for window function. * @param string $orderColumnAlias An alias for new ordering column. * * @return $this * * @since 2.0.0 * @throws \RuntimeException */ public function selectRowNumber($orderBy, $orderColumnAlias) { $this->validateRowNumber($orderBy, $orderColumnAlias); return $this; } /** * Add a query to UNION with the current query. * * Usage: * $query->union('SELECT name FROM #__foo') * $query->union('SELECT name FROM #__foo', true) * * @param DatabaseQuery|string $query The DatabaseQuery object or string to union. * @param boolean $distinct True to only return distinct rows from the union. * * @return $this * * @since 1.0 */ public function union($query, $distinct = true) { // Set up the name with parentheses, the DISTINCT flag is redundant return $this->merge($distinct ? 'UNION SELECT * FROM ()' : 'UNION ALL SELECT * FROM ()', $query); } /** * Aggregate function to get input values concatenated into a string, separated by delimiter * * Usage: * $query->groupConcat('id', ','); * * @param string $expression The expression to apply concatenation to, this may be a column name or complex SQL statement. * @param string $separator The delimiter of each concatenated value * * @return string Input values concatenated into a string, separated by delimiter * * @since 2.0.0 */ public function groupConcat($expression, $separator = ',') { return 'group_concat(' . $expression . ', ' . $this->quote($separator) . ')'; } } PK c�\CN� � & database/src/Command/ImportCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ // phpcs:disable Generic.PHP.DeprecatedFunctions.Deprecated namespace Joomla\Database\Command; use Joomla\Archive\Archive; use Joomla\Console\Command\AbstractCommand; use Joomla\Database\DatabaseDriver; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\Exception\UnsupportedAdapterException; use Joomla\Filesystem\Exception\FilesystemException; use Joomla\Filesystem\File; use Joomla\Filesystem\Folder; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Input\InputOption; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Style\SymfonyStyle; /** * Console command for importing the database * * @since 2.0.0 */ class ImportCommand extends AbstractCommand { /** * The default command name * * @var string * @since 2.0.0 */ protected static $defaultName = 'database:import'; /** * Database connector * * @var DatabaseDriver * @since 2.0.0 */ private $db; /** * Instantiate the command. * * @param DatabaseDriver $db Database connector * * @since 2.0.0 */ public function __construct(DatabaseDriver $db) { $this->db = $db; parent::__construct(); } /** * Checks if the zip file contains database export files * * @param string $archive A zip archive to analyze * * @return void * * @since 2.0.0 * @throws \RuntimeException */ private function checkZipFile(string $archive): void { if (!extension_loaded('zip')) { throw new \RuntimeException('The PHP zip extension is not installed or is disabled'); } $zip = zip_open($archive); if (!\is_resource($zip)) { throw new \RuntimeException('Unable to open archive'); } while ($file = @zip_read($zip)) { if (strpos(zip_entry_name($file), $this->db->getPrefix()) === false) { zip_entry_close($file); @zip_close($zip); throw new \RuntimeException('Unable to find table matching database prefix'); } zip_entry_close($file); } @zip_close($zip); } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ protected function doExecute(InputInterface $input, OutputInterface $output): int { $symfonyStyle = new SymfonyStyle($input, $output); $symfonyStyle->title('Importing Database'); $totalTime = microtime(true); // Make sure the database supports imports before we get going try { $importer = $this->db->getImporter() ->withStructure() ->asXml(); } catch (UnsupportedAdapterException $e) { $symfonyStyle->error(sprintf('The "%s" database driver does not support importing data.', $this->db->getName())); return 1; } $folderPath = $input->getOption('folder'); $tableName = $input->getOption('table'); $zipFile = $input->getOption('zip'); if ($zipFile) { if (!class_exists(File::class)) { $symfonyStyle->error('The "joomla/filesystem" Composer package is not installed, cannot process ZIP files.'); return 1; } if (!class_exists(Archive::class)) { $symfonyStyle->error('The "joomla/archive" Composer package is not installed, cannot process ZIP files.'); return 1; } $zipPath = $folderPath . '/' . $zipFile; try { $this->checkZipFile($zipPath); } catch (\RuntimeException $e) { $symfonyStyle->error($e->getMessage()); return 1; } $folderPath .= File::stripExt($zipFile); try { Folder::create($folderPath); } catch (FilesystemException $e) { $symfonyStyle->error($e->getMessage()); return 1; } try { (new Archive)->extract($zipPath, $folderPath); } catch (\RuntimeException $e) { $symfonyStyle->error($e->getMessage()); Folder::delete($folderPath); return 1; } } if ($tableName) { $tables = [$tableName . '.xml']; } else { $tables = Folder::files($folderPath, '\.xml$'); } foreach ($tables as $table) { $taskTime = microtime(true); $percorso = $folderPath . '/' . $table; // Check file if (!file_exists($percorso)) { $symfonyStyle->error(sprintf('The %s file does not exist.', $table)); return 1; } $tableName = str_replace('.xml', '', $table); $symfonyStyle->text(sprintf('Importing %1$s from %2$s', $tableName, $table)); $importer->from(file_get_contents($percorso)); $symfonyStyle->text(sprintf('Processing the %s table', $tableName)); try { $this->db->dropTable($tableName, true); } catch (ExecutionFailureException $e) { $symfonyStyle->error(sprintf('Error executing the DROP TABLE statement for %1$s: %2$s', $tableName, $e->getMessage())); return 1; } try { $importer->mergeStructure(); } catch (\Exception $e) { $symfonyStyle->error(sprintf('Error merging the structure for %1$s: %2$s', $tableName, $e->getMessage())); return 1; } try { $importer->importData(); } catch (\Exception $e) { $symfonyStyle->error(sprintf('Error importing the data for %1$s: %2$s', $tableName, $e->getMessage())); return 1; } $symfonyStyle->text(sprintf('Imported data for %s in %d seconds', $table, round(microtime(true) - $taskTime, 3))); } if ($zipFile) { Folder::delete($folderPath); } $symfonyStyle->success(sprintf('Import completed in %d seconds', round(microtime(true) - $totalTime, 3))); return 0; } /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { $this->setDescription('Import the database'); $this->addOption('folder', null, InputOption::VALUE_OPTIONAL, 'Path to the folder containing files to import', '.'); $this->addOption('zip', null, InputOption::VALUE_REQUIRED, 'The name of a ZIP file to import'); $this->addOption('table', null, InputOption::VALUE_REQUIRED, 'The name of the database table to import'); } } PK c�\m��� � & database/src/Command/ExportCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Command; use Joomla\Archive\Archive; use Joomla\Archive\Zip; use Joomla\Console\Command\AbstractCommand; use Joomla\Database\DatabaseDriver; use Joomla\Database\Exception\UnsupportedAdapterException; use Joomla\Filesystem\File; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Style\SymfonyStyle; use Symfony\Component\Console\Input\InputOption; /** * Console command for exporting the database * * @since 2.0.0 */ class ExportCommand extends AbstractCommand { /** * The default command name * * @var string * @since 2.0.0 */ protected static $defaultName = 'database:export'; /** * Database connector * * @var DatabaseDriver * @since 2.0.0 */ private $db; /** * Instantiate the command. * * @param DatabaseDriver $db Database connector * * @since 2.0.0 */ public function __construct(DatabaseDriver $db) { $this->db = $db; parent::__construct(); } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ protected function doExecute(InputInterface $input, OutputInterface $output): int { $symfonyStyle = new SymfonyStyle($input, $output); $symfonyStyle->title('Exporting Database'); $totalTime = microtime(true); if (!class_exists(File::class)) { $symfonyStyle->error('The "joomla/filesystem" Composer package is not installed, cannot create an export.'); return 1; } // Make sure the database supports exports before we get going try { $exporter = $this->db->getExporter() ->withStructure(); } catch (UnsupportedAdapterException $e) { $symfonyStyle->error(sprintf('The "%s" database driver does not support exporting data.', $this->db->getName())); return 1; } $folderPath = $input->getOption('folder'); $tableName = $input->getOption('table'); $zip = $input->getOption('zip'); $zipFile = $folderPath . '/data_exported_' . date("Y-m-d\TH-i-s") . '.zip'; $tables = $this->db->getTableList(); $prefix = $this->db->getPrefix(); if ($tableName) { if (!\in_array($tableName, $tables)) { $symfonyStyle->error(sprintf('The %s table does not exist in the database.', $tableName)); return 1; } $tables = [$tableName]; } if ($zip) { if (!class_exists(Archive::class)) { $symfonyStyle->error('The "joomla/archive" Composer package is not installed, cannot create ZIP files.'); return 1; } /** @var Zip $zipArchive */ $zipArchive = (new Archive)->getAdapter('zip'); } foreach ($tables as $table) { // If an empty prefix is in use then we will dump all tables, otherwise the prefix must match if (strlen($prefix) === 0 || strpos(substr($table, 0, strlen($prefix)), $prefix) !== false) { $taskTime = microtime(true); $filename = $folderPath . '/' . $table . '.xml'; $symfonyStyle->text(sprintf('Processing the %s table', $table)); $data = (string) $exporter->from($table)->withData(true); if (file_exists($filename)) { File::delete($filename); } File::write($filename, $data); if ($zip) { $zipFilesArray = [['name' => $table . '.xml', 'data' => $data]]; $zipArchive->create($zipFile, $zipFilesArray); File::delete($filename); } $symfonyStyle->text(sprintf('Exported data for %s in %d seconds', $table, round(microtime(true) - $taskTime, 3))); } } $symfonyStyle->success(sprintf('Export completed in %d seconds', round(microtime(true) - $totalTime, 3))); return 0; } /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { $this->setDescription('Export the database'); $this->addOption('folder', null, InputOption::VALUE_OPTIONAL, 'Path to write the export files to', '.'); $this->addOption('table', null, InputOption::VALUE_REQUIRED, 'The name of the database table to export'); $this->addOption('zip', null, InputOption::VALUE_NONE, 'Flag indicating the export will be saved to a ZIP archive'); } } PK c�\+�*=? =? " database/src/DatabaseInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Joomla Framework Database Interface * * @since 1.0 */ interface DatabaseInterface { /** * Connects to the database if needed. * * @return void * * @since 2.0.0 * @throws \RuntimeException */ public function connect(); /** * Determines if the connection to the server is active. * * @return boolean * * @since 2.0.0 */ public function connected(); /** * Create a new database using information from $options object. * * @param \stdClass $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 boolean|resource * * @since 2.0.0 * @throws \RuntimeException */ public function createDatabase($options, $utf = true); /** * Replace special placeholder representing binary field with the original string. * * @param string|resource $data Encoded string or resource. * * @return string The original string. * * @since 1.7.0 */ public function decodeBinary($data); /** * Disconnects the database. * * @return void * * @since 2.0.0 */ public function disconnect(); /** * 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 $this * * @since 2.0.0 * @throws \RuntimeException */ public function dropTable($table, $ifExists = true); /** * Escapes 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. * * @since 2.0.0 */ public function escape($text, $extra = false); /** * Execute the SQL statement. * * @return boolean * * @since 2.0.0 * @throws \RuntimeException */ public function execute(); /** * Get the number of affected rows for the previous executed SQL statement. * * @return integer * * @since 2.0.0 */ public function getAffectedRows(); /** * Method to get the database collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database or boolean false if not supported. * * @since 2.0.0 */ public function getCollation(); /** * Method that provides access to the underlying database connection. * * @return resource The underlying database connection resource. * * @since 2.0.0 */ public function getConnection(); /** * Method to get the database connection collation, as reported by the driver. * * If the connector doesn't support reporting this value please return an empty string. * * @return string * * @since 2.0.0 */ public function getConnectionCollation(); /** * Method to get the database encryption details (cipher and protocol) in use. * * @return string The database encryption details. * * @since 2.0.0 */ public function getConnectionEncryption(): string; /** * Method to test if the database TLS connections encryption are supported. * * @return boolean Whether the database supports TLS connections encryption. * * @since 2.0.0 */ public function isConnectionEncryptionSupported(): bool; /** * Method to check whether the installed database version is supported by the database driver * * @return boolean True if the database version is supported * * @since 2.0.0 */ public function isMinimumVersion(); /** * Get the total number of SQL statements executed by the database driver. * * @return integer * * @since 2.0.0 */ public function getCount(); /** * Returns a PHP date() function compliant date format for the database driver. * * @return string * * @since 2.0.0 */ public function getDateFormat(); /** * Get the minimum supported database version. * * @return string * * @since 2.0.0 */ public function getMinimum(); /** * Get the name of the database driver. * * @return string * * @since 2.0.0 */ public function getName(); /** * Get the null or zero representation of a timestamp for the database driver. * * @return string * * @since 2.0.0 */ public function getNullDate(); /** * Get the number of returned rows for the previous executed SQL statement. * * @return integer * * @since 2.0.0 */ public function getNumRows(); /** * Get the current query object or a new QueryInterface object. * * @param boolean $new False to return the current query object, True to return a new QueryInterface object. * * @return QueryInterface * * @since 2.0.0 * @throws \RuntimeException */ public function getQuery($new = false); /** * Get the server family type. * * @return string * * @since 2.0.0 */ public function getServerType(); /** * 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 * * @since 2.0.0 * @throws \RuntimeException */ public function getTableColumns($table, $typeOnly = true); /** * Retrieves field information about the given tables. * * @param mixed $tables A table name or a list of table names. * * @return array * * @since 2.0.0 * @throws \RuntimeException */ public function getTableKeys($tables); /** * Method to get an array of all tables in the database. * * @return array * * @since 2.0.0 * @throws \RuntimeException */ public function getTableList(); /** * Get the version of the database connector. * * @return string * * @since 2.0.0 */ public function getVersion(); /** * Determine whether or not the database engine supports UTF-8 character encoding. * * @return boolean True if the database engine supports UTF-8 character encoding. * * @since 2.0.0 */ public function hasUtfSupport(); /** * Method to get the auto-incremented value from the last INSERT statement. * * @return mixed The value of the auto-increment field from the last inserted row. * * @since 2.0.0 */ public function insertid(); /** * 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 * * @since 2.0.0 * @throws \RuntimeException */ public function insertObject($table, &$object, $key = null); /** * Test to see if the connector is available. * * @return boolean * * @since 1.0 */ public static function isSupported(); /** * 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. * * @since 2.0.0 * @throws \RuntimeException */ public function loadAssoc(); /** * 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: 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 $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. * * @since 2.0.0 * @throws \RuntimeException */ public function loadAssocList($key = null, $column = null); /** * Method to get an array of values from the <var>$offset</var> 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. * * @since 2.0.0 * @throws \RuntimeException */ public function loadColumn($offset = 0); /** * 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. * * @since 2.0.0 * @throws \RuntimeException */ public function loadObject($class = \stdClass::class); /** * 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. * * @since 2.0.0 * @throws \RuntimeException */ public function loadObjectList($key = '', $class = \stdClass::class); /** * 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. * * @since 2.0.0 * @throws \RuntimeException */ public function loadResult(); /** * 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 <var>$row[0]</var>, etc. * * @return mixed The return value or null if the query failed. * * @since 2.0.0 * @throws \RuntimeException */ public function loadRow(); /** * 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. * * @since 2.0.0 * @throws \RuntimeException */ public function loadRowList($key = null); /** * Locks a table in the database. * * @param string $tableName The name of the table to unlock. * * @return $this * * @since 2.0.0 * @throws \RuntimeException */ public function lockTable($tableName); /** * Quotes and optionally escapes a string to database requirements for use in database queries. * * @param array|string $text A string or an array of strings to quote. * @param boolean $escape True (default) to escape the string, false to leave it unchanged. * * @return string * * @since 2.0.0 */ public function quote($text, $escape = true); /** * Quotes a binary string to database requirements for use in database queries. * * @param string $data A binary string to quote. * * @return string The binary quoted input string. * * @since 1.7.0 */ public function quoteBinary($data); /** * Wrap an SQL statement identifier name such as column, table or database names in quotes to prevent injection * risks and reserved word conflicts. * * @param array|string $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 array|string $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 array|string The quote wrapped name, same type of $name. * * @since 2.0.0 */ public function quoteName($name, $as = null); /** * 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 $this * * @since 2.0.0 * @throws \RuntimeException */ public function renameTable($oldTable, $newTable, $backup = null, $prefix = null); /** * This function replaces a string identifier with the configured table prefix. * * @param string $sql The SQL statement to prepare. * @param string $prefix The table prefix. * * @return string The processed SQL statement. * * @since 2.0.0 */ public function replacePrefix($sql, $prefix = '#__'); /** * Select a database for use. * * @param string $database The name of the database to select for use. * * @return boolean * * @since 2.0.0 * @throws \RuntimeException */ public function select($database); /** * Sets the SQL statement string for later execution. * * @param mixed $query The SQL statement to set either as a Query object or a string. * @param integer $offset The affected row offset to set. {@deprecated 3.0 Use LimitableInterface::setLimit() instead} * @param integer $limit The maximum affected rows to set. {@deprecated 3.0 Use LimitableInterface::setLimit() instead} * * @return $this * * @since 2.0.0 */ public function setQuery($query, $offset = 0, $limit = 0); /** * Method to commit a transaction. * * @param boolean $toSavepoint If true, commit to the last savepoint. * * @return void * * @since 2.0.0 * @throws \RuntimeException */ public function transactionCommit($toSavepoint = false); /** * Method to roll back a transaction. * * @param boolean $toSavepoint If true, rollback to the last savepoint. * * @return void * * @since 2.0.0 * @throws \RuntimeException */ public function transactionRollback($toSavepoint = false); /** * Method to initialize a transaction. * * @param boolean $asSavepoint If true and a transaction is already active, a savepoint will be created. * * @return void * * @since 2.0.0 * @throws \RuntimeException */ public function transactionStart($asSavepoint = false); /** * Method to truncate a table. * * @param string $table The table to truncate * * @return void * * @since 2.0.0 * @throws \RuntimeException */ public function truncateTable($table); /** * Unlocks tables in the database. * * @return $this * * @since 2.0.0 * @throws \RuntimeException */ public 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 array|string $key The name of the primary key. * @param boolean $nulls True to update null fields or false to ignore them. * * @return boolean * * @since 2.0.0 * @throws \RuntimeException */ public function updateObject($table, &$object, $key, $nulls = false); } PK c�\\�[ ! database/src/DatabaseExporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Joomla Framework Database Exporter Class * * @since 1.0 */ abstract class DatabaseExporter { /** * The type of output format. * * @var string * @since 1.0 */ protected $asFormat = 'xml'; /** * An array of cached data. * * @var array * @since 1.0 */ protected $cache = ['columns' => [], 'keys' => []]; /** * The database connector to use for exporting structure and/or data. * * @var DatabaseInterface * @since 1.0 */ protected $db; /** * An array input sources (table names). * * @var string[] * @since 1.0 */ protected $from = []; /** * An array of options for the exporter. * * @var \stdClass * @since 1.0 */ protected $options; /** * Constructor. * * Sets up the default options for the exporter. * * @since 1.0 */ public function __construct() { $this->options = new \stdClass; // Set up the class defaults: // Export not only structure $this->withStructure(); $this->withData(); // Export as xml. $this->asXml(); // Default destination is a string using $output = (string) $exporter; } /** * Magic function to exports the data to a string. * * @return string * * @since 1.0 */ public function __toString() { $buffer = ''; try { // Check everything is ok to run first. $this->check(); // Get the format. switch ($this->asFormat) { case 'xml': default: $buffer = $this->buildXml(); break; } } catch (\Exception $e) { // Do nothing } return $buffer; } /** * Set the output option for the exporter to XML format. * * @return $this * * @since 1.0 */ public function asXml() { $this->asFormat = 'xml'; return $this; } /** * Builds the XML data for the tables to export. * * @return string An XML string * * @since 1.0 * @throws \Exception if an error occurs. */ abstract protected function buildXml(); /** * Builds the XML structure to export. * * @return array An array of XML lines (strings). * * @since 1.0 * @throws \Exception if an error occurs. */ abstract protected function buildXmlStructure(); /** * Checks if all data and options are in order prior to exporting. * * @return $this * * @since 1.0 * @throws \Exception if an error is encountered. */ abstract public function check(); /** * Specifies a list of table names to export. * * @param string[]|string $from The name of a single table, or an array of the table names to export. * * @return $this * * @since 1.0 * @throws \InvalidArgumentException */ public function from($from) { if (\is_string($from)) { $this->from = [$from]; } elseif (\is_array($from)) { $this->from = $from; } else { throw new \InvalidArgumentException('The exporter requires either a single table name or array of table names'); } return $this; } /** * Get the generic name of the table, converting the database prefix to the wildcard string. * * @param string $table The name of the table. * * @return string The name of the table with the database prefix replaced with #__. * * @since 1.0 */ protected function getGenericTableName($table) { $prefix = $this->db->getPrefix(); // Replace the magic prefix if found. return preg_replace("|^$prefix|", '#__', $table); } /** * Sets the database connector to use for importing structure and/or data. * * @param DatabaseInterface $db The database connector. * * @return $this * * @since 1.0 */ public function setDbo(DatabaseInterface $db) { $this->db = $db; return $this; } /** * Sets an internal option to export the structure of the input table(s). * * @param boolean $setting True to export the structure, false to not. * * @return $this * * @since 1.0 */ public function withStructure($setting = true) { $this->options->withStructure = (boolean) $setting; return $this; } /** * Sets an internal option to export the data of the input table(s). * * @param boolean $setting True to export the data, false to not. * * @return $this * * @since 2.0.0 */ public function withData($setting = false) { $this->options->withData = (boolean) $setting; return $this; } /** * Builds the XML data to export. * * @return array An array of XML lines (strings). * * @since 2.0.0 * @throws \Exception if an error occurs. */ protected function buildXmlData() { $buffer = []; foreach ($this->from as $table) { // Replace the magic prefix if found. $table = $this->getGenericTableName($table); // Get the details columns information. $fields = $this->db->getTableColumns($table, false); $colblob = []; foreach ($fields as $field) { // Catch blob for conversion xml if ($field->Type == 'mediumblob') { $colblob[] = $field->Field; } } $this->db->setQuery( $this->db->getQuery(true) ->select($this->db->quoteName(array_keys($fields))) ->from($this->db->quoteName($table)) ); $rows = $this->db->loadObjectList(); if (!count($rows)) { continue; } $buffer[] = ' <table_data name="' . $table . '">'; foreach ($rows as $row) { $buffer[] = ' <row>'; foreach ($row as $key => $value) { if (!in_array($key, $colblob)) { if (is_null($value)) { $buffer[] = ' <field name="' . $key . '" value_is_null></field>'; } else { $buffer[] = ' <field name="' . $key . '">' . htmlspecialchars($value, ENT_COMPAT, 'UTF-8') . '</field>'; } } else { $buffer[] = ' <field name="' . $key . '">' . base64_encode($value) . '</field>'; } } $buffer[] = ' </row>'; } $buffer[] = ' </table_data>'; } return $buffer; } } PK c�\���I I database/src/ParameterType.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Class defining the parameter types for prepared statements * * @since 2.0.0 */ final class ParameterType { /** * Defines a boolean parameter * * @var string * @since 2.0.0 */ public const BOOLEAN = 'boolean'; /** * Defines an integer parameter * * @var string * @since 2.0.0 */ public const INTEGER = 'int'; /** * Defines a large object parameter * * @var string * @since 2.0.0 */ public const LARGE_OBJECT = 'lob'; /** * Defines a null parameter * * @var string * @since 2.0.0 */ public const NULL = 'null'; /** * Defines a string parameter * * @var string * @since 2.0.0 */ public const STRING = 'string'; /** * Private constructor to prevent instantiation of this class * * @since 2.0.0 */ private function __construct() { } } PK c�\z���� �� database/src/DatabaseQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; use Joomla\Database\Exception\QueryTypeAlreadyDefinedException; use Joomla\Database\Exception\UnknownTypeException; /** * Joomla Framework Query Building Class. * * @since 1.0 * * @property-read array $bounded Holds key / value pair of bound objects. * @property-read array $parameterMapping Mapping array for parameter types. * @property-read DatabaseInterface $db The database driver. * @property-read string $sql The SQL query (if a direct query string was provided). * @property-read string $type The query type. * @property-read string|null $alias The query alias. * @property-read Query\QueryElement $element The query element for a generic query (type = null). * @property-read Query\QueryElement $select The select element. * @property-read Query\QueryElement $delete The delete element. * @property-read Query\QueryElement $update The update element. * @property-read Query\QueryElement $insert The insert element. * @property-read Query\QueryElement $from The from element. * @property-read Query\QueryElement[]|null $join The join elements. * @property-read Query\QueryElement $set The set element. * @property-read Query\QueryElement $where The where element. * @property-read Query\QueryElement $group The group element. * @property-read Query\QueryElement $having The having element. * @property-read Query\QueryElement $columns The column list for an INSERT statement. * @property-read Query\QueryElement $values The values list for an INSERT statement. * @property-read Query\QueryElement $order The order element. * @property-read boolean $autoIncrementField The auto increment insert field element. * @property-read Query\QueryElement $call The call element. * @property-read Query\QueryElement $exec The exec element. * @property-read Query\QueryElement[]|null $merge The list of query elements. * @property-read DatabaseQuery|null $querySet The query object. * @property-read array|null $selectRowNumber Details of window function. * @property-read string[] $nullDatetimeList The list of zero or null representation of a datetime. * @property-read integer|null $offset The offset for the result set. * @property-read integer|null $limit The limit for the result set. * @property-read integer $preparedIndex An internal index for the bindArray function for unique prepared parameters. */ abstract class DatabaseQuery implements QueryInterface { /** * Holds key / value pair of bound objects. * * @var array * @since 2.0.0 */ protected $bounded = []; /** * Mapping array for parameter types. * * @var array * @since 2.0.0 */ protected $parameterMapping = [ ParameterType::BOOLEAN => ParameterType::BOOLEAN, ParameterType::INTEGER => ParameterType::INTEGER, ParameterType::LARGE_OBJECT => ParameterType::LARGE_OBJECT, ParameterType::NULL => ParameterType::NULL, ParameterType::STRING => ParameterType::STRING, ]; /** * The database driver. * * @var DatabaseInterface * @since 1.0 */ protected $db; /** * The SQL query (if a direct query string was provided). * * @var string * @since 1.0 */ protected $sql; /** * The query type. * * @var string|null * @since 1.0 */ protected $type = ''; /** * The query alias. * * @var string|null * @since 2.0.0 */ protected $alias = null; /** * The query element for a generic query (type = null). * * @var Query\QueryElement * @since 1.0 */ protected $element; /** * The select element. * * @var Query\QueryElement * @since 1.0 */ protected $select; /** * The delete element. * * @var Query\QueryElement * @since 1.0 */ protected $delete; /** * The update element. * * @var Query\QueryElement * @since 1.0 */ protected $update; /** * The insert element. * * @var Query\QueryElement * @since 1.0 */ protected $insert; /** * The from element. * * @var Query\QueryElement * @since 1.0 */ protected $from; /** * The join elements. * * @var Query\QueryElement[] * @since 1.0 */ protected $join; /** * The set element. * * @var Query\QueryElement * @since 1.0 */ protected $set; /** * The where element. * * @var Query\QueryElement * @since 1.0 */ protected $where; /** * The group by element. * * @var Query\QueryElement * @since 1.0 */ protected $group; /** * The having element. * * @var Query\QueryElement * @since 1.0 */ protected $having; /** * The column list for an INSERT statement. * * @var Query\QueryElement * @since 1.0 */ protected $columns; /** * The values list for an INSERT statement. * * @var Query\QueryElement * @since 1.0 */ protected $values; /** * The order element. * * @var Query\QueryElement * @since 1.0 */ protected $order; /** * The auto increment insert field element. * * @var boolean * @since 1.0 */ protected $autoIncrementField = false; /** * The call element. * * @var Query\QueryElement * @since 1.0 */ protected $call; /** * The exec element. * * @var Query\QueryElement * @since 1.0 */ protected $exec; /** * The list of query elements, which may include UNION, UNION ALL, EXCEPT and INTERSECT. * * @var Query\QueryElement[] * @since 2.0.0 */ protected $merge; /** * The query object. * * @var Query\DatabaseQuery * @since 2.0.0 */ protected $querySet; /** * Details of window function. * * @var array|null * @since 2.0.0 */ protected $selectRowNumber; /** * The list of zero or null representation of a datetime. * * @var string[] * @since 2.0.0 */ protected $nullDatetimeList = []; /** * The offset for the result set. * * @var integer|null * @since 2.0.0 */ protected $offset; /** * The limit for the result set. * * @var integer|null * @since 2.0.0 */ protected $limit; /** * An internal index for the bindArray function for unique prepared parameters. * * @var integer * @since 2.0.0 */ protected $preparedIndex = 0; /** * Class constructor. * * @param DatabaseInterface $db The database driver. * * @since 1.0 */ public function __construct(DatabaseInterface $db = null) { $this->db = $db; } /** * Magic function to convert the query to a string. * * @return string The completed query. * * @since 1.0 */ public function __toString() { if ($this->sql) { return $this->processLimit($this->sql, $this->limit, $this->offset); } $query = ''; 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->selectRowNumber === null) { if ($this->group) { $query .= (string) $this->group; } if ($this->having) { $query .= (string) $this->having; } if ($this->merge) { // Special case for merge foreach ($this->merge as $element) { $query .= (string) $element; } } } if ($this->order) { $query .= (string) $this->order; } break; case 'querySet': $query = $this->querySet; if ($query->order || ($query->limit || $query->offset)) { // If ORDER BY or LIMIT statement exist then parentheses is required for the first query $query = "($query)"; } if ($this->merge) { // Special case for merge foreach ($this->merge as $element) { $query .= (string) $element; } } if ($this->order) { $query .= (string) $this->order; } 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; } elseif ($this->values) { // Columns-Values method 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; } $query = $this->processLimit($query, $this->limit, $this->offset); if ($this->type === 'select' && $this->alias !== null) { $query = '(' . $query . ') AS ' . $this->alias; } return $query; } /** * Magic function to get protected variable value * * @param string $name The name of the variable. * * @return mixed * * @since 1.0 */ public function __get($name) { if (property_exists($this, $name)) { return $this->$name; } $trace = debug_backtrace(); trigger_error( 'Undefined property via __get(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_NOTICE ); } /** * Add a single column, or array of columns to the CALL clause of the 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 $this * * @since 1.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function call($columns) { if ($this->type !== null && $this->type !== '' && $this->type !== 'call') { throw new QueryTypeAlreadyDefinedException( \sprintf( 'Cannot set the query type to "call" as the query type is already set to "%s".' . ' You should either call the `clear()` method to reset the type or create a new query object.', $this->type ) ); } $this->type = 'call'; if ($this->call === null) { $this->call = new Query\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->castAs('CHAR', 'a')); * * @param string $type The type of string to cast as. * @param string $value The value to cast as a char. * @param string $length Optionally specify the length of the field (if the type supports it otherwise * ignored). * * @return string SQL statement to cast the value as a char type. * * @since 1.0 */ public function castAs(string $type, string $value, ?string $length = null) { switch (strtoupper($type)) { case 'CHAR': return $value; default: throw new UnknownTypeException( sprintf( 'Type %s was not recognised by the database driver as valid for casting', $type ) ); } } /** * 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 SQL statement to cast the value as a char type. * * @since 1.0 * @deprecated 3.0 Use $query->castAs('CHAR', $value) */ public function castAsChar($value) { return $this->castAs('CHAR', $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|null $operator Comparison operator between charLength integer value and $condition * @param string|null $condition Integer value to compare charLength with. * * @return string The required char length call. * * @since 1.0 */ public function charLength($field, $operator = null, $condition = null) { $statement = 'CHAR_LENGTH(' . $field . ')'; if ($operator !== null && $condition !== null) { $statement .= ' ' . $operator . ' ' . $condition; } return $statement; } /** * 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 $this * * @since 1.0 */ public function clear($clause = null) { $this->sql = null; switch ($clause) { case 'alias': $this->alias = null; break; case 'select': $this->select = null; $this->type = null; $this->selectRowNumber = 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 'querySet': $this->querySet = null; $this->type = 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 'merge': $this->merge = 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 'offset': $this->offset = 0; break; case 'bounded': $this->bounded = []; break; default: $this->type = null; $this->alias = null; $this->bounded = []; $this->select = null; $this->selectRowNumber = null; $this->delete = null; $this->update = null; $this->insert = null; $this->querySet = null; $this->from = null; $this->join = null; $this->set = null; $this->where = null; $this->group = null; $this->having = null; $this->merge = null; $this->order = null; $this->columns = null; $this->values = null; $this->autoIncrementField = null; $this->exec = null; $this->call = 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 array|string $columns A column name, or array of column names. * * @return $this * * @since 1.0 */ public function columns($columns) { if ($this->columns === null) { $this->columns = new Query\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 string[] $values An array of values to concatenate. * @param string|null $separator As separator to place between each value. * * @return string The concatenated values. * * @since 1.0 */ public function concatenate($values, $separator = null) { if ($separator !== null) { return 'CONCATENATE(' . implode(' || ' . $this->quote($separator) . ' || ', $values) . ')'; } return 'CONCATENATE(' . implode(' || ', $values) . ')'; } /** * Gets the current date and time. * * Usage: * $query->where('published_up < '.$query->currentTimestamp()); * * @return string * * @since 1.0 */ public function currentTimestamp() { return 'CURRENT_TIMESTAMP()'; } /** * 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 db quoted string representation of the date to add to. May be date or datetime * @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 * * @link https://dev.mysql.com/doc/en/date-and-time-functions.html * @since 1.5.0 */ public function dateAdd($date, $interval, $datePart) { return 'DATE_ADD(' . $date . ', INTERVAL ' . $interval . ' ' . $datePart . ')'; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function dateFormat() { if (!($this->db instanceof DatabaseInterface)) { throw new \RuntimeException(sprintf('A %s instance is not set to the query object.', DatabaseInterface::class)); } return $this->db->getDateFormat(); } /** * Creates a HTML formatted dump of the query for debugging purposes. * * Usage: * echo $query->dump(); * * @return string * * @since 1.0 * @deprecated 3.0 Deprecated without replacement */ public function dump() { trigger_deprecation( 'joomla/database', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); return '<pre class="jdatabasequery">' . str_replace('#__', $this->db->getPrefix(), $this) . '</pre>'; } /** * Add a table name to the DELETE clause of the query. * * Usage: * $query->delete('#__a')->where('id = 1'); * * @param string $table The name of the table to delete from. * * @return $this * * @since 1.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function delete($table = null) { if ($this->type !== null && $this->type !== '' && $this->type !== 'delete') { throw new QueryTypeAlreadyDefinedException( \sprintf( 'Cannot set the query type to "delete" as the query type is already set to "%s".' . ' You should either call the `clear()` method to reset the type or create a new query object.', $this->type ) ); } $this->type = 'delete'; $this->delete = new Query\QueryElement('DELETE', null); if (!empty($table)) { $this->from($table); } return $this; } /** * Alias for escape method * * @param string $text The string to be escaped. * @param boolean $extra Optional parameter to provide extra escaping. * * @return string The escaped string. * * @since 1.0 * @throws \RuntimeException if the internal db property is not a valid object. */ public function e($text, $extra = false) { return $this->escape($text, $extra); } /** * 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 DatabaseDriver. * * @param string $text The string to be escaped. * @param boolean $extra Optional parameter to provide extra escaping. * * @return string The escaped string. * * @since 1.0 * @throws \RuntimeException if the internal db property is not a valid object. */ public function escape($text, $extra = false) { if (!($this->db instanceof DatabaseInterface)) { throw new \RuntimeException(sprintf('A %s instance is not set to the query object.', DatabaseInterface::class)); } return $this->db->escape($text, $extra); } /** * Add a single column, or array of columns to the EXEC clause of the query. * * Usage: * $query->exec('a.*')->exec('b.id'); * $query->exec(array('a.*', 'b.id')); * * @param array|string $columns A string or an array of field names. * * @return $this * * @since 1.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function exec($columns) { if ($this->type !== null && $this->type !== '' && $this->type !== 'exec') { throw new QueryTypeAlreadyDefinedException( \sprintf( 'Cannot set the query type to "exec" as the query type is already set to "%s".' . ' You should either call the `clear()` method to reset the type or create a new query object.', $this->type ) ); } $this->type = 'exec'; if ($this->exec === null) { $this->exec = new Query\QueryElement('EXEC', $columns); } else { $this->exec->append($columns); } return $this; } /** * Find a value in a varchar used like a set. * * Ensure that the value is an integer before passing to the method. * * Usage: * $query->findInSet((int) $parent->id, 'a.assigned_cat_ids') * * @param string $value The value to search for. * @param string $set The set of values. * * @return string A representation of the MySQL find_in_set() function for the driver. * * @since 1.5.0 */ public function findInSet($value, $set) { return ''; } /** * Add a table to the FROM clause of the query. * * Usage: * $query->select('*')->from('#__a'); * $query->select('*')->from($subquery->alias('a')); * * @param string|DatabaseQuery $table The name of the table or a DatabaseQuery object (or a child of it) with alias set. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function from($table) { if ($table instanceof $this && $table->alias === null) { throw new \RuntimeException('JLIB_DATABASE_ERROR_NULL_SUBQUERY_ALIAS'); } if ($this->from === null) { $this->from = new Query\QueryElement('FROM', $table); } else { $this->from->append($table); } return $this; } /** * Add alias for current query. * * Usage: * $query->select('*')->from('#__a')->alias('subquery'); * * @param string $alias Alias used for a JDatabaseQuery. * * @return $this * * @since 2.0.0 */ public function alias($alias) { $this->alias = $alias; 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. * * @since 1.0 */ 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. * * @since 1.0 */ 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. * * @since 1.0 */ 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. * * @since 1.0 */ 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. * * @since 1.0 */ 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. * * @since 1.0 */ public function second($date) { return 'SECOND(' . $date . ')'; } /** * Add a grouping column to the GROUP clause of the query. * * Usage: * $query->group('id'); * * @param array|string $columns A string or array of ordering columns. * * @return $this * * @since 1.0 */ public function group($columns) { if ($this->group === null) { $this->group = new Query\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 array|string $conditions A string or array of columns. * @param string $glue The glue by which to join the conditions. Defaults to AND. * * @return $this * * @since 1.0 */ public function having($conditions, $glue = 'AND') { if ($this->having === null) { $glue = strtoupper($glue); $this->having = new Query\QueryElement('HAVING', $conditions, " $glue "); } else { $this->having->append($conditions); } return $this; } /** * Add a table name to the INSERT clause of the 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 string $table The name of the table to insert data into. * @param boolean $incrementField The name of the field to auto increment. * * @return $this * * @since 1.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function insert($table, $incrementField = false) { if ($this->type !== null && $this->type !== '' && $this->type !== 'insert') { throw new QueryTypeAlreadyDefinedException( \sprintf( 'Cannot set the query type to "insert" as the query type is already set to "%s".' . ' You should either call the `clear()` method to reset the type or create a new query object.', $this->type ) ); } $this->type = 'insert'; $this->insert = new Query\QueryElement('INSERT INTO', $table); $this->autoIncrementField = $incrementField; return $this; } /** * Add a JOIN clause to the query. * * Usage: * $query->join('INNER', 'b', 'b.id = a.id); * * @param string $type The type of join. This string is prepended to the JOIN keyword. * @param string $table The name of table. * @param string $condition The join condition. * * @return $this * * @since 1.0 */ public function join($type, $table, $condition = null) { $type = strtoupper($type) . ' JOIN'; if ($condition !== null) { $this->join[] = new Query\QueryElement($type, [$table, $condition], ' ON '); } else { $this->join[] = new Query\QueryElement($type, $table); } return $this; } /** * Add an INNER JOIN clause to the query. * * Usage: * $query->innerJoin('b', 'b.id = a.id')->innerJoin('c', 'c.id = b.id'); * * @param string $table The name of table. * @param string $condition The join condition. * * @return $this * * @since 1.0 */ public function innerJoin($table, $condition = null) { return $this->join('INNER', $table, $condition); } /** * Add an OUTER JOIN clause to the query. * * Usage: * $query->outerJoin('b', 'b.id = a.id')->leftJoin('c', 'c.id = b.id'); * * @param string $table The name of table. * @param string $condition The join condition. * * @return $this * * @since 1.0 */ public function outerJoin($table, $condition = null) { return $this->join('OUTER', $table, $condition); } /** * Add a LEFT JOIN clause to the query. * * Usage: * $query->leftJoin('b', 'b.id = a.id')->leftJoin('c', 'c.id = b.id'); * * @param string $table The name of table. * @param string $condition The join condition. * * @return $this * * @since 1.0 */ public function leftJoin($table, $condition = null) { return $this->join('LEFT', $table, $condition); } /** * Add a RIGHT JOIN clause to the query. * * Usage: * $query->rightJoin('b', 'b.id = a.id')->rightJoin('c', 'c.id = b.id'); * * @param string $table The name of table. * @param string $condition The join condition. * * @return $this * * @since 1.0 */ public function rightJoin($table, $condition = null) { return $this->join('RIGHT', $table, $condition); } /** * 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 integer * * @since 1.0 */ 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. * * @since 1.0 * @throws \RuntimeException */ public function nullDate($quoted = true) { if (!($this->db instanceof DatabaseInterface)) { throw new \RuntimeException(sprintf('A %s instance is not set to the query object.', DatabaseInterface::class)); } $result = $this->db->getNullDate(); if ($quoted) { return $this->db->quote($result); } return $result; } /** * Generate a SQL statement to check if column represents a zero or null datetime. * * Usage: * $query->where($query->isNullDatetime('modified_date')); * * @param string $column A column name. * * @return string * * @since 2.0.0 */ public function isNullDatetime($column) { if (!$this->db instanceof DatabaseInterface) { throw new \RuntimeException(sprintf('A %s instance is not set to the query object.', DatabaseInterface::class)); } if ($this->nullDatetimeList) { return "($column IN (" . implode(', ', $this->db->quote($this->nullDatetimeList)) . ") OR $column IS NULL)"; } return "$column IS NULL"; } /** * Add a ordering column to the ORDER clause of the query. * * Usage: * $query->order('foo')->order('bar'); * $query->order(array('foo','bar')); * * @param array|string $columns A string or array of ordering columns. * * @return $this * * @since 1.0 */ public function order($columns) { if ($this->order === null) { $this->order = new Query\QueryElement('ORDER BY', $columns); } else { $this->order->append($columns); } return $this; } /** * Alias for quote method * * @param array|string $text A string or an array of strings to quote. * @param boolean $escape True (default) to escape the string, false to leave it unchanged. * * @return string The quoted input string. * * @since 1.0 * @throws \RuntimeException if the internal db property is not a valid object. */ public function q($text, $escape = true) { return $this->quote($text, $escape); } /** * 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 DatabaseDriver. * * Usage: * $query->quote('fulltext'); * $query->q('fulltext'); * $query->q(array('option', 'fulltext')); * * @param array|string $text A string or an array of strings to quote. * @param boolean $escape True (default) to escape the string, false to leave it unchanged. * * @return string The quoted input string. * * @since 1.0 * @throws \RuntimeException if the internal db property is not a valid object. */ public function quote($text, $escape = true) { if (!($this->db instanceof DatabaseInterface)) { throw new \RuntimeException(sprintf('A %s instance is not set to the query object.', DatabaseInterface::class)); } return $this->db->quote($text, $escape); } /** * Alias for quoteName method * * @param array|string $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 array|string $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 array|string The quote wrapped name, same type of $name. * * @since 1.0 * @throws \RuntimeException if the internal db property is not a valid object. */ public function qn($name, $as = null) { return $this->quoteName($name, $as); } /** * 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 DatabaseDriver. * * Usage: * $query->quoteName('#__a'); * $query->qn('#__a'); * * @param array|string $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 array|string $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 array|string The quote wrapped name, same type of $name. * * @since 1.0 * @throws \RuntimeException if the internal db property is not a valid object. */ public function quoteName($name, $as = null) { if (!($this->db instanceof DatabaseInterface)) { throw new \RuntimeException(sprintf('A %s instance is not set to the query object.', DatabaseInterface::class)); } return $this->db->quoteName($name, $as); } /** * Get the function to return a random floating-point value * * Usage: * $query->rand(); * * @return string * * @since 1.5.0 */ public function rand() { return ''; } /** * Get the regular expression operator * * Usage: * $query->where('field ' . $query->regexp($search)); * * @param string $value The regex pattern. * * @return string * * @since 1.5.0 */ public function regexp($value) { return ' ' . $value; } /** * 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 array|string $columns A string or an array of field names. * * @return $this * * @since 1.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function select($columns) { if ($this->type !== null && $this->type !== '' && $this->type !== 'select') { throw new QueryTypeAlreadyDefinedException( \sprintf( 'Cannot set the query type to "select" as the query type is already set to "%s".' . ' You should either call the `clear()` method to reset the type or create a new query object.', $this->type ) ); } $this->type = 'select'; if ($this->select === null) { $this->select = new Query\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 array|string $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 $this * * @since 1.0 */ public function set($conditions, $glue = ',') { if ($this->set === null) { $glue = strtoupper($glue); $this->set = new Query\QueryElement('SET', $conditions, \PHP_EOL . "\t$glue "); } else { $this->set->append($conditions); } return $this; } /** * 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 $this * * @since 2.0.0 */ public function setLimit($limit = 0, $offset = 0) { $this->limit = (int) $limit; $this->offset = (int) $offset; 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 DatabaseQuery|string $sql A SQL query string or DatabaseQuery object * * @return $this * * @since 1.0 */ public function setQuery($sql) { $this->sql = $sql; return $this; } /** * Add a table name to the UPDATE clause of the query. * * Usage: * $query->update('#__foo')->set(...); * * @param string $table A table to update. * * @return $this * * @since 1.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function update($table) { if ($this->type !== null && $this->type !== '' && $this->type !== 'update') { throw new QueryTypeAlreadyDefinedException( \sprintf( 'Cannot set the query type to "update" as the query type is already set to "%s".' . ' You should either call the `clear()` method to reset the type or create a new query object.', $this->type ) ); } $this->type = 'update'; $this->update = new Query\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 array|string $values A single tuple, or array of tuples. * * @return $this * * @since 1.0 */ public function values($values) { if ($this->values === null) { $this->values = new Query\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 array|string $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 $this * * @since 1.0 */ public function where($conditions, $glue = 'AND') { if ($this->where === null) { $glue = strtoupper($glue); $this->where = new Query\QueryElement('WHERE', $conditions, " $glue "); } else { $this->where->append($conditions); } return $this; } /** * Add a WHERE IN statement to the query. * * Note that all values must be the same data type. * * Usage * $query->whereIn('id', [1, 2, 3]); * * @param string $keyName Key name for the where clause * @param array $keyValues Array of values to be matched * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $keyValues * * @return $this * * @since 2.0.0 */ public function whereIn(string $keyName, array $keyValues, $dataType = ParameterType::INTEGER) { return $this->where( $keyName . ' IN (' . implode(',', $this->bindArray($keyValues, $dataType)) . ')' ); } /** * Add a WHERE NOT IN statement to the query. * * Note that all values must be the same data type. * * Usage * $query->whereNotIn('id', [1, 2, 3]); * * @param string $keyName Key name for the where clause * @param array $keyValues Array of values to be matched * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $keyValues * * @return $this * * @since 2.0.0 */ public function whereNotIn(string $keyName, array $keyValues, $dataType = ParameterType::INTEGER) { return $this->where( $keyName . ' NOT IN (' . implode(',', $this->bindArray($keyValues, $dataType)) . ')' ); } /** * Extend the WHERE clause with a single condition or an array of conditions, with a potentially * different logical operator from the one in the current WHERE clause. * * Usage: * $query->where(array('a = 1', 'b = 2'))->extendWhere('XOR', array('c = 3', 'd = 4')); * will produce: WHERE ((a = 1 AND b = 2) XOR (c = 3 AND d = 4) * * @param string $outerGlue The glue by which to join the conditions to the current WHERE conditions. * @param mixed $conditions A string or array of WHERE conditions. * @param string $innerGlue The glue by which to join the conditions. Defaults to AND. * * @return $this * * @since 1.3.0 */ public function extendWhere($outerGlue, $conditions, $innerGlue = 'AND') { // Replace the current WHERE with a new one which has the old one as an unnamed child. $this->where = new Query\QueryElement('WHERE', $this->where->setName('()'), " $outerGlue "); // Append the new conditions as a new unnamed child. $this->where->append(new Query\QueryElement('()', $conditions, " $innerGlue ")); return $this; } /** * Extend the WHERE clause with an OR and a single condition or an array of conditions. * * Usage: * $query->where(array('a = 1', 'b = 2'))->orWhere(array('c = 3', 'd = 4')); * will produce: WHERE ((a = 1 AND b = 2) OR (c = 3 AND d = 4) * * @param mixed $conditions A string or array of WHERE conditions. * @param string $glue The glue by which to join the conditions. Defaults to AND. * * @return $this * * @since 1.3.0 */ public function orWhere($conditions, $glue = 'AND') { return $this->extendWhere('OR', $conditions, $glue); } /** * Extend the WHERE clause with an AND and a single condition or an array of conditions. * * Usage: * $query->where(array('a = 1', 'b = 2'))->andWhere(array('c = 3', 'd = 4')); * will produce: WHERE ((a = 1 AND b = 2) AND (c = 3 OR d = 4) * * @param mixed $conditions A string or array of WHERE conditions. * @param string $glue The glue by which to join the conditions. Defaults to OR. * * @return $this * * @since 1.3.0 */ public function andWhere($conditions, $glue = 'OR') { return $this->extendWhere('AND', $conditions, $glue); } /** * Method to add a variable to an internal array that will be bound to a prepared SQL statement before query execution. * * @param array|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. It can be an array, in this case it has to be * same length of $key; The value is passed by reference to support output * parameters such as those possible with stored procedures. * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $key * @param integer $length The length of the variable. Usually required for OUTPUT parameters. * @param array $driverOptions Optional driver options to be used. * * @return $this * * @since 1.5.0 * @throws \InvalidArgumentException */ public function bind($key, &$value, $dataType = ParameterType::STRING, $length = 0, $driverOptions = []) { if (!$key) { throw new \InvalidArgumentException('A key is required'); } $key = (array) $key; $count = \count($key); if (\is_array($value)) { if ($count != \count($value)) { throw new \InvalidArgumentException('Array length of $key and $value are not equal'); } reset($value); } if (\is_array($dataType) && $count != \count($dataType)) { throw new \InvalidArgumentException('Array length of $key and $dataType are not equal'); } foreach ($key as $index) { if (\is_array($value)) { $localValue = &$value[key($value)]; next($value); } else { $localValue = &$value; } if (\is_array($dataType)) { $localDataType = array_shift($dataType); } else { $localDataType = $dataType; } // Validate parameter type if (!isset($this->parameterMapping[$localDataType])) { throw new \InvalidArgumentException(sprintf('Unsupported parameter type `%s`', $localDataType)); } $obj = new \stdClass; $obj->value = &$localValue; $obj->dataType = $this->parameterMapping[$localDataType]; $obj->length = $length; $obj->driverOptions = $driverOptions; // Add the Key/Value into the bounded array $this->bounded[$index] = $obj; unset($localValue); } return $this; } /** * Method to unbind a bound variable. * * @param array|string|integer $key The key or array of keys to unbind. * * @return $this * * @since 2.0.0 */ public function unbind($key) { if (\is_array($key)) { foreach ($key as $k) { unset($this->bounded[$k]); } } else { unset($this->bounded[$key]); } return $this; } /** * Binds an array of values and returns an array of prepared parameter names. * * Note that all values must be the same data type. * * Usage: * $query->where('column in (' . implode(',', $query->bindArray($keyValues, $dataType)) . ')'); * * @param array $values Values to bind * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $key * * @return array An array with parameter names * * @since 2.0.0 */ public function bindArray(array $values, $dataType = ParameterType::INTEGER) { $parameterNames = []; for ($i = 0; $i < count($values); $i++) { $parameterNames[] = ':preparedArray' . (++$this->preparedIndex); } $this->bind($parameterNames, $values, $dataType); return $parameterNames; } /** * Method to provide basic copy support. * * Any object pushed into the data of this class should have its own __clone() implementation. * This method does not support copying objects in a multidimensional array. * * @return void * * @since 1.0 */ public function __clone() { foreach ($this as $k => $v) { if ($k === 'db') { continue; } if (\is_object($v)) { $this->{$k} = clone $v; } elseif (\is_array($v)) { foreach ($v as $i => $element) { if (\is_object($element)) { $this->{$k}[$i] = clone $element; } } } } } /** * 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.5.0 */ public function &getBounded($key = null) { if (empty($key)) { return $this->bounded; } if (isset($this->bounded[$key])) { return $this->bounded[$key]; } } /** * Combine a select statement to the current query by one of the set operators. * Operators: UNION, UNION ALL, EXCEPT or INTERSECT. * * @param string $name The name of the set operator with parentheses. * @param DatabaseQuery|string $query The DatabaseQuery object or string. * * @return $this * * @since 2.0.0 */ protected function merge($name, $query) { $this->type = $this->type ?: 'select'; $this->merge[] = new Query\QueryElement($name, $query); return $this; } /** * Add a query to UNION with the current query. * * Usage: * $query->union('SELECT name FROM #__foo') * $query->union('SELECT name FROM #__foo', true) * * @param DatabaseQuery|string $query The DatabaseQuery object or string to union. * @param boolean $distinct True to only return distinct rows from the union. * * @return $this * * @since 1.0 */ public function union($query, $distinct = true) { // Set up the name with parentheses, the DISTINCT flag is redundant return $this->merge($distinct ? 'UNION ()' : 'UNION ALL ()', $query); } /** * Add a query to UNION ALL with the current query. * * Usage: * $query->unionAll('SELECT name FROM #__foo') * * @param DatabaseQuery|string $query The DatabaseQuery object or string to union. * * @return $this * * @see union * @since 1.5.0 */ public function unionAll($query) { return $this->union($query, false); } /** * Set a single query to the query set. * On this type of DatabaseQuery you can use union(), unionAll(), order() and setLimit() * * Usage: * $query->querySet($query2->select('name')->from('#__foo')->order('id DESC')->setLimit(1)) * ->unionAll($query3->select('name')->from('#__foo')->order('id')->setLimit(1)) * ->order('name') * ->setLimit(1) * * @param DatabaseQuery $query The DatabaseQuery object or string. * * @return $this * * @since 2.0.0 */ public function querySet($query) { $this->type = 'querySet'; $this->querySet = $query; return $this; } /** * Create a DatabaseQuery object of type querySet from current query. * * Usage: * $query->select('name')->from('#__foo')->order('id DESC')->setLimit(1) * ->toQuerySet() * ->unionAll($query2->select('name')->from('#__foo')->order('id')->setLimit(1)) * ->order('name') * ->setLimit(1) * * @return DatabaseQuery A new object of the DatabaseQuery. * * @since 2.0.0 */ public function toQuerySet() { return (new static($this->db))->querySet($this); } /** * 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. * * @since 1.0 */ 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(); case 'z': return $query->nullDate(false); case 'Z': return $query->nullDate(true); } // Increment the argument index only if argument specifier not provided. $index = is_numeric($match[4]) ? (int) $match[4] : $i++; if (!$index || !isset($args[$index])) { // TODO - What to do? sprintf() throws a Warning in these cases. $replacement = ''; } else { $replacement = $args[$index]; } switch ($match[5]) { case 'a': return 0 + $replacement; case 'e': return $query->escape($replacement); case 'E': return $query->escape($replacement, true); case 'n': return $query->quoteName($replacement); case 'q': return $query->quote($replacement); case 'Q': return $query->quote($replacement, false); case 'r': return $replacement; // Dates case 'y': return $query->year($query->quote($replacement)); case 'Y': return $query->year($query->quoteName($replacement)); case 'm': return $query->month($query->quote($replacement)); case 'M': return $query->month($query->quoteName($replacement)); case 'd': return $query->day($query->quote($replacement)); case 'D': return $query->day($query->quoteName($replacement)); case 'h': return $query->hour($query->quote($replacement)); case 'H': return $query->hour($query->quoteName($replacement)); case 'i': return $query->minute($query->quote($replacement)); case 'I': return $query->minute($query->quoteName($replacement)); case 's': return $query->second($query->quote($replacement)); case 'S': return $query->second($query->quoteName($replacement)); } 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); } /** * Validate arguments which are passed to selectRowNumber method and set up common variables. * * @param string $orderBy An expression of ordering for window function. * @param string $orderColumnAlias An alias for new ordering column. * * @return void * * @since 2.0.0 * @throws \RuntimeException */ protected function validateRowNumber($orderBy, $orderColumnAlias) { if ($this->selectRowNumber) { throw new \RuntimeException("Method 'selectRowNumber' can be called only once per instance."); } $this->type = 'select'; $this->selectRowNumber = [ 'orderBy' => $orderBy, 'orderColumnAlias' => $orderColumnAlias, ]; } /** * Return the number of the current row. * * Usage: * $query->select('id'); * $query->selectRowNumber('ordering,publish_up DESC', 'new_ordering'); * $query->from('#__content'); * * @param string $orderBy An expression of ordering for window function. * @param string $orderColumnAlias An alias for new ordering column. * * @return $this * * @since 2.0.0 * @throws \RuntimeException */ public function selectRowNumber($orderBy, $orderColumnAlias) { $this->validateRowNumber($orderBy, $orderColumnAlias); return $this->select("ROW_NUMBER() OVER (ORDER BY $orderBy) AS $orderColumnAlias"); } } PK c�\ �.� � # database/src/StatementInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Interface defining a query statement. * * This interface is a partial standalone implementation of PDOStatement. * * @since 2.0.0 */ interface StatementInterface { /** * Binds a parameter to the specified variable name. * * @param string|integer $parameter Parameter identifier. For a prepared statement using named placeholders, this will be a parameter * name of the form `:name`. For a prepared statement using question mark placeholders, this will be * the 1-indexed position of the parameter. * @param mixed $variable Name of the PHP variable to bind to the SQL statement parameter. * @param string $dataType Constant corresponding to a SQL datatype, this should be the processed type from the QueryInterface. * @param integer $length The length of the variable. Usually required for OUTPUT parameters. * @param array $driverOptions Optional driver options to be used. * * @return boolean * * @since 2.0.0 */ public function bindParam($parameter, &$variable, string $dataType = ParameterType::STRING, ?int $length = null, ?array $driverOptions = null); /** * Closes the cursor, enabling the statement to be executed again. * * @return void * * @since 2.0.0 */ public function closeCursor(): void; /** * Fetches the SQLSTATE associated with the last operation on the statement handle. * * @return string * * @since 2.0.0 */ public function errorCode(); /** * Fetches extended error information associated with the last operation on the statement handle. * * @return array * * @since 2.0.0 */ public function errorInfo(); /** * Executes a prepared statement * * @param array|null $parameters An array of values with as many elements as there are bound parameters in the SQL statement being executed. * * @return boolean * * @since 2.0.0 */ public function execute(?array $parameters = null); /** * Fetches the next row from a result set * * @param integer|null $fetchStyle Controls how the next row will be returned to the caller. This value must be one of the * FetchMode constants, defaulting to value of FetchMode::MIXED. * @param integer $cursorOrientation For a StatementInterface object representing a scrollable cursor, this value determines which row * will be returned to the caller. This value must be one of the FetchOrientation constants, * defaulting to FetchOrientation::NEXT. * @param integer $cursorOffset For a StatementInterface object representing a scrollable cursor for which the cursorOrientation * parameter is set to FetchOrientation::ABS, this value specifies the absolute number of the row in * the result set that shall be fetched. For a StatementInterface object representing a scrollable * cursor for which the cursorOrientation parameter is set to FetchOrientation::REL, this value * specifies the row to fetch relative to the cursor position before `fetch()` was called. * * @return mixed The return value of this function on success depends on the fetch type. In all cases, boolean false is returned on failure. * * @since 2.0.0 */ public function fetch(?int $fetchStyle = null, int $cursorOrientation = FetchOrientation::NEXT, int $cursorOffset = 0); /** * Returns the number of rows affected by the last SQL statement. * * @return integer * * @since 2.0.0 */ public function rowCount(): int; /** * Sets the fetch mode to use while iterating this statement. * * @param integer $fetchMode The fetch mode, must be one of the FetchMode constants. * @param mixed ...$args Optional mode-specific arguments. * * @return void * * @since 2.0.0 */ public function setFetchMode(int $fetchMode, ...$args): void; } PK c�\ � 7| | ! database/src/Pgsql/PgsqlQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Pgsql; use Joomla\Database\Pdo\PdoQuery; use Joomla\Database\Query\PostgresqlQueryBuilder; use Joomla\Database\Query\QueryElement; /** * PDO PostgreSQL Query Building Class. * * @since 1.0 * * @property-read QueryElement $forUpdate The FOR UPDATE element used in "FOR UPDATE" lock * @property-read QueryElement $forShare The FOR SHARE element used in "FOR SHARE" lock * @property-read QueryElement $noWait The NOWAIT element used in "FOR SHARE" and "FOR UPDATE" lock * @property-read QueryElement $returning The RETURNING element of INSERT INTO */ class PgsqlQuery extends PdoQuery { use PostgresqlQueryBuilder; /** * The list of zero or null representation of a datetime. * * @var array * @since 2.0.0 */ protected $nullDatetimeList = ['1970-01-01 00:00:00']; /** * Casts a value to a char. * * Ensure that the value is properly quoted before passing to the method. * * Usage: * $query->select($query->castAsChar('a')); * $query->select($query->castAsChar('a', 40)); * * @param string $value The value to cast as a char. * @param string $length The length of the char. * * @return string Returns the cast value. * * @since 1.8.0 */ public function castAsChar($value, $length = null) { if ((int) $length < 1) { return $value . '::text'; } return 'CAST(' . $value . ' AS CHAR(' . $length . '))'; } } PK c�\ ��� � $ database/src/Pgsql/PgsqlExporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Pgsql; use Joomla\Database\DatabaseExporter; /** * PDO PostgreSQL Database Exporter. * * @since 1.5.0 */ class PgsqlExporter extends DatabaseExporter { /** * Builds the XML data for the tables to export. * * @return string An XML string * * @since 1.0 * @throws \Exception if an error occurs. */ protected function buildXml() { $buffer = []; $buffer[] = '<?xml version="1.0"?>'; $buffer[] = '<postgresqldump xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">'; $buffer[] = ' <database name="">'; if ($this->options->withStructure) { $buffer = array_merge($buffer, $this->buildXmlStructure()); } if ($this->options->withData) { $buffer = array_merge($buffer, $this->buildXmlData()); } $buffer[] = ' </database>'; $buffer[] = '</postgresqldump>'; return implode("\n", $buffer); } /** * Builds the XML structure to export. * * @return array An array of XML lines (strings). * * @since 1.0 * @throws \Exception if an error occurs. */ protected function buildXmlStructure() { $buffer = []; foreach ($this->from as $table) { // Replace the magic prefix if found. $table = $this->getGenericTableName($table); // Get the details columns information. $fields = $this->db->getTableColumns($table, false); $keys = $this->db->getTableKeys($table); $sequences = $this->db->getTableSequences($table); $buffer[] = ' <table_structure name="' . $table . '">'; foreach ($sequences as $sequence) { $buffer[] = ' <sequence Name="' . $this->getGenericTableName($sequence->sequence) . '" Schema="' . $sequence->schema . '"' . ' Table="' . $table . '" Column="' . $sequence->column . '" Type="' . $sequence->data_type . '"' . ' Start_Value="' . $sequence->start_value . '" Min_Value="' . $sequence->minimum_value . '"' . ' Max_Value="' . $sequence->maximum_value . '" Last_Value="' . $this->db->getSequenceLastValue($sequence->sequence) . '"' . ' Increment="' . $sequence->increment . '" Cycle_option="' . $sequence->cycle_option . '"' . ' Is_called="' . $this->db->getSequenceIsCalled($sequence->sequence) . '"' . ' />'; } foreach ($fields as $field) { $buffer[] = ' <field Field="' . $field->column_name . '" Type="' . $field->type . '" Null="' . $field->null . '"' . ' Default="' . $field->Default . '" Comments="' . $field->comments . '" />'; } foreach ($keys as $key) { $buffer[] = ' <key Index="' . $this->getGenericTableName($key->idxName) . '" is_primary="' . $key->isPrimary . '"' . ' is_unique="' . $key->isUnique . '" Key_name="' . $this->db->getNamesKey($table, $key->indKey) . '"' . ' Query=\'' . $key->Query . '\' />'; } $buffer[] = ' </table_structure>'; } return $buffer; } /** * Builds the XML data to export. * * @return array An array of XML lines (strings). * * @since 2.0.0 * @throws \Exception if an error occurs. */ protected function buildXmlData() { $buffer = []; foreach ($this->from as $table) { // Replace the magic prefix if found. $table = $this->getGenericTableName($table); // Get the details columns information. $fields = $this->db->getTableColumns($table, false); $colblob = []; foreach ($fields as $field) { // Catch blob for xml conversion // PostgreSQL binary large object type if ($field->Type == 'bytea') { $colblob[] = $field->Field; } } $query = $this->db->getQuery(true); $query->select($query->quoteName(array_keys($fields))) ->from($query->quoteName($table)); $this->db->setQuery($query); $rows = $this->db->loadObjectList(); if (!count($rows)) { continue; } $buffer[] = ' <table_data name="' . $table . '">'; foreach ($rows as $row) { $buffer[] = ' <row>'; foreach ($row as $key => $value) { if (!in_array($key, $colblob)) { $buffer[] = ' <field name="' . $key . '">' . htmlspecialchars($value, ENT_COMPAT, 'UTF-8') . '</field>'; } else { $buffer[] = ' <field name="' . $key . '">' . stream_get_contents($value) . '</field>'; } } $buffer[] = ' </row>'; } $buffer[] = ' </table_data>'; } return $buffer; } /** * Checks if all data and options are in order prior to exporting. * * @return $this * * @since 1.5.0 * @throws \RuntimeException */ public function check() { // Check if the db connector has been set. if (!($this->db instanceof PgsqlDriver)) { throw new \RuntimeException('Database connection wrong type.'); } // Check if the tables have been specified. if (empty($this->from)) { throw new \RuntimeException('ERROR: No Tables Specified'); } return $this; } } PK c�\ ���p �p " database/src/Pgsql/PgsqlDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Pgsql; use Joomla\Database\Pdo\PdoDriver; /** * PostgreSQL PDO Database Driver * * @since 1.5.0 */ class PgsqlDriver extends PdoDriver { /** * The database driver name * * @var string * @since 1.5.0 */ public $name = 'pgsql'; /** * 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.5.0 */ protected $nameQuote = '"'; /** * The null or zero representation of a timestamp for the database driver. This should be * defined in child classes to hold the appropriate value for the engine. * * @var string * @since 1.5.0 */ protected $nullDate = '1970-01-01 00:00:00'; /** * The minimum supported database version. * * @var string * @since 1.5.0 */ protected static $dbMinimum = '9.4.0'; /** * Operator used for concatenation * * @var string * @since 1.5.0 */ protected $concat_operator = '||'; /** * Database object constructor * * @param array $options List of options used to configure the connection * * @since 1.5.0 */ public function __construct($options) { $options['driver'] = 'pgsql'; $options['host'] = $options['host'] ?? 'localhost'; $options['user'] = $options['user'] ?? ''; $options['password'] = $options['password'] ?? ''; $options['database'] = $options['database'] ?? ''; $options['port'] = $options['port'] ?? null; // Finalize initialization parent::__construct($options); } /** * Connects to the database if needed. * * @return void * * @since 1.5.0 * @throws \RuntimeException */ public function connect() { if ($this->getConnection()) { return; } parent::connect(); $this->setQuery('SET standard_conforming_strings = off')->execute(); } /** * Method to get the database collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database or boolean false if not supported. * * @since 1.5.0 * @throws \RuntimeException */ public function getCollation() { $this->setQuery('SHOW LC_COLLATE'); $array = $this->loadAssocList(); return $array[0]['lc_collate']; } /** * Method to get the database connection collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database connection (string) or boolean false if not supported. * * @since 1.6.0 * @throws \RuntimeException */ public function getConnectionCollation() { $this->setQuery('SHOW LC_COLLATE'); $array = $this->loadAssocList(); return $array[0]['lc_collate']; } /** * Method to get the database encryption details (cipher and protocol) in use. * * @return string The database encryption details. * * @since 2.0.0 * @throws \RuntimeException */ public function getConnectionEncryption(): string { // Requires PostgreSQL 9.5 or newer if (version_compare($this->getVersion(), '9.5', '<')) { return ''; } $query = $this->createQuery() ->select($this->quoteName(['version', 'cipher'])) ->from($this->quoteName('pg_stat_ssl')) ->where($this->quoteName('pid') . ' = pg_backend_pid()'); $variables = $this->setQuery($query)->loadAssoc(); if (!empty($variables['cipher'])) { return $variables['version'] . ' (' . $variables['cipher'] . ')'; } return ''; } /** * Method to test if the database TLS connections encryption are supported. * * @return boolean Whether the database supports TLS connections encryption. * * @since 2.0.0 */ public function isConnectionEncryptionSupported(): bool { $variables = $this->setQuery('SHOW "ssl"')->loadAssoc(); return !empty($variables['ssl']) && $variables['ssl'] === 'on'; } /** * Internal function to get the name of the default schema for the current PostgreSQL connection. * That is the schema where tables are created by Joomla. * * @return string * * @since 1.8.0 */ private function getDefaultSchema() { // Supported since PostgreSQL 7.3 $this->setQuery('SELECT (current_schemas(false))[1]'); return $this->loadResult(); } /** * Shows the table CREATE statement that creates the given tables. * * This is unsupported by PostgreSQL. * * @param mixed $tables A table name or a list of table names. * * @return string An empty string because this function is not supported by PostgreSQL. * * @since 1.5.0 * @throws \RuntimeException */ public function getTableCreate($tables) { return ''; } /** * 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. * * @since 1.5.0 * @throws \RuntimeException */ public function getTableColumns($table, $typeOnly = true) { $this->connect(); $result = []; $tableSub = $this->replacePrefix($table); $defaultSchema = $this->getDefaultSchema(); $this->setQuery(' SELECT a.attname AS "column_name", pg_catalog.format_type(a.atttypid, a.atttypmod) as "type", CASE WHEN a.attnotnull IS TRUE THEN \'NO\' ELSE \'YES\' END AS "null", CASE WHEN pg_catalog.pg_get_expr(adef.adbin, adef.adrelid, true) IS NOT NULL THEN pg_catalog.pg_get_expr(adef.adbin, adef.adrelid, true) END as "Default", CASE WHEN pg_catalog.col_description(a.attrelid, a.attnum) IS NULL THEN \'\' ELSE pg_catalog.col_description(a.attrelid, a.attnum) END AS "comments" FROM pg_catalog.pg_attribute a LEFT JOIN pg_catalog.pg_attrdef adef ON a.attrelid=adef.adrelid AND a.attnum=adef.adnum LEFT JOIN pg_catalog.pg_type t ON a.atttypid=t.oid WHERE a.attrelid = (SELECT oid FROM pg_catalog.pg_class WHERE relname=' . $this->quote($tableSub) . ' AND relnamespace = (SELECT oid FROM pg_catalog.pg_namespace WHERE nspname = ' . $this->quote($defaultSchema) . ') ) AND a.attnum > 0 AND NOT a.attisdropped ORDER BY a.attnum' ); $fields = $this->loadObjectList(); if ($typeOnly) { foreach ($fields as $field) { $result[$field->column_name] = preg_replace('/[(0-9)]/', '', $field->type); } } else { foreach ($fields as $field) { if ($field->Default !== null) { // Normalise default values like datetime if (preg_match('/^\'(.*)\'::.*/', $field->Default, $matches)) { $field->Default = $matches[1]; } // Change Postgresql's NULL::* type with PHP's null one. Do this last to avoid PHP type issues in PHP 8.1 and up if (preg_match('/^NULL::*/', $field->Default)) { $field->Default = null; } } // Do some dirty translation to MySQL output. // @todo: Come up with and implement a standard across databases. $result[$field->column_name] = (object) [ 'column_name' => $field->column_name, 'type' => $field->type, 'null' => $field->null, 'Default' => $field->Default, 'comments' => '', 'Field' => $field->column_name, 'Type' => $field->type, 'Null' => $field->null, // @todo: Improve query above to return primary key info as well // 'Key' => ($field->PK == '1' ? 'PRI' : '') ]; } } 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. * * @since 1.5.0 * @throws \RuntimeException */ public function getTableKeys($table) { $this->connect(); // To check if table exists and prevent SQL injection $tableList = $this->getTableList(); $tableSub = $this->replacePrefix($table); if (\in_array($tableSub, $tableList, true)) { // Get the details columns information. $this->setQuery(' SELECT indexname AS "idxName", indisprimary AS "isPrimary", indisunique AS "isUnique", indkey AS "indKey", CASE WHEN indisprimary = true THEN ( SELECT \'ALTER TABLE \' || tablename || \' ADD \' || pg_catalog.pg_get_constraintdef(const.oid, true) FROM pg_constraint AS const WHERE const.conname= pgClassFirst.relname ) ELSE pg_catalog.pg_get_indexdef(indexrelid, 0, true) END AS "Query" FROM pg_indexes LEFT JOIN pg_class AS pgClassFirst ON indexname=pgClassFirst.relname LEFT JOIN pg_index AS pgIndex ON pgClassFirst.oid=pgIndex.indexrelid WHERE tablename=' . $this->quote($tableSub) . ' ORDER BY indkey' ); return $this->loadObjectList(); } return []; } /** * Get the list of column names this index indexes. * * @param string $table The name of the table. * @param string $indKey The list of column numbers for the table * * @return string A list of the column names for the table. * * @since 2.0.0 * @throws \RuntimeException */ public function getNamesKey($table, $indKey) { $this->connect(); $tableSub = $this->replacePrefix($table); $tabInd = explode(' ', $indKey); $colNames = []; foreach ($tabInd as $numCol) { $query = $this->createQuery() ->select('attname') ->from('pg_attribute') ->join('LEFT', 'pg_class ON pg_class.relname=' . $this->quote($tableSub)) ->where('attnum=' . $numCol . ' AND attrelid=pg_class.oid'); $this->setQuery($query); $colNames[] = $this->loadResult(); } return implode(', ', $colNames); } /** * Method to get an array of all tables in the database. * * @return array An array of all the tables in the database. * * @since 1.5.0 * @throws \RuntimeException */ public function getTableList() { $query = $this->createQuery() ->select('table_name') ->from('information_schema.tables') ->where('table_type = ' . $this->quote('BASE TABLE')) ->where('table_schema NOT IN (' . $this->quote('pg_catalog') . ', ' . $this->quote('information_schema') . ')') ->order('table_name ASC'); $this->setQuery($query); return $this->loadColumn(); } /** * Get the details list of sequences for a table. * * @param string $table The name of the table. * * @return array An array of sequences specification for the table. * * @since 1.5.0 * @throws \RuntimeException */ public function getTableSequences($table) { // To check if table exists and prevent SQL injection $tableList = $this->getTableList(); $tableSub = $this->replacePrefix($table); if (\in_array($tableSub, $tableList, true)) { $name = [ 's.relname', 'n.nspname', 't.relname', 'a.attname', 'info.data_type', 'info.minimum_value', 'info.maximum_value', 'info.increment', 'info.cycle_option', 'info.start_value', ]; $as = [ 'sequence', 'schema', 'table', 'column', 'data_type', 'minimum_value', 'maximum_value', 'increment', 'cycle_option', 'start_value', ]; // Get the details columns information. $query = $this->createQuery() ->select($this->quoteName($name, $as)) ->from('pg_class AS s') ->leftJoin("pg_depend d ON d.objid = s.oid AND d.classid = 'pg_class'::regclass AND d.refclassid = 'pg_class'::regclass") ->leftJoin('pg_class t ON t.oid = d.refobjid') ->leftJoin('pg_namespace n ON n.oid = t.relnamespace') ->leftJoin('pg_attribute a ON a.attrelid = t.oid AND a.attnum = d.refobjsubid') ->leftJoin('information_schema.sequences AS info ON info.sequence_name = s.relname') ->where('s.relkind = ' . $this->quote('S') . ' AND d.deptype = ' . $this->quote('a') . ' AND t.relname = ' . $this->quote($tableSub)); $this->setQuery($query); return $this->loadObjectList(); } return []; } /** * Method to get the last value of a sequence in the database. * * @param string $sequence The name of the sequence. * * @return integer The last value of the sequence. * * @since 2.0.0 * @throws \RuntimeException */ public function getSequenceLastValue($sequence) { $this->connect(); $query = $this->createQuery() ->select($this->quoteName('last_value')) ->from($sequence); $this->setQuery($query); return $this->loadResult(); } /** * Method to get the is_called attribute of a sequence. * * @param string $sequence The name of the sequence. * * @return boolean The is_called attribute of the sequence. * * @since 2.0.0 * @throws \RuntimeException */ public function getSequenceIsCalled($sequence) { $this->connect(); $query = $this->createQuery() ->select($this->quoteName('is_called')) ->from($sequence); $this->setQuery($query); return $this->loadResult(); } /** * Locks a table in the database. * * @param string $tableName The name of the table to unlock. * * @return $this * * @since 1.5.0 * @throws \RuntimeException */ public function lockTable($tableName) { $this->transactionStart(); $this->setQuery('LOCK TABLE ' . $this->quoteName($tableName) . ' IN ACCESS EXCLUSIVE MODE')->execute(); return $this; } /** * 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 PostgreSQL. * @param string $prefix Not used by PostgreSQL. * * @return $this * * @since 1.5.0 * @throws \RuntimeException */ public function renameTable($oldTable, $newTable, $backup = null, $prefix = null) { $this->connect(); $oldTable = $this->replacePrefix($oldTable); $newTable = $this->replacePrefix($newTable); // To check if table exists and prevent SQL injection $tableList = $this->getTableList(); // Origin Table does not exist if (!\in_array($oldTable, $tableList, true)) { // Origin Table not found throw new \RuntimeException('Table not found in Postgresql database.'); } // Rename indexes $subQuery = $this->createQuery() ->select('indexrelid') ->from('pg_index, pg_class') ->where('pg_class.relname = ' . $this->quote($oldTable)) ->where('pg_class.oid = pg_index.indrelid'); $this->setQuery( $this->createQuery() ->select('relname') ->from('pg_class') ->where('oid IN (' . (string) $subQuery . ')') ); $oldIndexes = $this->loadColumn(); foreach ($oldIndexes as $oldIndex) { $changedIdxName = str_replace($oldTable, $newTable, $oldIndex); $this->setQuery('ALTER INDEX ' . $this->escape($oldIndex) . ' RENAME TO ' . $this->escape($changedIdxName))->execute(); } // Rename sequences $subQuery = $this->createQuery() ->select('oid') ->from('pg_namespace') ->where('nspname NOT LIKE ' . $this->quote('pg_%')) ->where('nspname != ' . $this->quote('information_schema')); $this->setQuery( $this->createQuery() ->select('relname') ->from('pg_class') ->where('relkind = ' . $this->quote('S')) ->where('relnamespace IN (' . (string) $subQuery . ')') ->where('relname LIKE ' . $this->quote("%$oldTable%")) ); $oldSequences = $this->loadColumn(); foreach ($oldSequences as $oldSequence) { $changedSequenceName = str_replace($oldTable, $newTable, $oldSequence); $this->setQuery('ALTER SEQUENCE ' . $this->escape($oldSequence) . ' RENAME TO ' . $this->escape($changedSequenceName))->execute(); } // Rename table $this->setQuery('ALTER TABLE ' . $this->escape($oldTable) . ' RENAME TO ' . $this->escape($newTable))->execute(); return $this; } /** * This function return a field value as a prepared string to be used in a SQL statement. * * @param array $columns Array of table's column returned by ::getTableColumns. * @param string $fieldName The table field's name. * @param string $fieldValue The variable value to quote and return. * * @return string The quoted string. * * @since 1.5.0 */ public function sqlValue($columns, $fieldName, $fieldValue) { switch ($columns[$fieldName]) { case 'boolean': $val = 'NULL'; if ($fieldValue === 't' || $fieldValue === true || $fieldValue === 1 || $fieldValue === '1') { $val = 'TRUE'; } elseif ($fieldValue === 'f' || $fieldValue === false || $fieldValue === 0 || $fieldValue === '0') { $val = 'FALSE'; } break; case 'bigint': case 'bigserial': case 'integer': case 'money': case 'numeric': case 'real': case 'smallint': case 'serial': case 'numeric,': $val = $fieldValue === '' ? 'NULL' : $fieldValue; break; case 'timestamp without time zone': case 'date': if (empty($fieldValue)) { $fieldValue = $this->getNullDate(); } $val = $this->quote($fieldValue); break; default: $val = $this->quote($fieldValue); break; } return $val; } /** * Method to commit a transaction. * * @param boolean $toSavepoint If true, commit to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionCommit($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { parent::transactionCommit($toSavepoint); } else { $this->transactionDepth--; } } /** * Method to roll back a transaction. * * @param boolean $toSavepoint If true, rollback to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionRollback($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { parent::transactionRollback($toSavepoint); } else { $savepoint = 'SP_' . ($this->transactionDepth - 1); $this->setQuery('ROLLBACK TO SAVEPOINT ' . $this->quoteName($savepoint)); if ($this->execute()) { $this->transactionDepth--; $this->setQuery('RELEASE SAVEPOINT ' . $this->quoteName($savepoint))->execute(); } } } /** * Method to initialize a transaction. * * @param boolean $asSavepoint If true and a transaction is already active, a savepoint will be created. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionStart($asSavepoint = false) { $this->connect(); if (!$asSavepoint || !$this->transactionDepth) { parent::transactionStart($asSavepoint); } else { $savepoint = 'SP_' . $this->transactionDepth; $this->setQuery('SAVEPOINT ' . $this->quoteName($savepoint)); if ($this->execute()) { $this->transactionDepth++; } } } /** * 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. * * @since 1.5.0 * @throws \RuntimeException */ public function insertObject($table, &$object, $key = null) { $columns = $this->getTableColumns($table); $fields = []; $values = []; // Iterate over the object variables to build the query fields and values. foreach (get_object_vars($object) as $k => $v) { // Skip columns that don't exist in the table. if (!\array_key_exists($k, $columns)) { continue; } // Only process non-null scalars. if (\is_array($v) || \is_object($v) || $v === null) { continue; } // Ignore any internal fields or primary keys with value 0. if (($k[0] === '_') || ($k == $key && (($v === 0) || ($v === '0')))) { continue; } // Ignore null timestamp fields. if ($columns[$k] === 'timestamp without time zone' && empty($v)) { continue; } // Prepare and sanitize the fields and values for the database query. $fields[] = $this->quoteName($k); $values[] = $this->sqlValue($columns, $k, $v); } // Create the base insert statement. $query = $this->createQuery(); $query->insert($this->quoteName($table)) ->columns($fields) ->values(implode(',', $values)); if ($key) { $query->returning($key); // Set the query and execute the insert. $object->$key = $this->setQuery($query)->loadResult(); } else { // Set the query and execute the insert. $this->setQuery($query)->execute(); } return true; } /** * Test to see if the PostgreSQL connector is available. * * @return boolean True on success, false otherwise. * * @since 1.5.0 */ public static function isSupported() { return class_exists('\\PDO') && \in_array('pgsql', \PDO::getAvailableDrivers(), true); } /** * Returns an array containing database's table list. * * @return array The database's table list. * * @since 1.5.0 */ public function showTables() { $query = $this->createQuery() ->select('table_name') ->from('information_schema.tables') ->where('table_type=' . $this->quote('BASE TABLE')) ->where('table_schema NOT IN (' . $this->quote('pg_catalog') . ', ' . $this->quote('information_schema') . ' )'); $this->setQuery($query); return $this->loadColumn(); } /** * Get the substring position inside a string * * @param string $substring The string being sought * @param string $string The string/column being searched * * @return integer The position of $substring in $string * * @since 1.5.0 */ public function getStringPositionSql($substring, $string) { $this->setQuery("SELECT POSITION($substring IN $string)"); $position = $this->loadRow(); return $position['position']; } /** * Generate a random value * * @return float The random generated number * * @since 1.5.0 */ public function getRandom() { $this->setQuery('SELECT RANDOM()'); $random = $this->loadAssoc(); return $random['random']; } /** * Get 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 * * @since 1.5.0 */ public function getAlterDbCharacterSet($dbName) { return 'ALTER DATABASE ' . $this->quoteName($dbName) . ' SET CLIENT_ENCODING TO ' . $this->quote('UTF8'); } /** * Get the query string to create new Database in correct PostgreSQL syntax. * * @param object $options object coming from "initialise" function to pass user and database name to database driver. * @param boolean $utf True if the database supports the UTF-8 character set, not used in PostgreSQL "CREATE DATABASE" query. * * @return string The query that creates database, owned by $options['user'] * * @since 1.5.0 */ public function getCreateDbQuery($options, $utf) { $query = 'CREATE DATABASE ' . $this->quoteName($options->db_name) . ' OWNER ' . $this->quoteName($options->db_user); if ($utf) { $query .= ' ENCODING ' . $this->quote('UTF-8'); } return $query; } /** * This function replaces a string identifier with the configured table prefix. * * @param string $sql The SQL statement to prepare. * @param string $prefix The table prefix. * * @return string The processed SQL statement. * * @since 1.5.0 */ public function replacePrefix($sql, $prefix = '#__') { $sql = trim($sql); if (strpos($sql, '\'')) { // Sequence name quoted with ' ' but need to be replaced if (strpos($sql, 'currval')) { $sql = explode('currval', $sql); for ($nIndex = 1, $nIndexMax = \count($sql); $nIndex < $nIndexMax; $nIndex += 2) { $sql[$nIndex] = str_replace($prefix, $this->tablePrefix, $sql[$nIndex]); } $sql = implode('currval', $sql); } // Sequence name quoted with ' ' but need to be replaced if (strpos($sql, 'nextval')) { $sql = explode('nextval', $sql); for ($nIndex = 1, $nIndexMax = \count($sql); $nIndex < $nIndexMax; $nIndex += 2) { $sql[$nIndex] = str_replace($prefix, $this->tablePrefix, $sql[$nIndex]); } $sql = implode('nextval', $sql); } // Sequence name quoted with ' ' but need to be replaced if (strpos($sql, 'setval')) { $sql = explode('setval', $sql); for ($nIndex = 1, $nIndexMax = \count($sql); $nIndex < $nIndexMax; $nIndex += 2) { $sql[$nIndex] = str_replace($prefix, $this->tablePrefix, $sql[$nIndex]); } $sql = implode('setval', $sql); } $explodedQuery = explode('\'', $sql); for ($nIndex = 0, $nIndexMax = \count($explodedQuery); $nIndex < $nIndexMax; $nIndex += 2) { if (strpos($explodedQuery[$nIndex], $prefix)) { $explodedQuery[$nIndex] = str_replace($prefix, $this->tablePrefix, $explodedQuery[$nIndex]); } } $replacedQuery = implode('\'', $explodedQuery); } else { $replacedQuery = str_replace($prefix, $this->tablePrefix, $sql); } return $replacedQuery; } /** * Unlocks tables in the database, this command does not exist in PostgreSQL, it is automatically done on commit or rollback. * * @return $this * * @since 1.5.0 * @throws \RuntimeException */ public function unlockTables() { $this->transactionCommit(); return $this; } /** * 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 array|string $key The name of the primary key. * @param boolean $nulls True to update null fields or false to ignore them. * * @return boolean * * @since 1.5.0 * @throws \RuntimeException */ public function updateObject($table, &$object, $key, $nulls = false) { $columns = $this->getTableColumns($table); $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) { // Skip columns that don't exist in the table. if (!\array_key_exists($k, $columns)) { continue; } // 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, true)) { $key_val = $this->sqlValue($columns, $k, $v); $where[] = $this->quoteName($k) . '=' . $key_val; continue; } // Prepare and sanitize the fields and values for the database query. if ($v === null) { // If the value is null and we do not want to update nulls then ignore this field. if (!$nulls) { continue; } // If the value is null and we want to update nulls then set it. $val = 'NULL'; } else { // The field is not null so we prep it for update. $val = $this->sqlValue($columns, $k, $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(); } /** * Quotes a binary string to database requirements for use in database queries. * * @param string $data A binary string to quote. * * @return string The binary quoted input string. * * @since 1.7.0 */ public function quoteBinary($data) { return "decode('" . bin2hex($data) . "', 'hex')"; } /** * Replace special placeholder representing binary field with the original string. * * @param string|resource $data Encoded string or resource. * * @return string The original string. * * @since 1.7.0 */ public function decodeBinary($data) { if (\is_resource($data)) { return stream_get_contents($data); } return $data; } } PK c�\�綿�= �= $ database/src/Pgsql/PgsqlImporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Pgsql; use Joomla\Database\DatabaseImporter; /** * PDO PostgreSQL Database Importer. * * @since 1.5.0 */ class PgsqlImporter extends DatabaseImporter { /** * Checks if all data and options are in order prior to exporting. * * @return $this * * @since 1.5.0 * @throws \RuntimeException if an error is encountered. */ public function check() { // Check if the db connector has been set. if (!($this->db instanceof PgsqlDriver)) { throw new \RuntimeException('Database connection wrong type.'); } // Check if the tables have been specified. if (empty($this->from)) { throw new \RuntimeException('ERROR: No Tables Specified'); } return $this; } /** * Get the SQL syntax to add an index. * * @param \SimpleXMLElement $field The XML index definition. * * @return string * * @since 1.0 */ protected function getAddIndexSql(\SimpleXMLElement $field) { return (string) $field['Query']; } /** * Get alters for table if there is a difference. * * @param \SimpleXMLElement $structure The XML structure of the table. * * @return array * * @since 1.0 */ protected function getAlterTableSql(\SimpleXMLElement $structure) { $table = $this->getRealTableName($structure['name']); $oldFields = $this->db->getTableColumns($table); $oldKeys = $this->db->getTableKeys($table); $oldSequence = $this->db->getTableSequences($table); $alters = []; // Get the fields and keys from the XML that we are aiming for. $newFields = $structure->xpath('field'); $newKeys = $structure->xpath('key'); $newSequence = $structure->xpath('sequence'); /* * Sequence section */ $oldSeq = $this->getSeqLookup($oldSequence); $newSequenceLook = $this->getSeqLookup($newSequence); foreach ($newSequenceLook as $kSeqName => $vSeq) { if (isset($oldSeq[$kSeqName])) { // The field exists, check it's the same. $column = $oldSeq[$kSeqName][0]; // Test whether there is a change. $change = ((string) $vSeq[0]['Type'] !== $column->Type) || ((string) $vSeq[0]['Start_Value'] !== $column->Start_Value) || ((string) $vSeq[0]['Min_Value'] !== $column->Min_Value) || ((string) $vSeq[0]['Max_Value'] !== $column->Max_Value) || ((string) $vSeq[0]['Increment'] !== $column->Increment) || ((string) $vSeq[0]['Cycle_option'] !== $column->Cycle_option) || ((string) $vSeq[0]['Table'] !== $column->Table) || ((string) $vSeq[0]['Column'] !== $column->Column) || ((string) $vSeq[0]['Schema'] !== $column->Schema) || ((string) $vSeq[0]['Name'] !== $column->Name); if ($change) { $alters[] = $this->getChangeSequenceSql($kSeqName, $vSeq); $alters[] = $this->getSetvalSequenceSql($kSeqName, $vSeq); } // Unset this field so that what we have left are fields that need to be removed. unset($oldSeq[$kSeqName]); } else { // The sequence is new $alters[] = $this->getAddSequenceSql($newSequenceLook[$kSeqName][0]); $alters[] = $this->getSetvalSequenceSql($newSequenceLook[$kSeqName][0]); } } // Any sequences left are orphans foreach ($oldSeq as $name => $column) { // Delete the sequence. $alters[] = $this->getDropSequenceSql($name); } /* * Field section */ // Loop through each field in the new structure. foreach ($newFields as $field) { $fName = (string) $field['Field']; if (isset($oldFields[$fName])) { // The field exists, check it's the same. $column = $oldFields[$fName]; // Test whether there is a change. $change = ((string) $field['Type'] !== $column->Type) || ((string) $field['Null'] !== $column->Null) || ((string) $field['Default'] !== $column->Default); if ($change) { $alters[] = $this->getChangeColumnSql($table, $field); } // Unset this field so that what we have left are fields that need to be removed. unset($oldFields[$fName]); } else { // The field is new. $alters[] = $this->getAddColumnSql($table, $field); } } // Any columns left are orphans foreach ($oldFields as $name => $column) { // Delete the column. $alters[] = $this->getDropColumnSql($table, $name); } /* * Index section */ // Get the lookups for the old and new keys $oldLookup = $this->getKeyLookup($oldKeys); $newLookup = $this->getKeyLookup($newKeys); // Loop through each key in the new structure. foreach ($newLookup as $name => $keys) { // Check if there are keys on this field in the existing table. if (isset($oldLookup[$name])) { $same = true; $newCount = \count($newLookup[$name]); $oldCount = \count($oldLookup[$name]); // There is a key on this field in the old and new tables. Are they the same? if ($newCount === $oldCount) { for ($i = 0; $i < $newCount; $i++) { // Check only query field -> different query means different index $same = ((string) $newLookup[$name][$i]['Query'] === $oldLookup[$name][$i]->Query); if (!$same) { // Break out of the loop. No need to check further. break; } } } else { // Count is different, just drop and add. $same = false; } if (!$same) { $alters[] = $this->getDropIndexSql($name); $alters[] = (string) $newLookup[$name][0]['Query']; } // Unset this field so that what we have left are fields that need to be removed. unset($oldLookup[$name]); } else { // This is a new key. $alters[] = (string) $newLookup[$name][0]['Query']; } } // Any keys left are orphans. foreach ($oldLookup as $name => $keys) { if ($oldLookup[$name][0]->is_primary === 'TRUE') { $alters[] = $this->getDropPrimaryKeySql($table, $oldLookup[$name][0]->Index); } else { $alters[] = $this->getDropIndexSql($name); } } return $alters; } /** * Get the SQL syntax to drop a sequence. * * @param string $name The name of the sequence to drop. * * @return string * * @since 1.0 */ protected function getDropSequenceSql($name) { return 'DROP SEQUENCE ' . $this->db->quoteName($name); } /** * Get the syntax to add a sequence. * * @param \SimpleXMLElement $field The XML definition for the sequence. * * @return string * * @since 1.0 */ protected function getAddSequenceSql(\SimpleXMLElement $field) { $sql = 'CREATE SEQUENCE IF NOT EXISTS ' . (string) $field['Name'] . ' INCREMENT BY ' . (string) $field['Increment'] . ' MINVALUE ' . $field['Min_Value'] . ' MAXVALUE ' . (string) $field['Max_Value'] . ' START ' . (string) $field['Start_Value'] . (((string) $field['Cycle_option'] === 'NO') ? ' NO' : '') . ' CYCLE' . ' OWNED BY ' . $this->db->quoteName((string) $field['Schema'] . '.' . (string) $field['Table'] . '.' . (string) $field['Column']); return $sql; } /** * Get the syntax to alter a sequence. * * @param \SimpleXMLElement $field The XML definition for the sequence. * * @return string * * @since 1.0 */ protected function getChangeSequenceSql(\SimpleXMLElement $field) { $sql = 'ALTER SEQUENCE ' . (string) $field['Name'] . ' INCREMENT BY ' . (string) $field['Increment'] . ' MINVALUE ' . (string) $field['Min_Value'] . ' MAXVALUE ' . (string) $field['Max_Value'] . ' START ' . (string) $field['Start_Value'] . ' OWNED BY ' . $this->db->quoteName((string) $field['Schema'] . '.' . (string) $field['Table'] . '.' . (string) $field['Column']); return $sql; } /** * Get the syntax to setval a sequence. * * @param \SimpleXMLElement $field The XML definition for the sequence. * * @return string * * @since 2.0.0 */ protected function getSetvalSequenceSql($field) { $is_called = $field['Is_called'] == 't' || $field['Is_called'] == '1' ? 'TRUE' : 'FALSE'; return 'SELECT setval(\'' . (string) $field['Name'] . '\', ' . (string) $field['Last_Value'] . ', ' . $is_called . ')'; } /** * Get the syntax to alter a column. * * @param string $table The name of the database table to alter. * @param \SimpleXMLElement $field The XML definition for the field. * * @return string * * @since 1.0 */ protected function getChangeColumnSql($table, \SimpleXMLElement $field) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' ALTER COLUMN ' . $this->db->quoteName((string) $field['Field']) . ' ' . $this->getAlterColumnSql($table, $field); } /** * Get the SQL syntax for a single column that would be included in a table create statement. * * @param string $table The name of the database table to alter. * @param \SimpleXMLElement $field The XML field definition. * * @return string * * @since 1.0 */ protected function getAlterColumnSql($table, \SimpleXMLElement $field) { // TODO Incorporate into parent class and use $this. $blobs = ['text', 'smalltext', 'mediumtext', 'largetext']; $fName = (string) $field['Field']; $fType = (string) $field['Type']; $fNull = (string) $field['Null']; $fDefault = (isset($field['Default']) && $field['Default'] != 'NULL') ? preg_match('/^[0-9]$/', $field['Default']) ? $field['Default'] : $this->db->quote((string) $field['Default']) : null; $sql = ' TYPE ' . $fType; if ($fNull === 'NO') { if ($fDefault === null || \in_array($fType, $blobs, true)) { $sql .= ",\nALTER COLUMN " . $this->db->quoteName($fName) . ' SET NOT NULL' . ",\nALTER COLUMN " . $this->db->quoteName($fName) . ' DROP DEFAULT'; } else { $sql .= ",\nALTER COLUMN " . $this->db->quoteName($fName) . ' SET NOT NULL' . ",\nALTER COLUMN " . $this->db->quoteName($fName) . ' SET DEFAULT ' . $fDefault; } } else { if ($fDefault !== null) { $sql .= ",\nALTER COLUMN " . $this->db->quoteName($fName) . ' DROP NOT NULL' . ",\nALTER COLUMN " . $this->db->quoteName($fName) . ' SET DEFAULT ' . $fDefault; } } // Sequence was created in other function, here is associated a default value but not yet owner if (strpos($fDefault, 'nextval') !== false) { $sequence = $table . '_' . $fName . '_seq'; $owner = $table . '.' . $fName; $sql .= ";\nALTER SEQUENCE " . $this->db->quoteName($sequence) . ' OWNED BY ' . $this->db->quoteName($owner); } return $sql; } /** * Get the SQL syntax for a single column that would be included in a table create statement. * * @param \SimpleXMLElement $field The XML field definition. * * @return string * * @since 1.0 */ protected function getColumnSql(\SimpleXMLElement $field) { $fName = (string) $field['Field']; $fType = (string) $field['Type']; $fNull = (string) $field['Null']; if (strpos($field['Default'], '::') != false) { $fDefault = strstr($field['Default'], '::', true); } else { $fDefault = isset($field['Default']) && strlen($field['Default']) > 0 ? preg_match('/^[0-9]$/', $field['Default']) ? $field['Default'] : $this->db->quote((string) $field['Default']) : null; } // Note, nextval() as default value means that type field is serial. if (strpos($fDefault, 'nextval') !== false) { $sql = $this->db->quoteName($fName) . ' SERIAL'; } else { $sql = $this->db->quoteName($fName) . ' ' . $fType; if ($fNull == 'NO') { if ($fDefault === null) { $sql .= ' NOT NULL'; } else { $sql .= ' NOT NULL DEFAULT ' . $fDefault; } } else { if ($fDefault !== null) { $sql .= ' DEFAULT ' . $fDefault; } } } return $sql; } /** * Get the SQL syntax to drop an index. * * @param string $name The name of the key to drop. * * @return string * * @since 1.0 */ protected function getDropIndexSql($name) { return 'DROP INDEX ' . $this->db->quoteName($name); } /** * Get the SQL syntax to drop a key. * * @param string $table The table name. * @param string $name The constraint name. * * @return string * * @since 1.0 */ protected function getDropPrimaryKeySql($table, $name) { return 'ALTER TABLE ONLY ' . $this->db->quoteName($table) . ' DROP CONSTRAINT ' . $this->db->quoteName($name); } /** * Get the details list of keys for a table. * * @param array $keys An array of objects that comprise the keys for the table. * * @return array The lookup array. array({key name} => array(object, ...)) * * @since 1.2.0 */ protected function getKeyLookup($keys) { // First pass, create a lookup of the keys. $lookup = []; foreach ($keys as $key) { if ($key instanceof \SimpleXMLElement) { $kName = (string) $key['Index']; } else { $kName = $key->Index; } if (empty($lookup[$kName])) { $lookup[$kName] = []; } $lookup[$kName][] = $key; } return $lookup; } /** * Get the SQL syntax to add a unique constraint for a table key. * * @param string $table The table name. * @param array $key The key. * * @return string * * @since 2.0.0 */ protected function getAddUniqueSql($table, $key) { if ($key instanceof \SimpleXMLElement) { $kName = (string) $key['Key_name']; $kIndex = (string) $key['Index']; } else { $kName = $key->Key_name; $kIndex = $key->Index; } $unique = $kIndex . ' UNIQUE (' . $kName . ')'; return 'ALTER TABLE ' . $this->db->quoteName($table) . ' ADD CONSTRAINT ' . $unique; } /** * Get the details list of sequences for a table. * * @param array $sequences An array of objects that comprise the sequences for the table. * * @return array The lookup array. array({key name} => array(object, ...)) * * @since 1.0 */ protected function getSeqLookup($sequences) { // First pass, create a lookup of the keys. $lookup = []; foreach ($sequences as $seq) { if ($seq instanceof \SimpleXMLElement) { $sName = (string) $seq['Name']; } else { $sName = $seq->Name; } if (empty($lookup[$sName])) { $lookup[$sName] = []; } $lookup[$sName][] = $seq; } return $lookup; } /** * Get the SQL syntax to add a table. * * @param \SimpleXMLElement $table The table information. * * @return string * * @since 2.0.0 * @throws \RuntimeException */ protected function xmlToCreate(\SimpleXMLElement $table) { $existingTables = $this->db->getTableList(); $tableName = (string) $table['name']; if (in_array($tableName, $existingTables)) { throw new \RuntimeException('The table you are trying to create already exists'); } $createTableStatement = 'CREATE TABLE ' . $this->db->quoteName($tableName) . ' ('; foreach ($table->xpath('field') as $field) { $createTableStatement .= $this->getColumnSql($field) . ', '; } $createTableStatement = rtrim($createTableStatement, ', '); $createTableStatement .= ');'; foreach ($table->xpath('sequence') as $seq) { $createTableStatement .= $this->getAddSequenceSql($seq) . ';'; $createTableStatement .= $this->getSetvalSequenceSql($seq) . ';'; } foreach ($table->xpath('key') as $key) { if ((($key['is_primary'] == 'f') || ($key['is_primary'] == '')) && (($key['is_unique'] == 't') || ($key['is_unique'] == '1'))) { $createTableStatement .= $this->getAddUniqueSql($tableName, $key) . ';'; } else { $createTableStatement .= $this->getAddIndexSql($key) . ';'; } } return $createTableStatement; } } PK c�\�36w2: 2: - database/src/Query/PostgresqlQueryBuilder.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Query; /** * Trait for PostgreSQL Query Building. * * @since 2.0.0 */ trait PostgresqlQueryBuilder { /** * The FOR UPDATE element used in "FOR UPDATE" lock * * @var QueryElement * @since 2.0.0 */ protected $forUpdate; /** * The FOR SHARE element used in "FOR SHARE" lock * * @var QueryElement * @since 2.0.0 */ protected $forShare; /** * The NOWAIT element used in "FOR SHARE" and "FOR UPDATE" lock * * @var QueryElement * @since 2.0.0 */ protected $noWait; /** * The LIMIT element * * @var QueryElement * @since 2.0.0 */ protected $limit; /** * The OFFSET element * * @var QueryElement * @since 2.0.0 */ protected $offset; /** * The RETURNING element of INSERT INTO * * @var QueryElement * @since 2.0.0 */ protected $returning; /** * Magic function to convert the query to a string, only for PostgreSQL specific queries * * @return string The completed query. * * @since 2.0.0 */ public function __toString() { $query = ''; switch ($this->type) { 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->selectRowNumber) { if ($this->order) { $query .= (string) $this->order; } break; } if ($this->group) { $query .= (string) $this->group; } if ($this->having) { $query .= (string) $this->having; } if ($this->merge) { // Special case for merge foreach ($this->merge as $element) { $query .= (string) $element; } } if ($this->order) { $query .= (string) $this->order; } if ($this->forUpdate) { $query .= (string) $this->forUpdate; } else { if ($this->forShare) { $query .= (string) $this->forShare; } } if ($this->noWait) { $query .= (string) $this->noWait; } $query = $this->processLimit($query, $this->limit, $this->offset); break; case 'update': $query .= (string) $this->update; $query .= (string) $this->set; if ($this->join) { $tmpFrom = $this->from; $tmpWhere = $this->where ? clone $this->where : null; $this->from = null; // Workaround for special case of JOIN with UPDATE foreach ($this->join as $join) { $joinElem = $join->getElements(); $this->from($joinElem[0]); if (isset($joinElem[1])) { $this->where($joinElem[1]); } } $query .= (string) $this->from; if ($this->where) { $query .= (string) $this->where; } $this->from = $tmpFrom; $this->where = $tmpWhere; } elseif ($this->where) { $query .= (string) $this->where; } $query = $this->processLimit($query, $this->limit, $this->offset); break; case 'insert': $query .= (string) $this->insert; if ($this->values) { if ($this->columns) { $query .= (string) $this->columns; } $elements = $this->values->getElements(); if (!($elements[0] instanceof $this)) { $query .= ' VALUES '; } $query .= (string) $this->values; if ($this->returning) { $query .= (string) $this->returning; } } $query = $this->processLimit($query, $this->limit, $this->offset); break; default: $query = parent::__toString(); break; } if ($this->type === 'select' && $this->alias !== null) { $query = '(' . $query . ') AS ' . $this->alias; } return $query; } /** * 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 $this * * @since 2.0.0 */ public function clear($clause = null) { switch ($clause) { case 'limit': $this->limit = null; break; case 'offset': $this->offset = null; break; case 'forUpdate': $this->forUpdate = null; break; case 'forShare': $this->forShare = null; break; case 'noWait': $this->noWait = null; break; case 'returning': $this->returning = null; break; case 'select': case 'update': case 'delete': case 'insert': case 'querySet': case 'from': case 'join': case 'set': case 'where': case 'group': case 'having': case 'merge': case 'order': case 'columns': case 'values': parent::clear($clause); break; default: $this->forUpdate = null; $this->forShare = null; $this->noWait = null; $this->returning = null; parent::clear($clause); break; } return $this; } /** * Casts a value to a char. * * Ensure that the value is properly quoted before passing to the method. * * Usage: * $query->select($query->castAs('CHAR', 'a')); * * @param string $type The type of string to cast as. * @param string $value The value to cast as a char. * @param string $length The value to cast as a char. * * @return string SQL statement to cast the value as a char type. * * @since 1.0 */ public function castAs(string $type, string $value, ?string $length = null) { switch (strtoupper($type)) { case 'CHAR': if (!$length) { return $value . '::text'; } else { return 'CAST(' . $value . ' AS CHAR(' . $length . '))'; } case 'INT': return 'CAST(' . $value . ' AS INTEGER)'; } return parent::castAs($type, $value, $length); } /** * Concatenates an array of column names or values. * * Usage: * $query->select($query->concatenate(array('a', 'b'))); * * @param string[] $values An array of values to concatenate. * @param string|null $separator As separator to place between each value. * * @return string The concatenated values. * * @since 2.0.0 */ public function concatenate($values, $separator = null) { if ($separator !== null) { return implode(' || ' . $this->quote($separator) . ' || ', $values); } return implode(' || ', $values); } /** * Gets the current date and time. * * @return string Return string used in query to obtain * * @since 2.0.0 */ public function currentTimestamp() { return 'NOW()'; } /** * Sets the FOR UPDATE lock on select's output row * * @param string $tableName The table to lock * @param string $glue The glue by which to join the conditions. Defaults to ',' . * * @return $this * * @since 2.0.0 */ public function forUpdate($tableName, $glue = ',') { $this->type = 'forUpdate'; if ($this->forUpdate === null) { $glue = strtoupper($glue); $this->forUpdate = new QueryElement('FOR UPDATE', 'OF ' . $tableName, "$glue "); } else { $this->forUpdate->append($tableName); } return $this; } /** * Sets the FOR SHARE lock on select's output row * * @param string $tableName The table to lock * @param string $glue The glue by which to join the conditions. Defaults to ',' . * * @return $this * * @since 2.0.0 */ public function forShare($tableName, $glue = ',') { $this->type = 'forShare'; if ($this->forShare === null) { $glue = strtoupper($glue); $this->forShare = new QueryElement('FOR SHARE', 'OF ' . $tableName, "$glue "); } else { $this->forShare->append($tableName); } return $this; } /** * Aggregate function to get input values concatenated into a string, separated by delimiter * * Usage: * $query->groupConcat('id', ','); * * @param string $expression The expression to apply concatenation to, this may be a column name or complex SQL statement. * @param string $separator The delimiter of each concatenated value * * @return string Input values concatenated into a string, separated by delimiter * * @since 2.0.0 */ public function groupConcat($expression, $separator = ',') { return 'string_agg(' . $expression . ', ' . $this->quote($separator) . ')'; } /** * 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. * * @since 2.0.0 */ public function year($date) { return 'EXTRACT (YEAR FROM ' . $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. * * @since 2.0.0 */ public function month($date) { return 'EXTRACT (MONTH FROM ' . $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. * * @since 2.0.0 */ public function day($date) { return 'EXTRACT (DAY FROM ' . $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. * * @since 2.0.0 */ public function hour($date) { return 'EXTRACT (HOUR FROM ' . $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. * * @since 2.0.0 */ public function minute($date) { return 'EXTRACT (MINUTE FROM ' . $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. * * @since 2.0.0 */ public function second($date) { return 'EXTRACT (SECOND FROM ' . $date . ')'; } /** * Sets the NOWAIT lock on select's output row * * @return $this * * @since 2.0.0 */ public function noWait() { $this->type = 'noWait'; if ($this->noWait === null) { $this->noWait = new QueryElement('NOWAIT', null); } return $this; } /** * Set the LIMIT clause to the query * * @param integer $limit Number of rows to return * * @return $this * * @since 2.0.0 */ public function limit($limit = 0) { if ($this->limit === null) { $this->limit = new QueryElement('LIMIT', (int) $limit); } return $this; } /** * Set the OFFSET clause to the query * * @param integer $offset An integer for skipping rows * * @return $this * * @since 2.0.0 */ public function offset($offset = 0) { if ($this->offset === null) { $this->offset = new QueryElement('OFFSET', (int) $offset); } return $this; } /** * Add the RETURNING element to INSERT INTO statement. * * @param mixed $pkCol The name of the primary key column. * * @return $this * * @since 2.0.0 */ public function returning($pkCol) { if ($this->returning === null) { $this->returning = new QueryElement('RETURNING', $pkCol); } return $this; } /** * 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 * * @since 2.0.0 */ public function processLimit($query, $limit, $offset = 0) { if ($limit > 0) { $query .= ' LIMIT ' . $limit; } if ($offset > 0) { $query .= ' OFFSET ' . $offset; } return $query; } /** * 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. * * @param string $date The db quoted string representation of the date to add to * @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 * * @since 2.0.0 * @link http://www.postgresql.org/docs/9.0/static/functions-datetime.html. */ public function dateAdd($date, $interval, $datePart) { if (substr($interval, 0, 1) !== '-') { return 'timestamp ' . $date . " + interval '" . $interval . ' ' . $datePart . "'"; } return 'timestamp ' . $date . " - interval '" . ltrim($interval, '-') . ' ' . $datePart . "'"; } /** * Get the regular expression operator * * Usage: * $query->where('field ' . $query->regexp($search)); * * @param string $value The regex pattern. * * @return string * * @since 2.0.0 */ public function regexp($value) { return ' ~* ' . $value; } /** * Get the function to return a random floating-point value * * Usage: * $query->rand(); * * @return string * * @since 2.0.0 */ public function rand() { return ' RANDOM() '; } /** * Find a value in a varchar used like a set. * * Ensure that the value is an integer before passing to the method. * * Usage: * $query->findInSet((int) $parent->id, 'a.assigned_cat_ids') * * @param string $value The value to search for. * @param string $set The set of values. * * @return string A representation of the MySQL find_in_set() function for the driver. * * @since 2.0.0 */ public function findInSet($value, $set) { return " $value = ANY (string_to_array($set, ',')::integer[]) "; } } PK c�\�� ( database/src/Query/MysqlQueryBuilder.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Query; /** * Trait for MySQL Query Building. * * @since 2.0.0 */ trait MysqlQueryBuilder { /** * Magic function to convert the query to a string. * * @return string The completed query. * * @since 2.0.0 */ public function __toString() { switch ($this->type) { case 'select': if ($this->selectRowNumber) { $orderBy = $this->selectRowNumber['orderBy']; $tmpOffset = $this->offset; $tmpLimit = $this->limit; $this->offset = 0; $this->limit = 0; $tmpOrder = $this->order; $this->order = null; $query = parent::__toString(); $this->order = $tmpOrder; $this->offset = $tmpOffset; $this->limit = $tmpLimit; // Add support for second order by, offset and limit $query = PHP_EOL . 'SELECT * FROM (' . $query . PHP_EOL . "ORDER BY $orderBy" . PHP_EOL . ') w'; if ($this->order) { $query .= (string) $this->order; } return $this->processLimit($query, $this->limit, $this->offset); } } return parent::__toString(); } /** * 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 * * @since 2.0.0 */ public function processLimit($query, $limit, $offset = 0) { if ($limit > 0 && $offset > 0) { $query .= ' LIMIT ' . $offset . ', ' . $limit; } elseif ($limit > 0) { $query .= ' LIMIT ' . $limit; } return $query; } /** * Concatenates an array of column names or values. * * @param string[] $values An array of values to concatenate. * @param string|null $separator As separator to place between each value. * * @return string The concatenated values. * * @since 2.0.0 */ public function concatenate($values, $separator = null) { if ($separator !== null) { $statement = 'CONCAT_WS(' . $this->quote($separator); foreach ($values as $value) { $statement .= ', ' . $value; } return $statement . ')'; } return 'CONCAT(' . implode(',', $values) . ')'; } /** * Aggregate function to get input values concatenated into a string, separated by delimiter * * Usage: * $query->groupConcat('id', ','); * * @param string $expression The expression to apply concatenation to, this may be a column name or complex SQL statement. * @param string $separator The delimiter of each concatenated value * * @return string Input values concatenated into a string, separated by delimiter * * @since 2.0.0 */ public function groupConcat($expression, $separator = ',') { return 'GROUP_CONCAT(' . $expression . ' SEPARATOR ' . $this->quote($separator) . ')'; } /** * 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 DatabaseDriver. * * Usage: * $query->quote('fulltext'); * $query->q('fulltext'); * $query->q(array('option', 'fulltext')); * * @param array|string $text A string or an array of strings to quote. * @param boolean $escape True (default) to escape the string, false to leave it unchanged. * * @return string The quoted input string. * * @since 2.0.0 * @throws \RuntimeException if the internal db property is not a valid object. */ abstract public function quote($text, $escape = true); /** * Get the regular expression operator * * Usage: * $query->where('field ' . $query->regexp($search)); * * @param string $value The regex pattern. * * @return string * * @since 2.0.0 */ public function regexp($value) { return ' REGEXP ' . $value; } /** * Get the function to return a random floating-point value * * Usage: * $query->rand(); * * @return string * * @since 2.0.0 */ public function rand() { return ' RAND() '; } /** * Find a value in a varchar used like a set. * * Ensure that the value is an integer before passing to the method. * * Usage: * $query->findInSet((int) $parent->id, 'a.assigned_cat_ids') * * @param string $value The value to search for. * @param string $set The set of values. * * @return string A representation of the MySQL find_in_set() function for the driver. * * @since 2.0.0 */ public function findInSet($value, $set) { return ' find_in_set(' . $value . ', ' . $set . ')'; } /** * Return the number of the current row. * * Usage: * $query->select('id'); * $query->selectRowNumber('ordering,publish_up DESC', 'new_ordering'); * $query->from('#__content'); * * @param string $orderBy An expression of ordering for window function. * @param string $orderColumnAlias An alias for new ordering column. * * @return $this * * @since 2.0.0 * @throws \RuntimeException */ public function selectRowNumber($orderBy, $orderColumnAlias) { $this->validateRowNumber($orderBy, $orderColumnAlias); return $this->select("(SELECT @rownum := @rownum + 1 FROM (SELECT @rownum := 0) AS r) AS $orderColumnAlias"); } /** * Casts a value to a char. * * Ensure that the value is properly quoted before passing to the method. * * Usage: * $query->select($query->castAs('CHAR', 'a')); * * @param string $type The type of string to cast as. * @param string $value The value to cast as a char. * @param string $length The value to cast as a char. * * @return string SQL statement to cast the value as a char type. * * @since 1.0 */ public function castAs(string $type, string $value, ?string $length = null) { switch (strtoupper($type)) { case 'CHAR': if (!$length) { return $value; } else { return 'CAST(' . $value . ' AS CHAR(' . $length . '))'; } case 'INT': return '(' . $value . ' + 0)'; } return parent::castAs($type, $value, $length); } } PK c�\\���s s * database/src/Query/PreparableInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Query; use Joomla\Database\ParameterType; use Joomla\Database\QueryInterface; trigger_deprecation( 'joomla/database', '2.0.0', '%s() is deprecated and will be removed in 3.0, all query objects should implement %s instead.', PreparableInterface::class, QueryInterface::class ); /** * Joomla 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 * @deprecated 3.0 Capabilities will be required in Joomla\Database\QueryInterface */ interface PreparableInterface { /** * Method to add a variable to an internal array that will be bound to a prepared SQL statement before query execution. * * @param array|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. It can be an array, in this case it has to be * same length of $key; The value is passed by reference to support output * parameters such as those possible with stored procedures. * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $key * @param integer $length The length of the variable. Usually required for OUTPUT parameters. * @param array $driverOptions Optional driver options to be used. * * @return $this * * @since 1.0 */ public function bind($key, &$value, $dataType = ParameterType::STRING, $length = 0, $driverOptions = []); /** * Method to unbind a bound variable. * * @param array|string|integer $key The key or array of keys to unbind. * * @return $this * * @since 2.0.0 */ public function unbind($key); /** * 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 c�\Z��� � # database/src/Query/QueryElement.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Query; /** * Query Element Class. * * @since 1.0 */ class QueryElement { /** * The name of the element. * * @var string * @since 1.0 */ protected $name; /** * An array of elements. * * @var string[] * @since 1.0 */ protected $elements = []; /** * Glue piece. * * @var string * @since 1.0 */ protected $glue; /** * Constructor. * * @param string $name The name of the element. * @param string[]|string $elements String or array. * @param string $glue The glue for elements. * * @since 1.0 */ public function __construct($name, $elements, $glue = ',') { $this->name = $name; $this->glue = $glue; $this->append($elements); } /** * Magic function to convert the query element to a string. * * @return string * * @since 1.0 */ public function __toString() { if (substr($this->name, -2) === '()') { return \PHP_EOL . substr($this->name, 0, -2) . '(' . implode($this->glue, $this->elements) . ')'; } return \PHP_EOL . $this->name . ' ' . implode($this->glue, $this->elements); } /** * Appends element parts to the internal list. * * @param string[]|string $elements String or array. * * @return void * * @since 1.0 */ 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[] * * @since 1.0 */ public function getElements() { return $this->elements; } /** * Gets the glue of this element. * * @return string Glue of the element. * * @since 2.0.0 */ public function getGlue() { return $this->glue; } /** * Gets the name of this element. * * @return string Name of the element. * * @since 1.7.0 */ public function getName() { return $this->name; } /** * Sets the name of this element. * * @param string $name Name of the element. * * @return $this * * @since 1.3.0 */ public function setName($name) { $this->name = $name; return $this; } /** * Method to provide basic copy support. * * Any object pushed into the data of this class should have its own __clone() implementation. * This method does not support copying objects in a multidimensional array. * * @return void * * @since 1.0 */ public function __clone() { foreach ($this as $k => $v) { if (\is_object($v)) { $this->{$k} = clone $v; } elseif (\is_array($v)) { foreach ($v as $i => $element) { if (\is_object($element)) { $this->{$k}[$i] = clone $element; } } } } } } PK c�\��>"y y ) database/src/Query/LimitableInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Query; use Joomla\Database\QueryInterface; trigger_deprecation( 'joomla/database', '2.0.0', '%s() is deprecated and will be removed in 3.0, all query objects should implement %s instead.', LimitableInterface::class, QueryInterface::class ); /** * Joomla Database Query LimitableInterface. * * @since 1.0 * @deprecated 3.0 Capabilities will be required in Joomla\Database\QueryInterface */ interface LimitableInterface { /** * 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 * * @since 1.0 */ 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 $this * * @since 1.0 */ public function setLimit($limit = 0, $offset = 0); } PK c�\P�� � � # database/src/DatabaseAwareTrait.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; use Joomla\Database\Exception\DatabaseNotFoundException; /** * Defines the trait for a Database Aware Class. * * @since 2.1.0 */ trait DatabaseAwareTrait { /** * Database * * @var DatabaseInterface * @since 2.1.0 */ private $databaseAwareTraitDatabase; /** * Get the database. * * @return DatabaseInterface * * @since 2.1.0 * @throws DatabaseNotFoundException May be thrown if the database has not been set. */ protected function getDatabase(): DatabaseInterface { if ($this->databaseAwareTraitDatabase) { return $this->databaseAwareTraitDatabase; } throw new DatabaseNotFoundException('Database not set in ' . \get_class($this)); } /** * Set the database. * * @param DatabaseInterface $db The database. * * @return void * * @since 2.1.0 */ public function setDatabase(DatabaseInterface $db): void { $this->databaseAwareTraitDatabase = $db; } } PK c�\�����V �V $ database/src/Sqlsrv/SqlsrvDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Sqlsrv; use Joomla\Database\DatabaseDriver; use Joomla\Database\DatabaseEvents; use Joomla\Database\Event\ConnectionEvent; use Joomla\Database\Exception\ConnectionFailureException; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\Exception\PrepareStatementFailureException; use Joomla\Database\Exception\UnsupportedAdapterException; use Joomla\Database\StatementInterface; /** * SQL Server Database Driver * * @link https://www.php.net/manual/en/book.sqlsrv.php * @since 1.0 */ class SqlsrvDriver extends DatabaseDriver { /** * The name of the database driver. * * @var string * @since 1.0 */ public $name = 'sqlsrv'; /** * The character(s) used to quote SQL statement names such as table names or field names, etc. * * 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 = '[]'; /** * The null or zero representation of a timestamp for the database driver. * * @var string * @since 1.0 */ protected $nullDate = '1900-01-01 00:00:00'; /** * The minimum supported database version. * * @var string * @since 1.0 */ protected static $dbMinimum = '11.0.2100.60'; /** * Test to see if the SQLSRV connector is available. * * @return boolean True on success, false otherwise. * * @since 1.0 */ public static function isSupported() { return \function_exists('sqlsrv_connect'); } /** * Constructor. * * @param array $options List of options used to configure the connection * * @since 1.0 */ public function __construct(array $options) { // Get some basic values from the options. $options['host'] = $options['host'] ?? 'localhost'; $options['user'] = $options['user'] ?? ''; $options['password'] = $options['password'] ?? ''; $options['database'] = $options['database'] ?? ''; $options['select'] = isset($options['select']) ? (bool) $options['select'] : true; $options['trust_certificate'] = isset($options['trust_certificate']) ? (bool) $options['trust_certificate'] : false; // Finalize initialisation parent::__construct($options); } /** * Connects to the database if needed. * * @return void Returns void if the database connected successfully. * * @since 1.0 * @throws \RuntimeException */ public function connect() { if ($this->connection) { return; } // Make sure the SQLSRV extension for PHP is installed and enabled. if (!static::isSupported()) { throw new UnsupportedAdapterException('PHP extension sqlsrv_connect is not available.'); } // Build the connection configuration array. $config = [ 'Database' => $this->options['database'], 'uid' => $this->options['user'], 'pwd' => $this->options['password'], 'CharacterSet' => 'UTF-8', 'ReturnDatesAsStrings' => true, 'TrustServerCertificate' => $this->options['trust_certificate'], ]; // Attempt to connect to the server. if (!($this->connection = @ sqlsrv_connect($this->options['host'], $config))) { throw new ConnectionFailureException('Could not connect to SQL Server'); } // Make sure that DB warnings are not returned as errors. sqlsrv_configure('WarningsReturnAsErrors', 0); // If auto-select is enabled select the given database. if ($this->options['select'] && !empty($this->options['database'])) { $this->select($this->options['database']); } $this->dispatchEvent(new ConnectionEvent(DatabaseEvents::POST_CONNECT, $this)); } /** * Disconnects the database. * * @return void * * @since 1.0 */ public function disconnect() { // Close the connection. if (\is_resource($this->connection)) { sqlsrv_close($this->connection); } parent::disconnect(); } /** * Get table constraints * * @param string $tableName The name of the database table. * * @return array Any constraints available for the table. * * @since 1.0 */ protected function getTableConstraints($tableName) { $this->connect(); return $this->setQuery('SELECT CONSTRAINT_NAME FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS WHERE TABLE_NAME = ' . $this->quote($tableName)) ->loadColumn(); } /** * Rename constraints. * * @param array $constraints Array(strings) of table constraints * @param string $prefix A string * @param string $backup A string * * @return void * * @since 1.0 */ protected function renameConstraints($constraints = [], $prefix = null, $backup = null) { $this->connect(); foreach ($constraints as $constraint) { $this->setQuery('sp_rename ' . $constraint . ',' . str_replace($prefix, $backup, $constraint)) ->execute(); } } /** * Method to escape a string for usage in an SQL statement. * * The escaping for MSSQL isn't handled in the driver though that would be nice. Because of this we need to handle the escaping ourselves. * * @param string $text The string to be escaped. * @param boolean $extra Optional parameter to provide extra escaping. * * @return string The escaped string. * * @since 1.0 */ public function escape($text, $extra = false) { if (\is_int($text)) { return $text; } if (\is_float($text)) { // Force the dot as a decimal point. return str_replace(',', '.', $text); } $result = str_replace("'", "''", $text); // SQL Server does not accept NULL byte in query string $result = str_replace("\0", "' + CHAR(0) + N'", $result); // Fix for SQL Sever escape sequence, see https://support.microsoft.com/en-us/kb/164291 $result = str_replace( ["\\\n", "\\\r", "\\\\\r\r\n"], ["\\\\\n\n", "\\\\\r\r", "\\\\\r\n\r\n"], $result ); if ($extra) { // Escape special chars $result = str_replace( ['[', '_', '%'], ['[[]', '[_]', '[%]'], $result ); } return $result; } /** * Quotes and optionally escapes a string to database requirements for use in database queries. * * @param mixed $text A string or an array of strings to quote. * @param boolean $escape True (default) to escape the string, false to leave it unchanged. * * @return string The quoted input string. * * @since 1.6.0 */ public function quote($text, $escape = true) { if (\is_array($text)) { return parent::quote($text, $escape); } // To support unicode on MSSQL we have to add prefix N return 'N\'' . ($escape ? $this->escape($text) : $text) . '\''; } /** * Quotes a binary string to database requirements for use in database queries. * * @param string $data A binary string to quote. * * @return string The binary quoted input string. * * @since 1.7.0 */ public function quoteBinary($data) { // ODBC syntax for hexadecimal literals return '0x' . bin2hex($data); } /** * Determines if the connection to the server is active. * * @return boolean True if connected to the database engine. * * @since 1.0 */ public function connected() { // TODO: Run a blank query here 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 $this * * @since 1.0 */ public function dropTable($table, $ifExists = true) { $this->connect(); if ($ifExists) { $this->setQuery( 'IF EXISTS(SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME = ' . $this->quote($table) . ') DROP TABLE ' . $table ); } else { $this->setQuery('DROP TABLE ' . $table); } $this->execute(); return $this; } /** * Method to get the database collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database or boolean false if not supported. * * @since 1.0 */ public function getCollation() { // TODO: Not fake this return 'MSSQL UTF-8 (UCS2)'; } /** * Method to get the database connection collation in use by sampling a text field of a table in the database. * * @return string|boolean The collation in use by the database connection (string) or boolean false if not supported. * * @since 1.6.0 * @throws \RuntimeException */ public function getConnectionCollation() { // TODO: Not fake this return 'MSSQL UTF-8 (UCS2)'; } /** * Method to get the database encryption details (cipher and protocol) in use. * * @return string The database encryption details. * * @since 2.0.0 * @throws \RuntimeException */ public function getConnectionEncryption(): string { // TODO: Not fake this return ''; } /** * Method to test if the database TLS connections encryption are supported. * * @return boolean Whether the database supports TLS connections encryption. * * @since 2.0.0 */ public function isConnectionEncryptionSupported(): bool { // TODO: Not fake this return false; } /** * Retrieves field information about the given tables. * * @param mixed $table A table name * @param boolean $typeOnly True to only return field types. * * @return array An array of fields. * * @since 1.0 * @throws \RuntimeException */ public function getTableColumns($table, $typeOnly = true) { $result = []; $table_temp = $this->replacePrefix((string) $table); // Set the query to get the table fields statement. $this->setQuery( 'SELECT column_name as Field, data_type as Type, is_nullable as \'Null\', column_default as \'Default\'' . ' FROM information_schema.columns WHERE table_name = ' . $this->quote($table_temp) ); $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); } } else { // If we want the whole field data object add that to the list. foreach ($fields as $field) { $field->Default = preg_replace("/(^(\(\(|\('|\(N'|\()|(('\)|(?<!\()\)\)|\))$))/i", '', $field->Default); $result[$field->Field] = $field; } } return $result; } /** * Shows the table CREATE statement that creates the given tables. * * This is unsupported by MSSQL. * * @param mixed $tables A table name or a list of table names. * * @return array A list of the create SQL for the tables. * * @since 1.0 * @throws \RuntimeException */ public function getTableCreate($tables) { $this->connect(); return ''; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function getTableKeys($table) { $this->connect(); // TODO To implement. return []; } /** * Method to get an array of all tables in the database. * * @return array An array of all the tables in the database. * * @since 1.0 * @throws \RuntimeException */ public function getTableList() { $this->connect(); // Set the query to get the tables statement. return $this->setQuery('SELECT name FROM ' . $this->getDatabase() . '.sys.Tables WHERE type = \'U\';')->loadColumn(); } /** * Get the version of the database connector. * * @return string The database connector version. * * @since 1.0 */ public function getVersion() { $this->connect(); $version = sqlsrv_server_info($this->connection); return $version['SQLServerVersion']; } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function insertObject($table, &$object, $key = null) { $fields = []; $values = []; $tableColumns = $this->getTableColumns($table); $statement = 'INSERT INTO ' . $this->quoteName($table) . ' (%s) VALUES (%s)'; foreach (get_object_vars($object) as $k => $v) { // Skip columns that don't exist in the table. if (!\array_key_exists($k, $tableColumns)) { continue; } // Only process non-null scalars. if (\is_array($v) || \is_object($v) || $v === null) { continue; } if (!$this->checkFieldExists($table, $k)) { continue; } if ($k[0] === '_') { // Internal field continue; } if ($k === $key && $key == 0) { continue; } $fields[] = $this->quoteName($k); $values[] = $this->quote($v); } // Set the query and execute the insert. $this->setQuery(sprintf($statement, implode(',', $fields), implode(',', $values)))->execute(); $id = $this->insertid(); if ($key && $id) { $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. * * @since 1.0 */ public function insertid() { $this->connect(); // TODO: SELECT IDENTITY $this->setQuery('SELECT @@IDENTITY'); return (int) $this->loadResult(); } /** * Execute the SQL statement. * * @return boolean * * @since 1.0 * @throws \RuntimeException */ public function execute() { $this->connect(); // Take a local copy so that we don't modify the original query and cause issues later $sql = $this->replacePrefix((string) $this->sql); // Increment the query counter. $this->count++; // Get list of bounded parameters $bounded =& $this->sql->getBounded(); // If there is a monitor registered, let it know we are starting this query if ($this->monitor) { $this->monitor->startQuery($sql, $bounded); } // Execute the query. $this->executed = false; // Bind the variables foreach ($bounded as $key => $obj) { $this->statement->bindParam($key, $obj->value, $obj->dataType); } try { $this->executed = $this->statement->execute(); // If there is a monitor registered, let it know we have finished this query if ($this->monitor) { $this->monitor->stopQuery(); } return true; } catch (ExecutionFailureException $exception) { // If there is a monitor registered, let it know we have finished this query if ($this->monitor) { $this->monitor->stopQuery(); } // Check if the server was disconnected. if (!$this->connected()) { try { // Attempt to reconnect. $this->connection = null; $this->connect(); } catch (ConnectionFailureException $e) { // If connect fails, ignore that exception and throw the normal exception. throw $exception; } // Since we were able to reconnect, run the query again. return $this->execute(); } // Throw the normal query exception. throw $exception; } } /** * This function replaces a string identifier with the configured table prefix. * * @param string $sql The SQL statement to prepare. * @param string $prefix The table prefix. * * @return string The processed SQL statement. * * @since 1.0 */ public function replacePrefix($sql, $prefix = '#__') { $escaped = false; $startPos = 0; $quoteChar = ''; $literal = ''; $sql = trim($sql); $n = \strlen($sql); while ($startPos < $n) { $ip = strpos($sql, $prefix, $startPos); if ($ip === false) { break; } $j = strpos($sql, "N'", $startPos); $k = strpos($sql, '"', $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($sql, $startPos, $j - $startPos)); $startPos = $j; $j = $startPos + 1; if ($j >= $n) { break; } // Quote comes first, find end of quote while (true) { $k = strpos($sql, $quoteChar, $j); $escaped = false; if ($k === false) { break; } $l = $k - 1; while ($l >= 0 && $sql[$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($sql, $startPos, $k - $startPos + 1); $startPos = $k + 1; } if ($startPos < $n) { $literal .= substr($sql, $startPos, $n - $startPos); } return $literal; } /** * 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. * * @since 1.0 * @throws ConnectionFailureException */ public function select($database) { $this->connect(); if (!$database) { return false; } if (!sqlsrv_query($this->connection, 'USE [' . $database . ']', null, ['scrollable' => \SQLSRV_CURSOR_STATIC])) { throw new ConnectionFailureException('Could not connect to database'); } return true; } /** * Set the connection to use UTF-8 character encoding. * * @return boolean True on success. * * @since 1.0 */ public function setUtf() { return true; } /** * Method to commit a transaction. * * @param boolean $toSavepoint If true, commit to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionCommit($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { $this->setQuery('COMMIT TRANSACTION')->execute(); $this->transactionDepth = 0; return; } $this->transactionDepth--; } /** * Method to roll back a transaction. * * @param boolean $toSavepoint If true, rollback to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionRollback($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth <= 1) { $this->setQuery('ROLLBACK TRANSACTION')->execute(); $this->transactionDepth = 0; return; } $savepoint = 'SP_' . ($this->transactionDepth - 1); $this->setQuery('ROLLBACK TRANSACTION ' . $this->quoteName($savepoint))->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 * * @since 1.0 * @throws \RuntimeException */ public function transactionStart($asSavepoint = false) { $this->connect(); if (!$asSavepoint || !$this->transactionDepth) { $this->setQuery('BEGIN TRANSACTION')->execute(); $this->transactionDepth = 1; return; } $savepoint = 'SP_' . $this->transactionDepth; $this->setQuery('BEGIN TRANSACTION ' . $this->quoteName($savepoint))->execute(); $this->transactionDepth++; } /** * Method to check and see if a field exists in a table. * * @param string $table The table in which to verify the field. * @param string $field The field to verify. * * @return boolean True if the field exists in the table. * * @since 1.0 */ protected function checkFieldExists($table, $field) { $this->connect(); $table = $this->replacePrefix((string) $table); $this->setQuery( "SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = '$table' AND COLUMN_NAME = '$field' ORDER BY ORDINAL_POSITION" ); return (bool) $this->loadResult(); } /** * Prepares a SQL statement for execution * * @param string $query The SQL query to be prepared. * * @return StatementInterface * * @since 2.0.0 * @throws PrepareStatementFailureException */ protected function prepareStatement(string $query): StatementInterface { return new SqlsrvStatement($this->connection, $query); } /** * 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 $this * * @since 1.0 * @throws \RuntimeException */ public function renameTable($oldTable, $newTable, $backup = null, $prefix = null) { $constraints = []; if ($prefix !== null && $backup !== null) { $constraints = $this->getTableConstraints($oldTable); } if (!empty($constraints)) { $this->renameConstraints($constraints, $prefix, $backup); } $this->setQuery("sp_rename '" . $oldTable . "', '" . $newTable . "'"); $this->execute(); return $this; } /** * Locks a table in the database. * * @param string $tableName The name of the table to lock. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function lockTable($tableName) { return $this; } /** * Unlocks tables in the database. * * @return $this * * @since 1.0 * @throws \RuntimeException */ public function unlockTables() { return $this; } } PK c�\Sȡ �: �: ' database/src/Sqlsrv/SqlsrvStatement.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Sqlsrv; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\Exception\PrepareStatementFailureException; use Joomla\Database\FetchMode; use Joomla\Database\FetchOrientation; use Joomla\Database\ParameterType; use Joomla\Database\StatementInterface; /** * SQL Server Database Statement. * * This class is modeled on \Doctrine\DBAL\Driver\SQLSrv\SQLSrvStatement * * @since 2.0.0 */ class SqlsrvStatement implements StatementInterface { /** * The database connection resource. * * @var resource * @since 2.0.0 */ protected $connection; /** * The default fetch mode for the statement. * * @var integer * @since 2.0.0 */ protected $defaultFetchStyle = FetchMode::MIXED; /** * The default class to use for building object result sets. * * @var integer * @since 2.0.0 */ protected $defaultObjectClass = \stdClass::class; /** * Mapping array converting fetch modes to the native engine type. * * @var array * @since 2.0.0 */ private $fetchMap = [ FetchMode::MIXED => SQLSRV_FETCH_BOTH, FetchMode::ASSOCIATIVE => SQLSRV_FETCH_ASSOC, FetchMode::NUMERIC => SQLSRV_FETCH_NUMERIC, ]; /** * The query string being prepared. * * @var string * @since 2.0.0 */ protected $query; /** * Internal tracking flag to set whether there is a result set available for processing * * @var boolean * @since 2.0.0 */ private $result = false; /** * The prepared statement. * * @var resource * @since 2.0.0 */ protected $statement; /** * Bound parameter types. * * @var array * @since 2.0.0 */ protected $typesKeyMapping; /** * References to the variables bound as statement parameters. * * @var array * @since 2.0.0 */ private $bindedValues = []; /** * Mapping between named parameters and position in query. * * @var array * @since 2.0.0 */ protected $parameterKeyMapping; /** * Mapping array for parameter types. * * @var array * @since 2.0.0 */ protected $parameterTypeMapping = [ ParameterType::BOOLEAN => ParameterType::BOOLEAN, ParameterType::INTEGER => ParameterType::INTEGER, ParameterType::LARGE_OBJECT => ParameterType::LARGE_OBJECT, ParameterType::NULL => ParameterType::NULL, ParameterType::STRING => ParameterType::STRING, ]; /** * Constructor. * * @param resource $connection The database connection resource * @param string $query The query this statement will process * * @since 2.0.0 * @throws PrepareStatementFailureException */ public function __construct($connection, string $query) { // Initial parameter types for prepared statements $this->parameterTypeMapping = [ ParameterType::BOOLEAN => SQLSRV_PHPTYPE_INT, ParameterType::INTEGER => SQLSRV_PHPTYPE_INT, ParameterType::LARGE_OBJECT => SQLSRV_PHPTYPE_STREAM(SQLSRV_ENC_BINARY), ParameterType::NULL => SQLSRV_PHPTYPE_NULL, ParameterType::STRING => SQLSRV_PHPTYPE_STRING(SQLSRV_ENC_CHAR), ]; $this->connection = $connection; $this->query = $this->prepareParameterKeyMapping($query); } /** * Replace named parameters with numbered parameters * * @param string $sql The SQL statement to prepare. * * @return string The processed SQL statement. * * @since 2.0.0 */ public function prepareParameterKeyMapping($sql) { $escaped = false; $startPos = 0; $quoteChar = ''; $literal = ''; $mapping = []; $replace = []; $matches = []; $pattern = '/([:][a-zA-Z0-9_]+)/'; if (!preg_match($pattern, $sql, $matches)) { return $sql; } $sql = trim($sql); $n = \strlen($sql); while ($startPos < $n) { if (!preg_match($pattern, $sql, $matches, 0, $startPos)) { break; } $j = strpos($sql, "'", $startPos); $k = strpos($sql, '"', $startPos); if (($k !== false) && (($k < $j) || ($j === false))) { $quoteChar = '"'; $j = $k; } else { $quoteChar = "'"; } if ($j === false) { $j = $n; } // Search for named prepared parameters and replace it with ? and save its position $substring = substr($sql, $startPos, $j - $startPos); if (preg_match_all($pattern, $substring, $matches, PREG_PATTERN_ORDER + PREG_OFFSET_CAPTURE)) { foreach ($matches[0] as $i => $match) { if ($i === 0) { $literal .= substr($substring, 0, $match[1]); } $mapping[$match[0]] = \count($mapping); $endOfPlaceholder = $match[1] + strlen($match[0]); $beginOfNextPlaceholder = $matches[0][$i + 1][1] ?? strlen($substring); $beginOfNextPlaceholder -= $endOfPlaceholder; $literal .= '?' . substr($substring, $endOfPlaceholder, $beginOfNextPlaceholder); } } else { $literal .= $substring; } $startPos = $j; $j++; if ($j >= $n) { break; } // Quote comes first, find end of quote while (true) { $k = strpos($sql, $quoteChar, $j); $escaped = false; if ($k === false) { break; } $l = $k - 1; while ($l >= 0 && $sql[$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($sql, $startPos, $k - $startPos + 1); $startPos = $k + 1; } if ($startPos < $n) { $literal .= substr($sql, $startPos, $n - $startPos); } $this->parameterKeyMapping = $mapping; return $literal; } /** * Binds a parameter to the specified variable name. * * @param string|integer $parameter Parameter identifier. For a prepared statement using named placeholders, this will be a parameter * name of the form `:name`. For a prepared statement using question mark placeholders, this will be * the 1-indexed position of the parameter. * @param mixed $variable Name of the PHP variable to bind to the SQL statement parameter. * @param string $dataType Constant corresponding to a SQL datatype, this should be the processed type from the QueryInterface. * @param integer $length The length of the variable. Usually required for OUTPUT parameters. * @param array $driverOptions Optional driver options to be used. * * @return boolean * * @since 2.0.0 */ public function bindParam($parameter, &$variable, string $dataType = ParameterType::STRING, ?int $length = null, ?array $driverOptions = null) { $this->bindedValues[$parameter] =& $variable; // Validate parameter type if (!isset($this->parameterTypeMapping[$dataType])) { throw new \InvalidArgumentException(sprintf('Unsupported parameter type `%s`', $dataType)); } $this->typesKeyMapping[$parameter] = $this->parameterTypeMapping[$dataType]; $this->statement = null; return true; } /** * Binds a value to the specified variable. * * @param string|integer $parameter Parameter identifier. For a prepared statement using named placeholders, this will be a parameter * name of the form `:name`. For a prepared statement using question mark placeholders, this will be * the 1-indexed position of the parameter. * @param mixed $variable Name of the PHP variable to bind to the SQL statement parameter. * @param string $dataType Constant corresponding to a SQL datatype, this should be the processed type from the QueryInterface. * * @return void * * @since 2.0.0 */ private function bindValue($parameter, $variable, $dataType = ParameterType::STRING) { $this->bindedValues[$parameter] = $variable; $this->typesKeyMapping[$parameter] = $dataType; } /** * Closes the cursor, enabling the statement to be executed again. * * @return void * * @since 2.0.0 */ public function closeCursor(): void { if (!$this->result || !\is_resource($this->statement)) { return; } // Emulate freeing the result fetching and discarding rows, similarly to what PDO does in this case while (sqlsrv_fetch($this->statement)) { // Do nothing (see above) } $this->result = false; } /** * Fetches the SQLSTATE associated with the last operation on the statement handle. * * @return string * * @since 2.0.0 */ public function errorCode() { $errors = sqlsrv_errors(SQLSRV_ERR_ERRORS); if ($errors) { return $errors[0]['code']; } return false; } /** * Fetches extended error information associated with the last operation on the statement handle. * * @return array * * @since 2.0.0 */ public function errorInfo() { return sqlsrv_errors(SQLSRV_ERR_ERRORS); } /** * Executes a prepared statement * * @param array|null $parameters An array of values with as many elements as there are bound parameters in the SQL statement being executed. * * @return boolean * * @since 2.0.0 */ public function execute(?array $parameters = null) { if (empty($this->bindedValues) && $parameters !== null) { $hasZeroIndex = array_key_exists(0, $parameters); foreach ($parameters as $key => $val) { $key = ($hasZeroIndex && is_numeric($key)) ? $key + 1 : $key; $this->bindValue($key, $val); } } if (!$this->statement) { $this->statement = $this->prepare(); } if (!sqlsrv_execute($this->statement)) { $errors = $this->errorInfo(); throw new ExecutionFailureException($this->query, $errors[0]['message'], $errors[0]['code']); } $this->result = true; return true; } /** * Fetches the next row from a result set * * @param integer|null $fetchStyle Controls how the next row will be returned to the caller. This value must be one of the * FetchMode constants, defaulting to value of FetchMode::MIXED. * @param integer $cursorOrientation For a StatementInterface object representing a scrollable cursor, this value determines which row * will be returned to the caller. This value must be one of the FetchOrientation constants, * defaulting to FetchOrientation::NEXT. * @param integer $cursorOffset For a StatementInterface object representing a scrollable cursor for which the cursorOrientation * parameter is set to FetchOrientation::ABS, this value specifies the absolute number of the row in * the result set that shall be fetched. For a StatementInterface object representing a scrollable * cursor for which the cursorOrientation parameter is set to FetchOrientation::REL, this value * specifies the row to fetch relative to the cursor position before `fetch()` was called. * * @return mixed The return value of this function on success depends on the fetch type. In all cases, boolean false is returned on failure. * * @since 2.0.0 */ public function fetch(?int $fetchStyle = null, int $cursorOrientation = FetchOrientation::NEXT, int $cursorOffset = 0) { if (!$this->result) { return false; } $fetchStyle = $fetchStyle ?: $this->defaultFetchStyle; if ($fetchStyle === FetchMode::COLUMN) { return $this->fetchColumn(); } if (isset($this->fetchMap[$fetchStyle])) { return sqlsrv_fetch_array($this->statement, $this->fetchMap[$fetchStyle]) ?: false; } if (\in_array($fetchStyle, [FetchMode::STANDARD_OBJECT, FetchMode::CUSTOM_OBJECT], true)) { return sqlsrv_fetch_object($this->statement, $this->defaultObjectClass) ?: false; } throw new \InvalidArgumentException("Unknown fetch type '{$fetchStyle}'"); } /** * Returns a single column from the next row of a result set * * @param integer $columnIndex 0-indexed number of the column you wish to retrieve from the row. * If no value is supplied, the first column is retrieved. * * @return mixed Returns a single column from the next row of a result set or boolean false if there are no more rows. * * @since 2.0.0 */ public function fetchColumn($columnIndex = 0) { $row = $this->fetch(FetchMode::NUMERIC); if ($row === false) { return false; } return $row[$columnIndex] ?? null; } /** * Prepares the SQL Server statement resource for execution * * @return resource * * @since 2.0.0 */ private function prepare() { $params = []; $options = []; foreach ($this->bindedValues as $key => &$value) { $variable = [ &$value, SQLSRV_PARAM_IN ]; if ($this->typesKeyMapping[$key] === $this->parameterTypeMapping[ParameterType::LARGE_OBJECT]) { $variable[] = $this->typesKeyMapping[$key]; $variable[] = SQLSRV_SQLTYPE_VARBINARY('max'); } if (isset($this->parameterKeyMapping[$key])) { $params[$this->parameterKeyMapping[$key]] = $variable; } else { $params[] = $variable; } } // Cleanup referenced variable unset($value); // SQLSRV Function sqlsrv_num_rows requires a static or keyset cursor. if (strncmp(strtoupper(ltrim($this->query)), 'SELECT', \strlen('SELECT')) === 0) { $options = ['Scrollable' => SQLSRV_CURSOR_KEYSET]; } $statement = sqlsrv_prepare($this->connection, $this->query, $params, $options); if (!$statement) { $errors = $this->errorInfo(); throw new PrepareStatementFailureException($errors[0]['message'], $errors[0]['code']); } return $statement; } /** * Returns the number of rows affected by the last SQL statement. * * @return integer * * @since 2.0.0 */ public function rowCount(): int { if (strncmp(strtoupper(ltrim($this->query)), 'SELECT', \strlen('SELECT')) === 0) { return sqlsrv_num_rows($this->statement); } return sqlsrv_rows_affected($this->statement); } /** * Sets the fetch mode to use while iterating this statement. * * @param integer $fetchMode The fetch mode, must be one of the FetchMode constants. * @param mixed ...$args Optional mode-specific arguments. * * @return void * * @since 2.0.0 */ public function setFetchMode(int $fetchMode, ...$args): void { $this->defaultFetchStyle = $fetchMode; if (isset($args[0])) { $this->defaultObjectClass = $args[0]; } } } PK c�\� `��n �n # database/src/Sqlsrv/SqlsrvQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Sqlsrv; use Joomla\Database\DatabaseInterface; use Joomla\Database\DatabaseQuery; use Joomla\Database\Query\QueryElement; /** * SQL Server Query Building Class. * * @since 1.0 */ class SqlsrvQuery extends DatabaseQuery { /** * The list of zero or null representation of a datetime. * * @var array * @since 2.0.0 */ protected $nullDatetimeList = ['1900-01-01 00:00:00']; /** * Magic function to convert the query to a string. * * @return string The completed query. * * @since 1.0 */ public function __toString() { // For the moment if we are given a query string we can't effectively process limits, fix this later if ($this->sql) { return $this->sql; } $query = ''; switch ($this->type) { case 'select': // Add required aliases for offset or fixGroupColumns method $columns = $this->fixSelectAliases(); $query = (string) $this->select; if ($this->group) { $this->fixGroupColumns($columns); } $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->selectRowNumber === null) { if ($this->group) { $query .= (string) $this->group; } if ($this->having) { $query .= (string) $this->having; } if ($this->merge) { // Special case for merge foreach ($this->merge as $idx => $element) { $query .= (string) $element . ' AS merge_' . (int) ($idx + 1); } } } if ($this->order) { $query .= (string) $this->order; } else { $query .= PHP_EOL . '/*ORDER BY (SELECT 0)*/'; } $query = $this->processLimit($query, $this->limit, $this->offset); if ($this->alias !== null) { $query = '(' . $query . ') AS ' . $this->alias; } break; case 'querySet': $query = $this->querySet; if ($query->order || $query->limit || $query->offset) { // If ORDER BY or LIMIT statement exist then parentheses is required for the first query $query = PHP_EOL . "SELECT * FROM ($query) AS merge_0"; } if ($this->merge) { // Special case for merge foreach ($this->merge as $idx => $element) { $query .= (string) $element . ' AS merge_' . (int) ($idx + 1); } } if ($this->order) { $query .= (string) $this->order; } $query = $this->processLimit($query, $this->limit, $this->offset); break; case 'insert': $query .= (string) $this->insert; // Set method if ($this->set) { $query .= (string) $this->set; } elseif ($this->values) { // Columns-Values method if ($this->columns) { $query .= (string) $this->columns; } $elements = $this->insert->getElements(); $tableName = array_shift($elements); $query .= 'VALUES '; $query .= (string) $this->values; if ($this->autoIncrementField) { $query = 'SET IDENTITY_INSERT ' . $tableName . ' ON;' . $query . 'SET IDENTITY_INSERT ' . $tableName . ' OFF;'; } if ($this->where) { $query .= (string) $this->where; } } 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; } if ($this->order) { $query .= (string) $this->order; } break; case 'update': if ($this->join) { $tmpUpdate = $this->update; $tmpFrom = $this->from; $this->update = null; $this->from = null; $updateElem = $tmpUpdate->getElements(); $updateArray = explode(' ', $updateElem[0]); // Use table alias if exists $this->update(end($updateArray)); $this->from($updateElem[0]); $query .= (string) $this->update; $query .= (string) $this->set; $query .= (string) $this->from; $this->update = $tmpUpdate; $this->from = $tmpFrom; // Special case for joins foreach ($this->join as $join) { $query .= (string) $join; } } else { $query .= (string) $this->update; $query .= (string) $this->set; } if ($this->where) { $query .= (string) $this->where; } if ($this->order) { $query .= (string) $this->order; } break; default: $query = parent::__toString(); break; } return $query; } /** * Casts a value to a char. * * Ensure that the value is properly quoted before passing to the method. * * Usage: * $query->select($query->castAs('CHAR', 'a')); * * @param string $type The type of string to cast as. * @param string $value The value to cast as a char. * @param string $length The value to cast as a char. * * @return string SQL statement to cast the value as a char type. * * @since 1.0 */ public function castAs(string $type, string $value, ?string $length = null) { switch (strtoupper($type)) { case 'CHAR': if (!$length) { $length = '10'; } return 'CAST(' . $value . ' as NVARCHAR(' . $length . '))'; case 'INT': return 'CAST(' . $value . ' AS INT)'; } return parent::castAs($type, $value, $length); } /** * Gets the function to determine the length of a character string. * * @param string $field A value. * @param string|null $operator Comparison operator between charLength integer value and $condition * @param string|null $condition Integer value to compare charLength with. * * @return string The required char length call. * * @since 1.0 */ public function charLength($field, $operator = null, $condition = null) { $statement = 'DATALENGTH(' . $field . ')'; if ($operator !== null && $condition !== null) { $statement .= ' ' . $operator . ' ' . $condition; } return $statement; } /** * Concatenates an array of column names or values. * * @param string[] $values An array of values to concatenate. * @param string|null $separator As separator to place between each value. * * @return string The concatenated values. * * @since 1.0 */ public function concatenate($values, $separator = null) { if ($separator !== null) { return '(' . implode('+' . $this->quote($separator) . '+', $values) . ')'; } return '(' . implode('+', $values) . ')'; } /** * Gets the current date and time. * * @return string * * @since 1.0 */ public function currentTimestamp() { return 'GETDATE()'; } /** * Get the length of a string in bytes. * * @param string $value The string to measure. * * @return integer * * @since 1.0 */ public function length($value) { return 'LEN(' . $value . ')'; } /** * 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 SqlsrvQuery Returns this object to allow chaining. * * @since 1.5.0 */ public function group($columns) { if (!($this->db instanceof DatabaseInterface)) { throw new \RuntimeException('JLIB_DATABASE_ERROR_INVALID_DB_OBJECT'); } // Transform $columns into an array for filtering purposes \is_string($columns) && $columns = explode(',', str_replace(' ', '', $columns)); // Get the _formatted_ FROM string and remove everything except `table AS alias` $fromStr = str_replace(['[', ']'], '', str_replace('#__', $this->db->getPrefix(), str_replace('FROM ', '', (string) $this->from))); // Start setting up an array of alias => table list($table, $alias) = preg_split("/\sAS\s/i", $fromStr); $tmpCols = $this->db->getTableColumns(trim($table)); $cols = []; foreach ($tmpCols as $name => $type) { $cols[] = $alias . '.' . $name; } // Now we need to get all tables from any joins // Go through all joins and add them to the tables array foreach ($this->join as $join) { $joinTbl = str_replace( '#__', $this->db->getPrefix(), str_replace( ']', '', preg_replace("/.*(#.+\sAS\s[^\s]*).*/i", '$1', (string) $join) ) ); list($table, $alias) = preg_split("/\sAS\s/i", $joinTbl); $tmpCols = $this->db->getTableColumns(trim($table)); foreach ($tmpCols as $name => $tmpColType) { $cols[] = $alias . '.' . $name; } } $selectStr = str_replace('SELECT ', '', (string) $this->select); // Remove any functions (e.g. COUNT(), SUM(), CONCAT()) $selectCols = preg_replace("/([^,]*\([^\)]*\)[^,]*,?)/", '', $selectStr); // Remove any "as alias" statements $selectCols = preg_replace("/(\sas\s[^,]*)/i", '', $selectCols); // Remove any extra commas $selectCols = preg_replace('/,{2,}/', ',', $selectCols); // Remove any trailing commas and all whitespaces $selectCols = trim(str_replace(' ', '', preg_replace('/,?$/', '', $selectCols))); // Get an array to compare against $selectCols = explode(',', $selectCols); // Find all alias.* and fill with proper table column names foreach ($selectCols as $key => $aliasColName) { if (preg_match("/.+\*/", $aliasColName, $match)) { // Grab the table alias minus the .* $aliasStar = preg_replace("/(.+)\.\*/", '$1', $aliasColName); // Unset the array key unset($selectCols[$key]); // Get the table name $tableColumns = preg_grep("/{$aliasStar}\.+/", $cols); $columns = array_merge($columns, $tableColumns); } } // Finally, get a unique string of all column names that need to be included in the group statement $columns = array_unique(array_merge($columns, $selectCols)); $columns = implode(',', $columns); // Recreate it every time, to ensure we have checked _all_ select statements $this->group = new QueryElement('GROUP BY', $columns); return $this; } /** * Aggregate function to get input values concatenated into a string, separated by delimiter * * Usage: * $query->groupConcat('id', ','); * * @param string $expression The expression to apply concatenation to, this may be a column name or complex SQL statement. * @param string $separator The delimiter of each concatenated value * * @return string Input values concatenated into a string, separated by delimiter * * @since 2.0.0 */ public function groupConcat($expression, $separator = ',') { return 'string_agg(' . $expression . ', ' . $this->quote($separator) . ')'; } /** * Get the function to return a random floating-point value * * Usage: * $query->rand(); * * @return string * * @since 1.5.0 */ public function rand() { return ' NEWID() '; } /** * Find a value in a varchar used like a set. * * Ensure that the value is an integer before passing to the method. * * Usage: * $query->findInSet((int) $parent->id, 'a.assigned_cat_ids') * * @param string $value The value to search for. * @param string $set The set of values. * * @return string A representation of the MySQL find_in_set() function for the driver. * * @since 1.5.0 */ public function findInSet($value, $set) { return "CHARINDEX(',$value,', ',' + $set + ',') > 0"; } /** * Add required aliases to columns for select statement in subquery. * * @return array[] Array of columns with added missing aliases. * * @since 2.0.0 */ protected function fixSelectAliases() { $operators = [ '+' => '', '-' => '', '*' => '', '/' => '', '%' => '', '&' => '', '|' => '', '~' => '', '^' => '', ]; // Split into array and remove comments $columns = $this->splitSqlExpression(implode(',', $this->select->getElements())); foreach ($columns as $i => $column) { $size = \count($column); if ($size == 0) { continue; } if ($size > 2 && strcasecmp($column[$size - 2], 'AS') === 0) { // Alias exists, replace it to uppercase $columns[$i][$size - 2] = 'AS'; continue; } if ($i == 0 && stripos(' DISTINCT ALL ', " $column[0] ") !== false) { // This words are reserved, they are not column names array_shift($column); $size--; } $lastWord = strtoupper($column[$size - 1]); $length = \strlen($lastWord); $lastChar = $lastWord[$length - 1]; if ($lastChar == '*') { // Skip on wildcard continue; } if ($lastChar == ')' || ($size == 1 && $lastChar == "'") || $lastWord[0] == '@' || $lastWord == 'NULL' || $lastWord == 'END' || is_numeric($lastWord)) { /* * Ends with: * - SQL function * - single static value like 'only '+'string' * - @@var * - NULL * - CASE ... END * - Numeric */ $columns[$i][] = 'AS'; $columns[$i][] = $this->quoteName('columnAlias' . $i); continue; } if ($size == 1) { continue; } $lastChar2 = substr($column[$size - 2], -1); // Check if column ends with '- a.x' or '- a. x' if (isset($operators[$lastChar2]) || ($size > 2 && $lastChar2 === '.' && isset($operators[substr($column[$size - 3], -1)]))) { // Ignore plus signs if column start with them if ($size != 2 || ltrim($column[0], '+') !== '' || $column[1][0] === "'") { // If operator exists before last word then alias is required for subquery $columns[$i][] = 'AS'; $columns[$i][] = $this->quoteName('columnAlias' . $i); continue; } } elseif ($column[$size - 1][0] !== '.' && $lastChar2 !== '.') { // If columns is like name name2 then second word is alias. // Add missing AS before the alias, exception for 'a. x' and 'a .x' array_splice($columns[$i], -1, 0, 'AS'); } } $selectColumns = []; foreach ($columns as $i => $column) { $selectColumns[$i] = implode(' ', $column); } $this->select = new QueryElement('SELECT', $selectColumns); return $columns; } /** * Add missing columns names to GROUP BY clause. * * @param array[] $selectColumns Array of columns from splitSqlExpression method. * * @return $this * * @since 2.0.0 */ protected function fixGroupColumns($selectColumns) { // Cache tables columns static $cacheCols = []; // Known columns of all included tables $knownColumnsByAlias = []; $iquotes = ['"' => '', '[' => '', "'" => '']; $nquotes = ['"', '[', ']']; // Aggregate functions $aFuncs = [ 'AVG(', 'CHECKSUM_AGG(', 'COUNT(', 'COUNT_BIG(', 'GROUPING(', 'GROUPING_ID(', 'MIN(', 'MAX(', 'SUM(', 'STDEV(', 'STDEVP(', 'VAR(', 'VARP(', ]; // Aggregated columns $filteredColumns = []; // Aliases found in SELECT statement $knownAliases = []; $wildcardTables = []; foreach ($selectColumns as $i => $column) { $size = \count($column); if ($size === 0) { continue; } if ($i == 0 && stripos(' DISTINCT ALL ', " $column[0] ") !== false) { // These words are reserved, they are not column names array_shift($selectColumns[0]); array_shift($column); $size--; } if ($size > 2 && $column[$size - 2] === 'AS') { // Save and remove AS alias $alias = $column[$size - 1]; if (isset($iquotes[$alias[0]])) { $alias = substr($alias, 1, -1); } // Remove alias $selectColumns[$i] = $column = \array_slice($column, 0, -2); if ($size === 3 || ($size === 4 && strpos('+-*/%&|~^', $column[0][0]) !== false)) { $lastWord = $column[$size - 3]; if ($lastWord[0] === "'" || $lastWord === 'NULL' || is_numeric($lastWord)) { unset($selectColumns[$i]); continue; } } // Remember pair alias => column expression $knownAliases[$alias] = implode(' ', $column); } $aggregated = false; foreach ($column as $j => $block) { if (substr($block, -2) === '.*') { // Found column ends with .* if (isset($iquotes[$block[0]])) { // Quoted table $wildcardTables[] = substr($block, 1, -3); } else { $wildcardTables[] = substr($block, 0, -2); } } elseif (str_ireplace($aFuncs, '', $block) != $block) { $aggregated = true; } if ($block[0] === "'") { // Shrink static strings which could contain column name $column[$j] = "''"; } } if (!$aggregated) { // Without aggregated columns and aliases $filteredColumns[] = implode(' ', $selectColumns[$i]); } // Without aliases and static strings $selectColumns[$i] = implode(' ', $column); } // If select statement use table.* expression if ($wildcardTables) { // Split FROM statement into list of tables $tables = $this->splitSqlExpression(implode(',', $this->from->getElements())); foreach ($tables as $i => $table) { $table = implode(' ', $table); // Exclude subquery from the FROM clause if (strpos($table, '(') === false) { // Unquote $table = str_replace($nquotes, '', $table); $table = str_replace('#__', $this->db->getPrefix(), $table); $table = explode(' ', $table); $alias = end($table); $table = $table[0]; // Chek if exists a wildcard with current alias table? if (\in_array($alias, $wildcardTables, true)) { if (!isset($cacheCols[$table])) { $cacheCols[$table] = $this->db->getTableColumns($table); } if ($this->join || $table != $alias) { foreach ($cacheCols[$table] as $name => $type) { $knownColumnsByAlias[$alias][] = $alias . '.' . $name; } } else { foreach ($cacheCols[$table] as $name => $type) { $knownColumnsByAlias[$alias][] = $name; } } } } } // Now we need to get all tables from any joins // Go through all joins and add them to the tables array if ($this->join) { foreach ($this->join as $join) { // Unquote and replace prefix $joinTbl = str_replace($nquotes, '', (string) $join); $joinTbl = str_replace('#__', $this->db->getPrefix(), $joinTbl); // Exclude subquery if (preg_match('/JOIN\s+(\w+)(?:\s+AS)?(?:\s+(\w+))?/i', $joinTbl, $matches)) { $table = $matches[1]; $alias = $matches[2] ?? $table; // Chek if exists a wildcard with current alias table? if (\in_array($alias, $wildcardTables, true)) { if (!isset($cacheCols[$table])) { $cacheCols[$table] = $this->db->getTableColumns($table); } foreach ($cacheCols[$table] as $name => $type) { $knownColumnsByAlias[$alias][] = $alias . '.' . $name; } } } } } } $selectExpression = implode(',', $selectColumns); // Split into the right columns $groupColumns = $this->splitSqlExpression(implode(',', $this->group->getElements())); // Remove column aliases from GROUP statement - SQLSRV does not support it foreach ($groupColumns as $i => $column) { $groupColumns[$i] = implode(' ', $column); $column = str_replace($nquotes, '', $groupColumns[$i]); if (isset($knownAliases[$column])) { // Be sure that this is not a valid column name if (!preg_match('/\b' . preg_quote($column, '/') . '\b/', $selectExpression)) { // Replace column alias by column expression $groupColumns[$i] = $knownAliases[$column]; } } } // Find all alias.* and fill with proper table column names foreach ($filteredColumns as $i => $column) { if (substr($column, -2) === '.*') { unset($filteredColumns[$i]); // Extract alias.* columns into GROUP BY statement $groupColumns = array_merge($groupColumns, $knownColumnsByAlias[substr($column, 0, -2)]); } } $groupColumns = array_merge($groupColumns, $filteredColumns); if ($this->order) { // Remove direction suffixes $dir = [" DESC\v", " ASC\v"]; $orderColumns = $this->splitSqlExpression(implode(',', $this->order->getElements())); foreach ($orderColumns as $i => $column) { $column = implode(' ', $column); $orderColumns[$i] = $column = trim(str_ireplace($dir, '', "$column\v"), "\v"); if (isset($knownAliases[str_replace($nquotes, '', $column)])) { unset($orderColumns[$i]); } if (str_ireplace($aFuncs, '', $column) != $column) { // Do not add aggregate expression unset($orderColumns[$i]); } } $groupColumns = array_merge($groupColumns, $orderColumns); } // Get a unique string of all column names that need to be included in the group statement $this->group = new QueryElement('GROUP BY', array_unique($groupColumns)); return $this; } /** * Split a string of sql expression into an array of individual columns. * Single line or line end comments and multi line comments are stripped off. * Always return at least one column. * * @param string $string Input string of sql expression like select expression. * * @return array[] The columns from the input string separated into an array. * * @since 2.0.0 */ protected function splitSqlExpression($string) { // Append whitespace as equivalent to the last comma $string .= ' '; $colIdx = 0; $start = 0; $open = false; $openC = 0; $comment = false; $endString = ''; $length = \strlen($string); $columns = []; $column = []; $current = ''; $previous = null; $operators = [ '+' => '', '-' => '', '*' => '', '/' => '', '%' => '', '&' => '', '|' => '', '~' => '', '^' => '', ]; $addBlock = function ($block) use (&$column, &$colIdx) { if (isset($column[$colIdx])) { $column[$colIdx] .= $block; } else { $column[$colIdx] = $block; } }; for ($i = 0; $i < $length; $i++) { $current = substr($string, $i, 1); $current2 = substr($string, $i, 2); $current3 = substr($string, $i, 3); $lenEndString = \strlen($endString); $testEnd = substr($string, $i, $lenEndString); if ($current == '[' || $current == '"' || $current == "'" || $current2 == '--' || ($current2 == '/*') || ($current == '#' && $current3 != '#__') || ($lenEndString && $testEnd == $endString)) { if ($open) { if ($testEnd === $endString) { if ($comment) { if ($lenEndString > 1) { $i += ($lenEndString - 1); } // Move cursor after close tag of comment $start = $i + 1; $comment = false; } elseif ($current == "'" || $current == ']' || $current == '"') { // Check for escaped quote like '', ]] or "" $n = 1; while ($i + $n < $length && $string[$i + $n] == $current) { $n++; } // Jump to the last quote $i += $n - 1; if ($n % 2 === 0) { // There is only escaped quote continue; } if ($n > 2) { // The last right close quote is not escaped $current = $string[$i]; } } $open = false; $endString = ''; } } else { $open = true; if ($current == '#' || $current2 == '--') { $endString = "\n"; $comment = true; } elseif ($current2 == '/*') { $endString = '*/'; $comment = true; } elseif ($current == '[') { $endString = ']'; } else { $endString = $current; } if ($comment && $start < $i) { // Add string exists before comment $addBlock(substr($string, $start, $i - $start)); $previous = $string[$i - 1]; $start = $i; } } } elseif (!$open) { if ($current == '(') { $openC++; $previous = $current; } elseif ($current == ')') { $openC--; $previous = $current; } elseif ($current == '.') { if ($i === $start && $colIdx > 0 && !isset($column[$colIdx])) { // Remove whitespace placed before dot $colIdx--; } $previous = $current; } elseif ($openC === 0) { if (ctype_space($current)) { // Normalize whitespace $string[$i] = ' '; if ($start < $i) { // Add text placed before whitespace $addBlock(substr($string, $start, $i - $start)); $colIdx++; $previous = $string[$i - 1]; } elseif (isset($column[$colIdx])) { if ($colIdx > 1 || !isset($operators[$previous])) { // There was whitespace after comment $colIdx++; } } // Move cursor forward $start = $i + 1; } elseif (isset($operators[$current]) && ($current !== '*' || $previous !== '.')) { if ($start < $i) { // Add text before operator $addBlock(substr($string, $start, $i - $start)); $colIdx++; } elseif (!isset($column[$colIdx]) && isset($operators[$previous])) { // Do not create whitespace between operators $colIdx--; } // Add operator $addBlock($current); $previous = $current; $colIdx++; // Move cursor forward $start = $i + 1; } else { $previous = $current; } } } if (($current == ',' && !$open && $openC == 0) || $i == $length - 1) { if ($start < $i && !$comment) { // Save remaining text $addBlock(substr($string, $start, $i - $start)); } $columns[] = $column; // Reset values $column = []; $colIdx = 0; $previous = null; // Column saved, move cursor forward after comma $start = $i + 1; } } return $columns; } /** * 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 * * @since 2.0.0 */ public function processLimit($query, $limit, $offset = 0) { if ($offset > 0) { // Find a position of the last comment $commentPos = strrpos($query, '/*ORDER BY (SELECT 0)*/'); // If the last comment belongs to this query, not previous subquery if ($commentPos !== false && $commentPos + 2 === strripos($query, 'ORDER BY', $commentPos + 2)) { // We can not use OFFSET without ORDER BY $query = substr_replace($query, 'ORDER BY (SELECT 0)', $commentPos, 23); } $query .= PHP_EOL . 'OFFSET ' . (int) $offset . ' ROWS'; if ($limit > 0) { $query .= PHP_EOL . 'FETCH NEXT ' . (int) $limit . ' ROWS ONLY'; } } elseif ($limit > 0) { $position = stripos($query, 'SELECT'); $distinct = stripos($query, 'SELECT DISTINCT'); if ($position === $distinct) { $query = substr_replace($query, 'SELECT DISTINCT TOP ' . (int) $limit, $position, 15); } else { $query = substr_replace($query, 'SELECT TOP ' . (int) $limit, $position, 6); } } return $query; } /** * Add a query to UNION with the current query. * * Usage: * $query->union('SELECT name FROM #__foo') * $query->union('SELECT name FROM #__foo', true) * * @param DatabaseQuery|string $query The DatabaseQuery object or string to union. * @param boolean $distinct True to only return distinct rows from the union. * * @return $this * * @since 1.0 */ public function union($query, $distinct = true) { // Set up the name with parentheses, the DISTINCT flag is redundant return $this->merge($distinct ? 'UNION SELECT * FROM ()' : 'UNION ALL SELECT * FROM ()', $query); } } PK c�\6��: : database/src/DatabaseEvents.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Class defining the events dispatched by the database API * * @since 2.0.0 */ final class DatabaseEvents { /** * Private constructor to prevent instantiation of this class * * @since 2.0.0 */ private function __construct() { } /** * Database event which is dispatched after the connection to the database server is opened. * * Listeners to this event receive a `Joomla\Database\Event\ConnectionEvent` object. * * @var string * @since 2.0.0 */ public const POST_CONNECT = 'onAfterConnect'; /** * Database event which is dispatched after the connection to the database server is closed. * * Listeners to this event receive a `Joomla\Database\Event\ConnectionEvent` object. * * @var string * @since 2.0.0 */ public const POST_DISCONNECT = 'onAfterDisconnect'; } PK c�\7*�h� � ' database/src/Sqlazure/SqlazureQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Sqlazure; use Joomla\Database\Sqlsrv\SqlsrvQuery; /** * SQL Azure Query Building Class. * * @since 1.0 */ class SqlazureQuery extends SqlsrvQuery { } PK c�\�$�M M ( database/src/Sqlazure/SqlazureDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Sqlazure; use Joomla\Database\Sqlsrv\SqlsrvDriver; /** * SQL Azure Database Driver * * @link https://msdn.microsoft.com/en-us/library/ee336279.aspx * @since 1.0 */ class SqlazureDriver extends SqlsrvDriver { /** * The name of the database driver. * * @var string * @since 1.0 */ public $name = 'sqlazure'; } PK c�\ g.� � ! database/src/DatabaseImporter.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Joomla Framework Database Importer Class * * @since 1.0 */ abstract class DatabaseImporter { /** * An array of cached data. * * @var array * @since 1.0 */ protected $cache = ['columns' => [], 'keys' => []]; /** * The database connector to use for exporting structure and/or data. * * @var DatabaseInterface * @since 1.0 */ protected $db; /** * The input source. * * @var mixed * @since 1.0 */ protected $from = []; /** * The type of input format. * * @var string * @since 1.0 */ protected $asFormat = 'xml'; /** * An array of options for the exporter. * * @var \stdClass * @since 1.0 */ protected $options; /** * Constructor. * * Sets up the default options for the importer. * * @since 1.0 */ public function __construct() { $this->options = new \stdClass; // Set up the class defaults: // Import with only structure $this->withStructure(); // Export as XML. $this->asXml(); // Default destination is a string using $output = (string) $importer; } /** * Set the output option for the importer to XML format. * * @return $this * * @since 1.0 */ public function asXml() { $this->asFormat = 'xml'; return $this; } /** * Checks if all data and options are in order prior to importer. * * @return $this * * @since 1.0 * @throws \RuntimeException */ abstract public function check(); /** * Specifies the data source to import. * * @param \SimpleXMLElement|string $from The data source to import, either as a SimpleXMLElement object or XML string. * * @return $this * * @since 1.0 */ public function from($from) { $this->from = $from; return $this; } /** * Get the SQL syntax to add a column. * * @param string $table The table name. * @param \SimpleXMLElement $field The XML field definition. * * @return string * * @since 1.0 */ protected function getAddColumnSql($table, \SimpleXMLElement $field) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' ADD COLUMN ' . $this->getColumnSQL($field); } /** * Get alters for table if there is a difference. * * @param \SimpleXMLElement $structure The XML structure of the table. * * @return array * * @since 2.0.0 */ abstract protected function getAlterTableSql(\SimpleXMLElement $structure); /** * Get the syntax to alter a column. * * @param string $table The name of the database table to alter. * @param \SimpleXMLElement $field The XML definition for the field. * * @return string * * @since 1.0 */ protected function getChangeColumnSql($table, \SimpleXMLElement $field) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' CHANGE COLUMN ' . $this->db->quoteName((string) $field['Field']) . ' ' . $this->getColumnSQL($field); } /** * Get the SQL syntax to drop a column. * * @param string $table The table name. * @param string $name The name of the field to drop. * * @return string * * @since 1.0 */ protected function getDropColumnSql($table, $name) { return 'ALTER TABLE ' . $this->db->quoteName($table) . ' DROP COLUMN ' . $this->db->quoteName($name); } /** * Get the details list of keys for a table. * * @param array $keys An array of objects that comprise the keys for the table. * * @return array The lookup array. array({key name} => array(object, ...)) * * @since 1.0 */ protected function getKeyLookup($keys) { // First pass, create a lookup of the keys. $lookup = []; foreach ($keys as $key) { if ($key instanceof \SimpleXMLElement) { $kName = (string) $key['Key_name']; } else { $kName = $key->Key_name; } if (empty($lookup[$kName])) { $lookup[$kName] = []; } $lookup[$kName][] = $key; } return $lookup; } /** * Get the real name of the table, converting the prefix wildcard string if present. * * @param string $table The name of the table. * * @return string The real name of the table. * * @since 1.0 */ protected function getRealTableName($table) { $prefix = $this->db->getPrefix(); // Replace the magic prefix if found. $table = preg_replace('|^#__|', $prefix, $table); return $table; } /** * Import the data from the source into the existing tables. * * @return void * * @note Currently only supports XML format. * @since 2.0.0 * @throws \RuntimeException on error. */ public function importData() { if ($this->from instanceof \SimpleXMLElement) { $xml = $this->from; } else { $xml = new \SimpleXMLElement($this->from); } // Get all the table definitions. $xmlTables = $xml->xpath('database/table_data'); foreach ($xmlTables as $table) { // Convert the magic prefix into the real table name. $tableName = $this->getRealTableName((string) $table['name']); $rows = $table->children(); foreach ($rows as $row) { if ($row->getName() == 'row') { $entry = new \stdClass; foreach ($row->children() as $data) { if (isset($data['value_is_null'])) { $entry->{(string) $data['name']} = null; } else { $entry->{(string) $data['name']} = (string) $data; } } $this->db->insertObject($tableName, $entry); } } } } /** * Merges the incoming structure definition with the existing structure. * * @return void * * @note Currently only supports XML format. * @since 1.0 * @throws \RuntimeException on error. */ public function mergeStructure() { $tables = $this->db->getTableList(); if ($this->from instanceof \SimpleXMLElement) { $xml = $this->from; } else { $xml = new \SimpleXMLElement($this->from); } // Get all the table definitions. $xmlTables = $xml->xpath('database/table_structure'); foreach ($xmlTables as $table) { // Convert the magic prefix into the real table name. $tableName = $this->getRealTableName((string) $table['name']); if (\in_array($tableName, $tables, true)) { // The table already exists. Now check if there is any difference. if ($queries = $this->getAlterTableSql($table)) { // Run the queries to upgrade the data structure. foreach ($queries as $query) { $this->db->setQuery((string) $query); $this->db->execute(); } } } else { // This is a new table. $sql = $this->xmlToCreate($table); $queries = explode(';', (string) $sql); foreach ($queries as $query) { if (!empty($query)) { $this->db->setQuery((string) $query); $this->db->execute(); } } } } } /** * Sets the database connector to use for exporting structure and/or data. * * @param DatabaseInterface $db The database connector. * * @return $this * * @since 1.0 */ public function setDbo(DatabaseInterface $db) { $this->db = $db; return $this; } /** * Sets an internal option to merge the structure based on the input data. * * @param boolean $setting True to import the structure, false to not. * * @return $this * * @since 1.0 */ public function withStructure($setting = true) { $this->options->withStructure = (boolean) $setting; return $this; } /** * Get the SQL syntax to add a table. * * @param \SimpleXMLElement $table The table information. * * @return string * * @since 2.0.0 * @throws \RuntimeException */ abstract protected function xmlToCreate(\SimpleXMLElement $table); } PK c�\)���M �M database/src/Pdo/PdoDriver.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Pdo; use Joomla\Database\DatabaseDriver; use Joomla\Database\DatabaseEvents; use Joomla\Database\Event\ConnectionEvent; use Joomla\Database\Exception\ConnectionFailureException; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\Exception\PrepareStatementFailureException; use Joomla\Database\Exception\UnsupportedAdapterException; use Joomla\Database\StatementInterface; /** * Joomla Framework PDO Database Driver Class * * @link https://www.php.net/pdo * @since 1.0 */ abstract class PdoDriver extends DatabaseDriver { /** * The database connection resource. * * @var \PDO * @since 1.0 */ protected $connection; /** * The name of the database driver. * * @var string * @since 1.0 */ public $name = 'pdo'; /** * The character(s) used to quote SQL statement names such as table names or field names, etc. * * 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 = "'"; /** * The null or zero representation of a timestamp for the database driver. * * @var string * @since 1.0 */ protected $nullDate = '0000-00-00 00:00:00'; /** * Constructor. * * @param array $options List of options used to configure the connection * * @since 1.0 */ public function __construct(array $options) { // Get some basic values from the options. $options['driver'] = $options['driver'] ?? 'odbc'; $options['dsn'] = $options['dsn'] ?? ''; $options['host'] = $options['host'] ?? 'localhost'; $options['database'] = $options['database'] ?? ''; $options['user'] = $options['user'] ?? ''; $options['port'] = isset($options['port']) ? (int) $options['port'] : null; $options['password'] = $options['password'] ?? ''; $options['driverOptions'] = $options['driverOptions'] ?? []; $options['ssl'] = isset($options['ssl']) ? $options['ssl'] : []; $options['socket'] = \strpos($options['host'], 'unix:') !== false ? \str_replace('unix:', '', $options['host']) : null; if ($options['ssl'] !== []) { $options['ssl']['enable'] = isset($options['ssl']['enable']) ? $options['ssl']['enable'] : false; $options['ssl']['cipher'] = isset($options['ssl']['cipher']) ? $options['ssl']['cipher'] : null; $options['ssl']['ca'] = isset($options['ssl']['ca']) ? $options['ssl']['ca'] : null; $options['ssl']['capath'] = isset($options['ssl']['capath']) ? $options['ssl']['capath'] : null; $options['ssl']['key'] = isset($options['ssl']['key']) ? $options['ssl']['key'] : null; $options['ssl']['cert'] = isset($options['ssl']['cert']) ? $options['ssl']['cert'] : null; $options['ssl']['verify_server_cert'] = isset($options['ssl']['verify_server_cert']) ? $options['ssl']['verify_server_cert'] : null; } // Finalize initialisation parent::__construct($options); } /** * Destructor. * * @since 1.0 */ public function __destruct() { $this->disconnect(); } /** * Connects to the database if needed. * * @return void Returns void if the database connected successfully. * * @since 1.0 * @throws \RuntimeException */ public function connect() { if ($this->connection) { return; } // Make sure the PDO extension for PHP is installed and enabled. if (!static::isSupported()) { throw new UnsupportedAdapterException('PDO Extension is not available.', 1); } // Find the correct PDO DSN Format to use: switch ($this->options['driver']) { case 'cubrid': $this->options['port'] = $this->options['port'] ?? 33000; $format = 'cubrid:host=#HOST#;port=#PORT#;dbname=#DBNAME#'; $replace = ['#HOST#', '#PORT#', '#DBNAME#']; $with = [$this->options['host'], $this->options['port'], $this->options['database']]; break; case 'dblib': $this->options['port'] = $this->options['port'] ?? 1433; $format = 'dblib:host=#HOST#;port=#PORT#;dbname=#DBNAME#'; $replace = ['#HOST#', '#PORT#', '#DBNAME#']; $with = [$this->options['host'], $this->options['port'], $this->options['database']]; break; case 'firebird': $this->options['port'] = $this->options['port'] ?? 3050; $format = 'firebird:dbname=#DBNAME#'; $replace = ['#DBNAME#']; $with = [$this->options['database']]; break; case 'ibm': $this->options['port'] = $this->options['port'] ?? 56789; if (!empty($this->options['dsn'])) { $format = 'ibm:DSN=#DSN#'; $replace = ['#DSN#']; $with = [$this->options['dsn']]; } else { $format = 'ibm:hostname=#HOST#;port=#PORT#;database=#DBNAME#'; $replace = ['#HOST#', '#PORT#', '#DBNAME#']; $with = [$this->options['host'], $this->options['port'], $this->options['database']]; } break; case 'informix': $this->options['port'] = $this->options['port'] ?? 1526; $this->options['protocol'] = $this->options['protocol'] ?? 'onsoctcp'; if (!empty($this->options['dsn'])) { $format = 'informix:DSN=#DSN#'; $replace = ['#DSN#']; $with = [$this->options['dsn']]; } else { $format = 'informix:host=#HOST#;service=#PORT#;database=#DBNAME#;server=#SERVER#;protocol=#PROTOCOL#'; $replace = ['#HOST#', '#PORT#', '#DBNAME#', '#SERVER#', '#PROTOCOL#']; $with = [ $this->options['host'], $this->options['port'], $this->options['database'], $this->options['server'], $this->options['protocol'], ]; } break; case 'mssql': $this->options['port'] = $this->options['port'] ?? 1433; $format = 'mssql:host=#HOST#;port=#PORT#;dbname=#DBNAME#'; $replace = ['#HOST#', '#PORT#', '#DBNAME#']; $with = [$this->options['host'], $this->options['port'], $this->options['database']]; break; case 'mysql': $this->options['port'] = $this->options['port'] ?? 3306; if ($this->options['socket'] !== null) { $format = 'mysql:unix_socket=#SOCKET#;dbname=#DBNAME#;charset=#CHARSET#'; } else { $format = 'mysql:host=#HOST#;port=#PORT#;dbname=#DBNAME#;charset=#CHARSET#'; } $replace = ['#HOST#', '#PORT#', '#SOCKET#', '#DBNAME#', '#CHARSET#']; $with = [ $this->options['host'], $this->options['port'], $this->options['socket'], $this->options['database'], $this->options['charset'] ]; break; case 'oci': $this->options['port'] = $this->options['port'] ?? 1521; $this->options['charset'] = $this->options['charset'] ?? 'AL32UTF8'; if (!empty($this->options['dsn'])) { $format = 'oci:dbname=#DSN#'; $replace = ['#DSN#']; $with = [$this->options['dsn']]; } else { $format = 'oci:dbname=//#HOST#:#PORT#/#DBNAME#'; $replace = ['#HOST#', '#PORT#', '#DBNAME#']; $with = [$this->options['host'], $this->options['port'], $this->options['database']]; } $format .= ';charset=' . $this->options['charset']; break; case 'odbc': $format = 'odbc:DSN=#DSN#;UID:#USER#;PWD=#PASSWORD#'; $replace = ['#DSN#', '#USER#', '#PASSWORD#']; $with = [$this->options['dsn'], $this->options['user'], $this->options['password']]; break; case 'pgsql': $this->options['port'] = $this->options['port'] ?? 5432; if ($this->options['socket'] !== null) { $format = 'pgsql:host=#SOCKET#;dbname=#DBNAME#'; } else { $format = 'pgsql:host=#HOST#;port=#PORT#;dbname=#DBNAME#'; } $replace = ['#HOST#', '#PORT#', '#SOCKET#', '#DBNAME#']; $with = [$this->options['host'], $this->options['port'], $this->options['socket'], $this->options['database']]; // For data in transit TLS encryption. if ($this->options['ssl'] !== [] && $this->options['ssl']['enable'] === true) { if (isset($this->options['ssl']['verify_server_cert']) && $this->options['ssl']['verify_server_cert'] === true) { $format .= ';sslmode=verify-full'; } else { $format .= ';sslmode=require'; } $sslKeysMapping = [ 'cipher' => null, 'ca' => 'sslrootcert', 'capath' => null, 'key' => 'sslkey', 'cert' => 'sslcert', ]; // If customised, add cipher suite, ca file path, ca path, private key file path and certificate file path to PDO driver options. foreach ($sslKeysMapping as $key => $value) { if ($value !== null && $this->options['ssl'][$key] !== null) { $format .= ';' . $value . '=' . $this->options['ssl'][$key]; } } } break; case 'sqlite': if (isset($this->options['version']) && $this->options['version'] == 2) { $format = 'sqlite2:#DBNAME#'; } else { $format = 'sqlite:#DBNAME#'; } $replace = ['#DBNAME#']; $with = [$this->options['database']]; break; case 'sybase': $this->options['port'] = $this->options['port'] ?? 1433; $format = 'mssql:host=#HOST#;port=#PORT#;dbname=#DBNAME#'; $replace = ['#HOST#', '#PORT#', '#DBNAME#']; $with = [$this->options['host'], $this->options['port'], $this->options['database']]; break; default: throw new UnsupportedAdapterException('The ' . $this->options['driver'] . ' driver is not supported.'); } // Create the connection string: $connectionString = str_replace($replace, $with, $format); try { $this->connection = new \PDO( $connectionString, $this->options['user'], $this->options['password'], $this->options['driverOptions'] ); } catch (\PDOException $e) { throw new ConnectionFailureException('Could not connect to PDO: ' . $e->getMessage(), $e->getCode(), $e); } $this->setOption(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION); $this->dispatchEvent(new ConnectionEvent(DatabaseEvents::POST_CONNECT, $this)); } /** * Method to escape a string for usage in an SQL statement. * * Oracle escaping reference: * http://www.orafaq.com/wiki/SQL_FAQ#How_does_one_escape_special_characters_when_writing_SQL_queries.3F * * SQLite escaping notes: * http://www.sqlite.org/faq.html#q14 * * Method body is as implemented by the Zend Framework * * 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)) { return $text; } if (\is_float($text)) { // Force the dot as a decimal point. return str_replace(',', '.', (string) $text); } $text = str_replace("'", "''", (string) $text); return addcslashes($text, "\000\n\r\\\032"); } /** * Execute the SQL statement. * * @return boolean * * @since 1.0 * @throws \Exception * @throws \RuntimeException */ public function execute() { $this->connect(); // Take a local copy so that we don't modify the original query and cause issues later $sql = $this->replacePrefix((string) $this->sql); // Increment the query counter. $this->count++; // Get list of bounded parameters $bounded =& $this->sql->getBounded(); // If there is a monitor registered, let it know we are starting this query if ($this->monitor) { $this->monitor->startQuery($sql, $bounded); } // Execute the query. $this->executed = false; // Bind the variables foreach ($bounded as $key => $obj) { $this->statement->bindParam($key, $obj->value, $obj->dataType, $obj->length, $obj->driverOptions); } try { $this->executed = $this->statement->execute(); // If there is a monitor registered, let it know we have finished this query if ($this->monitor) { $this->monitor->stopQuery(); } return true; } catch (\PDOException $exception) { // If there is a monitor registered, let it know we have finished this query if ($this->monitor) { $this->monitor->stopQuery(); } // Get the error number and message before we execute any more queries. $errorNum = (int) $this->statement->errorCode(); $errorMsg = (string) implode(', ', $this->statement->errorInfo()); // Check if the server was disconnected. try { if (!$this->connected()) { try { // Attempt to reconnect. $this->connection = null; $this->connect(); } catch (ConnectionFailureException $e) { // If connect fails, ignore that exception and throw the normal exception. throw new ExecutionFailureException($sql, $errorMsg, $errorNum); } // Since we were able to reconnect, run the query again. return $this->execute(); } } catch (\LogicException $e) { throw new ExecutionFailureException($sql, $errorMsg, $errorNum, $e); } // Throw the normal query exception. throw new ExecutionFailureException($sql, $errorMsg, $errorNum); } } /** * Retrieve a PDO database connection attribute * https://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->connect(); return $this->connection->getAttribute($key); } /** * Get the version of the database connector. * * @return string The database connector version. * * @since 1.5.0 */ public function getVersion() { $this->connect(); return $this->getOption(\PDO::ATTR_SERVER_VERSION); } /** * Get a query to run and verify the database is operational. * * @return string The query to check the health of the DB. * * @since 1.0 */ public function getConnectedQuery() { return 'SELECT 1'; } /** * Sets an attribute on the PDO database handle. * https://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->connect(); return $this->connection->setAttribute($key, $value); } /** * Test to see if the PDO extension is available. * Override as needed to check for specific PDO Drivers. * * @return boolean True on success, false otherwise. * * @since 1.0 */ public static function isSupported() { return \defined('\\PDO::ATTR_DRIVER_NAME'); } /** * Determines if the connection to the server is active. * * @return boolean True if connected to the database engine. * * @since 1.0 * @throws \LogicException */ public function connected() { // Flag to prevent recursion into this function. static $checkingConnected = false; if ($checkingConnected) { // Reset this flag and throw an exception. $checkingConnected = false; throw new \LogicException('Recursion trying to check if connected.'); } // Backup the query state. $sql = $this->sql; $limit = $this->limit; $offset = $this->offset; $statement = $this->statement; try { // Set the checking connection flag. $checkingConnected = true; // Run a simple query to check the connection. $this->setQuery($this->getConnectedQuery()); $status = (bool) $this->loadResult(); } catch (\Exception $e) { // If we catch an exception here, we must not be connected. $status = false; } // Restore the query state. $this->sql = $sql; $this->limit = $limit; $this->offset = $offset; $this->statement = $statement; $checkingConnected = false; return $status; } /** * Method to get the auto-incremented value from the last INSERT statement. * * @return string The value of the auto-increment field from the last inserted row. * * @since 1.0 */ public function insertid() { $this->connect(); // Error suppress this to prevent PDO warning us that the driver doesn't support this operation. return @$this->connection->lastInsertId(); } /** * 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. * * @since 1.0 * @throws \RuntimeException */ public function select($database) { $this->connect(); return true; } /** * Set the connection to use UTF-8 character encoding. * * @return boolean True on success. * * @since 1.0 */ public function setUtf() { return false; } /** * Method to commit a transaction. * * @param boolean $toSavepoint If true, commit to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionCommit($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth === 1) { $this->connection->commit(); } $this->transactionDepth--; } /** * Method to roll back a transaction. * * @param boolean $toSavepoint If true, rollback to the last savepoint. * * @return void * * @since 1.0 * @throws \RuntimeException */ public function transactionRollback($toSavepoint = false) { $this->connect(); if (!$toSavepoint || $this->transactionDepth === 1) { $this->connection->rollBack(); } $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 * * @since 1.0 * @throws \RuntimeException */ public function transactionStart($asSavepoint = false) { $this->connect(); if (!$asSavepoint || !$this->transactionDepth) { $this->connection->beginTransaction(); } $this->transactionDepth++; } /** * Prepares a SQL statement for execution * * @param string $query The SQL query to be prepared. * * @return StatementInterface * * @since 2.0.0 * @throws PrepareStatementFailureException */ protected function prepareStatement(string $query): StatementInterface { try { return new PdoStatement($this->connection->prepare($query, $this->options['driverOptions'])); } catch (\PDOException $exception) { throw new PrepareStatementFailureException($exception->getMessage(), $exception->getCode(), $exception); } } /** * PDO does not support serialize * * @return array * * @since 1.0 */ 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)) { $serializedProperties[] = $property->name; } } return $serializedProperties; } /** * Wake up after serialization * * @return void * * @since 1.0 */ public function __wakeup() { // Get connection back $this->__construct($this->options); } } PK c�\M��m� � ! database/src/Pdo/PdoStatement.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Pdo; use Joomla\Database\FetchMode; use Joomla\Database\FetchOrientation; use Joomla\Database\ParameterType; use Joomla\Database\StatementInterface; /** * PDO Database Statement. * * @since 2.0.0 */ class PdoStatement implements StatementInterface { /** * Mapping array for fetch modes. * * @var array * @since 2.0.0 */ private const FETCH_MODE_MAP = [ FetchMode::ASSOCIATIVE => \PDO::FETCH_ASSOC, FetchMode::NUMERIC => \PDO::FETCH_NUM, FetchMode::MIXED => \PDO::FETCH_BOTH, FetchMode::STANDARD_OBJECT => \PDO::FETCH_OBJ, FetchMode::COLUMN => \PDO::FETCH_COLUMN, FetchMode::CUSTOM_OBJECT => \PDO::FETCH_CLASS, ]; /** * Mapping array for parameter types. * * @var array * @since 2.0.0 */ private const PARAMETER_TYPE_MAP = [ ParameterType::BOOLEAN => \PDO::PARAM_BOOL, ParameterType::INTEGER => \PDO::PARAM_INT, ParameterType::LARGE_OBJECT => \PDO::PARAM_LOB, ParameterType::NULL => \PDO::PARAM_NULL, ParameterType::STRING => \PDO::PARAM_STR, ]; /** * The decorated PDOStatement object. * * @var \PDOStatement * @since 2.0.0 */ protected $pdoStatement; /** * Statement constructor * * @param \PDOStatement $pdoStatement The decorated PDOStatement object. * * @since 2.0.0 */ public function __construct(\PDOStatement $pdoStatement) { $this->pdoStatement = $pdoStatement; } /** * Binds a parameter to the specified variable name. * * @param string|integer $parameter Parameter identifier. For a prepared statement using named placeholders, this will be a parameter * name of the form `:name`. For a prepared statement using question mark placeholders, this will be * the 1-indexed position of the parameter. * @param mixed $variable Name of the PHP variable to bind to the SQL statement parameter. * @param string $dataType Constant corresponding to a SQL datatype, this should be the processed type from the QueryInterface. * @param integer $length The length of the variable. Usually required for OUTPUT parameters. * @param array $driverOptions Optional driver options to be used. * * @return boolean * * @since 2.0.0 */ public function bindParam($parameter, &$variable, string $dataType = ParameterType::STRING, ?int $length = null, ?array $driverOptions = null) { $type = $this->convertParameterType($dataType); $extraParameters = array_slice(func_get_args(), 3); if (count($extraParameters) !== 0) { $extraParameters[0] = $extraParameters[0] ?? 0; } $this->pdoStatement->bindParam($parameter, $variable, $type, ...$extraParameters); return true; } /** * Closes the cursor, enabling the statement to be executed again. * * @return void * * @since 2.0.0 */ public function closeCursor(): void { $this->pdoStatement->closeCursor(); } /** * Fetches the SQLSTATE associated with the last operation on the statement handle. * * @return string * * @since 2.0.0 */ public function errorCode() { return $this->pdoStatement->errorCode(); } /** * Fetches extended error information associated with the last operation on the statement handle. * * @return array * * @since 2.0.0 */ public function errorInfo() { return $this->pdoStatement->errorInfo(); } /** * Executes a prepared statement * * @param array|null $parameters An array of values with as many elements as there are bound parameters in the SQL statement being executed. * * @return boolean * * @since 2.0.0 */ public function execute(?array $parameters = null) { return $this->pdoStatement->execute($parameters); } /** * Fetches the next row from a result set * * @param integer|null $fetchStyle Controls how the next row will be returned to the caller. This value must be one of the * FetchMode constants, defaulting to value of FetchMode::MIXED. * @param integer $cursorOrientation For a StatementInterface object representing a scrollable cursor, this value determines which row * will be returned to the caller. This value must be one of the FetchOrientation constants, * defaulting to FetchOrientation::NEXT. * @param integer $cursorOffset For a StatementInterface object representing a scrollable cursor for which the cursorOrientation * parameter is set to FetchOrientation::ABS, this value specifies the absolute number of the row in * the result set that shall be fetched. For a StatementInterface object representing a scrollable * cursor for which the cursorOrientation parameter is set to FetchOrientation::REL, this value * specifies the row to fetch relative to the cursor position before `fetch()` was called. * * @return mixed The return value of this function on success depends on the fetch type. In all cases, boolean false is returned on failure. * * @since 2.0.0 */ public function fetch(?int $fetchStyle = null, int $cursorOrientation = FetchOrientation::NEXT, int $cursorOffset = 0) { if ($fetchStyle === null) { return $this->pdoStatement->fetch(); } return $this->pdoStatement->fetch($this->convertFetchMode($fetchStyle), $cursorOrientation, $cursorOffset); } /** * Returns the number of rows affected by the last SQL statement. * * @return integer * * @since 2.0.0 */ public function rowCount(): int { return $this->pdoStatement->rowCount(); } /** * Sets the fetch mode to use while iterating this statement. * * @param integer $fetchMode The fetch mode, must be one of the FetchMode constants. * @param mixed ...$args Optional mode-specific arguments. * * @return void * * @since 2.0.0 */ public function setFetchMode(int $fetchMode, ...$args): void { $this->pdoStatement->setFetchMode($this->convertFetchMode($fetchMode), ...$args); } /** * Converts the database API's fetch mode to a PDO fetch mode * * @param integer $mode Fetch mode to convert * * @return integer * * @since 2.0.0 * @throws \InvalidArgumentException if the fetch mode is unsupported */ private function convertFetchMode(int $mode): int { if (!isset(self::FETCH_MODE_MAP[$mode])) { throw new \InvalidArgumentException(sprintf('Unsupported fetch mode `%s`', $mode)); } return self::FETCH_MODE_MAP[$mode]; } /** * Converts the database API's parameter type to a PDO parameter type * * @param string $type Parameter type to convert * * @return integer * * @since 2.0.0 * @throws \InvalidArgumentException if the parameter type is unsupported */ private function convertParameterType(string $type): int { if (!isset(self::PARAMETER_TYPE_MAP[$type])) { throw new \InvalidArgumentException(sprintf('Unsupported parameter type `%s`', $type)); } return self::PARAMETER_TYPE_MAP[$type]; } } PK c�\I�{ { database/src/Pdo/PdoQuery.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Pdo; use Joomla\Database\DatabaseQuery; /** * PDO Query Building Class. * * @since 1.0 */ abstract class PdoQuery extends DatabaseQuery { /** * The list of zero or null representation of a datetime. * * @var array * @since 2.0.0 */ protected $nullDatetimeList = ['0000-00-00 00:00:00']; /** * Casts a value to a char. * * Ensure that the value is properly quoted before passing to the method. * * Usage: * $query->select($query->castAsChar('a')); * $query->select($query->castAsChar('a', 40)); * * @param string $value The value to cast as a char. * @param string $len The length of the char. * * @return string Returns the cast value. * * @since 1.8.0 */ public function castAsChar($value, $len = null) { if (!$len) { return $value; } else { return 'CAST(' . $value . ' AS CHAR(' . $len . '))'; } } } PK c�\ t� database/src/DatabaseFactory.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; /** * Joomla Framework Database Factory class * * @since 1.0 */ class DatabaseFactory { /** * Method to return a database driver based on the given options. * * There are three global options and then the rest are specific to the database driver. The 'database' option determines which database is to * be used for the connection. The 'select' option determines whether the connector should automatically select the chosen database. * * @param string $name Name of the database driver you'd like to instantiate * @param array $options Parameters to be passed to the database driver. * * @return DatabaseInterface * * @since 1.0 * @throws Exception\UnsupportedAdapterException if there is not a compatible database driver */ public function getDriver(string $name = 'mysqli', array $options = []): DatabaseInterface { // Sanitize the database connector options. $options['driver'] = preg_replace('/[^A-Z0-9_\.-]/i', '', $name); $options['database'] = $options['database'] ?? null; $options['select'] = $options['select'] ?? true; $options['factory'] = $options['factory'] ?? $this; // Derive the class name from the driver. $class = __NAMESPACE__ . '\\' . ucfirst(strtolower($options['driver'])) . '\\' . ucfirst(strtolower($options['driver'])) . 'Driver'; // If the class still doesn't exist we have nothing left to do but throw an exception. We did our best. if (!class_exists($class)) { throw new Exception\UnsupportedAdapterException(sprintf('Unable to load Database Driver: %s', $options['driver'])); } return new $class($options); } /** * Gets an exporter class object. * * @param string $name Name of the driver you want an exporter for. * @param DatabaseInterface|null $db Optional database driver to inject into the query object. * * @return DatabaseExporter * * @since 1.0 * @throws Exception\UnsupportedAdapterException if there is not a compatible database exporter */ public function getExporter(string $name, ?DatabaseInterface $db = null): DatabaseExporter { // Derive the class name from the driver. $class = __NAMESPACE__ . '\\' . ucfirst(strtolower($name)) . '\\' . ucfirst(strtolower($name)) . 'Exporter'; // Make sure we have an exporter class for this driver. if (!class_exists($class)) { // If it doesn't exist we are at an impasse so throw an exception. throw new Exception\UnsupportedAdapterException('Database Exporter not found.'); } /** @var $o DatabaseExporter */ $o = new $class; if ($db) { $o->setDbo($db); } return $o; } /** * Gets an importer class object. * * @param string $name Name of the driver you want an importer for. * @param DatabaseInterface|null $db Optional database driver to inject into the query object. * * @return DatabaseImporter * * @since 1.0 * @throws Exception\UnsupportedAdapterException if there is not a compatible database importer */ public function getImporter(string $name, ?DatabaseInterface $db = null): DatabaseImporter { // Derive the class name from the driver. $class = __NAMESPACE__ . '\\' . ucfirst(strtolower($name)) . '\\' . ucfirst(strtolower($name)) . 'Importer'; // Make sure we have an importer class for this driver. if (!class_exists($class)) { // If it doesn't exist we are at an impasse so throw an exception. throw new Exception\UnsupportedAdapterException('Database importer not found.'); } /** @var $o DatabaseImporter */ $o = new $class; if ($db) { $o->setDbo($db); } return $o; } /** * Get a new iterator on the current query. * * @param string $name Name of the driver you want an iterator for. * @param StatementInterface $statement Statement holding the result set to be iterated. * @param string|null $column An optional column to use as the iterator key. * @param string $class The class of object that is returned. * * @return DatabaseIterator * * @since 2.0.0 */ public function getIterator( string $name, StatementInterface $statement, ?string $column = null, string $class = \stdClass::class ): DatabaseIterator { // Derive the class name from the driver. $iteratorClass = __NAMESPACE__ . '\\' . ucfirst($name) . '\\' . ucfirst($name) . 'Iterator'; // Make sure we have an iterator class for this driver. if (!class_exists($iteratorClass)) { // We can work with the base iterator class so use that $iteratorClass = DatabaseIterator::class; } // Return a new iterator return new $iteratorClass($statement, $column, $class); } /** * Get the current query object or a new Query object. * * @param string $name Name of the driver you want an query object for. * @param DatabaseInterface|null $db Optional database driver to inject into the query object. * * @return QueryInterface * * @since 1.0 * @throws Exception\UnsupportedAdapterException if there is not a compatible database query object */ public function getQuery(string $name, ?DatabaseInterface $db = null): QueryInterface { // Derive the class name from the driver. $class = __NAMESPACE__ . '\\' . ucfirst(strtolower($name)) . '\\' . ucfirst(strtolower($name)) . 'Query'; // Make sure we have a query class for this driver. if (!class_exists($class)) { // If it doesn't exist we are at an impasse so throw an exception. throw new Exception\UnsupportedAdapterException('Database Query class not found'); } return new $class($db); } } PK c�\�{��K �K database/src/QueryInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database; use Joomla\Database\Exception\QueryTypeAlreadyDefinedException; use Joomla\Database\Query\LimitableInterface; use Joomla\Database\Query\PreparableInterface; use Joomla\Database\Exception\UnknownTypeException; /** * Joomla Framework Query Building Interface. * * @since 2.0.0 */ interface QueryInterface extends PreparableInterface, LimitableInterface { /** * Convert the query object to a string. * * @return string * * @since 2.0.0 */ public function __toString(); /** * Add a single column, or array of columns to the CALL clause of the query. * * Usage: * $query->call('a.*')->call('b.id'); * $query->call(array('a.*', 'b.id')); * * @param array|string $columns A string or an array of field names. * * @return $this * * @since 2.0.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function call($columns); /** * Casts a value to a specified type. * * Ensure that the value is properly quoted before passing to the method. * * Usage: * $query->select($query->castAs('CHAR', 'a')); * * @param string $type The type of string to cast as. * @param string $value The value to cast as a char. * @param string $length Optionally specify the length of the field (if the type supports it otherwise * ignored). * * @return string SQL statement to cast the value as a char type. * * @since 2.0.0 * @throws UnknownTypeException When unsupported cast for a database driver */ public function castAs(string $type, string $value, ?string $length = null); /** * 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|null $operator Comparison operator between charLength integer value and $condition * @param string|null $condition Integer value to compare charLength with. * * @return string SQL statement to get the length of a character. * * @since 2.0.0 */ public function charLength($field, $operator = null, $condition = null); /** * 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 $this * * @since 2.0.0 */ public function clear($clause = null); /** * Adds a column, or array of column names that would be used for an INSERT INTO statement. * * @param array|string $columns A column name, or array of column names. * * @return $this * * @since 2.0.0 */ public function columns($columns); /** * Concatenates an array of column names or values. * * Usage: * $query->select($query->concatenate(array('a', 'b'))); * * @param string[] $values An array of values to concatenate. * @param string|null $separator As separator to place between each value. * * @return string SQL statement representing the concatenated values. * * @since 2.0.0 */ public function concatenate($values, $separator = null); /** * Gets the current date and time. * * Usage: * $query->where('published_up < '.$query->currentTimestamp()); * * @return string SQL statement to get the current timestamp. * * @since 2.0.0 */ public function currentTimestamp(); /** * Add a table name to the DELETE clause of the query. * * Usage: * $query->delete('#__a')->where('id = 1'); * * @param string $table The name of the table to delete from. * * @return $this * * @since 2.0.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function delete($table = null); /** * Add a single column, or array of columns to the EXEC clause of the query. * * Usage: * $query->exec('a.*')->exec('b.id'); * $query->exec(array('a.*', 'b.id')); * * @param array|string $columns A string or an array of field names. * * @return $this * * @since 2.0.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function exec($columns); /** * Find a value in a varchar used like a set. * * Ensure that the value is an integer before passing to the method. * * Usage: * $query->findInSet((int) $parent->id, 'a.assigned_cat_ids') * * @param string $value The value to search for. * @param string $set The set of values. * * @return string A representation of the MySQL find_in_set() function for the driver. * * @since 2.0.0 */ public function findInSet($value, $set); /** * Add a table to the FROM clause of the query. * * Usage: * $query->select('*')->from('#__a'); * $query->select('*')->from($subquery->alias('a')); * * @param string|QueryInterface $table The name of the table or a QueryInterface object (or a child of it) with alias set. * * @return $this * * @since 2.0.0 */ public function from($table); /** * Add alias for current query. * * Usage: * $query->select('*')->from('#__a')->alias('subquery'); * * @param string $alias Alias used for a JDatabaseQuery. * * @return $this * * @since 2.0.0 */ public function alias($alias); /** * 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 SQL statement to get the year from a date value. * * @since 2.0.0 */ public function 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 SQL statement to get the month from a date value. * * @since 2.0.0 */ public function 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 SQL statement to get the day from a date value. * * @since 2.0.0 */ public function 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 SQL statement to get the hour from a date/time value. * * @since 2.0.0 */ public function 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 SQL statement to get the minute from a date/time value. * * @since 2.0.0 */ public function 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 SQL statement to get the second from a date/time value. * * @since 2.0.0 */ public function second($date); /** * Add a grouping column to the GROUP clause of the query. * * Usage: * $query->group('id'); * * @param array|string $columns A string or array of ordering columns. * * @return $this * * @since 2.0.0 */ public function group($columns); /** * Aggregate function to get input values concatenated into a string, separated by delimiter * * Usage: * $query->groupConcat('id', ','); * * @param string $expression The expression to apply concatenation to, this may be a column name or complex SQL statement. * @param string $separator The delimiter of each concatenated value * * @return string Input values concatenated into a string, separated by delimiter * * @since 2.0.0 */ public function groupConcat($expression, $separator = ','); /** * A conditions to the HAVING clause of the query. * * Usage: * $query->group('id')->having('COUNT(id) > 5'); * * @param array|string $conditions A string or array of columns. * @param string $glue The glue by which to join the conditions. Defaults to AND. * * @return $this * * @since 2.0.0 */ public function having($conditions, $glue = 'AND'); /** * Add a table name to the INSERT clause of the 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 string $table The name of the table to insert data into. * @param boolean $incrementField The name of the field to auto increment. * * @return $this * * @since 2.0.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function insert($table, $incrementField = false); /** * Add a JOIN clause to the query. * * Usage: * $query->join('INNER', 'b', 'b.id = a.id); * * @param string $type The type of join. This string is prepended to the JOIN keyword. * @param string $table The name of table. * @param string $condition The join condition. * * @return $this * * @since 2.0.0 */ public function join($type, $table, $condition = null); /** * 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 integer * * @since 2.0.0 */ public function 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. * * @since 2.0.0 * @throws \RuntimeException */ public function nullDate($quoted = true); /** * Generate a SQL statement to check if column represents a zero or null datetime. * * Usage: * $query->where($query->isNullDatetime('modified_date')); * * @param string $column A column name. * * @return string * * @since 2.0.0 */ public function isNullDatetime($column); /** * Add an ordering column to the ORDER clause of the query. * * Usage: * $query->order('foo')->order('bar'); * $query->order(array('foo','bar')); * * @param array|string $columns A string or array of ordering columns. * * @return $this * * @since 2.0.0 */ public function order($columns); /** * Get the function to return a random floating-point value * * Usage: * $query->rand(); * * @return string * * @since 2.0.0 */ public function rand(); /** * Get the regular expression operator * * Usage: * $query->where('field ' . $query->regexp($search)); * * @param string $value The regex pattern. * * @return string * * @since 2.0.0 */ public function regexp($value); /** * Add a single column, or array of columns to the SELECT clause of the query. * * Usage: * $query->select('a.*')->select('b.id'); * $query->select(array('a.*', 'b.id')); * * @param array|string $columns A string or an array of field names. * * @return $this * * @since 2.0.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function select($columns); /** * Return the number of the current row. * * Usage: * $query->select('id'); * $query->selectRowNumber('ordering,publish_up DESC', 'new_ordering'); * $query->from('#__content'); * * @param string $orderBy An expression of ordering for window function. * @param string $orderColumnAlias An alias for new ordering column. * * @return $this * * @since 2.0.0 * @throws \RuntimeException */ public function selectRowNumber($orderBy, $orderColumnAlias); /** * 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 array|string $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 $this * * @since 2.0.0 */ public function set($conditions, $glue = ','); /** * Add a table name to the UPDATE clause of the query. * * Usage: * $query->update('#__foo')->set(...); * * @param string $table A table to update. * * @return $this * * @since 2.0.0 * @throws QueryTypeAlreadyDefinedException if the query type has already been defined */ public function update($table); /** * 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 array|string $values A single tuple, or array of tuples. * * @return $this * * @since 2.0.0 */ public function values($values); /** * 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 array|string $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 $this * * @since 2.0.0 */ public function where($conditions, $glue = 'AND'); /** * Add a WHERE IN statement to the query. * * Note that all values must be the same data type. * * Usage * $query->whereIn('id', [1, 2, 3]); * * @param string $keyName Key name for the where clause * @param array $keyValues Array of values to be matched * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $keyValues * * @return $this * * @since 2.0.0 */ public function whereIn(string $keyName, array $keyValues, $dataType = ParameterType::INTEGER); /** * Add a WHERE NOT IN statement to the query. * * Note that all values must be the same data type. * * Usage * $query->whereNotIn('id', [1, 2, 3]); * * @param string $keyName Key name for the where clause * @param array $keyValues Array of values to be matched * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $keyValues * * @return $this * * @since 2.0.0 */ public function whereNotIn(string $keyName, array $keyValues, $dataType = ParameterType::INTEGER); /** * Extend the WHERE clause with a single condition or an array of conditions, with a potentially different logical operator from the one in the * current WHERE clause. * * Usage: * $query->where(array('a = 1', 'b = 2'))->extendWhere('XOR', array('c = 3', 'd = 4')); * will produce: WHERE ((a = 1 AND b = 2) XOR (c = 3 AND d = 4) * * @param string $outerGlue The glue by which to join the conditions to the current WHERE conditions. * @param mixed $conditions A string or array of WHERE conditions. * @param string $innerGlue The glue by which to join the conditions. Defaults to AND. * * @return $this * * @since 2.0.0 */ public function extendWhere($outerGlue, $conditions, $innerGlue = 'AND'); /** * Binds an array of values and returns an array of prepared parameter names. * * Note that all values must be the same data type. * * Usage: * $query->whereIn('column in (' . implode(',', $query->bindArray($keyValues, $dataType)) . ')'); * * @param array $values Values to bind * @param array|string $dataType Constant corresponding to a SQL datatype. It can be an array, in this case it * has to be same length of $key * * @return array An array with parameter names * * @since 2.0.0 */ public function bindArray(array $values, $dataType = ParameterType::INTEGER); /** * Add a query to UNION with the current query. * * Usage: * $query->union('SELECT name FROM #__foo') * $query->union('SELECT name FROM #__foo', true) * * @param DatabaseQuery|string $query The DatabaseQuery object or string to union. * @param boolean $distinct True to only return distinct rows from the union. * * @return $this * * @since 1.0 */ public function union($query, $distinct = true); /** * Add a query to UNION ALL with the current query. * * Usage: * $query->unionAll('SELECT name FROM #__foo') * * @param DatabaseQuery|string $query The DatabaseQuery object or string to union. * * @return $this * * @see union * @since 1.5.0 */ public function unionAll($query); /** * Set a single query to the query set. * On this type of DatabaseQuery you can use union(), unionAll(), order() and setLimit() * * Usage: * $query->querySet($query2->select('name')->from('#__foo')->order('id DESC')->setLimit(1)) * ->unionAll($query3->select('name')->from('#__foo')->order('id')->setLimit(1)) * ->order('name') * ->setLimit(1) * * @param DatabaseQuery|string $query The DatabaseQuery object or string. * * @return $this * * @since 2.0.0 */ public function querySet($query); /** * Create a DatabaseQuery object of type querySet from current query. * * Usage: * $query->select('name')->from('#__foo')->order('id DESC')->setLimit(1) * ->toQuerySet() * ->unionAll($query2->select('name')->from('#__foo')->order('id')->setLimit(1)) * ->order('name') * ->setLimit(1) * * @return DatabaseQuery A new object of the DatabaseQuery. * * @since 2.0.0 */ public function toQuerySet(); } PK c�\h %� � ; database/src/Exception/QueryTypeAlreadyDefinedException.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Exception; /** * Exception class defining an exception when attempting to change a query type * * @since 2.0.0 */ class QueryTypeAlreadyDefinedException extends \RuntimeException { } PK c�\�s�N� � ; database/src/Exception/PrepareStatementFailureException.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Exception; /** * Exception class defining an error preparing the SQL statement for execution * * @since 2.0.0 */ class PrepareStatementFailureException extends \RuntimeException { /** * Construct the exception * * @param string $message The Exception message to throw. [optional] * @param integer $code The Exception code. [optional] * @param Exception $previous The previous exception used for the exception chaining. [optional] * * @since 2.0.0 */ public function __construct($message = '', $code = 0, \Exception $previous = null) { // PDO uses strings for exception codes, PHP forces numeric codes, so "force" the string code to be used parent::__construct($message, 0, $previous); $this->code = $code; } } PK c�\.m{ { 4 database/src/Exception/DatabaseNotFoundException.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Exception; /** * No database is available. * * @since 2.1.0 */ class DatabaseNotFoundException extends \RuntimeException { } PK c�\�Q.xZ Z 4 database/src/Exception/ExecutionFailureException.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Exception; /** * Exception class defining an error executing a statement * * @since 1.5.0 */ class ExecutionFailureException extends \RuntimeException { /** * The SQL statement that was executed. * * @var string * @since 1.5.0 */ private $query; /** * Construct the exception * * @param string $query The SQL statement that was executed. * @param string $message The Exception message to throw. [optional] * @param integer $code The Exception code. [optional] * @param Exception $previous The previous exception used for the exception chaining. [optional] * * @since 1.5.0 */ public function __construct($query, $message = '', $code = 0, \Exception $previous = null) { // PDO uses strings for exception codes, PHP forces numeric codes, so "force" the string code to be used parent::__construct($message, 0, $previous); $this->code = $code; $this->query = $query; } /** * Get the SQL statement that was executed * * @return string * * @since 1.5.0 */ public function getQuery() { return $this->query; } } PK c�\Sw�W� � 5 database/src/Exception/ConnectionFailureException.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Exception; /** * Exception class defining an error connecting to the database platform * * @since 1.5.0 */ class ConnectionFailureException extends \RuntimeException { /** * Construct the exception * * @param string $message The Exception message to throw. [optional] * @param integer $code The Exception code. [optional] * @param Exception $previous The previous exception used for the exception chaining. [optional] * * @since 2.0.0 */ public function __construct($message = '', $code = 0, \Exception $previous = null) { // PDO uses strings for exception codes, PHP forces numeric codes, so "force" the string code to be used parent::__construct($message, 0, $previous); $this->code = $code; } } PK c�\w� �� � 6 database/src/Exception/UnsupportedAdapterException.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Exception; /** * Exception class defining an unsupported database object * * @since 1.5.0 */ class UnsupportedAdapterException extends \RuntimeException { } PK c�\�uzѫ � / database/src/Exception/UnknownTypeException.phpnu �[��� <?php /** * Part of the Joomla Framework Database Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Database\Exception; /** * Class representing an unknown type for a given database driver. * * @since 2.0.0 */ class UnknownTypeException extends \InvalidArgumentException { } PK c�\V�+�~ ~ database/phpunit.sqlite.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="sqlite" /> <env name="JOOMLA_TEST_DB_HOST" value="" /> <env name="JOOMLA_TEST_DB_PORT" value="" /> <env name="JOOMLA_TEST_DB_USER" value="" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="" /> <env name="JOOMLA_TEST_DB_DATABASE" value=":memory:" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests/Sqlite</directory> </testsuite> </testsuites> </phpunit> PK c�\QS`i�7 �7 database/.drone.ymlnu &1i� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlite" }, "kind": "pipeline", "name": "PHP 7.2 with SQLite (sqlite)", "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri sqlite || true", "vendor/bin/phpunit --configuration phpunit.sqlite.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlite" }, "kind": "pipeline", "name": "PHP 7.3 with SQLite (sqlite)", "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri sqlite || true", "vendor/bin/phpunit --configuration phpunit.sqlite.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlite" }, "kind": "pipeline", "name": "PHP 7.4 with SQLite (sqlite)", "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri sqlite || true", "vendor/bin/phpunit --configuration phpunit.sqlite.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlite" }, "kind": "pipeline", "name": "PHP 8.0 with SQLite (sqlite)", "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri sqlite || true", "vendor/bin/phpunit --configuration phpunit.sqlite.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlite" }, "kind": "pipeline", "name": "PHP 8.1 with SQLite (sqlite)", "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri sqlite || true", "vendor/bin/phpunit --configuration phpunit.sqlite.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlite" }, "kind": "pipeline", "name": "PHP 8.2 with SQLite (sqlite)", "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri sqlite || true", "vendor/bin/phpunit --configuration phpunit.sqlite.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 7.2 with MySQL 5.7 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 7.3 with MySQL 5.7 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 7.4 with MySQL 5.7 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 8.0 with MySQL 5.7 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 8.1 with MySQL 5.7 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 8.2 with MySQL 5.7 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 7.3 with MySQL 8.0 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 7.4 with MySQL 8.0 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 8.0 with MySQL 8.0 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 8.1 with MySQL 8.0 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysql" }, "kind": "pipeline", "name": "PHP 8.2 with MySQL 8.0 (mysql)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysql", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysql || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysql.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 7.2 with MySQL 5.7 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 7.3 with MySQL 5.7 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 7.4 with MySQL 5.7 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 8.0 with MySQL 5.7 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 8.1 with MySQL 5.7 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 8.2 with MySQL 5.7 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:5.7", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 7.3 with MySQL 8.0 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 7.4 with MySQL 8.0 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 8.0 with MySQL 8.0 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 8.1 with MySQL 8.0 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mysqli" }, "kind": "pipeline", "name": "PHP 8.2 with MySQL 8.0 (mysqli)", "services": [ { "environment": { "ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_AUTHENTICATION_PLUGIN": "mysql_native_password", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "bitnami/mysql:8.0", "name": "mysqli", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mysqli || true", "sleep 20", "vendor/bin/phpunit --configuration phpunit.mysqli.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 7.2 with MariaDB 10.2 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.2", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 7.3 with MariaDB 10.2 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.2", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 7.4 with MariaDB 10.0 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.0", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 7.4 with MariaDB 10.1 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.1", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 7.4 with MariaDB 10.2 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.2", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 8.0 with MariaDB 10.2 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.2", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 8.1 with MariaDB 10.2 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.2", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "mariadb" }, "kind": "pipeline", "name": "PHP 8.2 with MariaDB 10.2 (mariadb)", "services": [ { "environment": { "MARIADB_ALLOW_EMPTY_ROOT_PASSWORD": "yes", "MARIADB_DATABASE": "joomla_ut", "MARIADB_ROOT_PASSWORD": "", "MYSQL_ALLOW_EMPTY_PASSWORD": "yes", "MYSQL_DATABASE": "joomla_ut", "MYSQL_ROOT_PASSWORD": "" }, "image": "mariadb:10.2", "name": "mariadb", "ports": [ { "container": 3306, "host": 3306 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri mariadb || true", "vendor/bin/phpunit --configuration phpunit.mariadb.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 7.2 with PostgreSQL 9.4 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:9.4", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 7.2 with PostgreSQL 9.5 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:9.5", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 7.3 with PostgreSQL 9.6 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:9.6", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 7.3 with PostgreSQL 10 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:10", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 7.4 with PostgreSQL 10 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:10", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 8.0 with PostgreSQL 10 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:10", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 8.1 with PostgreSQL 10 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:10", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 8.2 with PostgreSQL 10 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:10", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 7.3 with PostgreSQL 11 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:11", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 7.4 with PostgreSQL 11 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:11", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 8.0 with PostgreSQL 11 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:11", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 8.1 with PostgreSQL 11 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:11", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "pgsql" }, "kind": "pipeline", "name": "PHP 8.2 with PostgreSQL 11 (pgsql)", "services": [ { "commands": [ "psql -U postgres -c ", "psql -U postgres -d joomla_ut -a -f Tests/Stubs/Schema/pgsql.sql" ], "environment": { "POSTGRES_HOST_AUTH_METHOD": "trust", "POSTGRES_PASSWORD": "", "POSTGRES_USER": "postgres" }, "image": "postgres:11", "name": "pgsql", "ports": [ { "container": 5432, "host": 5432 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php --ri pgsql || true", "vendor/bin/phpunit --configuration phpunit.pgsql.xml.dist --testdox" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlsrv" }, "kind": "pipeline", "name": "PHP 7.3 with MS SQL Server 2017-latest (sqlsrv)", "services": [ { "environment": { "ACCEPT_EULA": "Y", "SA_PASSWORD": "JoomlaFramework123" }, "image": "mcr.microsoft.com/mssql/server:2017-latest", "name": "sqlsrv", "ports": [ { "container": 1433, "host": 1433 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "apt-get update", "apt-get install -y software-properties-common lsb-release gnupg", "curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -", "echo \"deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/debian/11/prod bullseye main\" >> /etc/apt/sources.list", "apt-get update", "ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev", "pecl install sqlsrv && docker-php-ext-enable sqlsrv", "pecl install pdo_sqlsrv && docker-php-ext-enable pdo_sqlsrv", "php --ri sqlsrv", "php --ri pdo_sqlsrv", "vendor/bin/phpunit --configuration phpunit.sqlsrv.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit with MS SQL Server" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlsrv" }, "kind": "pipeline", "name": "PHP 7.4 with MS SQL Server 2017-latest (sqlsrv)", "services": [ { "environment": { "ACCEPT_EULA": "Y", "SA_PASSWORD": "JoomlaFramework123" }, "image": "mcr.microsoft.com/mssql/server:2017-latest", "name": "sqlsrv", "ports": [ { "container": 1433, "host": 1433 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "apt-get update", "apt-get install -y software-properties-common lsb-release gnupg", "curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -", "echo \"deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/debian/11/prod bullseye main\" >> /etc/apt/sources.list", "apt-get update", "ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev", "pecl install sqlsrv && docker-php-ext-enable sqlsrv", "pecl install pdo_sqlsrv && docker-php-ext-enable pdo_sqlsrv", "php --ri sqlsrv", "php --ri pdo_sqlsrv", "vendor/bin/phpunit --configuration phpunit.sqlsrv.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit with MS SQL Server" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlsrv" }, "kind": "pipeline", "name": "PHP 8.0 with MS SQL Server 2017-latest (sqlsrv)", "services": [ { "environment": { "ACCEPT_EULA": "Y", "SA_PASSWORD": "JoomlaFramework123" }, "image": "mcr.microsoft.com/mssql/server:2017-latest", "name": "sqlsrv", "ports": [ { "container": 1433, "host": 1433 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.0", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "apt-get update", "apt-get install -y software-properties-common lsb-release gnupg", "curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -", "echo \"deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/debian/11/prod bullseye main\" >> /etc/apt/sources.list", "apt-get update", "ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev", "pecl install sqlsrv && docker-php-ext-enable sqlsrv", "pecl install pdo_sqlsrv && docker-php-ext-enable pdo_sqlsrv", "php --ri sqlsrv", "php --ri pdo_sqlsrv", "vendor/bin/phpunit --configuration phpunit.sqlsrv.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit with MS SQL Server" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlsrv" }, "kind": "pipeline", "name": "PHP 8.1 with MS SQL Server 2017-latest (sqlsrv)", "services": [ { "environment": { "ACCEPT_EULA": "Y", "SA_PASSWORD": "JoomlaFramework123" }, "image": "mcr.microsoft.com/mssql/server:2017-latest", "name": "sqlsrv", "ports": [ { "container": 1433, "host": 1433 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.1", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "apt-get update", "apt-get install -y software-properties-common lsb-release gnupg", "curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -", "echo \"deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/debian/11/prod bullseye main\" >> /etc/apt/sources.list", "apt-get update", "ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev", "pecl install sqlsrv && docker-php-ext-enable sqlsrv", "pecl install pdo_sqlsrv && docker-php-ext-enable pdo_sqlsrv", "php --ri sqlsrv", "php --ri pdo_sqlsrv", "vendor/bin/phpunit --configuration phpunit.sqlsrv.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit with MS SQL Server" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "environment": { "DB": "sqlsrv" }, "kind": "pipeline", "name": "PHP 8.2 with MS SQL Server 2017-latest (sqlsrv)", "services": [ { "environment": { "ACCEPT_EULA": "Y", "SA_PASSWORD": "JoomlaFramework123" }, "image": "mcr.microsoft.com/mssql/server:2017-latest", "name": "sqlsrv", "ports": [ { "container": 1433, "host": 1433 } ] } ], "steps": [ { "commands": [ "php -v", "sleep 20", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "Composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "apt-get update", "apt-get install -y software-properties-common lsb-release gnupg", "curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -", "echo \"deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/debian/11/prod bullseye main\" >> /etc/apt/sources.list", "apt-get update", "ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev", "pecl install sqlsrv && docker-php-ext-enable sqlsrv", "pecl install pdo_sqlsrv && docker-php-ext-enable pdo_sqlsrv", "php --ri sqlsrv", "php --ri pdo_sqlsrv", "vendor/bin/phpunit --configuration phpunit.sqlsrv.xml.dist --testdox" ], "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit with MS SQL Server" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: b389fab99824411af8ffc163a663529071e2a6e7f7b6a0f19ae148721bea8fb8 ... PK c�\���c� � * database/phpunit.appveyor_sql2017.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="sqlsrv" /> <env name="JOOMLA_TEST_DB_HOST" value="(local)\SQL2017" /> <env name="JOOMLA_TEST_DB_PORT" value="" /> <env name="JOOMLA_TEST_DB_USER" value="sa" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="Password12!" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests</directory> </testsuite> </testsuites> </phpunit> PK c�\���� � database/phpunit.mysql.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="mysql" /> <env name="JOOMLA_TEST_DB_HOST" value="mysql" /> <env name="JOOMLA_TEST_DB_PORT" value="3306" /> <env name="JOOMLA_TEST_DB_USER" value="root" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests/Mysql</directory> </testsuite> </testsuites> </phpunit> PK c�\%�$�� � - database/phpunit.appveyor_sql2012sp1.xml.distnu &1i� <?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="Tests/bootstrap.php" colors="false"> <php> <env name="JOOMLA_TEST_DB_DRIVER" value="sqlsrv" /> <env name="JOOMLA_TEST_DB_HOST" value="(local)\SQL2012SP1" /> <env name="JOOMLA_TEST_DB_PORT" value="" /> <env name="JOOMLA_TEST_DB_USER" value="sa" /> <env name="JOOMLA_TEST_DB_PASSWORD" value="Password12!" /> <env name="JOOMLA_TEST_DB_DATABASE" value="joomla_ut" /> <env name="JOOMLA_TEST_DB_PREFIX" value="" /> <env name="SYMFONY_DEPRECATIONS_HELPER" value="weak" /> </php> <testsuites> <testsuite name="Unit"> <directory>Tests</directory> </testsuite> </testsuites> </phpunit> PK c�\�E[ RJ RJ di/src/Container.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI; use Joomla\DI\Exception\DependencyResolutionException; use Joomla\DI\Exception\KeyNotFoundException; use Joomla\DI\Exception\ProtectedKeyException; use Psr\Container\ContainerInterface; /** * The Container class. * * @since 1.0 */ class Container implements ContainerInterface { /** * Holds the key aliases. * * Format: * 'alias' => 'key' * * @var array * @since 1.0 */ protected $aliases = []; /** * Holds the resources. * * @var ContainerResource[] * @since 2.0.0 */ protected $resources = []; /** * Parent for hierarchical containers. * * In fact, this can be any PSR-11 compatible container, which gets decorated by this * * @var Container|ContainerInterface|null * @since 1.0 */ protected $parent; /** * Holds the service tag mapping. * * @var array * @since 1.5.0 */ protected $tags = []; /** * Constructor for the DI Container * * @param ContainerInterface|null $parent Parent for hierarchical containers. * * @since 1.0 */ public function __construct(?ContainerInterface $parent = null) { $this->parent = $parent; } /** * Retrieve a resource * * @param string $resourceName Name of the resource to get. * * @return mixed The requested resource * * @since 1.0 * @throws KeyNotFoundException */ public function get($resourceName) { $key = $this->resolveAlias($resourceName); if (!isset($this->resources[$key])) { if ($this->parent instanceof ContainerInterface && $this->parent->has($key)) { return $this->parent->get($key); } throw new KeyNotFoundException(sprintf("Resource '%s' has not been registered with the container.", $resourceName)); } return $this->resources[$key]->getInstance(); } /** * Check if specified resource exists. * * @param string $resourceName Name of the resource to check. * * @return boolean true if key is defined, false otherwise * * @since 1.5.0 */ public function has($resourceName) { $key = $this->resolveAlias($resourceName); if (!isset($this->resources[$key])) { if ($this->parent instanceof ContainerInterface) { return $this->parent->has($key); } return false; } return true; } /** * Method to check if specified dataStore key exists. * * @param string $key Name of the dataStore key to check. * * @return boolean True for success * * @since 1.0 * @deprecated 3.0 Use ContainerInterface::has() instead */ public function exists($key) { trigger_deprecation( 'joomla/di', '1.5.0', '%s() is deprecated and will be removed in 3.0, use %s::has() instead.', __METHOD__, ContainerInterface::class ); return $this->has($key); } /** * Create an alias for a given key for easy access. * * @param string $alias The alias name * @param string $key The key to alias * * @return $this * * @since 1.0 */ public function alias($alias, $key) { $this->aliases[$alias] = $key; return $this; } /** * Resolve a resource name. * * If the resource name is an alias, the corresponding key is returned. * If the resource name is not an alias, the resource name is returned unchanged. * * @param string $resourceName The key to search for. * * @return string * * @since 1.0 */ protected function resolveAlias($resourceName) { return $this->aliases[$resourceName] ?? $resourceName; } /** * Check whether a resource is shared * * @param string $resourceName Name of the resource to check. * * @return boolean * * @since 2.0.0 */ public function isShared(string $resourceName): bool { return $this->hasFlag($resourceName, 'isShared', true); } /** * Check whether a resource is protected * * @param string $resourceName Name of the resource to check. * * @return boolean * * @since 2.0.0 */ public function isProtected(string $resourceName): bool { return $this->hasFlag($resourceName, 'isProtected', true); } /** * Check whether a flag (i.e., one of 'shared' or 'protected') is set * * @param string $resourceName Name of the resource to check. * @param string $method Method to delegate to * @param boolean $default Default return value * * @return boolean * * @since 2.0.0 * @throws KeyNotFoundException */ private function hasFlag(string $resourceName, string $method, bool $default = true): bool { $key = $this->resolveAlias($resourceName); if (isset($this->resources[$key])) { return \call_user_func([$this->resources[$key], $method]); } if ($this->parent instanceof self) { return \call_user_func([$this->parent, $method], $key); } if ($this->parent instanceof ContainerInterface && $this->parent->has($key)) { // We don't know if the parent supports the 'shared' or 'protected' concept, so we assume the default return $default; } throw new KeyNotFoundException(sprintf("Resource '%s' has not been registered with the container.", $resourceName)); } /** * Assign a tag to services. * * @param string $tag The tag name * @param array $keys The service keys to tag * * @return $this * * @since 1.5.0 */ public function tag($tag, array $keys) { foreach ($keys as $key) { $resolvedKey = $this->resolveAlias($key); if (!isset($this->tags[$tag])) { $this->tags[$tag] = []; } $this->tags[$tag][] = $resolvedKey; } // Prune duplicates $this->tags[$tag] = array_unique($this->tags[$tag]); return $this; } /** * Fetch all services registered to the given tag. * * @param string $tag The tag name * * @return array The resolved services for the given tag * * @since 1.5.0 */ public function getTagged($tag) { $services = []; if (isset($this->tags[$tag])) { foreach ($this->tags[$tag] as $service) { $services[] = $this->get($service); } } return $services; } /** * Build an object of the requested class * * Creates an instance of the class specified by $resourceName with all dependencies injected. * If the dependencies cannot be completely resolved, a DependencyResolutionException is thrown. * * @param string $resourceName The class name to build. * @param boolean $shared True to create a shared resource. * * @return object|false Instance of class specified by $resourceName with all dependencies injected. * Returns an object if the class exists and false otherwise * * @since 1.0 * @throws DependencyResolutionException if the object could not be built (due to missing information) */ public function buildObject($resourceName, $shared = false) { static $buildStack = []; $key = $this->resolveAlias($resourceName); if (\in_array($key, $buildStack, true)) { $buildStack = []; throw new DependencyResolutionException(sprintf('Cannot resolve circular dependency for "%s"', $key)); } $buildStack[] = $key; if ($this->has($key)) { $resource = $this->get($key); array_pop($buildStack); return $resource; } try { $reflection = new \ReflectionClass($key); } catch (\ReflectionException $e) { array_pop($buildStack); return false; } if (!$reflection->isInstantiable()) { $buildStack = []; if ($reflection->isInterface()) { throw new DependencyResolutionException( sprintf('There is no service for "%s" defined, cannot autowire a class service for an interface.', $key) ); } if ($reflection->isAbstract()) { throw new DependencyResolutionException( sprintf('There is no service for "%s" defined, cannot autowire an abstract class.', $key) ); } throw new DependencyResolutionException(sprintf('"%s" cannot be instantiated.', $key)); } $constructor = $reflection->getConstructor(); // If there are no parameters, just return a new object. if ($constructor === null) { // There is no constructor, just return a new object. $callback = function () use ($key) { return new $key; }; } else { $newInstanceArgs = $this->getMethodArgs($constructor); $callback = function () use ($reflection, $newInstanceArgs) { return $reflection->newInstanceArgs($newInstanceArgs); }; } $this->set($key, $callback, $shared); $resource = $this->get($key); array_pop($buildStack); return $resource; } /** * Convenience method for building a shared object. * * @param string $resourceName The class name to build. * * @return object|false Instance of class specified by $resourceName with all dependencies injected. * Returns an object if the class exists and false otherwise * * @since 1.0 */ public function buildSharedObject($resourceName) { return $this->buildObject($resourceName, true); } /** * Create a child Container with a new property scope that has the ability to access the parent scope when resolving. * * @return Container A new container with the current as a parent * * @since 1.0 */ public function createChild() { return new static($this); } /** * Extend a defined service Closure by wrapping the existing one with a new callable function. * * This works very similar to a decorator pattern. Note that this only works on service Closures * that have been defined in the current container, not parent containers. * * @param string $resourceName The unique identifier for the Closure or property. * @param callable $callable A callable to wrap the original service Closure. * * @return void * * @since 1.0 * @throws KeyNotFoundException */ public function extend($resourceName, callable $callable) { $key = $this->resolveAlias($resourceName); $resource = $this->getResource($key, true); $closure = function ($c) use ($callable, $resource) { return $callable($resource->getInstance(), $c); }; $this->set($key, $closure, $resource->isShared()); } /** * Build an array of method arguments. * * @param \ReflectionMethod $method Method for which to build the argument array. * * @return array Array of arguments to pass to the method. * * @since 1.0 * @throws DependencyResolutionException */ private function getMethodArgs(\ReflectionMethod $method): array { $methodArgs = []; foreach ($method->getParameters() as $param) { // Check for a typehinted dependency if ($param->hasType()) { $dependency = $param->getType(); // Don't support PHP 8 union types if ($dependency instanceof \ReflectionUnionType) { // If this is a nullable parameter, then don't error out if ($param->allowsNull()) { $methodArgs[] = null; continue; } throw new DependencyResolutionException( sprintf( 'Could not resolve the parameter "$%s" of "%s::%s()": Union typehints are not supported.', $param->name, $method->class, $method->name ) ); } // Check for a class, if it doesn't have one then it is a scalar type, which we cannot handle if a mandatory argument if ($dependency->isBuiltin()) { // If the param is optional, then fall through to the optional param handling later in this method if (!$param->isOptional()) { $message = 'Could not resolve the parameter "$%s" of "%s::%s()":'; $message .= ' Scalar parameters cannot be autowired and the parameter does not have a default value.'; throw new DependencyResolutionException( sprintf( $message, $param->name, $method->class, $method->name ) ); } } else { $dependencyClassName = $dependency->getName(); // Check that class or interface exists if (!interface_exists($dependencyClassName) && !class_exists($dependencyClassName)) { // If this is a nullable parameter, then don't error out if ($param->allowsNull()) { $methodArgs[] = null; continue; } throw new DependencyResolutionException( sprintf( 'Could not resolve the parameter "$%s" of "%s::%s()": The "%s" class does not exist.', $param->name, $method->class, $method->name, $dependencyClassName ) ); } // If the dependency class name is registered with this container or a parent, use it. if ($this->getResource($dependencyClassName) !== null) { $depObject = $this->get($dependencyClassName); } else { try { $depObject = $this->buildObject($dependencyClassName); } catch (DependencyResolutionException $exception) { // If this is a nullable parameter, then don't error out if ($param->allowsNull()) { $methodArgs[] = null; continue; } $message = 'Could not resolve the parameter "$%s" of "%s::%s()":'; $message .= ' No service for "%s" exists and the dependency could not be autowired.'; throw new DependencyResolutionException( sprintf( $message, $param->name, $method->class, $method->name, $dependencyClassName ), 0, $exception ); } } if ($depObject instanceof $dependencyClassName) { $methodArgs[] = $depObject; continue; } } } // If there is a default parameter and it can be read, use it. if ($param->isOptional() && $param->isDefaultValueAvailable()) { try { $methodArgs[] = $param->getDefaultValue(); continue; } catch (\ReflectionException $exception) { throw new DependencyResolutionException( sprintf( 'Could not resolve the parameter "$%s" of "%s::%s()": Unable to read the default parameter value.', $param->name, $method->class, $method->name ), 0, $exception ); } } // If an untyped variadic argument, skip it if (!$param->hasType() && $param->isVariadic()) { continue; } // At this point the argument cannot be resolved, most likely cause is an untyped required argument throw new DependencyResolutionException( sprintf( 'Could not resolve the parameter "$%s" of "%s::%s()": The argument is untyped and has no default value.', $param->name, $method->class, $method->name ) ); } return $methodArgs; } /** * Set a resource to the container. If the value is null the resource is removed. * * @param string $key Name of resources key to set. * @param mixed $value Callable function to run or string to retrive when requesting the specified $key. * @param boolean $shared True to create and store a shared instance. * @param boolean $protected True to protect this item from being overwritten. Useful for services. * * @return $this * * @since 1.0 * @throws ProtectedKeyException Thrown if the provided key is already set and is protected. */ public function set($key, $value, $shared = false, $protected = false) { $key = $this->resolveAlias($key); $hasKey = $this->has($key); if ($hasKey && $this->isProtected($key)) { throw new ProtectedKeyException(sprintf("Key %s is protected and can't be overwritten.", $key)); } if ($value === null && $hasKey) { unset($this->resources[$key]); return $this; } $mode = $shared ? ContainerResource::SHARE : ContainerResource::NO_SHARE; $mode |= $protected ? ContainerResource::PROTECT : ContainerResource::NO_PROTECT; $this->resources[$key] = new ContainerResource($this, $value, $mode); return $this; } /** * Shortcut method for creating protected keys. * * @param string $key Name of dataStore key to set. * @param mixed $value Callable function to run or string to retrive when requesting the specified $key. * @param boolean $shared True to create and store a shared instance. * * @return $this * * @since 1.0 */ public function protect($key, $value, $shared = false) { return $this->set($key, $value, $shared, true); } /** * Shortcut method for creating shared keys. * * @param string $key Name of dataStore key to set. * @param mixed $value Callable function to run or string to retrive when requesting the specified $key. * @param boolean $protected True to protect this item from being overwritten. Useful for services. * * @return $this * * @since 1.0 */ public function share($key, $value, $protected = false) { return $this->set($key, $value, true, $protected); } /** * Get the raw data assigned to a key. * * @param string $key The key for which to get the stored item. * @param boolean $bail Throw an exception, if the key is not found * * @return ContainerResource|null The resource if present, or null if instructed to not bail * * @since 2.0.0 * @throws KeyNotFoundException */ public function getResource(string $key, bool $bail = false): ?ContainerResource { if (isset($this->resources[$key])) { return $this->resources[$key]; } if ($this->parent instanceof self) { return $this->parent->getResource($key); } if ($this->parent instanceof ContainerInterface && $this->parent->has($key)) { return new ContainerResource($this, $this->parent->get($key), ContainerResource::SHARE | ContainerResource::PROTECT); } if ($bail) { throw new KeyNotFoundException(sprintf('Key %s has not been registered with the container.', $key)); } return null; } /** * Method to force the container to return a new instance of the results of the callback for requested $key. * * @param string $key Name of the resources key to get. * * @return mixed Results of running the callback for the specified key. * * @since 1.0 */ public function getNewInstance($key) { $key = $this->resolveAlias($key); $this->getResource($key, true)->reset(); return $this->get($key); } /** * Register a service provider to the container. * * @param ServiceProviderInterface $provider The service provider to register. * * @return $this * * @since 1.0 */ public function registerServiceProvider(ServiceProviderInterface $provider) { $provider->register($this); return $this; } /** * Retrieve the keys for services assigned to this container. * * @return array * * @since 1.5.0 */ public function getKeys() { return array_unique(array_merge(array_keys($this->aliases), array_keys($this->resources))); } } PK c�\��!* * " di/src/ContainerAwareInterface.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI; /** * Defines the interface for a Container Aware class. * * @since 1.0 */ interface ContainerAwareInterface { /** * Set the DI container. * * @param Container $container The DI container. * * @return mixed * * @since 1.0 */ public function setContainer(Container $container); } PK c�\��$� � ) di/src/Exception/KeyNotFoundException.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI\Exception; use Psr\Container\NotFoundExceptionInterface; /** * No entry was found in the container. * * @since 1.5.0 */ class KeyNotFoundException extends \InvalidArgumentException implements NotFoundExceptionInterface { } PK c�\A� 0� � / di/src/Exception/ContainerNotFoundException.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI\Exception; use Psr\Container\ContainerExceptionInterface; /** * No container is available. * * @since 2.0.0 */ class ContainerNotFoundException extends \RuntimeException implements ContainerExceptionInterface { } PK c�\���� � * di/src/Exception/ProtectedKeyException.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI\Exception; use Psr\Container\ContainerExceptionInterface; /** * Attempt to set the value of a protected key, which already is set * * @since 1.5.0 */ class ProtectedKeyException extends \OutOfBoundsException implements ContainerExceptionInterface { } PK c�\y�q� � 2 di/src/Exception/DependencyResolutionException.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI\Exception; use Psr\Container\ContainerExceptionInterface; /** * Exception class for handling errors in resolving a dependency * * @since 1.0 */ class DependencyResolutionException extends \RuntimeException implements ContainerExceptionInterface { } PK c�\�td�? ? # di/src/ServiceProviderInterface.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI; /** * Defines the interface for a Service Provider. * * @since 1.0 */ interface ServiceProviderInterface { /** * Registers the service provider with a DI container. * * @param Container $container The DI container. * * @return void * * @since 1.0 */ public function register(Container $container); } PK c�\�Iw�� � di/src/ContainerResource.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI; /** * Defines the representation of a resource. * * @since 2.0.0 * @internal */ final class ContainerResource { /** * Defines the resource as non-shared * * @const integer * @since 2.0.0 */ public const NO_SHARE = 0; /** * Defines the resource as shared * * @const integer * @since 2.0.0 */ public const SHARE = 1; /** * Defines the resource as non-protected * * @const integer * @since 2.0.0 */ public const NO_PROTECT = 0; /** * Defines the resource as protected * * @const integer * @since 2.0.0 */ public const PROTECT = 2; /** * The container the resource is assigned to * * @var Container * @since 2.0.0 */ private $container; /** * The object instance for a shared object * * @var mixed * @since 2.0.0 */ private $instance; /** * The factory object * * @var callable * @since 2.0.0 */ private $factory; /** * Flag if the resource is shared * * @var boolean * @since 2.0.0 */ private $shared = false; /** * Flag if the resource is protected * * @var boolean * @since 2.0.0 */ private $protected = false; /** * Create a resource representation * * @param Container $container The container * @param mixed $value The resource or its factory closure * @param integer $mode Resource mode, defaults to Resource::NO_SHARE | Resource::NO_PROTECT * * @since 2.0.0 */ public function __construct(Container $container, $value, int $mode = 0) { $this->container = $container; $this->shared = ($mode & self::SHARE) === self::SHARE; $this->protected = ($mode & self::PROTECT) === self::PROTECT; if (\is_callable($value)) { $this->factory = $value; } else { if ($this->shared) { $this->instance = $value; } if (\is_object($value)) { $this->factory = function () use ($value) { return clone $value; }; } else { $this->factory = function () use ($value) { return $value; }; } } } /** * Check whether the resource is shared * * @return boolean * * @since 2.0.0 */ public function isShared(): bool { return $this->shared; } /** * Check whether the resource is protected * * @return boolean * * @since 2.0.0 */ public function isProtected(): bool { return $this->protected; } /** * Get an instance of the resource * * If a factory was provided, the resource is created and - if it is a shared resource - cached internally. * If the resource was provided directly, that resource is returned. * * @return mixed * * @since 2.0.0 */ public function getInstance() { $callable = $this->factory; if ($this->isShared()) { if ($this->instance === null) { $this->instance = $callable($this->container); } return $this->instance; } return $callable($this->container); } /** * Get the factory * * @return callable * * @since 2.0.0 */ public function getFactory(): callable { return $this->factory; } /** * Reset the resource * * The instance cache is cleared, so that the next call to get() returns a new instance. * This has an effect on shared, non-protected resources only. * * @return boolean True if the resource was reset, false otherwise * * @since 2.0.0 */ public function reset(): bool { if ($this->isShared() && !$this->isProtected()) { $this->instance = null; return true; } return false; } } PK c�\��3xN N di/src/ContainerAwareTrait.phpnu �[��� <?php /** * Part of the Joomla Framework DI Package * * @copyright Copyright (C) 2013 - 2018 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\DI; use Joomla\DI\Exception\ContainerNotFoundException; /** * Defines the trait for a Container Aware Class. * * @since 1.2 */ trait ContainerAwareTrait { /** * DI Container * * @var Container * @since 1.2 */ private $container; /** * Get the DI container. * * @return Container * * @since 1.2 * @throws ContainerNotFoundException May be thrown if the container has not been set. */ protected function getContainer() { if ($this->container) { return $this->container; } throw new ContainerNotFoundException('Container not set in ' . \get_class($this)); } /** * Set the DI container. * * @param Container $container The DI container. * * @return $this * * @since 1.2 */ public function setContainer(Container $container) { $this->container = $container; return $this; } } PK c�\�P�E �E di/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�P�E �E registry/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\ p�� registry/src/Factory.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2015 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry; /** * Factory class to fetch Registry objects * * @since 1.5.0 */ class Factory { /** * Returns a FormatInterface object, only creating it if it doesn't already exist. * * @param string $type The format to load * @param array $options Additional options to configure the object * * @return FormatInterface Registry format handler * * @throws \InvalidArgumentException * * @since 1.5.0 * @since 2.0.0 Object caching is no longer supported. `Factory::getFormat()` returns a new `FormatInterface` * instance on each call. */ public static function getFormat($type, array $options = []) { // Sanitize format type. $type = \strtolower(\preg_replace('/[^A-Z\d_]/i', '', $type)); $localNamespace = __NAMESPACE__ . '\\Format'; $namespace = $options['format_namespace'] ?? $localNamespace; $class = $namespace . '\\' . \ucfirst($type); if (!\class_exists($class)) { // Were we given a custom namespace? If not, there's nothing else we can do if ($namespace === $localNamespace) { throw new \InvalidArgumentException(\sprintf('Unable to load format class for type "%s".', $type), 500); } $class = $localNamespace . '\\' . \ucfirst($type); if (!\class_exists($class)) { throw new \InvalidArgumentException(\sprintf('Unable to load format class for type "%s".', $type), 500); } } return new $class(); } } PK c�\����g �g registry/src/Registry.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2013 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry; use Joomla\Utilities\ArrayHelper; /** * Registry class * * @since 1.0.0 * @since 2.0.0 `Registry::getInstance()` was removed. Instantiate a new Registry instance instead. */ class Registry implements \JsonSerializable, \ArrayAccess, \IteratorAggregate, \Countable { /** * Registry Object * * @var \stdClass * @since 1.0.0 */ protected $data; /** * Flag if the Registry data object has been initialized * * @var boolean * @since 1.5.2 */ protected $initialized = false; /** * Path separator * * @var string * @since 1.4.0 */ protected $separator = '.'; /** * Constructor * * @param mixed $data The data to bind to the new Registry object. * @param string $separator The path separator, and empty string will flatten the registry. * * @since 1.0.0 */ public function __construct($data = null, string $separator = '.') { $this->separator = $separator; // Instantiate the internal data object. $this->data = new \stdClass(); // Optionally load supplied data. if ($data instanceof self) { $this->merge($data); } elseif (\is_array($data) || \is_object($data)) { $this->bindData($this->data, $data); } elseif (!empty($data) && \is_string($data)) { $this->loadString($data); } } /** * Magic function to clone the registry object. * * @return void * * @since 1.0.0 */ public function __clone() { $this->data = \unserialize(\serialize($this->data)); } /** * Magic function to render this object as a string using default args of toString method. * * @return string * * @since 1.0.0 */ public function __toString() { return $this->toString(); } /** * Count elements of the data object * * @return integer The custom count as an integer. * * @link https://www.php.net/manual/en/countable.count.php * @since 1.3.0 */ #[\ReturnTypeWillChange] public function count() { return \count(\get_object_vars($this->data)); } /** * Implementation for the JsonSerializable interface. * Allows us to pass Registry objects to json_encode. * * @return object * * @since 1.0.0 * @note The interface is only present in PHP 5.4 and up. */ #[\ReturnTypeWillChange] public function jsonSerialize() { return $this->data; } /** * Sets a default value if not already assigned. * * @param string $key The name of the parameter. * @param mixed $default An optional value for the parameter. * * @return mixed The value set, or the default if the value was not previously set (or null). * * @since 1.0.0 */ public function def($key, $default = '') { $value = $this->get($key, $default); $this->set($key, $value); return $value; } /** * Check if a registry path exists. * * @param string $path Registry path (e.g. joomla.content.showauthor) * * @return boolean * * @since 1.0.0 */ public function exists($path) { // Return default value if path is empty if (empty($path)) { return false; } // Explode the registry path into an array if ($this->separator === null || $this->separator === '') { $nodes = [$path]; } else { $nodes = \explode($this->separator, $path); } // Initialize the current node to be the registry root. $node = $this->data; $found = false; // Traverse the registry to find the correct node for the result. foreach ($nodes as $n) { if (\is_array($node) && isset($node[$n])) { $node = $node[$n]; $found = true; continue; } if (!isset($node->$n)) { return false; } $node = $node->$n; $found = true; } return $found; } /** * Get a registry value. * * @param string $path Registry path (e.g. joomla.content.showauthor) * @param mixed $default Optional default value, returned if the internal value is null. * * @return mixed Value of entry or null * * @since 1.0.0 */ public function get($path, $default = null) { // Return default value if path is empty if (empty($path)) { return $default; } if ($this->separator === null || $this->separator === '' || !\strpos($path, $this->separator)) { return (isset($this->data->$path) && $this->data->$path !== null && $this->data->$path !== '') ? $this->data->$path : $default; } // Explode the registry path into an array $nodes = \explode($this->separator, \trim($path)); // Initialize the current node to be the registry root. $node = $this->data; $found = false; // Traverse the registry to find the correct node for the result. foreach ($nodes as $n) { if (\is_array($node) && isset($node[$n])) { $node = $node[$n]; $found = true; continue; } if (!isset($node->$n)) { return $default; } $node = $node->$n; $found = true; } if (!$found || $node === null || $node === '') { return $default; } return $node; } /** * Gets this object represented as an ArrayIterator. * * This allows the data properties to be accessed via a foreach statement. * * @return \ArrayIterator This object represented as an ArrayIterator. * * @see \IteratorAggregate::getIterator() * @since 1.3.0 */ #[\ReturnTypeWillChange] public function getIterator() { return new \ArrayIterator($this->data); } /** * Load an associative array of values into the default namespace * * @param array $array Associative array of value to load * @param boolean $flattened Load from a one-dimensional array * @param string $separator The key separator * * @return $this * * @since 1.0.0 * @since 2.0.0 The parameter `$array` is now type hinted as `array`. Before 2.0.0, the type was not enforced. */ public function loadArray(array $array, $flattened = false, $separator = null) { if (!$flattened) { $this->bindData($this->data, $array); return $this; } foreach ($array as $k => $v) { $this->set($k, $v, $separator); } return $this; } /** * Load the public variables of the object into the default namespace. * * @param object $object The object holding the publics to load * * @return $this * * @since 1.0.0 */ public function loadObject($object) { $this->bindData($this->data, $object); return $this; } /** * Load the contents of a file into the registry * * @param string $file Path to file to load * @param string $format Format of the file [optional: defaults to JSON] * @param array $options Options used by the formatter * * @return $this * * @since 1.0.0 * @since 2.0.0 The parameter `$options` is now type hinted as `array`. Before 2.0.0, the type was not enforced. */ public function loadFile($file, $format = 'JSON', array $options = []) { $data = \file_get_contents($file); return $this->loadString($data, $format, $options); } /** * Load a string into the registry * * @param string $data String to load into the registry * @param string $format Format of the string * @param array $options Options used by the formatter * * @return $this * * @since 1.0.0 * @since 2.0.0 The parameter `$options` is now type hinted as `array`. Before 2.0.0, the type was not enforced. */ public function loadString($data, $format = 'JSON', array $options = []) { // Load a string into the given namespace [or default namespace if not given] $obj = Factory::getFormat($format, $options)->stringToObject($data, $options); // If the data object has not yet been initialized, direct assign the object if (!$this->initialized) { $this->data = $obj; $this->initialized = true; return $this; } $this->loadObject($obj); return $this; } /** * Merge a Registry object into this one * * @param Registry $source Source Registry object to merge. * @param boolean $recursive True to support recursive merge the children values. * * @return $this * * @since 1.0.0 * @since 2.0.0 The parameter `$source` is now type hinted as `Registry`. Before 2.0.0, `Registry::merge()` just * returned `false` if `$source` was not a `Registry`. */ public function merge(Registry $source, $recursive = false) { $this->bindData($this->data, $source->toArray(), $recursive, false); return $this; } /** * Method to extract a sub-registry from path * * @param string $path Registry path (e.g. joomla.content.showauthor) * * @return Registry Registry object (empty if no data is present) * * @since 1.2.0 * @since 2.0.0 `Registry:extract()` now always returns a `Registry` object. Before 2.0.0, `null` was returned * if there was no data for the key. */ public function extract($path) { $data = $this->get($path); return new Registry($data); } /** * Checks whether an offset exists in the iterator. * * @param mixed $offset The array offset. * * @return boolean True if the offset exists, false otherwise. * * @since 1.0.0 */ #[\ReturnTypeWillChange] public function offsetExists($offset) { return $this->exists($offset); } /** * Gets an offset in the iterator. * * @param mixed $offset The array offset. * * @return mixed The array value if it exists, null otherwise. * * @since 1.0.0 */ #[\ReturnTypeWillChange] public function offsetGet($offset) { return $this->get($offset); } /** * Sets an offset in the iterator. * * @param mixed $offset The array offset. * @param mixed $value The array value. * * @return void * * @since 1.0.0 */ #[\ReturnTypeWillChange] public function offsetSet($offset, $value) { $this->set($offset, $value); } /** * Unsets an offset in the iterator. * * @param mixed $offset The array offset. * * @return void * * @since 1.0.0 */ #[\ReturnTypeWillChange] public function offsetUnset($offset) { $this->remove($offset); } /** * Set a registry value. * * @param string $path Registry Path (e.g. joomla.content.showauthor) * @param mixed $value Value of entry * @param string $separator The key separator * * @return mixed The value of the that has been set. * * @since 1.0.0 * * @deprecated The $separator parameter will be removed in version 4. */ public function set($path, $value, $separator = null) { if ($separator === null) { $separator = $this->separator; } else { \trigger_deprecation( 'joomla/registry', '__DEPLOY_VERSION__', 'The $separator parameter will be removed in version 3.', self::class, self::class ); } /* * Explode the registry path into an array and remove empty * nodes that occur as a result of a double separator. ex: joomla..test * Finally, re-key the array so they are sequential. */ if ($separator === null || $separator === '') { $nodes = [$path]; } else { $nodes = \array_values(\array_filter(\explode($separator, $path), 'strlen')); } if (!$nodes) { return null; } // Initialize the current node to be the registry root. $node = $this->data; // Traverse the registry to find the correct node for the result. for ($i = 0, $n = \count($nodes) - 1; $i < $n; $i++) { if (\is_object($node)) { if (!isset($node->{$nodes[$i]})) { $node->{$nodes[$i]} = new \stdClass(); } // Pass the child as pointer in case it is an object $node = &$node->{$nodes[$i]}; continue; } if (\is_array($node)) { if (!isset($node[$nodes[$i]])) { $node[$nodes[$i]] = new \stdClass(); } // Pass the child as pointer in case it is an array $node = &$node[$nodes[$i]]; } } // Get the old value if exists so we can return it switch (true) { case (\is_object($node)): $result = $node->{$nodes[$i]} ?? null; $node->{$nodes[$i]} = $value; break; case (\is_array($node)): $result = $node[$nodes[$i]] ?? null; $node[$nodes[$i]] = $value; break; default: $result = null; break; } return $result; } /** * Append value to a path in registry * * @param string $path Parent registry Path (e.g. joomla.content.showauthor) * @param mixed $value Value of entry * * @return mixed The value of the that has been set. * * @since 1.4.0 */ public function append($path, $value) { $result = null; /* * Explode the registry path into an array and remove empty * nodes that occur as a result of a double dot. ex: joomla..test * Finally, re-key the array so they are sequential. */ if ($this->separator === null || $this->separator === '') { $nodes = [$path]; } else { $nodes = \array_values(\array_filter(\explode($this->separator, $path), 'strlen')); } if ($nodes) { // Initialize the current node to be the registry root. $node = $this->data; // Traverse the registry to find the correct node for the result. // TODO Create a new private method from part of code below, as it is almost equal to 'set' method for ($i = 0, $n = \count($nodes) - 1; $i <= $n; $i++) { if (\is_object($node)) { if (!isset($node->{$nodes[$i]}) && ($i !== $n)) { $node->{$nodes[$i]} = new \stdClass(); } // Pass the child as pointer in case it is an array $node = &$node->{$nodes[$i]}; } elseif (\is_array($node)) { if (($i !== $n) && !isset($node[$nodes[$i]])) { $node[$nodes[$i]] = new \stdClass(); } // Pass the child as pointer in case it is an array $node = &$node[$nodes[$i]]; } } if (!\is_array($node)) { // Convert the node to array to make append possible $node = \get_object_vars($node); } $node[] = $value; $result = $value; } return $result; } /** * Delete a registry value * * @param string $path Registry Path (e.g. joomla.content.showauthor) * * @return mixed The value of the removed node or null if not set * * @since 1.6.0 */ public function remove($path) { // Cheap optimisation to direct remove the node if there is no separator if ($this->separator === null || $this->separator === '' || !\strpos($path, $this->separator)) { $result = (isset($this->data->$path) && $this->data->$path !== null && $this->data->$path !== '') ? $this->data->$path : null; unset($this->data->$path); return $result; } /* * Explode the registry path into an array and remove empty * nodes that occur as a result of a double separator. ex: joomla..test * Finally, re-key the array so they are sequential. */ $nodes = \array_values(\array_filter(\explode($this->separator, $path), 'strlen')); if (!$nodes) { return null; } // Initialize the current node to be the registry root. $node = $this->data; $parent = null; // Traverse the registry to find the correct node for the result. for ($i = 0, $n = \count($nodes) - 1; $i < $n; $i++) { if (\is_object($node)) { if (!isset($node->{$nodes[$i]})) { continue; } $parent = &$node; $node = $node->{$nodes[$i]}; continue; } if (\is_array($node)) { if (!isset($node[$nodes[$i]])) { continue; } $parent = &$node; $node = $node[$nodes[$i]]; continue; } } // Get the old value if exists so we can return it switch (true) { case \is_object($node): $result = $node->{$nodes[$i]} ?? null; unset($parent->{$nodes[$i]}); break; case \is_array($node): $result = $node[$nodes[$i]] ?? null; unset($parent[$nodes[$i]]); break; default: $result = null; break; } return $result; } /** * Transforms a namespace to an array * * @return array An associative array holding the namespace data * * @since 1.0.0 */ public function toArray() { return $this->asArray($this->data); } /** * Transforms a namespace to an object * * @return object An an object holding the namespace data * * @since 1.0.0 */ public function toObject() { return $this->data; } /** * Get a namespace in a given string format * * @param string $format Format to return the string in * @param array $options Parameters used by the formatter, see formatters for more info * * @return string Namespace in string format * * @since 1.0.0 */ public function toString($format = 'JSON', array $options = []) { return Factory::getFormat($format, $options)->objectToString($this->data, $options); } /** * Method to recursively bind data to a parent object. * * @param object $parent The parent object on which to attach the data values. * @param mixed $data An array or object of data to bind to the parent object. * @param boolean $recursive True to support recursive bindData. * @param boolean $allowNull True to allow null values. * * @return void * * @since 1.0.0 */ protected function bindData($parent, $data, $recursive = true, $allowNull = true) { // The data object is now initialized $this->initialized = true; // Ensure the input data is an array. $data = \is_object($data) ? \get_object_vars($data) : (array) $data; foreach ($data as $k => $v) { if (!$allowNull && !(($v !== null) && ($v !== ''))) { continue; } if ($recursive && ((\is_array($v) && ArrayHelper::isAssociative($v)) || \is_object($v))) { if (!isset($parent->$k)) { $parent->$k = new \stdClass(); } $this->bindData($parent->$k, $v); continue; } $parent->$k = $v; } } /** * Method to recursively convert an object of data to an array. * * @param object $data An object of data to return as an array. * * @return array Array representation of the input object. * * @since 1.0.0 */ protected function asArray($data) { $array = []; if (\is_object($data)) { $data = \get_object_vars($data); } foreach ($data as $k => $v) { if (\is_object($v) || \is_array($v)) { $array[$k] = $this->asArray($v); continue; } $array[$k] = $v; } return $array; } /** * Dump to one dimension array. * * @param string $separator The key separator. * * @return string[] Dumped array. * * @since 1.3.0 */ public function flatten($separator = null) { $array = []; if (empty($separator)) { $separator = $this->separator; } $this->toFlatten($separator, $this->data, $array); return $array; } /** * Method to recursively convert data to one dimension array. * * @param string $separator The key separator. * @param array|object $data Data source of this scope. * @param array $array The result array, it is passed by reference. * @param string $prefix Last level key prefix. * * @return void * * @since 1.3.0 * @since 2.0.0 The parameter `$array` is now type hinted as `array`. Before 2.0.0, the type was not enforced. */ protected function toFlatten($separator = null, $data = null, array &$array = [], $prefix = '') { $data = (array) $data; if (empty($separator)) { $separator = $this->separator; } foreach ($data as $k => $v) { $key = $prefix ? $prefix . $separator . $k : $k; if (\is_object($v) || \is_array($v)) { $this->toFlatten($separator, $v, $array, $key); continue; } $array[$key] = $v; } } /** * Magic method to access separator property. * * @param string $name The name of the property. * * @return string|null A value if the property name is valid, null otherwise. * * @since __DEPLOY_VERSION__ * @deprecated 3.0 This is a B/C proxy for deprecated read accesses */ public function __get($name) { switch ($name) { case 'separator': \trigger_deprecation( 'joomla/registry', '__DEPLOY_VERSION__', 'The $separator parameter will be removed in version 3.', self::class, self::class ); return $this->separator; default: if (property_exists($this, $name)) { throw new \RuntimeException( \sprintf( 'Cannot access protected or private property %s::$%s', __CLASS__, $name ) ); } $trace = \debug_backtrace(); \trigger_error( \sprintf( 'Undefined property via __get(): %1$s in %2$s on line %3$s', $name, $trace[0]['file'], $trace[0]['line'] ), E_USER_NOTICE ); return null; } } /** * Magic method to access separator property. * * @param string $name The name of the property. * @param mixed $value The value of the property. * * @return void * * @since __DEPLOY_VERSION__ * @deprecated 3.0 This is a B/C proxy for deprecated read accesses */ public function __set($name, $value) { switch ($name) { case 'separator': \trigger_deprecation( 'joomla/registry', '__DEPLOY_VERSION__', 'The $separator parameter will be removed in version 3.', self::class, self::class ); $this->separator = $value; break; default: if (property_exists($this, $name)) { throw new \RuntimeException( \sprintf( 'Cannot access protected or private property %s::$%s', __CLASS__, $name ) ); } \trigger_deprecation( 'joomla/registry', '__DEPLOY_VERSION__', 'Creating a property will be removed in version 3.', self::class, self::class ); $this->$name = $value; break; } } } PK c�\���c c registry/src/Format/Xml.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2013 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry\Format; use Joomla\Registry\FormatInterface; /** * XML format handler for Registry. * * @since 1.0.0 */ class Xml implements FormatInterface { /** * Converts an object into an XML formatted string. * - If more than two levels of nested groups are necessary, since INI is not * useful, XML or another format should be used. * * @param object $object Data source object. * @param array $options Options used by the formatter. * * @return string XML formatted string. * * @since 1.0.0 */ public function objectToString($object, array $options = []) { $rootName = $options['name'] ?? 'registry'; $nodeName = $options['nodeName'] ?? 'node'; // Create the root node. $root = \simplexml_load_string('<' . $rootName . ' />'); // Iterate over the object members. $this->getXmlChildren($root, $object, $nodeName); return $root->asXML(); } /** * Parse a XML formatted string and convert it into an object. * * @param string $data XML formatted string to convert. * @param array $options Options used by the formatter. * * @return object Data object. * * @since 1.0.0 */ public function stringToObject($data, array $options = []) { $obj = new \stdClass(); // Parse the XML string. $xml = \simplexml_load_string($data); foreach ($xml->children() as $node) { $obj->{$node['name']} = $this->getValueFromNode($node); } return $obj; } /** * Method to get a PHP native value for a SimpleXMLElement object. -- called recursively * * @param object $node SimpleXMLElement object for which to get the native value. * * @return mixed Native value of the SimpleXMLElement object. * * @since 1.0.0 */ protected function getValueFromNode($node) { switch ($node['type']) { case 'integer': $value = (string) $node; return (int) $value; case 'string': return (string) $node; case 'boolean': $value = (string) $node; return (bool) $value; case 'double': $value = (string) $node; return (float) $value; case 'array': $value = []; foreach ($node->children() as $child) { $value[(string) $child['name']] = $this->getValueFromNode($child); } break; default: $value = new \stdClass(); foreach ($node->children() as $child) { $value->{$child['name']} = $this->getValueFromNode($child); } break; } return $value; } /** * Method to build a level of the XML string -- called recursively * * @param \SimpleXMLElement $node SimpleXMLElement object to attach children. * @param object $var Object that represents a node of the XML document. * @param string $nodeName The name to use for node elements. * * @return void * * @since 1.0.0 */ protected function getXmlChildren(\SimpleXMLElement $node, $var, $nodeName) { // Iterate over the object members. foreach ((array) $var as $k => $v) { if (\is_scalar($v)) { $n = $node->addChild($nodeName, $v); $n->addAttribute('name', $k); $n->addAttribute('type', \gettype($v)); } else { $n = $node->addChild($nodeName); $n->addAttribute('name', $k); $n->addAttribute('type', \gettype($v)); $this->getXmlChildren($n, $v, $nodeName); } } } } PK c�\Ӫf�- - registry/src/Format/Json.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2013 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry\Format; use Joomla\Registry\Factory; use Joomla\Registry\FormatInterface; use RuntimeException; /** * JSON format handler for Registry. * * @since 1.0.0 */ class Json implements FormatInterface { /** * Converts an object into a JSON formatted string. * * @param object $object Data source object. * @param array $options Options used by the formatter. * * @return string JSON formatted string. * * @since 1.0.0 */ public function objectToString($object, array $options = []) { $bitMask = $options['bitmask'] ?? 0; $depth = $options['depth'] ?? 512; return \json_encode($object, $bitMask, $depth); } /** * Parse a JSON formatted string and convert it into an object. * * If the string is not in JSON format, this method will attempt to parse it as INI format. * * @param string $data JSON formatted string to convert. * @param array $options Options used by the formatter. * * @return object Data object. * * @throws \RuntimeException * @since 1.0.0 */ public function stringToObject($data, array $options = ['processSections' => false]) { $data = \trim($data); if (empty($data)) { return new \stdClass(); } $decoded = \json_decode($data); // Check for an error decoding the data if ($decoded === null && \json_last_error() !== JSON_ERROR_NONE) { // If it's an ini file, parse as ini. if ($data !== '' && $data[0] !== '{') { return Factory::getFormat('Ini')->stringToObject($data, $options); } throw new \RuntimeException(\sprintf('Error decoding JSON data: %s', \json_last_error_msg())); } return (object) $decoded; } } PK c�\-���� � registry/src/Format/Yaml.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2013 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry\Format; use Joomla\Registry\FormatInterface; use Symfony\Component\Yaml\Dumper as SymfonyYamlDumper; use Symfony\Component\Yaml\Parser as SymfonyYamlParser; use Symfony\Component\Yaml\Yaml as SymfonyYaml; use function sprintf; /** * YAML format handler for Registry. * * @since 1.0.0 */ class Yaml implements FormatInterface { /** * The YAML parser class. * * @var SymfonyYamlParser * @since 1.0.0 */ private $parser; /** * The YAML dumper class. * * @var SymfonyYamlDumper * @since 1.0.0 */ private $dumper; /** * Construct to set up the parser and dumper * * @since 1.0.0 */ public function __construct() { if (!\class_exists(SymfonyYaml::class)) { throw new \RuntimeException( \sprintf( 'The "%s" class could not be found, make sure you have installed the "symfony/yaml" package.', SymfonyYaml::class ) ); } $this->parser = new SymfonyYamlParser(); $this->dumper = new SymfonyYamlDumper(); } /** * Converts an object into a YAML formatted string. * We use json_* to convert the passed object to an array. * * @param object|array $object Data source object. * @param array $options Options used by the formatter. * * @return string YAML formatted string. * * @since 1.0.0 */ public function objectToString($object, array $options = []) { $array = \json_decode(\json_encode($object), true); return $this->dumper->dump($array, 2, 0); } /** * Parse a YAML formatted string and convert it into an object. * We use the json_* methods to convert the parsed YAML array to an object. * * @param string $data YAML formatted string to convert. * @param array $options Options used by the formatter. * * @return object Data object. * * @since 1.0.0 */ public function stringToObject($data, array $options = []) { $array = $this->parser->parse(\trim($data)); return (object) \json_decode(\json_encode($array)); } } PK c�\;�' �' registry/src/Format/Ini.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2013 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry\Format; use Joomla\Registry\FormatInterface; use Joomla\Utilities\ArrayHelper; /** * INI format handler for Registry. * * @since 1.0.0 */ class Ini implements FormatInterface { /** * Default options array * * @var array * @since 1.3.0 */ protected static $options = [ 'supportArrayValues' => false, 'parseBooleanWords' => false, 'processSections' => false, ]; /** * A cache used by stringToObject. * * @var array * @since 1.0.0 */ protected static $cache = []; /** * Converts an object into an INI formatted string * - Unfortunately, there is no way to have ini values nested further than two * levels deep. Therefore we will only go through the first two levels of * the object. * * @param object $object Data source object. * @param array $options Options used by the formatter. * * @return string INI formatted string. * * @since 1.0.0 */ public function objectToString($object, array $options = []) { $options = \array_merge(static::$options, $options); $supportArrayValues = $options['supportArrayValues']; $local = []; $global = []; $variables = \get_object_vars($object); $last = \count($variables); // Assume that the first element is in section $inSection = true; // Iterate over the object to set the properties. foreach ($variables as $key => $value) { // If the value is an object then we need to put it in a local section. if (\is_object($value)) { // Add an empty line if previous string wasn't in a section if (!$inSection) { $local[] = ''; } // Add the section line. $local[] = '[' . $key . ']'; // Add the properties for this section. foreach (\get_object_vars($value) as $k => $v) { if (\is_array($v) && $supportArrayValues) { $assoc = ArrayHelper::isAssociative($v); foreach ($v as $arrayKey => $item) { $arrayKey = $assoc ? $arrayKey : ''; $local[] = $k . '[' . $arrayKey . ']=' . $this->getValueAsIni($item); } } else { $local[] = $k . '=' . $this->getValueAsIni($v); } } // Add empty line after section if it is not the last one if (--$last !== 0) { $local[] = ''; } } elseif (\is_array($value) && $supportArrayValues) { $assoc = ArrayHelper::isAssociative($value); foreach ($value as $arrayKey => $item) { $arrayKey = $assoc ? $arrayKey : ''; $global[] = $key . '[' . $arrayKey . ']=' . $this->getValueAsIni($item); } } else { // Not in a section so add the property to the global array. $global[] = $key . '=' . $this->getValueAsIni($value); $inSection = false; } } return \implode("\n", \array_merge($global, $local)); } /** * Parse an INI formatted string and convert it into an object. * * @param string $data INI formatted string to convert. * @param array $options An array of options used by the formatter, or a boolean setting to process sections. * * @return object Data object. * * @since 1.0.0 */ public function stringToObject($data, array $options = []) { $options = \array_merge(static::$options, $options); // Check the memory cache for already processed strings. $hash = \md5($data . ':' . (int) $options['processSections']); if (isset(static::$cache[$hash])) { return static::$cache[$hash]; } // If no lines present just return the object. if (empty($data)) { return new \stdClass(); } $obj = new \stdClass(); $section = false; $array = false; $lines = \explode("\n", $data); // Process the lines. foreach ($lines as $line) { // Trim any unnecessary whitespace. $line = \trim($line); // Ignore empty lines and comments. if (empty($line) || ($line[0] === ';')) { continue; } if ($options['processSections']) { $length = \strlen($line); // If we are processing sections and the line is a section add the object and continue. if ($line[0] === '[' && ($line[$length - 1] === ']')) { $section = \substr($line, 1, $length - 2); $obj->$section = new \stdClass(); continue; } } elseif ($line[0] === '[') { continue; } // Check that an equal sign exists and is not the first character of the line. if (!\strpos($line, '=')) { // Maybe throw exception? continue; } // Get the key and value for the line. [$key, $value] = \explode('=', $line, 2); // If we have an array item if (\substr($key, -1) === ']' && ($openBrace = \strpos($key, '[', 1)) !== false) { if ($options['supportArrayValues']) { $array = true; $arrayKey = \substr($key, $openBrace + 1, -1); // If we have a multi-dimensional array or malformed key if (\strpos($arrayKey, '[') !== false || \strpos($arrayKey, ']') !== false) { // Maybe throw exception? continue; } $key = \substr($key, 0, $openBrace); } else { continue; } } // Validate the key. if (\preg_match('/[^A-Z\d_]/i', $key)) { // Maybe throw exception? continue; } // If the value is quoted then we assume it is a string. $length = \strlen($value); if ($length && ($value[0] === '"') && ($value[$length - 1] === '"')) { // Strip the quotes and Convert the new line characters. $value = \stripcslashes(\substr($value, 1, $length - 2)); $value = \str_replace('\n', "\n", $value); } else { // If the value is not quoted, we assume it is not a string. // If the value is 'false' assume boolean false. if ($value === 'false') { $value = false; } elseif ($value === 'true') { // If the value is 'true' assume boolean true. $value = true; } elseif ($options['parseBooleanWords'] && \in_array(\strtolower($value), ['yes', 'no'], true)) { // If the value is 'yes' or 'no' and option is enabled assume appropriate boolean $value = (\strtolower($value) === 'yes'); } elseif (\is_numeric($value)) { // If the value is numeric than it is either a float or int. // If there is a period then we assume a float. if (\strpos($value, '.') !== false) { $value = (float) $value; } else { $value = (int) $value; } } } // If a section is set add the key/value to the section, otherwise top level. if ($section) { if ($array) { if (!isset($obj->$section->$key)) { $obj->$section->$key = []; } if (!empty($arrayKey)) { $obj->$section->{$key}[$arrayKey] = $value; } else { $obj->$section->{$key}[] = $value; } } else { $obj->$section->$key = $value; } } else { if ($array) { if (!isset($obj->$key)) { $obj->$key = []; } if (!empty($arrayKey)) { $obj->{$key}[$arrayKey] = $value; } else { $obj->{$key}[] = $value; } } else { $obj->$key = $value; } } $array = false; } // Cache the string to save cpu cycles -- thus the world :) static::$cache[$hash] = clone $obj; return $obj; } /** * Method to get a value in an INI format. * * @param mixed $value The value to convert to INI format. * * @return string The value in INI format. * * @since 1.0.0 */ protected function getValueAsIni($value) { $string = ''; switch (\gettype($value)) { case 'integer': case 'double': $string = $value; break; case 'boolean': $string = $value ? 'true' : 'false'; break; case 'string': // Sanitize any CRLF characters.. $string = '"' . \str_replace(["\r\n", "\n"], '\\n', $value) . '"'; break; } return $string; } } PK c�\���߯ � registry/src/Format/Php.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2013 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry\Format; use Joomla\Registry\FormatInterface; /** * PHP class format handler for Registry * * @since 1.0.0 */ class Php implements FormatInterface { /** * Converts an object into a php class string. * - NOTE: Only one depth level is supported. * * @param object $object Data Source Object * @param array $params Parameters used by the formatter * * @return string Config class formatted string * * @since 1.0.0 * @since 2.0.0 The PHP format respects the data type of each value when generating the PHP source code. * Before 2.0.0, all data were converted to string notation. */ public function objectToString($object, array $params = []) { // A class must be provided $class = $params['class'] ?? 'Registry'; // Build the object variables string $vars = ''; foreach (\get_object_vars($object) as $k => $v) { $vars .= "\tpublic \$$k = " . $this->formatValue($v) . ";\n"; } $str = "<?php\n"; // If supplied, add a namespace to the class object if (isset($params['namespace']) && $params['namespace'] !== '') { $str .= 'namespace ' . $params['namespace'] . ";\n\n"; } $str .= "class $class {\n"; $str .= $vars; $str .= '}'; // Use the closing tag if it not set to false in parameters. if (!isset($params['closingtag']) || $params['closingtag'] !== false) { $str .= "\n?>"; } return $str; } /** * Parse a PHP class formatted string and convert it into an object. * * @param string $data PHP Class formatted string to convert. * @param array $options Options used by the formatter. * * @return object Data object. * * @since 1.0.0 */ public function stringToObject($data, array $options = []) { return new \stdClass(); } /** * Format a value for the string conversion * * @param mixed $value The value to format * * @return mixed The formatted value * * @since 2.0.0 */ protected function formatValue($value) { switch (\gettype($value)) { case 'string': return "'" . \addcslashes($value, '\\\'') . "'"; case 'array': case 'object': return $this->getArrayString((array) $value); case 'double': case 'integer': return $value; case 'boolean': return $value ? 'true' : 'false'; case 'NULL': return 'null'; } return null; } /** * Method to get an array as an exported string. * * @param array $a The array to get as a string. * * @return string * * @since 1.0.0 */ protected function getArrayString($a) { $s = 'array('; $i = 0; foreach ($a as $k => $v) { $s .= $i ? ', ' : ''; $s .= "'" . \addcslashes($k, '\\\'') . "' => "; $s .= $this->formatValue($v); $i++; } $s .= ')'; return $s; } } PK c�\��3�� � registry/src/FormatInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Registry Package * * @copyright Copyright (C) 2015 Open Source Matters, Inc. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Registry; /** * Interface defining a format object * * @since 1.5.0 * @since 1.5.0 Deprecated `AbstractRegistryFormat` in favor of the `FormatInterface`. * @since 2.0.0 Deprecated `AbstractRegistryFormat`. Format objects must now implement the `FormatInterface`. */ interface FormatInterface { /** * Converts an object into a formatted string. * * @param object $object Data Source Object. * @param array $options An array of options for the formatter. * * @return string Formatted string. * * @since 1.5.0 * @since 2.0.0 The `FormatInterface::objectToString()` method typehints the `$options` argument as an array; * this was not enforced before 2.0.0 with `AbstractRegistryFormat::objectToString()`. */ public function objectToString($object, array $options = []); /** * Converts a formatted string into an object. * * @param string $data Formatted string * @param array $options An array of options for the formatter. * * @return object Data Object * * @since 1.5.0 */ public function stringToObject($data, array $options = []); } PK c�\k5a� � archive/src/Tar.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive; use Joomla\Filesystem\File; use Joomla\Filesystem\Folder; use Joomla\Filesystem\Path; /** * Tar format adapter for the Archive package * * This class is inspired from and draws heavily in code and concept from the Compress package of * The Horde Project <http://www.horde.org> * * @contributor Michael Slusarz <slusarz@horde.org> * @contributor Michael Cochrane <mike@graftonhall.co.nz> * * @since 1.0 */ class Tar implements ExtractableInterface { /** * Tar file types. * * @var array * @since 1.0 */ private const TYPES = [ 0x0 => 'Unix file', 0x30 => 'File', 0x31 => 'Link', 0x32 => 'Symbolic link', 0x33 => 'Character special file', 0x34 => 'Block special file', 0x35 => 'Directory', 0x36 => 'FIFO special file', 0x37 => 'Contiguous file', ]; /** * Tar file data buffer * * @var string * @since 1.0 */ private $data; /** * Tar file metadata array * * @var array * @since 1.0 */ private $metadata; /** * Holds the options array. * * @var array|\ArrayAccess * @since 1.0 */ protected $options = []; /** * Create a new Archive object. * * @param array|\ArrayAccess $options An array of options or an object that implements \ArrayAccess * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct($options = []) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->options = $options; } /** * Extract a ZIP compressed file to a given path * * @param string $archive Path to ZIP archive to extract * @param string $destination Path to extract archive into * * @return boolean True if successful * * @since 1.0 * @throws \RuntimeException */ public function extract($archive, $destination) { $this->metadata = null; $this->data = file_get_contents($archive); if (!$this->data) { throw new \RuntimeException('Unable to read archive'); } $this->getTarInfo($this->data); for ($i = 0, $n = \count($this->metadata); $i < $n; $i++) { $type = strtolower($this->metadata[$i]['type']); if ($type == 'file' || $type == 'unix file') { $buffer = $this->metadata[$i]['data']; $path = Path::clean($destination . '/' . $this->metadata[$i]['name']); if (!$this->isBelow($destination, $destination . '/' . $this->metadata[$i]['name'])) { throw new \OutOfBoundsException('Unable to write outside of destination path', 100); } // Make sure the destination folder exists if (!Folder::create(\dirname($path))) { throw new \RuntimeException('Unable to create destination folder ' . \dirname($path)); } if (!File::write($path, $buffer)) { throw new \RuntimeException('Unable to write entry to file ' . $path); } } } return true; } /** * Tests whether this adapter can unpack files on this computer. * * @return boolean True if supported * * @since 1.0 */ public static function isSupported() { return true; } /** * Get the list of files/data from a Tar archive buffer and builds a metadata array. * * Array structure: * <pre> * KEY: Position in the array * VALUES: 'attr' -- File attributes * 'data' -- Raw file contents * 'date' -- File modification time * 'name' -- Filename * 'size' -- Original file size * 'type' -- File type * </pre> * * @param string $data The Tar archive buffer. * * @return void * * @since 1.0 * @throws \RuntimeException */ protected function getTarInfo(&$data) { $position = 0; $returnArray = []; while ($position < \strlen($data)) { $info = @unpack( 'Z100filename/Z8mode/Z8uid/Z8gid/Z12size/Z12mtime/Z8checksum/Ctypeflag/Z100link/Z6magic/Z2version/Z32uname/Z32gname/Z8devmajor/Z8devminor', substr($data, $position) ); /* * This variable has been set in the previous loop, meaning that the filename was present in the previous block * to allow more than 100 characters - see below */ if (isset($longlinkfilename)) { $info['filename'] = $longlinkfilename; unset($longlinkfilename); } if (!$info) { throw new \RuntimeException('Unable to decompress data'); } $position += 512; $contents = substr($data, $position, octdec($info['size'])); $position += ceil(octdec($info['size']) / 512) * 512; if ($info['filename']) { $file = [ 'attr' => null, 'data' => null, 'date' => octdec($info['mtime']), 'name' => trim($info['filename']), 'size' => octdec($info['size']), 'type' => self::TYPES[$info['typeflag']] ?? null, ]; if (($info['typeflag'] == 0) || ($info['typeflag'] == 0x30) || ($info['typeflag'] == 0x35)) { // File or folder. $file['data'] = $contents; $mode = hexdec(substr($info['mode'], 4, 3)); $file['attr'] = (($info['typeflag'] == 0x35) ? 'd' : '-') . (($mode & 0x400) ? 'r' : '-') . (($mode & 0x200) ? 'w' : '-') . (($mode & 0x100) ? 'x' : '-') . (($mode & 0x040) ? 'r' : '-') . (($mode & 0x020) ? 'w' : '-') . (($mode & 0x010) ? 'x' : '-') . (($mode & 0x004) ? 'r' : '-') . (($mode & 0x002) ? 'w' : '-') . (($mode & 0x001) ? 'x' : '-'); } elseif (\chr($info['typeflag']) == 'L' && $info['filename'] == '././@LongLink') { // GNU tar ././@LongLink support - the filename is actually in the contents, set a variable here so we can test in the next loop $longlinkfilename = $contents; // And the file contents are in the next block so we'll need to skip this continue; } $returnArray[] = $file; } } $this->metadata = $returnArray; } /** * Check if a path is below a given destination path * * @param string $destination The destination path * @param string $path The path to be checked * * @return boolean * * @since 2.0.1 */ private function isBelow($destination, $path): bool { $absoluteRoot = Path::clean(Path::resolve($destination)); $absolutePath = Path::clean(Path::resolve($path)); return strpos($absolutePath, $absoluteRoot) === 0; } } PK c�\}�� archive/src/Gzip.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive; use Joomla\Filesystem\File; use Joomla\Filesystem\Stream; /** * Gzip format adapter for the Archive package * * This class is inspired from and draws heavily in code and concept from the Compress package of * The Horde Project <http://www.horde.org> * * @contributor Michael Slusarz <slusarz@horde.org> * @contributor Michael Cochrane <mike@graftonhall.co.nz> * * @since 1.0 */ class Gzip implements ExtractableInterface { /** * Gzip file flags. * * @var array * @since 1.0 */ private const FLAGS = ['FTEXT' => 0x01, 'FHCRC' => 0x02, 'FEXTRA' => 0x04, 'FNAME' => 0x08, 'FCOMMENT' => 0x10]; /** * Gzip file data buffer * * @var string * @since 1.0 */ private $data; /** * Holds the options array. * * @var array|\ArrayAccess * @since 1.0 */ protected $options = []; /** * Create a new Archive object. * * @param array|\ArrayAccess $options An array of options * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct($options = []) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->options = $options; } /** * Extract a Gzip compressed file to a given path * * @param string $archive Path to ZIP archive to extract * @param string $destination Path to extract archive to * * @return boolean True if successful * * @since 1.0 * @throws \RuntimeException */ public function extract($archive, $destination) { $this->data = null; if (!isset($this->options['use_streams']) || $this->options['use_streams'] == false) { $this->data = file_get_contents($archive); if (!$this->data) { throw new \RuntimeException('Unable to read archive'); } $position = $this->getFilePosition(); $buffer = gzinflate(substr($this->data, $position, \strlen($this->data) - $position)); if (empty($buffer)) { throw new \RuntimeException('Unable to decompress data'); } if (!File::write($destination, $buffer)) { throw new \RuntimeException('Unable to write archive to file ' . $destination); } } else { // New style! streams! $input = Stream::getStream(); // Use gz $input->set('processingmethod', 'gz'); if (!$input->open($archive)) { throw new \RuntimeException('Unable to read archive'); } $output = Stream::getStream(); if (!$output->open($destination, 'w')) { $input->close(); throw new \RuntimeException('Unable to open file "' . $destination . '" for writing'); } do { $this->data = $input->read($input->get('chunksize', 8196)); if ($this->data) { if (!$output->write($this->data)) { $input->close(); throw new \RuntimeException('Unable to write archive to file ' . $destination); } } } while ($this->data); $output->close(); $input->close(); } return true; } /** * Tests whether this adapter can unpack files on this computer. * * @return boolean True if supported * * @since 1.0 */ public static function isSupported() { return \extension_loaded('zlib'); } /** * Get file data offset for archive * * @return integer Data position marker for archive * * @since 1.0 * @throws \RuntimeException */ public function getFilePosition() { // Gzipped file... unpack it first $position = 0; $info = @ unpack('CCM/CFLG/VTime/CXFL/COS', substr($this->data, $position + 2)); if (!$info) { throw new \RuntimeException('Unable to decompress data.'); } $position += 10; if ($info['FLG'] & self::FLAGS['FEXTRA']) { $XLEN = unpack('vLength', substr($this->data, $position + 0, 2)); $XLEN = $XLEN['Length']; $position += $XLEN + 2; } if ($info['FLG'] & self::FLAGS['FNAME']) { $filenamePos = strpos($this->data, "\x0", $position); $position = $filenamePos + 1; } if ($info['FLG'] & self::FLAGS['FCOMMENT']) { $commentPos = strpos($this->data, "\x0", $position); $position = $commentPos + 1; } if ($info['FLG'] & self::FLAGS['FHCRC']) { $hcrc = unpack('vCRC', substr($this->data, $position + 0, 2)); $hcrc = $hcrc['CRC']; $position += 2; } return $position; } } PK c�\�Ĝ��C �C archive/src/Zip.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive; use Joomla\Filesystem\File; use Joomla\Filesystem\Folder; use Joomla\Filesystem\Path; /** * ZIP format adapter for the Archive package * * The ZIP compression code is partially based on code from: * Eric Mueller <eric@themepark.com> * http://www.zend.com/codex.php?id=535&single=1 * * Deins125 <webmaster@atlant.ru> * http://www.zend.com/codex.php?id=470&single=1 * * The ZIP compression date code is partially based on code from * Peter Listiak <mlady@users.sourceforge.net> * * This class is inspired from and draws heavily in code and concept from the Compress package of * The Horde Project <http://www.horde.org> * * @contributor Chuck Hagenbuch <chuck@horde.org> * @contributor Michael Slusarz <slusarz@horde.org> * @contributor Michael Cochrane <mike@graftonhall.co.nz> * * @since 1.0 */ class Zip implements ExtractableInterface { /** * ZIP compression methods. * * @var array * @since 1.0 */ private const METHODS = [ 0x0 => 'None', 0x1 => 'Shrunk', 0x2 => 'Super Fast', 0x3 => 'Fast', 0x4 => 'Normal', 0x5 => 'Maximum', 0x6 => 'Imploded', 0x8 => 'Deflated', ]; /** * Beginning of central directory record. * * @var string * @since 1.0 */ private const CTRL_DIR_HEADER = "\x50\x4b\x01\x02"; /** * End of central directory record. * * @var string * @since 1.0 */ private const CTRL_DIR_END = "\x50\x4b\x05\x06\x00\x00\x00\x00"; /** * Beginning of file contents. * * @var string * @since 1.0 */ private const FILE_HEADER = "\x50\x4b\x03\x04"; /** * ZIP file data buffer * * @var string * @since 1.0 */ private $data; /** * ZIP file metadata array * * @var array * @since 1.0 */ private $metadata; /** * Holds the options array. * * @var array|\ArrayAccess * @since 1.0 */ protected $options = []; /** * Create a new Archive object. * * @param array|\ArrayAccess $options An array of options or an object that implements \ArrayAccess * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct($options = []) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->options = $options; } /** * Create a ZIP compressed file from an array of file data. * * @param string $archive Path to save archive. * @param array $files Array of files to add to archive. * * @return boolean True if successful. * * @since 1.0 * @todo Finish Implementation */ public function create($archive, $files) { $contents = []; $ctrldir = []; foreach ($files as $file) { $this->addToZipFile($file, $contents, $ctrldir); } return $this->createZipFile($contents, $ctrldir, $archive); } /** * Extract a ZIP compressed file to a given path * * @param string $archive Path to ZIP archive to extract * @param string $destination Path to extract archive into * * @return boolean True if successful * * @since 1.0 * @throws \RuntimeException */ public function extract($archive, $destination) { if (!is_file($archive)) { throw new \RuntimeException('Archive does not exist at ' . $archive); } if (static::hasNativeSupport()) { return $this->extractNative($archive, $destination); } return $this->extractCustom($archive, $destination); } /** * Tests whether this adapter can unpack files on this computer. * * @return boolean True if supported * * @since 1.0 */ public static function isSupported() { return self::hasNativeSupport() || \extension_loaded('zlib'); } /** * Method to determine if the server has native zip support for faster handling * * @return boolean True if php has native ZIP support * * @since 1.0 */ public static function hasNativeSupport() { return \extension_loaded('zip'); } /** * Checks to see if the data is a valid ZIP file. * * @param string $data ZIP archive data buffer. * * @return boolean True if valid, false if invalid. * * @since 1.0 */ public function checkZipData($data) { return strpos($data, self::FILE_HEADER) !== false; } /** * Extract a ZIP compressed file to a given path using a php based algorithm that only requires zlib support * * @param string $archive Path to ZIP archive to extract. * @param string $destination Path to extract archive into. * * @return boolean True if successful * * @since 1.0 * @throws \RuntimeException */ protected function extractCustom($archive, $destination) { $this->metadata = null; $this->data = file_get_contents($archive); if (!$this->data) { throw new \RuntimeException('Unable to read archive'); } if (!$this->readZipInfo($this->data)) { throw new \RuntimeException('Get ZIP Information failed'); } foreach ($this->metadata as $i => $metadata) { $lastPathCharacter = substr($metadata['name'], -1, 1); if ($lastPathCharacter !== '/' && $lastPathCharacter !== '\\') { $buffer = $this->getFileData($i); $path = Path::clean($destination . '/' . $metadata['name']); if (!$this->isBelow($destination, $destination . '/' . $metadata['name'])) { throw new \OutOfBoundsException('Unable to write outside of destination path', 100); } // Make sure the destination folder exists if (!Folder::create(\dirname($path))) { throw new \RuntimeException('Unable to create destination folder'); } if (!File::write($path, $buffer)) { throw new \RuntimeException('Unable to write file'); } } } return true; } /** * Extract a ZIP compressed file to a given path using native php api calls for speed * * @param string $archive Path to ZIP archive to extract * @param string $destination Path to extract archive into * * @return boolean True on success * * @throws \RuntimeException * @since 1.0 */ protected function extractNative($archive, $destination) { $zip = new \ZipArchive; if ($zip->open($archive) !== true) { throw new \RuntimeException('Unable to open archive'); } // Make sure the destination folder exists if (!Folder::create($destination)) { throw new \RuntimeException('Unable to create destination folder ' . \dirname($destination)); } // Read files in the archive for ($index = 0; $index < $zip->numFiles; $index++) { $file = $zip->getNameIndex($index); if (substr($file, -1) === '/') { continue; } $buffer = $zip->getFromIndex($index); if ($buffer === false) { throw new \RuntimeException('Unable to read ZIP entry'); } if (!$this->isBelow($destination, $destination . '/' . $file)) { throw new \RuntimeException('Unable to write outside of destination path', 100); } if (File::write($destination . '/' . $file, $buffer) === false) { throw new \RuntimeException('Unable to write ZIP entry to file ' . $destination . '/' . $file); } } $zip->close(); return true; } /** * Get the list of files/data from a ZIP archive buffer. * * <pre> * KEY: Position in zipfile * VALUES: 'attr' -- File attributes * 'crc' -- CRC checksum * 'csize' -- Compressed file size * 'date' -- File modification time * 'name' -- Filename * 'method'-- Compression method * 'size' -- Original file size * 'type' -- File type * </pre> * * @param string $data The ZIP archive buffer. * * @return boolean True on success * * @since 1.0 * @throws \RuntimeException */ private function readZipInfo($data) { $entries = []; // Find the last central directory header entry $fhLast = strpos($data, self::CTRL_DIR_END); do { $last = $fhLast; } while (($fhLast = strpos($data, self::CTRL_DIR_END, $fhLast + 1)) !== false); // Find the central directory offset $offset = 0; if ($last) { $endOfCentralDirectory = unpack( 'vNumberOfDisk/vNoOfDiskWithStartOfCentralDirectory/vNoOfCentralDirectoryEntriesOnDisk/' . 'vTotalCentralDirectoryEntries/VSizeOfCentralDirectory/VCentralDirectoryOffset/vCommentLength', substr($data, $last + 4) ); $offset = $endOfCentralDirectory['CentralDirectoryOffset']; } // Get details from central directory structure. $fhStart = strpos($data, self::CTRL_DIR_HEADER, $offset); $dataLength = \strlen($data); do { if ($dataLength < $fhStart + 31) { throw new \RuntimeException('Invalid ZIP Data'); } $info = unpack('vMethod/VTime/VCRC32/VCompressed/VUncompressed/vLength', substr($data, $fhStart + 10, 20)); $name = substr($data, $fhStart + 46, $info['Length']); $entries[$name] = [ 'attr' => null, 'crc' => sprintf('%08s', dechex($info['CRC32'])), 'csize' => $info['Compressed'], 'date' => null, '_dataStart' => null, 'name' => $name, 'method' => self::METHODS[$info['Method']], '_method' => $info['Method'], 'size' => $info['Uncompressed'], 'type' => null, ]; $entries[$name]['date'] = mktime( ($info['Time'] >> 11) & 0x1f, ($info['Time'] >> 5) & 0x3f, ($info['Time'] << 1) & 0x3e, ($info['Time'] >> 21) & 0x07, ($info['Time'] >> 16) & 0x1f, (($info['Time'] >> 25) & 0x7f) + 1980 ); if ($dataLength < $fhStart + 43) { throw new \RuntimeException('Invalid ZIP data'); } $info = unpack('vInternal/VExternal/VOffset', substr($data, $fhStart + 36, 10)); $entries[$name]['type'] = ($info['Internal'] & 0x01) ? 'text' : 'binary'; $entries[$name]['attr'] = (($info['External'] & 0x10) ? 'D' : '-') . (($info['External'] & 0x20) ? 'A' : '-') . (($info['External'] & 0x03) ? 'S' : '-') . (($info['External'] & 0x02) ? 'H' : '-') . (($info['External'] & 0x01) ? 'R' : '-'); $entries[$name]['offset'] = $info['Offset']; // Get details from local file header since we have the offset $lfhStart = strpos($data, self::FILE_HEADER, $entries[$name]['offset']); if ($dataLength < $lfhStart + 34) { throw new \RuntimeException('Invalid ZIP Data'); } $info = unpack('vMethod/VTime/VCRC32/VCompressed/VUncompressed/vLength/vExtraLength', substr($data, $lfhStart + 8, 25)); $name = substr($data, $lfhStart + 30, $info['Length']); $entries[$name]['_dataStart'] = $lfhStart + 30 + $info['Length'] + $info['ExtraLength']; // Bump the max execution time because not using the built in php zip libs makes this process slow. @set_time_limit(ini_get('max_execution_time')); } while (($fhStart = strpos($data, self::CTRL_DIR_HEADER, $fhStart + 46)) !== false); $this->metadata = array_values($entries); return true; } /** * Returns the file data for a file by offset in the ZIP archive * * @param integer $key The position of the file in the archive. * * @return string Uncompressed file data buffer. * * @since 1.0 */ private function getFileData(int $key): string { if ($this->metadata[$key]['_method'] == 0x8) { return gzinflate(substr($this->data, $this->metadata[$key]['_dataStart'], $this->metadata[$key]['csize'])); } if ($this->metadata[$key]['_method'] == 0x0) { // Files that aren't compressed. return substr($this->data, $this->metadata[$key]['_dataStart'], $this->metadata[$key]['csize']); } if ($this->metadata[$key]['_method'] == 0x12) { // If bz2 extension is loaded use it if (\extension_loaded('bz2')) { return bzdecompress(substr($this->data, $this->metadata[$key]['_dataStart'], $this->metadata[$key]['csize'])); } } return ''; } /** * 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. * * @since 1.0 */ protected function unix2DosTime($unixtime = null) { $timearray = $unixtime === null ? 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); } /** * Adds a "file" to the ZIP archive. * * @param array $file File data array to add * @param array $contents An array of existing zipped files. * @param array $ctrldir An array of central directory information. * * @return void * * @since 1.0 * @todo Review and finish implementation */ private function addToZipFile(array &$file, array &$contents, array &$ctrldir): void { $data = &$file['data']; $name = str_replace('\\', '/', $file['name']); // See if time/date information has been provided. $ftime = null; if (isset($file['time'])) { $ftime = $file['time']; } // Get the hex time. $dtime = dechex($this->unix2DosTime($ftime)); $hexdtime = \chr(hexdec($dtime[6] . $dtime[7])) . \chr(hexdec($dtime[4] . $dtime[5])) . \chr(hexdec($dtime[2] . $dtime[3])) . \chr(hexdec($dtime[0] . $dtime[1])); // Begin creating the ZIP data. $fr = self::FILE_HEADER; // Version needed to extract. $fr .= "\x14\x00"; // General purpose bit flag. $fr .= "\x00\x00"; // Compression method. $fr .= "\x08\x00"; // Last modification time/date. $fr .= $hexdtime; // "Local file header" segment. $uncLen = \strlen($data); $crc = crc32($data); $zdata = gzcompress($data); $zdata = substr(substr($zdata, 0, -4), 2); $cLen = \strlen($zdata); // CRC 32 information. $fr .= pack('V', $crc); // Compressed filesize. $fr .= pack('V', $cLen); // Uncompressed filesize. $fr .= pack('V', $uncLen); // Length of filename. $fr .= pack('v', \strlen($name)); // Extra field length. $fr .= pack('v', 0); // File name. $fr .= $name; // "File data" segment. $fr .= $zdata; // Add this entry to array. $oldOffset = \strlen(implode('', $contents)); $contents[] = &$fr; // Add to central directory record. $cdrec = self::CTRL_DIR_HEADER; // Version made by. $cdrec .= "\x00\x00"; // Version needed to extract $cdrec .= "\x14\x00"; // General purpose bit flag $cdrec .= "\x00\x00"; // Compression method $cdrec .= "\x08\x00"; // Last mod time/date. $cdrec .= $hexdtime; // CRC 32 information. $cdrec .= pack('V', $crc); // Compressed filesize. $cdrec .= pack('V', $cLen); // Uncompressed filesize. $cdrec .= pack('V', $uncLen); // Length of filename. $cdrec .= pack('v', \strlen($name)); // Extra field length. $cdrec .= pack('v', 0); // File comment length. $cdrec .= pack('v', 0); // Disk number start. $cdrec .= pack('v', 0); // Internal file attributes. $cdrec .= pack('v', 0); // External file attributes -'archive' bit set. $cdrec .= pack('V', 32); // Relative offset of local header. $cdrec .= pack('V', $oldOffset); // File name. $cdrec .= $name; // Save to central directory array. $ctrldir[] = &$cdrec; } /** * Creates the ZIP file. * * Official ZIP file format: http://www.pkware.com/appnote.txt * * @param array $contents An array of existing zipped files. * @param array $ctrlDir An array of central directory information. * @param string $path The path to store the archive. * * @return boolean True if successful * * @since 1.0 * @todo Review and finish implementation */ private function createZipFile(array $contents, array $ctrlDir, string $path): bool { $data = implode('', $contents); $dir = implode('', $ctrlDir); /* * Buffer data: * Total # of entries "on this disk". * Total # of entries overall. * Size of central directory. * Offset to start of central dir. * ZIP file comment length. */ $buffer = $data . $dir . self::CTRL_DIR_END . pack('v', \count($ctrlDir)) . pack('v', \count($ctrlDir)) . pack('V', \strlen($dir)) . pack('V', \strlen($data)) . "\x00\x00"; return File::write($path, $buffer); } /** * Check if a path is below a given destination path * * @param string $destination The destination path * @param string $path The path to be checked * * @return boolean * * @since 1.1.10 */ private function isBelow($destination, $path): bool { $absoluteRoot = Path::clean(Path::resolve($destination)); $absolutePath = Path::clean(Path::resolve($path)); return strpos($absolutePath, $absoluteRoot) === 0; } } PK c�\�muE3 3 5 archive/src/Exception/UnsupportedArchiveException.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive\Exception; /** * Exception class defining an unsupported archive adapter * * @since 2.0.0 */ class UnsupportedArchiveException extends \InvalidArgumentException { /** * The unsupported archive adapter name * * @var string * @since 2.0.0-beta2 */ protected $adapterType = ''; /** * Constructor * * @param string $adapterType The unsupported adapter type. * @param string $message The Exception message to throw. * @param int $code The Exception code. * @param ?\Throwable $previous The previous throwable used for the exception chaining. * * @since 2.0.0-beta2 */ public function __construct(string $adapterType, string $message = '', int $code = 0, ?\Throwable $previous = null) { $this->adapterType = $adapterType; parent::__construct($message, $code, $previous); } /** * Gets the name of the adapter type that was unsupported * * @return string * * @since 2.0.0-beta2 */ public function getUnsupportedAdapterType(): string { return $this->adapterType; } } PK c�\�c +� � 1 archive/src/Exception/UnknownArchiveException.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive\Exception; /** * Exception class defining an unknown archive type * * @since 2.0.0 */ class UnknownArchiveException extends \InvalidArgumentException { } PK c�\�M�� � archive/src/Archive.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive; use Joomla\Archive\Exception\UnknownArchiveException; use Joomla\Archive\Exception\UnsupportedArchiveException; use Joomla\Filesystem\File; use Joomla\Filesystem\Folder; /** * An Archive handling class * * @since 1.0 */ class Archive { /** * The array of instantiated archive adapters. * * @var ExtractableInterface[] * @since 1.0 */ protected $adapters = []; /** * Holds the options array. * * @var array|\ArrayAccess * @since 1.0 */ public $options = []; /** * Create a new Archive object. * * @param array|\ArrayAccess $options An array of options * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct($options = []) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } // Make sure we have a tmp directory. isset($options['tmp_path']) || $options['tmp_path'] = realpath(sys_get_temp_dir()); $this->options = $options; } /** * Extract an archive file to a directory. * * @param string $archivename The name of the archive file * @param string $extractdir Directory to unpack into * * @return boolean True for success * * @since 1.0 * @throws UnknownArchiveException if the archive type is not supported */ public function extract($archivename, $extractdir) { $ext = pathinfo($archivename, \PATHINFO_EXTENSION); $path = pathinfo($archivename, \PATHINFO_DIRNAME); $filename = pathinfo($archivename, \PATHINFO_FILENAME); switch (strtolower($ext)) { case 'zip': $result = $this->getAdapter('zip')->extract($archivename, $extractdir); break; case 'tar': $result = $this->getAdapter('tar')->extract($archivename, $extractdir); break; case 'tgz': case 'gz': case 'gzip': // This may just be an individual file (e.g. sql script) $tmpfname = $this->options['tmp_path'] . '/' . uniqid('gzip'); try { $this->getAdapter('gzip')->extract($archivename, $tmpfname); } catch (\RuntimeException $exception) { @unlink($tmpfname); return false; } if ($ext === 'tgz' || stripos($filename, '.tar') !== false) { $result = $this->getAdapter('tar')->extract($tmpfname, $extractdir); } else { Folder::create($extractdir); $result = File::copy($tmpfname, $extractdir . '/' . $filename, null, false); } @unlink($tmpfname); break; case 'tbz2': case 'bz2': case 'bzip2': // This may just be an individual file (e.g. sql script) $tmpfname = $this->options['tmp_path'] . '/' . uniqid('bzip2'); try { $this->getAdapter('bzip2')->extract($archivename, $tmpfname); } catch (\RuntimeException $exception) { @unlink($tmpfname); return false; } if ($ext === 'tbz2' || stripos($filename, '.tar') !== false) { $result = $this->getAdapter('tar')->extract($tmpfname, $extractdir); } else { Folder::create($extractdir); $result = File::copy($tmpfname, $extractdir . '/' . $filename, null, false); } @unlink($tmpfname); break; default: throw new UnknownArchiveException(sprintf('Unsupported archive type: %s', $ext)); } return $result; } /** * Method to override the provided adapter with your own implementation. * * @param string $type Name of the adapter to set. * @param string $class FQCN of your class which implements ExtractableInterface. * @param boolean $override True to force override the adapter type. * * @return $this * * @since 1.0 * @throws UnsupportedArchiveException if the adapter type is not supported */ public function setAdapter($type, $class, $override = true) { if ($override || !isset($this->adapters[$type])) { if (!\is_object($class) && !class_exists($class)) { throw new UnsupportedArchiveException($type, sprintf('Archive adapter "%s" (class "%s") not found.', $type, $class)); } if (!$class::isSupported()) { throw new UnsupportedArchiveException($type, sprintf('Archive adapter "%s" (class "%s") not supported.', $type, $class)); } $object = new $class($this->options); if (!($object instanceof ExtractableInterface)) { throw new UnsupportedArchiveException( $type, sprintf( 'The provided adapter "%s" (class "%s") must implement %s', $type, $class, ExtractableInterface::class ) ); } $this->adapters[$type] = $object; } return $this; } /** * Get a file compression adapter. * * @param string $type The type of adapter (bzip2|gzip|tar|zip). * * @return ExtractableInterface Adapter for the requested type * * @since 1.0 */ public function getAdapter($type) { $type = strtolower($type); if (!isset($this->adapters[$type])) { // Try to load the adapter object $this->setAdapter($type, __NAMESPACE__ . '\\' . ucfirst($type)); } return $this->adapters[$type]; } } PK c�\� ��W W $ archive/src/ExtractableInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive; /** * Archive class interface * * @since 1.0 */ interface ExtractableInterface { /** * Extract a compressed file to a given path * * @param string $archive Path to archive to extract * @param string $destination Path to extract archive to * * @return boolean True if successful * * @since 1.0 * @throws \RuntimeException */ public function extract($archive, $destination); /** * Tests whether this adapter can unpack files on this computer. * * @return boolean True if supported * * @since 1.0 */ public static function isSupported(); } PK c�\ �� archive/src/Bzip2.phpnu �[��� <?php /** * Part of the Joomla Framework Archive Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Archive; use Joomla\Filesystem\File; use Joomla\Filesystem\Stream; /** * Bzip2 format adapter for the Archive package * * @since 1.0 */ class Bzip2 implements ExtractableInterface { /** * Bzip2 file data buffer * * @var string * @since 1.0 */ private $data; /** * Holds the options array. * * @var array|\ArrayAccess * @since 1.0 */ protected $options = []; /** * Create a new Archive object. * * @param array|\ArrayAccess $options An array of options * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct($options = []) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->options = $options; } /** * Extract a Bzip2 compressed file to a given path * * @param string $archive Path to Bzip2 archive to extract * @param string $destination Path to extract archive to * * @return boolean True if successful * * @since 1.0 * @throws \RuntimeException */ public function extract($archive, $destination) { $this->data = null; if (!isset($this->options['use_streams']) || $this->options['use_streams'] == false) { // Old style: read the whole file and then parse it $this->data = file_get_contents($archive); if (!$this->data) { throw new \RuntimeException('Unable to read archive'); } $buffer = bzdecompress($this->data); unset($this->data); if (empty($buffer)) { throw new \RuntimeException('Unable to decompress data'); } if (!File::write($destination, $buffer)) { throw new \RuntimeException('Unable to write archive to file ' . $destination); } } else { // New style! streams! $input = Stream::getStream(); // Use bzip $input->set('processingmethod', 'bz'); if (!$input->open($archive)) { throw new \RuntimeException('Unable to read archive'); } $output = Stream::getStream(); if (!$output->open($destination, 'w')) { $input->close(); throw new \RuntimeException('Unable to open file "' . $destination . '" for writing'); } do { $this->data = $input->read($input->get('chunksize', 8196)); if ($this->data) { if (!$output->write($this->data)) { $input->close(); throw new \RuntimeException('Unable to write archive to file ' . $destination); } } } while ($this->data); $output->close(); $input->close(); } return true; } /** * Tests whether this adapter can unpack files on this computer. * * @return boolean True if supported * * @since 1.0 */ public static function isSupported() { return \extension_loaded('bz2'); } } PK c�\�P�E �E archive/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\0�|� � ) router/src/Command/DebugRouterCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Router Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Router\Command; use Joomla\Console\Command\AbstractCommand; use Joomla\Router\RouterInterface; use Symfony\Component\Console\Helper\TableCell; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Input\InputOption; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Style\SymfonyStyle; /** * Command listing information about the application's router. * * @since 2.0.0 */ class DebugRouterCommand extends AbstractCommand { /** * The default command name * * @var string * @since 2.0.0 */ protected static $defaultName = 'debug:router'; /** * The application router. * * @var RouterInterface * @since 2.0.0 */ private $router; /** * Instantiate the command. * * @param RouterInterface $router The application router. * * @since 2.0.0 */ public function __construct(RouterInterface $router) { $this->router = $router; parent::__construct(); } /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { $this->setDescription("Displays information about the application's routes"); $this->addOption('show-controllers', null, InputOption::VALUE_NONE, 'Show the controller for a route in the overview'); $this->setHelp(<<<'EOF' The <info>%command.name%</info> command lists all of the application's routes: <info>php %command.full_name%</info> To show the controllers that handle each route, use the <info>--show-controllers</info> option: <info>php %command.full_name% --show-controllers</info> EOF ); } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ protected function doExecute(InputInterface $input, OutputInterface $output): int { $io = new SymfonyStyle($input, $output); $showControllers = $input->getOption('show-controllers'); $io->title(sprintf('%s Router Information', $this->getApplication()->getName())); if (empty($this->router->getRoutes())) { $io->warning('The router has no routes.'); return 0; } $tableHeaders = [ 'Methods', 'Pattern', 'Rules', ]; $tableRows = []; if ($showControllers) { $tableHeaders[] = 'Controller'; } foreach ($this->router->getRoutes() as $route) { $row = []; $row[] = $route->getMethods() ? implode('|', $route->getMethods()) : 'ANY'; $row[] = $route->getPattern(); $rules = $route->getRules(); if (empty($rules)) { $row[] = 'N/A'; } else { ksort($rules); $rulesAsString = ''; foreach ($rules as $key => $value) { $rulesAsString .= sprintf("%s: %s\n", $key, $this->formatValue($value)); } $row[] = new TableCell(rtrim($rulesAsString), ['rowspan' => count($rules)]); } if ($showControllers) { $row[] = $this->formatCallable($route->getController()); } $tableRows[] = $row; } $io->table($tableHeaders, $tableRows); return 0; } /** * Formats a callable resource to be displayed in the console output * * @param callable $callable A callable resource to format * * @return string * * @since 2.0.0 * @throws \ReflectionException * @note This method is based on \Symfony\Bundle\FrameworkBundle\Console\Descriptor\TextDescriptor::formatCallable() */ private function formatCallable($callable): string { if (\is_array($callable)) { if (\is_object($callable[0])) { return sprintf('%s::%s()', \get_class($callable[0]), $callable[1]); } return sprintf('%s::%s()', $callable[0], $callable[1]); } if (\is_string($callable)) { return sprintf('%s()', $callable); } if ($callable instanceof \Closure) { $r = new \ReflectionFunction($callable); if (strpos($r->name, '{closure}') !== false) { return 'Closure()'; } if ($class = $r->getClosureScopeClass()) { return sprintf('%s::%s()', $class->name, $r->name); } return $r->name . '()'; } if (method_exists($callable, '__invoke')) { return sprintf('%s::__invoke()', \get_class($callable)); } throw new \InvalidArgumentException('Callable is not describable.'); } /** * Formats a value as string. * * @param mixed $value A value to format * * @return string * * @since 2.0.0 * @note This method is based on \Symfony\Bundle\FrameworkBundle\Console\Descriptor\Descriptor::formatValue() */ private function formatValue($value): string { if (\is_object($value)) { return sprintf('object(%s)', \get_class($value)); } if (\is_string($value)) { return $value; } return preg_replace("/\n\s*/s", '', var_export($value, true)); } } PK c�\��W* * router/src/Router.phpnu �[��� <?php /** * Part of the Joomla Framework Router Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Router; /** * A path router. * * @since 1.0 */ class Router implements RouterInterface, \Serializable { /** * An array of Route objects defining the supported paths. * * @var Route[] * @since 2.0.0 */ protected $routes = []; /** * Constructor. * * @param Route[]|array[] $routes A list of route maps or Route objects to add to the router. * * @since 1.0 */ public function __construct(array $routes = []) { if (!empty($routes)) { $this->addRoutes($routes); } } /** * Add a route to the router. * * @param Route $route The route definition * * @return $this * * @since 2.0.0 */ public function addRoute(Route $route): RouterInterface { $this->routes[] = $route; return $this; } /** * Add an array of route maps or objects to the router. * * @param Route[]|array[] $routes A list of route maps or Route objects to add to the router. * * @return $this * * @since 2.0.0 * @throws \UnexpectedValueException If missing the `pattern` or `controller` keys from the mapping array. */ public function addRoutes(array $routes): RouterInterface { foreach ($routes as $route) { if ($route instanceof Route) { $this->addRoute($route); } else { // Ensure a `pattern` key exists if (! array_key_exists('pattern', $route)) { throw new \UnexpectedValueException('Route map must contain a pattern variable.'); } // Ensure a `controller` key exists if (! array_key_exists('controller', $route)) { throw new \UnexpectedValueException('Route map must contain a controller variable.'); } // If defaults, rules have been specified, add them as well. $defaults = $route['defaults'] ?? []; $rules = $route['rules'] ?? []; $methods = $route['methods'] ?? ['GET']; $this->addRoute(new Route($methods, $route['pattern'], $route['controller'], $rules, $defaults)); } } return $this; } /** * Get the routes registered with this router. * * @return Route[] * * @since 2.0.0 */ public function getRoutes(): array { return $this->routes; } /** * Parse the given route and return the information about the route, including the controller assigned to the route. * * @param string $route The route string for which to find and execute a controller. * @param string $method Request method to match, should be a valid HTTP request method. * * @return ResolvedRoute * * @since 1.0 * @throws Exception\MethodNotAllowedException if the route was found but does not support the request method * @throws Exception\RouteNotFoundException if the route was not found */ public function parseRoute($route, $method = 'GET') { $method = strtoupper($method); // Get the path from the route and remove and leading or trailing slash. $route = trim(parse_url($route, PHP_URL_PATH), ' /'); // Iterate through all of the known routes looking for a match. foreach ($this->routes as $rule) { if (preg_match($rule->getRegex(), $route, $matches)) { // Check if the route supports this method if (!empty($rule->getMethods()) && !\in_array($method, $rule->getMethods())) { throw new Exception\MethodNotAllowedException( array_unique($rule->getMethods()), sprintf('Route `%s` does not support `%s` requests.', $route, strtoupper($method)), 405 ); } // If we have gotten this far then we have a positive match. $vars = $rule->getDefaults(); foreach ($rule->getRouteVariables() as $i => $var) { $vars[$var] = $matches[$i + 1]; } return new ResolvedRoute($rule->getController(), $vars, $route); } } throw new Exception\RouteNotFoundException(sprintf('Unable to handle request for route `%s`.', $route), 404); } /** * Add a GET route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function get(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['GET'], $pattern, $controller, $rules, $defaults)); } /** * Add a POST route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function post(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['POST'], $pattern, $controller, $rules, $defaults)); } /** * Add a PUT route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function put(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['PUT'], $pattern, $controller, $rules, $defaults)); } /** * Add a DELETE route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function delete(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['DELETE'], $pattern, $controller, $rules, $defaults)); } /** * Add a HEAD route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function head(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['HEAD'], $pattern, $controller, $rules, $defaults)); } /** * Add a OPTIONS route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function options(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['OPTIONS'], $pattern, $controller, $rules, $defaults)); } /** * Add a TRACE route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function trace(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['TRACE'], $pattern, $controller, $rules, $defaults)); } /** * Add a PATCH route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function patch(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route(['PATCH'], $pattern, $controller, $rules, $defaults)); } /** * Add a route to the router that accepts all request methods. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function all(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface { return $this->addRoute(new Route([], $pattern, $controller, $rules, $defaults)); } /** * Serialize the router. * * @return string The serialized router. * * @since 2.0.0 */ public function serialize() { return serialize($this->__serialize()); } /** * Serialize the router. * * @return array The data to be serialized * * @since 2.0.0 */ public function __serialize() { return [ 'routes' => $this->routes, ]; } /** * Unserialize the router. * * @param string $serialized The serialized router. * * @return void * * @since 2.0.0 */ public function unserialize($serialized) { $this->__unserialize(unserialize($serialized)); } /** * Unserialize the router. * * @param array $data The serialized router. * * @return void * * @since 2.0.0 */ public function __unserialize(array $data) { $this->routes = $data['routes']; } } PK c�\��;�# �# router/src/Route.phpnu �[��� <?php /** * Part of the Joomla Framework Router Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Router; use SuperClosure\SerializableClosure; /** * An object representing a route definition. * * @since 2.0.0 */ class Route implements \Serializable { /** * The controller which handles this route * * @var mixed * @since 2.0.0 */ private $controller; /** * The default variables defined by the route * * @var array * @since 2.0.0 */ private $defaults = []; /** * The HTTP methods this route supports * * @var string[] * @since 2.0.0 */ private $methods; /** * The route pattern to use for matching * * @var string * @since 2.0.0 */ private $pattern; /** * The path regex this route processes * * @var string * @since 2.0.0 */ private $regex; /** * The variables defined by the route * * @var array * @since 2.0.0 */ private $routeVariables = []; /** * An array of regex rules keyed using the route variables * * @var array * @since 2.0.0 */ private $rules = []; /** * Constructor. * * @param array $methods The HTTP methods this route supports * @param string $pattern The route pattern to use for matching * @param mixed $controller The controller which handles this route * @param array $rules An array of regex rules keyed using the route variables * @param array $defaults The default variables defined by the route * * @since 2.0.0 */ public function __construct(array $methods, string $pattern, $controller, array $rules = [], array $defaults = []) { $this->setMethods($methods); $this->setPattern($pattern); $this->setController($controller); $this->setRules($rules); $this->setDefaults($defaults); } /** * Parse the route's pattern to extract the named variables and build a proper regular expression for use when parsing the routes. * * @return void * * @since 2.0.0 */ protected function buildRegexAndVarList(): void { // Sanitize and explode the pattern. $pattern = explode('/', trim(parse_url($this->getPattern(), PHP_URL_PATH), ' /')); // Prepare the route variables $vars = []; // Initialize regular expression $regex = []; // Loop on each segment foreach ($pattern as $segment) { if ($segment == '*') { // Match a splat with no variable. $regex[] = '.*'; } elseif (isset($segment[0]) && $segment[0] == '*') { // Match a splat and capture the data to a named variable. $vars[] = substr($segment, 1); $regex[] = '(.*)'; } elseif (isset($segment[0]) && $segment[0] == '\\' && $segment[1] == '*') { // Match an escaped splat segment. $regex[] = '\*' . preg_quote(substr($segment, 2)); } elseif ($segment == ':') { // Match an unnamed variable without capture. $regex[] = '([^/]*)'; } elseif (isset($segment[0]) && $segment[0] == ':') { // Match a named variable and capture the data. $varName = substr($segment, 1); $vars[] = $varName; // Use the regex in the rules array if it has been defined. $regex[] = array_key_exists($varName, $this->getRules()) ? '(' . $this->getRules()[$varName] . ')' : '([^/]*)'; } elseif (isset($segment[0]) && $segment[0] == '\\' && $segment[1] == ':') { // Match a segment with an escaped variable character prefix. $regex[] = preg_quote(substr($segment, 1)); } else { // Match the standard segment. $regex[] = preg_quote($segment); } } $this->setRegex(\chr(1) . '^' . implode('/', $regex) . '$' . \chr(1)); $this->setRouteVariables($vars); } /** * Retrieve the controller which handles this route * * @return mixed * * @since 2.0.0 */ public function getController() { return $this->controller; } /** * Retrieve the default variables defined by the route * * @return array * * @since 2.0.0 */ public function getDefaults(): array { return $this->defaults; } /** * Retrieve the HTTP methods this route supports * * @return string[] * * @since 2.0.0 */ public function getMethods(): array { return $this->methods; } /** * Retrieve the route pattern to use for matching * * @return string * * @since 2.0.0 */ public function getPattern(): string { return $this->pattern; } /** * Retrieve the path regex this route processes * * @return string * * @since 2.0.0 */ public function getRegex(): string { if (!$this->regex) { $this->buildRegexAndVarList(); } return $this->regex; } /** * Retrieve the variables defined by the route * * @return array * * @since 2.0.0 */ public function getRouteVariables(): array { if (!$this->regex) { $this->buildRegexAndVarList(); } return $this->routeVariables; } /** * Retrieve the regex rules keyed using the route variables * * @return array * * @since 2.0.0 */ public function getRules(): array { return $this->rules; } /** * Set the controller which handles this route * * @param mixed $controller The controller which handles this route * * @return $this * * @since 2.0.0 */ public function setController($controller): self { $this->controller = $controller; return $this; } /** * Set the default variables defined by the route * * @param array $defaults The default variables defined by the route * * @return $this * * @since 2.0.0 */ public function setDefaults(array $defaults): self { $this->defaults = $defaults; return $this; } /** * Set the HTTP methods this route supports * * @param array $methods The HTTP methods this route supports * * @return $this * * @since 2.0.0 */ public function setMethods(array $methods): self { $this->methods = $this->methods = array_map('strtoupper', $methods); return $this; } /** * Set the route pattern to use for matching * * @param string $pattern The route pattern to use for matching * * @return $this * * @since 2.0.0 */ public function setPattern(string $pattern): self { $this->pattern = $pattern; $this->setRegex(''); $this->setRouteVariables([]); return $this; } /** * Set the path regex this route processes * * @param string $regex The path regex this route processes * * @return $this * * @since 2.0.0 */ public function setRegex(string $regex): self { $this->regex = $regex; return $this; } /** * Set the variables defined by the route * * @param array $routeVariables The variables defined by the route * * @return $this * * @since 2.0.0 */ public function setRouteVariables(array $routeVariables): self { $this->routeVariables = $routeVariables; return $this; } /** * Set the regex rules keyed using the route variables * * @param array $rules The rules defined by the route * * @return $this * * @since 2.0.0 */ public function setRules(array $rules): self { $this->rules = $rules; return $this; } /** * Serialize the route. * * @return string The serialized route. * * @since 2.0.0 */ public function serialize() { return serialize($this->__serialize()); } /** * Serialize the route. * * @return array The data to be serialized * * @since 2.0.0 */ public function __serialize() { $controller = $this->getController(); if ($controller instanceof \Closure) { if (!class_exists(SerializableClosure::class)) { throw new \RuntimeException( \sprintf( 'Cannot serialize the route for pattern "%s" because the controller is a Closure. ' . 'Install the "jeremeamia/superclosure" package to serialize Closures.', $this->getPattern() ) ); } $controller = new SerializableClosure($controller); } return [ 'controller' => $controller, 'defaults' => $this->getDefaults(), 'methods' => $this->getMethods(), 'pattern' => $this->getPattern(), 'regex' => $this->getRegex(), 'routeVariables' => $this->getRouteVariables(), 'rules' => $this->getRules(), ]; } /** * Unserialize the route. * * @param string $serialized The serialized route. * * @return void * * @since 1.0 */ public function unserialize($serialized) { $this->__unserialize(unserialize($serialized)); } /** * Unserialize the route. * * @param array $data The serialized route. * * @return void * * @since 2.0.0 */ public function __unserialize(array $data) { $this->controller = $data['controller']; $this->defaults = $data['defaults']; $this->methods = $data['methods']; $this->pattern = $data['pattern']; $this->regex = $data['regex']; $this->routeVariables = $data['routeVariables']; $this->rules = $data['rules']; } } PK c�\7; � 2 router/src/Exception/MethodNotAllowedException.phpnu �[��� <?php /** * Part of the Joomla Framework Router Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Router\Exception; /** * Exception defining a method not allowed error. * * @since 2.0.0 */ class MethodNotAllowedException extends \RuntimeException { /** * Allowed methods for the given route * * @var string[] * @since 2.0.0 */ protected $allowedMethods = []; /** * Constructor. * * @param array $allowedMethods The allowed methods for the route. * @param null $message The Exception message to throw. * @param integer $code The Exception code. * @param \Exception $previous The previous throwable used for the exception chaining. */ public function __construct(array $allowedMethods, $message = null, $code = 405, \Exception $previous = null) { $this->allowedMethods = array_map('strtoupper', $allowedMethods); parent::__construct($message, $code, $previous); } /** * Gets the allowed HTTP methods. * * @return array * * @since 2.0.0 */ public function getAllowedMethods(): array { return $this->allowedMethods; } } PK c�\�F��� � / router/src/Exception/RouteNotFoundException.phpnu �[��� <?php /** * Part of the Joomla Framework Router Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Router\Exception; /** * Exception defining a route not found error. * * @since 2.0.0 */ class RouteNotFoundException extends \InvalidArgumentException { } PK c�\��{ { router/src/ResolvedRoute.phpnu �[��� <?php /** * Part of the Joomla Framework Router Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Router; /** * An object representing a resolved route. * * @since 2.0.0 */ class ResolvedRoute { /** * The controller which handles this route * * @var mixed * @since 2.0.0 */ private $controller; /** * The variables matched by the route * * @var array * @since 2.0.0 */ private $routeVariables; /** * The URI for this route * * @var string * @since 2.0.0 */ private $uri; /** * Constructor. * * @param mixed $controller The controller which handles this route * @param array $routeVariables The variables matched by the route * @param string $uri The URI for this route * * @since 2.0.0 */ public function __construct($controller, array $routeVariables, string $uri) { $this->controller = $controller; $this->routeVariables = $routeVariables; $this->uri = $uri; } /** * Retrieve the controller which handles this route * * @return mixed * * @since 2.0.0 */ public function getController() { return $this->controller; } /** * Retrieve the variables matched by the route * * @return array * * @since 2.0.0 */ public function getRouteVariables(): array { return $this->routeVariables; } /** * Retrieve the URI for this route * * @return string * * @since 2.0.0 */ public function getUri(): string { return $this->uri; } } PK c�\~�z router/src/RouterInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Router Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Router; /** * Interface defining a HTTP path router. * * @since 2.0.0 */ interface RouterInterface { /** * Add a route to the router. * * @param Route $route The route definition * * @return $this * * @since 2.0.0 */ public function addRoute(Route $route): RouterInterface; /** * Add an array of route maps or objects to the router. * * @param Route[]|array[] $routes A list of route maps or Route objects to add to the router. * * @return $this * * @since 2.0.0 * @throws \UnexpectedValueException If missing the `pattern` or `controller` keys from the mapping array. */ public function addRoutes(array $routes): RouterInterface; /** * Get the routes registered with this router. * * @return Route[] * * @since 2.0.0 */ public function getRoutes(): array; /** * Parse the given route and return the information about the route, including the controller assigned to the route. * * @param string $route The route string for which to find and execute a controller. * @param string $method Request method to match, should be a valid HTTP request method. * * @return ResolvedRoute * * @since 2.0.0 * @throws Exception\MethodNotAllowedException if the route was found but does not support the request method * @throws Exception\RouteNotFoundException if the route was not found */ public function parseRoute($route, $method = 'GET'); /** * Add a GET route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function get(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a POST route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function post(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a PUT route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function put(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a DELETE route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function delete(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a HEAD route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function head(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a OPTIONS route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function options(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a TRACE route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function trace(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a PATCH route to the router. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function patch(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; /** * Add a route to the router that accepts all request methods. * * @param string $pattern The route pattern to use for matching. * @param mixed $controller The controller to map to the given pattern. * @param array $rules An array of regex rules keyed using the route variables. * @param array $defaults An array of default values that are used when the URL is matched. * * @return $this * * @since 2.0.0 */ public function all(string $pattern, $controller, array $rules = [], array $defaults = []): RouterInterface; } PK c�\�P�E �E router/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�+�m� � router/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\Bh=�o o router/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: 7dd98a782649ccbc790762f84661b7689088a042067a97c395e8cd9e02cc6e80 ... PK c�\�+�m� � string/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\��^�� � string/src/Inflector.phpnu �[��� <?php /** * Part of the Joomla Framework String Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\String; use Doctrine\Common\Inflector\Inflector as DoctrineInflector; /** * Joomla Framework String Inflector Class * * The Inflector transforms words * * @since 1.0 */ class Inflector extends DoctrineInflector { /** * The singleton instance. * * @var Inflector * @since 1.0 * @deprecated 3.0 */ private static $instance; /** * The inflector rules for countability. * * @var array * @since 2.0.0 */ private static $countable = [ 'rules' => [ 'id', 'hits', 'clicks', ], ]; /** * Adds inflection regex rules to the inflector. * * @param mixed $data A string or an array of strings or regex rules to add. * @param string $ruleType The rule type: singular | plural | countable * * @return void * * @since 1.0 * @throws \InvalidArgumentException */ private function addRule($data, string $ruleType) { if (\is_string($data)) { $data = [$data]; } elseif (!\is_array($data)) { throw new \InvalidArgumentException('Invalid inflector rule data.'); } elseif (!\in_array($ruleType, ['singular', 'plural', 'countable'])) { throw new \InvalidArgumentException('Unsupported rule type.'); } if ($ruleType === 'countable') { foreach ($data as $rule) { // Ensure a string is pushed. array_push(self::$countable['rules'], (string) $rule); } } else { static::rules($ruleType, $data); } } /** * Adds a countable word. * * @param mixed $data A string or an array of strings to add. * * @return $this * * @since 1.0 */ public function addCountableRule($data) { $this->addRule($data, 'countable'); return $this; } /** * Adds a specific singular-plural pair for a word. * * @param string $singular The singular form of the word. * @param string $plural The plural form of the word. If omitted, it is assumed the singular and plural are identical. * * @return $this * * @since 1.0 * @deprecated 3.0 Use Doctrine\Common\Inflector\Inflector::rules() instead. */ public function addWord($singular, $plural = '') { trigger_deprecation( 'joomla/string', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::rules() instead.', __METHOD__, DoctrineInflector::class ); if ($plural !== '') { static::rules( 'plural', [ 'irregular' => [$plural => $singular], ] ); static::rules( 'singular', [ 'irregular' => [$singular => $plural], ] ); } else { static::rules( 'plural', [ 'uninflected' => [$singular], ] ); static::rules( 'singular', [ 'uninflected' => [$singular], ] ); } return $this; } /** * Adds a pluralisation rule. * * @param mixed $data A string or an array of regex rules to add. * * @return $this * * @since 1.0 * @deprecated 3.0 Use Doctrine\Common\Inflector\Inflector::rules() instead. */ public function addPluraliseRule($data) { trigger_deprecation( 'joomla/string', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::rules() instead.', __METHOD__, DoctrineInflector::class ); $this->addRule($data, 'plural'); return $this; } /** * Adds a singularisation rule. * * @param mixed $data A string or an array of regex rules to add. * * @return $this * * @since 1.0 * @deprecated 3.0 Use Doctrine\Common\Inflector\Inflector::rules() instead. */ public function addSingulariseRule($data) { trigger_deprecation( 'joomla/string', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::rules() instead.', __METHOD__, DoctrineInflector::class ); $this->addRule($data, 'singular'); return $this; } /** * Gets an instance of the Inflector singleton. * * @param boolean $new If true (default is false), returns a new instance regardless if one exists. This argument is mainly used for testing. * * @return static * * @since 1.0 * @deprecated 3.0 Use static methods without a class instance instead. */ public static function getInstance($new = false) { trigger_deprecation( 'joomla/string', '2.0.0', '%s() is deprecated and will be removed in 3.0.', __METHOD__ ); if ($new) { return new static; } if (!\is_object(self::$instance)) { self::$instance = new static; } return self::$instance; } /** * Checks if a word is countable. * * @param string $word The string input. * * @return boolean True if word is countable, false otherwise. * * @since 1.0 */ public function isCountable($word) { return \in_array($word, self::$countable['rules']); } /** * Checks if a word is in a plural form. * * @param string $word The string input. * * @return boolean True if word is plural, false if not. * * @since 1.0 */ public function isPlural($word) { return $this->toPlural($this->toSingular($word)) === $word; } /** * Checks if a word is in a singular form. * * @param string $word The string input. * * @return boolean True if word is singular, false if not. * * @since 1.0 */ public function isSingular($word) { return $this->toSingular($word) === $word; } /** * Converts a word into its plural form. * * @param string $word The singular word to pluralise. * * @return string The word in plural form. * * @since 1.0 * @deprecated 3.0 Use Doctrine\Common\Inflector\Inflector::pluralize() instead. */ public function toPlural($word) { trigger_deprecation( 'joomla/string', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::pluralize() instead.', __METHOD__, DoctrineInflector::class ); return static::pluralize($word); } /** * Converts a word into its singular form. * * @param string $word The plural word to singularise. * * @return string The word in singular form. * * @since 1.0 * @deprecated 3.0 Use Doctrine\Common\Inflector\Inflector::singularize() instead. */ public function toSingular($word) { trigger_deprecation( 'joomla/string', '2.0.0', '%s() is deprecated and will be removed in 3.0, use %s::singularize() instead.', __METHOD__, DoctrineInflector::class ); return static::singularize($word); } } PK c�\:a �_ _ string/src/phputf8/strspn.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to strspn * Find length of initial segment matching mask * Note: requires utf8_strlen and utf8_substr (if start, length are used) * @param string * @return int * @see http://www.php.net/strspn * @package utf8 */ function utf8_strspn($str, $mask, $start = NULL, $length = NULL) { $mask = preg_replace('!([\\\\\\-\\]\\[/^])!','\\\${1}',$mask); // Fix for $start but no $length argument. if ($start !== null && $length === null) { $length = utf8_strlen($str); } if ( $start !== NULL || $length !== NULL ) { $str = utf8_substr($str, $start, $length); } preg_match('/^['.$mask.']+/u',$str, $matches); if ( isset($matches[0]) ) { return utf8_strlen($matches[0]); } return 0; } PK c�\OX5� � ! string/src/phputf8/strcasecmp.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to strcasecmp * A case insensivite string comparison * Note: requires utf8_strtolower * @param string * @param string * @return int * @see http://www.php.net/strcasecmp * @see utf8_strtolower * @package utf8 */ function utf8_strcasecmp($strX, $strY) { $strX = utf8_strtolower($strX); $strY = utf8_strtolower($strY); return strcmp($strX, $strY); } PK c�\���R R string/src/phputf8/trim.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware replacement for ltrim() * Note: you only need to use this if you are supplying the charlist * optional arg and it contains UTF-8 characters. Otherwise ltrim will * work normally on a UTF-8 string * @author Andreas Gohr <andi@splitbrain.org> * @see http://www.php.net/ltrim * @see http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php * @return string * @package utf8 */ function utf8_ltrim( $str, $charlist = FALSE ) { if($charlist === FALSE) return ltrim($str); //quote charlist for use in a characterclass $charlist = preg_replace('!([\\\\\\-\\]\\[/^])!','\\\${1}',$charlist); return preg_replace('/^['.$charlist.']+/u','',$str); } //--------------------------------------------------------------- /** * UTF-8 aware replacement for rtrim() * Note: you only need to use this if you are supplying the charlist * optional arg and it contains UTF-8 characters. Otherwise rtrim will * work normally on a UTF-8 string * @author Andreas Gohr <andi@splitbrain.org> * @see http://www.php.net/rtrim * @see http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php * @return string * @package utf8 */ function utf8_rtrim( $str, $charlist = FALSE ) { if($charlist === FALSE) return rtrim($str); //quote charlist for use in a characterclass $charlist = preg_replace('!([\\\\\\-\\]\\[/^])!','\\\${1}',$charlist); return preg_replace('/['.$charlist.']+$/u','',$str); } //--------------------------------------------------------------- /** * UTF-8 aware replacement for trim() * Note: you only need to use this if you are supplying the charlist * optional arg and it contains UTF-8 characters. Otherwise trim will * work normally on a UTF-8 string * @author Andreas Gohr <andi@splitbrain.org> * @see http://www.php.net/trim * @see http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php * @return string * @package utf8 */ function utf8_trim( $str, $charlist = FALSE ) { if($charlist === FALSE) return trim($str); return utf8_ltrim(utf8_rtrim($str, $charlist), $charlist); } PK c�\���� � string/src/phputf8/ucfirst.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to ucfirst * Make a string's first character uppercase * Note: requires utf8_strtoupper * @param string * @return string with first character as upper case (if applicable) * @see http://www.php.net/ucfirst * @see utf8_strtoupper * @package utf8 */ function utf8_ucfirst($str){ switch ( utf8_strlen($str) ) { case 0: return ''; break; case 1: return utf8_strtoupper($str); break; default: preg_match('/^(.{1})(.*)$/us', $str, $matches); return utf8_strtoupper($matches[1]).$matches[2]; break; } } PK c�\�uw w string/src/phputf8/str_pad.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * Replacement for str_pad. $padStr may contain multi-byte characters. * * @author Oliver Saunders <oliver (a) osinternetservices.com> * @param string $input * @param int $length * @param string $padStr * @param int $type ( same constants as str_pad ) * @return string * @see http://www.php.net/str_pad * @see utf8_substr * @package utf8 */ function utf8_str_pad($input, $length, $padStr = ' ', $type = STR_PAD_RIGHT) { $inputLen = utf8_strlen($input); if ($length <= $inputLen) { return $input; } $padStrLen = utf8_strlen($padStr); $padLen = $length - $inputLen; if ($type == STR_PAD_RIGHT) { $repeatTimes = ceil($padLen / $padStrLen); return utf8_substr($input . str_repeat($padStr, $repeatTimes), 0, $length); } if ($type == STR_PAD_LEFT) { $repeatTimes = ceil($padLen / $padStrLen); return utf8_substr(str_repeat($padStr, $repeatTimes), 0, floor($padLen)) . $input; } if ($type == STR_PAD_BOTH) { $padLen/= 2; $padAmountLeft = floor($padLen); $padAmountRight = ceil($padLen); $repeatTimesLeft = ceil($padAmountLeft / $padStrLen); $repeatTimesRight = ceil($padAmountRight / $padStrLen); $paddingLeft = utf8_substr(str_repeat($padStr, $repeatTimesLeft), 0, $padAmountLeft); $paddingRight = utf8_substr(str_repeat($padStr, $repeatTimesRight), 0, $padAmountLeft); return $paddingLeft . $input . $paddingRight; } trigger_error('utf8_str_pad: Unknown padding type (' . $type . ')',E_USER_ERROR); } PK c�\��� 2 2 % string/src/phputf8/substr_replace.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware substr_replace. * Note: requires utf8_substr to be loaded * @see http://www.php.net/substr_replace * @see utf8_strlen * @see utf8_substr */ function utf8_substr_replace($str, $repl, $start , $length = NULL ) { preg_match_all('/./us', $str, $ar); preg_match_all('/./us', $repl, $rar); if( $length === NULL ) { $length = utf8_strlen($str); } array_splice( $ar[0], $start, $length, $rar[0] ); return join('',$ar[0]); } PK c�\��)-B B string/src/phputf8/strcspn.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to strcspn * Find length of initial segment not matching mask * Note: requires utf8_strlen and utf8_substr (if start, length are used) * @param string * @return int * @see http://www.php.net/strcspn * @see utf8_strlen * @package utf8 */ function utf8_strcspn($str, $mask, $start = NULL, $length = NULL) { if ( empty($mask) || strlen($mask) == 0 ) { return NULL; } $mask = preg_replace('!([\\\\\\-\\]\\[/^])!','\\\${1}',$mask); if ( $start !== NULL || $length !== NULL ) { $str = utf8_substr($str, $start, $length); } preg_match('/^[^'.$mask.']+/u',$str, $matches); if ( isset($matches[0]) ) { return utf8_strlen($matches[0]); } return 0; } PK c�\@���� � # string/src/phputf8/str_ireplace.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to str_ireplace * Case-insensitive version of str_replace * Note: requires utf8_strtolower * Note: it's not fast and gets slower if $search / $replace is array * Notes: it's based on the assumption that the lower and uppercase * versions of a UTF-8 character will have the same length in bytes * which is currently true given the hash table to strtolower * @param string * @return string * @see http://www.php.net/str_ireplace * @see utf8_strtolower * @package utf8 */ function utf8_ireplace($search, $replace, $str, $count = NULL){ if ( !is_array($search) ) { $slen = strlen($search); if ( $slen == 0 ) { return $str; } $lendif = strlen($replace) - strlen($search); $search = utf8_strtolower($search); $search = preg_quote($search, '/'); $lstr = utf8_strtolower($str); $i = 0; $matched = 0; while ( preg_match('/(.*)'.$search.'/Us',$lstr, $matches) ) { if ( $i === $count ) { break; } $mlen = strlen($matches[0]); $lstr = substr($lstr, $mlen); $str = substr_replace($str, $replace, $matched+strlen($matches[1]), $slen); $matched += $mlen + $lendif; $i++; } return $str; } else { foreach ( array_keys($search) as $k ) { if ( is_array($replace) ) { if ( array_key_exists($k,$replace) ) { $str = utf8_ireplace($search[$k], $replace[$k], $str, $count); } else { $str = utf8_ireplace($search[$k], '', $str, $count); } } else { $str = utf8_ireplace($search[$k], $replace, $str, $count); } } return $str; } } PK c�\�^�� � string/src/phputf8/str_split.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to str_split * Convert a string to an array * Note: requires utf8_strlen to be loaded * @param string UTF-8 encoded * @param int number to characters to split string by * @return string characters in string reverses * @see http://www.php.net/str_split * @see utf8_strlen * @package utf8 */ function utf8_str_split($str, $split_len = 1) { if ( !preg_match('/^[0-9]+$/',$split_len) || $split_len < 1 ) { return FALSE; } $len = utf8_strlen($str); if ( $len <= $split_len ) { return array($str); } preg_match_all('/.{'.$split_len.'}|[^\x00]{1,'.$split_len.'}$/us', $str, $ar); return $ar[0]; } PK c�\�h�w�A �A " string/src/phputf8/native/core.phpnu �[��� <?php /** * @package utf8 */ /** * Define UTF8_CORE as required */ if ( !defined('UTF8_CORE') ) { define('UTF8_CORE',TRUE); } //-------------------------------------------------------------------- /** * Unicode aware replacement for strlen(). Returns the number * of characters in the string (not the number of bytes), replacing * multibyte characters with a single byte equivalent * utf8_decode() converts characters that are not in ISO-8859-1 * to '?', which, for the purpose of counting, is alright - It's * much faster than iconv_strlen * Note: this function does not count bad UTF-8 bytes in the string * - these are simply ignored * @author <chernyshevsky at hotmail dot com> * @link http://www.php.net/manual/en/function.strlen.php * @link http://www.php.net/manual/en/function.utf8-decode.php * @param string UTF-8 string * @return int number of UTF-8 characters in string * @package utf8 */ function utf8_strlen($str){ return strlen(utf8_decode($str)); } //-------------------------------------------------------------------- /** * UTF-8 aware alternative to strpos * Find position of first occurrence of a string * Note: This will get alot slower if offset is used * Note: requires utf8_strlen amd utf8_substr to be loaded * @param string haystack * @param string needle (you should validate this with utf8_is_valid) * @param integer offset in characters (from left) * @return mixed integer position or FALSE on failure * @see http://www.php.net/strpos * @see utf8_strlen * @see utf8_substr * @package utf8 */ function utf8_strpos($str, $needle, $offset = NULL) { if ( is_null($offset) ) { $ar = explode($needle, $str, 2); if ( count($ar) > 1 ) { return utf8_strlen($ar[0]); } return FALSE; } else { if ( !is_int($offset) ) { trigger_error('utf8_strpos: Offset must be an integer',E_USER_ERROR); return FALSE; } $str = utf8_substr($str, $offset); if ( FALSE !== ( $pos = utf8_strpos($str, $needle) ) ) { return $pos + $offset; } return FALSE; } } //-------------------------------------------------------------------- /** * UTF-8 aware alternative to strrpos * Find position of last occurrence of a char in a string * Note: This will get alot slower if offset is used * Note: requires utf8_substr and utf8_strlen to be loaded * @param string haystack * @param string needle (you should validate this with utf8_is_valid) * @param integer (optional) offset (from left) * @return mixed integer position or FALSE on failure * @see http://www.php.net/strrpos * @see utf8_substr * @see utf8_strlen * @package utf8 */ function utf8_strrpos($str, $needle, $offset = NULL) { if ( is_null($offset) ) { $ar = explode($needle, $str); if ( count($ar) > 1 ) { // Pop off the end of the string where the last match was made array_pop($ar); $str = join($needle,$ar); return utf8_strlen($str); } return FALSE; } else { if ( !is_int($offset) ) { trigger_error('utf8_strrpos expects parameter 3 to be long',E_USER_WARNING); return FALSE; } $str = utf8_substr($str, $offset); if ( FALSE !== ( $pos = utf8_strrpos($str, $needle) ) ) { return $pos + $offset; } return FALSE; } } //-------------------------------------------------------------------- /** * UTF-8 aware alternative to substr * Return part of a string given character offset (and optionally length) * * Note arguments: comparied to substr - if offset or length are * not integers, this version will not complain but rather massages them * into an integer. * * Note on returned values: substr documentation states false can be * returned in some cases (e.g. offset > string length) * mb_substr never returns false, it will return an empty string instead. * This adopts the mb_substr approach * * Note on implementation: PCRE only supports repetitions of less than * 65536, in order to accept up to MAXINT values for offset and length, * we'll repeat a group of 65535 characters when needed. * * Note on implementation: calculating the number of characters in the * string is a relatively expensive operation, so we only carry it out when * necessary. It isn't necessary for +ve offsets and no specified length * * @author Chris Smith<chris@jalakai.co.uk> * @param string * @param integer number of UTF-8 characters offset (from left) * @param integer (optional) length in UTF-8 characters from offset * @return mixed string or FALSE if failure * @package utf8 */ function utf8_substr($str, $offset, $length = NULL) { // generates E_NOTICE // for PHP4 objects, but not PHP5 objects $str = (string)$str; $offset = (int)$offset; if (!is_null($length)) $length = (int)$length; // handle trivial cases if ($length === 0) return ''; if ($offset < 0 && $length < 0 && $length < $offset) return ''; // normalise negative offsets (we could use a tail // anchored pattern, but they are horribly slow!) if ($offset < 0) { // see notes $strlen = strlen(utf8_decode($str)); $offset = $strlen + $offset; if ($offset < 0) $offset = 0; } $Op = ''; $Lp = ''; // establish a pattern for offset, a // non-captured group equal in length to offset if ($offset > 0) { $Ox = (int)($offset/65535); $Oy = $offset%65535; if ($Ox) { $Op = '(?:.{65535}){'.$Ox.'}'; } $Op = '^(?:'.$Op.'.{'.$Oy.'})'; } else { // offset == 0; just anchor the pattern $Op = '^'; } // establish a pattern for length if (is_null($length)) { // the rest of the string $Lp = '(.*)$'; } else { if (!isset($strlen)) { // see notes $strlen = strlen(utf8_decode($str)); } // another trivial case if ($offset > $strlen) return ''; if ($length > 0) { // reduce any length that would // go passed the end of the string $length = min($strlen-$offset, $length); $Lx = (int)( $length / 65535 ); $Ly = $length % 65535; // negative length requires a captured group // of length characters if ($Lx) $Lp = '(?:.{65535}){'.$Lx.'}'; $Lp = '('.$Lp.'.{'.$Ly.'})'; } else if ($length < 0) { if ( $length < ($offset - $strlen) ) { return ''; } $Lx = (int)((-$length)/65535); $Ly = (-$length)%65535; // negative length requires ... capture everything // except a group of -length characters // anchored at the tail-end of the string if ($Lx) $Lp = '(?:.{65535}){'.$Lx.'}'; $Lp = '(.*)(?:'.$Lp.'.{'.$Ly.'})$'; } } if (!preg_match( '#'.$Op.$Lp.'#us',$str, $match )) { return ''; } return $match[1]; } //--------------------------------------------------------------- /** * UTF-8 aware alternative to strtolower * Make a string lowercase * Note: The concept of a characters "case" only exists is some alphabets * such as Latin, Greek, Cyrillic, Armenian and archaic Georgian - it does * not exist in the Chinese alphabet, for example. See Unicode Standard * Annex #21: Case Mappings * Note: requires utf8_to_unicode and utf8_from_unicode * @author Andreas Gohr <andi@splitbrain.org> * @param string * @return mixed either string in lowercase or FALSE is UTF-8 invalid * @see http://www.php.net/strtolower * @see utf8_to_unicode * @see utf8_from_unicode * @see http://www.unicode.org/reports/tr21/tr21-5.html * @see http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php * @package utf8 */ function utf8_strtolower($string){ static $UTF8_UPPER_TO_LOWER = NULL; if ( is_null($UTF8_UPPER_TO_LOWER) ) { $UTF8_UPPER_TO_LOWER = array( 0x0041=>0x0061, 0x03A6=>0x03C6, 0x0162=>0x0163, 0x00C5=>0x00E5, 0x0042=>0x0062, 0x0139=>0x013A, 0x00C1=>0x00E1, 0x0141=>0x0142, 0x038E=>0x03CD, 0x0100=>0x0101, 0x0490=>0x0491, 0x0394=>0x03B4, 0x015A=>0x015B, 0x0044=>0x0064, 0x0393=>0x03B3, 0x00D4=>0x00F4, 0x042A=>0x044A, 0x0419=>0x0439, 0x0112=>0x0113, 0x041C=>0x043C, 0x015E=>0x015F, 0x0143=>0x0144, 0x00CE=>0x00EE, 0x040E=>0x045E, 0x042F=>0x044F, 0x039A=>0x03BA, 0x0154=>0x0155, 0x0049=>0x0069, 0x0053=>0x0073, 0x1E1E=>0x1E1F, 0x0134=>0x0135, 0x0427=>0x0447, 0x03A0=>0x03C0, 0x0418=>0x0438, 0x00D3=>0x00F3, 0x0420=>0x0440, 0x0404=>0x0454, 0x0415=>0x0435, 0x0429=>0x0449, 0x014A=>0x014B, 0x0411=>0x0431, 0x0409=>0x0459, 0x1E02=>0x1E03, 0x00D6=>0x00F6, 0x00D9=>0x00F9, 0x004E=>0x006E, 0x0401=>0x0451, 0x03A4=>0x03C4, 0x0423=>0x0443, 0x015C=>0x015D, 0x0403=>0x0453, 0x03A8=>0x03C8, 0x0158=>0x0159, 0x0047=>0x0067, 0x00C4=>0x00E4, 0x0386=>0x03AC, 0x0389=>0x03AE, 0x0166=>0x0167, 0x039E=>0x03BE, 0x0164=>0x0165, 0x0116=>0x0117, 0x0108=>0x0109, 0x0056=>0x0076, 0x00DE=>0x00FE, 0x0156=>0x0157, 0x00DA=>0x00FA, 0x1E60=>0x1E61, 0x1E82=>0x1E83, 0x00C2=>0x00E2, 0x0118=>0x0119, 0x0145=>0x0146, 0x0050=>0x0070, 0x0150=>0x0151, 0x042E=>0x044E, 0x0128=>0x0129, 0x03A7=>0x03C7, 0x013D=>0x013E, 0x0422=>0x0442, 0x005A=>0x007A, 0x0428=>0x0448, 0x03A1=>0x03C1, 0x1E80=>0x1E81, 0x016C=>0x016D, 0x00D5=>0x00F5, 0x0055=>0x0075, 0x0176=>0x0177, 0x00DC=>0x00FC, 0x1E56=>0x1E57, 0x03A3=>0x03C3, 0x041A=>0x043A, 0x004D=>0x006D, 0x016A=>0x016B, 0x0170=>0x0171, 0x0424=>0x0444, 0x00CC=>0x00EC, 0x0168=>0x0169, 0x039F=>0x03BF, 0x004B=>0x006B, 0x00D2=>0x00F2, 0x00C0=>0x00E0, 0x0414=>0x0434, 0x03A9=>0x03C9, 0x1E6A=>0x1E6B, 0x00C3=>0x00E3, 0x042D=>0x044D, 0x0416=>0x0436, 0x01A0=>0x01A1, 0x010C=>0x010D, 0x011C=>0x011D, 0x00D0=>0x00F0, 0x013B=>0x013C, 0x040F=>0x045F, 0x040A=>0x045A, 0x00C8=>0x00E8, 0x03A5=>0x03C5, 0x0046=>0x0066, 0x00DD=>0x00FD, 0x0043=>0x0063, 0x021A=>0x021B, 0x00CA=>0x00EA, 0x0399=>0x03B9, 0x0179=>0x017A, 0x00CF=>0x00EF, 0x01AF=>0x01B0, 0x0045=>0x0065, 0x039B=>0x03BB, 0x0398=>0x03B8, 0x039C=>0x03BC, 0x040C=>0x045C, 0x041F=>0x043F, 0x042C=>0x044C, 0x00DE=>0x00FE, 0x00D0=>0x00F0, 0x1EF2=>0x1EF3, 0x0048=>0x0068, 0x00CB=>0x00EB, 0x0110=>0x0111, 0x0413=>0x0433, 0x012E=>0x012F, 0x00C6=>0x00E6, 0x0058=>0x0078, 0x0160=>0x0161, 0x016E=>0x016F, 0x0391=>0x03B1, 0x0407=>0x0457, 0x0172=>0x0173, 0x0178=>0x00FF, 0x004F=>0x006F, 0x041B=>0x043B, 0x0395=>0x03B5, 0x0425=>0x0445, 0x0120=>0x0121, 0x017D=>0x017E, 0x017B=>0x017C, 0x0396=>0x03B6, 0x0392=>0x03B2, 0x0388=>0x03AD, 0x1E84=>0x1E85, 0x0174=>0x0175, 0x0051=>0x0071, 0x0417=>0x0437, 0x1E0A=>0x1E0B, 0x0147=>0x0148, 0x0104=>0x0105, 0x0408=>0x0458, 0x014C=>0x014D, 0x00CD=>0x00ED, 0x0059=>0x0079, 0x010A=>0x010B, 0x038F=>0x03CE, 0x0052=>0x0072, 0x0410=>0x0430, 0x0405=>0x0455, 0x0402=>0x0452, 0x0126=>0x0127, 0x0136=>0x0137, 0x012A=>0x012B, 0x038A=>0x03AF, 0x042B=>0x044B, 0x004C=>0x006C, 0x0397=>0x03B7, 0x0124=>0x0125, 0x0218=>0x0219, 0x00DB=>0x00FB, 0x011E=>0x011F, 0x041E=>0x043E, 0x1E40=>0x1E41, 0x039D=>0x03BD, 0x0106=>0x0107, 0x03AB=>0x03CB, 0x0426=>0x0446, 0x00DE=>0x00FE, 0x00C7=>0x00E7, 0x03AA=>0x03CA, 0x0421=>0x0441, 0x0412=>0x0432, 0x010E=>0x010F, 0x00D8=>0x00F8, 0x0057=>0x0077, 0x011A=>0x011B, 0x0054=>0x0074, 0x004A=>0x006A, 0x040B=>0x045B, 0x0406=>0x0456, 0x0102=>0x0103, 0x039B=>0x03BB, 0x00D1=>0x00F1, 0x041D=>0x043D, 0x038C=>0x03CC, 0x00C9=>0x00E9, 0x00D0=>0x00F0, 0x0407=>0x0457, 0x0122=>0x0123, ); } $uni = utf8_to_unicode($string); if ( !$uni ) { return FALSE; } $cnt = count($uni); for ($i=0; $i < $cnt; $i++){ if ( isset($UTF8_UPPER_TO_LOWER[$uni[$i]]) ) { $uni[$i] = $UTF8_UPPER_TO_LOWER[$uni[$i]]; } } return utf8_from_unicode($uni); } //--------------------------------------------------------------- /** * UTF-8 aware alternative to strtoupper * Make a string uppercase * Note: The concept of a characters "case" only exists is some alphabets * such as Latin, Greek, Cyrillic, Armenian and archaic Georgian - it does * not exist in the Chinese alphabet, for example. See Unicode Standard * Annex #21: Case Mappings * Note: requires utf8_to_unicode and utf8_from_unicode * @author Andreas Gohr <andi@splitbrain.org> * @param string * @return mixed either string in lowercase or FALSE is UTF-8 invalid * @see http://www.php.net/strtoupper * @see utf8_to_unicode * @see utf8_from_unicode * @see http://www.unicode.org/reports/tr21/tr21-5.html * @see http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php * @package utf8 */ function utf8_strtoupper($string){ static $UTF8_LOWER_TO_UPPER = NULL; if ( is_null($UTF8_LOWER_TO_UPPER) ) { $UTF8_LOWER_TO_UPPER = array( 0x0061=>0x0041, 0x03C6=>0x03A6, 0x0163=>0x0162, 0x00E5=>0x00C5, 0x0062=>0x0042, 0x013A=>0x0139, 0x00E1=>0x00C1, 0x0142=>0x0141, 0x03CD=>0x038E, 0x0101=>0x0100, 0x0491=>0x0490, 0x03B4=>0x0394, 0x015B=>0x015A, 0x0064=>0x0044, 0x03B3=>0x0393, 0x00F4=>0x00D4, 0x044A=>0x042A, 0x0439=>0x0419, 0x0113=>0x0112, 0x043C=>0x041C, 0x015F=>0x015E, 0x0144=>0x0143, 0x00EE=>0x00CE, 0x045E=>0x040E, 0x044F=>0x042F, 0x03BA=>0x039A, 0x0155=>0x0154, 0x0069=>0x0049, 0x0073=>0x0053, 0x1E1F=>0x1E1E, 0x0135=>0x0134, 0x0447=>0x0427, 0x03C0=>0x03A0, 0x0438=>0x0418, 0x00F3=>0x00D3, 0x0440=>0x0420, 0x0454=>0x0404, 0x0435=>0x0415, 0x0449=>0x0429, 0x014B=>0x014A, 0x0431=>0x0411, 0x0459=>0x0409, 0x1E03=>0x1E02, 0x00F6=>0x00D6, 0x00F9=>0x00D9, 0x006E=>0x004E, 0x0451=>0x0401, 0x03C4=>0x03A4, 0x0443=>0x0423, 0x015D=>0x015C, 0x0453=>0x0403, 0x03C8=>0x03A8, 0x0159=>0x0158, 0x0067=>0x0047, 0x00E4=>0x00C4, 0x03AC=>0x0386, 0x03AE=>0x0389, 0x0167=>0x0166, 0x03BE=>0x039E, 0x0165=>0x0164, 0x0117=>0x0116, 0x0109=>0x0108, 0x0076=>0x0056, 0x00FE=>0x00DE, 0x0157=>0x0156, 0x00FA=>0x00DA, 0x1E61=>0x1E60, 0x1E83=>0x1E82, 0x00E2=>0x00C2, 0x0119=>0x0118, 0x0146=>0x0145, 0x0070=>0x0050, 0x0151=>0x0150, 0x044E=>0x042E, 0x0129=>0x0128, 0x03C7=>0x03A7, 0x013E=>0x013D, 0x0442=>0x0422, 0x007A=>0x005A, 0x0448=>0x0428, 0x03C1=>0x03A1, 0x1E81=>0x1E80, 0x016D=>0x016C, 0x00F5=>0x00D5, 0x0075=>0x0055, 0x0177=>0x0176, 0x00FC=>0x00DC, 0x1E57=>0x1E56, 0x03C3=>0x03A3, 0x043A=>0x041A, 0x006D=>0x004D, 0x016B=>0x016A, 0x0171=>0x0170, 0x0444=>0x0424, 0x00EC=>0x00CC, 0x0169=>0x0168, 0x03BF=>0x039F, 0x006B=>0x004B, 0x00F2=>0x00D2, 0x00E0=>0x00C0, 0x0434=>0x0414, 0x03C9=>0x03A9, 0x1E6B=>0x1E6A, 0x00E3=>0x00C3, 0x044D=>0x042D, 0x0436=>0x0416, 0x01A1=>0x01A0, 0x010D=>0x010C, 0x011D=>0x011C, 0x00F0=>0x00D0, 0x013C=>0x013B, 0x045F=>0x040F, 0x045A=>0x040A, 0x00E8=>0x00C8, 0x03C5=>0x03A5, 0x0066=>0x0046, 0x00FD=>0x00DD, 0x0063=>0x0043, 0x021B=>0x021A, 0x00EA=>0x00CA, 0x03B9=>0x0399, 0x017A=>0x0179, 0x00EF=>0x00CF, 0x01B0=>0x01AF, 0x0065=>0x0045, 0x03BB=>0x039B, 0x03B8=>0x0398, 0x03BC=>0x039C, 0x045C=>0x040C, 0x043F=>0x041F, 0x044C=>0x042C, 0x00FE=>0x00DE, 0x00F0=>0x00D0, 0x1EF3=>0x1EF2, 0x0068=>0x0048, 0x00EB=>0x00CB, 0x0111=>0x0110, 0x0433=>0x0413, 0x012F=>0x012E, 0x00E6=>0x00C6, 0x0078=>0x0058, 0x0161=>0x0160, 0x016F=>0x016E, 0x03B1=>0x0391, 0x0457=>0x0407, 0x0173=>0x0172, 0x00FF=>0x0178, 0x006F=>0x004F, 0x043B=>0x041B, 0x03B5=>0x0395, 0x0445=>0x0425, 0x0121=>0x0120, 0x017E=>0x017D, 0x017C=>0x017B, 0x03B6=>0x0396, 0x03B2=>0x0392, 0x03AD=>0x0388, 0x1E85=>0x1E84, 0x0175=>0x0174, 0x0071=>0x0051, 0x0437=>0x0417, 0x1E0B=>0x1E0A, 0x0148=>0x0147, 0x0105=>0x0104, 0x0458=>0x0408, 0x014D=>0x014C, 0x00ED=>0x00CD, 0x0079=>0x0059, 0x010B=>0x010A, 0x03CE=>0x038F, 0x0072=>0x0052, 0x0430=>0x0410, 0x0455=>0x0405, 0x0452=>0x0402, 0x0127=>0x0126, 0x0137=>0x0136, 0x012B=>0x012A, 0x03AF=>0x038A, 0x044B=>0x042B, 0x006C=>0x004C, 0x03B7=>0x0397, 0x0125=>0x0124, 0x0219=>0x0218, 0x00FB=>0x00DB, 0x011F=>0x011E, 0x043E=>0x041E, 0x1E41=>0x1E40, 0x03BD=>0x039D, 0x0107=>0x0106, 0x03CB=>0x03AB, 0x0446=>0x0426, 0x00FE=>0x00DE, 0x00E7=>0x00C7, 0x03CA=>0x03AA, 0x0441=>0x0421, 0x0432=>0x0412, 0x010F=>0x010E, 0x00F8=>0x00D8, 0x0077=>0x0057, 0x011B=>0x011A, 0x0074=>0x0054, 0x006A=>0x004A, 0x045B=>0x040B, 0x0456=>0x0406, 0x0103=>0x0102, 0x03BB=>0x039B, 0x00F1=>0x00D1, 0x043D=>0x041D, 0x03CC=>0x038C, 0x00E9=>0x00C9, 0x00F0=>0x00D0, 0x0457=>0x0407, 0x0123=>0x0122, ); } $uni = utf8_to_unicode($string); if ( !$uni ) { return FALSE; } $cnt = count($uni); for ($i=0; $i < $cnt; $i++){ if( isset($UTF8_LOWER_TO_UPPER[$uni[$i]]) ) { $uni[$i] = $UTF8_LOWER_TO_UPPER[$uni[$i]]; } } return utf8_from_unicode($uni); } PK c�\��(�� � $ string/src/phputf8/mbstring/core.phpnu �[��� <?php /** * @package utf8 */ /** * Define UTF8_CORE as required */ if ( !defined('UTF8_CORE') ) { define('UTF8_CORE',TRUE); } //-------------------------------------------------------------------- /** * Wrapper round mb_strlen * Assumes you have mb_internal_encoding to UTF-8 already * Note: this function does not count bad bytes in the string - these * are simply ignored * @param string UTF-8 string * @return int number of UTF-8 characters in string * @package utf8 */ function utf8_strlen($str){ return mb_strlen($str); } //-------------------------------------------------------------------- /** * Assumes mbstring internal encoding is set to UTF-8 * Wrapper around mb_strpos * Find position of first occurrence of a string * @param string haystack * @param string needle (you should validate this with utf8_is_valid) * @param integer offset in characters (from left) * @return mixed integer position or FALSE on failure * @package utf8 */ function utf8_strpos($str, $search, $offset = FALSE){ if ( $offset === FALSE ) { return mb_strpos($str, $search); } else { return mb_strpos($str, $search, $offset); } } //-------------------------------------------------------------------- /** * Assumes mbstring internal encoding is set to UTF-8 * Wrapper around mb_strrpos * Find position of last occurrence of a char in a string * @param string haystack * @param string needle (you should validate this with utf8_is_valid) * @param integer (optional) offset (from left) * @return mixed integer position or FALSE on failure * @package utf8 */ function utf8_strrpos($str, $search, $offset = FALSE){ if ( $offset === FALSE ) { # Emulate behaviour of strrpos rather than raising warning if ( empty($str) ) { return FALSE; } return mb_strrpos($str, $search); } else { if ( !is_int($offset) ) { trigger_error('utf8_strrpos expects parameter 3 to be long',E_USER_WARNING); return FALSE; } $str = mb_substr($str, $offset); if ( FALSE !== ( $pos = mb_strrpos($str, $search) ) ) { return $pos + $offset; } return FALSE; } } //-------------------------------------------------------------------- /** * Assumes mbstring internal encoding is set to UTF-8 * Wrapper around mb_substr * Return part of a string given character offset (and optionally length) * @param string * @param integer number of UTF-8 characters offset (from left) * @param integer (optional) length in UTF-8 characters from offset * @return mixed string or FALSE if failure * @package utf8 */ function utf8_substr($str, $offset, $length = FALSE){ if ( $length === FALSE ) { return mb_substr($str, $offset); } else { return mb_substr($str, $offset, $length); } } //-------------------------------------------------------------------- /** * Assumes mbstring internal encoding is set to UTF-8 * Wrapper around mb_strtolower * Make a string lowercase * Note: The concept of a characters "case" only exists is some alphabets * such as Latin, Greek, Cyrillic, Armenian and archaic Georgian - it does * not exist in the Chinese alphabet, for example. See Unicode Standard * Annex #21: Case Mappings * @param string * @return mixed either string in lowercase or FALSE is UTF-8 invalid * @package utf8 */ function utf8_strtolower($str){ return mb_strtolower($str); } //-------------------------------------------------------------------- /** * Assumes mbstring internal encoding is set to UTF-8 * Wrapper around mb_strtoupper * Make a string uppercase * Note: The concept of a characters "case" only exists is some alphabets * such as Latin, Greek, Cyrillic, Armenian and archaic Georgian - it does * not exist in the Chinese alphabet, for example. See Unicode Standard * Annex #21: Case Mappings * @param string * @return mixed either string in lowercase or FALSE is UTF-8 invalid * @package utf8 */ function utf8_strtoupper($str){ return mb_strtoupper($str); } PK c�\���ռ � string/src/phputf8/utf8.phpnu �[��� <?php /** * This is the dynamic loader for the library. It checks whether you have * the mbstring extension available and includes relevant files * on that basis, falling back to the native (as in written in PHP) version * if mbstring is unavailabe. * * It's probably easiest to use this, if you don't want to understand * the dependencies involved, in conjunction with PHP versions etc. At * the same time, you might get better performance by managing loading * yourself. The smartest way to do this, bearing in mind performance, * is probably to "load on demand" - i.e. just before you use these * functions in your code, load the version you need. * * It makes sure the the following functions are available; * utf8_strlen, utf8_strpos, utf8_strrpos, utf8_substr, * utf8_strtolower, utf8_strtoupper * Other functions in the ./native directory depend on these * six functions being available * @package utf8 */ /** * Put the current directory in this constant */ if ( !defined('UTF8') ) { define('UTF8',dirname(__FILE__)); } /** * If string overloading is active, it will break many of the * native implementations. mbstring.func_overload must be set * to 0, 1 or 4 in php.ini (string overloading disabled). * Also need to check we have the correct internal mbstring * encoding */ if ( extension_loaded('mbstring')) { /* * Joomla modification - As of PHP 8, the `mbstring.func_overload` configuration has been removed and the * MB_OVERLOAD_STRING constant will no longer be present, so this check only runs for PHP 7 and older * See https://github.com/php/php-src/commit/331e56ce38a91e87a6fb8e88154bb5bde445b132 * and https://github.com/php/php-src/commit/97df99a6d7d96a886ac143337fecad775907589a * for additional references */ if ( PHP_VERSION_ID < 80000 && ((int) ini_get('mbstring.func_overload')) & MB_OVERLOAD_STRING ) { trigger_error('String functions are overloaded by mbstring',E_USER_ERROR); } mb_internal_encoding('UTF-8'); } /** * Check whether PCRE has been compiled with UTF-8 support */ $UTF8_ar = array(); if ( preg_match('/^.{1}$/u',"ñ",$UTF8_ar) != 1 ) { trigger_error('PCRE is not compiled with UTF-8 support',E_USER_ERROR); } unset($UTF8_ar); /** * Load the smartest implementations of utf8_strpos, utf8_strrpos * and utf8_substr */ if ( !defined('UTF8_CORE') ) { if ( function_exists('mb_substr') ) { require_once UTF8 . '/mbstring/core.php'; } else { require_once UTF8 . '/utils/unicode.php'; require_once UTF8 . '/native/core.php'; } } /** * Load the native implementation of utf8_substr_replace */ require_once UTF8 . '/substr_replace.php'; /** * You should now be able to use all the other utf_* string functions */ PK c�\O�y�t t string/src/phputf8/ucwords.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to ucwords * Uppercase the first character of each word in a string * Note: requires utf8_substr_replace and utf8_strtoupper * @param string * @return string with first char of each word uppercase * @see http://www.php.net/ucwords * @package utf8 */ function utf8_ucwords($str) { // Note: [\x0c\x09\x0b\x0a\x0d\x20] matches; // form feeds, horizontal tabs, vertical tabs, linefeeds and carriage returns // This corresponds to the definition of a "word" defined at http://www.php.net/ucwords $pattern = '/(^|([\x0c\x09\x0b\x0a\x0d\x20]+))([^\x0c\x09\x0b\x0a\x0d\x20]{1})[^\x0c\x09\x0b\x0a\x0d\x20]*/u'; return preg_replace_callback($pattern, 'utf8_ucwords_callback',$str); } //--------------------------------------------------------------- /** * Callback function for preg_replace_callback call in utf8_ucwords * You don't need to call this yourself * @param array of matches corresponding to a single word * @return string with first char of the word in uppercase * @see utf8_ucwords * @see utf8_strtoupper * @package utf8 */ function utf8_ucwords_callback($matches) { $leadingws = $matches[2]; $ucfirst = utf8_strtoupper($matches[3]); $ucword = utf8_substr_replace(ltrim($matches[0]),$ucfirst,0,1); return $leadingws . $ucword; } PK c�\ 4�/% /% $ string/src/phputf8/utils/unicode.phpnu �[��� <?php /** * Tools for conversion between UTF-8 and unicode * The Original Code is Mozilla Communicator client code. * The Initial Developer of the Original Code is * Netscape Communications Corporation. * Portions created by the Initial Developer are Copyright (C) 1998 * the Initial Developer. All Rights Reserved. * Ported to PHP by Henri Sivonen (http://hsivonen.iki.fi) * Slight modifications to fit with phputf8 library by Harry Fuecks (hfuecks gmail com) * @see http://lxr.mozilla.org/seamonkey/source/intl/uconv/src/nsUTF8ToUnicode.cpp * @see http://lxr.mozilla.org/seamonkey/source/intl/uconv/src/nsUnicodeToUTF8.cpp * @see http://hsivonen.iki.fi/php-utf8/ * @package utf8 */ //-------------------------------------------------------------------- /** * Takes an UTF-8 string and returns an array of ints representing the * Unicode characters. Astral planes are supported ie. the ints in the * output can be > 0xFFFF. Occurrances of the BOM are ignored. Surrogates * are not allowed. * Returns false if the input string isn't a valid UTF-8 octet sequence * and raises a PHP error at level E_USER_WARNING * Note: this function has been modified slightly in this library to * trigger errors on encountering bad bytes * * Joomla modification - As of PHP 7.4, curly brace access has been deprecated. As a result this function has been * modified to use square brace syntax * See https://github.com/php/php-src/commit/d574df63dc375f5fc9202ce5afde23f866b6450a * for additional references * * @author <hsivonen@iki.fi> * @param string UTF-8 encoded string * @return mixed array of unicode code points or FALSE if UTF-8 invalid * @see utf8_from_unicode * @see http://hsivonen.iki.fi/php-utf8/ * @package utf8 */ function utf8_to_unicode($str) { $mState = 0; // cached expected number of octets after the current octet // until the beginning of the next UTF8 character sequence $mUcs4 = 0; // cached Unicode character $mBytes = 1; // cached expected number of octets in the current sequence $out = array(); $len = strlen($str); for($i = 0; $i < $len; $i++) { $in = ord($str[$i]); if ( $mState == 0) { // When mState is zero we expect either a US-ASCII character or a // multi-octet sequence. if (0 == (0x80 & ($in))) { // US-ASCII, pass straight through. $out[] = $in; $mBytes = 1; } else if (0xC0 == (0xE0 & ($in))) { // First octet of 2 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x1F) << 6; $mState = 1; $mBytes = 2; } else if (0xE0 == (0xF0 & ($in))) { // First octet of 3 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x0F) << 12; $mState = 2; $mBytes = 3; } else if (0xF0 == (0xF8 & ($in))) { // First octet of 4 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x07) << 18; $mState = 3; $mBytes = 4; } else if (0xF8 == (0xFC & ($in))) { /* First octet of 5 octet sequence. * * This is illegal because the encoded codepoint must be either * (a) not the shortest form or * (b) outside the Unicode range of 0-0x10FFFF. * Rather than trying to resynchronize, we will carry on until the end * of the sequence and let the later error handling code catch it. */ $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x03) << 24; $mState = 4; $mBytes = 5; } else if (0xFC == (0xFE & ($in))) { // First octet of 6 octet sequence, see comments for 5 octet sequence. $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 1) << 30; $mState = 5; $mBytes = 6; } else { /* Current octet is neither in the US-ASCII range nor a legal first * octet of a multi-octet sequence. */ trigger_error( 'utf8_to_unicode: Illegal sequence identifier '. 'in UTF-8 at byte '.$i, E_USER_WARNING ); return FALSE; } } else { // When mState is non-zero, we expect a continuation of the multi-octet // sequence if (0x80 == (0xC0 & ($in))) { // Legal continuation. $shift = ($mState - 1) * 6; $tmp = $in; $tmp = ($tmp & 0x0000003F) << $shift; $mUcs4 |= $tmp; /** * End of the multi-octet sequence. mUcs4 now contains the final * Unicode codepoint to be output */ if (0 == --$mState) { /* * Check for illegal sequences and codepoints. */ // From Unicode 3.1, non-shortest form is illegal if (((2 == $mBytes) && ($mUcs4 < 0x0080)) || ((3 == $mBytes) && ($mUcs4 < 0x0800)) || ((4 == $mBytes) && ($mUcs4 < 0x10000)) || (4 < $mBytes) || // From Unicode 3.2, surrogate characters are illegal (($mUcs4 & 0xFFFFF800) == 0xD800) || // Codepoints outside the Unicode range are illegal ($mUcs4 > 0x10FFFF)) { trigger_error( 'utf8_to_unicode: Illegal sequence or codepoint '. 'in UTF-8 at byte '.$i, E_USER_WARNING ); return FALSE; } if (0xFEFF != $mUcs4) { // BOM is legal but we don't want to output it $out[] = $mUcs4; } //initialize UTF8 cache $mState = 0; $mUcs4 = 0; $mBytes = 1; } } else { /** *((0xC0 & (*in) != 0x80) && (mState != 0)) * Incomplete multi-octet sequence. */ trigger_error( 'utf8_to_unicode: Incomplete multi-octet '. ' sequence in UTF-8 at byte '.$i, E_USER_WARNING ); return FALSE; } } } return $out; } //-------------------------------------------------------------------- /** * Takes an array of ints representing the Unicode characters and returns * a UTF-8 string. Astral planes are supported ie. the ints in the * input can be > 0xFFFF. Occurrances of the BOM are ignored. Surrogates * are not allowed. * Returns false if the input array contains ints that represent * surrogates or are outside the Unicode range * and raises a PHP error at level E_USER_WARNING * Note: this function has been modified slightly in this library to use * output buffering to concatenate the UTF-8 string (faster) as well as * reference the array by it's keys * @param array of unicode code points representing a string * @return mixed UTF-8 string or FALSE if array contains invalid code points * @author <hsivonen@iki.fi> * @see utf8_to_unicode * @see http://hsivonen.iki.fi/php-utf8/ * @package utf8 */ function utf8_from_unicode($arr) { ob_start(); foreach (array_keys($arr) as $k) { # ASCII range (including control chars) if ( ($arr[$k] >= 0) && ($arr[$k] <= 0x007f) ) { echo chr($arr[$k]); # 2 byte sequence } else if ($arr[$k] <= 0x07ff) { echo chr(0xc0 | ($arr[$k] >> 6)); echo chr(0x80 | ($arr[$k] & 0x003f)); # Byte order mark (skip) } else if($arr[$k] == 0xFEFF) { // nop -- zap the BOM # Test for illegal surrogates } else if ($arr[$k] >= 0xD800 && $arr[$k] <= 0xDFFF) { // found a surrogate trigger_error( 'utf8_from_unicode: Illegal surrogate '. 'at index: '.$k.', value: '.$arr[$k], E_USER_WARNING ); return FALSE; # 3 byte sequence } else if ($arr[$k] <= 0xffff) { echo chr(0xe0 | ($arr[$k] >> 12)); echo chr(0x80 | (($arr[$k] >> 6) & 0x003f)); echo chr(0x80 | ($arr[$k] & 0x003f)); # 4 byte sequence } else if ($arr[$k] <= 0x10ffff) { echo chr(0xf0 | ($arr[$k] >> 18)); echo chr(0x80 | (($arr[$k] >> 12) & 0x3f)); echo chr(0x80 | (($arr[$k] >> 6) & 0x3f)); echo chr(0x80 | ($arr[$k] & 0x3f)); } else { trigger_error( 'utf8_from_unicode: Codepoint out of Unicode range '. 'at index: '.$k.', value: '.$arr[$k], E_USER_WARNING ); // out of range return FALSE; } } $result = ob_get_contents(); ob_end_clean(); return $result; } PK c�\���K� � ' string/src/phputf8/utils/validation.phpnu �[��� <?php /** * Tools for validing a UTF-8 string is well formed. * The Original Code is Mozilla Communicator client code. * The Initial Developer of the Original Code is * Netscape Communications Corporation. * Portions created by the Initial Developer are Copyright (C) 1998 * the Initial Developer. All Rights Reserved. * Ported to PHP by Henri Sivonen (http://hsivonen.iki.fi) * Slight modifications to fit with phputf8 library by Harry Fuecks (hfuecks gmail com) * @see http://lxr.mozilla.org/seamonkey/source/intl/uconv/src/nsUTF8ToUnicode.cpp * @see http://lxr.mozilla.org/seamonkey/source/intl/uconv/src/nsUnicodeToUTF8.cpp * @see http://hsivonen.iki.fi/php-utf8/ * @package utf8 */ //-------------------------------------------------------------------- /** * Tests a string as to whether it's valid UTF-8 and supported by the * Unicode standard * Note: this function has been modified to simple return true or false * @author <hsivonen@iki.fi> * @param string UTF-8 encoded string * @return boolean true if valid * @see http://hsivonen.iki.fi/php-utf8/ * @see utf8_compliant * @package utf8 */ function utf8_is_valid($str) { $mState = 0; // cached expected number of octets after the current octet // until the beginning of the next UTF8 character sequence $mUcs4 = 0; // cached Unicode character $mBytes = 1; // cached expected number of octets in the current sequence $len = strlen($str); for($i = 0; $i < $len; $i++) { /* * Joomla modification - As of PHP 7.4, curly brace access has been deprecated. As a result the line below has * been modified to use square brace syntax * See https://github.com/php/php-src/commit/d574df63dc375f5fc9202ce5afde23f866b6450a * for additional references */ $in = ord($str[$i]); if ( $mState == 0) { // When mState is zero we expect either a US-ASCII character or a // multi-octet sequence. if (0 == (0x80 & ($in))) { // US-ASCII, pass straight through. $mBytes = 1; } else if (0xC0 == (0xE0 & ($in))) { // First octet of 2 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x1F) << 6; $mState = 1; $mBytes = 2; } else if (0xE0 == (0xF0 & ($in))) { // First octet of 3 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x0F) << 12; $mState = 2; $mBytes = 3; } else if (0xF0 == (0xF8 & ($in))) { // First octet of 4 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x07) << 18; $mState = 3; $mBytes = 4; } else if (0xF8 == (0xFC & ($in))) { /* First octet of 5 octet sequence. * * This is illegal because the encoded codepoint must be either * (a) not the shortest form or * (b) outside the Unicode range of 0-0x10FFFF. * Rather than trying to resynchronize, we will carry on until the end * of the sequence and let the later error handling code catch it. */ $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x03) << 24; $mState = 4; $mBytes = 5; } else if (0xFC == (0xFE & ($in))) { // First octet of 6 octet sequence, see comments for 5 octet sequence. $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 1) << 30; $mState = 5; $mBytes = 6; } else { /* Current octet is neither in the US-ASCII range nor a legal first * octet of a multi-octet sequence. */ return FALSE; } } else { // When mState is non-zero, we expect a continuation of the multi-octet // sequence if (0x80 == (0xC0 & ($in))) { // Legal continuation. $shift = ($mState - 1) * 6; $tmp = $in; $tmp = ($tmp & 0x0000003F) << $shift; $mUcs4 |= $tmp; /** * End of the multi-octet sequence. mUcs4 now contains the final * Unicode codepoint to be output */ if (0 == --$mState) { /* * Check for illegal sequences and codepoints. */ // From Unicode 3.1, non-shortest form is illegal if (((2 == $mBytes) && ($mUcs4 < 0x0080)) || ((3 == $mBytes) && ($mUcs4 < 0x0800)) || ((4 == $mBytes) && ($mUcs4 < 0x10000)) || (4 < $mBytes) || // From Unicode 3.2, surrogate characters are illegal (($mUcs4 & 0xFFFFF800) == 0xD800) || // Codepoints outside the Unicode range are illegal ($mUcs4 > 0x10FFFF)) { return FALSE; } //initialize UTF8 cache $mState = 0; $mUcs4 = 0; $mBytes = 1; } } else { /** *((0xC0 & (*in) != 0x80) && (mState != 0)) * Incomplete multi-octet sequence. */ return FALSE; } } } return TRUE; } //-------------------------------------------------------------------- /** * Tests whether a string complies as UTF-8. This will be much * faster than utf8_is_valid but will pass five and six octet * UTF-8 sequences, which are not supported by Unicode and * so cannot be displayed correctly in a browser. In other words * it is not as strict as utf8_is_valid but it's faster. If you use * is to validate user input, you place yourself at the risk that * attackers will be able to inject 5 and 6 byte sequences (which * may or may not be a significant risk, depending on what you are * are doing) * @see utf8_is_valid * @see http://www.php.net/manual/en/reference.pcre.pattern.modifiers.php#54805 * @param string UTF-8 string to check * @return boolean TRUE if string is valid UTF-8 * @package utf8 */ function utf8_compliant($str) { if ( strlen($str) == 0 ) { return TRUE; } // If even just the first character can be matched, when the /u // modifier is used, then it's valid UTF-8. If the UTF-8 is somehow // invalid, nothing at all will match, even if the string contains // some valid sequences return (preg_match('/^.{1}/us',$str,$ar) == 1); } PK c�\f 3VB B % string/src/phputf8/utils/patterns.phpnu �[��� <?php /** * PCRE Regular expressions for UTF-8. Note this file is not actually used by * the rest of the library but these regular expressions can be useful to have * available. * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @package utf8 */ //-------------------------------------------------------------------- /** * PCRE Pattern to check a UTF-8 string is valid * Comes from W3 FAQ: Multilingual Forms * Note: modified to include full ASCII range including control chars * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @package utf8 */ $UTF8_VALID = '^('. '[\x00-\x7F]'. # ASCII (including control chars) '|[\xC2-\xDF][\x80-\xBF]'. # non-overlong 2-byte '|\xE0[\xA0-\xBF][\x80-\xBF]'. # excluding overlongs '|[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}'. # straight 3-byte '|\xED[\x80-\x9F][\x80-\xBF]'. # excluding surrogates '|\xF0[\x90-\xBF][\x80-\xBF]{2}'. # planes 1-3 '|[\xF1-\xF3][\x80-\xBF]{3}'. # planes 4-15 '|\xF4[\x80-\x8F][\x80-\xBF]{2}'. # plane 16 ')*$'; //-------------------------------------------------------------------- /** * PCRE Pattern to match single UTF-8 characters * Comes from W3 FAQ: Multilingual Forms * Note: modified to include full ASCII range including control chars * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @package utf8 */ $UTF8_MATCH = '([\x00-\x7F])'. # ASCII (including control chars) '|([\xC2-\xDF][\x80-\xBF])'. # non-overlong 2-byte '|(\xE0[\xA0-\xBF][\x80-\xBF])'. # excluding overlongs '|([\xE1-\xEC\xEE\xEF][\x80-\xBF]{2})'. # straight 3-byte '|(\xED[\x80-\x9F][\x80-\xBF])'. # excluding surrogates '|(\xF0[\x90-\xBF][\x80-\xBF]{2})'. # planes 1-3 '|([\xF1-\xF3][\x80-\xBF]{3})'. # planes 4-15 '|(\xF4[\x80-\x8F][\x80-\xBF]{2})'; # plane 16 //-------------------------------------------------------------------- /** * PCRE Pattern to locate bad bytes in a UTF-8 string * Comes from W3 FAQ: Multilingual Forms * Note: modified to include full ASCII range including control chars * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @package utf8 */ $UTF8_BAD = '([\x00-\x7F]'. # ASCII (including control chars) '|[\xC2-\xDF][\x80-\xBF]'. # non-overlong 2-byte '|\xE0[\xA0-\xBF][\x80-\xBF]'. # excluding overlongs '|[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}'. # straight 3-byte '|\xED[\x80-\x9F][\x80-\xBF]'. # excluding surrogates '|\xF0[\x90-\xBF][\x80-\xBF]{2}'. # planes 1-3 '|[\xF1-\xF3][\x80-\xBF]{3}'. # planes 4-15 '|\xF4[\x80-\x8F][\x80-\xBF]{2}'. # plane 16 '|(.{1}))'; # invalid byte PK c�\|�i�� � % string/src/phputf8/utils/position.phpnu �[��� <?php /** * Locate a byte index given a UTF-8 character index * @package utf8 */ //-------------------------------------------------------------------- /** * Given a string and a character index in the string, in * terms of the UTF-8 character position, returns the byte * index of that character. Can be useful when you want to * PHP's native string functions but we warned, locating * the byte can be expensive * Takes variable number of parameters - first must be * the search string then 1 to n UTF-8 character positions * to obtain byte indexes for - it is more efficient to search * the string for multiple characters at once, than make * repeated calls to this function * * @author Chris Smith<chris@jalakai.co.uk> * @param string string to locate index in * @param int (n times) * @return mixed - int if only one input int, array if more * @return boolean TRUE if it's all ASCII * @package utf8 */ function utf8_byte_position() { $args = func_get_args(); $str =& array_shift($args); if (!is_string($str)) return false; $result = array(); // trivial byte index, character offset pair $prev = array(0,0); // use a short piece of str to estimate bytes per character // $i (& $j) -> byte indexes into $str $i = utf8_locate_next_chr($str, 300); // $c -> character offset into $str $c = strlen(utf8_decode(substr($str,0,$i))); // deal with arguments from lowest to highest sort($args); foreach ($args as $offset) { // sanity checks FIXME // 0 is an easy check if ($offset == 0) { $result[] = 0; continue; } // ensure no endless looping $safety_valve = 50; do { if ( ($c - $prev[1]) == 0 ) { // Hack: gone past end of string $error = 0; $i = strlen($str); break; } $j = $i + (int)(($offset-$c) * ($i - $prev[0]) / ($c - $prev[1])); // correct to utf8 character boundary $j = utf8_locate_next_chr($str, $j); // save the index, offset for use next iteration $prev = array($i,$c); if ($j > $i) { // determine new character offset $c += strlen(utf8_decode(substr($str,$i,$j-$i))); } else { // ditto $c -= strlen(utf8_decode(substr($str,$j,$i-$j))); } $error = abs($c-$offset); // ready for next time around $i = $j; // from 7 it is faster to iterate over the string } while ( ($error > 7) && --$safety_valve) ; if ($error && $error <= 7) { if ($c < $offset) { // move up while ($error--) { $i = utf8_locate_next_chr($str,++$i); } } else { // move down while ($error--) { $i = utf8_locate_current_chr($str,--$i); } } // ready for next arg $c = $offset; } $result[] = $i; } if ( count($result) == 1 ) { return $result[0]; } return $result; } //-------------------------------------------------------------------- /** * Given a string and any byte index, returns the byte index * of the start of the current UTF-8 character, relative to supplied * position. If the current character begins at the same place as the * supplied byte index, that byte index will be returned. Otherwise * this function will step backwards, looking for the index where * current UTF-8 character begins * @author Chris Smith<chris@jalakai.co.uk> * @param string * @param int byte index in the string * @return int byte index of start of next UTF-8 character * @package utf8 */ function utf8_locate_current_chr( &$str, $idx ) { if ($idx <= 0) return 0; $limit = strlen($str); if ($idx >= $limit) return $limit; // Binary value for any byte after the first in a multi-byte UTF-8 character // will be like 10xxxxxx so & 0xC0 can be used to detect this kind // of byte - assuming well formed UTF-8 while ($idx && ((ord($str[$idx]) & 0xC0) == 0x80)) $idx--; return $idx; } //-------------------------------------------------------------------- /** * Given a string and any byte index, returns the byte index * of the start of the next UTF-8 character, relative to supplied * position. If the next character begins at the same place as the * supplied byte index, that byte index will be returned. * @author Chris Smith<chris@jalakai.co.uk> * @param string * @param int byte index in the string * @return int byte index of start of next UTF-8 character * @package utf8 */ function utf8_locate_next_chr( &$str, $idx ) { if ($idx <= 0) return 0; $limit = strlen($str); if ($idx >= $limit) return $limit; // Binary value for any byte after the first in a multi-byte UTF-8 character // will be like 10xxxxxx so & 0xC0 can be used to detect this kind // of byte - assuming well formed UTF-8 while (($idx < $limit) && ((ord($str[$idx]) & 0xC0) == 0x80)) $idx++; return $idx; } PK c�\Q c�! ! " string/src/phputf8/utils/ascii.phpnu �[��� <?php /** * Tools to help with ASCII in UTF-8 * * @package utf8 */ //-------------------------------------------------------------------- /** * Tests whether a string contains only 7bit ASCII bytes. * You might use this to conditionally check whether a string * needs handling as UTF-8 or not, potentially offering performance * benefits by using the native PHP equivalent if it's just ASCII e.g.; * * <code> * if ( utf8_is_ascii($someString) ) { * // It's just ASCII - use the native PHP version * $someString = strtolower($someString); * } else { * $someString = utf8_strtolower($someString); * } * </code> * * @param string * @return boolean TRUE if it's all ASCII * @package utf8 * @see utf8_is_ascii_ctrl */ function utf8_is_ascii($str) { // Search for any bytes which are outside the ASCII range... return (preg_match('/(?:[^\x00-\x7F])/',$str) !== 1); } //-------------------------------------------------------------------- /** * Tests whether a string contains only 7bit ASCII bytes with device * control codes omitted. The device control codes can be found on the * second table here: http://www.w3schools.com/tags/ref_ascii.asp * * @param string * @return boolean TRUE if it's all ASCII without device control codes * @package utf8 * @see utf8_is_ascii */ function utf8_is_ascii_ctrl($str) { if ( strlen($str) > 0 ) { // Search for any bytes which are outside the ASCII range, // or are device control codes return (preg_match('/[^\x09\x0A\x0D\x20-\x7E]/',$str) !== 1); } return FALSE; } //-------------------------------------------------------------------- /** * Strip out all non-7bit ASCII bytes * If you need to transmit a string to system which you know can only * support 7bit ASCII, you could use this function. * @param string * @return string with non ASCII bytes removed * @package utf8 * @see utf8_strip_non_ascii_ctrl */ function utf8_strip_non_ascii($str) { ob_start(); while ( preg_match( '/^([\x00-\x7F]+)|([^\x00-\x7F]+)/S', $str, $matches) ) { if ( !isset($matches[2]) ) { echo $matches[0]; } $str = substr($str, strlen($matches[0])); } $result = ob_get_contents(); ob_end_clean(); return $result; } //-------------------------------------------------------------------- /** * Strip out device control codes in the ASCII range * which are not permitted in XML. Note that this leaves * multi-byte characters untouched - it only removes device * control codes * @see http://hsivonen.iki.fi/producing-xml/#controlchar * @param string * @return string control codes removed */ function utf8_strip_ascii_ctrl($str) { ob_start(); while ( preg_match( '/^([^\x00-\x08\x0B\x0C\x0E-\x1F\x7F]+)|([\x00-\x08\x0B\x0C\x0E-\x1F\x7F]+)/S', $str, $matches) ) { if ( !isset($matches[2]) ) { echo $matches[0]; } $str = substr($str, strlen($matches[0])); } $result = ob_get_contents(); ob_end_clean(); return $result; } //-------------------------------------------------------------------- /** * Strip out all non 7bit ASCII bytes and ASCII device control codes. * For a list of ASCII device control codes see the 2nd table here: * http://www.w3schools.com/tags/ref_ascii.asp * * @param string * @return boolean TRUE if it's all ASCII * @package utf8 */ function utf8_strip_non_ascii_ctrl($str) { ob_start(); while ( preg_match( '/^([\x09\x0A\x0D\x20-\x7E]+)|([^\x09\x0A\x0D\x20-\x7E]+)/S', $str, $matches) ) { if ( !isset($matches[2]) ) { echo $matches[0]; } $str = substr($str, strlen($matches[0])); } $result = ob_get_contents(); ob_end_clean(); return $result; } //--------------------------------------------------------------- /** * Replace accented UTF-8 characters by unaccented ASCII-7 "equivalents". * The purpose of this function is to replace characters commonly found in Latin * alphabets with something more or less equivalent from the ASCII range. This can * be useful for converting a UTF-8 to something ready for a filename, for example. * Following the use of this function, you would probably also pass the string * through utf8_strip_non_ascii to clean out any other non-ASCII chars * Use the optional parameter to just deaccent lower ($case = -1) or upper ($case = 1) * letters. Default is to deaccent both cases ($case = 0) * * For a more complete implementation of transliteration, see the utf8_to_ascii package * available from the phputf8 project downloads: * http://prdownloads.sourceforge.net/phputf8 * * @param string UTF-8 string * @param int (optional) -1 lowercase only, +1 uppercase only, 1 both cases * @param string UTF-8 with accented characters replaced by ASCII chars * @return string accented chars replaced with ascii equivalents * @author Andreas Gohr <andi@splitbrain.org> * @package utf8 */ function utf8_accents_to_ascii( $str, $case=0 ){ static $UTF8_LOWER_ACCENTS = NULL; static $UTF8_UPPER_ACCENTS = NULL; if($case <= 0){ if ( is_null($UTF8_LOWER_ACCENTS) ) { $UTF8_LOWER_ACCENTS = array( 'à' => 'a', 'ô' => 'o', 'ď' => 'd', 'ḟ' => 'f', 'ë' => 'e', 'š' => 's', 'ơ' => 'o', 'ß' => 'ss', 'ă' => 'a', 'ř' => 'r', 'ț' => 't', 'ň' => 'n', 'ā' => 'a', 'ķ' => 'k', 'ŝ' => 's', 'ỳ' => 'y', 'ņ' => 'n', 'ĺ' => 'l', 'ħ' => 'h', 'ṗ' => 'p', 'ó' => 'o', 'ú' => 'u', 'ě' => 'e', 'é' => 'e', 'ç' => 'c', 'ẁ' => 'w', 'ċ' => 'c', 'õ' => 'o', 'ṡ' => 's', 'ø' => 'o', 'ģ' => 'g', 'ŧ' => 't', 'ș' => 's', 'ė' => 'e', 'ĉ' => 'c', 'ś' => 's', 'î' => 'i', 'ű' => 'u', 'ć' => 'c', 'ę' => 'e', 'ŵ' => 'w', 'ṫ' => 't', 'ū' => 'u', 'č' => 'c', 'ö' => 'oe', 'è' => 'e', 'ŷ' => 'y', 'ą' => 'a', 'ł' => 'l', 'ų' => 'u', 'ů' => 'u', 'ş' => 's', 'ğ' => 'g', 'ļ' => 'l', 'ƒ' => 'f', 'ž' => 'z', 'ẃ' => 'w', 'ḃ' => 'b', 'å' => 'a', 'ì' => 'i', 'ï' => 'i', 'ḋ' => 'd', 'ť' => 't', 'ŗ' => 'r', 'ä' => 'ae', 'í' => 'i', 'ŕ' => 'r', 'ê' => 'e', 'ü' => 'ue', 'ò' => 'o', 'ē' => 'e', 'ñ' => 'n', 'ń' => 'n', 'ĥ' => 'h', 'ĝ' => 'g', 'đ' => 'd', 'ĵ' => 'j', 'ÿ' => 'y', 'ũ' => 'u', 'ŭ' => 'u', 'ư' => 'u', 'ţ' => 't', 'ý' => 'y', 'ő' => 'o', 'â' => 'a', 'ľ' => 'l', 'ẅ' => 'w', 'ż' => 'z', 'ī' => 'i', 'ã' => 'a', 'ġ' => 'g', 'ṁ' => 'm', 'ō' => 'o', 'ĩ' => 'i', 'ù' => 'u', 'į' => 'i', 'ź' => 'z', 'á' => 'a', 'û' => 'u', 'þ' => 'th', 'ð' => 'dh', 'æ' => 'ae', 'µ' => 'u', 'ĕ' => 'e', ); } $str = str_replace( array_keys($UTF8_LOWER_ACCENTS), array_values($UTF8_LOWER_ACCENTS), $str ); } if($case >= 0){ if ( is_null($UTF8_UPPER_ACCENTS) ) { $UTF8_UPPER_ACCENTS = array( 'À' => 'A', 'Ô' => 'O', 'Ď' => 'D', 'Ḟ' => 'F', 'Ë' => 'E', 'Š' => 'S', 'Ơ' => 'O', 'Ă' => 'A', 'Ř' => 'R', 'Ț' => 'T', 'Ň' => 'N', 'Ā' => 'A', 'Ķ' => 'K', 'Ŝ' => 'S', 'Ỳ' => 'Y', 'Ņ' => 'N', 'Ĺ' => 'L', 'Ħ' => 'H', 'Ṗ' => 'P', 'Ó' => 'O', 'Ú' => 'U', 'Ě' => 'E', 'É' => 'E', 'Ç' => 'C', 'Ẁ' => 'W', 'Ċ' => 'C', 'Õ' => 'O', 'Ṡ' => 'S', 'Ø' => 'O', 'Ģ' => 'G', 'Ŧ' => 'T', 'Ș' => 'S', 'Ė' => 'E', 'Ĉ' => 'C', 'Ś' => 'S', 'Î' => 'I', 'Ű' => 'U', 'Ć' => 'C', 'Ę' => 'E', 'Ŵ' => 'W', 'Ṫ' => 'T', 'Ū' => 'U', 'Č' => 'C', 'Ö' => 'Oe', 'È' => 'E', 'Ŷ' => 'Y', 'Ą' => 'A', 'Ł' => 'L', 'Ų' => 'U', 'Ů' => 'U', 'Ş' => 'S', 'Ğ' => 'G', 'Ļ' => 'L', 'Ƒ' => 'F', 'Ž' => 'Z', 'Ẃ' => 'W', 'Ḃ' => 'B', 'Å' => 'A', 'Ì' => 'I', 'Ï' => 'I', 'Ḋ' => 'D', 'Ť' => 'T', 'Ŗ' => 'R', 'Ä' => 'Ae', 'Í' => 'I', 'Ŕ' => 'R', 'Ê' => 'E', 'Ü' => 'Ue', 'Ò' => 'O', 'Ē' => 'E', 'Ñ' => 'N', 'Ń' => 'N', 'Ĥ' => 'H', 'Ĝ' => 'G', 'Đ' => 'D', 'Ĵ' => 'J', 'Ÿ' => 'Y', 'Ũ' => 'U', 'Ŭ' => 'U', 'Ư' => 'U', 'Ţ' => 'T', 'Ý' => 'Y', 'Ő' => 'O', 'Â' => 'A', 'Ľ' => 'L', 'Ẅ' => 'W', 'Ż' => 'Z', 'Ī' => 'I', 'Ã' => 'A', 'Ġ' => 'G', 'Ṁ' => 'M', 'Ō' => 'O', 'Ĩ' => 'I', 'Ù' => 'U', 'Į' => 'I', 'Ź' => 'Z', 'Á' => 'A', 'Û' => 'U', 'Þ' => 'Th', 'Ð' => 'Dh', 'Æ' => 'Ae', 'Ĕ' => 'E', ); } $str = str_replace( array_keys($UTF8_UPPER_ACCENTS), array_values($UTF8_UPPER_ACCENTS), $str ); } return $str; } PK c�\�� ��6 �6 string/src/phputf8/utils/bad.phpnu �[��� <?php /** * Tools for locating / replacing bad bytes in UTF-8 strings * The Original Code is Mozilla Communicator client code. * The Initial Developer of the Original Code is * Netscape Communications Corporation. * Portions created by the Initial Developer are Copyright (C) 1998 * the Initial Developer. All Rights Reserved. * Ported to PHP by Henri Sivonen (http://hsivonen.iki.fi) * Slight modifications to fit with phputf8 library by Harry Fuecks (hfuecks gmail com) * @see http://lxr.mozilla.org/seamonkey/source/intl/uconv/src/nsUTF8ToUnicode.cpp * @see http://lxr.mozilla.org/seamonkey/source/intl/uconv/src/nsUnicodeToUTF8.cpp * @see http://hsivonen.iki.fi/php-utf8/ * @package utf8 * @see utf8_is_valid */ //-------------------------------------------------------------------- /** * Locates the first bad byte in a UTF-8 string returning it's * byte index in the string * PCRE Pattern to locate bad bytes in a UTF-8 string * Comes from W3 FAQ: Multilingual Forms * Note: modified to include full ASCII range including control chars * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @param string * @return mixed integer byte index or FALSE if no bad found * @package utf8 */ function utf8_bad_find($str) { $UTF8_BAD = '([\x00-\x7F]'. # ASCII (including control chars) '|[\xC2-\xDF][\x80-\xBF]'. # non-overlong 2-byte '|\xE0[\xA0-\xBF][\x80-\xBF]'. # excluding overlongs '|[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}'. # straight 3-byte '|\xED[\x80-\x9F][\x80-\xBF]'. # excluding surrogates '|\xF0[\x90-\xBF][\x80-\xBF]{2}'. # planes 1-3 '|[\xF1-\xF3][\x80-\xBF]{3}'. # planes 4-15 '|\xF4[\x80-\x8F][\x80-\xBF]{2}'. # plane 16 '|(.{1}))'; # invalid byte $pos = 0; $badList = array(); while (preg_match('/'.$UTF8_BAD.'/S', $str, $matches)) { $bytes = strlen($matches[0]); if ( isset($matches[2])) { return $pos; } $pos += $bytes; $str = substr($str,$bytes); } return FALSE; } //-------------------------------------------------------------------- /** * Locates all bad bytes in a UTF-8 string and returns a list of their * byte index in the string * PCRE Pattern to locate bad bytes in a UTF-8 string * Comes from W3 FAQ: Multilingual Forms * Note: modified to include full ASCII range including control chars * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @param string * @return mixed array of integers or FALSE if no bad found * @package utf8 */ function utf8_bad_findall($str) { $UTF8_BAD = '([\x00-\x7F]'. # ASCII (including control chars) '|[\xC2-\xDF][\x80-\xBF]'. # non-overlong 2-byte '|\xE0[\xA0-\xBF][\x80-\xBF]'. # excluding overlongs '|[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}'. # straight 3-byte '|\xED[\x80-\x9F][\x80-\xBF]'. # excluding surrogates '|\xF0[\x90-\xBF][\x80-\xBF]{2}'. # planes 1-3 '|[\xF1-\xF3][\x80-\xBF]{3}'. # planes 4-15 '|\xF4[\x80-\x8F][\x80-\xBF]{2}'. # plane 16 '|(.{1}))'; # invalid byte $pos = 0; $badList = array(); while (preg_match('/'.$UTF8_BAD.'/S', $str, $matches)) { $bytes = strlen($matches[0]); if ( isset($matches[2])) { $badList[] = $pos; } $pos += $bytes; $str = substr($str,$bytes); } if ( count($badList) > 0 ) { return $badList; } return FALSE; } //-------------------------------------------------------------------- /** * Strips out any bad bytes from a UTF-8 string and returns the rest * PCRE Pattern to locate bad bytes in a UTF-8 string * Comes from W3 FAQ: Multilingual Forms * Note: modified to include full ASCII range including control chars * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @param string * @return string * @package utf8 */ function utf8_bad_strip($str) { $UTF8_BAD = '([\x00-\x7F]'. # ASCII (including control chars) '|[\xC2-\xDF][\x80-\xBF]'. # non-overlong 2-byte '|\xE0[\xA0-\xBF][\x80-\xBF]'. # excluding overlongs '|[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}'. # straight 3-byte '|\xED[\x80-\x9F][\x80-\xBF]'. # excluding surrogates '|\xF0[\x90-\xBF][\x80-\xBF]{2}'. # planes 1-3 '|[\xF1-\xF3][\x80-\xBF]{3}'. # planes 4-15 '|\xF4[\x80-\x8F][\x80-\xBF]{2}'. # plane 16 '|(.{1}))'; # invalid byte ob_start(); while (preg_match('/'.$UTF8_BAD.'/S', $str, $matches)) { if ( !isset($matches[2])) { echo $matches[0]; } $str = substr($str,strlen($matches[0])); } $result = ob_get_contents(); ob_end_clean(); return $result; } //-------------------------------------------------------------------- /** * Replace bad bytes with an alternative character - ASCII character * recommended is replacement char * PCRE Pattern to locate bad bytes in a UTF-8 string * Comes from W3 FAQ: Multilingual Forms * Note: modified to include full ASCII range including control chars * @see http://www.w3.org/International/questions/qa-forms-utf-8 * @param string to search * @param string to replace bad bytes with (defaults to '?') - use ASCII * @return string * @package utf8 */ function utf8_bad_replace($str, $replace = '?') { $UTF8_BAD = '([\x00-\x7F]'. # ASCII (including control chars) '|[\xC2-\xDF][\x80-\xBF]'. # non-overlong 2-byte '|\xE0[\xA0-\xBF][\x80-\xBF]'. # excluding overlongs '|[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}'. # straight 3-byte '|\xED[\x80-\x9F][\x80-\xBF]'. # excluding surrogates '|\xF0[\x90-\xBF][\x80-\xBF]{2}'. # planes 1-3 '|[\xF1-\xF3][\x80-\xBF]{3}'. # planes 4-15 '|\xF4[\x80-\x8F][\x80-\xBF]{2}'. # plane 16 '|(.{1}))'; # invalid byte ob_start(); while (preg_match('/'.$UTF8_BAD.'/S', $str, $matches)) { if ( !isset($matches[2])) { echo $matches[0]; } else { echo $replace; } $str = substr($str,strlen($matches[0])); } $result = ob_get_contents(); ob_end_clean(); return $result; } //-------------------------------------------------------------------- /** * Return code from utf8_bad_identify() when a five octet sequence is detected. * Note: 5 octets sequences are valid UTF-8 but are not supported by Unicode so * do not represent a useful character * @see utf8_bad_identify * @package utf8 */ define('UTF8_BAD_5OCTET',1); /** * Return code from utf8_bad_identify() when a six octet sequence is detected. * Note: 6 octets sequences are valid UTF-8 but are not supported by Unicode so * do not represent a useful character * @see utf8_bad_identify * @package utf8 */ define('UTF8_BAD_6OCTET',2); /** * Return code from utf8_bad_identify(). * Invalid octet for use as start of multi-byte UTF-8 sequence * @see utf8_bad_identify * @package utf8 */ define('UTF8_BAD_SEQID',3); /** * Return code from utf8_bad_identify(). * From Unicode 3.1, non-shortest form is illegal * @see utf8_bad_identify * @package utf8 */ define('UTF8_BAD_NONSHORT',4); /** * Return code from utf8_bad_identify(). * From Unicode 3.2, surrogate characters are illegal * @see utf8_bad_identify * @package utf8 */ define('UTF8_BAD_SURROGATE',5); /** * Return code from utf8_bad_identify(). * Codepoints outside the Unicode range are illegal * @see utf8_bad_identify * @package utf8 */ define('UTF8_BAD_UNIOUTRANGE',6); /** * Return code from utf8_bad_identify(). * Incomplete multi-octet sequence * Note: this is kind of a "catch-all" * @see utf8_bad_identify * @package utf8 */ define('UTF8_BAD_SEQINCOMPLETE',7); //-------------------------------------------------------------------- /** * Reports on the type of bad byte found in a UTF-8 string. Returns a * status code on the first bad byte found * * Joomla modification - As of PHP 7.4, curly brace access has been deprecated. As a result this function has been * modified to use square brace syntax * See https://github.com/php/php-src/commit/d574df63dc375f5fc9202ce5afde23f866b6450a * for additional references * * @author <hsivonen@iki.fi> * @param string UTF-8 encoded string * @return mixed integer constant describing problem or FALSE if valid UTF-8 * @see utf8_bad_explain * @see http://hsivonen.iki.fi/php-utf8/ * @package utf8 */ function utf8_bad_identify($str, &$i) { $mState = 0; // cached expected number of octets after the current octet // until the beginning of the next UTF8 character sequence $mUcs4 = 0; // cached Unicode character $mBytes = 1; // cached expected number of octets in the current sequence $len = strlen($str); for($i = 0; $i < $len; $i++) { $in = ord($str[$i]); if ( $mState == 0) { // When mState is zero we expect either a US-ASCII character or a // multi-octet sequence. if (0 == (0x80 & ($in))) { // US-ASCII, pass straight through. $mBytes = 1; } else if (0xC0 == (0xE0 & ($in))) { // First octet of 2 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x1F) << 6; $mState = 1; $mBytes = 2; } else if (0xE0 == (0xF0 & ($in))) { // First octet of 3 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x0F) << 12; $mState = 2; $mBytes = 3; } else if (0xF0 == (0xF8 & ($in))) { // First octet of 4 octet sequence $mUcs4 = ($in); $mUcs4 = ($mUcs4 & 0x07) << 18; $mState = 3; $mBytes = 4; } else if (0xF8 == (0xFC & ($in))) { /* First octet of 5 octet sequence. * * This is illegal because the encoded codepoint must be either * (a) not the shortest form or * (b) outside the Unicode range of 0-0x10FFFF. */ return UTF8_BAD_5OCTET; } else if (0xFC == (0xFE & ($in))) { // First octet of 6 octet sequence, see comments for 5 octet sequence. return UTF8_BAD_6OCTET; } else { // Current octet is neither in the US-ASCII range nor a legal first // octet of a multi-octet sequence. return UTF8_BAD_SEQID; } } else { // When mState is non-zero, we expect a continuation of the multi-octet // sequence if (0x80 == (0xC0 & ($in))) { // Legal continuation. $shift = ($mState - 1) * 6; $tmp = $in; $tmp = ($tmp & 0x0000003F) << $shift; $mUcs4 |= $tmp; /** * End of the multi-octet sequence. mUcs4 now contains the final * Unicode codepoint to be output */ if (0 == --$mState) { // From Unicode 3.1, non-shortest form is illegal if (((2 == $mBytes) && ($mUcs4 < 0x0080)) || ((3 == $mBytes) && ($mUcs4 < 0x0800)) || ((4 == $mBytes) && ($mUcs4 < 0x10000)) ) { return UTF8_BAD_NONSHORT; // From Unicode 3.2, surrogate characters are illegal } else if (($mUcs4 & 0xFFFFF800) == 0xD800) { return UTF8_BAD_SURROGATE; // Codepoints outside the Unicode range are illegal } else if ($mUcs4 > 0x10FFFF) { return UTF8_BAD_UNIOUTRANGE; } //initialize UTF8 cache $mState = 0; $mUcs4 = 0; $mBytes = 1; } } else { // ((0xC0 & (*in) != 0x80) && (mState != 0)) // Incomplete multi-octet sequence. $i--; return UTF8_BAD_SEQINCOMPLETE; } } } if ( $mState != 0 ) { // Incomplete multi-octet sequence. $i--; return UTF8_BAD_SEQINCOMPLETE; } // No bad octets found $i = NULL; return FALSE; } //-------------------------------------------------------------------- /** * Takes a return code from utf8_bad_identify() are returns a message * (in English) explaining what the problem is. * @param int return code from utf8_bad_identify * @return mixed string message or FALSE if return code unknown * @see utf8_bad_identify * @package utf8 */ function utf8_bad_explain($code) { switch ($code) { case UTF8_BAD_5OCTET: return 'Five octet sequences are valid UTF-8 but are not supported by Unicode'; break; case UTF8_BAD_6OCTET: return 'Six octet sequences are valid UTF-8 but are not supported by Unicode'; break; case UTF8_BAD_SEQID: return 'Invalid octet for use as start of multi-byte UTF-8 sequence'; break; case UTF8_BAD_NONSHORT: return 'From Unicode 3.1, non-shortest form is illegal'; break; case UTF8_BAD_SURROGATE: return 'From Unicode 3.2, surrogate characters are illegal'; break; case UTF8_BAD_UNIOUTRANGE: return 'Codepoints outside the Unicode range are illegal'; break; case UTF8_BAD_SEQINCOMPLETE: return 'Incomplete multi-octet sequence'; break; } trigger_error('Unknown error code: '.$code,E_USER_WARNING); return FALSE; } PK c�\+OcgB B % string/src/phputf8/utils/specials.phpnu �[��� <?php /** * Utilities for processing "special" characters in UTF-8. "Special" largely means anything which would * be regarded as a non-word character, like ASCII control characters and punctuation. This has a "Roman" * bias - it would be unaware of modern Chinese "punctuation" characters for example. * Note: requires utils/unicode.php to be loaded * @package utf8 * @see utf8_is_valid */ //-------------------------------------------------------------------- /** * Used internally. Builds a PCRE pattern from the $UTF8_SPECIAL_CHARS * array defined in this file * The $UTF8_SPECIAL_CHARS should contain all special characters (non-letter/non-digit) * defined in the various local charsets - it's not a complete list of * non-alphanum characters in UTF-8. It's not perfect but should match most * cases of special chars. * This function adds the control chars 0x00 to 0x19 to the array of * special chars (they are not included in $UTF8_SPECIAL_CHARS) * @package utf8 * @return string * @see utf8_from_unicode * @see utf8_is_word_chars * @see utf8_strip_specials */ function utf8_specials_pattern() { static $pattern = NULL; if ( !$pattern ) { $UTF8_SPECIAL_CHARS = array( 0x001a, 0x001b, 0x001c, 0x001d, 0x001e, 0x001f, 0x0020, 0x0021, 0x0022, 0x0023, 0x0024, 0x0025, 0x0026, 0x0027, 0x0028, 0x0029, 0x002a, 0x002b, 0x002c, 0x002f, 0x003b, 0x003c, 0x003d, 0x003e, 0x003f, 0x0040, 0x005b, 0x005c, 0x005d, 0x005e, 0x0060, 0x007b, 0x007c, 0x007d, 0x007e, 0x007f, 0x0080, 0x0081, 0x0082, 0x0083, 0x0084, 0x0085, 0x0086, 0x0087, 0x0088, 0x0089, 0x008a, 0x008b, 0x008c, 0x008d, 0x008e, 0x008f, 0x0090, 0x0091, 0x0092, 0x0093, 0x0094, 0x0095, 0x0096, 0x0097, 0x0098, 0x0099, 0x009a, 0x009b, 0x009c, 0x009d, 0x009e, 0x009f, 0x00a0, 0x00a1, 0x00a2, 0x00a3, 0x00a4, 0x00a5, 0x00a6, 0x00a7, 0x00a8, 0x00a9, 0x00aa, 0x00ab, 0x00ac, 0x00ad, 0x00ae, 0x00af, 0x00b0, 0x00b1, 0x00b2, 0x00b3, 0x00b4, 0x00b5, 0x00b6, 0x00b7, 0x00b8, 0x00b9, 0x00ba, 0x00bb, 0x00bc, 0x00bd, 0x00be, 0x00bf, 0x00d7, 0x00f7, 0x02c7, 0x02d8, 0x02d9, 0x02da, 0x02db, 0x02dc, 0x02dd, 0x0300, 0x0301, 0x0303, 0x0309, 0x0323, 0x0384, 0x0385, 0x0387, 0x03b2, 0x03c6, 0x03d1, 0x03d2, 0x03d5, 0x03d6, 0x05b0, 0x05b1, 0x05b2, 0x05b3, 0x05b4, 0x05b5, 0x05b6, 0x05b7, 0x05b8, 0x05b9, 0x05bb, 0x05bc, 0x05bd, 0x05be, 0x05bf, 0x05c0, 0x05c1, 0x05c2, 0x05c3, 0x05f3, 0x05f4, 0x060c, 0x061b, 0x061f, 0x0640, 0x064b, 0x064c, 0x064d, 0x064e, 0x064f, 0x0650, 0x0651, 0x0652, 0x066a, 0x0e3f, 0x200c, 0x200d, 0x200e, 0x200f, 0x2013, 0x2014, 0x2015, 0x2017, 0x2018, 0x2019, 0x201a, 0x201c, 0x201d, 0x201e, 0x2020, 0x2021, 0x2022, 0x2026, 0x2030, 0x2032, 0x2033, 0x2039, 0x203a, 0x2044, 0x20a7, 0x20aa, 0x20ab, 0x20ac, 0x2116, 0x2118, 0x2122, 0x2126, 0x2135, 0x2190, 0x2191, 0x2192, 0x2193, 0x2194, 0x2195, 0x21b5, 0x21d0, 0x21d1, 0x21d2, 0x21d3, 0x21d4, 0x2200, 0x2202, 0x2203, 0x2205, 0x2206, 0x2207, 0x2208, 0x2209, 0x220b, 0x220f, 0x2211, 0x2212, 0x2215, 0x2217, 0x2219, 0x221a, 0x221d, 0x221e, 0x2220, 0x2227, 0x2228, 0x2229, 0x222a, 0x222b, 0x2234, 0x223c, 0x2245, 0x2248, 0x2260, 0x2261, 0x2264, 0x2265, 0x2282, 0x2283, 0x2284, 0x2286, 0x2287, 0x2295, 0x2297, 0x22a5, 0x22c5, 0x2310, 0x2320, 0x2321, 0x2329, 0x232a, 0x2469, 0x2500, 0x2502, 0x250c, 0x2510, 0x2514, 0x2518, 0x251c, 0x2524, 0x252c, 0x2534, 0x253c, 0x2550, 0x2551, 0x2552, 0x2553, 0x2554, 0x2555, 0x2556, 0x2557, 0x2558, 0x2559, 0x255a, 0x255b, 0x255c, 0x255d, 0x255e, 0x255f, 0x2560, 0x2561, 0x2562, 0x2563, 0x2564, 0x2565, 0x2566, 0x2567, 0x2568, 0x2569, 0x256a, 0x256b, 0x256c, 0x2580, 0x2584, 0x2588, 0x258c, 0x2590, 0x2591, 0x2592, 0x2593, 0x25a0, 0x25b2, 0x25bc, 0x25c6, 0x25ca, 0x25cf, 0x25d7, 0x2605, 0x260e, 0x261b, 0x261e, 0x2660, 0x2663, 0x2665, 0x2666, 0x2701, 0x2702, 0x2703, 0x2704, 0x2706, 0x2707, 0x2708, 0x2709, 0x270c, 0x270d, 0x270e, 0x270f, 0x2710, 0x2711, 0x2712, 0x2713, 0x2714, 0x2715, 0x2716, 0x2717, 0x2718, 0x2719, 0x271a, 0x271b, 0x271c, 0x271d, 0x271e, 0x271f, 0x2720, 0x2721, 0x2722, 0x2723, 0x2724, 0x2725, 0x2726, 0x2727, 0x2729, 0x272a, 0x272b, 0x272c, 0x272d, 0x272e, 0x272f, 0x2730, 0x2731, 0x2732, 0x2733, 0x2734, 0x2735, 0x2736, 0x2737, 0x2738, 0x2739, 0x273a, 0x273b, 0x273c, 0x273d, 0x273e, 0x273f, 0x2740, 0x2741, 0x2742, 0x2743, 0x2744, 0x2745, 0x2746, 0x2747, 0x2748, 0x2749, 0x274a, 0x274b, 0x274d, 0x274f, 0x2750, 0x2751, 0x2752, 0x2756, 0x2758, 0x2759, 0x275a, 0x275b, 0x275c, 0x275d, 0x275e, 0x2761, 0x2762, 0x2763, 0x2764, 0x2765, 0x2766, 0x2767, 0x277f, 0x2789, 0x2793, 0x2794, 0x2798, 0x2799, 0x279a, 0x279b, 0x279c, 0x279d, 0x279e, 0x279f, 0x27a0, 0x27a1, 0x27a2, 0x27a3, 0x27a4, 0x27a5, 0x27a6, 0x27a7, 0x27a8, 0x27a9, 0x27aa, 0x27ab, 0x27ac, 0x27ad, 0x27ae, 0x27af, 0x27b1, 0x27b2, 0x27b3, 0x27b4, 0x27b5, 0x27b6, 0x27b7, 0x27b8, 0x27b9, 0x27ba, 0x27bb, 0x27bc, 0x27bd, 0x27be, 0xf6d9, 0xf6da, 0xf6db, 0xf8d7, 0xf8d8, 0xf8d9, 0xf8da, 0xf8db, 0xf8dc, 0xf8dd, 0xf8de, 0xf8df, 0xf8e0, 0xf8e1, 0xf8e2, 0xf8e3, 0xf8e4, 0xf8e5, 0xf8e6, 0xf8e7, 0xf8e8, 0xf8e9, 0xf8ea, 0xf8eb, 0xf8ec, 0xf8ed, 0xf8ee, 0xf8ef, 0xf8f0, 0xf8f1, 0xf8f2, 0xf8f3, 0xf8f4, 0xf8f5, 0xf8f6, 0xf8f7, 0xf8f8, 0xf8f9, 0xf8fa, 0xf8fb, 0xf8fc, 0xf8fd, 0xf8fe, 0xfe7c, 0xfe7d, ); $pattern = preg_quote(utf8_from_unicode($UTF8_SPECIAL_CHARS), '/'); $pattern = '/[\x00-\x19'.$pattern.']/u'; } return $pattern; } //-------------------------------------------------------------------- /** * Checks a string for whether it contains only word characters. This * is logically equivalent to the \w PCRE meta character. Note that * this is not a 100% guarantee that the string only contains alpha / * numeric characters but just that common non-alphanumeric are not * in the string, including ASCII device control characters. * @package utf8 * @param string to check * @return boolean TRUE if the string only contains word characters * @see utf8_specials_pattern */ function utf8_is_word_chars($str) { return !(bool)preg_match(utf8_specials_pattern(),$str); } //-------------------------------------------------------------------- /** * Removes special characters (nonalphanumeric) from a UTF-8 string * * This can be useful as a helper for sanitizing a string for use as * something like a file name or a unique identifier. Be warned though * it does not handle all possible non-alphanumeric characters and is * not intended is some kind of security / injection filter. * * @package utf8 * @author Andreas Gohr <andi@splitbrain.org> * @param string $string The UTF8 string to strip of special chars * @param string (optional) $repl Replace special with this string * @return string with common non-alphanumeric characters removed * @see utf8_specials_pattern */ function utf8_strip_specials($string, $repl=''){ return preg_replace(utf8_specials_pattern(), $repl, $string); } PK c�\�ь�J J string/src/phputf8/ord.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to ord * Returns the unicode ordinal for a character * * Joomla modification - As of PHP 7.4, curly brace access has been deprecated. As a result this function has been * modified to use square brace syntax * See https://github.com/php/php-src/commit/d574df63dc375f5fc9202ce5afde23f866b6450a * for additional references * * @param string UTF-8 encoded character * @return int unicode ordinal for the character * @see http://www.php.net/ord * @see http://www.php.net/manual/en/function.ord.php#46267 */ function utf8_ord($chr) { $ord0 = ord($chr); if ( $ord0 >= 0 && $ord0 <= 127 ) { return $ord0; } if ( !isset($chr[1]) ) { trigger_error('Short sequence - at least 2 bytes expected, only 1 seen'); return FALSE; } $ord1 = ord($chr[1]); if ( $ord0 >= 192 && $ord0 <= 223 ) { return ( $ord0 - 192 ) * 64 + ( $ord1 - 128 ); } if ( !isset($chr[2]) ) { trigger_error('Short sequence - at least 3 bytes expected, only 2 seen'); return FALSE; } $ord2 = ord($chr[2]); if ( $ord0 >= 224 && $ord0 <= 239 ) { return ($ord0-224)*4096 + ($ord1-128)*64 + ($ord2-128); } if ( !isset($chr[3]) ) { trigger_error('Short sequence - at least 4 bytes expected, only 3 seen'); return FALSE; } $ord3 = ord($chr[3]); if ($ord0>=240 && $ord0<=247) { return ($ord0-240)*262144 + ($ord1-128)*4096 + ($ord2-128)*64 + ($ord3-128); } if ( !isset($chr[4]) ) { trigger_error('Short sequence - at least 5 bytes expected, only 4 seen'); return FALSE; } $ord4 = ord($chr[4]); if ($ord0>=248 && $ord0<=251) { return ($ord0-248)*16777216 + ($ord1-128)*262144 + ($ord2-128)*4096 + ($ord3-128)*64 + ($ord4-128); } if ( !isset($chr[5]) ) { trigger_error('Short sequence - at least 6 bytes expected, only 5 seen'); return FALSE; } if ($ord0>=252 && $ord0<=253) { return ($ord0-252) * 1073741824 + ($ord1-128)*16777216 + ($ord2-128)*262144 + ($ord3-128)*4096 + ($ord4-128)*64 + (ord($chr[5])-128); } if ( $ord0 >= 254 && $ord0 <= 255 ) { trigger_error('Invalid UTF-8 with surrogate ordinal '.$ord0); return FALSE; } } PK c�\� ��� � string/src/phputf8/READMEnu �[��� ++PHP UTF-8++ Version 0.5 ++DOCUMENTATION++ Documentation in progress in ./docs dir http://www.phpwact.org/php/i18n/charsets http://www.phpwact.org/php/i18n/utf-8 Important Note: DO NOT use these functions without understanding WHY you are using them. In particular, do not blindly replace all use of PHP's string functions which functions found here - most of the time you will not need to, and you will be introducing a significant performance overhead to your application. You can get a good idea of when to use what from reading: http://www.phpwact.org/php/i18n/utf-8 Important Note: For sake of performance most of the functions here are not "defensive" (e.g. there is not extensive parameter checking, well formed UTF-8 is assumed). This is particularily relevant when is comes to catching badly formed UTF-8 - you should screen input on the "outer perimeter" with help from functions in the utf8_validation.php and utf8_bad.php files. Important Note: this library treats ALL ASCII characters as valid, including ASCII control characters. But if you use some ASCII control characters in XML, it will render the XML ill-formed. Don't be a bozo: http://hsivonen.iki.fi/producing-xml/#controlchar ++BUGS / SUPPORT / FEATURE REQUESTS ++ Please report bugs to: http://sourceforge.net/tracker/?group_id=142846&atid=753842 - if you are able, please submit a failing unit test (http://www.lastcraft.com/simple_test.php) with your bug report. For feature requests / faster implementation of functions found here, please drop them in via the RFE tracker: http://sourceforge.net/tracker/?group_id=142846&atid=753845 Particularily interested in faster implementations! For general support / help, use: http://sourceforge.net/tracker/?group_id=142846&atid=753843 In the VERY WORST case, you can email me: hfuecks gmail com - I tend to be slow to respond though so be warned. Important Note: when reporting bugs, please provide the following information; PHP version, whether the iconv extension is loaded (in PHP5 it's there by default), whether the mbstring extension is loaded. The following PHP script can be used to determine this information; <?php print "PHP Version: " .phpversion()."<br>"; if ( extension_loaded('mbstring') ) { print "mbstring available<br>"; } else { print "mbstring not available<br>"; } if ( extension_loaded('iconv') ) { print "iconv available<br>"; } else { print "iconv not available<br>"; } ?> ++LICENSING++ Parts of the code in this library come from other places, under different licenses. The authors involved have been contacted (see below). Attribution for which code came from elsewhere can be found in the source code itself. +Andreas Gohr / Chris Smith - Dokuwiki There is a fair degree of collaboration / exchange of ideas and code beteen Dokuwiki's UTF-8 library; http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php and phputf8. Although Dokuwiki is released under GPL, its UTF-8 library is released under LGPL, hence no conflict with phputf8 +Henri Sivonen (http://hsivonen.iki.fi/php-utf8/ / http://hsivonen.iki.fi/php-utf8/) has also given permission for his code to be released under the terms of the LGPL. He ported a Unicode / UTF-8 converter from the Mozilla codebase to PHP, which is re-used in phputf8 PK c�\iؚ� string/src/phputf8/stristr.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to stristr * Find first occurrence of a string using case insensitive comparison * Note: requires utf8_strtolower * @param string * @param string * @return int * @see http://www.php.net/strcasecmp * @see utf8_strtolower * @package utf8 */ function utf8_stristr($str, $search) { if ( strlen($search) == 0 ) { return $str; } $lstr = utf8_strtolower($str); $lsearch = utf8_strtolower($search); //JOOMLA SPECIFIC FIX - BEGIN preg_match('/^(.*)'.preg_quote($lsearch, '/').'/Us',$lstr, $matches); //JOOMLA SPECIFIC FIX - END if ( count($matches) == 2 ) { return substr($str, strlen($matches[1])); } return FALSE; } PK c�\��{�� � string/src/phputf8/strrev.phpnu �[��� <?php /** * @package utf8 */ //--------------------------------------------------------------- /** * UTF-8 aware alternative to strrev * Reverse a string * @param string UTF-8 encoded * @return string characters in string reverses * @see http://www.php.net/strrev * @package utf8 */ function utf8_strrev($str){ preg_match_all('/./us', $str, $ar); return join('',array_reverse($ar[0])); } PK c�\�7�k>g >g string/src/phputf8/LICENSEnu �[��� GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999 Copyright (C) 1991, 1999 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. [This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.] Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This license, the Lesser General Public License, applies to some specially designated software packages--typically libraries--of the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the explanations below. When we speak of free software, we are referring to freedom of use, 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 this service if you wish); that you receive source code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are informed that you can do these things. To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it. For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must provide complete object files to the recipients, so that they can relink them with the library after making changes to the library and recompiling it. And you must show them these terms so they know their rights. We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library. To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the original author's reputation will not be affected by problems that might be introduced by others. Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license. Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU Lesser General Public License, applies to certain designated libraries, and is quite different from the ordinary General Public License. We use this license for certain libraries in order to permit linking those libraries into non-free programs. When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library. We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license provides advantages in certain special circumstances. For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it becomes a de-facto standard. To achieve this, non-free programs must be allowed to use the library. A more frequent case is that a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License. In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the whole GNU operating system, as well as its variant, the GNU/Linux operating system. Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library. The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run. GNU LESSER GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this License"). Each licensee is addressed as "you". A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".) "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library. Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does. 1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) The modified work must itself be a software library. b) You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change. c) You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License. d) If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful. (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library. In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices. Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy. This option is useful when you wish to copy part of the code of the Library into a program that is not a library. 4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange. If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code. 5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License. However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables. When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law. If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.) Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. 6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things: a) Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.) b) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time a copy of the library already present on the user's computer system, rather than copying library functions into the executable, and (2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is interface-compatible with the version that the work was made with. c) Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution. d) If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place. e) Verify that the user has already received a copy of these materials or that you have already sent this user a copy. For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute. 7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above. b) Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it. 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties with this License. 11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 13. The Free Software Foundation may publish revised and/or new versions of the Lesser 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 Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation. 14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "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 LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY 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 LIBRARY (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 LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Libraries If you develop a new library, and you want it to be of the greatest possible use to the public, we recommend making it free software that everyone can redistribute and change. You can do so by permitting redistribution under these terms (or, alternatively, under the terms of the ordinary General Public License). To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the library's name and a brief idea of what it does.> Copyright (C) <year> <name of author> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Also add information on how to contact you by electronic and paper mail. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the library `Frob' (a library for tweaking knobs) written by James Random Hacker. <signature of Ty Coon>, 1 April 1990 Ty Coon, President of Vice That's all there is to it! PK c�\��q�U �U string/src/StringHelper.phpnu �[��� <?php /** * Part of the Joomla Framework String Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\String; // PHP mbstring and iconv local configuration @ini_set('default_charset', 'UTF-8'); /** * String handling class for UTF-8 data wrapping the phputf8 library. All functions assume the validity of UTF-8 strings. * * @since 1.3.0 */ abstract class StringHelper { /** * Increment styles. * * @var array * @since 1.3.0 */ protected static $incrementStyles = [ 'dash' => [ '#-(\d+)$#', '-%d', ], 'default' => [ ['#\((\d+)\)$#', '#\(\d+\)$#'], [' (%d)', '(%d)'], ], ]; /** * Increments a trailing number in a string. * * Used to easily create distinct labels when copying objects. The method has the following styles: * * default: "Label" becomes "Label (2)" * dash: "Label" becomes "Label-2" * * @param string $string The source string. * @param string|null $style The the style (default|dash). * @param integer $n If supplied, this number is used for the copy, otherwise it is the 'next' number. * * @return string The incremented string. * * @since 1.3.0 */ public static function increment($string, $style = 'default', $n = 0) { $styleSpec = static::$incrementStyles[$style] ?? static::$incrementStyles['default']; // Regular expression search and replace patterns. if (\is_array($styleSpec[0])) { $rxSearch = $styleSpec[0][0]; $rxReplace = $styleSpec[0][1]; } else { $rxSearch = $rxReplace = $styleSpec[0]; } // New and old (existing) sprintf formats. if (\is_array($styleSpec[1])) { $newFormat = $styleSpec[1][0]; $oldFormat = $styleSpec[1][1]; } else { $newFormat = $oldFormat = $styleSpec[1]; } // Check if we are incrementing an existing pattern, or appending a new one. if (preg_match($rxSearch, $string, $matches)) { $n = empty($n) ? ($matches[1] + 1) : $n; $string = preg_replace($rxReplace, sprintf($oldFormat, $n), $string); } else { $n = empty($n) ? 2 : $n; $string .= sprintf($newFormat, $n); } return $string; } /** * Tests whether a string contains only 7bit ASCII bytes. * * You might use this to conditionally check whether a string needs handling as UTF-8 or not, potentially offering performance * benefits by using the native PHP equivalent if it's just ASCII e.g.; * * <code> * if (StringHelper::is_ascii($someString)) * { * // It's just ASCII - use the native PHP version * $someString = strtolower($someString); * } * else * { * $someString = StringHelper::strtolower($someString); * } * </code> * * @param string $str The string to test. * * @return boolean True if the string is all ASCII * * @since 1.3.0 */ public static function is_ascii($str) { return utf8_is_ascii($str); } /** * UTF-8 aware alternative to ord() * * Returns the unicode ordinal for a character. * * @param string $chr UTF-8 encoded character * * @return integer Unicode ordinal for the character * * @link https://www.php.net/ord * @since 1.4.0 */ public static function ord($chr) { return utf8_ord($chr); } /** * UTF-8 aware alternative to strpos() * * Find position of first occurrence of a string. * * @param string $str String being examined * @param string $search String being searched for * @param integer|null|boolean $offset Optional, specifies the position from which the search should be performed * * @return integer|boolean Number of characters before the first match or FALSE on failure * * @link https://www.php.net/strpos * @since 1.3.0 */ public static function strpos($str, $search, $offset = false) { if ($offset === false) { return utf8_strpos($str, $search); } return utf8_strpos($str, $search, $offset); } /** * UTF-8 aware alternative to strrpos() * * Finds position of last occurrence of a string. * * @param string $str String being examined. * @param string $search String being searched for. * @param integer $offset Offset from the left of the string. * * @return integer|boolean Number of characters before the last match or false on failure * * @link https://www.php.net/strrpos * @since 1.3.0 */ public static function strrpos($str, $search, $offset = 0) { return utf8_strrpos($str, $search, $offset); } /** * UTF-8 aware alternative to substr() * * Return part of a string given character offset (and optionally length). * * @param string $str String being processed * @param integer $offset Number of UTF-8 characters offset (from left) * @param integer|null|boolean $length Optional length in UTF-8 characters from offset * * @return string|boolean * * @link https://www.php.net/substr * @since 1.3.0 */ public static function substr($str, $offset, $length = false) { if ($length === false) { return utf8_substr($str, $offset); } return utf8_substr($str, $offset, $length); } /** * UTF-8 aware alternative to strtolower() * * Make a string lowercase * * Note: The concept of a characters "case" only exists is some alphabets such as Latin, Greek, Cyrillic, Armenian and archaic Georgian - it does * not exist in the Chinese alphabet, for example. See Unicode Standard Annex #21: Case Mappings * * @param string $str String being processed * * @return string|boolean Either string in lowercase or FALSE is UTF-8 invalid * * @link https://www.php.net/strtolower * @since 1.3.0 */ public static function strtolower($str) { return utf8_strtolower($str); } /** * UTF-8 aware alternative to strtoupper() * * Make a string uppercase * * Note: The concept of a characters "case" only exists is some alphabets such as Latin, Greek, Cyrillic, Armenian and archaic Georgian - it does * not exist in the Chinese alphabet, for example. See Unicode Standard Annex #21: Case Mappings * * @param string $str String being processed * * @return string|boolean Either string in uppercase or FALSE is UTF-8 invalid * * @link https://www.php.net/strtoupper * @since 1.3.0 */ public static function strtoupper($str) { return utf8_strtoupper($str); } /** * UTF-8 aware alternative to strlen() * * Returns the number of characters in the string (NOT THE NUMBER OF BYTES). * * @param string $str UTF-8 string. * * @return integer Number of UTF-8 characters in string. * * @link https://www.php.net/strlen * @since 1.3.0 */ public static function strlen($str) { return utf8_strlen($str); } /** * UTF-8 aware alternative to str_ireplace() * * Case-insensitive version of str_replace() * * @param string $search String to search * @param string $replace Existing string to replace * @param string $str New string to replace with * @param integer|null|boolean $count Optional count value to be passed by referene * * @return string UTF-8 String * * @link https://www.php.net/str_ireplace * @since 1.3.0 */ public static function str_ireplace($search, $replace, $str, $count = null) { if ($count === false) { return utf8_ireplace($search, $replace, $str); } return utf8_ireplace($search, $replace, $str, $count); } /** * UTF-8 aware alternative to str_pad() * * Pad a string to a certain length with another string. * $padStr may contain multi-byte characters. * * @param string $input The input string. * @param integer $length If the value is negative, less than, or equal to the length of the input string, no padding takes place. * @param string $padStr The string may be truncated if the number of padding characters can't be evenly divided by the string's length. * @param integer $type The type of padding to apply * * @return string * * @link https://www.php.net/str_pad * @since 1.4.0 */ public static function str_pad($input, $length, $padStr = ' ', $type = STR_PAD_RIGHT) { return utf8_str_pad($input, $length, $padStr, $type); } /** * UTF-8 aware alternative to str_split() * * Convert a string to an array. * * @param string $str UTF-8 encoded string to process * @param integer $splitLen Number to characters to split string by * * @return array|string|boolean * * @link https://www.php.net/str_split * @since 1.3.0 */ public static function str_split($str, $splitLen = 1) { return utf8_str_split($str, $splitLen); } /** * UTF-8/LOCALE aware alternative to strcasecmp() * * A case insensitive string comparison. * * @param string $str1 string 1 to compare * @param string $str2 string 2 to compare * @param string|boolean $locale The locale used by strcoll or false to use classical comparison * * @return integer < 0 if str1 is less than str2; > 0 if str1 is greater than str2, and 0 if they are equal. * * @link https://www.php.net/strcasecmp * @link https://www.php.net/strcoll * @link https://www.php.net/setlocale * @since 1.3.0 */ public static function strcasecmp($str1, $str2, $locale = false) { if ($locale === false) { return utf8_strcasecmp($str1, $str2); } // Get current locale $locale0 = setlocale(LC_COLLATE, 0); if (!$locale = setlocale(LC_COLLATE, $locale)) { $locale = $locale0; } // See if we have successfully set locale to UTF-8 if (!stristr($locale, 'UTF-8') && stristr($locale, '_') && preg_match('~\.(\d+)$~', $locale, $m)) { $encoding = 'CP' . $m[1]; } elseif (stristr($locale, 'UTF-8') || stristr($locale, 'utf8')) { $encoding = 'UTF-8'; } else { $encoding = 'nonrecodable'; } // If we successfully set encoding it to utf-8 or encoding is sth weird don't recode if ($encoding == 'UTF-8' || $encoding == 'nonrecodable') { return strcoll(utf8_strtolower($str1), utf8_strtolower($str2)); } return strcoll( static::transcode(utf8_strtolower($str1), 'UTF-8', $encoding), static::transcode(utf8_strtolower($str2), 'UTF-8', $encoding) ); } /** * UTF-8/LOCALE aware alternative to strcmp() * * A case sensitive string comparison. * * @param string $str1 string 1 to compare * @param string $str2 string 2 to compare * @param mixed $locale The locale used by strcoll or false to use classical comparison * * @return integer < 0 if str1 is less than str2; > 0 if str1 is greater than str2, and 0 if they are equal. * * @link https://www.php.net/strcmp * @link https://www.php.net/strcoll * @link https://www.php.net/setlocale * @since 1.3.0 */ public static function strcmp($str1, $str2, $locale = false) { if ($locale) { // Get current locale $locale0 = setlocale(LC_COLLATE, 0); if (!$locale = setlocale(LC_COLLATE, $locale)) { $locale = $locale0; } // See if we have successfully set locale to UTF-8 if (!stristr($locale, 'UTF-8') && stristr($locale, '_') && preg_match('~\.(\d+)$~', $locale, $m)) { $encoding = 'CP' . $m[1]; } elseif (stristr($locale, 'UTF-8') || stristr($locale, 'utf8')) { $encoding = 'UTF-8'; } else { $encoding = 'nonrecodable'; } // If we successfully set encoding it to utf-8 or encoding is sth weird don't recode if ($encoding == 'UTF-8' || $encoding == 'nonrecodable') { return strcoll($str1, $str2); } return strcoll(static::transcode($str1, 'UTF-8', $encoding), static::transcode($str2, 'UTF-8', $encoding)); } return strcmp($str1, $str2); } /** * UTF-8 aware alternative to strcspn() * * Find length of initial segment not matching mask. * * @param string $str The string to process * @param string $mask The mask * @param integer|boolean $start Optional starting character position (in characters) * @param integer|boolean $length Optional length * * @return integer The length of the initial segment of str1 which does not contain any of the characters in str2 * * @link https://www.php.net/strcspn * @since 1.3.0 */ public static function strcspn($str, $mask, $start = null, $length = null) { if ($start === false && $length === false) { return utf8_strcspn($str, $mask); } if ($length === false) { return utf8_strcspn($str, $mask, $start); } return utf8_strcspn($str, $mask, $start, $length); } /** * UTF-8 aware alternative to stristr() * * Returns all of haystack from the first occurrence of needle to the end. Needle and haystack are examined in a case-insensitive manner to * find the first occurrence of a string using case insensitive comparison. * * @param string $str The haystack * @param string $search The needle * * @return string|boolean * * @link https://www.php.net/stristr * @since 1.3.0 */ public static function stristr($str, $search) { return utf8_stristr($str, $search); } /** * UTF-8 aware alternative to strrev() * * Reverse a string. * * @param string $str String to be reversed * * @return string The string in reverse character order * * @link https://www.php.net/strrev * @since 1.3.0 */ public static function strrev($str) { return utf8_strrev($str); } /** * UTF-8 aware alternative to strspn() * * Find length of initial segment matching mask. * * @param string $str The haystack * @param string $mask The mask * @param integer|null $start Start optional * @param integer|null $length Length optional * * @return integer * * @link https://www.php.net/strspn * @since 1.3.0 */ public static function strspn($str, $mask, $start = null, $length = null) { if ($start === null && $length === null) { return utf8_strspn($str, $mask); } if ($length === null) { return utf8_strspn($str, $mask, $start); } return utf8_strspn($str, $mask, $start, $length); } /** * UTF-8 aware alternative to substr_replace() * * Replace text within a portion of a string. * * @param string $str The haystack * @param string $repl The replacement string * @param integer $start Start * @param integer|boolean|null $length Length (optional) * * @return string * * @link https://www.php.net/substr_replace * @since 1.3.0 */ public static function substr_replace($str, $repl, $start, $length = null) { // Loaded by library loader if ($length === false) { return utf8_substr_replace($str, $repl, $start); } return utf8_substr_replace($str, $repl, $start, $length); } /** * UTF-8 aware replacement for ltrim() * * Strip whitespace (or other characters) from the beginning of a string. You only need to use this if you are supplying the charlist * optional arg and it contains UTF-8 characters. Otherwise ltrim will work normally on a UTF-8 string. * * @param string $str The string to be trimmed * @param string|boolean $charlist The optional charlist of additional characters to trim * * @return string The trimmed string * * @link https://www.php.net/ltrim * @since 1.3.0 */ public static function ltrim($str, $charlist = false) { if (empty($charlist) && $charlist !== false) { return $str; } if ($charlist === false) { return utf8_ltrim($str); } return utf8_ltrim($str, $charlist); } /** * UTF-8 aware replacement for rtrim() * * Strip whitespace (or other characters) from the end of a string. You only need to use this if you are supplying the charlist * optional arg and it contains UTF-8 characters. Otherwise rtrim will work normally on a UTF-8 string. * * @param string $str The string to be trimmed * @param string|boolean $charlist The optional charlist of additional characters to trim * * @return string The trimmed string * * @link https://www.php.net/rtrim * @since 1.3.0 */ public static function rtrim($str, $charlist = false) { if (empty($charlist) && $charlist !== false) { return $str; } if ($charlist === false) { return utf8_rtrim($str); } return utf8_rtrim($str, $charlist); } /** * UTF-8 aware replacement for trim() * * Strip whitespace (or other characters) from the beginning and end of a string. You only need to use this if you are supplying the charlist * optional arg and it contains UTF-8 characters. Otherwise trim will work normally on a UTF-8 string * * @param string $str The string to be trimmed * @param string|boolean $charlist The optional charlist of additional characters to trim * * @return string The trimmed string * * @link https://www.php.net/trim * @since 1.3.0 */ public static function trim($str, $charlist = false) { if (empty($charlist) && $charlist !== false) { return $str; } if ($charlist === false) { return utf8_trim($str); } return utf8_trim($str, $charlist); } /** * UTF-8 aware alternative to ucfirst() * * Make a string's first character uppercase or all words' first character uppercase. * * @param string $str String to be processed * @param string|null $delimiter The words delimiter (null means do not split the string) * @param string|null $newDelimiter The new words delimiter (null means equal to $delimiter) * * @return string If $delimiter is null, return the string with first character as upper case (if applicable) * else consider the string of words separated by the delimiter, apply the ucfirst to each words * and return the string with the new delimiter * * @link https://www.php.net/ucfirst * @since 1.3.0 */ public static function ucfirst($str, $delimiter = null, $newDelimiter = null) { if ($delimiter === null) { return utf8_ucfirst($str); } if ($newDelimiter === null) { $newDelimiter = $delimiter; } return implode($newDelimiter, array_map('utf8_ucfirst', explode($delimiter, $str))); } /** * UTF-8 aware alternative to ucwords() * * Uppercase the first character of each word in a string. * * @param string $str String to be processed * * @return string String with first char of each word uppercase * * @link https://www.php.net/ucwords * @since 1.3.0 */ public static function ucwords($str) { return utf8_ucwords($str); } /** * Transcode a string. * * @param string $source The string to transcode. * @param string $fromEncoding The source encoding. * @param string $toEncoding The target encoding. * * @return string|null The transcoded string, or null if the source was not a string. * * @link https://bugs.php.net/bug.php?id=48147 * * @since 1.3.0 */ public static function transcode($source, $fromEncoding, $toEncoding) { switch (ICONV_IMPL) { case 'glibc': return @iconv($fromEncoding, $toEncoding . '//TRANSLIT,IGNORE', $source); case 'libiconv': default: return iconv($fromEncoding, $toEncoding . '//IGNORE//TRANSLIT', $source); } } /** * Tests a string as to whether it's valid UTF-8 and supported by the Unicode standard. * * Note: this function has been modified to simple return true or false. * * @param string $str UTF-8 encoded string. * * @return boolean true if valid * * @author <hsivonen@iki.fi> * @link https://hsivonen.fi/php-utf8/ * @see compliant * @since 1.3.0 */ public static function valid($str) { return utf8_is_valid($str); } /** * Tests whether a string complies as UTF-8. * * This will be much faster than StringHelper::valid() but will pass five and six octet UTF-8 sequences, which are not supported by Unicode and * so cannot be displayed correctly in a browser. In other words it is not as strict as StringHelper::valid() but it's faster. If you use it to * validate user input, you place yourself at the risk that attackers will be able to inject 5 and 6 byte sequences (which may or may not be a * significant risk, depending on what you are are doing). * * @param string $str UTF-8 string to check * * @return boolean TRUE if string is valid UTF-8 * * @see StringHelper::valid * @link https://www.php.net/manual/en/reference.pcre.pattern.modifiers.php#54805 * @since 1.3.0 */ public static function compliant($str) { return utf8_compliant($str); } /** * Converts Unicode sequences to UTF-8 string. * * @param string $str Unicode string to convert * * @return string UTF-8 string * * @since 1.3.0 */ public static function unicode_to_utf8($str) { if (\extension_loaded('mbstring')) { return preg_replace_callback( '/\\\\u([0-9a-fA-F]{4})/', static function ($match) { return mb_convert_encoding(pack('H*', $match[1]), 'UTF-8', 'UCS-2BE'); }, $str ); } return $str; } /** * Converts Unicode sequences to UTF-16 string. * * @param string $str Unicode string to convert * * @return string UTF-16 string * * @since 1.3.0 */ public static function unicode_to_utf16($str) { if (\extension_loaded('mbstring')) { return preg_replace_callback( '/\\\\u([0-9a-fA-F]{4})/', static function ($match) { return mb_convert_encoding(pack('H*', $match[1]), 'UTF-8', 'UTF-16BE'); }, $str ); } return $str; } } PK c�\A;b�g g string/src/Normalise.phpnu �[��� <?php /** * Part of the Joomla Framework String Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\String; /** * Joomla Framework String Normalise Class * * @since 1.0 */ abstract class Normalise { /** * Method to convert a string from camel case. * * This method offers two modes. Grouped allows for splitting on groups of uppercase characters as follows: * * "FooBarABCDef" becomes array("Foo", "Bar", "ABC", "Def") * "JFooBar" becomes array("J", "Foo", "Bar") * "J001FooBar002" becomes array("J001", "Foo", "Bar002") * "abcDef" becomes array("abc", "Def") * "abc_defGhi_Jkl" becomes array("abc_def", "Ghi_Jkl") * "ThisIsA_NASAAstronaut" becomes array("This", "Is", "A_NASA", "Astronaut")) * "JohnFitzgerald_Kennedy" becomes array("John", "Fitzgerald_Kennedy")) * * Non-grouped will split strings at each uppercase character. * * @param string $input The string input (ASCII only). * @param boolean $grouped Optionally allows splitting on groups of uppercase characters. * * @return array|string The space separated string, as an array if grouped. * * @since 1.0 */ public static function fromCamelCase($input, $grouped = false) { return $grouped ? preg_split('/(?<=[^A-Z_])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][^A-Z_])/x', $input) : trim(preg_replace('#([A-Z])#', ' $1', $input)); } /** * Method to convert a string into camel case. * * @param string $input The string input (ASCII only). * * @return string The camel case string. * * @since 1.0 */ public static function toCamelCase($input) { // Convert words to uppercase and then remove spaces. $input = static::toSpaceSeparated($input); $input = ucwords($input); $input = str_ireplace(' ', '', $input); return $input; } /** * Method to convert a string into dash separated form. * * @param string $input The string input (ASCII only). * * @return string The dash separated string. * * @since 1.0 */ public static function toDashSeparated($input) { // Convert spaces and underscores to dashes. return preg_replace('#[ \-_]+#', '-', $input); } /** * Method to convert a string into space separated form. * * @param string $input The string input (ASCII only). * * @return string The space separated string. * * @since 1.0 */ public static function toSpaceSeparated($input) { // Convert underscores and dashes to spaces. return preg_replace('#[ \-_]+#', ' ', $input); } /** * Method to convert a string into underscore separated form. * * @param string $input The string input (ASCII only). * * @return string The underscore separated string. * * @since 1.0 */ public static function toUnderscoreSeparated($input) { // Convert spaces and dashes to underscores. return preg_replace('#[ \-_]+#', '_', $input); } /** * Method to convert a string into variable form. * * @param string $input The string input (ASCII only). * * @return string The variable string. * * @since 1.0 */ public static function toVariable($input) { // Remove dashes and underscores, then convert to camel case. $input = static::toCamelCase($input); // Remove leading digits. $input = preg_replace('#^[0-9]+#', '', $input); // Lowercase the first character. $input = lcfirst($input); return $input; } /** * Method to convert a string into key form. * * @param string $input The string input (ASCII only). * * @return string The key string. * * @since 1.0 */ public static function toKey($input) { // Remove spaces and dashes, then convert to lower case. return strtolower(static::toUnderscoreSeparated($input)); } } PK c�\� ��o o string/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: 3a2b0669b2c8e3438124f8821d7dba1912173bb7728d188d1db809633267af10 ... PK c�\�P�E �E string/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�P�E �E utilities/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�P��o o utilities/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: 53b2e31d7148b37325b352c72da198b026bf9498b63062126d51043eace4eec2 ... PK c�\�+�m� � utilities/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\�jv�0 0 utilities/src/IpHelper.phpnu �[��� <?php /** * Part of the Joomla Framework Utilities Package * * @copyright Copyright (C) 2010-2016 Nicholas K. Dionysopoulos / Akeeba Ltd. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE.txt * @note This file has been modified by the Joomla! Project and no longer reflects the original work of its author. */ namespace Joomla\Utilities; /** * IpHelper is a utility class for processing IP addresses * * @since 1.6.0 */ final class IpHelper { /** * The IP address of the current visitor * * @var string * @since 1.6.0 */ private static $ip = null; /** * Should I allow IP overrides through X-Forwarded-For or Client-Ip HTTP headers? * * @var boolean * @since 1.6.0 * @note The default value is false in version 2.0+ */ private static $allowIpOverrides = false; /** * Private constructor to prevent instantiation of this class * * @since 1.6.0 */ private function __construct() { } /** * Get the current visitor's IP address * * @return string * * @since 1.6.0 */ public static function getIp() { if (self::$ip === null) { $ip = static::detectAndCleanIP(); if (!empty($ip) && ($ip != '0.0.0.0') && \function_exists('inet_pton') && \function_exists('inet_ntop')) { $myIP = @inet_pton($ip); if ($myIP !== false) { $ip = inet_ntop($myIP); } } static::setIp($ip); } return self::$ip; } /** * Set the IP address of the current visitor * * @param string $ip The visitor's IP address * * @return void * * @since 1.6.0 */ public static function setIp($ip) { self::$ip = $ip; } /** * Is it an IPv6 IP address? * * @param string $ip An IPv4 or IPv6 address * * @return boolean * * @since 1.6.0 */ public static function isIPv6($ip) { return strpos($ip, ':') !== false; } /** * Checks if an IP is contained in a list of IPs or IP expressions * * @param string $ip The IPv4/IPv6 address to check * @param array|string $ipTable An IP expression (or a comma-separated or array list of IP expressions) to check against * * @return boolean * * @since 1.6.0 */ public static function IPinList($ip, $ipTable = '') { // No point proceeding with an empty IP list if (empty($ipTable)) { return false; } // If the IP list is not an array, convert it to an array if (!\is_array($ipTable)) { if (strpos($ipTable, ',') !== false) { $ipTable = explode(',', $ipTable); $ipTable = array_map('trim', $ipTable); } else { $ipTable = trim($ipTable); $ipTable = array($ipTable); } } // If no IP address is found, return false if ($ip === '0.0.0.0') { return false; } // If no IP is given, return false if (empty($ip)) { return false; } // Sanity check if (!\function_exists('inet_pton')) { return false; } // Get the IP's in_adds representation $myIP = @inet_pton($ip); // If the IP is in an unrecognisable format, quite if ($myIP === false) { return false; } $ipv6 = static::isIPv6($ip); foreach ($ipTable as $ipExpression) { $ipExpression = trim($ipExpression); // Inclusive IP range, i.e. 123.123.123.123-124.125.126.127 if (strstr($ipExpression, '-')) { list($from, $to) = explode('-', $ipExpression, 2); if ($ipv6 && (!static::isIPv6($from) || !static::isIPv6($to))) { // Do not apply IPv4 filtering on an IPv6 address continue; } if (!$ipv6 && (static::isIPv6($from) || static::isIPv6($to))) { // Do not apply IPv6 filtering on an IPv4 address continue; } $from = @inet_pton(trim($from)); $to = @inet_pton(trim($to)); // Sanity check if (($from === false) || ($to === false)) { continue; } // Swap from/to if they're in the wrong order if ($from > $to) { list($from, $to) = array($to, $from); } if (($myIP >= $from) && ($myIP <= $to)) { return true; } } // Netmask or CIDR provided elseif (strstr($ipExpression, '/')) { $binaryip = static::inetToBits($myIP); list($net, $maskbits) = explode('/', $ipExpression, 2); if ($ipv6 && !static::isIPv6($net)) { // Do not apply IPv4 filtering on an IPv6 address continue; } if (!$ipv6 && static::isIPv6($net)) { // Do not apply IPv6 filtering on an IPv4 address continue; } if ($ipv6 && strstr($maskbits, ':')) { // Perform an IPv6 CIDR check if (static::checkIPv6CIDR($myIP, $ipExpression)) { return true; } // If we didn't match it proceed to the next expression continue; } if (!$ipv6 && strstr($maskbits, '.')) { // Convert IPv4 netmask to CIDR $long = ip2long($maskbits); $base = ip2long('255.255.255.255'); $maskbits = 32 - log(($long ^ $base) + 1, 2); } // Convert network IP to in_addr representation $net = @inet_pton($net); // Sanity check if ($net === false) { continue; } // Get the network's binary representation $expectedNumberOfBits = $ipv6 ? 128 : 24; $binarynet = str_pad(static::inetToBits($net), $expectedNumberOfBits, '0', STR_PAD_RIGHT); // Check the corresponding bits of the IP and the network $ipNetBits = substr($binaryip, 0, $maskbits); $netBits = substr($binarynet, 0, $maskbits); if ($ipNetBits === $netBits) { return true; } } else { // IPv6: Only single IPs are supported if ($ipv6) { $ipExpression = trim($ipExpression); if (!static::isIPv6($ipExpression)) { continue; } $ipCheck = @inet_pton($ipExpression); if ($ipCheck === false) { continue; } if ($ipCheck == $myIP) { return true; } } else { // Standard IPv4 address, i.e. 123.123.123.123 or partial IP address, i.e. 123.[123.][123.][123] $dots = 0; if (substr($ipExpression, -1) == '.') { // Partial IP address. Convert to CIDR and re-match foreach (count_chars($ipExpression, 1) as $i => $val) { if ($i == 46) { $dots = $val; } } switch ($dots) { case 1: $netmask = '255.0.0.0'; $ipExpression .= '0.0.0'; break; case 2: $netmask = '255.255.0.0'; $ipExpression .= '0.0'; break; case 3: $netmask = '255.255.255.0'; $ipExpression .= '0'; break; default: $dots = 0; } if ($dots) { $binaryip = static::inetToBits($myIP); // Convert netmask to CIDR $long = ip2long($netmask); $base = ip2long('255.255.255.255'); $maskbits = 32 - log(($long ^ $base) + 1, 2); $net = @inet_pton($ipExpression); // Sanity check if ($net === false) { continue; } // Get the network's binary representation $expectedNumberOfBits = $ipv6 ? 128 : 24; $binarynet = str_pad(static::inetToBits($net), $expectedNumberOfBits, '0', STR_PAD_RIGHT); // Check the corresponding bits of the IP and the network $ipNetBits = substr($binaryip, 0, $maskbits); $netBits = substr($binarynet, 0, $maskbits); if ($ipNetBits === $netBits) { return true; } } } if (!$dots) { $ip = @inet_pton(trim($ipExpression)); if ($ip == $myIP) { return true; } } } } } return false; } /** * Works around the REMOTE_ADDR not containing the user's IP * * @return void * * @since 1.6.0 */ public static function workaroundIPIssues() { $ip = static::getIp(); if (isset($_SERVER['REMOTE_ADDR']) && $_SERVER['REMOTE_ADDR'] === $ip) { return; } if (isset($_SERVER['REMOTE_ADDR'])) { $_SERVER['JOOMLA_REMOTE_ADDR'] = $_SERVER['REMOTE_ADDR']; } elseif (\function_exists('getenv')) { if (getenv('REMOTE_ADDR')) { $_SERVER['JOOMLA_REMOTE_ADDR'] = getenv('REMOTE_ADDR'); } } $_SERVER['REMOTE_ADDR'] = $ip; } /** * Should I allow the remote client's IP to be overridden by an X-Forwarded-For or Client-Ip HTTP header? * * @param boolean $newState True to allow the override * * @return void * * @since 1.6.0 */ public static function setAllowIpOverrides($newState) { self::$allowIpOverrides = $newState ? true : false; } /** * Gets the visitor's IP address. * * Automatically handles reverse proxies reporting the IPs of intermediate devices, like load balancers. Examples: * * - https://www.akeebabackup.com/support/admin-tools/13743-double-ip-adresses-in-security-exception-log-warnings.html * - https://stackoverflow.com/questions/2422395/why-is-request-envremote-addr-returning-two-ips * * The solution used is assuming that the last IP address is the external one. * * @return string * * @since 1.6.0 */ protected static function detectAndCleanIP() { $ip = static::detectIP(); if (strstr($ip, ',') !== false || strstr($ip, ' ') !== false) { $ip = str_replace(' ', ',', $ip); $ip = str_replace(',,', ',', $ip); $ips = explode(',', $ip); $ip = ''; while (empty($ip) && !empty($ips)) { $ip = array_shift($ips); $ip = trim($ip); } } else { $ip = trim($ip); } return $ip; } /** * Gets the visitor's IP address * * @return string * * @since 1.6.0 */ protected static function detectIP() { // Normally the $_SERVER superglobal is set if (isset($_SERVER)) { // Do we have an x-forwarded-for HTTP header (e.g. NginX)? if (self::$allowIpOverrides && isset($_SERVER['HTTP_X_FORWARDED_FOR'])) { return $_SERVER['HTTP_X_FORWARDED_FOR']; } // Do we have a client-ip header (e.g. non-transparent proxy)? if (self::$allowIpOverrides && isset($_SERVER['HTTP_CLIENT_IP'])) { return $_SERVER['HTTP_CLIENT_IP']; } // Normal, non-proxied server or server behind a transparent proxy if (isset($_SERVER['REMOTE_ADDR'])) { return $_SERVER['REMOTE_ADDR']; } } /* * This part is executed on PHP running as CGI, or on SAPIs which do not set the $_SERVER superglobal * If getenv() is disabled, you're screwed */ if (!\function_exists('getenv')) { return ''; } // Do we have an x-forwarded-for HTTP header? if (self::$allowIpOverrides && getenv('HTTP_X_FORWARDED_FOR')) { return getenv('HTTP_X_FORWARDED_FOR'); } // Do we have a client-ip header? if (self::$allowIpOverrides && getenv('HTTP_CLIENT_IP')) { return getenv('HTTP_CLIENT_IP'); } // Normal, non-proxied server or server behind a transparent proxy if (getenv('REMOTE_ADDR')) { return getenv('REMOTE_ADDR'); } // Catch-all case for broken servers, apparently return ''; } /** * Converts inet_pton output to bits string * * @param string $inet The in_addr representation of an IPv4 or IPv6 address * * @return string * * @since 1.6.0 */ protected static function inetToBits($inet) { if (\strlen($inet) == 4) { $unpacked = unpack('A4', $inet); } else { $unpacked = unpack('A16', $inet); } $unpacked = str_split($unpacked[1]); $binaryip = ''; foreach ($unpacked as $char) { $binaryip .= str_pad(decbin(\ord($char)), 8, '0', STR_PAD_LEFT); } return $binaryip; } /** * Checks if an IPv6 address $ip is part of the IPv6 CIDR block $cidrnet * * @param string $ip The IPv6 address to check, e.g. 21DA:00D3:0000:2F3B:02AC:00FF:FE28:9C5A * @param string $cidrnet The IPv6 CIDR block, e.g. 21DA:00D3:0000:2F3B::/64 * * @return boolean * * @since 1.6.0 */ protected static function checkIPv6CIDR($ip, $cidrnet) { $ip = inet_pton($ip); $binaryip = static::inetToBits($ip); list($net, $maskbits) = explode('/', $cidrnet); $net = inet_pton($net); $binarynet = static::inetToBits($net); $ipNetBits = substr($binaryip, 0, $maskbits); $netBits = substr($binarynet, 0, $maskbits); return $ipNetBits === $netBits; } } PK c�\��iñD �D utilities/src/ArrayHelper.phpnu �[��� <?php /** * Part of the Joomla Framework Utilities Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Utilities; use Joomla\String\StringHelper; /** * ArrayHelper is an array utility class for doing all sorts of odds and ends with arrays. * * @since 1.0 */ final class ArrayHelper { /** * Private constructor to prevent instantiation of this class * * @since 1.0 */ private function __construct() { } /** * Function to convert array to integer values * * @param array $array The source array to convert * @param int|array $default A default value to assign if $array is not an array * * @return array * * @since 1.0 */ public static function toInteger($array, $default = null) { if (\is_array($array)) { return array_map('intval', $array); } if ($default === null) { return []; } if (\is_array($default)) { return static::toInteger($default, null); } return [(int) $default]; } /** * Utility function to map an array to a stdClass object. * * @param array $array The array to map. * @param string $class Name of the class to create * @param boolean $recursive Convert also any array inside the main array * * @return object * * @since 1.0 */ public static function toObject(array $array, $class = 'stdClass', $recursive = true) { $obj = new $class; foreach ($array as $k => $v) { if ($recursive && \is_array($v)) { $obj->$k = static::toObject($v, $class); } else { $obj->$k = $v; } } return $obj; } /** * Utility function to map an array to a string. * * @param array $array The array to map. * @param string $innerGlue The glue (optional, defaults to '=') between the key and the value. * @param string $outerGlue The glue (optional, defaults to ' ') between array elements. * @param boolean $keepOuterKey True if final key should be kept. * * @return string * * @since 1.0 */ public static function toString(array $array, $innerGlue = '=', $outerGlue = ' ', $keepOuterKey = false) { $output = []; foreach ($array as $key => $item) { if (\is_array($item)) { if ($keepOuterKey) { $output[] = $key; } // This is value is an array, go and do it again! $output[] = static::toString($item, $innerGlue, $outerGlue, $keepOuterKey); } else { $output[] = $key . $innerGlue . '"' . $item . '"'; } } return implode($outerGlue, $output); } /** * Utility function to map an object to an array * * @param object $source The source object * @param boolean $recurse True to recurse through multi-level objects * @param string $regex An optional regular expression to match on field names * * @return array * * @since 1.0 */ public static function fromObject($source, $recurse = true, $regex = null) { if (\is_object($source) || \is_array($source)) { return self::arrayFromObject($source, $recurse, $regex); } return []; } /** * Utility function to map an object or array to an array * * @param mixed $item The source object or array * @param boolean $recurse True to recurse through multi-level objects * @param string $regex An optional regular expression to match on field names * * @return array * * @since 1.0 */ private static function arrayFromObject($item, $recurse, $regex) { if (\is_object($item)) { $result = []; foreach (get_object_vars($item) as $k => $v) { if (!$regex || preg_match($regex, $k)) { if ($recurse) { $result[$k] = self::arrayFromObject($v, $recurse, $regex); } else { $result[$k] = $v; } } } return $result; } if (\is_array($item)) { $result = []; foreach ($item as $k => $v) { $result[$k] = self::arrayFromObject($v, $recurse, $regex); } return $result; } return $item; } /** * Adds a column to an array of arrays or objects * * @param array $array The source array * @param array $column The array to be used as new column * @param string $colName The index of the new column or name of the new object property * @param string $keyCol The index of the column or name of object property to be used for mapping with the new column * * @return array An array with the new column added to the source array * * @since 1.5.0 * @see https://www.php.net/manual/en/language.types.array.php */ public static function addColumn(array $array, array $column, $colName, $keyCol = null) { $result = []; foreach ($array as $i => $item) { $value = null; if (!isset($keyCol)) { $value = static::getValue($column, $i); } else { // Convert object to array $subject = \is_object($item) ? static::fromObject($item) : $item; if (isset($subject[$keyCol]) && is_scalar($subject[$keyCol])) { $value = static::getValue($column, $subject[$keyCol]); } } // Add the column if (\is_object($item)) { if (isset($colName)) { $item->$colName = $value; } } else { if (isset($colName)) { $item[$colName] = $value; } else { $item[] = $value; } } $result[$i] = $item; } return $result; } /** * Remove a column from an array of arrays or objects * * @param array $array The source array * @param string $colName The index of the column or name of object property to be removed * * @return array Column of values from the source array * * @since 1.5.0 * @see https://www.php.net/manual/en/language.types.array.php */ public static function dropColumn(array $array, $colName) { $result = []; foreach ($array as $i => $item) { if (\is_object($item) && isset($item->$colName)) { unset($item->$colName); } elseif (\is_array($item) && isset($item[$colName])) { unset($item[$colName]); } $result[$i] = $item; } return $result; } /** * Extracts a column from an array of arrays or objects * * @param array $array The source array * @param string $valueCol The index of the column or name of object property to be used as value * It may also be NULL to return complete arrays or objects (this is * useful together with <var>$keyCol</var> to reindex the array). * @param string $keyCol The index of the column or name of object property to be used as key * * @return array Column of values from the source array * * @since 1.0 * @see https://www.php.net/manual/en/language.types.array.php * @see https://www.php.net/manual/en/function.array-column.php */ public static function getColumn(array $array, $valueCol, $keyCol = null) { return \array_reduce( $array, function ($result, $item) use ($keyCol, $valueCol) { $array = \is_object($item) ? get_object_vars($item) : $item; if ($valueCol === null) { $value = $item; } else { if (!array_key_exists($valueCol, $array)) { return $result; } $value = $array[$valueCol]; } if ($keyCol !== null && \array_key_exists($keyCol, $array) && \is_scalar($array[$keyCol])) { $result[$array[$keyCol]] = $value; } else { $result[] = $value; } return $result; }, [] ); } /** * Utility function to return a value from a named array or a specified default * * @param array|\ArrayAccess $array A named array or object that implements ArrayAccess * @param string $name The key to search for (this can be an array index or a dot separated key sequence as in Registry) * @param mixed $default The default value to give if no key found * @param string $type Return type for the variable (INT, FLOAT, STRING, WORD, BOOLEAN, ARRAY) * * @return mixed * * @since 1.0 * @throws \InvalidArgumentException */ public static function getValue($array, $name, $default = null, $type = '') { if (!\is_array($array) && !($array instanceof \ArrayAccess)) { throw new \InvalidArgumentException('The object must be an array or an object that implements ArrayAccess'); } $result = null; if (isset($array[$name])) { $result = $array[$name]; } elseif (strpos($name, '.')) { list($name, $subset) = explode('.', $name, 2); if (isset($array[$name]) && \is_array($array[$name])) { return static::getValue($array[$name], $subset, $default, $type); } } // Handle the default case if ($result === null) { $result = $default; } // Handle the type constraint switch (strtoupper($type)) { case 'INT': case 'INTEGER': // Only use the first integer value @preg_match('/-?[0-9]+/', $result, $matches); $result = @(int) $matches[0]; break; case 'FLOAT': case 'DOUBLE': // Only use the first floating point value @preg_match('/-?[0-9]+(\.[0-9]+)?/', $result, $matches); $result = @(float) $matches[0]; break; case 'BOOL': case 'BOOLEAN': $result = (bool) $result; break; case 'ARRAY': if (!\is_array($result)) { $result = [$result]; } break; case 'STRING': $result = (string) $result; break; case 'WORD': $result = (string) preg_replace('#\W#', '', $result); break; case 'NONE': default: // No casting necessary break; } return $result; } /** * Takes an associative array of arrays and inverts the array keys to values using the array values as keys. * * Example: * $input = array( * 'New' => array('1000', '1500', '1750'), * 'Used' => array('3000', '4000', '5000', '6000') * ); * $output = ArrayHelper::invert($input); * * Output would be equal to: * $output = array( * '1000' => 'New', * '1500' => 'New', * '1750' => 'New', * '3000' => 'Used', * '4000' => 'Used', * '5000' => 'Used', * '6000' => 'Used' * ); * * @param array $array The source array. * * @return array * * @since 1.0 */ public static function invert(array $array) { $return = []; foreach ($array as $base => $values) { if (!\is_array($values)) { continue; } foreach ($values as $key) { // If the key isn't scalar then ignore it. if (is_scalar($key)) { $return[$key] = $base; } } } return $return; } /** * Method to determine if an array is an associative array. * * @param array $array An array to test. * * @return boolean * * @since 1.0 */ public static function isAssociative($array) { if (\is_array($array)) { foreach (array_keys($array) as $k => $v) { if ($k !== $v) { return true; } } } return false; } /** * Pivots an array to create a reverse lookup of an array of scalars, arrays or objects. * * @param array $source The source array. * @param string $key Where the elements of the source array are objects or arrays, the key to pivot on. * * @return array An array of arrays pivoted either on the value of the keys, or an individual key of an object or array. * * @since 1.0 */ public static function pivot(array $source, $key = null) { $result = []; $counter = []; foreach ($source as $index => $value) { // Determine the name of the pivot key, and its value. if (\is_array($value)) { // If the key does not exist, ignore it. if (!isset($value[$key])) { continue; } $resultKey = $value[$key]; $resultValue = $source[$index]; } elseif (\is_object($value)) { // If the key does not exist, ignore it. if (!isset($value->$key)) { continue; } $resultKey = $value->$key; $resultValue = $source[$index]; } else { // Just a scalar value. $resultKey = $value; $resultValue = $index; } // The counter tracks how many times a key has been used. if (empty($counter[$resultKey])) { // The first time around we just assign the value to the key. $result[$resultKey] = $resultValue; $counter[$resultKey] = 1; } elseif ($counter[$resultKey] == 1) { // If there is a second time, we convert the value into an array. $result[$resultKey] = [ $result[$resultKey], $resultValue, ]; $counter[$resultKey]++; } else { // After the second time, no need to track any more. Just append to the existing array. $result[$resultKey][] = $resultValue; } } unset($counter); return $result; } /** * Utility function to sort an array of objects on a given field * * @param array $a An array of objects * @param mixed $k The key (string) or an array of keys to sort on * @param mixed $direction Direction (integer) or an array of direction to sort in [1 = Ascending] [-1 = Descending] * @param mixed $caseSensitive Boolean or array of booleans to let sort occur case sensitive or insensitive * @param mixed $locale Boolean or array of booleans to let sort occur using the locale language or not * * @return array * * @since 1.0 */ public static function sortObjects(array $a, $k, $direction = 1, $caseSensitive = true, $locale = false) { if (!\is_array($locale) || !\is_array($locale[0])) { $locale = [$locale]; } $sortCase = (array) $caseSensitive; $sortDirection = (array) $direction; $key = (array) $k; $sortLocale = $locale; usort( $a, function ($a, $b) use ($sortCase, $sortDirection, $key, $sortLocale) { for ($i = 0, $count = \count($key); $i < $count; $i++) { if (isset($sortDirection[$i])) { $direction = $sortDirection[$i]; } if (isset($sortCase[$i])) { $caseSensitive = $sortCase[$i]; } if (isset($sortLocale[$i])) { $locale = $sortLocale[$i]; } $va = $a->{$key[$i]}; $vb = $b->{$key[$i]}; if ((\is_bool($va) || is_numeric($va)) && (\is_bool($vb) || is_numeric($vb))) { $cmp = $va - $vb; } elseif ($caseSensitive) { $cmp = StringHelper::strcmp($va, $vb, $locale); } else { $cmp = StringHelper::strcasecmp($va, $vb, $locale); } if ($cmp > 0) { return $direction; } if ($cmp < 0) { return -$direction; } } return 0; } ); return $a; } /** * Multidimensional array safe unique test * * @param array $array The array to make unique. * * @return array * * @see https://www.php.net/manual/en/function.array-unique.php * @since 1.0 */ public static function arrayUnique(array $array) { $array = array_map('serialize', $array); $array = array_unique($array); $array = array_map('unserialize', $array); return $array; } /** * An improved array_search that allows for partial matching of strings values in associative arrays. * * @param string $needle The text to search for within the array. * @param array $haystack Associative array to search in to find $needle. * @param boolean $caseSensitive True to search case sensitive, false otherwise. * * @return mixed Returns the matching array $key if found, otherwise false. * * @since 1.0 */ public static function arraySearch($needle, array $haystack, $caseSensitive = true) { foreach ($haystack as $key => $value) { $searchFunc = ($caseSensitive) ? 'strpos' : 'stripos'; if ($searchFunc($value, $needle) === 0) { return $key; } } return false; } /** * Method to recursively convert data to a one dimension array. * * @param array|object $array The array or object to convert. * @param string $separator The key separator. * @param string $prefix Last level key prefix. * * @return array * * @since 1.3.0 */ public static function flatten($array, $separator = '.', $prefix = '') { if ($array instanceof \Traversable) { $array = iterator_to_array($array); } elseif (\is_object($array)) { $array = get_object_vars($array); } $result = []; foreach ($array as $k => $v) { $key = $prefix ? $prefix . $separator . $k : $k; if (\is_object($v) || \is_array($v)) { $result[] = static::flatten($v, $separator, $key); } else { $result[] = [$key => $v]; } } return array_merge(...$result); } /** * Merge array recursively. * * @param array ...$args Array list to be merged. * * @return array Merged array. * * @since 2.0.0 * @throws \InvalidArgumentException */ public static function mergeRecursive(...$args): array { $result = []; foreach ($args as $i => $array) { if (!\is_array($array)) { throw new \InvalidArgumentException(sprintf('Argument #%d is not an array.', $i + 2)); } foreach ($array as $key => &$value) { if (\is_array($value) && isset($result[$key]) && \is_array($result[$key])) { $result[$key] = static::mergeRecursive($result [$key], $value); } else { $result[$key] = $value; } } } return $result; } } PK c�\��lG�5 �5 data/src/DataSet.phpnu �[��� <?php /** * Part of the Joomla Framework Data Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Data; /** * DataSet is a collection class that allows the developer to operate on a set of DataObjects as if they were in a typical PHP array. * * @since 1.0 */ class DataSet implements DumpableInterface, \ArrayAccess, \Countable, \Iterator { /** * The current position of the iterator. * * @var integer * @since 1.0 */ private $current = false; /** * The iterator objects. * * @var DataObject[] * @since 1.0 */ private $objects = []; /** * The class constructor. * * @param DataObject[] $objects An array of DataObject objects to bind to the data set. * * @since 1.0 * @throws \InvalidArgumentException if an object is not a DataObject. */ public function __construct(array $objects = []) { // Set the objects. $this->initialise($objects); } /** * The magic call method is used to call object methods using the iterator. * * Example: $array = $objectList->foo('bar'); * * The object list will iterate over its objects and see if each object has a callable 'foo' method. * If so, it will pass the argument list and assemble any return values. If an object does not have * a callable method no return value is recorded. * The keys of the objects and the result array are maintained. * * @param string $method The name of the method called. * @param array $arguments The arguments of the method called. * * @return array An array of values returned by the methods called on the objects in the data set. * * @since 1.0 */ public function __call($method, $arguments = []) { $return = []; // Iterate through the objects. foreach ($this->objects as $key => $object) { // Create the object callback. $callback = [$object, $method]; // Check if the callback is callable. if (\is_callable($callback)) { // Call the method for the object. $return[$key] = \call_user_func_array($callback, $arguments); } } return $return; } /** * The magic get method is used to get a list of properties from the objects in the data set. * * Example: $array = $dataSet->foo; * * This will return a column of the values of the 'foo' property in all the objects * (or values determined by custom property setters in the individual DataObject's). * The result array will contain an entry for each object in the list (compared to __call which may not). * The keys of the objects and the result array are maintained. * * @param string $property The name of the data property. * * @return array An associative array of the values. * * @since 1.0 */ public function __get($property) { $return = []; // Iterate through the objects. foreach ($this->objects as $key => $object) { // Get the property. $return[$key] = $object->$property; } return $return; } /** * The magic isset method is used to check the state of an object property using the iterator. * * Example: $array = isset($objectList->foo); * * @param string $property The name of the property. * * @return boolean True if the property is set in any of the objects in the data set. * * @since 1.0 */ public function __isset($property) { $return = []; // Iterate through the objects. foreach ($this->objects as $object) { // Check the property. $return[] = isset($object->$property); } return \in_array(true, $return, true); } /** * The magic set method is used to set an object property using the iterator. * * Example: $objectList->foo = 'bar'; * * This will set the 'foo' property to 'bar' in all of the objects * (or a value determined by custom property setters in the DataObject). * * @param string $property The name of the property. * @param mixed $value The value to give the data property. * * @return void * * @since 1.0 */ public function __set($property, $value) { // Iterate through the objects. foreach ($this->objects as $object) { // Set the property. $object->$property = $value; } } /** * The magic unset method is used to unset an object property using the iterator. * * Example: unset($objectList->foo); * * This will unset all of the 'foo' properties in the list of DataObject's. * * @param string $property The name of the property. * * @return void * * @since 1.0 */ public function __unset($property) { // Iterate through the objects. foreach ($this->objects as $object) { unset($object->$property); } } /** * Gets an array of keys, existing in objects * * @param string $type Selection type 'all' or 'common' * * @return array Array of keys * * @since 1.2.0 * @throws \InvalidArgumentException */ public function getObjectsKeys($type = 'all') { $keys = null; if ($type == 'all') { $function = 'array_merge'; } elseif ($type == 'common') { $function = 'array_intersect_key'; } else { throw new \InvalidArgumentException("Unknown selection type: $type"); } foreach ($this->objects as $object) { $objectVars = json_decode(json_encode($object), true); $keys = ($keys === null) ? $objectVars : $function($keys, $objectVars); } return array_keys($keys); } /** * Gets all objects as an array * * @param boolean $associative Option to set return mode: associative or numeric array. * @param string ...$keys Unlimited optional property names to extract from objects. * * @return array Returns an array according to defined options. * * @since 1.2.0 */ public function toArray($associative = true, ...$keys) { if (empty($keys)) { $keys = $this->getObjectsKeys(); } $return = []; $i = 0; foreach ($this->objects as $key => $object) { $arrayItem = []; $key = ($associative) ? $key : $i++; $j = 0; foreach ($keys as $property) { $propertyKey = ($associative) ? $property : $j++; $arrayItem[$propertyKey] = $object->$property ?? null; } $return[$key] = $arrayItem; } return $return; } /** * Gets the number of data objects in the set. * * @return integer The number of objects. * * @since 1.0 */ public function count() { return \count($this->objects); } /** * Clears the objects in the data set. * * @return DataSet Returns itself to allow chaining. * * @since 1.0 */ public function clear() { $this->objects = []; $this->rewind(); return $this; } /** * Get the current data object in the set. * * @return DataObject|false The current object, or false if the array is empty or the pointer is beyond the end of the elements. * * @since 1.0 */ public function current() { return is_scalar($this->current) ? $this->objects[$this->current] : false; } /** * Dumps the data object in the set, recursively if appropriate. * * @param integer $depth The maximum depth of recursion (default = 3). * For example, a depth of 0 will return a stdClass with all the properties in native * form. A depth of 1 will recurse into the first level of properties only. * @param \SplObjectStorage $dumped An array of already serialized objects that is used to avoid infinite loops. * * @return array An associative array of the data objects in the set, dumped as a simple PHP stdClass object. * * @see DataObject::dump() * @since 1.0 */ public function dump($depth = 3, \SplObjectStorage $dumped = null) { // Check if we should initialise the recursion tracker. if ($dumped === null) { $dumped = new \SplObjectStorage; } // Add this object to the dumped stack. $dumped->attach($this); $objects = []; // Make sure that we have not reached our maximum depth. if ($depth > 0) { // Handle JSON serialization recursively. foreach ($this->objects as $key => $object) { $objects[$key] = $object->dump($depth, $dumped); } } return $objects; } /** * Gets the data set in a form that can be serialised to JSON format. * * Note that this method will not return an associative array, otherwise it would be encoded into an object. * JSON decoders do not consistently maintain the order of associative keys, whereas they do maintain the order of arrays. * * @return array * * @since 1.0 */ public function jsonSerialize() { $return = []; // Iterate through the objects. foreach ($this->objects as $object) { // Call the method for the object. $return[] = $object; } return $return; } /** * Gets the key of the current object in the iterator. * * @return integer|false The object key on success; false on failure. * * @since 1.0 */ public function key() { return $this->current; } /** * Gets the array of keys for all the objects in the iterator (emulates array_keys). * * @return array The array of keys * * @since 1.0 */ public function keys() { return array_keys($this->objects); } /** * Applies a function to every object in the set (emulates array_walk). * * @param callable $funcname Callback function. * * @return boolean * * @since 1.2.0 * @throws \InvalidArgumentException */ public function walk(callable $funcname) { foreach ($this->objects as $key => $object) { $funcname($object, $key); } return true; } /** * Advances the iterator to the next object in the iterator. * * @return void * * @since 1.0 */ public function next() { // Get the object offsets. $keys = $this->keys(); // Check if _current has been set to false but offsetUnset. if ($this->current === false && isset($keys[0])) { // This is a special case where offsetUnset was used in a foreach loop and the first element was unset. $this->current = $keys[0]; } else { // Get the current key. $position = array_search($this->current, $keys); // Check if there is an object after the current object. if ($position !== false && isset($keys[$position + 1])) { // Get the next id. $this->current = $keys[$position + 1]; } else { // That was the last object or the internal properties have become corrupted. $this->current = null; } } } /** * Checks whether an offset exists in the iterator. * * @param mixed $offset The object offset. * * @return boolean * * @since 1.0 */ public function offsetExists($offset) { return isset($this->objects[$offset]); } /** * Gets an offset in the iterator. * * @param mixed $offset The object offset. * * @return DataObject|null * * @since 1.0 */ public function offsetGet($offset) { return $this->objects[$offset] ?? null; } /** * Sets an offset in the iterator. * * @param mixed $offset The object offset. * @param DataObject $object The object object. * * @return void * * @since 1.0 * @throws \InvalidArgumentException if an object is not an instance of DataObject. */ public function offsetSet($offset, $object) { if (!($object instanceof DataObject)) { throw new \InvalidArgumentException( sprintf( 'The $object argument must be an instance of "%s", a %s was given.', DataObject::class, \gettype($object) === 'object' ? \get_class($object) : \gettype($object) ) ); } // Set the offset. if ($offset === null) { $this->objects[] = $object; } else { $this->objects[$offset] = $object; } } /** * Unsets an offset in the iterator. * * @param mixed $offset The object offset. * * @return void * * @since 1.0 */ public function offsetUnset($offset) { if (!isset($this[$offset])) { // Do nothing if the offset does not exist. return; } // Check for special handling of unsetting the current position. if ($offset == $this->current) { // Get the current position. $keys = $this->keys(); $position = array_search($this->current, $keys); // Check if there is an object before the current object. if ($position > 0) { // Move the current position back one. $this->current = $keys[$position - 1]; } else { // We are at the start of the keys AND let's assume we are in a foreach loop and `next` is going to be called. $this->current = false; } } unset($this->objects[$offset]); } /** * Rewinds the iterator to the first object. * * @return void * * @since 1.0 */ public function rewind() { // Set the current position to the first object. if (empty($this->objects)) { $this->current = false; } else { $keys = $this->keys(); $this->current = array_shift($keys); } } /** * Validates the iterator. * * @return boolean * * @since 1.0 */ public function valid() { // Check the current position. if (!is_scalar($this->current) || !isset($this->objects[$this->current])) { return false; } return true; } /** * Initialises the list with an array of objects. * * @param array $input An array of objects. * * @return void * * @since 1.0 * @throws \InvalidArgumentException if an object is not a DataObject. */ private function initialise(array $input = []) { foreach ($input as $key => $object) { if ($object !== null) { $this[$key] = $object; } } $this->rewind(); } } PK c�\,�9� � data/src/DumpableInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Data Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Data; /** * An interface to define if an object is dumpable. * * @since 1.0 */ interface DumpableInterface { /** * Dumps the data properties into an object, recursively if appropriate. * * @param integer $depth The maximum depth of recursion. * For example, a depth of 0 will return a stdClass with all the properties in native * form. A depth of 1 will recurse into the first level of properties only. * @param \SplObjectStorage $dumped An array of already serialized objects that is used to avoid infinite loops. * * @return \stdClass * * @since 1.0 */ public function dump($depth = 3, \SplObjectStorage $dumped = null); } PK c�\�~a� � data/src/DataObject.phpnu �[��� <?php /** * Part of the Joomla Framework Data Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Data; use Joomla\Registry\Registry; /** * DataObject is a class that is used to store data but allowing you to access the data by mimicking the way PHP handles class properties. * * @since 1.0 */ class DataObject implements DumpableInterface, \IteratorAggregate, \JsonSerializable, \Countable { /** * The data object properties. * * @var array * @since 1.0 */ private $properties = []; /** * The class constructor. * * @param mixed $properties Either an associative array or another object by which to set the initial properties of the new object. * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct($properties = []) { // Check the properties input. if (!empty($properties)) { // Bind the properties. $this->bind($properties); } } /** * The magic get method is used to get a data property. * * This method is a public proxy for the protected getProperty method. * * Note: Magic __get does not allow recursive calls. This can be tricky because the error generated by recursing into * __get is "Undefined property: {CLASS}::{PROPERTY}" which is misleading. This is relevant for this class because * requesting a non-visible property can trigger a call to a sub-function. If that references the property directly in * the object, it will cause a recursion into __get. * * @param string $property The name of the data property. * * @return mixed The value of the data property, or null if the data property does not exist. * * @see DataObject::getProperty() * @since 1.0 */ public function __get($property) { return $this->getProperty($property); } /** * The magic isset method is used to check the state of an object property. * * @param string $property The name of the data property. * * @return boolean * * @since 1.0 */ public function __isset($property) { return isset($this->properties[$property]); } /** * The magic set method is used to set a data property. * * This is a public proxy for the protected setProperty method. * * @param string $property The name of the data property. * @param mixed $value The value to give the data property. * * @return void * * @see DataObject::setProperty() * @since 1.0 */ public function __set($property, $value) { $this->setProperty($property, $value); } /** * The magic unset method is used to unset a data property. * * @param string $property The name of the data property. * * @return void * * @since 1.0 */ public function __unset($property) { unset($this->properties[$property]); } /** * Binds an array or object to this object. * * @param mixed $properties An associative array of properties or an object. * @param boolean $updateNulls True to bind null values, false to ignore null values. * * @return $this * * @since 1.0 * @throws \InvalidArgumentException */ public function bind($properties, $updateNulls = true) { // Check the properties data type. if (!\is_array($properties) && !\is_object($properties)) { throw new \InvalidArgumentException( sprintf('The $properties argument must be an array or object, a %s was given.', \gettype($properties)) ); } // Check if the object is traversable. if ($properties instanceof \Traversable) { // Convert iterator to array. $properties = iterator_to_array($properties); } elseif (\is_object($properties)) { // Convert properties to an array. $properties = (array) $properties; } // Bind the properties. foreach ($properties as $property => $value) { // Check if the value is null and should be bound. if ($value === null && !$updateNulls) { continue; } // Set the property. $this->setProperty($property, $value); } return $this; } /** * Dumps the data properties into an object, recursively if appropriate. * * @param integer $depth The maximum depth of recursion (default = 3). * For example, a depth of 0 will return a stdClass with all the properties in native * form. A depth of 1 will recurse into the first level of properties only. * @param \SplObjectStorage $dumped An array of already serialized objects that is used to avoid infinite loops. * * @return \stdClass * * @since 1.0 */ public function dump($depth = 3, \SplObjectStorage $dumped = null) { // Check if we should initialise the recursion tracker. if ($dumped === null) { $dumped = new \SplObjectStorage; } // Add this object to the dumped stack. $dumped->attach($this); // Setup a container. $dump = new \stdClass; // Dump all object properties. foreach (array_keys($this->properties) as $property) { // Get the property. $dump->$property = $this->dumpProperty($property, $depth, $dumped); } return $dump; } /** * Gets this object represented as an ArrayIterator. * * This allows the data properties to be access via a foreach statement. * * @return \ArrayIterator * * @see IteratorAggregate::getIterator() * @since 1.0 */ public function getIterator() { return new \ArrayIterator($this->dump(0)); } /** * Gets the data properties in a form that can be serialised to JSON format. * * @return string * * @since 1.0 */ public function jsonSerialize() { return $this->dump(); } /** * Dumps a data property. * * If recursion is set, this method will dump any object implementing DumpableInterface (like DataObject and DataSet); it will * convert a DateTimeInterface object to a string; and it will convert a Joomla\Registry\Registry to an object. * * @param string $property The name of the data property. * @param integer $depth The current depth of recursion (a value of 0 will ignore recursion). * @param \SplObjectStorage $dumped An array of already serialized objects that is used to avoid infinite loops. * * @return mixed The value of the dumped property. * * @since 1.0 */ protected function dumpProperty($property, $depth, \SplObjectStorage $dumped) { $value = $this->getProperty($property); if ($depth > 0) { // Check if the object is also a dumpable object. if ($value instanceof DumpableInterface) { // Do not dump the property if it has already been dumped. if (!$dumped->contains($value)) { $value = $value->dump($depth - 1, $dumped); } } // Check if the object is a date. if ($value instanceof \DateTimeInterface) { $value = $value->format('Y-m-d H:i:s'); } elseif ($value instanceof Registry) { $value = $value->toObject(); } } return $value; } /** * Gets a data property. * * @param string $property The name of the data property. * * @return mixed The value of the data property. * * @see DataObject::__get() * @since 1.0 */ protected function getProperty($property) { return $this->properties[$property] ?? null; } /** * Sets a data property. * * If the name of the property starts with a null byte, this method will return null. * * @param string $property The name of the data property. * @param mixed $value The value to give the data property. * * @return mixed The value of the data property. * * @see DataObject::__set() * @since 1.0 */ protected function setProperty($property, $value) { /* * Check if the property starts with a null byte. If so, discard it because a later attempt to try to access it * can cause a fatal error. See http://www.php.net/manual/en/language.types.array.php#language.types.array.casting */ if (strpos($property, "\0") === 0) { return; } // Set the value. $this->properties[$property] = $value; return $value; } /** * Count the number of data properties. * * @return integer The number of data properties. * * @since 1.0 */ public function count() { return \count($this->properties); } } PK c�\�P�E �E data/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\h���o o , session/src/Validator/ForwardedValidator.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Validator; use Joomla\Input\Input; use Joomla\Session\SessionInterface; use Joomla\Session\ValidatorInterface; /** * Interface for validating a part of the session * * @since 2.0.0 */ class ForwardedValidator implements ValidatorInterface { /** * The Input object. * * @var Input * @since 2.0.0 */ private $input; /** * The session object. * * @var SessionInterface * @since 2.0.0 */ private $session; /** * Constructor * * @param Input $input The input object * @param SessionInterface $session DispatcherInterface for the session to use. * * @since 2.0.0 */ public function __construct(Input $input, SessionInterface $session) { $this->input = $input; $this->session = $session; } /** * Validates the session * * @param boolean $restart Flag if the session should be restarted * * @return void * * @since 2.0.0 */ public function validate(bool $restart = false): void { if ($restart) { $this->session->set('session.client.forwarded', null); } $xForwardedFor = $this->input->server->getString('HTTP_X_FORWARDED_FOR', ''); // Record proxy forwarded for in the session in case we need it later if (!empty($xForwardedFor) && filter_var($xForwardedFor, FILTER_VALIDATE_IP) !== false) { $this->session->set('session.client.forwarded', $xForwardedFor); } } } PK c�\� ��B B * session/src/Validator/AddressValidator.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Validator; use Joomla\Input\Input; use Joomla\Session\Exception\InvalidSessionException; use Joomla\Session\SessionInterface; use Joomla\Session\ValidatorInterface; use Joomla\Utilities\IpHelper; /** * Interface for validating a part of the session * * @since 2.0.0 */ class AddressValidator implements ValidatorInterface { /** * The Input object. * * @var Input * @since 2.0.0 */ private $input; /** * The session object. * * @var SessionInterface * @since 2.0.0 */ private $session; /** * Constructor * * @param Input $input The input object * @param SessionInterface $session DispatcherInterface for the session to use. * * @since 2.0.0 */ public function __construct(Input $input, SessionInterface $session) { $this->input = $input; $this->session = $session; } /** * Validates the session * * @param boolean $restart Flag if the session should be restarted * * @return void * * @since 2.0.0 * @throws InvalidSessionException */ public function validate(bool $restart = false): void { if ($restart) { $this->session->set('session.client.address', null); } $remoteAddr = IpHelper::getIp(); // Check for client address if (!empty($remoteAddr) && filter_var($remoteAddr, FILTER_VALIDATE_IP) !== false) { $ip = $this->session->get('session.client.address'); if ($ip === null) { $this->session->set('session.client.address', $remoteAddr); } elseif ($remoteAddr !== $ip) { throw new InvalidSessionException('Invalid client IP'); } } } } PK c�\�gk� 1 session/src/Command/CreateSessionTableCommand.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Command; use Joomla\Console\Command\AbstractCommand; use Joomla\Database\DatabaseInterface; use Joomla\Session\Exception\CreateSessionTableException; use Joomla\Session\Exception\UnsupportedDatabaseDriverException; use Joomla\Session\Handler\DatabaseHandler; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Style\SymfonyStyle; /** * Command used to create the session database table. * * @since 2.0.0 */ class CreateSessionTableCommand extends AbstractCommand { /** * The default command name * * @var string * @since 2.0.0 */ protected static $defaultName = 'session:create-table'; /** * Database connector * * @var DatabaseInterface * @since 2.0.0 */ private $db; /** * Instantiate the command. * * @param DatabaseInterface $db Database connector * * @since 2.0.0 */ public function __construct(DatabaseInterface $db) { $this->db = $db; parent::__construct(); } /** * Configure the command. * * @return void * * @since 2.0.0 */ protected function configure(): void { $this->setDescription('Creates the session database table if not already present'); } /** * Internal function to execute the command. * * @param InputInterface $input The input to inject into the command. * @param OutputInterface $output The output to inject into the command. * * @return integer The command exit code * * @since 2.0.0 */ protected function doExecute(InputInterface $input, OutputInterface $output): int { $io = new SymfonyStyle($input, $output); $io->title('Create Session Table'); // Check if the table exists if (\in_array($this->db->replacePrefix('#__session'), $this->db->getTableList())) { $io->success('The session table already exists.'); return 0; } try { (new DatabaseHandler($this->db))->createDatabaseTable(); } catch (UnsupportedDatabaseDriverException $exception) { $io->error($exception->getMessage()); return 1; } catch (CreateSessionTableException $exception) { $io->error(\sprintf('The session table could not be created: %s', $exception->getMessage())); return 1; } $io->success('The session table has been created.'); return 0; } } PK c�\K/�e e session/src/StorageInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; /** * Interface defining a Joomla! session storage object * * @since 2.0.0 */ interface StorageInterface { /** * Get the session name * * @return string The session name * * @since 2.0.0 */ public function getName(): string; /** * Set the session name * * @param string $name The session name * * @return $this * * @since 2.0.0 */ public function setName(string $name); /** * Get the session ID * * @return string The session ID * * @since 2.0.0 */ public function getId(): string; /** * Set the session ID * * @param string $id The session ID * * @return $this * * @since 2.0.0 */ public function setId(string $id); /** * Check if the session is active * * @return boolean * * @since 2.0.0 */ public function isActive(): bool; /** * Check if the session is started * * @return boolean * * @since 2.0.0 */ public function isStarted(): bool; /** * Get data from the session store * * @param string $name Name of a variable * @param mixed $default Default value of a variable if not set * * @return mixed Value of a variable * * @since 2.0.0 */ public function get(string $name, $default); /** * Set data into the session store * * @param string $name Name of a variable * @param mixed $value Value of a variable * * @return mixed Old value of a variable * * @since 2.0.0 */ public function set(string $name, $value); /** * Check whether data exists in the session store * * @param string $name Name of variable * * @return boolean * * @since 2.0.0 */ public function has(string $name): bool; /** * Unset a variable from the session store * * @param string $name Name of variable * * @return mixed The value from session or NULL if not set * * @since 2.0.0 */ public function remove(string $name); /** * Clears all variables from the session store * * @return void * * @since 2.0.0 */ public function clear(): void; /** * Retrieves all variables from the session store * * @return array * * @since 2.0.0 */ public function all(): array; /** * Start a session * * @return void * * @since 2.0.0 */ public function start(): void; /** * Regenerates the session ID that represents this storage. * * This method must invoke session_regenerate_id($destroy) unless this interface is used for a storage object designed for unit * or functional testing where a real PHP session would interfere with testing. * * @param boolean $destroy Destroy session when regenerating? * * @return boolean True on success * * @see session_regenerate_id() * @since 2.0.0 */ public function regenerate(bool $destroy = false): bool; /** * Writes session data and ends session * * @return void * * @see session_write_close() * @since 2.0.0 */ public function close(): void; /** * Perform session data garbage collection * * @return integer|boolean Number of deleted sessions on success or boolean false on failure or if the function is unsupported * * @see session_gc() * @since 2.0.0 */ public function gc(); /** * Aborts the current session * * @return boolean * * @see session_abort() * @since 2.0.0 */ public function abort(): bool; } PK c�\�.��� � session/src/SessionEvents.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; /** * Class defining the events dispatched by the session API * * @since 2.0.0 */ final class SessionEvents { /** * Private constructor to prevent instantiation of this class * * @since 2.0.0 */ private function __construct() { } /** * Session event which is dispatched after the session has been started. * * Listeners to this event receive a `Joomla\Session\SessionEvent` object. * * @var string * @since 2.0.0 */ public const START = 'session.start'; /** * Session event which is dispatched after the session has been restarted. * * Listeners to this event receive a `Joomla\Session\SessionEvent` object. * * @var string * @since 2.0.0 */ public const RESTART = 'session.restart'; } PK c�\-P�� ) session/src/Handler/FilesystemHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Handler; use Joomla\Session\HandlerInterface; /** * Filesystem session storage handler * * @since 2.0.0 */ class FilesystemHandler extends \SessionHandler implements HandlerInterface { /** * Constructor * * @param string $path Path of directory to save session files. Leave null to use the PHP configured path. * * @since 2.0.0 * @throws \InvalidArgumentException * @throws \RuntimeException */ public function __construct(string $path = '') { $pathConfig = ini_get('session.save_path'); // If the paths are empty, then we can't use this handler if (empty($path) && empty($pathConfig)) { throw new \InvalidArgumentException('Invalid argument $path'); } // If path is empty or equal to the the PHP configured path, set only the handler and use the PHP path directly if (empty($path) || $path === $pathConfig) { if (!headers_sent()) { ini_set('session.save_handler', 'files'); } return; } $baseDir = $path; if ($count = substr_count($path, ';')) { if ($count > 2) { throw new \InvalidArgumentException(sprintf('Invalid argument $path "%s"', $path)); } // Characters after the last semi-colon are the path $baseDir = ltrim(strrchr($path, ';'), ';'); } // Create the directory if it doesn't exist if (!is_dir($baseDir)) { if (!mkdir($baseDir, 0755)) { throw new \RuntimeException(sprintf('Could not create session directory "%s"', $baseDir)); } } if (!headers_sent()) { ini_set('session.save_path', $path); ini_set('session.save_handler', 'files'); } } /** * Test to see if the HandlerInterface is available * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public static function isSupported(): bool { return true; } } PK c�\DT�� � # session/src/Handler/ApcuHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Handler; use Joomla\Session\HandlerInterface; /** * APCu session storage handler * * @since 2.0.0 */ class ApcuHandler implements HandlerInterface { /** * Session ID prefix to avoid naming conflicts * * @var string * @since 2.0.0 */ private $prefix; /** * Constructor * * @param array $options Associative array of options to configure the handler * * @since 2.0.0 */ public function __construct(array $options = []) { // Namespace our session IDs to avoid potential conflicts $this->prefix = $options['prefix'] ?? 'jfw'; } /** * Close the session * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function close() { return true; } /** * Destroy a session * * @param integer $session_id The session ID being destroyed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public function destroy($session_id): bool { // The apcu_delete function returns false if the id does not exist return apcu_delete($this->prefix . $session_id) || !apcu_exists($this->prefix . $session_id); } /** * Cleanup old sessions * * @param integer $maxlifetime Sessions that have not updated for the last maxlifetime seconds will be removed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function gc($maxlifetime) { return true; } /** * Test to see if the HandlerInterface is available * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public static function isSupported(): bool { $supported = \extension_loaded('apcu') && ini_get('apc.enabled'); // If on the CLI interface, the `apc.enable_cli` option must also be enabled if ($supported && PHP_SAPI === 'cli') { $supported = ini_get('apc.enable_cli'); } return (bool) $supported; } /** * Initialize session * * @param string $save_path The path where to store/retrieve the session * @param string $session_id The session id * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function open($save_path, $session_id) { return true; } /** * Read session data * * @param string $session_id The session id to read data for * * @return string The session data * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function read($session_id) { return (string) apcu_fetch($this->prefix . $session_id); } /** * Write session data * * @param string $session_id The session id * @param string $session_data The encoded session data * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function write($session_id, $session_data) { return apcu_store($this->prefix . $session_id, $session_data, ini_get('session.gc_maxlifetime')); } } PK c�\N��7� � ' session/src/Handler/WincacheHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Handler; use Joomla\Session\HandlerInterface; /** * Wincache session storage handler * * @since 2.0.0 */ class WincacheHandler extends \SessionHandler implements HandlerInterface { /** * Constructor * * @since 2.0.0 */ public function __construct() { if (!headers_sent()) { ini_set('session.save_handler', 'wincache'); } } /** * Test to see if the HandlerInterface is available * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public static function isSupported(): bool { return \extension_loaded('wincache') && \function_exists('wincache_ucache_get') && !strcmp(ini_get('wincache.ucenabled'), '1'); } } PK c�\� 2l l $ session/src/Handler/RedisHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Handler; use Joomla\Session\HandlerInterface; /** * Redis session storage handler * * @since 2.0.0 */ class RedisHandler implements HandlerInterface { /** * Session ID prefix to avoid naming conflicts * * @var string * @since 2.0.0 */ private $prefix; /** * Redis driver * * @var \Redis * @since 2.0.0 */ private $redis; /** * Time to live in seconds * * @var integer * @since 2.0.0 */ private $ttl; /** * Constructor * * @param \Redis $redis A Redis instance * @param array $options Associative array of options to configure the handler * * @since 2.0.0 */ public function __construct(\Redis $redis, array $options = []) { $this->redis = $redis; // Set the default time-to-live based on the Session object's default configuration $this->ttl = isset($options['ttl']) ? (int) $options['ttl'] : 900; // Namespace our session IDs to avoid potential conflicts $this->prefix = $options['prefix'] ?? 'jfw'; } /** * Close the session * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function close() { // No need to close the connection to Redis server manually. return true; } /** * Destroy a session, called automatically when running session_regenerate_id(). * * @param integer $session_id The session ID being destroyed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public function destroy($session_id): bool { $this->redis->del($this->prefix . $session_id); // Session callback must have a return value of type bool when session_regenerate_id() is called. return true; } /** * Cleanup old sessions * * @param integer $maxlifetime Sessions that have not updated for the last maxlifetime seconds will be removed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function gc($maxlifetime) { return true; } /** * Test to see if the HandlerInterface is available * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public static function isSupported(): bool { return \extension_loaded('redis') && class_exists('Redis'); } /** * Initialize session * * @param string $save_path The path where to store/retrieve the session * @param string $session_id The session id * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function open($save_path, $session_id) { return true; } /** * Read session data * * @param string $session_id The session id to read data for * * @return string The session data * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function read($session_id) { return $this->redis->get($this->prefix . $session_id) ?: ''; } /** * Write session data * * @param string $session_id The session id * @param string $session_data The encoded session data * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function write($session_id, $session_data) { if ($this->ttl > 0) { return $this->redis->setex($this->prefix . $session_id, $this->ttl, $session_data); } return $this->redis->set($this->prefix . $session_id, $session_data); } } PK c�\G���- - ( session/src/Handler/MemcachedHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Handler; use Joomla\Session\HandlerInterface; /** * Memcached session storage handler * * @since 2.0.0 */ class MemcachedHandler implements HandlerInterface { /** * Memcached driver * * @var \Memcached * @since 2.0.0 */ private $memcached; /** * Session ID prefix to avoid naming conflicts * * @var string * @since 2.0.0 */ private $prefix; /** * Time to live in seconds * * @var integer * @since 2.0.0 */ private $ttl; /** * Constructor * * @param \Memcached $memcached A Memcached instance * @param array $options Associative array of options to configure the handler * * @since 2.0.0 */ public function __construct(\Memcached $memcached, array $options = []) { $this->memcached = $memcached; // Set the default time-to-live based on the Session object's default configuration $this->ttl = isset($options['ttl']) ? (int) $options['ttl'] : 900; // Namespace our session IDs to avoid potential conflicts $this->prefix = $options['prefix'] ?? 'jfw'; } /** * Close the session * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function close() { return true; } /** * Destroy a session * * @param integer $session_id The session ID being destroyed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public function destroy($session_id): bool { return $this->memcached->delete($this->prefix . $session_id); } /** * Cleanup old sessions * * @param integer $maxlifetime Sessions that have not updated for the last maxlifetime seconds will be removed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function gc($maxlifetime) { // Memcached manages garbage collection on its own return true; } /** * Test to see if the HandlerInterface is available * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public static function isSupported(): bool { /* * GAE and HHVM have both had instances where Memcached the class was defined but no extension was loaded. * If the class is there, we can assume it works. */ return class_exists('Memcached'); } /** * Initialize session * * @param string $save_path The path where to store/retrieve the session * @param string $session_id The session id * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function open($save_path, $session_id) { return true; } /** * Read session data * * @param string $session_id The session id to read data for * * @return string The session data * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function read($session_id) { return $this->memcached->get($this->prefix . $session_id) ?: ''; } /** * Write session data * * @param string $session_id The session id * @param string $session_data The encoded session data * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function write($session_id, $session_data) { return $this->memcached->set($this->prefix . $session_id, $session_data, time() + $this->ttl); } } PK c�\��R�� � ' session/src/Handler/DatabaseHandler.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Handler; use Joomla\Database\DatabaseDriver; use Joomla\Database\DatabaseInterface; use Joomla\Database\Exception\ExecutionFailureException; use Joomla\Database\ParameterType; use Joomla\Session\Exception\CreateSessionTableException; use Joomla\Session\Exception\UnsupportedDatabaseDriverException; use Joomla\Session\HandlerInterface; /** * Database session storage handler * * @since 2.0.0 */ class DatabaseHandler implements HandlerInterface { /** * Database connector * * @var DatabaseInterface * @since 2.0.0 */ private $db; /** * Flag whether gc() has been called * * @var boolean * @since 2.0.0 */ private $gcCalled = false; /** * Lifetime for garbage collection * * @var integer * @since 2.0.0 */ private $gcLifetime; /** * Constructor * * @param DatabaseInterface $db Database connector * * @since 2.0.0 */ public function __construct(DatabaseInterface $db) { $this->db = $db; } /** * Close the session * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function close() { if ($this->gcCalled) { $query = $this->db->getQuery(true) ->delete($this->db->quoteName('#__session')) ->where($this->db->quoteName('time') . ' < ?') ->bind(1, $this->gcLifetime, ParameterType::INTEGER); // Remove expired sessions from the database. $this->db->setQuery($query)->execute(); $this->gcCalled = false; $this->gcLifetime = null; } $this->db->disconnect(); return true; } /** * Creates the session database table * * @return boolean * * @since 2.0.0 * @throws CreateSessionTableException * @throws UnsupportedDatabaseDriverException */ public function createDatabaseTable(): bool { switch ($this->db->getName()) { case 'mysql': case 'mysqli': $filename = 'mysql.sql'; break; case 'postgresql': $filename = 'pgsql.sql'; break; case 'sqlsrv': case 'sqlazure': $filename = 'sqlsrv.sql'; break; case 'sqlite': $filename = 'sqlite.sql'; break; default: throw new UnsupportedDatabaseDriverException(sprintf('The %s database driver is not supported.', $this->db->getName())); } $path = \dirname(__DIR__, 2) . '/meta/sql/' . $filename; if (!is_readable($path)) { throw new CreateSessionTableException( sprintf('Database schema could not be read from %s. Please ensure the file exists and is readable.', $path) ); } $queries = DatabaseDriver::splitSql(file_get_contents($path)); foreach ($queries as $query) { $query = trim($query); if ($query !== '') { try { $this->db->setQuery($query)->execute(); } catch (ExecutionFailureException $exception) { throw new CreateSessionTableException('Failed to create the session table.', 0, $exception); } } } return true; } /** * Destroy a session * * @param integer $session_id The session ID being destroyed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public function destroy($session_id): bool { try { $query = $this->db->getQuery(true) ->delete($this->db->quoteName('#__session')) ->where($this->db->quoteName('session_id') . ' = ' . $this->db->quote($session_id)); // Remove a session from the database. $this->db->setQuery($query)->execute(); return true; } catch (\Exception $e) { return false; } } /** * Cleanup old sessions * * @param integer $maxlifetime Sessions that have not updated for the last maxlifetime seconds will be removed * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function gc($maxlifetime) { // We'll delay garbage collection until the session is closed to prevent potential issues mid-cycle $this->gcLifetime = time() - $maxlifetime; $this->gcCalled = true; return true; } /** * Test to see if the HandlerInterface is available * * @return boolean True on success, false otherwise * * @since 2.0.0 */ public static function isSupported(): bool { return interface_exists(DatabaseInterface::class); } /** * Initialize session * * @param string $save_path The path where to store/retrieve the session * @param string $session_id The session id * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function open($save_path, $session_id) { $this->db->connect(); return true; } /** * Read session data * * @param string $session_id The session id to read data for * * @return string The session data * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function read($session_id) { try { // Get the session data from the database table. $query = $this->db->getQuery(true) ->select($this->db->quoteName('data')) ->from($this->db->quoteName('#__session')) ->where($this->db->quoteName('session_id') . ' = ?') ->bind(1, $session_id); $this->db->setQuery($query); return (string) $this->db->loadResult(); } catch (\Exception $e) { return ''; } } /** * Write session data * * @param string $session_id The session id * @param string $session_data The encoded session data * * @return boolean True on success, false otherwise * * @since 2.0.0 */ #[\ReturnTypeWillChange] public function write($session_id, $session_data) { try { // Figure out if a row exists for the session ID $query = $this->db->getQuery(true) ->select($this->db->quoteName('session_id')) ->from($this->db->quoteName('#__session')) ->where($this->db->quoteName('session_id') . ' = ?') ->bind(1, $session_id); $idExists = $this->db->setQuery($query)->loadResult(); $query = $this->db->getQuery(true); $time = time(); if ($idExists) { $query->update($this->db->quoteName('#__session')) ->set($this->db->quoteName('data') . ' = ?') ->set($this->db->quoteName('time') . ' = ?') ->where($this->db->quoteName('session_id') . ' = ?') ->bind(1, $session_data) ->bind(2, $time, ParameterType::INTEGER) ->bind(3, $session_id); } else { $query->insert($this->db->quoteName('#__session')) ->columns([$this->db->quoteName('data'), $this->db->quoteName('time'), $this->db->quoteName('session_id')]) ->values('?, ?, ?') ->bind(1, $session_data) ->bind(2, $time, ParameterType::INTEGER) ->bind(3, $session_id); } // Try to insert the session data in the database table. $this->db->setQuery($query)->execute(); return true; } catch (\Exception $e) { return false; } } } PK c�\|p |J J session/src/HandlerInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; /** * Interface defining Joomla! session handlers * * @since 2.0.0 */ interface HandlerInterface extends \SessionHandlerInterface { /** * Test to see if the HandlerInterface is available. * * @return boolean True on success, false otherwise. * * @since 2.0.0 */ public static function isSupported(): bool; } PK c�\�:I I session/src/SessionInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; /** * Interface defining a Joomla! Session object * * @since 2.0.0 */ interface SessionInterface extends \IteratorAggregate { /** * Get expiration time in seconds * * @return integer The session expiration time in seconds * * @since 2.0.0 */ public function getExpire(); /** * Get the session name * * @return string The session name * * @since 2.0.0 */ public function getName(); /** * Set the session name * * @param string $name The session name * * @return $this * * @since 2.0.0 */ public function setName(string $name); /** * Get the session ID * * @return string The session ID * * @since 2.0.0 */ public function getId(); /** * Set the session ID * * @param string $id The session ID * * @return $this * * @since 2.0.0 */ public function setId(string $id); /** * Check if the session is active * * @return boolean * * @since 2.0.0 */ public function isActive(); /** * Check whether this session is newly created * * @return boolean * * @since 2.0.0 */ public function isNew(); /** * Check if the session is started * * @return boolean * * @since 2.0.0 */ public function isStarted(); /** * Get a session token. * * Tokens are used to secure forms from spamming attacks. Once a token has been generated the system will check the request to see if * it is present, if not it will invalidate the session. * * @param boolean $forceNew If true, forces a new token to be created * * @return string * * @since 2.0.0 */ public function getToken($forceNew = false); /** * Check if the session has the given token. * * @param string $token Hashed token to be verified * @param boolean $forceExpire If true, expires the session * * @return boolean * * @since 2.0.0 */ public function hasToken($token, $forceExpire = true); /** * Get data from the session store * * @param string $name Name of a variable * @param mixed $default Default value of a variable if not set * * @return mixed Value of a variable * * @since 2.0.0 */ public function get($name, $default = null); /** * Set data into the session store * * @param string $name Name of a variable. * @param mixed $value Value of a variable. * * @return mixed Old value of a variable. * * @since 2.0.0 */ public function set($name, $value = null); /** * Check whether data exists in the session store * * @param string $name Name of variable * * @return boolean True if the variable exists * * @since 2.0.0 */ public function has($name); /** * Unset a variable from the session store * * @param string $name Name of variable * * @return mixed The value from session or NULL if not set * * @since 2.0.0 */ public function remove(string $name); /** * Clears all variables from the session store * * @return void * * @since 2.0.0 */ public function clear(); /** * Retrieves all variables from the session store * * @return array * * @since 2.0.0 */ public function all(): array; /** * Start a session * * @return void * * @since 2.0.0 */ public function start(); /** * Frees all session variables and destroys all data registered to a session * * This method resets the $_SESSION variable and destroys all of the data associated * with the current session in its storage (file or DB). It forces new session to be * started after this method is called. It does not unset the session cookie. * * @return boolean * * @see session_destroy() * @see session_unset() * @since 2.0.0 */ public function destroy(); /** * Restart an expired or locked session * * @return boolean True on success * * @see destroy * @since 2.0.0 */ public function restart(); /** * Create a new session and copy variables from the old one * * @return boolean * * @since 2.0.0 */ public function fork(); /** * Writes session data and ends session * * Session data is usually stored after your script terminated without the need * to call SessionInterface::close(), but as session data is locked to prevent concurrent * writes only one script may operate on a session at any time. When using * framesets together with sessions you will experience the frames loading one * by one due to this locking. You can reduce the time needed to load all the * frames by ending the session as soon as all changes to session variables are * done. * * @return void * * @see session_write_close() * @since 2.0.0 */ public function close(); /** * Perform session data garbage collection * * @return integer|boolean Number of deleted sessions on success or boolean false on failure or if the function is unsupported * * @see session_gc() * @since 2.0.0 */ public function gc(); /** * Aborts the current session * * @return boolean * * @see session_abort() * @since 2.0.0 */ public function abort(): bool; } PK c�\�> %� � & session/src/Storage/RuntimeStorage.phpnu �[��� <?php /** * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Storage; use Joomla\Session\StorageInterface; /** * Session storage object that stores objects in Runtime memory. This is designed for use in CLI Apps, including * unit testing applications in PHPUnit. * * @since 2.0.0 */ class RuntimeStorage implements StorageInterface { /** * Flag if the session is active * * @var boolean * @since 2.0.0 */ private $active = false; /** * Internal flag identifying whether the session has been closed * * @var boolean * @since 2.0.0 */ private $closed = false; /** * Internal data store * * @var array * @since 2.0.0 */ private $data = []; /** * Session ID * * @var string * @since 2.0.0 */ private $id = ''; /** * Session Name * * @var string * @since 2.0.0 */ private $name = 'MockSession'; /** * Internal flag identifying whether the session has been started * * @var boolean * @since 2.0.0 */ private $started = false; /** * Retrieves all variables from the session store * * @return array */ public function all(): array { return $this->data; } /** * Clears all variables from the session store * * @return void * * @since 2.0.0 */ public function clear(): void { $this->data = []; } /** * Writes session data and ends session * * @return void * * @see session_write_close() * @since 2.0.0 */ public function close(): void { $this->closed = true; $this->started = false; } /** * Perform session data garbage collection * * @return integer|boolean Number of deleted sessions on success or boolean false on failure or if the function is unsupported * * @see session_gc() * @since 2.0.0 */ public function gc() { return 0; } /** * Aborts the current session * * @return boolean * * @see session_abort() * @since 2.0.0 */ public function abort(): bool { $this->closed = true; $this->started = false; return true; } /** * Generates a session ID * * @return string * * @since 2.0.0 */ private function generateId(): string { return hash('sha256', uniqid(mt_rand())); } /** * Get data from the session store * * @param string $name Name of a variable * @param mixed $default Default value of a variable if not set * * @return mixed Value of a variable * * @since 2.0.0 */ public function get(string $name, $default) { if (!$this->isStarted()) { $this->start(); } if (isset($this->data[$name])) { return $this->data[$name]; } return $default; } /** * Get the session ID * * @return string The session ID * * @since 2.0.0 */ public function getId(): string { return $this->id; } /** * Get the session name * * @return string The session name * * @since 2.0.0 */ public function getName(): string { return $this->name; } /** * Check whether data exists in the session store * * @param string $name Name of variable * * @return boolean * * @since 2.0.0 */ public function has(string $name): bool { if (!$this->isStarted()) { $this->start(); } return isset($this->data[$name]); } /** * Check if the session is active * * @return boolean * * @since 2.0.0 */ public function isActive(): bool { return $this->active = $this->started; } /** * Check if the session is started * * @return boolean * * @since 2.0.0 */ public function isStarted(): bool { return $this->started; } /** * Unset a variable from the session store * * @param string $name Name of variable * * @return mixed The value from session or NULL if not set * * @since 2.0.0 */ public function remove(string $name) { if (!$this->isStarted()) { $this->start(); } $old = $this->data[$name] ?? null; unset($this->data[$name]); return $old; } /** * Regenerates the session ID that represents this storage. * * This method must invoke session_regenerate_id($destroy) unless this interface is used for a storage object designed for unit * or functional testing where a real PHP session would interfere with testing. * * @param boolean $destroy Destroy session when regenerating? * * @return boolean True on success * * @see session_regenerate_id() * @since 2.0.0 */ public function regenerate(bool $destroy = false): bool { if (!$this->isActive()) { return false; } if ($destroy) { $this->id = $this->generateId(); } return true; } /** * Set data into the session store * * @param string $name Name of a variable * @param mixed $value Value of a variable * * @return mixed Old value of a variable * * @since 2.0.0 */ public function set(string $name, $value = null) { if (!$this->isStarted()) { $this->start(); } $old = $this->data[$name] ?? null; $this->data[$name] = $value; return $old; } /** * Set the session ID * * @param string $id The session ID * * @return $this * * @since 2.0.0 * @throws \LogicException */ public function setId(string $id) { if ($this->isActive()) { throw new \LogicException('Cannot change the ID of an active session'); } $this->id = $id; return $this; } /** * Set the session name * * @param string $name The session name * * @return $this * * @since 2.0.0 * @throws \LogicException */ public function setName(string $name) { if ($this->isActive()) { throw new \LogicException('Cannot change the name of an active session'); } $this->name = $name; return $this; } /** * Start a session * * @return void * * @since 2.0.0 */ public function start(): void { if ($this->isStarted()) { return; } if ($this->isActive()) { throw new \RuntimeException('Failed to start the session: already started by PHP.'); } if (empty($this->id)) { $this->setId($this->generateId()); } $this->closed = false; $this->started = true; $this->isActive(); } } PK c�\�d1" $ $ % session/src/Storage/NativeStorage.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Storage; use Joomla\Session\HandlerInterface; use Joomla\Session\StorageInterface; /** * Base class providing a session store * * @since 2.0.0 */ class NativeStorage implements StorageInterface { /** * Flag if the session is active * * @var boolean * @since 2.0.0 */ private $active = false; /** * Internal flag identifying whether the session has been closed * * @var boolean * @since 2.0.0 */ private $closed = false; /** * Session save handler * * @var \SessionHandlerInterface * @since 2.0.0 */ private $handler; /** * Internal flag identifying whether the session has been started * * @var boolean * @since 2.0.0 */ private $started = false; /** * Constructor * * @param \SessionHandlerInterface $handler Session save handler * @param array $options Session options * * @since 1.0 */ public function __construct(?\SessionHandlerInterface $handler = null, array $options = []) { // Disable transparent sid support and default use cookies $options += [ 'use_cookies' => 1, 'use_trans_sid' => 0, ]; if (!headers_sent()) { session_cache_limiter('none'); } session_register_shutdown(); $this->setOptions($options); $this->setHandler($handler); } /** * Retrieves all variables from the session store * * @return array * * @since 2.0.0 */ public function all(): array { return $_SESSION; } /** * Clears all variables from the session store * * @return void * * @since 2.0.0 */ public function clear(): void { $_SESSION = []; } /** * Writes session data and ends session * * @return void * * @see session_write_close() * @since 2.0.0 */ public function close(): void { session_write_close(); $this->closed = true; $this->started = false; } /** * Perform session data garbage collection * * @return integer|boolean Number of deleted sessions on success or boolean false on failure or if the function is unsupported * * @see session_gc() * @since 2.0.0 */ public function gc() { if (!$this->isStarted()) { $this->start(); } return session_gc(); } /** * Aborts the current session * * @return boolean * * @see session_abort() * @since 2.0.0 */ public function abort(): bool { if (!$this->isStarted()) { return true; } return session_abort(); } /** * Get data from the session store * * @param string $name Name of a variable * @param mixed $default Default value of a variable if not set * * @return mixed Value of a variable * * @since 2.0.0 */ public function get(string $name, $default) { if (!$this->isStarted()) { $this->start(); } if (isset($_SESSION[$name])) { return $_SESSION[$name]; } return $default; } /** * Gets the save handler instance * * @return \SessionHandlerInterface|null * * @since 2.0.0 */ public function getHandler(): ?\SessionHandlerInterface { return $this->handler; } /** * Get the session ID * * @return string The session ID * * @since 2.0.0 */ public function getId(): string { return session_id(); } /** * Get the session name * * @return string The session name * * @since 2.0.0 */ public function getName(): string { return session_name(); } /** * Check whether data exists in the session store * * @param string $name Name of variable * * @return boolean * * @since 2.0.0 */ public function has(string $name): bool { if (!$this->isStarted()) { $this->start(); } return isset($_SESSION[$name]); } /** * Check if the session is active * * @return boolean * * @since 2.0.0 */ public function isActive(): bool { return $this->active = session_status() === \PHP_SESSION_ACTIVE; } /** * Check if the session is started * * @return boolean * * @since 2.0.0 */ public function isStarted(): bool { return $this->started; } /** * Unset a variable from the session store * * @param string $name Name of variable * * @return mixed The value from session or NULL if not set * * @since 2.0.0 */ public function remove(string $name) { if (!$this->isStarted()) { $this->start(); } $old = $_SESSION[$name] ?? null; unset($_SESSION[$name]); return $old; } /** * Regenerates the session ID that represents this storage. * * This method must invoke session_regenerate_id($destroy) unless this interface is used for a storage object designed for unit * or functional testing where a real PHP session would interfere with testing. * * @param boolean $destroy Destroy session when regenerating? * * @return boolean True on success * * @see session_regenerate_id() * @since 2.0.0 */ public function regenerate(bool $destroy = false): bool { if (headers_sent() || !$this->isActive()) { return false; } return session_regenerate_id($destroy); } /** * Set data into the session store * * @param string $name Name of a variable * @param mixed $value Value of a variable * * @return mixed Old value of a variable * * @since 2.0.0 */ public function set(string $name, $value = null) { if (!$this->isStarted()) { $this->start(); } $old = $_SESSION[$name] ?? null; $_SESSION[$name] = $value; return $old; } /** * Registers session save handler as a PHP session handler * * @param \SessionHandlerInterface $handler The save handler to use * * @return $this * * @since 2.0.0 * @throws \RuntimeException */ public function setHandler(?\SessionHandlerInterface $handler = null): self { // If the handler is an instance of our HandlerInterface, check whether it is supported if ($handler instanceof HandlerInterface) { if (!$handler::isSupported()) { throw new \RuntimeException( sprintf( 'The "%s" handler is not supported in this environment.', \get_class($handler) ) ); } } $this->handler = $handler; if (!headers_sent() && !$this->isActive()) { session_set_save_handler($this->handler, false); } return $this; } /** * Set the session ID * * @param string $id The session ID * * @return $this * * @since 2.0.0 * @throws \LogicException */ public function setId(string $id) { if ($this->isActive()) { throw new \LogicException('Cannot change the ID of an active session'); } session_id($id); return $this; } /** * Set the session name * * @param string $name The session name * * @return $this * * @since 2.0.0 * @throws \LogicException */ public function setName(string $name) { if ($this->isActive()) { throw new \LogicException('Cannot change the name of an active session'); } session_name($name); return $this; } /** * Sets session.* ini variables. * * For convenience we omit 'session.' from the beginning of the keys. * Explicitly ignores other ini keys. * * @param array $options Session ini directives array(key => value). * * @return $this * * @note Based on \Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage::setOptions() * @see http://php.net/session.configuration * @since 2.0.0 */ public function setOptions(array $options): self { if (headers_sent() || $this->isActive()) { return $this; } $validOptions = array_flip( [ 'cache_limiter', 'cache_expire', 'cookie_domain', 'cookie_httponly', 'cookie_lifetime', 'cookie_path', 'cookie_secure', 'gc_divisor', 'gc_maxlifetime', 'gc_probability', 'lazy_write', 'name', 'referer_check', 'serialize_handler', 'use_strict_mode', 'use_cookies', 'use_only_cookies', 'use_trans_sid', 'upload_progress.enabled', 'upload_progress.cleanup', 'upload_progress.prefix', 'upload_progress.name', 'upload_progress.freq', 'upload_progress.min-freq', 'url_rewriter.tags', 'sid_length', 'sid_bits_per_character', 'trans_sid_hosts', 'trans_sid_tags', ] ); foreach ($options as $key => $value) { if (isset($validOptions[$key])) { ini_set('session.' . $key, $value); } } return $this; } /** * Start a session * * @return void * * @since 2.0.0 */ public function start(): void { if ($this->isStarted()) { return; } if ($this->isActive()) { throw new \RuntimeException('Failed to start the session: already started by PHP.'); } if (ini_get('session.use_cookies') && headers_sent($file, $line)) { throw new \RuntimeException( sprintf('Failed to start the session because headers have already been sent by "%s" at line %d.', $file, $line) ); } if (!session_start()) { throw new \RuntimeException('Failed to start the session'); } $this->isActive(); $this->closed = false; $this->started = true; } } PK c�\k�9=e< e< session/src/Session.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; use Joomla\Event\DispatcherAwareInterface; use Joomla\Event\DispatcherAwareTrait; use Joomla\Event\DispatcherInterface; /** * Class for managing HTTP sessions * * Provides access to session-state values as well as session-level settings and lifetime management methods. * Based on the standard PHP session handling mechanism it provides more advanced features such as expire timeouts. * * @since 1.0 */ class Session implements SessionInterface, DispatcherAwareInterface { use DispatcherAwareTrait; /** * Internal session state. * * @var string * @since 1.0 */ protected $state = SessionState::INACTIVE; /** * Maximum age of unused session in seconds. * * @var integer * @since 1.0 */ protected $expire = 900; /** * The session store object. * * @var StorageInterface * @since 1.0 */ protected $store; /** * Container holding session validators. * * @var ValidatorInterface[] * @since 2.0.0 */ protected $sessionValidators = []; /** * Constructor * * @param StorageInterface $store A StorageInterface implementation. * @param DispatcherInterface $dispatcher DispatcherInterface for the session to use. * @param array $options Optional parameters. Supported keys include: * - name: The session name * - id: The session ID * - expire: The session lifetime in seconds * * @since 1.0 */ public function __construct(StorageInterface $store = null, DispatcherInterface $dispatcher = null, array $options = []) { $this->store = $store ?: new Storage\NativeStorage(new Handler\FilesystemHandler); if ($dispatcher) { $this->setDispatcher($dispatcher); } $this->setOptions($options); $this->setState(SessionState::INACTIVE); } /** * Adds a validator to the session * * @param ValidatorInterface $validator The session validator * * @return void * * @since 2.0.0 */ public function addValidator(ValidatorInterface $validator): void { $this->sessionValidators[] = $validator; } /** * Get expiration time in seconds * * @return integer The session expiration time in seconds * * @since 1.0 */ public function getExpire() { return $this->expire; } /** * Get current state of session * * @return string The session state * * @since 1.0 */ public function getState() { return $this->state; } /** * Get a session token. * * Tokens are used to secure forms from spamming attacks. Once a token has been generated the system will check the request to see if * it is present, if not it will invalidate the session. * * @param boolean $forceNew If true, forces a new token to be created * * @return string * * @since 1.0 */ public function getToken($forceNew = false) { // Ensure the session token exists and create it if necessary if (!$this->has('session.token') || $forceNew) { $this->set('session.token', $this->createToken()); } return $this->get('session.token'); } /** * Check if the session has the given token. * * @param string $token Hashed token to be verified * @param boolean $forceExpire If true, expires the session * * @return boolean * * @since 1.0 */ public function hasToken($token, $forceExpire = true) { $result = $this->get('session.token') === $token; if (!$result && $forceExpire) { $this->setState(SessionState::EXPIRED); } return $result; } /** * Retrieve an external iterator. * * @return \ArrayIterator Return an ArrayIterator of $_SESSION. * * @since 1.0 */ #[\ReturnTypeWillChange] public function getIterator() { return new \ArrayIterator($this->all()); } /** * Get session name * * @return string The session name * * @since 1.0 */ public function getName() { return $this->store->getName(); } /** * Set the session name * * @param string $name The session name * * @return $this * * @since 2.0.0 */ public function setName(string $name) { $this->store->setName($name); return $this; } /** * Get session id * * @return string The session id * * @since 1.0 */ public function getId() { return $this->store->getId(); } /** * Set the session ID * * @param string $id The session ID * * @return $this * * @since 2.0.0 */ public function setId(string $id) { $this->store->setId($id); return $this; } /** * Check if the session is active * * @return boolean * * @since 1.0 */ public function isActive() { if ($this->getState() === SessionState::ACTIVE) { return $this->store->isActive(); } return false; } /** * Check whether this session is currently created * * @return boolean * * @since 1.0 */ public function isNew() { $counter = $this->get('session.counter'); return $counter === 1; } /** * Check if the session is started * * @return boolean * * @since 2.0.0 */ public function isStarted(): bool { return $this->store->isStarted(); } /** * Get data from the session store * * @param string $name Name of a variable * @param mixed $default Default value of a variable if not set * * @return mixed Value of a variable * * @since 1.0 */ public function get($name, $default = null) { if (!$this->isActive()) { $this->start(); } return $this->store->get($name, $default); } /** * Set data into the session store. * * @param string $name Name of a variable. * @param mixed $value Value of a variable. * * @return mixed Old value of a variable. * * @since 1.0 */ public function set($name, $value = null) { if (!$this->isActive()) { $this->start(); } return $this->store->set($name, $value); } /** * Check whether data exists in the session store * * @param string $name Name of variable * * @return boolean True if the variable exists * * @since 1.0 */ public function has($name) { if (!$this->isActive()) { $this->start(); } return $this->store->has($name); } /** * Unset a variable from the session store * * @param string $name Name of variable * * @return mixed The value from session or NULL if not set * * @since 2.0.0 */ public function remove(string $name) { if (!$this->isActive()) { $this->start(); } return $this->store->remove($name); } /** * Clears all variables from the session store * * @return void * * @since 1.0 */ public function clear() { if (!$this->isActive()) { $this->start(); } $this->store->clear(); } /** * Retrieves all variables from the session store * * @return array * * @since 2.0.0 */ public function all(): array { if (!$this->isActive()) { $this->start(); } return $this->store->all(); } /** * Start a session. * * @return void * * @since 1.0 */ public function start() { if ($this->isStarted()) { return; } $this->store->start(); $this->setState(SessionState::ACTIVE); // Initialise the session $this->setCounter(); $this->setTimers(); // Perform security checks if (!$this->validate()) { // If the session isn't valid because it expired try to restart it or destroy it. if ($this->getState() === SessionState::EXPIRED) { $this->restart(); } else { $this->destroy(); } } if ($this->dispatcher) { if (!empty($this->dispatcher->getListeners('onAfterSessionStart'))) { trigger_deprecation( 'joomla/session', '2.0.0', 'The `onAfterSessionStart` event is deprecated and will be removed in 3.0, use the %s::START event instead.', SessionEvents::class ); // Dispatch deprecated event $this->dispatcher->dispatch('onAfterSessionStart', new SessionEvent('onAfterSessionStart', $this)); } // Dispatch new event $this->dispatcher->dispatch(SessionEvents::START, new SessionEvent(SessionEvents::START, $this)); } } /** * Frees all session variables and destroys all data registered to a session * * This method resets the $_SESSION variable and destroys all of the data associated * with the current session in its storage (file or DB). It forces new session to be * started after this method is called. * * @return boolean * * @see session_destroy() * @see session_unset() * @since 1.0 */ public function destroy() { // Session was already destroyed if ($this->getState() === SessionState::DESTROYED) { return true; } $this->clear(); $this->fork(true); $this->setState(SessionState::DESTROYED); return true; } /** * Restart an expired or locked session. * * @return boolean True on success * * @see destroy * @since 1.0 */ public function restart() { // Backup existing session data $data = $this->all(); $this->destroy(); if ($this->getState() !== SessionState::DESTROYED) { // @TODO :: generated error here return false; } // Restart the session $this->store->start(); $this->setState(SessionState::ACTIVE); // Initialise the session $this->setCounter(); $this->setTimers(); // Restore the data foreach ($data as $key => $value) { $this->set($key, $value); } // If the restarted session cannot be validated then it will be destroyed if (!$this->validate(true)) { $this->destroy(); } if ($this->dispatcher) { if (!empty($this->dispatcher->getListeners('onAfterSessionRestart'))) { trigger_deprecation( 'joomla/session', '2.0.0', 'The `onAfterSessionRestart` event is deprecated and will be removed in 3.0, use the %s::RESTART event instead.', SessionEvents::class ); // Dispatch deprecated event $this->dispatcher->dispatch('onAfterSessionRestart', new SessionEvent('onAfterSessionRestart', $this)); } // Dispatch new event $this->dispatcher->dispatch(SessionEvents::RESTART, new SessionEvent(SessionEvents::RESTART, $this)); } return true; } /** * Create a new session and copy variables from the old one * * @param boolean $destroy Whether to delete the old session or leave it to garbage collection. * * @return boolean True on success * * @since 1.0 */ public function fork($destroy = false) { $result = $this->store->regenerate($destroy); if ($result) { $this->setTimers(); } return $result; } /** * Writes session data and ends session * * Session data is usually stored after your script terminated without the need * to call {@link Session::close()}, but as session data is locked to prevent concurrent * writes only one script may operate on a session at any time. When using * framesets together with sessions you will experience the frames loading one * by one due to this locking. You can reduce the time needed to load all the * frames by ending the session as soon as all changes to session variables are * done. * * @return void * * @see session_write_close() * @since 1.0 */ public function close() { $this->store->close(); $this->setState(SessionState::CLOSED); } /** * Perform session data garbage collection * * @return integer|boolean Number of deleted sessions on success or boolean false on failure or if the function is unsupported * * @see session_gc() * @since 2.0.0 */ public function gc() { if (!$this->isActive()) { $this->start(); } return $this->store->gc(); } /** * Aborts the current session * * @return boolean * * @see session_abort() * @since 2.0.0 */ public function abort(): bool { if (!$this->isActive()) { return true; } return $this->store->abort(); } /** * Create a token string * * @return string * * @since 1.3.1 */ protected function createToken(): string { /* * We are returning a 32 character string. * The bin2hex() function will double the length of the hexadecimal value returned by random_bytes(), * so generate the token from a 16 byte random value */ return bin2hex(random_bytes(16)); } /** * Set counter of session usage * * @return boolean True on success * * @since 1.0 */ protected function setCounter() { $counter = $this->get('session.counter', 0); $counter++; $this->set('session.counter', $counter); return true; } /** * Set the session expiration * * @param integer $expire Maximum age of unused session in seconds * * @return $this * * @since 1.3.0 */ protected function setExpire($expire) { $this->expire = $expire; return $this; } /** * Set the session state * * @param string $state Internal state * * @return $this * * @since 1.3.0 */ protected function setState($state) { $this->state = $state; return $this; } /** * Set the session timers * * @return boolean True on success * * @since 1.0 */ protected function setTimers() { if (!$this->has('session.timer.start')) { $start = time(); $this->set('session.timer.start', $start); $this->set('session.timer.last', $start); $this->set('session.timer.now', $start); } $this->set('session.timer.last', $this->get('session.timer.now')); $this->set('session.timer.now', time()); return true; } /** * Set additional session options * * @param array $options List of parameter * * @return boolean True on success * * @since 1.0 */ protected function setOptions(array $options) { // Set name if (isset($options['name'])) { $this->setName($options['name']); } // Set id if (isset($options['id'])) { $this->setId($options['id']); } // Set expire time if (isset($options['expire'])) { $this->setExpire($options['expire']); } // Sync the session maxlifetime if (!headers_sent()) { ini_set('session.gc_maxlifetime', $this->getExpire()); } return true; } /** * Do some checks for security reasons * * If one check fails, session data has to be cleaned. * * @param boolean $restart Reactivate session * * @return boolean True on success * * @see http://shiflett.org/articles/the-truth-about-sessions * @since 1.0 */ protected function validate($restart = false) { // Allow to restart a session if ($restart) { $this->setState(SessionState::ACTIVE); } // Check if session has expired if ($this->expire) { $curTime = $this->get('session.timer.now', 0); $maxTime = $this->get('session.timer.last', 0) + $this->expire; // Empty session variables if ($maxTime < $curTime) { $this->setState(SessionState::EXPIRED); return false; } } try { foreach ($this->sessionValidators as $validator) { $validator->validate($restart); } } catch (Exception\InvalidSessionException $e) { $this->setState(SessionState::ERROR); return false; } return true; } } PK c�\�W�{� � session/src/SessionState.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; /** * Class defining the various states of a session * * @since 2.0.0 */ final class SessionState { /** * Private constructor to prevent instantiation of this class * * @since 2.0.0 */ private function __construct() { } /** * State indicating the session is active. * * A `SessionInterface` instance should be in this state once the session has started. * * @var string * @since 2.0.0 */ public const ACTIVE = 'active'; /** * State indicating the session is closed. * * A `SessionInterface` instance should be in this state after calling the `close()` method. * * @var string * @since 2.0.0 */ public const CLOSED = 'closed'; /** * State indicating the session is destroyed. * * A `SessionInterface` instance should be in this state after calling the `destroy()` method. * * @var string * @since 2.0.0 */ public const DESTROYED = 'destroyed'; /** * State indicating the session is in an error state. * * A `SessionInterface` instance should be in this state if the session cannot be validated after being started. * * @var string * @since 2.0.0 */ public const ERROR = 'error'; /** * State indicating the session is expired. * * A `SessionInterface` instance should be in this state if the session has passed the allowed lifetime. * A `SessionInterface` instance may be in this state if validating a session token fails. * * @var string * @since 2.0.0 */ public const EXPIRED = 'expired'; /** * State indicating the session is inactive. * * A `SessionInterface` instance should begin in this state. * * @var string * @since 2.0.0 */ public const INACTIVE = 'inactive'; } PK c�\߁;� session/src/SessionEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; use Joomla\Event\Event; /** * Class representing a Session event * * @since 2.0.0 */ class SessionEvent extends Event { /** * SessionInterface object for this event * * @var SessionInterface * @since 2.0.0 */ private $session; /** * Constructor. * * @param string $name The event name. * @param SessionInterface $session The SessionInterface object for this event. * * @since 2.0.0 */ public function __construct(string $name, SessionInterface $session) { parent::__construct($name); $this->session = $session; } /** * Retrieve the SessionInterface object attached to this event. * * @return SessionInterface * * @since 2.0.0 */ public function getSession(): SessionInterface { return $this->session; } } PK c�\P>�0r r " session/src/ValidatorInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session; /** * Interface for validating a part of the session * * @since 2.0.0 */ interface ValidatorInterface { /** * Validates the session * * @param boolean $restart Flag if the session should be restarted * * @return void * * @since 2.0.0 * @throws Exception\InvalidSessionException */ public function validate(bool $restart = false): void; } PK c�\�Kj� � 1 session/src/Exception/InvalidSessionException.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Exception; /** * Exception thrown when a session validator fails * * @since 2.0.0 */ class InvalidSessionException extends \RuntimeException { } PK c�\�G�� � 5 session/src/Exception/CreateSessionTableException.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Exception; /** * Exception thrown when the database session table cannot be created * * @since 2.0.0 */ class CreateSessionTableException extends \RuntimeException { } PK c�\� �Z� � < session/src/Exception/UnsupportedDatabaseDriverException.phpnu �[��� <?php /** * Part of the Joomla Framework Session Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Session\Exception; /** * Exception thrown when the database driver is unsupported * * @since 2.0.0 */ class UnsupportedDatabaseDriverException extends \UnexpectedValueException { } PK c�\Xj�i" i" session/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "services": [ { "image": "memcached:alpine", "name": "memcached" }, { "image": "redis:alpine", "name": "redis" } ], "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "services": [ { "image": "memcached:alpine", "name": "memcached" }, { "image": "redis:alpine", "name": "redis" } ], "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "services": [ { "image": "memcached:alpine", "name": "memcached" }, { "image": "redis:alpine", "name": "redis" } ], "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "services": [ { "image": "memcached:alpine", "name": "memcached" }, { "image": "redis:alpine", "name": "redis" } ], "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "services": [ { "image": "memcached:alpine", "name": "memcached" }, { "image": "redis:alpine", "name": "redis" } ], "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "services": [ { "image": "memcached:alpine", "name": "memcached" }, { "image": "redis:alpine", "name": "redis" } ], "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "services": [ { "image": "memcached:alpine", "name": "memcached" }, { "image": "redis:alpine", "name": "redis" } ], "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: 7b4c99661032efaac3aa1e3012dbb078a5c838693cfe069901f74f55faabcc56 ... PK c�\.>� � session/meta/sql/sqlite.sqlnu �[��� CREATE TABLE `#__session` ( `session_id` TEXT NOT NULL, `time` INTEGER NOT NULL, `data` BLOB NOT NULL, CONSTRAINT `idx_session` PRIMARY KEY (`session_id`) ); PK c�\�<�� � session/meta/sql/pgsql.sqlnu �[��� CREATE TABLE "#__session" ( "session_id" VARCHAR(128) NOT NULL, "time" INTEGER NOT NULL, "data" BYTEA NOT NULL, PRIMARY KEY ("session_id") ); PK c�\/�^� � session/meta/sql/mysql.sqlnu �[��� CREATE TABLE IF NOT EXISTS `#__session` ( `session_id` VARBINARY(128) NOT NULL, `time` INTEGER UNSIGNED NOT NULL, `data` BLOB NOT NULL, PRIMARY KEY (`session_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; PK c�\�*zVs s session/meta/sql/sqlsrv.sqlnu �[��� CREATE TABLE [#__session] ( [session_id] VARCHAR(128) NOT NULL, [time] INTEGER NOT NULL, [data] VARBINARY(MAX) NOT NULL, CONSTRAINT [PK_#__session_session_id] PRIMARY KEY CLUSTERED ( [session_id] ASC ) WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY] ) ON [PRIMARY]; PK c�\�8��T T session/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: ["vendor/bin/phpunit"] }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], services: [ { name: "memcached", image: "memcached:alpine" }, { name:"redis", image: "redis:alpine" } ] }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\�P�E �E session/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\�P�E �E ldap/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\��։= �= ldap/src/LdapClient.phpnu �[��� <?php /** * Part of the Joomla Framework LDAP Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Ldap; /** * LDAP client class * * @since 1.0 * @deprecated The joomla/ldap package is deprecated */ class LdapClient { /** * Hostname of LDAP server * * @var string * @since 1.0 */ public $host = null; /** * Authorization Method to use * * @var boolean * @since 1.0 */ public $auth_method = null; /** * Port of LDAP server * * @var integer * @since 1.0 */ public $port = null; /** * Base DN (e.g. o=MyDir) * * @var string * @since 1.0 */ public $base_dn = null; /** * User DN (e.g. cn=Users,o=MyDir) * * @var string * @since 1.0 */ public $users_dn = null; /** * Search String * * @var string * @since 1.0 */ public $search_string = null; /** * Use LDAP Version 3 * * @var boolean * @since 1.0 */ public $use_ldapV3 = null; /** * No referrals (server transfers) * * @var boolean * @since 1.0 */ public $no_referrals = null; /** * Negotiate TLS (encrypted communications) * * @var boolean * @since 1.0 */ public $negotiate_tls = null; /** * Username to connect to server * * @var string * @since 1.0 */ public $username = null; /** * Password to connect to server * * @var string * @since 1.0 */ public $password = null; /** * LDAP Resource Identifier * * @var resource * @since 1.0 */ private $resource = null; /** * Current DN * * @var string * @since 1.0 */ private $dn = null; /** * Flag tracking whether the connection has been bound * * @var boolean * @since 1.3.0 */ private $isBound = false; /** * Constructor * * @param object $configObj An object of configuration variables * * @since 1.0 */ public function __construct($configObj = null) { if (is_object($configObj)) { $vars = get_class_vars(get_class($this)); foreach (array_keys($vars) as $var) { if (substr($var, 0, 1) != '_') { $param = $configObj->get($var); if ($param) { $this->$var = $param; } } } } } /** * Class destructor. * * @since 1.3.0 */ public function __destruct() { $this->close(); } /** * Connect to an LDAP server * * @return boolean * * @since 1.0 */ public function connect() { if ($this->host == '') { return false; } $this->resource = ldap_connect($this->host, $this->port); if (!$this->resource) { return false; } if ($this->use_ldapV3 && !ldap_set_option($this->resource, LDAP_OPT_PROTOCOL_VERSION, 3)) { return false; } if (!ldap_set_option($this->resource, LDAP_OPT_REFERRALS, (int) $this->no_referrals)) { return false; } if ($this->negotiate_tls && !ldap_start_tls($this->resource)) { return false; } return true; } /** * Close the connection * * @return void * * @since 1.0 */ public function close() { if ($this->isConnected()) { $this->unbind(); } $this->resource = null; } /** * Sets the DN with some template replacements * * @param string $username The username * @param string $nosub ... * * @return void * * @since 1.0 */ public function setDn($username, $nosub = 0) { if ($this->users_dn == '' || $nosub) { $this->dn = $username; } elseif (strlen($username)) { $this->dn = str_replace('[username]', $username, $this->users_dn); } else { $this->dn = ''; } } /** * Get the configured DN * * @return string * * @since 1.0 */ public function getDn() { return $this->dn; } /** * Anonymously binds to LDAP directory * * @return boolean * * @since 1.0 */ public function anonymous_bind() { if (!$this->isConnected()) { if (!$this->connect()) { return false; } } $this->isBound = ldap_bind($this->resource); return $this->isBound; } /** * Binds to the LDAP directory * * @param string $username The username * @param string $password The password * @param string $nosub ... * * @return boolean * * @since 1.0 */ public function bind($username = null, $password = null, $nosub = 0) { if (!$this->isConnected()) { if (!$this->connect()) { return false; } } if (is_null($username)) { $username = $this->username; } if (is_null($password)) { $password = $this->password; } $this->setDn($username, $nosub); $this->isBound = ldap_bind($this->resource, $this->getDn(), $password); return $this->isBound; } /** * Unbinds from the LDAP directory * * @return boolean * * @since 1.3.0 */ public function unbind() { if ($this->isBound && $this->resource && is_resource($this->resource)) { return ldap_unbind($this->resource); } return true; } /** * Perform an LDAP search using comma separated search strings * * @param string $search search string of search values * * @return array Search results * * @since 1.0 */ public function simple_search($search) { $results = explode(';', $search); foreach ($results as $key => $result) { $results[$key] = '(' . $result . ')'; } return $this->search($results); } /** * Performs an LDAP search * * @param array $filters Search Filters (array of strings) * @param string $dnoverride DN Override * @param array $attributes An array of attributes to return (if empty, all fields are returned). * * @return array Multidimensional array of results * * @since 1.0 */ public function search(array $filters, $dnoverride = null, array $attributes = array()) { $result = array(); if (!$this->isBound || !$this->isConnected()) { return $result; } if ($dnoverride) { $dn = $dnoverride; } else { $dn = $this->base_dn; } foreach ($filters as $searchFilter) { $searchResult = ldap_search($this->resource, $dn, $searchFilter, $attributes); if ($searchResult && ($count = ldap_count_entries($this->resource, $searchResult)) > 0) { for ($i = 0; $i < $count; $i++) { $result[$i] = array(); if (!$i) { $firstentry = ldap_first_entry($this->resource, $searchResult); } else { $firstentry = ldap_next_entry($this->resource, $firstentry); } // Load user-specified attributes $attributeResult = ldap_get_attributes($this->resource, $firstentry); // LDAP returns an array of arrays, fit this into attributes result array foreach ($attributeResult as $ki => $ai) { if (is_array($ai)) { $subcount = $ai['count']; $result[$i][$ki] = array(); for ($k = 0; $k < $subcount; $k++) { $result[$i][$ki][$k] = $ai[$k]; } } } $result[$i]['dn'] = ldap_get_dn($this->resource, $firstentry); } } } return $result; } /** * Replace attribute values with new ones * * @param string $dn The DN which contains the attribute you want to replace * @param string $attribute The attribute values you want to replace * * @return boolean * * @since 1.0 */ public function replace($dn, $attribute) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_mod_replace($this->resource, $dn, $attribute); } /** * Modify an LDAP entry * * @param string $dn The DN which contains the attribute you want to modify * @param string $attribute The attribute values you want to modify * * @return boolean * * @since 1.0 */ public function modify($dn, $attribute) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_modify($this->resource, $dn, $attribute); } /** * Delete attribute values from current attributes * * @param string $dn The DN which contains the attribute you want to remove * @param string $attribute The attribute values you want to remove * * @return boolean * * @since 1.0 */ public function remove($dn, $attribute) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_mod_del($this->resource, $dn, $attribute); } /** * Compare value of attribute found in entry specified with DN * * @param string $dn The DN which contains the attribute you want to compare * @param string $attribute The attribute whose value you want to compare * @param string $value The value you want to check against the LDAP attribute * * @return boolean|integer Boolean result of the comparison or -1 on error * * @since 1.0 */ public function compare($dn, $attribute, $value) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_compare($this->resource, $dn, $attribute, $value); } /** * Read attributes of a given DN * * @param string $dn The DN of the object you want to read * * @return array|boolean Array of attributes for the given DN or boolean false on failure * * @since 1.0 */ public function read($dn) { if (!$this->isBound || !$this->isConnected()) { return false; } $base = substr($dn, strpos($dn, ',') + 1); $cn = substr($dn, 0, strpos($dn, ',')); $result = ldap_read($this->resource, $base, $cn); if ($result === false) { return false; } return ldap_get_entries($this->resource, $result); } /** * Delete an entry from a directory * * @param string $dn The DN of the object you want to delete * * @return boolean * * @since 1.0 */ public function delete($dn) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_delete($this->resource, $dn); } /** * Add entries to LDAP directory * * @param string $dn The DN where you want to put the object * @param array $entries An array of arrays describing the object to add * * @return boolean * * @since 1.0 */ public function create($dn, array $entries) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_add($this->resource, $dn, $entries); } /** * Add attribute values to current attributes * * @param string $dn The DN of the entry to add the attribute * @param array $entry An array of arrays with attributes to add * * @return boolean * * @since 1.0 */ public function add($dn, array $entry) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_mod_add($this->resource, $dn, $entry); } /** * Modify the name of an entry * * @param string $dn The DN of the entry at the moment * @param string $newdn The DN of the entry should be (only cn=newvalue) * @param string $newparent The full DN of the parent (null by default) * @param boolean $deleteolddn Delete the old values (default) * * @return boolean * * @since 1.0 */ public function rename($dn, $newdn, $newparent, $deleteolddn) { if (!$this->isBound || !$this->isConnected()) { return false; } return ldap_rename($this->resource, $dn, $newdn, $newparent, $deleteolddn); } /** * Escape a string * * @param string $value The subject string * @param string $ignore Characters to ignore when escaping. * @param integer $flags The context the escaped string will be used in LDAP_ESCAPE_FILTER or LDAP_ESCAPE_DN * * @return string * * @since 1.2.0 */ public function escape($value, $ignore = '', $flags = 0) { return ldap_escape($value, $ignore, $flags); } /** * Return the LDAP error message of the last LDAP command * * @return string * * @since 1.0 */ public function getErrorMsg() { if (!$this->isBound || !$this->isConnected()) { return ''; } return ldap_error($this->resource); } /** * Check if the connection is established * * @return boolean * * @since 1.3.0 */ public function isConnected() { return $this->resource && is_resource($this->resource); } /** * Converts a dot notation IP address to net address (e.g. for Netware, etc) * * @param string $ip IP Address (e.g. xxx.xxx.xxx.xxx) * * @return string * * @since 1.0 */ public static function ipToNetAddress($ip) { $parts = explode('.', $ip); $address = '1#'; foreach ($parts as $int) { $tmp = dechex($int); if (strlen($tmp) != 2) { $tmp = '0' . $tmp; } $address .= '\\' . $tmp; } return $address; } /** * Extract readable network address from the LDAP encoded networkAddress attribute. * * Please keep this document block and author attribution in place. * * Novell Docs, see: http://developer.novell.com/ndk/doc/ndslib/schm_enu/data/sdk5624.html#sdk5624 * for Address types: http://developer.novell.com/ndk/doc/ndslib/index.html?page=/ndk/doc/ndslib/schm_enu/data/sdk4170.html * LDAP Format, String: * taggedData = uint32String "#" octetstring * byte 0 = uint32String = Address Type: 0= IPX Address; 1 = IP Address * byte 1 = char = "#" - separator * byte 2+ = octetstring - the ordinal value of the address * Note: with eDirectory 8.6.2, the IP address (type 1) returns * correctly, however, an IPX address does not seem to. eDir 8.7 may correct this. * Enhancement made by Merijn van de Schoot: * If addresstype is 8 (UDP) or 9 (TCP) do some additional parsing like still returning the IP address * * @param string $networkaddress The network address * * @return array * * @author Jay Burrell, Systems & Networks, Mississippi State University * @since 1.0 */ public static function ldapNetAddr($networkaddress) { $addr = ""; $addrtype = (int) substr($networkaddress, 0, 1); // Throw away bytes 0 and 1 which should be the addrtype and the "#" separator $networkaddress = substr($networkaddress, 2); if (($addrtype == 8) || ($addrtype = 9)) { // TODO 1.6: If UDP or TCP, (TODO fill addrport and) strip portnumber information from address $networkaddress = substr($networkaddress, (strlen($networkaddress) - 4)); } $addrtypes = array( 'IPX', 'IP', 'SDLC', 'Token Ring', 'OSI', 'AppleTalk', 'NetBEUI', 'Socket', 'UDP', 'TCP', 'UDP6', 'TCP6', 'Reserved (12)', 'URL', 'Count' ); $len = strlen($networkaddress); if ($len > 0) { for ($i = 0; $i < $len; $i++) { $byte = substr($networkaddress, $i, 1); $addr .= ord($byte); if (($addrtype == 1) || ($addrtype == 8) || ($addrtype = 9)) { // Dot separate IP addresses... $addr .= "."; } } if (($addrtype == 1) || ($addrtype == 8) || ($addrtype = 9)) { // Strip last period from end of $addr $addr = substr($addr, 0, strlen($addr) - 1); } } else { $addr .= 'Address not available.'; } return array('protocol' => $addrtypes[$addrtype], 'address' => $addr); } /** * Generates a LDAP compatible password * * @param string $password Clear text password to encrypt * @param string $type Type of password hash, either md5 or SHA * * @return string * * @since 1.0 */ public static function generatePassword($password, $type = 'md5') { switch (strtolower($type)) { case 'sha': return '{SHA}' . base64_encode(pack('H*', sha1($password))); case 'md5': default: return '{MD5}' . base64_encode(pack('H*', md5($password))); } } } PK c�\�P�E �E application/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\���� + application/src/WebApplicationInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2019 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; use Joomla\Input\Input; use Psr\Http\Message\ResponseInterface; /** * Application sub-interface defining a web application class * * @since 2.0.0 */ interface WebApplicationInterface extends ApplicationInterface { /** * Method to get the application input object. * * @return Input * * @since 2.0.0 */ public function getInput(): Input; /** * Redirect to another URL. * * If the headers have not been sent the redirect will be accomplished using a "301 Moved Permanently" or "303 See Other" code in the header * pointing to the new location. If the headers have already been sent this will be accomplished using a JavaScript statement. * * @param string $url The URL to redirect to. Can only be http/https URL * @param integer|boolean $status The HTTP status code to be provided. 303 is assumed by default. * * @return void * * @since 2.0.0 * @throws \InvalidArgumentException */ public function redirect($url, $status = 303); /** * Set/get cachable state for the response. * * If $allow is set, sets the cachable state of the response. Always returns the current state. * * @param boolean $allow True to allow browser caching. * * @return boolean * * @since 2.0.0 */ public function allowCache($allow = null); /** * Method to set a response header. * * If the replace flag is set then all headers with the given name will be replaced by the new one. * The headers are stored in an internal array to be sent when the site is sent to the browser. * * @param string $name The name of the header to set. * @param string $value The value of the header to set. * @param boolean $replace True to replace any headers with the same name. * * @return $this * * @since 2.0.0 */ public function setHeader($name, $value, $replace = false); /** * Method to get the array of response headers to be sent when the response is sent to the client. * * @return array * * @since 2.0.0 */ public function getHeaders(); /** * Method to clear any set response headers. * * @return $this * * @since 2.0.0 */ public function clearHeaders(); /** * Send the response headers. * * @return $this * * @since 2.0.0 */ public function sendHeaders(); /** * Set body content. If body content already defined, this will replace it. * * @param string $content The content to set as the response body. * * @return $this * * @since 2.0.0 */ public function setBody($content); /** * Prepend content to the body content * * @param string $content The content to prepend to the response body. * * @return $this * * @since 2.0.0 */ public function prependBody($content); /** * Append content to the body content * * @param string $content The content to append to the response body. * * @return $this * * @since 2.0.0 */ public function appendBody($content); /** * Return the body content * * @return mixed The response body as a string. * * @since 2.0.0 */ public function getBody(); /** * Get the PSR-7 Response Object. * * @return ResponseInterface * * @since 2.0.0 */ public function getResponse(): ResponseInterface; /** * Check if the value is a valid HTTP status code * * @param integer $code The potential status code * * @return boolean * * @since 2.0.0 */ public function isValidHttpStatus($code); /** * Set the PSR-7 Response Object. * * @param ResponseInterface $response The response object * * @return void * * @since 2.0.0 */ public function setResponse(ResponseInterface $response): void; /** * Determine if we are using a secure (SSL) connection. * * @return boolean True if using SSL, false if not. * * @since 2.0.0 */ public function isSslConnection(); } PK c�\\�[^� � " application/src/WebApplication.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2018 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; use Joomla\Application\Controller\ControllerResolverInterface; use Joomla\Application\Web\WebClient; use Joomla\Input\Input; use Joomla\Registry\Registry; use Joomla\Router\RouterInterface; use Psr\Http\Message\ResponseInterface; /** * A basic web application class for handing HTTP requests. * * @since 2.0.0 */ class WebApplication extends AbstractWebApplication implements SessionAwareWebApplicationInterface { use SessionAwareWebApplicationTrait; /** * The application's controller resolver. * * @var ControllerResolverInterface * @since 2.0.0 */ protected $controllerResolver; /** * The application's router. * * @var RouterInterface * @since 2.0.0 */ protected $router; /** * Class constructor. * * @param ControllerResolverInterface $controllerResolver The application's controller resolver * @param RouterInterface $router The application's router * @param Input $input An optional argument to provide dependency injection * for the application's input object. If the argument * is an Input object that object will become the * application's input object, otherwise a default input * object is created. * @param Registry $config An optional argument to provide dependency injection * for the application's config object. If the argument * is a Registry object that object will become the * application's config object, otherwise a default * config object is created. * @param Web\WebClient $client An optional argument to provide dependency injection * for the application's client object. If the argument * is a Web\WebClient object that object will become the * application's client object, otherwise a default * client object is created. * @param ResponseInterface $response An optional argument to provide dependency injection * for the application's response object. If the * argument is a ResponseInterface object that object * will become the application's response object, * otherwise a default response object is created. * * @since 2.0.0 */ public function __construct( ControllerResolverInterface $controllerResolver, RouterInterface $router, Input $input = null, Registry $config = null, WebClient $client = null, ResponseInterface $response = null ) { $this->controllerResolver = $controllerResolver; $this->router = $router; // Call the constructor as late as possible (it runs `initialise`). parent::__construct($input, $config, $client, $response); } /** * Method to run the application routines. * * @return void * * @since 2.0.0 */ protected function doExecute(): void { $route = $this->router->parseRoute($this->get('uri.route'), $this->input->getMethod()); // Add variables to the input if not already set foreach ($route->getRouteVariables() as $key => $value) { $this->input->def($key, $value); } \call_user_func($this->controllerResolver->resolve($route)); } } PK c�\U�5K� � : application/src/ConfigurationAwareApplicationInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2018 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; use Joomla\Registry\Registry; /** * Application sub-interface defining an application class which is aware of its configuration * * @since 2.0.0 */ interface ConfigurationAwareApplicationInterface extends ApplicationInterface { /** * Returns a property of the object or the default value if the property is not set. * * @param string $key The name of the property. * @param mixed $default The default value (optional) if none is set. * * @return mixed The value of the configuration. * * @since 2.0.0 */ public function get($key, $default = null); /** * Modifies a property of the object, creating it if it does not already exist. * * @param string $key The name of the property. * @param mixed $value The value of the property to set (optional). * * @return mixed Previous value of the property * * @since 2.0.0 */ public function set($key, $value = null); /** * Sets the configuration for the application. * * @param Registry $config A registry object holding the configuration. * * @return $this * * @since 2.0.0 */ public function setConfiguration(Registry $config); } PK c�\ m�L� � : application/src/Controller/ControllerResolverInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2018 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application\Controller; use Joomla\Router\ResolvedRoute; /** * Interface defining a controller resolver. * * @since 2.0.0 */ interface ControllerResolverInterface { /** * Resolve the controller for a route * * @param ResolvedRoute $route The route to resolve the controller for * * @return callable * * @since 2.0.0 * @throws \InvalidArgumentException */ public function resolve(ResolvedRoute $route): callable; } PK c�\UEV� � : application/src/Controller/ContainerControllerResolver.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2018 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application\Controller; use Psr\Container\ContainerInterface; /** * Controller resolver which supports creating controllers from a PSR-11 compatible container * * Controllers must be registered in the container using their FQCN as a service key * * @since 2.0.0 */ class ContainerControllerResolver extends ControllerResolver { /** * The container to search for controllers in * * @var ContainerInterface * @since 2.0.0 */ private $container; /** * Constructor * * @param ContainerInterface $container The container to search for controllers in * * @since 2.0.0 */ public function __construct(ContainerInterface $container) { $this->container = $container; } /** * Instantiate a controller class * * @param string $class The class to instantiate * * @return object Controller class instance * * @since 2.0.0 */ protected function instantiateController(string $class): object { if ($this->container->has($class)) { return $this->container->get($class); } return parent::instantiateController($class); } } PK c�\ �u�R R 1 application/src/Controller/ControllerResolver.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2018 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application\Controller; use Joomla\Controller\ControllerInterface; use Joomla\Router\ResolvedRoute; /** * Resolves a controller for the given route. * * @since 2.0.0 */ class ControllerResolver implements ControllerResolverInterface { /** * Resolve the controller for a route * * @param ResolvedRoute $route The route to resolve the controller for * * @return callable * * @throws \InvalidArgumentException * @since 2.0.0 */ public function resolve(ResolvedRoute $route): callable { $controller = $route->getController(); // Try to resolve a callable defined as an array if (\is_array($controller)) { if (isset($controller[0]) && \is_string($controller[0]) && isset($controller[1])) { if (!\class_exists($controller[0])) { throw new \InvalidArgumentException( \sprintf('Cannot resolve controller for URI `%s`', $route->getUri()) ); } try { $controller[0] = $this->instantiateController($controller[0]); } catch (\ArgumentCountError $error) { throw new \InvalidArgumentException( \sprintf( 'Controller `%s` has required constructor arguments, cannot instantiate the class', $controller[0] ), 0, $error ); } } if (!\is_callable($controller)) { throw new \InvalidArgumentException( \sprintf('Cannot resolve controller for URI `%s`', $route->getUri()) ); } return $controller; } // Try to resolve an invokable object if (\is_object($controller)) { if (!\is_callable($controller)) { throw new \InvalidArgumentException( \sprintf('Cannot resolve controller for URI `%s`', $route->getUri()) ); } return $controller; } // Try to resolve a known function if (\function_exists($controller)) { return $controller; } // Try to resolve a class name if it implements our ControllerInterface if (\is_string($controller) && \interface_exists(ControllerInterface::class)) { if (!\class_exists($controller)) { throw new \InvalidArgumentException( \sprintf('Cannot resolve controller for URI `%s`', $route->getUri()) ); } try { return [$this->instantiateController($controller), 'execute']; } catch (\ArgumentCountError $error) { throw new \InvalidArgumentException( \sprintf( 'Controller `%s` has required constructor arguments, cannot instantiate the class', $controller ), 0, $error ); } } // Unsupported resolution throw new \InvalidArgumentException(\sprintf('Cannot resolve controller for URI `%s`', $route->getUri())); } /** * Instantiate a controller class * * @param string $class The class to instantiate * * @return object Controller class instance * * @since 2.0.0 */ protected function instantiateController(string $class): object { return new $class(); } } PK c�\�=\�� � * application/src/Event/ApplicationEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2017 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application\Event; use Joomla\Application\AbstractApplication; use Joomla\Event\Event; /** * Base event class for application events. * * @since 2.0.0 */ class ApplicationEvent extends Event { /** * The active application. * * @var AbstractApplication * @since 2.0.0 */ private $application; /** * Event constructor. * * @param string $name The event name. * @param AbstractApplication $application The active application. * * @since 2.0.0 */ public function __construct(string $name, AbstractApplication $application) { parent::__construct($name); $this->application = $application; } /** * Get the active application. * * @return AbstractApplication * * @since 2.0.0 */ public function getApplication(): AbstractApplication { return $this->application; } } PK c�\��WM / application/src/Event/ApplicationErrorEvent.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2018 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application\Event; use Joomla\Application\AbstractApplication; use Joomla\Application\ApplicationEvents; use Joomla\Event\Event; /** * Event class thrown when an application error occurs. * * @since 2.0.0 */ class ApplicationErrorEvent extends ApplicationEvent { /** * The Throwable object with the error data. * * @var \Throwable * @since 2.0.0 */ private $error; /** * Event constructor. * * @param \Throwable $error The Throwable object with the error data. * @param AbstractApplication $application The active application. * * @since 2.0.0 */ public function __construct(\Throwable $error, AbstractApplication $application) { parent::__construct(ApplicationEvents::ERROR, $application); $this->error = $error; } /** * Get the error object. * * @return \Throwable * * @since 2.0.0 */ public function getError(): \Throwable { return $this->error; } /** * Set the error object. * * @param \Throwable $error The error object to set to the event. * * @return void * * @since 2.0.0 */ public function setError(\Throwable $error): void { $this->error = $error; } } PK c�\�0T� � / application/src/Exception/UnableToWriteBody.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2017 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application\Exception; /** * Exception thrown when the application can't write to the response body * * @since 2.0.0 */ class UnableToWriteBody extends \DomainException { } PK c�\)�D�R R 3 application/src/SessionAwareWebApplicationTrait.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2019 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; use Joomla\Input\Input; use Joomla\Session\SessionInterface; /** * Trait which helps implementing `Joomla\Application\SessionAwareWebApplicationInterface` in a web application class. * * @since 2.0.0 */ trait SessionAwareWebApplicationTrait { /** * The application session object. * * @var SessionInterface * @since 2.0.0 */ protected $session; /** * Method to get the application input object. * * @return Input * * @since 2.0.0 */ abstract public function getInput(): Input; /** * Method to get the application session object. * * @return SessionInterface The session object * * @since 2.0.0 */ public function getSession() { if ($this->session === null) { throw new \RuntimeException(\sprintf('A %s object has not been set.', SessionInterface::class)); } return $this->session; } /** * Sets the session for the application to use, if required. * * @param SessionInterface $session A session object. * * @return $this * * @since 2.0.0 */ public function setSession(SessionInterface $session) { $this->session = $session; return $this; } /** * Checks for a form token in the request. * * @param string $method The request method in which to look for the token key. * * @return boolean * * @since 2.0.0 */ public function checkToken($method = 'post') { $token = $this->getFormToken(); // Support a token sent via the X-CSRF-Token header, then fall back to a token in the request $requestToken = $this->getInput()->server->get( 'HTTP_X_CSRF_TOKEN', $this->getInput()->$method->get($token, '', 'alnum'), 'alnum' ); if (!$requestToken) { return false; } return $this->getSession()->hasToken($token); } /** * Method to determine a hash for anti-spoofing variable names * * @param boolean $forceNew If true, force a new token to be created * * @return string Hashed var name * * @since 2.0.0 */ public function getFormToken($forceNew = false) { return $this->getSession()->getToken($forceNew); } } PK c�\~�� O O ! application/src/Web/WebClient.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2013 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application\Web; /** * Class to model a Web Client. * * @property-read integer $platform The detected platform on which the web client runs. * @property-read boolean $mobile True if the web client is a mobile device. * @property-read integer $engine The detected rendering engine used by the web client. * @property-read integer $browser The detected browser used by the web client. * @property-read string $browserVersion The detected browser version used by the web client. * @property-read array $languages The priority order detected accepted languages for the client. * @property-read array $encodings The priority order detected accepted encodings for the client. * @property-read string $userAgent The web client's user agent string. * @property-read string $acceptEncoding The web client's accepted encoding string. * @property-read string $acceptLanguage The web client's accepted languages string. * @property-read array $detection An array of flags determining whether a detection routine has been run. * @property-read boolean $robot True if the web client is a robot * @property-read array $headers An array of all headers sent by client * * @since 1.0.0 */ class WebClient { public const WINDOWS = 1; public const WINDOWS_PHONE = 2; public const WINDOWS_CE = 3; public const IPHONE = 4; public const IPAD = 5; public const IPOD = 6; public const MAC = 7; public const BLACKBERRY = 8; public const ANDROID = 9; public const LINUX = 10; public const TRIDENT = 11; public const WEBKIT = 12; public const GECKO = 13; public const PRESTO = 14; public const KHTML = 15; public const AMAYA = 16; public const IE = 17; public const FIREFOX = 18; public const CHROME = 19; public const SAFARI = 20; public const OPERA = 21; public const ANDROIDTABLET = 22; public const EDGE = 23; public const BLINK = 24; public const EDG = 25; /** * The detected platform on which the web client runs. * * @var integer * @since 1.0.0 */ protected $platform; /** * True if the web client is a mobile device. * * @var boolean * @since 1.0.0 */ protected $mobile = false; /** * The detected rendering engine used by the web client. * * @var integer * @since 1.0.0 */ protected $engine; /** * The detected browser used by the web client. * * @var integer * @since 1.0.0 */ protected $browser; /** * The detected browser version used by the web client. * * @var string * @since 1.0.0 */ protected $browserVersion; /** * The priority order detected accepted languages for the client. * * @var array * @since 1.0.0 */ protected $languages = []; /** * The priority order detected accepted encodings for the client. * * @var array * @since 1.0.0 */ protected $encodings = []; /** * The web client's user agent string. * * @var string * @since 1.0.0 */ protected $userAgent; /** * The web client's accepted encoding string. * * @var string * @since 1.0.0 */ protected $acceptEncoding; /** * The web client's accepted languages string. * * @var string * @since 1.0.0 */ protected $acceptLanguage; /** * True if the web client is a robot. * * @var boolean * @since 1.0.0 */ protected $robot = false; /** * An array of flags determining whether or not a detection routine has been run. * * @var array * @since 1.0.0 */ protected $detection = []; /** * An array of headers sent by client. * * @var array * @since 1.3.0 */ protected $headers; /** * Class constructor. * * @param string $userAgent The optional user-agent string to parse. * @param string $acceptEncoding The optional client accept encoding string to parse. * @param string $acceptLanguage The optional client accept language string to parse. * * @since 1.0.0 */ public function __construct($userAgent = null, $acceptEncoding = null, $acceptLanguage = null) { // If no explicit user agent string was given attempt to use the implicit one from server environment. if (empty($userAgent) && isset($_SERVER['HTTP_USER_AGENT'])) { $this->userAgent = $_SERVER['HTTP_USER_AGENT']; } else { $this->userAgent = $userAgent; } // If no explicit acceptable encoding string was given attempt to use the implicit one from server environment. if (empty($acceptEncoding) && isset($_SERVER['HTTP_ACCEPT_ENCODING'])) { $this->acceptEncoding = $_SERVER['HTTP_ACCEPT_ENCODING']; } else { $this->acceptEncoding = $acceptEncoding; } // If no explicit acceptable languages string was given attempt to use the implicit one from server environment. if (empty($acceptLanguage) && isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) { $this->acceptLanguage = $_SERVER['HTTP_ACCEPT_LANGUAGE']; } else { $this->acceptLanguage = $acceptLanguage; } } /** * Magic method to get an object property's value by name. * * @param string $name Name of the property for which to return a value. * * @return mixed The requested value if it exists. * * @since 1.0.0 */ public function __get($name) { switch ($name) { case 'mobile': case 'platform': if (empty($this->detection['platform'])) { $this->detectPlatform($this->userAgent); } break; case 'engine': if (empty($this->detection['engine'])) { $this->detectEngine($this->userAgent); } break; case 'browser': case 'browserVersion': if (empty($this->detection['browser'])) { $this->detectBrowser($this->userAgent); } break; case 'languages': if (empty($this->detection['acceptLanguage'])) { $this->detectLanguage($this->acceptLanguage); } break; case 'encodings': if (empty($this->detection['acceptEncoding'])) { $this->detectEncoding($this->acceptEncoding); } break; case 'robot': if (empty($this->detection['robot'])) { $this->detectRobot($this->userAgent); } break; case 'headers': if (empty($this->detection['headers'])) { $this->detectHeaders(); } break; } // Return the property if it exists. if (\property_exists($this, $name)) { return $this->$name; } $trace = \debug_backtrace(); \trigger_error( 'Undefined property via \__get(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_NOTICE ); } /** * Detects the client browser and version in a user agent string. * * @param string $userAgent The user-agent string to parse. * * @return void * * @since 1.0.0 */ protected function detectBrowser($userAgent) { $patternBrowser = ''; // Attempt to detect the browser type. Obviously we are only worried about major browsers. if ((\stripos($userAgent, 'MSIE') !== false) && (\stripos($userAgent, 'Opera') === false)) { $this->browser = self::IE; $patternBrowser = 'MSIE'; } elseif (\stripos($userAgent, 'Trident') !== false) { $this->browser = self::IE; $patternBrowser = ' rv'; } elseif (\stripos($userAgent, 'Edge') !== false) { $this->browser = self::EDGE; $patternBrowser = 'Edge'; } elseif (\stripos($userAgent, 'Edg') !== false) { $this->browser = self::EDG; $patternBrowser = 'Edg'; } elseif ((\stripos($userAgent, 'Firefox') !== false) && (\stripos($userAgent, 'like Firefox') === false)) { $this->browser = self::FIREFOX; $patternBrowser = 'Firefox'; } elseif (\stripos($userAgent, 'OPR') !== false) { $this->browser = self::OPERA; $patternBrowser = 'OPR'; } elseif (\stripos($userAgent, 'Chrome') !== false) { $this->browser = self::CHROME; $patternBrowser = 'Chrome'; } elseif (\stripos($userAgent, 'Safari') !== false) { $this->browser = self::SAFARI; $patternBrowser = 'Safari'; } elseif (\stripos($userAgent, 'Opera') !== false) { $this->browser = self::OPERA; $patternBrowser = 'Opera'; } // If we detected a known browser let's attempt to determine the version. if ($this->browser) { // Build the REGEX pattern to match the browser version string within the user agent string. $pattern = '#(?<browser>Version|' . $patternBrowser . ')[/ :]+(?<version>[0-9.|a-zA-Z.]*)#'; // Attempt to find version strings in the user agent string. $matches = []; if (\preg_match_all($pattern, $userAgent, $matches)) { // Do we have both a Version and browser match? if (\count($matches['browser']) == 2) { // See whether Version or browser came first, and use the number accordingly. if (\strripos($userAgent, 'Version') < \strripos($userAgent, $patternBrowser)) { $this->browserVersion = $matches['version'][0]; } else { $this->browserVersion = $matches['version'][1]; } } elseif (\count($matches['browser']) > 2) { $key = \array_search('Version', $matches['browser']); if ($key) { $this->browserVersion = $matches['version'][$key]; } } else { // We only have a Version or a browser so use what we have. $this->browserVersion = $matches['version'][0]; } } } // Mark this detection routine as run. $this->detection['browser'] = true; } /** * Method to detect the accepted response encoding by the client. * * @param string $acceptEncoding The client accept encoding string to parse. * * @return void * * @since 1.0.0 */ protected function detectEncoding($acceptEncoding) { // Parse the accepted encodings. $this->encodings = \array_map('trim', (array) \explode(',', (string) $acceptEncoding)); // Mark this detection routine as run. $this->detection['acceptEncoding'] = true; } /** * Detects the client rendering engine in a user agent string. * * @param string $userAgent The user-agent string to parse. * * @return void * * @since 1.0.0 */ protected function detectEngine($userAgent) { if (\stripos($userAgent, 'MSIE') !== false || \stripos($userAgent, 'Trident') !== false) { // Attempt to detect the client engine -- starting with the most popular ... for now. $this->engine = self::TRIDENT; } elseif (\stripos($userAgent, 'Edge') !== false || \stripos($userAgent, 'EdgeHTML') !== false) { $this->engine = self::EDGE; } elseif (\stripos($userAgent, 'Edg') !== false) { $this->engine = self::BLINK; } elseif (\stripos($userAgent, 'Chrome') !== false) { $result = \explode('/', \stristr($userAgent, 'Chrome')); $version = \explode(' ', $result[1]); if ($version[0] >= 28) { $this->engine = self::BLINK; } else { $this->engine = self::WEBKIT; } } elseif (\stripos($userAgent, 'AppleWebKit') !== false || \stripos($userAgent, 'blackberry') !== false) { if (\stripos($userAgent, 'AppleWebKit') !== false) { $result = \explode('/', \stristr($userAgent, 'AppleWebKit')); $version = \explode(' ', $result[1]); if ($version[0] === 537.36) { // AppleWebKit/537.36 is Blink engine specific, exception is Blink emulated IEMobile, Trident or Edge $this->engine = self::BLINK; } } // Evidently blackberry uses WebKit and doesn't necessarily report it. Bad RIM. $this->engine = self::WEBKIT; } elseif (\stripos($userAgent, 'Gecko') !== false && \stripos($userAgent, 'like Gecko') === false) { // We have to check for like Gecko because some other browsers spoof Gecko. $this->engine = self::GECKO; } elseif (\stripos($userAgent, 'Opera') !== false || \stripos($userAgent, 'Presto') !== false) { $version = false; if (\preg_match('/Opera[\/| ]?([0-9.]+)/u', $userAgent, $match)) { $version = (float) ($match[1]); } if (\preg_match('/Version\/([0-9.]+)/u', $userAgent, $match)) { if ((float) ($match[1]) >= 10) { $version = (float) ($match[1]); } } if ($version !== false && $version >= 15) { $this->engine = self::BLINK; } else { $this->engine = self::PRESTO; } } elseif (\stripos($userAgent, 'KHTML') !== false) { // *sigh* $this->engine = self::KHTML; } elseif (\stripos($userAgent, 'Amaya') !== false) { // Lesser known engine but it finishes off the major list from Wikipedia :-) $this->engine = self::AMAYA; } // Mark this detection routine as run. $this->detection['engine'] = true; } /** * Method to detect the accepted languages by the client. * * @param mixed $acceptLanguage The client accept language string to parse. * * @return void * * @since 1.0.0 */ protected function detectLanguage($acceptLanguage) { // Parse the accepted encodings. $this->languages = \array_map('trim', (array) \explode(',', $acceptLanguage)); // Mark this detection routine as run. $this->detection['acceptLanguage'] = true; } /** * Detects the client platform in a user agent string. * * @param string $userAgent The user-agent string to parse. * * @return void * * @since 1.0.0 */ protected function detectPlatform($userAgent) { // Attempt to detect the client platform. if (\stripos($userAgent, 'Windows') !== false) { $this->platform = self::WINDOWS; // Let's look at the specific mobile options in the Windows space. if (\stripos($userAgent, 'Windows Phone') !== false) { $this->mobile = true; $this->platform = self::WINDOWS_PHONE; } elseif (\stripos($userAgent, 'Windows CE') !== false) { $this->mobile = true; $this->platform = self::WINDOWS_CE; } } elseif (\stripos($userAgent, 'iPhone') !== false) { // Interestingly 'iPhone' is present in all iOS devices so far including iPad and iPods. $this->mobile = true; $this->platform = self::IPHONE; // Let's look at the specific mobile options in the iOS space. if (\stripos($userAgent, 'iPad') !== false) { $this->platform = self::IPAD; } elseif (\stripos($userAgent, 'iPod') !== false) { $this->platform = self::IPOD; } } elseif (\stripos($userAgent, 'iPad') !== false) { // In case where iPhone is not mentioed in iPad user agent string $this->mobile = true; $this->platform = self::IPAD; } elseif (\stripos($userAgent, 'iPod') !== false) { // In case where iPhone is not mentioed in iPod user agent string $this->mobile = true; $this->platform = self::IPOD; } elseif (\preg_match('/macintosh|mac os x/i', $userAgent)) { // This has to come after the iPhone check because mac strings are also present in iOS devices. $this->platform = self::MAC; } elseif (\stripos($userAgent, 'Blackberry') !== false) { $this->mobile = true; $this->platform = self::BLACKBERRY; } elseif (\stripos($userAgent, 'Android') !== false) { $this->mobile = true; $this->platform = self::ANDROID; /* * Attempt to distinguish between Android phones and tablets * There is no totally foolproof method but certain rules almost always hold * Android 3.x is only used for tablets * Some devices and browsers encourage users to change their UA string to include Tablet. * Google encourages manufacturers to exclude the string Mobile from tablet device UA strings. * In some modes Kindle Android devices include the string Mobile but they include the string Silk. */ if ( \stripos($userAgent, 'Android 3') !== false || \stripos($userAgent, 'Tablet') !== false || \stripos($userAgent, 'Mobile') === false || \stripos($userAgent, 'Silk') !== false ) { $this->platform = self::ANDROIDTABLET; } } elseif (\stripos($userAgent, 'Linux') !== false) { $this->platform = self::LINUX; } // Mark this detection routine as run. $this->detection['platform'] = true; } /** * Determines if the browser is a robot or not. * * @param string $userAgent The user-agent string to parse. * * @return void * * @since 1.0.0 */ protected function detectRobot($userAgent) { $this->robot = (bool) \preg_match('/http|bot|robot|spider|crawler|curl|^$/i', $userAgent); $this->detection['robot'] = true; } /** * Fills internal array of headers * * @return void * * @since 1.3.0 */ protected function detectHeaders() { if (\function_exists('getallheaders')) { // If php is working under Apache, there is a special function $this->headers = \getallheaders(); } else { // Else we fill headers from $_SERVER variable $this->headers = []; foreach ($_SERVER as $name => $value) { if (\substr($name, 0, 5) == 'HTTP_') { $this->headers[\str_replace(' ', '-', \ucwords(\strtolower(\str_replace('_', ' ', \substr($name, 5)))))] = $value; } } } // Mark this detection routine as run. $this->detection['headers'] = true; } } PK c�\5���� �� * application/src/AbstractWebApplication.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2013 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; use Joomla\Application\Event\ApplicationErrorEvent; use Joomla\Application\Exception\UnableToWriteBody; use Joomla\Application\Web\WebClient; use Joomla\Input\Input; use Joomla\Registry\Registry; use Joomla\Uri\Uri; use Laminas\Diactoros\Response; use Laminas\Diactoros\Stream; use Psr\Http\Message\ResponseInterface; /** * Base class for a Joomla! Web application. * * @since 1.0.0 * * @property-read Input $input The application input object */ abstract class AbstractWebApplication extends AbstractApplication implements WebApplicationInterface { /** * The application input object. * * @var Input * @since 1.0.0 */ protected $input; /** * Character encoding string. * * @var string * @since 1.0.0 */ public $charSet = 'utf-8'; /** * Response mime type. * * @var string * @since 1.0.0 */ public $mimeType = 'text/html'; /** * HTTP protocol version. * * @var string * @since 1.9.0 */ public $httpVersion = '1.1'; /** * The body modified date for response headers. * * @var \DateTime * @since 1.0.0 */ public $modifiedDate; /** * The application client object. * * @var Web\WebClient * @since 1.0.0 */ public $client; /** * The application response object. * * @var ResponseInterface * @since 1.0.0 */ protected $response; /** * Is caching enabled? * * @var boolean * @since 2.0.0 */ private $cacheable = false; /** * A map of integer HTTP response codes to the full HTTP Status for the headers. * * @var array * @since 1.6.0 * @link https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml */ private $responseMap = [ 100 => 'HTTP/{version} 100 Continue', 101 => 'HTTP/{version} 101 Switching Protocols', 102 => 'HTTP/{version} 102 Processing', 200 => 'HTTP/{version} 200 OK', 201 => 'HTTP/{version} 201 Created', 202 => 'HTTP/{version} 202 Accepted', 203 => 'HTTP/{version} 203 Non-Authoritative Information', 204 => 'HTTP/{version} 204 No Content', 205 => 'HTTP/{version} 205 Reset Content', 206 => 'HTTP/{version} 206 Partial Content', 207 => 'HTTP/{version} 207 Multi-Status', 208 => 'HTTP/{version} 208 Already Reported', 226 => 'HTTP/{version} 226 IM Used', 300 => 'HTTP/{version} 300 Multiple Choices', 301 => 'HTTP/{version} 301 Moved Permanently', 302 => 'HTTP/{version} 302 Found', 303 => 'HTTP/{version} 303 See other', 304 => 'HTTP/{version} 304 Not Modified', 305 => 'HTTP/{version} 305 Use Proxy', 306 => 'HTTP/{version} 306 (Unused)', 307 => 'HTTP/{version} 307 Temporary Redirect', 308 => 'HTTP/{version} 308 Permanent Redirect', 400 => 'HTTP/{version} 400 Bad Request', 401 => 'HTTP/{version} 401 Unauthorized', 402 => 'HTTP/{version} 402 Payment Required', 403 => 'HTTP/{version} 403 Forbidden', 404 => 'HTTP/{version} 404 Not Found', 405 => 'HTTP/{version} 405 Method Not Allowed', 406 => 'HTTP/{version} 406 Not Acceptable', 407 => 'HTTP/{version} 407 Proxy Authentication Required', 408 => 'HTTP/{version} 408 Request Timeout', 409 => 'HTTP/{version} 409 Conflict', 410 => 'HTTP/{version} 410 Gone', 411 => 'HTTP/{version} 411 Length Required', 412 => 'HTTP/{version} 412 Precondition Failed', 413 => 'HTTP/{version} 413 Payload Too Large', 414 => 'HTTP/{version} 414 URI Too Long', 415 => 'HTTP/{version} 415 Unsupported Media Type', 416 => 'HTTP/{version} 416 Range Not Satisfiable', 417 => 'HTTP/{version} 417 Expectation Failed', 418 => 'HTTP/{version} 418 I\'m a teapot', 421 => 'HTTP/{version} 421 Misdirected Request', 422 => 'HTTP/{version} 422 Unprocessable Entity', 423 => 'HTTP/{version} 423 Locked', 424 => 'HTTP/{version} 424 Failed Dependency', 426 => 'HTTP/{version} 426 Upgrade Required', 428 => 'HTTP/{version} 428 Precondition Required', 429 => 'HTTP/{version} 429 Too Many Requests', 431 => 'HTTP/{version} 431 Request Header Fields Too Large', 451 => 'HTTP/{version} 451 Unavailable For Legal Reasons', 500 => 'HTTP/{version} 500 Internal Server Error', 501 => 'HTTP/{version} 501 Not Implemented', 502 => 'HTTP/{version} 502 Bad Gateway', 503 => 'HTTP/{version} 503 Service Unavailable', 504 => 'HTTP/{version} 504 Gateway Timeout', 505 => 'HTTP/{version} 505 HTTP Version Not Supported', 506 => 'HTTP/{version} 506 Variant Also Negotiates', 507 => 'HTTP/{version} 507 Insufficient Storage', 508 => 'HTTP/{version} 508 Loop Detected', 510 => 'HTTP/{version} 510 Not Extended', 511 => 'HTTP/{version} 511 Network Authentication Required', ]; /** * Class constructor. * * @param Input|null $input An optional argument to provide dependency * injection for the application's input object. If * the argument is an Input object that object will * become the application's input object, otherwise a * default input object is created. * @param Registry|null $config An optional argument to provide dependency * injection for the application's config object. If * the argument is a Registry object that object will * become the application's config object, otherwise a * default config object is created. * @param WebClient|null $client An optional argument to provide dependency * injection for the application's client object. If * the argument is a Web\WebClient object that object * will become the application's client object, * otherwise a default client object is created. * @param ResponseInterface|null $response An optional argument to provide dependency * injection for the application's response object. * If the argument is a ResponseInterface object that * object will become the application's response * object, otherwise a default response object is * created. * * @since 1.0.0 */ public function __construct( Input $input = null, Registry $config = null, WebClient $client = null, ResponseInterface $response = null ) { $this->input = $input ?: new Input(); $this->client = $client ?: new WebClient(); // Setup the response object. if (!$response) { $response = new Response(); } $this->setResponse($response); // Call the constructor as late as possible (it runs `initialise`). parent::__construct($config); // Set the system URIs. $this->loadSystemUris(); } /** * Magic method to access properties of the application. * * @param string $name The name of the property. * * @return Input|null A value if the property name is valid, null otherwise. * * @since 2.0.0 * @deprecated 3.0 This is a B/C proxy for deprecated read accesses */ public function __get($name) { switch ($name) { case 'input': \trigger_deprecation( 'joomla/application', '2.0.0', 'Accessing the input property of %s is deprecated, use the %s::getInput() method instead.', self::class, self::class ); return $this->getInput(); default: $trace = \debug_backtrace(); \trigger_error( \sprintf( 'Undefined property via __get(): %1$s in %2$s on line %3$s', $name, $trace[0]['file'], $trace[0]['line'] ), E_USER_NOTICE ); return null; } } /** * Execute the application. * * @return void * * @since 1.0.0 */ public function execute() { try { $this->dispatchEvent(ApplicationEvents::BEFORE_EXECUTE); // Perform application routines. $this->doExecute(); $this->dispatchEvent(ApplicationEvents::AFTER_EXECUTE); // If gzip compression is enabled in configuration and the server is compliant, compress the output. if ( $this->get('gzip') && !\ini_get('zlib.output_compression') && (\ini_get('output_handler') != 'ob_gzhandler') ) { $this->compress(); } } catch (\Throwable $throwable) { $this->dispatchEvent(ApplicationEvents::ERROR, new ApplicationErrorEvent($throwable, $this)); } $this->dispatchEvent(ApplicationEvents::BEFORE_RESPOND); // Send the application response. $this->respond(); $this->dispatchEvent(ApplicationEvents::AFTER_RESPOND); } /** * Checks the accept encoding of the browser and compresses the data before sending it to the client if possible. * * @return void * * @since 1.0.0 */ protected function compress() { // Supported compression encodings. $supported = [ 'x-gzip' => 'gz', 'gzip' => 'gz', 'deflate' => 'deflate', ]; // Get the supported encoding. $encodings = \array_intersect($this->client->encodings, \array_keys($supported)); // If no supported encoding is detected do nothing and return. if (empty($encodings)) { return; } // Verify that headers have not yet been sent, and that our connection is still alive. if ($this->checkHeadersSent() || !$this->checkConnectionAlive()) { return; } // Iterate through the encodings and attempt to compress the data using any found supported encodings. foreach ($encodings as $encoding) { if (($supported[$encoding] == 'gz') || ($supported[$encoding] == 'deflate')) { // Verify that the server supports gzip compression before we attempt to gzip encode the data. // @codeCoverageIgnoreStart if (!\extension_loaded('zlib') || \ini_get('zlib.output_compression')) { continue; } // @codeCoverageIgnoreEnd // Attempt to gzip encode the data with an optimal level 4. $data = $this->getBody(); $gzdata = \gzencode($data, 4, ($supported[$encoding] == 'gz') ? FORCE_GZIP : FORCE_DEFLATE); // If there was a problem encoding the data just try the next encoding scheme. // @codeCoverageIgnoreStart if ($gzdata === false) { continue; } // @codeCoverageIgnoreEnd // Set the encoding headers. $this->setHeader('Content-Encoding', $encoding); $this->setHeader('Vary', 'Accept-Encoding'); $this->setHeader('X-Content-Encoded-By', 'Joomla'); // Replace the output with the encoded data. $this->setBody($gzdata); // Compression complete, let's break out of the loop. break; } } } /** * Method to send the application response to the client. All headers will be sent prior to the main application * output data. * * @return void * * @since 1.0.0 */ protected function respond() { // Send the content-type header. if (!$this->getResponse()->hasHeader('Content-Type')) { $this->setHeader('Content-Type', $this->mimeType . '; charset=' . $this->charSet); } // If the response is set to uncachable, et some appropriate headers so browsers don't cache the response. if (!$this->allowCache()) { // Expires in the past. $this->setHeader('Expires', 'Wed, 17 Aug 2005 00:00:00 GMT', true); // Always modified. $this->setHeader('Last-Modified', \gmdate('D, d M Y H:i:s') . ' GMT', true); $this->setHeader('Cache-Control', 'no-store, no-cache, must-revalidate, post-check=0, pre-check=0', false); // HTTP 1.0 $this->setHeader('Pragma', 'no-cache'); } else { // Expires. if (!$this->getResponse()->hasHeader('Expires')) { $this->setHeader('Expires', \gmdate('D, d M Y H:i:s', \time() + 900) . ' GMT'); } // Last modified. if (!$this->getResponse()->hasHeader('Last-Modified') && $this->modifiedDate instanceof \DateTime) { $this->modifiedDate->setTimezone(new \DateTimeZone('UTC')); $this->setHeader('Last-Modified', $this->modifiedDate->format('D, d M Y H:i:s') . ' GMT'); } } // Make sure there is a status header already otherwise generate it from the response if (!$this->getResponse()->hasHeader('Status')) { $this->setHeader('Status', (string) $this->getResponse()->getStatusCode()); } $this->sendHeaders(); echo $this->getBody(); } /** * Method to get the application input object. * * @return Input * * @since 2.0.0 */ public function getInput(): Input { return $this->input; } /** * Redirect to another URL. * * If the headers have not been sent the redirect will be accomplished using a "301 Moved Permanently" or "303 See * Other" code in the header pointing to the new location. If the headers have already been sent this will be * accomplished using a JavaScript statement. * * @param string $url The URL to redirect to. Can only be http/https URL * @param integer|boolean $status The HTTP status code to be provided. 303 is assumed by default. * * @return void * * @throws \InvalidArgumentException * @since 1.0.0 */ public function redirect($url, $status = 303) { // Check for relative internal links. if (\preg_match('#^index\.php#', $url)) { $url = $this->get('uri.base.full') . $url; } // Perform a basic sanity check to make sure we don't have any CRLF garbage. $url = \preg_split("/[\r\n]/", $url); $url = $url[0]; /* * Here we need to check and see if the URL is relative or absolute. Essentially, do we need to * prepend the URL with our base URL for a proper redirect. The rudimentary way we are looking * at this is to simply check whether or not the URL string has a valid scheme or not. */ if (!\preg_match('#^[a-z]+://#i', $url)) { // Get a Uri instance for the requested URI. $uri = new Uri($this->get('uri.request')); // Get a base URL to prepend from the requested URI. $prefix = $uri->toString(['scheme', 'user', 'pass', 'host', 'port']); // We just need the prefix since we have a path relative to the root. if ($url[0] == '/') { $url = $prefix . $url; } else { // It's relative to where we are now, so lets add that. $parts = \explode('/', $uri->toString(['path'])); \array_pop($parts); $path = \implode('/', $parts) . '/'; $url = $prefix . $path . $url; } } if ($this->checkHeadersSent()) { // If the headers have already been sent we need to send the redirect statement via JavaScript. echo '<script>document.location.href=' . \json_encode($url) . ";</script>\n"; } elseif (($this->client->engine == WebClient::TRIDENT) && !static::isAscii($url)) { // We have to use a JavaScript redirect here because MSIE doesn't play nice with UTF-8 URLs. $html = '<html><head>'; $html .= '<meta http-equiv="content-type" content="text/html; charset=' . $this->charSet . '" />'; $html .= '<script>document.location.href=' . \json_encode($url) . ';</script>'; $html .= '</head><body></body></html>'; echo $html; } else { // Check if we have a boolean for the status variable for compatability with v1 of the framework // @deprecated 3.0 if (\is_bool($status)) { \trigger_deprecation( 'joomla/application', '2.0.0', 'Passing a boolean value for the $status argument in %s() is deprecated,' . ' an integer should be passed instead.', __METHOD__ ); $status = $status ? 301 : 303; } if (!\is_int($status) && !$this->isRedirectState($status)) { throw new \InvalidArgumentException('You have not supplied a valid HTTP status code'); } // All other cases use the more efficient HTTP header for redirection. $this->setHeader('Status', (string) $status, true); $this->setHeader('Location', $url, true); } $this->dispatchEvent(ApplicationEvents::BEFORE_RESPOND); // Set appropriate headers $this->respond(); $this->dispatchEvent(ApplicationEvents::AFTER_RESPOND); // Close the application after the redirect. $this->close(); } /** * Set/get cachable state for the response. * * If $allow is set, sets the cachable state of the response. Always returns the current state. * * @param boolean $allow True to allow browser caching. * * @return boolean * * @since 1.0.0 */ public function allowCache($allow = null) { if ($allow !== null) { $this->cacheable = (bool) $allow; } return $this->cacheable; } /** * Method to set a response header. * * If the replace flag is set then all headers with the given name will be replaced by the new one. * The headers are stored in an internal array to be sent when the site is sent to the browser. * * @param string $name The name of the header to set. * @param string $value The value of the header to set. * @param boolean $replace True to replace any headers with the same name. * * @return $this * * @since 1.0.0 */ public function setHeader($name, $value, $replace = false) { // Sanitize the input values. $name = (string) $name; $value = (string) $value; $response = $this->getResponse(); // If the replace flag is set, unset all known headers with the given name. if ($replace && $response->hasHeader($name)) { $response = $response->withoutHeader($name); } // Add the header to the internal array. $this->setResponse($response->withAddedHeader($name, $value)); return $this; } /** * Method to get the array of response headers to be sent when the response is sent to the client. * * @return array * * @since 1.0.0 */ public function getHeaders() { $return = []; foreach ($this->getResponse()->getHeaders() as $name => $values) { foreach ($values as $value) { $return[] = ['name' => $name, 'value' => $value]; } } return $return; } /** * Method to clear any set response headers. * * @return $this * * @since 1.0.0 */ public function clearHeaders() { $response = $this->getResponse(); foreach ($response->getHeaders() as $name => $values) { $response = $response->withoutHeader($name); } $this->setResponse($response); return $this; } /** * Send the response headers. * * @return $this * * @since 1.0.0 */ public function sendHeaders() { if (!$this->checkHeadersSent()) { foreach ($this->getHeaders() as $header) { if (\strtolower($header['name']) == 'status') { // 'status' headers indicate an HTTP status, and need to be handled slightly differently $status = $this->getHttpStatusValue($header['value']); $this->header($status, true, (int) $header['value']); } else { $this->header($header['name'] . ': ' . $header['value']); } } } return $this; } /** * Set body content. If body content already defined, this will replace it. * * @param string $content The content to set as the response body. * * @return $this * * @since 1.0.0 */ public function setBody($content) { $stream = new Stream('php://memory', 'rw'); $stream->write((string) $content); $this->setResponse($this->getResponse()->withBody($stream)); return $this; } /** * Prepend content to the body content * * @param string $content The content to prepend to the response body. * * @return $this * * @since 1.0.0 */ public function prependBody($content) { $currentBody = $this->getResponse()->getBody(); if (!$currentBody->isReadable()) { throw new UnableToWriteBody(); } $stream = new Stream('php://memory', 'rw'); $stream->write((string) $content . (string) $currentBody); $this->setResponse($this->getResponse()->withBody($stream)); return $this; } /** * Append content to the body content * * @param string $content The content to append to the response body. * * @return $this * * @since 1.0.0 */ public function appendBody($content) { $currentStream = $this->getResponse()->getBody(); if ($currentStream->isWritable()) { $currentStream->write((string) $content); $this->setResponse($this->getResponse()->withBody($currentStream)); } elseif ($currentStream->isReadable()) { $stream = new Stream('php://memory', 'rw'); $stream->write((string) $currentStream . (string) $content); $this->setResponse($this->getResponse()->withBody($stream)); } else { throw new UnableToWriteBody(); } return $this; } /** * Return the body content * * @return string The response body as a string. * * @since 1.0.0 */ public function getBody() { return (string) $this->getResponse()->getBody(); } /** * Get the PSR-7 Response Object. * * @return ResponseInterface * * @since 2.0.0 */ public function getResponse(): ResponseInterface { return $this->response; } /** * Check if a given value can be successfully mapped to a valid http status value * * @param string|int $value The given status as int or string * * @return string * * @since 1.8.0 */ protected function getHttpStatusValue($value) { $code = (int) $value; if (\array_key_exists($code, $this->responseMap)) { $value = $this->responseMap[$code]; } else { $value = 'HTTP/{version} ' . $code; } return \str_replace('{version}', $this->httpVersion, $value); } /** * Check if the value is a valid HTTP status code * * @param integer $code The potential status code * * @return boolean * * @since 1.8.1 */ public function isValidHttpStatus($code) { return \array_key_exists($code, $this->responseMap); } /** * Method to check the current client connection status to ensure that it is alive. We are * wrapping this to isolate the \connection_status() function from our code base for testing reasons. * * @return boolean True if the connection is valid and normal. * * @codeCoverageIgnore * @see \connection_status() * @since 1.0.0 */ protected function checkConnectionAlive() { return \connection_status() === CONNECTION_NORMAL; } /** * Method to check to see if headers have already been sent. * * @return boolean True if the headers have already been sent. * * @codeCoverageIgnore * @see \headers_sent() * @since 1.0.0 */ protected function checkHeadersSent() { return \headers_sent(); } /** * Method to detect the requested URI from server environment variables. * * @return string The requested URI * * @since 1.0.0 */ protected function detectRequestUri() { // First we need to detect the URI scheme. $scheme = $this->isSslConnection() ? 'https://' : 'http://'; /* * There are some differences in the way that Apache and IIS populate server environment variables. To * properly detect the requested URI we need to adjust our algorithm based on whether or not we are getting * information from Apache or IIS. */ $phpSelf = $this->input->server->getString('PHP_SELF', ''); $requestUri = $this->input->server->getString('REQUEST_URI', ''); $uri = $scheme . $this->input->server->getString('HTTP_HOST'); if (!empty($phpSelf) && !empty($requestUri)) { // If PHP_SELF and REQUEST_URI are both populated then we will assume "Apache Mode". // The URI is built from the HTTP_HOST and REQUEST_URI environment variables in an Apache environment. $uri .= $requestUri; } else { // If not in "Apache Mode" we will assume that we are in an IIS environment and proceed. // IIS uses the SCRIPT_NAME variable instead of a REQUEST_URI variable... thanks, MS $uri .= $this->input->server->getString('SCRIPT_NAME'); $queryHost = $this->input->server->getString('QUERY_STRING', ''); // If the QUERY_STRING variable exists append it to the URI string. if (!empty($queryHost)) { $uri .= '?' . $queryHost; } } // Extra cleanup to remove invalid chars in the URL to prevent injections through the Host header $uri = str_replace(array("'", '"', '<', '>'), array('%27', '%22', '%3C', '%3E'), $uri); return \trim($uri); } /** * Method to send a header to the client. * * @param string $string The header string. * @param boolean $replace The optional replace parameter indicates whether the header should replace a * previous similar header, or add a second header of the same type. * @param integer $code Forces the HTTP response code to the specified value. Note that this parameter only * has an effect if the string is not empty. * * @return void * * @codeCoverageIgnore * @see \header() * @since 1.0.0 */ protected function header($string, $replace = true, $code = null) { if ($code === null) { $code = 0; } \header(\str_replace(\chr(0), '', $string), $replace, $code); } /** * Set the PSR-7 Response Object. * * @param ResponseInterface $response The response object * * @return void * * @since 2.0.0 */ public function setResponse(ResponseInterface $response): void { $this->response = $response; } /** * Checks if a state is a redirect state * * @param integer $state The HTTP status code. * * @return boolean * * @since 1.8.0 */ protected function isRedirectState($state) { $state = (int) $state; return $state > 299 && $state < 400 && \array_key_exists($state, $this->responseMap); } /** * Determine if we are using a secure (SSL) connection. * * @return boolean True if using SSL, false if not. * * @since 1.0.0 */ public function isSslConnection() { $serverSSLVar = $this->input->server->getString('HTTPS', ''); if (!empty($serverSSLVar) && \strtolower($serverSSLVar) !== 'off') { return true; } $serverForwarderProtoVar = $this->input->server->getString('HTTP_X_FORWARDED_PROTO', ''); return !empty($serverForwarderProtoVar) && \strtolower($serverForwarderProtoVar) === 'https'; } /** * Method to load the system URI strings for the application. * * @param string $requestUri An optional request URI to use instead of detecting one from the server environment * variables. * * @return void * * @since 1.0.0 */ protected function loadSystemUris($requestUri = null) { // Set the request URI. if (!empty($requestUri)) { $this->set('uri.request', $requestUri); } else { $this->set('uri.request', $this->detectRequestUri()); } // Check to see if an explicit base URI has been set. $siteUri = \trim($this->get('site_uri', '')); if ($siteUri !== '') { $uri = new Uri($siteUri); $path = $uri->toString(['path']); } else { // No explicit base URI was set so we need to detect it. Start with the requested URI. $uri = new Uri($this->get('uri.request')); $requestUri = $this->input->server->getString('REQUEST_URI', ''); // If we are working from a CGI SAPI with the 'cgi.fix_pathinfo' directive disabled we use PHP_SELF. if (\strpos(PHP_SAPI, 'cgi') !== false && !\ini_get('cgi.fix_pathinfo') && !empty($requestUri)) { // We aren't expecting PATH_INFO within PHP_SELF so this should work. $path = \dirname($this->input->server->getString('PHP_SELF', '')); } else { // Pretty much everything else should be handled with SCRIPT_NAME. $path = \dirname($this->input->server->getString('SCRIPT_NAME', '')); } } // Get the host from the URI. $host = $uri->toString(['scheme', 'user', 'pass', 'host', 'port']); // Check if the path includes "index.php". if (\strpos($path, 'index.php') !== false) { // Remove the index.php portion of the path. $path = \substr_replace($path, '', \strpos($path, 'index.php'), 9); } $path = \rtrim($path, '/\\'); // Set the base URI both as just a path and as the full URI. $this->set('uri.base.full', $host . $path . '/'); $this->set('uri.base.host', $host); $this->set('uri.base.path', $path . '/'); // Set the extended (non-base) part of the request URI as the route. if (\stripos($this->get('uri.request'), $this->get('uri.base.full')) === 0) { $this->set( 'uri.route', \substr_replace($this->get('uri.request'), '', 0, \strlen($this->get('uri.base.full'))) ); } // Get an explicitly set media URI is present. $mediaURI = \trim($this->get('media_uri', '')); if ($mediaURI !== '') { if (\strpos($mediaURI, '://') !== false) { $this->set('uri.media.full', $mediaURI); } else { // Normalise slashes. $mediaURI = \trim($mediaURI, '/\\'); $mediaURI = !empty($mediaURI) ? '/' . $mediaURI . '/' : '/'; $this->set('uri.media.full', $this->get('uri.base.host') . $mediaURI); } $this->set('uri.media.path', $mediaURI); } else { // No explicit media URI was set, build it dynamically from the base uri. $this->set('uri.media.full', $this->get('uri.base.full') . 'media/'); $this->set('uri.media.path', $this->get('uri.base.path') . 'media/'); } } /** * Tests whether a string contains only 7bit ASCII bytes. * * You might use this to conditionally check whether a string * needs handling as UTF-8 or not, potentially offering performance * benefits by using the native PHP equivalent if it's just ASCII e.g.; * * @param string $str The string to test. * * @return boolean True if the string is all ASCII * * @since 1.4.0 */ public static function isAscii($str) { // Search for any bytes which are outside the ASCII range... return \preg_match('/[^\x00-\x7F]/', $str) !== 1; } } PK c�\ԧ�)f f ' application/src/AbstractApplication.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2013 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; use Joomla\Application\Event\ApplicationErrorEvent; use Joomla\Application\Event\ApplicationEvent; use Joomla\Event\DispatcherAwareInterface; use Joomla\Event\DispatcherAwareTrait; use Joomla\Event\EventInterface; use Joomla\Registry\Registry; use Psr\Log\LoggerAwareInterface; use Psr\Log\LoggerAwareTrait; use Psr\Log\LoggerInterface; use Psr\Log\NullLogger; /** * Joomla Framework Base Application Class * * @since 1.0.0 */ abstract class AbstractApplication implements ConfigurationAwareApplicationInterface, LoggerAwareInterface, DispatcherAwareInterface { use LoggerAwareTrait; use DispatcherAwareTrait; /** * The application configuration object. * * @var Registry * @since 1.0.0 */ protected $config; /** * Class constructor. * * @param Registry|null $config An optional argument to provide dependency injection for the * application's config object. If the argument is a Registry * object that object will become the application's config object, * otherwise a default config object is created. * * @since 1.0.0 */ public function __construct(Registry $config = null) { $this->config = $config ?: new Registry(); // Set the execution datetime and timestamp; $this->set('execution.datetime', \gmdate('Y-m-d H:i:s')); $this->set('execution.timestamp', \time()); $this->set('execution.microtimestamp', \microtime(true)); $this->initialise(); } /** * Method to close the application. * * @param integer $code The exit code (optional; default is 0). * * @return void * * @codeCoverageIgnore * @since 1.0.0 */ public function close($code = 0) { exit($code); } /** * Dispatches an application event if the dispatcher has been set. * * @param string $eventName The event to dispatch. * @param EventInterface|null $event The event object. * * @return EventInterface|null The dispatched event or null if no dispatcher is set * * @since 2.0.0 */ protected function dispatchEvent(string $eventName, ?EventInterface $event = null): ?EventInterface { try { $dispatcher = $this->getDispatcher(); } catch (\UnexpectedValueException $exception) { return null; } return $dispatcher->dispatch($eventName, $event ?: new ApplicationEvent($eventName, $this)); } /** * Method to run the application routines. * * Most likely you will want to instantiate a controller and execute it, or perform some sort of task directly. * * @return mixed * * @since 1.0.0 */ abstract protected function doExecute(); /** * Execute the application. * * @return void * * @since 1.0.0 */ public function execute() { try { $this->dispatchEvent(ApplicationEvents::BEFORE_EXECUTE); // Perform application routines. $this->doExecute(); $this->dispatchEvent(ApplicationEvents::AFTER_EXECUTE); } catch (\Throwable $throwable) { $this->dispatchEvent(ApplicationEvents::ERROR, new ApplicationErrorEvent($throwable, $this)); } } /** * Returns a property of the object or the default value if the property is not set. * * @param string $key The name of the property. * @param mixed $default The default value (optional) if none is set. * * @return mixed The value of the configuration. * * @since 1.0.0 */ public function get($key, $default = null) { return $this->config->get($key, $default); } /** * Get the logger. * * @return LoggerInterface * * @since 1.0.0 */ public function getLogger() { // If a logger hasn't been set, use NullLogger if (!($this->logger instanceof LoggerInterface)) { $this->setLogger(new NullLogger()); } return $this->logger; } /** * Custom initialisation method. * * Called at the end of the AbstractApplication::__construct method. * This is for developers to inject initialisation code for their application classes. * * @return void * * @codeCoverageIgnore * @since 1.0.0 */ protected function initialise() { } /** * Modifies a property of the object, creating it if it does not already exist. * * @param string $key The name of the property. * @param mixed $value The value of the property to set (optional). * * @return mixed Previous value of the property * * @since 1.0.0 */ public function set($key, $value = null) { $previous = $this->config->get($key); $this->config->set($key, $value); return $previous; } /** * Sets the configuration for the application. * * @param Registry $config A registry object holding the configuration. * * @return $this * * @since 1.0.0 */ public function setConfiguration(Registry $config) { $this->config = $config; return $this; } } PK c�\PL��� � 7 application/src/SessionAwareWebApplicationInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2019 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; use Joomla\Session\SessionInterface; /** * Application sub-interface defining a web application class which supports sessions * * @since 2.0.0 */ interface SessionAwareWebApplicationInterface extends WebApplicationInterface { /** * Method to get the application session object. * * @return SessionInterface The session object * * @since 2.0.0 */ public function getSession(); /** * Sets the session for the application to use, if required. * * @param SessionInterface $session A session object. * * @return $this * * @since 2.0.0 */ public function setSession(SessionInterface $session); /** * Checks for a form token in the request. * * @param string $method The request method in which to look for the token key. * * @return boolean * * @since 2.0.0 */ public function checkToken($method = 'post'); /** * Method to determine a hash for anti-spoofing variable names * * @param boolean $forceNew If true, force a new token to be created * * @return string Hashed var name * * @since 2.0.0 */ public function getFormToken($forceNew = false); } PK c�\�Ī % application/src/ApplicationEvents.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2017 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; /** * Class defining the events available in the application. * * @since 2.0.0 */ final class ApplicationEvents { /** * The ERROR event is an event triggered when a Throwable is uncaught. * * This event allows you to inspect the Throwable and implement additional error handling/reporting mechanisms. * * @var string * @since 2.0.0 */ public const ERROR = 'application.error'; /** * The BEFORE_EXECUTE event is an event triggered before the application is executed. * * @var string * @since 2.0.0 */ public const BEFORE_EXECUTE = 'application.before_execute'; /** * The AFTER_EXECUTE event is an event triggered after the application is executed. * * @var string * @since 2.0.0 */ public const AFTER_EXECUTE = 'application.after_execute'; /** * The BEFORE_RESPOND event is an event triggered before the application response is sent. * * @var string * @since 2.0.0 */ public const BEFORE_RESPOND = 'application.before_respond'; /** * The AFTER_RESPOND event is an event triggered after the application response is sent. * * @var string * @since 2.0.0 */ public const AFTER_RESPOND = 'application.after_respond'; } PK c�\��[W� � ( application/src/ApplicationInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Application Package * * @copyright (C) 2018 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Application; /** * Joomla Framework Application Interface * * @since 2.0.0 */ interface ApplicationInterface { /** * Method to close the application. * * @param integer $code The exit code (optional; default is 0). * * @return void * * @since 2.0.0 */ public function close($code = 0); /** * Execute the application. * * @return void * * @since 2.0.0 */ public function execute(); } PK c�\O��Y+ + application/rector.phpnu �[��� <?php declare(strict_types=1); use Rector\CodeQuality\Rector\Class_\InlineConstructorDefaultToPropertyRector; use Rector\Config\RectorConfig; use Rector\Php71\Rector\ClassConst\PublicConstantVisibilityRector; use Rector\Set\ValueObject\LevelSetList; return static function (RectorConfig $rectorConfig): void { $rectorConfig->paths([ __DIR__ . '/src', __DIR__ . '/Tests', ]); $rectorConfig->importNames(true); $rectorConfig->importShortClasses(false); $rectorConfig->rule(PublicConstantVisibilityRector::class); }; PK c�\��H http/src/AbstractTransport.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http; /** * Abstract transport class. * * @since 2.0.0 */ abstract class AbstractTransport implements TransportInterface { /** * The client options. * * @var array|\ArrayAccess * @since 2.0.0 */ protected $options; /** * Constructor. * * @param array|\ArrayAccess $options Client options array. * * @since 2.0.0 * @throws \RuntimeException */ public function __construct($options = []) { if (!static::isSupported()) { throw new \RuntimeException(sprintf('The %s transport is not supported in this environment.', \get_class($this))); } if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->options = $options; } /** * Get an option from the HTTP transport. * * @param string $key The name of the option to get. * @param mixed $default The default value if the option is not set. * * @return mixed The option value. * * @since 2.0.0 */ protected function getOption(string $key, $default = null) { return $this->options[$key] ?? $default; } /** * Processes the headers from a transport's response data. * * @param array $headers The headers to process. * * @return array * * @since 2.0.0 */ protected function processHeaders(array $headers): array { $verifiedHeaders = []; // Add the response headers to the response object. foreach ($headers as $header) { $pos = strpos($header, ':'); $keyName = trim(substr($header, 0, $pos)); if (!isset($verifiedHeaders[$keyName])) { $verifiedHeaders[$keyName] = []; } $verifiedHeaders[$keyName][] = trim(substr($header, ($pos + 1))); } return $verifiedHeaders; } } PK c�\h,ټB B http/src/TransportInterface.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http; use Joomla\Uri\UriInterface; /** * HTTP transport class interface. * * @since 1.0 */ interface TransportInterface { /** * Send a request to the server and return a Response object with the response. * * @param string $method The HTTP method for sending the request. * @param UriInterface $uri The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * @param string $userAgent The optional user agent string to send with the request. * * @return Response * * @since 1.0 */ public function request($method, UriInterface $uri, $data = null, array $headers = [], $timeout = null, $userAgent = null); /** * Method to check if HTTP transport layer available for using * * @return boolean True if available else false * * @since 1.0 */ public static function isSupported(); } PK c�\CR% % http/src/Transport/Curl.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http\Transport; use Composer\CaBundle\CaBundle; use Joomla\Http\AbstractTransport; use Joomla\Http\Exception\InvalidResponseCodeException; use Joomla\Http\Response; use Joomla\Uri\UriInterface; use Laminas\Diactoros\Stream as StreamResponse; /** * HTTP transport class for using cURL. * * @since 1.0 */ class Curl extends AbstractTransport { /** * Send a request to the server and return a Response object with the response. * * @param string $method The HTTP method for sending the request. * @param UriInterface $uri The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * @param string $userAgent The optional user agent string to send with the request. * * @return Response * * @since 1.0 * @throws \RuntimeException */ public function request($method, UriInterface $uri, $data = null, array $headers = [], $timeout = null, $userAgent = null) { // Setup the cURL handle. $ch = curl_init(); // Initialize the certificate store $this->setCAOptionAndValue($ch); $options = []; // Set the request method. switch (strtoupper($method)) { case 'GET': $options[\CURLOPT_HTTPGET] = true; break; case 'POST': $options[\CURLOPT_POST] = true; break; default: $options[\CURLOPT_CUSTOMREQUEST] = strtoupper($method); break; } // Don't wait for body when $method is HEAD $options[\CURLOPT_NOBODY] = ($method === 'HEAD'); // Initialize the certificate store $options[CURLOPT_CAINFO] = $this->getOption('curl.certpath', CaBundle::getSystemCaRootBundlePath()); // If data exists let's encode it and make sure our Content-type header is set. if (isset($data)) { // If the data is a scalar value simply add it to the cURL post fields. if (is_scalar($data) || (isset($headers['Content-Type']) && strpos($headers['Content-Type'], 'multipart/form-data') === 0)) { $options[\CURLOPT_POSTFIELDS] = $data; } else { // Otherwise we need to encode the value first. $options[\CURLOPT_POSTFIELDS] = http_build_query($data); } if (!isset($headers['Content-Type'])) { $headers['Content-Type'] = 'application/x-www-form-urlencoded; charset=utf-8'; } // Add the relevant headers. if (is_scalar($options[\CURLOPT_POSTFIELDS])) { $headers['Content-Length'] = \strlen($options[\CURLOPT_POSTFIELDS]); } } // Build the headers string for the request. $headerArray = []; if (!empty($headers)) { foreach ($headers as $key => $value) { if (\is_array($value)) { foreach ($value as $header) { $headerArray[] = "$key: $header"; } } else { $headerArray[] = "$key: $value"; } } // Add the headers string into the stream context options array. $options[\CURLOPT_HTTPHEADER] = $headerArray; } // Curl needs the accepted encoding header as option if (isset($headers['Accept-Encoding'])) { $options[\CURLOPT_ENCODING] = $headers['Accept-Encoding']; } // If an explicit timeout is given use it. if (isset($timeout)) { $options[\CURLOPT_TIMEOUT] = (int) $timeout; $options[\CURLOPT_CONNECTTIMEOUT] = (int) $timeout; } // If an explicit user agent is given use it. if (isset($userAgent)) { $options[\CURLOPT_USERAGENT] = $userAgent; } // Set the request URL. $options[\CURLOPT_URL] = (string) $uri; // We want our headers. :-) $options[\CURLOPT_HEADER] = true; // Return it... echoing it would be tacky. $options[\CURLOPT_RETURNTRANSFER] = true; // Override the Expect header to prevent cURL from confusing itself in its own stupidity. // Link: http://the-stickman.com/web-development/php-and-curl-disabling-100-continue-header/ $options[\CURLOPT_HTTPHEADER][] = 'Expect:'; // Follow redirects if server config allows if ($this->redirectsAllowed()) { $options[\CURLOPT_FOLLOWLOCATION] = (bool) $this->getOption('follow_location', true); } // Authentication, if needed if ($this->getOption('userauth') && $this->getOption('passwordauth')) { $options[\CURLOPT_USERPWD] = $this->getOption('userauth') . ':' . $this->getOption('passwordauth'); $options[\CURLOPT_HTTPAUTH] = CURLAUTH_BASIC; } // Configure protocol version if ($protocolVersion = $this->getOption('protocolVersion')) { $options[\CURLOPT_HTTP_VERSION] = $this->mapProtocolVersion($protocolVersion); } // Set any custom transport options foreach ($this->getOption('transport.curl', []) as $key => $value) { $options[$key] = $value; } // Set the cURL options. curl_setopt_array($ch, $options); // Execute the request and close the connection. $content = curl_exec($ch); // Check if the content is a string. If it is not, it must be an error. if (!\is_string($content)) { $message = curl_error($ch); if (empty($message)) { // Error but nothing from cURL? Create our own $message = 'No HTTP response received'; } throw new \RuntimeException($message); } // Get the request information. $info = curl_getinfo($ch); // Close the connection. curl_close($ch); return $this->getResponse($content, $info); } /** * Configure the cURL resources with the appropriate root certificates. * * @param resource $ch The cURL resource you want to configure the certificates on. * * @return void * * @since 1.3.2 */ protected function setCAOptionAndValue($ch) { if ($certpath = $this->getOption('curl.certpath')) { // Option is passed to a .PEM file. curl_setopt($ch, \CURLOPT_CAINFO, $certpath); return; } $caPathOrFile = CaBundle::getSystemCaRootBundlePath(); if (is_dir($caPathOrFile) || (is_link($caPathOrFile) && is_dir(readlink($caPathOrFile)))) { curl_setopt($ch, \CURLOPT_CAPATH, $caPathOrFile); return; } curl_setopt($ch, \CURLOPT_CAINFO, $caPathOrFile); } /** * Method to get a response object from a server response. * * @param string $content The complete server response, including headers * as a string if the response has no errors. * @param array $info The cURL request information. * * @return Response * * @since 1.0 * @throws InvalidResponseCodeException */ protected function getResponse($content, $info) { // Try to get header size if (isset($info['header_size'])) { $headerString = trim(substr($content, 0, $info['header_size'])); $headerArray = explode("\r\n\r\n", $headerString); // Get the last set of response headers as an array. $headers = explode("\r\n", array_pop($headerArray)); // Set the body for the response. $body = substr($content, $info['header_size']); } // Fallback and try to guess header count by redirect count else { // Get the number of redirects that occurred. $redirects = $info['redirect_count'] ?? 0; /* * Split the response into headers and body. If cURL encountered redirects, the headers for the redirected requests will * also be included. So we split the response into header + body + the number of redirects and only use the last two * sections which should be the last set of headers and the actual body. */ $response = explode("\r\n\r\n", $content, 2 + $redirects); // Set the body for the response. $body = array_pop($response); // Get the last set of response headers as an array. $headers = explode("\r\n", array_pop($response)); } // Get the response code from the first offset of the response headers. preg_match('/[0-9]{3}/', array_shift($headers), $matches); $code = \count($matches) ? $matches[0] : null; if (!is_numeric($code)) { // No valid response code was detected. throw new InvalidResponseCodeException('No HTTP response code found.'); } $statusCode = (int) $code; $verifiedHeaders = $this->processHeaders($headers); $streamInterface = new StreamResponse('php://memory', 'rw'); $streamInterface->write($body); return new Response($streamInterface, $statusCode, $verifiedHeaders); } /** * Method to check if HTTP transport cURL is available for use * * @return boolean True if available, else false * * @since 1.0 */ public static function isSupported() { return \function_exists('curl_version') && curl_version(); } /** * Get the cURL constant for a HTTP protocol version * * @param string $version The HTTP protocol version to use * * @return integer * * @since 1.3.1 */ private function mapProtocolVersion(string $version): int { switch ($version) { case '1.0': return \CURL_HTTP_VERSION_1_0; case '1.1': return \CURL_HTTP_VERSION_1_1; case '2.0': case '2': if (\defined('CURL_HTTP_VERSION_2')) { return \CURL_HTTP_VERSION_2; } } return \CURL_HTTP_VERSION_NONE; } /** * Check if redirects are allowed * * @return boolean * * @since 1.2.1 */ private function redirectsAllowed(): bool { return true; } } PK c�\�"K� � http/src/Transport/Socket.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http\Transport; use Joomla\Http\AbstractTransport; use Joomla\Http\Exception\InvalidResponseCodeException; use Joomla\Http\Response; use Joomla\Uri\Uri; use Joomla\Uri\UriInterface; use Laminas\Diactoros\Stream as StreamResponse; /** * HTTP transport class for using sockets directly. * * @since 1.0 */ class Socket extends AbstractTransport { /** * Reusable socket connections. * * @var array * @since 1.0 */ protected $connections; /** * Send a request to the server and return a Response object with the response. * * @param string $method The HTTP method for sending the request. * @param UriInterface $uri The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * @param string $userAgent The optional user agent string to send with the request. * * @return Response * * @since 1.0 * @throws \RuntimeException */ public function request($method, UriInterface $uri, $data = null, array $headers = [], $timeout = null, $userAgent = null) { $connection = $this->connect($uri, $timeout); // Make sure the connection is alive and valid. if (!\is_resource($connection)) { throw new \RuntimeException('Not connected to server.'); } // Make sure the connection has not timed out. $meta = stream_get_meta_data($connection); if ($meta['timed_out']) { throw new \RuntimeException('Server connection timed out.'); } // Get the request path from the URI object. $path = $uri->toString(['path', 'query']); // If we have data to send make sure our request is setup for it. if (!empty($data)) { // If the data is not a scalar value encode it to be sent with the request. if (!is_scalar($data)) { $data = http_build_query($data); } if (!isset($headers['Content-Type'])) { $headers['Content-Type'] = 'application/x-www-form-urlencoded; charset=utf-8'; } // Add the relevant headers. $headers['Content-Length'] = \strlen($data); } // Configure protocol version, use transport's default if not set otherwise. $protocolVersion = $this->getOption('protocolVersion', '1.0'); // Build the request payload. $request = []; $request[] = strtoupper($method) . ' ' . ((empty($path)) ? '/' : $path) . ' HTTP/' . $protocolVersion; if (!isset($headers['Host'])) { $request[] = 'Host: ' . $uri->getHost(); } // If an explicit user agent is given use it. if (isset($userAgent)) { $headers['User-Agent'] = $userAgent; } // If we have a username then we include basic authentication credentials. if ($uri->getUser()) { $authString = $uri->getUser() . ':' . $uri->getPass(); $headers['Authorization'] = 'Basic ' . base64_encode($authString); } // If there are custom headers to send add them to the request payload. if (!empty($headers)) { foreach ($headers as $key => $value) { if (\is_array($value)) { foreach ($value as $header) { $request[] = "$key: $header"; } } else { $request[] = "$key: $value"; } } } // Authentication, if needed if ($this->getOption('userauth') && $this->getOption('passwordauth')) { $request[] = 'Authorization: Basic ' . base64_encode($this->getOption('userauth') . ':' . $this->getOption('passwordauth')); } // Set any custom transport options foreach ($this->getOption('transport.socket', []) as $value) { $request[] = $value; } // If we have data to send add it to the request payload. if (!empty($data)) { $request[] = null; $request[] = $data; } // Send the request to the server. fwrite($connection, implode("\r\n", $request) . "\r\n\r\n"); // Get the response data from the server. $content = ''; while (!feof($connection)) { $content .= fgets($connection, 4096); } $content = $this->getResponse($content); // Follow Http redirects if ($content->getStatusCode() >= 301 && $content->getStatusCode() < 400 && $content->hasHeader('Location')) { return $this->request($method, new Uri($content->getHeaderLine('Location')), $data, $headers, $timeout, $userAgent); } return $content; } /** * Method to get a response object from a server response. * * @param string $content The complete server response, including headers. * * @return Response * * @since 1.0 * @throws \UnexpectedValueException * @throws InvalidResponseCodeException */ protected function getResponse($content) { if (empty($content)) { throw new \UnexpectedValueException('No content in response.'); } // Split the response into headers and body. $response = explode("\r\n\r\n", $content, 2); // Get the response headers as an array. $headers = explode("\r\n", $response[0]); // Set the body for the response. $body = empty($response[1]) ? '' : $response[1]; // Get the response code from the first offset of the response headers. preg_match('/[0-9]{3}/', array_shift($headers), $matches); $code = $matches[0]; if (!is_numeric($code)) { // No valid response code was detected. throw new InvalidResponseCodeException('No HTTP response code found.'); } $statusCode = (int) $code; $verifiedHeaders = $this->processHeaders($headers); $streamInterface = new StreamResponse('php://memory', 'rw'); $streamInterface->write($body); return new Response($streamInterface, $statusCode, $verifiedHeaders); } /** * Method to connect to a server and get the resource. * * @param UriInterface $uri The URI to connect with. * @param integer $timeout Read timeout in seconds. * * @return resource Socket connection resource. * * @since 1.0 * @throws \RuntimeException */ protected function connect(UriInterface $uri, $timeout = null) { $errno = null; $err = null; // Get the host from the uri. $host = ($uri->isSsl()) ? 'ssl://' . $uri->getHost() : $uri->getHost(); // If the port is not explicitly set in the URI detect it. if (!$uri->getPort()) { $port = ($uri->getScheme() == 'https') ? 443 : 80; } // Use the set port. else { $port = $uri->getPort(); } // Build the connection key for resource memory caching. $key = md5($host . $port); // If the connection already exists, use it. if (!empty($this->connections[$key]) && \is_resource($this->connections[$key])) { // Connection reached EOF, cannot be used anymore $meta = stream_get_meta_data($this->connections[$key]); if ($meta['eof']) { if (!fclose($this->connections[$key])) { throw new \RuntimeException('Cannot close connection'); } } // Make sure the connection has not timed out. elseif (!$meta['timed_out']) { return $this->connections[$key]; } } if (!is_numeric($timeout)) { $timeout = ini_get('default_socket_timeout'); } // Capture PHP errors error_clear_last(); // PHP sends a warning if the uri does not exists; we silence it and throw an exception instead. // Attempt to connect to the server $connection = @fsockopen($host, $port, $errno, $err, $timeout); if (!$connection) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => sprintf('Could not connect to resource %s: %s (%d)', $uri, $err, $errno) ); } throw new \RuntimeException($error['message']); } // Since the connection was successful let's store it in case we need to use it later. $this->connections[$key] = $connection; stream_set_timeout($this->connections[$key], (int) $timeout); return $this->connections[$key]; } /** * Method to check if http transport socket available for use * * @return boolean True if available else false * * @since 1.0 */ public static function isSupported() { return \function_exists('fsockopen') && \is_callable('fsockopen'); } } PK c�\tσ�K K http/src/Transport/Stream.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http\Transport; use Composer\CaBundle\CaBundle; use Joomla\Http\AbstractTransport; use Joomla\Http\Exception\InvalidResponseCodeException; use Joomla\Http\Response; use Joomla\Uri\Uri; use Joomla\Uri\UriInterface; use Laminas\Diactoros\Stream as StreamResponse; /** * HTTP transport class for using PHP streams. * * @since 1.0 */ class Stream extends AbstractTransport { /** * Send a request to the server and return a Response object with the response. * * @param string $method The HTTP method for sending the request. * @param UriInterface $uri The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * @param string $userAgent The optional user agent string to send with the request. * * @return Response * * @since 1.0 * @throws \RuntimeException */ public function request($method, UriInterface $uri, $data = null, array $headers = [], $timeout = null, $userAgent = null) { // Create the stream context options array with the required method offset. $options = ['method' => strtoupper($method)]; // If data exists let's encode it and make sure our Content-Type header is set. if (isset($data)) { // If the data is a scalar value simply add it to the stream context options. if (is_scalar($data)) { $options['content'] = $data; } else { // Otherwise we need to encode the value first. $options['content'] = http_build_query($data); } if (!isset($headers['Content-Type'])) { $headers['Content-Type'] = 'application/x-www-form-urlencoded; charset=utf-8'; } // Add the relevant headers. $headers['Content-Length'] = \strlen($options['content']); } // If an explicit timeout is given user it. if (isset($timeout)) { $options['timeout'] = (int) $timeout; } // If an explicit user agent is given use it. if (isset($userAgent)) { $options['user_agent'] = $userAgent; } // Ignore HTTP errors so that we can capture them. $options['ignore_errors'] = 1; // Follow redirects. $options['follow_location'] = (int) $this->getOption('follow_location', 1); // Configure protocol version, use transport's default if not set otherwise. $options['follow_location'] = $this->getOption('protocolVersion', '1.0'); // Add the proxy configuration if enabled if ($this->getOption('proxy.enabled', false)) { $options['request_fulluri'] = true; if ($this->getOption('proxy.host') && $this->getOption('proxy.port')) { $options['proxy'] = $this->getOption('proxy.host') . ':' . (int) $this->getOption('proxy.port'); } // If authentication details are provided, add those as well if ($this->getOption('proxy.user') && $this->getOption('proxy.password')) { $headers['Proxy-Authorization'] = 'Basic ' . base64_encode($this->getOption('proxy.user') . ':' . $this->getOption('proxy.password')); } } // Build the headers string for the request. if (!empty($headers)) { $headerString = ''; foreach ($headers as $key => $value) { if (\is_array($value)) { foreach ($value as $header) { $headerString .= "$key: $header\r\n"; } } else { $headerString .= "$key: $value\r\n"; } } // Add the headers string into the stream context options array. $options['header'] = trim($headerString, "\r\n"); } // Authentication, if needed if ($uri instanceof Uri && $this->getOption('userauth') && $this->getOption('passwordauth')) { $uri->setUser($this->getOption('userauth')); $uri->setPass($this->getOption('passwordauth')); } // Set any custom transport options foreach ($this->getOption('transport.stream', []) as $key => $value) { $options[$key] = $value; } // Get the current context options. $contextOptions = stream_context_get_options(stream_context_get_default()); // Add our options to the currently defined options, if any. $contextOptions['http'] = isset($contextOptions['http']) ? array_merge($contextOptions['http'], $options) : $options; // Create the stream context for the request. $streamOptions = [ 'http' => $options, 'ssl' => [ 'verify_peer' => true, 'verify_depth' => 5, 'verify_peer_name' => true, ], ]; // The cacert may be a file or path $certpath = $this->getOption('stream.certpath', CaBundle::getSystemCaRootBundlePath()); if (is_dir($certpath)) { $streamOptions['ssl']['capath'] = $certpath; } else { $streamOptions['ssl']['cafile'] = $certpath; } $context = stream_context_create($streamOptions); // Capture PHP errors error_clear_last(); // Open the stream for reading. $stream = @fopen((string) $uri, 'r', false, $context); if (!$stream) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => sprintf('Could not connect to resource %s', $uri) ); } throw new \RuntimeException($error['message']); } // Get the metadata for the stream, including response headers. $metadata = stream_get_meta_data($stream); // Get the contents from the stream. $content = stream_get_contents($stream); // Close the stream. fclose($stream); $headers = []; if (isset($metadata['wrapper_data']['headers'])) { $headers = $metadata['wrapper_data']['headers']; } elseif (isset($metadata['wrapper_data'])) { $headers = $metadata['wrapper_data']; } return $this->getResponse($headers, $content); } /** * Method to get a response object from a server response. * * @param array $headers The response headers as an array. * @param string $body The response body as a string. * * @return Response * * @since 1.0 * @throws InvalidResponseCodeException */ protected function getResponse(array $headers, $body) { // Get the response code from the first offset of the response headers. preg_match('/[0-9]{3}/', array_shift($headers), $matches); $code = $matches[0]; if (!is_numeric($code)) { // No valid response code was detected. throw new InvalidResponseCodeException('No HTTP response code found.'); } $statusCode = (int) $code; $verifiedHeaders = $this->processHeaders($headers); $streamInterface = new StreamResponse('php://memory', 'rw'); $streamInterface->write($body); return new Response($streamInterface, $statusCode, $verifiedHeaders); } /** * Method to check if http transport stream available for use * * @return boolean True if available else false * * @since 1.0 */ public static function isSupported() { return \function_exists('fopen') && \is_callable('fopen') && ini_get('allow_url_fopen'); } } PK c�\� w� � 2 http/src/Exception/UnexpectedResponseException.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http\Exception; use Joomla\Http\Response; use Psr\Http\Client\ClientExceptionInterface; /** * Exception representing an unexpected response * * @since 1.2.0 */ class UnexpectedResponseException extends \DomainException implements ClientExceptionInterface { /** * The Response object. * * @var Response * @since 1.2.0 */ private $response; /** * Constructor * * @param Response $response The Response object. * @param string $message The Exception message to throw. * @param integer $code The Exception code. * @param \Exception $previous The previous exception used for the exception chaining. * * @since 1.2.0 */ public function __construct(Response $response, $message = '', $code = 0, \Exception $previous = null) { parent::__construct($message, $code, $previous); $this->response = $response; } /** * Get the Response object. * * @return Response * * @since 1.2.0 */ public function getResponse() { return $this->response; } } PK c�\m�� 3 http/src/Exception/InvalidResponseCodeException.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http\Exception; use Psr\Http\Client\ClientExceptionInterface; /** * Exception representing an invalid or undefined HTTP response code * * @since 1.2.0 */ class InvalidResponseCodeException extends \UnexpectedValueException implements ClientExceptionInterface { } PK c�\O�gk k http/src/HttpFactory.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http; /** * HTTP factory class. * * @since 1.0 */ class HttpFactory { /** * Method to create an Http instance. * * @param array|\ArrayAccess $options Client options array. * @param array|string $adapters Adapter (string) or queue of adapters (array) to use for communication. * * @return Http * * @since 1.0 * @throws \InvalidArgumentException * @throws \RuntimeException */ public function getHttp($options = [], $adapters = null) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } if (!$driver = $this->getAvailableDriver($options, $adapters)) { throw new \RuntimeException('No transport driver available.'); } return new Http($options, $driver); } /** * Finds an available TransportInterface object for communication * * @param array|\ArrayAccess $options Options for creating TransportInterface object * @param array|string $default Adapter (string) or queue of adapters (array) to use * * @return TransportInterface|boolean Interface sub-class or boolean false if no adapters are available * * @since 1.0 * @throws \InvalidArgumentException */ public function getAvailableDriver($options = [], $default = null) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } if ($default === null) { $availableAdapters = $this->getHttpTransports(); } else { settype($default, 'array'); $availableAdapters = $default; } // Check if there is at least one available http transport adapter if (!\count($availableAdapters)) { return false; } foreach ($availableAdapters as $adapter) { $class = __NAMESPACE__ . '\\Transport\\' . ucfirst($adapter); if (class_exists($class)) { if ($class::isSupported()) { return new $class($options); } } } return false; } /** * Get the HTTP transport handlers * * @return string[] An array of available transport handler types * * @since 1.0 */ public function getHttpTransports() { $names = []; $iterator = new \DirectoryIterator(__DIR__ . '/Transport'); /** @var \DirectoryIterator $file */ foreach ($iterator as $file) { $fileName = $file->getFilename(); // Only load for php files. if ($file->isFile() && $file->getExtension() == 'php') { $names[] = substr($fileName, 0, strrpos($fileName, '.')); } } // Keep alphabetical order across all environments sort($names); // If curl is available set it to the first position $key = array_search('Curl', $names); if ($key) { unset($names[$key]); array_unshift($names, 'Curl'); } return $names; } } PK c�\�88�*$ *$ http/src/Http.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http; use Joomla\Uri\Uri; use Joomla\Uri\UriInterface; use Psr\Http\Client\ClientInterface; use Psr\Http\Message\RequestInterface; use Psr\Http\Message\ResponseInterface; /** * HTTP client class. * * @since 1.0 */ class Http implements ClientInterface { /** * Options for the HTTP client. * * @var array|\ArrayAccess * @since 1.0 */ protected $options; /** * The HTTP transport object to use in sending HTTP requests. * * @var TransportInterface * @since 1.0 */ protected $transport; /** * Constructor. * * @param array|\ArrayAccess $options Client options array. If the registry contains any headers.* elements, * these will be added to the request headers. * @param TransportInterface $transport The HTTP transport object. * * @since 1.0 * @throws \InvalidArgumentException */ public function __construct($options = [], TransportInterface $transport = null) { if (!\is_array($options) && !($options instanceof \ArrayAccess)) { throw new \InvalidArgumentException( 'The options param must be an array or implement the ArrayAccess interface.' ); } $this->options = $options; if (!$transport) { $transport = (new HttpFactory)->getAvailableDriver($this->options); // Ensure the transport is a TransportInterface instance or bail out if (!($transport instanceof TransportInterface)) { throw new \InvalidArgumentException(sprintf('A valid %s object was not set.', TransportInterface::class)); } } $this->transport = $transport; } /** * Get an option from the HTTP client. * * @param string $key The name of the option to get. * @param mixed $default The default value if the option is not set. * * @return mixed The option value. * * @since 1.0 */ public function getOption($key, $default = null) { return $this->options[$key] ?? $default; } /** * Set an option for the HTTP client. * * @param string $key The name of the option to set. * @param mixed $value The option value to set. * * @return $this * * @since 1.0 */ public function setOption($key, $value) { $this->options[$key] = $value; return $this; } /** * Method to send the OPTIONS command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 */ public function options($url, array $headers = [], $timeout = null) { return $this->makeTransportRequest('OPTIONS', $url, null, $headers, $timeout); } /** * Method to send the HEAD command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 */ public function head($url, array $headers = [], $timeout = null) { return $this->makeTransportRequest('HEAD', $url, null, $headers, $timeout); } /** * Method to send the GET command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 */ public function get($url, array $headers = [], $timeout = null) { return $this->makeTransportRequest('GET', $url, null, $headers, $timeout); } /** * Method to send the POST command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 */ public function post($url, $data, array $headers = [], $timeout = null) { return $this->makeTransportRequest('POST', $url, $data, $headers, $timeout); } /** * Method to send the PUT command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 */ public function put($url, $data, array $headers = [], $timeout = null) { return $this->makeTransportRequest('PUT', $url, $data, $headers, $timeout); } /** * Method to send the DELETE command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * @param mixed $data Either an associative array or a string to be sent with the request. * * @return Response * * @since 1.0 */ public function delete($url, array $headers = [], $timeout = null, $data = null) { return $this->makeTransportRequest('DELETE', $url, $data, $headers, $timeout); } /** * Method to send the TRACE command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 */ public function trace($url, array $headers = [], $timeout = null) { return $this->makeTransportRequest('TRACE', $url, null, $headers, $timeout); } /** * Method to send the PATCH command to the server. * * @param string|UriInterface $url The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 */ public function patch($url, $data, array $headers = [], $timeout = null) { return $this->makeTransportRequest('PATCH', $url, $data, $headers, $timeout); } /** * Sends a PSR-7 request and returns a PSR-7 response. * * @param RequestInterface $request The PSR-7 request object. * * @return ResponseInterface|Response * * @since 2.0.0 */ public function sendRequest(RequestInterface $request): ResponseInterface { $data = $request->getBody()->getContents(); return $this->makeTransportRequest( $request->getMethod(), new Uri((string) $request->getUri()), empty($data) ? null : $data, $request->getHeaders() ); } /** * Send a request to the server and return a Response object with the response. * * @param string $method The HTTP method for sending the request. * @param string|UriInterface $url The URI to the resource to request. * @param mixed $data Either an associative array or a string to be sent with the request. * @param array $headers An array of request headers to send with the request. * @param integer $timeout Read timeout in seconds. * * @return Response * * @since 1.0 * @throws \InvalidArgumentException */ protected function makeTransportRequest($method, $url, $data = null, array $headers = [], $timeout = null) { // Look for headers set in the options. if (isset($this->options['headers'])) { $temp = (array) $this->options['headers']; foreach ($temp as $key => $val) { if (!isset($headers[$key])) { $headers[$key] = $val; } } } // Look for timeout set in the options. if ($timeout === null && isset($this->options['timeout'])) { $timeout = $this->options['timeout']; } $userAgent = isset($this->options['userAgent']) ? $this->options['userAgent'] : null; // Convert to a Uri object if we were given a string if (\is_string($url)) { $url = new Uri($url); } elseif (!($url instanceof UriInterface)) { throw new \InvalidArgumentException( sprintf( 'A string or %s object must be provided, a "%s" was provided.', UriInterface::class, \gettype($url) ) ); } return $this->transport->request($method, $url, $data, $headers, $timeout, $userAgent); } } PK c�\��. . http/src/Response.phpnu �[��� <?php /** * Part of the Joomla Framework Http Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Http; use Laminas\Diactoros\Response as PsrResponse; /** * HTTP response data object class. * * @property-read string $body The response body as a string * @property-read integer $code The status code of the response * @property-read array $headers The headers as an array * * @since 1.0 */ class Response extends PsrResponse { /** * Magic getter for backward compatibility with the 1.x API * * @param string $name The variable to return * * @return mixed * * @since 2.0.0 * @deprecated 3.0 Access data via the PSR-7 ResponseInterface instead */ public function __get($name) { switch (strtolower($name)) { case 'body': return (string) $this->getBody(); case 'code': return $this->getStatusCode(); case 'headers': return $this->getHeaders(); default: $trace = debug_backtrace(); trigger_error( sprintf( 'Undefined property via __get(): %s in %s on line %s', $name, $trace[0]['file'], $trace[0]['line'] ), E_USER_NOTICE ); break; } } } PK c�\�:;� � http/.drone.jsonnetnu �[��� local volumes = [ { name: "composer-cache", path: "/tmp/composer-cache", }, ]; local hostvolumes = [ { name: "composer-cache", host: {path: "/tmp/composer-cache"} }, ]; local composer(phpversion, params) = { name: "composer", image: "joomlaprojects/docker-images:php" + phpversion, volumes: volumes, commands: [ "php -v", "composer update " + params, ] }; local phpunit(phpversion) = { name: "PHPUnit", image: "joomlaprojects/docker-images:php" + phpversion, [if phpversion == "8.2" then "failure"]: "ignore", commands: [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], }; local pipeline(name, phpversion, params) = { kind: "pipeline", name: "PHP " + name, volumes: hostvolumes, steps: [ composer(phpversion, params), phpunit(phpversion) ], }; [ { kind: "pipeline", name: "Codequality", volumes: hostvolumes, steps: [ { name: "composer", image: "joomlaprojects/docker-images:php7.4", volumes: volumes, commands: [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ] }, { name: "phpcs", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], commands: [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ] }, { name: "phpmd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode", ] }, { name: "phpstan", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "vendor/bin/phpstan analyse src", ] }, { name: "phploc", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phploc src", ] }, { name: "phpcpd", image: "joomlaprojects/docker-images:php7.4", depends: [ "composer" ], failure: "ignore", commands: [ "phpcpd src", ] } ] }, pipeline("7.2 lowest", "7.2", "--prefer-stable --prefer-lowest"), pipeline("7.2", "7.2", "--prefer-stable"), pipeline("7.3", "7.3", "--prefer-stable"), pipeline("7.4", "7.4", "--prefer-stable"), pipeline("8.0", "8.0", "--prefer-stable"), pipeline("8.1", "8.1", "--prefer-stable"), pipeline("8.2", "8.2", "--prefer-stable --ignore-platform-reqs"), ] PK c�\�P�E �E http/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\<$ �� � http/.drone.ymlnu �[��� --- { "kind": "pipeline", "name": "Codequality", "steps": [ { "commands": [ "php -v", "composer update", "composer require phpmd/phpmd phpstan/phpstan" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "vendor/bin/phpcs --config-set installed_paths vendor/joomla/coding-standards", "vendor/bin/phpcs --standard=ruleset.xml src/" ], "depends": [ "composer" ], "image": "joomlaprojects/docker-images:php7.4", "name": "phpcs" }, { "commands": [ "vendor/bin/phpmd src text cleancode", "vendor/bin/phpmd src text codesize", "vendor/bin/phpmd src text controversial", "vendor/bin/phpmd src text design", "vendor/bin/phpmd src text unusedcode" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpmd" }, { "commands": [ "vendor/bin/phpstan analyse src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpstan" }, { "commands": [ "phploc src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phploc" }, { "commands": [ "phpcpd src" ], "depends": [ "composer" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php7.4", "name": "phpcpd" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2 lowest", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --prefer-lowest" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.3", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.3", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.3", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 7.4", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php7.4", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php7.4", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.0", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.0", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.0", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.1", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable" ], "image": "joomlaprojects/docker-images:php8.1", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], "image": "joomlaprojects/docker-images:php8.1", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- { "kind": "pipeline", "name": "PHP 8.2", "steps": [ { "commands": [ "php -v", "composer update --prefer-stable --ignore-platform-reqs" ], "image": "joomlaprojects/docker-images:php8.2", "name": "composer", "volumes": [ { "name": "composer-cache", "path": "/tmp/composer-cache" } ] }, { "commands": [ "php -S localhost:8080 -t Tests/stubs &", "vendor/bin/phpunit" ], "failure": "ignore", "image": "joomlaprojects/docker-images:php8.2", "name": "PHPUnit" } ], "volumes": [ { "host": { "path": "/tmp/composer-cache" }, "name": "composer-cache" } ] } --- kind: signature hmac: b92b6c78b0d5519f12fe1a478291ebac147143d1d84bbc1f01730ee911c248bb ... PK c�\,q�* * input/src/Json.phpnu �[��� <?php /** * Part of the Joomla Framework Input Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Input; /** * Joomla! Input JSON Class * * This class decodes a JSON string from the raw request data and makes it available via the standard Input interface. * * @since 1.0 */ class Json extends Input { /** * The raw JSON string from the request. * * @var string * @since 1.0 */ private $raw; /** * Constructor. * * @param array|null $source Source data (Optional, default is the raw HTTP input decoded from JSON) * @param array $options Array of configuration parameters (Optional) * * @since 1.0 */ public function __construct($source = null, array $options = []) { if ($source === null) { $this->raw = file_get_contents('php://input'); // This is a workaround for where php://input has already been read. // See note under php://input on https://www.php.net/manual/en/wrappers.php.php if (empty($this->raw) && isset($GLOBALS['HTTP_RAW_POST_DATA'])) { $this->raw = $GLOBALS['HTTP_RAW_POST_DATA']; } $source = json_decode($this->raw, true); if (!\is_array($source)) { $source = []; } } parent::__construct($source, $options); } /** * Gets the raw JSON string from the request. * * @return string The raw JSON string from the request. * * @since 1.0 */ public function getRaw() { return $this->raw; } } PK c�\O|"�� � input/src/Input.phpnu �[��� <?php /** * Part of the Joomla Framework Input Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Input; use Joomla\Filter; /** * Joomla! Input Base Class * * This is an abstracted input class used to manage retrieving data from the application environment. * * @since 1.0 * * @property-read Input $get * @property-read Input $post * @property-read Input $request * @property-read Input $server * @property-read Input $env * @property-read Files $files * @property-read Cookie $cookie * * @method integer getInt($name, $default = null) Get a signed integer. * @method integer getUint($name, $default = null) Get an unsigned integer. * @method float getFloat($name, $default = null) Get a floating-point number. * @method boolean getBool($name, $default = null) Get a boolean value. * @method string getWord($name, $default = null) Get a word. * @method string getAlnum($name, $default = null) Get an alphanumeric string. * @method string getCmd($name, $default = null) Get a CMD filtered string. * @method string getBase64($name, $default = null) Get a base64 encoded string. * @method string getString($name, $default = null) Get a string. * @method string getHtml($name, $default = null) Get a HTML string. * @method string getPath($name, $default = null) Get a file path. * @method string getUsername($name, $default = null) Get a username. * @method mixed getRaw($name, $default = null) Get an unfiltered value. */ class Input implements \Countable { /** * Container with allowed superglobals * * @var array * @since 1.3.0 */ private const ALLOWED_GLOBALS = ['REQUEST', 'GET', 'POST', 'FILES', 'SERVER', 'ENV']; /** * Options array for the Input instance. * * @var array * @since 1.0 */ protected $options = []; /** * Filter object to use. * * @var Filter\InputFilter * @since 1.0 */ protected $filter; /** * Input data. * * @var array * @since 1.0 */ protected $data = []; /** * Input objects * * @var Input[] * @since 1.0 */ protected $inputs = []; /** * Constructor. * * @param array|null $source Optional source data. If omitted, a copy of the server variable '_REQUEST' is used. * @param array $options An optional associative array of configuration parameters: * filter: An instance of Filter\Input. If omitted, a default filter is initialised. * * @since 1.0 */ public function __construct($source = null, array $options = []) { $this->data = $source ?? $_REQUEST; $this->filter = $options['filter'] ?? new Filter\InputFilter; $this->options = $options; } /** * Magic method to get an input object * * @param mixed $name Name of the input object to retrieve. * * @return Input The request input object * * @since 1.0 */ public function __get($name) { if (isset($this->inputs[$name])) { return $this->inputs[$name]; } $className = __NAMESPACE__ . '\\' . ucfirst($name); if (class_exists($className)) { $this->inputs[$name] = new $className(null, $this->options); return $this->inputs[$name]; } $superGlobal = '_' . strtoupper($name); if (\in_array(strtoupper($name), self::ALLOWED_GLOBALS, true) && isset($GLOBALS[$superGlobal])) { $this->inputs[$name] = new self($GLOBALS[$superGlobal], $this->options); return $this->inputs[$name]; } $trace = debug_backtrace(); trigger_error( 'Undefined property via __get(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_NOTICE ); } /** * Get the number of variables. * * @return integer The number of variables in the input. * * @since 1.0 * @see Countable::count() */ #[\ReturnTypeWillChange] public function count() { return \count($this->data); } /** * Gets a value from the input data. * * @param string $name Name of the value to get. * @param mixed $default Default value to return if variable does not exist. * @param string $filter Filter to apply to the value. * * @return mixed The filtered input value. * * @see \Joomla\Filter\InputFilter::clean() * @since 1.0 */ public function get($name, $default = null, $filter = 'cmd') { if ($this->exists($name)) { return $this->filter->clean($this->data[$name], $filter); } return $default; } /** * Gets an array of values from the request. * * @param array $vars Associative array of keys and filter types to apply. * If empty and datasource is null, all the input data will be returned * but filtered using the default case in InputFilter::clean. * @param mixed $datasource Array to retrieve data from, or null * * @return mixed The filtered input data. * * @since 1.0 */ public function getArray(array $vars = [], $datasource = null) { if (empty($vars) && $datasource === null) { $vars = $this->data; } $results = []; foreach ($vars as $k => $v) { if (\is_array($v)) { if ($datasource === null) { $results[$k] = $this->getArray($v, $this->get($k, null, 'array')); } else { $results[$k] = $this->getArray($v, $datasource[$k]); } } else { if ($datasource === null) { $results[$k] = $this->get($k, null, $v); } elseif (isset($datasource[$k])) { $results[$k] = $this->filter->clean($datasource[$k], $v); } else { $results[$k] = $this->filter->clean(null, $v); } } } return $results; } /** * Get the Input instance holding the data for the current request method * * @return Input * * @since 1.3.0 */ public function getInputForRequestMethod() { switch (strtoupper($this->getMethod())) { case 'GET': return $this->get; case 'POST': return $this->post; default: // PUT, PATCH, etc. don't have superglobals return $this; } } /** * Sets a value * * @param string $name Name of the value to set. * @param mixed $value Value to assign to the input. * * @return void * * @since 1.0 */ public function set($name, $value) { $this->data[$name] = $value; } /** * Define a value. The value will only be set if there's no value for the name or if it is null. * * @param string $name Name of the value to define. * @param mixed $value Value to assign to the input. * * @return void * * @since 1.0 */ public function def($name, $value) { if (isset($this->data[$name])) { return; } $this->data[$name] = $value; } /** * Check if a value name exists. * * @param string $name Value name * * @return boolean * * @since 1.2.0 */ public function exists($name) { return isset($this->data[$name]); } /** * Magic method to get filtered input data. * * @param string $name Name of the filter type prefixed with 'get'. * @param array $arguments [0] The name of the variable [1] The default value. * * @return mixed The filtered input value. * * @since 1.0 */ public function __call($name, $arguments) { if (substr($name, 0, 3) == 'get') { $filter = substr($name, 3); $default = null; if (isset($arguments[1])) { $default = $arguments[1]; } return $this->get($arguments[0], $default, $filter); } $trace = debug_backtrace(); trigger_error( 'Call to undefined method via call(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'], E_USER_ERROR ); } /** * Gets the request method. * * @return string The request method. * * @since 1.0 */ public function getMethod() { return strtoupper($this->server->getCmd('REQUEST_METHOD')); } } PK c�\P�=� � input/src/Files.phpnu �[��� <?php /** * Part of the Joomla Framework Input Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Input; /** * Joomla! Input Files Class * * @since 1.0 */ class Files extends Input { /** * The pivoted data from a $_FILES or compatible array. * * @var array * @since 1.0 */ protected $decodedData = []; /** * The class constructor. * * @param array|null $source Source data (Optional, default is $_FILES) * @param array $options Array of configuration parameters (Optional) * * @since 1.0 */ public function __construct($source = null, array $options = []) { $source = $source ?? $_FILES; parent::__construct($source, $options); } /** * Gets a value from the input data. * * @param string $name The name of the input property (usually the name of the files INPUT tag) to get. * @param mixed $default The default value to return if the named property does not exist. * @param string $filter The filter to apply to the value. * * @return mixed The filtered input value. * * @see \Joomla\Filter\InputFilter::clean() * @since 1.0 */ public function get($name, $default = null, $filter = 'cmd') { if (isset($this->data[$name])) { $results = $this->decodeData( [ $this->data[$name]['name'], $this->data[$name]['type'], $this->data[$name]['tmp_name'], $this->data[$name]['error'], $this->data[$name]['size'], ] ); return $results; } return $default; } /** * Method to decode a data array. * * @param array $data The data array to decode. * * @return array * * @since 1.0 */ protected function decodeData(array $data) { $result = []; if (\is_array($data[0])) { foreach ($data[0] as $k => $v) { $result[$k] = $this->decodeData([$data[0][$k], $data[1][$k], $data[2][$k], $data[3][$k], $data[4][$k]]); } return $result; } return ['name' => $data[0], 'type' => $data[1], 'tmp_name' => $data[2], 'error' => $data[3], 'size' => $data[4]]; } /** * Sets a value. * * @param string $name The name of the input property to set. * @param mixed $value The value to assign to the input property. * * @return void * * @since 1.0 */ public function set($name, $value) { // Restricts the usage of parent's set method. } } PK c�\34��� � input/src/Cookie.phpnu �[��� <?php /** * Part of the Joomla Framework Input Package * * @copyright Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Input; /** * Joomla! Input Cookie Class * * @since 1.0 */ class Cookie extends Input { /** * Constructor. * * @param array|null $source Source data (Optional, default is $_COOKIE) * @param array $options Array of configuration parameters (Optional) * * @since 1.0 */ public function __construct($source = null, array $options = []) { $source = $source ?? $_COOKIE; parent::__construct($source, $options); } /** * Sets a value * * @param string $name Name of the value to set. * @param mixed $value Value to assign to the input. * @param array $options An associative array which may have any of the keys expires, path, domain, * secure, httponly and samesite. The values have the same meaning as described * for the parameters with the same name. The value of the samesite element * should be either Lax or Strict. If any of the allowed options are not given, * their default values are the same as the default values of the explicit * parameters. If the samesite element is omitted, no SameSite cookie attribute * is set. * * @return void * * @link https://www.ietf.org/rfc/rfc2109.txt * @link https://php.net/manual/en/function.setcookie.php * * @since 1.0 * * @note As of 1.4.0, the (name, value, expire, path, domain, secure, httpOnly) signature is deprecated and will not be supported * when support for PHP 7.2 and earlier is dropped */ public function set($name, $value, $options = []) { // BC layer to convert old method parameters. if (is_array($options) === false) { trigger_deprecation( 'joomla/input', '1.4.0', 'The %s($name, $value, $expire, $path, $domain, $secure, $httpOnly) signature is deprecated and will not be supported once support' . ' for PHP 7.2 and earlier is dropped, use the %s($name, $value, $options) signature instead', __METHOD__, __METHOD__ ); $argList = func_get_args(); $options = [ 'expires' => $argList[2] ?? 0, 'path' => $argList[3] ?? '', 'domain' => $argList[4] ?? '', 'secure' => $argList[5] ?? false, 'httponly' => $argList[6] ?? false, ]; } // Set the cookie if (version_compare(PHP_VERSION, '7.3', '>=')) { setcookie($name, $value, $options); } else { // Using the setcookie function before php 7.3, make sure we have default values. if (array_key_exists('expires', $options) === false) { $options['expires'] = 0; } if (array_key_exists('path', $options) === false) { $options['path'] = ''; } if (array_key_exists('domain', $options) === false) { $options['domain'] = ''; } if (array_key_exists('secure', $options) === false) { $options['secure'] = false; } if (array_key_exists('httponly', $options) === false) { $options['httponly'] = false; } setcookie($name, $value, $options['expires'], $options['path'], $options['domain'], $options['secure'], $options['httponly']); } $this->data[$name] = $value; } } PK c�\�P�E �E input/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK c�\��� � filesystem/src/File.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem; use Joomla\Filesystem\Exception\FilesystemException; /** * A File handling class * * @since 1.0 */ class File { /** * Strips the last extension off of a file name * * @param string $file The file name * * @return string The file name without the extension * * @since 1.0 */ public static function stripExt($file) { return preg_replace('#\.[^.]*$#', '', $file); } /** * Makes the file name safe to use * * @param string $file The name of the file [not full path] * @param array $stripChars Array of regex (by default will remove any leading periods) * * @return string The sanitised string * * @since 1.0 */ public static function makeSafe($file, array $stripChars = ['#^\.#']) { $regex = array_merge(['#(\.){2,}#', '#[^A-Za-z0-9\.\_\- ]#'], $stripChars); $file = preg_replace($regex, '', $file); // Remove any trailing dots, as those aren't ever valid file names. $file = rtrim($file, '.'); return $file; } /** * Copies a file * * @param string $src The path to the source file * @param string $dest The path to the destination file * @param string $path An optional base path to prefix to the file names * @param boolean $useStreams True to use streams * * @return boolean True on success * * @since 1.0 * @throws FilesystemException * @throws \UnexpectedValueException */ public static function copy($src, $dest, $path = null, $useStreams = false) { // Prepend a base path if it exists if ($path) { $src = Path::clean($path . '/' . $src); $dest = Path::clean($path . '/' . $dest); } // Check src path if (!is_readable($src)) { throw new \UnexpectedValueException( sprintf( "%s: Cannot find or read file: %s", __METHOD__, Path::removeRoot($src) ) ); } if ($useStreams) { $stream = Stream::getStream(); if (!$stream->copy($src, $dest, null, false)) { throw new FilesystemException(sprintf('%1$s(%2$s, %3$s): %4$s', __METHOD__, $src, $dest, $stream->getError())); } self::invalidateFileCache($dest); return true; } if (!@ copy($src, $dest)) { throw new FilesystemException(__METHOD__ . ': Copy failed.'); } self::invalidateFileCache($dest); return true; } /** * Delete a file or array of files * * @param mixed $file The file name or an array of file names * * @return boolean True on success * * @since 1.0 * @throws FilesystemException */ public static function delete($file) { $files = (array) $file; foreach ($files as $file) { $file = Path::clean($file); $filename = basename($file); if (!Path::canChmod($file)) { throw new FilesystemException(__METHOD__ . ': Failed deleting inaccessible file ' . $filename); } // Try making the file writable first. If it's read-only, it can't be deleted // on Windows, even if the parent folder is writable @chmod($file, 0777); // In case of restricted permissions we zap it one way or the other // as long as the owner is either the webserver or the ftp if (!@ unlink($file)) { throw new FilesystemException(__METHOD__ . ': Failed deleting ' . $filename); } self::invalidateFileCache($file); } return true; } /** * Moves a file * * @param string $src The path to the source file * @param string $dest The path to the destination file * @param string $path An optional base path to prefix to the file names * @param boolean $useStreams True to use streams * * @return boolean True on success * * @since 1.0 * @throws FilesystemException */ public static function move($src, $dest, $path = '', $useStreams = false) { if ($path) { $src = Path::clean($path . '/' . $src); $dest = Path::clean($path . '/' . $dest); } // Check src path if (!is_readable($src)) { return 'Cannot find source file.'; } if ($useStreams) { $stream = Stream::getStream(); if (!$stream->move($src, $dest, null, false)) { throw new FilesystemException(__METHOD__ . ': ' . $stream->getError()); } self::invalidateFileCache($dest); return true; } if (!@ rename($src, $dest)) { throw new FilesystemException(__METHOD__ . ': Rename failed.'); } self::invalidateFileCache($dest); return true; } /** * Write contents to a file * * @param string $file The full file path * @param string $buffer The buffer to write * @param boolean $useStreams Use streams * @param boolean $appendToFile Append to the file and not overwrite it. * * @return boolean True on success * * @since 1.0 */ public static function write($file, &$buffer, $useStreams = false, $appendToFile = false) { @set_time_limit(ini_get('max_execution_time')); // If the destination directory doesn't exist we need to create it if (!file_exists(\dirname($file))) { Folder::create(\dirname($file)); } if ($useStreams) { $stream = Stream::getStream(); // Beef up the chunk size to a meg $stream->set('chunksize', (1024 * 1024)); $stream->writeFile($file, $buffer, $appendToFile); self::invalidateFileCache($file); return true; } $file = Path::clean($file); // Set the required flag to only append to the file and not overwrite it if ($appendToFile === true) { $res = \is_int(file_put_contents($file, $buffer, \FILE_APPEND)); } else { $res = \is_int(file_put_contents($file, $buffer)); } self::invalidateFileCache($file); return $res; } /** * Moves an uploaded file to a destination folder * * @param string $src The name of the php (temporary) uploaded file * @param string $dest The path (including filename) to move the uploaded file to * @param boolean $useStreams True to use streams * * @return boolean True on success * * @since 1.0 * @throws FilesystemException */ public static function upload($src, $dest, $useStreams = false) { // Ensure that the path is valid and clean $dest = Path::clean($dest); // Create the destination directory if it does not exist $baseDir = \dirname($dest); if (!is_dir($baseDir)) { Folder::create($baseDir); } if ($useStreams) { $stream = Stream::getStream(); if (!$stream->upload($src, $dest, null, false)) { throw new FilesystemException(sprintf('%1$s(%2$s, %3$s): %4$s', __METHOD__, $src, $dest, $stream->getError())); } self::invalidateFileCache($dest); return true; } if (is_writable($baseDir) && move_uploaded_file($src, $dest)) { // Short circuit to prevent file permission errors if (Path::setPermissions($dest)) { self::invalidateFileCache($dest); return true; } throw new FilesystemException(__METHOD__ . ': Failed to change file permissions.'); } throw new FilesystemException(__METHOD__ . ': Failed to move file.'); } /** * Invalidate any opcache for a newly written file immediately, if opcache* functions exist and if this was a PHP file. * * @param string $file The path to the file just written to, to flush from opcache * * @return void */ public static function invalidateFileCache($file) { if (function_exists('opcache_invalidate')) { $info = pathinfo($file); if (isset($info['extension']) && $info['extension'] === 'php') { // Force invalidation to be absolutely sure the opcache is cleared for this file. opcache_invalidate($file, true); } } } } PK c�\"�x ' filesystem/src/Stream/StringWrapper.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem\Stream; use Joomla\Filesystem\Support\StringController; /** * String Stream Wrapper * * This class allows you to use a PHP string in the same way that you would normally use a regular stream wrapper * * @since 1.3.0 */ class StringWrapper { /** * The current string * * @var string * @since 1.3.0 */ protected $currentString; /** * The path * * @var string * @since 1.3.0 */ protected $path; /** * The mode * * @var string * @since 1.3.0 */ protected $mode; /** * Enter description here ... * * @var string * @since 1.3.0 */ protected $options; /** * Enter description here ... * * @var string * @since 1.3.0 */ protected $openedPath; /** * Current position * * @var integer * @since 1.3.0 */ protected $pos; /** * Length of the string * * @var string * @since 1.3.0 */ protected $len; /** * Statistics for a file * * @var array * @since 1.3.0 * @link https://www.php.net/manual/en/function.stat.php */ protected $stat; /** * Method to open a file or URL. * * @param string $path The stream path. * @param string $mode Not used. * @param integer $options Not used. * @param string $openedPath Not used. * * @return boolean * * @since 1.3.0 */ public function stream_open($path, $mode, $options, &$openedPath) { $refPath = StringController::getRef(str_replace('string://', '', $path)); $this->currentString = &$refPath; if ($this->currentString) { $this->len = \strlen($this->currentString); $this->pos = 0; $this->stat = $this->url_stat($path, 0); return true; } return false; } /** * Method to retrieve information from a file resource * * @return array * * @link https://www.php.net/manual/en/streamwrapper.stream-stat.php * @since 1.3.0 */ public function stream_stat() { return $this->stat; } /** * Method to retrieve information about a file. * * @param string $path File path or URL to stat * @param integer $flags Additional flags set by the streams API * * @return array * * @link https://www.php.net/manual/en/streamwrapper.url-stat.php * @since 1.3.0 */ public function url_stat($path, $flags = 0) { $now = time(); $refPath = StringController::getRef(str_replace('string://', '', $path)); $string = &$refPath; $stat = [ 'dev' => 0, 'ino' => 0, 'mode' => 0, 'nlink' => 1, 'uid' => 0, 'gid' => 0, 'rdev' => 0, 'size' => \strlen($string), 'atime' => $now, 'mtime' => $now, 'ctime' => $now, 'blksize' => '512', 'blocks' => ceil(\strlen($string) / 512), ]; return $stat; } /** * Method to read a given number of bytes starting at the current position * and moving to the end of the string defined by the current position plus the * given number. * * @param integer $count Bytes of data from the current position should be returned. * * @return string * * @link https://www.php.net/manual/en/streamwrapper.stream-read.php * @since 1.3.0 */ public function stream_read($count) { $result = substr($this->currentString, $this->pos ?? 0, $count); $this->pos += $count; return $result; } /** * Stream write, always returning false. * * @param string $data The data to write. * * @return boolean * * @since 1.3.0 * @note Updating the string is not supported. */ public function stream_write($data) { // We don't support updating the string. return false; } /** * Method to get the current position * * @return integer The position * * @since 1.3.0 */ public function stream_tell() { return $this->pos; } /** * End of field check * * @return boolean True if at end of field. * * @since 1.3.0 */ public function stream_eof() { if ($this->pos >= $this->len) { return true; } return false; } /** * Stream offset * * @param integer $offset The starting offset. * @param integer $whence SEEK_SET, SEEK_CUR, SEEK_END * * @return boolean True on success. * * @since 1.3.0 */ public function stream_seek($offset, $whence) { // $whence: SEEK_SET, SEEK_CUR, SEEK_END if ($offset > $this->len) { // We can't seek beyond our len. return false; } switch ($whence) { case \SEEK_SET: $this->pos = $offset; break; case \SEEK_CUR: if (($this->pos + $offset) > $this->len) { return false; } $this->pos += $offset; break; case \SEEK_END: $this->pos = $this->len - $offset; break; } return true; } /** * Stream flush, always returns true. * * @return boolean * * @since 1.3.0 * @note Data storage is not supported */ public function stream_flush() { // We don't store data. return true; } } if (!stream_wrapper_register('string', '\\Joomla\\Filesystem\\Stream\\StringWrapper')) { die('\\Joomla\\Filesystem\\Stream\\StringWrapper Wrapper Registration Failed'); } PK c�\6��l29 29 filesystem/src/Folder.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem; use Joomla\Filesystem\Exception\FilesystemException; /** * A Folder handling class * * @since 1.0 */ abstract class Folder { /** * Copy a folder. * * @param string $src The path to the source folder. * @param string $dest The path to the destination folder. * @param string $path An optional base path to prefix to the file names. * @param boolean $force Force copy. * @param boolean $useStreams Optionally force folder/file overwrites. * * @return boolean True on success. * * @since 1.0 * @throws FilesystemException */ public static function copy($src, $dest, $path = '', $force = false, $useStreams = false) { @set_time_limit(ini_get('max_execution_time')); if ($path) { $src = Path::clean($path . '/' . $src); $dest = Path::clean($path . '/' . $dest); } // Eliminate trailing directory separators, if any $src = rtrim($src, \DIRECTORY_SEPARATOR); $dest = rtrim($dest, \DIRECTORY_SEPARATOR); if (!is_dir(Path::clean($src))) { throw new FilesystemException('Source folder not found', -1); } if (is_dir(Path::clean($dest)) && !$force) { throw new FilesystemException('Destination folder not found', -1); } // Make sure the destination exists if (!self::create($dest)) { throw new FilesystemException('Cannot create destination folder', -1); } if (!($dh = @opendir($src))) { throw new FilesystemException('Cannot open source folder', -1); } // Walk through the directory copying files and recursing into folders. while (($file = readdir($dh)) !== false) { $sfid = $src . '/' . $file; $dfid = $dest . '/' . $file; switch (filetype($sfid)) { case 'dir': if ($file != '.' && $file != '..') { $ret = self::copy($sfid, $dfid, null, $force, $useStreams); if ($ret !== true) { return $ret; } } break; case 'file': if ($useStreams) { Stream::getStream()->copy($sfid, $dfid); } else { if (!@copy($sfid, $dfid)) { throw new FilesystemException('Copy file failed', -1); } } break; } } return true; } /** * Create a folder -- and all necessary parent folders. * * @param string $path A path to create from the base path. * @param integer $mode Directory permissions to set for folders created. 0755 by default. * * @return boolean True if successful. * * @since 1.0 * @throws FilesystemException */ public static function create($path = '', $mode = 0755) { static $nested = 0; // Check to make sure the path valid and clean $path = Path::clean($path); // Check if parent dir exists $parent = \dirname($path); if (!is_dir(Path::clean($parent))) { // Prevent infinite loops! $nested++; if (($nested > 20) || ($parent == $path)) { throw new FilesystemException(__METHOD__ . ': Infinite loop detected'); } try { // Create the parent directory if (self::create($parent, $mode) !== true) { // Folder::create throws an error $nested--; return false; } } catch (FilesystemException $exception) { $nested--; throw $exception; } // OK, parent directory has been created $nested--; } // Check if dir already exists if (is_dir(Path::clean($path))) { return true; } // We need to get and explode the open_basedir paths $obd = ini_get('open_basedir'); // If open_basedir is set we need to get the open_basedir that the path is in if ($obd != null) { if (\defined('PHP_WINDOWS_VERSION_MAJOR')) { $obdSeparator = ';'; } else { $obdSeparator = ':'; } // Create the array of open_basedir paths $obdArray = explode($obdSeparator, $obd); $inBaseDir = false; // Iterate through open_basedir paths looking for a match foreach ($obdArray as $test) { $test = Path::clean($test); if (strpos($path, $test) === 0 || strpos($path, realpath($test)) === 0) { $inBaseDir = true; break; } } if ($inBaseDir == false) { // Throw a FilesystemException because the path to be created is not in open_basedir throw new FilesystemException(__METHOD__ . ': Path not in open_basedir paths'); } } // First set umask $origmask = @umask(0); // Create the path if (!$ret = @mkdir($path, $mode)) { @umask($origmask); throw new FilesystemException(__METHOD__ . ': Could not create directory. Path: ' . $path); } // Reset umask @umask($origmask); return $ret; } /** * Delete a folder. * * @param string $path The path to the folder to delete. * * @return boolean True on success. * * @since 1.0 * @throws FilesystemException * @throws \UnexpectedValueException */ public static function delete($path) { @set_time_limit(ini_get('max_execution_time')); // Sanity check if (!$path) { // Bad programmer! Bad Bad programmer! throw new FilesystemException(__METHOD__ . ': You can not delete a base directory.'); } // Check to make sure the path valid and clean $path = Path::clean($path); // Is this really a folder? if (!is_dir($path)) { throw new \UnexpectedValueException( sprintf( '%1$s: Path is not a folder. Path: %2$s', __METHOD__, Path::removeRoot($path) ) ); } // Remove all the files in folder if they exist; disable all filtering $files = self::files($path, '.', false, true, [], []); if (!empty($files)) { if (File::delete($files) !== true) { // File::delete throws an error return false; } } // Remove sub-folders of folder; disable all filtering $folders = self::folders($path, '.', false, true, [], []); foreach ($folders as $folder) { if (is_link($folder)) { // Don't descend into linked directories, just delete the link. if (File::delete($folder) !== true) { // File::delete throws an error return false; } } elseif (self::delete($folder) !== true) { // Folder::delete throws an error return false; } } // In case of restricted permissions we zap it one way or the other as long as the owner is either the webserver or the ftp. if (@rmdir($path)) { return true; } throw new FilesystemException(sprintf('%1$s: Could not delete folder. Path: %2$s', __METHOD__, $path)); } /** * Moves a folder. * * @param string $src The path to the source folder. * @param string $dest The path to the destination folder. * @param string $path An optional base path to prefix to the file names. * @param boolean $useStreams Optionally use streams. * * @return string|boolean Error message on false or boolean true on success. * * @since 1.0 */ public static function move($src, $dest, $path = '', $useStreams = false) { if ($path) { $src = Path::clean($path . '/' . $src); $dest = Path::clean($path . '/' . $dest); } if (!is_dir(Path::clean($src))) { return 'Cannot find source folder'; } if (is_dir(Path::clean($dest))) { return 'Folder already exists'; } if ($useStreams) { Stream::getStream()->move($src, $dest); return true; } if (!@rename($src, $dest)) { return 'Rename failed'; } return true; } /** * Utility function to read the files in a folder. * * @param string $path The path of the folder to read. * @param string $filter A filter for file names. * @param mixed $recurse True to recursively search into sub-folders, or an integer to specify the maximum depth. * @param boolean $full True to return the full path to the file. * @param array $exclude Array with names of files which should not be shown in the result. * @param array $excludeFilter Array of filter to exclude * * @return array Files in the given folder. * * @since 1.0 * @throws \UnexpectedValueException */ public static function files($path, $filter = '.', $recurse = false, $full = false, $exclude = ['.svn', 'CVS', '.DS_Store', '__MACOSX'], $excludeFilter = ['^\..*', '.*~'] ) { // Check to make sure the path valid and clean $path = Path::clean($path); // Is the path a folder? if (!is_dir($path)) { throw new \UnexpectedValueException( sprintf( '%1$s: Path is not a folder. Path: %2$s', __METHOD__, Path::removeRoot($path) ) ); } // Compute the excludefilter string if (\count($excludeFilter)) { $excludeFilterString = '/(' . implode('|', $excludeFilter) . ')/'; } else { $excludeFilterString = ''; } // Get the files $arr = self::_items($path, $filter, $recurse, $full, $exclude, $excludeFilterString, true); // Sort the files asort($arr); return array_values($arr); } /** * Utility function to read the folders in a folder. * * @param string $path The path of the folder to read. * @param string $filter A filter for folder names. * @param mixed $recurse True to recursively search into sub-folders, or an integer to specify the maximum depth. * @param boolean $full True to return the full path to the folders. * @param array $exclude Array with names of folders which should not be shown in the result. * @param array $excludeFilter Array with regular expressions matching folders which should not be shown in the result. * * @return array Folders in the given folder. * * @since 1.0 * @throws \UnexpectedValueException */ public static function folders($path, $filter = '.', $recurse = false, $full = false, $exclude = ['.svn', 'CVS', '.DS_Store', '__MACOSX'], $excludeFilter = ['^\..*'] ) { // Check to make sure the path valid and clean $path = Path::clean($path); // Is the path a folder? if (!is_dir($path)) { throw new \UnexpectedValueException( sprintf( '%1$s: Path is not a folder. Path: %2$s', __METHOD__, Path::removeRoot($path) ) ); } // Compute the excludefilter string if (\count($excludeFilter)) { $excludeFilterString = '/(' . implode('|', $excludeFilter) . ')/'; } else { $excludeFilterString = ''; } // Get the folders $arr = self::_items($path, $filter, $recurse, $full, $exclude, $excludeFilterString, false); // Sort the folders asort($arr); return array_values($arr); } /** * Function to read the files/folders in a folder. * * @param string $path The path of the folder to read. * @param string $filter A filter for file names. * @param mixed $recurse True to recursively search into sub-folders, or an integer to specify the maximum depth. * @param boolean $full True to return the full path to the file. * @param array $exclude Array with names of files which should not be shown in the result. * @param string $excludeFilterString Regexp of files to exclude * @param boolean $findfiles True to read the files, false to read the folders * * @return array Files. * * @since 1.0 */ protected static function _items($path, $filter, $recurse, $full, $exclude, $excludeFilterString, $findfiles) { @set_time_limit(ini_get('max_execution_time')); $arr = []; // Read the source directory if (!($handle = @opendir($path))) { return $arr; } while (($file = readdir($handle)) !== false) { if ($file != '.' && $file != '..' && !\in_array($file, $exclude) && (empty($excludeFilterString) || !preg_match($excludeFilterString, $file))) { // Compute the fullpath $fullpath = Path::clean($path . '/' . $file); // Compute the isDir flag $isDir = is_dir($fullpath); if (($isDir xor $findfiles) && preg_match("/$filter/", $file)) { // (fullpath is dir and folders are searched or fullpath is not dir and files are searched) and file matches the filter if ($full) { // Full path is requested $arr[] = $fullpath; } else { // Filename is requested $arr[] = $file; } } if ($isDir && $recurse) { // Search recursively if (\is_int($recurse)) { // Until depth 0 is reached $arr = array_merge($arr, self::_items($fullpath, $filter, $recurse - 1, $full, $exclude, $excludeFilterString, $findfiles)); } else { $arr = array_merge($arr, self::_items($fullpath, $filter, $recurse, $full, $exclude, $excludeFilterString, $findfiles)); } } } } closedir($handle); return $arr; } /** * Lists folder in format suitable for tree display. * * @param string $path The path of the folder to read. * @param string $filter A filter for folder names. * @param integer $maxLevel The maximum number of levels to recursively read, defaults to three. * @param integer $level The current level, optional. * @param integer $parent Unique identifier of the parent folder, if any. * * @return array Folders in the given folder. * * @since 1.0 */ public static function listFolderTree($path, $filter, $maxLevel = 3, $level = 0, $parent = 0) { $dirs = []; if ($level == 0) { $GLOBALS['_JFolder_folder_tree_index'] = 0; } if ($level < $maxLevel) { $folders = self::folders($path, $filter); // First path, index foldernames foreach ($folders as $name) { $id = ++$GLOBALS['_JFolder_folder_tree_index']; $fullName = Path::clean($path . '/' . $name); $dirs[] = [ 'id' => $id, 'parent' => $parent, 'name' => $name, 'fullname' => $fullName, 'relname' => str_replace(JPATH_ROOT, '', $fullName), ]; $dirs2 = self::listFolderTree($fullName, $filter, $maxLevel, $level + 1, $id); $dirs = array_merge($dirs, $dirs2); } } return $dirs; } /** * Makes path name safe to use. * * @param string $path The full path to sanitise. * * @return string The sanitised string. * * @since 1.0 */ public static function makeSafe($path) { $regex = ['#[^A-Za-z0-9_\\\/\(\)\[\]\{\}\#\$\^\+\.\'~`!@&=;,-]#']; return preg_replace($regex, '', $path); } } PK c�\��%6� � 0 filesystem/src/Exception/FilesystemException.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem\Exception; use Joomla\Filesystem\Path; /** * Exception class for handling errors in the Filesystem package * * @since 1.2.0 * @change 2.0.1 If the message containes a full path, the root path (JPATH_ROOT) is removed from it * to avoid any full path disclosure. Before 2.0.1, the path was propagated as provided. */ class FilesystemException extends \RuntimeException { /** * Constructor. * * @param string $message The message * @param integer $code The code * @param \Throwable|null $previous A previous exception */ public function __construct($message = "", $code = 0, \Throwable $previous = null) { parent::__construct( Path::removeRoot($message), $code, $previous ); } } PK c�\zi�� � $ filesystem/src/Clients/FtpClient.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem\Clients; use Joomla\Filesystem\Exception\FilesystemException; /* * Error Codes: * - 30 : Unable to connect to host * - 31 : Not connected * - 32 : Unable to send command to server * - 33 : Bad username * - 34 : Bad password * - 35 : Bad response * - 36 : Passive mode failed * - 37 : Data transfer error * - 38 : Local filesystem error */ if (!\defined('CRLF')) { \define('CRLF', "\r\n"); } if (!\defined('FTP_AUTOASCII')) { \define('FTP_AUTOASCII', -1); } if (!\defined('FTP_BINARY')) { \define('FTP_BINARY', 1); } if (!\defined('FTP_ASCII')) { \define('FTP_ASCII', 0); } if (!\defined('FTP_NATIVE')) { \define('FTP_NATIVE', (\function_exists('ftp_connect')) ? 1 : 0); } /** * FTP client class * * @since 1.0 */ class FtpClient { /** * Socket resource * * @var resource * @since 1.0 */ private $conn; /** * Data port connection resource * * @var resource * @since 1.0 */ private $dataconn; /** * Passive connection information * * @var array * @since 1.0 */ private $pasv; /** * Response Message * * @var string * @since 1.0 */ private $response; /** * Response Code * * @var integer * @since 1.0 */ private $responseCode; /** * Response Message * * @var string * @since 1.0 */ private $responseMsg; /** * Timeout limit * * @var integer * @since 1.0 */ private $timeout = 15; /** * Transfer Type * * @var integer * @since 1.0 */ private $type; /** * Array to hold ascii format file extensions * * @var array * @since 1.0 */ private $autoAscii = [ 'asp', 'bat', 'c', 'cpp', 'csv', 'h', 'htm', 'html', 'shtml', 'ini', 'inc', 'log', 'php', 'php3', 'pl', 'perl', 'sh', 'sql', 'txt', 'xhtml', 'xml', ]; /** * Array to hold native line ending characters * * @var array * @since 1.0 */ private $lineEndings = ['UNIX' => "\n", 'WIN' => "\r\n"]; /** * FtpClient instances container. * * @var FtpClient[] * @since 1.0 */ protected static $instances = []; /** * FtpClient object constructor * * @param array $options Associative array of options to set * * @since 1.0 */ public function __construct(array $options = []) { // If default transfer type is not set, set it to autoascii detect if (!isset($options['type'])) { $options['type'] = \FTP_BINARY; } $this->setOptions($options); if (FTP_NATIVE) { // Autoloading fails for Buffer as the class is used as a stream handler class_exists('Joomla\\Filesystem\\Buffer'); } } /** * FtpClient object destructor * * Closes an existing connection, if we have one * * @since 1.0 */ public function __destruct() { if (\is_resource($this->conn)) { $this->quit(); } } /** * Returns the global FTP connector object, only creating it * if it doesn't already exist. * * You may optionally specify a username and password in the parameters. If you do so, * you may not login() again with different credentials using the same object. * If you do not use this option, you must quit() the current connection when you * are done, to free it for use by others. * * @param string $host Host to connect to * @param string $port Port to connect to * @param array $options Array with any of these options: type=>[FTP_AUTOASCII|FTP_ASCII|FTP_BINARY], timeout=>(int) * @param string $user Username to use for a connection * @param string $pass Password to use for a connection * * @return FtpClient The FTP Client object. * * @since 1.0 */ public static function getInstance($host = '127.0.0.1', $port = '21', array $options = [], $user = null, $pass = null) { $signature = $user . ':' . $pass . '@' . $host . ':' . $port; // Create a new instance, or set the options of an existing one if (!isset(self::$instances[$signature]) || !\is_object(self::$instances[$signature])) { self::$instances[$signature] = new static($options); } else { self::$instances[$signature]->setOptions($options); } // Connect to the server, and login, if requested if (!self::$instances[$signature]->isConnected()) { $return = self::$instances[$signature]->connect($host, $port); if ($return && $user !== null && $pass !== null) { self::$instances[$signature]->login($user, $pass); } } return self::$instances[$signature]; } /** * Set client options * * @param array $options Associative array of options to set * * @return boolean True if successful * * @since 1.0 */ public function setOptions(array $options) { if (isset($options['type'])) { $this->type = $options['type']; } if (isset($options['timeout'])) { $this->timeout = $options['timeout']; } return true; } /** * Method to connect to a FTP server * * @param string $host Host to connect to [Default: 127.0.0.1] * @param integer $port Port to connect on [Default: port 21] * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function connect($host = '127.0.0.1', $port = 21) { $errno = null; $err = null; // If already connected, return if (\is_resource($this->conn)) { return true; } // If native FTP support is enabled let's use it... if (FTP_NATIVE) { $this->conn = @ftp_connect($host, $port, $this->timeout); if ($this->conn === false) { throw new FilesystemException(sprintf('%1$s: Could not connect to host " %2$s " on port " %3$s "', __METHOD__, $host, $port)); } // Set the timeout for this connection ftp_set_option($this->conn, \FTP_TIMEOUT_SEC, $this->timeout); return true; } // Connect to the FTP server. $this->conn = @ fsockopen($host, $port, $errno, $err, $this->timeout); if (!$this->conn) { throw new FilesystemException( sprintf( '%1$s: Could not connect to host " %2$s " on port " %3$s ". Socket error number: %4$s and error message: %5$s', __METHOD__, $host, $port, $errno, $err ) ); } // Set the timeout for this connection socket_set_timeout($this->conn, $this->timeout, 0); // Check for welcome response code if (!$this->_verifyResponse(220)) { throw new FilesystemException(sprintf('%1$s: Bad response. Server response: %2$s [Expected: 220]', __METHOD__, $this->response)); } return true; } /** * Method to determine if the object is connected to an FTP server * * @return boolean True if connected * * @since 1.0 */ public function isConnected() { return \is_resource($this->conn); } /** * Method to login to a server once connected * * @param string $user Username to login to the server * @param string $pass Password to login to the server * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function login($user = 'anonymous', $pass = 'jftp@joomla.org') { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (@ftp_login($this->conn, $user, $pass) === false) { throw new FilesystemException(__METHOD__ . ': Unable to login'); } return true; } // Send the username if (!$this->_putCmd('USER ' . $user, [331, 503])) { throw new FilesystemException( sprintf('%1$s: Bad Username. Server response: %2$s [Expected: 331]. Username sent: %3$s', __METHOD__, $this->response, $user) ); } // If we are already logged in, continue :) if ($this->responseCode == 503) { return true; } // Send the password if (!$this->_putCmd('PASS ' . $pass, 230)) { throw new FilesystemException(sprintf('%1$s: Bad Password. Server response: %2$s [Expected: 230].', __METHOD__, $this->response)); } return true; } /** * Method to quit and close the connection * * @return boolean True if successful * * @since 1.0 */ public function quit() { // If native FTP support is enabled lets use it... if (FTP_NATIVE) { @ftp_close($this->conn); return true; } // Logout and close connection @fwrite($this->conn, "QUIT\r\n"); @fclose($this->conn); return true; } /** * Method to retrieve the current working directory on the FTP server * * @return string Current working directory * * @since 1.0 * @throws FilesystemException */ public function pwd() { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (($ret = @ftp_pwd($this->conn)) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return $ret; } $match = [null]; // Send print working directory command and verify success if (!$this->_putCmd('PWD', 257)) { throw new FilesystemException(sprintf('%1$s: Bad response. Server response: %2$s [Expected: 257]', __METHOD__, $this->response)); } // Match just the path preg_match('/"[^"\r\n]*"/', $this->response, $match); // Return the cleaned path return preg_replace('/"/', '', $match[0]); } /** * Method to system string from the FTP server * * @return string System identifier string * * @since 1.0 * @throws FilesystemException */ public function syst() { // If native FTP support is enabled lets use it... if (FTP_NATIVE) { if (($ret = @ftp_systype($this->conn)) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } } else { // Send print working directory command and verify success if (!$this->_putCmd('SYST', 215)) { throw new FilesystemException(sprintf('%1$s: Bad response. Server response: %2$s [Expected: 215]', __METHOD__, $this->response)); } $ret = $this->response; } // Match the system string to an OS if (strpos(strtoupper($ret), 'MAC') !== false) { $ret = 'MAC'; } elseif (strpos(strtoupper($ret), 'WIN') !== false) { $ret = 'WIN'; } else { $ret = 'UNIX'; } // Return the os type return $ret; } /** * Method to change the current working directory on the FTP server * * @param string $path Path to change into on the server * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function chdir($path) { // If native FTP support is enabled lets use it... if (FTP_NATIVE) { if (@ftp_chdir($this->conn, $path) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return true; } // Send change directory command and verify success if (!$this->_putCmd('CWD ' . $path, 250)) { throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 250]. Sent path: %3$s', __METHOD__, $this->response, $path) ); } return true; } /** * Method to reinitialise the server, ie. need to login again * * NOTE: This command not available on all servers * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function reinit() { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (@ftp_site($this->conn, 'REIN') === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return true; } // Send reinitialise command to the server if (!$this->_putCmd('REIN', 220)) { throw new FilesystemException(sprintf('%1$s: Bad response. Server response: %2$s [Expected: 220]', __METHOD__, $this->response)); } return true; } /** * Method to rename a file/folder on the FTP server * * @param string $from Path to change file/folder from * @param string $to Path to change file/folder to * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function rename($from, $to) { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (@ftp_rename($this->conn, $from, $to) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return true; } // Send rename from command to the server if (!$this->_putCmd('RNFR ' . $from, 350)) { throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 350]. From path sent: %3$s', __METHOD__, $this->response, $from) ); } // Send rename to command to the server if (!$this->_putCmd('RNTO ' . $to, 250)) { throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 250]. To path sent: %3$s', __METHOD__, $this->response, $to) ); } return true; } /** * Method to change mode for a path on the FTP server * * @param string $path Path to change mode on * @param mixed $mode Octal value to change mode to, e.g. '0777', 0777 or 511 (string or integer) * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function chmod($path, $mode) { // If no filename is given, we assume the current directory is the target if ($path == '') { $path = '.'; } // Convert the mode to a string if (\is_int($mode)) { $mode = decoct($mode); } // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (@ftp_site($this->conn, 'CHMOD ' . $mode . ' ' . $path) === false) { if (!\defined('PHP_WINDOWS_VERSION_MAJOR')) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return false; } return true; } // Send change mode command and verify success [must convert mode from octal] if (!$this->_putCmd('SITE CHMOD ' . $mode . ' ' . $path, [200, 250])) { if (!\defined('PHP_WINDOWS_VERSION_MAJOR')) { throw new FilesystemException( sprintf( '%1$s: Bad response. Server response: %2$s [Expected: 250]. Path sent: %3$s. Mode sent: %4$s', __METHOD__, $this->response, $path, $mode ) ); } return false; } return true; } /** * Method to delete a path [file/folder] on the FTP server * * @param string $path Path to delete * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function delete($path) { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (@ftp_delete($this->conn, $path) === false) { if (@ftp_rmdir($this->conn, $path) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } } return true; } // Send delete file command and if that doesn't work, try to remove a directory if (!$this->_putCmd('DELE ' . $path, 250)) { if (!$this->_putCmd('RMD ' . $path, 250)) { throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 250]. Path sent: %3$s', __METHOD__, $this->response, $path) ); } } return true; } /** * Method to create a directory on the FTP server * * @param string $path Directory to create * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function mkdir($path) { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (@ftp_mkdir($this->conn, $path) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return true; } // Send change directory command and verify success if (!$this->_putCmd('MKD ' . $path, 257)) { throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 257]. Path sent: %3$s', __METHOD__, $this->response, $path) ); } return true; } /** * Method to restart data transfer at a given byte * * @param integer $point Byte to restart transfer at * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function restart($point) { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { if (@ftp_site($this->conn, 'REST ' . $point) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return true; } // Send restart command and verify success if (!$this->_putCmd('REST ' . $point, 350)) { throw new FilesystemException( sprintf( '%1$s: Bad response. Server response: %2$s [Expected: 350]. Restart point sent: %3$s', __METHOD__, $this->response, $point ) ); } return true; } /** * Method to create an empty file on the FTP server * * @param string $path Path local file to store on the FTP server * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function create($path) { // If native FTP support is enabled let's use it... if (FTP_NATIVE) { // Turn passive mode on if (@ftp_pasv($this->conn, true) === false) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } $buffer = fopen('buffer://tmp', 'r'); if (@ftp_fput($this->conn, $path, $buffer, \FTP_ASCII) === false) { fclose($buffer); throw new FilesystemException(__METHOD__ . 'Bad response.'); } fclose($buffer); return true; } // Start passive mode if (!$this->_passive()) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (!$this->_putCmd('STOR ' . $path, [150, 125])) { @ fclose($this->dataconn); throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 150 or 125]. Path sent: %3$s', __METHOD__, $this->response, $path) ); } // To create a zero byte upload close the data port connection fclose($this->dataconn); if (!$this->_verifyResponse(226)) { throw new FilesystemException( sprintf('%1$s: Transfer failed. Server response: %2$s [Expected: 226]. Path sent: %3$s', __METHOD__, $this->response, $path) ); } return true; } /** * Method to read a file from the FTP server's contents into a buffer * * @param string $remote Path to remote file to read on the FTP server * @param string $buffer Buffer variable to read file contents into * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function read($remote, &$buffer) { // Determine file type $mode = $this->_findMode($remote); // If native FTP support is enabled let's use it... if (FTP_NATIVE) { // Turn passive mode on if (@ftp_pasv($this->conn, true) === false) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } $tmp = fopen('buffer://tmp', 'br+'); if (@ftp_fget($this->conn, $tmp, $remote, $mode) === false) { fclose($tmp); throw new FilesystemException(__METHOD__ . 'Bad response.'); } // Read tmp buffer contents rewind($tmp); $buffer = ''; while (!feof($tmp)) { $buffer .= fread($tmp, 8192); } fclose($tmp); return true; } $this->_mode($mode); // Start passive mode if (!$this->_passive()) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (!$this->_putCmd('RETR ' . $remote, [150, 125])) { @ fclose($this->dataconn); throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 150 or 125]. Path sent: %3$s', __METHOD__, $this->response, $remote) ); } // Read data from data port connection and add to the buffer $buffer = ''; while (!feof($this->dataconn)) { $buffer .= fread($this->dataconn, 4096); } // Close the data port connection fclose($this->dataconn); // Let's try to cleanup some line endings if it is ascii if ($mode == \FTP_ASCII) { $os = 'UNIX'; if (\defined('PHP_WINDOWS_VERSION_MAJOR')) { $os = 'WIN'; } $buffer = preg_replace('/' . CRLF . '/', $this->lineEndings[$os], $buffer); } if (!$this->_verifyResponse(226)) { throw new FilesystemException( sprintf( '%1$s: Transfer failed. Server response: %2$s [Expected: 226]. Restart point sent: %3$s', __METHOD__, $this->response, $remote ) ); } return true; } /** * Method to get a file from the FTP server and save it to a local file * * @param string $local Local path to save remote file to * @param string $remote Path to remote file to get on the FTP server * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function get($local, $remote) { // Determine file type $mode = $this->_findMode($remote); // If native FTP support is enabled let's use it... if (FTP_NATIVE) { // Turn passive mode on if (@ftp_pasv($this->conn, true) === false) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (@ftp_get($this->conn, $local, $remote, $mode) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return true; } $this->_mode($mode); // Check to see if the local file can be opened for writing $fp = fopen($local, 'wb'); if (!$fp) { throw new FilesystemException(sprintf('%1$s: Unable to open local file for writing. Local path: %2$s', __METHOD__, $local)); } // Start passive mode if (!$this->_passive()) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (!$this->_putCmd('RETR ' . $remote, [150, 125])) { @ fclose($this->dataconn); throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 150 or 125]. Path sent: %3$s', __METHOD__, $this->response, $remote) ); } // Read data from data port connection and add to the buffer while (!feof($this->dataconn)) { $buffer = fread($this->dataconn, 4096); fwrite($fp, $buffer, 4096); } // Close the data port connection and file pointer fclose($this->dataconn); fclose($fp); if (!$this->_verifyResponse(226)) { throw new FilesystemException( sprintf('%1$s: Transfer failed. Server response: %2$s [Expected: 226]. Path sent: %3$s', __METHOD__, $this->response, $remote) ); } return true; } /** * Method to store a file to the FTP server * * @param string $local Path to local file to store on the FTP server * @param string $remote FTP path to file to create * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function store($local, $remote = null) { // If remote file is not given, use the filename of the local file in the current // working directory. if ($remote == null) { $remote = basename($local); } // Determine file type $mode = $this->_findMode($remote); // If native FTP support is enabled let's use it... if (FTP_NATIVE) { // Turn passive mode on if (@ftp_pasv($this->conn, true) === false) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (@ftp_put($this->conn, $remote, $local, $mode) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } return true; } $this->_mode($mode); // Check to see if the local file exists and if so open it for reading if (@ file_exists($local)) { $fp = fopen($local, 'rb'); if (!$fp) { throw new FilesystemException(sprintf('%1$s: Unable to open local file for reading. Local path: %2$s', __METHOD__, $local)); } } else { throw new FilesystemException(sprintf('%1$s: Unable to find local file. Local path: %2$s', __METHOD__, $local)); } // Start passive mode if (!$this->_passive()) { @ fclose($fp); throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } // Send store command to the FTP server if (!$this->_putCmd('STOR ' . $remote, [150, 125])) { @ fclose($fp); @ fclose($this->dataconn); throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 150 or 125]. Path sent: %3$s', __METHOD__, $this->response, $remote) ); } // Do actual file transfer, read local file and write to data port connection while (!feof($fp)) { $line = fread($fp, 4096); do { if (($result = @ fwrite($this->dataconn, $line)) === false) { throw new FilesystemException(__METHOD__ . ': Unable to write to data port socket'); } $line = substr($line, $result); } while ($line != ''); } fclose($fp); fclose($this->dataconn); if (!$this->_verifyResponse(226)) { throw new FilesystemException( sprintf('%1$s: Transfer failed. Server response: %2$s [Expected: 226]. Path sent: %3$s', __METHOD__, $this->response, $remote) ); } return true; } /** * Method to write a string to the FTP server * * @param string $remote FTP path to file to write to * @param string $buffer Contents to write to the FTP server * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ public function write($remote, $buffer) { // Determine file type $mode = $this->_findMode($remote); // If native FTP support is enabled let's use it... if (FTP_NATIVE) { // Turn passive mode on if (@ftp_pasv($this->conn, true) === false) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } $tmp = fopen('buffer://tmp', 'br+'); fwrite($tmp, $buffer); rewind($tmp); if (@ftp_fput($this->conn, $remote, $tmp, $mode) === false) { fclose($tmp); throw new FilesystemException(__METHOD__ . 'Bad response.'); } fclose($tmp); return true; } // First we need to set the transfer mode $this->_mode($mode); // Start passive mode if (!$this->_passive()) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } // Send store command to the FTP server if (!$this->_putCmd('STOR ' . $remote, [150, 125])) { @ fclose($this->dataconn); throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 150 or 125]. Path sent: %3$s', __METHOD__, $this->response, $remote) ); } // Write buffer to the data connection port do { if (($result = @ fwrite($this->dataconn, $buffer)) === false) { throw new FilesystemException(__METHOD__ . ': Unable to write to data port socket.'); } $buffer = substr($buffer, $result); } while ($buffer != ''); // Close the data connection port [Data transfer complete] fclose($this->dataconn); // Verify that the server recieved the transfer if (!$this->_verifyResponse(226)) { throw new FilesystemException( sprintf('%1$s: Transfer failed. Server response: %2$s [Expected: 226]. Path sent: %3$s', __METHOD__, $this->response, $remote) ); } return true; } /** * Method to list the filenames of the contents of a directory on the FTP server * * Note: Some servers also return folder names. However, to be sure to list folders on all * servers, you should use listDetails() instead if you also need to deal with folders * * @param string $path Path local file to store on the FTP server * * @return string Directory listing * * @since 1.0 * @throws FilesystemException */ public function listNames($path = null) { $data = null; // If native FTP support is enabled let's use it... if (FTP_NATIVE) { // Turn passive mode on if (@ftp_pasv($this->conn, true) === false) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (($list = @ftp_nlist($this->conn, $path)) === false) { // Workaround for empty directories on some servers if ($this->listDetails($path, 'files') === []) { return []; } throw new FilesystemException(__METHOD__ . 'Bad response.'); } $list = preg_replace('#^' . preg_quote($path, '#') . '[/\\\\]?#', '', $list); if ($keys = array_merge(array_keys($list, '.'), array_keys($list, '..'))) { foreach ($keys as $key) { unset($list[$key]); } } return $list; } // If a path exists, prepend a space if ($path != null) { $path = ' ' . $path; } // Start passive mode if (!$this->_passive()) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (!$this->_putCmd('NLST' . $path, [150, 125])) { @ fclose($this->dataconn); // Workaround for empty directories on some servers if ($this->listDetails($path, 'files') === []) { return []; } throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 150 or 125]. Path sent: %3$s', __METHOD__, $this->response, $path) ); } // Read in the file listing. while (!feof($this->dataconn)) { $data .= fread($this->dataconn, 4096); } fclose($this->dataconn); // Everything go okay? if (!$this->_verifyResponse(226)) { throw new FilesystemException( sprintf('%1$s: Transfer failed. Server response: %2$s [Expected: 226]. Path sent: %3$s', __METHOD__, $this->response, $path) ); } $data = preg_split('/[' . CRLF . ']+/', $data, -1, \PREG_SPLIT_NO_EMPTY); $data = preg_replace('#^' . preg_quote(substr($path, 1), '#') . '[/\\\\]?#', '', $data); if ($keys = array_merge(array_keys($data, '.'), array_keys($data, '..'))) { foreach ($keys as $key) { unset($data[$key]); } } return $data; } /** * Method to list the contents of a directory on the FTP server * * @param string $path Path to the local file to be stored on the FTP server * @param string $type Return type [raw|all|folders|files] * * @return string[] If $type is raw: string Directory listing, otherwise array of string with file-names * * @since 1.0 * @throws FilesystemException */ public function listDetails($path = null, $type = 'all') { $dirList = []; $data = null; $regs = null; // TODO: Deal with recurse -- nightmare // For now we will just set it to false $recurse = false; // If native FTP support is enabled let's use it... if (FTP_NATIVE) { // Turn passive mode on if (@ftp_pasv($this->conn, true) === false) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } if (($contents = @ftp_rawlist($this->conn, $path)) === false) { throw new FilesystemException(__METHOD__ . 'Bad response.'); } } else { // Non Native mode // Start passive mode if (!$this->_passive()) { throw new FilesystemException(__METHOD__ . ': Unable to use passive mode.'); } // If a path exists, prepend a space if ($path != null) { $path = ' ' . $path; } // Request the file listing if (!$this->_putCmd(($recurse == true) ? 'LIST -R' : 'LIST' . $path, [150, 125])) { @ fclose($this->dataconn); throw new FilesystemException( sprintf( '%1$s: Bad response. Server response: %2$s [Expected: 150 or 125]. Path sent: %3$s', __METHOD__, $this->response, $path ) ); } // Read in the file listing. while (!feof($this->dataconn)) { $data .= fread($this->dataconn, 4096); } fclose($this->dataconn); // Everything go okay? if (!$this->_verifyResponse(226)) { throw new FilesystemException( sprintf('%1$s: Transfer failed. Server response: %2$s [Expected: 226]. Path sent: %3$s', __METHOD__, $this->response, $path) ); } $contents = explode(CRLF, $data); } // If only raw output is requested we are done if ($type == 'raw') { return $data; } // If we received the listing of an empty directory, we are done as well if (empty($contents[0])) { return $dirList; } // If the server returned the number of results in the first response, let's dump it if (strtolower(substr($contents[0], 0, 6)) == 'total ') { array_shift($contents); if (!isset($contents[0]) || empty($contents[0])) { return $dirList; } } // Regular expressions for the directory listing parsing. $regexps = [ 'UNIX' => '#([-dl][rwxstST-]+).* ([0-9]*) ([a-zA-Z0-9]+).* ([a-zA-Z0-9]+).* ([0-9]*)' . ' ([a-zA-Z]+[0-9: ]*[0-9])[ ]+(([0-9]{1,2}:[0-9]{2})|[0-9]{4}) (.+)#', 'MAC' => '#([-dl][rwxstST-]+).* ?([0-9 ]*)?([a-zA-Z0-9]+).* ([a-zA-Z0-9]+).* ([0-9]*)' . ' ([a-zA-Z]+[0-9: ]*[0-9])[ ]+(([0-9]{2}:[0-9]{2})|[0-9]{4}) (.+)#', 'WIN' => '#([0-9]{2})-([0-9]{2})-([0-9]{2}) +([0-9]{2}):([0-9]{2})(AM|PM) +([0-9]+|<DIR>) +(.+)#', ]; // Find out the format of the directory listing by matching one of the regexps $osType = null; foreach ($regexps as $k => $v) { if (@preg_match($v, $contents[0])) { $osType = $k; $regexp = $v; break; } } if (!$osType) { throw new FilesystemException(__METHOD__ . ': Unrecognised directory listing format.'); } /* * Here is where it is going to get dirty.... */ if ($osType == 'UNIX' || $osType == 'MAC') { foreach ($contents as $file) { $tmpArray = null; if (@preg_match($regexp, $file, $regs)) { $fType = (int) strpos('-dl', $regs[1][0]); // $tmpArray['line'] = $regs[0]; $tmpArray['type'] = $fType; $tmpArray['rights'] = $regs[1]; // $tmpArray['number'] = $regs[2]; $tmpArray['user'] = $regs[3]; $tmpArray['group'] = $regs[4]; $tmpArray['size'] = $regs[5]; $tmpArray['date'] = @date('m-d', strtotime($regs[6])); $tmpArray['time'] = $regs[7]; $tmpArray['name'] = $regs[9]; } // If we just want files, do not add a folder if ($type == 'files' && $tmpArray['type'] == 1) { continue; } // If we just want folders, do not add a file if ($type == 'folders' && $tmpArray['type'] == 0) { continue; } if (\is_array($tmpArray) && $tmpArray['name'] != '.' && $tmpArray['name'] != '..') { $dirList[] = $tmpArray; } } } else { foreach ($contents as $file) { $tmpArray = null; if (@preg_match($regexp, $file, $regs)) { $fType = (int) ($regs[7] == '<DIR>'); $timestamp = strtotime("$regs[3]-$regs[1]-$regs[2] $regs[4]:$regs[5]$regs[6]"); // $tmpArray['line'] = $regs[0]; $tmpArray['type'] = $fType; $tmpArray['rights'] = ''; // $tmpArray['number'] = 0; $tmpArray['user'] = ''; $tmpArray['group'] = ''; $tmpArray['size'] = (int) $regs[7]; $tmpArray['date'] = date('m-d', $timestamp); $tmpArray['time'] = date('H:i', $timestamp); $tmpArray['name'] = $regs[8]; } // If we just want files, do not add a folder if ($type == 'files' && $tmpArray['type'] == 1) { continue; } // If we just want folders, do not add a file if ($type == 'folders' && $tmpArray['type'] == 0) { continue; } if (\is_array($tmpArray) && $tmpArray['name'] != '.' && $tmpArray['name'] != '..') { $dirList[] = $tmpArray; } } } return $dirList; } /** * Send command to the FTP server and validate an expected response code * * @param string $cmd Command to send to the FTP server * @param mixed $expectedResponse Integer response code or array of integer response codes * * @return boolean True if command executed successfully * * @since 1.0 * @throws FilesystemException */ protected function _putCmd($cmd, $expectedResponse) { // Make sure we have a connection to the server if (!\is_resource($this->conn)) { throw new FilesystemException(__METHOD__ . ': Not connected to the control port.'); } // Send the command to the server if (!fwrite($this->conn, $cmd . "\r\n")) { throw new FilesystemException(sprintf('%1$s: Unable to send command: %2$s', __METHOD__, $cmd)); } return $this->_verifyResponse($expectedResponse); } /** * Verify the response code from the server and log response if flag is set * * @param mixed $expected Integer response code or array of integer response codes * * @return boolean True if response code from the server is expected * * @since 1.0 * @throws FilesystemException */ protected function _verifyResponse($expected) { $parts = null; // Wait for a response from the server, but timeout after the set time limit $endTime = time() + $this->timeout; $this->response = ''; do { $this->response .= fgets($this->conn, 4096); } while (!preg_match('/^([0-9]{3})(-(.*' . CRLF . ')+\\1)? [^' . CRLF . ']+' . CRLF . '$/', $this->response, $parts) && time() < $endTime); // Catch a timeout or bad response if (!isset($parts[1])) { throw new FilesystemException( sprintf( '%1$s: Timeout or unrecognised response while waiting for a response from the server. Server response: %2$s', __METHOD__, $this->response ) ); } // Separate the code from the message $this->responseCode = $parts[1]; $this->responseMsg = $parts[0]; // Did the server respond with the code we wanted? if (\is_array($expected)) { if (\in_array($this->responseCode, $expected)) { $retval = true; } else { $retval = false; } } else { if ($this->responseCode == $expected) { $retval = true; } else { $retval = false; } } return $retval; } /** * Set server to passive mode and open a data port connection * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ protected function _passive() { $match = []; $parts = []; $errno = null; $err = null; // Make sure we have a connection to the server if (!\is_resource($this->conn)) { throw new FilesystemException(__METHOD__ . ': Not connected to the control port.'); } // Request a passive connection - this means, we'll talk to you, you don't talk to us. @ fwrite($this->conn, "PASV\r\n"); // Wait for a response from the server, but timeout after the set time limit $endTime = time() + $this->timeout; $this->response = ''; do { $this->response .= fgets($this->conn, 4096); } while (!preg_match('/^([0-9]{3})(-(.*' . CRLF . ')+\\1)? [^' . CRLF . ']+' . CRLF . '$/', $this->response, $parts) && time() < $endTime); // Catch a timeout or bad response if (!isset($parts[1])) { throw new FilesystemException( sprintf( '%1$s: Timeout or unrecognised response while waiting for a response from the server. Server response: %2$s', __METHOD__, $this->response ) ); } // Separate the code from the message $this->responseCode = $parts[1]; $this->responseMsg = $parts[0]; // If it's not 227, we weren't given an IP and port, which means it failed. if ($this->responseCode != 227) { throw new FilesystemException( sprintf('%1$s: Unable to obtain IP and port for data transfer. Server response: %2$s', __METHOD__, $this->responseMsg) ); } // Snatch the IP and port information, or die horribly trying... if (preg_match('~\((\d+),\s*(\d+),\s*(\d+),\s*(\d+),\s*(\d+)(?:,\s*(\d+))\)~', $this->responseMsg, $match) == 0) { throw new FilesystemException( sprintf('%1$s: IP and port for data transfer not valid. Server response: %2$s', __METHOD__, $this->responseMsg) ); } // This is pretty simple - store it for later use ;). $this->pasv = ['ip' => $match[1] . '.' . $match[2] . '.' . $match[3] . '.' . $match[4], 'port' => $match[5] * 256 + $match[6]]; // Connect, assuming we've got a connection. $this->dataconn = @fsockopen($this->pasv['ip'], $this->pasv['port'], $errno, $err, $this->timeout); if (!$this->dataconn) { throw new FilesystemException( sprintf( '%1$s: Could not connect to host %2$s on port %3$s. Socket error number: %4$s and error message: %5$s', __METHOD__, $this->pasv['ip'], $this->pasv['port'], $errno, $err ) ); } // Set the timeout for this connection socket_set_timeout($this->conn, $this->timeout, 0); return true; } /** * Method to find out the correct transfer mode for a specific file * * @param string $fileName Name of the file * * @return integer Transfer-mode for this filetype [FTP_ASCII|FTP_BINARY] * * @since 1.0 */ protected function _findMode($fileName) { if ($this->type == FTP_AUTOASCII) { $dot = strrpos($fileName, '.') + 1; $ext = substr($fileName, $dot); if (\in_array($ext, $this->autoAscii)) { $mode = \FTP_ASCII; } else { $mode = \FTP_BINARY; } } elseif ($this->type == \FTP_ASCII) { $mode = \FTP_ASCII; } else { $mode = \FTP_BINARY; } return $mode; } /** * Set transfer mode * * @param integer $mode Integer representation of data transfer mode [1:Binary|0:Ascii] * Defined constants can also be used [FTP_BINARY|FTP_ASCII] * * @return boolean True if successful * * @since 1.0 * @throws FilesystemException */ protected function _mode($mode) { if ($mode == \FTP_BINARY) { if (!$this->_putCmd('TYPE I', 200)) { throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 200]. Mode sent: Binary', __METHOD__, $this->response) ); } } else { if (!$this->_putCmd('TYPE A', 200)) { throw new FilesystemException( sprintf('%1$s: Bad response. Server response: %2$s [Expected: 200]. Mode sent: ASCII', __METHOD__, $this->response) ); } } return true; } } PK c�\߭�K[ [ filesystem/src/Helper.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem; /** * File system helper * * Holds support functions for the filesystem, particularly the stream * * @since 1.0 */ class Helper { /** * Remote file size function for streams that don't support it * * @param string $url TODO Add text * * @return mixed * * @link https://www.php.net/manual/en/function.filesize.php#71098 * @since 1.0 */ public static function remotefsize($url) { $sch = parse_url($url, \PHP_URL_SCHEME); if (!\in_array($sch, ['http', 'https', 'ftp', 'ftps'], true)) { return false; } if (\in_array($sch, ['http', 'https'], true)) { $headers = @ get_headers($url, 1); if (!$headers || (!\array_key_exists('Content-Length', $headers))) { return false; } return $headers['Content-Length']; } if (\in_array($sch, ['ftp', 'ftps'], true)) { $server = parse_url($url, \PHP_URL_HOST); $port = parse_url($url, \PHP_URL_PORT); $path = parse_url($url, \PHP_URL_PATH); $user = parse_url($url, \PHP_URL_USER); $pass = parse_url($url, \PHP_URL_PASS); if ((!$server) || (!$path)) { return false; } if (!$port) { $port = 21; } if (!$user) { $user = 'anonymous'; } if (!$pass) { $pass = ''; } $ftpid = null; switch ($sch) { case 'ftp': $ftpid = @ftp_connect($server, $port); break; case 'ftps': $ftpid = @ftp_ssl_connect($server, $port); break; } if (!$ftpid) { return false; } $login = @ftp_login($ftpid, $user, $pass); if (!$login) { return false; } $ftpsize = ftp_size($ftpid, $path); ftp_close($ftpid); if ($ftpsize == -1) { return false; } return $ftpsize; } } /** * Quick FTP chmod * * @param string $url Link identifier * @param integer $mode The new permissions, given as an octal value. * * @return integer|boolean * * @link https://www.php.net/manual/en/function.ftp-chmod.php * @since 1.0 */ public static function ftpChmod($url, $mode) { $sch = parse_url($url, \PHP_URL_SCHEME); if (($sch != 'ftp') && ($sch != 'ftps')) { return false; } $server = parse_url($url, \PHP_URL_HOST); $port = parse_url($url, \PHP_URL_PORT); $path = parse_url($url, \PHP_URL_PATH); $user = parse_url($url, \PHP_URL_USER); $pass = parse_url($url, \PHP_URL_PASS); if ((!$server) || (!$path)) { return false; } if (!$port) { $port = 21; } if (!$user) { $user = 'anonymous'; } if (!$pass) { $pass = ''; } $ftpid = null; switch ($sch) { case 'ftp': $ftpid = @ftp_connect($server, $port); break; case 'ftps': $ftpid = @ftp_ssl_connect($server, $port); break; } if (!$ftpid) { return false; } $login = @ftp_login($ftpid, $user, $pass); if (!$login) { return false; } $res = @ftp_chmod($ftpid, $mode, $path); ftp_close($ftpid); return $res; } /** * Modes that require a write operation * * @return array * * @since 1.0 */ public static function getWriteModes() { return ['w', 'w+', 'a', 'a+', 'r+', 'x', 'x+']; } /** * Stream and Filter Support Operations * * Returns the supported streams, in addition to direct file access * Also includes Joomla! streams as well as PHP streams * * @return array Streams * * @since 1.0 */ public static function getSupported() { // Really quite cool what php can do with arrays when you let it... static $streams; if (!$streams) { $streams = array_merge(stream_get_wrappers(), self::getJStreams()); } return $streams; } /** * Returns a list of transports * * @return array * * @since 1.0 */ public static function getTransports() { // Is this overkill? return stream_get_transports(); } /** * Returns a list of filters * * @return array * * @since 1.0 */ public static function getFilters() { // Note: This will look like the getSupported() function with J! filters. // TODO: add user space filter loading like user space stream loading return stream_get_filters(); } /** * Returns a list of J! streams * * @return array * * @since 1.0 */ public static function getJStreams() { static $streams = []; if (!$streams) { $files = new \DirectoryIterator(__DIR__ . '/Stream'); /** @var $file \DirectoryIterator */ foreach ($files as $file) { // Only load for php files. if (!$file->isFile() || $file->getExtension() != 'php') { continue; } $streams[] = $file->getBasename('.php'); } } return $streams; } /** * Determine if a stream is a Joomla stream. * * @param string $streamname The name of a stream * * @return boolean True for a Joomla Stream * * @since 1.0 */ public static function isJoomlaStream($streamname) { return \in_array($streamname, self::getJStreams()); } } PK c�\k|�n# # filesystem/src/Path.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem; use Joomla\Filesystem\Exception\FilesystemException; /** * A Path handling class * * @since 1.0 */ class Path { /** * Checks if a path's permissions can be changed. * * @param string $path Path to check. * * @return boolean True if path can have mode changed. * * @since 1.0 */ public static function canChmod($path) { if (!file_exists($path)) { return false; } $perms = @fileperms($path); if ($perms !== false) { if (@chmod($path, $perms ^ 0001)) { @chmod($path, $perms); return true; } } return false; } /** * Chmods files and directories recursively to given permissions. * * @param string $path Root path to begin changing mode [without trailing slash]. * @param string $filemode Octal representation of the value to change file mode to [null = no change]. * @param string $foldermode Octal representation of the value to change folder mode to [null = no change]. * * @return boolean True if successful [one fail means the whole operation failed]. * * @since 1.0 */ public static function setPermissions($path, $filemode = '0644', $foldermode = '0755') { // Initialise return value $ret = true; if (is_dir($path)) { $dh = @opendir($path); if ($dh) { while ($file = readdir($dh)) { if ($file != '.' && $file != '..') { $fullpath = $path . '/' . $file; if (is_dir($fullpath)) { if (!static::setPermissions($fullpath, $filemode, $foldermode)) { $ret = false; } } else { if (isset($filemode)) { if (!static::canChmod($fullpath) || !@ chmod($fullpath, octdec($filemode))) { $ret = false; } } } } } closedir($dh); } if (isset($foldermode)) { if (!static::canChmod($path) || !@ chmod($path, octdec($foldermode))) { $ret = false; } } } else { if (isset($filemode)) { if (!static::canChmod($path) || !@ chmod($path, octdec($filemode))) { $ret = false; } } } return $ret; } /** * Get the permissions of the file/folder at a give path. * * @param string $path The path of a file/folder. * * @return string Filesystem permissions. * * @since 1.0 */ public static function getPermissions($path) { $path = self::clean($path); $mode = @ decoct(@ fileperms($path) & 0777); if (\strlen($mode) < 3) { return '---------'; } $parsedMode = ''; for ($i = 0; $i < 3; $i++) { // Read $parsedMode .= ($mode[$i] & 04) ? 'r' : '-'; // Write $parsedMode .= ($mode[$i] & 02) ? 'w' : '-'; // Execute $parsedMode .= ($mode[$i] & 01) ? 'x' : '-'; } return $parsedMode; } /** * Checks for snooping outside of the file system root. * * @param string $path A file system path to check. * @param string $basePath The base path of the system * * @return string A cleaned version of the path or exit on error. * * @since 1.0 * @throws FilesystemException */ public static function check($path, $basePath = '') { if (strpos($path, '..') !== false) { throw new FilesystemException( sprintf( '%s() - Use of relative paths not permitted', __METHOD__ ), 20 ); } $path = static::clean($path); // If a base path is defined then check the cleaned path is not outside of root if (($basePath != '') && strpos($path, static::clean($basePath)) !== 0) { throw new FilesystemException( sprintf( '%1$s() - Snooping out of bounds @ %2$s', __METHOD__, $path ), 20 ); } return $path; } /** * Function to strip additional / or \ in a path name. * * @param string $path The path to clean. * @param string $ds Directory separator (optional). * * @return string The cleaned path. * * @since 1.0 * @throws \UnexpectedValueException If $path is not a string. */ public static function clean($path, $ds = \DIRECTORY_SEPARATOR) { if (!\is_string($path)) { throw new \InvalidArgumentException('You must specify a non-empty path to clean'); } $stream = explode('://', $path, 2); $scheme = ''; $path = $stream[0]; if (\count($stream) >= 2) { $scheme = $stream[0] . '://'; $path = $stream[1]; } $path = trim($path); // Remove double slashes and backslashes and convert all slashes and backslashes to DIRECTORY_SEPARATOR // If dealing with a UNC path don't forget to prepend the path with a backslash. if (($ds == '\\') && ($path[0] == '\\') && ($path[1] == '\\')) { $path = '\\' . preg_replace('#[/\\\\]+#', $ds, $path); } else { $path = preg_replace('#[/\\\\]+#', $ds, $path); } return $scheme . $path; } /** * Method to determine if script owns the path. * * @param string $path Path to check ownership. * * @return boolean True if the php script owns the path passed. * * @since 1.0 */ public static function isOwner($path) { $tmp = md5(random_bytes(16)); $ssp = ini_get('session.save_path'); // Try to find a writable directory $dir = is_writable('/tmp') ? '/tmp' : false; $dir = !$dir && is_writable('.') ? '.' : $dir; $dir = !$dir && is_writable($ssp) ? $ssp : $dir; if ($dir) { $test = $dir . '/' . $tmp; // Create the test file $blank = ''; File::write($test, $blank, false); // Test ownership $return = fileowner($test) === fileowner($path); // Delete the test file File::delete($test); return $return; } return false; } /** * Searches the directory paths for a given file. * * @param mixed $paths A path string or array of path strings to search in * @param string $file The file name to look for. * * @return string|boolean The full path and file name for the target file, or boolean false if the file is not found in any of the paths. * * @since 1.0 */ public static function find($paths, $file) { // Force to array if (!\is_array($paths) && !($paths instanceof \Iterator)) { settype($paths, 'array'); } // Start looping through the path set foreach ($paths as $path) { // Get the path to the file $fullname = $path . '/' . $file; // Is the path based on a stream? if (strpos($path, '://') === false) { // Not a stream, so do a realpath() to avoid directory // traversal attempts on the local file system. // Needed for substr() later $path = realpath($path); $fullname = realpath($fullname); } /* * The substr() check added to make sure that the realpath() * results in a directory registered so that * non-registered directories are not accessible via directory * traversal attempts. */ if (file_exists($fullname) && substr($fullname, 0, \strlen($path)) == $path) { return $fullname; } } // Could not find the file in the set of paths return false; } /** * Resolves /./, /../ and multiple / in a string and returns the resulting absolute path, inspired by Flysystem * Removes trailing slashes * * @param string $path A path to resolve * * @return string The resolved path * * @since 1.6.0 */ public static function resolve($path) { $path = static::clean($path); // Save start character for absolute path $startCharacter = ($path[0] === DIRECTORY_SEPARATOR) ? DIRECTORY_SEPARATOR : ''; $parts = array(); foreach (explode(DIRECTORY_SEPARATOR, $path) as $part) { switch ($part) { case '': case '.': break; case '..': if (empty($parts)) { throw new FilesystemException('Path is outside of the defined root'); } array_pop($parts); break; default: $parts[] = $part; break; } } return $startCharacter . implode(DIRECTORY_SEPARATOR, $parts); } /** * Remove all references to root directory path and the system tmp path from a message * * @param string $message The message to be cleaned * @param string $rootDirectory Optional root directory, defaults to JPATH_ROOT * * @return string * @since 2.0.1 */ public static function removeRoot($message, $rootDirectory = null) { if (empty($rootDirectory)) { $rootDirectory = JPATH_ROOT; } $makePattern = static function ($dir) { return '~' . str_replace('~', '\\~', preg_replace('~[/\\\\]+~', '.', $dir)) . '~'; }; $replacements = [ $makePattern(static::clean($rootDirectory)) => '[ROOT]', $makePattern(sys_get_temp_dir()) => '[TMP]', ]; return preg_replace(array_keys($replacements), array_values($replacements), $message); } } PK c�\��(c c filesystem/src/Buffer.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem; /** * 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. * * @since 1.0 */ class Buffer { /** * Stream position * * @var integer * @since 1.0 */ public $position = 0; /** * Buffer name * * @var string * @since 1.0 */ public $name; /** * Buffer hash * * @var array * @since 1.0 */ 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 $openedPath Full path of the resource. Used with STREAN_USE_PATH option * * @return boolean * * @since 1.0 * @see streamWrapper::stream_open */ public function stream_open($path, $mode, $options, &$openedPath) { $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 * @since 1.0 */ 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 * @since 1.0 */ 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 * @since 1.0 */ 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 * @since 1.0 */ 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 * @since 1.0 */ 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; } return false; case \SEEK_CUR: if ($offset >= 0) { $this->position += $offset; return true; } return false; case \SEEK_END: if (\strlen($this->buffers[$this->name]) + $offset >= 0) { $this->position = \strlen($this->buffers[$this->name]) + $offset; return true; } return false; default: return false; } } } // Register the stream stream_wrapper_register('buffer', 'Joomla\\Filesystem\\Buffer'); PK c�\�]sf� � filesystem/src/Stream.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem; use Joomla\Filesystem\Exception\FilesystemException; /** * Joomla! Stream Interface * * The Joomla! stream interface is designed to handle files as streams * where as the legacy JFile static class treated files in a rather * atomic manner. * * This class adheres to the stream wrapper operations: * * @link https://www.php.net/manual/en/function.stream-get-wrappers.php * @link https://www.php.net/manual/en/intro.stream.php PHP Stream Manual * @link https://www.php.net/manual/en/wrappers.php Stream Wrappers * @link https://www.php.net/manual/en/filters.php Stream Filters * @link https://www.php.net/manual/en/transports.php Socket Transports (used by some options, particularly HTTP proxy) * @since 1.0 */ class Stream { /** * File Mode * * @var integer * @since 1.0 */ protected $filemode = 0644; /** * Directory Mode * * @var integer * @since 1.0 */ protected $dirmode = 0755; /** * Default Chunk Size * * @var integer * @since 1.0 */ protected $chunksize = 8192; /** * Filename * * @var string * @since 1.0 */ protected $filename; /** * Prefix of the connection for writing * * @var string * @since 1.0 */ protected $writeprefix; /** * Prefix of the connection for reading * * @var string * @since 1.0 */ protected $readprefix; /** * Read Processing method * * @var string gz, bz, f * If a scheme is detected, fopen will be defaulted * To use compression with a network stream use a filter * @since 1.0 */ protected $processingmethod = 'f'; /** * Filters applied to the current stream * * @var array * @since 1.0 */ protected $filters = []; /** * File Handle * * @var resource * @since 1.0 */ protected $fh; /** * File size * * @var integer * @since 1.0 */ protected $filesize; /** * Context to use when opening the connection * * @var string * @since 1.0 */ protected $context; /** * Context options; used to rebuild the context * * @var array * @since 1.0 */ protected $contextOptions; /** * The mode under which the file was opened * * @var string * @since 1.0 */ protected $openmode; /** * Constructor * * @param string $writeprefix Prefix of the stream (optional). Unlike the JPATH_*, this has a final path separator! * @param string $readprefix The read prefix (optional). * @param array $context The context options (optional). * * @since 1.0 */ public function __construct($writeprefix = '', $readprefix = '', $context = []) { $this->writeprefix = $writeprefix; $this->readprefix = $readprefix; $this->contextOptions = $context; $this->_buildContext(); } /** * Destructor * * @since 1.0 */ public function __destruct() { // Attempt to close on destruction if there is a file handle if ($this->fh) { @$this->close(); } } /** * Creates a new stream object with appropriate prefix * * @param boolean $usePrefix Prefix the connections for writing * @param string $ua UA User agent to use * @param boolean $uamask User agent masking (prefix Mozilla) * * @return Stream * * @see Stream * @since 1.0 */ public static function getStream($usePrefix = true, $ua = null, $uamask = false) { // Setup the context; Joomla! UA and overwrite $context = []; // Set the UA for HTTP $context['http']['user_agent'] = $ua ?: 'Joomla! Framework Stream'; if ($usePrefix) { return new static(JPATH_ROOT . '/', JPATH_ROOT, $context); } return new static('', '', $context); } /** * Generic File Operations * * Open a stream with some lazy loading smarts * * @param string $filename Filename * @param string $mode Mode string to use * @param boolean $useIncludePath Use the PHP include path * @param resource $context Context to use when opening * @param boolean $usePrefix Use a prefix to open the file * @param boolean $relative Filename is a relative path (if false, strips JPATH_ROOT to make it relative) * @param boolean $detectprocessingmode Detect the processing method for the file and use the appropriate function * to handle output automatically * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function open($filename, $mode = 'r', $useIncludePath = false, $context = null, $usePrefix = false, $relative = false, $detectprocessingmode = false ) { $filename = $this->_getFilename($filename, $mode, $usePrefix, $relative); if (!$filename) { throw new FilesystemException('Filename not set'); } $this->filename = $filename; $this->openmode = $mode; $url = parse_url($filename); if (isset($url['scheme'])) { $scheme = ucfirst($url['scheme']); // Map to StringWrapper if required if ($scheme === 'String') { $scheme = 'StringWrapper'; } // If we're dealing with a Joomla! stream, load it if (Helper::isJoomlaStream($scheme)) { require_once __DIR__ . '/Stream/' . $scheme . '.php'; } // We have a scheme! force the method to be f $this->processingmethod = 'f'; } elseif ($detectprocessingmode) { $ext = strtolower(pathinfo($this->filename, \PATHINFO_EXTENSION)); switch ($ext) { case 'tgz': case 'gz': case 'gzip': $this->processingmethod = 'gz'; break; case 'tbz2': case 'bz2': case 'bzip2': $this->processingmethod = 'bz'; break; default: $this->processingmethod = 'f'; break; } } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } // Decide which context to use: switch ($this->processingmethod) { // Gzip doesn't support contexts or streams case 'gz': $this->fh = gzopen($filename, $mode, $useIncludePath); break; // Bzip2 is much like gzip except it doesn't use the include path case 'bz': $this->fh = bzopen($filename, $mode); break; // Fopen can handle streams case 'f': default: // One supplied at open; overrides everything if ($context) { $this->fh = @fopen($filename, $mode, $useIncludePath, $context); } elseif ($this->context) { // One provided at initialisation $this->fh = @fopen($filename, $mode, $useIncludePath, $this->context); } else { // No context; all defaults $this->fh = @fopen($filename, $mode, $useIncludePath); } break; } if (!$this->fh) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => sprintf('Unknown error opening file %s', $filename) ); } throw new FilesystemException($error['message']); } // Return the result return true; } /** * Attempt to close a file handle * * Will return false if it failed and true on success * If the file is not open the system will return true, this function destroys the file handle as well * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function close() { if (!$this->fh) { throw new FilesystemException('File not open'); } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } switch ($this->processingmethod) { case 'gz': $res = gzclose($this->fh); break; case 'bz': $res = bzclose($this->fh); break; case 'f': default: $res = fclose($this->fh); break; } if (!$res) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to close stream' ); } throw new FilesystemException($error['message']); } // Reset this $this->fh = null; // If we wrote, chmod the file after it's closed if ($this->openmode[0] == 'w') { $this->chmod(); } // Return the result return true; } /** * Work out if we're at the end of the file for a stream * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function eof() { if (!$this->fh) { throw new FilesystemException('File not open'); } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } switch ($this->processingmethod) { case 'gz': $res = gzeof($this->fh); break; case 'bz': case 'f': default: $res = feof($this->fh); break; } $error = error_get_last(); if ($error !== null && $error['message'] !== '') { throw new FilesystemException($error['message']); } // Return the result return $res; } /** * Retrieve the file size of the path * * @return integer|boolean * * @since 1.0 * @throws FilesystemException */ public function filesize() { if (!$this->filename) { throw new FilesystemException('File not open'); } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $res = @filesize($this->filename); if (!$res) { $res = Helper::remotefsize($this->filename); } if (!$res) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Failed to get file size. This may not work for all streams.' ); } throw new FilesystemException($error['message']); } $this->filesize = $res; // Return the result return $this->filesize; } /** * Get a line from the stream source. * * @param integer $length The number of bytes (optional) to read. * * @return string * * @since 1.0 * @throws FilesystemException */ public function gets($length = 0) { if (!$this->fh) { throw new FilesystemException('File not open'); } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } switch ($this->processingmethod) { case 'gz': $res = $length ? gzgets($this->fh, $length) : gzgets($this->fh); break; case 'bz': case 'f': default: $res = $length ? fgets($this->fh, $length) : fgets($this->fh); break; } if (!$res) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to read from stream' ); } throw new FilesystemException($error['message']); } // Return the result return $res; } /** * Read a file * * Handles user space streams appropriately otherwise any read will return 8192 * * @param integer $length Length of data to read * * @return string * * @link https://www.php.net/manual/en/function.fread.php * @since 1.0 * @throws FilesystemException */ public function read($length = 0) { if (!$this->fh) { throw new FilesystemException('File not open'); } if (!$this->filesize && !$length) { // Get the filesize $this->filesize(); if (!$this->filesize) { // Set it to the biggest and then wait until eof $length = -1; } else { $length = $this->filesize; } } $retval = false; // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $remaining = $length; do { // Do chunked reads where relevant switch ($this->processingmethod) { case 'bz': $res = ($remaining > 0) ? bzread($this->fh, $remaining) : bzread($this->fh, $this->chunksize); break; case 'gz': $res = ($remaining > 0) ? gzread($this->fh, $remaining) : gzread($this->fh, $this->chunksize); break; case 'f': default: $res = ($remaining > 0) ? fread($this->fh, $remaining) : fread($this->fh, $this->chunksize); break; } if (!$res) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to read from stream' ); } throw new FilesystemException($error['message']); } if (!$retval) { $retval = ''; } $retval .= $res; if (!$this->eof()) { $len = \strlen($res); $remaining -= $len; } else { // If it's the end of the file then we've nothing left to read; reset remaining and len $remaining = 0; $length = \strlen($retval); } } while ($remaining || !$length); // Return the result return $retval; } /** * Seek the file * * Note: the return value is different to that of fseek * * @param integer $offset Offset to use when seeking. * @param integer $whence Seek mode to use. * * @return boolean True on success, false on failure * * @link https://www.php.net/manual/en/function.fseek.php * @since 1.0 * @throws FilesystemException */ public function seek($offset, $whence = \SEEK_SET) { if (!$this->fh) { throw new FilesystemException('File not open'); } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } switch ($this->processingmethod) { case 'gz': $res = gzseek($this->fh, $offset, $whence); break; case 'bz': case 'f': default: $res = fseek($this->fh, $offset, $whence); break; } // Seek, interestingly, returns 0 on success or -1 on failure. if ($res == -1) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to seek in stream' ); } throw new FilesystemException($error['message']); } // Return the result return true; } /** * Returns the current position of the file read/write pointer. * * @return integer * * @since 1.0 * @throws FilesystemException */ public function tell() { if (!$this->fh) { throw new FilesystemException('File not open'); } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } switch ($this->processingmethod) { case 'gz': $res = gztell($this->fh); break; case 'bz': case 'f': default: $res = ftell($this->fh); break; } // May return 0 so check if it's really false if ($res === false) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to determine the current position in stream' ); } throw new FilesystemException($error['message']); } // Return the result return $res; } /** * File write * * Whilst this function accepts a reference, the underlying fwrite * will do a copy! This will roughly double the memory allocation for * any write you do. Specifying chunked will get around this by only * writing in specific chunk sizes. This defaults to 8192 which is a * sane number to use most of the time (change the default with * Stream::set('chunksize', newsize);) * Note: This doesn't support gzip/bzip2 writing like reading does * * @param string $string Reference to the string to write. * @param integer $length Length of the string to write. * @param integer $chunk Size of chunks to write in. * * @return boolean * * @link https://www.php.net/manual/en/function.fwrite.php * @since 1.0 * @throws FilesystemException */ public function write(&$string, $length = 0, $chunk = 0) { if (!$this->fh) { throw new FilesystemException('File not open'); } if ($this->openmode == 'r') { throw new \RuntimeException('File is in readonly mode'); } // If the length isn't set, set it to the length of the string. if (!$length) { $length = \strlen($string); } // If the chunk isn't set, set it to the default. if (!$chunk) { $chunk = $this->chunksize; } $retval = true; // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $remaining = $length; $start = 0; do { // If the amount remaining is greater than the chunk size, then use the chunk $amount = ($remaining > $chunk) ? $chunk : $remaining; $res = fwrite($this->fh, substr($string, $start), $amount); // Returns false on error or the number of bytes written if ($res === false) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to write to stream' ); } throw new FilesystemException($error['message']); } if ($res === 0) { // Wrote nothing? throw new FilesystemException('Warning: No data written'); } // Wrote something $start += $amount; $remaining -= $res; } while ($remaining); // Return the result return $retval; } /** * Chmod wrapper * * @param string $filename File name. * @param mixed $mode Mode to use. * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function chmod($filename = '', $mode = 0) { if (!$filename) { if (!isset($this->filename) || !$this->filename) { throw new FilesystemException('Filename not set'); } $filename = $this->filename; } // If no mode is set use the default if (!$mode) { $mode = $this->filemode; } // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $sch = parse_url($filename, \PHP_URL_SCHEME); // Scheme specific options; ftp's chmod support is fun. switch ($sch) { case 'ftp': case 'ftps': $res = Helper::ftpChmod($filename, $mode); break; default: $res = chmod($filename, $mode); break; } if ($res === false) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to change mode of stream' ); } throw new FilesystemException($error['message']); } // Return the result return true; } /** * Get the stream metadata * * @return array header/metadata * * @link https://www.php.net/manual/en/function.stream-get-meta-data.php * @since 1.0 * @throws FilesystemException */ public function get_meta_data() { if (!$this->fh) { throw new FilesystemException('File not open'); } return stream_get_meta_data($this->fh); } /** * Stream contexts * Builds the context from the array * * @return void * * @since 1.0 */ public function _buildContext() { // According to the manual this always works! if (\count($this->contextOptions)) { $this->context = @stream_context_create($this->contextOptions); } else { $this->context = null; } } /** * Updates the context to the array * * Format is the same as the options for stream_context_create * * @param array $context Options to create the context with * * @return void * * @link https://www.php.net/stream_context_create * @since 1.0 */ public function setContextOptions($context) { $this->contextOptions = $context; $this->_buildContext(); } /** * Adds a particular options to the context * * @param string $wrapper The wrapper to use * @param string $name The option to set * @param string $value The value of the option * * @return void * * @link https://www.php.net/stream_context_create Stream Context Creation * @link https://www.php.net/manual/en/context.php Context Options for various streams * @since 1.0 */ public function addContextEntry($wrapper, $name, $value) { $this->contextOptions[$wrapper][$name] = $value; $this->_buildContext(); } /** * Deletes a particular setting from a context * * @param string $wrapper The wrapper to use * @param string $name The option to unset * * @return void * * @link https://www.php.net/stream_context_create * @since 1.0 */ public function deleteContextEntry($wrapper, $name) { // Check whether the wrapper is set if (isset($this->contextOptions[$wrapper])) { // Check that entry is set for that wrapper if (isset($this->contextOptions[$wrapper][$name])) { // Unset the item unset($this->contextOptions[$wrapper][$name]); // Check that there are still items there if (!\count($this->contextOptions[$wrapper])) { // Clean up an empty wrapper context option unset($this->contextOptions[$wrapper]); } } } // Rebuild the context and apply it to the stream $this->_buildContext(); } /** * Applies the current context to the stream * * Use this to change the values of the context after you've opened a stream * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function applyContextToStream() { $retval = false; if ($this->fh) { // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $retval = @stream_context_set_option($this->fh, $this->contextOptions); if (!$retval) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to apply context to stream' ); } throw new FilesystemException($error['message']); } } return $retval; } /** * Stream filters * Append a filter to the chain * * @param string $filtername The key name of the filter. * @param integer $readWrite Optional. Defaults to STREAM_FILTER_READ. * @param array $params An array of params for the stream_filter_append call. * * @return resource|boolean * * @link https://www.php.net/manual/en/function.stream-filter-append.php * @since 1.0 * @throws FilesystemException */ public function appendFilter($filtername, $readWrite = \STREAM_FILTER_READ, $params = []) { $res = false; if ($this->fh) { // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $res = @stream_filter_append($this->fh, $filtername, $readWrite, $params); if (!$res) { $error = error_get_last(); if ($error !== null && $error['message'] !== '') { throw new FilesystemException($error['message']); } } $this->filters[] = &$res; } return $res; } /** * Prepend a filter to the chain * * @param string $filtername The key name of the filter. * @param integer $readWrite Optional. Defaults to STREAM_FILTER_READ. * @param array $params An array of params for the stream_filter_prepend call. * * @return resource|boolean * * @link https://www.php.net/manual/en/function.stream-filter-prepend.php * @since 1.0 * @throws FilesystemException */ public function prependFilter($filtername, $readWrite = \STREAM_FILTER_READ, $params = []) { $res = false; if ($this->fh) { // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $res = @stream_filter_prepend($this->fh, $filtername, $readWrite, $params); if (!$res) { $error = error_get_last(); if ($error !== null && $error['message'] !== '') { throw new FilesystemException($error['message']); } } array_unshift($this->filters, ''); $this->filters[0] = &$res; } return $res; } /** * Remove a filter, either by resource (handed out from the append or prepend function) * or via getting the filter list) * * @param resource $resource The resource. * @param boolean $byindex The index of the filter. * * @return boolean Result of operation * * @since 1.0 * @throws FilesystemException */ public function removeFilter(&$resource, $byindex = false) { // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } if ($byindex) { $res = stream_filter_remove($this->filters[$resource]); } else { $res = stream_filter_remove($resource); } if (!$res) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to remove filter from stream' ); } throw new FilesystemException($error['message']); } return $res; } /** * Copy a file from src to dest * * @param string $src The file path to copy from. * @param string $dest The file path to copy to. * @param resource $context A valid context resource (optional) created with stream_context_create. * @param boolean $usePrefix Controls the use of a prefix (optional). * @param boolean $relative Determines if the filename given is relative. Relative paths do not have JPATH_ROOT stripped. * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function copy($src, $dest, $context = null, $usePrefix = true, $relative = false) { // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $chmodDest = $this->_getFilename($dest, 'w', $usePrefix, $relative); // Since we're going to open the file directly we need to get the filename. // We need to use the same prefix so force everything to write. $src = $this->_getFilename($src, 'w', $usePrefix, $relative); $dest = $this->_getFilename($dest, 'w', $usePrefix, $relative); // One supplied at copy; overrides everything if ($context) { // Use the provided context $res = @copy($src, $dest, $context); } elseif ($this->context) { // One provided at initialisation $res = @copy($src, $dest, $this->context); } else { // No context; all defaults $res = @copy($src, $dest); } if (!$res) { $error = error_get_last(); if ($error !== null && $error['message'] !== '') { throw new FilesystemException($error['message']); } } $this->chmod($chmodDest); return $res; } /** * Moves a file * * @param string $src The file path to move from. * @param string $dest The file path to move to. * @param resource $context A valid context resource (optional) created with stream_context_create. * @param boolean $usePrefix Controls the use of a prefix (optional). * @param boolean $relative Determines if the filename given is relative. Relative paths do not have JPATH_ROOT stripped. * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function move($src, $dest, $context = null, $usePrefix = true, $relative = false) { // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $src = $this->_getFilename($src, 'w', $usePrefix, $relative); $dest = $this->_getFilename($dest, 'w', $usePrefix, $relative); if ($context) { // Use the provided context $res = @rename($src, $dest, $context); } elseif ($this->context) { // Use the object's context $res = @rename($src, $dest, $this->context); } else { // Don't use any context $res = @rename($src, $dest); } if (!$res) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to move stream' ); } throw new FilesystemException($error['message']); } $this->chmod($dest); return $res; } /** * Delete a file * * @param string $filename The file path to delete. * @param resource $context A valid context resource (optional) created with stream_context_create. * @param boolean $usePrefix Controls the use of a prefix (optional). * @param boolean $relative Determines if the filename given is relative. Relative paths do not have JPATH_ROOT stripped. * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function delete($filename, $context = null, $usePrefix = true, $relative = false) { // Capture PHP errors if (PHP_VERSION_ID < 70000) { // @Todo Remove this path, when PHP5 support is dropped. set_error_handler( function () { return false; } ); @trigger_error(''); restore_error_handler(); } else { /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ error_clear_last(); } $filename = $this->_getFilename($filename, 'w', $usePrefix, $relative); if ($context) { // Use the provided context $res = @unlink($filename, $context); } elseif ($this->context) { // Use the object's context $res = @unlink($filename, $this->context); } else { // Don't use any context $res = @unlink($filename); } if (!$res) { $error = error_get_last(); if ($error === null || $error['message'] === '') { // Error but nothing from php? Create our own $error = array( 'message' => 'Unable to delete stream' ); } throw new FilesystemException($error['message']); } return $res; } /** * Upload a file * * @param string $src The file path to copy from (usually a temp folder). * @param string $dest The file path to copy to. * @param resource $context A valid context resource (optional) created with stream_context_create. * @param boolean $usePrefix Controls the use of a prefix (optional). * @param boolean $relative Determines if the filename given is relative. Relative paths do not have JPATH_ROOT stripped. * * @return boolean * * @since 1.0 * @throws FilesystemException */ public function upload($src, $dest, $context = null, $usePrefix = true, $relative = false) { if (is_uploaded_file($src)) { // Make sure it's an uploaded file return $this->copy($src, $dest, $context, $usePrefix, $relative); } throw new FilesystemException('Not an uploaded file.'); } /** * Writes a chunk of data to a file. * * @param string $filename The file name. * @param string $buffer The data to write to the file. * @param boolean $appendToFile Append to the file and not overwrite it. * * @return boolean * * @since 1.0 */ public function writeFile($filename, &$buffer, $appendToFile = false) { $fileMode = 'w'; // Switch the filemode when we want to append to the file if ($appendToFile) { $fileMode = 'a'; } if ($this->open($filename, $fileMode)) { $result = $this->write($buffer); $this->chmod(); $this->close(); return $result; } return false; } /** * Determine the appropriate 'filename' of a file * * @param string $filename Original filename of the file * @param string $mode Mode string to retrieve the filename * @param boolean $usePrefix Controls the use of a prefix * @param boolean $relative Determines if the filename given is relative. Relative paths do not have JPATH_ROOT stripped. * * @return string * * @since 1.0 */ public function _getFilename($filename, $mode, $usePrefix, $relative) { if ($usePrefix) { // Get rid of binary or t, should be at the end of the string $tmode = trim($mode, 'btf123456789'); $stream = explode('://', $filename, 2); $scheme = ''; $filename = $stream[0]; if (\count($stream) >= 2) { $scheme = $stream[0] . '://'; $filename = $stream[1]; } // Check if it's a write mode then add the appropriate prefix if (\in_array($tmode, Helper::getWriteModes())) { $prefixToUse = $this->writeprefix; } else { $prefixToUse = $this->readprefix; } // Get rid of JPATH_ROOT (legacy compat) if (!$relative && $prefixToUse) { $pos = strpos($filename, JPATH_ROOT); if ($pos !== false) { $filename = substr_replace($filename, '', $pos, \strlen(JPATH_ROOT)); } } $filename = ($prefixToUse ? $prefixToUse : '') . $filename; } return $filename; } /** * Return the internal file handle * * @return File handler * * @since 1.0 */ public function getFileHandle() { return $this->fh; } /** * Modifies a property of the object, creating it if it does not already exist. * * @param string $property The name of the property. * @param mixed $value The value of the property to set. * * @return mixed Previous value of the property. * * @since 1.0 */ public function set($property, $value = null) { $previous = $this->$property ?? null; $this->$property = $value; return $previous; } /** * Returns a property of the object or the default value if the property is not set. * * @param string $property The name of the property. * @param mixed $default The default value. * * @return mixed The value of the property. * * @since 1.0 */ public function get($property, $default = null) { if (isset($this->$property)) { return $this->$property; } return $default; } } PK c�\�ǡq@- @- filesystem/src/Patcher.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem; /** * A Unified Diff Format Patcher class * * @link http://sourceforge.net/projects/phppatcher/ This has been derived from the PhpPatcher version 0.1.1 written by Giuseppe Mazzotta * @since 1.0 */ class Patcher { /** * Regular expression for searching source files * * @var string * @since 1.0 */ const SRC_FILE = '/^---\\s+(\\S+)\s+\\d{1,4}-\\d{1,2}-\\d{1,2}\\s+\\d{1,2}:\\d{1,2}:\\d{1,2}(\\.\\d+)?\\s+(\+|-)\\d{4}/A'; /** * Regular expression for searching destination files * * @var string * @since 1.0 */ const DST_FILE = '/^\\+\\+\\+\\s+(\\S+)\s+\\d{1,4}-\\d{1,2}-\\d{1,2}\\s+\\d{1,2}:\\d{1,2}:\\d{1,2}(\\.\\d+)?\\s+(\+|-)\\d{4}/A'; /** * Regular expression for searching hunks of differences * * @var string * @since 1.0 */ const HUNK = '/@@ -(\\d+)(,(\\d+))?\\s+\\+(\\d+)(,(\\d+))?\\s+@@($)/A'; /** * Regular expression for splitting lines * * @var string * @since 1.0 */ const SPLIT = '/(\r\n)|(\r)|(\n)/'; /** * Source files * * @var array * @since 1.0 */ protected $sources = []; /** * Destination files * * @var array * @since 1.0 */ protected $destinations = []; /** * Removal files * * @var array * @since 1.0 */ protected $removals = []; /** * Patches * * @var array * @since 1.0 */ protected $patches = []; /** * Singleton instance of this class * * @var Patcher * @since 1.0 */ protected static $instance; /** * Constructor * * The constructor is protected to force the use of Patcher::getInstance() * * @since 1.0 */ protected function __construct() { } /** * Method to get a patcher * * @return Patcher an instance of the patcher * * @since 1.0 */ public static function getInstance() { if (!isset(static::$instance)) { static::$instance = new static; } return static::$instance; } /** * Reset the pacher * * @return Patcher This object for chaining * * @since 1.0 */ public function reset() { $this->sources = []; $this->destinations = []; $this->removals = []; $this->patches = []; return $this; } /** * Apply the patches * * @return integer The number of files patched * * @since 1.0 * @throws \RuntimeException */ public function apply() { foreach ($this->patches as $patch) { // Separate the input into lines $lines = self::splitLines($patch['udiff']); // Loop for each header while (self::findHeader($lines, $src, $dst)) { $done = false; if ($patch['strip'] === null) { $src = $patch['root'] . preg_replace('#^([^/]*/)*#', '', $src); $dst = $patch['root'] . preg_replace('#^([^/]*/)*#', '', $dst); } else { $src = $patch['root'] . preg_replace('#^([^/]*/){' . (int) $patch['strip'] . '}#', '', $src); $dst = $patch['root'] . preg_replace('#^([^/]*/){' . (int) $patch['strip'] . '}#', '', $dst); } // Loop for each hunk of differences while (self::findHunk($lines, $srcLine, $srcSize, $dstLine, $dstSize)) { $done = true; // Apply the hunk of differences $this->applyHunk($lines, $src, $dst, $srcLine, $srcSize, $dstLine, $dstSize); } // If no modifications were found, throw an exception if (!$done) { throw new \RuntimeException('Invalid Diff'); } } } // Initialize the counter $done = 0; // Patch each destination file foreach ($this->destinations as $file => $content) { $content = implode("\n", $content); if (File::write($file, $content)) { if (isset($this->sources[$file])) { $this->sources[$file] = $content; } $done++; } } // Remove each removed file foreach ($this->removals as $file) { if (File::delete($file)) { if (isset($this->sources[$file])) { unset($this->sources[$file]); } $done++; } } // Clear the destinations cache $this->destinations = []; // Clear the removals $this->removals = []; // Clear the patches $this->patches = []; return $done; } /** * Add a unified diff file to the patcher * * @param string $filename Path to the unified diff file * @param string $root The files root path * @param integer $strip The number of '/' to strip * * @return Patcher $this for chaining * * @since 1.0 */ public function addFile($filename, $root, $strip = 0) { return $this->add(file_get_contents($filename), $root, $strip); } /** * Add a unified diff string to the patcher * * @param string $udiff Unified diff input string * @param string $root The files root path * @param integer $strip The number of '/' to strip * * @return Patcher $this for chaining * * @since 1.0 */ public function add($udiff, $root, $strip = 0) { $this->patches[] = [ 'udiff' => $udiff, 'root' => isset($root) ? rtrim($root, \DIRECTORY_SEPARATOR) . \DIRECTORY_SEPARATOR : '', 'strip' => $strip, ]; return $this; } /** * Separate CR or CRLF lines * * @param string $data Input string * * @return array The lines of the input destination file * * @since 1.0 */ protected static function splitLines($data) { return preg_split(self::SPLIT, $data); } /** * Find the diff header * * The internal array pointer of $lines is on the next line after the finding * * @param array $lines The udiff array of lines * @param string $src The source file * @param string $dst The destination file * * @return boolean TRUE in case of success, FALSE in case of failure * * @since 1.0 * @throws \RuntimeException */ protected static function findHeader(&$lines, &$src, &$dst) { // Get the current line $line = current($lines); // Search for the header while ($line !== false && !preg_match(self::SRC_FILE, $line, $m)) { $line = next($lines); } if ($line === false) { // No header found, return false return false; } // Set the source file $src = $m[1]; // Advance to the next line $line = next($lines); if ($line === false) { throw new \RuntimeException('Unexpected EOF'); } // Search the destination file if (!preg_match(self::DST_FILE, $line, $m)) { throw new \RuntimeException('Invalid Diff file'); } // Set the destination file $dst = $m[1]; // Advance to the next line if (next($lines) === false) { throw new \RuntimeException('Unexpected EOF'); } return true; } /** * Find the next hunk of difference * * The internal array pointer of $lines is on the next line after the finding * * @param array $lines The udiff array of lines * @param string $srcLine The beginning of the patch for the source file * @param string $srcSize The size of the patch for the source file * @param string $dstLine The beginning of the patch for the destination file * @param string $dstSize The size of the patch for the destination file * * @return boolean TRUE in case of success, false in case of failure * * @since 1.0 * @throws \RuntimeException */ protected static function findHunk(&$lines, &$srcLine, &$srcSize, &$dstLine, &$dstSize) { $line = current($lines); if (preg_match(self::HUNK, $line, $m)) { $srcLine = (int) $m[1]; if ($m[3] === '') { $srcSize = 1; } else { $srcSize = (int) $m[3]; } $dstLine = (int) $m[4]; if ($m[6] === '') { $dstSize = 1; } else { $dstSize = (int) $m[6]; } if (next($lines) === false) { throw new \RuntimeException('Unexpected EOF'); } return true; } return false; } /** * Apply the patch * * @param array $lines The udiff array of lines * @param string $src The source file * @param string $dst The destination file * @param string $srcLine The beginning of the patch for the source file * @param string $srcSize The size of the patch for the source file * @param string $dstLine The beginning of the patch for the destination file * @param string $dstSize The size of the patch for the destination file * * @return void * * @since 1.0 * @throws \RuntimeException */ protected function applyHunk(&$lines, $src, $dst, $srcLine, $srcSize, $dstLine, $dstSize) { $srcLine--; $dstLine--; $line = current($lines); // Source lines (old file) $source = []; // New lines (new file) $destin = []; $srcLeft = $srcSize; $dstLeft = $dstSize; do { if (!isset($line[0])) { $source[] = ''; $destin[] = ''; $srcLeft--; $dstLeft--; } elseif ($line[0] == '-') { if ($srcLeft == 0) { throw new \RuntimeException('Unexpected remove line at line ' . key($lines)); } $source[] = substr($line, 1); $srcLeft--; } elseif ($line[0] == '+') { if ($dstLeft == 0) { throw new \RuntimeException('Unexpected add line at line ' . key($lines)); } $destin[] = substr($line, 1); $dstLeft--; } elseif ($line != '\\ No newline at end of file') { $line = substr($line, 1); $source[] = $line; $destin[] = $line; $srcLeft--; $dstLeft--; } if ($srcLeft == 0 && $dstLeft == 0) { // Now apply the patch, finally! if ($srcSize > 0) { $srcLines = & $this->getSource($src); if (!isset($srcLines)) { throw new \RuntimeException( 'Unexisting source file: ' . Path::removeRoot($src) ); } } if ($dstSize > 0) { if ($srcSize > 0) { $dstLines = & $this->getDestination($dst, $src); $srcBottom = $srcLine + \count($source); for ($l = $srcLine; $l < $srcBottom; $l++) { if ($srcLines[$l] != $source[$l - $srcLine]) { throw new \RuntimeException( sprintf( 'Failed source verification of file %1$s at line %2$s', Path::removeRoot($src), $l ) ); } } array_splice($dstLines, $dstLine, \count($source), $destin); } else { $this->destinations[$dst] = $destin; } } else { $this->removals[] = $src; } next($lines); return; } $line = next($lines); } while ($line !== false); throw new \RuntimeException('Unexpected EOF'); } /** * Get the lines of a source file * * @param string $src The path of a file * * @return array The lines of the source file * * @since 1.0 */ protected function &getSource($src) { if (!isset($this->sources[$src])) { if (is_readable($src)) { $this->sources[$src] = self::splitLines(file_get_contents($src)); } else { $this->sources[$src] = null; } } return $this->sources[$src]; } /** * Get the lines of a destination file * * @param string $dst The path of a destination file * @param string $src The path of a source file * * @return array The lines of the destination file * * @since 1.0 */ protected function &getDestination($dst, $src) { if (!isset($this->destinations[$dst])) { $this->destinations[$dst] = $this->getSource($src); } return $this->destinations[$dst]; } } PK c�\q� � � + filesystem/src/Support/StringController.phpnu �[��� <?php /** * Part of the Joomla Framework Filesystem Package * * @copyright Copyright (C) 2005 - 2021 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE */ namespace Joomla\Filesystem\Support; /** * String Controller * * @since 1.0 */ class StringController { /** * Internal string references * * @var array * @ssince 1.4.0 */ private static $strings = []; /** * Defines a variable as an array * * @return array * * @since 1.0 * @deprecated 2.0 Use `getArray` instead. */ public static function _getArray() { return self::getArray(); } /** * Defines a variable as an array * * @return array * * @since 1.4.0 */ public static function getArray() { return self::$strings; } /** * Create a reference * * @param string $reference The key * @param string $string The value * * @return void * * @since 1.0 */ public static function createRef($reference, &$string) { self::$strings[$reference] = & $string; } /** * Get reference * * @param string $reference The key for the reference. * * @return mixed False if not set, reference if it exists * * @since 1.0 */ public static function getRef($reference) { if (isset(self::$strings[$reference])) { return self::$strings[$reference]; } return false; } } PK c�\����� � F filesystem/meta/language/en-GB/en-GB.lib_joomla_filesystem_patcher.ininu �[��� ; Joomla! Project ; Copyright (C) 2005 - 2016 Open Source Matters. All rights reserved. ; License GNU General Public License version 2 or later; see LICENSE.txt ; Note : All ini files need to be saved as UTF-8 - No BOM JLIB_FILESYSTEM_PATCHER_FAILED_VERIFY="Failed source verification of file %s at line %d" JLIB_FILESYSTEM_PATCHER_INVALID_DIFF="Invalid unified diff block" JLIB_FILESYSTEM_PATCHER_INVALID_INPUT="Invalid input" JLIB_FILESYSTEM_PATCHER_UNEXISING_SOURCE="Unexisting source file" JLIB_FILESYSTEM_PATCHER_UNEXPECTED_ADD_LINE="Unexpected add line at line %d'" JLIB_FILESYSTEM_PATCHER_UNEXPECTED_EOF="Unexpected end of file" JLIB_FILESYSTEM_PATCHER_UNEXPECTED_REMOVE_LINE="Unexpected remove line at line %d" PK c�\�P�E �E filesystem/LICENSEnu �[��� GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) 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 this service 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 make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. 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. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), 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 distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the 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 a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE 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. 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 convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) <year> <name of author> 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision 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, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This 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 Library General Public License instead of this License. PK �^�\�V� index.htmlnu &1i� PK �^�\��&�B B Y joomla.phpnu &1i� PK X`�\O]��C �C � src/Extension/Joomla.phpnu �[��� PK X`�\��P9� � �Z joomla.xmlnu �[��� PK X`�\�a0� � �a services/provider.phpnu �[��� PK c�\�P�E �E �g event/LICENSEnu �[��� PK c�\8�d�~ ~ �� event/src/EventInterface.phpnu �[��� PK c�\,�d�H H ! N� event/src/SubscriberInterface.phpnu �[��� PK c�\�� � event/src/Priority.phpnu �[��� PK c�\�Cu� � & F� event/src/DispatcherAwareInterface.phpnu �[��� PK c�\9���D D & +� event/src/LazyServiceEventListener.phpnu �[��� PK c�\��4Ƥ � �� event/src/Event.phpnu �[��� PK c�\�)�x $ �� event/src/ListenersPriorityQueue.phpnu �[��� PK c�\<j� � event/src/EventImmutable.phpnu �[��� PK c�\� �� ! ^� event/src/DispatcherInterface.phpnu �[��� PK c�\���� � .� event/src/AbstractEvent.phpnu �[��� PK c�\���J. J. C event/src/Dispatcher.phpnu �[��� PK c�\u��f f " �9 event/src/DispatcherAwareTrait.phpnu �[��� PK c�\���_� � 1 �> event/src/Command/DebugEventDispatcherCommand.phpnu �[��� PK c�\�M �R filter/PATCHES.txtnu �[��� PK c�\� �g �g T filter/src/InputFilter.phpnu �[��� PK c�\VAf� � � filter/src/OutputFilter.phpnu �[��� PK c�\�P�E �E U� filter/LICENSEnu �[��� PK c�\ma�o o + oauth1/.drone.ymlnu �[��� PK c�\�P�E �E �= oauth1/LICENSEnu �[��� PK c�\���<x6 x6 �� oauth1/src/Client.phpnu �[��� PK c�\�+�m� � n� oauth1/.drone.jsonnetnu �[��� PK c�\����s s G� crypt/src/Cipher/Sodium.phpnu �[��� PK c�\��{ { � crypt/src/Cipher/OpenSSL.phpnu �[��� PK c�\��#I� � �� crypt/src/Cipher/Crypto.phpnu �[��� PK c�\�m:z� � �� crypt/src/Key.phpnu �[��� PK c�\U��h� � � crypt/src/CipherInterface.phpnu �[��� PK c�\ Ab� � 2 � crypt/src/Exception/UnsupportedCipherException.phpnu �[��� PK c�\�_��8 8 / � crypt/src/Exception/InvalidKeyTypeException.phpnu �[��� PK c�\�>�� � + e crypt/src/Exception/InvalidKeyException.phpnu �[��� PK c�\V�-�� � + | crypt/src/Exception/EncryptionException.phpnu �[��� PK c�\�o3Í � / � crypt/src/Exception/CryptExceptionInterface.phpnu �[��� PK c�\�l�� � + r crypt/src/Exception/DecryptionException.phpnu �[��� PK c�\��h�y y | crypt/src/Crypt.phpnu �[��� PK c�\�P�E �E 8) crypt/LICENSEnu �[��� PK c�\�P�E �E o console/LICENSEnu �[��� PK c�\C�߯� � + � console/src/Event/ApplicationErrorEvent.phpnu �[��� PK c�\�^y�2 2 ' ;� console/src/Event/CommandErrorEvent.phpnu �[��� PK c�\ْ��� � $ �� console/src/Event/TerminateEvent.phpnu �[��� PK c�\NE� " � console/src/Event/ConsoleEvent.phpnu �[��� PK c�\�I�B� � / c� console/src/Event/BeforeCommandExecuteEvent.phpnu �[��� PK c�\0 ] ] �� console/src/ConsoleEvents.phpnu �[��� PK c�\ ��i i ' B� console/src/Helper/DescriptorHelper.phpnu �[��� PK c�\Q ��w w 1 � console/src/Descriptor/ApplicationDescription.phpnu �[��� PK c�\h��m� � ) � console/src/Descriptor/TextDescriptor.phpnu �[��� PK c�\O �j� � # � console/src/Command/ListCommand.phpnu �[��� PK c�\� # console/src/Command/HelpCommand.phpnu �[��� PK c�\��fE�1 �1 ' z& console/src/Command/AbstractCommand.phpnu �[��� PK c�\bs "� � 4 vX console/src/Exception/NamespaceNotFoundException.phpnu �[��� PK c�\Y)�U� U� �Z console/src/Application.phpnu �[��� PK c�\�U}; & ]� console/src/Loader/LoaderInterface.phpnu �[��� PK c�\;"�� & �� console/src/Loader/ContainerLoader.phpnu �[��� PK c�\S�ao o � console/.drone.ymlnu �[��� PK c�\�+�m� � � console/.drone.jsonnetnu �[��� PK c�\�P�E �E � uri/LICENSEnu �[��� PK c�\�+�m� � pZ uri/.drone.jsonnetnu �[��� PK c�\�/�1o o Fh uri/.drone.ymlnu �[��� PK c�\��"�� � � uri/src/Uri.phpnu �[��� PK c�\�$j�� � ϓ uri/src/UriImmutable.phpnu �[��� PK c�\��� �� uri/src/UriHelper.phpnu �[��� PK c�\� �!: : � uri/src/UriInterface.phpnu �[��� PK c�\b銦. . v� uri/src/AbstractUri.phpnu �[��� PK c�\K�u�o o �� oauth2/.drone.ymlnu �[��� PK c�\�P�E �E �� oauth2/LICENSEnu �[��� PK c�\�0��& �& q4 oauth2/src/Client.phpnu �[��� PK c�\�+�m� � j[ oauth2/.drone.jsonnetnu �[��� PK c�\���# # 6 Ci authentication/src/AuthenticationStrategyInterface.phpnu �[��� PK c�\��i� � D �l authentication/src/Exception/UnsupportedPasswordHandlerException.phpnu �[��� PK c�\�» | | E �n authentication/src/AbstractUsernamePasswordAuthenticationStrategy.phpnu �[��� PK c�\���� � / �z authentication/src/Strategies/LocalStrategy.phpnu �[��� PK c�\�� � 2 #� authentication/src/Strategies/DatabaseStrategy.phpnu �[��� PK c�\롭 % 7� authentication/src/Authentication.phpnu �[��� PK c�\d�u~� � - �� authentication/src/Password/BCryptHandler.phpnu �[��� PK c�\:5�m m 0 �� authentication/src/Password/HandlerInterface.phpnu �[��� PK c�\��Q� � / W� authentication/src/Password/Argon2idHandler.phpnu �[��� PK c�\ԴmI� � . <� authentication/src/Password/Argon2iHandler.phpnu �[��� PK c�\(��&;g ;g �� authentication/LICENSEnu �[��� PK c�\��.F� � ' database/phpunit.mysqli.xml.distnu &1i� PK c�\�P�E �E �) database/LICENSEnu �[��� PK c�\u5D � � �o database/phpunit.sqlsrv.xml.distnu &1i� PK c�\ ��O� � * �r database/phpunit.appveyor_sql2014.xml.distnu &1i� PK c�\��zX� � �u database/phpunit.pgsql.xml.distnu &1i� PK c�\��Ք� � ! �x database/phpunit.mariadb.xml.distnu &1i� PK c�\1P{��0 �0 �{ database/.drone.jsonnetnu &1i� PK c�\z� �3 3 ' �� database/src/Monitor/ChainedMonitor.phpnu �[��� PK c�\��Կ � % � database/src/Monitor/DebugMonitor.phpnu �[��� PK c�\1�)� ' 2� database/src/Monitor/LoggingMonitor.phpnu �[��� PK c�\��3E E & �� database/src/Event/ConnectionEvent.phpnu �[��� PK c�\��kT� � ( 2� database/src/UTF8MB4SupportInterface.phpnu �[��� PK c�\��y�U� U� �� database/src/DatabaseDriver.phpnu �[��� PK c�\"�d�� � %� database/src/FetchMode.phpnu �[��� PK c�\�h�� � ! a� database/src/Mysql/MysqlQuery.phpnu �[��� PK c�\�m~ Q Q " =� database/src/Mysql/MysqlDriver.phpnu �[��� PK c�\�H&]. ]. $ �� database/src/Mysql/MysqlImporter.phpnu �[��� PK c�\���� � $ I database/src/Mysql/MysqlExporter.phpnu �[��� PK c�\��TO� � & w database/src/QueryMonitorInterface.phpnu �[��� PK c�\ �m ! P database/src/DatabaseIterator.phpnu �[��� PK c�\x eG& & ) �/ database/src/Service/DatabaseProvider.phpnu �[��� PK c�\X��R8 8 ' ;5 database/src/DatabaseAwareInterface.phpnu �[��� PK c�\����s s $ �7 database/src/Mysqli/MysqliDriver.phpnu �[��� PK c�\e�Bl� � & 3� database/src/Mysqli/MysqliExporter.phpnu �[��� PK c�\RH �9 �9 ' g� database/src/Mysqli/MysqliStatement.phpnu �[��� PK c�\�h# . . & m� database/src/Mysqli/MysqliImporter.phpnu �[��� PK c�\�?�� � # � database/src/Mysqli/MysqliQuery.phpnu �[��� PK c�\�3�T T ! �" database/src/FetchOrientation.phpnu �[��� PK c�\�`�w- w- $ n) database/src/Sqlite/SqliteDriver.phpnu �[��� PK c�\�B oo o # 9W database/src/Sqlite/SqliteQuery.phpnu �[��� PK c�\CN� � & �s database/src/Command/ImportCommand.phpnu �[��� PK c�\m��� � & � database/src/Command/ExportCommand.phpnu �[��� PK c�\+�*=? =? " � database/src/DatabaseInterface.phpnu �[��� PK c�\\�[ ! �� database/src/DatabaseExporter.phpnu �[��� PK c�\���I I � database/src/ParameterType.phpnu �[��� PK c�\z���� �� �� database/src/DatabaseQuery.phpnu �[��� PK c�\ �.� � # �� database/src/StatementInterface.phpnu �[��� PK c�\ � 7| | ! �� database/src/Pgsql/PgsqlQuery.phpnu �[��� PK c�\ ��� � $ R database/src/Pgsql/PgsqlExporter.phpnu �[��� PK c�\ ���p �p " \ database/src/Pgsql/PgsqlDriver.phpnu �[��� PK c�\�綿�= �= $ 0� database/src/Pgsql/PgsqlImporter.phpnu �[��� PK c�\�36w2: 2: - O� database/src/Query/PostgresqlQueryBuilder.phpnu �[��� PK c�\�� ( � database/src/Query/MysqlQueryBuilder.phpnu �[��� PK c�\\���s s * O database/src/Query/PreparableInterface.phpnu �[��� PK c�\Z��� � # % database/src/Query/QueryElement.phpnu �[��� PK c�\��>"y y ) g1 database/src/Query/LimitableInterface.phpnu �[��� PK c�\P�� � � # 98 database/src/DatabaseAwareTrait.phpnu �[��� PK c�\�����V �V $ '= database/src/Sqlsrv/SqlsrvDriver.phpnu �[��� PK c�\Sȡ �: �: ' I� database/src/Sqlsrv/SqlsrvStatement.phpnu �[��� PK c�\� `��n �n # o� database/src/Sqlsrv/SqlsrvQuery.phpnu �[��� PK c�\6��: : �> database/src/DatabaseEvents.phpnu �[��� PK c�\7*�h� � ' C database/src/Sqlazure/SqlazureQuery.phpnu �[��� PK c�\�$�M M ( E database/src/Sqlazure/SqlazureDriver.phpnu �[��� PK c�\ g.� � ! �G database/src/DatabaseImporter.phpnu �[��� PK c�\)���M �M �f database/src/Pdo/PdoDriver.phpnu �[��� PK c�\M��m� � ! � database/src/Pdo/PdoStatement.phpnu �[��� PK c�\I�{ { )� database/src/Pdo/PdoQuery.phpnu �[��� PK c�\ t� �� database/src/DatabaseFactory.phpnu �[��� PK c�\�{��K �K X� database/src/QueryInterface.phpnu �[��� PK c�\h %� � ; �; database/src/Exception/QueryTypeAlreadyDefinedException.phpnu �[��� PK c�\�s�N� � ; �= database/src/Exception/PrepareStatementFailureException.phpnu �[��� PK c�\.m{ { 4 %B database/src/Exception/DatabaseNotFoundException.phpnu �[��� PK c�\�Q.xZ Z 4 D database/src/Exception/ExecutionFailureException.phpnu �[��� PK c�\Sw�W� � 5 �I database/src/Exception/ConnectionFailureException.phpnu �[��� PK c�\w� �� � 6 N database/src/Exception/UnsupportedAdapterException.phpnu �[��� PK c�\�uzѫ � / !P database/src/Exception/UnknownTypeException.phpnu �[��� PK c�\V�+�~ ~ +R database/phpunit.sqlite.xml.distnu &1i� PK c�\QS`i�7 �7 �T database/.drone.ymlnu &1i� PK c�\���c� � * � database/phpunit.appveyor_sql2017.xml.distnu &1i� PK c�\���� � � database/phpunit.mysql.xml.distnu &1i� PK c�\%�$�� � - ْ database/phpunit.appveyor_sql2012sp1.xml.distnu &1i� PK c�\�E[ RJ RJ ͕ di/src/Container.phpnu �[��� PK c�\��!* * " c� di/src/ContainerAwareInterface.phpnu �[��� PK c�\��$� � ) �� di/src/Exception/KeyNotFoundException.phpnu �[��� PK c�\A� 0� � / � di/src/Exception/ContainerNotFoundException.phpnu �[��� PK c�\���� � * ?� di/src/Exception/ProtectedKeyException.phpnu �[��� PK c�\y�q� � 2 �� di/src/Exception/DependencyResolutionException.phpnu �[��� PK c�\�td�? ? # �� di/src/ServiceProviderInterface.phpnu �[��� PK c�\�Iw�� � u� di/src/ContainerResource.phpnu �[��� PK c�\��3xN N �� di/src/ContainerAwareTrait.phpnu �[��� PK c�\�P�E �E di/LICENSEnu �[��� PK c�\�P�E �E �G registry/LICENSEnu �[��� PK c�\ p�� ʍ registry/src/Factory.phpnu �[��� PK c�\����g �g 2� registry/src/Registry.phpnu �[��� PK c�\���c c N� registry/src/Format/Xml.phpnu �[��� PK c�\Ӫf�- - � registry/src/Format/Json.phpnu �[��� PK c�\-���� � u registry/src/Format/Yaml.phpnu �[��� PK c�\;�' �' o registry/src/Format/Ini.phpnu �[��� PK c�\���߯ � XH registry/src/Format/Php.phpnu �[��� PK c�\��3�� � RV registry/src/FormatInterface.phpnu �[��� PK c�\k5a� � 5\ archive/src/Tar.phpnu �[��� PK c�\}�� %v archive/src/Gzip.phpnu �[��� PK c�\�Ĝ��C �C u� archive/src/Zip.phpnu �[��� PK c�\�muE3 3 5 <� archive/src/Exception/UnsupportedArchiveException.phpnu �[��� PK c�\�c +� � 1 �� archive/src/Exception/UnknownArchiveException.phpnu �[��� PK c�\�M�� � �� archive/src/Archive.phpnu �[��� PK c�\� ��W W $ � archive/src/ExtractableInterface.phpnu �[��� PK c�\ �� �� archive/src/Bzip2.phpnu �[��� PK c�\�P�E �E � archive/LICENSEnu �[��� PK c�\0�|� � ) �> router/src/Command/DebugRouterCommand.phpnu �[��� PK c�\��W* * 0S router/src/Router.phpnu �[��� PK c�\��;�# �# v} router/src/Route.phpnu �[��� PK c�\7; � 2 e� router/src/Exception/MethodNotAllowedException.phpnu �[��� PK c�\�F��� � / ɦ router/src/Exception/RouteNotFoundException.phpnu �[��� PK c�\��{ { �� router/src/ResolvedRoute.phpnu �[��� PK c�\~�z �� router/src/RouterInterface.phpnu �[��� PK c�\�P�E �E �� router/LICENSEnu �[��� PK c�\�+�m� � � router/.drone.jsonnetnu �[��� PK c�\Bh=�o o � router/.drone.ymlnu �[��� PK c�\�+�m� � I; string/.drone.jsonnetnu �[��� PK c�\��^�� � "I string/src/Inflector.phpnu �[��� PK c�\:a �_ _ ?c string/src/phputf8/strspn.phpnu �[��� PK c�\OX5� � ! �f string/src/phputf8/strcasecmp.phpnu �[��� PK c�\���R R "i string/src/phputf8/trim.phpnu �[��� PK c�\���� � �q string/src/phputf8/ucfirst.phpnu �[��� PK c�\�uw w �t string/src/phputf8/str_pad.phpnu �[��� PK c�\��� 2 2 % �{ string/src/phputf8/substr_replace.phpnu �[��� PK c�\��)-B B 0~ string/src/phputf8/strcspn.phpnu �[��� PK c�\@���� � # �� string/src/phputf8/str_ireplace.phpnu �[��� PK c�\�^�� � �� string/src/phputf8/str_split.phpnu �[��� PK c�\�h�w�A �A " � string/src/phputf8/native/core.phpnu �[��� PK c�\��(�� � $ �� string/src/phputf8/mbstring/core.phpnu �[��� PK c�\���ռ � � string/src/phputf8/utf8.phpnu �[��� PK c�\O�y�t t � string/src/phputf8/ucwords.phpnu �[��� PK c�\ 4�/% /% $ �� string/src/phputf8/utils/unicode.phpnu �[��� PK c�\���K� � ' Y string/src/phputf8/utils/validation.phpnu �[��� PK c�\f 3VB B % �0 string/src/phputf8/utils/patterns.phpnu �[��� PK c�\|�i�� � % < string/src/phputf8/utils/position.phpnu �[��� PK c�\Q c�! ! " fP string/src/phputf8/utils/ascii.phpnu �[��� PK c�\�� ��6 �6 �q string/src/phputf8/utils/bad.phpnu �[��� PK c�\+OcgB B % �� string/src/phputf8/utils/specials.phpnu �[��� PK c�\�ь�J J �� string/src/phputf8/ord.phpnu �[��� PK c�\� ��� � #� string/src/phputf8/READMEnu �[��� PK c�\iؚ� D� string/src/phputf8/stristr.phpnu �[��� PK c�\��{�� � �� string/src/phputf8/strrev.phpnu �[��� PK c�\�7�k>g >g �� string/src/phputf8/LICENSEnu �[��� PK c�\��q�U �U I string/src/StringHelper.phpnu �[��� PK c�\A;b�g g B� string/src/Normalise.phpnu �[��� PK c�\� ��o o � string/.drone.ymlnu �[��� PK c�\�P�E �E �� string/LICENSEnu �[��� PK c�\�P�E �E w utilities/LICENSEnu �[��� PK c�\�P��o o PX utilities/.drone.ymlnu �[��� PK c�\�+�m� � v utilities/.drone.jsonnetnu �[��� PK c�\�jv�0 0 ߃ utilities/src/IpHelper.phpnu �[��� PK c�\��iñD �D ;� utilities/src/ArrayHelper.phpnu �[��� PK c�\��lG�5 �5 9� data/src/DataSet.phpnu �[��� PK c�\,�9� � 1/ data/src/DumpableInterface.phpnu �[��� PK c�\�~a� � `3 data/src/DataObject.phpnu �[��� PK c�\�P�E �E �T data/LICENSEnu �[��� PK c�\h���o o , b� session/src/Validator/ForwardedValidator.phpnu �[��� PK c�\� ��B B * -� session/src/Validator/AddressValidator.phpnu �[��� PK c�\�gk� 1 ɨ session/src/Command/CreateSessionTableCommand.phpnu �[��� PK c�\K/�e e 3� session/src/StorageInterface.phpnu �[��� PK c�\�.��� � � session/src/SessionEvents.phpnu �[��� PK c�\-P�� ) � session/src/Handler/FilesystemHandler.phpnu �[��� PK c�\DT�� � # �� session/src/Handler/ApcuHandler.phpnu �[��� PK c�\N��7� � ' �� session/src/Handler/WincacheHandler.phpnu �[��� PK c�\� 2l l $ �� session/src/Handler/RedisHandler.phpnu �[��� PK c�\G���- - ( B� session/src/Handler/MemcachedHandler.phpnu �[��� PK c�\��R�� � ' � session/src/Handler/DatabaseHandler.phpnu �[��� PK c�\|p |J J � session/src/HandlerInterface.phpnu �[��� PK c�\�:I I J session/src/SessionInterface.phpnu �[��� PK c�\�> %� � & �0 session/src/Storage/RuntimeStorage.phpnu �[��� PK c�\�d1" $ $ % �I session/src/Storage/NativeStorage.phpnu �[��� PK c�\k�9=e< e< Zn session/src/Session.phpnu �[��� PK c�\�W�{� � � session/src/SessionState.phpnu �[��� PK c�\߁;� � session/src/SessionEvent.phpnu �[��� PK c�\P>�0r r " n� session/src/ValidatorInterface.phpnu �[��� PK c�\�Kj� � 1 2� session/src/Exception/InvalidSessionException.phpnu �[��� PK c�\�G�� � 5 '� session/src/Exception/CreateSessionTableException.phpnu �[��� PK c�\� �Z� � < 7� session/src/Exception/UnsupportedDatabaseDriverException.phpnu �[��� PK c�\Xj�i" i" S� session/.drone.ymlnu �[��� PK c�\.>� � �� session/meta/sql/sqlite.sqlnu �[��� PK c�\�<�� � �� session/meta/sql/pgsql.sqlnu �[��� PK c�\/�^� � �� session/meta/sql/mysql.sqlnu �[��� PK c�\�*zVs s �� session/meta/sql/sqlsrv.sqlnu �[��� PK c�\�8��T T �� session/.drone.jsonnetnu �[��� PK c�\�P�E �E B� session/LICENSEnu �[��� PK c�\�P�E �E < ldap/LICENSEnu �[��� PK c�\��։= �= � ldap/src/LdapClient.phpnu �[��� PK c�\�P�E �E �� application/LICENSEnu �[��� PK c�\���� + � application/src/WebApplicationInterface.phpnu �[��� PK c�\\�[^� � " application/src/WebApplication.phpnu �[��� PK c�\U�5K� � : G* application/src/ConfigurationAwareApplicationInterface.phpnu �[��� PK c�\ m�L� � : �0 application/src/Controller/ControllerResolverInterface.phpnu �[��� PK c�\UEV� � : �3 application/src/Controller/ContainerControllerResolver.phpnu �[��� PK c�\ �u�R R 1 �9 application/src/Controller/ControllerResolver.phpnu �[��� PK c�\�=\�� � * �I application/src/Event/ApplicationEvent.phpnu �[��� PK c�\��WM / �N application/src/Event/ApplicationErrorEvent.phpnu �[��� PK c�\�0T� � / -U application/src/Exception/UnableToWriteBody.phpnu �[��� PK c�\)�D�R R 3 ,W application/src/SessionAwareWebApplicationTrait.phpnu �[��� PK c�\~�� O O ! �a application/src/Web/WebClient.phpnu �[��� PK c�\5���� �� * 8� application/src/AbstractWebApplication.phpnu �[��� PK c�\ԧ�)f f ' 19 application/src/AbstractApplication.phpnu �[��� PK c�\PL��� � 7 �O application/src/SessionAwareWebApplicationInterface.phpnu �[��� PK c�\�Ī % <V application/src/ApplicationEvents.phpnu �[��� PK c�\��[W� � ( �\ application/src/ApplicationInterface.phpnu �[��� PK c�\O��Y+ + �_ application/rector.phpnu �[��� PK c�\��H Mb http/src/AbstractTransport.phpnu �[��� PK c�\h,ټB B �j http/src/TransportInterface.phpnu �[��� PK c�\CR% % Bp http/src/Transport/Curl.phpnu �[��� PK c�\�"K� � �� http/src/Transport/Socket.phpnu �[��� PK c�\tσ�K K � http/src/Transport/Stream.phpnu �[��� PK c�\� w� � 2 �� http/src/Exception/UnexpectedResponseException.phpnu �[��� PK c�\m�� 3 �� http/src/Exception/InvalidResponseCodeException.phpnu �[��� PK c�\O�gk k H� http/src/HttpFactory.phpnu �[��� PK c�\�88�*$ *$ �� http/src/Http.phpnu �[��� PK c�\��. . f http/src/Response.phpnu �[��� PK c�\�:;� � � http/.drone.jsonnetnu �[��� PK c�\�P�E �E � http/LICENSEnu �[��� PK c�\<$ �� � �e http/.drone.ymlnu �[��� PK c�\,q�* * � input/src/Json.phpnu �[��� PK c�\O|"�� � Y� input/src/Input.phpnu �[��� PK c�\P�=� � � input/src/Files.phpnu �[��� PK c�\34��� � �� input/src/Cookie.phpnu �[��� PK c�\�P�E �E h� input/LICENSEnu �[��� PK c�\��� � = filesystem/src/File.phpnu �[��� PK c�\"�x ' C( filesystem/src/Stream/StringWrapper.phpnu �[��� PK c�\6��l29 29 �= filesystem/src/Folder.phpnu �[��� PK c�\��%6� � 0 w filesystem/src/Exception/FilesystemException.phpnu �[��� PK c�\zi�� � $ r{ filesystem/src/Clients/FtpClient.phpnu �[��� PK c�\߭�K[ [ � filesystem/src/Helper.phpnu �[��� PK c�\k|�n# # U4 filesystem/src/Path.phpnu �[��� PK c�\��(c c �W filesystem/src/Buffer.phpnu �[��� PK c�\�]sf� � Xh filesystem/src/Stream.phpnu �[��� PK c�\�ǡq@- @- �� filesystem/src/Patcher.phpnu �[��� PK c�\q� � � + <+ filesystem/src/Support/StringController.phpnu �[��� PK c�\����� � F $1 filesystem/meta/language/en-GB/en-GB.lib_joomla_filesystem_patcher.ininu �[��� PK c�\�P�E �E k4 filesystem/LICENSEnu �[��� PK 77 u Ez
| ver. 1.4 |
Github
|
.
| PHP 8.3.23 | Generation time: 0.07 |
proxy
|
phpinfo
|
Settings