State.php

Go to the documentation of this file.

<?php
namespace Magento\Framework\App;

class State
{
    const PARAM_MODE = 'MAGE_MODE';

    protected $_appMode;

    protected $_isDownloader = false;

    protected $_updateMode = false;

    protected $_configScope;

    protected $_areaCode;

    protected $_isAreaCodeEmulated = false;

    private $areaList;

    const MODE_DEVELOPER = 'developer';

    const MODE_PRODUCTION = 'production';

    const MODE_DEFAULT = 'default';

    public function __construct(
        \Magento\Framework\Config\ScopeInterface $configScope,
        $mode = self::MODE_DEFAULT
    ) {
        $this->_configScope = $configScope;
        switch ($mode) {
            case self::MODE_DEVELOPER:
            case self::MODE_PRODUCTION:
            case self::MODE_DEFAULT:
                $this->_appMode = $mode;
                break;
            default:
                throw new \InvalidArgumentException("Unknown application mode: {$mode}");
        }
    }

    public function getMode()
    {
        return $this->_appMode;
    }

    public function setIsDownloader($flag = true)
    {
        $this->_isDownloader = $flag;
    }

    public function setAreaCode($code)
    {
        $this->checkAreaCode($code);

        if (isset($this->_areaCode)) {
            throw new \Magento\Framework\Exception\LocalizedException(
                new \Magento\Framework\Phrase('Area code is already set')
            );
        }
        $this->_configScope->setCurrentScope($code);
        $this->_areaCode = $code;
    }

    public function getAreaCode()
    {
        if (!isset($this->_areaCode)) {
            throw new \Magento\Framework\Exception\LocalizedException(
                new \Magento\Framework\Phrase('Area code is not set')
            );
        }
        return $this->_areaCode;
    }

    public function isAreaCodeEmulated()
    {
        return $this->_isAreaCodeEmulated;
    }

    public function emulateAreaCode($areaCode, $callback, $params = [])
    {
        $this->checkAreaCode($areaCode);

        $currentArea = $this->_areaCode;
        $this->_areaCode = $areaCode;
        $this->_isAreaCodeEmulated = true;
        try {
            $result = call_user_func_array($callback, $params);
        } catch (\Exception $e) {
            $this->_areaCode = $currentArea;
            $this->_isAreaCodeEmulated = false;
            throw $e;
        }
        $this->_areaCode = $currentArea;
        $this->_isAreaCodeEmulated = false;
        return $result;
    }

    private function checkAreaCode($areaCode)
    {
        $areaCodes = array_merge(
            [Area::AREA_GLOBAL],
            $this->getAreaListInstance()->getCodes()
        );

        if (!in_array($areaCode, $areaCodes)) {
            throw new \Magento\Framework\Exception\LocalizedException(
                new \Magento\Framework\Phrase('Area code "%1" does not exist', [$areaCode])
            );
        }
    }

    private function getAreaListInstance()
    {
        if ($this->areaList === null) {
            $this->areaList = ObjectManager::getInstance()->get(AreaList::class);
        }

        return $this->areaList;
    }
}