polysource / symfony-bundle
Polysource Admin — Symfony bundle wiring core contracts into Symfony 7.4 (DI, routing, controllers).
Maintainers
Package info
github.com/polysource/symfony-bundle
Type:symfony-bundle
pkg:composer/polysource/symfony-bundle
Requires
- php: >=8.2
- polysource/core: ^0.1 || ^0.2 || ^0.3 || ^0.4 || ^0.5 || ^0.6 || ^0.7 || ^0.8 || ^0.9 || ^0.10 || ^0.11 || ^1.0
- polysource/filter: ^0.1 || ^0.2 || ^0.3 || ^0.4 || ^0.5 || ^0.6 || ^0.7 || ^0.8 || ^0.9 || ^0.10 || ^0.11 || ^1.0
- polysource/twig-theme: ^0.1 || ^0.2 || ^0.3 || ^0.4 || ^0.5 || ^0.6 || ^0.7 || ^0.8 || ^0.9 || ^0.10 || ^0.11 || ^1.0
- psr/log: ^1.0 || ^2.0 || ^3.0
- symfony/config: ^6.4 || ^7.0 || ^8.0
- symfony/dependency-injection: ^6.4 || ^7.0 || ^8.0
- symfony/framework-bundle: ^6.4 || ^7.0 || ^8.0
- symfony/http-foundation: ^6.4 || ^7.0 || ^8.0
- symfony/http-kernel: ^6.4 || ^7.0 || ^8.0
- symfony/routing: ^6.4 || ^7.0 || ^8.0
- symfony/security-bundle: ^6.4 || ^7.0 || ^8.0
- symfony/translation: ^6.4 || ^7.0 || ^8.0
- symfony/twig-bundle: ^6.4 || ^7.0 || ^8.0
- symfony/yaml: ^6.4 || ^7.0 || ^8.0
- twig/twig: ^3.0
Requires (Dev)
- phpunit/phpunit: ^10.5 || ^11.5
- symfony/browser-kit: ^6.4 || ^7.0 || ^8.0
- symfony/dom-crawler: ^6.4 || ^7.0 || ^8.0
- symfony/phpunit-bridge: ^6.4 || ^7.0 || ^8.0
Suggests
- doctrine/orm: Enables the `polysource:doctor` schema check (DoctrineSchemaCheck). The check degrades gracefully when the ORM is absent.
This package is auto-updated.
Last update: 2026-08-07 15:37:47 UTC
README
Symfony bundle that wires polysource/core contracts into Symfony 6.4 LTS, 7.x and 8.x (DI, routing, controllers, Twig view layer).
This package is the entry point for any Symfony application using Polysource Admin.
The pure-PHP core package can be used standalone, but most users will install
this bundle to get full HTTP/Twig integration.
Installation
composer require polysource/symfony-bundle
The bundle auto-registers itself via Symfony Flex.
Configuration
# config/packages/polysource.yaml polysource: url_prefix: /admin # default
What it ships
Routing. PolysourceRouteLoader generates five physical routes for
every registered resource (cf. ADR-003), under the configured url_prefix:
| Method | Path | Controller |
|---|---|---|
GET |
{prefix}/{slug} |
IndexController |
GET |
{prefix}/{slug}/{id} |
DetailController |
GET |
{prefix}/{slug}/{id}/detail-panel |
RowDetailPanelController |
POST |
{prefix}/{slug}/batch/{action} |
ActionController::bulk |
POST |
{prefix}/{slug}/{id}/{action} |
ActionController |
Expandable row details. Any resource may opt in by implementing
HasRowDetailsInterface (3 methods — hasRowDetail(DataRecord),
getRowDetail(DataRecord): ?RowDetail, getRowDetailPermission(): ?string).
The detail-panel route serves the panel lazily as a fragment, and the
same URL renders a layout-wrapped standalone page when JavaScript is
absent (ADR-027). RowDetail::listing() embeds another Polysource
resource read-only, paged through rd_page by EmbeddedListingRenderer.
Per-record action gating. ControllerSupport::collectRecordActionViews()
evaluates inline actions against the row, not just the resource: the
permission check receives the DataRecord as voter subject, and
isDisplayed() receives a populated context — record, subject (the
domain object behind the record, e.g. the Doctrine entity), and page
('index' or 'detail'). An unknown record id answers 404, not 500.
Plugins. PluginCompilerPass + PluginRegistry collect
AdminPluginInterface implementations declared with #[AsPlugin];
polysource:plugins:list dumps what the container found.
polysource:doctor. A console health check over the wiring most
likely to be wrong: PHP version, bundle registration, Doctrine schema,
plugin declarations, and EasyAdmin co-loading.
Status
Shipped — v1.1.0 (2026-08-07). Public API frozen under strict SemVer since v1.0.0 (2026-08-06): breaking changes only in a new major. See ROADMAP.
Architectural decisions
This package implements:
- ADR-003 — physical routes per resource
- ADR-004 —
final readonly AdminContext - ADR-005 —
#[AsResource]attribute + interface methods - ADR-011 — the pre-v1.0 API freeze checklist, which set the v1.0 floors (PHP 8.2+, Symfony 6.4 LTS+)
- ADR-015 — multi-version compatibility baseline
- ADR-018 —
AdminPluginInterface+ public contracts - ADR-027 — server-side fallback for every interactive feature
- ADR-033 — expandable row details
License
MIT