Содержание статьи
- 1. Что это за релиз и как читать обзор
- 2. Performance: где именно стало быстрее
- 3. Compiled Event Dispatcher: меньше работы до первого события
- 4. Выражения компилируются, ошибки находятся раньше
- 5. Messenger: concurrency и быстрый AMQP consumer
- 6. Outbox и Claim Check: сохранить намерение отправить
- 7. Inbox: распознать повторную доставку сообщения
- 8. Потоки сообщений: correlation, цепочки и межсистемный обмен
- 9. Компоненты получают собственные bundles
- 10. JSON Schema для конфигурации и CI
- 11. Serializer, generics и доменные accessors
- 12. Формы: меньше дублирования DTO и новые составные поля
- 13. Аргументы контроллеров, Lock и Validator
- 14. HTTP Recorder: воспроизводить внешнее API в тестах
- 15. Security: OpenID Connect и подтверждение недавнего входа
- 16. Подписи, ротация секретов и управление ключами
- 17. AssetMapper: integrity, обновления и более удобный dev
- 18. Ещё несколько изменений, которые стоит открыть отдельно
- 19. Как обновляться и что измерить в своём проекте
- 20. Источники и границы обзора
1. Что это за релиз и как читать обзор
В Symfony 8.2 важны сразу два направления: уменьшение инфраструктурных расходов и готовые механизмы для задач, которые команды раньше собирали самостоятельно. Особенно заметны изменения вокруг Messenger, Serializer, конфигурации и тестирования внешних API.
На 19 ноября 2026 года официальный release API указывает последнюю сборку 8.2.0-BETA2. Ветка требует PHP от 8.4, не является LTS; окончание поддержки заявлено на июль 2027 года. Это обзор опубликованных возможностей перед финальным релизом, а не объявление о его выходе. Актуальный статус — на странице Symfony 8.2.
Мы просмотрели 48 публикаций Living on the Edge для 8.2 и сгруппировали наиболее полезные изменения по рабочим задачам. Примеры ниже показывают отдельные возможности и не являются полной конфигурацией production-приложения.
2. Performance: где именно стало быстрее
Официальный performance-разбор основан на профилировании Symfony Demo и отдельного API-проекта. Несколько показательных результатов:
| Участок | Изменение | Результат в исходном сценарии |
|---|---|---|
| Serializer: списки 150–900 объектов | Меньше повторных вычислений контекста и копирования массивов | Маршруты быстрее на 14–24% |
| PropertyAccess | Дешевле чтение свойства | На 40% меньше PHP-инструкций в этой операции |
| PropertyInfo/TypeInfo в dev | Меньше повторного разбора docblocks | POST быстрее на 24–38% |
| AssetMapper в dev | Меньше чтений кешированных metadata | Рендер importmap: 4,7 → 2,4 мс |
| Debug container dump | Клонируются только definitions с env vars | Этап dump: 49 → 14 мс |
Дополнительно ускорены прогрев metadata, кеши, Twig warmup и работа Profiler. Часть подготовки профиля перенесена после отправки ответа в PHP-FPM. Для некоторых клиентских HTTP-ошибок уровень логирования изменён на warning: проверьте свои правила оповещений.
Это замеры авторов Symfony, не наши. Проценты относятся к разным нагрузкам и операциям, их нельзя складывать. Источник и подробные условия: Performance Improvements.
Как применить: возьмите свой API списка, один POST с DTO и прогрев кеша. Сравните одинаковые PHP, extensions, данные и режим debug. Запишите не только время HTTP, но и CPU, память и число SQL. Если запрос ждёт базу, ускорение Serializer не обязано заметно изменить его общую длительность.
3. Compiled Event Dispatcher: меньше работы до первого события
Контейнер заранее знает listeners приложения. В 8.2 общий event_dispatcher использует CompiledEventDispatcher: подготовленный список и service locator вместо повторного построения набора closures на каждом запросе.
В опубликованном микробенчмарке с 75 listeners и 31 событием создание dispatcher сократилось с 33,7 до 0,48 мкс. Это время создания конкретного объекта, а не ускорение dispatch или HTTP-запроса в десятки раз.
Динамические addListener/addSubscriber и removeListener/removeSubscriber на общем сервисе deprecated. Временные listeners следует размещать в ScopedEventDispatcher, постоянные — регистрировать как сервисы. Для сервисов, которые только отправляют события, используйте contracts-интерфейс:
use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
final class OrderEvents
{
public function __construct(private EventDispatcherInterface $dispatcher)
{
}
public function publish(object $event): void
{
$this->dispatcher->dispatch($event);
}
}Проверьте и тесты, которые временно добавляют listeners в общий dispatcher. Compiled Event Dispatcher.
4. Выражения компилируются, ошибки находятся раньше
Security expressions и workflow guards переносят больше работы в cache warmup: выражение компилируется в PHP вместо повторного восстановления структуры при выполнении. В официальном примере вычисление занимает около 1 мкс вместо прежних 15–30 мкс восстановления/разбора. В debug compilation пропускается.
Новая команда проверяет выражения, включая controller attributes:
php bin/console lint:expressionsЕё полезно добавить в CI: опечатка в переменной правила доступа должна обнаруживаться до того, как пользователь откроет защищённую страницу. Для своих ExpressionLanguage instances также проверьте настройку ConstantFunctionProvider: unrestricted constant()/enum() deprecated.
Validated and Compiled Expressions.
5. Messenger: concurrency и быстрый AMQP consumer
Новый --concurrency запускает pool обработчиков через amphp/parallel. Это отдельные процессы, либо threads при соответствующем расширении; механизм не делает handler автоматически асинхронным.
composer require amphp/parallel
php bin/console messenger:consume async --concurrency=4В официальном тесте сообщений по 20 мс concurrency=8 дал 7,5× относительно одного worker. Отдельно AMQP prefetch_count переводит получение на consumer с предварительной доставкой; на локальном брокере авторы получили 13–18×. Эти коэффициенты не складываются.
MESSENGER_TRANSPORT_DSN=amqp://guest:guest@localhost:5672/%2f/messages?prefetch_count=20Prefetch выключен по умолчанию и меняет порядок потребления между очередями и поведение при остановке. Batch handlers не ускоряются тем же pool. Также сокращается количество AMQP delay queues за счёт округления задержек, а middleware logging умеет записывать длительность и память обработки. Faster Messenger Workers.
Практический выбор: перед увеличением concurrency оцените доступные соединения к БД, лимиты внешних API и нагрузку на память. Четыре параллельных обработчика могут быстрее упереться в лимит контрагента, чем один.
6. Outbox и Claim Check: сохранить намерение отправить
Outbox связывает запись данных и постановку сообщения в одной БД-транзакции; отдельный relay отправляет сохранённые сообщения настоящему брокеру. В конфигурации основного transport указывается другой transport — outbox:
framework:
messenger:
transports:
orders:
dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
outbox: db_outbox
db_outbox: 'doctrine://default?queue_name=outbox'Outbox должен использовать Doctrine transport и то же DB-соединение, что и прикладная запись. Relay и обработчик запускаются отдельно; порядок пересылки не гарантируется. Одного наличия параметра недостаточно, если данные и outbox пишутся разными транзакциями.
Claim Check решает другую задачу: большие сообщения остаются в общем PSR-6 pool, а в broker передаётся ссылка. TTL должен покрывать задержки, retries и пребывание в failure transport. Такой pool становится частью доставки: его очистка способна удалить ещё нужные payload.
7. Inbox: распознать повторную доставку сообщения
Inbox записывает успешную обработку message ID вместе с прикладными изменениями в той же транзакции. После повторной доставки уже выполненные handlers можно пропустить:
framework:
messenger:
identity_stamps: true
transports:
orders:
dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
inbox: true
buses:
messenger.bus.default:
middleware: [doctrine_transaction]Нужны symfony/doctrine-messenger, одна DB connection с handlers, таблица inbox и retention, покрывающий возможные redeliveries. Batch handlers в этот механизм не входят. Для сообщений DispatchAfterCurrentBus требуется согласованный outbox.
Это защита транзакционно связанных изменений. Уже отправленный внешний HTTP-запрос или письмо не откатывается вместе с БД; общий exactly-once для всех побочных эффектов из этого не следует. Messenger Inbox.
Для команды интеграций это повод проверить сценарий «COMMIT прошёл, ACK не дошёл». Именно на нём простая проверка успешного handler часто оказывается недостаточной.
8. Потоки сообщений: correlation, цепочки и межсистемный обмен
identity_stamps добавляет ID сообщения, causation и общий correlation flow. Пользовательские stamps с PropagatedStampInterface автоматически переходят в сообщения, отправленные из handler. Это упрощает перенос tenant/trace-контекста.
ChainStamp описывает последовательность сообщений; следующий шаг отправляется после выполнения предыдущего всеми handlers. DispatchOnFailureStamp позволяет отправить сообщение при окончательном сбое, но требует отдельного продумывания компенсации: повторная доставка не делает бизнес-откат бесплатным.
Для sync:// появились опциональные retries и failure transport: повторы выполняются сразу, без задержек retry strategy. Messenger Flows.
Для обмена между приложениями новый interop_serializer убирает PHP-specific stamp objects из wire-контракта. Стандартные ID можно передавать простыми headers; serialized type name помогает не привязывать интеграцию к PHP-имени класса. Cross-Application Messaging.
Что проверить: включение identity меняет serialized envelopes. Сначала проверьте совместимость отправителей, получателей и старых сообщений в очереди.
9. Компоненты получают собственные bundles
29 новых bundles выносят конфигурацию и сервисы компонентов из FrameworkBundle. Старые framework.* keys продолжают работать через aliases: массовая перепись конфигов не обязательна и сама по себе не является оптимизацией.
Например, mailer можно описать на корневом уровне:
# config/packages/mailer.yaml
mailer:
dsn: '%env(MAILER_DSN)%'Большинство имён сохраняется, но assets превращается в asset, translator — в translation, workflows — в workflow. debug:config framework mailer заменяется на debug:config mailer. Некоторые классы переезжают в компоненты с deprecation прежних имён.
Новые bundles регистрируются автоматически; их количество не означает, что каждый объект bundle создаётся на каждом production-запросе. Обратите внимание: включение forms больше не включает validation неявно. One Bundle per Component.
Для авторов собственных bundles это изменение границ интеграции. Обновление приложения и поддержка новой структуры в стороннем bundle — две отдельные проверки.
10. JSON Schema для конфигурации и CI
В debug-сборке с установленным YAML Symfony генерирует config/schema.json по деревьям зарегистрированных bundles. Его можно подключить к IDE для подсказок и проверки типов, в дополнение к PHP reference.php.
Для schema-проверки YAML нужен opis/json-schema:
composer require --dev opis/json-schema
php bin/console lint:yaml config/packages/ --check-schema=config/schema.jsonСтатическая схема не выражает все runtime-normalization правила bundles: возможны сообщения о некорректности конфигурации, которую контейнер принимает. Поэтому schema lint дополняет сборку контейнера, а не заменяет её. JSON Schema for Configuration.
В CI полезно различать три проверки: YAML синтаксически корректен, соответствует схеме, контейнер реально компилируется с установленными пакетами.
11. Serializer, generics и доменные accessors
Денормализация разрешает PHPDoc template-типы вроде Page<Product>, когда конкретный тип указан на содержащем свойстве. Нужны PhpStanExtractor и phpstan/phpdoc-parser. Это интерпретация metadata, а не появление native generics в PHP.
Поддерживаются union-типы внутри коллекций. Некорректное значение теперь может вызвать исключение вместо возврата raw array. Для list со значимыми или несмежными ключами появляется deprecation; в Symfony 9 ожидается более строгая ошибка. Generics and Stricter Types.
WithAccessors позволяет явно указать доменные методы:
use Symfony\Component\PropertyInfo\Attribute\WithAccessors;
final class ProductLabel
{
#[WithAccessors(getter: 'label', setter: 'rename')]
private string $name = '';
public function label(): string { return $this->name; }
public function rename(string $name): void { $this->name = $name; }
}PropertyAccess, формы и Serializer могут использовать эту информацию. Также расширена metadata property hooks и virtual properties. Это не автоматический контракт гидратора произвольной ORM. Custom Property Accessors.
12. Формы: меньше дублирования DTO и новые составные поля
Для простых DTO форму можно описать атрибутами AsFormType и FormField. Отдельные FormType не deprecated и остаются подходящими для сложного поведения. Attribute-Based Forms.
use Symfony\Component\Form\Attribute\AsFormType;
use Symfony\Component\Form\Attribute\FormField;
#[AsFormType]
final class ReportFilter
{
#[FormField]
public ?int $limit = null;
#[FormField]
public ?\DateTimeImmutable $startsAt = null;
}Новый type guesser читает PHP-типы обычных DTO: nullable int становится необязательным IntegerType, DateTimeImmutable — соответствующим DateTimeType. Явно заданные types сохраняются. Проверьте также изменение empty values у non-nullable свойств. Forms That Read Your Types.
BoundsType объединяет нижнюю и верхнюю границы; choice_help даёт описание каждому expanded choice, sort_choices сортирует по переведённой метке и locale. Form flows получают вложенные группы шагов. Пользовательские form themes стоит проверить, особенно если они переопределяют form_start и используют form_attr. Form Improvements.
13. Аргументы контроллеров, Lock и Validator
Union/intersection autowiring теперь работает и в controller actions и invokable commands по правилам контейнера. MapQueryParameter и MapRequestHeader могут передавать сложные типы следующим resolvers, например даты и поддерживаемые entities. Это не автоматическая поддержка любой ORM. Smarter Controller Arguments.
Lock attribute ограничивает параллельное выполнение controller по ключу; конкурирующий запрос по умолчанию получает 409. Для нескольких инстансов нужен подходящий общий store. TTL не продлевается автоматически, а blocking не имеет собственного timeout: это важно для долгого импорта. Locking Controllers.
Validator расширяет Callback, Unique и работу с arbitrary precision numbers. Inline callback в attribute может опираться на PHP 8.5: требование конкретного примера не следует путать с минимальным PHP 8.4 для всего Symfony 8.2. Validator Improvements.
14. HTTP Recorder: воспроизводить внешнее API в тестах
RecorderHttpClient записывает HTTP-обмен в HAR и воспроизводит его в следующих тестах. Интеграция использует SymfonyExtension PHPUnit Bridge и UseRecord. В test-окружении включается recorder:
# config/packages/test/http_client.yaml
http_client:
recorder: trueПосле подключения UseRecord к нужному тесту запись отсутствующих запросов включается явно:
SYMFONY_HTTP_RECORDER=missing vendor/bin/phpunit --filter testExchangeRatesПо умолчанию replay не выходит в сеть и завершает тест ошибкой при отсутствии записи. Есть режимы record и passthrough. Секреты маскируются, но HAR перед коммитом всё равно нужно просмотреть: прикладные payload могут содержать данные, не попавшие под стандартные правила.
Для интеграционного проекта это способ стабилизировать тестовый пример ответа контрагента. Отдельные live contract tests всё равно нужны, чтобы обнаруживать изменения настоящего API.
15. Security: OpenID Connect и подтверждение недавнего входа
Встроенный oidc_login подключает OpenID Connect провайдера через discovery. Нужны HttpClient и библиотека проверки JWT; Symfony берёт на себя протокольные проверки, включая state, nonce, PKCE и ID token. Хранение пользователей и сопоставление ролей остаются задачами приложения. OpenID Connect Login.
Sudo mode добавляет IS_AUTHENTICATED_RECENTLY и IS_AUTHENTICATED_VERY_RECENTLY. По умолчанию это два часа и пять минут; remember-me не считается свежим вводом credentials. Подходит для изменения реквизитов, удаления данных и других чувствительных операций.
При собственном login controller нужно отличать повторную аутентификацию от обычного входа, чтобы не отправить уже залогиненного пользователя обратно в интерфейс без подтверждения. Sudo Mode.
Отдельно routes могут выбирать firewall, а общий импорт загружает firewall routes. Перед обновлением проверьте порядок и область действия аутентификации. Firewalls and Routes.
16. Подписи, ротация секретов и управление ключами
Подпись transport проверяется до десериализации payload. Переход от signing отдельных handlers требует учитывать уже лежащие в очереди сообщения. Для подписывающих функций появляются отдельные secrets: первый ключ подписывает новые данные, прежние позволяют проверить ещё действующие подписи. Signed Transports and Secret Rotation.
UriSigner получает version, позволяющий привязать подпись к изменяемому состоянию. Одноразовость возникает после изменения этого состояния, а не от самого verify(). Подпись без expiration deprecated. Single-Use and Safer Signed URLs.
Новый экспериментальный KeyManagement объединяет KMS-интеграции и envelope encryption. У него отдельные provider bridges и контракт, который ещё может меняться. KeyManagement Component.
Также есть encrypted Doctrine columns. Это интеграция с Doctrine ORM/DBAL, а не обещание автоматической работы Encrypted с ModernORM. Проверяйте поддержку выбранного persistence stack отдельно. Encrypted Doctrine Columns.
17. AssetMapper: integrity, обновления и более удобный dev
В 8.2 добавлены integrity hashes import map, minimum_release_age для обновлений npm-зависимостей, reachable entries и metadata_dir. Пример настроек:
framework:
asset_mapper:
importmap_integrity_algorithms: ['sha384']
minimum_release_age: 604800
importmap_entries: reachable
metadata_dir: '%kernel.project_dir%/var/assets'Minimum release age применяется к importmap:update, но не importmap:require. Reachable entries не распознаёт import с переменной-спецификатором; поэтому опция выключена по умолчанию.
В debug игнорируется compiled metadata: случайный локальный asset-map:compile больше не должен скрывать изменения исходных assets. Это изменение относится к 8.2, его нельзя ожидать от нашего текущего Symfony 7.4. AssetMapper Improvements.
18. Ещё несколько изменений, которые стоит открыть отдельно
- JsonSchema component. Генерация JSON Schema/OpenAPI-схем по PHP-типам, metadata Serializer и Validator; полезно для описания API и инструментов агентов. Это не самостоятельная проверка всех бизнес-правил. Подробнее.
- Tui. Вкладки, collapsible panels, keybinding bar и multiselect для terminal UI. Подробнее.
- Порядок listeners. before/after вместо подбора произвольных числовых priorities; порядок разрешается при сборке контейнера. Подробнее.
- Workflow attributes. Дополнительный способ описывать workflows ближе к PHP-коду. Подробнее.
- Mailer. PGP/MIME-подпись и шифрование, provider-hosted templates и контроль tracking. PGP/MIME и шаблоны провайдеров.
- HTTP и WebLink. Trailers, адресный Cache-Control, Cache-Status, link sets и URI templates. Trailers, кеширование и WebLink.
19. Как обновляться и что измерить в своём проекте
- Зафиксировать исходную точку. Список компонентов, PHP/extensions, deprecations и совместимость сторонних bundles. С 7.4 отдельно учитывайте переход на major 8; с 8.1 это обновление minor.
- Проверить реальную доступность версии. На дату статьи последняя опубликованная сборка — beta. Не меняйте production minimum-stability ради эксперимента.
- Собрать тестовый стенд. Полный прогрев кеша, schema/config lint, функциональные тесты и smoke критичных маршрутов.
- Проверить изменения поведения. Logging 4xx, mutations общего dispatcher, строгие коллекции Serializer, формы и старые envelopes Messenger.
- Снять сравнимые замеры. API lists, POST с DTO, dev-render, cache warmup и очередь — как отдельные сценарии.
- Испытать отказы. Повторная доставка, остановка relay, истечение Claim Check, внешнее API недоступно и перезапуск worker.
В этом наборе наиболее интересны не только более дешёвые операции, но и возможность меньше писать собственного кода вокруг доставки, конфигурации и тестовых HTTP-обменов. Каждую новую гарантию стоит проверять на границах своей БД, очереди и внешнего сервиса.
Для диагностики стоимости ORM — обзор ModernORMBundle и Profiler. Для другого уровня сетевой производительности — Polling API в PHP 8.6. Эти возможности не включаются автоматически вместе с обновлением Symfony.
20. Источники и границы обзора
Обзор подготовлен 19 ноября 2026 года по официальной серии Living on the Edge. Проверен список из 48 доступных на эту дату публикаций; ключевые изменения разобраны по соответствующим первоисточникам. Каждое направление снабжено ссылкой на первоисточник.
Цифры производительности приведены из измерений авторов Symfony. На нашем проекте Symfony 8.2 не устанавливался; примеры проверены синтаксически и сверены с официальными публикациями, но не выполнялись на новом framework. Связанные изменения PHP, Twig и сторонних библиотек не следует автоматически приписывать самому Symfony.