super-kernel / environment

dev-main 2026-10-28 09:55 UTC

Requires

• php: >=8.4.27 <8.5
• ext-filter: *
• super-kernel/attribute: dev-main
• symfony/dotenv: ^8.1.6

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95.27
• phpunit/phpunit: ^13.4.3

MIT

Published on Packagist.org on 2026-10-28 10:10 UTC

README

super-kernel/environment exposes ordered external property sources through a strict, typed object API. It owns source precedence and scalar conversion, but it does not define defaults or validation policy for Framework, Server, database, cache, or other consuming components.

Source organization

Paths below are relative to src/ and the package namespace.

Directory	Responsibility
Naming	PropertyName: canonical name validation and process-variable mapping.
PropertySource	Array, process, and dotenv value sources.
Provider / Contract	Default environment composition and component-owned access contracts.

Implementation helpers retain an @internal boundary; a responsibility namespace does not make them extension points.

Public namespaces

Use the following component declarations:

• Naming\PropertyName

Property sources

Environment accepts a list of PropertySourceInterface implementations. Sources are ordered from lowest to highest precedence, so a value in a later source overrides the same property from every earlier source. The package includes array, optional or required dotenv-file, and process-environment sources.

Canonical property names use lowercase dotted or kebab notation, for example:

app.feature.enabled

Process and dotenv sources map that name to:

APP_FEATURE_ENABLED

A dotenv source reads one immutable snapshot without mutating $_ENV, $_SERVER, or the process environment. A missing optional file contributes no values; a missing required file raises PropertySourceLoadingException.

Typed access

EnvironmentInterface exposes raw scalar lookup plus string, integer, float, and boolean conversion. Missing values return null. Invalid explicit values raise InvalidEnvironmentValueException without including the configured value in the exception message. Component configuration factories apply their own defaults only after a missing lookup and validate their domain-specific invariants.

The default EnvironmentProvider installs only the process environment. An application may provide its own EnvironmentInterface implementation to add a project-root dotenv file or another source before the process source.

Development

Use a PHP 8.4 Composer in this package's checkout:

composer install
composer validate --strict
composer test
composer format:check
composer format