PPFrame_DOM.php

Go to the documentation of this file.

<?php
// phpcs:ignore Squiz.Classes.ValidClassName.NotCamelCaps
class PPFrame_DOM implements PPFrame {

    public $preprocessor;

    public $parser;

    public $title;
    public $titleCache;

    public $loopCheckHash;

    public $depth;

    private $volatile = false;
    private $ttl = null;

    protected $childExpansionCache;

    public function __construct( $preprocessor ) {
        $this->preprocessor = $preprocessor;
        $this->parser = $preprocessor->parser;
        $this->title = $this->parser->getTitle();
        $this->titleCache = [ $this->title ? $this->title->getPrefixedDBkey() : false ];
        $this->loopCheckHash = [];
        $this->depth = 0;
        $this->childExpansionCache = [];
    }

    public function newChild( $args = false, $title = false, $indexOffset = 0 ) {
        $namedArgs = [];
        $numberedArgs = [];
        if ( $title === false ) {
            $title = $this->title;
        }
        if ( $args !== false ) {
            $xpath = false;
            if ( $args instanceof PPNode_DOM ) {
                $args = $args->node;
            }
            // @phan-suppress-next-line PhanTypeSuspiciousNonTraversableForeach
            foreach ( $args as $arg ) {
                if ( $arg instanceof PPNode_DOM ) {
                    $arg = $arg->node;
                }
                if ( !$xpath || $xpath->document !== $arg->ownerDocument ) {
                    $xpath = new DOMXPath( $arg->ownerDocument );
                }

                $nameNodes = $xpath->query( 'name', $arg );
                $value = $xpath->query( 'value', $arg );
                if ( $nameNodes->item( 0 )->hasAttributes() ) {
                    // Numbered parameter
                    $index = $nameNodes->item( 0 )->attributes->getNamedItem( 'index' )->textContent;
                    $index = $index - $indexOffset;
                    if ( isset( $namedArgs[$index] ) || isset( $numberedArgs[$index] ) ) {
                        $this->parser->getOutput()->addWarning( wfMessage( 'duplicate-args-warning',
                            wfEscapeWikiText( $this->title ),
                            wfEscapeWikiText( $title ),
                            wfEscapeWikiText( $index ) )->text() );
                        $this->parser->addTrackingCategory( 'duplicate-args-category' );
                    }
                    $numberedArgs[$index] = $value->item( 0 );
                    unset( $namedArgs[$index] );
                } else {
                    // Named parameter
                    $name = trim( $this->expand( $nameNodes->item( 0 ), PPFrame::STRIP_COMMENTS ) );
                    if ( isset( $namedArgs[$name] ) || isset( $numberedArgs[$name] ) ) {
                        $this->parser->getOutput()->addWarning( wfMessage( 'duplicate-args-warning',
                            wfEscapeWikiText( $this->title ),
                            wfEscapeWikiText( $title ),
                            wfEscapeWikiText( $name ) )->text() );
                        $this->parser->addTrackingCategory( 'duplicate-args-category' );
                    }
                    $namedArgs[$name] = $value->item( 0 );
                    unset( $numberedArgs[$name] );
                }
            }
        }
        return new PPTemplateFrame_DOM( $this->preprocessor, $this, $numberedArgs, $namedArgs, $title );
    }

    public function cachedExpand( $key, $root, $flags = 0 ) {
        // we don't have a parent, so we don't have a cache
        return $this->expand( $root, $flags );
    }

    public function expand( $root, $flags = 0 ) {
        static $expansionDepth = 0;
        if ( is_string( $root ) ) {
            return $root;
        }

        if ( ++$this->parser->mPPNodeCount > $this->parser->mOptions->getMaxPPNodeCount() ) {
            $this->parser->limitationWarn( 'node-count-exceeded',
                $this->parser->mPPNodeCount,
                $this->parser->mOptions->getMaxPPNodeCount()
            );
            return '<span class="error">Node-count limit exceeded</span>';
        }

        if ( $expansionDepth > $this->parser->mOptions->getMaxPPExpandDepth() ) {
            $this->parser->limitationWarn( 'expansion-depth-exceeded',
                $expansionDepth,
                $this->parser->mOptions->getMaxPPExpandDepth()
            );
            return '<span class="error">Expansion depth limit exceeded</span>';
        }
        ++$expansionDepth;
        if ( $expansionDepth > $this->parser->mHighestExpansionDepth ) {
            $this->parser->mHighestExpansionDepth = $expansionDepth;
        }

        if ( $root instanceof PPNode_DOM ) {
            $root = $root->node;
        }
        if ( $root instanceof DOMDocument ) {
            $root = $root->documentElement;
        }

        $outStack = [ '', '' ];
        $iteratorStack = [ false, $root ];
        $indexStack = [ 0, 0 ];

        while ( count( $iteratorStack ) > 1 ) {
            $level = count( $outStack ) - 1;
            $iteratorNode =& $iteratorStack[$level];
            $out =& $outStack[$level];
            $index =& $indexStack[$level];

            if ( $iteratorNode instanceof PPNode_DOM ) {
                $iteratorNode = $iteratorNode->node;
            }

            if ( is_array( $iteratorNode ) ) {
                if ( $index >= count( $iteratorNode ) ) {
                    // All done with this iterator
                    $iteratorStack[$level] = false;
                    $contextNode = false;
                } else {
                    $contextNode = $iteratorNode[$index];
                    $index++;
                }
            } elseif ( $iteratorNode instanceof DOMNodeList ) {
                if ( $index >= $iteratorNode->length ) {
                    // All done with this iterator
                    $iteratorStack[$level] = false;
                    $contextNode = false;
                } else {
                    $contextNode = $iteratorNode->item( $index );
                    $index++;
                }
            } else {
                // Copy to $contextNode and then delete from iterator stack,
                // because this is not an iterator but we do have to execute it once
                $contextNode = $iteratorStack[$level];
                $iteratorStack[$level] = false;
            }

            if ( $contextNode instanceof PPNode_DOM ) {
                $contextNode = $contextNode->node;
            }

            $newIterator = false;

            if ( $contextNode === false ) {
                // nothing to do
            } elseif ( is_string( $contextNode ) ) {
                $out .= $contextNode;
            } elseif ( is_array( $contextNode ) || $contextNode instanceof DOMNodeList ) {
                $newIterator = $contextNode;
            } elseif ( $contextNode instanceof DOMNode ) {
                if ( $contextNode->nodeType == XML_TEXT_NODE ) {
                    $out .= $contextNode->nodeValue;
                } elseif ( $contextNode->nodeName == 'template' ) {
                    # Double-brace expansion
                    $xpath = new DOMXPath( $contextNode->ownerDocument );
                    $titles = $xpath->query( 'title', $contextNode );
                    $title = $titles->item( 0 );
                    $parts = $xpath->query( 'part', $contextNode );
                    if ( $flags & PPFrame::NO_TEMPLATES ) {
                        $newIterator = $this->virtualBracketedImplode( '{{', '|', '}}', $title, $parts );
                    } else {
                        $lineStart = $contextNode->getAttribute( 'lineStart' );
                        $params = [
                            'title' => new PPNode_DOM( $title ),
                            'parts' => new PPNode_DOM( $parts ),
                            'lineStart' => $lineStart ];
                        $ret = $this->parser->braceSubstitution( $params, $this );
                        if ( isset( $ret['object'] ) ) {
                            $newIterator = $ret['object'];
                        } else {
                            $out .= $ret['text'];
                        }
                    }
                } elseif ( $contextNode->nodeName == 'tplarg' ) {
                    # Triple-brace expansion
                    $xpath = new DOMXPath( $contextNode->ownerDocument );
                    $titles = $xpath->query( 'title', $contextNode );
                    $title = $titles->item( 0 );
                    $parts = $xpath->query( 'part', $contextNode );
                    if ( $flags & PPFrame::NO_ARGS ) {
                        $newIterator = $this->virtualBracketedImplode( '{{{', '|', '}}}', $title, $parts );
                    } else {
                        $params = [
                            'title' => new PPNode_DOM( $title ),
                            'parts' => new PPNode_DOM( $parts ) ];
                        $ret = $this->parser->argSubstitution( $params, $this );
                        if ( isset( $ret['object'] ) ) {
                            $newIterator = $ret['object'];
                        } else {
                            $out .= $ret['text'];
                        }
                    }
                } elseif ( $contextNode->nodeName == 'comment' ) {
                    # HTML-style comment
                    # Remove it in HTML, pre+remove and STRIP_COMMENTS modes
                    # Not in RECOVER_COMMENTS mode (msgnw) though.
                    if ( ( $this->parser->ot['html']
                        || ( $this->parser->ot['pre'] && $this->parser->mOptions->getRemoveComments() )
                        || ( $flags & PPFrame::STRIP_COMMENTS )
                        ) && !( $flags & PPFrame::RECOVER_COMMENTS )
                    ) {
                        $out .= '';
                    } elseif ( $this->parser->ot['wiki'] && !( $flags & PPFrame::RECOVER_COMMENTS ) ) {
                        # Add a strip marker in PST mode so that pstPass2() can
                        # run some old-fashioned regexes on the result.
                        # Not in RECOVER_COMMENTS mode (extractSections) though.
                        $out .= $this->parser->insertStripItem( $contextNode->textContent );
                    } else {
                        # Recover the literal comment in RECOVER_COMMENTS and pre+no-remove
                        $out .= $contextNode->textContent;
                    }
                } elseif ( $contextNode->nodeName == 'ignore' ) {
                    # Output suppression used by <includeonly> etc.
                    # OT_WIKI will only respect <ignore> in substed templates.
                    # The other output types respect it unless NO_IGNORE is set.
                    # extractSections() sets NO_IGNORE and so never respects it.
                    if ( ( !isset( $this->parent ) && $this->parser->ot['wiki'] )
                        || ( $flags & PPFrame::NO_IGNORE )
                    ) {
                        $out .= $contextNode->textContent;
                    } else {
                        $out .= '';
                    }
                } elseif ( $contextNode->nodeName == 'ext' ) {
                    # Extension tag
                    $xpath = new DOMXPath( $contextNode->ownerDocument );
                    $names = $xpath->query( 'name', $contextNode );
                    $attrs = $xpath->query( 'attr', $contextNode );
                    $inners = $xpath->query( 'inner', $contextNode );
                    $closes = $xpath->query( 'close', $contextNode );
                    if ( $flags & PPFrame::NO_TAGS ) {
                        $s = '<' . $this->expand( $names->item( 0 ), $flags );
                        if ( $attrs->length > 0 ) {
                            $s .= $this->expand( $attrs->item( 0 ), $flags );
                        }
                        if ( $inners->length > 0 ) {
                            $s .= '>' . $this->expand( $inners->item( 0 ), $flags );
                            if ( $closes->length > 0 ) {
                                $s .= $this->expand( $closes->item( 0 ), $flags );
                            }
                        } else {
                            $s .= '/>';
                        }
                        $out .= $s;
                    } else {
                        $params = [
                            'name' => new PPNode_DOM( $names->item( 0 ) ),
                            'attr' => $attrs->length > 0 ? new PPNode_DOM( $attrs->item( 0 ) ) : null,
                            'inner' => $inners->length > 0 ? new PPNode_DOM( $inners->item( 0 ) ) : null,
                            'close' => $closes->length > 0 ? new PPNode_DOM( $closes->item( 0 ) ) : null,
                        ];
                        $out .= $this->parser->extensionSubstitution( $params, $this );
                    }
                } elseif ( $contextNode->nodeName == 'h' ) {
                    # Heading
                    $s = $this->expand( $contextNode->childNodes, $flags );

                    # Insert a heading marker only for <h> children of <root>
                    # This is to stop extractSections from going over multiple tree levels
                    if ( $contextNode->parentNode->nodeName == 'root' && $this->parser->ot['html'] ) {
                        # Insert heading index marker
                        $headingIndex = $contextNode->getAttribute( 'i' );
                        $titleText = $this->title->getPrefixedDBkey();
                        $this->parser->mHeadings[] = [ $titleText, $headingIndex ];
                        $serial = count( $this->parser->mHeadings ) - 1;
                        $marker = Parser::MARKER_PREFIX . "-h-$serial-" . Parser::MARKER_SUFFIX;
                        $count = $contextNode->getAttribute( 'level' );
                        $s = substr( $s, 0, $count ) . $marker . substr( $s, $count );
                        $this->parser->mStripState->addGeneral( $marker, '' );
                    }
                    $out .= $s;
                } else {
                    # Generic recursive expansion
                    $newIterator = $contextNode->childNodes;
                }
            } else {
                throw new MWException( __METHOD__ . ': Invalid parameter type' );
            }

            if ( $newIterator !== false ) {
                if ( $newIterator instanceof PPNode_DOM ) {
                    $newIterator = $newIterator->node;
                }
                $outStack[] = '';
                $iteratorStack[] = $newIterator;
                $indexStack[] = 0;
            } elseif ( $iteratorStack[$level] === false ) {
                // Return accumulated value to parent
                // With tail recursion
                while ( $iteratorStack[$level] === false && $level > 0 ) {
                    $outStack[$level - 1] .= $out;
                    array_pop( $outStack );
                    array_pop( $iteratorStack );
                    array_pop( $indexStack );
                    $level--;
                }
            }
        }
        --$expansionDepth;
        return $outStack[0];
    }

    public function implodeWithFlags( $sep, $flags, ...$args ) {
        $first = true;
        $s = '';
        foreach ( $args as $root ) {
            if ( $root instanceof PPNode_DOM ) {
                $root = $root->node;
            }
            if ( !is_array( $root ) && !( $root instanceof DOMNodeList ) ) {
                $root = [ $root ];
            }
            foreach ( $root as $node ) {
                if ( $first ) {
                    $first = false;
                } else {
                    $s .= $sep;
                }
                $s .= $this->expand( $node, $flags );
            }
        }
        return $s;
    }

    public function implode( $sep, ...$args ) {
        $first = true;
        $s = '';
        foreach ( $args as $root ) {
            if ( $root instanceof PPNode_DOM ) {
                $root = $root->node;
            }
            if ( !is_array( $root ) && !( $root instanceof DOMNodeList ) ) {
                $root = [ $root ];
            }
            foreach ( $root as $node ) {
                if ( $first ) {
                    $first = false;
                } else {
                    $s .= $sep;
                }
                $s .= $this->expand( $node );
            }
        }
        return $s;
    }

    public function virtualImplode( $sep, ...$args ) {
        $out = [];
        $first = true;

        foreach ( $args as $root ) {
            if ( $root instanceof PPNode_DOM ) {
                $root = $root->node;
            }
            if ( !is_array( $root ) && !( $root instanceof DOMNodeList ) ) {
                $root = [ $root ];
            }
            foreach ( $root as $node ) {
                if ( $first ) {
                    $first = false;
                } else {
                    $out[] = $sep;
                }
                $out[] = $node;
            }
        }
        return $out;
    }

    public function virtualBracketedImplode( $start, $sep, $end, ...$args ) {
        $out = [ $start ];
        $first = true;

        foreach ( $args as $root ) {
            if ( $root instanceof PPNode_DOM ) {
                $root = $root->node;
            }
            if ( !is_array( $root ) && !( $root instanceof DOMNodeList ) ) {
                $root = [ $root ];
            }
            foreach ( $root as $node ) {
                if ( $first ) {
                    $first = false;
                } else {
                    $out[] = $sep;
                }
                $out[] = $node;
            }
        }
        $out[] = $end;
        return $out;
    }

    public function __toString() {
        return 'frame{}';
    }

    public function getPDBK( $level = false ) {
        if ( $level === false ) {
            return $this->title->getPrefixedDBkey();
        } else {
            return $this->titleCache[$level] ?? false;
        }
    }

    public function getArguments() {
        return [];
    }

    public function getNumberedArguments() {
        return [];
    }

    public function getNamedArguments() {
        return [];
    }

    public function isEmpty() {
        return true;
    }

    public function getArgument( $name ) {
        return false;
    }

    public function loopCheck( $title ) {
        return !isset( $this->loopCheckHash[$title->getPrefixedDBkey()] );
    }

    public function isTemplate() {
        return false;
    }

    public function getTitle() {
        return $this->title;
    }

    public function setVolatile( $flag = true ) {
        $this->volatile = $flag;
    }

    public function isVolatile() {
        return $this->volatile;
    }

    public function setTTL( $ttl ) {
        if ( $ttl !== null && ( $this->ttl === null || $ttl < $this->ttl ) ) {
            $this->ttl = $ttl;
        }
    }

    public function getTTL() {
        return $this->ttl;
    }
}