Динамические маршруты — Веб-разработка на PHP

До сих пор мы встречались только со статическими маршрутами. В них нет изменяемых частей — адрес точно совпадает с маршрутом и не меняется, поэтому и называется статическим.

На практике чаще встречаются динамические маршруты. Проанализируем адреса курсов на Хекслете:

• https://ru.hexlet.io/courses/php-introduction-to-oop
• https://ru.hexlet.io/courses/php-object-oriented-design
• https://ru.hexlet.io/courses/js-react

В этих адресах прослеживается определенная структура: /courses/<имя курса>. Можно предположить, что на каждый такой адрес создается свой маршрут и обработчик, но тогда представим процесс наполнения сайта.

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

То же можно сказать и про профили пользователей — /u/<никнейм пользователя>. Причем пользователей сотни тысяч, и добавляются они на сайт непрерывно без нашего участия.

В примерах выше мы столкнулись с динамическими маршрутами. Такие маршруты имеют внутри изменяемые части, но обработчик у маршрута только один. Например, все указанные выше адреса курсов соответствуют одному маршруту, который можно записать так /courses/{id}.

Секция {id} означает, что на это место подставляется конкретный идентификатор курса — уникальная запись, отличающая одну сущность от другой.

Имя изменяемой части можно выбирать произвольно. Вместо {id} можно написать {lala}. Сам способ записи (в данном случае имя с обрамляющими {}) зависит от конкретного фреймворка. В Slim для этого используются фигурные скобки, что создает ощущение использования интерполяции:

<?php

$app->get('/courses/{id}', function ($request, $response, array $args) {
    $id = $args['id'];
    return $response->write("Course id: {$id}");
});

curl localhost:8080/courses/132

Course id: 132

Любая изменяемая часть маршрута называется плейсхолдером — заполнителем. В маршруте выше только один плейсхолдер — id. Доступ к значению конкретного плейсхолдера осуществляется по имени через массив $args, который передается третьим параметром в функцию-обработчик.

Для удобства пользователей в адресах стараются использовать не числовые идентификаторы, а человекочитаемые названия. Например, вместо /courses/332 показывают /courses/php-mvc. Эту часть адреса называют словом slug.

Slug должен быть уникален, а его формат обязан соответствовать требованиям формирования адресов. Как правило, эти имена делают, используя символы латинского алфавита с дефисом между ними: this-that-other-outre-collection.

Подведем промежуточный итог. Понятия адрес и маршрут обозначают разные вещи. Если маршрут статический, то он всегда совпадает с адресом, например, /about. Если маршрут динамический, то ему могут соответствовать бесконечное число адресов, даже если таких страниц на сайте нет, например, /courses/:id.

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

<?php

$app->get('/courses/{courseId}/lessons/{id}', function ($request, $response, array $args) {
    $courseId = $args['courseId'];
    $id = $args['id'];
    return $response->write("Course id: {$courseId}")
      ->write("Lesson id: {$id}");
});

Самостоятельная работа

1. Добавьте в index.php обработчик из первого примера этого урока
2. Откройте в браузере страницу /courses/5. Попробуйте поменять число

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

1. Официальная документация