omnisense / omnibase
Base helper integration for Symfony
Package info
github.com/glitchr-omnisense/omnibase
Type:symfony-bundle
pkg:composer/omnisense/omnibase
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: ^1.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.2
- doctrine/doctrine-fixtures-bundle: ^3.4
- doctrine/doctrine-migrations-bundle: ^3.0
- doctrine/orm: ^3.4
- 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: 2.x-dev
- omnibridge/symfony: ^2.0
- omnibridge/twig: 1.x-dev
- 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/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: since 5.0 the core requires no Doctrine package but doctrine/collections; omnibridge/doctrine brings doctrine/orm and dbal, the DQL functions (beberlei/doctrineextensions, scienta/doctrine-json-functions), the repositories, the mapping and the types of the core's entities (^2.0)
- omnibridge/laravel: The core under Laravel: the contracts, the services' list bound, the forms drawn in Blade (^1.2)
- omnibridge/symfony: The core under Symfony: since 5.0 the bundle itself (Omnibridge\Symfony\Omnibase\BaseBundle, registered in config/bundles.php), its configuration (base:), its container extension and compiler passes, the Symfony controllers (their routes imported with `type: omnibase`), the adapters of the host's contracts and the framework packages (FrameworkBundle, DoctrineBundle, SecurityBundle, TwigBundle, Form, Routing, HttpKernel, Validator, Cache, Process, Workflow...) (^2.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/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
- omnibridge/doctrine: <2.0
- omnibridge/eloquent: <1.1
- omnibridge/laravel: <1.2
- omnibridge/symfony: <2.0
Replaces
- glitchr/omnibase: v6.0.0
- omniscient/omnibase: v6.0.0
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 omniscient/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/omniscient/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.2 (omnibridge/doctrine) and Symfony 6, 7 or 8. 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 Fondation 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-studio/omnibase):
composer require omniscient/omnibase:^3.0
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 src/DependencyInjection/BaseExtension.php):
base.entity_extension, base.annotation, base.icon_provider,
base.service.sharer, base.simple_cache, …
Service wiring
Service definitions live in config/:
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/omniscient/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.