OutputTransformPipeline.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\OutputTransform;
 
use MediaWiki\Parser\ParserOutput;
use ParserOptions;
 
class OutputTransformPipeline {
 
    private array $stages = [];
 
    public function addStage( OutputTransformStage $stage ): OutputTransformPipeline {
        $this->stages[] = $stage;
        return $this;
    }
 
    public function run( ParserOutput $in, ?ParserOptions $popts, array $options ): ParserOutput {
        if ( $options['suppressClone'] ?? false ) {
            // T353257: This should be a clone, but we've need to suppress it
            // for some legacy codepaths.
            $out = $in;
        } else {
            $out = clone $in;
        }
        foreach ( $this->stages as $stage ) {
            if ( $stage->shouldRun( $out, $popts, $options ) ) {
                // Some stages may (for now) modify $options. See OutputTransformStage documentation for more info.
                $out = $stage->transform( $out, $popts, $options );
            }
        }
        return $out;
    }
}