NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #2951 most downloaded on Packagist
Spiral, High-Performance PHP/Go Framework
Latest stable
3.18.2
Last release 13 days ago
09 Nov 2026
Release timing varies
gaps range from 9 days to 8 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
184 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
[spiral/console] Fixed compatibility with symfony/console 6.x
symfony/console 6.xFull Changelog: https://github.com/spiral/framework/compare/2.10.0...2.10.1
upd(deps): update RR version in go.mod by @rustatian in https://github.com/spiral/framework/pull/530
go.mod by @rustatian in https://github.com/spiral/framework/pull/530Spiral\Mailer\Message class by @msmakouz in https://github.com/spiral/framework/pull/558Full Changelog: https://github.com/spiral/framework/compare/2.9.1...2.10.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Spiral\Session\SessionFactoryInterface. Now you can use custom implementation of
sessions.Spiral\Scaffolder\Command\MigrationCommand, Spiral\Scaffolder\Command\Database\RepositoryCommand,
Spiral\Scaffolder\Command\Database\EntityCommand is deprecated. Will be moved to spiral/cycle-bridge and
removed in v3.0Spiral\Scaffolder\Declaration\MigrationDeclaration is deprecated. Will be moved
to spiral/cycle-bridge
and removed in v3.0PHP increased to ^7.4queue and cache propertiesSpiral\Mailer\Message is no longer final and is available for extensionFixed: PHP Deprecated: htmlspecialchars(): Passing null to parameter [PHP8.1] by @msmakouz in https://github.com/spiral/framework/pull/565
starting and started by @butschster in https://github.com/spiral/framework/pull/540Undefined class or binding 'Spiral\Boot\EnvironmentInterface by @butschster in https://github.com/spiral/framework/pull/545Class "Composer\InstalledVersions" not found by @butschster in https://github.com/spiral/framework/pull/546SNAPSHOT_MAX_FILES and SNAPSHOT_VERBOSITY to int in SnapshotsBootloader by @msmakouz in https://github.com/spiral/framework/pull/541composer.json by @butschster in https://github.com/spiral/framework/pull/561Spiral\Boot\STDERR in ExceptionHandler by @butschster in https://github.com/spiral/framework/pull/562RouteGroup from AnnotatedRoutes component to Router component by @msmakouz in https://github.com/spiral/framework/pull/557queue to the SendIt by @msmakouz in https://github.com/spiral/framework/pull/556PHP Deprecated: htmlspecialchars(): Passing null to parameter [PHP8.1] by @msmakouz in https://github.com/spiral/framework/pull/565Full Changelog: https://github.com/spiral/framework/compare/2.9.0...2.9.1
getQueuePipeline of Spiral\SendIt\Config\MailerConfig class is deprecated.
Use method getQueue instead. Added environment variables MAILER_QUEUE and MAILER_QUEUE_CONNECTIONAdding attributes, marking as deprecated Annotations package by @msmakouz in #486
New packages
get and make methods #516invoke for invoking callables with auto-wiring. You can use Spiral\Core\InvokerInterface for callables also.1.8.1 by @msmakouz in #487psr/container version to 1 - 2 by @roxblnfk in #499spiral/cycle-bridge package by @msmakouz in #497sync driver out of the box by @butschster in #501array and file driver out of the box by @butschsterConsoleDispatcher and SapiDispatcher dispatchers by @butschster in #527Spiral Framework project: https://github.com/orgs/spiral/projects/5
Full Changelog: https://github.com/spiral/framework/compare/v2.8.13...2.9.0
Spiral\Validation\Checker\EntityChecker, Spiral\Auth\Cycle\Token, Spiral\Auth\Cycle\TokenStorage,
Spiral\Cycle\RepositoryInjector, Spiral\Cycle\SchemaCompiler, is deprecated.
Will be moved to spiral/cycle-bridge and removed in v3.0Spiral\Command\Cycle\MigrateCommand, Spiral\Command\Cycle\SyncCommand,
Spiral\Command\Cycle\UpdateCommand is deprecated. Will be moved to spiral/cycle-bridge and removed in v3.0Spiral\Bootloader\Cycle\AnnotatedBootloader, Spiral\Bootloader\Cycle\CycleBootloader,
Spiral\Bootloader\Cycle\ProxiesBootloader, Spiral\Bootloader\Cycle\SchemaBootloader is deprecated.
Use spiral/cycle-bridge insteadSpiral\Domain\CycleInterceptor is deprecated.
Will be moved to spiral/cycle-bridge and removed in v3.0Spiral\Scaffolder\Declaration\Database\Entity\AnnotatedDeclaration,
Spiral\Scaffolder\Declaration\Database\RepositoryDeclaration is deprecated. Will be moved
to spiral/cycle-bridge
and removed in v3.0spiral/data-grid-bridge is deprecated. Will be moved to spiral/cycle-bridge and removed in v3.0spiral/annotations is deprecated. Use spiral/attributes insteaddoctrine/annotations increased to ^1.12sync driver for mail queue (#398)[Security] Added new console command securitypermissions (#455, #369)
security:role:permissions (#455, #369)[Filters] Added optional flag for nested filters (#408, #453)
[Distribution] Added S3 and CloudFront distribution prefixes
[Attributes] Fix attributes PSR-6 cache init logic
[Distribution] Invalid diff computation when a concrete expiration date is provided
[Distriution] Fix prefix file uri with slash
Fix S3 distribution config endpoint
Added S3 options distribution config section
options distribution config sectiontoUri and toUriFrom argumentsAdded additional S3 storage options: https://github.com/spiral/framework/pull/421
Improve an expection message of aws storage's dependency.
Serialize Mail::options for sending via queue (#422, #402)
Fix S3 distribution configuration typo
Fix CloudFront distribution signer
Added new spiral/storage component (See https://spiral.dev/docs/component-storage)
New Functionality
spiral/storage component (See https://spiral.dev/docs/component-storage)spiral/distribution component (See https://spiral.dev/docs/component-distribution)spiral/attributes component (See https://spiral.dev/docs/component-attributes)High Impact Changes
league/flysystem: ^2.0 dependency.Other Features
[spiral/http] ResponseWrapper bugfix
Change subject encoding to base64_encode
- Fix dumprr helper output logic
dumprr helper output logic (#394)Fix uuid segment regex in UriHandler
- Fix composer interdependencies
Nothing published for this version
- fix QueryWriter for DataGrid
Fix monolog bridge compatibility
Fix dotenv bridge compatibility
A minimal version of monolog/monolog increased to ^2.2
High Impact Changes
monolog/monolog increased to ^2.2Other Features
arrayOf validation checkernow parameter in datetime checkerilike postgres filterGuardInterceptorBug Fixes
Nothing published for this version
Fixed RR binary (upgrade minimal RR version to 1.8.3)
Fixed default secure cookies flag
A minimal version of symfony/translation increased to ^5.1
High Impact Changes
symfony/translation increased to ^5.1symfony/console increased to ^5.1symfony/finder increased to ^5.1Medium Impact Changes
zend/zend-diactoros was replaced by laminas/laminas-diactoros ^2.3Spiral\Debug\Dumper class marked as finalOther Features
any, none conditionsregister new validation conditions
RR updated to 1.8.2 (don't use broken 1.8.1 tag)
Allow JSON requests with empty body by @rauanmayemir
Add the ability to control view cache separately from DEBUG via VIEW_CACHE env variable
added support for Postgres Cycle Auth tokens
- Update RR to 1.8.0
added JobRegistry with the ability to route jobs into custom pipelines
JobRegistry with the ability to route jobs into custom pipelinesencrypt:key is no longer privateroute:list by @ncounotNull validation rulegrpc:generate command by @matthewhall-caRoadRunner version updated to 1.7.0
build.sh script updated. Included -trimpath and musl target
-trimpath and musl targetroadrunner updated to version 1.6.3
fix issue with debug http collector fail in console mode
WebSocket module updated to v1.1.0
- added reload module
Fix return status code behavior in the console dispatcher
TableCommand render for fragmentsFix ConsoleDispatcher default values
Add status code return into ConsoleDispatcher
minor code-base quality improvements
route:list commandPUSH message anymoreroave/security-advisoriesbump spiral/validation dependency
spiral/validation dependencyDatetimeChecker in the ValidationBootloaderadded striker payload validation for jobs
refactor in WebsocketBootloader
- added Broadcast service - added WebSocket server
minor refactoring in json exception handler
bugfix: client exceptions no longer sent with 500 code in application/json payloads
application/json payloadsthe framework can work without any snapshooter
fixed invalid middleware association for HTTP state collector
improved debug state management
the plain snapshots enabled by default instead of HTML based
lighter API and abstract class base injection for spiral/filters
spiral/filtersOne column per quarter.