Download the PHP package elcommerce/magento2-app-emulation without Composer
On this page you can find all versions of the php package elcommerce/magento2-app-emulation. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download elcommerce/magento2-app-emulation
More information about elcommerce/magento2-app-emulation
Files in elcommerce/magento2-app-emulation
Package magento2-app-emulation
Short Description A drop-in replacement for Magento App Emulation that supports nested environment emulation
License GPL-3.0-only
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package magento2-app-emulation
Elcommerce Magento 2 App Emulation
A drop-in replacement for Magento\Store\Model\App\Emulation that supports nested environment emulation.
Magento's standard implementation allows only one active emulation. If code that is already emulating a store calls another service that starts emulation, the inner call is ignored and its matching stop can restore the environment too early. This module keeps a stack of environment states so every start can be paired with a stop safely.
Features
- Supports nested store-environment emulation.
- Restores the preceding environment when each nested call finishes.
- Preserves store, area, theme, locale, inline-translation state, and phrase renderer.
- Replaces the Magento service through dependency injection, so existing consumers do not need to change their injected class.
- Retains the public
startEnvironmentEmulation()andstopEnvironmentEmulation()API.
Requirements
- Magento 2 with
magento/module-store - PHP 7.4 or later
Installation
Install the Composer package from a repository that provides it:
In production mode, regenerate dependency-injection code after installation:
Confirm that the module is enabled:
Usage
Continue to inject Magento's standard emulation class. The module's DI preference supplies the nested-capable implementation automatically.
Always place the stop call in a finally block. Every call to startEnvironmentEmulation() creates a stack entry and must have exactly one matching call to stopEnvironmentEmulation().
Nested behavior
Given the following sequence:
The inner stop restores the outer emulated environment instead of ending all emulation. Calls may use different stores or areas.
The $force argument retains Magento's standard behavior. When it is false and the requested store and area are already active, the module records a balanced no-op frame. Passing true applies the requested environment unconditionally. In both cases, start and stop calls must remain balanced.
How it works
The module declares a DI preference from Magento\Store\Model\App\Emulation to Elcommerce\AppEmulation\Model\Emulation. Before applying a requested environment, it pushes the current state onto an in-process stack. Stopping emulation pops and restores the most recent state.
No configuration is required.
License
Licensed under the GNU General Public License v3.0.
