omnisense / omnibase
omnibase: entities, repositories, view models, contracts, forms and helpers for any PHP host - Base\ is what is provided, App\ the application that overrides it by the same path; under Symfony with omnibridge/symfony, under Laravel with omnibridge/laravel, persisted through omnibridge/doctrine or om
Requires
- php: ^8.4
- composer-runtime-api: ^2.0
- ext-bcmath: *
- ext-exif: *
- ext-igbinary: *
- ext-imagick: *
- doctrine/collections: ^3.1
- embed/embed: ^4.4
- endroid/qr-code: ^6.0
- enshrined/svg-sanitize: ^1.0
- hashids/hashids: ^5.0
- imagine/imagine: ^1.2
- jaybizzle/crawler-detect: ^1.2
- league/flysystem: ^3.0
- omnibridge/composer: ^1.0
- omnisense/omnibridge: ^2.0
- omnisense/omnidrive: ^1.0
- psr/cache: ^1.0|^2.0|^3.0
- psr/clock: ^1.0
- psr/container: ^1.1|^2.0
- psr/event-dispatcher: ^1.0
- psr/log: ^1.0|^2.0|^3.0
- psr/simple-cache: ^1.0|^2.0|^3.0
- symfony/cache-contracts: ^2.5|^3.0
- symfony/event-dispatcher-contracts: ^2.5|^3.0
- symfony/filesystem: ^6.0|^7.0|^8.0
- symfony/finder: ^6.0|^7.0|^8.0
- symfony/http-client-contracts: ^2.5|^3.0
- symfony/intl: ^6.0|^7.0|^8.0
- symfony/mailer: ^6.0|^7.0|^8.0
- symfony/mime: ^6.0|^7.0|^8.0
- symfony/notifier: ^6.0|^7.0|^8.0
- symfony/options-resolver: ^6.0|^7.0|^8.0
- symfony/password-hasher: ^6.0|^7.0|^8.0
- symfony/property-access: ^6.0|^7.0|^8.0
- symfony/serializer: ^6.0|^7.0|^8.0
- symfony/service-contracts: ^2.5|^3.0
- symfony/string: ^6.0|^7.0|^8.0
- symfony/translation: ^6.0|^7.0|^8.0
- symfony/translation-contracts: ^2.5|^3.0
- symfony/uid: ^6.0|^7.0|^8.0
- symfony/yaml: ^6.0|^7.0|^8.0
Requires (Dev)
- api-platform/symfony: ^4.0
- beberlei/doctrineextensions: ^1.0
- doctrine/dbal: ^4.6
- doctrine/doctrine-fixtures-bundle: ^3.4
- doctrine/doctrine-migrations-bundle: ^3.0
- doctrine/orm: ^3.8
- florianv/swap: ^4.0
- glitchr/backup-manager: 4.0.*-dev
- glitchr/ux-google: 1.0.*-dev
- hwi/oauth-bundle: ^2.1
- league/flysystem-bundle: ^3.1
- league/flysystem-ftp: ^3.0
- omniauth/otp: 1.x-dev
- omniauth/webauthn: 1.x-dev
- omnibridge/doctrine: ^4.0
- omnibridge/symfony: ^3.1
- omnibridge/twig: ^2.0
- omnisense/omniauth: 1.x-dev
- omnisense/omnishield: 1.x-dev
- omnisense/omnisign: 1.x-dev
- omnishield/akismet: 1.x-dev
- omnishield/altcha: 1.x-dev
- omnishield/disposable: 1.x-dev
- omnisign/docuseal: 1.x-dev
- phpoffice/phpspreadsheet: ^1.23|^2.0
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^10.5
- scheb/2fa: ^7.0|^8.0
- scienta/doctrine-json-functions: ~4.3
- squizlabs/php_codesniffer: ^3.7
- symfony/cache: ^6.0|^7.0|^8.0
- symfony/debug-bundle: ^6.0|^7.0|^8.0
- symfony/discord-notifier: ^6.0|^7.0|^8.0
- symfony/http-client: ^6.0|^7.0|^8.0
- symfony/lock: ^6.0|^7.0|^8.0
- symfony/phpunit-bridge: ^6.0|^7.0|^8.0
- symfony/process: ^6.0|^7.0|^8.0
- symfony/rate-limiter: ^7.0|^8.0
- symfony/stopwatch: ^6.0|^7.0|^8.0
- symfony/validator: ^6.0|^7.0|^8.0
- symfony/web-profiler-bundle: ^6.0|^7.0|^8.0
- symfony/webpack-encore-bundle: ^2.0
- symfony/workflow: ^6.0|^7.0|^8.0
- twig/twig: ^3.0
- wapmorgan/php-deprecation-detector: ^2.0
- web-auth/webauthn-lib: ^5.3
- web-auth/webauthn-symfony-bundle: ^5.3
Suggests
- api-platform/doctrine-orm: API Platform's Doctrine state for those resources (^4.0)
- api-platform/symfony: The API of the #[ApiResource] entities (User, Thread); an App\ override replaces the Base\ resource it extends (^4.0)
- doctrine/doctrine-fixtures-bundle: demo:reset reloads the fixtures (the demo environment)
- dompdf/dompdf: Base\Response\PdfResponse: an HTML page answered as a PDF (^3.0)
- florianv/swap: The currency rates of Base\Service\Trading (^4.0)
- glitchr/backup-manager: The TimeMachine, the backups of the database and the application to the storages (Base\Service\TimeMachine, which extends its Manager, and the commands timemachine:snapshot, timemachine:snapshot:backup, timemachine:snapshot:restore and timemachine:storage); without it, neither the service nor the commands are registered, and base.time_machine is read by nothing (4.0.*-dev)
- glitchr/ux-google: Google Analytics (AnalyticsSubscriber) and the reCAPTCHA of the sign-in and comment forms (1.0.*-dev)
- glitchr/well-known: The /.well-known files (security.txt...) (1.0.*-dev)
- hwi/oauth-bundle: Signing in through an identity provider (Google...): Base\Security\UserProvider is then the OAuth-aware provider (Base\Security\OAuthUserProvider) (^2.1)
- league/flysystem-bundle: The storages of the application's configuration (local, S3, SFTP...) behind the `flysystem` service every file, image and backup service reads; without it, omnibase's local storages (local.cache, local.uploads, local.wysiwyg and their .public) (^3.1)
- league/flysystem-ftp: FTP storages behind the core's flysystem (^3.0)
- nelmio/cors-bundle: CORS headers (^2.2)
- nelmio/security-bundle: Security headers: CSP, clickjacking, external redirects (^3.0)
- omniauth/google: Google sign-in through omniauth, linked by its subject in userIdentity (Base\Auth\UserIdentities; Base\Auth\PolicyLinking: never by the address an account with a second factor or an administration role); the providers' mechanics are omnisense/omniauth's own (^1.0)
- omniauth/otp: Authenticator applications through omniauth, on user.secret (Base\Auth\UserTotpSecrets), sealed at rest when omniauth.yaml sets totp.secret_key (formerly omniauth/totp) (^1.0)
- omniauth/webauthn: Passkeys through omniauth: Base\Auth\UserPasskeys, the userPasskey table as omniauth/webauthn's records (formerly omniauth/passkey) (^1.0)
- omnibridge/doctrine: The persistence on Doctrine behind the core's contracts: the DQL compiler of the finder language, the statements of the backend-only queries, the mapping and the types (^1.0)
- omnibridge/eloquent: The persistence on Eloquent's database layer behind the same contracts (^1.0)
- omnibridge/laravel: The core under Laravel: the contracts, the services' list bound, the forms drawn in Blade (^1.0)
- omnibridge/symfony: The core under Symfony: the bundle (Base\BaseBundle, registered in config/bundles.php), its configuration (base:), the Symfony form types, controllers, commands and security classes under their Base\ names, the adapters of the host's contracts (^1.0)
- omnibridge/twig: Twig's generic helpers beside omnibase's (|at, |emoji_only, html_attributes()...: Omnibridge\Twig\HelperExtension, registered with the Twig layer); omnibridge/symfony and omnibridge/laravel require it (^1.0)
- omnisense/omniauth: Signing in under any host (Symfony, Laravel, plain PHP): Base\Auth\ fills omniauth's stores on omnibase's tables (the accounts, user.password, the sign-in links of userToken hashed, the e-mailed codes hashed, the backup codes, the trusted devices' version, the identities of userIdentity), Base\Auth\Policy is SecurityPolicy on its second-factor rule, Base\Auth\Listener\* listen to its events; nothing is wired without it (^1.0)
- omnisense/omnimap: Maps through omnimap (config/packages/omnimap.yaml): BaseBundle registers omnibridge/symfony's OmnimapExtension where both are installed - the providers, the map cache, omnimap() in Twig, the cache's routes (^1.0)
- omnisense/omnishield: Base\Service\FormGuard's captcha, address lists and content classifier (the option `guard` of a form, Akismet behind SpamChecker): register Omnishield\Bridge\Symfony\OmnishieldBundle
- omnisense/omnisign: Base\Service\Signatures: documents signed for any entity (Base\Entity\Signature\Envelope, mapped only with it), the signed file and its evidence kept in the private storage; register Omnisign\Bridge\Symfony\OmnisignBundle
- omnishield/akismet: Akismet behind Base\Service\SpamChecker (base.guard.classifier)
- omnishield/altcha: ALTCHA, the default captcha of FormGuard: a proof of work served and checked by the site, no third party, no cookie, no consent
- omnishield/disposable: Disposable e-mail domains refused at sign-up (base.guard.reputation)
- omnisign/docuseal: A DocuSeal instance of one's own: nothing leaves for a third party (omnisign/yousign, omnisign/docusign for the providers)
- phpoffice/phpspreadsheet: The spreadsheets exported and read by the back office and the commands (^1.23|^2.0)
- scheb/2fa: Two-factor sign-in (TOTP, e-mail codes, backup codes, trusted devices): installed, Base\Entity\User implements its Scheb\TwoFactorBundle\Model interfaces (Base\Contract\TwoFactorUser); register SchebTwoFactorBundle for the sign-in itself (^7.0|^8.0)
- symfony/discord-notifier: Notifications to Discord through the core's notifier (^6.0|^7.0|^8.0)
- symfony/form: Base\Form\Type\* (the contact, comment, privacy, search and password forms) and FormDefinition::of(): the forms written as Symfony form types, read on every host (omnibridge/symfony and omnibridge/laravel install it)
- symfony/http-client: An HTTP client behind the core's HTTP contract (symfony/http-client-contracts): the currency rates (Trading), the remote classifiers, embeds (^6.0|^7.0|^8.0)
- symfony/lock: demo:reset runs under a lock (the demo environment)
- symfony/ux-twig-component: The Base\ and App\ Twig components (^2.0|^3.0)
- symfony/validator: The validation of the entities' #[Assert\...] attributes under Symfony (omnibridge/symfony requires it), and its `validators` catalogue (^6.0|^7.0|^8.0)
- symfony/webpack-encore-bundle: The application's Encore build beside the core's (encore_entry_*_tags read both; without it, the core's alone) (^2.0)
- twig/cache-extra: {% cache %} in the core's breakpoints and widget templates (@Base/breakpoints.css.twig, @Base/widget/*) (^3.0)
- twig/cssinliner-extra: inline_css in the core's e-mail frame, and |inline_css_email (MailTwigExtension) (^3.0)
- twig/inky-extra: inky_to_html in the core's e-mail frame (@Base/notifier/email.html.twig) (^3.0)
- twig/intl-extra: Twig's format_date(), format_number()... in a Twig application's templates; omnibase's |datetime and |format_currency no longer need it (Base\View\Dates, Money) (^3.0)
- twig/twig: Twig as the application's view engine (since step F4 of the plan "omnibase agnostic": the view engine is the application's choice). Installed, omnibase's Twig layer is registered - its environment, loader, variables and the extensions of src/Twig (|thumbnail, |wysiwyg, render_locale()...), thin wrappers over the neutral helpers Base\View\*, which need no Twig and serve Blade and React as well -, and the core's templates (@Base/...) can be rendered; without it nothing of src/Twig is registered or loaded (^3.0)
- web-auth/webauthn-lib: Passkeys: the userPasskey columns and Base\Repository\User\PasskeyRepository's records (^5.3)
- web-auth/webauthn-symfony-bundle: Passkeys: Base\Repository\User\PasskeyRepository and Base\Security\WebauthnUserEntityRepository are its credential and user repositories (^5.3)
Provides
None
Conflicts
None
Replaces
- glitchr/omnibase: v7.1.1
- omniscient/omnibase: v7.1.1
README
Bedrock Symfony bundle for Glitchr projects: it pre-configures a full application
stack (admin, security, media, i18n, workflow, API) so host apps only add their
domain code. The Base\ namespace deliberately mirrors the host apps' App\
structure — a host class can usually extend or decorate its Base\ counterpart
one-to-one.
Published as omnisense/omnibase (formerly glitchr/omnibase, which this package replaces: a
composer.json that still requires the old name keeps resolving to it, and never installs both).
Composer now installs it in vendor/omnisense/omnibase; nothing in the package depends on that
path (its templates, documentation and scripts are found from its own directory), but an
application that names the old path in its configuration has to follow - see CHANGELOG.
Requires PHP ≥ 8.4 (doctrine/collections 3). Since 4.0 the package requires its Foundation alone
(Doctrine, Twig, Symfony's standalone components): under Symfony 6, 7 or 8 the framework comes with
omnibridge/symfony, see Installation. Licensed MIT (LICENSE) since 2026-10-09;
earlier versions remain published under LGPL-3.0-or-later.
Docker: every plugin, running
docker/ builds this checkout into one Symfony application with every omnibase/* plugin -
the back office, the shop, the forge, the forum, the mailbox, the docs - on SQLite, with a demo
page that seeds members and a shop and signs you in:
cd docker docker compose up # → http://localhost:8000/ docker compose run --rm omnibase check # container and templates linted, routes counted docker compose -f compose.yml -f compose.checkouts.yml run --rm omnibase bare # the Foundation loaded without the framework docker compose -f compose.yml -f compose.checkouts.yml up # the checkouts beside this one instead of Packagist docker compose -f compose.yml -f compose.checkouts.yml run --rm omnibase test [admin|marketplace|forge|...] # a suite, on the checkouts
The suites run there in the test environment on a fresh SQLite database: see docs/30-operations/harness.md.
Installation
The package is resolved from Packagist (repository: https://github.com/glitchr-omnisense/omnibase).
The core alone, under any PHP host (7.x: no framework, no persistence, no view engine imposed):
composer require omnisense/omnibase
Symfony (6, 7 or 8): the core and the framework packages, which omnibridge/symfony
carries (FrameworkBundle, SecurityBundle, TwigBundle, Form...; DoctrineBundle and MonologBundle are its suggestions),
then the bundles your config/bundles.php registers - the core suggests them, and works with
all of them:
composer require omnisense/omnibase omnibridge/symfony
composer require doctrine/doctrine-bundle omnibridge/doctrine symfony/monolog-bundle \
scheb/2fa league/flysystem-bundle hwi/oauth-bundle web-auth/webauthn-symfony-bundle \
api-platform/symfony api-platform/doctrine-orm symfony/webpack-encore-bundle symfony/ux-twig-component \
glitchr/ux-google:1.0.*-dev glitchr/well-known:1.0.*-dev nelmio/cors-bundle nelmio/security-bundle
Without any one of them the container still compiles: since step C7b Base\Entity\User
declares Security's and scheb/2fa's interfaces where they are installed (Base\Contract\SecurityUser,
TwoFactorUser), and Base\Service\Flysystem is the core's own class, on omnibase's local storages
without league/flysystem-bundle. An application coming from 3.x adds omnibridge/symfony and
the bundles it did not require itself, and updates those alone. An application on 4.x keeps
omnisense/omnibase:4.0.*-dev; from 4.x to 5.x, see UPGRADE-5.0.md. The 3.x branch
(omnisense/omnibase:3.0.*-dev) still requires the framework itself. See
docs/20-architecture/packages.md.
Laravel (12 or 13): omnibridge/laravel fills the core's contracts with Laravel's services; no Symfony
framework package is installed then:
composer require omnisense/omnibase omnibridge/laravel
Under Symfony, enable in config/bundles.php (Flex usually does it):
Base\BaseBundle::class => ['all' => true],
Bundle configuration lives under the base: key; the tree is defined in
src/DependencyInjection/BaseConfiguration.php.
Try it in one command
A self-contained demo (bare Symfony skeleton + this bundle + SQLite, one flat
page touring the App\ ↔ Base\ mirroring, the shipped entity layer, the
setting bag, the obfuscator and the translator) ships in the root
Dockerfile:
docker build -t base-bundle-demo . docker run --rm -p 8000:8000 base-bundle-demo # → http://localhost:8000/
The demo app under example/app/ doubles as a minimal
reference: the smallest bundles.php, base.yaml, doctrine.yaml,
security.yaml and flysystem.yaml a host application needs.
What's inside (map of src/)
| Area | Directories | Purpose |
|---|---|---|
| Admin | Admin/, Field/, Form/ |
EasyAdmin integration: custom CRUD fields (~40, e.g. WysiwygField, CropperField, TranslationField) with their configurators, form types and extensions |
| Persistence | Database/, Entity/, Repository/, EntityDispatcher/, *Subscriber/ |
Doctrine attributes (Hierarchify, Versionable, Vault, …), base entities (User, Thread, Layout, …), lifecycle dispatching |
| HTTP | Controller/, Routing/, Response/ |
Public/admin/UX controllers, advanced router, sitemap |
| Security | Security/, Validator/ |
Voters, 2FA (scheb), access tokens, dynamic session storage |
| Services | Service/, Cache/, Notifier/, Serializer/ |
BaseService facade, media/file/flysystem services, localizer, notifier channels |
| Presentation | Twig/, templates/, translations/ |
Twig extensions/components, EasyAdmin + client templates, translations |
| Assets | assets/, public/, Imagine/ |
Encore entrypoints (async/defer), built assets, image filters |
| Tooling | Console/, Inspector/, Attributes/ |
Console commands, profiler data collectors, attribute reader |
Extension points are autoconfigured by tag — implement the interface, the tag is
applied automatically (see omnibridge/symfony's src/Omnibase/DependencyInjection/BaseExtension.php):
base.entity_extension, base.annotation, base.icon_provider,
base.service.sharer, base.simple_cache, …
Service wiring
Since 5.0 the Symfony service definitions are omnibridge/symfony's (config/omnibase/, loaded by
its Base\DependencyInjection\BaseExtension); the core keeps the list of
its services as data (Base\Services::definitions()), which Symfony, Laravel and a plain-PHP
container read alike. The files there:
services.php— registrations (split per domain, loaded byBaseExtension)services-decoration.php— decorations of framework/third-party servicesservices-public.php— services forced publicservices-fix.php— targeted workarounds
Development
The bundle is developed inside a host app's vendor/omnisense/omnibase
checkout (composer VCS install keeps .git) and pushed from there.
make build # yarn install --frozen-lockfile (yarn.lock) + Encore, production build make linter # php-cs-fixer + phpstan (level max) make tests # phpunit
CI (.gitlab-ci.yml) runs cs-fixer, PHPStan and PHPUnit on every push.
Releases
One development branch per major (1.x, 2.x, 3.x — the current one is the
main branch; the next major starts 4.x), tags per release (3.0.0, 3.1.0,
…) — tag after each meaningful batch so consumers can pin stable versions:
git tag -a 3.1.0 -m "..." && git push origin 3.1.0
The legacy 1.0/2.0/3.0 branches carry the pre-2026 unslimmed history and
are frozen — do not push to them.
See CHANGELOG.md.