Класс RouteBuilder

__construct()source public

__construct( Cake\Routing\RouteCollection $collection , string $path , array $params = [] , array $options = [] )

Конструктор

Параметры

• routeClass - Класс маршрута по умолчанию для использования при добавлении маршрутов.
• extensions - Расширения для подключения при добавлении маршрутов.
• namePrefix - Префикс, который должен быть добавлен ко всем именам маршрутов.
• middleware - Имена middleware, маршруты которых должны быть применены.

Параметры

Cake\Routing\RouteCollection $collection

Коллекция маршрутов, в которую нужно добавить маршруты.

string $path

Префикс пути, для которого предназначена область.

array $params optional []

Параметры маршрутизации области.

array $options optional []

Список опций.

_makeRoute()source protected

_makeRoute( string|Cake\Routing\Route\Route $route , array $defaults , array $options )

Создание объекта маршрута или возврат предоставленного объекта.

Параметры

string|Cake\Routing\Route\Route $route

Шаблон маршрута или объект маршрута.

array $defaults

Параметры по умолчанию.

array $options

Дополнительные параметры опций.

Возвращает

Cake\Routing\Route\Route

Исключения

InvalidArgumentException
если класс маршрута или объект маршрута некорректны.
BadMethodCallException
если создаваемый маршрут конфликтует с текущей областью

_methodRoute()source protected

_methodRoute( string $method , string $template , array $target , string $name )

Помощник для создания маршрутов, которые отвечают только на один HTTP-метод.

Параметры

строка $method

Имя HTTP-метода для сопоставления.

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которым ведет этот маршрут.

строка $name

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

addExtensions()source public

addExtensions( string|array $extensions )

Добавить дополнительные расширения к тем, что уже есть в текущем объёме.

Параметры

строка|массив $extensions

Одно или несколько расширений для добавления

applyMiddleware()source public

applyMiddleware( ... $names )

Применить middleware к текущему объёму маршрутов.

Требуется, чтобы middleware был зарегистрирован через registerMiddleware()

Параметры

... $names

$names Имена middleware для применения к текущему объёму.

Возвращает

$this

См. также

\Cake\Routing\RouteCollection::addMiddlewareToScope()

connect()source public

connect( string $route , array|string $defaults = [] , array $options = [] )

Подключает новый маршрут.

Маршруты — это способ соединения URL-адресов запросов с объектами в вашем приложении. В основе маршрутов лежит набор или регулярные выражения, используемые для сопоставления запросов с пунктами назначения.

Примеры:

$routes->connect('/:controller/:action/*');

Первый параметр будет использоваться в качестве имени контроллера, а второй — в качестве имени действия. Синтаксис «/*» делает этот маршрут жадным, то есть он будет соответствовать запросам, таким как /posts/index, а также запросам, таким как /posts/edit/1/foo/bar.

$routes->connect('/home-page', ['controller' => 'Pages', 'action' => 'display', 'home']);

Выше показано использование значений параметров маршрута по умолчанию. А также предоставление параметров маршрутизации для статического маршрута.

$routes->connect(
  '/:lang/:controller/:action/:id',
  [],
  ['id' => '[0-9]+', 'lang' => '[a-z]{3}']
);

Показывает подключение маршрута с пользовательскими параметрами маршрута, а также предоставляет шаблоны для этих параметров. Шаблоны для параметров маршрутизации не нуждаются в группах захвата, так как для каждого параметра маршрута будет добавлена одна группа захвата.

$options предлагает несколько «специальных» ключей, имеющих специальное значение в массиве $options.

• routeClass используется для расширения и изменения того, как отдельные маршруты анализируют запросы и обрабатывают обратную маршрутизацию с помощью пользовательского класса маршрутизации. Пример: 'routeClass' => 'SlugRoute'
• pass используется для определения того, какие из параметров маршрута должны быть перемещены в массив pass. Добавление параметра в pass удалит его из обычного массива параметров маршрута. Пример: 'pass' => ['slug'].
• persist используется для определения параметров маршрута, которые должны быть автоматически включены при генерации новых URL-адресов. Вы можете переопределить постоянные параметры, повторно определив их в URL-адресе, или удалить их, установив параметр в false. Пример: 'persist' => ['lang']
• multibytePattern Установите в true для включения поддержки многобайтных шаблонов в шаблонах параметров маршрута.
• _name используется для определения определенного имени для маршрутов. Это можно использовать для оптимизации обратных поисков маршрутов. Если не определено, для каждого подключенного маршрута будет сгенерировано имя.
• _ext это массив расширений имен файлов, которые будут извлечены из URL, если они присутствуют. См. \Cake\Routing\RouteCollection::setExtensions().
• _method Сопоставлять запросы только со специфическими HTTP-глаголами.

Пример использования условия %%%CODE_BLOCK_67%%:

$routes->connect('/tasks', ['controller' => 'Tasks', 'action' => 'index', '_method' => 'GET']);

Вышеуказанный маршрут будет соответствовать только запросам GET. Запросы POST не будут соответствовать этому маршруту.

Параметры

строка $route

Строка, описывающая шаблон маршрута

массив|строка $defaults дополнительный []

Массив, описывающий параметры маршрута по умолчанию. Эти параметры будут использоваться по умолчанию и могут предоставлять параметры маршрутизации, которые не являются динамическими. См. выше.

массив $options дополнительный []

Массив, сопоставляющий именованные элементы маршрута с регулярными выражениями, которым должен соответствовать этот элемент. Также содержит дополнительные параметры, такие как параметры маршрута, которые должны быть перемещены в переданные аргументы, шаблоны для параметров маршрута и имя пользовательского класса маршрутизации.

Возвращает

Cake\Routing\Route\Route

Выбрасывает

InvalidArgumentException
BadMethodCallException

delete()source public

delete( string $template , array $target , string $name = null )

Создает маршрут, который отвечает только на запросы DELETE.

Параметры

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которым ведет этот маршрут.

строка $name дополнительный null

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

extensions()source public устаревший

extensions( null|string|array $extensions = null )

Получить или установить расширения в объёме этого билдера маршрутов.

Будущие маршруты, подключённые через этот билдер, будут иметь применённые расширения. Однако установка расширений не изменяет существующие маршруты.

Устаревший

3.5.0 Используйте getExtensions/setExtensions вместо этого.

Параметры

null|строка|массив $extensions дополнительный null

Расширения для использования или null.

Возвращает

массив|null

fallbacks()source public

fallbacks( string|null $routeClass = null )

Подключить /:controller и /:controller/:action/* fallback маршруты.

Это сокращенный метод для подключения fallback маршрутов в данном объёме.

Параметры

строка|null $routeClass дополнительный null

класс маршрута для использования, используется класс маршрута по умолчанию, если не указан

get()source public

get( string $template , array $target , string $name = null )

Создаёт маршрут, который отвечает только на GET-запросы.

Параметры

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которым ведет этот маршрут.

строка $name дополнительный null

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

getExtensions()source public

getExtensions( )

Получить расширения в объёме этого билдера маршрутов.

Возвращает

массив

getRouteClass()source public

getRouteClass( )

Получить класс маршрута по умолчанию.

Возвращает

строка

head()source public

head( string $template , array $target , string $name = null )

Создаёт маршрут, который отвечает только на HEAD-запросы.

Параметры

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которым ведет этот маршрут.

строка $name дополнительный null

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

loadPlugin()source public

loadPlugin( string $name , string $file = 'routes.php' )

Загрузить маршруты из плагина.

Файл маршрутов будет иметь локальную переменную с именем $routes, которая содержит текущую инстанцию RouteBuilder.

Параметры

строка $name

Имя плагина

строка $file дополнительный 'routes.php'

Файл маршрутов для загрузки. По умолчанию routes.php. Этот параметр устарел и будет удален в версии 4.0

Выбрасывает

Cake\Core\Exception\MissingPluginException
При отсутствии плагина.
InvalidArgumentException
При отсутствии файла маршрутов в плагине.

middlewareGroup()source public

middlewareGroup( string $name , array $middlewareNames )

Применить набор middleware к группе

Параметры

строка $name

Имя группы middleware

массив $middlewareNames

Имена middleware

Возвращает

$this

nameExists()source public

nameExists( string $name )

Проверяет, существует ли маршрут с заданным именем.

Параметры

строка $name

Имя.

Возвращает

boolean

namePrefix()source public

namePrefix( string|null $value = null )

Получить/установить префикс имени для данного контекста.

Изменение префикса имени повлияет только на префиксы, используемые для маршрутов, подключенных после изменения префикса.

Параметры

строка|null $value необязательно null

Значение для установки или null.

Возвращает

строка

options()source public

options( string $template , array $target , string $name = null )

Создать маршрут, который отвечает только на запросы OPTIONS.

Параметры

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которым обращается этот маршрут.

строка $name необязательно null

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

params()source public

params( )

Получить имена/значения параметров для данного контекста.

Возвращает

массив

parseDefaults()source protected static

parseDefaults( string|array $defaults )

Обработать значения по умолчанию, если они представлены строкой

Параметры

строка|массив $defaults

Массив значений по умолчанию из метода connect().

Возвращает

строка|массив

patch()source public

patch( string $template , array $target , string $name = null )

Создать маршрут, который отвечает только на запросы PATCH.

Параметры

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которым обращается этот маршрут.

строка $name необязательно null

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

path()source public

path( )

Получить путь для данного контекста.

Возвращает

строка

plugin()source public

plugin( string $name , array|callable $options = [] , callable|null $callback = null )

Добавить маршруты плагинов.

Этот метод создаёт новый контекст для коллекции маршрутов, включающий информацию о соответствующем плагине.

Имя плагина преобразуется в нижний регистр с использованием символа подчёркивания для создания пути маршрутизации. Если вам нужен пользовательский путь, используйте опцию path.

Маршруты, подключенные в контексте, будут иметь соответствующий префикс пути и соответствующий ключ маршрутизации плагина.

Параметры

строка $name

Имя плагина для создания маршрутов

массив|обратный вызов $options необязательно []

Используемые параметры или обратный вызов

обратный вызов|null $callback необязательно null

Обратный вызов для построения маршрутов плагина. Требуется только при наличии опций $options.

post()source public

post( string $template , array $target , string $name = null )

Создать маршрут, который отвечает только на запросы POST.

Параметры

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которому обращается этот маршрут.

строка $name необязательно null

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

prefix()source public

prefix( string $name , array|callable $params = [] , callable $callback = null )

Добавить маршруты с префиксом.

Этот метод создаёт контекст для коллекции маршрутов, включающий информацию о соответствующем префиксе.

Параметр $name используется для генерации имени параметра маршрутизации. Например, путь admin приведет к применению 'prefix' => 'admin' ко всем подключенным маршрутам.

Вы можете повторно открыть префикс столько раз, сколько необходимо, а также вкладывать префиксы. Вложенные префиксы приведут к значениям префиксов, таким как admin/api, что соответствует пространству имён Controller\Admin\Api\.

Если вам нужен префикс с точками, например: '/api/v1.0', используйте ключ 'path' для аргумента $params:

$route->prefix('api', function($route) {
    $route->prefix('v10', ['path' => '/v1.0'], function($route) {
        // Translates to `Controller\Api\V10\` namespace
    });
});

Параметры

строка $name

Имя префикса для использования.

массив|обратный вызов $params необязательно []

Массив значений по умолчанию для маршрутизации, добавляемых к каждому подключенному маршруту. Если параметров нет, этот аргумент может быть обратным вызовом.

обратный вызов $callback необязательно null

Обратный вызов для построения маршрутов с префиксом.

Исключения

InvalidArgumentException
Если не передан действительный обратный вызов

put()source public

put( string $template , array $target , string $name = null )

Создать маршрут, который отвечает только на запросы PUT.

Параметры

строка $template

Шаблон URL для использования.

массив $target

Массив, описывающий параметры целевого маршрута. Эти параметры должны указывать плагин, префикс, контроллер и действие, к которому обращается этот маршрут.

строка $name необязательно null

Имя маршрута.

Возвращает

Cake\Routing\Route\Route

redirect()source public

redirect( string $route , array|string $url , array $options = [] )

Подключает новый маршрут перенаправления в маршрутизаторе.

Маршруты перенаправления отличаются от обычных маршрутов, так как они выполняют фактическое перенаправление заголовка, если совпадение найдено. Перенаправление может происходить в пределах приложения или перенаправлять на внешний ресурс.

Примеры:

$routes->redirect('/home/*', ['controller' => 'posts', 'action' => 'view']);

Перенаправляет /home/* на /posts/view и передаёт параметры в /posts/view. Использование массива в качестве места назначения перенаправления позволяет использовать другие маршруты для определения, куда должна быть перенаправлена строка URL.

$routes->redirect('/posts/*', 'http://google.com', ['status' => 302]);

Перенаправляет /posts/* на http://google.com со статусом HTTP 302

Опции:

• status Устанавливает код HTTP-статуса (по умолчанию 301)
• persist Передаёт параметры перенаправленному маршруту, если это возможно. Это полезно для жадных маршрутов, маршрутов, заканчивающихся на *, так как они жадные. Вы можете переназначить URL и не потерять переданные аргументы.

Параметры

строка $route

Строка, описывающая шаблон маршрута

массив|строка $url

URL для перенаправления. Может быть строкой или URL, основанным на массиве Cake

массив $options необязательно []

Массив, сопоставляющий именованные элементы маршрута с регулярными выражениями, которым должен соответствовать элемент. Также содержит дополнительные параметры, такие как параметры маршрута, которые должны быть перенесены в переданные аргументы, а также шаблоны для параметров маршрута.

Возвращает

Cake\Routing\Route\Route|Cake\Routing\Route\RedirectRoute

registerMiddleware()source public

registerMiddleware( string $name , callable|string $middleware )

Зарегистрировать мидлварь в RouteCollection.

После регистрации мидлвары, её можно применить к текущей области маршрутизации или любым дочерним областям, которые используют ту же RouteCollection.

Параметры

string $name

Имя мидлвары. Используется при применении мидлвары к области.

callable|string $middleware

Вызываемая мидлвара или имя класса мидлвары для регистрации.

Возвращаемое значение

$this

См. также

\Cake\Routing\RouteCollection

resources()source public

resources( string $name , array|callable $options = [] , callable|null $callback = null )

Генерировать маршруты REST-ресурсов для заданного(ых) контроллера(ов).

Быстрый способ сгенерировать стандартные маршруты для набора REST-ресурсов (контроллера(ов)).

Использование

Подключить маршруты ресурсов для контроллера приложения:

$routes->resources('Posts');

Подключить маршруты ресурсов для контроллера Comments в плагине Comments:

Router::plugin('Comments', function ($routes) {
  $routes->resources('Comments');
});

Плагины будут создавать маршруты ресурсов с использованием нижнего подчеркивания. Пример: /comments/comments

Подключить маршруты ресурсов для контроллера Articles в префиксе Admin:

Router::prefix('admin', function ($routes) {
  $routes->resources('Articles');
});

Префиксы будут создавать маршруты ресурсов с использованием нижнего подчеркивания. Пример: /admin/posts

Вы можете создать вложенные ресурсы, передав коллбек:

$routes->resources('Articles', function ($routes) {
  $routes->resources('Comments');
});

Вышеуказанное сгенерирует маршруты ресурсов как для /articles, так и для /articles/:article_id/comments. Вы можете использовать опцию map для подключения дополнительных методов ресурсов:

$routes->resources('Articles', [
  'map' => ['deleteAll' => ['action' => 'deleteAll', 'method' => 'DELETE']]
]);

В дополнение к стандартным маршрутам, это также подключит маршрут для /articles/delete_all. По умолчанию сегмент пути будет соответствовать имени ключа. Вы можете использовать ключ 'path' в определении ресурса для настройки имени пути.

Вы можете использовать опцию inflect для изменения того, как генерируются сегменты пути:

$routes->resources('PaymentTypes', ['inflect' => 'dasherize']);

Это сгенерирует маршруты вроде /payment-types вместо /payment_types

Опции:

• 'id' - Часть регулярного выражения, используемая при сопоставлении идентификаторов. По умолчанию соответствует целочисленным значениям и UUID.
• 'inflect' - Выберите метод склонения, используемый для имени ресурса. По умолчанию 'underscore'.
• 'only' - Подключить только указанный список действий.
• 'actions' - Переопределить имена методов, используемых для подключения действий.
• 'map' - Дополнительные маршруты ресурсов, которые должны быть подключены. Если вы определили 'only' и 'map', убедитесь, что ваши сопоставленные методы также присутствуют в списке 'only'.
• 'prefix' - Определите префикс маршрутизации для контроллера ресурса. Если текущая область определяет префикс, этот префикс будет добавлен к нему.
• 'connectOptions' - Настраиваемые параметры для подключения маршрутов.
• 'path' - Изменить путь, чтобы он не соответствовал имени ресурса. Например, ArticlesController доступен по адресу /posts

Параметры

string $name

Имя контроллера, для которого необходимо подключить маршруты ресурсов.

array|callable $options необязательно []

Опции для использования при генерации маршрутов REST, или коллбек.

callable|null $callback необязательно null

Необязательный коллбек, который выполняется во вложенной области. Вложенные области наследуют существующий путь и параметр 'id'.

routeClass()source public устаревший

routeClass( string|null $routeClass = null )

Получить или установить класс маршрута по умолчанию.

Устаревший

3.5.0 Используйте getRouteClass/setRouteClass вместо этого.

Параметры

string|null $routeClass необязательно null

Имя класса.

Возвращаемое значение

string|null

scope()source public

scope( string $path , array|callable $params , callable|null $callback = null )

Создать новую область маршрутизации.

Области, созданные с помощью этого метода, будут наследоваться от свойств области, к которой они добавлены. Это означает, что как текущий путь, так и параметры будут добавлены к предоставленным параметрам.

Параметры

string $path

Путь для создания области.

array|callable $params

Либо параметры для добавления к маршрутам, либо коллбек.

callable|null $callback необязательно null

Коллбек для вызова, который строит маршруты плагина. Требуется только при определении $params.

Исключения

InvalidArgumentException
при отсутствии параметра callable.

setExtensions()source public

setExtensions( string|array $extensions )

Установить расширения в области этого билдера маршрутов.

Будущие маршруты, подключенные через этот билдер, будут иметь применённые расширения. Однако, установка расширений не изменяет существующие маршруты.

Параметры

string|array $extensions

Расширения для установки.

Возвращаемое значение

$this

setRouteClass()source public

setRouteClass( string $routeClass )

Установить класс маршрута по умолчанию.

Параметры

string $routeClass

Имя класса.

Возвращаемое значение

$this

[]

''

[
    'index' => ['action' => 'index', 'method' => 'GET', 'path' => ''],
    'create' => ['action' => 'add', 'method' => 'POST', 'path' => ''],
    'view' => ['action' => 'view', 'method' => 'GET', 'path' => ':id'],
    'update' => ['action' => 'edit', 'method' => ['PUT', 'PATCH'], 'path' => ':id'],
    'delete' => ['action' => 'delete', 'method' => 'DELETE', 'path' => ':id'],
]

'Cake\Routing\Route\Route'

[]