IfNoneMatch.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\Rest\HeaderParser;
 
class IfNoneMatch extends HeaderParserBase {
    private $results = [];
 
    private $lastError;
 
    public function parseHeaderList( $headerList ) {
        $this->lastError = null;
        if ( count( $headerList ) === 1 && $headerList[0] === '*' ) {
            return [ [
                'weak' => true,
                'contents' => null,
                'whole' => '*'
            ] ];
        }
        $this->results = [];
        try {
            foreach ( $headerList as $header ) {
                $this->parseHeader( $header );
            }
            return $this->results;
        } catch ( HeaderParserError $e ) {
            $this->lastError = $e->getMessage();
            return [];
        }
    }
 
    public function parseETag( $eTag ) {
        $this->setInput( $eTag );
        $this->results = [];
 
        try {
            $this->consumeTag();
            $this->assertEnd();
        } catch ( HeaderParserError $e ) {
            $this->lastError = $e->getMessage();
            return null;
        }
        /* @phan-suppress-next-line PhanTypeInvalidDimOffset */
        return $this->results[0];
    }
 
    public function getLastError() {
        return $this->lastError;
    }
 
    private function parseHeader( $header ) {
        $this->setInput( $header );
        $this->consumeTagList();
        $this->assertEnd();
    }
 
    private function consumeTagList() {
        while ( true ) {
            $this->skipWhitespace();
            $this->consumeTag();
            $this->skipWhitespace();
            if ( $this->pos === $this->inputLength ) {
                break;
            } else {
                $this->consumeString( ',' );
            }
        }
    }
 
    private function consumeTag() {
        $weak = false;
        $whole = '';
        if ( substr( $this->input, $this->pos, 2 ) === 'W/' ) {
            $weak = true;
            $whole .= 'W/';
            $this->pos += 2;
        }
        $this->consumeString( '"' );
        if ( !preg_match( '/[!#-~\x80-\xff]*/A', $this->input, $m, 0, $this->pos ) ) {
            $this->error( 'unexpected regex failure' );
        }
        $contents = $m[0];
        $this->pos += strlen( $contents );
        $this->consumeString( '"' );
        $whole .= '"' . $contents . '"';
        $this->results[] = [
            'weak' => $weak,
            'contents' => $contents,
            'whole' => $whole
        ];
    }
}