UPGRADE FROM 7.0 to 7.1

Symfony 7.1 is a minor release. According to the Symfony release process, there should be no significant backward compatibility breaks. Minor backward compatibility breaks are prefixed in this document with [BC BREAK], make sure your code is compatible with these entries before upgrading. Read more about this in the Symfony documentation.

If you're upgrading from a version below 7.0, follow the 7.0 upgrade guide first.

Table of Contents

Bundles

• FrameworkBundle
• SecurityBundle
• TwigBundle

Bridges

• DoctrineBridge

Components

• AssetMapper
• Cache
• DependencyInjection
• ExpressionLanguage
• Form
• Intl
• HttpClient
• HttpKernel
• Security
• Serializer
• Translation
• Workflow

AssetMapper

• Deprecate ImportMapConfigReader::splitPackageNameAndFilePath(), use ImportMapEntry::splitPackageNameAndFilePath() instead

Cache

• Deprecate CouchbaseBucketAdapter, use CouchbaseCollectionAdapter with Couchbase 3 instead
• The algorithm for the default cache namespace changed from SHA256 to XXH128

DependencyInjection

• [BC BREAK] When used in the prependExtension() method, the ContainerConfigurator::import() method now prepends the configuration instead of appending it

• Deprecate #[TaggedIterator] and #[TaggedLocator] attributes, use #[AutowireIterator] and #[AutowireLocator] instead

  Before

  use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
  use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
  
  class HandlerCollection
  {
      public function __construct(
          #[TaggedIterator('app.handler', indexAttribute: 'key')]
          iterable $handlers,
  
          #[TaggedLocator('app.handler')]
          private ContainerInterface $locator,
      ) {
      }
  }

  After

  use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
  use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
  
  class HandlerCollection
  {
      public function __construct(
          #[AutowireIterator('app.handler', indexAttribute: 'key')]
          iterable $handlers,
  
          #[AutowireLocator('app.handler')]
          private ContainerInterface $locator,
      ) {
      }
  }

DoctrineBridge

• Mark class ProxyCacheWarmer as final

ExpressionLanguage

• Deprecate passing null as the allowed variable names to ExpressionLanguage::lint() and Parser::lint(), pass the IGNORE_UNKNOWN_VARIABLES flag instead to ignore unknown variables during linting

  Before

  $expressionLanguage->lint('a + 1', null);

  After

  use Symfony\Component\ExpressionLanguage\Parser;
  
  $expressionLanguage->lint('a + 1', [], Parser::IGNORE_UNKNOWN_VARIABLES);

Form

• Deprecate not configuring the default_protocol option of the UrlType, it will default to null in 8.0 (the current default is 'http')

FrameworkBundle

• [BC BREAK] Enabling framework.rate_limiter requires symfony/rate-limiter 7.1 or higher
• Mark classes ConfigBuilderCacheWarmer, Router, SerializerCacheWarmer, TranslationsCacheWarmer, Translator and ValidatorCacheWarmer as final
• Deprecate the router.cache_dir config option, the Router will always use the kernel.build_dir parameter
• Reset env vars when resetting the container

HttpClient

• Deprecate the setLogger() methods of the NoPrivateNetworkHttpClient, TraceableHttpClient and ScopingHttpClient classes, configure the logger of the wrapped clients directly instead

  Before

  // ...
  use Symfony\Component\HttpClient\HttpClient;
  use Symfony\Component\HttpClient\NoPrivateNetworkHttpClient;
  
  $publicClient = new NoPrivateNetworkHttpClient(HttpClient::create());
  $publicClient->setLogger(new Logger());

  After

  // ...
  use Symfony\Component\HttpClient\HttpClient;
  use Symfony\Component\HttpClient\NoPrivateNetworkHttpClient;
  
  $client = HttpClient::create();
  $client->setLogger(new Logger());
  
  $publicClient = new NoPrivateNetworkHttpClient($client);

HttpKernel

• The Extension class is marked as internal, extend the Extension class from the DependencyInjection component instead
• Deprecate Extension::addAnnotatedClassesToCompile()
• Deprecate AddAnnotatedClassesToCachePass
• Deprecate the setAnnotatedClassCache() and getAnnotatedClassesToCompile() methods of the Kernel class
• Deprecate the addAnnotatedClassesToCompile() and getAnnotatedClassesToCompile() methods of the Extension class

Intl

• [BC BREAK] Extracted EmojiTransliterator to a separate symfony/emoji component, the new FQCN is Symfony\Component\Emoji\EmojiTransliterator. You must install the symfony/emoji component if you're using the old EmojiTransliterator class in the Intl component.

Mailer

• Postmark's "406 - Inactive recipient" API error code now results in a PostmarkDeliveryEvent instead of throwing a HttpTransportException

Security

• Change the first and second argument of OidcTokenHandler to Jose\Component\Core\AlgorithmManager and Jose\Component\Core\JWKSet respectively

SecurityBundle

• Mark class ExpressionCacheWarmer as final

• Deprecate options algorithm and key of oidc token handler, use algorithms and keyset instead

  Before

  security:
      firewalls:
          main:
              access_token:
                  token_handler:
                      oidc:
                          algorithm: 'ES256'
                          key: '{"kty":"...","k":"..."}'
                          # ...

  After

  security:
      firewalls:
          main:
              access_token:
                  token_handler:
                      oidc:
                          algorithms: ['ES256']
                          keyset: '{"keys":[{"kty":"...","k":"..."}]}'
                          # ...

• Deprecate the security.access_token_handler.oidc.jwk service, use security.access_token_handler.oidc.jwkset instead

Serializer

• Deprecate the withDefaultContructorArguments() method of AbstractNormalizerContextBuilder, use withDefaultConstructorArguments() instead (note the typo in the old method name)

Translation

• Mark class DataCollectorTranslator as final

TwigBundle

• Mark class TemplateCacheWarmer as final
• Deprecate the base_template_class config option, this option is no-op when using Twig 3+

Validator

• Deprecate not passing a value for the requireTld option to the Url constraint (the default value will become true in 8.0)
• Deprecate Bic::INVALID_BANK_CODE_ERROR, as ISO 9362 defines no restrictions on BIC bank code characters

Workflow

• Add method getEnabledTransition() to WorkflowInterface
• Add $nbToken argument to Marking::mark() and Marking::unmark()