⭐ Found this useful? Install from Packagist · Give it a star on GitHub so more developers can find it.
Database-backed application environment variables with admin CRUD. Values are encrypted at rest with nowo-tech/doctrine-encrypt-bundle. Designed for FrankenPHP worker (no $_ENV / putenv mutation; safe with or without kernel.reset / services_resetter).
This bundle is FrankenPHP worker mode friendly.
Bootstrap secrets (
DATABASE_URL,APP_SECRET, encryptor key files,FRANKENPHP_MODE, …) stay in.env. This bundle is for agility on business/integration variables you want to edit without redeploy.
Manage panel: encrypted at rest, values masked, paginated |
Edit: stored value never shown; delete behind a confirm dialog |
RuntimeEnvBag reads the stored value on the next request |
- Doctrine entity
RuntimeEnvVariablewith#[Encrypted]value column - Admin CRUD at
/_runtime_env(REQ-UI-002:ROLE_ADMINby default), paginated, CSRF-protected deletes behind a confirm dialog RuntimeEnvBagAPI + Twigruntime_env('KEY')— request-scoped memoization (worker-safe even whenresetKernelis false) +kernel.reset- Configurable
table_prefix(defaultruntime_env→ tableruntime_env_variables) - UiKit page contract (list / form scaffolds, one host theme for every Nowo bundle; no CDN, no inline JS)
- 1.6 (opt-in): database backend of nowo-tech/runtime-setting-contract — a bundle setting from
.envcan come from this table, change live (nowo:runtime-setting:*or the admin UI, same validator) and rotate without downtime; see USAGE
composer require nowo-tech/runtime-env-bundleRequires a configured DoctrineEncryptBundle profile (Halite recommended). See docs/INSTALLATION.md.
Register routes (Flex recipe copies this):
# config/routes/nowo_runtime_env.yaml
nowo_runtime_env:
resource: .
type: nowo_runtime_env- PHP >= 8.2, < 8.6
- Symfony 7.4, 8.0, or 8.1 (see
composer.json; CI exercises 7.4, 8.0, and 8.1) - Doctrine ORM + Doctrine Bundle
nowo-tech/doctrine-encrypt-bundle(Halite recommended)- Twig 3.12+
# config/packages/nowo_runtime_env.yaml
nowo_runtime_env:
enabled: true
table_prefix: runtime_env
security:
access_roles: [ROLE_ADMIN]
allow_unauthenticated: false # never true in production
web_ui:
enabled: true
path_prefix: /_runtime_env
list_page_size: 50The manage pages follow the UiKit page contract: they render inside
nowo_ui_kit.layouts.admin and use the host theme (nowo_ui_kit.css_framework, nowo_ui_kit.theme). Page map and
override points: docs/TEMPLATES.md.
Full tree: docs/CONFIGURATION.md.
use Nowo\RuntimeEnvBundle\Service\RuntimeEnvBag;
public function __construct(private RuntimeEnvBag $runtimeEnv) {}
public function __invoke(): void
{
$token = $this->runtimeEnv->get('MY_API_TOKEN');
}{{ runtime_env('MY_API_TOKEN') }}See docs/USAGE.md for more examples.
make setup-hooks
make up
make test
make phpstan
make igor
make cs-checkDemo: cd demo/symfony8 && make up → http://localhost:8026 — see demo/README.md.
The screenshots at the top come from this demo: refresh them with make -C demo/symfony8 demo-screenshots; make -C demo/symfony8 test-e2e runs the Playwright happy path.
- Installation
- Configuration
- Usage
- Contributing
- Code of Conduct
- Changelog
- Upgrading
- Release
- Security
- Engram
- Spec-driven development
- GitHub Spec Kit
- Demo with FrankenPHP (development and production)
- Concurrency (write paths, conflict codes)
- FrankenPHP worker audit (
resetKernel=false) - GitHub Actions CI requirements
- PSR evaluation (REQ-CS-007)
- Tests: PHPUnit (PHP) under
tests/Unit/andtests/Integration/(FrankenPHP worker simulation) - Coverage:
- PHP: 100%
- TS/JS: N/A
- Python: N/A
- Badge / CI: PHPUnit coverage job on PHP 8.2 + Symfony 7.4
MIT. See LICENSE.
Nowo.tech · Héctor Franco Aceituno



