Laravel предлагает несколько функций, которые помогут вам в создании URL-адресов для вашего приложения. Эти помощники в первую очередь полезны при построении ссылок в ваших шаблонах и ответах API или при создании ответов-перенаправлений в другую часть вашего приложения.
Помощник url
используется для генерации произвольных URL-адресов для вашего приложения. Сгенерированный URL-адрес будет автоматически использовать схему (HTTP или HTTPS) и хост из текущего запроса, обрабатываемого приложением:
$post = App\Models\Post::find(1);
echo url("/posts/{$post->id}");
// http://example.com/posts/1
Если не передан путь помощнику url
, то возвращается экземпляр Illuminate\Routing\UrlGenerator
, позволяющий вам получить доступ к информации о текущем URL:
// Получить текущий URL без строки запроса ...
echo url()->current();
// Получить текущий URL, включая строку запроса ...
echo url()->full();
// Получить полный URL-адрес предыдущего запроса ...
echo url()->previous();
К каждому из этих методов также можно получить доступ через фасад URL
:
use Illuminate\Support\Facades\URL;
echo URL::current();
Помощник route
используется для генерации URL-адресов для именованных маршрутов. Именованные маршруты позволяют создавать URL-адреса без привязки к фактическому URL-адресу, определенному в маршруте. Следовательно, если URL-адрес маршрута изменится, никаких изменений в ваши вызовы функции route
вносить не нужно. Например, представьте, что ваше приложение содержит маршрут, определенный следующим образом:
Route::get('/post/{post}', function (Post $post) {
//
})->name('post.show');
Чтобы сгенерировать URL-адрес этого маршрута, вы можете использовать помощник route
следующим образом:
echo route('post.show', ['post' => 1]);
// http://example.com/post/1
Конечно, помощник route
также может использоваться для генерации URL-адресов для маршрутов с несколькими параметрами:
Route::get('/post/{post}/comment/{comment}', function (Post $post, Comment $comment)
//
})->name('comment.show');
echo route('comment.show', ['post' => 1, 'comment' => 3]);
// http://example.com/post/1/comment/3
Любые дополнительные элементы массива, не соответствующие параметрам определения маршрута, будут добавлены в строку запроса URL:
echo route('post.show', ['post' => 1, 'search' => 'rocket']);
// http://example.com/post/1?search=rocket
Вы часто будете генерировать URL-адреса, используя ключ маршрута (обычно первичный ключ) модели Eloquent. По этой причине вы можете передавать в качестве значений параметров модели Eloquent полностью. Помощник route
автоматически извлечет ключ маршрута модели:
echo route('post.show', ['post' => $post]);
Laravel позволяет вам легко создавать «подписанные» URL-адреса для именованных маршрутов. Эти URL-адреса имеют хеш «подписи», добавленный к строке запроса, который позволяет Laravel проверять, что URL-адрес не был изменен с момента его создания. Подписанные URL-адреса особенно полезны для маршрутов, которые общедоступны, но требуют уровня защиты от манипуляций с URL-адресами.
Например, вы можете использовать подписанные URL-адреса для реализации общедоступной ссылки «отказаться от подписки», которая отправляется вашим клиентам по электронной почте. Чтобы создать подписанный URL для именованного маршрута, используйте метод signedRoute
фасада URL
:
use Illuminate\Support\Facades\URL;
return URL::signedRoute('unsubscribe', ['user' => 1]);
Если вы хотите сгенерировать временный подписанный URL-адрес маршрута, срок действия которого истекает по истечении определенного времени, вы можете использовать метод temporarySignedRoute
. Когда Laravel проверяет временный подписанный URL-адрес маршрута, он гарантирует, что метка времени истечения срока, закодированная в подписанный URL-адрес, не истекла:
use Illuminate\Support\Facades\URL;
return URL::temporarySignedRoute(
'unsubscribe', now()->addMinutes(30), ['user' => 1]
);
Чтобы убедиться, что входящий запрос имеет действительную подпись, вы должны вызвать метод hasValidSignature
для экземпляра Illuminate\Http\Request
входящего запроса:
use Illuminate\Http\Request;
Route::get('/unsubscribe/{user}', function (Request $request) {
if (! $request->hasValidSignature()) {
abort(401);
}
// ...
})->name('unsubscribe');
Иногда требуется разрешить внешнему интерфейсу вашего приложения добавлять данные к подписанному URL-адресу, например, при выполнении разбивки на страницы на стороне клиента. Таким образом, вы можете указать параметры запроса, которые следует игнорировать при проверке подписанного URL-адреса, используя метод hasValidSignatureWhileIgnoring
. Помните, что игнорирование параметров позволяет любому изменять эти параметры:
if (! $request->hasValidSignatureWhileIgnoring(['page', 'order'])) {
abort(401);
}
Вместо проверки подписанных URL-адресов с использованием экземпляра входящего запроса, вы можете назначить маршруту посредник Illuminate\Routing\Middleware\ValidateSignature
. Если его еще нет, то вы должны назначить этому посреднику ключ в массиве routeMiddleware
в HTTP-ядре:
/**
* Посредники маршрутов приложения.
*
* Эти посредники могут быть групповыми или использоваться по отдельности.
*
* @var array
*/
protected $routeMiddleware = [
'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
];
После того, как вы зарегистрировали посредников в ядре приложения, вы можете назначить его маршруту. Если входящий запрос не имеет действительной подписи, посредник автоматически вернет HTTP-ответ 403
:
Route::post('/unsubscribe/{user}', function (Request $request) {
// ...
})->name('unsubscribe')->middleware('signed');
Когда кто-то посещает подписанный URL-адрес, срок действия которого истек, он получит общую страницу с 403
-им кодом ошибки состояния HTTP. Однако вы можете изменить это поведение, определив собственное замыкание метода renderable
для исключения InvalidSignatureException
в вашем обработчике исключений. Это замыкание должно вернуть HTTP-ответ:
use Illuminate\Routing\Exceptions\InvalidSignatureException;
/**
* Зарегистрировать замыкания, обрабатывающие исключения приложения.
*
* @return void
*/
public function register()
{
$this->renderable(function (InvalidSignatureException $e) {
return response()->view('error.link-expired', [], 403);
});
}
Функция action
генерирует URL-адрес для переданного действия контроллера:
use App\Http\Controllers\HomeController;
$url = action([HomeController::class, 'index']);
Если метод контроллера принимает параметры маршрута, вы можете передать ассоциативный массив параметров маршрута в качестве второго аргумента функции:
$url = action([UserController::class, 'profile'], ['id' => 1]);
Для некоторых приложений вы можете указать значения по умолчанию для определенных параметров URL-адреса. Например, представьте, что многие из ваших маршрутов определяют параметр {locale}
:
Route::get('/{locale}/posts', function () {
//
})->name('post.index');
Обременительно передавать locale
каждый раз при вызове помощника route
. Итак, вы можете использовать метод URL::defaults
, чтобы определить значение по умолчанию для этого параметра, которое всегда будет применяться во время текущего запроса. Вы можете вызвать этот метод из посредника маршрута, чтобы получить доступ к текущему запросу:
<?php
namespace App\Http\Middleware;
use Closure;
use Illuminate\Support\Facades\URL;
class SetDefaultLocaleForUrls
{
/**
* Обработка входящего запроса.
*
* @param \Illuminate\Http\Request $request
* @param \Closure $next
* @return \Illuminate\Http\Response
*/
public function handle($request, Closure $next)
{
URL::defaults(['locale' => $request->user()->locale]);
return $next($request);
}
}
После установки значения по умолчанию для параметра locale
вам больше не потребуется передавать его значение при генерации URL-адресов с помощью помощника route
.
Установка значений URL по умолчанию может мешать Laravel обрабатывать неявные привязки модели. Следовательно, необходимо установить приоритет посреднику, который задает значения URL по умолчанию, и должен выполняться перед посредником Laravel SubstituteBindings
. Вы можете добиться этого, убедившись, что ваш посредник находится перед посредником SubstituteBindings
в свойстве $middlewarePriority
HTTP-ядра вашего приложения.
Свойство $middlewarePriority
определено в базовом классе Illuminate\Foundation\Http\Kernel
. Вы можете скопировать его определение из этого класса и перезаписать его в HTTP-ядре вашего приложения, чтобы изменить приоритет:
/**
* Список посредников, отсортированный по приоритетности.
*
* Заставит неглобальных посредников всегда быть в заданном порядке.
*
* @var array
*/
protected $middlewarePriority = [
// ...
\App\Http\Middleware\SetDefaultLocaleForUrls::class,
\Illuminate\Routing\Middleware\SubstituteBindings::class,
// ...
];