---
title: "Breaking: Removed internal environment / state-manager subsystem"
manual: "Academic Base"
version: "main"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-base:breaking-removed-internal-environment-state-manager-subsystem@main"
source: "Changelog/3.0/Breaking-RemovedInternalEnvironmentStateManagerSubsystem.rst"
rendered: "2026-10-17T08:47:46+00:00"
---

# Breaking: Removed internal environment / state-manager subsystem {#breaking-removed-internal-environment-state-manager-subsystem}

## Description {#description}

The internal environment, state-manager and environment-builder subsystem
that `EXT:academic_base` shipped under the namespaces
`\FGTCLB\AcademicBase\Environment`,
`\FGTCLB\AcademicBase\Core12\Environment` and
`\FGTCLB\AcademicBase\Core13\Environment` has been removed. Use the
standalone `fgtclb/environment-state-manager` extension
(namespace `\FGTCLB\EnvironmentStateManager`) instead.

This is the removal step of the change deprecated in academic_base 2.4.0,
see [the deprecation notice](https://docs.typo3.org/permalink/fgtclb/academic-base:deprecation-1783574951@main).

Together with the classes the backward-compatibility class alias for
`\FGTCLB\AcademicBase\Environment\StateBuildContext` (registered onto
`\FGTCLB\EnvironmentStateManager\StateBuildContext` via
`Migrations/Code/ClassAliasMap.php` and its IDE stub
`Migrations/Code/LegacyClassesForIde.php`) has been removed, as well as
the `typo3/class-alias-loader` requirement and its
`extra.typo3/class-alias-loader` composer configuration that registered
the alias.

## Impact {#impact}

Code referencing any of the removed classes, interfaces or traits - including
the deprecated `\FGTCLB\AcademicBase\Environment\StateBuildContext`
alias - no longer resolves and triggers a fatal error.

## Affected installations {#affected-installations}

Installations referencing the removed internal environment / state-manager
classes or the deprecated `StateBuildContext` alias directly. Within the
academic extensions this concerned only `EXT:academic_persons` and
`EXT:academic_programs`, which were already switched to
`fgtclb/environment-state-manager`.

## Migration {#migration}

Require `fgtclb/environment-state-manager` and replace the namespace prefix
`\FGTCLB\AcademicBase\Environment` with
`\FGTCLB\EnvironmentStateManager`, and
`\FGTCLB\AcademicBase\Core13\Environment` with
`\FGTCLB\EnvironmentStateManager\Core13`. Class names, method
signatures and behaviour are compatible. Version 2 of that extension, which
3.0 requires, has no `Core12` namespace, so code that used
`\FGTCLB\AcademicBase\Core12\Environment` names the class of the
running TYPO3 version instead, see [Important: fgtclb/environment-state-manager 2 is required](https://docs.typo3.org/permalink/fgtclb/academic-base:important-environment-state-manager-2@main).

```php
// Before
use FGTCLB\AcademicBase\Environment\StateManagerInterface;
use FGTCLB\AcademicBase\Environment\StateBuildContext;

// After
use FGTCLB\EnvironmentStateManager\StateManagerInterface;
use FGTCLB\EnvironmentStateManager\StateBuildContext;
```