Changeset 60796 for trunk/src/wp-includes/class-wp-theme.php

Timestamp:

09/23/2025 07:26:03 PM (3 months ago)

Author:

SergeyBiryukov

Message:

Code Modernization: Address __sleep() and __wakeup() deprecations in PHP 8.5.

PHP 8.5 deprecates the __sleep() and __wakeup() magic methods in favor of __serialize() and __unserialize():

Deprecated: The __wakeup() serialization magic method has been deprecated. Implement __unserialize() instead (or in addition, if support for old PHP versions is necessary)

For PHP < 7.4 compatibility, __sleep() and __wakeup() need to be kept for the time being.

This commit moves the logic of __wakeup() methods in core to __unserialize(), and turns the former into wrappers. WordPress core does not use __sleep() methods, so these are the only changes required.

Reference: ​PHP RFC: Deprecations for PHP 8.5: Deprecate the __sleep() and __wakeup() magic methods.

Follow-up to [56835], [60787], [60795].

Props TobiasBg, tusharbharti, swissspidy, dmsnell, SergeyBiryukov.
Fixes #63962. See #63061.

File:

• trunk/src/wp-includes/class-wp-theme.php (modified) (2 diffs)

trunk/src/wp-includes/class-wp-theme.php

@@ -784 +784 @@
      *
      * Prevents a callback from being injected during unserialization of an object.
-     */
-    public function __wakeup() {
+     *
+     * @since 6.9.0
+     *
+     * @param array $data Data to unserialize.
+     */
+    public function __unserialize( $data ) { // phpcs:ignore PHPCompatibility.FunctionNameRestrictions.NewMagicMethods.__unserializeFound
         if ( $this->parent && ! $this->parent instanceof self ) {
             throw new UnexpectedValueException();
@@ -798 +802 @@
         }
         $this->headers_sanitized = array();
+    }
+
+    /**
+     * Wakeup magic method.
+     *
+     * @since 6.4.0
+     */
+    public function __wakeup() {
+        $this->__unserialize( array() );
     }