Changeset 57815 for branches/6.5/src/wp-includes/html-api/class-wp-html-tag-processor.php

Timestamp:

03/12/2024 02:25:30 PM (20 months ago)

Author:

audrasjb

Message:

HTML API: Defer applying attribute updates until necessary.

When making repeated updates to a document, the Tag Processor will end
up copying the entire document once for every update. This can lead to
catastrophic behavior in the worse case.

However, when batch-applying updates it's able to copy chunks of the
document in one thread and only end up copying the entire document once
for the entire batch.

Previously the Tag Processor has been eagerly applying udpates, but in
this patch it defers applying those updates as long as is possible.
Developed in ​https://github.com/WordPress/wordpress-develop/pull/6120
Discussed in https://core.trac.wordpress.org/ticket/60697

Follow-up to [55706], [56941], [57348].

Reviewed by swissspidy.
Merges [57805] to the to the 6.5 branch.

Props dmsnell, bernhard-reiter, jonsurrell, westonruter.
Fixes #60697.

Location:

branches/6.5

Files:

• . (modified) (1 prop)
• src/wp-includes/html-api/class-wp-html-tag-processor.php (modified) (4 diffs)

branches/6.5/src/wp-includes/html-api/class-wp-html-tag-processor.php

@@ -838 +838 @@
      */
     public function next_token() {
+        return $this->base_class_next_token();
+    }
+
+    /**
+     * Internal method which finds the next token in the HTML document.
+     *
+     * This method is a protected internal function which implements the logic for
+     * finding the next token in a document. It exists so that the parser can update
+     * its state without affecting the location of the cursor in the document and
+     * without triggering subclass methods for things like `next_token()`, e.g. when
+     * applying patches before searching for the next token.
+     *
+     * @since 6.5.0
+     *
+     * @access private
+     *
+     * @return bool Whether a token was parsed.
+     */
+    private function base_class_next_token() {
         $was_at = $this->bytes_already_parsed;
-        $this->get_updated_html();
+        $this->after_tag();
 
         // Don't proceed if there's nothing more to scan.
@@ -2042 +2061 @@
      */
     private function after_tag() {
+        /*
+         * There could be lexical updates enqueued for an attribute that
+         * also exists on the next tag. In order to avoid conflating the
+         * attributes across the two tags, lexical updates with names
+         * need to be flushed to raw lexical updates.
+         */
+        $this->class_name_updates_to_attributes_updates();
+
+        /*
+         * Purge updates if there are too many. The actual count isn't
+         * scientific, but a few values from 100 to a few thousand were
+         * tests to find a practially-useful limit.
+         *
+         * If the update queue grows too big, then the Tag Processor
+         * will spend more time iterating through them and lose the
+         * efficiency gains of deferring applying them.
+         */
+        if ( 1000 < count( $this->lexical_updates ) ) {
+            $this->get_updated_html();
+        }
+
+        foreach ( $this->lexical_updates as $name => $update ) {
+            /*
+             * Any updates appearing after the cursor should be applied
+             * before proceeding, otherwise they may be overlooked.
+             */
+            if ( $update->start >= $this->bytes_already_parsed ) {
+                $this->get_updated_html();
+                break;
+            }
+
+            if ( is_int( $name ) ) {
+                continue;
+            }
+
+            $this->lexical_updates[] = $update;
+            unset( $this->lexical_updates[ $name ] );
+        }
+
         $this->token_starts_at      = null;
         $this->token_length         = null;
@@ -2231 +2289 @@
 
             // Adjust the cursor position by however much an update affects it.
-            if ( $diff->start <= $this->bytes_already_parsed ) {
+            if ( $diff->start < $this->bytes_already_parsed ) {
                 $this->bytes_already_parsed += $shift;
             }
@@ -3165 +3223 @@
          */
         $this->bytes_already_parsed = $before_current_tag;
-        $this->parse_next_tag();
-        // Reparse the attributes.
-        while ( $this->parse_next_attribute() ) {
-            continue;
-        }
-
-        $tag_ends_at                = strpos( $this->html, '>', $this->bytes_already_parsed );
-        $this->token_length         = $tag_ends_at - $this->token_starts_at;
-        $this->bytes_already_parsed = $tag_ends_at;
+        $this->base_class_next_token();
 
         return $this->html;