MachineReadableRCFeedFormatter.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\RCFeed;
 
use MediaWiki\MainConfigNames;
use MediaWiki\MediaWikiServices;
use MediaWiki\RecentChanges\RecentChange;
use MediaWiki\WikiMap\WikiMap;
use Wikimedia\Timestamp\TimestampFormat as TS;
 
abstract class MachineReadableRCFeedFormatter implements RCFeedFormatter {
 
    abstract protected function formatArray( array $packet );
 
    public function getLine( array $feed, RecentChange $rc, $actionComment ) {
        $services = MediaWikiServices::getInstance();
        $recentChangeRCFeedNotifier = $services->getRecentChangeRCFeedNotifier();
        $recentChangeLookup = $services->getRecentChangeLookup();
        $mainConfig = $services->getMainConfig();
        $canonicalServer = $mainConfig->get( MainConfigNames::CanonicalServer );
        $serverName = $mainConfig->get( MainConfigNames::ServerName );
        $scriptPath = $mainConfig->get( MainConfigNames::ScriptPath );
        $packet = [
            // Usually, RC ID is exposed only for patrolling purposes,
            // but there is no real reason not to expose it in other cases,
            // and I can see how this may be potentially useful for clients.
            'id' => $rc->getAttribute( 'rc_id' ),
            'type' => $recentChangeLookup->convertSourceToType( $rc->getAttribute( 'rc_source' ) ),
            'namespace' => $rc->getTitle()->getNamespace(),
            'title' => $rc->getTitle()->getPrefixedText(),
            'title_url' => $rc->getTitle()->getCanonicalURL(),
            'comment' => $rc->getAttribute( 'rc_comment' ),
            'timestamp' => (int)wfTimestamp( TS::UNIX, $rc->getAttribute( 'rc_timestamp' ) ),
            'user' => $rc->getAttribute( 'rc_user_text' ),
            'bot' => (bool)$rc->getAttribute( 'rc_bot' ),
            'notify_url' => $recentChangeRCFeedNotifier->getNotifyUrl( $rc ),
        ];
 
        if ( isset( $feed['channel'] ) ) {
            $packet['channel'] = $feed['channel'];
        }
 
        $source = $rc->getAttribute( 'rc_source' );
        if ( $source == RecentChange::SRC_EDIT || $source == RecentChange::SRC_NEW ) {
            $useRCPatrol = $services->getMainConfig()->get( MainConfigNames::UseRCPatrol );
            $useNPPatrol = $services->getMainConfig()->get( MainConfigNames::UseNPPatrol );
            $packet['minor'] = (bool)$rc->getAttribute( 'rc_minor' );
            if ( $useRCPatrol || ( $source == RecentChange::SRC_NEW && $useNPPatrol ) ) {
                $packet['patrolled'] = (bool)$rc->getAttribute( 'rc_patrolled' );
            }
        }
 
        switch ( $source ) {
            case RecentChange::SRC_EDIT:
                $packet['length'] = [
                    'old' => $rc->getAttribute( 'rc_old_len' ),
                    'new' => $rc->getAttribute( 'rc_new_len' )
                ];
                $packet['revision'] = [
                    'old' => $rc->getAttribute( 'rc_last_oldid' ),
                    'new' => $rc->getAttribute( 'rc_this_oldid' )
                ];
                break;
 
            case RecentChange::SRC_NEW:
                $packet['length'] = [ 'old' => null, 'new' => $rc->getAttribute( 'rc_new_len' ) ];
                $packet['revision'] = [ 'old' => null, 'new' => $rc->getAttribute( 'rc_this_oldid' ) ];
                break;
 
            case RecentChange::SRC_LOG:
                $packet['log_id'] = $rc->getAttribute( 'rc_logid' );
                $packet['log_type'] = $rc->getAttribute( 'rc_log_type' );
                $packet['log_action'] = $rc->getAttribute( 'rc_log_action' );
                if ( $rc->getAttribute( 'rc_params' ) ) {
                    $params = $rc->parseParams();
                    if (
                        // If it's an actual serialised false...
                        $rc->getAttribute( 'rc_params' ) == serialize( false ) ||
                        // Or if we did not get false back when trying to unserialise
                        $params !== false
                    ) {
                        // From ApiQueryLogEvents::addLogParams
                        $logParams = [];
                        // Keys like "4::paramname" can't be used for output so we change them to "paramname"
                        foreach ( $params as $key => $value ) {
                            if ( !str_contains( $key, ':' ) ) {
                                $logParams[$key] = $value;
                                continue;
                            }
                            $logParam = explode( ':', $key, 3 );
                            $logParams[$logParam[2]] = $value;
                        }
                        $packet['log_params'] = $logParams;
                    } else {
                        $packet['log_params'] = explode( "\n", $rc->getAttribute( 'rc_params' ) );
                    }
                }
                $packet['log_action_comment'] = $actionComment;
                break;
        }
 
        $packet['server_url'] = $canonicalServer;
        $packet['server_name'] = $serverName;
 
        $packet['server_script_path'] = $scriptPath ?: '/';
        $packet['wiki'] = WikiMap::getCurrentWikiId();
 
        return $this->formatArray( $packet );
    }
}
class_alias( MachineReadableRCFeedFormatter::class, 'MachineReadableRCFeedFormatter' );