libraries/src/Component/Router/RouterLegacy.php - 5.4-dev - githubmirror/joomla-cms

libraries/src/Component/Router/RouterLegacy.php
109 строк3 KB
Denitz
[5.2] foreach usage (#41982)
12 сен 2024, 13:23
12 сен 2024, 13:2363ba5aa
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2014 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Component\Router;

// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects

/**
 * Default routing class for missing or legacy component routers
 *
 * @since  3.3
 * @deprecated  5.1 will be removed in 7.0
 *              Will be removed without replacement. Use the class based router
 *              implementing the RouterInterface
 */
class RouterLegacy implements RouterInterface
{
    /**
     * Name of the component
     *
     * @var    string
     * @since  3.3
     */
    protected $component;

    /**
     * Constructor
     *
     * @param   string  $component  Component name without the com_ prefix this router should react upon
     *
     * @since   3.3
     */
    public function __construct($component)
    {
        $this->component = $component;
    }

    /**
     * Generic preprocess function for missing or legacy component router
     *
     * @param   array  $query  An associative array of URL arguments
     *
     * @return  array  The URL arguments to use to assemble the subsequent URL.
     *
     * @since   3.3
     */
    public function preprocess($query)
    {
        return $query;
    }

    /**
     * Generic build function for missing or legacy component router
     *
     * @param   array  &$query  An array of URL arguments
     *
     * @return  array  The URL arguments to use to assemble the subsequent URL.
     *
     * @since   3.3
     */
    public function build(&$query)
    {
        $function = $this->component . 'BuildRoute';

        if (\function_exists($function)) {
            $segments = $function($query);

            foreach ($segments as &$segment) {
                $segment = str_replace(':', '-', $segment);
            }

            return $segments;
        }

        return [];
    }

    /**
     * Generic parse function for missing or legacy component router
     *
     * @param   array  &$segments  The segments of the URL to parse.
     *
     * @return  array  The URL attributes to be used by the application.
     *
     * @since   3.3
     */
    public function parse(&$segments)
    {
        $function = $this->component . 'ParseRoute';

        if (\function_exists($function)) {
            foreach ($segments as &$segment) {
                $segment = preg_replace('/-/', ':', $segment, 1);
            }

            return $function($segments);
        }

        return [];
    }
}