src/Illuminate/Routing/RouteGroup.php - 13.x - githubmirror/framework

src/Illuminate/Routing/RouteGroup.php
165 строк4 KB
Ben Bjurstrom
[13.x] Add route metadata support (#60530)
19 июн 2026, 17:06
19 июн 2026, 17:06926b6c2
<?php

namespace Illuminate\Routing;

use Illuminate\Support\Arr;

class RouteGroup
{
    /**
     * Merge route groups into a new array.
     *
     * @param  array  $new
     * @param  array  $old
     * @param  bool  $prependExistingPrefix
     * @return array
     */
    public static function merge($new, $old, $prependExistingPrefix = true)
    {
        if (isset($new['domain'])) {
            unset($old['domain']);
        }

        if (isset($new['controller'])) {
            unset($old['controller']);
        }

        $metadata = static::formatMetadata($new, $old);

        unset($new['metadata']);

        $new = array_merge(static::formatAs($new, $old), [
            'namespace' => static::formatNamespace($new, $old),
            'prefix' => static::formatPrefix($new, $old, $prependExistingPrefix),
            'where' => static::formatWhere($new, $old),
        ]);

        if ($metadata !== []) {
            $new['metadata'] = $metadata;
        }

        return array_merge_recursive(Arr::except(
            $old, ['metadata', 'namespace', 'prefix', 'where', 'as']
        ), $new);
    }

    /**
     * Format the metadata for the new group attributes.
     *
     * @param  array  $new
     * @param  array  $old
     * @return array
     */
    protected static function formatMetadata($new, $old)
    {
        return static::mergeMetadata(
            $old['metadata'] ?? [],
            $new['metadata'] ?? []
        );
    }

    /**
     * Merge the given route metadata.
     *
     * Associative array values are merged recursively, while all other values, including lists, replace the existing value entirely.
     *
     * @param  array  $old
     * @param  array  $new
     * @return array
     */
    public static function mergeMetadata(array $old, array $new)
    {
        foreach ($new as $key => $value) {
            if (isset($old[$key]) && static::mergableMetadata($old[$key], $value)) {
                $value = static::mergeMetadata($old[$key], $value);
            }

            $old[$key] = $value;
        }

        return $old;
    }

    /**
     * Determine if the given metadata values should be merged.
     *
     * @param  mixed  $old
     * @param  mixed  $new
     * @return bool
     */
    protected static function mergableMetadata($old, $new)
    {
        return is_array($old) &&
            is_array($new) &&
            Arr::isAssoc($old) &&
            Arr::isAssoc($new);
    }

    /**
     * Format the namespace for the new group attributes.
     *
     * @param  array  $new
     * @param  array  $old
     * @return string|null
     */
    protected static function formatNamespace($new, $old)
    {
        if (isset($new['namespace'])) {
            return isset($old['namespace']) && ! str_starts_with($new['namespace'], '\\')
                ? trim($old['namespace'], '\\').'\\'.trim($new['namespace'], '\\')
                : trim($new['namespace'], '\\');
        }

        return $old['namespace'] ?? null;
    }

    /**
     * Format the prefix for the new group attributes.
     *
     * @param  array  $new
     * @param  array  $old
     * @param  bool  $prependExistingPrefix
     * @return string|null
     */
    protected static function formatPrefix($new, $old, $prependExistingPrefix = true)
    {
        $old = $old['prefix'] ?? '';

        if ($prependExistingPrefix) {
            return isset($new['prefix']) ? trim($old, '/').'/'.trim($new['prefix'], '/') : $old;
        }

        return isset($new['prefix']) ? trim($new['prefix'], '/').'/'.trim($old, '/') : $old;
    }

    /**
     * Format the "wheres" for the new group attributes.
     *
     * @param  array  $new
     * @param  array  $old
     * @return array
     */
    protected static function formatWhere($new, $old)
    {
        return array_merge(
            $old['where'] ?? [],
            $new['where'] ?? []
        );
    }

    /**
     * Format the "as" clause of the new group attributes.
     *
     * @param  array  $new
     * @param  array  $old
     * @return array
     */
    protected static function formatAs($new, $old)
    {
        if (isset($old['as'])) {
            $new['as'] = $old['as'].($new['as'] ?? '');
        }

        return $new;
    }
}