?? GreyFile

?? GreyFile — Mystic File Browser

Current path: home/webdevt/prestashop17/src/Adapter/

?? Go up: /home/webdevt/prestashop17/src

?? Editing: ContextStateManager.php

<?php
/**
 * Copyright since 2007 PrestaShop SA and Contributors
 * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
 *
 * NOTICE OF LICENSE
 *
 * This source file is subject to the Open Software License (OSL 3.0)
 * that is bundled with this package in the file LICENSE.md.
 * It is also available through the world-wide-web at this URL:
 * https://opensource.org/licenses/OSL-3.0
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@prestashop.com so we can send you a copy immediately.
 *
 * DISCLAIMER
 *
 * Do not edit or add to this file if you wish to upgrade PrestaShop to newer
 * versions in the future. If you wish to customize PrestaShop for your
 * needs please refer to https://devdocs.prestashop.com/ for more information.
 *
 * @author    PrestaShop SA and Contributors <contact@prestashop.com>
 * @copyright Since 2007 PrestaShop SA and Contributors
 * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
 */

declare(strict_types=1);

namespace PrestaShop\PrestaShop\Adapter;

use Cart;
use Context;
use Country;
use Currency;
use Customer;
use Language;
use Shop;

/**
 * Allows manipulating context state.
 * This was adapted for specific broken legacy use cases when the previous state of context must be restored after some actions.
 *
 * e.g. order creation from back office.
 *  Legacy requires Context properties (currency, country etc.) instead of using cart properties
 *  so some context props must be changed for a while and then restored to previous state.
 */
final class ContextStateManager
{
    private const MANAGED_FIELDS = [
        'cart',
        'country',
        'currency',
        'language',
        'customer',
        'shop',
        'shopContext',
    ];

/**
     * @var LegacyContext
     */
    private $legacyContext;

/**
     * @var array|null
     */
    private $contextFieldsStack = null;

/**
     * @param LegacyContext $legacyContext
     */
    public function __construct(LegacyContext $legacyContext)
    {
        $this->legacyContext = $legacyContext;
    }

/**
     * @return Context
     */
    public function getContext(): Context
    {
        return $this->legacyContext->getContext();
    }

/**
     * Sets context cart and saves previous value
     *
     * @param Cart|null $cart
     *
     * @return $this
     */
    public function setCart(?Cart $cart): self
    {
        $this->saveContextField('cart');
        $this->getContext()->cart = $cart;

return $this;
    }

/**
     * Sets context country and saves previous value
     *
     * @param Country|null $country
     *
     * @return $this
     */
    public function setCountry(?Country $country): self
    {
        $this->saveContextField('country');
        $this->getContext()->country = $country;

return $this;
    }

/**
     * Sets context currency and saves previous value
     *
     * @param Currency|null $currency
     *
     * @return $this
     */
    public function setCurrency(?Currency $currency): self
    {
        $this->saveContextField('currency');
        $this->getContext()->currency = $currency;

return $this;
    }

/**
     * Sets context language and saves previous value
     *
     * @param Language|null $language
     *
     * @return $this
     */
    public function setLanguage(?Language $language): self
    {
        $this->saveContextField('language');
        $this->getContext()->language = $language;
        if ($language) {
            $this->getContext()->getTranslator()->setLocale($language->locale);
        }

return $this;
    }

/**
     * Sets context customer and saves previous value
     *
     * @param Customer|null $customer
     *
     * @return $this
     */
    public function setCustomer(?Customer $customer): self
    {
        $this->saveContextField('customer');
        $this->getContext()->customer = $customer;

return $this;
    }

/**
     * Sets context shop and saves previous value
     *
     * @param Shop $shop
     *
     * @return $this
     *
     * @throws \PrestaShopException
     */
    public function setShop(Shop $shop): self
    {
        $this->saveContextField('shop');
        $this->getContext()->shop = $shop;
        Shop::setContext(Shop::CONTEXT_SHOP, $shop->id);

return $this;
    }

/**
     * Restores context to a state before changes
     *
     * @return self
     */
    public function restorePreviousContext(): self
    {
        $stackFields = array_keys($this->contextFieldsStack[$this->getCurrentStashIndex()]);
        foreach ($stackFields as $fieldName) {
            $this->restoreContextField($fieldName);
        }
        $this->removeLastSavedContext();

return $this;
    }

/**
     * Saves the current overridden fields in the context, allowing you to set new values to the
     * current Context. Next time you call restorePreviousContext the context will be refilled with
     * the values that were saved during this call.
     *
     * This is useful if several services use the ContextStateManager, this way if every service
     * saved the context before modifying it there is no risk of removing previous modifications
     * when you restore the context, because the different states have been stacked.
     *
     * @return $this
     */
    public function saveCurrentContext(): self
    {
        // No context field has been overridden yet so no need to save/stack it
        if (null === $this->contextFieldsStack) {
            return $this;
        }

// Saves all the fields that have not been overridden
        foreach (self::MANAGED_FIELDS as $contextField) {
            $this->saveContextField($contextField);
        }

// Add a new empty layer
        $this->contextFieldsStack[] = [];

return $this;
    }

/**
     * Return the stack of modified fields
     * If it's null, no context field has been overridden
     *
     * @return array|null
     */
    public function getContextFieldsStack(): ?array
    {
        return $this->contextFieldsStack;
    }

/**
     * Save context field into local array
     *
     * @param string $fieldName
     */
    private function saveContextField(string $fieldName)
    {
        $currentStashIndex = $this->getCurrentStashIndex();
        // NOTE: array_key_exists important here, isset cannot be used because it would not detect if null is stored
        if (!array_key_exists($fieldName, $this->contextFieldsStack[$currentStashIndex])) {
            switch ($fieldName) {
                case 'shop':
                    $this->contextFieldsStack[$currentStashIndex]['shop'] = $this->getContext()->$fieldName;
                    $this->contextFieldsStack[$currentStashIndex]['shopContext'] = Shop::getContext();
                    break;
                default:
                    $this->contextFieldsStack[$currentStashIndex][$fieldName] = $this->getContext()->$fieldName;
            }
        }
    }

/**
     * Restores context saved value, and remove save value from local array
     *
     * @param string $fieldName
     */
    private function restoreContextField(string $fieldName): void
    {
        $currentStashIndex = $this->getCurrentStashIndex();
        // NOTE: array_key_exists important here, isset cannot be used because it would not detect if null is stored
        if (array_key_exists($fieldName, $this->contextFieldsStack[$currentStashIndex])) {
            if ('shop' === $fieldName) {
                $this->restoreShopContext($currentStashIndex);
            }
            if ('language' === $fieldName && $this->contextFieldsStack[$currentStashIndex][$fieldName] instanceof Language) {
                $this->getContext()->getTranslator()->setLocale($this->contextFieldsStack[$currentStashIndex][$fieldName]->locale);
            }
            $this->getContext()->$fieldName = $this->contextFieldsStack[$currentStashIndex][$fieldName];
            unset($this->contextFieldsStack[$currentStashIndex][$fieldName]);
        }
    }

/**
     * Returns the index of the current stack
     *
     * @return int
     */
    private function getCurrentStashIndex(): int
    {
        // If this is the first time the index is needed we need to init the stack
        if (null === $this->contextFieldsStack) {
            $this->contextFieldsStack = [[]];
        }

return array_key_last($this->contextFieldsStack);
    }

/**
     * Restore the ShopContext, this is used when Shop has been overridden, we need to
     * restore context->shop of course But also the static fields in Shop class
     *
     * @param int $currentStashIndex
     */
    private function restoreShopContext(int $currentStashIndex): void
    {
        $shop = $this->contextFieldsStack[$currentStashIndex]['shop'];
        $shopId = $shop instanceof Shop ? $shop->id : null;
        $shopContext = $this->contextFieldsStack[$currentStashIndex]['shopContext'];
        if (null !== $shopContext) {
            Shop::setContext($shopContext, $shopId);
        }
        unset($this->contextFieldsStack[$currentStashIndex]['shopContext']);
    }

/**
     * Removes the last saved stashed context, in case this method is called too many times
     * we always keep one layer available
     */
    private function removeLastSavedContext(): void
    {
        array_pop($this->contextFieldsStack);

// When all layers have been popped we restore the initial null value
        if (empty($this->contextFieldsStack)) {
            $this->contextFieldsStack = null;
        }
    }
}

?? Addons | ??? Delete
?? Address | ??? Delete
?? Admin | ??? Delete
?? Assets | ??? Delete
?? Attachment | ??? Delete
?? Attribute | ??? Delete
?? Backup | ??? Delete
?? BestSales | ??? Delete
?? Cache | ??? Delete
?? Carrier | ??? Delete
?? Cart | ??? Delete
?? CartRule | ??? Delete
?? CatalogPriceRule | ??? Delete
?? Category | ??? Delete
?? CMS | ??? Delete
?? Configuration | ??? Delete
?? Contact | ??? Delete
?? Container | ??? Delete
?? Converter | ??? Delete
?? Country | ??? Delete
?? CreditSlip | ??? Delete
?? Currency | ??? Delete
?? Customer | ??? Delete
?? CustomerService | ??? Delete
?? Debug | ??? Delete
?? Domain | ??? Delete
?? Email | ??? Delete
?? Employee | ??? Delete
?? EntityTranslation | ??? Delete
?? Feature | ??? Delete
?? File | ??? Delete
?? Form | ??? Delete
?? Geolocation | ??? Delete
?? Grid | ??? Delete
?? Group | ??? Delete
?? Hook | ??? Delete
?? Hosting | ??? Delete
?? Image | ??? Delete
?? Import | ??? Delete
?? Invoice | ??? Delete
?? Kpi | ??? Delete
?? Language | ??? Delete
?? Localization | ??? Delete
?? Mail | ??? Delete
?? MailTemplate | ??? Delete
?? Manufacturer | ??? Delete
?? Media | ??? Delete
?? Meta | ??? Delete
?? Module | ??? Delete
?? NewProducts | ??? Delete
?? News | ??? Delete
?? Notification | ??? Delete
?? Number | ??? Delete
?? OptionalFeatures | ??? Delete
?? Order | ??? Delete
?? OrderMessage | ??? Delete
?? OrderReturnState | ??? Delete
?? OrderState | ??? Delete
?? Pack | ??? Delete
?? PDF | ??? Delete
?? Preferences | ??? Delete
?? Presenter | ??? Delete
?? PricesDrop | ??? Delete
?? Product | ??? Delete
?? Profile | ??? Delete
?? Requirement | ??? Delete
?? Routes | ??? Delete
?? Routing | ??? Delete
?? Search | ??? Delete
?? Security | ??? Delete
?? Shop | ??? Delete
?? Smarty | ??? Delete
?? SpecificPrice | ??? Delete
?? SqlManager | ??? Delete
?? Supplier | ??? Delete
?? Support | ??? Delete
?? System | ??? Delete
?? Tab | ??? Delete
?? Tax | ??? Delete
?? TaxRulesGroup | ??? Delete
?? Theme | ??? Delete
?? Translations | ??? Delete
?? Twig | ??? Delete
?? Upload | ??? Delete
?? Warehouse | ??? Delete
?? Webservice | ??? Delete
?? Zone | ??? Delete
?? AbstractObjectModelRepository.php | ?? Edit | ??? Delete
?? AbstractObjectModelValidator.php | ?? Edit | ??? Delete
?? AddressFactory.php | ?? Edit | ??? Delete
?? CacheManager.php | ?? Edit | ??? Delete
?? ClassLang.php | ?? Edit | ??? Delete
?? CombinationDataProvider.php | ?? Edit | ??? Delete
?? Configuration.php | ?? Edit | ??? Delete
?? ContainerBuilder.php | ?? Edit | ??? Delete
?? ContainerFinder.php | ?? Edit | ??? Delete
?? ContextStateManager.php | ?? Edit | ??? Delete
?? CoreException.php | ?? Edit | ??? Delete
?? Database.php | ?? Edit | ??? Delete
?? EntityMapper.php | ?? Edit | ??? Delete
?? EntityMetaDataRetriever.php | ?? Edit | ??? Delete
?? Environment.php | ?? Edit | ??? Delete
?? GeneralConfiguration.php | ?? Edit | ??? Delete
?? HookManager.php | ?? Edit | ??? Delete
?? ImageManager.php | ?? Edit | ??? Delete
?? LegacyContext.php | ?? Edit | ??? Delete
?? LegacyContextLoader.php | ?? Edit | ??? Delete
?? LegacyHookSubscriber.php | ?? Edit | ??? Delete
?? LegacyLogger.php | ?? Edit | ??? Delete
?? ObjectPresenter.php | ?? Edit | ??? Delete
?? RoundingMapper.php | ?? Edit | ??? Delete
?? ServiceLocator.php | ?? Edit | ??? Delete
?? StockManager.php | ?? Edit | ??? Delete
?? SymfonyContainer.php | ?? Edit | ??? Delete
?? Tools.php | ?? Edit | ??? Delete
?? Validate.php | ?? Edit | ??? Delete