PHPackages fgtclb/environment-state-manager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. fgtclb/environment-state-manager ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility) fgtclb/environment-state-manager ================================ Environment builder and state manager for TYPO3 CMS 00[1 PRs](https://github.com/fgtclb/environment-state-manager/pulls)PHP Pushed todayCompare [ Source](https://github.com/fgtclb/environment-state-manager)[ Packagist](https://packagist.org/packages/fgtclb/environment-state-manager)[ RSS](/packages/fgtclb-environment-state-manager/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersionsUsed By (0) [![Latest Stable Version](https://camo.githubusercontent.com/20aebb577daf69af77179221aa4be3793b923d5e6843cb2e0cddae5c1d9cc98a/68747470733a2f2f706f7365722e707567782e6f72672f666774636c622f656e7669726f6e6d656e742d73746174652d6d616e616765722f762f737461626c652e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/fgtclb/environment-state-manager)[![License](https://camo.githubusercontent.com/0ce17ebf4592126a98e8aaf56f602825193f7ebae2696e3501c60b6d5b5eaa55/68747470733a2f2f706f7365722e707567782e6f72672f666774636c622f656e7669726f6e6d656e742d73746174652d6d616e616765722f6c6963656e73653f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/fgtclb/environment-state-manager)[![TYPO3 13.4](https://camo.githubusercontent.com/d42fe27cc5732df3ef0ecf4bd12a80d214e0bc127a91f7885ba89fd155e74d31/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31332e342d677265656e2e7376673f7374796c653d666f722d7468652d6261646765)](https://get.typo3.org/version/13.4)[![TYPO3 12.4](https://camo.githubusercontent.com/af4386ccce6ff254edfbfc23a3850a527f374d729b0296e9de521a50783c9fa6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31322e342d677265656e2e7376673f7374796c653d666f722d7468652d6261646765)](https://get.typo3.org/version/12.4)[![Total Downloads](https://camo.githubusercontent.com/79ba845d018508c3339e00c904a6b4c3d75ec8db60e641d2eaef010399642b38/68747470733a2f2f706f7365722e707567782e6f72672f666774636c622f656e7669726f6e6d656e742d73746174652d6d616e616765722f646f776e6c6f6164732e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/fgtclb/environment-state-manager)[![Monthly Downloads](https://camo.githubusercontent.com/351b037159eafac083253e22a0bbbb50c085b17893351c598222e674709af466/68747470733a2f2f706f7365722e707567782e6f72672f666774636c622f656e7669726f6e6d656e742d73746174652d6d616e616765722f642f6d6f6e74686c793f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/fgtclb/environment-state-manager) FGTCLB: Environment State Manager ================================= [](#fgtclb-environment-state-manager) URL**Repository:****Read online:****TER:**[https://extensions.typo3.org/extension/environment\_state\_manager/](https://extensions.typo3.org/extension/environment_state_manager/)**ISSUES:****RELEASES:**Description ----------- [](#description) TYPO3 CMS extension providing an environment builder and a state manager. It allows code to build and apply a fully featured TYPO3 environment (request, controller context, `ServerRequest`, TypoScript, language and visibility aspects, …) for a given page and to safely back up and restore the global state around such an operation. > **Note:** Both **frontend** and **backend** environment handling are implemented. The API is designed around an application type, selecting the matching environment builder for the requested type. This functionality was extracted from `fgtclb/academic-base` into a dedicated, reusable extension. Over the time there has been multiple extensions to allow the creation of the `TypoScriptFrontendController (TSFE)` but missed all the other handling and state in various places. They further lacked all a proper state management and build when used in FE or BE web-requests and did not returned to the previous state leaving the context in a populated (broken) state, something this extension tries to handle more properly over the different TYPO3 versions. It ca be used in tasks, commands, schedulers, frontend requests, backend requests and also within functional tests to properly build the more global state. Features -------- [](#features) - `EnvironmentBuilderFactory` returning a TYPO3 core version compatible environment builder (TYPO3 v12 and v13). A `FrontendEnvironmentBuilder` and a `BackendEnvironmentBuilder` are shipped. - `StateManager` to build, apply and restore an environment state, emitting `StateApplyEvent` and `StateBackupEvent` PSR-14 events. Compatibility ------------- [](#compatibility) BranchStateExtensionTYPO3PHPmainactive support1.xv12 / v138.1 – 8.5Installation ------------ [](#installation) ``` composer require fgtclb/environment-state-manager ``` Development ----------- [](#development) Tip This extension uses the `Build/Scripts/runTests.sh` script dispatcher known from TYPO3 Core Development and also from a long list of public extensions adopting it for extension development. Every tool or test execution is dispatched through this wrapper script making it the same in every environment. This requires at `docker` or `podman` to be installed on the system. Tests and code quality checks are executed through the container based test runner: ``` # Prepare dependencies for a TYPO3 version Build/Scripts/runTests.sh -t 13 -p 8.2 -s composerUpdate # Coding guidelines (php-cs-fixer) Build/Scripts/runTests.sh -s cgl # Static analysis Build/Scripts/runTests.sh -t 13 -s phpstan # Unit / functional tests Build/Scripts/runTests.sh -t 13 -s unit Build/Scripts/runTests.sh -t 13 -s functional ``` See `Build/Scripts/runTests.sh -h` for all options. Tests ----- [](#tests) The test suite combines feature tests for the extracted functionality with a set of tests adopted from the `fgtclb/academic-*` extension family. Documentation ------------- [](#documentation) The extension documentation is based on `ReStructured TEXT (ReST)` and the TYPO3 render-guides can be used to render the documentation locally using the `Build/Scripts/runTests.sh` dispatcher. ``` Build/Scripts/runTests.sh -s renderDocumentation ``` The implementation follows the recommendation from the TYPO3 Documentation team except not using the Makefile or Github Action approach in favour of the centralized `runTests.sh` wrapper approach. Adding the `Makefile` will be declined due to our own policies. ### Feature tests [](#feature-tests) - `Tests/Unit/EnvironmentBuilderFactoryTest.php` and `Tests/Functional/EnvironmentBuilderFactoryTest.php` cover the `EnvironmentBuilderFactory`, including the TYPO3 core version specific service resolution. - `Tests/Functional/Core12` and `Tests/Functional/Core13` hold the `StateManager` functional tests, gated per TYPO3 version through the `not-core-12` / `not-core-13` PHPUnit groups. ### Adopted tests [](#adopted-tests) These tests were adopted from `fgtclb/academic-persons`. Because a standalone extension can not depend on the monorepo-only `fgtclb/academics-monorepo-testing-helper` package, the underlying traits are adopted into this repository under `Tests/FunctionalTestCase/` (namespace `FGTCLB\EnvironmentStateManager\Tests\FunctionalTestCase`): - `Tests/Unit/VersionCompatTest.php` and `Tests/Functional/VersionCompatTest.php`use `ExtensionCoreVersionCompatTestsTrait` to assert the supported TYPO3 v12 and v13 major versions, as a unit and a functional test respectively. - `Tests/Functional/ExtensionLoadedTest.php` uses `ExtensionsLoadedTestsTrait`to verify the extension is registered both by its composer package name (`fgtclb/environment-state-manager`) and its extension key (`environment_state_manager`). The academic extension chain of the original test is reduced to this extension only. Create a release (maintainers only) ----------------------------------- [](#create-a-release-maintainers-only) Prerequisites: - git binary - ssh key allowed to push new branches to the repository - GitHub command line tool `gh` installed and configured with user having permission to create pull requests. **Create release** > Set `RELEASE_BRANCH` to branch release should happen, for example: 'main'. Set `RELEASE_VERSION` to release version working on, for example: '1.0.0'. Important Requires `GitHub cli tool` with personal token and maintainer permission on the extension repository. ``` echo '>> Create release' ; \ RELEASE_BRANCH='main' ; \ RELEASE_VERSION='1.0.0' ; \ DEV_VERSION='1.0.1' ; \ echo ">> Checkout branches" && \ git checkout master && \ git fetch --all && \ git pull --rebase && \ git checkout ${RELEASE_BRANCH} && \ git pull --rebase && \ echo ">> Create release ${RELEASE_VERSION}" && \ git checkout -b release-${RELEASE_VERSION} && \ sed -i "s/^COMPOSER_ROOT_VERSION.*/COMPOSER_ROOT_VERSION=\"${RELEASE_VERSION}\"/" Build/Scripts/runTests.sh && \ sed -i "s/^ RELEASE_VERSION.*/ RELEASE_VERSION='${RELEASE_VERSION}' ; \\\\/" README.md && \ sed -i "s/^ DEV_VERSION.*/ DEV_VERSION='${DEV_VERSION}' ; \\\\/" README.md && \ tailor set-version ${RELEASE_VERSION} && \ composer config "extra"."typo3/cms"."version" "${RELEASE_VERSION}" && \ echo "${RELEASE_VERSION}" > VERSION && \ git add . && \ git commit -m "[RELEASE] ${RELEASE_VERSION}" && \ git push --set-upstream origin release-${RELEASE_VERSION} && \ gh pr create --fill --base ${RELEASE_BRANCH} --title "[RELEASE] ${RELEASE_VERSION}" && \ sleep 10 && \ gh pr checks --watch --interval 2 && \ sleep 10 && \ gh pr merge -rd --admin && \ git remote prune origin && \ git tag ${RELEASE_VERSION} && \ git push origin ${RELEASE_VERSION} && \ echo ">> Post-release - set dev version: ${DEV_VRESION}-dev" && \ git checkout -b set-dev-version-${DEV_VERSION} && \ sed -i "s/^COMPOSER_ROOT_VERSION.*/COMPOSER_ROOT_VERSION=\"${DEV_VERSION}-dev\"/" Build/Scripts/runTests.sh && \ tailor set-version ${DEV_VERSION} && \ composer config "extra"."typo3/cms"."version" "${DEV_VERSION}-dev" && \ echo "${DEV_VERSION}-dev" > VERSION && \ git add . && \ git commit -m "[TASK] Set dev version ${DEV_VERSION}" && \ git push --set-upstream origin set-dev-version-${DEV_VERSION} && \ gh pr create --fill --base ${RELEASE_BRANCH} --title "[TASK] Set dev version \"${DEV_VERSION}-dev\"" && \ sleep 10 && \ gh pr checks --watch --interval 2 && \ sleep 10 && \ gh pr merge -rd --admin && \ git remote prune origin ``` This triggers the `on push tags` workflow (`publish.yml`) which creates the upload package, License ------- [](#license) GPL-2.0-or-later. See [LICENSE](LICENSE). ### Health Score 20 — LowBetter than 13% of packages Maintenance65 Regular maintenance activity Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity8 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1453466?v=4)[Stefan Bürk](/maintainers/sbuerk)[@sbuerk](https://github.com/sbuerk) --- Top Contributors [![sbuerk](https://avatars.githubusercontent.com/u/1453466?v=4)](https://github.com/sbuerk "sbuerk (25 commits)") ### Embed Badge ![Health badge](/badges/fgtclb-environment-state-manager/health.svg) ``` [![Health](https://phpackages.com/badges/fgtclb-environment-state-manager/health.svg)](https://phpackages.com/packages/fgtclb-environment-state-manager) ``` ### Alternatives [elhebert/laravel-sri Subresource Integrity hash generator for laravel 39241.9k](/packages/elhebert-laravel-sri)[mtdowling/burgomaster Packages up PHP packages into zips and phars 2780.9k12](/packages/mtdowling-burgomaster)[francescomalatesta/laravel-circuit-breaker A circuit breaker pattern implementation for the Laravel framework 2919.2k2](/packages/francescomalatesta-laravel-circuit-breaker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)