SignatureValidator.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Preferences;
 
use Html;
use MediaWiki\Config\ServiceOptions;
use MediaWiki\MediaWikiServices;
use MediaWiki\SpecialPage\SpecialPageFactory;
use MediaWiki\User\UserIdentity;
use MessageLocalizer;
use MultiHttpClient;
use Parser;
use ParserOptions;
use ParsoidVirtualRESTService;
use SpecialPage;
use TitleFactory;
use VirtualRESTServiceClient;
 
class SignatureValidator {
 
    private const CONSTRUCTOR_OPTIONS = [
        'SignatureAllowedLintErrors',
        'VirtualRestConfig',
    ];
 
    private $user;
    private $localizer;
    private $popts;
    private $parser;
    private $serviceOptions;
    private $specialPageFactory;
    private $titleFactory;
 
    public function __construct( UserIdentity $user, ?MessageLocalizer $localizer, ParserOptions $popts ) {
        $this->user = $user;
        $this->localizer = $localizer;
        $this->popts = $popts;
 
        // TODO inject these
        $services = MediaWikiServices::getInstance();
        // Fetch the parser, will be used to create a new parser via getFreshParser() when needed
        $this->parser = $services->getParser();
        // Configuration
        $this->serviceOptions = new ServiceOptions(
            self::CONSTRUCTOR_OPTIONS,
            $services->getMainConfig()
        );
        $this->serviceOptions->assertRequiredOptions( self::CONSTRUCTOR_OPTIONS );
        // Services
        $this->specialPageFactory = $services->getSpecialPageFactory();
        $this->titleFactory = $services->getTitleFactory();
 
        // TODO SpecialPage::getTitleFor should also be available via SpecialPageFactory
    }
 
    public function validateSignature( string $signature ) {
        $pstSignature = $this->applyPreSaveTransform( $signature );
        if ( $pstSignature === false ) {
            // Return early because the rest of the validation uses wikitext parsing, which requires
            // the pre-save transform to be applied first, and we just found out that the result of the
            // pre-save transform would require *another* pre-save transform, which is crazy
            if ( $this->localizer ) {
                return [ $this->localizer->msg( 'badsigsubst' )->parse() ];
            }
            return true;
        }
 
        $pstWasApplied = false;
        if ( $pstSignature !== $signature ) {
            $pstWasApplied = true;
            $signature = $pstSignature;
        }
 
        $errors = $this->localizer ? [] : false;
 
        $lintErrors = $this->checkLintErrors( $signature );
        if ( $lintErrors ) {
            $allowedLintErrors = $this->serviceOptions->get( 'SignatureAllowedLintErrors' );
            $messages = '';
 
            foreach ( $lintErrors as $error ) {
                if ( $error['type'] === 'multiple-unclosed-formatting-tags' ) {
                    // Always appears with 'missing-end-tag', we can ignore it to simplify the error message
                    continue;
                }
                if ( in_array( $error['type'], $allowedLintErrors, true ) ) {
                    continue;
                }
                if ( !$this->localizer ) {
                    $errors = true;
                    break;
                }
 
                $details = $this->getLintErrorDetails( $error );
                $location = $this->getLintErrorLocation( $error );
                // Messages used here:
                // * linter-pager-bogus-image-options-details
                // * linter-pager-deletable-table-tag-details
                // * linter-pager-html5-misnesting-details
                // * linter-pager-misc-tidy-replacement-issues-details
                // * linter-pager-misnested-tag-details
                // * linter-pager-missing-end-tag-details
                // * linter-pager-multi-colon-escape-details
                // * linter-pager-multiline-html-table-in-list-details
                // * linter-pager-multiple-unclosed-formatting-tags-details
                // * linter-pager-obsolete-tag-details
                // * linter-pager-pwrap-bug-workaround-details
                // * linter-pager-self-closed-tag-details
                // * linter-pager-stripped-tag-details
                // * linter-pager-tidy-font-bug-details
                // * linter-pager-tidy-whitespace-bug-details
                // * linter-pager-unclosed-quotes-in-heading-details
                $label = $this->localizer->msg( "linter-pager-{$error['type']}-details" )->parse();
                $docsLink = new \OOUI\ButtonWidget( [
                    'href' =>
                        "https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Lint_errors/{$error['type']}",
                    'target' => '_blank',
                    'label' => $this->localizer->msg( 'prefs-signature-error-details' )->text(),
                ] );
 
                // If pre-save transform was applied (i.e., the signature has 'subst:' syntax),
                // error locations will be incorrect, because Parsoid can't expand templates.
                // Don't display them.
                $encLocation = $pstWasApplied ? null : json_encode( $location );
 
                $messages .= Html::rawElement(
                    'li',
                    [ 'data-mw-lint-error-location' => $encLocation ],
                    $label . $this->localizer->msg( 'colon-separator' )->escaped() .
                        $details . ' ' . $docsLink
                );
            }
 
            if ( $messages && $this->localizer ) {
                $errors[] = $this->localizer->msg( 'badsightml' )->parse() .
                    Html::rawElement( 'ol', [], $messages );
            }
        }
 
        if ( !$this->checkUserLinks( $signature ) ) {
            if ( $this->localizer ) {
                $userText = wfEscapeWikiText( $this->user->getName() );
                $linkWikitext = $this->localizer->msg( 'signature', $userText, $userText )->inContentLanguage()->text();
                $errors[] = $this->localizer->msg( 'badsiglinks', wfEscapeWikiText( $linkWikitext ) )->parse();
            } else {
                $errors = true;
            }
        }
 
        if ( !$this->checkLineBreaks( $signature ) ) {
            if ( $this->localizer ) {
                $errors[] = $this->localizer->msg( 'badsiglinebreak' )->parse();
            } else {
                $errors = true;
            }
        }
 
        return $errors;
    }
 
    protected function applyPreSaveTransform( string $signature ) {
        // This may be called by the Parser when it's displaying a signature, so we need a new instance
        $parser = $this->parser->getFreshParser();
 
        $pstSignature = $parser->preSaveTransform(
            $signature,
            SpecialPage::getTitleFor( 'Preferences' ),
            $this->user,
            $this->popts
        );
 
        // The signature wikitext contains another '~~~~' or similar (T230652)
        if ( $parser->getOutput()->getFlag( 'user-signature' ) ) {
            return false;
        }
 
        // The signature wikitext contains '{{subst:...}}' markup that produces another subst (T230652)
        $pstPstSignature = $parser->preSaveTransform(
            $pstSignature,
            SpecialPage::getTitleFor( 'Preferences' ),
            $this->user,
            $this->popts
        );
        if ( $pstPstSignature !== $pstSignature ) {
            return false;
        }
 
        return $pstSignature;
    }
 
    protected function checkLintErrors( string $signature ): array {
        // Real check for mismatched HTML tags in the *output*.
        // This has to use Parsoid because PHP Parser doesn't produce this information,
        // it just fixes up the result quietly.
 
        // This request is not cached, but that's okay, because $signature is short (other code checks
        // the length against $wgMaxSigChars).
 
        $vrsConfig = $this->serviceOptions->get( 'VirtualRestConfig' );
        if ( isset( $vrsConfig['modules']['parsoid'] ) ) {
            $params = $vrsConfig['modules']['parsoid'];
            if ( isset( $vrsConfig['global'] ) ) {
                $params = array_merge( $vrsConfig['global'], $params );
            }
            $parsoidVrs = new ParsoidVirtualRESTService( $params );
 
            $vrsClient = new VirtualRESTServiceClient( new MultiHttpClient( [] ) );
            $vrsClient->mount( '/parsoid/', $parsoidVrs );
 
            $request = [
                'method' => 'POST',
                'url' => '/parsoid/local/v3/transform/wikitext/to/lint',
                'body' => [
                    'wikitext' => $signature,
                ],
                'headers' => [
                    // Are both of these are really needed?
                    'User-Agent' => 'MediaWiki/' . MW_VERSION,
                    'Api-User-Agent' => 'MediaWiki/' . MW_VERSION,
                ],
            ];
 
            $response = $vrsClient->run( $request );
            if ( $response['code'] === 200 ) {
                $json = json_decode( $response['body'], true );
                // $json is an array of error objects
                if ( $json ) {
                    return $json;
                }
            }
        }
 
        return [];
    }
 
    protected function checkUserLinks( string $signature ): bool {
        // This may be called by the Parser when it's displaying a signature, so we need a new instance
        $parser = $this->parser->getFreshParser();
 
        // Check for required links. This one's easier to do with the PHP Parser.
        $pout = $parser->parse(
            $signature,
            SpecialPage::getTitleFor( 'Preferences' ),
            $this->popts
        );
 
        // Checking user or talk links is easy
        $links = $pout->getLinks();
        $username = $this->user->getName();
        if (
            isset( $links[ NS_USER ][ strtr( $username, ' ', '_' ) ] ) ||
            isset( $links[ NS_USER_TALK ][ strtr( $username, ' ', '_' ) ] )
        ) {
            return true;
        }
 
        // Checking the contributions link is harder, because the special page name and the username in
        // the "subpage parameter" are not normalized for us.
        $splinks = $pout->getLinksSpecial();
        foreach ( $splinks as $dbkey => $unused ) {
            list( $name, $subpage ) = $this->specialPageFactory->resolveAlias( $dbkey );
            if ( $name === 'Contributions' && $subpage ) {
                $userTitle = $this->titleFactory->makeTitleSafe( NS_USER, $subpage );
                if ( $userTitle && $userTitle->getText() === $username ) {
                    return true;
                }
            }
        }
 
        return false;
    }
 
    protected function checkLineBreaks( string $signature ): bool {
        return !preg_match( "/[\r\n]/", $signature );
    }
 
    // Adapted from the Linter extension
    private function getLintErrorLocation( array $lintError ): array {
        return array_slice( $lintError['dsr'], 0, 2 );
    }
 
    // Adapted from the Linter extension
    private function getLintErrorDetails( array $lintError ): string {
        [ 'type' => $type, 'params' => $params ] = $lintError;
 
        if ( $type === 'bogus-image-options' && isset( $params['items'] ) ) {
            $list = array_map( static function ( $in ) {
                return Html::element( 'code', [], $in );
            }, $params['items'] );
            return implode(
                $this->localizer->msg( 'comma-separator' )->escaped(),
                $list
            );
        } elseif ( $type === 'pwrap-bug-workaround' &&
            isset( $params['root'] ) &&
            isset( $params['child'] ) ) {
            return Html::element( 'code', [],
                $params['root'] . " > " . $params['child'] );
        } elseif ( $type === 'tidy-whitespace-bug' &&
            isset( $params['node'] ) &&
            isset( $params['sibling'] ) ) {
            return Html::element( 'code', [],
                $params['node'] . " + " . $params['sibling'] );
        } elseif ( $type === 'multi-colon-escape' &&
            isset( $params['href'] ) ) {
            return Html::element( 'code', [], $params['href'] );
        } elseif ( $type === 'multiline-html-table-in-list' ) {
            /* ancestor and name will be set */
            return Html::element( 'code', [],
                $params['ancestorName'] . " > " . $params['name'] );
        } elseif ( $type === 'misc-tidy-replacement-issues' ) {
            /* There will be a 'subtype' param to disambiguate */
            return Html::element( 'code', [], $params['subtype'] );
        } elseif ( $type === 'missing-end-tag' ) {
            return Html::element( 'code', [], '</' . $params['name'] . '>' );
        } elseif ( isset( $params['name'] ) ) {
            return Html::element( 'code', [], $params['name'] );
        }
 
        return '';
    }
 
}