[Validator] Deprecate implementing __sleep/wakeup() on GenericMetadata implementations

nicolas-grekas · nicolas-grekas · commit eb940c91a068 · 2025-08-14T15:24:33.000+02:00
diff --git a/AbstractString.php b/AbstractString.php
@@ -729,9 +729,7 @@ public function __serialize(): array
     }
 
     /**
-     * @internal since Symfony 7.4, will be removed in 8.0
-     *
-     * @final since Symfony 7.4, will be removed in 8.0
+     * @deprecated since Symfony 7.4, will be replaced by `__unserialize()` in 8.0
      */
     public function __sleep(): array
     {
diff --git a/LazyString.php b/LazyString.php
@@ -126,12 +126,12 @@ public function __serialize(): array
     }
 
     /**
-     * @internal since Symfony 7.4, will be removed in 8.0
-     *
-     * @final since Symfony 7.4, will be removed in 8.0
+     * @deprecated since Symfony 7.4, will be replaced by `__serialize()` in 8.0
      */
     public function __sleep(): array
     {
+        trigger_deprecation('symfony/string', '7.4', 'Calling "%s::__sleep()" is deprecated, use "__serialize()" instead.', get_debug_type($this));
+
         $this->__toString();
 
         return ['value'];
diff --git a/UnicodeString.php b/UnicodeString.php
@@ -406,9 +406,7 @@ public function __unserialize(array $data): void
     }
 
     /**
-     * @internal since Symfony 7.4, will be removed in 8.0
-     *
-     * @final since Symfony 7.4, will be removed in 8.0
+     * @deprecated since Symfony 7.4, will be replaced by `__unserialize()` in 8.0
      */
     public function __wakeup(): void
     {

Original file line number	Diff line number	Diff line change
`@@ -729,9 +729,7 @@ public function __serialize(): array`
`729`	`729`	`}`
`730`	`730`
`731`	`731`	`/**`
`732`		`- * @internal since Symfony 7.4, will be removed in 8.0`
`733`		`- *`
`734`		`- * @final since Symfony 7.4, will be removed in 8.0`
	`732`	+ * @deprecated since Symfony 7.4, will be replaced by `__unserialize()` in 8.0
`735`	`733`	`*/`
`736`	`734`	`public function __sleep(): array`
`737`	`735`	`{`
Original file line number	Diff line number	Diff line change
`@@ -126,12 +126,12 @@ public function __serialize(): array`
`126`	`126`	`}`
`127`	`127`
`128`	`128`	`/**`
`129`		`- * @internal since Symfony 7.4, will be removed in 8.0`
`130`		`- *`
`131`		`- * @final since Symfony 7.4, will be removed in 8.0`
	`129`	+ * @deprecated since Symfony 7.4, will be replaced by `__serialize()` in 8.0
`132`	`130`	`*/`
`133`	`131`	`public function __sleep(): array`
`134`	`132`	`{`
	`133`	`+ trigger_deprecation('symfony/string', '7.4', 'Calling "%s::__sleep()" is deprecated, use "__serialize()" instead.', get_debug_type($this));`
	`134`	`+`
`135`	`135`	`$this->__toString();`
`136`	`136`
`137`	`137`	`return ['value'];`
Original file line number	Diff line number	Diff line change
`@@ -406,9 +406,7 @@ public function __unserialize(array $data): void`
`406`	`406`	`}`
`407`	`407`
`408`	`408`	`/**`
`409`		`- * @internal since Symfony 7.4, will be removed in 8.0`
`410`		`- *`
`411`		`- * @final since Symfony 7.4, will be removed in 8.0`
	`409`	+ * @deprecated since Symfony 7.4, will be replaced by `__unserialize()` in 8.0
`412`	`410`	`*/`
`413`	`411`	`public function __wakeup(): void`
`414`	`412`	`{`