ChannelFeed.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\Feed;
 
use MediaWiki\Html\TemplateParser;
use MediaWiki\MainConfigNames;
use MediaWiki\MediaWikiServices;
 
abstract class ChannelFeed extends FeedItem {
 
    protected $templateParser;
 
    public function __construct(
        $title, $description, $url, $date = '', $author = '', $comments = ''
    ) {
        parent::__construct( $title, $description, $url, $date, $author, $comments );
        $this->templateParser = new TemplateParser();
    }
 
    abstract public function outHeader();
 
    abstract public function outItem( $item );
 
    abstract public function outFooter();
 
    public function httpHeaders() {
        global $wgOut;
        $varyOnXFP = MediaWikiServices::getInstance()->getMainConfig()
            ->get( MainConfigNames::VaryOnXFP );
        # We take over from $wgOut, excepting its cache header info
        $wgOut->disable();
        $mimetype = $this->contentType();
        header( "Content-type: $mimetype; charset=UTF-8" );
        // @todo Maybe set a CSP header here at some point as defense in depth.
        // need to figure out how that interacts with browser display of article
        // snippets.
 
        // Set a sensible filename
        $mimeAnalyzer = MediaWikiServices::getInstance()->getMimeAnalyzer();
        $ext = $mimeAnalyzer->getExtensionFromMimeTypeOrNull( $mimetype ) ?? 'xml';
        header( "Content-Disposition: inline; filename=\"feed.{$ext}\"" );
 
        if ( $varyOnXFP ) {
            $wgOut->addVaryHeader( 'X-Forwarded-Proto' );
        }
        $wgOut->sendCacheControl();
    }
 
    private function contentType() {
        global $wgRequest;
 
        $ctype = $wgRequest->getVal( 'ctype', 'application/xml' );
        $allowedctypes = [
            'application/xml',
            'text/xml',
            'application/rss+xml',
            'application/atom+xml'
        ];
 
        return ( in_array( $ctype, $allowedctypes ) ? $ctype : 'application/xml' );
    }
 
    protected function outXmlHeader() {
        $this->httpHeaders();
        echo '<?xml version="1.0"?>' . "\n";
    }
}