ParameterParser.php

<?php
/**
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * This file is part of Nominatim. (https://nominatim.org)
 *
 * Copyright (C) 2022 by the Nominatim developer community.
 * For a full list of authors see the git log.
 */

namespace Nominatim;

class ParameterParser
{
    private $aParams;


    public function __construct($aParams = null)
    {
        $this->aParams = ($aParams === null) ? $_GET : $aParams;
    }

    public function getBool($sName, $bDefault = false)
    {
        if (!isset($this->aParams[$sName])
            || !is_string($this->aParams[$sName])
            || strlen($this->aParams[$sName]) == 0
        ) {
            return $bDefault;
        }

        return (bool) $this->aParams[$sName];
    }

    public function getInt($sName, $bDefault = false)
    {
        if (!isset($this->aParams[$sName]) || is_array($this->aParams[$sName])) {
            return $bDefault;
        }

        if (!preg_match('/^[+-]?[0-9]+$/', $this->aParams[$sName])) {
            userError("Integer number expected for parameter '$sName'");
        }

        return (int) $this->aParams[$sName];
    }

    public function getFloat($sName, $bDefault = false)
    {
        if (!isset($this->aParams[$sName]) || is_array($this->aParams[$sName])) {
            return $bDefault;
        }

        if (!preg_match('/^[+-]?[0-9]*\.?[0-9]+$/', $this->aParams[$sName])) {
            userError("Floating-point number expected for parameter '$sName'");
        }

        return (float) $this->aParams[$sName];
    }

    public function getString($sName, $bDefault = false)
    {
        if (!isset($this->aParams[$sName])
            || !is_string($this->aParams[$sName])
            || strlen($this->aParams[$sName]) == 0
        ) {
            return $bDefault;
        }

        return $this->aParams[$sName];
    }

    public function getSet($sName, $aValues, $sDefault = false)
    {
        if (!isset($this->aParams[$sName])
            || !is_string($this->aParams[$sName])
            || strlen($this->aParams[$sName]) == 0
        ) {
            return $sDefault;
        }

        if (!in_array($this->aParams[$sName], $aValues, true)) {
            userError("Parameter '$sName' must be one of: ".join(', ', $aValues));
        }

        return $this->aParams[$sName];
    }

    public function getStringList($sName, $aDefault = false)
    {
        $sValue = $this->getString($sName);

        if ($sValue) {
            // removes all NULL, FALSE and Empty Strings but leaves 0 (zero) values
            return array_values(array_filter(explode(',', $sValue), 'strlen'));
        }

        return $aDefault;
    }

    public function getPreferredLanguages($sFallback = null)
    {
        if ($sFallback === null && isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) {
            $sFallback = $_SERVER['HTTP_ACCEPT_LANGUAGE'];
        }

        $aLanguages = array();
        $sLangString = $this->getString('accept-language', $sFallback);

        if ($sLangString
            && preg_match_all('/(([a-z]{1,8})([-_][a-z]{1,8})?)\s*(;\s*q\s*=\s*(1|0\.[0-9]+))?/i', $sLangString, $aLanguagesParse, PREG_SET_ORDER)
        ) {
            foreach ($aLanguagesParse as $iLang => $aLanguage) {
                $aLanguages[$aLanguage[1]] = isset($aLanguage[5])?(float)$aLanguage[5]:1 - ($iLang/100);
                if (!isset($aLanguages[$aLanguage[2]])) {
                    $aLanguages[$aLanguage[2]] = $aLanguages[$aLanguage[1]]/10;
                }
            }
            arsort($aLanguages);
        }
        if (empty($aLanguages) && CONST_Default_Language) {
            $aLanguages[CONST_Default_Language] = 1;
        }

        foreach ($aLanguages as $sLanguage => $fLanguagePref) {
            $this->addNameTag($aLangPrefOrder, 'name:'.$sLanguage);
        }
        $this->addNameTag($aLangPrefOrder, 'name');
        $this->addNameTag($aLangPrefOrder, 'brand');
        foreach ($aLanguages as $sLanguage => $fLanguagePref) {
            $this->addNameTag($aLangPrefOrder, 'official_name:'.$sLanguage);
            $this->addNameTag($aLangPrefOrder, 'short_name:'.$sLanguage);
        }
        $this->addNameTag($aLangPrefOrder, 'official_name');
        $this->addNameTag($aLangPrefOrder, 'short_name');
        $this->addNameTag($aLangPrefOrder, 'ref');
        $this->addNameTag($aLangPrefOrder, 'type');
        return $aLangPrefOrder;
    }

    private function addNameTag(&$aLangPrefOrder, $sTag)
    {
        $aLangPrefOrder[$sTag] = $sTag;
        $aLangPrefOrder['_place_'.$sTag] = '_place_'.$sTag;
    }

    public function hasSetAny($aParamNames)
    {
        foreach ($aParamNames as $sName) {
            if ($this->getBool($sName)) {
                return true;
            }
        }

        return false;
    }
}