Changeset 60796 for trunk/src/wp-includes/html-api/class-wp-html-token.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/html-api/class-wp-html-token.php (modified) (2 diffs)

trunk/src/wp-includes/html-api/class-wp-html-token.php

@@ -117 +117 @@
 
     /**
+     * Unserialize magic method.
+     *
+     * @since 6.9.0
+     *
+     * @param array $data Data to unserialize.
+     */
+    public function __unserialize( $data ) { // phpcs:ignore PHPCompatibility.FunctionNameRestrictions.NewMagicMethods.__unserializeFound
+        throw new \LogicException( __CLASS__ . ' should never be unserialized' );
+    }
+
+    /**
      * Wakeup magic method.
      *
@@ -122 +133 @@
      */
     public function __wakeup() {
-        throw new \LogicException( __CLASS__ . ' should never be unserialized' );
+        $this->__unserialize( array() );
     }
 }