symfony · nicolas-grekas · Jun 6, 2025 · Jun 5, 2025
diff --git a/UPGRADE-8.0.md b/UPGRADE-8.0.md
@@ -12,6 +12,25 @@ HttpClient
  * Remove support for amphp/http-client < 5
  * Remove setLogger() methods on decorators; configure the logger on the wrapped client directly instead
 
+OptionsResolver
+---------------
+
+ * Remove support for nested options definition via `setDefault()`, use `setOptions()` instead
+
+   *Before*
+   ```php
+   $resolver->setDefault('option', function (OptionsResolver $resolver) {
+       // ...
+   });
+   ```
+
+   *After*
+   ```php
+   $resolver->setOptions('option', function (OptionsResolver $resolver) {
+       // ...
+   });
+   ```
+
 TwigBridge
 ----------
 

@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+8.0
+---
+
+* Remove support for nested options definition via `setDefault()`, use `setOptions()` instead
+
 7.3
 ---
 

@@ -229,22 +229,6 @@ public function setDefault(string $option, mixed $value): static
 
                 return $this;
             }
-
-            // Remove in Symfony 8.0.
-            if (isset($params[0]) && ($type = $params[0]->getType()) instanceof \ReflectionNamedType && self::class === $type->getName() && (!isset($params[1]) || (($type = $params[1]->getType()) instanceof \ReflectionNamedType && Options::class === $type->getName()))) {
-                trigger_deprecation('symfony/options-resolver', '7.3', 'Defining nested options via "%s()" is deprecated and will be removed in Symfony 8.0, use "setOptions()" method instead.', __METHOD__);
-                $this->deprecatedNestedOptions[$option] = true;
-
-                // Store closure for later evaluation
-                $this->nested[$option][] = $value;
-                $this->defaults[$option] = [];
-                $this->defined[$option] = true;
-
-                // Make sure the option is processed and is not lazy anymore
-                unset($this->resolved[$option], $this->lazy[$option]);
-
-                return $this;
-            }
         }
 
         // This option is not lazy anymore