1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 

<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom Flidr (https://github.com/mvccore)
 * @license     https://mvccore.github.io/docs/mvccore/5.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Routers\Localizations\Route;

trait UrlBuilding {

    /**
     * Complete route URL by given params array and route internal reverse 
     * replacements pattern string. If there are more given params in first 
     * argument than total count of replacement places in reverse pattern,
     * then create URL with query string params after reverse pattern, 
     * containing that extra record(s) value(s). Returned is an array with two 
     * strings - result URL in two parts - first part as scheme, domain and base 
     * path and second as path and query string.
     * Example:
     *  Input (`$params`):
     *      `[
     *          "name"          => "cool-product-name",
     *          "color"         => "blue",
     *          "variants"      => ["L", "XL"],
     *      ];`
     *  Input (`\MvcCore\Route::$reverse`):
     *      `"/products-list/<name>/<color*>"`
     *  Output:
     *      `[
     *          "/any/app/base/path",
     *          "/products-list/cool-product-name/blue?variant[]=L&amp;variant[]=XL"
     *      ]`
     * @param \MvcCore\Request  $request 
     *                          Currently requested request object.
     * @param array             $params
     *                          URL params from application point completed 
     *                          by developer.
     * @param array             $defaultUrlParams 
     *                          Requested URL route params and query string 
     *                          params without escaped HTML special chars: 
     *                          `< > & " ' &`.
     * @param string            $queryStringParamsSepatator 
     *                          Query params separator, `&` by default. Always 
     *                          automatically completed by router instance.
     * @param bool              $splitUrl
     *                          Boolean value about to split completed result URL
     *                          into two parts or not. Default is FALSE to return 
     *                          a string array with only one record - the result 
     *                          URL. If `TRUE`, result url is split into two 
     *                          parts and function return array with two items.
     * @return \string[]        Result URL address in array. If last argument is 
     *                          `FALSE` by default, this function returns only 
     *                          single item array with result URL. If last 
     *                          argument is `TRUE`, function returns result URL 
     *                          in two parts - domain part with base path and 
     *                          path part with query string.
     */
    public function Url (\MvcCore\IRequest $request, array & $params = [], array & $defaultUrlParams = [], $queryStringParamsSepatator = '&', $splitUrl = FALSE) {
        /** @var $this \MvcCore\Ext\Routers\Localizations\Route */
        // initialize localization param and route localization key
        $router = $this->router;
        $localizationParamName = $router::URL_PARAM_LOCALIZATION;
        if (isset($params[$localizationParamName])) {
            $localizationStr = $params[$localizationParamName];
            unset($params[$localizationParamName]);
        } else if (isset($defaultUrlParams[$localizationParamName])) {
            $localizationStr = $defaultUrlParams[$localizationParamName];
            unset($defaultUrlParams[$localizationParamName]);
        } else {
            $localizationStr = implode($router::LANG_AND_LOCALE_SEPARATOR, $router->GetLocalization());
        }
        $localization = explode($router::LANG_AND_LOCALE_SEPARATOR, $localizationStr);
        $routesLocalization = $router->GetRouteRecordsByLanguageAndLocale()
            ? $localizationStr
            : $localization[0];
        
        // check reverse initialization
        if (
            !array_key_exists($routesLocalization, $this->reverseParamsLocalized) || 
            !array_key_exists($routesLocalization, $this->reverseLocalized)
        ) 
            $this->initReverse($routesLocalization);
        
        // complete and filter all params to build reverse pattern
        $reverseParams = $this->reverseParamsLocalized[$routesLocalization];
        if (count($reverseParams) === 0) {
            $allParamsClone = array_merge([], $params);
        } else {
            $emptyReverseParams = array_fill_keys(array_keys($reverseParams), NULL);
            $allMergedParams = array_merge($this->GetDefaults($routesLocalization), $defaultUrlParams, $params);
            $allParamsClone = array_merge($emptyReverseParams, array_intersect_key($allMergedParams, $emptyReverseParams), $params);
        }
        
        // filter params
        $localizationContained = array_key_exists($localizationParamName, $allParamsClone);
        $allParamsClone[$localizationParamName] = $localizationStr;
        list(,$filteredParams) = $this->Filter($allParamsClone, $defaultUrlParams, \MvcCore\IRoute::CONFIG_FILTER_OUT);
        $filteredParams = $filteredParams ?: [];
        if (!$localizationContained) unset($filteredParams[$localizationParamName]);
        
        // split params into domain params array and into path and query params array
        $domainPercentageParams = $this->urlGetAndRemoveDomainPercentageParams($filteredParams);

        // build reverse pattern
        $result = $this->urlComposeByReverseSectionsAndParams(
            $this->reverseLocalized[$routesLocalization], 
            $this->reverseSectionsLocalized[$routesLocalization], 
            $this->reverseParamsLocalized[$routesLocalization], 
            $filteredParams, 
            $this->GetDefaults($routesLocalization)
        );
        
        // add all remaining params to query string
        if ($filteredParams) {
            // `http_build_query()` automatically converts all XSS chars to entities (`< > & " ' &`):
            $result .= (mb_strpos($result, '?') !== FALSE ? $queryStringParamsSepatator : '?')
                . str_replace('%2F', '/', http_build_query(
                    $filteredParams, '', $queryStringParamsSepatator, PHP_QUERY_RFC3986
                ));
        }
        
        return $this->urlAbsPartAndSplit($request, $result, $domainPercentageParams, $splitUrl);
    }
}