URL 생성

• 소개
• 기본
  • URL 생성
  • 현재 URL 접근
• 이름있는 라우트에 대한 URL
  • 서명된 URL
• 컨트롤러 액션에 대한 URL
• 기본 값

소개

라라벨은 애플리케이션의 URL을 생성하는 데 도움이 되는 여러 헬퍼를 제공합니다. 이러한 헬퍼는 주로 템플릿 및 API 응답에서 링크를 작성하거나 애플리케이션의 다른 부분으로 리디렉션 응답을 생성할 때 유용합니다.

기본

URL 생성

url 헬퍼를 사용하여 애플리케이션에 대한 임의의 URL을 생성할 수 있습니다. 생성된 URL은 애플리케이션에서 처리 중인 현재 요청의 체계(HTTP 또는 HTTPS) 및 호스트를 자동으로 사용합니다.

$post = App\Models\Post::find(1);
 
echo url("/posts/{$post->id}");
 
// http://example.com/posts/1

쿼리 문자열 매개변수가 있는 URL을 생성하려면 query 메서드를 사용할 수 있습니다.

echo url()->query('/posts', ['search' => 'Laravel']);
 
// https://example.com/posts?search=Laravel
 
echo url()->query('/posts?sort=latest', ['search' => 'Laravel']);
 
// http://example.com/posts?sort=latest&search=Laravel

경로에 이미 존재하는 쿼리 문자열 매개변수를 제공하면 기존 값이 덮어쓰여집니다.

echo url()->query('/posts?sort=latest', ['sort' => 'oldest']);
 
// http://example.com/posts?sort=oldest

값의 배열을 쿼리 매개변수로 전달할 수도 있습니다. 이러한 값은 생성된 URL에서 올바르게 키가 지정되고 인코딩됩니다.

echo $url = url()->query('/posts', ['columns' => ['title', 'body']]);
 
// http://example.com/posts?columns%5B0%5D=title&columns%5B1%5D=body
 
echo urldecode($url);
 
// http://example.com/posts?columns[0]=title&columns[1]=body

현재 URL 접근

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();

이름있는 라우트에 대한 URL

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

Eloquent 모델

종종 Eloquent 모델의 라우트 키(일반적으로 기본 키)를 사용하여 URL을 생성하게 됩니다. 이러한 이유로 Eloquent 모델을 매개변수 값으로 전달할 수 있습니다. route 헬퍼는 모델의 라우트 키를 자동으로 추출합니다.

echo route('post.show', ['post' => $post]);

서명된 URL

라라벨을 사용하면 이름 있는 라우트에 대한 "서명된" URL을 쉽게 만들 수 있습니다. 이러한 URL에는 쿼리 문자열에 "서명" 해시가 추가되어 있어 라라벨이 URL이 생성된 이후 수정되지 않았는지 확인할 수 있습니다. 서명된 URL은 공개적으로 접근할 수 있지만 URL 조작에 대한 보호 계층이 필요한 라우트에 특히 유용합니다.

예를 들어, 고객에게 이메일로 발송되는 공개 "구독 취소" 링크를 구현하는 데 서명된 URL을 사용할 수 있습니다. 이름있는 라우트에 대한 서명된 URL을 만들려면 URL 파사드의 signedRoute 메서드를 사용합니다.

use Illuminate\Support\Facades\URL;
 
return URL::signedRoute('unsubscribe', ['user' => 1]);

signedRoute 메서드에 absolute 인수를 제공하여 서명된 URL 해시에서 도메인을 제외할 수 있습니다.

return URL::signedRoute('unsubscribe', ['user' => 1], absolute: false);

지정된 시간 후에 만료되는 임시 서명된 라우트 URL을 생성하려면 temporarySignedRoute 메서드를 사용할 수 있습니다. 라라벨이 임시 서명된 라우트 URL을 검증할 때 서명된 URL에 인코딩된 만료 타임스탬프가 경과하지 않았는지 확인합니다.

use Illuminate\Support\Facades\URL;
 
return URL::temporarySignedRoute(
    'unsubscribe', now()->addMinutes(30), ['user' => 1]
);

서명된 라우트 요청 검증

들어오는 요청에 유효한 서명이 있는지 확인하려면 들어오는 Illuminate\Http\Request 인스턴스에서 hasValidSignature 메서드를 호출해야 합니다.

use Illuminate\Http\Request;
 
Route::get('/unsubscribe/{user}', function (Request $request) {
    if (! $request->hasValidSignature()) {
        abort(401);
    }
 
    // ...
})->name('unsubscribe');

때로는 클라이언트 측 페이지 매김을 수행할 때와 같이 애플리케이션의 프런트엔드에서 서명된 URL에 데이터를 추가할 수 있도록 해야 할 수도 있습니다. 따라서 hasValidSignatureWhileIgnoring 메서드를 사용하여 서명된 URL을 검증할 때 무시해야 하는 요청 쿼리 매개변수를 지정할 수 있습니다. 매개변수를 무시하면 누구나 요청에서 해당 매개변수를 수정할 수 있다는 점을 기억하십시오.

if (! $request->hasValidSignatureWhileIgnoring(['page', 'order'])) {
    abort(401);
}

들어오는 요청 인스턴스를 사용하여 서명된 URL을 검증하는 대신 라우트에 signed (Illuminate\Routing\Middleware\ValidateSignature) 미들웨어를 할당할 수 있습니다. 들어오는 요청에 유효한 서명이 없으면 미들웨어는 자동으로 403 HTTP 응답을 반환합니다.

Route::post('/unsubscribe/{user}', function (Request $request) {
    // ...
})->name('unsubscribe')->middleware('signed');

서명된 URL에 URL 해시에 도메인이 포함되지 않은 경우 미들웨어에 relative 인수를 제공해야 합니다.

Route::post('/unsubscribe/{user}', function (Request $request) {
    // ...
})->name('unsubscribe')->middleware('signed:relative');

유효하지 않은 서명된 라우트에 응답

만료된 서명된 URL을 방문하면 403 HTTP 상태 코드에 대한 일반 오류 페이지가 표시됩니다. 그러나 애플리케이션의 bootstrap/app.php 파일에서 InvalidSignatureException 예외에 대한 사용자 정의 "렌더링" 클로저를 정의하여 이 동작을 사용자 정의할 수 있습니다.

use Illuminate\Routing\Exceptions\InvalidSignatureException;
 
->withExceptions(function (Exceptions $exceptions) {
    $exceptions->render(function (InvalidSignatureException $e) {
        return response()->view('errors.link-expired', status: 403);
    });
})

컨트롤러 액션에 대한 URL

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');

route 헬퍼를 호출할 때마다 locale을 항상 전달하는 것은 번거롭습니다. 따라서 URL::defaults 메서드를 사용하여 현재 요청 중에 항상 적용되는 이 매개변수의 기본값을 정의할 수 있습니다. 현재 요청에 액세스할 수 있도록 라우트 미들웨어에서 이 메서드를 호출할 수 있습니다.

<?php
 
namespace App\Http\Middleware;
 
use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\URL;
use Symfony\Component\HttpFoundation\Response;
 
class SetDefaultLocaleForUrls
{
    /**
     * Handle an incoming request.
     *
     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
     */
    public function handle(Request $request, Closure $next): Response
    {
        URL::defaults(['locale' => $request->user()->locale]);
 
        return $next($request);
    }
}

locale 매개변수에 대한 기본값이 설정되면 route 헬퍼를 통해 URL을 생성할 때 더 이상 값을 전달할 필요가 없습니다.

URL 기본값 및 미들웨어 우선순위

URL 기본값을 설정하면 라라벨의 암시적 모델 바인딩 처리를 방해할 수 있습니다. 따라서 URL 기본값을 설정하는 미들웨어가 라라벨 자체의 SubstituteBindings 미들웨어보다 먼저 실행되도록 우선순위를 지정해야 합니다. 애플리케이션의 bootstrap/app.php 파일에서 priority 미들웨어 메서드를 사용하여 이를 수행할 수 있습니다.

->withMiddleware(function (Middleware $middleware) {
    // 미들웨어 우선순위 목록의 맨 앞에 추가합니다.
    $middleware->prependToPriorityList(
        // \Illuminate\Routing\Middleware\SubstituteBindings::class 미들웨어 앞에
        before: \Illuminate\Routing\Middleware\SubstituteBindings::class,
        // \App\Http\Middleware\SetDefaultLocaleForUrls::class 미들웨어를 추가합니다.
        prepend: \App\Http\Middleware\SetDefaultLocaleForUrls::class,
    );
})