1780c6ec3d
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: [https://wiki.php.net/rfc/deprecations_php_8_5#deprecate_the_sleep_and_wakeup_magic_methods 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. Built from https://develop.svn.wordpress.org/trunk@60796 git-svn-id: http://core.svn.wordpress.org/trunk@60132 1a063a9b-81f0-0310-95a4-ce76da25c4cd
138 lines
3.6 KiB
PHP
138 lines
3.6 KiB
PHP
<?php
|
|
/**
|
|
* HTML API: WP_HTML_Token class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage HTML-API
|
|
* @since 6.4.0
|
|
*/
|
|
|
|
/**
|
|
* Core class used by the HTML processor during HTML parsing
|
|
* for referring to tokens in the input HTML string.
|
|
*
|
|
* This class is designed for internal use by the HTML processor.
|
|
*
|
|
* @since 6.4.0
|
|
*
|
|
* @access private
|
|
*
|
|
* @see WP_HTML_Processor
|
|
*/
|
|
class WP_HTML_Token {
|
|
/**
|
|
* Name of bookmark corresponding to source of token in input HTML string.
|
|
*
|
|
* Having a bookmark name does not imply that the token still exists. It
|
|
* may be that the source token and underlying bookmark was wiped out by
|
|
* some modification to the source HTML.
|
|
*
|
|
* @since 6.4.0
|
|
*
|
|
* @var string
|
|
*/
|
|
public $bookmark_name = null;
|
|
|
|
/**
|
|
* Name of node; lowercase names such as "marker" are not HTML elements.
|
|
*
|
|
* For HTML elements/tags this value should come from WP_HTML_Processor::get_tag().
|
|
*
|
|
* @since 6.4.0
|
|
*
|
|
* @see WP_HTML_Processor::get_tag()
|
|
*
|
|
* @var string
|
|
*/
|
|
public $node_name = null;
|
|
|
|
/**
|
|
* Whether node contains the self-closing flag.
|
|
*
|
|
* A node may have a self-closing flag when it shouldn't. This value
|
|
* only reports if the flag is present in the original HTML.
|
|
*
|
|
* @since 6.4.0
|
|
*
|
|
* @see https://html.spec.whatwg.org/#self-closing-flag
|
|
*
|
|
* @var bool
|
|
*/
|
|
public $has_self_closing_flag = false;
|
|
|
|
/**
|
|
* Indicates if the element is an HTML element or if it's inside foreign content.
|
|
*
|
|
* @since 6.7.0
|
|
*
|
|
* @var string 'html', 'svg', or 'math'.
|
|
*/
|
|
public $namespace = 'html';
|
|
|
|
/**
|
|
* Indicates which kind of integration point the element is, if any.
|
|
*
|
|
* @since 6.7.0
|
|
*
|
|
* @var string|null 'math', 'html', or null if not an integration point.
|
|
*/
|
|
public $integration_node_type = null;
|
|
|
|
/**
|
|
* Called when token is garbage-collected or otherwise destroyed.
|
|
*
|
|
* @var callable|null
|
|
*/
|
|
public $on_destroy = null;
|
|
|
|
/**
|
|
* Constructor - creates a reference to a token in some external HTML string.
|
|
*
|
|
* @since 6.4.0
|
|
*
|
|
* @param string|null $bookmark_name Name of bookmark corresponding to location in HTML where token is found,
|
|
* or `null` for markers and nodes without a bookmark.
|
|
* @param string $node_name Name of node token represents; if uppercase, an HTML element; if lowercase, a special value like "marker".
|
|
* @param bool $has_self_closing_flag Whether the source token contains the self-closing flag, regardless of whether it's valid.
|
|
* @param callable|null $on_destroy Optional. Function to call when destroying token, useful for releasing the bookmark.
|
|
*/
|
|
public function __construct( ?string $bookmark_name, string $node_name, bool $has_self_closing_flag, ?callable $on_destroy = null ) {
|
|
$this->bookmark_name = $bookmark_name;
|
|
$this->namespace = 'html';
|
|
$this->node_name = $node_name;
|
|
$this->has_self_closing_flag = $has_self_closing_flag;
|
|
$this->on_destroy = $on_destroy;
|
|
}
|
|
|
|
/**
|
|
* Destructor.
|
|
*
|
|
* @since 6.4.0
|
|
*/
|
|
public function __destruct() {
|
|
if ( is_callable( $this->on_destroy ) ) {
|
|
call_user_func( $this->on_destroy, $this->bookmark_name );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @since 6.4.2
|
|
*/
|
|
public function __wakeup() {
|
|
$this->__unserialize( array() );
|
|
}
|
|
}
|