HttpAcceptParser.php

Go to the documentation of this file.

<?php
 
namespace Wikimedia\Http;
 
class HttpAcceptParser {
 
    public function parseAccept( $accept ): array {
        // FIXME: Allow commas in quotes
        $accepts = explode( ',', $accept );
        $ret = [];
 
        foreach ( $accepts as $i => $a ) {
            if ( !preg_match( '!^([^\s/;]+)/([^;\s]+)\s*(?:;(.*))?$!D', trim( $a ), $matches ) ) {
                continue;
            }
 
            $q = 1;
            $params = [];
            if ( isset( $matches[3] ) ) {
                // FIXME: Allow semi-colon in quotes
                $kvps = explode( ';', $matches[3] );
                foreach ( $kvps as $kv ) {
                    $kvArray = explode( '=', trim( $kv ), 2 );
                    if ( count( $kvArray ) != 2 ) {
                        continue;
                    }
                    [ $key, $val ] = $kvArray;
                    $key = strtolower( trim( $key ) );
                    $val = trim( $val );
                    if ( $key === 'q' ) {
                        // FIXME: Spec is stricter about this
                        $q = (float)$val;
                    } else {
                        if ( $val && $val[0] === '"' && str_ends_with( $val, '"' ) ) {
                            $val = substr( $val, 1, -1 );
                        }
                        $params[$key] = $val;
                    }
                }
            }
            $ret[] = [
                'type' => $matches[1],
                'subtype' => $matches[2],
                'q' => $q,
                'i' => $i,
                'params' => $params,
            ];
        }
 
        // Sort list. First by q values, then by order
        usort( $ret, static fn ( $a, $b ) =>
            $b['q'] <=> $a['q'] ?:
            $a['i'] <=> $b['i']
        );
 
        return $ret;
    }
 
    public function parseWeights( $rawHeader ) {
        // first, strip header name
        $rawHeader = preg_replace( '/^[-\w]+:\s*/', '', $rawHeader );
 
        // Return values in lower case
        $rawHeader = strtolower( $rawHeader );
 
        $accepts = $this->parseAccept( $rawHeader );
 
        // Create a list like "en" => 0.8
        return array_reduce( $accepts, static function ( $prev, $next ) {
            $type = "{$next['type']}/{$next['subtype']}";
            $prev[$type] = $next['q'];
            return $prev;
        }, [] );
    }
 
}